STRING_TO_USINT

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

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

Função

            STRING_TO_USINT
           +-------------+
STRING ----|S            |---- USINT
           +-------------+

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 suportada pelo tipo de dado USINT.

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
USINT	—	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 : USINT;           (* valor convertido *)
END_VAR

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