| SYNOPSIS |
| #include <regexp.h> |
| |
| string * regexp(string *list, string pattern) |
| string * regexp(string *list, string pattern, int opt) |
| |
| DESCRIPTION |
| Match the pattern <pattern> (interpreted according to <opt> if |
| given) against all strings in list, and return a new array with all |
| strings that matched. |
| |
| If there is an error in the regular expression, a runtime |
| error will be raised. |
| |
| EXAMPLES |
| string strs; |
| string pattern; |
| |
| if (regexp_package() == RE_PCRE) |
| pattern = "\\<help\\>.*\\<me\\>"; |
| else |
| pattern = "\\bhelp\\b.*\\bme\\b"; |
| |
| if (strs = regexp(({"please, help me Sir John."}), pattern)) { |
| if (sizeof(strs) |
| write("It matches.\n"); |
| } |
| |
| The regular expression will test the given string (which is |
| packed into an array) if there is something like "help ... me" |
| inside of it. |
| |
| HISTORY |
| LDMud 3.3 added the optional <opt> argument. |
| Since 3.5.0 a error is raised if RE_PCRE is specified in <opt>, but |
| the driver lacks PCRE support. |
| |
| SEE ALSO |
| regexplode(E), regmatch(E), regreplace(E), regexp_package(E), sscanf(E), |
| regexp(C) |