substr

substr()

The substr() function extracts a substring from a value specified by the parameter.

Search for	Example	Results
A single word	`cat`	Topics that contain the word "cat". You will also find its grammatical variations, such as "cats".
A phrase. You can specify that the search results contain a specific phrase.	`"cat food"` (quotation marks)	Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase.

Search for	Operator	Example
Two or more words in the same topic	`AND` `and` `+` (plus symbol) `&` (ampersand)	`cat AND dog` `"cat food"+milk` `"cat food"&"dog food"`
Either word in a topic	`OR` `or` `\|` (pipe)	`cat OR dog` `cat \| dog`
Topics that do not contain a specific word or phrase	`NOT` `not` `!` (exclamation point)	`NOT cat` `! dog`
Topics that contain one string and do not contain another	`^` (caret)	`cat ^ mouse`
A combination of search types	`( )` parentheses	`cat + (dog \| mouse)` `cat \| dog + (! mouse)`

Example of the lng Function Translation
Service Manager function	Translated SQL equivalent:
select ps.number, ps.title from probsummary ps where substr(ps.openen.by, 0, 3)=”fal”	select t01.”NUMBER”, t01.”TITLE” from PROBSUMMARYM1 t01 where SUBSTR(t01.”OPENED_BY”) = ‘fal’

Example of the lng Function Translation

Service Manager function

Translated SQL equivalent:

select ps.number, ps.title from probsummary ps where substr(ps.openen.by, 0, 3)=”fal”

select t01.”NUMBER”, t01.”TITLE” from PROBSUMMARYM1 t01 where SUBSTR(t01.”OPENED_BY”) = ‘fal’

The first parameter can only be a field name or an expression that can be evaluated beforehand, it cannot be an expression that cannot be evaluated before translation into SQL. The other parameters can only be constant numbers or expressions that can be evaluated to numbers before translation into SQL:

The following cases are valid:

substr ( ps.category, 0, 4 ) //In this example, “category” is a field from file “probsummary”

substr ( $L.var, 0, 4 ) //In this example,$L.var is a local variable defined beforehand.

substr ( ps.title + ps.brief, 0, 4 )

substr ( ps.title + $L.var, 0, 4 )