GET_SYSTEM_ERR

Retorna o código de falha da execução da última chamada das funções de biblioteca que podem gerar erro durante o processamento. Neste caso, a função executada atribui em uma variável do firmware denominada SYSTEM_ERR um código de retorno que, quando igual a SUCCESS (0) indica que a função foi executada corretamente. Qualquer valor diferente de SUCCESS indica falha no processamento da função.

Atraves da função GET_SYSTEM_ERR() o conteudo desta variável pode ser obtido pelo programa de aplicação para validar a execução da função utilizada.

Atenção

O teste para verificar o resultado da função chamada deve ser realizado imediatamente após a execução da mesma, antes da chamada de qualquer outra função de biblioteca.

Para consultar a lista dos possíveis códigos de retorno obtido, acesse: RET_CODE - Códigos de retorno do firmware G5

Bloco

 GET_SYSTEM_ERR
+---------------+
|               |---- INT
+---------------+

Parâmetro

nenhum

Retorno

Tipo Dado	Descrição
INT	Código de erro da execução da função. = 0: função executada com sucesso <> 0: falha na execução da função

Exemplo

Declaração de variáveis

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

Clique aqui para baixar a tabela de variáveis

Código ST

(* Exemplo de utilização da função GET_SYSTEM_ERR para verificação de erros de execução *)
(* ... *)
// converte o conteudo de uma string em um valor numérico
// Neste caso o conteúdo pode nao ser numérico o que invalida a conversão
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;
(* ... *)