java.lang

Class StringBuffer

java.lang.Object

java.lang.StringBuffer

All Implemented Interfaces:

Appendable, CharSequence

public class StringBuffer
extends Object
implements CharSequence, Appendable

A fast way to create strings using multiple appends. This is implemented using a StringBufferImpl that is chosen with deferred binding. Most methods will give expected performance results. Exceptions are setCharAt(int, char), which is O(n), and length(), which forces a toString() and thus should not be used many times on the same StringBuffer. This class is an exact clone of StringBuilder except for the name. Any change made to one should be mirrored in the other.

Constructor Summary

Constructors

Constructor and Description
StringBuffer()
StringBuffer(CharSequence s)
StringBuffer(int ignoredCapacity) This implementation does not track capacity; using this constructor is functionally equivalent to using the zero-argument constructor.
StringBuffer(String s)

Method Summary

Modifier and Type	Method and Description
StringBuffer	append(boolean x)
StringBuffer	append(char x)
StringBuffer	append(char[] x)
StringBuffer	append(char[] x, int start, int len)
StringBuffer	append(CharSequence x)
StringBuffer	append(CharSequence x, int start, int end)
StringBuffer	append(double x)
StringBuffer	append(float x)
StringBuffer	append(int x)
StringBuffer	append(long x)
StringBuffer	append(Object x)
StringBuffer	append(String x)
StringBuffer	append(StringBuffer x)
int	capacity() This implementation does not track capacity; always returns Integer.MAX_VALUE.
char	charAt(int index)
StringBuffer	delete(int start, int end)
StringBuffer	deleteCharAt(int start)
void	ensureCapacity(int ignoredCapacity) This implementation does not track capacity; calling this method has no effect.
void	getChars(int srcStart, int srcEnd, char[] dst, int dstStart)
int	indexOf(String x)
int	indexOf(String x, int start)
StringBuffer	insert(int index, boolean x)
StringBuffer	insert(int index, char x)
StringBuffer	insert(int index, char[] x)
StringBuffer	insert(int index, char[] x, int offset, int len)
StringBuffer	insert(int index, CharSequence chars)
StringBuffer	insert(int index, CharSequence chars, int start, int end)
StringBuffer	insert(int index, double x)
StringBuffer	insert(int index, float x)
StringBuffer	insert(int index, int x)
StringBuffer	insert(int index, long x)
StringBuffer	insert(int index, Object x)
StringBuffer	insert(int index, String x)
int	lastIndexOf(String s)
int	lastIndexOf(String s, int start)
int	length()
StringBuffer	replace(int start, int end, String toInsert)
StringBuffer	reverse()
void	setCharAt(int index, char x) Warning! This method is much slower than the JRE implementation.
void	setLength(int newLength)
CharSequence	subSequence(int start, int end)
String	substring(int begin)
String	substring(int begin, int end)
String	toString()
void	trimToSize()

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode

Constructor Detail

StringBuffer

public StringBuffer()

StringBuffer

public StringBuffer(CharSequence s)

StringBuffer

public StringBuffer(int ignoredCapacity)

This implementation does not track capacity; using this constructor is functionally equivalent to using the zero-argument constructor.

StringBuffer

public StringBuffer(String s)

Method Detail

append

public StringBuffer append(boolean x)

append

public StringBuffer append(char x)

Specified by:

append in interface Appendable

append

public StringBuffer append(char[] x)

append

public StringBuffer append(char[] x,
                           int start,
                           int len)

append

public StringBuffer append(CharSequence x)

Specified by:

append in interface Appendable

append

public StringBuffer append(CharSequence x,
                           int start,
                           int end)

Specified by:

append in interface Appendable

append

public StringBuffer append(double x)

append

public StringBuffer append(float x)

append

public StringBuffer append(int x)

append

public StringBuffer append(long x)

append

public StringBuffer append(Object x)

append

public StringBuffer append(String x)

append

public StringBuffer append(StringBuffer x)

capacity

public int capacity()

This implementation does not track capacity; always returns Integer.MAX_VALUE.

charAt

public char charAt(int index)

Specified by:

charAt in interface CharSequence

delete

public StringBuffer delete(int start,
                           int end)

deleteCharAt

public StringBuffer deleteCharAt(int start)

ensureCapacity

public void ensureCapacity(int ignoredCapacity)

This implementation does not track capacity; calling this method has no effect.

getChars

public void getChars(int srcStart,
                     int srcEnd,
                     char[] dst,
                     int dstStart)

indexOf

public int indexOf(String x)

indexOf

public int indexOf(String x,
                   int start)

insert

public StringBuffer insert(int index,
                           boolean x)

insert

public StringBuffer insert(int index,
                           char x)

insert

public StringBuffer insert(int index,
                           char[] x)

insert

public StringBuffer insert(int index,
                           char[] x,
                           int offset,
                           int len)

insert

public StringBuffer insert(int index,
                           CharSequence chars)

insert

public StringBuffer insert(int index,
                           CharSequence chars,
                           int start,
                           int end)

insert

public StringBuffer insert(int index,
                           double x)

insert

public StringBuffer insert(int index,
                           float x)

insert

public StringBuffer insert(int index,
                           int x)

insert

public StringBuffer insert(int index,
                           long x)

insert

public StringBuffer insert(int index,
                           Object x)

insert

public StringBuffer insert(int index,
                           String x)

lastIndexOf

public int lastIndexOf(String s)

lastIndexOf

public int lastIndexOf(String s,
                       int start)

length

public int length()

Specified by:

length in interface CharSequence

replace

public StringBuffer replace(int start,
                            int end,
                            String toInsert)

reverse

public StringBuffer reverse()

setCharAt

public void setCharAt(int index,
                      char x)

Warning! This method is much slower than the JRE implementation. If you need to do character level manipulation, you are strongly advised to use a char[] directly.

setLength

public void setLength(int newLength)

subSequence

public CharSequence subSequence(int start,
                                int end)

Specified by:

subSequence in interface CharSequence

substring

public String substring(int begin)

substring

public String substring(int begin,
                        int end)

toString

public String toString()

Specified by:

toString in interface CharSequence

Overrides:

toString in class Object

trimToSize

public void trimToSize()