cereal
A C++11 library for serialization
Public Member Functions | Friends | List of all members
cereal::InputArchive< ArchiveType, Flags > Class Template Reference

The base input archive class. More...

#include </build/libcereal-SAfJB3/libcereal-1.3.2+dfsg/include/cereal/cereal.hpp>

Inheritance diagram for cereal::InputArchive< ArchiveType, Flags >:
cereal::detail::InputArchiveBase

Public Member Functions

 InputArchive (ArchiveType *const derived)
 Construct the output archive. More...
 
InputArchiveoperator= (InputArchive const &)=delete
 
template<class ... Types>
ArchiveType & operator() (Types &&... args)
 Serializes all passed in data. More...
 
void serializeDeferments ()
 Serializes any data marked for deferment using defer. More...
 
std::shared_ptr< void > getSharedPointer (std::uint32_t const id)
 Retrieves a shared pointer given a unique key for it. More...
 
void registerSharedPointer (std::uint32_t const id, std::shared_ptr< void > ptr)
 Registers a shared pointer to its unique identifier. More...
 
std::string getPolymorphicName (std::uint32_t const id)
 Retrieves the string for a polymorphic type given a unique key for it. More...
 
void registerPolymorphicName (std::uint32_t const id, std::string const &name)
 Registers a polymorphic name string to its unique identifier. More...
 
- Public Member Functions inherited from cereal::detail::InputArchiveBase
 InputArchiveBase (InputArchiveBase &&) CEREAL_NOEXCEPT
 
InputArchiveBaseoperator= (InputArchiveBase &&) CEREAL_NOEXCEPT
 

Friends

template<class A , class B , bool C, bool D, bool E, bool F>
struct detail::Construct
 Befriend for versioning in load_and_construct.
 

Boost Transition Layer

Functionality that mirrors the syntax for Boost. This is useful if you are transitioning a large project from Boost to cereal. The preferred interface for cereal is using operator().

using is_loading = std::true_type
 Indicates this archive is intended for loading. More...
 
using is_saving = std::false_type
 Indicates this archive is not intended for saving. More...
 
template<class T >
ArchiveType & operator& (T &&arg)
 Serializes passed in data. More...
 
template<class T >
ArchiveType & operator>> (T &&arg)
 Serializes passed in data. More...
 

Detailed Description

template<class ArchiveType, std::uint32_t Flags = 0>
class cereal::InputArchive< ArchiveType, Flags >

The base input archive class.

This is the base input archive for all input archives. If you create a custom archive class, it should derive from this, passing itself as a template parameter for the ArchiveType.

The base class provides all of the functionality necessary to properly forward data to the correct serialization functions.

Individual archives should use a combination of prologue and epilogue functions together with specializations of serialize, save, and load to alter the functionality of their serialization.

Template Parameters
ArchiveTypeThe archive type that derives from InputArchive
FlagsFlags to control advanced functionality. See the Flags enum for more information.

Member Typedef Documentation

◆ is_loading

template<class ArchiveType , std::uint32_t Flags = 0>
using cereal::InputArchive< ArchiveType, Flags >::is_loading = std::true_type

Indicates this archive is intended for loading.

This ensures compatibility with boost archive types. If you are transitioning from boost, you can check this value within a member or external serialize function (i.e., Archive::is_loading::value) to enable behavior specific to loading, until you can transition to split save/load or save_minimal/load_minimal functions

◆ is_saving

template<class ArchiveType , std::uint32_t Flags = 0>
using cereal::InputArchive< ArchiveType, Flags >::is_saving = std::false_type

Indicates this archive is not intended for saving.

This ensures compatibility with boost archive types. If you are transitioning from boost, you can check this value within a member or external serialize function (i.e., Archive::is_saving::value) to disable behavior specific to loading, until you can transition to split save/load or save_minimal/load_minimal functions

Constructor & Destructor Documentation

◆ InputArchive()

template<class ArchiveType , std::uint32_t Flags = 0>
cereal::InputArchive< ArchiveType, Flags >::InputArchive ( ArchiveType *const  derived)
inline

Construct the output archive.

Parameters
derivedA pointer to the derived ArchiveType (pass this from the derived archive)

Member Function Documentation

◆ getPolymorphicName()

template<class ArchiveType , std::uint32_t Flags = 0>
std::string cereal::InputArchive< ArchiveType, Flags >::getPolymorphicName ( std::uint32_t const  id)
inline

Retrieves the string for a polymorphic type given a unique key for it.

This is used to retrieve a string previously registered during a polymorphic load.

◆ getSharedPointer()

template<class ArchiveType , std::uint32_t Flags = 0>
std::shared_ptr< void > cereal::InputArchive< ArchiveType, Flags >::getSharedPointer ( std::uint32_t const  id)
inline

Retrieves a shared pointer given a unique key for it.

This is used to retrieve a previously registered shared_ptr which has already been loaded.

◆ operator&()

template<class ArchiveType , std::uint32_t Flags = 0>
template<class T >
ArchiveType & cereal::InputArchive< ArchiveType, Flags >::operator& ( T &&  arg)
inline

Serializes passed in data.

This is a boost compatability layer and is not the preferred way of using cereal. If you are transitioning from boost, use this until you can transition to the operator() overload

◆ operator()()

template<class ArchiveType , std::uint32_t Flags = 0>
template<class ... Types>
ArchiveType & cereal::InputArchive< ArchiveType, Flags >::operator() ( Types &&...  args)
inline

Serializes all passed in data.

This is the primary interface for serializing data with an archive

◆ operator>>()

template<class ArchiveType , std::uint32_t Flags = 0>
template<class T >
ArchiveType & cereal::InputArchive< ArchiveType, Flags >::operator>> ( T &&  arg)
inline

Serializes passed in data.

This is a boost compatability layer and is not the preferred way of using cereal. If you are transitioning from boost, use this until you can transition to the operator() overload

◆ registerPolymorphicName()

template<class ArchiveType , std::uint32_t Flags = 0>
void cereal::InputArchive< ArchiveType, Flags >::registerPolymorphicName ( std::uint32_t const  id,
std::string const &  name 
)
inline

Registers a polymorphic name string to its unique identifier.

After a polymorphic type has been loaded for the first time, it should be registered with its loaded id for future references to it.

◆ registerSharedPointer()

template<class ArchiveType , std::uint32_t Flags = 0>
void cereal::InputArchive< ArchiveType, Flags >::registerSharedPointer ( std::uint32_t const  id,
std::shared_ptr< void >  ptr 
)
inline

Registers a shared pointer to its unique identifier.

After a shared pointer has been allocated for the first time, it should be registered with its loaded id for future references to it.

◆ serializeDeferments()

template<class ArchiveType , std::uint32_t Flags = 0>
void cereal::InputArchive< ArchiveType, Flags >::serializeDeferments ( )
inline

Serializes any data marked for deferment using defer.

This will cause any data wrapped in DeferredData to be immediately serialized


The documentation for this class was generated from the following file: