This class resembles an arbitrary text data file, which is formatted in a table-like manner. The columns may be separated using tabulators and/or whitespace characters. More...

#include <file.hpp>

Inheritance diagram for NumeRe::TextDataFile:

Collaboration diagram for NumeRe::TextDataFile:

Public Member Functions
	TextDataFile (const std::string &filename)

virtual	~TextDataFile ()

virtual bool	read () override
	Pure virtual declaration of the read access method. Has to be implemented in all derived classes and can be used to read the contents of the file to memory. More...

virtual bool	write () override
	Pure virtual declaration of the write access method. Has to be implemented in all derived classes and can be used to write the contents in memory to the target file. More...

Public Member Functions inherited from NumeRe::GenericFile
	GenericFile (const std::string &fileName)
	Constructor from filename. More...

	GenericFile (const GenericFile &file)
	Copy constructor. More...

virtual	~GenericFile ()
	Virtual destructor: we'll work with instances on the heap, therefore we'll need virtual declared destructors. This destructor will clear the internal memory and closes the file stream, if it is still open. More...

bool	is_open ()
	Wrapper for fstream::is_open() More...

void	close ()
	Wrapper for fstream::close(). Will also clear the internal memory. More...

bool	good ()
	Wrapper for fstream::good() More...

size_t	tellg ()
	Wrapper for fstream::tellg() More...

size_t	tellp ()
	Wrapper for fstream::tellp() More...

void	seekg (size_t pos)
	Wrapper for fstream::seekg() with start from the beginning of the stream. More...

void	seekp (size_t pos)
	Wrapper for fstream::seekp() with start from the beginning of the stream. More...

std::string	getExtension ()
	Returns the file extension. More...

std::string	getFileName ()
	Returns the file name. More...

std::string	getTableName ()
	Returns the table name referenced in the file. Will default to the file name with non-alnum characters replaced with underscores, if the file does not reference a table name by itself. More...

std::string	getComment ()
	Returns the comment stored with the referenced file. More...

void	setComment (const std::string &comment)
	Sets the comment to be written to the referencedfile. More...

long long int	getRows ()
	Returns the number of rows. More...

long long int	getCols ()
	Returns the number of columns. More...

virtual FileHeaderInfo	getFileHeaderInformation ()
	Returns the file header information structure. More...

virtual bool	read ()=0
	Pure virtual declaration of the read access method. Has to be implemented in all derived classes and can be used to read the contents of the file to memory. More...

virtual bool	write ()=0
	Pure virtual declaration of the write access method. Has to be implemented in all derived classes and can be used to write the contents in memory to the target file. More...

GenericFile &	operator= (const GenericFile &file)
	Assignment operator definition. More...

void	getData (TableColumnArray *data)
	This method copies the internal data to the passed memory address. The target memory must already exist. More...

TableColumnArray *	getData (long long int &rows, long long int &cols)
	This method returns a pointer to the internal memory with read and write access. This pointer shall not stored for future use, because the referenced memory will be deleted upon destruction of this class instance. More...

void	setDimensions (long long int rows, long long int cols)
	Sets the dimensions of the data table, which will be used in the future. Clears the internal memory in advance. More...

void	setTableName (const std::string &name)
	Set the table's name. More...

void	setTextfilePrecision (unsigned short nPrecision)
	Set the precision, which shall be used to convert the floating point numbers into strings. More...

void	addData (TableColumnArray *data, long long int rows, long long int cols)
	This method created the internal storage and copies the passed data to this storage. More...

void	setData (TableColumnArray *data, long long int rows, long long int cols)
	This method refernces the passed external data internally. The data is not copied and must exist as long as thos class exists. More...

Public Member Functions inherited from FileSystem
	FileSystem ()
	Default constructor. More...

FileSystem &	assign (const FileSystem &_fSys)
	Assignment member function to copy the settings from another FileSystem instance. More...

std::string	ValidFileName (std::string _sFileName, const std::string sExtension=".dat", bool checkExtension=true, bool doCleanPath=true) const
	This member function evaluates, whether the passed filename is a valid filename. One may supply a preferred filename extension. More...

std::string	ValidFolderName (std::string _sFileName, bool doCleanPath=true, bool appendTrailingSeparator=true) const
	This member function evaluates, whether the passed foldername is a valid foldername. More...

