TT_MESSAGE_STATUS(3)

🌸 NAME 🌸

okay so bestie, this is the tt_message_status(library call) manual page — and it does exactly one very specific thing: retrieve the status attribute from a message. that’s the whole vibe. ✨

✨ SYNOPSIS ✨

#include &<Tt/tt_c.h>
int tt_message_status(
Tt_message m);

💅 DESCRIPTION 💅

The tt_message_status function retrieves the status attribute from the specified message. like, you pass it a message, and it gives you the status that’s stored in there. iconic. 💖

The m argument is the opaque handle for the message involved in this operation. no peeking inside, bestie — just pass the handle. 🫶

👑 RETURN VALUE 👑

Upon successful completion, the tt_message_status function returns an integer that describes the status stored in the status attribute of this message. The application can use tt_int_error(3) to extract one of the following Tt_status values from the returned integer:

• 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. 🙈

🦋 SEE ALSO 🦋

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

---

💖 that’s the whole page, bestie! source/version/manual tag: tt_message_status(library call) — and the original didn’t give a date, so no fake date energy here. 🎀