База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C#

Кодиране на ASCII в буфер Span<byte>

Използвайте Encoding.ASCII, за да кодирате ReadOnlySpan<char> в буфер Span<byte>. GetByteCount изчислява необходимия размер, а GetBytes записва байтовете и връща броя им. Замяната по подразбиране на знаци извън ASCII може да доведе до загуба на данни.

Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Синтаксис

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 в пространството от имена System.Text кодира 7-битовия набор от символи ASCII, обхващащ U+0000–U+007F. Не може да кодира произволен Unicode текст: механизмът за заместване по подразбиране заменя некодируемите символи с ? (байт 0x3F). Следователно не транслитерира é до e и не служи за строга ASCII проверка.

Encoding.GetByteCount(ReadOnlySpan<char>) изчислява точния брой байтове за входа и конфигурирания механизъм за заместване, без да записва данни. Encoding.GetBytes(ReadOnlySpan<char>, Span<byte>) кодира в буфер, предоставен от извикващия, и връща броя на записаните байтове. За разлика от претоварването GetBytes(string), не връща нов byte[].

Целевият буфер трябва да има поне изчисления капацитет; твърде малък буфер води до ArgumentException. Изчислете размера и кодирайте със същото кодиране и непроменен вход. След това подавайте само buffer[..written], а не целия капацитет на буфера. Фиксираният буфер stackalloc в примера е достатъчен за краткия вход; не правете неограниченото заделяне в стека зависимо от размера на външни данни.

Примерът използва span претоварвания, налични в .NET 10, и не изисква синтаксис preview. Hi é дава четири байта, 48 69 20 3F, което показва загубата на é. Ако загубата на данни е неприемлива, конфигурирайте ASCII кодирането с EncoderFallback.ExceptionFallback; ако форматът допуска Unicode, изберете подходящо кодиране, например Encoding.UTF8.

Примери

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]));

Резултат

Required: 4; written: 4
4869203F

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници