XMTEXTFIELDGETSTRING(3)

💖 NAME 💖

XmTextFieldGetString — bestie, it's a TextField function that grabs the string value for you ✨

🎀 SYNOPSIS 🎀

#include <Xm/TextF.h>
char * XmTextFieldGetString(
        Widget widget);

🦋 DESCRIPTION 🦋

okay so XmTextFieldGetString literally reaches into your TextField widget and pulls out its string value. that's the whole job. main character energy, no drama 💅

but bestie, hear me when i say this: you are the one responsible for freeing the storage associated with that string, and you do it by calling XtFree. not optional. the widget is not gonna clean up after you. you gotta do it yourself 🫶

• widget — specifies the TextField widget ID 👑

also, for the complete definition of TextField and all its associated resources, go read XmTextField(3). it's giving required reading 📚

🌸 RETURN 🌸

it returns a character pointer to the string value of the TextField widget ✨ and just so you know, that returned value is a copy of the value of the XmNvalue resource. so yeah, that's why you gotta free it (see above, i told you 💀).

oh and if the length of the TextField widget's string is 0 (zero), it returns an empty string. iconic behaviour tbh 🌈

💜 RELATED 💜

• XmTextField(3)
• XmTextFieldGetStringWcs(3)

go read those too, iykyk 🔥

and that's the whole page bestie!! this one came from the XmTextFieldGetString(library call) library call page — mwah, kisses, go free your strings 💖💅🦋