ANannlen/afannlen

Annotation identifier returned by ANcreate, ANcreatef, or ANselect

Purpose

Returns the length, in bytes, of the annotation specified by the given annotation identifier.

Return Value

Returns the length of the target annotation or FAIL (or -1) otherwise.

Description

A common use of ANannlen is to determine if a buffer is large enough to contain the entire target annotation.

Example

This example illustrates the use of ANannlen:

     #include "hdf.h"

     int32 an_id, ann_id, file_id, ann_len, stat;

     file_id = Hopen("myfile", DFACC_READ, 0);
     an_id = ANstart(file_id);
     ann_id = ANselect(an_id, index, annot_type);
     ann_len = ANannlen(ann_id);
       ...
     stat = ANendaccess(ann_id);
     stat = ANend(an_id);
     Hclose(file_id);
     
 


 FORTRAN

 integer function afannlen(ann_id)


 

 integer ann_id

[Top] [Prev] [Next] [Bottom]

hdfhelp@ncsa.uiuc.edu

HDF User's Reference Manual, Draft 06/01/97, NCSA HDF Development Group.

Purpose	Returns the length, in bytes, of the annotation specified by the given annotation identifier.
Return Value	Returns the length of the target annotation or FAIL (or -1) otherwise.
Description	A common use of ANannlen is to determine if a buffer is large enough to contain the entire target annotation.
Example	This example illustrates the use of ANannlen: