QB_HDB_HANDLE_DESTROY(3)

✨ qb_hdb_handle_destroy ✨

okay bestie, pull up a chair, we're reading a page from the libqb Programmer's Manual and it's honestly a short one but it's so important 💖

---

🌸 NAME 🌸

qb_hdb_handle_destroy — Request the destruction of the object.

like, you're politely asking the object to go away. you're not doing it yourself, you're requesting. main character energy but make it a function call 💅

---

🎀 SYNOPSIS 🎀

#include <qb/qbhdb.h>

int32_t qb_hdb_handle_destroy(
    struct qb_hdb   *hdb,        /* the database instance */
    qb_handle_t      handle_in   /* the handle */
);

---

🦋 PARAMS 🦋

• hdb — the database instance 🗂️
• handle_in — the handle 🏷️

---

💜 DESCRIPTION 💜

okay so here's the whole vibe: when the refcount is 0, it will be destroyed. that's it. that's the tea ☕ the object doesn't dip out while people are still holding onto it — it waits, and once nobody's counting on it anymore, poof, gone 🫶

---

🧚 STRUCTURES 🧚

the way this struct is literally just sitting here, iconic:

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)

so like, 0 means slay 💚, anything -errno means it's giving problem 😭

---

💖 SEE ALSO 💖

the whole friend group, fr fr:

• qb_hdb_handle_get(3)
• qb_hdb_iterator_reset(3)
• qb_hdb_handle_create(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.

---

lowkey reminder: this is a request, not a demand. the destruction only actually happens once the refcount hits 0. respect the count, bestie 🙈

---

and that's a wrap on the qb_hdb_handle_destroy(3) page from the libqb Programmer's Manual, dated 2025-09-16 🎀💖 no cap, you understood all of it, periodt ✨🦋