Routines (alphabetical) > Routines: H > HDF-EOS Routines > EOS_PT_WRITELEVEL

# EOS_PT_WRITELEVEL

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