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 typetype
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:
- ss_prop_dest: 6.4: Destroy a property list
- Properties: Introduction for current chapter