vf_get_prop_name_string(3)

💖 vf_get_prop_name_string 💖

okay bestie, gather round, because we're talking about vf_get_prop_name_string(3) from the Library Functions Manual, and she is lowkey iconic ✨

---

🌸 NAME 🌸

vf_get_prop_name_string — literally vf_get_prop_name_string(), that's the whole vibe 🫶

---

✨ SYNOPSIS ✨

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

extern char *vf_get_prop_name_string
(
     VF_PROP_T *p_prop,
     uint32_t n_string
);

yes she's an extern char * function and yes she takes two args, no cap 💅

---

🎀 PARAMETERS 🎀

• VF_PROP_T *p_prop — the property you want to go locate a string from. this is the thing we're snooping through 🔍
• uint32_t n_string — the index of the string you want. like, which one. the n'th one. girlypop picks her fighter 🌈

---

💜 DESCRIPTION 💜

so basically she gets the n'th name string. periodt.

for example, a property might be defined like this, and I need you to look at it very carefully because it's about to make everything click:

THING;THIS=STUFF;WITH-QUALIFIERS:fred-fred-fred;gogogo;baabaabaa

so if you call vf_get_prop_name_string() and specify n_string=2, she hands you back a pointer to the WITH-QUALIFIERS value. ate. 🔥

and if you go asking for something out of range? she returns NULL. like, she's not gonna manifest a string that doesn't exist. example: N_string=4 for X;A;B;C:foo → you get NULL, bestie, sorry 😭

out-of-range requests are not it. she will simply return NULL and move on with her life 💀

---

⭐ RETURNS ⭐

• pointer to the string value if the value is present 🫶
• NULL if the index is too large 🙈

---

🦋 SEE ALSO 🦋

vf_parse_init(3), vf_parse_text(3), vf_parse_end(3), vf_read_file(3), vf_write_file(3), vf_get_next_object(3), vf_create_object(3), vf_get_object_type(3), vf_get_property(3), vf_get_property_ex(3), vf_get_next_property(3), vf_get_prop_value(3), vf_set_prop_value(3), vf_get_prop_value_string(3), vf_set_prop_name_string(3), vf_get_prop_name(3), vf_get_prop_value_object(3), vf_set_prop_value_object(3), vf_set_prop_value_string(3), vf_set_prop_value_base64(3), vf_get_prop_value_base64(3), vf_set_property_from_file(3), vf_delete_object(3), vf_delete_prop(3), vf_find_prop_qual_index(3), vf_is_modified(3), vf_find_charset(3), vf_date_string_to_time(3), vf_period_string_to_time(3), vf_period_time_to_string(3), vf_set_prop_value_time(3), vf_get_prop_value_time(3)

the whole friend group fr fr, go say hi to all of them 👑💖

---

okay and finally, the lil sign-off: this page was made by c2man from vf_iface.h, dated 30 April 2003 — vintage but make it fashion 💅🦋