WvRegex – Unified support for regular expressions. More...

#include <wvregex.h>

Inheritance diagram for WvRegex:

[legend]

Public Types
enum	CFlags { BASIC = 0 , EXTENDED = REG_EXTENDED , ICASE = REG_ICASE , NOSUB = REG_NOSUB , NEWLINE = REG_NEWLINE }
	Flags that affect interpretation of the regex; used in Regex() and set() More...

enum	EFlags { NOTBOL = REG_NOTBOL , NOTEOL = REG_NOTEOL }
	Flags that affect matching of regex. More...

Public Member Functions
	WvRegex ()
	Construct an empty regex object.

	WvRegex (WvStringParm regex, int cflags=default_cflags)
	Construct a regex object, compiling the given regex.

bool	set (WvStringParm regex, int cflags=default_cflags)
	Replace the current regex to match with a new one.

bool	match (WvStringParm string, WVREGEX_REGS_DECL) const
	Match a given string against the compiled regular expression.

bool	match (WvStringParm string, int eflags, WVREGEX_REGS_DECL) const
	Match a given string against the compiled regular expression.

bool	continuable_match (WvStringParm string, int &match_start, int &match_end, WVREGEX_REGS_DECL) const
	Match a given string against the compiled regular expression, capturing the start and end positions of the matching string.

bool	continuable_match (WvStringParm string, int eflags, int &match_start, int &match_end, WVREGEX_REGS_DECL) const
	Match a given string against the compiled regular expression, capturing the start and end positions of the matching string.

virtual bool	isok () const
	By default, returns true if geterr() == 0.

virtual int	geterr () const
	If isok() is false, return the system error number corresponding to the error, -1 for a special error string (which you can obtain with errstr()) or 0 on end of file.

virtual WvString	errstr () const

void	seterr (WvStringParm specialerr)

void	seterr (WVSTRING_FORMAT_DECL)

void	seterr (const WvErrorBase &err)

void	seterr_both (int _errnum, WvStringParm specialerr)

void	seterr_both (int _errnum, WVSTRING_FORMAT_DECL)

void	noerr ()
	Reset our error state - there's no error condition anymore.

Static Public Member Functions
static WvString	strerror (int errnum)
	A replacement for the operating system strerror() function that can map more kinds of error strings (especially in win32).

Static Public Attributes
static const int	default_cflags = WvRegex::EXTENDED

static const int	default_eflags = 0

static WvString	__wvre_null_reg
	Internal use only.

Protected Attributes
int	errnum

WvString	errstring

Detailed Description

WvRegex – Unified support for regular expressions.

Supports matching compiled regular expressions and capturing substrings in registers. !

Definition at line 47 of file wvregex.h.

Member Enumeration Documentation

◆ CFlags

enum WvRegex::CFlags

Flags that affect interpretation of the regex; used in Regex() and set()

Definition at line 112 of file wvregex.h.

◆ EFlags

enum WvRegex::EFlags

Flags that affect matching of regex.

Used in match() and continuable_match()

Definition at line 130 of file wvregex.h.

Constructor & Destructor Documentation

◆ WvRegex() [1/2]

WvRegex::WvRegex ( )

inline

Construct an empty regex object.

Matches will always fail until set() is called with a valid regex.

Definition at line 148 of file wvregex.h.

◆ WvRegex() [2/2]

WvRegex::WvRegex	(	WvStringParm	regex,
		int	cflags = `default_cflags`
	)

inline

Construct a regex object, compiling the given regex.

Parameters

regex	The new regular expression to match
cflags	CFlags used to compile the regular expression; the defaults are case sensitive, extended RE.

Definition at line 156 of file wvregex.h.

References set().

◆ ~WvRegex()

WvRegex::~WvRegex ( )

Definition at line 42 of file wvregex.cc.

Member Function Documentation

◆ set()

bool WvRegex::set	(	WvStringParm	regex,
		int	cflags = `default_cflags`
	)

Replace the current regex to match with a new one.

Parameters

regex	The new regular expression to match
cflags	CFlags used to compile the regular expression; the defaults are case sensitive, extended RE.

Definition at line 27 of file wvregex.cc.

Referenced by WvGlob::set(), and WvRegex().

◆ match() [1/2]

bool WvRegex::match	(	WvStringParm	string,
		WVREGEX_REGS_DECL
	)		const

inline

Match a given string against the compiled regular expression.

Parameters

string	The string to match
(remaining)	WvString registers to capture substring matches as specified in the RE

extern WvString line;
WvString match;
if (re.match(line, match))
    wvout->print("Matching substring is '%s'\n", match);

Definition at line 183 of file wvregex.h.

◆ match() [2/2]

bool WvRegex::match	(	WvStringParm	string,
		int	eflags,
		WVREGEX_REGS_DECL
	)		const

inline

Match a given string against the compiled regular expression.

Parameters

string	The string to match
eflags	EFlags that affect matching
(remaining)	WvString registers to capture substring matches as specified in the RE

Definition at line 197 of file wvregex.h.

◆ continuable_match() [1/2]

bool WvRegex::continuable_match	(	WvStringParm	string,
		int &	match_start,
		int &	match_end,
		WVREGEX_REGS_DECL
	)		const

inline

Match a given string against the compiled regular expression, capturing the start and end positions of the matching string.

Parameters

string	The string to match
match_start	If the match succeeds, the starting index of the match in string
match_end	If the match succeeds, the index of the character in string following the last character of the match
(remaining)	WvString registers to capture substring matches as specified in the RE

extern WvString line;
int start = 0;
WvString match;
int match_start, match_end;
while (re.continuable_match(&line[start],
        match_start, match_end, match))
{
    wvout->print("Matching substring is '%s'@[%s,%s)\n",
            match, match_start, match_end);
    start += match_end;
}

Definition at line 230 of file wvregex.h.

Referenced by strcoll_split().

◆ continuable_match() [2/2]

bool WvRegex::continuable_match	(	WvStringParm	string,
		int	eflags,
		int &	match_start,
		int &	match_end,
		WVREGEX_REGS_DECL
	)		const

inline

Match a given string against the compiled regular expression, capturing the start and end positions of the matching string.

Parameters

string	The string to match
eflags	EFlags that affect matching
match_start	If the match succeeds, the starting index of the match in string
match_end	If the match succeeds, the index of the character in string following the last character of the match
(remaining)	WvString registers to capture substring matches as specified in the RE

Definition at line 250 of file wvregex.h.

◆ isok()

virtual bool WvErrorBase::isok ( ) const

inlinevirtualinherited

By default, returns true if geterr() == 0.

Might be overridden so that isok() == false even though no error code has been specified.

Reimplemented in WvBufStream, WvDBusServer, WvDSAKey, WvEncoderStream, WvFdStream, WvIStreamList, WvListener, WvNullListener, WvLog, WvSSLStream, WvStream, WvStreamClone, WvTCPConn, WvTimeoutStream, WvTimeStream, WvReadLineStream, _WvConStream, and IWvStream.

Definition at line 39 of file wverror.h.

Referenced by WvListener::isok(), WvStream::isok(), and WvGlob::set().

◆ geterr()

virtual int WvErrorBase::geterr ( ) const

inlinevirtualinherited

If isok() is false, return the system error number corresponding to the error, -1 for a special error string (which you can obtain with errstr()) or 0 on end of file.

If isok() is true, returns an undefined number.

Reimplemented in WvDBusServer, and WvStreamClone.

Definition at line 48 of file wverror.h.

Referenced by UniIniGen::commit(), UniFileSystemGen::get(), WvDBusServer::geterr(), WvStreamClone::geterr(), WvEncoderStream::isok(), UniConfDaemon::listen(), UniIniGen::refresh(), WvStream::seterr(), and WvMagicCircle::WvMagicCircle().

◆ errstr()

WvString WvErrorBase::errstr ( ) const

virtualinherited

Definition at line 127 of file wverror.cc.

◆ strerror()

WvString WvErrorBase::strerror ( int errnum )

staticinherited

A replacement for the operating system strerror() function that can map more kinds of error strings (especially in win32).

Definition at line 91 of file wverror.cc.

References WvErrorBase::strerror().

Referenced by WvLog::perror(), WvErrorBase::strerror(), WvSSLStream::uread(), and WvSSLStream::uwrite().

◆ seterr() [1/3]

void WvErrorBase::seterr ( WvStringParm specialerr )

inherited

Definition at line 159 of file wverror.cc.

◆ seterr() [2/3]

void WvErrorBase::seterr ( WVSTRING_FORMAT_DECL )

inlineinherited

Definition at line 70 of file wverror.h.

◆ seterr() [3/3]

void WvErrorBase::seterr ( const WvErrorBase & err )

inherited

Definition at line 170 of file wverror.cc.

◆ seterr_both() [1/2]

void WvErrorBase::seterr_both	(	int	_errnum,
		WvStringParm	specialerr
	)

inherited

Definition at line 179 of file wverror.cc.

◆ seterr_both() [2/2]

void WvErrorBase::seterr_both	(	int	_errnum,
		WVSTRING_FORMAT_DECL
	)

inlineinherited

Definition at line 73 of file wverror.h.

◆ noerr()

void WvErrorBase::noerr ( )

inlineinherited

Reset our error state - there's no error condition anymore.

Definition at line 78 of file wverror.h.

Member Data Documentation

◆ default_cflags

const int WvRegex::default_cflags = WvRegex::EXTENDED

static

Definition at line 124 of file wvregex.h.

◆ default_eflags

const int WvRegex::default_eflags = 0

static

Definition at line 137 of file wvregex.h.

◆ __wvre_null_reg

WvString WvRegex::__wvre_null_reg

static

Internal use only.

Definition at line 142 of file wvregex.h.

◆ errnum

int WvErrorBase::errnum

protectedinherited

Definition at line 26 of file wverror.h.

◆ errstring

WvString WvErrorBase::errstring

protectedinherited

Definition at line 27 of file wverror.h.

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

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Attributes

Detailed Description

Member Enumeration Documentation

◆ CFlags

◆ EFlags

Constructor & Destructor Documentation

◆ WvRegex() [1/2]

◆ WvRegex() [2/2]

◆ ~WvRegex()

Member Function Documentation

◆ set()

◆ match() [1/2]

◆ match() [2/2]

◆ continuable_match() [1/2]

◆ continuable_match() [2/2]

◆ isok()

◆ geterr()

◆ errstr()

◆ strerror()

◆ seterr() [1/3]

◆ seterr() [2/3]

◆ seterr() [3/3]

◆ seterr_both() [1/2]

◆ seterr_both() [2/2]

◆ noerr()

Member Data Documentation

◆ default_cflags

◆ default_eflags

◆ __wvre_null_reg

◆ errnum

◆ errstring