就业培训     下载中心     Wiki     联络 登录   注册
  1. 首页
  2. C4D R23.110 C++ SDK
公共成员函数 | 私有成员函数 | 所有成员列表

DataSerializeInterface Class Reference

#include <dataserialize.h>

Inheritance diagram for DataSerializeInterface:
Inheritance graph
[ legend ]

详细描述

This is the base class for generic serialization of any data type. For reading and writing the interfaces are split into DataSerializeReaderInterface and DataSerializeWriterInterface 。 DataFormatReaderInterface and DataFormatWriterInterface can add specific serialization for data types. The DataSerializeReaderClasses and DataSerializeWriterClasses registry lists all possible formats. io_overview_describeio

公共成员函数

MAXON_METHOD Result < void >  DescribeElement (const Char *name, const DataType &dt, Int objectOffset, KeyValueConversionFunc *func, DESCRIBEFLAGS flags, UInt64 mask, UInt64 value) const
MAXON_METHOD Result < void >  PrepareHelperClass ( CreateIoHelperFunc *createFunc, DeleteIoHelperFunc *deleteFunc, ReadIoHelperFunc *readFunc, WriteIoHelperFunc *writeFunc, PREPAREHELPERFLAGS flags) const
MAXON_METHOD Result < void >  RegisterObjectSubstitution ( ReferenceSubstitutionFunction &&func)
MAXON_METHOD Result < void * >  RegisterDefaults ( CreateIoHelperFunc *createFunc, DeleteIoHelperFunc *deleteFunc) const
template<typename HELPERCLASS , typename MAINCLASS >
Result < void >  PrepareHelperClass ( PREPAREHELPERFLAGS flags) const
template<typename CLASSNAME , typename CMP , decltype(DESCRIBEFLAGS::_value) FLAGS, typename T >
Result < void >  DescribeElement (const Char *fileName, const UniqueRef < T > *member, decltype( DESCRIBEFLAGS::_value ) additional, UInt64 mask=0, UInt64 value=0) const
template<typename CLASSNAME , typename CMP , decltype(DESCRIBEFLAGS::_value) FLAGS, typename T >
Result < void >  DescribeElement (const Char *fileName, const WeakRef < T > *member, decltype( DESCRIBEFLAGS::_value ) additional, UInt64 mask=0, UInt64 value=0) const
template<typename CLASSNAME , typename CMP , decltype(DESCRIBEFLAGS::_value) FLAGS, typename T >
std::enable_if< GetCollectionKind < T >::value== COLLECTION_KIND::NONE , Result < void > >::type  DescribeElement (const Char *fileName, const T *member, decltype( DESCRIBEFLAGS::_value ) additional, UInt64 mask=0, UInt64 value=0) const
template<typename CLASSNAME , typename CMP , decltype(DESCRIBEFLAGS::_value) FLAGS, typename T >
std::enable_if< GetCollectionKind < T >::value== COLLECTION_KIND::ARRAY , Result < void > >::type  DescribeElement (const Char *fileName, const T *member, decltype( DESCRIBEFLAGS::_value ) additional) const
template<typename CLASSNAME , typename CMP , decltype(DESCRIBEFLAGS::_value) FLAGS, typename T >
std::enable_if< GetCollectionKind < T >::value== COLLECTION_KIND::SET , Result < void > >::type  DescribeElement (const Char *fileName, const T *member, decltype( DESCRIBEFLAGS::_value ) additional) const
template<typename CLASSNAME , typename CMP , decltype(DESCRIBEFLAGS::_value) FLAGS, typename T >
std::enable_if< GetCollectionKind < T >::value== COLLECTION_KIND::MAP , Result < void > >::type  DescribeElement (const Char *fileName, const T *member, decltype( DESCRIBEFLAGS::_value ) additional) const

私有成员函数

  MAXON_INTERFACE ( DataSerializeInterface , MAXON_REFERENCE_NORMAL , "net.maxon.interface.dataserialize")

成员函数文档编制

◆  MAXON_INTERFACE()

MAXON_INTERFACE ( DataSerializeInterface   ,
MAXON_REFERENCE_NORMAL   ,
"net.maxon.interface.dataserialize"   
)
private

◆  DescribeElement() [1/7]

MAXON_METHOD Result <void> DescribeElement ( const Char *  name ,
const DataType &  dt ,
Int   objectOffset ,
KeyValueConversionFunc *  func ,
DESCRIBEFLAGS   flags ,
UInt64   mask ,
UInt64   value  
) const

Describes an element for I/O operations. Usually this routine is not directly called. Instead the helper-defines Describe , DescribeHelper , DescribeIf etc. are used.

