Rune.DecodeFromUtf16(ReadOnlySpan<Char>, Rune, Int32) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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.