TT_MESSAGE_STATUS_STRING(3)

💖 NAME 💖

tt_message_status_string — retrieve the character string stored with the status attribute for a message 🎀✨

hey bestie, you're reading the tt_message_status_string page from the library call manual, and it's lowkey iconic because it's all about scooping out the status string attached to a message 💅.

✨ SYNOPSIS ✨

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

🦋 DESCRIPTION 🦋

okay so tt_message_status_string retrieves the character string stored with the status attribute for the specified message — it's giving “tell me the status tea, but as a string” 🍓.

The m argument is the opaque handle for the message involved in this operation. treat it like the main character backstage pass for the message 🎟️👑.

🌸 RETURN VALUE 🌸

Upon successful completion, tt_message_status_string returns the status string stored in this message. The application can use tt_ptr_error(3) to extract one of the following Tt_status values from the returned pointer:

• TT_OK — The operation completed successfully. 💖
• 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. 💀

🎀 APPLICATION USAGE 🎀

The application should use tt_free(3) to free any data stored in the address returned by the ToolTalk API — yes bestie, clean up your mess, it's self-care 🧚✨.

🌈 SEE ALSO 🌈

the friend group:

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

---

and that's the cute sign-off from the tt_message_status_string page in the library call manual — that's the footer's source/version/date situation, no extra date tea in the original, so byeee bestie 🎀💖✨