qt_dictionary_end(3)

💖 qt_dictionary_end(3) 💖

okay bestie, welcome to libqthread's very own manual page for qt_dictionary_end — yes this is a page from the libqthread manual, and yes it's about to be your new fave lil function. sit down, hydrate, let's go 🫶

✨ NAME ✨

qt_dictionary_end — bestie, this one makes you an iterator that points to the end of the dictionary. that's the whole job. iconic behaviour honestly 👑

🌸 SYNOPSIS 🌸

#include <qthread/dictionary.h>

qt_dictionary_iterator *
qt_dictionary_end (qt_dictionary *dict);

look at her. two lines of include, one lil function. no cap, she's serving simplicity ✨

🦋 DESCRIPTION 🦋

so here's the tea, fr fr: this function creates a new iterator on the dictionary dict, and that iterator is pointing at the item past the end of the list — which, and this is the key part bestie, is NULL.

like… she's not pointing at a real item. she's pointing at the <em>nothing</em> after the last item. it's giving "end of the road, nothing to see here" energy 💅 and that's literally the point, that's what she's for.

🎀 RETURN VALUES 🎀

• returns an initialized qt_dictionary_iterator object — slay, you got yourself an iterator 🥳
• or NULL if there was some kind of error 😭 so like… always check, okay? don't just assume she ate. check for NULL.

bestie PLEASE vibe check that return value before you use it. NULL means something went wrong and using it anyway is not the move 🙈

🌈 SEE ALSO 🌈

the whole friend group, go say hi:

• qt_dictionary_create(3)
• qt_dictionary_delete(3)
• qt_dictionary_destroy(3)
• qt_dictionary_get(3)
• qt_dictionary_iterator_copy(3)
• qt_dictionary_iterator_create(3)
• qt_dictionary_iterator_destroy(3)
• qt_dictionary_iterator_equals(3)
• qt_dictionary_iterator_get(3)
• qt_dictionary_iterator_next(3)
• qt_dictionary_put(3)
• qt_dictionary_put_if_absent(3)

and that's the page babes 💜 this lil gem comes to you from libqthread, dated AUGUST 2012 — vintage but still serving. mwah, go write some iterators, you got this 🧚✨💖