Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/shockerli/cvt
Easy and safe convert any value to another type in Go. （Go 数据类型安全转换）
https://github.com/shockerli/cvt
cast convert cvt go golang helper toolkit
Last synced: 14 days ago
JSON representation
Easy and safe convert any value to another type in Go. （Go 数据类型安全转换）
- Host: GitHub
- URL: https://github.com/shockerli/cvt
- Owner: shockerli
- License: mit
- Created: 2021-03-09T02:38:50.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2023-12-20T12:00:31.000Z (11 months ago)
- Last Synced: 2024-07-31T20:53:32.765Z (3 months ago)
- Topics: cast, convert, cvt, go, golang, helper, toolkit
- Language: Go
- Homepage: https://cvt.shockerli.net
- Size: 5.51 MB
- Stars: 47
- Watchers: 2
- Forks: 8
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-go - cvt - Easy and safe convert any value to another type. (Utilities / Utility/Miscellaneous)
- go-awesome - cvt - Arbitrary data type conversion, support for custom types, extract structure fields and values (Open source library / Development Aid Package)
- awesome-go-extra - cvt - 03-09T02:38:50Z|2022-01-08T05:19:37Z| (Utilities / Fail injection)
README
# cvt
[](https://pkg.go.dev/github.com/shockerli/cvt)
[](https://goreportcard.com/report/github.com/shockerli/cvt)
[](https://travis-ci.com/shockerli/cvt)
[](https://codecov.io/gh/shockerli/cvt)
[](https://github.com/avelino/awesome-go)
> Simple, safe conversion of any type, including indirect/custom types.
## Documents
https://cvt.shockerli.net
## Install
> Go >= 1.13
```go
go get -u github.com/shockerli/cvt
```
## Usage
English | [中文](README_ZH.md)
### with `error`
> Method `__E()`: expect handle error, while unable to convert
```go
cvt.IntE("12") // 12, nil
cvt.Float64E("12.34") // 12.34, nil
cvt.StringE(12.34) // "12.34", nil
cvt.BoolE("false") // false, nil
```
### custom type and pointers
> dereferencing pointer and reach the original type
```go
type Name string
var name Name = "jioby"
cvt.StringE(name) // jioby, nil
cvt.StringE(&name) // jioby, nil
```
### ignore `error`
> Method `__()`: ignore error, while convert failed, will return the zero value of type
```go
cvt.Int("12") // 12(success)
cvt.Int(struct{}{}) // 0(failed)
```
### with default
> return the default value, while convert failed
```go
cvt.Int(struct{}{}, 12) // 12
cvt.Float("hello", 12.34) // 12.34
```
### more
> 1000+ unit test cases, for more examples, see `*_test.go`
## License
This project is under the terms of the [MIT](LICENSE) license.
## Thanks
- [JetBrains Open Source Support](https://jb.gg/OpenSourceSupport)
