UTF32Encoding クラス
アセンブリ: mscorlib (mscorlib.dll 内)
構文解説エンコーディングは、Unicode 文字のセットをバイト シーケンスに変換するプロセスです。デコードはその逆になります。エンコードされたバイト シーケンスを Unicode 文字のセットに変換するプロセスです。
Unicode Standard では、サポートされるすべてのスクリプトについて、各文字にコード ポイント (数値) を割り当てています。コード ポイントのエンコードには UTF (Unicode Transformation Format) が使用されます。Unicode Standard バージョン 3.2 では、次の UTF が使用されています。
GetByteCount メソッドは、Unicode 文字のセットをエンコードした結果得られるバイト数を確認します。実際のエンコードは、GetBytes メソッドによって実行されます。
同様に、GetCharCount メソッドは、バイト シーケンスをデコードした結果得られる文字数を確認します。実際のデコードは、GetChars メソッドと GetString メソッドによって実行されます。
エンコーダでは、最上位バイトが先頭に配置されるビッグ エンディアン バイト順、または最下位バイトが先頭に配置されるリトル エンディアン バイト順が使用されます。たとえば、Latin の大文字 A (コード ポイント U+0041) は次のように 16 進数でシリアル化されます。
-
ビッグ エンディアン バイト順 : 00 00 00 41
-
リトル エンディアン バイト順 : 41 00 00 00
UTF32Encoding は、オプションでプリアンブルを提供します。プリアンブルは、エンコーディング プロセスで得られたバイト シーケンスの先頭に付加できるバイトの配列です。プリアンブルにバイト順マーク (コード ポイント U+FEFF) が含まれる場合、デコーダはバイト順および変換形式 (UTF) を判断できます。Unicode バイト順マークは、次のように 16 進数でシリアル化されます。
-
ビッグ エンディアン バイト順 : 00 00 FE FF
-
リトル エンディアン バイト順 : FF FE 00 00
通常、ネイティブなバイト順で Unicode 文字を格納した方が効率的です。たとえば、Intel のコンピュータなど、リトル エンディアンのプラットフォームでは、リトル エンディアンのバイト順を使用した方が効率的です。
GetPreamble メソッドは、バイト順マークを格納するバイト配列を返します。このバイト配列がエンコード済みストリームの前に付加されていると、使用されているエンコーディング形式をデコーダが識別するのに役立ちます。
Unicode エンコーディング、バイト順、およびバイト順マークの詳細については、www.unicode.org の「Unicode Standard」を参照してください。
.gif) メモ |
|---|
| エラー検出を有効にしてクラス インスタンスの安全性を向上させるには、throwOnInvalidCharacters パラメータを受け取る UTF32Encoding コンストラクタを使用し、このパラメータを true に設定します。エラー検出を有効にすると、メソッドは、無効な文字シーケンスやバイト シーケンスを検出したときに、ArgumentException をスローします。エラー検出を無効にすると、例外はスローされず、無効なシーケンスは全般に無視されます。 |
UTF32Encoding は、Windows コード ページ 12000 (リトル エンディアン バイト順) と 12001 (ビッグ エンディアン バイト順) に対応しています。
使用例次のコード例は、エラー検出を有効にした場合と無効にした場合の UTF32Encoding の動作を示しています。
Imports System Imports System.Text Imports Microsoft.VisualBasic Public Class SamplesUTF32Encoding Public Shared Sub Main() ' Create an instance of UTF32Encoding using little-endian byte order. ' This will be used for encoding. Dim u32LE As New UTF32Encoding(False, True) ' Create two instances of UTF32Encoding using big-endian byte order: one with error detection and one without. ' These will be used for decoding. Dim u32withED As New UTF32Encoding(True, True, True) Dim u32noED As New UTF32Encoding(True, True, False) ' Create byte arrays from the same 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) ' a high-surrogate value (U+D8FF) ' a low-surrogate value (U+DCFF) Dim myStr As String = "za" & ChrW(&H0306) & ChrW(&H01FD) & ChrW(&H03B2) & ChrW(&HD8FF) & ChrW(&HDCFF) ' Encode the string using little-endian byte order. Dim myBytes(u32LE.GetByteCount(myStr)) As Byte u32LE.GetBytes(myStr, 0, myStr.Length, myBytes, 0) ' Decode the byte array with error detection. Console.WriteLine("Decoding with error detection:") PrintDecodedString(myBytes, u32withED) ' Decode the byte array without error detection. Console.WriteLine("Decoding without error detection:") PrintDecodedString(myBytes, u32noED) End Sub 'Main ' Decode the bytes and display the string. Public Shared Sub PrintDecodedString(bytes() As Byte, enc As Encoding) Try Console.WriteLine(" Decoded string: {0}", enc.GetString(bytes, 0, bytes.Length)) Catch e As System.ArgumentException Console.WriteLine(e.ToString()) End Try Console.WriteLine() End Sub 'PrintDecodedString End Class 'SamplesUTF32Encoding
using System; using System.Text; public class SamplesUTF32Encoding { public static void Main() { // Create an instance of UTF32Encoding using little-endian byte order. // This will be used for encoding. UTF32Encoding u32LE = new UTF32Encoding( false, true ); // Create two instances of UTF32Encoding using big-endian byte order: one with error detection and one without. // These will be used for decoding. UTF32Encoding u32withED = new UTF32Encoding( true, true, true ); UTF32Encoding u32noED = new UTF32Encoding( true, true, false ); // Create byte arrays from the same 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) // a high-surrogate value (U+D8FF) // a low-surrogate value (U+DCFF) String myStr = "za\u0306\u01FD\u03B2\uD8FF\uDCFF"; // Encode the string using little-endian byte order. byte[] myBytes = new byte[u32LE.GetByteCount( myStr )]; u32LE.GetBytes( myStr, 0, myStr.Length, myBytes, 0 ); // Decode the byte array with error detection. Console.WriteLine( "Decoding with error detection:" ); PrintDecodedString( myBytes, u32withED ); // Decode the byte array without error detection. Console.WriteLine( "Decoding without error detection:" ); PrintDecodedString( myBytes, u32noED ); } // Decode the bytes and display the string. public static void PrintDecodedString( byte[] bytes, Encoding enc ) { try { Console.WriteLine( " Decoded string: {0}", enc.GetString( bytes, 0, bytes.Length ) ); } catch ( System.ArgumentException e ) { Console.WriteLine( e.ToString() ); } Console.WriteLine(); } }
using namespace System; using namespace System::Text; void PrintDecodedString( array<Byte>^bytes, Encoding^ enc ); int main() { // Create an instance of UTF32Encoding using little-endian byte order. // This will be used for encoding. UTF32Encoding^ u32LE = gcnew UTF32Encoding( false,true ); // Create two instances of UTF32Encoding using big-endian byte order: one with error detection and one without. // These will be used for decoding. UTF32Encoding^ u32withED = gcnew UTF32Encoding( true,true,true ); UTF32Encoding^ u32noED = gcnew UTF32Encoding( true,true,false ); // Create byte arrays from the same 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 = L"za\u0306\u01FD\u03B2\xD8FF\xDCFF"; // Encode the string using little-endian byte order. array<Byte>^myBytes = gcnew array<Byte>(u32LE->GetByteCount( myStr )); u32LE->GetBytes( myStr, 0, myStr->Length, myBytes, 0 ); // Decode the byte array with error detection. Console::WriteLine( "Decoding with error detection:" ); PrintDecodedString( myBytes, u32withED ); // Decode the byte array without error detection. Console::WriteLine( "Decoding without error detection:" ); PrintDecodedString( myBytes, u32noED ); } // Decode the bytes and display the string. void PrintDecodedString( array<Byte>^bytes, Encoding^ enc ) { try { Console::WriteLine( " Decoded string: {0}", enc->GetString( bytes, 0, bytes->Length ) ); } catch ( System::ArgumentException^ e ) { Console::WriteLine( e ); } Console::WriteLine(); }
import System.*; import System.Text.*; public class SamplesUTF32Encoding { public static void main(String[] args) { // Create an instance of UTF32Encoding using little-endian byte order. // This will be used for encoding. UTF32Encoding u32LE = new UTF32Encoding(false, true); // Create two instances of UTF32Encoding using big-endian byte order: // one with error detection and one without. // These will be used for decoding. UTF32Encoding u32withED = new UTF32Encoding(true, true, true); UTF32Encoding u32noED = new UTF32Encoding(true, true, false); // Create byte arrays from the same 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) // a high-surrogate value (U+D8FF) // a low-surrogate value (U+DCFF) String myStr = "za\u0306\u01FD\u03B2\uD8FF\uDCFF"; // Encode the string using little-endian byte order. ubyte myBytes[] = new ubyte[u32LE.GetByteCount(myStr)]; u32LE.GetBytes(myStr, 0, myStr.get_Length(), myBytes, 0); // Decode the byte array with error detection. Console.WriteLine("Decoding with error detection:"); PrintDecodedString(myBytes, u32withED); // Decode the byte array without error detection. Console.WriteLine("Decoding without error detection:"); PrintDecodedString(myBytes, u32noED); } //main // Decode the bytes and display the string. public static void PrintDecodedString(ubyte bytes[], Encoding enc) { try { Console.WriteLine(" Decoded string: {0}" , enc.GetString(bytes, 0, bytes.length)); } catch(System.ArgumentException e) { Console.WriteLine(e.ToString()); } Console.WriteLine(); } //PrintDecodedString } //SamplesUTF32Encoding
継承階層System.Text.Encoding
System.Text.UTF32Encoding
スレッド セーフプラットフォームWindows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- UTF32Encoding クラスのページへのリンク
