Java in a Nutshell

Previous Chapter 25
The java.lang Package
Next
 

25.58 java.lang.StringBuffer (JDK 1.0)

This class represents a string of characters. It differs from the String class in that its contents may be modified. A StringBuffer object grows in length as necessary. The string stored in a StringBuffer object may be modified in place with the setCharAt(), append(), and insert() methods.

After a string is processed in a StringBuffer object, it may be efficiently converted to a String object for subsequent use. The StringBuffer.toString() method does not copy the internal array of characters; instead it shares that array with the new String object, and makes a new copy for itself only when further modifications are made to the StringBuffer object.


public final class StringBuffer extends Object implements Serializable {

    // Public Constructors

            public StringBuffer();

            public StringBuffer(int length);

            public StringBuffer(String str);

    // Public Instance Methods

            public synchronized StringBuffer append(Object obj);

            public synchronized StringBuffer append(String str);

            public synchronized StringBuffer append(char[] str);

            public synchronized StringBuffer append(char[] str, int offset, int len);

            public StringBuffer append(boolean b);

            public synchronized StringBuffer append(char c);

            public StringBuffer append(int i);

            public StringBuffer append(long l);

            public StringBuffer append(float f);

            public StringBuffer append(double d);

            public int capacity();

            public synchronized char charAt(int index);

            public synchronized void ensureCapacity(int minimumCapacity);

            public synchronized void getChars(int srcBegin, int srcEnd, char[] dst, int dstBegin);

            public synchronized StringBuffer insert(int offset, Object obj);

            public synchronized StringBuffer insert(int offset, String str);

            public synchronized StringBuffer insert(int offset, char[] str);

            public StringBuffer insert(int offset, boolean b);

            public synchronized StringBuffer insert(int offset, char c);

            public StringBuffer insert(int offset, int i);

            public StringBuffer insert(int offset, long l);

            public StringBuffer insert(int offset, float f);

            public StringBuffer insert(int offset, double d);

            public int length();

            public synchronized StringBuffer reverse();

            public synchronized void setCharAt(int index, char ch);

            public synchronized void setLength(int newLength);

            public String toString();  // Overrides Object

}

Passed To:

ChoiceFormat.format(), DateFormat.format(), DecimalFormat.format(), Format.format(), MessageFormat.format(), NumberFormat.format(), SimpleDateFormat.format(), String()

Returned By:

ChoiceFormat.format(), DateFormat.format(), DecimalFormat.format(), Format.format(), MessageFormat.format(), NumberFormat.format(), SimpleDateFormat.format(), StringBuffer.append(), StringBuffer.insert(), StringBuffer.reverse(), StringWriter.getBuffer()


Previous Home Next
java.lang.String (JDK 1.0) Book Index java.lang.StringIndexOutOfBoundsException (JDK 1.0)

Java in a Nutshell Java Language Reference Java AWT Java Fundamental Classes Exploring Java