XMSTRINGGETLTOR(3)

✨ NAME ✨

XmStringGetLtoR — a compound string function that goes looking for a text segment inside the compound string you hand it 💅 (it's the XmStringGetLtoR(library call) page, bestie, and we're gonna get through it together)

🌸 SYNOPSIS 🌸

#include <Xm/Xm.h>
Boolean XmStringGetLtoR(
XmString string,
XmStringCharSet tag,
char **text);

💖 DESCRIPTION 💖

okay so first thing, and I need you to hear me on this one: this function is obsolete 😭 it literally only still exists for compatibility with previous releases, like that group chat you can't leave because of one person. it's been replaced by XmStringUnparse, so if you're writing new code, go there instead, fr fr.

so what does it do? XmStringGetLtoR returns the first text component in the input compound string that's tagged with the tag component you gave it. the returned text is meant to be a NULL-terminated sequence of single byte characters.

and here's the part where you gotta pay attention 👀 if the function returns True, it will allocate space to hold the returned text. the application is responsible for managing that allocated space — that's on you, bestie, not on the library. you can recover the allocated space by calling XtFree. don't forget, or it's giving memory leak energy 💀

• string — specifies the compound string. that's the one we're digging through 🦋
• tag — specifies the font list element tag associated with the text. a value of XmFONTLIST_DEFAULT_TAG identifies a locale text segment ✨
• text — specifies a pointer to a NULL terminated string

🎀 RETURN 🎀

returns True if the matching text segment can be found 🔥 and on return, text will have a NULL terminated byte sequence containing the matched segment. iconic. that's it, that's the whole return value.

🫶 RELATED 🫶

• XmStringCreate(3).

and that's the whole page, no cap 💜 this was the XmStringGetLtoR(library call) manual page — library call vibes, straight from the Xm docs, and yes I read the whole thing so you don't have to. go call XtFree when you're done, I'm literally begging 🙈 🎀✨