Decoder.GetChars メソッド

定義

名前空間:

System.Text

アセンブリ:

System.Runtime.dll

派生クラスでオーバーライドされた場合、バイト シーケンスを文字のセットにデコードします。

オーバーロード

GetChars(ReadOnlySpan<Byte>, Span<Char>, Boolean)	派生クラスでオーバーライドされた場合、スパン バイトと内部バッファー内のすべてのバイトのシーケンスを、指定された文字ポインターから始まる文字セットにデコードします。 パラメーターでは、変換後にデコーダーの内部状態をクリアするかどうかを示します。
GetChars(Byte*, Int32, Char*, Int32, Boolean)	派生クラスでオーバーライドされた場合、指定したバイト ポインターで始まるバイト シーケンス、および内部バッファー内のバイトを、指定した文字ポインターを開始位置として格納される文字のセットにエンコードします。 パラメーターでは、変換後にデコーダーの内部状態をクリアするかどうかを示します。
GetChars(Byte[], Int32, Int32, Char[], Int32)	派生クラスでオーバーライドされた場合、指定したバイト配列に格納されているバイト シーケンス、および内部バッファー内のバイトを、指定した文字配列にデコードします。
GetChars(Byte[], Int32, Int32, Char[], Int32, Boolean)	派生クラスでオーバーライドされた場合、指定したバイト配列に格納されているバイト シーケンス、および内部バッファー内のバイトを、指定した文字配列にデコードします。 パラメーターでは、変換後にデコーダーの内部状態をクリアするかどうかを示します。

GetChars(ReadOnlySpan<Byte>, Span<Char>, Boolean)

ソース:

Decoder.cs

派生クラスでオーバーライドされた場合、スパン バイトと内部バッファー内のすべてのバイトのシーケンスを、指定された文字ポインターから始まる文字セットにデコードします。 パラメーターでは、変換後にデコーダーの内部状態をクリアするかどうかを示します。

public:
 virtual int GetChars(ReadOnlySpan<System::Byte> bytes, Span<char> chars, bool flush);

public virtual int GetChars (ReadOnlySpan<byte> bytes, Span<char> chars, bool flush);

abstract member GetChars : ReadOnlySpan<byte> * Span<char> * bool -> int
override this.GetChars : ReadOnlySpan<byte> * Span<char> * bool -> int

Public Overridable Function GetChars (bytes As ReadOnlySpan(Of Byte), chars As Span(Of Char), flush As Boolean) As Integer

パラメーター

bytes

ReadOnlySpan<Byte>

デコードするバイト スパン。

chars

Span<Char>

結果の文字セットを書き込むスパン。

flush

Boolean

変換後にデコーダーの内部状態をクリアする場合は true。それ以外の場合は false。

戻り値

Int32

chars パラメーターによって示されるスパンに書き込む実際の文字数。

注釈

オブジェクトは への Decoder 呼び出しの間に状態を GetChars保存します。 データストリームを使用してアプリケーションを実行する場合は、 パラメーターを flush に true 設定して、状態情報がフラッシュされるようにする必要があります。 この設定では、デコーダーはデータ ブロックの末尾にある無効なバイトを無視し、内部バッファーをクリアします。

結果の文字を格納する必要がある GetChars 正確なスパン サイズを計算するには、アプリケーションで を使用 GetCharCountする必要があります。

を に設定して falseが呼び出されたflush場合GetChars、デコーダーはデータ ブロックの末尾のバイトを内部バッファーに格納し、次のデコード操作で使用します。 アプリケーションは、前のブロックの後続バイトが計算に含まれるように、同じブロックで を呼び出す直前にデータ ブロックを呼び出GetCharCountGetCharsす必要があります。

アプリケーションで入力ストリームの多数のセグメントを変換する場合は、 メソッドの使用を Convert 検討してください。 GetChars 出力範囲が十分な大きさではない場合は例外がスローされますが Convert 、出力配列で少なくとも 2 文字が許可されている場合は、読み取られたバイト数と書き込まれた文字を返します。 その他のコメントについては、 Encoding.GetChars トピックも参照してください。

GetChars(Byte*, Int32, Char*, Int32, Boolean)

ソース:

Decoder.cs

重要

この API は CLS 準拠ではありません。

