src/keymap.h

   1 /* Functions to manipulate keymaps.
   2    Copyright (C) 2001-2012 Free Software Foundation, Inc.
   3
   4 This file is part of GNU Emacs.
   5
   6 GNU Emacs is free software: you can redistribute it and/or modify
   7 it under the terms of the GNU General Public License as published by
   8 the Free Software Foundation, either version 3 of the License, or
   9 (at your option) any later version.
  10
  11 GNU Emacs is distributed in the hope that it will be useful,
  12 but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 GNU General Public License for more details.
  15
  16 You should have received a copy of the GNU General Public License
  17 along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.  */
  18
  19 #ifndef KEYMAP_H
  20 #define KEYMAP_H
  21
  22 /* The maximum byte size consumed by push_key_description.
  23    All callers should assure that at least this size of memory is
  24    allocated at the place pointed by the second argument.
  25
  26    There are 6 modifiers, each consumes 2 chars.
  27    The octal form of a character code consumes
  28    (1 + CHARACTERBITS / 3 + 1) chars (including backslash at the head).
  29    We need one more byte for string terminator `\0'.  */
  30 #define KEY_DESCRIPTION_SIZE ((2 * 6) + 1 + (CHARACTERBITS / 3) + 1 + 1)
  31
  32 #define KEYMAPP(m) (!NILP (get_keymap (m, 0, 0)))
  33 extern Lisp_Object Qkeymap, Qmenu_bar;
  34 extern Lisp_Object Qremap;
  35 extern Lisp_Object Qmenu_item;
  36 extern Lisp_Object current_global_map;
  37 EXFUN (Fmake_sparse_keymap, 1);
  38 EXFUN (Fkeymap_prompt, 1);
  39 EXFUN (Fdefine_key, 3);
  40 EXFUN (Fcommand_remapping, 3);
  41 EXFUN (Fkey_binding, 4);
  42 EXFUN (Fkey_description, 2);
  43 extern char *push_key_description (EMACS_INT, char *, int);
  44 EXFUN (Fsingle_key_description, 2);
  45 EXFUN (Fwhere_is_internal, 5);
  46 EXFUN (Fcurrent_active_maps, 2);
  47 extern Lisp_Object access_keymap (Lisp_Object, Lisp_Object, int, int, int);
  48 extern Lisp_Object get_keymap (Lisp_Object, int, int);
  49 EXFUN (Fset_keymap_parent, 2);
  50 extern int describe_map_tree (Lisp_Object, int, Lisp_Object, Lisp_Object,
  51                               const char *, int, int, int, int);
  52 extern ptrdiff_t current_minor_maps (Lisp_Object **, Lisp_Object **);
  53 extern void initial_define_key (Lisp_Object, int, const char *);
  54 extern void initial_define_lispy_key (Lisp_Object, const char *, const char *);
  55 extern void syms_of_keymap (void);
  56 extern void keys_of_keymap (void);
  57
  58 typedef void (*map_keymap_function_t)
  59      (Lisp_Object key, Lisp_Object val, Lisp_Object args, void* data);
  60 extern void map_keymap (Lisp_Object map, map_keymap_function_t fun, Lisp_Object largs, void* cargs, int autoload);
  61 extern void map_keymap_canonical (Lisp_Object map,
  62                                   map_keymap_function_t fun,
  63                                   Lisp_Object args, void *data);
  64
  65 #endif