EOS_PT_UPDATELEVEL

Syntax | Return Value | Arguments | Keywords | Examples | Version History

This function updates the specified fields and records of a single level.

Syntax

Result = EOS_PT_UPDATELEVEL(pointID, level, field, list, nrec, recs, 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 update (0-based long).

fieldlist

List of fields (string) to update.

nrec

Number of records (long) to update.

recs

Record number of records to update (0-based long).

data

Values to be written to the fields. 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.

Keywords

None

Examples

In this example, we update records 0, 2, and 3 in the Temperature and Mode fields in the second level in the point referred to by the point ID pointID. Temperature is a 4 value 32-bit float field and Mode is a 4 character field (HDF types 5 and 4 respectively):

recs = [ 0, 2, 3] 
dataTemperature = [ [20, 21, 22, 23], [30, 31, 32, 33], $ 
   [40, 41, 42, 43]]] 
dataMode = ['P', 'I', 'A'] 
buffer = HDF_PACKDATA(dataTemperature, dataMode, $ 
   HDF_TYPE = [5, 4], HDF_ORDER = [4, 4]) 
status = EOS_PT_UPDATELEVEL( pointID, 1, "Temperature,Mode", $ 
   3, recs, buffer) 

Version History