XMTEXTGETSTRING(3)

✨ XmTextGetString ✨

okay bestie so this one is a library call from the Xm Text era, and it's literally the "gimme the string" button 💖 the whole function is just XmTextGetString, and she's here to hand you the string value of a Text widget. no cap.

---

🌸 NAME 🌸

XmTextGetString — a Text function that accesses the string value 🫶

---

🎀 SYNOPSIS 🎀

#include <Xm/Text.h>
char * XmTextGetString(
Widget widget);

---

💅 DESCRIPTION 💅

so XmTextGetString goes and accesses the string value of the Text widget. that's it, that's the job, and she ate 💅

⚠️ okay but listen — the application is responsible for freeing the storage associated with the string by calling XtFree. like, you have to clean up after her. she is not going to do it for you. it's giving main character who leaves the dishes in the sink. don't be that app. free it. 😭

• widget — specifies the Text widget ID ✨

and for a complete definition of Text and its associated resources, go look at XmText(3). iykyk 📖

---

🔥 RETURN 🔥

she returns a character pointer to the string value of the text widget, periodt.

• this returned value is a copy of the value of the XmNvalue resource 👑 (a copy, bestie, not a live wire — don't go thinking you're editing the widget through it)
• she returns an empty string if the length of the Text widget's string is 0 (zero) 🍓 like, zero chars, zero drama, just an empty string

---

🌈 RELATED 🌈

• XmText(3)
• XmTextGetStringWcs(3)

go read those too, they're iconic ⭐

---

and that's the whole page, bestie 🦋 this was the XmTextGetString library call manual page, brought to you by the Xm Text widget corner of the universe, and yes she was born in the era of library calls and she's still slaying 💖 mwah, go free your strings 🌸