MulleObjCContainerObjectCallback.md

MulleObjCContainerObjectCallback

Callback structure for object-based container operations in mulle-objc.

Structure Definition

struct MulleObjCContainerObjectCallback
{
   void   (*retain)(id);
   void   (*release)(id);
   void   (*describe)(id, struct mulle_buffer *);
};

Functions

Memory Management

• MulleObjCContainerObjectCallbackRetain - Retain object
• MulleObjCContainerObjectCallbackRelease - Release object

Description

• MulleObjCContainerObjectCallbackDescribe - Description callback

Usage Example

struct MulleObjCContainerObjectCallback callbacks = {
    .retain = MulleObjCContainerObjectCallbackRetain,
    .release = MulleObjCContainerObjectCallbackRelease,
    .describe = MulleObjCContainerObjectCallbackDescribe
};

// Use in container initialization
container->objectCallbacks = callbacks;

Important Notes

1. Memory Management

   • Retain/release pairs must balance
   • Handle nil objects properly
   • Clean up resources
   • Consider autorelease pools

2. Thread Safety

   • Callbacks must be thread-safe
   • Consider synchronization
   • Handle concurrent access
   • Check thread ownership

3. Best Practices

   • Initialize all fields
   • Handle errors gracefully
   • Document requirements
   • Test thoroughly
   • Consider TAO implications