qb_hdb_iterator_next(3)

Usage

#include <qb/qbhdb.h>

int32_t qb_hdb_iterator_next(
    struct qb_hdb   *hdb,       /* the database instance */
    void           **instance,  /* (out) pointer to the desired object. */
    qb_handle_t     *handle     /* (out) the handle */
);

Params

hdb the database instance

instance (out) pointer to the desired object.

handle (out) the handle

Overview

Remember to call qb_hdb_handle_put()

Structures

struct qb_hdb {
    uint32_t    handle_count;
    qb_array_t  handles;
    uint32_t    iterator;
    void      (*destructor)(void *);
    uint32_t    first_run;
};

Return value

(0 == ok, -errno failure)

Releases

4 releases since Debian 11 (Bullseye); the text changed 3 times.

qb_hdb_handle_get(3) Get the instance associated with this handle and increase it's refcount. qb_hdb_iterator_reset(3) Reset the iterator. qb_hdb_handle_create(3) Create a new handle. qb_hdb_handle_destroy(3) Request the destruction of the object. qb_hdb_handle_refcount_get(3) Get the current refcount. qb_hdb_nocheck_convert(3) qb_hdb_create(3) Create a new database. qb_hdb_destroy(3) Destroy a handle database. qb_hdb_base_convert(3) qb_hdb_handle_get_always(3) Get the instance associated with this handle and increase it's refcount. qb_hdb_handle_put(3) Put the instance associated with this handle and decrease it's refcount.

Referred to by

qbhdb.h(3) The handle database is for reference counting objects. qb_hdb_create(3) Create a new database. qb_hdb_destroy(3) Destroy a handle database. qb_hdb_handle_get(3) Get the instance associated with this handle and increase it's refcount. qb_hdb_handle_put(3) Put the instance associated with this handle and decrease it's refcount. qb_hdb_base_convert(3) qb_hdb_handle_create(3) Create a new handle. qb_hdb_handle_destroy(3) Request the destruction of the object. qb_hdb_iterator_reset(3) Reset the iterator. qb_hdb_nocheck_convert(3) qb_hdb_handle_get_always(3) Get the instance associated with this handle and increase it's refcount. qb_hdb_handle_refcount_get(3) Get the current refcount.