xref: /vim-8.2.3635/src/structs.h (revision bc2eada5)
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 #ifdef FEAT_VIRTUALEDIT
31     colnr_T	coladd;
32 #endif
33 } pos_T;
34 
35 #ifdef FEAT_VIRTUALEDIT
36 # define INIT_POS_T(l, c, ca) {l, c, ca}
37 #else
38 # define INIT_POS_T(l, c, ca) {l, c}
39 #endif
40 
41 /*
42  * Same, but without coladd.
43  */
44 typedef struct
45 {
46     linenr_T	lnum;	/* line number */
47     colnr_T	col;	/* column number */
48 } lpos_T;
49 
50 /*
51  * Structure used for growing arrays.
52  * This is used to store information that only grows, is deleted all at
53  * once, and needs to be accessed by index.  See ga_clear() and ga_grow().
54  */
55 typedef struct growarray
56 {
57     int	    ga_len;		    /* current number of items used */
58     int	    ga_maxlen;		    /* maximum number of items possible */
59     int	    ga_itemsize;	    /* sizeof(item) */
60     int	    ga_growsize;	    /* number of items to grow each time */
61     void    *ga_data;		    /* pointer to the first item */
62 } garray_T;
63 
64 #define GA_EMPTY    {0, 0, 0, 0, NULL}
65 
66 typedef struct window_S		win_T;
67 typedef struct wininfo_S	wininfo_T;
68 typedef struct frame_S		frame_T;
69 typedef int			scid_T;		/* script ID */
70 typedef struct file_buffer	buf_T;  /* forward declaration */
71 
72 /* Reference to a buffer that stores the value of buf_free_count.
73  * bufref_valid() only needs to check "buf" when the count differs.
74  */
75 typedef struct {
76     buf_T   *br_buf;
77     int	    br_buf_free_count;
78 } bufref_T;
79 
80 /*
81  * This is here because regexp.h needs pos_T and below regprog_T is used.
82  */
83 #include "regexp.h"
84 
85 /*
86  * This is here because gui.h needs the pos_T and win_T, and win_T needs gui.h
87  * for scrollbar_T.
88  */
89 #ifdef FEAT_GUI
90 # include "gui.h"
91 #else
92 # ifdef FEAT_XCLIPBOARD
93 #  include <X11/Intrinsic.h>
94 # endif
95 # define guicolor_T long
96 # define INVALCOLOR ((guicolor_T)0x1ffffff)
97 #endif
98 
99 /*
100  * marks: positions in a file
101  * (a normal mark is a lnum/col pair, the same as a file position)
102  */
103 
104 /* (Note: for EBCDIC there are more than 26, because there are gaps in the
105  * alphabet coding.  To minimize changes to the code, I decided to just
106  * increase the number of possible marks. */
107 #define NMARKS		('z' - 'a' + 1)	/* max. # of named marks */
108 #define JUMPLISTSIZE	100		/* max. # of marks in jump list */
109 #define TAGSTACKSIZE	20		/* max. # of tags in tag stack */
110 
111 typedef struct filemark
112 {
113     pos_T	mark;		/* cursor position */
114     int		fnum;		/* file number */
115 } fmark_T;
116 
117 /* Xtended file mark: also has a file name */
118 typedef struct xfilemark
119 {
120     fmark_T	fmark;
121     char_u	*fname;		/* file name, used when fnum == 0 */
122 #ifdef FEAT_VIMINFO
123     time_T	time_set;
124 #endif
125 } xfmark_T;
126 
127 /*
128  * The taggy struct is used to store the information about a :tag command.
129  */
130 typedef struct taggy
131 {
132     char_u	*tagname;	/* tag name */
133     fmark_T	fmark;		/* cursor position BEFORE ":tag" */
134     int		cur_match;	/* match number */
135     int		cur_fnum;	/* buffer number used for cur_match */
136 } taggy_T;
137 
138 /*
139  * Structure that contains all options that are local to a window.
140  * Used twice in a window: for the current buffer and for all buffers.
141  * Also used in wininfo_T.
142  */
143 typedef struct
144 {
145 #ifdef FEAT_ARABIC
146     int		wo_arab;
147 # define w_p_arab w_onebuf_opt.wo_arab	/* 'arabic' */
148 #endif
149 #ifdef FEAT_LINEBREAK
150     int		wo_bri;
151 # define w_p_bri w_onebuf_opt.wo_bri	/* 'breakindent' */
152     char_u	*wo_briopt;
153 # define w_p_briopt w_onebuf_opt.wo_briopt /* 'breakindentopt' */
154 #endif
155 #ifdef FEAT_DIFF
156     int		wo_diff;
157 # define w_p_diff w_onebuf_opt.wo_diff	/* 'diff' */
158 #endif
159 #ifdef FEAT_FOLDING
160     long	wo_fdc;
161 # define w_p_fdc w_onebuf_opt.wo_fdc	/* 'foldcolumn' */
162     int		wo_fdc_save;
163 # define w_p_fdc_save w_onebuf_opt.wo_fdc_save	/* 'foldenable' saved for diff mode */
164     int		wo_fen;
165 # define w_p_fen w_onebuf_opt.wo_fen	/* 'foldenable' */
166     int		wo_fen_save;
167 # define w_p_fen_save w_onebuf_opt.wo_fen_save	/* 'foldenable' saved for diff mode */
168     char_u	*wo_fdi;
169 # define w_p_fdi w_onebuf_opt.wo_fdi	/* 'foldignore' */
170     long	wo_fdl;
171 # define w_p_fdl w_onebuf_opt.wo_fdl	/* 'foldlevel' */
172     int		wo_fdl_save;
173 # define w_p_fdl_save w_onebuf_opt.wo_fdl_save	/* 'foldlevel' state saved for diff mode */
174     char_u	*wo_fdm;
175 # define w_p_fdm w_onebuf_opt.wo_fdm	/* 'foldmethod' */
176     char_u	*wo_fdm_save;
177 # define w_p_fdm_save w_onebuf_opt.wo_fdm_save	/* 'fdm' saved for diff mode */
178     long	wo_fml;
179 # define w_p_fml w_onebuf_opt.wo_fml	/* 'foldminlines' */
180     long	wo_fdn;
181 # define w_p_fdn w_onebuf_opt.wo_fdn	/* 'foldnestmax' */
182 # ifdef FEAT_EVAL
183     char_u	*wo_fde;
184 # define w_p_fde w_onebuf_opt.wo_fde	/* 'foldexpr' */
185     char_u	*wo_fdt;
186 #  define w_p_fdt w_onebuf_opt.wo_fdt	/* 'foldtext' */
187 # endif
188     char_u	*wo_fmr;
189 # define w_p_fmr w_onebuf_opt.wo_fmr	/* 'foldmarker' */
190 #endif
191 #ifdef FEAT_LINEBREAK
192     int		wo_lbr;
193 # define w_p_lbr w_onebuf_opt.wo_lbr	/* 'linebreak' */
194 #endif
195     int		wo_list;
196 #define w_p_list w_onebuf_opt.wo_list	/* 'list' */
197     int		wo_nu;
198 #define w_p_nu w_onebuf_opt.wo_nu	/* 'number' */
199     int		wo_rnu;
200 #define w_p_rnu w_onebuf_opt.wo_rnu	/* 'relativenumber' */
201 #ifdef FEAT_LINEBREAK
202     long	wo_nuw;
203 # define w_p_nuw w_onebuf_opt.wo_nuw	/* 'numberwidth' */
204 #endif
205 #if defined(FEAT_WINDOWS)
206     int		wo_wfh;
207 # define w_p_wfh w_onebuf_opt.wo_wfh	/* 'winfixheight' */
208     int		wo_wfw;
209 # define w_p_wfw w_onebuf_opt.wo_wfw	/* 'winfixwidth' */
210 #endif
211 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
212     int		wo_pvw;
213 # define w_p_pvw w_onebuf_opt.wo_pvw	/* 'previewwindow' */
214 #endif
215 #ifdef FEAT_RIGHTLEFT
216     int		wo_rl;
217 # define w_p_rl w_onebuf_opt.wo_rl	/* 'rightleft' */
218     char_u	*wo_rlc;
219 # define w_p_rlc w_onebuf_opt.wo_rlc	/* 'rightleftcmd' */
220 #endif
221     long	wo_scr;
222 #define w_p_scr w_onebuf_opt.wo_scr	/* 'scroll' */
223 #ifdef FEAT_SPELL
224     int		wo_spell;
225 # define w_p_spell w_onebuf_opt.wo_spell /* 'spell' */
226 #endif
227 #ifdef FEAT_SYN_HL
228     int		wo_cuc;
229 # define w_p_cuc w_onebuf_opt.wo_cuc	/* 'cursorcolumn' */
230     int		wo_cul;
231 # define w_p_cul w_onebuf_opt.wo_cul	/* 'cursorline' */
232     char_u	*wo_cc;
233 # define w_p_cc w_onebuf_opt.wo_cc	/* 'colorcolumn' */
234 #endif
235 #ifdef FEAT_STL_OPT
236     char_u	*wo_stl;
237 #define w_p_stl w_onebuf_opt.wo_stl	/* 'statusline' */
238 #endif
239 #ifdef FEAT_SCROLLBIND
240     int		wo_scb;
241 # define w_p_scb w_onebuf_opt.wo_scb	/* 'scrollbind' */
242     int		wo_diff_saved; /* options were saved for starting diff mode */
243 # define w_p_diff_saved w_onebuf_opt.wo_diff_saved
244     int		wo_scb_save;	/* 'scrollbind' saved for diff mode*/
245 # define w_p_scb_save w_onebuf_opt.wo_scb_save
246 #endif
247     int		wo_wrap;
248 #define w_p_wrap w_onebuf_opt.wo_wrap	/* 'wrap' */
249 #ifdef FEAT_DIFF
250     int		wo_wrap_save;	/* 'wrap' state saved for diff mode*/
251 # define w_p_wrap_save w_onebuf_opt.wo_wrap_save
252 #endif
253 #ifdef FEAT_CONCEAL
254     char_u	*wo_cocu;		/* 'concealcursor' */
255 # define w_p_cocu w_onebuf_opt.wo_cocu
256     long	wo_cole;		/* 'conceallevel' */
257 # define w_p_cole w_onebuf_opt.wo_cole
258 #endif
259 #ifdef FEAT_CURSORBIND
260     int		wo_crb;
261 # define w_p_crb w_onebuf_opt.wo_crb	/* 'cursorbind' */
262     int		wo_crb_save;	/* 'cursorbind' state saved for diff mode*/
263 # define w_p_crb_save w_onebuf_opt.wo_crb_save
264 #endif
265 #ifdef FEAT_SIGNS
266     char_u	*wo_scl;
267 # define w_p_scl w_onebuf_opt.wo_scl	/* 'signcolumn' */
268 #endif
269 
270 #ifdef FEAT_EVAL
271     int		wo_scriptID[WV_COUNT];	/* SIDs for window-local options */
272 # define w_p_scriptID w_onebuf_opt.wo_scriptID
273 #endif
274 } winopt_T;
275 
276 /*
277  * Window info stored with a buffer.
278  *
279  * Two types of info are kept for a buffer which are associated with a
280  * specific window:
281  * 1. Each window can have a different line number associated with a buffer.
282  * 2. The window-local options for a buffer work in a similar way.
283  * The window-info is kept in a list at b_wininfo.  It is kept in
284  * most-recently-used order.
285  */
286 struct wininfo_S
287 {
288     wininfo_T	*wi_next;	/* next entry or NULL for last entry */
289     wininfo_T	*wi_prev;	/* previous entry or NULL for first entry */
290     win_T	*wi_win;	/* pointer to window that did set wi_fpos */
291     pos_T	wi_fpos;	/* last cursor position in the file */
292     int		wi_optset;	/* TRUE when wi_opt has useful values */
293     winopt_T	wi_opt;		/* local window options */
294 #ifdef FEAT_FOLDING
295     int		wi_fold_manual;	/* copy of w_fold_manual */
296     garray_T	wi_folds;	/* clone of w_folds */
297 #endif
298 };
299 
300 /*
301  * Info used to pass info about a fold from the fold-detection code to the
302  * code that displays the foldcolumn.
303  */
304 typedef struct foldinfo
305 {
306     int		fi_level;	/* level of the fold; when this is zero the
307 				   other fields are invalid */
308     int		fi_lnum;	/* line number where fold starts */
309     int		fi_low_level;	/* lowest fold level that starts in the same
310 				   line */
311 } foldinfo_T;
312 
313 /* Structure to store info about the Visual area. */
314 typedef struct
315 {
316     pos_T	vi_start;	/* start pos of last VIsual */
317     pos_T	vi_end;		/* end position of last VIsual */
318     int		vi_mode;	/* VIsual_mode of last VIsual */
319     colnr_T	vi_curswant;	/* MAXCOL from w_curswant */
320 } visualinfo_T;
321 
322 /*
323  * structures used for undo
324  */
325 
326 typedef struct u_entry u_entry_T;
327 typedef struct u_header u_header_T;
328 struct u_entry
329 {
330     u_entry_T	*ue_next;	/* pointer to next entry in list */
331     linenr_T	ue_top;		/* number of line above undo block */
332     linenr_T	ue_bot;		/* number of line below undo block */
333     linenr_T	ue_lcount;	/* linecount when u_save called */
334     char_u	**ue_array;	/* array of lines in undo block */
335     long	ue_size;	/* number of lines in ue_array */
336 #ifdef U_DEBUG
337     int		ue_magic;	/* magic number to check allocation */
338 #endif
339 };
340 
341 struct u_header
342 {
343     /* The following have a pointer and a number. The number is used when
344      * reading the undo file in u_read_undo() */
345     union {
346 	u_header_T *ptr;	/* pointer to next undo header in list */
347 	long	   seq;
348     } uh_next;
349     union {
350 	u_header_T *ptr;	/* pointer to previous header in list */
351 	long	   seq;
352     } uh_prev;
353     union {
354 	u_header_T *ptr;	/* pointer to next header for alt. redo */
355 	long	   seq;
356     } uh_alt_next;
357     union {
358 	u_header_T *ptr;	/* pointer to previous header for alt. redo */
359 	long	   seq;
360     } uh_alt_prev;
361     long	uh_seq;		/* sequence number, higher == newer undo */
362     int		uh_walk;	/* used by undo_time() */
363     u_entry_T	*uh_entry;	/* pointer to first entry */
364     u_entry_T	*uh_getbot_entry; /* pointer to where ue_bot must be set */
365     pos_T	uh_cursor;	/* cursor position before saving */
366 #ifdef FEAT_VIRTUALEDIT
367     long	uh_cursor_vcol;
368 #endif
369     int		uh_flags;	/* see below */
370     pos_T	uh_namedm[NMARKS];	/* marks before undo/after redo */
371     visualinfo_T uh_visual;	/* Visual areas before undo/after redo */
372     time_T	uh_time;	/* timestamp when the change was made */
373     long	uh_save_nr;	/* set when the file was saved after the
374 				   changes in this block */
375 #ifdef U_DEBUG
376     int		uh_magic;	/* magic number to check allocation */
377 #endif
378 };
379 
380 /* values for uh_flags */
381 #define UH_CHANGED  0x01	/* b_changed flag before undo/after redo */
382 #define UH_EMPTYBUF 0x02	/* buffer was empty */
383 
384 /*
385  * structures used in undo.c
386  */
387 #if VIM_SIZEOF_INT > 2
388 # define ALIGN_LONG	/* longword alignment and use filler byte */
389 # define ALIGN_SIZE (sizeof(long))
390 #else
391 # define ALIGN_SIZE (sizeof(short))
392 #endif
393 
394 #define ALIGN_MASK (ALIGN_SIZE - 1)
395 
396 typedef struct m_info minfo_T;
397 
398 /*
399  * structure used to link chunks in one of the free chunk lists.
400  */
401 struct m_info
402 {
403 #ifdef ALIGN_LONG
404     long_u	m_size;		/* size of the chunk (including m_info) */
405 #else
406     short_u	m_size;		/* size of the chunk (including m_info) */
407 #endif
408     minfo_T	*m_next;	/* pointer to next free chunk in the list */
409 };
410 
411 /*
412  * things used in memfile.c
413  */
414 
415 typedef struct block_hdr    bhdr_T;
416 typedef struct memfile	    memfile_T;
417 typedef long		    blocknr_T;
418 
419 /*
420  * mf_hashtab_T is a chained hashtable with blocknr_T key and arbitrary
421  * structures as items.  This is an intrusive data structure: we require
422  * that items begin with mf_hashitem_T which contains the key and linked
423  * list pointers.  List of items in each bucket is doubly-linked.
424  */
425 
426 typedef struct mf_hashitem_S mf_hashitem_T;
427 
428 struct mf_hashitem_S
429 {
430     mf_hashitem_T   *mhi_next;
431     mf_hashitem_T   *mhi_prev;
432     blocknr_T	    mhi_key;
433 };
434 
435 #define MHT_INIT_SIZE   64
436 
437 typedef struct mf_hashtab_S
438 {
439     long_u	    mht_mask;	    /* mask used for hash value (nr of items
440 				     * in array is "mht_mask" + 1) */
441     long_u	    mht_count;	    /* nr of items inserted into hashtable */
442     mf_hashitem_T   **mht_buckets;  /* points to mht_small_buckets or
443 				     *dynamically allocated array */
444     mf_hashitem_T   *mht_small_buckets[MHT_INIT_SIZE];   /* initial buckets */
445     char	    mht_fixed;	    /* non-zero value forbids growth */
446 } mf_hashtab_T;
447 
448 /*
449  * for each (previously) used block in the memfile there is one block header.
450  *
451  * The block may be linked in the used list OR in the free list.
452  * The used blocks are also kept in hash lists.
453  *
454  * The used list is a doubly linked list, most recently used block first.
455  *	The blocks in the used list have a block of memory allocated.
456  *	mf_used_count is the number of pages in the used list.
457  * The hash lists are used to quickly find a block in the used list.
458  * The free list is a single linked list, not sorted.
459  *	The blocks in the free list have no block of memory allocated and
460  *	the contents of the block in the file (if any) is irrelevant.
461  */
462 
463 struct block_hdr
464 {
465     mf_hashitem_T bh_hashitem;      /* header for hash table and key */
466 #define bh_bnum bh_hashitem.mhi_key /* block number, part of bh_hashitem */
467 
468     bhdr_T	*bh_next;	    /* next block_hdr in free or used list */
469     bhdr_T	*bh_prev;	    /* previous block_hdr in used list */
470     char_u	*bh_data;	    /* pointer to memory (for used block) */
471     int		bh_page_count;	    /* number of pages in this block */
472 
473 #define BH_DIRTY    1
474 #define BH_LOCKED   2
475     char	bh_flags;	    /* BH_DIRTY or BH_LOCKED */
476 };
477 
478 /*
479  * when a block with a negative number is flushed to the file, it gets
480  * a positive number. Because the reference to the block is still the negative
481  * number, we remember the translation to the new positive number in the
482  * double linked trans lists. The structure is the same as the hash lists.
483  */
484 typedef struct nr_trans NR_TRANS;
485 
486 struct nr_trans
487 {
488     mf_hashitem_T nt_hashitem;		/* header for hash table and key */
489 #define nt_old_bnum nt_hashitem.mhi_key	/* old, negative, number */
490 
491     blocknr_T	nt_new_bnum;		/* new, positive, number */
492 };
493 
494 
495 typedef struct buffblock buffblock_T;
496 typedef struct buffheader buffheader_T;
497 
498 /*
499  * structure used to store one block of the stuff/redo/recording buffers
500  */
501 struct buffblock
502 {
503     buffblock_T	*b_next;	/* pointer to next buffblock */
504     char_u	b_str[1];	/* contents (actually longer) */
505 };
506 
507 /*
508  * header used for the stuff buffer and the redo buffer
509  */
510 struct buffheader
511 {
512     buffblock_T	bh_first;	/* first (dummy) block of list */
513     buffblock_T	*bh_curr;	/* buffblock for appending */
514     int		bh_index;	/* index for reading */
515     int		bh_space;	/* space in bh_curr for appending */
516 };
517 
518 /*
519  * used for completion on the command line
520  */
521 typedef struct expand
522 {
523     int		xp_context;		/* type of expansion */
524     char_u	*xp_pattern;		/* start of item to expand */
525     int		xp_pattern_len;		/* bytes in xp_pattern before cursor */
526 #if defined(FEAT_USR_CMDS) && defined(FEAT_EVAL) && defined(FEAT_CMDL_COMPL)
527     char_u	*xp_arg;		/* completion function */
528     int		xp_scriptID;		/* SID for completion function */
529 #endif
530     int		xp_backslash;		/* one of the XP_BS_ values */
531 #ifndef BACKSLASH_IN_FILENAME
532     int		xp_shell;		/* TRUE for a shell command, more
533 					   characters need to be escaped */
534 #endif
535     int		xp_numfiles;		/* number of files found by
536 						    file name completion */
537     char_u	**xp_files;		/* list of files */
538     char_u	*xp_line;		/* text being completed */
539     int		xp_col;			/* cursor position in line */
540 } expand_T;
541 
542 /* values for xp_backslash */
543 #define XP_BS_NONE	0	/* nothing special for backslashes */
544 #define XP_BS_ONE	1	/* uses one backslash before a space */
545 #define XP_BS_THREE	2	/* uses three backslashes before a space */
546 
547 /*
548  * Command modifiers ":vertical", ":browse", ":confirm" and ":hide" set a flag.
549  * This needs to be saved for recursive commands, put them in a structure for
550  * easy manipulation.
551  */
552 typedef struct
553 {
554     int		hide;			/* TRUE when ":hide" was used */
555 # ifdef FEAT_BROWSE_CMD
556     int		browse;			/* TRUE to invoke file dialog */
557 # endif
558 # ifdef FEAT_WINDOWS
559     int		split;			/* flags for win_split() */
560     int		tab;			/* > 0 when ":tab" was used */
561 # endif
562 # if defined(FEAT_GUI_DIALOG) || defined(FEAT_CON_DIALOG)
563     int		confirm;		/* TRUE to invoke yes/no dialog */
564 # endif
565     int		keepalt;		/* TRUE when ":keepalt" was used */
566     int		keepmarks;		/* TRUE when ":keepmarks" was used */
567     int		keepjumps;		/* TRUE when ":keepjumps" was used */
568     int		lockmarks;		/* TRUE when ":lockmarks" was used */
569     int		keeppatterns;		/* TRUE when ":keeppatterns" was used */
570     int		noswapfile;		/* TRUE when ":noswapfile" was used */
571 # ifdef FEAT_AUTOCMD
572     char_u	*save_ei;		/* saved value of 'eventignore' */
573 # endif
574     regmatch_T	filter_regmatch;	/* set by :filter /pat/ */
575     int		filter_force;		/* set for :filter! */
576 } cmdmod_T;
577 
578 #define MF_SEED_LEN	8
579 
580 struct memfile
581 {
582     char_u	*mf_fname;		/* name of the file */
583     char_u	*mf_ffname;		/* idem, full path */
584     int		mf_fd;			/* file descriptor */
585     bhdr_T	*mf_free_first;		/* first block_hdr in free list */
586     bhdr_T	*mf_used_first;		/* mru block_hdr in used list */
587     bhdr_T	*mf_used_last;		/* lru block_hdr in used list */
588     unsigned	mf_used_count;		/* number of pages in used list */
589     unsigned	mf_used_count_max;	/* maximum number of pages in memory */
590     mf_hashtab_T mf_hash;		/* hash lists */
591     mf_hashtab_T mf_trans;		/* trans lists */
592     blocknr_T	mf_blocknr_max;		/* highest positive block number + 1*/
593     blocknr_T	mf_blocknr_min;		/* lowest negative block number - 1 */
594     blocknr_T	mf_neg_count;		/* number of negative blocks numbers */
595     blocknr_T	mf_infile_count;	/* number of pages in the file */
596     unsigned	mf_page_size;		/* number of bytes in a page */
597     int		mf_dirty;		/* TRUE if there are dirty blocks */
598 #ifdef FEAT_CRYPT
599     buf_T	*mf_buffer;		/* buffer this memfile is for */
600     char_u	mf_seed[MF_SEED_LEN];	/* seed for encryption */
601 
602     /* Values for key, method and seed used for reading data blocks when
603      * updating for a newly set key or method. Only when mf_old_key != NULL. */
604     char_u	*mf_old_key;
605     int		mf_old_cm;
606     char_u	mf_old_seed[MF_SEED_LEN];
607 #endif
608 };
609 
610 /*
611  * things used in memline.c
612  */
613 /*
614  * When searching for a specific line, we remember what blocks in the tree
615  * are the branches leading to that block. This is stored in ml_stack.  Each
616  * entry is a pointer to info in a block (may be data block or pointer block)
617  */
618 typedef struct info_pointer
619 {
620     blocknr_T	ip_bnum;	/* block number */
621     linenr_T	ip_low;		/* lowest lnum in this block */
622     linenr_T	ip_high;	/* highest lnum in this block */
623     int		ip_index;	/* index for block with current lnum */
624 } infoptr_T;	/* block/index pair */
625 
626 #ifdef FEAT_BYTEOFF
627 typedef struct ml_chunksize
628 {
629     int		mlcs_numlines;
630     long	mlcs_totalsize;
631 } chunksize_T;
632 
633  /* Flags when calling ml_updatechunk() */
634 
635 #define ML_CHNK_ADDLINE 1
636 #define ML_CHNK_DELLINE 2
637 #define ML_CHNK_UPDLINE 3
638 #endif
639 
640 /*
641  * the memline structure holds all the information about a memline
642  */
643 typedef struct memline
644 {
645     linenr_T	ml_line_count;	/* number of lines in the buffer */
646 
647     memfile_T	*ml_mfp;	/* pointer to associated memfile */
648 
649 #define ML_EMPTY	1	/* empty buffer */
650 #define ML_LINE_DIRTY	2	/* cached line was changed and allocated */
651 #define ML_LOCKED_DIRTY	4	/* ml_locked was changed */
652 #define ML_LOCKED_POS	8	/* ml_locked needs positive block number */
653     int		ml_flags;
654 
655     infoptr_T	*ml_stack;	/* stack of pointer blocks (array of IPTRs) */
656     int		ml_stack_top;	/* current top of ml_stack */
657     int		ml_stack_size;	/* total number of entries in ml_stack */
658 
659     linenr_T	ml_line_lnum;	/* line number of cached line, 0 if not valid */
660     char_u	*ml_line_ptr;	/* pointer to cached line */
661 
662     bhdr_T	*ml_locked;	/* block used by last ml_get */
663     linenr_T	ml_locked_low;	/* first line in ml_locked */
664     linenr_T	ml_locked_high;	/* last line in ml_locked */
665     int		ml_locked_lineadd;  /* number of lines inserted in ml_locked */
666 #ifdef FEAT_BYTEOFF
667     chunksize_T *ml_chunksize;
668     int		ml_numchunks;
669     int		ml_usedchunks;
670 #endif
671 } memline_T;
672 
673 #if defined(FEAT_SIGNS) || defined(PROTO)
674 typedef struct signlist signlist_T;
675 
676 struct signlist
677 {
678     int		id;		/* unique identifier for each placed sign */
679     linenr_T	lnum;		/* line number which has this sign */
680     int		typenr;		/* typenr of sign */
681     signlist_T	*next;		/* next signlist entry */
682 # ifdef FEAT_NETBEANS_INTG
683     signlist_T  *prev;		/* previous entry -- for easy reordering */
684 # endif
685 };
686 
687 /* type argument for buf_getsigntype() */
688 #define SIGN_ANY	0
689 #define SIGN_LINEHL	1
690 #define SIGN_ICON	2
691 #define SIGN_TEXT	3
692 #endif
693 
694 /*
695  * Argument list: Array of file names.
696  * Used for the global argument list and the argument lists local to a window.
697  */
698 typedef struct arglist
699 {
700     garray_T	al_ga;		/* growarray with the array of file names */
701     int		al_refcount;	/* number of windows using this arglist */
702     int		id;		/* id of this arglist */
703 } alist_T;
704 
705 /*
706  * For each argument remember the file name as it was given, and the buffer
707  * number that contains the expanded file name (required for when ":cd" is
708  * used.
709  */
710 typedef struct argentry
711 {
712     char_u	*ae_fname;	/* file name as specified */
713     int		ae_fnum;	/* buffer number with expanded file name */
714 } aentry_T;
715 
716 #ifdef FEAT_WINDOWS
717 # define ALIST(win) (win)->w_alist
718 #else
719 # define ALIST(win) (&global_alist)
720 #endif
721 #define GARGLIST	((aentry_T *)global_alist.al_ga.ga_data)
722 #define ARGLIST		((aentry_T *)ALIST(curwin)->al_ga.ga_data)
723 #define WARGLIST(wp)	((aentry_T *)ALIST(wp)->al_ga.ga_data)
724 #define AARGLIST(al)	((aentry_T *)((al)->al_ga.ga_data))
725 #define GARGCOUNT	(global_alist.al_ga.ga_len)
726 #define ARGCOUNT	(ALIST(curwin)->al_ga.ga_len)
727 #define WARGCOUNT(wp)	(ALIST(wp)->al_ga.ga_len)
728 
729 /*
730  * A list used for saving values of "emsg_silent".  Used by ex_try() to save the
731  * value of "emsg_silent" if it was non-zero.  When this is done, the CSF_SILENT
732  * flag below is set.
733  */
734 
735 typedef struct eslist_elem eslist_T;
736 struct eslist_elem
737 {
738     int		saved_emsg_silent;	/* saved value of "emsg_silent" */
739     eslist_T	*next;			/* next element on the list */
740 };
741 
742 /*
743  * For conditional commands a stack is kept of nested conditionals.
744  * When cs_idx < 0, there is no conditional command.
745  */
746 #define CSTACK_LEN	50
747 
748 struct condstack
749 {
750     short	cs_flags[CSTACK_LEN];	/* CSF_ flags */
751     char	cs_pending[CSTACK_LEN];	/* CSTP_: what's pending in ":finally"*/
752     union {
753 	void	*csp_rv[CSTACK_LEN];	/* return typeval for pending return */
754 	void	*csp_ex[CSTACK_LEN];	/* exception for pending throw */
755     }		cs_pend;
756     void	*cs_forinfo[CSTACK_LEN]; /* info used by ":for" */
757     int		cs_line[CSTACK_LEN];	/* line nr of ":while"/":for" line */
758     int		cs_idx;			/* current entry, or -1 if none */
759     int		cs_looplevel;		/* nr of nested ":while"s and ":for"s */
760     int		cs_trylevel;		/* nr of nested ":try"s */
761     eslist_T	*cs_emsg_silent_list;	/* saved values of "emsg_silent" */
762     char	cs_lflags;		/* loop flags: CSL_ flags */
763 };
764 # define cs_rettv	cs_pend.csp_rv
765 # define cs_exception	cs_pend.csp_ex
766 
767 /* There is no CSF_IF, the lack of CSF_WHILE, CSF_FOR and CSF_TRY means ":if"
768  * was used. */
769 # define CSF_TRUE	0x0001	/* condition was TRUE */
770 # define CSF_ACTIVE	0x0002	/* current state is active */
771 # define CSF_ELSE	0x0004	/* ":else" has been passed */
772 # define CSF_WHILE	0x0008	/* is a ":while" */
773 # define CSF_FOR	0x0010	/* is a ":for" */
774 
775 # define CSF_TRY	0x0100	/* is a ":try" */
776 # define CSF_FINALLY	0x0200	/* ":finally" has been passed */
777 # define CSF_THROWN	0x0400	/* exception thrown to this try conditional */
778 # define CSF_CAUGHT	0x0800  /* exception caught by this try conditional */
779 # define CSF_SILENT	0x1000	/* "emsg_silent" reset by ":try" */
780 /* Note that CSF_ELSE is only used when CSF_TRY and CSF_WHILE are unset
781  * (an ":if"), and CSF_SILENT is only used when CSF_TRY is set. */
782 
783 /*
784  * What's pending for being reactivated at the ":endtry" of this try
785  * conditional:
786  */
787 # define CSTP_NONE	0	/* nothing pending in ":finally" clause */
788 # define CSTP_ERROR	1	/* an error is pending */
789 # define CSTP_INTERRUPT	2	/* an interrupt is pending */
790 # define CSTP_THROW	4	/* a throw is pending */
791 # define CSTP_BREAK	8	/* ":break" is pending */
792 # define CSTP_CONTINUE	16	/* ":continue" is pending */
793 # define CSTP_RETURN	24	/* ":return" is pending */
794 # define CSTP_FINISH	32	/* ":finish" is pending */
795 
796 /*
797  * Flags for the cs_lflags item in struct condstack.
798  */
799 # define CSL_HAD_LOOP	 1	/* just found ":while" or ":for" */
800 # define CSL_HAD_ENDLOOP 2	/* just found ":endwhile" or ":endfor" */
801 # define CSL_HAD_CONT	 4	/* just found ":continue" */
802 # define CSL_HAD_FINA	 8	/* just found ":finally" */
803 
804 /*
805  * A list of error messages that can be converted to an exception.  "throw_msg"
806  * is only set in the first element of the list.  Usually, it points to the
807  * original message stored in that element, but sometimes it points to a later
808  * message in the list.  See cause_errthrow() below.
809  */
810 struct msglist
811 {
812     char_u		*msg;		/* original message */
813     char_u		*throw_msg;	/* msg to throw: usually original one */
814     struct msglist	*next;		/* next of several messages in a row */
815 };
816 
817 /*
818  * The exception types.
819  */
820 typedef enum
821 {
822     ET_USER,		/* exception caused by ":throw" command */
823     ET_ERROR,		/* error exception */
824     ET_INTERRUPT	/* interrupt exception triggered by Ctrl-C */
825 } except_type_T;
826 
827 /*
828  * Structure describing an exception.
829  * (don't use "struct exception", it's used by the math library).
830  */
831 typedef struct vim_exception except_T;
832 struct vim_exception
833 {
834     except_type_T	type;		/* exception type */
835     char_u		*value;		/* exception value */
836     struct msglist	*messages;	/* message(s) causing error exception */
837     char_u		*throw_name;	/* name of the throw point */
838     linenr_T		throw_lnum;	/* line number of the throw point */
839     except_T		*caught;	/* next exception on the caught stack */
840 };
841 
842 /*
843  * Structure to save the error/interrupt/exception state between calls to
844  * enter_cleanup() and leave_cleanup().  Must be allocated as an automatic
845  * variable by the (common) caller of these functions.
846  */
847 typedef struct cleanup_stuff cleanup_T;
848 struct cleanup_stuff
849 {
850     int pending;		/* error/interrupt/exception state */
851     except_T *exception;	/* exception value */
852 };
853 
854 #ifdef FEAT_SYN_HL
855 /* struct passed to in_id_list() */
856 struct sp_syn
857 {
858     int		inc_tag;	/* ":syn include" unique tag */
859     short	id;		/* highlight group ID of item */
860     short	*cont_in_list;	/* cont.in group IDs, if non-zero */
861 };
862 
863 /*
864  * Each keyword has one keyentry, which is linked in a hash list.
865  */
866 typedef struct keyentry keyentry_T;
867 
868 struct keyentry
869 {
870     keyentry_T	*ke_next;	/* next entry with identical "keyword[]" */
871     struct sp_syn k_syn;	/* struct passed to in_id_list() */
872     short	*next_list;	/* ID list for next match (if non-zero) */
873     int		flags;
874     int		k_char;		/* conceal substitute character */
875     char_u	keyword[1];	/* actually longer */
876 };
877 
878 /*
879  * Struct used to store one state of the state stack.
880  */
881 typedef struct buf_state
882 {
883     int		    bs_idx;	 /* index of pattern */
884     int		    bs_flags;	 /* flags for pattern */
885 #ifdef FEAT_CONCEAL
886     int		    bs_seqnr;	 /* stores si_seqnr */
887     int		    bs_cchar;	 /* stores si_cchar */
888 #endif
889     reg_extmatch_T *bs_extmatch; /* external matches from start pattern */
890 } bufstate_T;
891 
892 /*
893  * syn_state contains the syntax state stack for the start of one line.
894  * Used by b_sst_array[].
895  */
896 typedef struct syn_state synstate_T;
897 
898 struct syn_state
899 {
900     synstate_T	*sst_next;	/* next entry in used or free list */
901     linenr_T	sst_lnum;	/* line number for this state */
902     union
903     {
904 	bufstate_T	sst_stack[SST_FIX_STATES]; /* short state stack */
905 	garray_T	sst_ga;	/* growarray for long state stack */
906     } sst_union;
907     int		sst_next_flags;	/* flags for sst_next_list */
908     int		sst_stacksize;	/* number of states on the stack */
909     short	*sst_next_list;	/* "nextgroup" list in this state
910 				 * (this is a copy, don't free it! */
911     disptick_T	sst_tick;	/* tick when last displayed */
912     linenr_T	sst_change_lnum;/* when non-zero, change in this line
913 				 * may have made the state invalid */
914 };
915 #endif /* FEAT_SYN_HL */
916 
917 /*
918  * Structure shared between syntax.c, screen.c and gui_x11.c.
919  */
920 typedef struct attr_entry
921 {
922     short	    ae_attr;		/* HL_BOLD, etc. */
923     union
924     {
925 	struct
926 	{
927 	    char_u	    *start;	/* start escape sequence */
928 	    char_u	    *stop;	/* stop escape sequence */
929 	} term;
930 	struct
931 	{
932 	    /* These colors need to be > 8 bits to hold 256. */
933 	    short_u	    fg_color;	/* foreground color number */
934 	    short_u	    bg_color;	/* background color number */
935 # ifdef FEAT_TERMGUICOLORS
936 	    guicolor_T	    fg_rgb;	/* foreground color RGB */
937 	    guicolor_T	    bg_rgb;	/* background color RGB */
938 # endif
939 	} cterm;
940 # ifdef FEAT_GUI
941 	struct
942 	{
943 	    guicolor_T	    fg_color;	/* foreground color handle */
944 	    guicolor_T	    bg_color;	/* background color handle */
945 	    guicolor_T	    sp_color;	/* special color handle */
946 	    GuiFont	    font;	/* font handle */
947 #  ifdef FEAT_XFONTSET
948 	    GuiFontset	    fontset;	/* fontset handle */
949 #  endif
950 	} gui;
951 # endif
952     } ae_u;
953 } attrentry_T;
954 
955 #ifdef USE_ICONV
956 # ifdef HAVE_ICONV_H
957 #  include <iconv.h>
958 # else
959 #  if defined(MACOS_X)
960 #   include <sys/errno.h>
961 #   define EILSEQ ENOENT /* MacOS X does not have EILSEQ */
962 typedef struct _iconv_t *iconv_t;
963 #  else
964 #   if defined(MACOS_CLASSIC)
965 typedef struct _iconv_t *iconv_t;
966 #    define EINVAL	22
967 #    define E2BIG	7
968 #    define ENOENT	2
969 #    define EFAULT	14
970 #    define EILSEQ	123
971 #   else
972 #    include <errno.h>
973 #   endif
974 #  endif
975 typedef void *iconv_t;
976 # endif
977 #endif
978 
979 /*
980  * Used for the typeahead buffer: typebuf.
981  */
982 typedef struct
983 {
984     char_u	*tb_buf;	/* buffer for typed characters */
985     char_u	*tb_noremap;	/* mapping flags for characters in tb_buf[] */
986     int		tb_buflen;	/* size of tb_buf[] */
987     int		tb_off;		/* current position in tb_buf[] */
988     int		tb_len;		/* number of valid bytes in tb_buf[] */
989     int		tb_maplen;	/* nr of mapped bytes in tb_buf[] */
990     int		tb_silent;	/* nr of silently mapped bytes in tb_buf[] */
991     int		tb_no_abbr_cnt; /* nr of bytes without abbrev. in tb_buf[] */
992     int		tb_change_cnt;	/* nr of time tb_buf was changed; never zero */
993 } typebuf_T;
994 
995 /* Struct to hold the saved typeahead for save_typeahead(). */
996 typedef struct
997 {
998     typebuf_T		save_typebuf;
999     int			typebuf_valid;	    /* TRUE when save_typebuf valid */
1000     int			old_char;
1001     int			old_mod_mask;
1002     buffheader_T	save_readbuf1;
1003     buffheader_T	save_readbuf2;
1004 #ifdef USE_INPUT_BUF
1005     char_u		*save_inputbuf;
1006 #endif
1007 } tasave_T;
1008 
1009 /*
1010  * Used for conversion of terminal I/O and script files.
1011  */
1012 typedef struct
1013 {
1014     int		vc_type;	/* zero or one of the CONV_ values */
1015     int		vc_factor;	/* max. expansion factor */
1016 # ifdef WIN3264
1017     int		vc_cpfrom;	/* codepage to convert from (CONV_CODEPAGE) */
1018     int		vc_cpto;	/* codepage to convert to (CONV_CODEPAGE) */
1019 # endif
1020 # ifdef USE_ICONV
1021     iconv_t	vc_fd;		/* for CONV_ICONV */
1022 # endif
1023     int		vc_fail;	/* fail for invalid char, don't use '?' */
1024 } vimconv_T;
1025 
1026 /*
1027  * Structure used for reading from the viminfo file.
1028  */
1029 typedef struct
1030 {
1031     char_u	*vir_line;	/* text of the current line */
1032     FILE	*vir_fd;	/* file descriptor */
1033 #ifdef FEAT_MBYTE
1034     vimconv_T	vir_conv;	/* encoding conversion */
1035 #endif
1036     int		vir_version;	/* viminfo version detected or -1 */
1037     garray_T	vir_barlines;	/* lines starting with | */
1038 } vir_T;
1039 
1040 #define CONV_NONE		0
1041 #define CONV_TO_UTF8		1
1042 #define CONV_9_TO_UTF8		2
1043 #define CONV_TO_LATIN1		3
1044 #define CONV_TO_LATIN9		4
1045 #define CONV_ICONV		5
1046 #ifdef WIN3264
1047 # define CONV_CODEPAGE		10	/* codepage -> codepage */
1048 #endif
1049 #ifdef MACOS_X
1050 # define CONV_MAC_LATIN1	20
1051 # define CONV_LATIN1_MAC	21
1052 # define CONV_MAC_UTF8		22
1053 # define CONV_UTF8_MAC		23
1054 #endif
1055 
1056 /*
1057  * Structure used for mappings and abbreviations.
1058  */
1059 typedef struct mapblock mapblock_T;
1060 struct mapblock
1061 {
1062     mapblock_T	*m_next;	/* next mapblock in list */
1063     char_u	*m_keys;	/* mapped from, lhs */
1064     char_u	*m_str;		/* mapped to, rhs */
1065     char_u	*m_orig_str;	/* rhs as entered by the user */
1066     int		m_keylen;	/* strlen(m_keys) */
1067     int		m_mode;		/* valid mode */
1068     int		m_noremap;	/* if non-zero no re-mapping for m_str */
1069     char	m_silent;	/* <silent> used, don't echo commands */
1070     char	m_nowait;	/* <nowait> used */
1071 #ifdef FEAT_EVAL
1072     char	m_expr;		/* <expr> used, m_str is an expression */
1073     scid_T	m_script_ID;	/* ID of script where map was defined */
1074 #endif
1075 };
1076 
1077 /*
1078  * Used for highlighting in the status line.
1079  */
1080 struct stl_hlrec
1081 {
1082     char_u	*start;
1083     int		userhl;		/* 0: no HL, 1-9: User HL, < 0 for syn ID */
1084 };
1085 
1086 
1087 /*
1088  * Syntax items - usually buffer-specific.
1089  */
1090 
1091 /* Item for a hashtable.  "hi_key" can be one of three values:
1092  * NULL:	   Never been used
1093  * HI_KEY_REMOVED: Entry was removed
1094  * Otherwise:	   Used item, pointer to the actual key; this usually is
1095  *		   inside the item, subtract an offset to locate the item.
1096  *		   This reduces the size of hashitem by 1/3.
1097  */
1098 typedef struct hashitem_S
1099 {
1100     long_u	hi_hash;	/* cached hash number of hi_key */
1101     char_u	*hi_key;
1102 } hashitem_T;
1103 
1104 /* The address of "hash_removed" is used as a magic number for hi_key to
1105  * indicate a removed item. */
1106 #define HI_KEY_REMOVED &hash_removed
1107 #define HASHITEM_EMPTY(hi) ((hi)->hi_key == NULL || (hi)->hi_key == &hash_removed)
1108 
1109 /* Initial size for a hashtable.  Our items are relatively small and growing
1110  * is expensive, thus use 16 as a start.  Must be a power of 2. */
1111 #define HT_INIT_SIZE 16
1112 
1113 typedef struct hashtable_S
1114 {
1115     long_u	ht_mask;	/* mask used for hash value (nr of items in
1116 				 * array is "ht_mask" + 1) */
1117     long_u	ht_used;	/* number of items used */
1118     long_u	ht_filled;	/* number of items used + removed */
1119     int		ht_locked;	/* counter for hash_lock() */
1120     int		ht_error;	/* when set growing failed, can't add more
1121 				   items before growing works */
1122     hashitem_T	*ht_array;	/* points to the array, allocated when it's
1123 				   not "ht_smallarray" */
1124     hashitem_T	ht_smallarray[HT_INIT_SIZE];   /* initial array */
1125 } hashtab_T;
1126 
1127 typedef long_u hash_T;		/* Type for hi_hash */
1128 
1129 
1130 #ifdef FEAT_NUM64
1131 /* Use 64-bit Number. */
1132 # ifdef WIN3264
1133 #  ifdef PROTO
1134 typedef long		    varnumber_T;
1135 typedef unsigned long	    uvarnumber_T;
1136 #  else
1137 typedef __int64		    varnumber_T;
1138 typedef unsigned __int64    uvarnumber_T;
1139 #  endif
1140 # elif defined(HAVE_STDINT_H)
1141 typedef int64_t		    varnumber_T;
1142 typedef uint64_t	    uvarnumber_T;
1143 # else
1144 typedef long		    varnumber_T;
1145 typedef unsigned long	    uvarnumber_T;
1146 # endif
1147 #else
1148 /* Use 32-bit Number. */
1149 # if VIM_SIZEOF_INT <= 3	/* use long if int is smaller than 32 bits */
1150 typedef long		    varnumber_T;
1151 typedef unsigned long	    uvarnumber_T;
1152 # else
1153 typedef int		    varnumber_T;
1154 typedef unsigned int	    uvarnumber_T;
1155 # endif
1156 #endif
1157 
1158 typedef double	float_T;
1159 
1160 typedef struct listvar_S list_T;
1161 typedef struct dictvar_S dict_T;
1162 typedef struct partial_S partial_T;
1163 
1164 typedef struct jobvar_S job_T;
1165 typedef struct readq_S readq_T;
1166 typedef struct jsonq_S jsonq_T;
1167 typedef struct cbq_S cbq_T;
1168 typedef struct channel_S channel_T;
1169 
1170 typedef enum
1171 {
1172     VAR_UNKNOWN = 0,
1173     VAR_NUMBER,	 /* "v_number" is used */
1174     VAR_STRING,	 /* "v_string" is used */
1175     VAR_FUNC,	 /* "v_string" is function name */
1176     VAR_PARTIAL, /* "v_partial" is used */
1177     VAR_LIST,	 /* "v_list" is used */
1178     VAR_DICT,	 /* "v_dict" is used */
1179     VAR_FLOAT,	 /* "v_float" is used */
1180     VAR_SPECIAL, /* "v_number" is used */
1181     VAR_JOB,	 /* "v_job" is used */
1182     VAR_CHANNEL	 /* "v_channel" is used */
1183 } vartype_T;
1184 
1185 /*
1186  * Structure to hold an internal variable without a name.
1187  */
1188 typedef struct
1189 {
1190     vartype_T	v_type;
1191     char	v_lock;	    /* see below: VAR_LOCKED, VAR_FIXED */
1192     union
1193     {
1194 	varnumber_T	v_number;	/* number value */
1195 #ifdef FEAT_FLOAT
1196 	float_T		v_float;	/* floating number value */
1197 #endif
1198 	char_u		*v_string;	/* string value (can be NULL!) */
1199 	list_T		*v_list;	/* list value (can be NULL!) */
1200 	dict_T		*v_dict;	/* dict value (can be NULL!) */
1201 	partial_T	*v_partial;	/* closure: function with args */
1202 #ifdef FEAT_JOB_CHANNEL
1203 	job_T		*v_job;		/* job value (can be NULL!) */
1204 	channel_T	*v_channel;	/* channel value (can be NULL!) */
1205 #endif
1206     }		vval;
1207 } typval_T;
1208 
1209 /* Values for "dv_scope". */
1210 #define VAR_SCOPE     1	/* a:, v:, s:, etc. scope dictionaries */
1211 #define VAR_DEF_SCOPE 2	/* l:, g: scope dictionaries: here funcrefs are not
1212 			   allowed to mask existing functions */
1213 
1214 /* Values for "v_lock". */
1215 #define VAR_LOCKED  1	/* locked with lock(), can use unlock() */
1216 #define VAR_FIXED   2	/* locked forever */
1217 
1218 /*
1219  * Structure to hold an item of a list: an internal variable without a name.
1220  */
1221 typedef struct listitem_S listitem_T;
1222 
1223 struct listitem_S
1224 {
1225     listitem_T	*li_next;	/* next item in list */
1226     listitem_T	*li_prev;	/* previous item in list */
1227     typval_T	li_tv;		/* type and value of the variable */
1228 };
1229 
1230 /*
1231  * Struct used by those that are using an item in a list.
1232  */
1233 typedef struct listwatch_S listwatch_T;
1234 
1235 struct listwatch_S
1236 {
1237     listitem_T		*lw_item;	/* item being watched */
1238     listwatch_T		*lw_next;	/* next watcher */
1239 };
1240 
1241 /*
1242  * Structure to hold info about a list.
1243  */
1244 struct listvar_S
1245 {
1246     listitem_T	*lv_first;	/* first item, NULL if none */
1247     listitem_T	*lv_last;	/* last item, NULL if none */
1248     int		lv_refcount;	/* reference count */
1249     int		lv_len;		/* number of items */
1250     listwatch_T	*lv_watch;	/* first watcher, NULL if none */
1251     int		lv_idx;		/* cached index of an item */
1252     listitem_T	*lv_idx_item;	/* when not NULL item at index "lv_idx" */
1253     int		lv_copyID;	/* ID used by deepcopy() */
1254     list_T	*lv_copylist;	/* copied list used by deepcopy() */
1255     char	lv_lock;	/* zero, VAR_LOCKED, VAR_FIXED */
1256     list_T	*lv_used_next;	/* next list in used lists list */
1257     list_T	*lv_used_prev;	/* previous list in used lists list */
1258 };
1259 
1260 /*
1261  * Static list with 10 items.  Use init_static_list() to initialize.
1262  */
1263 typedef struct {
1264     list_T	sl_list;	/* must be first */
1265     listitem_T	sl_items[10];
1266 } staticList10_T;
1267 
1268 /*
1269  * Structure to hold an item of a Dictionary.
1270  * Also used for a variable.
1271  * The key is copied into "di_key" to avoid an extra alloc/free for it.
1272  */
1273 struct dictitem_S
1274 {
1275     typval_T	di_tv;		/* type and value of the variable */
1276     char_u	di_flags;	/* flags (only used for variable) */
1277     char_u	di_key[1];	/* key (actually longer!) */
1278 };
1279 typedef struct dictitem_S dictitem_T;
1280 
1281 /* A dictitem with a 16 character key (plus NUL). */
1282 struct dictitem16_S
1283 {
1284     typval_T	di_tv;		/* type and value of the variable */
1285     char_u	di_flags;	/* flags (only used for variable) */
1286     char_u	di_key[17];	/* key */
1287 };
1288 typedef struct dictitem16_S dictitem16_T;
1289 
1290 #define DI_FLAGS_RO	1  /* "di_flags" value: read-only variable */
1291 #define DI_FLAGS_RO_SBX 2  /* "di_flags" value: read-only in the sandbox */
1292 #define DI_FLAGS_FIX	4  /* "di_flags" value: fixed: no :unlet or remove() */
1293 #define DI_FLAGS_LOCK	8  /* "di_flags" value: locked variable */
1294 #define DI_FLAGS_ALLOC	16 /* "di_flags" value: separately allocated */
1295 
1296 /*
1297  * Structure to hold info about a Dictionary.
1298  */
1299 struct dictvar_S
1300 {
1301     char	dv_lock;	/* zero, VAR_LOCKED, VAR_FIXED */
1302     char	dv_scope;	/* zero, VAR_SCOPE, VAR_DEF_SCOPE */
1303     int		dv_refcount;	/* reference count */
1304     int		dv_copyID;	/* ID used by deepcopy() */
1305     hashtab_T	dv_hashtab;	/* hashtab that refers to the items */
1306     dict_T	*dv_copydict;	/* copied dict used by deepcopy() */
1307     dict_T	*dv_used_next;	/* next dict in used dicts list */
1308     dict_T	*dv_used_prev;	/* previous dict in used dicts list */
1309 };
1310 
1311 #if defined(FEAT_EVAL) || defined(PROTO)
1312 typedef struct funccall_S funccall_T;
1313 
1314 /*
1315  * Structure to hold info for a user function.
1316  */
1317 typedef struct
1318 {
1319     int		uf_varargs;	/* variable nr of arguments */
1320     int		uf_flags;
1321     int		uf_calls;	/* nr of active calls */
1322     garray_T	uf_args;	/* arguments */
1323     garray_T	uf_lines;	/* function lines */
1324 #ifdef FEAT_PROFILE
1325     int		uf_profiling;	/* TRUE when func is being profiled */
1326     /* profiling the function as a whole */
1327     int		uf_tm_count;	/* nr of calls */
1328     proftime_T	uf_tm_total;	/* time spent in function + children */
1329     proftime_T	uf_tm_self;	/* time spent in function itself */
1330     proftime_T	uf_tm_children;	/* time spent in children this call */
1331     /* profiling the function per line */
1332     int		*uf_tml_count;	/* nr of times line was executed */
1333     proftime_T	*uf_tml_total;	/* time spent in a line + children */
1334     proftime_T	*uf_tml_self;	/* time spent in a line itself */
1335     proftime_T	uf_tml_start;	/* start time for current line */
1336     proftime_T	uf_tml_children; /* time spent in children for this line */
1337     proftime_T	uf_tml_wait;	/* start wait time for current line */
1338     int		uf_tml_idx;	/* index of line being timed; -1 if none */
1339     int		uf_tml_execed;	/* line being timed was executed */
1340 #endif
1341     scid_T	uf_script_ID;	/* ID of script where function was defined,
1342 				   used for s: variables */
1343     int		uf_refcount;	/* reference count, see func_name_refcount() */
1344     funccall_T	*uf_scoped;	/* l: local variables for closure */
1345     char_u	uf_name[1];	/* name of function (actually longer); can
1346 				   start with <SNR>123_ (<SNR> is K_SPECIAL
1347 				   KS_EXTRA KE_SNR) */
1348 } ufunc_T;
1349 
1350 #define MAX_FUNC_ARGS	20	/* maximum number of function arguments */
1351 #define VAR_SHORT_LEN	20	/* short variable name length */
1352 #define FIXVAR_CNT	12	/* number of fixed variables */
1353 
1354 /* structure to hold info for a function that is currently being executed. */
1355 struct funccall_S
1356 {
1357     ufunc_T	*func;		/* function being called */
1358     int		linenr;		/* next line to be executed */
1359     int		returned;	/* ":return" used */
1360     struct			/* fixed variables for arguments */
1361     {
1362 	dictitem_T	var;		/* variable (without room for name) */
1363 	char_u	room[VAR_SHORT_LEN];	/* room for the name */
1364     } fixvar[FIXVAR_CNT];
1365     dict_T	l_vars;		/* l: local function variables */
1366     dictitem_T	l_vars_var;	/* variable for l: scope */
1367     dict_T	l_avars;	/* a: argument variables */
1368     dictitem_T	l_avars_var;	/* variable for a: scope */
1369     list_T	l_varlist;	/* list for a:000 */
1370     listitem_T	l_listitems[MAX_FUNC_ARGS];	/* listitems for a:000 */
1371     typval_T	*rettv;		/* return value */
1372     linenr_T	breakpoint;	/* next line with breakpoint or zero */
1373     int		dbg_tick;	/* debug_tick when breakpoint was set */
1374     int		level;		/* top nesting level of executed function */
1375 #ifdef FEAT_PROFILE
1376     proftime_T	prof_child;	/* time spent in a child */
1377 #endif
1378     funccall_T	*caller;	/* calling function or NULL */
1379 
1380     /* for closure */
1381     int		fc_refcount;	/* number of user functions that reference this
1382 				 * funccal */
1383     int		fc_copyID;	/* for garbage collection */
1384     garray_T	fc_funcs;	/* list of ufunc_T* which keep a reference to
1385 				 * "func" */
1386 };
1387 
1388 /*
1389  * Struct used by trans_function_name()
1390  */
1391 typedef struct
1392 {
1393     dict_T	*fd_dict;	/* Dictionary used */
1394     char_u	*fd_newkey;	/* new key in "dict" in allocated memory */
1395     dictitem_T	*fd_di;		/* Dictionary item used */
1396 } funcdict_T;
1397 
1398 #else
1399 /* dummy typedefs for function prototypes */
1400 typedef struct
1401 {
1402     int	    dummy;
1403 } ufunc_T;
1404 typedef struct
1405 {
1406     int	    dummy;
1407 } funcdict_T;
1408 #endif
1409 
1410 struct partial_S
1411 {
1412     int		pt_refcount;	/* reference count */
1413     char_u	*pt_name;	/* function name; when NULL use
1414 				 * pt_func->uf_name */
1415     ufunc_T	*pt_func;	/* function pointer; when NULL lookup function
1416 				 * with pt_name */
1417     int		pt_auto;	/* when TRUE the partial was created for using
1418 				   dict.member in handle_subscript() */
1419     int		pt_argc;	/* number of arguments */
1420     typval_T	*pt_argv;	/* arguments in allocated array */
1421     dict_T	*pt_dict;	/* dict for "self" */
1422 };
1423 
1424 /* Status of a job.  Order matters! */
1425 typedef enum
1426 {
1427     JOB_FAILED,
1428     JOB_STARTED,
1429     JOB_ENDED,	    /* detected job done */
1430     JOB_FINISHED    /* job done and cleanup done */
1431 } jobstatus_T;
1432 
1433 /*
1434  * Structure to hold info about a Job.
1435  */
1436 struct jobvar_S
1437 {
1438     job_T	*jv_next;
1439     job_T	*jv_prev;
1440 #ifdef UNIX
1441     pid_t	jv_pid;
1442 #endif
1443 #ifdef WIN32
1444     PROCESS_INFORMATION	jv_proc_info;
1445     HANDLE		jv_job_object;
1446 #endif
1447     jobstatus_T	jv_status;
1448     char_u	*jv_stoponexit; /* allocated */
1449     int		jv_exitval;
1450     char_u	*jv_exit_cb;	/* allocated */
1451     partial_T	*jv_exit_partial;
1452 
1453     buf_T	*jv_in_buf;	/* buffer from "in-name" */
1454 
1455     int		jv_refcount;	/* reference count */
1456     int		jv_copyID;
1457 
1458     channel_T	*jv_channel;	/* channel for I/O, reference counted */
1459 };
1460 
1461 /*
1462  * Structures to hold info about a Channel.
1463  */
1464 struct readq_S
1465 {
1466     char_u	*rq_buffer;
1467     long_u	rq_buflen;
1468     readq_T	*rq_next;
1469     readq_T	*rq_prev;
1470 };
1471 
1472 struct jsonq_S
1473 {
1474     typval_T	*jq_value;
1475     jsonq_T	*jq_next;
1476     jsonq_T	*jq_prev;
1477     int		jq_no_callback; /* TRUE when no callback was found */
1478 };
1479 
1480 struct cbq_S
1481 {
1482     char_u	*cq_callback;
1483     partial_T	*cq_partial;
1484     int		cq_seq_nr;
1485     cbq_T	*cq_next;
1486     cbq_T	*cq_prev;
1487 };
1488 
1489 /* mode for a channel */
1490 typedef enum
1491 {
1492     MODE_NL = 0,
1493     MODE_RAW,
1494     MODE_JSON,
1495     MODE_JS
1496 } ch_mode_T;
1497 
1498 typedef enum {
1499     JIO_PIPE,	    /* default */
1500     JIO_NULL,
1501     JIO_FILE,
1502     JIO_BUFFER,
1503     JIO_OUT
1504 } job_io_T;
1505 
1506 /* Ordering matters, it is used in for loops: IN is last, only SOCK/OUT/ERR
1507  * are polled. */
1508 typedef enum {
1509     PART_SOCK = 0,
1510 #define CH_SOCK_FD	ch_part[PART_SOCK].ch_fd
1511 #ifdef FEAT_JOB_CHANNEL
1512     PART_OUT,
1513 # define CH_OUT_FD	ch_part[PART_OUT].ch_fd
1514     PART_ERR,
1515 # define CH_ERR_FD	ch_part[PART_ERR].ch_fd
1516     PART_IN,
1517 # define CH_IN_FD	ch_part[PART_IN].ch_fd
1518 #endif
1519     PART_COUNT
1520 } ch_part_T;
1521 
1522 #define INVALID_FD	(-1)
1523 
1524 /* The per-fd info for a channel. */
1525 typedef struct {
1526     sock_T	ch_fd;	    /* socket/stdin/stdout/stderr, -1 if not used */
1527 
1528 # if defined(UNIX) && !defined(HAVE_SELECT)
1529     int		ch_poll_idx;	/* used by channel_poll_setup() */
1530 # endif
1531 
1532 #ifdef FEAT_GUI_X11
1533     XtInputId	ch_inputHandler; /* Cookie for input */
1534 #endif
1535 #ifdef FEAT_GUI_GTK
1536     gint	ch_inputHandler; /* Cookie for input */
1537 #endif
1538 
1539     ch_mode_T	ch_mode;
1540     job_io_T	ch_io;
1541     int		ch_timeout;	/* request timeout in msec */
1542 
1543     readq_T	ch_head;	/* header for circular raw read queue */
1544     jsonq_T	ch_json_head;	/* header for circular json read queue */
1545     int		ch_block_id;	/* ID that channel_read_json_block() is
1546 				   waiting for */
1547     /* When ch_waiting is TRUE use ch_deadline to wait for incomplete message
1548      * to be complete. */
1549     int		ch_waiting;
1550 #ifdef WIN32
1551     DWORD	ch_deadline;
1552 #else
1553     struct timeval ch_deadline;
1554 #endif
1555     int		ch_block_write;	/* for testing: 0 when not used, -1 when write
1556 				 * does not block, 1 simulate blocking */
1557 
1558     cbq_T	ch_cb_head;	/* dummy node for per-request callbacks */
1559     char_u	*ch_callback;	/* call when a msg is not handled */
1560     partial_T	*ch_partial;
1561 
1562     bufref_T	ch_bufref;	/* buffer to read from or write to */
1563     int		ch_nomodifiable; /* TRUE when buffer can be 'nomodifiable' */
1564     int		ch_nomod_error;	/* TRUE when e_modifiable was given */
1565     int		ch_buf_append;	/* write appended lines instead top-bot */
1566     linenr_T	ch_buf_top;	/* next line to send */
1567     linenr_T	ch_buf_bot;	/* last line to send */
1568 } chanpart_T;
1569 
1570 struct channel_S {
1571     channel_T	*ch_next;
1572     channel_T	*ch_prev;
1573 
1574     int		ch_id;		/* ID of the channel */
1575     int		ch_last_msg_id;	/* ID of the last message */
1576 
1577     chanpart_T	ch_part[PART_COUNT]; /* info for socket, out, err and in */
1578 
1579     char	*ch_hostname;	/* only for socket, allocated */
1580     int		ch_port;	/* only for socket */
1581 
1582     int		ch_to_be_closed; /* bitset of readable fds to be closed.
1583 				  * When all readable fds have been closed,
1584 				  * set to (1 << PART_COUNT). */
1585     int		ch_to_be_freed; /* When TRUE channel must be freed when it's
1586 				 * safe to invoke callbacks. */
1587     int		ch_error;	/* When TRUE an error was reported.  Avoids
1588 				 * giving pages full of error messages when
1589 				 * the other side has exited, only mention the
1590 				 * first error until the connection works
1591 				 * again. */
1592 
1593     void	(*ch_nb_close_cb)(void);
1594 				/* callback for Netbeans when channel is
1595 				 * closed */
1596 
1597     char_u	*ch_callback;	/* call when any msg is not handled */
1598     partial_T	*ch_partial;
1599     char_u	*ch_close_cb;	/* call when channel is closed */
1600     partial_T	*ch_close_partial;
1601     int		ch_drop_never;
1602 
1603     job_T	*ch_job;	/* Job that uses this channel; this does not
1604 				 * count as a reference to avoid a circular
1605 				 * reference, the job refers to the channel. */
1606     int		ch_job_killed;	/* TRUE when there was a job and it was killed
1607 				 * or we know it died. */
1608 
1609     int		ch_refcount;	/* reference count */
1610     int		ch_copyID;
1611 };
1612 
1613 #define JO_MODE		    0x0001	/* channel mode */
1614 #define JO_IN_MODE	    0x0002	/* stdin mode */
1615 #define JO_OUT_MODE	    0x0004	/* stdout mode */
1616 #define JO_ERR_MODE	    0x0008	/* stderr mode */
1617 #define JO_CALLBACK	    0x0010	/* channel callback */
1618 #define JO_OUT_CALLBACK	    0x0020	/* stdout callback */
1619 #define JO_ERR_CALLBACK	    0x0040	/* stderr callback */
1620 #define JO_CLOSE_CALLBACK   0x0080	/* close callback */
1621 #define JO_WAITTIME	    0x0100	/* only for ch_open() */
1622 #define JO_TIMEOUT	    0x0200	/* all timeouts */
1623 #define JO_OUT_TIMEOUT	    0x0400	/* stdout timeouts */
1624 #define JO_ERR_TIMEOUT	    0x0800	/* stderr timeouts */
1625 #define JO_PART		    0x1000	/* "part" */
1626 #define JO_ID		    0x2000	/* "id" */
1627 #define JO_STOPONEXIT	    0x4000	/* "stoponexit" */
1628 #define JO_EXIT_CB	    0x8000	/* "exit_cb" */
1629 #define JO_OUT_IO	    0x10000	/* "out_io" */
1630 #define JO_ERR_IO	    0x20000	/* "err_io" (JO_OUT_IO << 1) */
1631 #define JO_IN_IO	    0x40000	/* "in_io" (JO_OUT_IO << 2) */
1632 #define JO_OUT_NAME	    0x80000	/* "out_name" */
1633 #define JO_ERR_NAME	    0x100000	/* "err_name" (JO_OUT_NAME << 1) */
1634 #define JO_IN_NAME	    0x200000	/* "in_name" (JO_OUT_NAME << 2) */
1635 #define JO_IN_TOP	    0x400000	/* "in_top" */
1636 #define JO_IN_BOT	    0x800000	/* "in_bot" */
1637 #define JO_OUT_BUF	    0x1000000	/* "out_buf" */
1638 #define JO_ERR_BUF	    0x2000000	/* "err_buf" (JO_OUT_BUF << 1) */
1639 #define JO_IN_BUF	    0x4000000	/* "in_buf" (JO_OUT_BUF << 2) */
1640 #define JO_CHANNEL	    0x8000000	/* "channel" */
1641 #define JO_BLOCK_WRITE	    0x10000000	/* "block_write" */
1642 #define JO_OUT_MODIFIABLE   0x20000000	/* "out_modifiable" */
1643 #define JO_ERR_MODIFIABLE   0x40000000	/* "err_modifiable" (JO_OUT_ << 1) */
1644 #define JO_ALL		    0x7fffffff
1645 
1646 #define JO2_OUT_MSG	    0x0001	/* "out_msg" */
1647 #define JO2_ERR_MSG	    0x0002	/* "err_msg" (JO_OUT_ << 1) */
1648 #define JO2_ALL		    0x0003
1649 
1650 #define JO_MODE_ALL	(JO_MODE + JO_IN_MODE + JO_OUT_MODE + JO_ERR_MODE)
1651 #define JO_CB_ALL \
1652     (JO_CALLBACK + JO_OUT_CALLBACK + JO_ERR_CALLBACK + JO_CLOSE_CALLBACK)
1653 #define JO_TIMEOUT_ALL	(JO_TIMEOUT + JO_OUT_TIMEOUT + JO_ERR_TIMEOUT)
1654 
1655 /*
1656  * Options for job and channel commands.
1657  */
1658 typedef struct
1659 {
1660     int		jo_set;		/* JO_ bits for values that were set */
1661     int		jo_set2;	/* JO2_ bits for values that were set */
1662 
1663     ch_mode_T	jo_mode;
1664     ch_mode_T	jo_in_mode;
1665     ch_mode_T	jo_out_mode;
1666     ch_mode_T	jo_err_mode;
1667 
1668     job_io_T	jo_io[4];	/* PART_OUT, PART_ERR, PART_IN */
1669     char_u	jo_io_name_buf[4][NUMBUFLEN];
1670     char_u	*jo_io_name[4];	/* not allocated! */
1671     int		jo_io_buf[4];
1672     int		jo_modifiable[4];
1673     int		jo_message[4];
1674     channel_T	*jo_channel;
1675 
1676     linenr_T	jo_in_top;
1677     linenr_T	jo_in_bot;
1678 
1679     char_u	*jo_callback;	/* not allocated! */
1680     partial_T	*jo_partial;	/* not referenced! */
1681     char_u	*jo_out_cb;	/* not allocated! */
1682     partial_T	*jo_out_partial; /* not referenced! */
1683     char_u	*jo_err_cb;	/* not allocated! */
1684     partial_T	*jo_err_partial; /* not referenced! */
1685     char_u	*jo_close_cb;	/* not allocated! */
1686     partial_T	*jo_close_partial; /* not referenced! */
1687     char_u	*jo_exit_cb;	/* not allocated! */
1688     partial_T	*jo_exit_partial; /* not referenced! */
1689     int		jo_drop_never;
1690     int		jo_waittime;
1691     int		jo_timeout;
1692     int		jo_out_timeout;
1693     int		jo_err_timeout;
1694     int		jo_block_write;	/* for testing only */
1695     int		jo_part;
1696     int		jo_id;
1697     char_u	jo_soe_buf[NUMBUFLEN];
1698     char_u	*jo_stoponexit;
1699 } jobopt_T;
1700 
1701 
1702 /* structure used for explicit stack while garbage collecting hash tables */
1703 typedef struct ht_stack_S
1704 {
1705     hashtab_T		*ht;
1706     struct ht_stack_S	*prev;
1707 } ht_stack_T;
1708 
1709 /* structure used for explicit stack while garbage collecting lists */
1710 typedef struct list_stack_S
1711 {
1712     list_T		*list;
1713     struct list_stack_S	*prev;
1714 } list_stack_T;
1715 
1716 /* values for b_syn_spell: what to do with toplevel text */
1717 #define SYNSPL_DEFAULT	0	/* spell check if @Spell not defined */
1718 #define SYNSPL_TOP	1	/* spell check toplevel text */
1719 #define SYNSPL_NOTOP	2	/* don't spell check toplevel text */
1720 
1721 /* avoid #ifdefs for when b_spell is not available */
1722 #ifdef FEAT_SPELL
1723 # define B_SPELL(buf)  ((buf)->b_spell)
1724 #else
1725 # define B_SPELL(buf)  (0)
1726 #endif
1727 
1728 #ifdef FEAT_QUICKFIX
1729 typedef struct qf_info_S qf_info_T;
1730 #endif
1731 
1732 #ifdef FEAT_PROFILE
1733 /*
1734  * Used for :syntime: timing of executing a syntax pattern.
1735  */
1736 typedef struct {
1737     proftime_T	total;		/* total time used */
1738     proftime_T	slowest;	/* time of slowest call */
1739     long	count;		/* nr of times used */
1740     long	match;		/* nr of times matched */
1741 } syn_time_T;
1742 #endif
1743 
1744 #ifdef FEAT_CRYPT
1745 /*
1746  * Structure to hold the type of encryption and the state of encryption or
1747  * decryption.
1748  */
1749 typedef struct {
1750     int	    method_nr;
1751     void    *method_state;  /* method-specific state information */
1752 } cryptstate_T;
1753 
1754 /* values for method_nr */
1755 # define CRYPT_M_ZIP	0
1756 # define CRYPT_M_BF	1
1757 # define CRYPT_M_BF2	2
1758 # define CRYPT_M_COUNT	3 /* number of crypt methods */
1759 #endif
1760 
1761 
1762 /*
1763  * These are items normally related to a buffer.  But when using ":ownsyntax"
1764  * a window may have its own instance.
1765  */
1766 typedef struct {
1767 #ifdef FEAT_SYN_HL
1768     hashtab_T	b_keywtab;		/* syntax keywords hash table */
1769     hashtab_T	b_keywtab_ic;		/* idem, ignore case */
1770     int		b_syn_error;		/* TRUE when error occurred in HL */
1771     int		b_syn_ic;		/* ignore case for :syn cmds */
1772     int		b_syn_spell;		/* SYNSPL_ values */
1773     garray_T	b_syn_patterns;		/* table for syntax patterns */
1774     garray_T	b_syn_clusters;		/* table for syntax clusters */
1775     int		b_spell_cluster_id;	/* @Spell cluster ID or 0 */
1776     int		b_nospell_cluster_id;	/* @NoSpell cluster ID or 0 */
1777     int		b_syn_containedin;	/* TRUE when there is an item with a
1778 					   "containedin" argument */
1779     int		b_syn_sync_flags;	/* flags about how to sync */
1780     short	b_syn_sync_id;		/* group to sync on */
1781     long	b_syn_sync_minlines;	/* minimal sync lines offset */
1782     long	b_syn_sync_maxlines;	/* maximal sync lines offset */
1783     long	b_syn_sync_linebreaks;	/* offset for multi-line pattern */
1784     char_u	*b_syn_linecont_pat;	/* line continuation pattern */
1785     regprog_T	*b_syn_linecont_prog;	/* line continuation program */
1786 #ifdef FEAT_PROFILE
1787     syn_time_T  b_syn_linecont_time;
1788 #endif
1789     int		b_syn_linecont_ic;	/* ignore-case flag for above */
1790     int		b_syn_topgrp;		/* for ":syntax include" */
1791 # ifdef FEAT_CONCEAL
1792     int		b_syn_conceal;		/* auto-conceal for :syn cmds */
1793 # endif
1794 # ifdef FEAT_FOLDING
1795     int		b_syn_folditems;	/* number of patterns with the HL_FOLD
1796 					   flag set */
1797 # endif
1798     /*
1799      * b_sst_array[] contains the state stack for a number of lines, for the
1800      * start of that line (col == 0).  This avoids having to recompute the
1801      * syntax state too often.
1802      * b_sst_array[] is allocated to hold the state for all displayed lines,
1803      * and states for 1 out of about 20 other lines.
1804      * b_sst_array	pointer to an array of synstate_T
1805      * b_sst_len	number of entries in b_sst_array[]
1806      * b_sst_first	pointer to first used entry in b_sst_array[] or NULL
1807      * b_sst_firstfree	pointer to first free entry in b_sst_array[] or NULL
1808      * b_sst_freecount	number of free entries in b_sst_array[]
1809      * b_sst_check_lnum	entries after this lnum need to be checked for
1810      *			validity (MAXLNUM means no check needed)
1811      */
1812     synstate_T	*b_sst_array;
1813     int		b_sst_len;
1814     synstate_T	*b_sst_first;
1815     synstate_T	*b_sst_firstfree;
1816     int		b_sst_freecount;
1817     linenr_T	b_sst_check_lnum;
1818     short_u	b_sst_lasttick;	/* last display tick */
1819 #endif /* FEAT_SYN_HL */
1820 
1821 #ifdef FEAT_SPELL
1822     /* for spell checking */
1823     garray_T	b_langp;	/* list of pointers to slang_T, see spell.c */
1824     char_u	b_spell_ismw[256];/* flags: is midword char */
1825 # ifdef FEAT_MBYTE
1826     char_u	*b_spell_ismw_mb; /* multi-byte midword chars */
1827 # endif
1828     char_u	*b_p_spc;	/* 'spellcapcheck' */
1829     regprog_T	*b_cap_prog;	/* program for 'spellcapcheck' */
1830     char_u	*b_p_spf;	/* 'spellfile' */
1831     char_u	*b_p_spl;	/* 'spelllang' */
1832 # ifdef FEAT_MBYTE
1833     int		b_cjk;		/* all CJK letters as OK */
1834 # endif
1835 #endif
1836 #if !defined(FEAT_SYN_HL) && !defined(FEAT_SPELL)
1837     int		dummy;
1838 #endif
1839     char_u	b_syn_chartab[32];	/* syntax iskeyword option */
1840     char_u	*b_syn_isk;		/* iskeyword option */
1841 } synblock_T;
1842 
1843 
1844 /*
1845  * buffer: structure that holds information about one file
1846  *
1847  * Several windows can share a single Buffer
1848  * A buffer is unallocated if there is no memfile for it.
1849  * A buffer is new if the associated file has never been loaded yet.
1850  */
1851 
1852 struct file_buffer
1853 {
1854     memline_T	b_ml;		/* associated memline (also contains line
1855 				   count) */
1856 
1857     buf_T	*b_next;	/* links in list of buffers */
1858     buf_T	*b_prev;
1859 
1860     int		b_nwindows;	/* nr of windows open on this buffer */
1861 
1862     int		b_flags;	/* various BF_ flags */
1863 #ifdef FEAT_AUTOCMD
1864     int		b_locked;	/* Buffer is being closed or referenced, don't
1865 				   let autocommands wipe it out. */
1866 #endif
1867 
1868     /*
1869      * b_ffname has the full path of the file (NULL for no name).
1870      * b_sfname is the name as the user typed it (or NULL).
1871      * b_fname is the same as b_sfname, unless ":cd" has been done,
1872      *		then it is the same as b_ffname (NULL for no name).
1873      */
1874     char_u	*b_ffname;	/* full path file name */
1875     char_u	*b_sfname;	/* short file name */
1876     char_u	*b_fname;	/* current file name */
1877 
1878 #ifdef UNIX
1879     int		b_dev_valid;	/* TRUE when b_dev has a valid number */
1880     dev_t	b_dev;		/* device number */
1881     ino_t	b_ino;		/* inode number */
1882 #endif
1883 #ifdef FEAT_CW_EDITOR
1884     FSSpec	b_FSSpec;	/* MacOS File Identification */
1885 #endif
1886 #ifdef VMS
1887     char	 b_fab_rfm;	/* Record format    */
1888     char	 b_fab_rat;	/* Record attribute */
1889     unsigned int b_fab_mrs;	/* Max record size  */
1890 #endif
1891     int		b_fnum;		/* buffer number for this file. */
1892     char_u	b_key[VIM_SIZEOF_INT * 2 + 1];
1893 				/* key used for buf_hashtab, holds b_fnum as
1894 				   hex string */
1895 
1896     int		b_changed;	/* 'modified': Set to TRUE if something in the
1897 				   file has been changed and not written out. */
1898     int		b_changedtick;	/* incremented for each change, also for undo */
1899 
1900     int		b_saving;	/* Set to TRUE if we are in the middle of
1901 				   saving the buffer. */
1902 
1903     /*
1904      * Changes to a buffer require updating of the display.  To minimize the
1905      * work, remember changes made and update everything at once.
1906      */
1907     int		b_mod_set;	/* TRUE when there are changes since the last
1908 				   time the display was updated */
1909     linenr_T	b_mod_top;	/* topmost lnum that was changed */
1910     linenr_T	b_mod_bot;	/* lnum below last changed line, AFTER the
1911 				   change */
1912     long	b_mod_xlines;	/* number of extra buffer lines inserted;
1913 				   negative when lines were deleted */
1914 
1915     wininfo_T	*b_wininfo;	/* list of last used info for each window */
1916 
1917     long	b_mtime;	/* last change time of original file */
1918     long	b_mtime_read;	/* last change time when reading */
1919     off_T	b_orig_size;	/* size of original file in bytes */
1920     int		b_orig_mode;	/* mode of original file */
1921 #ifdef FEAT_VIMINFO
1922     time_T	b_last_used;	/* time when the buffer was last used; used
1923 				 * for viminfo */
1924 #endif
1925 
1926     pos_T	b_namedm[NMARKS]; /* current named marks (mark.c) */
1927 
1928     /* These variables are set when VIsual_active becomes FALSE */
1929     visualinfo_T b_visual;
1930 #ifdef FEAT_EVAL
1931     int		b_visual_mode_eval;  /* b_visual.vi_mode for visualmode() */
1932 #endif
1933 
1934     pos_T	b_last_cursor;	/* cursor position when last unloading this
1935 				   buffer */
1936     pos_T	b_last_insert;	/* where Insert mode was left */
1937     pos_T	b_last_change;	/* position of last change: '. mark */
1938 
1939 #ifdef FEAT_JUMPLIST
1940     /*
1941      * the changelist contains old change positions
1942      */
1943     pos_T	b_changelist[JUMPLISTSIZE];
1944     int		b_changelistlen;	/* number of active entries */
1945     int		b_new_change;		/* set by u_savecommon() */
1946 #endif
1947 
1948     /*
1949      * Character table, only used in charset.c for 'iskeyword'
1950      * 32 bytes of 8 bits: 1 bit per character 0-255.
1951      */
1952     char_u	b_chartab[32];
1953 
1954 #ifdef FEAT_LOCALMAP
1955     /* Table used for mappings local to a buffer. */
1956     mapblock_T	*(b_maphash[256]);
1957 
1958     /* First abbreviation local to a buffer. */
1959     mapblock_T	*b_first_abbr;
1960 #endif
1961 #ifdef FEAT_USR_CMDS
1962     /* User commands local to the buffer. */
1963     garray_T	b_ucmds;
1964 #endif
1965     /*
1966      * start and end of an operator, also used for '[ and ']
1967      */
1968     pos_T	b_op_start;
1969     pos_T	b_op_start_orig;  /* used for Insstart_orig */
1970     pos_T	b_op_end;
1971 
1972 #ifdef FEAT_VIMINFO
1973     int		b_marks_read;	/* Have we read viminfo marks yet? */
1974 #endif
1975 
1976     /*
1977      * The following only used in undo.c.
1978      */
1979     u_header_T	*b_u_oldhead;	/* pointer to oldest header */
1980     u_header_T	*b_u_newhead;	/* pointer to newest header; may not be valid
1981 				   if b_u_curhead is not NULL */
1982     u_header_T	*b_u_curhead;	/* pointer to current header */
1983     int		b_u_numhead;	/* current number of headers */
1984     int		b_u_synced;	/* entry lists are synced */
1985     long	b_u_seq_last;	/* last used undo sequence number */
1986     long	b_u_save_nr_last; /* counter for last file write */
1987     long	b_u_seq_cur;	/* hu_seq of header below which we are now */
1988     time_T	b_u_time_cur;	/* uh_time of header below which we are now */
1989     long	b_u_save_nr_cur; /* file write nr after which we are now */
1990 
1991     /*
1992      * variables for "U" command in undo.c
1993      */
1994     char_u	*b_u_line_ptr;	/* saved line for "U" command */
1995     linenr_T	b_u_line_lnum;	/* line number of line in u_line */
1996     colnr_T	b_u_line_colnr;	/* optional column number */
1997 
1998 #ifdef FEAT_INS_EXPAND
1999     int		b_scanned;	/* ^N/^P have scanned this buffer */
2000 #endif
2001 
2002     /* flags for use of ":lmap" and IM control */
2003     long	b_p_iminsert;	/* input mode for insert */
2004     long	b_p_imsearch;	/* input mode for search */
2005 #define B_IMODE_USE_INSERT -1	/*	Use b_p_iminsert value for search */
2006 #define B_IMODE_NONE 0		/*	Input via none */
2007 #define B_IMODE_LMAP 1		/*	Input via langmap */
2008 #ifndef USE_IM_CONTROL
2009 # define B_IMODE_LAST 1
2010 #else
2011 # define B_IMODE_IM 2		/*	Input via input method */
2012 # define B_IMODE_LAST 2
2013 #endif
2014 
2015 #ifdef FEAT_KEYMAP
2016     short	b_kmap_state;	/* using "lmap" mappings */
2017 # define KEYMAP_INIT	1	/* 'keymap' was set, call keymap_init() */
2018 # define KEYMAP_LOADED	2	/* 'keymap' mappings have been loaded */
2019     garray_T	b_kmap_ga;	/* the keymap table */
2020 #endif
2021 
2022     /*
2023      * Options local to a buffer.
2024      * They are here because their value depends on the type of file
2025      * or contents of the file being edited.
2026      */
2027     int		b_p_initialized;	/* set when options initialized */
2028 
2029 #ifdef FEAT_EVAL
2030     int		b_p_scriptID[BV_COUNT];	/* SIDs for buffer-local options */
2031 #endif
2032 
2033     int		b_p_ai;		/* 'autoindent' */
2034     int		b_p_ai_nopaste;	/* b_p_ai saved for paste mode */
2035     char_u	*b_p_bkc;	/* 'backupcopy' */
2036     unsigned	b_bkc_flags;    /* flags for 'backupcopy' */
2037     int		b_p_ci;		/* 'copyindent' */
2038     int		b_p_bin;	/* 'binary' */
2039 #ifdef FEAT_MBYTE
2040     int		b_p_bomb;	/* 'bomb' */
2041 #endif
2042 #ifdef FEAT_QUICKFIX
2043     char_u	*b_p_bh;	/* 'bufhidden' */
2044     char_u	*b_p_bt;	/* 'buftype' */
2045 #define BUF_HAS_QF_ENTRY 1
2046 #define BUF_HAS_LL_ENTRY 2
2047     int		b_has_qf_entry;
2048 #endif
2049     int		b_p_bl;		/* 'buflisted' */
2050 #ifdef FEAT_CINDENT
2051     int		b_p_cin;	/* 'cindent' */
2052     char_u	*b_p_cino;	/* 'cinoptions' */
2053     char_u	*b_p_cink;	/* 'cinkeys' */
2054 #endif
2055 #if defined(FEAT_CINDENT) || defined(FEAT_SMARTINDENT)
2056     char_u	*b_p_cinw;	/* 'cinwords' */
2057 #endif
2058 #ifdef FEAT_COMMENTS
2059     char_u	*b_p_com;	/* 'comments' */
2060 #endif
2061 #ifdef FEAT_FOLDING
2062     char_u	*b_p_cms;	/* 'commentstring' */
2063 #endif
2064 #ifdef FEAT_INS_EXPAND
2065     char_u	*b_p_cpt;	/* 'complete' */
2066 #endif
2067 #ifdef FEAT_COMPL_FUNC
2068     char_u	*b_p_cfu;	/* 'completefunc' */
2069     char_u	*b_p_ofu;	/* 'omnifunc' */
2070 #endif
2071     int		b_p_eol;	/* 'endofline' */
2072     int		b_p_fixeol;	/* 'fixendofline' */
2073     int		b_p_et;		/* 'expandtab' */
2074     int		b_p_et_nobin;	/* b_p_et saved for binary mode */
2075     int	        b_p_et_nopaste; /* b_p_et saved for paste mode */
2076 #ifdef FEAT_MBYTE
2077     char_u	*b_p_fenc;	/* 'fileencoding' */
2078 #endif
2079     char_u	*b_p_ff;	/* 'fileformat' */
2080 #ifdef FEAT_AUTOCMD
2081     char_u	*b_p_ft;	/* 'filetype' */
2082 #endif
2083     char_u	*b_p_fo;	/* 'formatoptions' */
2084     char_u	*b_p_flp;	/* 'formatlistpat' */
2085     int		b_p_inf;	/* 'infercase' */
2086     char_u	*b_p_isk;	/* 'iskeyword' */
2087 #ifdef FEAT_FIND_ID
2088     char_u	*b_p_def;	/* 'define' local value */
2089     char_u	*b_p_inc;	/* 'include' */
2090 # ifdef FEAT_EVAL
2091     char_u	*b_p_inex;	/* 'includeexpr' */
2092     long_u	b_p_inex_flags;	/* flags for 'includeexpr' */
2093 # endif
2094 #endif
2095 #if defined(FEAT_CINDENT) && defined(FEAT_EVAL)
2096     char_u	*b_p_inde;	/* 'indentexpr' */
2097     long_u	b_p_inde_flags;	/* flags for 'indentexpr' */
2098     char_u	*b_p_indk;	/* 'indentkeys' */
2099 #endif
2100 #if defined(FEAT_EVAL)
2101     char_u	*b_p_fex;	/* 'formatexpr' */
2102     long_u	b_p_fex_flags;	/* flags for 'formatexpr' */
2103 #endif
2104 #ifdef FEAT_CRYPT
2105     char_u	*b_p_key;	/* 'key' */
2106 #endif
2107     char_u	*b_p_kp;	/* 'keywordprg' */
2108 #ifdef FEAT_LISP
2109     int		b_p_lisp;	/* 'lisp' */
2110 #endif
2111     char_u	*b_p_mps;	/* 'matchpairs' */
2112     int		b_p_ml;		/* 'modeline' */
2113     int		b_p_ml_nobin;	/* b_p_ml saved for binary mode */
2114     int		b_p_ma;		/* 'modifiable' */
2115     char_u	*b_p_nf;	/* 'nrformats' */
2116     int		b_p_pi;		/* 'preserveindent' */
2117 #ifdef FEAT_TEXTOBJ
2118     char_u	*b_p_qe;	/* 'quoteescape' */
2119 #endif
2120     int		b_p_ro;		/* 'readonly' */
2121     long	b_p_sw;		/* 'shiftwidth' */
2122     int		b_p_sn;		/* 'shortname' */
2123 #ifdef FEAT_SMARTINDENT
2124     int		b_p_si;		/* 'smartindent' */
2125 #endif
2126     long	b_p_sts;	/* 'softtabstop' */
2127     long	b_p_sts_nopaste; /* b_p_sts saved for paste mode */
2128 #ifdef FEAT_SEARCHPATH
2129     char_u	*b_p_sua;	/* 'suffixesadd' */
2130 #endif
2131     int		b_p_swf;	/* 'swapfile' */
2132 #ifdef FEAT_SYN_HL
2133     long	b_p_smc;	/* 'synmaxcol' */
2134     char_u	*b_p_syn;	/* 'syntax' */
2135 #endif
2136     long	b_p_ts;		/* 'tabstop' */
2137     int		b_p_tx;		/* 'textmode' */
2138     long	b_p_tw;		/* 'textwidth' */
2139     long	b_p_tw_nobin;	/* b_p_tw saved for binary mode */
2140     long	b_p_tw_nopaste;	/* b_p_tw saved for paste mode */
2141     long	b_p_wm;		/* 'wrapmargin' */
2142     long	b_p_wm_nobin;	/* b_p_wm saved for binary mode */
2143     long	b_p_wm_nopaste;	/* b_p_wm saved for paste mode */
2144 #ifdef FEAT_KEYMAP
2145     char_u	*b_p_keymap;	/* 'keymap' */
2146 #endif
2147 
2148     /* local values for options which are normally global */
2149 #ifdef FEAT_QUICKFIX
2150     char_u	*b_p_gp;	/* 'grepprg' local value */
2151     char_u	*b_p_mp;	/* 'makeprg' local value */
2152     char_u	*b_p_efm;	/* 'errorformat' local value */
2153 #endif
2154     char_u	*b_p_ep;	/* 'equalprg' local value */
2155     char_u	*b_p_path;	/* 'path' local value */
2156     int		b_p_ar;		/* 'autoread' local value */
2157     char_u	*b_p_tags;	/* 'tags' local value */
2158     char_u	*b_p_tc;	/* 'tagcase' local value */
2159     unsigned	b_tc_flags;     /* flags for 'tagcase' */
2160 #ifdef FEAT_INS_EXPAND
2161     char_u	*b_p_dict;	/* 'dictionary' local value */
2162     char_u	*b_p_tsr;	/* 'thesaurus' local value */
2163 #endif
2164     long	b_p_ul;		/* 'undolevels' local value */
2165 #ifdef FEAT_PERSISTENT_UNDO
2166     int		b_p_udf;	/* 'undofile' */
2167 #endif
2168 #ifdef FEAT_LISP
2169     char_u	*b_p_lw;	/* 'lispwords' local value */
2170 #endif
2171 
2172     /* end of buffer options */
2173 
2174 #ifdef FEAT_CINDENT
2175     /* values set from b_p_cino */
2176     int		b_ind_level;
2177     int		b_ind_open_imag;
2178     int		b_ind_no_brace;
2179     int		b_ind_first_open;
2180     int		b_ind_open_extra;
2181     int		b_ind_close_extra;
2182     int		b_ind_open_left_imag;
2183     int		b_ind_jump_label;
2184     int		b_ind_case;
2185     int		b_ind_case_code;
2186     int		b_ind_case_break;
2187     int		b_ind_param;
2188     int		b_ind_func_type;
2189     int		b_ind_comment;
2190     int		b_ind_in_comment;
2191     int		b_ind_in_comment2;
2192     int		b_ind_cpp_baseclass;
2193     int		b_ind_continuation;
2194     int		b_ind_unclosed;
2195     int		b_ind_unclosed2;
2196     int		b_ind_unclosed_noignore;
2197     int		b_ind_unclosed_wrapped;
2198     int		b_ind_unclosed_whiteok;
2199     int		b_ind_matching_paren;
2200     int		b_ind_paren_prev;
2201     int		b_ind_maxparen;
2202     int		b_ind_maxcomment;
2203     int		b_ind_scopedecl;
2204     int		b_ind_scopedecl_code;
2205     int		b_ind_java;
2206     int		b_ind_js;
2207     int		b_ind_keep_case_label;
2208     int		b_ind_hash_comment;
2209     int		b_ind_cpp_namespace;
2210     int		b_ind_if_for_while;
2211 #endif
2212 
2213     linenr_T	b_no_eol_lnum;	/* non-zero lnum when last line of next binary
2214 				 * write should not have an end-of-line */
2215 
2216     int		b_start_eol;	/* last line had eol when it was read */
2217     int		b_start_ffc;	/* first char of 'ff' when edit started */
2218 #ifdef FEAT_MBYTE
2219     char_u	*b_start_fenc;	/* 'fileencoding' when edit started or NULL */
2220     int		b_bad_char;	/* "++bad=" argument when edit started or 0 */
2221     int		b_start_bomb;	/* 'bomb' when it was read */
2222 #endif
2223 
2224 #ifdef FEAT_EVAL
2225     dictitem_T	b_bufvar;	/* variable for "b:" Dictionary */
2226     dict_T	*b_vars;	/* internal variables, local to buffer */
2227 #endif
2228 
2229 #if defined(FEAT_BEVAL) && defined(FEAT_EVAL)
2230     char_u	*b_p_bexpr;	/* 'balloonexpr' local value */
2231     long_u	b_p_bexpr_flags;/* flags for 'balloonexpr' */
2232 #endif
2233 #ifdef FEAT_CRYPT
2234     char_u	*b_p_cm;	/* 'cryptmethod' */
2235 #endif
2236 
2237     /* When a buffer is created, it starts without a swap file.  b_may_swap is
2238      * then set to indicate that a swap file may be opened later.  It is reset
2239      * if a swap file could not be opened.
2240      */
2241     int		b_may_swap;
2242     int		b_did_warn;	/* Set to 1 if user has been warned on first
2243 				   change of a read-only file */
2244 
2245     /* Two special kinds of buffers:
2246      * help buffer  - used for help files, won't use a swap file.
2247      * spell buffer - used for spell info, never displayed and doesn't have a
2248      *		      file name.
2249      */
2250     int		b_help;		/* TRUE for help file buffer (when set b_p_bt
2251 				   is "help") */
2252 #ifdef FEAT_SPELL
2253     int		b_spell;	/* TRUE for a spell file buffer, most fields
2254 				   are not used!  Use the B_SPELL macro to
2255 				   access b_spell without #ifdef. */
2256 #endif
2257 
2258     int		b_shortname;	/* this file has an 8.3 file name */
2259 
2260 #ifdef FEAT_MZSCHEME
2261     void	*b_mzscheme_ref; /* The MzScheme reference to this buffer */
2262 #endif
2263 
2264 #ifdef FEAT_PERL
2265     void	*b_perl_private;
2266 #endif
2267 
2268 #ifdef FEAT_PYTHON
2269     void	*b_python_ref;	/* The Python reference to this buffer */
2270 #endif
2271 
2272 #ifdef FEAT_PYTHON3
2273     void	*b_python3_ref;	/* The Python3 reference to this buffer */
2274 #endif
2275 
2276 #ifdef FEAT_TCL
2277     void	*b_tcl_ref;
2278 #endif
2279 
2280 #ifdef FEAT_RUBY
2281     void	*b_ruby_ref;
2282 #endif
2283 
2284 #if defined(FEAT_SYN_HL) || defined(FEAT_SPELL)
2285     synblock_T	b_s;		/* Info related to syntax highlighting.  w_s
2286 				 * normally points to this, but some windows
2287 				 * may use a different synblock_T. */
2288 #endif
2289 
2290 #ifdef FEAT_SIGNS
2291     signlist_T	*b_signlist;	/* list of signs to draw */
2292 # ifdef FEAT_NETBEANS_INTG
2293     int		b_has_sign_column; /* Flag that is set when a first sign is
2294 				    * added and remains set until the end of
2295 				    * the netbeans session. */
2296 # endif
2297 #endif
2298 
2299 #ifdef FEAT_NETBEANS_INTG
2300     int		b_netbeans_file;    /* TRUE when buffer is owned by NetBeans */
2301     int		b_was_netbeans_file;/* TRUE if b_netbeans_file was once set */
2302 #endif
2303 #ifdef FEAT_JOB_CHANNEL
2304     int		b_write_to_channel; /* TRUE when appended lines are written to
2305 				     * a channel. */
2306 #endif
2307 
2308 #ifdef FEAT_CRYPT
2309     cryptstate_T *b_cryptstate;	/* Encryption state while reading or writing
2310 				 * the file. NULL when not using encryption. */
2311 #endif
2312     int		b_mapped_ctrl_c; /* modes where CTRL-C is mapped */
2313 
2314 }; /* file_buffer */
2315 
2316 
2317 #ifdef FEAT_DIFF
2318 /*
2319  * Stuff for diff mode.
2320  */
2321 # define DB_COUNT 8	/* up to eight buffers can be diff'ed */
2322 
2323 /*
2324  * Each diffblock defines where a block of lines starts in each of the buffers
2325  * and how many lines it occupies in that buffer.  When the lines are missing
2326  * in the buffer the df_count[] is zero.  This is all counted in
2327  * buffer lines.
2328  * There is always at least one unchanged line in between the diffs.
2329  * Otherwise it would have been included in the diff above or below it.
2330  * df_lnum[] + df_count[] is the lnum below the change.  When in one buffer
2331  * lines have been inserted, in the other buffer df_lnum[] is the line below
2332  * the insertion and df_count[] is zero.  When appending lines at the end of
2333  * the buffer, df_lnum[] is one beyond the end!
2334  * This is using a linked list, because the number of differences is expected
2335  * to be reasonable small.  The list is sorted on lnum.
2336  */
2337 typedef struct diffblock_S diff_T;
2338 struct diffblock_S
2339 {
2340     diff_T	*df_next;
2341     linenr_T	df_lnum[DB_COUNT];	/* line number in buffer */
2342     linenr_T	df_count[DB_COUNT];	/* nr of inserted/changed lines */
2343 };
2344 #endif
2345 
2346 #define SNAP_HELP_IDX	0
2347 #ifdef FEAT_AUTOCMD
2348 # define SNAP_AUCMD_IDX 1
2349 # define SNAP_COUNT	2
2350 #else
2351 # define SNAP_COUNT	1
2352 #endif
2353 
2354 /*
2355  * Tab pages point to the top frame of each tab page.
2356  * Note: Most values are NOT valid for the current tab page!  Use "curwin",
2357  * "firstwin", etc. for that.  "tp_topframe" is always valid and can be
2358  * compared against "topframe" to find the current tab page.
2359  */
2360 typedef struct tabpage_S tabpage_T;
2361 struct tabpage_S
2362 {
2363     tabpage_T	    *tp_next;	    /* next tabpage or NULL */
2364     frame_T	    *tp_topframe;   /* topframe for the windows */
2365     win_T	    *tp_curwin;	    /* current window in this Tab page */
2366     win_T	    *tp_prevwin;    /* previous window in this Tab page */
2367     win_T	    *tp_firstwin;   /* first window in this Tab page */
2368     win_T	    *tp_lastwin;    /* last window in this Tab page */
2369     long	    tp_old_Rows;    /* Rows when Tab page was left */
2370     long	    tp_old_Columns; /* Columns when Tab page was left */
2371     long	    tp_ch_used;	    /* value of 'cmdheight' when frame size
2372 				       was set */
2373 #ifdef FEAT_GUI
2374     int		    tp_prev_which_scrollbars[3];
2375 				    /* previous value of which_scrollbars */
2376 #endif
2377 #ifdef FEAT_DIFF
2378     diff_T	    *tp_first_diff;
2379     buf_T	    *(tp_diffbuf[DB_COUNT]);
2380     int		    tp_diff_invalid;	/* list of diffs is outdated */
2381 #endif
2382     frame_T	    *(tp_snapshot[SNAP_COUNT]);  /* window layout snapshots */
2383 #ifdef FEAT_EVAL
2384     dictitem_T	    tp_winvar;	    /* variable for "t:" Dictionary */
2385     dict_T	    *tp_vars;	    /* internal variables, local to tab page */
2386 #endif
2387 
2388 #ifdef FEAT_PYTHON
2389     void	    *tp_python_ref;	/* The Python value for this tab page */
2390 #endif
2391 
2392 #ifdef FEAT_PYTHON3
2393     void	    *tp_python3_ref;	/* The Python value for this tab page */
2394 #endif
2395 };
2396 
2397 /*
2398  * Structure to cache info for displayed lines in w_lines[].
2399  * Each logical line has one entry.
2400  * The entry tells how the logical line is currently displayed in the window.
2401  * This is updated when displaying the window.
2402  * When the display is changed (e.g., when clearing the screen) w_lines_valid
2403  * is changed to exclude invalid entries.
2404  * When making changes to the buffer, wl_valid is reset to indicate wl_size
2405  * may not reflect what is actually in the buffer.  When wl_valid is FALSE,
2406  * the entries can only be used to count the number of displayed lines used.
2407  * wl_lnum and wl_lastlnum are invalid too.
2408  */
2409 typedef struct w_line
2410 {
2411     linenr_T	wl_lnum;	/* buffer line number for logical line */
2412     short_u	wl_size;	/* height in screen lines */
2413     char	wl_valid;	/* TRUE values are valid for text in buffer */
2414 #ifdef FEAT_FOLDING
2415     char	wl_folded;	/* TRUE when this is a range of folded lines */
2416     linenr_T	wl_lastlnum;	/* last buffer line number for logical line */
2417 #endif
2418 } wline_T;
2419 
2420 /*
2421  * Windows are kept in a tree of frames.  Each frame has a column (FR_COL)
2422  * or row (FR_ROW) layout or is a leaf, which has a window.
2423  */
2424 struct frame_S
2425 {
2426     char	fr_layout;	/* FR_LEAF, FR_COL or FR_ROW */
2427 #ifdef FEAT_WINDOWS
2428     int		fr_width;
2429     int		fr_newwidth;	/* new width used in win_equal_rec() */
2430 #endif
2431     int		fr_height;
2432     int		fr_newheight;	/* new height used in win_equal_rec() */
2433     frame_T	*fr_parent;	/* containing frame or NULL */
2434     frame_T	*fr_next;	/* frame right or below in same parent, NULL
2435 				   for first */
2436     frame_T	*fr_prev;	/* frame left or above in same parent, NULL
2437 				   for last */
2438     /* fr_child and fr_win are mutually exclusive */
2439     frame_T	*fr_child;	/* first contained frame */
2440     win_T	*fr_win;	/* window that fills this frame */
2441 };
2442 
2443 #define FR_LEAF	0	/* frame is a leaf */
2444 #define FR_ROW	1	/* frame with a row of windows */
2445 #define FR_COL	2	/* frame with a column of windows */
2446 
2447 /*
2448  * Struct used for highlighting 'hlsearch' matches, matches defined by
2449  * ":match" and matches defined by match functions.
2450  * For 'hlsearch' there is one pattern for all windows.  For ":match" and the
2451  * match functions there is a different pattern for each window.
2452  */
2453 typedef struct
2454 {
2455     regmmatch_T	rm;	/* points to the regexp program; contains last found
2456 			   match (may continue in next line) */
2457     buf_T	*buf;	/* the buffer to search for a match */
2458     linenr_T	lnum;	/* the line to search for a match */
2459     int		attr;	/* attributes to be used for a match */
2460     int		attr_cur; /* attributes currently active in win_line() */
2461     linenr_T	first_lnum;	/* first lnum to search for multi-line pat */
2462     colnr_T	startcol; /* in win_line() points to char where HL starts */
2463     colnr_T	endcol;	 /* in win_line() points to char where HL ends */
2464     int		is_addpos;	/* position specified directly by
2465 				   matchaddpos(). TRUE/FALSE */
2466 #ifdef FEAT_RELTIME
2467     proftime_T	tm;	/* for a time limit */
2468 #endif
2469 } match_T;
2470 
2471 /* number of positions supported by matchaddpos() */
2472 #define MAXPOSMATCH 8
2473 
2474 /*
2475  * Same as lpos_T, but with additional field len.
2476  */
2477 typedef struct
2478 {
2479     linenr_T	lnum;	/* line number */
2480     colnr_T	col;	/* column number */
2481     int		len;	/* length: 0 - to the end of line */
2482 } llpos_T;
2483 
2484 /*
2485  * posmatch_T provides an array for storing match items for matchaddpos()
2486  * function.
2487  */
2488 typedef struct posmatch posmatch_T;
2489 struct posmatch
2490 {
2491     llpos_T	pos[MAXPOSMATCH];	/* array of positions */
2492     int		cur;			/* internal position counter */
2493     linenr_T	toplnum;		/* top buffer line */
2494     linenr_T	botlnum;		/* bottom buffer line */
2495 };
2496 
2497 /*
2498  * matchitem_T provides a linked list for storing match items for ":match" and
2499  * the match functions.
2500  */
2501 typedef struct matchitem matchitem_T;
2502 struct matchitem
2503 {
2504     matchitem_T	*next;
2505     int		id;	    /* match ID */
2506     int		priority;   /* match priority */
2507     char_u	*pattern;   /* pattern to highlight */
2508     int		hlg_id;	    /* highlight group ID */
2509     regmmatch_T	match;	    /* regexp program for pattern */
2510     posmatch_T	pos;	    /* position matches */
2511     match_T	hl;	    /* struct for doing the actual highlighting */
2512 #ifdef FEAT_CONCEAL
2513     int		conceal_char; /* cchar for Conceal highlighting */
2514 #endif
2515 };
2516 
2517 /*
2518  * Structure which contains all information that belongs to a window
2519  *
2520  * All row numbers are relative to the start of the window, except w_winrow.
2521  */
2522 struct window_S
2523 {
2524     int		w_id;		    /* unique window ID */
2525 
2526     buf_T	*w_buffer;	    /* buffer we are a window into (used
2527 				       often, keep it the first item!) */
2528 
2529 #if defined(FEAT_SYN_HL) || defined(FEAT_SPELL)
2530     synblock_T	*w_s;		    /* for :ownsyntax */
2531 #endif
2532 
2533 #ifdef FEAT_WINDOWS
2534     win_T	*w_prev;	    /* link to previous window */
2535     win_T	*w_next;	    /* link to next window */
2536 #endif
2537 #ifdef FEAT_AUTOCMD
2538     int		w_closing;	    /* window is being closed, don't let
2539 				       autocommands close it too. */
2540 #endif
2541 
2542     frame_T	*w_frame;	    /* frame containing this window */
2543 
2544     pos_T	w_cursor;	    /* cursor position in buffer */
2545 
2546     colnr_T	w_curswant;	    /* The column we'd like to be at.  This is
2547 				       used to try to stay in the same column
2548 				       for up/down cursor motions. */
2549 
2550     int		w_set_curswant;	    /* If set, then update w_curswant the next
2551 				       time through cursupdate() to the
2552 				       current virtual column */
2553 
2554     /*
2555      * the next seven are used to update the visual part
2556      */
2557     char	w_old_visual_mode;  /* last known VIsual_mode */
2558     linenr_T	w_old_cursor_lnum;  /* last known end of visual part */
2559     colnr_T	w_old_cursor_fcol;  /* first column for block visual part */
2560     colnr_T	w_old_cursor_lcol;  /* last column for block visual part */
2561     linenr_T	w_old_visual_lnum;  /* last known start of visual part */
2562     colnr_T	w_old_visual_col;   /* last known start of visual part */
2563     colnr_T	w_old_curswant;	    /* last known value of Curswant */
2564 
2565     /*
2566      * "w_topline", "w_leftcol" and "w_skipcol" specify the offsets for
2567      * displaying the buffer.
2568      */
2569     linenr_T	w_topline;	    /* buffer line number of the line at the
2570 				       top of the window */
2571 #ifdef FEAT_AUTOCMD
2572     char	w_topline_was_set;  /* flag set to TRUE when topline is set,
2573 				       e.g. by winrestview() */
2574 #endif
2575 #ifdef FEAT_DIFF
2576     int		w_topfill;	    /* number of filler lines above w_topline */
2577     int		w_old_topfill;	    /* w_topfill at last redraw */
2578     int		w_botfill;	    /* TRUE when filler lines are actually
2579 				       below w_topline (at end of file) */
2580     int		w_old_botfill;	    /* w_botfill at last redraw */
2581 #endif
2582     colnr_T	w_leftcol;	    /* window column number of the left most
2583 				       character in the window; used when
2584 				       'wrap' is off */
2585     colnr_T	w_skipcol;	    /* starting column when a single line
2586 				       doesn't fit in the window */
2587 
2588     /*
2589      * Layout of the window in the screen.
2590      * May need to add "msg_scrolled" to "w_winrow" in rare situations.
2591      */
2592 #ifdef FEAT_WINDOWS
2593     int		w_winrow;	    /* first row of window in screen */
2594 #endif
2595     int		w_height;	    /* number of rows in window, excluding
2596 				       status/command line(s) */
2597 #ifdef FEAT_WINDOWS
2598     int		w_status_height;    /* number of status lines (0 or 1) */
2599     int		w_wincol;	    /* Leftmost column of window in screen.
2600 				       use W_WINCOL() */
2601     int		w_width;	    /* Width of window, excluding separation.
2602 				       use W_WIDTH() */
2603     int		w_vsep_width;	    /* Number of separator columns (0 or 1).
2604 				       use W_VSEP_WIDTH() */
2605 #endif
2606 
2607     /*
2608      * === start of cached values ====
2609      */
2610     /*
2611      * Recomputing is minimized by storing the result of computations.
2612      * Use functions in screen.c to check if they are valid and to update.
2613      * w_valid is a bitfield of flags, which indicate if specific values are
2614      * valid or need to be recomputed.	See screen.c for values.
2615      */
2616     int		w_valid;
2617     pos_T	w_valid_cursor;	    /* last known position of w_cursor, used
2618 				       to adjust w_valid */
2619     colnr_T	w_valid_leftcol;    /* last known w_leftcol */
2620 
2621     /*
2622      * w_cline_height is the number of physical lines taken by the buffer line
2623      * that the cursor is on.  We use this to avoid extra calls to plines().
2624      */
2625     int		w_cline_height;	    /* current size of cursor line */
2626 #ifdef FEAT_FOLDING
2627     int		w_cline_folded;	    /* cursor line is folded */
2628 #endif
2629 
2630     int		w_cline_row;	    /* starting row of the cursor line */
2631 
2632     colnr_T	w_virtcol;	    /* column number of the cursor in the
2633 				       buffer line, as opposed to the column
2634 				       number we're at on the screen.  This
2635 				       makes a difference on lines which span
2636 				       more than one screen line or when
2637 				       w_leftcol is non-zero */
2638 
2639     /*
2640      * w_wrow and w_wcol specify the cursor position in the window.
2641      * This is related to positions in the window, not in the display or
2642      * buffer, thus w_wrow is relative to w_winrow.
2643      */
2644     int		w_wrow, w_wcol;	    /* cursor position in window */
2645 
2646     linenr_T	w_botline;	    /* number of the line below the bottom of
2647 				       the window */
2648     int		w_empty_rows;	    /* number of ~ rows in window */
2649 #ifdef FEAT_DIFF
2650     int		w_filler_rows;	    /* number of filler rows at the end of the
2651 				       window */
2652 #endif
2653 
2654     /*
2655      * Info about the lines currently in the window is remembered to avoid
2656      * recomputing it every time.  The allocated size of w_lines[] is Rows.
2657      * Only the w_lines_valid entries are actually valid.
2658      * When the display is up-to-date w_lines[0].wl_lnum is equal to w_topline
2659      * and w_lines[w_lines_valid - 1].wl_lnum is equal to w_botline.
2660      * Between changing text and updating the display w_lines[] represents
2661      * what is currently displayed.  wl_valid is reset to indicated this.
2662      * This is used for efficient redrawing.
2663      */
2664     int		w_lines_valid;	    /* number of valid entries */
2665     wline_T	*w_lines;
2666 
2667 #ifdef FEAT_FOLDING
2668     garray_T	w_folds;	    /* array of nested folds */
2669     char	w_fold_manual;	    /* when TRUE: some folds are opened/closed
2670 				       manually */
2671     char	w_foldinvalid;	    /* when TRUE: folding needs to be
2672 				       recomputed */
2673 #endif
2674 #ifdef FEAT_LINEBREAK
2675     int		w_nrwidth;	    /* width of 'number' and 'relativenumber'
2676 				       column being used */
2677 #endif
2678 
2679     /*
2680      * === end of cached values ===
2681      */
2682 
2683     int		w_redr_type;	    /* type of redraw to be performed on win */
2684     int		w_upd_rows;	    /* number of window lines to update when
2685 				       w_redr_type is REDRAW_TOP */
2686     linenr_T	w_redraw_top;	    /* when != 0: first line needing redraw */
2687     linenr_T	w_redraw_bot;	    /* when != 0: last line needing redraw */
2688 #ifdef FEAT_WINDOWS
2689     int		w_redr_status;	    /* if TRUE status line must be redrawn */
2690 #endif
2691 
2692 #ifdef FEAT_CMDL_INFO
2693     /* remember what is shown in the ruler for this window (if 'ruler' set) */
2694     pos_T	w_ru_cursor;	    /* cursor position shown in ruler */
2695     colnr_T	w_ru_virtcol;	    /* virtcol shown in ruler */
2696     linenr_T	w_ru_topline;	    /* topline shown in ruler */
2697     linenr_T	w_ru_line_count;    /* line count used for ruler */
2698 # ifdef FEAT_DIFF
2699     int		w_ru_topfill;	    /* topfill shown in ruler */
2700 # endif
2701     char	w_ru_empty;	    /* TRUE if ruler shows 0-1 (empty line) */
2702 #endif
2703 
2704     int		w_alt_fnum;	    /* alternate file (for # and CTRL-^) */
2705 
2706 #ifdef FEAT_WINDOWS
2707     alist_T	*w_alist;	    /* pointer to arglist for this window */
2708 #endif
2709     int		w_arg_idx;	    /* current index in argument list (can be
2710 				       out of range!) */
2711     int		w_arg_idx_invalid;  /* editing another file than w_arg_idx */
2712 
2713     char_u	*w_localdir;	    /* absolute path of local directory or
2714 				       NULL */
2715     /*
2716      * Options local to a window.
2717      * They are local because they influence the layout of the window or
2718      * depend on the window layout.
2719      * There are two values: w_onebuf_opt is local to the buffer currently in
2720      * this window, w_allbuf_opt is for all buffers in this window.
2721      */
2722     winopt_T	w_onebuf_opt;
2723     winopt_T	w_allbuf_opt;
2724 
2725     /* A few options have local flags for P_INSECURE. */
2726 #ifdef FEAT_STL_OPT
2727     long_u	w_p_stl_flags;	    /* flags for 'statusline' */
2728 #endif
2729 #ifdef FEAT_EVAL
2730     long_u	w_p_fde_flags;	    /* flags for 'foldexpr' */
2731     long_u	w_p_fdt_flags;	    /* flags for 'foldtext' */
2732 #endif
2733 #ifdef FEAT_SYN_HL
2734     int		*w_p_cc_cols;	    /* array of columns to highlight or NULL */
2735 #endif
2736 #ifdef FEAT_LINEBREAK
2737     int		w_p_brimin;	    /* minimum width for breakindent */
2738     int		w_p_brishift;	    /* additional shift for breakindent */
2739     int		w_p_brisbr;	    /* sbr in 'briopt' */
2740 #endif
2741 
2742     /* transform a pointer to a "onebuf" option into a "allbuf" option */
2743 #define GLOBAL_WO(p)	((char *)p + sizeof(winopt_T))
2744 
2745 #ifdef FEAT_SCROLLBIND
2746     long	w_scbind_pos;
2747 #endif
2748 
2749 #ifdef FEAT_EVAL
2750     dictitem_T	w_winvar;	/* variable for "w:" Dictionary */
2751     dict_T	*w_vars;	/* internal variables, local to window */
2752 #endif
2753 
2754 #if defined(FEAT_RIGHTLEFT) && defined(FEAT_FKMAP)
2755     int		w_farsi;	/* for the window dependent Farsi functions */
2756 #endif
2757 
2758     /*
2759      * The w_prev_pcmark field is used to check whether we really did jump to
2760      * a new line after setting the w_pcmark.  If not, then we revert to
2761      * using the previous w_pcmark.
2762      */
2763     pos_T	w_pcmark;	/* previous context mark */
2764     pos_T	w_prev_pcmark;	/* previous w_pcmark */
2765 
2766 #ifdef FEAT_JUMPLIST
2767     /*
2768      * the jumplist contains old cursor positions
2769      */
2770     xfmark_T	w_jumplist[JUMPLISTSIZE];
2771     int		w_jumplistlen;		/* number of active entries */
2772     int		w_jumplistidx;		/* current position */
2773 
2774     int		w_changelistidx;	/* current position in b_changelist */
2775 #endif
2776 
2777 #ifdef FEAT_SEARCH_EXTRA
2778     matchitem_T	*w_match_head;		/* head of match list */
2779     int		w_next_match_id;	/* next match ID */
2780 #endif
2781 
2782     /*
2783      * the tagstack grows from 0 upwards:
2784      * entry 0: older
2785      * entry 1: newer
2786      * entry 2: newest
2787      */
2788     taggy_T	w_tagstack[TAGSTACKSIZE];	/* the tag stack */
2789     int		w_tagstackidx;		/* idx just below active entry */
2790     int		w_tagstacklen;		/* number of tags on stack */
2791 
2792     /*
2793      * w_fraction is the fractional row of the cursor within the window, from
2794      * 0 at the top row to FRACTION_MULT at the last row.
2795      * w_prev_fraction_row was the actual cursor row when w_fraction was last
2796      * calculated.
2797      */
2798     int		w_fraction;
2799     int		w_prev_fraction_row;
2800 
2801 #ifdef FEAT_GUI
2802     scrollbar_T	w_scrollbars[2];	/* vert. Scrollbars for this window */
2803 #endif
2804 #ifdef FEAT_LINEBREAK
2805     linenr_T	w_nrwidth_line_count;	/* line count when ml_nrwidth_width
2806 					 * was computed. */
2807     long	w_nuw_cached;		/* 'numberwidth' option cached */
2808     int		w_nrwidth_width;	/* nr of chars to print line count. */
2809 #endif
2810 
2811 #ifdef FEAT_QUICKFIX
2812     qf_info_T	*w_llist;		/* Location list for this window */
2813     /*
2814      * Location list reference used in the location list window.
2815      * In a non-location list window, w_llist_ref is NULL.
2816      */
2817     qf_info_T	*w_llist_ref;
2818 #endif
2819 
2820 
2821 #ifdef FEAT_MZSCHEME
2822     void	*w_mzscheme_ref;	/* The MzScheme value for this window */
2823 #endif
2824 
2825 #ifdef FEAT_PERL
2826     void	*w_perl_private;
2827 #endif
2828 
2829 #ifdef FEAT_PYTHON
2830     void	*w_python_ref;		/* The Python value for this window */
2831 #endif
2832 
2833 #ifdef FEAT_PYTHON3
2834     void	*w_python3_ref;		/* The Python value for this window */
2835 #endif
2836 
2837 #ifdef FEAT_TCL
2838     void	*w_tcl_ref;
2839 #endif
2840 
2841 #ifdef FEAT_RUBY
2842     void	*w_ruby_ref;
2843 #endif
2844 };
2845 
2846 /*
2847  * Arguments for operators.
2848  */
2849 typedef struct oparg_S
2850 {
2851     int		op_type;	/* current pending operator type */
2852     int		regname;	/* register to use for the operator */
2853     int		motion_type;	/* type of the current cursor motion */
2854     int		motion_force;	/* force motion type: 'v', 'V' or CTRL-V */
2855     int		use_reg_one;	/* TRUE if delete uses reg 1 even when not
2856 				   linewise */
2857     int		inclusive;	/* TRUE if char motion is inclusive (only
2858 				   valid when motion_type is MCHAR */
2859     int		end_adjusted;	/* backuped b_op_end one char (only used by
2860 				   do_format()) */
2861     pos_T	start;		/* start of the operator */
2862     pos_T	end;		/* end of the operator */
2863     pos_T	cursor_start;	/* cursor position before motion for "gw" */
2864 
2865     long	line_count;	/* number of lines from op_start to op_end
2866 				   (inclusive) */
2867     int		empty;		/* op_start and op_end the same (only used by
2868 				   do_change()) */
2869     int		is_VIsual;	/* operator on Visual area */
2870     int		block_mode;	/* current operator is Visual block mode */
2871     colnr_T	start_vcol;	/* start col for block mode operator */
2872     colnr_T	end_vcol;	/* end col for block mode operator */
2873 #ifdef FEAT_AUTOCMD
2874     long	prev_opcount;	/* ca.opcount saved for K_CURSORHOLD */
2875     long	prev_count0;	/* ca.count0 saved for K_CURSORHOLD */
2876 #endif
2877 } oparg_T;
2878 
2879 /*
2880  * Arguments for Normal mode commands.
2881  */
2882 typedef struct cmdarg_S
2883 {
2884     oparg_T	*oap;		/* Operator arguments */
2885     int		prechar;	/* prefix character (optional, always 'g') */
2886     int		cmdchar;	/* command character */
2887     int		nchar;		/* next command character (optional) */
2888 #ifdef FEAT_MBYTE
2889     int		ncharC1;	/* first composing character (optional) */
2890     int		ncharC2;	/* second composing character (optional) */
2891 #endif
2892     int		extra_char;	/* yet another character (optional) */
2893     long	opcount;	/* count before an operator */
2894     long	count0;		/* count before command, default 0 */
2895     long	count1;		/* count before command, default 1 */
2896     int		arg;		/* extra argument from nv_cmds[] */
2897     int		retval;		/* return: CA_* values */
2898     char_u	*searchbuf;	/* return: pointer to search pattern or NULL */
2899 } cmdarg_T;
2900 
2901 /* values for retval: */
2902 #define CA_COMMAND_BUSY	    1	/* skip restarting edit() once */
2903 #define CA_NO_ADJ_OP_END    2	/* don't adjust operator end */
2904 
2905 #ifdef CURSOR_SHAPE
2906 /*
2907  * struct to store values from 'guicursor' and 'mouseshape'
2908  */
2909 /* Indexes in shape_table[] */
2910 #define SHAPE_IDX_N	0	/* Normal mode */
2911 #define SHAPE_IDX_V	1	/* Visual mode */
2912 #define SHAPE_IDX_I	2	/* Insert mode */
2913 #define SHAPE_IDX_R	3	/* Replace mode */
2914 #define SHAPE_IDX_C	4	/* Command line Normal mode */
2915 #define SHAPE_IDX_CI	5	/* Command line Insert mode */
2916 #define SHAPE_IDX_CR	6	/* Command line Replace mode */
2917 #define SHAPE_IDX_O	7	/* Operator-pending mode */
2918 #define SHAPE_IDX_VE	8	/* Visual mode with 'selection' exclusive */
2919 #define SHAPE_IDX_CLINE	9	/* On command line */
2920 #define SHAPE_IDX_STATUS 10	/* A status line */
2921 #define SHAPE_IDX_SDRAG 11	/* dragging a status line */
2922 #define SHAPE_IDX_VSEP	12	/* A vertical separator line */
2923 #define SHAPE_IDX_VDRAG 13	/* dragging a vertical separator line */
2924 #define SHAPE_IDX_MORE	14	/* Hit-return or More */
2925 #define SHAPE_IDX_MOREL	15	/* Hit-return or More in last line */
2926 #define SHAPE_IDX_SM	16	/* showing matching paren */
2927 #define SHAPE_IDX_COUNT	17
2928 
2929 #define SHAPE_BLOCK	0	/* block cursor */
2930 #define SHAPE_HOR	1	/* horizontal bar cursor */
2931 #define SHAPE_VER	2	/* vertical bar cursor */
2932 
2933 #define MSHAPE_NUMBERED	1000	/* offset for shapes identified by number */
2934 #define MSHAPE_HIDE	1	/* hide mouse pointer */
2935 
2936 #define SHAPE_MOUSE	1	/* used for mouse pointer shape */
2937 #define SHAPE_CURSOR	2	/* used for text cursor shape */
2938 
2939 typedef struct cursor_entry
2940 {
2941     int		shape;		/* one of the SHAPE_ defines */
2942     int		mshape;		/* one of the MSHAPE defines */
2943     int		percentage;	/* percentage of cell for bar */
2944     long	blinkwait;	/* blinking, wait time before blinking starts */
2945     long	blinkon;	/* blinking, on time */
2946     long	blinkoff;	/* blinking, off time */
2947     int		id;		/* highlight group ID */
2948     int		id_lm;		/* highlight group ID for :lmap mode */
2949     char	*name;		/* mode name (fixed) */
2950     char	used_for;	/* SHAPE_MOUSE and/or SHAPE_CURSOR */
2951 } cursorentry_T;
2952 #endif /* CURSOR_SHAPE */
2953 
2954 #ifdef FEAT_MENU
2955 
2956 /* Indices into vimmenu_T->strings[] and vimmenu_T->noremap[] for each mode */
2957 #define MENU_INDEX_INVALID	-1
2958 #define MENU_INDEX_NORMAL	0
2959 #define MENU_INDEX_VISUAL	1
2960 #define MENU_INDEX_SELECT	2
2961 #define MENU_INDEX_OP_PENDING	3
2962 #define MENU_INDEX_INSERT	4
2963 #define MENU_INDEX_CMDLINE	5
2964 #define MENU_INDEX_TIP		6
2965 #define MENU_MODES		7
2966 
2967 /* Menu modes */
2968 #define MENU_NORMAL_MODE	(1 << MENU_INDEX_NORMAL)
2969 #define MENU_VISUAL_MODE	(1 << MENU_INDEX_VISUAL)
2970 #define MENU_SELECT_MODE	(1 << MENU_INDEX_SELECT)
2971 #define MENU_OP_PENDING_MODE	(1 << MENU_INDEX_OP_PENDING)
2972 #define MENU_INSERT_MODE	(1 << MENU_INDEX_INSERT)
2973 #define MENU_CMDLINE_MODE	(1 << MENU_INDEX_CMDLINE)
2974 #define MENU_TIP_MODE		(1 << MENU_INDEX_TIP)
2975 #define MENU_ALL_MODES		((1 << MENU_INDEX_TIP) - 1)
2976 /*note MENU_INDEX_TIP is not a 'real' mode*/
2977 
2978 /* Start a menu name with this to not include it on the main menu bar */
2979 #define MNU_HIDDEN_CHAR		']'
2980 
2981 typedef struct VimMenu vimmenu_T;
2982 
2983 struct VimMenu
2984 {
2985     int		modes;		    /* Which modes is this menu visible for? */
2986     int		enabled;	    /* for which modes the menu is enabled */
2987     char_u	*name;		    /* Name of menu, possibly translated */
2988     char_u	*dname;		    /* Displayed Name ("name" without '&') */
2989 #ifdef FEAT_MULTI_LANG
2990     char_u	*en_name;	    /* "name" untranslated, NULL when "name"
2991 				     * was not translated */
2992     char_u	*en_dname;	    /* "dname" untranslated, NULL when "dname"
2993 				     * was not translated */
2994 #endif
2995     int		mnemonic;	    /* mnemonic key (after '&') */
2996     char_u	*actext;	    /* accelerator text (after TAB) */
2997     int		priority;	    /* Menu order priority */
2998 #ifdef FEAT_GUI
2999     void	(*cb)(vimmenu_T *);	    /* Call-back routine */
3000 #endif
3001 #ifdef FEAT_TOOLBAR
3002     char_u	*iconfile;	    /* name of file for icon or NULL */
3003     int		iconidx;	    /* icon index (-1 if not set) */
3004     int		icon_builtin;	    /* icon names is BuiltIn{nr} */
3005 #endif
3006     char_u	*strings[MENU_MODES]; /* Mapped string for each mode */
3007     int		noremap[MENU_MODES]; /* A REMAP_ flag for each mode */
3008     char	silent[MENU_MODES]; /* A silent flag for each mode */
3009     vimmenu_T	*children;	    /* Children of sub-menu */
3010     vimmenu_T	*parent;	    /* Parent of menu */
3011     vimmenu_T	*next;		    /* Next item in menu */
3012 #ifdef FEAT_GUI_X11
3013     Widget	id;		    /* Manage this to enable item */
3014     Widget	submenu_id;	    /* If this is submenu, add children here */
3015 #endif
3016 #ifdef FEAT_GUI_GTK
3017     GtkWidget	*id;		    /* Manage this to enable item */
3018     GtkWidget	*submenu_id;	    /* If this is submenu, add children here */
3019 # if defined(GTK_CHECK_VERSION) && !GTK_CHECK_VERSION(3,4,0)
3020     GtkWidget	*tearoff_handle;
3021 # endif
3022     GtkWidget   *label;		    /* Used by "set wak=" code. */
3023 #endif
3024 #ifdef FEAT_GUI_MOTIF
3025     int		sensitive;	    /* turn button on/off */
3026     char	**xpm;		    /* pixmap data */
3027     char	*xpm_fname;	    /* file with pixmap data */
3028 #endif
3029 #ifdef FEAT_GUI_ATHENA
3030     Pixmap	image;		    /* Toolbar image */
3031 #endif
3032 #ifdef FEAT_BEVAL_TIP
3033     BalloonEval *tip;		    /* tooltip for this menu item */
3034 #endif
3035 #ifdef FEAT_GUI_W32
3036     UINT	id;		    /* Id of menu item */
3037     HMENU	submenu_id;	    /* If this is submenu, add children here */
3038     HWND	tearoff_handle;	    /* hWnd of tearoff if created */
3039 #endif
3040 #ifdef FEAT_GUI_MAC
3041 /*  MenuHandle	id; */
3042 /*  short	index;	*/	    /* the item index within the father menu */
3043     short	menu_id;	    /* the menu id to which this item belong */
3044     short	submenu_id;	    /* the menu id of the children (could be
3045 				       get through some tricks) */
3046     MenuHandle	menu_handle;
3047     MenuHandle	submenu_handle;
3048 #endif
3049 #ifdef FEAT_GUI_PHOTON
3050     PtWidget_t	*id;
3051     PtWidget_t	*submenu_id;
3052 #endif
3053 };
3054 #else
3055 /* For generating prototypes when FEAT_MENU isn't defined. */
3056 typedef int vimmenu_T;
3057 
3058 #endif /* FEAT_MENU */
3059 
3060 /*
3061  * Struct to save values in before executing autocommands for a buffer that is
3062  * not the current buffer.  Without FEAT_AUTOCMD only "curbuf" is remembered.
3063  */
3064 typedef struct
3065 {
3066     buf_T	*save_curbuf;	/* saved curbuf */
3067 #ifdef FEAT_AUTOCMD
3068     int		use_aucmd_win;	/* using aucmd_win */
3069     win_T	*save_curwin;	/* saved curwin */
3070     win_T	*new_curwin;	/* new curwin */
3071     bufref_T	new_curbuf;	/* new curbuf */
3072     char_u	*globaldir;	/* saved value of globaldir */
3073 #endif
3074 } aco_save_T;
3075 
3076 /*
3077  * Generic option table item, only used for printer at the moment.
3078  */
3079 typedef struct
3080 {
3081     const char	*name;
3082     int		hasnum;
3083     long	number;
3084     char_u	*string;	/* points into option string */
3085     int		strlen;
3086     int		present;
3087 } option_table_T;
3088 
3089 /*
3090  * Structure to hold printing color and font attributes.
3091  */
3092 typedef struct
3093 {
3094     long_u	fg_color;
3095     long_u	bg_color;
3096     int		bold;
3097     int		italic;
3098     int		underline;
3099     int		undercurl;
3100 } prt_text_attr_T;
3101 
3102 /*
3103  * Structure passed back to the generic printer code.
3104  */
3105 typedef struct
3106 {
3107     int		n_collated_copies;
3108     int		n_uncollated_copies;
3109     int		duplex;
3110     int		chars_per_line;
3111     int		lines_per_page;
3112     int		has_color;
3113     prt_text_attr_T number;
3114 #ifdef FEAT_SYN_HL
3115     int		modec;
3116     int		do_syntax;
3117 #endif
3118     int		user_abort;
3119     char_u	*jobname;
3120 #ifdef FEAT_POSTSCRIPT
3121     char_u	*outfile;
3122     char_u	*arguments;
3123 #endif
3124 } prt_settings_T;
3125 
3126 #define PRINT_NUMBER_WIDTH 8
3127 
3128 /*
3129  * Used for popup menu items.
3130  */
3131 typedef struct
3132 {
3133     char_u	*pum_text;	/* main menu text */
3134     char_u	*pum_kind;	/* extra kind text (may be truncated) */
3135     char_u	*pum_extra;	/* extra menu text (may be truncated) */
3136     char_u	*pum_info;	/* extra info */
3137 } pumitem_T;
3138 
3139 /*
3140  * Structure used for get_tagfname().
3141  */
3142 typedef struct
3143 {
3144     char_u	*tn_tags;	/* value of 'tags' when starting */
3145     char_u	*tn_np;		/* current position in tn_tags */
3146     int		tn_did_filefind_init;
3147     int		tn_hf_idx;
3148     void	*tn_search_ctx;
3149 } tagname_T;
3150 
3151 /*
3152  * Array indexes used for cptext argument of ins_compl_add().
3153  */
3154 #define CPT_ABBR    0	/* "abbr" */
3155 #define CPT_MENU    1	/* "menu" */
3156 #define CPT_KIND    2	/* "kind" */
3157 #define CPT_INFO    3	/* "info" */
3158 #define CPT_COUNT   4	/* Number of entries */
3159 
3160 typedef struct {
3161   UINT32_T total[2];
3162   UINT32_T state[8];
3163   char_u   buffer[64];
3164 } context_sha256_T;
3165 
3166 /*
3167  * Structure used for reading in json_decode().
3168  */
3169 struct js_reader
3170 {
3171     char_u	*js_buf;	/* text to be decoded */
3172     char_u	*js_end;	/* NUL in js_buf */
3173     int		js_used;	/* bytes used from js_buf */
3174     int		(*js_fill)(struct js_reader *);
3175 				/* function to fill the buffer or NULL;
3176                                  * return TRUE when the buffer was filled */
3177     void	*js_cookie;	/* can be used by js_fill */
3178     int		js_cookie_arg;	/* can be used by js_fill */
3179 };
3180 typedef struct js_reader js_read_T;
3181 
3182 typedef struct timer_S timer_T;
3183 struct timer_S
3184 {
3185     long	tr_id;
3186 #ifdef FEAT_TIMERS
3187     timer_T	*tr_next;
3188     timer_T	*tr_prev;
3189     proftime_T	tr_due;		    /* when the callback is to be invoked */
3190     char	tr_firing;	    /* when TRUE callback is being called */
3191     char	tr_paused;	    /* when TRUE callback is not invoked */
3192     int		tr_repeat;	    /* number of times to repeat, -1 forever */
3193     long	tr_interval;	    /* msec */
3194     char_u	*tr_callback;	    /* allocated */
3195     partial_T	*tr_partial;
3196 #endif
3197 };
3198 
3199 /* Maximum number of commands from + or -c arguments. */
3200 #define MAX_ARG_CMDS 10
3201 
3202 /* values for "window_layout" */
3203 #define WIN_HOR	    1	    /* "-o" horizontally split windows */
3204 #define	WIN_VER	    2	    /* "-O" vertically split windows */
3205 #define	WIN_TABS    3	    /* "-p" windows on tab pages */
3206 
3207 /* Struct for various parameters passed between main() and other functions. */
3208 typedef struct
3209 {
3210     int		argc;
3211     char	**argv;
3212 
3213     char_u	*fname;			/* first file to edit */
3214 
3215     int		evim_mode;		/* started as "evim" */
3216     char_u	*use_vimrc;		/* vimrc from -u argument */
3217 
3218     int		n_commands;		     /* no. of commands from + or -c */
3219     char_u	*commands[MAX_ARG_CMDS];     /* commands from + or -c arg. */
3220     char_u	cmds_tofree[MAX_ARG_CMDS];   /* commands that need free() */
3221     int		n_pre_commands;		     /* no. of commands from --cmd */
3222     char_u	*pre_commands[MAX_ARG_CMDS]; /* commands from --cmd argument */
3223 
3224     int		edit_type;		/* type of editing to do */
3225     char_u	*tagname;		/* tag from -t argument */
3226 #ifdef FEAT_QUICKFIX
3227     char_u	*use_ef;		/* 'errorfile' from -q argument */
3228 #endif
3229 
3230     int		want_full_screen;
3231     int		not_a_term;		/* no warning for missing term? */
3232     int		tty_fail;		/* exit if not a tty */
3233     char_u	*term;			/* specified terminal name */
3234 #ifdef FEAT_CRYPT
3235     int		ask_for_key;		/* -x argument */
3236 #endif
3237     int		no_swap_file;		/* "-n" argument used */
3238 #ifdef FEAT_EVAL
3239     int		use_debug_break_level;
3240 #endif
3241 #ifdef FEAT_WINDOWS
3242     int		window_count;		/* number of windows to use */
3243     int		window_layout;		/* 0, WIN_HOR, WIN_VER or WIN_TABS */
3244 #endif
3245 
3246 #ifdef FEAT_CLIENTSERVER
3247     int		serverArg;		/* TRUE when argument for a server */
3248     char_u	*serverName_arg;	/* cmdline arg for server name */
3249     char_u	*serverStr;		/* remote server command */
3250     char_u	*serverStrEnc;		/* encoding of serverStr */
3251     char_u	*servername;		/* allocated name for our server */
3252 #endif
3253 #if !defined(UNIX)
3254 # define EXPAND_FILENAMES
3255     int		literal;		/* don't expand file names */
3256 #endif
3257 #ifdef MSWIN
3258     int		full_path;		/* file name argument was full path */
3259 #endif
3260 #ifdef FEAT_DIFF
3261     int		diff_mode;		/* start with 'diff' set */
3262 #endif
3263 } mparm_T;
3264 
3265 /*
3266  * Structure returned by get_lval() and used by set_var_lval().
3267  * For a plain name:
3268  *	"name"	    points to the variable name.
3269  *	"exp_name"  is NULL.
3270  *	"tv"	    is NULL
3271  * For a magic braces name:
3272  *	"name"	    points to the expanded variable name.
3273  *	"exp_name"  is non-NULL, to be freed later.
3274  *	"tv"	    is NULL
3275  * For an index in a list:
3276  *	"name"	    points to the (expanded) variable name.
3277  *	"exp_name"  NULL or non-NULL, to be freed later.
3278  *	"tv"	    points to the (first) list item value
3279  *	"li"	    points to the (first) list item
3280  *	"range", "n1", "n2" and "empty2" indicate what items are used.
3281  * For an existing Dict item:
3282  *	"name"	    points to the (expanded) variable name.
3283  *	"exp_name"  NULL or non-NULL, to be freed later.
3284  *	"tv"	    points to the dict item value
3285  *	"newkey"    is NULL
3286  * For a non-existing Dict item:
3287  *	"name"	    points to the (expanded) variable name.
3288  *	"exp_name"  NULL or non-NULL, to be freed later.
3289  *	"tv"	    points to the Dictionary typval_T
3290  *	"newkey"    is the key for the new item.
3291  */
3292 typedef struct lval_S
3293 {
3294     char_u	*ll_name;	/* start of variable name (can be NULL) */
3295     char_u	*ll_exp_name;	/* NULL or expanded name in allocated memory. */
3296     typval_T	*ll_tv;		/* Typeval of item being used.  If "newkey"
3297 				   isn't NULL it's the Dict to which to add
3298 				   the item. */
3299     listitem_T	*ll_li;		/* The list item or NULL. */
3300     list_T	*ll_list;	/* The list or NULL. */
3301     int		ll_range;	/* TRUE when a [i:j] range was used */
3302     long	ll_n1;		/* First index for list */
3303     long	ll_n2;		/* Second index for list range */
3304     int		ll_empty2;	/* Second index is empty: [i:] */
3305     dict_T	*ll_dict;	/* The Dictionary or NULL */
3306     dictitem_T	*ll_di;		/* The dictitem or NULL */
3307     char_u	*ll_newkey;	/* New key for Dict in alloc. mem or NULL. */
3308 } lval_T;
3309