TT_SPEC_PROP(3)

💖 NAME 💖

okay so this is tt_spec_prop, straight from the tt_spec_prop(library call) manual, and it's here to retrieve the *i*th value of the property associated with an object spec. periodt 💅

• tt_spec_prop — retrieve the *i*th value of the property associated with an object spec ✨

---

✨ SYNOPSIS ✨

#include <Tt/tt_c.h>
char *tt_spec_prop(
const char *objid,
const char *propname,
int i);

---

🦋 DESCRIPTION 🦋

The tt_spec_prop function retrieves the *i*th value of the property associated with this object spec. like, it's giving "grab that specific value from the list" energy 🎀

Here's the cast of characters, bestie:

• objid — the identifier of the object involved in this operation.
• propname — the name of the property associated with the object spec.
• i — the item of the list whose value is to be retrieved. The list numbering begins with zero. iykyk 🫶

---

🎀 RETURN VALUE 🎀

Upon successful completion, the tt_spec_prop function returns the contents of the property value. 💖

If there are i values or less, tt_spec_prop returns NULL. The application can use tt_ptr_error(3) to extract one of the following Tt_status values from the returned pointer:

• TT_OK — The operation completed successfully. ✅
• 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. 💀
• TT_ERR_NOMP — The ttsession(1) process is not running and the ToolTalk service cannot restart it. 🚨
• TT_ERR_NUM — The integer value passed was invalid (out of range). 🙈
• TT_ERR_OBJID — The objid passed to the ToolTalk service does not reference an existing object spec. 🦋
• TT_ERR_PROPNAME — The specified property name is syntactically invalid. 🍓

---

🌸 APPLICATION USAGE 🌸

The application should use tt_free(3) to free any data stored in the address returned by the ToolTalk API. clean up after yourself, bestie 🧚

🚨 real talk: if the returned value has embedded nulls, its length cannot be determined. no cap, that's the caveat. 💅

---

🌈 SEE ALSO 🌈

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

---

bye bestie 💖 — footer sign-off: this is the tt_spec_prop(library call) page, and that's the source/version-date line as it appears. mwah 💋