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 (?=pattern)
  • pattern?! as Perl (?!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!)
• 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 Methods
	CRegExp ()
	Empty constructor.
	CRegExp (const String *text)
	Constructs regular expression and compile it with text pattern.
bool	isOk ()
	Is RE well-compiled.
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)
bool	getBackTrace (const String **str, SMatches **trace)
bool	setRE (const String *re)
	Compiles specified regular expression.
bool	parse (const String *str, SMatches *mtch)
bool	parse (const String *str, int pos, int eol, SMatches *mtch, int soscheme=0, int moves=-1)

Colorer-take5 Library. Copyright © 1999-2003 Cail Lomecb.
Generated at Fri Sep 12 18:54:55 2003 by doxygen 1.3-rc2.