Share via


CArchive::operator >>

Loads the indicated object or primitive type from the archive.

friend CArchive& operator >>( 
   CArchive& ar, 
   CObject *& pOb  
); 
throw( 
   CArchiveException*, 
   CFileException*, 
   CMemoryException*  
); 
friend CArchive& operator >>( 
   CArchive& ar, 
   const CObject *& pOb  
); 
throw( 
   CArchiveException*, 
   CFileException*, 
   CMemoryException*  
); 
CArchive& AFXAPI operator >>( 
   CArchive& ar, 
   const RECT& rect 
); 
CArchive& AFXAPI operator >>( 
   CArchive& ar, 
   POINT point 
); 
CArchive& AFXAPI operator >>( 
  CArchive& ar, 
   SIZE size 
); 
template<  
   typename BaseType,  
   class StringTraits  
> 
CArchive& operator>>( 
   ATL::CStringT< 
      BaseType,  
      StringTraits 
   >& str 
); 
CArchive& operator >>( 
   BYTE& by  
); 
CArchive& operator >>( 
   WORD& w  
); 
CArchive& operator >>( 
   int& i  
); 
CArchive& operator >>( 
   LONG& l  
); 
CArchive& operator >>( 
   DWORD& dw  
); 
CArchive& operator >>( 
   float& f  
); 
CArchive& operator >>( 
   double& d  
); 
CArchive& operator >>( 
   short& w  
); 
CArchive& operator >>( 
   char& ch  
); 
CArchive& operator>>( 
   wchar_t& ch); 
CArchive& operator >>( 
   unsigned& u  
); 
CArchive& operator >>( 
   bool& b  
); 
CArchive& operator >>( 
   ULONGLONG& dwdw  
); 
CArchive& operator >>( 
   LONGLONG& dwdw  
);

Return Value

A CArchive reference that enables multiple extraction operators on a single line.

Remarks

The last two versions above are specifically for loading 64-bit integers.

If you used the IMPLEMENT_SERIAL macro in your class implementation, then the extraction operators overloaded for CObject call the protected ReadObject function (with a nonzero run-time class pointer). This function, in turn, calls the Serialize function of the class.

The CStringT extraction operator (>>) supports loading from an archive.

Example

This example demonstrates the use of the CArchive extraction operator >> with the int type.

long l;
int i;
if(ar.IsLoading())
   ar >> l >> i;

This example demonstrates the use of the CArchive insertion and extraction operators << and >> with the CStringT type.

CString s;
if (ar.IsLoading())
   ar >> s;

Requirements

Header: afx.h

See Also

Reference

CArchive Class

Hierarchy Chart

CArchive::ReadObject

CObject::Serialize

Other Resources

CArchive Members