Titus Information Systems CTableFile Class

Titus Information Systems, Inc.

Standard Library
CTableFile Class

This class is inherited from CFile and provides several additional member functions and variables that access fixed-field, variable-length, binary table files. Both the file and memory buffer must start with a short (16-bit integer) that specifies the number of records in the table. This class is called by the TABLEFIL Cobol function. The member functions and variables are as follows:

CTableFile::CTableFile(): This is the default constructor. It initializes the data members. CTableFile::FileName is set to NULL, CTableFile::Length is set to zero, and CTableFile::Record is set to NULL.
CTableFile::CTableFile(CString fn, short Len, short*Rec): This constructor is used to initialize the internal variables. CTableFile::FileName is set to fn, CTableFile::Length is set to Len, and CTableFile::Record is set to Rec.
CTableFile::~CTableFile(): This is the destructor. It deallocates the data members.
BOOL CTableFile::Load(): This member function loads the data from the table file into the memory buffer. The table file is then closed.
BOOL CTableFile::Store(): This member function stores the data into the table file from the memory buffer. Any data in the file is overwritten. The table file is then closed.
BOOL CTableFile::Read(): This member function loads the data from the table file into the memory buffer. The table file remains open so it can be rewritten using the CTableFile::Write() function.
BOOL CTableFile::Write(): This member function stores the data into the table file from the memory buffer. Any data in the file is overwritten. The table file must have been opened by the CTableFile::Read() function.
CString CTableFile::FileName: This data member is used to store the name of the table file. It may be set by the constructor or directly by the invoking function.
short CTableFile::Length: This data member is used to store the length of the memory buffer that contains a copy of the table file. It may be set by the constructor or directly by the invoking function.
short* CTableFile::Record: This data member is used to store the pointer to the memory buffer that contains a copy of the table file. It may be set by the constructor or directly by the invoking function.