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