includes (string)

includes (string) Task Purpose

The string includes task searches an input variable for a predefined value and returns 'true' if the value is found, or 'false' if the value is not found.

Potential Use Case

You could use this task if you need to scan an email list for the word 'unsubscribe' and execute a process to remove that email address from a database.

Properties

Example 1

In this IAP example:

• The str variable has been statically coded as 12 Dollars And 43 Cents.

• The searchString variable to search for is Cents.

• The position number to begin searching within the string has been statically coded as 19.

• The result will be false, which means no instance of the searchString occurs starting from position 18 of the str variable (starting at position 19, the str value reads "ents").

  

Example 2

In this IAP example:

• The str variable has been statically coded as 12 Dollars And 43 Cents.

• The searchString variable to search for is cents.

• The position number to begin searching within the string has been statically coded as 18.

• The result will be false because the searchString is case sensitive ("Cents" is not equal to "cents").

  

Example 3

In this IAP example:

• The str variable has been statically coded as 12 Dollars And 43 Cents.

• The searchString variable to search for is Cents.

• The position variable has been left blank (thereby defaulting to 0).

• The result will be true because the searchString ("Cents") does appear within the str variable.