MulleObjCContainerCallback.md

MulleObjCContainerCallback

Callback structure for container operations in mulle-objc.

Structure Definition

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

Functions

Memory Management

• MulleObjCContainerCallbackRetain - Retain callback
• MulleObjCContainerCallbackRelease - Release callback

Description

• MulleObjCContainerCallbackDescribe - Description callback

Usage Example

struct MulleObjCContainerCallback callbacks = {
    .retain = MulleObjCContainerCallbackRetain,
    .release = MulleObjCContainerCallbackRelease,
    .describe = MulleObjCContainerCallbackDescribe
};

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

Important Notes

1. Memory Management

   • Retain/release pairs must balance
   • Handle nil values properly
   • Clean up resources

2. Thread Safety

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

3. Best Practices

   • Initialize all fields
   • Handle errors gracefully
   • Document requirements
   • Test thoroughly