blob: a82b89727e0c1104fc66cdb7c631fc08f0c28cf1 [file] [log] [blame]
Bram Moolenaar261f3462019-09-07 15:45:32 +02001/* vi:set ts=8 sts=4 sw=4 noet:
2 *
3 * VIM - Vi IMproved by Bram Moolenaar
4 *
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 */
9
10/*
11 * evalbuffer.c: Buffer related builtin functions
12 */
13
14#include "vim.h"
15
16#if defined(FEAT_EVAL) || defined(PROTO)
17/*
18 * Mark references in functions of buffers.
19 */
20 int
21set_ref_in_buffers(int copyID)
22{
23 int abort = FALSE;
24 buf_T *bp;
25
26 FOR_ALL_BUFFERS(bp)
27 {
28 listener_T *lnr;
29 typval_T tv;
30
31 for (lnr = bp->b_listener; !abort && lnr != NULL; lnr = lnr->lr_next)
32 {
33 if (lnr->lr_callback.cb_partial != NULL)
34 {
35 tv.v_type = VAR_PARTIAL;
36 tv.vval.v_partial = lnr->lr_callback.cb_partial;
37 abort = abort || set_ref_in_item(&tv, copyID, NULL, NULL);
38 }
39 }
40# ifdef FEAT_JOB_CHANNEL
41 if (!abort && bp->b_prompt_callback.cb_partial != NULL)
42 {
43 tv.v_type = VAR_PARTIAL;
44 tv.vval.v_partial = bp->b_prompt_callback.cb_partial;
45 abort = abort || set_ref_in_item(&tv, copyID, NULL, NULL);
46 }
47 if (!abort && bp->b_prompt_interrupt.cb_partial != NULL)
48 {
49 tv.v_type = VAR_PARTIAL;
50 tv.vval.v_partial = bp->b_prompt_interrupt.cb_partial;
51 abort = abort || set_ref_in_item(&tv, copyID, NULL, NULL);
52 }
53# endif
54 if (abort)
55 break;
56 }
57 return abort;
58}
59
60 buf_T *
61buflist_find_by_name(char_u *name, int curtab_only)
62{
63 int save_magic;
64 char_u *save_cpo;
65 buf_T *buf;
66
67 // Ignore 'magic' and 'cpoptions' here to make scripts portable
68 save_magic = p_magic;
69 p_magic = TRUE;
70 save_cpo = p_cpo;
71 p_cpo = (char_u *)"";
72
73 buf = buflist_findnr(buflist_findpat(name, name + STRLEN(name),
74 TRUE, FALSE, curtab_only));
75
76 p_magic = save_magic;
77 p_cpo = save_cpo;
78 return buf;
79}
80
81/*
82 * Find a buffer by number or exact name.
83 */
84 buf_T *
85find_buffer(typval_T *avar)
86{
87 buf_T *buf = NULL;
88
89 if (avar->v_type == VAR_NUMBER)
90 buf = buflist_findnr((int)avar->vval.v_number);
91 else if (avar->v_type == VAR_STRING && avar->vval.v_string != NULL)
92 {
93 buf = buflist_findname_exp(avar->vval.v_string);
94 if (buf == NULL)
95 {
96 // No full path name match, try a match with a URL or a "nofile"
97 // buffer, these don't use the full path.
98 FOR_ALL_BUFFERS(buf)
99 if (buf->b_fname != NULL
100 && (path_with_url(buf->b_fname)
101#ifdef FEAT_QUICKFIX
102 || bt_nofilename(buf)
103#endif
104 )
105 && STRCMP(buf->b_fname, avar->vval.v_string) == 0)
106 break;
107 }
108 }
109 return buf;
110}
111
112/*
113 * If there is a window for "curbuf", make it the current window.
114 */
115 static void
116find_win_for_curbuf(void)
117{
118 wininfo_T *wip;
119
120 for (wip = curbuf->b_wininfo; wip != NULL; wip = wip->wi_next)
121 {
122 if (wip->wi_win != NULL)
123 {
124 curwin = wip->wi_win;
125 break;
126 }
127 }
128}
129
130/*
131 * Set line or list of lines in buffer "buf".
132 */
133 static void
134set_buffer_lines(
135 buf_T *buf,
136 linenr_T lnum_arg,
137 int append,
138 typval_T *lines,
139 typval_T *rettv)
140{
141 linenr_T lnum = lnum_arg + (append ? 1 : 0);
142 char_u *line = NULL;
143 list_T *l = NULL;
144 listitem_T *li = NULL;
145 long added = 0;
146 linenr_T append_lnum;
147 buf_T *curbuf_save = NULL;
148 win_T *curwin_save = NULL;
149 int is_curbuf = buf == curbuf;
150
151 // When using the current buffer ml_mfp will be set if needed. Useful when
152 // setline() is used on startup. For other buffers the buffer must be
153 // loaded.
154 if (buf == NULL || (!is_curbuf && buf->b_ml.ml_mfp == NULL) || lnum < 1)
155 {
156 rettv->vval.v_number = 1; // FAIL
157 return;
158 }
159
160 if (!is_curbuf)
161 {
162 curbuf_save = curbuf;
163 curwin_save = curwin;
164 curbuf = buf;
165 find_win_for_curbuf();
166 }
167
168 if (append)
169 // appendbufline() uses the line number below which we insert
170 append_lnum = lnum - 1;
171 else
172 // setbufline() uses the line number above which we insert, we only
173 // append if it's below the last line
174 append_lnum = curbuf->b_ml.ml_line_count;
175
176 if (lines->v_type == VAR_LIST)
177 {
178 l = lines->vval.v_list;
179 li = l->lv_first;
180 }
181 else
182 line = tv_get_string_chk(lines);
183
184 // default result is zero == OK
185 for (;;)
186 {
187 if (l != NULL)
188 {
189 // list argument, get next string
190 if (li == NULL)
191 break;
192 line = tv_get_string_chk(&li->li_tv);
193 li = li->li_next;
194 }
195
196 rettv->vval.v_number = 1; // FAIL
197 if (line == NULL || lnum > curbuf->b_ml.ml_line_count + 1)
198 break;
199
200 // When coming here from Insert mode, sync undo, so that this can be
201 // undone separately from what was previously inserted.
202 if (u_sync_once == 2)
203 {
204 u_sync_once = 1; // notify that u_sync() was called
205 u_sync(TRUE);
206 }
207
208 if (!append && lnum <= curbuf->b_ml.ml_line_count)
209 {
210 // Existing line, replace it.
211 // Removes any existing text properties.
212 if (u_savesub(lnum) == OK && ml_replace_len(
213 lnum, line, (colnr_T)STRLEN(line) + 1, TRUE, TRUE) == OK)
214 {
215 changed_bytes(lnum, 0);
216 if (is_curbuf && lnum == curwin->w_cursor.lnum)
217 check_cursor_col();
218 rettv->vval.v_number = 0; // OK
219 }
220 }
221 else if (added > 0 || u_save(lnum - 1, lnum) == OK)
222 {
223 // append the line
224 ++added;
225 if (ml_append(lnum - 1, line, (colnr_T)0, FALSE) == OK)
226 rettv->vval.v_number = 0; // OK
227 }
228
229 if (l == NULL) // only one string argument
230 break;
231 ++lnum;
232 }
233
234 if (added > 0)
235 {
236 win_T *wp;
237 tabpage_T *tp;
238
239 appended_lines_mark(append_lnum, added);
240
241 // Only adjust the cursor for buffers other than the current, unless it
242 // is the current window. For curbuf and other windows it has been
243 // done in mark_adjust_internal().
244 FOR_ALL_TAB_WINDOWS(tp, wp)
245 if (wp->w_buffer == buf
246 && (wp->w_buffer != curbuf || wp == curwin)
247 && wp->w_cursor.lnum > append_lnum)
248 wp->w_cursor.lnum += added;
249 check_cursor_col();
250 update_topline();
251 }
252
253 if (!is_curbuf)
254 {
255 curbuf = curbuf_save;
256 curwin = curwin_save;
257 }
258}
259
260/*
261 * "append(lnum, string/list)" function
262 */
263 void
264f_append(typval_T *argvars, typval_T *rettv)
265{
266 linenr_T lnum = tv_get_lnum(&argvars[0]);
267
268 set_buffer_lines(curbuf, lnum, TRUE, &argvars[1], rettv);
269}
270
271/*
272 * "appendbufline(buf, lnum, string/list)" function
273 */
274 void
275f_appendbufline(typval_T *argvars, typval_T *rettv)
276{
277 linenr_T lnum;
278 buf_T *buf;
279
280 buf = tv_get_buf(&argvars[0], FALSE);
281 if (buf == NULL)
282 rettv->vval.v_number = 1; // FAIL
283 else
284 {
285 lnum = tv_get_lnum_buf(&argvars[1], buf);
286 set_buffer_lines(buf, lnum, TRUE, &argvars[2], rettv);
287 }
288}
289
290/*
291 * "bufadd(expr)" function
292 */
293 void
294f_bufadd(typval_T *argvars, typval_T *rettv)
295{
296 char_u *name = tv_get_string(&argvars[0]);
297
298 rettv->vval.v_number = buflist_add(*name == NUL ? NULL : name, 0);
299}
300
301/*
302 * "bufexists(expr)" function
303 */
304 void
305f_bufexists(typval_T *argvars, typval_T *rettv)
306{
307 rettv->vval.v_number = (find_buffer(&argvars[0]) != NULL);
308}
309
310/*
311 * "buflisted(expr)" function
312 */
313 void
314f_buflisted(typval_T *argvars, typval_T *rettv)
315{
316 buf_T *buf;
317
318 buf = find_buffer(&argvars[0]);
319 rettv->vval.v_number = (buf != NULL && buf->b_p_bl);
320}
321
322/*
323 * "bufload(expr)" function
324 */
325 void
326f_bufload(typval_T *argvars, typval_T *rettv UNUSED)
327{
328 buf_T *buf = get_buf_arg(&argvars[0]);
329
330 if (buf != NULL)
331 buffer_ensure_loaded(buf);
332}
333
334/*
335 * "bufloaded(expr)" function
336 */
337 void
338f_bufloaded(typval_T *argvars, typval_T *rettv)
339{
340 buf_T *buf;
341
342 buf = find_buffer(&argvars[0]);
343 rettv->vval.v_number = (buf != NULL && buf->b_ml.ml_mfp != NULL);
344}
345
346/*
347 * "bufname(expr)" function
348 */
349 void
350f_bufname(typval_T *argvars, typval_T *rettv)
351{
352 buf_T *buf;
353
354 if (argvars[0].v_type == VAR_UNKNOWN)
355 buf = curbuf;
356 else
357 {
358 (void)tv_get_number(&argvars[0]); // issue errmsg if type error
359 ++emsg_off;
360 buf = tv_get_buf(&argvars[0], FALSE);
361 --emsg_off;
362 }
363 rettv->v_type = VAR_STRING;
364 if (buf != NULL && buf->b_fname != NULL)
365 rettv->vval.v_string = vim_strsave(buf->b_fname);
366 else
367 rettv->vval.v_string = NULL;
368}
369
370/*
371 * "bufnr(expr)" function
372 */
373 void
374f_bufnr(typval_T *argvars, typval_T *rettv)
375{
376 buf_T *buf;
377 int error = FALSE;
378 char_u *name;
379
380 if (argvars[0].v_type == VAR_UNKNOWN)
381 buf = curbuf;
382 else
383 {
384 (void)tv_get_number(&argvars[0]); // issue errmsg if type error
385 ++emsg_off;
386 buf = tv_get_buf(&argvars[0], FALSE);
387 --emsg_off;
388 }
389
390 // If the buffer isn't found and the second argument is not zero create a
391 // new buffer.
392 if (buf == NULL
393 && argvars[1].v_type != VAR_UNKNOWN
394 && tv_get_number_chk(&argvars[1], &error) != 0
395 && !error
396 && (name = tv_get_string_chk(&argvars[0])) != NULL
397 && !error)
398 buf = buflist_new(name, NULL, (linenr_T)1, 0);
399
400 if (buf != NULL)
401 rettv->vval.v_number = buf->b_fnum;
402 else
403 rettv->vval.v_number = -1;
404}
405
406 static void
407buf_win_common(typval_T *argvars, typval_T *rettv, int get_nr)
408{
409 win_T *wp;
410 int winnr = 0;
411 buf_T *buf;
412
413 (void)tv_get_number(&argvars[0]); // issue errmsg if type error
414 ++emsg_off;
415 buf = tv_get_buf(&argvars[0], TRUE);
416 FOR_ALL_WINDOWS(wp)
417 {
418 ++winnr;
419 if (wp->w_buffer == buf)
420 break;
421 }
422 rettv->vval.v_number = (wp != NULL ? (get_nr ? winnr : wp->w_id) : -1);
423 --emsg_off;
424}
425
426/*
427 * "bufwinid(nr)" function
428 */
429 void
430f_bufwinid(typval_T *argvars, typval_T *rettv)
431{
432 buf_win_common(argvars, rettv, FALSE);
433}
434
435/*
436 * "bufwinnr(nr)" function
437 */
438 void
439f_bufwinnr(typval_T *argvars, typval_T *rettv)
440{
441 buf_win_common(argvars, rettv, TRUE);
442}
443
444/*
445 * "deletebufline()" function
446 */
447 void
448f_deletebufline(typval_T *argvars, typval_T *rettv)
449{
450 buf_T *buf;
451 linenr_T first, last;
452 linenr_T lnum;
453 long count;
454 int is_curbuf;
455 buf_T *curbuf_save = NULL;
456 win_T *curwin_save = NULL;
457 tabpage_T *tp;
458 win_T *wp;
459
460 buf = tv_get_buf(&argvars[0], FALSE);
461 if (buf == NULL)
462 {
463 rettv->vval.v_number = 1; // FAIL
464 return;
465 }
466 is_curbuf = buf == curbuf;
467
468 first = tv_get_lnum_buf(&argvars[1], buf);
469 if (argvars[2].v_type != VAR_UNKNOWN)
470 last = tv_get_lnum_buf(&argvars[2], buf);
471 else
472 last = first;
473
474 if (buf->b_ml.ml_mfp == NULL || first < 1
475 || first > buf->b_ml.ml_line_count || last < first)
476 {
477 rettv->vval.v_number = 1; // FAIL
478 return;
479 }
480
481 if (!is_curbuf)
482 {
483 curbuf_save = curbuf;
484 curwin_save = curwin;
485 curbuf = buf;
486 find_win_for_curbuf();
487 }
488 if (last > curbuf->b_ml.ml_line_count)
489 last = curbuf->b_ml.ml_line_count;
490 count = last - first + 1;
491
492 // When coming here from Insert mode, sync undo, so that this can be
493 // undone separately from what was previously inserted.
494 if (u_sync_once == 2)
495 {
496 u_sync_once = 1; // notify that u_sync() was called
497 u_sync(TRUE);
498 }
499
500 if (u_save(first - 1, last + 1) == FAIL)
501 {
502 rettv->vval.v_number = 1; // FAIL
503 return;
504 }
505
506 for (lnum = first; lnum <= last; ++lnum)
507 ml_delete(first, TRUE);
508
509 FOR_ALL_TAB_WINDOWS(tp, wp)
510 if (wp->w_buffer == buf)
511 {
512 if (wp->w_cursor.lnum > last)
513 wp->w_cursor.lnum -= count;
514 else if (wp->w_cursor.lnum> first)
515 wp->w_cursor.lnum = first;
516 if (wp->w_cursor.lnum > wp->w_buffer->b_ml.ml_line_count)
517 wp->w_cursor.lnum = wp->w_buffer->b_ml.ml_line_count;
518 }
519 check_cursor_col();
520 deleted_lines_mark(first, count);
521
522 if (!is_curbuf)
523 {
524 curbuf = curbuf_save;
525 curwin = curwin_save;
526 }
527}
528
529/*
530 * Returns buffer options, variables and other attributes in a dictionary.
531 */
532 static dict_T *
533get_buffer_info(buf_T *buf)
534{
535 dict_T *dict;
536 tabpage_T *tp;
537 win_T *wp;
538 list_T *windows;
539
540 dict = dict_alloc();
541 if (dict == NULL)
542 return NULL;
543
544 dict_add_number(dict, "bufnr", buf->b_fnum);
545 dict_add_string(dict, "name", buf->b_ffname);
546 dict_add_number(dict, "lnum", buf == curbuf ? curwin->w_cursor.lnum
547 : buflist_findlnum(buf));
548 dict_add_number(dict, "loaded", buf->b_ml.ml_mfp != NULL);
549 dict_add_number(dict, "listed", buf->b_p_bl);
550 dict_add_number(dict, "changed", bufIsChanged(buf));
551 dict_add_number(dict, "changedtick", CHANGEDTICK(buf));
552 dict_add_number(dict, "hidden",
553 buf->b_ml.ml_mfp != NULL && buf->b_nwindows == 0);
554
555 // Get a reference to buffer variables
556 dict_add_dict(dict, "variables", buf->b_vars);
557
558 // List of windows displaying this buffer
559 windows = list_alloc();
560 if (windows != NULL)
561 {
562 FOR_ALL_TAB_WINDOWS(tp, wp)
563 if (wp->w_buffer == buf)
564 list_append_number(windows, (varnumber_T)wp->w_id);
565 dict_add_list(dict, "windows", windows);
566 }
567
568#ifdef FEAT_TEXT_PROP
569 // List of popup windows displaying this buffer
570 windows = list_alloc();
571 if (windows != NULL)
572 {
573 for (wp = first_popupwin; wp != NULL; wp = wp->w_next)
574 if (wp->w_buffer == buf)
575 list_append_number(windows, (varnumber_T)wp->w_id);
576 FOR_ALL_TABPAGES(tp)
577 for (wp = tp->tp_first_popupwin; wp != NULL; wp = wp->w_next)
578 if (wp->w_buffer == buf)
579 list_append_number(windows, (varnumber_T)wp->w_id);
580
581 dict_add_list(dict, "popups", windows);
582 }
583#endif
584
585#ifdef FEAT_SIGNS
586 if (buf->b_signlist != NULL)
587 {
588 // List of signs placed in this buffer
589 list_T *signs = list_alloc();
590 if (signs != NULL)
591 {
592 get_buffer_signs(buf, signs);
593 dict_add_list(dict, "signs", signs);
594 }
595 }
596#endif
597
Bram Moolenaar52410572019-10-27 05:12:45 +0100598#ifdef FEAT_VIMINFO
599 dict_add_number(dict, "lastused", buf->b_last_used);
600#endif
601
Bram Moolenaar261f3462019-09-07 15:45:32 +0200602 return dict;
603}
604
605/*
606 * "getbufinfo()" function
607 */
608 void
609f_getbufinfo(typval_T *argvars, typval_T *rettv)
610{
611 buf_T *buf = NULL;
612 buf_T *argbuf = NULL;
613 dict_T *d;
614 int filtered = FALSE;
615 int sel_buflisted = FALSE;
616 int sel_bufloaded = FALSE;
617 int sel_bufmodified = FALSE;
618
619 if (rettv_list_alloc(rettv) != OK)
620 return;
621
622 // List of all the buffers or selected buffers
623 if (argvars[0].v_type == VAR_DICT)
624 {
625 dict_T *sel_d = argvars[0].vval.v_dict;
626
627 if (sel_d != NULL)
628 {
629 dictitem_T *di;
630
631 filtered = TRUE;
632
633 di = dict_find(sel_d, (char_u *)"buflisted", -1);
634 if (di != NULL && tv_get_number(&di->di_tv))
635 sel_buflisted = TRUE;
636
637 di = dict_find(sel_d, (char_u *)"bufloaded", -1);
638 if (di != NULL && tv_get_number(&di->di_tv))
639 sel_bufloaded = TRUE;
640
641 di = dict_find(sel_d, (char_u *)"bufmodified", -1);
642 if (di != NULL && tv_get_number(&di->di_tv))
643 sel_bufmodified = TRUE;
644 }
645 }
646 else if (argvars[0].v_type != VAR_UNKNOWN)
647 {
648 // Information about one buffer. Argument specifies the buffer
649 (void)tv_get_number(&argvars[0]); // issue errmsg if type error
650 ++emsg_off;
651 argbuf = tv_get_buf(&argvars[0], FALSE);
652 --emsg_off;
653 if (argbuf == NULL)
654 return;
655 }
656
657 // Return information about all the buffers or a specified buffer
658 FOR_ALL_BUFFERS(buf)
659 {
660 if (argbuf != NULL && argbuf != buf)
661 continue;
662 if (filtered && ((sel_bufloaded && buf->b_ml.ml_mfp == NULL)
663 || (sel_buflisted && !buf->b_p_bl)
664 || (sel_bufmodified && !buf->b_changed)))
665 continue;
666
667 d = get_buffer_info(buf);
668 if (d != NULL)
669 list_append_dict(rettv->vval.v_list, d);
670 if (argbuf != NULL)
671 return;
672 }
673}
674
675/*
676 * Get line or list of lines from buffer "buf" into "rettv".
677 * Return a range (from start to end) of lines in rettv from the specified
678 * buffer.
679 * If 'retlist' is TRUE, then the lines are returned as a Vim List.
680 */
681 static void
682get_buffer_lines(
683 buf_T *buf,
684 linenr_T start,
685 linenr_T end,
686 int retlist,
687 typval_T *rettv)
688{
689 char_u *p;
690
691 rettv->v_type = VAR_STRING;
692 rettv->vval.v_string = NULL;
693 if (retlist && rettv_list_alloc(rettv) == FAIL)
694 return;
695
696 if (buf == NULL || buf->b_ml.ml_mfp == NULL || start < 0)
697 return;
698
699 if (!retlist)
700 {
701 if (start >= 1 && start <= buf->b_ml.ml_line_count)
702 p = ml_get_buf(buf, start, FALSE);
703 else
704 p = (char_u *)"";
705 rettv->vval.v_string = vim_strsave(p);
706 }
707 else
708 {
709 if (end < start)
710 return;
711
712 if (start < 1)
713 start = 1;
714 if (end > buf->b_ml.ml_line_count)
715 end = buf->b_ml.ml_line_count;
716 while (start <= end)
717 if (list_append_string(rettv->vval.v_list,
718 ml_get_buf(buf, start++, FALSE), -1) == FAIL)
719 break;
720 }
721}
722
723/*
724 * "getbufline()" function
725 */
726 void
727f_getbufline(typval_T *argvars, typval_T *rettv)
728{
729 linenr_T lnum;
730 linenr_T end;
731 buf_T *buf;
732
733 (void)tv_get_number(&argvars[0]); // issue errmsg if type error
734 ++emsg_off;
735 buf = tv_get_buf(&argvars[0], FALSE);
736 --emsg_off;
737
738 lnum = tv_get_lnum_buf(&argvars[1], buf);
739 if (argvars[2].v_type == VAR_UNKNOWN)
740 end = lnum;
741 else
742 end = tv_get_lnum_buf(&argvars[2], buf);
743
744 get_buffer_lines(buf, lnum, end, TRUE, rettv);
745}
746
747/*
748 * "getline(lnum, [end])" function
749 */
750 void
751f_getline(typval_T *argvars, typval_T *rettv)
752{
753 linenr_T lnum;
754 linenr_T end;
755 int retlist;
756
757 lnum = tv_get_lnum(argvars);
758 if (argvars[1].v_type == VAR_UNKNOWN)
759 {
760 end = 0;
761 retlist = FALSE;
762 }
763 else
764 {
765 end = tv_get_lnum(&argvars[1]);
766 retlist = TRUE;
767 }
768
769 get_buffer_lines(curbuf, lnum, end, retlist, rettv);
770}
771
772/*
773 * "setbufline()" function
774 */
775 void
776f_setbufline(typval_T *argvars, typval_T *rettv)
777{
778 linenr_T lnum;
779 buf_T *buf;
780
781 buf = tv_get_buf(&argvars[0], FALSE);
782 if (buf == NULL)
783 rettv->vval.v_number = 1; // FAIL
784 else
785 {
786 lnum = tv_get_lnum_buf(&argvars[1], buf);
787 set_buffer_lines(buf, lnum, FALSE, &argvars[2], rettv);
788 }
789}
790
791/*
792 * "setline()" function
793 */
794 void
795f_setline(typval_T *argvars, typval_T *rettv)
796{
797 linenr_T lnum = tv_get_lnum(&argvars[0]);
798
799 set_buffer_lines(curbuf, lnum, FALSE, &argvars[1], rettv);
800}
801#endif // FEAT_EVAL
802
803#if defined(FEAT_JOB_CHANNEL) \
804 || defined(FEAT_PYTHON) || defined(FEAT_PYTHON3) \
805 || defined(PROTO)
806/*
807 * Make "buf" the current buffer. restore_buffer() MUST be called to undo.
808 * No autocommands will be executed. Use aucmd_prepbuf() if there are any.
809 */
810 void
811switch_buffer(bufref_T *save_curbuf, buf_T *buf)
812{
813 block_autocmds();
814 set_bufref(save_curbuf, curbuf);
815 --curbuf->b_nwindows;
816 curbuf = buf;
817 curwin->w_buffer = buf;
818 ++curbuf->b_nwindows;
819}
820
821/*
822 * Restore the current buffer after using switch_buffer().
823 */
824 void
825restore_buffer(bufref_T *save_curbuf)
826{
827 unblock_autocmds();
828 /* Check for valid buffer, just in case. */
829 if (bufref_valid(save_curbuf))
830 {
831 --curbuf->b_nwindows;
832 curwin->w_buffer = save_curbuf->br_buf;
833 curbuf = save_curbuf->br_buf;
834 ++curbuf->b_nwindows;
835 }
836}
837
838/*
839 * Find a window for buffer "buf".
840 * If found OK is returned and "wp" and "tp" are set to the window and tabpage.
841 * If not found FAIL is returned.
842 */
843 static int
844find_win_for_buf(
845 buf_T *buf,
846 win_T **wp,
847 tabpage_T **tp)
848{
849 FOR_ALL_TAB_WINDOWS(*tp, *wp)
850 if ((*wp)->w_buffer == buf)
851 return OK;
852 return FAIL;
853}
854
855/*
856 * Find a window that contains "buf" and switch to it.
857 * If there is no such window, use the current window and change "curbuf".
858 * Caller must initialize save_curbuf to NULL.
859 * restore_win_for_buf() MUST be called later!
860 */
861 void
862switch_to_win_for_buf(
863 buf_T *buf,
864 win_T **save_curwinp,
865 tabpage_T **save_curtabp,
866 bufref_T *save_curbuf)
867{
868 win_T *wp;
869 tabpage_T *tp;
870
871 if (find_win_for_buf(buf, &wp, &tp) == FAIL)
872 switch_buffer(save_curbuf, buf);
873 else if (switch_win(save_curwinp, save_curtabp, wp, tp, TRUE) == FAIL)
874 {
875 restore_win(*save_curwinp, *save_curtabp, TRUE);
876 switch_buffer(save_curbuf, buf);
877 }
878}
879
880 void
881restore_win_for_buf(
882 win_T *save_curwin,
883 tabpage_T *save_curtab,
884 bufref_T *save_curbuf)
885{
886 if (save_curbuf->br_buf == NULL)
887 restore_win(save_curwin, save_curtab, TRUE);
888 else
889 restore_buffer(save_curbuf);
890}
891#endif