This function writes (appends) full records to a level. The data in each record must be packed. Refer to the section on Vdatas in the HDF documentation. The input data buffer must be sufficient to fill the number of records designated.

Examples


In this example, we write 5 records to the first level in the point referred to by the point id, pointID1:

status = EOS_PT_WRITELEVEL(pointID1, 0, 5, datbuf)

Syntax


Result = EOS_PT_WRITELEVEL(pointID, level, nrec, data)

Return Value


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

Arguments


pointID

Point id (long) returned by EOS_PT_CREATE or EOS_PT_ATTACH.

level

Level to write (0-based long).

nrec

Number of records (long) to write.

data

Values to be written to the field. Data values are not converted to the internal HDF type automatically. Use HDF_PACKDATA if conversion is necessary or the data fields specify multiple types.

Version History


5.2

Introduced