派生クラスでオーバーライドされた場合、指定したバイト ポインターで始まるバイト シーケンス、および内部バッファー内のバイトを、指定した文字ポインターを開始位置として格納される文字のセットにエンコードします。 パラメーターでは、変換後にデコーダーの内部状態をクリアするかどうかを示します。

public:
 virtual int GetChars(System::Byte* bytes, int byteCount, char* chars, int charCount, bool flush);

[System.CLSCompliant(false)]
public virtual int GetChars (byte* bytes, int byteCount, char* chars, int charCount, bool flush);

[<System.CLSCompliant(false)>]
abstract member GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int

パラメーター

bytes

Byte*

デコードする最初のバイトへのポインター。

byteCount

Int32

デコードするバイト数。

chars

Char*

結果の文字セットの書き込みを開始する位置へのポインター。

charCount

Int32

書き込む文字の最大数。

flush

Boolean

変換後にデコーダーの内部状態をクリアする場合は true。それ以外の場合は false。

戻り値

Int32

chars パラメーターによって示される位置に書き込む実際の文字数。

属性

CLSCompliantAttribute

例外

ArgumentNullException

bytes が null (Nothing) です。

または

chars が null (Nothing) です。

ArgumentOutOfRangeException

byteCount または charCount が 0 未満です。

ArgumentException

charCount が結果の文字数より少なくなっています。

DecoderFallbackException

フォールバックが発生しました (詳細については「.NET での文字エンコード」を参照)

および

Fallback が DecoderExceptionFallback に設定されます。

注釈

オブジェクトは への Decoder 呼び出しの間に状態を GetChars保存します。 データストリームを使用してアプリケーションを実行する場合は、 パラメーターを flush に true 設定して、状態情報がフラッシュされるようにする必要があります。 この設定では、デコーダーはデータ ブロックの末尾にある無効なバイトを無視し、内部バッファーをクリアします。

結果の文字を格納する必要がある GetChars 正確なバッファー サイズを計算するには、アプリケーションで を使用 GetCharCountする必要があります。

を に設定して falseが呼び出されたflush場合GetChars、デコーダーはデータ ブロックの末尾のバイトを内部バッファーに格納し、次のデコード操作で使用します。 アプリケーションは、前のブロックの後続バイトが計算に含まれるように、同じブロックで を呼び出す直前にデータ ブロックを呼び出GetCharCountGetCharsす必要があります。

アプリケーションで入力ストリームの多数のセグメントを変換する場合は、 メソッドの使用を Convert 検討してください。 GetChars 出力バッファーが十分な大きさでない場合は例外をスローしますが Convert 、出力配列で少なくとも 2 文字が許可されている場合は、できるだけ多くの領域を埋め、書き込まれたバイト数と文字を返します。 その他のコメントについては、 Encoding.GetChars トピックも参照してください。

こちらもご覧ください

• GetCharCount(Byte*, Int32, Boolean)
• Reset()

GetChars(Byte[], Int32, Int32, Char[], Int32)

ソース:

Decoder.cs

派生クラスでオーバーライドされた場合、指定したバイト配列に格納されているバイト シーケンス、および内部バッファー内のバイトを、指定した文字配列にデコードします。

public:
 abstract int GetChars(cli::array <System::Byte> ^ bytes, int byteIndex, int byteCount, cli::array <char> ^ chars, int charIndex);

public abstract int GetChars (byte[] bytes, int byteIndex, int byteCount, char[] chars, int charIndex);

abstract member GetChars : byte[] * int * int * char[] * int -> int

Public MustOverride Function GetChars (bytes As Byte(), byteIndex As Integer, byteCount As Integer, chars As Char(), charIndex As Integer) As Integer

パラメーター

bytes

Byte[]

デコード対象のバイト シーケンスが格納されたバイト配列。

byteIndex

Int32

デコードする最初のバイトのインデックス。

byteCount

Int32

デコードするバイト数。

chars

Char[]

結果の文字のセットを格納する文字配列。

charIndex

Int32

結果の文字のセットを書き込む開始位置のインデックス。

戻り値

Int32

chars に書き込まれた実際の文字数。

例外

ArgumentNullException

bytes が null (Nothing) です。

または

chars が null (Nothing) です。

ArgumentOutOfRangeException

byteIndex、byteCount、または charIndex が 0 未満です。

または

byteindex および byteCount は bytesにおいて有効な範囲を表していません。

または

charIndex が chars の有効なインデックスではありません。

ArgumentException

chars には、charIndex から配列の末尾までに十分なサイズがなく、結果の文字を格納できません。

DecoderFallbackException

フォールバックが発生しました (詳細については「.NET での文字エンコード」を参照)

および

Fallback が DecoderExceptionFallback に設定されます。

例

次の例では、バイト配列から要素の範囲をデコードし、Unicode 文字配列に格納する方法を示します。 メソッドは GetCharCount 、デコードされた要素を配列 bytesに格納するために必要な文字数を計算するために使用されます。 メソッドは GetChars 、バイト配列内の指定された要素をデコードし、新しい文字配列に格納します。

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   array<Char>^chars;
   array<Byte>^bytes = {85,0,110,0,105,0,99,0,111,0,100,0,101,0};
   Decoder^ uniDecoder = Encoding::Unicode->GetDecoder();
   int charCount = uniDecoder->GetCharCount( bytes, 0, bytes->Length );
   chars = gcnew array<Char>(charCount);
   int charsDecodedCount = uniDecoder->GetChars( bytes, 0, bytes->Length, chars, 0 );
   Console::WriteLine( "{0} characters used to decode bytes.", charsDecodedCount );
   Console::Write( "Decoded chars: " );
   IEnumerator^ myEnum = chars->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Char c = safe_cast<Char>(myEnum->Current);
      Console::Write( "[{0}]", c.ToString() );
   }

   Console::WriteLine();
}

/* This code example produces the following output.

7 characters used to decode bytes.
Decoded chars: [U][n][i][c][o][d][e]

*/

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        Char[] chars;
        Byte[] bytes = new Byte[] {
            85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0
        };

        Decoder uniDecoder = Encoding.Unicode.GetDecoder();

        int charCount = uniDecoder.GetCharCount(bytes, 0, bytes.Length);
        chars = new Char[charCount];
        int charsDecodedCount = uniDecoder.GetChars(bytes, 0, bytes.Length, chars, 0);

        Console.WriteLine(
            "{0} characters used to decode bytes.", charsDecodedCount
        );

        Console.Write("Decoded chars: ");
        foreach (Char c in chars) {
            Console.Write("[{0}]", c);
        }
        Console.WriteLine();
    }
}

/* This code example produces the following output.

7 characters used to decode bytes.
Decoded chars: [U][n][i][c][o][d][e]

*/

Imports System.Text

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        Dim chars() As Char
        Dim bytes() As Byte = { _
            85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0 _
        }
        
        Dim uniDecoder As Decoder = Encoding.Unicode.GetDecoder()
        
        Dim charCount As Integer = uniDecoder.GetCharCount(bytes, 0, bytes.Length)
        chars = New Char(charCount - 1) {}
        Dim charsDecodedCount As Integer = _
            uniDecoder.GetChars(bytes, 0, bytes.Length, chars, 0)
        
        Console.WriteLine( _
            "{0} characters used to decode bytes.", _
            charsDecodedCount _
        )
        
        Console.Write("Decoded chars: ")
        Dim c As Char
        For Each c In  chars
            Console.Write("[{0}]", c)
        Next c
        Console.WriteLine()
    End Sub
End Class

'This code example produces the following output.
'
'7 characters used to decode bytes.
'Decoded chars: [U][n][i][c][o][d][e]
'

注釈

オブジェクトは への Decoder 呼び出しの間に状態を GetChars保存します。 データストリームを使用してアプリケーションを実行する場合は、 パラメーターを flush に true 設定して、状態情報がフラッシュされるようにする必要があります。 この設定では、デコーダーはデータ ブロックの末尾にある無効なバイトを無視し、内部バッファーをクリアします。

結果の文字を格納する必要がある GetChars 正確な配列サイズを計算するには、アプリケーションで を使用 GetCharCountする必要があります。

を に設定して falseが呼び出されたflush場合GetChars、デコーダーはデータ ブロックの末尾のバイトを内部バッファーに格納し、次のデコード操作で使用します。 アプリケーションは、前のブロックの後続バイトが計算に含まれるように、同じブロックで を呼び出す直前にデータ ブロックを呼び出GetCharCountGetCharsす必要があります。

