Property constructor

ss_prop_cons is a function defined in ssprop.c.

Synopsis:

ss_prop_t * ss_prop_cons(hid_t type, void *values, const char *name)

Formal Arguments:

  • type: Property datatype (copied by this function)
  • values: Optional initial values, of type type
  • name: Optional property list name

Description: Construct a property from a datatype and optional memory. The datatype must be an HDF5 compound datatype and the memory must match that datatype. If a values buffer is supplied then the property list will be marked as non-appendable (new properties cannot be added) but modifiable (property values can be changed) and the ss_prop_dest function will not free the memory. But if values is null then a buffer will be allocated and initialized to zeros.

Return Value: Returns a new property list on success; null on failure.

Parallel Notes: Independent

See Also: