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