Rune.DecodeFromUtf16(ReadOnlySpan<Char>, Rune, Int32) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
解碼 Rune 於提供的 UTF-16 來源緩衝區開頭。
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
參數
- source
- ReadOnlySpan<Char>
一個只讀的 UTF-16 字元範圍。
- result
- Rune
當這個方法回來時,解碼後的符文。
- charsConsumed
- Int32
當此方法回傳時,會讀取用於創建符文的字元數。
傳回
Done 若來源緩衝區起始為有效的 UTF-16 編碼純量值。
result則包含解碼後Rune的 ,並charsConsumed包含輸入緩衝區中用來編碼 的Rune值數量Char。
NeedMoreData 若來源緩衝區為空或僅包含獨立的 UTF-16 高代替代字元。
result 則包含 ReplacementChar,且 charsConsumed 包含輸入緩衝區的長度。
InvalidData 若來源緩衝區起始為未成形的 UTF-16 編碼純量值。
result 則包含 ReplacementChar,且 charsConsumed 包含 Char 用於編碼錯形序列的數值。
.
備註
一般慣例是在迴圈中呼叫此方法,並在迴圈的每次迭代中依charsConsumed元素切片緩source衝區。 在迴圈的每次迭代中,若資料成功解碼,則result為實際純量值;若資料未成功解碼,則為 。Rune.ReplacementChar 此模式在迴圈迭代時,提供方便的自動 U+FFFD 替換無效序列。