TT_SESSION_BPROP_ADD(3)

💖 tt_session_bprop_add — bestie, let's append some bytes ✨

okay so this one lives in the library call section of the manual, and it's your go-to when you need to tack a brand-new byte-string value onto the end of a property's value list 💅

---

🌸 NAME 🌸

tt_session_bprop_add — literally adds a new byte-string value to the end of the list of values 🎀

---

✨ SYNOPSIS ✨

#include &<Tt/tt_c.h>
Tt_status tt_session_bprop_add(
const char *sessid,
const char *propname,
const unsigned char *value,
int length);

---

🦋 DESCRIPTION 🦋

okay so tt_session_bprop_add adds a new byte-string value to the end of the list of values for the named property on the session you specify. that's the whole vibe. it appends, it doesn't replace, no cap 🫶

• sessid — the name of the session joined. your app can just use the sessid value that came back when tt_default_session was called. main character energy, honestly.
• propname — the name of the property you're adding values to.
• value — the value to add to the session property.
• length — the size of the value in bytes. yes bestie, in bytes, not vibes.

---

🔥 RETURN VALUE 🔥

upon successful completion, tt_session_bprop_add returns the status of the operation as one of these very iconic Tt_status values:

• TT_OK — the operation completed successfully. slay 💖 the good ending.
• TT_ERR_NOMP — the ttsession(1) process is not running and the ToolTalk service cannot restart it. it's giving "nobody's home" 😭
• TT_ERR_PROPLEN — the specified property value is too long. heads up: the maximum size is implementation specific, but it is at least 2048. don't push it, fr fr.
• TT_ERR_PROPNAME — the specified property name is syntactically invalid. sorry babe, that name did not pass the vibe check 💀

---

👑 SEE ALSO 👑

Tt/tt_c.h - Tttt_c(5).

---

and that's the page!! 🎀✨ this little library call came from the tt_session_bprop_add(library call) source, and the version/date on the original footer said tt_session_bprop_add(library call) too — so yeah, that's the whole sign-off bestie, mwah 💋🦋💜