From dd7595a3475407a7fa96a97393bae8c5220e8762 Mon Sep 17 00:00:00 2001 From: David Walter Seikel Date: Wed, 4 Jan 2012 18:41:13 +1000 Subject: Add the base Enlightenment Foundation Libraries - eina, eet, evas, ecore, embryo, and edje. Note that embryo wont be used, but I'm not sure yet if you can build edje without it. --- libraries/eina/src/include/eina_refcount.h | 76 ++++++++++++++++++++++++++++++ 1 file changed, 76 insertions(+) create mode 100644 libraries/eina/src/include/eina_refcount.h (limited to 'libraries/eina/src/include/eina_refcount.h') diff --git a/libraries/eina/src/include/eina_refcount.h b/libraries/eina/src/include/eina_refcount.h new file mode 100644 index 0000000..6650b01 --- /dev/null +++ b/libraries/eina/src/include/eina_refcount.h @@ -0,0 +1,76 @@ +/* EINA - EFL data type library + * Copyright (C) 20011 Cedric Bail + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Lesser General Public + * License as published by the Free Software Foundation; either + * version 2.1 of the License, or (at your option) any later version. + * + * This library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public + * License along with this library; + * if not, see . + */ + +#ifndef EINA_REFCOUNT_H_ +#define EINA_REFCOUNT_H_ + +/** + * @addtogroup Eina_Refcount References counting + * + * @brief Small macro that simplify references counting. + * + * References counting is not a difficult task, but you must + * handle it correctly every where, and that the issue. This + * set of macro do provide helper that will force to use the + * correct code in most case and reduce the bug likeliness. + * Of course this without affecting speed ! + */ + +/** + * @addtogroup Eina_Data_Types_Group Data Types + * + * @{ + */ + +/** + * @defgroup Eina_Refcount References counting + * + * @{ + */ + +/** + * @typedef Eina_Refcount + * Inlined references counting type. + */ +typedef int Eina_Refcount; + +/** Used for declaring a reference counting member in a struct */ +#define EINA_REFCOUNT Eina_Refcount __refcount + +/** Used just after allocating a object */ +#define EINA_REFCOUNT_INIT(Variable) (Variable)->__refcount = 1 + +/** Used when using referring to an object one more time */ +#define EINA_REFCOUNT_REF(Variable) (Variable)->__refcount++ + +/** Used when removing a reference to an object. The code just after will automatically be called when necessary */ +#define EINA_REFCOUNT_UNREF(Variable) \ + if (--((Variable)->__refcount) == 0) + +/** Get refcounting value */ +#define EINA_REFCOUNT_GET(Variable) (Variable)->__refcount + +/** + * @} + */ + +/** + * @} + */ + +#endif /* EINA_REFCOUNT_H_ */ -- cgit v1.1