TTMEDIA_LOAD_REPLY(3)

okay so bestie, welcome to ttmedia_load_reply from the library call manual — yes, the media-reply icon herself is here and she's ready to explain the whole thing 💅✨

💖 NAME 💖

ttmedia_load_reply — reply to a Display, Edit or Compose request 🫶

✨ SYNOPSIS ✨

#include &<Tt/tttk.h>
Tt_message ttmedia_load_reply(
Tt_message contract,
const unsigned char *new_contents,
int new_len,
int reply_and_destroy);

🦋 DESCRIPTION 🦋

okay so the ttmedia_load_reply function is literally the one you use to reply to a Media Exchange request to display, edit or compose a document. the editor working on the request is usually the one calling ttmedia_load_reply, right when the user has indicated in some way that he or she is finished viewing or modifying the document.

if new_contents and new_len are non-NULL and non-zero, respectively, ttmedia_load_reply uses their values to set the new contents of the document back in the appropriate output argument of contract. and if reply_and_destroy is True, ttmedia_load_reply replies to contract and then destroys it. periodt 💅

🔥 RETURN VALUE 🔥

upon successful completion, the ttmedia_load_reply function returns the created 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_NOMP — the ttsession(1) process is not running and the ToolTalk service cannot restart it 😭
• TT_ERR_NOTHANDLER — this application is not the handler for this message
• TT_ERR_NUM — the integer value passed was invalid (out of range)
• TT_ERR_PROCID — the specified process identifier is out of date or invalid

🌸 APPLICATION USAGE 🌸

if contract is a Display request, then new_contents and new_len should be zero. yes bestie, literally zero — that's the rule on the page 🎀

👑 SEE ALSO 👑

Tt/tttk.h - Tttttk(5), ttmedia_load(3), ttmedia_ptype_declare(3), ttmedia_Deposit(3).

---

and that's the whole vibe: the footer only gives us ttmedia_load_reply and the library call manual section, with no date attached, so signing off from there — bye bestie, go reply to those Media Exchange requests with main character energy 🌈💖