Skip to main content

PQL47 (PQL Function Library - CPM 4.7)

LEFT

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

Description

LEFT returns the first n characters of a string. If the string is smaller than n characters, the whole string is returned.

Supported input column types: STRING

Output column type: STRING

Syntax
LEFT ( table.column, n ) 

If n is zero or negative, an empty STRING will be returned for all input, except NULL.

NULL handling

If the input value is NULL, the result is NULL as well.

Example

[1] Get first character of string.

Query

Column1

LEFT ( "Table1"."Column1" , 1 )

Input

Output

Table1

Column1 : STRING

'abc'

' bc'

''

null

''

null

'Left'

'Right'

Result

Column1 : STRING

'a'

''

''

null

''

null

'L'

'R'

See also: