語言

Rune.DecodeFromUtf16(ReadOnlySpan<Char>, Rune, Int32) 方法

定義

解碼 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 替換無效序列。

適用於