Skip to main content

PQL47 (PQL Function Library - CPM 4.7)

SUB

Applies to: CELONIS 4.0 CELONIS 4.2 CELONIS 4.3 CELONIS 4.4 CELONIS 4.5 CELONIS 4.6 CELONIS 4.7

Description

The subtraction operator computes the difference of two values.

The subtraction operator can be applied to INT or FLOAT columns or constants. The resulting column is of type INT if both input columns or constants are of type INT. In all other cases, the resulting column is of type FLOAT.

Syntax
SUB ( table.column1 , table.column2 )
table.column1 - table.column2
NULL handling

If one of the input values is NULL, the result is NULL as well.

Examples

[1] Subtract a constant INT value from a column of type INT.

Query

Column1

"Table1"."Column1" - 10

Input

OUtput

Table1

Column1 : INT

1

2

3

4

Result

Column1 : INT

-9

-8

-7

-6

[2] Subtract a constant FLOAT value from a column of type FLOAT.

Query

Column1

"Table1"."Column1" - 10.0

Input

Output

Table1

Column1 : FLOAT

1.0

2.0

3.0

4.0

Result

Column1 : FLOAT

-9.0

-8.0

-7.0

-6.0

[3] Subtract a constant FLOAT value from a column of type INT.

Query

Column1

"Table1"."Column1" - 10.0

Input

Output

Table1

Column1 : INT

1

2

3

4

Result

Column1 : FLOAT

-9.0

-8.0

-7.0

-6.0

[4] Subtract values of multiple INT and FLOAT columns.

Query

Column1

"Table1"."IntColumn1" - "Table1"."IntColumn2"

Column2

SUB ( "Table1"."IntColumn1" , "Table1"."FloatColumn1" )

Column3

"Table1"."FloatColumn1" - "Table1"."FloatColumn2"

Column4

"Table1"."IntColumn1" - "Table1"."IntColumn2" - "Table1"."FloatColumn1"

Column5

SUB ( "Table1"."IntColumn1" , "Table1"."IntColumn2" - "Table1"."FloatColumn1" )

Input

Output

Table1

IntColumn1 : INT

IntColumn2 : INT

FloatColumn1 : FLOAT

FloatColumn2 : FLOAT

20

5

10.0

20.0

30

15

14.0

7.0

40

null

12.0

22.0

50

30

null

23.0

null

45

14.0

null

Result

Column1 : INT

Column2 : FLOAT

Column3 : FLOAT

Column4 : FLOAT

Column5 : FLOAT

15

10.0

-10.0

5.0

25.0

15

16.0

7.0

1.0

29.0

null

28.0

-10.0

null

null

20

null

null

null

null

null

null

null

null

null