CKTIS / C#
Kódovanie ASCII do bufferu Span<byte>
Pomocou Encoding.ASCII zakódujte ReadOnlySpan<char> do bufferu Span<byte>. GetByteCount vypočíta potrebnú veľkosť, zatiaľ čo GetBytes zapíše bajty a vráti ich počet. Predvolené nahrádzanie znakov mimo ASCII môže spôsobiť stratu údajov.
Verzia: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
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 priestore názvov System.Text poskytuje kódovanie 7-bitovej znakovej sady ASCII, ktorá zahŕňa U+0000–U+007F. Nedokáže kódovať ľubovoľný text Unicode: predvolený náhradný mechanizmus nahrádza nekódovateľné znaky znakom ? (bajt 0x3F). Preto neprepisuje é na e a neslúži na prísnu validáciu ASCII.
Encoding.GetByteCount(ReadOnlySpan<char>) vypočíta presný počet bajtov pre vstup a nakonfigurovaný náhradný mechanizmus bez zapisovania údajov. Encoding.GetBytes(ReadOnlySpan<char>, Span<byte>) zakóduje údaje do buffera poskytnutého volajúcim a vráti počet zapísaných bajtov. Na rozdiel od preťaženia GetBytes(string) nevracia nové byte[].
Cieľový buffer musí mať aspoň vypočítanú kapacitu; príliš malý buffer spôsobí ArgumentException. Veľkosť vypočítajte a kódujte pomocou rovnakého kódovania a nezmeneného vstupu. Ďalej odovzdávajte iba buffer[..written], nie celú kapacitu buffera. Pevný buffer stackalloc v príklade postačuje pre krátky vstup; nerobte neobmedzenú alokáciu na zásobníku závislou od veľkosti externých údajov.
Príklad používa preťaženia so span dostupné v .NET 10 a nevyžaduje syntax preview. Hi é vytvorí štyri bajty, 48 69 20 3F, čím ukazuje stratu znaku é. Ak je strata údajov neprijateľná, nakonfigurujte kódovanie ASCII pomocou EncoderFallback.ExceptionFallback; ak formát povoľuje Unicode, vyberte vhodné kódovanie, napríklad Encoding.UTF8.
Prí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ýsledok
Required: 4; written: 4 4869203F
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.