|
428
|
1 @c -*-texinfo-*-
|
|
|
2 @c This is part of the XEmacs Lisp Reference Manual.
|
|
|
3 @c Copyright (C) 1996 Ben Wing.
|
|
|
4 @c See the file lispref.texi for copying conditions.
|
|
|
5 @setfilename ../../info/databases.info
|
|
|
6 @node Databases, Processes, Range Tables, top
|
|
|
7 @chapter Databases
|
|
|
8 @cindex database
|
|
|
9
|
|
|
10 @defun databasep object
|
|
|
11 This function returns non-@code{nil} if @var{object} is a database.
|
|
|
12 @end defun
|
|
|
13
|
|
|
14 @menu
|
|
|
15 * Connecting to a Database::
|
|
|
16 * Working With a Database::
|
|
|
17 * Other Database Functions::
|
|
|
18 @end menu
|
|
|
19
|
|
|
20 @node Connecting to a Database
|
|
|
21 @section Connecting to a Database
|
|
|
22
|
|
|
23 @defun open-database file &optional type subtype access mode
|
|
|
24 This function opens database @var{file}, using database method
|
|
|
25 @var{type} and @var{subtype}, with access rights @var{access} and
|
|
|
26 permissions @var{mode}. @var{access} can be any combination of @code{r}
|
|
|
27 @code{w} and @code{+}, for read, write, and creation flags.
|
|
|
28
|
|
442
|
29 @var{type} can have the value @code{'dbm} or @code{'berkeley-db} to
|
|
428
|
30 select the type of database file to use. (Note: XEmacs may not
|
|
|
31 support both of these types.)
|
|
|
32
|
|
|
33 For a @var{type} of @code{'dbm}, there are no subtypes, so
|
|
442
|
34 @var{subtype} should be @code{nil}.
|
|
428
|
35
|
|
442
|
36 For a @var{type} of @code{'berkeley-db}, the following subtypes are
|
|
428
|
37 available: @code{'hash}, @code{'btree}, and @code{'recno}. See the
|
|
444
|
38 manpages for the Berkeley DB functions for more information about these
|
|
428
|
39 types.
|
|
|
40 @end defun
|
|
|
41
|
|
444
|
42 @defun close-database database
|
|
|
43 This function closes database @var{database}.
|
|
428
|
44 @end defun
|
|
|
45
|
|
444
|
46 @defun database-live-p object
|
|
|
47 This function returns @code{t} if @var{object} is an active database, else
|
|
428
|
48 @code{nil}.
|
|
|
49 @end defun
|
|
|
50
|
|
|
51 @node Working With a Database
|
|
|
52 @section Working With a Database
|
|
|
53
|
|
444
|
54 @defun get-database key database &optional default
|
|
428
|
55 This function finds the value for @var{key} in @var{database}. If there is no
|
|
|
56 corresponding value, @var{default} is returned (@code{nil} if @var{default} is
|
|
|
57 omitted).
|
|
|
58 @end defun
|
|
|
59
|
|
444
|
60 @defun map-database function database
|
|
428
|
61 This function maps @var{function} over entries in @var{database},
|
|
|
62 calling it with two args, each key and value in the database.
|
|
|
63 @end defun
|
|
|
64
|
|
444
|
65 @defun put-database key value database &optional replace
|
|
|
66 This function stores @var{key} and @var{value} in @var{database}.
|
|
|
67 If optional fourth arg @var{replace} is non-@code{nil}, replace any
|
|
428
|
68 existing entry in the database.
|
|
|
69 @end defun
|
|
|
70
|
|
444
|
71 @defun remove-database key database
|
|
428
|
72 This function removes @var{key} from @var{database}.
|
|
|
73 @end defun
|
|
|
74
|
|
|
75 @node Other Database Functions
|
|
|
76 @section Other Database Functions
|
|
|
77
|
|
444
|
78 @defun database-file-name database
|
|
|
79 This function returns the filename associated with @var{database}.
|
|
428
|
80 @end defun
|
|
|
81
|
|
444
|
82 @defun database-last-error &optional database
|
|
|
83 This function returns the last error associated with @var{database}.
|
|
428
|
84 @end defun
|
|
|
85
|
|
444
|
86 @defun database-subtype database
|
|
|
87 This function returns the subtype of @var{database}, if any.
|
|
428
|
88 @end defun
|
|
|
89
|
|
444
|
90 @defun database-type database
|
|
|
91 This function returns the type of @var{database}.
|
|
428
|
92 @end defun
|
