References counting

Macros | Typedefs
References counting
Eina » Data Types

Small macro that simplify references counting. More...

## Macros
#define | EINA_REFCOUNT Eina_Refcount __refcount
| Used for declaring a reference counting member in a struct.
#define | EINA_REFCOUNT_INIT(Variable) (Variable)->__refcount = 1
| Used just after allocating a object.
#define | EINA_REFCOUNT_REF(Variable) (Variable)->__refcount++
| Used when using referring to an object one more time.
#define | EINA_REFCOUNT_UNREF(Variable) if (--((Variable)->__refcount) == 0)
| Used when removing a reference to an object. More...
#define | EINA_REFCOUNT_GET(Variable) (Variable)->__refcount
| Get refcounting value.

## Typedefs
typedef int | Eina_Refcount
| Inlined references counting type.

## Detailed Description

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 !

## Macro Definition Documentation

## ◆ EINA_REFCOUNT_UNREF

#define EINA_REFCOUNT_UNREF | ( |  | Variable | ) | if (--((Variable)->__refcount) == 0)

Used when removing a reference to an object.

The code just after will automatically be called when necessary