UnicodeEncoding.GetMaxCharCount メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

UnicodeEncoding.GetMaxCharCount メソッド

指定したバイト数をデコードすることによって生成される最大文字数を計算します。

名前空間: System.Text
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Overrides Function
 GetMaxCharCount ( _
    byteCount As Integer _
) As Integer

Visual Basic (使用法)

Dim instance As UnicodeEncoding
Dim byteCount As Integer
Dim returnValue As Integer

returnValue = instance.GetMaxCharCount(byteCount)

public override int GetMaxCharCount (
    int byteCount
)

C++

public:
virtual int GetMaxCharCount (
    int byteCount
) override

public int GetMaxCharCount (
    int byteCount
)

JScript

public override function GetMaxCharCount (
    byteCount : int
) : int

パラメータ

byteCount: デコードするバイト数。

戻り値
指定したバイト数をデコードすることによって生成される最大文字数。

例外

例外の種類	条件
ArgumentOutOfRangeException	byteCount が 0 未満です。または結果のバイト数が、int として返すことのできる最大数を超えています。

例外の種類

条件

ArgumentOutOfRangeException

byteCount が 0 未満です。

または

結果のバイト数が、int として返すことのできる最大数を超えています。

解説

GetChars が生成した文字を格納するために必要な正確な配列サイズを計算するには、GetCharCount を使用します。最大配列サイズを計算するには、GetMaxCharCount を使用します。通常、GetMaxCharCount メソッドの方が高速に実行されるのに対し、GetCharCount メソッドの方が使用メモリが少なくて済みます。

使用例

次のコード例は、指定したバイト数をデコードすることによって生成される最大文字数を、GetMaxCharCount メソッドを使用して計算する方法を示しています。

Visual Basic

Imports System
Imports System.Text

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        Dim uni As New UnicodeEncoding()
        Dim byteCount As Integer
 = 8
        Dim maxCharCount As Integer
 = uni.GetMaxCharCount(byteCount)
        Console.WriteLine("Maximum of {0} characters needed to
 decode {1} bytes.", maxCharCount, byteCount)
    End Sub 'Main
End Class 'UnicodeEncodingExample

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main()
 {
        UnicodeEncoding Unicode = new UnicodeEncoding();
        int byteCount = 8;
        int maxCharCount = Unicode.GetMaxCharCount(byteCount);
        Console.WriteLine(
            "Maximum of {0} characters needed to decode {1} bytes.",
            maxCharCount,
            byteCount
        );
    }
}

C++

using namespace System;
using namespace System::Text;
int main()
{
   UnicodeEncoding^ Unicode = gcnew UnicodeEncoding;
   int byteCount = 8;
   int maxCharCount = Unicode->GetMaxCharCount( byteCount );
   Console::WriteLine( "Maximum of {0} characters needed to decode {1} bytes.",
 maxCharCount, byteCount );
}

import System.*;
import System.Text.*;

class UnicodeEncodingExample
{
    public static void main(String[]
 args)
    {
        UnicodeEncoding unicode =  new UnicodeEncoding();
        int byteCount = 8;
        int maxCharCount = unicode.GetMaxCharCount(byteCount);
        Console.WriteLine(
            "Maximum of {0} characters needed to decode {1} bytes.", 
            String.valueOf(maxCharCount), String.valueOf(byteCount));
    } //main
} //UnicodeEncodingExample