Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C#

Codificar ASCII en un búfer Span<byte>

Usa Encoding.ASCII para codificar un ReadOnlySpan<char> en un búfer Span<byte>. GetByteCount calcula el tamaño necesario, mientras que GetBytes escribe los bytes y devuelve su cantidad. La sustitución predeterminada de caracteres no ASCII puede provocar pérdida de datos.

Versión: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaxis

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, del espacio de nombres System.Text, codifica el conjunto de caracteres ASCII de 7 bits, de U+0000 a U+007F. No permite codificar texto Unicode arbitrario: el mecanismo de reserva predeterminado sustituye los caracteres que no se pueden codificar por ? (byte 0x3F). Por tanto, no translitera é a e ni sirve para una validación ASCII estricta.

Encoding.GetByteCount(ReadOnlySpan<char>) calcula el número exacto de bytes para la entrada y el mecanismo de reserva configurado, sin escribir datos. Encoding.GetBytes(ReadOnlySpan<char>, Span<byte>) codifica en un búfer proporcionado por quien llama y devuelve el número de bytes escritos. A diferencia de la sobrecarga GetBytes(string), no devuelve un nuevo byte[].

El búfer de destino debe tener al menos la capacidad calculada; si es demasiado pequeño, se produce ArgumentException. Calcula el tamaño y codifica con la misma codificación y la entrada sin modificar. Después, pasa únicamente buffer[..written], no toda la capacidad del búfer. El búfer stackalloc fijo del ejemplo basta para su entrada breve; no hagas que una asignación de pila sin límite dependa del tamaño de datos externos.

El ejemplo usa sobrecargas con spans disponibles en .NET 10 y no requiere sintaxis preview. Hi é produce cuatro bytes, 48 69 20 3F, lo que muestra la pérdida de é. Si la pérdida de datos no es aceptable, configura la codificación ASCII con EncoderFallback.ExceptionFallback; si el formato permite Unicode, elige una codificación adecuada, como Encoding.UTF8.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes