lib/readline/tilde.h

   1 /* tilde.h: Externally available variables and function in libtilde.a. */
   2
   3 /* Copyright (C) 1992 Free Software Foundation, Inc.
   4
   5    This file contains the Readline Library (the Library), a set of
   6    routines for providing Emacs style line input to programs that ask
   7    for it.
   8
   9    The Library is free software; you can redistribute it and/or modify
  10    it under the terms of the GNU General Public License as published by
  11    the Free Software Foundation; either version 2, or (at your option)
  12    any later version.
  13
  14    The Library is distributed in the hope that it will be useful, but
  15    WITHOUT ANY WARRANTY; without even the implied warranty of
  16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  17    General Public License for more details.
  18
  19    The GNU General Public License is often shipped with GNU software, and
  20    is generally kept in a file called COPYING or LICENSE.  If you do not
  21    have a copy of the license, write to the Free Software Foundation,
  22    59 Temple Place, Suite 330, Boston, MA 02111 USA. */
  23
  24 #if !defined (_TILDE_H_)
  25 #  define _TILDE_H_
  26
  27 #ifdef __cplusplus
  28 extern "C" {
  29 #endif
  30
  31 /* A function can be defined using prototypes and compile on both ANSI C
  32    and traditional C compilers with something like this:
  33         extern char *func __P((char *, char *, int)); */
  34
  35 #if !defined (__P)
  36 #  if defined (__STDC__) || defined (__GNUC__) || defined (__cplusplus)
  37 #    define __P(protos) protos
  38 #  else
  39 #    define __P(protos) ()
  40 #  endif
  41 #endif
  42
  43 #if !defined (__STDC__) && !defined (__cplusplus)
  44 #  if defined (__GNUC__)        /* gcc with -traditional */
  45 #    if !defined (const)
  46 #      define const __const
  47 #    endif /* !const */
  48 #  else /* !__GNUC__ */
  49 #    if !defined (const)
  50 #      define const
  51 #    endif /* !const */
  52 #  endif /* !__GNUC__ */
  53 #endif /* !__STDC__ && !__cplusplus */
  54
  55 typedef char *tilde_hook_func_t __P((char *));
  56
  57 /* If non-null, this contains the address of a function that the application
  58    wants called before trying the standard tilde expansions.  The function
  59    is called with the text sans tilde, and returns a malloc()'ed string
  60    which is the expansion, or a NULL pointer if the expansion fails. */
  61 extern tilde_hook_func_t *tilde_expansion_preexpansion_hook;
  62
  63 /* If non-null, this contains the address of a function to call if the
  64    standard meaning for expanding a tilde fails.  The function is called
  65    with the text (sans tilde, as in "foo"), and returns a malloc()'ed string
  66    which is the expansion, or a NULL pointer if there is no expansion. */
  67 extern tilde_hook_func_t *tilde_expansion_failure_hook;
  68
  69 /* When non-null, this is a NULL terminated array of strings which
  70    are duplicates for a tilde prefix.  Bash uses this to expand
  71    `=~' and `:~'. */
  72 extern char **tilde_additional_prefixes;
  73
  74 /* When non-null, this is a NULL terminated array of strings which match
  75    the end of a username, instead of just "/".  Bash sets this to
  76    `:' and `=~'. */
  77 extern char **tilde_additional_suffixes;
  78
  79 /* Return a new string which is the result of tilde expanding STRING. */
  80 extern char *tilde_expand __P((const char *));
  81
  82 /* Do the work of tilde expansion on FILENAME.  FILENAME starts with a
  83    tilde.  If there is no expansion, call tilde_expansion_failure_hook. */
  84 extern char *tilde_expand_word __P((const char *));
  85
  86 #ifdef __cplusplus
  87 }
  88 #endif
  89
  90 #endif /* _TILDE_H_ */