/* tilde.h: Externally available variables and function in libtilde.a. */
|
/* tilde.h: Externally available variables and function in libtilde.a. */
|
|
|
/* Copyright (C) 1992 Free Software Foundation, Inc.
|
/* Copyright (C) 1992 Free Software Foundation, Inc.
|
|
|
This file contains the Readline Library (the Library), a set of
|
This file contains the Readline Library (the Library), a set of
|
routines for providing Emacs style line input to programs that ask
|
routines for providing Emacs style line input to programs that ask
|
for it.
|
for it.
|
|
|
The Library is free software; you can redistribute it and/or modify
|
The Library is free software; you can redistribute it and/or modify
|
it under the terms of the GNU General Public License as published by
|
it under the terms of the GNU General Public License as published by
|
the Free Software Foundation; either version 2, or (at your option)
|
the Free Software Foundation; either version 2, or (at your option)
|
any later version.
|
any later version.
|
|
|
The Library is distributed in the hope that it will be useful, but
|
The Library is distributed in the hope that it will be useful, but
|
WITHOUT ANY WARRANTY; without even the implied warranty of
|
WITHOUT ANY WARRANTY; without even the implied warranty of
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
General Public License for more details.
|
General Public License for more details.
|
|
|
The GNU General Public License is often shipped with GNU software, and
|
The GNU General Public License is often shipped with GNU software, and
|
is generally kept in a file called COPYING or LICENSE. If you do not
|
is generally kept in a file called COPYING or LICENSE. If you do not
|
have a copy of the license, write to the Free Software Foundation,
|
have a copy of the license, write to the Free Software Foundation,
|
59 Temple Place, Suite 330, Boston, MA 02111 USA. */
|
59 Temple Place, Suite 330, Boston, MA 02111 USA. */
|
|
|
#if !defined (_TILDE_H_)
|
#if !defined (_TILDE_H_)
|
# define _TILDE_H_
|
# define _TILDE_H_
|
|
|
#ifdef __cplusplus
|
#ifdef __cplusplus
|
extern "C" {
|
extern "C" {
|
#endif
|
#endif
|
|
|
/* A function can be defined using prototypes and compile on both ANSI C
|
/* A function can be defined using prototypes and compile on both ANSI C
|
and traditional C compilers with something like this:
|
and traditional C compilers with something like this:
|
extern char *func PARAMS((char *, char *, int)); */
|
extern char *func PARAMS((char *, char *, int)); */
|
|
|
#if !defined (PARAMS)
|
#if !defined (PARAMS)
|
# if defined (__STDC__) || defined (__GNUC__) || defined (__cplusplus)
|
# if defined (__STDC__) || defined (__GNUC__) || defined (__cplusplus)
|
# define PARAMS(protos) protos
|
# define PARAMS(protos) protos
|
# else
|
# else
|
# define PARAMS(protos) ()
|
# define PARAMS(protos) ()
|
# endif
|
# endif
|
#endif
|
#endif
|
|
|
typedef char *tilde_hook_func_t PARAMS((char *));
|
typedef char *tilde_hook_func_t PARAMS((char *));
|
|
|
/* If non-null, this contains the address of a function that the application
|
/* If non-null, this contains the address of a function that the application
|
wants called before trying the standard tilde expansions. The function
|
wants called before trying the standard tilde expansions. The function
|
is called with the text sans tilde, and returns a malloc()'ed string
|
is called with the text sans tilde, and returns a malloc()'ed string
|
which is the expansion, or a NULL pointer if the expansion fails. */
|
which is the expansion, or a NULL pointer if the expansion fails. */
|
extern tilde_hook_func_t *tilde_expansion_preexpansion_hook;
|
extern tilde_hook_func_t *tilde_expansion_preexpansion_hook;
|
|
|
/* If non-null, this contains the address of a function to call if the
|
/* If non-null, this contains the address of a function to call if the
|
standard meaning for expanding a tilde fails. The function is called
|
standard meaning for expanding a tilde fails. The function is called
|
with the text (sans tilde, as in "foo"), and returns a malloc()'ed string
|
with the text (sans tilde, as in "foo"), and returns a malloc()'ed string
|
which is the expansion, or a NULL pointer if there is no expansion. */
|
which is the expansion, or a NULL pointer if there is no expansion. */
|
extern tilde_hook_func_t *tilde_expansion_failure_hook;
|
extern tilde_hook_func_t *tilde_expansion_failure_hook;
|
|
|
/* When non-null, this is a NULL terminated array of strings which
|
/* When non-null, this is a NULL terminated array of strings which
|
are duplicates for a tilde prefix. Bash uses this to expand
|
are duplicates for a tilde prefix. Bash uses this to expand
|
`=~' and `:~'. */
|
`=~' and `:~'. */
|
extern char **tilde_additional_prefixes;
|
extern char **tilde_additional_prefixes;
|
|
|
/* When non-null, this is a NULL terminated array of strings which match
|
/* When non-null, this is a NULL terminated array of strings which match
|
the end of a username, instead of just "/". Bash sets this to
|
the end of a username, instead of just "/". Bash sets this to
|
`:' and `=~'. */
|
`:' and `=~'. */
|
extern char **tilde_additional_suffixes;
|
extern char **tilde_additional_suffixes;
|
|
|
/* Return a new string which is the result of tilde expanding STRING. */
|
/* Return a new string which is the result of tilde expanding STRING. */
|
extern char *tilde_expand PARAMS((const char *));
|
extern char *tilde_expand PARAMS((const char *));
|
|
|
/* Do the work of tilde expansion on FILENAME. FILENAME starts with a
|
/* Do the work of tilde expansion on FILENAME. FILENAME starts with a
|
tilde. If there is no expansion, call tilde_expansion_failure_hook. */
|
tilde. If there is no expansion, call tilde_expansion_failure_hook. */
|
extern char *tilde_expand_word PARAMS((const char *));
|
extern char *tilde_expand_word PARAMS((const char *));
|
|
|
/* Find the portion of the string beginning with ~ that should be expanded. */
|
/* Find the portion of the string beginning with ~ that should be expanded. */
|
extern char *tilde_find_word PARAMS((const char *, int, int *));
|
extern char *tilde_find_word PARAMS((const char *, int, int *));
|
|
|
#ifdef __cplusplus
|
#ifdef __cplusplus
|
}
|
}
|
#endif
|
#endif
|
|
|
#endif /* _TILDE_H_ */
|
#endif /* _TILDE_H_ */
|
|
|
