debian man page for mplist_put

mplist_put(3m17n)						 The m17n Library						 mplist_put(3m17n)

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>.

Version 1.6.2							    12 Jan 2011 						 mplist_put(3m17n)