FC_NegativePart

FC_NegativePart - General Information

Overview

Task

Determine the negative part of a value.

Description

The negative part is defined as follows:

oi_lrValue >= 0.0 -> 0.0

oi_lrValue < 0.0 -> ABS(i_lrValue)

Together with the function FC_PositivePart the following identity applies to all real lrValues:

lrValue = FC_PositivePart(lrValue) - FC_NegativePart(lrValue)

Interface

Input	Data type	Description
i_lrValue	LREAL	Value of the number of which the negative part is to be determined

Output	Data type	Description
q_etDiag	GD.ET_Diag	General library-independent statement on the diagnostic. A value not equal to ET_Diag.Ok corresponds to an diagnostic message.
q_etDiagExt	ET_DiagExt	POU-specific output on the diagnostic. q_etDiag = ET_Diag.Ok -> Status message q_etDiag <> ET_Diag.Ok -> Diagnostic message

Output

Data type

Description

q_etDiag

General library-independent statement on the diagnostic.

A value not equal to ET_Diag.Ok corresponds to an diagnostic message.

q_etDiagExt

POU-specific output on the diagnostic.

q_etDiag = ET_Diag.Ok -> Status message

q_etDiag <> ET_Diag.Ok -> Diagnostic message

Return Value

Data type	Description
LREAL	Negative part of the value i_lrValue

Diagnostic Messages

q_etDiag	q_etDiagExt	Enumeration value	Description
OK	Ok	0	Ok

The negative part has been calculated successfully.