[+] feat: feat: Add v.At(...).Set(...) methods and fix some spelling issues

Author: Andrew-M-C

CHANGELOG.md

@@ -2,6 +2,7 @@
 
 [中文](./CHANGELOG_zh-cn.md)
 
+- [v1.4.1](#v141)
 - [v1.4.0](#v140)
 - [v1.3.8](#v138)
 - [v1.3.7](#v137)
@@ -16,6 +17,10 @@
 - [v1.2.0](#v120)
 - [v1.1.1](#v111)
 
+## v1.4.1
+
+- Add `v.At(...).Set(...)` pattern, allowing putting keys ahead (comparing to `v.Set(...).At(...)`).
+
 ## v1.4.0
 
 - Allow passing parameter with a single slice or array for Get, Set, Append, Insert, Delete methods.

CHANGELOG_zh-cn.md

@@ -2,6 +2,7 @@
 
 [English](./CHANGELOG.md)
 
+- [v1.4.1](#v141)
 - [v1.4.0](#v140)
 - [v1.3.8](#v138)
 - [v1.3.7](#v137)
@@ -16,6 +17,10 @@
 - [v1.2.0](#v120)
 - [v1.1.1](#v111)
 
+## v1.4.1
+
+- 新增 `v.At(...).Set(...)` 模式, 相比 `v.Set(...).At(...)` 模式不同的是将 key 放在前面
+
 ## v1.4.0
 
 - 在 Get, Set, Append, Insert, Delete 等方法中, 允许传递一个切片参数, 用来标识 key 链

conv.go

@@ -133,65 +133,22 @@ func escapeStringToBuff(s string, buf buffer.Buffer, opt *Opt) {
 	}
 }
 
-func intfToInt(v any) (u int, err error) {
-	switch v := v.(type) {
-	case int:
-		u = v
-	case uint:
-		u = int(v)
-	case int64:
-		u = int(v)
-	case uint64:
-		u = int(v)
-	case int32:
-		u = int(v)
-	case uint32:
-		u = int(v)
-	case int16:
-		u = int(v)
-	case uint16:
-		u = int(v)
-	case int8:
-		u = int(v)
-	case uint8:
-		u = int(v)
+func anyToInt(v any) (u int, err error) {
+	if v == nil {
+		return 0, fmt.Errorf("%w: parameter is nil", ErrParameterError)
+	}
+	value := reflect.ValueOf(v)
+	switch value.Kind() {
+	case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64:
+		return int(value.Int()), nil
+	case reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64:
+		return int(value.Uint()), nil
 	default:
-		err = fmt.Errorf("%s is not a number", reflect.TypeOf(v).String())
+		return 0, fmt.Errorf("%v is not a number", reflect.TypeOf(v))
 	}
+}
 
-	return
-}
-
-// func intfToInt64(v any) (i int64, err error) {
-// 	switch v.(type) {
-// 	case int:
-// 		i = int64(v.(int))
-// 	case uint:
-// 		i = int64(v.(uint))
-// 	case int64:
-// 		i = int64(v.(int64))
-// 	case uint64:
-// 		i = int64(v.(uint64))
-// 	case int32:
-// 		i = int64(v.(int32))
-// 	case uint32:
-// 		i = int64(v.(uint32))
-// 	case int16:
-// 		i = int64(v.(int16))
-// 	case uint16:
-// 		i = int64(v.(uint16))
-// 	case int8:
-// 		i = int64(v.(int8))
-// 	case uint8:
-// 		i = int64(v.(uint8))
-// 	default:
-// 		err = fmt.Errorf("%s is not a number", reflect.TypeOf(v).String())
-// 	}
-
-// 	return
-// }
-
-func intfToString(v any) (s string, err error) {
+func anyToString(v any) (s string, err error) {
 	if v == nil {
 		return "", fmt.Errorf("%w: parameter is nil", ErrParameterError)
 	}

docs/en/03_set.md

@@ -119,6 +119,15 @@ This feature is so complicated that we will not use in most cases. But there is
     fmt.Println(c.MustMarshalString())
 ```
 
+If you like placing keys ahead, you can use the `v.At(...).Set(...)` pattern:
+
+```go
+    // ...
+        v.At("array", i, "word").Set(words[i])
+        v.At("array", i, "lesson").Set(lessons[i]).
+    // ...
+```
+
 Final output:
 
 ```json

docs/zh-cn/03_set.md

@@ -115,6 +115,15 @@ v.MustSet("Hello, array!").At("arr", 0)          // {"obj":{"message":"Hello, ob
     fmt.Println(c.MustMarshalString())
 ```
 
+如果你喜欢把 key 放在前面，那你可以使用 `v.At(...).Set(...)` 模式:
+
+```go
+    // ...
+        v.At("array", i, "word").Set(words[i])
+        v.At("array", i, "lesson").Set(lessons[i]).
+    // ...
+```
+
 最终输出为:
 
 ```json

errors.go

@@ -1,6 +1,6 @@
 package jsonvalue
 
-// Error is equavilent to string and used to create some error constants in this package.
+// Error is equivalent to string and used to create some error constants in this package.
 // Error constants: http://godoc.org/github.com/Andrew-M-C/go.jsonvalue/#pkg-constants
 type Error string
 
@@ -9,7 +9,7 @@ func (e Error) Error() string {
 }
 
 const (
-	// ErrNilParameter identifies input paremeter is nil
+	// ErrNilParameter identifies input parameter is nil
 	//
 	// ErrNilParameter 表示参数为空
 	ErrNilParameter = Error("nil parameter")
@@ -19,10 +19,10 @@ const (
 	// ErrValueUninitialized 表示当前的 jsonvalue 实例未初始化
 	ErrValueUninitialized = Error("jsonvalue instance is not initialized")
 
-	// ErrRawBytesUnrecignized identifies all unexpected raw bytes
+	// ErrRawBytesUnrecognized identifies all unexpected raw bytes
 	//
-	// ErrRawBytesUnrecignized 表示无法识别的序列文本
-	ErrRawBytesUnrecignized = Error("unrecognized raw text")
+	// ErrRawBytesUnrecognized 表示无法识别的序列文本
+	ErrRawBytesUnrecognized = Error("unrecognized raw text")
 
 	// ErrNotValidNumberValue shows that a value starts with number or '-' is not eventually a number value
 	//
@@ -34,10 +34,10 @@ const (
 	// ErrNotValidBoolValue 表示当前值不是一个合法的布尔值
 	ErrNotValidBoolValue = Error("not a valid bool value")
 
-	// ErrNotValidNulllValue shows that a value starts with 'n' is not eventually a bool value
+	// ErrNotValidNullValue shows that a value starts with 'n' is not eventually a bool value
 	//
-	// ErrNotValidNulllValue 表示当前不是一个 null 值类型的 JSON
-	ErrNotValidNulllValue = Error("not a valid null value")
+	// ErrNotValidNullValue 表示当前不是一个 null 值类型的 JSON
+	ErrNotValidNullValue = Error("not a valid null value")
 
 	// ErrOutOfRange identifies that given position for a JSON array is out of range
 	//
@@ -64,7 +64,7 @@ const (
 	// ErrNotArrayValue 表示当前不是一个数组类型 JSON
 	ErrNotArrayValue = Error("not an array typed value")
 
-	// ErrNotObjectValue shows that operation target value is not an valie object
+	// ErrNotObjectValue shows that operation target value is not an valid object
 	//
 	// ErrNotObjectValue 表示当前不是一个合法的对象类型 JSON
 	ErrNotObjectValue = Error("not an object typed value")