xref: /vim-8.2.3635/src/evalwindow.c (revision be7529e8)
1 /* 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  * evalwindow.c: Window related builtin functions
12  */
13 
14 #include "vim.h"
15 
16 #if defined(FEAT_EVAL) || defined(PROTO)
17 
18     static int
19 win_getid(typval_T *argvars)
20 {
21     int	    winnr;
22     win_T   *wp;
23 
24     if (argvars[0].v_type == VAR_UNKNOWN)
25 	return curwin->w_id;
26     winnr = tv_get_number(&argvars[0]);
27     if (winnr > 0)
28     {
29 	if (argvars[1].v_type == VAR_UNKNOWN)
30 	    wp = firstwin;
31 	else
32 	{
33 	    tabpage_T	*tp;
34 	    int		tabnr = tv_get_number(&argvars[1]);
35 
36 	    FOR_ALL_TABPAGES(tp)
37 		if (--tabnr == 0)
38 		    break;
39 	    if (tp == NULL)
40 		return -1;
41 	    if (tp == curtab)
42 		wp = firstwin;
43 	    else
44 		wp = tp->tp_firstwin;
45 	}
46 	for ( ; wp != NULL; wp = wp->w_next)
47 	    if (--winnr == 0)
48 		return wp->w_id;
49     }
50     return 0;
51 }
52 
53     static void
54 win_id2tabwin(typval_T *argvars, list_T *list)
55 {
56     win_T	*wp;
57     tabpage_T   *tp;
58     int		winnr = 1;
59     int		tabnr = 1;
60     int		id = tv_get_number(&argvars[0]);
61 
62     FOR_ALL_TABPAGES(tp)
63     {
64 	FOR_ALL_WINDOWS_IN_TAB(tp, wp)
65 	{
66 	    if (wp->w_id == id)
67 	    {
68 		list_append_number(list, tabnr);
69 		list_append_number(list, winnr);
70 		return;
71 	    }
72 	    ++winnr;
73 	}
74 	++tabnr;
75 	winnr = 1;
76     }
77     list_append_number(list, 0);
78     list_append_number(list, 0);
79 }
80 
81 /*
82  * Return the window pointer of window "id".
83  */
84     win_T *
85 win_id2wp(int id)
86 {
87     return win_id2wp_tp(id, NULL);
88 }
89 
90 /*
91  * Return the window and tab pointer of window "id".
92  */
93     win_T *
94 win_id2wp_tp(int id, tabpage_T **tpp)
95 {
96     win_T	*wp;
97     tabpage_T   *tp;
98 
99     FOR_ALL_TAB_WINDOWS(tp, wp)
100 	if (wp->w_id == id)
101 	{
102 	    if (tpp != NULL)
103 		*tpp = tp;
104 	    return wp;
105 	}
106 #ifdef FEAT_PROP_POPUP
107     // popup windows are in separate lists
108      FOR_ALL_TABPAGES(tp)
109 	 FOR_ALL_POPUPWINS_IN_TAB(tp, wp)
110 	     if (wp->w_id == id)
111 	     {
112 		 if (tpp != NULL)
113 		     *tpp = tp;
114 		 return wp;
115 	     }
116     FOR_ALL_POPUPWINS(wp)
117 	if (wp->w_id == id)
118 	{
119 	    if (tpp != NULL)
120 		*tpp = tp;
121 	    return wp;
122 	}
123 #endif
124 
125     return NULL;
126 }
127 
128     static int
129 win_id2win(typval_T *argvars)
130 {
131     win_T   *wp;
132     int	    nr = 1;
133     int	    id = tv_get_number(&argvars[0]);
134 
135     FOR_ALL_WINDOWS(wp)
136     {
137 	if (wp->w_id == id)
138 	    return nr;
139 	++nr;
140     }
141     return 0;
142 }
143 
144     void
145 win_findbuf(typval_T *argvars, list_T *list)
146 {
147     win_T	*wp;
148     tabpage_T   *tp;
149     int		bufnr = tv_get_number(&argvars[0]);
150 
151     FOR_ALL_TAB_WINDOWS(tp, wp)
152 	    if (wp->w_buffer->b_fnum == bufnr)
153 		list_append_number(list, wp->w_id);
154 }
155 
156 /*
157  * Find window specified by "vp" in tabpage "tp".
158  */
159     win_T *
160 find_win_by_nr(
161     typval_T	*vp,
162     tabpage_T	*tp)	// NULL for current tab page
163 {
164     win_T	*wp;
165     int		nr = (int)tv_get_number_chk(vp, NULL);
166 
167     if (nr < 0)
168 	return NULL;
169     if (nr == 0)
170 	return curwin;
171 
172     FOR_ALL_WINDOWS_IN_TAB(tp, wp)
173     {
174 	if (nr >= LOWEST_WIN_ID)
175 	{
176 	    if (wp->w_id == nr)
177 		return wp;
178 	}
179 	else if (--nr <= 0)
180 	    break;
181     }
182     if (nr >= LOWEST_WIN_ID)
183     {
184 #ifdef FEAT_PROP_POPUP
185 	// check tab-local popup windows
186 	for (wp = (tp == NULL ? curtab : tp)->tp_first_popupwin;
187 						   wp != NULL; wp = wp->w_next)
188 	    if (wp->w_id == nr)
189 		return wp;
190 	// check global popup windows
191 	FOR_ALL_POPUPWINS(wp)
192 	    if (wp->w_id == nr)
193 		return wp;
194 #endif
195 	return NULL;
196     }
197     return wp;
198 }
199 
200 /*
201  * Find a window: When using a Window ID in any tab page, when using a number
202  * in the current tab page.
203  * Returns NULL when not found.
204  */
205     win_T *
206 find_win_by_nr_or_id(typval_T *vp)
207 {
208     int	nr = (int)tv_get_number_chk(vp, NULL);
209 
210     if (nr >= LOWEST_WIN_ID)
211 	return win_id2wp(tv_get_number(vp));
212     return find_win_by_nr(vp, NULL);
213 }
214 
215 /*
216  * Find window specified by "wvp" in tabpage "tvp".
217  * Returns the tab page in 'ptp'
218  */
219     win_T *
220 find_tabwin(
221     typval_T	*wvp,	// VAR_UNKNOWN for current window
222     typval_T	*tvp,	// VAR_UNKNOWN for current tab page
223     tabpage_T	**ptp)
224 {
225     win_T	*wp = NULL;
226     tabpage_T	*tp = NULL;
227     long	n;
228 
229     if (wvp->v_type != VAR_UNKNOWN)
230     {
231 	if (tvp->v_type != VAR_UNKNOWN)
232 	{
233 	    n = (long)tv_get_number(tvp);
234 	    if (n >= 0)
235 		tp = find_tabpage(n);
236 	}
237 	else
238 	    tp = curtab;
239 
240 	if (tp != NULL)
241 	{
242 	    wp = find_win_by_nr(wvp, tp);
243 	    if (wp == NULL && wvp->v_type == VAR_NUMBER
244 						&& wvp->vval.v_number != -1)
245 		// A window with the specified number is not found
246 		tp = NULL;
247 	}
248     }
249     else
250     {
251 	wp = curwin;
252 	tp = curtab;
253     }
254 
255     if (ptp != NULL)
256 	*ptp = tp;
257 
258     return wp;
259 }
260 
261 /*
262  * Get the layout of the given tab page for winlayout().
263  */
264     static void
265 get_framelayout(frame_T *fr, list_T *l, int outer)
266 {
267     frame_T	*child;
268     list_T	*fr_list;
269     list_T	*win_list;
270 
271     if (fr == NULL)
272 	return;
273 
274     if (outer)
275 	// outermost call from f_winlayout()
276 	fr_list = l;
277     else
278     {
279 	fr_list = list_alloc();
280 	if (fr_list == NULL)
281 	    return;
282 	list_append_list(l, fr_list);
283     }
284 
285     if (fr->fr_layout == FR_LEAF)
286     {
287 	if (fr->fr_win != NULL)
288 	{
289 	    list_append_string(fr_list, (char_u *)"leaf", -1);
290 	    list_append_number(fr_list, fr->fr_win->w_id);
291 	}
292     }
293     else
294     {
295 	list_append_string(fr_list,
296 	     fr->fr_layout == FR_ROW ?  (char_u *)"row" : (char_u *)"col", -1);
297 
298 	win_list = list_alloc();
299 	if (win_list == NULL)
300 	    return;
301 	list_append_list(fr_list, win_list);
302 	child = fr->fr_child;
303 	while (child != NULL)
304 	{
305 	    get_framelayout(child, win_list, FALSE);
306 	    child = child->fr_next;
307 	}
308     }
309 }
310 
311 /*
312  * Common code for tabpagewinnr() and winnr().
313  */
314     static int
315 get_winnr(tabpage_T *tp, typval_T *argvar)
316 {
317     win_T	*twin;
318     int		nr = 1;
319     win_T	*wp;
320     char_u	*arg;
321 
322     twin = (tp == curtab) ? curwin : tp->tp_curwin;
323     if (argvar->v_type != VAR_UNKNOWN)
324     {
325 	int	invalid_arg = FALSE;
326 
327 	arg = tv_get_string_chk(argvar);
328 	if (arg == NULL)
329 	    nr = 0;		// type error; errmsg already given
330 	else if (STRCMP(arg, "$") == 0)
331 	    twin = (tp == curtab) ? lastwin : tp->tp_lastwin;
332 	else if (STRCMP(arg, "#") == 0)
333 	{
334 	    twin = (tp == curtab) ? prevwin : tp->tp_prevwin;
335 	}
336 	else
337 	{
338 	    long	count;
339 	    char_u	*endp;
340 
341 	    // Extract the window count (if specified). e.g. winnr('3j')
342 	    count = strtol((char *)arg, (char **)&endp, 10);
343 	    if (count <= 0)
344 		count = 1;	// if count is not specified, default to 1
345 	    if (endp != NULL && *endp != '\0')
346 	    {
347 		if (STRCMP(endp, "j") == 0)
348 		    twin = win_vert_neighbor(tp, twin, FALSE, count);
349 		else if (STRCMP(endp, "k") == 0)
350 		    twin = win_vert_neighbor(tp, twin, TRUE, count);
351 		else if (STRCMP(endp, "h") == 0)
352 		    twin = win_horz_neighbor(tp, twin, TRUE, count);
353 		else if (STRCMP(endp, "l") == 0)
354 		    twin = win_horz_neighbor(tp, twin, FALSE, count);
355 		else
356 		    invalid_arg = TRUE;
357 	    }
358 	    else
359 		invalid_arg = TRUE;
360 	}
361 	if (twin == NULL)
362 	    nr = 0;
363 
364 	if (invalid_arg)
365 	{
366 	    semsg(_(e_invexpr2), arg);
367 	    nr = 0;
368 	}
369     }
370 
371     if (nr > 0)
372 	for (wp = (tp == curtab) ? firstwin : tp->tp_firstwin;
373 					      wp != twin; wp = wp->w_next)
374 	{
375 	    if (wp == NULL)
376 	    {
377 		// didn't find it in this tabpage
378 		nr = 0;
379 		break;
380 	    }
381 	    ++nr;
382 	}
383     return nr;
384 }
385 
386 /*
387  * Returns information about a window as a dictionary.
388  */
389     static dict_T *
390 get_win_info(win_T *wp, short tpnr, short winnr)
391 {
392     dict_T	*dict;
393 
394     dict = dict_alloc();
395     if (dict == NULL)
396 	return NULL;
397 
398     dict_add_number(dict, "tabnr", tpnr);
399     dict_add_number(dict, "winnr", winnr);
400     dict_add_number(dict, "winid", wp->w_id);
401     dict_add_number(dict, "height", wp->w_height);
402     dict_add_number(dict, "winrow", wp->w_winrow + 1);
403     dict_add_number(dict, "topline", wp->w_topline);
404     dict_add_number(dict, "botline", wp->w_botline - 1);
405 #ifdef FEAT_MENU
406     dict_add_number(dict, "winbar", wp->w_winbar_height);
407 #endif
408     dict_add_number(dict, "width", wp->w_width);
409     dict_add_number(dict, "wincol", wp->w_wincol + 1);
410     dict_add_number(dict, "bufnr", wp->w_buffer->b_fnum);
411 
412 #ifdef FEAT_TERMINAL
413     dict_add_number(dict, "terminal", bt_terminal(wp->w_buffer));
414 #endif
415 #ifdef FEAT_QUICKFIX
416     dict_add_number(dict, "quickfix", bt_quickfix(wp->w_buffer));
417     dict_add_number(dict, "loclist",
418 		      (bt_quickfix(wp->w_buffer) && wp->w_llist_ref != NULL));
419 #endif
420 
421     // Add a reference to window variables
422     dict_add_dict(dict, "variables", wp->w_vars);
423 
424     return dict;
425 }
426 
427 /*
428  * Returns information (variables, options, etc.) about a tab page
429  * as a dictionary.
430  */
431     static dict_T *
432 get_tabpage_info(tabpage_T *tp, int tp_idx)
433 {
434     win_T	*wp;
435     dict_T	*dict;
436     list_T	*l;
437 
438     dict = dict_alloc();
439     if (dict == NULL)
440 	return NULL;
441 
442     dict_add_number(dict, "tabnr", tp_idx);
443 
444     l = list_alloc();
445     if (l != NULL)
446     {
447 	FOR_ALL_WINDOWS_IN_TAB(tp, wp)
448 	    list_append_number(l, (varnumber_T)wp->w_id);
449 	dict_add_list(dict, "windows", l);
450     }
451 
452     // Make a reference to tabpage variables
453     dict_add_dict(dict, "variables", tp->tp_vars);
454 
455     return dict;
456 }
457 
458 /*
459  * "gettabinfo()" function
460  */
461     void
462 f_gettabinfo(typval_T *argvars, typval_T *rettv)
463 {
464     tabpage_T	*tp, *tparg = NULL;
465     dict_T	*d;
466     int		tpnr = 0;
467 
468     if (rettv_list_alloc(rettv) != OK)
469 	return;
470 
471     if (argvars[0].v_type != VAR_UNKNOWN)
472     {
473 	// Information about one tab page
474 	tparg = find_tabpage((int)tv_get_number_chk(&argvars[0], NULL));
475 	if (tparg == NULL)
476 	    return;
477     }
478 
479     // Get information about a specific tab page or all tab pages
480     FOR_ALL_TABPAGES(tp)
481     {
482 	tpnr++;
483 	if (tparg != NULL && tp != tparg)
484 	    continue;
485 	d = get_tabpage_info(tp, tpnr);
486 	if (d != NULL)
487 	    list_append_dict(rettv->vval.v_list, d);
488 	if (tparg != NULL)
489 	    return;
490     }
491 }
492 
493 /*
494  * "getwininfo()" function
495  */
496     void
497 f_getwininfo(typval_T *argvars, typval_T *rettv)
498 {
499     tabpage_T	*tp;
500     win_T	*wp = NULL, *wparg = NULL;
501     dict_T	*d;
502     short	tabnr = 0, winnr;
503 
504     if (rettv_list_alloc(rettv) != OK)
505 	return;
506 
507     if (argvars[0].v_type != VAR_UNKNOWN)
508     {
509 	wparg = win_id2wp(tv_get_number(&argvars[0]));
510 	if (wparg == NULL)
511 	    return;
512     }
513 
514     // Collect information about either all the windows across all the tab
515     // pages or one particular window.
516     FOR_ALL_TABPAGES(tp)
517     {
518 	tabnr++;
519 	winnr = 0;
520 	FOR_ALL_WINDOWS_IN_TAB(tp, wp)
521 	{
522 	    winnr++;
523 	    if (wparg != NULL && wp != wparg)
524 		continue;
525 	    d = get_win_info(wp, tabnr, winnr);
526 	    if (d != NULL)
527 		list_append_dict(rettv->vval.v_list, d);
528 	    if (wparg != NULL)
529 		// found information about a specific window
530 		return;
531 	}
532     }
533 }
534 
535 /*
536  * "getwinpos({timeout})" function
537  */
538     void
539 f_getwinpos(typval_T *argvars UNUSED, typval_T *rettv)
540 {
541     int x = -1;
542     int y = -1;
543 
544     if (rettv_list_alloc(rettv) == FAIL)
545 	return;
546 #if defined(FEAT_GUI) \
547 	|| (defined(HAVE_TGETENT) && defined(FEAT_TERMRESPONSE)) \
548 	|| defined(MSWIN)
549     {
550 	varnumber_T timeout = 100;
551 
552 	if (argvars[0].v_type != VAR_UNKNOWN)
553 	    timeout = tv_get_number(&argvars[0]);
554 
555 	(void)ui_get_winpos(&x, &y, timeout);
556     }
557 #endif
558     list_append_number(rettv->vval.v_list, (varnumber_T)x);
559     list_append_number(rettv->vval.v_list, (varnumber_T)y);
560 }
561 
562 
563 /*
564  * "getwinposx()" function
565  */
566     void
567 f_getwinposx(typval_T *argvars UNUSED, typval_T *rettv)
568 {
569     rettv->vval.v_number = -1;
570 #if defined(FEAT_GUI) \
571 	|| (defined(HAVE_TGETENT) && defined(FEAT_TERMRESPONSE)) \
572 	|| defined(MSWIN)
573 
574     {
575 	int	    x, y;
576 
577 	if (ui_get_winpos(&x, &y, 100) == OK)
578 	    rettv->vval.v_number = x;
579     }
580 #endif
581 }
582 
583 /*
584  * "getwinposy()" function
585  */
586     void
587 f_getwinposy(typval_T *argvars UNUSED, typval_T *rettv)
588 {
589     rettv->vval.v_number = -1;
590 #if defined(FEAT_GUI) \
591 	|| (defined(HAVE_TGETENT) && defined(FEAT_TERMRESPONSE)) \
592 	|| defined(MSWIN)
593     {
594 	int	    x, y;
595 
596 	if (ui_get_winpos(&x, &y, 100) == OK)
597 	    rettv->vval.v_number = y;
598     }
599 #endif
600 }
601 
602 /*
603  * "tabpagenr()" function
604  */
605     void
606 f_tabpagenr(typval_T *argvars UNUSED, typval_T *rettv)
607 {
608     int		nr = 1;
609     char_u	*arg;
610 
611     if (argvars[0].v_type != VAR_UNKNOWN)
612     {
613 	arg = tv_get_string_chk(&argvars[0]);
614 	nr = 0;
615 	if (arg != NULL)
616 	{
617 	    if (STRCMP(arg, "$") == 0)
618 		nr = tabpage_index(NULL) - 1;
619 	    else if (STRCMP(arg, "#") == 0)
620 		nr = valid_tabpage(lastused_tabpage) ?
621 					tabpage_index(lastused_tabpage) : 0;
622 	    else
623 		semsg(_(e_invexpr2), arg);
624 	}
625     }
626     else
627 	nr = tabpage_index(curtab);
628     rettv->vval.v_number = nr;
629 }
630 
631 /*
632  * "tabpagewinnr()" function
633  */
634     void
635 f_tabpagewinnr(typval_T *argvars UNUSED, typval_T *rettv)
636 {
637     int		nr = 1;
638     tabpage_T	*tp;
639 
640     tp = find_tabpage((int)tv_get_number(&argvars[0]));
641     if (tp == NULL)
642 	nr = 0;
643     else
644 	nr = get_winnr(tp, &argvars[1]);
645     rettv->vval.v_number = nr;
646 }
647 
648 /*
649  * "win_execute()" function
650  */
651     void
652 f_win_execute(typval_T *argvars, typval_T *rettv)
653 {
654     int		id = (int)tv_get_number(argvars);
655     tabpage_T	*tp;
656     win_T	*wp = win_id2wp_tp(id, &tp);
657     win_T	*save_curwin;
658     tabpage_T	*save_curtab;
659 
660     if (wp != NULL && tp != NULL)
661     {
662 	pos_T	curpos = wp->w_cursor;
663 
664 	if (switch_win_noblock(&save_curwin, &save_curtab, wp, tp, TRUE) == OK)
665 	{
666 	    check_cursor();
667 	    execute_common(argvars, rettv, 1);
668 	}
669 	restore_win_noblock(save_curwin, save_curtab, TRUE);
670 
671 	// Update the status line if the cursor moved.
672 	if (win_valid(wp) && !EQUAL_POS(curpos, wp->w_cursor))
673 	    wp->w_redr_status = TRUE;
674     }
675 }
676 
677 /*
678  * "win_findbuf()" function
679  */
680     void
681 f_win_findbuf(typval_T *argvars, typval_T *rettv)
682 {
683     if (rettv_list_alloc(rettv) != FAIL)
684 	win_findbuf(argvars, rettv->vval.v_list);
685 }
686 
687 /*
688  * "win_getid()" function
689  */
690     void
691 f_win_getid(typval_T *argvars, typval_T *rettv)
692 {
693     rettv->vval.v_number = win_getid(argvars);
694 }
695 
696 /*
697  * "win_gotoid()" function
698  */
699     void
700 f_win_gotoid(typval_T *argvars, typval_T *rettv)
701 {
702     win_T	*wp;
703     tabpage_T   *tp;
704     int		id = tv_get_number(&argvars[0]);
705 
706 #ifdef FEAT_CMDWIN
707     if (cmdwin_type != 0)
708     {
709 	emsg(_(e_cmdwin));
710 	return;
711     }
712 #endif
713     FOR_ALL_TAB_WINDOWS(tp, wp)
714 	if (wp->w_id == id)
715 	{
716 	    goto_tabpage_win(tp, wp);
717 	    rettv->vval.v_number = 1;
718 	    return;
719 	}
720 }
721 
722 /*
723  * "win_id2tabwin()" function
724  */
725     void
726 f_win_id2tabwin(typval_T *argvars, typval_T *rettv)
727 {
728     if (rettv_list_alloc(rettv) != FAIL)
729 	win_id2tabwin(argvars, rettv->vval.v_list);
730 }
731 
732 /*
733  * "win_id2win()" function
734  */
735     void
736 f_win_id2win(typval_T *argvars, typval_T *rettv)
737 {
738     rettv->vval.v_number = win_id2win(argvars);
739 }
740 
741 /*
742  * "win_screenpos()" function
743  */
744     void
745 f_win_screenpos(typval_T *argvars, typval_T *rettv)
746 {
747     win_T	*wp;
748 
749     if (rettv_list_alloc(rettv) == FAIL)
750 	return;
751 
752     wp = find_win_by_nr_or_id(&argvars[0]);
753     list_append_number(rettv->vval.v_list, wp == NULL ? 0 : wp->w_winrow + 1);
754     list_append_number(rettv->vval.v_list, wp == NULL ? 0 : wp->w_wincol + 1);
755 }
756 
757 /*
758  * Move the window wp into a new split of targetwin in a given direction
759  */
760     static void
761 win_move_into_split(win_T *wp, win_T *targetwin, int size, int flags)
762 {
763     int	    dir;
764     int	    height = wp->w_height;
765     win_T   *oldwin = curwin;
766 
767     if (wp == targetwin)
768 	return;
769 
770     // Jump to the target window
771     if (curwin != targetwin)
772 	win_goto(targetwin);
773 
774     // Remove the old window and frame from the tree of frames
775     (void)winframe_remove(wp, &dir, NULL);
776     win_remove(wp, NULL);
777     last_status(FALSE);	    // may need to remove last status line
778     (void)win_comp_pos();   // recompute window positions
779 
780     // Split a window on the desired side and put the old window there
781     (void)win_split_ins(size, flags, wp, dir);
782 
783     // If splitting horizontally, try to preserve height
784     if (size == 0 && !(flags & WSP_VERT))
785     {
786 	win_setheight_win(height, wp);
787 	if (p_ea)
788 	    win_equal(wp, TRUE, 'v');
789     }
790 
791 #if defined(FEAT_GUI)
792     // When 'guioptions' includes 'L' or 'R' may have to remove or add
793     // scrollbars.  Have to update them anyway.
794     gui_may_update_scrollbars();
795 #endif
796 
797     if (oldwin != curwin)
798 	win_goto(oldwin);
799 }
800 
801 /*
802  * "win_splitmove()" function
803  */
804     void
805 f_win_splitmove(typval_T *argvars, typval_T *rettv)
806 {
807     win_T   *wp;
808     win_T   *targetwin;
809     int     flags = 0, size = 0;
810 
811     wp = find_win_by_nr_or_id(&argvars[0]);
812     targetwin = find_win_by_nr_or_id(&argvars[1]);
813 
814     if (wp == NULL || targetwin == NULL || wp == targetwin
815 	    || !win_valid(wp) || !win_valid(targetwin)
816 	    || win_valid_popup(wp) || win_valid_popup(targetwin))
817     {
818         emsg(_(e_invalwindow));
819 	rettv->vval.v_number = -1;
820 	return;
821     }
822 
823     if (argvars[2].v_type != VAR_UNKNOWN)
824     {
825         dict_T      *d;
826         dictitem_T  *di;
827 
828         if (argvars[2].v_type != VAR_DICT || argvars[2].vval.v_dict == NULL)
829         {
830             emsg(_(e_invarg));
831             return;
832         }
833 
834         d = argvars[2].vval.v_dict;
835         if (dict_get_number(d, (char_u *)"vertical"))
836             flags |= WSP_VERT;
837         if ((di = dict_find(d, (char_u *)"rightbelow", -1)) != NULL)
838             flags |= tv_get_number(&di->di_tv) ? WSP_BELOW : WSP_ABOVE;
839         size = (int)dict_get_number(d, (char_u *)"size");
840     }
841 
842     win_move_into_split(wp, targetwin, size, flags);
843 }
844 
845 /*
846  * "win_gettype(nr)" function
847  */
848     void
849 f_win_gettype(typval_T *argvars, typval_T *rettv)
850 {
851     win_T	*wp = curwin;
852 
853     rettv->v_type = VAR_STRING;
854     rettv->vval.v_string = NULL;
855     if (argvars[0].v_type != VAR_UNKNOWN)
856     {
857 	wp = find_win_by_nr_or_id(&argvars[0]);
858 	if (wp == NULL)
859 	{
860 	    rettv->vval.v_string = vim_strsave((char_u *)"unknown");
861 	    return;
862 	}
863     }
864     if (wp == aucmd_win)
865 	rettv->vval.v_string = vim_strsave((char_u *)"autocmd");
866 #if defined(FEAT_QUICKFIX)
867     else if (wp->w_p_pvw)
868 	rettv->vval.v_string = vim_strsave((char_u *)"preview");
869 #endif
870 #ifdef FEAT_PROP_POPUP
871     else if (WIN_IS_POPUP(wp))
872 	rettv->vval.v_string = vim_strsave((char_u *)"popup");
873 #endif
874 #ifdef FEAT_CMDWIN
875     else if (wp == curwin && cmdwin_type != 0)
876 	rettv->vval.v_string = vim_strsave((char_u *)"command");
877 #endif
878 }
879 
880 /*
881  * "getcmdwintype()" function
882  */
883     void
884 f_getcmdwintype(typval_T *argvars UNUSED, typval_T *rettv)
885 {
886     rettv->v_type = VAR_STRING;
887     rettv->vval.v_string = NULL;
888 #ifdef FEAT_CMDWIN
889     rettv->vval.v_string = alloc(2);
890     if (rettv->vval.v_string != NULL)
891     {
892 	rettv->vval.v_string[0] = cmdwin_type;
893 	rettv->vval.v_string[1] = NUL;
894     }
895 #endif
896 }
897 
898 /*
899  * "winbufnr(nr)" function
900  */
901     void
902 f_winbufnr(typval_T *argvars, typval_T *rettv)
903 {
904     win_T	*wp;
905 
906     wp = find_win_by_nr_or_id(&argvars[0]);
907     if (wp == NULL)
908 	rettv->vval.v_number = -1;
909     else
910 	rettv->vval.v_number = wp->w_buffer->b_fnum;
911 }
912 
913 /*
914  * "wincol()" function
915  */
916     void
917 f_wincol(typval_T *argvars UNUSED, typval_T *rettv)
918 {
919     validate_cursor();
920     rettv->vval.v_number = curwin->w_wcol + 1;
921 }
922 
923 /*
924  * "winheight(nr)" function
925  */
926     void
927 f_winheight(typval_T *argvars, typval_T *rettv)
928 {
929     win_T	*wp;
930 
931     wp = find_win_by_nr_or_id(&argvars[0]);
932     if (wp == NULL)
933 	rettv->vval.v_number = -1;
934     else
935 	rettv->vval.v_number = wp->w_height;
936 }
937 
938 /*
939  * "winlayout()" function
940  */
941     void
942 f_winlayout(typval_T *argvars, typval_T *rettv)
943 {
944     tabpage_T	*tp;
945 
946     if (rettv_list_alloc(rettv) != OK)
947 	return;
948 
949     if (argvars[0].v_type == VAR_UNKNOWN)
950 	tp = curtab;
951     else
952     {
953 	tp = find_tabpage((int)tv_get_number(&argvars[0]));
954 	if (tp == NULL)
955 	    return;
956     }
957 
958     get_framelayout(tp->tp_topframe, rettv->vval.v_list, TRUE);
959 }
960 
961 /*
962  * "winline()" function
963  */
964     void
965 f_winline(typval_T *argvars UNUSED, typval_T *rettv)
966 {
967     validate_cursor();
968     rettv->vval.v_number = curwin->w_wrow + 1;
969 }
970 
971 /*
972  * "winnr()" function
973  */
974     void
975 f_winnr(typval_T *argvars UNUSED, typval_T *rettv)
976 {
977     int		nr = 1;
978 
979     nr = get_winnr(curtab, &argvars[0]);
980     rettv->vval.v_number = nr;
981 }
982 
983 /*
984  * "winrestcmd()" function
985  */
986     void
987 f_winrestcmd(typval_T *argvars UNUSED, typval_T *rettv)
988 {
989     win_T	*wp;
990     int		winnr = 1;
991     garray_T	ga;
992     char_u	buf[50];
993 
994     ga_init2(&ga, (int)sizeof(char), 70);
995     FOR_ALL_WINDOWS(wp)
996     {
997 	sprintf((char *)buf, "%dresize %d|", winnr, wp->w_height);
998 	ga_concat(&ga, buf);
999 	sprintf((char *)buf, "vert %dresize %d|", winnr, wp->w_width);
1000 	ga_concat(&ga, buf);
1001 	++winnr;
1002     }
1003     ga_append(&ga, NUL);
1004 
1005     rettv->vval.v_string = ga.ga_data;
1006     rettv->v_type = VAR_STRING;
1007 }
1008 
1009 /*
1010  * "winrestview()" function
1011  */
1012     void
1013 f_winrestview(typval_T *argvars, typval_T *rettv UNUSED)
1014 {
1015     dict_T	*dict;
1016 
1017     if (argvars[0].v_type != VAR_DICT
1018 	    || (dict = argvars[0].vval.v_dict) == NULL)
1019 	emsg(_(e_invarg));
1020     else
1021     {
1022 	if (dict_find(dict, (char_u *)"lnum", -1) != NULL)
1023 	    curwin->w_cursor.lnum = (linenr_T)dict_get_number(dict, (char_u *)"lnum");
1024 	if (dict_find(dict, (char_u *)"col", -1) != NULL)
1025 	    curwin->w_cursor.col = (colnr_T)dict_get_number(dict, (char_u *)"col");
1026 	if (dict_find(dict, (char_u *)"coladd", -1) != NULL)
1027 	    curwin->w_cursor.coladd = (colnr_T)dict_get_number(dict, (char_u *)"coladd");
1028 	if (dict_find(dict, (char_u *)"curswant", -1) != NULL)
1029 	{
1030 	    curwin->w_curswant = (colnr_T)dict_get_number(dict, (char_u *)"curswant");
1031 	    curwin->w_set_curswant = FALSE;
1032 	}
1033 
1034 	if (dict_find(dict, (char_u *)"topline", -1) != NULL)
1035 	    set_topline(curwin, (linenr_T)dict_get_number(dict, (char_u *)"topline"));
1036 #ifdef FEAT_DIFF
1037 	if (dict_find(dict, (char_u *)"topfill", -1) != NULL)
1038 	    curwin->w_topfill = (int)dict_get_number(dict, (char_u *)"topfill");
1039 #endif
1040 	if (dict_find(dict, (char_u *)"leftcol", -1) != NULL)
1041 	    curwin->w_leftcol = (colnr_T)dict_get_number(dict, (char_u *)"leftcol");
1042 	if (dict_find(dict, (char_u *)"skipcol", -1) != NULL)
1043 	    curwin->w_skipcol = (colnr_T)dict_get_number(dict, (char_u *)"skipcol");
1044 
1045 	check_cursor();
1046 	win_new_height(curwin, curwin->w_height);
1047 	win_new_width(curwin, curwin->w_width);
1048 	changed_window_setting();
1049 
1050 	if (curwin->w_topline <= 0)
1051 	    curwin->w_topline = 1;
1052 	if (curwin->w_topline > curbuf->b_ml.ml_line_count)
1053 	    curwin->w_topline = curbuf->b_ml.ml_line_count;
1054 #ifdef FEAT_DIFF
1055 	check_topfill(curwin, TRUE);
1056 #endif
1057     }
1058 }
1059 
1060 /*
1061  * "winsaveview()" function
1062  */
1063     void
1064 f_winsaveview(typval_T *argvars UNUSED, typval_T *rettv)
1065 {
1066     dict_T	*dict;
1067 
1068     if (rettv_dict_alloc(rettv) == FAIL)
1069 	return;
1070     dict = rettv->vval.v_dict;
1071 
1072     dict_add_number(dict, "lnum", (long)curwin->w_cursor.lnum);
1073     dict_add_number(dict, "col", (long)curwin->w_cursor.col);
1074     dict_add_number(dict, "coladd", (long)curwin->w_cursor.coladd);
1075     update_curswant();
1076     dict_add_number(dict, "curswant", (long)curwin->w_curswant);
1077 
1078     dict_add_number(dict, "topline", (long)curwin->w_topline);
1079 #ifdef FEAT_DIFF
1080     dict_add_number(dict, "topfill", (long)curwin->w_topfill);
1081 #endif
1082     dict_add_number(dict, "leftcol", (long)curwin->w_leftcol);
1083     dict_add_number(dict, "skipcol", (long)curwin->w_skipcol);
1084 }
1085 
1086 /*
1087  * "winwidth(nr)" function
1088  */
1089     void
1090 f_winwidth(typval_T *argvars, typval_T *rettv)
1091 {
1092     win_T	*wp;
1093 
1094     wp = find_win_by_nr_or_id(&argvars[0]);
1095     if (wp == NULL)
1096 	rettv->vval.v_number = -1;
1097     else
1098 	rettv->vval.v_number = wp->w_width;
1099 }
1100 #endif // FEAT_EVAL
1101 
1102 #if defined(FEAT_EVAL) || defined(FEAT_PYTHON) || defined(FEAT_PYTHON3) \
1103 	|| defined(PROTO)
1104 /*
1105  * Set "win" to be the curwin and "tp" to be the current tab page.
1106  * restore_win() MUST be called to undo, also when FAIL is returned.
1107  * No autocommands will be executed until restore_win() is called.
1108  * When "no_display" is TRUE the display won't be affected, no redraw is
1109  * triggered, another tabpage access is limited.
1110  * Returns FAIL if switching to "win" failed.
1111  */
1112     int
1113 switch_win(
1114     win_T	**save_curwin,
1115     tabpage_T	**save_curtab,
1116     win_T	*win,
1117     tabpage_T	*tp,
1118     int		no_display)
1119 {
1120     block_autocmds();
1121     return switch_win_noblock(save_curwin, save_curtab, win, tp, no_display);
1122 }
1123 
1124 /*
1125  * As switch_win() but without blocking autocommands.
1126  */
1127     int
1128 switch_win_noblock(
1129     win_T	**save_curwin,
1130     tabpage_T	**save_curtab,
1131     win_T	*win,
1132     tabpage_T	*tp,
1133     int		no_display)
1134 {
1135     *save_curwin = curwin;
1136     if (tp != NULL)
1137     {
1138 	*save_curtab = curtab;
1139 	if (no_display)
1140 	{
1141 	    curtab->tp_firstwin = firstwin;
1142 	    curtab->tp_lastwin = lastwin;
1143 	    curtab = tp;
1144 	    firstwin = curtab->tp_firstwin;
1145 	    lastwin = curtab->tp_lastwin;
1146 	}
1147 	else
1148 	    goto_tabpage_tp(tp, FALSE, FALSE);
1149     }
1150     if (!win_valid(win))
1151 	return FAIL;
1152     curwin = win;
1153     curbuf = curwin->w_buffer;
1154     return OK;
1155 }
1156 
1157 /*
1158  * Restore current tabpage and window saved by switch_win(), if still valid.
1159  * When "no_display" is TRUE the display won't be affected, no redraw is
1160  * triggered.
1161  */
1162     void
1163 restore_win(
1164     win_T	*save_curwin,
1165     tabpage_T	*save_curtab,
1166     int		no_display)
1167 {
1168     restore_win_noblock(save_curwin, save_curtab, no_display);
1169     unblock_autocmds();
1170 }
1171 
1172 /*
1173  * As restore_win() but without unblocking autocommands.
1174  */
1175     void
1176 restore_win_noblock(
1177     win_T	*save_curwin,
1178     tabpage_T	*save_curtab,
1179     int		no_display)
1180 {
1181     if (save_curtab != NULL && valid_tabpage(save_curtab))
1182     {
1183 	if (no_display)
1184 	{
1185 	    curtab->tp_firstwin = firstwin;
1186 	    curtab->tp_lastwin = lastwin;
1187 	    curtab = save_curtab;
1188 	    firstwin = curtab->tp_firstwin;
1189 	    lastwin = curtab->tp_lastwin;
1190 	}
1191 	else
1192 	    goto_tabpage_tp(save_curtab, FALSE, FALSE);
1193     }
1194     if (win_valid(save_curwin))
1195     {
1196 	curwin = save_curwin;
1197 	curbuf = curwin->w_buffer;
1198     }
1199 # ifdef FEAT_PROP_POPUP
1200     else if (WIN_IS_POPUP(curwin))
1201 	// original window was closed and now we're in a popup window: Go
1202 	// to the first valid window.
1203 	win_goto(firstwin);
1204 # endif
1205 }
1206 #endif
1207