(appt-disp-window): Do a set-buffer when the
[emacs.git] / src / minibuf.c
blobed892e9dc92962c550592e66255a66a74d2ee57f
1 /* Minibuffer input and completion.
2 Copyright (C) 1985, 1986, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
3 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007,
4 2008 Free Software Foundation, Inc.
6 This file is part of GNU Emacs.
8 GNU Emacs is free software: you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation, either version 3 of the License, or
11 (at your option) any later version.
13 GNU Emacs is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
22 #include <config.h>
23 #include <stdio.h>
25 #include "lisp.h"
26 #include "commands.h"
27 #include "buffer.h"
28 #include "character.h"
29 #include "dispextern.h"
30 #include "keyboard.h"
31 #include "frame.h"
32 #include "window.h"
33 #include "syntax.h"
34 #include "intervals.h"
35 #include "keymap.h"
36 #include "termhooks.h"
38 extern int quit_char;
40 /* List of buffers for use as minibuffers.
41 The first element of the list is used for the outermost minibuffer
42 invocation, the next element is used for a recursive minibuffer
43 invocation, etc. The list is extended at the end as deeper
44 minibuffer recursions are encountered. */
46 Lisp_Object Vminibuffer_list;
48 /* Data to remember during recursive minibuffer invocations */
50 Lisp_Object minibuf_save_list;
52 /* Depth in minibuffer invocations. */
54 int minibuf_level;
56 /* The maximum length of a minibuffer history. */
58 Lisp_Object Qhistory_length, Vhistory_length;
60 /* No duplicates in history. */
62 int history_delete_duplicates;
64 /* Non-nil means add new input to history. */
66 Lisp_Object Vhistory_add_new_input;
68 /* Fread_minibuffer leaves the input here as a string. */
70 Lisp_Object last_minibuf_string;
72 /* Nonzero means let functions called when within a minibuffer
73 invoke recursive minibuffers (to read arguments, or whatever) */
75 int enable_recursive_minibuffers;
77 /* Nonzero means don't ignore text properties
78 in Fread_from_minibuffer. */
80 int minibuffer_allow_text_properties;
82 /* help-form is bound to this while in the minibuffer. */
84 Lisp_Object Vminibuffer_help_form;
86 /* Variable which is the history list to add minibuffer values to. */
88 Lisp_Object Vminibuffer_history_variable;
90 /* Current position in the history list (adjusted by M-n and M-p). */
92 Lisp_Object Vminibuffer_history_position;
94 /* Text properties that are added to minibuffer prompts.
95 These are in addition to the basic `field' property, and stickiness
96 properties. */
98 Lisp_Object Vminibuffer_prompt_properties;
100 Lisp_Object Qminibuffer_history, Qbuffer_name_history;
102 Lisp_Object Qread_file_name_internal;
104 /* Normal hooks for entry to and exit from minibuffer. */
106 Lisp_Object Qminibuffer_setup_hook, Vminibuffer_setup_hook;
107 Lisp_Object Qminibuffer_exit_hook, Vminibuffer_exit_hook;
109 /* Function to call to read a buffer name. */
110 Lisp_Object Vread_buffer_function;
112 /* Nonzero means completion ignores case. */
114 int completion_ignore_case;
115 Lisp_Object Qcompletion_ignore_case;
116 int read_buffer_completion_ignore_case;
118 /* List of regexps that should restrict possible completions. */
120 Lisp_Object Vcompletion_regexp_list;
122 /* Nonzero means raise the minibuffer frame when the minibuffer
123 is entered. */
125 int minibuffer_auto_raise;
127 /* Keymap for reading expressions. */
128 Lisp_Object Vread_expression_map;
130 Lisp_Object Vminibuffer_completion_table, Qminibuffer_completion_table;
131 Lisp_Object Vminibuffer_completion_predicate, Qminibuffer_completion_predicate;
132 Lisp_Object Vminibuffer_completion_confirm, Qminibuffer_completion_confirm;
133 Lisp_Object Vminibuffer_completing_file_name;
135 Lisp_Object Quser_variable_p;
137 Lisp_Object Qminibuffer_default;
139 Lisp_Object Qcurrent_input_method, Qactivate_input_method;
141 Lisp_Object Qcase_fold_search;
143 Lisp_Object Qread_expression_history;
145 extern Lisp_Object Voverriding_local_map;
147 extern Lisp_Object Qmouse_face;
149 extern Lisp_Object Qfield;
151 /* Put minibuf on currently selected frame's minibuffer.
152 We do this whenever the user starts a new minibuffer
153 or when a minibuffer exits. */
155 void
156 choose_minibuf_frame ()
158 if (FRAMEP (selected_frame)
159 && FRAME_LIVE_P (XFRAME (selected_frame))
160 && !EQ (minibuf_window, XFRAME (selected_frame)->minibuffer_window))
162 struct frame *sf = XFRAME (selected_frame);
163 Lisp_Object buffer;
165 /* I don't think that any frames may validly have a null minibuffer
166 window anymore. */
167 if (NILP (sf->minibuffer_window))
168 abort ();
170 /* Under X, we come here with minibuf_window being the
171 minibuffer window of the unused termcap window created in
172 init_window_once. That window doesn't have a buffer. */
173 buffer = XWINDOW (minibuf_window)->buffer;
174 if (BUFFERP (buffer))
175 Fset_window_buffer (sf->minibuffer_window, buffer, Qnil);
176 minibuf_window = sf->minibuffer_window;
179 /* Make sure no other frame has a minibuffer as its selected window,
180 because the text would not be displayed in it, and that would be
181 confusing. Only allow the selected frame to do this,
182 and that only if the minibuffer is active. */
184 Lisp_Object tail, frame;
186 FOR_EACH_FRAME (tail, frame)
187 if (MINI_WINDOW_P (XWINDOW (FRAME_SELECTED_WINDOW (XFRAME (frame))))
188 && !(EQ (frame, selected_frame)
189 && minibuf_level > 0))
190 Fset_frame_selected_window (frame, Fframe_first_window (frame), Qnil);
194 Lisp_Object
195 choose_minibuf_frame_1 (ignore)
196 Lisp_Object ignore;
198 choose_minibuf_frame ();
199 return Qnil;
202 DEFUN ("set-minibuffer-window", Fset_minibuffer_window,
203 Sset_minibuffer_window, 1, 1, 0,
204 doc: /* Specify which minibuffer window to use for the minibuffer.
205 This affects where the minibuffer is displayed if you put text in it
206 without invoking the usual minibuffer commands. */)
207 (window)
208 Lisp_Object window;
210 CHECK_WINDOW (window);
211 if (! MINI_WINDOW_P (XWINDOW (window)))
212 error ("Window is not a minibuffer window");
214 minibuf_window = window;
216 return window;
220 /* Actual minibuffer invocation. */
222 static Lisp_Object read_minibuf_unwind P_ ((Lisp_Object));
223 static Lisp_Object run_exit_minibuf_hook P_ ((Lisp_Object));
224 static Lisp_Object read_minibuf P_ ((Lisp_Object, Lisp_Object,
225 Lisp_Object, Lisp_Object,
226 int, Lisp_Object,
227 Lisp_Object, Lisp_Object,
228 int, int));
229 static Lisp_Object read_minibuf_noninteractive P_ ((Lisp_Object, Lisp_Object,
230 Lisp_Object, Lisp_Object,
231 int, Lisp_Object,
232 Lisp_Object, Lisp_Object,
233 int, int));
234 static Lisp_Object string_to_object P_ ((Lisp_Object, Lisp_Object));
237 /* Read a Lisp object from VAL and return it. If VAL is an empty
238 string, and DEFALT is a string, read from DEFALT instead of VAL. */
240 static Lisp_Object
241 string_to_object (val, defalt)
242 Lisp_Object val, defalt;
244 struct gcpro gcpro1, gcpro2;
245 Lisp_Object expr_and_pos;
246 int pos;
248 GCPRO2 (val, defalt);
250 if (STRINGP (val) && SCHARS (val) == 0)
252 if (STRINGP (defalt))
253 val = defalt;
254 else if (CONSP (defalt) && STRINGP (XCAR (defalt)))
255 val = XCAR (defalt);
258 expr_and_pos = Fread_from_string (val, Qnil, Qnil);
259 pos = XINT (Fcdr (expr_and_pos));
260 if (pos != SCHARS (val))
262 /* Ignore trailing whitespace; any other trailing junk
263 is an error. */
264 int i;
265 pos = string_char_to_byte (val, pos);
266 for (i = pos; i < SBYTES (val); i++)
268 int c = SREF (val, i);
269 if (c != ' ' && c != '\t' && c != '\n')
270 error ("Trailing garbage following expression");
274 val = Fcar (expr_and_pos);
275 RETURN_UNGCPRO (val);
279 /* Like read_minibuf but reading from stdin. This function is called
280 from read_minibuf to do the job if noninteractive. */
282 static Lisp_Object
283 read_minibuf_noninteractive (map, initial, prompt, backup_n, expflag,
284 histvar, histpos, defalt, allow_props,
285 inherit_input_method)
286 Lisp_Object map;
287 Lisp_Object initial;
288 Lisp_Object prompt;
289 Lisp_Object backup_n;
290 int expflag;
291 Lisp_Object histvar;
292 Lisp_Object histpos;
293 Lisp_Object defalt;
294 int allow_props;
295 int inherit_input_method;
297 int size, len;
298 char *line, *s;
299 Lisp_Object val;
301 fprintf (stdout, "%s", SDATA (prompt));
302 fflush (stdout);
304 val = Qnil;
305 size = 100;
306 len = 0;
307 line = (char *) xmalloc (size * sizeof *line);
308 while ((s = fgets (line + len, size - len, stdin)) != NULL
309 && (len = strlen (line),
310 len == size - 1 && line[len - 1] != '\n'))
312 size *= 2;
313 line = (char *) xrealloc (line, size);
316 if (s)
318 len = strlen (line);
320 if (len > 0 && line[len - 1] == '\n')
321 line[--len] = '\0';
323 val = build_string (line);
324 xfree (line);
326 else
328 xfree (line);
329 error ("Error reading from stdin");
332 /* If Lisp form desired instead of string, parse it. */
333 if (expflag)
334 val = string_to_object (val, CONSP (defalt) ? XCAR (defalt) : defalt);
336 return val;
339 DEFUN ("minibufferp", Fminibufferp,
340 Sminibufferp, 0, 1, 0,
341 doc: /* Return t if BUFFER is a minibuffer.
342 No argument or nil as argument means use current buffer as BUFFER.
343 BUFFER can be a buffer or a buffer name. */)
344 (buffer)
345 Lisp_Object buffer;
347 Lisp_Object tem;
349 if (NILP (buffer))
350 buffer = Fcurrent_buffer ();
351 else if (STRINGP (buffer))
352 buffer = Fget_buffer (buffer);
353 else
354 CHECK_BUFFER (buffer);
356 tem = Fmemq (buffer, Vminibuffer_list);
357 return ! NILP (tem) ? Qt : Qnil;
360 DEFUN ("minibuffer-prompt-end", Fminibuffer_prompt_end,
361 Sminibuffer_prompt_end, 0, 0, 0,
362 doc: /* Return the buffer position of the end of the minibuffer prompt.
363 Return (point-min) if current buffer is not a minibuffer. */)
366 /* This function is written to be most efficient when there's a prompt. */
367 Lisp_Object beg, end, tem;
368 beg = make_number (BEGV);
370 tem = Fmemq (Fcurrent_buffer (), Vminibuffer_list);
371 if (NILP (tem))
372 return beg;
374 end = Ffield_end (beg, Qnil, Qnil);
376 if (XINT (end) == ZV && NILP (Fget_char_property (beg, Qfield, Qnil)))
377 return beg;
378 else
379 return end;
382 DEFUN ("minibuffer-contents", Fminibuffer_contents,
383 Sminibuffer_contents, 0, 0, 0,
384 doc: /* Return the user input in a minibuffer as a string.
385 If the current buffer is not a minibuffer, return its entire contents. */)
388 int prompt_end = XINT (Fminibuffer_prompt_end ());
389 return make_buffer_string (prompt_end, ZV, 1);
392 DEFUN ("minibuffer-contents-no-properties", Fminibuffer_contents_no_properties,
393 Sminibuffer_contents_no_properties, 0, 0, 0,
394 doc: /* Return the user input in a minibuffer as a string, without text-properties.
395 If the current buffer is not a minibuffer, return its entire contents. */)
398 int prompt_end = XINT (Fminibuffer_prompt_end ());
399 return make_buffer_string (prompt_end, ZV, 0);
402 DEFUN ("minibuffer-completion-contents", Fminibuffer_completion_contents,
403 Sminibuffer_completion_contents, 0, 0, 0,
404 doc: /* Return the user input in a minibuffer before point as a string.
405 That is what completion commands operate on.
406 If the current buffer is not a minibuffer, return its entire contents. */)
409 int prompt_end = XINT (Fminibuffer_prompt_end ());
410 if (PT < prompt_end)
411 error ("Cannot do completion in the prompt");
412 return make_buffer_string (prompt_end, PT, 1);
416 /* Read from the minibuffer using keymap MAP and initial contents INITIAL,
417 putting point minus BACKUP_N bytes from the end of INITIAL,
418 prompting with PROMPT (a string), using history list HISTVAR
419 with initial position HISTPOS. INITIAL should be a string or a
420 cons of a string and an integer. BACKUP_N should be <= 0, or
421 Qnil, which is equivalent to 0. If INITIAL is a cons, BACKUP_N is
422 ignored and replaced with an integer that puts point at one-indexed
423 position N in INITIAL, where N is the CDR of INITIAL, or at the
424 beginning of INITIAL if N <= 0.
426 Normally return the result as a string (the text that was read),
427 but if EXPFLAG is nonzero, read it and return the object read.
428 If HISTVAR is given, save the value read on that history only if it doesn't
429 match the front of that history list exactly. The value is pushed onto
430 the list as the string that was read.
432 DEFALT specifies the default value for the sake of history commands.
434 If ALLOW_PROPS is nonzero, we do not throw away text properties.
436 if INHERIT_INPUT_METHOD is nonzero, the minibuffer inherits the
437 current input method. */
439 static Lisp_Object
440 read_minibuf (map, initial, prompt, backup_n, expflag,
441 histvar, histpos, defalt, allow_props, inherit_input_method)
442 Lisp_Object map;
443 Lisp_Object initial;
444 Lisp_Object prompt;
445 Lisp_Object backup_n;
446 int expflag;
447 Lisp_Object histvar;
448 Lisp_Object histpos;
449 Lisp_Object defalt;
450 int allow_props;
451 int inherit_input_method;
453 Lisp_Object val;
454 int count = SPECPDL_INDEX ();
455 Lisp_Object mini_frame, ambient_dir, minibuffer, input_method;
456 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5;
457 Lisp_Object enable_multibyte;
458 int pos = INTEGERP (backup_n) ? XINT (backup_n) : 0;
459 /* String to add to the history. */
460 Lisp_Object histstring;
462 Lisp_Object empty_minibuf;
463 Lisp_Object dummy, frame;
465 extern Lisp_Object Qfront_sticky;
466 extern Lisp_Object Qrear_nonsticky;
468 specbind (Qminibuffer_default, defalt);
470 /* If Vminibuffer_completing_file_name is `lambda' on entry, it was t
471 in previous recursive minibuffer, but was not set explicitly
472 to t for this invocation, so set it to nil in this minibuffer.
473 Save the old value now, before we change it. */
474 specbind (intern ("minibuffer-completing-file-name"), Vminibuffer_completing_file_name);
475 if (EQ (Vminibuffer_completing_file_name, Qlambda))
476 Vminibuffer_completing_file_name = Qnil;
478 #ifdef HAVE_WINDOW_SYSTEM
479 if (display_hourglass_p)
480 cancel_hourglass ();
481 #endif
483 if (!NILP (initial))
485 if (CONSP (initial))
487 backup_n = Fcdr (initial);
488 initial = Fcar (initial);
489 CHECK_STRING (initial);
490 if (!NILP (backup_n))
492 CHECK_NUMBER (backup_n);
493 /* Convert to distance from end of input. */
494 if (XINT (backup_n) < 1)
495 /* A number too small means the beginning of the string. */
496 pos = - SCHARS (initial);
497 else
498 pos = XINT (backup_n) - 1 - SCHARS (initial);
501 else
502 CHECK_STRING (initial);
504 val = Qnil;
505 ambient_dir = current_buffer->directory;
506 input_method = Qnil;
507 enable_multibyte = Qnil;
509 /* Don't need to protect PROMPT, HISTVAR, and HISTPOS because we
510 store them away before we can GC. Don't need to protect
511 BACKUP_N because we use the value only if it is an integer. */
512 GCPRO5 (map, initial, val, ambient_dir, input_method);
514 if (!STRINGP (prompt))
515 prompt = empty_unibyte_string;
517 if (!enable_recursive_minibuffers
518 && minibuf_level > 0)
520 if (EQ (selected_window, minibuf_window))
521 error ("Command attempted to use minibuffer while in minibuffer");
522 else
523 /* If we're in another window, cancel the minibuffer that's active. */
524 Fthrow (Qexit,
525 build_string ("Command attempted to use minibuffer while in minibuffer"));
528 if (noninteractive && NILP (Vexecuting_kbd_macro))
530 val = read_minibuf_noninteractive (map, initial, prompt,
531 make_number (pos),
532 expflag, histvar, histpos, defalt,
533 allow_props, inherit_input_method);
534 UNGCPRO;
535 return unbind_to (count, val);
538 /* Choose the minibuffer window and frame, and take action on them. */
540 choose_minibuf_frame ();
542 record_unwind_protect (choose_minibuf_frame_1, Qnil);
544 record_unwind_protect (Fset_window_configuration,
545 Fcurrent_window_configuration (Qnil));
547 /* If the minibuffer window is on a different frame, save that
548 frame's configuration too. */
549 mini_frame = WINDOW_FRAME (XWINDOW (minibuf_window));
550 if (!EQ (mini_frame, selected_frame))
551 record_unwind_protect (Fset_window_configuration,
552 Fcurrent_window_configuration (mini_frame));
554 /* If the minibuffer is on an iconified or invisible frame,
555 make it visible now. */
556 Fmake_frame_visible (mini_frame);
558 if (minibuffer_auto_raise)
559 Fraise_frame (mini_frame);
561 temporarily_switch_to_single_kboard (XFRAME (mini_frame));
563 /* We have to do this after saving the window configuration
564 since that is what restores the current buffer. */
566 /* Arrange to restore a number of minibuffer-related variables.
567 We could bind each variable separately, but that would use lots of
568 specpdl slots. */
569 minibuf_save_list
570 = Fcons (Voverriding_local_map,
571 Fcons (minibuf_window,
572 minibuf_save_list));
573 minibuf_save_list
574 = Fcons (minibuf_prompt,
575 Fcons (make_number (minibuf_prompt_width),
576 Fcons (Vhelp_form,
577 Fcons (Vcurrent_prefix_arg,
578 Fcons (Vminibuffer_history_position,
579 Fcons (Vminibuffer_history_variable,
580 minibuf_save_list))))));
582 record_unwind_protect (read_minibuf_unwind, Qnil);
583 minibuf_level++;
584 /* We are exiting the minibuffer one way or the other, so run the hook.
585 It should be run before unwinding the minibuf settings. Do it
586 separately from read_minibuf_unwind because we need to make sure that
587 read_minibuf_unwind is fully executed even if exit-minibuffer-hook
588 signals an error. --Stef */
589 record_unwind_protect (run_exit_minibuf_hook, Qnil);
591 /* Now that we can restore all those variables, start changing them. */
593 minibuf_prompt_width = 0;
594 minibuf_prompt = Fcopy_sequence (prompt);
595 Vminibuffer_history_position = histpos;
596 Vminibuffer_history_variable = histvar;
597 Vhelp_form = Vminibuffer_help_form;
598 /* If this minibuffer is reading a file name, that doesn't mean
599 recursive ones are. But we cannot set it to nil, because
600 completion code still need to know the minibuffer is completing a
601 file name. So use `lambda' as intermediate value meaning
602 "t" in this minibuffer, but "nil" in next minibuffer. */
603 if (!NILP (Vminibuffer_completing_file_name))
604 Vminibuffer_completing_file_name = Qlambda;
606 if (inherit_input_method)
608 /* `current-input-method' is buffer local. So, remember it in
609 INPUT_METHOD before changing the current buffer. */
610 input_method = Fsymbol_value (Qcurrent_input_method);
611 enable_multibyte = current_buffer->enable_multibyte_characters;
614 /* Switch to the minibuffer. */
616 minibuffer = get_minibuffer (minibuf_level);
617 Fset_buffer (minibuffer);
619 /* If appropriate, copy enable-multibyte-characters into the minibuffer. */
620 if (inherit_input_method)
621 current_buffer->enable_multibyte_characters = enable_multibyte;
623 /* The current buffer's default directory is usually the right thing
624 for our minibuffer here. However, if you're typing a command at
625 a minibuffer-only frame when minibuf_level is zero, then buf IS
626 the current_buffer, so reset_buffer leaves buf's default
627 directory unchanged. This is a bummer when you've just started
628 up Emacs and buf's default directory is Qnil. Here's a hack; can
629 you think of something better to do? Find another buffer with a
630 better directory, and use that one instead. */
631 if (STRINGP (ambient_dir))
632 current_buffer->directory = ambient_dir;
633 else
635 Lisp_Object buf_list;
637 for (buf_list = Vbuffer_alist;
638 CONSP (buf_list);
639 buf_list = XCDR (buf_list))
641 Lisp_Object other_buf;
643 other_buf = XCDR (XCAR (buf_list));
644 if (STRINGP (XBUFFER (other_buf)->directory))
646 current_buffer->directory = XBUFFER (other_buf)->directory;
647 break;
652 if (!EQ (mini_frame, selected_frame))
653 Fredirect_frame_focus (selected_frame, mini_frame);
655 Vminibuf_scroll_window = selected_window;
656 if (minibuf_level == 1 || !EQ (minibuf_window, selected_window))
657 minibuf_selected_window = selected_window;
659 /* Empty out the minibuffers of all frames other than the one
660 where we are going to display one now.
661 Set them to point to ` *Minibuf-0*', which is always empty. */
662 empty_minibuf = Fget_buffer (build_string (" *Minibuf-0*"));
664 FOR_EACH_FRAME (dummy, frame)
666 Lisp_Object root_window = Fframe_root_window (frame);
667 Lisp_Object mini_window = XWINDOW (root_window)->next;
669 if (! NILP (mini_window) && ! EQ (mini_window, minibuf_window)
670 && !NILP (Fwindow_minibuffer_p (mini_window)))
671 Fset_window_buffer (mini_window, empty_minibuf, Qnil);
674 /* Display this minibuffer in the proper window. */
675 Fset_window_buffer (minibuf_window, Fcurrent_buffer (), Qnil);
676 Fselect_window (minibuf_window, Qnil);
677 XSETFASTINT (XWINDOW (minibuf_window)->hscroll, 0);
679 Fmake_local_variable (Qprint_escape_newlines);
680 print_escape_newlines = 1;
682 /* Erase the buffer. */
684 int count1 = SPECPDL_INDEX ();
685 specbind (Qinhibit_read_only, Qt);
686 specbind (Qinhibit_modification_hooks, Qt);
687 Ferase_buffer ();
689 if (!NILP (current_buffer->enable_multibyte_characters)
690 && ! STRING_MULTIBYTE (minibuf_prompt))
691 minibuf_prompt = Fstring_make_multibyte (minibuf_prompt);
693 /* Insert the prompt, record where it ends. */
694 Finsert (1, &minibuf_prompt);
695 if (PT > BEG)
697 Fput_text_property (make_number (BEG), make_number (PT),
698 Qfront_sticky, Qt, Qnil);
699 Fput_text_property (make_number (BEG), make_number (PT),
700 Qrear_nonsticky, Qt, Qnil);
701 Fput_text_property (make_number (BEG), make_number (PT),
702 Qfield, Qt, Qnil);
703 Fadd_text_properties (make_number (BEG), make_number (PT),
704 Vminibuffer_prompt_properties, Qnil);
706 unbind_to (count1, Qnil);
709 minibuf_prompt_width = (int) current_column (); /* iftc */
711 /* Put in the initial input. */
712 if (!NILP (initial))
714 Finsert (1, &initial);
715 Fforward_char (make_number (pos));
718 clear_message (1, 1);
719 current_buffer->keymap = map;
721 /* Turn on an input method stored in INPUT_METHOD if any. */
722 if (STRINGP (input_method) && !NILP (Ffboundp (Qactivate_input_method)))
723 call1 (Qactivate_input_method, input_method);
725 /* Run our hook, but not if it is empty.
726 (run-hooks would do nothing if it is empty,
727 but it's important to save time here in the usual case.) */
728 if (!NILP (Vminibuffer_setup_hook) && !EQ (Vminibuffer_setup_hook, Qunbound)
729 && !NILP (Vrun_hooks))
730 call1 (Vrun_hooks, Qminibuffer_setup_hook);
732 /* Don't allow the user to undo past this point. */
733 current_buffer->undo_list = Qnil;
735 recursive_edit_1 ();
737 /* If cursor is on the minibuffer line,
738 show the user we have exited by putting it in column 0. */
739 if (XWINDOW (minibuf_window)->cursor.vpos >= 0
740 && !noninteractive)
742 XWINDOW (minibuf_window)->cursor.hpos = 0;
743 XWINDOW (minibuf_window)->cursor.x = 0;
744 XWINDOW (minibuf_window)->must_be_updated_p = 1;
745 update_frame (XFRAME (selected_frame), 1, 1);
747 struct frame *f = XFRAME (XWINDOW (minibuf_window)->frame);
748 struct redisplay_interface *rif = FRAME_RIF (f);
749 if (rif && rif->flush_display)
750 rif->flush_display (f);
754 /* Make minibuffer contents into a string. */
755 Fset_buffer (minibuffer);
756 if (allow_props)
757 val = Fminibuffer_contents ();
758 else
759 val = Fminibuffer_contents_no_properties ();
761 /* VAL is the string of minibuffer text. */
763 last_minibuf_string = val;
765 /* Choose the string to add to the history. */
766 if (SCHARS (val) != 0)
767 histstring = val;
768 else if (STRINGP (defalt))
769 histstring = defalt;
770 else if (CONSP (defalt) && STRINGP (XCAR (defalt)))
771 histstring = XCAR (defalt);
772 else
773 histstring = Qnil;
775 /* Add the value to the appropriate history list, if any. */
776 if (!NILP (Vhistory_add_new_input)
777 && SYMBOLP (Vminibuffer_history_variable)
778 && !NILP (histstring))
780 /* If the caller wanted to save the value read on a history list,
781 then do so if the value is not already the front of the list. */
782 Lisp_Object histval;
784 /* If variable is unbound, make it nil. */
786 histval = find_symbol_value (Vminibuffer_history_variable);
787 if (EQ (histval, Qunbound))
788 Fset (Vminibuffer_history_variable, Qnil);
790 /* The value of the history variable must be a cons or nil. Other
791 values are unacceptable. We silently ignore these values. */
793 if (NILP (histval)
794 || (CONSP (histval)
795 /* Don't duplicate the most recent entry in the history. */
796 && (NILP (Fequal (histstring, Fcar (histval))))))
798 Lisp_Object length;
800 if (history_delete_duplicates) Fdelete (histstring, histval);
801 histval = Fcons (histstring, histval);
802 Fset (Vminibuffer_history_variable, histval);
804 /* Truncate if requested. */
805 length = Fget (Vminibuffer_history_variable, Qhistory_length);
806 if (NILP (length)) length = Vhistory_length;
807 if (INTEGERP (length))
809 if (XINT (length) <= 0)
810 Fset (Vminibuffer_history_variable, Qnil);
811 else
813 Lisp_Object temp;
815 temp = Fnthcdr (Fsub1 (length), histval);
816 if (CONSP (temp)) Fsetcdr (temp, Qnil);
822 /* If Lisp form desired instead of string, parse it. */
823 if (expflag)
824 val = string_to_object (val, defalt);
826 /* The appropriate frame will get selected
827 in set-window-configuration. */
828 UNGCPRO;
829 return unbind_to (count, val);
832 /* Return a buffer to be used as the minibuffer at depth `depth'.
833 depth = 0 is the lowest allowed argument, and that is the value
834 used for nonrecursive minibuffer invocations */
836 Lisp_Object
837 get_minibuffer (depth)
838 int depth;
840 Lisp_Object tail, num, buf;
841 char name[24];
842 extern Lisp_Object nconc2 ();
844 XSETFASTINT (num, depth);
845 tail = Fnthcdr (num, Vminibuffer_list);
846 if (NILP (tail))
848 tail = Fcons (Qnil, Qnil);
849 Vminibuffer_list = nconc2 (Vminibuffer_list, tail);
851 buf = Fcar (tail);
852 if (NILP (buf) || NILP (XBUFFER (buf)->name))
854 sprintf (name, " *Minibuf-%d*", depth);
855 buf = Fget_buffer_create (build_string (name));
857 /* Although the buffer's name starts with a space, undo should be
858 enabled in it. */
859 Fbuffer_enable_undo (buf);
861 XSETCAR (tail, buf);
863 else
865 int count = SPECPDL_INDEX ();
866 /* `reset_buffer' blindly sets the list of overlays to NULL, so we
867 have to empty the list, otherwise we end up with overlays that
868 think they belong to this buffer while the buffer doesn't know about
869 them any more. */
870 delete_all_overlays (XBUFFER (buf));
871 reset_buffer (XBUFFER (buf));
872 record_unwind_protect (Fset_buffer, Fcurrent_buffer ());
873 Fset_buffer (buf);
874 Fkill_all_local_variables ();
875 unbind_to (count, Qnil);
878 return buf;
881 static Lisp_Object
882 run_exit_minibuf_hook (data)
883 Lisp_Object data;
885 if (!NILP (Vminibuffer_exit_hook) && !EQ (Vminibuffer_exit_hook, Qunbound)
886 && !NILP (Vrun_hooks))
887 safe_run_hooks (Qminibuffer_exit_hook);
889 return Qnil;
892 /* This function is called on exiting minibuffer, whether normally or
893 not, and it restores the current window, buffer, etc. */
895 static Lisp_Object
896 read_minibuf_unwind (data)
897 Lisp_Object data;
899 Lisp_Object old_deactivate_mark;
900 Lisp_Object window;
902 /* If this was a recursive minibuffer,
903 tie the minibuffer window back to the outer level minibuffer buffer. */
904 minibuf_level--;
906 window = minibuf_window;
907 /* To keep things predictable, in case it matters, let's be in the
908 minibuffer when we reset the relevant variables. */
909 Fset_buffer (XWINDOW (window)->buffer);
911 /* Restore prompt, etc, from outer minibuffer level. */
912 minibuf_prompt = Fcar (minibuf_save_list);
913 minibuf_save_list = Fcdr (minibuf_save_list);
914 minibuf_prompt_width = XFASTINT (Fcar (minibuf_save_list));
915 minibuf_save_list = Fcdr (minibuf_save_list);
916 Vhelp_form = Fcar (minibuf_save_list);
917 minibuf_save_list = Fcdr (minibuf_save_list);
918 Vcurrent_prefix_arg = Fcar (minibuf_save_list);
919 minibuf_save_list = Fcdr (minibuf_save_list);
920 Vminibuffer_history_position = Fcar (minibuf_save_list);
921 minibuf_save_list = Fcdr (minibuf_save_list);
922 Vminibuffer_history_variable = Fcar (minibuf_save_list);
923 minibuf_save_list = Fcdr (minibuf_save_list);
924 Voverriding_local_map = Fcar (minibuf_save_list);
925 minibuf_save_list = Fcdr (minibuf_save_list);
926 #if 0
927 temp = Fcar (minibuf_save_list);
928 if (FRAME_LIVE_P (XFRAME (WINDOW_FRAME (XWINDOW (temp)))))
929 minibuf_window = temp;
930 #endif
931 minibuf_save_list = Fcdr (minibuf_save_list);
933 /* Erase the minibuffer we were using at this level. */
935 int count = SPECPDL_INDEX ();
936 /* Prevent error in erase-buffer. */
937 specbind (Qinhibit_read_only, Qt);
938 specbind (Qinhibit_modification_hooks, Qt);
939 old_deactivate_mark = Vdeactivate_mark;
940 Ferase_buffer ();
941 Vdeactivate_mark = old_deactivate_mark;
942 unbind_to (count, Qnil);
945 /* When we get to the outmost level, make sure we resize the
946 mini-window back to its normal size. */
947 if (minibuf_level == 0)
948 resize_mini_window (XWINDOW (window), 0);
950 /* Make sure minibuffer window is erased, not ignored. */
951 windows_or_buffers_changed++;
952 XSETFASTINT (XWINDOW (window)->last_modified, 0);
953 XSETFASTINT (XWINDOW (window)->last_overlay_modified, 0);
954 return Qnil;
958 DEFUN ("read-from-minibuffer", Fread_from_minibuffer, Sread_from_minibuffer, 1, 7, 0,
959 doc: /* Read a string from the minibuffer, prompting with string PROMPT.
960 The optional second arg INITIAL-CONTENTS is an obsolete alternative to
961 DEFAULT-VALUE. It normally should be nil in new code, except when
962 HIST is a cons. It is discussed in more detail below.
963 Third arg KEYMAP is a keymap to use whilst reading;
964 if omitted or nil, the default is `minibuffer-local-map'.
965 If fourth arg READ is non-nil, then interpret the result as a Lisp object
966 and return that object:
967 in other words, do `(car (read-from-string INPUT-STRING))'
968 Fifth arg HIST, if non-nil, specifies a history list and optionally
969 the initial position in the list. It can be a symbol, which is the
970 history list variable to use, or it can be a cons cell
971 (HISTVAR . HISTPOS). In that case, HISTVAR is the history list variable
972 to use, and HISTPOS is the initial position for use by the minibuffer
973 history commands. For consistency, you should also specify that
974 element of the history as the value of INITIAL-CONTENTS. Positions
975 are counted starting from 1 at the beginning of the list.
976 Sixth arg DEFAULT-VALUE is the default value or the list of default values.
977 If non-nil, it is available for history commands, and as the value
978 (or the first element of the list of default values) to return
979 if the user enters the empty string. But, unless READ is non-nil,
980 `read-from-minibuffer' does NOT return DEFAULT-VALUE if the user enters
981 empty input! It returns the empty string.
982 Seventh arg INHERIT-INPUT-METHOD, if non-nil, means the minibuffer inherits
983 the current input method and the setting of `enable-multibyte-characters'.
984 If the variable `minibuffer-allow-text-properties' is non-nil,
985 then the string which is returned includes whatever text properties
986 were present in the minibuffer. Otherwise the value has no text properties.
988 The remainder of this documentation string describes the
989 INITIAL-CONTENTS argument in more detail. It is only relevant when
990 studying existing code, or when HIST is a cons. If non-nil,
991 INITIAL-CONTENTS is a string to be inserted into the minibuffer before
992 reading input. Normally, point is put at the end of that string.
993 However, if INITIAL-CONTENTS is \(STRING . POSITION), the initial
994 input is STRING, but point is placed at _one-indexed_ position
995 POSITION in the minibuffer. Any integer value less than or equal to
996 one puts point at the beginning of the string. *Note* that this
997 behavior differs from the way such arguments are used in `completing-read'
998 and some related functions, which use zero-indexing for POSITION. */)
999 (prompt, initial_contents, keymap, read, hist, default_value, inherit_input_method)
1000 Lisp_Object prompt, initial_contents, keymap, read, hist, default_value;
1001 Lisp_Object inherit_input_method;
1003 Lisp_Object histvar, histpos, val;
1004 struct gcpro gcpro1;
1006 CHECK_STRING (prompt);
1007 if (NILP (keymap))
1008 keymap = Vminibuffer_local_map;
1009 else
1010 keymap = get_keymap (keymap, 1, 0);
1012 if (SYMBOLP (hist))
1014 histvar = hist;
1015 histpos = Qnil;
1017 else
1019 histvar = Fcar_safe (hist);
1020 histpos = Fcdr_safe (hist);
1022 if (NILP (histvar))
1023 histvar = Qminibuffer_history;
1024 if (NILP (histpos))
1025 XSETFASTINT (histpos, 0);
1027 GCPRO1 (default_value);
1028 val = read_minibuf (keymap, initial_contents, prompt,
1029 Qnil, !NILP (read),
1030 histvar, histpos, default_value,
1031 minibuffer_allow_text_properties,
1032 !NILP (inherit_input_method));
1033 UNGCPRO;
1034 return val;
1037 DEFUN ("read-minibuffer", Fread_minibuffer, Sread_minibuffer, 1, 2, 0,
1038 doc: /* Return a Lisp object read using the minibuffer, unevaluated.
1039 Prompt with PROMPT. If non-nil, optional second arg INITIAL-CONTENTS
1040 is a string to insert in the minibuffer before reading.
1041 \(INITIAL-CONTENTS can also be a cons of a string and an integer.
1042 Such arguments are used as in `read-from-minibuffer'.) */)
1043 (prompt, initial_contents)
1044 Lisp_Object prompt, initial_contents;
1046 CHECK_STRING (prompt);
1047 return read_minibuf (Vminibuffer_local_map, initial_contents,
1048 prompt, Qnil, 1, Qminibuffer_history,
1049 make_number (0), Qnil, 0, 0);
1052 DEFUN ("eval-minibuffer", Feval_minibuffer, Seval_minibuffer, 1, 2, 0,
1053 doc: /* Return value of Lisp expression read using the minibuffer.
1054 Prompt with PROMPT. If non-nil, optional second arg INITIAL-CONTENTS
1055 is a string to insert in the minibuffer before reading.
1056 \(INITIAL-CONTENTS can also be a cons of a string and an integer.
1057 Such arguments are used as in `read-from-minibuffer'.) */)
1058 (prompt, initial_contents)
1059 Lisp_Object prompt, initial_contents;
1061 return Feval (read_minibuf (Vread_expression_map, initial_contents,
1062 prompt, Qnil, 1, Qread_expression_history,
1063 make_number (0), Qnil, 0, 0));
1066 /* Functions that use the minibuffer to read various things. */
1068 DEFUN ("read-string", Fread_string, Sread_string, 1, 5, 0,
1069 doc: /* Read a string from the minibuffer, prompting with string PROMPT.
1070 If non-nil, second arg INITIAL-INPUT is a string to insert before reading.
1071 This argument has been superseded by DEFAULT-VALUE and should normally
1072 be nil in new code. It behaves as in `read-from-minibuffer'. See the
1073 documentation string of that function for details.
1074 The third arg HISTORY, if non-nil, specifies a history list
1075 and optionally the initial position in the list.
1076 See `read-from-minibuffer' for details of HISTORY argument.
1077 Fourth arg DEFAULT-VALUE is the default value or the list of default values.
1078 If non-nil, it is used for history commands, and as the value (or the first
1079 element of the list of default values) to return if the user enters the
1080 empty string.
1081 Fifth arg INHERIT-INPUT-METHOD, if non-nil, means the minibuffer inherits
1082 the current input method and the setting of `enable-multibyte-characters'. */)
1083 (prompt, initial_input, history, default_value, inherit_input_method)
1084 Lisp_Object prompt, initial_input, history, default_value;
1085 Lisp_Object inherit_input_method;
1087 Lisp_Object val;
1088 val = Fread_from_minibuffer (prompt, initial_input, Qnil,
1089 Qnil, history, default_value,
1090 inherit_input_method);
1091 if (STRINGP (val) && SCHARS (val) == 0 && ! NILP (default_value))
1092 val = CONSP (default_value) ? XCAR (default_value) : default_value;
1093 return val;
1096 DEFUN ("read-no-blanks-input", Fread_no_blanks_input, Sread_no_blanks_input, 1, 3, 0,
1097 doc: /* Read a string from the terminal, not allowing blanks.
1098 Prompt with PROMPT. Whitespace terminates the input. If INITIAL is
1099 non-nil, it should be a string, which is used as initial input, with
1100 point positioned at the end, so that SPACE will accept the input.
1101 \(Actually, INITIAL can also be a cons of a string and an integer.
1102 Such values are treated as in `read-from-minibuffer', but are normally
1103 not useful in this function.)
1104 Third arg INHERIT-INPUT-METHOD, if non-nil, means the minibuffer inherits
1105 the current input method and the setting of`enable-multibyte-characters'. */)
1106 (prompt, initial, inherit_input_method)
1107 Lisp_Object prompt, initial, inherit_input_method;
1109 CHECK_STRING (prompt);
1110 return read_minibuf (Vminibuffer_local_ns_map, initial, prompt, Qnil,
1111 0, Qminibuffer_history, make_number (0), Qnil, 0,
1112 !NILP (inherit_input_method));
1115 DEFUN ("read-command", Fread_command, Sread_command, 1, 2, 0,
1116 doc: /* Read the name of a command and return as a symbol.
1117 Prompt with PROMPT. By default, return DEFAULT-VALUE or its first element
1118 if it is a list. */)
1119 (prompt, default_value)
1120 Lisp_Object prompt, default_value;
1122 Lisp_Object name, default_string;
1124 if (NILP (default_value))
1125 default_string = Qnil;
1126 else if (SYMBOLP (default_value))
1127 default_string = SYMBOL_NAME (default_value);
1128 else
1129 default_string = default_value;
1131 name = Fcompleting_read (prompt, Vobarray, Qcommandp, Qt,
1132 Qnil, Qnil, default_string, Qnil);
1133 if (NILP (name))
1134 return name;
1135 return Fintern (name, Qnil);
1138 #ifdef NOTDEF
1139 DEFUN ("read-function", Fread_function, Sread_function, 1, 1, 0,
1140 doc: /* One arg PROMPT, a string. Read the name of a function and return as a symbol.
1141 Prompt with PROMPT. */)
1142 (prompt)
1143 Lisp_Object prompt;
1145 return Fintern (Fcompleting_read (prompt, Vobarray, Qfboundp, Qt, Qnil, Qnil, Qnil, Qnil),
1146 Qnil);
1148 #endif /* NOTDEF */
1150 DEFUN ("read-variable", Fread_variable, Sread_variable, 1, 2, 0,
1151 doc: /* Read the name of a user variable and return it as a symbol.
1152 Prompt with PROMPT. By default, return DEFAULT-VALUE or its first element
1153 if it is a list.
1154 A user variable is one for which `user-variable-p' returns non-nil. */)
1155 (prompt, default_value)
1156 Lisp_Object prompt, default_value;
1158 Lisp_Object name, default_string;
1160 if (NILP (default_value))
1161 default_string = Qnil;
1162 else if (SYMBOLP (default_value))
1163 default_string = SYMBOL_NAME (default_value);
1164 else
1165 default_string = default_value;
1167 name = Fcompleting_read (prompt, Vobarray,
1168 Quser_variable_p, Qt,
1169 Qnil, Qnil, default_string, Qnil);
1170 if (NILP (name))
1171 return name;
1172 return Fintern (name, Qnil);
1175 DEFUN ("read-buffer", Fread_buffer, Sread_buffer, 1, 3, 0,
1176 doc: /* Read the name of a buffer and return as a string.
1177 Prompt with PROMPT.
1178 Optional second arg DEF is value to return if user enters an empty line.
1179 If DEF is a list of default values, return its first element.
1180 If optional third arg REQUIRE-MATCH is non-nil,
1181 only existing buffer names are allowed.
1182 The argument PROMPT should be a string ending with a colon and a space.
1183 If `read-buffer-completion-ignore-case' is non-nil, completion ignores
1184 case while reading the buffer name.
1185 If `read-buffer-function' is non-nil, this works by calling it as a
1186 function, instead of the usual behavior. */)
1187 (prompt, def, require_match)
1188 Lisp_Object prompt, def, require_match;
1190 Lisp_Object args[4], result;
1191 unsigned char *s;
1192 int len;
1193 int count = SPECPDL_INDEX ();
1195 if (BUFFERP (def))
1196 def = XBUFFER (def)->name;
1198 specbind (Qcompletion_ignore_case,
1199 read_buffer_completion_ignore_case ? Qt : Qnil);
1201 if (NILP (Vread_buffer_function))
1203 if (!NILP (def))
1205 /* A default value was provided: we must change PROMPT,
1206 editing the default value in before the colon. To achieve
1207 this, we replace PROMPT with a substring that doesn't
1208 contain the terminal space and colon (if present). They
1209 are then added back using Fformat. */
1211 if (STRINGP (prompt))
1213 s = SDATA (prompt);
1214 len = strlen (s);
1215 if (len >= 2 && s[len - 2] == ':' && s[len - 1] == ' ')
1216 len = len - 2;
1217 else if (len >= 1 && (s[len - 1] == ':' || s[len - 1] == ' '))
1218 len--;
1220 prompt = make_specified_string (s, -1, len,
1221 STRING_MULTIBYTE (prompt));
1224 args[0] = build_string ("%s (default %s): ");
1225 args[1] = prompt;
1226 args[2] = CONSP (def) ? XCAR (def) : def;
1227 prompt = Fformat (3, args);
1230 result = Fcompleting_read (prompt, intern ("internal-complete-buffer"),
1231 Qnil, require_match, Qnil, Qbuffer_name_history,
1232 def, Qnil);
1234 else
1236 args[0] = Vread_buffer_function;
1237 args[1] = prompt;
1238 args[2] = def;
1239 args[3] = require_match;
1240 result = Ffuncall(4, args);
1242 return unbind_to (count, result);
1245 static Lisp_Object
1246 minibuf_conform_representation (string, basis)
1247 Lisp_Object string, basis;
1249 if (STRING_MULTIBYTE (string) == STRING_MULTIBYTE (basis))
1250 return string;
1252 if (STRING_MULTIBYTE (string))
1253 return Fstring_make_unibyte (string);
1254 else
1255 return Fstring_make_multibyte (string);
1258 DEFUN ("try-completion", Ftry_completion, Stry_completion, 2, 3, 0,
1259 doc: /* Return common substring of all completions of STRING in COLLECTION.
1260 Test each possible completion specified by COLLECTION
1261 to see if it begins with STRING. The possible completions may be
1262 strings or symbols. Symbols are converted to strings before testing,
1263 see `symbol-name'.
1264 All that match STRING are compared together; the longest initial sequence
1265 common to all these matches is the return value.
1266 If there is no match at all, the return value is nil.
1267 For a unique match which is exact, the return value is t.
1269 If COLLECTION is an alist, the keys (cars of elements) are the
1270 possible completions. If an element is not a cons cell, then the
1271 element itself is the possible completion.
1272 If COLLECTION is a hash-table, all the keys that are strings or symbols
1273 are the possible completions.
1274 If COLLECTION is an obarray, the names of all symbols in the obarray
1275 are the possible completions.
1277 COLLECTION can also be a function to do the completion itself.
1278 It receives three arguments: the values STRING, PREDICATE and nil.
1279 Whatever it returns becomes the value of `try-completion'.
1281 If optional third argument PREDICATE is non-nil,
1282 it is used to test each possible match.
1283 The match is a candidate only if PREDICATE returns non-nil.
1284 The argument given to PREDICATE is the alist element
1285 or the symbol from the obarray. If COLLECTION is a hash-table,
1286 predicate is called with two arguments: the key and the value.
1287 Additionally to this predicate, `completion-regexp-list'
1288 is used to further constrain the set of candidates. */)
1289 (string, collection, predicate)
1290 Lisp_Object string, collection, predicate;
1292 Lisp_Object bestmatch, tail, elt, eltstring;
1293 /* Size in bytes of BESTMATCH. */
1294 int bestmatchsize = 0;
1295 /* These are in bytes, too. */
1296 int compare, matchsize;
1297 enum { function_table, list_table, obarray_table, hash_table}
1298 type = (HASH_TABLE_P (collection) ? hash_table
1299 : VECTORP (collection) ? obarray_table
1300 : ((NILP (collection)
1301 || (CONSP (collection)
1302 && (!SYMBOLP (XCAR (collection))
1303 || NILP (XCAR (collection)))))
1304 ? list_table : function_table));
1305 int index = 0, obsize = 0;
1306 int matchcount = 0;
1307 int bindcount = -1;
1308 Lisp_Object bucket, zero, end, tem;
1309 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1311 CHECK_STRING (string);
1312 if (type == function_table)
1313 return call3 (collection, string, predicate, Qnil);
1315 bestmatch = bucket = Qnil;
1316 zero = make_number (0);
1318 /* If COLLECTION is not a list, set TAIL just for gc pro. */
1319 tail = collection;
1320 if (type == obarray_table)
1322 collection = check_obarray (collection);
1323 obsize = XVECTOR (collection)->size;
1324 bucket = XVECTOR (collection)->contents[index];
1327 while (1)
1329 /* Get the next element of the alist, obarray, or hash-table. */
1330 /* Exit the loop if the elements are all used up. */
1331 /* elt gets the alist element or symbol.
1332 eltstring gets the name to check as a completion. */
1334 if (type == list_table)
1336 if (!CONSP (tail))
1337 break;
1338 elt = XCAR (tail);
1339 eltstring = CONSP (elt) ? XCAR (elt) : elt;
1340 tail = XCDR (tail);
1342 else if (type == obarray_table)
1344 if (!EQ (bucket, zero))
1346 if (!SYMBOLP (bucket))
1347 error ("Bad data in guts of obarray");
1348 elt = bucket;
1349 eltstring = elt;
1350 if (XSYMBOL (bucket)->next)
1351 XSETSYMBOL (bucket, XSYMBOL (bucket)->next);
1352 else
1353 XSETFASTINT (bucket, 0);
1355 else if (++index >= obsize)
1356 break;
1357 else
1359 bucket = XVECTOR (collection)->contents[index];
1360 continue;
1363 else /* if (type == hash_table) */
1365 while (index < HASH_TABLE_SIZE (XHASH_TABLE (collection))
1366 && NILP (HASH_HASH (XHASH_TABLE (collection), index)))
1367 index++;
1368 if (index >= HASH_TABLE_SIZE (XHASH_TABLE (collection)))
1369 break;
1370 else
1371 elt = eltstring = HASH_KEY (XHASH_TABLE (collection), index++);
1374 /* Is this element a possible completion? */
1376 if (SYMBOLP (eltstring))
1377 eltstring = Fsymbol_name (eltstring);
1379 if (STRINGP (eltstring)
1380 && SCHARS (string) <= SCHARS (eltstring)
1381 && (tem = Fcompare_strings (eltstring, zero,
1382 make_number (SCHARS (string)),
1383 string, zero, Qnil,
1384 completion_ignore_case ? Qt : Qnil),
1385 EQ (Qt, tem)))
1387 /* Yes. */
1388 Lisp_Object regexps;
1390 /* Ignore this element if it fails to match all the regexps. */
1392 for (regexps = Vcompletion_regexp_list; CONSP (regexps);
1393 regexps = XCDR (regexps))
1395 if (bindcount < 0) {
1396 bindcount = SPECPDL_INDEX ();
1397 specbind (Qcase_fold_search,
1398 completion_ignore_case ? Qt : Qnil);
1400 tem = Fstring_match (XCAR (regexps), eltstring, zero);
1401 if (NILP (tem))
1402 break;
1404 if (CONSP (regexps))
1405 continue;
1408 /* Ignore this element if there is a predicate
1409 and the predicate doesn't like it. */
1411 if (!NILP (predicate))
1413 if (EQ (predicate, Qcommandp))
1414 tem = Fcommandp (elt, Qnil);
1415 else
1417 if (bindcount >= 0)
1419 unbind_to (bindcount, Qnil);
1420 bindcount = -1;
1422 GCPRO4 (tail, string, eltstring, bestmatch);
1423 tem = (type == hash_table
1424 ? call2 (predicate, elt,
1425 HASH_VALUE (XHASH_TABLE (collection),
1426 index - 1))
1427 : call1 (predicate, elt));
1428 UNGCPRO;
1430 if (NILP (tem)) continue;
1433 /* Update computation of how much all possible completions match */
1435 if (NILP (bestmatch))
1437 matchcount = 1;
1438 bestmatch = eltstring;
1439 bestmatchsize = SCHARS (eltstring);
1441 else
1443 compare = min (bestmatchsize, SCHARS (eltstring));
1444 tem = Fcompare_strings (bestmatch, zero,
1445 make_number (compare),
1446 eltstring, zero,
1447 make_number (compare),
1448 completion_ignore_case ? Qt : Qnil);
1449 if (EQ (tem, Qt))
1450 matchsize = compare;
1451 else if (XINT (tem) < 0)
1452 matchsize = - XINT (tem) - 1;
1453 else
1454 matchsize = XINT (tem) - 1;
1456 if (completion_ignore_case)
1458 /* If this is an exact match except for case,
1459 use it as the best match rather than one that is not an
1460 exact match. This way, we get the case pattern
1461 of the actual match. */
1462 if ((matchsize == SCHARS (eltstring)
1463 && matchsize < SCHARS (bestmatch))
1465 /* If there is more than one exact match ignoring case,
1466 and one of them is exact including case,
1467 prefer that one. */
1468 /* If there is no exact match ignoring case,
1469 prefer a match that does not change the case
1470 of the input. */
1471 ((matchsize == SCHARS (eltstring))
1473 (matchsize == SCHARS (bestmatch))
1474 && (tem = Fcompare_strings (eltstring, zero,
1475 make_number (SCHARS (string)),
1476 string, zero,
1477 Qnil,
1478 Qnil),
1479 EQ (Qt, tem))
1480 && (tem = Fcompare_strings (bestmatch, zero,
1481 make_number (SCHARS (string)),
1482 string, zero,
1483 Qnil,
1484 Qnil),
1485 ! EQ (Qt, tem))))
1486 bestmatch = eltstring;
1488 if (bestmatchsize != SCHARS (eltstring)
1489 || bestmatchsize != matchsize)
1490 /* Don't count the same string multiple times. */
1491 matchcount++;
1492 bestmatchsize = matchsize;
1493 if (matchsize <= SCHARS (string)
1494 /* If completion-ignore-case is non-nil, don't
1495 short-circuit because we want to find the best
1496 possible match *including* case differences. */
1497 && !completion_ignore_case
1498 && matchcount > 1)
1499 /* No need to look any further. */
1500 break;
1505 if (bindcount >= 0) {
1506 unbind_to (bindcount, Qnil);
1507 bindcount = -1;
1510 if (NILP (bestmatch))
1511 return Qnil; /* No completions found */
1512 /* If we are ignoring case, and there is no exact match,
1513 and no additional text was supplied,
1514 don't change the case of what the user typed. */
1515 if (completion_ignore_case && bestmatchsize == SCHARS (string)
1516 && SCHARS (bestmatch) > bestmatchsize)
1517 return minibuf_conform_representation (string, bestmatch);
1519 /* Return t if the supplied string is an exact match (counting case);
1520 it does not require any change to be made. */
1521 if (matchcount == 1 && !NILP (Fequal (bestmatch, string)))
1522 return Qt;
1524 XSETFASTINT (zero, 0); /* Else extract the part in which */
1525 XSETFASTINT (end, bestmatchsize); /* all completions agree */
1526 return Fsubstring (bestmatch, zero, end);
1529 DEFUN ("all-completions", Fall_completions, Sall_completions, 2, 4, 0,
1530 doc: /* Search for partial matches to STRING in COLLECTION.
1531 Test each of the possible completions specified by COLLECTION
1532 to see if it begins with STRING. The possible completions may be
1533 strings or symbols. Symbols are converted to strings before testing,
1534 see `symbol-name'.
1535 The value is a list of all the possible completions that match STRING.
1537 If COLLECTION is an alist, the keys (cars of elements) are the
1538 possible completions. If an element is not a cons cell, then the
1539 element itself is the possible completion.
1540 If COLLECTION is a hash-table, all the keys that are strings or symbols
1541 are the possible completions.
1542 If COLLECTION is an obarray, the names of all symbols in the obarray
1543 are the possible completions.
1545 COLLECTION can also be a function to do the completion itself.
1546 It receives three arguments: the values STRING, PREDICATE and t.
1547 Whatever it returns becomes the value of `all-completions'.
1549 If optional third argument PREDICATE is non-nil,
1550 it is used to test each possible match.
1551 The match is a candidate only if PREDICATE returns non-nil.
1552 The argument given to PREDICATE is the alist element
1553 or the symbol from the obarray. If COLLECTION is a hash-table,
1554 predicate is called with two arguments: the key and the value.
1555 Additionally to this predicate, `completion-regexp-list'
1556 is used to further constrain the set of candidates.
1558 If the optional fourth argument HIDE-SPACES is non-nil,
1559 strings in COLLECTION that start with a space
1560 are ignored unless STRING itself starts with a space. */)
1561 (string, collection, predicate, hide_spaces)
1562 Lisp_Object string, collection, predicate, hide_spaces;
1564 Lisp_Object tail, elt, eltstring;
1565 Lisp_Object allmatches;
1566 int type = HASH_TABLE_P (collection) ? 3
1567 : VECTORP (collection) ? 2
1568 : NILP (collection) || (CONSP (collection)
1569 && (!SYMBOLP (XCAR (collection))
1570 || NILP (XCAR (collection))));
1571 int index = 0, obsize = 0;
1572 int bindcount = -1;
1573 Lisp_Object bucket, tem, zero;
1574 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1576 CHECK_STRING (string);
1577 if (type == 0)
1578 return call3 (collection, string, predicate, Qt);
1579 allmatches = bucket = Qnil;
1580 zero = make_number (0);
1582 /* If COLLECTION is not a list, set TAIL just for gc pro. */
1583 tail = collection;
1584 if (type == 2)
1586 obsize = XVECTOR (collection)->size;
1587 bucket = XVECTOR (collection)->contents[index];
1590 while (1)
1592 /* Get the next element of the alist, obarray, or hash-table. */
1593 /* Exit the loop if the elements are all used up. */
1594 /* elt gets the alist element or symbol.
1595 eltstring gets the name to check as a completion. */
1597 if (type == 1)
1599 if (!CONSP (tail))
1600 break;
1601 elt = XCAR (tail);
1602 eltstring = CONSP (elt) ? XCAR (elt) : elt;
1603 tail = XCDR (tail);
1605 else if (type == 2)
1607 if (!EQ (bucket, zero))
1609 elt = bucket;
1610 eltstring = elt;
1611 if (XSYMBOL (bucket)->next)
1612 XSETSYMBOL (bucket, XSYMBOL (bucket)->next);
1613 else
1614 XSETFASTINT (bucket, 0);
1616 else if (++index >= obsize)
1617 break;
1618 else
1620 bucket = XVECTOR (collection)->contents[index];
1621 continue;
1624 else /* if (type == 3) */
1626 while (index < HASH_TABLE_SIZE (XHASH_TABLE (collection))
1627 && NILP (HASH_HASH (XHASH_TABLE (collection), index)))
1628 index++;
1629 if (index >= HASH_TABLE_SIZE (XHASH_TABLE (collection)))
1630 break;
1631 else
1632 elt = eltstring = HASH_KEY (XHASH_TABLE (collection), index++);
1635 /* Is this element a possible completion? */
1637 if (SYMBOLP (eltstring))
1638 eltstring = Fsymbol_name (eltstring);
1640 if (STRINGP (eltstring)
1641 && SCHARS (string) <= SCHARS (eltstring)
1642 /* If HIDE_SPACES, reject alternatives that start with space
1643 unless the input starts with space. */
1644 && ((SBYTES (string) > 0
1645 && SREF (string, 0) == ' ')
1646 || SREF (eltstring, 0) != ' '
1647 || NILP (hide_spaces))
1648 && (tem = Fcompare_strings (eltstring, zero,
1649 make_number (SCHARS (string)),
1650 string, zero,
1651 make_number (SCHARS (string)),
1652 completion_ignore_case ? Qt : Qnil),
1653 EQ (Qt, tem)))
1655 /* Yes. */
1656 Lisp_Object regexps;
1657 Lisp_Object zero;
1658 XSETFASTINT (zero, 0);
1660 /* Ignore this element if it fails to match all the regexps. */
1662 for (regexps = Vcompletion_regexp_list; CONSP (regexps);
1663 regexps = XCDR (regexps))
1665 if (bindcount < 0) {
1666 bindcount = SPECPDL_INDEX ();
1667 specbind (Qcase_fold_search,
1668 completion_ignore_case ? Qt : Qnil);
1670 tem = Fstring_match (XCAR (regexps), eltstring, zero);
1671 if (NILP (tem))
1672 break;
1674 if (CONSP (regexps))
1675 continue;
1678 /* Ignore this element if there is a predicate
1679 and the predicate doesn't like it. */
1681 if (!NILP (predicate))
1683 if (EQ (predicate, Qcommandp))
1684 tem = Fcommandp (elt, Qnil);
1685 else
1687 if (bindcount >= 0) {
1688 unbind_to (bindcount, Qnil);
1689 bindcount = -1;
1691 GCPRO4 (tail, eltstring, allmatches, string);
1692 tem = type == 3
1693 ? call2 (predicate, elt,
1694 HASH_VALUE (XHASH_TABLE (collection), index - 1))
1695 : call1 (predicate, elt);
1696 UNGCPRO;
1698 if (NILP (tem)) continue;
1700 /* Ok => put it on the list. */
1701 allmatches = Fcons (eltstring, allmatches);
1705 if (bindcount >= 0) {
1706 unbind_to (bindcount, Qnil);
1707 bindcount = -1;
1710 return Fnreverse (allmatches);
1713 DEFUN ("completing-read", Fcompleting_read, Scompleting_read, 2, 8, 0,
1714 doc: /* Read a string in the minibuffer, with completion.
1715 PROMPT is a string to prompt with; normally it ends in a colon and a space.
1716 COLLECTION can be a list of strings, an alist, an obarray or a hash table.
1717 COLLECTION can also be a function to do the completion itself.
1718 PREDICATE limits completion to a subset of COLLECTION.
1719 See `try-completion' and `all-completions' for more details
1720 on completion, COLLECTION, and PREDICATE.
1722 REQUIRE-MATCH can take the following values:
1723 - t means that the user is not allowed to exit unless
1724 the input is (or completes to) an element of COLLECTION or is null.
1725 - nil means that the user can exit with any input.
1726 - `confirm' means that the user can exit with any input, but she needs
1727 to confirm her choice if the input is not an element of COLLECTION.
1728 - `confirm-after-completion' means that the user can exit with any
1729 input, but she needs to confirm her choice if she called
1730 `minibuffer-complete' right before `minibuffer-complete-and-exit'
1731 and the input is not an element of COLLECTION.
1732 - anything else behaves like t except that typing RET does not exit if it
1733 does non-null completion.
1735 If the input is null, `completing-read' returns DEF, or the first element
1736 of the list of default values, or an empty string if DEF is nil,
1737 regardless of the value of REQUIRE-MATCH.
1739 If INITIAL-INPUT is non-nil, insert it in the minibuffer initially,
1740 with point positioned at the end.
1741 If it is (STRING . POSITION), the initial input is STRING, but point
1742 is placed at _zero-indexed_ position POSITION in STRING. (*Note*
1743 that this is different from `read-from-minibuffer' and related
1744 functions, which use one-indexing for POSITION.) This feature is
1745 deprecated--it is best to pass nil for INITIAL-INPUT and supply the
1746 default value DEF instead. The user can yank the default value into
1747 the minibuffer easily using \\[next-history-element].
1749 HIST, if non-nil, specifies a history list and optionally the initial
1750 position in the list. It can be a symbol, which is the history list
1751 variable to use, or it can be a cons cell (HISTVAR . HISTPOS). In
1752 that case, HISTVAR is the history list variable to use, and HISTPOS
1753 is the initial position (the position in the list used by the
1754 minibuffer history commands). For consistency, you should also
1755 specify that element of the history as the value of
1756 INITIAL-INPUT. (This is the only case in which you should use
1757 INITIAL-INPUT instead of DEF.) Positions are counted starting from
1758 1 at the beginning of the list. The variable `history-length'
1759 controls the maximum length of a history list.
1761 DEF, if non-nil, is the default value or the list of default values.
1763 If INHERIT-INPUT-METHOD is non-nil, the minibuffer inherits
1764 the current input method and the setting of `enable-multibyte-characters'.
1766 Completion ignores case if the ambient value of
1767 `completion-ignore-case' is non-nil. */)
1768 (prompt, collection, predicate, require_match, initial_input, hist, def, inherit_input_method)
1769 Lisp_Object prompt, collection, predicate, require_match, initial_input;
1770 Lisp_Object hist, def, inherit_input_method;
1772 Lisp_Object val, histvar, histpos, position;
1773 Lisp_Object init;
1774 int pos = 0;
1775 int count = SPECPDL_INDEX ();
1776 struct gcpro gcpro1;
1778 init = initial_input;
1779 GCPRO1 (def);
1781 specbind (Qminibuffer_completion_table, collection);
1782 specbind (Qminibuffer_completion_predicate, predicate);
1783 specbind (Qminibuffer_completion_confirm,
1784 EQ (require_match, Qt) ? Qnil : require_match);
1786 position = Qnil;
1787 if (!NILP (init))
1789 if (CONSP (init))
1791 position = Fcdr (init);
1792 init = Fcar (init);
1794 CHECK_STRING (init);
1795 if (!NILP (position))
1797 CHECK_NUMBER (position);
1798 /* Convert to distance from end of input. */
1799 pos = XINT (position) - SCHARS (init);
1803 if (SYMBOLP (hist))
1805 histvar = hist;
1806 histpos = Qnil;
1808 else
1810 histvar = Fcar_safe (hist);
1811 histpos = Fcdr_safe (hist);
1813 if (NILP (histvar))
1814 histvar = Qminibuffer_history;
1815 if (NILP (histpos))
1816 XSETFASTINT (histpos, 0);
1818 val = read_minibuf (NILP (require_match)
1819 ? (NILP (Vminibuffer_completing_file_name)
1820 || EQ (Vminibuffer_completing_file_name, Qlambda)
1821 ? Vminibuffer_local_completion_map
1822 : Vminibuffer_local_filename_completion_map)
1823 : (NILP (Vminibuffer_completing_file_name)
1824 || EQ (Vminibuffer_completing_file_name, Qlambda)
1825 ? Vminibuffer_local_must_match_map
1826 : Vminibuffer_local_filename_must_match_map),
1827 init, prompt, make_number (pos), 0,
1828 histvar, histpos, def, 0,
1829 !NILP (inherit_input_method));
1831 if (STRINGP (val) && SCHARS (val) == 0 && ! NILP (def))
1832 val = CONSP (def) ? XCAR (def) : def;
1834 RETURN_UNGCPRO (unbind_to (count, val));
1837 Lisp_Object Fassoc_string ();
1839 /* Test whether TXT is an exact completion. */
1840 DEFUN ("test-completion", Ftest_completion, Stest_completion, 2, 3, 0,
1841 doc: /* Return non-nil if STRING is a valid completion.
1842 Takes the same arguments as `all-completions' and `try-completion'.
1843 If COLLECTION is a function, it is called with three arguments:
1844 the values STRING, PREDICATE and `lambda'. */)
1845 (string, collection, predicate)
1846 Lisp_Object string, collection, predicate;
1848 Lisp_Object regexps, tail, tem = Qnil;
1849 int i = 0;
1851 CHECK_STRING (string);
1853 if ((CONSP (collection)
1854 && (!SYMBOLP (XCAR (collection)) || NILP (XCAR (collection))))
1855 || NILP (collection))
1857 tem = Fassoc_string (string, collection, completion_ignore_case ? Qt : Qnil);
1858 if (NILP (tem))
1859 return Qnil;
1861 else if (VECTORP (collection))
1863 /* Bypass intern-soft as that loses for nil. */
1864 tem = oblookup (collection,
1865 SDATA (string),
1866 SCHARS (string),
1867 SBYTES (string));
1868 if (!SYMBOLP (tem))
1870 if (STRING_MULTIBYTE (string))
1871 string = Fstring_make_unibyte (string);
1872 else
1873 string = Fstring_make_multibyte (string);
1875 tem = oblookup (collection,
1876 SDATA (string),
1877 SCHARS (string),
1878 SBYTES (string));
1881 if (completion_ignore_case && !SYMBOLP (tem))
1883 for (i = XVECTOR (collection)->size - 1; i >= 0; i--)
1885 tail = XVECTOR (collection)->contents[i];
1886 if (SYMBOLP (tail))
1887 while (1)
1889 if (EQ((Fcompare_strings (string, make_number (0), Qnil,
1890 Fsymbol_name (tail),
1891 make_number (0) , Qnil, Qt)),
1892 Qt))
1894 tem = tail;
1895 break;
1897 if (XSYMBOL (tail)->next == 0)
1898 break;
1899 XSETSYMBOL (tail, XSYMBOL (tail)->next);
1904 if (!SYMBOLP (tem))
1905 return Qnil;
1907 else if (HASH_TABLE_P (collection))
1909 struct Lisp_Hash_Table *h = XHASH_TABLE (collection);
1910 i = hash_lookup (h, string, NULL);
1911 if (i >= 0)
1912 tem = HASH_KEY (h, i);
1913 else
1914 for (i = 0; i < HASH_TABLE_SIZE (h); ++i)
1915 if (!NILP (HASH_HASH (h, i)) &&
1916 EQ (Fcompare_strings (string, make_number (0), Qnil,
1917 HASH_KEY (h, i), make_number (0) , Qnil,
1918 completion_ignore_case ? Qt : Qnil),
1919 Qt))
1921 tem = HASH_KEY (h, i);
1922 break;
1924 if (!STRINGP (tem))
1925 return Qnil;
1927 else
1928 return call3 (collection, string, predicate, Qlambda);
1930 /* Reject this element if it fails to match all the regexps. */
1931 if (CONSP (Vcompletion_regexp_list))
1933 int count = SPECPDL_INDEX ();
1934 specbind (Qcase_fold_search, completion_ignore_case ? Qt : Qnil);
1935 for (regexps = Vcompletion_regexp_list; CONSP (regexps);
1936 regexps = XCDR (regexps))
1938 if (NILP (Fstring_match (XCAR (regexps),
1939 SYMBOLP (tem) ? string : tem,
1940 Qnil)))
1941 return unbind_to (count, Qnil);
1943 unbind_to (count, Qnil);
1946 /* Finally, check the predicate. */
1947 if (!NILP (predicate))
1949 return HASH_TABLE_P (collection)
1950 ? call2 (predicate, tem, HASH_VALUE (XHASH_TABLE (collection), i))
1951 : call1 (predicate, tem);
1953 else
1954 return Qt;
1957 DEFUN ("internal-complete-buffer", Finternal_complete_buffer, Sinternal_complete_buffer, 3, 3, 0,
1958 doc: /* Perform completion on buffer names.
1959 If the argument FLAG is nil, invoke `try-completion', if it's t, invoke
1960 `all-completions', otherwise invoke `test-completion'.
1962 The arguments STRING and PREDICATE are as in `try-completion',
1963 `all-completions', and `test-completion'. */)
1964 (string, predicate, flag)
1965 Lisp_Object string, predicate, flag;
1967 if (NILP (flag))
1968 return Ftry_completion (string, Vbuffer_alist, predicate);
1969 else if (EQ (flag, Qt))
1971 Lisp_Object res = Fall_completions (string, Vbuffer_alist, predicate, Qnil);
1972 if (SCHARS (string) > 0)
1973 return res;
1974 else
1975 { /* Strip out internal buffers. */
1976 Lisp_Object bufs = res;
1977 /* First, look for a non-internal buffer in `res'. */
1978 while (CONSP (bufs) && SREF (XCAR (bufs), 0) == ' ')
1979 bufs = XCDR (bufs);
1980 if (NILP (bufs))
1981 /* All bufs in `res' are internal, so don't trip them out. */
1982 return res;
1983 res = bufs;
1984 while (CONSP (XCDR (bufs)))
1985 if (SREF (XCAR (XCDR (bufs)), 0) == ' ')
1986 XSETCDR (bufs, XCDR (XCDR (bufs)));
1987 else
1988 bufs = XCDR (bufs);
1989 return res;
1992 else /* assume `lambda' */
1993 return Ftest_completion (string, Vbuffer_alist, predicate);
1996 /* Like assoc but assumes KEY is a string, and ignores case if appropriate. */
1998 DEFUN ("assoc-string", Fassoc_string, Sassoc_string, 2, 3, 0,
1999 doc: /* Like `assoc' but specifically for strings (and symbols).
2001 This returns the first element of LIST whose car matches the string or
2002 symbol KEY, or nil if no match exists. When performing the
2003 comparison, symbols are first converted to strings, and unibyte
2004 strings to multibyte. If the optional arg CASE-FOLD is non-nil, case
2005 is ignored.
2007 Unlike `assoc', KEY can also match an entry in LIST consisting of a
2008 single string, rather than a cons cell whose car is a string. */)
2009 (key, list, case_fold)
2010 register Lisp_Object key;
2011 Lisp_Object list, case_fold;
2013 register Lisp_Object tail;
2015 if (SYMBOLP (key))
2016 key = Fsymbol_name (key);
2018 for (tail = list; CONSP (tail); tail = XCDR (tail))
2020 register Lisp_Object elt, tem, thiscar;
2021 elt = XCAR (tail);
2022 thiscar = CONSP (elt) ? XCAR (elt) : elt;
2023 if (SYMBOLP (thiscar))
2024 thiscar = Fsymbol_name (thiscar);
2025 else if (!STRINGP (thiscar))
2026 continue;
2027 tem = Fcompare_strings (thiscar, make_number (0), Qnil,
2028 key, make_number (0), Qnil,
2029 case_fold);
2030 if (EQ (tem, Qt))
2031 return elt;
2032 QUIT;
2034 return Qnil;
2038 DEFUN ("minibuffer-depth", Fminibuffer_depth, Sminibuffer_depth, 0, 0, 0,
2039 doc: /* Return current depth of activations of minibuffer, a nonnegative integer. */)
2042 return make_number (minibuf_level);
2045 DEFUN ("minibuffer-prompt", Fminibuffer_prompt, Sminibuffer_prompt, 0, 0, 0,
2046 doc: /* Return the prompt string of the currently-active minibuffer.
2047 If no minibuffer is active, return nil. */)
2050 return Fcopy_sequence (minibuf_prompt);
2054 void
2055 init_minibuf_once ()
2057 Vminibuffer_list = Qnil;
2058 staticpro (&Vminibuffer_list);
2061 void
2062 syms_of_minibuf ()
2064 minibuf_level = 0;
2065 minibuf_prompt = Qnil;
2066 staticpro (&minibuf_prompt);
2068 minibuf_save_list = Qnil;
2069 staticpro (&minibuf_save_list);
2071 Qcompletion_ignore_case = intern ("completion-ignore-case");
2072 staticpro (&Qcompletion_ignore_case);
2074 Qread_file_name_internal = intern ("read-file-name-internal");
2075 staticpro (&Qread_file_name_internal);
2077 Qminibuffer_default = intern ("minibuffer-default");
2078 staticpro (&Qminibuffer_default);
2079 Fset (Qminibuffer_default, Qnil);
2081 Qminibuffer_completion_table = intern ("minibuffer-completion-table");
2082 staticpro (&Qminibuffer_completion_table);
2084 Qminibuffer_completion_confirm = intern ("minibuffer-completion-confirm");
2085 staticpro (&Qminibuffer_completion_confirm);
2087 Qminibuffer_completion_predicate = intern ("minibuffer-completion-predicate");
2088 staticpro (&Qminibuffer_completion_predicate);
2090 staticpro (&last_minibuf_string);
2091 last_minibuf_string = Qnil;
2093 Quser_variable_p = intern ("user-variable-p");
2094 staticpro (&Quser_variable_p);
2096 Qminibuffer_history = intern ("minibuffer-history");
2097 staticpro (&Qminibuffer_history);
2099 Qbuffer_name_history = intern ("buffer-name-history");
2100 staticpro (&Qbuffer_name_history);
2101 Fset (Qbuffer_name_history, Qnil);
2103 Qminibuffer_setup_hook = intern ("minibuffer-setup-hook");
2104 staticpro (&Qminibuffer_setup_hook);
2106 Qminibuffer_exit_hook = intern ("minibuffer-exit-hook");
2107 staticpro (&Qminibuffer_exit_hook);
2109 Qhistory_length = intern ("history-length");
2110 staticpro (&Qhistory_length);
2112 Qcurrent_input_method = intern ("current-input-method");
2113 staticpro (&Qcurrent_input_method);
2115 Qactivate_input_method = intern ("activate-input-method");
2116 staticpro (&Qactivate_input_method);
2118 Qcase_fold_search = intern ("case-fold-search");
2119 staticpro (&Qcase_fold_search);
2121 Qread_expression_history = intern ("read-expression-history");
2122 staticpro (&Qread_expression_history);
2124 DEFVAR_LISP ("read-buffer-function", &Vread_buffer_function,
2125 doc: /* If this is non-nil, `read-buffer' does its work by calling this function. */);
2126 Vread_buffer_function = Qnil;
2128 DEFVAR_BOOL ("read-buffer-completion-ignore-case",
2129 &read_buffer_completion_ignore_case,
2130 doc: /* *Non-nil means completion ignores case when reading a buffer name. */);
2131 read_buffer_completion_ignore_case = 0;
2133 DEFVAR_LISP ("minibuffer-setup-hook", &Vminibuffer_setup_hook,
2134 doc: /* Normal hook run just after entry to minibuffer. */);
2135 Vminibuffer_setup_hook = Qnil;
2137 DEFVAR_LISP ("minibuffer-exit-hook", &Vminibuffer_exit_hook,
2138 doc: /* Normal hook run just after exit from minibuffer. */);
2139 Vminibuffer_exit_hook = Qnil;
2141 DEFVAR_LISP ("history-length", &Vhistory_length,
2142 doc: /* *Maximum length for history lists before truncation takes place.
2143 A number means that length; t means infinite. Truncation takes place
2144 just after a new element is inserted. Setting the `history-length'
2145 property of a history variable overrides this default. */);
2146 XSETFASTINT (Vhistory_length, 30);
2148 DEFVAR_BOOL ("history-delete-duplicates", &history_delete_duplicates,
2149 doc: /* *Non-nil means to delete duplicates in history.
2150 If set to t when adding a new history element, all previous identical
2151 elements are deleted from the history list. */);
2152 history_delete_duplicates = 0;
2154 DEFVAR_LISP ("history-add-new-input", &Vhistory_add_new_input,
2155 doc: /* *Non-nil means to add new elements in history.
2156 If set to nil, minibuffer reading functions don't add new elements to the
2157 history list, so it is possible to do this afterwards by calling
2158 `add-to-history' explicitly. */);
2159 Vhistory_add_new_input = Qt;
2161 DEFVAR_BOOL ("completion-ignore-case", &completion_ignore_case,
2162 doc: /* Non-nil means don't consider case significant in completion.
2163 For file-name completion, `read-file-name-completion-ignore-case'
2164 controls the behavior, rather than this variable.
2165 For buffer name completion, `read-buffer-completion-ignore-case'
2166 controls the behavior, rather than this variable. */);
2167 completion_ignore_case = 0;
2169 DEFVAR_BOOL ("enable-recursive-minibuffers", &enable_recursive_minibuffers,
2170 doc: /* *Non-nil means to allow minibuffer commands while in the minibuffer.
2171 This variable makes a difference whenever the minibuffer window is active. */);
2172 enable_recursive_minibuffers = 0;
2174 DEFVAR_LISP ("minibuffer-completion-table", &Vminibuffer_completion_table,
2175 doc: /* Alist or obarray used for completion in the minibuffer.
2176 This becomes the ALIST argument to `try-completion' and `all-completions'.
2177 The value can also be a list of strings or a hash table.
2179 The value may alternatively be a function, which is given three arguments:
2180 STRING, the current buffer contents;
2181 PREDICATE, the predicate for filtering possible matches;
2182 CODE, which says what kind of things to do.
2183 CODE can be nil, t or `lambda':
2184 nil -- return the best completion of STRING, or nil if there is none.
2185 t -- return a list of all possible completions of STRING.
2186 lambda -- return t if STRING is a valid completion as it stands. */);
2187 Vminibuffer_completion_table = Qnil;
2189 DEFVAR_LISP ("minibuffer-completion-predicate", &Vminibuffer_completion_predicate,
2190 doc: /* Within call to `completing-read', this holds the PREDICATE argument. */);
2191 Vminibuffer_completion_predicate = Qnil;
2193 DEFVAR_LISP ("minibuffer-completion-confirm", &Vminibuffer_completion_confirm,
2194 doc: /* Whether to demand confirmation of completion before exiting minibuffer.
2195 If nil, confirmation is not required.
2196 If the value is `confirm', the user may exit with an input that is not
2197 a valid completion alternative, but Emacs asks for confirmation.
2198 If the value is `confirm-after-completion', the user may exit with an
2199 input that is not a valid completion alternative, but Emacs asks for
2200 confirmation if the user submitted the input right after
2201 `minibuffer-complete'. */);
2202 Vminibuffer_completion_confirm = Qnil;
2204 DEFVAR_LISP ("minibuffer-completing-file-name",
2205 &Vminibuffer_completing_file_name,
2206 doc: /* Non-nil means completing file names. */);
2207 Vminibuffer_completing_file_name = Qnil;
2209 DEFVAR_LISP ("minibuffer-help-form", &Vminibuffer_help_form,
2210 doc: /* Value that `help-form' takes on inside the minibuffer. */);
2211 Vminibuffer_help_form = Qnil;
2213 DEFVAR_LISP ("minibuffer-history-variable", &Vminibuffer_history_variable,
2214 doc: /* History list symbol to add minibuffer values to.
2215 Each string of minibuffer input, as it appears on exit from the minibuffer,
2216 is added with
2217 (set minibuffer-history-variable
2218 (cons STRING (symbol-value minibuffer-history-variable))) */);
2219 XSETFASTINT (Vminibuffer_history_variable, 0);
2221 DEFVAR_LISP ("minibuffer-history-position", &Vminibuffer_history_position,
2222 doc: /* Current position of redoing in the history list. */);
2223 Vminibuffer_history_position = Qnil;
2225 DEFVAR_BOOL ("minibuffer-auto-raise", &minibuffer_auto_raise,
2226 doc: /* *Non-nil means entering the minibuffer raises the minibuffer's frame.
2227 Some uses of the echo area also raise that frame (since they use it too). */);
2228 minibuffer_auto_raise = 0;
2230 DEFVAR_LISP ("completion-regexp-list", &Vcompletion_regexp_list,
2231 doc: /* List of regexps that should restrict possible completions.
2232 The basic completion functions only consider a completion acceptable
2233 if it matches all regular expressions in this list, with
2234 `case-fold-search' bound to the value of `completion-ignore-case'.
2235 See Info node `(elisp)Basic Completion', for a description of these
2236 functions. */);
2237 Vcompletion_regexp_list = Qnil;
2239 DEFVAR_BOOL ("minibuffer-allow-text-properties",
2240 &minibuffer_allow_text_properties,
2241 doc: /* Non-nil means `read-from-minibuffer' should not discard text properties.
2242 This also affects `read-string', but it does not affect `read-minibuffer',
2243 `read-no-blanks-input', or any of the functions that do minibuffer input
2244 with completion; they always discard text properties. */);
2245 minibuffer_allow_text_properties = 0;
2247 DEFVAR_LISP ("minibuffer-prompt-properties", &Vminibuffer_prompt_properties,
2248 doc: /* Text properties that are added to minibuffer prompts.
2249 These are in addition to the basic `field' property, and stickiness
2250 properties. */);
2251 /* We use `intern' here instead of Qread_only to avoid
2252 initialization-order problems. */
2253 Vminibuffer_prompt_properties
2254 = Fcons (intern ("read-only"), Fcons (Qt, Qnil));
2256 DEFVAR_LISP ("read-expression-map", &Vread_expression_map,
2257 doc: /* Minibuffer keymap used for reading Lisp expressions. */);
2258 Vread_expression_map = Qnil;
2260 defsubr (&Sset_minibuffer_window);
2261 defsubr (&Sread_from_minibuffer);
2262 defsubr (&Seval_minibuffer);
2263 defsubr (&Sread_minibuffer);
2264 defsubr (&Sread_string);
2265 defsubr (&Sread_command);
2266 defsubr (&Sread_variable);
2267 defsubr (&Sinternal_complete_buffer);
2268 defsubr (&Sread_buffer);
2269 defsubr (&Sread_no_blanks_input);
2270 defsubr (&Sminibuffer_depth);
2271 defsubr (&Sminibuffer_prompt);
2273 defsubr (&Sminibufferp);
2274 defsubr (&Sminibuffer_prompt_end);
2275 defsubr (&Sminibuffer_contents);
2276 defsubr (&Sminibuffer_contents_no_properties);
2277 defsubr (&Sminibuffer_completion_contents);
2279 defsubr (&Stry_completion);
2280 defsubr (&Sall_completions);
2281 defsubr (&Stest_completion);
2282 defsubr (&Sassoc_string);
2283 defsubr (&Scompleting_read);
2286 /* arch-tag: 8f69b601-fba3-484c-a6dd-ceaee54a7a73
2287 (do not change this comment) */