[Back to Interface] [Prev] [Next]

ANfileinfo/affileinfo

intn ANfileinfo(int32 an_id, int32 *n_file_labels, int32 *n_file_descs, int32 *n_data_labels, int32 *n_data_descs)

an_id IN:

AN interface identifier returned by ANstart

n_file_labels OUT:

Number of file labels

n_file_descs OUT:

Number of file descriptions

n_data_labels OUT:

Number of data labels

n_data_descs OUT:

Number of data descriptions

Purpose

Retrieves the number of annotations of each type in a file.

Return value

Returns SUCCEED (or 0) if successful or FAIL (or -1) otherwise.

Description

ANfileinfo retrieves the total number of the four kinds of annotations and stores them in the appropriate parameters. The total number of data labels of all data objects in the file is stored in n_data_labels. The total number of data descriptions of all data objects in the file is stored in n_data_descs. The total number of file labels is stored in n_file_labels and the total number of file descriptions in n_file_descs.

Note that the numbers of data labels and descriptions refer to the total number of data labels and data descriptions in the file, not for a specific object. Use ANnumann to determine these numbers for a specific object.

This routine is generally used to find the range of acceptable indices for ANselect calls.

FORTRAN

integer function affileinfo(an_id, n_file_labels, n_file_descs, n_data_labels, n_data_descs)

integer an_id, n_file_labels, n_file_descs

integer n_data_labels, n_data_descs



[Back to Interface] [Prev] [Next]

hdfhelp@ncsa.uiuc.edu
HDF Reference Manual - 07/29/98, NCSA HDF Development Group.