stringx

func AddPrefixIfNot ¶

func AddPrefixIfNot(str string, prefix string) string

AddPrefixIfNot 如果给定字符串不是以prefix开头的，在开头补充 prefix

func AddSuffixIfNot ¶

func AddSuffixIfNot(str string, suffix string) string

AddSuffixIfNot 如果给定字符串不是以suffix结尾的，在尾部补充 suffix

func AppendFieldNameVariants ¶

func AppendFieldNameVariants(dst []string, fieldName string) []string

AppendFieldNameVariants 把字段名的各种命名风格变体追加到 dst，返回追加后的切片

顺序与 NormalizeFieldName 一致，dst 为空时第一个元素就是原始名称 供调用方用栈上数组承接，避免为一个用完即弃的切片分配：

var buf [stringx.MaxFieldNameVariants]string
for _, name := range stringx.AppendFieldNameVariants(buf[:0], fieldName) {
    ...
}

pkg/safe 的链式取值就在热路径上这么用：先按原名直取，未命中才算变体

[EN] Appends the naming-style variants of a field name to dst in the same order as NormalizeFieldName, letting callers back dst with a stack array instead of allocating a slice they discard immediately. pkg/safe's chained access uses it exactly that way on its hot path

func CalculateMD5Hash ¶

func CalculateMD5Hash(input string) string

CalculateMD5Hash 计算string md5 hash值

func CleanEmpty ¶

func CleanEmpty(str string) string

CleanEmpty 清除空白串

func Coalesce ¶

func Coalesce(s ...string) string

Coalesce 高性能字符串拼接

func CompareIgnoreCase ¶

func CompareIgnoreCase(str1 string, str2 string) int

CompareIgnoreCase 比较两个字符串，用于排序(大小写不敏感)

func Contains ¶

func Contains(value string, searchStr string) bool

Contains 指定字符是否在字符串中出现过

func ContainsAll ¶

func ContainsAll(str string, searchStrs []string) bool

ContainsAll 检查指定字符串中是否含给定的所有字符串

func ContainsAny ¶

func ContainsAny(value string, searchStrs []string) bool

ContainsAny 查找指定字符串是否包含指定字符串列表中的任意一个字符串

func ContainsAnyIgnoreCase ¶

func ContainsAnyIgnoreCase(str string, searchStrs []string) bool

ContainsAnyIgnoreCase 找指定字符串是否包含指定字符串列表中的任意一个字符串（忽略大小写）

func ContainsBlank ¶

func ContainsBlank(str string) bool

ContainsBlank 给定字符串是否包含空白符（空白符包括空格、制表符、全角空格和不间断空格）

func ContainsIgnoreCase ¶

func ContainsIgnoreCase(value string, searchStr string) bool

ContainsIgnoreCase 指定字符是否在字符串中出现过(忽略大小写)

func ConvertCharacterStyle ¶

func ConvertCharacterStyle(input string, caseType CharacterStyle) string

ConvertCharacterStyle 根据指定的 CharacterStyle 将字符串转换为相应的格式

func Count ¶

func Count(str string, searchStr string) int

Count 统计指定内容中包含指定字符串的数量

func Cut ¶

func Cut(str string, n int) []string

Cut 将字符串切分为n等份

func DisplayWidth ¶

func DisplayWidth(s string) int

DisplayWidth 计算字符串的显示宽度 基于 East Asian Width 标准，考虑中文、日文、韩文、Emoji 等宽字符

func EndWith ¶

func EndWith(str string, suffix string) bool

EndWith 是否以指定字符串结尾

func EndWithAny ¶

func EndWithAny(str string, suffixes []string) bool

EndWithAny 给定字符串是否以任何一个字符串结尾 给定字符串和数组为空都返回false

func EndWithAnyIgnoreCase ¶

func EndWithAnyIgnoreCase(str string, suffixes []string) bool

EndWithAnyIgnoreCase 给定字符串是否以任何一个字符串结尾（忽略大小写） 给定字符串和数组为空都返回false

func EndWithIgnoreCase ¶

func EndWithIgnoreCase(str string, suffix string) bool

EndWithIgnoreCase 是否以指定字符串结尾，忽略大小写

func Equals ¶

func Equals(str1 string, str2 string) bool

Equals 比较2个字符串（大小写敏感）

func EqualsAny ¶

func EqualsAny(str1 string, str2 []string) bool

EqualsAny 给定字符串是否与提供的中任一字符串相同

func EqualsAnyIgnoreCase ¶

func EqualsAnyIgnoreCase(str1 string, str2 []string) bool

