TT_SESSION_BPROP(3)

🌸 NAME 🌸

tt_session_bprop — grab the ith value of a named property on a session, bestie 💅

(this one lives in the library call section of the manual, fyi 🫶)

---

✨ SYNOPSIS ✨

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

---

🦋 DESCRIPTION 🦋

Okay so tt_session_bprop fetches the ith value of the property you named, from the session you specified. That's literally the whole vibe 💖

Heads up tho: if there are i values or fewer, then both the returned value and the returned length get set to zero. Not one, not the other — both. Zero. Periodt ✨

Now let's break down the args, because iykyk:

• sessid — the session you joined, hun. You can totally use the sessid value that came back when tt_default_session was called 🎀
• propname — the name of the property you're pulling values out of 🌸
• i — which item in the property list you want. And listen — the list numbering starts at zero. Classic. 🙈
• value — the address of a character pointer that the ToolTalk service points at a string holding the contents of the property ✨
• length — the address of an integer where the ToolTalk service sets the length of the value, in bytes 💜 (the description below calls this one len, just so you're not confused when you see it 👀)

---

🔥 RETURN VALUE 🔥

When it's a slay and everything works, tt_session_bprop returns the status of the operation as one of these Tt_status values:

• TT_OK — the operation completed successfully, we love to see it 👑
• TT_ERR_NOMEM — not enough memory available to actually do the function 😭
• TT_ERR_NOMP — the ttsession(1) process isn't running and the ToolTalk service can't restart it 💀
• TT_ERR_NUM — the integer value you passed was invalid (out of range) 🚩
• TT_ERR_PROPNAME — that property name is syntactically invalid, bestie 🙈
• TT_ERR_SESSION — the ToolTalk session you specified is out of date or just plain invalid 🌧️

---

💫 SEE ALSO 💫

• Tt/tt_c.h — and also Tttt_c(5), go read it 🧚

---

and that's the whole page, bestie — filed under library calls, no date stamp on this one, so consider this your cute little sign-off 🎀💖✨