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

ANwriteann/afwriteann

intn ANwriteann(int32 ann_id, char* label, int32 ann_length)

ann_id	IN:	Annotation identifier returned by ANcreate, ANcreatef or ANselect
label	IN:	Text to be written to the annotation
ann_length	IN:	Length, in bytes, of the annotation text pointed to by label

HDF Users Guide v4.1r1
Purpose

Writes an annotation to the current HDF file.

Return value

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

Description

ANwriteann will overwrite any preexisting annotation containing the text identified by label.

Example

This example illustrates the use of ANwriteann:

HDF Users Guide v4.1r1
Purpose	Writes an annotation to the current HDF file.
Return value	Returns SUCCEED (or 0) if successful and FAIL (or -1) otherwise.
Description	ANwriteann will overwrite any preexisting annotation containing the text identified by label.
Example	This example illustrates the use of ANwriteann:

#include "hdf.h"

int32 an_id, stat;
char *label = "This is annotation text.";

file_id = Hopen("myfile", DFACC_WRITE, 0);
an_id = ANstart(file_id);
ann_id = ANcreate(an_id, tag, ref, type);
       ...
stat = ANwriteann(ann_id, label, sizeof(label));
       ...
stat = ANendaccess(ann_id);
stat = ANend(an_id);
Hclose(file_id);
     

 FORTRAN	integer function afwriteann(ann_id, label, ann_length)

 


 	integer ann_id, ann_length


 	character* (*) label

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

hdfhelp@ncsa.uiuc.edu

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