hdf_destroy(3) [debian man page]

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

NAME

       hdf_destroy  - deallocate an HDF data set

SYNOPSIS

       #include <util/neo_hdf.h>

       void hdf_destroy (HDF **hdf);

ARGUMENTS

       hdf - pointer to an HDF data set allocated with hdf_init

DESCRIPTION

       hdf_destroy  is	used  to  deallocate all memory associated with an hdf data set.  Although you can pass an HDF node as an argument to this
       function, you are likely to cause a segfault if you continue to access the data set.  In the future, we may restrict hdf_destroy so it only
       works on the top level node.

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_destroy(3)

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

NAME

       hdf_sort_obj  - sort the children of an HDF node

SYNOPSIS

       #include <util/neo_hdf.h>

       hdf_sort_obj()

ARGUMENTS

       h - HDF node
       compareFunc - function which returns 1,0,-1 depending on some
       criteria.  The arguments to this sort function
       are pointers to pointers to HDF elements.  For
       example:
       int sortByName(const void *a, const void *b) {
       HDF **ha = (HDF **)a;
       HDF **hb = (HDF **)b;
       *
       return strcasecmp(hdf_obj_name(*ha), hdf_obj_name(*hb));
       }
       *

DESCRIPTION

       hdf_sort_obj  will  sort  the children of an HDF node, based on the given comparison function.  This function works by creating an array of
       the pointers for each child object of h, using qsort to sort that array, and then re-ordering the linked list of children to the new order.
       The  qsort  compare  function uses a pointer to the value in the array, which in our case is a pointer to an HDF struct, so your comparison
       function should work on HDF ** pointers.

RETURN VALUE

       None (h children will be sorted)

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_sort_obj(3)