Skip to main content

PQL46 (PQL Function Library - CPM 4.6)

LEFT

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

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

NULL values: If the value is NULL, the result is NULL.

Syntax
LEFT ( table.column, n ) 

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

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'