vf_get_property_ex(3)

📦 version 1.13, in debian bookworm, ubuntu jammy, ubuntu noble

💖 vf_get_property_ex(3) 💖

okay bestie, gather round, because we're reading a page out of the Library Functions Manual and it's literally all about vf_get_property_ex ✨

🌸 NAME 🌸

vf_get_property_ex — vf_get_property_ex() 🫶 (yes the name is the name, we love a self-titled icon)

🎀 SYNOPSIS 🎀

#include <../vformat/vf_iface.h>

extern bool_t vf_get_property_ex
(
     VF_PROP_T **pp_prop,
     VF_OBJECT_T *p_object,
     vf_get_t ops,
     const char *p_group,
     const char *p_name,
     const char *p_qualifier,
     char args
);

like look at that signature. she's serving parameters. 💅

✨ PARAMETERS ✨

  • VF_PROP_T **pp_prop — the output pointer, aka where the goods get dropped off 💖
  • VF_OBJECT_T *p_object — the object we're searching through, our little hunting ground 🔍
  • vf_get_t ops — the search flags, your vibe settings for the hunt ⚙️
  • const char *p_group — group name, if there even is one (optional queen behavior) 👑
  • const char *p_name — name of tag, the thing you're actually looking for 🏷️
  • const char *p_qualifier — first qualifier, if any (again, optional, she's flexible) ✨
  • char args — the argument list 📋

🌈 DESCRIPTION 🌈

so this function is the grunt behind vf_get_property() — the backstage crew, the ones doing the actual lifting while the main character gets the credit 😭

she manages the search exactly as described by vf_get_property(), but with one lil twist: she takes the list of arguments as a va_list. no cap. 🫶

and bestie, that's the whole point — you're supposed to use this function when you're writing higher layer functions that themselves take varargs (eg. DDX functions). it's giving helper-for-a-helper energy and honestly? iconic. 💅✨

💀 RETURNS 💀

  • TRUE iff found/added successfully — like, and only if, fr fr 🎯
  • and the pointer to the prop comes back at you via pp_prop 📬

🦋 SEE ALSO 🦋

the whole friend group, and yes we're listing every single one because nobody gets left out in this house 💜

and that's the whole page, bestie!! 🎀✨

this lil masterpiece was generated by c2man from vf_iface.h, and she was born on 30 April 2003 — a true vintage queen who has aged flawlessly, and yes, this whole thing is page vf_get_property_ex(3). periodt. 💅🫶💖

📦 where this page comes from