CKTIS / C#
Kodiranje ASCII-ja u međuspremnik Span<byte>
Upotrijebite Encoding.ASCII za kodiranje ReadOnlySpan<char> u međuspremnik Span<byte>. GetByteCount izračunava potrebnu veličinu, a GetBytes zapisuje bajtove i vraća njihov broj. Zadana zamjena znakova koji nisu ASCII može uzrokovati gubitak podataka.
Verzija: .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 u prostoru naziva System.Text omogućuje kodiranje 7-bitnog skupa znakova ASCII, koji obuhvaća U+0000–U+007F. Ne može kodirati proizvoljan tekst Unicode: zadani zamjenski mehanizam zamjenjuje znakove koji se ne mogu kodirati znakom ? (bajt 0x3F). Zato ne transliterira é u e i nije namijenjen strogoj ASCII validaciji.
Encoding.GetByteCount(ReadOnlySpan<char>) izračunava točan broj bajtova za ulaz i konfigurirani zamjenski mehanizam, bez zapisivanja podataka. Encoding.GetBytes(ReadOnlySpan<char>, Span<byte>) kodira u međuspremnik koji je dao pozivatelj i vraća broj zapisanih bajtova. Za razliku od preopterećenja GetBytes(string), ne vraća novi byte[].
Odredišni međuspremnik mora imati barem izračunati kapacitet; premalen međuspremnik uzrokuje ArgumentException. Izračunajte veličinu i kodirajte istim kodiranjem i neizmijenjenim ulazom. Zatim proslijedite samo buffer[..written], a ne cijeli kapacitet međuspremnika. Fiksni međuspremnik stackalloc u primjeru dovoljan je za kratak ulaz; nemojte dopustiti da neograničena alokacija na stogu ovisi o veličini vanjskih podataka.
Primjer upotrebljava preopterećenja sa spanovima dostupna u .NET 10 i ne zahtijeva sintaksu preview. Hi é daje četiri bajta, 48 69 20 3F, čime se pokazuje gubitak znaka é. Ako gubitak podataka nije prihvatljiv, konfigurirajte ASCII kodiranje s EncoderFallback.ExceptionFallback; ako format dopušta Unicode, odaberite odgovarajuće kodiranje, primjerice Encoding.UTF8.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.