qt_team_eureka(3)

✨ NAME ✨

qt_team_eureka — bestie, this one literally signals a eureka moment 💡✨

(it lives in the libqthread manual, section 3, in case you were wondering 🫶)

🌸 SYNOPSIS 🌸

#include <qthread.h>

void
qt_team_eureka (void);

that's it. no args. no return. just vibes and one very dramatic function call 💅

🦋 DESCRIPTION 🦋

okay so here's the tea 🍓 — when you call qt_team_eureka(), you're telling the world that this task has reached a eureka moment. iconic behavior, honestly.

and the consequences? lowkey brutal. every single other task in the calling task's team gets preemptively destroyed. not just those, bestie — also all the tasks in any subteams whose ancestor tree includes the calling task's team. all of them. gone. 💀

but our main character survives 👑 — the calling task stays alive as the only task within the team. and here's the spicy part: its return value location changes to the return value location of the original task of the team. so basically this task is now treated as the founding task of the team. main character energy fr fr ✨

ngl, "preemptively destroyed" is doing a lot of heavy lifting there. the other tasks do not get a goodbye party. 🙈

🧚 an example, because you asked 🧚

here's how you could use this to search a large binomial tree 🌳 — say it with me, we love a recursive queen:

int target;
node_t *search_inner(node_t *root) {
       if (root->value == target) {
              qt_team_eureka();
              return n;
       } else {
              qthread_fork(search_inner, root->leftchild, NULL);
              qthread_fork(search_inner, root->rightchild, NULL);
       }
}

node_t *search(node_t *root) {
       node_t *found;
       qthread_fork_new_subteam(search_inner, root, &found);
       qthread_readFF(NULL, &found);
       return found;
}

the way that one task finds the thing and the whole team just evaporates so nobody wastes cycles looking?? we're obsessed 😭🔥 that's the whole point, bestie. found it → eureka → everyone else in the tree (and the subteams under it) is donezo.

👑 SEE ALSO 👑

• qt_team_critical_section(3) — go read this one too, iykyk 🫶

that's the whole page, no cap. this lil gem comes from libqthread, dated NOVEMBER 2012 — yeah she's vintage but she still slays 💅✨