Strings.Chr メソッドとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

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

索引トップ用語の索引ランキング

Strings.Chr メソッド

指定した文字コードに関連付けられている文字を返します。

名前空間: Microsoft.VisualBasic
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

Public Shared Function Chr
 ( _
    CharCode As Integer _
) As Char

Visual Basic (使用法)

Dim CharCode As Integer
Dim returnValue As Char

returnValue = Strings.Chr(CharCode)

public static char Chr (
    int CharCode
)

C++

public:
static wchar_t Chr (
    int CharCode
)

public static char Chr (
    int CharCode
)

JScript

public static function Chr
 (
    CharCode : int
) : char

パラメータ

CharCode: 必須。文字のコードポイント (文字コード) 表す Integer 型の式。CharCode に無効な範囲のコードを指定すると、ArgumentException エラーが発生します。Chr の有効な範囲は 0 ～ 255 であり、ChrW の有効な範囲は -32768 ～ 65535 です。

戻り値
指定した文字コードに関連付けられている文字を返します。

解説

詳細については、Visual Basic のトピック「Chr 関数、ChrW 関数」を参照してください。

CharCode に設定できる値の範囲は非対称であり、、Short 型 (Visual Basic) と整数型 (Integer) (Visual Basic) とのストレージの違いを補います。たとえば、-29183 は Short ですが、+36353 は Integer です。これにより、Visual Basic 6.0 との互換性も容易に実現されます。

Chr は、System.Text 名前空間の Encoding クラスを使用して、現在のスレッドが 1 バイト文字セット (SBCS) を使用しているか、または 2 バイト文字セット (DBCS) を使用しているかを判断します。次に、適切なセットのコードポイントとして CharCode を受け取ります。有効な範囲は、SBCS 文字セットの場合は 0 ～ 255、DBCS 文字の場合は -32768 ～ 65535 です。1 バイトの ASCII 文字の一覧については、「ASCII 文字コード」を参照してください。

戻り値は、現在のスレッドのコードページに依存します。コードページは、System.Globalization 名前空間に存在する TextInfo クラスの ANSICodePage プロパティに格納されています。ANSICodePage は、System.Globalization.CultureInfo.CurrentCulture.TextInfo.ANSICodePage を指定して取得できます。

ChrW は、Unicode コードポイントとして CharCode を受け取ります。有効な範囲は、現在のスレッドのカルチャおよびコードページ設定に依存しません。-32768 ～ -1 の値は、+32768 ～ +65535 の範囲の値と同じように扱われます。

0 ～ 31 の範囲の値は、標準の ASCII コードと同じで表示できません。たとえば、Chr(10) はラインフィード文字を返します。

メモ
以前のバージョンの Visual Basic の ChrB 関数は、1 バイト文字を返します。これは主に、2 バイト文字セット (DBCS) アプリケーションで文字列を変換する目的で使用されます。Visual Basic および .NET Framework のすべての文字列は Unicode であり、ChrB はサポートされていません。

使用例

次の例では、Chr 関数を使用して、指定した文字コードに関連付けられた文字を返しています。

Visual Basic

Dim associatedChar As Char
' Returns "A".
associatedChar = Chr(65)
' Returns "a".
associatedChar = Chr(97)
' Returns ">".
associatedChar = Chr(62)
' Returns "%".
associatedChar = Chr(37)