WvStreams
Public Types | Public Member Functions | Static Public Member Functions | Static Public Attributes | Protected Attributes | List of all members
WvRegex Class Reference

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

#include <wvregex.h>

Inheritance diagram for WvRegex:
Inheritance graph
[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

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

Definition at line 112 of file wvregex.h.

◆ 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
regexThe new regular expression to match
cflagsCFlags 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
regexThe new regular expression to match
cflagsCFlags 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
stringThe 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);
WvString is an implementation of a simple and efficient printable-string class.
Definition wvstring.h:330

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
stringThe string to match
eflagsEFlags 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
stringThe string to match
match_startIf the match succeeds, the starting index of the match in string
match_endIf 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
stringThe string to match
eflagsEFlags that affect matching
match_startIf the match succeeds, the starting index of the match in string
match_endIf 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: