Mercurial > hg > xemacs-beta
annotate man/lispref/databases.texi @ 4967:0d4c9d0f6a8d
rewrite dynarr code
-------------------- ChangeLog entries follow: --------------------
src/ChangeLog addition:
2010-02-03 Ben Wing <ben@xemacs.org>
* device-x.c (x_get_resource_prefix):
* device-x.c (Fx_get_resource):
* device-x.c (Fx_get_resource_prefix):
* device-x.c (Fx_put_resource):
* dialog-msw.c:
* dialog-msw.c (handle_question_dialog_box):
* dired-msw.c (mswindows_sort_files):
* dired-msw.c (mswindows_get_files):
* extents.c (extent_fragment_sort_by_priority):
* extents.c (Fset_extent_parent):
* file-coding.c (coding_reader):
* file-coding.c (coding_writer):
* file-coding.c (gzip_convert):
* frame.c (generate_title_string):
* gutter.c (calculate_gutter_size_from_display_lines):
* indent.c (vmotion_1):
* lread.c (read_bit_vector):
* mule-coding.c (iso2022_decode):
* rangetab.c:
* rangetab.c (Fcopy_range_table):
* rangetab.c (Fget_range_table):
* rangetab.c (unified_range_table_copy_data):
* redisplay-msw.c (mswindows_output_string):
* redisplay-output.c (output_display_line):
* redisplay-output.c (redisplay_move_cursor):
* redisplay-output.c (redisplay_clear_bottom_of_window):
* redisplay-tty.c (tty_output_ichar_dynarr):
* redisplay-tty.c (set_foreground_to):
* redisplay-tty.c (set_background_to):
* redisplay-xlike-inc.c (XLIKE_output_string):
* redisplay.c (redisplay_window_text_width_string):
* redisplay.c (redisplay_text_width_string):
* redisplay.c (create_text_block):
* redisplay.c (SET_CURRENT_MODE_CHARS_PIXSIZE):
* redisplay.c (generate_fstring_runes):
* redisplay.c (regenerate_modeline):
* redisplay.c (ensure_modeline_generated):
* redisplay.c (real_current_modeline_height):
* redisplay.c (create_string_text_block):
* redisplay.c (regenerate_window):
* redisplay.c (REGEN_INC_FIND_START_END):
* redisplay.c (point_visible):
* redisplay.c (redisplay_window):
* redisplay.c (mark_glyph_block_dynarr):
* redisplay.c (line_start_cache_start):
* redisplay.c (start_with_line_at_pixpos):
* redisplay.c (update_line_start_cache):
* redisplay.c (glyph_to_pixel_translation):
* redisplay.c (pixel_to_glyph_translation):
* sysdep.c (qxe_readdir):
* text.c (dfc_convert_to_external_format):
* text.c (dfc_convert_to_internal_format):
* toolbar-common.c (common_output_toolbar_button):
* window.c (window_modeline_height):
* window.c (Fwindow_last_line_visible_height):
* window.c (window_displayed_height):
* window.c (window_scroll):
* window.c (get_current_pixel_pos):
Use Dynarr_begin() in place of Dynarr_atp (foo, 0).
* dynarr.c (Dynarr_realloc):
* dynarr.c (Dynarr_lisp_realloc):
* dynarr.c (Dynarr_resize):
* dynarr.c (Dynarr_insert_many):
* dynarr.c (Dynarr_delete_many):
* dynarr.c (Dynarr_memory_usage):
* dynarr.c (stack_like_malloc):
* dynarr.c (stack_like_free):
* lisp.h:
* lisp.h (DECLARE_DYNARR_LISP_IMP):
* lisp.h (XD_DYNARR_DESC):
* lisp.h (Dynarr_pop):
* gutter.c (output_gutter):
* redisplay-output.c (sync_rune_structs):
* redisplay-output.c (redisplay_output_window):
Redo the dynarr code, add greater checks.
Rename the `len', `largest' and `max' members to `len_',
`largest_' and `max_' to try and catch existing places that might
directly modify these values. Make new accessors Dynarr_largest()
and Dynarr_max() and make them and existing Dynarr_length() be
non-lvalues by adding '+ 0' to them; fix a couple of places in the
redisplay code that tried to modify the length directly by setting
Dynarr_length(). Use the accessors whenever possible even in the
dynarr code itself. The accessors also verify that 0 <= len <=
largest <= max. Rename settor function Dynarr_set_size() to
Dynarr_set_length() and use it more consistently; also create
lower-level Dynarr_set_length_1(). This latter function should be
the only function that directly modifies the `len_' member of a
Dynarr, and in the process makes sure that the `largest' value is
kept correct.
Consistently use ERROR_CHECK_STRUCTURES instead of
ERROR_CHECK_TYPES for error-checking code. Reintroduce the
temporarily disabled verification code on the positions of
Dynarr_at(), Dynarr_atp() and Dynarr_atp_past_end().
Also create Dynarr_resize_if() in place of a repeated
code fragment. Clean up all the functions that modify Dynarrs to
use the new macros and functions and verify the correctness of the
Dynarr both before and after the change.
Note that there are two kinds of verification -- one for accessing
and one for modifying. The difference is that the modify
verification additionally checks to make sure that the Dynarr
isn't locked. (This is used in redisplay to check for problems
with reentrancy.)
* lrecord.h: Move XD_DYNARR_DESC to lisp.h, grouping with the dynarr code.
| author | Ben Wing <ben@xemacs.org> |
|---|---|
| date | Wed, 03 Feb 2010 20:51:18 -0600 |
| 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 |