DINT_TO_STRING

Converte o valor numérico de uma variável DINT em uma STRING. É uma função pura (sem estado; retorna o resultado diretamente).

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

Função

          DINT_TO_STRING
         +-------------+
DINT ----|IN           |---- STRING
         +-------------+

Esta função converte o valor numérico fornecido em IN para sua representação em texto (STRING).

Nota

É de responsabilidade do usuário garantir que a variável STRING que irá receber o valor convertido tenha tamanho suficiente para armazená-lo. Se a conversão falhar, a função define a variável de erro de sistema com o valor HILS.FAIL (1), obtido através de GET_SYSTEM_ERR ( ).

Parâmetros

Nome	Direção	Tipo	Padrão	Faixa / Unidade	Descrição
IN	IN	DINT	—	—	Valor numérico a ser convertido para string.

Retorno / Saídas

Tipo	Faixa / Unidade	Descrição
STRING	—	Valor de IN convertido em texto. Em caso de falha na conversão (por exemplo, string de destino sem tamanho suficiente), a variável de erro de sistema (SYSTEM_ERR) é definida com o valor HILS.FAIL.

Observações

• Garanta que a variável STRING de destino tenha tamanho suficiente para receber o valor convertido, evitando erro de sistema.

Exemplo

Clique aqui para baixar a tabela de variáveis

Código ST

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

(* Exemplo de ativação da função dentro da POU *)
(* ... *)
str := DINT_TO_STRING(i_val);
(* str recebe o conteúdo '3452234' *)
(* ... *)