TextFile :: write - Write data to file

The function allows writing text data to file. When an error occurred while writing the file, the function throws an exception.

The function is supported for simple text processing. Calling the function for any other kind of text processing will cause an exception.

Implementation overview

Write string to file
TextFile :: write ( sString )
Write text as position
TextFile :: write ( sString, iPosition64 )

Implementation details

Write string to file
TextFile :: write ( odaba::String &sString )

The data passed in sString will be written at last position updated.
- sString - String value

Write text as position
TextFile :: write ( odaba::String &sString, int64 iPosition64 )

The data passed in sString will be written at position passed in iPosition64. In order to write data after last position written or read, -1 may be passed in iPosition64.

Notes:
When passing a position beyond the end of file, the area between end of file and iPosition64 is filled with undefined characters.
- sString - String value
- iPosition64 - Position in an area or file
  The big position value usually refers to a relative position in an area or file.