Regex Class Reference

#include <Regex.h>

Classes
class	MatchResults

Public Types
enum	CompileFlags { ICASE = regex_icase , NOSUBS = regex_nosubs , NEWLINE = regex_newline }
enum	MatchFlags { NOTBOL = regex_not_bol , NOTEOL = regex_not_eol }

Public Member Functions
	Regex ()
	~Regex ()
	Regex (const wchar_t *_pattern, size_t _n, unsigned int _flags=0) __DCL_THROWS1(RegexException *)
void	compile (const wchar_t *_pattern, size_t _n, unsigned int _flags=0) __DCL_THROWS1(RegexException *)
bool	search (const wchar_t *_begin, const wchar_t *_end, unsigned int _flags=0) __DCL_THROWS1(RegexException *)
bool	search (const wchar_t *_begin, const wchar_t *_end, MatchResults &_results, unsigned int _flags=0) __DCL_THROWS1(RegexException *)
bool	match (const wchar_t *_begin, const wchar_t *_end, unsigned int _flags) __DCL_THROWS1(RegexException *)
bool	match (const wchar_t *_begin, const wchar_t *_end, MatchResults &_results, unsigned int _flags=0) __DCL_THROWS1(RegexException *)
	Regex (const String &_pattern, unsigned int _flags=0) __DCL_THROWS1(RegexException *)
void	compile (const String &_pattern, unsigned int _flags=0) __DCL_THROWS1(RegexException *)
bool	search (const String &_string, unsigned int _flags=0) __DCL_THROWS1(RegexException *)
bool	search (const String &_string, MatchResults &_results, unsigned int _flags=0) __DCL_THROWS1(RegexException *)
bool	match (const String &_string, unsigned int _flags=0) __DCL_THROWS1(RegexException *)
bool	match (const String &_string, MatchResults &_results, unsigned int _flags=0) __DCL_THROWS1(RegexException *)
String	replace (const String &_string, const String &_replacement, size_t _limit=(size_t) -1) __DCL_THROWS1(RegexException *)
size_t	split (const wchar_t *_begin, const wchar_t *_end, StringArray &_results, size_t _limit=(size_t) -1) __DCL_THROWS1(RegexException *)
size_t	split (const String &_string, StringArray &_results, size_t _limit=(size_t) -1) __DCL_THROWS1(RegexException *)

Static Public Member Functions
static bool	test (const wchar_t *_regex, const wchar_t *_string, bool _icase=false) __DCL_THROWS1(RegexException *)
static bool	test (const char *_regex, const char *_string, bool _icase=false) __DCL_THROWS1(RegexException *)

Detailed Description

Definition at line 31 of file Regex.h.

Member Enumeration Documentation

CompileFlags

enum Regex::CompileFlags

Enumerator
ICASE
NOSUBS
NEWLINE

Definition at line 34 of file Regex.h.

                      {
        ICASE      = regex_icase,
        NOSUBS        = regex_nosubs,
        NEWLINE      = regex_newline
    };

MatchFlags

enum Regex::MatchFlags

Enumerator
NOTBOL
NOTEOL

Definition at line 40 of file Regex.h.

                    {
        NOTBOL        = regex_not_bol,
        NOTEOL        = regex_not_eol
    };

Constructor & Destructor Documentation

Regex() [1/3]

Regex::Regex

(

)

Definition at line 83 of file Regex.cpp.

{
    __handle = NULL;
}

~Regex()

Regex::~Regex

(

)

Definition at line 75 of file Regex.cpp.

{
    if (__handle) {
        __regex_destroy(__handle);
//      __handle = NULL;
    }
}

Regex() [2/3]

Regex::Regex	(	const wchar_t *	_pattern,
		size_t	_n,
		unsigned int	_flags = 0 )

Definition at line 88 of file Regex.cpp.

{
    __handle = NULL;
    compile(_pattern, _n, _flags);
}

Regex() [3/3]

Regex::Regex	(	const String &	_pattern,
		unsigned int	_flags = 0 )

Definition at line 96 of file Regex.cpp.

{
    __handle = NULL;
    compile(_pattern.data(), _pattern.length(), _flags);
}

Member Function Documentation

compile() [1/2]

void Regex::compile ( const String & _pattern, unsigned int _flags = 0 )

inline

Definition at line 138 of file Regex.h.

{
    compile(_pattern.data(), _pattern.length(), _flags);
}

compile() [2/2]

void Regex::compile	(	const wchar_t *	_pattern,
		size_t	_n,
		unsigned int	_flags = 0 )

Definition at line 103 of file Regex.cpp.

{
    if (!__handle) {
        __handle = __regex_create();
    }
 
    try {
        __regex_compile(__handle, _pattern, _n, _flags);
    }
//  catch (boost::bad_expression& e)
    catch (std::exception& e) {
        throw(new RegexException(typeid(e).name(), e.what()));
    }
}

match() [1/4]

bool Regex::match ( const String & _string, MatchResults & _results, unsigned int _flags = 0 )

inline

Definition at line 179 of file Regex.h.

{
    return match(
        _string.data(), _string.data() + _string.length(),
        _results, _flags
    );
}

match() [2/4]

bool Regex::match ( const String & _string, unsigned int _flags = 0 )

inline

Definition at line 168 of file Regex.h.

{
    return match(
        _string.data(), _string.data() + _string.length(),
        _flags
    );
}

match() [3/4]

