Função BYTE( )

Retorna o caractere armazenado numa determinada posição no byte do registro atual.

Sintaxe

BYTE(localização_do_ byte)

Parâmetros

Nome Tipo Descrição
local_do_byte numérico

A posição de byte a ser retornada como valor de caractere.

O valor refere-se a uma posição no registro (a partir de 1), quaisquer que sejam as definições do campo.

Saída

Caractere.

Exemplos

Exemplos básicos

Retorna "1" de um registro que começa com um campo de ID que contém "1":

byte(112)

Exemplos avançados

Identificar registros em arquivos de impressão ou PDFs com base em uma formatação consistente

Utilize BYTE( ) para identificar os registros num arquivo de dados em que um caractere particular está presente na posição de byte particular. Normalmente, este é o caso em arquivos de imagem de impressão (Relatório) ou arquivos do Adobe Acrobat (PDF) em que os dados são formatados de forma consistente em todo o documento.

Por exemplo, para localizar e extrair registros que incluem um período na posição de byte 113:

EXTRACT RECORD IF BYTE(113) = "." TO “Saída.fil”

Observações

Quando usar BYTE( )

Use BYTE( ) para examinar o conteúdo de uma posição em um registro, sem precisar definir um campo para isso.

Uso de BYTE( ) em dados EBCDIC

Se você usar essa função em dados EBCDIC, o valor retornado também será EBCDIC. Pode ser impossível comparar esses dados com valores de caracteres.

Funções relacionadas

Se desejar recuperar a representação binária para a localização de byte especificado, utilize a função BIT( ).