configuration::StringConfigurationParser Class Reference

#include <confparser.h>

Inheritance diagram for configuration::StringConfigurationParser:

Public Member Functions
	StringConfigurationParser (std::istream *str)
std::string	setCommentsSet (std::string set)
std::string	setBlankSet (std::string set)
std::string	setDeliminersSet (std::string set)
void	skip ()
bool	parse (std::string &key, std::string &value)
bool	eod ()
Private Attributes
std::string	delimiterSet
std::string	commentsSet
std::string	blankSet
Static Private Attributes
static const size_t	LINELENGTH = 1024

Detailed Description

Simple string parser. Reads input stream by lines and split line according delimiter. Everything before delimiters member is marked as key and everything after as value.
Deliminers are specified as set of characters where each stands for separator.

Constructor & Destructor Documentation

configuration::StringConfigurationParser::StringConfigurationParser ( std::istream * str ) [inline]

Initialization constructor.

Parameters:

str

Input stream with data.

Initializes stream field with str and initializes *Set fields with default values.

References blankSet, commentsSet, and delimiterSet.

Member Function Documentation

bool configuration::StringConfigurationParser::eod ( ) [inline, virtual]

Returns istream::eof(). If no stream is specified, returns with true.

Implements configuration::IConfigurationParser< std::string, std::string >.

References configuration::IConfigurationParser< std::string, std::string >::stream.

bool configuration::StringConfigurationParser::parse	(	std::string &	key,
		std::string &	value
	)			`[inline, virtual]`

Parses valid line. Reads line from current stream position. Removes comments (everything behind membet of commentsSet character). Removes intials and trailing blanks (all characters from blankSet). If result data are empty, parses following line. Otherwise starts parsing.
Parsing process is very simple and just searches first occurence of character from delimiterSet. Everything before separator is used to initialize key parameter and everything behind to value parameter. If none from delimiterSet is found assumes that value is empty and key is whole parsed string.
Both key and value are trimed (leading and trailing blanks - all from blankSet are removed).
If any error occures while reading or end of file occured, returns with false and key, value parameters are not filled.
If no stream is set, immediately returns with false.
Note that input stream can't contain 0 characters.