20.12

java.lang.String

THE PACKAGE JAVA.LANG

20.12.12

public char charAt(int index)

throws IndexOutOfBoundsException

This method returns the character indicated by the

index

 argument within the

sequence of characters represented by this

String

. The first character of the

sequence is at index

0

, the next at index

1

, and so on, as for array indexing. If the

index

 argument is negative or not less than the length ( 20.12.11) of this string,

then an

IndexOutOfBoundsException

 is thrown.

20.12.13

public void getChars(int srcBegin, int srcEnd,

char dst[], int dstBegin)

throws NullPointerException,

IndexOutOfBoundsException

Characters are copied from this

String

 object into the destination character 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.

An

IndexOutOfBoundsException

 is thrown if any of the following is true:

srcBegin

 is negative

srcBegin

 is greater than

srcEnd

srcEnd

 is greater than the length of this String

dstBegin

 is negative

dstBegin+(srcEnd srcBegin)

 is larger than

dst.length

20.12.14

public void getBytes(int srcBegin, int srcEnd,

byte dst[], int dstBegin)

throws NullPointerException,

IndexOutOfBoundsException

Characters are copied from this

String

 object into the destination byte array

dst

.

Each byte receives only the eight low order bits of the corresponding character.

The eight high order bits of each character are not copied and do not participate in

the transfer in any way. 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 charac 

536