Commit | Line | Data |
---|---|---|
c5f0f3d0 | 1 | /* Header for GDB line completion. |
32d0add0 | 2 | Copyright (C) 2000-2015 Free Software Foundation, Inc. |
c5f0f3d0 FN |
3 | |
4 | This program is free software; you can redistribute it and/or modify | |
5 | it under the terms of the GNU General Public License as published by | |
a9762ec7 | 6 | the Free Software Foundation; either version 3 of the License, or |
c5f0f3d0 FN |
7 | (at your option) any later version. |
8 | ||
9 | This program is distributed in the hope that it will be useful, | |
10 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
11 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
12 | GNU General Public License for more details. | |
13 | ||
14 | You should have received a copy of the GNU General Public License | |
a9762ec7 | 15 | along with this program. If not, see <http://www.gnu.org/licenses/>. */ |
c5f0f3d0 FN |
16 | |
17 | #if !defined (COMPLETER_H) | |
18 | #define COMPLETER_H 1 | |
19 | ||
49c4e619 | 20 | #include "gdb_vecs.h" |
7d793aa9 | 21 | #include "command.h" |
49c4e619 | 22 | |
82083d6d DE |
23 | /* Types of functions in struct match_list_displayer. */ |
24 | ||
25 | struct match_list_displayer; | |
26 | ||
27 | typedef void mld_crlf_ftype (const struct match_list_displayer *); | |
28 | typedef void mld_putch_ftype (const struct match_list_displayer *, int); | |
29 | typedef void mld_puts_ftype (const struct match_list_displayer *, | |
30 | const char *); | |
31 | typedef void mld_flush_ftype (const struct match_list_displayer *); | |
32 | typedef void mld_erase_entire_line_ftype (const struct match_list_displayer *); | |
33 | typedef void mld_beep_ftype (const struct match_list_displayer *); | |
34 | typedef int mld_read_key_ftype (const struct match_list_displayer *); | |
35 | ||
36 | /* Interface between CLI/TUI and gdb_match_list_displayer. */ | |
37 | ||
38 | struct match_list_displayer | |
39 | { | |
40 | /* The screen dimensions to work with when displaying matches. */ | |
41 | int height, width; | |
42 | ||
43 | /* Print cr,lf. */ | |
44 | mld_crlf_ftype *crlf; | |
45 | ||
46 | /* Not "putc" to avoid issues where it is a stdio macro. Sigh. */ | |
47 | mld_putch_ftype *putch; | |
48 | ||
49 | /* Print a string. */ | |
50 | mld_puts_ftype *puts; | |
51 | ||
52 | /* Flush all accumulated output. */ | |
53 | mld_flush_ftype *flush; | |
54 | ||
55 | /* Erase the currently line on the terminal (but don't discard any text the | |
56 | user has entered, readline may shortly re-print it). */ | |
57 | mld_erase_entire_line_ftype *erase_entire_line; | |
58 | ||
59 | /* Ring the bell. */ | |
60 | mld_beep_ftype *beep; | |
61 | ||
62 | /* Read one key. */ | |
63 | mld_read_key_ftype *read_key; | |
64 | }; | |
65 | ||
66 | extern void gdb_display_match_list (char **matches, int len, int max, | |
67 | const struct match_list_displayer *); | |
68 | ||
ef0b411a GB |
69 | extern const char *get_max_completions_reached_message (void); |
70 | ||
49c4e619 | 71 | extern VEC (char_ptr) *complete_line (const char *text, |
1834676b | 72 | const char *line_buffer, |
49c4e619 | 73 | int point); |
83d31a92 | 74 | |
aff410f1 MS |
75 | extern char *readline_line_completion_function (const char *text, |
76 | int matches); | |
d75b5104 | 77 | |
49c4e619 | 78 | extern VEC (char_ptr) *noop_completer (struct cmd_list_element *, |
6f937416 | 79 | const char *, const char *); |
d75b5104 | 80 | |
49c4e619 | 81 | extern VEC (char_ptr) *filename_completer (struct cmd_list_element *, |
6f937416 | 82 | const char *, const char *); |
c5f0f3d0 | 83 | |
49c4e619 | 84 | extern VEC (char_ptr) *expression_completer (struct cmd_list_element *, |
6f937416 | 85 | const char *, const char *); |
65d12d83 | 86 | |
49c4e619 | 87 | extern VEC (char_ptr) *location_completer (struct cmd_list_element *, |
6f937416 | 88 | const char *, const char *); |
c94fdfd0 | 89 | |
49c4e619 | 90 | extern VEC (char_ptr) *command_completer (struct cmd_list_element *, |
6f937416 | 91 | const char *, const char *); |
db60ec62 | 92 | |
de0bea00 | 93 | extern VEC (char_ptr) *signal_completer (struct cmd_list_element *, |
6f937416 | 94 | const char *, const char *); |
de0bea00 | 95 | |
71c24708 AA |
96 | extern VEC (char_ptr) *reg_or_group_completer (struct cmd_list_element *, |
97 | const char *, const char *); | |
98 | ||
51f0e40d AB |
99 | extern VEC (char_ptr) *reggroup_completer (struct cmd_list_element *, |
100 | const char *, const char *); | |
101 | ||
c5f0f3d0 FN |
102 | extern char *get_gdb_completer_quote_characters (void); |
103 | ||
67c296a2 PM |
104 | extern char *gdb_completion_word_break_characters (void); |
105 | ||
7d793aa9 SDJ |
106 | /* Set the word break characters array to the corresponding set of |
107 | chars, based on FN. This function is useful for cases when the | |
108 | completer doesn't know the type of the completion until some | |
109 | calculation is done (e.g., for Python functions). */ | |
110 | ||
111 | extern void set_gdb_completion_word_break_characters (completer_ftype *fn); | |
112 | ||
c5f0f3d0 FN |
113 | /* Exported to linespec.c */ |
114 | ||
d7561cbb KS |
115 | extern const char *skip_quoted_chars (const char *, const char *, |
116 | const char *); | |
4e87b832 | 117 | |
d7561cbb | 118 | extern const char *skip_quoted (const char *); |
c5f0f3d0 | 119 | |
ef0b411a GB |
120 | /* Maximum number of candidates to consider before the completer |
121 | bails by throwing MAX_COMPLETIONS_REACHED_ERROR. Negative values | |
122 | disable limiting. */ | |
123 | ||
124 | extern int max_completions; | |
125 | ||
126 | /* Object to track how many unique completions have been generated. | |
127 | Used to limit the size of generated completion lists. */ | |
128 | ||
129 | typedef htab_t completion_tracker_t; | |
130 | ||
131 | /* Create a new completion tracker. | |
132 | The result is a hash table to track added completions, or NULL | |
133 | if max_completions <= 0. If max_completions < 0, tracking is disabled. | |
134 | If max_completions == 0, the max is indeed zero. */ | |
135 | ||
136 | extern completion_tracker_t new_completion_tracker (void); | |
137 | ||
138 | /* Make a cleanup to free a completion tracker, and reset its pointer | |
139 | to NULL. */ | |
140 | ||
141 | extern struct cleanup *make_cleanup_free_completion_tracker | |
142 | (completion_tracker_t *tracker_ptr); | |
143 | ||
144 | /* Return values for maybe_add_completion. */ | |
145 | ||
146 | enum maybe_add_completion_enum | |
147 | { | |
148 | /* NAME has been recorded and max_completions has not been reached, | |
149 | or completion tracking is disabled (max_completions < 0). */ | |
150 | MAYBE_ADD_COMPLETION_OK, | |
151 | ||
152 | /* NAME has been recorded and max_completions has been reached | |
153 | (thus the caller can stop searching). */ | |
154 | MAYBE_ADD_COMPLETION_OK_MAX_REACHED, | |
155 | ||
156 | /* max-completions entries has been reached. | |
157 | Whether NAME is a duplicate or not is not determined. */ | |
158 | MAYBE_ADD_COMPLETION_MAX_REACHED, | |
159 | ||
160 | /* NAME has already been recorded. | |
161 | Note that this is never returned if completion tracking is disabled | |
162 | (max_completions < 0). */ | |
163 | MAYBE_ADD_COMPLETION_DUPLICATE | |
164 | }; | |
165 | ||
166 | /* Add the completion NAME to the list of generated completions if | |
167 | it is not there already. | |
168 | If max_completions is negative, nothing is done, not even watching | |
169 | for duplicates, and MAYBE_ADD_COMPLETION_OK is always returned. | |
170 | ||
171 | If MAYBE_ADD_COMPLETION_MAX_REACHED is returned, callers are required to | |
172 | record at least one more completion. The final list will be pruned to | |
173 | max_completions, but recording at least one more than max_completions is | |
174 | the signal to the completion machinery that too many completions were | |
175 | found. */ | |
176 | ||
177 | extern enum maybe_add_completion_enum | |
178 | maybe_add_completion (completion_tracker_t tracker, char *name); | |
179 | ||
180 | /* Wrapper to throw MAX_COMPLETIONS_REACHED_ERROR. */ | |
181 | ||
182 | extern void throw_max_completions_reached_error (void); | |
183 | ||
c5f0f3d0 | 184 | #endif /* defined (COMPLETER_H) */ |