TT_FEATURE_REQUIRED(3)

💅 tt_feature_required — library call, bestie

okay so this is a library call from the ToolTalk crew, and it's literally the "hey, I NEED this" button. Let's get into it 🫶

---

✨ NAME ✨

tt_feature_required — declare a feature to be required by the calling program. that's it, that's the whole vibe 💖

---

🌸 SYNOPSIS 🌸

#include <Tt/tt_c.h>
Tt_status tt_feature_required(
Tt_feature feature);

---

🦋 DESCRIPTION 🦋

so tt_feature_required declares a feature to be required by the calling code. no cap. and if that feature is available? it enables it right then and there. slay ✨

now here's the part where you gotta pay attention, bestie 👀 — if the feature needs the ToolTalk service to do some initialization (for example, TT_FEATURE_MULTITHREADED), that initialization gets performed in this call. like, this call is where the magic happens.

and some features (such as TT_FEATURE_MULTITHREADED) require this call to be made before calling tt_open. so do it early, okay? don't be that person 🙈

---

🎀 ARGUMENTS 🎀

• feature — specifies the feature to be required. yeah that's it, just tell it which feature you're claiming 💅

---

👑 RETURN VALUE 👑

when it's done, tt_feature_required returns the status of the operation as one of these Tt_status values. vibe check time:

• TT_OK — the feature is available and has been enabled. iconic. we love to see it 🌈
• TT_ERR_TOOLATE — the tt_feature_required call must be made prior to other calls that have already been made to the ToolTalk API. oops, you're late to the party 😭
• TT_ERR_UNIMP — the version of the ToolTalk library linked with the calling code does not support the indicated feature. not implemented, not supported, not happening 💀

---

💜 APPLICATION USAGE 💜

so say you wanna use the ToolTalk library in a multithreaded environment — you'd declare multithreading to be required before a call to tt_open or ttdt_open. like this:

Tt_status ttstat;
ttstat = tt_feature_required(TT_FEATURE_MULTITHREADED);
tt_open();

see? declare first, open second. order matters, bestie 🧚

---

💖 SEE ALSO 💖

Tt/tt_c.h - Tttt_c(5), tt_feature_enabled(3), tt_open(3), ttdt_open(3) ⭐

---

and that's the whole page, fr fr 🌸 this was tt_feature_required(library call) — the header said so at the top and the footer said so at the bottom, so you know it's official. go forth and declare your features, main character 🎀💫