TT_SPEC_PROP_ADD(3)

💖 tt_spec_prop_add — bestie edition 💖

okay so this is a library call from the tt_spec_prop_add(library call) manual — literally the ToolTalk corner of the universe, and today we're adding stuff to the end of a property's value list. slay.

✨ NAME ✨

tt_spec_prop_add — add a new item to the end of the list of values 🎀

✨ SYNOPSIS ✨

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

✨ DESCRIPTION ✨

okay so the tt_spec_prop_add function does exactly one thing and does it gorgeously: it adds a new item to the end of the list of values associated with this spec property. no cap. it goes at the back, bestie — no line-cutting, no pushing people out of the way. 💅

The objid argument is the identifier of the object involved in this operation. think of it as the main character's ID card. 🪪

The propname argument is the property to which the item is to be added. like, which little property bucket are we dropping this into. 🧺

The value argument is the new character-string to be added to the property value list. that's the actual thing going in. periodt. ✨

✨ RETURN VALUE ✨

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

• TT_OK — The operation completed successfully. we ate and left no crumbs. 🍓
• TT_ERR_DBAVAIL — The ToolTalk service could not access the ToolTalk database needed for this operation. the database said "not today." 😭
• TT_ERR_DBEXIST — The ToolTalk service could not access the specified ToolTalk database in the expected place. it's giving lost in the mail. 📭
• TT_ERR_NOMP — The ttsession(1) process is not running and the ToolTalk service cannot restart it. literally nobody's home, and it can't even call somebody to come over. 💀
• TT_ERR_OBJID — The objid passed to the ToolTalk service does not reference an existing object spec. that ID card is fake, bestie. 🪪❌
• TT_ERR_PROPLEN — The specified property value is too long. (The maximum size is implementation specific, but is at least 2048.) too much text, the vibe check said overflow. 📏🙈
• TT_ERR_PROPNAME — The specified property name is syntactically invalid. the name is not giving what it's supposed to give. 🚫

✨ SEE ALSO ✨

• Tt/tt_c.h — Tttt_c(5)
• tt_spec_prop_set(3)

---

🦋 ok that's the whole page, bestie. this one's a library call from the tt_spec_prop_add(library call) manual, and the footer said tt_spec_prop_add(library call) with its source/version and date vibes — so there you go, go forth and add to the end of that list. mwah. 💖👑