Export (0) Print
Expand All

CFile Class

The base class for Microsoft Foundation Class file classes.

class CFile : public CObject

Name

Description

CFile::CFile

Constructs a CFile object from a path or file handle.

Name

Description

CFile::Abort

Closes a file ignoring all warnings and errors.

CFile::Close

Closes a file and deletes the object.

CFile::Duplicate

Constructs a duplicate object based on this file.

CFile::Flush

Flushes any data yet to be written.

CFile::GetFileName

Retrieves the filename of the selected file.

CFile::GetFilePath

Retrieves the full file path of the selected file.

CFile::GetFileTitle

Retrieves the title of the selected file.

CFile::GetLength

Retrieves the length of the file.

CFile::GetPosition

Retrieves the current file pointer.

CFile::GetStatus

Retrieves the status of the open file, or in the static version, retrieves the status of the specified file (static, virtual function).

CFile::LockRange

Locks a range of bytes in a file.

CFile::Open

Safely opens a file with an error-testing option.

CFile::Read

Reads (unbuffered) data from a file at the current file position.

CFile::Remove

Deletes the specified file (static function).

CFile::Rename

Renames the specified file (static function).

CFile::Seek

Positions the current file pointer.

CFile::SeekToBegin

Positions the current file pointer at the beginning of the file.

CFile::SeekToEnd

Positions the current file pointer at the end of the file.

CFile::SetFilePath

Sets the full file path of the selected file.

CFile::SetLength

Changes the length of the file.

CFile::SetStatus

Sets the status of the specified file (static, virtual function).

CFile::UnlockRange

Unlocks a range of bytes in a file.

CFile::Write

Writes (unbuffered) data in a file to the current file position.

Name

Description

CFile::operator HANDLE

A handle to a CFile object.

Name

Description

CFile::hFileNull

Determines if the CFile object has a valid handle.

CFile::m_hFile

Usually contains the operating-system file handle.

Name

Description

CFile::m_pTM

Pointer to CAtlTransactionManager object.

It directly provides unbuffered, binary disk input/output services, and it indirectly supports text files and memory files through its derived classes. CFile works in conjunction with the CArchive class to support serialization of Microsoft Foundation Class objects.

The hierarchical relationship between this class and its derived classes allows your program to operate on all file objects through the polymorphic CFile interface. A memory file, for example, behaves like a disk file.

Use CFile and its derived classes for general-purpose disk I/O. Use ofstream or other Microsoft iostream classes for formatted text sent to a disk file.

Normally, a disk file is opened automatically on CFile construction and closed on destruction. Static member functions permit you to interrogate a file's status without opening the file.

For more information on using CFile, see the articles Files in MFC and File Handling in the Run-Time Library Reference.

Header: afx.h

Show:
© 2014 Microsoft