https://github.com/kaatinga/strconv
Fast and low memory consuming uint to string and string to uint converters
https://github.com/kaatinga/strconv
converter fast go golang high-performance string uint
Last synced: 3 months ago
JSON representation
Fast and low memory consuming uint to string and string to uint converters
- Host: GitHub
- URL: https://github.com/kaatinga/strconv
- Owner: kaatinga
- Created: 2022-05-17T19:40:35.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2025-10-17T19:43:57.000Z (5 months ago)
- Last Synced: 2025-10-18T21:41:18.190Z (5 months ago)
- Topics: converter, fast, go, golang, high-performance, string, uint
- Language: Go
- Homepage:
- Size: 84 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[](https://github.com/kaatinga/strconv/actions/workflows/github-code-scanning/codeql)
[](https://github.com/kaatinga/strconv/releases)
[](https://github.com/kaatinga/strconv/blob/main/LICENSE)
[](https://codecov.io/gh/kaatinga/strconv)
[](https://github.com/kaatinga/strconv/actions/workflows/golang_ci.yml)
[](https://github.com/kaatinga/strconv/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22)
# The faststrconv package
The package contain several useful functions intended for conversion between string,
[]byte and different integer types.
For the sake of code shortness, generics are used, it means the package requires go1.18+.
## GetUint32(), GetUint16(), GetByte()
The functions are faster alternative to `strconv.Atoi()`.
```
goos: darwin
goarch: arm64
pkg: github.com/kaatinga/strconv
BenchmarkGetByte
BenchmarkGetByte-8 523370584 2.042 ns/op 0 B/op 0 allocs/op
BenchmarkGetUint16
BenchmarkGetUint16-8 582942614 2.046 ns/op 0 B/op 0 allocs/op
BenchmarkGetUint32
BenchmarkGetUint32-8 587540109 2.045 ns/op 0 B/op 0 allocs/op
BenchmarkStrvconv_Atoi
BenchmarkStrvconv_Atoi-8 174534008 7.387 ns/op 0 B/op 0 allocs/op
PASS
```
## Uint162String, Byte2String, etc
The functions are faster alternative to `strconv.Itoa()`.
```
goos: darwin
goarch: arm64
pkg: github.com/kaatinga/strconv
cpu: Apple M1
BenchmarkByte2String
BenchmarkByte2String-8 70187169 19.01 ns/op 0 B/op 0 allocs/op
BenchmarkUint162String
BenchmarkUint162String-8 44651092 27.47 ns/op 0 B/op 0 allocs/op
BenchmarkUint322String
BenchmarkUint322String-8 42029007 29.80 ns/op 0 B/op 0 allocs/op
BenchmarkUint642String
BenchmarkUint642String-8 38611280 31.20 ns/op 0 B/op 0 allocs/op
BenchmarkUint32And642StringWithUint64
BenchmarkUint32And642StringWithUint64-8 38078565 31.53 ns/op 0 B/op 0 allocs/op
BenchmarkUint32And642StringWithUint32
BenchmarkUint32And642StringWithUint32-8 37886760 31.42 ns/op 0 B/op 0 allocs/op
BenchmarkItoa
BenchmarkItoa-8 20134200 58.28 ns/op 8 B/op 2 allocs/op
PASS
```
Warning. For the sake of maximum processing speed, all the converters have limited support of the leading zeros.
The length of the string cannot exceed the maximum length of the string of every certain type. For example, `012` is
supported for the `byte` type, whereas `0255` is not as it consists of 4 characters what is impossible for `byte` type.
In case you process a date number, like month that is formatted with zero, like `09`, you can use the fast
converters of the strconv package directly, but if you still need to process formatted numbers like `0000000000000255` as byte, use
`DeleteLeadingZeros` helper to remove leading zeros in the processed string first:
```go
numberINeed, err = strconv.String2Byte(DeleteLeadingZeros("0000000000000255"))
if err != nil {
...
}
```