Класс VectorMask<E>

public abstract VectorSpecies<E> vectorSpecies()

Возвращает векторную разновидность, к которой относится эта маска. Эта маска применяется к векторам той же разновидности и того же количества элементов.

public final int length()

Возвращает количество элементов маски. Эта маска применяется к векторам с тем же количеством элементов и той же разновидностью.

public static <E> VectorMask<E> fromValues(VectorSpecies<E> species, boolean... bits)

Возвращает маску, где каждый элемент устанавливается или сбрасывается в соответствии с заданными boolean значениями.

Для каждого элемента маски, где N - индекс элемента маски, если заданное boolean значение с индексом N равно true, то элемент маски с индексом N устанавливается, в противном случае он сбрасывается.

Заданная разновидность должна иметь количество элементов, совместимое с заданным массивом.

public static <E> VectorMask<E> fromArray(VectorSpecies<E> species, boolean[] bits, int offset)

Загружает маску из массива boolean начиная со смещения.

Для каждого элемента маски, где N - индекс элемента маски, если элемент массива с индексом offset + N равен true, то элемент маски с индексом N устанавливается, в противном случае он сбрасывается.

public static <E> VectorMask<E> fromLong(VectorSpecies<E> species, long bits)

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

Для каждого элемента маски, где N - индекс элемента маски, если выражение (bits>>min(63,N))&1 не равно нулю, то элемент маски с индексом N устанавливается, в противном случае он сбрасывается.

Если у заданной разновидности меньше 64 элементов, старшие 64-VLENGTH биты битовой маски игнорируются. Если у заданной разновидности более 64 элементов, бит знака дублируется в элементы с 64 и далее.

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

Преобразует эту маску в маску заданной разновидности с типом элемента F. species.length() должно быть равно длине маски. Различные биты элементов маски не изменяются.

Для каждого элемента маски, где N - индекс элемента, если элемент маски с индексом N установлен, то элемент маски с индексом N результирующей маски установлен, в противном случае этот элемент маски не установлен.

public abstract long toLong()

Возвращает элементы элементов этой маски, упакованные в значение long для не более чем первых 64 элементов.

Элементы элементов упаковываются в порядке от младшего к старшему биту. Для каждого элемента маски, где N - индекс элемента маски, если элемент маски установлен, то N-й бит устанавливается в единицу в результирующем значении long, в противном случае N-й бит устанавливается в ноль. Маска должна иметь не более 64 элементов.

public abstract boolean[] toArray()

Возвращает массив boolean содержащий элементы элементов этой маски.

Этот метод ведет себя так, как будто он сохраняет эту маску в выделенном массиве (используя intoArray(boolean[], int)) и возвращает этот массив следующим образом:

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

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

Сохраняет эту маску в массив boolean начиная со смещения.

Для каждого элемента маски, где N - индекс элемента маски, элемент элемента с индексом N сохраняется в элемент массива a[offset+N].

public abstract boolean anyTrue()

Возвращает true, если любой из элементов маски установлен.

public abstract boolean allTrue()

Возвращает true, если все элементы маски установлены.

public abstract int trueCount()

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

public abstract int firstTrue()

Возвращает индекс первого элемента маски, который установлен. Возвращает VLENGTH, если ни один из них не установлен.

public abstract int lastTrue()

Возвращает индекс последнего элемента маски, который установлен. Возвращает -1, если ни один из них не установлен.

public abstract VectorMask<E> and(VectorMask<E> m)

Вычисляет логическое пересечение (в виде a&b) между этой маской и второй входной маской.

Это бинарная операция по элементам, которая применяет логическую операцию AND (&) к каждой соответствующей паре битов маски.

public abstract VectorMask<E> or(VectorMask<E> m)

Вычисляет логическое объединение (в виде a|b) этой маски и второй входной маски.

Это бинарная операция по элементам, которая применяет логическую операцию OR (|) к каждой соответствующей паре битов маски.

public abstract VectorMask<E> eq(VectorMask<E> m)

Определяет логическое равенство этой маски со второй входной маской (как булево a==b или a^~b).

Это бинарная операция по элементам, проверяющая каждое соответствующее пару битов маски на равенство. Она также эквивалентна обратной XOR операции (^~) на битах маски.

public abstract VectorMask<E> andNot(VectorMask<E> m)

Логически вычитает вторую входную маску из этой маски (как a&~b).

Это бинарная операция на уровне регистров, которая применяет логическую операцию ANDC (&~) к каждой соответствующей паре битов маски.

public abstract VectorMask<E> not()

Логически инвертирует эту маску.

Это бинарная операция на уровне регистров, которая применяет логическую операцию NOT (~) к каждому биту маски.

public abstract VectorMask<E> indexInRange(int offset, int limit)

Удаляет регистры с номерами N из этой маски, где скорректированный индекс N+offset, не находится в диапазоне [0..limit-1].

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

public abstract Vector<E> toVector()

Возвращает векторное представление этой маски, биты регистров которой установлены или сброшены в соответствии с битами маски. Для каждого регистра маски, где N — индекс регистра маски, если регистр маски установлен в N, то конкретное значение по умолчанию -1 помещается в результирующий вектор с индексом регистра N. В противном случае значение элемента по умолчанию 0 помещается в результирующий вектор с индексом регистра N. Будь то тип элемента (ETYPE) этой маски — с плавающей точкой или целочисленный, значение регистра, выбранное маской, будет одним из двух арифметических значений 0 или -1. Для каждого ETYPE наиболее значимый бит регистра вектора установлен тогда и только тогда, когда регистр маски установлен. Кроме того, для целочисленных типов все биты регистра устанавливаются в регистрах, где маска установлена.

Возвращаемый вектор эквивалентен вектору, вычисленному по формуле ZERO.blend(MINUS_ONE, this), где ZERO и MINUS_ONE — векторы, которые дублируют значение по умолчанию ETYPE и значение ETYPE , представляющее -1, соответственно.

public abstract boolean laneIsSet(int i)

Проверяет, установлен ли регистр с индексом i

public abstract <F> VectorMask<F> check(Class<F> elementType)

Проверяет, что эта маска применяется к векторам с указанным типом элемента, и возвращает эту маску без изменений. Эффект аналогичен следующему псевдокоду: elementType == vectorSpecies().elementType() ? this : throw new ClassCastException().

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

Проверяет, что эта маска имеет заданный вид, и возвращает эту маску без изменений. Эффект аналогичен следующему псевдокоду: species == vectorSpecies() ? this : throw new ClassCastException().

public final String toString()

Возвращает строковое представление этой маски в формате "Mask[T.TT...]", отображая состояние битов маски (символами 'T' или '.') в порядке регистров.

public final boolean equals(Object obj)

Указывает, идентична ли эта маска какому-либо другому объекту. Две маски идентичны только в том случае, если они имеют одинаковый вид и одинаковые исходные индексы в том же порядке.

public final int hashCode()

Возвращает значение хеш-кода для маски, основанное на значениях битов маски и виде вектора.