hdf_set_value(3)

💖 hdf_set_value(3) 💖

okay so bestie, we're in util/neo_hdf.h territory today and this one is a certified banger. it's the one that sets the value of a named node. that's the whole vibe. let's get into it 🫶

✨ NAME ✨

hdf_set_value — Set the value of a named node

like. that's it. that's the job. slay.

🌸 SYNOPSIS 🌸

#include <util/neo_hdf.h>

NEOERR* hdf_set_value (HDF *hdf, const char *name, const char *value);

🎀 ARGUMENTS 🎀

• hdf — the pointer to the hdf dataset. this is your main character, your dataset, the whole reason we're here 💅
• name — the named node to walk to. you're giving it directions and it will follow them.
• value — the value to set the node to. the moment. the reveal. the glow-up ✨

🦋 DESCRIPTION 🦋

okay so here's the tea ☕ — hdf_set_value will set the value of a named node. simple concept, iconic execution.

all of the interstitial nodes which don't exist will be created with a value of NULL. so like, if the path ain't there yet, it builds it for you. no cap, it just does it 🙈

existing nodes are not modified. hands off. we don't touch what's already thriving.

new nodes are created at the end of the list. no cutting the line, bestie, we queue politely.

and here's the lowkey important part: if a list of nodes exceeds FORCE_HASH_AT, then a HASH will be created at that level and all of the nodes will be added to the hash for faster lookup times. it's giving ✨optimization✨ — glow-up via data structure. iykyk.

also, the copy of the value will be made which the dataset will own. so you don't gotta worry about who's holding the memory, the dataset claims it, periodt 👑

💀 RETURN VALUE 💀

None. literally nothing comes back. it's a void situation. no return value, no drama, just vibes and side effects 💖

🔥 SEE ALSO 🔥

the whole friend group, fr fr:

hdf_set_symlink(3), hdf_get_valuef(3), compareFunc)(3), hdf_dump_str(3), hdf_get_int_value(3), hdf_read_string_ignore(3), hdf_copy(3), hdf_get_node(3), hdf_set_value(3), hdf_obj_child(3), hdf_read_string(3), hdf_set_buf(3), hdf_register_fileload(3), hdf_get_obj(3), hdf_get_attr(3), hdf_obj_top(3), hdf_dump_format(3), hdf_destroy(3), hdf_init(3), hdf_obj_value(3), hdf_write_string(3), hdf_set_valuevf(3), hdf_sort_obj(3), hdf_write_file_atomic(3), hdf_obj_attr(3), hdf_set_valuef(3), hdf_get_copy(3), hdf_write_file(3), hdf_get_valuevf(3), hdf_set_int_value(3), hdf_dump(3), hdf_get_value(3), hdf_set_copy(3), hdf_obj_next(3), hdf_search_path(3), hdf_obj_name(3), hdf_set_attr(3), hdf_get_child(3), hdf_remove_tree

(yes, compareFunc)(3) is really written like that in the original. iconic typo behavior, we keep it exactly as-is, no notes 🎀)

and that's the page, bestie!! brought to you by ClearSilver 🌈 and dated 12 July 2007 🩷 — the manual name is util/neo_hdf.h, in case you forgot where we were this whole time. love that for us. go set some values. mwah 💋