bool Regex::match	(	const wchar_t *	_begin,
		const wchar_t *	_end,
		Regex::MatchResults &	_results,
		unsigned int	_flags = 0 )

Definition at line 178 of file Regex.cpp.

{
    __DCL_ASSERT(__handle != NULL);
 
    try {
        match_result* results = NULL;
        size_t n = __regex_match(__handle, _begin, _end, &results, _flags);
        if (n) {
            _results.attach(results, n);
            return true;
        }
    }
//  catch (std::runtime_error& e)
    catch (std::exception& e) {
        throw(new RegexException(typeid(e).name(), e.what()));
    }
 
    return false;
}

match() [4/4]

bool Regex::match	(	const wchar_t *	_begin,
		const wchar_t *	_end,
		unsigned int	_flags )

Definition at line 160 of file Regex.cpp.

{
    __DCL_ASSERT(__handle != NULL);
 
    bool r = false;
    try {
        r = __regex_match(__handle, _begin, _end, _flags);
    }
//  catch (std::runtime_error& e)
    catch (std::exception& e) {
        throw(new RegexException(typeid(e).name(), e.what()));
    }
 
    return r;
}

replace()

String Regex::replace	(	const String &	_string,
		const String &	_replacement,
		size_t	_limit = (size_t)-1 )

Definition at line 200 of file Regex.cpp.

{
    const wchar_t* _begin = _string.data();
    const wchar_t* _end = _string.data() + _string.length();
    StringBuilder r;
 
    MatchResults results;
    while (_begin < _end && 0 < _limit && search(_begin, _end, results)) {
        r.append(_begin, results[0].first);
        r.append(_replacement);
 
        _limit--;
        _begin = results[0].second;
    }
 
    if (_begin < _end) {
        r.append(_begin, _end);
    }
 
    return r;
}

search() [1/4]

bool Regex::search ( const String & _string, MatchResults & _results, unsigned int _flags = 0 )

inline

Definition at line 157 of file Regex.h.

{
    return search(
        _string.data(), _string.data() + _string.length(),
        _results, _flags
    );
}

search() [2/4]

bool Regex::search ( const String & _string, unsigned int _flags = 0 )

inline

Definition at line 146 of file Regex.h.

{
    return search(
        _string.data(), _string.data() + _string.length(),
        _flags
    );
}

search() [3/4]

bool Regex::search	(	const wchar_t *	_begin,
		const wchar_t *	_end,
		Regex::MatchResults &	_results,
		unsigned int	_flags = 0 )

Definition at line 138 of file Regex.cpp.

{
    __DCL_ASSERT(__handle != NULL);
 
    try {
        match_result* results = NULL;
        size_t n = __regex_search(__handle, _begin, _end, &results, _flags);
        if (n) {
            _results.attach(results, n);
            return true;
        }
    }
//  catch (std::runtime_error& e)
    catch (std::exception& e) {
        throw(new RegexException(typeid(e).name(), e.what()));
    }
 
    return false;
}

search() [4/4]

bool Regex::search	(	const wchar_t *	_begin,
		const wchar_t *	_end,
		unsigned int	_flags = 0 )

Definition at line 120 of file Regex.cpp.

{
    __DCL_ASSERT(__handle != NULL);
 
    bool r = false;
    try {
        r = __regex_search(__handle, _begin, _end, _flags);
    }
//  catch (std::runtime_error& e)
    catch (std::exception& e) {
        throw(new RegexException(typeid(e).name(), e.what()));
    }
 
    return r;
}

split() [1/2]

size_t Regex::split ( const String & _string, StringArray & _results, size_t _limit = (size_t)-1 )

inline

Definition at line 190 of file Regex.h.

{
    return split(
        _string.data(), _string.data() + _string.length(),
        _results, _limit
    );
}

split() [2/2]

size_t Regex::split	(	const wchar_t *	_begin,
		const wchar_t *	_end,
		StringArray &	_results,
		size_t	_limit = (size_t)-1 )

Definition at line 226 of file Regex.cpp.

{
    __DCL_ASSERT(_begin != NULL && _end != NULL);
    __DCL_ASSERT(_begin <= _end);
 
    MatchResults results;
    while(_begin < _end && _limit > 0 && search(_begin, _end, results)) {
        _results.add(String(_begin, results[0].first - _begin));
 
        _limit--;
        _begin = results[0].second;
    }
 
    if (_begin < _end) {
        _results.add(String(_end, _end - _begin));
    }
 
    return _results.size();
}

test() [1/2]

bool Regex::test ( const char * _regex, const char * _string, bool _icase = false )

static

Definition at line 265 of file Regex.cpp.

{
    __DCL_ASSERT_PARAM(_regex != NULL);
    __DCL_ASSERT_PARAM(_string != NULL);
    return __regex_search(
        _regex, _regex + ByteString::length(_regex),
        _string, _string + ByteString::length(_string),
        _icase
    ) != (size_t)-1;;
}

test() [2/2]

bool Regex::test ( const wchar_t * _regex, const wchar_t * _string, bool _icase = false )

static

Definition at line 250 of file Regex.cpp.

{
    __DCL_ASSERT_PARAM(_regex != NULL);
    __DCL_ASSERT_PARAM(_string != NULL);
    return __regex_search(
        _regex, _regex + String::length(_regex),
        _string, _string + String::length(_string),
        _icase
    ) != (size_t)-1;
}

---

The documentation for this class was generated from the following files:

• Regex.h
• Regex.cpp