qt_dictionary_delete(3)

💖 qt_dictionary_delete — bestie edition 💖

okay so this is a page from libqthread, and today's main character is qt_dictionary_delete(3). she's the one who removes things. a queen of letting go. 🫶

✨ NAME ✨

qt_dictionary_delete — remove a key/value pair from the dictionary

🌸 SYNOPSIS 🌸

#include <qthread/dictionary.h>

void *
qt_dictionary_delete (qt_dictionary *dict,
                      void *key);

🎀 DESCRIPTION 🎀

okay so picture this: you've got a dictionary data structure called dict, right? and inside it there's a key/value pair, and you're like. bestie. this pairing has served its purpose. it's time. 😌

that's literally what this function does. it removes the key/value pair, identified by key, from the dictionary data structure dict. she takes the key, she finds the pair, she takes it OUT. bye boo 💅

⭐ RETURN VALUES ⭐

• if the key was actually present in the dictionary — you get back a pointer to the value that was associated with it. iconic. you get the goods back. 👑
• if the key was not there — you get NULL. no key, no value, no drama. just NULL. 🍓

🌈 SEE ALSO 🌈

the whole dictionary friend group, fr fr:

• qt_dictionary_create(3)
• qt_dictionary_destroy(3)
• qt_dictionary_end(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 whole page, bestie!! this was libqthread, dated AUGUST 2012 (yes she's vintage, she's an elder, respect her 🧚), and you were reading qt_dictionary_delete(3). go forth and delete responsibly. no cap. 💜✨