HEXASCII_TO_RAW

Converte uma STRING com a representação hexadecimal-ASCII de uma sequência de bytes (por exemplo '1A2BFF') na sequência de bytes raw correspondente, gravada em um buffer de destino. É uma função (conversão pura, sem estado entre scans).

Biblioteca: HI_STD · Namespace: HILS · Tipo: função

Função

A função percorre a STRING de entrada tomando cada par de dígitos hexadecimais e convertendo-o no byte correspondente, produzindo no destino a sequência binária (raw) equivalente. É a operação inversa de RAW_TO_HEXASCII, que gera a STRING hexadecimal-ASCII a partir de um buffer de bytes.

Parâmetros

Nota

A interface (nomes, tipos e direção dos parâmetros) desta função não está descrita na fonte de documentação disponível. Consulte a assinatura exata do POU HILS.HEXASCII_TO_RAW no OnStudio antes de utilizá-la.

Pré-condições

  • A STRING de entrada deve conter apenas dígitos hexadecimais (0–9, A–F), em quantidade par — dois dígitos por byte.

  • O buffer de destino deve ter tamanho suficiente para acomodar todos os bytes resultantes (metade do número de caracteres da entrada).

Observações

  • Cada byte do resultado é formado por dois caracteres hexadecimais consecutivos da entrada; uma entrada com número ímpar de dígitos é inválida.

  • Use RAW_TO_HEXASCII para a conversão no sentido oposto (bytes raw ? STRING hexadecimal-ASCII).

Ver também

GET_HEXASC_STR