TT_MESSAGE_OP(3)

💅 tt_message_op — library call energy

okay so bestie, welcome to tt_message_op, a lil' function from the ToolTalk library (that's the library call bit on the tin 🎀). She's small, she's simple, she's here to hand you one specific attribute off a message. Let's get into it ✨

---

🌸 NAME 🌸

tt_message_op — retrieve the operation attribute from a message 🫶

---

🦋 SYNOPSIS 🦋

#include <Tt/tt_c.h>
char *tt_message_op(
Tt_message m);

---

💖 DESCRIPTION 💖

So like, tt_message_op literally just goes and retrieves the operation attribute from the message you point it at. That's the whole gig. She's not doing side quests, she's not doing extra credit — one message in, one operation attribute out. Iconic behavior, honestly 👑

The m argument is the opaque handle for the message involved in this operation. Opaque means don't peek under her hood, just pass the handle and trust the process 🫶

---

⭐ RETURN VALUE ⭐

When everything goes right, tt_message_op returns the operation which the receiving process is to perform — like, the actual assignment, delivered fresh 📬

Now, the app can use tt_ptr_error(3) to extract one of the following Tt_status values from the returned pointer:

• TT_OK — slay, the operation completed successfully 💅
• TT_ERR_NOMP — uh oh, the ttsession(1) process is not running and the ToolTalk service cannot restart it 😭 like, the whole session ghosted you
• TT_ERR_POINTER — the pointer you passed does not point to an object of the correct type for this operation 🙈 wrong vibe, wrong type, wrong pointer fr fr

---

🎀 APPLICATION USAGE 🎀

Bestie, listen to me: the application should use tt_free(3) to free any data stored in the address returned by the ToolTalk API. That memory is yours to clean up — don't just leave it sitting there, that's not the energy we're bringing ✨

---

🔥 SEE ALSO 🔥

• Tt/tt_c.h - Tttt_c(5)
• tt_ptr_error(3)
• tt_free(3)

---

lowkey a whole ToolTalk moment, highkey worth reading the related pages before you go off on your own 🧚

and that's the whole page, bestie — go forth and retrieve those operation attributes responsibly 💜

signing off with all the love: this was tt_message_op(library call), brought to you by the same glorious title stamped at the top, so you always know exactly where you are 🍓✨