xref: /vim-8.2.3635/src/structs.h (revision 98be7fec)
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 // Use 64-bit Number.
1249 #ifdef MSWIN
1250 # ifdef PROTO
1251    // workaround for cproto that doesn't recognize __int64
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_NO_LONG_LONG)
1265 # if defined(HAVE_STDINT_H)
1266    typedef int64_t		varnumber_T;
1267    typedef uint64_t		uvarnumber_T;
1268 #  define VARNUM_MIN		INT64_MIN
1269 #  define VARNUM_MAX		INT64_MAX
1270 #  define UVARNUM_MAX		UINT64_MAX
1271 # else
1272    // this may cause trouble for code that depends on 64 bit ints
1273    typedef long			varnumber_T;
1274    typedef unsigned long	uvarnumber_T;
1275 #  define VARNUM_MIN		LONG_MIN
1276 #  define VARNUM_MAX		LONG_MAX
1277 #  define UVARNUM_MAX		ULONG_MAX
1278 # endif
1279 #else
1280   typedef long long		varnumber_T;
1281   typedef unsigned long long	uvarnumber_T;
1282 # ifdef LLONG_MIN
1283 #  define VARNUM_MIN		LLONG_MIN
1284 #  define VARNUM_MAX		LLONG_MAX
1285 #  define UVARNUM_MAX		ULLONG_MAX
1286 # else
1287 #  define VARNUM_MIN		LONG_LONG_MIN
1288 #  define VARNUM_MAX		LONG_LONG_MAX
1289 #  define UVARNUM_MAX		ULONG_LONG_MAX
1290 # endif
1291 #endif
1292 
1293 typedef double	float_T;
1294 
1295 typedef struct listvar_S list_T;
1296 typedef struct dictvar_S dict_T;
1297 typedef struct partial_S partial_T;
1298 typedef struct blobvar_S blob_T;
1299 
1300 // Struct that holds both a normal function name and a partial_T, as used for a
1301 // callback argument.
1302 // When used temporarily "cb_name" is not allocated.  The refcounts to either
1303 // the function or the partial are incremented and need to be decremented
1304 // later with free_callback().
1305 typedef struct {
1306     char_u	*cb_name;
1307     partial_T	*cb_partial;
1308     int		cb_free_name;	    // cb_name was allocated
1309 } callback_T;
1310 
1311 typedef struct dfunc_S dfunc_T;	    // :def function
1312 
1313 typedef struct jobvar_S job_T;
1314 typedef struct readq_S readq_T;
1315 typedef struct writeq_S writeq_T;
1316 typedef struct jsonq_S jsonq_T;
1317 typedef struct cbq_S cbq_T;
1318 typedef struct channel_S channel_T;
1319 typedef struct cctx_S cctx_T;
1320 
1321 typedef enum
1322 {
1323     VAR_UNKNOWN = 0,	// not set, also used for "any" type
1324     VAR_VOID,		// no value
1325     VAR_BOOL,		// "v_number" is used: VVAL_TRUE or VVAL_FALSE
1326     VAR_SPECIAL,	// "v_number" is used: VVAL_NULL or VVAL_NONE
1327     VAR_NUMBER,		// "v_number" is used
1328     VAR_FLOAT,		// "v_float" is used
1329     VAR_STRING,		// "v_string" is used
1330     VAR_BLOB,		// "v_blob" is used
1331     VAR_FUNC,		// "v_string" is function name
1332     VAR_PARTIAL,	// "v_partial" is used
1333     VAR_LIST,		// "v_list" is used
1334     VAR_DICT,		// "v_dict" is used
1335     VAR_JOB,		// "v_job" is used
1336     VAR_CHANNEL,	// "v_channel" is used
1337 } vartype_T;
1338 
1339 // A type specification.
1340 typedef struct type_S type_T;
1341 struct type_S {
1342     vartype_T	    tt_type;
1343     short	    tt_argcount;    // for func, partial, -1 for unknown
1344     type_T	    *tt_member;	    // for list, dict, func return type
1345     type_T	    *tt_args;	    // func arguments
1346 };
1347 
1348 /*
1349  * Structure to hold an internal variable without a name.
1350  */
1351 typedef struct
1352 {
1353     vartype_T	v_type;
1354     char	v_lock;	    // see below: VAR_LOCKED, VAR_FIXED
1355     union
1356     {
1357 	varnumber_T	v_number;	// number value
1358 #ifdef FEAT_FLOAT
1359 	float_T		v_float;	// floating number value
1360 #endif
1361 	char_u		*v_string;	// string value (can be NULL!)
1362 	list_T		*v_list;	// list value (can be NULL!)
1363 	dict_T		*v_dict;	// dict value (can be NULL!)
1364 	partial_T	*v_partial;	// closure: function with args
1365 #ifdef FEAT_JOB_CHANNEL
1366 	job_T		*v_job;		// job value (can be NULL!)
1367 	channel_T	*v_channel;	// channel value (can be NULL!)
1368 #endif
1369 	blob_T		*v_blob;	// blob value (can be NULL!)
1370     }		vval;
1371 } typval_T;
1372 
1373 // Values for "dv_scope".
1374 #define VAR_SCOPE     1	// a:, v:, s:, etc. scope dictionaries
1375 #define VAR_DEF_SCOPE 2	// l:, g: scope dictionaries: here funcrefs are not
1376 			// allowed to mask existing functions
1377 
1378 // Values for "v_lock".
1379 #define VAR_LOCKED  1	// locked with lock(), can use unlock()
1380 #define VAR_FIXED   2	// locked forever
1381 
1382 /*
1383  * Structure to hold an item of a list: an internal variable without a name.
1384  */
1385 typedef struct listitem_S listitem_T;
1386 
1387 struct listitem_S
1388 {
1389     listitem_T	*li_next;	// next item in list
1390     listitem_T	*li_prev;	// previous item in list
1391     typval_T	li_tv;		// type and value of the variable
1392 };
1393 
1394 // Struct used by those that are using an item in a list.
1395 typedef struct listwatch_S listwatch_T;
1396 
1397 struct listwatch_S
1398 {
1399     listitem_T		*lw_item;	// item being watched
1400     listwatch_T		*lw_next;	// next watcher
1401 };
1402 
1403 /*
1404  * Structure to hold info about a list.
1405  * Order of members is optimized to reduce padding.
1406  * When created by range() it will at first have special value:
1407  *  lv_first == &range_list_item;
1408  * and use lv_start, lv_end, lv_stride.
1409  */
1410 struct listvar_S
1411 {
1412     listitem_T	*lv_first;	// first item, NULL if none
1413     listwatch_T	*lv_watch;	// first watcher, NULL if none
1414     union {
1415 	struct {	// used for non-materialized range list:
1416 			// "lv_first" is &range_list_item
1417 	    varnumber_T lv_start;
1418 	    varnumber_T lv_end;
1419 	    int		lv_stride;
1420 	} nonmat;
1421 	struct {	// used for materialized list
1422 	    listitem_T	*lv_last;	// last item, NULL if none
1423 	    listitem_T	*lv_idx_item;	// when not NULL item at index "lv_idx"
1424 	    int		lv_idx;		// cached index of an item
1425 	} mat;
1426     } lv_u;
1427     list_T	*lv_copylist;	// copied list used by deepcopy()
1428     list_T	*lv_used_next;	// next list in used lists list
1429     list_T	*lv_used_prev;	// previous list in used lists list
1430     int		lv_refcount;	// reference count
1431     int		lv_len;		// number of items
1432     int		lv_with_items;	// number of items following this struct that
1433 				// should not be freed
1434     int		lv_copyID;	// ID used by deepcopy()
1435     char	lv_lock;	// zero, VAR_LOCKED, VAR_FIXED
1436 };
1437 
1438 /*
1439  * Static list with 10 items.  Use init_static_list() to initialize.
1440  */
1441 typedef struct {
1442     list_T	sl_list;	// must be first
1443     listitem_T	sl_items[10];
1444 } staticList10_T;
1445 
1446 /*
1447  * Structure to hold an item of a Dictionary.
1448  * Also used for a variable.
1449  * The key is copied into "di_key" to avoid an extra alloc/free for it.
1450  */
1451 struct dictitem_S
1452 {
1453     typval_T	di_tv;		// type and value of the variable
1454     char_u	di_flags;	// DI_FLAGS_ flags (only used for variable)
1455     char_u	di_key[1];	// key (actually longer!)
1456 };
1457 typedef struct dictitem_S dictitem_T;
1458 
1459 /*
1460  * A dictitem with a 16 character key (plus NUL).  This is an efficient way to
1461  * have a fixed-size dictitem.
1462  */
1463 #define DICTITEM16_KEY_LEN 16
1464 struct dictitem16_S
1465 {
1466     typval_T	di_tv;		// type and value of the variable
1467     char_u	di_flags;	// DI_FLAGS_ flags (only used for variable)
1468     char_u	di_key[DICTITEM16_KEY_LEN + 1];	// key
1469 };
1470 typedef struct dictitem16_S dictitem16_T;
1471 
1472 // Flags for "di_flags"
1473 #define DI_FLAGS_RO	   0x01	    // read-only variable
1474 #define DI_FLAGS_RO_SBX	   0x02	    // read-only in the sandbox
1475 #define DI_FLAGS_FIX	   0x04	    // fixed: no :unlet or remove()
1476 #define DI_FLAGS_LOCK	   0x08	    // locked variable
1477 #define DI_FLAGS_ALLOC	   0x10	    // separately allocated
1478 #define DI_FLAGS_RELOAD	   0x20	    // set when script sourced again
1479 
1480 /*
1481  * Structure to hold info about a Dictionary.
1482  */
1483 struct dictvar_S
1484 {
1485     char	dv_lock;	// zero, VAR_LOCKED, VAR_FIXED
1486     char	dv_scope;	// zero, VAR_SCOPE, VAR_DEF_SCOPE
1487     int		dv_refcount;	// reference count
1488     int		dv_copyID;	// ID used by deepcopy()
1489     hashtab_T	dv_hashtab;	// hashtab that refers to the items
1490     dict_T	*dv_copydict;	// copied dict used by deepcopy()
1491     dict_T	*dv_used_next;	// next dict in used dicts list
1492     dict_T	*dv_used_prev;	// previous dict in used dicts list
1493 };
1494 
1495 /*
1496  * Structure to hold info about a blob.
1497  */
1498 struct blobvar_S
1499 {
1500     garray_T	bv_ga;		// growarray with the data
1501     int		bv_refcount;	// reference count
1502     char	bv_lock;	// zero, VAR_LOCKED, VAR_FIXED
1503 };
1504 
1505 #if defined(FEAT_EVAL) || defined(PROTO)
1506 typedef struct funccall_S funccall_T;
1507 
1508 /*
1509  * Structure to hold info for a user function.
1510  */
1511 typedef struct
1512 {
1513     int		uf_varargs;	// variable nr of arguments (old style)
1514     int		uf_flags;	// FC_ flags
1515     int		uf_calls;	// nr of active calls
1516     int		uf_cleared;	// func_clear() was already called
1517     int		uf_dfunc_idx;	// >= 0 for :def function only
1518     garray_T	uf_args;	// arguments
1519     garray_T	uf_def_args;	// default argument expressions
1520 
1521     // for :def (for :function uf_ret_type is NULL)
1522     type_T	**uf_arg_types;	// argument types (count == uf_args.ga_len)
1523     type_T	*uf_ret_type;	// return type
1524     garray_T	uf_type_list;	// types used in arg and return types
1525     int		*uf_def_arg_idx; // instruction indexes for evaluating
1526 				// uf_def_args; length: uf_def_args.ga_len + 1
1527     char_u	*uf_va_name;	// name from "...name" or NULL
1528     type_T	*uf_va_type;	// type from "...name: type" or NULL
1529 
1530     garray_T	uf_lines;	// function lines
1531 # ifdef FEAT_PROFILE
1532     int		uf_profiling;	// TRUE when func is being profiled
1533     int		uf_prof_initialized;
1534     // profiling the function as a whole
1535     int		uf_tm_count;	// nr of calls
1536     proftime_T	uf_tm_total;	// time spent in function + children
1537     proftime_T	uf_tm_self;	// time spent in function itself
1538     proftime_T	uf_tm_children;	// time spent in children this call
1539     // profiling the function per line
1540     int		*uf_tml_count;	// nr of times line was executed
1541     proftime_T	*uf_tml_total;	// time spent in a line + children
1542     proftime_T	*uf_tml_self;	// time spent in a line itself
1543     proftime_T	uf_tml_start;	// start time for current line
1544     proftime_T	uf_tml_children; // time spent in children for this line
1545     proftime_T	uf_tml_wait;	// start wait time for current line
1546     int		uf_tml_idx;	// index of line being timed; -1 if none
1547     int		uf_tml_execed;	// line being timed was executed
1548 # endif
1549     sctx_T	uf_script_ctx;	// SCTX where function was defined,
1550 				// used for s: variables
1551     int		uf_refcount;	// reference count, see func_name_refcount()
1552     funccall_T	*uf_scoped;	// l: local variables for closure
1553     char_u	*uf_name_exp;	// if "uf_name[]" starts with SNR the name with
1554 				// "<SNR>" as a string, otherwise NULL
1555     char_u	uf_name[1];	// name of function (actually longer); can
1556 				// start with <SNR>123_ (<SNR> is K_SPECIAL
1557 				// KS_EXTRA KE_SNR)
1558 } ufunc_T;
1559 
1560 #define MAX_FUNC_ARGS	20	// maximum number of function arguments
1561 #define VAR_SHORT_LEN	20	// short variable name length
1562 #define FIXVAR_CNT	12	// number of fixed variables
1563 
1564 /*
1565  * structure to hold info for a function that is currently being executed.
1566  */
1567 struct funccall_S
1568 {
1569     ufunc_T	*func;		// function being called
1570     int		linenr;		// next line to be executed
1571     int		returned;	// ":return" used
1572     struct			// fixed variables for arguments
1573     {
1574 	dictitem_T	var;		// variable (without room for name)
1575 	char_u	room[VAR_SHORT_LEN];	// room for the name
1576     } fixvar[FIXVAR_CNT];
1577     dict_T	l_vars;		// l: local function variables
1578     dictitem_T	l_vars_var;	// variable for l: scope
1579     dict_T	l_avars;	// a: argument variables
1580     dictitem_T	l_avars_var;	// variable for a: scope
1581     list_T	l_varlist;	// list for a:000
1582     listitem_T	l_listitems[MAX_FUNC_ARGS];	// listitems for a:000
1583     typval_T	*rettv;		// return value
1584     linenr_T	breakpoint;	// next line with breakpoint or zero
1585     int		dbg_tick;	// debug_tick when breakpoint was set
1586     int		level;		// top nesting level of executed function
1587 #ifdef FEAT_PROFILE
1588     proftime_T	prof_child;	// time spent in a child
1589 #endif
1590     funccall_T	*caller;	// calling function or NULL
1591 
1592     // for closure
1593     int		fc_refcount;	// number of user functions that reference this
1594 				// funccal
1595     int		fc_copyID;	// for garbage collection
1596     garray_T	fc_funcs;	// list of ufunc_T* which keep a reference to
1597 				// "func"
1598 };
1599 
1600 /*
1601  * Struct used by trans_function_name()
1602  */
1603 typedef struct
1604 {
1605     dict_T	*fd_dict;	// Dictionary used
1606     char_u	*fd_newkey;	// new key in "dict" in allocated memory
1607     dictitem_T	*fd_di;		// Dictionary item used
1608 } funcdict_T;
1609 
1610 typedef struct funccal_entry funccal_entry_T;
1611 struct funccal_entry {
1612     void	    *top_funccal;
1613     funccal_entry_T *next;
1614 };
1615 
1616 // From user function to hashitem and back.
1617 #define UF2HIKEY(fp) ((fp)->uf_name)
1618 #define HIKEY2UF(p)  ((ufunc_T *)((p) - offsetof(ufunc_T, uf_name)))
1619 #define HI2UF(hi)     HIKEY2UF((hi)->hi_key)
1620 
1621 /*
1622  * Holds the hashtab with variables local to each sourced script.
1623  * Each item holds a variable (nameless) that points to the dict_T.
1624  */
1625 typedef struct
1626 {
1627     dictitem_T	sv_var;
1628     dict_T	sv_dict;
1629 } scriptvar_T;
1630 
1631 /*
1632  * Entry for "sn_var_vals".  Used for script-local variables.
1633  */
1634 typedef struct {
1635     char_u	*sv_name;	// points into "sn_vars" di_key
1636     typval_T	*sv_tv;		// points into "sn_vars" di_tv
1637     type_T	*sv_type;
1638     int		sv_const;
1639     int		sv_export;	// "export let var = val"
1640 } svar_T;
1641 
1642 typedef struct {
1643     char_u	*imp_name;	    // name imported as (allocated)
1644     int		imp_sid;	    // script ID of "from"
1645 
1646     // for "import * as Name", "imp_name" is "Name"
1647     int		imp_all;
1648 
1649     // for variable
1650     type_T	*imp_type;
1651     int		imp_var_vals_idx;   // index in sn_var_vals of "from"
1652 
1653     // for function
1654     char_u	*imp_funcname;	    // user func name (NOT allocated)
1655 } imported_T;
1656 
1657 /*
1658  * Growarray to store info about already sourced scripts.
1659  * For Unix also store the dev/ino, so that we don't have to stat() each
1660  * script when going through the list.
1661  */
1662 typedef struct
1663 {
1664     char_u	*sn_name;
1665 
1666     scriptvar_T	*sn_vars;	// stores s: variables for this script
1667     garray_T	sn_var_vals;	// same variables as a list of svar_T
1668 
1669     garray_T	sn_imports;	// imported items, imported_T
1670 
1671     garray_T	sn_type_list;	// keeps types used by variables
1672 
1673     int		sn_version;	// :scriptversion
1674     int		sn_had_command;	// TRUE if any command was executed
1675     char_u	*sn_save_cpo;	// 'cpo' value when :vim9script found
1676 
1677 # ifdef FEAT_PROFILE
1678     int		sn_prof_on;	// TRUE when script is/was profiled
1679     int		sn_pr_force;	// forceit: profile functions in this script
1680     proftime_T	sn_pr_child;	// time set when going into first child
1681     int		sn_pr_nest;	// nesting for sn_pr_child
1682     // profiling the script as a whole
1683     int		sn_pr_count;	// nr of times sourced
1684     proftime_T	sn_pr_total;	// time spent in script + children
1685     proftime_T	sn_pr_self;	// time spent in script itself
1686     proftime_T	sn_pr_start;	// time at script start
1687     proftime_T	sn_pr_children; // time in children after script start
1688     // profiling the script per line
1689     garray_T	sn_prl_ga;	// things stored for every line
1690     proftime_T	sn_prl_start;	// start time for current line
1691     proftime_T	sn_prl_children; // time spent in children for this line
1692     proftime_T	sn_prl_wait;	// wait start time for current line
1693     int		sn_prl_idx;	// index of line being timed; -1 if none
1694     int		sn_prl_execed;	// line being timed was executed
1695 # endif
1696 } scriptitem_T;
1697 
1698 # ifdef FEAT_PROFILE
1699 /*
1700  * Struct used in sn_prl_ga for every line of a script.
1701  */
1702 typedef struct sn_prl_S
1703 {
1704     int		snp_count;	// nr of times line was executed
1705     proftime_T	sn_prl_total;	// time spent in a line + children
1706     proftime_T	sn_prl_self;	// time spent in a line itself
1707 } sn_prl_T;
1708 
1709 #  define PRL_ITEM(si, idx)	(((sn_prl_T *)(si)->sn_prl_ga.ga_data)[(idx)])
1710 # endif
1711 #else
1712 // dummy typedefs for use in function prototypes
1713 typedef struct
1714 {
1715     int	    dummy;
1716 } ufunc_T;
1717 typedef struct
1718 {
1719     int	    dummy;
1720 } funccall_T;
1721 typedef struct
1722 {
1723     int	    dummy;
1724 } funcdict_T;
1725 typedef struct
1726 {
1727     int	    dummy;
1728 } funccal_entry_T;
1729 typedef struct
1730 {
1731     int	    dummy;
1732 } scriptitem_T;
1733 #endif
1734 
1735 // Struct passed between functions dealing with function call execution.
1736 //
1737 // "argv_func", when not NULL, can be used to fill in arguments only when the
1738 // invoked function uses them.  It is called like this:
1739 //   new_argcount = argv_func(current_argcount, argv, partial_argcount,
1740 //							called_func_argcount)
1741 //
1742 typedef struct {
1743     int		(* argv_func)(int, typval_T *, int, int);
1744     linenr_T	firstline;	// first line of range
1745     linenr_T	lastline;	// last line of range
1746     int		*doesrange;	// if not NULL: return: function handled range
1747     int		evaluate;	// actually evaluate expressions
1748     partial_T	*partial;	// for extra arguments
1749     dict_T	*selfdict;	// Dictionary for "self"
1750     typval_T	*basetv;	// base for base->method()
1751 } funcexe_T;
1752 
1753 struct partial_S
1754 {
1755     int		pt_refcount;	// reference count
1756     char_u	*pt_name;	// function name; when NULL use
1757 				// pt_func->uf_name
1758     ufunc_T	*pt_func;	// function pointer; when NULL lookup function
1759 				// with pt_name
1760     int		pt_auto;	// when TRUE the partial was created for using
1761 				// dict.member in handle_subscript()
1762     int		pt_argc;	// number of arguments
1763     typval_T	*pt_argv;	// arguments in allocated array
1764     dict_T	*pt_dict;	// dict for "self"
1765 };
1766 
1767 typedef struct AutoPatCmd_S AutoPatCmd;
1768 
1769 /*
1770  * Entry in the execution stack "exestack".
1771  */
1772 typedef enum {
1773     ETYPE_TOP,		    // toplevel
1774     ETYPE_SCRIPT,           // sourcing script, use es_info.sctx
1775     ETYPE_UFUNC,            // user function, use es_info.ufunc
1776     ETYPE_AUCMD,            // autocomand, use es_info.aucmd
1777     ETYPE_MODELINE,         // modeline, use es_info.sctx
1778     ETYPE_EXCEPT,           // exception, use es_info.exception
1779     ETYPE_ARGS,             // command line argument
1780     ETYPE_ENV,              // environment variable
1781     ETYPE_INTERNAL,         // internal operation
1782     ETYPE_SPELL,            // loading spell file
1783 } etype_T;
1784 
1785 typedef struct {
1786     long      es_lnum;      // replaces "sourcing_lnum"
1787     char_u    *es_name;     // replaces "sourcing_name"
1788     etype_T   es_type;
1789     union {
1790 	sctx_T  *sctx;      // script and modeline info
1791 #if defined(FEAT_EVAL)
1792 	ufunc_T *ufunc;     // function info
1793 #endif
1794 	AutoPatCmd *aucmd;  // autocommand info
1795 	except_T   *except; // exception info
1796     } es_info;
1797 } estack_T;
1798 
1799 // Information returned by get_tty_info().
1800 typedef struct {
1801     int backspace;	// what the Backspace key produces
1802     int enter;		// what the Enter key produces
1803     int interrupt;	// interrupt character
1804     int nl_does_cr;	// TRUE when a NL is expanded to CR-NL on output
1805 } ttyinfo_T;
1806 
1807 // Status of a job.  Order matters!
1808 typedef enum
1809 {
1810     JOB_FAILED,
1811     JOB_STARTED,
1812     JOB_ENDED,	    // detected job done
1813     JOB_FINISHED,   // job done and cleanup done
1814 } jobstatus_T;
1815 
1816 /*
1817  * Structure to hold info about a Job.
1818  */
1819 struct jobvar_S
1820 {
1821     job_T	*jv_next;
1822     job_T	*jv_prev;
1823 #ifdef UNIX
1824     pid_t	jv_pid;
1825 #endif
1826 #ifdef MSWIN
1827     PROCESS_INFORMATION	jv_proc_info;
1828     HANDLE		jv_job_object;
1829 #endif
1830     char_u	*jv_tty_in;	// controlling tty input, allocated
1831     char_u	*jv_tty_out;	// controlling tty output, allocated
1832     jobstatus_T	jv_status;
1833     char_u	*jv_stoponexit;	// allocated
1834 #ifdef UNIX
1835     char_u	*jv_termsig;	// allocated
1836 #endif
1837 #ifdef MSWIN
1838     char_u	*jv_tty_type;	// allocated
1839 #endif
1840     int		jv_exitval;
1841     callback_T	jv_exit_cb;
1842 
1843     buf_T	*jv_in_buf;	// buffer from "in-name"
1844 
1845     int		jv_refcount;	// reference count
1846     int		jv_copyID;
1847 
1848     channel_T	*jv_channel;	// channel for I/O, reference counted
1849     char	**jv_argv;	// command line used to start the job
1850 };
1851 
1852 /*
1853  * Structures to hold info about a Channel.
1854  */
1855 struct readq_S
1856 {
1857     char_u	*rq_buffer;
1858     long_u	rq_buflen;
1859     readq_T	*rq_next;
1860     readq_T	*rq_prev;
1861 };
1862 
1863 struct writeq_S
1864 {
1865     garray_T	wq_ga;
1866     writeq_T	*wq_next;
1867     writeq_T	*wq_prev;
1868 };
1869 
1870 struct jsonq_S
1871 {
1872     typval_T	*jq_value;
1873     jsonq_T	*jq_next;
1874     jsonq_T	*jq_prev;
1875     int		jq_no_callback; // TRUE when no callback was found
1876 };
1877 
1878 struct cbq_S
1879 {
1880     callback_T	cq_callback;
1881     int		cq_seq_nr;
1882     cbq_T	*cq_next;
1883     cbq_T	*cq_prev;
1884 };
1885 
1886 // mode for a channel
1887 typedef enum
1888 {
1889     MODE_NL = 0,
1890     MODE_RAW,
1891     MODE_JSON,
1892     MODE_JS,
1893 } ch_mode_T;
1894 
1895 typedef enum {
1896     JIO_PIPE,	    // default
1897     JIO_NULL,
1898     JIO_FILE,
1899     JIO_BUFFER,
1900     JIO_OUT
1901 } job_io_T;
1902 
1903 #define CH_PART_FD(part)	ch_part[part].ch_fd
1904 
1905 // Ordering matters, it is used in for loops: IN is last, only SOCK/OUT/ERR
1906 // are polled.
1907 typedef enum {
1908     PART_SOCK = 0,
1909 #define CH_SOCK_FD	CH_PART_FD(PART_SOCK)
1910 #ifdef FEAT_JOB_CHANNEL
1911     PART_OUT,
1912 # define CH_OUT_FD	CH_PART_FD(PART_OUT)
1913     PART_ERR,
1914 # define CH_ERR_FD	CH_PART_FD(PART_ERR)
1915     PART_IN,
1916 # define CH_IN_FD	CH_PART_FD(PART_IN)
1917 #endif
1918     PART_COUNT,
1919 } ch_part_T;
1920 
1921 #define INVALID_FD	(-1)
1922 
1923 // The per-fd info for a channel.
1924 typedef struct {
1925     sock_T	ch_fd;	    // socket/stdin/stdout/stderr, -1 if not used
1926 
1927 # if defined(UNIX) && !defined(HAVE_SELECT)
1928     int		ch_poll_idx;	// used by channel_poll_setup()
1929 # endif
1930 
1931 #ifdef FEAT_GUI_X11
1932     XtInputId	ch_inputHandler; // Cookie for input
1933 #endif
1934 #ifdef FEAT_GUI_GTK
1935     gint	ch_inputHandler; // Cookie for input
1936 #endif
1937 
1938     ch_mode_T	ch_mode;
1939     job_io_T	ch_io;
1940     int		ch_timeout;	// request timeout in msec
1941 
1942     readq_T	ch_head;	// header for circular raw read queue
1943     jsonq_T	ch_json_head;	// header for circular json read queue
1944     garray_T	ch_block_ids;	// list of IDs that channel_read_json_block()
1945 				// is waiting for
1946     // When ch_wait_len is non-zero use ch_deadline to wait for incomplete
1947     // message to be complete. The value is the length of the incomplete
1948     // message when the deadline was set.  If it gets longer (something was
1949     // received) the deadline is reset.
1950     size_t	ch_wait_len;
1951 #ifdef MSWIN
1952     DWORD	ch_deadline;
1953 #else
1954     struct timeval ch_deadline;
1955 #endif
1956     int		ch_block_write;	// for testing: 0 when not used, -1 when write
1957 				// does not block, 1 simulate blocking
1958     int		ch_nonblocking;	// write() is non-blocking
1959     writeq_T	ch_writeque;	// header for write queue
1960 
1961     cbq_T	ch_cb_head;	// dummy node for per-request callbacks
1962     callback_T	ch_callback;	// call when a msg is not handled
1963 
1964     bufref_T	ch_bufref;	// buffer to read from or write to
1965     int		ch_nomodifiable; // TRUE when buffer can be 'nomodifiable'
1966     int		ch_nomod_error;	// TRUE when e_modifiable was given
1967     int		ch_buf_append;	// write appended lines instead top-bot
1968     linenr_T	ch_buf_top;	// next line to send
1969     linenr_T	ch_buf_bot;	// last line to send
1970 } chanpart_T;
1971 
1972 struct channel_S {
1973     channel_T	*ch_next;
1974     channel_T	*ch_prev;
1975 
1976     int		ch_id;		// ID of the channel
1977     int		ch_last_msg_id;	// ID of the last message
1978 
1979     chanpart_T	ch_part[PART_COUNT]; // info for socket, out, err and in
1980     int		ch_write_text_mode; // write buffer lines with CR, not NL
1981 
1982     char	*ch_hostname;	// only for socket, allocated
1983     int		ch_port;	// only for socket
1984 
1985     int		ch_to_be_closed; // bitset of readable fds to be closed.
1986 				 // When all readable fds have been closed,
1987 				 // set to (1 << PART_COUNT).
1988     int		ch_to_be_freed; // When TRUE channel must be freed when it's
1989 				// safe to invoke callbacks.
1990     int		ch_error;	// When TRUE an error was reported.  Avoids
1991 				// giving pages full of error messages when
1992 				// the other side has exited, only mention the
1993 				// first error until the connection works
1994 				// again.
1995 
1996     void	(*ch_nb_close_cb)(void);
1997 				// callback for Netbeans when channel is
1998 				// closed
1999 
2000 #ifdef MSWIN
2001     int		ch_named_pipe;	// using named pipe instead of pty
2002 #endif
2003     callback_T	ch_callback;	// call when any msg is not handled
2004     callback_T	ch_close_cb;	// call when channel is closed
2005     int		ch_drop_never;
2006     int		ch_keep_open;	// do not close on read error
2007     int		ch_nonblock;
2008 
2009     job_T	*ch_job;	// Job that uses this channel; this does not
2010 				// count as a reference to avoid a circular
2011 				// reference, the job refers to the channel.
2012     int		ch_job_killed;	// TRUE when there was a job and it was killed
2013 				// or we know it died.
2014     int		ch_anonymous_pipe;  // ConPTY
2015     int		ch_killing;	    // TerminateJobObject() was called
2016 
2017     int		ch_refcount;	// reference count
2018     int		ch_copyID;
2019 };
2020 
2021 #define JO_MODE		    0x0001	// channel mode
2022 #define JO_IN_MODE	    0x0002	// stdin mode
2023 #define JO_OUT_MODE	    0x0004	// stdout mode
2024 #define JO_ERR_MODE	    0x0008	// stderr mode
2025 #define JO_CALLBACK	    0x0010	// channel callback
2026 #define JO_OUT_CALLBACK	    0x0020	// stdout callback
2027 #define JO_ERR_CALLBACK	    0x0040	// stderr callback
2028 #define JO_CLOSE_CALLBACK   0x0080	// "close_cb"
2029 #define JO_WAITTIME	    0x0100	// only for ch_open()
2030 #define JO_TIMEOUT	    0x0200	// all timeouts
2031 #define JO_OUT_TIMEOUT	    0x0400	// stdout timeouts
2032 #define JO_ERR_TIMEOUT	    0x0800	// stderr timeouts
2033 #define JO_PART		    0x1000	// "part"
2034 #define JO_ID		    0x2000	// "id"
2035 #define JO_STOPONEXIT	    0x4000	// "stoponexit"
2036 #define JO_EXIT_CB	    0x8000	// "exit_cb"
2037 #define JO_OUT_IO	    0x10000	// "out_io"
2038 #define JO_ERR_IO	    0x20000	// "err_io" (JO_OUT_IO << 1)
2039 #define JO_IN_IO	    0x40000	// "in_io" (JO_OUT_IO << 2)
2040 #define JO_OUT_NAME	    0x80000	// "out_name"
2041 #define JO_ERR_NAME	    0x100000	// "err_name" (JO_OUT_NAME << 1)
2042 #define JO_IN_NAME	    0x200000	// "in_name" (JO_OUT_NAME << 2)
2043 #define JO_IN_TOP	    0x400000	// "in_top"
2044 #define JO_IN_BOT	    0x800000	// "in_bot"
2045 #define JO_OUT_BUF	    0x1000000	// "out_buf"
2046 #define JO_ERR_BUF	    0x2000000	// "err_buf" (JO_OUT_BUF << 1)
2047 #define JO_IN_BUF	    0x4000000	// "in_buf" (JO_OUT_BUF << 2)
2048 #define JO_CHANNEL	    0x8000000	// "channel"
2049 #define JO_BLOCK_WRITE	    0x10000000	// "block_write"
2050 #define JO_OUT_MODIFIABLE   0x20000000	// "out_modifiable"
2051 #define JO_ERR_MODIFIABLE   0x40000000	// "err_modifiable" (JO_OUT_ << 1)
2052 #define JO_ALL		    0x7fffffff
2053 
2054 #define JO2_OUT_MSG	    0x0001	// "out_msg"
2055 #define JO2_ERR_MSG	    0x0002	// "err_msg" (JO_OUT_ << 1)
2056 #define JO2_TERM_NAME	    0x0004	// "term_name"
2057 #define JO2_TERM_FINISH	    0x0008	// "term_finish"
2058 #define JO2_ENV		    0x0010	// "env"
2059 #define JO2_CWD		    0x0020	// "cwd"
2060 #define JO2_TERM_ROWS	    0x0040	// "term_rows"
2061 #define JO2_TERM_COLS	    0x0080	// "term_cols"
2062 #define JO2_VERTICAL	    0x0100	// "vertical"
2063 #define JO2_CURWIN	    0x0200	// "curwin"
2064 #define JO2_HIDDEN	    0x0400	// "hidden"
2065 #define JO2_TERM_OPENCMD    0x0800	// "term_opencmd"
2066 #define JO2_EOF_CHARS	    0x1000	// "eof_chars"
2067 #define JO2_NORESTORE	    0x2000	// "norestore"
2068 #define JO2_TERM_KILL	    0x4000	// "term_kill"
2069 #define JO2_ANSI_COLORS	    0x8000	// "ansi_colors"
2070 #define JO2_TTY_TYPE	    0x10000	// "tty_type"
2071 #define JO2_BUFNR	    0x20000	// "bufnr"
2072 #define JO2_TERM_API	    0x40000	// "term_api"
2073 
2074 #define JO_MODE_ALL	(JO_MODE + JO_IN_MODE + JO_OUT_MODE + JO_ERR_MODE)
2075 #define JO_CB_ALL \
2076     (JO_CALLBACK + JO_OUT_CALLBACK + JO_ERR_CALLBACK + JO_CLOSE_CALLBACK)
2077 #define JO_TIMEOUT_ALL	(JO_TIMEOUT + JO_OUT_TIMEOUT + JO_ERR_TIMEOUT)
2078 
2079 /*
2080  * Options for job and channel commands.
2081  */
2082 typedef struct
2083 {
2084     int		jo_set;		// JO_ bits for values that were set
2085     int		jo_set2;	// JO2_ bits for values that were set
2086 
2087     ch_mode_T	jo_mode;
2088     ch_mode_T	jo_in_mode;
2089     ch_mode_T	jo_out_mode;
2090     ch_mode_T	jo_err_mode;
2091     int		jo_noblock;
2092 
2093     job_io_T	jo_io[4];	// PART_OUT, PART_ERR, PART_IN
2094     char_u	jo_io_name_buf[4][NUMBUFLEN];
2095     char_u	*jo_io_name[4];	// not allocated!
2096     int		jo_io_buf[4];
2097     int		jo_pty;
2098     int		jo_modifiable[4];
2099     int		jo_message[4];
2100     channel_T	*jo_channel;
2101 
2102     linenr_T	jo_in_top;
2103     linenr_T	jo_in_bot;
2104 
2105     callback_T	jo_callback;
2106     callback_T	jo_out_cb;
2107     callback_T	jo_err_cb;
2108     callback_T	jo_close_cb;
2109     callback_T	jo_exit_cb;
2110     int		jo_drop_never;
2111     int		jo_waittime;
2112     int		jo_timeout;
2113     int		jo_out_timeout;
2114     int		jo_err_timeout;
2115     int		jo_block_write;	// for testing only
2116     int		jo_part;
2117     int		jo_id;
2118     char_u	jo_stoponexit_buf[NUMBUFLEN];
2119     char_u	*jo_stoponexit;
2120     dict_T	*jo_env;	// environment variables
2121     char_u	jo_cwd_buf[NUMBUFLEN];
2122     char_u	*jo_cwd;
2123 
2124 #ifdef FEAT_TERMINAL
2125     // when non-zero run the job in a terminal window of this size
2126     int		jo_term_rows;
2127     int		jo_term_cols;
2128     int		jo_vertical;
2129     int		jo_curwin;
2130     buf_T	*jo_bufnr_buf;
2131     int		jo_hidden;
2132     int		jo_term_norestore;
2133     char_u	jo_term_name_buf[NUMBUFLEN];
2134     char_u	*jo_term_name;
2135     char_u	jo_term_opencmd_buf[NUMBUFLEN];
2136     char_u	*jo_term_opencmd;
2137     int		jo_term_finish;
2138     char_u	jo_eof_chars_buf[NUMBUFLEN];
2139     char_u	*jo_eof_chars;
2140     char_u	jo_term_kill_buf[NUMBUFLEN];
2141     char_u	*jo_term_kill;
2142 # if defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS)
2143     long_u	jo_ansi_colors[16];
2144 # endif
2145     int		jo_tty_type;	    // first character of "tty_type"
2146     char_u	jo_term_api_buf[NUMBUFLEN];
2147     char_u	*jo_term_api;
2148 #endif
2149 } jobopt_T;
2150 
2151 #ifdef FEAT_EVAL
2152 /*
2153  * Structure used for listeners added with listener_add().
2154  */
2155 typedef struct listener_S listener_T;
2156 struct listener_S
2157 {
2158     listener_T	*lr_next;
2159     int		lr_id;
2160     callback_T	lr_callback;
2161 };
2162 #endif
2163 
2164 /*
2165  * structure used for explicit stack while garbage collecting hash tables
2166  */
2167 typedef struct ht_stack_S
2168 {
2169     hashtab_T		*ht;
2170     struct ht_stack_S	*prev;
2171 } ht_stack_T;
2172 
2173 /*
2174  * structure used for explicit stack while garbage collecting lists
2175  */
2176 typedef struct list_stack_S
2177 {
2178     list_T		*list;
2179     struct list_stack_S	*prev;
2180 } list_stack_T;
2181 
2182 /*
2183  * Structure used for iterating over dictionary items.
2184  * Initialize with dict_iterate_start().
2185  */
2186 typedef struct
2187 {
2188     long_u	dit_todo;
2189     hashitem_T	*dit_hi;
2190 } dict_iterator_T;
2191 
2192 // values for b_syn_spell: what to do with toplevel text
2193 #define SYNSPL_DEFAULT	0	// spell check if @Spell not defined
2194 #define SYNSPL_TOP	1	// spell check toplevel text
2195 #define SYNSPL_NOTOP	2	// don't spell check toplevel text
2196 
2197 // avoid #ifdefs for when b_spell is not available
2198 #ifdef FEAT_SPELL
2199 # define B_SPELL(buf)  ((buf)->b_spell)
2200 #else
2201 # define B_SPELL(buf)  (0)
2202 #endif
2203 
2204 typedef struct qf_info_S qf_info_T;
2205 
2206 #ifdef FEAT_PROFILE
2207 /*
2208  * Used for :syntime: timing of executing a syntax pattern.
2209  */
2210 typedef struct {
2211     proftime_T	total;		// total time used
2212     proftime_T	slowest;	// time of slowest call
2213     long	count;		// nr of times used
2214     long	match;		// nr of times matched
2215 } syn_time_T;
2216 #endif
2217 
2218 typedef struct timer_S timer_T;
2219 struct timer_S
2220 {
2221     long	tr_id;
2222 #ifdef FEAT_TIMERS
2223     timer_T	*tr_next;
2224     timer_T	*tr_prev;
2225     proftime_T	tr_due;		    // when the callback is to be invoked
2226     char	tr_firing;	    // when TRUE callback is being called
2227     char	tr_paused;	    // when TRUE callback is not invoked
2228     int		tr_repeat;	    // number of times to repeat, -1 forever
2229     long	tr_interval;	    // msec
2230     callback_T	tr_callback;
2231     int		tr_emsg_count;
2232 #endif
2233 };
2234 
2235 #ifdef FEAT_CRYPT
2236 /*
2237  * Structure to hold the type of encryption and the state of encryption or
2238  * decryption.
2239  */
2240 typedef struct {
2241     int	    method_nr;
2242     void    *method_state;  // method-specific state information
2243 } cryptstate_T;
2244 
2245 // values for method_nr
2246 # define CRYPT_M_ZIP	0
2247 # define CRYPT_M_BF	1
2248 # define CRYPT_M_BF2	2
2249 # define CRYPT_M_COUNT	3 // number of crypt methods
2250 
2251 // Currently all crypt methods work inplace.  If one is added that isn't then
2252 // define this.
2253 //  # define CRYPT_NOT_INPLACE 1
2254 #endif
2255 
2256 #ifdef FEAT_PROP_POPUP
2257 typedef enum {
2258     POPPOS_BOTLEFT,
2259     POPPOS_TOPLEFT,
2260     POPPOS_BOTRIGHT,
2261     POPPOS_TOPRIGHT,
2262     POPPOS_CENTER,
2263     POPPOS_NONE
2264 } poppos_T;
2265 
2266 typedef enum {
2267     POPCLOSE_NONE,
2268     POPCLOSE_BUTTON,
2269     POPCLOSE_CLICK
2270 } popclose_T;
2271 
2272 # define POPUPWIN_DEFAULT_ZINDEX	 50
2273 # define POPUPMENU_ZINDEX		100
2274 # define POPUPWIN_DIALOG_ZINDEX		200
2275 # define POPUPWIN_NOTIFICATION_ZINDEX   300
2276 #endif
2277 
2278 /*
2279  * These are items normally related to a buffer.  But when using ":ownsyntax"
2280  * a window may have its own instance.
2281  */
2282 typedef struct {
2283 #ifdef FEAT_SYN_HL
2284     hashtab_T	b_keywtab;		// syntax keywords hash table
2285     hashtab_T	b_keywtab_ic;		// idem, ignore case
2286     int		b_syn_error;		// TRUE when error occurred in HL
2287 # ifdef FEAT_RELTIME
2288     int		b_syn_slow;		// TRUE when 'redrawtime' reached
2289 # endif
2290     int		b_syn_ic;		// ignore case for :syn cmds
2291     int		b_syn_spell;		// SYNSPL_ values
2292     garray_T	b_syn_patterns;		// table for syntax patterns
2293     garray_T	b_syn_clusters;		// table for syntax clusters
2294     int		b_spell_cluster_id;	// @Spell cluster ID or 0
2295     int		b_nospell_cluster_id;	// @NoSpell cluster ID or 0
2296     int		b_syn_containedin;	// TRUE when there is an item with a
2297 					// "containedin" argument
2298     int		b_syn_sync_flags;	// flags about how to sync
2299     short	b_syn_sync_id;		// group to sync on
2300     long	b_syn_sync_minlines;	// minimal sync lines offset
2301     long	b_syn_sync_maxlines;	// maximal sync lines offset
2302     long	b_syn_sync_linebreaks;	// offset for multi-line pattern
2303     char_u	*b_syn_linecont_pat;	// line continuation pattern
2304     regprog_T	*b_syn_linecont_prog;	// line continuation program
2305 #ifdef FEAT_PROFILE
2306     syn_time_T  b_syn_linecont_time;
2307 #endif
2308     int		b_syn_linecont_ic;	// ignore-case flag for above
2309     int		b_syn_topgrp;		// for ":syntax include"
2310 # ifdef FEAT_CONCEAL
2311     int		b_syn_conceal;		// auto-conceal for :syn cmds
2312 # endif
2313 # ifdef FEAT_FOLDING
2314     int		b_syn_folditems;	// number of patterns with the HL_FOLD
2315 					// flag set
2316 # endif
2317     /*
2318      * b_sst_array[] contains the state stack for a number of lines, for the
2319      * start of that line (col == 0).  This avoids having to recompute the
2320      * syntax state too often.
2321      * b_sst_array[] is allocated to hold the state for all displayed lines,
2322      * and states for 1 out of about 20 other lines.
2323      * b_sst_array	pointer to an array of synstate_T
2324      * b_sst_len	number of entries in b_sst_array[]
2325      * b_sst_first	pointer to first used entry in b_sst_array[] or NULL
2326      * b_sst_firstfree	pointer to first free entry in b_sst_array[] or NULL
2327      * b_sst_freecount	number of free entries in b_sst_array[]
2328      * b_sst_check_lnum	entries after this lnum need to be checked for
2329      *			validity (MAXLNUM means no check needed)
2330      */
2331     synstate_T	*b_sst_array;
2332     int		b_sst_len;
2333     synstate_T	*b_sst_first;
2334     synstate_T	*b_sst_firstfree;
2335     int		b_sst_freecount;
2336     linenr_T	b_sst_check_lnum;
2337     short_u	b_sst_lasttick;	// last display tick
2338 #endif // FEAT_SYN_HL
2339 
2340 #ifdef FEAT_SPELL
2341     // for spell checking
2342     garray_T	b_langp;	    // list of pointers to slang_T, see spell.c
2343     char_u	b_spell_ismw[256];  // flags: is midword char
2344     char_u	*b_spell_ismw_mb;   // multi-byte midword chars
2345     char_u	*b_p_spc;	    // 'spellcapcheck'
2346     regprog_T	*b_cap_prog;	    // program for 'spellcapcheck'
2347     char_u	*b_p_spf;	    // 'spellfile'
2348     char_u	*b_p_spl;	    // 'spelllang'
2349     int		b_cjk;		    // all CJK letters as OK
2350 #endif
2351 #if !defined(FEAT_SYN_HL) && !defined(FEAT_SPELL)
2352     int		dummy;
2353 #endif
2354     char_u	b_syn_chartab[32];  // syntax iskeyword option
2355     char_u	*b_syn_isk;	    // iskeyword option
2356 } synblock_T;
2357 
2358 
2359 /*
2360  * buffer: structure that holds information about one file
2361  *
2362  * Several windows can share a single Buffer
2363  * A buffer is unallocated if there is no memfile for it.
2364  * A buffer is new if the associated file has never been loaded yet.
2365  */
2366 
2367 struct file_buffer
2368 {
2369     memline_T	b_ml;		// associated memline (also contains line
2370 				// count)
2371 
2372     buf_T	*b_next;	// links in list of buffers
2373     buf_T	*b_prev;
2374 
2375     int		b_nwindows;	// nr of windows open on this buffer
2376 
2377     int		b_flags;	// various BF_ flags
2378     int		b_locked;	// Buffer is being closed or referenced, don't
2379 				// let autocommands wipe it out.
2380 
2381     /*
2382      * b_ffname has the full path of the file (NULL for no name).
2383      * b_sfname is the name as the user typed it (or NULL).
2384      * b_fname is the same as b_sfname, unless ":cd" has been done,
2385      *		then it is the same as b_ffname (NULL for no name).
2386      */
2387     char_u	*b_ffname;	// full path file name, allocated
2388     char_u	*b_sfname;	// short file name, allocated, may be equal to
2389 				// b_ffname
2390     char_u	*b_fname;	// current file name, points to b_ffname or
2391 				// b_sfname
2392 
2393 #ifdef UNIX
2394     int		b_dev_valid;	// TRUE when b_dev has a valid number
2395     dev_t	b_dev;		// device number
2396     ino_t	b_ino;		// inode number
2397 #endif
2398 #ifdef FEAT_CW_EDITOR
2399     FSSpec	b_FSSpec;	// MacOS File Identification
2400 #endif
2401 #ifdef VMS
2402     char	 b_fab_rfm;	// Record format
2403     char	 b_fab_rat;	// Record attribute
2404     unsigned int b_fab_mrs;	// Max record size
2405 #endif
2406     int		b_fnum;		// buffer number for this file.
2407     char_u	b_key[VIM_SIZEOF_INT * 2 + 1];
2408 				// key used for buf_hashtab, holds b_fnum as
2409 				// hex string
2410 
2411     int		b_changed;	// 'modified': Set to TRUE if something in the
2412 				// file has been changed and not written out.
2413     dictitem16_T b_ct_di;	// holds the b:changedtick value in
2414 				// b_ct_di.di_tv.vval.v_number;
2415 				// incremented for each change, also for undo
2416 #define CHANGEDTICK(buf) ((buf)->b_ct_di.di_tv.vval.v_number)
2417 
2418     varnumber_T	b_last_changedtick; // b:changedtick when TextChanged or
2419 				    // TextChangedI was last triggered.
2420     varnumber_T	b_last_changedtick_pum; // b:changedtick when TextChangedP was
2421 					// last triggered.
2422 
2423     int		b_saving;	// Set to TRUE if we are in the middle of
2424 				// saving the buffer.
2425 
2426     /*
2427      * Changes to a buffer require updating of the display.  To minimize the
2428      * work, remember changes made and update everything at once.
2429      */
2430     int		b_mod_set;	// TRUE when there are changes since the last
2431 				// time the display was updated
2432     linenr_T	b_mod_top;	// topmost lnum that was changed
2433     linenr_T	b_mod_bot;	// lnum below last changed line, AFTER the
2434 				// change
2435     long	b_mod_xlines;	// number of extra buffer lines inserted;
2436 				// negative when lines were deleted
2437 
2438     wininfo_T	*b_wininfo;	// list of last used info for each window
2439 
2440     long	b_mtime;	// last change time of original file
2441     long	b_mtime_read;	// last change time when reading
2442     off_T	b_orig_size;	// size of original file in bytes
2443     int		b_orig_mode;	// mode of original file
2444 #ifdef FEAT_VIMINFO
2445     time_T	b_last_used;	// time when the buffer was last used; used
2446 				// for viminfo
2447 #endif
2448 
2449     pos_T	b_namedm[NMARKS]; // current named marks (mark.c)
2450 
2451     // These variables are set when VIsual_active becomes FALSE
2452     visualinfo_T b_visual;
2453 #ifdef FEAT_EVAL
2454     int		b_visual_mode_eval;  // b_visual.vi_mode for visualmode()
2455 #endif
2456 
2457     pos_T	b_last_cursor;	// cursor position when last unloading this
2458 				// buffer
2459     pos_T	b_last_insert;	// where Insert mode was left
2460     pos_T	b_last_change;	// position of last change: '. mark
2461 
2462 #ifdef FEAT_JUMPLIST
2463     /*
2464      * the changelist contains old change positions
2465      */
2466     pos_T	b_changelist[JUMPLISTSIZE];
2467     int		b_changelistlen;	// number of active entries
2468     int		b_new_change;		// set by u_savecommon()
2469 #endif
2470 
2471     /*
2472      * Character table, only used in charset.c for 'iskeyword'
2473      * 32 bytes of 8 bits: 1 bit per character 0-255.
2474      */
2475     char_u	b_chartab[32];
2476 
2477     // Table used for mappings local to a buffer.
2478     mapblock_T	*(b_maphash[256]);
2479 
2480     // First abbreviation local to a buffer.
2481     mapblock_T	*b_first_abbr;
2482 
2483     // User commands local to the buffer.
2484     garray_T	b_ucmds;
2485     // start and end of an operator, also used for '[ and ']
2486     pos_T	b_op_start;
2487     pos_T	b_op_start_orig;  // used for Insstart_orig
2488     pos_T	b_op_end;
2489 
2490 #ifdef FEAT_VIMINFO
2491     int		b_marks_read;	// Have we read viminfo marks yet?
2492 #endif
2493 
2494     /*
2495      * The following only used in undo.c.
2496      */
2497     u_header_T	*b_u_oldhead;	// pointer to oldest header
2498     u_header_T	*b_u_newhead;	// pointer to newest header; may not be valid
2499 				// if b_u_curhead is not NULL
2500     u_header_T	*b_u_curhead;	// pointer to current header
2501     int		b_u_numhead;	// current number of headers
2502     int		b_u_synced;	// entry lists are synced
2503     long	b_u_seq_last;	// last used undo sequence number
2504     long	b_u_save_nr_last; // counter for last file write
2505     long	b_u_seq_cur;	// hu_seq of header below which we are now
2506     time_T	b_u_time_cur;	// uh_time of header below which we are now
2507     long	b_u_save_nr_cur; // file write nr after which we are now
2508 
2509     /*
2510      * variables for "U" command in undo.c
2511      */
2512     undoline_T	b_u_line_ptr;	// saved line for "U" command
2513     linenr_T	b_u_line_lnum;	// line number of line in u_line
2514     colnr_T	b_u_line_colnr;	// optional column number
2515 
2516     int		b_scanned;	// ^N/^P have scanned this buffer
2517 
2518     // flags for use of ":lmap" and IM control
2519     long	b_p_iminsert;	// input mode for insert
2520     long	b_p_imsearch;	// input mode for search
2521 #define B_IMODE_USE_INSERT -1	//	Use b_p_iminsert value for search
2522 #define B_IMODE_NONE 0		//	Input via none
2523 #define B_IMODE_LMAP 1		//	Input via langmap
2524 #define B_IMODE_IM 2		//	Input via input method
2525 #define B_IMODE_LAST 2
2526 
2527 #ifdef FEAT_KEYMAP
2528     short	b_kmap_state;	// using "lmap" mappings
2529 # define KEYMAP_INIT	1	// 'keymap' was set, call keymap_init()
2530 # define KEYMAP_LOADED	2	// 'keymap' mappings have been loaded
2531     garray_T	b_kmap_ga;	// the keymap table
2532 #endif
2533 
2534     /*
2535      * Options local to a buffer.
2536      * They are here because their value depends on the type of file
2537      * or contents of the file being edited.
2538      */
2539     int		b_p_initialized;	// set when options initialized
2540 
2541 #ifdef FEAT_EVAL
2542     sctx_T	b_p_script_ctx[BV_COUNT]; // SCTXs for buffer-local options
2543 #endif
2544 
2545     int		b_p_ai;		// 'autoindent'
2546     int		b_p_ai_nopaste;	// b_p_ai saved for paste mode
2547     char_u	*b_p_bkc;	// 'backupcopy'
2548     unsigned	b_bkc_flags;    // flags for 'backupcopy'
2549     int		b_p_ci;		// 'copyindent'
2550     int		b_p_bin;	// 'binary'
2551     int		b_p_bomb;	// 'bomb'
2552     char_u	*b_p_bh;	// 'bufhidden'
2553     char_u	*b_p_bt;	// 'buftype'
2554 #ifdef FEAT_QUICKFIX
2555 #define BUF_HAS_QF_ENTRY 1
2556 #define BUF_HAS_LL_ENTRY 2
2557     int		b_has_qf_entry;
2558 #endif
2559     int		b_p_bl;		// 'buflisted'
2560 #ifdef FEAT_CINDENT
2561     int		b_p_cin;	// 'cindent'
2562     char_u	*b_p_cino;	// 'cinoptions'
2563     char_u	*b_p_cink;	// 'cinkeys'
2564 #endif
2565 #if defined(FEAT_CINDENT) || defined(FEAT_SMARTINDENT)
2566     char_u	*b_p_cinw;	// 'cinwords'
2567 #endif
2568     char_u	*b_p_com;	// 'comments'
2569 #ifdef FEAT_FOLDING
2570     char_u	*b_p_cms;	// 'commentstring'
2571 #endif
2572     char_u	*b_p_cpt;	// 'complete'
2573 #ifdef BACKSLASH_IN_FILENAME
2574     char_u	*b_p_csl;	// 'completeslash'
2575 #endif
2576 #ifdef FEAT_COMPL_FUNC
2577     char_u	*b_p_cfu;	// 'completefunc'
2578     char_u	*b_p_ofu;	// 'omnifunc'
2579 #endif
2580 #ifdef FEAT_EVAL
2581     char_u	*b_p_tfu;	// 'tagfunc'
2582 #endif
2583     int		b_p_eol;	// 'endofline'
2584     int		b_p_fixeol;	// 'fixendofline'
2585     int		b_p_et;		// 'expandtab'
2586     int		b_p_et_nobin;	// b_p_et saved for binary mode
2587     int		b_p_et_nopaste; // b_p_et saved for paste mode
2588     char_u	*b_p_fenc;	// 'fileencoding'
2589     char_u	*b_p_ff;	// 'fileformat'
2590     char_u	*b_p_ft;	// 'filetype'
2591     char_u	*b_p_fo;	// 'formatoptions'
2592     char_u	*b_p_flp;	// 'formatlistpat'
2593     int		b_p_inf;	// 'infercase'
2594     char_u	*b_p_isk;	// 'iskeyword'
2595 #ifdef FEAT_FIND_ID
2596     char_u	*b_p_def;	// 'define' local value
2597     char_u	*b_p_inc;	// 'include'
2598 # ifdef FEAT_EVAL
2599     char_u	*b_p_inex;	// 'includeexpr'
2600     long_u	b_p_inex_flags;	// flags for 'includeexpr'
2601 # endif
2602 #endif
2603 #if defined(FEAT_CINDENT) && defined(FEAT_EVAL)
2604     char_u	*b_p_inde;	// 'indentexpr'
2605     long_u	b_p_inde_flags;	// flags for 'indentexpr'
2606     char_u	*b_p_indk;	// 'indentkeys'
2607 #endif
2608     char_u	*b_p_fp;	// 'formatprg'
2609 #if defined(FEAT_EVAL)
2610     char_u	*b_p_fex;	// 'formatexpr'
2611     long_u	b_p_fex_flags;	// flags for 'formatexpr'
2612 #endif
2613 #ifdef FEAT_CRYPT
2614     char_u	*b_p_key;	// 'key'
2615 #endif
2616     char_u	*b_p_kp;	// 'keywordprg'
2617 #ifdef FEAT_LISP
2618     int		b_p_lisp;	// 'lisp'
2619 #endif
2620     char_u	*b_p_menc;	// 'makeencoding'
2621     char_u	*b_p_mps;	// 'matchpairs'
2622     int		b_p_ml;		// 'modeline'
2623     int		b_p_ml_nobin;	// b_p_ml saved for binary mode
2624     int		b_p_ma;		// 'modifiable'
2625     char_u	*b_p_nf;	// 'nrformats'
2626     int		b_p_pi;		// 'preserveindent'
2627 #ifdef FEAT_TEXTOBJ
2628     char_u	*b_p_qe;	// 'quoteescape'
2629 #endif
2630     int		b_p_ro;		// 'readonly'
2631     long	b_p_sw;		// 'shiftwidth'
2632     int		b_p_sn;		// 'shortname'
2633 #ifdef FEAT_SMARTINDENT
2634     int		b_p_si;		// 'smartindent'
2635 #endif
2636     long	b_p_sts;	// 'softtabstop'
2637     long	b_p_sts_nopaste; // b_p_sts saved for paste mode
2638 #ifdef FEAT_SEARCHPATH
2639     char_u	*b_p_sua;	// 'suffixesadd'
2640 #endif
2641     int		b_p_swf;	// 'swapfile'
2642 #ifdef FEAT_SYN_HL
2643     long	b_p_smc;	// 'synmaxcol'
2644     char_u	*b_p_syn;	// 'syntax'
2645 #endif
2646     long	b_p_ts;		// 'tabstop'
2647     int		b_p_tx;		// 'textmode'
2648     long	b_p_tw;		// 'textwidth'
2649     long	b_p_tw_nobin;	// b_p_tw saved for binary mode
2650     long	b_p_tw_nopaste;	// b_p_tw saved for paste mode
2651     long	b_p_wm;		// 'wrapmargin'
2652     long	b_p_wm_nobin;	// b_p_wm saved for binary mode
2653     long	b_p_wm_nopaste;	// b_p_wm saved for paste mode
2654 #ifdef FEAT_VARTABS
2655     char_u	*b_p_vsts;	// 'varsofttabstop'
2656     int		*b_p_vsts_array;   // 'varsofttabstop' in internal format
2657     char_u	*b_p_vsts_nopaste; // b_p_vsts saved for paste mode
2658     char_u	*b_p_vts;	// 'vartabstop'
2659     int		*b_p_vts_array;	// 'vartabstop' in internal format
2660 #endif
2661 #ifdef FEAT_KEYMAP
2662     char_u	*b_p_keymap;	// 'keymap'
2663 #endif
2664 
2665     /*
2666      * local values for options which are normally global
2667      */
2668 #ifdef FEAT_QUICKFIX
2669     char_u	*b_p_gp;	// 'grepprg' local value
2670     char_u	*b_p_mp;	// 'makeprg' local value
2671     char_u	*b_p_efm;	// 'errorformat' local value
2672 #endif
2673     char_u	*b_p_ep;	// 'equalprg' local value
2674     char_u	*b_p_path;	// 'path' local value
2675     int		b_p_ar;		// 'autoread' local value
2676     char_u	*b_p_tags;	// 'tags' local value
2677     char_u	*b_p_tc;	// 'tagcase' local value
2678     unsigned	b_tc_flags;     // flags for 'tagcase'
2679     char_u	*b_p_dict;	// 'dictionary' local value
2680     char_u	*b_p_tsr;	// 'thesaurus' local value
2681     long	b_p_ul;		// 'undolevels' local value
2682 #ifdef FEAT_PERSISTENT_UNDO
2683     int		b_p_udf;	// 'undofile'
2684 #endif
2685 #ifdef FEAT_LISP
2686     char_u	*b_p_lw;	// 'lispwords' local value
2687 #endif
2688 #ifdef FEAT_TERMINAL
2689     long	b_p_twsl;	// 'termwinscroll'
2690 #endif
2691 
2692     /*
2693      * end of buffer options
2694      */
2695 
2696 #ifdef FEAT_CINDENT
2697     // values set from b_p_cino
2698     int		b_ind_level;
2699     int		b_ind_open_imag;
2700     int		b_ind_no_brace;
2701     int		b_ind_first_open;
2702     int		b_ind_open_extra;
2703     int		b_ind_close_extra;
2704     int		b_ind_open_left_imag;
2705     int		b_ind_jump_label;
2706     int		b_ind_case;
2707     int		b_ind_case_code;
2708     int		b_ind_case_break;
2709     int		b_ind_param;
2710     int		b_ind_func_type;
2711     int		b_ind_comment;
2712     int		b_ind_in_comment;
2713     int		b_ind_in_comment2;
2714     int		b_ind_cpp_baseclass;
2715     int		b_ind_continuation;
2716     int		b_ind_unclosed;
2717     int		b_ind_unclosed2;
2718     int		b_ind_unclosed_noignore;
2719     int		b_ind_unclosed_wrapped;
2720     int		b_ind_unclosed_whiteok;
2721     int		b_ind_matching_paren;
2722     int		b_ind_paren_prev;
2723     int		b_ind_maxparen;
2724     int		b_ind_maxcomment;
2725     int		b_ind_scopedecl;
2726     int		b_ind_scopedecl_code;
2727     int		b_ind_java;
2728     int		b_ind_js;
2729     int		b_ind_keep_case_label;
2730     int		b_ind_hash_comment;
2731     int		b_ind_cpp_namespace;
2732     int		b_ind_if_for_while;
2733     int		b_ind_cpp_extern_c;
2734 #endif
2735 
2736     linenr_T	b_no_eol_lnum;	// non-zero lnum when last line of next binary
2737 				// write should not have an end-of-line
2738 
2739     int		b_start_eol;	// last line had eol when it was read
2740     int		b_start_ffc;	// first char of 'ff' when edit started
2741     char_u	*b_start_fenc;	// 'fileencoding' when edit started or NULL
2742     int		b_bad_char;	// "++bad=" argument when edit started or 0
2743     int		b_start_bomb;	// 'bomb' when it was read
2744 
2745 #ifdef FEAT_EVAL
2746     dictitem_T	b_bufvar;	// variable for "b:" Dictionary
2747     dict_T	*b_vars;	// internal variables, local to buffer
2748 
2749     listener_T	*b_listener;
2750     list_T	*b_recorded_changes;
2751 #endif
2752 #ifdef FEAT_PROP_POPUP
2753     int		b_has_textprop;	// TRUE when text props were added
2754     hashtab_T	*b_proptypes;	// text property types local to buffer
2755 #endif
2756 
2757 #if defined(FEAT_BEVAL) && defined(FEAT_EVAL)
2758     char_u	*b_p_bexpr;	// 'balloonexpr' local value
2759     long_u	b_p_bexpr_flags;// flags for 'balloonexpr'
2760 #endif
2761 #ifdef FEAT_CRYPT
2762     char_u	*b_p_cm;	// 'cryptmethod'
2763 #endif
2764 
2765     // When a buffer is created, it starts without a swap file.  b_may_swap is
2766     // then set to indicate that a swap file may be opened later.  It is reset
2767     // if a swap file could not be opened.
2768     int		b_may_swap;
2769     int		b_did_warn;	// Set to 1 if user has been warned on first
2770 				// change of a read-only file
2771 
2772     // Two special kinds of buffers:
2773     // help buffer  - used for help files, won't use a swap file.
2774     // spell buffer - used for spell info, never displayed and doesn't have a
2775     //		      file name.
2776     int		b_help;		// TRUE for help file buffer (when set b_p_bt
2777 				// is "help")
2778 #ifdef FEAT_SPELL
2779     int		b_spell;	// TRUE for a spell file buffer, most fields
2780 				// are not used!  Use the B_SPELL macro to
2781 				// access b_spell without #ifdef.
2782 #endif
2783 
2784     int		b_shortname;	// this file has an 8.3 file name
2785 
2786 #ifdef FEAT_JOB_CHANNEL
2787     char_u	*b_prompt_text;		// set by prompt_setprompt()
2788     callback_T	b_prompt_callback;	// set by prompt_setcallback()
2789     callback_T	b_prompt_interrupt;	// set by prompt_setinterrupt()
2790     int		b_prompt_insert;	// value for restart_edit when entering
2791 					// a prompt buffer window.
2792 #endif
2793 #ifdef FEAT_MZSCHEME
2794     void	*b_mzscheme_ref; // The MzScheme reference to this buffer
2795 #endif
2796 
2797 #ifdef FEAT_PERL
2798     void	*b_perl_private;
2799 #endif
2800 
2801 #ifdef FEAT_PYTHON
2802     void	*b_python_ref;	// The Python reference to this buffer
2803 #endif
2804 
2805 #ifdef FEAT_PYTHON3
2806     void	*b_python3_ref;	// The Python3 reference to this buffer
2807 #endif
2808 
2809 #ifdef FEAT_TCL
2810     void	*b_tcl_ref;
2811 #endif
2812 
2813 #ifdef FEAT_RUBY
2814     void	*b_ruby_ref;
2815 #endif
2816 
2817 #if defined(FEAT_SYN_HL) || defined(FEAT_SPELL)
2818     synblock_T	b_s;		// Info related to syntax highlighting.  w_s
2819 				// normally points to this, but some windows
2820 				// may use a different synblock_T.
2821 #endif
2822 
2823 #ifdef FEAT_SIGNS
2824     sign_entry_T *b_signlist;	   // list of placed signs
2825 # ifdef FEAT_NETBEANS_INTG
2826     int		b_has_sign_column; // Flag that is set when a first sign is
2827 				   // added and remains set until the end of
2828 				   // the netbeans session.
2829 # endif
2830 #endif
2831 
2832 #ifdef FEAT_NETBEANS_INTG
2833     int		b_netbeans_file;    // TRUE when buffer is owned by NetBeans
2834     int		b_was_netbeans_file;// TRUE if b_netbeans_file was once set
2835 #endif
2836 #ifdef FEAT_JOB_CHANNEL
2837     int		b_write_to_channel; // TRUE when appended lines are written to
2838 				    // a channel.
2839 #endif
2840 
2841 #ifdef FEAT_CRYPT
2842     cryptstate_T *b_cryptstate;	// Encryption state while reading or writing
2843 				// the file. NULL when not using encryption.
2844 #endif
2845     int		b_mapped_ctrl_c; // modes where CTRL-C is mapped
2846 
2847 #ifdef FEAT_TERMINAL
2848     term_T	*b_term;	// When not NULL this buffer is for a terminal
2849 				// window.
2850 #endif
2851 #ifdef FEAT_DIFF
2852     int		b_diff_failed;	// internal diff failed for this buffer
2853 #endif
2854 }; // file_buffer
2855 
2856 
2857 #ifdef FEAT_DIFF
2858 /*
2859  * Stuff for diff mode.
2860  */
2861 # define DB_COUNT 8	// up to eight buffers can be diff'ed
2862 
2863 /*
2864  * Each diffblock defines where a block of lines starts in each of the buffers
2865  * and how many lines it occupies in that buffer.  When the lines are missing
2866  * in the buffer the df_count[] is zero.  This is all counted in
2867  * buffer lines.
2868  * There is always at least one unchanged line in between the diffs.
2869  * Otherwise it would have been included in the diff above or below it.
2870  * df_lnum[] + df_count[] is the lnum below the change.  When in one buffer
2871  * lines have been inserted, in the other buffer df_lnum[] is the line below
2872  * the insertion and df_count[] is zero.  When appending lines at the end of
2873  * the buffer, df_lnum[] is one beyond the end!
2874  * This is using a linked list, because the number of differences is expected
2875  * to be reasonable small.  The list is sorted on lnum.
2876  */
2877 typedef struct diffblock_S diff_T;
2878 struct diffblock_S
2879 {
2880     diff_T	*df_next;
2881     linenr_T	df_lnum[DB_COUNT];	// line number in buffer
2882     linenr_T	df_count[DB_COUNT];	// nr of inserted/changed lines
2883 };
2884 #endif
2885 
2886 #define SNAP_HELP_IDX	0
2887 #define SNAP_AUCMD_IDX 1
2888 #define SNAP_COUNT	2
2889 
2890 /*
2891  * Tab pages point to the top frame of each tab page.
2892  * Note: Most values are NOT valid for the current tab page!  Use "curwin",
2893  * "firstwin", etc. for that.  "tp_topframe" is always valid and can be
2894  * compared against "topframe" to find the current tab page.
2895  */
2896 typedef struct tabpage_S tabpage_T;
2897 struct tabpage_S
2898 {
2899     tabpage_T	    *tp_next;	    // next tabpage or NULL
2900     frame_T	    *tp_topframe;   // topframe for the windows
2901     win_T	    *tp_curwin;	    // current window in this Tab page
2902     win_T	    *tp_prevwin;    // previous window in this Tab page
2903     win_T	    *tp_firstwin;   // first window in this Tab page
2904     win_T	    *tp_lastwin;    // last window in this Tab page
2905 #ifdef FEAT_PROP_POPUP
2906     win_T	    *tp_first_popupwin; // first popup window in this Tab page
2907 #endif
2908     long	    tp_old_Rows;    // Rows when Tab page was left
2909     long	    tp_old_Columns; // Columns when Tab page was left
2910     long	    tp_ch_used;	    // value of 'cmdheight' when frame size
2911 				    // was set
2912 #ifdef FEAT_GUI
2913     int		    tp_prev_which_scrollbars[3];
2914 				    // previous value of which_scrollbars
2915 #endif
2916 
2917     char_u	    *tp_localdir;	// absolute path of local directory or
2918 					// NULL
2919 #ifdef FEAT_DIFF
2920     diff_T	    *tp_first_diff;
2921     buf_T	    *(tp_diffbuf[DB_COUNT]);
2922     int		    tp_diff_invalid;	// list of diffs is outdated
2923     int		    tp_diff_update;	// update diffs before redrawing
2924 #endif
2925     frame_T	    *(tp_snapshot[SNAP_COUNT]);  // window layout snapshots
2926 #ifdef FEAT_EVAL
2927     dictitem_T	    tp_winvar;	    // variable for "t:" Dictionary
2928     dict_T	    *tp_vars;	    // internal variables, local to tab page
2929 #endif
2930 
2931 #ifdef FEAT_PYTHON
2932     void	    *tp_python_ref;	// The Python value for this tab page
2933 #endif
2934 
2935 #ifdef FEAT_PYTHON3
2936     void	    *tp_python3_ref;	// The Python value for this tab page
2937 #endif
2938 };
2939 
2940 /*
2941  * Structure to cache info for displayed lines in w_lines[].
2942  * Each logical line has one entry.
2943  * The entry tells how the logical line is currently displayed in the window.
2944  * This is updated when displaying the window.
2945  * When the display is changed (e.g., when clearing the screen) w_lines_valid
2946  * is changed to exclude invalid entries.
2947  * When making changes to the buffer, wl_valid is reset to indicate wl_size
2948  * may not reflect what is actually in the buffer.  When wl_valid is FALSE,
2949  * the entries can only be used to count the number of displayed lines used.
2950  * wl_lnum and wl_lastlnum are invalid too.
2951  */
2952 typedef struct w_line
2953 {
2954     linenr_T	wl_lnum;	// buffer line number for logical line
2955     short_u	wl_size;	// height in screen lines
2956     char	wl_valid;	// TRUE values are valid for text in buffer
2957 #ifdef FEAT_FOLDING
2958     char	wl_folded;	// TRUE when this is a range of folded lines
2959     linenr_T	wl_lastlnum;	// last buffer line number for logical line
2960 #endif
2961 } wline_T;
2962 
2963 /*
2964  * Windows are kept in a tree of frames.  Each frame has a column (FR_COL)
2965  * or row (FR_ROW) layout or is a leaf, which has a window.
2966  */
2967 struct frame_S
2968 {
2969     char	fr_layout;	// FR_LEAF, FR_COL or FR_ROW
2970     int		fr_width;
2971     int		fr_newwidth;	// new width used in win_equal_rec()
2972     int		fr_height;
2973     int		fr_newheight;	// new height used in win_equal_rec()
2974     frame_T	*fr_parent;	// containing frame or NULL
2975     frame_T	*fr_next;	// frame right or below in same parent, NULL
2976 				// for last
2977     frame_T	*fr_prev;	// frame left or above in same parent, NULL
2978 				// for first
2979     // fr_child and fr_win are mutually exclusive
2980     frame_T	*fr_child;	// first contained frame
2981     win_T	*fr_win;	// window that fills this frame
2982 };
2983 
2984 #define FR_LEAF	0	// frame is a leaf
2985 #define FR_ROW	1	// frame with a row of windows
2986 #define FR_COL	2	// frame with a column of windows
2987 
2988 /*
2989  * Struct used for highlighting 'hlsearch' matches, matches defined by
2990  * ":match" and matches defined by match functions.
2991  * For 'hlsearch' there is one pattern for all windows.  For ":match" and the
2992  * match functions there is a different pattern for each window.
2993  */
2994 typedef struct
2995 {
2996     regmmatch_T	rm;	    // points to the regexp program; contains last
2997 			    // found match (may continue in next line)
2998     buf_T	*buf;	    // the buffer to search for a match
2999     linenr_T	lnum;	    // the line to search for a match
3000     int		attr;	    // attributes to be used for a match
3001     int		attr_cur;   // attributes currently active in win_line()
3002     linenr_T	first_lnum; // first lnum to search for multi-line pat
3003     colnr_T	startcol;   // in win_line() points to char where HL starts
3004     colnr_T	endcol;	    // in win_line() points to char where HL ends
3005     int		is_addpos;  // position specified directly by
3006 			    // matchaddpos(). TRUE/FALSE
3007 #ifdef FEAT_RELTIME
3008     proftime_T	tm;	    // for a time limit
3009 #endif
3010 } match_T;
3011 
3012 // number of positions supported by matchaddpos()
3013 #define MAXPOSMATCH 8
3014 
3015 /*
3016  * Same as lpos_T, but with additional field len.
3017  */
3018 typedef struct
3019 {
3020     linenr_T	lnum;	// line number
3021     colnr_T	col;	// column number
3022     int		len;	// length: 0 - to the end of line
3023 } llpos_T;
3024 
3025 /*
3026  * posmatch_T provides an array for storing match items for matchaddpos()
3027  * function.
3028  */
3029 typedef struct posmatch posmatch_T;
3030 struct posmatch
3031 {
3032     llpos_T	pos[MAXPOSMATCH];	// array of positions
3033     int		cur;			// internal position counter
3034     linenr_T	toplnum;		// top buffer line
3035     linenr_T	botlnum;		// bottom buffer line
3036 };
3037 
3038 /*
3039  * matchitem_T provides a linked list for storing match items for ":match" and
3040  * the match functions.
3041  */
3042 typedef struct matchitem matchitem_T;
3043 struct matchitem
3044 {
3045     matchitem_T	*next;
3046     int		id;	    // match ID
3047     int		priority;   // match priority
3048     char_u	*pattern;   // pattern to highlight
3049     regmmatch_T	match;	    // regexp program for pattern
3050     posmatch_T	pos;	    // position matches
3051     match_T	hl;	    // struct for doing the actual highlighting
3052     int		hlg_id;	    // highlight group ID
3053 #ifdef FEAT_CONCEAL
3054     int		conceal_char; // cchar for Conceal highlighting
3055 #endif
3056 };
3057 
3058 // Structure to store last cursor position and topline.  Used by check_lnums()
3059 // and reset_lnums().
3060 typedef struct
3061 {
3062     int		w_topline_save;	// original topline value
3063     int		w_topline_corr;	// corrected topline value
3064     pos_T	w_cursor_save;	// original cursor position
3065     pos_T	w_cursor_corr;	// corrected cursor position
3066 } pos_save_T;
3067 
3068 #ifdef FEAT_MENU
3069 typedef struct {
3070     int		wb_startcol;
3071     int		wb_endcol;
3072     vimmenu_T	*wb_menu;
3073 } winbar_item_T;
3074 #endif
3075 
3076 /*
3077  * Structure which contains all information that belongs to a window
3078  *
3079  * All row numbers are relative to the start of the window, except w_winrow.
3080  */
3081 struct window_S
3082 {
3083     int		w_id;		    // unique window ID
3084 
3085     buf_T	*w_buffer;	    // buffer we are a window into
3086 
3087     win_T	*w_prev;	    // link to previous window
3088     win_T	*w_next;	    // link to next window
3089 
3090 #if defined(FEAT_SYN_HL) || defined(FEAT_SPELL)
3091     synblock_T	*w_s;		    // for :ownsyntax
3092 #endif
3093 
3094     int		w_closing;	    // window is being closed, don't let
3095 				    // autocommands close it too.
3096 
3097     frame_T	*w_frame;	    // frame containing this window
3098 
3099     pos_T	w_cursor;	    // cursor position in buffer
3100 
3101     colnr_T	w_curswant;	    // The column we'd like to be at.  This is
3102 				    // used to try to stay in the same column
3103 				    // for up/down cursor motions.
3104 
3105     int		w_set_curswant;	    // If set, then update w_curswant the next
3106 				    // time through cursupdate() to the
3107 				    // current virtual column
3108 
3109 #ifdef FEAT_SYN_HL
3110     linenr_T	w_last_cursorline;  // where last time 'cursorline' was drawn
3111 #endif
3112 
3113     /*
3114      * the next seven are used to update the Visual highlighting
3115      */
3116     char	w_old_visual_mode;  // last known VIsual_mode
3117     linenr_T	w_old_cursor_lnum;  // last known end of visual part
3118     colnr_T	w_old_cursor_fcol;  // first column for block visual part
3119     colnr_T	w_old_cursor_lcol;  // last column for block visual part
3120     linenr_T	w_old_visual_lnum;  // last known start of visual part
3121     colnr_T	w_old_visual_col;   // last known start of visual part
3122     colnr_T	w_old_curswant;	    // last known value of Curswant
3123 
3124     /*
3125      * "w_topline", "w_leftcol" and "w_skipcol" specify the offsets for
3126      * displaying the buffer.
3127      */
3128     linenr_T	w_topline;	    // buffer line number of the line at the
3129 				    // top of the window
3130     char	w_topline_was_set;  // flag set to TRUE when topline is set,
3131 				    // e.g. by winrestview()
3132 #ifdef FEAT_DIFF
3133     int		w_topfill;	    // number of filler lines above w_topline
3134     int		w_old_topfill;	    // w_topfill at last redraw
3135     int		w_botfill;	    // TRUE when filler lines are actually
3136 				    // below w_topline (at end of file)
3137     int		w_old_botfill;	    // w_botfill at last redraw
3138 #endif
3139     colnr_T	w_leftcol;	    // window column number of the left most
3140 				    // character in the window; used when
3141 				    // 'wrap' is off
3142     colnr_T	w_skipcol;	    // starting column when a single line
3143 				    // doesn't fit in the window
3144 
3145     /*
3146      * Layout of the window in the screen.
3147      * May need to add "msg_scrolled" to "w_winrow" in rare situations.
3148      */
3149     int		w_winrow;	    // first row of window in screen
3150     int		w_height;	    // number of rows in window, excluding
3151 				    // status/command/winbar line(s)
3152     int		w_status_height;    // number of status lines (0 or 1)
3153     int		w_wincol;	    // Leftmost column of window in screen.
3154     int		w_width;	    // Width of window, excluding separation.
3155     int		w_vsep_width;	    // Number of separator columns (0 or 1).
3156     pos_save_T	w_save_cursor;	    // backup of cursor pos and topline
3157 #ifdef FEAT_PROP_POPUP
3158     int		w_popup_flags;	    // POPF_ values
3159     int		w_popup_handled;    // POPUP_HANDLE[0-9] flags
3160     char_u	*w_popup_title;
3161     poppos_T	w_popup_pos;
3162     int		w_popup_fixed;	    // do not shift popup to fit on screen
3163     int		w_popup_prop_type;  // when not zero: textprop type ID
3164     win_T	*w_popup_prop_win;  // window to search for textprop
3165     int		w_popup_prop_id;    // when not zero: textprop ID
3166     int		w_zindex;
3167     int		w_minheight;	    // "minheight" for popup window
3168     int		w_minwidth;	    // "minwidth" for popup window
3169     int		w_maxheight;	    // "maxheight" for popup window
3170     int		w_maxwidth;	    // "maxwidth" for popup window
3171     int		w_wantline;	    // "line" for popup window
3172     int		w_wantcol;	    // "col" for popup window
3173     int		w_firstline;	    // "firstline" for popup window
3174     int		w_want_scrollbar;   // when zero don't use a scrollbar
3175     int		w_has_scrollbar;    // 1 if scrollbar displayed, 0 otherwise
3176     char_u	*w_scrollbar_highlight; // "scrollbarhighlight"
3177     char_u	*w_thumb_highlight; // "thumbhighlight"
3178     int		w_popup_padding[4]; // popup padding top/right/bot/left
3179     int		w_popup_border[4];  // popup border top/right/bot/left
3180     char_u	*w_border_highlight[4];  // popup border highlight
3181     int		w_border_char[8];   // popup border characters
3182 
3183     int		w_popup_leftoff;    // columns left of the screen
3184     int		w_popup_rightoff;   // columns right of the screen
3185     varnumber_T	w_popup_last_changedtick; // b:changedtick of popup buffer
3186 					  // when position was computed
3187     varnumber_T	w_popup_prop_changedtick; // b:changedtick of buffer with
3188 					  // w_popup_prop_type when position
3189 					  // was computed
3190     int		w_popup_prop_topline; // w_topline of window with
3191 				      // w_popup_prop_type when position was
3192 				      // computed
3193     linenr_T	w_popup_last_curline; // last known w_cursor.lnum of window
3194 				      // with "cursorline" set
3195     callback_T	w_close_cb;	    // popup close callback
3196     callback_T	w_filter_cb;	    // popup filter callback
3197     int		w_filter_mode;	    // mode when filter callback is used
3198 
3199     win_T	*w_popup_curwin;    // close popup if curwin differs
3200     linenr_T	w_popup_lnum;	    // close popup if cursor not on this line
3201     colnr_T	w_popup_mincol;	    // close popup if cursor before this col
3202     colnr_T	w_popup_maxcol;	    // close popup if cursor after this col
3203     int		w_popup_mouse_row;  // close popup if mouse moves away
3204     int		w_popup_mouse_mincol;  // close popup if mouse moves away
3205     int		w_popup_mouse_maxcol;  // close popup if mouse moves away
3206     popclose_T	w_popup_close;	    // allow closing the popup with the mouse
3207 
3208     list_T	*w_popup_mask;	     // list of lists for "mask"
3209     char_u	*w_popup_mask_cells; // cached mask cells
3210     int		w_popup_mask_height; // height of w_popup_mask_cells
3211     int		w_popup_mask_width;  // width of w_popup_mask_cells
3212 # if defined(FEAT_TIMERS)
3213     timer_T	*w_popup_timer;	    // timer for closing popup window
3214 # endif
3215 #endif
3216 
3217 
3218     /*
3219      * === start of cached values ====
3220      */
3221     /*
3222      * Recomputing is minimized by storing the result of computations.
3223      * Use functions in screen.c to check if they are valid and to update.
3224      * w_valid is a bitfield of flags, which indicate if specific values are
3225      * valid or need to be recomputed.	See screen.c for values.
3226      */
3227     int		w_valid;
3228     pos_T	w_valid_cursor;	    // last known position of w_cursor, used
3229 				    // to adjust w_valid
3230     colnr_T	w_valid_leftcol;    // last known w_leftcol
3231 
3232     /*
3233      * w_cline_height is the number of physical lines taken by the buffer line
3234      * that the cursor is on.  We use this to avoid extra calls to plines().
3235      */
3236     int		w_cline_height;	    // current size of cursor line
3237 #ifdef FEAT_FOLDING
3238     int		w_cline_folded;	    // cursor line is folded
3239 #endif
3240 
3241     int		w_cline_row;	    // starting row of the cursor line
3242 
3243     colnr_T	w_virtcol;	    // column number of the cursor in the
3244 				    // buffer line, as opposed to the column
3245 				    // number we're at on the screen.  This
3246 				    // makes a difference on lines which span
3247 				    // more than one screen line or when
3248 				    // w_leftcol is non-zero
3249 
3250     /*
3251      * w_wrow and w_wcol specify the cursor position in the window.
3252      * This is related to positions in the window, not in the display or
3253      * buffer, thus w_wrow is relative to w_winrow.
3254      */
3255     int		w_wrow, w_wcol;	    // cursor position in window
3256 
3257     linenr_T	w_botline;	    // number of the line below the bottom of
3258 				    // the window
3259     int		w_empty_rows;	    // number of ~ rows in window
3260 #ifdef FEAT_DIFF
3261     int		w_filler_rows;	    // number of filler rows at the end of the
3262 				    // window
3263 #endif
3264 
3265     /*
3266      * Info about the lines currently in the window is remembered to avoid
3267      * recomputing it every time.  The allocated size of w_lines[] is Rows.
3268      * Only the w_lines_valid entries are actually valid.
3269      * When the display is up-to-date w_lines[0].wl_lnum is equal to w_topline
3270      * and w_lines[w_lines_valid - 1].wl_lnum is equal to w_botline.
3271      * Between changing text and updating the display w_lines[] represents
3272      * what is currently displayed.  wl_valid is reset to indicated this.
3273      * This is used for efficient redrawing.
3274      */
3275     int		w_lines_valid;	    // number of valid entries
3276     wline_T	*w_lines;
3277 
3278 #ifdef FEAT_FOLDING
3279     garray_T	w_folds;	    // array of nested folds
3280     char	w_fold_manual;	    // when TRUE: some folds are opened/closed
3281 				    // manually
3282     char	w_foldinvalid;	    // when TRUE: folding needs to be
3283 				    // recomputed
3284 #endif
3285 #ifdef FEAT_LINEBREAK
3286     int		w_nrwidth;	    // width of 'number' and 'relativenumber'
3287 				    // column being used
3288 #endif
3289 
3290     /*
3291      * === end of cached values ===
3292      */
3293 
3294     int		w_redr_type;	    // type of redraw to be performed on win
3295     int		w_upd_rows;	    // number of window lines to update when
3296 				    // w_redr_type is REDRAW_TOP
3297     linenr_T	w_redraw_top;	    // when != 0: first line needing redraw
3298     linenr_T	w_redraw_bot;	    // when != 0: last line needing redraw
3299     int		w_redr_status;	    // if TRUE status line must be redrawn
3300 
3301 #ifdef FEAT_CMDL_INFO
3302     // remember what is shown in the ruler for this window (if 'ruler' set)
3303     pos_T	w_ru_cursor;	    // cursor position shown in ruler
3304     colnr_T	w_ru_virtcol;	    // virtcol shown in ruler
3305     linenr_T	w_ru_topline;	    // topline shown in ruler
3306     linenr_T	w_ru_line_count;    // line count used for ruler
3307 # ifdef FEAT_DIFF
3308     int		w_ru_topfill;	    // topfill shown in ruler
3309 # endif
3310     char	w_ru_empty;	    // TRUE if ruler shows 0-1 (empty line)
3311 #endif
3312 
3313     int		w_alt_fnum;	    // alternate file (for # and CTRL-^)
3314 
3315     alist_T	*w_alist;	    // pointer to arglist for this window
3316     int		w_arg_idx;	    // current index in argument list (can be
3317 				    // out of range!)
3318     int		w_arg_idx_invalid;  // editing another file than w_arg_idx
3319 
3320     char_u	*w_localdir;	    // absolute path of local directory or
3321 				    // NULL
3322 #ifdef FEAT_MENU
3323     vimmenu_T	*w_winbar;	    // The root of the WinBar menu hierarchy.
3324     winbar_item_T *w_winbar_items;  // list of items in the WinBar
3325     int		w_winbar_height;    // 1 if there is a window toolbar
3326 #endif
3327 
3328     /*
3329      * Options local to a window.
3330      * They are local because they influence the layout of the window or
3331      * depend on the window layout.
3332      * There are two values: w_onebuf_opt is local to the buffer currently in
3333      * this window, w_allbuf_opt is for all buffers in this window.
3334      */
3335     winopt_T	w_onebuf_opt;
3336     winopt_T	w_allbuf_opt;
3337 
3338     // A few options have local flags for P_INSECURE.
3339 #ifdef FEAT_STL_OPT
3340     long_u	w_p_stl_flags;	    // flags for 'statusline'
3341 #endif
3342 #ifdef FEAT_EVAL
3343     long_u	w_p_fde_flags;	    // flags for 'foldexpr'
3344     long_u	w_p_fdt_flags;	    // flags for 'foldtext'
3345 #endif
3346 #ifdef FEAT_SYN_HL
3347     int		*w_p_cc_cols;	    // array of columns to highlight or NULL
3348     char_u	w_p_culopt_flags;   // flags for cursorline highlighting
3349 #endif
3350     long	w_p_siso;	    // 'sidescrolloff' local value
3351     long	w_p_so;		    // 'scrolloff' local value
3352 
3353 #ifdef FEAT_LINEBREAK
3354     int		w_briopt_min;	    // minimum width for breakindent
3355     int		w_briopt_shift;	    // additional shift for breakindent
3356     int		w_briopt_sbr;	    // sbr in 'briopt'
3357 #endif
3358 
3359     // transform a pointer to a "onebuf" option into a "allbuf" option
3360 #define GLOBAL_WO(p)	((char *)p + sizeof(winopt_T))
3361 
3362     long	w_scbind_pos;
3363 
3364 #ifdef FEAT_EVAL
3365     dictitem_T	w_winvar;	// variable for "w:" Dictionary
3366     dict_T	*w_vars;	// internal variables, local to window
3367 #endif
3368 
3369     /*
3370      * The w_prev_pcmark field is used to check whether we really did jump to
3371      * a new line after setting the w_pcmark.  If not, then we revert to
3372      * using the previous w_pcmark.
3373      */
3374     pos_T	w_pcmark;	// previous context mark
3375     pos_T	w_prev_pcmark;	// previous w_pcmark
3376 
3377 #ifdef FEAT_JUMPLIST
3378     /*
3379      * the jumplist contains old cursor positions
3380      */
3381     xfmark_T	w_jumplist[JUMPLISTSIZE];
3382     int		w_jumplistlen;		// number of active entries
3383     int		w_jumplistidx;		// current position
3384 
3385     int		w_changelistidx;	// current position in b_changelist
3386 #endif
3387 
3388 #ifdef FEAT_SEARCH_EXTRA
3389     matchitem_T	*w_match_head;		// head of match list
3390     int		w_next_match_id;	// next match ID
3391 #endif
3392 
3393     /*
3394      * the tagstack grows from 0 upwards:
3395      * entry 0: older
3396      * entry 1: newer
3397      * entry 2: newest
3398      */
3399     taggy_T	w_tagstack[TAGSTACKSIZE];   // the tag stack
3400     int		w_tagstackidx;		    // idx just below active entry
3401     int		w_tagstacklen;		    // number of tags on stack
3402 
3403     /*
3404      * w_fraction is the fractional row of the cursor within the window, from
3405      * 0 at the top row to FRACTION_MULT at the last row.
3406      * w_prev_fraction_row was the actual cursor row when w_fraction was last
3407      * calculated.
3408      */
3409     int		w_fraction;
3410     int		w_prev_fraction_row;
3411 
3412 #ifdef FEAT_GUI
3413     scrollbar_T	w_scrollbars[2];	// vert. Scrollbars for this window
3414 #endif
3415 #ifdef FEAT_LINEBREAK
3416     linenr_T	w_nrwidth_line_count;	// line count when ml_nrwidth_width
3417 					// was computed.
3418     long	w_nuw_cached;		// 'numberwidth' option cached
3419     int		w_nrwidth_width;	// nr of chars to print line count.
3420 #endif
3421 
3422 #ifdef FEAT_QUICKFIX
3423     qf_info_T	*w_llist;		// Location list for this window
3424     /*
3425      * Location list reference used in the location list window.
3426      * In a non-location list window, w_llist_ref is NULL.
3427      */
3428     qf_info_T	*w_llist_ref;
3429 #endif
3430 
3431 #ifdef FEAT_MZSCHEME
3432     void	*w_mzscheme_ref;	// The MzScheme value for this window
3433 #endif
3434 
3435 #ifdef FEAT_PERL
3436     void	*w_perl_private;
3437 #endif
3438 
3439 #ifdef FEAT_PYTHON
3440     void	*w_python_ref;		// The Python value for this window
3441 #endif
3442 
3443 #ifdef FEAT_PYTHON3
3444     void	*w_python3_ref;		// The Python value for this window
3445 #endif
3446 
3447 #ifdef FEAT_TCL
3448     void	*w_tcl_ref;
3449 #endif
3450 
3451 #ifdef FEAT_RUBY
3452     void	*w_ruby_ref;
3453 #endif
3454 };
3455 
3456 /*
3457  * Arguments for operators.
3458  */
3459 typedef struct oparg_S
3460 {
3461     int		op_type;	// current pending operator type
3462     int		regname;	// register to use for the operator
3463     int		motion_type;	// type of the current cursor motion
3464     int		motion_force;	// force motion type: 'v', 'V' or CTRL-V
3465     int		use_reg_one;	// TRUE if delete uses reg 1 even when not
3466 				// linewise
3467     int		inclusive;	// TRUE if char motion is inclusive (only
3468 				// valid when motion_type is MCHAR
3469     int		end_adjusted;	// backuped b_op_end one char (only used by
3470 				// do_format())
3471     pos_T	start;		// start of the operator
3472     pos_T	end;		// end of the operator
3473     pos_T	cursor_start;	// cursor position before motion for "gw"
3474 
3475     long	line_count;	// number of lines from op_start to op_end
3476 				// (inclusive)
3477     int		empty;		// op_start and op_end the same (only used by
3478 				// do_change())
3479     int		is_VIsual;	// operator on Visual area
3480     int		block_mode;	// current operator is Visual block mode
3481     colnr_T	start_vcol;	// start col for block mode operator
3482     colnr_T	end_vcol;	// end col for block mode operator
3483     long	prev_opcount;	// ca.opcount saved for K_CURSORHOLD
3484     long	prev_count0;	// ca.count0 saved for K_CURSORHOLD
3485 } oparg_T;
3486 
3487 /*
3488  * Arguments for Normal mode commands.
3489  */
3490 typedef struct cmdarg_S
3491 {
3492     oparg_T	*oap;		// Operator arguments
3493     int		prechar;	// prefix character (optional, always 'g')
3494     int		cmdchar;	// command character
3495     int		nchar;		// next command character (optional)
3496     int		ncharC1;	// first composing character (optional)
3497     int		ncharC2;	// second composing character (optional)
3498     int		extra_char;	// yet another character (optional)
3499     long	opcount;	// count before an operator
3500     long	count0;		// count before command, default 0
3501     long	count1;		// count before command, default 1
3502     int		arg;		// extra argument from nv_cmds[]
3503     int		retval;		// return: CA_* values
3504     char_u	*searchbuf;	// return: pointer to search pattern or NULL
3505 } cmdarg_T;
3506 
3507 // values for retval:
3508 #define CA_COMMAND_BUSY	    1	// skip restarting edit() once
3509 #define CA_NO_ADJ_OP_END    2	// don't adjust operator end
3510 
3511 #ifdef CURSOR_SHAPE
3512 /*
3513  * struct to store values from 'guicursor' and 'mouseshape'
3514  */
3515 // Indexes in shape_table[]
3516 #define SHAPE_IDX_N	0	// Normal mode
3517 #define SHAPE_IDX_V	1	// Visual mode
3518 #define SHAPE_IDX_I	2	// Insert mode
3519 #define SHAPE_IDX_R	3	// Replace mode
3520 #define SHAPE_IDX_C	4	// Command line Normal mode
3521 #define SHAPE_IDX_CI	5	// Command line Insert mode
3522 #define SHAPE_IDX_CR	6	// Command line Replace mode
3523 #define SHAPE_IDX_O	7	// Operator-pending mode
3524 #define SHAPE_IDX_VE	8	// Visual mode with 'selection' exclusive
3525 #define SHAPE_IDX_CLINE	9	// On command line
3526 #define SHAPE_IDX_STATUS 10	// A status line
3527 #define SHAPE_IDX_SDRAG 11	// dragging a status line
3528 #define SHAPE_IDX_VSEP	12	// A vertical separator line
3529 #define SHAPE_IDX_VDRAG 13	// dragging a vertical separator line
3530 #define SHAPE_IDX_MORE	14	// Hit-return or More
3531 #define SHAPE_IDX_MOREL	15	// Hit-return or More in last line
3532 #define SHAPE_IDX_SM	16	// showing matching paren
3533 #define SHAPE_IDX_COUNT	17
3534 
3535 #define SHAPE_BLOCK	0	// block cursor
3536 #define SHAPE_HOR	1	// horizontal bar cursor
3537 #define SHAPE_VER	2	// vertical bar cursor
3538 
3539 #define MSHAPE_NUMBERED	1000	// offset for shapes identified by number
3540 #define MSHAPE_HIDE	1	// hide mouse pointer
3541 
3542 #define SHAPE_MOUSE	1	// used for mouse pointer shape
3543 #define SHAPE_CURSOR	2	// used for text cursor shape
3544 
3545 typedef struct cursor_entry
3546 {
3547     int		shape;		// one of the SHAPE_ defines
3548     int		mshape;		// one of the MSHAPE defines
3549     int		percentage;	// percentage of cell for bar
3550     long	blinkwait;	// blinking, wait time before blinking starts
3551     long	blinkon;	// blinking, on time
3552     long	blinkoff;	// blinking, off time
3553     int		id;		// highlight group ID
3554     int		id_lm;		// highlight group ID for :lmap mode
3555     char	*name;		// mode name (fixed)
3556     char	used_for;	// SHAPE_MOUSE and/or SHAPE_CURSOR
3557 } cursorentry_T;
3558 #endif // CURSOR_SHAPE
3559 
3560 #ifdef FEAT_MENU
3561 
3562 // Indices into vimmenu_T->strings[] and vimmenu_T->noremap[] for each mode
3563 #define MENU_INDEX_INVALID	-1
3564 #define MENU_INDEX_NORMAL	0
3565 #define MENU_INDEX_VISUAL	1
3566 #define MENU_INDEX_SELECT	2
3567 #define MENU_INDEX_OP_PENDING	3
3568 #define MENU_INDEX_INSERT	4
3569 #define MENU_INDEX_CMDLINE	5
3570 #define MENU_INDEX_TERMINAL	6
3571 #define MENU_INDEX_TIP		7
3572 #define MENU_MODES		8
3573 
3574 // Menu modes
3575 #define MENU_NORMAL_MODE	(1 << MENU_INDEX_NORMAL)
3576 #define MENU_VISUAL_MODE	(1 << MENU_INDEX_VISUAL)
3577 #define MENU_SELECT_MODE	(1 << MENU_INDEX_SELECT)
3578 #define MENU_OP_PENDING_MODE	(1 << MENU_INDEX_OP_PENDING)
3579 #define MENU_INSERT_MODE	(1 << MENU_INDEX_INSERT)
3580 #define MENU_CMDLINE_MODE	(1 << MENU_INDEX_CMDLINE)
3581 #define MENU_TERMINAL_MODE	(1 << MENU_INDEX_TERMINAL)
3582 #define MENU_TIP_MODE		(1 << MENU_INDEX_TIP)
3583 #define MENU_ALL_MODES		((1 << MENU_INDEX_TIP) - 1)
3584 // note MENU_INDEX_TIP is not a 'real' mode
3585 
3586 // Start a menu name with this to not include it on the main menu bar
3587 #define MNU_HIDDEN_CHAR		']'
3588 
3589 struct VimMenu
3590 {
3591     int		modes;		    // Which modes is this menu visible for?
3592     int		enabled;	    // for which modes the menu is enabled
3593     char_u	*name;		    // Name of menu, possibly translated
3594     char_u	*dname;		    // Displayed Name ("name" without '&')
3595 #ifdef FEAT_MULTI_LANG
3596     char_u	*en_name;	    // "name" untranslated, NULL when "name"
3597 				    // was not translated
3598     char_u	*en_dname;	    // "dname" untranslated, NULL when "dname"
3599 				    // was not translated
3600 #endif
3601     int		mnemonic;	    // mnemonic key (after '&')
3602     char_u	*actext;	    // accelerator text (after TAB)
3603     int		priority;	    // Menu order priority
3604 #ifdef FEAT_GUI
3605     void	(*cb)(vimmenu_T *); // Call-back function
3606 #endif
3607 #ifdef FEAT_TOOLBAR
3608     char_u	*iconfile;	    // name of file for icon or NULL
3609     int		iconidx;	    // icon index (-1 if not set)
3610     int		icon_builtin;	    // icon names is BuiltIn{nr}
3611 #endif
3612     char_u	*strings[MENU_MODES]; // Mapped string for each mode
3613     int		noremap[MENU_MODES]; // A REMAP_ flag for each mode
3614     char	silent[MENU_MODES]; // A silent flag for each mode
3615     vimmenu_T	*children;	    // Children of sub-menu
3616     vimmenu_T	*parent;	    // Parent of menu
3617     vimmenu_T	*next;		    // Next item in menu
3618 #ifdef FEAT_GUI_X11
3619     Widget	id;		    // Manage this to enable item
3620     Widget	submenu_id;	    // If this is submenu, add children here
3621 #endif
3622 #ifdef FEAT_GUI_GTK
3623     GtkWidget	*id;		    // Manage this to enable item
3624     GtkWidget	*submenu_id;	    // If this is submenu, add children here
3625 # if defined(GTK_CHECK_VERSION) && !GTK_CHECK_VERSION(3,4,0)
3626     GtkWidget	*tearoff_handle;
3627 # endif
3628     GtkWidget   *label;		    // Used by "set wak=" code.
3629 #endif
3630 #ifdef FEAT_GUI_MOTIF
3631     int		sensitive;	    // turn button on/off
3632     char	**xpm;		    // pixmap data
3633     char	*xpm_fname;	    // file with pixmap data
3634 #endif
3635 #ifdef FEAT_GUI_ATHENA
3636     Pixmap	image;		    // Toolbar image
3637 #endif
3638 #ifdef FEAT_BEVAL_TIP
3639     BalloonEval *tip;		    // tooltip for this menu item
3640 #endif
3641 #ifdef FEAT_GUI_MSWIN
3642     UINT	id;		    // Id of menu item
3643     HMENU	submenu_id;	    // If this is submenu, add children here
3644     HWND	tearoff_handle;	    // hWnd of tearoff if created
3645 #endif
3646 #if FEAT_GUI_HAIKU
3647     BMenuItem  *id;		    // Id of menu item
3648     BMenu  *submenu_id;		    // If this is submenu, add children here
3649 # ifdef FEAT_TOOLBAR
3650     BPictureButton *button;
3651 # endif
3652 #endif
3653 #ifdef FEAT_GUI_MAC
3654 //  MenuHandle	id;
3655 //  short	index;		    // the item index within the father menu
3656     short	menu_id;	    // the menu id to which this item belongs
3657     short	submenu_id;	    // the menu id of the children (could be
3658 				    // get through some tricks)
3659     MenuHandle	menu_handle;
3660     MenuHandle	submenu_handle;
3661 #endif
3662 #ifdef FEAT_GUI_PHOTON
3663     PtWidget_t	*id;
3664     PtWidget_t	*submenu_id;
3665 #endif
3666 };
3667 #else
3668 // For generating prototypes when FEAT_MENU isn't defined.
3669 typedef int vimmenu_T;
3670 
3671 #endif // FEAT_MENU
3672 
3673 /*
3674  * Struct to save values in before executing autocommands for a buffer that is
3675  * not the current buffer.
3676  */
3677 typedef struct
3678 {
3679     buf_T	*save_curbuf;	// saved curbuf
3680     int		use_aucmd_win;	// using aucmd_win
3681     win_T	*save_curwin;	// saved curwin
3682     win_T	*new_curwin;	// new curwin
3683     win_T	*save_prevwin;	// saved prevwin
3684     bufref_T	new_curbuf;	// new curbuf
3685     char_u	*globaldir;	// saved value of globaldir
3686 } aco_save_T;
3687 
3688 /*
3689  * Generic option table item, only used for printer at the moment.
3690  */
3691 typedef struct
3692 {
3693     const char	*name;
3694     int		hasnum;
3695     long	number;
3696     char_u	*string;	// points into option string
3697     int		strlen;
3698     int		present;
3699 } option_table_T;
3700 
3701 /*
3702  * Structure to hold printing color and font attributes.
3703  */
3704 typedef struct
3705 {
3706     long_u	fg_color;
3707     long_u	bg_color;
3708     int		bold;
3709     int		italic;
3710     int		underline;
3711     int		undercurl;
3712 } prt_text_attr_T;
3713 
3714 /*
3715  * Structure passed back to the generic printer code.
3716  */
3717 typedef struct
3718 {
3719     int		n_collated_copies;
3720     int		n_uncollated_copies;
3721     int		duplex;
3722     int		chars_per_line;
3723     int		lines_per_page;
3724     int		has_color;
3725     prt_text_attr_T number;
3726 #ifdef FEAT_SYN_HL
3727     int		modec;
3728     int		do_syntax;
3729 #endif
3730     int		user_abort;
3731     char_u	*jobname;
3732 #ifdef FEAT_POSTSCRIPT
3733     char_u	*outfile;
3734     char_u	*arguments;
3735 #endif
3736 } prt_settings_T;
3737 
3738 #define PRINT_NUMBER_WIDTH 8
3739 
3740 /*
3741  * Used for popup menu items.
3742  */
3743 typedef struct
3744 {
3745     char_u	*pum_text;	// main menu text
3746     char_u	*pum_kind;	// extra kind text (may be truncated)
3747     char_u	*pum_extra;	// extra menu text (may be truncated)
3748     char_u	*pum_info;	// extra info
3749 } pumitem_T;
3750 
3751 /*
3752  * Structure used for get_tagfname().
3753  */
3754 typedef struct
3755 {
3756     char_u	*tn_tags;	// value of 'tags' when starting
3757     char_u	*tn_np;		// current position in tn_tags
3758     int		tn_did_filefind_init;
3759     int		tn_hf_idx;
3760     void	*tn_search_ctx;
3761 } tagname_T;
3762 
3763 typedef struct {
3764   UINT32_T total[2];
3765   UINT32_T state[8];
3766   char_u   buffer[64];
3767 } context_sha256_T;
3768 
3769 /*
3770  * types for expressions.
3771  */
3772 typedef enum
3773 {
3774     EXPR_UNKNOWN = 0,
3775     EXPR_EQUAL,		// ==
3776     EXPR_NEQUAL,	// !=
3777     EXPR_GREATER,	// >
3778     EXPR_GEQUAL,	// >=
3779     EXPR_SMALLER,	// <
3780     EXPR_SEQUAL,	// <=
3781     EXPR_MATCH,		// =~
3782     EXPR_NOMATCH,	// !~
3783     EXPR_IS,		// is
3784     EXPR_ISNOT,		// isnot
3785     // used with ISN_OPNR
3786     EXPR_ADD,		// +
3787     EXPR_SUB,		// -
3788     EXPR_MULT,		// *
3789     EXPR_DIV,		// /
3790     EXPR_REM,		// %
3791 } exptype_T;
3792 
3793 /*
3794  * Structure used for reading in json_decode().
3795  */
3796 struct js_reader
3797 {
3798     char_u	*js_buf;	// text to be decoded
3799     char_u	*js_end;	// NUL in js_buf
3800     int		js_used;	// bytes used from js_buf
3801     int		(*js_fill)(struct js_reader *);
3802 				// function to fill the buffer or NULL;
3803 				// return TRUE when the buffer was filled
3804     void	*js_cookie;	// can be used by js_fill
3805     int		js_cookie_arg;	// can be used by js_fill
3806 };
3807 typedef struct js_reader js_read_T;
3808 
3809 // Maximum number of commands from + or -c arguments.
3810 #define MAX_ARG_CMDS 10
3811 
3812 // values for "window_layout"
3813 #define WIN_HOR	    1	    // "-o" horizontally split windows
3814 #define	WIN_VER	    2	    // "-O" vertically split windows
3815 #define	WIN_TABS    3	    // "-p" windows on tab pages
3816 
3817 // Struct for various parameters passed between main() and other functions.
3818 typedef struct
3819 {
3820     int		argc;
3821     char	**argv;
3822 
3823     char_u	*fname;			// first file to edit
3824 
3825     int		evim_mode;		// started as "evim"
3826     char_u	*use_vimrc;		// vimrc from -u argument
3827     int		clean;			// --clean argument
3828 
3829     int		n_commands;		     // no. of commands from + or -c
3830     char_u	*commands[MAX_ARG_CMDS];     // commands from + or -c arg.
3831     char_u	cmds_tofree[MAX_ARG_CMDS];   // commands that need free()
3832     int		n_pre_commands;		     // no. of commands from --cmd
3833     char_u	*pre_commands[MAX_ARG_CMDS]; // commands from --cmd argument
3834 
3835     int		edit_type;		// type of editing to do
3836     char_u	*tagname;		// tag from -t argument
3837 #ifdef FEAT_QUICKFIX
3838     char_u	*use_ef;		// 'errorfile' from -q argument
3839 #endif
3840 
3841     int		want_full_screen;
3842     int		not_a_term;		// no warning for missing term?
3843     int		tty_fail;		// exit if not a tty
3844     char_u	*term;			// specified terminal name
3845 #ifdef FEAT_CRYPT
3846     int		ask_for_key;		// -x argument
3847 #endif
3848     int		no_swap_file;		// "-n" argument used
3849 #ifdef FEAT_EVAL
3850     int		use_debug_break_level;
3851 #endif
3852     int		window_count;		// number of windows to use
3853     int		window_layout;		// 0, WIN_HOR, WIN_VER or WIN_TABS
3854 
3855 #ifdef FEAT_CLIENTSERVER
3856     int		serverArg;		// TRUE when argument for a server
3857     char_u	*serverName_arg;	// cmdline arg for server name
3858     char_u	*serverStr;		// remote server command
3859     char_u	*serverStrEnc;		// encoding of serverStr
3860     char_u	*servername;		// allocated name for our server
3861 #endif
3862 #if !defined(UNIX)
3863 # define EXPAND_FILENAMES
3864     int		literal;		// don't expand file names
3865 #endif
3866 #ifdef MSWIN
3867     int		full_path;		// file name argument was full path
3868 #endif
3869 #ifdef FEAT_DIFF
3870     int		diff_mode;		// start with 'diff' set
3871 #endif
3872 } mparm_T;
3873 
3874 /*
3875  * Structure returned by get_lval() and used by set_var_lval().
3876  * For a plain name:
3877  *	"name"	    points to the variable name.
3878  *	"exp_name"  is NULL.
3879  *	"tv"	    is NULL
3880  * For a magic braces name:
3881  *	"name"	    points to the expanded variable name.
3882  *	"exp_name"  is non-NULL, to be freed later.
3883  *	"tv"	    is NULL
3884  * For an index in a list:
3885  *	"name"	    points to the (expanded) variable name.
3886  *	"exp_name"  NULL or non-NULL, to be freed later.
3887  *	"tv"	    points to the (first) list item value
3888  *	"li"	    points to the (first) list item
3889  *	"range", "n1", "n2" and "empty2" indicate what items are used.
3890  * For an existing Dict item:
3891  *	"name"	    points to the (expanded) variable name.
3892  *	"exp_name"  NULL or non-NULL, to be freed later.
3893  *	"tv"	    points to the dict item value
3894  *	"newkey"    is NULL
3895  * For a non-existing Dict item:
3896  *	"name"	    points to the (expanded) variable name.
3897  *	"exp_name"  NULL or non-NULL, to be freed later.
3898  *	"tv"	    points to the Dictionary typval_T
3899  *	"newkey"    is the key for the new item.
3900  */
3901 typedef struct lval_S
3902 {
3903     char_u	*ll_name;	// start of variable name (can be NULL)
3904     char_u	*ll_name_end;	// end of variable name (can be NULL)
3905     type_T	*ll_type;	// type of variable (can be NULL)
3906     char_u	*ll_exp_name;	// NULL or expanded name in allocated memory.
3907     typval_T	*ll_tv;		// Typeval of item being used.  If "newkey"
3908 				// isn't NULL it's the Dict to which to add
3909 				// the item.
3910     listitem_T	*ll_li;		// The list item or NULL.
3911     list_T	*ll_list;	// The list or NULL.
3912     int		ll_range;	// TRUE when a [i:j] range was used
3913     int		ll_empty2;	// Second index is empty: [i:]
3914     long	ll_n1;		// First index for list
3915     long	ll_n2;		// Second index for list range
3916     dict_T	*ll_dict;	// The Dictionary or NULL
3917     dictitem_T	*ll_di;		// The dictitem or NULL
3918     char_u	*ll_newkey;	// New key for Dict in alloc. mem or NULL.
3919     blob_T	*ll_blob;	// The Blob or NULL
3920 } lval_T;
3921 
3922 // Structure used to save the current state.  Used when executing Normal mode
3923 // commands while in any other mode.
3924 typedef struct {
3925     int		save_msg_scroll;
3926     int		save_restart_edit;
3927     int		save_msg_didout;
3928     int		save_State;
3929     int		save_insertmode;
3930     int		save_finish_op;
3931     int		save_opcount;
3932     int		save_reg_executing;
3933     tasave_T	tabuf;
3934 } save_state_T;
3935 
3936 typedef struct {
3937     varnumber_T vv_prevcount;
3938     varnumber_T vv_count;
3939     varnumber_T vv_count1;
3940 } vimvars_save_T;
3941 
3942 // Scope for changing directory
3943 typedef enum {
3944     CDSCOPE_GLOBAL,	// :cd
3945     CDSCOPE_TABPAGE,	// :tcd
3946     CDSCOPE_WINDOW	// :lcd
3947 } cdscope_T;
3948 
3949 // Variable flavor
3950 typedef enum
3951 {
3952     VAR_FLAVOUR_DEFAULT,	// doesn't start with uppercase
3953     VAR_FLAVOUR_SESSION,	// starts with uppercase, some lower
3954     VAR_FLAVOUR_VIMINFO		// all uppercase
3955 } var_flavour_T;
3956 
3957 // argument for mouse_find_win()
3958 typedef enum {
3959     IGNORE_POPUP,	// only check non-popup windows
3960     FIND_POPUP,		// also find popup windows
3961     FAIL_POPUP		// return NULL if mouse on popup window
3962 } mouse_find_T;
3963 
3964 // Symbolic names for some registers.
3965 #define DELETION_REGISTER	36
3966 #ifdef FEAT_CLIPBOARD
3967 # define STAR_REGISTER		37
3968 #  ifdef FEAT_X11
3969 #   define PLUS_REGISTER	38
3970 #  else
3971 #   define PLUS_REGISTER	STAR_REGISTER	    // there is only one
3972 #  endif
3973 #endif
3974 #ifdef FEAT_DND
3975 # define TILDE_REGISTER		(PLUS_REGISTER + 1)
3976 #endif
3977 
3978 #ifdef FEAT_CLIPBOARD
3979 # ifdef FEAT_DND
3980 #  define NUM_REGISTERS		(TILDE_REGISTER + 1)
3981 # else
3982 #  define NUM_REGISTERS		(PLUS_REGISTER + 1)
3983 # endif
3984 #else
3985 # define NUM_REGISTERS		37
3986 #endif
3987 
3988 // structure used by block_prep, op_delete and op_yank for blockwise operators
3989 // also op_change, op_shift, op_insert, op_replace - AKelly
3990 struct block_def
3991 {
3992     int		startspaces;	// 'extra' cols before first char
3993     int		endspaces;	// 'extra' cols after last char
3994     int		textlen;	// chars in block
3995     char_u	*textstart;	// pointer to 1st char (partially) in block
3996     colnr_T	textcol;	// index of chars (partially) in block
3997     colnr_T	start_vcol;	// start col of 1st char wholly inside block
3998     colnr_T	end_vcol;	// start col of 1st char wholly after block
3999     int		is_short;	// TRUE if line is too short to fit in block
4000     int		is_MAX;		// TRUE if curswant==MAXCOL when starting
4001     int		is_oneChar;	// TRUE if block within one character
4002     int		pre_whitesp;	// screen cols of ws before block
4003     int		pre_whitesp_c;	// chars of ws before block
4004     colnr_T	end_char_vcols;	// number of vcols of post-block char
4005     colnr_T	start_char_vcols; // number of vcols of pre-block char
4006 };
4007 
4008 // Each yank register has an array of pointers to lines.
4009 typedef struct
4010 {
4011     char_u	**y_array;	// pointer to array of line pointers
4012     linenr_T	y_size;		// number of lines in y_array
4013     char_u	y_type;		// MLINE, MCHAR or MBLOCK
4014     colnr_T	y_width;	// only set if y_type == MBLOCK
4015 #ifdef FEAT_VIMINFO
4016     time_t	y_time_set;
4017 #endif
4018 } yankreg_T;
4019 
4020 // The offset for a search command is store in a soff struct
4021 // Note: only spats[0].off is really used
4022 typedef struct soffset
4023 {
4024     int		dir;		// search direction, '/' or '?'
4025     int		line;		// search has line offset
4026     int		end;		// search set cursor at end
4027     long	off;		// line or char offset
4028 } soffset_T;
4029 
4030 // A search pattern and its attributes are stored in a spat struct
4031 typedef struct spat
4032 {
4033     char_u	    *pat;	// the pattern (in allocated memory) or NULL
4034     int		    magic;	// magicness of the pattern
4035     int		    no_scs;	// no smartcase for this pattern
4036     soffset_T	    off;
4037 } spat_T;
4038 
4039 /*
4040  * Optional extra arguments for searchit().
4041  */
4042 typedef struct
4043 {
4044     linenr_T	sa_stop_lnum;	// stop after this line number when != 0
4045 #ifdef FEAT_RELTIME
4046     proftime_T	*sa_tm;		// timeout limit or NULL
4047     int		sa_timed_out;	// set when timed out
4048 #endif
4049     int		sa_wrapped;	// search wrapped around
4050 } searchit_arg_T;
4051 
4052 #define WRITEBUFSIZE	8192	// size of normal write buffer
4053 
4054 #define FIO_LATIN1	0x01	// convert Latin1
4055 #define FIO_UTF8	0x02	// convert UTF-8
4056 #define FIO_UCS2	0x04	// convert UCS-2
4057 #define FIO_UCS4	0x08	// convert UCS-4
4058 #define FIO_UTF16	0x10	// convert UTF-16
4059 #ifdef MSWIN
4060 # define FIO_CODEPAGE	0x20	// convert MS-Windows codepage
4061 # define FIO_PUT_CP(x) (((x) & 0xffff) << 16)	// put codepage in top word
4062 # define FIO_GET_CP(x)	(((x)>>16) & 0xffff)	// get codepage from top word
4063 #endif
4064 #ifdef MACOS_CONVERT
4065 # define FIO_MACROMAN	0x20	// convert MacRoman
4066 #endif
4067 #define FIO_ENDIAN_L	0x80	// little endian
4068 #define FIO_ENCRYPTED	0x1000	// encrypt written bytes
4069 #define FIO_NOCONVERT	0x2000	// skip encoding conversion
4070 #define FIO_UCSBOM	0x4000	// check for BOM at start of file
4071 #define FIO_ALL	-1	// allow all formats
4072 
4073 // When converting, a read() or write() may leave some bytes to be converted
4074 // for the next call.  The value is guessed...
4075 #define CONV_RESTLEN 30
4076 
4077 // We have to guess how much a sequence of bytes may expand when converting
4078 // with iconv() to be able to allocate a buffer.
4079 #define ICONV_MULT 8
4080