lancet/docs/convertor_zh-CN.md

Convertor

convertor转换器包支持一些常见的数据类型转换

源码:

• https://github.com/duke-git/lancet/blob/main/convertor/convertor.go

用法:

import (
    "github.com/duke-git/lancet/v2/convertor"
)

目录

• ColorHexToRGB
• ColorRGBToHex
• ToBool
• ToBytes
• ToChar
• ToChannel
• ToFloat
• ToInt
• ToJson
• ToMap
• ToPointer
• ToString
• StructToMap
• MapToSlice
• EncodeByte
• DecodeByte

文档

ColorHexToRGB

颜色值十六进制转rgb。

函数签名:

func ColorHexToRGB(colorHex string) (red, green, blue int)

示例:

package main

import (
    "fmt"
    "github.com/duke-git/lancet/v2/convertor"
)

func main() {
    colorHex := "#003366"
	r, g, b := convertor.ColorHexToRGB(colorHex)

	fmt.Println(r, g, b)

	// Output:
	// 0 51 102
}

ColorRGBToHex

颜色值rgb转十六进制。

函数签名:

func ColorRGBToHex(red, green, blue int) string

示例:

package main

import (
    "fmt"
    "github.com/duke-git/lancet/v2/convertor"
)

func main() {
    r := 0
	g := 51
	b := 102
	colorHex := ColorRGBToHex(r, g, b)

	fmt.Println(colorHex)

	// Output:
	// #003366
}

ToBool

字符串转布尔类型，使用strconv.ParseBool。

函数签名:

func ToBool(s string) (bool, error)

示例:

package main

import (
    "fmt"
    "github.com/duke-git/lancet/v2/convertor"
)

func main() {
    cases := []string{"1", "true", "True", "false", "False", "0", "123", "0.0", "abc"}

	for i := 0; i < len(cases); i++ {
		result, _ := convertor.ToBool(cases[i])
		fmt.Println(result)
	}

	// Output:
	// true
	// true
	// true
	// false
	// false
	// false
	// false
	// false
	// false
}

ToBytes

Interface转字节切片。

函数签名:

func ToBytes(data any) ([]byte, error)

示例:

package main

import (
    "fmt"
    "github.com/duke-git/lancet/v2/convertor"
)

func main() {
    bytesData, err := convertor.ToBytes("abc")
    if err != nil {
        fmt.Println(err)
    }

    fmt.Println(bytesData)

    // Output:
	// [97 98 99]
}

ToChar

字符串转字符切片。

函数签名:

func ToChar(s string) []string

示例:

package main

import (
    "fmt"
    "github.com/duke-git/lancet/v2/convertor"
)

func main() {
    result1 := convertor.ToChar("")
	result2 := convertor.ToChar("abc")
	result3 := convertor.ToChar("1 2#3")

	fmt.Println(result1)
	fmt.Println(result2)
	fmt.Println(result3)

	// Output:
	// []
	// [a b c]
	// [1   2 # 3]
}

ToChannel

将切片转为只读channel。

函数签名:

func ToChannel[T any](array []T) <-chan T

示例:

package main

import (
    "fmt"
    "github.com/duke-git/lancet/v2/convertor"
)

func main() {
    ch := convertor.ToChannel([]int{1, 2, 3})
	result1 := <-ch
	result2 := <-ch
	result3 := <-ch

	fmt.Println(result1)
	fmt.Println(result2)
	fmt.Println(result3)

	// Output:
	// 1
	// 2
	// 3
}

ToFloat

将interface转成float64类型，如果参数无法转换，会返回0和error。

函数签名:

func ToFloat(value any) (float64, error)

示例:

package main

import (
    "fmt"
    "github.com/duke-git/lancet/v2/convertor"
)

func main() {
    result1, _ := convertor.ToFloat("")
	result2, err := convertor.ToFloat("abc")
	result3, _ := convertor.ToFloat("-1")
	result4, _ := convertor.ToFloat("-.11")
	result5, _ := convertor.ToFloat("1.23e3")
	result6, _ := convertor.ToFloat(true)

	fmt.Println(result1)
	fmt.Println(result2, err)
	fmt.Println(result3)
	fmt.Println(result4)
	fmt.Println(result5)
	fmt.Println(result6)

	// Output:
	// 0
	// 0 strconv.ParseFloat: parsing "": invalid syntax
	// -1
	// -0.11
	// 1230
	// 0
}

ToInt

将interface转成int64类型，如果参数无法转换，会返回0和error。

函数签名:

func ToInt(value any) (int64, error)

示例:

package main

import (
    "fmt"
    "github.com/duke-git/lancet/v2/convertor"
)

