Decoder.GetChars メソッド

ソース:

Decoder.cs

ソース:

Decoder.cs

ソース:

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

パラメーター

戻り値

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

注釈

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

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

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

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

ソース:

Decoder.cs

ソース:

Decoder.cs

ソース:

Decoder.cs

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)]
[System.Runtime.InteropServices.ComVisible(false)]
public virtual int GetChars (byte* bytes, int byteCount, char* chars, int charCount, bool flush);

[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
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

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

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

パラメーター

戻り値

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

属性

CLSCompliantAttribute ComVisibleAttribute SecurityCriticalAttribute

例外

注釈

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

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

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

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

こちらもご覧ください

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

ソース:

Decoder.cs

ソース:

Decoder.cs

ソース:

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

パラメーター

戻り値

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

例外

例

次の例では、バイト配列から要素の範囲をデコードし、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()

ソース:

Decoder.cs

ソース:

Decoder.cs

ソース:

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

パラメーター

戻り値

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

例外

注釈

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

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

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

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

こちらもご覧ください

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