Add new property to a list

ss_prop_add is a function defined in ssprop.c.

Synopsis:

herr_t ss_prop_add(ss_prop_t *prop, const char *name, hid_t type, const void *value)

Formal Arguments:

  • prop: property list to which is added a property
  • name: name of property to add
  • type: datatype for stored property value
  • value: optional initial property value

Description: A new property called name is added to property list prop. The new property can be given an initial value (or else all bits are cleared). If a value is specified it must be of type type, which is the datatype of the property as stored in the property list.

Return Value: Returns non-negative on success; negative on failure. It is an error to add a property to the list if a property by that name already exists in the list. Only appendable property lists can have new properties added.

See Also: