[[TOC]]

= CFile =

CFile is a C++ class that is provided to simplify 825 file operations. CFile is a wrapper class around the standard C library FILE object. CFile also provides some useful features such as baud rate setting for the 825 serial ports.

== Constructors ==

{{{
CFile(void);
CFile(const string& strFilename);
CFile(const char* pszfilename);
}}}
These constructors just create a CFile object without opening a file.
{{{
CFile(const string& strFilename, const string& strMode);
CFile(const string& strFilename, const char* pszMode);
CFile(const char* pszFilename, const string& strMode);
CFile(const char* pszFilename, const char* pszMode);
}}}
These constructors construct the file object and attempt to open the file.

{{{
CFile fileLog("/mnt/fl1/log.txt", "a");
if(fileLog.IsOpen())
{
     fileLog.Print("Gross %s Tare %s Net %s\r\n", FormatGrossWt(1).c_str(), FormatTareWt(1).c_str(), FormatNetWt(1).c_str()); 
     fileLog.Close();
}
}}}

==== Parameters ====
 * strFilename - filename
 * pszFilename - filename
 * strMode - mode
 * pszMode - mode

== Member Functions ==

=== Open ===
Opens a specified file, or using the filename already stored in the object.

{{{
bool Open(const string& strFilename, const string& strMode);
bool Open(const string& strFilename, const char* pszMode);
bool Open(const char* pszFilename, const string& strMode);
bool Open(const char* pszFilename, const char* pszMode);
bool Open(const char* pszMode);
}}}

==== Parameters ====
 * strFilename - filename
 * pszFilename - filename
 * strMode - mode
 * pszMode - mode

==== Return Value ====

Returns true if successful or false if unsuccessful.

==== Remarks ====

==== Example ====

{{{
CFile file;
if(file.Open("/tmp/tmpfile", "w") == false)
{
    DisplayText(0, 0, "Error writing temporary file");
}

}}}

=== Close ===
Closes the file
{{{
void Close(void);
}}}

==== Parameters ====

Function does not accept any parameters

==== Result ====
 
Function does not return any result.

=== SetSerial ===

 * bool SetSerial(baud_index baud, data_bit_index = data8, parity_index = parityNone, stop_bit_index = stopOne);

=== ReadLine ===

 * bool ReadLine(std::string& str);

=== DeleteFile ===

 * static bool DeleteFile(std::string& filepath);
 * static bool DeleteFile(const char* filepath);

 * bool DeleteFile(void);


=== IsReady ===
Check the state of the serial CTS input
{{{
bool IsReady(void);
}}}
==== Parameters ==== 

Function does not accept any parameters.

==== Return Value ====

Function returns true if CTS is active, false if CTS is inactive.

==== Remarks ====

==== Example ====

{{{
CFile fileLogOutput("/dev/ttyS1", "w");
if(fileLogOutput.IsOpen())
{
   fileLogOutput.SetRTS(true);
   if(fileLogOutput.IsReady() == false)
   {
      DisplayText(0, 0, "Printer offline, or disconnected");
   }
}
}}}


=== SetRTS ===
Set the state of the serial RTS output

{{{
bool SetRTS(bool bRTSOn = true);
}}}

==== Parameters ==== 

 * bRTSOn - true to turn on RTS output, false to turn off RTS output

==== Return Value ====

 * Returns true if successfully set RTS state, false otherwise.

==== Remarks ====

==== Example ====

{{{
CFile fileLogOutput("/dev/ttyS1", "w");
fileLogOutput.SetRTS(true);
}}}



=== GetFile ===

 * FILE* GetFile(void);

=== Print ===

 * void Print(const std::string& fmt, ...);
 * void Print(const char * fmt, va_list& args);
 * void Print(const std::string& fmt, va_list& args);
 * void Print(const char * fmt, va_list& args);

=== SetNonBlocking ===

 * void SetNonBlocking(void);



=== Read ===

 * bool Read(void * ptr, size_t size);

=== Write ===

 * bool Write(void * buf, size_t size);

=== GetBytesRead ===

 * size_t GetBytesRead(void);

=== GetbytesWritten ===

 * size_t GetBytesWritten(void);

=== Seek ===

 * bool Seek(long int offset, long int origin = SEEK_SET);