Support functions: Field/SliceInt/SliceInt64/SliceFloat64/SliceString

cvte.go

@@ -15,7 +15,20 @@ var formatOutOfLimitInt = "%w, out of max limit value(%d)"
 var formatOutOfLimitFloat = "%w, out of max limit value(%f)"
 var formatExtend = "%v, %w"
 
-// FieldE return the field value from map/struct, ignore the filed type
+// Field return the field value from map/struct, with default value
+func Field(v interface{}, field interface{}, def ...interface{}) interface{} {
+	if v, err := FieldE(v, field); err == nil {
+		return v
+	}
+
+	if len(def) > 0 {
+		return def[0]
+	}
+
+	return nil
+}
+
+// FieldE return the field value from map/struct, ignore the field type
 func FieldE(val interface{}, field interface{}) (interface{}, error) {
 	if val == nil {
 		return nil, errUnsupportedTypeNil

doc/content/en/type/others.md

@@ -0,0 +1,33 @@
+---
+title: Others
+weight: 80
+---
+
+
+{{< toc >}}
+
+## Field
+Reference method `FieldE`.
+
+## FieldE
+Return the field value from map/struct, `interface{}`.
+
+```go
+// map
+cvt.FieldE(map[int]interface{}{123: "112233"}, "123") // "112233"
+cvt.FieldE(map[string]interface{}{"123": "112233"}, "123") // "112233"
+
+// struct
+cvt.FieldE(struct{
+	  A string
+	  B int
+}{"Hello", 18}, "A") // "Hello"
+cvt.FieldE(struct{
+	  A string
+	  B int
+}{"Hello", 18}, "B") // 18
+```
+
+
+> 更多示例请看单元测试：`cvte_test.go`
+

doc/content/en/type/slice.md

@@ -35,25 +35,6 @@ cvt.ColumnsE(map[int]TestStructD{1: {11}, 2: {22}}, "D1")
 cvt.ColumnsE([]TestStructE{{D1: 1}, {D1: 2}}, "D1")
 ```
 
-## FieldE
-Return the field value from map/struct, `interface{}`.
-
-```go
-// map
-cvt.FieldE(map[int]interface{}{123: "112233"}, "123") // "112233"
-cvt.FieldE(map[string]interface{}{"123": "112233"}, "123") // "112233"
-
-// struct
-cvt.FieldE(struct{
-	  A string
-	  B int
-}{"Hello", 18}, "A") // "Hello"
-cvt.FieldE(struct{
-	  A string
-	  B int
-}{"Hello", 18}, "B") // 18
-```
-
 ## KeysE
 Return the keys of map, or fields of struct, `[]interface{}`.
 
@@ -83,7 +64,7 @@ cvt.KeysE(struct{
 
 
 ## Slice
-Convert an interface to a `[]interface{}` type.
+Reference method `SliceE`.
 
 ## SliceE
 Convert an interface to a `[]interface{}` type.
@@ -104,6 +85,9 @@ cvt.SliceE(TestStruct{18,"jhon"}) // []interface{}{18, "jhon"}
 ```
 
 
+## SliceInt
+Reference method `SliceIntE`.
+
 ## SliceIntE
 Convert an interface to a `[]int` type.
 
@@ -112,6 +96,9 @@ cvt.SliceIntE([]string{"1", "2", "3"})              // []int{1, 2, 3}
 cvt.SliceIntE(map[int]string{2: "222", 1: "111"})   // []int{111, 222}
 ```
 
+## SliceInt64
+Reference method `SliceInt64E`.
+
 ## SliceInt64E
 Convert an interface to a `[]int64` type.
 
@@ -121,6 +108,9 @@ cvt.SliceInt64E(map[int]string{2: "222", 1: "111"})   // []int64{111, 222}
 ```
 
 
+## SliceFloat64
+Reference method `SliceFloat64E`.
+
 ## SliceFloat64E
 Convert an interface to a `[]float64` type.
 
@@ -129,6 +119,9 @@ cvt.SliceFloat64E([]string{"1", "2", "3"})              // []float64{1, 2, 3}
 cvt.SliceFloat64E(map[int]string{2: "222", 1: "111"})   // []float64{111, 222}
 ```
 
+## SliceString
+Reference method `SliceStringE`.
+
 ## SliceStringE
 Convert an interface to a `[]string` type.
 

doc/content/en/usage/getting-started.md

@@ -5,6 +5,12 @@ weight: -20
 
 Simple, safe conversion of any type, including indirect/custom types.
 
+
+{{< hint type=warning >}}
+**Document statement**\
+`__()` and `__P()` are convenient method is based on `__E()`, so the method of use and the type of support please reference ` __E () ` document.
+{{< /hint >}}
+
 <!--more-->
 
 {{< toc >}}

doc/content/zh-cn/develop/testing.md

@@ -0,0 +1,12 @@
+---
+title: 测试
+weight: 20
+---
+
+## 命名约定
+
+- `TestXXX_HasDefault`：测试带有默认值的方法
+- `TestXXX_BaseLine`：测试没有带默认值的无错误方法
+- `TestXXXE`：测试返回错误信息的方法
+- `TestXXXP`：测试返回数据指针的方法
+

doc/content/zh-cn/type/others.md

@@ -0,0 +1,34 @@
+---
+title: Others
+weight: 80
+---
+
+
+{{< toc >}}
+
+
+## Field
+参考 `FieldE` 方法。
+
+## FieldE
+取 `map` 或 `struct` 的字段值，返回 `interface{}`。
+
+```go
+// map
+cvt.FieldE(map[int]interface{}{123: "112233"}, "123") // "112233"
+cvt.FieldE(map[string]interface{}{"123": "112233"}, "123") // "112233"
+
+// struct
+cvt.FieldE(struct{
+	  A string
+	  B int
+}{"Hello", 18}, "A") // "Hello"
+cvt.FieldE(struct{
+	  A string
+	  B int
+}{"Hello", 18}, "B") // 18
+```
+
+
+> 更多示例请看单元测试：`cvte_test.go`
+

doc/content/zh-cn/type/slice.md

@@ -38,25 +38,6 @@ cvt.ColumnsE(map[int]TestStructD{1: {11}, 2: {22}}, "D1")
 cvt.ColumnsE([]TestStructE{{D1: 1}, {D1: 2}}, "D1")
 ```
 
-## FieldE
-取 `map` 或 `struct` 的字段值，返回 `interface{}`。
-
-```go
-// map
-cvt.FieldE(map[int]interface{}{123: "112233"}, "123") // "112233"
-cvt.FieldE(map[string]interface{}{"123": "112233"}, "123") // "112233"
-
-// struct
-cvt.FieldE(struct{
-	  A string
-	  B int
-}{"Hello", 18}, "A") // "Hello"
-cvt.FieldE(struct{
-	  A string
-	  B int
-}{"Hello", 18}, "B") // 18
-```
-
 ## KeysE
 取 `map` 的键名，或结构体的字段名，返回 `[]interface{}`。
 
@@ -86,7 +67,7 @@ cvt.KeysE(struct{
 
 
 ## Slice
-`SliceE` 方法的默认值版本
+参考 `SliceE` 方法。
 
 ## SliceE
 转换成 `[]interface{}`
@@ -107,6 +88,9 @@ cvt.SliceE(TestStruct{18,"jhon"}) // []interface{}{18, "jhon"}
 ```
 
 
+## SliceInt
+参考 `SliceIntE` 方法。
+
 ## SliceIntE
 转换成 `[]int`
 
@@ -115,6 +99,9 @@ cvt.SliceIntE([]string{"1", "2", "3"})              // []int{1, 2, 3}
 cvt.SliceIntE(map[int]string{2: "222", 1: "111"})   // []int{111, 222}
 ```
 
+## SliceInt64
+参考 `SliceInt64E` 方法。
+
 ## SliceInt64E
 转换成 `[]int64`
 
@@ -124,6 +111,9 @@ cvt.SliceInt64E(map[int]string{2: "222", 1: "111"})   // []int64{111, 222}
 ```
 
 
+## SliceFloat64
+参考 `SliceFloat64E` 方法。
+
 ## SliceFloat64E
 转换成 `[]float64`
 
@@ -132,6 +122,9 @@ cvt.SliceFloat64E([]string{"1", "2", "3"})              // []float64{1, 2, 3}
 cvt.SliceFloat64E(map[int]string{2: "222", 1: "111"})   // []float64{111, 222}
 ```
 
+## SliceString
+参考 `SliceStringE` 方法。
+
 ## SliceStringE
 转换成 `[]string`
 

doc/content/zh-cn/usage/getting-started.md

@@ -6,6 +6,12 @@ weight: -20
 简单、安全、高效的转换任意数据类型的 Go 语言工具包，支持自定义类型、提取结构体字段和值。
 
 
+{{< hint type=warning >}}
+**文档说明**\
+`__()`、`__P()` 均是以其对应的 `__E()` 为基础的便捷方法，故其使用方法及支持的类型请参考 `__E()` 的文档，大部分此类便利方法均不再详细阐述。
+{{< /hint >}}
+
+
 <!--more-->
 
 {{< toc >}}
@@ -75,6 +81,7 @@ cvt.Float("hello", 12.34)       // 12.34
 cvt.BoolP("true")   // (*bool)(0x14000126180)(true)
 ```
 
+
 ### 更多示例
 
 > 上千个单元测试用例，覆盖率近100%，所有示例可通过单元测试了解：`*_test.go`