StringTools[RegMatch] - determine if a string matches a regular expression
|
Calling Sequence
|
|
RegMatch(pattern, text, options)
|
|
Parameters
|
|
pattern
|
-
|
string; regular expression to match
|
text
|
-
|
string; text to test
|
options
|
-
|
(optional) name; subexpression substitution
|
|
|
|
|
Description
|
|
•
|
The RegMatch( pattern, text ) function determines whether a string text matches the regular expression pattern.
|
|
If the string text matches the regular expression specified by pattern, the value true is returned. If text does not match pattern, the value false is returned.
|
|
Note: If the pattern argument contains syntax errors, Maple may signal an error.
|
•
|
Up to nine names can be passed to RegMatch in the options parameter. Upon a successful match, the first of these symbols is assigned the substring of text that matches the entire regular expression pattern, and the remaining symbols are assigned the portions of text that match any parenthesized subexpressions, if any.
|
•
|
This function is part of the StringTools package, and so it can be used in the form RegMatch(..) only after executing the command with(StringTools). However, it can always be accessed through the long form of the command by using the form StringTools[RegMatch](..).
|
|
|
Examples
|
|
>
|
|
>
|
|
| (1) |
>
|
|
| (2) |
>
|
|
| (3) |
>
|
|
| (4) |
>
|
|
| (5) |
>
|
|
| (6) |
>
|
|
| (7) |
>
|
|
| (8) |
>
|
|
| (9) |
>
|
|
| (10) |
>
|
|
| (11) |
>
|
|
| (12) |
>
|
|
| (13) |
>
|
|
| (14) |
>
|
|
| (15) |
>
|
|
| (16) |
The following is a Maple implementation of the `grep' text searching tool.
>
|
|
>
|
|
| (17) |
In the following example, the matching string and substrings are assigned to names.
>
|
|
| (18) |
| (19) |
|
|
Download Help Document
Was this information helpful?