blob: f5ad17414a63503ac07301a57b2f4b52c1f19940 [file] [log] [blame]
Bram Moolenaaredf3f972016-08-29 22:49:24 +02001/* vi:set ts=8 sts=4 sw=4 noet:
Bram Moolenaar071d4272004-06-13 20:20:40 +00002 *
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
18typedef long linenr_T;
Bram Moolenaar5fd0ca72009-05-13 16:56:33 +000019typedef int colnr_T;
Bram Moolenaar071d4272004-06-13 20:20:40 +000020typedef unsigned short short_u;
21#endif
22
23/*
Bram Moolenaar29ddebe2019-01-26 17:28:26 +010024 * Position in file or buffer.
Bram Moolenaar071d4272004-06-13 20:20:40 +000025 */
26typedef struct
27{
Bram Moolenaar29ddebe2019-01-26 17:28:26 +010028 linenr_T lnum; // line number
29 colnr_T col; // column number
30 colnr_T coladd; // extra virtual column
Bram Moolenaar071d4272004-06-13 20:20:40 +000031} pos_T;
32
Bram Moolenaar071d4272004-06-13 20:20:40 +000033
34/*
35 * Same, but without coladd.
36 */
37typedef struct
38{
Bram Moolenaar29ddebe2019-01-26 17:28:26 +010039 linenr_T lnum; // line number
40 colnr_T col; // column number
Bram Moolenaar071d4272004-06-13 20:20:40 +000041} lpos_T;
42
43/*
44 * Structure used for growing arrays.
45 * This is used to store information that only grows, is deleted all at
46 * once, and needs to be accessed by index. See ga_clear() and ga_grow().
47 */
48typedef struct growarray
49{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +020050 int ga_len; // current number of items used
51 int ga_maxlen; // maximum number of items possible
52 int ga_itemsize; // sizeof(item)
53 int ga_growsize; // number of items to grow each time
54 void *ga_data; // pointer to the first item
Bram Moolenaar071d4272004-06-13 20:20:40 +000055} garray_T;
56
57#define GA_EMPTY {0, 0, 0, 0, NULL}
58
Bram Moolenaar1d2ba7f2006-02-14 22:29:30 +000059typedef struct window_S win_T;
60typedef struct wininfo_S wininfo_T;
61typedef struct frame_S frame_T;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +020062typedef int scid_T; // script ID
63typedef struct file_buffer buf_T; // forward declaration
Bram Moolenaare4f25e42017-07-07 11:54:15 +020064typedef struct terminal_S term_T;
Bram Moolenaarfbc0d2e2013-05-19 19:40:29 +020065
Bram Moolenaar1b9645d2017-09-17 23:03:31 +020066#ifdef FEAT_MENU
67typedef struct VimMenu vimmenu_T;
68#endif
69
Bram Moolenaar67979662020-06-20 22:50:47 +020070// maximum value for sc_version
71#define SCRIPT_VERSION_MAX 4
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010072// value for sc_version in a Vim9 script file
73#define SCRIPT_VERSION_VIM9 999999
74
Bram Moolenaar45e5fd12017-06-04 14:58:02 +020075/*
Bram Moolenaarfe72d082019-12-20 19:07:00 +010076 * SCript ConteXt (SCTX): identifies a script line.
Bram Moolenaarf29c1c62018-09-10 21:05:02 +020077 * When sourcing a script "sc_lnum" is zero, "sourcing_lnum" is the current
78 * line number. When executing a user function "sc_lnum" is the line where the
79 * function was defined, "sourcing_lnum" is the line number inside the
80 * function. When stored with a function, mapping, option, etc. "sc_lnum" is
81 * the line number in the script "sc_sid".
Bram Moolenaar7ebcba62020-01-12 17:42:55 +010082 *
83 * sc_version is also here, for convenience.
Bram Moolenaarf29c1c62018-09-10 21:05:02 +020084 */
85typedef struct {
Bram Moolenaar9b8d6222020-12-28 18:26:00 +010086#ifdef FEAT_EVAL
Bram Moolenaarf29c1c62018-09-10 21:05:02 +020087 scid_T sc_sid; // script ID
Bram Moolenaarded5f1b2018-11-10 17:33:29 +010088 int sc_seq; // sourcing sequence number
Bram Moolenaarf29c1c62018-09-10 21:05:02 +020089 linenr_T sc_lnum; // line number
Bram Moolenaar9b8d6222020-12-28 18:26:00 +010090#endif
Bram Moolenaar558ca4a2019-04-04 18:15:38 +020091 int sc_version; // :scriptversion
Bram Moolenaarf29c1c62018-09-10 21:05:02 +020092} sctx_T;
93
94/*
Bram Moolenaar45e5fd12017-06-04 14:58:02 +020095 * Reference to a buffer that stores the value of buf_free_count.
Bram Moolenaarb25f9a92016-07-10 18:21:50 +020096 * bufref_valid() only needs to check "buf" when the count differs.
97 */
98typedef struct {
99 buf_T *br_buf;
Bram Moolenaar45e5fd12017-06-04 14:58:02 +0200100 int br_fnum;
Bram Moolenaarb25f9a92016-07-10 18:21:50 +0200101 int br_buf_free_count;
102} bufref_T;
103
Bram Moolenaarfbc0d2e2013-05-19 19:40:29 +0200104/*
105 * This is here because regexp.h needs pos_T and below regprog_T is used.
106 */
107#include "regexp.h"
Bram Moolenaar071d4272004-06-13 20:20:40 +0000108
109/*
110 * This is here because gui.h needs the pos_T and win_T, and win_T needs gui.h
111 * for scrollbar_T.
112 */
113#ifdef FEAT_GUI
114# include "gui.h"
115#else
116# ifdef FEAT_XCLIPBOARD
117# include <X11/Intrinsic.h>
118# endif
Bram Moolenaar1b58cdd2016-08-22 23:04:33 +0200119# define guicolor_T long
Bram Moolenaar8a633e32016-04-21 21:10:14 +0200120# define INVALCOLOR ((guicolor_T)0x1ffffff)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200121 // only used for cterm.bg_rgb and cterm.fg_rgb: use cterm color
Bram Moolenaard4fc5772018-02-27 14:39:03 +0100122# define CTERMCOLOR ((guicolor_T)0x1fffffe)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000123#endif
Bram Moolenaard4fc5772018-02-27 14:39:03 +0100124#define COLOR_INVALID(x) ((x) == INVALCOLOR || (x) == CTERMCOLOR)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000125
Bram Moolenaar87fd0922021-11-20 13:47:45 +0000126#ifdef FEAT_TERMINAL
127# include "libvterm/include/vterm.h"
128typedef struct {
129 VTermColor fg;
130 VTermColor bg;
131} termcellcolor_T;
132#endif
133
Bram Moolenaar071d4272004-06-13 20:20:40 +0000134/*
135 * marks: positions in a file
136 * (a normal mark is a lnum/col pair, the same as a file position)
137 */
138
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200139#define NMARKS ('z' - 'a' + 1) // max. # of named marks
Bram Moolenaar1e78e692019-07-22 20:18:27 +0200140#define EXTRA_MARKS 10 // marks 0-9
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200141#define JUMPLISTSIZE 100 // max. # of marks in jump list
142#define TAGSTACKSIZE 20 // max. # of tags in tag stack
Bram Moolenaar071d4272004-06-13 20:20:40 +0000143
144typedef struct filemark
145{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200146 pos_T mark; // cursor position
147 int fnum; // file number
Bram Moolenaar071d4272004-06-13 20:20:40 +0000148} fmark_T;
149
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200150// Xtended file mark: also has a file name
Bram Moolenaar071d4272004-06-13 20:20:40 +0000151typedef struct xfilemark
152{
153 fmark_T fmark;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200154 char_u *fname; // file name, used when fnum == 0
Bram Moolenaar2d358992016-06-12 21:20:54 +0200155#ifdef FEAT_VIMINFO
Bram Moolenaarf4fba6d2016-06-26 16:44:24 +0200156 time_T time_set;
Bram Moolenaar2d358992016-06-12 21:20:54 +0200157#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +0000158} xfmark_T;
159
160/*
161 * The taggy struct is used to store the information about a :tag command.
162 */
163typedef struct taggy
164{
Bram Moolenaar45e18cb2019-04-28 18:05:35 +0200165 char_u *tagname; // tag name
166 fmark_T fmark; // cursor position BEFORE ":tag"
167 int cur_match; // match number
168 int cur_fnum; // buffer number used for cur_match
169 char_u *user_data; // used with tagfunc
Bram Moolenaar071d4272004-06-13 20:20:40 +0000170} taggy_T;
171
172/*
173 * Structure that contains all options that are local to a window.
174 * Used twice in a window: for the current buffer and for all buffers.
175 * Also used in wininfo_T.
176 */
177typedef struct
178{
179#ifdef FEAT_ARABIC
180 int wo_arab;
Bram Moolenaar4d784b22019-05-25 19:51:39 +0200181# define w_p_arab w_onebuf_opt.wo_arab // 'arabic'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000182#endif
Bram Moolenaar597a4222014-06-25 14:39:50 +0200183#ifdef FEAT_LINEBREAK
184 int wo_bri;
Bram Moolenaar4d784b22019-05-25 19:51:39 +0200185# define w_p_bri w_onebuf_opt.wo_bri // 'breakindent'
Bram Moolenaarb8ee25a2014-09-23 15:45:08 +0200186 char_u *wo_briopt;
Bram Moolenaar4d784b22019-05-25 19:51:39 +0200187# define w_p_briopt w_onebuf_opt.wo_briopt // 'breakindentopt'
Bram Moolenaar597a4222014-06-25 14:39:50 +0200188#endif
Bram Moolenaar4d784b22019-05-25 19:51:39 +0200189 char_u *wo_wcr;
190# define w_p_wcr w_onebuf_opt.wo_wcr // 'wincolor'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000191#ifdef FEAT_DIFF
192 int wo_diff;
Bram Moolenaar4d784b22019-05-25 19:51:39 +0200193# define w_p_diff w_onebuf_opt.wo_diff // 'diff'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000194#endif
195#ifdef FEAT_FOLDING
196 long wo_fdc;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200197# define w_p_fdc w_onebuf_opt.wo_fdc // 'foldcolumn'
Bram Moolenaara87aa802013-07-03 15:47:03 +0200198 int wo_fdc_save;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200199# define w_p_fdc_save w_onebuf_opt.wo_fdc_save // 'foldenable' saved for diff mode
Bram Moolenaar071d4272004-06-13 20:20:40 +0000200 int wo_fen;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200201# define w_p_fen w_onebuf_opt.wo_fen // 'foldenable'
Bram Moolenaara87aa802013-07-03 15:47:03 +0200202 int wo_fen_save;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200203# define w_p_fen_save w_onebuf_opt.wo_fen_save // 'foldenable' saved for diff mode
Bram Moolenaar071d4272004-06-13 20:20:40 +0000204 char_u *wo_fdi;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200205# define w_p_fdi w_onebuf_opt.wo_fdi // 'foldignore'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000206 long wo_fdl;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200207# define w_p_fdl w_onebuf_opt.wo_fdl // 'foldlevel'
Bram Moolenaara87aa802013-07-03 15:47:03 +0200208 int wo_fdl_save;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200209# define w_p_fdl_save w_onebuf_opt.wo_fdl_save // 'foldlevel' state saved for diff mode
Bram Moolenaar071d4272004-06-13 20:20:40 +0000210 char_u *wo_fdm;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200211# define w_p_fdm w_onebuf_opt.wo_fdm // 'foldmethod'
Bram Moolenaara87aa802013-07-03 15:47:03 +0200212 char_u *wo_fdm_save;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200213# define w_p_fdm_save w_onebuf_opt.wo_fdm_save // 'fdm' saved for diff mode
Bram Moolenaar071d4272004-06-13 20:20:40 +0000214 long wo_fml;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200215# define w_p_fml w_onebuf_opt.wo_fml // 'foldminlines'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000216 long wo_fdn;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200217# define w_p_fdn w_onebuf_opt.wo_fdn // 'foldnestmax'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000218# ifdef FEAT_EVAL
219 char_u *wo_fde;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200220# define w_p_fde w_onebuf_opt.wo_fde // 'foldexpr'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000221 char_u *wo_fdt;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200222# define w_p_fdt w_onebuf_opt.wo_fdt // 'foldtext'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000223# endif
224 char_u *wo_fmr;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200225# define w_p_fmr w_onebuf_opt.wo_fmr // 'foldmarker'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000226#endif
227#ifdef FEAT_LINEBREAK
228 int wo_lbr;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200229# define w_p_lbr w_onebuf_opt.wo_lbr // 'linebreak'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000230#endif
231 int wo_list;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200232#define w_p_list w_onebuf_opt.wo_list // 'list'
Bram Moolenaareed9d462021-02-15 20:38:25 +0100233 char_u *wo_lcs;
234#define w_p_lcs w_onebuf_opt.wo_lcs // 'listchars'
Bram Moolenaar96ba25a2022-07-04 17:34:33 +0100235 char_u *wo_fcs;
236#define w_p_fcs w_onebuf_opt.wo_fcs // 'fillchars'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000237 int wo_nu;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200238#define w_p_nu w_onebuf_opt.wo_nu // 'number'
Bram Moolenaar64486672010-05-16 15:46:46 +0200239 int wo_rnu;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200240#define w_p_rnu w_onebuf_opt.wo_rnu // 'relativenumber'
Gary Johnson51ad8502021-08-03 18:33:08 +0200241 char_u *wo_ve;
242#define w_p_ve w_onebuf_opt.wo_ve // 'virtualedit'
243 unsigned wo_ve_flags;
244#define w_ve_flags w_onebuf_opt.wo_ve_flags // flags for 'virtualedit'
Bram Moolenaar592e0a22004-07-03 16:05:59 +0000245#ifdef FEAT_LINEBREAK
246 long wo_nuw;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200247# define w_p_nuw w_onebuf_opt.wo_nuw // 'numberwidth'
Bram Moolenaar592e0a22004-07-03 16:05:59 +0000248#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +0000249 int wo_wfh;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200250# define w_p_wfh w_onebuf_opt.wo_wfh // 'winfixheight'
Bram Moolenaar97b2ad32006-03-18 21:40:56 +0000251 int wo_wfw;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200252# define w_p_wfw w_onebuf_opt.wo_wfw // 'winfixwidth'
Bram Moolenaar4033c552017-09-16 20:54:51 +0200253#if defined(FEAT_QUICKFIX)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000254 int wo_pvw;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200255# define w_p_pvw w_onebuf_opt.wo_pvw // 'previewwindow'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000256#endif
257#ifdef FEAT_RIGHTLEFT
258 int wo_rl;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200259# define w_p_rl w_onebuf_opt.wo_rl // 'rightleft'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000260 char_u *wo_rlc;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200261# define w_p_rlc w_onebuf_opt.wo_rlc // 'rightleftcmd'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000262#endif
263 long wo_scr;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200264#define w_p_scr w_onebuf_opt.wo_scr // 'scroll'
Bram Moolenaarf6196f42022-10-02 21:29:55 +0100265 int wo_sms;
266#define w_p_sms w_onebuf_opt.wo_sms // 'smoothscroll'
Bram Moolenaarb9a02fc2006-03-12 22:08:12 +0000267#ifdef FEAT_SPELL
Bram Moolenaar217ad922005-03-20 22:37:15 +0000268 int wo_spell;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200269# define w_p_spell w_onebuf_opt.wo_spell // 'spell'
Bram Moolenaarb9a02fc2006-03-12 22:08:12 +0000270#endif
Martin Tournoijba43e762022-10-13 22:12:15 +0100271#if defined(FEAT_SYN_HL) || defined(FEAT_FOLDING) || defined(FEAT_DIFF)
Bram Moolenaarb9a02fc2006-03-12 22:08:12 +0000272 int wo_cuc;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200273# define w_p_cuc w_onebuf_opt.wo_cuc // 'cursorcolumn'
Bram Moolenaarb9a02fc2006-03-12 22:08:12 +0000274 int wo_cul;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200275# define w_p_cul w_onebuf_opt.wo_cul // 'cursorline'
Bram Moolenaar410e98a2019-09-09 22:05:49 +0200276 char_u *wo_culopt;
277# define w_p_culopt w_onebuf_opt.wo_culopt // 'cursorlineopt'
Bram Moolenaar1a384422010-07-14 19:53:30 +0200278 char_u *wo_cc;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200279# define w_p_cc w_onebuf_opt.wo_cc // 'colorcolumn'
Bram Moolenaar217ad922005-03-20 22:37:15 +0000280#endif
Bram Moolenaaree857022019-11-09 23:26:40 +0100281#ifdef FEAT_LINEBREAK
282 char_u *wo_sbr;
283#define w_p_sbr w_onebuf_opt.wo_sbr // 'showbreak'
284#endif
Bram Moolenaarb5bf5b82004-12-24 14:35:23 +0000285#ifdef FEAT_STL_OPT
286 char_u *wo_stl;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200287#define w_p_stl w_onebuf_opt.wo_stl // 'statusline'
Bram Moolenaarb5bf5b82004-12-24 14:35:23 +0000288#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +0000289 int wo_scb;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200290#define w_p_scb w_onebuf_opt.wo_scb // 'scrollbind'
291 int wo_diff_saved; // options were saved for starting diff mode
Bram Moolenaar8a3bb562018-03-04 20:14:14 +0100292#define w_p_diff_saved w_onebuf_opt.wo_diff_saved
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200293 int wo_scb_save; // 'scrollbind' saved for diff mode
Bram Moolenaar8a3bb562018-03-04 20:14:14 +0100294#define w_p_scb_save w_onebuf_opt.wo_scb_save
Bram Moolenaar071d4272004-06-13 20:20:40 +0000295 int wo_wrap;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200296#define w_p_wrap w_onebuf_opt.wo_wrap // 'wrap'
Bram Moolenaara87aa802013-07-03 15:47:03 +0200297#ifdef FEAT_DIFF
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200298 int wo_wrap_save; // 'wrap' state saved for diff mode
Bram Moolenaara87aa802013-07-03 15:47:03 +0200299# define w_p_wrap_save w_onebuf_opt.wo_wrap_save
300#endif
Bram Moolenaar860cae12010-06-05 23:22:07 +0200301#ifdef FEAT_CONCEAL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200302 char_u *wo_cocu; // 'concealcursor'
Bram Moolenaarf5963f72010-07-23 22:10:27 +0200303# define w_p_cocu w_onebuf_opt.wo_cocu
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200304 long wo_cole; // 'conceallevel'
Bram Moolenaarf5963f72010-07-23 22:10:27 +0200305# define w_p_cole w_onebuf_opt.wo_cole
Bram Moolenaar860cae12010-06-05 23:22:07 +0200306#endif
Bram Moolenaar860cae12010-06-05 23:22:07 +0200307 int wo_crb;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200308#define w_p_crb w_onebuf_opt.wo_crb // 'cursorbind'
309 int wo_crb_save; // 'cursorbind' state saved for diff mode
Bram Moolenaar8a3bb562018-03-04 20:14:14 +0100310#define w_p_crb_save w_onebuf_opt.wo_crb_save
Bram Moolenaar95ec9d62016-08-12 18:29:59 +0200311#ifdef FEAT_SIGNS
312 char_u *wo_scl;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200313# define w_p_scl w_onebuf_opt.wo_scl // 'signcolumn'
Bram Moolenaar95ec9d62016-08-12 18:29:59 +0200314#endif
Christian Brabandt4a8eb6e2023-08-13 19:43:42 +0200315 long wo_siso;
316# define w_p_siso w_onebuf_opt.wo_siso // 'sidescrolloff' local value
317 long wo_so;
318# define w_p_so w_onebuf_opt.wo_so // 'scrolloff' local value
Bram Moolenaare4f25e42017-07-07 11:54:15 +0200319#ifdef FEAT_TERMINAL
Bram Moolenaare1fc5152018-04-21 19:49:08 +0200320 char_u *wo_twk;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200321# define w_p_twk w_onebuf_opt.wo_twk // 'termwinkey'
Bram Moolenaare1fc5152018-04-21 19:49:08 +0200322 char_u *wo_tws;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200323# define w_p_tws w_onebuf_opt.wo_tws // 'termwinsize'
Bram Moolenaare4f25e42017-07-07 11:54:15 +0200324#endif
Bram Moolenaar5e3cb7e2006-02-27 23:58:35 +0000325
326#ifdef FEAT_EVAL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200327 sctx_T wo_script_ctx[WV_COUNT]; // SCTXs for window-local options
Bram Moolenaarf29c1c62018-09-10 21:05:02 +0200328# define w_p_script_ctx w_onebuf_opt.wo_script_ctx
Bram Moolenaar5e3cb7e2006-02-27 23:58:35 +0000329#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +0000330} winopt_T;
331
332/*
333 * Window info stored with a buffer.
334 *
335 * Two types of info are kept for a buffer which are associated with a
336 * specific window:
337 * 1. Each window can have a different line number associated with a buffer.
338 * 2. The window-local options for a buffer work in a similar way.
339 * The window-info is kept in a list at b_wininfo. It is kept in
340 * most-recently-used order.
341 */
Bram Moolenaar1d2ba7f2006-02-14 22:29:30 +0000342struct wininfo_S
Bram Moolenaar071d4272004-06-13 20:20:40 +0000343{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200344 wininfo_T *wi_next; // next entry or NULL for last entry
345 wininfo_T *wi_prev; // previous entry or NULL for first entry
346 win_T *wi_win; // pointer to window that did set wi_fpos
347 pos_T wi_fpos; // last cursor position in the file
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200348 winopt_T wi_opt; // local window options
Dominique Pelle3276f582021-08-07 12:44:41 +0200349 int wi_optset; // TRUE when wi_opt has useful values
Bram Moolenaar071d4272004-06-13 20:20:40 +0000350#ifdef FEAT_FOLDING
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200351 int wi_fold_manual; // copy of w_fold_manual
352 garray_T wi_folds; // clone of w_folds
Bram Moolenaar071d4272004-06-13 20:20:40 +0000353#endif
LemonBoydb0ea7f2022-04-10 17:59:26 +0100354 int wi_changelistidx; // copy of w_changelistidx
Bram Moolenaar071d4272004-06-13 20:20:40 +0000355};
356
357/*
358 * Info used to pass info about a fold from the fold-detection code to the
359 * code that displays the foldcolumn.
360 */
361typedef struct foldinfo
362{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200363 int fi_level; // level of the fold; when this is zero the
364 // other fields are invalid
365 int fi_lnum; // line number where fold starts
366 int fi_low_level; // lowest fold level that starts in the same
367 // line
Bram Moolenaar071d4272004-06-13 20:20:40 +0000368} foldinfo_T;
369
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200370/*
371 * Structure to store info about the Visual area.
372 */
Bram Moolenaara23ccb82006-02-27 00:08:02 +0000373typedef struct
374{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200375 pos_T vi_start; // start pos of last VIsual
376 pos_T vi_end; // end position of last VIsual
377 int vi_mode; // VIsual_mode of last VIsual
378 colnr_T vi_curswant; // MAXCOL from w_curswant
Bram Moolenaara23ccb82006-02-27 00:08:02 +0000379} visualinfo_T;
380
Bram Moolenaar071d4272004-06-13 20:20:40 +0000381/*
Bram Moolenaar335437b2007-05-10 18:32:52 +0000382 * structures used for undo
Bram Moolenaar071d4272004-06-13 20:20:40 +0000383 */
384
Bram Moolenaarccae4672019-01-04 15:09:57 +0100385// One line saved for undo. After the NUL terminated text there might be text
386// properties, thus ul_len can be larger than STRLEN(ul_line) + 1.
387typedef struct {
388 char_u *ul_line; // text of the line
389 long ul_len; // length of the line including NUL, plus text
390 // properties
391} undoline_T;
392
Bram Moolenaar071d4272004-06-13 20:20:40 +0000393typedef struct u_entry u_entry_T;
394typedef struct u_header u_header_T;
395struct u_entry
396{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200397 u_entry_T *ue_next; // pointer to next entry in list
398 linenr_T ue_top; // number of line above undo block
399 linenr_T ue_bot; // number of line below undo block
400 linenr_T ue_lcount; // linecount when u_save called
401 undoline_T *ue_array; // array of lines in undo block
402 long ue_size; // number of lines in ue_array
Bram Moolenaarfecb6602007-10-01 20:54:15 +0000403#ifdef U_DEBUG
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200404 int ue_magic; // magic number to check allocation
Bram Moolenaarfecb6602007-10-01 20:54:15 +0000405#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +0000406};
407
408struct u_header
409{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200410 // The following have a pointer and a number. The number is used when
411 // reading the undo file in u_read_undo()
Bram Moolenaar83d09bb2010-06-01 19:58:08 +0200412 union {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200413 u_header_T *ptr; // pointer to next undo header in list
Bram Moolenaar83d09bb2010-06-01 19:58:08 +0200414 long seq;
415 } uh_next;
416 union {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200417 u_header_T *ptr; // pointer to previous header in list
Bram Moolenaar83d09bb2010-06-01 19:58:08 +0200418 long seq;
419 } uh_prev;
420 union {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200421 u_header_T *ptr; // pointer to next header for alt. redo
Bram Moolenaar83d09bb2010-06-01 19:58:08 +0200422 long seq;
423 } uh_alt_next;
424 union {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200425 u_header_T *ptr; // pointer to previous header for alt. redo
Bram Moolenaar83d09bb2010-06-01 19:58:08 +0200426 long seq;
427 } uh_alt_prev;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200428 long uh_seq; // sequence number, higher == newer undo
429 int uh_walk; // used by undo_time()
430 u_entry_T *uh_entry; // pointer to first entry
431 u_entry_T *uh_getbot_entry; // pointer to where ue_bot must be set
432 pos_T uh_cursor; // cursor position before saving
Bram Moolenaar071d4272004-06-13 20:20:40 +0000433 long uh_cursor_vcol;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200434 int uh_flags; // see below
435 pos_T uh_namedm[NMARKS]; // marks before undo/after redo
436 visualinfo_T uh_visual; // Visual areas before undo/after redo
437 time_T uh_time; // timestamp when the change was made
438 long uh_save_nr; // set when the file was saved after the
439 // changes in this block
Bram Moolenaarfecb6602007-10-01 20:54:15 +0000440#ifdef U_DEBUG
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200441 int uh_magic; // magic number to check allocation
Bram Moolenaarfecb6602007-10-01 20:54:15 +0000442#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +0000443};
444
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200445// values for uh_flags
446#define UH_CHANGED 0x01 // b_changed flag before undo/after redo
447#define UH_EMPTYBUF 0x02 // buffer was empty
Bram Moolenaar071d4272004-06-13 20:20:40 +0000448
449/*
Bram Moolenaar335437b2007-05-10 18:32:52 +0000450 * structures used in undo.c
Bram Moolenaar071d4272004-06-13 20:20:40 +0000451 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200452#define ALIGN_LONG // longword alignment and use filler byte
Bram Moolenaar30276f22019-01-24 17:59:39 +0100453#define ALIGN_SIZE (sizeof(long))
Bram Moolenaar071d4272004-06-13 20:20:40 +0000454
455#define ALIGN_MASK (ALIGN_SIZE - 1)
456
457typedef struct m_info minfo_T;
458
459/*
Bram Moolenaar2767c602010-05-16 13:56:06 +0200460 * structure used to link chunks in one of the free chunk lists.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000461 */
462struct m_info
463{
464#ifdef ALIGN_LONG
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200465 long_u m_size; // size of the chunk (including m_info)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000466#else
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200467 short_u m_size; // size of the chunk (including m_info)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000468#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200469 minfo_T *m_next; // pointer to next free chunk in the list
Bram Moolenaar071d4272004-06-13 20:20:40 +0000470};
471
472/*
Bram Moolenaar071d4272004-06-13 20:20:40 +0000473 * things used in memfile.c
474 */
475
476typedef struct block_hdr bhdr_T;
477typedef struct memfile memfile_T;
478typedef long blocknr_T;
479
480/*
Bram Moolenaarb05b10a2011-03-22 18:10:45 +0100481 * mf_hashtab_T is a chained hashtable with blocknr_T key and arbitrary
482 * structures as items. This is an intrusive data structure: we require
483 * that items begin with mf_hashitem_T which contains the key and linked
484 * list pointers. List of items in each bucket is doubly-linked.
485 */
486
487typedef struct mf_hashitem_S mf_hashitem_T;
488
489struct mf_hashitem_S
490{
491 mf_hashitem_T *mhi_next;
492 mf_hashitem_T *mhi_prev;
493 blocknr_T mhi_key;
494};
495
496#define MHT_INIT_SIZE 64
497
498typedef struct mf_hashtab_S
499{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200500 long_u mht_mask; // mask used for hash value (nr of items
501 // in array is "mht_mask" + 1)
502 long_u mht_count; // nr of items inserted into hashtable
503 mf_hashitem_T **mht_buckets; // points to mht_small_buckets or
504 //dynamically allocated array
505 mf_hashitem_T *mht_small_buckets[MHT_INIT_SIZE]; // initial buckets
506 char mht_fixed; // non-zero value forbids growth
Bram Moolenaarb05b10a2011-03-22 18:10:45 +0100507} mf_hashtab_T;
508
509/*
Bram Moolenaar071d4272004-06-13 20:20:40 +0000510 * for each (previously) used block in the memfile there is one block header.
511 *
512 * The block may be linked in the used list OR in the free list.
513 * The used blocks are also kept in hash lists.
514 *
515 * The used list is a doubly linked list, most recently used block first.
516 * The blocks in the used list have a block of memory allocated.
517 * mf_used_count is the number of pages in the used list.
518 * The hash lists are used to quickly find a block in the used list.
519 * The free list is a single linked list, not sorted.
520 * The blocks in the free list have no block of memory allocated and
521 * the contents of the block in the file (if any) is irrelevant.
522 */
523
524struct block_hdr
525{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200526 mf_hashitem_T bh_hashitem; // header for hash table and key
527#define bh_bnum bh_hashitem.mhi_key // block number, part of bh_hashitem
Bram Moolenaarb05b10a2011-03-22 18:10:45 +0100528
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200529 bhdr_T *bh_next; // next block_hdr in free or used list
530 bhdr_T *bh_prev; // previous block_hdr in used list
531 char_u *bh_data; // pointer to memory (for used block)
532 int bh_page_count; // number of pages in this block
Bram Moolenaar071d4272004-06-13 20:20:40 +0000533
534#define BH_DIRTY 1
535#define BH_LOCKED 2
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200536 char bh_flags; // BH_DIRTY or BH_LOCKED
Bram Moolenaar071d4272004-06-13 20:20:40 +0000537};
538
539/*
540 * when a block with a negative number is flushed to the file, it gets
541 * a positive number. Because the reference to the block is still the negative
542 * number, we remember the translation to the new positive number in the
543 * double linked trans lists. The structure is the same as the hash lists.
544 */
545typedef struct nr_trans NR_TRANS;
546
547struct nr_trans
548{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200549 mf_hashitem_T nt_hashitem; // header for hash table and key
550#define nt_old_bnum nt_hashitem.mhi_key // old, negative, number
Bram Moolenaarb05b10a2011-03-22 18:10:45 +0100551
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200552 blocknr_T nt_new_bnum; // new, positive, number
Bram Moolenaar071d4272004-06-13 20:20:40 +0000553};
554
Bram Moolenaar0a36fec2014-02-11 15:10:43 +0100555
556typedef struct buffblock buffblock_T;
557typedef struct buffheader buffheader_T;
558
Bram Moolenaar071d4272004-06-13 20:20:40 +0000559/*
560 * structure used to store one block of the stuff/redo/recording buffers
561 */
562struct buffblock
563{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200564 buffblock_T *b_next; // pointer to next buffblock
565 char_u b_str[1]; // contents (actually longer)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000566};
567
568/*
569 * header used for the stuff buffer and the redo buffer
570 */
571struct buffheader
572{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200573 buffblock_T bh_first; // first (dummy) block of list
574 buffblock_T *bh_curr; // buffblock for appending
575 int bh_index; // index for reading
576 int bh_space; // space in bh_curr for appending
Bram Moolenaar071d4272004-06-13 20:20:40 +0000577};
578
Bram Moolenaard4863aa2017-04-07 19:50:12 +0200579typedef struct
580{
581 buffheader_T sr_redobuff;
582 buffheader_T sr_old_redobuff;
583} save_redo_T;
584
Bram Moolenaar048d9d22023-05-06 22:21:11 +0100585typedef enum {
586 XP_PREFIX_NONE, // prefix not used
587 XP_PREFIX_NO, // "no" prefix for bool option
588 XP_PREFIX_INV, // "inv" prefix for bool option
589} xp_prefix_T;
590
Bram Moolenaar071d4272004-06-13 20:20:40 +0000591/*
592 * used for completion on the command line
593 */
594typedef struct expand
595{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200596 char_u *xp_pattern; // start of item to expand
Bram Moolenaard6beab02019-11-10 15:07:19 +0100597 int xp_context; // type of expansion
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200598 int xp_pattern_len; // bytes in xp_pattern before cursor
Bram Moolenaar048d9d22023-05-06 22:21:11 +0100599 xp_prefix_T xp_prefix;
Bram Moolenaar0a52df52019-08-18 22:26:31 +0200600#if defined(FEAT_EVAL)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200601 char_u *xp_arg; // completion function
602 sctx_T xp_script_ctx; // SCTX for completion function
Bram Moolenaar071d4272004-06-13 20:20:40 +0000603#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200604 int xp_backslash; // one of the XP_BS_ values
Bram Moolenaar8ada17c2006-01-19 22:16:24 +0000605#ifndef BACKSLASH_IN_FILENAME
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200606 int xp_shell; // TRUE for a shell command, more
607 // characters need to be escaped
Bram Moolenaar8ada17c2006-01-19 22:16:24 +0000608#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200609 int xp_numfiles; // number of files found by
610 // file name completion
Bram Moolenaard6beab02019-11-10 15:07:19 +0100611 int xp_col; // cursor position in line
zeertzjqe9ef3472023-08-17 23:57:05 +0200612 int xp_selected; // selected index in completion
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200613 char_u **xp_files; // list of files
614 char_u *xp_line; // text being completed
Bram Moolenaar5ff595d2022-08-26 22:36:41 +0100615#define EXPAND_BUF_LEN 256
616 char_u xp_buf[EXPAND_BUF_LEN]; // buffer for returned match
Bram Moolenaar071d4272004-06-13 20:20:40 +0000617} expand_T;
618
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200619/*
620 * values for xp_backslash
621 */
622#define XP_BS_NONE 0 // nothing special for backslashes
623#define XP_BS_ONE 1 // uses one backslash before a space
624#define XP_BS_THREE 2 // uses three backslashes before a space
Bram Moolenaar071d4272004-06-13 20:20:40 +0000625
626/*
Bram Moolenaar66b51422019-08-18 21:44:12 +0200627 * Variables shared between getcmdline(), redrawcmdline() and others.
628 * These need to be saved when using CTRL-R |, that's why they are in a
629 * structure.
630 */
631typedef struct
632{
Bram Moolenaar4aea03e2019-09-25 22:37:17 +0200633 char_u *cmdbuff; // pointer to command line buffer
634 int cmdbufflen; // length of cmdbuff
635 int cmdlen; // number of chars in command line
636 int cmdpos; // current cursor position
637 int cmdspos; // cursor column on screen
638 int cmdfirstc; // ':', '/', '?', '=', '>' or NUL
639 int cmdindent; // number of spaces before cmdline
640 char_u *cmdprompt; // message in front of cmdline
641 int cmdattr; // attributes for prompt
642 int overstrike; // Typing mode on the command line. Shared by
643 // getcmdline() and put_on_cmdline().
644 expand_T *xpc; // struct being used for expansion, xp_pattern
645 // may point into cmdbuff
646 int xp_context; // type of expansion
Bram Moolenaar66b51422019-08-18 21:44:12 +0200647# ifdef FEAT_EVAL
Bram Moolenaar4aea03e2019-09-25 22:37:17 +0200648 char_u *xp_arg; // user-defined expansion arg
649 int input_fn; // when TRUE Invoked for input() function
Bram Moolenaar66b51422019-08-18 21:44:12 +0200650# endif
651} cmdline_info_T;
652
653/*
Bram Moolenaar071d4272004-06-13 20:20:40 +0000654 * Command modifiers ":vertical", ":browse", ":confirm" and ":hide" set a flag.
655 * This needs to be saved for recursive commands, put them in a structure for
656 * easy manipulation.
657 */
658typedef struct
659{
Bram Moolenaare1004402020-10-24 20:49:43 +0200660 int cmod_flags; // CMOD_ flags
661#define CMOD_SANDBOX 0x0001 // ":sandbox"
662#define CMOD_SILENT 0x0002 // ":silent"
663#define CMOD_ERRSILENT 0x0004 // ":silent!"
664#define CMOD_UNSILENT 0x0008 // ":unsilent"
665#define CMOD_NOAUTOCMD 0x0010 // ":noautocmd"
666#define CMOD_HIDE 0x0020 // ":hide"
667#define CMOD_BROWSE 0x0040 // ":browse" - invoke file dialog
668#define CMOD_CONFIRM 0x0080 // ":confirm" - invoke yes/no dialog
669#define CMOD_KEEPALT 0x0100 // ":keepalt"
670#define CMOD_KEEPMARKS 0x0200 // ":keepmarks"
671#define CMOD_KEEPJUMPS 0x0400 // ":keepjumps"
672#define CMOD_LOCKMARKS 0x0800 // ":lockmarks"
673#define CMOD_KEEPPATTERNS 0x1000 // ":keeppatterns"
674#define CMOD_NOSWAPFILE 0x2000 // ":noswapfile"
Bram Moolenaar39f3b142021-02-14 12:57:36 +0100675#define CMOD_VIM9CMD 0x4000 // ":vim9cmd"
Bram Moolenaar96cf4ba2021-04-24 14:15:41 +0200676#define CMOD_LEGACY 0x8000 // ":legacy"
Bram Moolenaare1004402020-10-24 20:49:43 +0200677
678 int cmod_split; // flags for win_split()
679 int cmod_tab; // > 0 when ":tab" was used
680 regmatch_T cmod_filter_regmatch; // set by :filter /pat/
681 int cmod_filter_force; // set for :filter!
Bram Moolenaar5661ed62020-10-24 17:19:16 +0200682
zeertzjqcd749632022-06-14 13:30:35 +0100683 int cmod_verbose; // 0 if not set, > 0 to set 'verbose'
684 // to cmod_verbose - 1
Bram Moolenaar5661ed62020-10-24 17:19:16 +0200685
686 // values for undo_cmdmod()
687 char_u *cmod_save_ei; // saved value of 'eventignore'
688#ifdef HAVE_SANDBOX
689 int cmod_did_sandbox; // set when "sandbox" was incremented
690#endif
691 long cmod_verbose_save; // if 'verbose' was set: value of
692 // p_verbose plus one
693 int cmod_save_msg_silent; // if non-zero: saved value of
694 // msg_silent + 1
Bram Moolenaare1004402020-10-24 20:49:43 +0200695 int cmod_save_msg_scroll; // for restoring msg_scroll
Bram Moolenaar5661ed62020-10-24 17:19:16 +0200696 int cmod_did_esilent; // incremented when emsg_silent is
Bram Moolenaar071d4272004-06-13 20:20:40 +0000697} cmdmod_T;
698
Bram Moolenaar3a2a60c2023-05-27 18:02:55 +0100699typedef enum {
700 MF_DIRTY_NO = 0, // no dirty blocks
701 MF_DIRTY_YES, // there are dirty blocks
702 MF_DIRTY_YES_NOSYNC, // there are dirty blocks, do not sync yet
703} mfdirty_T;
704
Bram Moolenaara8ffcbb2010-06-21 06:15:46 +0200705#define MF_SEED_LEN 8
Bram Moolenaar071d4272004-06-13 20:20:40 +0000706
707struct memfile
708{
Bram Moolenaarb58a4b92019-05-27 23:36:21 +0200709 char_u *mf_fname; // name of the file
710 char_u *mf_ffname; // idem, full path
711 int mf_fd; // file descriptor
712 int mf_flags; // flags used when opening this memfile
713 int mf_reopen; // mf_fd was closed, retry opening
714 bhdr_T *mf_free_first; // first block_hdr in free list
715 bhdr_T *mf_used_first; // mru block_hdr in used list
716 bhdr_T *mf_used_last; // lru block_hdr in used list
717 unsigned mf_used_count; // number of pages in used list
718 unsigned mf_used_count_max; // maximum number of pages in memory
719 mf_hashtab_T mf_hash; // hash lists
720 mf_hashtab_T mf_trans; // trans lists
721 blocknr_T mf_blocknr_max; // highest positive block number + 1
722 blocknr_T mf_blocknr_min; // lowest negative block number - 1
723 blocknr_T mf_neg_count; // number of negative blocks numbers
724 blocknr_T mf_infile_count; // number of pages in the file
725 unsigned mf_page_size; // number of bytes in a page
Bram Moolenaar3a2a60c2023-05-27 18:02:55 +0100726 mfdirty_T mf_dirty;
Bram Moolenaara8ffcbb2010-06-21 06:15:46 +0200727#ifdef FEAT_CRYPT
Bram Moolenaarb58a4b92019-05-27 23:36:21 +0200728 buf_T *mf_buffer; // buffer this memfile is for
729 char_u mf_seed[MF_SEED_LEN]; // seed for encryption
Bram Moolenaara8ffcbb2010-06-21 06:15:46 +0200730
Bram Moolenaarb58a4b92019-05-27 23:36:21 +0200731 // Values for key, method and seed used for reading data blocks when
732 // updating for a newly set key or method. Only when mf_old_key != NULL.
Bram Moolenaara8ffcbb2010-06-21 06:15:46 +0200733 char_u *mf_old_key;
734 int mf_old_cm;
735 char_u mf_old_seed[MF_SEED_LEN];
736#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +0000737};
738
739/*
740 * things used in memline.c
741 */
742/*
743 * When searching for a specific line, we remember what blocks in the tree
744 * are the branches leading to that block. This is stored in ml_stack. Each
745 * entry is a pointer to info in a block (may be data block or pointer block)
746 */
747typedef struct info_pointer
748{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200749 blocknr_T ip_bnum; // block number
750 linenr_T ip_low; // lowest lnum in this block
751 linenr_T ip_high; // highest lnum in this block
752 int ip_index; // index for block with current lnum
753} infoptr_T; // block/index pair
Bram Moolenaar071d4272004-06-13 20:20:40 +0000754
755#ifdef FEAT_BYTEOFF
756typedef struct ml_chunksize
757{
758 int mlcs_numlines;
759 long mlcs_totalsize;
760} chunksize_T;
761
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200762/*
763 * Flags when calling ml_updatechunk()
764 */
765# define ML_CHNK_ADDLINE 1
766# define ML_CHNK_DELLINE 2
767# define ML_CHNK_UPDLINE 3
Bram Moolenaar071d4272004-06-13 20:20:40 +0000768#endif
769
770/*
771 * the memline structure holds all the information about a memline
772 */
773typedef struct memline
774{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200775 linenr_T ml_line_count; // number of lines in the buffer
Bram Moolenaar071d4272004-06-13 20:20:40 +0000776
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200777 memfile_T *ml_mfp; // pointer to associated memfile
Bram Moolenaar071d4272004-06-13 20:20:40 +0000778
Bram Moolenaard6beab02019-11-10 15:07:19 +0100779 infoptr_T *ml_stack; // stack of pointer blocks (array of IPTRs)
780 int ml_stack_top; // current top of ml_stack
781 int ml_stack_size; // total number of entries in ml_stack
782
Bram Moolenaarfa4873c2022-06-30 22:13:59 +0100783#define ML_EMPTY 0x01 // empty buffer
784#define ML_LINE_DIRTY 0x02 // cached line was changed and allocated
785#define ML_LOCKED_DIRTY 0x04 // ml_locked was changed
786#define ML_LOCKED_POS 0x08 // ml_locked needs positive block number
787#define ML_ALLOCATED 0x10 // ml_line_ptr is an allocated copy
Bram Moolenaar071d4272004-06-13 20:20:40 +0000788 int ml_flags;
789
Bram Moolenaard6beab02019-11-10 15:07:19 +0100790 colnr_T ml_line_len; // length of the cached line, including NUL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200791 linenr_T ml_line_lnum; // line number of cached line, 0 if not valid
792 char_u *ml_line_ptr; // pointer to cached line
Bram Moolenaar071d4272004-06-13 20:20:40 +0000793
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200794 bhdr_T *ml_locked; // block used by last ml_get
795 linenr_T ml_locked_low; // first line in ml_locked
796 linenr_T ml_locked_high; // last line in ml_locked
797 int ml_locked_lineadd; // number of lines inserted in ml_locked
Bram Moolenaar071d4272004-06-13 20:20:40 +0000798#ifdef FEAT_BYTEOFF
799 chunksize_T *ml_chunksize;
800 int ml_numchunks;
801 int ml_usedchunks;
802#endif
803} memline_T;
804
Bram Moolenaara9d4b842020-05-30 14:46:52 +0200805// Values for the flags argument of ml_delete_flags().
806#define ML_DEL_MESSAGE 1 // may give a "No lines in buffer" message
807#define ML_DEL_UNDO 2 // called from undo, do not update textprops
Bram Moolenaar4cd5c522021-06-27 13:04:00 +0200808#define ML_DEL_NOPROP 4 // splitting data block, do not update textprops
Bram Moolenaara9d4b842020-05-30 14:46:52 +0200809
810// Values for the flags argument of ml_append_int().
811#define ML_APPEND_NEW 1 // starting to edit a new file
812#define ML_APPEND_MARK 2 // mark the new line
813#define ML_APPEND_UNDO 4 // called from undo
Bram Moolenaar840f91f2021-05-26 22:32:10 +0200814#define ML_APPEND_NOPROP 8 // do not continue textprop from previous line
Bram Moolenaara9d4b842020-05-30 14:46:52 +0200815
Bram Moolenaar98aefe72018-12-13 22:20:09 +0100816
817/*
818 * Structure defining text properties. These stick with the text.
819 * When stored in memline they are after the text, ml_line_len is larger than
820 * STRLEN(ml_line_ptr) + 1.
821 */
822typedef struct textprop_S
823{
Bram Moolenaarb9c67a52019-01-01 19:49:20 +0100824 colnr_T tp_col; // start column (one based, in bytes)
Bram Moolenaarf396ce82022-08-23 18:39:37 +0100825 colnr_T tp_len; // length in bytes, when tp_id is negative used
826 // for left padding plus one
Bram Moolenaar98aefe72018-12-13 22:20:09 +0100827 int tp_id; // identifier
828 int tp_type; // property type
829 int tp_flags; // TP_FLAG_ values
Yegappan Lakshmanan171c5b92023-08-22 21:48:50 +0200830 int tp_padleft; // left padding between text line and virtual
831 // text
Bram Moolenaar98aefe72018-12-13 22:20:09 +0100832} textprop_T;
833
Bram Moolenaar7f9969c2022-07-25 18:13:54 +0100834#define TP_FLAG_CONT_NEXT 0x1 // property continues in next line
835#define TP_FLAG_CONT_PREV 0x2 // property was continued from prev line
Bram Moolenaarb7963df2022-07-31 17:12:43 +0100836
837// without these text is placed after the end of the line
Bram Moolenaar04e0ed12022-09-10 20:00:56 +0100838#define TP_FLAG_ALIGN_RIGHT 0x010 // virtual text is right-aligned
839#define TP_FLAG_ALIGN_ABOVE 0x020 // virtual text above the line
840#define TP_FLAG_ALIGN_BELOW 0x040 // virtual text on next screen line
Bram Moolenaarb7963df2022-07-31 17:12:43 +0100841
Bram Moolenaar04e0ed12022-09-10 20:00:56 +0100842#define TP_FLAG_WRAP 0x080 // virtual text wraps - when missing
Bram Moolenaarb7963df2022-07-31 17:12:43 +0100843 // text is truncated
Bram Moolenaar04e0ed12022-09-10 20:00:56 +0100844#define TP_FLAG_START_INCL 0x100 // "start_incl" copied from proptype
Bram Moolenaar28c9f892022-08-14 13:28:55 +0100845
dundargocc57b5bc2022-11-02 13:30:51 +0000846#define PROP_TEXT_MIN_CELLS 4 // minimum number of cells to use for
Bram Moolenaar398649e2022-08-04 15:03:48 +0100847 // the text, even when truncating
Bram Moolenaar98aefe72018-12-13 22:20:09 +0100848
849/*
850 * Structure defining a property type.
851 */
852typedef struct proptype_S
853{
854 int pt_id; // value used for tp_id
855 int pt_type; // number used for tp_type
856 int pt_hl_id; // highlighting
857 int pt_priority; // priority
858 int pt_flags; // PT_FLAG_ values
859 char_u pt_name[1]; // property type name, actually longer
860} proptype_T;
861
862#define PT_FLAG_INS_START_INCL 1 // insert at start included in property
863#define PT_FLAG_INS_END_INCL 2 // insert at end included in property
Bram Moolenaarde24a872019-05-05 15:48:00 +0200864#define PT_FLAG_COMBINE 4 // combine with syntax highlight
Bram Moolenaarf4ba8bc2022-08-05 17:05:04 +0100865#define PT_FLAG_OVERRIDE 8 // override any highlight
Bram Moolenaar98aefe72018-12-13 22:20:09 +0100866
Bram Moolenaar7a2d9892018-12-24 20:23:49 +0100867// Sign group
868typedef struct signgroup_S
869{
Bram Moolenaar6656c2e2019-10-24 15:00:04 +0200870 int sg_next_sign_id; // next sign id for this group
871 short_u sg_refcount; // number of signs in this group
Bram Moolenaar47ed5532019-08-08 20:49:14 +0200872 char_u sg_name[1]; // sign group name, actually longer
Bram Moolenaar7a2d9892018-12-24 20:23:49 +0100873} signgroup_T;
874
Bram Moolenaar6656c2e2019-10-24 15:00:04 +0200875typedef struct sign_entry sign_entry_T;
876struct sign_entry
Bram Moolenaar071d4272004-06-13 20:20:40 +0000877{
Bram Moolenaar6656c2e2019-10-24 15:00:04 +0200878 int se_id; // unique identifier for each placed sign
Bram Moolenaar6656c2e2019-10-24 15:00:04 +0200879 int se_typenr; // typenr of sign
Bram Moolenaar6656c2e2019-10-24 15:00:04 +0200880 int se_priority; // priority for highlighting
Bram Moolenaard6beab02019-11-10 15:07:19 +0100881 linenr_T se_lnum; // line number which has this sign
882 signgroup_T *se_group; // sign group
Bram Moolenaar6656c2e2019-10-24 15:00:04 +0200883 sign_entry_T *se_next; // next entry in a list of signs
884 sign_entry_T *se_prev; // previous entry -- for easy reordering
Bram Moolenaar071d4272004-06-13 20:20:40 +0000885};
886
Bram Moolenaar4e038572019-07-04 18:28:35 +0200887/*
888 * Sign attributes. Used by the screen refresh routines.
889 */
890typedef struct sign_attrs_S {
Bram Moolenaar6656c2e2019-10-24 15:00:04 +0200891 int sat_typenr;
892 void *sat_icon;
893 char_u *sat_text;
894 int sat_texthl;
895 int sat_linehl;
Bram Moolenaare413ea02021-11-24 16:20:13 +0000896 int sat_culhl;
James McCoya80aad72021-12-22 19:45:28 +0000897 int sat_numhl;
Bram Moolenaar39f7aa32020-08-31 22:00:05 +0200898 int sat_priority;
Bram Moolenaar4e038572019-07-04 18:28:35 +0200899} sign_attrs_T;
900
Bram Moolenaarced198d2018-12-29 20:04:40 +0100901#if defined(FEAT_SIGNS) || defined(PROTO)
902// Macros to get the sign group structure from the group name
903#define SGN_KEY_OFF offsetof(signgroup_T, sg_name)
904#define HI2SG(hi) ((signgroup_T *)((hi)->hi_key - SGN_KEY_OFF))
905
Bram Moolenaar162b7142018-12-21 15:17:36 +0100906// Default sign priority for highlighting
907#define SIGN_DEF_PRIO 10
908
Bram Moolenaar071d4272004-06-13 20:20:40 +0000909#endif
910
911/*
912 * Argument list: Array of file names.
913 * Used for the global argument list and the argument lists local to a window.
914 */
915typedef struct arglist
916{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200917 garray_T al_ga; // growarray with the array of file names
918 int al_refcount; // number of windows using this arglist
919 int id; // id of this arglist
Bram Moolenaar071d4272004-06-13 20:20:40 +0000920} alist_T;
921
922/*
923 * For each argument remember the file name as it was given, and the buffer
924 * number that contains the expanded file name (required for when ":cd" is
Bram Moolenaard6beab02019-11-10 15:07:19 +0100925 * used).
Bram Moolenaar071d4272004-06-13 20:20:40 +0000926 */
927typedef struct argentry
928{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200929 char_u *ae_fname; // file name as specified
930 int ae_fnum; // buffer number with expanded file name
Bram Moolenaar071d4272004-06-13 20:20:40 +0000931} aentry_T;
932
Bram Moolenaar4033c552017-09-16 20:54:51 +0200933#define ALIST(win) (win)->w_alist
Bram Moolenaar071d4272004-06-13 20:20:40 +0000934#define GARGLIST ((aentry_T *)global_alist.al_ga.ga_data)
935#define ARGLIST ((aentry_T *)ALIST(curwin)->al_ga.ga_data)
936#define WARGLIST(wp) ((aentry_T *)ALIST(wp)->al_ga.ga_data)
937#define AARGLIST(al) ((aentry_T *)((al)->al_ga.ga_data))
938#define GARGCOUNT (global_alist.al_ga.ga_len)
939#define ARGCOUNT (ALIST(curwin)->al_ga.ga_len)
940#define WARGCOUNT(wp) (ALIST(wp)->al_ga.ga_len)
941
942/*
943 * A list used for saving values of "emsg_silent". Used by ex_try() to save the
944 * value of "emsg_silent" if it was non-zero. When this is done, the CSF_SILENT
945 * flag below is set.
946 */
947
948typedef struct eslist_elem eslist_T;
949struct eslist_elem
950{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200951 int saved_emsg_silent; // saved value of "emsg_silent"
952 eslist_T *next; // next element on the list
Bram Moolenaar071d4272004-06-13 20:20:40 +0000953};
954
955/*
956 * For conditional commands a stack is kept of nested conditionals.
957 * When cs_idx < 0, there is no conditional command.
958 */
959#define CSTACK_LEN 50
960
Bram Moolenaarddef1292019-12-16 17:10:33 +0100961typedef struct {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200962 short cs_flags[CSTACK_LEN]; // CSF_ flags
963 char cs_pending[CSTACK_LEN]; // CSTP_: what's pending in ":finally"
Bram Moolenaar071d4272004-06-13 20:20:40 +0000964 union {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200965 void *csp_rv[CSTACK_LEN]; // return typeval for pending return
966 void *csp_ex[CSTACK_LEN]; // exception for pending throw
Bram Moolenaar071d4272004-06-13 20:20:40 +0000967 } cs_pend;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200968 void *cs_forinfo[CSTACK_LEN]; // info used by ":for"
969 int cs_line[CSTACK_LEN]; // line nr of ":while"/":for" line
Bram Moolenaar8d739de2020-10-14 19:39:19 +0200970 int cs_block_id[CSTACK_LEN]; // block ID stack
Bram Moolenaarfcdc5d82020-10-10 19:07:09 +0200971 int cs_script_var_len[CSTACK_LEN]; // value of sn_var_vals.ga_len
972 // when entering the block
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200973 int cs_idx; // current entry, or -1 if none
974 int cs_looplevel; // nr of nested ":while"s and ":for"s
975 int cs_trylevel; // nr of nested ":try"s
976 eslist_T *cs_emsg_silent_list; // saved values of "emsg_silent"
977 char cs_lflags; // loop flags: CSL_ flags
Bram Moolenaarddef1292019-12-16 17:10:33 +0100978} cstack_T;
Bram Moolenaar12805862005-01-05 22:16:17 +0000979# define cs_rettv cs_pend.csp_rv
980# define cs_exception cs_pend.csp_ex
Bram Moolenaar071d4272004-06-13 20:20:40 +0000981
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200982// There is no CSF_IF, the lack of CSF_WHILE, CSF_FOR and CSF_TRY means ":if"
983// was used.
984# define CSF_TRUE 0x0001 // condition was TRUE
985# define CSF_ACTIVE 0x0002 // current state is active
986# define CSF_ELSE 0x0004 // ":else" has been passed
987# define CSF_WHILE 0x0008 // is a ":while"
988# define CSF_FOR 0x0010 // is a ":for"
Bram Moolenaar9becdf22020-10-10 21:33:48 +0200989# define CSF_BLOCK 0x0020 // is a "{" block
Bram Moolenaar12805862005-01-05 22:16:17 +0000990
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200991# define CSF_TRY 0x0100 // is a ":try"
992# define CSF_FINALLY 0x0200 // ":finally" has been passed
Bram Moolenaar41978282021-07-04 14:47:30 +0200993# define CSF_CATCH 0x0400 // ":catch" has been seen
994# define CSF_THROWN 0x0800 // exception thrown to this try conditional
995# define CSF_CAUGHT 0x1000 // exception caught by this try conditional
Bram Moolenaarf67d3fb2021-10-05 11:22:27 +0100996# define CSF_FINISHED 0x2000 // CSF_CAUGHT was handled by finish_exception()
997# define CSF_SILENT 0x4000 // "emsg_silent" reset by ":try"
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200998// Note that CSF_ELSE is only used when CSF_TRY and CSF_WHILE are unset
999// (an ":if"), and CSF_SILENT is only used when CSF_TRY is set.
Bram Moolenaarf67d3fb2021-10-05 11:22:27 +01001000
1001# define CSF_FUNC_DEF 0x8000 // a function was defined in this block
Bram Moolenaar071d4272004-06-13 20:20:40 +00001002
1003/*
1004 * What's pending for being reactivated at the ":endtry" of this try
1005 * conditional:
1006 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001007# define CSTP_NONE 0 // nothing pending in ":finally" clause
1008# define CSTP_ERROR 1 // an error is pending
1009# define CSTP_INTERRUPT 2 // an interrupt is pending
1010# define CSTP_THROW 4 // a throw is pending
1011# define CSTP_BREAK 8 // ":break" is pending
1012# define CSTP_CONTINUE 16 // ":continue" is pending
1013# define CSTP_RETURN 24 // ":return" is pending
1014# define CSTP_FINISH 32 // ":finish" is pending
Bram Moolenaar071d4272004-06-13 20:20:40 +00001015
1016/*
Bram Moolenaarddef1292019-12-16 17:10:33 +01001017 * Flags for the cs_lflags item in cstack_T.
Bram Moolenaar12805862005-01-05 22:16:17 +00001018 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001019# define CSL_HAD_LOOP 1 // just found ":while" or ":for"
1020# define CSL_HAD_ENDLOOP 2 // just found ":endwhile" or ":endfor"
1021# define CSL_HAD_CONT 4 // just found ":continue"
1022# define CSL_HAD_FINA 8 // just found ":finally"
Bram Moolenaar12805862005-01-05 22:16:17 +00001023
1024/*
Bram Moolenaar071d4272004-06-13 20:20:40 +00001025 * A list of error messages that can be converted to an exception. "throw_msg"
1026 * is only set in the first element of the list. Usually, it points to the
1027 * original message stored in that element, but sometimes it points to a later
Bram Moolenaar25e0f582020-05-25 22:36:50 +02001028 * message in the list. See cause_errthrow().
Bram Moolenaar071d4272004-06-13 20:20:40 +00001029 */
Bram Moolenaar25e0f582020-05-25 22:36:50 +02001030typedef struct msglist msglist_T;
Bram Moolenaar071d4272004-06-13 20:20:40 +00001031struct msglist
1032{
Bram Moolenaare8c46602021-04-05 22:27:37 +02001033 msglist_T *next; // next of several messages in a row
Bram Moolenaar25e0f582020-05-25 22:36:50 +02001034 char *msg; // original message, allocated
1035 char *throw_msg; // msg to throw: usually original one
1036 char_u *sfile; // value from estack_sfile(), allocated
1037 long slnum; // line number for "sfile"
Bram Moolenaare8c46602021-04-05 22:27:37 +02001038 int msg_compiling; // saved value of estack_compiling
Bram Moolenaar071d4272004-06-13 20:20:40 +00001039};
1040
1041/*
Bram Moolenaar8a5883b2016-11-10 20:20:05 +01001042 * The exception types.
1043 */
1044typedef enum
1045{
Bram Moolenaarea3ece42018-04-17 20:14:39 +02001046 ET_USER, // exception caused by ":throw" command
1047 ET_ERROR, // error exception
1048 ET_INTERRUPT, // interrupt exception triggered by Ctrl-C
Bram Moolenaar8a5883b2016-11-10 20:20:05 +01001049} except_type_T;
1050
1051/*
Bram Moolenaar071d4272004-06-13 20:20:40 +00001052 * Structure describing an exception.
1053 * (don't use "struct exception", it's used by the math library).
1054 */
1055typedef struct vim_exception except_T;
1056struct vim_exception
1057{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001058 except_type_T type; // exception type
1059 char *value; // exception value
1060 struct msglist *messages; // message(s) causing error exception
1061 char_u *throw_name; // name of the throw point
1062 linenr_T throw_lnum; // line number of the throw point
1063 except_T *caught; // next exception on the caught stack
Bram Moolenaar071d4272004-06-13 20:20:40 +00001064};
1065
1066/*
Bram Moolenaarc0197e22004-09-13 20:26:32 +00001067 * Structure to save the error/interrupt/exception state between calls to
1068 * enter_cleanup() and leave_cleanup(). Must be allocated as an automatic
1069 * variable by the (common) caller of these functions.
1070 */
1071typedef struct cleanup_stuff cleanup_T;
1072struct cleanup_stuff
1073{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001074 int pending; // error/interrupt/exception state
1075 except_T *exception; // exception value
Bram Moolenaarc0197e22004-09-13 20:26:32 +00001076};
Bram Moolenaar071d4272004-06-13 20:20:40 +00001077
1078#ifdef FEAT_SYN_HL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001079// struct passed to in_id_list()
Bram Moolenaar071d4272004-06-13 20:20:40 +00001080struct sp_syn
1081{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001082 int inc_tag; // ":syn include" unique tag
1083 short id; // highlight group ID of item
1084 short *cont_in_list; // cont.in group IDs, if non-zero
Bram Moolenaar071d4272004-06-13 20:20:40 +00001085};
1086
1087/*
1088 * Each keyword has one keyentry, which is linked in a hash list.
1089 */
1090typedef struct keyentry keyentry_T;
1091
1092struct keyentry
1093{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001094 keyentry_T *ke_next; // next entry with identical "keyword[]"
1095 struct sp_syn k_syn; // struct passed to in_id_list()
1096 short *next_list; // ID list for next match (if non-zero)
Bram Moolenaar860cae12010-06-05 23:22:07 +02001097 int flags;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001098 int k_char; // conceal substitute character
1099 char_u keyword[1]; // actually longer
Bram Moolenaar071d4272004-06-13 20:20:40 +00001100};
1101
1102/*
1103 * Struct used to store one state of the state stack.
1104 */
1105typedef struct buf_state
1106{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001107 int bs_idx; // index of pattern
1108 int bs_flags; // flags for pattern
Bram Moolenaar6e202e52010-07-28 18:14:45 +02001109#ifdef FEAT_CONCEAL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001110 int bs_seqnr; // stores si_seqnr
1111 int bs_cchar; // stores si_cchar
Bram Moolenaar6e202e52010-07-28 18:14:45 +02001112#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001113 reg_extmatch_T *bs_extmatch; // external matches from start pattern
Bram Moolenaar071d4272004-06-13 20:20:40 +00001114} bufstate_T;
1115
1116/*
1117 * syn_state contains the syntax state stack for the start of one line.
1118 * Used by b_sst_array[].
1119 */
1120typedef struct syn_state synstate_T;
1121
1122struct syn_state
1123{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001124 synstate_T *sst_next; // next entry in used or free list
1125 linenr_T sst_lnum; // line number for this state
Bram Moolenaar071d4272004-06-13 20:20:40 +00001126 union
1127 {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001128 bufstate_T sst_stack[SST_FIX_STATES]; // short state stack
1129 garray_T sst_ga; // growarray for long state stack
Bram Moolenaar071d4272004-06-13 20:20:40 +00001130 } sst_union;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001131 int sst_next_flags; // flags for sst_next_list
1132 int sst_stacksize; // number of states on the stack
1133 short *sst_next_list; // "nextgroup" list in this state
1134 // (this is a copy, don't free it!
1135 disptick_T sst_tick; // tick when last displayed
1136 linenr_T sst_change_lnum;// when non-zero, change in this line
1137 // may have made the state invalid
Bram Moolenaar071d4272004-06-13 20:20:40 +00001138};
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001139#endif // FEAT_SYN_HL
Bram Moolenaar071d4272004-06-13 20:20:40 +00001140
Bram Moolenaarf9cc9f22019-07-14 21:29:22 +02001141#define MAX_HL_ID 20000 // maximum value for a highlight ID.
1142
1143/*
Bram Moolenaar071d4272004-06-13 20:20:40 +00001144 * Structure shared between syntax.c, screen.c and gui_x11.c.
1145 */
1146typedef struct attr_entry
1147{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001148 short ae_attr; // HL_BOLD, etc.
Bram Moolenaar071d4272004-06-13 20:20:40 +00001149 union
1150 {
1151 struct
1152 {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001153 char_u *start; // start escape sequence
1154 char_u *stop; // stop escape sequence
Bram Moolenaar071d4272004-06-13 20:20:40 +00001155 } term;
1156 struct
1157 {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001158 // These colors need to be > 8 bits to hold 256.
1159 short_u fg_color; // foreground color number
1160 short_u bg_color; // background color number
Bram Moolenaare023e882020-05-31 16:42:30 +02001161 short_u ul_color; // underline color number
Bram Moolenaar61be73b2016-04-29 22:59:22 +02001162# ifdef FEAT_TERMGUICOLORS
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001163 guicolor_T fg_rgb; // foreground color RGB
1164 guicolor_T bg_rgb; // background color RGB
Bram Moolenaare023e882020-05-31 16:42:30 +02001165 guicolor_T ul_rgb; // underline color RGB
Bram Moolenaar8a633e32016-04-21 21:10:14 +02001166# endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00001167 } cterm;
1168# ifdef FEAT_GUI
1169 struct
1170 {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001171 guicolor_T fg_color; // foreground color handle
1172 guicolor_T bg_color; // background color handle
1173 guicolor_T sp_color; // special color handle
1174 GuiFont font; // font handle
Bram Moolenaar071d4272004-06-13 20:20:40 +00001175# ifdef FEAT_XFONTSET
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001176 GuiFontset fontset; // fontset handle
Bram Moolenaar071d4272004-06-13 20:20:40 +00001177# endif
1178 } gui;
1179# endif
1180 } ae_u;
1181} attrentry_T;
1182
1183#ifdef USE_ICONV
1184# ifdef HAVE_ICONV_H
1185# include <iconv.h>
1186# else
1187# if defined(MACOS_X)
1188# include <sys/errno.h>
Bram Moolenaard0573012017-10-28 21:11:06 +02001189# ifndef EILSEQ
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001190# define EILSEQ ENOENT // Early MacOS X does not have EILSEQ
Bram Moolenaard0573012017-10-28 21:11:06 +02001191# endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00001192typedef struct _iconv_t *iconv_t;
1193# else
Bram Moolenaard0573012017-10-28 21:11:06 +02001194# include <errno.h>
Bram Moolenaar071d4272004-06-13 20:20:40 +00001195# endif
1196typedef void *iconv_t;
1197# endif
1198#endif
1199
1200/*
1201 * Used for the typeahead buffer: typebuf.
1202 */
1203typedef struct
1204{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001205 char_u *tb_buf; // buffer for typed characters
1206 char_u *tb_noremap; // mapping flags for characters in tb_buf[]
1207 int tb_buflen; // size of tb_buf[]
1208 int tb_off; // current position in tb_buf[]
1209 int tb_len; // number of valid bytes in tb_buf[]
1210 int tb_maplen; // nr of mapped bytes in tb_buf[]
1211 int tb_silent; // nr of silently mapped bytes in tb_buf[]
1212 int tb_no_abbr_cnt; // nr of bytes without abbrev. in tb_buf[]
1213 int tb_change_cnt; // nr of time tb_buf was changed; never zero
Bram Moolenaar071d4272004-06-13 20:20:40 +00001214} typebuf_T;
1215
Bram Moolenaar9bf703d2019-11-30 19:44:38 +01001216// Struct to hold the saved typeahead for save_typeahead().
Bram Moolenaar071d4272004-06-13 20:20:40 +00001217typedef struct
1218{
1219 typebuf_T save_typebuf;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001220 int typebuf_valid; // TRUE when save_typebuf valid
Bram Moolenaar13df0fe2009-07-09 16:24:19 +00001221 int old_char;
1222 int old_mod_mask;
Bram Moolenaar0a36fec2014-02-11 15:10:43 +01001223 buffheader_T save_readbuf1;
1224 buffheader_T save_readbuf2;
Bram Moolenaar071d4272004-06-13 20:20:40 +00001225#ifdef USE_INPUT_BUF
1226 char_u *save_inputbuf;
1227#endif
1228} tasave_T;
1229
1230/*
1231 * Used for conversion of terminal I/O and script files.
1232 */
1233typedef struct
1234{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001235 int vc_type; // zero or one of the CONV_ values
1236 int vc_factor; // max. expansion factor
Bram Moolenaar4f974752019-02-17 17:44:42 +01001237# ifdef MSWIN
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001238 int vc_cpfrom; // codepage to convert from (CONV_CODEPAGE)
1239 int vc_cpto; // codepage to convert to (CONV_CODEPAGE)
Bram Moolenaar071d4272004-06-13 20:20:40 +00001240# endif
1241# ifdef USE_ICONV
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001242 iconv_t vc_fd; // for CONV_ICONV
Bram Moolenaar071d4272004-06-13 20:20:40 +00001243# endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001244 int vc_fail; // fail for invalid char, don't use '?'
Bram Moolenaar071d4272004-06-13 20:20:40 +00001245} vimconv_T;
1246
1247/*
Bram Moolenaar5f32ece2019-07-21 21:51:59 +02001248 * Structure used for the command line history.
1249 */
1250typedef struct hist_entry
1251{
Bram Moolenaar4aea03e2019-09-25 22:37:17 +02001252 int hisnum; // identifying number
1253 int viminfo; // when TRUE hisstr comes from viminfo
1254 char_u *hisstr; // actual entry, separator char after the NUL
1255 time_t time_set; // when it was typed, zero if unknown
Bram Moolenaar5f32ece2019-07-21 21:51:59 +02001256} histentry_T;
1257
Bram Moolenaar071d4272004-06-13 20:20:40 +00001258#define CONV_NONE 0
1259#define CONV_TO_UTF8 1
Bram Moolenaar3fdfa4a2004-10-07 21:02:47 +00001260#define CONV_9_TO_UTF8 2
1261#define CONV_TO_LATIN1 3
1262#define CONV_TO_LATIN9 4
1263#define CONV_ICONV 5
Bram Moolenaar4f974752019-02-17 17:44:42 +01001264#ifdef MSWIN
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001265# define CONV_CODEPAGE 10 // codepage -> codepage
Bram Moolenaar071d4272004-06-13 20:20:40 +00001266#endif
1267#ifdef MACOS_X
Bram Moolenaar3fdfa4a2004-10-07 21:02:47 +00001268# define CONV_MAC_LATIN1 20
1269# define CONV_LATIN1_MAC 21
1270# define CONV_MAC_UTF8 22
1271# define CONV_UTF8_MAC 23
Bram Moolenaar071d4272004-06-13 20:20:40 +00001272#endif
1273
1274/*
1275 * Structure used for mappings and abbreviations.
1276 */
1277typedef struct mapblock mapblock_T;
1278struct mapblock
1279{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001280 mapblock_T *m_next; // next mapblock in list
1281 char_u *m_keys; // mapped from, lhs
1282 char_u *m_str; // mapped to, rhs
1283 char_u *m_orig_str; // rhs as entered by the user
1284 int m_keylen; // strlen(m_keys)
1285 int m_mode; // valid mode
Bram Moolenaar459fd782019-10-13 16:43:39 +02001286 int m_simplified; // m_keys was simplified, do not use this map
Bram Moolenaar47f1fdc2022-11-24 13:27:36 +00001287 // if key_protocol_enabled() returns TRUE
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001288 int m_noremap; // if non-zero no re-mapping for m_str
1289 char m_silent; // <silent> used, don't echo commands
1290 char m_nowait; // <nowait> used
Bram Moolenaarae5bce12005-08-15 21:41:48 +00001291#ifdef FEAT_EVAL
Bram Moolenaar9b8d6222020-12-28 18:26:00 +01001292 char m_expr; // <expr> used, m_str is an expression
Dominique Pelle3276f582021-08-07 12:44:41 +02001293 sctx_T m_script_ctx; // SCTX where map was defined
Bram Moolenaar071d4272004-06-13 20:20:40 +00001294#endif
1295};
1296
Bram Moolenaar8133cc62020-10-26 21:05:27 +01001297
Bram Moolenaar071d4272004-06-13 20:20:40 +00001298/*
1299 * Used for highlighting in the status line.
1300 */
Bram Moolenaar8133cc62020-10-26 21:05:27 +01001301typedef struct
Bram Moolenaar071d4272004-06-13 20:20:40 +00001302{
1303 char_u *start;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001304 int userhl; // 0: no HL, 1-9: User HL, < 0 for syn ID
Bram Moolenaar8133cc62020-10-26 21:05:27 +01001305} stl_hlrec_T;
Bram Moolenaar071d4272004-06-13 20:20:40 +00001306
Bram Moolenaar860cae12010-06-05 23:22:07 +02001307
1308/*
1309 * Syntax items - usually buffer-specific.
1310 */
1311
Bram Moolenaar9bf703d2019-11-30 19:44:38 +01001312/*
1313 * Item for a hashtable. "hi_key" can be one of three values:
Bram Moolenaardcaf10e2005-01-21 11:55:25 +00001314 * NULL: Never been used
1315 * HI_KEY_REMOVED: Entry was removed
1316 * Otherwise: Used item, pointer to the actual key; this usually is
1317 * inside the item, subtract an offset to locate the item.
1318 * This reduces the size of hashitem by 1/3.
1319 */
1320typedef struct hashitem_S
1321{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001322 long_u hi_hash; // cached hash number of hi_key
Bram Moolenaardcaf10e2005-01-21 11:55:25 +00001323 char_u *hi_key;
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001324} hashitem_T;
Bram Moolenaardcaf10e2005-01-21 11:55:25 +00001325
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001326// The address of "hash_removed" is used as a magic number for hi_key to
1327// indicate a removed item.
Bram Moolenaardcaf10e2005-01-21 11:55:25 +00001328#define HI_KEY_REMOVED &hash_removed
1329#define HASHITEM_EMPTY(hi) ((hi)->hi_key == NULL || (hi)->hi_key == &hash_removed)
1330
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001331// Initial size for a hashtable. Our items are relatively small and growing
1332// is expensive, thus use 16 as a start. Must be a power of 2.
Bram Moolenaarac3150d2019-07-28 16:36:39 +02001333// This allows for storing 10 items (2/3 of 16) before a resize is needed.
Bram Moolenaardcaf10e2005-01-21 11:55:25 +00001334#define HT_INIT_SIZE 16
1335
Bram Moolenaaref2c3252022-11-25 16:31:51 +00001336// flags used for ht_flags
1337#define HTFLAGS_ERROR 0x01 // Set when growing failed, can't add more
1338 // items before growing works.
1339#define HTFLAGS_FROZEN 0x02 // Trying to add or remove an item will result
1340 // in an error message.
1341
Bram Moolenaardcaf10e2005-01-21 11:55:25 +00001342typedef struct hashtable_S
1343{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001344 long_u ht_mask; // mask used for hash value (nr of items in
1345 // array is "ht_mask" + 1)
1346 long_u ht_used; // number of items used
1347 long_u ht_filled; // number of items used + removed
Bram Moolenaar49fe0d62020-07-14 15:47:23 +02001348 int ht_changed; // incremented when adding or removing an item
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001349 int ht_locked; // counter for hash_lock()
Bram Moolenaaref2c3252022-11-25 16:31:51 +00001350 int ht_flags; // HTFLAGS_ values
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001351 hashitem_T *ht_array; // points to the array, allocated when it's
1352 // not "ht_smallarray"
1353 hashitem_T ht_smallarray[HT_INIT_SIZE]; // initial array
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001354} hashtab_T;
1355
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001356typedef long_u hash_T; // Type for hi_hash
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001357
1358
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001359// Use 64-bit Number.
Bram Moolenaar82f654e2020-02-17 22:12:50 +01001360#ifdef MSWIN
1361# ifdef PROTO
Bram Moolenaarf9706e92020-02-22 14:27:04 +01001362 // workaround for cproto that doesn't recognize __int64
1363 typedef long varnumber_T;
1364 typedef unsigned long uvarnumber_T;
1365# define VARNUM_MIN LONG_MIN
1366# define VARNUM_MAX LONG_MAX
1367# define UVARNUM_MAX ULONG_MAX
Bram Moolenaar82f654e2020-02-17 22:12:50 +01001368# else
Bram Moolenaarf9706e92020-02-22 14:27:04 +01001369 typedef __int64 varnumber_T;
1370 typedef unsigned __int64 uvarnumber_T;
1371# define VARNUM_MIN _I64_MIN
1372# define VARNUM_MAX _I64_MAX
1373# define UVARNUM_MAX _UI64_MAX
Bram Moolenaar22fcfad2016-07-01 18:17:26 +02001374# endif
Bram Moolenaarf9706e92020-02-22 14:27:04 +01001375#elif defined(HAVE_NO_LONG_LONG)
1376# if defined(HAVE_STDINT_H)
1377 typedef int64_t varnumber_T;
1378 typedef uint64_t uvarnumber_T;
1379# define VARNUM_MIN INT64_MIN
1380# define VARNUM_MAX INT64_MAX
1381# define UVARNUM_MAX UINT64_MAX
1382# else
1383 // this may cause trouble for code that depends on 64 bit ints
1384 typedef long varnumber_T;
1385 typedef unsigned long uvarnumber_T;
1386# define VARNUM_MIN LONG_MIN
1387# define VARNUM_MAX LONG_MAX
1388# define UVARNUM_MAX ULONG_MAX
1389# endif
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001390#else
Bram Moolenaarf9706e92020-02-22 14:27:04 +01001391 typedef long long varnumber_T;
1392 typedef unsigned long long uvarnumber_T;
Bram Moolenaarc593bec2020-02-25 21:26:49 +01001393# ifdef LLONG_MIN
1394# define VARNUM_MIN LLONG_MIN
1395# define VARNUM_MAX LLONG_MAX
1396# define UVARNUM_MAX ULLONG_MAX
1397# else
1398# define VARNUM_MIN LONG_LONG_MIN
1399# define VARNUM_MAX LONG_LONG_MAX
1400# define UVARNUM_MAX ULONG_LONG_MAX
1401# endif
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001402#endif
Bram Moolenaar22fcfad2016-07-01 18:17:26 +02001403
Bram Moolenaara65c2882020-04-08 11:31:48 +02001404// On rare systems "char" is unsigned, sometimes we really want a signed 8-bit
1405// value.
1406typedef signed char int8_T;
1407
Bram Moolenaarc1a11ed2008-06-24 22:09:24 +00001408typedef double float_T;
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001409
Bram Moolenaard505d172022-12-18 21:42:55 +00001410typedef struct typval_S typval_T;
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001411typedef struct listvar_S list_T;
1412typedef struct dictvar_S dict_T;
Bram Moolenaar1735bc92016-03-14 23:05:14 +01001413typedef struct partial_S partial_T;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01001414typedef struct blobvar_S blob_T;
Bram Moolenaar6463ca22016-02-13 17:04:46 +01001415
Bram Moolenaar3a97bb32019-06-01 13:28:35 +02001416// Struct that holds both a normal function name and a partial_T, as used for a
1417// callback argument.
1418// When used temporarily "cb_name" is not allocated. The refcounts to either
1419// the function or the partial are incremented and need to be decremented
1420// later with free_callback().
1421typedef struct {
1422 char_u *cb_name;
1423 partial_T *cb_partial;
1424 int cb_free_name; // cb_name was allocated
1425} callback_T;
1426
Bram Moolenaar20431c92020-03-20 18:39:46 +01001427typedef struct isn_S isn_T; // instruction
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001428typedef struct dfunc_S dfunc_T; // :def function
1429
Bram Moolenaar00b28d62022-12-08 15:32:33 +00001430typedef struct type_S type_T;
1431typedef struct ufunc_S ufunc_T;
1432
Bram Moolenaar835dc632016-02-07 14:27:38 +01001433typedef struct jobvar_S job_T;
Bram Moolenaar6463ca22016-02-13 17:04:46 +01001434typedef struct readq_S readq_T;
Bram Moolenaar97bd5e62017-08-18 20:50:30 +02001435typedef struct writeq_S writeq_T;
Bram Moolenaar6463ca22016-02-13 17:04:46 +01001436typedef struct jsonq_S jsonq_T;
1437typedef struct cbq_S cbq_T;
1438typedef struct channel_S channel_T;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001439typedef struct cctx_S cctx_T;
Bram Moolenaarcd45ed02020-12-22 17:35:54 +01001440typedef struct ectx_S ectx_T;
Bram Moolenaarf18332f2021-05-07 17:55:55 +02001441typedef struct instr_S instr_T;
Bram Moolenaar00b28d62022-12-08 15:32:33 +00001442typedef struct class_S class_T;
1443typedef struct object_S object_T;
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001444
Bram Moolenaara03f2332016-02-06 18:09:59 +01001445typedef enum
1446{
Bram Moolenaar4c683752020-04-05 21:38:23 +02001447 VAR_UNKNOWN = 0, // not set, any type or "void" allowed
1448 VAR_ANY, // used for "any" type
1449 VAR_VOID, // no value (function not returning anything)
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001450 VAR_BOOL, // "v_number" is used: VVAL_TRUE or VVAL_FALSE
1451 VAR_SPECIAL, // "v_number" is used: VVAL_NULL or VVAL_NONE
1452 VAR_NUMBER, // "v_number" is used
1453 VAR_FLOAT, // "v_float" is used
1454 VAR_STRING, // "v_string" is used
1455 VAR_BLOB, // "v_blob" is used
1456 VAR_FUNC, // "v_string" is function name
1457 VAR_PARTIAL, // "v_partial" is used
1458 VAR_LIST, // "v_list" is used
1459 VAR_DICT, // "v_dict" is used
1460 VAR_JOB, // "v_job" is used
1461 VAR_CHANNEL, // "v_channel" is used
Bram Moolenaarf18332f2021-05-07 17:55:55 +02001462 VAR_INSTR, // "v_instr" is used
Bram Moolenaar5bcd29b2023-01-05 20:14:43 +00001463 VAR_CLASS, // "v_class" is used (also used for interface)
Bram Moolenaar00b28d62022-12-08 15:32:33 +00001464 VAR_OBJECT, // "v_object" is used
Bram Moolenaara03f2332016-02-06 18:09:59 +01001465} vartype_T;
1466
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001467// A type specification.
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001468struct type_S {
1469 vartype_T tt_type;
Bram Moolenaar1378fbc2020-04-11 20:50:33 +02001470 int8_T tt_argcount; // for func, incl. vararg, -1 for unknown
James McCoy2e258bd2021-10-05 19:44:04 +01001471 int8_T tt_min_argcount; // number of non-optional arguments
1472 char_u tt_flags; // TTFLAG_ values
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001473 type_T *tt_member; // for list, dict, func return type
Bram Moolenaarb1e32ac2023-02-21 12:38:51 +00001474 class_T *tt_class; // for class and object
Bram Moolenaar5deeb3f2020-04-05 17:08:17 +02001475 type_T **tt_args; // func argument types, allocated
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001476};
1477
Bram Moolenaar078a4612022-01-04 15:17:03 +00001478typedef struct {
1479 type_T *type_curr; // current type, value type
1480 type_T *type_decl; // declared type or equal to type_current
1481} type2_T;
1482
Bram Moolenaarc6951a72022-12-29 20:56:24 +00001483#define TTFLAG_VARARGS 0x01 // func args ends with "..."
1484#define TTFLAG_BOOL_OK 0x02 // can be converted to bool
Bram Moolenaar47bba532023-01-20 18:49:46 +00001485#define TTFLAG_FLOAT_OK 0x04 // number can be used/converted to float
1486#define TTFLAG_NUMBER_OK 0x08 // number can be used for a float
1487#define TTFLAG_STATIC 0x10 // one of the static types, e.g. t_any
1488#define TTFLAG_CONST 0x20 // cannot be changed
1489#define TTFLAG_SUPER 0x40 // object from "super".
Bram Moolenaarc6951a72022-12-29 20:56:24 +00001490
Bram Moolenaar3d473ee2022-12-14 20:59:32 +00001491typedef enum {
Yegappan Lakshmanancd7293b2023-08-27 19:18:23 +02001492 VIM_ACCESS_PRIVATE, // read/write only inside the class
1493 VIM_ACCESS_READ, // read everywhere, write only inside the class
=?UTF-8?q?Ola=20S=C3=B6der?=d8742472023-03-05 13:12:32 +00001494 VIM_ACCESS_ALL // read/write everywhere
Bram Moolenaar3d473ee2022-12-14 20:59:32 +00001495} omacc_T;
1496
Bram Moolenaar00b28d62022-12-08 15:32:33 +00001497/*
Bram Moolenaard505d172022-12-18 21:42:55 +00001498 * Entry for an object or class member variable.
Bram Moolenaar00b28d62022-12-08 15:32:33 +00001499 */
1500typedef struct {
Bram Moolenaard505d172022-12-18 21:42:55 +00001501 char_u *ocm_name; // allocated
1502 omacc_T ocm_access;
1503 type_T *ocm_type;
1504 char_u *ocm_init; // allocated
1505} ocmember_T;
Bram Moolenaar00b28d62022-12-08 15:32:33 +00001506
Bram Moolenaard0200c82023-01-28 15:19:40 +00001507// used for the lookup table of a class member index and object method index
Bram Moolenaar29ac5df2023-01-16 19:43:47 +00001508typedef struct itf2class_S itf2class_T;
1509struct itf2class_S {
1510 itf2class_T *i2c_next;
1511 class_T *i2c_class;
Bram Moolenaard0200c82023-01-28 15:19:40 +00001512 int i2c_is_method; // TRUE for method indexes
Bram Moolenaar29ac5df2023-01-16 19:43:47 +00001513 // array with ints follows
1514};
1515
Bram Moolenaard0200c82023-01-28 15:19:40 +00001516#define CLASS_INTERFACE 1
1517#define CLASS_EXTENDED 2 // another class extends this one
Yegappan Lakshmanan7bcd25c2023-09-08 19:27:51 +02001518#define CLASS_ABSTRACT 4 // abstract class
Bram Moolenaar5bcd29b2023-01-05 20:14:43 +00001519
Bram Moolenaar00b28d62022-12-08 15:32:33 +00001520// "class_T": used for v_class of typval of VAR_CLASS
Bram Moolenaar5bcd29b2023-01-05 20:14:43 +00001521// Also used for an interface (class_flags has CLASS_INTERFACE).
Bram Moolenaar00b28d62022-12-08 15:32:33 +00001522struct class_S
1523{
1524 char_u *class_name; // allocated
Bram Moolenaar5bcd29b2023-01-05 20:14:43 +00001525 int class_flags; // CLASS_ flags
1526
Bram Moolenaar00b28d62022-12-08 15:32:33 +00001527 int class_refcount;
Bram Moolenaarcf760d52023-01-05 13:16:04 +00001528 int class_copyID; // used by garbage collection
Yegappan Lakshmanane651e112023-09-04 07:51:01 +02001529 class_T *class_next_used; // for list headed by "first_class"
1530 class_T *class_prev_used; // for list headed by "first_class"
Bram Moolenaar00b28d62022-12-08 15:32:33 +00001531
Bram Moolenaar83677162023-01-08 19:54:10 +00001532 class_T *class_extends; // parent class or NULL
1533
Bram Moolenaar94674f22023-01-06 18:42:20 +00001534 // interfaces declared for the class
1535 int class_interface_count;
1536 char_u **class_interfaces; // allocated array of names
Bram Moolenaara94bd9d2023-01-12 15:01:32 +00001537 class_T **class_interfaces_cl; // interfaces (counts as reference)
Bram Moolenaar29ac5df2023-01-16 19:43:47 +00001538 itf2class_T *class_itf2class; // member index lookup tables
Bram Moolenaar94674f22023-01-06 18:42:20 +00001539
Bram Moolenaard505d172022-12-18 21:42:55 +00001540 // class members: "static varname"
1541 int class_class_member_count;
1542 ocmember_T *class_class_members; // allocated
1543 typval_T *class_members_tv; // allocated array of class member vals
Bram Moolenaar00b28d62022-12-08 15:32:33 +00001544
Bram Moolenaar6bafdd42023-01-01 12:58:33 +00001545 // class functions: "static def SomeMethod()"
Bram Moolenaar58b40092023-01-11 15:59:05 +00001546 int class_class_function_count; // total count
1547 int class_class_function_count_child; // count without "extends"
Bram Moolenaar6bafdd42023-01-01 12:58:33 +00001548 ufunc_T **class_class_functions; // allocated
Bram Moolenaard505d172022-12-18 21:42:55 +00001549
1550 // object members: "this.varname"
1551 int class_obj_member_count;
1552 ocmember_T *class_obj_members; // allocated
1553
1554 // object methods: "def SomeMethod()"
Bram Moolenaar58b40092023-01-11 15:59:05 +00001555 int class_obj_method_count; // total count
1556 int class_obj_method_count_child; // count without "extends"
Bram Moolenaar00b28d62022-12-08 15:32:33 +00001557 ufunc_T **class_obj_methods; // allocated
Bram Moolenaar00b28d62022-12-08 15:32:33 +00001558
1559 garray_T class_type_list; // used for type pointers
Bram Moolenaard505d172022-12-18 21:42:55 +00001560 type_T class_type; // type used for the class
Bram Moolenaarffdaca92022-12-09 21:41:48 +00001561 type_T class_object_type; // same as class_type but VAR_OBJECT
Bram Moolenaar00b28d62022-12-08 15:32:33 +00001562};
1563
1564// Used for v_object of typval of VAR_OBJECT.
1565// The member variables follow in an array of typval_T.
Bram Moolenaarffdaca92022-12-09 21:41:48 +00001566struct object_S
1567{
Bram Moolenaard28d7b92022-12-08 20:42:00 +00001568 class_T *obj_class; // class this object is created for;
1569 // pointer adds to class_refcount
Bram Moolenaar00b28d62022-12-08 15:32:33 +00001570 int obj_refcount;
Bram Moolenaard28d7b92022-12-08 20:42:00 +00001571
1572 object_T *obj_next_used; // for list headed by "first_object"
1573 object_T *obj_prev_used; // for list headed by "first_object"
1574 int obj_copyID; // used by garbage collection
Bram Moolenaar00b28d62022-12-08 15:32:33 +00001575};
1576
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001577/*
1578 * Structure to hold an internal variable without a name.
1579 */
Bram Moolenaard505d172022-12-18 21:42:55 +00001580struct typval_S
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001581{
Bram Moolenaara03f2332016-02-06 18:09:59 +01001582 vartype_T v_type;
Bram Moolenaar2bb26582020-10-03 22:52:39 +02001583 char v_lock; // see below: VAR_LOCKED, VAR_FIXED
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001584 union
1585 {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001586 varnumber_T v_number; // number value
Bram Moolenaar00b28d62022-12-08 15:32:33 +00001587 float_T v_float; // floating point number value
1588 char_u *v_string; // string value (can be NULL)
1589 list_T *v_list; // list value (can be NULL)
1590 dict_T *v_dict; // dict value (can be NULL)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001591 partial_T *v_partial; // closure: function with args
Bram Moolenaar509ce2a2016-03-11 22:52:15 +01001592#ifdef FEAT_JOB_CHANNEL
Bram Moolenaar00b28d62022-12-08 15:32:33 +00001593 job_T *v_job; // job value (can be NULL)
1594 channel_T *v_channel; // channel value (can be NULL)
Bram Moolenaar77073442016-02-13 23:23:53 +01001595#endif
Bram Moolenaar00b28d62022-12-08 15:32:33 +00001596 blob_T *v_blob; // blob value (can be NULL)
Bram Moolenaarf18332f2021-05-07 17:55:55 +02001597 instr_T *v_instr; // instructions to execute
Bram Moolenaar00b28d62022-12-08 15:32:33 +00001598 class_T *v_class; // class value (can be NULL)
1599 object_T *v_object; // object value (can be NULL)
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001600 } vval;
Bram Moolenaard505d172022-12-18 21:42:55 +00001601};
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001602
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001603// Values for "dv_scope".
1604#define VAR_SCOPE 1 // a:, v:, s:, etc. scope dictionaries
1605#define VAR_DEF_SCOPE 2 // l:, g: scope dictionaries: here funcrefs are not
1606 // allowed to mask existing functions
Bram Moolenaarbdb62052012-07-16 17:31:53 +02001607
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001608// Values for "v_lock".
Bram Moolenaar70c43d82022-01-26 21:01:15 +00001609#define VAR_LOCKED 1 // locked with lock(), can use unlock()
1610#define VAR_FIXED 2 // locked forever
1611#define VAR_ITEMS_LOCKED 4 // items of non-materialized list locked
Bram Moolenaar2ce06f62005-01-31 19:19:04 +00001612
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001613/*
1614 * Structure to hold an item of a list: an internal variable without a name.
1615 */
1616typedef struct listitem_S listitem_T;
1617
1618struct listitem_S
1619{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001620 listitem_T *li_next; // next item in list
1621 listitem_T *li_prev; // previous item in list
1622 typval_T li_tv; // type and value of the variable
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001623};
1624
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001625// Struct used by those that are using an item in a list.
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001626typedef struct listwatch_S listwatch_T;
1627
1628struct listwatch_S
1629{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001630 listitem_T *lw_item; // item being watched
1631 listwatch_T *lw_next; // next watcher
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001632};
1633
1634/*
1635 * Structure to hold info about a list.
Bram Moolenaar1a840242018-03-08 21:46:43 +01001636 * Order of members is optimized to reduce padding.
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001637 * When created by range() it will at first have special value:
1638 * lv_first == &range_list_item;
1639 * and use lv_start, lv_end, lv_stride.
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001640 */
1641struct listvar_S
1642{
Bram Moolenaar70c43d82022-01-26 21:01:15 +00001643 listitem_T *lv_first; // first item, NULL if none, &range_list_item
1644 // for a non-materialized list
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001645 listwatch_T *lv_watch; // first watcher, NULL if none
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001646 union {
1647 struct { // used for non-materialized range list:
1648 // "lv_first" is &range_list_item
1649 varnumber_T lv_start;
1650 varnumber_T lv_end;
1651 int lv_stride;
Bram Moolenaar0ff6aad2020-01-29 21:27:21 +01001652 } nonmat;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001653 struct { // used for materialized list
1654 listitem_T *lv_last; // last item, NULL if none
1655 listitem_T *lv_idx_item; // when not NULL item at index "lv_idx"
1656 int lv_idx; // cached index of an item
Bram Moolenaar0ff6aad2020-01-29 21:27:21 +01001657 } mat;
1658 } lv_u;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001659 type_T *lv_type; // current type, allocated by alloc_type()
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001660 list_T *lv_copylist; // copied list used by deepcopy()
1661 list_T *lv_used_next; // next list in used lists list
1662 list_T *lv_used_prev; // previous list in used lists list
1663 int lv_refcount; // reference count
1664 int lv_len; // number of items
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001665 int lv_with_items; // number of items following this struct that
1666 // should not be freed
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001667 int lv_copyID; // ID used by deepcopy()
1668 char lv_lock; // zero, VAR_LOCKED, VAR_FIXED
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001669};
1670
1671/*
Bram Moolenaardf48fb42016-07-22 21:50:18 +02001672 * Static list with 10 items. Use init_static_list() to initialize.
1673 */
1674typedef struct {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001675 list_T sl_list; // must be first
Bram Moolenaardf48fb42016-07-22 21:50:18 +02001676 listitem_T sl_items[10];
1677} staticList10_T;
1678
1679/*
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001680 * Structure to hold an item of a Dictionary.
1681 * Also used for a variable.
1682 * The key is copied into "di_key" to avoid an extra alloc/free for it.
1683 */
1684struct dictitem_S
1685{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001686 typval_T di_tv; // type and value of the variable
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001687 char_u di_flags; // DI_FLAGS_ flags (only used for variable)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001688 char_u di_key[1]; // key (actually longer!)
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001689};
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001690typedef struct dictitem_S dictitem_T;
1691
Bram Moolenaard7c96872019-06-15 17:12:48 +02001692/*
1693 * A dictitem with a 16 character key (plus NUL). This is an efficient way to
1694 * have a fixed-size dictitem.
1695 */
1696#define DICTITEM16_KEY_LEN 16
Bram Moolenaarbee6c0c2016-03-25 15:40:50 +01001697struct dictitem16_S
1698{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001699 typval_T di_tv; // type and value of the variable
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001700 char_u di_flags; // DI_FLAGS_ flags (only used for variable)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001701 char_u di_key[DICTITEM16_KEY_LEN + 1]; // key
Bram Moolenaarbee6c0c2016-03-25 15:40:50 +01001702};
1703typedef struct dictitem16_S dictitem16_T;
1704
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001705// Flags for "di_flags"
1706#define DI_FLAGS_RO 0x01 // read-only variable
1707#define DI_FLAGS_RO_SBX 0x02 // read-only in the sandbox
1708#define DI_FLAGS_FIX 0x04 // fixed: no :unlet or remove()
1709#define DI_FLAGS_LOCK 0x08 // locked variable
1710#define DI_FLAGS_ALLOC 0x10 // separately allocated
1711#define DI_FLAGS_RELOAD 0x20 // set when script sourced again
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001712
1713/*
1714 * Structure to hold info about a Dictionary.
1715 */
1716struct dictvar_S
1717{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001718 char dv_lock; // zero, VAR_LOCKED, VAR_FIXED
1719 char dv_scope; // zero, VAR_SCOPE, VAR_DEF_SCOPE
1720 int dv_refcount; // reference count
1721 int dv_copyID; // ID used by deepcopy()
1722 hashtab_T dv_hashtab; // hashtab that refers to the items
Bram Moolenaar078a4612022-01-04 15:17:03 +00001723 type_T *dv_type; // current type, allocated by alloc_type()
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001724 dict_T *dv_copydict; // copied dict used by deepcopy()
1725 dict_T *dv_used_next; // next dict in used dicts list
1726 dict_T *dv_used_prev; // previous dict in used dicts list
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001727};
1728
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01001729/*
1730 * Structure to hold info about a blob.
1731 */
1732struct blobvar_S
1733{
1734 garray_T bv_ga; // growarray with the data
1735 int bv_refcount; // reference count
1736 char bv_lock; // zero, VAR_LOCKED, VAR_FIXED
1737};
1738
Bram Moolenaar801ab062020-06-25 19:27:56 +02001739typedef int (*cfunc_T)(int argcount, typval_T *argvars, typval_T *rettv, void *state);
1740typedef void (*cfunc_free_T)(void *state);
1741
Bram Moolenaar20b23c62020-08-20 15:25:00 +02001742// type of getline() last argument
1743typedef enum {
1744 GETLINE_NONE, // do not concatenate any lines
Bram Moolenaar8242ebb2020-12-29 11:15:01 +01001745 GETLINE_CONCAT_CONT, // concatenate continuation lines with backslash
1746 GETLINE_CONCAT_CONTBAR, // concatenate continuation lines with \ and |
Bram Moolenaar20b23c62020-08-20 15:25:00 +02001747 GETLINE_CONCAT_ALL // concatenate continuation and Vim9 # comment lines
1748} getline_opt_T;
1749
Bram Moolenaar9b8d6222020-12-28 18:26:00 +01001750typedef struct svar_S svar_T;
1751
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001752#if defined(FEAT_EVAL) || defined(PROTO)
Bram Moolenaar766ae5b2022-09-14 00:30:51 +01001753/*
1754 * Info used by a ":for" loop.
1755 */
1756typedef struct
1757{
1758 int fi_semicolon; // TRUE if ending in '; var]'
Bram Moolenaare8e369a2022-09-21 18:59:14 +01001759 int fi_varcount; // nr of variables in [] or zero
Bram Moolenaar766ae5b2022-09-14 00:30:51 +01001760 int fi_break_count; // nr of line breaks encountered
1761 listwatch_T fi_lw; // keep an eye on the item used.
1762 list_T *fi_list; // list being used
1763 int fi_bi; // index of blob
1764 blob_T *fi_blob; // blob being used
1765 char_u *fi_string; // copy of string being used
1766 int fi_byte_idx; // byte index in fi_string
1767 int fi_cs_flags; // cs_flags or'ed together
1768} forinfo_T;
1769
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001770typedef struct funccall_S funccall_T;
1771
Bram Moolenaarb2049902021-01-24 12:53:53 +01001772// values used for "uf_def_status"
Bram Moolenaar0cb5bcf2020-06-20 18:19:09 +02001773typedef enum {
Bram Moolenaar701cc6c2021-04-10 13:33:48 +02001774 UF_NOT_COMPILED, // executed with interpreter
1775 UF_TO_BE_COMPILED, // to be compiled before execution
1776 UF_COMPILING, // in compile_def_function()
1777 UF_COMPILED, // successfully compiled
1778 UF_COMPILE_ERROR // compilation error, cannot execute
Bram Moolenaar0cb5bcf2020-06-20 18:19:09 +02001779} def_status_T;
Bram Moolenaar822ba242020-05-24 23:00:18 +02001780
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001781/*
1782 * Structure to hold info for a user function.
Bram Moolenaar8fa745e2022-09-16 19:04:24 +01001783 * When adding a field check copy_lambda_to_global_func().
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001784 */
Bram Moolenaar00b28d62022-12-08 15:32:33 +00001785struct ufunc_S
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001786{
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001787 int uf_varargs; // variable nr of arguments (old style)
1788 int uf_flags; // FC_ flags
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02001789 int uf_calls; // nr of active calls
1790 int uf_cleared; // func_clear() was already called
Bram Moolenaar0cb5bcf2020-06-20 18:19:09 +02001791 def_status_T uf_def_status; // UF_NOT_COMPILED, UF_TO_BE_COMPILED, etc.
1792 int uf_dfunc_idx; // only valid if uf_def_status is UF_COMPILED
Bram Moolenaar00b28d62022-12-08 15:32:33 +00001793
Yegappan Lakshmananc30a90d2023-09-15 20:14:55 +02001794 class_T *uf_class; // for class/object method and constructor;
1795 // does not count for class_refcount.
1796 // class of the object which is invoking this
1797 // function.
1798 class_T *uf_defclass; // class where this function is defined.
Bram Moolenaar00b28d62022-12-08 15:32:33 +00001799
Bram Moolenaar5deeb3f2020-04-05 17:08:17 +02001800 garray_T uf_args; // arguments, including optional arguments
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02001801 garray_T uf_def_args; // default argument expressions
Bram Moolenaare28d9b32021-07-03 18:56:53 +02001802 int uf_args_visible; // normally uf_args.ga_len, less when
1803 // compiling default argument expression.
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001804
1805 // for :def (for :function uf_ret_type is NULL)
1806 type_T **uf_arg_types; // argument types (count == uf_args.ga_len)
1807 type_T *uf_ret_type; // return type
1808 garray_T uf_type_list; // types used in arg and return types
Bram Moolenaarf112f302020-12-20 17:47:52 +01001809 partial_T *uf_partial; // for closure created inside :def function:
1810 // information about the context
1811
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001812 char_u *uf_va_name; // name from "...name" or NULL
1813 type_T *uf_va_type; // type from "...name: type" or NULL
Bram Moolenaar5deeb3f2020-04-05 17:08:17 +02001814 type_T *uf_func_type; // type of the function, &t_func_any if unknown
Bram Moolenaarfbbcd002020-10-15 12:46:44 +02001815 int uf_block_depth; // nr of entries in uf_block_ids
1816 int *uf_block_ids; // blocks a :def function is defined inside
Bram Moolenaar801ab062020-06-25 19:27:56 +02001817# if defined(FEAT_LUA)
1818 cfunc_T uf_cb; // callback function for cfunc
1819 cfunc_free_T uf_cb_free; // callback function to free cfunc
Bram Moolenaar6ed545e2022-05-09 20:09:23 +01001820 void *uf_cb_state; // state of uf_cb
Bram Moolenaar801ab062020-06-25 19:27:56 +02001821# endif
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001822
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02001823 garray_T uf_lines; // function lines
Bram Moolenaar4f8f5422021-06-20 19:28:14 +02001824
1825 int uf_debug_tick; // when last checked for a breakpoint in this
1826 // function.
1827 int uf_has_breakpoint; // TRUE when a breakpoint has been set in
1828 // this function.
Bram Moolenaar27e80c82018-10-14 21:41:01 +02001829# ifdef FEAT_PROFILE
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02001830 int uf_profiling; // TRUE when func is being profiled
Bram Moolenaarad648092018-06-30 18:28:03 +02001831 int uf_prof_initialized;
Ernie Rael21d32122023-09-02 15:09:18 +02001832 hash_T uf_hash; // hash for uf_name when profiling
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02001833 // profiling the function as a whole
1834 int uf_tm_count; // nr of calls
1835 proftime_T uf_tm_total; // time spent in function + children
1836 proftime_T uf_tm_self; // time spent in function itself
1837 proftime_T uf_tm_children; // time spent in children this call
1838 // profiling the function per line
1839 int *uf_tml_count; // nr of times line was executed
1840 proftime_T *uf_tml_total; // time spent in a line + children
1841 proftime_T *uf_tml_self; // time spent in a line itself
1842 proftime_T uf_tml_start; // start time for current line
1843 proftime_T uf_tml_children; // time spent in children for this line
1844 proftime_T uf_tml_wait; // start wait time for current line
1845 int uf_tml_idx; // index of line being timed; -1 if none
1846 int uf_tml_execed; // line being timed was executed
Bram Moolenaar27e80c82018-10-14 21:41:01 +02001847# endif
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02001848 sctx_T uf_script_ctx; // SCTX where function was defined,
Bram Moolenaarf9b2b492020-08-05 14:34:14 +02001849 // used for s: variables; sc_version changed
1850 // for :function
1851 int uf_script_ctx_version; // original sc_version of SCTX
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02001852 int uf_refcount; // reference count, see func_name_refcount()
Bram Moolenaarc8cd2b32020-05-01 19:29:08 +02001853
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02001854 funccall_T *uf_scoped; // l: local variables for closure
Bram Moolenaarc8cd2b32020-05-01 19:29:08 +02001855
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01001856 char_u *uf_name_exp; // if "uf_name[]" starts with SNR the name with
1857 // "<SNR>" as a string, otherwise NULL
Bram Moolenaar6a12e332021-01-31 14:46:00 +01001858 char_u uf_name[4]; // name of function (actual size equals name);
1859 // can start with <SNR>123_ (<SNR> is K_SPECIAL
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02001860 // KS_EXTRA KE_SNR)
Bram Moolenaar00b28d62022-12-08 15:32:33 +00001861};
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001862
Bram Moolenaarc8cd2b32020-05-01 19:29:08 +02001863// flags used in uf_flags
1864#define FC_ABORT 0x01 // abort function on error
1865#define FC_RANGE 0x02 // function accepts range
1866#define FC_DICT 0x04 // Dict function, uses "self"
1867#define FC_CLOSURE 0x08 // closure, uses outer scope variables
1868#define FC_DELETED 0x10 // :delfunction used while uf_refcount > 0
1869#define FC_REMOVED 0x20 // function redefined while uf_refcount > 0
1870#define FC_SANDBOX 0x40 // function defined in the sandbox
1871#define FC_DEAD 0x80 // function kept only for reference to dfunc
1872#define FC_EXPORT 0x100 // "export def Func()"
1873#define FC_NOARGS 0x200 // no a: variables in lambda
1874#define FC_VIM9 0x400 // defined in vim9 script file
Bram Moolenaar801ab062020-06-25 19:27:56 +02001875#define FC_CFUNC 0x800 // defined as Lua C func
Bram Moolenaar8fa745e2022-09-16 19:04:24 +01001876#define FC_COPY 0x1000 // copy of another function by
1877 // copy_lambda_to_global_func()
Bram Moolenaar38453522021-11-28 22:00:12 +00001878#define FC_LAMBDA 0x2000 // one line "return {expr}"
Bram Moolenaarc8cd2b32020-05-01 19:29:08 +02001879
Bram Moolenaar574950d2023-01-03 19:08:50 +00001880#define FC_OBJECT 0x4000 // object method
1881#define FC_NEW 0x8000 // constructor
Yegappan Lakshmanan7bcd25c2023-09-08 19:27:51 +02001882#define FC_ABSTRACT 0x10000 // abstract method
Bram Moolenaar00b28d62022-12-08 15:32:33 +00001883
Yegappan Lakshmanan1db15142023-09-19 20:34:05 +02001884// Is "ufunc" an object method?
1885#define IS_OBJECT_METHOD(ufunc) ((ufunc->uf_flags & FC_OBJECT) == FC_OBJECT)
1886// Is "ufunc" a class new() constructor method?
1887#define IS_CONSTRUCTOR_METHOD(ufunc) ((ufunc->uf_flags & FC_NEW) == FC_NEW)
1888// Is "ufunc" an abstract class method?
1889#define IS_ABSTRACT_METHOD(ufunc) ((ufunc->uf_flags & FC_ABSTRACT) == FC_ABSTRACT)
1890
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02001891#define MAX_FUNC_ARGS 20 // maximum number of function arguments
1892#define VAR_SHORT_LEN 20 // short variable name length
1893#define FIXVAR_CNT 12 // number of fixed variables
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001894
Bram Moolenaar9bf703d2019-11-30 19:44:38 +01001895/*
Bram Moolenaarbf67ea12020-05-02 17:52:42 +02001896 * Structure to hold info for a function that is currently being executed.
Bram Moolenaar9bf703d2019-11-30 19:44:38 +01001897 */
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001898struct funccall_S
1899{
Bram Moolenaarca16c602022-09-06 18:57:08 +01001900 ufunc_T *fc_func; // function being called
1901 int fc_linenr; // next line to be executed
1902 int fc_returned; // ":return" used
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001903 struct // fixed variables for arguments
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001904 {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001905 dictitem_T var; // variable (without room for name)
1906 char_u room[VAR_SHORT_LEN]; // room for the name
Bram Moolenaarca16c602022-09-06 18:57:08 +01001907 } fc_fixvar[FIXVAR_CNT];
1908 dict_T fc_l_vars; // l: local function variables
1909 dictitem_T fc_l_vars_var; // variable for l: scope
1910 dict_T fc_l_avars; // a: argument variables
1911 dictitem_T fc_l_avars_var; // variable for a: scope
1912 list_T fc_l_varlist; // list for a:000
1913 listitem_T fc_l_listitems[MAX_FUNC_ARGS]; // listitems for a:000
1914 typval_T *fc_rettv; // return value
1915 linenr_T fc_breakpoint; // next line with breakpoint or zero
1916 int fc_dbg_tick; // debug_tick when breakpoint was set
1917 int fc_level; // top nesting level of executed function
Bram Moolenaar58779852022-09-06 18:31:14 +01001918
Bram Moolenaar1d84f762022-09-03 21:35:53 +01001919 garray_T fc_defer; // functions to be called on return
Bram Moolenaar58779852022-09-06 18:31:14 +01001920 ectx_T *fc_ectx; // execution context for :def function, NULL
1921 // otherwise
1922
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001923#ifdef FEAT_PROFILE
Bram Moolenaarca16c602022-09-06 18:57:08 +01001924 proftime_T fc_prof_child; // time spent in a child
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001925#endif
Bram Moolenaarca16c602022-09-06 18:57:08 +01001926 funccall_T *fc_caller; // calling function or NULL; or next funccal in
Bram Moolenaar22286892020-11-05 20:50:51 +01001927 // list pointed to by previous_funccal.
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001928
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001929 // for closure
1930 int fc_refcount; // number of user functions that reference this
1931 // funccal
1932 int fc_copyID; // for garbage collection
Bram Moolenaarca16c602022-09-06 18:57:08 +01001933 garray_T fc_ufuncs; // list of ufunc_T* which keep a reference to
zeertzjqe7d49462023-04-16 20:53:55 +01001934 // "fc_func"
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001935};
1936
Bram Moolenaar1d84f762022-09-03 21:35:53 +01001937// structure used as item in "fc_defer"
1938typedef struct
1939{
1940 char_u *dr_name; // function name, allocated
1941 typval_T dr_argvars[MAX_FUNC_ARGS + 1];
1942 int dr_argcount;
1943} defer_T;
1944
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001945/*
1946 * Struct used by trans_function_name()
1947 */
1948typedef struct
1949{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001950 dict_T *fd_dict; // Dictionary used
1951 char_u *fd_newkey; // new key in "dict" in allocated memory
1952 dictitem_T *fd_di; // Dictionary item used
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001953} funcdict_T;
1954
Bram Moolenaar27e80c82018-10-14 21:41:01 +02001955typedef struct funccal_entry funccal_entry_T;
1956struct funccal_entry {
1957 void *top_funccal;
1958 funccal_entry_T *next;
1959};
1960
Bram Moolenaar9bf703d2019-11-30 19:44:38 +01001961// From user function to hashitem and back.
Bram Moolenaar660a10a2019-07-14 15:48:38 +02001962#define UF2HIKEY(fp) ((fp)->uf_name)
1963#define HIKEY2UF(p) ((ufunc_T *)((p) - offsetof(ufunc_T, uf_name)))
1964#define HI2UF(hi) HIKEY2UF((hi)->hi_key)
1965
Bram Moolenaar9bf703d2019-11-30 19:44:38 +01001966/*
Bram Moolenaar7ebcba62020-01-12 17:42:55 +01001967 * Holds the hashtab with variables local to each sourced script.
1968 * Each item holds a variable (nameless) that points to the dict_T.
1969 */
Bram Moolenaar8d739de2020-10-14 19:39:19 +02001970typedef struct {
Bram Moolenaar7ebcba62020-01-12 17:42:55 +01001971 dictitem_T sv_var;
1972 dict_T sv_dict;
1973} scriptvar_T;
1974
1975/*
Bram Moolenaar8d739de2020-10-14 19:39:19 +02001976 * Entry for "sn_all_vars". Contains the s: variables from sn_vars plus the
1977 * block-local ones.
1978 */
1979typedef struct sallvar_S sallvar_T;
1980struct sallvar_S {
1981 sallvar_T *sav_next; // var with same name but different block
1982 int sav_block_id; // block ID where declared
1983 int sav_var_vals_idx; // index in sn_var_vals
1984
1985 // So long as the variable is valid (block it was defined in is still
1986 // active) "sav_di" is used. It is set to NULL when leaving the block,
1987 // then sav_tv and sav_flags are used.
1988 dictitem_T *sav_di; // dictitem with di_key and di_tv
1989 typval_T sav_tv; // type and value of the variable
1990 char_u sav_flags; // DI_FLAGS_ flags (only used for variable)
1991 char_u sav_key[1]; // key (actually longer!)
1992};
1993
1994/*
1995 * In the sn_all_vars hashtab item "hi_key" points to "sav_key" in a sallvar_T.
1996 * This makes it possible to store and find the sallvar_T.
1997 * SAV2HIKEY() converts a sallvar_T pointer to a hashitem key pointer.
1998 * HIKEY2SAV() converts a hashitem key pointer to a sallvar_T pointer.
1999 * HI2SAV() converts a hashitem pointer to a sallvar_T pointer.
2000 */
2001#define SAV2HIKEY(sav) ((sav)->sav_key)
2002#define HIKEY2SAV(p) ((sallvar_T *)(p - offsetof(sallvar_T, sav_key)))
2003#define HI2SAV(hi) HIKEY2SAV((hi)->hi_key)
2004
Bram Moolenaaraa7d0c22022-04-05 21:40:38 +01002005#define SVFLAG_TYPE_ALLOCATED 1 // call free_type() for "sv_type"
2006#define SVFLAG_EXPORTED 2 // "export let var = val"
2007#define SVFLAG_ASSIGNED 4 // assigned a value
2008
Bram Moolenaar8d739de2020-10-14 19:39:19 +02002009/*
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002010 * Entry for "sn_var_vals". Used for script-local variables.
2011 */
Bram Moolenaar9b8d6222020-12-28 18:26:00 +01002012struct svar_S {
Bram Moolenaar8d739de2020-10-14 19:39:19 +02002013 char_u *sv_name; // points into "sn_all_vars" di_key
2014 typval_T *sv_tv; // points into "sn_vars" or "sn_all_vars" di_tv
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002015 type_T *sv_type;
Bram Moolenaaraa7d0c22022-04-05 21:40:38 +01002016 int sv_flags; // SVFLAG_ values above
Bram Moolenaar08251752021-01-11 21:20:18 +01002017 int sv_const; // 0, ASSIGN_CONST or ASSIGN_FINAL
Bram Moolenaar9b8d6222020-12-28 18:26:00 +01002018};
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002019
2020typedef struct {
2021 char_u *imp_name; // name imported as (allocated)
Bram Moolenaard5f400c2022-01-06 21:10:28 +00002022 scid_T imp_sid; // script ID of "from"
Bram Moolenaara6294952020-12-27 13:39:50 +01002023 int imp_flags; // IMP_FLAGS_ values
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002024} imported_T;
2025
Bram Moolenaara6294952020-12-27 13:39:50 +01002026#define IMP_FLAGS_RELOAD 2 // script reloaded, OK to redefine
Bram Moolenaardc4451d2022-01-09 21:36:37 +00002027#define IMP_FLAGS_AUTOLOAD 4 // script still needs to be loaded
Bram Moolenaara6294952020-12-27 13:39:50 +01002028
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002029/*
dundargocc57b5bc2022-11-02 13:30:51 +00002030 * Info about an encountered script.
Dominique Pelleb49dfd02023-04-14 21:54:25 +01002031 * When sn_state has SN_STATE_NOT_LOADED, it has not been sourced yet.
Bram Moolenaar9bf703d2019-11-30 19:44:38 +01002032 */
Bram Moolenaar7ebcba62020-01-12 17:42:55 +01002033typedef struct
Bram Moolenaarfa55cfc2019-07-13 22:59:32 +02002034{
Bram Moolenaarc0ceeeb2022-03-30 21:12:27 +01002035 char_u *sn_name; // full path of script file
Bram Moolenaar4aab88d2020-12-24 21:56:41 +01002036 int sn_script_seq; // latest sctx_T sc_seq value
Bram Moolenaar7ebcba62020-01-12 17:42:55 +01002037
Bram Moolenaar753885b2022-08-24 16:30:36 +01002038 // When non-zero the script ID of the actually sourced script. Used if a
2039 // script is used by a name which has a symlink, we list both names, but
2040 // only the linked-to script is actually sourced.
2041 int sn_sourced_sid;
2042
Bram Moolenaar8d739de2020-10-14 19:39:19 +02002043 // "sn_vars" stores the s: variables currently valid. When leaving a block
2044 // variables local to that block are removed.
2045 scriptvar_T *sn_vars;
2046
2047 // Specific for a Vim9 script.
2048 // "sn_all_vars" stores all script variables ever declared. So long as the
2049 // variable is still valid the value is in "sn_vars->sv_dict...di_tv".
2050 // When the block of a declaration is left the value is moved to
2051 // "sn_all_vars..sav_tv".
2052 // Variables with duplicate names are possible, the sav_block_id must be
2053 // used to check that which variable is valid.
2054 dict_T sn_all_vars; // all script variables, dict of sallvar_T
2055
2056 // Stores the same variables as in "sn_all_vars" as a list of svar_T, so
2057 // that they can be quickly found by index instead of a hash table lookup.
2058 // Also stores the type.
2059 garray_T sn_var_vals;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002060
2061 garray_T sn_imports; // imported items, imported_T
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002062 garray_T sn_type_list; // keeps types used by variables
Bram Moolenaarfbbcd002020-10-15 12:46:44 +02002063 int sn_current_block_id; // ID for current block, 0 for outer
2064 int sn_last_block_id; // Unique ID for each script block
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002065
Bram Moolenaar7ebcba62020-01-12 17:42:55 +01002066 int sn_version; // :scriptversion
Bram Moolenaar2b327002020-12-26 15:39:31 +01002067 int sn_state; // SN_STATE_ values
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002068 char_u *sn_save_cpo; // 'cpo' value when :vim9script found
Bram Moolenaar71eb3ad2021-12-26 12:07:30 +00002069 char sn_is_vimrc; // .vimrc file, do not restore 'cpo'
Bram Moolenaarfe2ef0b2022-01-10 18:08:00 +00002070
Bram Moolenaarc0ceeeb2022-03-30 21:12:27 +01002071 // for a Vim9 script under "rtp/autoload/" this is "dir#scriptname#"
Bram Moolenaarfe2ef0b2022-01-10 18:08:00 +00002072 char_u *sn_autoload_prefix;
Bram Moolenaar7ebcba62020-01-12 17:42:55 +01002073
Bram Moolenaarc0ceeeb2022-03-30 21:12:27 +01002074 // TRUE for a script used with "import autoload './dirname/script.vim'"
Bram Moolenaarccbfd482022-03-31 16:18:23 +01002075 // For "../autoload/script.vim" sn_autoload_prefix is also set.
Bram Moolenaarc0ceeeb2022-03-30 21:12:27 +01002076 int sn_import_autoload;
2077
Bram Moolenaarfa55cfc2019-07-13 22:59:32 +02002078# ifdef FEAT_PROFILE
Bram Moolenaar4aea03e2019-09-25 22:37:17 +02002079 int sn_prof_on; // TRUE when script is/was profiled
2080 int sn_pr_force; // forceit: profile functions in this script
2081 proftime_T sn_pr_child; // time set when going into first child
2082 int sn_pr_nest; // nesting for sn_pr_child
2083 // profiling the script as a whole
2084 int sn_pr_count; // nr of times sourced
2085 proftime_T sn_pr_total; // time spent in script + children
2086 proftime_T sn_pr_self; // time spent in script itself
2087 proftime_T sn_pr_start; // time at script start
2088 proftime_T sn_pr_children; // time in children after script start
2089 // profiling the script per line
2090 garray_T sn_prl_ga; // things stored for every line
2091 proftime_T sn_prl_start; // start time for current line
2092 proftime_T sn_prl_children; // time spent in children for this line
2093 proftime_T sn_prl_wait; // wait start time for current line
2094 int sn_prl_idx; // index of line being timed; -1 if none
2095 int sn_prl_execed; // line being timed was executed
Bram Moolenaarfa55cfc2019-07-13 22:59:32 +02002096# endif
2097} scriptitem_T;
2098
Bram Moolenaar2b327002020-12-26 15:39:31 +01002099#define SN_STATE_NEW 0 // newly loaded script, nothing done
Bram Moolenaardc4451d2022-01-09 21:36:37 +00002100#define SN_STATE_NOT_LOADED 1 // script located but not loaded
2101#define SN_STATE_RELOAD 2 // script loaded before, nothing done
Bram Moolenaar2b327002020-12-26 15:39:31 +01002102#define SN_STATE_HAD_COMMAND 9 // a command was executed
2103
Bram Moolenaar5409f5d2020-06-24 18:37:35 +02002104// Struct passed through eval() functions.
2105// See EVALARG_EVALUATE for a fixed value with eval_flags set to EVAL_EVALUATE.
2106typedef struct {
Bram Moolenaarb7a78f72020-06-28 18:43:40 +02002107 int eval_flags; // EVAL_ flag values below
2108 int eval_break_count; // nr of line breaks consumed
Bram Moolenaar5409f5d2020-06-24 18:37:35 +02002109
2110 // copied from exarg_T when "getline" is "getsourceline". Can be NULL.
Bram Moolenaar66250c92020-08-20 15:02:42 +02002111 char_u *(*eval_getline)(int, void *, int, getline_opt_T);
Bram Moolenaarb7a78f72020-06-28 18:43:40 +02002112 void *eval_cookie; // argument for eval_getline()
Bram Moolenaarb171fb12020-06-24 20:34:03 +02002113
Bram Moolenaar7a4b8982020-07-08 17:36:21 +02002114 // used when compiling a :def function, NULL otherwise
2115 cctx_T *eval_cctx;
2116
Bram Moolenaar2eb6fc32021-07-25 14:13:53 +02002117 // used when executing commands from a script, NULL otherwise
2118 cstack_T *eval_cstack;
2119
Bram Moolenaare40fbc22020-06-27 18:06:45 +02002120 // Used to collect lines while parsing them, so that they can be
2121 // concatenated later. Used when "eval_ga.ga_itemsize" is not zero.
2122 // "eval_ga.ga_data" is a list of pointers to lines.
Bram Moolenaarecb66452021-05-18 15:09:18 +02002123 // "eval_freega" list pointers that need to be freed after concatenating.
Bram Moolenaare40fbc22020-06-27 18:06:45 +02002124 garray_T eval_ga;
Bram Moolenaarecb66452021-05-18 15:09:18 +02002125 garray_T eval_freega;
Bram Moolenaare40fbc22020-06-27 18:06:45 +02002126
Bram Moolenaar8e2730a2020-07-08 22:01:49 +02002127 // pointer to the last line obtained with getsourceline()
Bram Moolenaarb171fb12020-06-24 20:34:03 +02002128 char_u *eval_tofree;
Bram Moolenaar8e2730a2020-07-08 22:01:49 +02002129
Bram Moolenaar844fb642021-10-23 13:32:30 +01002130 // array with lines of an inline function
2131 garray_T eval_tofree_ga;
2132
2133 // set when "arg" points into the last entry of "eval_tofree_ga"
2134 int eval_using_cmdline;
Bram Moolenaar67da21a2021-03-21 22:12:34 +01002135
Bram Moolenaar8e2730a2020-07-08 22:01:49 +02002136 // pointer to the lines concatenated for a lambda.
2137 char_u *eval_tofree_lambda;
Bram Moolenaar5409f5d2020-06-24 18:37:35 +02002138} evalarg_T;
2139
zeertzjqb7f6f932023-04-13 22:12:50 +01002140// Flag for expression evaluation.
Bram Moolenaar5409f5d2020-06-24 18:37:35 +02002141#define EVAL_EVALUATE 1 // when missing don't actually evaluate
Bram Moolenaar5409f5d2020-06-24 18:37:35 +02002142
Bram Moolenaarfa55cfc2019-07-13 22:59:32 +02002143# ifdef FEAT_PROFILE
Bram Moolenaar9bf703d2019-11-30 19:44:38 +01002144/*
2145 * Struct used in sn_prl_ga for every line of a script.
2146 */
Bram Moolenaarfa55cfc2019-07-13 22:59:32 +02002147typedef struct sn_prl_S
2148{
Bram Moolenaar4aea03e2019-09-25 22:37:17 +02002149 int snp_count; // nr of times line was executed
2150 proftime_T sn_prl_total; // time spent in a line + children
2151 proftime_T sn_prl_self; // time spent in a line itself
Bram Moolenaarfa55cfc2019-07-13 22:59:32 +02002152} sn_prl_T;
2153
2154# define PRL_ITEM(si, idx) (((sn_prl_T *)(si)->sn_prl_ga.ga_data)[(idx)])
Bram Moolenaarb2049902021-01-24 12:53:53 +01002155
2156typedef struct {
2157 int pi_started_profiling;
2158 proftime_T pi_wait_start;
2159 proftime_T pi_call_start;
2160} profinfo_T;
2161
Bram Moolenaarf002a412021-01-24 13:34:18 +01002162# else
2163typedef struct
2164{
2165 int dummy;
2166} profinfo_T;
Bram Moolenaarfa55cfc2019-07-13 22:59:32 +02002167# endif
Bram Moolenaaracadbea2016-08-01 16:35:59 +02002168#else
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002169// dummy typedefs for use in function prototypes
Bram Moolenaar83c43ab2022-12-08 16:10:01 +00002170struct ufunc_S
Bram Moolenaaracadbea2016-08-01 16:35:59 +02002171{
2172 int dummy;
Bram Moolenaar83c43ab2022-12-08 16:10:01 +00002173};
Bram Moolenaaracadbea2016-08-01 16:35:59 +02002174typedef struct
2175{
2176 int dummy;
Bram Moolenaarfa55cfc2019-07-13 22:59:32 +02002177} funccall_T;
2178typedef struct
2179{
2180 int dummy;
Bram Moolenaaracadbea2016-08-01 16:35:59 +02002181} funcdict_T;
Bram Moolenaard95c3c22018-10-14 22:38:09 +02002182typedef struct
2183{
2184 int dummy;
2185} funccal_entry_T;
Bram Moolenaarfa55cfc2019-07-13 22:59:32 +02002186typedef struct
2187{
2188 int dummy;
2189} scriptitem_T;
Bram Moolenaar9d40c632020-06-24 19:05:29 +02002190typedef struct
2191{
2192 int dummy;
2193} evalarg_T;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02002194#endif
2195
Bram Moolenaar505e43a2019-08-03 18:28:17 +02002196// Struct passed between functions dealing with function call execution.
2197//
zeertzjq48db5da2022-09-16 12:10:03 +01002198// "fe_argv_func", when not NULL, can be used to fill in arguments only when the
Bram Moolenaar505e43a2019-08-03 18:28:17 +02002199// invoked function uses them. It is called like this:
zeertzjq48db5da2022-09-16 12:10:03 +01002200// new_argcount = fe_argv_func(current_argcount, argv, partial_argcount,
2201// called_func)
Bram Moolenaar505e43a2019-08-03 18:28:17 +02002202//
2203typedef struct {
zeertzjq48db5da2022-09-16 12:10:03 +01002204 int (* fe_argv_func)(int, typval_T *, int, ufunc_T *);
Bram Moolenaar851f86b2021-12-13 14:26:44 +00002205 linenr_T fe_firstline; // first line of range
2206 linenr_T fe_lastline; // last line of range
2207 int *fe_doesrange; // if not NULL: return: function handled range
2208 int fe_evaluate; // actually evaluate expressions
Bram Moolenaar5ca05fa2023-06-10 16:45:13 +01002209 ufunc_T *fe_ufunc; // function to be called, when NULL lookup by
2210 // name
2211 partial_T *fe_partial; // for "dict" and extra arguments
Bram Moolenaar851f86b2021-12-13 14:26:44 +00002212 dict_T *fe_selfdict; // Dictionary for "self"
Bram Moolenaarffdaca92022-12-09 21:41:48 +00002213 object_T *fe_object; // object, e.g. for "this.Func()"
Bram Moolenaar851f86b2021-12-13 14:26:44 +00002214 typval_T *fe_basetv; // base for base->method()
2215 type_T *fe_check_type; // type from funcref or NULL
Bram Moolenaar2ef91562021-12-11 16:14:07 +00002216 int fe_found_var; // if the function is not found then give an
2217 // error that a variable is not callable.
Bram Moolenaar505e43a2019-08-03 18:28:17 +02002218} funcexe_T;
2219
Bram Moolenaarf7779c62020-05-03 15:38:16 +02002220/*
2221 * Structure to hold the context of a compiled function, used by closures
2222 * defined in that function.
2223 */
Bram Moolenaar7509ad82021-12-14 18:14:37 +00002224typedef struct funcstack_S funcstack_T;
Bram Moolenaar7509ad82021-12-14 18:14:37 +00002225struct funcstack_S
Bram Moolenaarf7779c62020-05-03 15:38:16 +02002226{
Bram Moolenaar7509ad82021-12-14 18:14:37 +00002227 funcstack_T *fs_next; // linked list at "first_funcstack"
2228 funcstack_T *fs_prev;
2229
Bram Moolenaarf7779c62020-05-03 15:38:16 +02002230 garray_T fs_ga; // contains the stack, with:
2231 // - arguments
2232 // - frame
2233 // - local variables
Bram Moolenaar85d5e2b2020-10-10 14:13:01 +02002234 int fs_var_offset; // count of arguments + frame size == offset to
2235 // local variables
Bram Moolenaarf7779c62020-05-03 15:38:16 +02002236
2237 int fs_refcount; // nr of closures referencing this funcstack
Bram Moolenaar85d5e2b2020-10-10 14:13:01 +02002238 int fs_min_refcount; // nr of closures on this funcstack
Bram Moolenaar0cdfb7c2022-09-17 15:44:52 +01002239 int fs_copyID; // for garbage collection
2240};
2241
2242/*
dundargocc57b5bc2022-11-02 13:30:51 +00002243 * Structure to hold the variables declared in a loop that are possibly used
Bram Moolenaar0cdfb7c2022-09-17 15:44:52 +01002244 * in a closure.
2245 */
2246typedef struct loopvars_S loopvars_T;
2247struct loopvars_S
2248{
2249 loopvars_T *lvs_next; // linked list at "first_loopvars"
2250 loopvars_T *lvs_prev;
2251
2252 garray_T lvs_ga; // contains the variables
2253 int lvs_refcount; // nr of closures referencing this loopvars
2254 int lvs_min_refcount; // nr of closures on this loopvars
2255 int lvs_copyID; // for garbage collection
Bram Moolenaar7509ad82021-12-14 18:14:37 +00002256};
Bram Moolenaarf7779c62020-05-03 15:38:16 +02002257
Bram Moolenaarcc341812022-09-19 15:54:34 +01002258// maximum nesting of :while and :for loops in a :def function
2259#define MAX_LOOP_DEPTH 10
2260
Bram Moolenaar0186e582021-01-10 18:33:11 +01002261typedef struct outer_S outer_T;
2262struct outer_S {
Bram Moolenaar8fa745e2022-09-16 19:04:24 +01002263 garray_T *out_stack; // stack from outer scope, or a copy
2264 // containing only arguments and local vars
Bram Moolenaar0186e582021-01-10 18:33:11 +01002265 int out_frame_idx; // index of stack frame in out_stack
2266 outer_T *out_up; // outer scope of outer scope or NULL
Bram Moolenaarc04f2a42021-06-09 19:30:03 +02002267 partial_T *out_up_partial; // partial owning out_up or NULL
Bram Moolenaar8fa745e2022-09-16 19:04:24 +01002268
Bram Moolenaarcc341812022-09-19 15:54:34 +01002269 struct {
2270 garray_T *stack; // stack from outer scope, or a copy
Bram Moolenaar8fa745e2022-09-16 19:04:24 +01002271 // containing only vars inside the loop
Bram Moolenaarcc341812022-09-19 15:54:34 +01002272 short var_idx; // first variable defined in a loop in
2273 // out_loop_stack
2274 short var_count; // number of variables defined in a loop
2275 } out_loop[MAX_LOOP_DEPTH];
Bram Moolenaar6d313be2022-09-22 16:36:25 +01002276 int out_loop_size; // nr of used entries in out_loop[]
Bram Moolenaar0186e582021-01-10 18:33:11 +01002277};
2278
Bram Moolenaar1735bc92016-03-14 23:05:14 +01002279struct partial_S
2280{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002281 int pt_refcount; // reference count
Dominique Pelle3276f582021-08-07 12:44:41 +02002282 int pt_auto; // when TRUE the partial was created for using
2283 // dict.member in handle_subscript()
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002284 char_u *pt_name; // function name; when NULL use
2285 // pt_func->uf_name
2286 ufunc_T *pt_func; // function pointer; when NULL lookup function
2287 // with pt_name
Bram Moolenaarf7779c62020-05-03 15:38:16 +02002288
Bram Moolenaar0186e582021-01-10 18:33:11 +01002289 // For a compiled closure: the arguments and local variables scope
2290 outer_T pt_outer;
2291
Bram Moolenaar7aca5ca2022-02-07 19:56:43 +00002292 // For a partial of a partial: use pt_outer values of this partial.
2293 partial_T *pt_outer_partial;
2294
Bram Moolenaar0186e582021-01-10 18:33:11 +01002295 funcstack_T *pt_funcstack; // copy of stack, used after context
2296 // function returns
Bram Moolenaarcc341812022-09-19 15:54:34 +01002297 loopvars_T *(pt_loopvars[MAX_LOOP_DEPTH]);
2298 // copy of loop variables, used after loop
Bram Moolenaar0cdfb7c2022-09-17 15:44:52 +01002299 // block ends
Bram Moolenaarf7779c62020-05-03 15:38:16 +02002300
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002301 typval_T *pt_argv; // arguments in allocated array
Dominique Pelle3276f582021-08-07 12:44:41 +02002302 int pt_argc; // number of arguments
Bram Moolenaarf7779c62020-05-03 15:38:16 +02002303
Bram Moolenaarb68b3462020-05-06 21:06:30 +02002304 int pt_copyID; // funcstack may contain pointer to partial
Dominique Pelle3276f582021-08-07 12:44:41 +02002305 dict_T *pt_dict; // dict for "self"
Bram Moolenaar1735bc92016-03-14 23:05:14 +01002306};
2307
Bram Moolenaarcc341812022-09-19 15:54:34 +01002308typedef struct {
2309 short lvi_depth; // current nested loop depth
2310 struct {
2311 short var_idx; // index of first variable inside loop
2312 short var_count; // number of variables inside loop
2313 } lvi_loop[MAX_LOOP_DEPTH];
2314} loopvarinfo_T;
2315
LemonBoyeca7c602022-04-14 15:39:43 +01002316typedef struct AutoPatCmd_S AutoPatCmd_T;
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01002317
2318/*
2319 * Entry in the execution stack "exestack".
2320 */
2321typedef enum {
2322 ETYPE_TOP, // toplevel
Bram Moolenaar6ed545e2022-05-09 20:09:23 +01002323 ETYPE_SCRIPT, // sourcing script, use es_info.sctx
2324 ETYPE_UFUNC, // user function, use es_info.ufunc
2325 ETYPE_AUCMD, // autocomand, use es_info.aucmd
2326 ETYPE_MODELINE, // modeline, use es_info.sctx
2327 ETYPE_EXCEPT, // exception, use es_info.exception
2328 ETYPE_ARGS, // command line argument
2329 ETYPE_ENV, // environment variable
2330 ETYPE_INTERNAL, // internal operation
2331 ETYPE_SPELL, // loading spell file
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01002332} etype_T;
2333
2334typedef struct {
2335 long es_lnum; // replaces "sourcing_lnum"
2336 char_u *es_name; // replaces "sourcing_name"
2337 etype_T es_type;
2338 union {
2339 sctx_T *sctx; // script and modeline info
2340#if defined(FEAT_EVAL)
2341 ufunc_T *ufunc; // function info
2342#endif
LemonBoyeca7c602022-04-14 15:39:43 +01002343 AutoPatCmd_T *aucmd; // autocommand info
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01002344 except_T *except; // exception info
2345 } es_info;
Bram Moolenaarc620c052020-07-08 15:16:19 +02002346#if defined(FEAT_EVAL)
Bram Moolenaarc70fe462021-04-17 17:59:19 +02002347 sctx_T es_save_sctx; // saved current_sctx when calling function
Bram Moolenaarc620c052020-07-08 15:16:19 +02002348#endif
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01002349} estack_T;
2350
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002351// Information returned by get_tty_info().
Bram Moolenaar6b93b0e2017-08-13 20:28:53 +02002352typedef struct {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002353 int backspace; // what the Backspace key produces
2354 int enter; // what the Enter key produces
2355 int interrupt; // interrupt character
2356 int nl_does_cr; // TRUE when a NL is expanded to CR-NL on output
Bram Moolenaar6b93b0e2017-08-13 20:28:53 +02002357} ttyinfo_T;
2358
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002359// Status of a job. Order matters!
Bram Moolenaar835dc632016-02-07 14:27:38 +01002360typedef enum
2361{
2362 JOB_FAILED,
2363 JOB_STARTED,
Bram Moolenaarea3ece42018-04-17 20:14:39 +02002364 JOB_ENDED, // detected job done
2365 JOB_FINISHED, // job done and cleanup done
Bram Moolenaar835dc632016-02-07 14:27:38 +01002366} jobstatus_T;
2367
2368/*
2369 * Structure to hold info about a Job.
2370 */
2371struct jobvar_S
2372{
Bram Moolenaar65edff82016-02-21 16:40:11 +01002373 job_T *jv_next;
2374 job_T *jv_prev;
Bram Moolenaar835dc632016-02-07 14:27:38 +01002375#ifdef UNIX
2376 pid_t jv_pid;
Bram Moolenaar835dc632016-02-07 14:27:38 +01002377#endif
Bram Moolenaar4f974752019-02-17 17:44:42 +01002378#ifdef MSWIN
Bram Moolenaar76467df2016-02-12 19:30:26 +01002379 PROCESS_INFORMATION jv_proc_info;
Bram Moolenaar14207f42016-10-27 21:13:10 +02002380 HANDLE jv_job_object;
Bram Moolenaar835dc632016-02-07 14:27:38 +01002381#endif
Dominique Pelle3276f582021-08-07 12:44:41 +02002382 jobstatus_T jv_status;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002383 char_u *jv_tty_in; // controlling tty input, allocated
2384 char_u *jv_tty_out; // controlling tty output, allocated
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002385 char_u *jv_stoponexit; // allocated
Bram Moolenaarb3051ce2019-01-31 15:52:11 +01002386#ifdef UNIX
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002387 char_u *jv_termsig; // allocated
Bram Moolenaarb3051ce2019-01-31 15:52:11 +01002388#endif
Bram Moolenaar4f974752019-02-17 17:44:42 +01002389#ifdef MSWIN
Bram Moolenaarc6ddce32019-02-08 12:47:03 +01002390 char_u *jv_tty_type; // allocated
2391#endif
Bram Moolenaareab089d2016-02-21 19:32:02 +01002392 int jv_exitval;
Bram Moolenaar3a97bb32019-06-01 13:28:35 +02002393 callback_T jv_exit_cb;
Bram Moolenaar835dc632016-02-07 14:27:38 +01002394
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002395 buf_T *jv_in_buf; // buffer from "in-name"
Bram Moolenaar014069a2016-03-03 22:51:40 +01002396
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002397 int jv_refcount; // reference count
Bram Moolenaar107e1ee2016-04-08 17:07:19 +02002398 int jv_copyID;
2399
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002400 channel_T *jv_channel; // channel for I/O, reference counted
2401 char **jv_argv; // command line used to start the job
Bram Moolenaar835dc632016-02-07 14:27:38 +01002402};
2403
Bram Moolenaar6463ca22016-02-13 17:04:46 +01002404/*
2405 * Structures to hold info about a Channel.
2406 */
2407struct readq_S
2408{
Bram Moolenaar77073442016-02-13 23:23:53 +01002409 char_u *rq_buffer;
Bram Moolenaar9ed96ef2016-06-04 17:17:11 +02002410 long_u rq_buflen;
Bram Moolenaar77073442016-02-13 23:23:53 +01002411 readq_T *rq_next;
2412 readq_T *rq_prev;
Bram Moolenaar6463ca22016-02-13 17:04:46 +01002413};
2414
Bram Moolenaar97bd5e62017-08-18 20:50:30 +02002415struct writeq_S
2416{
2417 garray_T wq_ga;
2418 writeq_T *wq_next;
2419 writeq_T *wq_prev;
2420};
2421
Bram Moolenaar6463ca22016-02-13 17:04:46 +01002422struct jsonq_S
2423{
Bram Moolenaar77073442016-02-13 23:23:53 +01002424 typval_T *jq_value;
2425 jsonq_T *jq_next;
2426 jsonq_T *jq_prev;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002427 int jq_no_callback; // TRUE when no callback was found
Bram Moolenaar6463ca22016-02-13 17:04:46 +01002428};
2429
2430struct cbq_S
2431{
Bram Moolenaar3a97bb32019-06-01 13:28:35 +02002432 callback_T cq_callback;
Bram Moolenaar77073442016-02-13 23:23:53 +01002433 int cq_seq_nr;
2434 cbq_T *cq_next;
2435 cbq_T *cq_prev;
Bram Moolenaar6463ca22016-02-13 17:04:46 +01002436};
2437
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002438// mode for a channel
Bram Moolenaar6463ca22016-02-13 17:04:46 +01002439typedef enum
2440{
Bram Moolenaarac4174e2022-05-07 16:38:24 +01002441 CH_MODE_NL = 0,
2442 CH_MODE_RAW,
2443 CH_MODE_JSON,
2444 CH_MODE_JS,
2445 CH_MODE_LSP // Language Server Protocol (http + json)
Bram Moolenaar6463ca22016-02-13 17:04:46 +01002446} ch_mode_T;
2447
Bram Moolenaar580984e2016-03-20 21:17:13 +01002448typedef enum {
Bram Moolenaarea3ece42018-04-17 20:14:39 +02002449 JIO_PIPE, // default
Bram Moolenaar580984e2016-03-20 21:17:13 +01002450 JIO_NULL,
2451 JIO_FILE,
2452 JIO_BUFFER,
2453 JIO_OUT
2454} job_io_T;
2455
Bram Moolenaar7c9aec42017-08-03 13:51:25 +02002456#define CH_PART_FD(part) ch_part[part].ch_fd
2457
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002458// Ordering matters, it is used in for loops: IN is last, only SOCK/OUT/ERR
2459// are polled.
Bram Moolenaardc0ccae2016-10-09 17:28:01 +02002460typedef enum {
2461 PART_SOCK = 0,
Bram Moolenaar7c9aec42017-08-03 13:51:25 +02002462#define CH_SOCK_FD CH_PART_FD(PART_SOCK)
Bram Moolenaar509ce2a2016-03-11 22:52:15 +01002463#ifdef FEAT_JOB_CHANNEL
Bram Moolenaardc0ccae2016-10-09 17:28:01 +02002464 PART_OUT,
Bram Moolenaar7c9aec42017-08-03 13:51:25 +02002465# define CH_OUT_FD CH_PART_FD(PART_OUT)
Bram Moolenaardc0ccae2016-10-09 17:28:01 +02002466 PART_ERR,
Bram Moolenaar7c9aec42017-08-03 13:51:25 +02002467# define CH_ERR_FD CH_PART_FD(PART_ERR)
Bram Moolenaardc0ccae2016-10-09 17:28:01 +02002468 PART_IN,
Bram Moolenaar7c9aec42017-08-03 13:51:25 +02002469# define CH_IN_FD CH_PART_FD(PART_IN)
Bram Moolenaar7b3ca762016-02-14 19:13:43 +01002470#endif
Bram Moolenaarea3ece42018-04-17 20:14:39 +02002471 PART_COUNT,
Bram Moolenaardc0ccae2016-10-09 17:28:01 +02002472} ch_part_T;
2473
2474#define INVALID_FD (-1)
Bram Moolenaar7b3ca762016-02-14 19:13:43 +01002475
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002476// The per-fd info for a channel.
Bram Moolenaar7b3ca762016-02-14 19:13:43 +01002477typedef struct {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002478 sock_T ch_fd; // socket/stdin/stdout/stderr, -1 if not used
Bram Moolenaar7b3ca762016-02-14 19:13:43 +01002479
2480# if defined(UNIX) && !defined(HAVE_SELECT)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002481 int ch_poll_idx; // used by channel_poll_setup()
Bram Moolenaar7b3ca762016-02-14 19:13:43 +01002482# endif
2483
2484#ifdef FEAT_GUI_X11
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002485 XtInputId ch_inputHandler; // Cookie for input
Bram Moolenaar7b3ca762016-02-14 19:13:43 +01002486#endif
2487#ifdef FEAT_GUI_GTK
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002488 gint ch_inputHandler; // Cookie for input
Bram Moolenaar7b3ca762016-02-14 19:13:43 +01002489#endif
Bram Moolenaar42d38a22016-02-20 18:18:59 +01002490
2491 ch_mode_T ch_mode;
Bram Moolenaar580984e2016-03-20 21:17:13 +01002492 job_io_T ch_io;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002493 int ch_timeout; // request timeout in msec
Bram Moolenaar42d38a22016-02-20 18:18:59 +01002494
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002495 readq_T ch_head; // header for circular raw read queue
2496 jsonq_T ch_json_head; // header for circular json read queue
2497 garray_T ch_block_ids; // list of IDs that channel_read_json_block()
2498 // is waiting for
2499 // When ch_wait_len is non-zero use ch_deadline to wait for incomplete
2500 // message to be complete. The value is the length of the incomplete
2501 // message when the deadline was set. If it gets longer (something was
2502 // received) the deadline is reset.
Bram Moolenaar88989cc2017-02-06 21:56:09 +01002503 size_t ch_wait_len;
Bram Moolenaar4f974752019-02-17 17:44:42 +01002504#ifdef MSWIN
Bram Moolenaarba61ac02016-03-20 16:40:37 +01002505 DWORD ch_deadline;
2506#else
2507 struct timeval ch_deadline;
2508#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002509 int ch_block_write; // for testing: 0 when not used, -1 when write
2510 // does not block, 1 simulate blocking
2511 int ch_nonblocking; // write() is non-blocking
2512 writeq_T ch_writeque; // header for write queue
Bram Moolenaar42d38a22016-02-20 18:18:59 +01002513
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002514 cbq_T ch_cb_head; // dummy node for per-request callbacks
2515 callback_T ch_callback; // call when a msg is not handled
Bram Moolenaar014069a2016-03-03 22:51:40 +01002516
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002517 bufref_T ch_bufref; // buffer to read from or write to
2518 int ch_nomodifiable; // TRUE when buffer can be 'nomodifiable'
2519 int ch_nomod_error; // TRUE when e_modifiable was given
2520 int ch_buf_append; // write appended lines instead top-bot
2521 linenr_T ch_buf_top; // next line to send
2522 linenr_T ch_buf_bot; // last line to send
Bram Moolenaar42d38a22016-02-20 18:18:59 +01002523} chanpart_T;
Bram Moolenaar7b3ca762016-02-14 19:13:43 +01002524
Bram Moolenaar6463ca22016-02-13 17:04:46 +01002525struct channel_S {
Bram Moolenaar77073442016-02-13 23:23:53 +01002526 channel_T *ch_next;
2527 channel_T *ch_prev;
2528
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002529 int ch_id; // ID of the channel
2530 int ch_last_msg_id; // ID of the last message
Bram Moolenaar77073442016-02-13 23:23:53 +01002531
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002532 chanpart_T ch_part[PART_COUNT]; // info for socket, out, err and in
2533 int ch_write_text_mode; // write buffer lines with CR, not NL
Bram Moolenaar6463ca22016-02-13 17:04:46 +01002534
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002535 char *ch_hostname; // only for socket, allocated
2536 int ch_port; // only for socket
Bram Moolenaar580984e2016-03-20 21:17:13 +01002537
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002538 int ch_to_be_closed; // bitset of readable fds to be closed.
2539 // When all readable fds have been closed,
2540 // set to (1 << PART_COUNT).
2541 int ch_to_be_freed; // When TRUE channel must be freed when it's
2542 // safe to invoke callbacks.
2543 int ch_error; // When TRUE an error was reported. Avoids
2544 // giving pages full of error messages when
2545 // the other side has exited, only mention the
2546 // first error until the connection works
2547 // again.
Bram Moolenaar16eb4f82016-02-14 23:02:34 +01002548
Bram Moolenaar4e221c92016-02-23 13:20:22 +01002549 void (*ch_nb_close_cb)(void);
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002550 // callback for Netbeans when channel is
2551 // closed
Bram Moolenaar6463ca22016-02-13 17:04:46 +01002552
Bram Moolenaar4f974752019-02-17 17:44:42 +01002553#ifdef MSWIN
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002554 int ch_named_pipe; // using named pipe instead of pty
Bram Moolenaar2dc9d262017-09-08 14:39:30 +02002555#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002556 callback_T ch_callback; // call when any msg is not handled
2557 callback_T ch_close_cb; // call when channel is closed
Bram Moolenaar958dc692016-12-01 15:34:12 +01002558 int ch_drop_never;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002559 int ch_keep_open; // do not close on read error
Bram Moolenaar0b146882018-09-06 16:27:24 +02002560 int ch_nonblock;
Bram Moolenaar6463ca22016-02-13 17:04:46 +01002561
Bram Moolenaaraa5df7e2019-02-03 14:53:10 +01002562 job_T *ch_job; // Job that uses this channel; this does not
2563 // count as a reference to avoid a circular
2564 // reference, the job refers to the channel.
2565 int ch_job_killed; // TRUE when there was a job and it was killed
2566 // or we know it died.
2567 int ch_anonymous_pipe; // ConPTY
2568 int ch_killing; // TerminateJobObject() was called
Bram Moolenaar77073442016-02-13 23:23:53 +01002569
Bram Moolenaaraa5df7e2019-02-03 14:53:10 +01002570 int ch_refcount; // reference count
Bram Moolenaar107e1ee2016-04-08 17:07:19 +02002571 int ch_copyID;
Bram Moolenaar6463ca22016-02-13 17:04:46 +01002572};
2573
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002574#define JO_MODE 0x0001 // channel mode
2575#define JO_IN_MODE 0x0002 // stdin mode
2576#define JO_OUT_MODE 0x0004 // stdout mode
2577#define JO_ERR_MODE 0x0008 // stderr mode
2578#define JO_CALLBACK 0x0010 // channel callback
2579#define JO_OUT_CALLBACK 0x0020 // stdout callback
2580#define JO_ERR_CALLBACK 0x0040 // stderr callback
2581#define JO_CLOSE_CALLBACK 0x0080 // "close_cb"
2582#define JO_WAITTIME 0x0100 // only for ch_open()
2583#define JO_TIMEOUT 0x0200 // all timeouts
2584#define JO_OUT_TIMEOUT 0x0400 // stdout timeouts
2585#define JO_ERR_TIMEOUT 0x0800 // stderr timeouts
2586#define JO_PART 0x1000 // "part"
2587#define JO_ID 0x2000 // "id"
2588#define JO_STOPONEXIT 0x4000 // "stoponexit"
2589#define JO_EXIT_CB 0x8000 // "exit_cb"
2590#define JO_OUT_IO 0x10000 // "out_io"
2591#define JO_ERR_IO 0x20000 // "err_io" (JO_OUT_IO << 1)
2592#define JO_IN_IO 0x40000 // "in_io" (JO_OUT_IO << 2)
2593#define JO_OUT_NAME 0x80000 // "out_name"
2594#define JO_ERR_NAME 0x100000 // "err_name" (JO_OUT_NAME << 1)
2595#define JO_IN_NAME 0x200000 // "in_name" (JO_OUT_NAME << 2)
2596#define JO_IN_TOP 0x400000 // "in_top"
2597#define JO_IN_BOT 0x800000 // "in_bot"
2598#define JO_OUT_BUF 0x1000000 // "out_buf"
2599#define JO_ERR_BUF 0x2000000 // "err_buf" (JO_OUT_BUF << 1)
2600#define JO_IN_BUF 0x4000000 // "in_buf" (JO_OUT_BUF << 2)
2601#define JO_CHANNEL 0x8000000 // "channel"
2602#define JO_BLOCK_WRITE 0x10000000 // "block_write"
2603#define JO_OUT_MODIFIABLE 0x20000000 // "out_modifiable"
2604#define JO_ERR_MODIFIABLE 0x40000000 // "err_modifiable" (JO_OUT_ << 1)
Bram Moolenaar8b877ac2016-03-28 19:16:20 +02002605#define JO_ALL 0x7fffffff
Bram Moolenaar40ea1da2016-02-19 22:33:35 +01002606
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002607#define JO2_OUT_MSG 0x0001 // "out_msg"
2608#define JO2_ERR_MSG 0x0002 // "err_msg" (JO_OUT_ << 1)
2609#define JO2_TERM_NAME 0x0004 // "term_name"
2610#define JO2_TERM_FINISH 0x0008 // "term_finish"
2611#define JO2_ENV 0x0010 // "env"
2612#define JO2_CWD 0x0020 // "cwd"
2613#define JO2_TERM_ROWS 0x0040 // "term_rows"
2614#define JO2_TERM_COLS 0x0080 // "term_cols"
2615#define JO2_VERTICAL 0x0100 // "vertical"
2616#define JO2_CURWIN 0x0200 // "curwin"
2617#define JO2_HIDDEN 0x0400 // "hidden"
2618#define JO2_TERM_OPENCMD 0x0800 // "term_opencmd"
2619#define JO2_EOF_CHARS 0x1000 // "eof_chars"
2620#define JO2_NORESTORE 0x2000 // "norestore"
2621#define JO2_TERM_KILL 0x4000 // "term_kill"
2622#define JO2_ANSI_COLORS 0x8000 // "ansi_colors"
2623#define JO2_TTY_TYPE 0x10000 // "tty_type"
2624#define JO2_BUFNR 0x20000 // "bufnr"
Bram Moolenaard2842ea2019-09-26 23:08:54 +02002625#define JO2_TERM_API 0x40000 // "term_api"
Bram Moolenaar83d47902020-03-26 20:34:00 +01002626#define JO2_TERM_HIGHLIGHT 0x80000 // "highlight"
Bram Moolenaar169ebb02016-09-07 23:32:23 +02002627
Bram Moolenaarb6b52522016-02-20 23:30:07 +01002628#define JO_MODE_ALL (JO_MODE + JO_IN_MODE + JO_OUT_MODE + JO_ERR_MODE)
Bram Moolenaar4e221c92016-02-23 13:20:22 +01002629#define JO_CB_ALL \
2630 (JO_CALLBACK + JO_OUT_CALLBACK + JO_ERR_CALLBACK + JO_CLOSE_CALLBACK)
Bram Moolenaarb6b52522016-02-20 23:30:07 +01002631#define JO_TIMEOUT_ALL (JO_TIMEOUT + JO_OUT_TIMEOUT + JO_ERR_TIMEOUT)
2632
Bram Moolenaar9a6e33a2016-02-16 19:25:12 +01002633/*
Bram Moolenaar910b8aa2016-02-16 21:03:07 +01002634 * Options for job and channel commands.
Bram Moolenaar9a6e33a2016-02-16 19:25:12 +01002635 */
2636typedef struct
2637{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002638 int jo_set; // JO_ bits for values that were set
2639 int jo_set2; // JO2_ bits for values that were set
Bram Moolenaar40ea1da2016-02-19 22:33:35 +01002640
2641 ch_mode_T jo_mode;
Bram Moolenaarb6b52522016-02-20 23:30:07 +01002642 ch_mode_T jo_in_mode;
2643 ch_mode_T jo_out_mode;
2644 ch_mode_T jo_err_mode;
Bram Moolenaar0b146882018-09-06 16:27:24 +02002645 int jo_noblock;
Bram Moolenaar187db502016-02-27 14:44:26 +01002646
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002647 job_io_T jo_io[4]; // PART_OUT, PART_ERR, PART_IN
Bram Moolenaar187db502016-02-27 14:44:26 +01002648 char_u jo_io_name_buf[4][NUMBUFLEN];
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002649 char_u *jo_io_name[4]; // not allocated!
Bram Moolenaar29fd0382016-03-09 23:14:07 +01002650 int jo_io_buf[4];
Bram Moolenaar5a1feb82017-07-22 18:04:08 +02002651 int jo_pty;
Bram Moolenaar9f5842e2016-05-29 16:17:08 +02002652 int jo_modifiable[4];
Bram Moolenaar169ebb02016-09-07 23:32:23 +02002653 int jo_message[4];
Bram Moolenaarde279892016-03-11 22:19:44 +01002654 channel_T *jo_channel;
Bram Moolenaar187db502016-02-27 14:44:26 +01002655
Bram Moolenaar014069a2016-03-03 22:51:40 +01002656 linenr_T jo_in_top;
2657 linenr_T jo_in_bot;
2658
Bram Moolenaar3a97bb32019-06-01 13:28:35 +02002659 callback_T jo_callback;
2660 callback_T jo_out_cb;
2661 callback_T jo_err_cb;
2662 callback_T jo_close_cb;
2663 callback_T jo_exit_cb;
Bram Moolenaar958dc692016-12-01 15:34:12 +01002664 int jo_drop_never;
Bram Moolenaar40ea1da2016-02-19 22:33:35 +01002665 int jo_waittime;
2666 int jo_timeout;
Bram Moolenaarb6b52522016-02-20 23:30:07 +01002667 int jo_out_timeout;
2668 int jo_err_timeout;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002669 int jo_block_write; // for testing only
Bram Moolenaar6f3a5442016-02-20 19:56:13 +01002670 int jo_part;
2671 int jo_id;
Bram Moolenaar21109272020-01-30 16:27:20 +01002672 char_u jo_stoponexit_buf[NUMBUFLEN];
Bram Moolenaar65edff82016-02-21 16:40:11 +01002673 char_u *jo_stoponexit;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002674 dict_T *jo_env; // environment variables
Bram Moolenaar05aafed2017-08-11 19:12:11 +02002675 char_u jo_cwd_buf[NUMBUFLEN];
2676 char_u *jo_cwd;
Bram Moolenaar58556cd2017-07-20 23:04:46 +02002677
2678#ifdef FEAT_TERMINAL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002679 // when non-zero run the job in a terminal window of this size
Bram Moolenaar58556cd2017-07-20 23:04:46 +02002680 int jo_term_rows;
2681 int jo_term_cols;
Bram Moolenaar08d384f2017-08-11 21:51:23 +02002682 int jo_vertical;
Bram Moolenaarda43b612017-08-11 22:27:50 +02002683 int jo_curwin;
Bram Moolenaar87abab92019-06-03 21:14:59 +02002684 buf_T *jo_bufnr_buf;
Bram Moolenaar8cad9302017-08-12 14:32:32 +02002685 int jo_hidden;
Bram Moolenaar4d8bac82018-03-09 21:33:34 +01002686 int jo_term_norestore;
Bram Moolenaar21109272020-01-30 16:27:20 +01002687 char_u jo_term_name_buf[NUMBUFLEN];
Bram Moolenaar78712a72017-08-05 14:50:12 +02002688 char_u *jo_term_name;
Bram Moolenaar21109272020-01-30 16:27:20 +01002689 char_u jo_term_opencmd_buf[NUMBUFLEN];
Bram Moolenaar37c45832017-08-12 16:01:04 +02002690 char_u *jo_term_opencmd;
Bram Moolenaardd693ce2017-08-10 23:15:19 +02002691 int jo_term_finish;
Bram Moolenaar21109272020-01-30 16:27:20 +01002692 char_u jo_eof_chars_buf[NUMBUFLEN];
Bram Moolenaar3346cc42017-09-02 14:54:21 +02002693 char_u *jo_eof_chars;
Bram Moolenaar21109272020-01-30 16:27:20 +01002694 char_u jo_term_kill_buf[NUMBUFLEN];
Bram Moolenaar25cdd9c2018-03-10 20:28:12 +01002695 char_u *jo_term_kill;
Bram Moolenaarf59c6e82018-04-10 15:59:11 +02002696# if defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS)
2697 long_u jo_ansi_colors[16];
2698# endif
Bram Moolenaar83d47902020-03-26 20:34:00 +01002699 char_u jo_term_highlight_buf[NUMBUFLEN];
2700 char_u *jo_term_highlight;
Bram Moolenaarc6ddce32019-02-08 12:47:03 +01002701 int jo_tty_type; // first character of "tty_type"
Bram Moolenaard2842ea2019-09-26 23:08:54 +02002702 char_u jo_term_api_buf[NUMBUFLEN];
Bram Moolenaar21109272020-01-30 16:27:20 +01002703 char_u *jo_term_api;
Bram Moolenaar58556cd2017-07-20 23:04:46 +02002704#endif
Bram Moolenaar9a6e33a2016-02-16 19:25:12 +01002705} jobopt_T;
2706
Bram Moolenaar6d2399b2019-05-11 19:14:16 +02002707#ifdef FEAT_EVAL
2708/*
2709 * Structure used for listeners added with listener_add().
2710 */
2711typedef struct listener_S listener_T;
2712struct listener_S
2713{
2714 listener_T *lr_next;
2715 int lr_id;
Bram Moolenaar3a97bb32019-06-01 13:28:35 +02002716 callback_T lr_callback;
Bram Moolenaar6d2399b2019-05-11 19:14:16 +02002717};
2718#endif
Bram Moolenaar6463ca22016-02-13 17:04:46 +01002719
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002720/*
2721 * structure used for explicit stack while garbage collecting hash tables
2722 */
Bram Moolenaar2459a5e2015-02-03 12:55:18 +01002723typedef struct ht_stack_S
2724{
2725 hashtab_T *ht;
2726 struct ht_stack_S *prev;
2727} ht_stack_T;
2728
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002729/*
2730 * structure used for explicit stack while garbage collecting lists
2731 */
Bram Moolenaar2459a5e2015-02-03 12:55:18 +01002732typedef struct list_stack_S
2733{
2734 list_T *list;
2735 struct list_stack_S *prev;
2736} list_stack_T;
2737
Bram Moolenaar45e18cb2019-04-28 18:05:35 +02002738/*
2739 * Structure used for iterating over dictionary items.
2740 * Initialize with dict_iterate_start().
2741 */
2742typedef struct
2743{
2744 long_u dit_todo;
2745 hashitem_T *dit_hi;
2746} dict_iterator_T;
2747
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002748// values for b_syn_spell: what to do with toplevel text
2749#define SYNSPL_DEFAULT 0 // spell check if @Spell not defined
2750#define SYNSPL_TOP 1 // spell check toplevel text
2751#define SYNSPL_NOTOP 2 // don't spell check toplevel text
Bram Moolenaarce0842a2005-07-18 21:58:11 +00002752
Bram Moolenaare35a52a2020-05-31 19:48:53 +02002753// values for b_syn_foldlevel: how to compute foldlevel on a line
2754#define SYNFLD_START 0 // use level of item at start of line
2755#define SYNFLD_MINIMUM 1 // use lowest local minimum level on line
2756
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002757// avoid #ifdefs for when b_spell is not available
Bram Moolenaarb9a02fc2006-03-12 22:08:12 +00002758#ifdef FEAT_SPELL
Bram Moolenaar4770d092006-01-12 23:22:24 +00002759# define B_SPELL(buf) ((buf)->b_spell)
2760#else
2761# define B_SPELL(buf) (0)
2762#endif
2763
Bram Moolenaard12f5c12006-01-25 22:10:52 +00002764typedef struct qf_info_S qf_info_T;
Bram Moolenaardcaf10e2005-01-21 11:55:25 +00002765
Bram Moolenaarf7512552013-06-06 14:55:19 +02002766#ifdef FEAT_PROFILE
Bram Moolenaar8a7f5a22013-06-06 14:01:46 +02002767/*
2768 * Used for :syntime: timing of executing a syntax pattern.
2769 */
2770typedef struct {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002771 proftime_T total; // total time used
2772 proftime_T slowest; // time of slowest call
2773 long count; // nr of times used
2774 long match; // nr of times matched
Bram Moolenaar8a7f5a22013-06-06 14:01:46 +02002775} syn_time_T;
2776#endif
2777
Bram Moolenaar51fe3b12019-05-26 20:10:06 +02002778typedef struct timer_S timer_T;
2779struct timer_S
2780{
2781 long tr_id;
2782#ifdef FEAT_TIMERS
2783 timer_T *tr_next;
2784 timer_T *tr_prev;
Bram Moolenaar3a97bb32019-06-01 13:28:35 +02002785 proftime_T tr_due; // when the callback is to be invoked
2786 char tr_firing; // when TRUE callback is being called
2787 char tr_paused; // when TRUE callback is not invoked
Bram Moolenaar9198de32022-08-27 21:30:03 +01002788 char tr_keep; // when TRUE keep timer after it fired
Bram Moolenaar3a97bb32019-06-01 13:28:35 +02002789 int tr_repeat; // number of times to repeat, -1 forever
2790 long tr_interval; // msec
2791 callback_T tr_callback;
Bram Moolenaar51fe3b12019-05-26 20:10:06 +02002792 int tr_emsg_count;
2793#endif
2794};
2795
Bram Moolenaar8f4ac012014-08-10 13:38:34 +02002796#ifdef FEAT_CRYPT
2797/*
2798 * Structure to hold the type of encryption and the state of encryption or
2799 * decryption.
2800 */
2801typedef struct {
2802 int method_nr;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002803 void *method_state; // method-specific state information
Bram Moolenaar8f4ac012014-08-10 13:38:34 +02002804} cryptstate_T;
2805
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002806// values for method_nr
Bram Moolenaar8f4ac012014-08-10 13:38:34 +02002807# define CRYPT_M_ZIP 0
2808# define CRYPT_M_BF 1
2809# define CRYPT_M_BF2 2
Christian Brabandtf573c6e2021-06-20 14:02:16 +02002810# define CRYPT_M_SOD 3
Christian Brabandtaae58342023-04-23 17:50:22 +01002811# define CRYPT_M_SOD2 4
2812# define CRYPT_M_COUNT 5 // number of crypt methods
Bram Moolenaar987411d2019-01-18 22:48:34 +01002813
2814// Currently all crypt methods work inplace. If one is added that isn't then
2815// define this.
Christian Brabandtf573c6e2021-06-20 14:02:16 +02002816# define CRYPT_NOT_INPLACE 1
Christian Brabandtaae58342023-04-23 17:50:22 +01002817
2818// Struct for passing arguments down to the crypt_init functions
2819typedef struct {
2820 char_u *cat_salt;
2821 int cat_salt_len;
2822 char_u *cat_seed;
2823 int cat_seed_len;
2824 char_u *cat_add;
2825 int cat_add_len;
2826 int cat_init_from_file;
2827} crypt_arg_T;
2828
Bram Moolenaar8f4ac012014-08-10 13:38:34 +02002829#endif
2830
Bram Moolenaar05ad5ff2019-11-30 22:48:27 +01002831#ifdef FEAT_PROP_POPUP
Bram Moolenaarac1f1bc2019-05-30 21:24:26 +02002832typedef enum {
2833 POPPOS_BOTLEFT,
2834 POPPOS_TOPLEFT,
2835 POPPOS_BOTRIGHT,
2836 POPPOS_TOPRIGHT,
Bram Moolenaar4dd8fe02019-11-09 15:33:31 +01002837 POPPOS_CENTER,
Bram Moolenaar37fef162022-08-29 18:16:32 +01002838 POPPOS_BOTTOM, // bottom of popup just above the command line
Bram Moolenaar4dd8fe02019-11-09 15:33:31 +01002839 POPPOS_NONE
Bram Moolenaarac1f1bc2019-05-30 21:24:26 +02002840} poppos_T;
Bram Moolenaar6c009a32019-06-08 16:06:28 +02002841
Bram Moolenaar2e62b562019-06-30 18:07:00 +02002842typedef enum {
2843 POPCLOSE_NONE,
2844 POPCLOSE_BUTTON,
2845 POPCLOSE_CLICK
2846} popclose_T;
2847
Bram Moolenaar68d48f42019-06-12 22:42:41 +02002848# define POPUPWIN_DEFAULT_ZINDEX 50
2849# define POPUPMENU_ZINDEX 100
Bram Moolenaara42d9452019-06-15 21:46:30 +02002850# define POPUPWIN_DIALOG_ZINDEX 200
2851# define POPUPWIN_NOTIFICATION_ZINDEX 300
Bram Moolenaarac1f1bc2019-05-30 21:24:26 +02002852#endif
Bram Moolenaar8f4ac012014-08-10 13:38:34 +02002853
Bram Moolenaar362ce482012-06-06 19:02:45 +02002854/*
2855 * These are items normally related to a buffer. But when using ":ownsyntax"
2856 * a window may have its own instance.
2857 */
Bram Moolenaar860cae12010-06-05 23:22:07 +02002858typedef struct {
2859#ifdef FEAT_SYN_HL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002860 hashtab_T b_keywtab; // syntax keywords hash table
2861 hashtab_T b_keywtab_ic; // idem, ignore case
2862 int b_syn_error; // TRUE when error occurred in HL
Bram Moolenaar06f1ed22017-06-18 22:41:03 +02002863# ifdef FEAT_RELTIME
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002864 int b_syn_slow; // TRUE when 'redrawtime' reached
Bram Moolenaar06f1ed22017-06-18 22:41:03 +02002865# endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002866 int b_syn_ic; // ignore case for :syn cmds
Bram Moolenaare35a52a2020-05-31 19:48:53 +02002867 int b_syn_foldlevel; // how to compute foldlevel on a line
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002868 int b_syn_spell; // SYNSPL_ values
2869 garray_T b_syn_patterns; // table for syntax patterns
2870 garray_T b_syn_clusters; // table for syntax clusters
2871 int b_spell_cluster_id; // @Spell cluster ID or 0
2872 int b_nospell_cluster_id; // @NoSpell cluster ID or 0
2873 int b_syn_containedin; // TRUE when there is an item with a
2874 // "containedin" argument
2875 int b_syn_sync_flags; // flags about how to sync
2876 short b_syn_sync_id; // group to sync on
2877 long b_syn_sync_minlines; // minimal sync lines offset
2878 long b_syn_sync_maxlines; // maximal sync lines offset
2879 long b_syn_sync_linebreaks; // offset for multi-line pattern
2880 char_u *b_syn_linecont_pat; // line continuation pattern
2881 regprog_T *b_syn_linecont_prog; // line continuation program
Bram Moolenaarf7512552013-06-06 14:55:19 +02002882#ifdef FEAT_PROFILE
Bram Moolenaar8a7f5a22013-06-06 14:01:46 +02002883 syn_time_T b_syn_linecont_time;
2884#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002885 int b_syn_linecont_ic; // ignore-case flag for above
2886 int b_syn_topgrp; // for ":syntax include"
Bram Moolenaar860cae12010-06-05 23:22:07 +02002887# ifdef FEAT_CONCEAL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002888 int b_syn_conceal; // auto-conceal for :syn cmds
Bram Moolenaar860cae12010-06-05 23:22:07 +02002889# endif
2890# ifdef FEAT_FOLDING
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002891 int b_syn_folditems; // number of patterns with the HL_FOLD
2892 // flag set
Bram Moolenaar860cae12010-06-05 23:22:07 +02002893# endif
Bram Moolenaar8765a4a2010-07-27 22:41:43 +02002894 /*
2895 * b_sst_array[] contains the state stack for a number of lines, for the
2896 * start of that line (col == 0). This avoids having to recompute the
2897 * syntax state too often.
2898 * b_sst_array[] is allocated to hold the state for all displayed lines,
2899 * and states for 1 out of about 20 other lines.
2900 * b_sst_array pointer to an array of synstate_T
2901 * b_sst_len number of entries in b_sst_array[]
2902 * b_sst_first pointer to first used entry in b_sst_array[] or NULL
2903 * b_sst_firstfree pointer to first free entry in b_sst_array[] or NULL
2904 * b_sst_freecount number of free entries in b_sst_array[]
2905 * b_sst_check_lnum entries after this lnum need to be checked for
2906 * validity (MAXLNUM means no check needed)
2907 */
Bram Moolenaar860cae12010-06-05 23:22:07 +02002908 synstate_T *b_sst_array;
2909 int b_sst_len;
2910 synstate_T *b_sst_first;
2911 synstate_T *b_sst_firstfree;
2912 int b_sst_freecount;
2913 linenr_T b_sst_check_lnum;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002914 short_u b_sst_lasttick; // last display tick
2915#endif // FEAT_SYN_HL
Bram Moolenaar860cae12010-06-05 23:22:07 +02002916
2917#ifdef FEAT_SPELL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002918 // for spell checking
2919 garray_T b_langp; // list of pointers to slang_T, see spell.c
2920 char_u b_spell_ismw[256]; // flags: is midword char
2921 char_u *b_spell_ismw_mb; // multi-byte midword chars
2922 char_u *b_p_spc; // 'spellcapcheck'
2923 regprog_T *b_cap_prog; // program for 'spellcapcheck'
2924 char_u *b_p_spf; // 'spellfile'
2925 char_u *b_p_spl; // 'spelllang'
Bram Moolenaar215f49c2020-06-10 22:12:04 +02002926 char_u *b_p_spo; // 'spelloptions'
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002927 int b_cjk; // all CJK letters as OK
Bram Moolenaar860cae12010-06-05 23:22:07 +02002928#endif
Bram Moolenaar8765a4a2010-07-27 22:41:43 +02002929#if !defined(FEAT_SYN_HL) && !defined(FEAT_SPELL)
2930 int dummy;
2931#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002932 char_u b_syn_chartab[32]; // syntax iskeyword option
2933 char_u *b_syn_isk; // iskeyword option
Bram Moolenaar860cae12010-06-05 23:22:07 +02002934} synblock_T;
2935
2936
Bram Moolenaar071d4272004-06-13 20:20:40 +00002937/*
2938 * buffer: structure that holds information about one file
2939 *
2940 * Several windows can share a single Buffer
2941 * A buffer is unallocated if there is no memfile for it.
2942 * A buffer is new if the associated file has never been loaded yet.
2943 */
2944
Bram Moolenaar071d4272004-06-13 20:20:40 +00002945struct file_buffer
2946{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002947 memline_T b_ml; // associated memline (also contains line
2948 // count)
Bram Moolenaar071d4272004-06-13 20:20:40 +00002949
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002950 buf_T *b_next; // links in list of buffers
Bram Moolenaar071d4272004-06-13 20:20:40 +00002951 buf_T *b_prev;
2952
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002953 int b_nwindows; // nr of windows open on this buffer
Bram Moolenaar071d4272004-06-13 20:20:40 +00002954
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002955 int b_flags; // various BF_ flags
2956 int b_locked; // Buffer is being closed or referenced, don't
2957 // let autocommands wipe it out.
Bram Moolenaar983d83f2021-02-07 12:12:43 +01002958 int b_locked_split; // Buffer is being closed, don't allow opening
2959 // a new window with it.
Bram Moolenaar071d4272004-06-13 20:20:40 +00002960
2961 /*
2962 * b_ffname has the full path of the file (NULL for no name).
2963 * b_sfname is the name as the user typed it (or NULL).
2964 * b_fname is the same as b_sfname, unless ":cd" has been done,
2965 * then it is the same as b_ffname (NULL for no name).
2966 */
Bram Moolenaar3d6014f2018-10-11 19:27:47 +02002967 char_u *b_ffname; // full path file name, allocated
2968 char_u *b_sfname; // short file name, allocated, may be equal to
2969 // b_ffname
2970 char_u *b_fname; // current file name, points to b_ffname or
2971 // b_sfname
Bram Moolenaar071d4272004-06-13 20:20:40 +00002972
2973#ifdef UNIX
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002974 int b_dev_valid; // TRUE when b_dev has a valid number
2975 dev_t b_dev; // device number
2976 ino_t b_ino; // inode number
Bram Moolenaar071d4272004-06-13 20:20:40 +00002977#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00002978#ifdef VMS
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002979 char b_fab_rfm; // Record format
2980 char b_fab_rat; // Record attribute
2981 unsigned int b_fab_mrs; // Max record size
Bram Moolenaar071d4272004-06-13 20:20:40 +00002982#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002983 int b_fnum; // buffer number for this file.
Bram Moolenaar480778b2016-07-14 22:09:39 +02002984 char_u b_key[VIM_SIZEOF_INT * 2 + 1];
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002985 // key used for buf_hashtab, holds b_fnum as
2986 // hex string
Bram Moolenaar071d4272004-06-13 20:20:40 +00002987
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002988 int b_changed; // 'modified': Set to TRUE if something in the
2989 // file has been changed and not written out.
2990 dictitem16_T b_ct_di; // holds the b:changedtick value in
2991 // b_ct_di.di_tv.vval.v_number;
2992 // incremented for each change, also for undo
Bram Moolenaar95c526e2017-02-25 14:59:34 +01002993#define CHANGEDTICK(buf) ((buf)->b_ct_di.di_tv.vval.v_number)
Bram Moolenaar071d4272004-06-13 20:20:40 +00002994
Christian Brabandtdb3b4462021-10-16 11:58:55 +01002995 varnumber_T b_last_changedtick; // b:changedtick when TextChanged was
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002996 // last triggered.
Christian Brabandtdb3b4462021-10-16 11:58:55 +01002997 varnumber_T b_last_changedtick_pum; // b:changedtick for TextChangedP
2998 varnumber_T b_last_changedtick_i; // b:changedtick for TextChangedI
Bram Moolenaar5a093432018-02-10 18:15:19 +01002999
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003000 int b_saving; // Set to TRUE if we are in the middle of
3001 // saving the buffer.
Bram Moolenaar071d4272004-06-13 20:20:40 +00003002
3003 /*
3004 * Changes to a buffer require updating of the display. To minimize the
3005 * work, remember changes made and update everything at once.
3006 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003007 int b_mod_set; // TRUE when there are changes since the last
3008 // time the display was updated
3009 linenr_T b_mod_top; // topmost lnum that was changed
3010 linenr_T b_mod_bot; // lnum below last changed line, AFTER the
3011 // change
3012 long b_mod_xlines; // number of extra buffer lines inserted;
3013 // negative when lines were deleted
Bram Moolenaar071d4272004-06-13 20:20:40 +00003014
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003015 wininfo_T *b_wininfo; // list of last used info for each window
Bram Moolenaar071d4272004-06-13 20:20:40 +00003016
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003017 long b_mtime; // last change time of original file
Leah Neukirchen0a7984a2021-10-14 21:27:55 +01003018 long b_mtime_ns; // nanoseconds of last change time
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003019 long b_mtime_read; // last change time when reading
Leah Neukirchen0a7984a2021-10-14 21:27:55 +01003020 long b_mtime_read_ns; // nanoseconds of last read time
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003021 off_T b_orig_size; // size of original file in bytes
3022 int b_orig_mode; // mode of original file
Bram Moolenaarab9c89b2016-07-03 17:47:26 +02003023#ifdef FEAT_VIMINFO
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003024 time_T b_last_used; // time when the buffer was last used; used
3025 // for viminfo
Bram Moolenaarab9c89b2016-07-03 17:47:26 +02003026#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00003027
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003028 pos_T b_namedm[NMARKS]; // current named marks (mark.c)
Bram Moolenaar071d4272004-06-13 20:20:40 +00003029
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003030 // These variables are set when VIsual_active becomes FALSE
Bram Moolenaara23ccb82006-02-27 00:08:02 +00003031 visualinfo_T b_visual;
Bram Moolenaarf7ff6e82014-03-23 15:13:05 +01003032#ifdef FEAT_EVAL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003033 int b_visual_mode_eval; // b_visual.vi_mode for visualmode()
Bram Moolenaar071d4272004-06-13 20:20:40 +00003034#endif
3035
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003036 pos_T b_last_cursor; // cursor position when last unloading this
3037 // buffer
3038 pos_T b_last_insert; // where Insert mode was left
3039 pos_T b_last_change; // position of last change: '. mark
Bram Moolenaar071d4272004-06-13 20:20:40 +00003040
Bram Moolenaar071d4272004-06-13 20:20:40 +00003041 /*
3042 * the changelist contains old change positions
3043 */
3044 pos_T b_changelist[JUMPLISTSIZE];
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003045 int b_changelistlen; // number of active entries
3046 int b_new_change; // set by u_savecommon()
Bram Moolenaar071d4272004-06-13 20:20:40 +00003047
3048 /*
3049 * Character table, only used in charset.c for 'iskeyword'
3050 * 32 bytes of 8 bits: 1 bit per character 0-255.
3051 */
3052 char_u b_chartab[32];
3053
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003054 // Table used for mappings local to a buffer.
Bram Moolenaar071d4272004-06-13 20:20:40 +00003055 mapblock_T *(b_maphash[256]);
3056
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003057 // First abbreviation local to a buffer.
Bram Moolenaar071d4272004-06-13 20:20:40 +00003058 mapblock_T *b_first_abbr;
Bram Moolenaarb66bab32019-08-01 14:28:24 +02003059
Bram Moolenaarac9fb182019-04-27 13:04:13 +02003060 // User commands local to the buffer.
Bram Moolenaar071d4272004-06-13 20:20:40 +00003061 garray_T b_ucmds;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003062 // start and end of an operator, also used for '[ and ']
Bram Moolenaar071d4272004-06-13 20:20:40 +00003063 pos_T b_op_start;
Bram Moolenaar4aea03e2019-09-25 22:37:17 +02003064 pos_T b_op_start_orig; // used for Insstart_orig
Bram Moolenaar071d4272004-06-13 20:20:40 +00003065 pos_T b_op_end;
3066
3067#ifdef FEAT_VIMINFO
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003068 int b_marks_read; // Have we read viminfo marks yet?
Bram Moolenaar071d4272004-06-13 20:20:40 +00003069#endif
3070
3071 /*
3072 * The following only used in undo.c.
3073 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003074 u_header_T *b_u_oldhead; // pointer to oldest header
3075 u_header_T *b_u_newhead; // pointer to newest header; may not be valid
3076 // if b_u_curhead is not NULL
3077 u_header_T *b_u_curhead; // pointer to current header
3078 int b_u_numhead; // current number of headers
3079 int b_u_synced; // entry lists are synced
3080 long b_u_seq_last; // last used undo sequence number
3081 long b_u_save_nr_last; // counter for last file write
Bram Moolenaar1d84f762022-09-03 21:35:53 +01003082 long b_u_seq_cur; // uh_seq of header below which we are now
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003083 time_T b_u_time_cur; // uh_time of header below which we are now
3084 long b_u_save_nr_cur; // file write nr after which we are now
Bram Moolenaar071d4272004-06-13 20:20:40 +00003085
3086 /*
3087 * variables for "U" command in undo.c
3088 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003089 undoline_T b_u_line_ptr; // saved line for "U" command
3090 linenr_T b_u_line_lnum; // line number of line in u_line
3091 colnr_T b_u_line_colnr; // optional column number
Bram Moolenaar071d4272004-06-13 20:20:40 +00003092
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003093 int b_scanned; // ^N/^P have scanned this buffer
Bram Moolenaar071d4272004-06-13 20:20:40 +00003094
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003095 // flags for use of ":lmap" and IM control
3096 long b_p_iminsert; // input mode for insert
3097 long b_p_imsearch; // input mode for search
kylo2529dac9b12022-03-27 20:05:17 +01003098#define B_IMODE_USE_INSERT (-1) // Use b_p_iminsert value for search
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003099#define B_IMODE_NONE 0 // Input via none
3100#define B_IMODE_LMAP 1 // Input via langmap
3101#define B_IMODE_IM 2 // Input via input method
Bram Moolenaar6315a9a2017-11-25 15:20:02 +01003102#define B_IMODE_LAST 2
Bram Moolenaar071d4272004-06-13 20:20:40 +00003103
3104#ifdef FEAT_KEYMAP
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003105 short b_kmap_state; // using "lmap" mappings
3106# define KEYMAP_INIT 1 // 'keymap' was set, call keymap_init()
3107# define KEYMAP_LOADED 2 // 'keymap' mappings have been loaded
3108 garray_T b_kmap_ga; // the keymap table
Bram Moolenaar071d4272004-06-13 20:20:40 +00003109#endif
3110
3111 /*
3112 * Options local to a buffer.
3113 * They are here because their value depends on the type of file
3114 * or contents of the file being edited.
3115 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003116 int b_p_initialized; // set when options initialized
Bram Moolenaar071d4272004-06-13 20:20:40 +00003117
Bram Moolenaar5e3cb7e2006-02-27 23:58:35 +00003118#ifdef FEAT_EVAL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003119 sctx_T b_p_script_ctx[BV_COUNT]; // SCTXs for buffer-local options
Bram Moolenaar5e3cb7e2006-02-27 23:58:35 +00003120#endif
3121
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003122 int b_p_ai; // 'autoindent'
3123 int b_p_ai_nopaste; // b_p_ai saved for paste mode
3124 char_u *b_p_bkc; // 'backupcopy'
3125 unsigned b_bkc_flags; // flags for 'backupcopy'
3126 int b_p_ci; // 'copyindent'
3127 int b_p_bin; // 'binary'
3128 int b_p_bomb; // 'bomb'
3129 char_u *b_p_bh; // 'bufhidden'
3130 char_u *b_p_bt; // 'buftype'
Bram Moolenaar1f2903c2017-07-23 19:51:01 +02003131#ifdef FEAT_QUICKFIX
Bram Moolenaarc1542742016-07-20 21:44:37 +02003132#define BUF_HAS_QF_ENTRY 1
3133#define BUF_HAS_LL_ENTRY 2
Bram Moolenaar2f095a42016-06-03 19:05:49 +02003134 int b_has_qf_entry;
Bram Moolenaar071d4272004-06-13 20:20:40 +00003135#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003136 int b_p_bl; // 'buflisted'
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003137 int b_p_cin; // 'cindent'
3138 char_u *b_p_cino; // 'cinoptions'
3139 char_u *b_p_cink; // 'cinkeys'
Tom Praschan3506cf32022-04-07 12:39:08 +01003140 char_u *b_p_cinsd; // 'cinscopedecls'
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003141 char_u *b_p_cinw; // 'cinwords'
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003142 char_u *b_p_com; // 'comments'
Bram Moolenaar071d4272004-06-13 20:20:40 +00003143#ifdef FEAT_FOLDING
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003144 char_u *b_p_cms; // 'commentstring'
Bram Moolenaar071d4272004-06-13 20:20:40 +00003145#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003146 char_u *b_p_cpt; // 'complete'
Bram Moolenaarac3150d2019-07-28 16:36:39 +02003147#ifdef BACKSLASH_IN_FILENAME
3148 char_u *b_p_csl; // 'completeslash'
3149#endif
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +00003150#ifdef FEAT_COMPL_FUNC
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003151 char_u *b_p_cfu; // 'completefunc'
Yegappan Lakshmanan8658c752021-12-03 11:09:29 +00003152 callback_T b_cfu_cb; // 'completefunc' callback
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003153 char_u *b_p_ofu; // 'omnifunc'
Yegappan Lakshmanan8658c752021-12-03 11:09:29 +00003154 callback_T b_ofu_cb; // 'omnifunc' callback
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +00003155#endif
Bram Moolenaar45e18cb2019-04-28 18:05:35 +02003156#ifdef FEAT_EVAL
Yegappan Lakshmanan19916a82021-11-24 16:32:55 +00003157 char_u *b_p_tfu; // 'tagfunc' option value
3158 callback_T b_tfu_cb; // 'tagfunc' callback
Bram Moolenaar45e18cb2019-04-28 18:05:35 +02003159#endif
Bram Moolenaarfb0cf232022-10-22 11:25:19 +01003160 int b_p_eof; // 'endoffile'
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003161 int b_p_eol; // 'endofline'
3162 int b_p_fixeol; // 'fixendofline'
3163 int b_p_et; // 'expandtab'
3164 int b_p_et_nobin; // b_p_et saved for binary mode
3165 int b_p_et_nopaste; // b_p_et saved for paste mode
3166 char_u *b_p_fenc; // 'fileencoding'
3167 char_u *b_p_ff; // 'fileformat'
3168 char_u *b_p_ft; // 'filetype'
3169 char_u *b_p_fo; // 'formatoptions'
3170 char_u *b_p_flp; // 'formatlistpat'
3171 int b_p_inf; // 'infercase'
3172 char_u *b_p_isk; // 'iskeyword'
Bram Moolenaar071d4272004-06-13 20:20:40 +00003173#ifdef FEAT_FIND_ID
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003174 char_u *b_p_def; // 'define' local value
3175 char_u *b_p_inc; // 'include'
Bram Moolenaar071d4272004-06-13 20:20:40 +00003176# ifdef FEAT_EVAL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003177 char_u *b_p_inex; // 'includeexpr'
3178 long_u b_p_inex_flags; // flags for 'includeexpr'
Bram Moolenaar071d4272004-06-13 20:20:40 +00003179# endif
3180#endif
Bram Moolenaar8e145b82022-05-21 20:17:31 +01003181#if defined(FEAT_EVAL)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003182 char_u *b_p_inde; // 'indentexpr'
3183 long_u b_p_inde_flags; // flags for 'indentexpr'
3184 char_u *b_p_indk; // 'indentkeys'
Bram Moolenaar071d4272004-06-13 20:20:40 +00003185#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003186 char_u *b_p_fp; // 'formatprg'
Bram Moolenaar1d2ba7f2006-02-14 22:29:30 +00003187#if defined(FEAT_EVAL)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003188 char_u *b_p_fex; // 'formatexpr'
3189 long_u b_p_fex_flags; // flags for 'formatexpr'
Bram Moolenaar1d2ba7f2006-02-14 22:29:30 +00003190#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00003191#ifdef FEAT_CRYPT
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003192 char_u *b_p_key; // 'key'
Bram Moolenaar071d4272004-06-13 20:20:40 +00003193#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003194 char_u *b_p_kp; // 'keywordprg'
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003195 int b_p_lisp; // 'lisp'
Bram Moolenaar4b082c42022-10-15 16:25:27 +01003196 char_u *b_p_lop; // 'lispoptions'
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003197 char_u *b_p_menc; // 'makeencoding'
3198 char_u *b_p_mps; // 'matchpairs'
3199 int b_p_ml; // 'modeline'
3200 int b_p_ml_nobin; // b_p_ml saved for binary mode
3201 int b_p_ma; // 'modifiable'
3202 char_u *b_p_nf; // 'nrformats'
3203 int b_p_pi; // 'preserveindent'
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003204 char_u *b_p_qe; // 'quoteescape'
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003205 int b_p_ro; // 'readonly'
3206 long b_p_sw; // 'shiftwidth'
3207 int b_p_sn; // 'shortname'
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003208 int b_p_si; // 'smartindent'
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003209 long b_p_sts; // 'softtabstop'
3210 long b_p_sts_nopaste; // b_p_sts saved for paste mode
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003211 char_u *b_p_sua; // 'suffixesadd'
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003212 int b_p_swf; // 'swapfile'
Bram Moolenaar071d4272004-06-13 20:20:40 +00003213#ifdef FEAT_SYN_HL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003214 long b_p_smc; // 'synmaxcol'
3215 char_u *b_p_syn; // 'syntax'
Bram Moolenaarb9a02fc2006-03-12 22:08:12 +00003216#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003217 long b_p_ts; // 'tabstop'
3218 int b_p_tx; // 'textmode'
3219 long b_p_tw; // 'textwidth'
3220 long b_p_tw_nobin; // b_p_tw saved for binary mode
3221 long b_p_tw_nopaste; // b_p_tw saved for paste mode
3222 long b_p_wm; // 'wrapmargin'
3223 long b_p_wm_nobin; // b_p_wm saved for binary mode
3224 long b_p_wm_nopaste; // b_p_wm saved for paste mode
Bram Moolenaar04958cb2018-06-23 19:23:02 +02003225#ifdef FEAT_VARTABS
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003226 char_u *b_p_vsts; // 'varsofttabstop'
3227 int *b_p_vsts_array; // 'varsofttabstop' in internal format
3228 char_u *b_p_vsts_nopaste; // b_p_vsts saved for paste mode
3229 char_u *b_p_vts; // 'vartabstop'
3230 int *b_p_vts_array; // 'vartabstop' in internal format
Bram Moolenaar04958cb2018-06-23 19:23:02 +02003231#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00003232#ifdef FEAT_KEYMAP
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003233 char_u *b_p_keymap; // 'keymap'
Bram Moolenaar071d4272004-06-13 20:20:40 +00003234#endif
3235
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003236 /*
3237 * local values for options which are normally global
3238 */
Bram Moolenaar071d4272004-06-13 20:20:40 +00003239#ifdef FEAT_QUICKFIX
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003240 char_u *b_p_gp; // 'grepprg' local value
3241 char_u *b_p_mp; // 'makeprg' local value
3242 char_u *b_p_efm; // 'errorformat' local value
Bram Moolenaar071d4272004-06-13 20:20:40 +00003243#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003244 char_u *b_p_ep; // 'equalprg' local value
3245 char_u *b_p_path; // 'path' local value
3246 int b_p_ar; // 'autoread' local value
3247 char_u *b_p_tags; // 'tags' local value
3248 char_u *b_p_tc; // 'tagcase' local value
3249 unsigned b_tc_flags; // flags for 'tagcase'
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003250 char_u *b_p_dict; // 'dictionary' local value
3251 char_u *b_p_tsr; // 'thesaurus' local value
Bram Moolenaarf4d8b762021-10-17 14:13:09 +01003252#ifdef FEAT_COMPL_FUNC
3253 char_u *b_p_tsrfu; // 'thesaurusfunc' local value
Yegappan Lakshmanan8658c752021-12-03 11:09:29 +00003254 callback_T b_tsrfu_cb; // 'thesaurusfunc' callback
Bram Moolenaarf4d8b762021-10-17 14:13:09 +01003255#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003256 long b_p_ul; // 'undolevels' local value
Bram Moolenaar55debbe2010-05-23 23:34:36 +02003257#ifdef FEAT_PERSISTENT_UNDO
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003258 int b_p_udf; // 'undofile'
Bram Moolenaar55debbe2010-05-23 23:34:36 +02003259#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003260 char_u *b_p_lw; // 'lispwords' local value
Bram Moolenaare1fc5152018-04-21 19:49:08 +02003261#ifdef FEAT_TERMINAL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003262 long b_p_twsl; // 'termwinscroll'
Bram Moolenaare1fc5152018-04-21 19:49:08 +02003263#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00003264
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003265 /*
3266 * end of buffer options
3267 */
Bram Moolenaar071d4272004-06-13 20:20:40 +00003268
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003269 // values set from b_p_cino
Bram Moolenaar6bcbcc52013-11-05 07:13:41 +01003270 int b_ind_level;
3271 int b_ind_open_imag;
3272 int b_ind_no_brace;
3273 int b_ind_first_open;
3274 int b_ind_open_extra;
3275 int b_ind_close_extra;
3276 int b_ind_open_left_imag;
3277 int b_ind_jump_label;
3278 int b_ind_case;
3279 int b_ind_case_code;
3280 int b_ind_case_break;
3281 int b_ind_param;
3282 int b_ind_func_type;
3283 int b_ind_comment;
3284 int b_ind_in_comment;
3285 int b_ind_in_comment2;
3286 int b_ind_cpp_baseclass;
3287 int b_ind_continuation;
3288 int b_ind_unclosed;
3289 int b_ind_unclosed2;
3290 int b_ind_unclosed_noignore;
3291 int b_ind_unclosed_wrapped;
3292 int b_ind_unclosed_whiteok;
3293 int b_ind_matching_paren;
3294 int b_ind_paren_prev;
3295 int b_ind_maxparen;
3296 int b_ind_maxcomment;
3297 int b_ind_scopedecl;
3298 int b_ind_scopedecl_code;
3299 int b_ind_java;
3300 int b_ind_js;
3301 int b_ind_keep_case_label;
3302 int b_ind_hash_comment;
3303 int b_ind_cpp_namespace;
3304 int b_ind_if_for_while;
Bram Moolenaar7720ba82017-03-08 22:19:26 +01003305 int b_ind_cpp_extern_c;
Bram Moolenaard881b512020-05-31 17:49:30 +02003306 int b_ind_pragma;
Bram Moolenaar6bcbcc52013-11-05 07:13:41 +01003307
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003308 linenr_T b_no_eol_lnum; // non-zero lnum when last line of next binary
3309 // write should not have an end-of-line
Bram Moolenaarcab35ad2011-02-15 17:39:22 +01003310
Bram Moolenaar15775372022-10-29 20:01:52 +01003311 int b_start_eof; // last line had eof (CTRL-Z) when it was read
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003312 int b_start_eol; // last line had eol when it was read
3313 int b_start_ffc; // first char of 'ff' when edit started
3314 char_u *b_start_fenc; // 'fileencoding' when edit started or NULL
3315 int b_bad_char; // "++bad=" argument when edit started or 0
3316 int b_start_bomb; // 'bomb' when it was read
Bram Moolenaar071d4272004-06-13 20:20:40 +00003317
3318#ifdef FEAT_EVAL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003319 dictitem_T b_bufvar; // variable for "b:" Dictionary
3320 dict_T *b_vars; // internal variables, local to buffer
Bram Moolenaar6d2399b2019-05-11 19:14:16 +02003321
3322 listener_T *b_listener;
Bram Moolenaardda41442019-05-16 22:11:47 +02003323 list_T *b_recorded_changes;
Bram Moolenaar071d4272004-06-13 20:20:40 +00003324#endif
Bram Moolenaar05ad5ff2019-11-30 22:48:27 +01003325#ifdef FEAT_PROP_POPUP
Bram Moolenaarb413d2e2018-12-25 23:15:46 +01003326 int b_has_textprop; // TRUE when text props were added
3327 hashtab_T *b_proptypes; // text property types local to buffer
Bram Moolenaare44336b2022-08-07 18:20:08 +01003328 proptype_T **b_proparray; // entries of b_proptypes sorted on tp_id
Bram Moolenaar7f9969c2022-07-25 18:13:54 +01003329 garray_T b_textprop_text; // stores text for props, index by (-id - 1)
Bram Moolenaar98aefe72018-12-13 22:20:09 +01003330#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00003331
Bram Moolenaar9b2200a2006-03-20 21:55:45 +00003332#if defined(FEAT_BEVAL) && defined(FEAT_EVAL)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003333 char_u *b_p_bexpr; // 'balloonexpr' local value
3334 long_u b_p_bexpr_flags;// flags for 'balloonexpr'
Bram Moolenaar9b2200a2006-03-20 21:55:45 +00003335#endif
Bram Moolenaar49771f42010-07-20 17:32:38 +02003336#ifdef FEAT_CRYPT
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003337 char_u *b_p_cm; // 'cryptmethod'
Bram Moolenaar49771f42010-07-20 17:32:38 +02003338#endif
Bram Moolenaar9b2200a2006-03-20 21:55:45 +00003339
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003340 // When a buffer is created, it starts without a swap file. b_may_swap is
3341 // then set to indicate that a swap file may be opened later. It is reset
3342 // if a swap file could not be opened.
Bram Moolenaar071d4272004-06-13 20:20:40 +00003343 int b_may_swap;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003344 int b_did_warn; // Set to 1 if user has been warned on first
3345 // change of a read-only file
Bram Moolenaar4770d092006-01-12 23:22:24 +00003346
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003347 // Two special kinds of buffers:
3348 // help buffer - used for help files, won't use a swap file.
3349 // spell buffer - used for spell info, never displayed and doesn't have a
3350 // file name.
3351 int b_help; // TRUE for help file buffer (when set b_p_bt
3352 // is "help")
Bram Moolenaarb9a02fc2006-03-12 22:08:12 +00003353#ifdef FEAT_SPELL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003354 int b_spell; // TRUE for a spell file buffer, most fields
3355 // are not used! Use the B_SPELL macro to
3356 // access b_spell without #ifdef.
Bram Moolenaar4770d092006-01-12 23:22:24 +00003357#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00003358
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003359 int b_shortname; // this file has an 8.3 file name
Bram Moolenaar071d4272004-06-13 20:20:40 +00003360
Bram Moolenaarf2732452018-06-03 14:47:35 +02003361#ifdef FEAT_JOB_CHANNEL
Bram Moolenaar3a97bb32019-06-01 13:28:35 +02003362 char_u *b_prompt_text; // set by prompt_setprompt()
3363 callback_T b_prompt_callback; // set by prompt_setcallback()
3364 callback_T b_prompt_interrupt; // set by prompt_setinterrupt()
3365 int b_prompt_insert; // value for restart_edit when entering
3366 // a prompt buffer window.
Bram Moolenaarf2732452018-06-03 14:47:35 +02003367#endif
Bram Moolenaar325b7a22004-07-05 15:58:32 +00003368#ifdef FEAT_MZSCHEME
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003369 void *b_mzscheme_ref; // The MzScheme reference to this buffer
Bram Moolenaar325b7a22004-07-05 15:58:32 +00003370#endif
3371
Bram Moolenaar071d4272004-06-13 20:20:40 +00003372#ifdef FEAT_PERL
Bram Moolenaare344bea2005-09-01 20:46:49 +00003373 void *b_perl_private;
Bram Moolenaar071d4272004-06-13 20:20:40 +00003374#endif
3375
3376#ifdef FEAT_PYTHON
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003377 void *b_python_ref; // The Python reference to this buffer
Bram Moolenaar071d4272004-06-13 20:20:40 +00003378#endif
3379
Bram Moolenaarbd5e15f2010-07-17 21:19:38 +02003380#ifdef FEAT_PYTHON3
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003381 void *b_python3_ref; // The Python3 reference to this buffer
Bram Moolenaarbd5e15f2010-07-17 21:19:38 +02003382#endif
3383
Bram Moolenaar071d4272004-06-13 20:20:40 +00003384#ifdef FEAT_TCL
Bram Moolenaare344bea2005-09-01 20:46:49 +00003385 void *b_tcl_ref;
Bram Moolenaar071d4272004-06-13 20:20:40 +00003386#endif
3387
3388#ifdef FEAT_RUBY
Bram Moolenaare344bea2005-09-01 20:46:49 +00003389 void *b_ruby_ref;
Bram Moolenaar071d4272004-06-13 20:20:40 +00003390#endif
3391
Bram Moolenaar860cae12010-06-05 23:22:07 +02003392#if defined(FEAT_SYN_HL) || defined(FEAT_SPELL)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003393 synblock_T b_s; // Info related to syntax highlighting. w_s
3394 // normally points to this, but some windows
3395 // may use a different synblock_T.
Bram Moolenaarb9a02fc2006-03-12 22:08:12 +00003396#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00003397
3398#ifdef FEAT_SIGNS
Bram Moolenaar6656c2e2019-10-24 15:00:04 +02003399 sign_entry_T *b_signlist; // list of placed signs
Bram Moolenaar3b7b8362015-03-20 18:11:48 +01003400# ifdef FEAT_NETBEANS_INTG
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003401 int b_has_sign_column; // Flag that is set when a first sign is
3402 // added and remains set until the end of
3403 // the netbeans session.
Bram Moolenaar3b7b8362015-03-20 18:11:48 +01003404# endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00003405#endif
3406
3407#ifdef FEAT_NETBEANS_INTG
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003408 int b_netbeans_file; // TRUE when buffer is owned by NetBeans
3409 int b_was_netbeans_file;// TRUE if b_netbeans_file was once set
Bram Moolenaar071d4272004-06-13 20:20:40 +00003410#endif
Bram Moolenaar509ce2a2016-03-11 22:52:15 +01003411#ifdef FEAT_JOB_CHANNEL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003412 int b_write_to_channel; // TRUE when appended lines are written to
3413 // a channel.
Bram Moolenaar99ef0622016-03-06 20:22:25 +01003414#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00003415
Bram Moolenaar8f4ac012014-08-10 13:38:34 +02003416#ifdef FEAT_CRYPT
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003417 cryptstate_T *b_cryptstate; // Encryption state while reading or writing
3418 // the file. NULL when not using encryption.
Bram Moolenaar8f4ac012014-08-10 13:38:34 +02003419#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003420 int b_mapped_ctrl_c; // modes where CTRL-C is mapped
Bram Moolenaar8f4ac012014-08-10 13:38:34 +02003421
Bram Moolenaare4f25e42017-07-07 11:54:15 +02003422#ifdef FEAT_TERMINAL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003423 term_T *b_term; // When not NULL this buffer is for a terminal
3424 // window.
Bram Moolenaare4f25e42017-07-07 11:54:15 +02003425#endif
Bram Moolenaare828b762018-09-10 17:51:58 +02003426#ifdef FEAT_DIFF
3427 int b_diff_failed; // internal diff failed for this buffer
3428#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003429}; // file_buffer
Bram Moolenaar071d4272004-06-13 20:20:40 +00003430
Bram Moolenaar997fb4b2006-02-17 21:53:23 +00003431
3432#ifdef FEAT_DIFF
3433/*
3434 * Stuff for diff mode.
3435 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003436# define DB_COUNT 8 // up to eight buffers can be diff'ed
Bram Moolenaar997fb4b2006-02-17 21:53:23 +00003437
3438/*
3439 * Each diffblock defines where a block of lines starts in each of the buffers
3440 * and how many lines it occupies in that buffer. When the lines are missing
3441 * in the buffer the df_count[] is zero. This is all counted in
3442 * buffer lines.
3443 * There is always at least one unchanged line in between the diffs.
3444 * Otherwise it would have been included in the diff above or below it.
3445 * df_lnum[] + df_count[] is the lnum below the change. When in one buffer
3446 * lines have been inserted, in the other buffer df_lnum[] is the line below
3447 * the insertion and df_count[] is zero. When appending lines at the end of
3448 * the buffer, df_lnum[] is one beyond the end!
3449 * This is using a linked list, because the number of differences is expected
3450 * to be reasonable small. The list is sorted on lnum.
3451 */
3452typedef struct diffblock_S diff_T;
3453struct diffblock_S
3454{
3455 diff_T *df_next;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003456 linenr_T df_lnum[DB_COUNT]; // line number in buffer
3457 linenr_T df_count[DB_COUNT]; // nr of inserted/changed lines
Bram Moolenaar997fb4b2006-02-17 21:53:23 +00003458};
3459#endif
3460
Bram Moolenaar746ebd32009-06-16 14:01:43 +00003461#define SNAP_HELP_IDX 0
Christian Brabandte7d6dbc2022-05-06 12:21:04 +01003462#define SNAP_AUCMD_IDX 1
Bram Moolenaarf2bd8ef2018-03-04 18:08:14 +01003463#define SNAP_COUNT 2
Bram Moolenaar746ebd32009-06-16 14:01:43 +00003464
Bram Moolenaar997fb4b2006-02-17 21:53:23 +00003465/*
3466 * Tab pages point to the top frame of each tab page.
3467 * Note: Most values are NOT valid for the current tab page! Use "curwin",
3468 * "firstwin", etc. for that. "tp_topframe" is always valid and can be
3469 * compared against "topframe" to find the current tab page.
3470 */
3471typedef struct tabpage_S tabpage_T;
3472struct tabpage_S
3473{
Bram Moolenaar4d784b22019-05-25 19:51:39 +02003474 tabpage_T *tp_next; // next tabpage or NULL
3475 frame_T *tp_topframe; // topframe for the windows
3476 win_T *tp_curwin; // current window in this Tab page
3477 win_T *tp_prevwin; // previous window in this Tab page
3478 win_T *tp_firstwin; // first window in this Tab page
3479 win_T *tp_lastwin; // last window in this Tab page
Bram Moolenaar05ad5ff2019-11-30 22:48:27 +01003480#ifdef FEAT_PROP_POPUP
Bram Moolenaar4d784b22019-05-25 19:51:39 +02003481 win_T *tp_first_popupwin; // first popup window in this Tab page
3482#endif
3483 long tp_old_Rows; // Rows when Tab page was left
Bram Moolenaarb7118142021-12-10 13:40:08 +00003484 long tp_old_Columns; // Columns when Tab page was left, -1 when
3485 // calling shell_new_columns() postponed
Bram Moolenaar4d784b22019-05-25 19:51:39 +02003486 long tp_ch_used; // value of 'cmdheight' when frame size
3487 // was set
Bram Moolenaar9b2200a2006-03-20 21:55:45 +00003488#ifdef FEAT_GUI
3489 int tp_prev_which_scrollbars[3];
Bram Moolenaar4d784b22019-05-25 19:51:39 +02003490 // previous value of which_scrollbars
Bram Moolenaar9b2200a2006-03-20 21:55:45 +00003491#endif
Bram Moolenaar00aa0692019-04-27 20:37:57 +02003492
3493 char_u *tp_localdir; // absolute path of local directory or
3494 // NULL
Bram Moolenaar002bc792020-06-05 22:33:42 +02003495 char_u *tp_prevdir; // previous directory
3496
Bram Moolenaar997fb4b2006-02-17 21:53:23 +00003497#ifdef FEAT_DIFF
3498 diff_T *tp_first_diff;
3499 buf_T *(tp_diffbuf[DB_COUNT]);
Bram Moolenaare3521d92018-09-16 14:10:31 +02003500 int tp_diff_invalid; // list of diffs is outdated
3501 int tp_diff_update; // update diffs before redrawing
Bram Moolenaar997fb4b2006-02-17 21:53:23 +00003502#endif
Bram Moolenaar4d784b22019-05-25 19:51:39 +02003503 frame_T *(tp_snapshot[SNAP_COUNT]); // window layout snapshots
Bram Moolenaar910f66f2006-04-05 20:41:53 +00003504#ifdef FEAT_EVAL
Bram Moolenaar4d784b22019-05-25 19:51:39 +02003505 dictitem_T tp_winvar; // variable for "t:" Dictionary
3506 dict_T *tp_vars; // internal variables, local to tab page
Bram Moolenaar910f66f2006-04-05 20:41:53 +00003507#endif
Bram Moolenaar5e538ec2013-05-15 15:12:29 +02003508
3509#ifdef FEAT_PYTHON
Bram Moolenaar4d784b22019-05-25 19:51:39 +02003510 void *tp_python_ref; // The Python value for this tab page
Bram Moolenaar5e538ec2013-05-15 15:12:29 +02003511#endif
3512
3513#ifdef FEAT_PYTHON3
Bram Moolenaar4d784b22019-05-25 19:51:39 +02003514 void *tp_python3_ref; // The Python value for this tab page
Bram Moolenaar5e538ec2013-05-15 15:12:29 +02003515#endif
Bram Moolenaar997fb4b2006-02-17 21:53:23 +00003516};
3517
Bram Moolenaar071d4272004-06-13 20:20:40 +00003518/*
3519 * Structure to cache info for displayed lines in w_lines[].
3520 * Each logical line has one entry.
3521 * The entry tells how the logical line is currently displayed in the window.
3522 * This is updated when displaying the window.
3523 * When the display is changed (e.g., when clearing the screen) w_lines_valid
3524 * is changed to exclude invalid entries.
3525 * When making changes to the buffer, wl_valid is reset to indicate wl_size
3526 * may not reflect what is actually in the buffer. When wl_valid is FALSE,
3527 * the entries can only be used to count the number of displayed lines used.
3528 * wl_lnum and wl_lastlnum are invalid too.
3529 */
3530typedef struct w_line
3531{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003532 linenr_T wl_lnum; // buffer line number for logical line
3533 short_u wl_size; // height in screen lines
3534 char wl_valid; // TRUE values are valid for text in buffer
Bram Moolenaar071d4272004-06-13 20:20:40 +00003535#ifdef FEAT_FOLDING
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003536 char wl_folded; // TRUE when this is a range of folded lines
3537 linenr_T wl_lastlnum; // last buffer line number for logical line
Bram Moolenaar071d4272004-06-13 20:20:40 +00003538#endif
3539} wline_T;
3540
3541/*
3542 * Windows are kept in a tree of frames. Each frame has a column (FR_COL)
3543 * or row (FR_ROW) layout or is a leaf, which has a window.
3544 */
Bram Moolenaar1d2ba7f2006-02-14 22:29:30 +00003545struct frame_S
Bram Moolenaar071d4272004-06-13 20:20:40 +00003546{
Bram Moolenaarcce713d2019-03-04 11:40:12 +01003547 char fr_layout; // FR_LEAF, FR_COL or FR_ROW
Bram Moolenaar071d4272004-06-13 20:20:40 +00003548 int fr_width;
Bram Moolenaarcce713d2019-03-04 11:40:12 +01003549 int fr_newwidth; // new width used in win_equal_rec()
Bram Moolenaar071d4272004-06-13 20:20:40 +00003550 int fr_height;
Bram Moolenaarcce713d2019-03-04 11:40:12 +01003551 int fr_newheight; // new height used in win_equal_rec()
3552 frame_T *fr_parent; // containing frame or NULL
3553 frame_T *fr_next; // frame right or below in same parent, NULL
3554 // for last
3555 frame_T *fr_prev; // frame left or above in same parent, NULL
3556 // for first
3557 // fr_child and fr_win are mutually exclusive
3558 frame_T *fr_child; // first contained frame
Christian Brabandte7d6dbc2022-05-06 12:21:04 +01003559 win_T *fr_win; // window that fills this frame; for a snapshot
3560 // set to the current window
Bram Moolenaar071d4272004-06-13 20:20:40 +00003561};
3562
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003563#define FR_LEAF 0 // frame is a leaf
3564#define FR_ROW 1 // frame with a row of windows
3565#define FR_COL 2 // frame with a column of windows
Bram Moolenaar071d4272004-06-13 20:20:40 +00003566
3567/*
Bram Moolenaar6ee10162007-07-26 20:58:42 +00003568 * Struct used for highlighting 'hlsearch' matches, matches defined by
3569 * ":match" and matches defined by match functions.
3570 * For 'hlsearch' there is one pattern for all windows. For ":match" and the
3571 * match functions there is a different pattern for each window.
3572 */
3573typedef struct
3574{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003575 regmmatch_T rm; // points to the regexp program; contains last
3576 // found match (may continue in next line)
3577 buf_T *buf; // the buffer to search for a match
3578 linenr_T lnum; // the line to search for a match
3579 int attr; // attributes to be used for a match
3580 int attr_cur; // attributes currently active in win_line()
3581 linenr_T first_lnum; // first lnum to search for multi-line pat
3582 colnr_T startcol; // in win_line() points to char where HL starts
3583 colnr_T endcol; // in win_line() points to char where HL ends
Bram Moolenaar693ccd12022-04-16 12:04:37 +01003584 char is_addpos; // position specified directly by
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003585 // matchaddpos(). TRUE/FALSE
Bram Moolenaar693ccd12022-04-16 12:04:37 +01003586 char has_cursor; // TRUE if the cursor is inside the match, used for
3587 // CurSearch
Bram Moolenaar6ee10162007-07-26 20:58:42 +00003588} match_T;
3589
Bram Moolenaarb3414592014-06-17 17:48:32 +02003590/*
3591 * Same as lpos_T, but with additional field len.
3592 */
3593typedef struct
3594{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003595 linenr_T lnum; // line number
3596 colnr_T col; // column number
3597 int len; // length: 0 - to the end of line
Bram Moolenaarb3414592014-06-17 17:48:32 +02003598} llpos_T;
3599
3600/*
Bram Moolenaar50faf022022-09-29 12:50:17 +01003601 * matchitem_T provides a linked list for storing match items for ":match",
3602 * matchadd() and matchaddpos().
Bram Moolenaar6ee10162007-07-26 20:58:42 +00003603 */
3604typedef struct matchitem matchitem_T;
3605struct matchitem
3606{
Bram Moolenaar50faf022022-09-29 12:50:17 +01003607 matchitem_T *mit_next;
3608 int mit_id; // match ID
3609 int mit_priority; // match priority
3610
3611 // Either a pattern is defined (mit_pattern is not NUL) or a list of
3612 // positions is given (mit_pos is not NULL and mit_pos_count > 0).
3613 char_u *mit_pattern; // pattern to highlight
3614 regmmatch_T mit_match; // regexp program for pattern
3615
3616 llpos_T *mit_pos_array; // array of positions
3617 int mit_pos_count; // nr of entries in mit_pos
3618 int mit_pos_cur; // internal position counter
3619 linenr_T mit_toplnum; // top buffer line
3620 linenr_T mit_botlnum; // bottom buffer line
3621
3622 match_T mit_hl; // struct for doing the actual highlighting
3623 int mit_hlg_id; // highlight group ID
Bram Moolenaar6561d522015-07-21 15:48:27 +02003624#ifdef FEAT_CONCEAL
Bram Moolenaar50faf022022-09-29 12:50:17 +01003625 int mit_conceal_char; // cchar for Conceal highlighting
Bram Moolenaar6561d522015-07-21 15:48:27 +02003626#endif
Bram Moolenaar6ee10162007-07-26 20:58:42 +00003627};
3628
Bram Moolenaara68e5952019-04-25 22:22:01 +02003629// Structure to store last cursor position and topline. Used by check_lnums()
3630// and reset_lnums().
3631typedef struct
3632{
3633 int w_topline_save; // original topline value
3634 int w_topline_corr; // corrected topline value
3635 pos_T w_cursor_save; // original cursor position
3636 pos_T w_cursor_corr; // corrected cursor position
3637} pos_save_T;
3638
Bram Moolenaar1b9645d2017-09-17 23:03:31 +02003639#ifdef FEAT_MENU
3640typedef struct {
3641 int wb_startcol;
3642 int wb_endcol;
3643 vimmenu_T *wb_menu;
3644} winbar_item_T;
3645#endif
3646
Bram Moolenaar6ee10162007-07-26 20:58:42 +00003647/*
Bram Moolenaareed9d462021-02-15 20:38:25 +01003648 * Characters from the 'listchars' option
3649 */
3650typedef struct
3651{
3652 int eol;
3653 int ext;
3654 int prec;
3655 int nbsp;
3656 int space;
3657 int tab1;
3658 int tab2;
3659 int tab3;
3660 int trail;
3661 int lead;
zeertzjqf14b8ba2021-09-10 16:58:30 +02003662 int *multispace;
Bram Moolenaaraca12fd2022-06-07 10:16:15 +01003663 int *leadmultispace;
Bram Moolenaareed9d462021-02-15 20:38:25 +01003664#ifdef FEAT_CONCEAL
3665 int conceal;
3666#endif
3667} lcs_chars_T;
3668
3669/*
Bram Moolenaar96ba25a2022-07-04 17:34:33 +01003670 * Characters from the 'fillchars' option
3671 */
3672typedef struct
3673{
3674 int stl;
3675 int stlnc;
3676 int vert;
3677 int fold;
3678 int foldopen;
3679 int foldclosed;
3680 int foldsep;
3681 int diff;
3682 int eob;
Bram Moolenaar4ba5f1d2022-10-04 14:36:29 +01003683 int lastline;
Bram Moolenaar96ba25a2022-07-04 17:34:33 +01003684} fill_chars_T;
3685
3686/*
Bram Moolenaar071d4272004-06-13 20:20:40 +00003687 * Structure which contains all information that belongs to a window
3688 *
3689 * All row numbers are relative to the start of the window, except w_winrow.
3690 */
Bram Moolenaar1d2ba7f2006-02-14 22:29:30 +00003691struct window_S
Bram Moolenaar071d4272004-06-13 20:20:40 +00003692{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003693 int w_id; // unique window ID
Bram Moolenaar86edef62016-03-13 18:07:30 +01003694
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003695 buf_T *w_buffer; // buffer we are a window into
Bram Moolenaar4d784b22019-05-25 19:51:39 +02003696
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003697 win_T *w_prev; // link to previous window
3698 win_T *w_next; // link to next window
Bram Moolenaar071d4272004-06-13 20:20:40 +00003699
Bram Moolenaar860cae12010-06-05 23:22:07 +02003700#if defined(FEAT_SYN_HL) || defined(FEAT_SPELL)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003701 synblock_T *w_s; // for :ownsyntax
Bram Moolenaar860cae12010-06-05 23:22:07 +02003702#endif
3703
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003704 int w_closing; // window is being closed, don't let
3705 // autocommands close it too.
Bram Moolenaar071d4272004-06-13 20:20:40 +00003706
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003707 frame_T *w_frame; // frame containing this window
Bram Moolenaar071d4272004-06-13 20:20:40 +00003708
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003709 pos_T w_cursor; // cursor position in buffer
Bram Moolenaar071d4272004-06-13 20:20:40 +00003710
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003711 colnr_T w_curswant; // The column we'd like to be at. This is
3712 // used to try to stay in the same column
3713 // for up/down cursor motions.
Bram Moolenaar071d4272004-06-13 20:20:40 +00003714
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003715 int w_set_curswant; // If set, then update w_curswant the next
3716 // time through cursupdate() to the
3717 // current virtual column
Bram Moolenaar071d4272004-06-13 20:20:40 +00003718
Bram Moolenaar4a5abbd2018-10-02 18:26:10 +02003719#ifdef FEAT_SYN_HL
3720 linenr_T w_last_cursorline; // where last time 'cursorline' was drawn
3721#endif
3722
Bram Moolenaar071d4272004-06-13 20:20:40 +00003723 /*
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003724 * the next seven are used to update the Visual highlighting
Bram Moolenaar071d4272004-06-13 20:20:40 +00003725 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003726 char w_old_visual_mode; // last known VIsual_mode
3727 linenr_T w_old_cursor_lnum; // last known end of visual part
3728 colnr_T w_old_cursor_fcol; // first column for block visual part
3729 colnr_T w_old_cursor_lcol; // last column for block visual part
3730 linenr_T w_old_visual_lnum; // last known start of visual part
3731 colnr_T w_old_visual_col; // last known start of visual part
3732 colnr_T w_old_curswant; // last known value of Curswant
Bram Moolenaar071d4272004-06-13 20:20:40 +00003733
Lewis Russell16246392022-03-29 11:38:17 +01003734 linenr_T w_last_cursor_lnum_rnu; // cursor lnum when 'rnu' was last
3735 // redrawn
3736
Bram Moolenaareed9d462021-02-15 20:38:25 +01003737 lcs_chars_T w_lcs_chars; // 'listchars' characters
Bram Moolenaar96ba25a2022-07-04 17:34:33 +01003738 fill_chars_T w_fill_chars; // 'fillchars' characters
Bram Moolenaareed9d462021-02-15 20:38:25 +01003739
Bram Moolenaar071d4272004-06-13 20:20:40 +00003740 /*
Bram Moolenaard4153d42008-11-15 15:06:17 +00003741 * "w_topline", "w_leftcol" and "w_skipcol" specify the offsets for
3742 * displaying the buffer.
Bram Moolenaar071d4272004-06-13 20:20:40 +00003743 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003744 linenr_T w_topline; // buffer line number of the line at the
3745 // top of the window
3746 char w_topline_was_set; // flag set to TRUE when topline is set,
3747 // e.g. by winrestview()
Bram Moolenaar6a076442020-11-15 20:32:58 +01003748
3749 linenr_T w_botline; // number of the line below the bottom of
3750 // the window
3751
Bram Moolenaar071d4272004-06-13 20:20:40 +00003752#ifdef FEAT_DIFF
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003753 int w_topfill; // number of filler lines above w_topline
3754 int w_old_topfill; // w_topfill at last redraw
3755 int w_botfill; // TRUE when filler lines are actually
3756 // below w_topline (at end of file)
3757 int w_old_botfill; // w_botfill at last redraw
Bram Moolenaar071d4272004-06-13 20:20:40 +00003758#endif
Bram Moolenaarf6196f42022-10-02 21:29:55 +01003759 colnr_T w_leftcol; // screen column number of the left most
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003760 // character in the window; used when
3761 // 'wrap' is off
Bram Moolenaarf6196f42022-10-02 21:29:55 +01003762 colnr_T w_skipcol; // starting screen column for the first
3763 // line in the window; used when 'wrap' is
Bram Moolenaar856c5d22022-10-13 21:54:28 +01003764 // on; does not include win_col_off()
Bram Moolenaar071d4272004-06-13 20:20:40 +00003765
Bram Moolenaar6a076442020-11-15 20:32:58 +01003766 int w_empty_rows; // number of ~ rows in window
3767#ifdef FEAT_DIFF
3768 int w_filler_rows; // number of filler rows at the end of the
3769 // window
3770#endif
3771
Bram Moolenaar2e613452022-12-07 22:30:18 +00003772 // six fields that are only used when there is a WinScrolled autocommand
LemonBoy09371822022-04-08 15:18:45 +01003773 linenr_T w_last_topline; // last known value for w_topline
zeertzjq3fc84dc2022-12-07 09:17:59 +00003774#ifdef FEAT_DIFF
Bram Moolenaar2e613452022-12-07 22:30:18 +00003775 int w_last_topfill; // last known value for w_topfill
zeertzjq3fc84dc2022-12-07 09:17:59 +00003776#endif
LemonBoy09371822022-04-08 15:18:45 +01003777 colnr_T w_last_leftcol; // last known value for w_leftcol
zeertzjq670ab032022-08-28 19:16:15 +01003778 colnr_T w_last_skipcol; // last known value for w_skipcol
LemonBoy09371822022-04-08 15:18:45 +01003779 int w_last_width; // last known value for w_width
3780 int w_last_height; // last known value for w_height
3781
Bram Moolenaar071d4272004-06-13 20:20:40 +00003782 /*
3783 * Layout of the window in the screen.
3784 * May need to add "msg_scrolled" to "w_winrow" in rare situations.
3785 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003786 int w_winrow; // first row of window in screen
3787 int w_height; // number of rows in window, excluding
3788 // status/command/winbar line(s)
Luuk van Baal13ece2a2022-10-03 15:28:08 +01003789 int w_prev_winrow; // previous winrow used for 'splitkeep'
3790 int w_prev_height; // previous height used for 'splitkeep'
Bram Moolenaar6a076442020-11-15 20:32:58 +01003791
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003792 int w_status_height; // number of status lines (0 or 1)
3793 int w_wincol; // Leftmost column of window in screen.
3794 int w_width; // Width of window, excluding separation.
3795 int w_vsep_width; // Number of separator columns (0 or 1).
Bram Moolenaar6a076442020-11-15 20:32:58 +01003796
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003797 pos_save_T w_save_cursor; // backup of cursor pos and topline
Luuk van Baal16af9132023-08-20 20:44:59 +02003798 int w_do_win_fix_cursor;// if TRUE cursor may be invalid
Bram Moolenaar6a076442020-11-15 20:32:58 +01003799
Bram Moolenaar05ad5ff2019-11-30 22:48:27 +01003800#ifdef FEAT_PROP_POPUP
Bram Moolenaarac1f1bc2019-05-30 21:24:26 +02003801 int w_popup_flags; // POPF_ values
Bram Moolenaarafe45b62019-11-13 22:35:19 +01003802 int w_popup_handled; // POPUP_HANDLE[0-9] flags
Bram Moolenaareb2310d2019-06-16 20:09:10 +02003803 char_u *w_popup_title;
Bram Moolenaarac1f1bc2019-05-30 21:24:26 +02003804 poppos_T w_popup_pos;
Bram Moolenaar042fb4b2019-06-02 14:49:56 +02003805 int w_popup_fixed; // do not shift popup to fit on screen
Bram Moolenaar12034e22019-08-25 22:25:02 +02003806 int w_popup_prop_type; // when not zero: textprop type ID
3807 win_T *w_popup_prop_win; // window to search for textprop
3808 int w_popup_prop_id; // when not zero: textprop ID
Bram Moolenaar4d784b22019-05-25 19:51:39 +02003809 int w_zindex;
Bram Moolenaar60cdb302019-05-27 21:54:10 +02003810 int w_minheight; // "minheight" for popup window
3811 int w_minwidth; // "minwidth" for popup window
Bram Moolenaar4d784b22019-05-25 19:51:39 +02003812 int w_maxheight; // "maxheight" for popup window
3813 int w_maxwidth; // "maxwidth" for popup window
Bram Moolenaarde2396f2020-07-18 21:40:41 +02003814 int w_maxwidth_opt; // maxwidth from option
Bram Moolenaar60cdb302019-05-27 21:54:10 +02003815 int w_wantline; // "line" for popup window
3816 int w_wantcol; // "col" for popup window
Bram Moolenaar8d241042019-06-12 23:40:01 +02003817 int w_firstline; // "firstline" for popup window
Bram Moolenaar75fb0852019-06-25 05:15:58 +02003818 int w_want_scrollbar; // when zero don't use a scrollbar
Bram Moolenaarf9c85f52019-06-29 07:41:35 +02003819 int w_has_scrollbar; // 1 if scrollbar displayed, 0 otherwise
Bram Moolenaar4cd583c2019-06-26 05:13:57 +02003820 char_u *w_scrollbar_highlight; // "scrollbarhighlight"
3821 char_u *w_thumb_highlight; // "thumbhighlight"
Bram Moolenaar2fd8e352019-06-01 20:16:48 +02003822 int w_popup_padding[4]; // popup padding top/right/bot/left
3823 int w_popup_border[4]; // popup border top/right/bot/left
Bram Moolenaar790498b2019-06-01 22:15:29 +02003824 char_u *w_border_highlight[4]; // popup border highlight
3825 int w_border_char[8]; // popup border characters
Bram Moolenaard529ba52019-07-02 23:13:53 +02003826
3827 int w_popup_leftoff; // columns left of the screen
3828 int w_popup_rightoff; // columns right of the screen
Bram Moolenaar12034e22019-08-25 22:25:02 +02003829 varnumber_T w_popup_last_changedtick; // b:changedtick of popup buffer
3830 // when position was computed
3831 varnumber_T w_popup_prop_changedtick; // b:changedtick of buffer with
3832 // w_popup_prop_type when position
3833 // was computed
3834 int w_popup_prop_topline; // w_topline of window with
3835 // w_popup_prop_type when position was
3836 // computed
Bram Moolenaar3d2a3cb2019-09-08 17:12:01 +02003837 linenr_T w_popup_last_curline; // last known w_cursor.lnum of window
3838 // with "cursorline" set
Bram Moolenaar9eaac892019-06-01 22:49:29 +02003839 callback_T w_close_cb; // popup close callback
Bram Moolenaarbf0eff02019-06-01 17:13:36 +02003840 callback_T w_filter_cb; // popup filter callback
Bram Moolenaar6defa7b2020-09-08 22:06:44 +02003841 int w_filter_errors; // popup filter error count
Bram Moolenaar581ba392019-09-03 22:08:33 +02003842 int w_filter_mode; // mode when filter callback is used
Bram Moolenaar3397f742019-06-02 18:40:06 +02003843
3844 win_T *w_popup_curwin; // close popup if curwin differs
3845 linenr_T w_popup_lnum; // close popup if cursor not on this line
3846 colnr_T w_popup_mincol; // close popup if cursor before this col
3847 colnr_T w_popup_maxcol; // close popup if cursor after this col
Bram Moolenaar56a63122019-07-07 18:38:34 +02003848 int w_popup_mouse_row; // close popup if mouse moves away
3849 int w_popup_mouse_mincol; // close popup if mouse moves away
3850 int w_popup_mouse_maxcol; // close popup if mouse moves away
Bram Moolenaar2e62b562019-06-30 18:07:00 +02003851 popclose_T w_popup_close; // allow closing the popup with the mouse
Bram Moolenaar3397f742019-06-02 18:40:06 +02003852
Bram Moolenaar4f0d0022019-07-26 22:20:03 +02003853 list_T *w_popup_mask; // list of lists for "mask"
3854 char_u *w_popup_mask_cells; // cached mask cells
3855 int w_popup_mask_height; // height of w_popup_mask_cells
3856 int w_popup_mask_width; // width of w_popup_mask_cells
Bram Moolenaar35d5af62019-05-26 20:44:10 +02003857# if defined(FEAT_TIMERS)
Bram Moolenaar51fe3b12019-05-26 20:10:06 +02003858 timer_T *w_popup_timer; // timer for closing popup window
Bram Moolenaar35d5af62019-05-26 20:44:10 +02003859# endif
Bram Moolenaara68e5952019-04-25 22:22:01 +02003860
Bram Moolenaar6a076442020-11-15 20:32:58 +01003861 int w_flags; // WFLAG_ flags
3862
3863# define WFLAG_WCOL_OFF_ADDED 1 // popup border and padding were added to
3864 // w_wcol
3865# define WFLAG_WROW_OFF_ADDED 2 // popup border and padding were added to
3866 // w_wrow
3867#endif
Bram Moolenaare0de17d2017-09-24 16:24:34 +02003868
Bram Moolenaar071d4272004-06-13 20:20:40 +00003869 /*
3870 * === start of cached values ====
3871 */
3872 /*
3873 * Recomputing is minimized by storing the result of computations.
3874 * Use functions in screen.c to check if they are valid and to update.
3875 * w_valid is a bitfield of flags, which indicate if specific values are
3876 * valid or need to be recomputed. See screen.c for values.
3877 */
3878 int w_valid;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003879 pos_T w_valid_cursor; // last known position of w_cursor, used
3880 // to adjust w_valid
3881 colnr_T w_valid_leftcol; // last known w_leftcol
Bram Moolenaar2fbabd22022-10-12 19:53:38 +01003882 colnr_T w_valid_skipcol; // last known w_skipcol
Bram Moolenaar071d4272004-06-13 20:20:40 +00003883
3884 /*
3885 * w_cline_height is the number of physical lines taken by the buffer line
3886 * that the cursor is on. We use this to avoid extra calls to plines().
3887 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003888 int w_cline_height; // current size of cursor line
Bram Moolenaar071d4272004-06-13 20:20:40 +00003889#ifdef FEAT_FOLDING
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003890 int w_cline_folded; // cursor line is folded
Bram Moolenaar071d4272004-06-13 20:20:40 +00003891#endif
3892
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003893 int w_cline_row; // starting row of the cursor line
Bram Moolenaar071d4272004-06-13 20:20:40 +00003894
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003895 colnr_T w_virtcol; // column number of the cursor in the
3896 // buffer line, as opposed to the column
3897 // number we're at on the screen. This
3898 // makes a difference on lines which span
3899 // more than one screen line or when
3900 // w_leftcol is non-zero
Bram Moolenaar071d4272004-06-13 20:20:40 +00003901
Bram Moolenaar04e0ed12022-09-10 20:00:56 +01003902#ifdef FEAT_PROP_POPUP
3903 colnr_T w_virtcol_first_char; // offset for w_virtcol when there are
3904 // virtual text properties above the
3905 // line
3906#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00003907 /*
3908 * w_wrow and w_wcol specify the cursor position in the window.
3909 * This is related to positions in the window, not in the display or
3910 * buffer, thus w_wrow is relative to w_winrow.
3911 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003912 int w_wrow, w_wcol; // cursor position in window
Bram Moolenaar071d4272004-06-13 20:20:40 +00003913
Bram Moolenaar071d4272004-06-13 20:20:40 +00003914 /*
3915 * Info about the lines currently in the window is remembered to avoid
3916 * recomputing it every time. The allocated size of w_lines[] is Rows.
3917 * Only the w_lines_valid entries are actually valid.
3918 * When the display is up-to-date w_lines[0].wl_lnum is equal to w_topline
3919 * and w_lines[w_lines_valid - 1].wl_lnum is equal to w_botline.
3920 * Between changing text and updating the display w_lines[] represents
3921 * what is currently displayed. wl_valid is reset to indicated this.
3922 * This is used for efficient redrawing.
3923 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003924 int w_lines_valid; // number of valid entries
Bram Moolenaar071d4272004-06-13 20:20:40 +00003925 wline_T *w_lines;
3926
3927#ifdef FEAT_FOLDING
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003928 garray_T w_folds; // array of nested folds
3929 char w_fold_manual; // when TRUE: some folds are opened/closed
3930 // manually
3931 char w_foldinvalid; // when TRUE: folding needs to be
3932 // recomputed
Bram Moolenaar071d4272004-06-13 20:20:40 +00003933#endif
Bram Moolenaar592e0a22004-07-03 16:05:59 +00003934#ifdef FEAT_LINEBREAK
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003935 int w_nrwidth; // width of 'number' and 'relativenumber'
3936 // column being used
Bram Moolenaar592e0a22004-07-03 16:05:59 +00003937#endif
Bram Moolenaar87fd0922021-11-20 13:47:45 +00003938#ifdef FEAT_TERMINAL
3939 termcellcolor_T w_term_wincolor; // cache for term color of 'wincolor'
3940#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00003941
3942 /*
3943 * === end of cached values ===
3944 */
3945
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003946 int w_redr_type; // type of redraw to be performed on win
3947 int w_upd_rows; // number of window lines to update when
Bram Moolenaara4d158b2022-08-14 14:17:45 +01003948 // w_redr_type is UPD_REDRAW_TOP
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003949 linenr_T w_redraw_top; // when != 0: first line needing redraw
3950 linenr_T w_redraw_bot; // when != 0: last line needing redraw
3951 int w_redr_status; // if TRUE status line must be redrawn
Bram Moolenaar071d4272004-06-13 20:20:40 +00003952
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003953 // remember what is shown in the ruler for this window (if 'ruler' set)
3954 pos_T w_ru_cursor; // cursor position shown in ruler
3955 colnr_T w_ru_virtcol; // virtcol shown in ruler
3956 linenr_T w_ru_topline; // topline shown in ruler
3957 linenr_T w_ru_line_count; // line count used for ruler
Martin Tournoijba43e762022-10-13 22:12:15 +01003958#ifdef FEAT_DIFF
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003959 int w_ru_topfill; // topfill shown in ruler
Bram Moolenaar071d4272004-06-13 20:20:40 +00003960#endif
Martin Tournoijba43e762022-10-13 22:12:15 +01003961 char w_ru_empty; // TRUE if ruler shows 0-1 (empty line)
Bram Moolenaar071d4272004-06-13 20:20:40 +00003962
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003963 int w_alt_fnum; // alternate file (for # and CTRL-^)
Bram Moolenaar071d4272004-06-13 20:20:40 +00003964
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003965 alist_T *w_alist; // pointer to arglist for this window
3966 int w_arg_idx; // current index in argument list (can be
3967 // out of range!)
3968 int w_arg_idx_invalid; // editing another file than w_arg_idx
Bram Moolenaar071d4272004-06-13 20:20:40 +00003969
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003970 char_u *w_localdir; // absolute path of local directory or
3971 // NULL
Bram Moolenaar002bc792020-06-05 22:33:42 +02003972 char_u *w_prevdir; // previous directory
Bram Moolenaar1b9645d2017-09-17 23:03:31 +02003973#ifdef FEAT_MENU
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003974 vimmenu_T *w_winbar; // The root of the WinBar menu hierarchy.
3975 winbar_item_T *w_winbar_items; // list of items in the WinBar
3976 int w_winbar_height; // 1 if there is a window toolbar
Bram Moolenaar1b9645d2017-09-17 23:03:31 +02003977#endif
3978
Bram Moolenaar071d4272004-06-13 20:20:40 +00003979 /*
3980 * Options local to a window.
3981 * They are local because they influence the layout of the window or
3982 * depend on the window layout.
3983 * There are two values: w_onebuf_opt is local to the buffer currently in
3984 * this window, w_allbuf_opt is for all buffers in this window.
3985 */
3986 winopt_T w_onebuf_opt;
3987 winopt_T w_allbuf_opt;
Bram Moolenaare70dd112022-01-21 16:31:11 +00003988 // transform a pointer to a "onebuf" option into a "allbuf" option
kylo2529dac9b12022-03-27 20:05:17 +01003989#define GLOBAL_WO(p) ((char *)(p) + sizeof(winopt_T))
Bram Moolenaar071d4272004-06-13 20:20:40 +00003990
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003991 // A few options have local flags for P_INSECURE.
Bram Moolenaard1f56e62006-02-22 21:25:37 +00003992#ifdef FEAT_STL_OPT
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003993 long_u w_p_stl_flags; // flags for 'statusline'
Bram Moolenaard1f56e62006-02-22 21:25:37 +00003994#endif
3995#ifdef FEAT_EVAL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003996 long_u w_p_fde_flags; // flags for 'foldexpr'
3997 long_u w_p_fdt_flags; // flags for 'foldtext'
Bram Moolenaard1f56e62006-02-22 21:25:37 +00003998#endif
Martin Tournoijba43e762022-10-13 22:12:15 +01003999#if defined(FEAT_SIGNS) || defined(FEAT_FOLDING) || defined(FEAT_DIFF)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004000 int *w_p_cc_cols; // array of columns to highlight or NULL
Bram Moolenaar017ba072019-09-14 21:01:23 +02004001 char_u w_p_culopt_flags; // flags for cursorline highlighting
Bram Moolenaar1a384422010-07-14 19:53:30 +02004002#endif
Bram Moolenaard1f56e62006-02-22 21:25:37 +00004003
Bram Moolenaarb81f56f2020-02-23 15:29:46 +01004004#ifdef FEAT_LINEBREAK
4005 int w_briopt_min; // minimum width for breakindent
4006 int w_briopt_shift; // additional shift for breakindent
4007 int w_briopt_sbr; // sbr in 'briopt'
Christian Brabandt4a0b85a2021-07-14 20:00:27 +02004008 int w_briopt_list; // additional indent for lists
Christian Brabandte7d6dbc2022-05-06 12:21:04 +01004009 int w_briopt_vcol; // indent for specific column
Bram Moolenaarb81f56f2020-02-23 15:29:46 +01004010#endif
4011
Bram Moolenaar071d4272004-06-13 20:20:40 +00004012 long w_scbind_pos;
Bram Moolenaar071d4272004-06-13 20:20:40 +00004013
4014#ifdef FEAT_EVAL
Bram Moolenaar4aea03e2019-09-25 22:37:17 +02004015 dictitem_T w_winvar; // variable for "w:" Dictionary
4016 dict_T *w_vars; // internal variables, local to window
Bram Moolenaar071d4272004-06-13 20:20:40 +00004017#endif
4018
Bram Moolenaar071d4272004-06-13 20:20:40 +00004019 /*
4020 * The w_prev_pcmark field is used to check whether we really did jump to
4021 * a new line after setting the w_pcmark. If not, then we revert to
4022 * using the previous w_pcmark.
4023 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004024 pos_T w_pcmark; // previous context mark
4025 pos_T w_prev_pcmark; // previous w_pcmark
Bram Moolenaar071d4272004-06-13 20:20:40 +00004026
Bram Moolenaar071d4272004-06-13 20:20:40 +00004027 /*
4028 * the jumplist contains old cursor positions
4029 */
4030 xfmark_T w_jumplist[JUMPLISTSIZE];
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004031 int w_jumplistlen; // number of active entries
4032 int w_jumplistidx; // current position
Bram Moolenaar071d4272004-06-13 20:20:40 +00004033
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004034 int w_changelistidx; // current position in b_changelist
Bram Moolenaar071d4272004-06-13 20:20:40 +00004035
4036#ifdef FEAT_SEARCH_EXTRA
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004037 matchitem_T *w_match_head; // head of match list
4038 int w_next_match_id; // next match ID
Bram Moolenaar071d4272004-06-13 20:20:40 +00004039#endif
4040
4041 /*
4042 * the tagstack grows from 0 upwards:
4043 * entry 0: older
4044 * entry 1: newer
4045 * entry 2: newest
4046 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004047 taggy_T w_tagstack[TAGSTACKSIZE]; // the tag stack
4048 int w_tagstackidx; // idx just below active entry
4049 int w_tagstacklen; // number of tags on stack
Bram Moolenaar071d4272004-06-13 20:20:40 +00004050
4051 /*
4052 * w_fraction is the fractional row of the cursor within the window, from
4053 * 0 at the top row to FRACTION_MULT at the last row.
4054 * w_prev_fraction_row was the actual cursor row when w_fraction was last
4055 * calculated.
4056 */
4057 int w_fraction;
4058 int w_prev_fraction_row;
4059
4060#ifdef FEAT_GUI
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004061 scrollbar_T w_scrollbars[2]; // vert. Scrollbars for this window
Bram Moolenaar071d4272004-06-13 20:20:40 +00004062#endif
Bram Moolenaar592e0a22004-07-03 16:05:59 +00004063#ifdef FEAT_LINEBREAK
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004064 linenr_T w_nrwidth_line_count; // line count when ml_nrwidth_width
4065 // was computed.
4066 long w_nuw_cached; // 'numberwidth' option cached
4067 int w_nrwidth_width; // nr of chars to print line count.
Bram Moolenaar592e0a22004-07-03 16:05:59 +00004068#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00004069
Bram Moolenaard12f5c12006-01-25 22:10:52 +00004070#ifdef FEAT_QUICKFIX
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004071 qf_info_T *w_llist; // Location list for this window
Bram Moolenaard12f5c12006-01-25 22:10:52 +00004072 /*
4073 * Location list reference used in the location list window.
4074 * In a non-location list window, w_llist_ref is NULL.
4075 */
4076 qf_info_T *w_llist_ref;
4077#endif
4078
Bram Moolenaar325b7a22004-07-05 15:58:32 +00004079#ifdef FEAT_MZSCHEME
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004080 void *w_mzscheme_ref; // The MzScheme value for this window
Bram Moolenaar325b7a22004-07-05 15:58:32 +00004081#endif
4082
Bram Moolenaar071d4272004-06-13 20:20:40 +00004083#ifdef FEAT_PERL
Bram Moolenaare344bea2005-09-01 20:46:49 +00004084 void *w_perl_private;
Bram Moolenaar071d4272004-06-13 20:20:40 +00004085#endif
4086
4087#ifdef FEAT_PYTHON
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004088 void *w_python_ref; // The Python value for this window
Bram Moolenaar071d4272004-06-13 20:20:40 +00004089#endif
4090
Bram Moolenaarbd5e15f2010-07-17 21:19:38 +02004091#ifdef FEAT_PYTHON3
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004092 void *w_python3_ref; // The Python value for this window
Bram Moolenaarbd5e15f2010-07-17 21:19:38 +02004093#endif
4094
Bram Moolenaar071d4272004-06-13 20:20:40 +00004095#ifdef FEAT_TCL
Bram Moolenaare344bea2005-09-01 20:46:49 +00004096 void *w_tcl_ref;
Bram Moolenaar071d4272004-06-13 20:20:40 +00004097#endif
4098
4099#ifdef FEAT_RUBY
Bram Moolenaare344bea2005-09-01 20:46:49 +00004100 void *w_ruby_ref;
Bram Moolenaar071d4272004-06-13 20:20:40 +00004101#endif
4102};
4103
4104/*
4105 * Arguments for operators.
4106 */
Bram Moolenaare344bea2005-09-01 20:46:49 +00004107typedef struct oparg_S
Bram Moolenaar071d4272004-06-13 20:20:40 +00004108{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004109 int op_type; // current pending operator type
4110 int regname; // register to use for the operator
4111 int motion_type; // type of the current cursor motion
4112 int motion_force; // force motion type: 'v', 'V' or CTRL-V
4113 int use_reg_one; // TRUE if delete uses reg 1 even when not
4114 // linewise
4115 int inclusive; // TRUE if char motion is inclusive (only
Christian Brabandt544a38e2021-06-10 19:39:11 +02004116 // valid when motion_type is MCHAR)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004117 int end_adjusted; // backuped b_op_end one char (only used by
4118 // do_format())
4119 pos_T start; // start of the operator
4120 pos_T end; // end of the operator
4121 pos_T cursor_start; // cursor position before motion for "gw"
Bram Moolenaar071d4272004-06-13 20:20:40 +00004122
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004123 long line_count; // number of lines from op_start to op_end
4124 // (inclusive)
4125 int empty; // op_start and op_end the same (only used by
4126 // do_change())
4127 int is_VIsual; // operator on Visual area
4128 int block_mode; // current operator is Visual block mode
4129 colnr_T start_vcol; // start col for block mode operator
4130 colnr_T end_vcol; // end col for block mode operator
4131 long prev_opcount; // ca.opcount saved for K_CURSORHOLD
4132 long prev_count0; // ca.count0 saved for K_CURSORHOLD
Christian Brabandt544a38e2021-06-10 19:39:11 +02004133 int excl_tr_ws; // exclude trailing whitespace for yank of a
4134 // block
Bram Moolenaar071d4272004-06-13 20:20:40 +00004135} oparg_T;
4136
4137/*
4138 * Arguments for Normal mode commands.
4139 */
Bram Moolenaare344bea2005-09-01 20:46:49 +00004140typedef struct cmdarg_S
Bram Moolenaar071d4272004-06-13 20:20:40 +00004141{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004142 oparg_T *oap; // Operator arguments
4143 int prechar; // prefix character (optional, always 'g')
4144 int cmdchar; // command character
4145 int nchar; // next command character (optional)
4146 int ncharC1; // first composing character (optional)
4147 int ncharC2; // second composing character (optional)
4148 int extra_char; // yet another character (optional)
4149 long opcount; // count before an operator
4150 long count0; // count before command, default 0
4151 long count1; // count before command, default 1
4152 int arg; // extra argument from nv_cmds[]
4153 int retval; // return: CA_* values
4154 char_u *searchbuf; // return: pointer to search pattern or NULL
Bram Moolenaar071d4272004-06-13 20:20:40 +00004155} cmdarg_T;
4156
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004157// values for retval:
4158#define CA_COMMAND_BUSY 1 // skip restarting edit() once
4159#define CA_NO_ADJ_OP_END 2 // don't adjust operator end
Bram Moolenaar071d4272004-06-13 20:20:40 +00004160
4161#ifdef CURSOR_SHAPE
4162/*
4163 * struct to store values from 'guicursor' and 'mouseshape'
4164 */
Bram Moolenaar9bf703d2019-11-30 19:44:38 +01004165// Indexes in shape_table[]
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004166#define SHAPE_IDX_N 0 // Normal mode
4167#define SHAPE_IDX_V 1 // Visual mode
4168#define SHAPE_IDX_I 2 // Insert mode
4169#define SHAPE_IDX_R 3 // Replace mode
4170#define SHAPE_IDX_C 4 // Command line Normal mode
4171#define SHAPE_IDX_CI 5 // Command line Insert mode
4172#define SHAPE_IDX_CR 6 // Command line Replace mode
4173#define SHAPE_IDX_O 7 // Operator-pending mode
4174#define SHAPE_IDX_VE 8 // Visual mode with 'selection' exclusive
4175#define SHAPE_IDX_CLINE 9 // On command line
4176#define SHAPE_IDX_STATUS 10 // A status line
4177#define SHAPE_IDX_SDRAG 11 // dragging a status line
4178#define SHAPE_IDX_VSEP 12 // A vertical separator line
4179#define SHAPE_IDX_VDRAG 13 // dragging a vertical separator line
4180#define SHAPE_IDX_MORE 14 // Hit-return or More
4181#define SHAPE_IDX_MOREL 15 // Hit-return or More in last line
4182#define SHAPE_IDX_SM 16 // showing matching paren
Bram Moolenaar071d4272004-06-13 20:20:40 +00004183#define SHAPE_IDX_COUNT 17
4184
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004185#define SHAPE_BLOCK 0 // block cursor
4186#define SHAPE_HOR 1 // horizontal bar cursor
4187#define SHAPE_VER 2 // vertical bar cursor
Bram Moolenaar071d4272004-06-13 20:20:40 +00004188
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004189#define MSHAPE_NUMBERED 1000 // offset for shapes identified by number
4190#define MSHAPE_HIDE 1 // hide mouse pointer
Bram Moolenaar071d4272004-06-13 20:20:40 +00004191
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004192#define SHAPE_MOUSE 1 // used for mouse pointer shape
4193#define SHAPE_CURSOR 2 // used for text cursor shape
Bram Moolenaar071d4272004-06-13 20:20:40 +00004194
4195typedef struct cursor_entry
4196{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004197 int shape; // one of the SHAPE_ defines
4198 int mshape; // one of the MSHAPE defines
4199 int percentage; // percentage of cell for bar
4200 long blinkwait; // blinking, wait time before blinking starts
4201 long blinkon; // blinking, on time
4202 long blinkoff; // blinking, off time
4203 int id; // highlight group ID
4204 int id_lm; // highlight group ID for :lmap mode
4205 char *name; // mode name (fixed)
4206 char used_for; // SHAPE_MOUSE and/or SHAPE_CURSOR
Bram Moolenaar071d4272004-06-13 20:20:40 +00004207} cursorentry_T;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004208#endif // CURSOR_SHAPE
Bram Moolenaar071d4272004-06-13 20:20:40 +00004209
4210#ifdef FEAT_MENU
4211
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004212// Indices into vimmenu_T->strings[] and vimmenu_T->noremap[] for each mode
Bram Moolenaar071d4272004-06-13 20:20:40 +00004213#define MENU_INDEX_INVALID -1
4214#define MENU_INDEX_NORMAL 0
4215#define MENU_INDEX_VISUAL 1
Bram Moolenaar9b2200a2006-03-20 21:55:45 +00004216#define MENU_INDEX_SELECT 2
4217#define MENU_INDEX_OP_PENDING 3
4218#define MENU_INDEX_INSERT 4
4219#define MENU_INDEX_CMDLINE 5
Bram Moolenaar4c5d8152018-10-19 22:36:53 +02004220#define MENU_INDEX_TERMINAL 6
4221#define MENU_INDEX_TIP 7
4222#define MENU_MODES 8
Bram Moolenaar071d4272004-06-13 20:20:40 +00004223
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004224// Menu modes
Bram Moolenaar071d4272004-06-13 20:20:40 +00004225#define MENU_NORMAL_MODE (1 << MENU_INDEX_NORMAL)
4226#define MENU_VISUAL_MODE (1 << MENU_INDEX_VISUAL)
Bram Moolenaar9b2200a2006-03-20 21:55:45 +00004227#define MENU_SELECT_MODE (1 << MENU_INDEX_SELECT)
Bram Moolenaar071d4272004-06-13 20:20:40 +00004228#define MENU_OP_PENDING_MODE (1 << MENU_INDEX_OP_PENDING)
4229#define MENU_INSERT_MODE (1 << MENU_INDEX_INSERT)
4230#define MENU_CMDLINE_MODE (1 << MENU_INDEX_CMDLINE)
Bram Moolenaar4c5d8152018-10-19 22:36:53 +02004231#define MENU_TERMINAL_MODE (1 << MENU_INDEX_TERMINAL)
Bram Moolenaar071d4272004-06-13 20:20:40 +00004232#define MENU_TIP_MODE (1 << MENU_INDEX_TIP)
4233#define MENU_ALL_MODES ((1 << MENU_INDEX_TIP) - 1)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004234// note MENU_INDEX_TIP is not a 'real' mode
Bram Moolenaar071d4272004-06-13 20:20:40 +00004235
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004236// Start a menu name with this to not include it on the main menu bar
Bram Moolenaar071d4272004-06-13 20:20:40 +00004237#define MNU_HIDDEN_CHAR ']'
4238
Bram Moolenaar071d4272004-06-13 20:20:40 +00004239struct VimMenu
4240{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004241 int modes; // Which modes is this menu visible for?
4242 int enabled; // for which modes the menu is enabled
4243 char_u *name; // Name of menu, possibly translated
4244 char_u *dname; // Displayed Name ("name" without '&')
Bram Moolenaar70b11cd2010-05-14 22:24:40 +02004245#ifdef FEAT_MULTI_LANG
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004246 char_u *en_name; // "name" untranslated, NULL when "name"
4247 // was not translated
4248 char_u *en_dname; // "dname" untranslated, NULL when "dname"
4249 // was not translated
Bram Moolenaar70b11cd2010-05-14 22:24:40 +02004250#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004251 char_u *actext; // accelerator text (after TAB)
Dominique Pelle3276f582021-08-07 12:44:41 +02004252 int mnemonic; // mnemonic key (after '&')
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004253 int priority; // Menu order priority
Bram Moolenaar071d4272004-06-13 20:20:40 +00004254#ifdef FEAT_GUI
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004255 void (*cb)(vimmenu_T *); // Call-back function
Bram Moolenaar071d4272004-06-13 20:20:40 +00004256#endif
4257#ifdef FEAT_TOOLBAR
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004258 char_u *iconfile; // name of file for icon or NULL
4259 int iconidx; // icon index (-1 if not set)
4260 int icon_builtin; // icon names is BuiltIn{nr}
Bram Moolenaar071d4272004-06-13 20:20:40 +00004261#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004262 char_u *strings[MENU_MODES]; // Mapped string for each mode
4263 int noremap[MENU_MODES]; // A REMAP_ flag for each mode
4264 char silent[MENU_MODES]; // A silent flag for each mode
4265 vimmenu_T *children; // Children of sub-menu
4266 vimmenu_T *parent; // Parent of menu
4267 vimmenu_T *next; // Next item in menu
Bram Moolenaar071d4272004-06-13 20:20:40 +00004268#ifdef FEAT_GUI_X11
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004269 Widget id; // Manage this to enable item
4270 Widget submenu_id; // If this is submenu, add children here
Bram Moolenaar071d4272004-06-13 20:20:40 +00004271#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00004272#ifdef FEAT_GUI_GTK
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004273 GtkWidget *id; // Manage this to enable item
4274 GtkWidget *submenu_id; // If this is submenu, add children here
Bram Moolenaar98921892016-02-23 17:14:37 +01004275# if defined(GTK_CHECK_VERSION) && !GTK_CHECK_VERSION(3,4,0)
Bram Moolenaar071d4272004-06-13 20:20:40 +00004276 GtkWidget *tearoff_handle;
Bram Moolenaar98921892016-02-23 17:14:37 +01004277# endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004278 GtkWidget *label; // Used by "set wak=" code.
Bram Moolenaar071d4272004-06-13 20:20:40 +00004279#endif
4280#ifdef FEAT_GUI_MOTIF
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004281 int sensitive; // turn button on/off
4282 char **xpm; // pixmap data
4283 char *xpm_fname; // file with pixmap data
Bram Moolenaar071d4272004-06-13 20:20:40 +00004284#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00004285#ifdef FEAT_BEVAL_TIP
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004286 BalloonEval *tip; // tooltip for this menu item
Bram Moolenaar071d4272004-06-13 20:20:40 +00004287#endif
Bram Moolenaar4f974752019-02-17 17:44:42 +01004288#ifdef FEAT_GUI_MSWIN
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004289 UINT id; // Id of menu item
4290 HMENU submenu_id; // If this is submenu, add children here
4291 HWND tearoff_handle; // hWnd of tearoff if created
Bram Moolenaar071d4272004-06-13 20:20:40 +00004292#endif
Bram Moolenaarb3f74062020-02-26 16:16:53 +01004293#if FEAT_GUI_HAIKU
4294 BMenuItem *id; // Id of menu item
4295 BMenu *submenu_id; // If this is submenu, add children here
4296# ifdef FEAT_TOOLBAR
4297 BPictureButton *button;
4298# endif
4299#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00004300#ifdef FEAT_GUI_PHOTON
4301 PtWidget_t *id;
4302 PtWidget_t *submenu_id;
4303#endif
4304};
4305#else
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004306// For generating prototypes when FEAT_MENU isn't defined.
Bram Moolenaar071d4272004-06-13 20:20:40 +00004307typedef int vimmenu_T;
4308
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004309#endif // FEAT_MENU
Bram Moolenaar071d4272004-06-13 20:20:40 +00004310
4311/*
4312 * Struct to save values in before executing autocommands for a buffer that is
Bram Moolenaarf2bd8ef2018-03-04 18:08:14 +01004313 * not the current buffer.
Bram Moolenaar071d4272004-06-13 20:20:40 +00004314 */
4315typedef struct
4316{
Bram Moolenaarcbcd9cb2020-11-07 16:58:59 +01004317 buf_T *save_curbuf; // saved curbuf
Bram Moolenaare76062c2022-11-28 18:51:43 +00004318 int use_aucmd_win_idx; // index in aucmd_win[] if >= 0
Bram Moolenaarcbcd9cb2020-11-07 16:58:59 +01004319 int save_curwin_id; // ID of saved curwin
4320 int new_curwin_id; // ID of new curwin
4321 int save_prevwin_id; // ID of saved prevwin
4322 bufref_T new_curbuf; // new curbuf
4323 char_u *globaldir; // saved value of globaldir
Bram Moolenaarcb1956d2022-01-07 15:45:18 +00004324 int save_VIsual_active; // saved VIsual_active
Bram Moolenaar05a627c2023-04-09 22:01:31 +01004325 int save_State; // saved State
Bram Moolenaar071d4272004-06-13 20:20:40 +00004326} aco_save_T;
4327
4328/*
4329 * Generic option table item, only used for printer at the moment.
4330 */
4331typedef struct
4332{
4333 const char *name;
4334 int hasnum;
4335 long number;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004336 char_u *string; // points into option string
Bram Moolenaar071d4272004-06-13 20:20:40 +00004337 int strlen;
4338 int present;
4339} option_table_T;
4340
4341/*
4342 * Structure to hold printing color and font attributes.
4343 */
4344typedef struct
4345{
4346 long_u fg_color;
4347 long_u bg_color;
4348 int bold;
4349 int italic;
4350 int underline;
Bram Moolenaare2cc9702005-03-15 22:43:58 +00004351 int undercurl;
Bram Moolenaar071d4272004-06-13 20:20:40 +00004352} prt_text_attr_T;
4353
4354/*
4355 * Structure passed back to the generic printer code.
4356 */
4357typedef struct
4358{
4359 int n_collated_copies;
4360 int n_uncollated_copies;
4361 int duplex;
4362 int chars_per_line;
4363 int lines_per_page;
4364 int has_color;
4365 prt_text_attr_T number;
4366#ifdef FEAT_SYN_HL
4367 int modec;
4368 int do_syntax;
4369#endif
4370 int user_abort;
4371 char_u *jobname;
4372#ifdef FEAT_POSTSCRIPT
4373 char_u *outfile;
4374 char_u *arguments;
4375#endif
4376} prt_settings_T;
4377
4378#define PRINT_NUMBER_WIDTH 8
Bram Moolenaar8b6144b2006-02-08 09:20:24 +00004379
4380/*
4381 * Used for popup menu items.
4382 */
4383typedef struct
4384{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004385 char_u *pum_text; // main menu text
4386 char_u *pum_kind; // extra kind text (may be truncated)
4387 char_u *pum_extra; // extra menu text (may be truncated)
4388 char_u *pum_info; // extra info
Bram Moolenaar8b6144b2006-02-08 09:20:24 +00004389} pumitem_T;
Bram Moolenaara23ccb82006-02-27 00:08:02 +00004390
4391/*
4392 * Structure used for get_tagfname().
4393 */
4394typedef struct
4395{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004396 char_u *tn_tags; // value of 'tags' when starting
4397 char_u *tn_np; // current position in tn_tags
Bram Moolenaara23ccb82006-02-27 00:08:02 +00004398 int tn_did_filefind_init;
4399 int tn_hf_idx;
4400 void *tn_search_ctx;
4401} tagname_T;
4402
Bram Moolenaar55debbe2010-05-23 23:34:36 +02004403typedef struct {
4404 UINT32_T total[2];
4405 UINT32_T state[8];
4406 char_u buffer[64];
4407} context_sha256_T;
Bram Moolenaar520e1e42016-01-23 19:46:28 +01004408
4409/*
Bram Moolenaarc6f9f732018-02-11 19:06:26 +01004410 * types for expressions.
4411 */
4412typedef enum
4413{
Bram Moolenaar87396072019-12-31 22:36:18 +01004414 EXPR_UNKNOWN = 0,
4415 EXPR_EQUAL, // ==
4416 EXPR_NEQUAL, // !=
4417 EXPR_GREATER, // >
4418 EXPR_GEQUAL, // >=
4419 EXPR_SMALLER, // <
4420 EXPR_SEQUAL, // <=
4421 EXPR_MATCH, // =~
4422 EXPR_NOMATCH, // !~
4423 EXPR_IS, // is
4424 EXPR_ISNOT, // isnot
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004425 // used with ISN_OPNR
4426 EXPR_ADD, // +
4427 EXPR_SUB, // -
4428 EXPR_MULT, // *
4429 EXPR_DIV, // /
4430 EXPR_REM, // %
Yegappan Lakshmanana061f342022-05-22 19:13:49 +01004431 EXPR_LSHIFT, // <<
4432 EXPR_RSHIFT, // >>
Bram Moolenaar07802042021-09-09 23:01:14 +02004433 // used with ISN_ADDLIST
4434 EXPR_COPY, // create new list
4435 EXPR_APPEND, // append to first list
Bram Moolenaar657137c2021-01-09 15:45:23 +01004436} exprtype_T;
Bram Moolenaarc6f9f732018-02-11 19:06:26 +01004437
4438/*
Bram Moolenaar520e1e42016-01-23 19:46:28 +01004439 * Structure used for reading in json_decode().
4440 */
Bram Moolenaar56ead342016-02-02 18:20:08 +01004441struct js_reader
Bram Moolenaar520e1e42016-01-23 19:46:28 +01004442{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004443 char_u *js_buf; // text to be decoded
4444 char_u *js_end; // NUL in js_buf
4445 int js_used; // bytes used from js_buf
Bram Moolenaar56ead342016-02-02 18:20:08 +01004446 int (*js_fill)(struct js_reader *);
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004447 // function to fill the buffer or NULL;
4448 // return TRUE when the buffer was filled
4449 void *js_cookie; // can be used by js_fill
4450 int js_cookie_arg; // can be used by js_fill
Bram Moolenaar56ead342016-02-02 18:20:08 +01004451};
4452typedef struct js_reader js_read_T;
Bram Moolenaar975b5272016-03-15 23:10:59 +01004453
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004454// Maximum number of commands from + or -c arguments.
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02004455#define MAX_ARG_CMDS 10
4456
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004457// values for "window_layout"
4458#define WIN_HOR 1 // "-o" horizontally split windows
4459#define WIN_VER 2 // "-O" vertically split windows
4460#define WIN_TABS 3 // "-p" windows on tab pages
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02004461
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004462// Struct for various parameters passed between main() and other functions.
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02004463typedef struct
4464{
4465 int argc;
4466 char **argv;
4467
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004468 char_u *fname; // first file to edit
Bram Moolenaara8e691d2016-08-07 15:19:26 +02004469
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004470 int evim_mode; // started as "evim"
4471 char_u *use_vimrc; // vimrc from -u argument
4472 int clean; // --clean argument
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02004473
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004474 int n_commands; // no. of commands from + or -c
4475 char_u *commands[MAX_ARG_CMDS]; // commands from + or -c arg.
4476 char_u cmds_tofree[MAX_ARG_CMDS]; // commands that need free()
4477 int n_pre_commands; // no. of commands from --cmd
4478 char_u *pre_commands[MAX_ARG_CMDS]; // commands from --cmd argument
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02004479
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004480 int edit_type; // type of editing to do
4481 char_u *tagname; // tag from -t argument
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02004482#ifdef FEAT_QUICKFIX
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004483 char_u *use_ef; // 'errorfile' from -q argument
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02004484#endif
4485
4486 int want_full_screen;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004487 int not_a_term; // no warning for missing term?
Bram Moolenaar2d12c252022-06-13 21:42:45 +01004488#ifdef FEAT_GUI
4489 char_u *gui_dialog_file; // file to write dialog text in
4490#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004491 int tty_fail; // exit if not a tty
4492 char_u *term; // specified terminal name
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02004493#ifdef FEAT_CRYPT
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004494 int ask_for_key; // -x argument
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02004495#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004496 int no_swap_file; // "-n" argument used
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02004497#ifdef FEAT_EVAL
4498 int use_debug_break_level;
4499#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004500 int window_count; // number of windows to use
4501 int window_layout; // 0, WIN_HOR, WIN_VER or WIN_TABS
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02004502
4503#ifdef FEAT_CLIENTSERVER
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004504 int serverArg; // TRUE when argument for a server
4505 char_u *serverName_arg; // cmdline arg for server name
4506 char_u *serverStr; // remote server command
4507 char_u *serverStrEnc; // encoding of serverStr
4508 char_u *servername; // allocated name for our server
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02004509#endif
4510#if !defined(UNIX)
4511# define EXPAND_FILENAMES
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004512 int literal; // don't expand file names
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02004513#endif
4514#ifdef MSWIN
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004515 int full_path; // file name argument was full path
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02004516#endif
4517#ifdef FEAT_DIFF
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004518 int diff_mode; // start with 'diff' set
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02004519#endif
4520} mparm_T;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004521
4522/*
4523 * Structure returned by get_lval() and used by set_var_lval().
4524 * For a plain name:
4525 * "name" points to the variable name.
4526 * "exp_name" is NULL.
4527 * "tv" is NULL
4528 * For a magic braces name:
4529 * "name" points to the expanded variable name.
4530 * "exp_name" is non-NULL, to be freed later.
4531 * "tv" is NULL
4532 * For an index in a list:
4533 * "name" points to the (expanded) variable name.
4534 * "exp_name" NULL or non-NULL, to be freed later.
4535 * "tv" points to the (first) list item value
4536 * "li" points to the (first) list item
4537 * "range", "n1", "n2" and "empty2" indicate what items are used.
4538 * For an existing Dict item:
4539 * "name" points to the (expanded) variable name.
4540 * "exp_name" NULL or non-NULL, to be freed later.
4541 * "tv" points to the dict item value
4542 * "newkey" is NULL
4543 * For a non-existing Dict item:
4544 * "name" points to the (expanded) variable name.
4545 * "exp_name" NULL or non-NULL, to be freed later.
4546 * "tv" points to the Dictionary typval_T
4547 * "newkey" is the key for the new item.
4548 */
4549typedef struct lval_S
4550{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004551 char_u *ll_name; // start of variable name (can be NULL)
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004552 char_u *ll_name_end; // end of variable name (can be NULL)
4553 type_T *ll_type; // type of variable (can be NULL)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004554 char_u *ll_exp_name; // NULL or expanded name in allocated memory.
Bram Moolenaard5f400c2022-01-06 21:10:28 +00004555
4556 scid_T ll_sid; // for an imported item: the script ID it was
4557 // imported from; zero otherwise
4558
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004559 typval_T *ll_tv; // Typeval of item being used. If "newkey"
4560 // isn't NULL it's the Dict to which to add
4561 // the item.
4562 listitem_T *ll_li; // The list item or NULL.
4563 list_T *ll_list; // The list or NULL.
4564 int ll_range; // TRUE when a [i:j] range was used
Bram Moolenaard6beab02019-11-10 15:07:19 +01004565 int ll_empty2; // Second index is empty: [i:]
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004566 long ll_n1; // First index for list
4567 long ll_n2; // Second index for list range
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004568 dict_T *ll_dict; // The Dictionary or NULL
4569 dictitem_T *ll_di; // The dictitem or NULL
4570 char_u *ll_newkey; // New key for Dict in alloc. mem or NULL.
Bram Moolenaar10c65862020-10-08 21:16:42 +02004571 type_T *ll_valtype; // type expected for the value or NULL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004572 blob_T *ll_blob; // The Blob or NULL
Bram Moolenaar99a7c0d2023-02-21 19:55:14 +00004573 ufunc_T *ll_ufunc; // The function or NULL
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004574} lval_T;
Bram Moolenaara21a6a92017-09-23 16:33:50 +02004575
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004576// Structure used to save the current state. Used when executing Normal mode
4577// commands while in any other mode.
Bram Moolenaara21a6a92017-09-23 16:33:50 +02004578typedef struct {
4579 int save_msg_scroll;
4580 int save_restart_edit;
4581 int save_msg_didout;
4582 int save_State;
4583 int save_insertmode;
4584 int save_finish_op;
4585 int save_opcount;
Bram Moolenaarcce713d2019-03-04 11:40:12 +01004586 int save_reg_executing;
zeertzjq6d4e7252022-04-07 13:58:04 +01004587 int save_pending_end_reg_executing;
Bram Moolenaar4324d872020-12-01 20:12:24 +01004588 int save_script_version;
Bram Moolenaara21a6a92017-09-23 16:33:50 +02004589 tasave_T tabuf;
4590} save_state_T;
Bram Moolenaarb0f42ba2018-05-12 15:38:26 +02004591
4592typedef struct {
4593 varnumber_T vv_prevcount;
4594 varnumber_T vv_count;
4595 varnumber_T vv_count1;
4596} vimvars_save_T;
Bram Moolenaar1063f3d2019-05-07 22:06:52 +02004597
4598// Scope for changing directory
4599typedef enum {
4600 CDSCOPE_GLOBAL, // :cd
4601 CDSCOPE_TABPAGE, // :tcd
4602 CDSCOPE_WINDOW // :lcd
4603} cdscope_T;
Bram Moolenaar451d4b52019-06-12 20:22:27 +02004604
Bram Moolenaardefa0672019-07-21 19:25:37 +02004605// Variable flavor
4606typedef enum
4607{
Bram Moolenaar4aea03e2019-09-25 22:37:17 +02004608 VAR_FLAVOUR_DEFAULT, // doesn't start with uppercase
4609 VAR_FLAVOUR_SESSION, // starts with uppercase, some lower
4610 VAR_FLAVOUR_VIMINFO // all uppercase
Bram Moolenaardefa0672019-07-21 19:25:37 +02004611} var_flavour_T;
4612
Bram Moolenaar451d4b52019-06-12 20:22:27 +02004613// argument for mouse_find_win()
4614typedef enum {
4615 IGNORE_POPUP, // only check non-popup windows
4616 FIND_POPUP, // also find popup windows
4617 FAIL_POPUP // return NULL if mouse on popup window
4618} mouse_find_T;
Bram Moolenaarc3328162019-07-23 22:15:25 +02004619
4620// Symbolic names for some registers.
4621#define DELETION_REGISTER 36
4622#ifdef FEAT_CLIPBOARD
4623# define STAR_REGISTER 37
4624# ifdef FEAT_X11
4625# define PLUS_REGISTER 38
4626# else
4627# define PLUS_REGISTER STAR_REGISTER // there is only one
4628# endif
4629#endif
4630#ifdef FEAT_DND
4631# define TILDE_REGISTER (PLUS_REGISTER + 1)
4632#endif
4633
4634#ifdef FEAT_CLIPBOARD
4635# ifdef FEAT_DND
4636# define NUM_REGISTERS (TILDE_REGISTER + 1)
4637# else
4638# define NUM_REGISTERS (PLUS_REGISTER + 1)
4639# endif
4640#else
4641# define NUM_REGISTERS 37
4642#endif
4643
Bram Moolenaar4aea03e2019-09-25 22:37:17 +02004644// structure used by block_prep, op_delete and op_yank for blockwise operators
4645// also op_change, op_shift, op_insert, op_replace - AKelly
4646struct block_def
4647{
4648 int startspaces; // 'extra' cols before first char
4649 int endspaces; // 'extra' cols after last char
4650 int textlen; // chars in block
4651 char_u *textstart; // pointer to 1st char (partially) in block
4652 colnr_T textcol; // index of chars (partially) in block
4653 colnr_T start_vcol; // start col of 1st char wholly inside block
4654 colnr_T end_vcol; // start col of 1st char wholly after block
4655 int is_short; // TRUE if line is too short to fit in block
4656 int is_MAX; // TRUE if curswant==MAXCOL when starting
4657 int is_oneChar; // TRUE if block within one character
4658 int pre_whitesp; // screen cols of ws before block
4659 int pre_whitesp_c; // chars of ws before block
4660 colnr_T end_char_vcols; // number of vcols of post-block char
4661 colnr_T start_char_vcols; // number of vcols of pre-block char
4662};
4663
Bram Moolenaarc3328162019-07-23 22:15:25 +02004664// Each yank register has an array of pointers to lines.
4665typedef struct
4666{
4667 char_u **y_array; // pointer to array of line pointers
4668 linenr_T y_size; // number of lines in y_array
4669 char_u y_type; // MLINE, MCHAR or MBLOCK
4670 colnr_T y_width; // only set if y_type == MBLOCK
4671#ifdef FEAT_VIMINFO
4672 time_t y_time_set;
4673#endif
4674} yankreg_T;
4675
4676// The offset for a search command is store in a soff struct
4677// Note: only spats[0].off is really used
4678typedef struct soffset
4679{
4680 int dir; // search direction, '/' or '?'
4681 int line; // search has line offset
4682 int end; // search set cursor at end
4683 long off; // line or char offset
4684} soffset_T;
4685
4686// A search pattern and its attributes are stored in a spat struct
4687typedef struct spat
4688{
4689 char_u *pat; // the pattern (in allocated memory) or NULL
4690 int magic; // magicness of the pattern
4691 int no_scs; // no smartcase for this pattern
4692 soffset_T off;
4693} spat_T;
Bram Moolenaar473952e2019-09-28 16:30:04 +02004694
Bram Moolenaar92ea26b2019-10-18 20:53:34 +02004695/*
4696 * Optional extra arguments for searchit().
4697 */
4698typedef struct
4699{
4700 linenr_T sa_stop_lnum; // stop after this line number when != 0
4701#ifdef FEAT_RELTIME
Paul Ollis65745772022-06-05 16:55:54 +01004702 long sa_tm; // timeout limit or zero
Bram Moolenaar92ea26b2019-10-18 20:53:34 +02004703 int sa_timed_out; // set when timed out
4704#endif
4705 int sa_wrapped; // search wrapped around
4706} searchit_arg_T;
4707
Bram Moolenaar9567efa2021-01-11 22:16:30 +01004708/*
4709 * Cookie used by getsourceline().
4710 */
4711/*
4712 * Cookie used to store info for each sourced file.
4713 * It is shared between do_source() and getsourceline().
4714 * This is passed to do_cmdline().
4715 */
4716typedef struct {
4717 FILE *fp; // opened file for sourcing
4718 char_u *nextline; // if not NULL: line that was read ahead
4719 linenr_T sourcing_lnum; // line number of the source file
4720 int finished; // ":finish" used
Yegappan Lakshmanan85b43c62022-03-21 19:45:17 +00004721 int source_from_buf;// TRUE if sourcing from current buffer
4722 int buf_lnum; // line number in the current buffer
4723 garray_T buflines; // lines in the current buffer
Bram Moolenaar9567efa2021-01-11 22:16:30 +01004724#ifdef USE_CRNL
4725 int fileformat; // EOL_UNKNOWN, EOL_UNIX or EOL_DOS
4726 int error; // TRUE if LF found after CR-LF
4727#endif
4728#ifdef FEAT_EVAL
4729 linenr_T breakpoint; // next line with breakpoint or zero
4730 char_u *fname; // name of sourced file
4731 int dbg_tick; // debug_tick when breakpoint was set
4732 int level; // top nesting level of sourced file
4733#endif
4734 vimconv_T conv; // type of conversion
4735} source_cookie_T;
4736
Bram Moolenaaradc17a52020-06-06 18:37:51 +02004737
Bram Moolenaar473952e2019-09-28 16:30:04 +02004738#define WRITEBUFSIZE 8192 // size of normal write buffer
4739
4740#define FIO_LATIN1 0x01 // convert Latin1
4741#define FIO_UTF8 0x02 // convert UTF-8
4742#define FIO_UCS2 0x04 // convert UCS-2
4743#define FIO_UCS4 0x08 // convert UCS-4
4744#define FIO_UTF16 0x10 // convert UTF-16
4745#ifdef MSWIN
4746# define FIO_CODEPAGE 0x20 // convert MS-Windows codepage
4747# define FIO_PUT_CP(x) (((x) & 0xffff) << 16) // put codepage in top word
4748# define FIO_GET_CP(x) (((x)>>16) & 0xffff) // get codepage from top word
4749#endif
4750#ifdef MACOS_CONVERT
4751# define FIO_MACROMAN 0x20 // convert MacRoman
4752#endif
4753#define FIO_ENDIAN_L 0x80 // little endian
4754#define FIO_ENCRYPTED 0x1000 // encrypt written bytes
4755#define FIO_NOCONVERT 0x2000 // skip encoding conversion
4756#define FIO_UCSBOM 0x4000 // check for BOM at start of file
kylo2529dac9b12022-03-27 20:05:17 +01004757#define FIO_ALL (-1) // allow all formats
Bram Moolenaar473952e2019-09-28 16:30:04 +02004758
4759// When converting, a read() or write() may leave some bytes to be converted
4760// for the next call. The value is guessed...
4761#define CONV_RESTLEN 30
4762
4763// We have to guess how much a sequence of bytes may expand when converting
4764// with iconv() to be able to allocate a buffer.
4765#define ICONV_MULT 8
Bram Moolenaarf4e20992020-12-21 19:59:08 +01004766
Bram Moolenaard93a7fc2021-01-04 12:42:13 +01004767// Used for "magic_overruled".
Bram Moolenaarf4e20992020-12-21 19:59:08 +01004768typedef enum {
Bram Moolenaard93a7fc2021-01-04 12:42:13 +01004769 OPTION_MAGIC_NOT_SET, // p_magic not overruled
4770 OPTION_MAGIC_ON, // magic on inside regexp
4771 OPTION_MAGIC_OFF // magic off inside regexp
4772} optmagic_T;
4773
4774// Magicness of a pattern, used by regexp code.
4775// The order and values matter:
4776// magic <= MAGIC_OFF includes MAGIC_NONE
4777// magic >= MAGIC_ON includes MAGIC_ALL
4778typedef enum {
4779 MAGIC_NONE = 1, // "\V" very unmagic
4780 MAGIC_OFF = 2, // "\M" or 'magic' off
4781 MAGIC_ON = 3, // "\m" or 'magic'
4782 MAGIC_ALL = 4 // "\v" very magic
Bram Moolenaarf4e20992020-12-21 19:59:08 +01004783} magic_T;
Bram Moolenaarf785aa12021-02-11 21:19:34 +01004784
LemonBoyc5d27442023-08-19 13:02:35 +02004785typedef enum {
4786 WT_UNKNOWN = 0, // Unknown or unspecified location
4787 WT_ARGUMENT,
4788 WT_VARIABLE,
4789 WT_MEMBER,
4790 WT_METHOD,
4791} wherekind_T;
4792
Bram Moolenaarf785aa12021-02-11 21:19:34 +01004793// Struct used to pass to error messages about where the error happened.
4794typedef struct {
LemonBoyc5d27442023-08-19 13:02:35 +02004795 char *wt_func_name; // function name or NULL
4796 char wt_index; // argument or variable index, 0 means unknown
4797 wherekind_T wt_kind; // "variable" when TRUE, "argument" otherwise
Bram Moolenaarf785aa12021-02-11 21:19:34 +01004798} where_T;
4799
LemonBoyc5d27442023-08-19 13:02:35 +02004800#define WHERE_INIT {NULL, 0, WT_UNKNOWN}
Bram Moolenaar7a3fe3e2021-07-22 14:58:47 +02004801
Bram Moolenaar3075a452021-11-17 15:51:52 +00004802// Struct passed to get_v_event() and restore_v_event().
4803typedef struct {
4804 int sve_did_save;
4805 hashtab_T sve_hashtab;
4806} save_v_event_T;
Yegappan Lakshmananf973eeb2021-12-22 18:19:26 +00004807
4808// Enum used by filter(), map() and mapnew()
4809typedef enum {
4810 FILTERMAP_FILTER,
4811 FILTERMAP_MAP,
4812 FILTERMAP_MAPNEW
4813} filtermap_T;
4814
Bram Moolenaar18f47402022-01-06 13:24:51 +00004815// Structure used by switch_win() to pass values to restore_win()
4816typedef struct {
4817 win_T *sw_curwin;
4818 tabpage_T *sw_curtab;
4819 int sw_same_win; // VIsual_active was not reset
4820 int sw_visual_active;
4821} switchwin_T;
Yegappan Lakshmanan38b85cb2022-02-24 13:28:41 +00004822
4823// Fuzzy matched string list item. Used for fuzzy match completion. Items are
4824// usually sorted by 'score'. The 'idx' member is used for stable-sort.
4825typedef struct {
4826 int idx;
4827 char_u *str;
4828 int score;
4829} fuzmatch_str_T;
Bram Moolenaar7f9969c2022-07-25 18:13:54 +01004830
4831// Argument for lbr_chartabsize().
4832typedef struct {
4833 win_T *cts_win;
zeertzjqb557f482023-08-22 22:07:34 +02004834 char_u *cts_line; // start of the line
4835 char_u *cts_ptr; // current position in line
Bram Moolenaar7f9969c2022-07-25 18:13:54 +01004836#ifdef FEAT_PROP_POPUP
Bram Moolenaar34a1f772022-07-26 11:20:48 +01004837 int cts_text_prop_count; // number of text props; when zero
4838 // cts_text_props is not used
4839 textprop_T *cts_text_props; // text props (allocated)
zeertzjqb557f482023-08-22 22:07:34 +02004840 char cts_has_prop_with_text; // TRUE if a property inserts text
4841 int cts_cur_text_width; // width of current inserted text
Bram Moolenaar55a27d82023-02-12 18:03:57 +00004842 int cts_prop_lines; // nr of properties above or below
Bram Moolenaar856c5d22022-10-13 21:54:28 +01004843 int cts_first_char; // width text props above the line
Bram Moolenaarb7963df2022-07-31 17:12:43 +01004844 int cts_with_trailing; // include size of trailing props with
4845 // last character
Bram Moolenaar28c9f892022-08-14 13:28:55 +01004846 int cts_start_incl; // prop has true "start_incl" arg
Bram Moolenaar7f9969c2022-07-25 18:13:54 +01004847#endif
zeertzjqb557f482023-08-22 22:07:34 +02004848 int cts_vcol; // virtual column at current position
4849 int cts_max_head_vcol; // see win_lbr_chartabsize()
Bram Moolenaar7f9969c2022-07-25 18:13:54 +01004850} chartabsize_T;
Yegappan Lakshmananaf936912023-02-20 12:16:39 +00004851
4852/*
4853 * Argument for the callback function (opt_did_set_cb_T) invoked after an
4854 * option value is modified.
4855 */
4856typedef struct
4857{
Yegappan Lakshmananc727b192023-03-03 12:26:15 +00004858 // Pointer to the option variable. The variable can be a long (numeric
4859 // option), an int (boolean option) or a char pointer (string option).
4860 char_u *os_varp;
4861 int os_idx;
Yegappan Lakshmananaf936912023-02-20 12:16:39 +00004862 int os_flags;
Yegappan Lakshmananaf936912023-02-20 12:16:39 +00004863
4864 // old value of the option (can be a string, number or a boolean)
4865 union
4866 {
4867 long number;
4868 int boolean;
4869 char_u *string;
4870 } os_oldval;
4871
4872 // new value of the option (can be a string, number or a boolean)
4873 union
4874 {
4875 long number;
4876 int boolean;
4877 char_u *string;
4878 } os_newval;
4879
4880 // When set by the called function: Stop processing the option further.
4881 // Currently only used for boolean options.
4882 int os_doskip;
Yegappan Lakshmanan6d611de2023-02-25 11:59:33 +00004883
Yegappan Lakshmanan5da901b2023-02-27 12:47:47 +00004884 // Option value was checked to be safe, no need to set P_INSECURE
4885 // Used for the 'keymap', 'filetype' and 'syntax' options.
4886 int os_value_checked;
4887 // Option value changed. Used for the 'filetype' and 'syntax' options.
4888 int os_value_changed;
4889
4890 // Used by the 'isident', 'iskeyword', 'isprint' and 'isfname' options.
4891 // Set to TRUE if the character table is modified when processing the
4892 // option and need to be restored because of a failure.
4893 int os_restore_chartab;
4894
Yegappan Lakshmananc727b192023-03-03 12:26:15 +00004895#if defined(FEAT_VTP) && defined(FEAT_TERMGUICOLORS)
4896 // Used by the 't_xxx' terminal options on MS-Windows.
4897 int os_did_swaptcap;
4898#endif
4899
Yegappan Lakshmanan6d611de2023-02-25 11:59:33 +00004900 // If the value specified for an option is not valid and the error message
4901 // is parameterized, then the "os_errbuf" buffer is used to store the error
4902 // message (when it is not NULL).
4903 char *os_errbuf;
Yegappan Lakshmananaf936912023-02-20 12:16:39 +00004904} optset_T;
Luuk van Baal30805a12023-05-27 22:22:10 +01004905
4906/*
4907 * Spell checking variables passed from win_update() to win_line().
4908 */
4909typedef struct {
4910 int spv_has_spell; // drawn window has spell checking
4911#ifdef FEAT_SPELL
4912 int spv_unchanged; // not updating for changed text
4913 int spv_checked_col; // column in "checked_lnum" up to
4914 // which there are no spell errors
4915 linenr_T spv_checked_lnum; // line number for "checked_col"
4916 int spv_cap_col; // column to check for Cap word
4917 linenr_T spv_capcol_lnum; // line number for "cap_col"
4918#endif
4919} spellvars_T;