ASCIIEncoding.GetChars Метод

Определение

Пространство имен:

System.Text

Сборка:

System.Text.Encoding.Extensions.dll

Декодирует последовательность байтов в набор символов.

Перегрузки

GetChars(ReadOnlySpan<Byte>, Span<Char>)	Декодирует заданный диапазон байтов в заданный диапазон символов.
GetChars(Byte*, Int32, Char*, Int32)	Декодирует последовательность байтов, начало которой задается указателем байта, в набор символов, которые сохраняются начиная с заданного указателя символа.
GetChars(Byte[], Int32, Int32, Char[], Int32)	Декодирует последовательность байтов из заданного массива байтов в указанный массив символов.

GetChars(ReadOnlySpan<Byte>, Span<Char>)

Исходный код:

ASCIIEncoding.cs

Декодирует заданный диапазон байтов в заданный диапазон символов.

public:
 override int GetChars(ReadOnlySpan<System::Byte> bytes, Span<char> chars);

public override int GetChars (ReadOnlySpan<byte> bytes, Span<char> chars);

override this.GetChars : ReadOnlySpan<byte> * Span<char> -> int

Public Overrides Function GetChars (bytes As ReadOnlySpan(Of Byte), chars As Span(Of Char)) As Integer

Параметры

bytes

ReadOnlySpan<Byte>

Диапазон, содержащий байты для декодирования.

chars

Span<Char>

Диапазон, содержащий результирующий набор символов.

Возвращаемое значение

Int32

Фактическое число символов, записанных в chars.

Комментарии

Чтобы вычислить точный размер, необходимый GetChars для хранения полученных символов, используйте .GetCharCount Чтобы вычислить максимальный размер, используйте .GetMaxCharCount GetCharCountМетод обычно позволяет выделить меньше памяти, в то время GetMaxCharCount как метод обычно выполняется быстрее.

Преобразуемые данные, например данные, считываемые из потока, могут быть доступны только в последовательных блоках. В этом случае или если объем данных настолько велик, что их необходимо разделить на более мелкие блоки, следует использовать Decoder или , предоставленные Encoder методом GetDecoder или методом GetEncoder соответственно.

ASCIIEncoding не обеспечивает обнаружение ошибок. Любой байт, превышающий шестнадцатеричный 0x7F , декодируется как вопросительный знак Юникода ("?").

Внимание!

В целях безопасности следует использовать UTF8Encoding, UnicodeEncodingили UTF32Encoding и включить обнаружение ошибок.

GetChars(Byte*, Int32, Char*, Int32)

Исходный код:

ASCIIEncoding.cs

Важно!

Этот API несовместим с CLS.

Альтернативный вариант, совместимый с CLS

System.Text.ASCIIEncoding.GetChars(Byte[], Int32, Int32, Char[], Int32)

Декодирует последовательность байтов, начало которой задается указателем байта, в набор символов, которые сохраняются начиная с заданного указателя символа.

public:
 override int GetChars(System::Byte* bytes, int byteCount, char* chars, int charCount);

[System.CLSCompliant(false)]
public override int GetChars (byte* bytes, int byteCount, char* chars, int charCount);

[<System.CLSCompliant(false)>]
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int -> int

Параметры

bytes

Byte*

Указатель на первый декодируемый байт.

byteCount

Int32

Число байтов для декодирования.

chars

Char*

Указатель на положение, с которого начинается запись результирующего набора символов.

charCount

Int32

Наибольшее количество символов для записи.

Возвращаемое значение

Int32

Фактическое число символов, записанных в местоположение, указанное с помощью параметра chars.

Атрибуты

CLSCompliantAttribute

Исключения

ArgumentNullException

bytes имеет значение null.

-или-

chars имеет значение null.

ArgumentOutOfRangeException

Значение параметра byteCount или charCount меньше нуля.

ArgumentException

charCount меньше результирующего числа символов.

DecoderFallbackException

Произошел откат (см. сведения о кодировке символов в .NET)

- и -

Параметру DecoderFallback задается значение DecoderExceptionFallback.

Комментарии

Чтобы вычислить точный размер массива, необходимый GetChars для хранения результирующего символа, приложение использует GetCharCount. Чтобы вычислить максимальный размер массива, приложение должно использовать GetMaxCharCount. GetCharCountМетод обычно позволяет выделить меньше памяти, в то время GetMaxCharCount как метод обычно выполняется быстрее.

Преобразуемые данные, например данные, считываемые из потока, могут быть доступны только в последовательных блоках. В этом случае или если объем данных настолько велик, что их нужно разделить на более мелкие блоки, приложение должно использовать Decoder или , предоставленные Encoder методом GetDecoder или методом GetEncoder соответственно.

ASCIIEncoding не обеспечивает обнаружение ошибок. Любой байт, превышающий шестнадцатеричное 0x7F, декодируется как вопросительный знак Юникода ("?").

Внимание!

В целях безопасности в приложении рекомендуется использовать UTF8Encoding, UnicodeEncodingили UTF32Encoding и включить обнаружение ошибок.

См. также раздел

• GetCharCount(Byte[], Int32, Int32)
• GetMaxCharCount(Int32)
• GetDecoder()
• GetString(Byte[], Int32, Int32)

GetChars(Byte[], Int32, Int32, Char[], Int32)

Исходный код:

ASCIIEncoding.cs

