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