20.13

java.lang.StringBuffer

THE PACKAGE JAVA.LANG

20.13.10

public void setCharAt(int index, char ch)

throws IndexOutOfBoundsException

The string buffer 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

.

If the

index

 argument is negative or not less than the current length

( 20.13.5) of the string buffer, an

IndexOutOfBoundsException

 is thrown.

20.13.11

public void getChars(int srcBegin, int srcEnd,

char[] dst, int dstBegin)

throws NullPointerException,

IndexOutOfBoundsException

Characters are copied from this

StringBuffer

 object into the destination array

dst

. The first character to be copied is at index

srcBegin

; the last character to be

copied is at index

srcEnd 1

 (thus, 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

.

If

dst

 is

null

, then a

NullPointerException

 is thrown.

Otherwise, if any of the following is true, an

IndexOutOfBoundsException

is thrown and the destination is not modified:

The

srcBegin

 argument is negative.

The

srcBegin

 argument is greater than the

srcEnd

 argument.

srcEnd

 is greater than

this.length()

, the current length of this string

buffer.

dstBegin+srcEnd srcBegin

 is greater than

dst.length

.

20.13.12

public StringBuffer append(Object obj)

The argument is converted to a string as if by the method

String.valueOf

( 20.12.38) and the characters of that string are then appended ( 20.13.13) to this

StringBuffer

 object. A reference to this

StringBuffer

 object is returned.

20.13.13

public StringBuffer append(String str)

The characters of the

String

 argument are appended, in order, to the contents of

this string buffer, increasing the length of this string buffer by the length of the

552