NAME

       mplist_get - Get the value of a property in a property list.

SYNOPSIS

       void* mplist_get (MPlist * plist, MSymbol key)

DESCRIPTION

       Get the value of a property in a property list. The mplist_get() function searches property list plist
       from the beginning for a property whose key is key.  If such a property is found, its value is returned
       as the type of (void *).  If not found, NULL is returned.

       When NULL is returned, there are two possibilities: one is the case where no property is found (see
       above); the other is the case where a property is found and its value is NULL.  In case that these two
       cases must be distinguished, use the mplist_find_by_key() function.

SEE ALSO

           mplist_find_by_key()

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_get(3m17n)