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

すべての辞書から再検索する

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

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

Encoding.GetMaxCharCount メソッド

派生クラスでオーバーライドされた場合、指定したバイト数をデコードすることによって生成される最大文字数を計算します。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As Encoding
Dim byteCount As Integer
Dim returnValue As Integer

returnValue = instance.GetMaxCharCount(byteCount)

public abstract int GetMaxCharCount (
    int byteCount
)

C++

public:
virtual int GetMaxCharCount (
    int byteCount
) abstract

public abstract int GetMaxCharCount (
    int byteCount
)

JScript

public abstract function GetMaxCharCount (
    byteCount : int
) : int

パラメータ

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

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

例外

例外の種類	条件
ArgumentOutOfRangeException	byteCount が 0 未満です。

解説

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

実装時の注意 すべての Encoding 実装では、このメソッドの計算結果に従ってバッファサイズが設定された場合、バッファオーバーフローによる例外が決して発生しないようにする必要があります。

使用例

次のコード例は、文字列をバイト配列にエンコードし、そのバイトを文字配列にデコードします。

Visual Basic

Imports System
Imports System.Text
Imports Microsoft.VisualBasic

Public Class SamplesEncoding   

   Public Shared Sub Main()

      ' Create two instances of UTF32Encoding: one with little-endian
 byte order and one with big-endian byte order.
      Dim u32LE As Encoding = Encoding.GetEncoding("utf-32")
      Dim u32BE As Encoding = Encoding.GetEncoding("utf-32BE")

      ' Use a string containing the following characters:
      '    Latin Small Letter Z (U+007A)
      '    Latin Small Letter A (U+0061)
      '    Combining Breve (U+0306)
      '    Latin Small Letter AE With Acute (U+01FD)
      '    Greek Small Letter Beta (U+03B2)
      Dim myStr As String
 = "za" & ChrW(&H0306) & ChrW(&H01FD)
 & ChrW(&H03B2) 

      ' Encode the string using the big-endian byte order.
      ' NOTE: In VB.NET, arrays contain one extra element by default.
      '       The following line creates the array with the exact number
 of elements required.
      Dim barrBE(u32BE.GetByteCount(myStr) - 1) As
 Byte
      u32BE.GetBytes(myStr, 0, myStr.Length, barrBE, 0)

      ' Encode the string using the little-endian byte order.
      ' NOTE: In VB.NET, arrays contain one extra element by default.
      '       The following line creates the array with the exact number
 of elements required.
      Dim barrLE(u32LE.GetByteCount(myStr) - 1) As
 Byte
      u32LE.GetBytes(myStr, 0, myStr.Length, barrLE, 0)

      ' Get the char counts, and decode the byte arrays.
      Console.Write("BE array with BE encoding : ")
      PrintCountsAndChars(barrBE, u32BE)
      Console.Write("LE array with LE encoding : ")
      PrintCountsAndChars(barrLE, u32LE)

   End Sub 'Main


   Public Shared Sub PrintCountsAndChars(bytes()
 As Byte, enc As Encoding)

      ' Display the name of the encoding used.
      Console.Write("{0,-25} :", enc.ToString())

      ' Display the exact character count.
      Dim iCC As Integer
 = enc.GetCharCount(bytes)
      Console.Write(" {0,-3}", iCC)

      ' Display the maximum character count.
      Dim iMCC As Integer
 = enc.GetMaxCharCount(bytes.Length)
      Console.Write(" {0,-3} :", iMCC)

      ' Decode the bytes and display the characters.
      Dim chars As Char()
 = enc.GetChars(bytes)
      Console.WriteLine(chars)

   End Sub 'PrintCountsAndChars
 

End Class 'SamplesEncoding


'This code produces the following output.  The question marks take the
 place of characters that cannot be displayed at the console.
'
'BE array with BE encoding : System.Text.UTF32Encoding : 5   12  :za??
'LE array with LE encoding : System.Text.UTF32Encoding : 5   12  :za??

using System;
using System.Text;

