Queries/sets property list modifiability¶
ss_prop_modifiable
is a function defined in ssprop.c.
Synopsis:
-
htri_t
ss_prop_modifiable
(ss_prop_t *prop, htri_t new_value)¶
Description: Queries and/or sets whether the property list is modifiable. That is, whether property values can be changed.
If new_value
is negative then the modifiability status remains unchanged, otherwise it is set to the new
value. Once a property list is marked as not modifiable it cannot be later marked as modifiable.
Return Value: Returns true (positive) if the property list was modifiable before this call, false otherwise. Returns negative on failure. It is an error to attempt to make a non-modifiable property list modifiable.
Parallel Notes: Independent
See Also:
- Properties: Introduction for current chapter