NAME

       msymbol_put - Set the value of a symbol property.

SYNOPSIS

       int msymbol_put (MSymbol symbol, MSymbol key, void * val)

DESCRIPTION

       Set the value of a symbol property. The msymbol_put() function assigns val to the value of
       the symbol property that belongs to symbol and whose key is key.  If the symbol property
       already has a value, val overwrites the old one. Both symbol and key must not be Mnil.

       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, msymbol_put() returns 0. Otherwise it returns -1 and
           assigns an error code to the external variable merror_code.

ERRORS

           MERROR_SYMBOL

SEE ALSO

           msymbol_get()

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