Декодирует последовательность байтов из заданного массива байтов в указанный массив символов.

public:
 override int GetChars(cli::array <System::Byte> ^ bytes, int byteIndex, int byteCount, cli::array <char> ^ chars, int charIndex);

public override int GetChars (byte[] bytes, int byteIndex, int byteCount, char[] chars, int charIndex);

override this.GetChars : byte[] * int * int * char[] * int -> int

Public Overrides Function GetChars (bytes As Byte(), byteIndex As Integer, byteCount As Integer, chars As Char(), charIndex As Integer) As Integer

Параметры

bytes

Byte[]

Массив байтов, содержащий последовательность байтов, которую требуется декодировать.

byteIndex

Int32

Индекс первого декодируемого байта.

byteCount

Int32

Число байтов для декодирования.

chars

Char[]

Массив символов, в который будет помещен результирующий набор символов.

charIndex

Int32

Индекс, с которого начинается запись результирующего набора символов.

Возвращаемое значение

Int32

Фактическое число символов, записанных в chars.

Исключения

ArgumentNullException

bytes имеет значение null.

-или-

chars имеет значение null.

ArgumentOutOfRangeException

Значение параметра byteIndex, byteCount или charIndex меньше нуля.

-или-

Параметрыbyteindex и byteCount не указывают допустимый диапазон в bytes.

-или-

Значение параметра charIndex не является допустимым индексом в chars.

ArgumentException

Недостаточно емкости chars от charIndex до конца массива для размещения полученных символов.

DecoderFallbackException

Произошел откат (см. сведения о кодировке символов в .NET)

- и -

Параметру DecoderFallback задается значение DecoderExceptionFallback.

Примеры

В следующем примере показано, как декодировать диапазон элементов из массива байтов и сохранить результат в наборе элементов в массиве символов Юникода.

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   array<Char>^chars;
   array<Byte>^bytes = {65,83,67,73,73,32,69,110,99,111,100,105,110,103,32,69,120,97,109,112,108,101};
   ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
   int charCount = ascii->GetCharCount( bytes, 6, 8 );
   chars = gcnew array<Char>(charCount);
   int charsDecodedCount = ascii->GetChars( bytes, 6, 8, chars, 0 );
   Console::WriteLine( "{0} characters used to decode bytes.", charsDecodedCount );
   Console::Write( "Decoded chars: " );
   IEnumerator^ myEnum = chars->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Char c = safe_cast<Char>(myEnum->Current);
      Console::Write( "[{0}]", c.ToString() );
   }

   Console::WriteLine();
}

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        Char[] chars;
        Byte[] bytes = new Byte[] {
             65,  83,  67,  73,  73,  32,  69,
            110,  99, 111, 100, 105, 110, 103,
             32,  69, 120,  97, 109, 112, 108, 101
        };

        ASCIIEncoding ascii = new ASCIIEncoding();

        int charCount = ascii.GetCharCount(bytes, 6, 8);
        chars = new Char[charCount];
        int charsDecodedCount = ascii.GetChars(bytes, 6, 8, chars, 0);

        Console.WriteLine(
            "{0} characters used to decode bytes.", charsDecodedCount
        );

        Console.Write("Decoded chars: ");
        foreach (Char c in chars) {
            Console.Write("[{0}]", c);
        }
        Console.WriteLine();
    }
}

Imports System.Text

Class ASCIIEncodingExample
    Public Shared Sub Main()
        Dim chars() As Char
        Dim bytes() As Byte = { _
             65,  83,  67,  73,  73,  32,  69, _
            110,  99, 111, 100, 105, 110, 103, _
             32,  69, 120,  97, 109, 112, 108, 101}

        Dim ascii As New ASCIIEncoding()

        Dim charCount As Integer = ascii.GetCharCount(bytes, 6, 8)
        chars = New Char(charCount - 1) {}
        Dim charsDecodedCount As Integer = ascii.GetChars(bytes, 6, 8, chars, 0)

        Console.WriteLine("{0} characters used to decode bytes.", charsDecodedCount)

        Console.Write("Decoded chars: ")
        Dim c As Char
        For Each c In chars
            Console.Write("[{0}]", c)
        Next c
        Console.WriteLine()
    End Sub
End Class

Комментарии

Чтобы вычислить точный размер массива, необходимый GetChars для хранения результирующего символа, приложение использует GetCharCount. Чтобы вычислить максимальный размер массива, приложение должно использовать GetMaxCharCount. GetCharCountМетод обычно позволяет выделить меньше памяти, в то время GetMaxCharCount как метод обычно выполняется быстрее.

Преобразуемые данные, например данные, считываемые из потока, могут быть доступны только в последовательных блоках. В этом случае или если объем данных настолько велик, что их нужно разделить на более мелкие блоки, приложение должно использовать Decoder или , предоставленные Encoder методом GetDecoder или методом GetEncoder соответственно.

ASCIIEncoding не обеспечивает обнаружение ошибок. Любой байт, превышающий шестнадцатеричное 0x7F, декодируется как вопросительный знак Юникода ("?").

Внимание!

В целях безопасности в приложении рекомендуется использовать UTF8Encoding, UnicodeEncodingили UTF32Encoding и включить обнаружение ошибок.

См. также раздел

• GetCharCount(Byte[], Int32, Int32)
• GetMaxCharCount(Int32)
• GetDecoder()
• GetString(Byte[], Int32, Int32)