Mercurial > hg > xemacs-beta
annotate man/lispref/databases.texi @ 5307:c096d8051f89
Have NATNUMP give t for positive bignums; check limits appropriately.
src/ChangeLog addition:
2010-11-20 Aidan Kehoe <kehoea@parhasard.net>
* abbrev.c (Fexpand_abbrev):
* alloc.c:
* alloc.c (Fmake_list):
* alloc.c (Fmake_vector):
* alloc.c (Fmake_bit_vector):
* alloc.c (Fmake_byte_code):
* alloc.c (Fmake_string):
* alloc.c (vars_of_alloc):
* bytecode.c (UNUSED):
* bytecode.c (Fbyte_code):
* chartab.c (decode_char_table_range):
* cmds.c (Fself_insert_command):
* data.c (check_integer_range):
* data.c (Fnatnump):
* data.c (Fnonnegativep):
* data.c (Fstring_to_number):
* elhash.c (hash_table_size_validate):
* elhash.c (decode_hash_table_size):
* eval.c (Fbacktrace_frame):
* event-stream.c (lisp_number_to_milliseconds):
* event-stream.c (Faccept_process_output):
* event-stream.c (Frecent_keys):
* event-stream.c (Fdispatch_event):
* events.c (Fmake_event):
* events.c (Fevent_timestamp):
* events.c (Fevent_timestamp_lessp):
* events.h:
* events.h (struct command_builder):
* file-coding.c (gzip_putprop):
* fns.c:
* fns.c (check_sequence_range):
* fns.c (Frandom):
* fns.c (Fnthcdr):
* fns.c (Flast):
* fns.c (Fnbutlast):
* fns.c (Fbutlast):
* fns.c (Fmember):
* fns.c (Ffill):
* fns.c (Freduce):
* fns.c (replace_string_range_1):
* fns.c (Freplace):
* font-mgr.c (Ffc_pattern_get):
* frame-msw.c (msprinter_set_frame_properties):
* glyphs.c (check_valid_xbm_inline):
* indent.c (Fmove_to_column):
* intl-win32.c (mswindows_multibyte_to_unicode_putprop):
* lisp.h:
* lisp.h (ARRAY_DIMENSION_LIMIT):
* lread.c (decode_mode_1):
* mule-ccl.c (ccl_get_compiled_code):
* number.h:
* process-unix.c (unix_open_multicast_group):
* process.c (Fset_process_window_size):
* profile.c (Fstart_profiling):
* unicode.c (Funicode_to_char):
Change NATNUMP to return 1 for positive bignums; changes uses of
it and of CHECK_NATNUM appropriately, usually by checking for an
integer in an appropriate range.
Add array-dimension-limit and use it in #'make-vector,
#'make-string. Add array-total-size-limit, array-rank-limit while
we're at it, for the sake of any Common Lisp-oriented code that
uses these limits.
Rename check_int_range to check_integer_range, have it take
Lisp_Objects (and thus bignums) instead.
Remove bignum_butlast(), just set int_n to an appropriately large
integer if N is a bignum.
Accept bignums in check_sequence_range(), change the functions
that use check_sequence_range() appropriately.
Move the definition of NATNUMP() to number.h; document why it's a
reasonable name, contradicting an old comment.
tests/ChangeLog addition:
2010-11-20 Aidan Kehoe <kehoea@parhasard.net>
* automated/lisp-tests.el:
* automated/lisp-tests.el (featurep):
* automated/lisp-tests.el (wrong-type-argument):
* automated/mule-tests.el (featurep):
Check for args-out-of-range errors instead of wrong-type-argument
errors in various places when code is handed a large bignum
instead of a fixnum.
Also check for the wrong-type-argument errors when giving the same
code a non-integer value.
| author | Aidan Kehoe <kehoea@parhasard.net> |
|---|---|
| date | Sat, 20 Nov 2010 16:49:11 +0000 |
| parents | 576fb035e263 |
| children | 9fae6227ede5 |
| rev | line source |
|---|---|
| 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 |