|
Java Debug Interface | ||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
public interface ArrayReference
ターゲット VM 内の配列オブジェクト要素へのアクセスを提供します。各配列要素は Value
オブジェクトによりミラー化されます。配列要素は、API のその他の部分との一貫性およびほかの API との相互運用性のために、配列ではなく List
オブジェクト内に全体として置かれます。
フィールドの概要 |
---|
インタフェース com.sun.jdi.ObjectReference から継承されたフィールド |
---|
INVOKE_NONVIRTUAL, INVOKE_SINGLE_THREADED |
メソッドの概要 | |
---|---|
Value |
getValue(int index)
配列要素の値を返します。 |
List<Value> |
getValues()
この配列内のすべての要素を返します。 |
List<Value> |
getValues(int index,
int length)
配列コンポーネントの範囲を返します。 |
int |
length()
この配列の要素の数を返します。 |
void |
setValue(int index,
Value value)
配列要素を別の値に置き換えます。 |
void |
setValues(int index,
List<? extends Value> values,
int srcIndex,
int length)
配列要素のある範囲を別の値に置き換えます。 |
void |
setValues(List<? extends Value> values)
すべての配列要素を別の値に置き換えます。 |
インタフェース com.sun.jdi.ObjectReference から継承されたメソッド |
---|
disableCollection, enableCollection, entryCount, equals, getValue, getValues, hashCode, invokeMethod, isCollected, owningThread, referenceType, setValue, uniqueID, waitingThreads |
インタフェース com.sun.jdi.Value から継承されたメソッド |
---|
type |
インタフェース com.sun.jdi.Mirror から継承されたメソッド |
---|
toString, virtualMachine |
メソッドの詳細 |
---|
int length()
Value getValue(int index)
index
- 取得する要素のインデックス
Value
IndexOutOfBoundsException
- index
がこの配列の範囲外である場合、つまり次のどちらかが true である場合
index < 0
index >= length()
List<Value> getValues()
Value
オブジェクトのリスト。長さがゼロの配列の場合、空のリストが返されるList<Value> getValues(int index, int length)
index
- 取得する最初の要素のインデックスlength
- 取得する要素の数。配列の最後までのすべての要素を取得する場合は -1
Value
オブジェクトのリスト。指定された範囲に要素が存在しない場合 (length
がゼロの場合など)、空のリストが返される
IndexOutOfBoundsException
- index
と length
で指定された範囲が配列の範囲内に収まっていない場合、つまり、次のどちらかが true である場合
index < 0
index > length()
length != -1
でかつ次のどちらかが true の場合
length < 0
index + length > length()
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.canBeModified()
を参照ArrayType.componentType()
void setValues(List<? extends Value> values) throws InvalidTypeException, ClassNotLoadedException
オブジェクト値は、この配列要素の型への代入互換性を持たなければなりません (これは、この要素型は、囲むクラスのクラスローダによってロードする必要があることを意味する)。プリミティブ値は、この要素型への代入互換性を持たなければなりません。つまり、情報を失わずにこの要素型に変換できる必要があります。代入互換性の詳細は、JLS のセクション 5.2 を参照してください。
values
- この配列に格納する Value
オブジェクトのリスト。values.size()
が配列の長さよりも大きかった場合、先頭からvalues.size()
個の要素が設定される
InvalidTypeException
- 新しい values
のどれかが、宣言されている配列要素型への代入互換性を持たない場合
ClassNotLoadedException
- 配列要素型が、適切なクラスローダによってロードされていない場合
VMCannotBeModifiedException
- 仮想マシンが読み取り専用の場合は、VirtualMachine.canBeModified()
を参照ArrayType.componentType()
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.canBeModified()
を参照
ClassNotLoadedException
ArrayType.componentType()
|
Java Debug Interface | ||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |