Rune.DecodeFromUtf8(ReadOnlySpan<Byte>, Rune, Int32) Método

Definição

Namespace:

System.Text

Assembly:

System.Runtime.dll

Decodifica o Rune no início do buffer de origem UTF-8 fornecido.

public:
 static System::Buffers::OperationStatus DecodeFromUtf8(ReadOnlySpan<System::Byte> source, [Runtime::InteropServices::Out] System::Text::Rune % result, [Runtime::InteropServices::Out] int % bytesConsumed);

public static System.Buffers.OperationStatus DecodeFromUtf8 (ReadOnlySpan<byte> source, out System.Text.Rune result, out int bytesConsumed);

static member DecodeFromUtf8 : ReadOnlySpan<byte> * Rune * int -> System.Buffers.OperationStatus

Public Shared Function DecodeFromUtf8 (source As ReadOnlySpan(Of Byte), ByRef result As Rune, ByRef bytesConsumed As Integer) As OperationStatus

Parâmetros

source

ReadOnlySpan<Byte>

Um intervalo de bytes codificados em UTF-8 somente leitura.

result

Rune

Quando este método é retornado, o símbolo decodificado.

bytesConsumed

Int32

Quando este método é retornado, o número de bytes lidos para criar o símbolo.

Retornos

OperationStatus

Done se o buffer de origem começar com um valor escalar codificado UTF-8 válido. result, então, contém o Rune decodificado e bytesConsumed contém o número de valores Byte usados no buffer de entrada para codificar o Rune.

NeedMoreData se o buffer de origem estiver vazio ou contiver apenas um caractere UTF-8 alternativo superior. result, então, contém ReplacementChar, e bytesConsumed contém o comprimento do buffer de entrada.

InvalidData se o buffer de origem começar com um valor escalar codificado em UTF-8 malformado. result, então, contém ReplacementChar, e bytesConsumed contém o número de valores de Byte usados no buffer de entrada para codificar a sequência malformada. .

Comentários

A convenção geral é chamar esse método em um loop, cortando o source buffer por bytesConsumed elementos em cada iteração do loop. Em cada iteração do loop, result contém o valor escalar real, se decodificado com êxito, ou contém Rune.ReplacementChar se os dados não puderam ser decodificados com êxito. Esse padrão fornece substituição U+FFFD automática conveniente de sequências inválidas durante a iteração por meio do loop.