qb_hdb_iterator_next - Man Page

Get the next object and increament it's refcount.

Synopsis

#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

Description

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)

See Also

qb_hdb_handle_get(3), qb_hdb_iterator_reset(3), qb_hdb_handle_create(3), qb_hdb_handle_destroy(3), qb_hdb_handle_refcount_get(3), qb_hdb_nocheck_convert(3), qb_hdb_create(3), qb_hdb_destroy(3), qb_hdb_base_convert(3), qb_hdb_handle_get_always(3), qb_hdb_handle_put(3)

Referenced By

qb_hdb_base_convert(3), qb_hdb_create(3), qb_hdb_destroy(3), qbhdb.h(3), qb_hdb_handle_create(3), qb_hdb_handle_destroy(3), qb_hdb_handle_get(3), qb_hdb_handle_get_always(3), qb_hdb_handle_put(3), qb_hdb_handle_refcount_get(3), qb_hdb_iterator_reset(3), qb_hdb_nocheck_convert(3).

2023-07-21 libqb Programmer's Manual