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.OperationStatusPublic 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 содержит количество значений, используемых Char в входном буфере для кодирования Rune.
NeedMoreData Значение , если исходный буфер пуст или содержит только автономный символ UTF-16 с высоким суррогатным символом.
result затем содержит ReplacementCharи charsConsumed содержит длину входного буфера.
InvalidData Если исходный буфер начинается с неправильно сформированного скалярного значения UTF-16.
result затем содержит ReplacementCharи charsConsumed содержит количество значений, используемых Char для кодирования неправильно сформированной последовательности.
.
Комментарии
Общее соглашение заключается в вызове этого метода в цикле, срезая source буфер по charsConsumed элементам в каждой итерации цикла. В каждой итерации цикла содержит реальное скалярное значение, result если данные были успешно декодированы, или содержит Rune.ReplacementChar , если данные не были успешно декодированы. Этот шаблон обеспечивает удобную автоматическую подстановку U+FFFD недопустимых последовательностей при итерации по циклу.
