NAME

       mplist_put -

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