StrBuilder (bus-core 3.0.5 API)

java.lang.Object
- org.aoju.bus.core.text.StrBuilder

All Implemented Interfaces:

Serializable, Appendable, CharSequence, Builder<String>
```
public class StrBuilder
extends Object
implements CharSequence, Appendable, Serializable, Builder<String>
```
Builds a string from constituent parts providing a more flexible and powerful API than StringBuffer.
The main differences from StringBuffer/StringBuilder are:
- Not synchronized
- Not final
- Subclasses have direct access to character array
- Additional methods
  - appendWithSeparators - adds an array of values, with a separator
  - appendPadding - adds a length padding characters
  - appendFixedLength - adds a fixed width field to the builder
  - toCharArray/getChars - simpler ways to get a range of the character array
  - delete - delete char or string
  - replace - search and replace for a char or string
  - leftString/rightString/midString - substring without exceptions
  - contains - whether the builder contains a char or string
  - size/clear/isEmpty - collections style API methods
- Views
  - asTokenizer - uses the internal buffer as the source of a StrTokenizer
  - asReader - uses the internal buffer as the source of a Reader
  - asWriter - allows a Writer to write directly to the internal buffer
The aim has been to provide an API that mimics very closely what StringBuffer provides, but with additional methods. It should be noted that some edge cases, with invalid indices or null input, have been altered - see individual methods. The biggest of these changes is that by default, null will not output the text 'null'. This can be controlled by a property, setNullText(String).
Prior to 3.0, this class implemented Cloneable but did not implement the clone method so could not be used. From 3.0 onwards it no longer implements the interface.
Since:

2.2

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`protected char[]`	`buffer` 存放的字符数组
`protected int`	`size` 当前指针位置，或者叫做已经加入的字符数，此位置总在最后一个字符之后

Constructor Summary

