NATIONAL-OF 関数は、引数-1 内の UCS-2 表現の文字で構成される国別文字ストリングを戻します。関数のタイプは国別です。
形式 1: ソース CCSID の指定 >>-FUNCTION NATIONAL-OF--(--引数-1--+--------+--)-------------->< '-引数-2-'
+----------------------------------IBM 拡張----------------------------------+
整数でなければなりません。引数-2 は、変換のソース・コード・ページを識別します。引数-2 は、EBCDIC、 ASCII、UTF-8、または EUC コード・ページを識別する有効な CCSID 番号でなければなりません。EBCDIC または ASCII CCSID は、SBCS、DBCS、または混合 SBCS/DBCS であるコード・ページを識別できます。
引数-2 が省略された場合、ソース・コード・ページは、ソース・コードのコンパイル時に CCSID コンパイラー・オプション用に有効になるソース・コード・ページです。ソース・コード・ページが 65535 である場合、デフォルトの CCSID 37 が使用されます。
+------------------------------End of IBM 拡張-------------------------------+
戻り値は、国別文字表現 (CCSID 13488) に変換される引数-1 の文字で構成される国別文字ストリングです。
ソース文字を国別文字に変換できない場合、ソース文字は、システム定義の置換文字 X'FFFD' に変換されます。例外条件は発生しません。
戻り値の長さは、引数-1 のコンテントおよびソース・コード・ページの特性によって異なります。
例外: 変換が失敗すると、重大なランタイム・エラーが発生します。ソース CCSID からターゲット CCSID (13488) への変換がオペレーティング・システムでサポートされていることを確認してください。
形式 2: ユーザー置換文字の指定 >>-FUNCTION NATIONAL-OF--(--引数-1--引数-3--)------------------><
引数-3 は、対応する国別文字を持たない英数字の変換で使用される国別置換文字を指定します。
ソース・コード・ページは、ソース・コードのコンパイル時に CCSID コンパイラー・オプション用に有効になるソース・コード・ページです。CCSID コンパイラー・オプションが 65535 である場合、デフォルトの CCSID 37 が使用されます。
戻り値は、国別文字表現 (CCSID 13488) に変換される引数-1 の文字で構成される国別文字ストリングです。ソース文字を国別文字に変換できない場合、ソース文字は、ユーザー置換文字引数-3 に変換されます。例外条件は発生しません。
戻り値の長さは、引数-1 のコンテントおよびソース・コード・ページの特性によって異なります。
例外: 変換が失敗すると、重大なランタイム・エラーが発生します。ソース ccsid からターゲット CCSID (UCS-2) への変換がオペレーティング・システムでサポートされていることを確認してください。