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