Класс VectorShuffle<E>

public abstract VectorSpecies<E> vectorSpecies()

Возвращает:

вид этого перемешивания

public final int length()

Возвращает:

количество полос перемешивания

public abstract <F> VectorShuffle<F> cast(VectorSpecies<F> species)

Параметры типа:

F — упакованный тип элемента вида

Параметры:

species — вид требуемого перемешивания

Возвращает:

перемешивание, преобразованное по форме и типу элемента

Вызывает исключение:

IllegalArgumentException — если длина этого перемешивания и длина вида различаются

public abstract <F> VectorShuffle<F> check(VectorSpecies<F> species)

Параметры типа:

F — упакованный тип элемента требуемого вида

Параметры:

species — требуемый вид

Возвращает:

то же перемешивание

Вызывает исключение:

ClassCastException — если вид перемешивания неверен

См. также:

• Vector.check(Class)
• Vector.check(VectorSpecies)

public abstract int checkIndex(int index)

Параметры:

index — индекс полосы

Возвращает:

index

Вызывает исключение:

IndexOutOfBoundsException — если index не меньше VLENGTH или является отрицательным

См. также:

• wrapIndex(int)
• checkIndexes()

public abstract int wrapIndex(int index)

Параметры:

index — индекс полосы

Возвращает:

index, приведенный к диапазону [0..VLENGTH-1} с помощью соответствующего кратного VLENGTH

См. также:

• VectorSpecies.loopBound(int)
• checkIndex(int)
• wrapIndexes()

public abstract VectorShuffle<E> checkIndexes()

Возвращает:

текущее перемешивание без изменений

Вызывает исключение:

IndexOutOfBoundsException — если некоторые полосы этого перемешивания содержат исключительные индексы

См. также:

• checkIndex(int)
• wrapIndexes()

public abstract VectorShuffle<E> wrapIndexes()

Возвращает:

текущее перемешивание, в котором все исключительные индексы приведены

См. также:

• wrapIndex(int)
• checkIndexes()

public abstract VectorMask<E> laneIsValid()

Возвращает:

маска полос, содержащих допустимые индексы источников

См. также:

• checkIndexes()

public static <E> VectorShuffle<E> fromValues(VectorSpecies<E> species, int... sourceIndexes)

Параметры типа:

E — упакованный тип элемента

Параметры:

species — вид перемешивания

sourceIndexes — индексы источников, из которых будет выбирать перемешивание

Возвращает:

перемешивание, в котором индекс источника каждой полосы установлен в заданное значение int и частично приведен, если оно является исключительным

Вызывает исключение:

IndexOutOfBoundsException — если sourceIndexes.length != VLENGTH

См. также:

• VectorSpecies.shuffleFromValues(int...)

public static <E> VectorShuffle<E> fromArray(VectorSpecies<E> species, int[] sourceIndexes, int offset)

Параметры типа:

E — упакованный тип элемента

Параметры:

species — вид перемешивания

sourceIndexes — индексы источников, из которых будет выбирать перемешивание

offset — смещение в массиве

Возвращает:

перемешивание, в котором индекс источника каждой полосы установлен в заданное значение int и частично приведен, если оно является исключительным

Вызывает исключение:

IndexOutOfBoundsException — если offset < 0 или offset > sourceIndexes.length - VLENGTH

См. также:

• VectorSpecies.shuffleFromArray(int[], int)

public static final <E> VectorShuffle<E> fromMemorySegment(VectorSpecies<E> species, MemorySegment ms, long offset, ByteOrder bo)

var slice = ms.asSlice(offset);
int[] ar = new int[species.length()];
for (int n = 0; n < ar.length; n++) {
    ar[n] = slice.getAtIndex(ValuaLayout.JAVA_INT_UNALIGNED, n);
}
VectorShuffle<E> r = VectorShuffle.fromArray(species, ar, 0);

Примечание по реализации:

Эта операция, вероятно, будет эффективнее, если заданный порядок байтов совпадает с собственным порядком байтов платформы, поскольку этому методу не потребуется менять порядок байтов значений полос.

Параметры типа:

E — упакованный тип элемента

Параметры:

species — вид перемешивания

ms — индексы источников в памяти, из которых будет выбирать перемешивание

offset — смещение в сегменте

bo — порядок байтов

Возвращает:

перемешивание, в котором индекс источника каждой полосы установлен в заданное значение int и частично приведен, если оно является исключительным

Вызывает исключение:

IndexOutOfBoundsException — если offset < 0 или offset > sourceIndexes.byteSize() - VLENGTH * 4

Начиная с версии:

25

public static <E> VectorShuffle<E> fromOp(VectorSpecies<E> species, IntUnaryOperator fn)

  int[] a = new int[species.length()];
  for (int i = 0; i < a.length; i++) {
      a[i] = fn.applyAsInt(i);
  }
  return VectorShuffle.fromArray(a, 0);

Параметры типа:

E — упакованный тип элемента

Параметры:

species — вид перемешивания

fn — функция отображения индексов полос

Возвращает:

перемешивание отображенных индексов

См. также:

