Class StringBuffer

vm/JavaAPI/src/java/lang/StringBuffer.java:36–364

A string buffer implements a mutable sequence of characters. A string buffer is like a String, but can be modified. At any point in time it contains some particular sequence of characters, but the length and content of the sequence can be changed through certain method calls. String buffers are safe

 * Since: JDK1.0, CLDC 1.0 See Also:ByteArrayOutputStream, String
 */
public final class StringBuffer implements CharSequence, Appendable {
    private StringBuilder internal;
    /**
     * Constructs a string buffer with no characters in it and an initial capacity of 16 characters.
     */
    public StringBuffer(){
         internal = new StringBuilder();
    }

    /**
     * Constructs a string buffer with no characters in it and an initial capacity specified by the length argument.
     * length - the initial capacity.
     * - if the length argument is less than 0.
     */
    public StringBuffer(int length){
         internal = new StringBuilder(length);
    }

    /**
     * Constructs a string buffer so that it represents the same sequence of characters as the string argument; in other words, the initial contents of the string buffer is a copy of the argument string. The initial capacity of the string buffer is 16 plus the length of the string argument.
     * str - the initial contents of the buffer.
     */
    public StringBuffer(java.lang.String str){
        internal = new StringBuilder(str);
    }

    /**
     * Appends the string representation of the boolean argument to the string buffer.
     * The argument is converted to a string as if by the method String.valueOf, and the characters of that string are then appended to this string buffer.
     */
    public java.lang.StringBuffer append(boolean b){
        internal.append(b);
        return this; 
    }

    /**
     * Appends the string representation of the char argument to this string buffer.
     * The argument is appended to the contents of this string buffer. The length of this string buffer increases by 1.
     * The overall effect is exactly as if the argument were converted to a string by the method String.valueOf(char) and the character in that string were then appended to this StringBuffer object.
     */
    public java.lang.StringBuffer append(char c){
        internal.append(c);
        return this; 
    }

    java.lang.StringBuffer append(char[] str){
        internal.append(str);
        return this; 
    }

    /**
     * Appends the string representation of a subarray of the char array argument to this string buffer.
     * Characters of the character array str, starting at index offset, are appended, in order, to the contents of this string buffer. The length of this string buffer increases by the value of len.
     * The overall effect is exactly as if the arguments were converted to a string by the method String.valueOf(char[],int,int) and the characters of that string were then appended to this StringBuffer object.
     */
    public java.lang.StringBuffer append(char[] str, int offset, int len){
        internal.append(str, offset, len);
        return this;