Класс 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()