hdf_sort_obj(3) [debian man page]
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)
Check Out this Related Man Page
HDP(1) General Commands Manual HDP(1) NAME
hdp - display general information about the contents of an HDF file SYNOPSIS
hdp [-H command] hdf-file DESCRIPTION
hdp provides quick and general information about all objects in the specified HDF file. It can list the contents of HDF files at various levels with different details. It can also dump the data of one or more specific objects in the file. Like hdfed, hdp provides a set of commands that allow the user to determine what kind of information is to be displayed. The commands are documented in /usr/share/doc/libhdf4g/html-userguide/Utils14.html. OPTIONS
-H [command] Display usage information about the specified command. If no command is listed, information about all commands is displayed. COMMANDS
list Displays the contents of the HDF files in the specified format. dumpsds Displays the contents of the SDSs in the listed files. dumpvd Displays the contents of the vdata objects in the listed files. dumpvg Displays the contents of the vgroup objects in the listed files. dumprig Displays the contents of the RIGs in the listed files. COMMAND DETAILS
list displays the contents of the HDF files in the specified format. As with the 'info' command, the listing for special elements will contain a special tag value (for DFTAG_VS it's 18347) and the text "Unknown Tag". The list command has the following syntax: list [-s|-l|-d] [-n|-c|-a] [-g|-t number-or-name] [-ot|-of|-og|-on] message The list command accepts these options: -s Short format. -l Long format. -d Debug format. -n Display the object name. -c Display the object class. -a Display the object description. -g Display groups only. -t number-or-name Display objects with the specified tag number or name. -ot Sort by tag. -of Sort by position in the data descriptor list. -og Sort by group. -on Sort by name. dumpsds displays SDS information in the specified format. The dumpsds command has the following syntax: dumpsds [-i index | -r ref-list | -n name-list | -a] [-v|-h|-d] [-o filename | -b | -t] dumpsds accepts these options: -i index Dump SDSs with the specified index. -r ref-list Dump SDSs with the specified reference numbers. -n name-list Dump SDSs with the specified names. -a Dump all SDSs. -v Display all SDS contents including annotations. -h Display the SDS header only. -d Display the SDS data only. -o outfile Print information to the specified file. -b Specify output file as binary. -t Specify output file as text. dumpvd displays vdata information in the specified format. The dumpvd command has this syntax: dumpvd [-i index | -r ref-list | -n name-list | -c class | [-a] [-v|-h|-f|-d] [-o filename | -b | -t] dumpvd accepts these options: -i index Dump vdatas with the specified index. -r ref-list Dump vdatas with the specified reference numbers. -c class Dump vdatas with the specified class. -n name-list Dump vdatas with the specified names. -a Dump all vdatas. -v Display all vdata contents including annotations. -h Display the vdata header only. -d Display the vdata data only. -f Display the vdata field data only. -o outfile Print information to the specified file. -b Specify output file as binary. -t Specify output file as text. dumpvg displays vgroup information in the specified format. dumpvg command has this syntax: dumpvg [-i index | -r ref-list | -n name-list | -c class | [-a] [-v|-h|-d] [-o filename | -b | -t] dumpvg accepts these options: -i index Dump vgroups with the specified index. -r ref-list Dump vgroups with the specified reference numbers. -c class Dump vgroups with the specified class. -n name-list Dump vgroups with the specified names. -a Dump all vgroups. -v Display all vgroup contents including annotations. -h Display the vgroup header only. -d Display the vgroup data only. -o outfile Print information to the specified file. -b Specify output file as binary. -t Specify output file as text. dumprig displays RIG information in the specified format. dumprig command has this syntax: dumprig [-i index | -r ref-list | -m <8, 24> | [-a] [-v|-h|-d] [-o filename | -b | -t] dumprig accepts these options: -i index Dump RIGs with the specified index. -r ref-list Dump RIGs with the specified reference numbers. -m data-length Dump RIGs with the specified data length: 8- or 24-bit. -a Dump all RIGs. -v Display RIG contents including annotations. -h Display the RIG header only. -d Display the RIG data only. -o outfile Print information to the specified file. -b Specify output file as binary. -t Specify output file as text. SEE ALSO
hdfed(1), hdf(5), /usr/share/doc/libhdf4g/html-userguide/Utils14.html. November 6, 1999 HDP(1)