Home | Modules | Class Hierarchy | Alphabetical List | Compound List | Related Pages

CRegExp Class Reference
[Regular Expressions]

---

Detailed Description

Regular Expression compiler and matcher.

Colorer regular expressions library cregexp.

1. Features.

1.1. Colorer Unicode classes.

• Unicode Consortium regexp level 1 support. All characters are treated as independent 16-bit units. The result of RE is independent of current locale.
• Unicode syntax extensions:
  • Unicode general category char class:
    • [{L}{Nd}] - all letters and decimal digits,
    • [{ALL}] - as '.',
    • [{ASSIGNED}] - all assigned unicode characters,
    • [{UNASSIGNED}] - all unassigned unicode characters.
  • Char classes substraction unicode extension:
    • [{ASSIGNED}-[{Lu}]-[{Ll}]] - all assigned characters except,
    • upper and lower case characters.
  • Char classes connection syntax:
    • [{Lu}[{Ll}]] - upper and lower case characters.
  • Char classes intersection syntax:
    • [{ALL}&&[{L}]] - only Letter characters.
  • Character reference syntax: \x{2028} \x0A as in Perl.
  • Unicode form \u2028 is unused (\u - upper case char).

1.2. Extensions.

• Bracket extensions:
  • (?{name} pattern ) - named bracket,
  • \p{name} - named bracket reference.
  • (?{} pattern ) - no capturing bracket as (?: pattern ) in Perl.
• Look Ahead/Backward:
  • pattern?= as Perl's (?=pattern)
  • pattern?! as Perl's (?!pattern)
  • pattern?N - N symbols backward look for pattern
  • pattern?~N - N symbols backward look for no pattern
• Colorer library extensions:
  • \m \M - sets new start and end of zero(default) bracket.
  • \yN \YN \y{name} \Y{name} - back reference into another RE's bracket.

1.3. Perl compatibility.

• Modifiers //ismx
• \ p{name} - back reference to named bracket (but not named property as in Perl!)
• No POSIX character classes support.

2. Dislikes:

2.1. According to Unicode RE level 1 support:

• No surrogate symbols support,
• No string length changes on case mappings (only 1 <-> 1 mappings),

2.2. Algorithmic problems:

• Stack recursion implementation.

Public Member Functions
	CRegExp ()
	Empty constructor.
	CRegExp (const String *text)
	Constructs regular expression and compile it with text pattern.
bool	isOk ()
	Is compilied RE well-formed.
EError	getError ()
	Returns information about RE compilation error.
bool	setPositionMoves (bool moves)
	Tells RE parser, that it must make moves on tested string while RE matching.
int	getBracketNo (const String *brname)
	Returns count of named brackets.
String *	getBracketName (int no)
	Returns named bracked name by it's index.
bool	setBackRE (CRegExp *bkre)
bool	setBackTrace (const String *str, SMatches *trace)
	Changes RE object, used for backreferences with named {} {} operators.
bool	getBackTrace (const String **str, SMatches **trace)
	Returns current RE object, used for backreferences with operators.
bool	setRE (const String *re)
	Compiles specified regular expression and drops all previous structures.
bool	parse (const String *str, SMatches *mtch)
	Runs RE parser against input string str.
bool	parse (const String *str, int pos, int eol, SMatches *mtch, int soscheme=0, int moves=-1)
	Runs RE parser against input string str.

---

Constructor & Destructor Documentation

CRegExp::CRegExp (   )

Empty constructor. No RE tree is builded with this constructor. Use setRE method to change pattern.

Colorer-take5 Library. Copyright © 1999-2006 Igor Russkih.
Generated at Fri Nov 24 17:13:12 2006 by doxygen 1.4.6.