Tcl_GetCwd(3tcl)

💖 Tcl_GetCwd — the "where am I tho" page 💖

okay bestie, welcome to Tcl_GetCwd(3tcl) from the Tcl Library Procedures ✨ this one's all about the two lil C functions that mess with your current working directory. group chat energy, but make it pwd. 🫶

---

✨ NAME ✨

Tcl_GetCwd, Tcl_Chdir — manipulate the current working directory 🌸

---

🎀 SYNOPSIS 🎀

#include <tcl.h>

char *
Tcl_GetCwd(interp, bufferPtr)

int
Tcl_Chdir(dirName)

---

🦋 ARGUMENTS 🦋

• Tcl_Interp *interp (in) — the interpreter where we drop an error message if something goes wrong, iykyk. 🙈
• Tcl_DString *bufferPtr (in/out) — this dynamic string is where the current working directory gets stored. at the time of the call it should be uninitialized or free, no cap. and the caller must eventually call Tcl_DStringFree to free up anything stored here — that's your cleanup era, don't skip it. 💅
• const char *dirName (in) — file path in UTF-8 format. periodt.

---

🌈 DESCRIPTION 🌈

These procedures may be used to manipulate the current working directory for the application. they're giving C-level access to the same functionality as the Tcl pwd command — main character energy, but in C. 👑

Tcl_GetCwd returns a pointer to a string specifying the current directory, or NULL if the current directory could not be determined 😭. if NULL is returned, an error message is left in the interp's result. storage for the result string is allocated in bufferPtr; the caller must call Tcl_DStringFree() when the result is no longer needed. the format of the path is UTF-8. ✨

Tcl_Chdir changes the application's current working directory to the value specified in dirName. the format of the passed in string must be UTF-8. the function returns -1 on error or 0 on success. slay. ✅

---

⭐ KEYWORDS ⭐

pwd

---

and that's the whole page, bestie 🎀 this was Tcl 8.1, filed under Tcl_GetCwd(3tcl) — go change directories responsibly, mwah 💖