std::string	ValidizeAndPrepareName (const std::string &_sFileName, const std::string &sExtension=".dat") const
	This member function validizes the passed file name and creates the needed folders on-the-fly. More...

int	setPath (std::string _sPath, bool bMkDir, std::string _sExePath)
	This member function may be used to set the preferred file path of the current FileSystem instance. More...

void	createRevisionsFolder ()
	This member function creates the hidden revisions folders for the version control system. More...

std::string	getPath () const
	Returns the default path of this FileSystem instance. More...

std::vector< std::string >	getFileParts (const std::string &sFilePath) const
	This member function separates all path parts into single strings: the drive letter, the path, the name and the extension. This function may also handle folder paths and network paths. More...

FileInfo	getFileInfo (const std::string &sFilePath) const
	Return the file information about the passed file path. More...

void	setTokens (std::string _sTokens)
	This member function may be used to update the path placeholders of the current FileSystem instance. More...

bool	isFile (const std::string &_sPath) const
	This function determines, whether a path name indicates a file or a folder. More...

void	initializeFromKernel ()
	Member function to remote-initialize the class from the kernel. Cannot be used during kernel start-up. More...

void	setProgramPath (std::string _sExePath)

std::string	getProgramPath () const

void	declareFileType (const std::string &sFileType)

Private Member Functions
void	readFile ()
	This method reads the data in the referenced text file to memory. More...

void	writeFile ()
	This method writes the data in memory to the referenced text file. More...

void	writeHeader ()
	This member function writes the header lines or the text files. More...

void	writeTableHeads (const std::vector< size_t > &vColumnWidth, size_t nNumberOfLines)
	This member function is used to write the table heads into the target file. More...

void	writeTableContents (const std::vector< size_t > &vColumnWidth)
	This member function is used to write the data in memory to the target text file. More...

void	addSeparator (const std::vector< size_t > &vColumnWidth)
	This member function draws a separator based upon the overall width of the columns. More...

void	decodeTableHeads (std::vector< std::string > &vFileContents, long long int nComment)
	This member function decodes the table heads in the text file and stores them in memory. More...

std::vector< size_t >	calculateColumnWidths (size_t &nNumberOfLines)
	This member function calculates the widths of the columns and also determines the number of lines needed for the column heads. More...

Additional Inherited Members
Protected Member Functions inherited from NumeRe::GenericFile
void	open (std::ios::openmode mode)
	This method has to be used to open the target file in stream mode. If the file cannot be opened, this method throws an error. More...

void	stripTrailingSpaces (std::string &_sToStrip)
	This method strips trailing spaces from the passed string. More...

void	replaceDecimalSign (std::string &_sToReplace)
	This method simply replaces commas with dots in the passed string to enable correct parsing into a double. More...

void	replaceTabSign (std::string &_sToReplace, bool bAddPlaceholders=false)
	This method replaces tabulator characters with whitespaces to simplify the column determination (the used tokenizer will only have to consider whitespaces as separator characters). Sometimes, replacing tabulators into whitespaces will destroy column information. To avoid this, placeholders (underscores) may be inserted as "empty" column cells. More...

std::pair< size_t, size_t >	calculateCellExtents (const std::string &sContents)
	This method calculates the extents of the passed string, if it is used as a table column headlines. This method will return a std::pair<> with the maximal number of characters in a line in the first and the number of lines in the second component. More...

std::string	getLineFromHead (long long int nCol, size_t nLineNumber)
	This method gets the selected line number from the table column headline in the selected column. If the selected text does not contain enough lines, a simple whitespaces is returned. More...

template<typename T >
T	readNumField ()
	This method is a template fo reading a numeric field of the selected template type in binary mode. More...

std::string	readStringField ()
	This mehtod can be used to read a string field from the file in binary mode. More...

std::string	getZipFileItem (const std::string &filename)
	This method may be used to get the contents of an embedded file in a zipfile and return the contents as string. More...

template<typename T >
T *	readNumBlock (long long int &size)
	This method template is for reading a block of numeric data into memory in binary mode. More...

template<typename T >
T **	readDataArray (long long int &rows, long long int &cols)
	This method template is for reading a whole two-dimensional array of data into memory in binary mode. More...

