NAME¶
mplist_put - Set the value of a property in a property list.
SYNOPSIS¶
MPlist*
mplist_put (
MPlist *
plist,
MSymbol
key, void *
val)
DESCRIPTION¶
Set the value of a property in a property list. The mplist_put() function
searches property list plist from the beginning for a property whose key is
key
. If such a property is found, its value is changed to value
. Otherwise, a new property whose key is key and value is value is
appended at the end of plist
. See the documentation of mplist_add()
for the restriction on key and val
.
If key is a managing key, val must be a managed object. In this case, the
reference count of the old value, if not NULL
, is decremented by one,
and that of val is incremented by one.
RETURN VALUE¶
If the operation was successful, mplist_put()
returns a sublist of plist whose first element is the just modified or added
one. Otherwise, it returns NULL .
COPYRIGHT¶
Copyright (C) 2001 Information-technology Promotion Agency (IPA)
Copyright (C) 2001-2011 National Institute of Advanced Industrial Science and
Technology (AIST)
Permission is granted to copy, distribute and/or modify this document under the
terms of the GNU Free Documentation License
<
http://www.gnu.org/licenses/fdl.html>.