StringBuffer.insert

Class Overview | Class Members | This Package | All Packages

Syntax 1

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

Parameters
  • offset
    the offset.
  • b
    an Object.
Returns

this string buffer.

Description

Inserts the string representation of the Object argument into this string buffer.

The second argument is converted to a string as if by the method String.valueOf, and the characters of that string are then inserted into this string buffer at the indicated offset.

The offset argument must be greater than or equal to 0, and less than or equal to the length of this string buffer.

Exceptions

StringIndexOutOfBoundsException if the offset is invalid.

See Also

valueOf, insert, length

Syntax 2

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

Parameters
  • offset
    the offset.
  • str
    a string.
Returns

this string buffer.

Description

Inserts the string into this string buffer.

The characters of the String argument are inserted, in order, into this string buffer at the indicated offset. The length of this string buffer is increased by the length of the argument.

The offset argument must be greater than or equal to 0, and less than or equal to the length of this string buffer.

Exceptions

StringIndexOutOfBoundsException if the offset is invalid.

See Also

length

Syntax 3

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

Parameters
  • offset
    the offset.
  • ch
    a character array.
Returns

this string buffer.

Description

Inserts the string representation of the char array argument into this string buffer.

The characters of the array argument are inserted into the contents of this string buffer at the position indicated by offset. The length of this string buffer increases by the length of the argument.

Exceptions

StringIndexOutOfBoundsException if the offset is invalid.

Syntax 4

public StringBuffer insert( int offset**, boolean** b )

Parameters
  • offset
    the offset.
  • b
    a boolean.
Returns

this string buffer.

Description

Inserts the string representation of the boolean argument into this string buffer.

The second argument is converted to a string as if by the method String.valueOf, and the characters of that string are then inserted into this string buffer at the indicated offset.

The offset argument must be greater than or equal to 0, and less than or equal to the length of this string buffer.

Exceptions

StringIndexOutOfBoundsException if the offset is invalid.

See Also

valueOf, insert, length

Syntax 5

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

Parameters
  • offset
    the offset.
  • ch
    a char.
Returns

this string buffer.

Description

Inserts the string representation of the char argument into this string buffer.

The second argument is inserted into the contents of this string buffer at the position indicated by offset. The length of this string buffer increases by one.

The offset argument must be greater than or equal to 0, and less than or equal to the length of this string buffer.

Exceptions

StringIndexOutOfBoundsException if the offset is invalid.

See Also

length

Syntax 6

public StringBuffer insert( int offset**, int** i )

Parameters
  • offset
    the offset.
  • b
    an int.
Returns

this string buffer.

Description

Inserts the string representation of the second int argument into this string buffer.

The second argument is converted to a string as if by the method String.valueOf, and the characters of that string are then inserted into this string buffer at the indicated offset.

The offset argument must be greater than or equal to 0, and less than or equal to the length of this string buffer.

Exceptions

StringIndexOutOfBoundsException if the offset is invalid.

See Also

valueOf, insert, length

Syntax 7

public StringBuffer insert( int offset**, long** l )

Parameters
  • offset
    the offset.
  • b
    a long.
Returns

this string buffer.

Description

Inserts the string representation of the long argument into this string buffer.

The second argument is converted to a string as if by the method String.valueOf, and the characters of that string are then inserted into this string buffer at the indicated offset.

The offset argument must be greater than or equal to 0, and less than or equal to the length of this string buffer.

Exceptions

StringIndexOutOfBoundsException if the offset is invalid.

See Also

valueOf, insert, length

Syntax 8

public StringBuffer insert( int offset**, float** f )

Parameters
  • offset
    the offset.
  • b
    a float.
Returns

this string buffer.

Description

Inserts the string representation of the float argument into this string buffer.

The second argument is converted to a string as if by the method String.valueOf, and the characters of that string are then inserted into this string buffer at the indicated offset.

The offset argument must be greater than or equal to 0, and less than or equal to the length of this string buffer.

Exceptions

StringIndexOutOfBoundsException if the offset is invalid.

See Also

valueOf, insert, length

Syntax 9

public StringBuffer insert( int offset**, double** d )

Parameters
  • offset
    the offset.
  • b
    a double.
Returns

this string buffer.

Description

Inserts the string representation of the double argument into this string buffer.

The second argument is converted to a string as if by the method String.valueOf, and the characters of that string are then inserted into this string buffer at the indicated offset.

The offset argument must be greater than or equal to 0, and less than or equal to the length of this string buffer.

Exceptions

StringIndexOutOfBoundsException if the offset is invalid.

See Also

valueOf, insert, length