RWTRegexResult< T > Class Template Reference

Encapsulates the results from a search using RWTRegex. More...

#include <rw/tools/regexresult.h>

Public Member Functions
	RWTRegexResult ()
	RWTRegexResult (const RWTRegexResult< T > &source)
	RWTRegexResult (RWTRegexResult< T > &&rhs)
	~RWTRegexResult ()
size_t	getLength (size_t matchID=0) const
size_t	getStart (size_t matchID=0) const
	operator bool () const
RWTRegexResult< T > &	operator= (const RWTRegexResult< T > &rhs)
RWTRegexResult< T > &	operator= (RWTRegexResult< T > &&rhs)
size_t	size () const
RString	subString (const RString &str, size_t matchID=0) const
void	swap (RWTRegexResult< T > &rhs)

Detailed Description

template<class T>
class RWTRegexResult< T >

Class RWTRegexResult is a class template that encapsulates the result of a RWTRegex::matchAt() or RWTRegex::search() operation executed on an instance of RWTRegex.

Synopsis

#include <rw/tools/regex.h>
#include <rw/cstring.h>

RWTRegex<char> pattern("a+");
RWTRegexResult<char> result = pattern.search("aabbccaadd");

Persistence

None

Example

#include <rw/tools/regex.h>
#include <rw/cstring.h>

#include <iostream>

int main()
{
  RWTRegex<char>        pattern("h(t+)p");
  RWCString             str("http");
  RWTRegexResult<char>  result = pattern.search(str);

  std::cout << "Overall match at offset " << result.getStart()
            << ", with length " << result.getLength()
            << " is " << result.subString(str)
            << std::endl;

  std::cout << "First sub-expression match at offset "
            << result.getStart(1)
            << ", with length " << result.getLength(1)
            << " is " << result.subString(str, 1)
            << std::endl;

  return 0;
}

Constructor & Destructor Documentation

template<class T>

RWTRegexResult< T >::RWTRegexResult

(

)

Default constructor

template<class T>

RWTRegexResult< T >::RWTRegexResult

(

const RWTRegexResult< T > &

source

)

Copy constructor

template<class T>

RWTRegexResult< T >::RWTRegexResult

(

RWTRegexResult< T > &&

rhs

)

Move constructor. The constructed instance takes ownership of the data owned by rhs.

Condition:

This method is available only on platforms with rvalue reference support.

template<class T>

RWTRegexResult< T >::~RWTRegexResult

(

)

Destructor

Member Function Documentation

template<class T>

size_t RWTRegexResult< T >::getLength

(

size_t

matchID = 0

)

const

Returns the length of the requested match.

template<class T>

size_t RWTRegexResult< T >::getStart

(

size_t

matchID = 0

)

const

Returns the offset of the start of the requested match.

template<class T>

RWTRegexResult< T >::operator bool

(

)

const

Match operator

template<class T>

RWTRegexResult<T>& RWTRegexResult< T >::operator=

(

const RWTRegexResult< T > &

rhs

)

Assignment operator

template<class T>

RWTRegexResult<T>& RWTRegexResult< T >::operator=

(

RWTRegexResult< T > &&

rhs

)

Move assignment. Self takes ownership of the data owned by rhs.

Condition:

This method is available only on platforms with rvalue reference support.

template<class T>

size_t RWTRegexResult< T >::size

(

)

const

Returns the number of match identifiers (matchID) available for request, including the 0 matchID. Hence, the largest matchID that can be requested is size() -1.

template<class T>

RString RWTRegexResult< T >::subString	(	const RString &	str,
		size_t	matchID = 0
	)		const

Returns a substring containing the requested match.

template<class T>

void RWTRegexResult< T >::swap

(

RWTRegexResult< T > &

rhs

)

Swaps the data owned by self with the data owned by rhs.