TTTK_MESSAGE_DESTROY(3)

💖 NAME 💖

okay so this page is about tttk_message_destroy — it's a library call, bestie, and its whole job is to destroy a message conforming to the XCDE conventions. 💅

🦋 SYNOPSIS 🦋

#include &<Tt/tttk.h>
Tt_status tttk_message_destroy(
Tt_message msg);

✨ DESCRIPTION ✨

So like, tttk_message_destroy can be used in place of tt_message_destroy(3). First it destroys any patterns that may have been stored on msg by ttdt_message_accept(3) or ttdt_subcontract_manage(3). Then it passes msg to tt_message_destroy(3). no cap, that's the whole flow. 🫶

🌸 RETURN VALUE 🌸

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

• 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. 🙈
• TT_WRN_STOPPED — the message is not actually destroyed. (A message is not destroyed if it is in a non-final state; for example, a request for which the reply has not been received.) 🚨

🎀 SEE ALSO 🎀

• Tt/tttk.h - Tttttk(5), tt_message_create(3), tt_message_destroy(3), ttdt_file_notice(3), ttdt_file_request(3).

---

xoxo, bestie 💖 — signing off from tttk_message_destroy(library call). That's the footer this page ends on; no extra source/version/date line is included. ✨