Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje