XMSTRINGCONCATANDFREE(3)

✨ NAME ✨

XmStringConcatAndFree — a compound string function that glues one string onto the end of another and then frees the originals, bestie 💖

🎀 SYNOPSIS 🎀

#include <Xm/Xm.h>
XmString XmStringConcatAndFree(
XmString s1,
XmString s2);

💅 DESCRIPTION 💅

okay so here's the vibe: XmStringConcatAndFree copies s2 to the end of s1 and hands you back a copy of the resulting compound string. and then — this is the part that makes it iconic — the original strings get freed. like, both of them. gone. slay ✨

the function will allocate space to hold the returned compound string, so bestie, that memory is yours to manage now. the application is responsible for managing the allocated space. 🫶

and how do you give that space back? you call XmStringFree. that's it. that's the whole recovery arc 💀

• s1 — specifies the compound string to which a copy of s2 is appended. she's the main character, everything gets appended to her 👑
• s2 — specifies the compound string that is appended to the end of s1. she's the plus-one tagging along at the end 🌸

so here's the tea: XmStringConcatAndFree works like the XmStringConcat function, except that it frees the s1 and s2 strings, and is therefore more efficient. you should use XmStringConcatAndFree instead of XmStringConcat if you want s1 and s2 to be freed afterwards. no cap, that's literally the whole point. iykyk 🔥

⚠️ heads up bestie: once this runs, s1 and s2 are freed. if you still needed them for something else, that's giving undefined-behaviour energy. plan accordingly 💀

🌈 RETURN 🌈

returns a new compound string. brand new. fresh out the box. periodt ✨

🦋 RELATED 🦋

• XmStringConcat(3)
• XmStringCreate(3)
• XmStringFree(3)

and that's the whole page, bestie!! this was XmStringConcatAndFree(library call) — a library call, in case the parentheses didn't already give it away 💅 go forth, concat, and free responsibly 🎀✨💖