STRING_TO_REAL

Converte se possível o contéudo da string fornecida em um valor númerico do tipo REAL. Se o conteúdo da string não for um valor numérico valido a função retorna 0 e 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 ( ).

Nota

É de responsabilidade do usuário garantir que o valor numérico da string possa ser representado dentro da faixa de valores suportado pelo tipo de dado REAL.

Bloco

            STRING_TO_REAL
           +-------------+
STRING ----|S            |---- REAL
           +-------------+

Parâmetro

Nome	Parâmetro	Tipo Dado	V. Ini.	Descrição
S	Entrada	STRING		string a ser convertida

Retorno

Tipo Dado	Descrição
REAL	Valor numerico da string fornecida se conversão possível. Se falha no processo retorna 0 e seta variavel de erro de sistema (SYSTEM_ERR).

Exemplo

Declaração de variáveis

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

Clique aqui para baixar a tabela de variáveis

Código ST

// Exemplo de ativação da função dentro da POU
(* ... *)
i_val := STRING_TO_REAL(str);
IF (HILS.GET_SYSTEM_ERR() = HILS.SUCCESS)  THEN
  (* conversão com sucesso i_val recebe o valor 123 da string de teste *)

ELSE
  (* conversão com falha i_val retorna 0  *)

END_IF;
(* ... *)