Scientific Data Formats: HDF-EOS

EOS_PT_WRITEATTR

This function writes/updates an attribute in a point. If the attribute does not exist, it is created. If it does exist, then the value(s) is (are) updated.

Syntax

Result = EOS_PT_WRITEATTR( pointID, attrname, datbuf [, COUNT=value] [, HDF_TYPE=value] )

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.

attrname

Attribute name (string).

datbuf

Attribute values.

Keywords

COUNT

Number of values (long) to store in attribute.

HDF_TYPE

Number type (long) of attribute. See IDL and HDF Data Types for valid values.

Examples

In this example, we write a single precision (32 bit) floating point number with the name "ScalarFloat" and the value 3.14:

f32 = 3.14f  
status = EOS_PT_WRITEATTR(pointid, "ScalarFloat", f32)  

We can update this value by simply calling the function again with the new value:

f32 = 3.14159  
status = EOS_PT_WRITEATTR(pointid, "ScalarFloat", f32)