qdqueue_enqueue(3)

✨ qdqueue_enqueue — the libqthread girlie's guide to yeeting stuff onto a distributed queue ✨

okay so bestie, you're in the libqthread section of the manual (that's the 3 in the title, iykyk), and today's main character is qdqueue_enqueue 💅

🎀 NAME 🎀

qdqueue_enqueue — append an element to a distributed queue. literally just dropping something onto the end of the queue. no cap. 💖

🦋 SYNOPSIS 🦋

#include <qthread/qdqueue.h>

int
qdqueue_enqueue (qdqueue_t *q, void *elem);

int
qdqueue_enqueue_there (qdqueue_t *q, void *elem,
                       qthread_shepherd_id_t there);

🌸 DESCRIPTION 🌸

so there's two of these functions and they both do the same cute little thing: they append elements to distributed queues. 🫶

• qdqueue_enqueue() — this one is lowkey just qdqueue_enqueue_there() but where the there location is the current shepherd. like, the result of qthread_shep(NULL). she's staying home, no travel arc, periodt. ✨

ngl the "current shepherd" thing is doing a lot of heavy lifting here, so remember: same function, just pinned to where you already are. 💀

👑 RETURN VALUE 👑

the return value will be 0 for success, or it will indicate an error. that's it, that's the vibe check. 🌈

🔥 ERROR CODES 🔥

possible error codes are:

• QTHREAD_BADARGS — this one means one of the input arguments was null 😭 like bestie, you handed her nothing. she cannot work with nothing. 🙈

💜 SEE ALSO 💜

• qlfqueue_enqueue(3)
• qdqueue_create(3)
• qdqueue_enqueue(3)
• qdqueue_dequeue(3)
• qdqueue_empty(3)

and that's the whole page, babe 🎀 this was libqthread, dated APRIL 2011 — iconic behaviour from the archives, fr fr. go enqueue something. slay 💅✨