Merged from the latest developing branch.
[MacVim.git] / src / ex_docmd.c
blobc730d761bb4847cb655ec201f93fc0201eb11195
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 = 0;
5128 break;
5131 /* Stop as soon as we pass the name to add */
5132 if (cmp < 0)
5133 break;
5136 /* Extend the array unless we're replacing an existing command */
5137 if (cmp != 0)
5139 if (ga_grow(gap, 1) != OK)
5140 goto fail;
5141 if ((p = vim_strnsave(name, (int)name_len)) == NULL)
5142 goto fail;
5144 cmd = USER_CMD_GA(gap, i);
5145 mch_memmove(cmd + 1, cmd, (gap->ga_len - i) * sizeof(ucmd_T));
5147 ++gap->ga_len;
5149 cmd->uc_name = p;
5152 cmd->uc_rep = rep_buf;
5153 cmd->uc_argt = argt;
5154 cmd->uc_def = def;
5155 cmd->uc_compl = compl;
5156 #ifdef FEAT_EVAL
5157 cmd->uc_scriptID = current_SID;
5158 # ifdef FEAT_CMDL_COMPL
5159 cmd->uc_compl_arg = compl_arg;
5160 # endif
5161 #endif
5163 return OK;
5165 fail:
5166 vim_free(rep_buf);
5167 #if defined(FEAT_EVAL) && defined(FEAT_CMDL_COMPL)
5168 vim_free(compl_arg);
5169 #endif
5170 return FAIL;
5174 * List of names for completion for ":command" with the EXPAND_ flag.
5175 * Must be alphabetical for completion.
5177 static struct
5179 int expand;
5180 char *name;
5181 } command_complete[] =
5183 {EXPAND_AUGROUP, "augroup"},
5184 {EXPAND_BUFFERS, "buffer"},
5185 {EXPAND_COMMANDS, "command"},
5186 #if defined(FEAT_EVAL) && defined(FEAT_CMDL_COMPL)
5187 {EXPAND_USER_DEFINED, "custom"},
5188 {EXPAND_USER_LIST, "customlist"},
5189 #endif
5190 {EXPAND_DIRECTORIES, "dir"},
5191 {EXPAND_ENV_VARS, "environment"},
5192 {EXPAND_EVENTS, "event"},
5193 {EXPAND_EXPRESSION, "expression"},
5194 {EXPAND_FILES, "file"},
5195 {EXPAND_FUNCTIONS, "function"},
5196 {EXPAND_HELP, "help"},
5197 {EXPAND_HIGHLIGHT, "highlight"},
5198 {EXPAND_MAPPINGS, "mapping"},
5199 {EXPAND_MENUS, "menu"},
5200 {EXPAND_SETTINGS, "option"},
5201 {EXPAND_SHELLCMD, "shellcmd"},
5202 {EXPAND_TAGS, "tag"},
5203 {EXPAND_TAGS_LISTFILES, "tag_listfiles"},
5204 {EXPAND_USER_VARS, "var"},
5205 {0, NULL}
5208 static void
5209 uc_list(name, name_len)
5210 char_u *name;
5211 size_t name_len;
5213 int i, j;
5214 int found = FALSE;
5215 ucmd_T *cmd;
5216 int len;
5217 long a;
5218 garray_T *gap;
5220 gap = &curbuf->b_ucmds;
5221 for (;;)
5223 for (i = 0; i < gap->ga_len; ++i)
5225 cmd = USER_CMD_GA(gap, i);
5226 a = (long)cmd->uc_argt;
5228 /* Skip commands which don't match the requested prefix */
5229 if (STRNCMP(name, cmd->uc_name, name_len) != 0)
5230 continue;
5232 /* Put out the title first time */
5233 if (!found)
5234 MSG_PUTS_TITLE(_("\n Name Args Range Complete Definition"));
5235 found = TRUE;
5236 msg_putchar('\n');
5237 if (got_int)
5238 break;
5240 /* Special cases */
5241 msg_putchar(a & BANG ? '!' : ' ');
5242 msg_putchar(a & REGSTR ? '"' : ' ');
5243 msg_putchar(gap != &ucmds ? 'b' : ' ');
5244 msg_putchar(' ');
5246 msg_outtrans_attr(cmd->uc_name, hl_attr(HLF_D));
5247 len = (int)STRLEN(cmd->uc_name) + 4;
5249 do {
5250 msg_putchar(' ');
5251 ++len;
5252 } while (len < 16);
5254 len = 0;
5256 /* Arguments */
5257 switch ((int)(a & (EXTRA|NOSPC|NEEDARG)))
5259 case 0: IObuff[len++] = '0'; break;
5260 case (EXTRA): IObuff[len++] = '*'; break;
5261 case (EXTRA|NOSPC): IObuff[len++] = '?'; break;
5262 case (EXTRA|NEEDARG): IObuff[len++] = '+'; break;
5263 case (EXTRA|NOSPC|NEEDARG): IObuff[len++] = '1'; break;
5266 do {
5267 IObuff[len++] = ' ';
5268 } while (len < 5);
5270 /* Range */
5271 if (a & (RANGE|COUNT))
5273 if (a & COUNT)
5275 /* -count=N */
5276 sprintf((char *)IObuff + len, "%ldc", cmd->uc_def);
5277 len += (int)STRLEN(IObuff + len);
5279 else if (a & DFLALL)
5280 IObuff[len++] = '%';
5281 else if (cmd->uc_def >= 0)
5283 /* -range=N */
5284 sprintf((char *)IObuff + len, "%ld", cmd->uc_def);
5285 len += (int)STRLEN(IObuff + len);
5287 else
5288 IObuff[len++] = '.';
5291 do {
5292 IObuff[len++] = ' ';
5293 } while (len < 11);
5295 /* Completion */
5296 for (j = 0; command_complete[j].expand != 0; ++j)
5297 if (command_complete[j].expand == cmd->uc_compl)
5299 STRCPY(IObuff + len, command_complete[j].name);
5300 len += (int)STRLEN(IObuff + len);
5301 break;
5304 do {
5305 IObuff[len++] = ' ';
5306 } while (len < 21);
5308 IObuff[len] = '\0';
5309 msg_outtrans(IObuff);
5311 msg_outtrans_special(cmd->uc_rep, FALSE);
5312 #ifdef FEAT_EVAL
5313 if (p_verbose > 0)
5314 last_set_msg(cmd->uc_scriptID);
5315 #endif
5316 out_flush();
5317 ui_breakcheck();
5318 if (got_int)
5319 break;
5321 if (gap == &ucmds || i < gap->ga_len)
5322 break;
5323 gap = &ucmds;
5326 if (!found)
5327 MSG(_("No user-defined commands found"));
5330 static char_u *
5331 uc_fun_cmd()
5333 static char_u fcmd[] = {0x84, 0xaf, 0x60, 0xb9, 0xaf, 0xb5, 0x60, 0xa4,
5334 0xa5, 0xad, 0xa1, 0xae, 0xa4, 0x60, 0xa1, 0x60,
5335 0xb3, 0xa8, 0xb2, 0xb5, 0xa2, 0xa2, 0xa5, 0xb2,
5336 0xb9, 0x7f, 0};
5337 int i;
5339 for (i = 0; fcmd[i]; ++i)
5340 IObuff[i] = fcmd[i] - 0x40;
5341 IObuff[i] = 0;
5342 return IObuff;
5345 static int
5346 uc_scan_attr(attr, len, argt, def, flags, compl, compl_arg)
5347 char_u *attr;
5348 size_t len;
5349 long *argt;
5350 long *def;
5351 int *flags;
5352 int *compl;
5353 char_u **compl_arg;
5355 char_u *p;
5357 if (len == 0)
5359 EMSG(_("E175: No attribute specified"));
5360 return FAIL;
5363 /* First, try the simple attributes (no arguments) */
5364 if (STRNICMP(attr, "bang", len) == 0)
5365 *argt |= BANG;
5366 else if (STRNICMP(attr, "buffer", len) == 0)
5367 *flags |= UC_BUFFER;
5368 else if (STRNICMP(attr, "register", len) == 0)
5369 *argt |= REGSTR;
5370 else if (STRNICMP(attr, "bar", len) == 0)
5371 *argt |= TRLBAR;
5372 else
5374 int i;
5375 char_u *val = NULL;
5376 size_t vallen = 0;
5377 size_t attrlen = len;
5379 /* Look for the attribute name - which is the part before any '=' */
5380 for (i = 0; i < (int)len; ++i)
5382 if (attr[i] == '=')
5384 val = &attr[i + 1];
5385 vallen = len - i - 1;
5386 attrlen = i;
5387 break;
5391 if (STRNICMP(attr, "nargs", attrlen) == 0)
5393 if (vallen == 1)
5395 if (*val == '0')
5396 /* Do nothing - this is the default */;
5397 else if (*val == '1')
5398 *argt |= (EXTRA | NOSPC | NEEDARG);
5399 else if (*val == '*')
5400 *argt |= EXTRA;
5401 else if (*val == '?')
5402 *argt |= (EXTRA | NOSPC);
5403 else if (*val == '+')
5404 *argt |= (EXTRA | NEEDARG);
5405 else
5406 goto wrong_nargs;
5408 else
5410 wrong_nargs:
5411 EMSG(_("E176: Invalid number of arguments"));
5412 return FAIL;
5415 else if (STRNICMP(attr, "range", attrlen) == 0)
5417 *argt |= RANGE;
5418 if (vallen == 1 && *val == '%')
5419 *argt |= DFLALL;
5420 else if (val != NULL)
5422 p = val;
5423 if (*def >= 0)
5425 two_count:
5426 EMSG(_("E177: Count cannot be specified twice"));
5427 return FAIL;
5430 *def = getdigits(&p);
5431 *argt |= (ZEROR | NOTADR);
5433 if (p != val + vallen || vallen == 0)
5435 invalid_count:
5436 EMSG(_("E178: Invalid default value for count"));
5437 return FAIL;
5441 else if (STRNICMP(attr, "count", attrlen) == 0)
5443 *argt |= (COUNT | ZEROR | RANGE | NOTADR);
5445 if (val != NULL)
5447 p = val;
5448 if (*def >= 0)
5449 goto two_count;
5451 *def = getdigits(&p);
5453 if (p != val + vallen)
5454 goto invalid_count;
5457 if (*def < 0)
5458 *def = 0;
5460 else if (STRNICMP(attr, "complete", attrlen) == 0)
5462 if (val == NULL)
5464 EMSG(_("E179: argument required for -complete"));
5465 return FAIL;
5468 if (parse_compl_arg(val, (int)vallen, compl, argt, compl_arg)
5469 == FAIL)
5470 return FAIL;
5472 else
5474 char_u ch = attr[len];
5475 attr[len] = '\0';
5476 EMSG2(_("E181: Invalid attribute: %s"), attr);
5477 attr[len] = ch;
5478 return FAIL;
5482 return OK;
5486 * ":command ..."
5488 static void
5489 ex_command(eap)
5490 exarg_T *eap;
5492 char_u *name;
5493 char_u *end;
5494 char_u *p;
5495 long argt = 0;
5496 long def = -1;
5497 int flags = 0;
5498 int compl = EXPAND_NOTHING;
5499 char_u *compl_arg = NULL;
5500 int has_attr = (eap->arg[0] == '-');
5502 p = eap->arg;
5504 /* Check for attributes */
5505 while (*p == '-')
5507 ++p;
5508 end = skiptowhite(p);
5509 if (uc_scan_attr(p, end - p, &argt, &def, &flags, &compl, &compl_arg)
5510 == FAIL)
5511 return;
5512 p = skipwhite(end);
5515 /* Get the name (if any) and skip to the following argument */
5516 name = p;
5517 if (ASCII_ISALPHA(*p))
5518 while (ASCII_ISALNUM(*p))
5519 ++p;
5520 if (!ends_excmd(*p) && !vim_iswhite(*p))
5522 EMSG(_("E182: Invalid command name"));
5523 return;
5525 end = p;
5527 /* If there is nothing after the name, and no attributes were specified,
5528 * we are listing commands
5530 p = skipwhite(end);
5531 if (!has_attr && ends_excmd(*p))
5533 uc_list(name, end - name);
5535 else if (!ASCII_ISUPPER(*name))
5537 EMSG(_("E183: User defined commands must start with an uppercase letter"));
5538 return;
5540 else
5541 uc_add_command(name, end - name, p, argt, def, flags, compl, compl_arg,
5542 eap->forceit);
5546 * ":comclear"
5547 * Clear all user commands, global and for current buffer.
5549 /*ARGSUSED*/
5550 void
5551 ex_comclear(eap)
5552 exarg_T *eap;
5554 uc_clear(&ucmds);
5555 uc_clear(&curbuf->b_ucmds);
5559 * Clear all user commands for "gap".
5561 void
5562 uc_clear(gap)
5563 garray_T *gap;
5565 int i;
5566 ucmd_T *cmd;
5568 for (i = 0; i < gap->ga_len; ++i)
5570 cmd = USER_CMD_GA(gap, i);
5571 vim_free(cmd->uc_name);
5572 vim_free(cmd->uc_rep);
5573 # if defined(FEAT_EVAL) && defined(FEAT_CMDL_COMPL)
5574 vim_free(cmd->uc_compl_arg);
5575 # endif
5577 ga_clear(gap);
5580 static void
5581 ex_delcommand(eap)
5582 exarg_T *eap;
5584 int i = 0;
5585 ucmd_T *cmd = NULL;
5586 int cmp = -1;
5587 garray_T *gap;
5589 gap = &curbuf->b_ucmds;
5590 for (;;)
5592 for (i = 0; i < gap->ga_len; ++i)
5594 cmd = USER_CMD_GA(gap, i);
5595 cmp = STRCMP(eap->arg, cmd->uc_name);
5596 if (cmp <= 0)
5597 break;
5599 if (gap == &ucmds || cmp == 0)
5600 break;
5601 gap = &ucmds;
5604 if (cmp != 0)
5606 EMSG2(_("E184: No such user-defined command: %s"), eap->arg);
5607 return;
5610 vim_free(cmd->uc_name);
5611 vim_free(cmd->uc_rep);
5612 # if defined(FEAT_EVAL) && defined(FEAT_CMDL_COMPL)
5613 vim_free(cmd->uc_compl_arg);
5614 # endif
5616 --gap->ga_len;
5618 if (i < gap->ga_len)
5619 mch_memmove(cmd, cmd + 1, (gap->ga_len - i) * sizeof(ucmd_T));
5623 * split and quote args for <f-args>
5625 static char_u *
5626 uc_split_args(arg, lenp)
5627 char_u *arg;
5628 size_t *lenp;
5630 char_u *buf;
5631 char_u *p;
5632 char_u *q;
5633 int len;
5635 /* Precalculate length */
5636 p = arg;
5637 len = 2; /* Initial and final quotes */
5639 while (*p)
5641 if (p[0] == '\\' && p[1] == '\\')
5643 len += 2;
5644 p += 2;
5646 else if (p[0] == '\\' && vim_iswhite(p[1]))
5648 len += 1;
5649 p += 2;
5651 else if (*p == '\\' || *p == '"')
5653 len += 2;
5654 p += 1;
5656 else if (vim_iswhite(*p))
5658 p = skipwhite(p);
5659 if (*p == NUL)
5660 break;
5661 len += 3; /* "," */
5663 else
5665 ++len;
5666 ++p;
5670 buf = alloc(len + 1);
5671 if (buf == NULL)
5673 *lenp = 0;
5674 return buf;
5677 p = arg;
5678 q = buf;
5679 *q++ = '"';
5680 while (*p)
5682 if (p[0] == '\\' && p[1] == '\\')
5684 *q++ = '\\';
5685 *q++ = '\\';
5686 p += 2;
5688 else if (p[0] == '\\' && vim_iswhite(p[1]))
5690 *q++ = p[1];
5691 p += 2;
5693 else if (*p == '\\' || *p == '"')
5695 *q++ = '\\';
5696 *q++ = *p++;
5698 else if (vim_iswhite(*p))
5700 p = skipwhite(p);
5701 if (*p == NUL)
5702 break;
5703 *q++ = '"';
5704 *q++ = ',';
5705 *q++ = '"';
5707 else
5709 *q++ = *p++;
5712 *q++ = '"';
5713 *q = 0;
5715 *lenp = len;
5716 return buf;
5720 * Check for a <> code in a user command.
5721 * "code" points to the '<'. "len" the length of the <> (inclusive).
5722 * "buf" is where the result is to be added.
5723 * "split_buf" points to a buffer used for splitting, caller should free it.
5724 * "split_len" is the length of what "split_buf" contains.
5725 * Returns the length of the replacement, which has been added to "buf".
5726 * Returns -1 if there was no match, and only the "<" has been copied.
5728 static size_t
5729 uc_check_code(code, len, buf, cmd, eap, split_buf, split_len)
5730 char_u *code;
5731 size_t len;
5732 char_u *buf;
5733 ucmd_T *cmd; /* the user command we're expanding */
5734 exarg_T *eap; /* ex arguments */
5735 char_u **split_buf;
5736 size_t *split_len;
5738 size_t result = 0;
5739 char_u *p = code + 1;
5740 size_t l = len - 2;
5741 int quote = 0;
5742 enum { ct_ARGS, ct_BANG, ct_COUNT, ct_LINE1, ct_LINE2, ct_REGISTER,
5743 ct_LT, ct_NONE } type = ct_NONE;
5745 if ((vim_strchr((char_u *)"qQfF", *p) != NULL) && p[1] == '-')
5747 quote = (*p == 'q' || *p == 'Q') ? 1 : 2;
5748 p += 2;
5749 l -= 2;
5752 ++l;
5753 if (l <= 1)
5754 type = ct_NONE;
5755 else if (STRNICMP(p, "args>", l) == 0)
5756 type = ct_ARGS;
5757 else if (STRNICMP(p, "bang>", l) == 0)
5758 type = ct_BANG;
5759 else if (STRNICMP(p, "count>", l) == 0)
5760 type = ct_COUNT;
5761 else if (STRNICMP(p, "line1>", l) == 0)
5762 type = ct_LINE1;
5763 else if (STRNICMP(p, "line2>", l) == 0)
5764 type = ct_LINE2;
5765 else if (STRNICMP(p, "lt>", l) == 0)
5766 type = ct_LT;
5767 else if (STRNICMP(p, "reg>", l) == 0 || STRNICMP(p, "register>", l) == 0)
5768 type = ct_REGISTER;
5770 switch (type)
5772 case ct_ARGS:
5773 /* Simple case first */
5774 if (*eap->arg == NUL)
5776 if (quote == 1)
5778 result = 2;
5779 if (buf != NULL)
5780 STRCPY(buf, "''");
5782 else
5783 result = 0;
5784 break;
5787 /* When specified there is a single argument don't split it.
5788 * Works for ":Cmd %" when % is "a b c". */
5789 if ((eap->argt & NOSPC) && quote == 2)
5790 quote = 1;
5792 switch (quote)
5794 case 0: /* No quoting, no splitting */
5795 result = STRLEN(eap->arg);
5796 if (buf != NULL)
5797 STRCPY(buf, eap->arg);
5798 break;
5799 case 1: /* Quote, but don't split */
5800 result = STRLEN(eap->arg) + 2;
5801 for (p = eap->arg; *p; ++p)
5803 if (*p == '\\' || *p == '"')
5804 ++result;
5807 if (buf != NULL)
5809 *buf++ = '"';
5810 for (p = eap->arg; *p; ++p)
5812 if (*p == '\\' || *p == '"')
5813 *buf++ = '\\';
5814 *buf++ = *p;
5816 *buf = '"';
5819 break;
5820 case 2: /* Quote and split (<f-args>) */
5821 /* This is hard, so only do it once, and cache the result */
5822 if (*split_buf == NULL)
5823 *split_buf = uc_split_args(eap->arg, split_len);
5825 result = *split_len;
5826 if (buf != NULL && result != 0)
5827 STRCPY(buf, *split_buf);
5829 break;
5831 break;
5833 case ct_BANG:
5834 result = eap->forceit ? 1 : 0;
5835 if (quote)
5836 result += 2;
5837 if (buf != NULL)
5839 if (quote)
5840 *buf++ = '"';
5841 if (eap->forceit)
5842 *buf++ = '!';
5843 if (quote)
5844 *buf = '"';
5846 break;
5848 case ct_LINE1:
5849 case ct_LINE2:
5850 case ct_COUNT:
5852 char num_buf[20];
5853 long num = (type == ct_LINE1) ? eap->line1 :
5854 (type == ct_LINE2) ? eap->line2 :
5855 (eap->addr_count > 0) ? eap->line2 : cmd->uc_def;
5856 size_t num_len;
5858 sprintf(num_buf, "%ld", num);
5859 num_len = STRLEN(num_buf);
5860 result = num_len;
5862 if (quote)
5863 result += 2;
5865 if (buf != NULL)
5867 if (quote)
5868 *buf++ = '"';
5869 STRCPY(buf, num_buf);
5870 buf += num_len;
5871 if (quote)
5872 *buf = '"';
5875 break;
5878 case ct_REGISTER:
5879 result = eap->regname ? 1 : 0;
5880 if (quote)
5881 result += 2;
5882 if (buf != NULL)
5884 if (quote)
5885 *buf++ = '\'';
5886 if (eap->regname)
5887 *buf++ = eap->regname;
5888 if (quote)
5889 *buf = '\'';
5891 break;
5893 case ct_LT:
5894 result = 1;
5895 if (buf != NULL)
5896 *buf = '<';
5897 break;
5899 default:
5900 /* Not recognized: just copy the '<' and return -1. */
5901 result = (size_t)-1;
5902 if (buf != NULL)
5903 *buf = '<';
5904 break;
5907 return result;
5910 static void
5911 do_ucmd(eap)
5912 exarg_T *eap;
5914 char_u *buf;
5915 char_u *p;
5916 char_u *q;
5918 char_u *start;
5919 char_u *end = NULL;
5920 char_u *ksp;
5921 size_t len, totlen;
5923 size_t split_len = 0;
5924 char_u *split_buf = NULL;
5925 ucmd_T *cmd;
5926 #ifdef FEAT_EVAL
5927 scid_T save_current_SID = current_SID;
5928 #endif
5930 if (eap->cmdidx == CMD_USER)
5931 cmd = USER_CMD(eap->useridx);
5932 else
5933 cmd = USER_CMD_GA(&curbuf->b_ucmds, eap->useridx);
5936 * Replace <> in the command by the arguments.
5937 * First round: "buf" is NULL, compute length, allocate "buf".
5938 * Second round: copy result into "buf".
5940 buf = NULL;
5941 for (;;)
5943 p = cmd->uc_rep; /* source */
5944 q = buf; /* destinateion */
5945 totlen = 0;
5947 for (;;)
5949 start = vim_strchr(p, '<');
5950 if (start != NULL)
5951 end = vim_strchr(start + 1, '>');
5952 if (buf != NULL)
5954 ksp = vim_strchr(p, K_SPECIAL);
5955 if (ksp != NULL && (start == NULL || ksp < start || end == NULL)
5956 && ((ksp[1] == KS_SPECIAL && ksp[2] == KE_FILLER)
5957 # ifdef FEAT_GUI
5958 || (ksp[1] == KS_EXTRA && ksp[2] == (int)KE_CSI)
5959 # endif
5962 /* K_SPECIAL han been put in the buffer as K_SPECIAL
5963 * KS_SPECIAL KE_FILLER, like for mappings, but
5964 * do_cmdline() doesn't handle that, so convert it back.
5965 * Also change K_SPECIAL KS_EXTRA KE_CSI into CSI. */
5966 len = ksp - p;
5967 if (len > 0)
5969 mch_memmove(q, p, len);
5970 q += len;
5972 *q++ = ksp[1] == KS_SPECIAL ? K_SPECIAL : CSI;
5973 p = ksp + 3;
5974 continue;
5978 /* break if there no <item> is found */
5979 if (start == NULL || end == NULL)
5980 break;
5982 /* Include the '>' */
5983 ++end;
5985 /* Take everything up to the '<' */
5986 len = start - p;
5987 if (buf == NULL)
5988 totlen += len;
5989 else
5991 mch_memmove(q, p, len);
5992 q += len;
5995 len = uc_check_code(start, end - start, q, cmd, eap,
5996 &split_buf, &split_len);
5997 if (len == (size_t)-1)
5999 /* no match, continue after '<' */
6000 p = start + 1;
6001 len = 1;
6003 else
6004 p = end;
6005 if (buf == NULL)
6006 totlen += len;
6007 else
6008 q += len;
6010 if (buf != NULL) /* second time here, finished */
6012 STRCPY(q, p);
6013 break;
6016 totlen += STRLEN(p); /* Add on the trailing characters */
6017 buf = alloc((unsigned)(totlen + 1));
6018 if (buf == NULL)
6020 vim_free(split_buf);
6021 return;
6025 #ifdef FEAT_EVAL
6026 current_SID = cmd->uc_scriptID;
6027 #endif
6028 (void)do_cmdline(buf, eap->getline, eap->cookie,
6029 DOCMD_VERBOSE|DOCMD_NOWAIT|DOCMD_KEYTYPED);
6030 #ifdef FEAT_EVAL
6031 current_SID = save_current_SID;
6032 #endif
6033 vim_free(buf);
6034 vim_free(split_buf);
6037 # if defined(FEAT_CMDL_COMPL) || defined(PROTO)
6038 static char_u *
6039 get_user_command_name(idx)
6040 int idx;
6042 return get_user_commands(NULL, idx - (int)CMD_SIZE);
6046 * Function given to ExpandGeneric() to obtain the list of user command names.
6048 /*ARGSUSED*/
6049 char_u *
6050 get_user_commands(xp, idx)
6051 expand_T *xp;
6052 int idx;
6054 if (idx < curbuf->b_ucmds.ga_len)
6055 return USER_CMD_GA(&curbuf->b_ucmds, idx)->uc_name;
6056 idx -= curbuf->b_ucmds.ga_len;
6057 if (idx < ucmds.ga_len)
6058 return USER_CMD(idx)->uc_name;
6059 return NULL;
6063 * Function given to ExpandGeneric() to obtain the list of user command
6064 * attributes.
6066 /*ARGSUSED*/
6067 char_u *
6068 get_user_cmd_flags(xp, idx)
6069 expand_T *xp;
6070 int idx;
6072 static char *user_cmd_flags[] =
6073 {"bang", "bar", "buffer", "complete", "count",
6074 "nargs", "range", "register"};
6076 if (idx >= sizeof(user_cmd_flags) / sizeof(user_cmd_flags[0]))
6077 return NULL;
6078 return (char_u *)user_cmd_flags[idx];
6082 * Function given to ExpandGeneric() to obtain the list of values for -nargs.
6084 /*ARGSUSED*/
6085 char_u *
6086 get_user_cmd_nargs(xp, idx)
6087 expand_T *xp;
6088 int idx;
6090 static char *user_cmd_nargs[] = {"0", "1", "*", "?", "+"};
6092 if (idx >= sizeof(user_cmd_nargs) / sizeof(user_cmd_nargs[0]))
6093 return NULL;
6094 return (char_u *)user_cmd_nargs[idx];
6098 * Function given to ExpandGeneric() to obtain the list of values for -complete.
6100 /*ARGSUSED*/
6101 char_u *
6102 get_user_cmd_complete(xp, idx)
6103 expand_T *xp;
6104 int idx;
6106 return (char_u *)command_complete[idx].name;
6108 # endif /* FEAT_CMDL_COMPL */
6110 #endif /* FEAT_USR_CMDS */
6112 #if defined(FEAT_USR_CMDS) || defined(FEAT_EVAL) || defined(PROTO)
6114 * Parse a completion argument "value[vallen]".
6115 * The detected completion goes in "*complp", argument type in "*argt".
6116 * When there is an argument, for function and user defined completion, it's
6117 * copied to allocated memory and stored in "*compl_arg".
6118 * Returns FAIL if something is wrong.
6121 parse_compl_arg(value, vallen, complp, argt, compl_arg)
6122 char_u *value;
6123 int vallen;
6124 int *complp;
6125 long *argt;
6126 char_u **compl_arg;
6128 char_u *arg = NULL;
6129 size_t arglen = 0;
6130 int i;
6131 int valend = vallen;
6133 /* Look for any argument part - which is the part after any ',' */
6134 for (i = 0; i < vallen; ++i)
6136 if (value[i] == ',')
6138 arg = &value[i + 1];
6139 arglen = vallen - i - 1;
6140 valend = i;
6141 break;
6145 for (i = 0; command_complete[i].expand != 0; ++i)
6147 if ((int)STRLEN(command_complete[i].name) == valend
6148 && STRNCMP(value, command_complete[i].name, valend) == 0)
6150 *complp = command_complete[i].expand;
6151 if (command_complete[i].expand == EXPAND_BUFFERS)
6152 *argt |= BUFNAME;
6153 else if (command_complete[i].expand == EXPAND_DIRECTORIES
6154 || command_complete[i].expand == EXPAND_FILES)
6155 *argt |= XFILE;
6156 break;
6160 if (command_complete[i].expand == 0)
6162 EMSG2(_("E180: Invalid complete value: %s"), value);
6163 return FAIL;
6166 # if defined(FEAT_EVAL) && defined(FEAT_CMDL_COMPL)
6167 if (*complp != EXPAND_USER_DEFINED && *complp != EXPAND_USER_LIST
6168 && arg != NULL)
6169 # else
6170 if (arg != NULL)
6171 # endif
6173 EMSG(_("E468: Completion argument only allowed for custom completion"));
6174 return FAIL;
6177 # if defined(FEAT_EVAL) && defined(FEAT_CMDL_COMPL)
6178 if ((*complp == EXPAND_USER_DEFINED || *complp == EXPAND_USER_LIST)
6179 && arg == NULL)
6181 EMSG(_("E467: Custom completion requires a function argument"));
6182 return FAIL;
6185 if (arg != NULL)
6186 *compl_arg = vim_strnsave(arg, (int)arglen);
6187 # endif
6188 return OK;
6190 #endif
6192 static void
6193 ex_colorscheme(eap)
6194 exarg_T *eap;
6196 if (load_colors(eap->arg) == FAIL)
6197 EMSG2(_("E185: Cannot find color scheme %s"), eap->arg);
6200 static void
6201 ex_highlight(eap)
6202 exarg_T *eap;
6204 if (*eap->arg == NUL && eap->cmd[2] == '!')
6205 MSG(_("Greetings, Vim user!"));
6206 do_highlight(eap->arg, eap->forceit, FALSE);
6211 * Call this function if we thought we were going to exit, but we won't
6212 * (because of an error). May need to restore the terminal mode.
6214 void
6215 not_exiting()
6217 exiting = FALSE;
6218 settmode(TMODE_RAW);
6222 * ":quit": quit current window, quit Vim if closed the last window.
6224 static void
6225 ex_quit(eap)
6226 exarg_T *eap;
6228 #ifdef FEAT_CMDWIN
6229 if (cmdwin_type != 0)
6231 cmdwin_result = Ctrl_C;
6232 return;
6234 #endif
6235 /* Don't quit while editing the command line. */
6236 if (text_locked())
6238 text_locked_msg();
6239 return;
6241 #ifdef FEAT_AUTOCMD
6242 if (curbuf_locked())
6243 return;
6244 #endif
6246 #ifdef FEAT_NETBEANS_INTG
6247 netbeansForcedQuit = eap->forceit;
6248 #endif
6251 * If there are more files or windows we won't exit.
6253 if (check_more(FALSE, eap->forceit) == OK && only_one_window())
6254 exiting = TRUE;
6255 if ((!P_HID(curbuf)
6256 && check_changed(curbuf, p_awa, FALSE, eap->forceit, FALSE))
6257 || check_more(TRUE, eap->forceit) == FAIL
6258 || (only_one_window() && check_changed_any(eap->forceit)))
6260 not_exiting();
6262 else
6264 #ifdef FEAT_WINDOWS
6265 if (only_one_window()) /* quit last window */
6266 #endif
6267 getout(0);
6268 #ifdef FEAT_WINDOWS
6269 # ifdef FEAT_GUI
6270 need_mouse_correct = TRUE;
6271 # endif
6272 /* close window; may free buffer */
6273 win_close(curwin, !P_HID(curwin->w_buffer) || eap->forceit);
6274 #endif
6279 * ":cquit".
6281 /*ARGSUSED*/
6282 static void
6283 ex_cquit(eap)
6284 exarg_T *eap;
6286 getout(1); /* this does not always pass on the exit code to the Manx
6287 compiler. why? */
6291 * ":qall": try to quit all windows
6293 static void
6294 ex_quit_all(eap)
6295 exarg_T *eap;
6297 # ifdef FEAT_CMDWIN
6298 if (cmdwin_type != 0)
6300 if (eap->forceit)
6301 cmdwin_result = K_XF1; /* ex_window() takes care of this */
6302 else
6303 cmdwin_result = K_XF2;
6304 return;
6306 # endif
6308 /* Don't quit while editing the command line. */
6309 if (text_locked())
6311 text_locked_msg();
6312 return;
6314 #ifdef FEAT_AUTOCMD
6315 if (curbuf_locked())
6316 return;
6317 #endif
6319 exiting = TRUE;
6320 if (eap->forceit || !check_changed_any(FALSE))
6321 getout(0);
6322 not_exiting();
6325 #if defined(FEAT_WINDOWS) || defined(PROTO)
6327 * ":close": close current window, unless it is the last one
6329 static void
6330 ex_close(eap)
6331 exarg_T *eap;
6333 # ifdef FEAT_CMDWIN
6334 if (cmdwin_type != 0)
6335 cmdwin_result = K_IGNORE;
6336 else
6337 # endif
6338 if (!text_locked()
6339 #ifdef FEAT_AUTOCMD
6340 && !curbuf_locked()
6341 #endif
6343 ex_win_close(eap->forceit, curwin, NULL);
6346 # ifdef FEAT_QUICKFIX
6348 * ":pclose": Close any preview window.
6350 static void
6351 ex_pclose(eap)
6352 exarg_T *eap;
6354 win_T *win;
6356 for (win = firstwin; win != NULL; win = win->w_next)
6357 if (win->w_p_pvw)
6359 ex_win_close(eap->forceit, win, NULL);
6360 break;
6363 # endif
6366 * Close window "win" and take care of handling closing the last window for a
6367 * modified buffer.
6369 static void
6370 ex_win_close(forceit, win, tp)
6371 int forceit;
6372 win_T *win;
6373 tabpage_T *tp; /* NULL or the tab page "win" is in */
6375 int need_hide;
6376 buf_T *buf = win->w_buffer;
6378 need_hide = (bufIsChanged(buf) && buf->b_nwindows <= 1);
6379 if (need_hide && !P_HID(buf) && !forceit)
6381 # if defined(FEAT_GUI_DIALOG) || defined(FEAT_CON_DIALOG)
6382 if ((p_confirm || cmdmod.confirm) && p_write)
6384 dialog_changed(buf, FALSE);
6385 if (buf_valid(buf) && bufIsChanged(buf))
6386 return;
6387 need_hide = FALSE;
6389 else
6390 # endif
6392 EMSG(_(e_nowrtmsg));
6393 return;
6397 # ifdef FEAT_GUI
6398 need_mouse_correct = TRUE;
6399 # endif
6401 /* free buffer when not hiding it or when it's a scratch buffer */
6402 if (tp == NULL)
6403 win_close(win, !need_hide && !P_HID(buf));
6404 else
6405 win_close_othertab(win, !need_hide && !P_HID(buf), tp);
6409 * ":tabclose": close current tab page, unless it is the last one.
6410 * ":tabclose N": close tab page N.
6412 static void
6413 ex_tabclose(eap)
6414 exarg_T *eap;
6416 tabpage_T *tp;
6418 # ifdef FEAT_CMDWIN
6419 if (cmdwin_type != 0)
6420 cmdwin_result = K_IGNORE;
6421 else
6422 # endif
6423 if (first_tabpage->tp_next == NULL)
6424 EMSG(_("E784: Cannot close last tab page"));
6425 else
6427 if (eap->addr_count > 0)
6429 tp = find_tabpage((int)eap->line2);
6430 if (tp == NULL)
6432 beep_flush();
6433 return;
6435 if (tp != curtab)
6437 tabpage_close_other(tp, eap->forceit);
6438 return;
6441 if (!text_locked()
6442 #ifdef FEAT_AUTOCMD
6443 && !curbuf_locked()
6444 #endif
6446 tabpage_close(eap->forceit);
6451 * ":tabonly": close all tab pages except the current one
6453 static void
6454 ex_tabonly(eap)
6455 exarg_T *eap;
6457 tabpage_T *tp;
6458 int done;
6460 # ifdef FEAT_CMDWIN
6461 if (cmdwin_type != 0)
6462 cmdwin_result = K_IGNORE;
6463 else
6464 # endif
6465 if (first_tabpage->tp_next == NULL)
6466 MSG(_("Already only one tab page"));
6467 else
6469 /* Repeat this up to a 1000 times, because autocommands may mess
6470 * up the lists. */
6471 for (done = 0; done < 1000; ++done)
6473 for (tp = first_tabpage; tp != NULL; tp = tp->tp_next)
6474 if (tp->tp_topframe != topframe)
6476 tabpage_close_other(tp, eap->forceit);
6477 /* if we failed to close it quit */
6478 if (valid_tabpage(tp))
6479 done = 1000;
6480 /* start over, "tp" is now invalid */
6481 break;
6483 if (first_tabpage->tp_next == NULL)
6484 break;
6490 * Close the current tab page.
6492 void
6493 tabpage_close(forceit)
6494 int forceit;
6496 /* First close all the windows but the current one. If that worked then
6497 * close the last window in this tab, that will close it. */
6498 if (lastwin != firstwin)
6499 close_others(TRUE, forceit);
6500 if (lastwin == firstwin)
6501 ex_win_close(forceit, curwin, NULL);
6502 # ifdef FEAT_GUI
6503 need_mouse_correct = TRUE;
6504 # endif
6508 * Close tab page "tp", which is not the current tab page.
6509 * Note that autocommands may make "tp" invalid.
6510 * Also takes care of the tab pages line disappearing when closing the
6511 * last-but-one tab page.
6513 void
6514 tabpage_close_other(tp, forceit)
6515 tabpage_T *tp;
6516 int forceit;
6518 int done = 0;
6519 win_T *wp;
6520 int h = tabline_height();
6522 /* Limit to 1000 windows, autocommands may add a window while we close
6523 * one. OK, so I'm paranoid... */
6524 while (++done < 1000)
6526 wp = tp->tp_firstwin;
6527 ex_win_close(forceit, wp, tp);
6529 /* Autocommands may delete the tab page under our fingers and we may
6530 * fail to close a window with a modified buffer. */
6531 if (!valid_tabpage(tp) || tp->tp_firstwin == wp)
6532 break;
6535 redraw_tabline = TRUE;
6536 if (h != tabline_height())
6537 shell_new_rows();
6541 * ":only".
6543 static void
6544 ex_only(eap)
6545 exarg_T *eap;
6547 # ifdef FEAT_GUI
6548 need_mouse_correct = TRUE;
6549 # endif
6550 close_others(TRUE, eap->forceit);
6554 * ":all" and ":sall".
6555 * Also used for ":tab drop file ..." after setting the argument list.
6557 void
6558 ex_all(eap)
6559 exarg_T *eap;
6561 if (eap->addr_count == 0)
6562 eap->line2 = 9999;
6563 do_arg_all((int)eap->line2, eap->forceit, eap->cmdidx == CMD_drop);
6565 #endif /* FEAT_WINDOWS */
6567 static void
6568 ex_hide(eap)
6569 exarg_T *eap;
6571 if (*eap->arg != NUL && check_nextcmd(eap->arg) == NULL)
6572 eap->errmsg = e_invarg;
6573 else
6575 /* ":hide" or ":hide | cmd": hide current window */
6576 eap->nextcmd = check_nextcmd(eap->arg);
6577 #ifdef FEAT_WINDOWS
6578 if (!eap->skip)
6580 # ifdef FEAT_GUI
6581 need_mouse_correct = TRUE;
6582 # endif
6583 win_close(curwin, FALSE); /* don't free buffer */
6585 #endif
6590 * ":stop" and ":suspend": Suspend Vim.
6592 static void
6593 ex_stop(eap)
6594 exarg_T *eap;
6597 * Disallow suspending for "rvim".
6599 if (!check_restricted()
6600 #ifdef WIN3264
6602 * Check if external commands are allowed now.
6604 && can_end_termcap_mode(TRUE)
6605 #endif
6608 if (!eap->forceit)
6609 autowrite_all();
6610 windgoto((int)Rows - 1, 0);
6611 out_char('\n');
6612 out_flush();
6613 stoptermcap();
6614 out_flush(); /* needed for SUN to restore xterm buffer */
6615 #ifdef FEAT_TITLE
6616 mch_restore_title(3); /* restore window titles */
6617 #endif
6618 ui_suspend(); /* call machine specific function */
6619 #ifdef FEAT_TITLE
6620 maketitle();
6621 resettitle(); /* force updating the title */
6622 #endif
6623 starttermcap();
6624 scroll_start(); /* scroll screen before redrawing */
6625 redraw_later_clear();
6626 shell_resized(); /* may have resized window */
6631 * ":exit", ":xit" and ":wq": Write file and exit Vim.
6633 static void
6634 ex_exit(eap)
6635 exarg_T *eap;
6637 #ifdef FEAT_CMDWIN
6638 if (cmdwin_type != 0)
6640 cmdwin_result = Ctrl_C;
6641 return;
6643 #endif
6644 /* Don't quit while editing the command line. */
6645 if (text_locked())
6647 text_locked_msg();
6648 return;
6650 #ifdef FEAT_AUTOCMD
6651 if (curbuf_locked())
6652 return;
6653 #endif
6656 * if more files or windows we won't exit
6658 if (check_more(FALSE, eap->forceit) == OK && only_one_window())
6659 exiting = TRUE;
6660 if ( ((eap->cmdidx == CMD_wq
6661 || curbufIsChanged())
6662 && do_write(eap) == FAIL)
6663 || check_more(TRUE, eap->forceit) == FAIL
6664 || (only_one_window() && check_changed_any(eap->forceit)))
6666 not_exiting();
6668 else
6670 #ifdef FEAT_WINDOWS
6671 if (only_one_window()) /* quit last window, exit Vim */
6672 #endif
6673 getout(0);
6674 #ifdef FEAT_WINDOWS
6675 # ifdef FEAT_GUI
6676 need_mouse_correct = TRUE;
6677 # endif
6678 /* quit current window, may free buffer */
6679 win_close(curwin, !P_HID(curwin->w_buffer));
6680 #endif
6685 * ":print", ":list", ":number".
6687 static void
6688 ex_print(eap)
6689 exarg_T *eap;
6691 if (curbuf->b_ml.ml_flags & ML_EMPTY)
6692 EMSG(_(e_emptybuf));
6693 else
6695 for ( ;!got_int; ui_breakcheck())
6697 print_line(eap->line1,
6698 (eap->cmdidx == CMD_number || eap->cmdidx == CMD_pound
6699 || (eap->flags & EXFLAG_NR)),
6700 eap->cmdidx == CMD_list || (eap->flags & EXFLAG_LIST));
6701 if (++eap->line1 > eap->line2)
6702 break;
6703 out_flush(); /* show one line at a time */
6705 setpcmark();
6706 /* put cursor at last line */
6707 curwin->w_cursor.lnum = eap->line2;
6708 beginline(BL_SOL | BL_FIX);
6711 ex_no_reprint = TRUE;
6714 #ifdef FEAT_BYTEOFF
6715 static void
6716 ex_goto(eap)
6717 exarg_T *eap;
6719 goto_byte(eap->line2);
6721 #endif
6724 * ":shell".
6726 /*ARGSUSED*/
6727 static void
6728 ex_shell(eap)
6729 exarg_T *eap;
6731 do_shell(NULL, 0);
6734 #if (defined(FEAT_WINDOWS) && defined(HAVE_DROP_FILE)) \
6735 || (defined(FEAT_GUI_GTK) && defined(FEAT_DND)) \
6736 || defined(FEAT_GUI_MSWIN) \
6737 || defined(FEAT_GUI_MAC) \
6738 || defined(PROTO)
6741 * Handle a file drop. The code is here because a drop is *nearly* like an
6742 * :args command, but not quite (we have a list of exact filenames, so we
6743 * don't want to (a) parse a command line, or (b) expand wildcards. So the
6744 * code is very similar to :args and hence needs access to a lot of the static
6745 * functions in this file.
6747 * The list should be allocated using alloc(), as should each item in the
6748 * list. This function takes over responsibility for freeing the list.
6750 * XXX The list is made into the argument list. This is freed using
6751 * FreeWild(), which does a series of vim_free() calls, unless the two defines
6752 * __EMX__ and __ALWAYS_HAS_TRAILING_NUL_POINTER are set. In this case, a
6753 * routine _fnexplodefree() is used. This may cause problems, but as the drop
6754 * file functionality is (currently) not in EMX this is not presently a
6755 * problem.
6757 void
6758 handle_drop(filec, filev, split)
6759 int filec; /* the number of files dropped */
6760 char_u **filev; /* the list of files dropped */
6761 int split; /* force splitting the window */
6763 exarg_T ea;
6764 int save_msg_scroll = msg_scroll;
6766 /* Postpone this while editing the command line. */
6767 if (text_locked())
6768 return;
6769 #ifdef FEAT_AUTOCMD
6770 if (curbuf_locked())
6771 return;
6772 #endif
6773 /* When the screen is being updated we should not change buffers and
6774 * windows structures, it may cause freed memory to be used. */
6775 if (updating_screen)
6776 return;
6778 /* Check whether the current buffer is changed. If so, we will need
6779 * to split the current window or data could be lost.
6780 * We don't need to check if the 'hidden' option is set, as in this
6781 * case the buffer won't be lost.
6783 if (!P_HID(curbuf) && !split)
6785 ++emsg_off;
6786 split = check_changed(curbuf, TRUE, FALSE, FALSE, FALSE);
6787 --emsg_off;
6789 if (split)
6791 # ifdef FEAT_WINDOWS
6792 if (win_split(0, 0) == FAIL)
6793 return;
6794 # ifdef FEAT_SCROLLBIND
6795 curwin->w_p_scb = FALSE;
6796 # endif
6798 /* When splitting the window, create a new alist. Otherwise the
6799 * existing one is overwritten. */
6800 alist_unlink(curwin->w_alist);
6801 alist_new();
6802 # else
6803 return; /* can't split, always fail */
6804 # endif
6808 * Set up the new argument list.
6810 alist_set(ALIST(curwin), filec, filev, FALSE, NULL, 0);
6813 * Move to the first file.
6815 /* Fake up a minimal "next" command for do_argfile() */
6816 vim_memset(&ea, 0, sizeof(ea));
6817 ea.cmd = (char_u *)"next";
6818 do_argfile(&ea, 0);
6820 /* do_ecmd() may set need_start_insertmode, but since we never left Insert
6821 * mode that is not needed here. */
6822 need_start_insertmode = FALSE;
6824 /* Restore msg_scroll, otherwise a following command may cause scrolling
6825 * unexpectedly. The screen will be redrawn by the caller, thus
6826 * msg_scroll being set by displaying a message is irrelevant. */
6827 msg_scroll = save_msg_scroll;
6829 #endif
6832 * Clear an argument list: free all file names and reset it to zero entries.
6834 void
6835 alist_clear(al)
6836 alist_T *al;
6838 while (--al->al_ga.ga_len >= 0)
6839 vim_free(AARGLIST(al)[al->al_ga.ga_len].ae_fname);
6840 ga_clear(&al->al_ga);
6844 * Init an argument list.
6846 void
6847 alist_init(al)
6848 alist_T *al;
6850 ga_init2(&al->al_ga, (int)sizeof(aentry_T), 5);
6853 #if defined(FEAT_WINDOWS) || defined(PROTO)
6856 * Remove a reference from an argument list.
6857 * Ignored when the argument list is the global one.
6858 * If the argument list is no longer used by any window, free it.
6860 void
6861 alist_unlink(al)
6862 alist_T *al;
6864 if (al != &global_alist && --al->al_refcount <= 0)
6866 alist_clear(al);
6867 vim_free(al);
6871 # if defined(FEAT_LISTCMDS) || defined(HAVE_DROP_FILE) || defined(PROTO)
6873 * Create a new argument list and use it for the current window.
6875 void
6876 alist_new()
6878 curwin->w_alist = (alist_T *)alloc((unsigned)sizeof(alist_T));
6879 if (curwin->w_alist == NULL)
6881 curwin->w_alist = &global_alist;
6882 ++global_alist.al_refcount;
6884 else
6886 curwin->w_alist->al_refcount = 1;
6887 alist_init(curwin->w_alist);
6890 # endif
6891 #endif
6893 #if (!defined(UNIX) && !defined(__EMX__)) || defined(ARCHIE) || defined(PROTO)
6895 * Expand the file names in the global argument list.
6896 * If "fnum_list" is not NULL, use "fnum_list[fnum_len]" as a list of buffer
6897 * numbers to be re-used.
6899 void
6900 alist_expand(fnum_list, fnum_len)
6901 int *fnum_list;
6902 int fnum_len;
6904 char_u **old_arg_files;
6905 int old_arg_count;
6906 char_u **new_arg_files;
6907 int new_arg_file_count;
6908 char_u *save_p_su = p_su;
6909 int i;
6911 /* Don't use 'suffixes' here. This should work like the shell did the
6912 * expansion. Also, the vimrc file isn't read yet, thus the user
6913 * can't set the options. */
6914 p_su = empty_option;
6915 old_arg_files = (char_u **)alloc((unsigned)(sizeof(char_u *) * GARGCOUNT));
6916 if (old_arg_files != NULL)
6918 for (i = 0; i < GARGCOUNT; ++i)
6919 old_arg_files[i] = vim_strsave(GARGLIST[i].ae_fname);
6920 old_arg_count = GARGCOUNT;
6921 if (expand_wildcards(old_arg_count, old_arg_files,
6922 &new_arg_file_count, &new_arg_files,
6923 EW_FILE|EW_NOTFOUND|EW_ADDSLASH) == OK
6924 && new_arg_file_count > 0)
6926 alist_set(&global_alist, new_arg_file_count, new_arg_files,
6927 TRUE, fnum_list, fnum_len);
6928 FreeWild(old_arg_count, old_arg_files);
6931 p_su = save_p_su;
6933 #endif
6936 * Set the argument list for the current window.
6937 * Takes over the allocated files[] and the allocated fnames in it.
6939 void
6940 alist_set(al, count, files, use_curbuf, fnum_list, fnum_len)
6941 alist_T *al;
6942 int count;
6943 char_u **files;
6944 int use_curbuf;
6945 int *fnum_list;
6946 int fnum_len;
6948 int i;
6950 alist_clear(al);
6951 if (ga_grow(&al->al_ga, count) == OK)
6953 for (i = 0; i < count; ++i)
6955 if (got_int)
6957 /* When adding many buffers this can take a long time. Allow
6958 * interrupting here. */
6959 while (i < count)
6960 vim_free(files[i++]);
6961 break;
6964 /* May set buffer name of a buffer previously used for the
6965 * argument list, so that it's re-used by alist_add. */
6966 if (fnum_list != NULL && i < fnum_len)
6967 buf_set_name(fnum_list[i], files[i]);
6969 alist_add(al, files[i], use_curbuf ? 2 : 1);
6970 ui_breakcheck();
6972 vim_free(files);
6974 else
6975 FreeWild(count, files);
6976 #ifdef FEAT_WINDOWS
6977 if (al == &global_alist)
6978 #endif
6979 arg_had_last = FALSE;
6983 * Add file "fname" to argument list "al".
6984 * "fname" must have been allocated and "al" must have been checked for room.
6986 void
6987 alist_add(al, fname, set_fnum)
6988 alist_T *al;
6989 char_u *fname;
6990 int set_fnum; /* 1: set buffer number; 2: re-use curbuf */
6992 if (fname == NULL) /* don't add NULL file names */
6993 return;
6994 #ifdef BACKSLASH_IN_FILENAME
6995 slash_adjust(fname);
6996 #endif
6997 AARGLIST(al)[al->al_ga.ga_len].ae_fname = fname;
6998 if (set_fnum > 0)
6999 AARGLIST(al)[al->al_ga.ga_len].ae_fnum =
7000 buflist_add(fname, BLN_LISTED | (set_fnum == 2 ? BLN_CURBUF : 0));
7001 ++al->al_ga.ga_len;
7004 #if defined(BACKSLASH_IN_FILENAME) || defined(PROTO)
7006 * Adjust slashes in file names. Called after 'shellslash' was set.
7008 void
7009 alist_slash_adjust()
7011 int i;
7012 # ifdef FEAT_WINDOWS
7013 win_T *wp;
7014 tabpage_T *tp;
7015 # endif
7017 for (i = 0; i < GARGCOUNT; ++i)
7018 if (GARGLIST[i].ae_fname != NULL)
7019 slash_adjust(GARGLIST[i].ae_fname);
7020 # ifdef FEAT_WINDOWS
7021 FOR_ALL_TAB_WINDOWS(tp, wp)
7022 if (wp->w_alist != &global_alist)
7023 for (i = 0; i < WARGCOUNT(wp); ++i)
7024 if (WARGLIST(wp)[i].ae_fname != NULL)
7025 slash_adjust(WARGLIST(wp)[i].ae_fname);
7026 # endif
7028 #endif
7031 * ":preserve".
7033 /*ARGSUSED*/
7034 static void
7035 ex_preserve(eap)
7036 exarg_T *eap;
7038 curbuf->b_flags |= BF_PRESERVED;
7039 ml_preserve(curbuf, TRUE);
7043 * ":recover".
7045 static void
7046 ex_recover(eap)
7047 exarg_T *eap;
7049 /* Set recoverymode right away to avoid the ATTENTION prompt. */
7050 recoverymode = TRUE;
7051 if (!check_changed(curbuf, p_awa, TRUE, eap->forceit, FALSE)
7052 && (*eap->arg == NUL
7053 || setfname(curbuf, eap->arg, NULL, TRUE) == OK))
7054 ml_recover();
7055 recoverymode = FALSE;
7059 * Command modifier used in a wrong way.
7061 static void
7062 ex_wrongmodifier(eap)
7063 exarg_T *eap;
7065 eap->errmsg = e_invcmd;
7068 #ifdef FEAT_WINDOWS
7070 * :sview [+command] file split window with new file, read-only
7071 * :split [[+command] file] split window with current or new file
7072 * :vsplit [[+command] file] split window vertically with current or new file
7073 * :new [[+command] file] split window with no or new file
7074 * :vnew [[+command] file] split vertically window with no or new file
7075 * :sfind [+command] file split window with file in 'path'
7077 * :tabedit open new Tab page with empty window
7078 * :tabedit [+command] file open new Tab page and edit "file"
7079 * :tabnew [[+command] file] just like :tabedit
7080 * :tabfind [+command] file open new Tab page and find "file"
7082 void
7083 ex_splitview(eap)
7084 exarg_T *eap;
7086 win_T *old_curwin = curwin;
7087 # if defined(FEAT_SEARCHPATH) || defined(FEAT_BROWSE)
7088 char_u *fname = NULL;
7089 # endif
7090 # ifdef FEAT_BROWSE
7091 int browse_flag = cmdmod.browse;
7092 # endif
7094 # ifndef FEAT_VERTSPLIT
7095 if (eap->cmdidx == CMD_vsplit || eap->cmdidx == CMD_vnew)
7097 ex_ni(eap);
7098 return;
7100 # endif
7102 # ifdef FEAT_GUI
7103 need_mouse_correct = TRUE;
7104 # endif
7106 # ifdef FEAT_QUICKFIX
7107 /* A ":split" in the quickfix window works like ":new". Don't want two
7108 * quickfix windows. But it's OK when doing ":tab split". */
7109 if (bt_quickfix(curbuf) && cmdmod.tab == 0)
7111 if (eap->cmdidx == CMD_split)
7112 eap->cmdidx = CMD_new;
7113 # ifdef FEAT_VERTSPLIT
7114 if (eap->cmdidx == CMD_vsplit)
7115 eap->cmdidx = CMD_vnew;
7116 # endif
7118 # endif
7120 # ifdef FEAT_SEARCHPATH
7121 if (eap->cmdidx == CMD_sfind || eap->cmdidx == CMD_tabfind)
7123 fname = find_file_in_path(eap->arg, (int)STRLEN(eap->arg),
7124 FNAME_MESS, TRUE, curbuf->b_ffname);
7125 if (fname == NULL)
7126 goto theend;
7127 eap->arg = fname;
7129 # ifdef FEAT_BROWSE
7130 else
7131 # endif
7132 # endif
7133 # ifdef FEAT_BROWSE
7134 if (cmdmod.browse
7135 # ifdef FEAT_VERTSPLIT
7136 && eap->cmdidx != CMD_vnew
7137 # endif
7138 && eap->cmdidx != CMD_new)
7140 # ifdef FEAT_AUTOCMD
7141 if (
7142 # ifdef FEAT_GUI
7143 !gui.in_use &&
7144 # endif
7145 au_has_group((char_u *)"FileExplorer"))
7147 /* No browsing supported but we do have the file explorer:
7148 * Edit the directory. */
7149 if (*eap->arg == NUL || !mch_isdir(eap->arg))
7150 eap->arg = (char_u *)".";
7152 else
7153 # endif
7155 fname = do_browse(0, (char_u *)_("Edit File in new window"),
7156 eap->arg, NULL, NULL, NULL, curbuf);
7157 if (fname == NULL)
7158 goto theend;
7159 eap->arg = fname;
7162 cmdmod.browse = FALSE; /* Don't browse again in do_ecmd(). */
7163 # endif
7166 * Either open new tab page or split the window.
7168 if (eap->cmdidx == CMD_tabedit
7169 || eap->cmdidx == CMD_tabfind
7170 || eap->cmdidx == CMD_tabnew)
7172 if (win_new_tabpage(cmdmod.tab != 0 ? cmdmod.tab
7173 : eap->addr_count == 0 ? 0
7174 : (int)eap->line2 + 1) != FAIL)
7176 do_exedit(eap, old_curwin);
7178 /* set the alternate buffer for the window we came from */
7179 if (curwin != old_curwin
7180 && win_valid(old_curwin)
7181 && old_curwin->w_buffer != curbuf
7182 && !cmdmod.keepalt)
7183 old_curwin->w_alt_fnum = curbuf->b_fnum;
7186 else if (win_split(eap->addr_count > 0 ? (int)eap->line2 : 0,
7187 *eap->cmd == 'v' ? WSP_VERT : 0) != FAIL)
7189 # ifdef FEAT_SCROLLBIND
7190 /* Reset 'scrollbind' when editing another file, but keep it when
7191 * doing ":split" without arguments. */
7192 if (*eap->arg != NUL
7193 # ifdef FEAT_BROWSE
7194 || cmdmod.browse
7195 # endif
7197 curwin->w_p_scb = FALSE;
7198 else
7199 do_check_scrollbind(FALSE);
7200 # endif
7201 do_exedit(eap, old_curwin);
7204 # ifdef FEAT_BROWSE
7205 cmdmod.browse = browse_flag;
7206 # endif
7208 # if defined(FEAT_SEARCHPATH) || defined(FEAT_BROWSE)
7209 theend:
7210 vim_free(fname);
7211 # endif
7215 * Open a new tab page.
7217 void
7218 tabpage_new()
7220 exarg_T ea;
7222 vim_memset(&ea, 0, sizeof(ea));
7223 ea.cmdidx = CMD_tabnew;
7224 ea.cmd = (char_u *)"tabn";
7225 ea.arg = (char_u *)"";
7226 ex_splitview(&ea);
7230 * :tabnext command
7232 static void
7233 ex_tabnext(eap)
7234 exarg_T *eap;
7236 switch (eap->cmdidx)
7238 case CMD_tabfirst:
7239 case CMD_tabrewind:
7240 goto_tabpage(1);
7241 break;
7242 case CMD_tablast:
7243 goto_tabpage(9999);
7244 break;
7245 case CMD_tabprevious:
7246 case CMD_tabNext:
7247 goto_tabpage(eap->addr_count == 0 ? -1 : -(int)eap->line2);
7248 break;
7249 default: /* CMD_tabnext */
7250 goto_tabpage(eap->addr_count == 0 ? 0 : (int)eap->line2);
7251 break;
7256 * :tabmove command
7258 static void
7259 ex_tabmove(eap)
7260 exarg_T *eap;
7262 tabpage_move(eap->addr_count == 0 ? 9999 : (int)eap->line2);
7266 * :tabs command: List tabs and their contents.
7268 /*ARGSUSED*/
7269 static void
7270 ex_tabs(eap)
7271 exarg_T *eap;
7273 tabpage_T *tp;
7274 win_T *wp;
7275 int tabcount = 1;
7277 msg_start();
7278 msg_scroll = TRUE;
7279 for (tp = first_tabpage; tp != NULL && !got_int; tp = tp->tp_next)
7281 msg_putchar('\n');
7282 vim_snprintf((char *)IObuff, IOSIZE, _("Tab page %d"), tabcount++);
7283 msg_outtrans_attr(IObuff, hl_attr(HLF_T));
7284 out_flush(); /* output one line at a time */
7285 ui_breakcheck();
7287 if (tp == curtab)
7288 wp = firstwin;
7289 else
7290 wp = tp->tp_firstwin;
7291 for ( ; wp != NULL && !got_int; wp = wp->w_next)
7293 msg_putchar('\n');
7294 msg_putchar(wp == curwin ? '>' : ' ');
7295 msg_putchar(' ');
7296 msg_putchar(bufIsChanged(wp->w_buffer) ? '+' : ' ');
7297 msg_putchar(' ');
7298 if (buf_spname(wp->w_buffer) != NULL)
7299 STRCPY(IObuff, buf_spname(wp->w_buffer));
7300 else
7301 home_replace(wp->w_buffer, wp->w_buffer->b_fname,
7302 IObuff, IOSIZE, TRUE);
7303 msg_outtrans(IObuff);
7304 out_flush(); /* output one line at a time */
7305 ui_breakcheck();
7310 #endif /* FEAT_WINDOWS */
7313 * ":mode": Set screen mode.
7314 * If no argument given, just get the screen size and redraw.
7316 static void
7317 ex_mode(eap)
7318 exarg_T *eap;
7320 if (*eap->arg == NUL)
7321 shell_resized();
7322 else
7323 mch_screenmode(eap->arg);
7326 #ifdef FEAT_WINDOWS
7328 * ":resize".
7329 * set, increment or decrement current window height
7331 static void
7332 ex_resize(eap)
7333 exarg_T *eap;
7335 int n;
7336 win_T *wp = curwin;
7338 if (eap->addr_count > 0)
7340 n = eap->line2;
7341 for (wp = firstwin; wp->w_next != NULL && --n > 0; wp = wp->w_next)
7345 #ifdef FEAT_GUI
7346 need_mouse_correct = TRUE;
7347 #endif
7348 n = atol((char *)eap->arg);
7349 #ifdef FEAT_VERTSPLIT
7350 if (cmdmod.split & WSP_VERT)
7352 if (*eap->arg == '-' || *eap->arg == '+')
7353 n += W_WIDTH(curwin);
7354 else if (n == 0 && eap->arg[0] == NUL) /* default is very wide */
7355 n = 9999;
7356 win_setwidth_win((int)n, wp);
7358 else
7359 #endif
7361 if (*eap->arg == '-' || *eap->arg == '+')
7362 n += curwin->w_height;
7363 else if (n == 0 && eap->arg[0] == NUL) /* default is very wide */
7364 n = 9999;
7365 win_setheight_win((int)n, wp);
7368 #endif
7371 * ":find [+command] <file>" command.
7373 static void
7374 ex_find(eap)
7375 exarg_T *eap;
7377 #ifdef FEAT_SEARCHPATH
7378 char_u *fname;
7379 int count;
7381 fname = find_file_in_path(eap->arg, (int)STRLEN(eap->arg), FNAME_MESS,
7382 TRUE, curbuf->b_ffname);
7383 if (eap->addr_count > 0)
7385 /* Repeat finding the file "count" times. This matters when it
7386 * appears several times in the path. */
7387 count = eap->line2;
7388 while (fname != NULL && --count > 0)
7390 vim_free(fname);
7391 fname = find_file_in_path(NULL, 0, FNAME_MESS,
7392 FALSE, curbuf->b_ffname);
7396 if (fname != NULL)
7398 eap->arg = fname;
7399 #endif
7400 do_exedit(eap, NULL);
7401 #ifdef FEAT_SEARCHPATH
7402 vim_free(fname);
7404 #endif
7408 * ":open" simulation: for now just work like ":visual".
7410 static void
7411 ex_open(eap)
7412 exarg_T *eap;
7414 regmatch_T regmatch;
7415 char_u *p;
7417 curwin->w_cursor.lnum = eap->line2;
7418 beginline(BL_SOL | BL_FIX);
7419 if (*eap->arg == '/')
7421 /* ":open /pattern/": put cursor in column found with pattern */
7422 ++eap->arg;
7423 p = skip_regexp(eap->arg, '/', p_magic, NULL);
7424 *p = NUL;
7425 regmatch.regprog = vim_regcomp(eap->arg, p_magic ? RE_MAGIC : 0);
7426 if (regmatch.regprog != NULL)
7428 regmatch.rm_ic = p_ic;
7429 p = ml_get_curline();
7430 if (vim_regexec(&regmatch, p, (colnr_T)0))
7431 curwin->w_cursor.col = (colnr_T)(regmatch.startp[0] - p);
7432 else
7433 EMSG(_(e_nomatch));
7434 vim_free(regmatch.regprog);
7436 /* Move to the NUL, ignore any other arguments. */
7437 eap->arg += STRLEN(eap->arg);
7439 check_cursor();
7441 eap->cmdidx = CMD_visual;
7442 do_exedit(eap, NULL);
7446 * ":edit", ":badd", ":visual".
7448 static void
7449 ex_edit(eap)
7450 exarg_T *eap;
7452 do_exedit(eap, NULL);
7456 * ":edit <file>" command and alikes.
7458 /*ARGSUSED*/
7459 void
7460 do_exedit(eap, old_curwin)
7461 exarg_T *eap;
7462 win_T *old_curwin; /* curwin before doing a split or NULL */
7464 int n;
7465 #ifdef FEAT_WINDOWS
7466 int need_hide;
7467 #endif
7468 int exmode_was = exmode_active;
7471 * ":vi" command ends Ex mode.
7473 if (exmode_active && (eap->cmdidx == CMD_visual
7474 || eap->cmdidx == CMD_view))
7476 exmode_active = FALSE;
7477 if (*eap->arg == NUL)
7479 /* Special case: ":global/pat/visual\NLvi-commands" */
7480 if (global_busy)
7482 int rd = RedrawingDisabled;
7483 int nwr = no_wait_return;
7484 int ms = msg_scroll;
7485 #ifdef FEAT_GUI
7486 int he = hold_gui_events;
7487 #endif
7489 if (eap->nextcmd != NULL)
7491 stuffReadbuff(eap->nextcmd);
7492 eap->nextcmd = NULL;
7495 if (exmode_was != EXMODE_VIM)
7496 settmode(TMODE_RAW);
7497 RedrawingDisabled = 0;
7498 no_wait_return = 0;
7499 need_wait_return = FALSE;
7500 msg_scroll = 0;
7501 #ifdef FEAT_GUI
7502 hold_gui_events = 0;
7503 #endif
7504 must_redraw = CLEAR;
7506 main_loop(FALSE, TRUE);
7508 RedrawingDisabled = rd;
7509 no_wait_return = nwr;
7510 msg_scroll = ms;
7511 #ifdef FEAT_GUI
7512 hold_gui_events = he;
7513 #endif
7515 return;
7519 if ((eap->cmdidx == CMD_new
7520 || eap->cmdidx == CMD_tabnew
7521 || eap->cmdidx == CMD_tabedit
7522 #ifdef FEAT_VERTSPLIT
7523 || eap->cmdidx == CMD_vnew
7524 #endif
7525 ) && *eap->arg == NUL)
7527 /* ":new" or ":tabnew" without argument: edit an new empty buffer */
7528 setpcmark();
7529 (void)do_ecmd(0, NULL, NULL, eap, ECMD_ONE,
7530 ECMD_HIDE + (eap->forceit ? ECMD_FORCEIT : 0),
7531 old_curwin == NULL ? curwin : NULL);
7533 else if ((eap->cmdidx != CMD_split
7534 #ifdef FEAT_VERTSPLIT
7535 && eap->cmdidx != CMD_vsplit
7536 #endif
7538 || *eap->arg != NUL
7539 #ifdef FEAT_BROWSE
7540 || cmdmod.browse
7541 #endif
7544 #ifdef FEAT_AUTOCMD
7545 /* Can't edit another file when "curbuf_lock" is set. Only ":edit"
7546 * can bring us here, others are stopped earlier. */
7547 if (*eap->arg != NUL && curbuf_locked())
7548 return;
7549 #endif
7550 n = readonlymode;
7551 if (eap->cmdidx == CMD_view || eap->cmdidx == CMD_sview)
7552 readonlymode = TRUE;
7553 else if (eap->cmdidx == CMD_enew)
7554 readonlymode = FALSE; /* 'readonly' doesn't make sense in an
7555 empty buffer */
7556 setpcmark();
7557 if (do_ecmd(0, (eap->cmdidx == CMD_enew ? NULL : eap->arg),
7558 NULL, eap,
7559 /* ":edit" goes to first line if Vi compatible */
7560 (*eap->arg == NUL && eap->do_ecmd_lnum == 0
7561 && vim_strchr(p_cpo, CPO_GOTO1) != NULL)
7562 ? ECMD_ONE : eap->do_ecmd_lnum,
7563 (P_HID(curbuf) ? ECMD_HIDE : 0)
7564 + (eap->forceit ? ECMD_FORCEIT : 0)
7565 #ifdef FEAT_LISTCMDS
7566 + (eap->cmdidx == CMD_badd ? ECMD_ADDBUF : 0 )
7567 #endif
7568 , old_curwin == NULL ? curwin : NULL) == FAIL)
7570 /* Editing the file failed. If the window was split, close it. */
7571 #ifdef FEAT_WINDOWS
7572 if (old_curwin != NULL)
7574 need_hide = (curbufIsChanged() && curbuf->b_nwindows <= 1);
7575 if (!need_hide || P_HID(curbuf))
7577 # if defined(FEAT_AUTOCMD) && defined(FEAT_EVAL)
7578 cleanup_T cs;
7580 /* Reset the error/interrupt/exception state here so that
7581 * aborting() returns FALSE when closing a window. */
7582 enter_cleanup(&cs);
7583 # endif
7584 # ifdef FEAT_GUI
7585 need_mouse_correct = TRUE;
7586 # endif
7587 win_close(curwin, !need_hide && !P_HID(curbuf));
7589 # if defined(FEAT_AUTOCMD) && defined(FEAT_EVAL)
7590 /* Restore the error/interrupt/exception state if not
7591 * discarded by a new aborting error, interrupt, or
7592 * uncaught exception. */
7593 leave_cleanup(&cs);
7594 # endif
7597 #endif
7599 else if (readonlymode && curbuf->b_nwindows == 1)
7601 /* When editing an already visited buffer, 'readonly' won't be set
7602 * but the previous value is kept. With ":view" and ":sview" we
7603 * want the file to be readonly, except when another window is
7604 * editing the same buffer. */
7605 curbuf->b_p_ro = TRUE;
7607 readonlymode = n;
7609 else
7611 if (eap->do_ecmd_cmd != NULL)
7612 do_cmdline_cmd(eap->do_ecmd_cmd);
7613 #ifdef FEAT_TITLE
7614 n = curwin->w_arg_idx_invalid;
7615 #endif
7616 check_arg_idx(curwin);
7617 #ifdef FEAT_TITLE
7618 if (n != curwin->w_arg_idx_invalid)
7619 maketitle();
7620 #endif
7623 #ifdef FEAT_WINDOWS
7625 * if ":split file" worked, set alternate file name in old window to new
7626 * file
7628 if (old_curwin != NULL
7629 && *eap->arg != NUL
7630 && curwin != old_curwin
7631 && win_valid(old_curwin)
7632 && old_curwin->w_buffer != curbuf
7633 && !cmdmod.keepalt)
7634 old_curwin->w_alt_fnum = curbuf->b_fnum;
7635 #endif
7637 ex_no_reprint = TRUE;
7640 #ifndef FEAT_GUI
7642 * ":gui" and ":gvim" when there is no GUI.
7644 static void
7645 ex_nogui(eap)
7646 exarg_T *eap;
7648 eap->errmsg = e_nogvim;
7650 #endif
7652 #if defined(FEAT_GUI_W32) && defined(FEAT_MENU) && defined(FEAT_TEAROFF)
7653 static void
7654 ex_tearoff(eap)
7655 exarg_T *eap;
7657 gui_make_tearoff(eap->arg);
7659 #endif
7661 #if (defined(FEAT_GUI_MSWIN) || defined(FEAT_GUI_GTK)) && defined(FEAT_MENU)
7662 static void
7663 ex_popup(eap)
7664 exarg_T *eap;
7666 gui_make_popup(eap->arg, eap->forceit);
7668 #endif
7670 /*ARGSUSED*/
7671 static void
7672 ex_swapname(eap)
7673 exarg_T *eap;
7675 if (curbuf->b_ml.ml_mfp == NULL || curbuf->b_ml.ml_mfp->mf_fname == NULL)
7676 MSG(_("No swap file"));
7677 else
7678 msg(curbuf->b_ml.ml_mfp->mf_fname);
7682 * ":syncbind" forces all 'scrollbind' windows to have the same relative
7683 * offset.
7684 * (1998-11-02 16:21:01 R. Edward Ralston <eralston@computer.org>)
7686 /*ARGSUSED*/
7687 static void
7688 ex_syncbind(eap)
7689 exarg_T *eap;
7691 #ifdef FEAT_SCROLLBIND
7692 win_T *wp;
7693 long topline;
7694 long y;
7695 linenr_T old_linenr = curwin->w_cursor.lnum;
7697 setpcmark();
7700 * determine max topline
7702 if (curwin->w_p_scb)
7704 topline = curwin->w_topline;
7705 for (wp = firstwin; wp; wp = wp->w_next)
7707 if (wp->w_p_scb && wp->w_buffer)
7709 y = wp->w_buffer->b_ml.ml_line_count - p_so;
7710 if (topline > y)
7711 topline = y;
7714 if (topline < 1)
7715 topline = 1;
7717 else
7719 topline = 1;
7724 * set all scrollbind windows to the same topline
7726 wp = curwin;
7727 for (curwin = firstwin; curwin; curwin = curwin->w_next)
7729 if (curwin->w_p_scb)
7731 y = topline - curwin->w_topline;
7732 if (y > 0)
7733 scrollup(y, TRUE);
7734 else
7735 scrolldown(-y, TRUE);
7736 curwin->w_scbind_pos = topline;
7737 redraw_later(VALID);
7738 cursor_correct();
7739 #ifdef FEAT_WINDOWS
7740 curwin->w_redr_status = TRUE;
7741 #endif
7744 curwin = wp;
7745 if (curwin->w_p_scb)
7747 did_syncbind = TRUE;
7748 checkpcmark();
7749 if (old_linenr != curwin->w_cursor.lnum)
7751 char_u ctrl_o[2];
7753 ctrl_o[0] = Ctrl_O;
7754 ctrl_o[1] = 0;
7755 ins_typebuf(ctrl_o, REMAP_NONE, 0, TRUE, FALSE);
7758 #endif
7762 static void
7763 ex_read(eap)
7764 exarg_T *eap;
7766 int i;
7767 int empty = (curbuf->b_ml.ml_flags & ML_EMPTY);
7768 linenr_T lnum;
7770 if (eap->usefilter) /* :r!cmd */
7771 do_bang(1, eap, FALSE, FALSE, TRUE);
7772 else
7774 if (u_save(eap->line2, (linenr_T)(eap->line2 + 1)) == FAIL)
7775 return;
7777 #ifdef FEAT_BROWSE
7778 if (cmdmod.browse)
7780 char_u *browseFile;
7782 browseFile = do_browse(0, (char_u *)_("Append File"), eap->arg,
7783 NULL, NULL, NULL, curbuf);
7784 if (browseFile != NULL)
7786 i = readfile(browseFile, NULL,
7787 eap->line2, (linenr_T)0, (linenr_T)MAXLNUM, eap, 0);
7788 vim_free(browseFile);
7790 else
7791 i = OK;
7793 else
7794 #endif
7795 if (*eap->arg == NUL)
7797 if (check_fname() == FAIL) /* check for no file name */
7798 return;
7799 i = readfile(curbuf->b_ffname, curbuf->b_fname,
7800 eap->line2, (linenr_T)0, (linenr_T)MAXLNUM, eap, 0);
7802 else
7804 if (vim_strchr(p_cpo, CPO_ALTREAD) != NULL)
7805 (void)setaltfname(eap->arg, eap->arg, (linenr_T)1);
7806 i = readfile(eap->arg, NULL,
7807 eap->line2, (linenr_T)0, (linenr_T)MAXLNUM, eap, 0);
7810 if (i == FAIL)
7812 #if defined(FEAT_AUTOCMD) && defined(FEAT_EVAL)
7813 if (!aborting())
7814 #endif
7815 EMSG2(_(e_notopen), eap->arg);
7817 else
7819 if (empty && exmode_active)
7821 /* Delete the empty line that remains. Historically ex does
7822 * this but vi doesn't. */
7823 if (eap->line2 == 0)
7824 lnum = curbuf->b_ml.ml_line_count;
7825 else
7826 lnum = 1;
7827 if (*ml_get(lnum) == NUL && u_savedel(lnum, 1L) == OK)
7829 ml_delete(lnum, FALSE);
7830 deleted_lines_mark(lnum, 1L);
7831 if (curwin->w_cursor.lnum > 1
7832 && curwin->w_cursor.lnum >= lnum)
7833 --curwin->w_cursor.lnum;
7836 redraw_curbuf_later(VALID);
7841 static char_u *prev_dir = NULL;
7843 #if defined(EXITFREE) || defined(PROTO)
7844 void
7845 free_cd_dir()
7847 vim_free(prev_dir);
7848 prev_dir = NULL;
7850 #endif
7854 * ":cd", ":lcd", ":chdir" and ":lchdir".
7856 void
7857 ex_cd(eap)
7858 exarg_T *eap;
7860 char_u *new_dir;
7861 char_u *tofree;
7863 new_dir = eap->arg;
7864 #if !defined(UNIX) && !defined(VMS)
7865 /* for non-UNIX ":cd" means: print current directory */
7866 if (*new_dir == NUL)
7867 ex_pwd(NULL);
7868 else
7869 #endif
7871 if (vim_strchr(p_cpo, CPO_CHDIR) != NULL && curbufIsChanged()
7872 && !eap->forceit)
7874 EMSG(_("E747: Cannot change directory, buffer is modified (add ! to override)"));
7875 return;
7878 /* ":cd -": Change to previous directory */
7879 if (STRCMP(new_dir, "-") == 0)
7881 if (prev_dir == NULL)
7883 EMSG(_("E186: No previous directory"));
7884 return;
7886 new_dir = prev_dir;
7889 /* Save current directory for next ":cd -" */
7890 tofree = prev_dir;
7891 if (mch_dirname(NameBuff, MAXPATHL) == OK)
7892 prev_dir = vim_strsave(NameBuff);
7893 else
7894 prev_dir = NULL;
7896 #if defined(UNIX) || defined(VMS)
7897 /* for UNIX ":cd" means: go to home directory */
7898 if (*new_dir == NUL)
7900 /* use NameBuff for home directory name */
7901 # ifdef VMS
7902 char_u *p;
7904 p = mch_getenv((char_u *)"SYS$LOGIN");
7905 if (p == NULL || *p == NUL) /* empty is the same as not set */
7906 NameBuff[0] = NUL;
7907 else
7908 vim_strncpy(NameBuff, p, MAXPATHL - 1);
7909 # else
7910 expand_env((char_u *)"$HOME", NameBuff, MAXPATHL);
7911 # endif
7912 new_dir = NameBuff;
7914 #endif
7915 if (new_dir == NULL || vim_chdir(new_dir))
7916 EMSG(_(e_failed));
7917 else
7919 vim_free(curwin->w_localdir);
7920 if (eap->cmdidx == CMD_lcd || eap->cmdidx == CMD_lchdir)
7922 /* If still in global directory, need to remember current
7923 * directory as global directory. */
7924 if (globaldir == NULL && prev_dir != NULL)
7925 globaldir = vim_strsave(prev_dir);
7926 /* Remember this local directory for the window. */
7927 if (mch_dirname(NameBuff, MAXPATHL) == OK)
7928 curwin->w_localdir = vim_strsave(NameBuff);
7930 else
7932 /* We are now in the global directory, no need to remember its
7933 * name. */
7934 vim_free(globaldir);
7935 globaldir = NULL;
7936 curwin->w_localdir = NULL;
7939 shorten_fnames(TRUE);
7941 /* Echo the new current directory if the command was typed. */
7942 if (KeyTyped)
7943 ex_pwd(eap);
7945 vim_free(tofree);
7950 * ":pwd".
7952 /*ARGSUSED*/
7953 static void
7954 ex_pwd(eap)
7955 exarg_T *eap;
7957 if (mch_dirname(NameBuff, MAXPATHL) == OK)
7959 #ifdef BACKSLASH_IN_FILENAME
7960 slash_adjust(NameBuff);
7961 #endif
7962 msg(NameBuff);
7964 else
7965 EMSG(_("E187: Unknown"));
7969 * ":=".
7971 static void
7972 ex_equal(eap)
7973 exarg_T *eap;
7975 smsg((char_u *)"%ld", (long)eap->line2);
7976 ex_may_print(eap);
7979 static void
7980 ex_sleep(eap)
7981 exarg_T *eap;
7983 int n;
7984 long len;
7986 if (cursor_valid())
7988 n = W_WINROW(curwin) + curwin->w_wrow - msg_scrolled;
7989 if (n >= 0)
7990 windgoto((int)n, curwin->w_wcol);
7993 len = eap->line2;
7994 switch (*eap->arg)
7996 case 'm': break;
7997 case NUL: len *= 1000L; break;
7998 default: EMSG2(_(e_invarg2), eap->arg); return;
8000 do_sleep(len);
8004 * Sleep for "msec" milliseconds, but keep checking for a CTRL-C every second.
8006 void
8007 do_sleep(msec)
8008 long msec;
8010 long done;
8012 cursor_on();
8013 out_flush();
8014 for (done = 0; !got_int && done < msec; done += 1000L)
8016 ui_delay(msec - done > 1000L ? 1000L : msec - done, TRUE);
8017 ui_breakcheck();
8021 static void
8022 do_exmap(eap, isabbrev)
8023 exarg_T *eap;
8024 int isabbrev;
8026 int mode;
8027 char_u *cmdp;
8029 cmdp = eap->cmd;
8030 mode = get_map_mode(&cmdp, eap->forceit || isabbrev);
8032 switch (do_map((*cmdp == 'n') ? 2 : (*cmdp == 'u'),
8033 eap->arg, mode, isabbrev))
8035 case 1: EMSG(_(e_invarg));
8036 break;
8037 case 2: EMSG(isabbrev ? _(e_noabbr) : _(e_nomap));
8038 break;
8043 * ":winsize" command (obsolete).
8045 static void
8046 ex_winsize(eap)
8047 exarg_T *eap;
8049 int w, h;
8050 char_u *arg = eap->arg;
8051 char_u *p;
8053 w = getdigits(&arg);
8054 arg = skipwhite(arg);
8055 p = arg;
8056 h = getdigits(&arg);
8057 if (*p != NUL && *arg == NUL)
8058 set_shellsize(w, h, TRUE);
8059 else
8060 EMSG(_("E465: :winsize requires two number arguments"));
8063 #ifdef FEAT_WINDOWS
8064 static void
8065 ex_wincmd(eap)
8066 exarg_T *eap;
8068 int xchar = NUL;
8069 char_u *p;
8071 if (*eap->arg == 'g' || *eap->arg == Ctrl_G)
8073 /* CTRL-W g and CTRL-W CTRL-G have an extra command character */
8074 if (eap->arg[1] == NUL)
8076 EMSG(_(e_invarg));
8077 return;
8079 xchar = eap->arg[1];
8080 p = eap->arg + 2;
8082 else
8083 p = eap->arg + 1;
8085 eap->nextcmd = check_nextcmd(p);
8086 p = skipwhite(p);
8087 if (*p != NUL && *p != '"' && eap->nextcmd == NULL)
8088 EMSG(_(e_invarg));
8089 else
8091 /* Pass flags on for ":vertical wincmd ]". */
8092 postponed_split_flags = cmdmod.split;
8093 postponed_split_tab = cmdmod.tab;
8094 do_window(*eap->arg, eap->addr_count > 0 ? eap->line2 : 0L, xchar);
8095 postponed_split_flags = 0;
8096 postponed_split_tab = 0;
8099 #endif
8101 #if defined(FEAT_GUI) || defined(UNIX) || defined(VMS) || defined(MSWIN)
8103 * ":winpos".
8105 static void
8106 ex_winpos(eap)
8107 exarg_T *eap;
8109 int x, y;
8110 char_u *arg = eap->arg;
8111 char_u *p;
8113 if (*arg == NUL)
8115 # if defined(FEAT_GUI) || defined(MSWIN)
8116 # ifdef FEAT_GUI
8117 if (gui.in_use && gui_mch_get_winpos(&x, &y) != FAIL)
8118 # else
8119 if (mch_get_winpos(&x, &y) != FAIL)
8120 # endif
8122 sprintf((char *)IObuff, _("Window position: X %d, Y %d"), x, y);
8123 msg(IObuff);
8125 else
8126 # endif
8127 EMSG(_("E188: Obtaining window position not implemented for this platform"));
8129 else
8131 x = getdigits(&arg);
8132 arg = skipwhite(arg);
8133 p = arg;
8134 y = getdigits(&arg);
8135 if (*p == NUL || *arg != NUL)
8137 EMSG(_("E466: :winpos requires two number arguments"));
8138 return;
8140 # ifdef FEAT_GUI
8141 if (gui.in_use)
8142 gui_mch_set_winpos(x, y);
8143 else if (gui.starting)
8145 /* Remember the coordinates for when the window is opened. */
8146 gui_win_x = x;
8147 gui_win_y = y;
8149 # ifdef HAVE_TGETENT
8150 else
8151 # endif
8152 # else
8153 # ifdef MSWIN
8154 mch_set_winpos(x, y);
8155 # endif
8156 # endif
8157 # ifdef HAVE_TGETENT
8158 if (*T_CWP)
8159 term_set_winpos(x, y);
8160 # endif
8163 #endif
8166 * Handle command that work like operators: ":delete", ":yank", ":>" and ":<".
8168 static void
8169 ex_operators(eap)
8170 exarg_T *eap;
8172 oparg_T oa;
8174 clear_oparg(&oa);
8175 oa.regname = eap->regname;
8176 oa.start.lnum = eap->line1;
8177 oa.end.lnum = eap->line2;
8178 oa.line_count = eap->line2 - eap->line1 + 1;
8179 oa.motion_type = MLINE;
8180 #ifdef FEAT_VIRTUALEDIT
8181 virtual_op = FALSE;
8182 #endif
8183 if (eap->cmdidx != CMD_yank) /* position cursor for undo */
8185 setpcmark();
8186 curwin->w_cursor.lnum = eap->line1;
8187 beginline(BL_SOL | BL_FIX);
8190 switch (eap->cmdidx)
8192 case CMD_delete:
8193 oa.op_type = OP_DELETE;
8194 op_delete(&oa);
8195 break;
8197 case CMD_yank:
8198 oa.op_type = OP_YANK;
8199 (void)op_yank(&oa, FALSE, TRUE);
8200 break;
8202 default: /* CMD_rshift or CMD_lshift */
8203 if ((eap->cmdidx == CMD_rshift)
8204 #ifdef FEAT_RIGHTLEFT
8205 ^ curwin->w_p_rl
8206 #endif
8208 oa.op_type = OP_RSHIFT;
8209 else
8210 oa.op_type = OP_LSHIFT;
8211 op_shift(&oa, FALSE, eap->amount);
8212 break;
8214 #ifdef FEAT_VIRTUALEDIT
8215 virtual_op = MAYBE;
8216 #endif
8217 ex_may_print(eap);
8221 * ":put".
8223 static void
8224 ex_put(eap)
8225 exarg_T *eap;
8227 /* ":0put" works like ":1put!". */
8228 if (eap->line2 == 0)
8230 eap->line2 = 1;
8231 eap->forceit = TRUE;
8233 curwin->w_cursor.lnum = eap->line2;
8234 do_put(eap->regname, eap->forceit ? BACKWARD : FORWARD, 1L,
8235 PUT_LINE|PUT_CURSLINE);
8239 * Handle ":copy" and ":move".
8241 static void
8242 ex_copymove(eap)
8243 exarg_T *eap;
8245 long n;
8247 n = get_address(&eap->arg, FALSE, FALSE);
8248 if (eap->arg == NULL) /* error detected */
8250 eap->nextcmd = NULL;
8251 return;
8253 get_flags(eap);
8256 * move or copy lines from 'eap->line1'-'eap->line2' to below line 'n'
8258 if (n == MAXLNUM || n < 0 || n > curbuf->b_ml.ml_line_count)
8260 EMSG(_(e_invaddr));
8261 return;
8264 if (eap->cmdidx == CMD_move)
8266 if (do_move(eap->line1, eap->line2, n) == FAIL)
8267 return;
8269 else
8270 ex_copy(eap->line1, eap->line2, n);
8271 u_clearline();
8272 beginline(BL_SOL | BL_FIX);
8273 ex_may_print(eap);
8277 * Print the current line if flags were given to the Ex command.
8279 static void
8280 ex_may_print(eap)
8281 exarg_T *eap;
8283 if (eap->flags != 0)
8285 print_line(curwin->w_cursor.lnum, (eap->flags & EXFLAG_NR),
8286 (eap->flags & EXFLAG_LIST));
8287 ex_no_reprint = TRUE;
8292 * ":smagic" and ":snomagic".
8294 static void
8295 ex_submagic(eap)
8296 exarg_T *eap;
8298 int magic_save = p_magic;
8300 p_magic = (eap->cmdidx == CMD_smagic);
8301 do_sub(eap);
8302 p_magic = magic_save;
8306 * ":join".
8308 static void
8309 ex_join(eap)
8310 exarg_T *eap;
8312 curwin->w_cursor.lnum = eap->line1;
8313 if (eap->line1 == eap->line2)
8315 if (eap->addr_count >= 2) /* :2,2join does nothing */
8316 return;
8317 if (eap->line2 == curbuf->b_ml.ml_line_count)
8319 beep_flush();
8320 return;
8322 ++eap->line2;
8324 do_do_join(eap->line2 - eap->line1 + 1, !eap->forceit);
8325 beginline(BL_WHITE | BL_FIX);
8326 ex_may_print(eap);
8330 * ":[addr]@r" or ":[addr]*r": execute register
8332 static void
8333 ex_at(eap)
8334 exarg_T *eap;
8336 int c;
8338 curwin->w_cursor.lnum = eap->line2;
8340 #ifdef USE_ON_FLY_SCROLL
8341 dont_scroll = TRUE; /* disallow scrolling here */
8342 #endif
8344 /* get the register name. No name means to use the previous one */
8345 c = *eap->arg;
8346 if (c == NUL || (c == '*' && *eap->cmd == '*'))
8347 c = '@';
8348 /* Put the register in the typeahead buffer with the "silent" flag. */
8349 if (do_execreg(c, TRUE, vim_strchr(p_cpo, CPO_EXECBUF) != NULL, TRUE)
8350 == FAIL)
8352 beep_flush();
8354 else
8356 int save_efr = exec_from_reg;
8358 exec_from_reg = TRUE;
8361 * Execute from the typeahead buffer.
8362 * Originally this didn't check for the typeahead buffer to be empty,
8363 * thus could read more Ex commands from stdin. It's not clear why,
8364 * it is certainly unexpected.
8366 while ((!stuff_empty() || typebuf.tb_len > 0) && vpeekc() == ':')
8367 (void)do_cmdline(NULL, getexline, NULL, DOCMD_NOWAIT|DOCMD_VERBOSE);
8369 exec_from_reg = save_efr;
8374 * ":!".
8376 static void
8377 ex_bang(eap)
8378 exarg_T *eap;
8380 do_bang(eap->addr_count, eap, eap->forceit, TRUE, TRUE);
8384 * ":undo".
8386 /*ARGSUSED*/
8387 static void
8388 ex_undo(eap)
8389 exarg_T *eap;
8391 if (eap->addr_count == 1) /* :undo 123 */
8392 undo_time(eap->line2, FALSE, TRUE);
8393 else
8394 u_undo(1);
8398 * ":redo".
8400 /*ARGSUSED*/
8401 static void
8402 ex_redo(eap)
8403 exarg_T *eap;
8405 u_redo(1);
8409 * ":earlier" and ":later".
8411 /*ARGSUSED*/
8412 static void
8413 ex_later(eap)
8414 exarg_T *eap;
8416 long count = 0;
8417 int sec = FALSE;
8418 char_u *p = eap->arg;
8420 if (*p == NUL)
8421 count = 1;
8422 else if (isdigit(*p))
8424 count = getdigits(&p);
8425 switch (*p)
8427 case 's': ++p; sec = TRUE; break;
8428 case 'm': ++p; sec = TRUE; count *= 60; break;
8429 case 'h': ++p; sec = TRUE; count *= 60 * 60; break;
8433 if (*p != NUL)
8434 EMSG2(_(e_invarg2), eap->arg);
8435 else
8436 undo_time(eap->cmdidx == CMD_earlier ? -count : count, sec, FALSE);
8440 * ":redir": start/stop redirection.
8442 static void
8443 ex_redir(eap)
8444 exarg_T *eap;
8446 char *mode;
8447 char_u *fname;
8448 char_u *arg = eap->arg;
8450 if (STRICMP(eap->arg, "END") == 0)
8451 close_redir();
8452 else
8454 if (*arg == '>')
8456 ++arg;
8457 if (*arg == '>')
8459 ++arg;
8460 mode = "a";
8462 else
8463 mode = "w";
8464 arg = skipwhite(arg);
8466 close_redir();
8468 /* Expand environment variables and "~/". */
8469 fname = expand_env_save(arg);
8470 if (fname == NULL)
8471 return;
8472 #ifdef FEAT_BROWSE
8473 if (cmdmod.browse)
8475 char_u *browseFile;
8477 browseFile = do_browse(BROWSE_SAVE,
8478 (char_u *)_("Save Redirection"),
8479 fname, NULL, NULL, BROWSE_FILTER_ALL_FILES, curbuf);
8480 if (browseFile == NULL)
8481 return; /* operation cancelled */
8482 vim_free(fname);
8483 fname = browseFile;
8484 eap->forceit = TRUE; /* since dialog already asked */
8486 #endif
8488 redir_fd = open_exfile(fname, eap->forceit, mode);
8489 vim_free(fname);
8491 #ifdef FEAT_EVAL
8492 else if (*arg == '@')
8494 /* redirect to a register a-z (resp. A-Z for appending) */
8495 close_redir();
8496 ++arg;
8497 if (ASCII_ISALPHA(*arg)
8498 # ifdef FEAT_CLIPBOARD
8499 || *arg == '*'
8500 || *arg == '+'
8501 # endif
8502 || *arg == '"')
8504 redir_reg = *arg++;
8505 if (*arg == '>' && arg[1] == '>') /* append */
8506 arg += 2;
8507 else
8509 /* Can use both "@a" and "@a>". */
8510 if (*arg == '>')
8511 arg++;
8512 /* Make register empty when not using @A-@Z and the
8513 * command is valid. */
8514 if (*arg == NUL && !isupper(redir_reg))
8515 write_reg_contents(redir_reg, (char_u *)"", -1, FALSE);
8518 if (*arg != NUL)
8520 redir_reg = 0;
8521 EMSG2(_(e_invarg2), eap->arg);
8524 else if (*arg == '=' && arg[1] == '>')
8526 int append;
8528 /* redirect to a variable */
8529 close_redir();
8530 arg += 2;
8532 if (*arg == '>')
8534 ++arg;
8535 append = TRUE;
8537 else
8538 append = FALSE;
8540 if (var_redir_start(skipwhite(arg), append) == OK)
8541 redir_vname = 1;
8543 #endif
8545 /* TODO: redirect to a buffer */
8547 else
8548 EMSG2(_(e_invarg2), eap->arg);
8551 /* Make sure redirection is not off. Can happen for cmdline completion
8552 * that indirectly invokes a command to catch its output. */
8553 if (redir_fd != NULL
8554 #ifdef FEAT_EVAL
8555 || redir_reg || redir_vname
8556 #endif
8558 redir_off = FALSE;
8562 * ":redraw": force redraw
8564 static void
8565 ex_redraw(eap)
8566 exarg_T *eap;
8568 int r = RedrawingDisabled;
8569 int p = p_lz;
8571 RedrawingDisabled = 0;
8572 p_lz = FALSE;
8573 update_topline();
8574 update_screen(eap->forceit ? CLEAR :
8575 #ifdef FEAT_VISUAL
8576 VIsual_active ? INVERTED :
8577 #endif
8579 #ifdef FEAT_TITLE
8580 if (need_maketitle)
8581 maketitle();
8582 #endif
8583 RedrawingDisabled = r;
8584 p_lz = p;
8586 /* Reset msg_didout, so that a message that's there is overwritten. */
8587 msg_didout = FALSE;
8588 msg_col = 0;
8590 out_flush();
8594 * ":redrawstatus": force redraw of status line(s)
8596 /*ARGSUSED*/
8597 static void
8598 ex_redrawstatus(eap)
8599 exarg_T *eap;
8601 #if defined(FEAT_WINDOWS)
8602 int r = RedrawingDisabled;
8603 int p = p_lz;
8605 RedrawingDisabled = 0;
8606 p_lz = FALSE;
8607 if (eap->forceit)
8608 status_redraw_all();
8609 else
8610 status_redraw_curbuf();
8611 update_screen(
8612 # ifdef FEAT_VISUAL
8613 VIsual_active ? INVERTED :
8614 # endif
8616 RedrawingDisabled = r;
8617 p_lz = p;
8618 out_flush();
8619 #endif
8622 static void
8623 close_redir()
8625 if (redir_fd != NULL)
8627 fclose(redir_fd);
8628 redir_fd = NULL;
8630 #ifdef FEAT_EVAL
8631 redir_reg = 0;
8632 if (redir_vname)
8634 var_redir_stop();
8635 redir_vname = 0;
8637 #endif
8640 #if defined(FEAT_SESSION) && defined(USE_CRNL)
8641 # define MKSESSION_NL
8642 static int mksession_nl = FALSE; /* use NL only in put_eol() */
8643 #endif
8646 * ":mkexrc", ":mkvimrc", ":mkview" and ":mksession".
8648 static void
8649 ex_mkrc(eap)
8650 exarg_T *eap;
8652 FILE *fd;
8653 int failed = FALSE;
8654 char_u *fname;
8655 #ifdef FEAT_BROWSE
8656 char_u *browseFile = NULL;
8657 #endif
8658 #ifdef FEAT_SESSION
8659 int view_session = FALSE;
8660 int using_vdir = FALSE; /* using 'viewdir'? */
8661 char_u *viewFile = NULL;
8662 unsigned *flagp;
8663 #endif
8665 if (eap->cmdidx == CMD_mksession || eap->cmdidx == CMD_mkview)
8667 #ifdef FEAT_SESSION
8668 view_session = TRUE;
8669 #else
8670 ex_ni(eap);
8671 return;
8672 #endif
8675 #ifdef FEAT_SESSION
8676 did_lcd = FALSE;
8678 /* ":mkview" or ":mkview 9": generate file name with 'viewdir' */
8679 if (eap->cmdidx == CMD_mkview
8680 && (*eap->arg == NUL
8681 || (vim_isdigit(*eap->arg) && eap->arg[1] == NUL)))
8683 eap->forceit = TRUE;
8684 fname = get_view_file(*eap->arg);
8685 if (fname == NULL)
8686 return;
8687 viewFile = fname;
8688 using_vdir = TRUE;
8690 else
8691 #endif
8692 if (*eap->arg != NUL)
8693 fname = eap->arg;
8694 else if (eap->cmdidx == CMD_mkvimrc)
8695 fname = (char_u *)VIMRC_FILE;
8696 #ifdef FEAT_SESSION
8697 else if (eap->cmdidx == CMD_mksession)
8698 fname = (char_u *)SESSION_FILE;
8699 #endif
8700 else
8701 fname = (char_u *)EXRC_FILE;
8703 #ifdef FEAT_BROWSE
8704 if (cmdmod.browse)
8706 browseFile = do_browse(BROWSE_SAVE,
8707 # ifdef FEAT_SESSION
8708 eap->cmdidx == CMD_mkview ? (char_u *)_("Save View") :
8709 eap->cmdidx == CMD_mksession ? (char_u *)_("Save Session") :
8710 # endif
8711 (char_u *)_("Save Setup"),
8712 fname, (char_u *)"vim", NULL, BROWSE_FILTER_MACROS, NULL);
8713 if (browseFile == NULL)
8714 goto theend;
8715 fname = browseFile;
8716 eap->forceit = TRUE; /* since dialog already asked */
8718 #endif
8720 #if defined(FEAT_SESSION) && defined(vim_mkdir)
8721 /* When using 'viewdir' may have to create the directory. */
8722 if (using_vdir && !mch_isdir(p_vdir))
8723 vim_mkdir_emsg(p_vdir, 0755);
8724 #endif
8726 fd = open_exfile(fname, eap->forceit, WRITEBIN);
8727 if (fd != NULL)
8729 #ifdef FEAT_SESSION
8730 if (eap->cmdidx == CMD_mkview)
8731 flagp = &vop_flags;
8732 else
8733 flagp = &ssop_flags;
8734 #endif
8736 #ifdef MKSESSION_NL
8737 /* "unix" in 'sessionoptions': use NL line separator */
8738 if (view_session && (*flagp & SSOP_UNIX))
8739 mksession_nl = TRUE;
8740 #endif
8742 /* Write the version command for :mkvimrc */
8743 if (eap->cmdidx == CMD_mkvimrc)
8744 (void)put_line(fd, "version 6.0");
8746 #ifdef FEAT_SESSION
8747 if (eap->cmdidx == CMD_mksession)
8749 if (put_line(fd, "let SessionLoad = 1") == FAIL)
8750 failed = TRUE;
8753 if (eap->cmdidx != CMD_mkview)
8754 #endif
8756 /* Write setting 'compatible' first, because it has side effects.
8757 * For that same reason only do it when needed. */
8758 if (p_cp)
8759 (void)put_line(fd, "if !&cp | set cp | endif");
8760 else
8761 (void)put_line(fd, "if &cp | set nocp | endif");
8764 #ifdef FEAT_SESSION
8765 if (!view_session
8766 || (eap->cmdidx == CMD_mksession
8767 && (*flagp & SSOP_OPTIONS)))
8768 #endif
8769 failed |= (makemap(fd, NULL) == FAIL
8770 || makeset(fd, OPT_GLOBAL, FALSE) == FAIL);
8772 #ifdef FEAT_SESSION
8773 if (!failed && view_session)
8775 if (put_line(fd, "let s:so_save = &so | let s:siso_save = &siso | set so=0 siso=0") == FAIL)
8776 failed = TRUE;
8777 if (eap->cmdidx == CMD_mksession)
8779 char_u dirnow[MAXPATHL]; /* current directory */
8782 * Change to session file's dir.
8784 if (mch_dirname(dirnow, MAXPATHL) == FAIL
8785 || mch_chdir((char *)dirnow) != 0)
8786 *dirnow = NUL;
8787 if (*dirnow != NUL && (ssop_flags & SSOP_SESDIR))
8789 if (vim_chdirfile(fname) == OK)
8790 shorten_fnames(TRUE);
8792 else if (*dirnow != NUL
8793 && (ssop_flags & SSOP_CURDIR) && globaldir != NULL)
8795 if (mch_chdir((char *)globaldir) == 0)
8796 shorten_fnames(TRUE);
8799 failed |= (makeopens(fd, dirnow) == FAIL);
8801 /* restore original dir */
8802 if (*dirnow != NUL && ((ssop_flags & SSOP_SESDIR)
8803 || ((ssop_flags & SSOP_CURDIR) && globaldir != NULL)))
8805 if (mch_chdir((char *)dirnow) != 0)
8806 EMSG(_(e_prev_dir));
8807 shorten_fnames(TRUE);
8810 else
8812 failed |= (put_view(fd, curwin, !using_vdir, flagp,
8813 -1) == FAIL);
8815 if (put_line(fd, "let &so = s:so_save | let &siso = s:siso_save")
8816 == FAIL)
8817 failed = TRUE;
8818 if (put_line(fd, "doautoall SessionLoadPost") == FAIL)
8819 failed = TRUE;
8820 if (eap->cmdidx == CMD_mksession)
8822 if (put_line(fd, "unlet SessionLoad") == FAIL)
8823 failed = TRUE;
8826 #endif
8827 if (put_line(fd, "\" vim: set ft=vim :") == FAIL)
8828 failed = TRUE;
8830 failed |= fclose(fd);
8832 if (failed)
8833 EMSG(_(e_write));
8834 #if defined(FEAT_EVAL) && defined(FEAT_SESSION)
8835 else if (eap->cmdidx == CMD_mksession)
8837 /* successful session write - set this_session var */
8838 char_u tbuf[MAXPATHL];
8840 if (vim_FullName(fname, tbuf, MAXPATHL, FALSE) == OK)
8841 set_vim_var_string(VV_THIS_SESSION, tbuf, -1);
8843 #endif
8844 #ifdef MKSESSION_NL
8845 mksession_nl = FALSE;
8846 #endif
8849 #ifdef FEAT_BROWSE
8850 theend:
8851 vim_free(browseFile);
8852 #endif
8853 #ifdef FEAT_SESSION
8854 vim_free(viewFile);
8855 #endif
8858 #if ((defined(FEAT_SESSION) || defined(FEAT_EVAL)) && defined(vim_mkdir)) \
8859 || defined(PROTO)
8860 /*ARGSUSED*/
8862 vim_mkdir_emsg(name, prot)
8863 char_u *name;
8864 int prot;
8866 if (vim_mkdir(name, prot) != 0)
8868 EMSG2(_("E739: Cannot create directory: %s"), name);
8869 return FAIL;
8871 return OK;
8873 #endif
8876 * Open a file for writing for an Ex command, with some checks.
8877 * Return file descriptor, or NULL on failure.
8879 FILE *
8880 open_exfile(fname, forceit, mode)
8881 char_u *fname;
8882 int forceit;
8883 char *mode; /* "w" for create new file or "a" for append */
8885 FILE *fd;
8887 #ifdef UNIX
8888 /* with Unix it is possible to open a directory */
8889 if (mch_isdir(fname))
8891 EMSG2(_(e_isadir2), fname);
8892 return NULL;
8894 #endif
8895 if (!forceit && *mode != 'a' && vim_fexists(fname))
8897 EMSG2(_("E189: \"%s\" exists (add ! to override)"), fname);
8898 return NULL;
8901 if ((fd = mch_fopen((char *)fname, mode)) == NULL)
8902 EMSG2(_("E190: Cannot open \"%s\" for writing"), fname);
8904 return fd;
8908 * ":mark" and ":k".
8910 static void
8911 ex_mark(eap)
8912 exarg_T *eap;
8914 pos_T pos;
8916 if (*eap->arg == NUL) /* No argument? */
8917 EMSG(_(e_argreq));
8918 else if (eap->arg[1] != NUL) /* more than one character? */
8919 EMSG(_(e_trailing));
8920 else
8922 pos = curwin->w_cursor; /* save curwin->w_cursor */
8923 curwin->w_cursor.lnum = eap->line2;
8924 beginline(BL_WHITE | BL_FIX);
8925 if (setmark(*eap->arg) == FAIL) /* set mark */
8926 EMSG(_("E191: Argument must be a letter or forward/backward quote"));
8927 curwin->w_cursor = pos; /* restore curwin->w_cursor */
8932 * Update w_topline, w_leftcol and the cursor position.
8934 void
8935 update_topline_cursor()
8937 check_cursor(); /* put cursor on valid line */
8938 update_topline();
8939 if (!curwin->w_p_wrap)
8940 validate_cursor();
8941 update_curswant();
8944 #ifdef FEAT_EX_EXTRA
8946 * ":normal[!] {commands}": Execute normal mode commands.
8948 static void
8949 ex_normal(eap)
8950 exarg_T *eap;
8952 int save_msg_scroll = msg_scroll;
8953 int save_restart_edit = restart_edit;
8954 int save_msg_didout = msg_didout;
8955 int save_State = State;
8956 tasave_T tabuf;
8957 int save_insertmode = p_im;
8958 int save_finish_op = finish_op;
8959 int save_opcount = opcount;
8960 #ifdef FEAT_MBYTE
8961 char_u *arg = NULL;
8962 int l;
8963 char_u *p;
8964 #endif
8966 if (ex_normal_lock > 0)
8968 EMSG(_(e_secure));
8969 return;
8971 if (ex_normal_busy >= p_mmd)
8973 EMSG(_("E192: Recursive use of :normal too deep"));
8974 return;
8976 ++ex_normal_busy;
8978 msg_scroll = FALSE; /* no msg scrolling in Normal mode */
8979 restart_edit = 0; /* don't go to Insert mode */
8980 p_im = FALSE; /* don't use 'insertmode' */
8982 #ifdef FEAT_MBYTE
8984 * vgetc() expects a CSI and K_SPECIAL to have been escaped. Don't do
8985 * this for the K_SPECIAL leading byte, otherwise special keys will not
8986 * work.
8988 if (has_mbyte)
8990 int len = 0;
8992 /* Count the number of characters to be escaped. */
8993 for (p = eap->arg; *p != NUL; ++p)
8995 # ifdef FEAT_GUI
8996 if (*p == CSI) /* leadbyte CSI */
8997 len += 2;
8998 # endif
8999 for (l = (*mb_ptr2len)(p) - 1; l > 0; --l)
9000 if (*++p == K_SPECIAL /* trailbyte K_SPECIAL or CSI */
9001 # ifdef FEAT_GUI
9002 || *p == CSI
9003 # endif
9005 len += 2;
9007 if (len > 0)
9009 arg = alloc((unsigned)(STRLEN(eap->arg) + len + 1));
9010 if (arg != NULL)
9012 len = 0;
9013 for (p = eap->arg; *p != NUL; ++p)
9015 arg[len++] = *p;
9016 # ifdef FEAT_GUI
9017 if (*p == CSI)
9019 arg[len++] = KS_EXTRA;
9020 arg[len++] = (int)KE_CSI;
9022 # endif
9023 for (l = (*mb_ptr2len)(p) - 1; l > 0; --l)
9025 arg[len++] = *++p;
9026 if (*p == K_SPECIAL)
9028 arg[len++] = KS_SPECIAL;
9029 arg[len++] = KE_FILLER;
9031 # ifdef FEAT_GUI
9032 else if (*p == CSI)
9034 arg[len++] = KS_EXTRA;
9035 arg[len++] = (int)KE_CSI;
9037 # endif
9039 arg[len] = NUL;
9044 #endif
9047 * Save the current typeahead. This is required to allow using ":normal"
9048 * from an event handler and makes sure we don't hang when the argument
9049 * ends with half a command.
9051 save_typeahead(&tabuf);
9052 if (tabuf.typebuf_valid)
9055 * Repeat the :normal command for each line in the range. When no
9056 * range given, execute it just once, without positioning the cursor
9057 * first.
9061 if (eap->addr_count != 0)
9063 curwin->w_cursor.lnum = eap->line1++;
9064 curwin->w_cursor.col = 0;
9067 exec_normal_cmd(
9068 #ifdef FEAT_MBYTE
9069 arg != NULL ? arg :
9070 #endif
9071 eap->arg, eap->forceit ? REMAP_NONE : REMAP_YES, FALSE);
9073 while (eap->addr_count > 0 && eap->line1 <= eap->line2 && !got_int);
9076 /* Might not return to the main loop when in an event handler. */
9077 update_topline_cursor();
9079 /* Restore the previous typeahead. */
9080 restore_typeahead(&tabuf);
9082 --ex_normal_busy;
9083 msg_scroll = save_msg_scroll;
9084 restart_edit = save_restart_edit;
9085 p_im = save_insertmode;
9086 finish_op = save_finish_op;
9087 opcount = save_opcount;
9088 msg_didout |= save_msg_didout; /* don't reset msg_didout now */
9090 /* Restore the state (needed when called from a function executed for
9091 * 'indentexpr'). */
9092 State = save_State;
9093 #ifdef FEAT_MBYTE
9094 vim_free(arg);
9095 #endif
9099 * ":startinsert", ":startreplace" and ":startgreplace"
9101 static void
9102 ex_startinsert(eap)
9103 exarg_T *eap;
9105 if (eap->forceit)
9107 coladvance((colnr_T)MAXCOL);
9108 curwin->w_curswant = MAXCOL;
9109 curwin->w_set_curswant = FALSE;
9112 /* Ignore the command when already in Insert mode. Inserting an
9113 * expression register that invokes a function can do this. */
9114 if (State & INSERT)
9115 return;
9117 if (eap->cmdidx == CMD_startinsert)
9118 restart_edit = 'a';
9119 else if (eap->cmdidx == CMD_startreplace)
9120 restart_edit = 'R';
9121 else
9122 restart_edit = 'V';
9124 if (!eap->forceit)
9126 if (eap->cmdidx == CMD_startinsert)
9127 restart_edit = 'i';
9128 curwin->w_curswant = 0; /* avoid MAXCOL */
9133 * ":stopinsert"
9135 /*ARGSUSED*/
9136 static void
9137 ex_stopinsert(eap)
9138 exarg_T *eap;
9140 restart_edit = 0;
9141 stop_insert_mode = TRUE;
9143 #endif
9145 #if defined(FEAT_EX_EXTRA) || defined(FEAT_MENU) || defined(PROTO)
9147 * Execute normal mode command "cmd".
9148 * "remap" can be REMAP_NONE or REMAP_YES.
9150 void
9151 exec_normal_cmd(cmd, remap, silent)
9152 char_u *cmd;
9153 int remap;
9154 int silent;
9156 oparg_T oa;
9159 * Stuff the argument into the typeahead buffer.
9160 * Execute normal_cmd() until there is no typeahead left.
9162 clear_oparg(&oa);
9163 finish_op = FALSE;
9164 ins_typebuf(cmd, remap, 0, TRUE, silent);
9165 while ((!stuff_empty() || (!typebuf_typed() && typebuf.tb_len > 0))
9166 && !got_int)
9168 update_topline_cursor();
9169 normal_cmd(&oa, FALSE); /* execute a Normal mode cmd */
9172 #endif
9174 #ifdef FEAT_FIND_ID
9175 static void
9176 ex_checkpath(eap)
9177 exarg_T *eap;
9179 find_pattern_in_path(NULL, 0, 0, FALSE, FALSE, CHECK_PATH, 1L,
9180 eap->forceit ? ACTION_SHOW_ALL : ACTION_SHOW,
9181 (linenr_T)1, (linenr_T)MAXLNUM);
9184 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
9186 * ":psearch"
9188 static void
9189 ex_psearch(eap)
9190 exarg_T *eap;
9192 g_do_tagpreview = p_pvh;
9193 ex_findpat(eap);
9194 g_do_tagpreview = 0;
9196 #endif
9198 static void
9199 ex_findpat(eap)
9200 exarg_T *eap;
9202 int whole = TRUE;
9203 long n;
9204 char_u *p;
9205 int action;
9207 switch (cmdnames[eap->cmdidx].cmd_name[2])
9209 case 'e': /* ":psearch", ":isearch" and ":dsearch" */
9210 if (cmdnames[eap->cmdidx].cmd_name[0] == 'p')
9211 action = ACTION_GOTO;
9212 else
9213 action = ACTION_SHOW;
9214 break;
9215 case 'i': /* ":ilist" and ":dlist" */
9216 action = ACTION_SHOW_ALL;
9217 break;
9218 case 'u': /* ":ijump" and ":djump" */
9219 action = ACTION_GOTO;
9220 break;
9221 default: /* ":isplit" and ":dsplit" */
9222 action = ACTION_SPLIT;
9223 break;
9226 n = 1;
9227 if (vim_isdigit(*eap->arg)) /* get count */
9229 n = getdigits(&eap->arg);
9230 eap->arg = skipwhite(eap->arg);
9232 if (*eap->arg == '/') /* Match regexp, not just whole words */
9234 whole = FALSE;
9235 ++eap->arg;
9236 p = skip_regexp(eap->arg, '/', p_magic, NULL);
9237 if (*p)
9239 *p++ = NUL;
9240 p = skipwhite(p);
9242 /* Check for trailing illegal characters */
9243 if (!ends_excmd(*p))
9244 eap->errmsg = e_trailing;
9245 else
9246 eap->nextcmd = check_nextcmd(p);
9249 if (!eap->skip)
9250 find_pattern_in_path(eap->arg, 0, (int)STRLEN(eap->arg),
9251 whole, !eap->forceit,
9252 *eap->cmd == 'd' ? FIND_DEFINE : FIND_ANY,
9253 n, action, eap->line1, eap->line2);
9255 #endif
9257 #ifdef FEAT_WINDOWS
9259 # ifdef FEAT_QUICKFIX
9261 * ":ptag", ":ptselect", ":ptjump", ":ptnext", etc.
9263 static void
9264 ex_ptag(eap)
9265 exarg_T *eap;
9267 g_do_tagpreview = p_pvh;
9268 ex_tag_cmd(eap, cmdnames[eap->cmdidx].cmd_name + 1);
9272 * ":pedit"
9274 static void
9275 ex_pedit(eap)
9276 exarg_T *eap;
9278 win_T *curwin_save = curwin;
9280 g_do_tagpreview = p_pvh;
9281 prepare_tagpreview(TRUE);
9282 keep_help_flag = curwin_save->w_buffer->b_help;
9283 do_exedit(eap, NULL);
9284 keep_help_flag = FALSE;
9285 if (curwin != curwin_save && win_valid(curwin_save))
9287 /* Return cursor to where we were */
9288 validate_cursor();
9289 redraw_later(VALID);
9290 win_enter(curwin_save, TRUE);
9292 g_do_tagpreview = 0;
9294 # endif
9297 * ":stag", ":stselect" and ":stjump".
9299 static void
9300 ex_stag(eap)
9301 exarg_T *eap;
9303 postponed_split = -1;
9304 postponed_split_flags = cmdmod.split;
9305 postponed_split_tab = cmdmod.tab;
9306 ex_tag_cmd(eap, cmdnames[eap->cmdidx].cmd_name + 1);
9307 postponed_split_flags = 0;
9308 postponed_split_tab = 0;
9310 #endif
9313 * ":tag", ":tselect", ":tjump", ":tnext", etc.
9315 static void
9316 ex_tag(eap)
9317 exarg_T *eap;
9319 ex_tag_cmd(eap, cmdnames[eap->cmdidx].cmd_name);
9322 static void
9323 ex_tag_cmd(eap, name)
9324 exarg_T *eap;
9325 char_u *name;
9327 int cmd;
9329 switch (name[1])
9331 case 'j': cmd = DT_JUMP; /* ":tjump" */
9332 break;
9333 case 's': cmd = DT_SELECT; /* ":tselect" */
9334 break;
9335 case 'p': cmd = DT_PREV; /* ":tprevious" */
9336 break;
9337 case 'N': cmd = DT_PREV; /* ":tNext" */
9338 break;
9339 case 'n': cmd = DT_NEXT; /* ":tnext" */
9340 break;
9341 case 'o': cmd = DT_POP; /* ":pop" */
9342 break;
9343 case 'f': /* ":tfirst" */
9344 case 'r': cmd = DT_FIRST; /* ":trewind" */
9345 break;
9346 case 'l': cmd = DT_LAST; /* ":tlast" */
9347 break;
9348 default: /* ":tag" */
9349 #ifdef FEAT_CSCOPE
9350 if (p_cst && *eap->arg != NUL)
9352 do_cstag(eap);
9353 return;
9355 #endif
9356 cmd = DT_TAG;
9357 break;
9360 if (name[0] == 'l')
9362 #ifndef FEAT_QUICKFIX
9363 ex_ni(eap);
9364 return;
9365 #else
9366 cmd = DT_LTAG;
9367 #endif
9370 do_tag(eap->arg, cmd, eap->addr_count > 0 ? (int)eap->line2 : 1,
9371 eap->forceit, TRUE);
9375 * Check "str" for starting with a special cmdline variable.
9376 * If found return one of the SPEC_ values and set "*usedlen" to the length of
9377 * the variable. Otherwise return -1 and "*usedlen" is unchanged.
9380 find_cmdline_var(src, usedlen)
9381 char_u *src;
9382 int *usedlen;
9384 int len;
9385 int i;
9386 static char *(spec_str[]) = {
9387 "%",
9388 #define SPEC_PERC 0
9389 "#",
9390 #define SPEC_HASH 1
9391 "<cword>", /* cursor word */
9392 #define SPEC_CWORD 2
9393 "<cWORD>", /* cursor WORD */
9394 #define SPEC_CCWORD 3
9395 "<cfile>", /* cursor path name */
9396 #define SPEC_CFILE 4
9397 "<sfile>", /* ":so" file name */
9398 #define SPEC_SFILE 5
9399 #ifdef FEAT_AUTOCMD
9400 "<afile>", /* autocommand file name */
9401 # define SPEC_AFILE 6
9402 "<abuf>", /* autocommand buffer number */
9403 # define SPEC_ABUF 7
9404 "<amatch>", /* autocommand match name */
9405 # define SPEC_AMATCH 8
9406 #endif
9407 #ifdef FEAT_CLIENTSERVER
9408 "<client>"
9409 # define SPEC_CLIENT 9
9410 #endif
9412 #define SPEC_COUNT (sizeof(spec_str) / sizeof(char *))
9414 for (i = 0; i < SPEC_COUNT; ++i)
9416 len = (int)STRLEN(spec_str[i]);
9417 if (STRNCMP(src, spec_str[i], len) == 0)
9419 *usedlen = len;
9420 return i;
9423 return -1;
9427 * Evaluate cmdline variables.
9429 * change '%' to curbuf->b_ffname
9430 * '#' to curwin->w_altfile
9431 * '<cword>' to word under the cursor
9432 * '<cWORD>' to WORD under the cursor
9433 * '<cfile>' to path name under the cursor
9434 * '<sfile>' to sourced file name
9435 * '<afile>' to file name for autocommand
9436 * '<abuf>' to buffer number for autocommand
9437 * '<amatch>' to matching name for autocommand
9439 * When an error is detected, "errormsg" is set to a non-NULL pointer (may be
9440 * "" for error without a message) and NULL is returned.
9441 * Returns an allocated string if a valid match was found.
9442 * Returns NULL if no match was found. "usedlen" then still contains the
9443 * number of characters to skip.
9445 char_u *
9446 eval_vars(src, srcstart, usedlen, lnump, errormsg, escaped)
9447 char_u *src; /* pointer into commandline */
9448 char_u *srcstart; /* beginning of valid memory for src */
9449 int *usedlen; /* characters after src that are used */
9450 linenr_T *lnump; /* line number for :e command, or NULL */
9451 char_u **errormsg; /* pointer to error message */
9452 int *escaped; /* return value has escaped white space (can
9453 * be NULL) */
9455 int i;
9456 char_u *s;
9457 char_u *result;
9458 char_u *resultbuf = NULL;
9459 int resultlen;
9460 buf_T *buf;
9461 int valid = VALID_HEAD + VALID_PATH; /* assume valid result */
9462 int spec_idx;
9463 #ifdef FEAT_MODIFY_FNAME
9464 int skip_mod = FALSE;
9465 #endif
9467 #if defined(FEAT_AUTOCMD) || defined(FEAT_CLIENTSERVER)
9468 char_u strbuf[30];
9469 #endif
9471 *errormsg = NULL;
9472 if (escaped != NULL)
9473 *escaped = FALSE;
9476 * Check if there is something to do.
9478 spec_idx = find_cmdline_var(src, usedlen);
9479 if (spec_idx < 0) /* no match */
9481 *usedlen = 1;
9482 return NULL;
9486 * Skip when preceded with a backslash "\%" and "\#".
9487 * Note: In "\\%" the % is also not recognized!
9489 if (src > srcstart && src[-1] == '\\')
9491 *usedlen = 0;
9492 STRMOVE(src - 1, src); /* remove backslash */
9493 return NULL;
9497 * word or WORD under cursor
9499 if (spec_idx == SPEC_CWORD || spec_idx == SPEC_CCWORD)
9501 resultlen = find_ident_under_cursor(&result, spec_idx == SPEC_CWORD ?
9502 (FIND_IDENT|FIND_STRING) : FIND_STRING);
9503 if (resultlen == 0)
9505 *errormsg = (char_u *)"";
9506 return NULL;
9511 * '#': Alternate file name
9512 * '%': Current file name
9513 * File name under the cursor
9514 * File name for autocommand
9515 * and following modifiers
9517 else
9519 switch (spec_idx)
9521 case SPEC_PERC: /* '%': current file */
9522 if (curbuf->b_fname == NULL)
9524 result = (char_u *)"";
9525 valid = 0; /* Must have ":p:h" to be valid */
9527 else
9528 #ifdef RISCOS
9529 /* Always use the full path for RISC OS if possible. */
9530 result = curbuf->b_ffname;
9531 if (result == NULL)
9532 result = curbuf->b_fname;
9533 #else
9534 result = curbuf->b_fname;
9535 #endif
9536 break;
9538 case SPEC_HASH: /* '#' or "#99": alternate file */
9539 if (src[1] == '#') /* "##": the argument list */
9541 result = arg_all();
9542 resultbuf = result;
9543 *usedlen = 2;
9544 if (escaped != NULL)
9545 *escaped = TRUE;
9546 #ifdef FEAT_MODIFY_FNAME
9547 skip_mod = TRUE;
9548 #endif
9549 break;
9551 s = src + 1;
9552 if (*s == '<') /* "#<99" uses v:oldfiles */
9553 ++s;
9554 i = (int)getdigits(&s);
9555 *usedlen = (int)(s - src); /* length of what we expand */
9557 if (src[1] == '<')
9559 if (*usedlen < 2)
9561 /* Should we give an error message for #<text? */
9562 *usedlen = 1;
9563 return NULL;
9565 #ifdef FEAT_EVAL
9566 result = list_find_str(get_vim_var_list(VV_OLDFILES),
9567 (long)i);
9568 if (result == NULL)
9570 *errormsg = (char_u *)"";
9571 return NULL;
9573 #else
9574 *errormsg = (char_u *)_("E809: #< is not available without the +eval feature");
9575 return NULL;
9576 #endif
9578 else
9580 buf = buflist_findnr(i);
9581 if (buf == NULL)
9583 *errormsg = (char_u *)_("E194: No alternate file name to substitute for '#'");
9584 return NULL;
9586 if (lnump != NULL)
9587 *lnump = ECMD_LAST;
9588 if (buf->b_fname == NULL)
9590 result = (char_u *)"";
9591 valid = 0; /* Must have ":p:h" to be valid */
9593 else
9594 result = buf->b_fname;
9596 break;
9598 #ifdef FEAT_SEARCHPATH
9599 case SPEC_CFILE: /* file name under cursor */
9600 result = file_name_at_cursor(FNAME_MESS|FNAME_HYP, 1L, NULL);
9601 if (result == NULL)
9603 *errormsg = (char_u *)"";
9604 return NULL;
9606 resultbuf = result; /* remember allocated string */
9607 break;
9608 #endif
9610 #ifdef FEAT_AUTOCMD
9611 case SPEC_AFILE: /* file name for autocommand */
9612 result = autocmd_fname;
9613 if (result != NULL && !autocmd_fname_full)
9615 /* Still need to turn the fname into a full path. It is
9616 * postponed to avoid a delay when <afile> is not used. */
9617 autocmd_fname_full = TRUE;
9618 result = FullName_save(autocmd_fname, FALSE);
9619 vim_free(autocmd_fname);
9620 autocmd_fname = result;
9622 if (result == NULL)
9624 *errormsg = (char_u *)_("E495: no autocommand file name to substitute for \"<afile>\"");
9625 return NULL;
9627 result = shorten_fname1(result);
9628 break;
9630 case SPEC_ABUF: /* buffer number for autocommand */
9631 if (autocmd_bufnr <= 0)
9633 *errormsg = (char_u *)_("E496: no autocommand buffer number to substitute for \"<abuf>\"");
9634 return NULL;
9636 sprintf((char *)strbuf, "%d", autocmd_bufnr);
9637 result = strbuf;
9638 break;
9640 case SPEC_AMATCH: /* match name for autocommand */
9641 result = autocmd_match;
9642 if (result == NULL)
9644 *errormsg = (char_u *)_("E497: no autocommand match name to substitute for \"<amatch>\"");
9645 return NULL;
9647 break;
9649 #endif
9650 case SPEC_SFILE: /* file name for ":so" command */
9651 result = sourcing_name;
9652 if (result == NULL)
9654 *errormsg = (char_u *)_("E498: no :source file name to substitute for \"<sfile>\"");
9655 return NULL;
9657 break;
9658 #if defined(FEAT_CLIENTSERVER)
9659 case SPEC_CLIENT: /* Source of last submitted input */
9660 sprintf((char *)strbuf, PRINTF_HEX_LONG_U,
9661 (long_u)clientWindow);
9662 result = strbuf;
9663 break;
9664 #endif
9667 resultlen = (int)STRLEN(result); /* length of new string */
9668 if (src[*usedlen] == '<') /* remove the file name extension */
9670 ++*usedlen;
9671 #ifdef RISCOS
9672 if ((s = vim_strrchr(result, '/')) != NULL && s >= gettail(result))
9673 #else
9674 if ((s = vim_strrchr(result, '.')) != NULL && s >= gettail(result))
9675 #endif
9676 resultlen = (int)(s - result);
9678 #ifdef FEAT_MODIFY_FNAME
9679 else if (!skip_mod)
9681 valid |= modify_fname(src, usedlen, &result, &resultbuf,
9682 &resultlen);
9683 if (result == NULL)
9685 *errormsg = (char_u *)"";
9686 return NULL;
9689 #endif
9692 if (resultlen == 0 || valid != VALID_HEAD + VALID_PATH)
9694 if (valid != VALID_HEAD + VALID_PATH)
9695 /* xgettext:no-c-format */
9696 *errormsg = (char_u *)_("E499: Empty file name for '%' or '#', only works with \":p:h\"");
9697 else
9698 *errormsg = (char_u *)_("E500: Evaluates to an empty string");
9699 result = NULL;
9701 else
9702 result = vim_strnsave(result, resultlen);
9703 vim_free(resultbuf);
9704 return result;
9708 * Concatenate all files in the argument list, separated by spaces, and return
9709 * it in one allocated string.
9710 * Spaces and backslashes in the file names are escaped with a backslash.
9711 * Returns NULL when out of memory.
9713 static char_u *
9714 arg_all()
9716 int len;
9717 int idx;
9718 char_u *retval = NULL;
9719 char_u *p;
9722 * Do this loop two times:
9723 * first time: compute the total length
9724 * second time: concatenate the names
9726 for (;;)
9728 len = 0;
9729 for (idx = 0; idx < ARGCOUNT; ++idx)
9731 p = alist_name(&ARGLIST[idx]);
9732 if (p != NULL)
9734 if (len > 0)
9736 /* insert a space in between names */
9737 if (retval != NULL)
9738 retval[len] = ' ';
9739 ++len;
9741 for ( ; *p != NUL; ++p)
9743 if (*p == ' ' || *p == '\\')
9745 /* insert a backslash */
9746 if (retval != NULL)
9747 retval[len] = '\\';
9748 ++len;
9750 if (retval != NULL)
9751 retval[len] = *p;
9752 ++len;
9757 /* second time: break here */
9758 if (retval != NULL)
9760 retval[len] = NUL;
9761 break;
9764 /* allocate memory */
9765 retval = alloc(len + 1);
9766 if (retval == NULL)
9767 break;
9770 return retval;
9773 #if defined(FEAT_AUTOCMD) || defined(PROTO)
9775 * Expand the <sfile> string in "arg".
9777 * Returns an allocated string, or NULL for any error.
9779 char_u *
9780 expand_sfile(arg)
9781 char_u *arg;
9783 char_u *errormsg;
9784 int len;
9785 char_u *result;
9786 char_u *newres;
9787 char_u *repl;
9788 int srclen;
9789 char_u *p;
9791 result = vim_strsave(arg);
9792 if (result == NULL)
9793 return NULL;
9795 for (p = result; *p; )
9797 if (STRNCMP(p, "<sfile>", 7) != 0)
9798 ++p;
9799 else
9801 /* replace "<sfile>" with the sourced file name, and do ":" stuff */
9802 repl = eval_vars(p, result, &srclen, NULL, &errormsg, NULL);
9803 if (errormsg != NULL)
9805 if (*errormsg)
9806 emsg(errormsg);
9807 vim_free(result);
9808 return NULL;
9810 if (repl == NULL) /* no match (cannot happen) */
9812 p += srclen;
9813 continue;
9815 len = (int)STRLEN(result) - srclen + (int)STRLEN(repl) + 1;
9816 newres = alloc(len);
9817 if (newres == NULL)
9819 vim_free(repl);
9820 vim_free(result);
9821 return NULL;
9823 mch_memmove(newres, result, (size_t)(p - result));
9824 STRCPY(newres + (p - result), repl);
9825 len = (int)STRLEN(newres);
9826 STRCAT(newres, p + srclen);
9827 vim_free(repl);
9828 vim_free(result);
9829 result = newres;
9830 p = newres + len; /* continue after the match */
9834 return result;
9836 #endif
9838 #ifdef FEAT_SESSION
9839 static int ses_winsizes __ARGS((FILE *fd, int restore_size,
9840 win_T *tab_firstwin));
9841 static int ses_win_rec __ARGS((FILE *fd, frame_T *fr));
9842 static frame_T *ses_skipframe __ARGS((frame_T *fr));
9843 static int ses_do_frame __ARGS((frame_T *fr));
9844 static int ses_do_win __ARGS((win_T *wp));
9845 static int ses_arglist __ARGS((FILE *fd, char *cmd, garray_T *gap, int fullname, unsigned *flagp));
9846 static int ses_put_fname __ARGS((FILE *fd, char_u *name, unsigned *flagp));
9847 static int ses_fname __ARGS((FILE *fd, buf_T *buf, unsigned *flagp));
9850 * Write openfile commands for the current buffers to an .exrc file.
9851 * Return FAIL on error, OK otherwise.
9853 static int
9854 makeopens(fd, dirnow)
9855 FILE *fd;
9856 char_u *dirnow; /* Current directory name */
9858 buf_T *buf;
9859 int only_save_windows = TRUE;
9860 int nr;
9861 int cnr = 1;
9862 int restore_size = TRUE;
9863 win_T *wp;
9864 char_u *sname;
9865 win_T *edited_win = NULL;
9866 int tabnr;
9867 win_T *tab_firstwin;
9868 frame_T *tab_topframe;
9869 int cur_arg_idx = 0;
9870 int next_arg_idx = 0;
9872 if (ssop_flags & SSOP_BUFFERS)
9873 only_save_windows = FALSE; /* Save ALL buffers */
9876 * Begin by setting the this_session variable, and then other
9877 * sessionable variables.
9879 #ifdef FEAT_EVAL
9880 if (put_line(fd, "let v:this_session=expand(\"<sfile>:p\")") == FAIL)
9881 return FAIL;
9882 if (ssop_flags & SSOP_GLOBALS)
9883 if (store_session_globals(fd) == FAIL)
9884 return FAIL;
9885 #endif
9888 * Close all windows but one.
9890 if (put_line(fd, "silent only") == FAIL)
9891 return FAIL;
9894 * Now a :cd command to the session directory or the current directory
9896 if (ssop_flags & SSOP_SESDIR)
9898 if (put_line(fd, "exe \"cd \" . escape(expand(\"<sfile>:p:h\"), ' ')")
9899 == FAIL)
9900 return FAIL;
9902 else if (ssop_flags & SSOP_CURDIR)
9904 sname = home_replace_save(NULL, globaldir != NULL ? globaldir : dirnow);
9905 if (sname == NULL
9906 || fputs("cd ", fd) < 0
9907 || ses_put_fname(fd, sname, &ssop_flags) == FAIL
9908 || put_eol(fd) == FAIL)
9910 vim_free(sname);
9911 return FAIL;
9913 vim_free(sname);
9917 * If there is an empty, unnamed buffer we will wipe it out later.
9918 * Remember the buffer number.
9920 if (put_line(fd, "if expand('%') == '' && !&modified && line('$') <= 1 && getline(1) == ''") == FAIL)
9921 return FAIL;
9922 if (put_line(fd, " let s:wipebuf = bufnr('%')") == FAIL)
9923 return FAIL;
9924 if (put_line(fd, "endif") == FAIL)
9925 return FAIL;
9928 * Now save the current files, current buffer first.
9930 if (put_line(fd, "set shortmess=aoO") == FAIL)
9931 return FAIL;
9933 /* Now put the other buffers into the buffer list */
9934 for (buf = firstbuf; buf != NULL; buf = buf->b_next)
9936 if (!(only_save_windows && buf->b_nwindows == 0)
9937 && !(buf->b_help && !(ssop_flags & SSOP_HELP))
9938 && buf->b_fname != NULL
9939 && buf->b_p_bl)
9941 if (fprintf(fd, "badd +%ld ", buf->b_wininfo == NULL ? 1L
9942 : buf->b_wininfo->wi_fpos.lnum) < 0
9943 || ses_fname(fd, buf, &ssop_flags) == FAIL)
9944 return FAIL;
9948 /* the global argument list */
9949 if (ses_arglist(fd, "args", &global_alist.al_ga,
9950 !(ssop_flags & SSOP_CURDIR), &ssop_flags) == FAIL)
9951 return FAIL;
9953 if (ssop_flags & SSOP_RESIZE)
9955 /* Note: after the restore we still check it worked!*/
9956 if (fprintf(fd, "set lines=%ld columns=%ld" , Rows, Columns) < 0
9957 || put_eol(fd) == FAIL)
9958 return FAIL;
9961 #ifdef FEAT_GUI
9962 if (gui.in_use && (ssop_flags & SSOP_WINPOS))
9964 int x, y;
9966 if (gui_mch_get_winpos(&x, &y) == OK)
9968 /* Note: after the restore we still check it worked!*/
9969 if (fprintf(fd, "winpos %d %d", x, y) < 0 || put_eol(fd) == FAIL)
9970 return FAIL;
9973 #endif
9976 * May repeat putting Windows for each tab, when "tabpages" is in
9977 * 'sessionoptions'.
9978 * Don't use goto_tabpage(), it may change directory and trigger
9979 * autocommands.
9981 tab_firstwin = firstwin; /* first window in tab page "tabnr" */
9982 tab_topframe = topframe;
9983 for (tabnr = 1; ; ++tabnr)
9985 int need_tabnew = FALSE;
9987 if ((ssop_flags & SSOP_TABPAGES))
9989 tabpage_T *tp = find_tabpage(tabnr);
9991 if (tp == NULL)
9992 break; /* done all tab pages */
9993 if (tp == curtab)
9995 tab_firstwin = firstwin;
9996 tab_topframe = topframe;
9998 else
10000 tab_firstwin = tp->tp_firstwin;
10001 tab_topframe = tp->tp_topframe;
10003 if (tabnr > 1)
10004 need_tabnew = TRUE;
10008 * Before creating the window layout, try loading one file. If this
10009 * is aborted we don't end up with a number of useless windows.
10010 * This may have side effects! (e.g., compressed or network file).
10012 for (wp = tab_firstwin; wp != NULL; wp = wp->w_next)
10014 if (ses_do_win(wp)
10015 && wp->w_buffer->b_ffname != NULL
10016 && !wp->w_buffer->b_help
10017 #ifdef FEAT_QUICKFIX
10018 && !bt_nofile(wp->w_buffer)
10019 #endif
10022 if (fputs(need_tabnew ? "tabedit " : "edit ", fd) < 0
10023 || ses_fname(fd, wp->w_buffer, &ssop_flags) == FAIL)
10024 return FAIL;
10025 need_tabnew = FALSE;
10026 if (!wp->w_arg_idx_invalid)
10027 edited_win = wp;
10028 break;
10032 /* If no file got edited create an empty tab page. */
10033 if (need_tabnew && put_line(fd, "tabnew") == FAIL)
10034 return FAIL;
10037 * Save current window layout.
10039 if (put_line(fd, "set splitbelow splitright") == FAIL)
10040 return FAIL;
10041 if (ses_win_rec(fd, tab_topframe) == FAIL)
10042 return FAIL;
10043 if (!p_sb && put_line(fd, "set nosplitbelow") == FAIL)
10044 return FAIL;
10045 if (!p_spr && put_line(fd, "set nosplitright") == FAIL)
10046 return FAIL;
10049 * Check if window sizes can be restored (no windows omitted).
10050 * Remember the window number of the current window after restoring.
10052 nr = 0;
10053 for (wp = tab_firstwin; wp != NULL; wp = W_NEXT(wp))
10055 if (ses_do_win(wp))
10056 ++nr;
10057 else
10058 restore_size = FALSE;
10059 if (curwin == wp)
10060 cnr = nr;
10063 /* Go to the first window. */
10064 if (put_line(fd, "wincmd t") == FAIL)
10065 return FAIL;
10068 * If more than one window, see if sizes can be restored.
10069 * First set 'winheight' and 'winwidth' to 1 to avoid the windows being
10070 * resized when moving between windows.
10071 * Do this before restoring the view, so that the topline and the
10072 * cursor can be set. This is done again below.
10074 if (put_line(fd, "set winheight=1 winwidth=1") == FAIL)
10075 return FAIL;
10076 if (nr > 1 && ses_winsizes(fd, restore_size, tab_firstwin) == FAIL)
10077 return FAIL;
10080 * Restore the view of the window (options, file, cursor, etc.).
10082 for (wp = tab_firstwin; wp != NULL; wp = wp->w_next)
10084 if (!ses_do_win(wp))
10085 continue;
10086 if (put_view(fd, wp, wp != edited_win, &ssop_flags,
10087 cur_arg_idx) == FAIL)
10088 return FAIL;
10089 if (nr > 1 && put_line(fd, "wincmd w") == FAIL)
10090 return FAIL;
10091 next_arg_idx = wp->w_arg_idx;
10094 /* The argument index in the first tab page is zero, need to set it in
10095 * each window. For further tab pages it's the window where we do
10096 * "tabedit". */
10097 cur_arg_idx = next_arg_idx;
10100 * Restore cursor to the current window if it's not the first one.
10102 if (cnr > 1 && (fprintf(fd, "%dwincmd w", cnr) < 0
10103 || put_eol(fd) == FAIL))
10104 return FAIL;
10107 * Restore window sizes again after jumping around in windows, because
10108 * the current window has a minimum size while others may not.
10110 if (nr > 1 && ses_winsizes(fd, restore_size, tab_firstwin) == FAIL)
10111 return FAIL;
10113 /* Don't continue in another tab page when doing only the current one
10114 * or when at the last tab page. */
10115 if (!(ssop_flags & SSOP_TABPAGES))
10116 break;
10119 if (ssop_flags & SSOP_TABPAGES)
10121 if (fprintf(fd, "tabnext %d", tabpage_index(curtab)) < 0
10122 || put_eol(fd) == FAIL)
10123 return FAIL;
10127 * Wipe out an empty unnamed buffer we started in.
10129 if (put_line(fd, "if exists('s:wipebuf')") == FAIL)
10130 return FAIL;
10131 if (put_line(fd, " silent exe 'bwipe ' . s:wipebuf") == FAIL)
10132 return FAIL;
10133 if (put_line(fd, "endif") == FAIL)
10134 return FAIL;
10135 if (put_line(fd, "unlet! s:wipebuf") == FAIL)
10136 return FAIL;
10138 /* Re-apply 'winheight', 'winwidth' and 'shortmess'. */
10139 if (fprintf(fd, "set winheight=%ld winwidth=%ld shortmess=%s",
10140 p_wh, p_wiw, p_shm) < 0 || put_eol(fd) == FAIL)
10141 return FAIL;
10144 * Lastly, execute the x.vim file if it exists.
10146 if (put_line(fd, "let s:sx = expand(\"<sfile>:p:r\").\"x.vim\"") == FAIL
10147 || put_line(fd, "if file_readable(s:sx)") == FAIL
10148 || put_line(fd, " exe \"source \" . fnameescape(s:sx)") == FAIL
10149 || put_line(fd, "endif") == FAIL)
10150 return FAIL;
10152 return OK;
10155 static int
10156 ses_winsizes(fd, restore_size, tab_firstwin)
10157 FILE *fd;
10158 int restore_size;
10159 win_T *tab_firstwin;
10161 int n = 0;
10162 win_T *wp;
10164 if (restore_size && (ssop_flags & SSOP_WINSIZE))
10166 for (wp = tab_firstwin; wp != NULL; wp = wp->w_next)
10168 if (!ses_do_win(wp))
10169 continue;
10170 ++n;
10172 /* restore height when not full height */
10173 if (wp->w_height + wp->w_status_height < topframe->fr_height
10174 && (fprintf(fd,
10175 "exe '%dresize ' . ((&lines * %ld + %ld) / %ld)",
10176 n, (long)wp->w_height, Rows / 2, Rows) < 0
10177 || put_eol(fd) == FAIL))
10178 return FAIL;
10180 /* restore width when not full width */
10181 if (wp->w_width < Columns && (fprintf(fd,
10182 "exe 'vert %dresize ' . ((&columns * %ld + %ld) / %ld)",
10183 n, (long)wp->w_width, Columns / 2, Columns) < 0
10184 || put_eol(fd) == FAIL))
10185 return FAIL;
10188 else
10190 /* Just equalise window sizes */
10191 if (put_line(fd, "wincmd =") == FAIL)
10192 return FAIL;
10194 return OK;
10198 * Write commands to "fd" to recursively create windows for frame "fr",
10199 * horizontally and vertically split.
10200 * After the commands the last window in the frame is the current window.
10201 * Returns FAIL when writing the commands to "fd" fails.
10203 static int
10204 ses_win_rec(fd, fr)
10205 FILE *fd;
10206 frame_T *fr;
10208 frame_T *frc;
10209 int count = 0;
10211 if (fr->fr_layout != FR_LEAF)
10213 /* Find first frame that's not skipped and then create a window for
10214 * each following one (first frame is already there). */
10215 frc = ses_skipframe(fr->fr_child);
10216 if (frc != NULL)
10217 while ((frc = ses_skipframe(frc->fr_next)) != NULL)
10219 /* Make window as big as possible so that we have lots of room
10220 * to split. */
10221 if (put_line(fd, "wincmd _ | wincmd |") == FAIL
10222 || put_line(fd, fr->fr_layout == FR_COL
10223 ? "split" : "vsplit") == FAIL)
10224 return FAIL;
10225 ++count;
10228 /* Go back to the first window. */
10229 if (count > 0 && (fprintf(fd, fr->fr_layout == FR_COL
10230 ? "%dwincmd k" : "%dwincmd h", count) < 0
10231 || put_eol(fd) == FAIL))
10232 return FAIL;
10234 /* Recursively create frames/windows in each window of this column or
10235 * row. */
10236 frc = ses_skipframe(fr->fr_child);
10237 while (frc != NULL)
10239 ses_win_rec(fd, frc);
10240 frc = ses_skipframe(frc->fr_next);
10241 /* Go to next window. */
10242 if (frc != NULL && put_line(fd, "wincmd w") == FAIL)
10243 return FAIL;
10246 return OK;
10250 * Skip frames that don't contain windows we want to save in the Session.
10251 * Returns NULL when there none.
10253 static frame_T *
10254 ses_skipframe(fr)
10255 frame_T *fr;
10257 frame_T *frc;
10259 for (frc = fr; frc != NULL; frc = frc->fr_next)
10260 if (ses_do_frame(frc))
10261 break;
10262 return frc;
10266 * Return TRUE if frame "fr" has a window somewhere that we want to save in
10267 * the Session.
10269 static int
10270 ses_do_frame(fr)
10271 frame_T *fr;
10273 frame_T *frc;
10275 if (fr->fr_layout == FR_LEAF)
10276 return ses_do_win(fr->fr_win);
10277 for (frc = fr->fr_child; frc != NULL; frc = frc->fr_next)
10278 if (ses_do_frame(frc))
10279 return TRUE;
10280 return FALSE;
10284 * Return non-zero if window "wp" is to be stored in the Session.
10286 static int
10287 ses_do_win(wp)
10288 win_T *wp;
10290 if (wp->w_buffer->b_fname == NULL
10291 #ifdef FEAT_QUICKFIX
10292 /* When 'buftype' is "nofile" can't restore the window contents. */
10293 || bt_nofile(wp->w_buffer)
10294 #endif
10296 return (ssop_flags & SSOP_BLANK);
10297 if (wp->w_buffer->b_help)
10298 return (ssop_flags & SSOP_HELP);
10299 return TRUE;
10303 * Write commands to "fd" to restore the view of a window.
10304 * Caller must make sure 'scrolloff' is zero.
10306 static int
10307 put_view(fd, wp, add_edit, flagp, current_arg_idx)
10308 FILE *fd;
10309 win_T *wp;
10310 int add_edit; /* add ":edit" command to view */
10311 unsigned *flagp; /* vop_flags or ssop_flags */
10312 int current_arg_idx; /* current argument index of the window, use
10313 * -1 if unknown */
10315 win_T *save_curwin;
10316 int f;
10317 int do_cursor;
10318 int did_next = FALSE;
10320 /* Always restore cursor position for ":mksession". For ":mkview" only
10321 * when 'viewoptions' contains "cursor". */
10322 do_cursor = (flagp == &ssop_flags || *flagp & SSOP_CURSOR);
10325 * Local argument list.
10327 if (wp->w_alist == &global_alist)
10329 if (put_line(fd, "argglobal") == FAIL)
10330 return FAIL;
10332 else
10334 if (ses_arglist(fd, "arglocal", &wp->w_alist->al_ga,
10335 flagp == &vop_flags
10336 || !(*flagp & SSOP_CURDIR)
10337 || wp->w_localdir != NULL, flagp) == FAIL)
10338 return FAIL;
10341 /* Only when part of a session: restore the argument index. Some
10342 * arguments may have been deleted, check if the index is valid. */
10343 if (wp->w_arg_idx != current_arg_idx && wp->w_arg_idx <= WARGCOUNT(wp)
10344 && flagp == &ssop_flags)
10346 if (fprintf(fd, "%ldargu", (long)wp->w_arg_idx + 1) < 0
10347 || put_eol(fd) == FAIL)
10348 return FAIL;
10349 did_next = TRUE;
10352 /* Edit the file. Skip this when ":next" already did it. */
10353 if (add_edit && (!did_next || wp->w_arg_idx_invalid))
10356 * Load the file.
10358 if (wp->w_buffer->b_ffname != NULL
10359 #ifdef FEAT_QUICKFIX
10360 && !bt_nofile(wp->w_buffer)
10361 #endif
10365 * Editing a file in this buffer: use ":edit file".
10366 * This may have side effects! (e.g., compressed or network file).
10368 if (fputs("edit ", fd) < 0
10369 || ses_fname(fd, wp->w_buffer, flagp) == FAIL)
10370 return FAIL;
10372 else
10374 /* No file in this buffer, just make it empty. */
10375 if (put_line(fd, "enew") == FAIL)
10376 return FAIL;
10377 #ifdef FEAT_QUICKFIX
10378 if (wp->w_buffer->b_ffname != NULL)
10380 /* The buffer does have a name, but it's not a file name. */
10381 if (fputs("file ", fd) < 0
10382 || ses_fname(fd, wp->w_buffer, flagp) == FAIL)
10383 return FAIL;
10385 #endif
10386 do_cursor = FALSE;
10391 * Local mappings and abbreviations.
10393 if ((*flagp & (SSOP_OPTIONS | SSOP_LOCALOPTIONS))
10394 && makemap(fd, wp->w_buffer) == FAIL)
10395 return FAIL;
10398 * Local options. Need to go to the window temporarily.
10399 * Store only local values when using ":mkview" and when ":mksession" is
10400 * used and 'sessionoptions' doesn't include "options".
10401 * Some folding options are always stored when "folds" is included,
10402 * otherwise the folds would not be restored correctly.
10404 save_curwin = curwin;
10405 curwin = wp;
10406 curbuf = curwin->w_buffer;
10407 if (*flagp & (SSOP_OPTIONS | SSOP_LOCALOPTIONS))
10408 f = makeset(fd, OPT_LOCAL,
10409 flagp == &vop_flags || !(*flagp & SSOP_OPTIONS));
10410 #ifdef FEAT_FOLDING
10411 else if (*flagp & SSOP_FOLDS)
10412 f = makefoldset(fd);
10413 #endif
10414 else
10415 f = OK;
10416 curwin = save_curwin;
10417 curbuf = curwin->w_buffer;
10418 if (f == FAIL)
10419 return FAIL;
10421 #ifdef FEAT_FOLDING
10423 * Save Folds when 'buftype' is empty and for help files.
10425 if ((*flagp & SSOP_FOLDS)
10426 && wp->w_buffer->b_ffname != NULL
10427 # ifdef FEAT_QUICKFIX
10428 && (*wp->w_buffer->b_p_bt == NUL || wp->w_buffer->b_help)
10429 # endif
10432 if (put_folds(fd, wp) == FAIL)
10433 return FAIL;
10435 #endif
10438 * Set the cursor after creating folds, since that moves the cursor.
10440 if (do_cursor)
10443 /* Restore the cursor line in the file and relatively in the
10444 * window. Don't use "G", it changes the jumplist. */
10445 if (fprintf(fd, "let s:l = %ld - ((%ld * winheight(0) + %ld) / %ld)",
10446 (long)wp->w_cursor.lnum,
10447 (long)(wp->w_cursor.lnum - wp->w_topline),
10448 (long)wp->w_height / 2, (long)wp->w_height) < 0
10449 || put_eol(fd) == FAIL
10450 || put_line(fd, "if s:l < 1 | let s:l = 1 | endif") == FAIL
10451 || put_line(fd, "exe s:l") == FAIL
10452 || put_line(fd, "normal! zt") == FAIL
10453 || fprintf(fd, "%ld", (long)wp->w_cursor.lnum) < 0
10454 || put_eol(fd) == FAIL)
10455 return FAIL;
10456 /* Restore the cursor column and left offset when not wrapping. */
10457 if (wp->w_cursor.col == 0)
10459 if (put_line(fd, "normal! 0") == FAIL)
10460 return FAIL;
10462 else
10464 if (!wp->w_p_wrap && wp->w_leftcol > 0 && wp->w_width > 0)
10466 if (fprintf(fd,
10467 "let s:c = %ld - ((%ld * winwidth(0) + %ld) / %ld)",
10468 (long)wp->w_cursor.col,
10469 (long)(wp->w_cursor.col - wp->w_leftcol),
10470 (long)wp->w_width / 2, (long)wp->w_width) < 0
10471 || put_eol(fd) == FAIL
10472 || put_line(fd, "if s:c > 0") == FAIL
10473 || fprintf(fd,
10474 " exe 'normal! 0' . s:c . 'lzs' . (%ld - s:c) . 'l'",
10475 (long)wp->w_cursor.col) < 0
10476 || put_eol(fd) == FAIL
10477 || put_line(fd, "else") == FAIL
10478 || fprintf(fd, " normal! 0%dl", wp->w_cursor.col) < 0
10479 || put_eol(fd) == FAIL
10480 || put_line(fd, "endif") == FAIL)
10481 return FAIL;
10483 else
10485 if (fprintf(fd, "normal! 0%dl", wp->w_cursor.col) < 0
10486 || put_eol(fd) == FAIL)
10487 return FAIL;
10493 * Local directory.
10495 if (wp->w_localdir != NULL)
10497 if (fputs("lcd ", fd) < 0
10498 || ses_put_fname(fd, wp->w_localdir, flagp) == FAIL
10499 || put_eol(fd) == FAIL)
10500 return FAIL;
10501 did_lcd = TRUE;
10504 return OK;
10508 * Write an argument list to the session file.
10509 * Returns FAIL if writing fails.
10511 static int
10512 ses_arglist(fd, cmd, gap, fullname, flagp)
10513 FILE *fd;
10514 char *cmd;
10515 garray_T *gap;
10516 int fullname; /* TRUE: use full path name */
10517 unsigned *flagp;
10519 int i;
10520 char_u buf[MAXPATHL];
10521 char_u *s;
10523 if (gap->ga_len == 0)
10524 return put_line(fd, "silent! argdel *");
10525 if (fputs(cmd, fd) < 0)
10526 return FAIL;
10527 for (i = 0; i < gap->ga_len; ++i)
10529 /* NULL file names are skipped (only happens when out of memory). */
10530 s = alist_name(&((aentry_T *)gap->ga_data)[i]);
10531 if (s != NULL)
10533 if (fullname)
10535 (void)vim_FullName(s, buf, MAXPATHL, FALSE);
10536 s = buf;
10538 if (fputs(" ", fd) < 0 || ses_put_fname(fd, s, flagp) == FAIL)
10539 return FAIL;
10542 return put_eol(fd);
10546 * Write a buffer name to the session file.
10547 * Also ends the line.
10548 * Returns FAIL if writing fails.
10550 static int
10551 ses_fname(fd, buf, flagp)
10552 FILE *fd;
10553 buf_T *buf;
10554 unsigned *flagp;
10556 char_u *name;
10558 /* Use the short file name if the current directory is known at the time
10559 * the session file will be sourced.
10560 * Don't do this for ":mkview", we don't know the current directory.
10561 * Don't do this after ":lcd", we don't keep track of what the current
10562 * directory is. */
10563 if (buf->b_sfname != NULL
10564 && flagp == &ssop_flags
10565 && (ssop_flags & (SSOP_CURDIR | SSOP_SESDIR))
10566 && !did_lcd)
10567 name = buf->b_sfname;
10568 else
10569 name = buf->b_ffname;
10570 if (ses_put_fname(fd, name, flagp) == FAIL || put_eol(fd) == FAIL)
10571 return FAIL;
10572 return OK;
10576 * Write a file name to the session file.
10577 * Takes care of the "slash" option in 'sessionoptions' and escapes special
10578 * characters.
10579 * Returns FAIL if writing fails.
10581 static int
10582 ses_put_fname(fd, name, flagp)
10583 FILE *fd;
10584 char_u *name;
10585 unsigned *flagp;
10587 char_u *sname;
10588 int retval = OK;
10589 int c;
10591 sname = home_replace_save(NULL, name);
10592 if (sname != NULL)
10593 name = sname;
10594 while (*name != NUL)
10596 #ifdef FEAT_MBYTE
10598 int l;
10600 if (has_mbyte && (l = (*mb_ptr2len)(name)) > 1)
10602 /* copy a multibyte char */
10603 while (--l >= 0)
10605 if (putc(*name, fd) != *name)
10606 retval = FAIL;
10607 ++name;
10609 continue;
10612 #endif
10613 c = *name++;
10614 if (c == '\\' && (*flagp & SSOP_SLASH))
10615 /* change a backslash to a forward slash */
10616 c = '/';
10617 else if ((vim_strchr(escape_chars, c) != NULL
10618 #ifdef BACKSLASH_IN_FILENAME
10619 && c != '\\'
10620 #endif
10621 ) || c == '#' || c == '%')
10623 /* escape a special character with a backslash */
10624 if (putc('\\', fd) != '\\')
10625 retval = FAIL;
10627 if (putc(c, fd) != c)
10628 retval = FAIL;
10630 vim_free(sname);
10631 return retval;
10635 * ":loadview [nr]"
10637 static void
10638 ex_loadview(eap)
10639 exarg_T *eap;
10641 char_u *fname;
10643 fname = get_view_file(*eap->arg);
10644 if (fname != NULL)
10646 do_source(fname, FALSE, DOSO_NONE);
10647 vim_free(fname);
10652 * Get the name of the view file for the current buffer.
10654 static char_u *
10655 get_view_file(c)
10656 int c;
10658 int len = 0;
10659 char_u *p, *s;
10660 char_u *retval;
10661 char_u *sname;
10663 if (curbuf->b_ffname == NULL)
10665 EMSG(_(e_noname));
10666 return NULL;
10668 sname = home_replace_save(NULL, curbuf->b_ffname);
10669 if (sname == NULL)
10670 return NULL;
10673 * We want a file name without separators, because we're not going to make
10674 * a directory.
10675 * "normal" path separator -> "=+"
10676 * "=" -> "=="
10677 * ":" path separator -> "=-"
10679 for (p = sname; *p; ++p)
10680 if (*p == '=' || vim_ispathsep(*p))
10681 ++len;
10682 retval = alloc((unsigned)(STRLEN(sname) + len + STRLEN(p_vdir) + 9));
10683 if (retval != NULL)
10685 STRCPY(retval, p_vdir);
10686 add_pathsep(retval);
10687 s = retval + STRLEN(retval);
10688 for (p = sname; *p; ++p)
10690 if (*p == '=')
10692 *s++ = '=';
10693 *s++ = '=';
10695 else if (vim_ispathsep(*p))
10697 *s++ = '=';
10698 #if defined(BACKSLASH_IN_FILENAME) || defined(AMIGA) || defined(RISCOS) \
10699 || defined(VMS)
10700 if (*p == ':')
10701 *s++ = '-';
10702 else
10703 #endif
10704 *s++ = '+';
10706 else
10707 *s++ = *p;
10709 *s++ = '=';
10710 *s++ = c;
10711 STRCPY(s, ".vim");
10714 vim_free(sname);
10715 return retval;
10718 #endif /* FEAT_SESSION */
10721 * Write end-of-line character(s) for ":mkexrc", ":mkvimrc" and ":mksession".
10722 * Return FAIL for a write error.
10725 put_eol(fd)
10726 FILE *fd;
10728 if (
10729 #ifdef USE_CRNL
10731 # ifdef MKSESSION_NL
10732 !mksession_nl &&
10733 # endif
10734 (putc('\r', fd) < 0)) ||
10735 #endif
10736 (putc('\n', fd) < 0))
10737 return FAIL;
10738 return OK;
10742 * Write a line to "fd".
10743 * Return FAIL for a write error.
10746 put_line(fd, s)
10747 FILE *fd;
10748 char *s;
10750 if (fputs(s, fd) < 0 || put_eol(fd) == FAIL)
10751 return FAIL;
10752 return OK;
10755 #ifdef FEAT_VIMINFO
10757 * ":rviminfo" and ":wviminfo".
10759 static void
10760 ex_viminfo(eap)
10761 exarg_T *eap;
10763 char_u *save_viminfo;
10765 save_viminfo = p_viminfo;
10766 if (*p_viminfo == NUL)
10767 p_viminfo = (char_u *)"'100";
10768 if (eap->cmdidx == CMD_rviminfo)
10770 if (read_viminfo(eap->arg, VIF_WANT_INFO | VIF_WANT_MARKS
10771 | (eap->forceit ? VIF_FORCEIT : 0)) == FAIL)
10772 EMSG(_("E195: Cannot open viminfo file for reading"));
10774 else
10775 write_viminfo(eap->arg, eap->forceit);
10776 p_viminfo = save_viminfo;
10778 #endif
10780 #if defined(FEAT_GUI_DIALOG) || defined(FEAT_CON_DIALOG) || defined(PROTO)
10782 * Make a dialog message in "buff[IOSIZE]".
10783 * "format" must contain "%s".
10785 void
10786 dialog_msg(buff, format, fname)
10787 char_u *buff;
10788 char *format;
10789 char_u *fname;
10791 if (fname == NULL)
10792 fname = (char_u *)_("Untitled");
10793 vim_snprintf((char *)buff, IOSIZE, format, fname);
10795 #endif
10798 * ":behave {mswin,xterm}"
10800 static void
10801 ex_behave(eap)
10802 exarg_T *eap;
10804 if (STRCMP(eap->arg, "mswin") == 0)
10806 set_option_value((char_u *)"selection", 0L, (char_u *)"exclusive", 0);
10807 set_option_value((char_u *)"selectmode", 0L, (char_u *)"mouse,key", 0);
10808 set_option_value((char_u *)"mousemodel", 0L, (char_u *)"popup", 0);
10809 set_option_value((char_u *)"keymodel", 0L,
10810 (char_u *)"startsel,stopsel", 0);
10812 else if (STRCMP(eap->arg, "xterm") == 0)
10814 set_option_value((char_u *)"selection", 0L, (char_u *)"inclusive", 0);
10815 set_option_value((char_u *)"selectmode", 0L, (char_u *)"", 0);
10816 set_option_value((char_u *)"mousemodel", 0L, (char_u *)"extend", 0);
10817 set_option_value((char_u *)"keymodel", 0L, (char_u *)"", 0);
10819 else
10820 EMSG2(_(e_invarg2), eap->arg);
10823 #ifdef FEAT_AUTOCMD
10824 static int filetype_detect = FALSE;
10825 static int filetype_plugin = FALSE;
10826 static int filetype_indent = FALSE;
10829 * ":filetype [plugin] [indent] {on,off,detect}"
10830 * on: Load the filetype.vim file to install autocommands for file types.
10831 * off: Load the ftoff.vim file to remove all autocommands for file types.
10832 * plugin on: load filetype.vim and ftplugin.vim
10833 * plugin off: load ftplugof.vim
10834 * indent on: load filetype.vim and indent.vim
10835 * indent off: load indoff.vim
10837 static void
10838 ex_filetype(eap)
10839 exarg_T *eap;
10841 char_u *arg = eap->arg;
10842 int plugin = FALSE;
10843 int indent = FALSE;
10845 if (*eap->arg == NUL)
10847 /* Print current status. */
10848 smsg((char_u *)"filetype detection:%s plugin:%s indent:%s",
10849 filetype_detect ? "ON" : "OFF",
10850 filetype_plugin ? (filetype_detect ? "ON" : "(on)") : "OFF",
10851 filetype_indent ? (filetype_detect ? "ON" : "(on)") : "OFF");
10852 return;
10855 /* Accept "plugin" and "indent" in any order. */
10856 for (;;)
10858 if (STRNCMP(arg, "plugin", 6) == 0)
10860 plugin = TRUE;
10861 arg = skipwhite(arg + 6);
10862 continue;
10864 if (STRNCMP(arg, "indent", 6) == 0)
10866 indent = TRUE;
10867 arg = skipwhite(arg + 6);
10868 continue;
10870 break;
10872 if (STRCMP(arg, "on") == 0 || STRCMP(arg, "detect") == 0)
10874 if (*arg == 'o' || !filetype_detect)
10876 source_runtime((char_u *)FILETYPE_FILE, TRUE);
10877 filetype_detect = TRUE;
10878 if (plugin)
10880 source_runtime((char_u *)FTPLUGIN_FILE, TRUE);
10881 filetype_plugin = TRUE;
10883 if (indent)
10885 source_runtime((char_u *)INDENT_FILE, TRUE);
10886 filetype_indent = TRUE;
10889 if (*arg == 'd')
10891 (void)do_doautocmd((char_u *)"filetypedetect BufRead", TRUE);
10892 do_modelines(0);
10895 else if (STRCMP(arg, "off") == 0)
10897 if (plugin || indent)
10899 if (plugin)
10901 source_runtime((char_u *)FTPLUGOF_FILE, TRUE);
10902 filetype_plugin = FALSE;
10904 if (indent)
10906 source_runtime((char_u *)INDOFF_FILE, TRUE);
10907 filetype_indent = FALSE;
10910 else
10912 source_runtime((char_u *)FTOFF_FILE, TRUE);
10913 filetype_detect = FALSE;
10916 else
10917 EMSG2(_(e_invarg2), arg);
10921 * ":setfiletype {name}"
10923 static void
10924 ex_setfiletype(eap)
10925 exarg_T *eap;
10927 if (!did_filetype)
10928 set_option_value((char_u *)"filetype", 0L, eap->arg, OPT_LOCAL);
10930 #endif
10932 /*ARGSUSED*/
10933 static void
10934 ex_digraphs(eap)
10935 exarg_T *eap;
10937 #ifdef FEAT_DIGRAPHS
10938 if (*eap->arg != NUL)
10939 putdigraph(eap->arg);
10940 else
10941 listdigraphs();
10942 #else
10943 EMSG(_("E196: No digraphs in this version"));
10944 #endif
10947 static void
10948 ex_set(eap)
10949 exarg_T *eap;
10951 int flags = 0;
10953 if (eap->cmdidx == CMD_setlocal)
10954 flags = OPT_LOCAL;
10955 else if (eap->cmdidx == CMD_setglobal)
10956 flags = OPT_GLOBAL;
10957 #if defined(FEAT_EVAL) && defined(FEAT_AUTOCMD) && defined(FEAT_BROWSE)
10958 if (cmdmod.browse && flags == 0)
10959 ex_options(eap);
10960 else
10961 #endif
10962 (void)do_set(eap->arg, flags);
10965 #ifdef FEAT_SEARCH_EXTRA
10967 * ":nohlsearch"
10969 /*ARGSUSED*/
10970 static void
10971 ex_nohlsearch(eap)
10972 exarg_T *eap;
10974 no_hlsearch = TRUE;
10975 redraw_all_later(SOME_VALID);
10979 * ":[N]match {group} {pattern}"
10980 * Sets nextcmd to the start of the next command, if any. Also called when
10981 * skipping commands to find the next command.
10983 static void
10984 ex_match(eap)
10985 exarg_T *eap;
10987 char_u *p;
10988 char_u *g = NULL;
10989 char_u *end;
10990 int c;
10991 int id;
10993 if (eap->line2 <= 3)
10994 id = eap->line2;
10995 else
10997 EMSG(e_invcmd);
10998 return;
11001 /* First clear any old pattern. */
11002 if (!eap->skip)
11003 match_delete(curwin, id, FALSE);
11005 if (ends_excmd(*eap->arg))
11006 end = eap->arg;
11007 else if ((STRNICMP(eap->arg, "none", 4) == 0
11008 && (vim_iswhite(eap->arg[4]) || ends_excmd(eap->arg[4]))))
11009 end = eap->arg + 4;
11010 else
11012 p = skiptowhite(eap->arg);
11013 if (!eap->skip)
11014 g = vim_strnsave(eap->arg, (int)(p - eap->arg));
11015 p = skipwhite(p);
11016 if (*p == NUL)
11018 /* There must be two arguments. */
11019 EMSG2(_(e_invarg2), eap->arg);
11020 return;
11022 end = skip_regexp(p + 1, *p, TRUE, NULL);
11023 if (!eap->skip)
11025 if (*end != NUL && !ends_excmd(*skipwhite(end + 1)))
11027 eap->errmsg = e_trailing;
11028 return;
11030 if (*end != *p)
11032 EMSG2(_(e_invarg2), p);
11033 return;
11036 c = *end;
11037 *end = NUL;
11038 match_add(curwin, g, p + 1, 10, id);
11039 vim_free(g);
11040 *end = c;
11043 eap->nextcmd = find_nextcmd(end);
11045 #endif
11047 #ifdef FEAT_CRYPT
11049 * ":X": Get crypt key
11051 /*ARGSUSED*/
11052 static void
11053 ex_X(eap)
11054 exarg_T *eap;
11056 (void)get_crypt_key(TRUE, TRUE);
11058 #endif
11060 #ifdef FEAT_FOLDING
11061 static void
11062 ex_fold(eap)
11063 exarg_T *eap;
11065 if (foldManualAllowed(TRUE))
11066 foldCreate(eap->line1, eap->line2);
11069 static void
11070 ex_foldopen(eap)
11071 exarg_T *eap;
11073 opFoldRange(eap->line1, eap->line2, eap->cmdidx == CMD_foldopen,
11074 eap->forceit, FALSE);
11077 static void
11078 ex_folddo(eap)
11079 exarg_T *eap;
11081 linenr_T lnum;
11083 /* First set the marks for all lines closed/open. */
11084 for (lnum = eap->line1; lnum <= eap->line2; ++lnum)
11085 if (hasFolding(lnum, NULL, NULL) == (eap->cmdidx == CMD_folddoclosed))
11086 ml_setmarked(lnum);
11088 /* Execute the command on the marked lines. */
11089 global_exe(eap->arg);
11090 ml_clearmarked(); /* clear rest of the marks */
11092 #endif