Encoding.GetString メソッド (Byte , Int32, Int32)
バイト配列内のバイトの範囲の、デコードされた表現を含んでいる文字列を返します。
Overloads Public Overridable Function GetString( _
ByVal bytes() As Byte, _ ByVal index As Integer, _ ByVal count As Integer _) As String
[C#]
public virtual string GetString(byte[] bytes,intindex,intcount);
[C++]
public: virtual String* GetString(unsigned charbytes __gc[],intindex,intcount);
[JScript]
public function GetString(
bytes : Byte[],index : int,count : int) : String;
パラメータ
- bytes
デコードするバイト配列。 - index
デコードするバイト配列の開始インデックス。 - count
デコードするバイト数。
戻り値
指定したバイト配列内のバイトの範囲の、デコードされた表現を含んでいる文字列。
例外
例外の種類 | 条件 |
---|---|
ArgumentNullException | bytes パラメータが null 参照 (Visual Basic では Nothing) です。 |
ArgumentOutOfRangeException | index パラメータおよび count パラメータが、バイト配列内の有効範囲を示していません。 |
解説
GetString は、すべての文字を生成するために必要なすべてのバイトが、バイト配列に含まれていると見なします。バイトが複数のバイト配列にわたる可能性がある場合 (つまり、単一の文字に対応するバイトが、1 つのバイト配列の末尾と別のバイト配列の先頭に存在する可能性がある場合) は、複数の呼び出し間の状態を維持する Decoder クラスを使用します。
使用例
[Visual Basic, C#, C++] バイナリ ファイルから UTF8 でエンコードされた文字列を読み取る方法を、次のコード例に示します。
Private Function ReadAuthor(binary_file As Stream) As String
Dim encoding As System.Text.Encoding = System.Text.Encoding.UTF8
' Read string from binary file with UTF8 encoding
Dim buffer(30) As Byte
binary_file.Read(buffer, 0, 30)
Return encoding.GetString(buffer)
End Function
[C#]
private string ReadAuthor(Stream binary_file) {
System.Text.Encoding encoding = System.Text.Encoding.UTF8;
// Read string from binary file with UTF8 encoding
byte[] buffer = new byte[30];
binary_file.Read(buffer, 0, 30);
return encoding.GetString(buffer);
}
[C++]
String* ReadAuthor(Stream* binary_file) {
System::Text::Encoding* encoding = System::Text::Encoding::UTF8;
// Read string from binary file with UTF8 encoding
Byte buffer[] = new Byte[30];
binary_file->Read(buffer, 0, 30);
return encoding->GetString(buffer);
}
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard
参照
Encoding クラス | Encoding メンバ | System.Text 名前空間 | Encoding.GetString オーバーロードの一覧