The DISPLAY-OF function returns an alphanumeric character string consisting of the content of argument-1 converted to a specific code page representation.
The type of the function is alphanumeric.
| Format |
|---|
|
argument-2 must identify an EBCDIC, ASCII, UTF-8, UTF-16, or EUC code page, or any of the code pages described in Appendix F. Code page names, except UTF-16LE. An EBCDIC or ASCII code page can contain both single-byte and double-byte characters.
When argument-2 is an integer, the integer must be a valid CCSID number. When argument-2 is of class alphanumeric, its content must be a primary or alternate code page name as described in Appendix F. Code page names.
If argument-2 is omitted, the output code page is determined from the runtime locale.
The returned value is an alphanumeric character string consisting of the characters of argument-1 converted to the output code page representation. When a source character cannot be converted to a character in the output code page, the source character is replaced with a substitution character. The following table shows substitution characters for some widely-used code pages:
| Output code page | Substitution character |
|---|---|
| SBCS ASCII
PC Windows SBCS |
X'7F' |
| EBCDIC SBCS | X'3F' |
| ASCII DBCS | X'FCFC' |
| EBCDIC DBCS (except for Thai) | X'FEFE' |
| EBCDIC DBCS (Thai) | X'41B8' |
| PC DBCS (Japanese or Chinese) | X'FCFC' |
| PC DBCS (Korean) | X'BFFC' |
| EUC (Korean) | X'AFFE' |
| EUC (Japanese) | X'747E' |
| UTF-8 | From SBCS: X'1A'
From MBCS: X'EFBFBD' |
| UTF-16 | From SBCS: X'001A'
From MBCS: X'FFFD' |
No exception condition is raised.
The length of the returned value depends on the content of argument-1 and the characteristics of the output code page.
Usage notes
Exception: If the conversion fails, a severe runtime error occurs.