EqualsAnyIgnoreCase 给定字符串是否与提供的中任一字符串相同（忽略大小写）

func EqualsAt ¶

func EqualsAt(value string, position int, subStr string) bool

EqualsAt 字符串指定位置的字符是否与给定字符相同

func EqualsIgnoreCase ¶

func EqualsIgnoreCase(str1 string, str2 string) bool

EqualsIgnoreCase 比较2个字符串（大小写不敏感）

func EqualsTrimIgnoreCase ¶

func EqualsTrimIgnoreCase(str1 string, str2 string) bool

EqualsTrimIgnoreCase 去除首尾空白后忽略大小写比较字符串

func ExtractDomainPrefix ¶

func ExtractDomainPrefix(fullDomain, primaryDomain string) string

ExtractDomainPrefix 从完整域名中提取前缀 示例: ExtractDomainPrefix("www.example.com", "example.com") -> "www" 示例: ExtractDomainPrefix("example.com", "example.com") -> "@"

func ExtractValue ¶

func ExtractValue(extra string, key string, searchPrefix string) string

ExtractValue 从给定的字符串中提取指定的键的值

func FastAppendInt ¶

func FastAppendInt(buf []byte, val int) []byte

FastAppendInt 将整数追加到缓冲区

func FastFloat ¶

func FastFloat(val float64, prec int) string

FastFloat 浮点数转字符串

func FastFormatTime ¶

func FastFormatTime(buf []byte, t time.Time) []byte

FastFormatTime 格式化时间到缓冲区

func FastFormatTimeCompact ¶

func FastFormatTimeCompact(buf []byte, t time.Time) []byte

FastFormatTimeCompact 格式化时间到缓冲区，紧凑格式

func FastFormatTimeISO ¶

func FastFormatTimeISO(buf []byte, t time.Time) []byte

FastFormatTimeISO 格式化时间到缓冲区，ISO格式

func FastItoa ¶

func FastItoa(val int) string

FastItoa 整数转字符串

func Fill ¶

func Fill(str string, char string, length int, isPre bool) string

Fill 将已有字符串填充为规定长度，如果已有字符串超过这个长度则返回这个字符串

func FillAfter ¶

func FillAfter(str string, char string, length int) string

FillAfter 将已有字符串填充为规定长度，如果已有字符串超过这个长度则返回这个字符串

func FillBefore ¶

func FillBefore(str string, char string, length int) string

FillBefore 将已有字符串填充为规定长度，如果已有字符串超过这个长度则返回这个字符串

func FindKeysByValue ¶

func FindKeysByValue(data map[string]string, searchValue string) []string

FindKeysByValue 函数

func Format ¶

func Format(template string, params map[string]interface{}) string

Format 通过map中的参数 格式化字符串 map = {a: "aValue", b: "bValue"} format("{a} and {b}", map) ---=》 aValue and bValue

func GetContainsStr ¶

func GetContainsStr(str string, searchStrs []string) string

GetContainsStr 查找指定字符串是否包含指定字符串列表中的任意一个字符串，如果包含返回找到的第一个字符串 不存在返回空串

func Hide ¶

func Hide(str string, startInclude int, endExclude int) string

Hide 替换指定字符串的指定区间内字符为"*" 俗称：脱敏功能

func IndexOf ¶

func IndexOf(str string, subStr string) int

IndexOf 返回字符在原始字符串的下标

func IndexOfByRange ¶

func IndexOfByRange(str string, subStr string, start int, end int) int

IndexOfByRange 指定范围内查找指定字符

func IndexOfByRangeStart ¶

func IndexOfByRangeStart(str string, subStr string, start int) int

IndexOfByRangeStart 指定范围内查找指定字符

func IndexOfIgnoreCase ¶

func IndexOfIgnoreCase(str string, subStr string) int

IndexOfIgnoreCase 返回字符在原始字符串的下标(大小写不敏感)

func IndexOfIgnoreCaseByRange ¶

func IndexOfIgnoreCaseByRange(str string, subStr string, start int) int

IndexOfIgnoreCaseByRange 从指定下标开始，返回在字符串中的下标 (大小不敏感)

func IndexedFormat ¶

func IndexedFormat(template string, params []interface{}) string

IndexedFormat 有序的格式化文本，使用{number}做为占位符 通常使用：format("this is {0} for {1}", "a", "b") =》 this is a for b

性能：使用 strconv.Itoa + 字符串拼接构造占位符，避免 fmt.Sprintf 反射开销

func InsertSpaces ¶