アプリケーションで入力ストリームの多数のセグメントを変換する場合は、 メソッドの使用を Convert 検討してください。 GetChars 出力バッファーが十分な大きさでない場合は例外をスローしますが Convert 、出力配列で少なくとも 2 文字が許可されている場合は、できるだけ多くの領域を埋め、書き込まれたバイト数と文字を返します。 その他のコメントについては、 Encoding.GetChars トピックも参照してください。

こちらもご覧ください

• GetCharCount(Byte[], Int32, Int32)
• Reset()

GetChars(Byte[], Int32, Int32, Char[], Int32, Boolean)

ソース:

Decoder.cs

派生クラスでオーバーライドされた場合、指定したバイト配列に格納されているバイト シーケンス、および内部バッファー内のバイトを、指定した文字配列にデコードします。 パラメーターでは、変換後にデコーダーの内部状態をクリアするかどうかを示します。

public:
 virtual int GetChars(cli::array <System::Byte> ^ bytes, int byteIndex, int byteCount, cli::array <char> ^ chars, int charIndex, bool flush);

public virtual int GetChars (byte[] bytes, int byteIndex, int byteCount, char[] chars, int charIndex, bool flush);

abstract member GetChars : byte[] * int * int * char[] * int * bool -> int
override this.GetChars : byte[] * int * int * char[] * int * bool -> int

Public Overridable Function GetChars (bytes As Byte(), byteIndex As Integer, byteCount As Integer, chars As Char(), charIndex As Integer, flush As Boolean) As Integer

パラメーター

bytes

Byte[]

デコード対象のバイト シーケンスが格納されたバイト配列。

byteIndex

Int32

デコードする最初のバイトのインデックス。

byteCount

Int32

デコードするバイト数。

chars

Char[]

結果の文字のセットを格納する文字配列。

charIndex

Int32

結果の文字のセットを書き込む開始位置のインデックス。

flush

Boolean

変換後にデコーダーの内部状態をクリアする場合は true。それ以外の場合は false。

戻り値

Int32

chars パラメーターに書き込まれた実際の文字数。

例外

ArgumentNullException

bytes が null (Nothing) です。

または

chars が null (Nothing) です。

ArgumentOutOfRangeException

byteIndex、byteCount、または charIndex が 0 未満です。

または

byteindex および byteCount は bytesにおいて有効な範囲を表していません。

または

charIndex が chars の有効なインデックスではありません。

ArgumentException

chars には、charIndex から配列の末尾までに十分なサイズがなく、結果の文字を格納できません。

DecoderFallbackException

フォールバックが発生しました (詳細については「.NET での文字エンコード」を参照)

および

Fallback が DecoderExceptionFallback に設定されます。

注釈

オブジェクトは への Decoder 呼び出しの間に状態を GetChars保存します。 データストリームを使用してアプリケーションを実行する場合は、 パラメーターを flush に true 設定して、状態情報がフラッシュされるようにする必要があります。 この設定では、デコーダーはデータ ブロックの末尾にある無効なバイトを無視し、内部バッファーをクリアします。

結果の文字を格納する必要がある GetChars 正確な配列サイズを計算するには、アプリケーションで を使用 GetCharCountする必要があります。

を に設定して falseが呼び出されたflush場合GetChars、デコーダーはデータ ブロックの末尾のバイトを内部バッファーに格納し、次のデコード操作で使用します。 アプリケーションは、前のブロックの後続バイトが計算に含まれるように、同じブロックで を呼び出す直前にデータ ブロックを呼び出GetCharCountGetCharsす必要があります。

アプリケーションで入力ストリームの多数のセグメントを変換する場合は、 メソッドの使用を Convert 検討してください。 GetChars 出力バッファーが十分な大きさでない場合は例外をスローしますが Convert 、出力配列で少なくとも 2 文字が許可されている場合は、できるだけ多くの領域を埋め、書き込まれたバイト数と文字を返します。 その他のコメントについては、 Encoding.GetChars トピックも参照してください。

こちらもご覧ください

• GetCharCount(Byte[], Int32, Int32, Boolean)
• Reset()