Constructors
Constructor and Description
`StrBuilder()` 构造
`StrBuilder(CharSequence... strs)` 创建字符串构建器
`StrBuilder(int initialCapacity)` 构造
`StrBuilder(String str)` 构造

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`StrBuilder`	`append(boolean value)` Appends a boolean value to the string builder.
`StrBuilder`	`append(char ch)` Appends a char value to the string builder.
`StrBuilder`	`append(char[] chars)` Appends a char array to the string builder.
`StrBuilder`	`append(char[] chars, int startIndex, int length)` Appends a char array to the string builder.
`StrBuilder`	`append(CharBuffer buf)` Appends the contents of a char buffer to this string builder.
`StrBuilder`	`append(CharBuffer buf, int startIndex, int length)` Appends the contents of a char buffer to this string builder.
`StrBuilder`	`append(CharSequence seq)` Appends a CharSequence to this string builder.
`StrBuilder`	`append(CharSequence seq, int startIndex, int length)` Appends part of a CharSequence to this string builder.
`StrBuilder`	`append(double value)` Appends a double value to the string builder using `String.valueOf`.
`StrBuilder`	`append(float value)` Appends a float value to the string builder using `String.valueOf`.
`StrBuilder`	`append(int value)` Appends an int value to the string builder using `String.valueOf`.
`StrBuilder`	`append(long value)` Appends a long value to the string builder using `String.valueOf`.
`StrBuilder`	`append(Object obj)` Appends an object to this string builder.
`StrBuilder`	`append(StrBuilder str)` Appends another string builder to this string builder.
`StrBuilder`	`append(StrBuilder str, int startIndex, int length)` Appends part of a string builder to this string builder.
`StrBuilder`	`append(String str)` Appends a string to this string builder.
`StrBuilder`	`append(StringBuffer str)` Appends a string buffer to this string builder.
`StrBuilder`	`append(StringBuffer str, int startIndex, int length)` Appends part of a string buffer to this string builder.
`StrBuilder`	`append(StringBuilder str)` Appends a StringBuilder to this string builder.
`StrBuilder`	`append(StringBuilder str, int startIndex, int length)` Appends part of a StringBuilder to this string builder.
`StrBuilder`	`append(String str, int startIndex, int length)` Appends part of a string to this string builder.
`StrBuilder`	`append(String format, Object... objs)` Calls `String.format(String, Object...)` and appends the result.
`StrBuilder`	`appendAll(Iterable<?> iterable)` Appends each item in a iterable to the builder without any separators.
`StrBuilder`	`appendAll(Iterator<?> it)` Appends each item in an iterator to the builder without any separators.
`<T> StrBuilder`	`appendAll(T... array)` Appends each item in an array to the builder without any separators.
`StrBuilder`	`appendFixedWidthPadLeft(int value, int width, char padChar)` Appends an object to the builder padding on the left to a fixed width.
`StrBuilder`	`appendFixedWidthPadLeft(Object obj, int width, char padChar)` Appends an object to the builder padding on the left to a fixed width.
`StrBuilder`	`appendFixedWidthPadRight(int value, int width, char padChar)` Appends an object to the builder padding on the right to a fixed length.
`StrBuilder`	`appendFixedWidthPadRight(Object obj, int width, char padChar)` Appends an object to the builder padding on the right to a fixed length.
`StrBuilder`	`appendln(boolean value)` Appends a boolean value followed by a new line to the string builder.
`StrBuilder`	`appendln(char ch)` Appends a char value followed by a new line to the string builder.
`StrBuilder`	`appendln(char[] chars)` Appends a char array followed by a new line to the string builder.
`StrBuilder`	`appendln(char[] chars, int startIndex, int length)` Appends a char array followed by a new line to the string builder.
`StrBuilder`	`appendln(double value)` Appends a double value followed by a new line to the string builder using `String.valueOf`.
`StrBuilder`	`appendln(float value)` Appends a float value followed by a new line to the string builder using `String.valueOf`.
`StrBuilder`	`appendln(int value)` Appends an int value followed by a new line to the string builder using `String.valueOf`.
`StrBuilder`	`appendln(long value)` Appends a long value followed by a new line to the string builder using `String.valueOf`.
`StrBuilder`	`appendln(Object obj)` Appends an object followed by a new line to this string builder.
`StrBuilder`	`appendln(StrBuilder str)` Appends another string builder followed by a new line to this string builder.
`StrBuilder`	`appendln(StrBuilder str, int startIndex, int length)` Appends part of a string builder followed by a new line to this string builder.
`StrBuilder`	`appendln(String str)` Appends a string followed by a new line to this string builder.
`StrBuilder`	`appendln(StringBuffer str)` Appends a string buffer followed by a new line to this string builder.
`StrBuilder`	`appendln(StringBuffer str, int startIndex, int length)` Appends part of a string buffer followed by a new line to this string builder.
`StrBuilder`	`appendln(StringBuilder str)` Appends a string builder followed by a new line to this string builder.
`StrBuilder`	`appendln(StringBuilder str, int startIndex, int length)` Appends part of a string builder followed by a new line to this string builder.
`StrBuilder`	`appendln(String str, int startIndex, int length)` Appends part of a string followed by a new line to this string builder.
`StrBuilder`	`appendln(String format, Object... objs)` Calls `String.format(String, Object...)` and appends the result.
`StrBuilder`	`appendNewLine()` Appends the new line string to this string builder.
`StrBuilder`	`appendNull()` Appends the text representing `null` to this string builder.
`StrBuilder`	`appendWithSeparators(Iterable<?> iterable, String separator)` Appends an iterable placing separators between each value, but not before the first or after the last.
`StrBuilder`	`appendWithSeparators(Iterator<?> it, String separator)` Appends an iterator placing separators between each value, but not before the first or after the last.
`StrBuilder`	`appendWithSeparators(Object[] array, String separator)` Appends an array placing separators between each value, but not before the first or after the last.
`String`	`build()` Implement the `Builder` interface.
`int`	`capacity()` Gets the current size of the internal character array buffer.
`char`	`charAt(int index)` Gets the character at the specified index.
`StrBuilder`	`clear()` Clears the string builder (convenience Collections API style method).
`boolean`	`contains(char ch)` Checks if the string builder contains the specified char.
`boolean`	`contains(String str)` Checks if the string builder contains the specified string.
`boolean`	`contains(StrMatcher matcher)` Checks if the string builder contains a string matched using the specified matcher.
`StrBuilder`	`delete(int startIndex, int endIndex)` Deletes the characters between the two specified indices.
`StrBuilder`	`deleteAll(char ch)` Deletes the character wherever it occurs in the builder.
`StrBuilder`	`deleteAll(String str)` Deletes the string wherever it occurs in the builder.
`StrBuilder`	`deleteAll(StrMatcher matcher)` Deletes all parts of the builder that the matcher matches.
`StrBuilder`	`deleteCharAt(int index)` Deletes the character at the specified index.
`StrBuilder`	`deleteFirst(char ch)` Deletes the character wherever it occurs in the builder.
`StrBuilder`	`deleteFirst(String str)` Deletes the string wherever it occurs in the builder.
`StrBuilder`	`deleteFirst(StrMatcher matcher)` Deletes the first match within the builder using the specified matcher.
`boolean`	`endsWith(String str)` Checks whether this builder ends with the specified string.
`StrBuilder`	`ensureCapacity(int capacity)` Checks the capacity and ensures that it is at least the size specified.
`boolean`	`equals(Object obj)` Checks the contents of this builder against another to see if they contain the same character content.
`boolean`	`equals(StrBuilder other)` Checks the contents of this builder against another to see if they contain the same character content.
`boolean`	`equalsIgnoreCase(StrBuilder other)` Checks the contents of this builder against another to see if they contain the same character content ignoring case.
`char[]`	`getChars(char[] destination)` Copies the character array into the specified array.
`void`	`getChars(int startIndex, int endIndex, char[] destination, int destinationIndex)` Copies the character array into the specified array.
`String`	`getNewLineText()` Gets the text to be appended when a new line is added.
`String`	`getNullText()` Gets the text to be appended when null is added.
`int`	`hashCode()` Gets a suitable hash code for this builder.
`int`	`indexOf(char ch)` Searches the string builder to find the first reference to the specified char.
`int`	`indexOf(char ch, int startIndex)` Searches the string builder to find the first reference to the specified char.
`int`	`indexOf(String str)` Searches the string builder to find the first reference to the specified string.
`int`	`indexOf(String str, int startIndex)` Searches the string builder to find the first reference to the specified string starting searching from the given index.
`int`	`indexOf(StrMatcher matcher)` Searches the string builder using the matcher to find the first match.
`int`	`indexOf(StrMatcher matcher, int startIndex)` Searches the string builder using the matcher to find the first match searching from the given index.
`StrBuilder`	`insert(int index, boolean value)` Inserts the value into this builder.
`StrBuilder`	`insert(int index, char value)` Inserts the value into this builder.
`StrBuilder`	`insert(int index, char[] chars)` Inserts the character array into this builder.
`StrBuilder`	`insert(int index, char[] chars, int offset, int length)` Inserts part of the character array into this builder.
`StrBuilder`	`insert(int index, double value)` Inserts the value into this builder.
`StrBuilder`	`insert(int index, float value)` Inserts the value into this builder.
`StrBuilder`	`insert(int index, int value)` Inserts the value into this builder.
`StrBuilder`	`insert(int index, long value)` Inserts the value into this builder.
`StrBuilder`	`insert(int index, Object obj)` Inserts the string representation of an object into this builder.
`StrBuilder`	`insert(int index, String str)` Inserts the string into this builder.
`boolean`	`isEmpty()` Checks is the string builder is empty (convenience Collections API style method).
`int`	`lastIndexOf(char ch)` Searches the string builder to find the last reference to the specified char.
`int`	`lastIndexOf(char ch, int startIndex)` Searches the string builder to find the last reference to the specified char.
`int`	`lastIndexOf(String str)` Searches the string builder to find the last reference to the specified string.
`int`	`lastIndexOf(String str, int startIndex)` Searches the string builder to find the last reference to the specified string starting searching from the given index.
`int`	`lastIndexOf(StrMatcher matcher)` Searches the string builder using the matcher to find the last match.
`int`	`lastIndexOf(StrMatcher matcher, int startIndex)` Searches the string builder using the matcher to find the last match searching from the given index.
`String`	`leftString(int length)` Extracts the leftmost characters from the string builder without throwing an exception.
`int`	`length()` Gets the length of the string builder.
`String`	`midString(int index, int length)` Extracts some characters from the middle of the string builder without throwing an exception.
`StrBuilder`	`minimizeCapacity()` Minimizes the capacity to the actual length of the string.
`int`	`readFrom(Readable readable)` If possible, reads chars from the provided `Readable` directly into underlying character buffer without making extra copies.
`StrBuilder`	`replace(int startIndex, int endIndex, String replaceStr)` Replaces a portion of the string builder with another string.
`StrBuilder`	`replace(StrMatcher matcher, String replaceStr, int startIndex, int endIndex, int replaceCount)` Advanced search and replaces within the builder using a matcher.
`StrBuilder`	`replaceAll(char search, char replace)` Replaces the search character with the replace character throughout the builder.
`StrBuilder`	`replaceAll(String searchStr, String replaceStr)` Replaces the search string with the replace string throughout the builder.
`StrBuilder`	`replaceAll(StrMatcher matcher, String replaceStr)` Replaces all matches within the builder with the replace string.
`StrBuilder`	`replaceFirst(char search, char replace)` Replaces the first instance of the search character with the replace character in the builder.
`StrBuilder`	`replaceFirst(String searchStr, String replaceStr)` Replaces the first instance of the search string with the replace string.
`StrBuilder`	`replaceFirst(StrMatcher matcher, String replaceStr)` Replaces the first match within the builder with the replace string.
`StrBuilder`	`reverse()` Reverses the string builder placing each character in the opposite index.
`String`	`rightString(int length)` Extracts the rightmost characters from the string builder without throwing an exception.
`StrBuilder`	`setCharAt(int index, char ch)` Sets the character at the specified index.
`StrBuilder`	`setLength(int length)` Updates the length of the builder by either dropping the last characters or adding filler of Unicode zero.
`StrBuilder`	`setNewLineText(String newLine)` Sets the text to be appended when a new line is added.
`StrBuilder`	`setNullText(String nullText)` Sets the text to be appended when null is added.
`int`	`size()` Gets the length of the string builder.
`boolean`	`startsWith(String str)` Checks whether this builder starts with the specified string.
`CharSequence`	`subSequence(int startIndex, int endIndex)`
`String`	`substring(int start)` Extracts a portion of this string builder as a string.
`String`	`substring(int startIndex, int endIndex)` Extracts a portion of this string builder as a string.
`String`	`toString()` Gets a String version of the string builder, creating a new instance each time the method is called.
`StringBuffer`	`toStringBuffer()` Gets a StringBuffer version of the string builder, creating a new instance each time the method is called.
`StringBuilder`	`toStringBuilder()` Gets a StringBuilder version of the string builder, creating a new instance each time the method is called.
`StrBuilder`	`trim()` Trims the builder by removing characters less than or equal to a space from the beginning and end.
`protected void`	`validateIndex(int index)` Validates parameters defining a single index in the builder.
`protected int`	`validateRange(int startIndex, int endIndex)` Validates parameters defining a range of the builder.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.CharSequence
chars, codePoints

