qt_team_parent_id(3)

💖 qt_team_parent_id — bestie edition 💖

okay so this is a page from the libqthread manual (section 3, the library-functions section, iykyk), and it's all about finding out who your team's parent is. yes, teams have parents here. it's giving family tree but for threads. 🌳

✨ NAME ✨

qt_team_parent_id — returns the current team's parent's unique ID number 🫶

✨ SYNOPSIS ✨

#include <qthread.h>

unsigned int
qt_team_id (void);

no cap, that synopsis line is written exactly like that in the original page — qt_team_id, not qt_team_parent_id. we're keeping it verbatim because that's what's on the page, bestie. don't come for me 💅

✨ DESCRIPTION ✨

so like, this function hands you back the unique identifier that belongs to the parent team of whichever team the currently executing qthread is chillin' in. 🌸

• generally, these values go up monotonically — like, ever-increasing, one after another, very demure, very consistent ✨
• BUT 😭 the value can wrap around after UINT_MAX-1 teams. so don't be out here treating them like they'll climb forever. they won't. 💀
• also, only subteams have parent teams (or parent subteams). if you're a top-level team, you're parentless. main character energy, honestly. 👑
• if you call this from a team with no parent, you get QTHREAD_NON_TEAM_ID back. no parent, no ID, no drama. 🙈

✨ RETURN VALUE ✨

• on success, you get the thread's parent team's identifying number. slay. 🎀
• if you call it from outside the Qthreads library, or from a parentless team, you get QTHREAD_NON_TEAM_ID. that's your lil "nope, nothing here" signal. ⭐
• and lowkey important: the special value QTHREAD_NULL_TEAM_ID will never be returned by this function. never ever. periodt. 🔥

✨ SEE ALSO ✨

• qt_team_id(3)
• qthread_id(3)
• qthread_shep(3)

fr fr, go read those if you want the full lore. the whole squad is connected. 🦋

k bye bestie 💜 this was the libqthread manual page for qt_team_parent_id(3), dated NOVEMBER 2012 — yes, ancient, but she still serves. go be iconic with your team IDs. 🧚✨