Module jdk.incubator.vector

Package jdk.incubator.vector

Enum Class VectorShape

java.lang.Object

java.lang.Enum<VectorShape>

jdk.incubator.vector.VectorShape

所有已实现的接口:

Serializable, Comparable<VectorShape>, Constable

       public enum VectorShape extends Enum<VectorShape>
      

VectorShape 选择了Vector的特定实现。形状与元素类型结合确定了特定的向量种类对象。

API 注意:

因为并非所有平台都支持所有形状，所以无形状代码更具可移植性。选择特定形状的用户代码可能无法在某些平台上运行，或者运行缓慢。使用VectorShape.preferredShape()和VectorSpecies.ofPreferred()来选择通常对大多数用途更可取的形状。

Nested Class Summary

Nested classes/interfaces declared in class java.lang.Enum

Enum.EnumDesc<E extends Enum<E>>

Enum Constant Summary

Enum Constants

Enum Constant	Description
S_128_BIT	长度为128位的形状
S_256_BIT	长度为256位的形状
S_512_BIT	长度为512位的形状
S_64_BIT	长度为64位的形状
S_Max_BIT	平台支持的最大长度形状

Method Summary

Modifier and Type	Method	Description
static VectorShape	forBitSize(int bitSize)	根据向量的建议位大小找到合适的形状。
static VectorShape	forIndexBitSize(int indexBitSize, int elementSize)	根据向量的建议索引位大小和元素大小找到合适的索引形状。
static VectorShape	preferredShape()	找到当前平台对所有向量元素类型首选的向量形状。
static VectorShape	valueOf(String name)	返回具有指定名称的此类的枚举常量。
static VectorShape[]	values()	返回包含此枚举类的常量的数组，按它们声明的顺序排列。
int	vectorBitSize()	返回此形状的向量大小（以位为单位）。
<E> VectorSpecies<E>	withLanes(Class<E> elementType)	找到具有给定元素类型和当前形状的向量种类。

Methods declared in class java.lang.Enum

clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods declared in class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Details

S_64_BIT

             public static final VectorShape S_64_BIT
            

长度为64位的形状

S_128_BIT

             public static final VectorShape S_128_BIT
            

长度为128位的形状

S_256_BIT

             public static final VectorShape S_256_BIT
            

长度为256位的形状

S_512_BIT

             public static final VectorShape S_512_BIT
            

长度为512位的形状

S_Max_BIT

             public static final VectorShape S_Max_BIT
            

平台支持的最大长度形状

Method Details

values

             public static VectorShape[] values()
            

返回包含此枚举类的常量的数组，按它们声明的顺序排列。

返回:

包含此枚举类的常量的数组，按它们声明的顺序排列

valueOf

             public static VectorShape valueOf(String name)
            

返回具有指定名称的此类的枚举常量。字符串必须与此类中用于声明枚举常量的标识符完全匹配。（不允许存在多余的空白字符。）

参数:

name - 要返回的枚举常量的名称。

返回:

具有指定名称的枚举常量

抛出:

IllegalArgumentException - 如果此枚举类没有具有指定名称的常量

NullPointerException - 如果参数为null

vectorBitSize

             public int vectorBitSize()
            

返回此形状的向量大小（以位为单位）。

返回:

此形状的向量大小（以位为单位）。

withLanes

             public <E> VectorSpecies<E> withLanes(Class<E> elementType)
            

找到具有给定元素类型和当前形状的向量种类。返回与VectorSpecies.of(elementType, this)相同的值。

类型参数:

E - 装箱的元素类型

参数:

elementType - 所需的元素类型

返回:

给定元素类型和此形状的种类

参见:

• VectorSpecies.of(Class, VectorShape)

forBitSize

             public static VectorShape forBitSize(int bitSize)
            

根据向量的建议位大小找到合适的形状。

参数:

bitSize - 向量大小的建议位大小

返回:

与向量位大小对应的形状

抛出:

IllegalArgumentException - 如果不存在这样的向量形状

参见:

• vectorBitSize()

forIndexBitSize

             public static VectorShape forIndexBitSize(int indexBitSize, int elementSize)
            

根据向量的建议索引位大小和元素大小找到合适的索引形状。

参数:

indexBitSize - 建议的索引向量大小（以位为单位）

elementSize - 建议的元素大小（以位为单位）

返回:

与索引向量位大小和元素大小对应的形状。

抛出:

IllegalArgumentException - 如果不存在这样的向量形状

参见:

• vectorBitSize()

preferredShape

             public static VectorShape preferredShape()
            

找到当前平台对所有向量元素类型首选的向量形状。

平台首选的形状具有最大可能的位大小，受到所有支持的通道大小的约束，从byte到double。因此，各种通道类型的所有首选向量种类将具有共同的基础形状。

返回:

所有元素类型的首选形状

抛出:

UnsupportedOperationException - 如果不存在这样的形状

参见:

• VectorSpecies.ofPreferred(Class)