QB_HDB_ITERATOR_NEXT(3)

💖 qb_hdb_iterator_next — bestie edition 💖

okay so this is a page from the libqb Programmer's Manual, and it's about grabbing the next object out of your hdb iterator and bumping its refcount. that's it. that's the vibe. ✨

---

🌸 NAME 🌸

qb_hdb_iterator_next — get the next object and increament it's refcount.

yes bestie the manpage really spells it "increament" and yes i'm leaving it exactly as-is. not my typo, not my problem. 💅

---

🦋 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, the main character of this whole operation 👑
• instance — (out) pointer to the desired object. it hands you the goodies. 🍓
• handle — (out) the handle. you get one of these too, lucky you. 🌈

---

💜 DESCRIPTION 💜

Remember to call qb_hdb_handle_put()

fr fr. do NOT forget. that's the whole warning. that's it. that's the description. 😭

---

🧚 STRUCTURES 🧚

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

look at her. iconic. no notes. ✨

---

⭐ RETURN VALUE ⭐

(0 == ok, -errno failure)

so like — 0 is the slay, anything -errno shaped is the not-slay. 💀

---

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

the whole friend group honestly. go read them all. 🫶

---

👑 COPYRIGHT 👑

Copyright (C) 2010-2020 Red Hat, Inc.

---

that's the page bestie, hope it ate 💖 and hey — this was LIBQB, dated 2025-09-16, and the man page name is QB_HDB_ITERATOR_NEXT(3). mwah. 🌸🦋✨