Decoder.GetChars Метод

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

Decoder.cs

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

Decoder.cs

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

Decoder.cs

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

Decoder.cs

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

Decoder.cs

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

public virtual int GetChars(ReadOnlySpan<byte> bytes, Span<char> chars, bool flush);

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

Public Overridable Function GetChars (bytes As ReadOnlySpan(Of Byte), chars As Span(Of Char), flush As Boolean) As Integer

Параметры

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

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

Комментарии

Помните, что Decoder объект сохраняет состояние между вызовами GetChars. Когда приложение выполняется с потоком данных, он должен задать flush параметр, чтобы true убедиться, что сведения о состоянии сбрасываются. С помощью этого параметра декодировщик игнорирует недопустимые байты в конце блока данных и очищает внутренний буфер.

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

Если GetChars вызывается с flush заданным значением false, декодатор сохраняет конечные байты в конце блока данных во внутреннем буфере и использует их в следующей операции декодирования. Приложение должно вызывать GetCharCount блок данных непосредственно перед вызовом GetChars одного блока, чтобы все конечные байты из предыдущего блока были включены в вычисление.

Если приложение предназначено для преобразования множества сегментов входного потока, рассмотрите возможность использования Convert метода. GetChars вызовет исключение, если выходной диапазон не достаточно велик, но Convert будет заполнять максимальное пространство и возвращать записанные байты, если выходной массив позволяет по крайней мере два символа. Encoding.GetChars См. также раздел для дополнительных комментариев.

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

Decoder.cs

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

Decoder.cs

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

Decoder.cs

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

Decoder.cs

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

Decoder.cs

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

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

[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public virtual int GetChars(byte* bytes, int byteCount, char* chars, int charCount, bool flush);

[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
public virtual int GetChars(byte* bytes, int byteCount, char* chars, int charCount, bool flush);

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

[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int

[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Security.SecurityCritical>]
abstract member GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int

Параметры

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

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

Атрибуты

CLSCompliantAttribute ComVisibleAttribute SecurityCriticalAttribute

Исключения

Комментарии

Помните, что Decoder объект сохраняет состояние между вызовами GetChars. Когда приложение выполняется с потоком данных, он должен задать flush параметр, чтобы true убедиться, что сведения о состоянии сбрасываются. С помощью этого параметра декодировщик игнорирует недопустимые байты в конце блока данных и очищает внутренний буфер.

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

Если GetChars вызывается с flush заданным значением false, декодатор сохраняет конечные байты в конце блока данных во внутреннем буфере и использует их в следующей операции декодирования. Приложение должно вызывать GetCharCount блок данных непосредственно перед вызовом GetChars одного блока, чтобы все конечные байты из предыдущего блока были включены в вычисление.

Если приложение предназначено для преобразования множества сегментов входного потока, рассмотрите возможность использования Convert метода. GetChars вызовет исключение, если выходной буфер не достаточно велик, но Convert будет заполнять максимальное пространство и возвращать записанные байты, если выходной массив позволяет по крайней мере два символа. Encoding.GetChars См. также раздел для дополнительных комментариев.

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

• GetCharCount(Byte*, Int32, Boolean)
• Reset()

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

Decoder.cs

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

Decoder.cs

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

Decoder.cs

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

Decoder.cs

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

Decoder.cs

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

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

abstract member GetChars : byte[] * int * int * char[] * int -> int

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

Параметры

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

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

Исключения

Примеры

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

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        Char[] chars;
        Byte[] bytes = new Byte[] {
            85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0
        };

        Decoder uniDecoder = Encoding.Unicode.GetDecoder();

        int charCount = uniDecoder.GetCharCount(bytes, 0, bytes.Length);
        chars = new Char[charCount];
        int charsDecodedCount = uniDecoder.GetChars(bytes, 0, bytes.Length, 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();
    }
}

/* This code example produces the following output.

7 characters used to decode bytes.
Decoded chars: [U][n][i][c][o][d][e]

*/

Imports System.Text

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        Dim chars() As Char
        Dim bytes() As Byte = { _
            85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0 _
        }
        
        Dim uniDecoder As Decoder = Encoding.Unicode.GetDecoder()
        
        Dim charCount As Integer = uniDecoder.GetCharCount(bytes, 0, bytes.Length)
        chars = New Char(charCount - 1) {}
        Dim charsDecodedCount As Integer = _
            uniDecoder.GetChars(bytes, 0, bytes.Length, 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

'This code example produces the following output.
'
'7 characters used to decode bytes.
'Decoded chars: [U][n][i][c][o][d][e]
'

Комментарии

Помните, что Decoder объект сохраняет состояние между вызовами GetChars. Когда приложение выполняется с потоком данных, он должен задать flush параметр, чтобы true убедиться, что сведения о состоянии сбрасываются. С помощью этого параметра декодировщик игнорирует недопустимые байты в конце блока данных и очищает внутренний буфер.

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

Если GetChars вызывается с flush заданным значением false, декодатор сохраняет конечные байты в конце блока данных во внутреннем буфере и использует их в следующей операции декодирования. Приложение должно вызывать GetCharCount блок данных непосредственно перед вызовом GetChars одного блока, чтобы все конечные байты из предыдущего блока были включены в вычисление.

Если приложение предназначено для преобразования множества сегментов входного потока, рассмотрите возможность использования Convert метода. GetChars вызовет исключение, если выходной буфер не достаточно велик, но Convert будет заполнять максимальное пространство и возвращать записанные байты, если выходной массив позволяет по крайней мере два символа. Encoding.GetChars См. также раздел для дополнительных комментариев.

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

• GetCharCount(Byte[], Int32, Int32)
• Reset()

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

Decoder.cs

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

Decoder.cs

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

Decoder.cs

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

Decoder.cs

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

Decoder.cs

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

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

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

Public Overridable Function GetChars (bytes As Byte(), byteIndex As Integer, byteCount As Integer, chars As Char(), charIndex As Integer, flush As Boolean) As Integer

Параметры

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

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

Исключения

Комментарии

Помните, что Decoder объект сохраняет состояние между вызовами GetChars. Когда приложение выполняется с потоком данных, он должен задать flush параметр, чтобы true убедиться, что сведения о состоянии сбрасываются. С помощью этого параметра декодировщик игнорирует недопустимые байты в конце блока данных и очищает внутренний буфер.

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

Если GetChars вызывается с flush заданным значением false, декодатор сохраняет конечные байты в конце блока данных во внутреннем буфере и использует их в следующей операции декодирования. Приложение должно вызывать GetCharCount блок данных непосредственно перед вызовом GetChars одного блока, чтобы все конечные байты из предыдущего блока были включены в вычисление.

Если приложение предназначено для преобразования множества сегментов входного потока, рассмотрите возможность использования Convert метода. GetChars вызовет исключение, если выходной буфер не достаточно велик, но Convert будет заполнять максимальное пространство и возвращать записанные байты, если выходной массив позволяет по крайней мере два символа. Encoding.GetChars См. также раздел для дополнительных комментариев.

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

• GetCharCount(Byte[], Int32, Int32, Boolean)
• Reset()