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.