TT_PATTERN_REGISTER(3)

🌸 NAME 🌸

tt_pattern_register — register a pattern with the ToolTalk service. And yes bestie, this is the library call manual page, so you're in the right place 💅

---

✨ SYNOPSIS ✨

#include &<Tt/tt_c.h>
Tt_status tt_pattern_register(
Tt_pattern p);

---

💖 DESCRIPTION 💖

Okay so tt_pattern_register registers a pattern with the ToolTalk service. That's the main-character move.

When the process is registered, it will start receiving messages that match the specified pattern. Slay ✨

⚠️ Once a pattern is registered, no further changes can be made in the pattern. So lock it in before you commit, bestie — no take-backs.

When the process joins a session or file, the ToolTalk service updates the file and session field of its registered patterns. Iconic behavior, honestly 🦋

The p argument is a unique handle for a message pattern. That handle is returned after tt_pattern_create(3) is called. So yes, you need that first, iykyk.

---

🌈 RETURN VALUE 🌈

Upon successful completion, tt_pattern_register returns the status of the operation as one of the following Tt_status values:

• TT_OK — the operation completed successfully. periodt 💅
• 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. rude, but okay 🙈
• TT_ERR_PROCID — the specified process identifier is out of date or invalid. 💀

---

🦋 SEE ALSO 🦋

• Tt/tt_c.h - Tttt_c(5), tt_pattern_unregister(3), tt_pattern_create(3).

---

source/version tea: it's the library call manual, page tt_pattern_register; date: not shown in the footer, bestie — bye, mwah 💖✨🫶