func main() {
    result1, _ := convertor.ToInt("123")
	result2, _ := convertor.ToInt("-123")
	result3, _ := convertor.ToInt(float64(12.3))
	result4, err := convertor.ToInt("abc")
	result5, _ := convertor.ToInt(true)

	fmt.Println(result1)
	fmt.Println(result2)
	fmt.Println(result3)
	fmt.Println(result4, err)
	fmt.Println(result5)

	// Output:
	// 123
	// -123
	// 12
	// 0 strconv.ParseInt: parsing "": invalid syntax
	// 0
}

ToJson

将interface转成json字符串，如果参数无法转换，会返回""和error。

函数签名:

func ToJson(value any) (string, error)

示例:

package main

import (
    "fmt"
    "github.com/duke-git/lancet/v2/convertor"
)

func main() {
    aMap := map[string]int{"a": 1, "b": 2, "c": 3}
	result, err := ToJson(aMap)

	if err != nil {
		fmt.Printf("%v", err)
	}

	fmt.Println(result)

	// Output:
	// {"a":1,"b":2,"c":3}
}

ToMap

将切片转为map。

函数签名:

func ToMap[T any, K comparable, V any](array []T, iteratee func(T) (K, V)) map[K]V

示例:

package main

import (
    "fmt"
    "github.com/duke-git/lancet/v2/convertor"
)

func main() {
    type Message struct {
        name string
        code int
    }
    messages := []Message{
        {name: "Hello", code: 100},
        {name: "Hi", code: 101},
    }

    result := convertor.ToMap(messages, func(msg Message) (int, string) {
        return msg.code, msg.name
    })

    fmt.Println(result)

    // Output:
	// map[100:Hello 101:Hi]
}

ToPointer

返回传入值的指针。

函数签名:

func ToPointer[T any](value T) *T

示例:

package main

import (
    "fmt"
    "github.com/duke-git/lancet/v2/convertor"
)

func main() {
    result := convertor.ToPointer(123)
    fmt.Println(*result) 
    
    // Output:
	// 123
}

ToString

将值转换为字符串，对于数字、字符串、[]byte，将转换为字符串。 对于其他类型（切片、映射、数组、结构体）将调用 json.Marshal

函数签名:

func ToString(value any) string

示例:

package main

import (
    "fmt"
    "github.com/duke-git/lancet/v2/convertor"
)

func main() {
    result1 := convertor.ToString("")
	result2 := convertor.ToString(nil)
	result3 := convertor.ToString(0)
	result4 := convertor.ToString(1.23)
	result5 := convertor.ToString(true)
	result6 := convertor.ToString(false)
	result7 := convertor.ToString([]int{1, 2, 3})

	fmt.Println(result1)
	fmt.Println(result2)
	fmt.Println(result3)
	fmt.Println(result4)
	fmt.Println(result5)
	fmt.Println(result6)
	fmt.Println(result7)

	// Output:
	//
	//
	// 0
	// 1.23
	// true
	// false
	// [1,2,3]
}

StructToMap

将struct转成map，只会转换struct中可导出的字段。struct中导出字段需要设置json tag标记。

函数签名:

func StructToMap(value any) (map[string]any, error)

示例:

package main

import (
    "fmt"
    "github.com/duke-git/lancet/v2/convertor"
)

func main() {
    type People struct {
		Name string `json:"name"`
		age  int
	}
	p := People{
		"test",
		100,
	}
	pm, _ := convertor.StructToMap(p)

	fmt.Println(pm)

	// Output:
	// map[name:test]
}

MapToSlice

map中key和value执行函数iteratee后，转为切片。

函数签名:

func MapToSlice[T any, K comparable, V any](aMap map[K]V, iteratee func(K, V) T) []T

示例:

package main

import (
    "fmt"
    "github.com/duke-git/lancet/v2/convertor"
)

func main() {
    aMap := map[string]int{"a": 1, "b": 2, "c": 3}
    result := MapToSlice(aMap, func(key string, value int) string {
        return key + ":" + strconv.Itoa(value)
    })

    fmt.Println(result) //[]string{"a:1", "b:2", "c:3"}
}

EncodeByte

将data编码成字节切片。

函数签名:

func EncodeByte(data any) ([]byte, error)

示例:

package main

import (
    "fmt"
    "github.com/duke-git/lancet/v2/convertor"
)

func main() {
    byteData, _ := convertor.EncodeByte("abc")
    fmt.Println(byteData)

    // Output:
	// [6 12 0 3 97 98 99]
}

DecodeByte

解码字节切片到目标对象，目标对象需要传入一个指针实例。

函数签名:

func DecodeByte(data []byte, target any) error

示例:

package main

import (
    "fmt"
    "github.com/duke-git/lancet/v2/convertor"
)

func main() {
    var result string
	byteData := []byte{6, 12, 0, 3, 97, 98, 99}
	
    err := convertor.DecodeByte(byteData, &result)
    if err != nil {
		return
	}

    fmt.Println(result)
    
    // Output:
	// abc
}