1 /* $NetBSD: readline.h,v 1.53 2022/02/19 17:45:02 christos Exp $ */
4 * Copyright (c) 1997 The NetBSD Foundation, Inc.
7 * This code is derived from software contributed to The NetBSD Foundation
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions
13 * 1. Redistributions of source code must retain the above copyright
14 * notice, this list of conditions and the following disclaimer.
15 * 2. Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in the
17 * documentation and/or other materials provided with the distribution.
19 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
20 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
21 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
22 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
23 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29 * POSSIBILITY OF SUCH DAMAGE.
34 #include <sys/types.h>
37 /* list of readline stuff supported by editline library's readline wrapper */
40 typedef int Function(const char *, int);
41 typedef char *CPFunction(const char *, int);
42 typedef void VFunction(void);
43 typedef void rl_vcpfunc_t(char *);
44 typedef char **rl_completion_func_t(const char *, int, int);
45 typedef char *rl_compentry_func_t(const char *, int);
46 typedef int rl_command_func_t(int, int);
47 typedef int rl_hook_func_t(void);
48 typedef int rl_icppfunc_t(char **);
50 /* only supports length */
55 typedef void *histdata_t
;
57 typedef struct _hist_entry
{
62 typedef struct _keymap_entry
{
70 #define KEYMAP_SIZE 256
72 typedef KEYMAP_ENTRY KEYMAP_ENTRY_ARRAY
[KEYMAP_SIZE
];
73 typedef KEYMAP_ENTRY
*Keymap
;
75 #define control_character_threshold 0x20
76 #define control_character_bit 0x40
79 #include <sys/ioctl.h>
80 #if !defined(__sun) && !defined(__hpux) && !defined(_AIX)
81 #include <sys/ttydefaults.h>
84 #define CTRL(c) ((c) & 037)
88 #define UNCTRL(c) (((c) - 'a' + 'A')|control_character_bit)
92 #define ABORT_CHAR CTRL('G')
93 #define RL_READLINE_VERSION 0x0402
94 #define RL_PROMPT_START_IGNORE '\1'
95 #define RL_PROMPT_END_IGNORE '\2'
97 #define RL_STATE_NONE 0x000000
98 #define RL_STATE_DONE 0x000001
100 #define RL_SETSTATE(x) (rl_readline_state |= ((unsigned long) x))
101 #define RL_UNSETSTATE(x) (rl_readline_state &= ~((unsigned long) x))
102 #define RL_ISSTATE(x) (rl_readline_state & ((unsigned long) x))
104 /* global variables used by readline enabled applications */
108 extern const char *rl_library_version
;
109 extern int rl_readline_version
;
110 extern const char *rl_readline_name
;
111 extern FILE *rl_instream
;
112 extern FILE *rl_outstream
;
113 extern char *rl_line_buffer
;
114 extern int rl_point
, rl_end
;
115 extern int history_base
, history_length
;
116 extern int max_input_history
;
117 extern const char *rl_basic_quote_characters
;
118 extern const char *rl_basic_word_break_characters
;
119 extern char *rl_completer_word_break_characters
;
120 extern const char *rl_completer_quote_characters
;
121 extern rl_compentry_func_t
*rl_completion_entry_function
;
122 extern char *(*rl_completion_word_break_hook
)(void);
123 extern rl_completion_func_t
*rl_attempted_completion_function
;
124 extern int rl_attempted_completion_over
;
125 extern int rl_completion_type
;
126 extern int rl_completion_query_items
;
127 extern const char *rl_special_prefixes
;
128 extern int rl_completion_append_character
;
129 extern int rl_inhibit_completion
;
130 extern rl_hook_func_t
*rl_pre_input_hook
;
131 extern rl_hook_func_t
*rl_startup_hook
;
132 extern char *rl_terminal_name
;
133 extern int rl_already_prompted
;
134 extern char *rl_prompt
;
137 * The following is not implemented
139 extern unsigned long rl_readline_state
;
140 extern int rl_catch_signals
;
141 extern int rl_catch_sigwinch
;
142 extern KEYMAP_ENTRY_ARRAY emacs_standard_keymap
,
145 extern int rl_filename_completion_desired
;
146 extern int rl_ignore_completion_duplicates
;
147 extern int (*rl_getc_function
)(FILE *);
148 extern VFunction
*rl_redisplay_function
;
149 extern VFunction
*rl_completion_display_matches_hook
;
150 extern VFunction
*rl_prep_term_function
;
151 extern VFunction
*rl_deprep_term_function
;
152 extern rl_hook_func_t
*rl_event_hook
;
153 extern int readline_echoing_p
;
154 extern int _rl_print_completions_horizontally
;
155 extern int _rl_complete_mark_directories
;
156 extern rl_icppfunc_t
*rl_directory_completion_hook
;
157 extern int rl_completion_suppress_append
;
158 extern int rl_sort_completion_matches
;
159 extern int _rl_completion_prefix_display_length
;
160 extern int _rl_echoing_p
;
161 extern int history_max_entries
;
162 extern char *rl_display_prompt
;
163 extern int rl_erase_empty_line
;
165 /* supported functions */
166 char *readline(const char *);
167 int rl_initialize(void);
169 void using_history(void);
170 int add_history(const char *);
171 void clear_history(void);
172 int append_history(int, const char *);
173 void stifle_history(int);
174 int unstifle_history(void);
175 int history_is_stifled(void);
176 int where_history(void);
177 HIST_ENTRY
*current_history(void);
178 HIST_ENTRY
*history_get(int);
179 HIST_ENTRY
*remove_history(int);
180 HIST_ENTRY
*replace_history_entry(int, const char *, histdata_t
);
181 int history_total_bytes(void);
182 int history_set_pos(int);
183 HIST_ENTRY
*previous_history(void);
184 HIST_ENTRY
*next_history(void);
185 HIST_ENTRY
**history_list(void);
186 int history_search(const char *, int);
187 int history_search_prefix(const char *, int);
188 int history_search_pos(const char *, int, int);
189 int read_history(const char *);
190 int write_history(const char *);
191 int history_truncate_file(const char *, int);
192 int history_expand(char *, char **);
193 char **history_tokenize(const char *);
194 const char *get_history_event(const char *, int *, int);
195 char *history_arg_extract(int, int, const char *);
197 char *tilde_expand(char *);
198 char *filename_completion_function(const char *, int);
199 char *username_completion_function(const char *, int);
200 int rl_complete(int, int);
201 int rl_read_key(void);
202 char **completion_matches(/* const */ char *, rl_compentry_func_t
*);
203 void rl_display_match_list(char **, int, int);
205 int rl_insert(int, int);
206 int rl_insert_text(const char *);
207 int rl_reset_terminal(const char *);
208 void rl_resize_terminal(void);
209 int rl_bind_key(int, rl_command_func_t
*);
210 int rl_newline(int, int);
211 void rl_callback_read_char(void);
212 void rl_callback_handler_install(const char *, rl_vcpfunc_t
*);
213 void rl_callback_handler_remove(void);
214 void rl_redisplay(void);
215 int rl_get_previous_history(int, int);
216 void rl_prep_terminal(int);
217 void rl_deprep_terminal(void);
218 int rl_read_init_file(const char *);
219 int rl_parse_and_bind(const char *);
220 int rl_variable_bind(const char *, const char *);
221 int rl_stuff_char(int);
222 int rl_add_defun(const char *, rl_command_func_t
*, int);
223 HISTORY_STATE
*history_get_history_state(void);
224 void rl_get_screen_size(int *, int *);
225 void rl_set_screen_size(int, int);
226 char *rl_filename_completion_function(const char *, int);
227 int _rl_abort_internal(void);
228 int _rl_qsort_string_compare(char **, char **);
229 char **rl_completion_matches(const char *, rl_compentry_func_t
*);
230 void rl_forced_update_display(void);
231 int rl_set_prompt(const char *);
232 int rl_on_new_line(void);
233 void rl_reset_after_signal(void);
234 void rl_echo_signal_char(int);
237 char *rl_copy_text(int, int);
238 void rl_replace_line(const char *, int);
239 int rl_delete_text(int, int);
240 void rl_message(const char *format
, ...)
241 __attribute__((__format__(__printf__
, 1, 2)));
242 void rl_save_prompt(void);
243 void rl_restore_prompt(void);
246 * The following are not implemented
248 int rl_kill_text(int, int);
249 Keymap
rl_get_keymap(void);
250 void rl_set_keymap(Keymap
);
251 Keymap
rl_make_bare_keymap(void);
252 int rl_generic_bind(int, const char *, const char *, Keymap
);
253 int rl_bind_key_in_map(int, rl_command_func_t
*, Keymap
);
254 int rl_set_key(const char *, rl_command_func_t
*, Keymap
);
255 void rl_cleanup_after_signal(void);
256 void rl_free_line_state(void);
257 int rl_set_keyboard_input_timeout(int);
258 int rl_abort(int, int);
259 int rl_set_keymap_name(const char *, Keymap
);
260 histdata_t
free_history_entry(HIST_ENTRY
*);
261 void _rl_erase_entire_line(void);
267 #endif /* _READLINE_H_ */