Block.h (1541B) - Raw
1 /* 2 * Block.h 3 * 4 * Copyright (c) 2008-2010 Apple Inc. All rights reserved. 5 * 6 * @APPLE_LLVM_LICENSE_HEADER@ 7 * 8 */ 9 10 #ifndef _Block_H_ 11 #define _Block_H_ 12 13 #if !defined(BLOCK_EXPORT) 14 # if defined(__cplusplus) 15 # define BLOCK_EXPORT extern "C" 16 # else 17 # define BLOCK_EXPORT extern 18 # endif 19 #endif 20 21 #include <TargetConditionals.h> 22 #include <sys/cdefs.h> 23 24 #if __cplusplus 25 extern "C" { 26 #endif 27 28 // Create a heap based copy of a Block or simply add a reference to an existing one. 29 // This must be paired with Block_release to recover memory, even when running 30 // under Objective-C Garbage Collection. 31 BLOCK_EXPORT void *__single _Block_copy(const void *__single aBlock); 32 33 // Lose the reference, and if heap based and last reference, recover the memory 34 BLOCK_EXPORT void _Block_release(const void *__single aBlock); 35 36 // Used by the compiler. Do not call this function yourself. 37 BLOCK_EXPORT void _Block_object_assign(void *, const void *, const int); 38 39 // Used by the compiler. Do not call this function yourself. 40 BLOCK_EXPORT void _Block_object_dispose(const void *, const int); 41 42 // Used by the compiler. Do not use these variables yourself. 43 BLOCK_EXPORT void * _NSConcreteGlobalBlock[32]; 44 BLOCK_EXPORT void * _NSConcreteStackBlock[32]; 45 46 #if __cplusplus 47 } 48 #endif 49 50 // Type correct macros 51 52 #define Block_copy(...) ((__typeof(__VA_ARGS__))_Block_copy(__unsafe_forge_single(const void *, (const void *)(__VA_ARGS__)))) 53 #define Block_release(...) _Block_release(__unsafe_forge_single(const void *, (const void *)(__VA_ARGS__))) 54 55 56 #endif