vf_write_file(3)

💾 vf_write_file — okay so this is vf_write_file(3) from the Library Functions Manual and she is THAT girl

bestie. sit down. we're writing a vobject to a file and honestly? it's giving main character energy. this is vf_write_file, from the <../vformat/vf_iface.h> cinematic universe, and she's here to make your phonebook data go from "in memory" to "on disk". periodt. 💖

---

✨ SYNOPSIS ✨

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

extern bool_t vf_write_file
(
     const char *p_name,
     VF_OBJECT_T *p_object,
     bool_t write_all
);

look at her. three little arguments. so demure, so mindful. 🎀

---

🌸 PARAMETERS 🌸

• const char *p_name — the output filename. literally just where you want the good stuff to land. your girl is outpt — yes bestie, the original says "Outpt", we're keeping it, don't @ me. 💅
• VF_OBJECT_T *p_object — the object you wanna write. the actual vobject. the star of the show. 👑
• bool_t write_all — should we write p_next as well?? like, do you want the whole squad or just the head item?? your call, queen. 🦋

---

💜 DESCRIPTION 💜

So here's the tea. This function writes the indicated vobject to a file. simple. clean. iconic. ✨

But wait, there's lore. If you're dealing with a list of objects (eg. stuff Read from a phonebook 👀), the write_all parameter is your bestie-in-chief. It lets the caller control whether the library writes the entire list or just the head item. that's it. that's the whole vibe check. no cap. 💖

---

🔥 RETURNS 🔥

TRUE <=> written OK, FALSE else.

so like… if it worked, TRUE. if it didn't, FALSE. and also everything else that isn't TRUE, which is also FALSE. iykyk. 😭💀

---

🫶 SEE ALSO 🫶

the whole friend group, fr fr — go say hi:

vf_parse_init(3), vf_parse_text(3), vf_parse_end(3), vf_read_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_get_prop_name_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)

---

ngl, that SEE ALSO list is a whole group chat and every single one of them is typing. 🌈

---

🧚 cute sign-off 🧚

this lil' page was conjured up by c2man from vf_iface.h, dated 30 April 2003 — so yes, she's an elder icon but she still eats. 💅✨ no cap, stan forever, bye bestie! 🎀💖🦋