- Field Detail
  - buffer
```
protected char[] buffer
```
    存放的字符数组
  - size
```
protected int size
```
    当前指针位置，或者叫做已经加入的字符数，此位置总在最后一个字符之后
- Constructor Detail
  - StrBuilder
```
public StrBuilder()
```
    构造
  - StrBuilder
```
public StrBuilder(int initialCapacity)
```
    构造
    
    Parameters:
    
    initialCapacity - 初始容量
  - StrBuilder
```
public StrBuilder(String str)
```
    构造
    
    Parameters:
    
    str - 初始字符串
  - StrBuilder
```
public StrBuilder(CharSequence... strs)
```
    创建字符串构建器
    
    Parameters:
    
    strs - 初始字符串
    
    Since:
    
    4.0.1
- Method Detail
  - getNewLineText
```
public String getNewLineText()
```
    Gets the text to be appended when a new line is added.
    
    Returns:
    
    the new line text, null means use system default
  - setNewLineText
```
public StrBuilder setNewLineText(String newLine)
```
    Sets the text to be appended when a new line is added.
    
    Parameters:
    
    newLine - the new line text, null means use system default
    
    Returns:
    
    this, to enable chaining
  - getNullText
```
public String getNullText()
```
    Gets the text to be appended when null is added.
    
    Returns:
    
    the null text, null means no append
  - setNullText
```
public StrBuilder setNullText(String nullText)
```
    Sets the text to be appended when null is added.
    
    Parameters:
    
    nullText - the null text, null means no append
    
    Returns:
    
    this, to enable chaining
  - length
```
public int length()
```
    Gets the length of the string builder.
    
    Specified by:
    
    length in interface CharSequence
    
    Returns:
    
    the length
  - setLength
```
public StrBuilder setLength(int length)
```
    Updates the length of the builder by either dropping the last characters or adding filler of Unicode zero.
    
    Parameters:
    
    length - the length to set to, must be zero or positive
    
    Returns:
    
    this, to enable chaining
    
    Throws:
    
    IndexOutOfBoundsException - if the length is negative
  - capacity
```
public int capacity()
```
    Gets the current size of the internal character array buffer.
    
    Returns:
    
    the capacity
  - ensureCapacity
```
public StrBuilder ensureCapacity(int capacity)
```
    Checks the capacity and ensures that it is at least the size specified.
    
    Parameters:
    
    capacity - the capacity to ensure
    
    Returns:
    
    this, to enable chaining
  - minimizeCapacity
```
public StrBuilder minimizeCapacity()
```
    Minimizes the capacity to the actual length of the string.
    
    Returns:
    
    this, to enable chaining
  - size
```
public int size()
```
    Gets the length of the string builder.
    This method is the same as length() and is provided to match the API of Collections.
    
    Returns:
    
    the length
  - isEmpty
```
public boolean isEmpty()
```
    Checks is the string builder is empty (convenience Collections API style method).
    This method is the same as checking length() and is provided to match the API of Collections.
    
    Returns:
    
    true if the size is 0.
  - clear
```
public StrBuilder clear()
```
    Clears the string builder (convenience Collections API style method).
    This method does not reduce the size of the internal character buffer. To do that, call clear() followed by minimizeCapacity().
    This method is the same as setLength(int) called with zero and is provided to match the API of Collections.
    
    Returns:
    
    this, to enable chaining
  - charAt
```
public char charAt(int index)
```
    Gets the character at the specified index.
    
    Specified by:
    
    charAt in interface CharSequence
    
    Parameters:
    
    index - the index to retrieve, must be valid
    
    Returns:
    
    the character at the index
    
    Throws:
    
    IndexOutOfBoundsException - if the index is invalid
    
    See Also:
    
    setCharAt(int, char), deleteCharAt(int)
  - setCharAt
```
public StrBuilder setCharAt(int index,
                            char ch)
```
    Sets the character at the specified index.
    
    Parameters:
    
    index - the index to set
    
    ch - the new character
    
    Returns:
    
    this, to enable chaining
    
    Throws:
    
    IndexOutOfBoundsException - if the index is invalid
    
    See Also:
    
    charAt(int), deleteCharAt(int)
  - deleteCharAt
```
public StrBuilder deleteCharAt(int index)
```
    Deletes the character at the specified index.
    
    Parameters:
    
    index - the index to delete
    
    Returns:
    
    this, to enable chaining
    
    Throws:
    
    IndexOutOfBoundsException - if the index is invalid
    
    See Also:
    
    charAt(int), setCharAt(int, char)
  - getChars
```
public char[] getChars(char[] destination)
```
    Copies the character array into the specified array.
    
    Parameters:
    
    destination - the destination array, null will cause an array to be created
    
    Returns:
    
    the input array, unless that was null or too small
  - getChars
```
public void getChars(int startIndex,
                     int endIndex,
                     char[] destination,
                     int destinationIndex)
```
    Copies the character array into the specified array.
    
    Parameters:
    
    startIndex - first index to copy, inclusive, must be valid
    
    endIndex - last index, exclusive, must be valid
    
    destination - the destination array, must not be null or too small
    
    destinationIndex - the index to start copying in destination
    
    Throws:
    
    NullPointerException - if the array is null
    
    IndexOutOfBoundsException - if any index is invalid
  - readFrom
```
public int readFrom(Readable readable)
             throws IOException
```
    If possible, reads chars from the provided Readable directly into underlying character buffer without making extra copies.
    
    Parameters:
    
    readable - object to read from
    
    Returns:
    
    the number of characters read
    
    Throws:
    
    IOException - if an I/O error occurs
    
    Since:
    
    3.4
  - appendNewLine
```
public StrBuilder appendNewLine()
```
    Appends the new line string to this string builder.
    The new line string can be altered using setNewLineText(String). This might be used to force the output to always use Unix line endings even when on Windows.
    
    Returns:
    
    this, to enable chaining
  - appendNull
```
public StrBuilder appendNull()
```
    Appends the text representing null to this string builder.
    
    Returns:
    
    this, to enable chaining
  - append
```
public StrBuilder append(Object obj)
```
    Appends an object to this string builder. Appending null will call appendNull().
    
    Parameters:
    
    obj - the object to append
    
    Returns:
    
    this, to enable chaining
  - append
```
public StrBuilder append(CharSequence seq)
```
    Appends a CharSequence to this string builder. Appending null will call appendNull().
    
    Specified by:
    
    append in interface Appendable
    
    Parameters:
    
    seq - the CharSequence to append
    
    Returns:
    
    this, to enable chaining
    
    Since:
    
    3.0
  - append
