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