Interface IJavaArray

    • Method Detail

      • getValues

        IJavaValue[] getValues()
                        throws DebugException
        Returns the values contained in this array.
        Returns:
        the values contained in this array
        Throws:
        DebugException - if this method fails. Reasons include:
        • Failure communicating with the VM. The DebugException's status code contains the underlying exception responsible for the failure.
      • getValue

        IJavaValue getValue​(int index)
                     throws DebugException
        Returns the value at the given index in this array.
        Parameters:
        index - the index of the value to return
        Returns:
        the value at the given index
        Throws:
        DebugException - if this method fails. Reasons include:
        • Failure communicating with the VM. The DebugException's status code contains the underlying exception responsible for the failure.
        IndexOutOfBoundsException - if the index is not within the bounds of this array.
      • getLength

        int getLength()
               throws DebugException
        Returns the length of this array.
        Returns:
        the length of this array
        Throws:
        DebugException - if this method fails. Reasons include:
        • Failure communicating with the VM. The DebugException's status code contains the underlying exception responsible for the failure.
      • setValue

        void setValue​(int index,
                      IJavaValue value)
               throws DebugException
        Sets the value at the given index to the specified value.
        Parameters:
        index - the index at which to assign a new value
        value - the new value
        Throws:
        DebugException - if this method fails. Reasons include:
        • Failure communicating with the VM. The DebugException's status code contains the underlying exception responsible for the failure.
        • The given value is not compatible with the type of this array
        IndexOutOfBoundsException - if the index is not within the bounds of this array.
      • setValues

        void setValues​(IJavaValue[] values)
                throws DebugException
        Replaces values in this array. If the given replacement values length is less that the length of this array, only the number of values in the given array are replaced. If the given replacement values length is longer than the length of this array, values in positions greater than the length of this array are ignored.
        Parameters:
        values - replacement values
        Throws:
        DebugException - if an exception occurs replacing values
        Since:
        3.4
      • setValues

        void setValues​(int offset,
                       int length,
                       IJavaValue[] values,
                       int startOffset)
                throws DebugException
        Replaces a range of values in this array.
        Parameters:
        offset - offset in this array to start replacing values at
        length - the number of values to replace in this array
        values - replacement values
        startOffset - the first offset where values are copied from the given replacement values
        Throws:
        DebugException - if an exception occurs replacing values or if the given offsets and length are not within the range of this array or the replacement values
        Since:
        3.4