dbm-store

Arguments: ndbm key content &key if-exists external-format

dbm-store stores a key/content pair into the database specified by ndbm (which was returned by a call to dbm-open). key can be a string or a usb8 vector. If key is a string, it will be internally converted to a usb8 array according to the external-format keyword argument (or, if not supplied, the default determined by dbm-open will be used). Likewise for content, if it is a string. If the key to be stored already exists, and:

• if-exists is nil, then dbm-store will return nil and the operation will not be performed.
• if-exists is :error, then an error will be generated.
• if-exists is :replace (the default), then the existing key will be replaced.

dbm-store returns t if a key was added or replaced.

See ndbm.htm for information on the NDBM facility.

Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.