QB_HDB_ITERATOR_RESET(3)

💖 QB_HDB_ITERATOR_RESET — the reset button for your iterator, bestie 💖

okay so this page lives in the libqb Programmer's Manual (section 3, we love a library call) and it's all about one tiny little function that does one tiny little thing. let's get into it 🫶

---

✨ NAME ✨

qb_hdb_iterator_reset — Reset the iterator.

like. that's it. that's the whole job. she resets the iterator. iconic behaviour, no notes 💅

---

✨ SYNOPSIS ✨

#include <qb/qbhdb.h>

void qb_hdb_iterator_reset(
    struct qb_hdb   *hdb   /* the database instance */
);

so you pull in qb/qbhdb.h, you hand her a pointer to your struct qb_hdb, and she returns void — meaning she gives you nothing back, she just does the thing. no return value, no drama, just vibes ✨

---

✨ PARAMS ✨

• hdb — the database instance 🗂️ that's the one and only thing she wants from you. give her your qb_hdb and she'll handle the rest, periodt.

---

✨ DESCRIPTION ✨

so bestie... the description section on this page is literally empty. like, blank. nothing. the source manpage just goes straight from DESCRIPTION to STRUCTURES with absolutely nothing in between 😭

not me reading it three times looking for the paragraph. it's not there. it's giving mysterious. it's giving let the struct speak for itself 💀

so like, no extra lore here — everything she's gonna tell you lives in the synopsis, the params and the struct below. iykyk 🦋

---

✨ STRUCTURES ✨

here's the struct she's working with, copied exactly so you can see the whole girliepop:

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

look at iterator sitting right there in the middle, third from the top. that's the one she's resetting. main character energy fr fr 👑

---

🌈 SEE ALSO 🌈

go read her sisters, they're all part of the same friend group 💜

• qb_hdb_handle_get(3)
• qb_hdb_handle_create(3)
• qb_hdb_handle_destroy(3)
• qb_hdb_handle_refcount_get(3)
• qb_hdb_iterator_next(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)

---

✨ COPYRIGHT ✨

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

that's the legal bit, we respect it, we don't touch it 🎀

---

and that's the whole page bestie!! stay hydrated, reset your iterators, and remember: this dropped as part of libqb, dated 2025-09-16, filed under QB_HDB_ITERATOR_RESET(3) 💖✨🦋 slay, bye!!