| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |
Arguments: filename &key if-exists if-does-not-exist default-return external-format mode store-null-terminators
dbm-open opens or creates an ndbm database. filename specifies the base filename for the database (notes on this below).
The keyword arguments are:
:append
(the default),
:overwrite
, or :supersede
.
:append
and :overwrite
are
synonymous and indicate that an existing database should be opened.
:supersede
means that any existing database should
be erased and a fresh database should be created.
:error
(the default) or :create
.
:error
means that an error will be generated if
the database does not exist. :create
means that a
fresh database will be created if one does not exist.
:string
(the default), then database data will be
converted to strings before being returned from dbm-fetch (unless the return type is
specified in the call to dbm-fetch). If
default-return is :usb8
, then
dbm-fetch will return
usb8 vectors (that is, (unsigned-byte 8) vectors) unless the return
type is specified in the call to dbm-fetch.
(locale-external-format
*locale*)
will be used. (See locale-external-format and *locale*
.)
This function returns an ndbm object.
Your operating system's implementation of NDBM may augment the supplied filename and open/create additional files to support the database. For example, many implementations take the base filename and make two files: filename.dir and file.pag. Always use just the base filename when calling 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.
| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |