XtGetSubresources(3)

💖 XtGetSubresources(3) — XT FUNCTIONS 💖

okay bestie, gather round, because we're doing subresources today and honestly? it's giving ✨organized✨. this is part of the X Toolkit Intrinsics crew, and it's here to fetch subresources for you, no cap.

---

🌸 NAME 🌸

XtGetSubresources, XtVaGetSubresources — obtain subresources 🫶

---

✨ SYNTAX ✨

#include <X11/Intrinsic.h>

void XtGetSubresources(Widget w, XtPointer base, const char *name, const
       char * class, XtResourceList resources, Cardinal num_resources,
       ArgList args, Cardinal num_args);

void XtVaGetSubresources(Widget w, XtPointer base, const char *name,
       const char *class, XtResourceList resources, Cardinal
       num_resources, ...);

---

🎀 ARGUMENTS 🎀

• args — the argument list that overrides whatever resources came out of the resource database. it's the "actually, no, use this" list 💅
• base — the base address of the subpart data structure, aka where the resources get written. this is the drop-off spot, bestie 📍
• class — the class of the subpart.
• name — the name of the subpart.
• num_args — how many arguments are in that argument list.
• num_resources — how many resources are in the resource list.
• resources — the resource list for the subpart.
• w — the widget that wants resources for a subpart, or that identifies the resource database to search 👑
• ... — the variable arguments that override resources obtained from the resource database.

---

💜 DESCRIPTION 💜

so XtGetSubresources builds a name/class list, right? it constructs it from the application name/class, then the name/classes of all its ancestors, and then the widget itself. iconic lineage behavior fr fr 🌈

then it appends the name/class pair you passed in to that list. and then — the main character moment — the resources are fetched from the argument list, the resource database, or the default values in the resource list. after that they get copied into the subpart record. that's the whole glow-up 🦋

⚠️ one little thing, no cap: if args is NULL, then num_args must be zero. but flip side — if num_args is zero, the argument list is not referenced at all. so like... it's fine, it's just not looking at it 💀

---

🔥 SEE ALSO 🔥

• XtGetApplicationResources, XtVaGetApplicationResources
• X Toolkit Intrinsics - C Language Interface
• Xlib - C Language X Interface

---

and that's the page, bestie!! this one's from X Version 11, libXt 1.3.1, and it's the XtGetSubresources(3) page — so if you ever forget, just remember: subresources obtained, vibes immaculate, periodt 💅✨🎀