SET_REAL_PRECISION

Define o número de casas decimais usado na conversão de valores reais para string realizada pela função REAL_TO_STRING; é uma função.

Biblioteca: HI_STD · Namespace: HILS · Tipo: função

Função

         SET_REAL_PRECISION
        +-------------------+
INT ----|                   |
        +-------------------+

Por padrão a precisão é igual a 3, ou seja, a conversão de valores reais para string resulta em valores com 3 casas decimais. A precisão corrente pode ser obtida pela função GET_REAL_PRECISION.

Parâmetros

Nome	Direção	Tipo	Padrão	Faixa / Unidade	Descrição
IN	IN	INT	—	casas decimais	Número de casas decimais usado no processo de conversão.

Retorno / Saídas

Nenhum. A função não retorna valor.

Observações

O valor padrão da precisão é 3 casas decimais.
A precisão corrente pode ser consultada com GET_REAL_PRECISION.

Ver também

REAL_TO_STRING, GET_REAL_PRECISION

Exemplo

Clique aqui para baixar a tabela de variáveis

Código ST

VAR
    str   : STRING := '';    (* string de teste *)
    r_val : REAL := 34.4567; (* valor a ser convertido *)
END_VAR

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

(* Limita o número de casas decimais em 2 *)
IF (HILS.GET_REAL_PRECISION() > 2) THEN
  HILS.SET_REAL_PRECISION(2);
END_IF;

(* Converte o valor r_val para uma string *)
str := HILS.REAL_TO_STRING(r_val);
(* str recebe o conteúdo '34.46' *)

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

(* Converte o valor r_val para uma string *)
str := HILS.REAL_TO_STRING(r_val);
(* str recebe o conteúdo '34.457' *)