20.13

java.lang.StringBuffer

THE PACKAGE JAVA.LANG

Note that while the

StringBuffer

 class provides an

append

 method that

takes an offset, a character array, and two other arguments ( 20.13.15), it does not

currently provide an

insert

 method that takes an offset, a character array, and

two other arguments.

20.13.25

public StringBuffer insert(int offset, boolean b)

throws IndexOutOfBoundsException

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

String.valueOf

( 20.12.41) and the characters of that string are then inserted ( 20.13.23) into this

StringBuffer

 object at the position indicated by

offset

. A reference to this

StringBuffer

 object is returned.

20.13.26

public StringBuffer insert(int offset, char c)

throws IndexOutOfBoundsException

The argument is inserted into the contents of this string buffer at the position indi 

cated by

offset

, increasing the length of this string buffer by

1

. The method

ensureCapacity

 ( 20.13.7) is first called with this new string buffer length as its

argument. A reference to this

StringBuffer

 object is returned.

The overall effect is exactly as if the argument were converted to a string by

the method

String.valueOf

 ( 20.12.42) and the character in that string were

then inserted ( 20.13.23) into this

StringBuffer

 object at the position indicated

by

offset

.

20.13.27

public StringBuffer insert(int offset, int i)

throws IndexOutOfBoundsException

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

String.valueOf

( 20.12.43) and the characters of that string are then inserted ( 20.13.23) into this

StringBuffer

 object at the position indicated by

offset

. A reference to this

StringBuffer

 object is returned.

20.13.28

public StringBuffer insert(int offset, long l)

throws IndexOutOfBoundsException

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

String.valueOf

( 20.12.44) and the characters of that string are inserted ( 20.13.23) into this

556