Класс 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 <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 Note:

Параметр 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 Note:

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

Возвращает:

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

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

API Note:

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

Параметры:

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

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

Исключения:

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

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 Note:

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

Возвращает:

векторное представление этой перестановки

public 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()

Overrides:

hashCode в классе Object

Возвращает:

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

См. также:

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

protected final Object getPayload()