User Tools

Site Tools


Table of Contents

SEARCH

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

Search Examples

The following examples use a SEARCH called search1

Example 1

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

Example Two

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

Example Three

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

Example Four

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

Example Five

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

Example Six (Regular Expressions)

  • 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)

Example Seven

  • 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)