-
Notifications
You must be signed in to change notification settings - Fork 74
/
plooc_class.h
373 lines (303 loc) · 14.7 KB
/
plooc_class.h
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
/*****************************************************************************
* Copyright(C)2009-2019 by GorgonMeducer<embedded_zhuoran@hotmail.com> *
* and SimonQian<simonqian@simonqian.com> *
* with support from HenryLong<henry_long@163.com> *
* *
* Licensed under the Apache License, Version 2.0 (the "License"); *
* you may not use this file except in compliance with the License. *
* You may obtain a copy of the License at *
* *
* http://www.apache.org/licenses/LICENSE-2.0 *
* *
* Unless required by applicable law or agreed to in writing, software *
* distributed under the License is distributed on an "AS IS" BASIS, *
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. *
* See the License for the specific language governing permissions and *
* limitations under the License. *
* *
****************************************************************************/
#if defined(__cplusplus) || defined(__OOC_CPP__)
# undef __PLOOC_CLASS_USE_STRICT_TEMPLATE__
# undef PLOOC_CFG_REMOVE_MEMORY_LAYOUT_BOUNDARY___USE_WITH_CAUTION___
# define PLOOC_CFG_REMOVE_MEMORY_LAYOUT_BOUNDARY___USE_WITH_CAUTION___
# ifdef __cplusplus
extern "C" {
# endif
#endif
#if defined(__OOC_RELEASE__) || defined(__OOC_CPP__)
# undef __OOC_DEBUG__
# define __OOC_DEBUG__ 1
#endif
#if !defined(__PLOOC_CLASS_USE_STRICT_TEMPLATE__) \
&& !defined(__PLOOC_CLASS_USE_SIMPLE_TEMPLATE__) \
&& !defined(__PLOOC_CLASS_USE_BLACK_BOX_TEMPLATE__)
# define __PLOOC_CLASS_USE_SIMPLE_TEMPLATE__ 1
#endif
#if (!defined(__STDC_VERSION__) || __STDC_VERSION__ < 199901L) && !defined(__cplusplus)
#ifndef __OOC_DEBUG__
# define __OOC_DEBUG__
# warning For C89/90, __OOC_DEBUG__ is enforced.
#endif
#if defined(__PLOOC_CLASS_USE_STRICT_TEMPLATE__)
# undef __PLOOC_CLASS_USE_STRICT_TEMPLATE__
# define __PLOOC_CLASS_USE_SIMPLE_TEMPLATE__
#endif
#if defined(__PLOOC_CLASS_USE_BLACK_BOX_TEMPLATE__)
# undef __PLOOC_CLASS_USE_BLACK_BOX_TEMPLATE__
# define __PLOOC_CLASS_USE_SIMPLE_TEMPLATE__
#endif
# if !defined(__OOC_DEBUG__) || !defined(__PLOOC_CLASS_USE_SIMPLE_TEMPLATE__)
# error \
You must use __OOC_DEBUG__ (or __OOC_RELEASE__) together with the\
__PLOOC_CLASS_USE_SIMPLE_TEMPLATE__ in ANSI-C89/90.
# endif
#endif
#ifdef __cplusplus
}
#endif
#ifndef __PLOOC_CLASS_H__
#define __PLOOC_CLASS_H__
/******************************************************************************
* HOW TO USE *
******************************************************************************/
//! TODO: Add How to use
/*============================ INCLUDES ======================================*/
//#include <stdint.h>
/*! \NOTE the uint_fast8_t used in this header file is defined in stdint.h
if you don't have stdint.h supported in your toolchain, you should
define uint_fast8_t all by yourself with following rule:
a. if the target processor is 8 bits, define it as uint8_t
b. if the target processor is 16 bits, define it as uint16_t
c. if the target processor is 32 bits, define it as uint32_t
d. if the target processor is 64 bits, define it as either uint32_t or
uint64_t
*/
#include "./plooc.h"
#include <stdlib.h>
#ifdef __cplusplus
extern "C" {
#endif
/*============================ MACROS ========================================*/
/*!\ node if you want your code more "elegent", say you want to use "this" with
* "." rather than a pointer with "->", you can add following macros to
* your code, assuming the variable name of the object pointer is "ptThis".
* If your object pointer has a different name, please feel free to change
* the macro by yourself
#undef this
#define this (*ptThis)
*/
/*============================ MACROFIED FUNCTIONS ===========================*/
//! @{
#ifndef __PLOOC_CONNECT2
# define __PLOOC_CONNECT2( __A, __B) __A##__B
#endif
#ifndef __PLOOC_CONNECT3
# define __PLOOC_CONNECT3( __A, __B, __C) __A##__B##__C
#endif
#ifndef __PLOOC_CONNECT4
# define __PLOOC_CONNECT4( __A, __B, __C, __D) __A##__B##__C##__D
#endif
//! @}
#ifndef __PLOOC_ALIGN
# define __PLOOC_ALIGN(__N) __attribute__((aligned(__N)))
#endif
#ifndef PLOOC_ALIGN
# define PLOOC_ALIGN(__N) __PLOOC_ALIGN(__N)
#endif
/*
#ifndef PLOOC_DEFAULT_OBJ_ALIGN
# define PLOOC_DEFAULT_OBJ_ALIGN sizeof(uint_fast8_t)
#endif
*/
#ifndef PLOOC_PACKED
# define PLOOC_PACKED __attribute__((packed))
#endif
//! @{
#ifndef PLOOC_CONNECT2
# define PLOOC_CONNECT2( __A, __B) __PLOOC_CONNECT2( __A, __B)
#endif
#ifndef PLOOC_CONNECT3
# define PLOOC_CONNECT3( __A, __B, __C) __PLOOC_CONNECT3( __A, __B, __C)
#endif
#ifndef PLOOC_CONNECT4
# define PLOOC_CONNECT4( __A, __B, __C, __D) __PLOOC_CONNECT4( __A, __B, __C, __D)
#endif
//! @}
#ifndef PLOOC_UNUSED_PARAM
# define PLOOC_UNUSED_PARAM(__N) do {(__N) = (__N);}while(0)
#endif
#if (!defined(__STDC_VERSION__) || __STDC_VERSION__ < 199901L) && !defined(__cplusplus)
# ifndef PLOOC_ALIGNOF
# define PLOOC_ALIGNOF(__TYPE) __alignof__(__TYPE)
# endif
# define PLOOC_ALIGNOF_STRUCT(__TYPE) PLOOC_ALIGNOF(struct {__TYPE})
# define PLOOC_SIZEOF_STRUCT(__TYPE) sizeof(struct {__TYPE})
#else
# ifndef PLOOC_ALIGNOF
# define PLOOC_ALIGNOF(...) __alignof__(__VA_ARGS__)
# endif
# define PLOOC_ALIGNOF_STRUCT(...) PLOOC_ALIGNOF(struct {__VA_ARGS__})
# define PLOOC_SIZEOF_STRUCT(...) sizeof(struct {__VA_ARGS__})
/*! \note When both __OOC_DEBUG__ and
*! PLOOC_CFG_REMOVE_MEMORY_LAYOUT_BOUNDARY___USE_WITH_CAUTION___ are
*! defined, memory layout boundary, i.e. struct wrapper inside PLOOC
*! VISIBLE will be removed. This enables some platform to use the gaps
*! between members with different memory aligments to add members with
*! correct size and aligment for saving space.
*!
*! You can do this when you have all the source code and compile all
*! the source code with the same presence of "__OOC_DEBUG__".
*! If some of the code is compiled with different presence of
*! "__OOC_DEBUG__", i.e. using Lib + source, removing the memory
*! layout boundaries will cause different view of the structure and hence
*! cause undefined behaviours.
*/
# if defined(PLOOC_CFG_REMOVE_MEMORY_LAYOUT_BOUNDARY___USE_WITH_CAUTION___)
# define PLOOC_VISIBLE(...) __VA_ARGS__
# else
# define PLOOC_VISIBLE(...) \
struct { \
__VA_ARGS__ \
}PLOOC_ALIGN(PLOOC_ALIGNOF_STRUCT(__VA_ARGS__));
# endif
# if !defined (__PLOOC_CLASS_USE_NO_STRUCT_MASK__)
# define PLOOC_INVISIBLE(...) \
uint8_t PLOOC_CONNECT3(chMask_,__LINE__,__COUNTER__) \
[PLOOC_SIZEOF_STRUCT(__VA_ARGS__)] \
PLOOC_ALIGN(PLOOC_ALIGNOF_STRUCT(__VA_ARGS__));
# else
# define PLOOC_INVISIBLE(...) \
struct { \
__VA_ARGS__ \
} PLOOC_CONNECT3(zzz_, __LINE__,__COUNTER__) \
PLOOC_ALIGN(PLOOC_ALIGNOF_STRUCT(__VA_ARGS__));
# endif /* __PLOOC_CLASS_USE_NO_STRUCT_MASK__ */
# define __PLOOC_PRO_struct struct
# define __PLOOC_PRI_struct struct
# define __PLOOC_EXT_struct struct
# define __PLOOC_PRO_union union
# define __PLOOC_PRI_union union
# define __PLOOC_EXT_union union
# define __PLOOC_EXT_uint8_t uint8_t
# define __PLOOC_PRI_uint8_t uint8_t
# define __PLOOC_PRO_uint8_t uint8_t
# define __PLOOC_EXT_
# define __PLOOC_PRI_
# define __PLOOC_PRO_
# ifdef __OOC_DEBUG__
//! \brief wrapper for shell type
# define __PLOOC_EXT__public_member(...) PLOOC_VISIBLE(__VA_ARGS__)
# define __PLOOC_EXT__private_member(...) PLOOC_VISIBLE(__VA_ARGS__)
# define __PLOOC_EXT__protected_member(...) PLOOC_VISIBLE(__VA_ARGS__)
# define __PLOOC_EXT__which(...) PLOOC_VISIBLE(__VA_ARGS__)
//! \brief wrapper for internal private type
# define __PLOOC_PRI__public_member(...) PLOOC_VISIBLE(__VA_ARGS__)
# define __PLOOC_PRI__private_member(...) PLOOC_VISIBLE(__VA_ARGS__)
# define __PLOOC_PRI__protected_member(...) PLOOC_VISIBLE(__VA_ARGS__)
# define __PLOOC_PRI__which(...) PLOOC_VISIBLE(__VA_ARGS__)
//! \brief wrapper for internal protected type
# define __PLOOC_PRO__public_member(...) PLOOC_VISIBLE(__VA_ARGS__)
# define __PLOOC_PRO__private_member(...) PLOOC_VISIBLE(__VA_ARGS__)
# define __PLOOC_PRO__protected_member(...) PLOOC_VISIBLE(__VA_ARGS__)
# define __PLOOC_PRO__which(...) PLOOC_VISIBLE(__VA_ARGS__)
# else
//! \brief wrapper for shell type
# define __PLOOC_EXT__public_member(...) PLOOC_VISIBLE(__VA_ARGS__)
# define __PLOOC_EXT__private_member(...) PLOOC_INVISIBLE(__VA_ARGS__)
# define __PLOOC_EXT__protected_member(...) PLOOC_INVISIBLE(__VA_ARGS__)
# define __PLOOC_EXT__which(...) PLOOC_VISIBLE(__VA_ARGS__)
//! \brief wrapper for internal private type
# define __PLOOC_PRI__public_member(...) PLOOC_VISIBLE(__VA_ARGS__)
# define __PLOOC_PRI__private_member(...) PLOOC_VISIBLE(__VA_ARGS__)
# define __PLOOC_PRI__protected_member(...) PLOOC_VISIBLE(__VA_ARGS__)
# define __PLOOC_PRI__which(...) PLOOC_VISIBLE(__VA_ARGS__)
//! \brief wrapper for internal protected type
# define __PLOOC_PRO__public_member(...) PLOOC_VISIBLE(__VA_ARGS__)
# define __PLOOC_PRO__private_member(...) PLOOC_INVISIBLE(__VA_ARGS__)
# define __PLOOC_PRO__protected_member(...) PLOOC_VISIBLE(__VA_ARGS__)
# define __PLOOC_PRO__which(...) PLOOC_VISIBLE(__VA_ARGS__)
# endif
#endif
#if defined(__cplusplus)
}
#endif
#endif
# if (!defined(__STDC_VERSION__) || __STDC_VERSION__ < 199901L) && !defined(__cplusplus)
# undef which
# define which(__declare) ,_which(__declare)
#else
# undef which
# define which(...) ,_which(__VA_ARGS__)
#endif
#undef private_member
#define private_member ,_private_member
#undef protected_member
#define protected_member ,_protected_member
#undef public_member
#define public_member ,_public_member
/*! \brief helper macros for heap managed objects. They use malloc() and free()
*! internally.
*!
*! \note Make sure your constractor is named as <class_name>_init and it takes
*! an configuration structure with a type named as <class_name>_cfg_t.
*!
*! \note Make sure your destructor is named as <class_name>_depose.
*/
#define __new_class(__name, ...) \
({__name##_cfg_t tCFG = { \
__VA_ARGS__ \
}; \
__name##_init( \
(__name##_t *)malloc(sizeof(__name##_t)), \
&tCFG);})
#define __free_class(__name, __obj) \
do { \
__name##_depose((__name##_t *)(__obj)); \
free(__obj); \
} while(0)
/*============================ TYPES =========================================*/
/*============================ GLOBAL VARIABLES ==============================*/
/*============================ PROTOTYPES ====================================*/
/*============================ INCLUDES ======================================*/
#if defined(__PLOOC_CLASS_USE_STRICT_TEMPLATE__)
# include "./plooc_class_strict.h"
#elif defined(__PLOOC_CLASS_USE_SIMPLE_TEMPLATE__)
# if (!defined(__STDC_VERSION__) || __STDC_VERSION__ < 199901L) && !defined(__cplusplus)
# include "./plooc_class_simple_c90.h"
# else
# include "./plooc_class_simple.h"
# endif
#elif defined(__PLOOC_CLASS_USE_BLACK_BOX_TEMPLATE__)
# ifndef __PLOOC_I_KNOW_BLACK_BOX_IS_INCOMPATIBLE_WITH_OTHER_TEMPLATES__
# warning The black box template is incompatible with other templates. When\
header files which contains different templates mixing together, the one contains\
black box template will cause conflicts in other header files. To avoid such\
conflicts, you can either use black box alone in a project or in the source code of\
the target module avoid including header files which directly or indirectly \
including the header file of the very same module. To suppress this warning, please\
find the macro __PLOOC_I_KNOW_BLACK_BOX_IS_INCOMPATIBLE_WITH_OTHER_TEMPLATES__ in your\
project to acknowledge that you understand the facts and consequences.
# endif
# include "./plooc_class_black_box.h"
#else
# include "./plooc_class_simple.h"
#endif
#ifdef __cplusplus
extern "C" {
#endif
#undef __PLOOC_CLASS_USE_STRICT_TEMPLATE__
#undef __PLOOC_CLASS_USE_SIMPLE_TEMPLATE__
#undef __PLOOC_CLASS_USE_BLACK_BOX_TEMPLATE__
#undef __PLOOC_CLASS_IMPLEMENT
#undef __PLOOC_CLASS_IMPLEMENT__
#undef __PLOOC_CLASS_INHERIT__
#undef __PLOOC_CLASS_INHERIT
#if defined(__cplusplus)
# undef class
# undef this
# undef private
# undef public
#endif
#if defined(__cplusplus)
}
#endif