TTTK_MESSAGE_CREATE(3)

🌸 NAME 🌸

okay bestie, welcome to the tttk_message_create(library call) page — this is the library call that creates a message conforming to the XCDE conventions. iconic behavior, honestly 💅✨

---

✨ SYNOPSIS ✨

       #include &<Tt/tttk.h>
       Tt_message tttk_message_create(
       Tt_message context,
       Tt_class the_class,
       Tt_scope the_scope,
       const char *handler,
       const char *op,
       Tt_message_callback callback);

---

💖 DESCRIPTION 💖

so the tttk_message_create function creates a message that propagates inherited contexts from one message to another. yes bestie, it’s giving “pass the context along” energy 🫶

the tttk_message_create function creates a message and copies onto it all the context slots from context whose slotname begins with the characters ENV_. it gives the created message a Tt_class of the_class and a Tt_scope of the_scope.

if handler is not NULL, then tttk_message_create addresses the message as a TT_HANDLER to that procid; otherwise, it gives the message a Tt_address of TT_PROCEDURE. it sets the message’s op to op if op is not NULL.

if callback is not NULL, tttk_message_create adds it to the message as a message callback. cute, functional, slay 💅

---

🫶 RETURN VALUE 🫶

upon successful completion, the tttk_message_create function returns the created Tt_message, which can be modified, sent, and destroyed like any other Tt_message; otherwise, it returns an error pointer 😭

the application can use tt_ptr_error(3) to extract one of the following Tt_status values from the returned handle:

• TT_ERR_NOMEM — there is insufficient memory available to perform the function.
• TT_ERR_NOMP — the ttsession(1) process is not running and the ToolTalk service cannot restart it.
• TT_ERR_PROCID — the specified process identifier is out of date or invalid.

bestie, if you get an error pointer, do not just vibe past it — run tt_ptr_error(3) and find out which one it is. periodt 💀

---

🌈 SEE ALSO 🌈

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

---

that’s the whole page, bestie 🎀 source/version: tttk_message_create(library call); date: not printed on this copy, so no cap — that’s all she wrote 💅✨