```
public StrBuilder append(CharSequence seq,
                         int startIndex,
                         int length)
```
    Appends part of a CharSequence to this string builder. Appending null will call appendNull().
    
    Specified by:
    
    append in interface Appendable
    
    Parameters:
    
    seq - the CharSequence to append
    
    startIndex - the start index, inclusive, must be valid
    
    length - the length to append, must be valid
    
    Returns:
    
    this, to enable chaining
    
    Since:
    
    3.0
  - append
```
public StrBuilder append(String str)
```
    Appends a string to this string builder. Appending null will call appendNull().
    
    Parameters:
    
    str - the string to append
    
    Returns:
    
    this, to enable chaining
  - append
```
public StrBuilder append(String str,
                         int startIndex,
                         int length)
```
    Appends part of a string to this string builder. Appending null will call appendNull().
    
    Parameters:
    
    str - the string to append
    
    startIndex - the start index, inclusive, must be valid
    
    length - the length to append, must be valid
    
    Returns:
    
    this, to enable chaining
  - append
```
public StrBuilder append(String format,
                         Object... objs)
```
    Calls String.format(String, Object...) and appends the result.
    
    Parameters:
    
    format - the format string
    
    objs - the objects to use in the format string
    
    Returns:
    
    this to enable chaining
    
    Since:
    
    3.2
    
    See Also:
    
    String.format(String, Object...)
  - append
```
public StrBuilder append(CharBuffer buf)
```
    Appends the contents of a char buffer to this string builder. Appending null will call appendNull().
    
    Parameters:
    
    buf - the char buffer to append
    
    Returns:
    
    this, to enable chaining
    
    Since:
    
    3.4
  - append
```
public StrBuilder append(CharBuffer buf,
                         int startIndex,
                         int length)
```
    Appends the contents of a char buffer to this string builder. Appending null will call appendNull().
    
    Parameters:
    
    buf - the char buffer to append
    
    startIndex - the start index, inclusive, must be valid
    
    length - the length to append, must be valid
    
    Returns:
    
    this, to enable chaining
    
    Since:
    
    3.4
  - append
```
public StrBuilder append(StringBuffer str)
```
    Appends a string buffer to this string builder. Appending null will call appendNull().
    
    Parameters:
    
    str - the string buffer to append
    
    Returns:
    
    this, to enable chaining
  - append
```
public StrBuilder append(StringBuffer str,
                         int startIndex,
                         int length)
```
    Appends part of a string buffer to this string builder. Appending null will call appendNull().
    
    Parameters:
    
    str - the string to append
    
    startIndex - the start index, inclusive, must be valid
    
    length - the length to append, must be valid
    
    Returns:
    
    this, to enable chaining
  - append
```
public StrBuilder append(StringBuilder str)
```
    Appends a StringBuilder to this string builder. Appending null will call appendNull().
    
    Parameters:
    
    str - the StringBuilder to append
    
    Returns:
    
    this, to enable chaining
    
    Since:
    
    3.2
  - append
```
public StrBuilder append(StringBuilder str,
                         int startIndex,
                         int length)
```
    Appends part of a StringBuilder to this string builder. Appending null will call appendNull().
    
    Parameters:
    
    str - the StringBuilder to append
    
    startIndex - the start index, inclusive, must be valid
    
    length - the length to append, must be valid
    
    Returns:
    
    this, to enable chaining
    
    Since:
    
    3.2
  - append
```
public StrBuilder append(StrBuilder str)
```
    Appends another string builder to this string builder. Appending null will call appendNull().
    
    Parameters:
    
    str - the string builder to append
    
    Returns:
    
    this, to enable chaining
  - append
```
public StrBuilder append(StrBuilder str,
                         int startIndex,
                         int length)
```
    Appends part of a string builder to this string builder. Appending null will call appendNull().
    
    Parameters:
    
    str - the string to append
    
    startIndex - the start index, inclusive, must be valid
    
    length - the length to append, must be valid
    
    Returns:
    
    this, to enable chaining
  - append
```
public StrBuilder append(char[] chars)
```
    Appends a char array to the string builder. Appending null will call appendNull().
    
    Parameters:
    
    chars - the char array to append
    
    Returns:
    
    this, to enable chaining
  - append
```
public StrBuilder append(char[] chars,
                         int startIndex,
                         int length)
```
    Appends a char array to the string builder. Appending null will call appendNull().
    
    Parameters:
    
    chars - the char array to append
    
    startIndex - the start index, inclusive, must be valid
    
    length - the length to append, must be valid
    
    Returns:
    
    this, to enable chaining
  - append
```
public StrBuilder append(boolean value)
```
    Appends a boolean value to the string builder.
    
    Parameters:
    
    value - the value to append
    
    Returns:
    
    this, to enable chaining
  - append
```
public StrBuilder append(char ch)
```
    Appends a char value to the string builder.
    
    Specified by:
    
    append in interface Appendable
    
    Parameters:
    
    ch - the value to append
    
    Returns:
    
    this, to enable chaining
    
    Since:
    
    3.0
  - append
```
public StrBuilder append(int value)
```
    Appends an int value to the string builder using String.valueOf.
    
    Parameters:
    
    value - the value to append
    
    Returns:
    
    this, to enable chaining
  - append
```
public StrBuilder append(long value)
```
    Appends a long value to the string builder using String.valueOf.
    
    Parameters:
    
    value - the value to append
    
    Returns:
    
    this, to enable chaining
  - append
```
public StrBuilder append(float value)
```
    Appends a float value to the string builder using String.valueOf.
    
    Parameters:
    
    value - the value to append
    
    Returns:
    
    this, to enable chaining
  - append
```
public StrBuilder append(double value)
```
    Appends a double value to the string builder using String.valueOf.
    
    Parameters:
    
    value - the value to append
    
    Returns:
    
    this, to enable chaining
  - appendln
```
public StrBuilder appendln(Object obj)
```
    Appends an object followed by a new line to this string builder. Appending null will call appendNull().
    
    Parameters:
    
    obj - the object to append
    
    Returns:
    
    this, to enable chaining
    
    Since:
    
    2.3
  - appendln
```
public StrBuilder appendln(String str)
```
    Appends a string followed by a new line to this string builder. Appending null will call appendNull().
    
    Parameters:
    
    str - the string to append
    
    Returns:
    
    this, to enable chaining
    
    Since:
    
    2.3
  - appendln
```
public StrBuilder appendln(String str,
                           int startIndex,
                           int length)
```
    Appends part of a string followed by a new line to this string builder. Appending null will call appendNull().
    
    Parameters:
    
    str - the string to append
    
    startIndex - the start index, inclusive, must be valid
    
    length - the length to append, must be valid
    
    Returns:
    
    this, to enable chaining
    
    Since:
    
    2.3
  - appendln
```
public StrBuilder appendln(String format,
                           Object... objs)
```
    Calls String.format(String, Object...) and appends the result.
    
    Parameters:
    
    format - the format string
    
    objs - the objects to use in the format string
    
    Returns:
    
    this to enable chaining
    
    Since:
    
    3.2
    
    See Also:
    
    String.format(String, Object...)
  - appendln
```
public StrBuilder appendln(StringBuffer str)
```
    Appends a string buffer followed by a new line to this string builder. Appending null will call appendNull().
    
    Parameters:
    
    str - the string buffer to append
    
    Returns:
    
    this, to enable chaining
    
    Since:
    
    2.3
  - appendln
