dbm-fetch

Arguments: ndbm key &key external-format if-does-not-exist return

dbm-fetch retrieves content from the database specified by ndbm (which should be a value returned by dbm-open). key is used to locate the data. 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). If the key does not exist in the database and:

• if-does-not-exist is nil (the default), then dbm-fetch returns nil.
• if-does-not-exist is :error, then dbm-fetch signals an error.

If the key is found, then dbm-fetch returns the corresponding data. If the return keyword argument is :string, then the data will be converted to a string according to the external-format keyword argument (or the default determined by dbm-open). If return is :usb8, the the data will be returned as a usb8 array. If return is not specified, then the data will be returned in whatever format was specified as the default to dbm-open.

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.