bind.c
上传用户:tsgydb
上传日期:2007-04-14
资源大小:10674k
文件大小:47k
源码类别:

MySQL数据库

开发平台:

Visual C++

  1. /* bind.c -- key binding and startup file support for the readline library. */
  2. /* Copyright (C) 1987, 1989, 1992 Free Software Foundation, Inc.
  3.    This file is part of the GNU Readline Library, a library for
  4.    reading lines of text with interactive input and history editing.
  5.    The GNU Readline Library is free software; you can redistribute it
  6.    and/or modify it under the terms of the GNU General Public License
  7.    as published by the Free Software Foundation; either version 1, or
  8.    (at your option) any later version.
  9.    The GNU Readline Library is distributed in the hope that it will be
  10.    useful, but WITHOUT ANY WARRANTY; without even the implied warranty
  11.    of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12.    GNU General Public License for more details.
  13.    The GNU General Public License is often shipped with GNU software, and
  14.    is generally kept in a file called COPYING or LICENSE.  If you do not
  15.    have a copy of the license, write to the Free Software Foundation,
  16.    675 Mass Ave, Cambridge, MA 02139, USA. */
  17. #define READLINE_LIBRARY
  18. #if defined (HAVE_CONFIG_H)
  19. #  include <config.h>
  20. #endif
  21. #include <stdio.h>
  22. #include <sys/types.h>
  23. #include <fcntl.h>
  24. #if defined (HAVE_SYS_FILE_H)
  25. #  include <sys/file.h>
  26. #endif /* HAVE_SYS_FILE_H */
  27. #if defined (HAVE_UNISTD_H)
  28. #  include <unistd.h>
  29. #endif /* HAVE_UNISTD_H */
  30. #if defined (HAVE_STDLIB_H)
  31. #  include <stdlib.h>
  32. #else
  33. #  include "ansi_stdlib.h"
  34. #endif /* HAVE_STDLIB_H */
  35. #include <signal.h>
  36. #include <errno.h>
  37. #if !defined (errno)
  38. extern int errno;
  39. #endif /* !errno */
  40. #include "posixstat.h"
  41. /* System-specific feature definitions and include files. */
  42. #include "rldefs.h"
  43. /* Some standard library routines. */
  44. #include "readline.h"
  45. #include "history.h"
  46. #if !defined (strchr) && !defined (__STDC__)
  47. extern char *strchr (), *strrchr ();
  48. #endif /* !strchr && !__STDC__ */
  49. extern int _rl_horizontal_scroll_mode;
  50. extern int _rl_mark_modified_lines;
  51. extern int _rl_bell_preference;
  52. extern int _rl_meta_flag;
  53. extern int _rl_convert_meta_chars_to_ascii;
  54. extern int _rl_output_meta_chars;
  55. extern int _rl_complete_show_all;
  56. extern int _rl_complete_mark_directories;
  57. extern int _rl_print_completions_horizontally;
  58. extern int _rl_completion_case_fold;
  59. extern int _rl_enable_keypad;
  60. #if defined (PAREN_MATCHING)
  61. extern int rl_blink_matching_paren;
  62. #endif /* PAREN_MATCHING */
  63. #if defined (VISIBLE_STATS)
  64. extern int rl_visible_stats;
  65. #endif /* VISIBLE_STATS */
  66. extern int rl_complete_with_tilde_expansion;
  67. extern int rl_completion_query_items;
  68. extern int rl_inhibit_completion;
  69. extern char *_rl_comment_begin;
  70. extern unsigned char *_rl_isearch_terminators;
  71. extern int rl_explicit_arg;
  72. extern int rl_editing_mode;
  73. extern unsigned char _rl_parsing_conditionalized_out;
  74. extern Keymap _rl_keymap;
  75. extern char *possible_control_prefixes[], *possible_meta_prefixes[];
  76. /* Functions imported from funmap.c */
  77. extern char **rl_funmap_names ();
  78. extern int rl_add_funmap_entry ();
  79. /* Functions imported from util.c */
  80. extern char *_rl_strindex ();
  81. /* Functions imported from shell.c */
  82. extern char *get_env_value ();
  83. /* Variables exported by this file. */
  84. Keymap rl_binding_keymap;
  85. /* Forward declarations */
  86. void rl_set_keymap_from_edit_mode ();
  87. static int _rl_read_init_file ();
  88. static int glean_key_from_name ();
  89. static int substring_member_of_array ();
  90. extern char *xmalloc (), *xrealloc ();
  91. /* **************************************************************** */
  92. /*     */
  93. /* Binding keys     */
  94. /*     */
  95. /* **************************************************************** */
  96. /* rl_add_defun (char *name, Function *function, int key)
  97.    Add NAME to the list of named functions.  Make FUNCTION be the function
  98.    that gets called.  If KEY is not -1, then bind it. */
  99. int
  100. rl_add_defun (name, function, key)
  101.      char *name;
  102.      Function *function;
  103.      int key;
  104. {
  105.   if (key != -1)
  106.     rl_bind_key (key, function);
  107.   rl_add_funmap_entry (name, function);
  108.   return 0;
  109. }
  110. /* Bind KEY to FUNCTION.  Returns non-zero if KEY is out of range. */
  111. int
  112. rl_bind_key (key, function)
  113.      int key;
  114.      Function *function;
  115. {
  116.   if (key < 0)
  117.     return (key);
  118.   if (META_CHAR (key) && _rl_convert_meta_chars_to_ascii)
  119.     {
  120.       if (_rl_keymap[ESC].type == ISKMAP)
  121. {
  122.   Keymap escmap;
  123.   escmap = FUNCTION_TO_KEYMAP (_rl_keymap, ESC);
  124.   key = UNMETA (key);
  125.   escmap[key].type = ISFUNC;
  126.   escmap[key].function = function;
  127.   return (0);
  128. }
  129.       return (key);
  130.     }
  131.   _rl_keymap[key].type = ISFUNC;
  132.   _rl_keymap[key].function = function;
  133.   rl_binding_keymap = _rl_keymap;
  134.   return (0);
  135. }
  136. /* Bind KEY to FUNCTION in MAP.  Returns non-zero in case of invalid
  137.    KEY. */
  138. int
  139. rl_bind_key_in_map (key, function, map)
  140.      int key;
  141.      Function *function;
  142.      Keymap map;
  143. {
  144.   int result;
  145.   Keymap oldmap;
  146.   oldmap = _rl_keymap;
  147.   _rl_keymap = map;
  148.   result = rl_bind_key (key, function);
  149.   _rl_keymap = oldmap;
  150.   return (result);
  151. }
  152. /* Make KEY do nothing in the currently selected keymap.
  153.    Returns non-zero in case of error. */
  154. int
  155. rl_unbind_key (key)
  156.      int key;
  157. {
  158.   return (rl_bind_key (key, (Function *)NULL));
  159. }
  160. /* Make KEY do nothing in MAP.
  161.    Returns non-zero in case of error. */
  162. int
  163. rl_unbind_key_in_map (key, map)
  164.      int key;
  165.      Keymap map;
  166. {
  167.   return (rl_bind_key_in_map (key, (Function *)NULL, map));
  168. }
  169. /* Unbind all keys bound to FUNCTION in MAP. */
  170. int
  171. rl_unbind_function_in_map (func, map)
  172.      Function *func;
  173.      Keymap map;
  174. {
  175.   register int i, rval;
  176.   for (i = rval = 0; i < KEYMAP_SIZE; i++)
  177.     {
  178.       if (map[i].type == ISFUNC && map[i].function == func)
  179. {
  180.   map[i].function = (Function *)NULL;
  181.   rval = 1;
  182. }
  183.     }
  184.   return rval;
  185. }
  186. int
  187. rl_unbind_command_in_map (command, map)
  188.      char *command;
  189.      Keymap map;
  190. {
  191.   Function *func;
  192.   func = rl_named_function (command);
  193.   if (func == 0)
  194.     return 0;
  195.   return (rl_unbind_function_in_map (func, map));
  196. }
  197. /* Bind the key sequence represented by the string KEYSEQ to
  198.    FUNCTION.  This makes new keymaps as necessary.  The initial
  199.    place to do bindings is in MAP. */
  200. int
  201. rl_set_key (keyseq, function, map)
  202.      char *keyseq;
  203.      Function *function;
  204.      Keymap map;
  205. {
  206.   return (rl_generic_bind (ISFUNC, keyseq, (char *)function, map));
  207. }
  208. /* Bind the key sequence represented by the string KEYSEQ to
  209.    the string of characters MACRO.  This makes new keymaps as
  210.    necessary.  The initial place to do bindings is in MAP. */
  211. int
  212. rl_macro_bind (keyseq, macro, map)
  213.      char *keyseq, *macro;
  214.      Keymap map;
  215. {
  216.   char *macro_keys;
  217.   int macro_keys_len;
  218.   macro_keys = (char *)xmalloc ((2 * strlen (macro)) + 1);
  219.   if (rl_translate_keyseq (macro, macro_keys, &macro_keys_len))
  220.     {
  221.       free (macro_keys);
  222.       return -1;
  223.     }
  224.   rl_generic_bind (ISMACR, keyseq, macro_keys, map);
  225.   return 0;
  226. }
  227. /* Bind the key sequence represented by the string KEYSEQ to
  228.    the arbitrary pointer DATA.  TYPE says what kind of data is
  229.    pointed to by DATA, right now this can be a function (ISFUNC),
  230.    a macro (ISMACR), or a keymap (ISKMAP).  This makes new keymaps
  231.    as necessary.  The initial place to do bindings is in MAP. */
  232. int
  233. rl_generic_bind (type, keyseq, data, map)
  234.      int type;
  235.      char *keyseq, *data;
  236.      Keymap map;
  237. {
  238.   char *keys;
  239.   int keys_len;
  240.   register int i;
  241.   /* If no keys to bind to, exit right away. */
  242.   if (!keyseq || !*keyseq)
  243.     {
  244.       if (type == ISMACR)
  245. free (data);
  246.       return -1;
  247.     }
  248.   keys = xmalloc (1 + (2 * strlen (keyseq)));
  249.   /* Translate the ASCII representation of KEYSEQ into an array of
  250.      characters.  Stuff the characters into KEYS, and the length of
  251.      KEYS into KEYS_LEN. */
  252.   if (rl_translate_keyseq (keyseq, keys, &keys_len))
  253.     {
  254.       free (keys);
  255.       return -1;
  256.     }
  257.   /* Bind keys, making new keymaps as necessary. */
  258.   for (i = 0; i < keys_len; i++)
  259.     {
  260.       int ic = (int) ((unsigned char)keys[i]);
  261.       if (_rl_convert_meta_chars_to_ascii && META_CHAR (ic))
  262. {
  263.   ic = UNMETA (ic);
  264.   if (map[ESC].type == ISKMAP)
  265.     map = FUNCTION_TO_KEYMAP (map, ESC);
  266. }
  267.       if ((i + 1) < keys_len)
  268. {
  269.   if (map[ic].type != ISKMAP)
  270.     {
  271.       if (map[ic].type == ISMACR)
  272. free ((char *)map[ic].function);
  273.       map[ic].type = ISKMAP;
  274.       map[ic].function = KEYMAP_TO_FUNCTION (rl_make_bare_keymap());
  275.     }
  276.   map = FUNCTION_TO_KEYMAP (map, ic);
  277. }
  278.       else
  279. {
  280.   if (map[ic].type == ISMACR)
  281.     free ((char *)map[ic].function);
  282.   map[ic].function = KEYMAP_TO_FUNCTION (data);
  283.   map[ic].type = type;
  284. }
  285.       rl_binding_keymap = map;
  286.     }
  287.   free (keys);
  288.   return 0;
  289. }
  290. /* Translate the ASCII representation of SEQ, stuffing the values into ARRAY,
  291.    an array of characters.  LEN gets the final length of ARRAY.  Return
  292.    non-zero if there was an error parsing SEQ. */
  293. int
  294. rl_translate_keyseq (seq, array, len)
  295.      char *seq, *array;
  296.      int *len;
  297. {
  298.   register int i, c, l, temp;
  299.   for (i = l = 0; (c = seq[i]); i++)
  300.     {
  301.       if (c == '\')
  302. {
  303.   c = seq[++i];
  304.   if (c == 0)
  305.     break;
  306.   /* Handle C- and M- prefixes. */
  307.   if ((c == 'C' || c == 'M') && seq[i + 1] == '-')
  308.     {
  309.       /* Handle special case of backwards define. */
  310.       if (strncmp (&seq[i], "C-\M-", 5) == 0)
  311. {
  312.   array[l++] = ESC;
  313.   i += 5;
  314.   array[l++] = CTRL (_rl_to_upper (seq[i]));
  315.   if (seq[i] == '')
  316.     i--;
  317. }
  318.       else if (c == 'M')
  319. {
  320.   i++;
  321.   array[l++] = ESC; /* XXX */
  322. }
  323.       else if (c == 'C')
  324. {
  325.   i += 2;
  326.   /* Special hack for C-?... */
  327.   array[l++] = (seq[i] == '?') ? RUBOUT : CTRL (_rl_to_upper (seq[i]));
  328. }
  329.       continue;
  330.     }       
  331.   /* Translate other backslash-escaped characters.  These are the
  332.      same escape sequences that bash's `echo' and `printf' builtins
  333.      handle, with the addition of d -> RUBOUT.  A backslash
  334.      preceding a character that is not special is stripped. */
  335.   switch (c)
  336.     {
  337.     case 'a':
  338.       array[l++] = '07';
  339.       break;
  340.     case 'b':
  341.       array[l++] = 'b';
  342.       break;
  343.     case 'd':
  344.       array[l++] = RUBOUT; /* readline-specific */
  345.       break;
  346.     case 'e':
  347.       array[l++] = ESC;
  348.       break;
  349.     case 'f':
  350.       array[l++] = 'f';
  351.       break;
  352.     case 'n':
  353.       array[l++] = NEWLINE;
  354.       break;
  355.     case 'r':
  356.       array[l++] = RETURN;
  357.       break;
  358.     case 't':
  359.       array[l++] = TAB;
  360.       break;
  361.     case 'v':
  362.       array[l++] = 0x0B;
  363.       break;
  364.     case '\':
  365.       array[l++] = '\';
  366.       break;
  367.     case '0': case '1': case '2': case '3':
  368.     case '4': case '5': case '6': case '7':
  369.       i++;
  370.       for (temp = 2, c -= '0'; ISOCTAL (seq[i]) && temp--; i++)
  371.         c = (c * 8) + OCTVALUE (seq[i]);
  372.       i--; /* auto-increment in for loop */
  373.       array[l++] = c % (largest_char + 1);
  374.       break;
  375.     case 'x':
  376.       i++;
  377.       for (temp = 3, c = 0; isxdigit (seq[i]) && temp--; i++)
  378.         c = (c * 16) + HEXVALUE (seq[i]);
  379.       if (temp == 3)
  380.         c = 'x';
  381.       i--; /* auto-increment in for loop */
  382.       array[l++] = c % (largest_char + 1);
  383.       break;
  384.     default: /* backslashes before non-special chars just add the char */
  385.       array[l++] = c;
  386.       break; /* the backslash is stripped */
  387.     }
  388.   continue;
  389. }
  390.       array[l++] = c;
  391.     }
  392.   *len = l;
  393.   array[l] = '';
  394.   return (0);
  395. }
  396. char *
  397. rl_untranslate_keyseq (seq)
  398.      int seq;
  399. {
  400.   static char kseq[16];
  401.   int i, c;
  402.   i = 0;
  403.   c = seq;
  404.   if (META_CHAR (c))
  405.     {
  406.       kseq[i++] = '\';
  407.       kseq[i++] = 'M';
  408.       kseq[i++] = '-';
  409.       c = UNMETA (c);
  410.     }
  411.   else if (CTRL_CHAR (c))
  412.     {
  413.       kseq[i++] = '\';
  414.       kseq[i++] = 'C';
  415.       kseq[i++] = '-';
  416.       c = _rl_to_lower (UNCTRL (c));
  417.     }
  418.   else if (c == RUBOUT)
  419.     {
  420.       kseq[i++] = '\';
  421.       kseq[i++] = 'C';
  422.       kseq[i++] = '-';
  423.       c = '?';
  424.     }
  425.   if (c == ESC)
  426.     {
  427.       kseq[i++] = '\';
  428.       c = 'e';
  429.     }
  430.   else if (c == '\' || c == '"')
  431.     {
  432.       kseq[i++] = '\';
  433.     }
  434.   kseq[i++] = (unsigned char) c;
  435.   kseq[i] = '';
  436.   return kseq;
  437. }
  438. static char *
  439. _rl_untranslate_macro_value (seq)
  440.      char *seq;
  441. {
  442.   char *ret, *r, *s;
  443.   int c;
  444.   r = ret = xmalloc (7 * strlen (seq) + 1);
  445.   for (s = seq; *s; s++)
  446.     {
  447.       c = *s;
  448.       if (META_CHAR (c))
  449. {
  450.   *r++ = '\';
  451.   *r++ = 'M';
  452.   *r++ = '-';
  453.   c = UNMETA (c);
  454. }
  455.       else if (CTRL_CHAR (c) && c != ESC)
  456. {
  457.   *r++ = '\';
  458.   *r++ = 'C';
  459.   *r++ = '-';
  460.   c = _rl_to_lower (UNCTRL (c));
  461. }
  462.       else if (c == RUBOUT)
  463.   {
  464.     *r++ = '\';
  465.     *r++ = 'C';
  466.     *r++ = '-';
  467.     c = '?';
  468.   }
  469.       if (c == ESC)
  470. {
  471.   *r++ = '\';
  472.   c = 'e';
  473. }
  474.       else if (c == '\' || c == '"')
  475. *r++ = '\';
  476.       *r++ = (unsigned char)c;
  477.     }
  478.   *r = '';
  479.   return ret;
  480. }
  481. /* Return a pointer to the function that STRING represents.
  482.    If STRING doesn't have a matching function, then a NULL pointer
  483.    is returned. */
  484. Function *
  485. rl_named_function (string)
  486.      char *string;
  487. {
  488.   register int i;
  489.   rl_initialize_funmap ();
  490.   for (i = 0; funmap[i]; i++)
  491.     if (_rl_stricmp (funmap[i]->name, string) == 0)
  492.       return (funmap[i]->function);
  493.   return ((Function *)NULL);
  494. }
  495. /* Return the function (or macro) definition which would be invoked via
  496.    KEYSEQ if executed in MAP.  If MAP is NULL, then the current keymap is
  497.    used.  TYPE, if non-NULL, is a pointer to an int which will receive the
  498.    type of the object pointed to.  One of ISFUNC (function), ISKMAP (keymap),
  499.    or ISMACR (macro). */
  500. Function *
  501. rl_function_of_keyseq (keyseq, map, type)
  502.      char *keyseq;
  503.      Keymap map;
  504.      int *type;
  505. {
  506.   register int i;
  507.   if (!map)
  508.     map = _rl_keymap;
  509.   for (i = 0; keyseq && keyseq[i]; i++)
  510.     {
  511.       int ic = keyseq[i];
  512.       if (META_CHAR (ic) && _rl_convert_meta_chars_to_ascii)
  513. {
  514.   if (map[ESC].type != ISKMAP)
  515.     {
  516.       if (type)
  517. *type = map[ESC].type;
  518.       return (map[ESC].function);
  519.     }
  520.   else
  521.     {
  522.       map = FUNCTION_TO_KEYMAP (map, ESC);
  523.       ic = UNMETA (ic);
  524.     }
  525. }
  526.       if (map[ic].type == ISKMAP)
  527. {
  528.   /* If this is the last key in the key sequence, return the
  529.      map. */
  530.   if (!keyseq[i + 1])
  531.     {
  532.       if (type)
  533. *type = ISKMAP;
  534.       return (map[ic].function);
  535.     }
  536.   else
  537.     map = FUNCTION_TO_KEYMAP (map, ic);
  538. }
  539.       else
  540. {
  541.   if (type)
  542.     *type = map[ic].type;
  543.   return (map[ic].function);
  544. }
  545.     }
  546.   return ((Function *) NULL);
  547. }
  548. /* The last key bindings file read. */
  549. static char *last_readline_init_file = (char *)NULL;
  550. /* The file we're currently reading key bindings from. */
  551. static char *current_readline_init_file;
  552. static int current_readline_init_include_level;
  553. static int current_readline_init_lineno;
  554. /* Read FILENAME into a locally-allocated buffer and return the buffer.
  555.    The size of the buffer is returned in *SIZEP.  Returns NULL if any
  556.    errors were encountered. */
  557. static char *
  558. _rl_read_file (filename, sizep)
  559.      char *filename;
  560.      size_t *sizep;
  561. {
  562.   struct stat finfo;
  563.   size_t file_size;
  564.   char *buffer;
  565.   int i, file;
  566.   if ((stat (filename, &finfo) < 0) || (file = open (filename, O_RDONLY, 0666)) < 0)
  567.     return ((char *)NULL);
  568.   file_size = (size_t)finfo.st_size;
  569.   /* check for overflow on very large files */
  570.   if (file_size != finfo.st_size || file_size + 1 < file_size)
  571.     {
  572.       if (file >= 0)
  573. close (file);
  574. #if defined (EFBIG)
  575.       errno = EFBIG;
  576. #endif
  577.       return ((char *)NULL);
  578.     }
  579.   /* Read the file into BUFFER. */
  580.   buffer = (char *)xmalloc (file_size + 1);
  581.   i = read (file, buffer, file_size);
  582.   close (file);
  583. #if 0
  584.   if (i < file_size)
  585. #else
  586.   if (i < 0)
  587. #endif
  588.     {
  589.       free (buffer);
  590.       return ((char *)NULL);
  591.     }
  592.   buffer[file_size] = '';
  593.   if (sizep)
  594.     *sizep = file_size;
  595.   return (buffer);
  596. }
  597. /* Re-read the current keybindings file. */
  598. int
  599. rl_re_read_init_file (count, ignore)
  600.      int count, ignore;
  601. {
  602.   int r;
  603.   r = rl_read_init_file ((char *)NULL);
  604.   rl_set_keymap_from_edit_mode ();
  605.   return r;
  606. }
  607. /* Do key bindings from a file.  If FILENAME is NULL it defaults
  608.    to the first non-null filename from this list:
  609.      1. the filename used for the previous call
  610.      2. the value of the shell variable `INPUTRC'
  611.      3. ~/.inputrc
  612.    If the file existed and could be opened and read, 0 is returned,
  613.    otherwise errno is returned. */
  614. int
  615. rl_read_init_file (filename)
  616.      char *filename;
  617. {
  618.   /* Default the filename. */
  619.   if (filename == 0)
  620.     {
  621.       filename = last_readline_init_file;
  622.       if (filename == 0)
  623.         filename = get_env_value ("INPUTRC");
  624.       if (filename == 0)
  625. filename = DEFAULT_INPUTRC;
  626.     }
  627.   if (*filename == 0)
  628.     filename = DEFAULT_INPUTRC;
  629.   return (_rl_read_init_file (filename, 0));
  630. }
  631. static int
  632. _rl_read_init_file (filename, include_level)
  633.      char *filename;
  634.      int include_level;
  635. {
  636.   register int i;
  637.   char *buffer, *openname, *line, *end;
  638.   size_t file_size;
  639.   current_readline_init_file = filename;
  640.   current_readline_init_include_level = include_level;
  641.   openname = tilde_expand (filename);
  642.   buffer = _rl_read_file (openname, &file_size);
  643.   free (openname);
  644.   if (buffer == 0)
  645.     return (errno);
  646.   
  647.   if (include_level == 0 && filename != last_readline_init_file)
  648.     {
  649.       FREE (last_readline_init_file);
  650.       last_readline_init_file = savestring (filename);
  651.     }
  652.   /* Loop over the lines in the file.  Lines that start with `#' are
  653.      comments; all other lines are commands for readline initialization. */
  654.   current_readline_init_lineno = 1;
  655.   line = buffer;
  656.   end = buffer + file_size;
  657.   while (line < end)
  658.     {
  659.       /* Find the end of this line. */
  660.       for (i = 0; line + i != end && line[i] != 'n'; i++);
  661.       /* Mark end of line. */
  662.       line[i] = '';
  663.       /* Skip leading whitespace. */
  664.       while (*line && whitespace (*line))
  665.         {
  666.   line++;
  667.   i--;
  668.         }
  669.       /* If the line is not a comment, then parse it. */
  670.       if (*line && *line != '#')
  671. rl_parse_and_bind (line);
  672.       /* Move to the next line. */
  673.       line += i + 1;
  674.       current_readline_init_lineno++;
  675.     }
  676.   free (buffer);
  677.   return (0);
  678. }
  679. static void
  680. _rl_init_file_error (msg)
  681.      char *msg;
  682. {
  683.   fprintf (stderr, "readline: %s: line %d: %sn", current_readline_init_file,
  684.      current_readline_init_lineno,
  685.      msg);
  686. }
  687. /* **************************************************************** */
  688. /*     */
  689. /* Parser Directives            */
  690. /*     */
  691. /* **************************************************************** */
  692. /* Conditionals. */
  693. /* Calling programs set this to have their argv[0]. */
  694. char *rl_readline_name = "other";
  695. /* Stack of previous values of parsing_conditionalized_out. */
  696. static unsigned char *if_stack = (unsigned char *)NULL;
  697. static int if_stack_depth;
  698. static int if_stack_size;
  699. /* Push _rl_parsing_conditionalized_out, and set parser state based
  700.    on ARGS. */
  701. static int
  702. parser_if (args)
  703.      char *args;
  704. {
  705.   register int i;
  706.   /* Push parser state. */
  707.   if (if_stack_depth + 1 >= if_stack_size)
  708.     {
  709.       if (!if_stack)
  710. if_stack = (unsigned char *)xmalloc (if_stack_size = 20);
  711.       else
  712. if_stack = (unsigned char *)xrealloc (if_stack, if_stack_size += 20);
  713.     }
  714.   if_stack[if_stack_depth++] = _rl_parsing_conditionalized_out;
  715.   /* If parsing is turned off, then nothing can turn it back on except
  716.      for finding the matching endif.  In that case, return right now. */
  717.   if (_rl_parsing_conditionalized_out)
  718.     return 0;
  719.   /* Isolate first argument. */
  720.   for (i = 0; args[i] && !whitespace (args[i]); i++);
  721.   if (args[i])
  722.     args[i++] = '';
  723.   /* Handle "$if term=foo" and "$if mode=emacs" constructs.  If this
  724.      isn't term=foo, or mode=emacs, then check to see if the first
  725.      word in ARGS is the same as the value stored in rl_readline_name. */
  726.   if (rl_terminal_name && _rl_strnicmp (args, "term=", 5) == 0)
  727.     {
  728.       char *tem, *tname;
  729.       /* Terminals like "aaa-60" are equivalent to "aaa". */
  730.       tname = savestring (rl_terminal_name);
  731.       tem = strchr (tname, '-');
  732.       if (tem)
  733. *tem = '';
  734.       /* Test the `long' and `short' forms of the terminal name so that
  735.  if someone has a `sun-cmd' and does not want to have bindings
  736.  that will be executed if the terminal is a `sun', they can put
  737.  `$if term=sun-cmd' into their .inputrc. */
  738.       _rl_parsing_conditionalized_out = _rl_stricmp (args + 5, tname) &&
  739. _rl_stricmp (args + 5, rl_terminal_name);
  740.       free (tname);
  741.     }
  742. #if defined (VI_MODE)
  743.   else if (_rl_strnicmp (args, "mode=", 5) == 0)
  744.     {
  745.       int mode;
  746.       if (_rl_stricmp (args + 5, "emacs") == 0)
  747. mode = emacs_mode;
  748.       else if (_rl_stricmp (args + 5, "vi") == 0)
  749. mode = vi_mode;
  750.       else
  751. mode = no_mode;
  752.       _rl_parsing_conditionalized_out = mode != rl_editing_mode;
  753.     }
  754. #endif /* VI_MODE */
  755.   /* Check to see if the first word in ARGS is the same as the
  756.      value stored in rl_readline_name. */
  757.   else if (_rl_stricmp (args, rl_readline_name) == 0)
  758.     _rl_parsing_conditionalized_out = 0;
  759.   else
  760.     _rl_parsing_conditionalized_out = 1;
  761.   return 0;
  762. }
  763. /* Invert the current parser state if there is anything on the stack. */
  764. static int
  765. parser_else (args)
  766.      char *args;
  767. {
  768.   register int i;
  769.   if (if_stack_depth == 0)
  770.     {
  771.       _rl_init_file_error ("$else found without matching $if");
  772.       return 0;
  773.     }
  774.   /* Check the previous (n - 1) levels of the stack to make sure that
  775.      we haven't previously turned off parsing. */
  776.   for (i = 0; i < if_stack_depth - 1; i++)
  777.     if (if_stack[i] == 1)
  778.       return 0;
  779.   /* Invert the state of parsing if at top level. */
  780.   _rl_parsing_conditionalized_out = !_rl_parsing_conditionalized_out;
  781.   return 0;
  782. }
  783. /* Terminate a conditional, popping the value of
  784.    _rl_parsing_conditionalized_out from the stack. */
  785. static int
  786. parser_endif (args)
  787.      char *args;
  788. {
  789.   if (if_stack_depth)
  790.     _rl_parsing_conditionalized_out = if_stack[--if_stack_depth];
  791.   else
  792.     _rl_init_file_error ("$endif without matching $if");
  793.   return 0;
  794. }
  795. static int
  796. parser_include (args)
  797.      char *args;
  798. {
  799.   char *old_init_file, *e;
  800.   int old_line_number, old_include_level, r;
  801.   if (_rl_parsing_conditionalized_out)
  802.     return (0);
  803.   old_init_file = current_readline_init_file;
  804.   old_line_number = current_readline_init_lineno;
  805.   old_include_level = current_readline_init_include_level;
  806.   e = strchr (args, 'n');
  807.   if (e)
  808.     *e = '';
  809.   r = _rl_read_init_file (args, old_include_level + 1);
  810.   current_readline_init_file = old_init_file;
  811.   current_readline_init_lineno = old_line_number;
  812.   current_readline_init_include_level = old_include_level;
  813.   return r;
  814. }
  815.   
  816. /* Associate textual names with actual functions. */
  817. static struct {
  818.   char *name;
  819.   Function *function;
  820. } parser_directives [] = {
  821.   { "if", parser_if },
  822.   { "endif", parser_endif },
  823.   { "else", parser_else },
  824.   { "include", parser_include },
  825.   { (char *)0x0, (Function *)0x0 }
  826. };
  827. /* Handle a parser directive.  STATEMENT is the line of the directive
  828.    without any leading `$'. */
  829. static int
  830. handle_parser_directive (statement)
  831.      char *statement;
  832. {
  833.   register int i;
  834.   char *directive, *args;
  835.   /* Isolate the actual directive. */
  836.   /* Skip whitespace. */
  837.   for (i = 0; whitespace (statement[i]); i++);
  838.   directive = &statement[i];
  839.   for (; statement[i] && !whitespace (statement[i]); i++);
  840.   if (statement[i])
  841.     statement[i++] = '';
  842.   for (; statement[i] && whitespace (statement[i]); i++);
  843.   args = &statement[i];
  844.   /* Lookup the command, and act on it. */
  845.   for (i = 0; parser_directives[i].name; i++)
  846.     if (_rl_stricmp (directive, parser_directives[i].name) == 0)
  847.       {
  848. (*parser_directives[i].function) (args);
  849. return (0);
  850.       }
  851.   /* display an error message about the unknown parser directive */
  852.   _rl_init_file_error ("unknown parser directive");
  853.   return (1);
  854. }
  855. /* Read the binding command from STRING and perform it.
  856.    A key binding command looks like: Keyname: function-name,
  857.    a variable binding command looks like: set variable value.
  858.    A new-style keybinding looks like "C-xC-x": exchange-point-and-mark. */
  859. int
  860. rl_parse_and_bind (string)
  861.      char *string;
  862. {
  863.   char *funname, *kname;
  864.   register int c, i;
  865.   int key, equivalency;
  866.   while (string && whitespace (*string))
  867.     string++;
  868.   if (!string || !*string || *string == '#')
  869.     return 0;
  870.   /* If this is a parser directive, act on it. */
  871.   if (*string == '$')
  872.     {
  873.       handle_parser_directive (&string[1]);
  874.       return 0;
  875.     }
  876.   /* If we aren't supposed to be parsing right now, then we're done. */
  877.   if (_rl_parsing_conditionalized_out)
  878.     return 0;
  879.   i = 0;
  880.   /* If this keyname is a complex key expression surrounded by quotes,
  881.      advance to after the matching close quote.  This code allows the
  882.      backslash to quote characters in the key expression. */
  883.   if (*string == '"')
  884.     {
  885.       int passc = 0;
  886.       for (i = 1; (c = string[i]); i++)
  887. {
  888.   if (passc)
  889.     {
  890.       passc = 0;
  891.       continue;
  892.     }
  893.   if (c == '\')
  894.     {
  895.       passc++;
  896.       continue;
  897.     }
  898.   if (c == '"')
  899.     break;
  900. }
  901.       /* If we didn't find a closing quote, abort the line. */
  902.       if (string[i] == '')
  903.         {
  904.           _rl_init_file_error ("no closing `"' in key binding");
  905.           return 1;
  906.         }
  907.     }
  908.   /* Advance to the colon (:) or whitespace which separates the two objects. */
  909.   for (; (c = string[i]) && c != ':' && c != ' ' && c != 't'; i++ );
  910.   equivalency = (c == ':' && string[i + 1] == '=');
  911.   /* Mark the end of the command (or keyname). */
  912.   if (string[i])
  913.     string[i++] = '';
  914.   /* If doing assignment, skip the '=' sign as well. */
  915.   if (equivalency)
  916.     string[i++] = '';
  917.   /* If this is a command to set a variable, then do that. */
  918.   if (_rl_stricmp (string, "set") == 0)
  919.     {
  920.       char *var = string + i;
  921.       char *value;
  922.       /* Make VAR point to start of variable name. */
  923.       while (*var && whitespace (*var)) var++;
  924.       /* Make value point to start of value string. */
  925.       value = var;
  926.       while (*value && !whitespace (*value)) value++;
  927.       if (*value)
  928. *value++ = '';
  929.       while (*value && whitespace (*value)) value++;
  930.       rl_variable_bind (var, value);
  931.       return 0;
  932.     }
  933.   /* Skip any whitespace between keyname and funname. */
  934.   for (; string[i] && whitespace (string[i]); i++);
  935.   funname = &string[i];
  936.   /* Now isolate funname.
  937.      For straight function names just look for whitespace, since
  938.      that will signify the end of the string.  But this could be a
  939.      macro definition.  In that case, the string is quoted, so skip
  940.      to the matching delimiter.  We allow the backslash to quote the
  941.      delimiter characters in the macro body. */
  942.   /* This code exists to allow whitespace in macro expansions, which
  943.      would otherwise be gobbled up by the next `for' loop.*/
  944.   /* XXX - it may be desirable to allow backslash quoting only if " is
  945.      the quoted string delimiter, like the shell. */
  946.   if (*funname == ''' || *funname == '"')
  947.     {
  948.       int delimiter = string[i++], passc;
  949.       for (passc = 0; (c = string[i]); i++)
  950. {
  951.   if (passc)
  952.     {
  953.       passc = 0;
  954.       continue;
  955.     }
  956.   if (c == '\')
  957.     {
  958.       passc = 1;
  959.       continue;
  960.     }
  961.   if (c == delimiter)
  962.     break;
  963. }
  964.       if (c)
  965. i++;
  966.     }
  967.   /* Advance to the end of the string.  */
  968.   for (; string[i] && !whitespace (string[i]); i++);
  969.   /* No extra whitespace at the end of the string. */
  970.   string[i] = '';
  971.   /* Handle equivalency bindings here.  Make the left-hand side be exactly
  972.      whatever the right-hand evaluates to, including keymaps. */
  973.   if (equivalency)
  974.     {
  975.       return 0;
  976.     }
  977.   /* If this is a new-style key-binding, then do the binding with
  978.      rl_set_key ().  Otherwise, let the older code deal with it. */
  979.   if (*string == '"')
  980.     {
  981.       char *seq;
  982.       register int j, k, passc;
  983.       seq = xmalloc (1 + strlen (string));
  984.       for (j = 1, k = passc = 0; string[j]; j++)
  985. {
  986.   /* Allow backslash to quote characters, but leave them in place.
  987.      This allows a string to end with a backslash quoting another
  988.      backslash, or with a backslash quoting a double quote.  The
  989.      backslashes are left in place for rl_translate_keyseq (). */
  990.   if (passc || (string[j] == '\'))
  991.     {
  992.       seq[k++] = string[j];
  993.       passc = !passc;
  994.       continue;
  995.     }
  996.   if (string[j] == '"')
  997.     break;
  998.   seq[k++] = string[j];
  999. }
  1000.       seq[k] = '';
  1001.       /* Binding macro? */
  1002.       if (*funname == ''' || *funname == '"')
  1003. {
  1004.   j = strlen (funname);
  1005.   /* Remove the delimiting quotes from each end of FUNNAME. */
  1006.   if (j && funname[j - 1] == *funname)
  1007.     funname[j - 1] = '';
  1008.   rl_macro_bind (seq, &funname[1], _rl_keymap);
  1009. }
  1010.       else
  1011. rl_set_key (seq, rl_named_function (funname), _rl_keymap);
  1012.       free (seq);
  1013.       return 0;
  1014.     }
  1015.   /* Get the actual character we want to deal with. */
  1016.   kname = strrchr (string, '-');
  1017.   if (!kname)
  1018.     kname = string;
  1019.   else
  1020.     kname++;
  1021.   key = glean_key_from_name (kname);
  1022.   /* Add in control and meta bits. */
  1023.   if (substring_member_of_array (string, possible_control_prefixes))
  1024.     key = CTRL (_rl_to_upper (key));
  1025.   if (substring_member_of_array (string, possible_meta_prefixes))
  1026.     key = META (key);
  1027.   /* Temporary.  Handle old-style keyname with macro-binding. */
  1028.   if (*funname == ''' || *funname == '"')
  1029.     {
  1030.       unsigned char useq[2];
  1031.       int fl = strlen (funname);
  1032.       useq[0] = key; useq[1] = '';
  1033.       if (fl && funname[fl - 1] == *funname)
  1034. funname[fl - 1] = '';
  1035.       rl_macro_bind ((char*) useq, &funname[1], _rl_keymap);
  1036.     }
  1037. #if defined (PREFIX_META_HACK)
  1038.   /* Ugly, but working hack to keep prefix-meta around. */
  1039.   else if (_rl_stricmp (funname, "prefix-meta") == 0)
  1040.     {
  1041.       char seq[2];
  1042.       seq[0] = key;
  1043.       seq[1] = '';
  1044.       rl_generic_bind (ISKMAP, seq, (char *)emacs_meta_keymap, _rl_keymap);
  1045.     }
  1046. #endif /* PREFIX_META_HACK */
  1047.   else
  1048.     rl_bind_key (key, rl_named_function (funname));
  1049.   return 0;
  1050. }
  1051. /* Simple structure for boolean readline variables (i.e., those that can
  1052.    have one of two values; either "On" or 1 for truth, or "Off" or 0 for
  1053.    false. */
  1054. static struct {
  1055.   char *name;
  1056.   int *value;
  1057. } boolean_varlist [] = {
  1058. #if defined (PAREN_MATCHING)
  1059.   { "blink-matching-paren", &rl_blink_matching_paren },
  1060. #endif
  1061.   { "completion-ignore-case", &_rl_completion_case_fold },
  1062.   { "convert-meta", &_rl_convert_meta_chars_to_ascii },
  1063.   { "disable-completion", &rl_inhibit_completion },
  1064.   { "enable-keypad", &_rl_enable_keypad },
  1065.   { "expand-tilde", &rl_complete_with_tilde_expansion },
  1066.   { "horizontal-scroll-mode", &_rl_horizontal_scroll_mode },
  1067.   { "input-meta", &_rl_meta_flag },
  1068.   { "mark-directories", &_rl_complete_mark_directories },
  1069.   { "mark-modified-lines", &_rl_mark_modified_lines },
  1070.   { "meta-flag", &_rl_meta_flag },
  1071.   { "output-meta", &_rl_output_meta_chars },
  1072.   { "print-completions-horizontally", &_rl_print_completions_horizontally },
  1073.   { "show-all-if-ambiguous", &_rl_complete_show_all },
  1074. #if defined (VISIBLE_STATS)
  1075.   { "visible-stats", &rl_visible_stats },
  1076. #endif /* VISIBLE_STATS */
  1077.   { (char *)NULL, (int *)NULL }
  1078. };
  1079. int
  1080. rl_variable_bind (name, value)
  1081.      char *name, *value;
  1082. {
  1083.   register int i;
  1084.   /* Check for simple variables first. */
  1085.   for (i = 0; boolean_varlist[i].name; i++)
  1086.     {
  1087.       if (_rl_stricmp (name, boolean_varlist[i].name) == 0)
  1088. {
  1089.   /* A variable is TRUE if the "value" is "on", "1" or "". */
  1090.   *boolean_varlist[i].value = *value == 0 ||
  1091.          _rl_stricmp (value, "on") == 0 ||
  1092.       (value[0] == '1' && value[1] == '');
  1093.   return 0;
  1094. }
  1095.     }
  1096.   /* Not a boolean variable, so check for specials. */
  1097.   /* Editing mode change? */
  1098.   if (_rl_stricmp (name, "editing-mode") == 0)
  1099.     {
  1100.       if (_rl_strnicmp (value, "vi", 2) == 0)
  1101. {
  1102. #if defined (VI_MODE)
  1103.   _rl_keymap = vi_insertion_keymap;
  1104.   rl_editing_mode = vi_mode;
  1105. #endif /* VI_MODE */
  1106. }
  1107.       else if (_rl_strnicmp (value, "emacs", 5) == 0)
  1108. {
  1109.   _rl_keymap = emacs_standard_keymap;
  1110.   rl_editing_mode = emacs_mode;
  1111. }
  1112.     }
  1113.   /* Comment string change? */
  1114.   else if (_rl_stricmp (name, "comment-begin") == 0)
  1115.     {
  1116.       if (*value)
  1117. {
  1118.   if (_rl_comment_begin)
  1119.     free (_rl_comment_begin);
  1120.   _rl_comment_begin = savestring (value);
  1121. }
  1122.     }
  1123.   else if (_rl_stricmp (name, "completion-query-items") == 0)
  1124.     {
  1125.       int nval = 100;
  1126.       if (*value)
  1127. {
  1128.   nval = atoi (value);
  1129.   if (nval < 0)
  1130.     nval = 0;
  1131. }
  1132.       rl_completion_query_items = nval;
  1133.     }
  1134.   else if (_rl_stricmp (name, "keymap") == 0)
  1135.     {
  1136.       Keymap kmap;
  1137.       kmap = rl_get_keymap_by_name (value);
  1138.       if (kmap)
  1139.         rl_set_keymap (kmap);
  1140.     }
  1141.   else if (_rl_stricmp (name, "bell-style") == 0)
  1142.     {
  1143.       if (!*value)
  1144.         _rl_bell_preference = AUDIBLE_BELL;
  1145.       else
  1146.         {
  1147.           if (_rl_stricmp (value, "none") == 0 || _rl_stricmp (value, "off") == 0)
  1148.             _rl_bell_preference = NO_BELL;
  1149.           else if (_rl_stricmp (value, "audible") == 0 || _rl_stricmp (value, "on") == 0)
  1150.             _rl_bell_preference = AUDIBLE_BELL;
  1151.           else if (_rl_stricmp (value, "visible") == 0)
  1152.             _rl_bell_preference = VISIBLE_BELL;
  1153.         }
  1154.     }
  1155.   else if (_rl_stricmp (name, "prefer-visible-bell") == 0)
  1156.     {
  1157.       /* Backwards compatibility. */
  1158.       if (*value && (_rl_stricmp (value, "on") == 0 ||
  1159.      (*value == '1' && !value[1])))
  1160.         _rl_bell_preference = VISIBLE_BELL;
  1161.       else
  1162.         _rl_bell_preference = AUDIBLE_BELL;
  1163.     }
  1164.   else if (_rl_stricmp (name, "isearch-terminators") == 0)
  1165.     {
  1166.       /* Isolate the value and translate it into a character string. */
  1167.       int beg, end;
  1168.       char *v;
  1169.       v = savestring (value);
  1170.       FREE (_rl_isearch_terminators);
  1171.       if (v[0] == '"' || v[0] == ''')
  1172. {
  1173.   int delim = v[0];
  1174.   for (beg = end = 1; v[end] && v[end] != delim; end++)
  1175.     ;
  1176. }
  1177.       else
  1178. {
  1179.   for (beg = end = 0; whitespace (v[end]) == 0; end++)
  1180.     ;
  1181. }
  1182.       v[end] = '';
  1183.       /* The value starts at v + beg.  Translate it into a character string. */
  1184.       _rl_isearch_terminators = (unsigned char *)xmalloc (2 * strlen (v) + 1);
  1185.       rl_translate_keyseq (v + beg, (char*) _rl_isearch_terminators, &end);
  1186.       _rl_isearch_terminators[end] = '';
  1187.       free (v);
  1188.     }
  1189.       
  1190.   /* For the time being, unknown variable names are simply ignored. */
  1191.   return 0;
  1192. }
  1193. /* Return the character which matches NAME.
  1194.    For example, `Space' returns ' '. */
  1195. typedef struct {
  1196.   char *name;
  1197.   int value;
  1198. } assoc_list;
  1199. static assoc_list name_key_alist[] = {
  1200.   { "DEL", 0x7f },
  1201.   { "ESC", '33' },
  1202.   { "Escape", '33' },
  1203.   { "LFD", 'n' },
  1204.   { "Newline", 'n' },
  1205.   { "RET", 'r' },
  1206.   { "Return", 'r' },
  1207.   { "Rubout", 0x7f },
  1208.   { "SPC", ' ' },
  1209.   { "Space", ' ' },
  1210.   { "Tab", 0x09 },
  1211.   { (char *)0x0, 0 }
  1212. };
  1213. static int
  1214. glean_key_from_name (name)
  1215.      char *name;
  1216. {
  1217.   register int i;
  1218.   for (i = 0; name_key_alist[i].name; i++)
  1219.     if (_rl_stricmp (name, name_key_alist[i].name) == 0)
  1220.       return (name_key_alist[i].value);
  1221.   return (*(unsigned char *)name); /* XXX was return (*name) */
  1222. }
  1223. /* Auxiliary functions to manage keymaps. */
  1224. static struct {
  1225.   char *name;
  1226.   Keymap map;
  1227. } keymap_names[] = {
  1228.   { "emacs", emacs_standard_keymap },
  1229.   { "emacs-standard", emacs_standard_keymap },
  1230.   { "emacs-meta", emacs_meta_keymap },
  1231.   { "emacs-ctlx", emacs_ctlx_keymap },
  1232. #if defined (VI_MODE)
  1233.   { "vi", vi_movement_keymap },
  1234.   { "vi-move", vi_movement_keymap },
  1235.   { "vi-command", vi_movement_keymap },
  1236.   { "vi-insert", vi_insertion_keymap },
  1237. #endif /* VI_MODE */
  1238.   { (char *)0x0, (Keymap)0x0 }
  1239. };
  1240. Keymap
  1241. rl_get_keymap_by_name (name)
  1242.      char *name;
  1243. {
  1244.   register int i;
  1245.   for (i = 0; keymap_names[i].name; i++)
  1246.     if (strcmp (name, keymap_names[i].name) == 0)
  1247.       return (keymap_names[i].map);
  1248.   return ((Keymap) NULL);
  1249. }
  1250. char *
  1251. rl_get_keymap_name (map)
  1252.      Keymap map;
  1253. {
  1254.   register int i;
  1255.   for (i = 0; keymap_names[i].name; i++)
  1256.     if (map == keymap_names[i].map)
  1257.       return (keymap_names[i].name);
  1258.   return ((char *)NULL);
  1259. }
  1260.   
  1261. void
  1262. rl_set_keymap (map)
  1263.      Keymap map;
  1264. {
  1265.   if (map)
  1266.     _rl_keymap = map;
  1267. }
  1268. Keymap
  1269. rl_get_keymap ()
  1270. {
  1271.   return (_rl_keymap);
  1272. }
  1273. void
  1274. rl_set_keymap_from_edit_mode ()
  1275. {
  1276.   if (rl_editing_mode == emacs_mode)
  1277.     _rl_keymap = emacs_standard_keymap;
  1278. #if defined (VI_MODE)
  1279.   else if (rl_editing_mode == vi_mode)
  1280.     _rl_keymap = vi_insertion_keymap;
  1281. #endif /* VI_MODE */
  1282. }
  1283. char *
  1284. rl_get_keymap_name_from_edit_mode ()
  1285. {
  1286.   if (rl_editing_mode == emacs_mode)
  1287.     return "emacs";
  1288. #if defined (VI_MODE)
  1289.   else if (rl_editing_mode == vi_mode)
  1290.     return "vi";
  1291. #endif /* VI_MODE */
  1292.   else
  1293.     return "none";
  1294. }
  1295. /* **************************************************************** */
  1296. /*     */
  1297. /*   Key Binding and Function Information     */
  1298. /*     */
  1299. /* **************************************************************** */
  1300. /* Each of the following functions produces information about the
  1301.    state of keybindings and functions known to Readline.  The info
  1302.    is always printed to rl_outstream, and in such a way that it can
  1303.    be read back in (i.e., passed to rl_parse_and_bind (). */
  1304. /* Print the names of functions known to Readline. */
  1305. void
  1306. rl_list_funmap_names ()
  1307. {
  1308.   register int i;
  1309.   char **funmap_names;
  1310.   funmap_names = rl_funmap_names ();
  1311.   if (!funmap_names)
  1312.     return;
  1313.   for (i = 0; funmap_names[i]; i++)
  1314.     fprintf (rl_outstream, "%sn", funmap_names[i]);
  1315.   free (funmap_names);
  1316. }
  1317. static char *
  1318. _rl_get_keyname (key)
  1319.      int key;
  1320. {
  1321.   char *keyname;
  1322.   int i, c;
  1323.   keyname = (char *)xmalloc (8);
  1324.   c = key;
  1325.   /* Since this is going to be used to write out keysequence-function
  1326.      pairs for possible inclusion in an inputrc file, we don't want to
  1327.      do any special meta processing on KEY. */
  1328. #if 0
  1329.   /* We might want to do this, but the old version of the code did not. */
  1330.   /* If this is an escape character, we don't want to do any more processing.
  1331.      Just add the special ESC key sequence and return. */
  1332.   if (c == ESC)
  1333.     {
  1334.       keyseq[0] = '\';
  1335.       keyseq[1] = 'e';
  1336.       keyseq[2] = '';
  1337.       return keyseq;
  1338.     }
  1339. #endif
  1340.   /* RUBOUT is translated directly into C-? */
  1341.   if (key == RUBOUT)
  1342.     {
  1343.       keyname[0] = '\';
  1344.       keyname[1] = 'C';
  1345.       keyname[2] = '-';
  1346.       keyname[3] = '?';
  1347.       keyname[4] = '';
  1348.       return keyname;
  1349.     }
  1350.   i = 0;
  1351.   /* Now add special prefixes needed for control characters.  This can
  1352.      potentially change C. */
  1353.   if (CTRL_CHAR (c))
  1354.     {
  1355.       keyname[i++] = '\';
  1356.       keyname[i++] = 'C';
  1357.       keyname[i++] = '-';
  1358.       c = _rl_to_lower (UNCTRL (c));
  1359.     }
  1360.   /* XXX experimental code.  Turn the characters that are not ASCII or
  1361.      ISO Latin 1 (128 - 159) into octal escape sequences (200 - 237).
  1362.      This changes C. */
  1363.   if (c >= 128 && c <= 159)
  1364.     {
  1365.       keyname[i++] = '\';
  1366.       keyname[i++] = '2';
  1367.       c -= 128;
  1368.       keyname[i++] = (c / 8) + '0';
  1369.       c = (c % 8) + '0';
  1370.     }
  1371.   /* Now, if the character needs to be quoted with a backslash, do that. */
  1372.   if (c == '\' || c == '"')
  1373.     keyname[i++] = '\';
  1374.   /* Now add the key, terminate the string, and return it. */
  1375.   keyname[i++] = (char) c;
  1376.   keyname[i] = '';
  1377.   return keyname;
  1378. }
  1379. /* Return a NULL terminated array of strings which represent the key
  1380.    sequences that are used to invoke FUNCTION in MAP. */
  1381. char **
  1382. rl_invoking_keyseqs_in_map (function, map)
  1383.      Function *function;
  1384.      Keymap map;
  1385. {
  1386.   register int key;
  1387.   char **result;
  1388.   int result_index, result_size;
  1389.   result = (char **)NULL;
  1390.   result_index = result_size = 0;
  1391.   for (key = 0; key < KEYMAP_SIZE; key++)
  1392.     {
  1393.       switch (map[key].type)
  1394. {
  1395. case ISMACR:
  1396.   /* Macros match, if, and only if, the pointers are identical.
  1397.      Thus, they are treated exactly like functions in here. */
  1398. case ISFUNC:
  1399.   /* If the function in the keymap is the one we are looking for,
  1400.      then add the current KEY to the list of invoking keys. */
  1401.   if (map[key].function == function)
  1402.     {
  1403.       char *keyname;
  1404.       keyname = _rl_get_keyname (key);
  1405.       if (result_index + 2 > result_size)
  1406.         {
  1407.           result_size += 10;
  1408.   result = (char **) xrealloc (result, result_size * sizeof (char *));
  1409.         }
  1410.       result[result_index++] = keyname;
  1411.       result[result_index] = (char *)NULL;
  1412.     }
  1413.   break;
  1414. case ISKMAP:
  1415.   {
  1416.     char **seqs;
  1417.     register int i;
  1418.     /* Find the list of keyseqs in this map which have FUNCTION as
  1419.        their target.  Add the key sequences found to RESULT. */
  1420.     if (map[key].function)
  1421.       seqs =
  1422.         rl_invoking_keyseqs_in_map (function, FUNCTION_TO_KEYMAP (map, key));
  1423.     else
  1424.       break;
  1425.     if (seqs == 0)
  1426.       break;
  1427.     for (i = 0; seqs[i]; i++)
  1428.       {
  1429. char *keyname = (char *)xmalloc (6 + strlen (seqs[i]));
  1430. if (key == ESC)
  1431.   sprintf (keyname, "\e");
  1432. else if (CTRL_CHAR (key))
  1433.   sprintf (keyname, "\C-%c", _rl_to_lower (UNCTRL (key)));
  1434. else if (key == RUBOUT)
  1435.   sprintf (keyname, "\C-?");
  1436. else if (key == '\' || key == '"')
  1437.   {
  1438.     keyname[0] = '\';
  1439.     keyname[1] = (char) key;
  1440.     keyname[2] = '';
  1441.   }
  1442. else
  1443.   {
  1444.     keyname[0] = (char) key;
  1445.     keyname[1] = '';
  1446.   }
  1447. strcat (keyname, seqs[i]);
  1448. free (seqs[i]);
  1449. if (result_index + 2 > result_size)
  1450.   {
  1451.     result_size += 10;
  1452.     result = (char **) xrealloc (result, result_size * sizeof (char *));
  1453.   }
  1454. result[result_index++] = keyname;
  1455. result[result_index] = (char *)NULL;
  1456.       }
  1457.     free (seqs);
  1458.   }
  1459.   break;
  1460. }
  1461.     }
  1462.   return (result);
  1463. }
  1464. /* Return a NULL terminated array of strings which represent the key
  1465.    sequences that can be used to invoke FUNCTION using the current keymap. */
  1466. char **
  1467. rl_invoking_keyseqs (function)
  1468.      Function *function;
  1469. {
  1470.   return (rl_invoking_keyseqs_in_map (function, _rl_keymap));
  1471. }
  1472. /* Print all of the functions and their bindings to rl_outstream.  If
  1473.    PRINT_READABLY is non-zero, then print the output in such a way
  1474.    that it can be read back in. */
  1475. void
  1476. rl_function_dumper (print_readably)
  1477.      int print_readably;
  1478. {
  1479.   register int i;
  1480.   char **names;
  1481.   char *name;
  1482.   names = rl_funmap_names ();
  1483.   fprintf (rl_outstream, "n");
  1484.   for (i = 0; (name = names[i]); i++)
  1485.     {
  1486.       Function *function;
  1487.       char **invokers;
  1488.       function = rl_named_function (name);
  1489.       invokers = rl_invoking_keyseqs_in_map (function, _rl_keymap);
  1490.       if (print_readably)
  1491. {
  1492.   if (!invokers)
  1493.     fprintf (rl_outstream, "# %s (not bound)n", name);
  1494.   else
  1495.     {
  1496.       register int j;
  1497.       for (j = 0; invokers[j]; j++)
  1498. {
  1499.   fprintf (rl_outstream, ""%s": %sn",
  1500.    invokers[j], name);
  1501.   free (invokers[j]);
  1502. }
  1503.       free (invokers);
  1504.     }
  1505. }
  1506.       else
  1507. {
  1508.   if (!invokers)
  1509.     fprintf (rl_outstream, "%s is not bound to any keysn",
  1510.      name);
  1511.   else
  1512.     {
  1513.       register int j;
  1514.       fprintf (rl_outstream, "%s can be found on ", name);
  1515.       for (j = 0; invokers[j] && j < 5; j++)
  1516. {
  1517.   fprintf (rl_outstream, ""%s"%s", invokers[j],
  1518.    invokers[j + 1] ? ", " : ".n");
  1519. }
  1520.       if (j == 5 && invokers[j])
  1521. fprintf (rl_outstream, "...n");
  1522.       for (j = 0; invokers[j]; j++)
  1523. free (invokers[j]);
  1524.       free (invokers);
  1525.     }
  1526. }
  1527.     }
  1528. }
  1529. /* Print all of the current functions and their bindings to
  1530.    rl_outstream.  If an explicit argument is given, then print
  1531.    the output in such a way that it can be read back in. */
  1532. int
  1533. rl_dump_functions (count, key)
  1534.      int count, key;
  1535. {
  1536.   if (rl_dispatching)
  1537.     fprintf (rl_outstream, "rn");
  1538.   rl_function_dumper (rl_explicit_arg);
  1539.   rl_on_new_line ();
  1540.   return (0);
  1541. }
  1542. static void
  1543. _rl_macro_dumper_internal (print_readably, map, prefix)
  1544.      int print_readably;
  1545.      Keymap map;
  1546.      char *prefix;
  1547. {
  1548.   register int key;
  1549.   char *keyname, *out;
  1550.   int prefix_len;
  1551.   for (key = 0; key < KEYMAP_SIZE; key++)
  1552.     {
  1553.       switch (map[key].type)
  1554. {
  1555. case ISMACR:
  1556.   keyname = _rl_get_keyname (key);
  1557. #if 0
  1558.   out = (char *)map[key].function;
  1559. #else
  1560.   out = _rl_untranslate_macro_value ((char *)map[key].function);
  1561. #endif
  1562.   if (print_readably)
  1563.     fprintf (rl_outstream, ""%s%s": "%s"n", prefix ? prefix : "",
  1564.          keyname,
  1565.          out ? out : "");
  1566.   else
  1567.     fprintf (rl_outstream, "%s%s outputs %sn", prefix ? prefix : "",
  1568. keyname,
  1569. out ? out : "");
  1570.   free (keyname);
  1571. #if 1
  1572.   free (out);
  1573. #endif
  1574.   break;
  1575. case ISFUNC:
  1576.   break;
  1577. case ISKMAP:
  1578.   prefix_len = prefix ? strlen (prefix) : 0;
  1579.   if (key == ESC)
  1580.     {
  1581.       keyname = xmalloc (3 + prefix_len);
  1582.       if (prefix)
  1583. strcpy (keyname, prefix);
  1584.       keyname[prefix_len] = '\';
  1585.       keyname[prefix_len + 1] = 'e';
  1586.       keyname[prefix_len + 2] = '';
  1587.     }
  1588.   else
  1589.     {
  1590.       keyname = _rl_get_keyname (key);
  1591.       if (prefix)
  1592. {
  1593.   out = xmalloc (strlen (keyname) + prefix_len + 1);
  1594.   strcpy (out, prefix);
  1595.   strcpy (out + prefix_len, keyname);
  1596.   free (keyname);
  1597.   keyname = out;
  1598. }
  1599.     }
  1600.   _rl_macro_dumper_internal (print_readably, FUNCTION_TO_KEYMAP (map, key), keyname);
  1601.   free (keyname);
  1602.   break;
  1603. }
  1604.     }
  1605. }
  1606. void
  1607. rl_macro_dumper (print_readably)
  1608.      int print_readably;
  1609. {
  1610.   _rl_macro_dumper_internal (print_readably, _rl_keymap, (char *)NULL);
  1611. }
  1612. int
  1613. rl_dump_macros (count, key)
  1614.      int count, key;
  1615. {
  1616.   if (rl_dispatching)
  1617.     fprintf (rl_outstream, "rn");
  1618.   rl_macro_dumper (rl_explicit_arg);
  1619.   rl_on_new_line ();
  1620.   return (0);
  1621. }
  1622. void
  1623. rl_variable_dumper (print_readably)
  1624.      int print_readably;
  1625. {
  1626.   int i;
  1627.   char *kname;
  1628.   for (i = 0; boolean_varlist[i].name; i++)
  1629.     {
  1630.       if (print_readably)
  1631.         fprintf (rl_outstream, "set %s %sn", boolean_varlist[i].name,
  1632.        *boolean_varlist[i].value ? "on" : "off");
  1633.       else
  1634.         fprintf (rl_outstream, "%s is set to `%s'n", boolean_varlist[i].name,
  1635.        *boolean_varlist[i].value ? "on" : "off");
  1636.     }
  1637.   /* bell-style */
  1638.   switch (_rl_bell_preference)
  1639.     {
  1640.     case NO_BELL:
  1641.       kname = "none"; break;
  1642.     case VISIBLE_BELL:
  1643.       kname = "visible"; break;
  1644.     case AUDIBLE_BELL:
  1645.     default:
  1646.       kname = "audible"; break;
  1647.     }
  1648.   if (print_readably)
  1649.     fprintf (rl_outstream, "set bell-style %sn", kname);
  1650.   else
  1651.     fprintf (rl_outstream, "bell-style is set to `%s'n", kname);
  1652.   /* comment-begin */
  1653.   if (print_readably)
  1654.     fprintf (rl_outstream, "set comment-begin %sn", _rl_comment_begin ? _rl_comment_begin : RL_COMMENT_BEGIN_DEFAULT);
  1655.   else
  1656.     fprintf (rl_outstream, "comment-begin is set to `%s'n", _rl_comment_begin ? _rl_comment_begin : "");
  1657.   /* completion-query-items */
  1658.   if (print_readably)
  1659.     fprintf (rl_outstream, "set completion-query-items %dn", rl_completion_query_items);
  1660.   else
  1661.     fprintf (rl_outstream, "completion-query-items is set to `%d'n", rl_completion_query_items);
  1662.   /* editing-mode */
  1663.   if (print_readably)
  1664.     fprintf (rl_outstream, "set editing-mode %sn", (rl_editing_mode == emacs_mode) ? "emacs" : "vi");
  1665.   else
  1666.     fprintf (rl_outstream, "editing-mode is set to `%s'n", (rl_editing_mode == emacs_mode) ? "emacs" : "vi");
  1667.   /* keymap */
  1668.   kname = rl_get_keymap_name (_rl_keymap);
  1669.   if (kname == 0)
  1670.     kname = rl_get_keymap_name_from_edit_mode ();
  1671.   if (print_readably)
  1672.     fprintf (rl_outstream, "set keymap %sn", kname ? kname : "none");
  1673.   else
  1674.     fprintf (rl_outstream, "keymap is set to `%s'n", kname ? kname : "none");
  1675.   /* isearch-terminators */
  1676.   if (_rl_isearch_terminators)
  1677.     {
  1678.       char *disp;
  1679.       disp = _rl_untranslate_macro_value (_rl_isearch_terminators);
  1680.       if (print_readably)
  1681. fprintf (rl_outstream, "set isearch-terminators "%s"n", disp);
  1682.       else
  1683. fprintf (rl_outstream, "isearch-terminators is set to "%s"n", disp);
  1684.       free (disp);
  1685.     }
  1686. }
  1687. /* Print all of the current variables and their values to
  1688.    rl_outstream.  If an explicit argument is given, then print
  1689.    the output in such a way that it can be read back in. */
  1690. int
  1691. rl_dump_variables (count, key)
  1692.      int count, key;
  1693. {
  1694.   if (rl_dispatching)
  1695.     fprintf (rl_outstream, "rn");
  1696.   rl_variable_dumper (rl_explicit_arg);
  1697.   rl_on_new_line ();
  1698.   return (0);
  1699. }
  1700. /* Bind key sequence KEYSEQ to DEFAULT_FUNC if KEYSEQ is unbound. */
  1701. void
  1702. _rl_bind_if_unbound (keyseq, default_func)
  1703.      char *keyseq;
  1704.      Function *default_func;
  1705. {
  1706.   Function *func;
  1707.   if (keyseq)
  1708.     {
  1709.       func = rl_function_of_keyseq (keyseq, _rl_keymap, (int *)NULL);
  1710.       if (!func || func == rl_do_lowercase_version)
  1711. rl_set_key (keyseq, default_func, _rl_keymap);
  1712.     }
  1713. }
  1714. /* Return non-zero if any members of ARRAY are a substring in STRING. */
  1715. static int
  1716. substring_member_of_array (string, array)
  1717.      char *string, **array;
  1718. {
  1719.   while (*array)
  1720.     {
  1721.       if (_rl_strindex (string, *array))
  1722. return (1);
  1723.       array++;
  1724.     }
  1725.   return (0);
  1726. }