mirror of
https://gitee.com/Lyon1998/pikapython.git
synced 2025-01-15 17:02:53 +08:00
374 lines
15 KiB
C
374 lines
15 KiB
C
|
/*****************************************************************************
|
||
|
|
* 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
|