```
public StrBuilder appendln(StringBuilder str)
```
    Appends a string builder followed by a new line to this string builder. Appending null will call appendNull().
    
    Parameters:
    
    str - the string builder to append
    
    Returns:
    
    this, to enable chaining
    
    Since:
    
    3.2
  - appendln
```
public StrBuilder appendln(StringBuilder str,
                           int startIndex,
                           int length)
```
    Appends part of a string builder followed by a new line to this string builder. Appending null will call appendNull().
    
    Parameters:
    
    str - the string builder to append
    
    startIndex - the start index, inclusive, must be valid
    
    length - the length to append, must be valid
    
    Returns:
    
    this, to enable chaining
    
    Since:
    
    3.2
  - appendln
```
public StrBuilder appendln(StringBuffer str,
                           int startIndex,
                           int length)
```
    Appends part of a string buffer followed by a new line to this string builder. Appending null will call appendNull().
    
    Parameters:
    
    str - the string to append
    
    startIndex - the start index, inclusive, must be valid
    
    length - the length to append, must be valid
    
    Returns:
    
    this, to enable chaining
    
    Since:
    
    2.3
  - appendln
```
public StrBuilder appendln(StrBuilder str)
```
    Appends another string builder followed by a new line to this string builder. Appending null will call appendNull().
    
    Parameters:
    
    str - the string builder to append
    
    Returns:
    
    this, to enable chaining
    
    Since:
    
    2.3
  - appendln
```
public StrBuilder appendln(StrBuilder str,
                           int startIndex,
                           int length)
```
    Appends part of a string builder followed by a new line to this string builder. Appending null will call appendNull().
    
    Parameters:
    
    str - the string to append
    
    startIndex - the start index, inclusive, must be valid
    
    length - the length to append, must be valid
    
    Returns:
    
    this, to enable chaining
    
    Since:
    
    2.3
  - appendln
```
public StrBuilder appendln(char[] chars)
```
    Appends a char array followed by a new line to the string builder. Appending null will call appendNull().
    
    Parameters:
    
    chars - the char array to append
    
    Returns:
    
    this, to enable chaining
    
    Since:
    
    2.3
  - appendln
```
public StrBuilder appendln(char[] chars,
                           int startIndex,
                           int length)
```
    Appends a char array followed by a new line to the string builder. Appending null will call appendNull().
    
    Parameters:
    
    chars - the char array to append
    
    startIndex - the start index, inclusive, must be valid
    
    length - the length to append, must be valid
    
    Returns:
    
    this, to enable chaining
    
    Since:
    
    2.3
  - appendln
```
public StrBuilder appendln(boolean value)
```
    Appends a boolean value followed by a new line to the string builder.
    
    Parameters:
    
    value - the value to append
    
    Returns:
    
    this, to enable chaining
    
    Since:
    
    2.3
  - appendln
```
public StrBuilder appendln(char ch)
```
    Appends a char value followed by a new line to the string builder.
    
    Parameters:
    
    ch - the value to append
    
    Returns:
    
    this, to enable chaining
    
    Since:
    
    2.3
  - appendln
```
public StrBuilder appendln(int value)
```
    Appends an int value followed by a new line to the string builder using String.valueOf.
    
    Parameters:
    
    value - the value to append
    
    Returns:
    
    this, to enable chaining
    
    Since:
    
    2.3
  - appendln
```
public StrBuilder appendln(long value)
```
    Appends a long value followed by a new line to the string builder using String.valueOf.
    
    Parameters:
    
    value - the value to append
    
    Returns:
    
    this, to enable chaining
    
    Since:
    
    2.3
  - appendln
```
public StrBuilder appendln(float value)
```
    Appends a float value followed by a new line to the string builder using String.valueOf.
    
    Parameters:
    
    value - the value to append
    
    Returns:
    
    this, to enable chaining
    
    Since:
    
    2.3
  - appendln
```
public StrBuilder appendln(double value)
```
    Appends a double value followed by a new line to the string builder using String.valueOf.
    
    Parameters:
    
    value - the value to append
    
    Returns:
    
    this, to enable chaining
    
    Since:
    
    2.3
  - appendAll
```
public <T> StrBuilder appendAll(T... array)
```
    Appends each item in an array to the builder without any separators. Appending a null array will have no effect. Each object is appended using append(Object).
    
    Type Parameters:
    
    T - the element type
    
    Parameters:
    
    array - the array to append
    
    Returns:
    
    this, to enable chaining
    
    Since:
    
    2.3
  - appendAll
```
public StrBuilder appendAll(Iterable<?> iterable)
```
    Appends each item in a iterable to the builder without any separators. Appending a null iterable will have no effect. Each object is appended using append(Object).
    
    Parameters:
    
    iterable - the iterable to append
    
    Returns:
    
    this, to enable chaining
    
    Since:
    
    2.3
  - appendAll
```
public StrBuilder appendAll(Iterator<?> it)
```
    Appends each item in an iterator to the builder without any separators. Appending a null iterator will have no effect. Each object is appended using append(Object).
    
    Parameters:
    
    it - the iterator to append
    
    Returns:
    
    this, to enable chaining
    
    Since:
    
    2.3
  - appendWithSeparators
```
public StrBuilder appendWithSeparators(Object[] array,
                                       String separator)
```
    Appends an array placing separators between each value, but not before the first or after the last. Appending a null array will have no effect. Each object is appended using append(Object).
    
    Parameters:
    
    array - the array to append
    
    separator - the separator to use, null means no separator
    
    Returns:
    
    this, to enable chaining
  - appendWithSeparators
```
public StrBuilder appendWithSeparators(Iterable<?> iterable,
                                       String separator)
```
    Appends an iterable placing separators between each value, but not before the first or after the last. Appending a null iterable will have no effect. Each object is appended using append(Object).
    
    Parameters:
    
    iterable - the iterable to append
    
    separator - the separator to use, null means no separator
    
    Returns:
    
    this, to enable chaining
  - appendWithSeparators
```
public StrBuilder appendWithSeparators(Iterator<?> it,
                                       String separator)
```
    Appends an iterator placing separators between each value, but not before the first or after the last. Appending a null iterator will have no effect. Each object is appended using append(Object).
    
    Parameters:
    
    it - the iterator to append
    
    separator - the separator to use, null means no separator
    
    Returns:
    
    this, to enable chaining
  - appendFixedWidthPadLeft
```
public StrBuilder appendFixedWidthPadLeft(Object obj,
                                          int width,
                                          char padChar)
```
    Appends an object to the builder padding on the left to a fixed width. The toString of the object is used. If the object is larger than the length, the left hand side is lost. If the object is null, the null text value is used.
    
    Parameters:
    
    obj - the object to append, null uses null text
    
    width - the fixed field width, zero or negative has no effect
    
    padChar - the pad character to use
    
    Returns:
    
    this, to enable chaining
  - appendFixedWidthPadLeft
```
public StrBuilder appendFixedWidthPadLeft(int value,
                                          int width,
                                          char padChar)
```
    Appends an object to the builder padding on the left to a fixed width. The String.valueOf of the int value is used. If the formatted value is larger than the length, the left hand side is lost.
    
    Parameters:
    
    value - the value to append
    
    width - the fixed field width, zero or negative has no effect
    
    padChar - the pad character to use
    
    Returns:
    
    this, to enable chaining
  - appendFixedWidthPadRight
```
public StrBuilder appendFixedWidthPadRight(Object obj,
                                           int width,
                                           char padChar)
```
    Appends an object to the builder padding on the right to a fixed length. The toString of the object is used. If the object is larger than the length, the right hand side is lost. If the object is null, null text value is used.
    
    Parameters:
    
    obj - the object to append, null uses null text
    
    width - the fixed field width, zero or negative has no effect
    
    padChar - the pad character to use
    
    Returns:
    
    this, to enable chaining
  - appendFixedWidthPadRight
```
public StrBuilder appendFixedWidthPadRight(int value,
                                           int width,
                                           char padChar)
```
    Appends an object to the builder padding on the right to a fixed length. The String.valueOf of the int value is used. If the object is larger than the length, the right hand side is lost.
    
    Parameters:
    
    value - the value to append
    
    width - the fixed field width, zero or negative has no effect
    
    padChar - the pad character to use
    
    Returns:
    
    this, to enable chaining
  - insert
```
public StrBuilder insert(int index,
                         Object obj)
```
    Inserts the string representation of an object into this builder. Inserting null will use the stored null text value.
    
    Parameters:
    
    index - the index to add at, must be valid
    
    obj - the object to insert
    
    Returns:
    
    this, to enable chaining
    
    Throws:
    
    IndexOutOfBoundsException - if the index is invalid
  - insert
```
public StrBuilder insert(int index,
                         String str)
```
    Inserts the string into this builder. Inserting null will use the stored null text value.
    
    Parameters:
    
    index - the index to add at, must be valid
    
    str - the string to insert
    
    Returns:
    
    this, to enable chaining
    
    Throws:
    
    IndexOutOfBoundsException - if the index is invalid
  - insert
```
public StrBuilder insert(int index,
                         char[] chars)
```
    Inserts the character array into this builder. Inserting null will use the stored null text value.
    
    Parameters:
    
    index - the index to add at, must be valid
    
    chars - the char array to insert
    
    Returns:
    
    this, to enable chaining
    
    Throws:
    
    IndexOutOfBoundsException - if the index is invalid
  - insert
```
public StrBuilder insert(int index,
                         char[] chars,
                         int offset,
                         int length)
```
    Inserts part of the character array into this builder. Inserting null will use the stored null text value.
    
    Parameters:
    
    index - the index to add at, must be valid
    
    chars - the char array to insert
    
    offset - the offset into the character array to start at, must be valid
    
    length - the length of the character array part to copy, must be positive
    
    Returns:
    
    this, to enable chaining
    
    Throws:
    
    IndexOutOfBoundsException - if any index is invalid
  - insert
```
public StrBuilder insert(int index,
                         boolean value)
```
    Inserts the value into this builder.
    
    Parameters:
    
    index - the index to add at, must be valid
    
    value - the value to insert
    
    Returns:
    
    this, to enable chaining
    
    Throws:
    
    IndexOutOfBoundsException - if the index is invalid
  - insert
```
public StrBuilder insert(int index,
                         char value)
```
    Inserts the value into this builder.
    
    Parameters:
    
    index - the index to add at, must be valid
    
    value - the value to insert
    
    Returns:
    
    this, to enable chaining
    
    Throws:
    
    IndexOutOfBoundsException - if the index is invalid
  - insert
```
public StrBuilder insert(int index,
                         int value)
```
    Inserts the value into this builder.
    
    Parameters:
    
    index - the index to add at, must be valid
    
    value - the value to insert
    
    Returns:
    
    this, to enable chaining
    
    Throws:
    
    IndexOutOfBoundsException - if the index is invalid
  - insert
```
public StrBuilder insert(int index,
                         long value)
```
    Inserts the value into this builder.
    
    Parameters:
    
    index - the index to add at, must be valid
    
    value - the value to insert
    
    Returns:
    
    this, to enable chaining
    
    Throws:
    
    IndexOutOfBoundsException - if the index is invalid
  - insert
```
public StrBuilder insert(int index,
                         float value)
```
    Inserts the value into this builder.
    
    Parameters:
    
    index - the index to add at, must be valid
    
    value - the value to insert
    
    Returns:
    
    this, to enable chaining
    
    Throws:
    
    IndexOutOfBoundsException - if the index is invalid
  - insert
```
public StrBuilder insert(int index,
                         double value)
```
    Inserts the value into this builder.
    
    Parameters:
    
    index - the index to add at, must be valid
    
    value - the value to insert
    
    Returns:
    
    this, to enable chaining
    
    Throws:
    
    IndexOutOfBoundsException - if the index is invalid
  - delete
```
public StrBuilder delete(int startIndex,
                         int endIndex)
```
    Deletes the characters between the two specified indices.
    
    Parameters:
    
    startIndex - the start index, inclusive, must be valid
    
    endIndex - the end index, exclusive, must be valid except that if too large it is treated as end of string
    
    Returns:
    
    this, to enable chaining
    
    Throws:
    
    IndexOutOfBoundsException - if the index is invalid
  - deleteAll
```
public StrBuilder deleteAll(char ch)
```
    Deletes the character wherever it occurs in the builder.
    
    Parameters:
    
    ch - the character to delete
    
    Returns:
    
    this, to enable chaining
  - deleteFirst
```
public StrBuilder deleteFirst(char ch)
```
    Deletes the character wherever it occurs in the builder.
    
    Parameters:
    
    ch - the character to delete
    
    Returns:
    
    this, to enable chaining
  - deleteAll
```
public StrBuilder deleteAll(String str)
```
    Deletes the string wherever it occurs in the builder.
    
    Parameters:
    
    str - the string to delete, null causes no action
    
    Returns:
    
    this, to enable chaining
  - deleteFirst
```
public StrBuilder deleteFirst(String str)
```
    Deletes the string wherever it occurs in the builder.
    
    Parameters:
    
    str - the string to delete, null causes no action
    
    Returns:
    
    this, to enable chaining
  - deleteAll
```
public StrBuilder deleteAll(StrMatcher matcher)
```
    Deletes all parts of the builder that the matcher matches.
    Matchers can be used to perform advanced deletion behaviour. For example you could write a matcher to delete all occurrences where the character 'a' is followed by a number.
    
    Parameters:
    
    matcher - the matcher to use to find the deletion, null causes no action
    
    Returns:
    
    this, to enable chaining
  - deleteFirst
```
public StrBuilder deleteFirst(StrMatcher matcher)
```
    Deletes the first match within the builder using the specified matcher.
    Matchers can be used to perform advanced deletion behaviour. For example you could write a matcher to delete where the character 'a' is followed by a number.
    
    Parameters:
    
    matcher - the matcher to use to find the deletion, null causes no action
    
    Returns:
    
    this, to enable chaining
  - replace
```
public StrBuilder replace(int startIndex,
                          int endIndex,
                          String replaceStr)
```
    Replaces a portion of the string builder with another string. The length of the inserted string does not have to match the removed length.
    
    Parameters:
    
    startIndex - the start index, inclusive, must be valid
    
    endIndex - the end index, exclusive, must be valid except that if too large it is treated as end of string
    
    replaceStr - the string to replace with, null means delete range
    
    Returns:
    
    this, to enable chaining
    
    Throws:
    
    IndexOutOfBoundsException - if the index is invalid
  - replaceAll
