qthread_queue_release(3)

✨ NAME ✨

qthread_queue_release — bestie, this is the one that activates the tasks chillin' in the queue so they actually get scheduled and executed 💅

(also hi, you're reading a libqthread man page, section 3, and it's about to be iconic)

🎀 SYNOPSIS 🎀

#include <qthread.h>

int
qthread_queue_release_one (qthread_queue_t q);

int
qthread_queue_release_all (qthread_queue_t q);

💖 DESCRIPTION 💖

okay so there are two of these functions and they're both about the same vibe: emptying out the queue you point at (q) and handing the tasks inside it over to the scheduler so they can actually go do their thing. no gatekeeping, no tasks left rotting in the queue 🙈

The difference? It's giving how much.

• qthread_queue_release_one() — takes out only a single task, in a fifo manner (first in, first out, the way the universe intended), and schedules it. just one. one lil guy 🥺
• qthread_queue_release_all() — takes out all of the tasks and schedules them. every single one. the whole friend group is going out tonight 🔥

🌈 RETURN VALUES 🌈

Both functions return QTHREAD_SUCCESS on success, and an error otherwise. that's it, that's the tea 🍓

ngl if you get anything that isn't QTHREAD_SUCCESS, something went sideways — check your error, bestie 😭

👑 SEE ALSO 👑

• qthread_queue_create(3)
• qthread_queue_destroy(3)
• qthread_queue_join(3)
• qthread_queue_length(3)

and that's the whole page, you ate it 💖 this was libqthread, dated AUGUST 2013, and it lives at qthread_queue_release(3). periodt ✨🦋