SINT_TO_STRING

Converte o valor numérico do parâmetro fornecido em uma string; é uma função pura (sem estado; retorna o resultado diretamente).

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

Função

          SINT_TO_STRING
         +-------------+
SINT ----|IN           |---- STRING
         +-------------+

Se a string de retorno não puder receber o valor fornecido, a função define a variável de erro de sistema com o valor HILS.FAIL (1). Este valor pode ser 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	Padrão	Faixa / Unidade	Descrição
IN	IN	SINT	—	—	Valor a ser convertido para string.

Retorno / Saídas

Tipo	Faixa / Unidade	Descrição
STRING	—	Valor numérico do parâmetro `IN` em formato string. Se houver falha no processo, a variável de erro de sistema (SYSTEM_ERR) é definida com o valor FAIL.

Observações

É de responsabilidade do usuário garantir que a string de destino tenha tamanho suficiente para armazenar o valor convertido.
Em caso de falha, o tipo de erro gerado pode ser obtido através da função GET_SYSTEM_ERR ( ).

Exemplo

Clique aqui para baixar a tabela de variáveis

Código ST

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

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