TEXT
notmatch
PATTERN

The notmatch operator checks to see if the text on the left does not match the wildcard pattern specified on the right.


Parameters

This operator has two parameters:

text – The text you want to match.

pattern – The wildcard pattern.


Description

The notmatch operator is the opposite of the match operator. Notmatch checks to see if the text on the left matches the wildcard pattern specified on the right, and returns false if it does. This operator is similar to the notcontains operator except that the ? and * characters have special meanings:

The ? character will match any single character.

The * character will match any number of characters, or no characters.

Any other characters in the pattern must match a character in the text on the left. For example if the pattern contains an x, the text on the left must contain an x in the same spot (actually either lower case x or upper case X is fine, since the notmatch operator is not case sensitive. If you want a case sensitive version of this operator use the notmatchexact operator.

Here are some examples:

"Jim Johnson" notmatch "j*johnson" ☞ false
"Jack Johnson" notmatch "j*johnson" ☞ false
"Bill Johnson" notmatch "j*johnson" ☞ true
"JJohnson" notmatch "j*johnson" ☞ false
"J346 Ujohnson" notmatch "j*johnson" ☞ false
"J@#opcjohnson" notmatch "j*johnson" ☞ false
"92685" notmatch "926??" ☞ false
"92685-1000" notmatch "926??" ☞ true
"9268" notmatch "926??" ☞ true
"(714) 555-1212" notmatch "(???) ???-????" ☞ false
"714-555-1212" notmatch "(???) ???-????" ☞ true

The notmatch function only has two special characters, making it easy to use but rather limited. For a much more powerful (and much more complicated) pattern matching operator see regexmatch, which uses Regular Expressions instead of simple wildcards.


See Also


History

VersionStatusNotes
10.0UpdatedCarried over from Panorama 6.0, but also now allows numeric as well as text parameters.