BitConverter.ToChar メソッド

.NET Framework クラス ライブラリ リファレンス

BitConverter.ToChar メソッド

バイト配列内の指定位置にある 2 バイトから変換された Unicode 文字を返します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Shared Function ToChar
 ( _
    value As Byte(), _
    startIndex As Integer _
) As Char

Visual Basic (使用法)

Dim value As Byte()
Dim startIndex As Integer
Dim returnValue As Char

returnValue = BitConverter.ToChar(value, startIndex)

C#

public static char ToChar
 (
    byte[] value,
    int startIndex
)

C++

public:
static wchar_t ToChar (
    array<unsigned char>^ value, 
    int startIndex
)

J#

public static char ToChar
 (
    byte[] value, 
    int startIndex
)

JScript

public static function ToChar
 (
    value : byte[], 
    startIndex : int
) : char

パラメータ

value

配列。

startIndex

value 内の開始位置。

戻り値
startIndex から始まる 2 バイトで構成される文字。

例外

例外の種類	条件
ArgumentNullException	value が null 参照 (Visual Basic では Nothing) です。
ArgumentOutOfRangeException	startIndex が 0 未満か、value の長さから 2 を引いた値より大きい値です。

使用例

ToChar メソッドを使用して、Byte 配列の要素を Char 値 (Unicode 文字) に変換するコード例を次に示します。

Visual Basic

' Example of the BitConverter.ToChar method.
Imports System
Imports Microsoft.VisualBasic