std::string *	readStringBlock (long long int &size)
	This method can be used for reading a block of string data to memory in binary mode. More...

std::vector< std::string >	readTextFile (bool stripEmptyLines)
	This method may be used to read the file in text mode and to obtain the data as a vector. More...

std::vector< std::string >	tokenize (std::string sString, const std::string &sSeparators, bool skipEmptyTokens=false)
	This method may be used to separater a line into multiple tokens using a set of separator characters. If empty token shall be skipped, then only tokens with a non-zero length are stored. More...

template<typename T >
void	writeNumField (T num)
	This method template can be used to write a numeric value to file in binary mode. More...

void	writeStringField (const std::string &sString)
	This method may be used to write a string to file in binary mode. More...

template<typename T >
void	writeNumBlock (T *data, long long int size)
	This method template may be used to write a block of data of the selected type to the file in binary mode. More...

template<typename T >
void	writeDataArray (T **data, long long int rows, long long int cols)
	This method may be used to write a two-dimensional array of data to the file in binary mode. More...

void	writeStringBlock (std::string *data, long long int size)
	This method may be used to write a block of strings into the file in binary mode. More...

void	createStorage ()
	This method prepares the internal storage, so that it may contain the read data. This method is only used for textual files. More...

void	clearStorage ()
	This method cleares the internal storage. This method is called by the destructor automatically. More...

template<typename T >
void	copyDataArray (T from, T to, long long int rows, long long int cols)
	This method may be used to copy two- dimensional arrays of data. Both source and target arrays have to exist in advance. More...

void	copyStringArray (std::string from, std::string to, long long int nElements)
	This method may be used to copy string arrays. Both source and target arrays have to exist in advance. More...

template<typename T >
void	copyArray (T from, T to, long long int nElements)
	This method template may be used to copy arrays of data of the selected type. Both source and target arrays have to exist in advance. More...

bool	isNumeric (const std::string &sString)
	This method may be used to determine, whether a string contains only numeric data. More...

void	assign (const GenericFile &file)
	This method is used by the assignment operator and the copy constructor to copy the contents of the passed GenericFile instance. More...

Protected Member Functions inherited from FileSystem
int	createFolders (const std::string &_sPath) const
	This member function creates all missing directories in the passed path. More...

Protected Attributes inherited from NumeRe::GenericFile
std::fstream	fFileStream

std::string	sFileExtension

std::string	sFileName

std::string	sTableName

std::string	sComment

long long int	nRows

long long int	nCols

unsigned short	nPrecFields

bool	useExternalData

std::ios::openmode	openMode

TableColumnArray *	fileData

Protected Attributes inherited from FileSystem
std::string	sPath

std::string	sExecutablePath

std::string	sTokens [7][2]

std::string	sValidExtensions

Detailed Description

This class resembles an arbitrary text data file, which is formatted in a table-like manner. The columns may be separated using tabulators and/or whitespace characters.

Definition at line 1433 of file file.hpp.

Constructor & Destructor Documentation

◆ TextDataFile()

NumeRe::TextDataFile::TextDataFile ( const std::string & filename )

Definition at line 96 of file file.cpp.

◆ ~TextDataFile()

NumeRe::TextDataFile::~TextDataFile ( )

virtual

Definition at line 102 of file file.cpp.

Member Function Documentation

◆ addSeparator()

void NumeRe::TextDataFile::addSeparator ( const std::vector< size_t > & vColumnWidth )

private

This member function draws a separator based upon the overall width of the columns.

Parameters

vColumnWidth const vector<size_t>&

Returns: void

Definition at line 362 of file file.cpp.

References NumeRe::GenericFile::fFileStream.

Referenced by writeFile().

◆ calculateColumnWidths()

vector< size_t > NumeRe::TextDataFile::calculateColumnWidths ( size_t & nNumberOfLines )

private

This member function calculates the widths of the columns and also determines the number of lines needed for the column heads.

Parameters

nNumberOfLines size_t&

Returns: vector<size_t>

Definition at line 795 of file file.cpp.

References NumeRe::GenericFile::calculateCellExtents(), NumeRe::GenericFile::fileData, TableColumn::getDefaultColumnHead(), max, NumeRe::GenericFile::nCols, and NumeRe::GenericFile::nPrecFields.

Referenced by writeFile().

Here is the call graph for this function:

◆ decodeTableHeads()

void NumeRe::TextDataFile::decodeTableHeads	(	std::vector< std::string > &	vFileContents,
		long long int	nComment
	)

private

This member function decodes the table heads in the text file and stores them in memory.

Parameters

vFileContents	vector<string>&
nComment	long longint

Returns: void

Definition at line 390 of file file.cpp.

References NumeRe::GenericFile::fileData, NumeRe::GenericFile::isNumeric(), min, NumeRe::GenericFile::nCols, replaceAll(), NumeRe::GenericFile::tokenize(), and utf8parser().

Referenced by readFile().

Here is the call graph for this function:

◆ read()

virtual bool NumeRe::TextDataFile::read ( )

inlineoverridevirtual

Pure virtual declaration of the read access method. Has to be implemented in all derived classes and can be used to read the contents of the file to memory.

Returns: bool

Implements NumeRe::GenericFile.

Definition at line 1450 of file file.hpp.

References readFile().

Here is the call graph for this function:

◆ readFile()

void NumeRe::TextDataFile::readFile ( )

private

This method reads the data in the referenced text file to memory.

Returns: void

Definition at line 115 of file file.cpp.

Referenced by read().

Here is the call graph for this function:

◆ write()

virtual bool NumeRe::TextDataFile::write ( )

inlineoverridevirtual

Pure virtual declaration of the write access method. Has to be implemented in all derived classes and can be used to write the contents in memory to the target file.

Returns: bool

Implements NumeRe::GenericFile.

Definition at line 1456 of file file.hpp.

References writeFile().

Here is the call graph for this function:

◆ writeFile()

void NumeRe::TextDataFile::writeFile ( )

private

This method writes the data in memory to the referenced text file.

Returns: void

Definition at line 234 of file file.cpp.

References addSeparator(), calculateColumnWidths(), NumeRe::GenericFile::open(), date::detail::trunc(), writeHeader(), writeTableContents(), and writeTableHeads().

Referenced by write().

Here is the call graph for this function:

◆ writeHeader()

void NumeRe::TextDataFile::writeHeader ( )

private

This member function writes the header lines or the text files.

Returns: void

Definition at line 263 of file file.cpp.

References _lang, AutoVersion::DATE, NumeRe::GenericFile::fFileStream, Language::get(), getTimeStamp(), AutoVersion::MONTH, sVersion, and AutoVersion::YEAR.

Referenced by writeFile().

Here is the call graph for this function:

◆ writeTableContents()

void NumeRe::TextDataFile::writeTableContents ( const std::vector< size_t > & vColumnWidth )

private

This member function is used to write the data in memory to the target text file.

Parameters

vColumnWidth const vector<size_t>&

Returns: void

Definition at line 326 of file file.cpp.

References NumeRe::GenericFile::fFileStream, NumeRe::GenericFile::fileData, NumeRe::GenericFile::nCols, NumeRe::GenericFile::nPrecFields, NumeRe::GenericFile::nRows, toString(), and TableColumn::TYPE_VALUE.

Referenced by writeFile().

Here is the call graph for this function:

◆ writeTableHeads()

void NumeRe::TextDataFile::writeTableHeads	(	const std::vector< size_t > &	vColumnWidth,
		size_t	nNumberOfLines
	)

private

This member function is used to write the table heads into the target file.

Parameters

vColumnWidth	const vector<size_t>&
nNumberOfLines	size_t

Returns: void

Definition at line 293 of file file.cpp.

References NumeRe::GenericFile::fFileStream, NumeRe::GenericFile::getLineFromHead(), and NumeRe::GenericFile::nCols.

Referenced by writeFile().

Here is the call graph for this function:

The documentation for this class was generated from the following files:

D:/CPP/numere-source/trunk/kernel/core/io/file.hpp
D:/CPP/numere-source/trunk/kernel/core/io/file.cpp

Public Member Functions

Private Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ TextDataFile()

◆ ~TextDataFile()

Member Function Documentation

◆ addSeparator()

◆ calculateColumnWidths()

◆ decodeTableHeads()

◆ read()

◆ readFile()

◆ write()

◆ writeFile()

◆ writeHeader()

◆ writeTableContents()

◆ writeTableHeads()