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.