```
public StrBuilder replaceAll(char search,
                             char replace)
```
    Replaces the search character with the replace character throughout the builder.
    
    Parameters:
    
    search - the search character
    
    replace - the replace character
    
    Returns:
    
    this, to enable chaining
  - replaceFirst
```
public StrBuilder replaceFirst(char search,
                               char replace)
```
    Replaces the first instance of the search character with the replace character in the builder.
    
    Parameters:
    
    search - the search character
    
    replace - the replace character
    
    Returns:
    
    this, to enable chaining
  - replaceAll
```
public StrBuilder replaceAll(String searchStr,
                             String replaceStr)
```
    Replaces the search string with the replace string throughout the builder.
    
    Parameters:
    
    searchStr - the search string, null causes no action to occur
    
    replaceStr - the replace string, null is equivalent to an empty string
    
    Returns:
    
    this, to enable chaining
  - replaceFirst
```
public StrBuilder replaceFirst(String searchStr,
                               String replaceStr)
```
    Replaces the first instance of the search string with the replace string.
    
    Parameters:
    
    searchStr - the search string, null causes no action to occur
    
    replaceStr - the replace string, null is equivalent to an empty string
    
    Returns:
    
    this, to enable chaining
  - replaceAll
```
public StrBuilder replaceAll(StrMatcher matcher,
                             String replaceStr)
```
    Replaces all matches within the builder with the replace string.
    Matchers can be used to perform advanced replace behaviour. For example you could write a matcher to replace all occurrences where the character 'a' is followed by a number.
    
    Parameters:
    
    matcher - the matcher to use to find the deletion, null causes no action
    
    replaceStr - the replace string, null is equivalent to an empty string
    
    Returns:
    
    this, to enable chaining
  - replaceFirst
```
public StrBuilder replaceFirst(StrMatcher matcher,
                               String replaceStr)
```
    Replaces the first match within the builder with the replace string.
    Matchers can be used to perform advanced replace behaviour. For example you could write a matcher to replace where the character 'a' is followed by a number.
    
    Parameters:
    
    matcher - the matcher to use to find the deletion, null causes no action
    
    replaceStr - the replace string, null is equivalent to an empty string
    
    Returns:
    
    this, to enable chaining
  - replace
```
public StrBuilder replace(StrMatcher matcher,
                          String replaceStr,
                          int startIndex,
                          int endIndex,
                          int replaceCount)
```
    Advanced search and replaces within the builder using a matcher.
    Matchers can be used to perform advanced behaviour. For example you could write a matcher to delete all occurrences where the character 'a' is followed by a number.
    
    Parameters:
    
    matcher - the matcher to use to find the deletion, null causes no action
    
    replaceStr - the string to replace the match with, null is a delete
    
    startIndex - the start index, inclusive, must be valid
    
    endIndex - the end index, exclusive, must be valid except that if too large it is treated as end of string
    
    replaceCount - the number of times to replace, -1 for replace all
    
    Returns:
    
    this, to enable chaining
    
    Throws:
    
    IndexOutOfBoundsException - if start index is invalid
  - reverse
```
public StrBuilder reverse()
```
    Reverses the string builder placing each character in the opposite index.
    
    Returns:
    
    this, to enable chaining
  - trim
```
public StrBuilder trim()
```
    Trims the builder by removing characters less than or equal to a space from the beginning and end.
    
    Returns:
    
    this, to enable chaining
  - startsWith
```
public boolean startsWith(String str)
```
    Checks whether this builder starts with the specified string.
    Note that this method handles null input quietly, unlike String.
    
    Parameters:
    
    str - the string to search for, null returns false
    
    Returns:
    
    true if the builder starts with the string
  - endsWith
```
public boolean endsWith(String str)
```
    Checks whether this builder ends with the specified string.
    Note that this method handles null input quietly, unlike String.
    
    Parameters:
    
    str - the string to search for, null returns false
    
    Returns:
    
    true if the builder ends with the string
  - subSequence
```
public CharSequence subSequence(int startIndex,
                                int endIndex)
```
    Specified by:
    
    subSequence in interface CharSequence
    
    Since:
    
    3.0
  - substring
```
public String substring(int start)
```
    Extracts a portion of this string builder as a string.
    
    Parameters:
    
    start - the start index, inclusive, must be valid
    
    Returns:
    
    the new string
    
    Throws:
    
    IndexOutOfBoundsException - if the index is invalid
  - substring
```
public String substring(int startIndex,
                        int endIndex)
```
    Extracts a portion of this string builder as a string.
    Note: This method treats an endIndex greater than the length of the builder as equal to the length of the builder, and continues without error, unlike StringBuffer or String.
    
    Parameters:
    
    startIndex - the start index, inclusive, must be valid
    
    endIndex - the end index, exclusive, must be valid except that if too large it is treated as end of string
    
    Returns:
    
    the new string
    
    Throws:
    
    IndexOutOfBoundsException - if the index is invalid
  - leftString
```
public String leftString(int length)
```
    Extracts the leftmost characters from the string builder without throwing an exception.
    This method extracts the left length characters from the builder. If this many characters are not available, the whole builder is returned. Thus the returned string may be shorter than the length requested.
    
    Parameters:
    
    length - the number of characters to extract, negative returns empty string
    
    Returns:
    
    the new string
  - rightString
```
public String rightString(int length)
```
    Extracts the rightmost characters from the string builder without throwing an exception.
    This method extracts the right length characters from the builder. If this many characters are not available, the whole builder is returned. Thus the returned string may be shorter than the length requested.
    
    Parameters:
    
    length - the number of characters to extract, negative returns empty string
    
    Returns:
    
    the new string
  - midString
```
public String midString(int index,
                        int length)
```
    Extracts some characters from the middle of the string builder without throwing an exception.
    This method extracts length characters from the builder at the specified index. If the index is negative it is treated as zero. If the index is greater than the builder size, it is treated as the builder size. If the length is negative, the empty string is returned. If insufficient characters are available in the builder, as much as possible is returned. Thus the returned string may be shorter than the length requested.
    
    Parameters:
    
    index - the index to start at, negative means zero
    
    length - the number of characters to extract, negative returns empty string
    
    Returns:
    
    the new string
  - contains
```
public boolean contains(char ch)
```
    Checks if the string builder contains the specified char.
    
    Parameters:
    
    ch - the character to find
    
    Returns:
    
    true if the builder contains the character
  - contains
```
public boolean contains(String str)
```
    Checks if the string builder contains the specified string.
    
    Parameters:
    
    str - the string to find
    
    Returns:
    
    true if the builder contains the string
  - contains
```
public boolean contains(StrMatcher matcher)
```
    Checks if the string builder contains a string matched using the specified matcher.
    Matchers can be used to perform advanced searching behaviour. For example you could write a matcher to search for the character 'a' followed by a number.
    
    Parameters:
    
    matcher - the matcher to use, null returns -1
    
    Returns:
    
    true if the matcher finds a match in the builder
  - indexOf
```
public int indexOf(char ch)
```
    Searches the string builder to find the first reference to the specified char.
    
    Parameters:
    
    ch - the character to find
    
    Returns:
    
    the first index of the character, or -1 if not found
  - indexOf
```
public int indexOf(char ch,
                   int startIndex)
```
    Searches the string builder to find the first reference to the specified char.
    
    Parameters:
    
    ch - the character to find
    
    startIndex - the index to start at, invalid index rounded to edge
    
    Returns:
    
    the first index of the character, or -1 if not found
  - indexOf