参数
[in] name The clear-text name of an element in the file format. It can be arbitrarily chosen, but usually matches the respective member name. Once it has been used in files the identifier needs to stay the same to remain compatible (unless some conversion code is added). The name must only contain (latin) alphanumeric characters or '_' and it must not start with a numeric character. 'name' must be permanently available (and not only during the time of this call).
[in] dt The data type of the member (a registered data type must exist).
[in] objectOffset The offset position of the member in the class (or the helper class).
[in] func A conversion function that translates an address into the appropriate accessor interface (e.g. MapInterface or ArrayInterface ).
[in] flags Properties of the element.
[in] mask Conditional mask for DESCRIBEFLAGS::CONDITION_IF and DESCRIBEFLAGS::CONDITION_ELSE .
[in] value Conditional value for DESCRIBEFLAGS::CONDITION_IF and DESCRIBEFLAGS::CONDITION_ELSE .
返回
OK on success.

◆  PrepareHelperClass() [1/2]

MAXON_METHOD Result <void> PrepareHelperClass ( CreateIoHelperFunc *  createFunc ,
DeleteIoHelperFunc *  deleteFunc ,
ReadIoHelperFunc *  readFunc ,
WriteIoHelperFunc *  writeFunc ,
PREPAREHELPERFLAGS   flags  
) const

Declares and prepares a helper class. This can only be done once within DescribeIO. The helper class is used to convert I/O data and initialize temporary values. Usually this routine is not directly called. Instead the helper-define @ PrepareHelper is used.

参数
[in] createFunc The function to create the helper class.
[in] deleteFunc The function to delete the helper class.
[in] readFunc The function pointing to the helper's ReadAction member function.
[in] writeFunc The function pointing to the helper's WriteAction member function.
[in] flags Properties of the helper.
返回
OK on success.

◆  RegisterObjectSubstitution()

MAXON_METHOD Result <void> RegisterObjectSubstitution ( ReferenceSubstitutionFunction &&  func )

Registers a substitution function to replace virtual objects (objects with virtual interfaces) during the I/O process. The registration must happen before the main Read/Write call. The substitution will be able to write a different object than the one that exists in memory - or restore a different object than what is written into the stream. An example is e.g. RPC: instead of writing a WindowRef object only an object containing an Id is written to the file. On the other side then the object with the Id is read and a RPC WindowRef created. Substitutions fully support the referencing system, so all StrongReferences and WeakReferences will remain valid.

参数
[in] func The substitution function (used for both reading and writing).
返回
OK on success.

◆  RegisterDefaults()

MAXON_METHOD Result <void*> RegisterDefaults ( CreateIoHelperFunc *  createFunc ,
DeleteIoHelperFunc *  deleteFunc  
) const

Registers a class to support a later default value comparison. If the writer supports this feature an allocated class (using the createFunc) will be returned. Otherwise a nullptr is returned, which is no error state.

参数
[in] createFunc The function to create the class.
[in] deleteFunc The function to delete the class.
返回
The allocated class or a nullptr.

◆  PrepareHelperClass() [2/2]

Result <void> PrepareHelperClass ( PREPAREHELPERFLAGS   flags ) const

◆  DescribeElement() [2/7]

Result <void> DescribeElement ( const Char *  fileName ,
const UniqueRef < T > *  member ,
decltype( DESCRIBEFLAGS::_value )  additional ,
UInt64   mask = 0 ,
UInt64   value = 0  
) const

◆  DescribeElement() [3/7]

Result <void> DescribeElement ( const Char *  fileName ,
const WeakRef < T > *  member ,
decltype( DESCRIBEFLAGS::_value )  additional ,
UInt64   mask = 0 ,
UInt64   value = 0  
) const

◆  DescribeElement() [4/7]

std::enable_if< GetCollectionKind <T>::value == COLLECTION_KIND::NONE , Result <void> >::type DescribeElement ( const Char *  fileName ,
const T *  member ,
decltype( DESCRIBEFLAGS::_value )  additional ,
UInt64   mask = 0 ,
UInt64   value = 0  
) const

◆  DescribeElement() [5/7]

std::enable_if< GetCollectionKind <T>::value == COLLECTION_KIND::ARRAY , Result <void> >::type DescribeElement ( const Char *  fileName ,
const T *  member ,
decltype( DESCRIBEFLAGS::_value )  additional  
) const

◆  DescribeElement() [6/7]

std::enable_if< GetCollectionKind <T>::value == COLLECTION_KIND::SET , Result <void> >::type DescribeElement ( const Char *  fileName ,
const T *  member ,
decltype( DESCRIBEFLAGS::_value )  additional  
) const

◆  DescribeElement() [7/7]

std::enable_if< GetCollectionKind <T>::value == COLLECTION_KIND::MAP , Result <void> >::type DescribeElement ( const Char *  fileName ,
const T *  member ,
decltype( DESCRIBEFLAGS::_value )  additional  
) const