CKTIS / C#
Kodiranje ASCII v medpomnilnik Span<byte>
Uporabite Encoding.ASCII za kodiranje ReadOnlySpan<char> v medpomnilnik Span<byte>. GetByteCount izračuna potrebno velikost, GetBytes pa zapiše bajte in vrne njihovo število. Privzeto nadomeščanje znakov zunaj ASCII lahko povzroči izgubo podatkov.
Različica: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaksa
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 imenskem prostoru System.Text kodira 7-bitni nabor znakov ASCII, ki zajema U+0000–U+007F. Z njim ni mogoče kodirati poljubnega besedila Unicode: privzeti nadomestni mehanizem znake, ki jih ni mogoče kodirati, zamenja z ? (bajt 0x3F). Zato é ne prečrkuje v e in ni namenjen strogi validaciji ASCII.
Encoding.GetByteCount(ReadOnlySpan<char>) izračuna natančno število bajtov za vhod in nastavljeni nadomestni mehanizem, ne da bi zapisoval podatke. Encoding.GetBytes(ReadOnlySpan<char>, Span<byte>) kodira v medpomnilnik, ki ga zagotovi klicatelj, in vrne število zapisanih bajtov. Za razliko od preobremenitve GetBytes(string) ne vrne novega byte[].
Ciljni medpomnilnik mora imeti vsaj izračunano zmogljivost; premajhen medpomnilnik povzroči ArgumentException. Velikost izračunajte in kodirajte z istim kodiranjem ter nespremenjenim vhodom. Nato posredujte samo buffer[..written], ne celotne zmogljivosti medpomnilnika. Fiksni medpomnilnik stackalloc v primeru zadošča za kratek vhod; ne dovolite, da bi bila neomejena dodelitev na skladu odvisna od velikosti zunanjih podatkov.
Primer uporablja preobremenitve s spani, ki so na voljo v .NET 10, in ne potrebuje sintakse preview. Hi é ustvari štiri bajte, 48 69 20 3F, kar pokaže izgubo znaka é. Če izguba podatkov ni sprejemljiva, konfigurirajte kodiranje ASCII z EncoderFallback.ExceptionFallback; če oblika dovoljuje Unicode, izberite ustrezno kodiranje, na primer Encoding.UTF8.
Primeri
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]));Rezultat
Required: 4; written: 4 4869203F
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.