hdf_copy(3)

💖 hdf_copy — from the util/neo_hdf.h girlies, manual section 3 💖

okay bestie, sit down, hydrate, and let me tell you about the single most underrated little function in the whole HDF universe: hdf_copy. yes it's a section 3 manual page, yes it lives in util/neo_hdf.h, and yes it is lowkey doing the most while acting like it's doing nothing. let's get into it. 🦋

✨ NAME ✨

hdf_copy — copy part of an HDF dataset to another. that's it. that's the whole vibe. copy part. to another. slay.

🌸 SYNOPSIS 🌸

#include <util/neo_hdf.h>

NEOERR* hdf_copy (HDF *dest_hdf, const char *name, HDF *src);

look at her. three args, returns a NEOERR*. no notes. 👑

🎀 ARGUMENTS 🎀

• dest_hdf — the destination dataset. this is where the copy is gonna live, like moving into a new apartment. 🏠
• name — the name of the destination node. it's the little name tag for where the copied tree lands. 🏷️
• src — the hdf dataset to copy to the destination. the source of truth, the origin story, the one being duplicated. 📋

💅 DESCRIPTION 💅

okay so the tea is: hdf_copy is a deep copy of an HDF tree pointed to by src to the named node of dest.

the way that it's deep means it's not just a shallow little link situation — it's the whole tree, all the way down. no shortcuts, no "we'll do the children later", it is committing. periodt. 💅

and the plot twist that makes her iconic: dest and src need not be part of the same data set. they can be total strangers, different trees, different vibes entirely. she does not care. she copies anyway. 🫶

🔥 RETURN VALUE 🔥

None.

literally none. she returns None in the docs, and the function signature says NEOERR*. that's the energy. don't ask, just check your NEOERR. 😭

🌈 SEE ALSO 🌈

the whole friend group, in the order the original gave them, no cap:

• 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

and that's the page, bestie. this one came from ClearSilver, dated 12 July 2007, and it's manual section 3, page hdf_copy(3) — so go forth, deep copy responsibly, and remember: dest and src don't even have to know each other. iconic behavior fr fr. 💖✨