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

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

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

UnicodeEncoding.GetMaxByteCount メソッド

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

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

Visual Basic (宣言)

Public Overrides Function
 GetMaxByteCount ( _
    charCount As Integer _
) As Integer

Visual Basic (使用法)

Dim instance As UnicodeEncoding
Dim charCount As Integer
Dim returnValue As Integer

returnValue = instance.GetMaxByteCount(charCount)

public override int GetMaxByteCount (
    int charCount
)

C++

public:
virtual int GetMaxByteCount (
    int charCount
) override

public int GetMaxByteCount (
    int charCount
)

JScript

public override function GetMaxByteCount (
    charCount : int
) : int

パラメータ

charCount: エンコードする文字数。

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

例外

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

例外の種類

条件

ArgumentOutOfRangeException

charCount が 0 未満です。

または

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

解説

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

使用例

次のコード例は、指定した文字数をエンコードするために必要な最大バイト数を、GetMaxByteCount メソッドを使用して計算する方法を示しています。

Visual Basic

Imports System
Imports System.Text

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        Dim uni As New UnicodeEncoding()
        Dim charCount As Integer
 = 2
        Dim maxByteCount As Integer
 = uni.GetMaxByteCount(charCount)
        Console.WriteLine("Maximum of {0} bytes needed to encode
 {1} characters.", maxByteCount, charCount)
    End Sub 'Main
End Class 'UnicodeEncodingExample

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main()
 {
        UnicodeEncoding Unicode = new UnicodeEncoding();
        int charCount = 2;
        int maxByteCount = Unicode.GetMaxByteCount(charCount);
        Console.WriteLine(
            "Maximum of {0} bytes needed to encode {1} characters.",
            maxByteCount,
            charCount
        );
    }
}

C++

using namespace System;
using namespace System::Text;
int main()
{
   UnicodeEncoding^ Unicode = gcnew UnicodeEncoding;
   int charCount = 2;
   int maxByteCount = Unicode->GetMaxByteCount( charCount );
   Console::WriteLine( "Maximum of {0} bytes needed to encode {1} characters.",
 maxByteCount, charCount );
}

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

class UnicodeEncodingExample
{
    public static void main(String[]
 args)
    {
        UnicodeEncoding unicode = new UnicodeEncoding();
        int charCount = 2;
        int maxByteCount = unicode.GetMaxByteCount(charCount);
        Console.WriteLine(
            "Maximum of {0} bytes needed to encode {1} characters.",
            String.valueOf(maxByteCount), String.valueOf(charCount));
    } //main
} //UnicodeEncodingExample