TT_SPEC_PROP_SET(3)

💅 tt_spec_prop_set — like, the library call version, bestie

okay so picture this: it's a C library call, it lives in the ToolTalk world, and its whole entire job is replacing property values. that's it. that's the vibe. let's get into it ✨

---

✨ SYNOPSIS ✨

#include &<Tt/tt_c.h>
Tt_status tt_spec_prop_set(
const char *objid,
const char *propname,
const char *value);

like, that's the whole thing. three args, one status back. slay.

---

🎀 DESCRIPTION 🎀

so tt_spec_prop_set replaces any values that are currently chilling under this property of the object spec with a brand new value. not adds. not merges. replaces. the old values are gone gone, periodt. 💀

here's the cast of characters:

• objid — the identifier of the object involved in this operation. like, which object are we even talking about, bestie.
• propname — the name of the property that stores the values. the lil label on the box 📦
• value — the value to be placed in the property value list. and here's the plot twist: if value is NULL, the property gets removed entirely. gone. deleted. no cap. 🫶

---

🌈 RETURN VALUE 🌈

when it goes off without a hitch, tt_spec_prop_set returns the status of the operation as one of these following Tt_status values. iykyk, read them carefully:

• TT_OK — the operation completed successfully. we love to see it 👑
• TT_ERR_DBAVAIL — the ToolTalk service could not access the ToolTalk database needed for this operation. 😭
• TT_ERR_DBEXIST — the ToolTalk service could not access the specified ToolTalk database in the expected place. like it went looking and nobody was home 🏚️
• TT_ERR_NOMP — the ttsession(1) process is not running and the ToolTalk service cannot restart it. rip 💀
• TT_ERR_OBJID — the objid passed to the ToolTalk service does not reference an existing object spec. that object said "who?" 🙈
• TT_ERR_PROPLEN — the specified property value is too long. (the maximum size is implementation specific, but is at least 2048.) okay so important detail here, don't skip it: at least 2048, but the real max is up to whoever implemented it. so like, don't go assuming 2048 is the ceiling, bestie 🚨
• TT_ERR_PROPNAME — the specified property name is syntactically invalid. it's giving "you typed it wrong" ✨

---

🦋 SEE ALSO 🦋

• Tt/tt_c.h - Tttt_c(5)
• tt_spec_prop_add(3)

---

and that's the whole page, bestie!! this lil beauty comes to you straight from the tt_spec_prop_set(library call) manual — the library call section, no date on this one, that's just how it is 💖 go forth and set those properties 🌸