public class SamplesEncoding  {

   public static void Main()
  {

      // Create two instances of UTF32Encoding: one with little-endian
 byte order and one with big-endian byte order.
      Encoding u32LE = Encoding.GetEncoding( "utf-32" );
      Encoding u32BE = Encoding.GetEncoding( "utf-32BE" );

      // Use a string containing the following characters:
      //    Latin Small Letter Z (U+007A)
      //    Latin Small Letter A (U+0061)
      //    Combining Breve (U+0306)
      //    Latin Small Letter AE With Acute (U+01FD)
      //    Greek Small Letter Beta (U+03B2)
      String myStr = "za\u0306\u01FD\u03B2";

      // Encode the string using the big-endian byte order.
      byte[] barrBE = new byte[u32BE.GetByteCount( myStr )];
      u32BE.GetBytes( myStr, 0, myStr.Length, barrBE, 0 );

      // Encode the string using the little-endian byte order.
      byte[] barrLE = new byte[u32LE.GetByteCount( myStr )];
      u32LE.GetBytes( myStr, 0, myStr.Length, barrLE, 0 );

      // Get the char counts, and decode the byte arrays.
      Console.Write( "BE array with BE encoding : " );
      PrintCountsAndChars( barrBE, u32BE );
      Console.Write( "LE array with LE encoding : " );
      PrintCountsAndChars( barrLE, u32LE );

   }


   public static void PrintCountsAndChars(
 byte[] bytes, Encoding enc )  {

      // Display the name of the encoding used.
      Console.Write( "{0,-25} :", enc.ToString() );

      // Display the exact character count.
      int iCC  = enc.GetCharCount( bytes );
      Console.Write( " {0,-3}", iCC );

      // Display the maximum character count.
      int iMCC = enc.GetMaxCharCount( bytes.Length );
      Console.Write( " {0,-3} :", iMCC );

      // Decode the bytes and display the characters.
      char[] chars = enc.GetChars( bytes );
      Console.WriteLine( chars );

   }

}


/* 
This code produces the following output.  The question marks take the place of characters
 that cannot be displayed at the console.

BE array with BE encoding : System.Text.UTF32Encoding : 5   12  :za??
LE array with LE encoding : System.Text.UTF32Encoding : 5   12  :za??

*/

C++

using namespace System;
using namespace System::Text;
void PrintCountsAndChars( array<Byte>^bytes, Encoding^ enc
 );
int main()
{
   
   // Create two instances of UTF32Encoding: one with little-endian
 byte order and one with big-endian byte order.
   Encoding^ u32LE = Encoding::GetEncoding( "utf-32" );
   Encoding^ u32BE = Encoding::GetEncoding( "utf-32BE" );
   
   // Use a string containing the following characters:
   //    Latin Small Letter Z (U+007A)
   //    Latin Small Letter A (U+0061)
   //    Combining Breve (U+0306)
   //    Latin Small Letter AE With Acute (U+01FD)
   //    Greek Small Letter Beta (U+03B2)
   String^ myStr = "za\u0306\u01FD\u03B2";
   
   // Encode the string using the big-endian byte order.
   array<Byte>^barrBE = gcnew array<Byte>(u32BE->GetByteCount( myStr
 ));
   u32BE->GetBytes( myStr, 0, myStr->Length, barrBE, 0 );
   
   // Encode the string using the little-endian byte order.
   array<Byte>^barrLE = gcnew array<Byte>(u32LE->GetByteCount( myStr
 ));
   u32LE->GetBytes( myStr, 0, myStr->Length, barrLE, 0 );
   
   // Get the char counts, and decode the byte arrays.
   Console::Write( "BE array with BE encoding : " );
   PrintCountsAndChars( barrBE, u32BE );
   Console::Write( "LE array with LE encoding : " );
   PrintCountsAndChars( barrLE, u32LE );
}

