Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages
mplist_put(3m17n) Version 1.5.5 mplist_put(3m17n)

mplist_put - Set the value of a property in a property list.

MPlist* mplist_put (MPlist * plist, MSymbol key, void * val)

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.

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 (C) 2001 Information-technology Promotion Agency (IPA)
Copyright (C) 2001-2009 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 <>.
15 Oct 2009

Search for    or go to Top of page |  Section other |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.