Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 com-
     parison 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-or-
     dering  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_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

ClearSilver			  12 July 2007			 hdf_sort_obj(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=hdf_sort_obj&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help