index f2992c79346c989eb7d31d2fad25665174aab57c..819d11e849b48d4e1e2eb65d35247f4abe22af29 100644 (file)
extern "C" {
#endif
extern "C" {
#endif
+struct sdb_type;
+typedef struct sdb_type sdb_type_t;
+
struct sdb_object;
typedef struct sdb_object sdb_object_t;
struct sdb_object;
typedef struct sdb_object sdb_object_t;
-struct sdb_object {
- int ref_cnt;
- void (*destructor)(sdb_object_t *);
+struct sdb_type {
size_t size;
size_t size;
+
+ int (*init)(sdb_object_t *, va_list);
+ void (*destroy)(sdb_object_t *);
+};
+#define SDB_TYPE_INIT { 0, NULL, NULL }
+
+struct sdb_object {
+ sdb_type_t type;
+ int ref_cnt;
+ char *name;
};
};
-#define SDB_OBJECT_INIT { 1, NULL, 0 }
+#define SDB_OBJECT_INIT { SDB_TYPE_INIT, 1, NULL }
+#define SDB_OBJECT_TYPED_INIT(t) { (t), 1, NULL }
typedef struct {
sdb_object_t super;
typedef struct {
sdb_object_t super;
} sdb_object_wrapper_t;
#define SDB_OBJ(obj) ((sdb_object_t *)(obj))
} sdb_object_wrapper_t;
#define SDB_OBJ(obj) ((sdb_object_t *)(obj))
+#define SDB_CONST_OBJ(obj) ((const sdb_object_t *)(obj))
#define SDB_OBJ_WRAPPER(obj) ((sdb_object_wrapper_t *)(obj))
#define SDB_OBJ_WRAPPER(obj) ((sdb_object_wrapper_t *)(obj))
+#define SDB_CONST_OBJ_WRAPPER(obj) ((const sdb_object_wrapper_t *)(obj))
/*
* sdb_object_create:
/*
* sdb_object_create:
- * Allocates a new sdb_object_t of the specified 'size'. The object will be
- * initialized to zero and then passed on to the 'init' function (if
- * specified). If specified, the 'destructor' will be called, when the
+ * Allocates a new sdb_object_t of the specified 'name' and 'type'. The object
+ * will be initialized to zero and then passed on to the 'init' function (if
+ * specified). If specified, the 'destroy' callback will be called, when the
* reference count drops to zero and before freeing the memory allocated by
* the object itself.
*
* reference count drops to zero and before freeing the memory allocated by
* the object itself.
*
- * If the init function fails (returns a non-zero value), the object will be
- * destructed and destroyed.
+ * The init function will be called with the remaining arguments passed to
+ * sdb_object_create. If the init function fails (returns a non-zero value),
+ * the object will be destructed and destroyed. In this case, the 'destroy'
+ * callback may be called on objects that were only half-way initialized. The
+ * callback has to handle that case correctly.
*
* The reference count of the new object will be 1.
*
*
* The reference count of the new object will be 1.
*
* - NULL on error
*/
sdb_object_t *
* - NULL on error
*/
sdb_object_t *
-sdb_object_create(size_t size, int (*init)(sdb_object_t *, va_list),
- void (*destructor)(sdb_object_t *), ...);
+sdb_object_create(const char *name, sdb_type_t type, ...);
+sdb_object_t *
+sdb_object_vcreate(const char *name, sdb_type_t type, va_list ap);
+
+/*
+ * sdb_object_create_simple:
+ * Create a "simple" object without custom initialization and optional
+ * destructor. See the description of sdb_object_create for more details.
+ */
+sdb_object_t *
+sdb_object_create_simple(const char *name, size_t size,
+ void (*destructor)(sdb_object_t *));
+
+/*
+ * sdb_object_create_T:
+ * Create a simple object of type 't'.
+ */
+#define sdb_object_create_T(n,t) \
+ sdb_object_create_simple((n), sizeof(t), NULL)
+
+/*
+ * sdb_object_create_dT:
+ * Create a simple object of dynamic type 't' using destructor 'd'.
+ */
+#define sdb_object_create_dT(n,t,d) \
+ sdb_object_create_simple((n), sizeof(t), d)
/*
* sdb_object_create_wrapper:
* Create a new sdb_object_t wrapping some arbitrary other object.
/*
* sdb_object_create_wrapper:
* Create a new sdb_object_t wrapping some arbitrary other object.
+ *
+ * Creation and initialization of the wrapped object needs to happen outside
+ * of the SysDB object system.
*/
sdb_object_t *
*/
sdb_object_t *
-sdb_object_create_wrapper(void *data, void (*destructor)(void *));
+sdb_object_create_wrapper(const char *name,
+ void *data, void (*destructor)(void *));
#define SDB_OBJECT_WRAPPER_STATIC(obj, destructor) \
{ SDB_OBJECT_INIT, (obj), (destructor) }
#define SDB_OBJECT_WRAPPER_STATIC(obj, destructor) \
{ SDB_OBJECT_INIT, (obj), (destructor) }
void
sdb_object_ref(sdb_object_t *obj);
void
sdb_object_ref(sdb_object_t *obj);
+/*
+ * sdb_object_cmp_by_name:
+ * Compare two objects by their name ignoring the case of the characters.
+ *
+ * Returns:
+ * - a negative value if o1 compares less than o2
+ * - zero if o1 matches o2
+ * - a positive value if o1 compares greater than o2
+ */
+int
+sdb_object_cmp_by_name(const sdb_object_t *o1, const sdb_object_t *o2);
+
#ifdef __cplusplus
} /* extern "C" */
#endif
#ifdef __cplusplus
} /* extern "C" */
#endif