STRING_TO_INT

Converte o conteúdo de uma string em um valor numérico do tipo INT. É uma função pura (sem estado; retorna o resultado diretamente).

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

Função

            STRING_TO_INT
           +-------------+
STRING ----|S            |---- INT
           +-------------+

Converte o conteúdo da string informada em S para um valor numérico do tipo INT. Se o conteúdo da string não for um valor numérico válido, a função retorna 0 e sinaliza a variável de erro de sistema com o valor HILS.FAIL (1), que pode ser obtido através de 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 INT.

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
INT	—	Valor numérico da string fornecida em S, se a conversão for possível. Em caso de falha, retorna 0 e sinaliza a variável de erro de sistema (GET_SYSTEM_ERR).

Observações

• O conteúdo da string deve representar um valor numérico válido e dentro da faixa suportada pelo tipo INT; caso contrário a conversão falha (retorno 0) e a variável de erro de sistema é sinalizada com HILS.FAIL.

Exemplo

Clique aqui para baixar a tabela de variáveis

Código ST

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

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