Go to the source code of this file.
|
|
#define | GWEN_INHERIT_ELEMENT(t) GWEN_INHERITDATA_LIST *INHERIT__list; |
|
#define | GWEN_INHERIT_FUNCTION_DEFS(t) GWEN_INHERIT_FUNCTION_LIB_DEFS(t, GWEN_DUMMY_EMPTY_ARG) |
|
#define | GWEN_INHERIT_FUNCTION_LIB_DEFS(t, decl) |
|
|
#define | GWEN_INHERIT_FINI(t, element) |
|
#define | GWEN_INHERIT_FUNCTIONS(t) |
|
#define | GWEN_INHERIT_INIT(t, element) |
|
|
#define | GWEN_INHERIT(bt, t) uint32_t t##__INHERIT_ID=0; |
|
#define | GWEN_INHERIT_GETDATA(bt, t, element) ((t*)GWEN_Inherit_FindData(bt##__INHERIT_GETLIST(element),t##__INHERIT_ID,0)) |
|
#define | GWEN_INHERIT_ISOFTYPE(bt, t, element) |
|
#define | GWEN_INHERIT_REF(bt, t) extern uint32_t t##__INHERIT_ID; |
|
#define | GWEN_INHERIT_SETDATA(bt, t, element, data, fn) |
|
#define | GWEN_INHERIT_UNLINK(bt, t, element) |
|
◆ GWEN_INHERIT
#define GWEN_INHERIT |
( |
|
bt, |
|
|
|
t |
|
) |
| uint32_t t##__INHERIT_ID=0; |
Use this in the C file of inheriting classes. It initializes a global variable with a hash of the inheriting type name. This is used to speed up inheritance functions. This variable will be filled with a value upon the first invocation of the macro GWEN_INHERIT_SETDATA.
Definition at line 264 of file inherit.h.
◆ GWEN_INHERIT_ELEMENT
Use this macro inside the struct which you want to make inheritable. This macro defines some new elements for the struct for administration of inheritance.
Definition at line 112 of file inherit.h.
◆ GWEN_INHERIT_FINI
#define GWEN_INHERIT_FINI |
( |
|
t, |
|
|
|
element |
|
) |
| |
Value: {\
GWEN_INHERITDATA *inherit__data;\
\
assert(element);\
assert(element->INHERIT__list);\
\
GWEN_InheritData_freeData(inherit__data); \
GWEN_InheritData_List_Del(inherit__data); \
GWEN_InheritData_free(inherit__data); \
} \
GWEN_InheritData_List_free(element->INHERIT__list);\
}
GWEN_INHERITDATA * GWEN_InheritData_List_First(const GWEN_INHERITDATA_LIST *l)
Use this macro in your C file in destructor functions for the base class. This macro deinitializes the elements defined by the macro GWEN_INHERIT_ELEMENT. This should be the first instruction in that function, because it also gives inheriting classes the opportunity to free their own data associated with the given element. It causes the least problems if inheriting classes free their data before the base class does.
Definition at line 238 of file inherit.h.
◆ GWEN_INHERIT_FUNCTION_DEFS
Use this macro in the header file of the base class. This defines the prototypes of some inheritance functions. This macro should be used in applications, not in libraries. In libraries please use the macro GWEN_INHERIT_FUNCTION_LIB_DEFS.
You should not care about these functions here, since you should not use them directly. Please use GWEN_INHERIT_GETDATA and GWEN_INHERIT_SETDATA instead.
Definition at line 147 of file inherit.h.
◆ GWEN_INHERIT_FUNCTION_LIB_DEFS
#define GWEN_INHERIT_FUNCTION_LIB_DEFS |
( |
|
t, |
|
|
|
decl |
|
) |
| |
Value: decl void t##__INHERIT_SETDATA(t *element, \
const char *typeName,\
uint32_t id,\
void *data,\
decl int t##__INHERIT_ISOFTYPE(const t *element, uint32_t id);\
decl void t##__INHERIT_UNLINK(t *element, \
const char *typeName,\
uint32_t id);
void GWENHYWFAR_CB(* GWEN_INHERIT_FREEDATAFN)(void *baseData, void *data)
Use this macro in the header file of the base class. This defines the prototypes of some inheritance functions. This macro should be used in libraries with the __declspec(dllexport) as the decl
argument.
You should not care about these functions here, since you should not use them directly. Please use GWEN_INHERIT_GETDATA and GWEN_INHERIT_SETDATA instead.
Definition at line 125 of file inherit.h.
◆ GWEN_INHERIT_FUNCTIONS
#define GWEN_INHERIT_FUNCTIONS |
( |
|
t | ) |
|
Use this macro in the C file of the base class. It defines the implementations of the inheritance functions. This macro MUST be placed after the include statement which includes the classes header file.
Definition at line 163 of file inherit.h.
◆ GWEN_INHERIT_GETDATA
#define GWEN_INHERIT_GETDATA |
( |
|
bt, |
|
|
|
t, |
|
|
|
element |
|
) |
| ((t*)GWEN_Inherit_FindData(bt##__INHERIT_GETLIST(element),t##__INHERIT_ID,0)) |
This macros returns the private data of an inheriting class associated with an element of its base class.
Definition at line 279 of file inherit.h.
◆ GWEN_INHERIT_INIT
#define GWEN_INHERIT_INIT |
( |
|
t, |
|
|
|
element |
|
) |
| |
Value: {\
assert(element);\
}
GWEN_INHERITDATA_LIST * GWEN_InheritData_List_new()
Use this macro in your C file in constructor functions for the base class. This macro initializes the elements defined by the macro GWEN_INHERIT_ELEMENT.
Definition at line 223 of file inherit.h.
◆ GWEN_INHERIT_ISOFTYPE
#define GWEN_INHERIT_ISOFTYPE |
( |
|
bt, |
|
|
|
t, |
|
|
|
element |
|
) |
| |
Value: ((bt##__INHERIT_ISOFTYPE(element,\
((t##__INHERIT_ID==0)?\
t##__INHERIT_ID)))?1:0)
GWENHYWFAR_API uint32_t GWEN_Inherit_MakeId(const char *typeName)
This macro checks whether the given element is of the given type.
- Returns
- !=0 if the pointer is of the expected type, 0 otherwise
- Parameters
-
bt | base type |
t | derived type |
element | pointer which is to be checked |
Definition at line 313 of file inherit.h.
◆ GWEN_INHERIT_REF
#define GWEN_INHERIT_REF |
( |
|
bt, |
|
|
|
t |
|
) |
| extern uint32_t t##__INHERIT_ID; |
This is an extern reference when you need to call GWEN_INHERIT_GETDATA from one source file while the GWEN_INHERIT stance is in another one.
Definition at line 271 of file inherit.h.
◆ GWEN_INHERIT_SETDATA
#define GWEN_INHERIT_SETDATA |
( |
|
bt, |
|
|
|
t, |
|
|
|
element, |
|
|
|
data, |
|
|
|
fn |
|
) |
| |
Value: {\
if (!t##__INHERIT_ID)\
bt##__INHERIT_SETDATA(element,
__STRING(t), t##__INHERIT_ID, data, fn);\
}
This macro sets the private data of an inheriting class associated with an element of its base class. The last argument is a pointer to a function which frees the associated data. That function will be called when the element of the base class given is freed or new data is to be associated with the element. The prototype of that function is this:
typedef void (*function)(void *baseData, void *data);
Please note that the argument to that function is a pointer to the base type element. If you want to get the private data associated with the base type element (and you probably do) you must call GWEN_INHERIT_GETDATA. Every time the macro GWEN_INHERIT_SETDATA is used the previously associated data will be freed by calling the function whose prototype you've just learned.
Definition at line 300 of file inherit.h.
◆ GWEN_INHERIT_UNLINK
#define GWEN_INHERIT_UNLINK |
( |
|
bt, |
|
|
|
t, |
|
|
|
element |
|
) |
| |
Value: {\
if (!t##__INHERIT_ID)\
bt##__INHERIT_UNLINK(element,
__STRING(t), t##__INHERIT_ID);\
}
This macro gives up the inheritance for the given type. After this macro has been executed there is no link left between the type and its base type.
- Parameters
-
bt | base type |
t | derived type |
Definition at line 326 of file inherit.h.
◆ GWEN_INHERIT_FREEDATAFN
typedef void GWENHYWFAR_CB(* GWEN_INHERIT_FREEDATAFN) (void *baseData, void *data) |
◆ GWEN_INHERITDATA
◆ GWEN_Inherit_FindData()
◆ GWEN_Inherit_FindEntry()
◆ GWEN_Inherit_MakeId()
◆ GWEN_InheritData_clear()
◆ GWEN_InheritData_free()
◆ GWEN_InheritData_freeAllData()
◆ GWEN_InheritData_freeData()
◆ GWEN_InheritData_GetData()
◆ GWEN_InheritData_GetFreeDataFn()
◆ GWEN_InheritData_GetId()
◆ GWEN_InheritData_GetTypeName()
◆ GWEN_InheritData_new()