THE PACKAGE JAVA.LANG

java.lang.String

20.12

ters to be copied is

srcEnd srcBegin

). The characters, converted to bytes, 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.15

public char[] toCharArray()

A new character array is created and returned. The length of the array is equal to

the length ( 20.12.11) of this

String

 object. The array is initialized to contain the

character sequence represented by this

String

 object.

20.12.16

public boolean equalsIgnoreCase(String anotherString)

The result is

true

 if and only if the argument is not

null

 and is a

String

 object

that represents the same sequence of characters as this

String

 object, where case

is ignored.

Two characters are considered the same, ignoring case, if at least one of the

following is true:

The two characters are the same (as compared by the

==

 operator).

Applying the method

Character.toUppercase

 ( 20.5.21) to each character

produces the same result.

Applying the method

Character.toLowercase

 ( 20.5.20) to each character

produces the same result.

Two sequences of characters are the same, ignoring case, if the sequences

have the same length and corresponding characters are the same, ignoring case.

See also the method

equals

 ( 20.12.9).

537