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