Name: elR10090 Date: 04/19/2001



The following is the JDI specification for the method
com.sun.jdi.ArrayReference.setValues(List):

    public void setValues(java.util.List values) throws InvalidTypeException,
                                                        ClassNotLoadedException
    Replaces all array components with other values. If the given list is
    larger is size than the array, the values at the end of the list are
    ignored.
    
    Object values must be assignment compatible with the element type (This
    implies that the component type must be loaded through the enclosing
    class's class loader). Primitive values must be either assignment
    compatible with the component type or must be convertible to the component
    type without loss of information. See JLS section 5.2 for more information
    on assignment compatibility.
    
    Parameters: values - a list of Value objects to be placed in this array
    Throws: InvalidTypeException - if any of the values is not compatible with
                the declared type of array components.
            java.lang.IndexOutOfBoundsException - if the size of values is
                larger than the length of this array.
            ClassNotLoadedException - if the array component type has not yet
                been loaded through the appropriate class loader.
            ObjectCollectedException - if this object or any of the new values
                has been garbage collected.
            VMMismatchException - if a Mirror argument and this object do not
                belong to the sameVirtualMachine.
                
The spec is the same for Kestrel and Merlin.

The second sentence
    "If the given list is larger is size than the array, the values at the end
     of the list are ignored."
says that all values at the end of the list are ignored, if the list is larger
than the array. But the sentence from the last paragraph
    "Throws: java.lang.IndexOutOfBoundsException - if the size of values is
     larger than the length of this array."
claims that IndexOutOfBoundsException is thrown, if the list is larger than
the array.

The current java HotSpot VM (build 1.4.0-beta-b60, build 1.3.1-rc1-b21)
implement the first assertion, that "the values at the end of the list
are ignored, if the given list is larger is size than the array."

======================================================================