DTDBLOAD(3)

💖 NAME 💖

okay so bestie, welcome to the DtDbLoad(library call) page — this is the function that loads the actions and data types database into your app. That's the whole main-character job. 💅

✨ SYNOPSIS ✨

#include &<Dt/Action.h>
void DtDbLoad(void)

🦋 DESCRIPTION 🦋

DtDbLoad is the glow-up move: it loads the actions and data types database into the application. The moment this function returns, boom — the database has been loaded. No cap. ✨

An environment variable decides which set of directories gets searched. DtDbLoad loads all actions and data types defined in files with a .dt suffix located in those directories. Periodt. 🎀

The directory search path is based on the value of the DTDATABASESEARCHPATH environment variable and internal defaults. DTDATABASESEARCHPATH contains a comma-separated list of directories in [host:]/path format. Your application must call DtDbLoad before calling any of the routines that query either the action or data type databases. If you call it multiple times, the old databases are freed before the new ones are created — out with the old, in with the new, literally. 💀

🌸 RETURN VALUE 🌸

The DtDbLoad function returns no value. That's it. It just does the thing and leaves. Iconic. 🫶

🌈 APPLICATION USAGE 🌈

If this function is used in a long-lived application, the application must dynamically reload the databases when they are modified. To do this, the client must register to receive notification whenever the actions and data types database needs to be modified. It is up to the application to recall DtDbLoad after receiving notification. This is done with a call to DtDbReloadNotify(3). Lowkey important, bestie. 🔥

If errors are encountered when reading the database files, error messages are written to the user's errorlog file ($HOME/.dt/errorlog). Records containing errors are not incorporated into the internal database. So the messy records get left outside the club. 🙈

⭐ SEE ALSO ⭐

• Dt/Action.h - DtAction(5), DtDbReloadNotify(3), dtdtfile(4).

---

💖 That's the DtDbLoad(library call) footer, bestie — this library-call legend is signing off. Stay loaded, stay iconic. 🎀