hdf_get_copy(3)

🌸 hdf_get_copy(3) 🌸

okay bestie, welcome to the manual page for hdf_get_copy(3) — yes that's the whole title, we're keeping it, it's giving ✨ documentation ✨

💖 NAME 💖

hdf_get_copy — returns a copy of a string in the HDF data set 🫶

like. it copies the string. that's the whole job. and it SLAYED at it.

✨ SYNOPSIS ✨

#include <util/neo_hdf.h>

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

🎀 ARGUMENTS 🎀

• hdf — the dataset node you're starting from, like your home base, your origin story 💅
• name — the name to walk the data set to. yes queen, we're walking, it's a whole journey 🌈
• defval — the default value to return if the node doesn't exist 🥺 (the safety net. the backup bestie. the "if he doesn't text back" plan)

🦋 DESCRIPTION 🦋

okay so hdf_get_copy is similar to hdf_get_value, except — and this is the part that matters, no cap — it returns an malloc'd copy of the string 💖

not the string itself. a copy. a whole new string that is yours, that you own, that you can do whatever you want with. main character energy fr fr 👑

💅 RETURN VALUE 💅

• value — the allocated string (if defval = NULL, then value will be NULL if defval is used) 🫠

like. read that again bestie. if defval is NULL, and defval gets used, then value is NULL. it's giving "the absence of the fallback is itself the fallback." iconic. confusing. both. 😭

🌟 SEE ALSO 🌟

the whole group chat, assembled 🫶 every single one, in order, no one left behind:

• 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 hdf_get_copy(3) is in its own SEE ALSO list. self-love. we support it. 💜)

🎀 and that's the page bestie! go forth and copy those strings, and remember to free them — that's not in this manpage but like, iykyk 🙈

ClearSilver 🌈 12 July 2007 — mwah, that's the source, the version, and the date, all wrapped up in a little bow for you 🎀💖 bye pookie, love u, see u in the next manpage ✨