ASCIIEncoding.GetCharCount Метод

Определение

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

System.Text

Сборка:

System.Text.Encoding.Extensions.dll

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

Перегрузки

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

GetCharCount(Byte*, Int32)

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

ASCIIEncoding.cs

Важно!

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

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

System.Text.ASCIIEncoding.GetCharCount(Byte[], Int32, Int32)

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

public:
 override int GetCharCount(System::Byte* bytes, int count);

[System.CLSCompliant(false)]
public override int GetCharCount (byte* bytes, int count);

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

Параметры

bytes

Byte*

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

count

Int32

Количество байтов, которые необходимо декодировать.

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

Int32

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

Атрибуты

CLSCompliantAttribute

Исключения

ArgumentNullException

bytes null.

ArgumentOutOfRangeException

count меньше нуля.

-или-

Результирующее число байтов больше максимального числа, которое может быть возвращено в виде целого числа.

DecoderFallbackException

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

-и-

DecoderFallback имеет значение DecoderExceptionFallback.

Комментарии

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

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

• GetChars
• GetMaxCharCount(Int32)
• GetDecoder()

GetCharCount(Byte[], Int32, Int32)

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

ASCIIEncoding.cs

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

public:
 override int GetCharCount(cli::array <System::Byte> ^ bytes, int index, int count);

public override int GetCharCount (byte[] bytes, int index, int count);

override this.GetCharCount : byte[] * int * int -> int

Public Overrides Function GetCharCount (bytes As Byte(), index As Integer, count As Integer) As Integer

Параметры

bytes

Byte[]

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

index

Int32

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

count

Int32

Количество байтов, которые необходимо декодировать.

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

Int32

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

Исключения

ArgumentNullException

bytes null.

ArgumentOutOfRangeException

index или count меньше нуля.

-или-

index и count не указывают допустимый диапазон в bytes.

-или-

Результирующее число байтов больше максимального числа, которое может быть возвращено в виде целого числа.

DecoderFallbackException

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

-и-

DecoderFallback имеет значение DecoderExceptionFallback.

Примеры

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

using namespace System;
using namespace System::Text;
int main()
{
   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 );
   Console::WriteLine( "{0} characters needed to decode bytes.", charCount );
}

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        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);
        Console.WriteLine(
            "{0} characters needed to decode bytes.", charCount
        );
    }
}

Imports System.Text

Class ASCIIEncodingExample
    Public Shared Sub Main()
        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)
        Console.WriteLine("{0} characters needed to decode bytes.", charCount)
    End Sub
End Class

Комментарии

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

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

• GetChars
• GetMaxCharCount(Int32)
• GetDecoder()

GetCharCount(ReadOnlySpan<Byte>)

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

ASCIIEncoding.cs

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

public:
 override int GetCharCount(ReadOnlySpan<System::Byte> bytes);

public override int GetCharCount (ReadOnlySpan<byte> bytes);

override this.GetCharCount : ReadOnlySpan<byte> -> int

Public Overrides Function GetCharCount (bytes As ReadOnlySpan(Of Byte)) As Integer

Параметры

bytes

ReadOnlySpan<Byte>

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

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

Int32

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

Комментарии

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