StringBuilder

Inheritance: java.lang.Object

public final class StringBuilder

Represents a mutable string of characters. Cannot be extended.

Constructors

ConstructorDescription
StringBuilder()Initializes a new instance of the StringBuilder class.
StringBuilder(int capacity)Initializes a new instance of the StringBuilder class using the specified capacity.
StringBuilder(int capacity, int maxCapacity)Initializes a new instance of the StringBuilder class that starts with a specified capacity and can grow to a specified maximum.
StringBuilder(String value)Initializes a new instance of the StringBuilder class using the specified string.
StringBuilder(String value, int capacity)Initializes a new instance of the StringBuilder class using the specified string and capacity.
StringBuilder(String value, int startIndex, int length, int capacity)Initializes a new instance of the StringBuilder class from the specified substring and capacity.

Methods

MethodDescription
append(boolean value)Appends the string representation of a specified boolean value to this instance.
append(byte value)Appends the string representation of a specified byte to this instance.
append(char value)Appends the string representation of a specified Unicode character to this instance.
append(char value, int repeatCount)Appends a specified number of copies of the string representation of a Unicode character to this instance.
append(char[] value)Appends the string representation of the Unicode characters in a specified array to this instance.
append(char[] value, int startIndex, int charCount)Appends the string representation of a specified subarray of Unicode characters to this instance.
append(double value)Appends the string representation of a specified double number to this instance.
append(float value)Appends the string representation of a specified float number to this instance.
append(int value)Appends the string representation of a specified int number to this instance.
append(Object value)Appends the string representation of a specified object to this instance.
append(String value)Appends a copy of the specified string to this instance.
append(String value, int startIndex, int count)Appends a copy of a specified substring to this instance.
append(BigDecimal value)Appends the string representation of a specified BigDecimal number to this instance.
append(long value)Appends the string representation of a specified long number to this instance.
append(short value)Appends the string representation of a specified short number to this instance.
appendFormat(String format, Object[] args)Appends the string returned by processing a composite format string, which contains zero or more format items, to this instance.
appendLine()Appends the default line terminator to the end of the current StringBuilder object.
appendLine(String value)Appends a copy of the specified string followed by the default line terminator to the end of the current StringBuilder object.
copyTo(int sourceIndex, char[] destination, int destinationIndex, int count)Copies the characters from a specified segment of this instance to a specified segment of a destination Char array.
ensureCapacity(int capacity)Ensures that the capacity of this instance of StringBuilder is at least the specified value.
equals(Object obj)Returns a value indicating whether this instance is equal to a specified object.
getCapacity()Gets the maximum number of characters that can be contained in the memory allocated by the current instance.
getLength()Gets the length of the current StringBuilder object.
getMaxCapacity()Gets the maximum capacity of this instance.
hashCode()Returns a hash code for this StringBuilder.
insert(int index, boolean value)Inserts the string representation of a boolean value into this instance at the specified character position.
insert(int index, byte value)Inserts the string representation of a byte value into this instance at the specified character position.
insert(int index, char value)Inserts the string representation of a specified Unicode character into this instance at the specified character position.
insert(int index, char[] value)Inserts the string representation of a specified array of Unicode characters into this instance at the specified character position.
insert(int index, char[] value, int startIndex, int charCount)Inserts the string representation of a specified subarray of Unicode characters into this instance at the specified character position.
insert(int index, double value)Inserts the string representation of a double number into this instance at the specified character position.
insert(int index, float value)Inserts the string representation of a float number into this instance at the specified character position.
insert(int index, int value)Inserts the string representation of an int number into this instance at the specified character position.
insert(int index, Object value)Inserts the string representation of an object into this instance at the specified character position.
insert(int index, String value)Inserts a string into this instance at the specified character position.
insert(int index, String value, int count)Inserts one or more copies of a specified string into this instance at the specified character position.
insert(int index, BigDecimal value)Inserts the string representation of a decimal number into this instance at the specified character position.
insert(int index, long value)Inserts the string representation of a long number into this instance at the specified character position.
insert(int index, short value)Inserts the string representation of a short number into this instance at the specified character position.
remove(int startIndex, int length)Removes the specified range of characters from this instance.
replace(char oldChar, char newChar)Replaces all occurrences of a specified character in this instance with another specified character.
replace(char oldValue, char newValue, int startIndex, int count)Replaces, within a substring of this instance, all occurrences of a specified character with another specified character.
replace(String oldValue, String newValue)Replaces all occurrences of a specified string in this instance with another specified string.
replace(String oldValue, String newValue, int startIndex, int count)Replaces, within a substring of this instance, all occurrences of a specified string with another specified string.
setCapacity(int value)Sets the maximum number of characters that can be contained in the memory allocated by the current instance.
setLength(int value)Sets the length of the current StringBuilder object.
toString()Converts the value of this instance to a String.
toString(int startIndex, int length)Converts the value of a substring of this instance to a String.

