7.33.1 Proxy Types Library Specifics

The application would provide the proxy types library object constructors with a list of minimalist type definitions. From the definitions, proper data type definitions are constructed and made available via the library objects.

The objects of the constructed data types can be referred multiple times, though they are not expected to hold references to other objects.

See Referable Objects.

Since the proxy objects are meant to map application data, it is expected (though not required) that only one proxy object refers an application object. The application may find it convenient to store a pointer to the proxy object with the application object itself, and thus allow for the easy update of the proxy object when the application data is chanced (for instance, when the application object is destroyed).

The C type of proxy objects is struct x1f4_dxflat_type. The structure describes a pointer to application data and very little beyond that.

See struct x1f4_dxflat_type.

The proxy objects are application allocated and may extend beyond the struct x1f4_dxflat_type boundary. They still need to be freeable.

The copy method in the struct x1f4_nodetype_type data type definitions made available by the proxy types library objects does not copy data, and is relinking it instead (precisely, it increments data reference count).

See struct x1f4_nodetype_type.