void PrintCountsAndChars( array<Byte>^bytes, Encoding^ enc
 )
{
   
   // Display the name of the encoding used.
   Console::Write( "{0,-25} :", enc );
   
   // Display the exact character count.
   int iCC = enc->GetCharCount( bytes );
   Console::Write( " {0,-3}", iCC );
   
   // Display the maximum character count.
   int iMCC = enc->GetMaxCharCount( bytes->Length );
   Console::Write( " {0,-3} :", iMCC );
   
   // Decode the bytes and display the characters.
   array<Char>^chars = enc->GetChars( bytes );
   Console::WriteLine( chars );
}

/* 
This code produces the following output.  The question marks take the place of characters
 that cannot be displayed at the console.

BE array with BE encoding : System.Text.UTF32Encoding : 5   12  :za??
LE array with LE encoding : System.Text.UTF32Encoding : 5   12  :za??

*/

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

public class SamplesEncoding
{
    public static void main(String[]
 args)
    {
        // Create two instances of UTF32Encoding: one with little-endian
        // byte order and one with big-endian byte order.
        Encoding u32LE = Encoding.GetEncoding("utf-32");
        Encoding u32BE = Encoding.GetEncoding("utf-32BE");

        // Use a string containing the following characters:
        //    Latin Small Letter Z (U+007A)
        //    Latin Small Letter A (U+0061)
        //    Combining Breve (U+0306)
        //    Latin Small Letter AE With Acute (U+01FD)
        //    Greek Small Letter Beta (U+03B2)
        String myStr = "za\u0306\u01FD\u03B2";

        // Encode the string using the big-endian byte order.
        ubyte barrBE[] = new ubyte[u32BE.GetByteCount(myStr)];
        u32BE.GetBytes(myStr, 0, myStr.get_Length(), barrBE, 0);

        // Encode the string using the little-endian byte order.
        ubyte barrLE[] = new ubyte[u32LE.GetByteCount(myStr)];
        u32LE.GetBytes(myStr, 0, myStr.get_Length(), barrLE, 0);

        // Get the char counts, and decode the byte arrays.
        Console.Write("BE array with BE encoding : ");
        PrintCountsAndChars(barrBE, u32BE);
        Console.Write("LE array with LE encoding : ");
        PrintCountsAndChars(barrLE, u32LE);
    } //main

    public static void PrintCountsAndChars(ubyte
 bytes[], Encoding enc)
    {
        // Display the name of the encoding used.
        Console.Write("{0,-25} :", enc.ToString());

        // Display the exact character count.
        int iCC = enc.GetCharCount(bytes);
        Console.Write(" {0,-3}", String.valueOf(iCC));

        // Display the maximum character count.
        int iMCC = enc.GetMaxCharCount(bytes.length);
        Console.Write(" {0,-3} :", String.valueOf(iMCC));

        // Decode the bytes and display the characters.
        char chars[] = enc.GetChars(bytes);
        Console.WriteLine(chars);
    } //PrintCountsAndChars
} //SamplesEncoding 

/* 
This code produces the following output.  The question marks take the place
 of characters that cannot be displayed at the console.

BE array with BE encoding : System.Text.UTF32Encoding : 5   12  :za??
LE array with LE encoding : System.Text.UTF32Encoding : 5   12  :za??

*/

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Encoding クラス
Encoding メンバ
System.Text 名前空間
GetChars
GetString
GetCharCount
GetDecoder

このページでは「.NET Framework クラスライブラリリファレンス」からEncoding.GetMaxCharCount メソッドを検索した結果を表示しています。
Weblioに収録されているすべての辞書からEncoding.GetMaxCharCount メソッドを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からEncoding.GetMaxCharCount メソッドを検索

>> 「Encoding.GetMaxCharCount メソッド」を含む用語の索引
Encoding.GetMaxCharCount メソッドのページへのリンク


	© 2025 Microsoft.All rights reserved.

Encoding.GetMaxCharCount メソッドとは？ わかりやすく解説

Encoding.GetMaxCharCount メソッド

急上昇のことば

Encoding.GetMaxCharCount メソッドとは？わかりやすく解説