func InsertSpaces(str string, interval int) string

InsertSpaces 插入空值

func IsSubdomain ¶

func IsSubdomain(subdomain, primaryDomain string) bool

IsSubdomain 判断是否为子域名

func LastIndexOf ¶

func LastIndexOf(str string, subStr string) int

LastIndexOf 返回最后出现指定字符串的下标

func LastIndexOfByRangeStart ¶

func LastIndexOfByRangeStart(str string, subStr string, start int) int

LastIndexOfByRangeStart 从指定下标开始，返回最后出现指定字符串的下标

func LastIndexOfIgnoreCase ¶

func LastIndexOfIgnoreCase(str string, subStr string) int

LastIndexOfIgnoreCase 返回最后出现指定字符串的下标（大小写不敏感）

func Length ¶

func Length(str string) int

Length 计算字符（rune）长度 使用 utf8.RuneCountInString 零分配遍历，替代 []rune(str) 的堆分配

func NormalizeFieldName ¶

func NormalizeFieldName(fieldName string) []string

NormalizeFieldName 规范化字段名，返回所有可能的命名风格变体 支持的输入格式：camelCase, PascalCase, snake_case, kebab-case 返回顺序：原始名称、PascalCase、camelCase、snake_case、kebab-case

重复的变体会被跳过原先逐项手写去重条件，kebab 只和原名、snake 比， 于是 "X1" 这类输入会得到 ["X1","x1","x1"]——调用方按变体逐个查找时， 同一个名字要查两遍，map 多一次哈希，结构体多一次 FieldByName 全字段扫描

[EN] Duplicate variants are skipped. The original hand-wrote its dedup conditions and compared kebab case only against the original and snake case, so an input like "X1" produced ["X1","x1","x1"] and a caller iterating the variants looked the same name up twice

func NormalizeSQLDirection ¶

func NormalizeSQLDirection(direction, defaultDirection string) string

NormalizeSQLDirection 规范化排序方向，仅允许 "ASC" 或 "DESC"（不区分大小写） direction: 输入的排序方向 defaultDirection: 默认方向（当输入无效时） 返回规范化后的排序方向（大写）

func OrdinalIndexOf ¶

func OrdinalIndexOf(str string, subStr string, ordinal int, start ...int) int

OrdinalIndexOf 返回字符串 subStr 在字符串 str 中第 ordinal 次出现的位置。 如果 str="" 或 subStr=" 或 ordinal≥0 则返回-1

func Pad ¶

func Pad(input string, minLength int, paddler ...*Paddler) string

Pad 输入的字符长度<minLength时自动补位*

func ParseFieldInt ¶

func ParseFieldInt(field string, min, max int) (int, error)

ParseFieldInt 解析字段，只支持单数字，不支持通配符。

func ParseFieldIntOrWildcard ¶

func ParseFieldIntOrWildcard(field string, wildcard string, min, max int) (int, error)

ParseFieldIntOrWildcard 解析字段，支持单个数字或指定的通配符字符串。 返回值： - 当字段等于 wildcard 时，返回 -1，表示任意值。 - 当字段为数字时，返回对应整数。 - 当字段无效或超出范围时，返回错误。

func QuoteJSONBytes ¶

func QuoteJSONBytes(str string) []byte

QuoteJSONBytes 将字符串按 JSON 字符串规则转义，并返回带双引号的字节切片

func Repeat ¶

func Repeat(str string, count int) string

Repeat 重复字符串

func RepeatAndJoin ¶

func RepeatAndJoin(str string, delimiter string, count int) string

RepeatAndJoin 重复某个字符串并通过分界符连接

func RepeatByLength ¶

func RepeatByLength(str string, padLen int) string

RepeatByLength 重复某个字符串到指定长度

func Replace ¶

func Replace(source string, searchStr string, replacement string, replaceCount int) string

Replace 替换字符串

func ReplaceAll ¶

func ReplaceAll(source string, searchStr string, replacement string) string

ReplaceAll 替换字符串

func ReplaceSpecialChars ¶

func ReplaceSpecialChars(str string, replaceValue rune) string

ReplaceSpecialChars 去掉特殊符号、转为自定义

func ReplaceWithIndex ¶

func ReplaceWithIndex(str string, startIndex int, endIndex int, replacedStr string) string

ReplaceWithIndex 按照指定区间替换字符串 startIndex 开始位置（包含） endIndex 结束位置（不包含）

func ReplaceWithMatcher ¶

func ReplaceWithMatcher(str string, regex string, replaceFun func(string) string) string

