QB_HDB_HANDLE_CREATE(3)

💖 QB_HDB_HANDLE_CREATE(3) 💖

okay so bestie, welcome to the libqb Programmer's Manual — this is the page for qb_hdb_handle_create, and yes we're gonna get into it. grab a boba, we're learning today 🧋✨

---

🌸 NAME 🌸

qb_hdb_handle_create — Create a new handle.

like. the name literally says it. we love a self-explanatory icon 💅

---

✨ SYNOPSIS ✨

#include <qb/qbhdb.h>

int32_t qb_hdb_handle_create(
    struct qb_hdb   *hdb,            /* the database instance */
    int32_t          instance_size,  /* size of the object to malloc */
    qb_handle_t     *handle_id_out   /* new handle */
);

so you pull in the header, and you call this thing with three args. that's the whole vibe. 🦋

---

🎀 PARAMS 🎀

• hdb — the database instance. the main character of the whole situation, no cap.
• instance_size — size of the object to malloc. that's how much room we're asking for 🍓
• handle_id_out — new handle. this is where the shiny new handle goes when it's done, okay? 🫶

---

💜 DESCRIPTION 💜

(no prose here bestie — the structs are right below and they're doing all the talking 😭)

🧚 STRUCTURES 🧚

okay so here's the struct, look at her:

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

literally every field accounted for. handle_count, handles, iterator, destructor, first_run — all of them, we don't skip anybody in this house 💖

---

⭐ RETURN VALUE ⭐

(0 == ok, -errno failure)

so like: 0 means ok, we ate. anything -errno shaped means failure, and honestly? the -errno part tells you why, which is giving thoughtful ✨

---

👑 SEE ALSO 👑

squad, the whole group chat, all of them linked below:

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

go read them. they're all important. iykyk 😌

---

🌈 COPYRIGHT 🌈

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

---

a moment of appreciation for the legal girlies, fr fr — they keep the whole thing legit 💅

---

and that's the page!! 🎉 this was LIBQB, dated 2025-09-16, and you just read QB_HDB_HANDLE_CREATE(3) front to back like a scholar. so proud of you. go make some handles bestie 💖🌸✨