Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

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

HDFED(1)						      General Commands Manual							  HDFED(1)

NAME
hdfed - edit the contents of an HDF File SYNOPSIS
hdfed [-nobackup] [-batch] hdf_file DESCRIPTION
hdfed allows experienced HDF users to manipulate the elements of an HDF file. These manipulations include * Selecting groups and showing information about them. * Dumping group information to output files. * Writing group data to output files. * Deleting groups from HDF files. * Inserting groups in HDF files. * Replacing elements of HDF files. * Editing the labels and descriptions of any element in an HDF file. hdfed is designed primarily for users who need to know about HDF files at the level of individual data elements. It is not designed to pro- vide a comprehensive high-level view of the contents of an HDF file - other tools and utilities should be used for that purpose. To use hdfed one should be familiar with the components of an HDF file covered in the HDF Specifications manual. The hdfed utility is loosely modeled on ed(1), the UNIX line editor. When hdfed is invoked, it prompts the user for commands, as does ed. Also, basic command syntax and description information is available to the user through hdfed. The most common hdfed commands are used to control the position in the HDF file and the format of the information provided. The initial view of the file under hdfed consists of a set of tag/reference number pairs. Although hdfed allows modification of tags and reference numbers within strict constraints, it will not allow the user to arbitrarily modify binary data in the file. The following terms and concepts must be understood in order to use hdfed correctly and will be used in the following discussion about hdfed. * The data object or object refers to an HDF data object and the data descriptor of that object. (i.e., tags, reference numbers, off- sets, or lengths.) * The data or data element refers to the record that the data descriptor points to. For a precise definition of the data that is asso- ciated with a given tag consult the HDF Specifications and Developer's Guide v3.2 from the HDF WWW home page at http://hdf.ncsa.uiuc.edu/. * The group refers to a predefined collection of data objects that correspond to a particular application. For example, a raster image group refers to the collection of objects that are used to store all of the information in a raster image set. Once an HDF file has been opened by hdfed, the following operations can be performed on the data file, among others: * Select an HDF object to examine more closely. * Move forward or backward within the HDF file. * Get information about an object. (tag, reference number, size, label) * Display a raster image using the ICR protocol. * Display the contents of any object. * Delete an object. * Annotate an object with a label or description. * Write an object to a second HDF file. * Write data elements in binary form to a non-HDF file. * Close the file and exit, or open a new file. hdfed commands are documented in the Users Guide section on Command-line Utilities. OPTIONS
-nobackup Make no backup file. If this option is omitted, a backup file is automatically created. -batch Input to hdfed is a stream of hdfed commands, rather than interactively. The -batch flag is useful when a group of commonly-used commands are included in a UNIX shell script. The following is an example of such a script, using the C-shell, that lists informa- tion about the groups in a specified HDF file. #!/bin/csh -f set file=$1 shift hdfed -batch $file -nobackup << EOF info -all group $* close quit EOF echo "" -help Output usage information, as well as a quick list of the hdfedj commands. SEE ALSO
hdf(5), ed(1), The HDF Users Guide: /usr/share/doc/libhdf4g/html-userguide/Utils2.html#33. October 31, 1999 HDFED(1)
Man Page

Featured Tech Videos