CKTIS / C#
Kodowanie ASCII do bufora Span<byte>
Użyj Encoding.ASCII, aby zakodować ReadOnlySpan<char> w buforze Span<byte>. GetByteCount oblicza potrzebny rozmiar, a GetBytes zapisuje bajty i zwraca ich liczbę. Domyślne zastępowanie znaków spoza ASCII może powodować utratę danych.
Wersja: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Składnia
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 z przestrzeni nazw System.Text udostępnia kodowanie 7-bitowego zestawu ASCII, obejmującego U+0000–U+007F. Nie jest to kodowanie dowolnego tekstu Unicode: domyślny mechanizm zastępczy zamienia tekst niemożliwy do zakodowania na ? (bajt 0x3F). Nie transliteruje więc é na e i nie służy do ścisłej walidacji ASCII.
Encoding.GetByteCount(ReadOnlySpan<char>) oblicza dokładną liczbę bajtów dla wejścia i używanego mechanizmu zastępczego, ale nie zapisuje danych. Encoding.GetBytes(ReadOnlySpan<char>, Span<byte>) wykonuje kodowanie do bufora przekazanego przez wywołującego i zwraca liczbę zapisanych bajtów. W przeciwieństwie do przeciążenia GetBytes(string) nie zwraca nowej tablicy byte[].
Bufor docelowy musi mieć co najmniej obliczony rozmiar; zbyt mały powoduje ArgumentException. Obliczaj rozmiar i koduj przy użyciu tego samego kodowania oraz niezmienionego wejścia. Dalej przekazuj wyłącznie buffer[..written], a nie całą pojemność bufora. W przykładzie stały bufor stackalloc wystarcza dla krótkiego wejścia; nie uzależniaj nieograniczonej alokacji na stosie od rozmiaru danych zewnętrznych.
Przykład używa przeciążeń ze spanami dostępnych w .NET 10 i nie wymaga składni preview. Hi é daje cztery bajty 48 69 20 3F, pokazując utratę znaku é. Jeśli utrata danych jest niedopuszczalna, skonfiguruj kodowanie ASCII z EncoderFallback.ExceptionFallback; jeśli format dopuszcza Unicode, wybierz odpowiednie kodowanie, na przykład Encoding.UTF8.
Przykłady
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]));Wynik
Required: 4; written: 4 4869203F
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.