DTSESSIONSAVEPATH(3)

💖 NAME 💖

DtSessionSavePath — get a pathname for saving application state information. ✨

---

✨ SYNOPSIS ✨

#include &<Dt/Session.h>
Boolean DtSessionSavePath(
Widget widget,
char **savePath,
char **saveFile);

---

🦋 DESCRIPTION 🦋

Okay bestie, so DtSessionSavePath is the function that returns the pathname your app should use for saving its state information. The info gets used later by the application to restore its state. 💅

The widget argument is the application's top level widget. The savePath argument is the address of the character string that receives the pathname of the state information file your app will use for storing its state. The saveFile argument is the address of the character string that receives the filename of the file your app will use for storing its state. 🎀

---

🌈 RETURN VALUE 🌈

Upon successful completion, DtSessionSavePath returns True; otherwise, it returns False. No cap. 💖

---

🎀 APPLICATION USAGE 🎀

The application should add -session saveFile when it updates its WM_COMMAND property.

The application must use XtFree(3) to free data returned in *savePath and *saveFile. Like, actually must — don't skip this one, bestie. 🫶

---

🔥 SEE ALSO 🔥

• Dt/Session.h - DtSession(5), DtSessionRestorePath(3)
• XtFree(3)

---

That's the whole page, bestie! source/version: the library call section; date: not printed on this page. 💅🌟🦋