DTSESSIONRESTOREPATH(3)

🌸 NAME 🌸

okay so bestie, this is DtSessionRestorePath — the library call that gets you a pathname for the application's state information file. That's the whole name section, and she ate. 💅✨

✨ SYNOPSIS ✨

copy this exactly, character for character, no autocorrect:

#include &<Dt/Session.h>
Boolean DtSessionRestorePath(
Widget widget,
char **restorePath,
char *restoreFile);

💅 DESCRIPTION 💅

The DtSessionRestorePath function returns a pathname to an application's state information. Iconic, honestly. 🎀

Here's the arg breakdown, because we love a clear vibe check:

• widget — the application's top level widget. She's the main character widget, periodt. 👑
• restorePath — the address of the character string to receive the pathname of the application's state information file. It's giving out-parameter energy 💅
• restoreFile — the filename of the file containing the application state information. This is the filename specified with the -session option at application invocation. iykyk 🌸

🎀 RETURN VALUE 🎀

Upon successful completion, the DtSessionRestorePath function returns True; otherwise, it returns False. That's the vibe check: True for slay, False for not-slay. 💖

🦋 APPLICATION USAGE 🦋

• The application must support the -session command-line option. No cap, it's required. ✨
• The application must use XtFree(3) to free data returned in *restorePath. Do not forget, bestie — free your data, protect your peace. 🫶

🔥 SEE ALSO 🔥

• Dt/Session.h - DtSession(5), DtSessionSavePath(3); XtFree(3). 🌈

---

that's the DtSessionRestorePath(library call) page, bestie — library call, no cap, and that's the sign-off 💖🫶