xref: /vim-8.2.3635/src/structs.h (revision cb80aa2d)
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  */
8 
9 /*
10  * This file contains various definitions of structures that are used by Vim
11  */
12 
13 /*
14  * There is something wrong in the SAS compiler that makes typedefs not
15  * valid in include files.  Has been fixed in version 6.58.
16  */
17 #if defined(SASC) && SASC < 658
18 typedef long		linenr_T;
19 typedef int		colnr_T;
20 typedef unsigned short	short_u;
21 #endif
22 
23 /*
24  * Position in file or buffer.
25  */
26 typedef struct
27 {
28     linenr_T	lnum;	// line number
29     colnr_T	col;	// column number
30     colnr_T	coladd; // extra virtual column
31 } pos_T;
32 
33 
34 /*
35  * Same, but without coladd.
36  */
37 typedef struct
38 {
39     linenr_T	lnum;	// line number
40     colnr_T	col;	// column number
41 } lpos_T;
42 
43 /*
44  * Structure used for growing arrays.
45  * This is used to store information that only grows, is deleted all at
46  * once, and needs to be accessed by index.  See ga_clear() and ga_grow().
47  */
48 typedef struct growarray
49 {
50     int	    ga_len;		    // current number of items used
51     int	    ga_maxlen;		    // maximum number of items possible
52     int	    ga_itemsize;	    // sizeof(item)
53     int	    ga_growsize;	    // number of items to grow each time
54     void    *ga_data;		    // pointer to the first item
55 } garray_T;
56 
57 #define GA_EMPTY    {0, 0, 0, 0, NULL}
58 
59 typedef struct window_S		win_T;
60 typedef struct wininfo_S	wininfo_T;
61 typedef struct frame_S		frame_T;
62 typedef int			scid_T;		// script ID
63 typedef struct file_buffer	buf_T;		// forward declaration
64 typedef struct terminal_S	term_T;
65 
66 #ifdef FEAT_MENU
67 typedef struct VimMenu vimmenu_T;
68 #endif
69 
70 // maximum value for sc_version
71 #define SCRIPT_VERSION_MAX 4
72 // value for sc_version in a Vim9 script file
73 #define SCRIPT_VERSION_VIM9 999999
74 
75 /*
76  * SCript ConteXt (SCTX): identifies a script line.
77  * When sourcing a script "sc_lnum" is zero, "sourcing_lnum" is the current
78  * line number. When executing a user function "sc_lnum" is the line where the
79  * function was defined, "sourcing_lnum" is the line number inside the
80  * function.  When stored with a function, mapping, option, etc. "sc_lnum" is
81  * the line number in the script "sc_sid".
82  *
83  * sc_version is also here, for convenience.
84  */
85 typedef struct {
86     scid_T	sc_sid;		// script ID
87     int		sc_seq;		// sourcing sequence number
88     linenr_T	sc_lnum;	// line number
89     int		sc_version;	// :scriptversion
90 } sctx_T;
91 
92 /*
93  * Reference to a buffer that stores the value of buf_free_count.
94  * bufref_valid() only needs to check "buf" when the count differs.
95  */
96 typedef struct {
97     buf_T   *br_buf;
98     int	    br_fnum;
99     int	    br_buf_free_count;
100 } bufref_T;
101 
102 /*
103  * This is here because regexp.h needs pos_T and below regprog_T is used.
104  */
105 #include "regexp.h"
106 
107 /*
108  * This is here because gui.h needs the pos_T and win_T, and win_T needs gui.h
109  * for scrollbar_T.
110  */
111 #ifdef FEAT_GUI
112 # include "gui.h"
113 #else
114 # ifdef FEAT_XCLIPBOARD
115 #  include <X11/Intrinsic.h>
116 # endif
117 # define guicolor_T long
118 # define INVALCOLOR ((guicolor_T)0x1ffffff)
119     // only used for cterm.bg_rgb and cterm.fg_rgb: use cterm color
120 # define CTERMCOLOR ((guicolor_T)0x1fffffe)
121 #endif
122 #define COLOR_INVALID(x) ((x) == INVALCOLOR || (x) == CTERMCOLOR)
123 
124 /*
125  * marks: positions in a file
126  * (a normal mark is a lnum/col pair, the same as a file position)
127  */
128 
129 // (Note: for EBCDIC there are more than 26, because there are gaps in the
130 // alphabet coding.  To minimize changes to the code, I decided to just
131 // increase the number of possible marks.
132 #define NMARKS		('z' - 'a' + 1)	// max. # of named marks
133 #define EXTRA_MARKS	10		// marks 0-9
134 #define JUMPLISTSIZE	100		// max. # of marks in jump list
135 #define TAGSTACKSIZE	20		// max. # of tags in tag stack
136 
137 typedef struct filemark
138 {
139     pos_T	mark;		// cursor position
140     int		fnum;		// file number
141 } fmark_T;
142 
143 // Xtended file mark: also has a file name
144 typedef struct xfilemark
145 {
146     fmark_T	fmark;
147     char_u	*fname;		// file name, used when fnum == 0
148 #ifdef FEAT_VIMINFO
149     time_T	time_set;
150 #endif
151 } xfmark_T;
152 
153 /*
154  * The taggy struct is used to store the information about a :tag command.
155  */
156 typedef struct taggy
157 {
158     char_u	*tagname;	// tag name
159     fmark_T	fmark;		// cursor position BEFORE ":tag"
160     int		cur_match;	// match number
161     int		cur_fnum;	// buffer number used for cur_match
162     char_u	*user_data;	// used with tagfunc
163 } taggy_T;
164 
165 /*
166  * Structure that contains all options that are local to a window.
167  * Used twice in a window: for the current buffer and for all buffers.
168  * Also used in wininfo_T.
169  */
170 typedef struct
171 {
172 #ifdef FEAT_ARABIC
173     int		wo_arab;
174 # define w_p_arab w_onebuf_opt.wo_arab	// 'arabic'
175 #endif
176 #ifdef FEAT_LINEBREAK
177     int		wo_bri;
178 # define w_p_bri w_onebuf_opt.wo_bri	// 'breakindent'
179     char_u	*wo_briopt;
180 # define w_p_briopt w_onebuf_opt.wo_briopt // 'breakindentopt'
181 #endif
182     char_u	*wo_wcr;
183 # define w_p_wcr w_onebuf_opt.wo_wcr	// 'wincolor'
184 #ifdef FEAT_DIFF
185     int		wo_diff;
186 # define w_p_diff w_onebuf_opt.wo_diff	// 'diff'
187 #endif
188 #ifdef FEAT_FOLDING
189     long	wo_fdc;
190 # define w_p_fdc w_onebuf_opt.wo_fdc	// 'foldcolumn'
191     int		wo_fdc_save;
192 # define w_p_fdc_save w_onebuf_opt.wo_fdc_save	// 'foldenable' saved for diff mode
193     int		wo_fen;
194 # define w_p_fen w_onebuf_opt.wo_fen	// 'foldenable'
195     int		wo_fen_save;
196 # define w_p_fen_save w_onebuf_opt.wo_fen_save	// 'foldenable' saved for diff mode
197     char_u	*wo_fdi;
198 # define w_p_fdi w_onebuf_opt.wo_fdi	// 'foldignore'
199     long	wo_fdl;
200 # define w_p_fdl w_onebuf_opt.wo_fdl	// 'foldlevel'
201     int		wo_fdl_save;
202 # define w_p_fdl_save w_onebuf_opt.wo_fdl_save	// 'foldlevel' state saved for diff mode
203     char_u	*wo_fdm;
204 # define w_p_fdm w_onebuf_opt.wo_fdm	// 'foldmethod'
205     char_u	*wo_fdm_save;
206 # define w_p_fdm_save w_onebuf_opt.wo_fdm_save	// 'fdm' saved for diff mode
207     long	wo_fml;
208 # define w_p_fml w_onebuf_opt.wo_fml	// 'foldminlines'
209     long	wo_fdn;
210 # define w_p_fdn w_onebuf_opt.wo_fdn	// 'foldnestmax'
211 # ifdef FEAT_EVAL
212     char_u	*wo_fde;
213 # define w_p_fde w_onebuf_opt.wo_fde	// 'foldexpr'
214     char_u	*wo_fdt;
215 #  define w_p_fdt w_onebuf_opt.wo_fdt	// 'foldtext'
216 # endif
217     char_u	*wo_fmr;
218 # define w_p_fmr w_onebuf_opt.wo_fmr	// 'foldmarker'
219 #endif
220 #ifdef FEAT_LINEBREAK
221     int		wo_lbr;
222 # define w_p_lbr w_onebuf_opt.wo_lbr	// 'linebreak'
223 #endif
224     int		wo_list;
225 #define w_p_list w_onebuf_opt.wo_list	// 'list'
226     int		wo_nu;
227 #define w_p_nu w_onebuf_opt.wo_nu	// 'number'
228     int		wo_rnu;
229 #define w_p_rnu w_onebuf_opt.wo_rnu	// 'relativenumber'
230 #ifdef FEAT_LINEBREAK
231     long	wo_nuw;
232 # define w_p_nuw w_onebuf_opt.wo_nuw	// 'numberwidth'
233 #endif
234     int		wo_wfh;
235 # define w_p_wfh w_onebuf_opt.wo_wfh	// 'winfixheight'
236     int		wo_wfw;
237 # define w_p_wfw w_onebuf_opt.wo_wfw	// 'winfixwidth'
238 #if defined(FEAT_QUICKFIX)
239     int		wo_pvw;
240 # define w_p_pvw w_onebuf_opt.wo_pvw	// 'previewwindow'
241 #endif
242 #ifdef FEAT_RIGHTLEFT
243     int		wo_rl;
244 # define w_p_rl w_onebuf_opt.wo_rl	// 'rightleft'
245     char_u	*wo_rlc;
246 # define w_p_rlc w_onebuf_opt.wo_rlc	// 'rightleftcmd'
247 #endif
248     long	wo_scr;
249 #define w_p_scr w_onebuf_opt.wo_scr	// 'scroll'
250 #ifdef FEAT_SPELL
251     int		wo_spell;
252 # define w_p_spell w_onebuf_opt.wo_spell // 'spell'
253 #endif
254 #ifdef FEAT_SYN_HL
255     int		wo_cuc;
256 # define w_p_cuc w_onebuf_opt.wo_cuc	// 'cursorcolumn'
257     int		wo_cul;
258 # define w_p_cul w_onebuf_opt.wo_cul	// 'cursorline'
259     char_u	*wo_culopt;
260 # define w_p_culopt w_onebuf_opt.wo_culopt	// 'cursorlineopt'
261     char_u	*wo_cc;
262 # define w_p_cc w_onebuf_opt.wo_cc	// 'colorcolumn'
263 #endif
264 #ifdef FEAT_LINEBREAK
265     char_u	*wo_sbr;
266 #define w_p_sbr w_onebuf_opt.wo_sbr	// 'showbreak'
267 #endif
268 #ifdef FEAT_STL_OPT
269     char_u	*wo_stl;
270 #define w_p_stl w_onebuf_opt.wo_stl	// 'statusline'
271 #endif
272     int		wo_scb;
273 #define w_p_scb w_onebuf_opt.wo_scb	// 'scrollbind'
274     int		wo_diff_saved; // options were saved for starting diff mode
275 #define w_p_diff_saved w_onebuf_opt.wo_diff_saved
276     int		wo_scb_save;	// 'scrollbind' saved for diff mode
277 #define w_p_scb_save w_onebuf_opt.wo_scb_save
278     int		wo_wrap;
279 #define w_p_wrap w_onebuf_opt.wo_wrap	// 'wrap'
280 #ifdef FEAT_DIFF
281     int		wo_wrap_save;	// 'wrap' state saved for diff mode
282 # define w_p_wrap_save w_onebuf_opt.wo_wrap_save
283 #endif
284 #ifdef FEAT_CONCEAL
285     char_u	*wo_cocu;		// 'concealcursor'
286 # define w_p_cocu w_onebuf_opt.wo_cocu
287     long	wo_cole;		// 'conceallevel'
288 # define w_p_cole w_onebuf_opt.wo_cole
289 #endif
290     int		wo_crb;
291 #define w_p_crb w_onebuf_opt.wo_crb	// 'cursorbind'
292     int		wo_crb_save;	// 'cursorbind' state saved for diff mode
293 #define w_p_crb_save w_onebuf_opt.wo_crb_save
294 #ifdef FEAT_SIGNS
295     char_u	*wo_scl;
296 # define w_p_scl w_onebuf_opt.wo_scl	// 'signcolumn'
297 #endif
298 #ifdef FEAT_TERMINAL
299     char_u	*wo_twk;
300 # define w_p_twk w_onebuf_opt.wo_twk	// 'termwinkey'
301     char_u	*wo_tws;
302 # define w_p_tws w_onebuf_opt.wo_tws	// 'termwinsize'
303 #endif
304 
305 #ifdef FEAT_EVAL
306     sctx_T	wo_script_ctx[WV_COUNT];	// SCTXs for window-local options
307 # define w_p_script_ctx w_onebuf_opt.wo_script_ctx
308 #endif
309 } winopt_T;
310 
311 /*
312  * Window info stored with a buffer.
313  *
314  * Two types of info are kept for a buffer which are associated with a
315  * specific window:
316  * 1. Each window can have a different line number associated with a buffer.
317  * 2. The window-local options for a buffer work in a similar way.
318  * The window-info is kept in a list at b_wininfo.  It is kept in
319  * most-recently-used order.
320  */
321 struct wininfo_S
322 {
323     wininfo_T	*wi_next;	// next entry or NULL for last entry
324     wininfo_T	*wi_prev;	// previous entry or NULL for first entry
325     win_T	*wi_win;	// pointer to window that did set wi_fpos
326     pos_T	wi_fpos;	// last cursor position in the file
327     int		wi_optset;	// TRUE when wi_opt has useful values
328     winopt_T	wi_opt;		// local window options
329 #ifdef FEAT_FOLDING
330     int		wi_fold_manual;	// copy of w_fold_manual
331     garray_T	wi_folds;	// clone of w_folds
332 #endif
333 };
334 
335 /*
336  * Info used to pass info about a fold from the fold-detection code to the
337  * code that displays the foldcolumn.
338  */
339 typedef struct foldinfo
340 {
341     int		fi_level;	// level of the fold; when this is zero the
342 				// other fields are invalid
343     int		fi_lnum;	// line number where fold starts
344     int		fi_low_level;	// lowest fold level that starts in the same
345 				// line
346 } foldinfo_T;
347 
348 /*
349  * Structure to store info about the Visual area.
350  */
351 typedef struct
352 {
353     pos_T	vi_start;	// start pos of last VIsual
354     pos_T	vi_end;		// end position of last VIsual
355     int		vi_mode;	// VIsual_mode of last VIsual
356     colnr_T	vi_curswant;	// MAXCOL from w_curswant
357 } visualinfo_T;
358 
359 /*
360  * structures used for undo
361  */
362 
363 // One line saved for undo.  After the NUL terminated text there might be text
364 // properties, thus ul_len can be larger than STRLEN(ul_line) + 1.
365 typedef struct {
366     char_u	*ul_line;	// text of the line
367     long	ul_len;		// length of the line including NUL, plus text
368 				// properties
369 } undoline_T;
370 
371 typedef struct u_entry u_entry_T;
372 typedef struct u_header u_header_T;
373 struct u_entry
374 {
375     u_entry_T	*ue_next;	// pointer to next entry in list
376     linenr_T	ue_top;		// number of line above undo block
377     linenr_T	ue_bot;		// number of line below undo block
378     linenr_T	ue_lcount;	// linecount when u_save called
379     undoline_T	*ue_array;	// array of lines in undo block
380     long	ue_size;	// number of lines in ue_array
381 #ifdef U_DEBUG
382     int		ue_magic;	// magic number to check allocation
383 #endif
384 };
385 
386 struct u_header
387 {
388     // The following have a pointer and a number. The number is used when
389     // reading the undo file in u_read_undo()
390     union {
391 	u_header_T *ptr;	// pointer to next undo header in list
392 	long	   seq;
393     } uh_next;
394     union {
395 	u_header_T *ptr;	// pointer to previous header in list
396 	long	   seq;
397     } uh_prev;
398     union {
399 	u_header_T *ptr;	// pointer to next header for alt. redo
400 	long	   seq;
401     } uh_alt_next;
402     union {
403 	u_header_T *ptr;	// pointer to previous header for alt. redo
404 	long	   seq;
405     } uh_alt_prev;
406     long	uh_seq;		// sequence number, higher == newer undo
407     int		uh_walk;	// used by undo_time()
408     u_entry_T	*uh_entry;	// pointer to first entry
409     u_entry_T	*uh_getbot_entry; // pointer to where ue_bot must be set
410     pos_T	uh_cursor;	// cursor position before saving
411     long	uh_cursor_vcol;
412     int		uh_flags;	// see below
413     pos_T	uh_namedm[NMARKS];	// marks before undo/after redo
414     visualinfo_T uh_visual;	// Visual areas before undo/after redo
415     time_T	uh_time;	// timestamp when the change was made
416     long	uh_save_nr;	// set when the file was saved after the
417 				// changes in this block
418 #ifdef U_DEBUG
419     int		uh_magic;	// magic number to check allocation
420 #endif
421 };
422 
423 // values for uh_flags
424 #define UH_CHANGED  0x01	// b_changed flag before undo/after redo
425 #define UH_EMPTYBUF 0x02	// buffer was empty
426 
427 /*
428  * structures used in undo.c
429  */
430 #define ALIGN_LONG	// longword alignment and use filler byte
431 #define ALIGN_SIZE (sizeof(long))
432 
433 #define ALIGN_MASK (ALIGN_SIZE - 1)
434 
435 typedef struct m_info minfo_T;
436 
437 /*
438  * structure used to link chunks in one of the free chunk lists.
439  */
440 struct m_info
441 {
442 #ifdef ALIGN_LONG
443     long_u	m_size;		// size of the chunk (including m_info)
444 #else
445     short_u	m_size;		// size of the chunk (including m_info)
446 #endif
447     minfo_T	*m_next;	// pointer to next free chunk in the list
448 };
449 
450 /*
451  * things used in memfile.c
452  */
453 
454 typedef struct block_hdr    bhdr_T;
455 typedef struct memfile	    memfile_T;
456 typedef long		    blocknr_T;
457 
458 /*
459  * mf_hashtab_T is a chained hashtable with blocknr_T key and arbitrary
460  * structures as items.  This is an intrusive data structure: we require
461  * that items begin with mf_hashitem_T which contains the key and linked
462  * list pointers.  List of items in each bucket is doubly-linked.
463  */
464 
465 typedef struct mf_hashitem_S mf_hashitem_T;
466 
467 struct mf_hashitem_S
468 {
469     mf_hashitem_T   *mhi_next;
470     mf_hashitem_T   *mhi_prev;
471     blocknr_T	    mhi_key;
472 };
473 
474 #define MHT_INIT_SIZE   64
475 
476 typedef struct mf_hashtab_S
477 {
478     long_u	    mht_mask;	    // mask used for hash value (nr of items
479 				    // in array is "mht_mask" + 1)
480     long_u	    mht_count;	    // nr of items inserted into hashtable
481     mf_hashitem_T   **mht_buckets;  // points to mht_small_buckets or
482 				    //dynamically allocated array
483     mf_hashitem_T   *mht_small_buckets[MHT_INIT_SIZE];   // initial buckets
484     char	    mht_fixed;	    // non-zero value forbids growth
485 } mf_hashtab_T;
486 
487 /*
488  * for each (previously) used block in the memfile there is one block header.
489  *
490  * The block may be linked in the used list OR in the free list.
491  * The used blocks are also kept in hash lists.
492  *
493  * The used list is a doubly linked list, most recently used block first.
494  *	The blocks in the used list have a block of memory allocated.
495  *	mf_used_count is the number of pages in the used list.
496  * The hash lists are used to quickly find a block in the used list.
497  * The free list is a single linked list, not sorted.
498  *	The blocks in the free list have no block of memory allocated and
499  *	the contents of the block in the file (if any) is irrelevant.
500  */
501 
502 struct block_hdr
503 {
504     mf_hashitem_T bh_hashitem;      // header for hash table and key
505 #define bh_bnum bh_hashitem.mhi_key // block number, part of bh_hashitem
506 
507     bhdr_T	*bh_next;	    // next block_hdr in free or used list
508     bhdr_T	*bh_prev;	    // previous block_hdr in used list
509     char_u	*bh_data;	    // pointer to memory (for used block)
510     int		bh_page_count;	    // number of pages in this block
511 
512 #define BH_DIRTY    1
513 #define BH_LOCKED   2
514     char	bh_flags;	    // BH_DIRTY or BH_LOCKED
515 };
516 
517 /*
518  * when a block with a negative number is flushed to the file, it gets
519  * a positive number. Because the reference to the block is still the negative
520  * number, we remember the translation to the new positive number in the
521  * double linked trans lists. The structure is the same as the hash lists.
522  */
523 typedef struct nr_trans NR_TRANS;
524 
525 struct nr_trans
526 {
527     mf_hashitem_T nt_hashitem;		// header for hash table and key
528 #define nt_old_bnum nt_hashitem.mhi_key	// old, negative, number
529 
530     blocknr_T	nt_new_bnum;		// new, positive, number
531 };
532 
533 
534 typedef struct buffblock buffblock_T;
535 typedef struct buffheader buffheader_T;
536 
537 /*
538  * structure used to store one block of the stuff/redo/recording buffers
539  */
540 struct buffblock
541 {
542     buffblock_T	*b_next;	// pointer to next buffblock
543     char_u	b_str[1];	// contents (actually longer)
544 };
545 
546 /*
547  * header used for the stuff buffer and the redo buffer
548  */
549 struct buffheader
550 {
551     buffblock_T	bh_first;	// first (dummy) block of list
552     buffblock_T	*bh_curr;	// buffblock for appending
553     int		bh_index;	// index for reading
554     int		bh_space;	// space in bh_curr for appending
555 };
556 
557 typedef struct
558 {
559     buffheader_T sr_redobuff;
560     buffheader_T sr_old_redobuff;
561 } save_redo_T;
562 
563 /*
564  * used for completion on the command line
565  */
566 typedef struct expand
567 {
568     char_u	*xp_pattern;		// start of item to expand
569     int		xp_context;		// type of expansion
570     int		xp_pattern_len;		// bytes in xp_pattern before cursor
571 #if defined(FEAT_EVAL)
572     char_u	*xp_arg;		// completion function
573     sctx_T	xp_script_ctx;		// SCTX for completion function
574 #endif
575     int		xp_backslash;		// one of the XP_BS_ values
576 #ifndef BACKSLASH_IN_FILENAME
577     int		xp_shell;		// TRUE for a shell command, more
578 					// characters need to be escaped
579 #endif
580     int		xp_numfiles;		// number of files found by
581 					// file name completion
582     int		xp_col;			// cursor position in line
583     char_u	**xp_files;		// list of files
584     char_u	*xp_line;		// text being completed
585 } expand_T;
586 
587 /*
588  * values for xp_backslash
589  */
590 #define XP_BS_NONE	0	// nothing special for backslashes
591 #define XP_BS_ONE	1	// uses one backslash before a space
592 #define XP_BS_THREE	2	// uses three backslashes before a space
593 
594 /*
595  * Variables shared between getcmdline(), redrawcmdline() and others.
596  * These need to be saved when using CTRL-R |, that's why they are in a
597  * structure.
598  */
599 typedef struct
600 {
601     char_u	*cmdbuff;	// pointer to command line buffer
602     int		cmdbufflen;	// length of cmdbuff
603     int		cmdlen;		// number of chars in command line
604     int		cmdpos;		// current cursor position
605     int		cmdspos;	// cursor column on screen
606     int		cmdfirstc;	// ':', '/', '?', '=', '>' or NUL
607     int		cmdindent;	// number of spaces before cmdline
608     char_u	*cmdprompt;	// message in front of cmdline
609     int		cmdattr;	// attributes for prompt
610     int		overstrike;	// Typing mode on the command line.  Shared by
611 				// getcmdline() and put_on_cmdline().
612     expand_T	*xpc;		// struct being used for expansion, xp_pattern
613 				// may point into cmdbuff
614     int		xp_context;	// type of expansion
615 # ifdef FEAT_EVAL
616     char_u	*xp_arg;	// user-defined expansion arg
617     int		input_fn;	// when TRUE Invoked for input() function
618 # endif
619 } cmdline_info_T;
620 
621 /*
622  * Command modifiers ":vertical", ":browse", ":confirm" and ":hide" set a flag.
623  * This needs to be saved for recursive commands, put them in a structure for
624  * easy manipulation.
625  */
626 typedef struct
627 {
628     int		cmod_flags;		// CMOD_ flags
629 #define CMOD_SANDBOX	    0x0001	// ":sandbox"
630 #define CMOD_SILENT	    0x0002	// ":silent"
631 #define CMOD_ERRSILENT	    0x0004	// ":silent!"
632 #define CMOD_UNSILENT	    0x0008	// ":unsilent"
633 #define CMOD_NOAUTOCMD	    0x0010	// ":noautocmd"
634 #define CMOD_HIDE	    0x0020	// ":hide"
635 #define CMOD_BROWSE	    0x0040	// ":browse" - invoke file dialog
636 #define CMOD_CONFIRM	    0x0080	// ":confirm" - invoke yes/no dialog
637 #define CMOD_KEEPALT	    0x0100	// ":keepalt"
638 #define CMOD_KEEPMARKS	    0x0200	// ":keepmarks"
639 #define CMOD_KEEPJUMPS	    0x0400	// ":keepjumps"
640 #define CMOD_LOCKMARKS	    0x0800	// ":lockmarks"
641 #define CMOD_KEEPPATTERNS   0x1000	// ":keeppatterns"
642 #define CMOD_NOSWAPFILE	    0x2000	// ":noswapfile"
643 
644     int		cmod_split;		// flags for win_split()
645     int		cmod_tab;		// > 0 when ":tab" was used
646     regmatch_T	cmod_filter_regmatch;	// set by :filter /pat/
647     int		cmod_filter_force;	// set for :filter!
648 
649     int		cmod_verbose;		// non-zero to set 'verbose'
650 
651     // values for undo_cmdmod()
652     char_u	*cmod_save_ei;		// saved value of 'eventignore'
653 #ifdef HAVE_SANDBOX
654     int		cmod_did_sandbox;	// set when "sandbox" was incremented
655 #endif
656     long	cmod_verbose_save;	// if 'verbose' was set: value of
657 					// p_verbose plus one
658     int		cmod_save_msg_silent;	// if non-zero: saved value of
659 					// msg_silent + 1
660     int		cmod_save_msg_scroll;	// for restoring msg_scroll
661     int		cmod_did_esilent;	// incremented when emsg_silent is
662 } cmdmod_T;
663 
664 #define MF_SEED_LEN	8
665 
666 struct memfile
667 {
668     char_u	*mf_fname;		// name of the file
669     char_u	*mf_ffname;		// idem, full path
670     int		mf_fd;			// file descriptor
671     int		mf_flags;		// flags used when opening this memfile
672     int		mf_reopen;		// mf_fd was closed, retry opening
673     bhdr_T	*mf_free_first;		// first block_hdr in free list
674     bhdr_T	*mf_used_first;		// mru block_hdr in used list
675     bhdr_T	*mf_used_last;		// lru block_hdr in used list
676     unsigned	mf_used_count;		// number of pages in used list
677     unsigned	mf_used_count_max;	// maximum number of pages in memory
678     mf_hashtab_T mf_hash;		// hash lists
679     mf_hashtab_T mf_trans;		// trans lists
680     blocknr_T	mf_blocknr_max;		// highest positive block number + 1
681     blocknr_T	mf_blocknr_min;		// lowest negative block number - 1
682     blocknr_T	mf_neg_count;		// number of negative blocks numbers
683     blocknr_T	mf_infile_count;	// number of pages in the file
684     unsigned	mf_page_size;		// number of bytes in a page
685     int		mf_dirty;		// TRUE if there are dirty blocks
686 #ifdef FEAT_CRYPT
687     buf_T	*mf_buffer;		// buffer this memfile is for
688     char_u	mf_seed[MF_SEED_LEN];	// seed for encryption
689 
690     // Values for key, method and seed used for reading data blocks when
691     // updating for a newly set key or method. Only when mf_old_key != NULL.
692     char_u	*mf_old_key;
693     int		mf_old_cm;
694     char_u	mf_old_seed[MF_SEED_LEN];
695 #endif
696 };
697 
698 /*
699  * things used in memline.c
700  */
701 /*
702  * When searching for a specific line, we remember what blocks in the tree
703  * are the branches leading to that block. This is stored in ml_stack.  Each
704  * entry is a pointer to info in a block (may be data block or pointer block)
705  */
706 typedef struct info_pointer
707 {
708     blocknr_T	ip_bnum;	// block number
709     linenr_T	ip_low;		// lowest lnum in this block
710     linenr_T	ip_high;	// highest lnum in this block
711     int		ip_index;	// index for block with current lnum
712 } infoptr_T;	// block/index pair
713 
714 #ifdef FEAT_BYTEOFF
715 typedef struct ml_chunksize
716 {
717     int		mlcs_numlines;
718     long	mlcs_totalsize;
719 } chunksize_T;
720 
721 /*
722  * Flags when calling ml_updatechunk()
723  */
724 # define ML_CHNK_ADDLINE 1
725 # define ML_CHNK_DELLINE 2
726 # define ML_CHNK_UPDLINE 3
727 #endif
728 
729 /*
730  * the memline structure holds all the information about a memline
731  */
732 typedef struct memline
733 {
734     linenr_T	ml_line_count;	// number of lines in the buffer
735 
736     memfile_T	*ml_mfp;	// pointer to associated memfile
737 
738     infoptr_T	*ml_stack;	// stack of pointer blocks (array of IPTRs)
739     int		ml_stack_top;	// current top of ml_stack
740     int		ml_stack_size;	// total number of entries in ml_stack
741 
742 #define ML_EMPTY	1	// empty buffer
743 #define ML_LINE_DIRTY	2	// cached line was changed and allocated
744 #define ML_LOCKED_DIRTY	4	// ml_locked was changed
745 #define ML_LOCKED_POS	8	// ml_locked needs positive block number
746     int		ml_flags;
747 
748     colnr_T	ml_line_len;	// length of the cached line, including NUL
749     linenr_T	ml_line_lnum;	// line number of cached line, 0 if not valid
750     char_u	*ml_line_ptr;	// pointer to cached line
751 
752     bhdr_T	*ml_locked;	// block used by last ml_get
753     linenr_T	ml_locked_low;	// first line in ml_locked
754     linenr_T	ml_locked_high;	// last line in ml_locked
755     int		ml_locked_lineadd;  // number of lines inserted in ml_locked
756 #ifdef FEAT_BYTEOFF
757     chunksize_T *ml_chunksize;
758     int		ml_numchunks;
759     int		ml_usedchunks;
760 #endif
761 } memline_T;
762 
763 // Values for the flags argument of ml_delete_flags().
764 #define ML_DEL_MESSAGE	    1	// may give a "No lines in buffer" message
765 #define ML_DEL_UNDO	    2	// called from undo, do not update textprops
766 
767 // Values for the flags argument of ml_append_int().
768 #define ML_APPEND_NEW	    1	// starting to edit a new file
769 #define ML_APPEND_MARK	    2	// mark the new line
770 #define ML_APPEND_UNDO	    4	// called from undo
771 
772 
773 /*
774  * Structure defining text properties.  These stick with the text.
775  * When stored in memline they are after the text, ml_line_len is larger than
776  * STRLEN(ml_line_ptr) + 1.
777  */
778 typedef struct textprop_S
779 {
780     colnr_T	tp_col;		// start column (one based, in bytes)
781     colnr_T	tp_len;		// length in bytes
782     int		tp_id;		// identifier
783     int		tp_type;	// property type
784     int		tp_flags;	// TP_FLAG_ values
785 } textprop_T;
786 
787 #define TP_FLAG_CONT_NEXT	1	// property continues in next line
788 #define TP_FLAG_CONT_PREV	2	// property was continued from prev line
789 
790 /*
791  * Structure defining a property type.
792  */
793 typedef struct proptype_S
794 {
795     int		pt_id;		// value used for tp_id
796     int		pt_type;	// number used for tp_type
797     int		pt_hl_id;	// highlighting
798     int		pt_priority;	// priority
799     int		pt_flags;	// PT_FLAG_ values
800     char_u	pt_name[1];	// property type name, actually longer
801 } proptype_T;
802 
803 #define PT_FLAG_INS_START_INCL	1	// insert at start included in property
804 #define PT_FLAG_INS_END_INCL	2	// insert at end included in property
805 #define PT_FLAG_COMBINE		4	// combine with syntax highlight
806 
807 // Sign group
808 typedef struct signgroup_S
809 {
810     int		sg_next_sign_id;	// next sign id for this group
811     short_u	sg_refcount;		// number of signs in this group
812     char_u	sg_name[1];		// sign group name, actually longer
813 } signgroup_T;
814 
815 typedef struct sign_entry sign_entry_T;
816 struct sign_entry
817 {
818     int		 se_id;		// unique identifier for each placed sign
819     int		 se_typenr;	// typenr of sign
820     int		 se_priority;	// priority for highlighting
821     linenr_T	 se_lnum;	// line number which has this sign
822     signgroup_T	 *se_group;	// sign group
823     sign_entry_T *se_next;	// next entry in a list of signs
824     sign_entry_T *se_prev;	// previous entry -- for easy reordering
825 };
826 
827 /*
828  * Sign attributes. Used by the screen refresh routines.
829  */
830 typedef struct sign_attrs_S {
831     int		sat_typenr;
832     void	*sat_icon;
833     char_u	*sat_text;
834     int		sat_texthl;
835     int		sat_linehl;
836     int		sat_priority;
837 } sign_attrs_T;
838 
839 #if defined(FEAT_SIGNS) || defined(PROTO)
840 // Macros to get the sign group structure from the group name
841 #define SGN_KEY_OFF	offsetof(signgroup_T, sg_name)
842 #define HI2SG(hi)	((signgroup_T *)((hi)->hi_key - SGN_KEY_OFF))
843 
844 // Default sign priority for highlighting
845 #define SIGN_DEF_PRIO	10
846 
847 #endif
848 
849 /*
850  * Argument list: Array of file names.
851  * Used for the global argument list and the argument lists local to a window.
852  */
853 typedef struct arglist
854 {
855     garray_T	al_ga;		// growarray with the array of file names
856     int		al_refcount;	// number of windows using this arglist
857     int		id;		// id of this arglist
858 } alist_T;
859 
860 /*
861  * For each argument remember the file name as it was given, and the buffer
862  * number that contains the expanded file name (required for when ":cd" is
863  * used).
864  */
865 typedef struct argentry
866 {
867     char_u	*ae_fname;	// file name as specified
868     int		ae_fnum;	// buffer number with expanded file name
869 } aentry_T;
870 
871 #define ALIST(win)	(win)->w_alist
872 #define GARGLIST	((aentry_T *)global_alist.al_ga.ga_data)
873 #define ARGLIST		((aentry_T *)ALIST(curwin)->al_ga.ga_data)
874 #define WARGLIST(wp)	((aentry_T *)ALIST(wp)->al_ga.ga_data)
875 #define AARGLIST(al)	((aentry_T *)((al)->al_ga.ga_data))
876 #define GARGCOUNT	(global_alist.al_ga.ga_len)
877 #define ARGCOUNT	(ALIST(curwin)->al_ga.ga_len)
878 #define WARGCOUNT(wp)	(ALIST(wp)->al_ga.ga_len)
879 
880 /*
881  * A list used for saving values of "emsg_silent".  Used by ex_try() to save the
882  * value of "emsg_silent" if it was non-zero.  When this is done, the CSF_SILENT
883  * flag below is set.
884  */
885 
886 typedef struct eslist_elem eslist_T;
887 struct eslist_elem
888 {
889     int		saved_emsg_silent;	// saved value of "emsg_silent"
890     eslist_T	*next;			// next element on the list
891 };
892 
893 /*
894  * For conditional commands a stack is kept of nested conditionals.
895  * When cs_idx < 0, there is no conditional command.
896  */
897 #define CSTACK_LEN	50
898 
899 typedef struct {
900     short	cs_flags[CSTACK_LEN];	// CSF_ flags
901     char	cs_pending[CSTACK_LEN];	// CSTP_: what's pending in ":finally"
902     union {
903 	void	*csp_rv[CSTACK_LEN];	// return typeval for pending return
904 	void	*csp_ex[CSTACK_LEN];	// exception for pending throw
905     }		cs_pend;
906     void	*cs_forinfo[CSTACK_LEN]; // info used by ":for"
907     int		cs_line[CSTACK_LEN];	// line nr of ":while"/":for" line
908     int		cs_block_id[CSTACK_LEN];    // block ID stack
909     int		cs_script_var_len[CSTACK_LEN];	// value of sn_var_vals.ga_len
910 						// when entering the block
911     int		cs_idx;			// current entry, or -1 if none
912     int		cs_looplevel;		// nr of nested ":while"s and ":for"s
913     int		cs_trylevel;		// nr of nested ":try"s
914     eslist_T	*cs_emsg_silent_list;	// saved values of "emsg_silent"
915     char	cs_lflags;		// loop flags: CSL_ flags
916 } cstack_T;
917 # define cs_rettv	cs_pend.csp_rv
918 # define cs_exception	cs_pend.csp_ex
919 
920 // There is no CSF_IF, the lack of CSF_WHILE, CSF_FOR and CSF_TRY means ":if"
921 // was used.
922 # define CSF_TRUE	0x0001	// condition was TRUE
923 # define CSF_ACTIVE	0x0002	// current state is active
924 # define CSF_ELSE	0x0004	// ":else" has been passed
925 # define CSF_WHILE	0x0008	// is a ":while"
926 # define CSF_FOR	0x0010	// is a ":for"
927 # define CSF_BLOCK	0x0020	// is a "{" block
928 
929 # define CSF_TRY	0x0100	// is a ":try"
930 # define CSF_FINALLY	0x0200	// ":finally" has been passed
931 # define CSF_THROWN	0x0400	// exception thrown to this try conditional
932 # define CSF_CAUGHT	0x0800  // exception caught by this try conditional
933 # define CSF_SILENT	0x1000	// "emsg_silent" reset by ":try"
934 // Note that CSF_ELSE is only used when CSF_TRY and CSF_WHILE are unset
935 // (an ":if"), and CSF_SILENT is only used when CSF_TRY is set.
936 //
937 #define CSF_FUNC_DEF	0x2000	// a function was defined in this block
938 
939 /*
940  * What's pending for being reactivated at the ":endtry" of this try
941  * conditional:
942  */
943 # define CSTP_NONE	0	// nothing pending in ":finally" clause
944 # define CSTP_ERROR	1	// an error is pending
945 # define CSTP_INTERRUPT	2	// an interrupt is pending
946 # define CSTP_THROW	4	// a throw is pending
947 # define CSTP_BREAK	8	// ":break" is pending
948 # define CSTP_CONTINUE	16	// ":continue" is pending
949 # define CSTP_RETURN	24	// ":return" is pending
950 # define CSTP_FINISH	32	// ":finish" is pending
951 
952 /*
953  * Flags for the cs_lflags item in cstack_T.
954  */
955 # define CSL_HAD_LOOP	 1	// just found ":while" or ":for"
956 # define CSL_HAD_ENDLOOP 2	// just found ":endwhile" or ":endfor"
957 # define CSL_HAD_CONT	 4	// just found ":continue"
958 # define CSL_HAD_FINA	 8	// just found ":finally"
959 
960 /*
961  * A list of error messages that can be converted to an exception.  "throw_msg"
962  * is only set in the first element of the list.  Usually, it points to the
963  * original message stored in that element, but sometimes it points to a later
964  * message in the list.  See cause_errthrow().
965  */
966 typedef struct msglist msglist_T;
967 struct msglist
968 {
969     char	*msg;		// original message, allocated
970     char	*throw_msg;	// msg to throw: usually original one
971     char_u	*sfile;		// value from estack_sfile(), allocated
972     long	slnum;		// line number for "sfile"
973     msglist_T	*next;		// next of several messages in a row
974 };
975 
976 /*
977  * The exception types.
978  */
979 typedef enum
980 {
981     ET_USER,		// exception caused by ":throw" command
982     ET_ERROR,		// error exception
983     ET_INTERRUPT,	// interrupt exception triggered by Ctrl-C
984 } except_type_T;
985 
986 /*
987  * Structure describing an exception.
988  * (don't use "struct exception", it's used by the math library).
989  */
990 typedef struct vim_exception except_T;
991 struct vim_exception
992 {
993     except_type_T	type;		// exception type
994     char		*value;		// exception value
995     struct msglist	*messages;	// message(s) causing error exception
996     char_u		*throw_name;	// name of the throw point
997     linenr_T		throw_lnum;	// line number of the throw point
998     except_T		*caught;	// next exception on the caught stack
999 };
1000 
1001 /*
1002  * Structure to save the error/interrupt/exception state between calls to
1003  * enter_cleanup() and leave_cleanup().  Must be allocated as an automatic
1004  * variable by the (common) caller of these functions.
1005  */
1006 typedef struct cleanup_stuff cleanup_T;
1007 struct cleanup_stuff
1008 {
1009     int pending;		// error/interrupt/exception state
1010     except_T *exception;	// exception value
1011 };
1012 
1013 #ifdef FEAT_SYN_HL
1014 // struct passed to in_id_list()
1015 struct sp_syn
1016 {
1017     int		inc_tag;	// ":syn include" unique tag
1018     short	id;		// highlight group ID of item
1019     short	*cont_in_list;	// cont.in group IDs, if non-zero
1020 };
1021 
1022 /*
1023  * Each keyword has one keyentry, which is linked in a hash list.
1024  */
1025 typedef struct keyentry keyentry_T;
1026 
1027 struct keyentry
1028 {
1029     keyentry_T	*ke_next;	// next entry with identical "keyword[]"
1030     struct sp_syn k_syn;	// struct passed to in_id_list()
1031     short	*next_list;	// ID list for next match (if non-zero)
1032     int		flags;
1033     int		k_char;		// conceal substitute character
1034     char_u	keyword[1];	// actually longer
1035 };
1036 
1037 /*
1038  * Struct used to store one state of the state stack.
1039  */
1040 typedef struct buf_state
1041 {
1042     int		    bs_idx;	 // index of pattern
1043     int		    bs_flags;	 // flags for pattern
1044 #ifdef FEAT_CONCEAL
1045     int		    bs_seqnr;	 // stores si_seqnr
1046     int		    bs_cchar;	 // stores si_cchar
1047 #endif
1048     reg_extmatch_T *bs_extmatch; // external matches from start pattern
1049 } bufstate_T;
1050 
1051 /*
1052  * syn_state contains the syntax state stack for the start of one line.
1053  * Used by b_sst_array[].
1054  */
1055 typedef struct syn_state synstate_T;
1056 
1057 struct syn_state
1058 {
1059     synstate_T	*sst_next;	// next entry in used or free list
1060     linenr_T	sst_lnum;	// line number for this state
1061     union
1062     {
1063 	bufstate_T	sst_stack[SST_FIX_STATES]; // short state stack
1064 	garray_T	sst_ga;	// growarray for long state stack
1065     } sst_union;
1066     int		sst_next_flags;	// flags for sst_next_list
1067     int		sst_stacksize;	// number of states on the stack
1068     short	*sst_next_list;	// "nextgroup" list in this state
1069 				// (this is a copy, don't free it!
1070     disptick_T	sst_tick;	// tick when last displayed
1071     linenr_T	sst_change_lnum;// when non-zero, change in this line
1072 				// may have made the state invalid
1073 };
1074 #endif // FEAT_SYN_HL
1075 
1076 #define MAX_HL_ID       20000	// maximum value for a highlight ID.
1077 
1078 /*
1079  * Structure shared between syntax.c, screen.c and gui_x11.c.
1080  */
1081 typedef struct attr_entry
1082 {
1083     short	    ae_attr;		// HL_BOLD, etc.
1084     union
1085     {
1086 	struct
1087 	{
1088 	    char_u	    *start;	// start escape sequence
1089 	    char_u	    *stop;	// stop escape sequence
1090 	} term;
1091 	struct
1092 	{
1093 	    // These colors need to be > 8 bits to hold 256.
1094 	    short_u	    fg_color;	// foreground color number
1095 	    short_u	    bg_color;	// background color number
1096 	    short_u	    ul_color;	// underline color number
1097 # ifdef FEAT_TERMGUICOLORS
1098 	    guicolor_T	    fg_rgb;	// foreground color RGB
1099 	    guicolor_T	    bg_rgb;	// background color RGB
1100 	    guicolor_T	    ul_rgb;	// underline color RGB
1101 # endif
1102 	} cterm;
1103 # ifdef FEAT_GUI
1104 	struct
1105 	{
1106 	    guicolor_T	    fg_color;	// foreground color handle
1107 	    guicolor_T	    bg_color;	// background color handle
1108 	    guicolor_T	    sp_color;	// special color handle
1109 	    GuiFont	    font;	// font handle
1110 #  ifdef FEAT_XFONTSET
1111 	    GuiFontset	    fontset;	// fontset handle
1112 #  endif
1113 	} gui;
1114 # endif
1115     } ae_u;
1116 } attrentry_T;
1117 
1118 #ifdef USE_ICONV
1119 # ifdef HAVE_ICONV_H
1120 #  include <iconv.h>
1121 # else
1122 #  if defined(MACOS_X)
1123 #   include <sys/errno.h>
1124 #   ifndef EILSEQ
1125 #    define EILSEQ ENOENT // Early MacOS X does not have EILSEQ
1126 #   endif
1127 typedef struct _iconv_t *iconv_t;
1128 #  else
1129 #   include <errno.h>
1130 #  endif
1131 typedef void *iconv_t;
1132 # endif
1133 #endif
1134 
1135 /*
1136  * Used for the typeahead buffer: typebuf.
1137  */
1138 typedef struct
1139 {
1140     char_u	*tb_buf;	// buffer for typed characters
1141     char_u	*tb_noremap;	// mapping flags for characters in tb_buf[]
1142     int		tb_buflen;	// size of tb_buf[]
1143     int		tb_off;		// current position in tb_buf[]
1144     int		tb_len;		// number of valid bytes in tb_buf[]
1145     int		tb_maplen;	// nr of mapped bytes in tb_buf[]
1146     int		tb_silent;	// nr of silently mapped bytes in tb_buf[]
1147     int		tb_no_abbr_cnt; // nr of bytes without abbrev. in tb_buf[]
1148     int		tb_change_cnt;	// nr of time tb_buf was changed; never zero
1149 } typebuf_T;
1150 
1151 // Struct to hold the saved typeahead for save_typeahead().
1152 typedef struct
1153 {
1154     typebuf_T		save_typebuf;
1155     int			typebuf_valid;	    // TRUE when save_typebuf valid
1156     int			old_char;
1157     int			old_mod_mask;
1158     buffheader_T	save_readbuf1;
1159     buffheader_T	save_readbuf2;
1160 #ifdef USE_INPUT_BUF
1161     char_u		*save_inputbuf;
1162 #endif
1163 } tasave_T;
1164 
1165 /*
1166  * Used for conversion of terminal I/O and script files.
1167  */
1168 typedef struct
1169 {
1170     int		vc_type;	// zero or one of the CONV_ values
1171     int		vc_factor;	// max. expansion factor
1172 # ifdef MSWIN
1173     int		vc_cpfrom;	// codepage to convert from (CONV_CODEPAGE)
1174     int		vc_cpto;	// codepage to convert to (CONV_CODEPAGE)
1175 # endif
1176 # ifdef USE_ICONV
1177     iconv_t	vc_fd;		// for CONV_ICONV
1178 # endif
1179     int		vc_fail;	// fail for invalid char, don't use '?'
1180 } vimconv_T;
1181 
1182 /*
1183  * Structure used for the command line history.
1184  */
1185 typedef struct hist_entry
1186 {
1187     int		hisnum;		// identifying number
1188     int		viminfo;	// when TRUE hisstr comes from viminfo
1189     char_u	*hisstr;	// actual entry, separator char after the NUL
1190     time_t	time_set;	// when it was typed, zero if unknown
1191 } histentry_T;
1192 
1193 #define CONV_NONE		0
1194 #define CONV_TO_UTF8		1
1195 #define CONV_9_TO_UTF8		2
1196 #define CONV_TO_LATIN1		3
1197 #define CONV_TO_LATIN9		4
1198 #define CONV_ICONV		5
1199 #ifdef MSWIN
1200 # define CONV_CODEPAGE		10	// codepage -> codepage
1201 #endif
1202 #ifdef MACOS_X
1203 # define CONV_MAC_LATIN1	20
1204 # define CONV_LATIN1_MAC	21
1205 # define CONV_MAC_UTF8		22
1206 # define CONV_UTF8_MAC		23
1207 #endif
1208 
1209 /*
1210  * Structure used for mappings and abbreviations.
1211  */
1212 typedef struct mapblock mapblock_T;
1213 struct mapblock
1214 {
1215     mapblock_T	*m_next;	// next mapblock in list
1216     char_u	*m_keys;	// mapped from, lhs
1217     char_u	*m_str;		// mapped to, rhs
1218     char_u	*m_orig_str;	// rhs as entered by the user
1219     int		m_keylen;	// strlen(m_keys)
1220     int		m_mode;		// valid mode
1221     int		m_simplified;	// m_keys was simplified, do not use this map
1222 				// if seenModifyOtherKeys is TRUE
1223     int		m_noremap;	// if non-zero no re-mapping for m_str
1224     char	m_silent;	// <silent> used, don't echo commands
1225     char	m_nowait;	// <nowait> used
1226 #ifdef FEAT_EVAL
1227     char	m_expr;		// <expr> used, m_str is an expression
1228     sctx_T	m_script_ctx;	// SCTX where map was defined
1229 #endif
1230 };
1231 
1232 
1233 /*
1234  * Used for highlighting in the status line.
1235  */
1236 typedef struct
1237 {
1238     char_u	*start;
1239     int		userhl;		// 0: no HL, 1-9: User HL, < 0 for syn ID
1240 } stl_hlrec_T;
1241 
1242 
1243 /*
1244  * Syntax items - usually buffer-specific.
1245  */
1246 
1247 /*
1248  * Item for a hashtable.  "hi_key" can be one of three values:
1249  * NULL:	   Never been used
1250  * HI_KEY_REMOVED: Entry was removed
1251  * Otherwise:	   Used item, pointer to the actual key; this usually is
1252  *		   inside the item, subtract an offset to locate the item.
1253  *		   This reduces the size of hashitem by 1/3.
1254  */
1255 typedef struct hashitem_S
1256 {
1257     long_u	hi_hash;	// cached hash number of hi_key
1258     char_u	*hi_key;
1259 } hashitem_T;
1260 
1261 // The address of "hash_removed" is used as a magic number for hi_key to
1262 // indicate a removed item.
1263 #define HI_KEY_REMOVED &hash_removed
1264 #define HASHITEM_EMPTY(hi) ((hi)->hi_key == NULL || (hi)->hi_key == &hash_removed)
1265 
1266 // Initial size for a hashtable.  Our items are relatively small and growing
1267 // is expensive, thus use 16 as a start.  Must be a power of 2.
1268 // This allows for storing 10 items (2/3 of 16) before a resize is needed.
1269 #define HT_INIT_SIZE 16
1270 
1271 typedef struct hashtable_S
1272 {
1273     long_u	ht_mask;	// mask used for hash value (nr of items in
1274 				// array is "ht_mask" + 1)
1275     long_u	ht_used;	// number of items used
1276     long_u	ht_filled;	// number of items used + removed
1277     int		ht_changed;	// incremented when adding or removing an item
1278     int		ht_locked;	// counter for hash_lock()
1279     int		ht_error;	// when set growing failed, can't add more
1280 				// items before growing works
1281     hashitem_T	*ht_array;	// points to the array, allocated when it's
1282 				// not "ht_smallarray"
1283     hashitem_T	ht_smallarray[HT_INIT_SIZE];   // initial array
1284 } hashtab_T;
1285 
1286 typedef long_u hash_T;		// Type for hi_hash
1287 
1288 
1289 // Use 64-bit Number.
1290 #ifdef MSWIN
1291 # ifdef PROTO
1292    // workaround for cproto that doesn't recognize __int64
1293    typedef long			varnumber_T;
1294    typedef unsigned long	uvarnumber_T;
1295 #  define VARNUM_MIN		LONG_MIN
1296 #  define VARNUM_MAX		LONG_MAX
1297 #  define UVARNUM_MAX		ULONG_MAX
1298 # else
1299    typedef __int64		varnumber_T;
1300    typedef unsigned __int64	uvarnumber_T;
1301 #  define VARNUM_MIN		_I64_MIN
1302 #  define VARNUM_MAX		_I64_MAX
1303 #  define UVARNUM_MAX		_UI64_MAX
1304 # endif
1305 #elif defined(HAVE_NO_LONG_LONG)
1306 # if defined(HAVE_STDINT_H)
1307    typedef int64_t		varnumber_T;
1308    typedef uint64_t		uvarnumber_T;
1309 #  define VARNUM_MIN		INT64_MIN
1310 #  define VARNUM_MAX		INT64_MAX
1311 #  define UVARNUM_MAX		UINT64_MAX
1312 # else
1313    // this may cause trouble for code that depends on 64 bit ints
1314    typedef long			varnumber_T;
1315    typedef unsigned long	uvarnumber_T;
1316 #  define VARNUM_MIN		LONG_MIN
1317 #  define VARNUM_MAX		LONG_MAX
1318 #  define UVARNUM_MAX		ULONG_MAX
1319 # endif
1320 #else
1321   typedef long long		varnumber_T;
1322   typedef unsigned long long	uvarnumber_T;
1323 # ifdef LLONG_MIN
1324 #  define VARNUM_MIN		LLONG_MIN
1325 #  define VARNUM_MAX		LLONG_MAX
1326 #  define UVARNUM_MAX		ULLONG_MAX
1327 # else
1328 #  define VARNUM_MIN		LONG_LONG_MIN
1329 #  define VARNUM_MAX		LONG_LONG_MAX
1330 #  define UVARNUM_MAX		ULONG_LONG_MAX
1331 # endif
1332 #endif
1333 
1334 // On rare systems "char" is unsigned, sometimes we really want a signed 8-bit
1335 // value.
1336 typedef signed char int8_T;
1337 
1338 typedef double	float_T;
1339 
1340 typedef struct listvar_S list_T;
1341 typedef struct dictvar_S dict_T;
1342 typedef struct partial_S partial_T;
1343 typedef struct blobvar_S blob_T;
1344 
1345 // Struct that holds both a normal function name and a partial_T, as used for a
1346 // callback argument.
1347 // When used temporarily "cb_name" is not allocated.  The refcounts to either
1348 // the function or the partial are incremented and need to be decremented
1349 // later with free_callback().
1350 typedef struct {
1351     char_u	*cb_name;
1352     partial_T	*cb_partial;
1353     int		cb_free_name;	    // cb_name was allocated
1354 } callback_T;
1355 
1356 typedef struct isn_S isn_T;	    // instruction
1357 typedef struct dfunc_S dfunc_T;	    // :def function
1358 
1359 typedef struct jobvar_S job_T;
1360 typedef struct readq_S readq_T;
1361 typedef struct writeq_S writeq_T;
1362 typedef struct jsonq_S jsonq_T;
1363 typedef struct cbq_S cbq_T;
1364 typedef struct channel_S channel_T;
1365 typedef struct cctx_S cctx_T;
1366 
1367 typedef enum
1368 {
1369     VAR_UNKNOWN = 0,	// not set, any type or "void" allowed
1370     VAR_ANY,		// used for "any" type
1371     VAR_VOID,		// no value (function not returning anything)
1372     VAR_BOOL,		// "v_number" is used: VVAL_TRUE or VVAL_FALSE
1373     VAR_SPECIAL,	// "v_number" is used: VVAL_NULL or VVAL_NONE
1374     VAR_NUMBER,		// "v_number" is used
1375     VAR_FLOAT,		// "v_float" is used
1376     VAR_STRING,		// "v_string" is used
1377     VAR_BLOB,		// "v_blob" is used
1378     VAR_FUNC,		// "v_string" is function name
1379     VAR_PARTIAL,	// "v_partial" is used
1380     VAR_LIST,		// "v_list" is used
1381     VAR_DICT,		// "v_dict" is used
1382     VAR_JOB,		// "v_job" is used
1383     VAR_CHANNEL,	// "v_channel" is used
1384 } vartype_T;
1385 
1386 // A type specification.
1387 typedef struct type_S type_T;
1388 struct type_S {
1389     vartype_T	    tt_type;
1390     int8_T	    tt_argcount;    // for func, incl. vararg, -1 for unknown
1391     char	    tt_min_argcount; // number of non-optional arguments
1392     char	    tt_flags;	    // TTFLAG_ values
1393     type_T	    *tt_member;	    // for list, dict, func return type
1394     type_T	    **tt_args;	    // func argument types, allocated
1395 };
1396 
1397 #define TTFLAG_VARARGS	1	    // func args ends with "..."
1398 #define TTFLAG_OPTARG	2	    // func arg type with "?"
1399 #define TTFLAG_BOOL_OK	4	    // can be converted to bool
1400 #define TTFLAG_STATIC	8	    // one of the static types, e.g. t_any
1401 
1402 /*
1403  * Structure to hold an internal variable without a name.
1404  */
1405 typedef struct
1406 {
1407     vartype_T	v_type;
1408     char	v_lock;	    // see below: VAR_LOCKED, VAR_FIXED
1409     union
1410     {
1411 	varnumber_T	v_number;	// number value
1412 #ifdef FEAT_FLOAT
1413 	float_T		v_float;	// floating number value
1414 #endif
1415 	char_u		*v_string;	// string value (can be NULL!)
1416 	list_T		*v_list;	// list value (can be NULL!)
1417 	dict_T		*v_dict;	// dict value (can be NULL!)
1418 	partial_T	*v_partial;	// closure: function with args
1419 #ifdef FEAT_JOB_CHANNEL
1420 	job_T		*v_job;		// job value (can be NULL!)
1421 	channel_T	*v_channel;	// channel value (can be NULL!)
1422 #endif
1423 	blob_T		*v_blob;	// blob value (can be NULL!)
1424     }		vval;
1425 } typval_T;
1426 
1427 // Values for "dv_scope".
1428 #define VAR_SCOPE     1	// a:, v:, s:, etc. scope dictionaries
1429 #define VAR_DEF_SCOPE 2	// l:, g: scope dictionaries: here funcrefs are not
1430 			// allowed to mask existing functions
1431 
1432 // Values for "v_lock".
1433 #define VAR_LOCKED	1	// locked with lock(), can use unlock()
1434 #define VAR_FIXED	2	// locked forever
1435 
1436 /*
1437  * Structure to hold an item of a list: an internal variable without a name.
1438  */
1439 typedef struct listitem_S listitem_T;
1440 
1441 struct listitem_S
1442 {
1443     listitem_T	*li_next;	// next item in list
1444     listitem_T	*li_prev;	// previous item in list
1445     typval_T	li_tv;		// type and value of the variable
1446 };
1447 
1448 // Struct used by those that are using an item in a list.
1449 typedef struct listwatch_S listwatch_T;
1450 
1451 struct listwatch_S
1452 {
1453     listitem_T		*lw_item;	// item being watched
1454     listwatch_T		*lw_next;	// next watcher
1455 };
1456 
1457 /*
1458  * Structure to hold info about a list.
1459  * Order of members is optimized to reduce padding.
1460  * When created by range() it will at first have special value:
1461  *  lv_first == &range_list_item;
1462  * and use lv_start, lv_end, lv_stride.
1463  */
1464 struct listvar_S
1465 {
1466     listitem_T	*lv_first;	// first item, NULL if none
1467     listwatch_T	*lv_watch;	// first watcher, NULL if none
1468     union {
1469 	struct {	// used for non-materialized range list:
1470 			// "lv_first" is &range_list_item
1471 	    varnumber_T lv_start;
1472 	    varnumber_T lv_end;
1473 	    int		lv_stride;
1474 	} nonmat;
1475 	struct {	// used for materialized list
1476 	    listitem_T	*lv_last;	// last item, NULL if none
1477 	    listitem_T	*lv_idx_item;	// when not NULL item at index "lv_idx"
1478 	    int		lv_idx;		// cached index of an item
1479 	} mat;
1480     } lv_u;
1481     list_T	*lv_copylist;	// copied list used by deepcopy()
1482     list_T	*lv_used_next;	// next list in used lists list
1483     list_T	*lv_used_prev;	// previous list in used lists list
1484     int		lv_refcount;	// reference count
1485     int		lv_len;		// number of items
1486     int		lv_with_items;	// number of items following this struct that
1487 				// should not be freed
1488     int		lv_copyID;	// ID used by deepcopy()
1489     char	lv_lock;	// zero, VAR_LOCKED, VAR_FIXED
1490 };
1491 
1492 /*
1493  * Static list with 10 items.  Use init_static_list() to initialize.
1494  */
1495 typedef struct {
1496     list_T	sl_list;	// must be first
1497     listitem_T	sl_items[10];
1498 } staticList10_T;
1499 
1500 /*
1501  * Structure to hold an item of a Dictionary.
1502  * Also used for a variable.
1503  * The key is copied into "di_key" to avoid an extra alloc/free for it.
1504  */
1505 struct dictitem_S
1506 {
1507     typval_T	di_tv;		// type and value of the variable
1508     char_u	di_flags;	// DI_FLAGS_ flags (only used for variable)
1509     char_u	di_key[1];	// key (actually longer!)
1510 };
1511 typedef struct dictitem_S dictitem_T;
1512 
1513 /*
1514  * A dictitem with a 16 character key (plus NUL).  This is an efficient way to
1515  * have a fixed-size dictitem.
1516  */
1517 #define DICTITEM16_KEY_LEN 16
1518 struct dictitem16_S
1519 {
1520     typval_T	di_tv;		// type and value of the variable
1521     char_u	di_flags;	// DI_FLAGS_ flags (only used for variable)
1522     char_u	di_key[DICTITEM16_KEY_LEN + 1];	// key
1523 };
1524 typedef struct dictitem16_S dictitem16_T;
1525 
1526 // Flags for "di_flags"
1527 #define DI_FLAGS_RO	   0x01	    // read-only variable
1528 #define DI_FLAGS_RO_SBX	   0x02	    // read-only in the sandbox
1529 #define DI_FLAGS_FIX	   0x04	    // fixed: no :unlet or remove()
1530 #define DI_FLAGS_LOCK	   0x08	    // locked variable
1531 #define DI_FLAGS_ALLOC	   0x10	    // separately allocated
1532 #define DI_FLAGS_RELOAD	   0x20	    // set when script sourced again
1533 
1534 /*
1535  * Structure to hold info about a Dictionary.
1536  */
1537 struct dictvar_S
1538 {
1539     char	dv_lock;	// zero, VAR_LOCKED, VAR_FIXED
1540     char	dv_scope;	// zero, VAR_SCOPE, VAR_DEF_SCOPE
1541     int		dv_refcount;	// reference count
1542     int		dv_copyID;	// ID used by deepcopy()
1543     hashtab_T	dv_hashtab;	// hashtab that refers to the items
1544     dict_T	*dv_copydict;	// copied dict used by deepcopy()
1545     dict_T	*dv_used_next;	// next dict in used dicts list
1546     dict_T	*dv_used_prev;	// previous dict in used dicts list
1547 };
1548 
1549 /*
1550  * Structure to hold info about a blob.
1551  */
1552 struct blobvar_S
1553 {
1554     garray_T	bv_ga;		// growarray with the data
1555     int		bv_refcount;	// reference count
1556     char	bv_lock;	// zero, VAR_LOCKED, VAR_FIXED
1557 };
1558 
1559 typedef int (*cfunc_T)(int argcount, typval_T *argvars, typval_T *rettv, void *state);
1560 typedef void (*cfunc_free_T)(void *state);
1561 
1562 // type of getline() last argument
1563 typedef enum {
1564     GETLINE_NONE,	    // do not concatenate any lines
1565     GETLINE_CONCAT_CONT,    // concatenate continuation lines
1566     GETLINE_CONCAT_ALL	    // concatenate continuation and Vim9 # comment lines
1567 } getline_opt_T;
1568 
1569 #if defined(FEAT_EVAL) || defined(PROTO)
1570 typedef struct funccall_S funccall_T;
1571 
1572 // values used for "uf_dfunc_idx"
1573 typedef enum {
1574     UF_NOT_COMPILED,
1575     UF_TO_BE_COMPILED,
1576     UF_COMPILING,
1577     UF_COMPILED
1578 } def_status_T;
1579 
1580 /*
1581  * Structure to hold info for a user function.
1582  * When adding a field check copy_func().
1583  */
1584 typedef struct
1585 {
1586     int		uf_varargs;	// variable nr of arguments (old style)
1587     int		uf_flags;	// FC_ flags
1588     int		uf_calls;	// nr of active calls
1589     int		uf_cleared;	// func_clear() was already called
1590     def_status_T uf_def_status; // UF_NOT_COMPILED, UF_TO_BE_COMPILED, etc.
1591     int		uf_dfunc_idx;	// only valid if uf_def_status is UF_COMPILED
1592     garray_T	uf_args;	// arguments, including optional arguments
1593     garray_T	uf_def_args;	// default argument expressions
1594 
1595     // for :def (for :function uf_ret_type is NULL)
1596     type_T	**uf_arg_types;	// argument types (count == uf_args.ga_len)
1597     type_T	*uf_ret_type;	// return type
1598     garray_T	uf_type_list;	// types used in arg and return types
1599     int		*uf_def_arg_idx; // instruction indexes for evaluating
1600 				// uf_def_args; length: uf_def_args.ga_len + 1
1601     char_u	*uf_va_name;	// name from "...name" or NULL
1602     type_T	*uf_va_type;	// type from "...name: type" or NULL
1603     type_T	*uf_func_type;	// type of the function, &t_func_any if unknown
1604     int		uf_block_depth;	// nr of entries in uf_block_ids
1605     int		*uf_block_ids;	// blocks a :def function is defined inside
1606 # if defined(FEAT_LUA)
1607     cfunc_T     uf_cb;		// callback function for cfunc
1608     cfunc_free_T uf_cb_free;    // callback function to free cfunc
1609     void        *uf_cb_state;   // state of uf_cb
1610 # endif
1611 
1612     garray_T	uf_lines;	// function lines
1613 # ifdef FEAT_PROFILE
1614     int		uf_profiling;	// TRUE when func is being profiled
1615     int		uf_prof_initialized;
1616     // profiling the function as a whole
1617     int		uf_tm_count;	// nr of calls
1618     proftime_T	uf_tm_total;	// time spent in function + children
1619     proftime_T	uf_tm_self;	// time spent in function itself
1620     proftime_T	uf_tm_children;	// time spent in children this call
1621     // profiling the function per line
1622     int		*uf_tml_count;	// nr of times line was executed
1623     proftime_T	*uf_tml_total;	// time spent in a line + children
1624     proftime_T	*uf_tml_self;	// time spent in a line itself
1625     proftime_T	uf_tml_start;	// start time for current line
1626     proftime_T	uf_tml_children; // time spent in children for this line
1627     proftime_T	uf_tml_wait;	// start wait time for current line
1628     int		uf_tml_idx;	// index of line being timed; -1 if none
1629     int		uf_tml_execed;	// line being timed was executed
1630 # endif
1631     sctx_T	uf_script_ctx;	// SCTX where function was defined,
1632 				// used for s: variables; sc_version changed
1633 				// for :function
1634     int		uf_script_ctx_version;  // original sc_version of SCTX
1635     int		uf_refcount;	// reference count, see func_name_refcount()
1636 
1637     funccall_T	*uf_scoped;	// l: local variables for closure
1638 
1639     char_u	*uf_name_exp;	// if "uf_name[]" starts with SNR the name with
1640 				// "<SNR>" as a string, otherwise NULL
1641     char_u	uf_name[1];	// name of function (actually longer); can
1642 				// start with <SNR>123_ (<SNR> is K_SPECIAL
1643 				// KS_EXTRA KE_SNR)
1644 } ufunc_T;
1645 
1646 // flags used in uf_flags
1647 #define FC_ABORT    0x01	// abort function on error
1648 #define FC_RANGE    0x02	// function accepts range
1649 #define FC_DICT	    0x04	// Dict function, uses "self"
1650 #define FC_CLOSURE  0x08	// closure, uses outer scope variables
1651 #define FC_DELETED  0x10	// :delfunction used while uf_refcount > 0
1652 #define FC_REMOVED  0x20	// function redefined while uf_refcount > 0
1653 #define FC_SANDBOX  0x40	// function defined in the sandbox
1654 #define FC_DEAD	    0x80	// function kept only for reference to dfunc
1655 #define FC_EXPORT   0x100	// "export def Func()"
1656 #define FC_NOARGS   0x200	// no a: variables in lambda
1657 #define FC_VIM9	    0x400	// defined in vim9 script file
1658 #define FC_CFUNC    0x800	// defined as Lua C func
1659 #define FC_COPY	    0x1000	// copy of another function by copy_func()
1660 
1661 #define MAX_FUNC_ARGS	20	// maximum number of function arguments
1662 #define VAR_SHORT_LEN	20	// short variable name length
1663 #define FIXVAR_CNT	12	// number of fixed variables
1664 
1665 /*
1666  * Structure to hold info for a function that is currently being executed.
1667  */
1668 struct funccall_S
1669 {
1670     ufunc_T	*func;		// function being called
1671     int		linenr;		// next line to be executed
1672     int		returned;	// ":return" used
1673     struct			// fixed variables for arguments
1674     {
1675 	dictitem_T	var;		// variable (without room for name)
1676 	char_u	room[VAR_SHORT_LEN];	// room for the name
1677     } fixvar[FIXVAR_CNT];
1678     dict_T	l_vars;		// l: local function variables
1679     dictitem_T	l_vars_var;	// variable for l: scope
1680     dict_T	l_avars;	// a: argument variables
1681     dictitem_T	l_avars_var;	// variable for a: scope
1682     list_T	l_varlist;	// list for a:000
1683     listitem_T	l_listitems[MAX_FUNC_ARGS];	// listitems for a:000
1684     typval_T	*rettv;		// return value
1685     linenr_T	breakpoint;	// next line with breakpoint or zero
1686     int		dbg_tick;	// debug_tick when breakpoint was set
1687     int		level;		// top nesting level of executed function
1688 #ifdef FEAT_PROFILE
1689     proftime_T	prof_child;	// time spent in a child
1690 #endif
1691     funccall_T	*caller;	// calling function or NULL
1692 
1693     // for closure
1694     int		fc_refcount;	// number of user functions that reference this
1695 				// funccal
1696     int		fc_copyID;	// for garbage collection
1697     garray_T	fc_funcs;	// list of ufunc_T* which keep a reference to
1698 				// "func"
1699 };
1700 
1701 /*
1702  * Struct used by trans_function_name()
1703  */
1704 typedef struct
1705 {
1706     dict_T	*fd_dict;	// Dictionary used
1707     char_u	*fd_newkey;	// new key in "dict" in allocated memory
1708     dictitem_T	*fd_di;		// Dictionary item used
1709 } funcdict_T;
1710 
1711 typedef struct funccal_entry funccal_entry_T;
1712 struct funccal_entry {
1713     void	    *top_funccal;
1714     funccal_entry_T *next;
1715 };
1716 
1717 // From user function to hashitem and back.
1718 #define UF2HIKEY(fp) ((fp)->uf_name)
1719 #define HIKEY2UF(p)  ((ufunc_T *)((p) - offsetof(ufunc_T, uf_name)))
1720 #define HI2UF(hi)     HIKEY2UF((hi)->hi_key)
1721 
1722 /*
1723  * Holds the hashtab with variables local to each sourced script.
1724  * Each item holds a variable (nameless) that points to the dict_T.
1725  */
1726 typedef struct {
1727     dictitem_T	sv_var;
1728     dict_T	sv_dict;
1729 } scriptvar_T;
1730 
1731 /*
1732  * Entry for "sn_all_vars".  Contains the s: variables from sn_vars plus the
1733  * block-local ones.
1734  */
1735 typedef struct sallvar_S sallvar_T;
1736 struct sallvar_S {
1737     sallvar_T	*sav_next;	  // var with same name but different block
1738     int		sav_block_id;	  // block ID where declared
1739     int		sav_var_vals_idx; // index in sn_var_vals
1740 
1741     // So long as the variable is valid (block it was defined in is still
1742     // active) "sav_di" is used.  It is set to NULL when leaving the block,
1743     // then sav_tv and sav_flags are used.
1744     dictitem_T *sav_di;		// dictitem with di_key and di_tv
1745     typval_T	sav_tv;		// type and value of the variable
1746     char_u	sav_flags;	// DI_FLAGS_ flags (only used for variable)
1747     char_u	sav_key[1];	// key (actually longer!)
1748 };
1749 
1750 /*
1751  * In the sn_all_vars hashtab item "hi_key" points to "sav_key" in a sallvar_T.
1752  * This makes it possible to store and find the sallvar_T.
1753  * SAV2HIKEY() converts a sallvar_T pointer to a hashitem key pointer.
1754  * HIKEY2SAV() converts a hashitem key pointer to a sallvar_T pointer.
1755  * HI2SAV() converts a hashitem pointer to a sallvar_T pointer.
1756  */
1757 #define SAV2HIKEY(sav) ((sav)->sav_key)
1758 #define HIKEY2SAV(p)  ((sallvar_T *)(p - offsetof(sallvar_T, sav_key)))
1759 #define HI2SAV(hi)     HIKEY2SAV((hi)->hi_key)
1760 
1761 /*
1762  * Entry for "sn_var_vals".  Used for script-local variables.
1763  */
1764 typedef struct {
1765     char_u	*sv_name;	// points into "sn_all_vars" di_key
1766     typval_T	*sv_tv;		// points into "sn_vars" or "sn_all_vars" di_tv
1767     type_T	*sv_type;
1768     int		sv_const;
1769     int		sv_export;	// "export let var = val"
1770 } svar_T;
1771 
1772 typedef struct {
1773     char_u	*imp_name;	    // name imported as (allocated)
1774     int		imp_sid;	    // script ID of "from"
1775 
1776     // for "import * as Name", "imp_name" is "Name"
1777     int		imp_all;
1778 
1779     // for variable
1780     type_T	*imp_type;
1781     int		imp_var_vals_idx;   // index in sn_var_vals of "from"
1782 
1783     // for function
1784     char_u	*imp_funcname;	    // user func name (NOT allocated)
1785 } imported_T;
1786 
1787 /*
1788  * Growarray to store info about already sourced scripts.
1789  * For Unix also store the dev/ino, so that we don't have to stat() each
1790  * script when going through the list.
1791  */
1792 typedef struct
1793 {
1794     char_u	*sn_name;
1795 
1796     // "sn_vars" stores the s: variables currently valid.  When leaving a block
1797     // variables local to that block are removed.
1798     scriptvar_T	*sn_vars;
1799 
1800     // Specific for a Vim9 script.
1801     // "sn_all_vars" stores all script variables ever declared.  So long as the
1802     // variable is still valid the value is in "sn_vars->sv_dict...di_tv".
1803     // When the block of a declaration is left the value is moved to
1804     // "sn_all_vars..sav_tv".
1805     // Variables with duplicate names are possible, the sav_block_id must be
1806     // used to check that which variable is valid.
1807     dict_T	sn_all_vars;	// all script variables, dict of sallvar_T
1808 
1809     // Stores the same variables as in "sn_all_vars" as a list of svar_T, so
1810     // that they can be quickly found by index instead of a hash table lookup.
1811     // Also stores the type.
1812     garray_T	sn_var_vals;
1813 
1814     garray_T	sn_imports;	// imported items, imported_T
1815     garray_T	sn_type_list;	// keeps types used by variables
1816     int		sn_current_block_id; // ID for current block, 0 for outer
1817     int		sn_last_block_id;  // Unique ID for each script block
1818 
1819     int		sn_version;	// :scriptversion
1820     int		sn_had_command;	// TRUE if any command was executed
1821     char_u	*sn_save_cpo;	// 'cpo' value when :vim9script found
1822 
1823 # ifdef FEAT_PROFILE
1824     int		sn_prof_on;	// TRUE when script is/was profiled
1825     int		sn_pr_force;	// forceit: profile functions in this script
1826     proftime_T	sn_pr_child;	// time set when going into first child
1827     int		sn_pr_nest;	// nesting for sn_pr_child
1828     // profiling the script as a whole
1829     int		sn_pr_count;	// nr of times sourced
1830     proftime_T	sn_pr_total;	// time spent in script + children
1831     proftime_T	sn_pr_self;	// time spent in script itself
1832     proftime_T	sn_pr_start;	// time at script start
1833     proftime_T	sn_pr_children; // time in children after script start
1834     // profiling the script per line
1835     garray_T	sn_prl_ga;	// things stored for every line
1836     proftime_T	sn_prl_start;	// start time for current line
1837     proftime_T	sn_prl_children; // time spent in children for this line
1838     proftime_T	sn_prl_wait;	// wait start time for current line
1839     int		sn_prl_idx;	// index of line being timed; -1 if none
1840     int		sn_prl_execed;	// line being timed was executed
1841 # endif
1842 } scriptitem_T;
1843 
1844 // Struct passed through eval() functions.
1845 // See EVALARG_EVALUATE for a fixed value with eval_flags set to EVAL_EVALUATE.
1846 typedef struct {
1847     int		eval_flags;	    // EVAL_ flag values below
1848     int		eval_break_count;   // nr of line breaks consumed
1849 
1850     // copied from exarg_T when "getline" is "getsourceline". Can be NULL.
1851     char_u	*(*eval_getline)(int, void *, int, getline_opt_T);
1852     void	*eval_cookie;	    // argument for eval_getline()
1853 
1854     // used when compiling a :def function, NULL otherwise
1855     cctx_T	*eval_cctx;
1856 
1857     // Used to collect lines while parsing them, so that they can be
1858     // concatenated later.  Used when "eval_ga.ga_itemsize" is not zero.
1859     // "eval_ga.ga_data" is a list of pointers to lines.
1860     garray_T	eval_ga;
1861 
1862     // pointer to the last line obtained with getsourceline()
1863     char_u	*eval_tofree;
1864 
1865     // pointer to the lines concatenated for a lambda.
1866     char_u	*eval_tofree_lambda;
1867 } evalarg_T;
1868 
1869 // Flags for expression evaluation.
1870 #define EVAL_EVALUATE	    1	    // when missing don't actually evaluate
1871 #define EVAL_CONSTANT	    2	    // when not a constant return FAIL
1872 
1873 # ifdef FEAT_PROFILE
1874 /*
1875  * Struct used in sn_prl_ga for every line of a script.
1876  */
1877 typedef struct sn_prl_S
1878 {
1879     int		snp_count;	// nr of times line was executed
1880     proftime_T	sn_prl_total;	// time spent in a line + children
1881     proftime_T	sn_prl_self;	// time spent in a line itself
1882 } sn_prl_T;
1883 
1884 #  define PRL_ITEM(si, idx)	(((sn_prl_T *)(si)->sn_prl_ga.ga_data)[(idx)])
1885 # endif
1886 #else
1887 // dummy typedefs for use in function prototypes
1888 typedef struct
1889 {
1890     int	    dummy;
1891 } ufunc_T;
1892 typedef struct
1893 {
1894     int	    dummy;
1895 } funccall_T;
1896 typedef struct
1897 {
1898     int	    dummy;
1899 } funcdict_T;
1900 typedef struct
1901 {
1902     int	    dummy;
1903 } funccal_entry_T;
1904 typedef struct
1905 {
1906     int	    dummy;
1907 } scriptitem_T;
1908 typedef struct
1909 {
1910     int	    dummy;
1911 } evalarg_T;
1912 #endif
1913 
1914 // Struct passed between functions dealing with function call execution.
1915 //
1916 // "argv_func", when not NULL, can be used to fill in arguments only when the
1917 // invoked function uses them.  It is called like this:
1918 //   new_argcount = argv_func(current_argcount, argv, partial_argcount,
1919 //							called_func_argcount)
1920 //
1921 typedef struct {
1922     int		(* argv_func)(int, typval_T *, int, int);
1923     linenr_T	firstline;	// first line of range
1924     linenr_T	lastline;	// last line of range
1925     int		*doesrange;	// if not NULL: return: function handled range
1926     int		evaluate;	// actually evaluate expressions
1927     partial_T	*partial;	// for extra arguments
1928     dict_T	*selfdict;	// Dictionary for "self"
1929     typval_T	*basetv;	// base for base->method()
1930 } funcexe_T;
1931 
1932 /*
1933  * Structure to hold the context of a compiled function, used by closures
1934  * defined in that function.
1935  */
1936 typedef struct funcstack_S
1937 {
1938     garray_T	fs_ga;		// contains the stack, with:
1939 				// - arguments
1940 				// - frame
1941 				// - local variables
1942     int		fs_var_offset;	// count of arguments + frame size == offset to
1943 				// local variables
1944 
1945     int		fs_refcount;	// nr of closures referencing this funcstack
1946     int		fs_min_refcount; // nr of closures on this funcstack
1947     int		fs_copyID;	// for garray_T collection
1948 } funcstack_T;
1949 
1950 struct partial_S
1951 {
1952     int		pt_refcount;	// reference count
1953     char_u	*pt_name;	// function name; when NULL use
1954 				// pt_func->uf_name
1955     ufunc_T	*pt_func;	// function pointer; when NULL lookup function
1956 				// with pt_name
1957     int		pt_auto;	// when TRUE the partial was created for using
1958 				// dict.member in handle_subscript()
1959 
1960     // For a compiled closure: the arguments and local variables.
1961     garray_T	*pt_ectx_stack;	    // where to find local vars
1962     int		pt_ectx_frame;	    // index of function frame in uf_ectx_stack
1963     funcstack_T	*pt_funcstack;	    // copy of stack, used after context
1964 				    // function returns
1965 
1966     int		pt_argc;	// number of arguments
1967     typval_T	*pt_argv;	// arguments in allocated array
1968 
1969     dict_T	*pt_dict;	// dict for "self"
1970     int		pt_copyID;	// funcstack may contain pointer to partial
1971 };
1972 
1973 typedef struct AutoPatCmd_S AutoPatCmd;
1974 
1975 /*
1976  * Entry in the execution stack "exestack".
1977  */
1978 typedef enum {
1979     ETYPE_TOP,		    // toplevel
1980     ETYPE_SCRIPT,           // sourcing script, use es_info.sctx
1981     ETYPE_UFUNC,            // user function, use es_info.ufunc
1982     ETYPE_AUCMD,            // autocomand, use es_info.aucmd
1983     ETYPE_MODELINE,         // modeline, use es_info.sctx
1984     ETYPE_EXCEPT,           // exception, use es_info.exception
1985     ETYPE_ARGS,             // command line argument
1986     ETYPE_ENV,              // environment variable
1987     ETYPE_INTERNAL,         // internal operation
1988     ETYPE_SPELL,            // loading spell file
1989 } etype_T;
1990 
1991 typedef struct {
1992     long      es_lnum;      // replaces "sourcing_lnum"
1993     char_u    *es_name;     // replaces "sourcing_name"
1994     etype_T   es_type;
1995     union {
1996 	sctx_T  *sctx;      // script and modeline info
1997 #if defined(FEAT_EVAL)
1998 	ufunc_T *ufunc;     // function info
1999 #endif
2000 	AutoPatCmd *aucmd;  // autocommand info
2001 	except_T   *except; // exception info
2002     } es_info;
2003 #if defined(FEAT_EVAL)
2004     scid_T	es_save_sid;	    // saved sc_sid when calling function
2005 #endif
2006 } estack_T;
2007 
2008 // Information returned by get_tty_info().
2009 typedef struct {
2010     int backspace;	// what the Backspace key produces
2011     int enter;		// what the Enter key produces
2012     int interrupt;	// interrupt character
2013     int nl_does_cr;	// TRUE when a NL is expanded to CR-NL on output
2014 } ttyinfo_T;
2015 
2016 // Status of a job.  Order matters!
2017 typedef enum
2018 {
2019     JOB_FAILED,
2020     JOB_STARTED,
2021     JOB_ENDED,	    // detected job done
2022     JOB_FINISHED,   // job done and cleanup done
2023 } jobstatus_T;
2024 
2025 /*
2026  * Structure to hold info about a Job.
2027  */
2028 struct jobvar_S
2029 {
2030     job_T	*jv_next;
2031     job_T	*jv_prev;
2032 #ifdef UNIX
2033     pid_t	jv_pid;
2034 #endif
2035 #ifdef MSWIN
2036     PROCESS_INFORMATION	jv_proc_info;
2037     HANDLE		jv_job_object;
2038 #endif
2039     char_u	*jv_tty_in;	// controlling tty input, allocated
2040     char_u	*jv_tty_out;	// controlling tty output, allocated
2041     jobstatus_T	jv_status;
2042     char_u	*jv_stoponexit;	// allocated
2043 #ifdef UNIX
2044     char_u	*jv_termsig;	// allocated
2045 #endif
2046 #ifdef MSWIN
2047     char_u	*jv_tty_type;	// allocated
2048 #endif
2049     int		jv_exitval;
2050     callback_T	jv_exit_cb;
2051 
2052     buf_T	*jv_in_buf;	// buffer from "in-name"
2053 
2054     int		jv_refcount;	// reference count
2055     int		jv_copyID;
2056 
2057     channel_T	*jv_channel;	// channel for I/O, reference counted
2058     char	**jv_argv;	// command line used to start the job
2059 };
2060 
2061 /*
2062  * Structures to hold info about a Channel.
2063  */
2064 struct readq_S
2065 {
2066     char_u	*rq_buffer;
2067     long_u	rq_buflen;
2068     readq_T	*rq_next;
2069     readq_T	*rq_prev;
2070 };
2071 
2072 struct writeq_S
2073 {
2074     garray_T	wq_ga;
2075     writeq_T	*wq_next;
2076     writeq_T	*wq_prev;
2077 };
2078 
2079 struct jsonq_S
2080 {
2081     typval_T	*jq_value;
2082     jsonq_T	*jq_next;
2083     jsonq_T	*jq_prev;
2084     int		jq_no_callback; // TRUE when no callback was found
2085 };
2086 
2087 struct cbq_S
2088 {
2089     callback_T	cq_callback;
2090     int		cq_seq_nr;
2091     cbq_T	*cq_next;
2092     cbq_T	*cq_prev;
2093 };
2094 
2095 // mode for a channel
2096 typedef enum
2097 {
2098     MODE_NL = 0,
2099     MODE_RAW,
2100     MODE_JSON,
2101     MODE_JS,
2102 } ch_mode_T;
2103 
2104 typedef enum {
2105     JIO_PIPE,	    // default
2106     JIO_NULL,
2107     JIO_FILE,
2108     JIO_BUFFER,
2109     JIO_OUT
2110 } job_io_T;
2111 
2112 #define CH_PART_FD(part)	ch_part[part].ch_fd
2113 
2114 // Ordering matters, it is used in for loops: IN is last, only SOCK/OUT/ERR
2115 // are polled.
2116 typedef enum {
2117     PART_SOCK = 0,
2118 #define CH_SOCK_FD	CH_PART_FD(PART_SOCK)
2119 #ifdef FEAT_JOB_CHANNEL
2120     PART_OUT,
2121 # define CH_OUT_FD	CH_PART_FD(PART_OUT)
2122     PART_ERR,
2123 # define CH_ERR_FD	CH_PART_FD(PART_ERR)
2124     PART_IN,
2125 # define CH_IN_FD	CH_PART_FD(PART_IN)
2126 #endif
2127     PART_COUNT,
2128 } ch_part_T;
2129 
2130 #define INVALID_FD	(-1)
2131 
2132 // The per-fd info for a channel.
2133 typedef struct {
2134     sock_T	ch_fd;	    // socket/stdin/stdout/stderr, -1 if not used
2135 
2136 # if defined(UNIX) && !defined(HAVE_SELECT)
2137     int		ch_poll_idx;	// used by channel_poll_setup()
2138 # endif
2139 
2140 #ifdef FEAT_GUI_X11
2141     XtInputId	ch_inputHandler; // Cookie for input
2142 #endif
2143 #ifdef FEAT_GUI_GTK
2144     gint	ch_inputHandler; // Cookie for input
2145 #endif
2146 
2147     ch_mode_T	ch_mode;
2148     job_io_T	ch_io;
2149     int		ch_timeout;	// request timeout in msec
2150 
2151     readq_T	ch_head;	// header for circular raw read queue
2152     jsonq_T	ch_json_head;	// header for circular json read queue
2153     garray_T	ch_block_ids;	// list of IDs that channel_read_json_block()
2154 				// is waiting for
2155     // When ch_wait_len is non-zero use ch_deadline to wait for incomplete
2156     // message to be complete. The value is the length of the incomplete
2157     // message when the deadline was set.  If it gets longer (something was
2158     // received) the deadline is reset.
2159     size_t	ch_wait_len;
2160 #ifdef MSWIN
2161     DWORD	ch_deadline;
2162 #else
2163     struct timeval ch_deadline;
2164 #endif
2165     int		ch_block_write;	// for testing: 0 when not used, -1 when write
2166 				// does not block, 1 simulate blocking
2167     int		ch_nonblocking;	// write() is non-blocking
2168     writeq_T	ch_writeque;	// header for write queue
2169 
2170     cbq_T	ch_cb_head;	// dummy node for per-request callbacks
2171     callback_T	ch_callback;	// call when a msg is not handled
2172 
2173     bufref_T	ch_bufref;	// buffer to read from or write to
2174     int		ch_nomodifiable; // TRUE when buffer can be 'nomodifiable'
2175     int		ch_nomod_error;	// TRUE when e_modifiable was given
2176     int		ch_buf_append;	// write appended lines instead top-bot
2177     linenr_T	ch_buf_top;	// next line to send
2178     linenr_T	ch_buf_bot;	// last line to send
2179 } chanpart_T;
2180 
2181 struct channel_S {
2182     channel_T	*ch_next;
2183     channel_T	*ch_prev;
2184 
2185     int		ch_id;		// ID of the channel
2186     int		ch_last_msg_id;	// ID of the last message
2187 
2188     chanpart_T	ch_part[PART_COUNT]; // info for socket, out, err and in
2189     int		ch_write_text_mode; // write buffer lines with CR, not NL
2190 
2191     char	*ch_hostname;	// only for socket, allocated
2192     int		ch_port;	// only for socket
2193 
2194     int		ch_to_be_closed; // bitset of readable fds to be closed.
2195 				 // When all readable fds have been closed,
2196 				 // set to (1 << PART_COUNT).
2197     int		ch_to_be_freed; // When TRUE channel must be freed when it's
2198 				// safe to invoke callbacks.
2199     int		ch_error;	// When TRUE an error was reported.  Avoids
2200 				// giving pages full of error messages when
2201 				// the other side has exited, only mention the
2202 				// first error until the connection works
2203 				// again.
2204 
2205     void	(*ch_nb_close_cb)(void);
2206 				// callback for Netbeans when channel is
2207 				// closed
2208 
2209 #ifdef MSWIN
2210     int		ch_named_pipe;	// using named pipe instead of pty
2211 #endif
2212     callback_T	ch_callback;	// call when any msg is not handled
2213     callback_T	ch_close_cb;	// call when channel is closed
2214     int		ch_drop_never;
2215     int		ch_keep_open;	// do not close on read error
2216     int		ch_nonblock;
2217 
2218     job_T	*ch_job;	// Job that uses this channel; this does not
2219 				// count as a reference to avoid a circular
2220 				// reference, the job refers to the channel.
2221     int		ch_job_killed;	// TRUE when there was a job and it was killed
2222 				// or we know it died.
2223     int		ch_anonymous_pipe;  // ConPTY
2224     int		ch_killing;	    // TerminateJobObject() was called
2225 
2226     int		ch_refcount;	// reference count
2227     int		ch_copyID;
2228 };
2229 
2230 #define JO_MODE		    0x0001	// channel mode
2231 #define JO_IN_MODE	    0x0002	// stdin mode
2232 #define JO_OUT_MODE	    0x0004	// stdout mode
2233 #define JO_ERR_MODE	    0x0008	// stderr mode
2234 #define JO_CALLBACK	    0x0010	// channel callback
2235 #define JO_OUT_CALLBACK	    0x0020	// stdout callback
2236 #define JO_ERR_CALLBACK	    0x0040	// stderr callback
2237 #define JO_CLOSE_CALLBACK   0x0080	// "close_cb"
2238 #define JO_WAITTIME	    0x0100	// only for ch_open()
2239 #define JO_TIMEOUT	    0x0200	// all timeouts
2240 #define JO_OUT_TIMEOUT	    0x0400	// stdout timeouts
2241 #define JO_ERR_TIMEOUT	    0x0800	// stderr timeouts
2242 #define JO_PART		    0x1000	// "part"
2243 #define JO_ID		    0x2000	// "id"
2244 #define JO_STOPONEXIT	    0x4000	// "stoponexit"
2245 #define JO_EXIT_CB	    0x8000	// "exit_cb"
2246 #define JO_OUT_IO	    0x10000	// "out_io"
2247 #define JO_ERR_IO	    0x20000	// "err_io" (JO_OUT_IO << 1)
2248 #define JO_IN_IO	    0x40000	// "in_io" (JO_OUT_IO << 2)
2249 #define JO_OUT_NAME	    0x80000	// "out_name"
2250 #define JO_ERR_NAME	    0x100000	// "err_name" (JO_OUT_NAME << 1)
2251 #define JO_IN_NAME	    0x200000	// "in_name" (JO_OUT_NAME << 2)
2252 #define JO_IN_TOP	    0x400000	// "in_top"
2253 #define JO_IN_BOT	    0x800000	// "in_bot"
2254 #define JO_OUT_BUF	    0x1000000	// "out_buf"
2255 #define JO_ERR_BUF	    0x2000000	// "err_buf" (JO_OUT_BUF << 1)
2256 #define JO_IN_BUF	    0x4000000	// "in_buf" (JO_OUT_BUF << 2)
2257 #define JO_CHANNEL	    0x8000000	// "channel"
2258 #define JO_BLOCK_WRITE	    0x10000000	// "block_write"
2259 #define JO_OUT_MODIFIABLE   0x20000000	// "out_modifiable"
2260 #define JO_ERR_MODIFIABLE   0x40000000	// "err_modifiable" (JO_OUT_ << 1)
2261 #define JO_ALL		    0x7fffffff
2262 
2263 #define JO2_OUT_MSG	    0x0001	// "out_msg"
2264 #define JO2_ERR_MSG	    0x0002	// "err_msg" (JO_OUT_ << 1)
2265 #define JO2_TERM_NAME	    0x0004	// "term_name"
2266 #define JO2_TERM_FINISH	    0x0008	// "term_finish"
2267 #define JO2_ENV		    0x0010	// "env"
2268 #define JO2_CWD		    0x0020	// "cwd"
2269 #define JO2_TERM_ROWS	    0x0040	// "term_rows"
2270 #define JO2_TERM_COLS	    0x0080	// "term_cols"
2271 #define JO2_VERTICAL	    0x0100	// "vertical"
2272 #define JO2_CURWIN	    0x0200	// "curwin"
2273 #define JO2_HIDDEN	    0x0400	// "hidden"
2274 #define JO2_TERM_OPENCMD    0x0800	// "term_opencmd"
2275 #define JO2_EOF_CHARS	    0x1000	// "eof_chars"
2276 #define JO2_NORESTORE	    0x2000	// "norestore"
2277 #define JO2_TERM_KILL	    0x4000	// "term_kill"
2278 #define JO2_ANSI_COLORS	    0x8000	// "ansi_colors"
2279 #define JO2_TTY_TYPE	    0x10000	// "tty_type"
2280 #define JO2_BUFNR	    0x20000	// "bufnr"
2281 #define JO2_TERM_API	    0x40000	// "term_api"
2282 #define JO2_TERM_HIGHLIGHT  0x80000	// "highlight"
2283 
2284 #define JO_MODE_ALL	(JO_MODE + JO_IN_MODE + JO_OUT_MODE + JO_ERR_MODE)
2285 #define JO_CB_ALL \
2286     (JO_CALLBACK + JO_OUT_CALLBACK + JO_ERR_CALLBACK + JO_CLOSE_CALLBACK)
2287 #define JO_TIMEOUT_ALL	(JO_TIMEOUT + JO_OUT_TIMEOUT + JO_ERR_TIMEOUT)
2288 
2289 /*
2290  * Options for job and channel commands.
2291  */
2292 typedef struct
2293 {
2294     int		jo_set;		// JO_ bits for values that were set
2295     int		jo_set2;	// JO2_ bits for values that were set
2296 
2297     ch_mode_T	jo_mode;
2298     ch_mode_T	jo_in_mode;
2299     ch_mode_T	jo_out_mode;
2300     ch_mode_T	jo_err_mode;
2301     int		jo_noblock;
2302 
2303     job_io_T	jo_io[4];	// PART_OUT, PART_ERR, PART_IN
2304     char_u	jo_io_name_buf[4][NUMBUFLEN];
2305     char_u	*jo_io_name[4];	// not allocated!
2306     int		jo_io_buf[4];
2307     int		jo_pty;
2308     int		jo_modifiable[4];
2309     int		jo_message[4];
2310     channel_T	*jo_channel;
2311 
2312     linenr_T	jo_in_top;
2313     linenr_T	jo_in_bot;
2314 
2315     callback_T	jo_callback;
2316     callback_T	jo_out_cb;
2317     callback_T	jo_err_cb;
2318     callback_T	jo_close_cb;
2319     callback_T	jo_exit_cb;
2320     int		jo_drop_never;
2321     int		jo_waittime;
2322     int		jo_timeout;
2323     int		jo_out_timeout;
2324     int		jo_err_timeout;
2325     int		jo_block_write;	// for testing only
2326     int		jo_part;
2327     int		jo_id;
2328     char_u	jo_stoponexit_buf[NUMBUFLEN];
2329     char_u	*jo_stoponexit;
2330     dict_T	*jo_env;	// environment variables
2331     char_u	jo_cwd_buf[NUMBUFLEN];
2332     char_u	*jo_cwd;
2333 
2334 #ifdef FEAT_TERMINAL
2335     // when non-zero run the job in a terminal window of this size
2336     int		jo_term_rows;
2337     int		jo_term_cols;
2338     int		jo_vertical;
2339     int		jo_curwin;
2340     buf_T	*jo_bufnr_buf;
2341     int		jo_hidden;
2342     int		jo_term_norestore;
2343     char_u	jo_term_name_buf[NUMBUFLEN];
2344     char_u	*jo_term_name;
2345     char_u	jo_term_opencmd_buf[NUMBUFLEN];
2346     char_u	*jo_term_opencmd;
2347     int		jo_term_finish;
2348     char_u	jo_eof_chars_buf[NUMBUFLEN];
2349     char_u	*jo_eof_chars;
2350     char_u	jo_term_kill_buf[NUMBUFLEN];
2351     char_u	*jo_term_kill;
2352 # if defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS)
2353     long_u	jo_ansi_colors[16];
2354 # endif
2355     char_u	jo_term_highlight_buf[NUMBUFLEN];
2356     char_u	*jo_term_highlight;
2357     int		jo_tty_type;	    // first character of "tty_type"
2358     char_u	jo_term_api_buf[NUMBUFLEN];
2359     char_u	*jo_term_api;
2360 #endif
2361 } jobopt_T;
2362 
2363 #ifdef FEAT_EVAL
2364 /*
2365  * Structure used for listeners added with listener_add().
2366  */
2367 typedef struct listener_S listener_T;
2368 struct listener_S
2369 {
2370     listener_T	*lr_next;
2371     int		lr_id;
2372     callback_T	lr_callback;
2373 };
2374 #endif
2375 
2376 /*
2377  * structure used for explicit stack while garbage collecting hash tables
2378  */
2379 typedef struct ht_stack_S
2380 {
2381     hashtab_T		*ht;
2382     struct ht_stack_S	*prev;
2383 } ht_stack_T;
2384 
2385 /*
2386  * structure used for explicit stack while garbage collecting lists
2387  */
2388 typedef struct list_stack_S
2389 {
2390     list_T		*list;
2391     struct list_stack_S	*prev;
2392 } list_stack_T;
2393 
2394 /*
2395  * Structure used for iterating over dictionary items.
2396  * Initialize with dict_iterate_start().
2397  */
2398 typedef struct
2399 {
2400     long_u	dit_todo;
2401     hashitem_T	*dit_hi;
2402 } dict_iterator_T;
2403 
2404 // values for b_syn_spell: what to do with toplevel text
2405 #define SYNSPL_DEFAULT	0	// spell check if @Spell not defined
2406 #define SYNSPL_TOP	1	// spell check toplevel text
2407 #define SYNSPL_NOTOP	2	// don't spell check toplevel text
2408 
2409 // values for b_syn_foldlevel: how to compute foldlevel on a line
2410 #define SYNFLD_START	0	// use level of item at start of line
2411 #define SYNFLD_MINIMUM	1	// use lowest local minimum level on line
2412 
2413 // avoid #ifdefs for when b_spell is not available
2414 #ifdef FEAT_SPELL
2415 # define B_SPELL(buf)  ((buf)->b_spell)
2416 #else
2417 # define B_SPELL(buf)  (0)
2418 #endif
2419 
2420 typedef struct qf_info_S qf_info_T;
2421 
2422 #ifdef FEAT_PROFILE
2423 /*
2424  * Used for :syntime: timing of executing a syntax pattern.
2425  */
2426 typedef struct {
2427     proftime_T	total;		// total time used
2428     proftime_T	slowest;	// time of slowest call
2429     long	count;		// nr of times used
2430     long	match;		// nr of times matched
2431 } syn_time_T;
2432 #endif
2433 
2434 typedef struct timer_S timer_T;
2435 struct timer_S
2436 {
2437     long	tr_id;
2438 #ifdef FEAT_TIMERS
2439     timer_T	*tr_next;
2440     timer_T	*tr_prev;
2441     proftime_T	tr_due;		    // when the callback is to be invoked
2442     char	tr_firing;	    // when TRUE callback is being called
2443     char	tr_paused;	    // when TRUE callback is not invoked
2444     int		tr_repeat;	    // number of times to repeat, -1 forever
2445     long	tr_interval;	    // msec
2446     callback_T	tr_callback;
2447     int		tr_emsg_count;
2448 #endif
2449 };
2450 
2451 #ifdef FEAT_CRYPT
2452 /*
2453  * Structure to hold the type of encryption and the state of encryption or
2454  * decryption.
2455  */
2456 typedef struct {
2457     int	    method_nr;
2458     void    *method_state;  // method-specific state information
2459 } cryptstate_T;
2460 
2461 // values for method_nr
2462 # define CRYPT_M_ZIP	0
2463 # define CRYPT_M_BF	1
2464 # define CRYPT_M_BF2	2
2465 # define CRYPT_M_COUNT	3 // number of crypt methods
2466 
2467 // Currently all crypt methods work inplace.  If one is added that isn't then
2468 // define this.
2469 //  # define CRYPT_NOT_INPLACE 1
2470 #endif
2471 
2472 #ifdef FEAT_PROP_POPUP
2473 typedef enum {
2474     POPPOS_BOTLEFT,
2475     POPPOS_TOPLEFT,
2476     POPPOS_BOTRIGHT,
2477     POPPOS_TOPRIGHT,
2478     POPPOS_CENTER,
2479     POPPOS_NONE
2480 } poppos_T;
2481 
2482 typedef enum {
2483     POPCLOSE_NONE,
2484     POPCLOSE_BUTTON,
2485     POPCLOSE_CLICK
2486 } popclose_T;
2487 
2488 # define POPUPWIN_DEFAULT_ZINDEX	 50
2489 # define POPUPMENU_ZINDEX		100
2490 # define POPUPWIN_DIALOG_ZINDEX		200
2491 # define POPUPWIN_NOTIFICATION_ZINDEX   300
2492 #endif
2493 
2494 /*
2495  * These are items normally related to a buffer.  But when using ":ownsyntax"
2496  * a window may have its own instance.
2497  */
2498 typedef struct {
2499 #ifdef FEAT_SYN_HL
2500     hashtab_T	b_keywtab;		// syntax keywords hash table
2501     hashtab_T	b_keywtab_ic;		// idem, ignore case
2502     int		b_syn_error;		// TRUE when error occurred in HL
2503 # ifdef FEAT_RELTIME
2504     int		b_syn_slow;		// TRUE when 'redrawtime' reached
2505 # endif
2506     int		b_syn_ic;		// ignore case for :syn cmds
2507     int		b_syn_foldlevel;	// how to compute foldlevel on a line
2508     int		b_syn_spell;		// SYNSPL_ values
2509     garray_T	b_syn_patterns;		// table for syntax patterns
2510     garray_T	b_syn_clusters;		// table for syntax clusters
2511     int		b_spell_cluster_id;	// @Spell cluster ID or 0
2512     int		b_nospell_cluster_id;	// @NoSpell cluster ID or 0
2513     int		b_syn_containedin;	// TRUE when there is an item with a
2514 					// "containedin" argument
2515     int		b_syn_sync_flags;	// flags about how to sync
2516     short	b_syn_sync_id;		// group to sync on
2517     long	b_syn_sync_minlines;	// minimal sync lines offset
2518     long	b_syn_sync_maxlines;	// maximal sync lines offset
2519     long	b_syn_sync_linebreaks;	// offset for multi-line pattern
2520     char_u	*b_syn_linecont_pat;	// line continuation pattern
2521     regprog_T	*b_syn_linecont_prog;	// line continuation program
2522 #ifdef FEAT_PROFILE
2523     syn_time_T  b_syn_linecont_time;
2524 #endif
2525     int		b_syn_linecont_ic;	// ignore-case flag for above
2526     int		b_syn_topgrp;		// for ":syntax include"
2527 # ifdef FEAT_CONCEAL
2528     int		b_syn_conceal;		// auto-conceal for :syn cmds
2529 # endif
2530 # ifdef FEAT_FOLDING
2531     int		b_syn_folditems;	// number of patterns with the HL_FOLD
2532 					// flag set
2533 # endif
2534     /*
2535      * b_sst_array[] contains the state stack for a number of lines, for the
2536      * start of that line (col == 0).  This avoids having to recompute the
2537      * syntax state too often.
2538      * b_sst_array[] is allocated to hold the state for all displayed lines,
2539      * and states for 1 out of about 20 other lines.
2540      * b_sst_array	pointer to an array of synstate_T
2541      * b_sst_len	number of entries in b_sst_array[]
2542      * b_sst_first	pointer to first used entry in b_sst_array[] or NULL
2543      * b_sst_firstfree	pointer to first free entry in b_sst_array[] or NULL
2544      * b_sst_freecount	number of free entries in b_sst_array[]
2545      * b_sst_check_lnum	entries after this lnum need to be checked for
2546      *			validity (MAXLNUM means no check needed)
2547      */
2548     synstate_T	*b_sst_array;
2549     int		b_sst_len;
2550     synstate_T	*b_sst_first;
2551     synstate_T	*b_sst_firstfree;
2552     int		b_sst_freecount;
2553     linenr_T	b_sst_check_lnum;
2554     short_u	b_sst_lasttick;	// last display tick
2555 #endif // FEAT_SYN_HL
2556 
2557 #ifdef FEAT_SPELL
2558     // for spell checking
2559     garray_T	b_langp;	    // list of pointers to slang_T, see spell.c
2560     char_u	b_spell_ismw[256];  // flags: is midword char
2561     char_u	*b_spell_ismw_mb;   // multi-byte midword chars
2562     char_u	*b_p_spc;	    // 'spellcapcheck'
2563     regprog_T	*b_cap_prog;	    // program for 'spellcapcheck'
2564     char_u	*b_p_spf;	    // 'spellfile'
2565     char_u	*b_p_spl;	    // 'spelllang'
2566     char_u	*b_p_spo;	    // 'spelloptions'
2567     int		b_cjk;		    // all CJK letters as OK
2568 #endif
2569 #if !defined(FEAT_SYN_HL) && !defined(FEAT_SPELL)
2570     int		dummy;
2571 #endif
2572     char_u	b_syn_chartab[32];  // syntax iskeyword option
2573     char_u	*b_syn_isk;	    // iskeyword option
2574 } synblock_T;
2575 
2576 
2577 /*
2578  * buffer: structure that holds information about one file
2579  *
2580  * Several windows can share a single Buffer
2581  * A buffer is unallocated if there is no memfile for it.
2582  * A buffer is new if the associated file has never been loaded yet.
2583  */
2584 
2585 struct file_buffer
2586 {
2587     memline_T	b_ml;		// associated memline (also contains line
2588 				// count)
2589 
2590     buf_T	*b_next;	// links in list of buffers
2591     buf_T	*b_prev;
2592 
2593     int		b_nwindows;	// nr of windows open on this buffer
2594 
2595     int		b_flags;	// various BF_ flags
2596     int		b_locked;	// Buffer is being closed or referenced, don't
2597 				// let autocommands wipe it out.
2598 
2599     /*
2600      * b_ffname has the full path of the file (NULL for no name).
2601      * b_sfname is the name as the user typed it (or NULL).
2602      * b_fname is the same as b_sfname, unless ":cd" has been done,
2603      *		then it is the same as b_ffname (NULL for no name).
2604      */
2605     char_u	*b_ffname;	// full path file name, allocated
2606     char_u	*b_sfname;	// short file name, allocated, may be equal to
2607 				// b_ffname
2608     char_u	*b_fname;	// current file name, points to b_ffname or
2609 				// b_sfname
2610 
2611 #ifdef UNIX
2612     int		b_dev_valid;	// TRUE when b_dev has a valid number
2613     dev_t	b_dev;		// device number
2614     ino_t	b_ino;		// inode number
2615 #endif
2616 #ifdef VMS
2617     char	 b_fab_rfm;	// Record format
2618     char	 b_fab_rat;	// Record attribute
2619     unsigned int b_fab_mrs;	// Max record size
2620 #endif
2621     int		b_fnum;		// buffer number for this file.
2622     char_u	b_key[VIM_SIZEOF_INT * 2 + 1];
2623 				// key used for buf_hashtab, holds b_fnum as
2624 				// hex string
2625 
2626     int		b_changed;	// 'modified': Set to TRUE if something in the
2627 				// file has been changed and not written out.
2628     dictitem16_T b_ct_di;	// holds the b:changedtick value in
2629 				// b_ct_di.di_tv.vval.v_number;
2630 				// incremented for each change, also for undo
2631 #define CHANGEDTICK(buf) ((buf)->b_ct_di.di_tv.vval.v_number)
2632 
2633     varnumber_T	b_last_changedtick; // b:changedtick when TextChanged or
2634 				    // TextChangedI was last triggered.
2635     varnumber_T	b_last_changedtick_pum; // b:changedtick when TextChangedP was
2636 					// last triggered.
2637 
2638     int		b_saving;	// Set to TRUE if we are in the middle of
2639 				// saving the buffer.
2640 
2641     /*
2642      * Changes to a buffer require updating of the display.  To minimize the
2643      * work, remember changes made and update everything at once.
2644      */
2645     int		b_mod_set;	// TRUE when there are changes since the last
2646 				// time the display was updated
2647     linenr_T	b_mod_top;	// topmost lnum that was changed
2648     linenr_T	b_mod_bot;	// lnum below last changed line, AFTER the
2649 				// change
2650     long	b_mod_xlines;	// number of extra buffer lines inserted;
2651 				// negative when lines were deleted
2652 
2653     wininfo_T	*b_wininfo;	// list of last used info for each window
2654 
2655     long	b_mtime;	// last change time of original file
2656     long	b_mtime_read;	// last change time when reading
2657     off_T	b_orig_size;	// size of original file in bytes
2658     int		b_orig_mode;	// mode of original file
2659 #ifdef FEAT_VIMINFO
2660     time_T	b_last_used;	// time when the buffer was last used; used
2661 				// for viminfo
2662 #endif
2663 
2664     pos_T	b_namedm[NMARKS]; // current named marks (mark.c)
2665 
2666     // These variables are set when VIsual_active becomes FALSE
2667     visualinfo_T b_visual;
2668 #ifdef FEAT_EVAL
2669     int		b_visual_mode_eval;  // b_visual.vi_mode for visualmode()
2670 #endif
2671 
2672     pos_T	b_last_cursor;	// cursor position when last unloading this
2673 				// buffer
2674     pos_T	b_last_insert;	// where Insert mode was left
2675     pos_T	b_last_change;	// position of last change: '. mark
2676 
2677 #ifdef FEAT_JUMPLIST
2678     /*
2679      * the changelist contains old change positions
2680      */
2681     pos_T	b_changelist[JUMPLISTSIZE];
2682     int		b_changelistlen;	// number of active entries
2683     int		b_new_change;		// set by u_savecommon()
2684 #endif
2685 
2686     /*
2687      * Character table, only used in charset.c for 'iskeyword'
2688      * 32 bytes of 8 bits: 1 bit per character 0-255.
2689      */
2690     char_u	b_chartab[32];
2691 
2692     // Table used for mappings local to a buffer.
2693     mapblock_T	*(b_maphash[256]);
2694 
2695     // First abbreviation local to a buffer.
2696     mapblock_T	*b_first_abbr;
2697 
2698     // User commands local to the buffer.
2699     garray_T	b_ucmds;
2700     // start and end of an operator, also used for '[ and ']
2701     pos_T	b_op_start;
2702     pos_T	b_op_start_orig;  // used for Insstart_orig
2703     pos_T	b_op_end;
2704 
2705 #ifdef FEAT_VIMINFO
2706     int		b_marks_read;	// Have we read viminfo marks yet?
2707 #endif
2708 
2709     /*
2710      * The following only used in undo.c.
2711      */
2712     u_header_T	*b_u_oldhead;	// pointer to oldest header
2713     u_header_T	*b_u_newhead;	// pointer to newest header; may not be valid
2714 				// if b_u_curhead is not NULL
2715     u_header_T	*b_u_curhead;	// pointer to current header
2716     int		b_u_numhead;	// current number of headers
2717     int		b_u_synced;	// entry lists are synced
2718     long	b_u_seq_last;	// last used undo sequence number
2719     long	b_u_save_nr_last; // counter for last file write
2720     long	b_u_seq_cur;	// hu_seq of header below which we are now
2721     time_T	b_u_time_cur;	// uh_time of header below which we are now
2722     long	b_u_save_nr_cur; // file write nr after which we are now
2723 
2724     /*
2725      * variables for "U" command in undo.c
2726      */
2727     undoline_T	b_u_line_ptr;	// saved line for "U" command
2728     linenr_T	b_u_line_lnum;	// line number of line in u_line
2729     colnr_T	b_u_line_colnr;	// optional column number
2730 
2731     int		b_scanned;	// ^N/^P have scanned this buffer
2732 
2733     // flags for use of ":lmap" and IM control
2734     long	b_p_iminsert;	// input mode for insert
2735     long	b_p_imsearch;	// input mode for search
2736 #define B_IMODE_USE_INSERT -1	//	Use b_p_iminsert value for search
2737 #define B_IMODE_NONE 0		//	Input via none
2738 #define B_IMODE_LMAP 1		//	Input via langmap
2739 #define B_IMODE_IM 2		//	Input via input method
2740 #define B_IMODE_LAST 2
2741 
2742 #ifdef FEAT_KEYMAP
2743     short	b_kmap_state;	// using "lmap" mappings
2744 # define KEYMAP_INIT	1	// 'keymap' was set, call keymap_init()
2745 # define KEYMAP_LOADED	2	// 'keymap' mappings have been loaded
2746     garray_T	b_kmap_ga;	// the keymap table
2747 #endif
2748 
2749     /*
2750      * Options local to a buffer.
2751      * They are here because their value depends on the type of file
2752      * or contents of the file being edited.
2753      */
2754     int		b_p_initialized;	// set when options initialized
2755 
2756 #ifdef FEAT_EVAL
2757     sctx_T	b_p_script_ctx[BV_COUNT]; // SCTXs for buffer-local options
2758 #endif
2759 
2760     int		b_p_ai;		// 'autoindent'
2761     int		b_p_ai_nopaste;	// b_p_ai saved for paste mode
2762     char_u	*b_p_bkc;	// 'backupcopy'
2763     unsigned	b_bkc_flags;    // flags for 'backupcopy'
2764     int		b_p_ci;		// 'copyindent'
2765     int		b_p_bin;	// 'binary'
2766     int		b_p_bomb;	// 'bomb'
2767     char_u	*b_p_bh;	// 'bufhidden'
2768     char_u	*b_p_bt;	// 'buftype'
2769 #ifdef FEAT_QUICKFIX
2770 #define BUF_HAS_QF_ENTRY 1
2771 #define BUF_HAS_LL_ENTRY 2
2772     int		b_has_qf_entry;
2773 #endif
2774     int		b_p_bl;		// 'buflisted'
2775 #ifdef FEAT_CINDENT
2776     int		b_p_cin;	// 'cindent'
2777     char_u	*b_p_cino;	// 'cinoptions'
2778     char_u	*b_p_cink;	// 'cinkeys'
2779 #endif
2780 #if defined(FEAT_CINDENT) || defined(FEAT_SMARTINDENT)
2781     char_u	*b_p_cinw;	// 'cinwords'
2782 #endif
2783     char_u	*b_p_com;	// 'comments'
2784 #ifdef FEAT_FOLDING
2785     char_u	*b_p_cms;	// 'commentstring'
2786 #endif
2787     char_u	*b_p_cpt;	// 'complete'
2788 #ifdef BACKSLASH_IN_FILENAME
2789     char_u	*b_p_csl;	// 'completeslash'
2790 #endif
2791 #ifdef FEAT_COMPL_FUNC
2792     char_u	*b_p_cfu;	// 'completefunc'
2793     char_u	*b_p_ofu;	// 'omnifunc'
2794 #endif
2795 #ifdef FEAT_EVAL
2796     char_u	*b_p_tfu;	// 'tagfunc'
2797 #endif
2798     int		b_p_eol;	// 'endofline'
2799     int		b_p_fixeol;	// 'fixendofline'
2800     int		b_p_et;		// 'expandtab'
2801     int		b_p_et_nobin;	// b_p_et saved for binary mode
2802     int		b_p_et_nopaste; // b_p_et saved for paste mode
2803     char_u	*b_p_fenc;	// 'fileencoding'
2804     char_u	*b_p_ff;	// 'fileformat'
2805     char_u	*b_p_ft;	// 'filetype'
2806     char_u	*b_p_fo;	// 'formatoptions'
2807     char_u	*b_p_flp;	// 'formatlistpat'
2808     int		b_p_inf;	// 'infercase'
2809     char_u	*b_p_isk;	// 'iskeyword'
2810 #ifdef FEAT_FIND_ID
2811     char_u	*b_p_def;	// 'define' local value
2812     char_u	*b_p_inc;	// 'include'
2813 # ifdef FEAT_EVAL
2814     char_u	*b_p_inex;	// 'includeexpr'
2815     long_u	b_p_inex_flags;	// flags for 'includeexpr'
2816 # endif
2817 #endif
2818 #if defined(FEAT_CINDENT) && defined(FEAT_EVAL)
2819     char_u	*b_p_inde;	// 'indentexpr'
2820     long_u	b_p_inde_flags;	// flags for 'indentexpr'
2821     char_u	*b_p_indk;	// 'indentkeys'
2822 #endif
2823     char_u	*b_p_fp;	// 'formatprg'
2824 #if defined(FEAT_EVAL)
2825     char_u	*b_p_fex;	// 'formatexpr'
2826     long_u	b_p_fex_flags;	// flags for 'formatexpr'
2827 #endif
2828 #ifdef FEAT_CRYPT
2829     char_u	*b_p_key;	// 'key'
2830 #endif
2831     char_u	*b_p_kp;	// 'keywordprg'
2832 #ifdef FEAT_LISP
2833     int		b_p_lisp;	// 'lisp'
2834 #endif
2835     char_u	*b_p_menc;	// 'makeencoding'
2836     char_u	*b_p_mps;	// 'matchpairs'
2837     int		b_p_ml;		// 'modeline'
2838     int		b_p_ml_nobin;	// b_p_ml saved for binary mode
2839     int		b_p_ma;		// 'modifiable'
2840     char_u	*b_p_nf;	// 'nrformats'
2841     int		b_p_pi;		// 'preserveindent'
2842 #ifdef FEAT_TEXTOBJ
2843     char_u	*b_p_qe;	// 'quoteescape'
2844 #endif
2845     int		b_p_ro;		// 'readonly'
2846     long	b_p_sw;		// 'shiftwidth'
2847     int		b_p_sn;		// 'shortname'
2848 #ifdef FEAT_SMARTINDENT
2849     int		b_p_si;		// 'smartindent'
2850 #endif
2851     long	b_p_sts;	// 'softtabstop'
2852     long	b_p_sts_nopaste; // b_p_sts saved for paste mode
2853 #ifdef FEAT_SEARCHPATH
2854     char_u	*b_p_sua;	// 'suffixesadd'
2855 #endif
2856     int		b_p_swf;	// 'swapfile'
2857 #ifdef FEAT_SYN_HL
2858     long	b_p_smc;	// 'synmaxcol'
2859     char_u	*b_p_syn;	// 'syntax'
2860 #endif
2861     long	b_p_ts;		// 'tabstop'
2862     int		b_p_tx;		// 'textmode'
2863     long	b_p_tw;		// 'textwidth'
2864     long	b_p_tw_nobin;	// b_p_tw saved for binary mode
2865     long	b_p_tw_nopaste;	// b_p_tw saved for paste mode
2866     long	b_p_wm;		// 'wrapmargin'
2867     long	b_p_wm_nobin;	// b_p_wm saved for binary mode
2868     long	b_p_wm_nopaste;	// b_p_wm saved for paste mode
2869 #ifdef FEAT_VARTABS
2870     char_u	*b_p_vsts;	// 'varsofttabstop'
2871     int		*b_p_vsts_array;   // 'varsofttabstop' in internal format
2872     char_u	*b_p_vsts_nopaste; // b_p_vsts saved for paste mode
2873     char_u	*b_p_vts;	// 'vartabstop'
2874     int		*b_p_vts_array;	// 'vartabstop' in internal format
2875 #endif
2876 #ifdef FEAT_KEYMAP
2877     char_u	*b_p_keymap;	// 'keymap'
2878 #endif
2879 
2880     /*
2881      * local values for options which are normally global
2882      */
2883 #ifdef FEAT_QUICKFIX
2884     char_u	*b_p_gp;	// 'grepprg' local value
2885     char_u	*b_p_mp;	// 'makeprg' local value
2886     char_u	*b_p_efm;	// 'errorformat' local value
2887 #endif
2888     char_u	*b_p_ep;	// 'equalprg' local value
2889     char_u	*b_p_path;	// 'path' local value
2890     int		b_p_ar;		// 'autoread' local value
2891     char_u	*b_p_tags;	// 'tags' local value
2892     char_u	*b_p_tc;	// 'tagcase' local value
2893     unsigned	b_tc_flags;     // flags for 'tagcase'
2894     char_u	*b_p_dict;	// 'dictionary' local value
2895     char_u	*b_p_tsr;	// 'thesaurus' local value
2896     long	b_p_ul;		// 'undolevels' local value
2897 #ifdef FEAT_PERSISTENT_UNDO
2898     int		b_p_udf;	// 'undofile'
2899 #endif
2900 #ifdef FEAT_LISP
2901     char_u	*b_p_lw;	// 'lispwords' local value
2902 #endif
2903 #ifdef FEAT_TERMINAL
2904     long	b_p_twsl;	// 'termwinscroll'
2905 #endif
2906 
2907     /*
2908      * end of buffer options
2909      */
2910 
2911 #ifdef FEAT_CINDENT
2912     // values set from b_p_cino
2913     int		b_ind_level;
2914     int		b_ind_open_imag;
2915     int		b_ind_no_brace;
2916     int		b_ind_first_open;
2917     int		b_ind_open_extra;
2918     int		b_ind_close_extra;
2919     int		b_ind_open_left_imag;
2920     int		b_ind_jump_label;
2921     int		b_ind_case;
2922     int		b_ind_case_code;
2923     int		b_ind_case_break;
2924     int		b_ind_param;
2925     int		b_ind_func_type;
2926     int		b_ind_comment;
2927     int		b_ind_in_comment;
2928     int		b_ind_in_comment2;
2929     int		b_ind_cpp_baseclass;
2930     int		b_ind_continuation;
2931     int		b_ind_unclosed;
2932     int		b_ind_unclosed2;
2933     int		b_ind_unclosed_noignore;
2934     int		b_ind_unclosed_wrapped;
2935     int		b_ind_unclosed_whiteok;
2936     int		b_ind_matching_paren;
2937     int		b_ind_paren_prev;
2938     int		b_ind_maxparen;
2939     int		b_ind_maxcomment;
2940     int		b_ind_scopedecl;
2941     int		b_ind_scopedecl_code;
2942     int		b_ind_java;
2943     int		b_ind_js;
2944     int		b_ind_keep_case_label;
2945     int		b_ind_hash_comment;
2946     int		b_ind_cpp_namespace;
2947     int		b_ind_if_for_while;
2948     int		b_ind_cpp_extern_c;
2949     int		b_ind_pragma;
2950 #endif
2951 
2952     linenr_T	b_no_eol_lnum;	// non-zero lnum when last line of next binary
2953 				// write should not have an end-of-line
2954 
2955     int		b_start_eol;	// last line had eol when it was read
2956     int		b_start_ffc;	// first char of 'ff' when edit started
2957     char_u	*b_start_fenc;	// 'fileencoding' when edit started or NULL
2958     int		b_bad_char;	// "++bad=" argument when edit started or 0
2959     int		b_start_bomb;	// 'bomb' when it was read
2960 
2961 #ifdef FEAT_EVAL
2962     dictitem_T	b_bufvar;	// variable for "b:" Dictionary
2963     dict_T	*b_vars;	// internal variables, local to buffer
2964 
2965     listener_T	*b_listener;
2966     list_T	*b_recorded_changes;
2967 #endif
2968 #ifdef FEAT_PROP_POPUP
2969     int		b_has_textprop;	// TRUE when text props were added
2970     hashtab_T	*b_proptypes;	// text property types local to buffer
2971 #endif
2972 
2973 #if defined(FEAT_BEVAL) && defined(FEAT_EVAL)
2974     char_u	*b_p_bexpr;	// 'balloonexpr' local value
2975     long_u	b_p_bexpr_flags;// flags for 'balloonexpr'
2976 #endif
2977 #ifdef FEAT_CRYPT
2978     char_u	*b_p_cm;	// 'cryptmethod'
2979 #endif
2980 
2981     // When a buffer is created, it starts without a swap file.  b_may_swap is
2982     // then set to indicate that a swap file may be opened later.  It is reset
2983     // if a swap file could not be opened.
2984     int		b_may_swap;
2985     int		b_did_warn;	// Set to 1 if user has been warned on first
2986 				// change of a read-only file
2987 
2988     // Two special kinds of buffers:
2989     // help buffer  - used for help files, won't use a swap file.
2990     // spell buffer - used for spell info, never displayed and doesn't have a
2991     //		      file name.
2992     int		b_help;		// TRUE for help file buffer (when set b_p_bt
2993 				// is "help")
2994 #ifdef FEAT_SPELL
2995     int		b_spell;	// TRUE for a spell file buffer, most fields
2996 				// are not used!  Use the B_SPELL macro to
2997 				// access b_spell without #ifdef.
2998 #endif
2999 
3000     int		b_shortname;	// this file has an 8.3 file name
3001 
3002 #ifdef FEAT_JOB_CHANNEL
3003     char_u	*b_prompt_text;		// set by prompt_setprompt()
3004     callback_T	b_prompt_callback;	// set by prompt_setcallback()
3005     callback_T	b_prompt_interrupt;	// set by prompt_setinterrupt()
3006     int		b_prompt_insert;	// value for restart_edit when entering
3007 					// a prompt buffer window.
3008 #endif
3009 #ifdef FEAT_MZSCHEME
3010     void	*b_mzscheme_ref; // The MzScheme reference to this buffer
3011 #endif
3012 
3013 #ifdef FEAT_PERL
3014     void	*b_perl_private;
3015 #endif
3016 
3017 #ifdef FEAT_PYTHON
3018     void	*b_python_ref;	// The Python reference to this buffer
3019 #endif
3020 
3021 #ifdef FEAT_PYTHON3
3022     void	*b_python3_ref;	// The Python3 reference to this buffer
3023 #endif
3024 
3025 #ifdef FEAT_TCL
3026     void	*b_tcl_ref;
3027 #endif
3028 
3029 #ifdef FEAT_RUBY
3030     void	*b_ruby_ref;
3031 #endif
3032 
3033 #if defined(FEAT_SYN_HL) || defined(FEAT_SPELL)
3034     synblock_T	b_s;		// Info related to syntax highlighting.  w_s
3035 				// normally points to this, but some windows
3036 				// may use a different synblock_T.
3037 #endif
3038 
3039 #ifdef FEAT_SIGNS
3040     sign_entry_T *b_signlist;	   // list of placed signs
3041 # ifdef FEAT_NETBEANS_INTG
3042     int		b_has_sign_column; // Flag that is set when a first sign is
3043 				   // added and remains set until the end of
3044 				   // the netbeans session.
3045 # endif
3046 #endif
3047 
3048 #ifdef FEAT_NETBEANS_INTG
3049     int		b_netbeans_file;    // TRUE when buffer is owned by NetBeans
3050     int		b_was_netbeans_file;// TRUE if b_netbeans_file was once set
3051 #endif
3052 #ifdef FEAT_JOB_CHANNEL
3053     int		b_write_to_channel; // TRUE when appended lines are written to
3054 				    // a channel.
3055 #endif
3056 
3057 #ifdef FEAT_CRYPT
3058     cryptstate_T *b_cryptstate;	// Encryption state while reading or writing
3059 				// the file. NULL when not using encryption.
3060 #endif
3061     int		b_mapped_ctrl_c; // modes where CTRL-C is mapped
3062 
3063 #ifdef FEAT_TERMINAL
3064     term_T	*b_term;	// When not NULL this buffer is for a terminal
3065 				// window.
3066 #endif
3067 #ifdef FEAT_DIFF
3068     int		b_diff_failed;	// internal diff failed for this buffer
3069 #endif
3070 }; // file_buffer
3071 
3072 
3073 #ifdef FEAT_DIFF
3074 /*
3075  * Stuff for diff mode.
3076  */
3077 # define DB_COUNT 8	// up to eight buffers can be diff'ed
3078 
3079 /*
3080  * Each diffblock defines where a block of lines starts in each of the buffers
3081  * and how many lines it occupies in that buffer.  When the lines are missing
3082  * in the buffer the df_count[] is zero.  This is all counted in
3083  * buffer lines.
3084  * There is always at least one unchanged line in between the diffs.
3085  * Otherwise it would have been included in the diff above or below it.
3086  * df_lnum[] + df_count[] is the lnum below the change.  When in one buffer
3087  * lines have been inserted, in the other buffer df_lnum[] is the line below
3088  * the insertion and df_count[] is zero.  When appending lines at the end of
3089  * the buffer, df_lnum[] is one beyond the end!
3090  * This is using a linked list, because the number of differences is expected
3091  * to be reasonable small.  The list is sorted on lnum.
3092  */
3093 typedef struct diffblock_S diff_T;
3094 struct diffblock_S
3095 {
3096     diff_T	*df_next;
3097     linenr_T	df_lnum[DB_COUNT];	// line number in buffer
3098     linenr_T	df_count[DB_COUNT];	// nr of inserted/changed lines
3099 };
3100 #endif
3101 
3102 #define SNAP_HELP_IDX	0
3103 #define SNAP_AUCMD_IDX 1
3104 #define SNAP_COUNT	2
3105 
3106 /*
3107  * Tab pages point to the top frame of each tab page.
3108  * Note: Most values are NOT valid for the current tab page!  Use "curwin",
3109  * "firstwin", etc. for that.  "tp_topframe" is always valid and can be
3110  * compared against "topframe" to find the current tab page.
3111  */
3112 typedef struct tabpage_S tabpage_T;
3113 struct tabpage_S
3114 {
3115     tabpage_T	    *tp_next;	    // next tabpage or NULL
3116     frame_T	    *tp_topframe;   // topframe for the windows
3117     win_T	    *tp_curwin;	    // current window in this Tab page
3118     win_T	    *tp_prevwin;    // previous window in this Tab page
3119     win_T	    *tp_firstwin;   // first window in this Tab page
3120     win_T	    *tp_lastwin;    // last window in this Tab page
3121 #ifdef FEAT_PROP_POPUP
3122     win_T	    *tp_first_popupwin; // first popup window in this Tab page
3123 #endif
3124     long	    tp_old_Rows;    // Rows when Tab page was left
3125     long	    tp_old_Columns; // Columns when Tab page was left
3126     long	    tp_ch_used;	    // value of 'cmdheight' when frame size
3127 				    // was set
3128 #ifdef FEAT_GUI
3129     int		    tp_prev_which_scrollbars[3];
3130 				    // previous value of which_scrollbars
3131 #endif
3132 
3133     char_u	    *tp_localdir;	// absolute path of local directory or
3134 					// NULL
3135     char_u	    *tp_prevdir;	// previous directory
3136 
3137 #ifdef FEAT_DIFF
3138     diff_T	    *tp_first_diff;
3139     buf_T	    *(tp_diffbuf[DB_COUNT]);
3140     int		    tp_diff_invalid;	// list of diffs is outdated
3141     int		    tp_diff_update;	// update diffs before redrawing
3142 #endif
3143     frame_T	    *(tp_snapshot[SNAP_COUNT]);  // window layout snapshots
3144 #ifdef FEAT_EVAL
3145     dictitem_T	    tp_winvar;	    // variable for "t:" Dictionary
3146     dict_T	    *tp_vars;	    // internal variables, local to tab page
3147 #endif
3148 
3149 #ifdef FEAT_PYTHON
3150     void	    *tp_python_ref;	// The Python value for this tab page
3151 #endif
3152 
3153 #ifdef FEAT_PYTHON3
3154     void	    *tp_python3_ref;	// The Python value for this tab page
3155 #endif
3156 };
3157 
3158 /*
3159  * Structure to cache info for displayed lines in w_lines[].
3160  * Each logical line has one entry.
3161  * The entry tells how the logical line is currently displayed in the window.
3162  * This is updated when displaying the window.
3163  * When the display is changed (e.g., when clearing the screen) w_lines_valid
3164  * is changed to exclude invalid entries.
3165  * When making changes to the buffer, wl_valid is reset to indicate wl_size
3166  * may not reflect what is actually in the buffer.  When wl_valid is FALSE,
3167  * the entries can only be used to count the number of displayed lines used.
3168  * wl_lnum and wl_lastlnum are invalid too.
3169  */
3170 typedef struct w_line
3171 {
3172     linenr_T	wl_lnum;	// buffer line number for logical line
3173     short_u	wl_size;	// height in screen lines
3174     char	wl_valid;	// TRUE values are valid for text in buffer
3175 #ifdef FEAT_FOLDING
3176     char	wl_folded;	// TRUE when this is a range of folded lines
3177     linenr_T	wl_lastlnum;	// last buffer line number for logical line
3178 #endif
3179 } wline_T;
3180 
3181 /*
3182  * Windows are kept in a tree of frames.  Each frame has a column (FR_COL)
3183  * or row (FR_ROW) layout or is a leaf, which has a window.
3184  */
3185 struct frame_S
3186 {
3187     char	fr_layout;	// FR_LEAF, FR_COL or FR_ROW
3188     int		fr_width;
3189     int		fr_newwidth;	// new width used in win_equal_rec()
3190     int		fr_height;
3191     int		fr_newheight;	// new height used in win_equal_rec()
3192     frame_T	*fr_parent;	// containing frame or NULL
3193     frame_T	*fr_next;	// frame right or below in same parent, NULL
3194 				// for last
3195     frame_T	*fr_prev;	// frame left or above in same parent, NULL
3196 				// for first
3197     // fr_child and fr_win are mutually exclusive
3198     frame_T	*fr_child;	// first contained frame
3199     win_T	*fr_win;	// window that fills this frame
3200 };
3201 
3202 #define FR_LEAF	0	// frame is a leaf
3203 #define FR_ROW	1	// frame with a row of windows
3204 #define FR_COL	2	// frame with a column of windows
3205 
3206 /*
3207  * Struct used for highlighting 'hlsearch' matches, matches defined by
3208  * ":match" and matches defined by match functions.
3209  * For 'hlsearch' there is one pattern for all windows.  For ":match" and the
3210  * match functions there is a different pattern for each window.
3211  */
3212 typedef struct
3213 {
3214     regmmatch_T	rm;	    // points to the regexp program; contains last
3215 			    // found match (may continue in next line)
3216     buf_T	*buf;	    // the buffer to search for a match
3217     linenr_T	lnum;	    // the line to search for a match
3218     int		attr;	    // attributes to be used for a match
3219     int		attr_cur;   // attributes currently active in win_line()
3220     linenr_T	first_lnum; // first lnum to search for multi-line pat
3221     colnr_T	startcol;   // in win_line() points to char where HL starts
3222     colnr_T	endcol;	    // in win_line() points to char where HL ends
3223     int		is_addpos;  // position specified directly by
3224 			    // matchaddpos(). TRUE/FALSE
3225 #ifdef FEAT_RELTIME
3226     proftime_T	tm;	    // for a time limit
3227 #endif
3228 } match_T;
3229 
3230 // number of positions supported by matchaddpos()
3231 #define MAXPOSMATCH 8
3232 
3233 /*
3234  * Same as lpos_T, but with additional field len.
3235  */
3236 typedef struct
3237 {
3238     linenr_T	lnum;	// line number
3239     colnr_T	col;	// column number
3240     int		len;	// length: 0 - to the end of line
3241 } llpos_T;
3242 
3243 /*
3244  * posmatch_T provides an array for storing match items for matchaddpos()
3245  * function.
3246  */
3247 typedef struct posmatch posmatch_T;
3248 struct posmatch
3249 {
3250     llpos_T	pos[MAXPOSMATCH];	// array of positions
3251     int		cur;			// internal position counter
3252     linenr_T	toplnum;		// top buffer line
3253     linenr_T	botlnum;		// bottom buffer line
3254 };
3255 
3256 /*
3257  * matchitem_T provides a linked list for storing match items for ":match" and
3258  * the match functions.
3259  */
3260 typedef struct matchitem matchitem_T;
3261 struct matchitem
3262 {
3263     matchitem_T	*next;
3264     int		id;	    // match ID
3265     int		priority;   // match priority
3266     char_u	*pattern;   // pattern to highlight
3267     regmmatch_T	match;	    // regexp program for pattern
3268     posmatch_T	pos;	    // position matches
3269     match_T	hl;	    // struct for doing the actual highlighting
3270     int		hlg_id;	    // highlight group ID
3271 #ifdef FEAT_CONCEAL
3272     int		conceal_char; // cchar for Conceal highlighting
3273 #endif
3274 };
3275 
3276 // Structure to store last cursor position and topline.  Used by check_lnums()
3277 // and reset_lnums().
3278 typedef struct
3279 {
3280     int		w_topline_save;	// original topline value
3281     int		w_topline_corr;	// corrected topline value
3282     pos_T	w_cursor_save;	// original cursor position
3283     pos_T	w_cursor_corr;	// corrected cursor position
3284 } pos_save_T;
3285 
3286 #ifdef FEAT_MENU
3287 typedef struct {
3288     int		wb_startcol;
3289     int		wb_endcol;
3290     vimmenu_T	*wb_menu;
3291 } winbar_item_T;
3292 #endif
3293 
3294 /*
3295  * Structure which contains all information that belongs to a window
3296  *
3297  * All row numbers are relative to the start of the window, except w_winrow.
3298  */
3299 struct window_S
3300 {
3301     int		w_id;		    // unique window ID
3302 
3303     buf_T	*w_buffer;	    // buffer we are a window into
3304 
3305     win_T	*w_prev;	    // link to previous window
3306     win_T	*w_next;	    // link to next window
3307 
3308 #if defined(FEAT_SYN_HL) || defined(FEAT_SPELL)
3309     synblock_T	*w_s;		    // for :ownsyntax
3310 #endif
3311 
3312     int		w_closing;	    // window is being closed, don't let
3313 				    // autocommands close it too.
3314 
3315     frame_T	*w_frame;	    // frame containing this window
3316 
3317     pos_T	w_cursor;	    // cursor position in buffer
3318 
3319     colnr_T	w_curswant;	    // The column we'd like to be at.  This is
3320 				    // used to try to stay in the same column
3321 				    // for up/down cursor motions.
3322 
3323     int		w_set_curswant;	    // If set, then update w_curswant the next
3324 				    // time through cursupdate() to the
3325 				    // current virtual column
3326 
3327 #ifdef FEAT_SYN_HL
3328     linenr_T	w_last_cursorline;  // where last time 'cursorline' was drawn
3329 #endif
3330 
3331     /*
3332      * the next seven are used to update the Visual highlighting
3333      */
3334     char	w_old_visual_mode;  // last known VIsual_mode
3335     linenr_T	w_old_cursor_lnum;  // last known end of visual part
3336     colnr_T	w_old_cursor_fcol;  // first column for block visual part
3337     colnr_T	w_old_cursor_lcol;  // last column for block visual part
3338     linenr_T	w_old_visual_lnum;  // last known start of visual part
3339     colnr_T	w_old_visual_col;   // last known start of visual part
3340     colnr_T	w_old_curswant;	    // last known value of Curswant
3341 
3342     /*
3343      * "w_topline", "w_leftcol" and "w_skipcol" specify the offsets for
3344      * displaying the buffer.
3345      */
3346     linenr_T	w_topline;	    // buffer line number of the line at the
3347 				    // top of the window
3348     char	w_topline_was_set;  // flag set to TRUE when topline is set,
3349 				    // e.g. by winrestview()
3350 #ifdef FEAT_DIFF
3351     int		w_topfill;	    // number of filler lines above w_topline
3352     int		w_old_topfill;	    // w_topfill at last redraw
3353     int		w_botfill;	    // TRUE when filler lines are actually
3354 				    // below w_topline (at end of file)
3355     int		w_old_botfill;	    // w_botfill at last redraw
3356 #endif
3357     colnr_T	w_leftcol;	    // window column number of the left most
3358 				    // character in the window; used when
3359 				    // 'wrap' is off
3360     colnr_T	w_skipcol;	    // starting column when a single line
3361 				    // doesn't fit in the window
3362 
3363     /*
3364      * Layout of the window in the screen.
3365      * May need to add "msg_scrolled" to "w_winrow" in rare situations.
3366      */
3367     int		w_winrow;	    // first row of window in screen
3368     int		w_height;	    // number of rows in window, excluding
3369 				    // status/command/winbar line(s)
3370     int		w_status_height;    // number of status lines (0 or 1)
3371     int		w_wincol;	    // Leftmost column of window in screen.
3372     int		w_width;	    // Width of window, excluding separation.
3373     int		w_vsep_width;	    // Number of separator columns (0 or 1).
3374     pos_save_T	w_save_cursor;	    // backup of cursor pos and topline
3375 #ifdef FEAT_PROP_POPUP
3376     int		w_popup_flags;	    // POPF_ values
3377     int		w_popup_handled;    // POPUP_HANDLE[0-9] flags
3378     char_u	*w_popup_title;
3379     poppos_T	w_popup_pos;
3380     int		w_popup_fixed;	    // do not shift popup to fit on screen
3381     int		w_popup_prop_type;  // when not zero: textprop type ID
3382     win_T	*w_popup_prop_win;  // window to search for textprop
3383     int		w_popup_prop_id;    // when not zero: textprop ID
3384     int		w_zindex;
3385     int		w_minheight;	    // "minheight" for popup window
3386     int		w_minwidth;	    // "minwidth" for popup window
3387     int		w_maxheight;	    // "maxheight" for popup window
3388     int		w_maxwidth;	    // "maxwidth" for popup window
3389     int		w_maxwidth_opt;	    // maxwidth from option
3390     int		w_wantline;	    // "line" for popup window
3391     int		w_wantcol;	    // "col" for popup window
3392     int		w_firstline;	    // "firstline" for popup window
3393     int		w_want_scrollbar;   // when zero don't use a scrollbar
3394     int		w_has_scrollbar;    // 1 if scrollbar displayed, 0 otherwise
3395     char_u	*w_scrollbar_highlight; // "scrollbarhighlight"
3396     char_u	*w_thumb_highlight; // "thumbhighlight"
3397     int		w_popup_padding[4]; // popup padding top/right/bot/left
3398     int		w_popup_border[4];  // popup border top/right/bot/left
3399     char_u	*w_border_highlight[4];  // popup border highlight
3400     int		w_border_char[8];   // popup border characters
3401 
3402     int		w_popup_leftoff;    // columns left of the screen
3403     int		w_popup_rightoff;   // columns right of the screen
3404     varnumber_T	w_popup_last_changedtick; // b:changedtick of popup buffer
3405 					  // when position was computed
3406     varnumber_T	w_popup_prop_changedtick; // b:changedtick of buffer with
3407 					  // w_popup_prop_type when position
3408 					  // was computed
3409     int		w_popup_prop_topline; // w_topline of window with
3410 				      // w_popup_prop_type when position was
3411 				      // computed
3412     linenr_T	w_popup_last_curline; // last known w_cursor.lnum of window
3413 				      // with "cursorline" set
3414     callback_T	w_close_cb;	    // popup close callback
3415     callback_T	w_filter_cb;	    // popup filter callback
3416     int		w_filter_errors;    // popup filter error count
3417     int		w_filter_mode;	    // mode when filter callback is used
3418 
3419     win_T	*w_popup_curwin;    // close popup if curwin differs
3420     linenr_T	w_popup_lnum;	    // close popup if cursor not on this line
3421     colnr_T	w_popup_mincol;	    // close popup if cursor before this col
3422     colnr_T	w_popup_maxcol;	    // close popup if cursor after this col
3423     int		w_popup_mouse_row;  // close popup if mouse moves away
3424     int		w_popup_mouse_mincol;  // close popup if mouse moves away
3425     int		w_popup_mouse_maxcol;  // close popup if mouse moves away
3426     popclose_T	w_popup_close;	    // allow closing the popup with the mouse
3427 
3428     list_T	*w_popup_mask;	     // list of lists for "mask"
3429     char_u	*w_popup_mask_cells; // cached mask cells
3430     int		w_popup_mask_height; // height of w_popup_mask_cells
3431     int		w_popup_mask_width;  // width of w_popup_mask_cells
3432 # if defined(FEAT_TIMERS)
3433     timer_T	*w_popup_timer;	    // timer for closing popup window
3434 # endif
3435 #endif
3436 
3437 
3438     /*
3439      * === start of cached values ====
3440      */
3441     /*
3442      * Recomputing is minimized by storing the result of computations.
3443      * Use functions in screen.c to check if they are valid and to update.
3444      * w_valid is a bitfield of flags, which indicate if specific values are
3445      * valid or need to be recomputed.	See screen.c for values.
3446      */
3447     int		w_valid;
3448     pos_T	w_valid_cursor;	    // last known position of w_cursor, used
3449 				    // to adjust w_valid
3450     colnr_T	w_valid_leftcol;    // last known w_leftcol
3451 
3452     /*
3453      * w_cline_height is the number of physical lines taken by the buffer line
3454      * that the cursor is on.  We use this to avoid extra calls to plines().
3455      */
3456     int		w_cline_height;	    // current size of cursor line
3457 #ifdef FEAT_FOLDING
3458     int		w_cline_folded;	    // cursor line is folded
3459 #endif
3460 
3461     int		w_cline_row;	    // starting row of the cursor line
3462 
3463     colnr_T	w_virtcol;	    // column number of the cursor in the
3464 				    // buffer line, as opposed to the column
3465 				    // number we're at on the screen.  This
3466 				    // makes a difference on lines which span
3467 				    // more than one screen line or when
3468 				    // w_leftcol is non-zero
3469 
3470     /*
3471      * w_wrow and w_wcol specify the cursor position in the window.
3472      * This is related to positions in the window, not in the display or
3473      * buffer, thus w_wrow is relative to w_winrow.
3474      */
3475     int		w_wrow, w_wcol;	    // cursor position in window
3476 
3477     linenr_T	w_botline;	    // number of the line below the bottom of
3478 				    // the window
3479     int		w_empty_rows;	    // number of ~ rows in window
3480 #ifdef FEAT_DIFF
3481     int		w_filler_rows;	    // number of filler rows at the end of the
3482 				    // window
3483 #endif
3484 
3485     /*
3486      * Info about the lines currently in the window is remembered to avoid
3487      * recomputing it every time.  The allocated size of w_lines[] is Rows.
3488      * Only the w_lines_valid entries are actually valid.
3489      * When the display is up-to-date w_lines[0].wl_lnum is equal to w_topline
3490      * and w_lines[w_lines_valid - 1].wl_lnum is equal to w_botline.
3491      * Between changing text and updating the display w_lines[] represents
3492      * what is currently displayed.  wl_valid is reset to indicated this.
3493      * This is used for efficient redrawing.
3494      */
3495     int		w_lines_valid;	    // number of valid entries
3496     wline_T	*w_lines;
3497 
3498 #ifdef FEAT_FOLDING
3499     garray_T	w_folds;	    // array of nested folds
3500     char	w_fold_manual;	    // when TRUE: some folds are opened/closed
3501 				    // manually
3502     char	w_foldinvalid;	    // when TRUE: folding needs to be
3503 				    // recomputed
3504 #endif
3505 #ifdef FEAT_LINEBREAK
3506     int		w_nrwidth;	    // width of 'number' and 'relativenumber'
3507 				    // column being used
3508 #endif
3509 
3510     /*
3511      * === end of cached values ===
3512      */
3513 
3514     int		w_redr_type;	    // type of redraw to be performed on win
3515     int		w_upd_rows;	    // number of window lines to update when
3516 				    // w_redr_type is REDRAW_TOP
3517     linenr_T	w_redraw_top;	    // when != 0: first line needing redraw
3518     linenr_T	w_redraw_bot;	    // when != 0: last line needing redraw
3519     int		w_redr_status;	    // if TRUE status line must be redrawn
3520 
3521 #ifdef FEAT_CMDL_INFO
3522     // remember what is shown in the ruler for this window (if 'ruler' set)
3523     pos_T	w_ru_cursor;	    // cursor position shown in ruler
3524     colnr_T	w_ru_virtcol;	    // virtcol shown in ruler
3525     linenr_T	w_ru_topline;	    // topline shown in ruler
3526     linenr_T	w_ru_line_count;    // line count used for ruler
3527 # ifdef FEAT_DIFF
3528     int		w_ru_topfill;	    // topfill shown in ruler
3529 # endif
3530     char	w_ru_empty;	    // TRUE if ruler shows 0-1 (empty line)
3531 #endif
3532 
3533     int		w_alt_fnum;	    // alternate file (for # and CTRL-^)
3534 
3535     alist_T	*w_alist;	    // pointer to arglist for this window
3536     int		w_arg_idx;	    // current index in argument list (can be
3537 				    // out of range!)
3538     int		w_arg_idx_invalid;  // editing another file than w_arg_idx
3539 
3540     char_u	*w_localdir;	    // absolute path of local directory or
3541 				    // NULL
3542     char_u	*w_prevdir;	    // previous directory
3543 #ifdef FEAT_MENU
3544     vimmenu_T	*w_winbar;	    // The root of the WinBar menu hierarchy.
3545     winbar_item_T *w_winbar_items;  // list of items in the WinBar
3546     int		w_winbar_height;    // 1 if there is a window toolbar
3547 #endif
3548 
3549     /*
3550      * Options local to a window.
3551      * They are local because they influence the layout of the window or
3552      * depend on the window layout.
3553      * There are two values: w_onebuf_opt is local to the buffer currently in
3554      * this window, w_allbuf_opt is for all buffers in this window.
3555      */
3556     winopt_T	w_onebuf_opt;
3557     winopt_T	w_allbuf_opt;
3558 
3559     // A few options have local flags for P_INSECURE.
3560 #ifdef FEAT_STL_OPT
3561     long_u	w_p_stl_flags;	    // flags for 'statusline'
3562 #endif
3563 #ifdef FEAT_EVAL
3564     long_u	w_p_fde_flags;	    // flags for 'foldexpr'
3565     long_u	w_p_fdt_flags;	    // flags for 'foldtext'
3566 #endif
3567 #ifdef FEAT_SYN_HL
3568     int		*w_p_cc_cols;	    // array of columns to highlight or NULL
3569     char_u	w_p_culopt_flags;   // flags for cursorline highlighting
3570 #endif
3571     long	w_p_siso;	    // 'sidescrolloff' local value
3572     long	w_p_so;		    // 'scrolloff' local value
3573 
3574 #ifdef FEAT_LINEBREAK
3575     int		w_briopt_min;	    // minimum width for breakindent
3576     int		w_briopt_shift;	    // additional shift for breakindent
3577     int		w_briopt_sbr;	    // sbr in 'briopt'
3578 #endif
3579 
3580     // transform a pointer to a "onebuf" option into a "allbuf" option
3581 #define GLOBAL_WO(p)	((char *)p + sizeof(winopt_T))
3582 
3583     long	w_scbind_pos;
3584 
3585 #ifdef FEAT_EVAL
3586     dictitem_T	w_winvar;	// variable for "w:" Dictionary
3587     dict_T	*w_vars;	// internal variables, local to window
3588 #endif
3589 
3590     /*
3591      * The w_prev_pcmark field is used to check whether we really did jump to
3592      * a new line after setting the w_pcmark.  If not, then we revert to
3593      * using the previous w_pcmark.
3594      */
3595     pos_T	w_pcmark;	// previous context mark
3596     pos_T	w_prev_pcmark;	// previous w_pcmark
3597 
3598 #ifdef FEAT_JUMPLIST
3599     /*
3600      * the jumplist contains old cursor positions
3601      */
3602     xfmark_T	w_jumplist[JUMPLISTSIZE];
3603     int		w_jumplistlen;		// number of active entries
3604     int		w_jumplistidx;		// current position
3605 
3606     int		w_changelistidx;	// current position in b_changelist
3607 #endif
3608 
3609 #ifdef FEAT_SEARCH_EXTRA
3610     matchitem_T	*w_match_head;		// head of match list
3611     int		w_next_match_id;	// next match ID
3612 #endif
3613 
3614     /*
3615      * the tagstack grows from 0 upwards:
3616      * entry 0: older
3617      * entry 1: newer
3618      * entry 2: newest
3619      */
3620     taggy_T	w_tagstack[TAGSTACKSIZE];   // the tag stack
3621     int		w_tagstackidx;		    // idx just below active entry
3622     int		w_tagstacklen;		    // number of tags on stack
3623 
3624     /*
3625      * w_fraction is the fractional row of the cursor within the window, from
3626      * 0 at the top row to FRACTION_MULT at the last row.
3627      * w_prev_fraction_row was the actual cursor row when w_fraction was last
3628      * calculated.
3629      */
3630     int		w_fraction;
3631     int		w_prev_fraction_row;
3632 
3633 #ifdef FEAT_GUI
3634     scrollbar_T	w_scrollbars[2];	// vert. Scrollbars for this window
3635 #endif
3636 #ifdef FEAT_LINEBREAK
3637     linenr_T	w_nrwidth_line_count;	// line count when ml_nrwidth_width
3638 					// was computed.
3639     long	w_nuw_cached;		// 'numberwidth' option cached
3640     int		w_nrwidth_width;	// nr of chars to print line count.
3641 #endif
3642 
3643 #ifdef FEAT_QUICKFIX
3644     qf_info_T	*w_llist;		// Location list for this window
3645     /*
3646      * Location list reference used in the location list window.
3647      * In a non-location list window, w_llist_ref is NULL.
3648      */
3649     qf_info_T	*w_llist_ref;
3650 #endif
3651 
3652 #ifdef FEAT_MZSCHEME
3653     void	*w_mzscheme_ref;	// The MzScheme value for this window
3654 #endif
3655 
3656 #ifdef FEAT_PERL
3657     void	*w_perl_private;
3658 #endif
3659 
3660 #ifdef FEAT_PYTHON
3661     void	*w_python_ref;		// The Python value for this window
3662 #endif
3663 
3664 #ifdef FEAT_PYTHON3
3665     void	*w_python3_ref;		// The Python value for this window
3666 #endif
3667 
3668 #ifdef FEAT_TCL
3669     void	*w_tcl_ref;
3670 #endif
3671 
3672 #ifdef FEAT_RUBY
3673     void	*w_ruby_ref;
3674 #endif
3675 };
3676 
3677 /*
3678  * Arguments for operators.
3679  */
3680 typedef struct oparg_S
3681 {
3682     int		op_type;	// current pending operator type
3683     int		regname;	// register to use for the operator
3684     int		motion_type;	// type of the current cursor motion
3685     int		motion_force;	// force motion type: 'v', 'V' or CTRL-V
3686     int		use_reg_one;	// TRUE if delete uses reg 1 even when not
3687 				// linewise
3688     int		inclusive;	// TRUE if char motion is inclusive (only
3689 				// valid when motion_type is MCHAR
3690     int		end_adjusted;	// backuped b_op_end one char (only used by
3691 				// do_format())
3692     pos_T	start;		// start of the operator
3693     pos_T	end;		// end of the operator
3694     pos_T	cursor_start;	// cursor position before motion for "gw"
3695 
3696     long	line_count;	// number of lines from op_start to op_end
3697 				// (inclusive)
3698     int		empty;		// op_start and op_end the same (only used by
3699 				// do_change())
3700     int		is_VIsual;	// operator on Visual area
3701     int		block_mode;	// current operator is Visual block mode
3702     colnr_T	start_vcol;	// start col for block mode operator
3703     colnr_T	end_vcol;	// end col for block mode operator
3704     long	prev_opcount;	// ca.opcount saved for K_CURSORHOLD
3705     long	prev_count0;	// ca.count0 saved for K_CURSORHOLD
3706 } oparg_T;
3707 
3708 /*
3709  * Arguments for Normal mode commands.
3710  */
3711 typedef struct cmdarg_S
3712 {
3713     oparg_T	*oap;		// Operator arguments
3714     int		prechar;	// prefix character (optional, always 'g')
3715     int		cmdchar;	// command character
3716     int		nchar;		// next command character (optional)
3717     int		ncharC1;	// first composing character (optional)
3718     int		ncharC2;	// second composing character (optional)
3719     int		extra_char;	// yet another character (optional)
3720     long	opcount;	// count before an operator
3721     long	count0;		// count before command, default 0
3722     long	count1;		// count before command, default 1
3723     int		arg;		// extra argument from nv_cmds[]
3724     int		retval;		// return: CA_* values
3725     char_u	*searchbuf;	// return: pointer to search pattern or NULL
3726 } cmdarg_T;
3727 
3728 // values for retval:
3729 #define CA_COMMAND_BUSY	    1	// skip restarting edit() once
3730 #define CA_NO_ADJ_OP_END    2	// don't adjust operator end
3731 
3732 #ifdef CURSOR_SHAPE
3733 /*
3734  * struct to store values from 'guicursor' and 'mouseshape'
3735  */
3736 // Indexes in shape_table[]
3737 #define SHAPE_IDX_N	0	// Normal mode
3738 #define SHAPE_IDX_V	1	// Visual mode
3739 #define SHAPE_IDX_I	2	// Insert mode
3740 #define SHAPE_IDX_R	3	// Replace mode
3741 #define SHAPE_IDX_C	4	// Command line Normal mode
3742 #define SHAPE_IDX_CI	5	// Command line Insert mode
3743 #define SHAPE_IDX_CR	6	// Command line Replace mode
3744 #define SHAPE_IDX_O	7	// Operator-pending mode
3745 #define SHAPE_IDX_VE	8	// Visual mode with 'selection' exclusive
3746 #define SHAPE_IDX_CLINE	9	// On command line
3747 #define SHAPE_IDX_STATUS 10	// A status line
3748 #define SHAPE_IDX_SDRAG 11	// dragging a status line
3749 #define SHAPE_IDX_VSEP	12	// A vertical separator line
3750 #define SHAPE_IDX_VDRAG 13	// dragging a vertical separator line
3751 #define SHAPE_IDX_MORE	14	// Hit-return or More
3752 #define SHAPE_IDX_MOREL	15	// Hit-return or More in last line
3753 #define SHAPE_IDX_SM	16	// showing matching paren
3754 #define SHAPE_IDX_COUNT	17
3755 
3756 #define SHAPE_BLOCK	0	// block cursor
3757 #define SHAPE_HOR	1	// horizontal bar cursor
3758 #define SHAPE_VER	2	// vertical bar cursor
3759 
3760 #define MSHAPE_NUMBERED	1000	// offset for shapes identified by number
3761 #define MSHAPE_HIDE	1	// hide mouse pointer
3762 
3763 #define SHAPE_MOUSE	1	// used for mouse pointer shape
3764 #define SHAPE_CURSOR	2	// used for text cursor shape
3765 
3766 typedef struct cursor_entry
3767 {
3768     int		shape;		// one of the SHAPE_ defines
3769     int		mshape;		// one of the MSHAPE defines
3770     int		percentage;	// percentage of cell for bar
3771     long	blinkwait;	// blinking, wait time before blinking starts
3772     long	blinkon;	// blinking, on time
3773     long	blinkoff;	// blinking, off time
3774     int		id;		// highlight group ID
3775     int		id_lm;		// highlight group ID for :lmap mode
3776     char	*name;		// mode name (fixed)
3777     char	used_for;	// SHAPE_MOUSE and/or SHAPE_CURSOR
3778 } cursorentry_T;
3779 #endif // CURSOR_SHAPE
3780 
3781 #ifdef FEAT_MENU
3782 
3783 // Indices into vimmenu_T->strings[] and vimmenu_T->noremap[] for each mode
3784 #define MENU_INDEX_INVALID	-1
3785 #define MENU_INDEX_NORMAL	0
3786 #define MENU_INDEX_VISUAL	1
3787 #define MENU_INDEX_SELECT	2
3788 #define MENU_INDEX_OP_PENDING	3
3789 #define MENU_INDEX_INSERT	4
3790 #define MENU_INDEX_CMDLINE	5
3791 #define MENU_INDEX_TERMINAL	6
3792 #define MENU_INDEX_TIP		7
3793 #define MENU_MODES		8
3794 
3795 // Menu modes
3796 #define MENU_NORMAL_MODE	(1 << MENU_INDEX_NORMAL)
3797 #define MENU_VISUAL_MODE	(1 << MENU_INDEX_VISUAL)
3798 #define MENU_SELECT_MODE	(1 << MENU_INDEX_SELECT)
3799 #define MENU_OP_PENDING_MODE	(1 << MENU_INDEX_OP_PENDING)
3800 #define MENU_INSERT_MODE	(1 << MENU_INDEX_INSERT)
3801 #define MENU_CMDLINE_MODE	(1 << MENU_INDEX_CMDLINE)
3802 #define MENU_TERMINAL_MODE	(1 << MENU_INDEX_TERMINAL)
3803 #define MENU_TIP_MODE		(1 << MENU_INDEX_TIP)
3804 #define MENU_ALL_MODES		((1 << MENU_INDEX_TIP) - 1)
3805 // note MENU_INDEX_TIP is not a 'real' mode
3806 
3807 // Start a menu name with this to not include it on the main menu bar
3808 #define MNU_HIDDEN_CHAR		']'
3809 
3810 struct VimMenu
3811 {
3812     int		modes;		    // Which modes is this menu visible for?
3813     int		enabled;	    // for which modes the menu is enabled
3814     char_u	*name;		    // Name of menu, possibly translated
3815     char_u	*dname;		    // Displayed Name ("name" without '&')
3816 #ifdef FEAT_MULTI_LANG
3817     char_u	*en_name;	    // "name" untranslated, NULL when "name"
3818 				    // was not translated
3819     char_u	*en_dname;	    // "dname" untranslated, NULL when "dname"
3820 				    // was not translated
3821 #endif
3822     int		mnemonic;	    // mnemonic key (after '&')
3823     char_u	*actext;	    // accelerator text (after TAB)
3824     int		priority;	    // Menu order priority
3825 #ifdef FEAT_GUI
3826     void	(*cb)(vimmenu_T *); // Call-back function
3827 #endif
3828 #ifdef FEAT_TOOLBAR
3829     char_u	*iconfile;	    // name of file for icon or NULL
3830     int		iconidx;	    // icon index (-1 if not set)
3831     int		icon_builtin;	    // icon names is BuiltIn{nr}
3832 #endif
3833     char_u	*strings[MENU_MODES]; // Mapped string for each mode
3834     int		noremap[MENU_MODES]; // A REMAP_ flag for each mode
3835     char	silent[MENU_MODES]; // A silent flag for each mode
3836     vimmenu_T	*children;	    // Children of sub-menu
3837     vimmenu_T	*parent;	    // Parent of menu
3838     vimmenu_T	*next;		    // Next item in menu
3839 #ifdef FEAT_GUI_X11
3840     Widget	id;		    // Manage this to enable item
3841     Widget	submenu_id;	    // If this is submenu, add children here
3842 #endif
3843 #ifdef FEAT_GUI_GTK
3844     GtkWidget	*id;		    // Manage this to enable item
3845     GtkWidget	*submenu_id;	    // If this is submenu, add children here
3846 # if defined(GTK_CHECK_VERSION) && !GTK_CHECK_VERSION(3,4,0)
3847     GtkWidget	*tearoff_handle;
3848 # endif
3849     GtkWidget   *label;		    // Used by "set wak=" code.
3850 #endif
3851 #ifdef FEAT_GUI_MOTIF
3852     int		sensitive;	    // turn button on/off
3853     char	**xpm;		    // pixmap data
3854     char	*xpm_fname;	    // file with pixmap data
3855 #endif
3856 #ifdef FEAT_GUI_ATHENA
3857     Pixmap	image;		    // Toolbar image
3858 #endif
3859 #ifdef FEAT_BEVAL_TIP
3860     BalloonEval *tip;		    // tooltip for this menu item
3861 #endif
3862 #ifdef FEAT_GUI_MSWIN
3863     UINT	id;		    // Id of menu item
3864     HMENU	submenu_id;	    // If this is submenu, add children here
3865     HWND	tearoff_handle;	    // hWnd of tearoff if created
3866 #endif
3867 #if FEAT_GUI_HAIKU
3868     BMenuItem  *id;		    // Id of menu item
3869     BMenu  *submenu_id;		    // If this is submenu, add children here
3870 # ifdef FEAT_TOOLBAR
3871     BPictureButton *button;
3872 # endif
3873 #endif
3874 #ifdef FEAT_GUI_PHOTON
3875     PtWidget_t	*id;
3876     PtWidget_t	*submenu_id;
3877 #endif
3878 };
3879 #else
3880 // For generating prototypes when FEAT_MENU isn't defined.
3881 typedef int vimmenu_T;
3882 
3883 #endif // FEAT_MENU
3884 
3885 /*
3886  * Struct to save values in before executing autocommands for a buffer that is
3887  * not the current buffer.
3888  */
3889 typedef struct
3890 {
3891     buf_T	*save_curbuf;	// saved curbuf
3892     int		use_aucmd_win;	// using aucmd_win
3893     win_T	*save_curwin;	// saved curwin
3894     win_T	*new_curwin;	// new curwin
3895     win_T	*save_prevwin;	// saved prevwin
3896     bufref_T	new_curbuf;	// new curbuf
3897     char_u	*globaldir;	// saved value of globaldir
3898 } aco_save_T;
3899 
3900 /*
3901  * Generic option table item, only used for printer at the moment.
3902  */
3903 typedef struct
3904 {
3905     const char	*name;
3906     int		hasnum;
3907     long	number;
3908     char_u	*string;	// points into option string
3909     int		strlen;
3910     int		present;
3911 } option_table_T;
3912 
3913 /*
3914  * Structure to hold printing color and font attributes.
3915  */
3916 typedef struct
3917 {
3918     long_u	fg_color;
3919     long_u	bg_color;
3920     int		bold;
3921     int		italic;
3922     int		underline;
3923     int		undercurl;
3924 } prt_text_attr_T;
3925 
3926 /*
3927  * Structure passed back to the generic printer code.
3928  */
3929 typedef struct
3930 {
3931     int		n_collated_copies;
3932     int		n_uncollated_copies;
3933     int		duplex;
3934     int		chars_per_line;
3935     int		lines_per_page;
3936     int		has_color;
3937     prt_text_attr_T number;
3938 #ifdef FEAT_SYN_HL
3939     int		modec;
3940     int		do_syntax;
3941 #endif
3942     int		user_abort;
3943     char_u	*jobname;
3944 #ifdef FEAT_POSTSCRIPT
3945     char_u	*outfile;
3946     char_u	*arguments;
3947 #endif
3948 } prt_settings_T;
3949 
3950 #define PRINT_NUMBER_WIDTH 8
3951 
3952 /*
3953  * Used for popup menu items.
3954  */
3955 typedef struct
3956 {
3957     char_u	*pum_text;	// main menu text
3958     char_u	*pum_kind;	// extra kind text (may be truncated)
3959     char_u	*pum_extra;	// extra menu text (may be truncated)
3960     char_u	*pum_info;	// extra info
3961 } pumitem_T;
3962 
3963 /*
3964  * Structure used for get_tagfname().
3965  */
3966 typedef struct
3967 {
3968     char_u	*tn_tags;	// value of 'tags' when starting
3969     char_u	*tn_np;		// current position in tn_tags
3970     int		tn_did_filefind_init;
3971     int		tn_hf_idx;
3972     void	*tn_search_ctx;
3973 } tagname_T;
3974 
3975 typedef struct {
3976   UINT32_T total[2];
3977   UINT32_T state[8];
3978   char_u   buffer[64];
3979 } context_sha256_T;
3980 
3981 /*
3982  * types for expressions.
3983  */
3984 typedef enum
3985 {
3986     EXPR_UNKNOWN = 0,
3987     EXPR_EQUAL,		// ==
3988     EXPR_NEQUAL,	// !=
3989     EXPR_GREATER,	// >
3990     EXPR_GEQUAL,	// >=
3991     EXPR_SMALLER,	// <
3992     EXPR_SEQUAL,	// <=
3993     EXPR_MATCH,		// =~
3994     EXPR_NOMATCH,	// !~
3995     EXPR_IS,		// is
3996     EXPR_ISNOT,		// isnot
3997     // used with ISN_OPNR
3998     EXPR_ADD,		// +
3999     EXPR_SUB,		// -
4000     EXPR_MULT,		// *
4001     EXPR_DIV,		// /
4002     EXPR_REM,		// %
4003 } exptype_T;
4004 
4005 /*
4006  * Structure used for reading in json_decode().
4007  */
4008 struct js_reader
4009 {
4010     char_u	*js_buf;	// text to be decoded
4011     char_u	*js_end;	// NUL in js_buf
4012     int		js_used;	// bytes used from js_buf
4013     int		(*js_fill)(struct js_reader *);
4014 				// function to fill the buffer or NULL;
4015 				// return TRUE when the buffer was filled
4016     void	*js_cookie;	// can be used by js_fill
4017     int		js_cookie_arg;	// can be used by js_fill
4018 };
4019 typedef struct js_reader js_read_T;
4020 
4021 // Maximum number of commands from + or -c arguments.
4022 #define MAX_ARG_CMDS 10
4023 
4024 // values for "window_layout"
4025 #define WIN_HOR	    1	    // "-o" horizontally split windows
4026 #define	WIN_VER	    2	    // "-O" vertically split windows
4027 #define	WIN_TABS    3	    // "-p" windows on tab pages
4028 
4029 // Struct for various parameters passed between main() and other functions.
4030 typedef struct
4031 {
4032     int		argc;
4033     char	**argv;
4034 
4035     char_u	*fname;			// first file to edit
4036 
4037     int		evim_mode;		// started as "evim"
4038     char_u	*use_vimrc;		// vimrc from -u argument
4039     int		clean;			// --clean argument
4040 
4041     int		n_commands;		     // no. of commands from + or -c
4042     char_u	*commands[MAX_ARG_CMDS];     // commands from + or -c arg.
4043     char_u	cmds_tofree[MAX_ARG_CMDS];   // commands that need free()
4044     int		n_pre_commands;		     // no. of commands from --cmd
4045     char_u	*pre_commands[MAX_ARG_CMDS]; // commands from --cmd argument
4046 
4047     int		edit_type;		// type of editing to do
4048     char_u	*tagname;		// tag from -t argument
4049 #ifdef FEAT_QUICKFIX
4050     char_u	*use_ef;		// 'errorfile' from -q argument
4051 #endif
4052 
4053     int		want_full_screen;
4054     int		not_a_term;		// no warning for missing term?
4055     int		tty_fail;		// exit if not a tty
4056     char_u	*term;			// specified terminal name
4057 #ifdef FEAT_CRYPT
4058     int		ask_for_key;		// -x argument
4059 #endif
4060     int		no_swap_file;		// "-n" argument used
4061 #ifdef FEAT_EVAL
4062     int		use_debug_break_level;
4063 #endif
4064     int		window_count;		// number of windows to use
4065     int		window_layout;		// 0, WIN_HOR, WIN_VER or WIN_TABS
4066 
4067 #ifdef FEAT_CLIENTSERVER
4068     int		serverArg;		// TRUE when argument for a server
4069     char_u	*serverName_arg;	// cmdline arg for server name
4070     char_u	*serverStr;		// remote server command
4071     char_u	*serverStrEnc;		// encoding of serverStr
4072     char_u	*servername;		// allocated name for our server
4073 #endif
4074 #if !defined(UNIX)
4075 # define EXPAND_FILENAMES
4076     int		literal;		// don't expand file names
4077 #endif
4078 #ifdef MSWIN
4079     int		full_path;		// file name argument was full path
4080 #endif
4081 #ifdef FEAT_DIFF
4082     int		diff_mode;		// start with 'diff' set
4083 #endif
4084 } mparm_T;
4085 
4086 /*
4087  * Structure returned by get_lval() and used by set_var_lval().
4088  * For a plain name:
4089  *	"name"	    points to the variable name.
4090  *	"exp_name"  is NULL.
4091  *	"tv"	    is NULL
4092  * For a magic braces name:
4093  *	"name"	    points to the expanded variable name.
4094  *	"exp_name"  is non-NULL, to be freed later.
4095  *	"tv"	    is NULL
4096  * For an index in a list:
4097  *	"name"	    points to the (expanded) variable name.
4098  *	"exp_name"  NULL or non-NULL, to be freed later.
4099  *	"tv"	    points to the (first) list item value
4100  *	"li"	    points to the (first) list item
4101  *	"range", "n1", "n2" and "empty2" indicate what items are used.
4102  * For an existing Dict item:
4103  *	"name"	    points to the (expanded) variable name.
4104  *	"exp_name"  NULL or non-NULL, to be freed later.
4105  *	"tv"	    points to the dict item value
4106  *	"newkey"    is NULL
4107  * For a non-existing Dict item:
4108  *	"name"	    points to the (expanded) variable name.
4109  *	"exp_name"  NULL or non-NULL, to be freed later.
4110  *	"tv"	    points to the Dictionary typval_T
4111  *	"newkey"    is the key for the new item.
4112  */
4113 typedef struct lval_S
4114 {
4115     char_u	*ll_name;	// start of variable name (can be NULL)
4116     char_u	*ll_name_end;	// end of variable name (can be NULL)
4117     type_T	*ll_type;	// type of variable (can be NULL)
4118     char_u	*ll_exp_name;	// NULL or expanded name in allocated memory.
4119     typval_T	*ll_tv;		// Typeval of item being used.  If "newkey"
4120 				// isn't NULL it's the Dict to which to add
4121 				// the item.
4122     listitem_T	*ll_li;		// The list item or NULL.
4123     list_T	*ll_list;	// The list or NULL.
4124     int		ll_range;	// TRUE when a [i:j] range was used
4125     int		ll_empty2;	// Second index is empty: [i:]
4126     long	ll_n1;		// First index for list
4127     long	ll_n2;		// Second index for list range
4128     dict_T	*ll_dict;	// The Dictionary or NULL
4129     dictitem_T	*ll_di;		// The dictitem or NULL
4130     char_u	*ll_newkey;	// New key for Dict in alloc. mem or NULL.
4131     type_T	*ll_valtype;	// type expected for the value or NULL
4132     blob_T	*ll_blob;	// The Blob or NULL
4133 } lval_T;
4134 
4135 // Structure used to save the current state.  Used when executing Normal mode
4136 // commands while in any other mode.
4137 typedef struct {
4138     int		save_msg_scroll;
4139     int		save_restart_edit;
4140     int		save_msg_didout;
4141     int		save_State;
4142     int		save_insertmode;
4143     int		save_finish_op;
4144     int		save_opcount;
4145     int		save_reg_executing;
4146     tasave_T	tabuf;
4147 } save_state_T;
4148 
4149 typedef struct {
4150     varnumber_T vv_prevcount;
4151     varnumber_T vv_count;
4152     varnumber_T vv_count1;
4153 } vimvars_save_T;
4154 
4155 // Scope for changing directory
4156 typedef enum {
4157     CDSCOPE_GLOBAL,	// :cd
4158     CDSCOPE_TABPAGE,	// :tcd
4159     CDSCOPE_WINDOW	// :lcd
4160 } cdscope_T;
4161 
4162 // Variable flavor
4163 typedef enum
4164 {
4165     VAR_FLAVOUR_DEFAULT,	// doesn't start with uppercase
4166     VAR_FLAVOUR_SESSION,	// starts with uppercase, some lower
4167     VAR_FLAVOUR_VIMINFO		// all uppercase
4168 } var_flavour_T;
4169 
4170 // argument for mouse_find_win()
4171 typedef enum {
4172     IGNORE_POPUP,	// only check non-popup windows
4173     FIND_POPUP,		// also find popup windows
4174     FAIL_POPUP		// return NULL if mouse on popup window
4175 } mouse_find_T;
4176 
4177 // Symbolic names for some registers.
4178 #define DELETION_REGISTER	36
4179 #ifdef FEAT_CLIPBOARD
4180 # define STAR_REGISTER		37
4181 #  ifdef FEAT_X11
4182 #   define PLUS_REGISTER	38
4183 #  else
4184 #   define PLUS_REGISTER	STAR_REGISTER	    // there is only one
4185 #  endif
4186 #endif
4187 #ifdef FEAT_DND
4188 # define TILDE_REGISTER		(PLUS_REGISTER + 1)
4189 #endif
4190 
4191 #ifdef FEAT_CLIPBOARD
4192 # ifdef FEAT_DND
4193 #  define NUM_REGISTERS		(TILDE_REGISTER + 1)
4194 # else
4195 #  define NUM_REGISTERS		(PLUS_REGISTER + 1)
4196 # endif
4197 #else
4198 # define NUM_REGISTERS		37
4199 #endif
4200 
4201 // structure used by block_prep, op_delete and op_yank for blockwise operators
4202 // also op_change, op_shift, op_insert, op_replace - AKelly
4203 struct block_def
4204 {
4205     int		startspaces;	// 'extra' cols before first char
4206     int		endspaces;	// 'extra' cols after last char
4207     int		textlen;	// chars in block
4208     char_u	*textstart;	// pointer to 1st char (partially) in block
4209     colnr_T	textcol;	// index of chars (partially) in block
4210     colnr_T	start_vcol;	// start col of 1st char wholly inside block
4211     colnr_T	end_vcol;	// start col of 1st char wholly after block
4212     int		is_short;	// TRUE if line is too short to fit in block
4213     int		is_MAX;		// TRUE if curswant==MAXCOL when starting
4214     int		is_oneChar;	// TRUE if block within one character
4215     int		pre_whitesp;	// screen cols of ws before block
4216     int		pre_whitesp_c;	// chars of ws before block
4217     colnr_T	end_char_vcols;	// number of vcols of post-block char
4218     colnr_T	start_char_vcols; // number of vcols of pre-block char
4219 };
4220 
4221 // Each yank register has an array of pointers to lines.
4222 typedef struct
4223 {
4224     char_u	**y_array;	// pointer to array of line pointers
4225     linenr_T	y_size;		// number of lines in y_array
4226     char_u	y_type;		// MLINE, MCHAR or MBLOCK
4227     colnr_T	y_width;	// only set if y_type == MBLOCK
4228 #ifdef FEAT_VIMINFO
4229     time_t	y_time_set;
4230 #endif
4231 } yankreg_T;
4232 
4233 // The offset for a search command is store in a soff struct
4234 // Note: only spats[0].off is really used
4235 typedef struct soffset
4236 {
4237     int		dir;		// search direction, '/' or '?'
4238     int		line;		// search has line offset
4239     int		end;		// search set cursor at end
4240     long	off;		// line or char offset
4241 } soffset_T;
4242 
4243 // A search pattern and its attributes are stored in a spat struct
4244 typedef struct spat
4245 {
4246     char_u	    *pat;	// the pattern (in allocated memory) or NULL
4247     int		    magic;	// magicness of the pattern
4248     int		    no_scs;	// no smartcase for this pattern
4249     soffset_T	    off;
4250 } spat_T;
4251 
4252 /*
4253  * Optional extra arguments for searchit().
4254  */
4255 typedef struct
4256 {
4257     linenr_T	sa_stop_lnum;	// stop after this line number when != 0
4258 #ifdef FEAT_RELTIME
4259     proftime_T	*sa_tm;		// timeout limit or NULL
4260     int		sa_timed_out;	// set when timed out
4261 #endif
4262     int		sa_wrapped;	// search wrapped around
4263 } searchit_arg_T;
4264 
4265 
4266 #define WRITEBUFSIZE	8192	// size of normal write buffer
4267 
4268 #define FIO_LATIN1	0x01	// convert Latin1
4269 #define FIO_UTF8	0x02	// convert UTF-8
4270 #define FIO_UCS2	0x04	// convert UCS-2
4271 #define FIO_UCS4	0x08	// convert UCS-4
4272 #define FIO_UTF16	0x10	// convert UTF-16
4273 #ifdef MSWIN
4274 # define FIO_CODEPAGE	0x20	// convert MS-Windows codepage
4275 # define FIO_PUT_CP(x) (((x) & 0xffff) << 16)	// put codepage in top word
4276 # define FIO_GET_CP(x)	(((x)>>16) & 0xffff)	// get codepage from top word
4277 #endif
4278 #ifdef MACOS_CONVERT
4279 # define FIO_MACROMAN	0x20	// convert MacRoman
4280 #endif
4281 #define FIO_ENDIAN_L	0x80	// little endian
4282 #define FIO_ENCRYPTED	0x1000	// encrypt written bytes
4283 #define FIO_NOCONVERT	0x2000	// skip encoding conversion
4284 #define FIO_UCSBOM	0x4000	// check for BOM at start of file
4285 #define FIO_ALL	-1	// allow all formats
4286 
4287 // When converting, a read() or write() may leave some bytes to be converted
4288 // for the next call.  The value is guessed...
4289 #define CONV_RESTLEN 30
4290 
4291 // We have to guess how much a sequence of bytes may expand when converting
4292 // with iconv() to be able to allocate a buffer.
4293 #define ICONV_MULT 8
4294