Encoding.GetMaxByteCount メソッド
派生クラスでオーバーライドされた場合、指定した文字数をエンコードすることによって生成される最大バイト数を計算します。
名前空間: System.Text
アセンブリ: mscorlib (mscorlib.dll 内)
構文
パラメータ
戻り値
指定した文字数をエンコードすることによって生成される最大バイト数。
例外
解説
使用例
プラットフォーム
バージョン情報
参照
アセンブリ: mscorlib (mscorlib.dll 内)
構文Dim instance As Encoding Dim charCount As Integer Dim returnValue As Integer returnValue = instance.GetMaxByteCount(charCount)
戻り値
指定した文字数をエンコードすることによって生成される最大バイト数。
例外解説charCount パラメータでは、エンコード対象の Unicode 文字を表す Char オブジェクトの数を具体的に指定します。これは、.NET Framework の内部処理で、Unicode 文字の表現に UTF-16 を使用しているためです。したがって、ほとんどの Unicode 文字は 1 つの Char オブジェクトで表現できますが、サロゲート ペアなどで表現される Unicode 文字には 2 つの Char オブジェクトが必要です。
GetBytes が生成したバイトを格納するために必要な正確な配列サイズを計算するには、GetByteCount を使用します。最大配列サイズを計算するには、GetMaxByteCount を使用します。通常、GetMaxByteCount メソッドの方が高速に実行されるのに対し、GetByteCount メソッドの方が使用メモリが少なくて済みます。
実装時の注意 すべての Encoding 実装では、このメソッドの計算結果に従ってバッファ サイズが設定された場合、バッファ オーバーフローによる例外が決して発生しないようにする必要があります。使用例次のコード例では、文字配列のエンコードに必要なバイト数を確認し、文字を実際にエンコードして、結果のバイトを表示します。
Imports System Imports System.Text Imports Microsoft.VisualBasic Public Class SamplesEncoding Public Shared Sub Main() ' The characters to encode: ' 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) ' a high-surrogate value (U+D8FF) ' a low-surrogate value (U+DCFF) Dim myChars() As Char = {"z"c, "a"c, ChrW(&H0306), ChrW(&H01FD), ChrW(&H03B2), ChrW(&HD8FF), ChrW(&HDCFF)} ' Get different encodings. Dim u7 As Encoding = Encoding.UTF7 Dim u8 As Encoding = Encoding.UTF8 Dim u16LE As Encoding = Encoding.Unicode Dim u16BE As Encoding = Encoding.BigEndianUnicode Dim u32 As Encoding = Encoding.UTF32 ' Encode the entire array, and print out the counts and the resulting bytes. PrintCountsAndBytes(myChars, u7) PrintCountsAndBytes(myChars, u8) PrintCountsAndBytes(myChars, u16LE) PrintCountsAndBytes(myChars, u16BE) PrintCountsAndBytes(myChars, u32) End Sub 'Main Public Shared Sub PrintCountsAndBytes(chars() As Char, enc As Encoding) ' Display the name of the encoding used. Console.Write("{0,-30} :", enc.ToString()) ' Display the exact byte count. Dim iBC As Integer = enc.GetByteCount(chars) Console.Write(" {0,-3}", iBC) ' Display the maximum byte count. Dim iMBC As Integer = enc.GetMaxByteCount(chars.Length) Console.Write(" {0,-3} :", iMBC) ' Encode the array of chars. Dim bytes As Byte() = enc.GetBytes(chars) ' Display all the encoded bytes. PrintHexBytes(bytes) End Sub 'PrintCountsAndBytes Public Shared Sub PrintHexBytes(bytes() As Byte) If bytes Is Nothing OrElse bytes.Length = 0 Then Console.WriteLine("<none>") Else Dim i As Integer For i = 0 To bytes.Length - 1 Console.Write("{0:X2} ", bytes(i)) Next i Console.WriteLine() End If End Sub 'PrintHexBytes End Class 'SamplesEncoding 'This code produces the following output. ' 'System.Text.UTF7Encoding : 18 23 :7A 61 2B 41 77 59 42 2F 51 4F 79 32 50 2F 63 2F 77 2D 'System.Text.UTF8Encoding : 12 24 :7A 61 CC 86 C7 BD CE B2 F1 8F B3 BF 'System.Text.UnicodeEncoding : 14 16 :7A 00 61 00 06 03 FD 01 B2 03 FF D8 FF DC 'System.Text.UnicodeEncoding : 14 16 :00 7A 00 61 03 06 01 FD 03 B2 D8 FF DC FF 'System.Text.UTF32Encoding : 24 32 :7A 00 00 00 61 00 00 00 06 03 00 00 FD 01 00 00 B2 03 00 00 FF FC 04 00
using System; using System.Text; public class SamplesEncoding { public static void Main() { // The characters to encode: // 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) // a high-surrogate value (U+D8FF) // a low-surrogate value (U+DCFF) char[] myChars = new char[] { 'z', 'a', '\u0306', '\u01FD', '\u03B2', '\uD8FF', '\uDCFF' }; // Get different encodings. Encoding u7 = Encoding.UTF7; Encoding u8 = Encoding.UTF8; Encoding u16LE = Encoding.Unicode; Encoding u16BE = Encoding.BigEndianUnicode; Encoding u32 = Encoding.UTF32; // Encode the entire array, and print out the counts and the resulting bytes. PrintCountsAndBytes( myChars, u7 ); PrintCountsAndBytes( myChars, u8 ); PrintCountsAndBytes( myChars, u16LE ); PrintCountsAndBytes( myChars, u16BE ); PrintCountsAndBytes( myChars, u32 ); } public static void PrintCountsAndBytes( char[] chars, Encoding enc ) { // Display the name of the encoding used. Console.Write( "{0,-30} :", enc.ToString() ); // Display the exact byte count. int iBC = enc.GetByteCount( chars ); Console.Write( " {0,-3}", iBC ); // Display the maximum byte count. int iMBC = enc.GetMaxByteCount( chars.Length ); Console.Write( " {0,-3} :", iMBC ); // Encode the array of chars. byte[] bytes = enc.GetBytes( chars ); // Display all the encoded bytes. PrintHexBytes( bytes ); } public static void PrintHexBytes( byte[] bytes ) { if (( bytes == null ) || ( bytes.Length == 0 )) Console.WriteLine( "<none>" ); else { for ( int i = 0; i < bytes.Length; i++ ) Console.Write( "{0:X2} ", bytes[i] ); Console.WriteLine(); } } } /* This code produces the following output. System.Text.UTF7Encoding : 18 23 :7A 61 2B 41 77 59 42 2F 51 4F 79 32 50 2F 63 2F 77 2D System.Text.UTF8Encoding : 12 24 :7A 61 CC 86 C7 BD CE B2 F1 8F B3 BF System.Text.UnicodeEncoding : 14 16 :7A 00 61 00 06 03 FD 01 B2 03 FF D8 FF DC System.Text.UnicodeEncoding : 14 16 :00 7A 00 61 03 06 01 FD 03 B2 D8 FF DC FF System.Text.UTF32Encoding : 24 32 :7A 00 00 00 61 00 00 00 06 03 00 00 FD 01 00 00 B2 03 00 00 FF FC 04 00 */
using namespace System; using namespace System::Text; void PrintCountsAndBytes( array<Char>^chars, Encoding^ enc ); void PrintHexBytes( array<Byte>^bytes ); int main() { // The characters to encode: // 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) // a high-surrogate value (U+D8FF) // a low-surrogate value (U+DCFF) array<Char>^myChars = gcnew array<Char>{ L'z','a',L'\u0306',L'\u01FD',L'\u03B2',L'\xD8FF',L'\xDCFF' }; // Get different encodings. Encoding^ u7 = Encoding::UTF7; Encoding^ u8 = Encoding::UTF8; Encoding^ u16LE = Encoding::Unicode; Encoding^ u16BE = Encoding::BigEndianUnicode; Encoding^ u32 = Encoding::UTF32; // Encode the entire array, and print out the counts and the resulting bytes. PrintCountsAndBytes( myChars, u7 ); PrintCountsAndBytes( myChars, u8 ); PrintCountsAndBytes( myChars, u16LE ); PrintCountsAndBytes( myChars, u16BE ); PrintCountsAndBytes( myChars, u32 ); } void PrintCountsAndBytes( array<Char>^chars, Encoding^ enc ) { // Display the name of the encoding used. Console::Write( "{0,-30} :", enc ); // Display the exact byte count. int iBC = enc->GetByteCount( chars ); Console::Write( " {0,-3}", iBC ); // Display the maximum byte count. int iMBC = enc->GetMaxByteCount( chars->Length ); Console::Write( " {0,-3} :", iMBC ); // Encode the array of chars. array<Byte>^bytes = enc->GetBytes( chars ); // Display all the encoded bytes. PrintHexBytes( bytes ); } void PrintHexBytes( array<Byte>^bytes ) { if ( (bytes == nullptr) || (bytes->Length == 0) ) Console::WriteLine( "<none>" ); else { for ( int i = 0; i < bytes->Length; i++ ) Console::Write( "{0:X2} ", bytes[ i ] ); Console::WriteLine(); } } /* This code produces the following output. System.Text.UTF7Encoding : 18 23 :7A 61 2B 41 77 59 42 2F 51 4F 79 32 50 2F 63 2F 77 2D System.Text.UTF8Encoding : 12 24 :7A 61 CC 86 C7 BD CE B2 F1 8F B3 BF System.Text.UnicodeEncoding : 14 16 :7A 00 61 00 06 03 FD 01 B2 03 FF D8 FF DC System.Text.UnicodeEncoding : 14 16 :00 7A 00 61 03 06 01 FD 03 B2 D8 FF DC FF System.Text.UTF32Encoding : 24 32 :7A 00 00 00 61 00 00 00 06 03 00 00 FD 01 00 00 B2 03 00 00 FF FC 04 00 */
import System.*; import System.Text.*; import System.Byte; public class SamplesEncoding { public static void main(String[] args) { // The characters to encode: // 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) // a high-surrogate value (U+D8FF) // a low-surrogate value (U+DCFF) char myChars[] = new char[] { 'z', 'a', '\u0306', '\u01FD', '\u03B2', '\uD8FF', '\uDCFF' }; // Get different encodings. Encoding u7 = Encoding.get_UTF7(); Encoding u8 = Encoding.get_UTF8(); Encoding u16LE = Encoding.get_Unicode(); Encoding u16BE = Encoding.get_BigEndianUnicode(); Encoding u32 = Encoding.get_UTF32(); // Encode the entire array, and print out the counts // and the resulting bytes. PrintCountsAndBytes(myChars, u7); PrintCountsAndBytes(myChars, u8); PrintCountsAndBytes(myChars, u16LE); PrintCountsAndBytes(myChars, u16BE); PrintCountsAndBytes(myChars, u32); } //main public static void PrintCountsAndBytes(char chars[], Encoding enc) { // Display the name of the encoding used. Console.Write("{0,-30} :", enc.toString()); // Display the exact byte count. int iBC = enc.GetByteCount(chars); Console.Write(" {0,-3}", String.valueOf(iBC)); // Display the maximum byte count. int iMBC = enc.GetMaxByteCount(chars.length); Console.Write(" {0,-3} :", String.valueOf(iMBC)); // Encode the array of chars. ubyte bytes[] = enc.GetBytes(chars); // Display all the encoded bytes. PrintHexBytes(bytes); } //PrintCountsAndBytes public static void PrintHexBytes(ubyte bytes[]) { if(bytes == null || bytes.length == 0) { Console.WriteLine("<none>"); } else { for(int i = 0; i < bytes.length; i++) { Console.Write("{0:X2} ", ((System.Byte)bytes[i]).ToString("X2")); } Console.WriteLine(); } } //PrintHexBytes } //SamplesEncoding /* This code produces the following output. System.Text.UTF7Encoding : 18 23 :7A 61 2B 41 77 59 42 2F 51 4F 79 32 50 2F 63 2F 77 2D System.Text.UTF8Encoding : 12 24 :7A 61 CC 86 C7 BD CE B2 F1 8F B3 BF System.Text.UnicodeEncoding : 14 16 :7A 00 61 00 06 03 FD 01 B2 03 FF D8 FF DC System.Text.UnicodeEncoding : 14 16 :00 7A 00 61 03 06 01 FD 03 B2 D8 FF DC FF System.Text.UTF32Encoding : 24 32 :7A 00 00 00 61 00 00 00 06 03 00 00 FD 01 00 00 B2 03 00 00 FF FC 04 00 */
プラットフォーム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 クラス ライブラリ リファレンス」からEncoding.GetMaxByteCount メソッドを検索した結果を表示しています。
Weblioに収録されているすべての辞書からEncoding.GetMaxByteCount メソッドを検索する場合は、下記のリンクをクリックしてください。
全ての辞書からEncoding.GetMaxByteCount メソッド
を検索
Weblioに収録されているすべての辞書からEncoding.GetMaxByteCount メソッドを検索する場合は、下記のリンクをクリックしてください。
全ての辞書からEncoding.GetMaxByteCount メソッド
を検索
- Encoding.GetMaxByteCount メソッドのページへのリンク
