[Back to Interface] [Prev] [Next]

DFSDwriteref/dswref

intn DFSDwriteref(char *filename, uint16 ref)

filename

IN:

Name of the HDF file

ref

IN:

Reference number for next add or put operation

Purpose

DFSDwriteref determines the reference number of the dataset to overwritten next by DFSDputdata or DFSDadddata, after checking for its existence.

Return value

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

Description

If a non-existent reference number is specified, an error code will be returned.

As this routine alters data in a destructive manner, DFSDwriteref should be used with caution.

FORTRAN

integer function dswref(filename, ref)

character*(*) filename

integer ref



[Back to Interface] [Prev] [Next]

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