StringBuilder()

public StringBuilder()

Initializes a new instance of the StringBuilder class.

StringBuilder(int capacity)

public StringBuilder(int capacity)

Initializes a new instance of the StringBuilder class using the specified capacity.

Parameters:

ParameterTypeDescription
capacityintThe suggested starting size of this instance.

StringBuilder(int capacity, int maxCapacity)

public StringBuilder(int capacity, int maxCapacity)

Initializes a new instance of the StringBuilder class that starts with a specified capacity and can grow to a specified maximum.

Parameters:

ParameterTypeDescription
capacityintThe suggested starting size of the StringBuilder.
maxCapacityintThe maximum number of characters the current string can contain.

StringBuilder(String value)

public StringBuilder(String value)

Initializes a new instance of the StringBuilder class using the specified string.

Parameters:

ParameterTypeDescription
valuejava.lang.StringThe string used to initialize the value of the instance.

StringBuilder(String value, int capacity)

public StringBuilder(String value, int capacity)

Initializes a new instance of the StringBuilder class using the specified string and capacity.

Parameters:

ParameterTypeDescription
valuejava.lang.StringThe string used to initialize the value of the instance.
capacityintThe suggested starting size of the StringBuilder.

StringBuilder(String value, int startIndex, int length, int capacity)

public StringBuilder(String value, int startIndex, int length, int capacity)

Initializes a new instance of the StringBuilder class from the specified substring and capacity.

Parameters:

ParameterTypeDescription
valuejava.lang.StringThe string that contains the substring used to initialize the value of this instance.
startIndexintThe position within value where the substring begins.
lengthintThe number of characters in the substring.
capacityintThe suggested starting size of the StringBuilder.

append(boolean value)

public StringBuilder append(boolean value)

Appends the string representation of a specified boolean value to this instance.

Parameters:

ParameterTypeDescription
valuebooleanThe boolean value to append.

Returns: StringBuilder - A reference to this instance after the append operation has completed.

append(byte value)

public StringBuilder append(byte value)

Appends the string representation of a specified byte to this instance.

Parameters:

ParameterTypeDescription
valuebyteThe value to append.

Returns: StringBuilder - A reference to this instance after the append operation has completed.

append(char value)

public StringBuilder append(char value)

Appends the string representation of a specified Unicode character to this instance.

Parameters:

ParameterTypeDescription
valuecharThe Unicode character to append.

Returns: StringBuilder - A reference to this instance after the append operation has completed.

append(char value, int repeatCount)

public StringBuilder append(char value, int repeatCount)

Appends a specified number of copies of the string representation of a Unicode character to this instance.

Parameters:

ParameterTypeDescription
valuecharThe character to append.
repeatCountintThe number of times to append value.

Returns: StringBuilder - A reference to this instance after the append operation has completed.

append(char[] value)

public StringBuilder append(char[] value)

Appends the string representation of the Unicode characters in a specified array to this instance.

Parameters:

ParameterTypeDescription
valuechar[]The array of characters to append.

Returns: StringBuilder - A reference to this instance after the append operation has completed.

append(char[] value, int startIndex, int charCount)

public StringBuilder append(char[] value, int startIndex, int charCount)

Appends the string representation of a specified subarray of Unicode characters to this instance.

Parameters:

ParameterTypeDescription
valuechar[]A character array.
startIndexintThe starting position in value.
charCountintThe number of characters to append.

Returns: StringBuilder - A reference to this instance after the append operation has completed.

append(double value)

public StringBuilder append(double value)

Appends the string representation of a specified double number to this instance.

Parameters:

ParameterTypeDescription
valuedoubleThe value to append.

