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