Module BytesToCharDemo

    Const formatter As String
 = "{0,5}{1,17}{2,8}"
 
    ' Convert two Byte array elements to a Char and display it.
    Sub BAToChar( bytes( ) As Byte,
 index As Integer )

        Dim value As Char
 = BitConverter.ToChar( bytes, index )

        Console.WriteLine( formatter, index, _
            BitConverter.ToString( bytes, index, 2 ), value )
    End Sub 
       
    Sub Main( )

        Dim byteArray as Byte(
 ) = { _
             32,   0,   0,  42,   0,  65,   0, 125,   0, 197, _
              0, 168,   3,  41,   4, 172,  32 }

        Console.WriteLine( _
            "This example of the BitConverter.ToChar( Byte( ),
 " & _
            "Integer ) " & vbCrLf & "method
 generates the " & _
            "following output. It converts elements "
 & vbCrLf & _
            "of a Byte array to Char values." &
 vbCrLf )
        Console.WriteLine( "initial Byte array" )
        Console.WriteLine( "------------------" )
        Console.WriteLine( BitConverter.ToString( byteArray ) )
        Console.WriteLine( )
        Console.WriteLine( formatter, "index", "array
 elements", "Char" )
        Console.WriteLine( formatter, "-----", "--------------",
 "----" )
          
        ' Convert Byte array elements to Char values.
        BAToChar( byteArray, 0 )
        BAToChar( byteArray, 1 )
        BAToChar( byteArray, 3 )
        BAToChar( byteArray, 5 )
        BAToChar( byteArray, 7 )
        BAToChar( byteArray, 9 )
        BAToChar( byteArray, 11 )
        BAToChar( byteArray, 13 )
        BAToChar( byteArray, 15 )
    End Sub 
End Module

' This example of the BitConverter.ToChar( Byte( ), Integer )
' method generates the following output. It converts elements 
' of a Byte array to Char values.
' 
' initial Byte array
' ------------------
' 20-00-00-2A-00-41-00-7D-00-C5-00-A8-03-29-04-AC-20
' 
' index   array elements    Char
' -----   --------------    ----
'     0            20-00
'     1            00-00
'     3            2A-00       *
'     5            41-00       A
'     7            7D-00       }
'     9            C5-00       
'    11            A8-03       ?
'    13            29-04       ?
'    15            AC-20       ?

C#

// Example of the BitConverter.ToChar method.
using System;

class BytesToCharDemo
{
    const string formatter = "{0,5}{1
,17}{2,8}";
 
    // Convert two byte array elements to a char and display it.
    public static void BAToChar(
 byte[] bytes, int index )
    {
        char value = BitConverter.ToChar( bytes, index );

        Console.WriteLine( formatter, index, 
            BitConverter.ToString( bytes, index, 2 ), value );
    }
       
    public static void Main(
 )
    {
        byte[] byteArray = {
             32,   0,   0,  42,   0,  65,   0, 125,   0, 
            197,   0, 168,   3,  41,   4, 172,  32 };

        Console.WriteLine( 
            "This example of the BitConverter.ToChar( byte[ ], " +
            "int ) \nmethod generates the following output.
 It " +
            "converts \nelements of a byte array to char
 values.\n" );
        Console.WriteLine( "initial byte array" );
        Console.WriteLine( "------------------" );
        Console.WriteLine( BitConverter.ToString( byteArray ) );
        Console.WriteLine( );
        Console.WriteLine( formatter, "index", "array elements",
 "char" );
        Console.WriteLine( formatter, "-----", "--------------",
 "----" );
          
        // Convert byte array elements to char values.
        BAToChar( byteArray, 0 );
        BAToChar( byteArray, 1 );
        BAToChar( byteArray, 3 );
        BAToChar( byteArray, 5 );
        BAToChar( byteArray, 7 );
        BAToChar( byteArray, 9 );
        BAToChar( byteArray, 11 );
        BAToChar( byteArray, 13 );
        BAToChar( byteArray, 15 );
    }
}

/*
This example of the BitConverter.ToChar( byte[ ], int )
method generates the following output. It converts
elements of a byte array to char values.

initial byte array
------------------
20-00-00-2A-00-41-00-7D-00-C5-00-A8-03-29-04-AC-20

index   array elements    char
-----   --------------    ----
    0            20-00
    1            00-00
    3            2A-00       *
    5            41-00       A
    7            7D-00       }
    9            C5-00       
   11            A8-03       ?
   13            29-04       ?
   15            AC-20       ?
*/

C++

// Example of the BitConverter::ToChar method.
using namespace System;

// Convert two byte array elements to a __wchar_t and display it.
void BAToChar( array<unsigned char>^bytes,
 int index )
{
   __wchar_t value = BitConverter::ToChar( bytes, index );
   Console::WriteLine( "{0,5}{1,17}{2,11}", index, BitConverter::ToString(
 bytes, index, 2 ), value );
}

int main()
{
   array<unsigned char>^byteArray = {32,0,0,42,0,65,0,125
,0,197,0,168,3,41,4,172,32};
   Console::WriteLine( "This example of the BitConverter::ToChar( unsigned "
   "char[ ], int ) \nmethod generates
 the following output. It "
   "converts elements of a \nbyte array to __wchar_t values.\n" );
   Console::WriteLine( "initial unsigned char array"
 );
   Console::WriteLine( "---------------------------" );
   Console::WriteLine( BitConverter::ToString( byteArray ) );
   Console::WriteLine();
   Console::WriteLine( "{0,5}{1,17}{2,11}", "index", "array
 elements", "__wchar_t" );
   Console::WriteLine( "{0,5}{1,17}{2,11}", "-----", "--------------",
 "---------" );
   
   // Convert byte array elements to __wchar_t values.
   BAToChar( byteArray, 0 );
   BAToChar( byteArray, 1 );
   BAToChar( byteArray, 3 );
   BAToChar( byteArray, 5 );
   BAToChar( byteArray, 7 );
   BAToChar( byteArray, 9 );
   BAToChar( byteArray, 11 );
   BAToChar( byteArray, 13 );
   BAToChar( byteArray, 15 );
}

/*
This example of the BitConverter::ToChar( unsigned char[ ], int
 )
method generates the following output. It converts elements of a
byte array to __wchar_t values.

initial unsigned char array
---------------------------
20-00-00-2A-00-41-00-7D-00-C5-00-A8-03-29-04-AC-20

index   array elements  __wchar_t
-----   --------------  ---------
    0            20-00
    1            00-00
    3            2A-00          *
    5            41-00          A
    7            7D-00          }
    9            C5-00          
   11            A8-03          ?
   13            29-04          ?
   15            AC-20          ?
*/

J#

// Example of the BitConverter.ToChar method.
import System.*;

class BytesToCharDemo
{
    private static String formatter = "{0
,5}{1,17}{2,8}";

    // Convert two byte array elements to a char and display it.
    public static void BAToChar(ubyte
 bytes[], int index)
    {
        char value = BitConverter.ToChar(bytes, index);
        Console.WriteLine(formatter, (Int32)index,
            BitConverter.ToString(bytes, index, 2), (Char)value);
    } //BAToChar

    public static void main(String[]
 args)
    {
        ubyte byteArray[] =  { 32, 0, 0, 42, 0, 65, 0, 125, 0, 197, 0, 168, 3, 
                                41, 4, 172, 32 };
        Console.WriteLine("This example of the "
            + " BitConverter.ToChar( byte[ ], int ) \n"
            + "method generates the following output. " 
            + "It converts \nelements of a byte array to char
 values.\n");
        Console.WriteLine("initial byte array");
        Console.WriteLine("------------------");
        Console.WriteLine(BitConverter.ToString(byteArray));
        Console.WriteLine();
        Console.WriteLine(formatter, "index", "array elements",
 "char");
        Console.WriteLine(formatter, "-----", "--------------",
 "----");

        // Convert byte array elements to char values.
        BAToChar(byteArray, 0);
        BAToChar(byteArray, 1);
        BAToChar(byteArray, 3);
        BAToChar(byteArray, 5);
        BAToChar(byteArray, 7);
        BAToChar(byteArray, 9);
        BAToChar(byteArray, 11);
        BAToChar(byteArray, 13);
        BAToChar(byteArray, 15);
    } //main
} //BytesToCharDemo

/*
This example of the BitConverter.ToChar( byte[ ], int )
method generates the following output. It converts
elements of a byte array to char values.

initial byte array
------------------
20-00-00-2A-00-41-00-7D-00-C5-00-A8-03-29-04-AC-20

index   array elements    char
-----   --------------    ----
    0            20-00
    1            00-00
    3            2A-00       *
    5            41-00       A
    7            7D-00       }
    9            C5-00       
   11            A8-03       ?
   13            29-04       ?
   15            AC-20       ?
*/

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
BitConverter クラス
BitConverter メンバ
System 名前空間
Char