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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.