TT_MESSAGE_ACCEPTER(3)

📦
version 2.5.3 · 2 versions
, in nixos 26.05

💅 tt_message_accepter — library call

okay so bestie, welcome to tt_message_accepter from the library call girlies (that's the manual section, iykyk) ✨

🌸 NAME 🌸

tt_message_accepter — return offer's nth accepting procid 🎀

✨ SYNOPSIS ✨

#include <Tt/tt_c.h>
char *tt_message_accepter(
Tt_message m,
int n);

🦋 DESCRIPTION 🦋

so the tt_message_accepter function returns the procid of the *n*th accepter of the message you picked. literally that's it, that's the whole vibe 🫶

  • m — the opaque handle for the message involved in this operation. opaque means don't go peeking inside it, she's private 💅
  • n — the number of the accepter to be returned. and psa: the first accepter is numbered zero. zero-indexed, as the founding mothers intended 👑

💖 RETURN VALUE 💖

upon successful completion, tt_message_accepter returns the procid of the *n*th accepter. then you can use tt_ptr_error to extract one of these Tt_status values out of the returned pointer — vibe check time ⭐

  • TT_OK — the operation completed successfully. slay, no notes 🌈
  • TT_ERR_PROCID — there is no valid default procid, perhaps because tt_open has not yet been called. like bestie, you gotta open the door before you walk through it 😭
  • TT_ERR_NUM — the integer value passed was invalid (out of range). that number is not on the list, sorry 🍓
  • TT_ERR_STATE — the specified message is not in state TT_RETURNED. since only TT_OFFERs can be in state TT_RETURNED, this status will be returned if the specified message is a TT_NOTICE or a TT_REQUEST. wrong girl, wrong state, not her moment 💀
  • TT_ERR_POINTER — the pointer passed does not point to an object of the correct type for this operation. that's not a message, that's a whole other creature 🙈

🧚 APPLICATION USAGE 🧚

the application can use tt_free to free any data stored in the address returned by the ToolTalk API. yes, free it. clean up after yourself, main character energy includes chores 🫧

🎀 SEE ALSO 🎀

and that's the page, bestie 💜 this was tt_message_accepter(library call) — like, the actual manpage source/version line says tt_message_accepter(library call) too, so we're matching, iconic, periodt. mwah, go read tt_free(3) 🦋🌸

📦 where this page comes from