Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori