Returns the current capacity.

  Returns the current capacity. The capacity is the amount of storage
available for newly inserted characters, beyond which an allocation
will occur.
Returns: the current capacity

  Returns the char value in this sequence at the specified index.

  Returns the char value in this sequence at the specified index. The first char value is at index 0, the next at index 1, and so on, as in array indexing.

The index argument must be greater than or equal to 0, and less than the length of this sequence.

If the char value specified by the index is a surrogate, the surrogate value is returned.
Returns: the char value at the specified index.
Parameters:
- index - the index of the desired char value.
Throws:
- IndexOutOfBoundsException - if index is negative or greater than or equal to length().

Returns the character (Unicode code point) at the specified index.

Returns the character (Unicode code point) before the specified index.

  Returns the number of Unicode code points in the specified text range of this sequence.

  Returns the number of Unicode code points in the specified text
range of this sequence. The text range begins at the specified
beginIndex and extends to the char at
index endIndex - 1. Thus the length (in
chars) of the text range is
endIndex-beginIndex. Unpaired surrogates within
this sequence count as one code point each.
Returns: the number of Unicode code points in the specified text range
Parameters:
- beginIndex - the index to the first char of the text range.
- endIndex - the index after the last char of the text range.
Throws:
- IndexOutOfBoundsException - if the beginIndex is negative, or endIndex is larger than the length of this sequence, or beginIndex is larger than endIndex.

  Ensures that the capacity is at least equal to the specified minimum.

  Ensures that the capacity is at least equal to the specified minimum.
If the current capacity is less than the argument, then a new internal
array is allocated with greater capacity. The new capacity is the
larger of:

• The minimumCapacity argument.
  
• Twice the old capacity, plus 2.
  

If the minimumCapacity argument is nonpositive, this
method takes no action and simply returns.
Parameters:
- minimumCapacity - the minimum desired capacity.

This implements the expansion semantics of ensureCapacity with no size check or synchronization.

  Characters are copied from this sequence into the destination character array dst.

  Characters are copied from this sequence into the destination character array dst. The first character to be copied is at index srcBegin; the last character to be copied is at index srcEnd-1. The total number of characters to be copied is srcEnd-srcBegin. The characters are copied into the subarray of dst starting at index dstBegin and ending at index:

 dstbegin + (srcEnd-srcBegin) - 1
 

Parameters:
- srcBegin - start copying at this offset.
- srcEnd - stop copying at this offset.
- dst - the array to copy the data into.
- dstBegin - offset into dst.
Throws:
- NullPointerException - if dst is null.
- IndexOutOfBoundsException - if any of the following is true:

• srcBegin is negative
• dstBegin is negative
• the srcBegin argument is greater than the srcEnd argument.
• srcEnd is greater than this.length().
• dstBegin+srcEnd-srcBegin is greater than dst.length

Needed by String for the contentEquals method.

  Returns the length (character count).

  Returns the length (character count).
Returns: the length of the sequence of characters currently represented by this object

  Returns the index within this sequence that is offset from the given index by codePointOffset code points.

  Returns the index within this sequence that is offset from the
given index by codePointOffset code
points. Unpaired surrogates within the text range given by
index and codePointOffset count as
one code point each.
Returns: the index within this sequence
Parameters:
- index - the index to be offset
- codePointOffset - the offset in code points
Throws:
- IndexOutOfBoundsException - if index is negative or larger then the length of this sequence, or if codePointOffset is positive and the subsequence starting with index has fewer than codePointOffset code points, or if codePointOffset is negative and the subsequence before index has fewer than the absolute value of codePointOffset code points.

  The character at the specified index is set to ch.

  The character at the specified index is set to ch. This sequence is altered to represent a new character sequence that is identical to the old character sequence, except that it contains the character ch at position index.

The index argument must be greater than or equal to 0, and less than the length of this sequence.
Parameters:
- index - the index of the character to modify.
- ch - the new character.
Throws:
- IndexOutOfBoundsException - if index is negative or greater than or equal to length().

  Sets the length of the character sequence.

  Sets the length of the character sequence. The sequence is changed to a new character sequence whose length is specified by the argument. For every nonnegative index k less than newLength, the character at index k in the new character sequence is the same as the character at index k in the old sequence if k is less than the length of the old character sequence; otherwise, it is the null character '\u0000'. In other words, if the newLength argument is less than the current length, the length is changed to the specified length.

If the newLength argument is greater than or equal to the current length, sufficient null characters ('\u0000') are appended so that length becomes the newLength argument.

The newLength argument must be greater than or equal to 0.
Parameters:
- newLength - the new length
Throws:
- IndexOutOfBoundsException - if the newLength argument is negative.

  Returns a new character sequence that is a subsequence of this sequence.

  Returns a new character sequence that is a subsequence of this sequence.

An invocation of this method of the form

 sb.subSequence(begin, end)

behaves in exactly the same way as the invocation

 sb.substring(begin, end)

This method is provided so that this class can implement the CharSequence interface.

Returns: the specified subsequence.
Parameters:
- start - the start index, inclusive.
- end - the end index, exclusive.
Throws:
- IndexOutOfBoundsException - if start or end are negative, if end is greater than length(), or if start is greater than end

  Returns a new String that contains a subsequence of characters currently contained in this character sequence.

  Returns a new String that contains a subsequence of
characters currently contained in this character sequence. The
substring begins at the specified index and extends to the end of
this sequence.
Returns: The new string.
Parameters:
- start - The beginning index, inclusive.
Throws:
- StringIndexOutOfBoundsException - if start is less than zero, or greater than the length of this object.

  Returns a new String that contains a subsequence of characters currently contained in this sequence.

  Returns a new String that contains a subsequence of
characters currently contained in this sequence. The
substring begins at the specified start and
extends to the character at index end - 1.
Returns: The new string.
Parameters:
- start - The beginning index, inclusive.
- end - The ending index, exclusive.
Throws:
- StringIndexOutOfBoundsException - if start or end are negative or greater than length(), or start is greater than end.

Attempts to reduce storage used for the character sequence.