TT_MESSAGE_ABSTAINER(3)

🦋 tt_message_abstainer — library call, bestie 🦋

Okay so we’re in the library call page for tt_message_abstainer, and it’s highkey giving ToolTalk API main character energy 💅. This one returns an offer’s nth abstaining procid, no cap.

🌸 NAME 🌸

tt_message_abstainer — return offer's nth abstaining procid. Periodt. ✨

🎀 SYNOPSIS 🎀

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

💖 DESCRIPTION 💖

Okay so the tt_message_abstainer function returns the procid of the nth abstainer of the specified message. Slay. 🎀

Here’s the arg tea:

• The m argument is the opaque handle for the message involved in this operation. Iconic.
• The n argument is the number of the abstainer to be returned.

And the indexing? The first abstainer is numbered zero, bestie. Zero. Not one. Periodt. 🫶

🔥 RETURN VALUE 🔥

Upon successful completion, the tt_message_abstainer function returns the procid of the nth abstainer. The application can use tt_ptr_error to extract one of the following Tt_status values from the returned pointer:

• TT_OK — the operation completed successfully. We love a clean win 💅.
• TT_ERR_PROCID — there is no valid default procid, perhaps because tt_open has not yet been called. Not me forgetting tt_open 😭.
• TT_ERR_NUM — the integer value passed was invalid (out of range). Number said “not today” 💀.
• 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.
• TT_ERR_POINTER — the pointer passed does not point to an object of the correct type for this operation. Wrong-type vibe check failed, ngl 🚫.

🌈 APPLICATION USAGE 🌈

The application can use tt_free to free any data stored in the address returned by the ToolTalk API. Yes bestie, clean up after yourself — tt_free is the moment 🧚.

⭐ SEE ALSO ⭐

• Tt/tt_c.h - Tttt_c(5) 🦋
• tt_message_abstainers_count(3)
• tt_ptr_error(3)
• tt_free(3)

---

Byeee 🫶 source/version: tt_message_abstainer(library call); date: this page’s footer didn’t print one, so I’m not inventing a date, bestie 💅✨