qb_hdb_iterator_next(3)

Get the next object and increament it's refcount.

Section 3 libqb-dev bookworm source

Description

QB_HDB_ITERATOR_NEXT

NAME

qb_hdb_iterator_next - 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)