home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 22 gnu / 22-gnu.zip / readline.zip / readline-2.1 / keymaps.h < prev    next >
C/C++ Source or Header  |  1994-08-16  |  3KB  |  96 lines
  1. /* keymaps.h -- Manipulation of readline keymaps. */
  2.  
  3. /* Copyright (C) 1987, 1989, 1992 Free Software Foundation, Inc.
  4.  
  5.    This file is part of the GNU Readline Library, a library for
  6.    reading lines of text with interactive input and history editing.
  7.  
  8.    The GNU Readline Library is free software; you can redistribute it
  9.    and/or modify it under the terms of the GNU General Public License
  10.    as published by the Free Software Foundation; either version 1, or
  11.    (at your option) any later version.
  12.  
  13.    The GNU Readline Library is distributed in the hope that it will be
  14.    useful, but WITHOUT ANY WARRANTY; without even the implied warranty
  15.    of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16.    GNU General Public License for more details.
  17.  
  18.    The GNU General Public License is often shipped with GNU software, and
  19.    is generally kept in a file called COPYING or LICENSE.  If you do not
  20.    have a copy of the license, write to the Free Software Foundation,
  21.    675 Mass Ave, Cambridge, MA 02139, USA. */
  22.  
  23. #ifndef _KEYMAPS_H_
  24. #define _KEYMAPS_H_
  25.  
  26. #if defined (READLINE_LIBRARY)
  27. #  include "chardefs.h"
  28. #else
  29. #  include <readline/chardefs.h>
  30. #endif
  31.  
  32. #if !defined (_FUNCTION_DEF)
  33. #  define _FUNCTION_DEF
  34. typedef int Function ();
  35. typedef void VFunction ();
  36. typedef char *CPFunction ();
  37. typedef char **CPPFunction ();
  38. #endif
  39.  
  40. /* A keymap contains one entry for each key in the ASCII set.
  41.    Each entry consists of a type and a pointer.
  42.    POINTER is the address of a function to run, or the
  43.    address of a keymap to indirect through.
  44.    TYPE says which kind of thing POINTER is. */
  45. typedef struct _keymap_entry {
  46.   char type;
  47.   Function *function;
  48. } KEYMAP_ENTRY;
  49.  
  50. /* This must be large enough to hold bindings for all of the characters
  51.    in a desired character set (e.g, 128 for ASCII, 256 for ISO Latin-x,
  52.    and so on). */
  53. #define KEYMAP_SIZE 256
  54.  
  55. /* I wanted to make the above structure contain a union of:
  56.    union { Function *function; struct _keymap_entry *keymap; } value;
  57.    but this made it impossible for me to create a static array.
  58.    Maybe I need C lessons. */
  59.  
  60. typedef KEYMAP_ENTRY KEYMAP_ENTRY_ARRAY[KEYMAP_SIZE];
  61. typedef KEYMAP_ENTRY *Keymap;
  62.  
  63. /* The values that TYPE can have in a keymap entry. */
  64. #define ISFUNC 0
  65. #define ISKMAP 1
  66. #define ISMACR 2
  67.  
  68. extern KEYMAP_ENTRY_ARRAY emacs_standard_keymap, emacs_meta_keymap, emacs_ctlx_keymap;
  69. extern KEYMAP_ENTRY_ARRAY vi_insertion_keymap, vi_movement_keymap;
  70.  
  71. /* Return a new, empty keymap.
  72.    Free it with free() when you are done. */
  73. extern Keymap rl_make_bare_keymap ();
  74.  
  75. /* Return a new keymap which is a copy of MAP. */
  76. extern Keymap rl_copy_keymap ();
  77.  
  78. /* Return a new keymap with the printing characters bound to rl_insert,
  79.    the lowercase Meta characters bound to run their equivalents, and
  80.    the Meta digits bound to produce numeric arguments. */
  81. extern Keymap rl_make_keymap ();
  82.  
  83. extern void rl_discard_keymap ();
  84.  
  85. /* Return the keymap corresponding to a given name.  Names look like
  86.    `emacs' or `emacs-meta' or `vi-insert'. */
  87. extern Keymap rl_get_keymap_by_name ();
  88.  
  89. /* Return the current keymap. */
  90. extern Keymap rl_get_keymap ();
  91.  
  92. /* Set the current keymap to MAP. */
  93. extern void rl_set_keymap ();
  94.  
  95. #endif /* _KEYMAPS_H_ */
  96.