NATIONAL-OF

この関数の型は各国文字である。

一般形式

引数

argument-1 の字類は英字、英数字
、または UTF-8
とする。英数字の場合、argument-1 には、英数字文字または各国文字 (あるいはその両方) が外部表現の形式で含まれ得る。
argument-2 の項類は各国文字とし、1 文字位置の長さを占める。argument-2 に指定された文字は、変換時に対応する各国文字表現が存在しないような英数字文字に対する置き換え文字として使われる。
argument-2 は CCSID 変換テーブルを表す整数値とし、そのテーブルで変換に際しての変換元のコードページを指定する。argument-2 を省略すると、argument-1 の字類が UTF-8 の場合は値 1208 が想定される。
argument-2 は EBCDIC、ASCII、UTF-8、または EUC の有効なコードページを識別するものとする。EBCDIC または ASCII のコードページには 1 バイト文字と 2 バイト文字の両方を含めることができる。

1208 (UTF-8) 以外の CCSID 値は、適切な IBM CCSID 変換テーブルがインストールされている場合にのみ完全にサポートされる。詳細については、「CCSID 変換テーブルをインストールするには」を参照。CCSID が nnn であるとすると、IBM-nnn という名前のテーブルが必要になる。たとえば、サポートする CCSID の値が 37 であれば、IBM-37 というテーブルをインストールしなければならない。必要なテーブルがインストールされていない場合は、デフォルトの EBCDIC または ASCII コードページ (指定された CCSID が EBCDIC であるかどうかによって異なる) を使用して変換が実行される。

戻り値

argument-1 中の一つ一つの英数字文字および各国文字を対応する内部形式の各国文字表現に変換し、返却値として返す。argument-1 に含まれる外部表現が持つすべての制御機能は、単に文字種別を判別するためだけに用いられ、変換対象の文字とは見なされない。
argument-2 が指定されると、対応する内部形式の各国文字表現が存在しないような英数字文字に対してこの文字が返却値に返される。
argument-2 を指定しない場合、対応する内部形式の各国文字表現が存在しないような英数字文字に対しては、各国文字の空白文字が返却値に返される。
返却値の長さは、変換された結果を保持するのに必要な、USAGE NATIONAL の文字位置の個数となる。この長さは argument-1 の長さによって定まる。