hdf_set_symlink(3)						  util/neo_hdf.h						hdf_set_symlink(3)

NAME

       hdf_set_symlink	- Set part of the tree to link to another

SYNOPSIS

       #include <util/neo_hdf.h>

       NEOERR *hdf_set_symlink (HDF *hdf, const char *src, const char *dest);

ARGUMENTS

       hdf -> the dataset node
       src -> the source node name
       dest -> the destination node name (from the top of the
       dataset, not relative names)

DESCRIPTION

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

RETURN VALUE

       None

SEE ALSO

       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_val-
       uevf(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_val-
       uevf(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

ClearSilver							   12 July 2007 						hdf_set_symlink(3)