man mplist_get () - Get the value of a property in a property list.

NAME

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

SYNOPSIS

void* mplist_get (MPlist * plist, MSymbol key)

DESCRIPTION

The mplist_get() function searches property list plist from the beginning for a property whose key is key. If such a property is found, a pointer to 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()