QB_HDB_HANDLE_PUT(3)

💖 QB_HDB_HANDLE_PUT(3) 💖

okay bestie, so this is a page straight out of the libqb Programmer's Manual, and it's all about qb_hdb_handle_put — yes, the one from section 3, the library-call section. sit down, hydrate, let's get into it 🫶

---

✨ NAME ✨

qb_hdb_handle_put — put the instance associated with this handle and decrease it's refcount.

like literally that's the whole job. you hand back the thing you borrowed, and the refcount goes down by one. no cap. 💅

---

🌸 SYNOPSIS 🌸

#include <qb/qbhdb.h>

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

it's giving "two arguments, one return value, zero drama" ✨

---

🎀 PARAMS 🎀

• hdb — the database instance. your hdb. the whole vibe container.
• handle_in — the handle. the lil ticket you're handing back.

---

💜 DESCRIPTION 💜

okay so. the description section on this page is genuinely just… the struct. that's it. that's the description. minimalism is a lifestyle i guess 😭

---

🦋 STRUCTURES 🦋

here's the shape of the thing, verbatim, do not touch:

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

five fields. handle_count, handles, iterator, destructor, first_run. memorise them, love them, respect them 💖

---

👑 RETURN VALUE 👑

• 0 == ok ✅
• -errno == failure 😭

that's it, that's the whole emotional spectrum.

---

🌈 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_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)

go read them all, i'll wait 🍓

---

💅 COPYRIGHT 💅

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

---

and that's the whole page, bestie!! this icon was brought to you by the LIBQB girlies, dated 2025-09-16, and it goes by QB_HDB_HANDLE_PUT(3) in the group chat. now go put that handle back, your refcount is waiting 🎀✨💜