MemoryMarshal.Cast メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| 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) が逆になります。
別の例として、ある場合TFrom、ReadOnlySpan<Int32>Int321、2、3 の値が含まれており、TTo結果ReadOnlySpan<Int64>として Int641 つの値が含まれます:リトル エンディアン アーキテクチャの0x0000000200000001と、ビッグ エンディアン アーキテクチャでの0x0000000100000002。
このメソッドは、不適切なメモリ アクセスをサポートしているプラットフォーム、またはメモリ ブロックが他の方法でアラインされている場合にのみサポートされます。