CArchive 클래스 설명

Data Members

m_pDocument

Points to the CDocument object being serialized.

Construction

Abort	Closes an archive without throwing an exception.
CArchive	Creates a CArchive object.
Close	Flushes unwritten data and disconnects from the CFile.

Basic Input/Output

Flush	Flushes unwritten data from the archive buffer.
operator <<	Stores objects and primitive types to the archive.
operator >>	Loads objects and primitive types from the archive.
Read	Reads raw bytes.
ReadString	Reads a single line of text.
Write	Writes raw bytes.
WriteString	Writes a single line of text.

Status

GetFile	Gets the CFile object pointer for this archive.
GetObjectSchema	Called from the Serialize function to determine the version of the object that is being deserialized.
IsBufferEmpty	Determines whether the buffer has been emptied during a Windows Sockets receive process.
IsByteSwapping
IsLoading	Determines whether the archive is loading.
IsStoring	Determines whether the archive is storing.
SetObjectSchema	Sets the object schema stored in the archive object.

Object Input/Output

MapObject	Places objects in the map that are not serialized to the file, but that are available for subobjects to reference.
ReadClass	Reads a class reference previously stored with WriteClass.
ReadObject	Calls an object's Serialize function for loading.
SerializeClass	Reads or writes the class reference to the CArchive object depending on the direction of the CArchive.
SetLoadParams	Sets the size to which the load array grows. Must be called before any object is loaded or before MapObject or ReadObject is called.
SetStoreParams	Sets the hash table size and the block size of the map used to identify unique objects during the serialization process.
WriteClass	Writes a reference to the CRuntimeClass to the CArchive.
WriteObject	Calls an object's

Constructs a CArchive object and specifies whether it will be used for loading or storing objects.

CArchive(

   CFile* pFile,

   UINT nMode,

   int nBufSize = 4096,

   void* lpBuf = NULL 

);

Parameters

pFile

A pointer to the CFile object that is the ultimate source or destination of the persistent data.

nMode

A flag that specifies whether objects will be loaded from or stored to the archive. The nMode parameter must have one of the following values:

·         CArchive::load   Loads data from the archive. Requires only CFile read permission.

·         CArchive::store   Saves data to the archive. Requires CFile write permission.

·         CArchive::bNoFlushOnDelete   Prevents the archive from automatically calling Flush when the archive destructor is called. If you set this flag, you are responsible for explicitly calling Close before the destructor is called. If you do not, your data will be corrupted.

nBufSize

An integer that specifies the size of the internal file buffer, in bytes. Note that the default buffer size is 4,096 bytes. If you routinely archive large objects, you will improve performance if you use a larger buffer size that is a multiple of the file buffer size.

lpBuf

An optional pointer to a user-supplied buffer of size nBufSize. If you do not specify this parameter, the archive allocates a buffer from the local heap and frees it when the object is destroyed. The archive does not free a user-supplied buffer.

Remarks

You cannot change this specification after you have created the archive.

You may not use CFile operations to alter the state of the file until you have closed the archive. Any such operation will damage the integrity of the archive. You may access the position of the file pointer at any time during serialization by obtaining the archive's file object from the GetFile member function and then using the CFile::GetPosition function. You should call CArchive::Flush before obtaining the position of the file pointer.

Example

extern char* pFileName;

CFile f;

char buf[512];

if( !f.Open( pFileName, CFile::modeCreate | CFile::modeWrite ) ) {

   #ifdef _DEBUG

      afxDump << "Unable to open file" << "\n";

      exit( 1 );

   #endif

}

CArchive ar( &f, CArchive::store, 512, buf );