TT_PATTERN_CATEGORY(3)

💖 NAME 💖

okay bestie, welcome to the tt_pattern_category(library call) page ✨ — this one is about returning the category value of a pattern, fr fr.

---

🎀 SYNOPSIS 🎀

#include &<Tt/tt_c.h>
Tt_category tt_pattern_category(
Tt_pattern p);

---

🌸 DESCRIPTION 🌸

So the tt_pattern_category function returns the category value of the specified pattern. That's the whole main-character job 💅

The p argument is the opaque handle for a message pattern — think of it as the pattern's lil' VIP pass, iykyk 🫶

---

✨ RETURN VALUE ✨

When it's done successfully, tt_pattern_category returns a value that tells you whether the receiving process will observe or handle messages 👀

It returns one of these Tt_status values:

• TT_OBSERVE — the receiving process will observe messages.
• TT_HANDLE — the receiving process will handle messages.

Your app can use tt_int_error(3) to extract one of these Tt_status values from the Tt_category integer return value:

• TT_OK — the operation completed successfully. slay ✅
• TT_ERR_NOMP — the ttsession(1) process is not running and the ToolTalk service cannot restart it. 😭
• TT_ERR_POINTER — the pointer passed does not point to an object of the correct type for this operation. not the vibe check we wanted 💀

---

🦋 SEE ALSO 🦋

go peek at the rest of the crew:

• Tt/tt_c.h - Tttt_c(5)
• tt_pattern_category_set(3)
• tt_int_error(3)

---

xoxo from tt_pattern_category(library call) 💖 — that's the source/version footer energy, and there's no extra date line here, so bye bestie! 🎀