ReplaceWithMatcher 通过正则表达式替换字符串

正则会按模式串缓存，同一模式只编译一次，原因见 regexCache

func Reverse ¶

func Reverse(str string) string

Reverse 反转给定的字符串

func RuneWidth ¶

func RuneWidth(r rune) int

RuneWidth 返回单个 rune 的显示宽度 基于 East Asian Width 标准和终端显示规则： - ASCII 可见字符（0x20-0x7E）占 1 列 - 控制字符（0x00-0x1F, 0x7F-0x9F）占 0 列 - CJK 字符（中文、日文、韩文）占 2 列 - Emoji 表情符号占 2 列 - 其他字符默认占 1 列

func SafeIndexOfByRange ¶

func SafeIndexOfByRange(str string, subStr string, options ...func(*searchOptions)) (index int)

SafeIndexOfByRange 在指定范围内查找指定字符，避免下标溢出

func SanitizeSlug ¶

func SanitizeSlug(name string) string

SanitizeSlug 格式化字符串为 URL 友好的 slug 格式 规则：小写、去除空格、只保留字母数字和连字符、去除连续连字符、去除首尾连字符 适用场景：项目名称、域名、URL slug 等

示例：

SanitizeSlug("Hello World!")      // "hello-world"
SanitizeSlug("My--Project__123")  // "my-project-123"
SanitizeSlug("  -test-  ")        // "test"

func Split ¶

func Split(str string, separator string) []string

Split 分割字符串

func SplitAfterMapping ¶

func SplitAfterMapping[T any](str string, separator string, mapping func(s string) (T, error)) []T

SplitAfterMapping 切分字符串,切分之后通过mapping转换并返回

func SplitByLen ¶

func SplitByLen(str string, length int) []string

SplitByLen 根据给定长度，将给定字符串截取为多个部分

func SplitDomain ¶

func SplitDomain(fullDomain, primaryDomain string) (string, string)

SplitDomain 分割域名为前缀和主域名 返回: prefix, primaryDomain 示例: SplitDomain("www.api.example.com", "example.com") -> "www.api", "example.com"

func SplitLimit ¶

func SplitLimit(str string, separator string, limit int) []string

SplitLimit 分割字符串，限制分片数

func SplitTrim ¶

func SplitTrim(str string, separator string) []string

SplitTrim 切分字符串，去除切分后每个元素两边的空白符，去除空白项

func SplitTrimLimit ¶

func SplitTrimLimit(str string, separator string, limit int) []string

SplitTrimLimit 切分字符串，去除切分后每个元素两边的空白符，去除空白项，限制分片数

func StartWith ¶

func StartWith(str string, prefix string) bool

StartWith 字符串是否以给定字符开始

func StartWithAny ¶

func StartWithAny(str string, prefixes []string) bool

StartWithAny 给定字符串是否以任何一个字符串开始; 给定字符串和数组为空都返回false

func StartWithAnyIgnoreCase ¶

func StartWithAnyIgnoreCase(str string, prefixes []string) bool

StartWithAnyIgnoreCase 给定字符串是否以任何一个字符串开始(忽略大小写) 给定字符串和数组为空都返回false

func StartWithIgnoreCase ¶

func StartWithIgnoreCase(str string, prefix string) bool

StartWithIgnoreCase 字符串是否以给定字符开始-忽略大小写

func SubAfter ¶

func SubAfter(str string, separator string, isLastSeparator bool) string

SubAfter 截取分隔字符串之后的字符串，不包括分隔字符串

func SubBefore ¶

func SubBefore(str string, separator string, isLastSeparator bool) string

SubBefore 截取分隔字符串之前的字符串，不包括分隔字符串 isLastSeparator - 是否查找最后一个分隔字符串（多次出现分隔字符串时选取最后一个），true为选取最后一个

func SubBetween ¶

func SubBetween(str string, before string, after string) string

SubBetween 截取指定字符串中间部分，不包括标识字符串

func SubBetweenAll ¶

func SubBetweenAll(str string, prefix string, suffix string) []string

SubBetweenAll 截取指定字符串多段中间部分，不包括标识字符串

func SubString ¶

func SubString(s string, start, length int) string

SubString 截取字符串，从 start 位置开始，截取 length 长度 如果 start 超出范围或为负数，返回空字符串 如果 length 超出剩余长度，截取到字符串末尾

func ToCamelCase ¶

func ToCamelCase(s string) string

ToCamelCase 将字符串转换为驼峰命名法（首字母小写，例如：userName） 支持输入格式：PascalCase, snake_case, kebab-case

