QB_HDB_HAN...FCOUNT_GET(3)

💖 qb_hdb_handle_refcount_get — libqb Programmer's Manual ✨

okay so bestie, welcome to the libqb programmer's manual, and today's main character is qb_hdb_handle_refcount_get — she gets the current refcount. that's it. that's her whole job and she does it flawlessly. 💅

---

🌸 NAME 🌸

qb_hdb_handle_refcount_get — Get the current refcount.

---

🦋 SYNOPSIS 🦋

#include <qb/qbhdb.h>

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

---

🎀 PARAMS 🎀

• hdb — the database instance 🗂️ like, the whole vibe container
• handle_in — the handle 🫶 the specific lil guy you're asking about

---

💜 DESCRIPTION 💜

ngl, the original page leaves this section completely empty — no lore, no tea, nothing. so we're just gonna keep it moving, no cap. 🙈

---

🌈 STRUCTURES 🌈

here's the struct, verbatim, character for character, because we do not mess with the facts around here:

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

---

⭐ RETURN VALUE ⭐

(>= 0 is the refcount, -errno failure)

so yeah — if you get >= 0, that's your refcount, slay. if you get -errno, something went sideways and it's giving failure. 😭

---

👑 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_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.

---

okay that's the whole page bestie, we ate and left no crumbs 🍓✨ this was LIBQB, dated 2025-09-16, and the page you just read is QB_HDB_HAN...FCOUNT_GET(3) — mwah, bye! 🎀💅🦋