SUB

Calcula a subtração de dois valores numéricos. É uma função pura (sem estado; retorna o resultado diretamente).

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

Função

                 SUB
            +-------------+
ANY_NUM ----|IN1          |---- ANY_NUM
            |             |
ANY_NUM ----|IN2          |
            +-------------+

Esta função calcula a subtração IN1 - IN2, aceitando como parâmetros qualquer tipo do grupo ANY_NUM (ver Grupos de tipos de dados para a lista completa de tipos suportados). O tipo de retorno é sempre o mesmo tipo dos parâmetros de entrada.

Nota

Todos os parâmetros de entrada e o valor de retorno devem ser do mesmo tipo de dados.

Parâmetros

Nome	Direção	Tipo	Faixa / Unidade	Descrição
IN1	IN	ANY_NUM	—	Operando 1 (minuendo).
IN2	IN	ANY_NUM	—	Operando 2 (subtraendo).

Retorno / Saídas

Tipo	Faixa / Unidade	Descrição
ANY_NUM	—	Valor resultante da subtração IN1 - IN2. O tipo é idêntico ao de IN1 e IN2.

Observações

• O firmware do equipamento pode não suportar todos os tipos de dados definidos no padrão IEC 61131-3. Consulte Recursos dependentes de implementação da norma IEC61131-3 para restrições de implementação específicas de cada firmware.

Exemplo

Clique aqui para baixar a tabela de variáveis

Código ST

VAR
    value_inp1 : REAL; (* operando 1 *)
    value_inp2 : REAL; (* operando 2 *)
    value_out  : REAL; (* valor resultante da função matemática *)
END_VAR

(* Exemplo de ativação da função dentro da POU *)
(* ... *)
value_inp1 := 2.0;  (* primeiro operando *)
value_inp2 := 3.0;  (* segundo operando *)
value_out  := value_inp1 - value_inp2; (* calcula a subtração *)

(* chamada alternativa como função SUB *)
value_out  := SUB(IN1 := value_inp1, IN2 := value_inp2); (* calcula a subtração *)
    (* resultado value_out = -1.0 *)
(* ... *)
value_out  := SUB(value_inp1, 20.0); (* calcula a subtração *)
    (* resultado value_out = -18.0 *)
(* ... *)
value_out  := SUB(-10.0, 20.0); (* calcula a subtração *)
    (* resultado value_out = -30.0 *)
(* ... *)