UTF8Encoding.GetMaxCharCount(Int32) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定したバイト数をデコードすることによって生成される最大文字数を計算します。
public:
override int GetMaxCharCount(int byteCount);public override int GetMaxCharCount (int byteCount);override this.GetMaxCharCount : int -> intPublic Overrides Function GetMaxCharCount (byteCount As Integer) As Integerパラメーター
- byteCount
- Int32
デコードするバイト数。
戻り値
指定したバイト数をデコードすることによって生成される最大文字数。
例外
フォールバックが発生しました (詳細については「.NET での文字エンコード」を参照) および DecoderFallback が DecoderExceptionFallback に設定されます。
例
次の例では、メソッドを GetMaxCharCount 使用して、指定したバイト数をデコードすることによって生成される最大文字数を返します。
using namespace System;
using namespace System::Text;
int main()
{
UTF8Encoding^ utf8 = gcnew UTF8Encoding;
int byteCount = 8;
int maxCharCount = utf8->GetMaxCharCount( byteCount );
Console::WriteLine( "Maximum of {0} characters needed to decode {1} bytes.", maxCharCount, byteCount );
}
using System;
using System.Text;
class UTF8EncodingExample {
public static void Main() {
UTF8Encoding utf8 = new UTF8Encoding();
int byteCount = 8;
int maxCharCount = utf8.GetMaxCharCount(byteCount);
Console.WriteLine(
"Maximum of {0} characters needed to decode {1} bytes.",
maxCharCount,
byteCount
);
}
}
Imports System.Text
Class UTF8EncodingExample
Public Shared Sub Main()
Dim utf8 As New UTF8Encoding()
Dim byteCount As Integer = 8
Dim maxCharCount As Integer = utf8.GetMaxCharCount(byteCount)
Console.WriteLine( _
"Maximum of {0} characters needed to decode {1} bytes.", _
maxCharCount, _
byteCount _
)
End Sub
End Class
注釈
結果の文字を格納するために必要な正確な GetChars 配列サイズを計算するには、メソッドを GetCharCount 呼び出します。 配列の最大サイズを計算するには、メソッドを GetMaxCharCount 呼び出します。 通常、このメソッドは割り当てるメモリが少なくなりますが、メソッドの実行速度は GetCharCount 一般的に GetMaxCharCount 速くなります。
GetMaxCharCount は、現在選択されている DecoderFallback最悪のケースを含む、最悪のケースの数値です。 フォールバックが大きい可能性がある文字列で選択された場合は、 GetMaxCharCount 大きな値を返すことができます。
ほとんどの場合、このメソッドは小さな文字列に対して妥当な数値を返します。 大きな文字列の場合は、非常に大きなバッファーを使用して、より合理的なバッファーを超えるまれなケースでエラーをキャッチするかを選択する必要がある場合があります。 またはを使用して別の方法を検討することもでき GetCharCount Encoder.Convert ます。
GetMaxCharCountには関係がありません GetBytes 。 アプリケーションで使用 GetBytesする同様の関数が必要な場合は、使用する必要があります GetMaxByteCount。
注意
GetMaxCharCount(N)はと同じ値であるとは限りません N* GetMaxCharCount(1) 。