Returns: StringBuilder - A reference to this instance after the append operation has completed.

append(float value)

public StringBuilder append(float value)

Appends the string representation of a specified float number to this instance.

Parameters:

ParameterTypeDescription
valuefloatThe value to append.

Returns: StringBuilder - A reference to this instance after the append operation has completed.

append(int value)

public StringBuilder append(int value)

Appends the string representation of a specified int number to this instance.

Parameters:

ParameterTypeDescription
valueintThe value to append.

Returns: StringBuilder - A reference to this instance after the append operation has completed.

append(Object value)

public StringBuilder append(Object value)

Appends the string representation of a specified object to this instance.

Parameters:

ParameterTypeDescription
valuejava.lang.ObjectThe object to append.

Returns: StringBuilder - A reference to this instance after the append operation has completed.

append(String value)

public StringBuilder append(String value)

Appends a copy of the specified string to this instance.

Parameters:

ParameterTypeDescription
valuejava.lang.StringThe string to append.

Returns: StringBuilder - A reference to this instance after the append operation has completed.

append(String value, int startIndex, int count)

public StringBuilder append(String value, int startIndex, int count)

Appends a copy of a specified substring to this instance.

Parameters:

ParameterTypeDescription
valuejava.lang.StringThe string that contains the substring to append.
startIndexintThe starting position of the substring within value.
countintThe number of characters in value to append.

Returns: StringBuilder - A reference to this instance after the append operation has completed.

append(BigDecimal value)

public StringBuilder append(BigDecimal value)

Appends the string representation of a specified BigDecimal number to this instance.

Parameters:

ParameterTypeDescription
valuejava.math.BigDecimalThe value to append.

Returns: StringBuilder - A reference to this instance after the append operation has completed.

append(long value)

public StringBuilder append(long value)

Appends the string representation of a specified long number to this instance.

Parameters:

ParameterTypeDescription
valuelongThe value to append.

Returns: StringBuilder - A reference to this instance after the append operation has completed.

append(short value)

public StringBuilder append(short value)

Appends the string representation of a specified short number to this instance.

Parameters:

ParameterTypeDescription
valueshortThe value to append.

Returns: StringBuilder - A reference to this instance after the append operation has completed.

appendFormat(String format, Object[] args)

public StringBuilder appendFormat(String format, Object[] args)

Appends the string returned by processing a composite format string, which contains zero or more format items, to this instance. Each format item is replaced by the string representation of a corresponding argument in a parameter array.

Parameters:

ParameterTypeDescription
formatjava.lang.StringA composite format string.
argsjava.lang.Object[]An array of objects to format.

Returns: StringBuilder - A reference to this instance with format appended. Each format item in format is replaced by the string representation of the corresponding object argument.

appendLine()

public StringBuilder appendLine()

Appends the default line terminator to the end of the current StringBuilder object.

Returns: StringBuilder - A reference to this instance after the append operation has completed.

appendLine(String value)

public StringBuilder appendLine(String value)

Appends a copy of the specified string followed by the default line terminator to the end of the current StringBuilder object.

Parameters:

ParameterTypeDescription
valuejava.lang.StringThe string to append.

Returns: StringBuilder - A reference to this instance after the append operation has completed.

copyTo(int sourceIndex, char[] destination, int destinationIndex, int count)

public void copyTo(int sourceIndex, char[] destination, int destinationIndex, int count)

Copies the characters from a specified segment of this instance to a specified segment of a destination Char array.

Parameters:

ParameterTypeDescription
sourceIndexintThe starting position in this instance where characters will be copied from. The index is zero-based.
destinationchar[]The array where characters will be copied.
destinationIndexintThe starting position in destination where characters will be copied. The index is zero-based.
countintThe number of characters to be copied.

ensureCapacity(int capacity)

public int ensureCapacity(int capacity)

Ensures that the capacity of this instance of StringBuilder is at least the specified value.

Parameters:

ParameterTypeDescription
capacityintThe minimum capacity to ensure.

Returns: int - The new capacity of this instance.

equals(Object obj)

public boolean equals(Object obj)

Returns a value indicating whether this instance is equal to a specified object.

Parameters:

ParameterTypeDescription
objjava.lang.ObjectAn object to compare with this instance, or null.

Returns: boolean - true if this instance and sb have equal string, Capacity, and MaxCapacity values; otherwise, false.

