Интерфейс ArrayReference

Все суперинтерфейсы:: Mirror, ObjectReference, Value

public interface ArrayReference extends ObjectReference

Предоставляет доступ к объекту массива и его компонентам в целевой виртуальной машине. Каждый компонент массива отражается объектом Value. Компоненты массива в совокупности размещаются в объектах List, а не в массивах для обеспечения согласованности с остальной частью API и для межсовместимости с другими API.

С:: 1.3

Краткое описание полей

Поля, объявленные в интерфейсе 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.Mirror

toString, virtualMachine

Методы, объявленные в интерфейсе com.sun.jdi.ObjectReference

disableCollection, enableCollection, entryCount, equals, getValue, getValues, hashCode, invokeMethod, isCollected, owningThread, referenceType, referringObjects, setValue, uniqueID, waitingThreads

Методы, объявленные в интерфейсе com.sun.jdi.Value

type

Подробное описание методов

length

int length()

Возвращает количество компонентов в этом массиве.

Возвращает:: целое количество компонентов в этом массиве.

getValue

Value getValue(int index)

Возвращает значение компонента массива.

Параметры:

index - индекс компонента для извлечения

Возвращает:

объект Value по указанному индексу.

Использует:

IndexOutOfBoundsException - если index выходит за пределы диапазона этого массива, то есть, если выполняется одно из следующих условий:

    index < 0
    index >= length()

getValues

List<Value> getValues()

Возвращает все компоненты в этом массиве.

Возвращает:: список объектов Value, по одному для каждого компонента массива, упорядоченного по индексу массива. Для массивов нулевой длины возвращается пустой список.

getValues

List<Value> getValues(int index, int length)

Возвращает диапазон компонентов массива.

Параметры:

index - индекс первого компонента для извлечения

length - количество компонентов для извлечения, или -1 для извлечения всех компонентов до конца этого массива.

Возвращает:

список объектов Value, по одному для каждого запрошенного компонента массива, упорядоченного по индексу массива. При отсутствии элементов в заданном диапазоне (например, length равно нулю) возвращается пустой список

Использует:

IndexOutOfBoundsException - если заданный диапазон с index и length не находится в пределах массива, то есть, если выполняется одно из следующих условий:

    index < 0
    index > length()

или если length != -1 и выполняется одно из следующих условий:

    length < 0
    index + length >  length()

setValue

void setValue(int index, Value value) throws InvalidTypeException, ClassNotLoadedException

Заменяет компонент массива другим значением.

Значения объектов должны быть совместимы с типом компонента (это подразумевает, что тип компонента должен быть загружен через загрузчик классов объявляющего класса). Примитивные значения должны быть либо совместимы с типом компонента, либо должны быть преобразуемы в тип компонента без потери информации. См. раздел 5.2 JLS для получения дополнительной информации о совместимости присваивания.

Параметры:

index - индекс компонента для задания

value - новое значение

Использует:

    index < 0
    index >= length()

InvalidTypeException - если тип value несовместим с объявленным типом компонентов массива.

ClassNotLoadedException - если тип компонента массива еще не загружен через соответствующий загрузчик классов.

VMCannotBeModifiedException - если VirtualMachine только для чтения - см. VirtualMachine.canBeModified().

См. также:

setValues

void setValues(List<? extends Value> values) throws InvalidTypeException, ClassNotLoadedException

Заменяет все компоненты массива другими значениями. Если заданный список больше по размеру, чем массив, значения в конце списка игнорируются.

Значения объектов должны быть совместимы с типом элемента (это подразумевает, что тип компонента должен быть загружен через загрузчик классов содержащего класса). Примитивные значения должны быть либо совместимы с типом компонента, либо должны быть преобразуемы в тип компонента без потери информации. См. раздел 5.2 JLS для получения дополнительной информации о совместимости присваивания.

Параметры:

values - список объектов Value, которые должны быть помещены в этот массив. Если values.size() меньше длины массива, первые values.size() элементов задаются.

Использует:

InvalidTypeException - если любое из новых values несовместимо с объявленным типом компонентов массива.

ClassNotLoadedException - если тип компонента массива еще не загружен через соответствующий загрузчик классов.

VMCannotBeModifiedException - если VirtualMachine только для чтения - см. VirtualMachine.canBeModified().

См. также:

setValues

void setValues(int index, List<? extends Value> values, int srcIndex, int length) throws InvalidTypeException, ClassNotLoadedException

Заменяет диапазон компонентов массива другими значениями.

Значения объектов должны быть совместимы с типом компонента (это подразумевает, что тип компонента должен быть загружен через загрузчик классов содержащего класса). Примитивные значения должны быть либо совместимы с типом компонента, либо должны быть преобразуемы в тип компонента без потери информации. См. раздел 5.2 JLS для получения дополнительной информации о совместимости присваивания.

Параметры:

index - индекс первого компонента для задания.

values - список объектов Value, которые должны быть помещены в этот массив.

srcIndex - индекс первого значения источника для использования.

length - количество компонентов для задания, или -1 для задания всех компонентов до конца этого массива или до конца values (в зависимости от того, что произойдет раньше).

Использует:

InvalidTypeException - если какой-либо элемент из values несовместим с объявленным типом компонентов массива.

IndexOutOfBoundsException - если диапазон массива, указанный с index и length, не находится в пределах массива, или если диапазон источника, указанный с srcIndex и length, не находится в пределах values, то есть, если любое из следующих условий истинно:

    index < 0
    index > length()
    srcIndex < 0
    srcIndex > values.size()

или если length != -1 и любое из следующих условий истинно:

    length < 0
    index + length > length()
    srcIndex + length > values.size()

VMCannotBeModifiedException - если VirtualMachine только для чтения - см. VirtualMachine.canBeModified().

ClassNotLoadedException

См. также:

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/jdk.jdi/com/sun/jdi/ArrayReference.html