```
public int indexOf(String str)
```
    Searches the string builder to find the first reference to the specified string.
    Note that a null input string will return -1, whereas the JDK throws an exception.
    
    Parameters:
    
    str - the string to find, null returns -1
    
    Returns:
    
    the first index of the string, or -1 if not found
  - indexOf
```
public int indexOf(String str,
                   int startIndex)
```
    Searches the string builder to find the first reference to the specified string starting searching from the given index.
    Note that a null input string will return -1, whereas the JDK throws an exception.
    
    Parameters:
    
    str - the string to find, null returns -1
    
    startIndex - the index to start at, invalid index rounded to edge
    
    Returns:
    
    the first index of the string, or -1 if not found
  - indexOf
```
public int indexOf(StrMatcher matcher)
```
    Searches the string builder using the matcher to find the first match.
    Matchers can be used to perform advanced searching behaviour. For example you could write a matcher to find the character 'a' followed by a number.
    
    Parameters:
    
    matcher - the matcher to use, null returns -1
    
    Returns:
    
    the first index matched, or -1 if not found
  - indexOf
```
public int indexOf(StrMatcher matcher,
                   int startIndex)
```
    Searches the string builder using the matcher to find the first match searching from the given index.
    Matchers can be used to perform advanced searching behaviour. For example you could write a matcher to find the character 'a' followed by a number.
    
    Parameters:
    
    matcher - the matcher to use, null returns -1
    
    startIndex - the index to start at, invalid index rounded to edge
    
    Returns:
    
    the first index matched, or -1 if not found
  - lastIndexOf
```
public int lastIndexOf(char ch)
```
    Searches the string builder to find the last reference to the specified char.
    
    Parameters:
    
    ch - the character to find
    
    Returns:
    
    the last index of the character, or -1 if not found
  - lastIndexOf
```
public int lastIndexOf(char ch,
                       int startIndex)
```
    Searches the string builder to find the last reference to the specified char.
    
    Parameters:
    
    ch - the character to find
    
    startIndex - the index to start at, invalid index rounded to edge
    
    Returns:
    
    the last index of the character, or -1 if not found
  - lastIndexOf
```
public int lastIndexOf(String str)
```
    Searches the string builder to find the last reference to the specified string.
    Note that a null input string will return -1, whereas the JDK throws an exception.
    
    Parameters:
    
    str - the string to find, null returns -1
    
    Returns:
    
    the last index of the string, or -1 if not found
  - lastIndexOf
```
public int lastIndexOf(String str,
                       int startIndex)
```
    Searches the string builder to find the last reference to the specified string starting searching from the given index.
    Note that a null input string will return -1, whereas the JDK throws an exception.
    
    Parameters:
    
    str - the string to find, null returns -1
    
    startIndex - the index to start at, invalid index rounded to edge
    
    Returns:
    
    the last index of the string, or -1 if not found
  - lastIndexOf
```
public int lastIndexOf(StrMatcher matcher)
```
    Searches the string builder using the matcher to find the last match.
    Matchers can be used to perform advanced searching behaviour. For example you could write a matcher to find the character 'a' followed by a number.
    
    Parameters:
    
    matcher - the matcher to use, null returns -1
    
    Returns:
    
    the last index matched, or -1 if not found
  - lastIndexOf
```
public int lastIndexOf(StrMatcher matcher,
                       int startIndex)
```
    Searches the string builder using the matcher to find the last match searching from the given index.
    Matchers can be used to perform advanced searching behaviour. For example you could write a matcher to find the character 'a' followed by a number.
    
    Parameters:
    
    matcher - the matcher to use, null returns -1
    
    startIndex - the index to start at, invalid index rounded to edge
    
    Returns:
    
    the last index matched, or -1 if not found
  - equalsIgnoreCase
```
public boolean equalsIgnoreCase(StrBuilder other)
```
    Checks the contents of this builder against another to see if they contain the same character content ignoring case.
    
    Parameters:
    
    other - the object to check, null returns false
    
    Returns:
    
    true if the builders contain the same characters in the same order
  - equals
```
public boolean equals(StrBuilder other)
```
    Checks the contents of this builder against another to see if they contain the same character content.
    
    Parameters:
    
    other - the object to check, null returns false
    
    Returns:
    
    true if the builders contain the same characters in the same order
  - equals
```
public boolean equals(Object obj)
```
    Checks the contents of this builder against another to see if they contain the same character content.
    
    Overrides:
    
    equals in class Object
    
    Parameters:
    
    obj - the object to check, null returns false
    
    Returns:
    
    true if the builders contain the same characters in the same order
  - hashCode
```
public int hashCode()
```
    Gets a suitable hash code for this builder.
    
    Overrides:
    
    hashCode in class Object
    
    Returns:
    
    a hash code
  - toString
```
public String toString()
```
    Gets a String version of the string builder, creating a new instance each time the method is called.
    Note that unlike StringBuffer, the string version returned is independent of the string builder.
    
    Specified by:
    
    toString in interface CharSequence
    
    Overrides:
    
    toString in class Object
    
    Returns:
    
    the builder as a String
  - toStringBuffer
```
public StringBuffer toStringBuffer()
```
    Gets a StringBuffer version of the string builder, creating a new instance each time the method is called.
    
    Returns:
    
    the builder as a StringBuffer
  - toStringBuilder
```
public StringBuilder toStringBuilder()
```
    Gets a StringBuilder version of the string builder, creating a new instance each time the method is called.
    
    Returns:
    
    the builder as a StringBuilder
    
    Since:
    
    3.2
  - build
```
public String build()
```
    Implement the Builder interface.
    
    Specified by:
    
    build in interface Builder<String>
    
    Returns:
    
    the builder as a String
    
    Since:
    
    3.2
    
    See Also:
    
    toString()
  - validateRange
```
protected int validateRange(int startIndex,
                            int endIndex)
```
    Validates parameters defining a range of the builder.
    
    Parameters:
    
    startIndex - the start index, inclusive, must be valid
    
    endIndex - the end index, exclusive, must be valid except that if too large it is treated as end of string
    
    Returns:
    
    the new string
    
    Throws:
    
    IndexOutOfBoundsException - if the index is invalid
  - validateIndex
```
protected void validateIndex(int index)
```
    Validates parameters defining a single index in the builder.
    
    Parameters:
    
    index - the index, must be valid
    
    Throws:
    
    IndexOutOfBoundsException - if the index is invalid

Class StrBuilder

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface java.lang.CharSequence

Field Detail

buffer

size

Constructor Detail

StrBuilder

StrBuilder

StrBuilder

StrBuilder

Method Detail

getNewLineText

setNewLineText

getNullText

setNullText

length

setLength

capacity

ensureCapacity

minimizeCapacity

size

isEmpty

clear

charAt

setCharAt

deleteCharAt

getChars

getChars

readFrom

appendNewLine

appendNull

append

append

append

append

append

append

append

append

append

append

append

append

append

append

append

append

append

append

append

append

append

append

appendln

appendln

appendln

appendln

appendln

appendln

appendln

appendln

appendln

appendln

appendln

appendln

appendln

appendln

appendln

appendln

appendln

appendln

appendAll

appendAll

appendAll

appendWithSeparators

appendWithSeparators