Rune.DecodeFromUtf16(ReadOnlySpan<Char>, Rune, Int32) Metod

Definition

Avkodar Rune i början av den angivna UTF-16-källbufferten.

public:
 static System::Buffers::OperationStatus DecodeFromUtf16(ReadOnlySpan<char> source, [Runtime::InteropServices::Out] System::Text::Rune % result, [Runtime::InteropServices::Out] int % charsConsumed);
public static System.Buffers.OperationStatus DecodeFromUtf16(ReadOnlySpan<char> source, out System.Text.Rune result, out int charsConsumed);
static member DecodeFromUtf16 : ReadOnlySpan<char> * Rune * int -> System.Buffers.OperationStatus
Public Shared Function DecodeFromUtf16 (source As ReadOnlySpan(Of Char), ByRef result As Rune, ByRef charsConsumed As Integer) As OperationStatus

Parametrar

source
ReadOnlySpan<Char>

Ett skrivskyddat UTF-16-teckensintervall.

result
Rune

När den här metoden returneras avkodad runa.

charsConsumed
Int32

När den här metoden returnerar, antalet tecken som läss för att skapa körningen.

Returer

Done om källbufferten börjar med ett giltigt UTF-16-kodat skalärvärde. result innehåller sedan det avkodade Runeoch charsConsumed innehåller antalet Char värden som används i indatabufferten Runeför att koda .

NeedMoreData om källbufferten är tom eller bara innehåller ett fristående UTF-16-hög surrogattecken. result innehåller ReplacementCharsedan , och charsConsumed innehåller längden på indatabufferten.

InvalidData om källbufferten börjar med ett felaktigt utf-16-kodat skalärvärde. result innehåller ReplacementCharsedan , och charsConsumed innehåller antalet Char värden som används för att koda den illa utformade sekvensen. .

Kommentarer

Den allmänna konventionen är att anropa den här metoden i en loop och dela bufferten source efter charsConsumed element på varje iteration av loopen. På varje iteration av loopen result innehåller det verkliga skalärvärdet om data har avkodats eller innehåller Rune.ReplacementChar om data inte har avkodats. Det här mönstret ger bekväm automatisk U+FFFD-ersättning av ogiltiga sekvenser när du itererar genom loopen.

Gäller för