TT_MESSAGE_ARG_XVAL_SET(3)

📦
version 2.5.3 · 2 versions
, in nixos 26.05

💖 NAME 💖

tt_message_arg_xval_set — okay bestie, this one is a library call, and its whole thing is: serialize and set data into an existing message argument. That's the vibe. Periodt. ✨

✨ SYNOPSIS ✨

#include &<Tt/tt_c.h>
Tt_status tt_message_arg_xval_set(
Tt_message m,
int n,
xdrproc_t xdr_proc,
void *value);

🦋 DESCRIPTION 🦋

The tt_message_arg_xval_set function serializes and sets data into an existing message argument. It's giving "put this data into that argument slot, but make it XDR" energy. 💅

The m argument is the opaque handle for the message involved in this operation.

The n argument is the number of the argument to be changed. The first argument is numbered zero — yes, zero-indexed, iconic behavior, no cap.

The xdr_proc argument causes tt_message_arg_xval_set to serialize the data pointed to by value and store it as a byte string value of the nth argument of the message.

The value argument is the data to be serialized.

🌸 RETURN VALUE 🌸

Upon successful completion, the tt_message_arg_xval_set function returns the status of the operation as one of the following Tt_status values:

  • TT_OK — the operation completed successfully. slay.
  • TT_ERR_MODE — the specified Tt_mode is invalid.
  • TT_ERR_NOMP — the ttsession(1) process is not running and the ToolTalk service cannot restart it.
  • TT_ERR_POINTER — the pointer passed does not point to an object of the correct type for this operation.
  • TT_ERR_NUM — the integer value passed was invalid (out of range).
  • TT_ERR_XDR — the XDR procedure failed on the given data, or evaluated to a zero-length expression.

🎀 SEE ALSO 🎀

✨ Sign-off: this page's footer is the library call source/version vibe for tt_message_arg_xval_set, and the original didn't print a separate date — so I'm not inventing one, bestie 🫶💅🔥

📦 where this page comes from