func ToInt ¶

func ToInt(s string) (int, error)

func ToKebabCase ¶

func ToKebabCase(s string) string

ToKebabCase 将字符串转换为短横线命名法（例如：user-name） 支持输入格式：camelCase, PascalCase, snake_case

func ToLower ¶

func ToLower(str string) string

ToLower 将字符串转换为小写 直接委托标准库 strings.ToLower：标准库已做极致优化（ASCII 快速路径 + SIMD），

func ToPascalCase ¶

func ToPascalCase(s string) string

ToPascalCase 将字符串转换为帕斯卡命名法（首字母大写的驼峰，例如：UserName） 支持输入格式：camelCase, snake_case, kebab-case, 普通字符串（带空格） 增强版：合并了原 toStudlyCase 的逻辑，统一处理所有分隔符

func ToSliceByte ¶

func ToSliceByte(s string) []byte

ToSliceByte 将字符串转换为字节切片

func ToSnakeCase ¶

func ToSnakeCase(s string) string

ToSnakeCase 将字符串转换为蛇形命名法（例如：user_name） 支持输入格式：camelCase, PascalCase, kebab-case

func ToTitle ¶

func ToTitle(str string) string

ToTitle 将字符串转换为标题格式（每个单词首字母大写）

func ToUpper ¶

func ToUpper(str string) string

ToUpper 将字符串转换为大写 直接委托标准库 strings.ToUpper：标准库已做极致优化（ASCII 快速路径 + SIMD）

func Trim ¶

func Trim(str string) string

Trim 除去字符串头尾部的空白

func TrimAll ¶

func TrimAll(str string, strToRemove string) string

TrimAll 移除字符串中所有给定字符串 示例：TrimAll("aa-bb-cc-dd", "-") => "aabbccdd"

func TrimAllLineBreaks ¶

func TrimAllLineBreaks(str string) string

TrimAllLineBreaks 去除所有换行符，包括：\r \n

func TrimAny ¶

func TrimAny(str string, strsToRemove []string) string

TrimAny 移除字符串中所有给定的多个字符串

func TrimEnd ¶

func TrimEnd(str string) string

TrimEnd 除去字符串尾部的空白

func TrimEndNewlines ¶

func TrimEndNewlines(str string) string

TrimEndNewlines 除去字符串结尾的换行符（\n 和 \r）

func TrimNewlines ¶

func TrimNewlines(str string) string

TrimNewlines 除去字符串首尾的换行符（\n 和 \r）

func TrimPrefix ¶

func TrimPrefix(str string, prefix string) string

TrimPrefix 去掉指定前缀

func TrimPrefixIgnoreCase ¶

func TrimPrefixIgnoreCase(str string, prefix string) string

TrimPrefixIgnoreCase 忽略大小写去掉指定前缀

func TrimProtocol ¶

func TrimProtocol(url string) string

TrimProtocol 移除URL的协议前缀 (支持 http://, https://, ftp://, ws://, wss://, file:// 等所有协议)，并移除尾部空格

func TrimStart ¶

func TrimStart(str string) string

TrimStart 除去字符串头部的空白

func TrimStartNewlines ¶

func TrimStartNewlines(str string) string

TrimStartNewlines 除去字符串开头的换行符（\n 和 \r）

func TrimSuffix ¶

func TrimSuffix(str string, suffix string) string

TrimSuffix 去掉指定后缀

func TrimSuffixIgnoreCase ¶

func TrimSuffixIgnoreCase(str string, suffix string) string

TrimSuffixIgnoreCase 去掉指定后缀（忽略大小写）

func TrimSymbols ¶

func TrimSymbols(str string) string

TrimSymbols 使用正则表达式去掉字符串中的所有符号

func Truncate ¶

func Truncate(str string, maxBytes int) string

Truncate 截断字符串，使用不超过maxBytes长度

func TruncateAppendEllipsis ¶

func TruncateAppendEllipsis(str string, maxChars int) string

TruncateAppendEllipsis 截断字符串，使用不超过maxChars字符长度。截断后自动追加省略号(...) 用于存储数据库varchar且编码为UTF-8的字段

func TruncateMessage ¶

func TruncateMessage(content string, maxLen int) string

TruncateMessage 截断消息内容用于日志显示

func UniqueStringSlice ¶

func UniqueStringSlice(slice []string) []string

func WithEnd ¶

func WithEnd(end int) func(*searchOptions)

WithEnd 用于配置结束位置

func WithStart ¶

func WithStart(start int) func(*searchOptions)

WithStart 用于配置起始位置