Mercurial > hg > xemacs-beta
view man/lispref/maps.texi @ 4995:8431b52e43b1
Move the various map* functions to C; add #'map-into.
src/ChangeLog addition:
2010-01-31 Aidan Kehoe <kehoea@parhasard.net>
Move #'mapcar*, #'mapcan, #'mapc, #'map, #'mapl, #'mapcon to C;
extend #'mapvector, #'mapconcat, #'mapcar to support more
SEQUENCES; have them all error with circular lists.
* fns.c (Fsubseq): Call CHECK_SEQUENCE here; Flength can return
from the debugger if it errors with a non-sequence, leading to a
crash in Fsubseq if sequence really is *not* a sequence.
(mapcarX): Rename mapcar1 to mapcarX; rework it comprehensively to
take an optional lisp output argument, and a varying number of
sequences.
Special-case a single list argument, as we used to, saving its
elements in the stack space for the results before calling
FUNCTION, so FUNCTION can corrupt the list all it
wants. dead_wrong_type_argument() in the other cases if we
encounter a non-cons where we expected a cons.
(Fmapconcat):
Accept further SEQUENCES after separator here. Special-case
the idiom (mapconcat 'identity SEQUENCE), don't even funcall.
(FmapcarX): Rename this from Fmapcar. Accept optional SEQUENCES.
(Fmapvector): Accept optional SEQUENCES.
(Fmapcan, Fmapc, Fmap): Move these here from cl-extra.el.
(Fmap_into): New function, as specified by Common Lisp.
(maplist): New function, the guts of the implementation of
Fmaplist and Fmapl.
(Fmaplist, Fmapl, Fmapcon): Move these from cl-extra.el.
(syms_of_fns):
Add a few needed symbols here, for the type tests
used by #'map. Add the new subrs, with aliases for #'mapc-internal
and #'mapcar.
* general-slots.h: Declare Qcoerce here, now it's used in both
indent.c and fns.c
* indent.c (syms_of_indent): Qcoerce is gone from here.
* lisp.h: Add ARRAYP(), SEQUENCEP(), and the corresponding CHECK_*
macros. Declare Fbit_vector, Fstring, FmapcarX, now other files
need to use them.
* data.c (Farrayp, Fsequencep): Use ARRAYP and SEQUENCEP, just
added to lisp.h
* buffer.c (Fbuffer_list): Now Fmapcar has been renamed FmapcarX
and takes MANY arguments, update this function to reflect that.
lisp/ChangeLog addition:
2010-01-31 Aidan Kehoe <kehoea@parhasard.net>
* cl.el (mapcar*): Delete; this is now in fns.c.
Use #'mapc, not #'mapc-internal in a couple of places.
* cl-macs.el (mapc, mapcar*, map): Delete these compiler macros
now the corresponding functions are in fns.c; there's no run-time
advantage to the macros.
* cl-extra.el (coerce): Extend the possible conversions here a
little; it's not remotely comprehensive yet, though it does allow
running slightly more Common Lisp code than previously.
(cl-mapcar-many): Delete.
(map, maplist, mapc, mapl, mapcan, mapcon): Move these to fns.c.
* bytecomp.el (byte-compile-maybe-mapc):
Use #'mapc itself, not #'mapc-internal, now the former is in C.
(mapcar*): Use #'byte-compile-maybe-mapc as this function's
byte-compile method, now a #'mapc that can take more than one
sequence is in C.
* obsolete.el (cl-mapc): Move this compatibility alias to this file.
* update-elc.el (do-autoload-commands): Use #'mapc, not
#'mapc-internal here.
author | Aidan Kehoe <kehoea@parhasard.net> |
---|---|
date | Sun, 31 Jan 2010 18:29:48 +0000 |
parents | 576fb035e263 |
children |
line wrap: on
line source
@c -*-texinfo-*- @c This is part of the XEmacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993 Free Software Foundation, Inc. @c See the file lispref.texi for copying conditions. @setfilename ../../info/maps.info @node Standard Keymaps, Standard Hooks, Standard Buffer-Local Variables, Top @appendix Standard Keymaps The following symbols are used as the names for various keymaps. Some of these exist when XEmacs is first started, others are loaded only when their respective mode is used. This is not an exhaustive list. Almost all of these maps are used as local maps. Indeed, of the modes that presently exist, only Vip mode and Terminal mode ever change the global keymap. @table @code @item bookmark-map @vindex bookmark-map A keymap containing bindings to bookmark functions. @item Buffer-menu-mode-map @vindex Buffer-menu-mode-map A keymap used by Buffer Menu mode. @item c++-mode-map @vindex c++-mode-map A keymap used by C++ mode. @item c-mode-map @vindex c-mode-map A keymap used by C mode. A sparse keymap used by C mode. @item command-history-map @vindex command-history-map A keymap used by Command History mode. @item ctl-x-4-map @vindex ctl-x-4-map A keymap for subcommands of the prefix @kbd{C-x 4}. @item ctl-x-5-map @vindex ctl-x-5-map A keymap for subcommands of the prefix @kbd{C-x 5}. @item ctl-x-map @vindex ctl-x-map A keymap for @kbd{C-x} commands. @item debugger-mode-map @vindex debugger-mode-map A keymap used by Debugger mode. @item dired-mode-map @vindex dired-mode-map A keymap for @code{dired-mode} buffers. @item edit-abbrevs-map @vindex edit-abbrevs-map A keymap used in @code{edit-abbrevs}. @item edit-tab-stops-map @vindex edit-tab-stops-map A keymap used in @code{edit-tab-stops}. @item electric-buffer-menu-mode-map @vindex electric-buffer-menu-mode-map A keymap used by Electric Buffer Menu mode. @item electric-history-map @vindex electric-history-map A keymap used by Electric Command History mode. @item emacs-lisp-mode-map @vindex emacs-lisp-mode-map A keymap used by Emacs Lisp mode. @item help-map @vindex help-map A keymap for characters following the Help key. @item Helper-help-map @vindex Helper-help-map A keymap used by the help utility package.@* It has the same keymap in its value cell and in its function cell. @item Info-edit-map @vindex Info-edit-map A keymap used by the @kbd{e} command of Info. @item Info-mode-map @vindex Info-mode-map A keymap containing Info commands. @item isearch-mode-map @vindex isearch-mode-map A keymap that defines the characters you can type within incremental search. @item itimer-edit-map @vindex itimer-edit-map A keymap used when in Itimer Edit mode. @item lisp-interaction-mode-map @vindex lisp-interaction-mode-map A keymap used by Lisp mode. @item lisp-mode-map @vindex lisp-mode-map A keymap used by Lisp mode. @vindex minibuffer-local-completion-map A keymap for minibuffer input with completion. @item minibuffer-local-isearch-map @vindex minibuffer-local-isearch-map A keymap for editing isearch strings in the minibuffer. @item minibuffer-local-map @vindex minibuffer-local-map Default keymap to use when reading from the minibuffer. @item minibuffer-local-must-match-map @vindex minibuffer-local-must-match-map A keymap for minibuffer input with completion, for exact match. @item mode-specific-map @vindex mode-specific-map The keymap for characters following @kbd{C-c}. Note, this is in the global map. This map is not actually mode specific: its name was chosen to be informative for the user in @kbd{C-h b} (@code{display-bindings}), where it describes the main use of the @kbd{C-c} prefix key. @item modeline-map @vindex modeline-map The keymap consulted for mouse-clicks on the modeline of a window. @item objc-mode-map @vindex objc-mode-map A keymap used in Objective C mode as a local map. @item occur-mode-map @vindex occur-mode-map A local keymap used by Occur mode. @item overriding-local-map @vindex overriding-local-map A keymap that overrides all other local keymaps. @item query-replace-map @vindex query-replace-map A local keymap used for responses in @code{query-replace} and related commands; also for @code{y-or-n-p} and @code{map-y-or-n-p}. The functions that use this map do not support prefix keys; they look up one event at a time. @item read-expression-map @vindex read-expression-map The minibuffer keymap used for reading Lisp expressions. @item read-shell-command-map @vindex read-shell-command-map The minibuffer keymap used by @code{shell-command} and related commands. @item shared-lisp-mode-map @vindex shared-lisp-mode-map A keymap for commands shared by all sorts of Lisp modes. @item text-mode-map @vindex text-mode-map A keymap used by Text mode. @item toolbar-map @vindex toolbar-map The keymap consulted for mouse-clicks over a toolbar. @item view-mode-map @vindex view-mode-map A keymap used by View mode. @end table