XMGETSECONDARYRESOURCEDATA(3)

💖 NAME 💖

XmGetSecondaryResourceData — bestie, this is the function that hands you the secondary widget resource data. like, the resource lore that the other functions don't tell you about. ✨

---

🦋 SYNOPSIS 🦋

#include <Xm/Xm.h>
Cardinal XmGetSecondaryResourceData(
WidgetClass widget_class,
XmSecondaryResourceData **secondary_data_return);

---

🌸 DESCRIPTION 🌸

okay so listen. some Motif widget classes — and yes, Gadget, Text, and VendorShell are the named girlies here — have resources that are just... not reachable through XtGetResourceList and XtGetConstraintResourceList. like they're behind a velvet rope. 🙈 and the way to get the descriptions of those resources? you have to use XmGetSecondaryResourceData. no other way, periodt.

so when a widget class has these kinds of resources, this function gives you descriptions of them in one or more data structures. it takes a widget class argument and returns the number of those data structures that are associated with the widget class. and if that return value is greater than 0 (zero), it goes ahead and allocates + fills an array of pointers to the corresponding data structures. that array? it comes back to you at the address that is the value of the secondary_data_return argument. slay. 💅

now the type XmSecondaryResourceData is a pointer to a structure with two members that are actually useful to an application:

• resources — of type XtResourceList. this is the list of the widget resources that you can't access using Xt functions.
• num_resources — of type Cardinal. this is the length of that resources list. 💫

and here's the important part, bestie, do not skip this: if the return value is greater than 0 (zero), XmGetSecondaryResourceData allocates memory that the application must free. that's on you, not on it. use XtFree to free:

• the resource list in each structure (aka the value of the resources member)
• the structures themselves
• and the array of pointers to the structures (the array whose address is secondary_data_return)

🫶 memory leak girlies, i'm looking at you. free all three. every time. no cap.

widget_class

specifies the widget class for which the secondary resource data is to be retrieved. tell it who you want the tea about. 🎀

secondary_data_return

specifies a pointer to an array of XmSecondaryResourceData pointers to be returned by this function. and if the widget class has no secondary resource data — for example, if the value returned by the function is 0 (zero) — then this function returns no meaningful value for this argument. so like, don't go reading it. there's nothing there. 💀

---

🌈 RETURN 🌈

returns the number of secondary resource data structures associated with this widget class. that's it, that's the number. ✨

---

🧚 EXAMPLE 🧚

here's the moment you've been waiting for — this example uses XmGetSecondaryResourceData to print the names of the secondary resources of the Motif Text widget, and then frees the data that the function allocated. she cleans up after herself. iconic.

XmSecondaryResourceData * block_array;
Cardinal num_blocks, i, j;
if (num_blocks = XmGetSecondaryResourceData (xmTextWidgetClass,
                                             &block_array)) {
  for (i = 0; i < num_blocks; i++) {
    for (j = 0; j < block_array[i]->num_resources; j++) {
      printf("%s\n", block_array[i]->resources[j].resource_name);
    }
    XtFree((char*)block_array[i]->resources);
    XtFree((char*)block_array[i]);
  }
  XtFree((char*)block_array);
}

---

⭐ and that's the whole page, bestie. every flag, every member, every XtFree, every vibe. mwah. 💜

---

kisses from the XmGetSecond...esourceData(library call) page 💖 — that's the library call manual, and ngl there's no version or date printed down here to report, just the title and the manual name. so that's the sign-off: library call energy, no date given, still serving. 🎀🦋👑