Rune.DecodeLastFromUtf8(ReadOnlySpan<Byte>, Rune, Int32) Methode

Definition

Decodiert das Rune-Element am Ende des bereitgestellten UTF-8-Quellpuffers.

public:
 static System::Buffers::OperationStatus DecodeLastFromUtf8(ReadOnlySpan<System::Byte> source, [Runtime::InteropServices::Out] System::Text::Rune % value, [Runtime::InteropServices::Out] int % bytesConsumed);
public static System.Buffers.OperationStatus DecodeLastFromUtf8 (ReadOnlySpan<byte> source, out System.Text.Rune value, out int bytesConsumed);
static member DecodeLastFromUtf8 : ReadOnlySpan<byte> * Rune * int -> System.Buffers.OperationStatus
Public Shared Function DecodeLastFromUtf8 (source As ReadOnlySpan(Of Byte), ByRef value As Rune, ByRef bytesConsumed As Integer) As OperationStatus

Parameter

source
ReadOnlySpan<Byte>

Eine schreibgeschützte UTF-8-codierte Bytespanne.

value
Rune

Die decodierte Rune bei Rückgabe dieser Methode.

bytesConsumed
Int32

Die Anzahl von Bytes, die bei der Erstellung der Rune gelesen werden, wenn diese Methode zurückgegeben wird.

Gibt zurück

Done, wenn der Quellpuffer mit einem gültigen, UTF-8-codierten Skalarwert endet. result enthält dann die decodierte Rune-Eigenschaft und bytesConsumed die Anzahl an Byte-Werten, die in dem Eingabepuffer zur Codierung der Rune-Struktur verwendet wird.

NeedMoreData, wenn der Quellpuffer leer ist oder nur ein eigenständiges hohe UTF-8-Ersatzzeichen enthält. result enthält dann ReplacementChar und bytesConsumed enthält die Länge des Eingabepuffers.

InvalidData, wenn der Quellpuffer mit einem falsch formatierten, UTF-8-codierten Skalarwert endet. result enthält dann ReplacementChar und bytesConsumed enthält die Anzahl von Byte-Werten, die im Eingabepuffer zum Codieren der falsch formatierten Sequenz verwendet werden.

Hinweise

Diese Methode ist sehr ähnlich, DecodeFromUtf8(ReadOnlySpan<Byte>, Rune, Int32)mit der Ausnahme, dass der Aufrufer eine Schleife rückwärts statt vorwärts ausführen kann. Die typische Aufrufkonvention ist, dass der Aufrufer bei jeder Iteration der Schleife die letzten bytesConsumed Elemente des source Puffers abschneiden sollte.

Gilt für: