XMRENDERTABLEGETTAGS(3)

πŸ“¦
version 2.5.2 Β· 2 versions
, in alpine 3.24, arch rolling, centos-stream 9, epel 10, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0

πŸ’– XmRenderTableGetTags πŸ’–

okay bestie, welcome to the XmRenderTableGetTags page β€” it's a library call from the Xm fam, and it is literally the most helpful little convenience function ever. it gets rendition tags for you. that's the whole vibe. ✨


✨ NAME ✨

XmRenderTableGetTags β€” a convenience function that gets rendition tags πŸŽ€


🌸 SYNOPSIS 🌸

#include <Xm/Xm.h>
int XmRenderTableGetTags(
XmRenderTable table,
XmStringTag **tag_list);

no cap, that's the whole signature. two args, one int coming back. slay. πŸ’…


πŸ¦‹ DESCRIPTION πŸ¦‹

so here's the tea: XmRenderTableGetTags searches the table you hand it, digging through all the renditions (XmRenditions) entries for their XmNtag resources. and then β€” this is the good part β€” it composes those tag resources into an array. iconic behavior fr fr. 🌈

  • table β€” specifies the table containing the XmRenditions. like, the table you want searched. that one. πŸ‘‘
  • tag_list β€” is the array of XmStringTags generated by this function. and listen, this matters: the function allocates space to hold the returned tags and to hold the tag_list itself. the application is responsible for managing this allocated space. 🫢
⚠️ bestie, do NOT forget to clean up. the application can recover this allocated space by calling XtFree once for each of the returned tags, and then calling XtFree on the returned tag_list variable itself. leak = not cute. πŸ’€

⭐ RETURN ⭐

Returns the number of tags in tag_list. that's it, that's the return value. a little count for you. πŸ“



and that's the whole page, bestie!! πŸ’œ it's giving "convenience function done right." go forth and free your tags with XtFree, okay?? 🧚

XmRenderTableGetTags β€” library call, straight out of the Xm manual, footer and all (yes the page signs off with its own name again, we love a self-referential queen πŸ‘‘). mwah πŸ’‹