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
SIN	ANY_REAL	Sine (in rads)
COS	ANY_REAL	Cosine (in rads)
TAN	ANY_REAL	Tangent (in rads)
ASIN	ANY_REAL	Arcsin
ACOS	ANY_REAL	Arccos
ATAN	ANY_REAL	Arctan
ATAN2	ANY_REAL	Arctan at a given point (x,y)
ADD	ANY_NUM	Addition
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
ADD	TIME	TIME	TIME
ADD	DT	TIME	DT
ADD_TIME	TIME	TIME	TIME
ADD_TOD_TIME	TOD	TIME	TOD
ADD_DT_TIME	DT	TIME	DT
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).