$CHAR (ObjectScript)

Synopsis

$CHAR(expression,...)
$C(expression,...)

概要

$CHAR は expression で指定した 10 進数 (10 進法) に対応する文字を返します。この文字は 8 ビット (ASCII) 文字あるいは 16 ビット (Unicode) 文字です。8 ビット文字の場合、expression の値は、0 から 255 までの正の整数に評価される必要があります。16 ビット文字の場合、256 から 65535 (16 進数 FFFF) までの整数を指定します。65535 より大きい値は、空の文字列を返します。65536 (16 進数 10000) から 1114111 (16 進数 10FFFF) は、Unicode のサロゲート・ペアを表します。これらの文字は $WCHAR を使用して返されます。

コンマで区切られたリストとして expression を指定することもできます。その場合、$CHAR はリストの各 expression に対応する文字を返します。

$ASCII 関数は $CHAR と逆の機能を持っています。

引数

expression

式は、整数値、整数値を含む変数の名前、整数値に評価する有効な ObjectScript 式のいずれかにできます。複数の整数値に対して文字を返すためには、式をコンマで区切ったリストを使用します。

$ZHEX 関数を使用して、10 進数 (10 進法) の文字コードではなく、16 進数の文字コードを使用して文字を指定することができます。以下の例では、両方の $CHAR 文がギリシャ文字 pi を返します。

    WRITE $CHAR(960),!
    WRITE $CHAR($ZHEX("3C0"))

例

以下の例は、FOR ループの中で $CHAR を使用して、65 から 90 までのすべての ASCII コードの文字を出力しています。これらは、大文字のアルファベット文字になります。

  FOR i=65:1:90 {
     WRITE !,$CHAR(i) }

以下の例では、FOR ループで $CHAR を使用して、日本語のひらがな文字を出力します。

  FOR i=12353:1:12435 {
     WRITE !,$CHAR(i) }

以下の 2 つの例は、複数の expression 値の使用方法です。第 1 の例は "AB" を返し、第 2 の例は "AaBbCcDdEeFfGgHhIiJjKk" を返します。

  WRITE $CHAR(65,66),!
  FOR i=65:1:75 { 
     WRITE $CHAR(i,i+32) }

$CHAR および WRITE

WRITE コマンドで文字を出力するために $CHAR を用いる場合、出力文字は特殊変数 $X と $Y の位置を再設定します。これは NULL 文字 (ASCII 0) のときでも True ですが、NULL 文字列 ("") では異なります。原則として、出力不可能な文字を書き込むときの $CHAR の使用は、慎重に行ってください。このような文字は、予想できないカーソルの動きと画面動作をすることがあります。

$CHAR と %List 構造

%List 構造 (%Library.ListOpens in a new tab) は、出力不能文字を使用してエンコードされた文字列であるため、$CHAR の特定の値は、単一の要素が含まれる %List 構造になります。%List 構造を返す $CHAR の組み合わせは以下のとおりです。

• $CHAR(1) は、空のリスト $lb() を返します。

• $CHAR(1,1) は、2 要素の空のリスト $lb(,) を返します。

• $CHAR(2,1)、$CHAR(2,2)、または $CHAR(2,12) は、空の文字列が含まれるリスト $lb("") を返します。

• $CHAR(2,4) は、$lb(0) を返します。

• $CHAR(2,5) は、$lb(-1) を返します。

• $CHAR(2,8) または $CHAR(2,9) は、$lb($double(0)) を返します。

3 文字以上が含まれ、単一要素リストが生成される $CHAR の組み合わせは、以下のような構文になります。

$CHAR(count,flag,string)

$CHAR 引数での数値

expression に符号付きの数値を使用できます。InterSystems IRIS は負数を無視し、正もしくは符号なしの数のみを評価します。以下の例で、符号付きの整数を使用した $CHAR は、最初と 3 番目の expression のみを返し、負数である 2 番目の expression を無視します。

  WRITE !,$CHAR(65,66,67)
  WRITE !,$CHAR(+65,-66,67)

ABC

AC

expression に浮動小数点値を使用できます。InterSystems IRIS は引数の小数部を無視し、整数部のみを評価します。以下の例は、$CHAR が小数部分を無視して、文字コード 65、大文字 A を表す文字を作成しています。

   WRITE $CHAR(65.5)

Unicode サポート

$CHAR は、10 進数 (10 進法) で表される Unicode 文字をサポートします。

文字の Unicode 値は、通常 0 ～ 9 と A ～ F を使用する 16 進数の 4 桁の数字で表されます。しかし、ObjectScript 言語の基本関数は、通常 16 進数ではなく、10 進数値の ASCII コードによる文字を識別します。

したがって、$CHAR 関数は Unicode 標準が推奨する 16 進数値の代わりに、$ASCII 関数は入力文字の 10 進数の Unicode 値を返すことによって、Unicode コード化をサポートします。$CHAR($ZHEX("hexnum")) のように、$ZHEX 関数で引用符を使用して、16進数の Unicode 値を指定することができます。hexnum = $ZHEX(decnum) のように、引用符なしで $ZHEX を使用して、10 進数を 16 進数に変換することもできます。

詳細は、"ObjectScript の使用法" の "Unicode" を参照してください。

$CHAR に関連している関数

$ASCII 関数は $CHAR と逆の機能を持っています。文字を対応する数値に変換するために使用します。$ASCII は、Unicode 文字を含むすべての文字を変換します。また、すべての InterSystems IRIS プラットフォームは関連する関数、$ZLCHAR と $ZWCHAR をサポートしています。これらは、$CHAR に似ていますが、ワード (2 バイト) あるいはロングワード (4 バイト) で動作します。$ZISWIDE を使用して、$CHAR の expression 内にマルチバイト ("ワイド") 文字があるかどうかを判断します。

関連項目

• READ コマンド

• WRITE コマンド

• $ASCII 関数

• $WCHAR 関数

• $WISWIDE 関数

• $ZHEX 関数

• $ZLCHAR 関数

• $ZWCHAR 関数

• $X 特殊変数

• $Y 特殊変数