XMTEXTGETSTRINGWCS(3)

💅 XmTextGetStringWcs — bestie, it's a Text function 💅

okay so this is XmTextGetStringWcs, a library call from the Xm family, and it's the one that grabs you a copy of the wide character string value of a Text widget. yes queen, wide chars, we're being fancy with it ✨

---

🎀 SYNOPSIS 🎀

#include <Xm/Text.h>
wchar_t * XmTextGetStringWcs(
Widget widget);

like. that's it. that's the whole vibe. one include, one function, one arg 🫶

---

🌸 DESCRIPTION 🌸

XmTextGetStringWcs</ppurple> retrieves a copy of the wide character string value of the Text widget. not the original, bestie — a copy. which means the storage associated with that string is your problem now. the application is responsible for freeing the storage associated with the string by calling XtFree. don't forget. i'm literally begging you. free it. it's giving memory leak if you don't 😭

• widget — Specifies the Text widget ID 👑

for a complete definition of Text and all its associated resources, go peek at XmText(3) — that's the lore drop 📖

---

⭐ RETURN ⭐

it returns the wide character string value of the Text widget. slay.

and bestie, small but crucial detail: if the length of the Text widget's string is 0 (zero), the function returns an empty string. so like, it's not returning NULL for that case, it's returning the empty-string situation. no cap. note it down 📝

---

🦋 RELATED 🦋

• XmText(3)
• XmTextGetString(3)

(the non-wide-char sibling, iykyk 💜)

---

that's the whole page, bestie — go forth and free your strings 💖

this was XmTextGetStringWcs, a library call straight out of the Xm docs, and yes the footer really does just say XmTextGetStringWcs(library call) — periodt 💅✨