This documentation is archived and is not being maintained.

CObject::Serialize

Reads or writes this object from or to an archive.

virtual void Serialize(
   CArchive& ar 
);

Parameters

ar
A CArchive object to serialize to or from.

Remarks

You must override Serialize for each class that you intend to serialize. The overridden Serialize must first call the Serialize function of its base class.

You must also use the DECLARE_SERIAL macro in your class declaration, and you must use the IMPLEMENT_SERIAL macro in the implementation.

Use CArchive::IsLoading or CArchive::IsStoring to determine whether the archive is loading or storing.

Serialize is called by CArchive::ReadObject and CArchive::WriteObject. These functions are associated with the CArchive insertion operator (<<) and extraction operator (>>).

For serialization examples, see the article Serialization: Serializing an Object.

Example

See CObList::CObList for a listing of the CAge class used in all CObject examples.

// example for CObject::Serialize
void CAge::Serialize( CArchive& ar )
 {
 CObject::Serialize( ar );
     if( ar.IsStoring() )
     ar << m_years;
     else
     ar >> m_years;
 }

See Also

CObject Overview | Class Members | Hierarchy Chart

Show: