Rational Developer for System z
COBOL for Windows バージョン 7.5 言語解説書


DISPLAY-OF

DISPLAY-OF 関数は、特定のコード・ページ表現に変換された引数-1 の内容から構成される英数字ストリングを戻します。

この関数のタイプは英数字です。

フォーマット
構文図を読む構文図をスキップする>>-FUNCTION DISPLAY-OF--(--引数-1--+--------+--)---------------><
                                   '-引数-2-'     
 
引数-1
国別クラス (使用法 NATIONAL を指定して記述されている、国別、国別編集、および数字編集カテゴリー) でなければなりません。引数-1 は変換に使用するソース・ストリングを示します。
引数-2
整数であるか、クラスが英数字でなければなりません。引数-2 は変換に使用する出力コード・ページを示します。

引数-2 は、EBCDIC、ASCII、UTF-8、UTF-16、または EUC コード・ページ、あるいは 付録F. コード・ページ名に示される UTF-16LE 以外のコード・ページのいずれかでなければなりません。EBCDIC または ASCII コード・ページには 1 バイト文字と 2 バイト文字の両方を含めることができます。

引数-2 が整数の場合、整数は有効な CCSID 番号である必要があります。引数-2 のクラスが英数字の場合、内容は 付録F. コード・ページ名に示される基本または代替コード・ページ名である必要があります。

引数-2 を省略すると、出力コード・ページはランタイムのロケールから決定されます。

戻り値は、出力コード・ページの表現に変換された引数-1 の文字で構成される英数字ストリングです。 ソース文字を出力コード・ページの文字に変換できないときは、ソース文字が置換文字によって置き換えられます。一般的に使用されているいくつかのコード・ページの置換文字を以下の表に示します。

出力コード・ページ  置換文字
 SBCS ASCII
 PC Windows SBCS
 X'7F'
 EBCDIC SBCS  X'3F'
 ASCII DBCS  X'FCFC'
 EBCDIC DBCS (タイ語以外)  X'FEFE'
 EBCDIC DBCS (タイ語)  X'41B8'
 PC DBCS (日本語または中国語)  X'FCFC'
 PC DBCS (韓国語)  X'BFFC'
 EUC (韓国語)  X'AFFE'
 EUC (日本語)  X'747E'
 UTF-8  SBCS から変換する場合: X'1A'
 MBCS から変換する場合: X'EFBFBD'
 UTF-16  SBCS から変換する場合: X'001A'
 MBCS から変換する場合: X'FFFD'

例外条件は発生しません。

戻り値の長さは、引数-1 の内容および出力コード・ページの特性によって異なります。

使用上の注意

例外: 変換が失敗した場合、重大なランタイム・エラーが発生します。


ご利用条件 | フィードバック

Copyright IBM Corporation 1996, 2008.
このインフォメーション・センターでは Eclipse テクノロジーが採用されています。(http://www.eclipse.org)