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