MemoryMarshal.Cast Methode

Definition

Namespace:

System.Runtime.InteropServices

Assembly:

System.Memory.dll

Paket:

System.Memory v4.5.5

Überlädt

Cast<TFrom,TTo>(ReadOnlySpan<TFrom>)	Wandelt einen schreibgeschützten Span eines primitiven Typs in einen schreibgeschützten Span eines anderen primitiven Typs um.
Cast<TFrom,TTo>(Span<TFrom>)	Wandelt einen Span eines primitiven Typs in einen Span eines anderen primitiven Typs um.

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

Quelle:

MemoryMarshal.cs

Wandelt einen schreibgeschützten Span eines primitiven Typs in einen schreibgeschützten Span eines anderen primitiven Typs um.

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)

Typparameter

TFrom

Der Typ der Quellspanne.

TTo

Der Typ der Zielspanne.

Parameter

span

ReadOnlySpan<TFrom>

Der zu konvertierende Quellslice.

Gibt zurück

ReadOnlySpan<TTo>

Die konvertierte schreibgeschützte Span.

Ausnahmen

ArgumentException

TFrom oder TTo enthält Verweise auf verwaltete Objekte.

OverflowException

Die Length Eigenschaft des neuen ReadOnlySpan<T> würde überschreiten MaxValue.

Hinweise

Weder TFrom noch TTo können Verweise auf verwaltete Objekte enthalten. Die Cast -Methode führt diese Überprüfung zur Laufzeit aus und löst aus ArgumentException , wenn die Überprüfung fehlschlägt.

Diese Methode wird nur auf Plattformen unterstützt, die einen falsch ausgerichteten Speicherzugriff unterstützen, oder wenn der Speicherblock auf andere Weise ausgerichtet ist.

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

Quelle:

MemoryMarshal.cs

Wandelt einen Span eines primitiven Typs in einen Span eines anderen primitiven Typs um.

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)

Typparameter

TFrom

Der Typ der Quellspanne.

TTo

Der Typ der Zielspanne.

Parameter

span

Span<TFrom>

Der zu konvertierende Quellslice.

Gibt zurück

Span<TTo>

Der konvertierte Span.

Ausnahmen

ArgumentException

TFrom oder TTo enthält Verweise auf verwaltete Objekte.

OverflowException

Die Length Eigenschaft des neuen ReadOnlySpan<T> würde überschreiten MaxValue.

Hinweise

Weder TFrom noch TTo können Verweise auf verwaltete Objekte enthalten. Die Cast -Methode führt diese Überprüfung zur Laufzeit aus und löst aus ArgumentException , wenn die Überprüfung fehlschlägt.

Wenn die Größen der beiden Typen unterschiedlich sind, kombiniert oder teilt die Umwandlung Werte, was zu einer Änderung der Länge führt.

Wenn TFromInt64beispielsweise ist, enthält der ReadOnlySpan<Int64> einen einzelnen Wert, 0x0100001111110F0F und TTo ist Int32, enthält der resultierende ReadOnlySpan<Int32> zwei Werte. Die Werte werden 0x11110F0F und 0x01000011 in einer Little-End-Architektur wie x86. In einer Big-End-Architektur wird die Reihenfolge der beiden Werte umgekehrt, d. h. 0x01000011, gefolgt von 0x11110F0F.

Als weiteres Beispiel, Int32wenn TFrom ist, enthält das ReadOnlySpan<Int32> die Werte 1, 2 und 3 und TTo ist Int64, enthält das resultierende ReadOnlySpan<Int64> einen einzelnen Wert: 0x0000000200000001 für eine Little-Endian-Architektur und 0x0000000100000002 für eine Big-End-Architektur.

Diese Methode wird nur auf Plattformen unterstützt, die einen falsch ausgerichteten Speicherzugriff unterstützen, oder wenn der Speicherblock auf andere Weise ausgerichtet ist.