|
Main Page Class Hierarchy Alphabetical List Compound List File List Compound Members
|
FXRex is a regular expression class implementing a NFA matcher. More...
#include <FXRex.h>
Public Types | |
| enum | { Normal = 0, Capture = 1, IgnoreCase = 2, Newline = 4, Verbatim = 8, Syntax = 16, Unicode = 32 } |
| Regular expression parse flags. More... | |
| enum | { Forward = 0, Backward = 64, NotBol = 128, NotEol = 256, NotEmpty = 512 } |
| Regular expression match flags. More... | |
| enum | Error { ErrOK = 0, ErrEmpty = 1, ErrParent = 2, ErrBracket = 3, ErrBrace = 4, ErrRange = 5, ErrEscape = 6, ErrCount = 7, ErrNoAtom = 8, ErrRepeat = 9, ErrBackRef = 10, ErrClass = 11, ErrComplex = 12, ErrMemory = 13, ErrToken = 14, ErrBehind = 15 } |
| Regular expression error codes. More... | |
Public Member Functions | |
| FXRex () | |
| Construct empty regular expression object. | |
| FXRex (const FXRex &orig) | |
| Copy regular expression object. | |
| FXRex (const FXchar *pattern, FXint mode=Normal, Error *error=NULL) | |
| Compile expression from pattern; if error is not NULL, error code is returned. | |
| FXRex (const FXString &pattern, FXint mode=Normal, Error *error=NULL) | |
| Compile expression from pattern; if error is not NULL, error code is returned. | |
| FXRex & | operator= (const FXRex &orig) |
| Assign another regular expression to this one. | |
| FXbool | empty () const |
| See if regular expression is empty; the regular expression will be empty when it is unable to parse a pattern due to a syntax error. | |
| FXRex::Error | parse (const FXchar *pattern, FXint mode=Normal) |
| Parse pattern, return error code if syntax error is found. | |
| FXRex::Error | parse (const FXString &pattern, FXint mode=Normal) |
| Parse pattern, return error code if syntax error is found. | |
| FXbool | match (const FXchar *string, FXint len, FXint *beg=NULL, FXint *end=NULL, FXint mode=Forward, FXint npar=1, FXint fm=0, FXint to=2147483647) const |
| Match a subject string of length len, returning true if a match is found and false otherwise. | |
| FXbool | match (const FXString &string, FXint *beg=NULL, FXint *end=NULL, FXint mode=Forward, FXint npar=1, FXint fm=0, FXint to=2147483647) const |
| Search for match in a string. | |
| FXbool | operator== (const FXRex &rex) const |
| Comparison operators. | |
| FXbool | operator!= (const FXRex &rex) const |
| ~FXRex () | |
| Delete. | |
Static Public Member Functions | |
| static FXString | substitute (const FXchar *string, FXint len, FXint *beg, FXint *end, const FXString &replace, FXint npar=1) |
| After performing a regular expression match with capturing parentheses, a substitution string is build from the replace string, where where "&" is replaced by the entire matched pattern, and "\1" through "\9" are replaced by captured expressions. | |
| static FXString | substitute (const FXString &string, FXint *beg, FXint *end, const FXString &replace, FXint npar=1) |
| Return substitution string. | |
| static const FXchar * | getError (FXRex::Error err) |
| Returns error code for given error. | |
Friends | |
| FXAPI FXStream & | operator<< (FXStream &store, const FXRex &s) |
| Saving and loading. | |
| FXAPI FXStream & | operator>> (FXStream &store, FXRex &s) |
FXRex is a regular expression class implementing a NFA matcher.
It supports capturing parentheses, non-capturing parentheses, positive or negative lookahead, backreferences, case-insensitive matching, counted repetitions, lazy or greedy matches, and PERL-like matching operators. The subject string may be scanned forwards or backwards, and may contain any of 256 possible character values.
When parsing a regular expression pattern, the mode parameter is the bitwise OR of a set of flags and affects the match algorithm. Passing the flag Capture enables capturing parentheses and back references. The flag IgnoreCase enables case-insensitive matching. When the flag Newline is passed, newlines are treated like normal characters; otherwise, newline is NOT matched except when explicitly part of a character class. The flag Verbatim disables all special character interpretation.
When matching a compiled pattern, the mode parameter is the bitwise OR of a set of flags that affects how the match is performed. Passing the flag Backward causes the match to proceed backwards through the subject string. Passing the flags NotBol and/or NotEol causes the begin and end of the subject string NOT to be considered a line start or line end. The flag NotEmpty causes a match to fail if the empty string was matched.
Patterns which cause inordinate amounts of recursion may cause FXRex to throw an FXResourceException.
| anonymous enum |
| anonymous enum |
| enum FX::FXRex::Error |
Regular expression error codes.
| FXbool FX::FXRex::match | ( | const FXchar * | string, |
| FXint | len, | ||
| FXint * | beg = NULL, |
||
| FXint * | end = NULL, |
||
| FXint | mode = Forward, |
||
| FXint | npar = 1, |
||
| FXint | fm = 0, |
||
| FXint | to = 2147483647 |
||
| ) | const |
Match a subject string of length len, returning true if a match is found and false otherwise.
The entire pattern is captured in beg[0] and end[0], where beg[0] refers to the position of the first matched character and end[0] refers to the position after the last matched character. Sub expressions from capturing parenthesis i are returned in beg[i] and end[i].
| static FXString FX::FXRex::substitute | ( | const FXchar * | string, |
| FXint | len, | ||
| FXint * | beg, | ||
| FXint * | end, | ||
| const FXString & | replace, | ||
| FXint | npar = 1 |
||
| ) | [static] |
After performing a regular expression match with capturing parentheses, a substitution string is build from the replace string, where where "&" is replaced by the entire matched pattern, and "\1" through "\9" are replaced by captured expressions.
The original source string and its length, and the match arrays beg and end must be passed.
|
Copyright © 1997-2011 Jeroen van der Zijp
|