.\"  Automatically generated man page, do not edit
.TH QB_HDB_ITERATOR_NEXT 3 2023-07-21 "LIBQB" "libqb Programmer's Manual"
.SH NAME
qb_hdb_iterator_next \- Get the next object and increament it's refcount. 

.SH SYNOPSIS
.nf
.B #include <qb/qbhdb.h>
.sp
\fBint32_t qb_hdb_iterator_next\fP(
    \fBstruct qb_hdb   *\fP\fIhdb\fP,\fR       /* the database instance */
    \fBvoid           **\fP\fIinstance\fP,\fR  /* (out) pointer to the desired object. */
    \fBqb_handle_t     *\fP\fIhandle\fP\fR     /* (out) the handle */
);
.fi
.SH PARAMS
\fBhdb      \fP\fIthe database instance \fP
.PP
\fBinstance \fP\fI(out) pointer to the desired object. \fP
.PP
\fBhandle   \fP\fI(out) the handle \fP
.PP
.SH DESCRIPTION
.PP
Remember to call \fIqb_hdb_handle_put()\fR
.SH STRUCTURES
.nf


\fB
struct qb_hdb {
\fR
\fB
    \fBuint32_t    \fP\fIhandle_count\fP;
\fB
    \fBqb_array_t  \fP\fIhandles\fP;
\fB
    \fBuint32_t    \fP\fIiterator\fP;
\fB
    \fBvoid      (*\fP\fIdestructor)(void *)\fP;
\fB
    \fBuint32_t    \fP\fIfirst_run\fP;
};
\fP
.fi
.PP
.RE
.SH RETURN VALUE
.PP
(0 == ok, -errno failure) 
.PP
.SH SEE ALSO
.PP
.nh
.ad l
\fIqb_hdb_handle_get\fR(3), \fIqb_hdb_iterator_reset\fR(3), \fIqb_hdb_handle_create\fR(3), \fIqb_hdb_handle_destroy\fR(3), \fIqb_hdb_handle_refcount_get\fR(3), \fIqb_hdb_nocheck_convert\fR(3), \fIqb_hdb_create\fR(3), \fIqb_hdb_destroy\fR(3), \fIqb_hdb_base_convert\fR(3), \fIqb_hdb_handle_get_always\fR(3), \fIqb_hdb_handle_put\fR(3)
.ad
.hy
.SH "COPYRIGHT"
.PP
Copyright (C) 2010-2020 Red Hat, Inc.