TT_MESSAGE_ARG_IVAL_SET(3)

📦
version 2.5.3 · 2 versions
, in nixos 26.05

💅 tt_message_arg_ival_set — the manual page, but make it make sense

okay so bestie, you're looking at a library call page from the tt_message_arg_ival_set family (yes, that's the manual name, we're being official up top so we can be unhinged below 🎀). This is the ToolTalk girlie who handles integer args, and she's about to explain herself.

✨ SYNOPSIS ✨

#include <Tt/tt_c.h>
Tt_status tt_message_arg_ival_set(
Tt_message m,
int n,
int value);

like, that's the whole signature. look at her go 🦋

🌸 DESCRIPTION 🌸

okay so tt_message_arg_ival_set adds an integer value in the *n*th message argument. that's the whole job. she's an adder. she adds.

and like — plot twist — she also changes the value of an existing *n*th message argument to an integer. so if that slot was giving "not an int" energy before, now it's giving int. slay.

the arguments, one by one, karena we don't skip details in this house 💅:

  • m — the opaque handle for the message involved in this operation. opaque means you don't peek behind the curtain, you just hold the handle, no cap.
  • n — the number of the argument to be set. and listen: the first argument is numbered zero. zero-indexed. classic C behavior, we been knew 😭
  • value — the contents for the message argument. the actual integer. the main character of the operation, honestly.

🔥 RETURN VALUE 🔥

upon successful completion, tt_message_arg_ival_set returns the status of the operation as one of the following Tt_status values — vibe check 'em all:

  • TT_OK — The operation completed successfully. literally ate. 💖
  • TT_ERR_NOMP — The ttsession(1) process is not running and the ToolTalk service cannot restart it. like, the whole session is gone, bestie, that's not a you problem, that's a daemon problem 😭
  • TT_ERR_NUM — The integer value passed was invalid (out of range). you gave her a number that does not fit the assignment. tragic. 🫠
  • TT_ERR_POINTER — The pointer passed does not point to an object of the correct type for this operation. wrong type at the function, we're not doing that today 🙈
ngl, notice that TT_ERR_NUM is about the integer value being out of range — so like, do your range homework before calling. ✨

🦋 SEE ALSO 🦋

go read these next, bestie, they're all in the group chat:

🎀 and that's the page!! sign-off time: this was tt_message_arg_ival_set, a library call, brought to you by the tt_message_arg_ival_set(library call) crew — same name in the header, same name in the footer, no version, no date, just vibes and a copyright-free farewell. stay zero-indexed, stay hydrated, mwah 💜🧚

📦 where this page comes from