git/lancet
1
0
Fork 0
mirror of https://github.com/duke-git/lancet.git synced 2026-02-04 12:52:28 +08:00
Code Issues Projects Releases Wiki Activity

update doc

Browse Source
This commit is contained in:
dudaodong
2024-12-04 10:40:18 +08:00
parent e1e15883e9
commit 4595a94b4c
14 changed files with 342 additions and 196 deletions
Download Patch File Download Diff File Expand all files Collapse all files

245
compare/compare_internal.go
View File

@@ -3,6 +3,7 @@ package compare
import (
"bytes"
"encoding/json"
"math/big"
"reflect"
"time"
@@ -155,169 +156,129 @@ func compareBasicValue(operator string, leftValue, rightValue interface{}) bool
}
switch leftVal := leftValue.(type) {
case json.Number:
if left, err := leftVal.Float64(); err == nil {
switch rightVal := rightValue.(type) {
case json.Number:
if right, err := rightVal.Float64(); err == nil {
switch operator {
case equal:
if left == right {
return true
}
case lessThan:
if left < right {
return true
}
case greaterThan:
if left > right {
return true
}
case lessOrEqual:
if left <= right {
return true
}
case greaterOrEqual:
if left >= right {
return true
}
}
}
case float32, float64, int, uint, int8, uint8, int16, uint16, int32, uint32, int64, uint64:
right, err := convertor.ToFloat(rightValue)
if err != nil {
return false
}
switch operator {
case equal:
if left == right {
return true
}
case lessThan:
if left < right {
return true
}
case greaterThan:
if left > right {
return true
}
case lessOrEqual:
if left <= right {
return true
}
case greaterOrEqual:
if left >= right {
return true
}
}
}
case int, uint, int8, uint8, int16, uint16, int32, uint32, int64, uint64:
left, err := convertor.ToBigInt(leftValue)
if err != nil {
return false
}
case float32, float64, int, uint, int8, uint8, int16, uint16, int32, uint32, int64, uint64:
right, err := convertor.ToBigInt(rightValue)
if err != nil {
return false
}
return compareBigInt(operator, left, right)
case float32, float64:
left, err := convertor.ToFloat(leftValue)
if err != nil {
return false
}
switch rightVal := rightValue.(type) {
case json.Number:
if right, err := rightVal.Float64(); err == nil {
switch operator {
case equal:
if left == right {
return true
}
case lessThan:
if left < right {
return true
}
case greaterThan:
if left > right {
return true
}
case lessOrEqual:
if left <= right {
return true
}
case greaterOrEqual:
if left >= right {
return true
}
}
}
case float32, float64, int, uint, int8, uint8, int16, uint16, int32, uint32, int64, uint64:
right, err := convertor.ToFloat(rightValue)
if err != nil {
return false
}
switch operator {
case equal:
if left == right {
return true
}
case lessThan:
if left < right {
return true
}
case greaterThan:
if left > right {
return true
}
case lessOrEqual:
if left <= right {
return true
}
case greaterOrEqual:
if left >= right {
return true
}
}
right, err := convertor.ToFloat(rightValue)
if err != nil {
return false
}
return compareFloats(operator, left, right)
case string:
left := leftVal
switch right := rightValue.(type) {
case string:
switch operator {
case equal:
if left == right {
return true
}
case lessThan:
if left < right {
return true
}
case greaterThan:
if left > right {
return true
}
case lessOrEqual:
if left <= right {
return true
}
case greaterOrEqual:
if left >= right {
return true
}
}
return compareStrings(operator, left, right)
}
case bool:
left := leftVal
switch right := rightValue.(type) {
case bool:
switch operator {
case equal:
if left == right {
return true
}
}
return compareBools(operator, left, right)
}
case json.Number:
if left, err := leftVal.Float64(); err == nil {
switch rightVal := rightValue.(type) {
case json.Number:
if right, err := rightVal.Float64(); err == nil {
return compareFloats(operator, left, right)
}
case float32, float64:
right, err := convertor.ToFloat(rightValue)
if err != nil {
return false
}
return compareFloats(operator, left, right)
case int, uint, int8, uint8, int16, uint16, int32, uint32, int64, uint64:
right, err := convertor.ToBigInt(rightValue)
if err != nil {
return false
}
left, err := convertor.ToBigInt(left)
return compareBigInt(operator, left, right)
}
}
}
return false
}
// compareBigInt compares two big.Int values based on the operator
func compareBigInt(operator string, left, right *big.Int) bool {
switch operator {
case equal:
return left.Cmp(right) == 0
case lessThan:
return left.Cmp(right) < 0
case greaterThan:
return left.Cmp(right) > 0
case lessOrEqual:
return left.Cmp(right) <= 0
case greaterOrEqual:
return left.Cmp(right) >= 0
}
return false
}
// compareFloats compares two float64 values based on the operator
func compareFloats(operator string, left, right float64) bool {
switch operator {
case equal:
return left == right
case lessThan:
return left < right
case greaterThan:
return left > right
case lessOrEqual:
return left <= right
case greaterOrEqual:
return left >= right
}
return false
}
// compareStrings compares two string values based on the operator
func compareStrings(operator string, left, right string) bool {
switch operator {
case equal:
return left == right
case lessThan:
return left < right
case greaterThan:
return left > right
case lessOrEqual:
return left <= right
case greaterOrEqual:
return left >= right
}
return false
}
// compareBools compares two boolean values based on the operator
func compareBools(operator string, left, right bool) bool {
switch operator {
case equal:
return left == right
}
return false
}

29
compare/compare_test.go
View File

@@ -1,6 +1,7 @@
package compare
import (
"encoding/json"
"testing"
"time"
@@ -70,18 +71,28 @@ func TestEqualValue(t *testing.T) {
}
func TestLessThan(t *testing.T) {
t.Parallel()
assert := internal.NewAssert(t, "TestLessThan")
assert.Equal(true, LessThan(1, 2))
assert.Equal(true, LessThan(1.1, 2.2))
assert.Equal(true, LessThan("a", "b"))
tests := []struct {
left interface{}
right interface{}
want bool
}{
{1, 2, true},
{1.1, 2.2, true},
{"a", "b", true},
{time.Now(), time.Now().Add(time.Second), true},
{[]byte("hello1"), []byte("hello2"), true},
{json.Number("123"), json.Number("124"), true},
{645680099112988673, 645680099112988675, true},
{1, 1, false},
{1, int64(1), false},
}
time1 := time.Now()
time2 := time1.Add(time.Second)
assert.Equal(true, LessThan(time1, time2))
assert.Equal(false, LessThan(1, 1))
assert.Equal(false, LessThan(1, int64(1)))
for _, tt := range tests {
assert.Equal(tt.want, LessThan(tt.left, tt.right))
}
}
func TestGreaterThan(t *testing.T) {

34
convertor/convertor.go
View File

@@ -14,6 +14,7 @@ import (
"fmt"
"io"
"math"
"math/big"
"reflect"
"regexp"
"strconv"
@@ -460,3 +461,36 @@ func ToRawUrlBase64(value interface{}) string {
return base64.RawURLEncoding.EncodeToString(marshal)
}
}
// ToBigInt converts an integer of any supported type (int, int64, uint64, etc.) to *big.Int
// Play: todo
func ToBigInt(v interface{}) (*big.Int, error) {
result := new(big.Int)
switch v := (v).(type) {
case int:
result.SetInt64(int64(v))
case int8:
result.SetInt64(int64(v))
case int16:
result.SetInt64(int64(v))
case int32:
result.SetInt64(int64(v))
case int64:
result.SetInt64(v)
case uint:
result.SetUint64(uint64(v))
case uint8:
result.SetUint64(uint64(v))
case uint16:
result.SetUint64(uint64(v))
case uint32:
result.SetUint64(uint64(v))
case uint64:
result.SetUint64(v)
default:
return nil, fmt.Errorf("unsupported type: %T", v)
}
return result, nil
}

81
convertor/convertor_test.go
View File

@@ -5,6 +5,7 @@ import (
"errors"
"fmt"
"io"
"math/big"
"reflect"
"testing"
"unicode/utf8"
@@ -684,3 +685,83 @@ func TestToRawUrlBase64(t *testing.T) {
d15, _ := base64.RawURLEncoding.DecodeString(r15)
assert.Equal("4+3/4?=", string(d15))
}
func TestToBigInt(t *testing.T) {
t.Parallel()
assert := internal.NewAssert(t, "TestToBigInt")
tests := []struct {
name string
input interface{}
want *big.Int
hasErr bool
}{
{
name: "int",
input: 42,
want: big.NewInt(42),
},
{
name: "int8",
input: int8(127),
want: big.NewInt(127),
},
{
name: "int16",
input: int16(32000),
want: big.NewInt(32000),
},
{
name: "int32",
input: int32(123456),
want: big.NewInt(123456),
},
{
name: "int64",
input: int64(987654321),
want: big.NewInt(987654321),
},
{
name: "uint",
input: uint(987654321),
want: big.NewInt(987654321),
},
{
name: "uint8",
input: uint8(255),
want: big.NewInt(255),
},
{
name: "uint16",
input: uint16(65535),
want: big.NewInt(65535),
},
{
name: "uint32",
input: uint32(4294967295),
want: big.NewInt(4294967295),
},
{
name: "uint64",
input: uint64(18446744073709551615),
want: new(big.Int).SetUint64(18446744073709551615),
},
{
name: "unsupported type",
input: 3.14, // Unsupported type
hasErr: true,
},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
got, err := ToBigInt(tt.input)
if (err != nil) != tt.hasErr {
t.Errorf("ToBigInt() error = %v, hasErr %v", err, tt.hasErr)
return
}
assert.Equal(tt.want, got)
})
}
}

1
datetime/datetime.go
View File

@@ -325,7 +325,6 @@ func TimestampNano(timezone ...string) int64 {
// TrackFuncTime track the time of function execution.
// call it at top of the func like `defer TrackFuncTime(time.Now())()`
// Play: todo
func TrackFuncTime(pre time.Time) func() {
callerName := getCallerName()
return func() {

12
docs/compare.md
View File

@@ -42,7 +42,7 @@ import (
<b>Signature:</b>
```go
func Equal(left, right any) bool
func Equal(left, right interface{}) bool
```
<b>Example:</b>
@@ -91,7 +91,7 @@ func main() {
<b>Signature:</b>
```go
func EqualValue(left, right any) bool
func EqualValue(left, right interface{}) bool
```
<b>Example:</b>
@@ -130,7 +130,7 @@ func main() {
<b>Signature:</b>
```go
func LessThan(left, right any) bool
func LessThan(left, right interface{}) bool
```
<b>Example:</b>
@@ -179,7 +179,7 @@ func main() {
<b>Signature:</b>
```go
func GreaterThan(left, right any) bool
func GreaterThan(left, right interface{}) bool
```
<b>Example:</b>
@@ -231,7 +231,7 @@ func main() {
<b>Signature:</b>
```go
func LessOrEqual(left, right any) bool
func LessOrEqual(left, right interface{}) bool
```
<b>Example:</b>
@@ -280,7 +280,7 @@ func main() {
<b>Signature:</b>
```go
func GreaterOrEqual(left, right any) bool
func GreaterOrEqual(left, right interface{}) bool
```
<b>Example:</b>

12
docs/compare_zh-CN.md
View File

@@ -42,7 +42,7 @@ import (
<b>函数签名:</b>
```go
func Equal(left, right any) bool
func Equal(left, right interface{}) bool
```
<b>示例:</b>
@@ -91,7 +91,7 @@ func main() {
<b>函数签名:</b>
```go
func EqualValue(left, right any) bool
func EqualValue(left, right interface{}) bool
```
<b>示例:</b>
@@ -130,7 +130,7 @@ func main() {
<b>函数签名:</b>
```go
func LessThan(left, right any) bool
func LessThan(left, right interface{}) bool
```
<b>示例:</b>
@@ -179,7 +179,7 @@ func main() {
<b>函数签名:</b>
```go
func GreaterThan(left, right any) bool
func GreaterThan(left, right interface{}) bool
```
<b>示例:</b>
@@ -231,7 +231,7 @@ func main() {
<b>函数签名:</b>
```go
func LessOrEqual(left, right any) bool
func LessOrEqual(left, right interface{}) bool
```
<b>示例:</b>
@@ -280,7 +280,7 @@ func main() {
<b>函数签名:</b>
```go
func GreaterOrEqual(left, right any) bool
func GreaterOrEqual(left, right interface{}) bool
```
<b>示例:</b>

54
docs/convertor.md
View File

@@ -45,7 +45,7 @@ import (
- [ToUrlBase64](#ToUrlBase64)
- [ToRawStdBase64](#ToRawStdBase64)
- [ToRawUrlBase64](#ToRawUrlBase64)
- [ToBigInt](#ToBigInt)
<div STYLE="page-break-after: always;"></div>
@@ -454,7 +454,7 @@ func main() {
<b>Signature:</b>
```go
func EncodeByte(data any) ([]byte, error)
func EncodeByte(data interface{}) ([]byte, error)
```
<b>Example:</b>
@@ -480,7 +480,7 @@ func main() {
<b>Signature:</b>
```go
func DecodeByte(data []byte, target any) error
func DecodeByte(data []byte, target interface{}) error
```
<b>Example:</b>
@@ -508,7 +508,7 @@ func main() {
<b>Signature:</b>
```go
func DeepClone[T any](src T) T
func DeepClone[T interface{}](src T) T
```
<b>Example:</b>
@@ -753,7 +753,7 @@ func main() {
<b>Signature:</b>
```go
func ToStdBase64(value any) string
func ToStdBase64(value interface{}) string
```
<b>Example:</b>
@@ -785,7 +785,7 @@ func main() {
afterEncode = convertor.ToStdBase64(intVal)
fmt.Println(afterEncode)
mapVal := map[string]any{"a": "hi", "b": 2, "c": struct {
mapVal := map[string]interface{}{"a": "hi", "b": 2, "c": struct {
A string
B int
}{"hello", 3}}
@@ -825,7 +825,7 @@ func main() {
<b>Signature:</b>
```go
func ToUrlBase64(value any) string
func ToUrlBase64(value interface{}) string
```
<b>Example:</b>
@@ -855,7 +855,7 @@ func main() {
afterEncode = convertor.ToUrlBase64(intVal)
fmt.Println(afterEncode)
mapVal := map[string]any{"a": "hi", "b": 2, "c": struct {
mapVal := map[string]interface{}{"a": "hi", "b": 2, "c": struct {
A string
B int
}{"hello", 3}}
@@ -894,7 +894,7 @@ func main() {
<b>Signature:</b>
```go
func ToRawStdBase64(value any) string
func ToRawStdBase64(value interface{}) string
```
<b>Example:</b>
@@ -921,7 +921,7 @@ func main() {
afterEncode = convertor.ToRawStdBase64(intVal)
fmt.Println(afterEncode)
mapVal := map[string]any{"a": "hi", "b": 2, "c": struct {
mapVal := map[string]interface{}{"a": "hi", "b": 2, "c": struct {
A string
B int
}{"hello", 3}}
@@ -958,7 +958,7 @@ func main() {
<b>Signature:</b>
```go
func ToRawUrlBase64(value any) string
func ToRawUrlBase64(value interface{}) string
```
<b>Example:</b>
@@ -985,7 +985,7 @@ func main() {
afterEncode = convertor.ToRawUrlBase64(intVal)
fmt.Println(afterEncode)
mapVal := map[string]any{"a": "hi", "b": 2, "c": struct {
mapVal := map[string]interface{}{"a": "hi", "b": 2, "c": struct {
A string
B int
}{"hello", 3}}
@@ -1013,4 +1013,34 @@ func main() {
// dHJ1ZQ
// ZXJy
}
```
### <span id="ToBigInt">ToBigInt</span>
<p>Convert value to bigInt.</p>
<b>Signature:</b>
```go
func ToBigInt(v interface{}) (*big.Int, error)
```
<b>Example:</b>
```go
package main
import (
"fmt"
"github.com/duke-git/lancet/convertor"
)
func main() {
n := 9876543210
bigInt, _ := convertor.ToBigInt(n)
fmt.Println(bigInt)
// Output:
// 9876543210
}
```

61
docs/convertor_zh-CN.md
View File

@@ -45,6 +45,7 @@ import (
- [ToUrlBase64](#ToUrlBase64)
- [ToRawStdBase64](#ToRawStdBase64)
- [ToRawUrlBase64](#ToRawUrlBase64)
- [ToBigInt](#ToBigInt)
<div STYLE="page-break-after: always;"></div>
@@ -453,7 +454,7 @@ func main() {
<b>函数签名:</b>
```go
func EncodeByte(data any) ([]byte, error)
func EncodeByte(data interface{}) ([]byte, error)
```
<b>例子:</b>
@@ -479,7 +480,7 @@ func main() {
<b>函数签名:</b>
```go
func DecodeByte(data []byte, target any) error
func DecodeByte(data []byte, target interface{}) error
```
<b>例子:</b>
@@ -507,7 +508,7 @@ func main() {
<b>函数签名:</b>
```go
func DeepClone[T any](src T) T
func DeepClone[T interface{}](src T) T
```
<b>示例:</b>
@@ -753,7 +754,7 @@ func main() {
<b>函数签名:</b>
```go
func ToStdBase64(value any) string
func ToStdBase64(value interface{}) string
```
<b>示例:</b>
@@ -763,7 +764,7 @@ package main
import (
"fmt"
"github.com/duke-git/lancet/v2/convertor"
"github.com/duke-git/lancet/convertor"
)
func main() {
@@ -785,7 +786,7 @@ func main() {
afterEncode = convertor.ToStdBase64(intVal)
fmt.Println(afterEncode)
mapVal := map[string]any{"a": "hi", "b": 2, "c": struct {
mapVal := map[string]interface{}{"a": "hi", "b": 2, "c": struct {
A string
B int
}{"hello", 3}}
@@ -825,7 +826,7 @@ func main() {
<b>函数签名:</b>
```go
func ToUrlBase64(value any) string
func ToUrlBase64(value interface{}) string
```
<b>示例:</b>
@@ -835,7 +836,7 @@ package main
import (
"fmt"
"github.com/duke-git/lancet/v2/convertor"
"github.com/duke-git/lancet/convertor"
)
func main() {
@@ -855,7 +856,7 @@ func main() {
afterEncode = convertor.ToUrlBase64(intVal)
fmt.Println(afterEncode)
mapVal := map[string]any{"a": "hi", "b": 2, "c": struct {
mapVal := map[string]interface{}{"a": "hi", "b": 2, "c": struct {
A string
B int
}{"hello", 3}}
@@ -894,7 +895,7 @@ func main() {
<b>函数签名:</b>
```go
func ToRawStdBase64(value any) string
func ToRawStdBase64(value interface{}) string
```
<b>示例:</b>
@@ -904,7 +905,7 @@ package main
import (
"fmt"
"github.com/duke-git/lancet/v2/convertor"
"github.com/duke-git/lancet/convertor"
)
func main() {
@@ -921,7 +922,7 @@ func main() {
afterEncode = convertor.ToRawStdBase64(intVal)
fmt.Println(afterEncode)
mapVal := map[string]any{"a": "hi", "b": 2, "c": struct {
mapVal := map[string]interface{}{"a": "hi", "b": 2, "c": struct {
A string
B int
}{"hello", 3}}
@@ -958,7 +959,7 @@ func main() {
<b>函数签名:</b>
```go
func ToRawUrlBase64(value any) string
func ToRawUrlBase64(value interface{}) string
```
<b>示例:</b>
@@ -968,7 +969,7 @@ package main
import (
"fmt"
"github.com/duke-git/lancet/v2/convertor"
"github.com/duke-git/lancet/convertor"
)
func main() {
@@ -985,7 +986,7 @@ func main() {
afterEncode = convertor.ToRawUrlBase64(intVal)
fmt.Println(afterEncode)
mapVal := map[string]any{"a": "hi", "b": 2, "c": struct {
mapVal := map[string]interface{}{"a": "hi", "b": 2, "c": struct {
A string
B int
}{"hello", 3}}
@@ -1013,4 +1014,34 @@ func main() {
// dHJ1ZQ
// ZXJy
}
```
### <span id="ToBigInt">ToBigInt</span>
<p>将整数值转换为bigInt。</p>
<b>函数签名:</b>
```go
func ToBigInt(v interface{}) (*big.Int, error)
```
<b>示例:</b>
```go
package main
import (
"fmt"
"github.com/duke-git/lancet/convertor"
)
func main() {
n := 9876543210
bigInt, _ := convertor.ToBigInt(n)
fmt.Println(bigInt)
// Output:
// 9876543210
}
```

2
docs/datetime.md
View File

@@ -1381,7 +1381,7 @@ package main
import (
"fmt"
"github.com/duke-git/lancet/v2/datetime"
"github.com/duke-git/lancet/datetime"
)
func main() {

2
docs/fileutil.md
View File

@@ -902,7 +902,7 @@ package main
import (
"fmt"
"github.com/duke-git/lancet/v2/fileutil"
"github.com/duke-git/lancet/fileutil"
)
func main() {

2
docs/fileutil_zh-CN.md
View File

@@ -900,7 +900,7 @@ package main
import (
"fmt"
"github.com/duke-git/lancet/v2/fileutil"
"github.com/duke-git/lancet/fileutil"
)
func main() {

2
docs/validator.md
View File

@@ -1225,7 +1225,7 @@ func IsMasterCard(v string) bool
```go
import (
"fmt"
"github.com/duke-git/lancet/v2/validator"
"github.com/duke-git/lancet/validator"
)
func main() {

1
strutil/string.go
View File

@@ -360,7 +360,6 @@ func StringToBytes(str string) (b []byte) {
}
// BytesToString converts a byte slice to string without a memory allocation.
// Play: todo
func BytesToString(bytes []byte) string {
return *(*string)(unsafe.Pointer(&bytes))
}