ost_StringTokenizer_iterator: The input forward iterator for tokens.

SYNOPSIS

#include <tokenizer.h>

Public Member Functions

iterator ()

virtual ~iterator ()

iterator (const iterator &i)

copy constructor. iterator & operator= (const iterator &i)

assignment operator. iterator & operator++ () THROWS(NoSuchElementException)

shifts this iterator to the next token in the string. const char * operator* () THROWS(NoSuchElementException)

returns the immutable string this iterator points to or '0' if no token is available (i.e. char nextDelimiter () const

returns the next delimiter after the current token or '\0', if there are no following delimiters. bool operator== (const iterator &other) const

compares to other iterator. bool operator!= (const iterator &other) const

compares to other iterator.

Friends

class StringTokenizer

Detailed Description

The input forward iterator for tokens.

Author:

Henner Zeller

Constructor & Destructor Documentation

ost::StringTokenizer::iterator::iterator ()\fC [inline]\fP

virtual ost::StringTokenizer::iterator::~iterator ()\fC [inline]\fP, \fC [virtual]\fP

ost::StringTokenizer::iterator::iterator (const \fBiterator\fP &i)\fC [inline]\fP

copy constructor.

Member Function Documentation

char ost::StringTokenizer::iterator::nextDelimiter () const\fC [inline]\fP

returns the next delimiter after the current token or '\0', if there are no following delimiters. It returns the very next delimiter (even if skipAllDelim=true).

bool ost::StringTokenizer::iterator::operator!= (const \fBiterator\fP &other) const\fC [inline]\fP

compares to other iterator. Usually used to compare against the end() iterator.

const char* ost::StringTokenizer::iterator::operator* ()

returns the immutable string this iterator points to or '0' if no token is available (i.e. i == end()). Do not store pointers to this token, since it is invalidated for each iteration. If you need the token, copy it (e.g. with strdup());

\fBiterator\fP& ost::StringTokenizer::iterator::operator++ ()

shifts this iterator to the next token in the string.

\fBiterator\fP& ost::StringTokenizer::iterator::operator= (const \fBiterator\fP &i)\fC [inline]\fP

assignment operator.

bool ost::StringTokenizer::iterator::operator== (const \fBiterator\fP &other) const\fC [inline]\fP