MemoryMarshal.Cast メソッド

定義

オーバーロード

Cast<TFrom,TTo>(ReadOnlySpan<TFrom>)

1 つのプリミティブ型の読み取り専用スパンを、別のプリミティブ型の読み取り専用スパンにキャストします。

Cast<TFrom,TTo>(Span<TFrom>)

1 つのプリミティブ型のスパンを、別のプリミティブ型のスパンにキャストします。

Cast<TFrom,TTo>(ReadOnlySpan<TFrom>)

1 つのプリミティブ型の読み取り専用スパンを、別のプリミティブ型の読み取り専用スパンにキャストします。

public:
generic <typename TFrom, typename TTo>
 where TFrom : value class where TTo : value class static ReadOnlySpan<TTo> Cast(ReadOnlySpan<TFrom> span);
public static ReadOnlySpan<TTo> Cast<TFrom,TTo> (ReadOnlySpan<TFrom> span) where TFrom : struct where TTo : struct;
static member Cast : ReadOnlySpan<'From (requires 'From : struct)> -> ReadOnlySpan<'o (requires 'o : struct)> (requires 'From : struct and 'o : struct)
Public Shared Function Cast(Of TFrom As Structure, TTo As Structure) (span As ReadOnlySpan(Of TFrom)) As ReadOnlySpan(Of TTo)

型パラメーター

TFrom

ソース スパンの型。

TTo

ターゲット スパンの型。

パラメーター

span
ReadOnlySpan<TFrom>

変換するソース スライス。

戻り値

ReadOnlySpan<TTo>

変換された読み取り専用スパン。

例外

TFrom または TTo マネージド オブジェクト参照が含まれています。

新しいReadOnlySpan<T>プロパティがLength超えるMaxValue可能性があります。

注釈

マネージド オブジェクト参照を含めることもTFrom``TToできません。 メソッドは Cast 実行時にこのチェックを実行し、チェックが失敗した場合にスロー ArgumentException します。

このメソッドは、不適切なメモリ アクセスをサポートしているプラットフォーム、またはメモリ ブロックが他の方法でアラインされている場合にのみサポートされます。

適用対象

Cast<TFrom,TTo>(Span<TFrom>)

1 つのプリミティブ型のスパンを、別のプリミティブ型のスパンにキャストします。

public:
generic <typename TFrom, typename TTo>
 where TFrom : value class where TTo : value class static Span<TTo> Cast(Span<TFrom> span);
public static Span<TTo> Cast<TFrom,TTo> (Span<TFrom> span) where TFrom : struct where TTo : struct;
static member Cast : Span<'From (requires 'From : struct)> -> Span<'o (requires 'o : struct)> (requires 'From : struct and 'o : struct)
Public Shared Function Cast(Of TFrom As Structure, TTo As Structure) (span As Span(Of TFrom)) As Span(Of TTo)

型パラメーター

TFrom

ソース スパンの型。

TTo

ターゲット スパンの型。

パラメーター

span
Span<TFrom>

変換するソース スライス。

戻り値

Span<TTo>

変換されたスパン。

例外

TFrom または TTo マネージド オブジェクト参照が含まれています。

新しいReadOnlySpan<T>プロパティがLength超えるMaxValue可能性があります。

注釈

マネージド オブジェクト参照を含めることもTFrom``TToできません。 メソッドは Cast 実行時にこのチェックを実行し、チェックが失敗した場合にスロー ArgumentException します。

2 つの型のサイズが異なる場合、キャストによって値が結合または分割され、長さが変化します。

たとえば、次の場合TFrom、1 つの値である0x0100001111110F0FがInt32TTo含まれており、結果ReadOnlySpan<Int32>には 2 つの値が含ReadOnlySpan<Int64>まれます。Int64 値は0x11110F0Fされ、x86 などのリトル エンディアン アーキテクチャで0x01000011されます。 ビッグ エンディアン アーキテクチャでは、2 つの値の順序 (つまり、0x01000011、0x11110F0F) が逆になります。

別の例として、ある場合TFromReadOnlySpan<Int32>Int321、2、3 の値が含まれており、TTo結果ReadOnlySpan<Int64>として Int641 つの値が含まれます:リトル エンディアン アーキテクチャの0x0000000200000001と、ビッグ エンディアン アーキテクチャでの0x0000000100000002。

このメソッドは、不適切なメモリ アクセスをサポートしているプラットフォーム、またはメモリ ブロックが他の方法でアラインされている場合にのみサポートされます。

適用対象