doc: Improve comment for lo.Ellipsis

samber · web-flow · commit 52ad90c4055b · 2025-05-22T13:13:05.000+02:00
diff --git a/string.go b/string.go
@@ -210,7 +210,9 @@ func Capitalize(str string) string {
 	return cases.Title(language.English).String(str)
 }
 
-// Ellipsis trims and truncates a string to a specified length and appends an ellipsis if truncated.
+// Ellipsis trims and truncates a string to a specified length **in bytes** and appends an ellipsis
+// if truncated. If the string contains non-ASCII characters (which may occupy multiple bytes in UTF-8),
+// truncating by byte length may split a character in the middle, potentially resulting in garbled output.
 func Ellipsis(str string, length int) string {
 	str = strings.TrimSpace(str)
 

Original file line number	Diff line number	Diff line change
`@@ -210,7 +210,9 @@ func Capitalize(str string) string {`
`210`	`210`	`return cases.Title(language.English).String(str)`
`211`	`211`	`}`
`212`	`212`
`213`		`-// Ellipsis trims and truncates a string to a specified length and appends an ellipsis if truncated.`
	`213`	`+// Ellipsis trims and truncates a string to a specified length in bytes and appends an ellipsis`
	`214`	`+// if truncated. If the string contains non-ASCII characters (which may occupy multiple bytes in UTF-8),`
	`215`	`+// truncating by byte length may split a character in the middle, potentially resulting in garbled output.`
`214`	`216`	`func Ellipsis(str string, length int) string {`
`215`	`217`	`str = strings.TrimSpace(str)`
`216`	`218`