1hdf_set_symlink(3)              util/neo_hdf.h              hdf_set_symlink(3)
2
3
4

NAME

6       hdf_set_symlink  - Set part of the tree to link to another
7

SYNOPSIS

9       #include <util/neo_hdf.h>
10
11
12       NEOERR *hdf_set_symlink (HDF *hdf, const char *src, const char *dest);
13
14
15
16

ARGUMENTS

18       hdf -> the dataset node
19       src -> the source node name
20       dest -> the destination node name (from the top of the
21       dataset, not relative names)
22
23

DESCRIPTION

25       hdf_set_symlink  creates a link between two sections of an HDF dataset.
26       The link is "by name" hence the term "symlink".  This  means  that  the
27       destination  node  does  not  need to exist.  Any attempt to access the
28       source node will cause the function to walk to the dest node, and  then
29       continue  walking  from there.  Using symlinks can "hide" values in the
30       dataset since you won't be able to access any children  of  the  linked
31       node  directly,  though  dumps  and  other things which access the data
32       structure directly will bypass the symlink.  Use this feature sparingly
33       as its likely to surprise you.
34
35

RETURN VALUE

37       None
38
39

SEE ALSO

41       hdf_set_symlink(3),         hdf_get_valuef(3),         compareFunc)(3),
42       hdf_read_string(3),  hdf_obj_value(3),  hdf_get_node(3),   hdf_set_val‐
43       uevf(3),  hdf_sort_obj(3),  hdf_write_file_atomic(3),  hdf_obj_attr(3),
44       hdf_set_valuef(3),         hdf_search_path(3),         hdf_set_attr(3),
45       hdf_dump_str(3),    hdf_get_int_value(3),    hdf_read_string_ignore(3),
46       hdf_get_copy(3),  hdf_copy(3),  hdf_write_file(3),  hdf_get_valuevf(3),
47       hdf_set_value(3),  hdf_set_int_value(3), hdf_dump(3), hdf_get_value(3),
48       hdf_set_copy(3),  hdf_obj_child(3),  hdf_obj_next(3),   hdf_set_buf(3),
49       hdf_write_string(3),    hdf_get_obj(3),   hdf_get_attr(3),   hdf_regis‐
50       ter_fileload(3), hdf_obj_name(3),  hdf_obj_top(3),  hdf_dump_format(3),
51       hdf_get_child(3), hdf_destroy(3), hdf_remove_tree(3), hdf_init
52
53
54
55ClearSilver                    14 November 2006             hdf_set_symlink(3)
Impressum