hutool.core.text.str_builder¶
Module Contents¶
Classes¶
字符串构建器，类似Java StringBuilder |
API¶
- class hutool.core.text.str_builder.StrBuilder(capacity: int = 16)¶
字符串构建器，类似Java StringBuilder
提供高效的字符串拼接操作，内部使用列表缓存各段字符串， 最终在 to_string 时一次性拼接，避免频繁字符串拼接带来的性能问题。
Initialization
初始化字符串构建器
- 参数:
capacity – 初始容量（提示性，不强制约束）
- _to_str() str¶
内部方法：将当前所有片段拼接为完整字符串
- append(*args: object) hutool.core.text.str_builder.StrBuilder¶
追加内容
支持追加任意类型，会自动调用 str() 转换。 可一次追加多个对象，也可追加列表/元组（展开其元素）。
- 参数:
args – 要追加的一个或多个对象
- 返回:
self，支持链式调用
- insert(index: int, obj: object) hutool.core.text.str_builder.StrBuilder¶
在指定位置插入内容
- 参数:
index – 插入位置索引
obj – 要插入的对象，会被转换为字符串
- 返回:
self，支持链式调用
- 抛出:
IndexError – 索引越界
- delete(start: int, end: int) hutool.core.text.str_builder.StrBuilder¶
删除指定范围的内容 [start, end)
- 参数:
start – 起始索引（包含）
end – 结束索引（不包含）
- 返回:
self，支持链式调用
- 抛出:
IndexError – 索引越界
- replace(start: int, end: int, string: str) hutool.core.text.str_builder.StrBuilder¶
替换指定范围的内容 [start, end)
- 参数:
start – 起始索引（包含）
end – 结束索引（不包含）
string – 替换内容
- 返回:
self，支持链式调用
- 抛出:
IndexError – 索引越界
- reverse() hutool.core.text.str_builder.StrBuilder¶
反转字符串内容
- 返回:
self，支持链式调用
- to_string() str¶
转为字符串
- 返回:
当前构建器中的完整字符串
- length() int¶
获取当前字符串长度
- 返回:
字符串长度
- is_empty() bool¶
判断构建器是否为空
- 返回:
为空返回 True，否则返回 False
- char_at(index: int) str¶
获取指定位置的字符
- 参数:
index – 字符索引
- 返回:
指定位置的字符
- 抛出:
IndexError – 索引越界
- index_of(string: str, start: int = 0) int¶
查找子串首次出现的位置
- 参数:
string – 要查找的子串
start – 起始搜索位置，默认为0
- 返回:
子串首次出现的索引，未找到返回 -1
- last_index_of(string: str) int¶
从后查找子串最后一次出现的位置
- 参数:
string – 要查找的子串
- 返回:
子串最后一次出现的索引，未找到返回 -1
- substring(start: int, end: Optional[int] = None) str¶
获取子串
- 参数:
start – 起始索引（包含）
end – 结束索引（不包含），默认到末尾
- 返回:
截取的子串
- starts_with(prefix: str) bool¶
判断是否以指定字符串开头
- 参数:
prefix – 前缀字符串
- 返回:
是返回 True，否则返回 False
- ends_with(suffix: str) bool¶
判断是否以指定字符串结尾
- 参数:
suffix – 后缀字符串
- 返回:
是返回 True，否则返回 False
- contains(string: str) bool¶
判断是否包含指定字符串
- 参数:
string – 要查找的子串
- 返回:
包含返回 True，否则返回 False
- trim() hutool.core.text.str_builder.StrBuilder¶
去除首尾空白字符
- 返回:
self，支持链式调用
- clear() hutool.core.text.str_builder.StrBuilder¶
清空构建器
- 返回:
self，支持链式调用
- __str__() str¶
- __len__() int¶
- __repr__() str¶