CFile:new

CFile Class


The CFile class provides file reading and writing operations. Normally, this class is used for binary-mode file operations. You also can use it for text-mode file operations but the lua language includes an excellent io package for working with text files..

Usage

Construction

Object = CFile:new()

Destruction

Object:delete()

Properties

This class contains 3 enumeration properties for use with the Seek method:

eBegin

The file offset is moved relative to the beginning of the file.

eCurrent

The file offset is moved relative to the current position.

eEnd

The file offset is moved relative to the end of the file.

Class Methods

Construction

new

Creates a new instance of a CFile object.

delete

Deletes the instance of the CFile object.

Operations

Close

Closes the file.

FilePos

Returns the current file position.

Flush

Commits data in the operating system buffer to the file.

GetPath

Returns the name of the file.

Open

Opens the file.

Printf

Writes formatted text to the file.

Read

Reads a value or table of values of specified data type from a binary file.

ReadBswap

Reads a value or table of values of specified data type from a binary file. The values are automatically byte-swapped.

Seek

Resets the file position to a given location.

Write

Writes a value or table to a binary file using the specified data type.

WriteBswap

Writes a value or table to a binary file using the specified data type. The values are automatically byte-swapped before being written to the file.

Related Topics

Printf, CFindFiles