Update runtime files
[MacVim.git] / src / ex_docmd.c
blob66d7fa96c7d16a84d79137f782a0ae3b3902a529
1 /* vi:set ts=8 sts=4 sw=4:
3 * VIM - Vi IMproved by Bram Moolenaar
5 * Do ":help uganda" in Vim to read copying and usage conditions.
6 * Do ":help credits" in Vim to see a list of people who contributed.
7 * See README.txt for an overview of the Vim source code.
8 */
11 * ex_docmd.c: functions for executing an Ex command line.
14 #include "vim.h"
16 static int quitmore = 0;
17 static int ex_pressedreturn = FALSE;
18 #ifndef FEAT_PRINTER
19 # define ex_hardcopy ex_ni
20 #endif
22 #ifdef FEAT_USR_CMDS
23 typedef struct ucmd
25 char_u *uc_name; /* The command name */
26 long_u uc_argt; /* The argument type */
27 char_u *uc_rep; /* The command's replacement string */
28 long uc_def; /* The default value for a range/count */
29 scid_T uc_scriptID; /* SID where the command was defined */
30 int uc_compl; /* completion type */
31 # if defined(FEAT_EVAL) && defined(FEAT_CMDL_COMPL)
32 char_u *uc_compl_arg; /* completion argument if any */
33 # endif
34 } ucmd_T;
36 #define UC_BUFFER 1 /* -buffer: local to current buffer */
38 static garray_T ucmds = {0, 0, sizeof(ucmd_T), 4, NULL};
40 #define USER_CMD(i) (&((ucmd_T *)(ucmds.ga_data))[i])
41 #define USER_CMD_GA(gap, i) (&((ucmd_T *)((gap)->ga_data))[i])
43 static void do_ucmd __ARGS((exarg_T *eap));
44 static void ex_command __ARGS((exarg_T *eap));
45 static void ex_delcommand __ARGS((exarg_T *eap));
46 # ifdef FEAT_CMDL_COMPL
47 static char_u *get_user_command_name __ARGS((int idx));
48 # endif
50 #else
51 # define ex_command ex_ni
52 # define ex_comclear ex_ni
53 # define ex_delcommand ex_ni
54 #endif
56 #ifdef FEAT_EVAL
57 static char_u *do_one_cmd __ARGS((char_u **, int, struct condstack *, char_u *(*fgetline)(int, void *, int), void *cookie));
58 #else
59 static char_u *do_one_cmd __ARGS((char_u **, int, char_u *(*fgetline)(int, void *, int), void *cookie));
60 static int if_level = 0; /* depth in :if */
61 #endif
62 static char_u *find_command __ARGS((exarg_T *eap, int *full));
64 static void ex_abbreviate __ARGS((exarg_T *eap));
65 static void ex_map __ARGS((exarg_T *eap));
66 static void ex_unmap __ARGS((exarg_T *eap));
67 static void ex_mapclear __ARGS((exarg_T *eap));
68 static void ex_abclear __ARGS((exarg_T *eap));
69 #ifndef FEAT_MENU
70 # define ex_emenu ex_ni
71 # define ex_menu ex_ni
72 # define ex_menutranslate ex_ni
73 #endif
74 #ifdef FEAT_AUTOCMD
75 static void ex_autocmd __ARGS((exarg_T *eap));
76 static void ex_doautocmd __ARGS((exarg_T *eap));
77 #else
78 # define ex_autocmd ex_ni
79 # define ex_doautocmd ex_ni
80 # define ex_doautoall ex_ni
81 #endif
82 #ifdef FEAT_LISTCMDS
83 static void ex_bunload __ARGS((exarg_T *eap));
84 static void ex_buffer __ARGS((exarg_T *eap));
85 static void ex_bmodified __ARGS((exarg_T *eap));
86 static void ex_bnext __ARGS((exarg_T *eap));
87 static void ex_bprevious __ARGS((exarg_T *eap));
88 static void ex_brewind __ARGS((exarg_T *eap));
89 static void ex_blast __ARGS((exarg_T *eap));
90 #else
91 # define ex_bunload ex_ni
92 # define ex_buffer ex_ni
93 # define ex_bmodified ex_ni
94 # define ex_bnext ex_ni
95 # define ex_bprevious ex_ni
96 # define ex_brewind ex_ni
97 # define ex_blast ex_ni
98 # define buflist_list ex_ni
99 # define ex_checktime ex_ni
100 #endif
101 #if !defined(FEAT_LISTCMDS) || !defined(FEAT_WINDOWS)
102 # define ex_buffer_all ex_ni
103 #endif
104 static char_u *getargcmd __ARGS((char_u **));
105 static char_u *skip_cmd_arg __ARGS((char_u *p, int rembs));
106 static int getargopt __ARGS((exarg_T *eap));
107 #ifndef FEAT_QUICKFIX
108 # define ex_make ex_ni
109 # define ex_cbuffer ex_ni
110 # define ex_cc ex_ni
111 # define ex_cnext ex_ni
112 # define ex_cfile ex_ni
113 # define qf_list ex_ni
114 # define qf_age ex_ni
115 # define ex_helpgrep ex_ni
116 # define ex_vimgrep ex_ni
117 #endif
118 #if !defined(FEAT_QUICKFIX) || !defined(FEAT_WINDOWS)
119 # define ex_cclose ex_ni
120 # define ex_copen ex_ni
121 # define ex_cwindow ex_ni
122 #endif
123 #if !defined(FEAT_QUICKFIX) || !defined(FEAT_EVAL)
124 # define ex_cexpr ex_ni
125 #endif
127 static int check_more __ARGS((int, int));
128 static linenr_T get_address __ARGS((char_u **, int skip, int to_other_file));
129 static void get_flags __ARGS((exarg_T *eap));
130 #if !defined(FEAT_PERL) || !defined(FEAT_PYTHON) || !defined(FEAT_TCL) \
131 || !defined(FEAT_RUBY) || !defined(FEAT_MZSCHEME)
132 # define HAVE_EX_SCRIPT_NI
133 static void ex_script_ni __ARGS((exarg_T *eap));
134 #endif
135 static char_u *invalid_range __ARGS((exarg_T *eap));
136 static void correct_range __ARGS((exarg_T *eap));
137 #ifdef FEAT_QUICKFIX
138 static char_u *replace_makeprg __ARGS((exarg_T *eap, char_u *p, char_u **cmdlinep));
139 #endif
140 static char_u *repl_cmdline __ARGS((exarg_T *eap, char_u *src, int srclen, char_u *repl, char_u **cmdlinep));
141 static void ex_highlight __ARGS((exarg_T *eap));
142 static void ex_colorscheme __ARGS((exarg_T *eap));
143 static void ex_quit __ARGS((exarg_T *eap));
144 static void ex_cquit __ARGS((exarg_T *eap));
145 static void ex_quit_all __ARGS((exarg_T *eap));
146 #ifdef FEAT_WINDOWS
147 static void ex_close __ARGS((exarg_T *eap));
148 static void ex_win_close __ARGS((int forceit, win_T *win, tabpage_T *tp));
149 static void ex_only __ARGS((exarg_T *eap));
150 static void ex_resize __ARGS((exarg_T *eap));
151 static void ex_stag __ARGS((exarg_T *eap));
152 static void ex_tabclose __ARGS((exarg_T *eap));
153 static void ex_tabonly __ARGS((exarg_T *eap));
154 static void ex_tabnext __ARGS((exarg_T *eap));
155 static void ex_tabmove __ARGS((exarg_T *eap));
156 static void ex_tabs __ARGS((exarg_T *eap));
157 #else
158 # define ex_close ex_ni
159 # define ex_only ex_ni
160 # define ex_all ex_ni
161 # define ex_resize ex_ni
162 # define ex_splitview ex_ni
163 # define ex_stag ex_ni
164 # define ex_tabnext ex_ni
165 # define ex_tabmove ex_ni
166 # define ex_tabs ex_ni
167 # define ex_tabclose ex_ni
168 # define ex_tabonly ex_ni
169 #endif
170 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
171 static void ex_pclose __ARGS((exarg_T *eap));
172 static void ex_ptag __ARGS((exarg_T *eap));
173 static void ex_pedit __ARGS((exarg_T *eap));
174 #else
175 # define ex_pclose ex_ni
176 # define ex_ptag ex_ni
177 # define ex_pedit ex_ni
178 #endif
179 static void ex_hide __ARGS((exarg_T *eap));
180 static void ex_stop __ARGS((exarg_T *eap));
181 static void ex_exit __ARGS((exarg_T *eap));
182 static void ex_print __ARGS((exarg_T *eap));
183 #ifdef FEAT_BYTEOFF
184 static void ex_goto __ARGS((exarg_T *eap));
185 #else
186 # define ex_goto ex_ni
187 #endif
188 static void ex_shell __ARGS((exarg_T *eap));
189 static void ex_preserve __ARGS((exarg_T *eap));
190 static void ex_recover __ARGS((exarg_T *eap));
191 #ifndef FEAT_LISTCMDS
192 # define ex_argedit ex_ni
193 # define ex_argadd ex_ni
194 # define ex_argdelete ex_ni
195 # define ex_listdo ex_ni
196 #endif
197 static void ex_mode __ARGS((exarg_T *eap));
198 static void ex_wrongmodifier __ARGS((exarg_T *eap));
199 static void ex_find __ARGS((exarg_T *eap));
200 static void ex_open __ARGS((exarg_T *eap));
201 static void ex_edit __ARGS((exarg_T *eap));
202 #if !defined(FEAT_GUI) && !defined(FEAT_CLIENTSERVER)
203 # define ex_drop ex_ni
204 #endif
205 #ifndef FEAT_GUI
206 # define ex_gui ex_nogui
207 static void ex_nogui __ARGS((exarg_T *eap));
208 #endif
209 #if defined(FEAT_GUI_W32) && defined(FEAT_MENU) && defined(FEAT_TEAROFF)
210 static void ex_tearoff __ARGS((exarg_T *eap));
211 #else
212 # define ex_tearoff ex_ni
213 #endif
214 #if (defined(FEAT_GUI_MSWIN) || defined(FEAT_GUI_GTK)) && defined(FEAT_MENU)
215 static void ex_popup __ARGS((exarg_T *eap));
216 #else
217 # define ex_popup ex_ni
218 #endif
219 #ifndef FEAT_GUI_MSWIN
220 # define ex_simalt ex_ni
221 #endif
222 #if !defined(FEAT_GUI_MSWIN) && !defined(FEAT_GUI_GTK) && !defined(FEAT_GUI_MOTIF)
223 # define gui_mch_find_dialog ex_ni
224 # define gui_mch_replace_dialog ex_ni
225 #endif
226 #if !defined(FEAT_GUI_GTK)
227 # define ex_helpfind ex_ni
228 #endif
229 #ifndef FEAT_CSCOPE
230 # define do_cscope ex_ni
231 # define do_scscope ex_ni
232 # define do_cstag ex_ni
233 #endif
234 #ifndef FEAT_SYN_HL
235 # define ex_syntax ex_ni
236 #endif
237 #ifndef FEAT_SPELL
238 # define ex_spell ex_ni
239 # define ex_mkspell ex_ni
240 # define ex_spelldump ex_ni
241 # define ex_spellinfo ex_ni
242 # define ex_spellrepall ex_ni
243 #endif
244 #ifndef FEAT_MZSCHEME
245 # define ex_mzscheme ex_script_ni
246 # define ex_mzfile ex_ni
247 #endif
248 #ifndef FEAT_PERL
249 # define ex_perl ex_script_ni
250 # define ex_perldo ex_ni
251 #endif
252 #ifndef FEAT_PYTHON
253 # define ex_python ex_script_ni
254 # define ex_pyfile ex_ni
255 #endif
256 #ifndef FEAT_TCL
257 # define ex_tcl ex_script_ni
258 # define ex_tcldo ex_ni
259 # define ex_tclfile ex_ni
260 #endif
261 #ifndef FEAT_RUBY
262 # define ex_ruby ex_script_ni
263 # define ex_rubydo ex_ni
264 # define ex_rubyfile ex_ni
265 #endif
266 #ifndef FEAT_SNIFF
267 # define ex_sniff ex_ni
268 #endif
269 #ifndef FEAT_KEYMAP
270 # define ex_loadkeymap ex_ni
271 #endif
272 static void ex_swapname __ARGS((exarg_T *eap));
273 static void ex_syncbind __ARGS((exarg_T *eap));
274 static void ex_read __ARGS((exarg_T *eap));
275 static void ex_pwd __ARGS((exarg_T *eap));
276 static void ex_equal __ARGS((exarg_T *eap));
277 static void ex_sleep __ARGS((exarg_T *eap));
278 static void do_exmap __ARGS((exarg_T *eap, int isabbrev));
279 static void ex_winsize __ARGS((exarg_T *eap));
280 #ifdef FEAT_WINDOWS
281 static void ex_wincmd __ARGS((exarg_T *eap));
282 #else
283 # define ex_wincmd ex_ni
284 #endif
285 #if defined(FEAT_GUI) || defined(UNIX) || defined(VMS) || defined(MSWIN)
286 static void ex_winpos __ARGS((exarg_T *eap));
287 #else
288 # define ex_winpos ex_ni
289 #endif
290 static void ex_operators __ARGS((exarg_T *eap));
291 static void ex_put __ARGS((exarg_T *eap));
292 static void ex_copymove __ARGS((exarg_T *eap));
293 static void ex_may_print __ARGS((exarg_T *eap));
294 static void ex_submagic __ARGS((exarg_T *eap));
295 static void ex_join __ARGS((exarg_T *eap));
296 static void ex_at __ARGS((exarg_T *eap));
297 static void ex_bang __ARGS((exarg_T *eap));
298 static void ex_undo __ARGS((exarg_T *eap));
299 static void ex_redo __ARGS((exarg_T *eap));
300 static void ex_later __ARGS((exarg_T *eap));
301 static void ex_redir __ARGS((exarg_T *eap));
302 static void ex_redraw __ARGS((exarg_T *eap));
303 static void ex_redrawstatus __ARGS((exarg_T *eap));
304 static void close_redir __ARGS((void));
305 static void ex_mkrc __ARGS((exarg_T *eap));
306 static void ex_mark __ARGS((exarg_T *eap));
307 #ifdef FEAT_USR_CMDS
308 static char_u *uc_fun_cmd __ARGS((void));
309 static char_u *find_ucmd __ARGS((exarg_T *eap, char_u *p, int *full, expand_T *xp, int *compl));
310 #endif
311 #ifdef FEAT_EX_EXTRA
312 static void ex_normal __ARGS((exarg_T *eap));
313 static void ex_startinsert __ARGS((exarg_T *eap));
314 static void ex_stopinsert __ARGS((exarg_T *eap));
315 #else
316 # define ex_normal ex_ni
317 # define ex_align ex_ni
318 # define ex_retab ex_ni
319 # define ex_startinsert ex_ni
320 # define ex_stopinsert ex_ni
321 # define ex_helptags ex_ni
322 # define ex_sort ex_ni
323 #endif
324 #ifdef FEAT_FIND_ID
325 static void ex_checkpath __ARGS((exarg_T *eap));
326 static void ex_findpat __ARGS((exarg_T *eap));
327 #else
328 # define ex_findpat ex_ni
329 # define ex_checkpath ex_ni
330 #endif
331 #if defined(FEAT_FIND_ID) && defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
332 static void ex_psearch __ARGS((exarg_T *eap));
333 #else
334 # define ex_psearch ex_ni
335 #endif
336 static void ex_tag __ARGS((exarg_T *eap));
337 static void ex_tag_cmd __ARGS((exarg_T *eap, char_u *name));
338 #ifndef FEAT_EVAL
339 # define ex_scriptnames ex_ni
340 # define ex_finish ex_ni
341 # define ex_echo ex_ni
342 # define ex_echohl ex_ni
343 # define ex_execute ex_ni
344 # define ex_call ex_ni
345 # define ex_if ex_ni
346 # define ex_endif ex_ni
347 # define ex_else ex_ni
348 # define ex_while ex_ni
349 # define ex_for ex_ni
350 # define ex_continue ex_ni
351 # define ex_break ex_ni
352 # define ex_endwhile ex_ni
353 # define ex_endfor ex_ni
354 # define ex_throw ex_ni
355 # define ex_try ex_ni
356 # define ex_catch ex_ni
357 # define ex_finally ex_ni
358 # define ex_endtry ex_ni
359 # define ex_endfunction ex_ni
360 # define ex_let ex_ni
361 # define ex_unlet ex_ni
362 # define ex_lockvar ex_ni
363 # define ex_unlockvar ex_ni
364 # define ex_function ex_ni
365 # define ex_delfunction ex_ni
366 # define ex_return ex_ni
367 # define ex_oldfiles ex_ni
368 #endif
369 static char_u *arg_all __ARGS((void));
370 #ifdef FEAT_SESSION
371 static int makeopens __ARGS((FILE *fd, char_u *dirnow));
372 static int put_view __ARGS((FILE *fd, win_T *wp, int add_edit, unsigned *flagp, int current_arg_idx));
373 static void ex_loadview __ARGS((exarg_T *eap));
374 static char_u *get_view_file __ARGS((int c));
375 static int did_lcd; /* whether ":lcd" was produced for a session */
376 #else
377 # define ex_loadview ex_ni
378 #endif
379 #ifndef FEAT_EVAL
380 # define ex_compiler ex_ni
381 #endif
382 #ifdef FEAT_VIMINFO
383 static void ex_viminfo __ARGS((exarg_T *eap));
384 #else
385 # define ex_viminfo ex_ni
386 #endif
387 static void ex_behave __ARGS((exarg_T *eap));
388 #ifdef FEAT_AUTOCMD
389 static void ex_filetype __ARGS((exarg_T *eap));
390 static void ex_setfiletype __ARGS((exarg_T *eap));
391 #else
392 # define ex_filetype ex_ni
393 # define ex_setfiletype ex_ni
394 #endif
395 #ifndef FEAT_DIFF
396 # define ex_diffoff ex_ni
397 # define ex_diffpatch ex_ni
398 # define ex_diffgetput ex_ni
399 # define ex_diffsplit ex_ni
400 # define ex_diffthis ex_ni
401 # define ex_diffupdate ex_ni
402 #endif
403 static void ex_digraphs __ARGS((exarg_T *eap));
404 static void ex_set __ARGS((exarg_T *eap));
405 #if !defined(FEAT_EVAL) || !defined(FEAT_AUTOCMD)
406 # define ex_options ex_ni
407 #endif
408 #ifdef FEAT_SEARCH_EXTRA
409 static void ex_nohlsearch __ARGS((exarg_T *eap));
410 static void ex_match __ARGS((exarg_T *eap));
411 #else
412 # define ex_nohlsearch ex_ni
413 # define ex_match ex_ni
414 #endif
415 #ifdef FEAT_CRYPT
416 static void ex_X __ARGS((exarg_T *eap));
417 #else
418 # define ex_X ex_ni
419 #endif
420 #ifdef FEAT_FOLDING
421 static void ex_fold __ARGS((exarg_T *eap));
422 static void ex_foldopen __ARGS((exarg_T *eap));
423 static void ex_folddo __ARGS((exarg_T *eap));
424 #else
425 # define ex_fold ex_ni
426 # define ex_foldopen ex_ni
427 # define ex_folddo ex_ni
428 #endif
429 #if !((defined(HAVE_LOCALE_H) || defined(X_LOCALE)) \
430 && (defined(FEAT_GETTEXT) || defined(FEAT_MBYTE)))
431 # define ex_language ex_ni
432 #endif
433 #ifndef FEAT_SIGNS
434 # define ex_sign ex_ni
435 #endif
436 #ifndef FEAT_SUN_WORKSHOP
437 # define ex_wsverb ex_ni
438 #endif
439 #ifndef FEAT_NETBEANS_INTG
440 # define ex_nbkey ex_ni
441 #endif
443 #ifndef FEAT_EVAL
444 # define ex_debug ex_ni
445 # define ex_breakadd ex_ni
446 # define ex_debuggreedy ex_ni
447 # define ex_breakdel ex_ni
448 # define ex_breaklist ex_ni
449 #endif
451 #ifndef FEAT_CMDHIST
452 # define ex_history ex_ni
453 #endif
454 #ifndef FEAT_JUMPLIST
455 # define ex_jumps ex_ni
456 # define ex_changes ex_ni
457 #endif
459 #ifndef FEAT_PROFILE
460 # define ex_profile ex_ni
461 #endif
464 * Declare cmdnames[].
466 #define DO_DECLARE_EXCMD
467 #include "ex_cmds.h"
470 * Table used to quickly search for a command, based on its first character.
472 static cmdidx_T cmdidxs[27] =
474 CMD_append,
475 CMD_buffer,
476 CMD_change,
477 CMD_delete,
478 CMD_edit,
479 CMD_file,
480 CMD_global,
481 CMD_help,
482 CMD_insert,
483 CMD_join,
484 CMD_k,
485 CMD_list,
486 CMD_move,
487 CMD_next,
488 CMD_open,
489 CMD_print,
490 CMD_quit,
491 CMD_read,
492 CMD_substitute,
493 CMD_t,
494 CMD_undo,
495 CMD_vglobal,
496 CMD_write,
497 CMD_xit,
498 CMD_yank,
499 CMD_z,
500 CMD_bang
503 static char_u dollar_command[2] = {'$', 0};
506 #ifdef FEAT_EVAL
507 /* Struct for storing a line inside a while/for loop */
508 typedef struct
510 char_u *line; /* command line */
511 linenr_T lnum; /* sourcing_lnum of the line */
512 } wcmd_T;
515 * Structure used to store info for line position in a while or for loop.
516 * This is required, because do_one_cmd() may invoke ex_function(), which
517 * reads more lines that may come from the while/for loop.
519 struct loop_cookie
521 garray_T *lines_gap; /* growarray with line info */
522 int current_line; /* last read line from growarray */
523 int repeating; /* TRUE when looping a second time */
524 /* When "repeating" is FALSE use "getline" and "cookie" to get lines */
525 char_u *(*getline) __ARGS((int, void *, int));
526 void *cookie;
529 static char_u *get_loop_line __ARGS((int c, void *cookie, int indent));
530 static int store_loop_line __ARGS((garray_T *gap, char_u *line));
531 static void free_cmdlines __ARGS((garray_T *gap));
533 /* Struct to save a few things while debugging. Used in do_cmdline() only. */
534 struct dbg_stuff
536 int trylevel;
537 int force_abort;
538 except_T *caught_stack;
539 char_u *vv_exception;
540 char_u *vv_throwpoint;
541 int did_emsg;
542 int got_int;
543 int did_throw;
544 int need_rethrow;
545 int check_cstack;
546 except_T *current_exception;
549 static void save_dbg_stuff __ARGS((struct dbg_stuff *dsp));
550 static void restore_dbg_stuff __ARGS((struct dbg_stuff *dsp));
552 static void
553 save_dbg_stuff(dsp)
554 struct dbg_stuff *dsp;
556 dsp->trylevel = trylevel; trylevel = 0;
557 dsp->force_abort = force_abort; force_abort = FALSE;
558 dsp->caught_stack = caught_stack; caught_stack = NULL;
559 dsp->vv_exception = v_exception(NULL);
560 dsp->vv_throwpoint = v_throwpoint(NULL);
562 /* Necessary for debugging an inactive ":catch", ":finally", ":endtry" */
563 dsp->did_emsg = did_emsg; did_emsg = FALSE;
564 dsp->got_int = got_int; got_int = FALSE;
565 dsp->did_throw = did_throw; did_throw = FALSE;
566 dsp->need_rethrow = need_rethrow; need_rethrow = FALSE;
567 dsp->check_cstack = check_cstack; check_cstack = FALSE;
568 dsp->current_exception = current_exception; current_exception = NULL;
571 static void
572 restore_dbg_stuff(dsp)
573 struct dbg_stuff *dsp;
575 suppress_errthrow = FALSE;
576 trylevel = dsp->trylevel;
577 force_abort = dsp->force_abort;
578 caught_stack = dsp->caught_stack;
579 (void)v_exception(dsp->vv_exception);
580 (void)v_throwpoint(dsp->vv_throwpoint);
581 did_emsg = dsp->did_emsg;
582 got_int = dsp->got_int;
583 did_throw = dsp->did_throw;
584 need_rethrow = dsp->need_rethrow;
585 check_cstack = dsp->check_cstack;
586 current_exception = dsp->current_exception;
588 #endif
592 * do_exmode(): Repeatedly get commands for the "Ex" mode, until the ":vi"
593 * command is given.
595 void
596 do_exmode(improved)
597 int improved; /* TRUE for "improved Ex" mode */
599 int save_msg_scroll;
600 int prev_msg_row;
601 linenr_T prev_line;
602 int changedtick;
604 if (improved)
605 exmode_active = EXMODE_VIM;
606 else
607 exmode_active = EXMODE_NORMAL;
608 State = NORMAL;
610 /* When using ":global /pat/ visual" and then "Q" we return to continue
611 * the :global command. */
612 if (global_busy)
613 return;
615 save_msg_scroll = msg_scroll;
616 ++RedrawingDisabled; /* don't redisplay the window */
617 ++no_wait_return; /* don't wait for return */
618 #ifdef FEAT_GUI
619 /* Ignore scrollbar and mouse events in Ex mode */
620 ++hold_gui_events;
621 #endif
622 #ifdef FEAT_SNIFF
623 want_sniff_request = 0; /* No K_SNIFF wanted */
624 #endif
626 MSG(_("Entering Ex mode. Type \"visual\" to go to Normal mode."));
627 while (exmode_active)
629 #ifdef FEAT_EX_EXTRA
630 /* Check for a ":normal" command and no more characters left. */
631 if (ex_normal_busy > 0 && typebuf.tb_len == 0)
633 exmode_active = FALSE;
634 break;
636 #endif
637 msg_scroll = TRUE;
638 need_wait_return = FALSE;
639 ex_pressedreturn = FALSE;
640 ex_no_reprint = FALSE;
641 changedtick = curbuf->b_changedtick;
642 prev_msg_row = msg_row;
643 prev_line = curwin->w_cursor.lnum;
644 #ifdef FEAT_SNIFF
645 ProcessSniffRequests();
646 #endif
647 if (improved)
649 cmdline_row = msg_row;
650 do_cmdline(NULL, getexline, NULL, 0);
652 else
653 do_cmdline(NULL, getexmodeline, NULL, DOCMD_NOWAIT);
654 lines_left = Rows - 1;
656 if ((prev_line != curwin->w_cursor.lnum
657 || changedtick != curbuf->b_changedtick) && !ex_no_reprint)
659 if (curbuf->b_ml.ml_flags & ML_EMPTY)
660 EMSG(_(e_emptybuf));
661 else
663 if (ex_pressedreturn)
665 /* go up one line, to overwrite the ":<CR>" line, so the
666 * output doesn't contain empty lines. */
667 msg_row = prev_msg_row;
668 if (prev_msg_row == Rows - 1)
669 msg_row--;
671 msg_col = 0;
672 print_line_no_prefix(curwin->w_cursor.lnum, FALSE, FALSE);
673 msg_clr_eos();
676 else if (ex_pressedreturn && !ex_no_reprint) /* must be at EOF */
678 if (curbuf->b_ml.ml_flags & ML_EMPTY)
679 EMSG(_(e_emptybuf));
680 else
681 EMSG(_("E501: At end-of-file"));
685 #ifdef FEAT_GUI
686 --hold_gui_events;
687 #endif
688 --RedrawingDisabled;
689 --no_wait_return;
690 update_screen(CLEAR);
691 need_wait_return = FALSE;
692 msg_scroll = save_msg_scroll;
696 * Execute a simple command line. Used for translated commands like "*".
699 do_cmdline_cmd(cmd)
700 char_u *cmd;
702 return do_cmdline(cmd, NULL, NULL,
703 DOCMD_VERBOSE|DOCMD_NOWAIT|DOCMD_KEYTYPED);
707 * do_cmdline(): execute one Ex command line
709 * 1. Execute "cmdline" when it is not NULL.
710 * If "cmdline" is NULL, or more lines are needed, getline() is used.
711 * 2. Split up in parts separated with '|'.
713 * This function can be called recursively!
715 * flags:
716 * DOCMD_VERBOSE - The command will be included in the error message.
717 * DOCMD_NOWAIT - Don't call wait_return() and friends.
718 * DOCMD_REPEAT - Repeat execution until getline() returns NULL.
719 * DOCMD_KEYTYPED - Don't reset KeyTyped.
720 * DOCMD_EXCRESET - Reset the exception environment (used for debugging).
721 * DOCMD_KEEPLINE - Store first typed line (for repeating with ".").
723 * return FAIL if cmdline could not be executed, OK otherwise
726 do_cmdline(cmdline, getline, cookie, flags)
727 char_u *cmdline;
728 char_u *(*getline) __ARGS((int, void *, int));
729 void *cookie; /* argument for getline() */
730 int flags;
732 char_u *next_cmdline; /* next cmd to execute */
733 char_u *cmdline_copy = NULL; /* copy of cmd line */
734 int used_getline = FALSE; /* used "getline" to obtain command */
735 static int recursive = 0; /* recursive depth */
736 int msg_didout_before_start = 0;
737 int count = 0; /* line number count */
738 int did_inc = FALSE; /* incremented RedrawingDisabled */
739 int retval = OK;
740 #ifdef FEAT_EVAL
741 struct condstack cstack; /* conditional stack */
742 garray_T lines_ga; /* keep lines for ":while"/":for" */
743 int current_line = 0; /* active line in lines_ga */
744 char_u *fname = NULL; /* function or script name */
745 linenr_T *breakpoint = NULL; /* ptr to breakpoint field in cookie */
746 int *dbg_tick = NULL; /* ptr to dbg_tick field in cookie */
747 struct dbg_stuff debug_saved; /* saved things for debug mode */
748 int initial_trylevel;
749 struct msglist **saved_msg_list = NULL;
750 struct msglist *private_msg_list;
752 /* "getline" and "cookie" passed to do_one_cmd() */
753 char_u *(*cmd_getline) __ARGS((int, void *, int));
754 void *cmd_cookie;
755 struct loop_cookie cmd_loop_cookie;
756 void *real_cookie;
757 int getline_is_func;
758 #else
759 # define cmd_getline getline
760 # define cmd_cookie cookie
761 #endif
762 static int call_depth = 0; /* recursiveness */
764 #ifdef FEAT_EVAL
765 /* For every pair of do_cmdline()/do_one_cmd() calls, use an extra memory
766 * location for storing error messages to be converted to an exception.
767 * This ensures that the do_errthrow() call in do_one_cmd() does not
768 * combine the messages stored by an earlier invocation of do_one_cmd()
769 * with the command name of the later one. This would happen when
770 * BufWritePost autocommands are executed after a write error. */
771 saved_msg_list = msg_list;
772 msg_list = &private_msg_list;
773 private_msg_list = NULL;
774 #endif
776 /* It's possible to create an endless loop with ":execute", catch that
777 * here. The value of 200 allows nested function calls, ":source", etc. */
778 if (call_depth == 200)
780 EMSG(_("E169: Command too recursive"));
781 #ifdef FEAT_EVAL
782 /* When converting to an exception, we do not include the command name
783 * since this is not an error of the specific command. */
784 do_errthrow((struct condstack *)NULL, (char_u *)NULL);
785 msg_list = saved_msg_list;
786 #endif
787 return FAIL;
789 ++call_depth;
791 #ifdef FEAT_EVAL
792 cstack.cs_idx = -1;
793 cstack.cs_looplevel = 0;
794 cstack.cs_trylevel = 0;
795 cstack.cs_emsg_silent_list = NULL;
796 cstack.cs_lflags = 0;
797 ga_init2(&lines_ga, (int)sizeof(wcmd_T), 10);
799 real_cookie = getline_cookie(getline, cookie);
801 /* Inside a function use a higher nesting level. */
802 getline_is_func = getline_equal(getline, cookie, get_func_line);
803 if (getline_is_func && ex_nesting_level == func_level(real_cookie))
804 ++ex_nesting_level;
806 /* Get the function or script name and the address where the next breakpoint
807 * line and the debug tick for a function or script are stored. */
808 if (getline_is_func)
810 fname = func_name(real_cookie);
811 breakpoint = func_breakpoint(real_cookie);
812 dbg_tick = func_dbg_tick(real_cookie);
814 else if (getline_equal(getline, cookie, getsourceline))
816 fname = sourcing_name;
817 breakpoint = source_breakpoint(real_cookie);
818 dbg_tick = source_dbg_tick(real_cookie);
822 * Initialize "force_abort" and "suppress_errthrow" at the top level.
824 if (!recursive)
826 force_abort = FALSE;
827 suppress_errthrow = FALSE;
831 * If requested, store and reset the global values controlling the
832 * exception handling (used when debugging). Otherwise clear it to avoid
833 * a bogus compiler warning when the optimizer uses inline functions...
835 if (flags & DOCMD_EXCRESET)
836 save_dbg_stuff(&debug_saved);
837 else
838 memset(&debug_saved, 0, 1);
840 initial_trylevel = trylevel;
843 * "did_throw" will be set to TRUE when an exception is being thrown.
845 did_throw = FALSE;
846 #endif
848 * "did_emsg" will be set to TRUE when emsg() is used, in which case we
849 * cancel the whole command line, and any if/endif or loop.
850 * If force_abort is set, we cancel everything.
852 did_emsg = FALSE;
855 * KeyTyped is only set when calling vgetc(). Reset it here when not
856 * calling vgetc() (sourced command lines).
858 if (!(flags & DOCMD_KEYTYPED) && !getline_equal(getline, cookie, getexline))
859 KeyTyped = FALSE;
862 * Continue executing command lines:
863 * - when inside an ":if", ":while" or ":for"
864 * - for multiple commands on one line, separated with '|'
865 * - when repeating until there are no more lines (for ":source")
867 next_cmdline = cmdline;
870 #ifdef FEAT_EVAL
871 getline_is_func = getline_equal(getline, cookie, get_func_line);
872 #endif
874 /* stop skipping cmds for an error msg after all endif/while/for */
875 if (next_cmdline == NULL
876 #ifdef FEAT_EVAL
877 && !force_abort
878 && cstack.cs_idx < 0
879 && !(getline_is_func && func_has_abort(real_cookie))
880 #endif
882 did_emsg = FALSE;
885 * 1. If repeating a line in a loop, get a line from lines_ga.
886 * 2. If no line given: Get an allocated line with getline().
887 * 3. If a line is given: Make a copy, so we can mess with it.
890 #ifdef FEAT_EVAL
891 /* 1. If repeating, get a previous line from lines_ga. */
892 if (cstack.cs_looplevel > 0 && current_line < lines_ga.ga_len)
894 /* Each '|' separated command is stored separately in lines_ga, to
895 * be able to jump to it. Don't use next_cmdline now. */
896 vim_free(cmdline_copy);
897 cmdline_copy = NULL;
899 /* Check if a function has returned or, unless it has an unclosed
900 * try conditional, aborted. */
901 if (getline_is_func)
903 # ifdef FEAT_PROFILE
904 if (do_profiling == PROF_YES)
905 func_line_end(real_cookie);
906 # endif
907 if (func_has_ended(real_cookie))
909 retval = FAIL;
910 break;
913 #ifdef FEAT_PROFILE
914 else if (do_profiling == PROF_YES
915 && getline_equal(getline, cookie, getsourceline))
916 script_line_end();
917 #endif
919 /* Check if a sourced file hit a ":finish" command. */
920 if (source_finished(getline, cookie))
922 retval = FAIL;
923 break;
926 /* If breakpoints have been added/deleted need to check for it. */
927 if (breakpoint != NULL && dbg_tick != NULL
928 && *dbg_tick != debug_tick)
930 *breakpoint = dbg_find_breakpoint(
931 getline_equal(getline, cookie, getsourceline),
932 fname, sourcing_lnum);
933 *dbg_tick = debug_tick;
936 next_cmdline = ((wcmd_T *)(lines_ga.ga_data))[current_line].line;
937 sourcing_lnum = ((wcmd_T *)(lines_ga.ga_data))[current_line].lnum;
939 /* Did we encounter a breakpoint? */
940 if (breakpoint != NULL && *breakpoint != 0
941 && *breakpoint <= sourcing_lnum)
943 dbg_breakpoint(fname, sourcing_lnum);
944 /* Find next breakpoint. */
945 *breakpoint = dbg_find_breakpoint(
946 getline_equal(getline, cookie, getsourceline),
947 fname, sourcing_lnum);
948 *dbg_tick = debug_tick;
950 # ifdef FEAT_PROFILE
951 if (do_profiling == PROF_YES)
953 if (getline_is_func)
954 func_line_start(real_cookie);
955 else if (getline_equal(getline, cookie, getsourceline))
956 script_line_start();
958 # endif
961 if (cstack.cs_looplevel > 0)
963 /* Inside a while/for loop we need to store the lines and use them
964 * again. Pass a different "getline" function to do_one_cmd()
965 * below, so that it stores lines in or reads them from
966 * "lines_ga". Makes it possible to define a function inside a
967 * while/for loop. */
968 cmd_getline = get_loop_line;
969 cmd_cookie = (void *)&cmd_loop_cookie;
970 cmd_loop_cookie.lines_gap = &lines_ga;
971 cmd_loop_cookie.current_line = current_line;
972 cmd_loop_cookie.getline = getline;
973 cmd_loop_cookie.cookie = cookie;
974 cmd_loop_cookie.repeating = (current_line < lines_ga.ga_len);
976 else
978 cmd_getline = getline;
979 cmd_cookie = cookie;
981 #endif
983 /* 2. If no line given, get an allocated line with getline(). */
984 if (next_cmdline == NULL)
987 * Need to set msg_didout for the first line after an ":if",
988 * otherwise the ":if" will be overwritten.
990 if (count == 1 && getline_equal(getline, cookie, getexline))
991 msg_didout = TRUE;
992 if (getline == NULL || (next_cmdline = getline(':', cookie,
993 #ifdef FEAT_EVAL
994 cstack.cs_idx < 0 ? 0 : (cstack.cs_idx + 1) * 2
995 #else
997 #endif
998 )) == NULL)
1000 /* Don't call wait_return for aborted command line. The NULL
1001 * returned for the end of a sourced file or executed function
1002 * doesn't do this. */
1003 if (KeyTyped && !(flags & DOCMD_REPEAT))
1004 need_wait_return = FALSE;
1005 retval = FAIL;
1006 break;
1008 used_getline = TRUE;
1011 * Keep the first typed line. Clear it when more lines are typed.
1013 if (flags & DOCMD_KEEPLINE)
1015 vim_free(repeat_cmdline);
1016 if (count == 0)
1017 repeat_cmdline = vim_strsave(next_cmdline);
1018 else
1019 repeat_cmdline = NULL;
1023 /* 3. Make a copy of the command so we can mess with it. */
1024 else if (cmdline_copy == NULL)
1026 next_cmdline = vim_strsave(next_cmdline);
1027 if (next_cmdline == NULL)
1029 EMSG(_(e_outofmem));
1030 retval = FAIL;
1031 break;
1034 cmdline_copy = next_cmdline;
1036 #ifdef FEAT_EVAL
1038 * Save the current line when inside a ":while" or ":for", and when
1039 * the command looks like a ":while" or ":for", because we may need it
1040 * later. When there is a '|' and another command, it is stored
1041 * separately, because we need to be able to jump back to it from an
1042 * :endwhile/:endfor.
1044 if (current_line == lines_ga.ga_len
1045 && (cstack.cs_looplevel || has_loop_cmd(next_cmdline)))
1047 if (store_loop_line(&lines_ga, next_cmdline) == FAIL)
1049 retval = FAIL;
1050 break;
1053 did_endif = FALSE;
1054 #endif
1056 if (count++ == 0)
1059 * All output from the commands is put below each other, without
1060 * waiting for a return. Don't do this when executing commands
1061 * from a script or when being called recursive (e.g. for ":e
1062 * +command file").
1064 if (!(flags & DOCMD_NOWAIT) && !recursive)
1066 msg_didout_before_start = msg_didout;
1067 msg_didany = FALSE; /* no output yet */
1068 msg_start();
1069 msg_scroll = TRUE; /* put messages below each other */
1070 ++no_wait_return; /* dont wait for return until finished */
1071 ++RedrawingDisabled;
1072 did_inc = TRUE;
1076 if (p_verbose >= 15 && sourcing_name != NULL)
1078 ++no_wait_return;
1079 verbose_enter_scroll();
1081 smsg((char_u *)_("line %ld: %s"),
1082 (long)sourcing_lnum, cmdline_copy);
1083 if (msg_silent == 0)
1084 msg_puts((char_u *)"\n"); /* don't overwrite this */
1086 verbose_leave_scroll();
1087 --no_wait_return;
1091 * 2. Execute one '|' separated command.
1092 * do_one_cmd() will return NULL if there is no trailing '|'.
1093 * "cmdline_copy" can change, e.g. for '%' and '#' expansion.
1095 ++recursive;
1096 next_cmdline = do_one_cmd(&cmdline_copy, flags & DOCMD_VERBOSE,
1097 #ifdef FEAT_EVAL
1098 &cstack,
1099 #endif
1100 cmd_getline, cmd_cookie);
1101 --recursive;
1103 #ifdef FEAT_EVAL
1104 if (cmd_cookie == (void *)&cmd_loop_cookie)
1105 /* Use "current_line" from "cmd_loop_cookie", it may have been
1106 * incremented when defining a function. */
1107 current_line = cmd_loop_cookie.current_line;
1108 #endif
1110 if (next_cmdline == NULL)
1112 vim_free(cmdline_copy);
1113 cmdline_copy = NULL;
1114 #ifdef FEAT_CMDHIST
1116 * If the command was typed, remember it for the ':' register.
1117 * Do this AFTER executing the command to make :@: work.
1119 if (getline_equal(getline, cookie, getexline)
1120 && new_last_cmdline != NULL)
1122 vim_free(last_cmdline);
1123 last_cmdline = new_last_cmdline;
1124 new_last_cmdline = NULL;
1126 #endif
1128 else
1130 /* need to copy the command after the '|' to cmdline_copy, for the
1131 * next do_one_cmd() */
1132 STRMOVE(cmdline_copy, next_cmdline);
1133 next_cmdline = cmdline_copy;
1137 #ifdef FEAT_EVAL
1138 /* reset did_emsg for a function that is not aborted by an error */
1139 if (did_emsg && !force_abort
1140 && getline_equal(getline, cookie, get_func_line)
1141 && !func_has_abort(real_cookie))
1142 did_emsg = FALSE;
1144 if (cstack.cs_looplevel > 0)
1146 ++current_line;
1149 * An ":endwhile", ":endfor" and ":continue" is handled here.
1150 * If we were executing commands, jump back to the ":while" or
1151 * ":for".
1152 * If we were not executing commands, decrement cs_looplevel.
1154 if (cstack.cs_lflags & (CSL_HAD_CONT | CSL_HAD_ENDLOOP))
1156 cstack.cs_lflags &= ~(CSL_HAD_CONT | CSL_HAD_ENDLOOP);
1158 /* Jump back to the matching ":while" or ":for". Be careful
1159 * not to use a cs_line[] from an entry that isn't a ":while"
1160 * or ":for": It would make "current_line" invalid and can
1161 * cause a crash. */
1162 if (!did_emsg && !got_int && !did_throw
1163 && cstack.cs_idx >= 0
1164 && (cstack.cs_flags[cstack.cs_idx]
1165 & (CSF_WHILE | CSF_FOR))
1166 && cstack.cs_line[cstack.cs_idx] >= 0
1167 && (cstack.cs_flags[cstack.cs_idx] & CSF_ACTIVE))
1169 current_line = cstack.cs_line[cstack.cs_idx];
1170 /* remember we jumped there */
1171 cstack.cs_lflags |= CSL_HAD_LOOP;
1172 line_breakcheck(); /* check if CTRL-C typed */
1174 /* Check for the next breakpoint at or after the ":while"
1175 * or ":for". */
1176 if (breakpoint != NULL)
1178 *breakpoint = dbg_find_breakpoint(
1179 getline_equal(getline, cookie, getsourceline),
1180 fname,
1181 ((wcmd_T *)lines_ga.ga_data)[current_line].lnum-1);
1182 *dbg_tick = debug_tick;
1185 else
1187 /* can only get here with ":endwhile" or ":endfor" */
1188 if (cstack.cs_idx >= 0)
1189 rewind_conditionals(&cstack, cstack.cs_idx - 1,
1190 CSF_WHILE | CSF_FOR, &cstack.cs_looplevel);
1195 * For a ":while" or ":for" we need to remember the line number.
1197 else if (cstack.cs_lflags & CSL_HAD_LOOP)
1199 cstack.cs_lflags &= ~CSL_HAD_LOOP;
1200 cstack.cs_line[cstack.cs_idx] = current_line - 1;
1205 * When not inside any ":while" loop, clear remembered lines.
1207 if (cstack.cs_looplevel == 0)
1209 if (lines_ga.ga_len > 0)
1211 sourcing_lnum =
1212 ((wcmd_T *)lines_ga.ga_data)[lines_ga.ga_len - 1].lnum;
1213 free_cmdlines(&lines_ga);
1215 current_line = 0;
1219 * A ":finally" makes did_emsg, got_int, and did_throw pending for
1220 * being restored at the ":endtry". Reset them here and set the
1221 * ACTIVE and FINALLY flags, so that the finally clause gets executed.
1222 * This includes the case where a missing ":endif", ":endwhile" or
1223 * ":endfor" was detected by the ":finally" itself.
1225 if (cstack.cs_lflags & CSL_HAD_FINA)
1227 cstack.cs_lflags &= ~CSL_HAD_FINA;
1228 report_make_pending(cstack.cs_pending[cstack.cs_idx]
1229 & (CSTP_ERROR | CSTP_INTERRUPT | CSTP_THROW),
1230 did_throw ? (void *)current_exception : NULL);
1231 did_emsg = got_int = did_throw = FALSE;
1232 cstack.cs_flags[cstack.cs_idx] |= CSF_ACTIVE | CSF_FINALLY;
1235 /* Update global "trylevel" for recursive calls to do_cmdline() from
1236 * within this loop. */
1237 trylevel = initial_trylevel + cstack.cs_trylevel;
1240 * If the outermost try conditional (across function calls and sourced
1241 * files) is aborted because of an error, an interrupt, or an uncaught
1242 * exception, cancel everything. If it is left normally, reset
1243 * force_abort to get the non-EH compatible abortion behavior for
1244 * the rest of the script.
1246 if (trylevel == 0 && !did_emsg && !got_int && !did_throw)
1247 force_abort = FALSE;
1249 /* Convert an interrupt to an exception if appropriate. */
1250 (void)do_intthrow(&cstack);
1251 #endif /* FEAT_EVAL */
1255 * Continue executing command lines when:
1256 * - no CTRL-C typed, no aborting error, no exception thrown or try
1257 * conditionals need to be checked for executing finally clauses or
1258 * catching an interrupt exception
1259 * - didn't get an error message or lines are not typed
1260 * - there is a command after '|', inside a :if, :while, :for or :try, or
1261 * looping for ":source" command or function call.
1263 while (!((got_int
1264 #ifdef FEAT_EVAL
1265 || (did_emsg && force_abort) || did_throw
1266 #endif
1268 #ifdef FEAT_EVAL
1269 && cstack.cs_trylevel == 0
1270 #endif
1272 && !(did_emsg && used_getline
1273 && (getline_equal(getline, cookie, getexmodeline)
1274 || getline_equal(getline, cookie, getexline)))
1275 && (next_cmdline != NULL
1276 #ifdef FEAT_EVAL
1277 || cstack.cs_idx >= 0
1278 #endif
1279 || (flags & DOCMD_REPEAT)));
1281 vim_free(cmdline_copy);
1282 #ifdef FEAT_EVAL
1283 free_cmdlines(&lines_ga);
1284 ga_clear(&lines_ga);
1286 if (cstack.cs_idx >= 0)
1289 * If a sourced file or executed function ran to its end, report the
1290 * unclosed conditional.
1292 if (!got_int && !did_throw
1293 && ((getline_equal(getline, cookie, getsourceline)
1294 && !source_finished(getline, cookie))
1295 || (getline_equal(getline, cookie, get_func_line)
1296 && !func_has_ended(real_cookie))))
1298 if (cstack.cs_flags[cstack.cs_idx] & CSF_TRY)
1299 EMSG(_(e_endtry));
1300 else if (cstack.cs_flags[cstack.cs_idx] & CSF_WHILE)
1301 EMSG(_(e_endwhile));
1302 else if (cstack.cs_flags[cstack.cs_idx] & CSF_FOR)
1303 EMSG(_(e_endfor));
1304 else
1305 EMSG(_(e_endif));
1309 * Reset "trylevel" in case of a ":finish" or ":return" or a missing
1310 * ":endtry" in a sourced file or executed function. If the try
1311 * conditional is in its finally clause, ignore anything pending.
1312 * If it is in a catch clause, finish the caught exception.
1313 * Also cleanup any "cs_forinfo" structures.
1317 int idx = cleanup_conditionals(&cstack, 0, TRUE);
1319 if (idx >= 0)
1320 --idx; /* remove try block not in its finally clause */
1321 rewind_conditionals(&cstack, idx, CSF_WHILE | CSF_FOR,
1322 &cstack.cs_looplevel);
1324 while (cstack.cs_idx >= 0);
1325 trylevel = initial_trylevel;
1328 /* If a missing ":endtry", ":endwhile", ":endfor", or ":endif" or a memory
1329 * lack was reported above and the error message is to be converted to an
1330 * exception, do this now after rewinding the cstack. */
1331 do_errthrow(&cstack, getline_equal(getline, cookie, get_func_line)
1332 ? (char_u *)"endfunction" : (char_u *)NULL);
1334 if (trylevel == 0)
1337 * When an exception is being thrown out of the outermost try
1338 * conditional, discard the uncaught exception, disable the conversion
1339 * of interrupts or errors to exceptions, and ensure that no more
1340 * commands are executed.
1342 if (did_throw)
1344 void *p = NULL;
1345 char_u *saved_sourcing_name;
1346 int saved_sourcing_lnum;
1347 struct msglist *messages = NULL, *next;
1350 * If the uncaught exception is a user exception, report it as an
1351 * error. If it is an error exception, display the saved error
1352 * message now. For an interrupt exception, do nothing; the
1353 * interrupt message is given elsewhere.
1355 switch (current_exception->type)
1357 case ET_USER:
1358 vim_snprintf((char *)IObuff, IOSIZE,
1359 _("E605: Exception not caught: %s"),
1360 current_exception->value);
1361 p = vim_strsave(IObuff);
1362 break;
1363 case ET_ERROR:
1364 messages = current_exception->messages;
1365 current_exception->messages = NULL;
1366 break;
1367 case ET_INTERRUPT:
1368 break;
1369 default:
1370 p = vim_strsave((char_u *)_(e_internal));
1373 saved_sourcing_name = sourcing_name;
1374 saved_sourcing_lnum = sourcing_lnum;
1375 sourcing_name = current_exception->throw_name;
1376 sourcing_lnum = current_exception->throw_lnum;
1377 current_exception->throw_name = NULL;
1379 discard_current_exception(); /* uses IObuff if 'verbose' */
1380 suppress_errthrow = TRUE;
1381 force_abort = TRUE;
1383 if (messages != NULL)
1387 next = messages->next;
1388 emsg(messages->msg);
1389 vim_free(messages->msg);
1390 vim_free(messages);
1391 messages = next;
1393 while (messages != NULL);
1395 else if (p != NULL)
1397 emsg(p);
1398 vim_free(p);
1400 vim_free(sourcing_name);
1401 sourcing_name = saved_sourcing_name;
1402 sourcing_lnum = saved_sourcing_lnum;
1406 * On an interrupt or an aborting error not converted to an exception,
1407 * disable the conversion of errors to exceptions. (Interrupts are not
1408 * converted any more, here.) This enables also the interrupt message
1409 * when force_abort is set and did_emsg unset in case of an interrupt
1410 * from a finally clause after an error.
1412 else if (got_int || (did_emsg && force_abort))
1413 suppress_errthrow = TRUE;
1417 * The current cstack will be freed when do_cmdline() returns. An uncaught
1418 * exception will have to be rethrown in the previous cstack. If a function
1419 * has just returned or a script file was just finished and the previous
1420 * cstack belongs to the same function or, respectively, script file, it
1421 * will have to be checked for finally clauses to be executed due to the
1422 * ":return" or ":finish". This is done in do_one_cmd().
1424 if (did_throw)
1425 need_rethrow = TRUE;
1426 if ((getline_equal(getline, cookie, getsourceline)
1427 && ex_nesting_level > source_level(real_cookie))
1428 || (getline_equal(getline, cookie, get_func_line)
1429 && ex_nesting_level > func_level(real_cookie) + 1))
1431 if (!did_throw)
1432 check_cstack = TRUE;
1434 else
1436 /* When leaving a function, reduce nesting level. */
1437 if (getline_equal(getline, cookie, get_func_line))
1438 --ex_nesting_level;
1440 * Go to debug mode when returning from a function in which we are
1441 * single-stepping.
1443 if ((getline_equal(getline, cookie, getsourceline)
1444 || getline_equal(getline, cookie, get_func_line))
1445 && ex_nesting_level + 1 <= debug_break_level)
1446 do_debug(getline_equal(getline, cookie, getsourceline)
1447 ? (char_u *)_("End of sourced file")
1448 : (char_u *)_("End of function"));
1452 * Restore the exception environment (done after returning from the
1453 * debugger).
1455 if (flags & DOCMD_EXCRESET)
1456 restore_dbg_stuff(&debug_saved);
1458 msg_list = saved_msg_list;
1459 #endif /* FEAT_EVAL */
1462 * If there was too much output to fit on the command line, ask the user to
1463 * hit return before redrawing the screen. With the ":global" command we do
1464 * this only once after the command is finished.
1466 if (did_inc)
1468 --RedrawingDisabled;
1469 --no_wait_return;
1470 msg_scroll = FALSE;
1473 * When just finished an ":if"-":else" which was typed, no need to
1474 * wait for hit-return. Also for an error situation.
1476 if (retval == FAIL
1477 #ifdef FEAT_EVAL
1478 || (did_endif && KeyTyped && !did_emsg)
1479 #endif
1482 need_wait_return = FALSE;
1483 msg_didany = FALSE; /* don't wait when restarting edit */
1485 else if (need_wait_return)
1488 * The msg_start() above clears msg_didout. The wait_return we do
1489 * here should not overwrite the command that may be shown before
1490 * doing that.
1492 msg_didout |= msg_didout_before_start;
1493 wait_return(FALSE);
1497 #ifndef FEAT_EVAL
1499 * Reset if_level, in case a sourced script file contains more ":if" than
1500 * ":endif" (could be ":if x | foo | endif").
1502 if_level = 0;
1503 #endif
1505 --call_depth;
1506 return retval;
1509 #ifdef FEAT_EVAL
1511 * Obtain a line when inside a ":while" or ":for" loop.
1513 static char_u *
1514 get_loop_line(c, cookie, indent)
1515 int c;
1516 void *cookie;
1517 int indent;
1519 struct loop_cookie *cp = (struct loop_cookie *)cookie;
1520 wcmd_T *wp;
1521 char_u *line;
1523 if (cp->current_line + 1 >= cp->lines_gap->ga_len)
1525 if (cp->repeating)
1526 return NULL; /* trying to read past ":endwhile"/":endfor" */
1528 /* First time inside the ":while"/":for": get line normally. */
1529 if (cp->getline == NULL)
1530 line = getcmdline(c, 0L, indent);
1531 else
1532 line = cp->getline(c, cp->cookie, indent);
1533 if (line != NULL && store_loop_line(cp->lines_gap, line) == OK)
1534 ++cp->current_line;
1536 return line;
1539 KeyTyped = FALSE;
1540 ++cp->current_line;
1541 wp = (wcmd_T *)(cp->lines_gap->ga_data) + cp->current_line;
1542 sourcing_lnum = wp->lnum;
1543 return vim_strsave(wp->line);
1547 * Store a line in "gap" so that a ":while" loop can execute it again.
1549 static int
1550 store_loop_line(gap, line)
1551 garray_T *gap;
1552 char_u *line;
1554 if (ga_grow(gap, 1) == FAIL)
1555 return FAIL;
1556 ((wcmd_T *)(gap->ga_data))[gap->ga_len].line = vim_strsave(line);
1557 ((wcmd_T *)(gap->ga_data))[gap->ga_len].lnum = sourcing_lnum;
1558 ++gap->ga_len;
1559 return OK;
1563 * Free the lines stored for a ":while" or ":for" loop.
1565 static void
1566 free_cmdlines(gap)
1567 garray_T *gap;
1569 while (gap->ga_len > 0)
1571 vim_free(((wcmd_T *)(gap->ga_data))[gap->ga_len - 1].line);
1572 --gap->ga_len;
1575 #endif
1578 * If "fgetline" is get_loop_line(), return TRUE if the getline it uses equals
1579 * "func". * Otherwise return TRUE when "fgetline" equals "func".
1581 /*ARGSUSED*/
1583 getline_equal(fgetline, cookie, func)
1584 char_u *(*fgetline) __ARGS((int, void *, int));
1585 void *cookie; /* argument for fgetline() */
1586 char_u *(*func) __ARGS((int, void *, int));
1588 #ifdef FEAT_EVAL
1589 char_u *(*gp) __ARGS((int, void *, int));
1590 struct loop_cookie *cp;
1592 /* When "fgetline" is "get_loop_line()" use the "cookie" to find the
1593 * function that's originally used to obtain the lines. This may be
1594 * nested several levels. */
1595 gp = fgetline;
1596 cp = (struct loop_cookie *)cookie;
1597 while (gp == get_loop_line)
1599 gp = cp->getline;
1600 cp = cp->cookie;
1602 return gp == func;
1603 #else
1604 return fgetline == func;
1605 #endif
1608 #if defined(FEAT_EVAL) || defined(FEAT_MBYTE) || defined(PROTO)
1610 * If "fgetline" is get_loop_line(), return the cookie used by the original
1611 * getline function. Otherwise return "cookie".
1613 /*ARGSUSED*/
1614 void *
1615 getline_cookie(fgetline, cookie)
1616 char_u *(*fgetline) __ARGS((int, void *, int));
1617 void *cookie; /* argument for fgetline() */
1619 # ifdef FEAT_EVAL
1620 char_u *(*gp) __ARGS((int, void *, int));
1621 struct loop_cookie *cp;
1623 /* When "fgetline" is "get_loop_line()" use the "cookie" to find the
1624 * cookie that's originally used to obtain the lines. This may be nested
1625 * several levels. */
1626 gp = fgetline;
1627 cp = (struct loop_cookie *)cookie;
1628 while (gp == get_loop_line)
1630 gp = cp->getline;
1631 cp = cp->cookie;
1633 return cp;
1634 # else
1635 return cookie;
1636 # endif
1638 #endif
1641 * Execute one Ex command.
1643 * If 'sourcing' is TRUE, the command will be included in the error message.
1645 * 1. skip comment lines and leading space
1646 * 2. handle command modifiers
1647 * 3. parse range
1648 * 4. parse command
1649 * 5. parse arguments
1650 * 6. switch on command name
1652 * Note: "fgetline" can be NULL.
1654 * This function may be called recursively!
1656 #if (_MSC_VER == 1200)
1658 * Avoid optimisation bug in VC++ version 6.0
1660 #pragma optimize( "g", off )
1661 #endif
1662 static char_u *
1663 do_one_cmd(cmdlinep, sourcing,
1664 #ifdef FEAT_EVAL
1665 cstack,
1666 #endif
1667 fgetline, cookie)
1668 char_u **cmdlinep;
1669 int sourcing;
1670 #ifdef FEAT_EVAL
1671 struct condstack *cstack;
1672 #endif
1673 char_u *(*fgetline) __ARGS((int, void *, int));
1674 void *cookie; /* argument for fgetline() */
1676 char_u *p;
1677 linenr_T lnum;
1678 long n;
1679 char_u *errormsg = NULL; /* error message */
1680 exarg_T ea; /* Ex command arguments */
1681 long verbose_save = -1;
1682 int save_msg_scroll = 0;
1683 int did_silent = 0;
1684 int did_esilent = 0;
1685 #ifdef HAVE_SANDBOX
1686 int did_sandbox = FALSE;
1687 #endif
1688 cmdmod_T save_cmdmod;
1689 int ni; /* set when Not Implemented */
1691 vim_memset(&ea, 0, sizeof(ea));
1692 ea.line1 = 1;
1693 ea.line2 = 1;
1694 #ifdef FEAT_EVAL
1695 ++ex_nesting_level;
1696 #endif
1698 /* when not editing the last file :q has to be typed twice */
1699 if (quitmore
1700 #ifdef FEAT_EVAL
1701 /* avoid that a function call in 'statusline' does this */
1702 && !getline_equal(fgetline, cookie, get_func_line)
1703 #endif
1705 --quitmore;
1708 * Reset browse, confirm, etc.. They are restored when returning, for
1709 * recursive calls.
1711 save_cmdmod = cmdmod;
1712 vim_memset(&cmdmod, 0, sizeof(cmdmod));
1714 /* "#!anything" is handled like a comment. */
1715 if ((*cmdlinep)[0] == '#' && (*cmdlinep)[1] == '!')
1716 goto doend;
1719 * Repeat until no more command modifiers are found.
1721 ea.cmd = *cmdlinep;
1722 for (;;)
1725 * 1. skip comment lines and leading white space and colons
1727 while (*ea.cmd == ' ' || *ea.cmd == '\t' || *ea.cmd == ':')
1728 ++ea.cmd;
1730 /* in ex mode, an empty line works like :+ */
1731 if (*ea.cmd == NUL && exmode_active
1732 && (getline_equal(fgetline, cookie, getexmodeline)
1733 || getline_equal(fgetline, cookie, getexline))
1734 && curwin->w_cursor.lnum < curbuf->b_ml.ml_line_count)
1736 ea.cmd = (char_u *)"+";
1737 ex_pressedreturn = TRUE;
1740 /* ignore comment and empty lines */
1741 if (*ea.cmd == '"')
1742 goto doend;
1743 if (*ea.cmd == NUL)
1745 ex_pressedreturn = TRUE;
1746 goto doend;
1750 * 2. handle command modifiers.
1752 p = ea.cmd;
1753 if (VIM_ISDIGIT(*ea.cmd))
1754 p = skipwhite(skipdigits(ea.cmd));
1755 switch (*p)
1757 /* When adding an entry, also modify cmd_exists(). */
1758 case 'a': if (!checkforcmd(&ea.cmd, "aboveleft", 3))
1759 break;
1760 #ifdef FEAT_WINDOWS
1761 cmdmod.split |= WSP_ABOVE;
1762 #endif
1763 continue;
1765 case 'b': if (checkforcmd(&ea.cmd, "belowright", 3))
1767 #ifdef FEAT_WINDOWS
1768 cmdmod.split |= WSP_BELOW;
1769 #endif
1770 continue;
1772 if (checkforcmd(&ea.cmd, "browse", 3))
1774 #ifdef FEAT_BROWSE_CMD
1775 cmdmod.browse = TRUE;
1776 #endif
1777 continue;
1779 if (!checkforcmd(&ea.cmd, "botright", 2))
1780 break;
1781 #ifdef FEAT_WINDOWS
1782 cmdmod.split |= WSP_BOT;
1783 #endif
1784 continue;
1786 case 'c': if (!checkforcmd(&ea.cmd, "confirm", 4))
1787 break;
1788 #if defined(FEAT_GUI_DIALOG) || defined(FEAT_CON_DIALOG)
1789 cmdmod.confirm = TRUE;
1790 #endif
1791 continue;
1793 case 'k': if (checkforcmd(&ea.cmd, "keepmarks", 3))
1795 cmdmod.keepmarks = TRUE;
1796 continue;
1798 if (checkforcmd(&ea.cmd, "keepalt", 5))
1800 cmdmod.keepalt = TRUE;
1801 continue;
1803 if (!checkforcmd(&ea.cmd, "keepjumps", 5))
1804 break;
1805 cmdmod.keepjumps = TRUE;
1806 continue;
1808 /* ":hide" and ":hide | cmd" are not modifiers */
1809 case 'h': if (p != ea.cmd || !checkforcmd(&p, "hide", 3)
1810 || *p == NUL || ends_excmd(*p))
1811 break;
1812 ea.cmd = p;
1813 cmdmod.hide = TRUE;
1814 continue;
1816 case 'l': if (checkforcmd(&ea.cmd, "lockmarks", 3))
1818 cmdmod.lockmarks = TRUE;
1819 continue;
1822 if (!checkforcmd(&ea.cmd, "leftabove", 5))
1823 break;
1824 #ifdef FEAT_WINDOWS
1825 cmdmod.split |= WSP_ABOVE;
1826 #endif
1827 continue;
1829 case 'n': if (!checkforcmd(&ea.cmd, "noautocmd", 3))
1830 break;
1831 #ifdef FEAT_AUTOCMD
1832 if (cmdmod.save_ei == NULL)
1834 /* Set 'eventignore' to "all". Restore the
1835 * existing option value later. */
1836 cmdmod.save_ei = vim_strsave(p_ei);
1837 set_string_option_direct((char_u *)"ei", -1,
1838 (char_u *)"all", OPT_FREE, SID_NONE);
1840 #endif
1841 continue;
1843 case 'r': if (!checkforcmd(&ea.cmd, "rightbelow", 6))
1844 break;
1845 #ifdef FEAT_WINDOWS
1846 cmdmod.split |= WSP_BELOW;
1847 #endif
1848 continue;
1850 case 's': if (checkforcmd(&ea.cmd, "sandbox", 3))
1852 #ifdef HAVE_SANDBOX
1853 if (!did_sandbox)
1854 ++sandbox;
1855 did_sandbox = TRUE;
1856 #endif
1857 continue;
1859 if (!checkforcmd(&ea.cmd, "silent", 3))
1860 break;
1861 ++did_silent;
1862 ++msg_silent;
1863 save_msg_scroll = msg_scroll;
1864 if (*ea.cmd == '!' && !vim_iswhite(ea.cmd[-1]))
1866 /* ":silent!", but not "silent !cmd" */
1867 ea.cmd = skipwhite(ea.cmd + 1);
1868 ++emsg_silent;
1869 ++did_esilent;
1871 continue;
1873 case 't': if (checkforcmd(&p, "tab", 3))
1875 #ifdef FEAT_WINDOWS
1876 if (vim_isdigit(*ea.cmd))
1877 cmdmod.tab = atoi((char *)ea.cmd) + 1;
1878 else
1879 cmdmod.tab = tabpage_index(curtab) + 1;
1880 ea.cmd = p;
1881 #endif
1882 continue;
1884 if (!checkforcmd(&ea.cmd, "topleft", 2))
1885 break;
1886 #ifdef FEAT_WINDOWS
1887 cmdmod.split |= WSP_TOP;
1888 #endif
1889 continue;
1891 case 'v': if (checkforcmd(&ea.cmd, "vertical", 4))
1893 #ifdef FEAT_VERTSPLIT
1894 cmdmod.split |= WSP_VERT;
1895 #endif
1896 continue;
1898 if (!checkforcmd(&p, "verbose", 4))
1899 break;
1900 if (verbose_save < 0)
1901 verbose_save = p_verbose;
1902 if (vim_isdigit(*ea.cmd))
1903 p_verbose = atoi((char *)ea.cmd);
1904 else
1905 p_verbose = 1;
1906 ea.cmd = p;
1907 continue;
1909 break;
1912 #ifdef FEAT_EVAL
1913 ea.skip = did_emsg || got_int || did_throw || (cstack->cs_idx >= 0
1914 && !(cstack->cs_flags[cstack->cs_idx] & CSF_ACTIVE));
1915 #else
1916 ea.skip = (if_level > 0);
1917 #endif
1919 #ifdef FEAT_EVAL
1920 # ifdef FEAT_PROFILE
1921 /* Count this line for profiling if ea.skip is FALSE. */
1922 if (do_profiling == PROF_YES && !ea.skip)
1924 if (getline_equal(fgetline, cookie, get_func_line))
1925 func_line_exec(getline_cookie(fgetline, cookie));
1926 else if (getline_equal(fgetline, cookie, getsourceline))
1927 script_line_exec();
1929 #endif
1931 /* May go to debug mode. If this happens and the ">quit" debug command is
1932 * used, throw an interrupt exception and skip the next command. */
1933 dbg_check_breakpoint(&ea);
1934 if (!ea.skip && got_int)
1936 ea.skip = TRUE;
1937 (void)do_intthrow(cstack);
1939 #endif
1942 * 3. parse a range specifier of the form: addr [,addr] [;addr] ..
1944 * where 'addr' is:
1946 * % (entire file)
1947 * $ [+-NUM]
1948 * 'x [+-NUM] (where x denotes a currently defined mark)
1949 * . [+-NUM]
1950 * [+-NUM]..
1951 * NUM
1953 * The ea.cmd pointer is updated to point to the first character following the
1954 * range spec. If an initial address is found, but no second, the upper bound
1955 * is equal to the lower.
1958 /* repeat for all ',' or ';' separated addresses */
1959 for (;;)
1961 ea.line1 = ea.line2;
1962 ea.line2 = curwin->w_cursor.lnum; /* default is current line number */
1963 ea.cmd = skipwhite(ea.cmd);
1964 lnum = get_address(&ea.cmd, ea.skip, ea.addr_count == 0);
1965 if (ea.cmd == NULL) /* error detected */
1966 goto doend;
1967 if (lnum == MAXLNUM)
1969 if (*ea.cmd == '%') /* '%' - all lines */
1971 ++ea.cmd;
1972 ea.line1 = 1;
1973 ea.line2 = curbuf->b_ml.ml_line_count;
1974 ++ea.addr_count;
1976 /* '*' - visual area */
1977 else if (*ea.cmd == '*' && vim_strchr(p_cpo, CPO_STAR) == NULL)
1979 pos_T *fp;
1981 ++ea.cmd;
1982 if (!ea.skip)
1984 fp = getmark('<', FALSE);
1985 if (check_mark(fp) == FAIL)
1986 goto doend;
1987 ea.line1 = fp->lnum;
1988 fp = getmark('>', FALSE);
1989 if (check_mark(fp) == FAIL)
1990 goto doend;
1991 ea.line2 = fp->lnum;
1992 ++ea.addr_count;
1996 else
1997 ea.line2 = lnum;
1998 ea.addr_count++;
2000 if (*ea.cmd == ';')
2002 if (!ea.skip)
2003 curwin->w_cursor.lnum = ea.line2;
2005 else if (*ea.cmd != ',')
2006 break;
2007 ++ea.cmd;
2010 /* One address given: set start and end lines */
2011 if (ea.addr_count == 1)
2013 ea.line1 = ea.line2;
2014 /* ... but only implicit: really no address given */
2015 if (lnum == MAXLNUM)
2016 ea.addr_count = 0;
2019 /* Don't leave the cursor on an illegal line (caused by ';') */
2020 check_cursor_lnum();
2023 * 4. parse command
2027 * Skip ':' and any white space
2029 ea.cmd = skipwhite(ea.cmd);
2030 while (*ea.cmd == ':')
2031 ea.cmd = skipwhite(ea.cmd + 1);
2034 * If we got a line, but no command, then go to the line.
2035 * If we find a '|' or '\n' we set ea.nextcmd.
2037 if (*ea.cmd == NUL || *ea.cmd == '"' ||
2038 (ea.nextcmd = check_nextcmd(ea.cmd)) != NULL)
2041 * strange vi behaviour:
2042 * ":3" jumps to line 3
2043 * ":3|..." prints line 3
2044 * ":|" prints current line
2046 if (ea.skip) /* skip this if inside :if */
2047 goto doend;
2048 if (*ea.cmd == '|' || (exmode_active && ea.line1 != ea.line2))
2050 ea.cmdidx = CMD_print;
2051 ea.argt = RANGE+COUNT+TRLBAR;
2052 if ((errormsg = invalid_range(&ea)) == NULL)
2054 correct_range(&ea);
2055 ex_print(&ea);
2058 else if (ea.addr_count != 0)
2060 if (ea.line2 > curbuf->b_ml.ml_line_count)
2062 /* With '-' in 'cpoptions' a line number past the file is an
2063 * error, otherwise put it at the end of the file. */
2064 if (vim_strchr(p_cpo, CPO_MINUS) != NULL)
2065 ea.line2 = -1;
2066 else
2067 ea.line2 = curbuf->b_ml.ml_line_count;
2070 if (ea.line2 < 0)
2071 errormsg = (char_u *)_(e_invrange);
2072 else
2074 if (ea.line2 == 0)
2075 curwin->w_cursor.lnum = 1;
2076 else
2077 curwin->w_cursor.lnum = ea.line2;
2078 beginline(BL_SOL | BL_FIX);
2081 goto doend;
2084 /* Find the command and let "p" point to after it. */
2085 p = find_command(&ea, NULL);
2087 #ifdef FEAT_USR_CMDS
2088 if (p == NULL)
2090 if (!ea.skip)
2091 errormsg = (char_u *)_("E464: Ambiguous use of user-defined command");
2092 goto doend;
2094 /* Check for wrong commands. */
2095 if (*p == '!' && ea.cmd[1] == 0151 && ea.cmd[0] == 78)
2097 errormsg = uc_fun_cmd();
2098 goto doend;
2100 #endif
2101 if (ea.cmdidx == CMD_SIZE)
2103 if (!ea.skip)
2105 STRCPY(IObuff, _("E492: Not an editor command"));
2106 if (!sourcing)
2108 STRCAT(IObuff, ": ");
2109 STRNCAT(IObuff, *cmdlinep, 40);
2111 errormsg = IObuff;
2113 goto doend;
2116 ni = (
2117 #ifdef FEAT_USR_CMDS
2118 !USER_CMDIDX(ea.cmdidx) &&
2119 #endif
2120 (cmdnames[ea.cmdidx].cmd_func == ex_ni
2121 #ifdef HAVE_EX_SCRIPT_NI
2122 || cmdnames[ea.cmdidx].cmd_func == ex_script_ni
2123 #endif
2126 #ifndef FEAT_EVAL
2128 * When the expression evaluation is disabled, recognize the ":if" and
2129 * ":endif" commands and ignore everything in between it.
2131 if (ea.cmdidx == CMD_if)
2132 ++if_level;
2133 if (if_level)
2135 if (ea.cmdidx == CMD_endif)
2136 --if_level;
2137 goto doend;
2140 #endif
2142 /* forced commands */
2143 if (*p == '!' && ea.cmdidx != CMD_substitute
2144 && ea.cmdidx != CMD_smagic && ea.cmdidx != CMD_snomagic)
2146 ++p;
2147 ea.forceit = TRUE;
2149 else
2150 ea.forceit = FALSE;
2153 * 5. parse arguments
2155 #ifdef FEAT_USR_CMDS
2156 if (!USER_CMDIDX(ea.cmdidx))
2157 #endif
2158 ea.argt = (long)cmdnames[(int)ea.cmdidx].cmd_argt;
2160 if (!ea.skip)
2162 #ifdef HAVE_SANDBOX
2163 if (sandbox != 0 && !(ea.argt & SBOXOK))
2165 /* Command not allowed in sandbox. */
2166 errormsg = (char_u *)_(e_sandbox);
2167 goto doend;
2169 #endif
2170 if (!curbuf->b_p_ma && (ea.argt & MODIFY))
2172 /* Command not allowed in non-'modifiable' buffer */
2173 errormsg = (char_u *)_(e_modifiable);
2174 goto doend;
2177 if (text_locked() && !(ea.argt & CMDWIN)
2178 # ifdef FEAT_USR_CMDS
2179 && !USER_CMDIDX(ea.cmdidx)
2180 # endif
2183 /* Command not allowed when editing the command line. */
2184 #ifdef FEAT_CMDWIN
2185 if (cmdwin_type != 0)
2186 errormsg = (char_u *)_(e_cmdwin);
2187 else
2188 #endif
2189 errormsg = (char_u *)_(e_secure);
2190 goto doend;
2192 #ifdef FEAT_AUTOCMD
2193 /* Disallow editing another buffer when "curbuf_lock" is set.
2194 * Do allow ":edit" (check for argument later).
2195 * Do allow ":checktime" (it's postponed). */
2196 if (!(ea.argt & CMDWIN)
2197 && ea.cmdidx != CMD_edit
2198 && ea.cmdidx != CMD_checktime
2199 # ifdef FEAT_USR_CMDS
2200 && !USER_CMDIDX(ea.cmdidx)
2201 # endif
2202 && curbuf_locked())
2203 goto doend;
2204 #endif
2206 if (!ni && !(ea.argt & RANGE) && ea.addr_count > 0)
2208 /* no range allowed */
2209 errormsg = (char_u *)_(e_norange);
2210 goto doend;
2214 if (!ni && !(ea.argt & BANG) && ea.forceit) /* no <!> allowed */
2216 errormsg = (char_u *)_(e_nobang);
2217 goto doend;
2221 * Don't complain about the range if it is not used
2222 * (could happen if line_count is accidentally set to 0).
2224 if (!ea.skip && !ni)
2227 * If the range is backwards, ask for confirmation and, if given, swap
2228 * ea.line1 & ea.line2 so it's forwards again.
2229 * When global command is busy, don't ask, will fail below.
2231 if (!global_busy && ea.line1 > ea.line2)
2233 if (msg_silent == 0)
2235 if (sourcing || exmode_active)
2237 errormsg = (char_u *)_("E493: Backwards range given");
2238 goto doend;
2240 if (ask_yesno((char_u *)
2241 _("Backwards range given, OK to swap"), FALSE) != 'y')
2242 goto doend;
2244 lnum = ea.line1;
2245 ea.line1 = ea.line2;
2246 ea.line2 = lnum;
2248 if ((errormsg = invalid_range(&ea)) != NULL)
2249 goto doend;
2252 if ((ea.argt & NOTADR) && ea.addr_count == 0) /* default is 1, not cursor */
2253 ea.line2 = 1;
2255 correct_range(&ea);
2257 #ifdef FEAT_FOLDING
2258 if (((ea.argt & WHOLEFOLD) || ea.addr_count >= 2) && !global_busy)
2260 /* Put the first line at the start of a closed fold, put the last line
2261 * at the end of a closed fold. */
2262 (void)hasFolding(ea.line1, &ea.line1, NULL);
2263 (void)hasFolding(ea.line2, NULL, &ea.line2);
2265 #endif
2267 #ifdef FEAT_QUICKFIX
2269 * For the ":make" and ":grep" commands we insert the 'makeprg'/'grepprg'
2270 * option here, so things like % get expanded.
2272 p = replace_makeprg(&ea, p, cmdlinep);
2273 if (p == NULL)
2274 goto doend;
2275 #endif
2278 * Skip to start of argument.
2279 * Don't do this for the ":!" command, because ":!! -l" needs the space.
2281 if (ea.cmdidx == CMD_bang)
2282 ea.arg = p;
2283 else
2284 ea.arg = skipwhite(p);
2287 * Check for "++opt=val" argument.
2288 * Must be first, allow ":w ++enc=utf8 !cmd"
2290 if (ea.argt & ARGOPT)
2291 while (ea.arg[0] == '+' && ea.arg[1] == '+')
2292 if (getargopt(&ea) == FAIL && !ni)
2294 errormsg = (char_u *)_(e_invarg);
2295 goto doend;
2298 if (ea.cmdidx == CMD_write || ea.cmdidx == CMD_update)
2300 if (*ea.arg == '>') /* append */
2302 if (*++ea.arg != '>') /* typed wrong */
2304 errormsg = (char_u *)_("E494: Use w or w>>");
2305 goto doend;
2307 ea.arg = skipwhite(ea.arg + 1);
2308 ea.append = TRUE;
2310 else if (*ea.arg == '!' && ea.cmdidx == CMD_write) /* :w !filter */
2312 ++ea.arg;
2313 ea.usefilter = TRUE;
2317 if (ea.cmdidx == CMD_read)
2319 if (ea.forceit)
2321 ea.usefilter = TRUE; /* :r! filter if ea.forceit */
2322 ea.forceit = FALSE;
2324 else if (*ea.arg == '!') /* :r !filter */
2326 ++ea.arg;
2327 ea.usefilter = TRUE;
2331 if (ea.cmdidx == CMD_lshift || ea.cmdidx == CMD_rshift)
2333 ea.amount = 1;
2334 while (*ea.arg == *ea.cmd) /* count number of '>' or '<' */
2336 ++ea.arg;
2337 ++ea.amount;
2339 ea.arg = skipwhite(ea.arg);
2343 * Check for "+command" argument, before checking for next command.
2344 * Don't do this for ":read !cmd" and ":write !cmd".
2346 if ((ea.argt & EDITCMD) && !ea.usefilter)
2347 ea.do_ecmd_cmd = getargcmd(&ea.arg);
2350 * Check for '|' to separate commands and '"' to start comments.
2351 * Don't do this for ":read !cmd" and ":write !cmd".
2353 if ((ea.argt & TRLBAR) && !ea.usefilter)
2354 separate_nextcmd(&ea);
2357 * Check for <newline> to end a shell command.
2358 * Also do this for ":read !cmd", ":write !cmd" and ":global".
2359 * Any others?
2361 else if (ea.cmdidx == CMD_bang
2362 || ea.cmdidx == CMD_global
2363 || ea.cmdidx == CMD_vglobal
2364 || ea.usefilter)
2366 for (p = ea.arg; *p; ++p)
2368 /* Remove one backslash before a newline, so that it's possible to
2369 * pass a newline to the shell and also a newline that is preceded
2370 * with a backslash. This makes it impossible to end a shell
2371 * command in a backslash, but that doesn't appear useful.
2372 * Halving the number of backslashes is incompatible with previous
2373 * versions. */
2374 if (*p == '\\' && p[1] == '\n')
2375 STRMOVE(p, p + 1);
2376 else if (*p == '\n')
2378 ea.nextcmd = p + 1;
2379 *p = NUL;
2380 break;
2385 if ((ea.argt & DFLALL) && ea.addr_count == 0)
2387 ea.line1 = 1;
2388 ea.line2 = curbuf->b_ml.ml_line_count;
2391 /* accept numbered register only when no count allowed (:put) */
2392 if ( (ea.argt & REGSTR)
2393 && *ea.arg != NUL
2394 #ifdef FEAT_USR_CMDS
2395 && valid_yank_reg(*ea.arg, (ea.cmdidx != CMD_put
2396 && USER_CMDIDX(ea.cmdidx)))
2397 /* Do not allow register = for user commands */
2398 && (!USER_CMDIDX(ea.cmdidx) || *ea.arg != '=')
2399 #else
2400 && valid_yank_reg(*ea.arg, ea.cmdidx != CMD_put)
2401 #endif
2402 && !((ea.argt & COUNT) && VIM_ISDIGIT(*ea.arg)))
2404 ea.regname = *ea.arg++;
2405 #ifdef FEAT_EVAL
2406 /* for '=' register: accept the rest of the line as an expression */
2407 if (ea.arg[-1] == '=' && ea.arg[0] != NUL)
2409 set_expr_line(vim_strsave(ea.arg));
2410 ea.arg += STRLEN(ea.arg);
2412 #endif
2413 ea.arg = skipwhite(ea.arg);
2417 * Check for a count. When accepting a BUFNAME, don't use "123foo" as a
2418 * count, it's a buffer name.
2420 if ((ea.argt & COUNT) && VIM_ISDIGIT(*ea.arg)
2421 && (!(ea.argt & BUFNAME) || *(p = skipdigits(ea.arg)) == NUL
2422 || vim_iswhite(*p)))
2424 n = getdigits(&ea.arg);
2425 ea.arg = skipwhite(ea.arg);
2426 if (n <= 0 && !ni && (ea.argt & ZEROR) == 0)
2428 errormsg = (char_u *)_(e_zerocount);
2429 goto doend;
2431 if (ea.argt & NOTADR) /* e.g. :buffer 2, :sleep 3 */
2433 ea.line2 = n;
2434 if (ea.addr_count == 0)
2435 ea.addr_count = 1;
2437 else
2439 ea.line1 = ea.line2;
2440 ea.line2 += n - 1;
2441 ++ea.addr_count;
2443 * Be vi compatible: no error message for out of range.
2445 if (ea.line2 > curbuf->b_ml.ml_line_count)
2446 ea.line2 = curbuf->b_ml.ml_line_count;
2451 * Check for flags: 'l', 'p' and '#'.
2453 if (ea.argt & EXFLAGS)
2454 get_flags(&ea);
2455 /* no arguments allowed */
2456 if (!ni && !(ea.argt & EXTRA) && *ea.arg != NUL
2457 && *ea.arg != '"' && (*ea.arg != '|' || (ea.argt & TRLBAR) == 0))
2459 errormsg = (char_u *)_(e_trailing);
2460 goto doend;
2463 if (!ni && (ea.argt & NEEDARG) && *ea.arg == NUL)
2465 errormsg = (char_u *)_(e_argreq);
2466 goto doend;
2469 #ifdef FEAT_EVAL
2471 * Skip the command when it's not going to be executed.
2472 * The commands like :if, :endif, etc. always need to be executed.
2473 * Also make an exception for commands that handle a trailing command
2474 * themselves.
2476 if (ea.skip)
2478 switch (ea.cmdidx)
2480 /* commands that need evaluation */
2481 case CMD_while:
2482 case CMD_endwhile:
2483 case CMD_for:
2484 case CMD_endfor:
2485 case CMD_if:
2486 case CMD_elseif:
2487 case CMD_else:
2488 case CMD_endif:
2489 case CMD_try:
2490 case CMD_catch:
2491 case CMD_finally:
2492 case CMD_endtry:
2493 case CMD_function:
2494 break;
2496 /* Commands that handle '|' themselves. Check: A command should
2497 * either have the TRLBAR flag, appear in this list or appear in
2498 * the list at ":help :bar". */
2499 case CMD_aboveleft:
2500 case CMD_and:
2501 case CMD_belowright:
2502 case CMD_botright:
2503 case CMD_browse:
2504 case CMD_call:
2505 case CMD_confirm:
2506 case CMD_delfunction:
2507 case CMD_djump:
2508 case CMD_dlist:
2509 case CMD_dsearch:
2510 case CMD_dsplit:
2511 case CMD_echo:
2512 case CMD_echoerr:
2513 case CMD_echomsg:
2514 case CMD_echon:
2515 case CMD_execute:
2516 case CMD_help:
2517 case CMD_hide:
2518 case CMD_ijump:
2519 case CMD_ilist:
2520 case CMD_isearch:
2521 case CMD_isplit:
2522 case CMD_keepalt:
2523 case CMD_keepjumps:
2524 case CMD_keepmarks:
2525 case CMD_leftabove:
2526 case CMD_let:
2527 case CMD_lockmarks:
2528 case CMD_match:
2529 case CMD_mzscheme:
2530 case CMD_perl:
2531 case CMD_psearch:
2532 case CMD_python:
2533 case CMD_return:
2534 case CMD_rightbelow:
2535 case CMD_ruby:
2536 case CMD_silent:
2537 case CMD_smagic:
2538 case CMD_snomagic:
2539 case CMD_substitute:
2540 case CMD_syntax:
2541 case CMD_tab:
2542 case CMD_tcl:
2543 case CMD_throw:
2544 case CMD_tilde:
2545 case CMD_topleft:
2546 case CMD_unlet:
2547 case CMD_verbose:
2548 case CMD_vertical:
2549 break;
2551 default: goto doend;
2554 #endif
2556 if (ea.argt & XFILE)
2558 if (expand_filename(&ea, cmdlinep, &errormsg) == FAIL)
2559 goto doend;
2562 #ifdef FEAT_LISTCMDS
2564 * Accept buffer name. Cannot be used at the same time with a buffer
2565 * number. Don't do this for a user command.
2567 if ((ea.argt & BUFNAME) && *ea.arg != NUL && ea.addr_count == 0
2568 # ifdef FEAT_USR_CMDS
2569 && !USER_CMDIDX(ea.cmdidx)
2570 # endif
2574 * :bdelete, :bwipeout and :bunload take several arguments, separated
2575 * by spaces: find next space (skipping over escaped characters).
2576 * The others take one argument: ignore trailing spaces.
2578 if (ea.cmdidx == CMD_bdelete || ea.cmdidx == CMD_bwipeout
2579 || ea.cmdidx == CMD_bunload)
2580 p = skiptowhite_esc(ea.arg);
2581 else
2583 p = ea.arg + STRLEN(ea.arg);
2584 while (p > ea.arg && vim_iswhite(p[-1]))
2585 --p;
2587 ea.line2 = buflist_findpat(ea.arg, p, (ea.argt & BUFUNL) != 0, FALSE);
2588 if (ea.line2 < 0) /* failed */
2589 goto doend;
2590 ea.addr_count = 1;
2591 ea.arg = skipwhite(p);
2593 #endif
2596 * 6. switch on command name
2598 * The "ea" structure holds the arguments that can be used.
2600 ea.cmdlinep = cmdlinep;
2601 ea.getline = fgetline;
2602 ea.cookie = cookie;
2603 #ifdef FEAT_EVAL
2604 ea.cstack = cstack;
2605 #endif
2607 #ifdef FEAT_USR_CMDS
2608 if (USER_CMDIDX(ea.cmdidx))
2611 * Execute a user-defined command.
2613 do_ucmd(&ea);
2615 else
2616 #endif
2619 * Call the function to execute the command.
2621 ea.errmsg = NULL;
2622 (cmdnames[ea.cmdidx].cmd_func)(&ea);
2623 if (ea.errmsg != NULL)
2624 errormsg = (char_u *)_(ea.errmsg);
2627 #ifdef FEAT_EVAL
2629 * If the command just executed called do_cmdline(), any throw or ":return"
2630 * or ":finish" encountered there must also check the cstack of the still
2631 * active do_cmdline() that called this do_one_cmd(). Rethrow an uncaught
2632 * exception, or reanimate a returned function or finished script file and
2633 * return or finish it again.
2635 if (need_rethrow)
2636 do_throw(cstack);
2637 else if (check_cstack)
2639 if (source_finished(fgetline, cookie))
2640 do_finish(&ea, TRUE);
2641 else if (getline_equal(fgetline, cookie, get_func_line)
2642 && current_func_returned())
2643 do_return(&ea, TRUE, FALSE, NULL);
2645 need_rethrow = check_cstack = FALSE;
2646 #endif
2648 doend:
2649 if (curwin->w_cursor.lnum == 0) /* can happen with zero line number */
2650 curwin->w_cursor.lnum = 1;
2652 if (errormsg != NULL && *errormsg != NUL && !did_emsg)
2654 if (sourcing)
2656 if (errormsg != IObuff)
2658 STRCPY(IObuff, errormsg);
2659 errormsg = IObuff;
2661 STRCAT(errormsg, ": ");
2662 STRNCAT(errormsg, *cmdlinep, IOSIZE - STRLEN(IObuff) - 1);
2664 emsg(errormsg);
2666 #ifdef FEAT_EVAL
2667 do_errthrow(cstack,
2668 (ea.cmdidx != CMD_SIZE
2669 # ifdef FEAT_USR_CMDS
2670 && !USER_CMDIDX(ea.cmdidx)
2671 # endif
2672 ) ? cmdnames[(int)ea.cmdidx].cmd_name : (char_u *)NULL);
2673 #endif
2675 if (verbose_save >= 0)
2676 p_verbose = verbose_save;
2677 #ifdef FEAT_AUTOCMD
2678 if (cmdmod.save_ei != NULL)
2680 /* Restore 'eventignore' to the value before ":noautocmd". */
2681 set_string_option_direct((char_u *)"ei", -1, cmdmod.save_ei,
2682 OPT_FREE, SID_NONE);
2683 free_string_option(cmdmod.save_ei);
2685 #endif
2687 cmdmod = save_cmdmod;
2689 if (did_silent > 0)
2691 /* messages could be enabled for a serious error, need to check if the
2692 * counters don't become negative */
2693 msg_silent -= did_silent;
2694 if (msg_silent < 0)
2695 msg_silent = 0;
2696 emsg_silent -= did_esilent;
2697 if (emsg_silent < 0)
2698 emsg_silent = 0;
2699 /* Restore msg_scroll, it's set by file I/O commands, even when no
2700 * message is actually displayed. */
2701 msg_scroll = save_msg_scroll;
2704 #ifdef HAVE_SANDBOX
2705 if (did_sandbox)
2706 --sandbox;
2707 #endif
2709 if (ea.nextcmd && *ea.nextcmd == NUL) /* not really a next command */
2710 ea.nextcmd = NULL;
2712 #ifdef FEAT_EVAL
2713 --ex_nesting_level;
2714 #endif
2716 return ea.nextcmd;
2718 #if (_MSC_VER == 1200)
2719 #pragma optimize( "", on )
2720 #endif
2723 * Check for an Ex command with optional tail.
2724 * If there is a match advance "pp" to the argument and return TRUE.
2727 checkforcmd(pp, cmd, len)
2728 char_u **pp; /* start of command */
2729 char *cmd; /* name of command */
2730 int len; /* required length */
2732 int i;
2734 for (i = 0; cmd[i] != NUL; ++i)
2735 if (cmd[i] != (*pp)[i])
2736 break;
2737 if (i >= len && !isalpha((*pp)[i]))
2739 *pp = skipwhite(*pp + i);
2740 return TRUE;
2742 return FALSE;
2746 * Find an Ex command by its name, either built-in or user.
2747 * Start of the name can be found at eap->cmd.
2748 * Returns pointer to char after the command name.
2749 * "full" is set to TRUE if the whole command name matched.
2750 * Returns NULL for an ambiguous user command.
2752 /*ARGSUSED*/
2753 static char_u *
2754 find_command(eap, full)
2755 exarg_T *eap;
2756 int *full;
2758 int len;
2759 char_u *p;
2760 int i;
2763 * Isolate the command and search for it in the command table.
2764 * Exceptions:
2765 * - the 'k' command can directly be followed by any character.
2766 * - the 's' command can be followed directly by 'c', 'g', 'i', 'I' or 'r'
2767 * but :sre[wind] is another command, as are :scrip[tnames],
2768 * :scs[cope], :sim[alt], :sig[ns] and :sil[ent].
2769 * - the "d" command can directly be followed by 'l' or 'p' flag.
2771 p = eap->cmd;
2772 if (*p == 'k')
2774 eap->cmdidx = CMD_k;
2775 ++p;
2777 else if (p[0] == 's'
2778 && ((p[1] == 'c' && p[2] != 's' && p[2] != 'r'
2779 && p[3] != 'i' && p[4] != 'p')
2780 || p[1] == 'g'
2781 || (p[1] == 'i' && p[2] != 'm' && p[2] != 'l' && p[2] != 'g')
2782 || p[1] == 'I'
2783 || (p[1] == 'r' && p[2] != 'e')))
2785 eap->cmdidx = CMD_substitute;
2786 ++p;
2788 else
2790 while (ASCII_ISALPHA(*p))
2791 ++p;
2792 /* check for non-alpha command */
2793 if (p == eap->cmd && vim_strchr((char_u *)"@*!=><&~#", *p) != NULL)
2794 ++p;
2795 len = (int)(p - eap->cmd);
2796 if (*eap->cmd == 'd' && (p[-1] == 'l' || p[-1] == 'p'))
2798 /* Check for ":dl", ":dell", etc. to ":deletel": that's
2799 * :delete with the 'l' flag. Same for 'p'. */
2800 for (i = 0; i < len; ++i)
2801 if (eap->cmd[i] != "delete"[i])
2802 break;
2803 if (i == len - 1)
2805 --len;
2806 if (p[-1] == 'l')
2807 eap->flags |= EXFLAG_LIST;
2808 else
2809 eap->flags |= EXFLAG_PRINT;
2813 if (ASCII_ISLOWER(*eap->cmd))
2814 eap->cmdidx = cmdidxs[CharOrdLow(*eap->cmd)];
2815 else
2816 eap->cmdidx = cmdidxs[26];
2818 for ( ; (int)eap->cmdidx < (int)CMD_SIZE;
2819 eap->cmdidx = (cmdidx_T)((int)eap->cmdidx + 1))
2820 if (STRNCMP(cmdnames[(int)eap->cmdidx].cmd_name, (char *)eap->cmd,
2821 (size_t)len) == 0)
2823 #ifdef FEAT_EVAL
2824 if (full != NULL
2825 && cmdnames[(int)eap->cmdidx].cmd_name[len] == NUL)
2826 *full = TRUE;
2827 #endif
2828 break;
2831 #ifdef FEAT_USR_CMDS
2832 /* Look for a user defined command as a last resort */
2833 if (eap->cmdidx == CMD_SIZE && *eap->cmd >= 'A' && *eap->cmd <= 'Z')
2835 /* User defined commands may contain digits. */
2836 while (ASCII_ISALNUM(*p))
2837 ++p;
2838 p = find_ucmd(eap, p, full, NULL, NULL);
2840 #endif
2841 if (p == eap->cmd)
2842 eap->cmdidx = CMD_SIZE;
2845 return p;
2848 #ifdef FEAT_USR_CMDS
2850 * Search for a user command that matches "eap->cmd".
2851 * Return cmdidx in "eap->cmdidx", flags in "eap->argt", idx in "eap->useridx".
2852 * Return a pointer to just after the command.
2853 * Return NULL if there is no matching command.
2855 static char_u *
2856 find_ucmd(eap, p, full, xp, compl)
2857 exarg_T *eap;
2858 char_u *p; /* end of the command (possibly including count) */
2859 int *full; /* set to TRUE for a full match */
2860 expand_T *xp; /* used for completion, NULL otherwise */
2861 int *compl; /* completion flags or NULL */
2863 int len = (int)(p - eap->cmd);
2864 int j, k, matchlen = 0;
2865 ucmd_T *uc;
2866 int found = FALSE;
2867 int possible = FALSE;
2868 char_u *cp, *np; /* Point into typed cmd and test name */
2869 garray_T *gap;
2870 int amb_local = FALSE; /* Found ambiguous buffer-local command,
2871 only full match global is accepted. */
2874 * Look for buffer-local user commands first, then global ones.
2876 gap = &curbuf->b_ucmds;
2877 for (;;)
2879 for (j = 0; j < gap->ga_len; ++j)
2881 uc = USER_CMD_GA(gap, j);
2882 cp = eap->cmd;
2883 np = uc->uc_name;
2884 k = 0;
2885 while (k < len && *np != NUL && *cp++ == *np++)
2886 k++;
2887 if (k == len || (*np == NUL && vim_isdigit(eap->cmd[k])))
2889 /* If finding a second match, the command is ambiguous. But
2890 * not if a buffer-local command wasn't a full match and a
2891 * global command is a full match. */
2892 if (k == len && found && *np != NUL)
2894 if (gap == &ucmds)
2895 return NULL;
2896 amb_local = TRUE;
2899 if (!found || (k == len && *np == NUL))
2901 /* If we matched up to a digit, then there could
2902 * be another command including the digit that we
2903 * should use instead.
2905 if (k == len)
2906 found = TRUE;
2907 else
2908 possible = TRUE;
2910 if (gap == &ucmds)
2911 eap->cmdidx = CMD_USER;
2912 else
2913 eap->cmdidx = CMD_USER_BUF;
2914 eap->argt = (long)uc->uc_argt;
2915 eap->useridx = j;
2917 # ifdef FEAT_CMDL_COMPL
2918 if (compl != NULL)
2919 *compl = uc->uc_compl;
2920 # ifdef FEAT_EVAL
2921 if (xp != NULL)
2923 xp->xp_arg = uc->uc_compl_arg;
2924 xp->xp_scriptID = uc->uc_scriptID;
2926 # endif
2927 # endif
2928 /* Do not search for further abbreviations
2929 * if this is an exact match. */
2930 matchlen = k;
2931 if (k == len && *np == NUL)
2933 if (full != NULL)
2934 *full = TRUE;
2935 amb_local = FALSE;
2936 break;
2942 /* Stop if we found a full match or searched all. */
2943 if (j < gap->ga_len || gap == &ucmds)
2944 break;
2945 gap = &ucmds;
2948 /* Only found ambiguous matches. */
2949 if (amb_local)
2951 if (xp != NULL)
2952 xp->xp_context = EXPAND_UNSUCCESSFUL;
2953 return NULL;
2956 /* The match we found may be followed immediately by a number. Move "p"
2957 * back to point to it. */
2958 if (found || possible)
2959 return p + (matchlen - len);
2960 return p;
2962 #endif
2964 #if defined(FEAT_EVAL) || defined(PROTO)
2965 static struct cmdmod
2967 char *name;
2968 int minlen;
2969 int has_count; /* :123verbose :3tab */
2970 } cmdmods[] = {
2971 {"aboveleft", 3, FALSE},
2972 {"belowright", 3, FALSE},
2973 {"botright", 2, FALSE},
2974 {"browse", 3, FALSE},
2975 {"confirm", 4, FALSE},
2976 {"hide", 3, FALSE},
2977 {"keepalt", 5, FALSE},
2978 {"keepjumps", 5, FALSE},
2979 {"keepmarks", 3, FALSE},
2980 {"leftabove", 5, FALSE},
2981 {"lockmarks", 3, FALSE},
2982 {"noautocmd", 3, FALSE},
2983 {"rightbelow", 6, FALSE},
2984 {"sandbox", 3, FALSE},
2985 {"silent", 3, FALSE},
2986 {"tab", 3, TRUE},
2987 {"topleft", 2, FALSE},
2988 {"verbose", 4, TRUE},
2989 {"vertical", 4, FALSE},
2993 * Return length of a command modifier (including optional count).
2994 * Return zero when it's not a modifier.
2997 modifier_len(cmd)
2998 char_u *cmd;
3000 int i, j;
3001 char_u *p = cmd;
3003 if (VIM_ISDIGIT(*cmd))
3004 p = skipwhite(skipdigits(cmd));
3005 for (i = 0; i < sizeof(cmdmods) / sizeof(struct cmdmod); ++i)
3007 for (j = 0; p[j] != NUL; ++j)
3008 if (p[j] != cmdmods[i].name[j])
3009 break;
3010 if (!isalpha(p[j]) && j >= cmdmods[i].minlen
3011 && (p == cmd || cmdmods[i].has_count))
3012 return j + (int)(p - cmd);
3014 return 0;
3018 * Return > 0 if an Ex command "name" exists.
3019 * Return 2 if there is an exact match.
3020 * Return 3 if there is an ambiguous match.
3023 cmd_exists(name)
3024 char_u *name;
3026 exarg_T ea;
3027 int full = FALSE;
3028 int i;
3029 int j;
3030 char_u *p;
3032 /* Check command modifiers. */
3033 for (i = 0; i < sizeof(cmdmods) / sizeof(struct cmdmod); ++i)
3035 for (j = 0; name[j] != NUL; ++j)
3036 if (name[j] != cmdmods[i].name[j])
3037 break;
3038 if (name[j] == NUL && j >= cmdmods[i].minlen)
3039 return (cmdmods[i].name[j] == NUL ? 2 : 1);
3042 /* Check built-in commands and user defined commands.
3043 * For ":2match" and ":3match" we need to skip the number. */
3044 ea.cmd = (*name == '2' || *name == '3') ? name + 1 : name;
3045 ea.cmdidx = (cmdidx_T)0;
3046 p = find_command(&ea, &full);
3047 if (p == NULL)
3048 return 3;
3049 if (vim_isdigit(*name) && ea.cmdidx != CMD_match)
3050 return 0;
3051 if (*skipwhite(p) != NUL)
3052 return 0; /* trailing garbage */
3053 return (ea.cmdidx == CMD_SIZE ? 0 : (full ? 2 : 1));
3055 #endif
3058 * This is all pretty much copied from do_one_cmd(), with all the extra stuff
3059 * we don't need/want deleted. Maybe this could be done better if we didn't
3060 * repeat all this stuff. The only problem is that they may not stay
3061 * perfectly compatible with each other, but then the command line syntax
3062 * probably won't change that much -- webb.
3064 char_u *
3065 set_one_cmd_context(xp, buff)
3066 expand_T *xp;
3067 char_u *buff; /* buffer for command string */
3069 char_u *p;
3070 char_u *cmd, *arg;
3071 int len = 0;
3072 exarg_T ea;
3073 #if defined(FEAT_USR_CMDS) && defined(FEAT_CMDL_COMPL)
3074 int compl = EXPAND_NOTHING;
3075 #endif
3076 #ifdef FEAT_CMDL_COMPL
3077 int delim;
3078 #endif
3079 int forceit = FALSE;
3080 int usefilter = FALSE; /* filter instead of file name */
3082 ExpandInit(xp);
3083 xp->xp_pattern = buff;
3084 xp->xp_context = EXPAND_COMMANDS; /* Default until we get past command */
3085 ea.argt = 0;
3088 * 2. skip comment lines and leading space, colons or bars
3090 for (cmd = buff; vim_strchr((char_u *)" \t:|", *cmd) != NULL; cmd++)
3092 xp->xp_pattern = cmd;
3094 if (*cmd == NUL)
3095 return NULL;
3096 if (*cmd == '"') /* ignore comment lines */
3098 xp->xp_context = EXPAND_NOTHING;
3099 return NULL;
3103 * 3. parse a range specifier of the form: addr [,addr] [;addr] ..
3105 cmd = skip_range(cmd, &xp->xp_context);
3108 * 4. parse command
3110 xp->xp_pattern = cmd;
3111 if (*cmd == NUL)
3112 return NULL;
3113 if (*cmd == '"')
3115 xp->xp_context = EXPAND_NOTHING;
3116 return NULL;
3119 if (*cmd == '|' || *cmd == '\n')
3120 return cmd + 1; /* There's another command */
3123 * Isolate the command and search for it in the command table.
3124 * Exceptions:
3125 * - the 'k' command can directly be followed by any character, but
3126 * do accept "keepmarks", "keepalt" and "keepjumps".
3127 * - the 's' command can be followed directly by 'c', 'g', 'i', 'I' or 'r'
3129 if (*cmd == 'k' && cmd[1] != 'e')
3131 ea.cmdidx = CMD_k;
3132 p = cmd + 1;
3134 else
3136 p = cmd;
3137 while (ASCII_ISALPHA(*p) || *p == '*') /* Allow * wild card */
3138 ++p;
3139 /* check for non-alpha command */
3140 if (p == cmd && vim_strchr((char_u *)"@*!=><&~#", *p) != NULL)
3141 ++p;
3142 len = (int)(p - cmd);
3144 if (len == 0)
3146 xp->xp_context = EXPAND_UNSUCCESSFUL;
3147 return NULL;
3149 for (ea.cmdidx = (cmdidx_T)0; (int)ea.cmdidx < (int)CMD_SIZE;
3150 ea.cmdidx = (cmdidx_T)((int)ea.cmdidx + 1))
3151 if (STRNCMP(cmdnames[(int)ea.cmdidx].cmd_name, cmd, (size_t)len) == 0)
3152 break;
3154 #ifdef FEAT_USR_CMDS
3155 if (cmd[0] >= 'A' && cmd[0] <= 'Z')
3157 while (ASCII_ISALNUM(*p) || *p == '*') /* Allow * wild card */
3158 ++p;
3159 len = (int)(p - cmd);
3161 #endif
3165 * If the cursor is touching the command, and it ends in an alpha-numeric
3166 * character, complete the command name.
3168 if (*p == NUL && ASCII_ISALNUM(p[-1]))
3169 return NULL;
3171 if (ea.cmdidx == CMD_SIZE)
3173 if (*cmd == 's' && vim_strchr((char_u *)"cgriI", cmd[1]) != NULL)
3175 ea.cmdidx = CMD_substitute;
3176 p = cmd + 1;
3178 #ifdef FEAT_USR_CMDS
3179 else if (cmd[0] >= 'A' && cmd[0] <= 'Z')
3181 ea.cmd = cmd;
3182 p = find_ucmd(&ea, p, NULL, xp,
3183 # if defined(FEAT_CMDL_COMPL)
3184 &compl
3185 # else
3186 NULL
3187 # endif
3189 if (p == NULL)
3190 ea.cmdidx = CMD_SIZE; /* ambiguous user command */
3192 #endif
3194 if (ea.cmdidx == CMD_SIZE)
3196 /* Not still touching the command and it was an illegal one */
3197 xp->xp_context = EXPAND_UNSUCCESSFUL;
3198 return NULL;
3201 xp->xp_context = EXPAND_NOTHING; /* Default now that we're past command */
3203 if (*p == '!') /* forced commands */
3205 forceit = TRUE;
3206 ++p;
3210 * 5. parse arguments
3212 #ifdef FEAT_USR_CMDS
3213 if (!USER_CMDIDX(ea.cmdidx))
3214 #endif
3215 ea.argt = (long)cmdnames[(int)ea.cmdidx].cmd_argt;
3217 arg = skipwhite(p);
3219 if (ea.cmdidx == CMD_write || ea.cmdidx == CMD_update)
3221 if (*arg == '>') /* append */
3223 if (*++arg == '>')
3224 ++arg;
3225 arg = skipwhite(arg);
3227 else if (*arg == '!' && ea.cmdidx == CMD_write) /* :w !filter */
3229 ++arg;
3230 usefilter = TRUE;
3234 if (ea.cmdidx == CMD_read)
3236 usefilter = forceit; /* :r! filter if forced */
3237 if (*arg == '!') /* :r !filter */
3239 ++arg;
3240 usefilter = TRUE;
3244 if (ea.cmdidx == CMD_lshift || ea.cmdidx == CMD_rshift)
3246 while (*arg == *cmd) /* allow any number of '>' or '<' */
3247 ++arg;
3248 arg = skipwhite(arg);
3251 /* Does command allow "+command"? */
3252 if ((ea.argt & EDITCMD) && !usefilter && *arg == '+')
3254 /* Check if we're in the +command */
3255 p = arg + 1;
3256 arg = skip_cmd_arg(arg, FALSE);
3258 /* Still touching the command after '+'? */
3259 if (*arg == NUL)
3260 return p;
3262 /* Skip space(s) after +command to get to the real argument */
3263 arg = skipwhite(arg);
3267 * Check for '|' to separate commands and '"' to start comments.
3268 * Don't do this for ":read !cmd" and ":write !cmd".
3270 if ((ea.argt & TRLBAR) && !usefilter)
3272 p = arg;
3273 /* ":redir @" is not the start of a comment */
3274 if (ea.cmdidx == CMD_redir && p[0] == '@' && p[1] == '"')
3275 p += 2;
3276 while (*p)
3278 if (*p == Ctrl_V)
3280 if (p[1] != NUL)
3281 ++p;
3283 else if ( (*p == '"' && !(ea.argt & NOTRLCOM))
3284 || *p == '|' || *p == '\n')
3286 if (*(p - 1) != '\\')
3288 if (*p == '|' || *p == '\n')
3289 return p + 1;
3290 return NULL; /* It's a comment */
3293 mb_ptr_adv(p);
3297 /* no arguments allowed */
3298 if (!(ea.argt & EXTRA) && *arg != NUL &&
3299 vim_strchr((char_u *)"|\"", *arg) == NULL)
3300 return NULL;
3302 /* Find start of last argument (argument just before cursor): */
3303 p = buff + STRLEN(buff);
3304 while (p != arg && *p != ' ' && *p != TAB)
3305 p--;
3306 if (*p == ' ' || *p == TAB)
3307 p++;
3308 xp->xp_pattern = p;
3310 if (ea.argt & XFILE)
3312 int c;
3313 int in_quote = FALSE;
3314 char_u *bow = NULL; /* Beginning of word */
3317 * Allow spaces within back-quotes to count as part of the argument
3318 * being expanded.
3320 xp->xp_pattern = skipwhite(arg);
3321 p = xp->xp_pattern;
3322 while (*p != NUL)
3324 #ifdef FEAT_MBYTE
3325 if (has_mbyte)
3326 c = mb_ptr2char(p);
3327 else
3328 #endif
3329 c = *p;
3330 if (c == '\\' && p[1] != NUL)
3331 ++p;
3332 else if (c == '`')
3334 if (!in_quote)
3336 xp->xp_pattern = p;
3337 bow = p + 1;
3339 in_quote = !in_quote;
3341 /* An argument can contain just about everything, except
3342 * characters that end the command and white space. */
3343 else if (c == '|' || c == '\n' || c == '"' || (vim_iswhite(c)
3344 #ifdef SPACE_IN_FILENAME
3345 && (!(ea.argt & NOSPC) || usefilter)
3346 #endif
3349 len = 0; /* avoid getting stuck when space is in 'isfname' */
3350 while (*p != NUL)
3352 #ifdef FEAT_MBYTE
3353 if (has_mbyte)
3354 c = mb_ptr2char(p);
3355 else
3356 #endif
3357 c = *p;
3358 if (c == '`' || vim_isfilec_or_wc(c))
3359 break;
3360 #ifdef FEAT_MBYTE
3361 if (has_mbyte)
3362 len = (*mb_ptr2len)(p);
3363 else
3364 #endif
3365 len = 1;
3366 mb_ptr_adv(p);
3368 if (in_quote)
3369 bow = p;
3370 else
3371 xp->xp_pattern = p;
3372 p -= len;
3374 mb_ptr_adv(p);
3378 * If we are still inside the quotes, and we passed a space, just
3379 * expand from there.
3381 if (bow != NULL && in_quote)
3382 xp->xp_pattern = bow;
3383 xp->xp_context = EXPAND_FILES;
3385 #ifndef BACKSLASH_IN_FILENAME
3386 /* For a shell command more chars need to be escaped. */
3387 if (usefilter || ea.cmdidx == CMD_bang)
3389 xp->xp_shell = TRUE;
3391 /* When still after the command name expand executables. */
3392 if (xp->xp_pattern == skipwhite(arg))
3393 xp->xp_context = EXPAND_SHELLCMD;
3395 #endif
3397 /* Check for environment variable */
3398 if (*xp->xp_pattern == '$'
3399 #if defined(MSDOS) || defined(MSWIN) || defined(OS2)
3400 || *xp->xp_pattern == '%'
3401 #endif
3404 for (p = xp->xp_pattern + 1; *p != NUL; ++p)
3405 if (!vim_isIDc(*p))
3406 break;
3407 if (*p == NUL)
3409 xp->xp_context = EXPAND_ENV_VARS;
3410 ++xp->xp_pattern;
3411 #if defined(FEAT_USR_CMDS) && defined(FEAT_CMDL_COMPL)
3412 /* Avoid that the assignment uses EXPAND_FILES again. */
3413 if (compl != EXPAND_USER_DEFINED && compl != EXPAND_USER_LIST)
3414 compl = EXPAND_ENV_VARS;
3415 #endif
3421 * 6. switch on command name
3423 switch (ea.cmdidx)
3425 case CMD_cd:
3426 case CMD_chdir:
3427 case CMD_lcd:
3428 case CMD_lchdir:
3429 if (xp->xp_context == EXPAND_FILES)
3430 xp->xp_context = EXPAND_DIRECTORIES;
3431 break;
3432 case CMD_help:
3433 xp->xp_context = EXPAND_HELP;
3434 xp->xp_pattern = arg;
3435 break;
3437 /* Command modifiers: return the argument.
3438 * Also for commands with an argument that is a command. */
3439 case CMD_aboveleft:
3440 case CMD_argdo:
3441 case CMD_belowright:
3442 case CMD_botright:
3443 case CMD_browse:
3444 case CMD_bufdo:
3445 case CMD_confirm:
3446 case CMD_debug:
3447 case CMD_folddoclosed:
3448 case CMD_folddoopen:
3449 case CMD_hide:
3450 case CMD_keepalt:
3451 case CMD_keepjumps:
3452 case CMD_keepmarks:
3453 case CMD_leftabove:
3454 case CMD_lockmarks:
3455 case CMD_rightbelow:
3456 case CMD_sandbox:
3457 case CMD_silent:
3458 case CMD_tab:
3459 case CMD_topleft:
3460 case CMD_verbose:
3461 case CMD_vertical:
3462 case CMD_windo:
3463 return arg;
3465 #ifdef FEAT_CMDL_COMPL
3466 # ifdef FEAT_SEARCH_EXTRA
3467 case CMD_match:
3468 if (*arg == NUL || !ends_excmd(*arg))
3470 /* also complete "None" */
3471 set_context_in_echohl_cmd(xp, arg);
3472 arg = skipwhite(skiptowhite(arg));
3473 if (*arg != NUL)
3475 xp->xp_context = EXPAND_NOTHING;
3476 arg = skip_regexp(arg + 1, *arg, p_magic, NULL);
3479 return find_nextcmd(arg);
3480 # endif
3483 * All completion for the +cmdline_compl feature goes here.
3486 # ifdef FEAT_USR_CMDS
3487 case CMD_command:
3488 /* Check for attributes */
3489 while (*arg == '-')
3491 arg++; /* Skip "-" */
3492 p = skiptowhite(arg);
3493 if (*p == NUL)
3495 /* Cursor is still in the attribute */
3496 p = vim_strchr(arg, '=');
3497 if (p == NULL)
3499 /* No "=", so complete attribute names */
3500 xp->xp_context = EXPAND_USER_CMD_FLAGS;
3501 xp->xp_pattern = arg;
3502 return NULL;
3505 /* For the -complete and -nargs attributes, we complete
3506 * their arguments as well.
3508 if (STRNICMP(arg, "complete", p - arg) == 0)
3510 xp->xp_context = EXPAND_USER_COMPLETE;
3511 xp->xp_pattern = p + 1;
3512 return NULL;
3514 else if (STRNICMP(arg, "nargs", p - arg) == 0)
3516 xp->xp_context = EXPAND_USER_NARGS;
3517 xp->xp_pattern = p + 1;
3518 return NULL;
3520 return NULL;
3522 arg = skipwhite(p);
3525 /* After the attributes comes the new command name */
3526 p = skiptowhite(arg);
3527 if (*p == NUL)
3529 xp->xp_context = EXPAND_USER_COMMANDS;
3530 xp->xp_pattern = arg;
3531 break;
3534 /* And finally comes a normal command */
3535 return skipwhite(p);
3537 case CMD_delcommand:
3538 xp->xp_context = EXPAND_USER_COMMANDS;
3539 xp->xp_pattern = arg;
3540 break;
3541 # endif
3543 case CMD_global:
3544 case CMD_vglobal:
3545 delim = *arg; /* get the delimiter */
3546 if (delim)
3547 ++arg; /* skip delimiter if there is one */
3549 while (arg[0] != NUL && arg[0] != delim)
3551 if (arg[0] == '\\' && arg[1] != NUL)
3552 ++arg;
3553 ++arg;
3555 if (arg[0] != NUL)
3556 return arg + 1;
3557 break;
3558 case CMD_and:
3559 case CMD_substitute:
3560 delim = *arg;
3561 if (delim)
3563 /* skip "from" part */
3564 ++arg;
3565 arg = skip_regexp(arg, delim, p_magic, NULL);
3567 /* skip "to" part */
3568 while (arg[0] != NUL && arg[0] != delim)
3570 if (arg[0] == '\\' && arg[1] != NUL)
3571 ++arg;
3572 ++arg;
3574 if (arg[0] != NUL) /* skip delimiter */
3575 ++arg;
3576 while (arg[0] && vim_strchr((char_u *)"|\"#", arg[0]) == NULL)
3577 ++arg;
3578 if (arg[0] != NUL)
3579 return arg;
3580 break;
3581 case CMD_isearch:
3582 case CMD_dsearch:
3583 case CMD_ilist:
3584 case CMD_dlist:
3585 case CMD_ijump:
3586 case CMD_psearch:
3587 case CMD_djump:
3588 case CMD_isplit:
3589 case CMD_dsplit:
3590 arg = skipwhite(skipdigits(arg)); /* skip count */
3591 if (*arg == '/') /* Match regexp, not just whole words */
3593 for (++arg; *arg && *arg != '/'; arg++)
3594 if (*arg == '\\' && arg[1] != NUL)
3595 arg++;
3596 if (*arg)
3598 arg = skipwhite(arg + 1);
3600 /* Check for trailing illegal characters */
3601 if (*arg && vim_strchr((char_u *)"|\"\n", *arg) == NULL)
3602 xp->xp_context = EXPAND_NOTHING;
3603 else
3604 return arg;
3607 break;
3608 #ifdef FEAT_AUTOCMD
3609 case CMD_autocmd:
3610 return set_context_in_autocmd(xp, arg, FALSE);
3612 case CMD_doautocmd:
3613 case CMD_doautoall:
3614 return set_context_in_autocmd(xp, arg, TRUE);
3615 #endif
3616 case CMD_set:
3617 set_context_in_set_cmd(xp, arg, 0);
3618 break;
3619 case CMD_setglobal:
3620 set_context_in_set_cmd(xp, arg, OPT_GLOBAL);
3621 break;
3622 case CMD_setlocal:
3623 set_context_in_set_cmd(xp, arg, OPT_LOCAL);
3624 break;
3625 case CMD_tag:
3626 case CMD_stag:
3627 case CMD_ptag:
3628 case CMD_ltag:
3629 case CMD_tselect:
3630 case CMD_stselect:
3631 case CMD_ptselect:
3632 case CMD_tjump:
3633 case CMD_stjump:
3634 case CMD_ptjump:
3635 if (*p_wop != NUL)
3636 xp->xp_context = EXPAND_TAGS_LISTFILES;
3637 else
3638 xp->xp_context = EXPAND_TAGS;
3639 xp->xp_pattern = arg;
3640 break;
3641 case CMD_augroup:
3642 xp->xp_context = EXPAND_AUGROUP;
3643 xp->xp_pattern = arg;
3644 break;
3645 #ifdef FEAT_SYN_HL
3646 case CMD_syntax:
3647 set_context_in_syntax_cmd(xp, arg);
3648 break;
3649 #endif
3650 #ifdef FEAT_EVAL
3651 case CMD_let:
3652 case CMD_if:
3653 case CMD_elseif:
3654 case CMD_while:
3655 case CMD_for:
3656 case CMD_echo:
3657 case CMD_echon:
3658 case CMD_execute:
3659 case CMD_echomsg:
3660 case CMD_echoerr:
3661 case CMD_call:
3662 case CMD_return:
3663 set_context_for_expression(xp, arg, ea.cmdidx);
3664 break;
3666 case CMD_unlet:
3667 while ((xp->xp_pattern = vim_strchr(arg, ' ')) != NULL)
3668 arg = xp->xp_pattern + 1;
3669 xp->xp_context = EXPAND_USER_VARS;
3670 xp->xp_pattern = arg;
3671 break;
3673 case CMD_function:
3674 case CMD_delfunction:
3675 xp->xp_context = EXPAND_USER_FUNC;
3676 xp->xp_pattern = arg;
3677 break;
3679 case CMD_echohl:
3680 set_context_in_echohl_cmd(xp, arg);
3681 break;
3682 #endif
3683 case CMD_highlight:
3684 set_context_in_highlight_cmd(xp, arg);
3685 break;
3686 #ifdef FEAT_LISTCMDS
3687 case CMD_bdelete:
3688 case CMD_bwipeout:
3689 case CMD_bunload:
3690 while ((xp->xp_pattern = vim_strchr(arg, ' ')) != NULL)
3691 arg = xp->xp_pattern + 1;
3692 /*FALLTHROUGH*/
3693 case CMD_buffer:
3694 case CMD_sbuffer:
3695 case CMD_checktime:
3696 xp->xp_context = EXPAND_BUFFERS;
3697 xp->xp_pattern = arg;
3698 break;
3699 #endif
3700 #ifdef FEAT_USR_CMDS
3701 case CMD_USER:
3702 case CMD_USER_BUF:
3703 if (compl != EXPAND_NOTHING)
3705 /* XFILE: file names are handled above */
3706 if (!(ea.argt & XFILE))
3708 # ifdef FEAT_MENU
3709 if (compl == EXPAND_MENUS)
3710 return set_context_in_menu_cmd(xp, cmd, arg, forceit);
3711 # endif
3712 if (compl == EXPAND_COMMANDS)
3713 return arg;
3714 if (compl == EXPAND_MAPPINGS)
3715 return set_context_in_map_cmd(xp, (char_u *)"map",
3716 arg, forceit, FALSE, FALSE, CMD_map);
3717 while ((xp->xp_pattern = vim_strchr(arg, ' ')) != NULL)
3718 arg = xp->xp_pattern + 1;
3719 xp->xp_pattern = arg;
3721 xp->xp_context = compl;
3723 break;
3724 #endif
3725 case CMD_map: case CMD_noremap:
3726 case CMD_nmap: case CMD_nnoremap:
3727 case CMD_vmap: case CMD_vnoremap:
3728 case CMD_omap: case CMD_onoremap:
3729 case CMD_imap: case CMD_inoremap:
3730 case CMD_cmap: case CMD_cnoremap:
3731 return set_context_in_map_cmd(xp, cmd, arg, forceit,
3732 FALSE, FALSE, ea.cmdidx);
3733 case CMD_unmap:
3734 case CMD_nunmap:
3735 case CMD_vunmap:
3736 case CMD_ounmap:
3737 case CMD_iunmap:
3738 case CMD_cunmap:
3739 return set_context_in_map_cmd(xp, cmd, arg, forceit,
3740 FALSE, TRUE, ea.cmdidx);
3741 case CMD_abbreviate: case CMD_noreabbrev:
3742 case CMD_cabbrev: case CMD_cnoreabbrev:
3743 case CMD_iabbrev: case CMD_inoreabbrev:
3744 return set_context_in_map_cmd(xp, cmd, arg, forceit,
3745 TRUE, FALSE, ea.cmdidx);
3746 case CMD_unabbreviate:
3747 case CMD_cunabbrev:
3748 case CMD_iunabbrev:
3749 return set_context_in_map_cmd(xp, cmd, arg, forceit,
3750 TRUE, TRUE, ea.cmdidx);
3751 #ifdef FEAT_MENU
3752 case CMD_menu: case CMD_noremenu: case CMD_unmenu:
3753 case CMD_amenu: case CMD_anoremenu: case CMD_aunmenu:
3754 case CMD_nmenu: case CMD_nnoremenu: case CMD_nunmenu:
3755 case CMD_vmenu: case CMD_vnoremenu: case CMD_vunmenu:
3756 case CMD_omenu: case CMD_onoremenu: case CMD_ounmenu:
3757 case CMD_imenu: case CMD_inoremenu: case CMD_iunmenu:
3758 case CMD_cmenu: case CMD_cnoremenu: case CMD_cunmenu:
3759 case CMD_tmenu: case CMD_tunmenu:
3760 case CMD_popup: case CMD_tearoff: case CMD_emenu:
3761 return set_context_in_menu_cmd(xp, cmd, arg, forceit);
3762 #endif
3764 case CMD_colorscheme:
3765 xp->xp_context = EXPAND_COLORS;
3766 xp->xp_pattern = arg;
3767 break;
3769 case CMD_compiler:
3770 xp->xp_context = EXPAND_COMPILER;
3771 xp->xp_pattern = arg;
3772 break;
3774 #if (defined(HAVE_LOCALE_H) || defined(X_LOCALE)) \
3775 && (defined(FEAT_GETTEXT) || defined(FEAT_MBYTE))
3776 case CMD_language:
3777 if (*skiptowhite(arg) == NUL)
3779 xp->xp_context = EXPAND_LANGUAGE;
3780 xp->xp_pattern = arg;
3782 else
3783 xp->xp_context = EXPAND_NOTHING;
3784 break;
3785 #endif
3787 #endif /* FEAT_CMDL_COMPL */
3789 default:
3790 break;
3792 return NULL;
3796 * skip a range specifier of the form: addr [,addr] [;addr] ..
3798 * Backslashed delimiters after / or ? will be skipped, and commands will
3799 * not be expanded between /'s and ?'s or after "'".
3801 * Also skip white space and ":" characters.
3802 * Returns the "cmd" pointer advanced to beyond the range.
3804 char_u *
3805 skip_range(cmd, ctx)
3806 char_u *cmd;
3807 int *ctx; /* pointer to xp_context or NULL */
3809 int delim;
3811 while (vim_strchr((char_u *)" \t0123456789.$%'/?-+,;", *cmd) != NULL)
3813 if (*cmd == '\'')
3815 if (*++cmd == NUL && ctx != NULL)
3816 *ctx = EXPAND_NOTHING;
3818 else if (*cmd == '/' || *cmd == '?')
3820 delim = *cmd++;
3821 while (*cmd != NUL && *cmd != delim)
3822 if (*cmd++ == '\\' && *cmd != NUL)
3823 ++cmd;
3824 if (*cmd == NUL && ctx != NULL)
3825 *ctx = EXPAND_NOTHING;
3827 if (*cmd != NUL)
3828 ++cmd;
3831 /* Skip ":" and white space. */
3832 while (*cmd == ':')
3833 cmd = skipwhite(cmd + 1);
3835 return cmd;
3839 * get a single EX address
3841 * Set ptr to the next character after the part that was interpreted.
3842 * Set ptr to NULL when an error is encountered.
3844 * Return MAXLNUM when no Ex address was found.
3846 static linenr_T
3847 get_address(ptr, skip, to_other_file)
3848 char_u **ptr;
3849 int skip; /* only skip the address, don't use it */
3850 int to_other_file; /* flag: may jump to other file */
3852 int c;
3853 int i;
3854 long n;
3855 char_u *cmd;
3856 pos_T pos;
3857 pos_T *fp;
3858 linenr_T lnum;
3860 cmd = skipwhite(*ptr);
3861 lnum = MAXLNUM;
3864 switch (*cmd)
3866 case '.': /* '.' - Cursor position */
3867 ++cmd;
3868 lnum = curwin->w_cursor.lnum;
3869 break;
3871 case '$': /* '$' - last line */
3872 ++cmd;
3873 lnum = curbuf->b_ml.ml_line_count;
3874 break;
3876 case '\'': /* ''' - mark */
3877 if (*++cmd == NUL)
3879 cmd = NULL;
3880 goto error;
3882 if (skip)
3883 ++cmd;
3884 else
3886 /* Only accept a mark in another file when it is
3887 * used by itself: ":'M". */
3888 fp = getmark(*cmd, to_other_file && cmd[1] == NUL);
3889 ++cmd;
3890 if (fp == (pos_T *)-1)
3891 /* Jumped to another file. */
3892 lnum = curwin->w_cursor.lnum;
3893 else
3895 if (check_mark(fp) == FAIL)
3897 cmd = NULL;
3898 goto error;
3900 lnum = fp->lnum;
3903 break;
3905 case '/':
3906 case '?': /* '/' or '?' - search */
3907 c = *cmd++;
3908 if (skip) /* skip "/pat/" */
3910 cmd = skip_regexp(cmd, c, (int)p_magic, NULL);
3911 if (*cmd == c)
3912 ++cmd;
3914 else
3916 pos = curwin->w_cursor; /* save curwin->w_cursor */
3918 * When '/' or '?' follows another address, start
3919 * from there.
3921 if (lnum != MAXLNUM)
3922 curwin->w_cursor.lnum = lnum;
3924 * Start a forward search at the end of the line.
3925 * Start a backward search at the start of the line.
3926 * This makes sure we never match in the current
3927 * line, and can match anywhere in the
3928 * next/previous line.
3930 if (c == '/')
3931 curwin->w_cursor.col = MAXCOL;
3932 else
3933 curwin->w_cursor.col = 0;
3934 searchcmdlen = 0;
3935 if (!do_search(NULL, c, cmd, 1L,
3936 SEARCH_HIS | SEARCH_MSG, NULL))
3938 curwin->w_cursor = pos;
3939 cmd = NULL;
3940 goto error;
3942 lnum = curwin->w_cursor.lnum;
3943 curwin->w_cursor = pos;
3944 /* adjust command string pointer */
3945 cmd += searchcmdlen;
3947 break;
3949 case '\\': /* "\?", "\/" or "\&", repeat search */
3950 ++cmd;
3951 if (*cmd == '&')
3952 i = RE_SUBST;
3953 else if (*cmd == '?' || *cmd == '/')
3954 i = RE_SEARCH;
3955 else
3957 EMSG(_(e_backslash));
3958 cmd = NULL;
3959 goto error;
3962 if (!skip)
3965 * When search follows another address, start from
3966 * there.
3968 if (lnum != MAXLNUM)
3969 pos.lnum = lnum;
3970 else
3971 pos.lnum = curwin->w_cursor.lnum;
3974 * Start the search just like for the above
3975 * do_search().
3977 if (*cmd != '?')
3978 pos.col = MAXCOL;
3979 else
3980 pos.col = 0;
3981 if (searchit(curwin, curbuf, &pos,
3982 *cmd == '?' ? BACKWARD : FORWARD,
3983 (char_u *)"", 1L, SEARCH_MSG,
3984 i, (linenr_T)0, NULL) != FAIL)
3985 lnum = pos.lnum;
3986 else
3988 cmd = NULL;
3989 goto error;
3992 ++cmd;
3993 break;
3995 default:
3996 if (VIM_ISDIGIT(*cmd)) /* absolute line number */
3997 lnum = getdigits(&cmd);
4000 for (;;)
4002 cmd = skipwhite(cmd);
4003 if (*cmd != '-' && *cmd != '+' && !VIM_ISDIGIT(*cmd))
4004 break;
4006 if (lnum == MAXLNUM)
4007 lnum = curwin->w_cursor.lnum; /* "+1" is same as ".+1" */
4008 if (VIM_ISDIGIT(*cmd))
4009 i = '+'; /* "number" is same as "+number" */
4010 else
4011 i = *cmd++;
4012 if (!VIM_ISDIGIT(*cmd)) /* '+' is '+1', but '+0' is not '+1' */
4013 n = 1;
4014 else
4015 n = getdigits(&cmd);
4016 if (i == '-')
4017 lnum -= n;
4018 else
4019 lnum += n;
4021 } while (*cmd == '/' || *cmd == '?');
4023 error:
4024 *ptr = cmd;
4025 return lnum;
4029 * Get flags from an Ex command argument.
4031 static void
4032 get_flags(eap)
4033 exarg_T *eap;
4035 while (vim_strchr((char_u *)"lp#", *eap->arg) != NULL)
4037 if (*eap->arg == 'l')
4038 eap->flags |= EXFLAG_LIST;
4039 else if (*eap->arg == 'p')
4040 eap->flags |= EXFLAG_PRINT;
4041 else
4042 eap->flags |= EXFLAG_NR;
4043 eap->arg = skipwhite(eap->arg + 1);
4048 * Function called for command which is Not Implemented. NI!
4050 void
4051 ex_ni(eap)
4052 exarg_T *eap;
4054 if (!eap->skip)
4055 eap->errmsg = (char_u *)N_("E319: Sorry, the command is not available in this version");
4058 #ifdef HAVE_EX_SCRIPT_NI
4060 * Function called for script command which is Not Implemented. NI!
4061 * Skips over ":perl <<EOF" constructs.
4063 static void
4064 ex_script_ni(eap)
4065 exarg_T *eap;
4067 if (!eap->skip)
4068 ex_ni(eap);
4069 else
4070 vim_free(script_get(eap, eap->arg));
4072 #endif
4075 * Check range in Ex command for validity.
4076 * Return NULL when valid, error message when invalid.
4078 static char_u *
4079 invalid_range(eap)
4080 exarg_T *eap;
4082 if ( eap->line1 < 0
4083 || eap->line2 < 0
4084 || eap->line1 > eap->line2
4085 || ((eap->argt & RANGE)
4086 && !(eap->argt & NOTADR)
4087 && eap->line2 > curbuf->b_ml.ml_line_count
4088 #ifdef FEAT_DIFF
4089 + (eap->cmdidx == CMD_diffget)
4090 #endif
4092 return (char_u *)_(e_invrange);
4093 return NULL;
4097 * Correct the range for zero line number, if required.
4099 static void
4100 correct_range(eap)
4101 exarg_T *eap;
4103 if (!(eap->argt & ZEROR)) /* zero in range not allowed */
4105 if (eap->line1 == 0)
4106 eap->line1 = 1;
4107 if (eap->line2 == 0)
4108 eap->line2 = 1;
4112 #ifdef FEAT_QUICKFIX
4113 static char_u *skip_grep_pat __ARGS((exarg_T *eap));
4116 * For a ":vimgrep" or ":vimgrepadd" command return a pointer past the
4117 * pattern. Otherwise return eap->arg.
4119 static char_u *
4120 skip_grep_pat(eap)
4121 exarg_T *eap;
4123 char_u *p = eap->arg;
4125 if (*p != NUL && (eap->cmdidx == CMD_vimgrep || eap->cmdidx == CMD_lvimgrep
4126 || eap->cmdidx == CMD_vimgrepadd
4127 || eap->cmdidx == CMD_lvimgrepadd
4128 || grep_internal(eap->cmdidx)))
4130 p = skip_vimgrep_pat(p, NULL, NULL);
4131 if (p == NULL)
4132 p = eap->arg;
4134 return p;
4138 * For the ":make" and ":grep" commands insert the 'makeprg'/'grepprg' option
4139 * in the command line, so that things like % get expanded.
4141 static char_u *
4142 replace_makeprg(eap, p, cmdlinep)
4143 exarg_T *eap;
4144 char_u *p;
4145 char_u **cmdlinep;
4147 char_u *new_cmdline;
4148 char_u *program;
4149 char_u *pos;
4150 char_u *ptr;
4151 int len;
4152 int i;
4155 * Don't do it when ":vimgrep" is used for ":grep".
4157 if ((eap->cmdidx == CMD_make || eap->cmdidx == CMD_lmake
4158 || eap->cmdidx == CMD_grep || eap->cmdidx == CMD_lgrep
4159 || eap->cmdidx == CMD_grepadd
4160 || eap->cmdidx == CMD_lgrepadd)
4161 && !grep_internal(eap->cmdidx))
4163 if (eap->cmdidx == CMD_grep || eap->cmdidx == CMD_lgrep
4164 || eap->cmdidx == CMD_grepadd || eap->cmdidx == CMD_lgrepadd)
4166 if (*curbuf->b_p_gp == NUL)
4167 program = p_gp;
4168 else
4169 program = curbuf->b_p_gp;
4171 else
4173 if (*curbuf->b_p_mp == NUL)
4174 program = p_mp;
4175 else
4176 program = curbuf->b_p_mp;
4179 p = skipwhite(p);
4181 if ((pos = (char_u *)strstr((char *)program, "$*")) != NULL)
4183 /* replace $* by given arguments */
4184 i = 1;
4185 while ((pos = (char_u *)strstr((char *)pos + 2, "$*")) != NULL)
4186 ++i;
4187 len = (int)STRLEN(p);
4188 new_cmdline = alloc((int)(STRLEN(program) + i * (len - 2) + 1));
4189 if (new_cmdline == NULL)
4190 return NULL; /* out of memory */
4191 ptr = new_cmdline;
4192 while ((pos = (char_u *)strstr((char *)program, "$*")) != NULL)
4194 i = (int)(pos - program);
4195 STRNCPY(ptr, program, i);
4196 STRCPY(ptr += i, p);
4197 ptr += len;
4198 program = pos + 2;
4200 STRCPY(ptr, program);
4202 else
4204 new_cmdline = alloc((int)(STRLEN(program) + STRLEN(p) + 2));
4205 if (new_cmdline == NULL)
4206 return NULL; /* out of memory */
4207 STRCPY(new_cmdline, program);
4208 STRCAT(new_cmdline, " ");
4209 STRCAT(new_cmdline, p);
4211 msg_make(p);
4213 /* 'eap->cmd' is not set here, because it is not used at CMD_make */
4214 vim_free(*cmdlinep);
4215 *cmdlinep = new_cmdline;
4216 p = new_cmdline;
4218 return p;
4220 #endif
4223 * Expand file name in Ex command argument.
4224 * Return FAIL for failure, OK otherwise.
4227 expand_filename(eap, cmdlinep, errormsgp)
4228 exarg_T *eap;
4229 char_u **cmdlinep;
4230 char_u **errormsgp;
4232 int has_wildcards; /* need to expand wildcards */
4233 char_u *repl;
4234 int srclen;
4235 char_u *p;
4236 int n;
4237 int escaped;
4239 #ifdef FEAT_QUICKFIX
4240 /* Skip a regexp pattern for ":vimgrep[add] pat file..." */
4241 p = skip_grep_pat(eap);
4242 #else
4243 p = eap->arg;
4244 #endif
4247 * Decide to expand wildcards *before* replacing '%', '#', etc. If
4248 * the file name contains a wildcard it should not cause expanding.
4249 * (it will be expanded anyway if there is a wildcard before replacing).
4251 has_wildcards = mch_has_wildcard(p);
4252 while (*p != NUL)
4254 #ifdef FEAT_EVAL
4255 /* Skip over `=expr`, wildcards in it are not expanded. */
4256 if (p[0] == '`' && p[1] == '=')
4258 p += 2;
4259 (void)skip_expr(&p);
4260 if (*p == '`')
4261 ++p;
4262 continue;
4264 #endif
4266 * Quick check if this cannot be the start of a special string.
4267 * Also removes backslash before '%', '#' and '<'.
4269 if (vim_strchr((char_u *)"%#<", *p) == NULL)
4271 ++p;
4272 continue;
4276 * Try to find a match at this position.
4278 repl = eval_vars(p, eap->arg, &srclen, &(eap->do_ecmd_lnum),
4279 errormsgp, &escaped);
4280 if (*errormsgp != NULL) /* error detected */
4281 return FAIL;
4282 if (repl == NULL) /* no match found */
4284 p += srclen;
4285 continue;
4288 /* Wildcards won't be expanded below, the replacement is taken
4289 * literally. But do expand "~/file", "~user/file" and "$HOME/file". */
4290 if (vim_strchr(repl, '$') != NULL || vim_strchr(repl, '~') != NULL)
4292 char_u *l = repl;
4294 repl = expand_env_save(repl);
4295 vim_free(l);
4298 /* Need to escape white space et al. with a backslash.
4299 * Don't do this for:
4300 * - replacement that already has been escaped: "##"
4301 * - shell commands (may have to use quotes instead).
4302 * - non-unix systems when there is a single argument (spaces don't
4303 * separate arguments then).
4305 if (!eap->usefilter
4306 && !escaped
4307 && eap->cmdidx != CMD_bang
4308 && eap->cmdidx != CMD_make
4309 && eap->cmdidx != CMD_lmake
4310 && eap->cmdidx != CMD_grep
4311 && eap->cmdidx != CMD_lgrep
4312 && eap->cmdidx != CMD_grepadd
4313 && eap->cmdidx != CMD_lgrepadd
4314 #ifndef UNIX
4315 && !(eap->argt & NOSPC)
4316 #endif
4319 char_u *l;
4320 #ifdef BACKSLASH_IN_FILENAME
4321 /* Don't escape a backslash here, because rem_backslash() doesn't
4322 * remove it later. */
4323 static char_u *nobslash = (char_u *)" \t\"|";
4324 # define ESCAPE_CHARS nobslash
4325 #else
4326 # define ESCAPE_CHARS escape_chars
4327 #endif
4329 for (l = repl; *l; ++l)
4330 if (vim_strchr(ESCAPE_CHARS, *l) != NULL)
4332 l = vim_strsave_escaped(repl, ESCAPE_CHARS);
4333 if (l != NULL)
4335 vim_free(repl);
4336 repl = l;
4338 break;
4342 /* For a shell command a '!' must be escaped. */
4343 if ((eap->usefilter || eap->cmdidx == CMD_bang)
4344 && vim_strpbrk(repl, (char_u *)"!&;()<>") != NULL)
4346 char_u *l;
4348 l = vim_strsave_escaped(repl, (char_u *)"!&;()<>");
4349 if (l != NULL)
4351 vim_free(repl);
4352 repl = l;
4353 /* For a sh-like shell escape "!" another time. */
4354 if (strstr((char *)p_sh, "sh") != NULL)
4356 l = vim_strsave_escaped(repl, (char_u *)"!");
4357 if (l != NULL)
4359 vim_free(repl);
4360 repl = l;
4366 p = repl_cmdline(eap, p, srclen, repl, cmdlinep);
4367 vim_free(repl);
4368 if (p == NULL)
4369 return FAIL;
4373 * One file argument: Expand wildcards.
4374 * Don't do this with ":r !command" or ":w !command".
4376 if ((eap->argt & NOSPC) && !eap->usefilter)
4379 * May do this twice:
4380 * 1. Replace environment variables.
4381 * 2. Replace any other wildcards, remove backslashes.
4383 for (n = 1; n <= 2; ++n)
4385 if (n == 2)
4387 #ifdef UNIX
4389 * Only for Unix we check for more than one file name.
4390 * For other systems spaces are considered to be part
4391 * of the file name.
4392 * Only check here if there is no wildcard, otherwise
4393 * ExpandOne() will check for errors. This allows
4394 * ":e `ls ve*.c`" on Unix.
4396 if (!has_wildcards)
4397 for (p = eap->arg; *p; ++p)
4399 /* skip escaped characters */
4400 if (p[1] && (*p == '\\' || *p == Ctrl_V))
4401 ++p;
4402 else if (vim_iswhite(*p))
4404 *errormsgp = (char_u *)_("E172: Only one file name allowed");
4405 return FAIL;
4408 #endif
4411 * Halve the number of backslashes (this is Vi compatible).
4412 * For Unix and OS/2, when wildcards are expanded, this is
4413 * done by ExpandOne() below.
4415 #if defined(UNIX) || defined(OS2)
4416 if (!has_wildcards)
4417 #endif
4418 backslash_halve(eap->arg);
4421 if (has_wildcards)
4423 if (n == 1)
4426 * First loop: May expand environment variables. This
4427 * can be done much faster with expand_env() than with
4428 * something else (e.g., calling a shell).
4429 * After expanding environment variables, check again
4430 * if there are still wildcards present.
4432 if (vim_strchr(eap->arg, '$') != NULL
4433 || vim_strchr(eap->arg, '~') != NULL)
4435 expand_env_esc(eap->arg, NameBuff, MAXPATHL,
4436 TRUE, TRUE, NULL);
4437 has_wildcards = mch_has_wildcard(NameBuff);
4438 p = NameBuff;
4440 else
4441 p = NULL;
4443 else /* n == 2 */
4445 expand_T xpc;
4447 ExpandInit(&xpc);
4448 xpc.xp_context = EXPAND_FILES;
4449 p = ExpandOne(&xpc, eap->arg, NULL,
4450 WILD_LIST_NOTFOUND|WILD_ADD_SLASH,
4451 WILD_EXPAND_FREE);
4452 if (p == NULL)
4453 return FAIL;
4455 if (p != NULL)
4457 (void)repl_cmdline(eap, eap->arg, (int)STRLEN(eap->arg),
4458 p, cmdlinep);
4459 if (n == 2) /* p came from ExpandOne() */
4460 vim_free(p);
4465 return OK;
4469 * Replace part of the command line, keeping eap->cmd, eap->arg and
4470 * eap->nextcmd correct.
4471 * "src" points to the part that is to be replaced, of length "srclen".
4472 * "repl" is the replacement string.
4473 * Returns a pointer to the character after the replaced string.
4474 * Returns NULL for failure.
4476 static char_u *
4477 repl_cmdline(eap, src, srclen, repl, cmdlinep)
4478 exarg_T *eap;
4479 char_u *src;
4480 int srclen;
4481 char_u *repl;
4482 char_u **cmdlinep;
4484 int len;
4485 int i;
4486 char_u *new_cmdline;
4489 * The new command line is build in new_cmdline[].
4490 * First allocate it.
4491 * Careful: a "+cmd" argument may have been NUL terminated.
4493 len = (int)STRLEN(repl);
4494 i = (int)(src - *cmdlinep) + (int)STRLEN(src + srclen) + len + 3;
4495 if (eap->nextcmd != NULL)
4496 i += (int)STRLEN(eap->nextcmd);/* add space for next command */
4497 if ((new_cmdline = alloc((unsigned)i)) == NULL)
4498 return NULL; /* out of memory! */
4501 * Copy the stuff before the expanded part.
4502 * Copy the expanded stuff.
4503 * Copy what came after the expanded part.
4504 * Copy the next commands, if there are any.
4506 i = (int)(src - *cmdlinep); /* length of part before match */
4507 mch_memmove(new_cmdline, *cmdlinep, (size_t)i);
4509 mch_memmove(new_cmdline + i, repl, (size_t)len);
4510 i += len; /* remember the end of the string */
4511 STRCPY(new_cmdline + i, src + srclen);
4512 src = new_cmdline + i; /* remember where to continue */
4514 if (eap->nextcmd != NULL) /* append next command */
4516 i = (int)STRLEN(new_cmdline) + 1;
4517 STRCPY(new_cmdline + i, eap->nextcmd);
4518 eap->nextcmd = new_cmdline + i;
4520 eap->cmd = new_cmdline + (eap->cmd - *cmdlinep);
4521 eap->arg = new_cmdline + (eap->arg - *cmdlinep);
4522 if (eap->do_ecmd_cmd != NULL && eap->do_ecmd_cmd != dollar_command)
4523 eap->do_ecmd_cmd = new_cmdline + (eap->do_ecmd_cmd - *cmdlinep);
4524 vim_free(*cmdlinep);
4525 *cmdlinep = new_cmdline;
4527 return src;
4531 * Check for '|' to separate commands and '"' to start comments.
4533 void
4534 separate_nextcmd(eap)
4535 exarg_T *eap;
4537 char_u *p;
4539 #ifdef FEAT_QUICKFIX
4540 p = skip_grep_pat(eap);
4541 #else
4542 p = eap->arg;
4543 #endif
4545 for ( ; *p; mb_ptr_adv(p))
4547 if (*p == Ctrl_V)
4549 if (eap->argt & (USECTRLV | XFILE))
4550 ++p; /* skip CTRL-V and next char */
4551 else
4552 /* remove CTRL-V and skip next char */
4553 STRMOVE(p, p + 1);
4554 if (*p == NUL) /* stop at NUL after CTRL-V */
4555 break;
4558 #ifdef FEAT_EVAL
4559 /* Skip over `=expr` when wildcards are expanded. */
4560 else if (p[0] == '`' && p[1] == '=' && (eap->argt & XFILE))
4562 p += 2;
4563 (void)skip_expr(&p);
4565 #endif
4567 /* Check for '"': start of comment or '|': next command */
4568 /* :@" and :*" do not start a comment!
4569 * :redir @" doesn't either. */
4570 else if ((*p == '"' && !(eap->argt & NOTRLCOM)
4571 && ((eap->cmdidx != CMD_at && eap->cmdidx != CMD_star)
4572 || p != eap->arg)
4573 && (eap->cmdidx != CMD_redir
4574 || p != eap->arg + 1 || p[-1] != '@'))
4575 || *p == '|' || *p == '\n')
4578 * We remove the '\' before the '|', unless USECTRLV is used
4579 * AND 'b' is present in 'cpoptions'.
4581 if ((vim_strchr(p_cpo, CPO_BAR) == NULL
4582 || !(eap->argt & USECTRLV)) && *(p - 1) == '\\')
4584 STRMOVE(p - 1, p); /* remove the '\' */
4585 --p;
4587 else
4589 eap->nextcmd = check_nextcmd(p);
4590 *p = NUL;
4591 break;
4596 if (!(eap->argt & NOTRLCOM)) /* remove trailing spaces */
4597 del_trailing_spaces(eap->arg);
4601 * get + command from ex argument
4603 static char_u *
4604 getargcmd(argp)
4605 char_u **argp;
4607 char_u *arg = *argp;
4608 char_u *command = NULL;
4610 if (*arg == '+') /* +[command] */
4612 ++arg;
4613 if (vim_isspace(*arg))
4614 command = dollar_command;
4615 else
4617 command = arg;
4618 arg = skip_cmd_arg(command, TRUE);
4619 if (*arg != NUL)
4620 *arg++ = NUL; /* terminate command with NUL */
4623 arg = skipwhite(arg); /* skip over spaces */
4624 *argp = arg;
4626 return command;
4630 * Find end of "+command" argument. Skip over "\ " and "\\".
4632 static char_u *
4633 skip_cmd_arg(p, rembs)
4634 char_u *p;
4635 int rembs; /* TRUE to halve the number of backslashes */
4637 while (*p && !vim_isspace(*p))
4639 if (*p == '\\' && p[1] != NUL)
4641 if (rembs)
4642 STRMOVE(p, p + 1);
4643 else
4644 ++p;
4646 mb_ptr_adv(p);
4648 return p;
4652 * Get "++opt=arg" argument.
4653 * Return FAIL or OK.
4655 static int
4656 getargopt(eap)
4657 exarg_T *eap;
4659 char_u *arg = eap->arg + 2;
4660 int *pp = NULL;
4661 #ifdef FEAT_MBYTE
4662 char_u *p;
4663 #endif
4665 /* ":edit ++[no]bin[ary] file" */
4666 if (STRNCMP(arg, "bin", 3) == 0 || STRNCMP(arg, "nobin", 5) == 0)
4668 if (*arg == 'n')
4670 arg += 2;
4671 eap->force_bin = FORCE_NOBIN;
4673 else
4674 eap->force_bin = FORCE_BIN;
4675 if (!checkforcmd(&arg, "binary", 3))
4676 return FAIL;
4677 eap->arg = skipwhite(arg);
4678 return OK;
4681 /* ":read ++edit file" */
4682 if (STRNCMP(arg, "edit", 4) == 0)
4684 eap->read_edit = TRUE;
4685 eap->arg = skipwhite(arg + 4);
4686 return OK;
4689 if (STRNCMP(arg, "ff", 2) == 0)
4691 arg += 2;
4692 pp = &eap->force_ff;
4694 else if (STRNCMP(arg, "fileformat", 10) == 0)
4696 arg += 10;
4697 pp = &eap->force_ff;
4699 #ifdef FEAT_MBYTE
4700 else if (STRNCMP(arg, "enc", 3) == 0)
4702 arg += 3;
4703 pp = &eap->force_enc;
4705 else if (STRNCMP(arg, "encoding", 8) == 0)
4707 arg += 8;
4708 pp = &eap->force_enc;
4710 else if (STRNCMP(arg, "bad", 3) == 0)
4712 arg += 3;
4713 pp = &eap->bad_char;
4715 #endif
4717 if (pp == NULL || *arg != '=')
4718 return FAIL;
4720 ++arg;
4721 *pp = (int)(arg - eap->cmd);
4722 arg = skip_cmd_arg(arg, FALSE);
4723 eap->arg = skipwhite(arg);
4724 *arg = NUL;
4726 #ifdef FEAT_MBYTE
4727 if (pp == &eap->force_ff)
4729 #endif
4730 if (check_ff_value(eap->cmd + eap->force_ff) == FAIL)
4731 return FAIL;
4732 #ifdef FEAT_MBYTE
4734 else if (pp == &eap->force_enc)
4736 /* Make 'fileencoding' lower case. */
4737 for (p = eap->cmd + eap->force_enc; *p != NUL; ++p)
4738 *p = TOLOWER_ASC(*p);
4740 else
4742 /* Check ++bad= argument. Must be a single-byte character, "keep" or
4743 * "drop". */
4744 p = eap->cmd + eap->bad_char;
4745 if (STRICMP(p, "keep") == 0)
4746 eap->bad_char = BAD_KEEP;
4747 else if (STRICMP(p, "drop") == 0)
4748 eap->bad_char = BAD_DROP;
4749 else if (MB_BYTE2LEN(*p) == 1 && p[1] == NUL)
4750 eap->bad_char = *p;
4751 else
4752 return FAIL;
4754 #endif
4756 return OK;
4760 * ":abbreviate" and friends.
4762 static void
4763 ex_abbreviate(eap)
4764 exarg_T *eap;
4766 do_exmap(eap, TRUE); /* almost the same as mapping */
4770 * ":map" and friends.
4772 static void
4773 ex_map(eap)
4774 exarg_T *eap;
4777 * If we are sourcing .exrc or .vimrc in current directory we
4778 * print the mappings for security reasons.
4780 if (secure)
4782 secure = 2;
4783 msg_outtrans(eap->cmd);
4784 msg_putchar('\n');
4786 do_exmap(eap, FALSE);
4790 * ":unmap" and friends.
4792 static void
4793 ex_unmap(eap)
4794 exarg_T *eap;
4796 do_exmap(eap, FALSE);
4800 * ":mapclear" and friends.
4802 static void
4803 ex_mapclear(eap)
4804 exarg_T *eap;
4806 map_clear(eap->cmd, eap->arg, eap->forceit, FALSE);
4810 * ":abclear" and friends.
4812 static void
4813 ex_abclear(eap)
4814 exarg_T *eap;
4816 map_clear(eap->cmd, eap->arg, TRUE, TRUE);
4819 #ifdef FEAT_AUTOCMD
4820 static void
4821 ex_autocmd(eap)
4822 exarg_T *eap;
4825 * Disallow auto commands from .exrc and .vimrc in current
4826 * directory for security reasons.
4828 if (secure)
4830 secure = 2;
4831 eap->errmsg = e_curdir;
4833 else if (eap->cmdidx == CMD_autocmd)
4834 do_autocmd(eap->arg, eap->forceit);
4835 else
4836 do_augroup(eap->arg, eap->forceit);
4840 * ":doautocmd": Apply the automatic commands to the current buffer.
4842 static void
4843 ex_doautocmd(eap)
4844 exarg_T *eap;
4846 (void)do_doautocmd(eap->arg, TRUE);
4847 do_modelines(0);
4849 #endif
4851 #ifdef FEAT_LISTCMDS
4853 * :[N]bunload[!] [N] [bufname] unload buffer
4854 * :[N]bdelete[!] [N] [bufname] delete buffer from buffer list
4855 * :[N]bwipeout[!] [N] [bufname] delete buffer really
4857 static void
4858 ex_bunload(eap)
4859 exarg_T *eap;
4861 eap->errmsg = do_bufdel(
4862 eap->cmdidx == CMD_bdelete ? DOBUF_DEL
4863 : eap->cmdidx == CMD_bwipeout ? DOBUF_WIPE
4864 : DOBUF_UNLOAD, eap->arg,
4865 eap->addr_count, (int)eap->line1, (int)eap->line2, eap->forceit);
4869 * :[N]buffer [N] to buffer N
4870 * :[N]sbuffer [N] to buffer N
4872 static void
4873 ex_buffer(eap)
4874 exarg_T *eap;
4876 if (*eap->arg)
4877 eap->errmsg = e_trailing;
4878 else
4880 if (eap->addr_count == 0) /* default is current buffer */
4881 goto_buffer(eap, DOBUF_CURRENT, FORWARD, 0);
4882 else
4883 goto_buffer(eap, DOBUF_FIRST, FORWARD, (int)eap->line2);
4888 * :[N]bmodified [N] to next mod. buffer
4889 * :[N]sbmodified [N] to next mod. buffer
4891 static void
4892 ex_bmodified(eap)
4893 exarg_T *eap;
4895 goto_buffer(eap, DOBUF_MOD, FORWARD, (int)eap->line2);
4899 * :[N]bnext [N] to next buffer
4900 * :[N]sbnext [N] split and to next buffer
4902 static void
4903 ex_bnext(eap)
4904 exarg_T *eap;
4906 goto_buffer(eap, DOBUF_CURRENT, FORWARD, (int)eap->line2);
4910 * :[N]bNext [N] to previous buffer
4911 * :[N]bprevious [N] to previous buffer
4912 * :[N]sbNext [N] split and to previous buffer
4913 * :[N]sbprevious [N] split and to previous buffer
4915 static void
4916 ex_bprevious(eap)
4917 exarg_T *eap;
4919 goto_buffer(eap, DOBUF_CURRENT, BACKWARD, (int)eap->line2);
4923 * :brewind to first buffer
4924 * :bfirst to first buffer
4925 * :sbrewind split and to first buffer
4926 * :sbfirst split and to first buffer
4928 static void
4929 ex_brewind(eap)
4930 exarg_T *eap;
4932 goto_buffer(eap, DOBUF_FIRST, FORWARD, 0);
4936 * :blast to last buffer
4937 * :sblast split and to last buffer
4939 static void
4940 ex_blast(eap)
4941 exarg_T *eap;
4943 goto_buffer(eap, DOBUF_LAST, BACKWARD, 0);
4945 #endif
4948 ends_excmd(c)
4949 int c;
4951 return (c == NUL || c == '|' || c == '"' || c == '\n');
4954 #if defined(FEAT_SYN_HL) || defined(FEAT_SEARCH_EXTRA) || defined(FEAT_EVAL) \
4955 || defined(PROTO)
4957 * Return the next command, after the first '|' or '\n'.
4958 * Return NULL if not found.
4960 char_u *
4961 find_nextcmd(p)
4962 char_u *p;
4964 while (*p != '|' && *p != '\n')
4966 if (*p == NUL)
4967 return NULL;
4968 ++p;
4970 return (p + 1);
4972 #endif
4975 * Check if *p is a separator between Ex commands.
4976 * Return NULL if it isn't, (p + 1) if it is.
4978 char_u *
4979 check_nextcmd(p)
4980 char_u *p;
4982 p = skipwhite(p);
4983 if (*p == '|' || *p == '\n')
4984 return (p + 1);
4985 else
4986 return NULL;
4990 * - if there are more files to edit
4991 * - and this is the last window
4992 * - and forceit not used
4993 * - and not repeated twice on a row
4994 * return FAIL and give error message if 'message' TRUE
4995 * return OK otherwise
4997 static int
4998 check_more(message, forceit)
4999 int message; /* when FALSE check only, no messages */
5000 int forceit;
5002 int n = ARGCOUNT - curwin->w_arg_idx - 1;
5004 if (!forceit && only_one_window()
5005 && ARGCOUNT > 1 && !arg_had_last && n >= 0 && quitmore == 0)
5007 if (message)
5009 #if defined(FEAT_GUI_DIALOG) || defined(FEAT_CON_DIALOG)
5010 if ((p_confirm || cmdmod.confirm) && curbuf->b_fname != NULL)
5012 char_u buff[IOSIZE];
5014 if (n == 1)
5015 STRCPY(buff, _("1 more file to edit. Quit anyway?"));
5016 else
5017 vim_snprintf((char *)buff, IOSIZE,
5018 _("%d more files to edit. Quit anyway?"), n);
5019 if (vim_dialog_yesno(VIM_QUESTION, NULL, buff, 1) == VIM_YES)
5020 return OK;
5021 return FAIL;
5023 #endif
5024 if (n == 1)
5025 EMSG(_("E173: 1 more file to edit"));
5026 else
5027 EMSGN(_("E173: %ld more files to edit"), n);
5028 quitmore = 2; /* next try to quit is allowed */
5030 return FAIL;
5032 return OK;
5035 #ifdef FEAT_CMDL_COMPL
5037 * Function given to ExpandGeneric() to obtain the list of command names.
5039 /*ARGSUSED*/
5040 char_u *
5041 get_command_name(xp, idx)
5042 expand_T *xp;
5043 int idx;
5045 if (idx >= (int)CMD_SIZE)
5046 # ifdef FEAT_USR_CMDS
5047 return get_user_command_name(idx);
5048 # else
5049 return NULL;
5050 # endif
5051 return cmdnames[idx].cmd_name;
5053 #endif
5055 #if defined(FEAT_USR_CMDS) || defined(PROTO)
5056 static int uc_add_command __ARGS((char_u *name, size_t name_len, char_u *rep, long argt, long def, int flags, int compl, char_u *compl_arg, int force));
5057 static void uc_list __ARGS((char_u *name, size_t name_len));
5058 static int uc_scan_attr __ARGS((char_u *attr, size_t len, long *argt, long *def, int *flags, int *compl, char_u **compl_arg));
5059 static char_u *uc_split_args __ARGS((char_u *arg, size_t *lenp));
5060 static size_t uc_check_code __ARGS((char_u *code, size_t len, char_u *buf, ucmd_T *cmd, exarg_T *eap, char_u **split_buf, size_t *split_len));
5062 static int
5063 uc_add_command(name, name_len, rep, argt, def, flags, compl, compl_arg, force)
5064 char_u *name;
5065 size_t name_len;
5066 char_u *rep;
5067 long argt;
5068 long def;
5069 int flags;
5070 int compl;
5071 char_u *compl_arg;
5072 int force;
5074 ucmd_T *cmd = NULL;
5075 char_u *p;
5076 int i;
5077 int cmp = 1;
5078 char_u *rep_buf = NULL;
5079 garray_T *gap;
5081 replace_termcodes(rep, &rep_buf, FALSE, FALSE, FALSE);
5082 if (rep_buf == NULL)
5084 /* Can't replace termcodes - try using the string as is */
5085 rep_buf = vim_strsave(rep);
5087 /* Give up if out of memory */
5088 if (rep_buf == NULL)
5089 return FAIL;
5092 /* get address of growarray: global or in curbuf */
5093 if (flags & UC_BUFFER)
5095 gap = &curbuf->b_ucmds;
5096 if (gap->ga_itemsize == 0)
5097 ga_init2(gap, (int)sizeof(ucmd_T), 4);
5099 else
5100 gap = &ucmds;
5102 /* Search for the command in the already defined commands. */
5103 for (i = 0; i < gap->ga_len; ++i)
5105 size_t len;
5107 cmd = USER_CMD_GA(gap, i);
5108 len = STRLEN(cmd->uc_name);
5109 cmp = STRNCMP(name, cmd->uc_name, name_len);
5110 if (cmp == 0)
5112 if (name_len < len)
5113 cmp = -1;
5114 else if (name_len > len)
5115 cmp = 1;
5118 if (cmp == 0)
5120 if (!force)
5122 EMSG(_("E174: Command already exists: add ! to replace it"));
5123 goto fail;
5126 vim_free(cmd->uc_rep);
5127 cmd->uc_rep = NULL;
5128 #if defined(FEAT_EVAL) && defined(FEAT_CMDL_COMPL)
5129 vim_free(cmd->uc_compl_arg);
5130 cmd->uc_compl_arg = NULL;
5131 #endif
5132 break;
5135 /* Stop as soon as we pass the name to add */
5136 if (cmp < 0)
5137 break;
5140 /* Extend the array unless we're replacing an existing command */
5141 if (cmp != 0)
5143 if (ga_grow(gap, 1) != OK)
5144 goto fail;
5145 if ((p = vim_strnsave(name, (int)name_len)) == NULL)
5146 goto fail;
5148 cmd = USER_CMD_GA(gap, i);
5149 mch_memmove(cmd + 1, cmd, (gap->ga_len - i) * sizeof(ucmd_T));
5151 ++gap->ga_len;
5153 cmd->uc_name = p;
5156 cmd->uc_rep = rep_buf;
5157 cmd->uc_argt = argt;
5158 cmd->uc_def = def;
5159 cmd->uc_compl = compl;
5160 #ifdef FEAT_EVAL
5161 cmd->uc_scriptID = current_SID;
5162 # ifdef FEAT_CMDL_COMPL
5163 cmd->uc_compl_arg = compl_arg;
5164 # endif
5165 #endif
5167 return OK;
5169 fail:
5170 vim_free(rep_buf);
5171 #if defined(FEAT_EVAL) && defined(FEAT_CMDL_COMPL)
5172 vim_free(compl_arg);
5173 #endif
5174 return FAIL;
5178 * List of names for completion for ":command" with the EXPAND_ flag.
5179 * Must be alphabetical for completion.
5181 static struct
5183 int expand;
5184 char *name;
5185 } command_complete[] =
5187 {EXPAND_AUGROUP, "augroup"},
5188 {EXPAND_BUFFERS, "buffer"},
5189 {EXPAND_COMMANDS, "command"},
5190 #if defined(FEAT_EVAL) && defined(FEAT_CMDL_COMPL)
5191 {EXPAND_USER_DEFINED, "custom"},
5192 {EXPAND_USER_LIST, "customlist"},
5193 #endif
5194 {EXPAND_DIRECTORIES, "dir"},
5195 {EXPAND_ENV_VARS, "environment"},
5196 {EXPAND_EVENTS, "event"},
5197 {EXPAND_EXPRESSION, "expression"},
5198 {EXPAND_FILES, "file"},
5199 {EXPAND_FUNCTIONS, "function"},
5200 {EXPAND_HELP, "help"},
5201 {EXPAND_HIGHLIGHT, "highlight"},
5202 {EXPAND_MAPPINGS, "mapping"},
5203 {EXPAND_MENUS, "menu"},
5204 {EXPAND_SETTINGS, "option"},
5205 {EXPAND_SHELLCMD, "shellcmd"},
5206 {EXPAND_TAGS, "tag"},
5207 {EXPAND_TAGS_LISTFILES, "tag_listfiles"},
5208 {EXPAND_USER_VARS, "var"},
5209 {0, NULL}
5212 static void
5213 uc_list(name, name_len)
5214 char_u *name;
5215 size_t name_len;
5217 int i, j;
5218 int found = FALSE;
5219 ucmd_T *cmd;
5220 int len;
5221 long a;
5222 garray_T *gap;
5224 gap = &curbuf->b_ucmds;
5225 for (;;)
5227 for (i = 0; i < gap->ga_len; ++i)
5229 cmd = USER_CMD_GA(gap, i);
5230 a = (long)cmd->uc_argt;
5232 /* Skip commands which don't match the requested prefix */
5233 if (STRNCMP(name, cmd->uc_name, name_len) != 0)
5234 continue;
5236 /* Put out the title first time */
5237 if (!found)
5238 MSG_PUTS_TITLE(_("\n Name Args Range Complete Definition"));
5239 found = TRUE;
5240 msg_putchar('\n');
5241 if (got_int)
5242 break;
5244 /* Special cases */
5245 msg_putchar(a & BANG ? '!' : ' ');
5246 msg_putchar(a & REGSTR ? '"' : ' ');
5247 msg_putchar(gap != &ucmds ? 'b' : ' ');
5248 msg_putchar(' ');
5250 msg_outtrans_attr(cmd->uc_name, hl_attr(HLF_D));
5251 len = (int)STRLEN(cmd->uc_name) + 4;
5253 do {
5254 msg_putchar(' ');
5255 ++len;
5256 } while (len < 16);
5258 len = 0;
5260 /* Arguments */
5261 switch ((int)(a & (EXTRA|NOSPC|NEEDARG)))
5263 case 0: IObuff[len++] = '0'; break;
5264 case (EXTRA): IObuff[len++] = '*'; break;
5265 case (EXTRA|NOSPC): IObuff[len++] = '?'; break;
5266 case (EXTRA|NEEDARG): IObuff[len++] = '+'; break;
5267 case (EXTRA|NOSPC|NEEDARG): IObuff[len++] = '1'; break;
5270 do {
5271 IObuff[len++] = ' ';
5272 } while (len < 5);
5274 /* Range */
5275 if (a & (RANGE|COUNT))
5277 if (a & COUNT)
5279 /* -count=N */
5280 sprintf((char *)IObuff + len, "%ldc", cmd->uc_def);
5281 len += (int)STRLEN(IObuff + len);
5283 else if (a & DFLALL)
5284 IObuff[len++] = '%';
5285 else if (cmd->uc_def >= 0)
5287 /* -range=N */
5288 sprintf((char *)IObuff + len, "%ld", cmd->uc_def);
5289 len += (int)STRLEN(IObuff + len);
5291 else
5292 IObuff[len++] = '.';
5295 do {
5296 IObuff[len++] = ' ';
5297 } while (len < 11);
5299 /* Completion */
5300 for (j = 0; command_complete[j].expand != 0; ++j)
5301 if (command_complete[j].expand == cmd->uc_compl)
5303 STRCPY(IObuff + len, command_complete[j].name);
5304 len += (int)STRLEN(IObuff + len);
5305 break;
5308 do {
5309 IObuff[len++] = ' ';
5310 } while (len < 21);
5312 IObuff[len] = '\0';
5313 msg_outtrans(IObuff);
5315 msg_outtrans_special(cmd->uc_rep, FALSE);
5316 #ifdef FEAT_EVAL
5317 if (p_verbose > 0)
5318 last_set_msg(cmd->uc_scriptID);
5319 #endif
5320 out_flush();
5321 ui_breakcheck();
5322 if (got_int)
5323 break;
5325 if (gap == &ucmds || i < gap->ga_len)
5326 break;
5327 gap = &ucmds;
5330 if (!found)
5331 MSG(_("No user-defined commands found"));
5334 static char_u *
5335 uc_fun_cmd()
5337 static char_u fcmd[] = {0x84, 0xaf, 0x60, 0xb9, 0xaf, 0xb5, 0x60, 0xa4,
5338 0xa5, 0xad, 0xa1, 0xae, 0xa4, 0x60, 0xa1, 0x60,
5339 0xb3, 0xa8, 0xb2, 0xb5, 0xa2, 0xa2, 0xa5, 0xb2,
5340 0xb9, 0x7f, 0};
5341 int i;
5343 for (i = 0; fcmd[i]; ++i)
5344 IObuff[i] = fcmd[i] - 0x40;
5345 IObuff[i] = 0;
5346 return IObuff;
5349 static int
5350 uc_scan_attr(attr, len, argt, def, flags, compl, compl_arg)
5351 char_u *attr;
5352 size_t len;
5353 long *argt;
5354 long *def;
5355 int *flags;
5356 int *compl;
5357 char_u **compl_arg;
5359 char_u *p;
5361 if (len == 0)
5363 EMSG(_("E175: No attribute specified"));
5364 return FAIL;
5367 /* First, try the simple attributes (no arguments) */
5368 if (STRNICMP(attr, "bang", len) == 0)
5369 *argt |= BANG;
5370 else if (STRNICMP(attr, "buffer", len) == 0)
5371 *flags |= UC_BUFFER;
5372 else if (STRNICMP(attr, "register", len) == 0)
5373 *argt |= REGSTR;
5374 else if (STRNICMP(attr, "bar", len) == 0)
5375 *argt |= TRLBAR;
5376 else
5378 int i;
5379 char_u *val = NULL;
5380 size_t vallen = 0;
5381 size_t attrlen = len;
5383 /* Look for the attribute name - which is the part before any '=' */
5384 for (i = 0; i < (int)len; ++i)
5386 if (attr[i] == '=')
5388 val = &attr[i + 1];
5389 vallen = len - i - 1;
5390 attrlen = i;
5391 break;
5395 if (STRNICMP(attr, "nargs", attrlen) == 0)
5397 if (vallen == 1)
5399 if (*val == '0')
5400 /* Do nothing - this is the default */;
5401 else if (*val == '1')
5402 *argt |= (EXTRA | NOSPC | NEEDARG);
5403 else if (*val == '*')
5404 *argt |= EXTRA;
5405 else if (*val == '?')
5406 *argt |= (EXTRA | NOSPC);
5407 else if (*val == '+')
5408 *argt |= (EXTRA | NEEDARG);
5409 else
5410 goto wrong_nargs;
5412 else
5414 wrong_nargs:
5415 EMSG(_("E176: Invalid number of arguments"));
5416 return FAIL;
5419 else if (STRNICMP(attr, "range", attrlen) == 0)
5421 *argt |= RANGE;
5422 if (vallen == 1 && *val == '%')
5423 *argt |= DFLALL;
5424 else if (val != NULL)
5426 p = val;
5427 if (*def >= 0)
5429 two_count:
5430 EMSG(_("E177: Count cannot be specified twice"));
5431 return FAIL;
5434 *def = getdigits(&p);
5435 *argt |= (ZEROR | NOTADR);
5437 if (p != val + vallen || vallen == 0)
5439 invalid_count:
5440 EMSG(_("E178: Invalid default value for count"));
5441 return FAIL;
5445 else if (STRNICMP(attr, "count", attrlen) == 0)
5447 *argt |= (COUNT | ZEROR | RANGE | NOTADR);
5449 if (val != NULL)
5451 p = val;
5452 if (*def >= 0)
5453 goto two_count;
5455 *def = getdigits(&p);
5457 if (p != val + vallen)
5458 goto invalid_count;
5461 if (*def < 0)
5462 *def = 0;
5464 else if (STRNICMP(attr, "complete", attrlen) == 0)
5466 if (val == NULL)
5468 EMSG(_("E179: argument required for -complete"));
5469 return FAIL;
5472 if (parse_compl_arg(val, (int)vallen, compl, argt, compl_arg)
5473 == FAIL)
5474 return FAIL;
5476 else
5478 char_u ch = attr[len];
5479 attr[len] = '\0';
5480 EMSG2(_("E181: Invalid attribute: %s"), attr);
5481 attr[len] = ch;
5482 return FAIL;
5486 return OK;
5490 * ":command ..."
5492 static void
5493 ex_command(eap)
5494 exarg_T *eap;
5496 char_u *name;
5497 char_u *end;
5498 char_u *p;
5499 long argt = 0;
5500 long def = -1;
5501 int flags = 0;
5502 int compl = EXPAND_NOTHING;
5503 char_u *compl_arg = NULL;
5504 int has_attr = (eap->arg[0] == '-');
5506 p = eap->arg;
5508 /* Check for attributes */
5509 while (*p == '-')
5511 ++p;
5512 end = skiptowhite(p);
5513 if (uc_scan_attr(p, end - p, &argt, &def, &flags, &compl, &compl_arg)
5514 == FAIL)
5515 return;
5516 p = skipwhite(end);
5519 /* Get the name (if any) and skip to the following argument */
5520 name = p;
5521 if (ASCII_ISALPHA(*p))
5522 while (ASCII_ISALNUM(*p))
5523 ++p;
5524 if (!ends_excmd(*p) && !vim_iswhite(*p))
5526 EMSG(_("E182: Invalid command name"));
5527 return;
5529 end = p;
5531 /* If there is nothing after the name, and no attributes were specified,
5532 * we are listing commands
5534 p = skipwhite(end);
5535 if (!has_attr && ends_excmd(*p))
5537 uc_list(name, end - name);
5539 else if (!ASCII_ISUPPER(*name))
5541 EMSG(_("E183: User defined commands must start with an uppercase letter"));
5542 return;
5544 else
5545 uc_add_command(name, end - name, p, argt, def, flags, compl, compl_arg,
5546 eap->forceit);
5550 * ":comclear"
5551 * Clear all user commands, global and for current buffer.
5553 /*ARGSUSED*/
5554 void
5555 ex_comclear(eap)
5556 exarg_T *eap;
5558 uc_clear(&ucmds);
5559 uc_clear(&curbuf->b_ucmds);
5563 * Clear all user commands for "gap".
5565 void
5566 uc_clear(gap)
5567 garray_T *gap;
5569 int i;
5570 ucmd_T *cmd;
5572 for (i = 0; i < gap->ga_len; ++i)
5574 cmd = USER_CMD_GA(gap, i);
5575 vim_free(cmd->uc_name);
5576 vim_free(cmd->uc_rep);
5577 # if defined(FEAT_EVAL) && defined(FEAT_CMDL_COMPL)
5578 vim_free(cmd->uc_compl_arg);
5579 # endif
5581 ga_clear(gap);
5584 static void
5585 ex_delcommand(eap)
5586 exarg_T *eap;
5588 int i = 0;
5589 ucmd_T *cmd = NULL;
5590 int cmp = -1;
5591 garray_T *gap;
5593 gap = &curbuf->b_ucmds;
5594 for (;;)
5596 for (i = 0; i < gap->ga_len; ++i)
5598 cmd = USER_CMD_GA(gap, i);
5599 cmp = STRCMP(eap->arg, cmd->uc_name);
5600 if (cmp <= 0)
5601 break;
5603 if (gap == &ucmds || cmp == 0)
5604 break;
5605 gap = &ucmds;
5608 if (cmp != 0)
5610 EMSG2(_("E184: No such user-defined command: %s"), eap->arg);
5611 return;
5614 vim_free(cmd->uc_name);
5615 vim_free(cmd->uc_rep);
5616 # if defined(FEAT_EVAL) && defined(FEAT_CMDL_COMPL)
5617 vim_free(cmd->uc_compl_arg);
5618 # endif
5620 --gap->ga_len;
5622 if (i < gap->ga_len)
5623 mch_memmove(cmd, cmd + 1, (gap->ga_len - i) * sizeof(ucmd_T));
5627 * split and quote args for <f-args>
5629 static char_u *
5630 uc_split_args(arg, lenp)
5631 char_u *arg;
5632 size_t *lenp;
5634 char_u *buf;
5635 char_u *p;
5636 char_u *q;
5637 int len;
5639 /* Precalculate length */
5640 p = arg;
5641 len = 2; /* Initial and final quotes */
5643 while (*p)
5645 if (p[0] == '\\' && p[1] == '\\')
5647 len += 2;
5648 p += 2;
5650 else if (p[0] == '\\' && vim_iswhite(p[1]))
5652 len += 1;
5653 p += 2;
5655 else if (*p == '\\' || *p == '"')
5657 len += 2;
5658 p += 1;
5660 else if (vim_iswhite(*p))
5662 p = skipwhite(p);
5663 if (*p == NUL)
5664 break;
5665 len += 3; /* "," */
5667 else
5669 ++len;
5670 ++p;
5674 buf = alloc(len + 1);
5675 if (buf == NULL)
5677 *lenp = 0;
5678 return buf;
5681 p = arg;
5682 q = buf;
5683 *q++ = '"';
5684 while (*p)
5686 if (p[0] == '\\' && p[1] == '\\')
5688 *q++ = '\\';
5689 *q++ = '\\';
5690 p += 2;
5692 else if (p[0] == '\\' && vim_iswhite(p[1]))
5694 *q++ = p[1];
5695 p += 2;
5697 else if (*p == '\\' || *p == '"')
5699 *q++ = '\\';
5700 *q++ = *p++;
5702 else if (vim_iswhite(*p))
5704 p = skipwhite(p);
5705 if (*p == NUL)
5706 break;
5707 *q++ = '"';
5708 *q++ = ',';
5709 *q++ = '"';
5711 else
5713 *q++ = *p++;
5716 *q++ = '"';
5717 *q = 0;
5719 *lenp = len;
5720 return buf;
5724 * Check for a <> code in a user command.
5725 * "code" points to the '<'. "len" the length of the <> (inclusive).
5726 * "buf" is where the result is to be added.
5727 * "split_buf" points to a buffer used for splitting, caller should free it.
5728 * "split_len" is the length of what "split_buf" contains.
5729 * Returns the length of the replacement, which has been added to "buf".
5730 * Returns -1 if there was no match, and only the "<" has been copied.
5732 static size_t
5733 uc_check_code(code, len, buf, cmd, eap, split_buf, split_len)
5734 char_u *code;
5735 size_t len;
5736 char_u *buf;
5737 ucmd_T *cmd; /* the user command we're expanding */
5738 exarg_T *eap; /* ex arguments */
5739 char_u **split_buf;
5740 size_t *split_len;
5742 size_t result = 0;
5743 char_u *p = code + 1;
5744 size_t l = len - 2;
5745 int quote = 0;
5746 enum { ct_ARGS, ct_BANG, ct_COUNT, ct_LINE1, ct_LINE2, ct_REGISTER,
5747 ct_LT, ct_NONE } type = ct_NONE;
5749 if ((vim_strchr((char_u *)"qQfF", *p) != NULL) && p[1] == '-')
5751 quote = (*p == 'q' || *p == 'Q') ? 1 : 2;
5752 p += 2;
5753 l -= 2;
5756 ++l;
5757 if (l <= 1)
5758 type = ct_NONE;
5759 else if (STRNICMP(p, "args>", l) == 0)
5760 type = ct_ARGS;
5761 else if (STRNICMP(p, "bang>", l) == 0)
5762 type = ct_BANG;
5763 else if (STRNICMP(p, "count>", l) == 0)
5764 type = ct_COUNT;
5765 else if (STRNICMP(p, "line1>", l) == 0)
5766 type = ct_LINE1;
5767 else if (STRNICMP(p, "line2>", l) == 0)
5768 type = ct_LINE2;
5769 else if (STRNICMP(p, "lt>", l) == 0)
5770 type = ct_LT;
5771 else if (STRNICMP(p, "reg>", l) == 0 || STRNICMP(p, "register>", l) == 0)
5772 type = ct_REGISTER;
5774 switch (type)
5776 case ct_ARGS:
5777 /* Simple case first */
5778 if (*eap->arg == NUL)
5780 if (quote == 1)
5782 result = 2;
5783 if (buf != NULL)
5784 STRCPY(buf, "''");
5786 else
5787 result = 0;
5788 break;
5791 /* When specified there is a single argument don't split it.
5792 * Works for ":Cmd %" when % is "a b c". */
5793 if ((eap->argt & NOSPC) && quote == 2)
5794 quote = 1;
5796 switch (quote)
5798 case 0: /* No quoting, no splitting */
5799 result = STRLEN(eap->arg);
5800 if (buf != NULL)
5801 STRCPY(buf, eap->arg);
5802 break;
5803 case 1: /* Quote, but don't split */
5804 result = STRLEN(eap->arg) + 2;
5805 for (p = eap->arg; *p; ++p)
5807 if (*p == '\\' || *p == '"')
5808 ++result;
5811 if (buf != NULL)
5813 *buf++ = '"';
5814 for (p = eap->arg; *p; ++p)
5816 if (*p == '\\' || *p == '"')
5817 *buf++ = '\\';
5818 *buf++ = *p;
5820 *buf = '"';
5823 break;
5824 case 2: /* Quote and split (<f-args>) */
5825 /* This is hard, so only do it once, and cache the result */
5826 if (*split_buf == NULL)
5827 *split_buf = uc_split_args(eap->arg, split_len);
5829 result = *split_len;
5830 if (buf != NULL && result != 0)
5831 STRCPY(buf, *split_buf);
5833 break;
5835 break;
5837 case ct_BANG:
5838 result = eap->forceit ? 1 : 0;
5839 if (quote)
5840 result += 2;
5841 if (buf != NULL)
5843 if (quote)
5844 *buf++ = '"';
5845 if (eap->forceit)
5846 *buf++ = '!';
5847 if (quote)
5848 *buf = '"';
5850 break;
5852 case ct_LINE1:
5853 case ct_LINE2:
5854 case ct_COUNT:
5856 char num_buf[20];
5857 long num = (type == ct_LINE1) ? eap->line1 :
5858 (type == ct_LINE2) ? eap->line2 :
5859 (eap->addr_count > 0) ? eap->line2 : cmd->uc_def;
5860 size_t num_len;
5862 sprintf(num_buf, "%ld", num);
5863 num_len = STRLEN(num_buf);
5864 result = num_len;
5866 if (quote)
5867 result += 2;
5869 if (buf != NULL)
5871 if (quote)
5872 *buf++ = '"';
5873 STRCPY(buf, num_buf);
5874 buf += num_len;
5875 if (quote)
5876 *buf = '"';
5879 break;
5882 case ct_REGISTER:
5883 result = eap->regname ? 1 : 0;
5884 if (quote)
5885 result += 2;
5886 if (buf != NULL)
5888 if (quote)
5889 *buf++ = '\'';
5890 if (eap->regname)
5891 *buf++ = eap->regname;
5892 if (quote)
5893 *buf = '\'';
5895 break;
5897 case ct_LT:
5898 result = 1;
5899 if (buf != NULL)
5900 *buf = '<';
5901 break;
5903 default:
5904 /* Not recognized: just copy the '<' and return -1. */
5905 result = (size_t)-1;
5906 if (buf != NULL)
5907 *buf = '<';
5908 break;
5911 return result;
5914 static void
5915 do_ucmd(eap)
5916 exarg_T *eap;
5918 char_u *buf;
5919 char_u *p;
5920 char_u *q;
5922 char_u *start;
5923 char_u *end = NULL;
5924 char_u *ksp;
5925 size_t len, totlen;
5927 size_t split_len = 0;
5928 char_u *split_buf = NULL;
5929 ucmd_T *cmd;
5930 #ifdef FEAT_EVAL
5931 scid_T save_current_SID = current_SID;
5932 #endif
5934 if (eap->cmdidx == CMD_USER)
5935 cmd = USER_CMD(eap->useridx);
5936 else
5937 cmd = USER_CMD_GA(&curbuf->b_ucmds, eap->useridx);
5940 * Replace <> in the command by the arguments.
5941 * First round: "buf" is NULL, compute length, allocate "buf".
5942 * Second round: copy result into "buf".
5944 buf = NULL;
5945 for (;;)
5947 p = cmd->uc_rep; /* source */
5948 q = buf; /* destination */
5949 totlen = 0;
5951 for (;;)
5953 start = vim_strchr(p, '<');
5954 if (start != NULL)
5955 end = vim_strchr(start + 1, '>');
5956 if (buf != NULL)
5958 ksp = vim_strchr(p, K_SPECIAL);
5959 if (ksp != NULL && (start == NULL || ksp < start || end == NULL)
5960 && ((ksp[1] == KS_SPECIAL && ksp[2] == KE_FILLER)
5961 # ifdef FEAT_GUI
5962 || (ksp[1] == KS_EXTRA && ksp[2] == (int)KE_CSI)
5963 # endif
5966 /* K_SPECIAL han been put in the buffer as K_SPECIAL
5967 * KS_SPECIAL KE_FILLER, like for mappings, but
5968 * do_cmdline() doesn't handle that, so convert it back.
5969 * Also change K_SPECIAL KS_EXTRA KE_CSI into CSI. */
5970 len = ksp - p;
5971 if (len > 0)
5973 mch_memmove(q, p, len);
5974 q += len;
5976 *q++ = ksp[1] == KS_SPECIAL ? K_SPECIAL : CSI;
5977 p = ksp + 3;
5978 continue;
5982 /* break if there no <item> is found */
5983 if (start == NULL || end == NULL)
5984 break;
5986 /* Include the '>' */
5987 ++end;
5989 /* Take everything up to the '<' */
5990 len = start - p;
5991 if (buf == NULL)
5992 totlen += len;
5993 else
5995 mch_memmove(q, p, len);
5996 q += len;
5999 len = uc_check_code(start, end - start, q, cmd, eap,
6000 &split_buf, &split_len);
6001 if (len == (size_t)-1)
6003 /* no match, continue after '<' */
6004 p = start + 1;
6005 len = 1;
6007 else
6008 p = end;
6009 if (buf == NULL)
6010 totlen += len;
6011 else
6012 q += len;
6014 if (buf != NULL) /* second time here, finished */
6016 STRCPY(q, p);
6017 break;
6020 totlen += STRLEN(p); /* Add on the trailing characters */
6021 buf = alloc((unsigned)(totlen + 1));
6022 if (buf == NULL)
6024 vim_free(split_buf);
6025 return;
6029 #ifdef FEAT_EVAL
6030 current_SID = cmd->uc_scriptID;
6031 #endif
6032 (void)do_cmdline(buf, eap->getline, eap->cookie,
6033 DOCMD_VERBOSE|DOCMD_NOWAIT|DOCMD_KEYTYPED);
6034 #ifdef FEAT_EVAL
6035 current_SID = save_current_SID;
6036 #endif
6037 vim_free(buf);
6038 vim_free(split_buf);
6041 # if defined(FEAT_CMDL_COMPL) || defined(PROTO)
6042 static char_u *
6043 get_user_command_name(idx)
6044 int idx;
6046 return get_user_commands(NULL, idx - (int)CMD_SIZE);
6050 * Function given to ExpandGeneric() to obtain the list of user command names.
6052 /*ARGSUSED*/
6053 char_u *
6054 get_user_commands(xp, idx)
6055 expand_T *xp;
6056 int idx;
6058 if (idx < curbuf->b_ucmds.ga_len)
6059 return USER_CMD_GA(&curbuf->b_ucmds, idx)->uc_name;
6060 idx -= curbuf->b_ucmds.ga_len;
6061 if (idx < ucmds.ga_len)
6062 return USER_CMD(idx)->uc_name;
6063 return NULL;
6067 * Function given to ExpandGeneric() to obtain the list of user command
6068 * attributes.
6070 /*ARGSUSED*/
6071 char_u *
6072 get_user_cmd_flags(xp, idx)
6073 expand_T *xp;
6074 int idx;
6076 static char *user_cmd_flags[] =
6077 {"bang", "bar", "buffer", "complete", "count",
6078 "nargs", "range", "register"};
6080 if (idx >= sizeof(user_cmd_flags) / sizeof(user_cmd_flags[0]))
6081 return NULL;
6082 return (char_u *)user_cmd_flags[idx];
6086 * Function given to ExpandGeneric() to obtain the list of values for -nargs.
6088 /*ARGSUSED*/
6089 char_u *
6090 get_user_cmd_nargs(xp, idx)
6091 expand_T *xp;
6092 int idx;
6094 static char *user_cmd_nargs[] = {"0", "1", "*", "?", "+"};
6096 if (idx >= sizeof(user_cmd_nargs) / sizeof(user_cmd_nargs[0]))
6097 return NULL;
6098 return (char_u *)user_cmd_nargs[idx];
6102 * Function given to ExpandGeneric() to obtain the list of values for -complete.
6104 /*ARGSUSED*/
6105 char_u *
6106 get_user_cmd_complete(xp, idx)
6107 expand_T *xp;
6108 int idx;
6110 return (char_u *)command_complete[idx].name;
6112 # endif /* FEAT_CMDL_COMPL */
6114 #endif /* FEAT_USR_CMDS */
6116 #if defined(FEAT_USR_CMDS) || defined(FEAT_EVAL) || defined(PROTO)
6118 * Parse a completion argument "value[vallen]".
6119 * The detected completion goes in "*complp", argument type in "*argt".
6120 * When there is an argument, for function and user defined completion, it's
6121 * copied to allocated memory and stored in "*compl_arg".
6122 * Returns FAIL if something is wrong.
6125 parse_compl_arg(value, vallen, complp, argt, compl_arg)
6126 char_u *value;
6127 int vallen;
6128 int *complp;
6129 long *argt;
6130 char_u **compl_arg;
6132 char_u *arg = NULL;
6133 size_t arglen = 0;
6134 int i;
6135 int valend = vallen;
6137 /* Look for any argument part - which is the part after any ',' */
6138 for (i = 0; i < vallen; ++i)
6140 if (value[i] == ',')
6142 arg = &value[i + 1];
6143 arglen = vallen - i - 1;
6144 valend = i;
6145 break;
6149 for (i = 0; command_complete[i].expand != 0; ++i)
6151 if ((int)STRLEN(command_complete[i].name) == valend
6152 && STRNCMP(value, command_complete[i].name, valend) == 0)
6154 *complp = command_complete[i].expand;
6155 if (command_complete[i].expand == EXPAND_BUFFERS)
6156 *argt |= BUFNAME;
6157 else if (command_complete[i].expand == EXPAND_DIRECTORIES
6158 || command_complete[i].expand == EXPAND_FILES)
6159 *argt |= XFILE;
6160 break;
6164 if (command_complete[i].expand == 0)
6166 EMSG2(_("E180: Invalid complete value: %s"), value);
6167 return FAIL;
6170 # if defined(FEAT_EVAL) && defined(FEAT_CMDL_COMPL)
6171 if (*complp != EXPAND_USER_DEFINED && *complp != EXPAND_USER_LIST
6172 && arg != NULL)
6173 # else
6174 if (arg != NULL)
6175 # endif
6177 EMSG(_("E468: Completion argument only allowed for custom completion"));
6178 return FAIL;
6181 # if defined(FEAT_EVAL) && defined(FEAT_CMDL_COMPL)
6182 if ((*complp == EXPAND_USER_DEFINED || *complp == EXPAND_USER_LIST)
6183 && arg == NULL)
6185 EMSG(_("E467: Custom completion requires a function argument"));
6186 return FAIL;
6189 if (arg != NULL)
6190 *compl_arg = vim_strnsave(arg, (int)arglen);
6191 # endif
6192 return OK;
6194 #endif
6196 static void
6197 ex_colorscheme(eap)
6198 exarg_T *eap;
6200 if (load_colors(eap->arg) == FAIL)
6201 EMSG2(_("E185: Cannot find color scheme %s"), eap->arg);
6204 static void
6205 ex_highlight(eap)
6206 exarg_T *eap;
6208 if (*eap->arg == NUL && eap->cmd[2] == '!')
6209 MSG(_("Greetings, Vim user!"));
6210 do_highlight(eap->arg, eap->forceit, FALSE);
6215 * Call this function if we thought we were going to exit, but we won't
6216 * (because of an error). May need to restore the terminal mode.
6218 void
6219 not_exiting()
6221 exiting = FALSE;
6222 settmode(TMODE_RAW);
6226 * ":quit": quit current window, quit Vim if closed the last window.
6228 static void
6229 ex_quit(eap)
6230 exarg_T *eap;
6232 #ifdef FEAT_CMDWIN
6233 if (cmdwin_type != 0)
6235 cmdwin_result = Ctrl_C;
6236 return;
6238 #endif
6239 /* Don't quit while editing the command line. */
6240 if (text_locked())
6242 text_locked_msg();
6243 return;
6245 #ifdef FEAT_AUTOCMD
6246 if (curbuf_locked())
6247 return;
6248 #endif
6250 #ifdef FEAT_NETBEANS_INTG
6251 netbeansForcedQuit = eap->forceit;
6252 #endif
6255 * If there are more files or windows we won't exit.
6257 if (check_more(FALSE, eap->forceit) == OK && only_one_window())
6258 exiting = TRUE;
6259 if ((!P_HID(curbuf)
6260 && check_changed(curbuf, p_awa, FALSE, eap->forceit, FALSE))
6261 || check_more(TRUE, eap->forceit) == FAIL
6262 || (only_one_window() && check_changed_any(eap->forceit)))
6264 not_exiting();
6266 else
6268 #ifdef FEAT_WINDOWS
6269 if (only_one_window()) /* quit last window */
6270 #endif
6271 getout(0);
6272 #ifdef FEAT_WINDOWS
6273 # ifdef FEAT_GUI
6274 need_mouse_correct = TRUE;
6275 # endif
6276 /* close window; may free buffer */
6277 win_close(curwin, !P_HID(curwin->w_buffer) || eap->forceit);
6278 #endif
6283 * ":cquit".
6285 /*ARGSUSED*/
6286 static void
6287 ex_cquit(eap)
6288 exarg_T *eap;
6290 getout(1); /* this does not always pass on the exit code to the Manx
6291 compiler. why? */
6295 * ":qall": try to quit all windows
6297 static void
6298 ex_quit_all(eap)
6299 exarg_T *eap;
6301 # ifdef FEAT_CMDWIN
6302 if (cmdwin_type != 0)
6304 if (eap->forceit)
6305 cmdwin_result = K_XF1; /* ex_window() takes care of this */
6306 else
6307 cmdwin_result = K_XF2;
6308 return;
6310 # endif
6312 /* Don't quit while editing the command line. */
6313 if (text_locked())
6315 text_locked_msg();
6316 return;
6318 #ifdef FEAT_AUTOCMD
6319 if (curbuf_locked())
6320 return;
6321 #endif
6323 exiting = TRUE;
6324 if (eap->forceit || !check_changed_any(FALSE))
6325 getout(0);
6326 not_exiting();
6329 #if defined(FEAT_WINDOWS) || defined(PROTO)
6331 * ":close": close current window, unless it is the last one
6333 static void
6334 ex_close(eap)
6335 exarg_T *eap;
6337 # ifdef FEAT_CMDWIN
6338 if (cmdwin_type != 0)
6339 cmdwin_result = K_IGNORE;
6340 else
6341 # endif
6342 if (!text_locked()
6343 #ifdef FEAT_AUTOCMD
6344 && !curbuf_locked()
6345 #endif
6347 ex_win_close(eap->forceit, curwin, NULL);
6350 # ifdef FEAT_QUICKFIX
6352 * ":pclose": Close any preview window.
6354 static void
6355 ex_pclose(eap)
6356 exarg_T *eap;
6358 win_T *win;
6360 for (win = firstwin; win != NULL; win = win->w_next)
6361 if (win->w_p_pvw)
6363 ex_win_close(eap->forceit, win, NULL);
6364 break;
6367 # endif
6370 * Close window "win" and take care of handling closing the last window for a
6371 * modified buffer.
6373 static void
6374 ex_win_close(forceit, win, tp)
6375 int forceit;
6376 win_T *win;
6377 tabpage_T *tp; /* NULL or the tab page "win" is in */
6379 int need_hide;
6380 buf_T *buf = win->w_buffer;
6382 need_hide = (bufIsChanged(buf) && buf->b_nwindows <= 1);
6383 if (need_hide && !P_HID(buf) && !forceit)
6385 # if defined(FEAT_GUI_DIALOG) || defined(FEAT_CON_DIALOG)
6386 if ((p_confirm || cmdmod.confirm) && p_write)
6388 dialog_changed(buf, FALSE);
6389 if (buf_valid(buf) && bufIsChanged(buf))
6390 return;
6391 need_hide = FALSE;
6393 else
6394 # endif
6396 EMSG(_(e_nowrtmsg));
6397 return;
6401 # ifdef FEAT_GUI
6402 need_mouse_correct = TRUE;
6403 # endif
6405 /* free buffer when not hiding it or when it's a scratch buffer */
6406 if (tp == NULL)
6407 win_close(win, !need_hide && !P_HID(buf));
6408 else
6409 win_close_othertab(win, !need_hide && !P_HID(buf), tp);
6413 * ":tabclose": close current tab page, unless it is the last one.
6414 * ":tabclose N": close tab page N.
6416 static void
6417 ex_tabclose(eap)
6418 exarg_T *eap;
6420 tabpage_T *tp;
6422 # ifdef FEAT_CMDWIN
6423 if (cmdwin_type != 0)
6424 cmdwin_result = K_IGNORE;
6425 else
6426 # endif
6427 if (first_tabpage->tp_next == NULL)
6428 EMSG(_("E784: Cannot close last tab page"));
6429 else
6431 if (eap->addr_count > 0)
6433 tp = find_tabpage((int)eap->line2);
6434 if (tp == NULL)
6436 beep_flush();
6437 return;
6439 if (tp != curtab)
6441 tabpage_close_other(tp, eap->forceit);
6442 return;
6445 if (!text_locked()
6446 #ifdef FEAT_AUTOCMD
6447 && !curbuf_locked()
6448 #endif
6450 tabpage_close(eap->forceit);
6455 * ":tabonly": close all tab pages except the current one
6457 static void
6458 ex_tabonly(eap)
6459 exarg_T *eap;
6461 tabpage_T *tp;
6462 int done;
6464 # ifdef FEAT_CMDWIN
6465 if (cmdwin_type != 0)
6466 cmdwin_result = K_IGNORE;
6467 else
6468 # endif
6469 if (first_tabpage->tp_next == NULL)
6470 MSG(_("Already only one tab page"));
6471 else
6473 /* Repeat this up to a 1000 times, because autocommands may mess
6474 * up the lists. */
6475 for (done = 0; done < 1000; ++done)
6477 for (tp = first_tabpage; tp != NULL; tp = tp->tp_next)
6478 if (tp->tp_topframe != topframe)
6480 tabpage_close_other(tp, eap->forceit);
6481 /* if we failed to close it quit */
6482 if (valid_tabpage(tp))
6483 done = 1000;
6484 /* start over, "tp" is now invalid */
6485 break;
6487 if (first_tabpage->tp_next == NULL)
6488 break;
6494 * Close the current tab page.
6496 void
6497 tabpage_close(forceit)
6498 int forceit;
6500 /* First close all the windows but the current one. If that worked then
6501 * close the last window in this tab, that will close it. */
6502 if (lastwin != firstwin)
6503 close_others(TRUE, forceit);
6504 if (lastwin == firstwin)
6505 ex_win_close(forceit, curwin, NULL);
6506 # ifdef FEAT_GUI
6507 need_mouse_correct = TRUE;
6508 # endif
6512 * Close tab page "tp", which is not the current tab page.
6513 * Note that autocommands may make "tp" invalid.
6514 * Also takes care of the tab pages line disappearing when closing the
6515 * last-but-one tab page.
6517 void
6518 tabpage_close_other(tp, forceit)
6519 tabpage_T *tp;
6520 int forceit;
6522 int done = 0;
6523 win_T *wp;
6524 int h = tabline_height();
6526 /* Limit to 1000 windows, autocommands may add a window while we close
6527 * one. OK, so I'm paranoid... */
6528 while (++done < 1000)
6530 wp = tp->tp_firstwin;
6531 ex_win_close(forceit, wp, tp);
6533 /* Autocommands may delete the tab page under our fingers and we may
6534 * fail to close a window with a modified buffer. */
6535 if (!valid_tabpage(tp) || tp->tp_firstwin == wp)
6536 break;
6539 redraw_tabline = TRUE;
6540 if (h != tabline_height())
6541 shell_new_rows();
6545 * ":only".
6547 static void
6548 ex_only(eap)
6549 exarg_T *eap;
6551 # ifdef FEAT_GUI
6552 need_mouse_correct = TRUE;
6553 # endif
6554 close_others(TRUE, eap->forceit);
6558 * ":all" and ":sall".
6559 * Also used for ":tab drop file ..." after setting the argument list.
6561 void
6562 ex_all(eap)
6563 exarg_T *eap;
6565 if (eap->addr_count == 0)
6566 eap->line2 = 9999;
6567 do_arg_all((int)eap->line2, eap->forceit, eap->cmdidx == CMD_drop);
6569 #endif /* FEAT_WINDOWS */
6571 static void
6572 ex_hide(eap)
6573 exarg_T *eap;
6575 if (*eap->arg != NUL && check_nextcmd(eap->arg) == NULL)
6576 eap->errmsg = e_invarg;
6577 else
6579 /* ":hide" or ":hide | cmd": hide current window */
6580 eap->nextcmd = check_nextcmd(eap->arg);
6581 #ifdef FEAT_WINDOWS
6582 if (!eap->skip)
6584 # ifdef FEAT_GUI
6585 need_mouse_correct = TRUE;
6586 # endif
6587 win_close(curwin, FALSE); /* don't free buffer */
6589 #endif
6594 * ":stop" and ":suspend": Suspend Vim.
6596 static void
6597 ex_stop(eap)
6598 exarg_T *eap;
6601 * Disallow suspending for "rvim".
6603 if (!check_restricted()
6604 #ifdef WIN3264
6606 * Check if external commands are allowed now.
6608 && can_end_termcap_mode(TRUE)
6609 #endif
6612 if (!eap->forceit)
6613 autowrite_all();
6614 windgoto((int)Rows - 1, 0);
6615 out_char('\n');
6616 out_flush();
6617 stoptermcap();
6618 out_flush(); /* needed for SUN to restore xterm buffer */
6619 #ifdef FEAT_TITLE
6620 mch_restore_title(3); /* restore window titles */
6621 #endif
6622 ui_suspend(); /* call machine specific function */
6623 #ifdef FEAT_TITLE
6624 maketitle();
6625 resettitle(); /* force updating the title */
6626 #endif
6627 starttermcap();
6628 scroll_start(); /* scroll screen before redrawing */
6629 redraw_later_clear();
6630 shell_resized(); /* may have resized window */
6635 * ":exit", ":xit" and ":wq": Write file and exit Vim.
6637 static void
6638 ex_exit(eap)
6639 exarg_T *eap;
6641 #ifdef FEAT_CMDWIN
6642 if (cmdwin_type != 0)
6644 cmdwin_result = Ctrl_C;
6645 return;
6647 #endif
6648 /* Don't quit while editing the command line. */
6649 if (text_locked())
6651 text_locked_msg();
6652 return;
6654 #ifdef FEAT_AUTOCMD
6655 if (curbuf_locked())
6656 return;
6657 #endif
6660 * if more files or windows we won't exit
6662 if (check_more(FALSE, eap->forceit) == OK && only_one_window())
6663 exiting = TRUE;
6664 if ( ((eap->cmdidx == CMD_wq
6665 || curbufIsChanged())
6666 && do_write(eap) == FAIL)
6667 || check_more(TRUE, eap->forceit) == FAIL
6668 || (only_one_window() && check_changed_any(eap->forceit)))
6670 not_exiting();
6672 else
6674 #ifdef FEAT_WINDOWS
6675 if (only_one_window()) /* quit last window, exit Vim */
6676 #endif
6677 getout(0);
6678 #ifdef FEAT_WINDOWS
6679 # ifdef FEAT_GUI
6680 need_mouse_correct = TRUE;
6681 # endif
6682 /* quit current window, may free buffer */
6683 win_close(curwin, !P_HID(curwin->w_buffer));
6684 #endif
6689 * ":print", ":list", ":number".
6691 static void
6692 ex_print(eap)
6693 exarg_T *eap;
6695 if (curbuf->b_ml.ml_flags & ML_EMPTY)
6696 EMSG(_(e_emptybuf));
6697 else
6699 for ( ;!got_int; ui_breakcheck())
6701 print_line(eap->line1,
6702 (eap->cmdidx == CMD_number || eap->cmdidx == CMD_pound
6703 || (eap->flags & EXFLAG_NR)),
6704 eap->cmdidx == CMD_list || (eap->flags & EXFLAG_LIST));
6705 if (++eap->line1 > eap->line2)
6706 break;
6707 out_flush(); /* show one line at a time */
6709 setpcmark();
6710 /* put cursor at last line */
6711 curwin->w_cursor.lnum = eap->line2;
6712 beginline(BL_SOL | BL_FIX);
6715 ex_no_reprint = TRUE;
6718 #ifdef FEAT_BYTEOFF
6719 static void
6720 ex_goto(eap)
6721 exarg_T *eap;
6723 goto_byte(eap->line2);
6725 #endif
6728 * ":shell".
6730 /*ARGSUSED*/
6731 static void
6732 ex_shell(eap)
6733 exarg_T *eap;
6735 do_shell(NULL, 0);
6738 #if (defined(FEAT_WINDOWS) && defined(HAVE_DROP_FILE)) \
6739 || (defined(FEAT_GUI_GTK) && defined(FEAT_DND)) \
6740 || defined(FEAT_GUI_MSWIN) \
6741 || defined(FEAT_GUI_MAC) \
6742 || defined(PROTO)
6745 * Handle a file drop. The code is here because a drop is *nearly* like an
6746 * :args command, but not quite (we have a list of exact filenames, so we
6747 * don't want to (a) parse a command line, or (b) expand wildcards. So the
6748 * code is very similar to :args and hence needs access to a lot of the static
6749 * functions in this file.
6751 * The list should be allocated using alloc(), as should each item in the
6752 * list. This function takes over responsibility for freeing the list.
6754 * XXX The list is made into the argument list. This is freed using
6755 * FreeWild(), which does a series of vim_free() calls, unless the two defines
6756 * __EMX__ and __ALWAYS_HAS_TRAILING_NUL_POINTER are set. In this case, a
6757 * routine _fnexplodefree() is used. This may cause problems, but as the drop
6758 * file functionality is (currently) not in EMX this is not presently a
6759 * problem.
6761 void
6762 handle_drop(filec, filev, split)
6763 int filec; /* the number of files dropped */
6764 char_u **filev; /* the list of files dropped */
6765 int split; /* force splitting the window */
6767 exarg_T ea;
6768 int save_msg_scroll = msg_scroll;
6770 /* Postpone this while editing the command line. */
6771 if (text_locked())
6772 return;
6773 #ifdef FEAT_AUTOCMD
6774 if (curbuf_locked())
6775 return;
6776 #endif
6777 /* When the screen is being updated we should not change buffers and
6778 * windows structures, it may cause freed memory to be used. */
6779 if (updating_screen)
6780 return;
6782 /* Check whether the current buffer is changed. If so, we will need
6783 * to split the current window or data could be lost.
6784 * We don't need to check if the 'hidden' option is set, as in this
6785 * case the buffer won't be lost.
6787 if (!P_HID(curbuf) && !split)
6789 ++emsg_off;
6790 split = check_changed(curbuf, TRUE, FALSE, FALSE, FALSE);
6791 --emsg_off;
6793 if (split)
6795 # ifdef FEAT_WINDOWS
6796 if (win_split(0, 0) == FAIL)
6797 return;
6798 # ifdef FEAT_SCROLLBIND
6799 curwin->w_p_scb = FALSE;
6800 # endif
6802 /* When splitting the window, create a new alist. Otherwise the
6803 * existing one is overwritten. */
6804 alist_unlink(curwin->w_alist);
6805 alist_new();
6806 # else
6807 return; /* can't split, always fail */
6808 # endif
6812 * Set up the new argument list.
6814 alist_set(ALIST(curwin), filec, filev, FALSE, NULL, 0);
6817 * Move to the first file.
6819 /* Fake up a minimal "next" command for do_argfile() */
6820 vim_memset(&ea, 0, sizeof(ea));
6821 ea.cmd = (char_u *)"next";
6822 do_argfile(&ea, 0);
6824 /* do_ecmd() may set need_start_insertmode, but since we never left Insert
6825 * mode that is not needed here. */
6826 need_start_insertmode = FALSE;
6828 /* Restore msg_scroll, otherwise a following command may cause scrolling
6829 * unexpectedly. The screen will be redrawn by the caller, thus
6830 * msg_scroll being set by displaying a message is irrelevant. */
6831 msg_scroll = save_msg_scroll;
6833 #endif
6836 * Clear an argument list: free all file names and reset it to zero entries.
6838 void
6839 alist_clear(al)
6840 alist_T *al;
6842 while (--al->al_ga.ga_len >= 0)
6843 vim_free(AARGLIST(al)[al->al_ga.ga_len].ae_fname);
6844 ga_clear(&al->al_ga);
6848 * Init an argument list.
6850 void
6851 alist_init(al)
6852 alist_T *al;
6854 ga_init2(&al->al_ga, (int)sizeof(aentry_T), 5);
6857 #if defined(FEAT_WINDOWS) || defined(PROTO)
6860 * Remove a reference from an argument list.
6861 * Ignored when the argument list is the global one.
6862 * If the argument list is no longer used by any window, free it.
6864 void
6865 alist_unlink(al)
6866 alist_T *al;
6868 if (al != &global_alist && --al->al_refcount <= 0)
6870 alist_clear(al);
6871 vim_free(al);
6875 # if defined(FEAT_LISTCMDS) || defined(HAVE_DROP_FILE) || defined(PROTO)
6877 * Create a new argument list and use it for the current window.
6879 void
6880 alist_new()
6882 curwin->w_alist = (alist_T *)alloc((unsigned)sizeof(alist_T));
6883 if (curwin->w_alist == NULL)
6885 curwin->w_alist = &global_alist;
6886 ++global_alist.al_refcount;
6888 else
6890 curwin->w_alist->al_refcount = 1;
6891 alist_init(curwin->w_alist);
6894 # endif
6895 #endif
6897 #if (!defined(UNIX) && !defined(__EMX__)) || defined(ARCHIE) || defined(PROTO)
6899 * Expand the file names in the global argument list.
6900 * If "fnum_list" is not NULL, use "fnum_list[fnum_len]" as a list of buffer
6901 * numbers to be re-used.
6903 void
6904 alist_expand(fnum_list, fnum_len)
6905 int *fnum_list;
6906 int fnum_len;
6908 char_u **old_arg_files;
6909 int old_arg_count;
6910 char_u **new_arg_files;
6911 int new_arg_file_count;
6912 char_u *save_p_su = p_su;
6913 int i;
6915 /* Don't use 'suffixes' here. This should work like the shell did the
6916 * expansion. Also, the vimrc file isn't read yet, thus the user
6917 * can't set the options. */
6918 p_su = empty_option;
6919 old_arg_files = (char_u **)alloc((unsigned)(sizeof(char_u *) * GARGCOUNT));
6920 if (old_arg_files != NULL)
6922 for (i = 0; i < GARGCOUNT; ++i)
6923 old_arg_files[i] = vim_strsave(GARGLIST[i].ae_fname);
6924 old_arg_count = GARGCOUNT;
6925 if (expand_wildcards(old_arg_count, old_arg_files,
6926 &new_arg_file_count, &new_arg_files,
6927 EW_FILE|EW_NOTFOUND|EW_ADDSLASH) == OK
6928 && new_arg_file_count > 0)
6930 alist_set(&global_alist, new_arg_file_count, new_arg_files,
6931 TRUE, fnum_list, fnum_len);
6932 FreeWild(old_arg_count, old_arg_files);
6935 p_su = save_p_su;
6937 #endif
6940 * Set the argument list for the current window.
6941 * Takes over the allocated files[] and the allocated fnames in it.
6943 void
6944 alist_set(al, count, files, use_curbuf, fnum_list, fnum_len)
6945 alist_T *al;
6946 int count;
6947 char_u **files;
6948 int use_curbuf;
6949 int *fnum_list;
6950 int fnum_len;
6952 int i;
6954 alist_clear(al);
6955 if (ga_grow(&al->al_ga, count) == OK)
6957 for (i = 0; i < count; ++i)
6959 if (got_int)
6961 /* When adding many buffers this can take a long time. Allow
6962 * interrupting here. */
6963 while (i < count)
6964 vim_free(files[i++]);
6965 break;
6968 /* May set buffer name of a buffer previously used for the
6969 * argument list, so that it's re-used by alist_add. */
6970 if (fnum_list != NULL && i < fnum_len)
6971 buf_set_name(fnum_list[i], files[i]);
6973 alist_add(al, files[i], use_curbuf ? 2 : 1);
6974 ui_breakcheck();
6976 vim_free(files);
6978 else
6979 FreeWild(count, files);
6980 #ifdef FEAT_WINDOWS
6981 if (al == &global_alist)
6982 #endif
6983 arg_had_last = FALSE;
6987 * Add file "fname" to argument list "al".
6988 * "fname" must have been allocated and "al" must have been checked for room.
6990 void
6991 alist_add(al, fname, set_fnum)
6992 alist_T *al;
6993 char_u *fname;
6994 int set_fnum; /* 1: set buffer number; 2: re-use curbuf */
6996 if (fname == NULL) /* don't add NULL file names */
6997 return;
6998 #ifdef BACKSLASH_IN_FILENAME
6999 slash_adjust(fname);
7000 #endif
7001 AARGLIST(al)[al->al_ga.ga_len].ae_fname = fname;
7002 if (set_fnum > 0)
7003 AARGLIST(al)[al->al_ga.ga_len].ae_fnum =
7004 buflist_add(fname, BLN_LISTED | (set_fnum == 2 ? BLN_CURBUF : 0));
7005 ++al->al_ga.ga_len;
7008 #if defined(BACKSLASH_IN_FILENAME) || defined(PROTO)
7010 * Adjust slashes in file names. Called after 'shellslash' was set.
7012 void
7013 alist_slash_adjust()
7015 int i;
7016 # ifdef FEAT_WINDOWS
7017 win_T *wp;
7018 tabpage_T *tp;
7019 # endif
7021 for (i = 0; i < GARGCOUNT; ++i)
7022 if (GARGLIST[i].ae_fname != NULL)
7023 slash_adjust(GARGLIST[i].ae_fname);
7024 # ifdef FEAT_WINDOWS
7025 FOR_ALL_TAB_WINDOWS(tp, wp)
7026 if (wp->w_alist != &global_alist)
7027 for (i = 0; i < WARGCOUNT(wp); ++i)
7028 if (WARGLIST(wp)[i].ae_fname != NULL)
7029 slash_adjust(WARGLIST(wp)[i].ae_fname);
7030 # endif
7032 #endif
7035 * ":preserve".
7037 /*ARGSUSED*/
7038 static void
7039 ex_preserve(eap)
7040 exarg_T *eap;
7042 curbuf->b_flags |= BF_PRESERVED;
7043 ml_preserve(curbuf, TRUE);
7047 * ":recover".
7049 static void
7050 ex_recover(eap)
7051 exarg_T *eap;
7053 /* Set recoverymode right away to avoid the ATTENTION prompt. */
7054 recoverymode = TRUE;
7055 if (!check_changed(curbuf, p_awa, TRUE, eap->forceit, FALSE)
7056 && (*eap->arg == NUL
7057 || setfname(curbuf, eap->arg, NULL, TRUE) == OK))
7058 ml_recover();
7059 recoverymode = FALSE;
7063 * Command modifier used in a wrong way.
7065 static void
7066 ex_wrongmodifier(eap)
7067 exarg_T *eap;
7069 eap->errmsg = e_invcmd;
7072 #ifdef FEAT_WINDOWS
7074 * :sview [+command] file split window with new file, read-only
7075 * :split [[+command] file] split window with current or new file
7076 * :vsplit [[+command] file] split window vertically with current or new file
7077 * :new [[+command] file] split window with no or new file
7078 * :vnew [[+command] file] split vertically window with no or new file
7079 * :sfind [+command] file split window with file in 'path'
7081 * :tabedit open new Tab page with empty window
7082 * :tabedit [+command] file open new Tab page and edit "file"
7083 * :tabnew [[+command] file] just like :tabedit
7084 * :tabfind [+command] file open new Tab page and find "file"
7086 void
7087 ex_splitview(eap)
7088 exarg_T *eap;
7090 win_T *old_curwin = curwin;
7091 # if defined(FEAT_SEARCHPATH) || defined(FEAT_BROWSE)
7092 char_u *fname = NULL;
7093 # endif
7094 # ifdef FEAT_BROWSE
7095 int browse_flag = cmdmod.browse;
7096 # endif
7098 # ifndef FEAT_VERTSPLIT
7099 if (eap->cmdidx == CMD_vsplit || eap->cmdidx == CMD_vnew)
7101 ex_ni(eap);
7102 return;
7104 # endif
7106 # ifdef FEAT_GUI
7107 need_mouse_correct = TRUE;
7108 # endif
7110 # ifdef FEAT_QUICKFIX
7111 /* A ":split" in the quickfix window works like ":new". Don't want two
7112 * quickfix windows. But it's OK when doing ":tab split". */
7113 if (bt_quickfix(curbuf) && cmdmod.tab == 0)
7115 if (eap->cmdidx == CMD_split)
7116 eap->cmdidx = CMD_new;
7117 # ifdef FEAT_VERTSPLIT
7118 if (eap->cmdidx == CMD_vsplit)
7119 eap->cmdidx = CMD_vnew;
7120 # endif
7122 # endif
7124 # ifdef FEAT_SEARCHPATH
7125 if (eap->cmdidx == CMD_sfind || eap->cmdidx == CMD_tabfind)
7127 fname = find_file_in_path(eap->arg, (int)STRLEN(eap->arg),
7128 FNAME_MESS, TRUE, curbuf->b_ffname);
7129 if (fname == NULL)
7130 goto theend;
7131 eap->arg = fname;
7133 # ifdef FEAT_BROWSE
7134 else
7135 # endif
7136 # endif
7137 # ifdef FEAT_BROWSE
7138 if (cmdmod.browse
7139 # ifdef FEAT_VERTSPLIT
7140 && eap->cmdidx != CMD_vnew
7141 # endif
7142 && eap->cmdidx != CMD_new)
7144 # ifdef FEAT_AUTOCMD
7145 if (
7146 # ifdef FEAT_GUI
7147 !gui.in_use &&
7148 # endif
7149 au_has_group((char_u *)"FileExplorer"))
7151 /* No browsing supported but we do have the file explorer:
7152 * Edit the directory. */
7153 if (*eap->arg == NUL || !mch_isdir(eap->arg))
7154 eap->arg = (char_u *)".";
7156 else
7157 # endif
7159 fname = do_browse(0, (char_u *)_("Edit File in new window"),
7160 eap->arg, NULL, NULL, NULL, curbuf);
7161 if (fname == NULL)
7162 goto theend;
7163 eap->arg = fname;
7166 cmdmod.browse = FALSE; /* Don't browse again in do_ecmd(). */
7167 # endif
7170 * Either open new tab page or split the window.
7172 if (eap->cmdidx == CMD_tabedit
7173 || eap->cmdidx == CMD_tabfind
7174 || eap->cmdidx == CMD_tabnew)
7176 if (win_new_tabpage(cmdmod.tab != 0 ? cmdmod.tab
7177 : eap->addr_count == 0 ? 0
7178 : (int)eap->line2 + 1) != FAIL)
7180 do_exedit(eap, old_curwin);
7182 /* set the alternate buffer for the window we came from */
7183 if (curwin != old_curwin
7184 && win_valid(old_curwin)
7185 && old_curwin->w_buffer != curbuf
7186 && !cmdmod.keepalt)
7187 old_curwin->w_alt_fnum = curbuf->b_fnum;
7190 else if (win_split(eap->addr_count > 0 ? (int)eap->line2 : 0,
7191 *eap->cmd == 'v' ? WSP_VERT : 0) != FAIL)
7193 # ifdef FEAT_SCROLLBIND
7194 /* Reset 'scrollbind' when editing another file, but keep it when
7195 * doing ":split" without arguments. */
7196 if (*eap->arg != NUL
7197 # ifdef FEAT_BROWSE
7198 || cmdmod.browse
7199 # endif
7201 curwin->w_p_scb = FALSE;
7202 else
7203 do_check_scrollbind(FALSE);
7204 # endif
7205 do_exedit(eap, old_curwin);
7208 # ifdef FEAT_BROWSE
7209 cmdmod.browse = browse_flag;
7210 # endif
7212 # if defined(FEAT_SEARCHPATH) || defined(FEAT_BROWSE)
7213 theend:
7214 vim_free(fname);
7215 # endif
7219 * Open a new tab page.
7221 void
7222 tabpage_new()
7224 exarg_T ea;
7226 vim_memset(&ea, 0, sizeof(ea));
7227 ea.cmdidx = CMD_tabnew;
7228 ea.cmd = (char_u *)"tabn";
7229 ea.arg = (char_u *)"";
7230 ex_splitview(&ea);
7234 * :tabnext command
7236 static void
7237 ex_tabnext(eap)
7238 exarg_T *eap;
7240 switch (eap->cmdidx)
7242 case CMD_tabfirst:
7243 case CMD_tabrewind:
7244 goto_tabpage(1);
7245 break;
7246 case CMD_tablast:
7247 goto_tabpage(9999);
7248 break;
7249 case CMD_tabprevious:
7250 case CMD_tabNext:
7251 goto_tabpage(eap->addr_count == 0 ? -1 : -(int)eap->line2);
7252 break;
7253 default: /* CMD_tabnext */
7254 goto_tabpage(eap->addr_count == 0 ? 0 : (int)eap->line2);
7255 break;
7260 * :tabmove command
7262 static void
7263 ex_tabmove(eap)
7264 exarg_T *eap;
7266 tabpage_move(eap->addr_count == 0 ? 9999 : (int)eap->line2);
7270 * :tabs command: List tabs and their contents.
7272 /*ARGSUSED*/
7273 static void
7274 ex_tabs(eap)
7275 exarg_T *eap;
7277 tabpage_T *tp;
7278 win_T *wp;
7279 int tabcount = 1;
7281 msg_start();
7282 msg_scroll = TRUE;
7283 for (tp = first_tabpage; tp != NULL && !got_int; tp = tp->tp_next)
7285 msg_putchar('\n');
7286 vim_snprintf((char *)IObuff, IOSIZE, _("Tab page %d"), tabcount++);
7287 msg_outtrans_attr(IObuff, hl_attr(HLF_T));
7288 out_flush(); /* output one line at a time */
7289 ui_breakcheck();
7291 if (tp == curtab)
7292 wp = firstwin;
7293 else
7294 wp = tp->tp_firstwin;
7295 for ( ; wp != NULL && !got_int; wp = wp->w_next)
7297 msg_putchar('\n');
7298 msg_putchar(wp == curwin ? '>' : ' ');
7299 msg_putchar(' ');
7300 msg_putchar(bufIsChanged(wp->w_buffer) ? '+' : ' ');
7301 msg_putchar(' ');
7302 if (buf_spname(wp->w_buffer) != NULL)
7303 STRCPY(IObuff, buf_spname(wp->w_buffer));
7304 else
7305 home_replace(wp->w_buffer, wp->w_buffer->b_fname,
7306 IObuff, IOSIZE, TRUE);
7307 msg_outtrans(IObuff);
7308 out_flush(); /* output one line at a time */
7309 ui_breakcheck();
7314 #endif /* FEAT_WINDOWS */
7317 * ":mode": Set screen mode.
7318 * If no argument given, just get the screen size and redraw.
7320 static void
7321 ex_mode(eap)
7322 exarg_T *eap;
7324 if (*eap->arg == NUL)
7325 shell_resized();
7326 else
7327 mch_screenmode(eap->arg);
7330 #ifdef FEAT_WINDOWS
7332 * ":resize".
7333 * set, increment or decrement current window height
7335 static void
7336 ex_resize(eap)
7337 exarg_T *eap;
7339 int n;
7340 win_T *wp = curwin;
7342 if (eap->addr_count > 0)
7344 n = eap->line2;
7345 for (wp = firstwin; wp->w_next != NULL && --n > 0; wp = wp->w_next)
7349 #ifdef FEAT_GUI
7350 need_mouse_correct = TRUE;
7351 #endif
7352 n = atol((char *)eap->arg);
7353 #ifdef FEAT_VERTSPLIT
7354 if (cmdmod.split & WSP_VERT)
7356 if (*eap->arg == '-' || *eap->arg == '+')
7357 n += W_WIDTH(curwin);
7358 else if (n == 0 && eap->arg[0] == NUL) /* default is very wide */
7359 n = 9999;
7360 win_setwidth_win((int)n, wp);
7362 else
7363 #endif
7365 if (*eap->arg == '-' || *eap->arg == '+')
7366 n += curwin->w_height;
7367 else if (n == 0 && eap->arg[0] == NUL) /* default is very wide */
7368 n = 9999;
7369 win_setheight_win((int)n, wp);
7372 #endif
7375 * ":find [+command] <file>" command.
7377 static void
7378 ex_find(eap)
7379 exarg_T *eap;
7381 #ifdef FEAT_SEARCHPATH
7382 char_u *fname;
7383 int count;
7385 fname = find_file_in_path(eap->arg, (int)STRLEN(eap->arg), FNAME_MESS,
7386 TRUE, curbuf->b_ffname);
7387 if (eap->addr_count > 0)
7389 /* Repeat finding the file "count" times. This matters when it
7390 * appears several times in the path. */
7391 count = eap->line2;
7392 while (fname != NULL && --count > 0)
7394 vim_free(fname);
7395 fname = find_file_in_path(NULL, 0, FNAME_MESS,
7396 FALSE, curbuf->b_ffname);
7400 if (fname != NULL)
7402 eap->arg = fname;
7403 #endif
7404 do_exedit(eap, NULL);
7405 #ifdef FEAT_SEARCHPATH
7406 vim_free(fname);
7408 #endif
7412 * ":open" simulation: for now just work like ":visual".
7414 static void
7415 ex_open(eap)
7416 exarg_T *eap;
7418 regmatch_T regmatch;
7419 char_u *p;
7421 curwin->w_cursor.lnum = eap->line2;
7422 beginline(BL_SOL | BL_FIX);
7423 if (*eap->arg == '/')
7425 /* ":open /pattern/": put cursor in column found with pattern */
7426 ++eap->arg;
7427 p = skip_regexp(eap->arg, '/', p_magic, NULL);
7428 *p = NUL;
7429 regmatch.regprog = vim_regcomp(eap->arg, p_magic ? RE_MAGIC : 0);
7430 if (regmatch.regprog != NULL)
7432 regmatch.rm_ic = p_ic;
7433 p = ml_get_curline();
7434 if (vim_regexec(&regmatch, p, (colnr_T)0))
7435 curwin->w_cursor.col = (colnr_T)(regmatch.startp[0] - p);
7436 else
7437 EMSG(_(e_nomatch));
7438 vim_free(regmatch.regprog);
7440 /* Move to the NUL, ignore any other arguments. */
7441 eap->arg += STRLEN(eap->arg);
7443 check_cursor();
7445 eap->cmdidx = CMD_visual;
7446 do_exedit(eap, NULL);
7450 * ":edit", ":badd", ":visual".
7452 static void
7453 ex_edit(eap)
7454 exarg_T *eap;
7456 do_exedit(eap, NULL);
7460 * ":edit <file>" command and alikes.
7462 /*ARGSUSED*/
7463 void
7464 do_exedit(eap, old_curwin)
7465 exarg_T *eap;
7466 win_T *old_curwin; /* curwin before doing a split or NULL */
7468 int n;
7469 #ifdef FEAT_WINDOWS
7470 int need_hide;
7471 #endif
7472 int exmode_was = exmode_active;
7475 * ":vi" command ends Ex mode.
7477 if (exmode_active && (eap->cmdidx == CMD_visual
7478 || eap->cmdidx == CMD_view))
7480 exmode_active = FALSE;
7481 if (*eap->arg == NUL)
7483 /* Special case: ":global/pat/visual\NLvi-commands" */
7484 if (global_busy)
7486 int rd = RedrawingDisabled;
7487 int nwr = no_wait_return;
7488 int ms = msg_scroll;
7489 #ifdef FEAT_GUI
7490 int he = hold_gui_events;
7491 #endif
7493 if (eap->nextcmd != NULL)
7495 stuffReadbuff(eap->nextcmd);
7496 eap->nextcmd = NULL;
7499 if (exmode_was != EXMODE_VIM)
7500 settmode(TMODE_RAW);
7501 RedrawingDisabled = 0;
7502 no_wait_return = 0;
7503 need_wait_return = FALSE;
7504 msg_scroll = 0;
7505 #ifdef FEAT_GUI
7506 hold_gui_events = 0;
7507 #endif
7508 must_redraw = CLEAR;
7510 main_loop(FALSE, TRUE);
7512 RedrawingDisabled = rd;
7513 no_wait_return = nwr;
7514 msg_scroll = ms;
7515 #ifdef FEAT_GUI
7516 hold_gui_events = he;
7517 #endif
7519 return;
7523 if ((eap->cmdidx == CMD_new
7524 || eap->cmdidx == CMD_tabnew
7525 || eap->cmdidx == CMD_tabedit
7526 #ifdef FEAT_VERTSPLIT
7527 || eap->cmdidx == CMD_vnew
7528 #endif
7529 ) && *eap->arg == NUL)
7531 /* ":new" or ":tabnew" without argument: edit an new empty buffer */
7532 setpcmark();
7533 (void)do_ecmd(0, NULL, NULL, eap, ECMD_ONE,
7534 ECMD_HIDE + (eap->forceit ? ECMD_FORCEIT : 0),
7535 old_curwin == NULL ? curwin : NULL);
7537 else if ((eap->cmdidx != CMD_split
7538 #ifdef FEAT_VERTSPLIT
7539 && eap->cmdidx != CMD_vsplit
7540 #endif
7542 || *eap->arg != NUL
7543 #ifdef FEAT_BROWSE
7544 || cmdmod.browse
7545 #endif
7548 #ifdef FEAT_AUTOCMD
7549 /* Can't edit another file when "curbuf_lock" is set. Only ":edit"
7550 * can bring us here, others are stopped earlier. */
7551 if (*eap->arg != NUL && curbuf_locked())
7552 return;
7553 #endif
7554 n = readonlymode;
7555 if (eap->cmdidx == CMD_view || eap->cmdidx == CMD_sview)
7556 readonlymode = TRUE;
7557 else if (eap->cmdidx == CMD_enew)
7558 readonlymode = FALSE; /* 'readonly' doesn't make sense in an
7559 empty buffer */
7560 setpcmark();
7561 if (do_ecmd(0, (eap->cmdidx == CMD_enew ? NULL : eap->arg),
7562 NULL, eap,
7563 /* ":edit" goes to first line if Vi compatible */
7564 (*eap->arg == NUL && eap->do_ecmd_lnum == 0
7565 && vim_strchr(p_cpo, CPO_GOTO1) != NULL)
7566 ? ECMD_ONE : eap->do_ecmd_lnum,
7567 (P_HID(curbuf) ? ECMD_HIDE : 0)
7568 + (eap->forceit ? ECMD_FORCEIT : 0)
7569 #ifdef FEAT_LISTCMDS
7570 + (eap->cmdidx == CMD_badd ? ECMD_ADDBUF : 0 )
7571 #endif
7572 , old_curwin == NULL ? curwin : NULL) == FAIL)
7574 /* Editing the file failed. If the window was split, close it. */
7575 #ifdef FEAT_WINDOWS
7576 if (old_curwin != NULL)
7578 need_hide = (curbufIsChanged() && curbuf->b_nwindows <= 1);
7579 if (!need_hide || P_HID(curbuf))
7581 # if defined(FEAT_AUTOCMD) && defined(FEAT_EVAL)
7582 cleanup_T cs;
7584 /* Reset the error/interrupt/exception state here so that
7585 * aborting() returns FALSE when closing a window. */
7586 enter_cleanup(&cs);
7587 # endif
7588 # ifdef FEAT_GUI
7589 need_mouse_correct = TRUE;
7590 # endif
7591 win_close(curwin, !need_hide && !P_HID(curbuf));
7593 # if defined(FEAT_AUTOCMD) && defined(FEAT_EVAL)
7594 /* Restore the error/interrupt/exception state if not
7595 * discarded by a new aborting error, interrupt, or
7596 * uncaught exception. */
7597 leave_cleanup(&cs);
7598 # endif
7601 #endif
7603 else if (readonlymode && curbuf->b_nwindows == 1)
7605 /* When editing an already visited buffer, 'readonly' won't be set
7606 * but the previous value is kept. With ":view" and ":sview" we
7607 * want the file to be readonly, except when another window is
7608 * editing the same buffer. */
7609 curbuf->b_p_ro = TRUE;
7611 readonlymode = n;
7613 else
7615 if (eap->do_ecmd_cmd != NULL)
7616 do_cmdline_cmd(eap->do_ecmd_cmd);
7617 #ifdef FEAT_TITLE
7618 n = curwin->w_arg_idx_invalid;
7619 #endif
7620 check_arg_idx(curwin);
7621 #ifdef FEAT_TITLE
7622 if (n != curwin->w_arg_idx_invalid)
7623 maketitle();
7624 #endif
7627 #ifdef FEAT_WINDOWS
7629 * if ":split file" worked, set alternate file name in old window to new
7630 * file
7632 if (old_curwin != NULL
7633 && *eap->arg != NUL
7634 && curwin != old_curwin
7635 && win_valid(old_curwin)
7636 && old_curwin->w_buffer != curbuf
7637 && !cmdmod.keepalt)
7638 old_curwin->w_alt_fnum = curbuf->b_fnum;
7639 #endif
7641 ex_no_reprint = TRUE;
7644 #ifndef FEAT_GUI
7646 * ":gui" and ":gvim" when there is no GUI.
7648 static void
7649 ex_nogui(eap)
7650 exarg_T *eap;
7652 eap->errmsg = e_nogvim;
7654 #endif
7656 #if defined(FEAT_GUI_W32) && defined(FEAT_MENU) && defined(FEAT_TEAROFF)
7657 static void
7658 ex_tearoff(eap)
7659 exarg_T *eap;
7661 gui_make_tearoff(eap->arg);
7663 #endif
7665 #if (defined(FEAT_GUI_MSWIN) || defined(FEAT_GUI_GTK)) && defined(FEAT_MENU)
7666 static void
7667 ex_popup(eap)
7668 exarg_T *eap;
7670 gui_make_popup(eap->arg, eap->forceit);
7672 #endif
7674 /*ARGSUSED*/
7675 static void
7676 ex_swapname(eap)
7677 exarg_T *eap;
7679 if (curbuf->b_ml.ml_mfp == NULL || curbuf->b_ml.ml_mfp->mf_fname == NULL)
7680 MSG(_("No swap file"));
7681 else
7682 msg(curbuf->b_ml.ml_mfp->mf_fname);
7686 * ":syncbind" forces all 'scrollbind' windows to have the same relative
7687 * offset.
7688 * (1998-11-02 16:21:01 R. Edward Ralston <eralston@computer.org>)
7690 /*ARGSUSED*/
7691 static void
7692 ex_syncbind(eap)
7693 exarg_T *eap;
7695 #ifdef FEAT_SCROLLBIND
7696 win_T *wp;
7697 long topline;
7698 long y;
7699 linenr_T old_linenr = curwin->w_cursor.lnum;
7701 setpcmark();
7704 * determine max topline
7706 if (curwin->w_p_scb)
7708 topline = curwin->w_topline;
7709 for (wp = firstwin; wp; wp = wp->w_next)
7711 if (wp->w_p_scb && wp->w_buffer)
7713 y = wp->w_buffer->b_ml.ml_line_count - p_so;
7714 if (topline > y)
7715 topline = y;
7718 if (topline < 1)
7719 topline = 1;
7721 else
7723 topline = 1;
7728 * set all scrollbind windows to the same topline
7730 wp = curwin;
7731 for (curwin = firstwin; curwin; curwin = curwin->w_next)
7733 if (curwin->w_p_scb)
7735 y = topline - curwin->w_topline;
7736 if (y > 0)
7737 scrollup(y, TRUE);
7738 else
7739 scrolldown(-y, TRUE);
7740 curwin->w_scbind_pos = topline;
7741 redraw_later(VALID);
7742 cursor_correct();
7743 #ifdef FEAT_WINDOWS
7744 curwin->w_redr_status = TRUE;
7745 #endif
7748 curwin = wp;
7749 if (curwin->w_p_scb)
7751 did_syncbind = TRUE;
7752 checkpcmark();
7753 if (old_linenr != curwin->w_cursor.lnum)
7755 char_u ctrl_o[2];
7757 ctrl_o[0] = Ctrl_O;
7758 ctrl_o[1] = 0;
7759 ins_typebuf(ctrl_o, REMAP_NONE, 0, TRUE, FALSE);
7762 #endif
7766 static void
7767 ex_read(eap)
7768 exarg_T *eap;
7770 int i;
7771 int empty = (curbuf->b_ml.ml_flags & ML_EMPTY);
7772 linenr_T lnum;
7774 if (eap->usefilter) /* :r!cmd */
7775 do_bang(1, eap, FALSE, FALSE, TRUE);
7776 else
7778 if (u_save(eap->line2, (linenr_T)(eap->line2 + 1)) == FAIL)
7779 return;
7781 #ifdef FEAT_BROWSE
7782 if (cmdmod.browse)
7784 char_u *browseFile;
7786 browseFile = do_browse(0, (char_u *)_("Append File"), eap->arg,
7787 NULL, NULL, NULL, curbuf);
7788 if (browseFile != NULL)
7790 i = readfile(browseFile, NULL,
7791 eap->line2, (linenr_T)0, (linenr_T)MAXLNUM, eap, 0);
7792 vim_free(browseFile);
7794 else
7795 i = OK;
7797 else
7798 #endif
7799 if (*eap->arg == NUL)
7801 if (check_fname() == FAIL) /* check for no file name */
7802 return;
7803 i = readfile(curbuf->b_ffname, curbuf->b_fname,
7804 eap->line2, (linenr_T)0, (linenr_T)MAXLNUM, eap, 0);
7806 else
7808 if (vim_strchr(p_cpo, CPO_ALTREAD) != NULL)
7809 (void)setaltfname(eap->arg, eap->arg, (linenr_T)1);
7810 i = readfile(eap->arg, NULL,
7811 eap->line2, (linenr_T)0, (linenr_T)MAXLNUM, eap, 0);
7814 if (i == FAIL)
7816 #if defined(FEAT_AUTOCMD) && defined(FEAT_EVAL)
7817 if (!aborting())
7818 #endif
7819 EMSG2(_(e_notopen), eap->arg);
7821 else
7823 if (empty && exmode_active)
7825 /* Delete the empty line that remains. Historically ex does
7826 * this but vi doesn't. */
7827 if (eap->line2 == 0)
7828 lnum = curbuf->b_ml.ml_line_count;
7829 else
7830 lnum = 1;
7831 if (*ml_get(lnum) == NUL && u_savedel(lnum, 1L) == OK)
7833 ml_delete(lnum, FALSE);
7834 deleted_lines_mark(lnum, 1L);
7835 if (curwin->w_cursor.lnum > 1
7836 && curwin->w_cursor.lnum >= lnum)
7837 --curwin->w_cursor.lnum;
7840 redraw_curbuf_later(VALID);
7845 static char_u *prev_dir = NULL;
7847 #if defined(EXITFREE) || defined(PROTO)
7848 void
7849 free_cd_dir()
7851 vim_free(prev_dir);
7852 prev_dir = NULL;
7854 vim_free(globaldir);
7855 globaldir = NULL;
7857 #endif
7861 * ":cd", ":lcd", ":chdir" and ":lchdir".
7863 void
7864 ex_cd(eap)
7865 exarg_T *eap;
7867 char_u *new_dir;
7868 char_u *tofree;
7870 new_dir = eap->arg;
7871 #if !defined(UNIX) && !defined(VMS)
7872 /* for non-UNIX ":cd" means: print current directory */
7873 if (*new_dir == NUL)
7874 ex_pwd(NULL);
7875 else
7876 #endif
7878 #ifdef FEAT_AUTOCMD
7879 if (allbuf_locked())
7880 return;
7881 #endif
7882 if (vim_strchr(p_cpo, CPO_CHDIR) != NULL && curbufIsChanged()
7883 && !eap->forceit)
7885 EMSG(_("E747: Cannot change directory, buffer is modified (add ! to override)"));
7886 return;
7889 /* ":cd -": Change to previous directory */
7890 if (STRCMP(new_dir, "-") == 0)
7892 if (prev_dir == NULL)
7894 EMSG(_("E186: No previous directory"));
7895 return;
7897 new_dir = prev_dir;
7900 /* Save current directory for next ":cd -" */
7901 tofree = prev_dir;
7902 if (mch_dirname(NameBuff, MAXPATHL) == OK)
7903 prev_dir = vim_strsave(NameBuff);
7904 else
7905 prev_dir = NULL;
7907 #if defined(UNIX) || defined(VMS)
7908 /* for UNIX ":cd" means: go to home directory */
7909 if (*new_dir == NUL)
7911 /* use NameBuff for home directory name */
7912 # ifdef VMS
7913 char_u *p;
7915 p = mch_getenv((char_u *)"SYS$LOGIN");
7916 if (p == NULL || *p == NUL) /* empty is the same as not set */
7917 NameBuff[0] = NUL;
7918 else
7919 vim_strncpy(NameBuff, p, MAXPATHL - 1);
7920 # else
7921 expand_env((char_u *)"$HOME", NameBuff, MAXPATHL);
7922 # endif
7923 new_dir = NameBuff;
7925 #endif
7926 if (new_dir == NULL || vim_chdir(new_dir))
7927 EMSG(_(e_failed));
7928 else
7930 vim_free(curwin->w_localdir);
7931 if (eap->cmdidx == CMD_lcd || eap->cmdidx == CMD_lchdir)
7933 /* If still in global directory, need to remember current
7934 * directory as global directory. */
7935 if (globaldir == NULL && prev_dir != NULL)
7936 globaldir = vim_strsave(prev_dir);
7937 /* Remember this local directory for the window. */
7938 if (mch_dirname(NameBuff, MAXPATHL) == OK)
7939 curwin->w_localdir = vim_strsave(NameBuff);
7941 else
7943 /* We are now in the global directory, no need to remember its
7944 * name. */
7945 vim_free(globaldir);
7946 globaldir = NULL;
7947 curwin->w_localdir = NULL;
7950 shorten_fnames(TRUE);
7952 /* Echo the new current directory if the command was typed. */
7953 if (KeyTyped)
7954 ex_pwd(eap);
7956 vim_free(tofree);
7961 * ":pwd".
7963 /*ARGSUSED*/
7964 static void
7965 ex_pwd(eap)
7966 exarg_T *eap;
7968 if (mch_dirname(NameBuff, MAXPATHL) == OK)
7970 #ifdef BACKSLASH_IN_FILENAME
7971 slash_adjust(NameBuff);
7972 #endif
7973 msg(NameBuff);
7975 else
7976 EMSG(_("E187: Unknown"));
7980 * ":=".
7982 static void
7983 ex_equal(eap)
7984 exarg_T *eap;
7986 smsg((char_u *)"%ld", (long)eap->line2);
7987 ex_may_print(eap);
7990 static void
7991 ex_sleep(eap)
7992 exarg_T *eap;
7994 int n;
7995 long len;
7997 if (cursor_valid())
7999 n = W_WINROW(curwin) + curwin->w_wrow - msg_scrolled;
8000 if (n >= 0)
8001 windgoto((int)n, curwin->w_wcol);
8004 len = eap->line2;
8005 switch (*eap->arg)
8007 case 'm': break;
8008 case NUL: len *= 1000L; break;
8009 default: EMSG2(_(e_invarg2), eap->arg); return;
8011 do_sleep(len);
8015 * Sleep for "msec" milliseconds, but keep checking for a CTRL-C every second.
8017 void
8018 do_sleep(msec)
8019 long msec;
8021 long done;
8023 cursor_on();
8024 out_flush();
8025 for (done = 0; !got_int && done < msec; done += 1000L)
8027 ui_delay(msec - done > 1000L ? 1000L : msec - done, TRUE);
8028 ui_breakcheck();
8032 static void
8033 do_exmap(eap, isabbrev)
8034 exarg_T *eap;
8035 int isabbrev;
8037 int mode;
8038 char_u *cmdp;
8040 cmdp = eap->cmd;
8041 mode = get_map_mode(&cmdp, eap->forceit || isabbrev);
8043 switch (do_map((*cmdp == 'n') ? 2 : (*cmdp == 'u'),
8044 eap->arg, mode, isabbrev))
8046 case 1: EMSG(_(e_invarg));
8047 break;
8048 case 2: EMSG(isabbrev ? _(e_noabbr) : _(e_nomap));
8049 break;
8054 * ":winsize" command (obsolete).
8056 static void
8057 ex_winsize(eap)
8058 exarg_T *eap;
8060 int w, h;
8061 char_u *arg = eap->arg;
8062 char_u *p;
8064 w = getdigits(&arg);
8065 arg = skipwhite(arg);
8066 p = arg;
8067 h = getdigits(&arg);
8068 if (*p != NUL && *arg == NUL)
8069 set_shellsize(w, h, TRUE);
8070 else
8071 EMSG(_("E465: :winsize requires two number arguments"));
8074 #ifdef FEAT_WINDOWS
8075 static void
8076 ex_wincmd(eap)
8077 exarg_T *eap;
8079 int xchar = NUL;
8080 char_u *p;
8082 if (*eap->arg == 'g' || *eap->arg == Ctrl_G)
8084 /* CTRL-W g and CTRL-W CTRL-G have an extra command character */
8085 if (eap->arg[1] == NUL)
8087 EMSG(_(e_invarg));
8088 return;
8090 xchar = eap->arg[1];
8091 p = eap->arg + 2;
8093 else
8094 p = eap->arg + 1;
8096 eap->nextcmd = check_nextcmd(p);
8097 p = skipwhite(p);
8098 if (*p != NUL && *p != '"' && eap->nextcmd == NULL)
8099 EMSG(_(e_invarg));
8100 else
8102 /* Pass flags on for ":vertical wincmd ]". */
8103 postponed_split_flags = cmdmod.split;
8104 postponed_split_tab = cmdmod.tab;
8105 do_window(*eap->arg, eap->addr_count > 0 ? eap->line2 : 0L, xchar);
8106 postponed_split_flags = 0;
8107 postponed_split_tab = 0;
8110 #endif
8112 #if defined(FEAT_GUI) || defined(UNIX) || defined(VMS) || defined(MSWIN)
8114 * ":winpos".
8116 static void
8117 ex_winpos(eap)
8118 exarg_T *eap;
8120 int x, y;
8121 char_u *arg = eap->arg;
8122 char_u *p;
8124 if (*arg == NUL)
8126 # if defined(FEAT_GUI) || defined(MSWIN)
8127 # ifdef FEAT_GUI
8128 if (gui.in_use && gui_mch_get_winpos(&x, &y) != FAIL)
8129 # else
8130 if (mch_get_winpos(&x, &y) != FAIL)
8131 # endif
8133 sprintf((char *)IObuff, _("Window position: X %d, Y %d"), x, y);
8134 msg(IObuff);
8136 else
8137 # endif
8138 EMSG(_("E188: Obtaining window position not implemented for this platform"));
8140 else
8142 x = getdigits(&arg);
8143 arg = skipwhite(arg);
8144 p = arg;
8145 y = getdigits(&arg);
8146 if (*p == NUL || *arg != NUL)
8148 EMSG(_("E466: :winpos requires two number arguments"));
8149 return;
8151 # ifdef FEAT_GUI
8152 if (gui.in_use)
8153 gui_mch_set_winpos(x, y);
8154 else if (gui.starting)
8156 /* Remember the coordinates for when the window is opened. */
8157 gui_win_x = x;
8158 gui_win_y = y;
8160 # ifdef HAVE_TGETENT
8161 else
8162 # endif
8163 # else
8164 # ifdef MSWIN
8165 mch_set_winpos(x, y);
8166 # endif
8167 # endif
8168 # ifdef HAVE_TGETENT
8169 if (*T_CWP)
8170 term_set_winpos(x, y);
8171 # endif
8174 #endif
8177 * Handle command that work like operators: ":delete", ":yank", ":>" and ":<".
8179 static void
8180 ex_operators(eap)
8181 exarg_T *eap;
8183 oparg_T oa;
8185 clear_oparg(&oa);
8186 oa.regname = eap->regname;
8187 oa.start.lnum = eap->line1;
8188 oa.end.lnum = eap->line2;
8189 oa.line_count = eap->line2 - eap->line1 + 1;
8190 oa.motion_type = MLINE;
8191 #ifdef FEAT_VIRTUALEDIT
8192 virtual_op = FALSE;
8193 #endif
8194 if (eap->cmdidx != CMD_yank) /* position cursor for undo */
8196 setpcmark();
8197 curwin->w_cursor.lnum = eap->line1;
8198 beginline(BL_SOL | BL_FIX);
8201 switch (eap->cmdidx)
8203 case CMD_delete:
8204 oa.op_type = OP_DELETE;
8205 op_delete(&oa);
8206 break;
8208 case CMD_yank:
8209 oa.op_type = OP_YANK;
8210 (void)op_yank(&oa, FALSE, TRUE);
8211 break;
8213 default: /* CMD_rshift or CMD_lshift */
8214 if ((eap->cmdidx == CMD_rshift)
8215 #ifdef FEAT_RIGHTLEFT
8216 ^ curwin->w_p_rl
8217 #endif
8219 oa.op_type = OP_RSHIFT;
8220 else
8221 oa.op_type = OP_LSHIFT;
8222 op_shift(&oa, FALSE, eap->amount);
8223 break;
8225 #ifdef FEAT_VIRTUALEDIT
8226 virtual_op = MAYBE;
8227 #endif
8228 ex_may_print(eap);
8232 * ":put".
8234 static void
8235 ex_put(eap)
8236 exarg_T *eap;
8238 /* ":0put" works like ":1put!". */
8239 if (eap->line2 == 0)
8241 eap->line2 = 1;
8242 eap->forceit = TRUE;
8244 curwin->w_cursor.lnum = eap->line2;
8245 do_put(eap->regname, eap->forceit ? BACKWARD : FORWARD, 1L,
8246 PUT_LINE|PUT_CURSLINE);
8250 * Handle ":copy" and ":move".
8252 static void
8253 ex_copymove(eap)
8254 exarg_T *eap;
8256 long n;
8258 n = get_address(&eap->arg, FALSE, FALSE);
8259 if (eap->arg == NULL) /* error detected */
8261 eap->nextcmd = NULL;
8262 return;
8264 get_flags(eap);
8267 * move or copy lines from 'eap->line1'-'eap->line2' to below line 'n'
8269 if (n == MAXLNUM || n < 0 || n > curbuf->b_ml.ml_line_count)
8271 EMSG(_(e_invaddr));
8272 return;
8275 if (eap->cmdidx == CMD_move)
8277 if (do_move(eap->line1, eap->line2, n) == FAIL)
8278 return;
8280 else
8281 ex_copy(eap->line1, eap->line2, n);
8282 u_clearline();
8283 beginline(BL_SOL | BL_FIX);
8284 ex_may_print(eap);
8288 * Print the current line if flags were given to the Ex command.
8290 static void
8291 ex_may_print(eap)
8292 exarg_T *eap;
8294 if (eap->flags != 0)
8296 print_line(curwin->w_cursor.lnum, (eap->flags & EXFLAG_NR),
8297 (eap->flags & EXFLAG_LIST));
8298 ex_no_reprint = TRUE;
8303 * ":smagic" and ":snomagic".
8305 static void
8306 ex_submagic(eap)
8307 exarg_T *eap;
8309 int magic_save = p_magic;
8311 p_magic = (eap->cmdidx == CMD_smagic);
8312 do_sub(eap);
8313 p_magic = magic_save;
8317 * ":join".
8319 static void
8320 ex_join(eap)
8321 exarg_T *eap;
8323 curwin->w_cursor.lnum = eap->line1;
8324 if (eap->line1 == eap->line2)
8326 if (eap->addr_count >= 2) /* :2,2join does nothing */
8327 return;
8328 if (eap->line2 == curbuf->b_ml.ml_line_count)
8330 beep_flush();
8331 return;
8333 ++eap->line2;
8335 do_do_join(eap->line2 - eap->line1 + 1, !eap->forceit);
8336 beginline(BL_WHITE | BL_FIX);
8337 ex_may_print(eap);
8341 * ":[addr]@r" or ":[addr]*r": execute register
8343 static void
8344 ex_at(eap)
8345 exarg_T *eap;
8347 int c;
8349 curwin->w_cursor.lnum = eap->line2;
8351 #ifdef USE_ON_FLY_SCROLL
8352 dont_scroll = TRUE; /* disallow scrolling here */
8353 #endif
8355 /* get the register name. No name means to use the previous one */
8356 c = *eap->arg;
8357 if (c == NUL || (c == '*' && *eap->cmd == '*'))
8358 c = '@';
8359 /* Put the register in the typeahead buffer with the "silent" flag. */
8360 if (do_execreg(c, TRUE, vim_strchr(p_cpo, CPO_EXECBUF) != NULL, TRUE)
8361 == FAIL)
8363 beep_flush();
8365 else
8367 int save_efr = exec_from_reg;
8369 exec_from_reg = TRUE;
8372 * Execute from the typeahead buffer.
8373 * Originally this didn't check for the typeahead buffer to be empty,
8374 * thus could read more Ex commands from stdin. It's not clear why,
8375 * it is certainly unexpected.
8377 while ((!stuff_empty() || typebuf.tb_len > 0) && vpeekc() == ':')
8378 (void)do_cmdline(NULL, getexline, NULL, DOCMD_NOWAIT|DOCMD_VERBOSE);
8380 exec_from_reg = save_efr;
8385 * ":!".
8387 static void
8388 ex_bang(eap)
8389 exarg_T *eap;
8391 do_bang(eap->addr_count, eap, eap->forceit, TRUE, TRUE);
8395 * ":undo".
8397 /*ARGSUSED*/
8398 static void
8399 ex_undo(eap)
8400 exarg_T *eap;
8402 if (eap->addr_count == 1) /* :undo 123 */
8403 undo_time(eap->line2, FALSE, TRUE);
8404 else
8405 u_undo(1);
8409 * ":redo".
8411 /*ARGSUSED*/
8412 static void
8413 ex_redo(eap)
8414 exarg_T *eap;
8416 u_redo(1);
8420 * ":earlier" and ":later".
8422 /*ARGSUSED*/
8423 static void
8424 ex_later(eap)
8425 exarg_T *eap;
8427 long count = 0;
8428 int sec = FALSE;
8429 char_u *p = eap->arg;
8431 if (*p == NUL)
8432 count = 1;
8433 else if (isdigit(*p))
8435 count = getdigits(&p);
8436 switch (*p)
8438 case 's': ++p; sec = TRUE; break;
8439 case 'm': ++p; sec = TRUE; count *= 60; break;
8440 case 'h': ++p; sec = TRUE; count *= 60 * 60; break;
8444 if (*p != NUL)
8445 EMSG2(_(e_invarg2), eap->arg);
8446 else
8447 undo_time(eap->cmdidx == CMD_earlier ? -count : count, sec, FALSE);
8451 * ":redir": start/stop redirection.
8453 static void
8454 ex_redir(eap)
8455 exarg_T *eap;
8457 char *mode;
8458 char_u *fname;
8459 char_u *arg = eap->arg;
8461 if (STRICMP(eap->arg, "END") == 0)
8462 close_redir();
8463 else
8465 if (*arg == '>')
8467 ++arg;
8468 if (*arg == '>')
8470 ++arg;
8471 mode = "a";
8473 else
8474 mode = "w";
8475 arg = skipwhite(arg);
8477 close_redir();
8479 /* Expand environment variables and "~/". */
8480 fname = expand_env_save(arg);
8481 if (fname == NULL)
8482 return;
8483 #ifdef FEAT_BROWSE
8484 if (cmdmod.browse)
8486 char_u *browseFile;
8488 browseFile = do_browse(BROWSE_SAVE,
8489 (char_u *)_("Save Redirection"),
8490 fname, NULL, NULL, BROWSE_FILTER_ALL_FILES, curbuf);
8491 if (browseFile == NULL)
8492 return; /* operation cancelled */
8493 vim_free(fname);
8494 fname = browseFile;
8495 eap->forceit = TRUE; /* since dialog already asked */
8497 #endif
8499 redir_fd = open_exfile(fname, eap->forceit, mode);
8500 vim_free(fname);
8502 #ifdef FEAT_EVAL
8503 else if (*arg == '@')
8505 /* redirect to a register a-z (resp. A-Z for appending) */
8506 close_redir();
8507 ++arg;
8508 if (ASCII_ISALPHA(*arg)
8509 # ifdef FEAT_CLIPBOARD
8510 || *arg == '*'
8511 || *arg == '+'
8512 # endif
8513 || *arg == '"')
8515 redir_reg = *arg++;
8516 if (*arg == '>' && arg[1] == '>') /* append */
8517 arg += 2;
8518 else
8520 /* Can use both "@a" and "@a>". */
8521 if (*arg == '>')
8522 arg++;
8523 /* Make register empty when not using @A-@Z and the
8524 * command is valid. */
8525 if (*arg == NUL && !isupper(redir_reg))
8526 write_reg_contents(redir_reg, (char_u *)"", -1, FALSE);
8529 if (*arg != NUL)
8531 redir_reg = 0;
8532 EMSG2(_(e_invarg2), eap->arg);
8535 else if (*arg == '=' && arg[1] == '>')
8537 int append;
8539 /* redirect to a variable */
8540 close_redir();
8541 arg += 2;
8543 if (*arg == '>')
8545 ++arg;
8546 append = TRUE;
8548 else
8549 append = FALSE;
8551 if (var_redir_start(skipwhite(arg), append) == OK)
8552 redir_vname = 1;
8554 #endif
8556 /* TODO: redirect to a buffer */
8558 else
8559 EMSG2(_(e_invarg2), eap->arg);
8562 /* Make sure redirection is not off. Can happen for cmdline completion
8563 * that indirectly invokes a command to catch its output. */
8564 if (redir_fd != NULL
8565 #ifdef FEAT_EVAL
8566 || redir_reg || redir_vname
8567 #endif
8569 redir_off = FALSE;
8573 * ":redraw": force redraw
8575 static void
8576 ex_redraw(eap)
8577 exarg_T *eap;
8579 int r = RedrawingDisabled;
8580 int p = p_lz;
8582 RedrawingDisabled = 0;
8583 p_lz = FALSE;
8584 update_topline();
8585 update_screen(eap->forceit ? CLEAR :
8586 #ifdef FEAT_VISUAL
8587 VIsual_active ? INVERTED :
8588 #endif
8590 #ifdef FEAT_TITLE
8591 if (need_maketitle)
8592 maketitle();
8593 #endif
8594 RedrawingDisabled = r;
8595 p_lz = p;
8597 /* Reset msg_didout, so that a message that's there is overwritten. */
8598 msg_didout = FALSE;
8599 msg_col = 0;
8601 out_flush();
8605 * ":redrawstatus": force redraw of status line(s)
8607 /*ARGSUSED*/
8608 static void
8609 ex_redrawstatus(eap)
8610 exarg_T *eap;
8612 #if defined(FEAT_WINDOWS)
8613 int r = RedrawingDisabled;
8614 int p = p_lz;
8616 RedrawingDisabled = 0;
8617 p_lz = FALSE;
8618 if (eap->forceit)
8619 status_redraw_all();
8620 else
8621 status_redraw_curbuf();
8622 update_screen(
8623 # ifdef FEAT_VISUAL
8624 VIsual_active ? INVERTED :
8625 # endif
8627 RedrawingDisabled = r;
8628 p_lz = p;
8629 out_flush();
8630 #endif
8633 static void
8634 close_redir()
8636 if (redir_fd != NULL)
8638 fclose(redir_fd);
8639 redir_fd = NULL;
8641 #ifdef FEAT_EVAL
8642 redir_reg = 0;
8643 if (redir_vname)
8645 var_redir_stop();
8646 redir_vname = 0;
8648 #endif
8651 #if defined(FEAT_SESSION) && defined(USE_CRNL)
8652 # define MKSESSION_NL
8653 static int mksession_nl = FALSE; /* use NL only in put_eol() */
8654 #endif
8657 * ":mkexrc", ":mkvimrc", ":mkview" and ":mksession".
8659 static void
8660 ex_mkrc(eap)
8661 exarg_T *eap;
8663 FILE *fd;
8664 int failed = FALSE;
8665 char_u *fname;
8666 #ifdef FEAT_BROWSE
8667 char_u *browseFile = NULL;
8668 #endif
8669 #ifdef FEAT_SESSION
8670 int view_session = FALSE;
8671 int using_vdir = FALSE; /* using 'viewdir'? */
8672 char_u *viewFile = NULL;
8673 unsigned *flagp;
8674 #endif
8676 if (eap->cmdidx == CMD_mksession || eap->cmdidx == CMD_mkview)
8678 #ifdef FEAT_SESSION
8679 view_session = TRUE;
8680 #else
8681 ex_ni(eap);
8682 return;
8683 #endif
8686 #ifdef FEAT_SESSION
8687 did_lcd = FALSE;
8689 /* ":mkview" or ":mkview 9": generate file name with 'viewdir' */
8690 if (eap->cmdidx == CMD_mkview
8691 && (*eap->arg == NUL
8692 || (vim_isdigit(*eap->arg) && eap->arg[1] == NUL)))
8694 eap->forceit = TRUE;
8695 fname = get_view_file(*eap->arg);
8696 if (fname == NULL)
8697 return;
8698 viewFile = fname;
8699 using_vdir = TRUE;
8701 else
8702 #endif
8703 if (*eap->arg != NUL)
8704 fname = eap->arg;
8705 else if (eap->cmdidx == CMD_mkvimrc)
8706 fname = (char_u *)VIMRC_FILE;
8707 #ifdef FEAT_SESSION
8708 else if (eap->cmdidx == CMD_mksession)
8709 fname = (char_u *)SESSION_FILE;
8710 #endif
8711 else
8712 fname = (char_u *)EXRC_FILE;
8714 #ifdef FEAT_BROWSE
8715 if (cmdmod.browse)
8717 browseFile = do_browse(BROWSE_SAVE,
8718 # ifdef FEAT_SESSION
8719 eap->cmdidx == CMD_mkview ? (char_u *)_("Save View") :
8720 eap->cmdidx == CMD_mksession ? (char_u *)_("Save Session") :
8721 # endif
8722 (char_u *)_("Save Setup"),
8723 fname, (char_u *)"vim", NULL, BROWSE_FILTER_MACROS, NULL);
8724 if (browseFile == NULL)
8725 goto theend;
8726 fname = browseFile;
8727 eap->forceit = TRUE; /* since dialog already asked */
8729 #endif
8731 #if defined(FEAT_SESSION) && defined(vim_mkdir)
8732 /* When using 'viewdir' may have to create the directory. */
8733 if (using_vdir && !mch_isdir(p_vdir))
8734 vim_mkdir_emsg(p_vdir, 0755);
8735 #endif
8737 fd = open_exfile(fname, eap->forceit, WRITEBIN);
8738 if (fd != NULL)
8740 #ifdef FEAT_SESSION
8741 if (eap->cmdidx == CMD_mkview)
8742 flagp = &vop_flags;
8743 else
8744 flagp = &ssop_flags;
8745 #endif
8747 #ifdef MKSESSION_NL
8748 /* "unix" in 'sessionoptions': use NL line separator */
8749 if (view_session && (*flagp & SSOP_UNIX))
8750 mksession_nl = TRUE;
8751 #endif
8753 /* Write the version command for :mkvimrc */
8754 if (eap->cmdidx == CMD_mkvimrc)
8755 (void)put_line(fd, "version 6.0");
8757 #ifdef FEAT_SESSION
8758 if (eap->cmdidx == CMD_mksession)
8760 if (put_line(fd, "let SessionLoad = 1") == FAIL)
8761 failed = TRUE;
8764 if (eap->cmdidx != CMD_mkview)
8765 #endif
8767 /* Write setting 'compatible' first, because it has side effects.
8768 * For that same reason only do it when needed. */
8769 if (p_cp)
8770 (void)put_line(fd, "if !&cp | set cp | endif");
8771 else
8772 (void)put_line(fd, "if &cp | set nocp | endif");
8775 #ifdef FEAT_SESSION
8776 if (!view_session
8777 || (eap->cmdidx == CMD_mksession
8778 && (*flagp & SSOP_OPTIONS)))
8779 #endif
8780 failed |= (makemap(fd, NULL) == FAIL
8781 || makeset(fd, OPT_GLOBAL, FALSE) == FAIL);
8783 #ifdef FEAT_SESSION
8784 if (!failed && view_session)
8786 if (put_line(fd, "let s:so_save = &so | let s:siso_save = &siso | set so=0 siso=0") == FAIL)
8787 failed = TRUE;
8788 if (eap->cmdidx == CMD_mksession)
8790 char_u dirnow[MAXPATHL]; /* current directory */
8793 * Change to session file's dir.
8795 if (mch_dirname(dirnow, MAXPATHL) == FAIL
8796 || mch_chdir((char *)dirnow) != 0)
8797 *dirnow = NUL;
8798 if (*dirnow != NUL && (ssop_flags & SSOP_SESDIR))
8800 if (vim_chdirfile(fname) == OK)
8801 shorten_fnames(TRUE);
8803 else if (*dirnow != NUL
8804 && (ssop_flags & SSOP_CURDIR) && globaldir != NULL)
8806 if (mch_chdir((char *)globaldir) == 0)
8807 shorten_fnames(TRUE);
8810 failed |= (makeopens(fd, dirnow) == FAIL);
8812 /* restore original dir */
8813 if (*dirnow != NUL && ((ssop_flags & SSOP_SESDIR)
8814 || ((ssop_flags & SSOP_CURDIR) && globaldir != NULL)))
8816 if (mch_chdir((char *)dirnow) != 0)
8817 EMSG(_(e_prev_dir));
8818 shorten_fnames(TRUE);
8821 else
8823 failed |= (put_view(fd, curwin, !using_vdir, flagp,
8824 -1) == FAIL);
8826 if (put_line(fd, "let &so = s:so_save | let &siso = s:siso_save")
8827 == FAIL)
8828 failed = TRUE;
8829 if (put_line(fd, "doautoall SessionLoadPost") == FAIL)
8830 failed = TRUE;
8831 if (eap->cmdidx == CMD_mksession)
8833 if (put_line(fd, "unlet SessionLoad") == FAIL)
8834 failed = TRUE;
8837 #endif
8838 if (put_line(fd, "\" vim: set ft=vim :") == FAIL)
8839 failed = TRUE;
8841 failed |= fclose(fd);
8843 if (failed)
8844 EMSG(_(e_write));
8845 #if defined(FEAT_EVAL) && defined(FEAT_SESSION)
8846 else if (eap->cmdidx == CMD_mksession)
8848 /* successful session write - set this_session var */
8849 char_u tbuf[MAXPATHL];
8851 if (vim_FullName(fname, tbuf, MAXPATHL, FALSE) == OK)
8852 set_vim_var_string(VV_THIS_SESSION, tbuf, -1);
8854 #endif
8855 #ifdef MKSESSION_NL
8856 mksession_nl = FALSE;
8857 #endif
8860 #ifdef FEAT_BROWSE
8861 theend:
8862 vim_free(browseFile);
8863 #endif
8864 #ifdef FEAT_SESSION
8865 vim_free(viewFile);
8866 #endif
8869 #if ((defined(FEAT_SESSION) || defined(FEAT_EVAL)) && defined(vim_mkdir)) \
8870 || defined(PROTO)
8871 /*ARGSUSED*/
8873 vim_mkdir_emsg(name, prot)
8874 char_u *name;
8875 int prot;
8877 if (vim_mkdir(name, prot) != 0)
8879 EMSG2(_("E739: Cannot create directory: %s"), name);
8880 return FAIL;
8882 return OK;
8884 #endif
8887 * Open a file for writing for an Ex command, with some checks.
8888 * Return file descriptor, or NULL on failure.
8890 FILE *
8891 open_exfile(fname, forceit, mode)
8892 char_u *fname;
8893 int forceit;
8894 char *mode; /* "w" for create new file or "a" for append */
8896 FILE *fd;
8898 #ifdef UNIX
8899 /* with Unix it is possible to open a directory */
8900 if (mch_isdir(fname))
8902 EMSG2(_(e_isadir2), fname);
8903 return NULL;
8905 #endif
8906 if (!forceit && *mode != 'a' && vim_fexists(fname))
8908 EMSG2(_("E189: \"%s\" exists (add ! to override)"), fname);
8909 return NULL;
8912 if ((fd = mch_fopen((char *)fname, mode)) == NULL)
8913 EMSG2(_("E190: Cannot open \"%s\" for writing"), fname);
8915 return fd;
8919 * ":mark" and ":k".
8921 static void
8922 ex_mark(eap)
8923 exarg_T *eap;
8925 pos_T pos;
8927 if (*eap->arg == NUL) /* No argument? */
8928 EMSG(_(e_argreq));
8929 else if (eap->arg[1] != NUL) /* more than one character? */
8930 EMSG(_(e_trailing));
8931 else
8933 pos = curwin->w_cursor; /* save curwin->w_cursor */
8934 curwin->w_cursor.lnum = eap->line2;
8935 beginline(BL_WHITE | BL_FIX);
8936 if (setmark(*eap->arg) == FAIL) /* set mark */
8937 EMSG(_("E191: Argument must be a letter or forward/backward quote"));
8938 curwin->w_cursor = pos; /* restore curwin->w_cursor */
8943 * Update w_topline, w_leftcol and the cursor position.
8945 void
8946 update_topline_cursor()
8948 check_cursor(); /* put cursor on valid line */
8949 update_topline();
8950 if (!curwin->w_p_wrap)
8951 validate_cursor();
8952 update_curswant();
8955 #ifdef FEAT_EX_EXTRA
8957 * ":normal[!] {commands}": Execute normal mode commands.
8959 static void
8960 ex_normal(eap)
8961 exarg_T *eap;
8963 int save_msg_scroll = msg_scroll;
8964 int save_restart_edit = restart_edit;
8965 int save_msg_didout = msg_didout;
8966 int save_State = State;
8967 tasave_T tabuf;
8968 int save_insertmode = p_im;
8969 int save_finish_op = finish_op;
8970 int save_opcount = opcount;
8971 #ifdef FEAT_MBYTE
8972 char_u *arg = NULL;
8973 int l;
8974 char_u *p;
8975 #endif
8977 if (ex_normal_lock > 0)
8979 EMSG(_(e_secure));
8980 return;
8982 if (ex_normal_busy >= p_mmd)
8984 EMSG(_("E192: Recursive use of :normal too deep"));
8985 return;
8987 ++ex_normal_busy;
8989 msg_scroll = FALSE; /* no msg scrolling in Normal mode */
8990 restart_edit = 0; /* don't go to Insert mode */
8991 p_im = FALSE; /* don't use 'insertmode' */
8993 #ifdef FEAT_MBYTE
8995 * vgetc() expects a CSI and K_SPECIAL to have been escaped. Don't do
8996 * this for the K_SPECIAL leading byte, otherwise special keys will not
8997 * work.
8999 if (has_mbyte)
9001 int len = 0;
9003 /* Count the number of characters to be escaped. */
9004 for (p = eap->arg; *p != NUL; ++p)
9006 # ifdef FEAT_GUI
9007 if (*p == CSI) /* leadbyte CSI */
9008 len += 2;
9009 # endif
9010 for (l = (*mb_ptr2len)(p) - 1; l > 0; --l)
9011 if (*++p == K_SPECIAL /* trailbyte K_SPECIAL or CSI */
9012 # ifdef FEAT_GUI
9013 || *p == CSI
9014 # endif
9016 len += 2;
9018 if (len > 0)
9020 arg = alloc((unsigned)(STRLEN(eap->arg) + len + 1));
9021 if (arg != NULL)
9023 len = 0;
9024 for (p = eap->arg; *p != NUL; ++p)
9026 arg[len++] = *p;
9027 # ifdef FEAT_GUI
9028 if (*p == CSI)
9030 arg[len++] = KS_EXTRA;
9031 arg[len++] = (int)KE_CSI;
9033 # endif
9034 for (l = (*mb_ptr2len)(p) - 1; l > 0; --l)
9036 arg[len++] = *++p;
9037 if (*p == K_SPECIAL)
9039 arg[len++] = KS_SPECIAL;
9040 arg[len++] = KE_FILLER;
9042 # ifdef FEAT_GUI
9043 else if (*p == CSI)
9045 arg[len++] = KS_EXTRA;
9046 arg[len++] = (int)KE_CSI;
9048 # endif
9050 arg[len] = NUL;
9055 #endif
9058 * Save the current typeahead. This is required to allow using ":normal"
9059 * from an event handler and makes sure we don't hang when the argument
9060 * ends with half a command.
9062 save_typeahead(&tabuf);
9063 if (tabuf.typebuf_valid)
9066 * Repeat the :normal command for each line in the range. When no
9067 * range given, execute it just once, without positioning the cursor
9068 * first.
9072 if (eap->addr_count != 0)
9074 curwin->w_cursor.lnum = eap->line1++;
9075 curwin->w_cursor.col = 0;
9078 exec_normal_cmd(
9079 #ifdef FEAT_MBYTE
9080 arg != NULL ? arg :
9081 #endif
9082 eap->arg, eap->forceit ? REMAP_NONE : REMAP_YES, FALSE);
9084 while (eap->addr_count > 0 && eap->line1 <= eap->line2 && !got_int);
9087 /* Might not return to the main loop when in an event handler. */
9088 update_topline_cursor();
9090 /* Restore the previous typeahead. */
9091 restore_typeahead(&tabuf);
9093 --ex_normal_busy;
9094 msg_scroll = save_msg_scroll;
9095 restart_edit = save_restart_edit;
9096 p_im = save_insertmode;
9097 finish_op = save_finish_op;
9098 opcount = save_opcount;
9099 msg_didout |= save_msg_didout; /* don't reset msg_didout now */
9101 /* Restore the state (needed when called from a function executed for
9102 * 'indentexpr'). */
9103 State = save_State;
9104 #ifdef FEAT_MBYTE
9105 vim_free(arg);
9106 #endif
9110 * ":startinsert", ":startreplace" and ":startgreplace"
9112 static void
9113 ex_startinsert(eap)
9114 exarg_T *eap;
9116 if (eap->forceit)
9118 coladvance((colnr_T)MAXCOL);
9119 curwin->w_curswant = MAXCOL;
9120 curwin->w_set_curswant = FALSE;
9123 /* Ignore the command when already in Insert mode. Inserting an
9124 * expression register that invokes a function can do this. */
9125 if (State & INSERT)
9126 return;
9128 if (eap->cmdidx == CMD_startinsert)
9129 restart_edit = 'a';
9130 else if (eap->cmdidx == CMD_startreplace)
9131 restart_edit = 'R';
9132 else
9133 restart_edit = 'V';
9135 if (!eap->forceit)
9137 if (eap->cmdidx == CMD_startinsert)
9138 restart_edit = 'i';
9139 curwin->w_curswant = 0; /* avoid MAXCOL */
9144 * ":stopinsert"
9146 /*ARGSUSED*/
9147 static void
9148 ex_stopinsert(eap)
9149 exarg_T *eap;
9151 restart_edit = 0;
9152 stop_insert_mode = TRUE;
9154 #endif
9156 #if defined(FEAT_EX_EXTRA) || defined(FEAT_MENU) || defined(PROTO)
9158 * Execute normal mode command "cmd".
9159 * "remap" can be REMAP_NONE or REMAP_YES.
9161 void
9162 exec_normal_cmd(cmd, remap, silent)
9163 char_u *cmd;
9164 int remap;
9165 int silent;
9167 oparg_T oa;
9170 * Stuff the argument into the typeahead buffer.
9171 * Execute normal_cmd() until there is no typeahead left.
9173 clear_oparg(&oa);
9174 finish_op = FALSE;
9175 ins_typebuf(cmd, remap, 0, TRUE, silent);
9176 while ((!stuff_empty() || (!typebuf_typed() && typebuf.tb_len > 0))
9177 && !got_int)
9179 update_topline_cursor();
9180 normal_cmd(&oa, FALSE); /* execute a Normal mode cmd */
9183 #endif
9185 #ifdef FEAT_FIND_ID
9186 static void
9187 ex_checkpath(eap)
9188 exarg_T *eap;
9190 find_pattern_in_path(NULL, 0, 0, FALSE, FALSE, CHECK_PATH, 1L,
9191 eap->forceit ? ACTION_SHOW_ALL : ACTION_SHOW,
9192 (linenr_T)1, (linenr_T)MAXLNUM);
9195 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
9197 * ":psearch"
9199 static void
9200 ex_psearch(eap)
9201 exarg_T *eap;
9203 g_do_tagpreview = p_pvh;
9204 ex_findpat(eap);
9205 g_do_tagpreview = 0;
9207 #endif
9209 static void
9210 ex_findpat(eap)
9211 exarg_T *eap;
9213 int whole = TRUE;
9214 long n;
9215 char_u *p;
9216 int action;
9218 switch (cmdnames[eap->cmdidx].cmd_name[2])
9220 case 'e': /* ":psearch", ":isearch" and ":dsearch" */
9221 if (cmdnames[eap->cmdidx].cmd_name[0] == 'p')
9222 action = ACTION_GOTO;
9223 else
9224 action = ACTION_SHOW;
9225 break;
9226 case 'i': /* ":ilist" and ":dlist" */
9227 action = ACTION_SHOW_ALL;
9228 break;
9229 case 'u': /* ":ijump" and ":djump" */
9230 action = ACTION_GOTO;
9231 break;
9232 default: /* ":isplit" and ":dsplit" */
9233 action = ACTION_SPLIT;
9234 break;
9237 n = 1;
9238 if (vim_isdigit(*eap->arg)) /* get count */
9240 n = getdigits(&eap->arg);
9241 eap->arg = skipwhite(eap->arg);
9243 if (*eap->arg == '/') /* Match regexp, not just whole words */
9245 whole = FALSE;
9246 ++eap->arg;
9247 p = skip_regexp(eap->arg, '/', p_magic, NULL);
9248 if (*p)
9250 *p++ = NUL;
9251 p = skipwhite(p);
9253 /* Check for trailing illegal characters */
9254 if (!ends_excmd(*p))
9255 eap->errmsg = e_trailing;
9256 else
9257 eap->nextcmd = check_nextcmd(p);
9260 if (!eap->skip)
9261 find_pattern_in_path(eap->arg, 0, (int)STRLEN(eap->arg),
9262 whole, !eap->forceit,
9263 *eap->cmd == 'd' ? FIND_DEFINE : FIND_ANY,
9264 n, action, eap->line1, eap->line2);
9266 #endif
9268 #ifdef FEAT_WINDOWS
9270 # ifdef FEAT_QUICKFIX
9272 * ":ptag", ":ptselect", ":ptjump", ":ptnext", etc.
9274 static void
9275 ex_ptag(eap)
9276 exarg_T *eap;
9278 g_do_tagpreview = p_pvh;
9279 ex_tag_cmd(eap, cmdnames[eap->cmdidx].cmd_name + 1);
9283 * ":pedit"
9285 static void
9286 ex_pedit(eap)
9287 exarg_T *eap;
9289 win_T *curwin_save = curwin;
9291 g_do_tagpreview = p_pvh;
9292 prepare_tagpreview(TRUE);
9293 keep_help_flag = curwin_save->w_buffer->b_help;
9294 do_exedit(eap, NULL);
9295 keep_help_flag = FALSE;
9296 if (curwin != curwin_save && win_valid(curwin_save))
9298 /* Return cursor to where we were */
9299 validate_cursor();
9300 redraw_later(VALID);
9301 win_enter(curwin_save, TRUE);
9303 g_do_tagpreview = 0;
9305 # endif
9308 * ":stag", ":stselect" and ":stjump".
9310 static void
9311 ex_stag(eap)
9312 exarg_T *eap;
9314 postponed_split = -1;
9315 postponed_split_flags = cmdmod.split;
9316 postponed_split_tab = cmdmod.tab;
9317 ex_tag_cmd(eap, cmdnames[eap->cmdidx].cmd_name + 1);
9318 postponed_split_flags = 0;
9319 postponed_split_tab = 0;
9321 #endif
9324 * ":tag", ":tselect", ":tjump", ":tnext", etc.
9326 static void
9327 ex_tag(eap)
9328 exarg_T *eap;
9330 ex_tag_cmd(eap, cmdnames[eap->cmdidx].cmd_name);
9333 static void
9334 ex_tag_cmd(eap, name)
9335 exarg_T *eap;
9336 char_u *name;
9338 int cmd;
9340 switch (name[1])
9342 case 'j': cmd = DT_JUMP; /* ":tjump" */
9343 break;
9344 case 's': cmd = DT_SELECT; /* ":tselect" */
9345 break;
9346 case 'p': cmd = DT_PREV; /* ":tprevious" */
9347 break;
9348 case 'N': cmd = DT_PREV; /* ":tNext" */
9349 break;
9350 case 'n': cmd = DT_NEXT; /* ":tnext" */
9351 break;
9352 case 'o': cmd = DT_POP; /* ":pop" */
9353 break;
9354 case 'f': /* ":tfirst" */
9355 case 'r': cmd = DT_FIRST; /* ":trewind" */
9356 break;
9357 case 'l': cmd = DT_LAST; /* ":tlast" */
9358 break;
9359 default: /* ":tag" */
9360 #ifdef FEAT_CSCOPE
9361 if (p_cst && *eap->arg != NUL)
9363 do_cstag(eap);
9364 return;
9366 #endif
9367 cmd = DT_TAG;
9368 break;
9371 if (name[0] == 'l')
9373 #ifndef FEAT_QUICKFIX
9374 ex_ni(eap);
9375 return;
9376 #else
9377 cmd = DT_LTAG;
9378 #endif
9381 do_tag(eap->arg, cmd, eap->addr_count > 0 ? (int)eap->line2 : 1,
9382 eap->forceit, TRUE);
9386 * Check "str" for starting with a special cmdline variable.
9387 * If found return one of the SPEC_ values and set "*usedlen" to the length of
9388 * the variable. Otherwise return -1 and "*usedlen" is unchanged.
9391 find_cmdline_var(src, usedlen)
9392 char_u *src;
9393 int *usedlen;
9395 int len;
9396 int i;
9397 static char *(spec_str[]) = {
9398 "%",
9399 #define SPEC_PERC 0
9400 "#",
9401 #define SPEC_HASH 1
9402 "<cword>", /* cursor word */
9403 #define SPEC_CWORD 2
9404 "<cWORD>", /* cursor WORD */
9405 #define SPEC_CCWORD 3
9406 "<cfile>", /* cursor path name */
9407 #define SPEC_CFILE 4
9408 "<sfile>", /* ":so" file name */
9409 #define SPEC_SFILE 5
9410 #ifdef FEAT_AUTOCMD
9411 "<afile>", /* autocommand file name */
9412 # define SPEC_AFILE 6
9413 "<abuf>", /* autocommand buffer number */
9414 # define SPEC_ABUF 7
9415 "<amatch>", /* autocommand match name */
9416 # define SPEC_AMATCH 8
9417 #endif
9418 #ifdef FEAT_CLIENTSERVER
9419 "<client>"
9420 # define SPEC_CLIENT 9
9421 #endif
9423 #define SPEC_COUNT (sizeof(spec_str) / sizeof(char *))
9425 for (i = 0; i < SPEC_COUNT; ++i)
9427 len = (int)STRLEN(spec_str[i]);
9428 if (STRNCMP(src, spec_str[i], len) == 0)
9430 *usedlen = len;
9431 return i;
9434 return -1;
9438 * Evaluate cmdline variables.
9440 * change '%' to curbuf->b_ffname
9441 * '#' to curwin->w_altfile
9442 * '<cword>' to word under the cursor
9443 * '<cWORD>' to WORD under the cursor
9444 * '<cfile>' to path name under the cursor
9445 * '<sfile>' to sourced file name
9446 * '<afile>' to file name for autocommand
9447 * '<abuf>' to buffer number for autocommand
9448 * '<amatch>' to matching name for autocommand
9450 * When an error is detected, "errormsg" is set to a non-NULL pointer (may be
9451 * "" for error without a message) and NULL is returned.
9452 * Returns an allocated string if a valid match was found.
9453 * Returns NULL if no match was found. "usedlen" then still contains the
9454 * number of characters to skip.
9456 char_u *
9457 eval_vars(src, srcstart, usedlen, lnump, errormsg, escaped)
9458 char_u *src; /* pointer into commandline */
9459 char_u *srcstart; /* beginning of valid memory for src */
9460 int *usedlen; /* characters after src that are used */
9461 linenr_T *lnump; /* line number for :e command, or NULL */
9462 char_u **errormsg; /* pointer to error message */
9463 int *escaped; /* return value has escaped white space (can
9464 * be NULL) */
9466 int i;
9467 char_u *s;
9468 char_u *result;
9469 char_u *resultbuf = NULL;
9470 int resultlen;
9471 buf_T *buf;
9472 int valid = VALID_HEAD + VALID_PATH; /* assume valid result */
9473 int spec_idx;
9474 #ifdef FEAT_MODIFY_FNAME
9475 int skip_mod = FALSE;
9476 #endif
9478 #if defined(FEAT_AUTOCMD) || defined(FEAT_CLIENTSERVER)
9479 char_u strbuf[30];
9480 #endif
9482 *errormsg = NULL;
9483 if (escaped != NULL)
9484 *escaped = FALSE;
9487 * Check if there is something to do.
9489 spec_idx = find_cmdline_var(src, usedlen);
9490 if (spec_idx < 0) /* no match */
9492 *usedlen = 1;
9493 return NULL;
9497 * Skip when preceded with a backslash "\%" and "\#".
9498 * Note: In "\\%" the % is also not recognized!
9500 if (src > srcstart && src[-1] == '\\')
9502 *usedlen = 0;
9503 STRMOVE(src - 1, src); /* remove backslash */
9504 return NULL;
9508 * word or WORD under cursor
9510 if (spec_idx == SPEC_CWORD || spec_idx == SPEC_CCWORD)
9512 resultlen = find_ident_under_cursor(&result, spec_idx == SPEC_CWORD ?
9513 (FIND_IDENT|FIND_STRING) : FIND_STRING);
9514 if (resultlen == 0)
9516 *errormsg = (char_u *)"";
9517 return NULL;
9522 * '#': Alternate file name
9523 * '%': Current file name
9524 * File name under the cursor
9525 * File name for autocommand
9526 * and following modifiers
9528 else
9530 switch (spec_idx)
9532 case SPEC_PERC: /* '%': current file */
9533 if (curbuf->b_fname == NULL)
9535 result = (char_u *)"";
9536 valid = 0; /* Must have ":p:h" to be valid */
9538 else
9539 #ifdef RISCOS
9540 /* Always use the full path for RISC OS if possible. */
9541 result = curbuf->b_ffname;
9542 if (result == NULL)
9543 result = curbuf->b_fname;
9544 #else
9545 result = curbuf->b_fname;
9546 #endif
9547 break;
9549 case SPEC_HASH: /* '#' or "#99": alternate file */
9550 if (src[1] == '#') /* "##": the argument list */
9552 result = arg_all();
9553 resultbuf = result;
9554 *usedlen = 2;
9555 if (escaped != NULL)
9556 *escaped = TRUE;
9557 #ifdef FEAT_MODIFY_FNAME
9558 skip_mod = TRUE;
9559 #endif
9560 break;
9562 s = src + 1;
9563 if (*s == '<') /* "#<99" uses v:oldfiles */
9564 ++s;
9565 i = (int)getdigits(&s);
9566 *usedlen = (int)(s - src); /* length of what we expand */
9568 if (src[1] == '<')
9570 if (*usedlen < 2)
9572 /* Should we give an error message for #<text? */
9573 *usedlen = 1;
9574 return NULL;
9576 #ifdef FEAT_EVAL
9577 result = list_find_str(get_vim_var_list(VV_OLDFILES),
9578 (long)i);
9579 if (result == NULL)
9581 *errormsg = (char_u *)"";
9582 return NULL;
9584 #else
9585 *errormsg = (char_u *)_("E809: #< is not available without the +eval feature");
9586 return NULL;
9587 #endif
9589 else
9591 buf = buflist_findnr(i);
9592 if (buf == NULL)
9594 *errormsg = (char_u *)_("E194: No alternate file name to substitute for '#'");
9595 return NULL;
9597 if (lnump != NULL)
9598 *lnump = ECMD_LAST;
9599 if (buf->b_fname == NULL)
9601 result = (char_u *)"";
9602 valid = 0; /* Must have ":p:h" to be valid */
9604 else
9605 result = buf->b_fname;
9607 break;
9609 #ifdef FEAT_SEARCHPATH
9610 case SPEC_CFILE: /* file name under cursor */
9611 result = file_name_at_cursor(FNAME_MESS|FNAME_HYP, 1L, NULL);
9612 if (result == NULL)
9614 *errormsg = (char_u *)"";
9615 return NULL;
9617 resultbuf = result; /* remember allocated string */
9618 break;
9619 #endif
9621 #ifdef FEAT_AUTOCMD
9622 case SPEC_AFILE: /* file name for autocommand */
9623 result = autocmd_fname;
9624 if (result != NULL && !autocmd_fname_full)
9626 /* Still need to turn the fname into a full path. It is
9627 * postponed to avoid a delay when <afile> is not used. */
9628 autocmd_fname_full = TRUE;
9629 result = FullName_save(autocmd_fname, FALSE);
9630 vim_free(autocmd_fname);
9631 autocmd_fname = result;
9633 if (result == NULL)
9635 *errormsg = (char_u *)_("E495: no autocommand file name to substitute for \"<afile>\"");
9636 return NULL;
9638 result = shorten_fname1(result);
9639 break;
9641 case SPEC_ABUF: /* buffer number for autocommand */
9642 if (autocmd_bufnr <= 0)
9644 *errormsg = (char_u *)_("E496: no autocommand buffer number to substitute for \"<abuf>\"");
9645 return NULL;
9647 sprintf((char *)strbuf, "%d", autocmd_bufnr);
9648 result = strbuf;
9649 break;
9651 case SPEC_AMATCH: /* match name for autocommand */
9652 result = autocmd_match;
9653 if (result == NULL)
9655 *errormsg = (char_u *)_("E497: no autocommand match name to substitute for \"<amatch>\"");
9656 return NULL;
9658 break;
9660 #endif
9661 case SPEC_SFILE: /* file name for ":so" command */
9662 result = sourcing_name;
9663 if (result == NULL)
9665 *errormsg = (char_u *)_("E498: no :source file name to substitute for \"<sfile>\"");
9666 return NULL;
9668 break;
9669 #if defined(FEAT_CLIENTSERVER)
9670 case SPEC_CLIENT: /* Source of last submitted input */
9671 sprintf((char *)strbuf, PRINTF_HEX_LONG_U,
9672 (long_u)clientWindow);
9673 result = strbuf;
9674 break;
9675 #endif
9678 resultlen = (int)STRLEN(result); /* length of new string */
9679 if (src[*usedlen] == '<') /* remove the file name extension */
9681 ++*usedlen;
9682 #ifdef RISCOS
9683 if ((s = vim_strrchr(result, '/')) != NULL && s >= gettail(result))
9684 #else
9685 if ((s = vim_strrchr(result, '.')) != NULL && s >= gettail(result))
9686 #endif
9687 resultlen = (int)(s - result);
9689 #ifdef FEAT_MODIFY_FNAME
9690 else if (!skip_mod)
9692 valid |= modify_fname(src, usedlen, &result, &resultbuf,
9693 &resultlen);
9694 if (result == NULL)
9696 *errormsg = (char_u *)"";
9697 return NULL;
9700 #endif
9703 if (resultlen == 0 || valid != VALID_HEAD + VALID_PATH)
9705 if (valid != VALID_HEAD + VALID_PATH)
9706 /* xgettext:no-c-format */
9707 *errormsg = (char_u *)_("E499: Empty file name for '%' or '#', only works with \":p:h\"");
9708 else
9709 *errormsg = (char_u *)_("E500: Evaluates to an empty string");
9710 result = NULL;
9712 else
9713 result = vim_strnsave(result, resultlen);
9714 vim_free(resultbuf);
9715 return result;
9719 * Concatenate all files in the argument list, separated by spaces, and return
9720 * it in one allocated string.
9721 * Spaces and backslashes in the file names are escaped with a backslash.
9722 * Returns NULL when out of memory.
9724 static char_u *
9725 arg_all()
9727 int len;
9728 int idx;
9729 char_u *retval = NULL;
9730 char_u *p;
9733 * Do this loop two times:
9734 * first time: compute the total length
9735 * second time: concatenate the names
9737 for (;;)
9739 len = 0;
9740 for (idx = 0; idx < ARGCOUNT; ++idx)
9742 p = alist_name(&ARGLIST[idx]);
9743 if (p != NULL)
9745 if (len > 0)
9747 /* insert a space in between names */
9748 if (retval != NULL)
9749 retval[len] = ' ';
9750 ++len;
9752 for ( ; *p != NUL; ++p)
9754 if (*p == ' ' || *p == '\\')
9756 /* insert a backslash */
9757 if (retval != NULL)
9758 retval[len] = '\\';
9759 ++len;
9761 if (retval != NULL)
9762 retval[len] = *p;
9763 ++len;
9768 /* second time: break here */
9769 if (retval != NULL)
9771 retval[len] = NUL;
9772 break;
9775 /* allocate memory */
9776 retval = alloc(len + 1);
9777 if (retval == NULL)
9778 break;
9781 return retval;
9784 #if defined(FEAT_AUTOCMD) || defined(PROTO)
9786 * Expand the <sfile> string in "arg".
9788 * Returns an allocated string, or NULL for any error.
9790 char_u *
9791 expand_sfile(arg)
9792 char_u *arg;
9794 char_u *errormsg;
9795 int len;
9796 char_u *result;
9797 char_u *newres;
9798 char_u *repl;
9799 int srclen;
9800 char_u *p;
9802 result = vim_strsave(arg);
9803 if (result == NULL)
9804 return NULL;
9806 for (p = result; *p; )
9808 if (STRNCMP(p, "<sfile>", 7) != 0)
9809 ++p;
9810 else
9812 /* replace "<sfile>" with the sourced file name, and do ":" stuff */
9813 repl = eval_vars(p, result, &srclen, NULL, &errormsg, NULL);
9814 if (errormsg != NULL)
9816 if (*errormsg)
9817 emsg(errormsg);
9818 vim_free(result);
9819 return NULL;
9821 if (repl == NULL) /* no match (cannot happen) */
9823 p += srclen;
9824 continue;
9826 len = (int)STRLEN(result) - srclen + (int)STRLEN(repl) + 1;
9827 newres = alloc(len);
9828 if (newres == NULL)
9830 vim_free(repl);
9831 vim_free(result);
9832 return NULL;
9834 mch_memmove(newres, result, (size_t)(p - result));
9835 STRCPY(newres + (p - result), repl);
9836 len = (int)STRLEN(newres);
9837 STRCAT(newres, p + srclen);
9838 vim_free(repl);
9839 vim_free(result);
9840 result = newres;
9841 p = newres + len; /* continue after the match */
9845 return result;
9847 #endif
9849 #ifdef FEAT_SESSION
9850 static int ses_winsizes __ARGS((FILE *fd, int restore_size,
9851 win_T *tab_firstwin));
9852 static int ses_win_rec __ARGS((FILE *fd, frame_T *fr));
9853 static frame_T *ses_skipframe __ARGS((frame_T *fr));
9854 static int ses_do_frame __ARGS((frame_T *fr));
9855 static int ses_do_win __ARGS((win_T *wp));
9856 static int ses_arglist __ARGS((FILE *fd, char *cmd, garray_T *gap, int fullname, unsigned *flagp));
9857 static int ses_put_fname __ARGS((FILE *fd, char_u *name, unsigned *flagp));
9858 static int ses_fname __ARGS((FILE *fd, buf_T *buf, unsigned *flagp));
9861 * Write openfile commands for the current buffers to an .exrc file.
9862 * Return FAIL on error, OK otherwise.
9864 static int
9865 makeopens(fd, dirnow)
9866 FILE *fd;
9867 char_u *dirnow; /* Current directory name */
9869 buf_T *buf;
9870 int only_save_windows = TRUE;
9871 int nr;
9872 int cnr = 1;
9873 int restore_size = TRUE;
9874 win_T *wp;
9875 char_u *sname;
9876 win_T *edited_win = NULL;
9877 int tabnr;
9878 win_T *tab_firstwin;
9879 frame_T *tab_topframe;
9880 int cur_arg_idx = 0;
9881 int next_arg_idx = 0;
9883 if (ssop_flags & SSOP_BUFFERS)
9884 only_save_windows = FALSE; /* Save ALL buffers */
9887 * Begin by setting the this_session variable, and then other
9888 * sessionable variables.
9890 #ifdef FEAT_EVAL
9891 if (put_line(fd, "let v:this_session=expand(\"<sfile>:p\")") == FAIL)
9892 return FAIL;
9893 if (ssop_flags & SSOP_GLOBALS)
9894 if (store_session_globals(fd) == FAIL)
9895 return FAIL;
9896 #endif
9899 * Close all windows but one.
9901 if (put_line(fd, "silent only") == FAIL)
9902 return FAIL;
9905 * Now a :cd command to the session directory or the current directory
9907 if (ssop_flags & SSOP_SESDIR)
9909 if (put_line(fd, "exe \"cd \" . escape(expand(\"<sfile>:p:h\"), ' ')")
9910 == FAIL)
9911 return FAIL;
9913 else if (ssop_flags & SSOP_CURDIR)
9915 sname = home_replace_save(NULL, globaldir != NULL ? globaldir : dirnow);
9916 if (sname == NULL
9917 || fputs("cd ", fd) < 0
9918 || ses_put_fname(fd, sname, &ssop_flags) == FAIL
9919 || put_eol(fd) == FAIL)
9921 vim_free(sname);
9922 return FAIL;
9924 vim_free(sname);
9928 * If there is an empty, unnamed buffer we will wipe it out later.
9929 * Remember the buffer number.
9931 if (put_line(fd, "if expand('%') == '' && !&modified && line('$') <= 1 && getline(1) == ''") == FAIL)
9932 return FAIL;
9933 if (put_line(fd, " let s:wipebuf = bufnr('%')") == FAIL)
9934 return FAIL;
9935 if (put_line(fd, "endif") == FAIL)
9936 return FAIL;
9939 * Now save the current files, current buffer first.
9941 if (put_line(fd, "set shortmess=aoO") == FAIL)
9942 return FAIL;
9944 /* Now put the other buffers into the buffer list */
9945 for (buf = firstbuf; buf != NULL; buf = buf->b_next)
9947 if (!(only_save_windows && buf->b_nwindows == 0)
9948 && !(buf->b_help && !(ssop_flags & SSOP_HELP))
9949 && buf->b_fname != NULL
9950 && buf->b_p_bl)
9952 if (fprintf(fd, "badd +%ld ", buf->b_wininfo == NULL ? 1L
9953 : buf->b_wininfo->wi_fpos.lnum) < 0
9954 || ses_fname(fd, buf, &ssop_flags) == FAIL)
9955 return FAIL;
9959 /* the global argument list */
9960 if (ses_arglist(fd, "args", &global_alist.al_ga,
9961 !(ssop_flags & SSOP_CURDIR), &ssop_flags) == FAIL)
9962 return FAIL;
9964 if (ssop_flags & SSOP_RESIZE)
9966 /* Note: after the restore we still check it worked!*/
9967 if (fprintf(fd, "set lines=%ld columns=%ld" , Rows, Columns) < 0
9968 || put_eol(fd) == FAIL)
9969 return FAIL;
9972 #ifdef FEAT_GUI
9973 if (gui.in_use && (ssop_flags & SSOP_WINPOS))
9975 int x, y;
9977 if (gui_mch_get_winpos(&x, &y) == OK)
9979 /* Note: after the restore we still check it worked!*/
9980 if (fprintf(fd, "winpos %d %d", x, y) < 0 || put_eol(fd) == FAIL)
9981 return FAIL;
9984 #endif
9987 * May repeat putting Windows for each tab, when "tabpages" is in
9988 * 'sessionoptions'.
9989 * Don't use goto_tabpage(), it may change directory and trigger
9990 * autocommands.
9992 tab_firstwin = firstwin; /* first window in tab page "tabnr" */
9993 tab_topframe = topframe;
9994 for (tabnr = 1; ; ++tabnr)
9996 int need_tabnew = FALSE;
9998 if ((ssop_flags & SSOP_TABPAGES))
10000 tabpage_T *tp = find_tabpage(tabnr);
10002 if (tp == NULL)
10003 break; /* done all tab pages */
10004 if (tp == curtab)
10006 tab_firstwin = firstwin;
10007 tab_topframe = topframe;
10009 else
10011 tab_firstwin = tp->tp_firstwin;
10012 tab_topframe = tp->tp_topframe;
10014 if (tabnr > 1)
10015 need_tabnew = TRUE;
10019 * Before creating the window layout, try loading one file. If this
10020 * is aborted we don't end up with a number of useless windows.
10021 * This may have side effects! (e.g., compressed or network file).
10023 for (wp = tab_firstwin; wp != NULL; wp = wp->w_next)
10025 if (ses_do_win(wp)
10026 && wp->w_buffer->b_ffname != NULL
10027 && !wp->w_buffer->b_help
10028 #ifdef FEAT_QUICKFIX
10029 && !bt_nofile(wp->w_buffer)
10030 #endif
10033 if (fputs(need_tabnew ? "tabedit " : "edit ", fd) < 0
10034 || ses_fname(fd, wp->w_buffer, &ssop_flags) == FAIL)
10035 return FAIL;
10036 need_tabnew = FALSE;
10037 if (!wp->w_arg_idx_invalid)
10038 edited_win = wp;
10039 break;
10043 /* If no file got edited create an empty tab page. */
10044 if (need_tabnew && put_line(fd, "tabnew") == FAIL)
10045 return FAIL;
10048 * Save current window layout.
10050 if (put_line(fd, "set splitbelow splitright") == FAIL)
10051 return FAIL;
10052 if (ses_win_rec(fd, tab_topframe) == FAIL)
10053 return FAIL;
10054 if (!p_sb && put_line(fd, "set nosplitbelow") == FAIL)
10055 return FAIL;
10056 if (!p_spr && put_line(fd, "set nosplitright") == FAIL)
10057 return FAIL;
10060 * Check if window sizes can be restored (no windows omitted).
10061 * Remember the window number of the current window after restoring.
10063 nr = 0;
10064 for (wp = tab_firstwin; wp != NULL; wp = W_NEXT(wp))
10066 if (ses_do_win(wp))
10067 ++nr;
10068 else
10069 restore_size = FALSE;
10070 if (curwin == wp)
10071 cnr = nr;
10074 /* Go to the first window. */
10075 if (put_line(fd, "wincmd t") == FAIL)
10076 return FAIL;
10079 * If more than one window, see if sizes can be restored.
10080 * First set 'winheight' and 'winwidth' to 1 to avoid the windows being
10081 * resized when moving between windows.
10082 * Do this before restoring the view, so that the topline and the
10083 * cursor can be set. This is done again below.
10085 if (put_line(fd, "set winheight=1 winwidth=1") == FAIL)
10086 return FAIL;
10087 if (nr > 1 && ses_winsizes(fd, restore_size, tab_firstwin) == FAIL)
10088 return FAIL;
10091 * Restore the view of the window (options, file, cursor, etc.).
10093 for (wp = tab_firstwin; wp != NULL; wp = wp->w_next)
10095 if (!ses_do_win(wp))
10096 continue;
10097 if (put_view(fd, wp, wp != edited_win, &ssop_flags,
10098 cur_arg_idx) == FAIL)
10099 return FAIL;
10100 if (nr > 1 && put_line(fd, "wincmd w") == FAIL)
10101 return FAIL;
10102 next_arg_idx = wp->w_arg_idx;
10105 /* The argument index in the first tab page is zero, need to set it in
10106 * each window. For further tab pages it's the window where we do
10107 * "tabedit". */
10108 cur_arg_idx = next_arg_idx;
10111 * Restore cursor to the current window if it's not the first one.
10113 if (cnr > 1 && (fprintf(fd, "%dwincmd w", cnr) < 0
10114 || put_eol(fd) == FAIL))
10115 return FAIL;
10118 * Restore window sizes again after jumping around in windows, because
10119 * the current window has a minimum size while others may not.
10121 if (nr > 1 && ses_winsizes(fd, restore_size, tab_firstwin) == FAIL)
10122 return FAIL;
10124 /* Don't continue in another tab page when doing only the current one
10125 * or when at the last tab page. */
10126 if (!(ssop_flags & SSOP_TABPAGES))
10127 break;
10130 if (ssop_flags & SSOP_TABPAGES)
10132 if (fprintf(fd, "tabnext %d", tabpage_index(curtab)) < 0
10133 || put_eol(fd) == FAIL)
10134 return FAIL;
10138 * Wipe out an empty unnamed buffer we started in.
10140 if (put_line(fd, "if exists('s:wipebuf')") == FAIL)
10141 return FAIL;
10142 if (put_line(fd, " silent exe 'bwipe ' . s:wipebuf") == FAIL)
10143 return FAIL;
10144 if (put_line(fd, "endif") == FAIL)
10145 return FAIL;
10146 if (put_line(fd, "unlet! s:wipebuf") == FAIL)
10147 return FAIL;
10149 /* Re-apply 'winheight', 'winwidth' and 'shortmess'. */
10150 if (fprintf(fd, "set winheight=%ld winwidth=%ld shortmess=%s",
10151 p_wh, p_wiw, p_shm) < 0 || put_eol(fd) == FAIL)
10152 return FAIL;
10155 * Lastly, execute the x.vim file if it exists.
10157 if (put_line(fd, "let s:sx = expand(\"<sfile>:p:r\").\"x.vim\"") == FAIL
10158 || put_line(fd, "if file_readable(s:sx)") == FAIL
10159 || put_line(fd, " exe \"source \" . fnameescape(s:sx)") == FAIL
10160 || put_line(fd, "endif") == FAIL)
10161 return FAIL;
10163 return OK;
10166 static int
10167 ses_winsizes(fd, restore_size, tab_firstwin)
10168 FILE *fd;
10169 int restore_size;
10170 win_T *tab_firstwin;
10172 int n = 0;
10173 win_T *wp;
10175 if (restore_size && (ssop_flags & SSOP_WINSIZE))
10177 for (wp = tab_firstwin; wp != NULL; wp = wp->w_next)
10179 if (!ses_do_win(wp))
10180 continue;
10181 ++n;
10183 /* restore height when not full height */
10184 if (wp->w_height + wp->w_status_height < topframe->fr_height
10185 && (fprintf(fd,
10186 "exe '%dresize ' . ((&lines * %ld + %ld) / %ld)",
10187 n, (long)wp->w_height, Rows / 2, Rows) < 0
10188 || put_eol(fd) == FAIL))
10189 return FAIL;
10191 /* restore width when not full width */
10192 if (wp->w_width < Columns && (fprintf(fd,
10193 "exe 'vert %dresize ' . ((&columns * %ld + %ld) / %ld)",
10194 n, (long)wp->w_width, Columns / 2, Columns) < 0
10195 || put_eol(fd) == FAIL))
10196 return FAIL;
10199 else
10201 /* Just equalise window sizes */
10202 if (put_line(fd, "wincmd =") == FAIL)
10203 return FAIL;
10205 return OK;
10209 * Write commands to "fd" to recursively create windows for frame "fr",
10210 * horizontally and vertically split.
10211 * After the commands the last window in the frame is the current window.
10212 * Returns FAIL when writing the commands to "fd" fails.
10214 static int
10215 ses_win_rec(fd, fr)
10216 FILE *fd;
10217 frame_T *fr;
10219 frame_T *frc;
10220 int count = 0;
10222 if (fr->fr_layout != FR_LEAF)
10224 /* Find first frame that's not skipped and then create a window for
10225 * each following one (first frame is already there). */
10226 frc = ses_skipframe(fr->fr_child);
10227 if (frc != NULL)
10228 while ((frc = ses_skipframe(frc->fr_next)) != NULL)
10230 /* Make window as big as possible so that we have lots of room
10231 * to split. */
10232 if (put_line(fd, "wincmd _ | wincmd |") == FAIL
10233 || put_line(fd, fr->fr_layout == FR_COL
10234 ? "split" : "vsplit") == FAIL)
10235 return FAIL;
10236 ++count;
10239 /* Go back to the first window. */
10240 if (count > 0 && (fprintf(fd, fr->fr_layout == FR_COL
10241 ? "%dwincmd k" : "%dwincmd h", count) < 0
10242 || put_eol(fd) == FAIL))
10243 return FAIL;
10245 /* Recursively create frames/windows in each window of this column or
10246 * row. */
10247 frc = ses_skipframe(fr->fr_child);
10248 while (frc != NULL)
10250 ses_win_rec(fd, frc);
10251 frc = ses_skipframe(frc->fr_next);
10252 /* Go to next window. */
10253 if (frc != NULL && put_line(fd, "wincmd w") == FAIL)
10254 return FAIL;
10257 return OK;
10261 * Skip frames that don't contain windows we want to save in the Session.
10262 * Returns NULL when there none.
10264 static frame_T *
10265 ses_skipframe(fr)
10266 frame_T *fr;
10268 frame_T *frc;
10270 for (frc = fr; frc != NULL; frc = frc->fr_next)
10271 if (ses_do_frame(frc))
10272 break;
10273 return frc;
10277 * Return TRUE if frame "fr" has a window somewhere that we want to save in
10278 * the Session.
10280 static int
10281 ses_do_frame(fr)
10282 frame_T *fr;
10284 frame_T *frc;
10286 if (fr->fr_layout == FR_LEAF)
10287 return ses_do_win(fr->fr_win);
10288 for (frc = fr->fr_child; frc != NULL; frc = frc->fr_next)
10289 if (ses_do_frame(frc))
10290 return TRUE;
10291 return FALSE;
10295 * Return non-zero if window "wp" is to be stored in the Session.
10297 static int
10298 ses_do_win(wp)
10299 win_T *wp;
10301 if (wp->w_buffer->b_fname == NULL
10302 #ifdef FEAT_QUICKFIX
10303 /* When 'buftype' is "nofile" can't restore the window contents. */
10304 || bt_nofile(wp->w_buffer)
10305 #endif
10307 return (ssop_flags & SSOP_BLANK);
10308 if (wp->w_buffer->b_help)
10309 return (ssop_flags & SSOP_HELP);
10310 return TRUE;
10314 * Write commands to "fd" to restore the view of a window.
10315 * Caller must make sure 'scrolloff' is zero.
10317 static int
10318 put_view(fd, wp, add_edit, flagp, current_arg_idx)
10319 FILE *fd;
10320 win_T *wp;
10321 int add_edit; /* add ":edit" command to view */
10322 unsigned *flagp; /* vop_flags or ssop_flags */
10323 int current_arg_idx; /* current argument index of the window, use
10324 * -1 if unknown */
10326 win_T *save_curwin;
10327 int f;
10328 int do_cursor;
10329 int did_next = FALSE;
10331 /* Always restore cursor position for ":mksession". For ":mkview" only
10332 * when 'viewoptions' contains "cursor". */
10333 do_cursor = (flagp == &ssop_flags || *flagp & SSOP_CURSOR);
10336 * Local argument list.
10338 if (wp->w_alist == &global_alist)
10340 if (put_line(fd, "argglobal") == FAIL)
10341 return FAIL;
10343 else
10345 if (ses_arglist(fd, "arglocal", &wp->w_alist->al_ga,
10346 flagp == &vop_flags
10347 || !(*flagp & SSOP_CURDIR)
10348 || wp->w_localdir != NULL, flagp) == FAIL)
10349 return FAIL;
10352 /* Only when part of a session: restore the argument index. Some
10353 * arguments may have been deleted, check if the index is valid. */
10354 if (wp->w_arg_idx != current_arg_idx && wp->w_arg_idx <= WARGCOUNT(wp)
10355 && flagp == &ssop_flags)
10357 if (fprintf(fd, "%ldargu", (long)wp->w_arg_idx + 1) < 0
10358 || put_eol(fd) == FAIL)
10359 return FAIL;
10360 did_next = TRUE;
10363 /* Edit the file. Skip this when ":next" already did it. */
10364 if (add_edit && (!did_next || wp->w_arg_idx_invalid))
10367 * Load the file.
10369 if (wp->w_buffer->b_ffname != NULL
10370 #ifdef FEAT_QUICKFIX
10371 && !bt_nofile(wp->w_buffer)
10372 #endif
10376 * Editing a file in this buffer: use ":edit file".
10377 * This may have side effects! (e.g., compressed or network file).
10379 if (fputs("edit ", fd) < 0
10380 || ses_fname(fd, wp->w_buffer, flagp) == FAIL)
10381 return FAIL;
10383 else
10385 /* No file in this buffer, just make it empty. */
10386 if (put_line(fd, "enew") == FAIL)
10387 return FAIL;
10388 #ifdef FEAT_QUICKFIX
10389 if (wp->w_buffer->b_ffname != NULL)
10391 /* The buffer does have a name, but it's not a file name. */
10392 if (fputs("file ", fd) < 0
10393 || ses_fname(fd, wp->w_buffer, flagp) == FAIL)
10394 return FAIL;
10396 #endif
10397 do_cursor = FALSE;
10402 * Local mappings and abbreviations.
10404 if ((*flagp & (SSOP_OPTIONS | SSOP_LOCALOPTIONS))
10405 && makemap(fd, wp->w_buffer) == FAIL)
10406 return FAIL;
10409 * Local options. Need to go to the window temporarily.
10410 * Store only local values when using ":mkview" and when ":mksession" is
10411 * used and 'sessionoptions' doesn't include "options".
10412 * Some folding options are always stored when "folds" is included,
10413 * otherwise the folds would not be restored correctly.
10415 save_curwin = curwin;
10416 curwin = wp;
10417 curbuf = curwin->w_buffer;
10418 if (*flagp & (SSOP_OPTIONS | SSOP_LOCALOPTIONS))
10419 f = makeset(fd, OPT_LOCAL,
10420 flagp == &vop_flags || !(*flagp & SSOP_OPTIONS));
10421 #ifdef FEAT_FOLDING
10422 else if (*flagp & SSOP_FOLDS)
10423 f = makefoldset(fd);
10424 #endif
10425 else
10426 f = OK;
10427 curwin = save_curwin;
10428 curbuf = curwin->w_buffer;
10429 if (f == FAIL)
10430 return FAIL;
10432 #ifdef FEAT_FOLDING
10434 * Save Folds when 'buftype' is empty and for help files.
10436 if ((*flagp & SSOP_FOLDS)
10437 && wp->w_buffer->b_ffname != NULL
10438 # ifdef FEAT_QUICKFIX
10439 && (*wp->w_buffer->b_p_bt == NUL || wp->w_buffer->b_help)
10440 # endif
10443 if (put_folds(fd, wp) == FAIL)
10444 return FAIL;
10446 #endif
10449 * Set the cursor after creating folds, since that moves the cursor.
10451 if (do_cursor)
10454 /* Restore the cursor line in the file and relatively in the
10455 * window. Don't use "G", it changes the jumplist. */
10456 if (fprintf(fd, "let s:l = %ld - ((%ld * winheight(0) + %ld) / %ld)",
10457 (long)wp->w_cursor.lnum,
10458 (long)(wp->w_cursor.lnum - wp->w_topline),
10459 (long)wp->w_height / 2, (long)wp->w_height) < 0
10460 || put_eol(fd) == FAIL
10461 || put_line(fd, "if s:l < 1 | let s:l = 1 | endif") == FAIL
10462 || put_line(fd, "exe s:l") == FAIL
10463 || put_line(fd, "normal! zt") == FAIL
10464 || fprintf(fd, "%ld", (long)wp->w_cursor.lnum) < 0
10465 || put_eol(fd) == FAIL)
10466 return FAIL;
10467 /* Restore the cursor column and left offset when not wrapping. */
10468 if (wp->w_cursor.col == 0)
10470 if (put_line(fd, "normal! 0") == FAIL)
10471 return FAIL;
10473 else
10475 if (!wp->w_p_wrap && wp->w_leftcol > 0 && wp->w_width > 0)
10477 if (fprintf(fd,
10478 "let s:c = %ld - ((%ld * winwidth(0) + %ld) / %ld)",
10479 (long)wp->w_cursor.col,
10480 (long)(wp->w_cursor.col - wp->w_leftcol),
10481 (long)wp->w_width / 2, (long)wp->w_width) < 0
10482 || put_eol(fd) == FAIL
10483 || put_line(fd, "if s:c > 0") == FAIL
10484 || fprintf(fd,
10485 " exe 'normal! 0' . s:c . 'lzs' . (%ld - s:c) . 'l'",
10486 (long)wp->w_cursor.col) < 0
10487 || put_eol(fd) == FAIL
10488 || put_line(fd, "else") == FAIL
10489 || fprintf(fd, " normal! 0%dl", wp->w_cursor.col) < 0
10490 || put_eol(fd) == FAIL
10491 || put_line(fd, "endif") == FAIL)
10492 return FAIL;
10494 else
10496 if (fprintf(fd, "normal! 0%dl", wp->w_cursor.col) < 0
10497 || put_eol(fd) == FAIL)
10498 return FAIL;
10504 * Local directory.
10506 if (wp->w_localdir != NULL)
10508 if (fputs("lcd ", fd) < 0
10509 || ses_put_fname(fd, wp->w_localdir, flagp) == FAIL
10510 || put_eol(fd) == FAIL)
10511 return FAIL;
10512 did_lcd = TRUE;
10515 return OK;
10519 * Write an argument list to the session file.
10520 * Returns FAIL if writing fails.
10522 static int
10523 ses_arglist(fd, cmd, gap, fullname, flagp)
10524 FILE *fd;
10525 char *cmd;
10526 garray_T *gap;
10527 int fullname; /* TRUE: use full path name */
10528 unsigned *flagp;
10530 int i;
10531 char_u buf[MAXPATHL];
10532 char_u *s;
10534 if (gap->ga_len == 0)
10535 return put_line(fd, "silent! argdel *");
10536 if (fputs(cmd, fd) < 0)
10537 return FAIL;
10538 for (i = 0; i < gap->ga_len; ++i)
10540 /* NULL file names are skipped (only happens when out of memory). */
10541 s = alist_name(&((aentry_T *)gap->ga_data)[i]);
10542 if (s != NULL)
10544 if (fullname)
10546 (void)vim_FullName(s, buf, MAXPATHL, FALSE);
10547 s = buf;
10549 if (fputs(" ", fd) < 0 || ses_put_fname(fd, s, flagp) == FAIL)
10550 return FAIL;
10553 return put_eol(fd);
10557 * Write a buffer name to the session file.
10558 * Also ends the line.
10559 * Returns FAIL if writing fails.
10561 static int
10562 ses_fname(fd, buf, flagp)
10563 FILE *fd;
10564 buf_T *buf;
10565 unsigned *flagp;
10567 char_u *name;
10569 /* Use the short file name if the current directory is known at the time
10570 * the session file will be sourced.
10571 * Don't do this for ":mkview", we don't know the current directory.
10572 * Don't do this after ":lcd", we don't keep track of what the current
10573 * directory is. */
10574 if (buf->b_sfname != NULL
10575 && flagp == &ssop_flags
10576 && (ssop_flags & (SSOP_CURDIR | SSOP_SESDIR))
10577 && !did_lcd)
10578 name = buf->b_sfname;
10579 else
10580 name = buf->b_ffname;
10581 if (ses_put_fname(fd, name, flagp) == FAIL || put_eol(fd) == FAIL)
10582 return FAIL;
10583 return OK;
10587 * Write a file name to the session file.
10588 * Takes care of the "slash" option in 'sessionoptions' and escapes special
10589 * characters.
10590 * Returns FAIL if writing fails.
10592 static int
10593 ses_put_fname(fd, name, flagp)
10594 FILE *fd;
10595 char_u *name;
10596 unsigned *flagp;
10598 char_u *sname;
10599 int retval = OK;
10600 int c;
10602 sname = home_replace_save(NULL, name);
10603 if (sname != NULL)
10604 name = sname;
10605 while (*name != NUL)
10607 #ifdef FEAT_MBYTE
10609 int l;
10611 if (has_mbyte && (l = (*mb_ptr2len)(name)) > 1)
10613 /* copy a multibyte char */
10614 while (--l >= 0)
10616 if (putc(*name, fd) != *name)
10617 retval = FAIL;
10618 ++name;
10620 continue;
10623 #endif
10624 c = *name++;
10625 if (c == '\\' && (*flagp & SSOP_SLASH))
10626 /* change a backslash to a forward slash */
10627 c = '/';
10628 else if ((vim_strchr(escape_chars, c) != NULL
10629 #ifdef BACKSLASH_IN_FILENAME
10630 && c != '\\'
10631 #endif
10632 ) || c == '#' || c == '%')
10634 /* escape a special character with a backslash */
10635 if (putc('\\', fd) != '\\')
10636 retval = FAIL;
10638 if (putc(c, fd) != c)
10639 retval = FAIL;
10641 vim_free(sname);
10642 return retval;
10646 * ":loadview [nr]"
10648 static void
10649 ex_loadview(eap)
10650 exarg_T *eap;
10652 char_u *fname;
10654 fname = get_view_file(*eap->arg);
10655 if (fname != NULL)
10657 do_source(fname, FALSE, DOSO_NONE);
10658 vim_free(fname);
10663 * Get the name of the view file for the current buffer.
10665 static char_u *
10666 get_view_file(c)
10667 int c;
10669 int len = 0;
10670 char_u *p, *s;
10671 char_u *retval;
10672 char_u *sname;
10674 if (curbuf->b_ffname == NULL)
10676 EMSG(_(e_noname));
10677 return NULL;
10679 sname = home_replace_save(NULL, curbuf->b_ffname);
10680 if (sname == NULL)
10681 return NULL;
10684 * We want a file name without separators, because we're not going to make
10685 * a directory.
10686 * "normal" path separator -> "=+"
10687 * "=" -> "=="
10688 * ":" path separator -> "=-"
10690 for (p = sname; *p; ++p)
10691 if (*p == '=' || vim_ispathsep(*p))
10692 ++len;
10693 retval = alloc((unsigned)(STRLEN(sname) + len + STRLEN(p_vdir) + 9));
10694 if (retval != NULL)
10696 STRCPY(retval, p_vdir);
10697 add_pathsep(retval);
10698 s = retval + STRLEN(retval);
10699 for (p = sname; *p; ++p)
10701 if (*p == '=')
10703 *s++ = '=';
10704 *s++ = '=';
10706 else if (vim_ispathsep(*p))
10708 *s++ = '=';
10709 #if defined(BACKSLASH_IN_FILENAME) || defined(AMIGA) || defined(RISCOS) \
10710 || defined(VMS)
10711 if (*p == ':')
10712 *s++ = '-';
10713 else
10714 #endif
10715 *s++ = '+';
10717 else
10718 *s++ = *p;
10720 *s++ = '=';
10721 *s++ = c;
10722 STRCPY(s, ".vim");
10725 vim_free(sname);
10726 return retval;
10729 #endif /* FEAT_SESSION */
10732 * Write end-of-line character(s) for ":mkexrc", ":mkvimrc" and ":mksession".
10733 * Return FAIL for a write error.
10736 put_eol(fd)
10737 FILE *fd;
10739 if (
10740 #ifdef USE_CRNL
10742 # ifdef MKSESSION_NL
10743 !mksession_nl &&
10744 # endif
10745 (putc('\r', fd) < 0)) ||
10746 #endif
10747 (putc('\n', fd) < 0))
10748 return FAIL;
10749 return OK;
10753 * Write a line to "fd".
10754 * Return FAIL for a write error.
10757 put_line(fd, s)
10758 FILE *fd;
10759 char *s;
10761 if (fputs(s, fd) < 0 || put_eol(fd) == FAIL)
10762 return FAIL;
10763 return OK;
10766 #ifdef FEAT_VIMINFO
10768 * ":rviminfo" and ":wviminfo".
10770 static void
10771 ex_viminfo(eap)
10772 exarg_T *eap;
10774 char_u *save_viminfo;
10776 save_viminfo = p_viminfo;
10777 if (*p_viminfo == NUL)
10778 p_viminfo = (char_u *)"'100";
10779 if (eap->cmdidx == CMD_rviminfo)
10781 if (read_viminfo(eap->arg, VIF_WANT_INFO | VIF_WANT_MARKS
10782 | (eap->forceit ? VIF_FORCEIT : 0)) == FAIL)
10783 EMSG(_("E195: Cannot open viminfo file for reading"));
10785 else
10786 write_viminfo(eap->arg, eap->forceit);
10787 p_viminfo = save_viminfo;
10789 #endif
10791 #if defined(FEAT_GUI_DIALOG) || defined(FEAT_CON_DIALOG) || defined(PROTO)
10793 * Make a dialog message in "buff[IOSIZE]".
10794 * "format" must contain "%s".
10796 void
10797 dialog_msg(buff, format, fname)
10798 char_u *buff;
10799 char *format;
10800 char_u *fname;
10802 if (fname == NULL)
10803 fname = (char_u *)_("Untitled");
10804 vim_snprintf((char *)buff, IOSIZE, format, fname);
10806 #endif
10809 * ":behave {mswin,xterm}"
10811 static void
10812 ex_behave(eap)
10813 exarg_T *eap;
10815 if (STRCMP(eap->arg, "mswin") == 0)
10817 set_option_value((char_u *)"selection", 0L, (char_u *)"exclusive", 0);
10818 set_option_value((char_u *)"selectmode", 0L, (char_u *)"mouse,key", 0);
10819 set_option_value((char_u *)"mousemodel", 0L, (char_u *)"popup", 0);
10820 set_option_value((char_u *)"keymodel", 0L,
10821 (char_u *)"startsel,stopsel", 0);
10823 else if (STRCMP(eap->arg, "xterm") == 0)
10825 set_option_value((char_u *)"selection", 0L, (char_u *)"inclusive", 0);
10826 set_option_value((char_u *)"selectmode", 0L, (char_u *)"", 0);
10827 set_option_value((char_u *)"mousemodel", 0L, (char_u *)"extend", 0);
10828 set_option_value((char_u *)"keymodel", 0L, (char_u *)"", 0);
10830 else
10831 EMSG2(_(e_invarg2), eap->arg);
10834 #ifdef FEAT_AUTOCMD
10835 static int filetype_detect = FALSE;
10836 static int filetype_plugin = FALSE;
10837 static int filetype_indent = FALSE;
10840 * ":filetype [plugin] [indent] {on,off,detect}"
10841 * on: Load the filetype.vim file to install autocommands for file types.
10842 * off: Load the ftoff.vim file to remove all autocommands for file types.
10843 * plugin on: load filetype.vim and ftplugin.vim
10844 * plugin off: load ftplugof.vim
10845 * indent on: load filetype.vim and indent.vim
10846 * indent off: load indoff.vim
10848 static void
10849 ex_filetype(eap)
10850 exarg_T *eap;
10852 char_u *arg = eap->arg;
10853 int plugin = FALSE;
10854 int indent = FALSE;
10856 if (*eap->arg == NUL)
10858 /* Print current status. */
10859 smsg((char_u *)"filetype detection:%s plugin:%s indent:%s",
10860 filetype_detect ? "ON" : "OFF",
10861 filetype_plugin ? (filetype_detect ? "ON" : "(on)") : "OFF",
10862 filetype_indent ? (filetype_detect ? "ON" : "(on)") : "OFF");
10863 return;
10866 /* Accept "plugin" and "indent" in any order. */
10867 for (;;)
10869 if (STRNCMP(arg, "plugin", 6) == 0)
10871 plugin = TRUE;
10872 arg = skipwhite(arg + 6);
10873 continue;
10875 if (STRNCMP(arg, "indent", 6) == 0)
10877 indent = TRUE;
10878 arg = skipwhite(arg + 6);
10879 continue;
10881 break;
10883 if (STRCMP(arg, "on") == 0 || STRCMP(arg, "detect") == 0)
10885 if (*arg == 'o' || !filetype_detect)
10887 source_runtime((char_u *)FILETYPE_FILE, TRUE);
10888 filetype_detect = TRUE;
10889 if (plugin)
10891 source_runtime((char_u *)FTPLUGIN_FILE, TRUE);
10892 filetype_plugin = TRUE;
10894 if (indent)
10896 source_runtime((char_u *)INDENT_FILE, TRUE);
10897 filetype_indent = TRUE;
10900 if (*arg == 'd')
10902 (void)do_doautocmd((char_u *)"filetypedetect BufRead", TRUE);
10903 do_modelines(0);
10906 else if (STRCMP(arg, "off") == 0)
10908 if (plugin || indent)
10910 if (plugin)
10912 source_runtime((char_u *)FTPLUGOF_FILE, TRUE);
10913 filetype_plugin = FALSE;
10915 if (indent)
10917 source_runtime((char_u *)INDOFF_FILE, TRUE);
10918 filetype_indent = FALSE;
10921 else
10923 source_runtime((char_u *)FTOFF_FILE, TRUE);
10924 filetype_detect = FALSE;
10927 else
10928 EMSG2(_(e_invarg2), arg);
10932 * ":setfiletype {name}"
10934 static void
10935 ex_setfiletype(eap)
10936 exarg_T *eap;
10938 if (!did_filetype)
10939 set_option_value((char_u *)"filetype", 0L, eap->arg, OPT_LOCAL);
10941 #endif
10943 /*ARGSUSED*/
10944 static void
10945 ex_digraphs(eap)
10946 exarg_T *eap;
10948 #ifdef FEAT_DIGRAPHS
10949 if (*eap->arg != NUL)
10950 putdigraph(eap->arg);
10951 else
10952 listdigraphs();
10953 #else
10954 EMSG(_("E196: No digraphs in this version"));
10955 #endif
10958 static void
10959 ex_set(eap)
10960 exarg_T *eap;
10962 int flags = 0;
10964 if (eap->cmdidx == CMD_setlocal)
10965 flags = OPT_LOCAL;
10966 else if (eap->cmdidx == CMD_setglobal)
10967 flags = OPT_GLOBAL;
10968 #if defined(FEAT_EVAL) && defined(FEAT_AUTOCMD) && defined(FEAT_BROWSE)
10969 if (cmdmod.browse && flags == 0)
10970 ex_options(eap);
10971 else
10972 #endif
10973 (void)do_set(eap->arg, flags);
10976 #ifdef FEAT_SEARCH_EXTRA
10978 * ":nohlsearch"
10980 /*ARGSUSED*/
10981 static void
10982 ex_nohlsearch(eap)
10983 exarg_T *eap;
10985 no_hlsearch = TRUE;
10986 redraw_all_later(SOME_VALID);
10990 * ":[N]match {group} {pattern}"
10991 * Sets nextcmd to the start of the next command, if any. Also called when
10992 * skipping commands to find the next command.
10994 static void
10995 ex_match(eap)
10996 exarg_T *eap;
10998 char_u *p;
10999 char_u *g = NULL;
11000 char_u *end;
11001 int c;
11002 int id;
11004 if (eap->line2 <= 3)
11005 id = eap->line2;
11006 else
11008 EMSG(e_invcmd);
11009 return;
11012 /* First clear any old pattern. */
11013 if (!eap->skip)
11014 match_delete(curwin, id, FALSE);
11016 if (ends_excmd(*eap->arg))
11017 end = eap->arg;
11018 else if ((STRNICMP(eap->arg, "none", 4) == 0
11019 && (vim_iswhite(eap->arg[4]) || ends_excmd(eap->arg[4]))))
11020 end = eap->arg + 4;
11021 else
11023 p = skiptowhite(eap->arg);
11024 if (!eap->skip)
11025 g = vim_strnsave(eap->arg, (int)(p - eap->arg));
11026 p = skipwhite(p);
11027 if (*p == NUL)
11029 /* There must be two arguments. */
11030 EMSG2(_(e_invarg2), eap->arg);
11031 return;
11033 end = skip_regexp(p + 1, *p, TRUE, NULL);
11034 if (!eap->skip)
11036 if (*end != NUL && !ends_excmd(*skipwhite(end + 1)))
11038 eap->errmsg = e_trailing;
11039 return;
11041 if (*end != *p)
11043 EMSG2(_(e_invarg2), p);
11044 return;
11047 c = *end;
11048 *end = NUL;
11049 match_add(curwin, g, p + 1, 10, id);
11050 vim_free(g);
11051 *end = c;
11054 eap->nextcmd = find_nextcmd(end);
11056 #endif
11058 #ifdef FEAT_CRYPT
11060 * ":X": Get crypt key
11062 /*ARGSUSED*/
11063 static void
11064 ex_X(eap)
11065 exarg_T *eap;
11067 (void)get_crypt_key(TRUE, TRUE);
11069 #endif
11071 #ifdef FEAT_FOLDING
11072 static void
11073 ex_fold(eap)
11074 exarg_T *eap;
11076 if (foldManualAllowed(TRUE))
11077 foldCreate(eap->line1, eap->line2);
11080 static void
11081 ex_foldopen(eap)
11082 exarg_T *eap;
11084 opFoldRange(eap->line1, eap->line2, eap->cmdidx == CMD_foldopen,
11085 eap->forceit, FALSE);
11088 static void
11089 ex_folddo(eap)
11090 exarg_T *eap;
11092 linenr_T lnum;
11094 /* First set the marks for all lines closed/open. */
11095 for (lnum = eap->line1; lnum <= eap->line2; ++lnum)
11096 if (hasFolding(lnum, NULL, NULL) == (eap->cmdidx == CMD_folddoclosed))
11097 ml_setmarked(lnum);
11099 /* Execute the command on the marked lines. */
11100 global_exe(eap->arg);
11101 ml_clearmarked(); /* clear rest of the marks */
11103 #endif