diff --git a/docs/strutil.md b/docs/strutil.md index 8243c8c..0b396d0 100644 --- a/docs/strutil.md +++ b/docs/strutil.md @@ -33,8 +33,9 @@ import ( - [UpperKebabCase](#UpperKebabCase) - [LowerFirst](#LowerFirst) - [UpperFirst](#UpperFirst) -- [PadEnd](#PadEnd) +- [Pad](#Pad) - [PadStart](#PadStart) +- [PadEnd](#PadEnd) - [Reverse](#Reverse) - [SnakeCase](#SnakeCase) - [UpperSnakeCase](#UpperSnakeCase) @@ -449,6 +450,51 @@ func main() { } ``` +### Pad + +
Pads string on the left and right side if it's shorter than size.
+ +Signature: + +```go +func Pad(source string, size int, padStr string) string +``` + +Example: + +```go +import ( + "fmt" + "github.com/duke-git/lancet/v2/strutil" +) + +func main() { + result1 := strutil.Pad("foo", 1, "bar") + result2 := strutil.Pad("foo", 2, "bar") + result3 := strutil.Pad("foo", 3, "bar") + result4 := strutil.Pad("foo", 4, "bar") + result5 := strutil.Pad("foo", 5, "bar") + result6 := strutil.Pad("foo", 6, "bar") + result7 := strutil.Pad("foo", 7, "bar") + + fmt.Println(result1) + fmt.Println(result2) + fmt.Println(result3) + fmt.Println(result4) + fmt.Println(result5) + fmt.Println(result6) + fmt.Println(result7) + // Output: + // foo + // foo + // foo + // foob + // bfoob + // bfooba + // bafooba +} +``` + ### PadEndPads string on the right side if it's shorter than size.
diff --git a/docs/strutil_zh-CN.md b/docs/strutil_zh-CN.md index e2557de..60144da 100644 --- a/docs/strutil_zh-CN.md +++ b/docs/strutil_zh-CN.md @@ -449,6 +449,51 @@ func main() { } ``` +### Pad + +如果字符串长度短于size,则在左右两侧填充字符串。
+ +函数签名: + +```go +func Pad(source string, size int, padStr string) string +``` + +示例: + +```go +import ( + "fmt" + "github.com/duke-git/lancet/v2/strutil" +) + +func main() { + result1 := strutil.Pad("foo", 1, "bar") + result2 := strutil.Pad("foo", 2, "bar") + result3 := strutil.Pad("foo", 3, "bar") + result4 := strutil.Pad("foo", 4, "bar") + result5 := strutil.Pad("foo", 5, "bar") + result6 := strutil.Pad("foo", 6, "bar") + result7 := strutil.Pad("foo", 7, "bar") + + fmt.Println(result1) + fmt.Println(result2) + fmt.Println(result3) + fmt.Println(result4) + fmt.Println(result5) + fmt.Println(result6) + fmt.Println(result7) + // Output: + // foo + // foo + // foo + // foob + // bfoob + // bfooba + // bafooba +} +``` + ### PadEnd如果字符串长度短于size,则在右侧填充字符串。
diff --git a/strutil/string_example_test.go b/strutil/string_example_test.go index 8fed392..6b043dd 100644 --- a/strutil/string_example_test.go +++ b/strutil/string_example_test.go @@ -186,6 +186,33 @@ func ExampleUpperFirst() { // Bar大 } +func ExamplePad() { + result1 := Pad("foo", 1, "bar") + result2 := Pad("foo", 2, "bar") + result3 := Pad("foo", 3, "bar") + result4 := Pad("foo", 4, "bar") + result5 := Pad("foo", 5, "bar") + result6 := Pad("foo", 6, "bar") + result7 := Pad("foo", 7, "bar") + + fmt.Println(result1) + fmt.Println(result2) + fmt.Println(result3) + fmt.Println(result4) + fmt.Println(result5) + fmt.Println(result6) + fmt.Println(result7) + + // Output: + // foo + // foo + // foo + // foob + // bfoob + // bfooba + // bafooba +} + func ExamplePadEnd() { result1 := PadEnd("foo", 1, "bar") result2 := PadEnd("foo", 2, "bar")