UTF7Encoding.GetChars Метод

Определение

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

System.Text

Сборки:

netstandard.dll, System.Text.Encoding.Extensions.dll

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

Перегрузки

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

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

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

UTF7Encoding.cs

Важно!

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

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

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 is null (Nothing).

–или–

chars is null (Nothing).

ArgumentOutOfRangeException

byteCount или charCount меньше нуля.

ArgumentException

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

DecoderFallbackException

Произошла резервная ошибка (дополнительные сведения см. в разделе "Кодировка символов" в .NET)

-и-

DecoderFallback задан как DecoderExceptionFallback.

Комментарии

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

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

Note

UTF7Encoding не предоставляет обнаружение ошибок. При обнаружении UTF7Encoding недопустимых байтов обычно выдает недопустимые байты. Если байт больше шестнадцатеричного 0x7F, значение байта равно нулю в символ Юникода, результат хранится в chars массиве, а любая последовательность сдвигов завершается. Например, если байт для кодирования является шестнадцатеричным 0x81, результирующий символ — U+0081. По соображениям безопасности приложения рекомендуется использовать UTF8EncodingUnicodeEncodingили UTF32Encoding включить обнаружение ошибок.

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

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

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

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

UTF7Encoding.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 is null (Nothing).

–или–

chars is null (Nothing).

ArgumentOutOfRangeException

byteIndex или byteCountcharIndex меньше нуля.

–или–

byteIndex и byteCount не обозначайте допустимый диапазон в bytes.

–или–

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

ArgumentException

chars не имеет достаточной емкости от charIndex конца массива для размещения результирующего символа.

DecoderFallbackException

Произошла резервная ошибка (дополнительные сведения см. в разделе "Кодировка символов" в .NET)

-и-

DecoderFallback задан как DecoderExceptionFallback.

Примеры

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

using System;
using System.Text;

class UTF7EncodingExample {
    public static void Main() {
        Char[] chars;
        Byte[] bytes = new Byte[] {
             85,  84,  70,  55,  32,  69, 110,
             99, 111, 100, 105, 110, 103,  32,
             69, 120,  97, 109, 112, 108, 101
        };

        UTF7Encoding utf7 = new UTF7Encoding();

        int charCount = utf7.GetCharCount(bytes, 2, 8);
        chars = new Char[charCount];
        int charsDecodedCount = utf7.GetChars(bytes, 2, 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 UTF7EncodingExample
    
    Public Shared Sub Main()
        Dim chars() As Char
        Dim bytes() As Byte = { _
            85,  84,  70,  55,  32,  69, 110, _
            99, 111, 100, 105, 110, 103,  32, _
            69, 120,  97, 109, 112, 108, 101 _
        }
        
        Dim utf7 As New UTF7Encoding()
        
        Dim charCount As Integer = utf7.GetCharCount(bytes, 2, 8)
        chars = New Char(charCount - 1) {}
        Dim charsDecodedCount As Integer = utf7.GetChars(bytes, 2, 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 соответственно.

Note

UTF7Encoding не предоставляет обнаружение ошибок. При обнаружении UTF7Encoding недопустимых байтов обычно выдает недопустимые байты. Если байт больше шестнадцатеричного 0x7F, значение байта равно нулю в символ Юникода, результат хранится в chars массиве, а любая последовательность сдвигов завершается. Например, если байт для кодирования является шестнадцатеричным 0x81, результирующий символ — U+0081. По соображениям безопасности приложения рекомендуется использовать UTF8EncodingUnicodeEncodingили UTF32Encoding включить обнаружение ошибок.

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

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