String Library for padding and other useful functions. This has been tuned for high speed operation.
This library provides several common functions:
Truncate String
- TruncLeft
- TruncRight
Common Padding
- Left
- LeftLen
- Right
- RightLen
Zero Fill Pattern
- ZFill
- ZFillLen
Justified text
- LJust
- LJustLen
- RJust
- RJustLen.
The functions Left, Right, LJust, RJust, ZFill add a pattern to the string and return the result, which is of size input + pattern * count.
The functions LeftLen, RightLen, LJustLen, RJustLen, ZFillLen add a pattern to the string and return a string of the specified size.
Left(src string, pat string, count int)
Right(src string, pat string, count int)
ZFill(src string, count int)
LJust(src string, count int)
RJust(src string, count int)LeftLen(src string, pat string, length int)
RightLen(src string, pat string, length int)
ZFillLen(src string, length int)
LJustLen(src string, length int)
RJustLen(src string, length int)Please look at the example code.
package main
import (
"fmt"
"github.com/ppreeper/str"
)
func main() {
fmt.Println(str.Right("Hello", "!", 20))
fmt.Println(str.Left("Exit now", "→", 20))
fmt.Println("-----")
fmt.Println(str.Left("D", "a", 4))
fmt.Println(str.Right("D", "a", 4))
fmt.Println(str.ZFill("D", 4))
fmt.Println(str.LJust("D", 4))
fmt.Println(str.RJust("D", 4))
fmt.Println("-----")
fmt.Println(str.Left("ABCD", "a", 5))
fmt.Println(str.Right("ABCD", "a", 5))
fmt.Println(str.ZFill("ABCD", 5))
fmt.Println(str.LJust("ABCD", 5))
fmt.Println(str.RJust("ABCD", 5))
fmt.Println("-----")
fmt.Println(str.LeftLen("D", "a", 4))
fmt.Println(str.RightLen("D", "a", 4))
fmt.Println(str.ZFillLen("D", 4))
fmt.Println(str.LJustLen("D", 4))
fmt.Println(str.RJustLen("D", 4))
fmt.Println("-----")
fmt.Println(str.LeftLen("ABCD", "a", 5))
fmt.Println(str.RightLen("ABCD", "a", 5))
fmt.Println(str.ZFillLen("ABCD", 5))
fmt.Println(str.LJustLen("ABCD", 5))
fmt.Println(str.RJustLen("ABCD", 5))
}Hello!!!!!!!!!!!!!!!!!!!!
→→→→→→→→→→→→→→→→→→→→Exit now
-----
aaaaD
Daaaa
0000D
D
D
-----
aaaaaABCD
ABCDaaaaa
00000ABCD
ABCD
ABCD
-----
aaaD
Daaa
000D
D
D
-----
aABCD
ABCDa
0ABCD
ABCD
ABCD
Current benchmarks
> go test -run ^$ -cpu 1 -benchmem -benchtime 5s -bench .
goos: linux
goarch: amd64
pkg: github.com/ppreeper/str
cpu: AMD Ryzen 7 7735HS with Radeon Graphics
BenchmarkLeft_D_a_4 177426610 33.98 ns/op 4 B/op 1 allocs/op
BenchmarkLeft_D_aa_2 199887630 29.80 ns/op 4 B/op 1 allocs/op
BenchmarkLeft_D_utf8_4 147985876 40.27 ns/op 16 B/op 1 allocs/op
BenchmarkLeft_D_utf8_2_2 164434153 36.02 ns/op 16 B/op 1 allocs/op
BenchmarkLeft_D_a_200_1 56919225 103.7 ns/op 416 B/op 2 allocs/op
BenchmarkLeft_D_a_100_2 60211620 100.8 ns/op 416 B/op 2 allocs/op
BenchmarkRight_D_a_4 173296929 34.60 ns/op 4 B/op 1 allocs/op
BenchmarkRight_D_aa_2 196698732 30.74 ns/op 4 B/op 1 allocs/op
BenchmarkRight_D_utf8_4 151394588 40.14 ns/op 16 B/op 1 allocs/op
BenchmarkRight_D_utf8_2_2 168813403 35.31 ns/op 16 B/op 1 allocs/op
BenchmarkRight_D_a_200_1 57623094 104.8 ns/op 416 B/op 2 allocs/op
BenchmarkRight_D_a_100_2 60113691 102.1 ns/op 416 B/op 2 allocs/op
BenchmarkTruncLeft_ABCD_2 324979262 18.32 ns/op 0 B/op 0 allocs/op
BenchmarkTruncRight_ABCD_2 329157414 18.20 ns/op 0 B/op 0 allocs/op
BenchmarkLeftLen_D_utf8_4 55832942 107.5 ns/op 32 B/op 2 allocs/op
BenchmarkLeftLen_D_a_4 84549571 70.22 ns/op 16 B/op 2 allocs/op
BenchmarkLeftLen_D_a_200 4705328 1282 ns/op 1520 B/op 4 allocs/op
BenchmarkRightLen_D_utf8_4 55781134 108.3 ns/op 32 B/op 2 allocs/op
BenchmarkRightLen_D_a_4 85283271 69.94 ns/op 16 B/op 2 allocs/op
BenchmarkRightLen_D_a_200 4587787 1279 ns/op 1520 B/op 4 allocs/op
BenchmarkLJust_utf8_4 175381755 34.65 ns/op 4 B/op 1 allocs/op
BenchmarkLJust_D_4 176793922 33.80 ns/op 4 B/op 1 allocs/op
BenchmarkLJust_D_a_200 58400977 103.0 ns/op 416 B/op 2 allocs/op
BenchmarkRJust_utf8_4 174684237 33.89 ns/op 4 B/op 1 allocs/op
BenchmarkRJust_D_4 173668522 34.42 ns/op 4 B/op 1 allocs/op
BenchmarkRJust_D_a_200 58833978 103.2 ns/op 416 B/op 2 allocs/op
BenchmarkLJustLen_utf8_4 75187804 77.23 ns/op 16 B/op 2 allocs/op
BenchmarkLJustLen_D_4 84242854 69.98 ns/op 16 B/op 2 allocs/op
BenchmarkLJustLen_D_a_200 4625905 1282 ns/op 1520 B/op 4 allocs/op
BenchmarkRJustLen_utf8_4 84421971 73.52 ns/op 16 B/op 2 allocs/op
BenchmarkRJustLen_D_4 84456016 70.90 ns/op 16 B/op 2 allocs/op
BenchmarkRJustLen_D_a_200 4756957 1275 ns/op 1520 B/op 4 allocs/op
BenchmarkZFill_D_4 174243123 34.84 ns/op 4 B/op 1 allocs/op
BenchmarkZFill_ABCD_8 164768880 36.71 ns/op 8 B/op 1 allocs/op
BenchmarkZFill_D_a_200 56639906 102.5 ns/op 416 B/op 2 allocs/op
BenchmarkZFillLen_D_4 82058068 70.89 ns/op 16 B/op 2 allocs/op
BenchmarkZFillLen_ABCD_8 57930297 102.0 ns/op 24 B/op 2 allocs/op
BenchmarkZFillLen_D_a_200 4752658 1272 ns/op 1520 B/op 4 allocs/op
PASS
ok github.com/ppreeper/str 288.716s