public final class StringBuilder extends Object
Constructor and Description |
---|
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.
|
Modifier and Type | Method and Description |
---|---|
StringBuilder |
append(BigDecimal value)
Appends the string representation of a specified BigDecimal number to this instance.
|
StringBuilder |
append(boolean value)
Appends the string representation of a specified boolean value to this instance.
|
StringBuilder |
append(byte value)
Appends the string representation of a specified byte to this instance.
|
StringBuilder |
append(char value)
Appends the string representation of a specified Unicode character to this instance.
|
StringBuilder |
append(char[] value)
Appends the string representation of the Unicode characters in a specified array to this instance.
|
StringBuilder |
append(char[] value,
int startIndex,
int charCount)
Appends the string representation of a specified subarray of Unicode characters to this instance.
|
StringBuilder |
append(char value,
int repeatCount)
Appends a specified number of copies of the string representation of a Unicode character to this instance.
|
StringBuilder |
append(double value)
Appends the string representation of a specified double number to this instance.
|
StringBuilder |
append(float value)
Appends the string representation of a specified float number to this instance.
|
StringBuilder |
append(int value)
Appends the string representation of a specified int number to this instance.
|
StringBuilder |
append(long value)
Appends the string representation of a specified long number to this instance.
|
StringBuilder |
append(Object value)
Appends the string representation of a specified object to this instance.
|
StringBuilder |
append(short value)
Appends the string representation of a specified short number to this instance.
|
StringBuilder |
append(String value)
Appends a copy of the specified string to this instance.
|
StringBuilder |
append(String value,
int startIndex,
int count)
Appends a copy of a specified substring to this instance.
|
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.
|
StringBuilder |
appendLine()
Appends the default line terminator to the end of the current StringBuilder object.
|
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.
|
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.
|
int |
ensureCapacity(int capacity)
Ensures that the capacity of this instance of StringBuilder is at least the specified value.
|
boolean |
equals(Object obj)
Returns a value indicating whether this instance is equal to a specified object.
|
int |
getCapacity()
Gets the maximum number of characters that can be contained in the memory allocated by the current instance.
|
int |
getLength()
Gets the length of the current StringBuilder object.
|
int |
getMaxCapacity()
Gets the maximum capacity of this instance.
|
int |
hashCode()
Returns a hash code for this StringBuilder.
|
StringBuilder |
insert(int index,
BigDecimal value)
Inserts the string representation of a decimal number into this instance at the specified character position.
|
StringBuilder |
insert(int index,
boolean value)
Inserts the string representation of a boolean value into this instance at the specified character position.
|
StringBuilder |
insert(int index,
byte value)
Inserts the string representation of a byte value into this instance at the specified character position.
|
StringBuilder |
insert(int index,
char value)
Inserts the string representation of a specified Unicode character into this instance at the specified character
position.
|
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.
|
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.
|
StringBuilder |
insert(int index,
double value)
Inserts the string representation of a double number into this instance at the specified character position.
|
StringBuilder |
insert(int index,
float value)
Inserts the string representation of a float number into this instance at the specified character position.
|
StringBuilder |
insert(int index,
int value)
Inserts the string representation of an int number into this instance at the specified character position.
|
StringBuilder |
insert(int index,
long value)
Inserts the string representation of a long number into this instance at the specified character position.
|
StringBuilder |
insert(int index,
Object value)
Inserts the string representation of an object into this instance at the specified character position.
|
StringBuilder |
insert(int index,
short value)
Inserts the string representation of a short number into this instance at the specified character position.
|
StringBuilder |
insert(int index,
String value)
Inserts a string into this instance at the specified character position.
|
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.
|
StringBuilder |
remove(int startIndex,
int length)
Removes the specified range of characters from this instance.
|
StringBuilder |
replace(char oldChar,
char newChar)
Replaces all occurrences of a specified character in this instance with another specified character.
|
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.
|
StringBuilder |
replace(String oldValue,
String newValue)
Replaces all occurrences of a specified string in this instance with another specified string.
|
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.
|
void |
setCapacity(int value)
Sets the maximum number of characters that can be contained in the memory allocated by the current instance.
|
void |
setLength(int value)
Sets the length of the current StringBuilder object.
|
String |
toString()
Converts the value of this instance to a String.
|
String |
toString(int startIndex,
int length)
Converts the value of a substring of this instance to a String.
|
public StringBuilder()
public StringBuilder(int capacity)
capacity
- The suggested starting size of this instance.public StringBuilder(int capacity, int maxCapacity)
capacity
- The suggested starting size of the StringBuilder.maxCapacity
- The maximum number of characters the current string can contain.public StringBuilder(String value)
value
- The string used to initialize the value of the instance.public StringBuilder(String value, int capacity)
value
- The string used to initialize the value of the instance.capacity
- The suggested starting size of the StringBuilder.public StringBuilder(String value, int startIndex, int length, int capacity)
value
- The string that contains the substring used to initialize the value of this instance.startIndex
- The position within value where the substring begins.length
- The number of characters in the substring.capacity
- The suggested starting size of the StringBuilder.public StringBuilder append(String value)
value
- The string to append.public StringBuilder append(boolean value)
value
- The boolean value to append.public StringBuilder append(BigDecimal value)
value
- The value to append.public StringBuilder append(double value)
value
- The value to append.public StringBuilder append(short value)
value
- The value to append.public StringBuilder append(int value)
value
- The value to append.public StringBuilder append(char value)
value
- The Unicode character to append.public StringBuilder append(char value, int repeatCount)
value
- The character to append.repeatCount
- The number of times to append value.public StringBuilder append(char[] value, int startIndex, int charCount)
value
- A character array.startIndex
- The starting position in value.charCount
- The number of characters to append.public StringBuilder append(String value, int startIndex, int count)
value
- The string that contains the substring to append.startIndex
- The starting position of the substring within value.count
- The number of characters in value to append.public StringBuilder append(long value)
value
- The value to append.public StringBuilder append(Object value)
value
- The object to append.public StringBuilder append(byte value)
value
- The value to append.public StringBuilder append(float value)
value
- The value to append.public StringBuilder append(char[] value)
value
- The array of characters to append.public StringBuilder appendFormat(String format, Object... args)
format
- A composite format string.args
- An array of objects to format.public StringBuilder appendLine(String value)
value
- The string to append.public StringBuilder appendLine()
public void copyTo(int sourceIndex, char[] destination, int destinationIndex, int count)
sourceIndex
- The starting position in this instance where characters will be copied from. The index
is
zero-based.destination
- The array where characters will be copied.destinationIndex
- The starting position in destination where characters will be copied. The index
is
zero-based.count
- The number of characters to be copied.public int ensureCapacity(int capacity)
capacity
- The minimum capacity to ensure.public boolean equals(Object obj)
public int getCapacity()
public void setCapacity(int value)
value
- The maximum number of characters that can be contained in the memory allocated by the
current
instance.public int getLength()
public void setLength(int value)
value
- The length of this instance.public int getMaxCapacity()
public int hashCode()
public StringBuilder insert(int index, char value)
index
- The position in this instance where insertion begins.value
- The value to insert.public StringBuilder insert(int index, BigDecimal value)
index
- The position in this instance where insertion begins.value
- The value to insert.public StringBuilder insert(int index, double value)
index
- The position in this instance where insertion begins.value
- The value to insert.public StringBuilder insert(int index, short value)
index
- The position in this instance where insertion begins.value
- The value to insert.public StringBuilder insert(int index, boolean value)
index
- The position in this instance where insertion begins.value
- The value to insert.public StringBuilder insert(int index, char[] value)
index
- The position in this instance where insertion begins.value
- The character array to insert.public StringBuilder insert(int index, String value)
index
- The position in this instance where insertion begins.value
- The string to insert.public StringBuilder insert(int index, byte value)
index
- The position in this instance where insertion begins.value
- The value to insert.public StringBuilder insert(int index, float value)
index
- The position in this instance where insertion begins.value
- The value to insert.public StringBuilder insert(int index, String value, int count)
index
- The position in this instance where insertion begins.value
- The string to insert.count
- The number of times to insert value.public StringBuilder insert(int index, char[] value, int startIndex, int charCount)
index
- The position in this instance where insertion begins.value
- A character array.startIndex
- The starting index within value.charCount
- The number of characters to insert.public StringBuilder insert(int index, Object value)
index
- The position in this instance where insertion begins.value
- The object to insert, or null.public StringBuilder insert(int index, long value)
index
- The position in this instance where insertion begins.value
- The value to insert.public StringBuilder insert(int index, int value)
index
- The position in this instance where insertion begins.value
- The value to insert.public StringBuilder remove(int startIndex, int length)
startIndex
- The zero-based position in this instance where removal begins.length
- The number of characters to remove.public StringBuilder replace(char oldChar, char newChar)
oldChar
- The character to replace.newChar
- The character that replaces oldChar.public StringBuilder replace(String oldValue, String newValue, int startIndex, int count)
oldValue
- The string to replace.newValue
- The string that replaces oldValue, or null.startIndex
- The position in this instance where the substring begins.count
- The length of the substring.public StringBuilder replace(String oldValue, String newValue)
oldValue
- The string to replace.newValue
- The string that replaces oldValue, or null.public StringBuilder replace(char oldValue, char newValue, int startIndex, int count)
oldValue
- The character to replace.newValue
- The character that replaces oldChar.startIndex
- The position in this instance where the substring begins.count
- The length of the substring.public String toString()
public String toString(int startIndex, int length)
startIndex
- The starting position of the substring in this instance.length
- The length of the substring.