ULINT_TO_STRING

Converte o valor numérico do parâmetro de entrada em uma string e a retorna; é uma função pura (sem estado).

Biblioteca: IEC_STD · Namespace: IEC · Tipo: função

Função

          ULINT_TO_STRING
          +-------------+
ULINT ----|IN           |---- STRING
          +-------------+

Esta função converte o valor numérico fornecido em IN (tipo ULINT) para uma STRING e a retorna. Se a string de retorno não puder receber o valor convertido, a função seta a variável de erro de sistema com o valor HILS.FAIL (1), obtido através da função GET_SYSTEM_ERR ( ).

Nota

É de responsabilidade do usuário garantir que a string que irá receber o valor convertido tem um tamanho suficiente para armazená-lo.

Parâmetros

Nome	Direção	Tipo	Faixa / Unidade	Descrição
IN	IN	ULINT	—	Valor a ser convertido para string.

Retorno / Saídas

Tipo	Faixa / Unidade	Descrição
STRING	—	Valor numérico do parâmetro IN convertido para string. Se a conversão falhar, seta a variável de erro de sistema (SYSTEM_ERR) com o valor FAIL.

Observações

• Em caso de falha na conversão (string de destino sem tamanho suficiente), a variável de erro de sistema é setada com HILS.FAIL (1); consulte GET_SYSTEM_ERR ( ) para obter esse valor.

Exemplo

Clique aqui para baixar a tabela de variáveis

Código ST

VAR
    str   : STRING := '';     (* string de teste *)
    i_val : ULINT := 3452456; (* valor a ser convertido *)
END_VAR

(* Exemplo de ativação da função dentro da POU *)
(* ... *)
str := ULINT_TO_STRING(i_val);
(* str recebe o conteudo '3452456' *)

(* ... *)