Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

Kódování ASCII do bufferu Span<byte>

Pomocí Encoding.ASCII zakódujte ReadOnlySpan<char> do bufferu Span<byte>. GetByteCount vypočítá potřebnou velikost, zatímco GetBytes zapíše bajty a vrátí jejich počet. Výchozí nahrazení znaků mimo ASCII může způsobit ztrátu dat.

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

Syntaxe

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 v oboru názvů System.Text poskytuje kódování 7bitové znakové sady ASCII, která zahrnuje U+0000–U+007F. Nelze jím kódovat libovolný text Unicode: výchozí náhradní mechanismus nahradí nekódovatelné znaky znakem ? (bajt 0x3F). Nepřevádí tedy é na e a neslouží k přísné validaci ASCII.

Encoding.GetByteCount(ReadOnlySpan<char>) vypočítá přesný počet bajtů pro vstup a nakonfigurovaný náhradní mechanismus, aniž by zapisovala data. Encoding.GetBytes(ReadOnlySpan<char>, Span<byte>) provede kódování do bufferu poskytnutého volajícím a vrátí počet zapsaných bajtů. Na rozdíl od přetížení GetBytes(string) nevrací nové byte[].

Cílový buffer musí mít alespoň vypočtenou kapacitu; příliš malý buffer způsobí ArgumentException. Velikost vypočítejte a kódujte se stejným kódováním a nezměněným vstupem. Dále předávejte pouze buffer[..written], nikoli celou kapacitu bufferu. Pevný buffer stackalloc v příkladu stačí pro krátký vstup; neodvozujte neomezenou alokaci na zásobníku od velikosti externích dat.

Příklad používá přetížení se span dostupná v .NET 10 a nevyžaduje syntaxi preview. Hi é vytvoří čtyři bajty, 48 69 20 3F, což ukazuje ztrátu znaku é. Pokud je ztráta dat nepřijatelná, nastavte pro kódování ASCII EncoderFallback.ExceptionFallback; pokud formát umožňuje Unicode, zvolte vhodné kódování, například Encoding.UTF8.

Příklady

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]));

Výsledek

Required: 4; written: 4
4869203F

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje