gnustep/libs-base
0
0
Fork 0
mirror of https://github.com/gnustep/libs-base.git synced 2025-05-30 00:11:26 +00:00
Code Issues Projects Releases Packages Wiki Activity

more work on reserved/private pointer use

Browse source 
git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/base/trunk@32182 72102866-910b-0410-8b05-ffd578937521
This commit is contained in:
Richard Frith-MacDonald 2011-02-16 05:49:45 +00:00
parent 27550994ee
commit d07f49a9b6
41 changed files with 468 additions and 246 deletions
Download patch file Download diff file Expand all files Collapse all files

46
Source/GSInternal.h
View file

@ -27,16 +27,26 @@
* their code when the class implementation is changed in new versions of the
* library.
*
* The public class MUST declare its instance variables using code of the
* form:
* The public class MUST declare its instance variables (after any public
* instance variables which are part of the unchanging public API) using
* code of the form:
* #if GS_NONFRAGILE
* # if defined(GS_X_IVARS)
* @public GS_X_IVARS;
* # endif
* #else
* @private id _internal;
* @private void *_internal GS_UNUSED_IVAR;
* #endif
*
* In the non fragile case, this means that the public header has nothing
* visible, but the ivars defined in GS_X_IVARS are visible within the
* implementation.
*
* In the fragile case, the '_internal' pinter is visible in the public
* header, but as an opaque private instance variable, while macros from
* this file allow the actual memory to be accessed either as a malloc'ed
* structure or as a private class.
*
* Before including the header file containing the public class declaration,
* you must define GS_X_IVARS (where X is the class name) to be the
* list of actual instance variable declarations for the class.
@ -62,8 +72,32 @@
#if !GS_NONFRAGILE
/* Code for when we don't have non-fragile instance variables
* The presence of GS_INTERNAL_STRUCT means that the instance variables are
* accessible as a struct rather than as a class.
*/
#if defined(GS_INTERNAL_STRUCT)
/* Start declaration of internal ivars.
*/
#define GS_PRIVATE_INTERNAL(name) \
typedef struct name ## InternalStruct \
{ \
GS_##name##_IVARS; \
} name ## Internal;
/* Create holder for internal ivars.
*/
#define GS_CREATE_INTERNAL(name) \
_internal = (void*)NSZoneCalloc([self zone], 1, sizeof(name ## Internal));
/* Destroy holder for internal ivars.
*/
#define GS_DESTROY_INTERNAL(name) \
if (_internal != 0) { NSZoneFree([self zone], _internal); _internal = 0; }
#else /* GS_INTERNAL_STRUCT */
/* Start declaration of internal ivars.
*/
#define GS_PRIVATE_INTERNAL(name) \
@ -79,12 +113,14 @@ GS_##name##_IVARS; \
/* Create holder for internal ivars.
*/
#define GS_CREATE_INTERNAL(name) \
_internal = [name ## Internal new];
_internal = (void*)[name ## Internal new];
/* Destroy holder for internal ivars.
*/
#define GS_DESTROY_INTERNAL(name) \
if (_internal != 0) DESTROY(_internal);
if (_internal != 0) {[(id)_internal release]; _internal = 0; }
#endif /* GS_INTERNAL_STRUCT */
#undef internal
#define internal ((GSInternal*)_internal)