Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C#

Codificar ASCII num buffer Span<byte>

Utilize Encoding.ASCII para codificar um ReadOnlySpan<char> num buffer Span<byte>. GetByteCount calcula o tamanho necessário, enquanto GetBytes escreve os bytes e devolve a respetiva quantidade. A substituição predefinida de caracteres não ASCII pode causar perda de dados.

Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaxe

using System;
using System.Text;

ReadOnlySpan<char> chars = "Hi";
Encoding encoding = Encoding.ASCII;
int required = encoding.GetByteCount(chars);
Span<byte> bytes = new byte[required];
int written = encoding.GetBytes(chars, bytes);

Encoding.ASCII, no espaço de nomes System.Text, codifica o conjunto de caracteres ASCII de 7 bits, de U+0000 a U+007F. Não codifica texto Unicode arbitrário: o fallback predefinido substitui os caracteres não codificáveis por ? (byte 0x3F). Por isso, não translitera é para e e não serve para uma validação ASCII rigorosa.

Encoding.GetByteCount(ReadOnlySpan<char>) calcula o número exato de bytes para a entrada e o fallback configurado, sem escrever dados. Encoding.GetBytes(ReadOnlySpan<char>, Span<byte>) codifica para um buffer fornecido pelo autor da chamada e devolve o número de bytes escritos. Ao contrário da sobrecarga GetBytes(string), não devolve um novo byte[].

O buffer de destino tem de ter, pelo menos, a capacidade calculada; se for demasiado pequeno, é lançada uma ArgumentException. Calcule o tamanho e codifique com a mesma codificação e a entrada inalterada. Depois, passe apenas buffer[..written], e não toda a capacidade do buffer. O buffer stackalloc de tamanho fixo do exemplo é suficiente para a entrada curta; não faça depender uma alocação ilimitada na pilha do tamanho de dados externos.

O exemplo utiliza sobrecargas com spans disponíveis no .NET 10 e não requer sintaxe preview. Hi é produz quatro bytes, 48 69 20 3F, demonstrando a perda de é. Se a perda de dados não for aceitável, configure a codificação ASCII com EncoderFallback.ExceptionFallback; se o formato permitir Unicode, escolha uma codificação adequada, como Encoding.UTF8.

Exemplos

using System;
using System.Text;

ReadOnlySpan<char> text = "Hi \u00E9".AsSpan();
Encoding encoding = Encoding.ASCII;
int required = encoding.GetByteCount(text);
Span<byte> buffer = stackalloc byte[32];
int written = encoding.GetBytes(text, buffer);

Console.WriteLine($"Required: {required}; written: {written}");
Console.WriteLine(Convert.ToHexString(buffer[..written]));

Resultado

Required: 4; written: 4
4869203F

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes