Package org.aoju.bus.core.text
Class TextBuilder
java.lang.Object
org.aoju.bus.core.text.TextBuilder
- All Implemented Interfaces:
Serializable,Appendable,CharSequence,Builder<String>
提供比StringBuffer更灵活和更强大的API
- Since:
- Java 17+
- Author:
- Kimi Liu
- See Also:
-
Nested Class Summary
Nested classes/interfaces inherited from interface org.aoju.bus.core.builder.Builder
Builder.HashKey -
Field Summary
Fields -
Constructor Summary
ConstructorsConstructorDescription构造TextBuilder(int initialCapacity) 构造TextBuilder(CharSequence... texts) 创建字符串构建器TextBuilder(String text) 构造 -
Method Summary
Modifier and TypeMethodDescriptionappend(boolean value) 将布尔值附加到字符串生成器.append(char ch) 将char值附加到字符串生成器.append(char[] chars) 向字符串生成器追加一个char数组 附加null将调用appendNull().append(char[] chars, int startIndex, int length) 向字符串生成器追加一个char数组 附加null将调用appendNull()append(double value) 使用String.valueOf向字符串生成器追加一个double值append(float value) 使用String.valueOf向字符串生成器追加一个float值append(int value) 使用String.valueOf向字符串生成器追加一个int值append(long value) 使用String.valueOf向字符串生成器追加一个long值append(CharSequence seq) 将对象附加到此字符串生成器 附加null将调用appendNull().append(CharSequence seq, int startIndex, int length) 将对象附加到此字符串生成器 附加null将调用appendNull().将对象附加到此字符串生成器 附加null将调用appendNull().将对象附加到此字符串生成器 附加null将调用appendNull().append(StringBuffer text) 将对象附加到此字符串生成器 附加null将调用appendNull().append(StringBuffer text, int startIndex, int length) 将对象附加到此字符串生成器 附加null将调用appendNull().append(StringBuilder text) 将对象附加到此字符串生成器 附加null将调用appendNull().append(StringBuilder text, int startIndex, int length) 将StringBuilder的一部分附加到此字符串生成器 附加null将调用appendNull()将对象附加到此字符串生成器 附加null将调用appendNull().调用String.format(String, Object...)并附加结果append(CharBuffer buf) 将char缓冲区的内容附加到此字符串生成器 附加null将调用appendNull().append(CharBuffer buf, int startIndex, int length) 将char缓冲区的内容附加到此字符串生成器 附加null将调用appendNull().append(TextBuilder text) 将String的一部分附加到此字符串生成器 附加null将调用appendNull()append(TextBuilder text, int startIndex, int length) 将字符串生成器的一部分附加到此字符串生成器 附加null将调用appendNull().在不使用任何分隔符的情况下将迭代中的每个项附加到生成器 附加一个null iterable将没有效果 每个对象都使用append(Object)进行追加在不使用任何分隔符的情况下将迭代器中的每个项附加到生成器 附加一个空迭代器将没有效果 每个对象都使用append(Object)进行追加.<T> TextBuilderappendAll(T... array) 不使用任何分隔符将数组中的每个项添加到生成器 附加一个空数组将没有效果 每个对象都使用append(Object)进行追加appendFixedWidthPadLeft(int value, int width, char padChar) 将一个对象附加到左侧的生成器内边距上,使其具有固定的宽度 使用String.valueOf字符串,使用int如果格式化的值大于长度,则左侧边将丢失appendFixedWidthPadLeft(Object object, int width, char padChar) 将一个对象附加到左侧的生成器内边距上,使其具有固定的宽度。appendFixedWidthPadRight(int value, int width, char padChar) 将对象附加到右侧的生成器内边距,使其具有固定的长度 使用String.valueOf字符串,使用int如果格式化的值大于长度,则右侧将丢失appendFixedWidthPadRight(Object object, int width, char padChar) 将对象附加到右侧的生成器内边距,使其具有固定的长度 使用对象的toString如果物体比长度大,右边的部分就会丢失 如果对象为空,则使用空文本值appendln(boolean value) 将布尔值后跟新行追加到字符串生成器.appendln(char ch) 向字符串生成器追加一个字符值,后跟一个新行.appendln(char[] chars) 向此字符串生成器追加一个字符串缓冲区,后跟新行 附加null将调用appendNull()appendln(char[] chars, int startIndex, int length) 向字符串生成器追加一个字符数组,后跟一个新行 附加null将调用appendNull()appendln(double value) 使用String.valueOf向字符串生成器追加一个double值,后面跟一个新行appendln(float value) 使用String.valueOf向字符串生成器追加一个float值,后面跟一个新行appendln(int value) 使用String.valueOf向字符串生成器追加一个int值,后面跟一个新行appendln(long value) 使用String.valueOf向字符串生成器追加一个long值,后面跟一个新行将对象后接新行追加到此字符串生成器 附加null将调用appendNull()将对象后接新行追加到此字符串生成器 附加null将调用appendNull()appendln(StringBuffer text) 向此字符串生成器追加一个字符串缓冲区,后跟新行 附加null将调用appendNull()appendln(StringBuffer text, int startIndex, int length) 向此字符串生成器追加一个字符串缓冲区,后跟新行 附加null将调用appendNull()appendln(StringBuilder text) 向此字符串生成器追加一个字符串缓冲区,后跟新行 * 附加null将调用appendNull()appendln(StringBuilder text, int startIndex, int length) 向此字符串生成器追加一个字符串缓冲区,后跟新行 附加null将调用appendNull()将对象后接新行追加到此字符串生成器 附加null将调用appendNull()appendln(TextBuilder text) 向此字符串生成器追加一个字符串缓冲区,后跟新行 附加null将调用appendNull()appendln(TextBuilder text, int startIndex, int length) 向此字符串生成器追加一个字符串缓冲区,后跟新行 附加null将调用appendNull()将新行字符串附加到此字符串生成器将表示null的文本附加到此字符串生成器.appendWithSeparators(Iterable<?> iterable, String separator) 在每个值之间追加一个可迭代的放置分隔符,但不是在第一个值之前或最后一个值之后 附加一个null iterable将没有效果 每个对象都使用append(Object)进行追加.appendWithSeparators(Object[] array, String separator) 在每个值之间追加放置分隔符的数组,但不在第一个值之前或最后一个值之后追加 附加一个空数组将没有效果 每个对象都使用append(Object)进行追加appendWithSeparators(Iterator<?> it, String separator) 在每个值之间添加分隔符,但不在第一个值之前或最后一个值之后添加迭代器 附加一个空迭代器将没有效果 每个对象都使用append(Object)进行追加.build()实现Builder接口intcapacity()charcharAt(int index) clear()booleancontains(char ch) 检查字符串生成器是否包含指定的字符boolean检查字符串生成器是否包含指定的字符串boolean检查字符串生成器是否包含使用指定匹配器匹配的字符串static TextBuildercreate(int initialCapacity) 创建字符串构建器static TextBuildercreate(CharSequence... texts) 创建字符串构建器delete(int startIndex, int endIndex) 删除两个指定索引之间的字符deleteAll(char ch) 删除在生成器中出现的字符.删除生成器中出现的字符串删除匹配程序匹配的生成器的所有部分.deleteCharAt(int index) 删除指定索引处的字符deleteFirst(char ch) 删除在生成器中出现的字符deleteFirst(String text) 删除生成器中出现的字符串deleteFirst(Matchers matcher) 使用指定的匹配器删除生成器中的第一个匹配项.boolean检查此生成器是否以指定的字符串结束ensureCapacity(int capacity) 检查容量并确保它至少是指定的大小boolean检查此生成器的内容与另一个生成器的内容是否包含相同的字符内容.booleanequals(TextBuilder other) 检查此生成器的内容与另一个生成器的内容是否包含相同的字符内容.booleanequalsIgnoreCase(TextBuilder other) 检查此生成器的内容与另一个生成器的内容是否包含相同的字符内容(忽略大小写)char[]getChars(char[] destination) 将字符数组复制到指定的数组中.voidgetChars(int startIndex, int endIndex, char[] destination, int destinationIndex) 将字符数组复制到指定的数组中inthashCode()intindexes()intindexOf(char ch) 搜索字符串生成器以查找指定char类型的第一个引用.intindexOf(char ch, int startIndex) 搜索字符串生成器以查找指定char类型的第一个引用.int搜索字符串生成器以查找指定字符串的第一个引用int从给定索引开始搜索,搜索字符串生成器以查找指定字符串的第一个引用int使用matcher搜索字符串生成器以查找第一个匹配项.int使用matcher搜索字符串生成器,以查找从给定索引中搜索的第一个匹配项.insert(int index, boolean value) 将值插入此生成器.insert(int index, char value) 将值插入此生成器.insert(int index, char[] chars) 将字符数组插入到此生成器中.insert(int index, char[] chars, int offset, int length) 将字符数组的一部分插入到此生成器中.insert(int index, double value) 将值插入此生成器.insert(int index, float value) 将值插入此生成器.insert(int index, int value) 将值插入此生成器.insert(int index, long value) 将值插入此生成器.将对象的字符串表示形式插入到此生成器中 插入null将使用存储的空文本值将字符串插入到此生成器中.booleanisEmpty()intlastIndexOf(char ch) 搜索字符串生成器以查找对指定字符的最后一个引用.intlastIndexOf(char ch, int startIndex) 搜索字符串生成器以查找对指定字符的最后一个引用.intlastIndexOf(String text) 搜索字符串生成器以查找对指定字符串的最后引用intlastIndexOf(String text, int startIndex) 从给定索引开始搜索,搜索字符串生成器以查找指定字符串的最后一个引用intlastIndexOf(Matchers matcher) 使用matcher搜索字符串生成器以查找最后一个匹配项intlastIndexOf(Matchers matcher, int startIndex) 使用matcher搜索字符串生成器,以查找从给定索引中搜索的最后一个匹配项leftString(int length) 从字符串生成器中提取最左边的字符而不引发异常.intlength()midString(int index, int length) 从字符串生成器中间提取一些字符而不引发异常static TextBuilderof()创建字符串构建器int如果可能,从提供的Readable直接将字符读入底层字符缓冲区,而不进行额外的复制将字符串生成器的一部分替换为另一个字符串 插入字符串的长度不必与删除的长度匹配高级搜索并在构建器中使用匹配器进行替换replaceAll(char search, char replace) 在整个生成器中使用替换字符替换搜索字符replaceAll(String searchStr, String replaceStr) 在整个生成器中使用替换字符串替换搜索字符串replaceAll(Matchers matcher, String replaceStr) 用替换字符串替换生成器中的所有匹配项replaceFirst(char search, char replace) 用生成器中的替换字符替换搜索字符的第一个实例.replaceFirst(String searchStr, String replaceStr) 用替换字符串替换搜索字符串的第一个实例replaceFirst(Matchers matcher, String replaceStr) 用替换字符串替换生成器中的所有匹配项reset()删除全部字符,位置归零reverse()反转将每个字符放在相反索引中的字符串生成器rightString(int length) 从字符串生成器中提取最右边的字符而不引发异常.setCharAt(int index, char ch) 在指定的索引处设置字符setLength(int length) 通过删除最后一个字符或添加Unicode 0的填充来更新生成器的长度setNewLineText(String newLine) setNullText(String nullText) booleanstartsWith(String text) 检查此生成器是否以指定的字符串开始subSequence(int start, int end) subString(int start) 返回自定段的字符串subString(int start, int end) 返回自定段的字符串toString()toString(boolean isReset) 生成字符串获取字符串生成器的StringBuffer版本,在每次调用该方法时创建一个新实例获取字符串生成器的StringBuilder版本,在每次调用该方法时创建一个新实例static inttotalLength(CharSequence... texts) 给定字符串数组的总长度 null字符长度定义为0trim()通过从开头和结尾删除小于或等于空格的字符来修剪生成器protected voidvalidateIndex(int index) 验证在生成器中定义单个索引的参数protected intvalidateRange(int startIndex, int endIndex) 验证定义生成器范围的参数Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, waitMethods inherited from interface java.lang.CharSequence
chars, codePoints
-
Field Details
-
CAPACITY
public static final int CAPACITY默认容量- See Also:
-
buffer
public char[] buffer存放的字符数组 -
indexes
public int indexes当前指针位置
-
-
Constructor Details
-
TextBuilder
public TextBuilder()构造 -
TextBuilder
public TextBuilder(int initialCapacity) 构造- Parameters:
initialCapacity- 初始容量
-
TextBuilder
-
TextBuilder
-
-
Method Details
-
of
-
create
创建字符串构建器- Parameters:
initialCapacity- 初始容量- Returns:
TextBuilder
-
create
创建字符串构建器- Parameters:
texts- 初始字符串- Returns:
TextBuilder
-
totalLength
给定字符串数组的总长度 null字符长度定义为0- Parameters:
texts- 字符串数组- Returns:
- 总长度
-
length
public int length()- Specified by:
lengthin interfaceCharSequence
-
charAt
public char charAt(int index) - Specified by:
charAtin interfaceCharSequence
-
getNewLineText
-
setNewLineText
-
getNullText
-
setNullText
-
setLength
通过删除最后一个字符或添加Unicode 0的填充来更新生成器的长度- Parameters:
length- 要设置的长度必须为0或正- Returns:
- this
- Throws:
IndexOutOfBoundsException- 如果长度是负的
-
capacity
public int capacity() -
ensureCapacity
检查容量并确保它至少是指定的大小- Parameters:
capacity- 确保大小- Returns:
- this
-
indexes
public int indexes() -
isEmpty
public boolean isEmpty()- Specified by:
isEmptyin interfaceCharSequence
-
clear
-
reset
-
setCharAt
在指定的索引处设置字符- Parameters:
index- 要设置的索引ch- 新字符- Returns:
- this
- Throws:
IndexOutOfBoundsException- 如果索引无效- See Also:
-
deleteCharAt
删除指定索引处的字符- Parameters:
index- 要删除的索引- Returns:
- this
- Throws:
IndexOutOfBoundsException- 如果索引无效- See Also:
-
getChars
public char[] getChars(char[] destination) 将字符数组复制到指定的数组中.- Parameters:
destination- 目标数组,null将导致创建一个数组- Returns:
- 输入数组,除非它是null或太小
-
getChars
public void getChars(int startIndex, int endIndex, char[] destination, int destinationIndex) 将字符数组复制到指定的数组中- Parameters:
startIndex- 要复制的第一个索引(包括)必须有效endIndex- 最后一个索引(exclusive)必须有效destination- 目标数组不能为空或太小destinationIndex- 要在目的地开始复制的索引- Throws:
NullPointerException- 如果数组为空IndexOutOfBoundsException- 如果任何索引无效
-
readFrom
如果可能,从提供的Readable直接将字符读入底层字符缓冲区,而不进行额外的复制- Parameters:
readable- 读取对象- Returns:
- 读取的字符数
- Throws:
IOException- 如果发生I/O错误
-
appendNewLine
-
appendNull
-
append
将对象附加到此字符串生成器 附加null将调用appendNull().- Parameters:
object- 要追加的对象- Returns:
- this
-
append
将对象附加到此字符串生成器 附加null将调用appendNull().- Specified by:
appendin interfaceAppendable- Parameters:
seq- 要附加的字符序列- Returns:
- this
-
append
将对象附加到此字符串生成器 附加null将调用appendNull().- Specified by:
appendin interfaceAppendable- Parameters:
seq- 要附加的字符序列startIndex- 起始索引(包括起始索引)必须有效length- 要追加的长度必须有效- Returns:
- this
-
append
将对象附加到此字符串生成器 附加null将调用appendNull().- Parameters:
text- 要追加的字符串- Returns:
- this
-
append
将对象附加到此字符串生成器 附加null将调用appendNull().- Parameters:
text- 要追加的字符串startIndex- 起始索引(包括起始索引)必须有效length- 要追加的长度必须有效- Returns:
- this
-
append
调用String.format(String, Object...)并附加结果- Parameters:
format- 格式字符串objs- 要在格式字符串中使用的对象- Returns:
- this
- See Also:
-
append
将char缓冲区的内容附加到此字符串生成器 附加null将调用appendNull().- Parameters:
buf- 要附加的字符缓冲区- Returns:
- this
-
append
将char缓冲区的内容附加到此字符串生成器 附加null将调用appendNull().- Parameters:
buf- 要附加的字符缓冲区startIndex- 起始索引(包括起始索引)必须有效length- 要追加的长度必须有效- Returns:
- this
-
append
将对象附加到此字符串生成器 附加null将调用appendNull().- Parameters:
text- 要追加的字符串- Returns:
- this
-
append
将对象附加到此字符串生成器 附加null将调用appendNull().- Parameters:
text- 要追加的字符串startIndex- 起始索引(包括起始索引)必须有效length- 要追加的长度必须有效- Returns:
- this
-
append
将对象附加到此字符串生成器 附加null将调用appendNull().- Parameters:
text- 要追加的字符串- Returns:
- this
-
append
将StringBuilder的一部分附加到此字符串生成器 附加null将调用appendNull()- Parameters:
text- 要追加的字符串startIndex- 起始索引(包括起始索引)必须有效length- 要追加的长度必须有效- Returns:
- this
-
append
将String的一部分附加到此字符串生成器 附加null将调用appendNull()- Parameters:
text- 要追加的字符串- Returns:
- this
-
append
将字符串生成器的一部分附加到此字符串生成器 附加null将调用appendNull().- Parameters:
text- 要追加的字符串startIndex- 起始索引(包括起始索引)必须有效length- 要追加的长度必须有效- Returns:
- this
-
append
向字符串生成器追加一个char数组 附加null将调用appendNull().- Parameters:
chars- 要附加的字符数组- Returns:
- this
-
append
向字符串生成器追加一个char数组 附加null将调用appendNull()- Parameters:
chars- 要附加的字符数组startIndex- 起始索引(包括起始索引)必须有效length- 要追加的长度必须有效- Returns:
- this
-
append
-
append
将char值附加到字符串生成器.- Specified by:
appendin interfaceAppendable- Parameters:
ch- 要附加的值- Returns:
- this
-
append
使用String.valueOf向字符串生成器追加一个int值- Parameters:
value- 要附加的值- Returns:
- this
-
append
使用String.valueOf向字符串生成器追加一个long值- Parameters:
value- 要附加的值- Returns:
- this
-
append
使用String.valueOf向字符串生成器追加一个float值- Parameters:
value- 要附加的值- Returns:
- this
-
append
使用String.valueOf向字符串生成器追加一个double值- Parameters:
value- 要附加的值- Returns:
- this
-
appendln
将对象后接新行追加到此字符串生成器 附加null将调用appendNull()- Parameters:
object- 要附加的值- Returns:
- this
-
appendln
将对象后接新行追加到此字符串生成器 附加null将调用appendNull()- Parameters:
text- 要附加的值- Returns:
- this
-
appendln
将对象后接新行追加到此字符串生成器 附加null将调用appendNull()- Parameters:
text- 要附加的值startIndex- 起始索引(包括起始索引)必须有效length- 要追加的长度必须有效- Returns:
- this
-
appendln
- Parameters:
format- 格式字符串objs- 要在格式字符串中使用的对象- Returns:
- this
- See Also:
-
appendln
向此字符串生成器追加一个字符串缓冲区,后跟新行 附加null将调用appendNull()- Parameters:
text- 要追加的字符串缓冲区- Returns:
- this
-
appendln
向此字符串生成器追加一个字符串缓冲区,后跟新行 * 附加null将调用appendNull()- Parameters:
text- t他附加字符串生成器- Returns:
- this
-
appendln
向此字符串生成器追加一个字符串缓冲区,后跟新行 附加null将调用appendNull()- Parameters:
text- 要追加的字符串缓冲区startIndex- 起始索引(包括起始索引)必须有效length- 要追加的长度必须有效- Returns:
- this
-
appendln
向此字符串生成器追加一个字符串缓冲区,后跟新行 附加null将调用appendNull()- Parameters:
text- 要追加的字符串缓冲区startIndex- 起始索引(包括起始索引)必须有效length- 要追加的长度必须有效- Returns:
- this
-
appendln
向此字符串生成器追加一个字符串缓冲区,后跟新行 附加null将调用appendNull()- Parameters:
text- 要追加的字符串缓冲区- Returns:
- this
-
appendln
向此字符串生成器追加一个字符串缓冲区,后跟新行 附加null将调用appendNull()- Parameters:
text- 要追加的字符串缓冲区startIndex- 起始索引(包括起始索引)必须有效length- 要追加的长度必须有效- Returns:
- this
-
appendln
向此字符串生成器追加一个字符串缓冲区,后跟新行 附加null将调用appendNull()- Parameters:
chars- 要附加的字符数组- Returns:
- this
-
appendln
向字符串生成器追加一个字符数组,后跟一个新行 附加null将调用appendNull()- Parameters:
chars- 要追加的字符串缓冲区startIndex- 起始索引(包括起始索引)必须有效length- 要追加的长度必须有效- Returns:
- this
-
appendln
将布尔值后跟新行追加到字符串生成器.- Parameters:
value- 要附加的值- Returns:
- this
-
appendln
-
appendln
使用String.valueOf向字符串生成器追加一个int值,后面跟一个新行- Parameters:
value- 要附加的值- Returns:
- this
-
appendln
使用String.valueOf向字符串生成器追加一个long值,后面跟一个新行- Parameters:
value- 要附加的值- Returns:
- this
-
appendln
使用String.valueOf向字符串生成器追加一个float值,后面跟一个新行- Parameters:
value- 要附加的值- Returns:
- this
-
appendln
使用String.valueOf向字符串生成器追加一个double值,后面跟一个新行- Parameters:
value- 要附加的值- Returns:
- this
-
appendAll
不使用任何分隔符将数组中的每个项添加到生成器 附加一个空数组将没有效果 每个对象都使用append(Object)进行追加- Type Parameters:
T- 元素类型- Parameters:
array- 要追加的数组- Returns:
- this
-
appendAll
在不使用任何分隔符的情况下将迭代中的每个项附加到生成器 附加一个null iterable将没有效果 每个对象都使用append(Object)进行追加- Parameters:
iterable- 可追加的迭代- Returns:
- this
-
appendAll
在不使用任何分隔符的情况下将迭代器中的每个项附加到生成器 附加一个空迭代器将没有效果 每个对象都使用append(Object)进行追加.- Parameters:
it- 要追加的迭代器- Returns:
- this
-
appendWithSeparators
在每个值之间追加放置分隔符的数组,但不在第一个值之前或最后一个值之后追加 附加一个空数组将没有效果 每个对象都使用append(Object)进行追加- Parameters:
array- 要追加的数组separator- 要使用的分隔符,null表示没有分隔符- Returns:
- this
-
appendWithSeparators
在每个值之间追加一个可迭代的放置分隔符,但不是在第一个值之前或最后一个值之后 附加一个null iterable将没有效果 每个对象都使用append(Object)进行追加.- Parameters:
iterable- 可追加的迭代separator- 要使用的分隔符,null表示没有分隔符- Returns:
- this
-
appendWithSeparators
在每个值之间添加分隔符,但不在第一个值之前或最后一个值之后添加迭代器 附加一个空迭代器将没有效果 每个对象都使用append(Object)进行追加.- Parameters:
it- 要追加的迭代器separator- 要使用的分隔符,null表示没有分隔符- Returns:
- this
-
appendFixedWidthPadLeft
将一个对象附加到左侧的生成器内边距上,使其具有固定的宽度。 使用对象的toString如果对象的长度大于长度,则左手边就会丢失 如果对象为空,则使用空文本值- Parameters:
object- 要追加的对象null使用空文本width- 固定的字段宽度,零或负没有影响padChar- 要使用的填充字符- Returns:
- this
-
appendFixedWidthPadLeft
将一个对象附加到左侧的生成器内边距上,使其具有固定的宽度 使用String.valueOf字符串,使用int如果格式化的值大于长度,则左侧边将丢失- Parameters:
value- 要附加的值width- 固定的字段宽度,零或负没有影响padChar- 要使用的填充字符- Returns:
- this
-
appendFixedWidthPadRight
将对象附加到右侧的生成器内边距,使其具有固定的长度 使用对象的toString如果物体比长度大,右边的部分就会丢失 如果对象为空,则使用空文本值- Parameters:
object- 要追加的对象null使用空文本width- 固定的字段宽度,零或负没有影响padChar- 要使用的填充字符- Returns:
- this
-
appendFixedWidthPadRight
将对象附加到右侧的生成器内边距,使其具有固定的长度 使用String.valueOf字符串,使用int如果格式化的值大于长度,则右侧将丢失- Parameters:
value- 要附加的值width- 固定的字段宽度,零或负没有影响padChar- 要使用的填充字符- Returns:
- this
-
insert
将对象的字符串表示形式插入到此生成器中 插入null将使用存储的空文本值- Parameters:
index- 要添加的索引必须有效object- 要插入的对象- Returns:
- this
- Throws:
IndexOutOfBoundsException- 如果索引无效
-
insert
将字符串插入到此生成器中. 插入null将使用存储的空文本值.- Parameters:
index- 要添加的索引必须有效text- 要插入的字符串- Returns:
- this
- Throws:
IndexOutOfBoundsException- 如果索引无效
-
insert
将字符数组插入到此生成器中. 插入null将使用存储的空文本值.- Parameters:
index- 要添加的索引必须有效chars- 要插入的char数组- Returns:
- this
- Throws:
IndexOutOfBoundsException- 如果索引无效
-
insert
将字符数组的一部分插入到此生成器中. 插入null将使用存储的空文本值.- Parameters:
index- 要添加的索引必须有效chars- 要插入的char数组offset- 字符数组中要开始的偏移量必须有效length- 要复制的字符数组部分的长度必须为正- Returns:
- this
- Throws:
IndexOutOfBoundsException- 如果任何索引无效
-
insert
将值插入此生成器.- Parameters:
index- 要添加的索引必须有效value- 要插入的值- Returns:
- this
- Throws:
IndexOutOfBoundsException- 如果索引无效
-
insert
将值插入此生成器.- Parameters:
index- 要添加的索引必须有效value- 要插入的值- Returns:
- this
- Throws:
IndexOutOfBoundsException- 如果索引无效
-
insert
将值插入此生成器.- Parameters:
index- 要添加的索引必须有效value- 要插入的值- Returns:
- this
- Throws:
IndexOutOfBoundsException- 如果索引无效
-
insert
将值插入此生成器.- Parameters:
index- 要添加的索引必须有效value- 要插入的值- Returns:
- this
- Throws:
IndexOutOfBoundsException- 如果索引无效
-
insert
将值插入此生成器.- Parameters:
index- 要添加的索引必须有效value- 要插入的值- Returns:
- this
- Throws:
IndexOutOfBoundsException- 如果索引无效
-
insert
将值插入此生成器.- Parameters:
index- 要添加的索引必须有效value- 要插入的值- Returns:
- this
- Throws:
IndexOutOfBoundsException- 如果索引无效
-
delete
删除两个指定索引之间的字符- Parameters:
startIndex- 起始索引(包括起始索引)必须有效endIndex- 唯一的结束索引必须有效,除非太大,否则将被视为字符串的结束- Returns:
- this
- Throws:
IndexOutOfBoundsException- 如果索引无效
-
deleteAll
-
deleteFirst
-
deleteAll
删除生成器中出现的字符串- Parameters:
text- 若要删除的字符串为空,则不执行任何操作- Returns:
- this
-
deleteFirst
删除生成器中出现的字符串- Parameters:
text- 若要删除的字符串为空,则不执行任何操作- Returns:
- this
-
deleteAll
删除匹配程序匹配的生成器的所有部分. 匹配器可用于执行高级删除行为。例如, 您可以编写一个匹配器来删除字符“a”后面跟一个数字的所有匹配项- Parameters:
matcher- 要使用的matcher来查找删除,null不导致任何操作- Returns:
- this
-
deleteFirst
使用指定的匹配器删除生成器中的第一个匹配项.匹配器可用于执行高级删除行为。例如,您可以编写一个匹配器来删除字符“a”后面跟着一个数字的地方.
- Parameters:
matcher- 要使用的matcher来查找删除,null不导致任何操作- Returns:
- this
-
replace
将字符串生成器的一部分替换为另一个字符串 插入字符串的长度不必与删除的长度匹配- Parameters:
startIndex- 开始索引,必须是有效的endIndex- 唯一的结束索引必须有效,除非太大,否则将被视为字符串的结束replaceStr- 要替换的字符串null表示删除范围- Returns:
- this
- Throws:
IndexOutOfBoundsException- 如果索引无效
-
replaceAll
在整个生成器中使用替换字符替换搜索字符- Parameters:
search- 搜索字符replace- 替换字符- Returns:
- this
-
replaceFirst
用生成器中的替换字符替换搜索字符的第一个实例.- Parameters:
search- 搜索字符replace- 替换字符- Returns:
- this
-
replaceAll
在整个生成器中使用替换字符串替换搜索字符串- Parameters:
searchStr- 如果搜索字符串为空,则不执行任何操作replaceStr- 替换字符串null相当于空字符串- Returns:
- this
-
replaceFirst
用替换字符串替换搜索字符串的第一个实例- Parameters:
searchStr- 如果搜索字符串为空,则不执行任何操作replaceStr- 替换字符串null相当于空字符串- Returns:
- this
-
replaceAll
用替换字符串替换生成器中的所有匹配项- Parameters:
matcher- 要使用的matcher来查找删除,null不导致任何操作replaceStr- 替换字符串null相当于空字符串- Returns:
- this
-
replaceFirst
用替换字符串替换生成器中的所有匹配项- Parameters:
matcher- 要使用的matcher来查找删除,null不导致任何操作replaceStr- 替换字符串null相当于空字符串- Returns:
- this
-
replace
public TextBuilder replace(Matchers matcher, String replaceStr, int startIndex, int endIndex, int replaceCount) 高级搜索并在构建器中使用匹配器进行替换- Parameters:
matcher- 要使用的matcher来查找删除,null不导致任何操作replaceStr- 将匹配项替换为null的字符串是deletestartIndex- 起始索引(包括起始索引)必须有效endIndex- 唯一的结束索引必须有效,除非太大,否则将被视为字符串的结束replaceCount- 要替换的次数,-1表示替换所有- Returns:
- this
- Throws:
IndexOutOfBoundsException- 如果开始索引无效
-
reverse
-
trim
-
startsWith
检查此生成器是否以指定的字符串开始- Parameters:
text- 要搜索的字符串null返回false- Returns:
- 如果生成器从字符串开始,则为真
-
endsWith
检查此生成器是否以指定的字符串结束- Parameters:
text- 要搜索的字符串null返回false- Returns:
- 如果生成器以字符串结束,则为真
-
subSequence
- Specified by:
subSequencein interfaceCharSequence
-
subString
-
subString
返回自定段的字符串- Parameters:
start- 开始位置(包括)end- 结束位置(不包括)- Returns:
- this
-
leftString
从字符串生成器中提取最左边的字符而不引发异常.- Parameters:
length- 要提取的字符数,负返回空字符串- Returns:
- 新的字符串
-
rightString
从字符串生成器中提取最右边的字符而不引发异常.- Parameters:
length- 要提取的字符数,负返回空字符串- Returns:
- 新的字符串
-
midString
从字符串生成器中间提取一些字符而不引发异常- Parameters:
index- 下标从-开始,表示0length- 要提取的字符数,负返回空字符串- Returns:
- 新的字符串
-
contains
public boolean contains(char ch) 检查字符串生成器是否包含指定的字符- Parameters:
ch- 要找的字符- Returns:
- 如果生成器包含该字符,则为真
-
contains
检查字符串生成器是否包含指定的字符串- Parameters:
text- 要找的字符- Returns:
- 如果生成器包含该字符,则为真
-
contains
检查字符串生成器是否包含使用指定匹配器匹配的字符串- Parameters:
matcher- 要使用的匹配器,如果为null返回-1- Returns:
- 如果匹配器在生成器中找到匹配项,则为真
-
indexOf
public int indexOf(char ch) 搜索字符串生成器以查找指定char类型的第一个引用.- Parameters:
ch- 要找的字符- Returns:
- 字符的第一个索引,如果没有找到则为-1
-
indexOf
public int indexOf(char ch, int startIndex) 搜索字符串生成器以查找指定char类型的第一个引用.- Parameters:
ch- 要找的字符startIndex- 从索引开始,无效的索引四舍五入到边缘- Returns:
- 字符的第一个索引,如果没有找到则为-1
-
indexOf
搜索字符串生成器以查找指定字符串的第一个引用- Parameters:
text- 要查找的字符串,如果为null返回-1- Returns:
- 字符的第一个索引,如果没有找到则为-1
-
indexOf
从给定索引开始搜索,搜索字符串生成器以查找指定字符串的第一个引用- Parameters:
text- 要查找的字符串,如果为null返回-1startIndex- 从索引开始,无效的索引四舍五入到边缘- Returns:
- 字符的第一个索引,如果没有找到则为-1
-
indexOf
使用matcher搜索字符串生成器以查找第一个匹配项.- Parameters:
matcher- 要使用的匹配器,null返回-1- Returns:
- 第一个索引匹配,如果没有找到,则为-1
-
indexOf
使用matcher搜索字符串生成器,以查找从给定索引中搜索的第一个匹配项.- Parameters:
matcher- 要使用的匹配器,null返回-1startIndex- 从索引开始,无效的索引四舍五入到边缘- Returns:
- 第一个索引匹配,如果没有找到,则为-1
-
lastIndexOf
public int lastIndexOf(char ch) 搜索字符串生成器以查找对指定字符的最后一个引用.- Parameters:
ch- 要找的字符- Returns:
- 字符的最后一个索引,如果没有找到,则为-1
-
lastIndexOf
public int lastIndexOf(char ch, int startIndex) 搜索字符串生成器以查找对指定字符的最后一个引用.- Parameters:
ch- 要找的字符startIndex- 从索引开始,无效的索引四舍五入到边缘- Returns:
- 字符的最后一个索引,如果没有找到,则为-1
-
lastIndexOf
搜索字符串生成器以查找对指定字符串的最后引用- Parameters:
text- 要查找的字符串,null返回-1- Returns:
- 字符串的最后一个索引,如果没有找到,则为-1
-
lastIndexOf
从给定索引开始搜索,搜索字符串生成器以查找指定字符串的最后一个引用- Parameters:
text- 要查找的字符串,null返回-1startIndex- 从索引开始,无效的索引四舍五入到边缘- Returns:
- 字符串的最后一个索引,如果没有找到,则为-1
-
lastIndexOf
使用matcher搜索字符串生成器以查找最后一个匹配项- Parameters:
matcher- 要使用的匹配器,null返回-1- Returns:
- 最后一个索引匹配,如果没有找到,则为-1
-
lastIndexOf
使用matcher搜索字符串生成器,以查找从给定索引中搜索的最后一个匹配项- Parameters:
matcher- 要使用的匹配器,null返回-1startIndex- 从索引开始,无效的索引四舍五入到边缘- Returns:
- 最后一个索引匹配,如果没有找到,则为-1
-
equalsIgnoreCase
检查此生成器的内容与另一个生成器的内容是否包含相同的字符内容(忽略大小写)- Parameters:
other- 要检查的对象null返回false- Returns:
- 如果生成器以相同的顺序包含相同的字符,则为真
-
equals
检查此生成器的内容与另一个生成器的内容是否包含相同的字符内容.- Parameters:
other- 要检查的对象null返回false- Returns:
- 如果生成器以相同的顺序包含相同的字符,则为真
-
build
-
equals
-
hashCode
-
toString
- Specified by:
toStringin interfaceCharSequence- Overrides:
toStringin classObject
-
toString
生成字符串- Parameters:
isReset- 是否重置,重置后相当于空的构建器- Returns:
- 生成的字符串
-
toStringBuffer
获取字符串生成器的StringBuffer版本,在每次调用该方法时创建一个新实例- Returns:
- 构建器一个 StringBuffer
-
toStringBuilder
获取字符串生成器的StringBuilder版本,在每次调用该方法时创建一个新实例- Returns:
- 构建器一个 StringBuilder
-
validateRange
protected int validateRange(int startIndex, int endIndex) 验证定义生成器范围的参数- Parameters:
startIndex- 起始索引(包括起始索引)必须有效endIndex- 唯一的结束索引必须有效,除非太大,否则将被视为字符串的结束- Returns:
- 新的字符串
- Throws:
IndexOutOfBoundsException- 如果索引无效
-
validateIndex
protected void validateIndex(int index) 验证在生成器中定义单个索引的参数- Parameters:
index- 索引,必须是有效的- Throws:
IndexOutOfBoundsException- 如果索引无效
-