Intrinsic functions - Enterprise COBOL for z/OS 6.3.0
A função DISPLAY-OF retorna uma sequência de caracteres alfanuméricos que consiste no conteúdo do argument-1 convertido em uma representação específica da página
de códigos.
O tipo da função é alfanumérico.
- argument-1
- Deve ser da classe nacional (categorias nacional, edição nacional e edição numérica descritas com o uso NATIONAL). argument-1 identifica a cadeia de origem da
conversão.
- argument-2
- Deve ser um número inteiro.
o argumento- identifica a página de código de saída para a conversão.
O argument-2 deve ser um número CCSID válido e deve identificar uma página de código EBCDIC, ASCII, UTF-8 ou EUC.
Uma página de código EBCDIC ou ASCII pode conter caracteres de um ou dois bytes.
Se o argument- 2 for omitido, a página de código de saída é a que estava em vigor para a opção do compilador CODEPAGE quando o código fonte foi compilado.
O valor retornado é uma cadeia de caracteres alfanuméricos que consiste nos caracteres do argument-1 convertidos na representação da página de códigos de saída.
Quando um caractere de origem não pode ser convertido em um caracter na página de código de saída, o caracter de origem é substituído por um caracter de
substituição.
A tabela a seguir mostra caracteres de substituição para algumas páginas de códigos amplamente usadas:
| Página de código de saída |
Caráter de substituição |
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' |
Nenhuma condição de exceção é gerada.
O comprimento do valor retornado depende do conteúdo do argument-1 e das características da página de código de saída.
Notas de uso
- O CCSID para UTF-8 é 1208.
- Se a página de código de saída incluir caracteres DBCS, o valor retornado poderá ser uma sequência SBCS e DBCS mista.
- A função DISPLAY-OF, com o argument-2 especificado, pode ser usada para gerar dados de caracteres representados em uma página de código que difere daquela
especificada na opção do compilador CODEPAGE.
As operações COBOL subsequentes nesses dados podem envolver conversões implícitas que assumem que os dados estão representados na página de código EBCDIC
especificada na opção do compilador CODEPAGE.
Consulte Converting to or from national (Unicode) representation para obter exemplos
e técnicas de programação para processar dados representados usando mais de uma página de código em um único programa.
Exceção:
se a conversão falhar, ocorrerá um erro grave de tempo de execução.
Verifique se os serviços de conversão Unicode do z/OS estão instalados e configurados para incluir a tabela para conversão do CCSID 1200 na página de código de
saída.
Consulte o Customization Guide para obter os requisitos de instalação para suportar a conversão.
© Copyright IBM Corp.
