Class CTextFileLinesParser

Class Documentation

class CTextFileLinesParser

A class for parsing text files, returning each non-empty and non-comment line, along its line number. Lines are strip out of leading and trailing whitespaces. By default, lines starting with either “#”, “//” or “%” are skipped as comment lines, unless this behavior is explicitly disabled with enableCommentFilters.

Public Functions

CTextFileLinesParser() = default

Default constructor; should call open() at some moment later.

explicit CTextFileLinesParser(const std::string &filename)

Constructor for opening a file

Throws:

std::exception – On error opening file

explicit CTextFileLinesParser(std::istream &in)

Constructor for reading from a generic std::istream. Note that a reference to the stream is stored in the object, so it’s the user responsibility to make sure the stream is not destroyed before than this object.

void open(const std::string &fil)

Open a file (an alternative to the constructor with a file name)

void open(std::istream &in)

Opens for reading a generic std::istream. Note that a reference to the stream is stored in the object, so it’s the user responsibility to make sure the stream is not destroyed before than this object.

void close()

Close the file (no need to call it normally, the file is closed upon destruction)

void rewind()

Reset the read pointer to the beginning of the file

bool getNextLine(std::string &out_str)

Reads from the file and return the next (non-comment) line, as a std::string

Returns:

false on EOF.

bool getNextLine(std::istringstream &buf)

Reads from the file and stores the next (non-comment) line into the given stream buffer.

Returns:

false on EOF.

size_t getCurrentLineNumber() const

Return the line number of the last line returned with getNextLine

void enableCommentFilters(bool filter_MATLAB_comments, bool filter_C_comments, bool filter_SH_comments)

Enable/disable filtering of lines starting with “%”, “//” or “#”, respectively.