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

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

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

Enum.EnumDesc<E>

修飾子と型	クラス	説明
static final class	Enum.EnumDesc<E extends Enum<E>>	enum定数の「名目記述子」。

列挙型定数のサマリー

列挙型定数

列挙型定数	説明
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	largestShapeFor(Class<?> etype)	要素タイプetypeの現在のプラットフォームでサポートされている最大ベクトル・シェイプを検索します。
static VectorShape	preferredShape()	すべてのベクトル要素型について、現在のプラットフォームが優先するベクトル・シェイプを検索します。
static VectorShape	valueOf(String name)	指定された名前を持つこのクラスのenum定数を返します。
static VectorShape[]	values()	この列挙クラスの定数を含む配列を宣言されている順序で 返します。
int	vectorBitSize()	このシェイプのベクトルのサイズをビット単位で返します。
<E> VectorSpecies<E>	withLanes(Class<E> elementType)	指定された要素型と現在のシェイプを持つベクトル種を検索します。

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

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

修飾子と型	メソッド	説明
protected final Object	clone()	CloneNotSupportedExceptionをスローします。
final int	compareTo(VectorShape o)	このenumと指定されたオブジェクトの順序を比較します。
final Optional<Enum.EnumDesc<VectorShape>>	describeConstable()	このインスタンスの列挙型記述子EnumDescを返します(作成可能な場合)。作成できない場合は空のOptionalを返します。
final boolean	equals(Object other)	指定されたオブジェクトがこのenum定数と同じ場合は、trueを返します。
protected final void	finalize()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 最終決定は削除のために非推奨になりました。
final Class<VectorShape>	getDeclaringClass()	このenum定数のenum型に対応するClassオブジェクトを返します。
final int	hashCode()	このenum定数のハッシュ・コードを返します。
final String	name()	enum宣言で宣言されているとおりのenum定数の名前を返します。
final int	ordinal()	列挙定数の序数(列挙宣言での位置。初期定数はゼロの序数に割り当てられる)を返します。
String	toString()	宣言に含まれるとおりのenum定数の名前を返します。
static <T extends Enum<T>> T	valueOf(Class<T> enumClass, String name)	指定された名前の指定されたenumクラスのenum定数を返します。

クラスオブジェクトで宣言されたメソッド

getClass, notify, notifyAll, wait, wait, wait

修飾子と型	メソッド	説明
final Class<?>	getClass()	このObjectの実行時クラスを返します。
final void	notify()	このオブジェクトのモニターで待機中のスレッドを1つ再開します。
final void	notifyAll()	このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
final void	wait()	現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
final void	wait(long timeoutMillis)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
final void	wait(long timeoutMillis, int nanos)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

列挙型定数の詳細

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

largestShapeFor

public static VectorShape largestShapeFor(Class<?> etype)

要素タイプetypeの現在のプラットフォームでサポートされている最大ベクトル・シェイプを検索します。

パラメータ:

etype - 要素の型

戻り値:

etypeのプラットフォームでサポートされている最大ベクトル・シェイプ

スロー:

IllegalArgumentException - そのようなベクトル・シェイプが要素タイプに存在しない場合、または型が有効なETYPEでない場合。

preferredShape

public static VectorShape preferredShape()

すべてのベクトル要素型について、現在のプラットフォームが優先するベクトル・シェイプを検索します。

プラットフォームで優先されるシェイプは、すべてのレーンのサイズがサポートされているという制約の下で、byteからdoubleへのビット・サイズが最大になります。 したがって、様々なレーン・タイプのすべての「優先ベクトル種」には、基礎となる共通のシェイプがあります。

戻り値:

すべての要素タイプに適したシェイプ

スロー:

UnsupportedOperationException - そのようなシェイプが存在しない場合

関連項目:

• VectorSpecies.ofPreferred(Class)