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.