• VectorSpecies.shuffleFromOp(IntUnaryOperator)

public static <E> VectorShuffle<E> iota(VectorSpecies<E> species, int start, int step, boolean wrap)

Примечание API:

Параметру wrap следует присвоить значение true, если недопустимые индексы источников нужно привести к допустимым. В противном случае значение false позволяет последующим операциям, например unary rearrange, проверять недопустимые индексы источников на соответствие диапазону.

Параметры типа:

E — упакованный тип элемента

Параметры:

species — вид перемешивания

start — начальное значение последовательности индексов источников

step — разность между соседними индексами источников

wrap — следует ли приводить полученные индексы

Возвращает:

перемешивание последовательных индексов полос, возможно, приведенных

См. также:

• VectorSpecies.iotaShuffle(int,int,boolean)

public static <E> VectorShuffle<E> makeZip(VectorSpecies<E> species, int part)

Параметры типа:

E — упакованный тип элемента

Параметры:

species — вид перемешивания

part — номер части результата (ноль или один)

Возвращает:

перемешивание, объединяющее два вектора в 2*VLENGTH полос, с возвратом выбранной части

Вызывает исключение:

ArrayIndexOutOfBoundsException — если part не равно нулю или единице

См. также:

• makeUnzip(VectorSpecies, int)
• Vector.rearrange(VectorShuffle,Vector)

public static <E> VectorShuffle<E> makeUnzip(VectorSpecies<E> species, int part)

Параметры типа:

E — упакованный тип элемента

Параметры:

species — вид перемешивания

part — номер части результата (ноль или один)

Возвращает:

перемешивание, разделяющее 2*VLENGTH полос на два вектора, с возвратом выбранной части

Вызывает исключение:

ArrayIndexOutOfBoundsException — если part не равно нулю или единице

См. также:

• makeZip(VectorSpecies,int)
• Vector.rearrange(VectorShuffle,Vector)

public abstract int[] toArray()

  int[] a = new int[this.length()];
  VectorShuffle.intoArray(a, 0);
  return a;

Примечание API:

Индексы источников перемешивания всегда находятся в диапазоне от -VLENGTH до VLENGTH-1. Индекс источника является исключительным тогда и только тогда, когда он отрицателен.

Возвращает:

массив, содержащий индексы источников полос этого перемешивания

public abstract void intoArray(int[] a, int offset)

Примечание API:

Индексы источников перемешивания всегда находятся в диапазоне от -VLENGTH до VLENGTH-1.

Параметры:

a — массив типа int[]

offset — смещение в массиве

Вызывает исключение:

IndexOutOfBoundsException — если offset < 0 или offset > a.length - this.length()

public abstract void intoMemorySegment(MemorySegment ms, long offset, ByteOrder bo)

int[] a = this.toArray();
var slice = ms.asSlice(offset)
for (int n = 0; n < a.length; n++) {
    slice.setAtIndex(ValueLayout.JAVA_INT_UNALIGNED, n, a[n]);
}

Примечание API:

Индексы источников перемешивания всегда находятся в диапазоне от -VLENGTH до VLENGTH-1.

Примечание по реализации:

Эта операция, вероятно, будет эффективнее, если заданный порядок байтов совпадает с собственным порядком байтов платформы, поскольку этому методу не потребуется менять порядок байтов значений полос.

Параметры:

ms — сегмент памяти

offset — смещение в сегменте

bo — порядок байтов

Вызывает исключение:

IndexOutOfBoundsException — если offset < 0 или offset > a.byteSize() - this.length() * 4

IllegalArgumentException — если сегмент ms доступен только для чтения

Начиная с версии:

25

public abstract Vector<E> toVector()

  int[] sa = this.toArray();
  $type$[] va = new $type$[a.length];
  for (int i = 0; i < a.length; i++) {
      va[i] = ($type$) sa[i];
  }
  return IntVector.fromArray(va, 0);

Примечание API:

Индексы источников перемешивания всегда находятся в диапазоне от -VLENGTH до VLENGTH-1. Эти значения преобразуются в ETYPE результирующего вектора, даже если он имеет тип с плавающей точкой.

Возвращает:

представление этого перемешивания в виде вектора

public abstract int laneSource(int i)

Параметры:

i — индекс полосы

Возвращает:

элемент полосы int с индексом полосы i

public abstract VectorShuffle<E> rearrange(VectorShuffle<E> s)

Параметры:

s — перемешивание, задающее выбор индексов полос

Возвращает:

перестановку элементов полос этого перемешивания

public final String toString()

Переопределяет:

toString в классе Object

Возвращает:

строку в форме "Shuffle[0,1,2...]"

public final boolean equals(Object obj)

Переопределяет:

equals в классе Object

Параметры:

obj — эталонный объект для сравнения.

Возвращает:

указывает, идентичен ли этот вектор какому-либо другому объекту

См. также:

• Object.hashCode()
• HashMap

public final int hashCode()

Переопределяет:

hashCode в классе Object

Возвращает:

хеш-код этого перемешивания

См. также:

• Object.equals(java.lang.Object)
• System.identityHashCode(Object)

protected final Object getPayload()