DtWsmDeleteWorkspace(API)

okay so bestie, welcome to the DtWsmDeleteWorkspace(API) page 💅 — it’s giving “delete one specific workspace” energy, and honestly? iconic.

🎀 NAME 🎀

DtWsmDeleteWorkspace — delete a specific workspace. no cap, that’s the whole assignment 💖

✨ SYNOPSIS ✨

       #include &<Dt/Wsm.h>
       int DtWsmDeleteWorkspace(
       Widget widget,
       Atom workspace);

💅 DESCRIPTION 💅

okay so here’s the tea ☕: the DtWsmDeleteWorkspace() function works with the CDE workspace manager, dtwm(1), and deletes a specific workspace. Applications can use this function to implement an interface to the workspace manager. slay 🫶

If the DtWsmDeleteWorkspace() function is not successful, the most likely reason for failure is that the CDE workspace manager, dtwm(1), is not running. like, that’s the big likely culprit 😭

The DtWsmDeleteWorkspace() function requires a widget. A gadget (or unrealized widget) is not acceptable for the widget argument. do not try to sneak one in, bestie 💀

DtWsmDeleteWorkspace() sends a message to the CDE workspace manager, dtwm(1), to delete the workspace. If the workspace name is not valid, no action is taken and the workspace manager reports no error.

warning bestie: invalid workspace name = no action, and the workspace manager reports no error. it’s giving silent treatment 🙈

🧚 ARGUMENTS 🧚

• widget — a realized widget. fr fr, it has to be realized; a gadget or unrealized widget is not acceptable here 💅
• workspace — the name of the workspace (in X atom form) to delete ✨

🌈 RETURN VALUE 🌈

The function returns Success (0) when it succeeds, and non-zero when it fails. Note that these are not the same values _DtWsmDeleteWorkspace returns. yes, the underscore one is a different vibe — do not mix them up 👑

💖 SEE ALSO 💖

• DtWsm(5)
• “Communicating with the Workspace Manager” section in the CDE Programmer’s Guide
• “Workspace Manager” section in the CDE Programmer’s Overview

---

and that’s the footer, bestie: DtWsmDeleteWorkspace(API) 🫶✨💖