REAL_TO_STRING

Converte e retorna o valor numérico do parâmetro fornecido em uma string. Se a string de retorno não puder receber o valor fornecido a função seta 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 ( ).

O nro. de casas decimais utilizado no processo de conversão é controlado pela função SET_REAL_PRECISION ( ) presente na biblioteca HISTD. Por default o valor é convertido com 3 casas decimais.

Pode-se obter o valor corrente do nro. de casas com a função GET_REAL_PRECISION ( ).

Nota

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

Bloco

          REAL_TO_STRING
         +-------------+
REAL ----|IN           |---- STRING
         +-------------+

Parâmetro

Nome	Parâmetro	Tipo Dado	V. Ini.	Descrição
IN	Entrada	REAL		valor a ser convertido para string

Retorno

Tipo Dado	Descrição
STRING	Valor numerico do parâmetro IN em formato string. Se falha no processo seta variável de erro de sistema (SYSTEM_ERR) com o valor FAIL.

Exemplo

Declaração de variáveis

Nome	Tipo	Valor Inicial	Descrição
str	STRING	‘’	string de teste
i_val	REAL	34.4567	valor a ser convertido

Clique aqui para baixar a tabela de variáveis

Código ST

// Exemplo de ativação da função dentro da POU
(* ... *)

(* Define o nro de casas decimais utilizadas na conversão *)
HILS.SET_REAL_PRECISION(2);

str := REAL_TO_STRING(i_val);
(* str recebe recebe o conteudo '34.46' *)

(* Redefine o nro de casas decimais utilizadas na conversão *)
HILS.SET_REAL_PRECISION(3);

str := REAL_TO_STRING(i_val);
(* str recebe recebe o conteudo '34.457' *)
(* ... *)