STRING_TO_ULINT

Converte, se possível, o conteúdo da string fornecida em um valor numérico do tipo ULINT; é uma função pura (sem estado; retorna o resultado diretamente).

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

Função

            STRING_TO_ULINT
           +-------------+
STRING ----|S            |---- ULINT
           +-------------+

Se o conteúdo da string não for um valor numérico válido, 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 ULINT.

Parâmetros

Nome	Direção	Tipo	Faixa / Unidade	Descrição
S	IN	STRING	—	String a ser convertida.

Retorno / Saídas

Tipo	Faixa / Unidade	Descrição
ULINT	—	Valor numérico da string fornecida, se a conversão for possível. Se falhar, retorna 0 e seta a variável de erro de sistema (SYSTEM_ERR).

Exemplo

Clique aqui para baixar a tabela de variáveis

Código ST

VAR
    str   : STRING := '123'; (* string de teste *)
    i_val : ULINT;           (* valor convertido *)
END_VAR

(* Exemplo de ativação da função dentro da POU *)
(* ... *)
i_val := STRING_TO_ULINT(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;
(* ... *)