This concrete class performs basic tokenizing/parse functions on a string. More...

Detailed Description

This concrete class performs basic tokenizing/parse functions on a string.

A token is a one or more characters separated by one or more delimiter characters. The parsing is a destructive parsing in that it modifies the original string. The tokenizing is done one token at time i.e. when the next() method is called.

#include <Basic.h>

Public Member Functions
	Basic (char *stringToParse)
	Constructor. Uses whitespace for token delimiters.

	Basic (char stringToParse, const char delimiterSet)
	Constructor. Uses the specified character set for token delimiters.

const char *	next () noexcept
	Returns a pointer to the next token.

const char *	remaining () const noexcept
	Returns a pointer to the portion of the string that has not been tokenized, i.e.

const char *	getToken (unsigned n) const noexcept
	This method returns the Nth token.

unsigned	numTokens () const noexcept
	Returns the number of tokens parsed to-date.

Constructor & Destructor Documentation

◆ Basic() [1/2]

Cpl::Text::Tokenizer::Basic::Basic ( char * stringToParse )

Constructor. Uses whitespace for token delimiters.

◆ Basic() [2/2]

Cpl::Text::Tokenizer::Basic::Basic	(	char *	stringToParse,
		const char *	delimiterSet
	)

Constructor. Uses the specified character set for token delimiters.

Member Function Documentation

◆ getToken()

const char * Cpl::Text::Tokenizer::Basic::getToken ( unsigned n ) const

noexcept

This method returns the Nth token.

Where N is the zero-based token index, i.e. 0:=first token, 1:=second token, etc. If N is out-of-bound then 0 is returned. Typically this method is called once the entire string has been tokenized.

◆ next()

const char * Cpl::Text::Tokenizer::Basic::next ( )

noexcept

Returns a pointer to the next token.

Returns 0 if no tokens exist, or the string has already been completed tokenized. NOTE: This method is also used to get the 'first' token.

◆ numTokens()

unsigned Cpl::Text::Tokenizer::Basic::numTokens ( ) const

inlinenoexcept

Returns the number of tokens parsed to-date.

◆ remaining()

const char * Cpl::Text::Tokenizer::Basic::remaining ( ) const