getCapacity()

public int getCapacity()

Gets the maximum number of characters that can be contained in the memory allocated by the current instance.

Returns: int - The maximum number of characters that can be contained in the memory allocated by the current instance.

getLength()

public int getLength()

Gets the length of the current StringBuilder object.

Returns: int - The length of this instance.

getMaxCapacity()

public int getMaxCapacity()

Gets the maximum capacity of this instance.

Returns: int - The maximum number of characters this instance can hold.

hashCode()

public int hashCode()

Returns a hash code for this StringBuilder.

Returns: int - Returns a hash code value for this object.

insert(int index, boolean value)

public StringBuilder insert(int index, boolean value)

Inserts the string representation of a boolean value into this instance at the specified character position.

Parameters:

ParameterTypeDescription
indexintThe position in this instance where insertion begins.
valuebooleanThe value to insert.

Returns: StringBuilder - A reference to this instance after the insert operation has completed.

insert(int index, byte value)

public StringBuilder insert(int index, byte value)

Inserts the string representation of a byte value into this instance at the specified character position.

Parameters:

ParameterTypeDescription
indexintThe position in this instance where insertion begins.
valuebyteThe value to insert.

Returns: StringBuilder - A reference to this instance after the insert operation has completed.

insert(int index, char value)

public StringBuilder insert(int index, char value)

Inserts the string representation of a specified Unicode character into this instance at the specified character position.

Parameters:

ParameterTypeDescription
indexintThe position in this instance where insertion begins.
valuecharThe value to insert.

Returns: StringBuilder - A reference to this instance after the insert operation has completed.

insert(int index, char[] value)

public StringBuilder insert(int index, char[] value)

Inserts the string representation of a specified array of Unicode characters into this instance at the specified character position.

Parameters:

ParameterTypeDescription
indexintThe position in this instance where insertion begins.
valuechar[]The character array to insert.

Returns: StringBuilder - A reference to this instance after the insert operation has completed.

insert(int index, char[] value, int startIndex, int charCount)

public StringBuilder insert(int index, char[] value, int startIndex, int charCount)

Inserts the string representation of a specified subarray of Unicode characters into this instance at the specified character position.

Parameters:

ParameterTypeDescription
indexintThe position in this instance where insertion begins.
valuechar[]A character array.
startIndexintThe starting index within value.
charCountintThe number of characters to insert.

Returns: StringBuilder - A reference to this instance after the insert operation has completed.

insert(int index, double value)

public StringBuilder insert(int index, double value)

Inserts the string representation of a double number into this instance at the specified character position.

Parameters:

ParameterTypeDescription
indexintThe position in this instance where insertion begins.
valuedoubleThe value to insert.

Returns: StringBuilder - A reference to this instance after the insert operation has completed.

insert(int index, float value)

public StringBuilder insert(int index, float value)

Inserts the string representation of a float number into this instance at the specified character position.

Parameters:

ParameterTypeDescription
indexintThe position in this instance where insertion begins.
valuefloatThe value to insert.

Returns: StringBuilder - A reference to this instance after the insert operation has completed.

insert(int index, int value)

public StringBuilder insert(int index, int value)

Inserts the string representation of an int number into this instance at the specified character position.

Parameters:

ParameterTypeDescription
indexintThe position in this instance where insertion begins.
valueintThe value to insert.

Returns: StringBuilder - A reference to this instance after the insert operation has completed.

insert(int index, Object value)

public StringBuilder insert(int index, Object value)

Inserts the string representation of an object into this instance at the specified character position.

Parameters:

ParameterTypeDescription
indexintThe position in this instance where insertion begins.
valuejava.lang.ObjectThe object to insert, or null.

Returns: StringBuilder - A reference to this instance after the insert operation has completed.

insert(int index, String value)

public StringBuilder insert(int index, String value)

Inserts a string into this instance at the specified character position.

Parameters:

ParameterTypeDescription
indexintThe position in this instance where insertion begins.
valuejava.lang.StringThe string to insert.

Returns: StringBuilder - A reference to this instance after the insert operation has completed.

insert(int index, String value, int count)

public StringBuilder insert(int index, String value, int count)

Inserts one or more copies of a specified string into this instance at the specified character position.

Parameters:

ParameterTypeDescription
indexintThe position in this instance where insertion begins.
valuejava.lang.StringThe string to insert.
countintThe number of times to insert value.

Returns: StringBuilder - A reference to this instance after insertion has completed.

insert(int index, BigDecimal value)

public StringBuilder insert(int index, BigDecimal value)

Inserts the string representation of a decimal number into this instance at the specified character position.

Parameters:

ParameterTypeDescription
indexintThe position in this instance where insertion begins.
valuejava.math.BigDecimalThe value to insert.

Returns: StringBuilder - A reference to this instance after the insert operation has completed.

insert(int index, long value)

public StringBuilder insert(int index, long value)

Inserts the string representation of a long number into this instance at the specified character position.

Parameters:

ParameterTypeDescription
indexintThe position in this instance where insertion begins.
valuelongThe value to insert.

Returns: StringBuilder - A reference to this instance after the insert operation has completed.

insert(int index, short value)

public StringBuilder insert(int index, short value)

Inserts the string representation of a short number into this instance at the specified character position.

Parameters:

ParameterTypeDescription
indexintThe position in this instance where insertion begins.
valueshortThe value to insert.

Returns: StringBuilder - A reference to this instance after the insert operation has completed.

remove(int startIndex, int length)

public StringBuilder remove(int startIndex, int length)

Removes the specified range of characters from this instance.

Parameters:

ParameterTypeDescription
startIndexintThe zero-based position in this instance where removal begins.
lengthintThe number of characters to remove.

Returns: StringBuilder - A reference to this instance after the remove operation has completed.

replace(char oldChar, char newChar)

public StringBuilder replace(char oldChar, char newChar)

Replaces all occurrences of a specified character in this instance with another specified character.

Parameters:

ParameterTypeDescription
oldCharcharThe character to replace.
newCharcharThe character that replaces oldChar.

Returns: StringBuilder - A reference to this instance with oldChar replaced by newChar.

replace(char oldValue, char newValue, int startIndex, int count)

public StringBuilder replace(char oldValue, char newValue, int startIndex, int count)

Replaces, within a substring of this instance, all occurrences of a specified character with another specified character.

Parameters:

ParameterTypeDescription
oldValuecharThe character to replace.
newValuecharThe character that replaces oldChar.
startIndexintThe position in this instance where the substring begins.
countintThe length of the substring.

Returns: StringBuilder - A reference to this instance with oldChar replaced by newChar in the range from startIndex to startIndex + count -1.

replace(String oldValue, String newValue)

public StringBuilder replace(String oldValue, String newValue)

Replaces all occurrences of a specified string in this instance with another specified string.

Parameters:

ParameterTypeDescription
oldValuejava.lang.StringThe string to replace.
newValuejava.lang.StringThe string that replaces oldValue, or null.

Returns: StringBuilder - A reference to this instance with all instances of oldValue replaced by newValue.

replace(String oldValue, String newValue, int startIndex, int count)

public StringBuilder replace(String oldValue, String newValue, int startIndex, int count)

Replaces, within a substring of this instance, all occurrences of a specified string with another specified string.

Parameters:

ParameterTypeDescription
oldValuejava.lang.StringThe string to replace.
newValuejava.lang.StringThe string that replaces oldValue, or null.
startIndexintThe position in this instance where the substring begins.
countintThe length of the substring.

Returns: StringBuilder - A reference to this instance with all instances of oldValue replaced by newValue in the range from startIndex to startIndex + count - 1.

setCapacity(int value)

public void setCapacity(int value)

Sets the maximum number of characters that can be contained in the memory allocated by the current instance.

Parameters:

ParameterTypeDescription
valueintThe maximum number of characters that can be contained in the memory allocated by the current instance.

setLength(int value)

public void setLength(int value)

Sets the length of the current StringBuilder object.

Parameters:

ParameterTypeDescription
valueintThe length of this instance.

toString()

public String toString()

Converts the value of this instance to a String.

Returns: java.lang.String - A string whose value is the same as this instance.

toString(int startIndex, int length)

public String toString(int startIndex, int length)

Converts the value of a substring of this instance to a String.

Parameters:

ParameterTypeDescription
startIndexintThe starting position of the substring in this instance.
lengthintThe length of the substring.

Returns: java.lang.String - A string whose value is the same as the specified substring of this instance.