Unpacker::AddNodeLink
Defined in:
Adds a node link that will be resolved after unpacking is complete.
C4Packing.h
Prototype
void AddNodeLink(int32 index, NodeLink::Linker *linker, void *cookie);
Parameters
index |
The index of the node to be linked. |
linker |
A pointer to the linker function. |
cookie |
A user-defined pointer that is passed to the callback function. |
Description
The AddNodeLink
function registers a linker function that is called after unpacking is complete in order to resolve a node index to the actual pointer to a node. The AddNodeLink
function should be called from within an overridden Packable::Unpack
function or the callback passed to the Packable::UnpackChunkList
function. The index
parameter should be set to the node index, which would typically have just been unpacked.The
NodeLink::Linker
type is defined as follows.
typedef void Linker(Node *, void *);
linker
parameter should be set to a pointer to a static function having this prototype, and the cookie
parameter should be any pointer that the calling function needs. The value of the cookie
parameter is passed to the linker function as its second parameter. The node pointer received in the first parameter of the linker function will be the node whose index was previously specified by the index
parameter when the AddNodeLink
function was called. Note that the node pointer can be nullptr
if the node could not be constructed during the unpacking process.
See Also