Guide Section: Processing Object Data | EASAP Tree: DATA PROCESSING Branch

SEARCH performs a search to see if one string is present within another.

SEARCH may test whether a string starts, ends or contains another string.

SEARCH may find the position within the string of the first or last occurrence of the search string.

The search string Search Text: will often contain one or more object references. Any LIST references here are EXPAND'd to create a SCALAR before any matching is done.

A regular expression provides an advanced template or pattern for matching text.

SEARCH
Essential Parameters:
Value:	Choose a SCALAR from drop-down list to match to Search Text:.
Search Text:	The text to compare with Value:, object reference(s) allowed
Function:	String match operation (CONTAINS, ENDS WITH, EQUALS, FIRST, LAST, STARTS WITH)
Optional Parameters:
Delimiter:	Character to delimit an object reference in Search Text: above. default→ %
Allow Regular Expressions:	default→FALSE, TRUE

The following examples use a SEARCH called search1

• Value: Error Code: 131
• Search Text: Error
• Function: CONTAINS
• search1→TRUE

• Value: Error Code: 131
• Search Text: error
• Function: CONTAINS
• search1→FALSE (case does not match)

• Value: Error Code: 131
• Search Text: Error
• Function: STARTS WITH
• search1→TRUE

• Value: Error Code: 131
• Search Text: :
• Function: FIRST
• search1→11 (11th character is the first match)

• Value: Error Code: 131
• Search Text: $
• Function: FIRST
• search1-1 (-1 indicates no match)

• Value: Error Code: 131
• Search Text: : [\d]{3}
• Function: CONTAINS
• Allow Regular Expressions: TRUE
• search1→TRUE (searched for a colon followed by a space followed by three numbers)

• Value: Error Code: 131
• Search Text: : [\d]{4}
• Function: CONTAINS
• Allow Regular Expressions: TRUE
• search1→FALSE (searched for a colon followed by a space followed by 4 numbers)