• Home
• Function/Function Block Reference
• IEC 61131-3 Functions and Function Blocks
• Arithmetic
• DIV / DIV_S

DIV / DIV_S

Type	Function Available as standard (non-safety-related) and safety-related type (*_S). For the safety-related type, the safety-related data types (SAFE*) are expected at the formal parameters.
Description	Divides the operand connected to IN1 by the operand connected to IN2. Note This function is not extendable, no further inputs can be added.
Notes	Division of a TIME value by a larger data type (type casting): Before the division operation is performed, the larger data type (e.g., LINT, ULINT, LREAL) connected to IN2 is temporarily converted (casted) to the smaller TIME data type. A division by zero leads to a runtime exception which results in calling an Event Handler and a controller stop. This applies only if the ENO output is not connected. For the EN/ENO behavior of the function in case of a division by zero, see the description below. The result of the division is always rounded downwards. For example, 90/7 returns 12 not 13. Overloaded function. The function can operate on various input data types. The function provides implicit data type conversion at its input and output parameters according to the rules defined by the IEC 61131 standard.
Parameters	Inputs IN1 Data type: ANY_(SAFE)MAGNITUDE Description: Dividend IN2 Data type: ANY_(SAFE)NUM Description: Divisor Output Out Data type: ANY_(SAFE)MAGNITUDE Description: Output value
Error behavior	Error behavior The following table shows the errors which may occur while executing the function and the value returned by the function in the corresponding error case. Error case Output value RFC/NFC/AXC F 3152 Output value AXC F 2152 Div of nums and reals: IN1 not Inf+, IN2 < 1 Inf+- (depending on input values) Inf+- (depending on input values) Div of nums and reals: NaN NaN NaN Div of nums and reals: IN1 = Inf+ Inf+ Inf+ Div of nums and reals: IN1 not Inf+, IN2 = Inf+ Note: ENO stays true in the error case. 0 0 Div of nums and reals: IN1 = Inf- Inf- Inf- Div of nums and reals: IN1 not Inf+-, IN2 = Inf- Note: ENO stays true in the error case. 0 0 Div of reals: any combination of Inf+- / Inf+- NaN NaN Div of 0 by x Note: ENO stays true in the error case. 0 0 Div of TIME: overflow (for values between - 1 and 1) Overflow Result > ULINT_MAX: T#0, LTIME_MIN Overflow Result > ULINT_MAX: T#-1ms, LT#-1ns Div of time and reals: NaN TIME_MIN, LTIME_MIN T#0, LT#0 Div of time and reals: Inf+ Note: ENO stays true in the error case. T#0, LT#0 T#0, LT#0 Div of time and reals: Inf- Note: ENO stays true in the error case. T#0, LT#0 T#0, LT#0 IN1 = int; IN2=0 Note: If ENO is not used, controller goes into Halt. 0 0 IN1 = real; IN2=0 Note: If ENO is not used, controller goes into Halt. 0 0 IN1 = time; IN2=0 Note: If ENO is not used, controller goes into Halt. T#0, LT#0 T#0, LT#0
Additional information	EN/ENO behavior The POU is only executed if TRUE is applied to the EN input. If EN = FALSE, the POU is not executed and ENO = FALSE indicates the inactivity. If any of the errors listed under "Error behavior" occurs while executing the function, ENO is set to FALSE (the error cases for which ENO stays TRUE are labeled correspondingly). Further Info See the topic "General information on execution control with EN/ENO" for further details.