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

ANannlen/afannlen

int32 ANannlen(int32 ann_id)
ann_id

IN:

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/09/97, NCSA HDF Development Group.