StringMatchQ

StringMatchQ["string",patt]

tests whether "string" matches the string pattern patt.

StringMatchQ["string",RegularExpression["regex"]]

tests whether "string" matches the specified regular expression.

StringMatchQ[{s1,s2,…},p]

gives the list of results for each of the si.

StringMatchQ[patt]

represents an operator form of StringMatchQ that can be applied to an expression.

Details and Options

  • StringMatchQ allows both ordinary StringExpression string patterns, as well as abbreviated string patterns containing the following metacharacters:
  • *zero or more characters
    @one or more characters, excluding uppercase letters
    \\*, etc.literal *, etc.
  • Verbatim["p"] specifies the verbatim string "p", with * and @ treated literally.
  • Setting the option IgnoreCase->True makes StringMatchQ treat lowercase and uppercase letters as equivalent.
  • Setting the option SpellingCorrection->True makes StringMatchQ allow strings to match even if a small fraction of their characters are different.
  • StringMatchQ[form][expr] is equivalent to StringMatchQ[expr,form].

Examples

open allclose all

Basic Examples  (3)

Test whether a string pattern matches a particular string:

In[1]:=
Click for copyable input
Out[1]=

Use abbreviated string patterns:

In[1]:=
Click for copyable input
Out[1]=

Use the operator form of StringMatchQ:

In[1]:=
Click for copyable input
Out[1]=

Scope  (5)

Options  (2)

Applications  (1)

Properties & Relations  (3)

Possible Issues  (2)

See Also

StringContainsQ  StringFreeQ  StringPosition  StringCases  Equal  Names  MatchQ  StringExpression  RegularExpression  EditDistance

Tutorials

Introduced in 1988
(1.0)
| Updated in 2016
(10.4)