SourcePro 11.1 |
SourcePro® C++ API Reference Guide |
SourcePro C++ Documentation Home |
Iterates over matches found using RWTRegex<T>. More...
#include <rw/tools/regex.h>
Public Member Functions | |
RWTRegexMatchIterator () | |
RWTRegexMatchIterator (const RWTRegexMatchIterator< T > &source) | |
RWTRegexMatchIterator (RWTRegex< T > ®ex, const RChar *str, size_t start=size_t(0), size_t length=size_t(-1), bool overlap=false) | |
RWTRegexMatchIterator (RWTRegex< T > ®ex, const RString &str, size_t start=size_t(0), size_t length=size_t(-1), bool overlap=false) | |
~RWTRegexMatchIterator () | |
RWTRegexMatchIterator & | operator= (const RWTRegexMatchIterator &rhs) |
RWTRegexMatchIterator & | operator++ () |
const RWTRegexMatchIterator | operator++ (int) |
RWTRegexMatchIterator & | operator+= (size_t count) |
RWTRegexResult< T > | operator* () const |
const RWTRegexResult< T > * | operator-> () const |
bool | operator== (const RWTRegexMatchIterator &rhs) const |
bool | operator!= (const RWTRegexMatchIterator &rhs) const |
Class RWTRegexMatchIterator<T> is an iterator class provided with RWTRegex for iteration over matches of a pattern in a given string.
#include <rw/tools/regex.h> #include <rw/cstring.h> RWTRegex<char> pattern("a+"); RWCString str("aabbccaadd"); RWTRegexMatchIterator<char> i(pattern, str);
None
#include <rw/tools/regex.h> #include <rw/cstring.h> #include <iostream> int main() { RWCString pattern("a+"); RWCString str("aaabaacadeaaaafgaaa"); // Compile the pattern RWTRegex<char> r(pattern); // Iterate over all occurrences of the "pattern" string in // "str" for (RWTRegex<char>::iterator i(r, str); i != RWTRegex<char>::iterator(); ++i) { std::cout << "Found match at index, " << i-> getStart() << ":" << i-> subString(str) << std::endl; } return 0; } Program Output: Found match at index, 0 :aaa Found match at index, 4 :aa Found match at index, 7 :a Found match at index, 10 :aaaa Found match at index, 16 :aaa
RWTRegexMatchIterator< T >::RWTRegexMatchIterator | ( | ) |
Default constructor
RWTRegexMatchIterator< T >::RWTRegexMatchIterator | ( | const RWTRegexMatchIterator< T > & | source | ) |
Copy constructor
RWTRegexMatchIterator< T >::RWTRegexMatchIterator | ( | RWTRegex< T > & | regex, | |
const RChar * | str, | |||
size_t | start = size_t(0) , |
|||
size_t | length = size_t(-1) , |
|||
bool | overlap = false | |||
) |
Constructor. Initializes a match iterator to the first match in str, starting from the start character offset, of the regular expression pattern given in regex. The parameter length defines the length of str. If not specified, the length is calculated as the number of characters up to the first NULL
character, according to the character traits.
RWTRegexMatchIterator< T >::RWTRegexMatchIterator | ( | RWTRegex< T > & | regex, | |
const RString & | str, | |||
size_t | start = size_t(0) , |
|||
size_t | length = size_t(-1) , |
|||
bool | overlap = false | |||
) |
Constructor. Initializes a match iterator to the first match in str, starting from the start character offset, of the regular expression pattern given in regex. The parameter length identifies the length of str. If not specified, the length is assigned the length of str.
RWTRegexMatchIterator< T >::~RWTRegexMatchIterator | ( | ) |
Destructor
bool RWTRegexMatchIterator< T >::operator!= | ( | const RWTRegexMatchIterator< T > & | rhs | ) | const |
Determines if two iterators are unequal. The return value of this method is the same as !(*this == rhs).
RWTRegexResult<T> RWTRegexMatchIterator< T >::operator* | ( | ) | const |
Dereferences the iterator, giving a reference to the regular expression object represented in the iterator.
const RWTRegexMatchIterator RWTRegexMatchIterator< T >::operator++ | ( | int | ) |
Post-increment operator
RWTRegexMatchIterator& RWTRegexMatchIterator< T >::operator++ | ( | ) |
Pre-increment operator
RWTRegexMatchIterator& RWTRegexMatchIterator< T >::operator+= | ( | size_t | count | ) |
Advances through count matches.
const RWTRegexResult<T>* RWTRegexMatchIterator< T >::operator-> | ( | ) | const |
Returns a pointer to the regular expression object represented in the iterator.
RWTRegexMatchIterator& RWTRegexMatchIterator< T >::operator= | ( | const RWTRegexMatchIterator< T > & | rhs | ) |
Assignment operator
bool RWTRegexMatchIterator< T >::operator== | ( | const RWTRegexMatchIterator< T > & | rhs | ) | const |
Compares two iterators for equality based on the regular expression and the starting position in the string.
© Copyright Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave and SourcePro are registered trademarks of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.
Contact Rogue Wave about documentation or support issues.