モジュール jdk.jdi
パッケージ com.sun.jdi

インタフェースArrayReference

  • すべてのスーパー・インタフェース:
    Mirror, ObjectReference, Value
    public interface ArrayReference
extends ObjectReference
    ターゲットVM内の配列オブジェクトおよびそのコンポーネントへのアクセスを提供します。 各配列コンポーネントは、Valueオブジェクトによってミラー化されます。 配列コンポーネントは、APIのその他の部分との一貫性と、その他のAPIとの相互運用性を確保するために、配列ではなくListオブジェクト内に全体として置かれます。
    導入されたバージョン:
    1.3

    • メソッドの詳細

      • length

        int length()
        この配列のコンポーネントの数を返します。
        戻り値:
        この配列内のコンポーネントの数の整数値。

      • getValue

        Value getValue​(int index)
        配列コンポーネントの値を返します。
        パラメータ:
        index - 取得するコンポーネントのインデックス
        戻り値:
        指定されたインデックス位置のValue。
        例外:
        IndexOutOfBoundsException - indexがこの配列の範囲外である場合、つまり次のどちらかがtrueである場合: 
            index < 0
    index >= length()

      • getValues

        List<Value> getValues()
        この配列内のすべてのコンポーネントを返します。
        戻り値:
        Valueオブジェクトのリスト。配列索引により指定された各配列コンポーネントに1つ。 長さがゼロの配列の場合、空のリストが返される。

      • getValues

        List<Value> getValues​(int index,
                      int length)
        配列コンポーネントの範囲を返します。
        パラメータ:
        index - 取得する最初のコンポーネントのインデックス
        length - 取得するコンポーネントの数。配列の最後までのすべてのコンポーネントを取得する場合は -1。
        戻り値:
        Valueオブジェクトのリスト。配列索引により指定された、要求された各配列コンポーネントに1つ。 指定された範囲に要素が存在しない場合(lengthがゼロの場合など)、空のリストが返される
        例外:
        IndexOutOfBoundsException - indexとlengthで指定された範囲が配列の範囲内に収まっていない場合、つまり次のどちらかがtrueである場合 
            index < 0
    index > length()
        または、length != -1で、次のどちらかがtrueの場合 
            length < 0
    index + length >  length()

      • setValue

        void setValue​(int index,
              Value value)
       throws InvalidTypeException,
              ClassNotLoadedException
        配列コンポーネントを別の値に置き換えます。

        オブジェクト値は、このコンポーネントの型との代入互換性を持たなければいけません(これは、このコンポーネントの型は、宣言クラスのクラス・ローダーによってロードする必要があることを意味する)。 プリミティブ値は、このコンポーネントの型との代入互換性を持たなければいけません。つまり、情報を失わずにこのコンポーネントの型に変換できる必要があります。 代入互換性の詳細は、JLSのセクション5.2を参照してください。

        パラメータ:
        value - 新しい値
        index - 設定するコンポーネントのインデックス
        例外:
        IndexOutOfBoundsException - indexがこの配列の範囲外である場合、つまり次のどちらかがtrueである場合: 
            index < 0
    index >= length()
        InvalidTypeException - valueの型と宣言された配列コンポーネントの型に互換性がない場合。
        ClassNotLoadedException - 配列コンポーネントの型が適切なクラス・ローダーによってロードされていない場合。
        VMCannotBeModifiedException - VirtualMachineが読取り専用の場合(VirtualMachine.canBeModified()を参照)。
        関連項目:
        ArrayType.componentType()

      • setValues

        void setValues​(List<? extends Value> values)
        throws InvalidTypeException,
               ClassNotLoadedException
        すべての配列コンポーネントを別の値に置き換えます。 与えられたリストのサイズが配列よりも大きい場合は、リストの後ろの値は無視されます。

        オブジェクト値は、この要素の型との代入互換性を持たなければいけません(これは、この要素型は、囲むクラスのクラス・ローダーによってロードする必要があることを意味する)。 プリミティブ値は、このコンポーネントの型との代入互換性を持たなければいけません。つまり、情報を失わずにこのコンポーネントの型に変換できる必要があります。 代入互換性の詳細は、JLSのセクション5.2を参照してください。

        パラメータ:
        values - この配列内に配置されるValueオブジェクトのリスト。 values.size()の値が配列の長さよりも大きかった場合、先頭からvalues.size()個の要素が設定される。
        例外:
        InvalidTypeException - 新しいvaluesのどれかが、宣言された配列コンポーネントの型との互換性を持たない場合。
        ClassNotLoadedException - 配列コンポーネントの型が適切なクラス・ローダーによってロードされていない場合。
        VMCannotBeModifiedException - VirtualMachineが読取り専用の場合(VirtualMachine.canBeModified()を参照)。
        関連項目:
        ArrayType.componentType()

      • setValues

        void setValues​(int index,
               List<? extends Value> values,
               int srcIndex,
               int length)
        throws InvalidTypeException,
               ClassNotLoadedException
        配列コンポーネントのある範囲を別の値に置き換えます。

        オブジェクト値は、このコンポーネントの型への代入互換性を持たなければいけません(これは、この要素型は、囲むクラスのクラス・ローダーによってロードする必要があることを意味する)。 プリミティブ値は、このコンポーネントの型との代入互換性を持たなければいけません。つまり、情報を失わずにこのコンポーネントの型に変換できる必要があります。 代入互換性の詳細は、JLSのセクション5.2を参照してください。

        パラメータ:
        index - 設定する最初のコンポーネントのインデックス。
        values - この配列内に配置されるValueオブジェクトのリスト。
        srcIndex - 使用する最初のソース値のインデックス。
        length - 設定するコンポーネントの数。この配列またはvaluesの最後までのコンポーネントを設定する場合は -1。
        例外:
        InvalidTypeException - valuesのどれかが、宣言された配列コンポーネントの型との互換性を持たない場合。
        IndexOutOfBoundsException - indexとlengthで指定された配列範囲が配列のサイズに収まっていない場合、あるいはsrcIndexとlengthで指定されるソース範囲がvaluesのサイズに収まっていない場合、つまり次のいずれかがtrueである場合 
            index < 0
    index > length()
    srcIndex < 0
    srcIndex > values.size()
        または、length != -1で、次のいずれかがtrueである場合 
            length < 0
    index + length > length()
    srcIndex + length > values.size()
        VMCannotBeModifiedException - VirtualMachineが読取り専用の場合(VirtualMachine.canBeModified()を参照)。
        ClassNotLoadedException
        関連項目:
        ArrayType.componentType()