Contains
(7.2)
Returns True or False, based on whether the first specified string contains the second specified string.
Usage
@Contains(<Substring>, <WithinString>, [<IgnoreCase>], [<HonorWildcards>])
| Argument Name |
Description |
| HonorWildcards |
Optional (default is FALSE). Whether to honor wildcards (* or ?). |
| IgnoreCase |
Optional (default is TRUE). Whether to ignore case. |
| Substring |
The substring to find in the WithinString. |
| WithinString |
The string to search for the Substring. |
Examples
@Contains
function example
|
A |
B |
C |
D |
E |
F |
| 1 |
Search |
within |
ignore case |
wildcards |
Eval |
Comments |
| 2 |
|
|
|
|
|
| 3 |
Spreadsheet |
Dodeca |
|
|
|
Should be FALSE because Dodeca does not contain text "Spreadsheet" |
| 4 |
deca |
Dodeca |
|
|
|
| 5 |
Deca |
Dodeca |
TRUE |
|
|
| 6 |
|
|
|
|
|
| 7 |
Deca |
Dodeca |
FALSE |
|
|
| 8 |
Deca |
Dodeca |
TRUE |
TRUE |
|
| 9 |
Dod |
Dodeca |
FALSE |
TRUE |
|
| 10 |
Dod??? |
Dodeca |
FALSE |
TRUE |
|
| 11 |
|
|
|
|
|
All blank input evaluates to TRUE because XYZ |
| 12 |
|
|
|
|
|
| 13 |
|
|
|
|
|
| Procedure |
|
| |
Method |
Overload |
ErrorHandlingMode |
|
| |
|
Argument |
Value |
Comment |
| OnAfterBuild |
|
| |
SetEntry
|
Text
|
|
|
| |
|
Address |
ContainsRange |
|
| |
|
CellByCell |
True |
|
| |
|
Entry |
=@Contains(@ValueText(A@CRow()), @ValueText(B@CRow()), @ValueText(C@CRow()), @ValueText(D@CRow())) |
|
|
A |
B |
C |
D |
E |
F |
| 1 |
Search |
within |
ignore case |
wildcards |
Eval |
Comments |
| 2 |
|
|
|
|
TRUE |
| 3 |
Spreadsheet |
Dodeca |
|
|
FALSE |
Should be FALSE because Dodeca does not contain text "Spreadsheet" |
| 4 |
deca |
Dodeca |
|
|
TRUE |
| 5 |
Deca |
Dodeca |
TRUE |
|
TRUE |
| 6 |
|
|
|
|
TRUE |
| 7 |
Deca |
Dodeca |
FALSE |
|
FALSE |
| 8 |
Deca |
Dodeca |
TRUE |
TRUE |
TRUE |
| 9 |
Dod |
Dodeca |
FALSE |
TRUE |
TRUE |
| 10 |
Dod??? |
Dodeca |
FALSE |
TRUE |
FALSE |
| 11 |
|
|
|
|
TRUE |
All blank input evaluates to TRUE |
| 12 |
|
|
|
|
TRUE |
| 13 |
|
|
|
|
TRUE |