モジュール jdk.incubator.vector

パッケージ jdk.incubator.vector

列挙型クラス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()を使用して、通常はほとんどの用途に適したシェイプを選択します。

ネストされたクラスのサマリー

クラスjava.lang.Enumで宣言されたネストされたクラス/インタフェース

Enum.EnumDesc<E extends Enum<E>>

列挙型定数のサマリー

列挙型定数

列挙型定数	説明
S_128_BIT	長さ128ビットのシェイプ
S_256_BIT	長さ256ビットのシェイプ
S_512_BIT	長さ512ビットのシェイプ
S_64_BIT	長さ64ビットのシェイプ
S_Max_BIT	プラットフォームでサポートされる最大長のシェイプ

メソッドのサマリー

修飾子と型	メソッド	説明
static VectorShape	forBitSize(int bitSize)	ベクトルの提示ビット・サイズに応じて適切なシェイプを求めます。
static VectorShape	forIndexBitSize(int indexBitSize, int elementSize)	ベクトルの提示されたインデックス・ビット・サイズと要素サイズに応じて、適切なインデックス・シェイプを見つけます。
static VectorShape	preferredShape()	すべてのベクトル要素型について、現在のプラットフォームが優先するベクトル・シェイプを検索します。
static VectorShape	valueOf(String name)	指定された名前を持つこのクラスのenum定数を返します。
static VectorShape[]	values()	この列挙クラスの定数を含む配列を宣言されている順序で 返します。
int	vectorBitSize()	このシェイプのベクトルのサイズをビット単位で返します。
<E> VectorSpecies<E>	withLanes(Class<E> elementType)	指定された要素型と現在のシェイプを持つベクトル種を検索します。

クラスjava.lang.Enumで宣言されたメソッド

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

クラスjava.lang.Objectで宣言されたメソッド

getClass, notify, notifyAll, wait, wait, wait

列挙型定数の詳細

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

プラットフォームでサポートされる最大長のシェイプ

メソッドの詳細

values

public static VectorShape[] values()

この列挙クラスの定数を含む配列を宣言されている順序で 返します。

戻り値:

この列挙クラスの定数を宣言されている順序で含む配列

valueOf

public static VectorShape valueOf(String name)

指定された名前を持つこのクラスのenum定数を返します。 文字列は、このクラスでenum定数を宣言するために使用される識別子と正確に一致する必要があります。 (不適切な空白文字は許可されません。)

パラメータ:

name - 返される列挙型定数の名前。

戻り値:

指定された名前を持つ列挙型定数

例外:

IllegalArgumentException - この列挙型クラスに指定された名前の定数がない場合

NullPointerException - 引数がnullの場合

vectorBitSize

public int vectorBitSize()

このシェイプのベクトルのサイズをビット単位で返します。

戻り値:

このシェイプのベクトルのサイズ(ビット単位)。

withLanes

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

指定された要素型と現在のシェイプを持つベクトル種を検索します。 VectorSpecies.of(elementType, this)と同じ値を返します。

型パラメータ:

E - boxed要素型

パラメータ:

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)