Documentation

Standard functions

Standard functions can be used in all programming languages (FUPLA, ST), some of them may be overloaded (they work over different types, e.g. addition) and some of them are extendable (may have variable number of inputs, e.g. logical AND).

Type conversion functions

Function name Description Example
..._TO_... Conversion of first data type to second data type A:=INT_TO_REAL(B);
TO_... Overloaded data type conversion A:=TO_REAL(B);
..._TRUNC_... Truncating, or "cutting", of ANY_REAL to ANY_INT A:=REAL_TRUNC_INT(B);
..._BCD_TO_... Conversion ANY_BIT to ANY_INT A:=WORD_BCD_TO_INT(B);

Numerical functions

Function name I/O data type Description
ABS ANY_NUM Absolute value
SQRT ANY_REAL Square root
LN ANY_REAL Natural logarithm
LOG ANY_REAL Common logarithm
EXP ANY_REAL Natural exponential function
ASIN ANY_REAL Arcsin
ACOS ANY_REAL Arccos
ATAN ANY_REAL Arctan
ATAN2 ANY_REAL Arctan at a given point (x,y)
MUL ANY_NUM Multiplication
SUB ANY_NUM Subtraction
DIV ANY_NUM Division
MOD ANY_NUM Modulo
EXPT ANY_NUM Exponentiation
MOVE ANY_NUM Assignment

Bit chain functions

Function name I/O data type Description
SHL ANY_BIT Shift to left (completed by zeros from the right)
SHR ANY_BIT Shift to right (completed by zeros from the left)
ROL ANY_BIT Rotate to left
ROR ANY_BIT Rotate to right
AND ANY_BIT Logical AND (like A:=AND(B,C,D); or A:=B&C&D;)
OR ANY_BIT Logical OR
XOR ANY_BIT Logical EXOR
NOT ANY_BIT Negation

Selecting functions

Function name I/O data type Description
MOVE ANY Assignment (Example: A:=B;)
SEL ANY Binary selection (Example.: OUT:=IN if G=0;)
MAX ANY Maximum
MIN ANY Minimum
LIMIT ANY Limiter
MUX ANY Multiplexer

Comparing functions

Function name Symbol Description
GT > Decreasing sequence
GE >= Monotonous decreasing sequence
EQ = Equality
LE <= Monotonous increasing sequence
LT < Increasing sequence
NE <> Inequality

Functions over strings

Function name I/O data type Description
LEN ANY_STRING/ANY_INT String length
LEFT ANY_STRING/ANY_INT Copy given number of characters from left of the input string
RIGHT ANY_STRING/ANY_INT Copy given number of characters from right of the input string
MID ANY_STRING/ANY_INT Copy given number of characters from a given position of the input string (Example.: OUT:=MID(IN,10,3);)
CONCAT ANY_STRING Concatenation (linking) of strings
INSERT ANY_STRING/ANY_INT Insert a string at a given position
DELETE ANY_STRING/ANY_INT Delete a given number of characters at a given position
REPLACE ANY_STRING/ANY_INT Replace a given number of characters from a given position
FIND ANY_STRING/ANY_INT Find the position of first appearance of a substring

Date and time functions

Function name IN1 IN2 OUT
SUB TIME TIME TIME
SUB DATE DATE TIME
SUB TOD TIME TOD
SUB TOD TOD TIME
SUB DT TIME DT
SUB DT DT TIME
SUB_TIME TIME TIME TIME
SUB_DATE_DATE DATE DATE TIME
SUB_TOD_TIME TOD TIME TOD
SUB_TOD_TOD TOD TOD TIME
SUB_DT_TIME DT TIME DT
SUB_DT_DT DT DT TIME
MUL TIME ANY_NUM TIME
MUL_TIME TIME ANY_NUM TIME
DIV TIME ANY_NUM TIME
DIV_TIME TIME ANY_NUM TIME

The functions stated above are extended by the CONCAT and SPLIT functions, which link and cut parts of date and time variables. For example, the SPLIT_DATE function separates a date into three INT values (year, month, and day).