A class for parsing CSV files (or tab-separated files, or whitespace separated files, etc.). (This class does not support Mac line endings, so you should replace all '' with '
' before using this class if your data comes from a Mac.) More...

#include <GMatrix.h>

Public Member Functions
	GCSVParser ()

	~GCSVParser ()

void	columnNamesInFirstRow ()
	Indicate that the first row specifies column names. More...

void	parse (GMatrix &outMatrix, const char *szFilename)
	Load the specified file, and parse it. More...

void	parse (GMatrix &outMatrix, const char *pString, size_t len)
	Parse the given string. More...

std::string &	report (size_t column)
	Return a string that reports the status of the specified column. (This should only be called after parsing.) More...

void	setClearlyNumericalThreshold (size_t n)
	Specify the number of unique numerical values before a column is deemed to be clearly numerical. More...

void	setMaxVals (size_t n)
	Specify the maximum number of values to allow in a categorical attribute. The parsing of any columns that contain non-numerical values, and contain more than this number of unique values, will be aborted. More...

void	setNominalAttr (size_t attr)
	Indiciate that the specified attribute should be treated as nominal. More...

void	setRealAttr (size_t attr)
	Indiciate that the specified attribute should be treated as real. More...

void	setSeparator (char c)
	Specify the separating character. '\0' indicates that an arbitrary amount of whitespace is used for separation. More...

void	setTimeFormat (size_t attr, const char *szFormat)
	Specify that a certain attribute should be expected to be a date or time stamp that follows a given format. More...

void	tolerant ()
	Specify to ignore inconsistencies in the number of values in each row. (Using this is very dangerous.) More...

Protected Attributes
size_t	m_clearlyNumericalThreshold

bool	m_columnNamesInFirstRow

std::map< size_t, std::string >	m_formats

size_t	m_maxVals

std::vector< std::string >	m_report

char	m_separator

std::map< size_t, size_t >	m_specifiedNominal

std::map< size_t, size_t >	m_specifiedReal

bool	m_tolerant

Detailed Description

A class for parsing CSV files (or tab-separated files, or whitespace separated files, etc.). (This class does not support Mac line endings, so you should replace all '' with '
' before using this class if your data comes from a Mac.)

Constructor & Destructor Documentation

GClasses::GCSVParser::GCSVParser ( )

GClasses::GCSVParser::~GCSVParser ( )

Member Function Documentation

void GClasses::GCSVParser::columnNamesInFirstRow ( )

inline

Indicate that the first row specifies column names.

void GClasses::GCSVParser::parse	(	GMatrix &	outMatrix,
		const char *	szFilename
	)

Load the specified file, and parse it.

void GClasses::GCSVParser::parse	(	GMatrix &	outMatrix,
		const char *	pString,
		size_t	len
	)

Parse the given string.

std::string& GClasses::GCSVParser::report ( size_t column )

inline

Return a string that reports the status of the specified column. (This should only be called after parsing.)

void GClasses::GCSVParser::setClearlyNumericalThreshold ( size_t n )

inline

Specify the number of unique numerical values before a column is deemed to be clearly numerical.

void GClasses::GCSVParser::setMaxVals ( size_t n )

inline

Specify the maximum number of values to allow in a categorical attribute. The parsing of any columns that contain non-numerical values, and contain more than this number of unique values, will be aborted.

void GClasses::GCSVParser::setNominalAttr ( size_t attr )

Indiciate that the specified attribute should be treated as nominal.

void GClasses::GCSVParser::setRealAttr ( size_t attr )

Indiciate that the specified attribute should be treated as real.

void GClasses::GCSVParser::setSeparator ( char c )

inline

Specify the separating character. '\0' indicates that an arbitrary amount of whitespace is used for separation.

void GClasses::GCSVParser::setTimeFormat	(	size_t	attr,
		const char *	szFormat
	)

Specify that a certain attribute should be expected to be a date or time stamp that follows a given format.

void GClasses::GCSVParser::tolerant ( )

inline

Specify to ignore inconsistencies in the number of values in each row. (Using this is very dangerous.)

Member Data Documentation

size_t GClasses::GCSVParser::m_clearlyNumericalThreshold

protected

bool GClasses::GCSVParser::m_columnNamesInFirstRow

protected

std::map<size_t, std::string> GClasses::GCSVParser::m_formats

protected

size_t GClasses::GCSVParser::m_maxVals

protected

std::vector<std::string> GClasses::GCSVParser::m_report

protected

char GClasses::GCSVParser::m_separator

protected

std::map<size_t, size_t> GClasses::GCSVParser::m_specifiedNominal

protected

std::map<size_t, size_t> GClasses::GCSVParser::m_specifiedReal

protected

bool GClasses::GCSVParser::m_tolerant

protected

Public Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation