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