Prefácio
A Linguagem de Transformação
Constantes
Operadores
Variáveis
Datas
Funções
- Categorias de função
  - Funções de agregação
  - Funções de agregação e Nulls
    - Condições do Filtro
  - Funções binárias
  - Funções de caractere
  - Funções de conversão
  - Funções de Limpeza de Dados
  - Funções de data
  - Funções de codificação
  - Funções financeiras
  - Funções numéricas
  - Funções científicas
  - Funções especiais
  - Funções de string
  - Funções de teste
  - Funções variáveis
  - Funções de janela
- ABORT
- ABS
- ADD_TO_DATE
- AES_DECRYPT
- AES_ENCRYPT
- ASCII
- AVG
- BINARY_COMPARE
- BINARY_CONCAT
- BINARY_LENGTH
- BINARY_SECTION
- CEIL
- CHOOSE
- CHR
- CHRCODE
- COMPRESS
- CONCAT
- CONVERT_BASE
- COS
- COSH
- COUNT
- CRC32
- CUME
- DATE_COMPARE
- DATE_DIFF
- DEC_BASE64
- DEC_HEX
- DECODE
- DECOMPRESS
- EBCDIC_ISO88591
- ENC_BASE64
- ENC_HEX
- ERROR
- EXP
- FIRST
- FLOOR
- FV
- GET_DATE_PART
- GREATEST
- IIF
- IN
- INDEXOF
- INITCAP
- INSTR
- ISNULL
- IS_DATE
- IS_NUMBER
- IS_SPACES
- LAG
- LAST
- LAST_DAY
- LEAD
- LEAST
- LENGTH
- LN
- LOG
- LOOKUP
- LOWER
- LPAD
- LTRIM
- MAKE_DATE_TIME
- MAX (Datas)
- MAX (Números)
- MAX (String)
- MD5
- MEDIAN
- METAPHONE
- MIN (Datas)
- MIN (Números)
- MIN (String)
- MOD
- MOVINGAVG
- MOVINGSUM
- NPER
- PERCENTILE
- PMT
- POWER
- PV
- RAND
- RATE
- REG_EXTRACT
- REG_MATCH
- REG_REPLACE
- REPLACECHR
- REPLACESTR
- REVERSE
- ROUND (Datas)
- ROUND (Números)
- RPAD
- RTRIM
- SETCOUNTVARIABLE
- SET_DATE_PART
- SETMAXVARIABLE
- SETMINVARIABLE
- SETVARIABLE
- SHA256
- SIGN
- SIN
- SINH
- SOUNDEX
- SQRT
- STDDEV
- SUBSTR
- SUM
- SYSTIMESTAMP
- TAN
- TANH
- TIME_RANGE
- TO_BIGINT
- TO_CHAR (Datas)
- TO_CHAR (Números)
- TO_DATE
- TO_DECIMAL
- TO_FLOAT
- TO_INTEGER
- TRUNC (Datas)
- TRUNC (Números)
- UPPER
- VARIANCE
Criação de funções personalizadas
Referência de API da Função Personalizada

Referência de Linguagem de Transformação

10.5
- 10.4.0

Anterior Avançar

BINARY_SECTION

Retorna uma parte de um valor binário.

Para usar a função

BINARY_SECTION

, defina a variável de ambiente

INFA_ENABLE_BINARY_FUNCTIONS

como True ou Yes.

Sintaxe

BINARY_SECTION( binary, start [,length] )

A tabela a seguir descreve o argumento para este comando:

Argumento	Obrigatório/ Opcional	Descrição
binário	Obrigatório	Você pode inserir um valor binário ou qualquer expressão de transformação que retorne um tipo de dados binário.
início	Obrigatório	Você pode inserir um número inteiro ou qualquer expressão de transformação que retorne um número inteiro. A posição no binário em que você deseja começar a contagem. Se a posição inicial for um número positivo, BINARY_SECTION localizará a posição inicial contando a partir do começo do binário de entrada. Se a posição inicial for um número negativo, BINARY_SECTION localizará a posição inicial contando a partir do fim do binário de entrada. Se a posição inicial for 0, BINARY_SECTION pesquisará desde o primeiro byte no binário de entrada.
length	Opcional	Você pode inserir um número inteiro maior que 0 ou qualquer expressão de transformação que retorne um número inteiro positivo. O número de bytes que você deseja que BINARY_SECTION retorne. Se você omitir o argumento length, BINARY_SECTION retornará todos os bytes da posição inicial até o final do binário de entrada. Se você transmitir um inteiro negativo ou 0, a função retornará um erro.

Valor de Retorno

Binário.

NULL se a entrada for um valor nulo.

Exemplo

As expressões a seguir retornam os primeiros três bytes de um valor binário.

BINARY_SECTION( SYSID, 0, 3 )

SYSID (Shown in Hex)	RETURN VALUE (Shown in Hex)
0x00010203	0x000102
0x0405060708	0x040506
NULL	NULL

As expressões a seguir retornam os bytes 4 a 8 de um valor binário.

BINARY_SECTION( SYSID, 4, 5 )

SYSID (Shown in Hex)	RETURN VALUE (Shown in Hex)
0x000102030405060708	0x0304050607
0x0405060708090A0B	0x0708090A0B
NULL	NULL

Você também pode passar um valor inicial negativo. A expressão ainda lê o binário de origem da esquerda para a direita ao retornar o resultado do argumento length
: