MulleObjCAllocation.md

MulleObjCAllocation

Core functions for object allocation and memory management.

Instance Functions

• MulleObjCInstanceGetAllocator - Gets allocator for instance
• MulleObjCInstanceAllocateMemory - Allocates zeroed memory
• MulleObjCInstanceAllocateNonZeroedMemory - Allocates raw memory
• MulleObjCInstanceReallocateNonZeroedMemory - Resizes memory block
• MulleObjCInstanceDeallocateMemory - Frees allocated memory
• MulleObjCInstanceDuplicateUTF8String - Copies string using instance allocator

Class Functions

• MulleObjCClassGetAllocator - Gets allocator for class
• MulleObjCClassAllocateMemory - Allocates zeroed memory
• MulleObjCClassDeallocateMemory - Frees allocated memory
• MulleObjCClassDuplicateUTF8String - Copies string using class allocator

Thread Functions

• MulleObjCThreadSetAllocator - Sets thread-local allocator
• MulleObjCThreadGetAllocator - Gets thread-local allocator

Usage Example

// Allocate memory for instance
id obj = self;
void *memory = MulleObjCInstanceAllocateMemory(obj, 1024);

// Use memory
// ...

// Free when done
MulleObjCInstanceDeallocateMemory(obj, memory);

Important Notes

1. Memory Management

   • All allocations must be freed with corresponding deallocate function
   • Use instance allocator for instance-specific memory
   • Use class allocator for shared class memory

2. Thread Safety

   • Allocation functions are thread-safe
   • Each thread can have its own allocator
   • Thread allocator affects all allocations in that thread