QB_MAP_ITER_NEXT(3)

💖 QB_MAP_ITER_NEXT — get the next item, bestie 💖

okay so this is a page from the libqb Programmer's Manual, and we're talking about qb_map_iter_next. it's literally the "gimme the next one" function of the iterator world. sit down, grab a boba, we're doing this 🧋✨

---

🌸 NAME 🌸

qb_map_iter_next — Get the next item. that's it. that's the whole job. she's simple, she's focused, she serves 💅

---

✨ SYNOPSIS ✨

#include <qb/qbmap.h>

const char * qb_map_iter_next(
    qb_map_iter_t   *i,      /* the iterator */
    void           **value   /* (out) the next item's value*/
);

so you roll up with an iterator, you hand over a pointer-to-pointer for the value, and she hands you back a key. iconic behavior honestly 👑

---

🎀 PARAMS 🎀

• i — the iterator. that's your lil cursor guy, the one doing all the walking 🚶♀️
• value — (out) the next item's value. note the (out) bestie, this is her writing to you, not you writing to her. she fills this in and hands it back 🫶

---

🦋 DESCRIPTION 🦋

not me reading the original page and finding this section literally empty 😭 no description. zero. nada. the whole section is just vibes and silence. so like… that's what's here. nothing. i'm not gonna make stuff up, that's not the move 🙈

---

🌈 RETURN VALUE 🌈

• the next key — yes bestie, the key. she returns the key. that's the whole return situation 👑
• NULL — the end of the iteration. when she gives you NULL, the walk is over, no more items, pack it up, go home 🏁

---

🔥 SEE ALSO 🔥

the whole friend group, fr fr — go read these too:

• qb_trie_dump(3)
• qb_map_iter_create(3)
• qb_skiplist_create(3)
• qb_map_notify_del(3)
• qb_map_put(3)
• qb_map_count_get(3)
• qb_map_foreach(3)
• qb_map_pref_iter_create(3)
• qb_map_get(3)
• qb_map_destroy(3)
• qb_hashtable_create(3)
• qb_map_iter_free(3)
• qb_map_notify_add(3)
• qb_trie_create(3)
• qb_map_notify_del_2(3)
• qb_map_rm(3)

---

💜 COPYRIGHT 💜

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

---

and that's the page, bestie 🎀 this lil gem came to you from the libqb crew, dated 2025-09-16, and yes it's the QB_MAP_ITER_NEXT(3) page — you already knew that tho. go iterate something cute ✨🦋💖