THE PACKAGE JAVA.LANG

java.lang.System

20.18

The

src

 argument refers to an array of reference component type and the

dst

argument refers to an array of primitive component type.

Otherwise, if any of the following is true, an

IndexOutOfBoundsException

is thrown and the destination is not modified:

The

srcOffset

 argument is negative.

The

dstOffset

 argument is negative.

The

length

 argument is negative.

srcOffset+length

 is greater than

src.length

, the length of the

src

 array.

dstOffset+length

 is greater than

dst.length

, the length of the

dst

 array.

Otherwise, if the actual value of any component of the source array from posi 

tion

srcOffset

 through

srcOffset+length 1

 cannot be converted to the com 

ponent type of the destination array by assignment conversion, then an

ArrayStoreException

 is thrown. In this case, let

k

 be the smallest nonnegative

integer less than length such that

src[srcOffset+k]

 cannot be converted to the

component type of the destination array. When the exception is thrown, the source

array components from positions

srcOffset

 through

srcOffset+k 1

 have been

copied to destination array positions

dstOffset

 through

dstOffset+k 1

 and no

other positions of the destination array will have been modified. (Because of the

restrictions already itemized, this paragraph effectively applies only to the situa 

tion where both arrays have component types that are reference types.)

585