TT_MESSAGE_REJECTER(3)

📦
version 2.5.3 · 2 versions
, in nixos 26.05

💅 tt_message_rejecter — like, the library call one

okay so bestie, welcome to tt_message_rejecter from the ToolTalk C library (tt_c.h) ✨ this is a library call page, and we are getting into it.

🌸 NAME 🌸

tt_message_rejecter — returns the procid of the nth rejecter of an offer. that's the whole vibe. no cap.

🎀 SYNOPSIS 🎀

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

🦋 DESCRIPTION 🦋

okay so picture this: the tt_message_rejecter function returns the procid of the *n*th rejecter of the message you specify. that's it. that's the function. she's simple, she's iconic 💅

  • m — the opaque handle for the message involved in this operation. opaque means you don't peek inside her, you just hold her hand 🫶
  • n — the number of the rejecter to be returned. and listen: the first rejecter is numbered zero. zero-indexed, because of course it is 🙈

⭐ RETURN VALUE ⭐

upon successful completion, tt_message_rejecter returns the procid of the *n*th rejecter. slay 💖

but here's the thing — your application can use tt_ptr_error to extract one of these Tt_status values from the returned pointer, so let's do the vibe check:

  • TT_OK — the operation completed successfully. we love a clean run ✨
  • TT_ERR_PROCID — there is no valid default procid, maybe because tt_open has not yet been called. like, she hasn't been introduced yet, bestie 😭
  • TT_ERR_NUM — the integer value you passed was invalid (out of range). you asked for a rejecter that does not exist, and the universe said no 💀
  • TT_ERR_STATE — the specified message is not in state TT_RETURNED. and since only TT_OFFERs can be in state TT_RETURNED, you'll get this status if the message you specified is a TT_NOTICE or a TT_REQUEST. wrong message, wrong era, not her moment 🙈
  • TT_ERR_POINTER — the pointer you passed does not point to an object of the correct type for this operation. type mismatch, respectfully 💅

🌈 APPLICATION USAGE 🌈

your application can use tt_free to free any data stored in the address returned by the ToolTalk API. please free your stuff, bestie — main character energy includes cleaning up after yourself 🧚

👑 SEE ALSO 👑

and that's the page, periodt 🍓 this was tt_message_rejecter(library call) — courtesy of the ToolTalk library source, dated however old this manpage is (the footer literally just repeats tt_message_rejecter(library call), so like... she said the same thing twice, and honestly? relatable 💜). go forth and reject gracefully 💖🔥

📦 where this page comes from