Encoding.GetCharCount メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
派生クラスでオーバーライドされた場合、バイト シーケンスをデコードすることによって生成される文字数を計算します。
オーバーロード
| GetCharCount(Byte[]) |
派生クラスでオーバーライドされた場合、指定したバイト配列に格納されているすべてのバイトをデコードすることによって生成される文字数を計算します。 |
| GetCharCount(ReadOnlySpan<Byte>) |
派生クラスでオーバーライドされた場合、指定した読み取り専用バイト スパンをデコードすることによって生成される文字数を計算します。 |
| GetCharCount(Byte*, Int32) |
派生クラスでオーバーライドされた場合、指定したバイト ポインターから始まるバイト シーケンスをデコードすることによって生成される文字数を計算します。 |
| GetCharCount(Byte[], Int32, Int32) |
派生クラスでオーバーライドされた場合、指定したバイト配列に格納されているバイト シーケンスをデコードすることによって生成される文字数を計算します。 |
GetCharCount(Byte[])
派生クラスでオーバーライドされた場合、指定したバイト配列に格納されているすべてのバイトをデコードすることによって生成される文字数を計算します。
public:
virtual int GetCharCount(cli::array <System::Byte> ^ bytes);public virtual int GetCharCount (byte[] bytes);abstract member GetCharCount : byte[] -> int
override this.GetCharCount : byte[] -> intPublic Overridable Function GetCharCount (bytes As Byte()) As Integerパラメーター
- bytes
- Byte[]
デコード対象のバイト シーケンスが格納されたバイト配列。
戻り値
指定したバイト シーケンスをデコードすることによって生成される文字数。
例外
bytes が nullです。
例
次の例では、文字列をバイト配列にエンコードし、バイトを文字配列にデコードします。
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 :zăǽβ
LE array with LE encoding : System.Text.UTF32Encoding : 5 12 :zăǽβ
*/
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 :zăǽβ
LE array with LE encoding : System.Text.UTF32Encoding : 5 12 :zăǽβ
*/
Imports System.Text
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
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
End Class
'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 :zăǽβ
'LE array with LE encoding : System.Text.UTF32Encoding : 5 12 :zăǽβ
注釈
が結果の文字を格納するために必要な配列の正確なサイズを計算するには、 GetChars(Byte[]) メソッドを使用する必要があり GetCharCount(Byte[]) ます。 配列の最大サイズを計算するには、メソッドを使用する必要があり GetMaxCharCount(Int32) ます。 メソッドは一般に、より GetCharCount(Byte[]) 少ないメモリの割り当てを可能にしますが、 GetMaxCharCount メソッドは通常、より高速に実行されます。
メソッドは、 GetCharCount(Byte[]) バイトシーケンスをデコードする文字数を決定し、メソッドは GetChars(Byte[]) 実際のデコードを実行します。 メソッドは、 Encoding.GetChars Decoder.GetChars 1 つの入力ストリームに対して複数のパスを処理するメソッドとは対照的に、離散変換を必要とします。
とのいくつかのバージョン GetCharCount GetChars がサポートされています。 これらのメソッドを使用するためのプログラミング上の考慮事項を次に示します。
アプリでは、複数の呼び出しを使用して、コードページから複数の入力バイトをデコードし、バイトを処理することが必要になる場合があります。 この場合、呼び出しの間で状態を維持する必要があります。
アプリが文字列出力を処理する場合は、メソッドを使用する必要があり GetString ます。 このメソッドは文字列の長さを確認してバッファーを割り当てる必要があるため、少し遅くなりますが、結果の String 型が優先されます。
のバイトバージョンでは GetChars(Byte*, Int32, Char*, Int32) 、特に大きなバッファーを複数回呼び出す場合に、いくつかの高速な手法が許可されます。 ただし、ポインターが必要であるため、このメソッドのバージョンは安全でない場合があることに注意してください。
アプリで大量のデータを変換する必要がある場合は、出力バッファーを再利用する必要があります。 この場合、 GetChars(Byte[], Int32, Int32, Char[], Int32) 出力文字バッファーをサポートするバージョンが最適な選択肢です。
ではなく、メソッドを使用することを検討してください Decoder.Convert GetCharCount 。 変換メソッドは、可能な限り多くのデータを変換し、出力バッファーが小さすぎる場合は例外をスローします。 ストリームを連続してデコードする場合は、この方法が最適な選択肢です。
こちらもご覧ください
適用対象
GetCharCount(ReadOnlySpan<Byte>)
派生クラスでオーバーライドされた場合、指定した読み取り専用バイト スパンをデコードすることによって生成される文字数を計算します。
public:
virtual int GetCharCount(ReadOnlySpan<System::Byte> bytes);public virtual int GetCharCount (ReadOnlySpan<byte> bytes);abstract member GetCharCount : ReadOnlySpan<byte> -> int
override this.GetCharCount : ReadOnlySpan<byte> -> intPublic Overridable Function GetCharCount (bytes As ReadOnlySpan(Of Byte)) As Integerパラメーター
- bytes
- ReadOnlySpan<Byte>
デコードする読み取り専用バイト スパン。
戻り値
バイト スパンをデコードすることによって生成される文字数。
注釈
結果の文字を格納するために必要な配列の正確なサイズを計算するには、 GetChars メソッドを使用する必要があり GetCharCount ます。 配列の最大サイズを計算するには、メソッドを使用し GetMaxCharCount ます。 メソッドは一般に、より GetCharCount 少ないメモリの割り当てを可能にしますが、 GetMaxCharCount メソッドは通常、より高速に実行されます。
メソッドは、 GetCharCount バイトシーケンスをデコードする文字数を決定し、メソッドは GetChars 実際のデコードを実行します。 メソッドは、 GetChars Decoder.GetChars 1 つの入力ストリームに対して複数のパスを処理するメソッドとは対照的に、離散変換を必要とします。
とのいくつかのバージョン GetCharCount GetChars がサポートされています。 これらのメソッドを使用するためのプログラミング上の考慮事項を次に示します。
アプリでは、複数の呼び出しを使用して、コードページから複数の入力バイトをデコードし、バイトを処理することが必要になる場合があります。 この場合、呼び出しの間で状態を維持する必要があります。
アプリが文字列出力を処理する場合は、メソッドを使用することをお勧め GetString します。 このメソッドは文字列の長さを確認してバッファーを割り当てる必要があるため、少し遅くなりますが、結果の String 型が優先されます。
アプリで大量のデータを変換する必要がある場合は、出力バッファーを再利用する必要があります。 この場合、 GetChars(Byte[], Int32, Int32, Char[], Int32) 出力文字バッファーをサポートするバージョンが最適な選択肢です。
ではなく、メソッドを使用することを検討してください Decoder.Convert GetCharCount 。 変換メソッドは、可能な限り多くのデータを変換し、出力バッファーが小さすぎる場合は例外をスローします。 ストリームを連続してデコードする場合は、この方法が最適な選択肢です。
適用対象
GetCharCount(Byte*, Int32)
重要
この API は CLS 準拠ではありません。
派生クラスでオーバーライドされた場合、指定したバイト ポインターから始まるバイト シーケンスをデコードすることによって生成される文字数を計算します。
public:
virtual int GetCharCount(System::Byte* bytes, int count);[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public virtual int GetCharCount (byte* bytes, int count);[System.CLSCompliant(false)]
public virtual int GetCharCount (byte* bytes, int count);public virtual int GetCharCount (byte* bytes, int count);[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public virtual int GetCharCount (byte* bytes, int count);[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(false)]
public virtual int GetCharCount (byte* bytes, int count);[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
abstract member GetCharCount : nativeptr<byte> * int -> int
override this.GetCharCount : nativeptr<byte> * int -> int[<System.CLSCompliant(false)>]
abstract member GetCharCount : nativeptr<byte> * int -> int
override this.GetCharCount : nativeptr<byte> * int -> intabstract member GetCharCount : nativeptr<byte> * int -> int
override this.GetCharCount : nativeptr<byte> * int -> int[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member GetCharCount : nativeptr<byte> * int -> int
override this.GetCharCount : nativeptr<byte> * int -> int[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member GetCharCount : nativeptr<byte> * int -> int
override this.GetCharCount : nativeptr<byte> * int -> intパラメーター
- bytes
- Byte*
デコードする最初のバイトへのポインター。
- count
- Int32
デコードするバイト数。
戻り値
指定したバイト シーケンスをデコードすることによって生成される文字数。
- 属性
例外
bytes が nullです。
count が 0 未満です。
注釈
結果の文字を格納するために必要な配列の正確なサイズを計算するには、 GetChars メソッドを使用する必要があり GetCharCount ます。 配列の最大サイズを計算するには、メソッドを使用し GetMaxCharCount ます。 メソッドは一般に、より GetCharCount 少ないメモリの割り当てを可能にしますが、 GetMaxCharCount メソッドは通常、より高速に実行されます。
メソッドは、 GetCharCount バイトシーケンスをデコードする文字数を決定し、メソッドは GetChars 実際のデコードを実行します。 メソッドは、 GetChars Decoder.GetChars 1 つの入力ストリームに対して複数のパスを処理するメソッドとは対照的に、離散変換を必要とします。
とのいくつかのバージョン GetCharCount GetChars がサポートされています。 これらのメソッドを使用するためのプログラミング上の考慮事項を次に示します。
アプリでは、複数の呼び出しを使用して、コードページから複数の入力バイトをデコードし、バイトを処理することが必要になる場合があります。 この場合、呼び出しの間で状態を維持する必要があります。
アプリが文字列出力を処理する場合は、メソッドを使用することをお勧め GetString します。 このメソッドは文字列の長さを確認してバッファーを割り当てる必要があるため、少し遅くなりますが、結果の String 型が優先されます。
のバイトバージョンでは GetChars(Byte*, Int32, Char*, Int32) 、特に大きなバッファーを複数回呼び出す場合に、いくつかの高速な手法が許可されます。 ただし、ポインターが必要であるため、このメソッドのバージョンは安全でない場合があることに注意してください。
アプリで大量のデータを変換する必要がある場合は、出力バッファーを再利用する必要があります。 この場合、 GetChars(Byte[], Int32, Int32, Char[], Int32) 出力文字バッファーをサポートするバージョンが最適な選択肢です。
ではなく、メソッドを使用することを検討してください Decoder.Convert GetCharCount 。 変換メソッドは、可能な限り多くのデータを変換し、出力バッファーが小さすぎる場合は例外をスローします。 ストリームを連続してデコードする場合は、この方法が最適な選択肢です。
こちらもご覧ください
適用対象
GetCharCount(Byte[], Int32, Int32)
派生クラスでオーバーライドされた場合、指定したバイト配列に格納されているバイト シーケンスをデコードすることによって生成される文字数を計算します。
public:
abstract int GetCharCount(cli::array <System::Byte> ^ bytes, int index, int count);public abstract int GetCharCount (byte[] bytes, int index, int count);abstract member GetCharCount : byte[] * int * int -> intPublic MustOverride Function GetCharCount (bytes As Byte(), index As Integer, count As Integer) As Integerパラメーター
- bytes
- Byte[]
デコード対象のバイト シーケンスが格納されたバイト配列。
- index
- Int32
デコードする最初のバイトのインデックス。
- count
- Int32
デコードするバイト数。
戻り値
指定したバイト シーケンスをデコードすることによって生成される文字数。
例外
bytes が nullです。
index または count が 0 未満です。
または
index および count は bytes において有効な範囲を表していません。
例
次の例では、あるエンコードから別のエンコーディングに文字列を変換します。
using namespace System;
using namespace System::Text;
int main()
{
String^ unicodeString = "This string contains the unicode character Pi (\u03a0)";
// Create two different encodings.
Encoding^ ascii = Encoding::ASCII;
Encoding^ unicode = Encoding::Unicode;
// Convert the string into a byte array.
array<Byte>^unicodeBytes = unicode->GetBytes( unicodeString );
// Perform the conversion from one encoding to the other.
array<Byte>^asciiBytes = Encoding::Convert( unicode, ascii, unicodeBytes );
// Convert the new Byte into[] a char and[] then into a string.
array<Char>^asciiChars = gcnew array<Char>(ascii->GetCharCount( asciiBytes, 0, asciiBytes->Length ));
ascii->GetChars( asciiBytes, 0, asciiBytes->Length, asciiChars, 0 );
String^ asciiString = gcnew String( asciiChars );
// Display the strings created before and after the conversion.
Console::WriteLine( "Original String*: {0}", unicodeString );
Console::WriteLine( "Ascii converted String*: {0}", asciiString );
}
// The example displays the following output:
// Original string: This string contains the unicode character Pi (Π)
// Ascii converted string: This string contains the unicode character Pi (?)
using System;
using System.Text;
class Example
{
static void Main()
{
string unicodeString = "This string contains the unicode character Pi (\u03a0)";
// Create two different encodings.
Encoding ascii = Encoding.ASCII;
Encoding unicode = Encoding.Unicode;
// Convert the string into a byte array.
byte[] unicodeBytes = unicode.GetBytes(unicodeString);
// Perform the conversion from one encoding to the other.
byte[] asciiBytes = Encoding.Convert(unicode, ascii, unicodeBytes);
// Convert the new byte[] into a char[] and then into a string.
char[] asciiChars = new char[ascii.GetCharCount(asciiBytes, 0, asciiBytes.Length)];
ascii.GetChars(asciiBytes, 0, asciiBytes.Length, asciiChars, 0);
string asciiString = new string(asciiChars);
// Display the strings created before and after the conversion.
Console.WriteLine("Original string: {0}", unicodeString);
Console.WriteLine("Ascii converted string: {0}", asciiString);
}
}
// The example displays the following output:
// Original string: This string contains the unicode character Pi (Π)
// Ascii converted string: This string contains the unicode character Pi (?)
Imports System.Text
Class Example
Shared Sub Main()
Dim unicodeString As String = "This string contains the unicode character Pi (" & ChrW(&H03A0) & ")"
' Create two different encodings.
Dim ascii As Encoding = Encoding.ASCII
Dim unicode As Encoding = Encoding.Unicode
' Convert the string into a byte array.
Dim unicodeBytes As Byte() = unicode.GetBytes(unicodeString)
' Perform the conversion from one encoding to the other.
Dim asciiBytes As Byte() = Encoding.Convert(unicode, ascii, unicodeBytes)
' Convert the new byte array into a char array and then into a string.
Dim asciiChars(ascii.GetCharCount(asciiBytes, 0, asciiBytes.Length)-1) As Char
ascii.GetChars(asciiBytes, 0, asciiBytes.Length, asciiChars, 0)
Dim asciiString As New String(asciiChars)
' Display the strings created before and after the conversion.
Console.WriteLine("Original string: {0}", unicodeString)
Console.WriteLine("Ascii converted string: {0}", asciiString)
End Sub
End Class
' The example displays the following output:
' Original string: This string contains the unicode character Pi (Π)
' Ascii converted string: This string contains the unicode character Pi (?)
次の例では、文字列をバイト配列にエンコードした後、バイトの範囲を文字配列にデコードします。
using namespace System;
using namespace System::Text;
void PrintCountsAndChars( array<Byte>^bytes, int index, int count, 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, decode eight bytes starting at index 0,
// and print out the counts and the resulting bytes.
Console::Write( "BE array with BE encoding : " );
PrintCountsAndChars( barrBE, 0, 8, u32BE );
Console::Write( "LE array with LE encoding : " );
PrintCountsAndChars( barrLE, 0, 8, u32LE );
}
void PrintCountsAndChars( array<Byte>^bytes, int index, int count, Encoding^ enc )
{
// Display the name of the encoding used.
Console::Write( "{0,-25} :", enc );
// Display the exact character count.
int iCC = enc->GetCharCount( bytes, index, count );
Console::Write( " {0,-3}", iCC );
// Display the maximum character count.
int iMCC = enc->GetMaxCharCount( count );
Console::Write( " {0,-3} :", iMCC );
// Decode the bytes and display the characters.
array<Char>^chars = enc->GetChars( bytes, index, count );
// The following is an alternative way to decode the bytes:
// Char[] chars = new Char[iCC];
// enc->GetChars( bytes, index, count, chars, 0 );
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 : 2 6 :za
LE array with LE encoding : System.Text.UTF32Encoding : 2 6 :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, decode eight bytes starting at index 0,
// and print out the counts and the resulting bytes.
Console.Write( "BE array with BE encoding : " );
PrintCountsAndChars( barrBE, 0, 8, u32BE );
Console.Write( "LE array with LE encoding : " );
PrintCountsAndChars( barrLE, 0, 8, u32LE );
}
public static void PrintCountsAndChars( byte[] bytes, int index, int count, 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, index, count );
Console.Write( " {0,-3}", iCC );
// Display the maximum character count.
int iMCC = enc.GetMaxCharCount( count );
Console.Write( " {0,-3} :", iMCC );
// Decode the bytes and display the characters.
char[] chars = enc.GetChars( bytes, index, count );
// The following is an alternative way to decode the bytes:
// char[] chars = new char[iCC];
// enc.GetChars( bytes, index, count, chars, 0 );
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 : 2 6 :za
LE array with LE encoding : System.Text.UTF32Encoding : 2 6 :za
*/
Imports System.Text
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 barrBE 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 barrLE 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, decode eight bytes starting at index 0,
' and print out the counts and the resulting bytes.
Console.Write("BE array with BE encoding : ")
PrintCountsAndChars(barrBE, 0, 8, u32BE)
Console.Write("LE array with LE encoding : ")
PrintCountsAndChars(barrLE, 0, 8, u32LE)
End Sub
Public Shared Sub PrintCountsAndChars(bytes() As Byte, index As Integer, count As Integer, 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, index, count)
Console.Write(" {0,-3}", iCC)
' Display the maximum character count.
Dim iMCC As Integer = enc.GetMaxCharCount(count)
Console.Write(" {0,-3} :", iMCC)
' Decode the bytes.
Dim chars As Char() = enc.GetChars(bytes, index, count)
' The following is an alternative way to decode the bytes:
' 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 chars(iCC - 1) As Char
' enc.GetChars( bytes, index, count, chars, 0 )
' Display the characters.
Console.WriteLine(chars)
End Sub
End Class
'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 : 2 6 :za
'LE array with LE encoding : System.Text.UTF32Encoding : 2 6 :za
注釈
が結果の文字を格納するために必要な配列の正確なサイズを計算するには、 GetChars メソッドを使用する必要があり GetCharCount ます。 配列の最大サイズを計算するには、メソッドを使用し GetMaxCharCount ます。 メソッドは一般に、より GetCharCount 少ないメモリの割り当てを可能にしますが、 GetMaxCharCount メソッドは通常、より高速に実行されます。
メソッドは、 GetCharCount バイトシーケンスをデコードする文字数を決定し、メソッドは GetChars 実際のデコードを実行します。 メソッドは、 GetChars Decoder.GetChars 1 つの入力ストリームに対して複数のパスを処理するメソッドとは対照的に、離散変換を必要とします。
とのいくつかのバージョン GetCharCount GetChars がサポートされています。 これらのメソッドを使用するためのプログラミング上の考慮事項を次に示します。
アプリでは、複数の呼び出しを使用して、コードページから複数の入力バイトをデコードし、バイトを処理することが必要になる場合があります。 この場合、呼び出しの間で状態を維持する必要があります。
アプリが文字列出力を処理する場合は、メソッドを使用することをお勧め GetString します。 このメソッドは文字列の長さを確認してバッファーを割り当てる必要があるため、少し遅くなりますが、結果の String 型が優先されます。
のバイトバージョンでは GetChars(Byte*, Int32, Char*, Int32) 、特に大きなバッファーを複数回呼び出す場合に、いくつかの高速な手法が許可されます。 ただし、ポインターが必要であるため、このメソッドのバージョンは安全でない場合があることに注意してください。
アプリで大量のデータを変換する必要がある場合は、出力バッファーを再利用する必要があります。 この場合、 GetChars(Byte[], Int32, Int32, Char[], Int32) 出力文字バッファーをサポートするバージョンが最適な選択肢です。
ではなく、メソッドを使用することを検討してください Decoder.Convert GetCharCount 。 変換メソッドは、可能な限り多くのデータを変換し、出力バッファーが小さすぎる場合は例外をスローします。 ストリームを連続してデコードする場合は、この方法が最適な選択肢です。