blob: 3a9bbd33c6057c2f23af99905bfd62d69ddfd8d3 [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 {
86 scid_T sc_sid; // script ID
Bram Moolenaarded5f1b2018-11-10 17:33:29 +010087 int sc_seq; // sourcing sequence number
Bram Moolenaarf29c1c62018-09-10 21:05:02 +020088 linenr_T sc_lnum; // line number
Bram Moolenaar558ca4a2019-04-04 18:15:38 +020089 int sc_version; // :scriptversion
Bram Moolenaarf29c1c62018-09-10 21:05:02 +020090} sctx_T;
91
92/*
Bram Moolenaar45e5fd12017-06-04 14:58:02 +020093 * Reference to a buffer that stores the value of buf_free_count.
Bram Moolenaarb25f9a92016-07-10 18:21:50 +020094 * bufref_valid() only needs to check "buf" when the count differs.
95 */
96typedef struct {
97 buf_T *br_buf;
Bram Moolenaar45e5fd12017-06-04 14:58:02 +020098 int br_fnum;
Bram Moolenaarb25f9a92016-07-10 18:21:50 +020099 int br_buf_free_count;
100} bufref_T;
101
Bram Moolenaarfbc0d2e2013-05-19 19:40:29 +0200102/*
103 * This is here because regexp.h needs pos_T and below regprog_T is used.
104 */
105#include "regexp.h"
Bram Moolenaar071d4272004-06-13 20:20:40 +0000106
107/*
108 * This is here because gui.h needs the pos_T and win_T, and win_T needs gui.h
109 * for scrollbar_T.
110 */
111#ifdef FEAT_GUI
112# include "gui.h"
113#else
114# ifdef FEAT_XCLIPBOARD
115# include <X11/Intrinsic.h>
116# endif
Bram Moolenaar1b58cdd2016-08-22 23:04:33 +0200117# define guicolor_T long
Bram Moolenaar8a633e32016-04-21 21:10:14 +0200118# define INVALCOLOR ((guicolor_T)0x1ffffff)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200119 // only used for cterm.bg_rgb and cterm.fg_rgb: use cterm color
Bram Moolenaard4fc5772018-02-27 14:39:03 +0100120# define CTERMCOLOR ((guicolor_T)0x1fffffe)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000121#endif
Bram Moolenaard4fc5772018-02-27 14:39:03 +0100122#define COLOR_INVALID(x) ((x) == INVALCOLOR || (x) == CTERMCOLOR)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000123
124/*
125 * marks: positions in a file
126 * (a normal mark is a lnum/col pair, the same as a file position)
127 */
128
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200129// (Note: for EBCDIC there are more than 26, because there are gaps in the
130// alphabet coding. To minimize changes to the code, I decided to just
131// increase the number of possible marks.
132#define NMARKS ('z' - 'a' + 1) // max. # of named marks
Bram Moolenaar1e78e692019-07-22 20:18:27 +0200133#define EXTRA_MARKS 10 // marks 0-9
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200134#define JUMPLISTSIZE 100 // max. # of marks in jump list
135#define TAGSTACKSIZE 20 // max. # of tags in tag stack
Bram Moolenaar071d4272004-06-13 20:20:40 +0000136
137typedef struct filemark
138{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200139 pos_T mark; // cursor position
140 int fnum; // file number
Bram Moolenaar071d4272004-06-13 20:20:40 +0000141} fmark_T;
142
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200143// Xtended file mark: also has a file name
Bram Moolenaar071d4272004-06-13 20:20:40 +0000144typedef struct xfilemark
145{
146 fmark_T fmark;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200147 char_u *fname; // file name, used when fnum == 0
Bram Moolenaar2d358992016-06-12 21:20:54 +0200148#ifdef FEAT_VIMINFO
Bram Moolenaarf4fba6d2016-06-26 16:44:24 +0200149 time_T time_set;
Bram Moolenaar2d358992016-06-12 21:20:54 +0200150#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +0000151} xfmark_T;
152
153/*
154 * The taggy struct is used to store the information about a :tag command.
155 */
156typedef struct taggy
157{
Bram Moolenaar45e18cb2019-04-28 18:05:35 +0200158 char_u *tagname; // tag name
159 fmark_T fmark; // cursor position BEFORE ":tag"
160 int cur_match; // match number
161 int cur_fnum; // buffer number used for cur_match
162 char_u *user_data; // used with tagfunc
Bram Moolenaar071d4272004-06-13 20:20:40 +0000163} taggy_T;
164
165/*
166 * Structure that contains all options that are local to a window.
167 * Used twice in a window: for the current buffer and for all buffers.
168 * Also used in wininfo_T.
169 */
170typedef struct
171{
172#ifdef FEAT_ARABIC
173 int wo_arab;
Bram Moolenaar4d784b22019-05-25 19:51:39 +0200174# define w_p_arab w_onebuf_opt.wo_arab // 'arabic'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000175#endif
Bram Moolenaar597a4222014-06-25 14:39:50 +0200176#ifdef FEAT_LINEBREAK
177 int wo_bri;
Bram Moolenaar4d784b22019-05-25 19:51:39 +0200178# define w_p_bri w_onebuf_opt.wo_bri // 'breakindent'
Bram Moolenaarb8ee25a2014-09-23 15:45:08 +0200179 char_u *wo_briopt;
Bram Moolenaar4d784b22019-05-25 19:51:39 +0200180# define w_p_briopt w_onebuf_opt.wo_briopt // 'breakindentopt'
Bram Moolenaar597a4222014-06-25 14:39:50 +0200181#endif
Bram Moolenaar4d784b22019-05-25 19:51:39 +0200182 char_u *wo_wcr;
183# define w_p_wcr w_onebuf_opt.wo_wcr // 'wincolor'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000184#ifdef FEAT_DIFF
185 int wo_diff;
Bram Moolenaar4d784b22019-05-25 19:51:39 +0200186# define w_p_diff w_onebuf_opt.wo_diff // 'diff'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000187#endif
188#ifdef FEAT_FOLDING
189 long wo_fdc;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200190# define w_p_fdc w_onebuf_opt.wo_fdc // 'foldcolumn'
Bram Moolenaara87aa802013-07-03 15:47:03 +0200191 int wo_fdc_save;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200192# define w_p_fdc_save w_onebuf_opt.wo_fdc_save // 'foldenable' saved for diff mode
Bram Moolenaar071d4272004-06-13 20:20:40 +0000193 int wo_fen;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200194# define w_p_fen w_onebuf_opt.wo_fen // 'foldenable'
Bram Moolenaara87aa802013-07-03 15:47:03 +0200195 int wo_fen_save;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200196# define w_p_fen_save w_onebuf_opt.wo_fen_save // 'foldenable' saved for diff mode
Bram Moolenaar071d4272004-06-13 20:20:40 +0000197 char_u *wo_fdi;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200198# define w_p_fdi w_onebuf_opt.wo_fdi // 'foldignore'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000199 long wo_fdl;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200200# define w_p_fdl w_onebuf_opt.wo_fdl // 'foldlevel'
Bram Moolenaara87aa802013-07-03 15:47:03 +0200201 int wo_fdl_save;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200202# define w_p_fdl_save w_onebuf_opt.wo_fdl_save // 'foldlevel' state saved for diff mode
Bram Moolenaar071d4272004-06-13 20:20:40 +0000203 char_u *wo_fdm;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200204# define w_p_fdm w_onebuf_opt.wo_fdm // 'foldmethod'
Bram Moolenaara87aa802013-07-03 15:47:03 +0200205 char_u *wo_fdm_save;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200206# define w_p_fdm_save w_onebuf_opt.wo_fdm_save // 'fdm' saved for diff mode
Bram Moolenaar071d4272004-06-13 20:20:40 +0000207 long wo_fml;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200208# define w_p_fml w_onebuf_opt.wo_fml // 'foldminlines'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000209 long wo_fdn;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200210# define w_p_fdn w_onebuf_opt.wo_fdn // 'foldnestmax'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000211# ifdef FEAT_EVAL
212 char_u *wo_fde;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200213# define w_p_fde w_onebuf_opt.wo_fde // 'foldexpr'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000214 char_u *wo_fdt;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200215# define w_p_fdt w_onebuf_opt.wo_fdt // 'foldtext'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000216# endif
217 char_u *wo_fmr;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200218# define w_p_fmr w_onebuf_opt.wo_fmr // 'foldmarker'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000219#endif
220#ifdef FEAT_LINEBREAK
221 int wo_lbr;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200222# define w_p_lbr w_onebuf_opt.wo_lbr // 'linebreak'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000223#endif
224 int wo_list;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200225#define w_p_list w_onebuf_opt.wo_list // 'list'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000226 int wo_nu;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200227#define w_p_nu w_onebuf_opt.wo_nu // 'number'
Bram Moolenaar64486672010-05-16 15:46:46 +0200228 int wo_rnu;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200229#define w_p_rnu w_onebuf_opt.wo_rnu // 'relativenumber'
Bram Moolenaar592e0a22004-07-03 16:05:59 +0000230#ifdef FEAT_LINEBREAK
231 long wo_nuw;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200232# define w_p_nuw w_onebuf_opt.wo_nuw // 'numberwidth'
Bram Moolenaar592e0a22004-07-03 16:05:59 +0000233#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +0000234 int wo_wfh;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200235# define w_p_wfh w_onebuf_opt.wo_wfh // 'winfixheight'
Bram Moolenaar97b2ad32006-03-18 21:40:56 +0000236 int wo_wfw;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200237# define w_p_wfw w_onebuf_opt.wo_wfw // 'winfixwidth'
Bram Moolenaar4033c552017-09-16 20:54:51 +0200238#if defined(FEAT_QUICKFIX)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000239 int wo_pvw;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200240# define w_p_pvw w_onebuf_opt.wo_pvw // 'previewwindow'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000241#endif
242#ifdef FEAT_RIGHTLEFT
243 int wo_rl;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200244# define w_p_rl w_onebuf_opt.wo_rl // 'rightleft'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000245 char_u *wo_rlc;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200246# define w_p_rlc w_onebuf_opt.wo_rlc // 'rightleftcmd'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000247#endif
248 long wo_scr;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200249#define w_p_scr w_onebuf_opt.wo_scr // 'scroll'
Bram Moolenaarb9a02fc2006-03-12 22:08:12 +0000250#ifdef FEAT_SPELL
Bram Moolenaar217ad922005-03-20 22:37:15 +0000251 int wo_spell;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200252# define w_p_spell w_onebuf_opt.wo_spell // 'spell'
Bram Moolenaarb9a02fc2006-03-12 22:08:12 +0000253#endif
254#ifdef FEAT_SYN_HL
255 int wo_cuc;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200256# define w_p_cuc w_onebuf_opt.wo_cuc // 'cursorcolumn'
Bram Moolenaarb9a02fc2006-03-12 22:08:12 +0000257 int wo_cul;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200258# define w_p_cul w_onebuf_opt.wo_cul // 'cursorline'
Bram Moolenaar410e98a2019-09-09 22:05:49 +0200259 char_u *wo_culopt;
260# define w_p_culopt w_onebuf_opt.wo_culopt // 'cursorlineopt'
Bram Moolenaar1a384422010-07-14 19:53:30 +0200261 char_u *wo_cc;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200262# define w_p_cc w_onebuf_opt.wo_cc // 'colorcolumn'
Bram Moolenaar217ad922005-03-20 22:37:15 +0000263#endif
Bram Moolenaaree857022019-11-09 23:26:40 +0100264#ifdef FEAT_LINEBREAK
265 char_u *wo_sbr;
266#define w_p_sbr w_onebuf_opt.wo_sbr // 'showbreak'
267#endif
Bram Moolenaarb5bf5b82004-12-24 14:35:23 +0000268#ifdef FEAT_STL_OPT
269 char_u *wo_stl;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200270#define w_p_stl w_onebuf_opt.wo_stl // 'statusline'
Bram Moolenaarb5bf5b82004-12-24 14:35:23 +0000271#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +0000272 int wo_scb;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200273#define w_p_scb w_onebuf_opt.wo_scb // 'scrollbind'
274 int wo_diff_saved; // options were saved for starting diff mode
Bram Moolenaar8a3bb562018-03-04 20:14:14 +0100275#define w_p_diff_saved w_onebuf_opt.wo_diff_saved
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200276 int wo_scb_save; // 'scrollbind' saved for diff mode
Bram Moolenaar8a3bb562018-03-04 20:14:14 +0100277#define w_p_scb_save w_onebuf_opt.wo_scb_save
Bram Moolenaar071d4272004-06-13 20:20:40 +0000278 int wo_wrap;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200279#define w_p_wrap w_onebuf_opt.wo_wrap // 'wrap'
Bram Moolenaara87aa802013-07-03 15:47:03 +0200280#ifdef FEAT_DIFF
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200281 int wo_wrap_save; // 'wrap' state saved for diff mode
Bram Moolenaara87aa802013-07-03 15:47:03 +0200282# define w_p_wrap_save w_onebuf_opt.wo_wrap_save
283#endif
Bram Moolenaar860cae12010-06-05 23:22:07 +0200284#ifdef FEAT_CONCEAL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200285 char_u *wo_cocu; // 'concealcursor'
Bram Moolenaarf5963f72010-07-23 22:10:27 +0200286# define w_p_cocu w_onebuf_opt.wo_cocu
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200287 long wo_cole; // 'conceallevel'
Bram Moolenaarf5963f72010-07-23 22:10:27 +0200288# define w_p_cole w_onebuf_opt.wo_cole
Bram Moolenaar860cae12010-06-05 23:22:07 +0200289#endif
Bram Moolenaar860cae12010-06-05 23:22:07 +0200290 int wo_crb;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200291#define w_p_crb w_onebuf_opt.wo_crb // 'cursorbind'
292 int wo_crb_save; // 'cursorbind' state saved for diff mode
Bram Moolenaar8a3bb562018-03-04 20:14:14 +0100293#define w_p_crb_save w_onebuf_opt.wo_crb_save
Bram Moolenaar95ec9d62016-08-12 18:29:59 +0200294#ifdef FEAT_SIGNS
295 char_u *wo_scl;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200296# define w_p_scl w_onebuf_opt.wo_scl // 'signcolumn'
Bram Moolenaar95ec9d62016-08-12 18:29:59 +0200297#endif
Bram Moolenaare4f25e42017-07-07 11:54:15 +0200298#ifdef FEAT_TERMINAL
Bram Moolenaare1fc5152018-04-21 19:49:08 +0200299 char_u *wo_twk;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200300# define w_p_twk w_onebuf_opt.wo_twk // 'termwinkey'
Bram Moolenaare1fc5152018-04-21 19:49:08 +0200301 char_u *wo_tws;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200302# define w_p_tws w_onebuf_opt.wo_tws // 'termwinsize'
Bram Moolenaare4f25e42017-07-07 11:54:15 +0200303#endif
Bram Moolenaar5e3cb7e2006-02-27 23:58:35 +0000304
305#ifdef FEAT_EVAL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200306 sctx_T wo_script_ctx[WV_COUNT]; // SCTXs for window-local options
Bram Moolenaarf29c1c62018-09-10 21:05:02 +0200307# define w_p_script_ctx w_onebuf_opt.wo_script_ctx
Bram Moolenaar5e3cb7e2006-02-27 23:58:35 +0000308#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +0000309} winopt_T;
310
311/*
312 * Window info stored with a buffer.
313 *
314 * Two types of info are kept for a buffer which are associated with a
315 * specific window:
316 * 1. Each window can have a different line number associated with a buffer.
317 * 2. The window-local options for a buffer work in a similar way.
318 * The window-info is kept in a list at b_wininfo. It is kept in
319 * most-recently-used order.
320 */
Bram Moolenaar1d2ba7f2006-02-14 22:29:30 +0000321struct wininfo_S
Bram Moolenaar071d4272004-06-13 20:20:40 +0000322{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200323 wininfo_T *wi_next; // next entry or NULL for last entry
324 wininfo_T *wi_prev; // previous entry or NULL for first entry
325 win_T *wi_win; // pointer to window that did set wi_fpos
326 pos_T wi_fpos; // last cursor position in the file
327 int wi_optset; // TRUE when wi_opt has useful values
328 winopt_T wi_opt; // local window options
Bram Moolenaar071d4272004-06-13 20:20:40 +0000329#ifdef FEAT_FOLDING
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200330 int wi_fold_manual; // copy of w_fold_manual
331 garray_T wi_folds; // clone of w_folds
Bram Moolenaar071d4272004-06-13 20:20:40 +0000332#endif
333};
334
335/*
336 * Info used to pass info about a fold from the fold-detection code to the
337 * code that displays the foldcolumn.
338 */
339typedef struct foldinfo
340{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200341 int fi_level; // level of the fold; when this is zero the
342 // other fields are invalid
343 int fi_lnum; // line number where fold starts
344 int fi_low_level; // lowest fold level that starts in the same
345 // line
Bram Moolenaar071d4272004-06-13 20:20:40 +0000346} foldinfo_T;
347
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200348/*
349 * Structure to store info about the Visual area.
350 */
Bram Moolenaara23ccb82006-02-27 00:08:02 +0000351typedef struct
352{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200353 pos_T vi_start; // start pos of last VIsual
354 pos_T vi_end; // end position of last VIsual
355 int vi_mode; // VIsual_mode of last VIsual
356 colnr_T vi_curswant; // MAXCOL from w_curswant
Bram Moolenaara23ccb82006-02-27 00:08:02 +0000357} visualinfo_T;
358
Bram Moolenaar071d4272004-06-13 20:20:40 +0000359/*
Bram Moolenaar335437b2007-05-10 18:32:52 +0000360 * structures used for undo
Bram Moolenaar071d4272004-06-13 20:20:40 +0000361 */
362
Bram Moolenaarccae4672019-01-04 15:09:57 +0100363// One line saved for undo. After the NUL terminated text there might be text
364// properties, thus ul_len can be larger than STRLEN(ul_line) + 1.
365typedef struct {
366 char_u *ul_line; // text of the line
367 long ul_len; // length of the line including NUL, plus text
368 // properties
369} undoline_T;
370
Bram Moolenaar071d4272004-06-13 20:20:40 +0000371typedef struct u_entry u_entry_T;
372typedef struct u_header u_header_T;
373struct u_entry
374{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200375 u_entry_T *ue_next; // pointer to next entry in list
376 linenr_T ue_top; // number of line above undo block
377 linenr_T ue_bot; // number of line below undo block
378 linenr_T ue_lcount; // linecount when u_save called
379 undoline_T *ue_array; // array of lines in undo block
380 long ue_size; // number of lines in ue_array
Bram Moolenaarfecb6602007-10-01 20:54:15 +0000381#ifdef U_DEBUG
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200382 int ue_magic; // magic number to check allocation
Bram Moolenaarfecb6602007-10-01 20:54:15 +0000383#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +0000384};
385
386struct u_header
387{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200388 // The following have a pointer and a number. The number is used when
389 // reading the undo file in u_read_undo()
Bram Moolenaar83d09bb2010-06-01 19:58:08 +0200390 union {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200391 u_header_T *ptr; // pointer to next undo header in list
Bram Moolenaar83d09bb2010-06-01 19:58:08 +0200392 long seq;
393 } uh_next;
394 union {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200395 u_header_T *ptr; // pointer to previous header in list
Bram Moolenaar83d09bb2010-06-01 19:58:08 +0200396 long seq;
397 } uh_prev;
398 union {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200399 u_header_T *ptr; // pointer to next header for alt. redo
Bram Moolenaar83d09bb2010-06-01 19:58:08 +0200400 long seq;
401 } uh_alt_next;
402 union {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200403 u_header_T *ptr; // pointer to previous header for alt. redo
Bram Moolenaar83d09bb2010-06-01 19:58:08 +0200404 long seq;
405 } uh_alt_prev;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200406 long uh_seq; // sequence number, higher == newer undo
407 int uh_walk; // used by undo_time()
408 u_entry_T *uh_entry; // pointer to first entry
409 u_entry_T *uh_getbot_entry; // pointer to where ue_bot must be set
410 pos_T uh_cursor; // cursor position before saving
Bram Moolenaar071d4272004-06-13 20:20:40 +0000411 long uh_cursor_vcol;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200412 int uh_flags; // see below
413 pos_T uh_namedm[NMARKS]; // marks before undo/after redo
414 visualinfo_T uh_visual; // Visual areas before undo/after redo
415 time_T uh_time; // timestamp when the change was made
416 long uh_save_nr; // set when the file was saved after the
417 // changes in this block
Bram Moolenaarfecb6602007-10-01 20:54:15 +0000418#ifdef U_DEBUG
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200419 int uh_magic; // magic number to check allocation
Bram Moolenaarfecb6602007-10-01 20:54:15 +0000420#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +0000421};
422
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200423// values for uh_flags
424#define UH_CHANGED 0x01 // b_changed flag before undo/after redo
425#define UH_EMPTYBUF 0x02 // buffer was empty
Bram Moolenaar071d4272004-06-13 20:20:40 +0000426
427/*
Bram Moolenaar335437b2007-05-10 18:32:52 +0000428 * structures used in undo.c
Bram Moolenaar071d4272004-06-13 20:20:40 +0000429 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200430#define ALIGN_LONG // longword alignment and use filler byte
Bram Moolenaar30276f22019-01-24 17:59:39 +0100431#define ALIGN_SIZE (sizeof(long))
Bram Moolenaar071d4272004-06-13 20:20:40 +0000432
433#define ALIGN_MASK (ALIGN_SIZE - 1)
434
435typedef struct m_info minfo_T;
436
437/*
Bram Moolenaar2767c602010-05-16 13:56:06 +0200438 * structure used to link chunks in one of the free chunk lists.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000439 */
440struct m_info
441{
442#ifdef ALIGN_LONG
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200443 long_u m_size; // size of the chunk (including m_info)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000444#else
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200445 short_u m_size; // size of the chunk (including m_info)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000446#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200447 minfo_T *m_next; // pointer to next free chunk in the list
Bram Moolenaar071d4272004-06-13 20:20:40 +0000448};
449
450/*
Bram Moolenaar071d4272004-06-13 20:20:40 +0000451 * things used in memfile.c
452 */
453
454typedef struct block_hdr bhdr_T;
455typedef struct memfile memfile_T;
456typedef long blocknr_T;
457
458/*
Bram Moolenaarb05b10a2011-03-22 18:10:45 +0100459 * mf_hashtab_T is a chained hashtable with blocknr_T key and arbitrary
460 * structures as items. This is an intrusive data structure: we require
461 * that items begin with mf_hashitem_T which contains the key and linked
462 * list pointers. List of items in each bucket is doubly-linked.
463 */
464
465typedef struct mf_hashitem_S mf_hashitem_T;
466
467struct mf_hashitem_S
468{
469 mf_hashitem_T *mhi_next;
470 mf_hashitem_T *mhi_prev;
471 blocknr_T mhi_key;
472};
473
474#define MHT_INIT_SIZE 64
475
476typedef struct mf_hashtab_S
477{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200478 long_u mht_mask; // mask used for hash value (nr of items
479 // in array is "mht_mask" + 1)
480 long_u mht_count; // nr of items inserted into hashtable
481 mf_hashitem_T **mht_buckets; // points to mht_small_buckets or
482 //dynamically allocated array
483 mf_hashitem_T *mht_small_buckets[MHT_INIT_SIZE]; // initial buckets
484 char mht_fixed; // non-zero value forbids growth
Bram Moolenaarb05b10a2011-03-22 18:10:45 +0100485} mf_hashtab_T;
486
487/*
Bram Moolenaar071d4272004-06-13 20:20:40 +0000488 * for each (previously) used block in the memfile there is one block header.
489 *
490 * The block may be linked in the used list OR in the free list.
491 * The used blocks are also kept in hash lists.
492 *
493 * The used list is a doubly linked list, most recently used block first.
494 * The blocks in the used list have a block of memory allocated.
495 * mf_used_count is the number of pages in the used list.
496 * The hash lists are used to quickly find a block in the used list.
497 * The free list is a single linked list, not sorted.
498 * The blocks in the free list have no block of memory allocated and
499 * the contents of the block in the file (if any) is irrelevant.
500 */
501
502struct block_hdr
503{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200504 mf_hashitem_T bh_hashitem; // header for hash table and key
505#define bh_bnum bh_hashitem.mhi_key // block number, part of bh_hashitem
Bram Moolenaarb05b10a2011-03-22 18:10:45 +0100506
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200507 bhdr_T *bh_next; // next block_hdr in free or used list
508 bhdr_T *bh_prev; // previous block_hdr in used list
509 char_u *bh_data; // pointer to memory (for used block)
510 int bh_page_count; // number of pages in this block
Bram Moolenaar071d4272004-06-13 20:20:40 +0000511
512#define BH_DIRTY 1
513#define BH_LOCKED 2
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200514 char bh_flags; // BH_DIRTY or BH_LOCKED
Bram Moolenaar071d4272004-06-13 20:20:40 +0000515};
516
517/*
518 * when a block with a negative number is flushed to the file, it gets
519 * a positive number. Because the reference to the block is still the negative
520 * number, we remember the translation to the new positive number in the
521 * double linked trans lists. The structure is the same as the hash lists.
522 */
523typedef struct nr_trans NR_TRANS;
524
525struct nr_trans
526{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200527 mf_hashitem_T nt_hashitem; // header for hash table and key
528#define nt_old_bnum nt_hashitem.mhi_key // old, negative, number
Bram Moolenaarb05b10a2011-03-22 18:10:45 +0100529
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200530 blocknr_T nt_new_bnum; // new, positive, number
Bram Moolenaar071d4272004-06-13 20:20:40 +0000531};
532
Bram Moolenaar0a36fec2014-02-11 15:10:43 +0100533
534typedef struct buffblock buffblock_T;
535typedef struct buffheader buffheader_T;
536
Bram Moolenaar071d4272004-06-13 20:20:40 +0000537/*
538 * structure used to store one block of the stuff/redo/recording buffers
539 */
540struct buffblock
541{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200542 buffblock_T *b_next; // pointer to next buffblock
543 char_u b_str[1]; // contents (actually longer)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000544};
545
546/*
547 * header used for the stuff buffer and the redo buffer
548 */
549struct buffheader
550{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200551 buffblock_T bh_first; // first (dummy) block of list
552 buffblock_T *bh_curr; // buffblock for appending
553 int bh_index; // index for reading
554 int bh_space; // space in bh_curr for appending
Bram Moolenaar071d4272004-06-13 20:20:40 +0000555};
556
Bram Moolenaard4863aa2017-04-07 19:50:12 +0200557typedef struct
558{
559 buffheader_T sr_redobuff;
560 buffheader_T sr_old_redobuff;
561} save_redo_T;
562
Bram Moolenaar071d4272004-06-13 20:20:40 +0000563/*
564 * used for completion on the command line
565 */
566typedef struct expand
567{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200568 char_u *xp_pattern; // start of item to expand
Bram Moolenaard6beab02019-11-10 15:07:19 +0100569 int xp_context; // type of expansion
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200570 int xp_pattern_len; // bytes in xp_pattern before cursor
Bram Moolenaar0a52df52019-08-18 22:26:31 +0200571#if defined(FEAT_EVAL)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200572 char_u *xp_arg; // completion function
573 sctx_T xp_script_ctx; // SCTX for completion function
Bram Moolenaar071d4272004-06-13 20:20:40 +0000574#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200575 int xp_backslash; // one of the XP_BS_ values
Bram Moolenaar8ada17c2006-01-19 22:16:24 +0000576#ifndef BACKSLASH_IN_FILENAME
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200577 int xp_shell; // TRUE for a shell command, more
578 // characters need to be escaped
Bram Moolenaar8ada17c2006-01-19 22:16:24 +0000579#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200580 int xp_numfiles; // number of files found by
581 // file name completion
Bram Moolenaard6beab02019-11-10 15:07:19 +0100582 int xp_col; // cursor position in line
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200583 char_u **xp_files; // list of files
584 char_u *xp_line; // text being completed
Bram Moolenaar071d4272004-06-13 20:20:40 +0000585} expand_T;
586
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200587/*
588 * values for xp_backslash
589 */
590#define XP_BS_NONE 0 // nothing special for backslashes
591#define XP_BS_ONE 1 // uses one backslash before a space
592#define XP_BS_THREE 2 // uses three backslashes before a space
Bram Moolenaar071d4272004-06-13 20:20:40 +0000593
594/*
Bram Moolenaar66b51422019-08-18 21:44:12 +0200595 * Variables shared between getcmdline(), redrawcmdline() and others.
596 * These need to be saved when using CTRL-R |, that's why they are in a
597 * structure.
598 */
599typedef struct
600{
Bram Moolenaar4aea03e2019-09-25 22:37:17 +0200601 char_u *cmdbuff; // pointer to command line buffer
602 int cmdbufflen; // length of cmdbuff
603 int cmdlen; // number of chars in command line
604 int cmdpos; // current cursor position
605 int cmdspos; // cursor column on screen
606 int cmdfirstc; // ':', '/', '?', '=', '>' or NUL
607 int cmdindent; // number of spaces before cmdline
608 char_u *cmdprompt; // message in front of cmdline
609 int cmdattr; // attributes for prompt
610 int overstrike; // Typing mode on the command line. Shared by
611 // getcmdline() and put_on_cmdline().
612 expand_T *xpc; // struct being used for expansion, xp_pattern
613 // may point into cmdbuff
614 int xp_context; // type of expansion
Bram Moolenaar66b51422019-08-18 21:44:12 +0200615# ifdef FEAT_EVAL
Bram Moolenaar4aea03e2019-09-25 22:37:17 +0200616 char_u *xp_arg; // user-defined expansion arg
617 int input_fn; // when TRUE Invoked for input() function
Bram Moolenaar66b51422019-08-18 21:44:12 +0200618# endif
619} cmdline_info_T;
620
621/*
Bram Moolenaar071d4272004-06-13 20:20:40 +0000622 * Command modifiers ":vertical", ":browse", ":confirm" and ":hide" set a flag.
623 * This needs to be saved for recursive commands, put them in a structure for
624 * easy manipulation.
625 */
626typedef struct
627{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200628 int hide; // TRUE when ":hide" was used
Bram Moolenaard812df62008-11-09 12:46:09 +0000629# ifdef FEAT_BROWSE_CMD
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200630 int browse; // TRUE to invoke file dialog
Bram Moolenaar071d4272004-06-13 20:20:40 +0000631# endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200632 int split; // flags for win_split()
633 int tab; // > 0 when ":tab" was used
Bram Moolenaar071d4272004-06-13 20:20:40 +0000634# if defined(FEAT_GUI_DIALOG) || defined(FEAT_CON_DIALOG)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200635 int confirm; // TRUE to invoke yes/no dialog
Bram Moolenaar071d4272004-06-13 20:20:40 +0000636# endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200637 int keepalt; // TRUE when ":keepalt" was used
638 int keepmarks; // TRUE when ":keepmarks" was used
639 int keepjumps; // TRUE when ":keepjumps" was used
640 int lockmarks; // TRUE when ":lockmarks" was used
641 int keeppatterns; // TRUE when ":keeppatterns" was used
642 int noswapfile; // TRUE when ":noswapfile" was used
643 char_u *save_ei; // saved value of 'eventignore'
644 regmatch_T filter_regmatch; // set by :filter /pat/
645 int filter_force; // set for :filter!
Bram Moolenaar071d4272004-06-13 20:20:40 +0000646} cmdmod_T;
647
Bram Moolenaara8ffcbb2010-06-21 06:15:46 +0200648#define MF_SEED_LEN 8
Bram Moolenaar071d4272004-06-13 20:20:40 +0000649
650struct memfile
651{
Bram Moolenaarb58a4b92019-05-27 23:36:21 +0200652 char_u *mf_fname; // name of the file
653 char_u *mf_ffname; // idem, full path
654 int mf_fd; // file descriptor
655 int mf_flags; // flags used when opening this memfile
656 int mf_reopen; // mf_fd was closed, retry opening
657 bhdr_T *mf_free_first; // first block_hdr in free list
658 bhdr_T *mf_used_first; // mru block_hdr in used list
659 bhdr_T *mf_used_last; // lru block_hdr in used list
660 unsigned mf_used_count; // number of pages in used list
661 unsigned mf_used_count_max; // maximum number of pages in memory
662 mf_hashtab_T mf_hash; // hash lists
663 mf_hashtab_T mf_trans; // trans lists
664 blocknr_T mf_blocknr_max; // highest positive block number + 1
665 blocknr_T mf_blocknr_min; // lowest negative block number - 1
666 blocknr_T mf_neg_count; // number of negative blocks numbers
667 blocknr_T mf_infile_count; // number of pages in the file
668 unsigned mf_page_size; // number of bytes in a page
669 int mf_dirty; // TRUE if there are dirty blocks
Bram Moolenaara8ffcbb2010-06-21 06:15:46 +0200670#ifdef FEAT_CRYPT
Bram Moolenaarb58a4b92019-05-27 23:36:21 +0200671 buf_T *mf_buffer; // buffer this memfile is for
672 char_u mf_seed[MF_SEED_LEN]; // seed for encryption
Bram Moolenaara8ffcbb2010-06-21 06:15:46 +0200673
Bram Moolenaarb58a4b92019-05-27 23:36:21 +0200674 // Values for key, method and seed used for reading data blocks when
675 // updating for a newly set key or method. Only when mf_old_key != NULL.
Bram Moolenaara8ffcbb2010-06-21 06:15:46 +0200676 char_u *mf_old_key;
677 int mf_old_cm;
678 char_u mf_old_seed[MF_SEED_LEN];
679#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +0000680};
681
682/*
683 * things used in memline.c
684 */
685/*
686 * When searching for a specific line, we remember what blocks in the tree
687 * are the branches leading to that block. This is stored in ml_stack. Each
688 * entry is a pointer to info in a block (may be data block or pointer block)
689 */
690typedef struct info_pointer
691{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200692 blocknr_T ip_bnum; // block number
693 linenr_T ip_low; // lowest lnum in this block
694 linenr_T ip_high; // highest lnum in this block
695 int ip_index; // index for block with current lnum
696} infoptr_T; // block/index pair
Bram Moolenaar071d4272004-06-13 20:20:40 +0000697
698#ifdef FEAT_BYTEOFF
699typedef struct ml_chunksize
700{
701 int mlcs_numlines;
702 long mlcs_totalsize;
703} chunksize_T;
704
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200705/*
706 * Flags when calling ml_updatechunk()
707 */
708# define ML_CHNK_ADDLINE 1
709# define ML_CHNK_DELLINE 2
710# define ML_CHNK_UPDLINE 3
Bram Moolenaar071d4272004-06-13 20:20:40 +0000711#endif
712
713/*
714 * the memline structure holds all the information about a memline
715 */
716typedef struct memline
717{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200718 linenr_T ml_line_count; // number of lines in the buffer
Bram Moolenaar071d4272004-06-13 20:20:40 +0000719
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200720 memfile_T *ml_mfp; // pointer to associated memfile
Bram Moolenaar071d4272004-06-13 20:20:40 +0000721
Bram Moolenaard6beab02019-11-10 15:07:19 +0100722 infoptr_T *ml_stack; // stack of pointer blocks (array of IPTRs)
723 int ml_stack_top; // current top of ml_stack
724 int ml_stack_size; // total number of entries in ml_stack
725
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200726#define ML_EMPTY 1 // empty buffer
727#define ML_LINE_DIRTY 2 // cached line was changed and allocated
728#define ML_LOCKED_DIRTY 4 // ml_locked was changed
729#define ML_LOCKED_POS 8 // ml_locked needs positive block number
Bram Moolenaar071d4272004-06-13 20:20:40 +0000730 int ml_flags;
731
Bram Moolenaard6beab02019-11-10 15:07:19 +0100732 colnr_T ml_line_len; // length of the cached line, including NUL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200733 linenr_T ml_line_lnum; // line number of cached line, 0 if not valid
734 char_u *ml_line_ptr; // pointer to cached line
Bram Moolenaar071d4272004-06-13 20:20:40 +0000735
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200736 bhdr_T *ml_locked; // block used by last ml_get
737 linenr_T ml_locked_low; // first line in ml_locked
738 linenr_T ml_locked_high; // last line in ml_locked
739 int ml_locked_lineadd; // number of lines inserted in ml_locked
Bram Moolenaar071d4272004-06-13 20:20:40 +0000740#ifdef FEAT_BYTEOFF
741 chunksize_T *ml_chunksize;
742 int ml_numchunks;
743 int ml_usedchunks;
744#endif
745} memline_T;
746
Bram Moolenaara9d4b842020-05-30 14:46:52 +0200747// Values for the flags argument of ml_delete_flags().
748#define ML_DEL_MESSAGE 1 // may give a "No lines in buffer" message
749#define ML_DEL_UNDO 2 // called from undo, do not update textprops
750
751// Values for the flags argument of ml_append_int().
752#define ML_APPEND_NEW 1 // starting to edit a new file
753#define ML_APPEND_MARK 2 // mark the new line
754#define ML_APPEND_UNDO 4 // called from undo
755
Bram Moolenaar98aefe72018-12-13 22:20:09 +0100756
757/*
758 * Structure defining text properties. These stick with the text.
759 * When stored in memline they are after the text, ml_line_len is larger than
760 * STRLEN(ml_line_ptr) + 1.
761 */
762typedef struct textprop_S
763{
Bram Moolenaarb9c67a52019-01-01 19:49:20 +0100764 colnr_T tp_col; // start column (one based, in bytes)
Bram Moolenaar98aefe72018-12-13 22:20:09 +0100765 colnr_T tp_len; // length in bytes
766 int tp_id; // identifier
767 int tp_type; // property type
768 int tp_flags; // TP_FLAG_ values
769} textprop_T;
770
771#define TP_FLAG_CONT_NEXT 1 // property continues in next line
772#define TP_FLAG_CONT_PREV 2 // property was continued from prev line
773
774/*
775 * Structure defining a property type.
776 */
777typedef struct proptype_S
778{
779 int pt_id; // value used for tp_id
780 int pt_type; // number used for tp_type
781 int pt_hl_id; // highlighting
782 int pt_priority; // priority
783 int pt_flags; // PT_FLAG_ values
784 char_u pt_name[1]; // property type name, actually longer
785} proptype_T;
786
787#define PT_FLAG_INS_START_INCL 1 // insert at start included in property
788#define PT_FLAG_INS_END_INCL 2 // insert at end included in property
Bram Moolenaarde24a872019-05-05 15:48:00 +0200789#define PT_FLAG_COMBINE 4 // combine with syntax highlight
Bram Moolenaar98aefe72018-12-13 22:20:09 +0100790
Bram Moolenaar7a2d9892018-12-24 20:23:49 +0100791// Sign group
792typedef struct signgroup_S
793{
Bram Moolenaar6656c2e2019-10-24 15:00:04 +0200794 int sg_next_sign_id; // next sign id for this group
795 short_u sg_refcount; // number of signs in this group
Bram Moolenaar47ed5532019-08-08 20:49:14 +0200796 char_u sg_name[1]; // sign group name, actually longer
Bram Moolenaar7a2d9892018-12-24 20:23:49 +0100797} signgroup_T;
798
Bram Moolenaar6656c2e2019-10-24 15:00:04 +0200799typedef struct sign_entry sign_entry_T;
800struct sign_entry
Bram Moolenaar071d4272004-06-13 20:20:40 +0000801{
Bram Moolenaar6656c2e2019-10-24 15:00:04 +0200802 int se_id; // unique identifier for each placed sign
Bram Moolenaar6656c2e2019-10-24 15:00:04 +0200803 int se_typenr; // typenr of sign
Bram Moolenaar6656c2e2019-10-24 15:00:04 +0200804 int se_priority; // priority for highlighting
Bram Moolenaard6beab02019-11-10 15:07:19 +0100805 linenr_T se_lnum; // line number which has this sign
806 signgroup_T *se_group; // sign group
Bram Moolenaar6656c2e2019-10-24 15:00:04 +0200807 sign_entry_T *se_next; // next entry in a list of signs
808 sign_entry_T *se_prev; // previous entry -- for easy reordering
Bram Moolenaar071d4272004-06-13 20:20:40 +0000809};
810
Bram Moolenaar4e038572019-07-04 18:28:35 +0200811/*
812 * Sign attributes. Used by the screen refresh routines.
813 */
814typedef struct sign_attrs_S {
Bram Moolenaar6656c2e2019-10-24 15:00:04 +0200815 int sat_typenr;
816 void *sat_icon;
817 char_u *sat_text;
818 int sat_texthl;
819 int sat_linehl;
Bram Moolenaar4e038572019-07-04 18:28:35 +0200820} sign_attrs_T;
821
Bram Moolenaarced198d2018-12-29 20:04:40 +0100822#if defined(FEAT_SIGNS) || defined(PROTO)
823// Macros to get the sign group structure from the group name
824#define SGN_KEY_OFF offsetof(signgroup_T, sg_name)
825#define HI2SG(hi) ((signgroup_T *)((hi)->hi_key - SGN_KEY_OFF))
826
Bram Moolenaar162b7142018-12-21 15:17:36 +0100827// Default sign priority for highlighting
828#define SIGN_DEF_PRIO 10
829
Bram Moolenaar071d4272004-06-13 20:20:40 +0000830#endif
831
832/*
833 * Argument list: Array of file names.
834 * Used for the global argument list and the argument lists local to a window.
835 */
836typedef struct arglist
837{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200838 garray_T al_ga; // growarray with the array of file names
839 int al_refcount; // number of windows using this arglist
840 int id; // id of this arglist
Bram Moolenaar071d4272004-06-13 20:20:40 +0000841} alist_T;
842
843/*
844 * For each argument remember the file name as it was given, and the buffer
845 * number that contains the expanded file name (required for when ":cd" is
Bram Moolenaard6beab02019-11-10 15:07:19 +0100846 * used).
Bram Moolenaar071d4272004-06-13 20:20:40 +0000847 */
848typedef struct argentry
849{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200850 char_u *ae_fname; // file name as specified
851 int ae_fnum; // buffer number with expanded file name
Bram Moolenaar071d4272004-06-13 20:20:40 +0000852} aentry_T;
853
Bram Moolenaar4033c552017-09-16 20:54:51 +0200854#define ALIST(win) (win)->w_alist
Bram Moolenaar071d4272004-06-13 20:20:40 +0000855#define GARGLIST ((aentry_T *)global_alist.al_ga.ga_data)
856#define ARGLIST ((aentry_T *)ALIST(curwin)->al_ga.ga_data)
857#define WARGLIST(wp) ((aentry_T *)ALIST(wp)->al_ga.ga_data)
858#define AARGLIST(al) ((aentry_T *)((al)->al_ga.ga_data))
859#define GARGCOUNT (global_alist.al_ga.ga_len)
860#define ARGCOUNT (ALIST(curwin)->al_ga.ga_len)
861#define WARGCOUNT(wp) (ALIST(wp)->al_ga.ga_len)
862
863/*
864 * A list used for saving values of "emsg_silent". Used by ex_try() to save the
865 * value of "emsg_silent" if it was non-zero. When this is done, the CSF_SILENT
866 * flag below is set.
867 */
868
869typedef struct eslist_elem eslist_T;
870struct eslist_elem
871{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200872 int saved_emsg_silent; // saved value of "emsg_silent"
873 eslist_T *next; // next element on the list
Bram Moolenaar071d4272004-06-13 20:20:40 +0000874};
875
876/*
877 * For conditional commands a stack is kept of nested conditionals.
878 * When cs_idx < 0, there is no conditional command.
879 */
880#define CSTACK_LEN 50
881
Bram Moolenaarddef1292019-12-16 17:10:33 +0100882typedef struct {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200883 short cs_flags[CSTACK_LEN]; // CSF_ flags
884 char cs_pending[CSTACK_LEN]; // CSTP_: what's pending in ":finally"
Bram Moolenaar071d4272004-06-13 20:20:40 +0000885 union {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200886 void *csp_rv[CSTACK_LEN]; // return typeval for pending return
887 void *csp_ex[CSTACK_LEN]; // exception for pending throw
Bram Moolenaar071d4272004-06-13 20:20:40 +0000888 } cs_pend;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200889 void *cs_forinfo[CSTACK_LEN]; // info used by ":for"
890 int cs_line[CSTACK_LEN]; // line nr of ":while"/":for" line
891 int cs_idx; // current entry, or -1 if none
892 int cs_looplevel; // nr of nested ":while"s and ":for"s
893 int cs_trylevel; // nr of nested ":try"s
894 eslist_T *cs_emsg_silent_list; // saved values of "emsg_silent"
895 char cs_lflags; // loop flags: CSL_ flags
Bram Moolenaarddef1292019-12-16 17:10:33 +0100896} cstack_T;
Bram Moolenaar12805862005-01-05 22:16:17 +0000897# define cs_rettv cs_pend.csp_rv
898# define cs_exception cs_pend.csp_ex
Bram Moolenaar071d4272004-06-13 20:20:40 +0000899
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200900// There is no CSF_IF, the lack of CSF_WHILE, CSF_FOR and CSF_TRY means ":if"
901// was used.
902# define CSF_TRUE 0x0001 // condition was TRUE
903# define CSF_ACTIVE 0x0002 // current state is active
904# define CSF_ELSE 0x0004 // ":else" has been passed
905# define CSF_WHILE 0x0008 // is a ":while"
906# define CSF_FOR 0x0010 // is a ":for"
Bram Moolenaar12805862005-01-05 22:16:17 +0000907
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200908# define CSF_TRY 0x0100 // is a ":try"
909# define CSF_FINALLY 0x0200 // ":finally" has been passed
910# define CSF_THROWN 0x0400 // exception thrown to this try conditional
911# define CSF_CAUGHT 0x0800 // exception caught by this try conditional
912# define CSF_SILENT 0x1000 // "emsg_silent" reset by ":try"
913// Note that CSF_ELSE is only used when CSF_TRY and CSF_WHILE are unset
914// (an ":if"), and CSF_SILENT is only used when CSF_TRY is set.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000915
916/*
917 * What's pending for being reactivated at the ":endtry" of this try
918 * conditional:
919 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200920# define CSTP_NONE 0 // nothing pending in ":finally" clause
921# define CSTP_ERROR 1 // an error is pending
922# define CSTP_INTERRUPT 2 // an interrupt is pending
923# define CSTP_THROW 4 // a throw is pending
924# define CSTP_BREAK 8 // ":break" is pending
925# define CSTP_CONTINUE 16 // ":continue" is pending
926# define CSTP_RETURN 24 // ":return" is pending
927# define CSTP_FINISH 32 // ":finish" is pending
Bram Moolenaar071d4272004-06-13 20:20:40 +0000928
929/*
Bram Moolenaarddef1292019-12-16 17:10:33 +0100930 * Flags for the cs_lflags item in cstack_T.
Bram Moolenaar12805862005-01-05 22:16:17 +0000931 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200932# define CSL_HAD_LOOP 1 // just found ":while" or ":for"
933# define CSL_HAD_ENDLOOP 2 // just found ":endwhile" or ":endfor"
934# define CSL_HAD_CONT 4 // just found ":continue"
935# define CSL_HAD_FINA 8 // just found ":finally"
Bram Moolenaar12805862005-01-05 22:16:17 +0000936
937/*
Bram Moolenaar071d4272004-06-13 20:20:40 +0000938 * A list of error messages that can be converted to an exception. "throw_msg"
939 * is only set in the first element of the list. Usually, it points to the
940 * original message stored in that element, but sometimes it points to a later
Bram Moolenaar25e0f582020-05-25 22:36:50 +0200941 * message in the list. See cause_errthrow().
Bram Moolenaar071d4272004-06-13 20:20:40 +0000942 */
Bram Moolenaar25e0f582020-05-25 22:36:50 +0200943typedef struct msglist msglist_T;
Bram Moolenaar071d4272004-06-13 20:20:40 +0000944struct msglist
945{
Bram Moolenaar25e0f582020-05-25 22:36:50 +0200946 char *msg; // original message, allocated
947 char *throw_msg; // msg to throw: usually original one
948 char_u *sfile; // value from estack_sfile(), allocated
949 long slnum; // line number for "sfile"
950 msglist_T *next; // next of several messages in a row
Bram Moolenaar071d4272004-06-13 20:20:40 +0000951};
952
953/*
Bram Moolenaar8a5883b2016-11-10 20:20:05 +0100954 * The exception types.
955 */
956typedef enum
957{
Bram Moolenaarea3ece42018-04-17 20:14:39 +0200958 ET_USER, // exception caused by ":throw" command
959 ET_ERROR, // error exception
960 ET_INTERRUPT, // interrupt exception triggered by Ctrl-C
Bram Moolenaar8a5883b2016-11-10 20:20:05 +0100961} except_type_T;
962
963/*
Bram Moolenaar071d4272004-06-13 20:20:40 +0000964 * Structure describing an exception.
965 * (don't use "struct exception", it's used by the math library).
966 */
967typedef struct vim_exception except_T;
968struct vim_exception
969{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200970 except_type_T type; // exception type
971 char *value; // exception value
972 struct msglist *messages; // message(s) causing error exception
973 char_u *throw_name; // name of the throw point
974 linenr_T throw_lnum; // line number of the throw point
975 except_T *caught; // next exception on the caught stack
Bram Moolenaar071d4272004-06-13 20:20:40 +0000976};
977
978/*
Bram Moolenaarc0197e22004-09-13 20:26:32 +0000979 * Structure to save the error/interrupt/exception state between calls to
980 * enter_cleanup() and leave_cleanup(). Must be allocated as an automatic
981 * variable by the (common) caller of these functions.
982 */
983typedef struct cleanup_stuff cleanup_T;
984struct cleanup_stuff
985{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200986 int pending; // error/interrupt/exception state
987 except_T *exception; // exception value
Bram Moolenaarc0197e22004-09-13 20:26:32 +0000988};
Bram Moolenaar071d4272004-06-13 20:20:40 +0000989
990#ifdef FEAT_SYN_HL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200991// struct passed to in_id_list()
Bram Moolenaar071d4272004-06-13 20:20:40 +0000992struct sp_syn
993{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +0200994 int inc_tag; // ":syn include" unique tag
995 short id; // highlight group ID of item
996 short *cont_in_list; // cont.in group IDs, if non-zero
Bram Moolenaar071d4272004-06-13 20:20:40 +0000997};
998
999/*
1000 * Each keyword has one keyentry, which is linked in a hash list.
1001 */
1002typedef struct keyentry keyentry_T;
1003
1004struct keyentry
1005{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001006 keyentry_T *ke_next; // next entry with identical "keyword[]"
1007 struct sp_syn k_syn; // struct passed to in_id_list()
1008 short *next_list; // ID list for next match (if non-zero)
Bram Moolenaar860cae12010-06-05 23:22:07 +02001009 int flags;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001010 int k_char; // conceal substitute character
1011 char_u keyword[1]; // actually longer
Bram Moolenaar071d4272004-06-13 20:20:40 +00001012};
1013
1014/*
1015 * Struct used to store one state of the state stack.
1016 */
1017typedef struct buf_state
1018{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001019 int bs_idx; // index of pattern
1020 int bs_flags; // flags for pattern
Bram Moolenaar6e202e52010-07-28 18:14:45 +02001021#ifdef FEAT_CONCEAL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001022 int bs_seqnr; // stores si_seqnr
1023 int bs_cchar; // stores si_cchar
Bram Moolenaar6e202e52010-07-28 18:14:45 +02001024#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001025 reg_extmatch_T *bs_extmatch; // external matches from start pattern
Bram Moolenaar071d4272004-06-13 20:20:40 +00001026} bufstate_T;
1027
1028/*
1029 * syn_state contains the syntax state stack for the start of one line.
1030 * Used by b_sst_array[].
1031 */
1032typedef struct syn_state synstate_T;
1033
1034struct syn_state
1035{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001036 synstate_T *sst_next; // next entry in used or free list
1037 linenr_T sst_lnum; // line number for this state
Bram Moolenaar071d4272004-06-13 20:20:40 +00001038 union
1039 {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001040 bufstate_T sst_stack[SST_FIX_STATES]; // short state stack
1041 garray_T sst_ga; // growarray for long state stack
Bram Moolenaar071d4272004-06-13 20:20:40 +00001042 } sst_union;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001043 int sst_next_flags; // flags for sst_next_list
1044 int sst_stacksize; // number of states on the stack
1045 short *sst_next_list; // "nextgroup" list in this state
1046 // (this is a copy, don't free it!
1047 disptick_T sst_tick; // tick when last displayed
1048 linenr_T sst_change_lnum;// when non-zero, change in this line
1049 // may have made the state invalid
Bram Moolenaar071d4272004-06-13 20:20:40 +00001050};
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001051#endif // FEAT_SYN_HL
Bram Moolenaar071d4272004-06-13 20:20:40 +00001052
Bram Moolenaarf9cc9f22019-07-14 21:29:22 +02001053#define MAX_HL_ID 20000 // maximum value for a highlight ID.
1054
1055/*
Bram Moolenaar071d4272004-06-13 20:20:40 +00001056 * Structure shared between syntax.c, screen.c and gui_x11.c.
1057 */
1058typedef struct attr_entry
1059{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001060 short ae_attr; // HL_BOLD, etc.
Bram Moolenaar071d4272004-06-13 20:20:40 +00001061 union
1062 {
1063 struct
1064 {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001065 char_u *start; // start escape sequence
1066 char_u *stop; // stop escape sequence
Bram Moolenaar071d4272004-06-13 20:20:40 +00001067 } term;
1068 struct
1069 {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001070 // These colors need to be > 8 bits to hold 256.
1071 short_u fg_color; // foreground color number
1072 short_u bg_color; // background color number
Bram Moolenaare023e882020-05-31 16:42:30 +02001073 short_u ul_color; // underline color number
Bram Moolenaar61be73b2016-04-29 22:59:22 +02001074# ifdef FEAT_TERMGUICOLORS
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001075 guicolor_T fg_rgb; // foreground color RGB
1076 guicolor_T bg_rgb; // background color RGB
Bram Moolenaare023e882020-05-31 16:42:30 +02001077 guicolor_T ul_rgb; // underline color RGB
Bram Moolenaar8a633e32016-04-21 21:10:14 +02001078# endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00001079 } cterm;
1080# ifdef FEAT_GUI
1081 struct
1082 {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001083 guicolor_T fg_color; // foreground color handle
1084 guicolor_T bg_color; // background color handle
1085 guicolor_T sp_color; // special color handle
1086 GuiFont font; // font handle
Bram Moolenaar071d4272004-06-13 20:20:40 +00001087# ifdef FEAT_XFONTSET
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001088 GuiFontset fontset; // fontset handle
Bram Moolenaar071d4272004-06-13 20:20:40 +00001089# endif
1090 } gui;
1091# endif
1092 } ae_u;
1093} attrentry_T;
1094
1095#ifdef USE_ICONV
1096# ifdef HAVE_ICONV_H
1097# include <iconv.h>
1098# else
1099# if defined(MACOS_X)
1100# include <sys/errno.h>
Bram Moolenaard0573012017-10-28 21:11:06 +02001101# ifndef EILSEQ
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001102# define EILSEQ ENOENT // Early MacOS X does not have EILSEQ
Bram Moolenaard0573012017-10-28 21:11:06 +02001103# endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00001104typedef struct _iconv_t *iconv_t;
1105# else
Bram Moolenaard0573012017-10-28 21:11:06 +02001106# include <errno.h>
Bram Moolenaar071d4272004-06-13 20:20:40 +00001107# endif
1108typedef void *iconv_t;
1109# endif
1110#endif
1111
1112/*
1113 * Used for the typeahead buffer: typebuf.
1114 */
1115typedef struct
1116{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001117 char_u *tb_buf; // buffer for typed characters
1118 char_u *tb_noremap; // mapping flags for characters in tb_buf[]
1119 int tb_buflen; // size of tb_buf[]
1120 int tb_off; // current position in tb_buf[]
1121 int tb_len; // number of valid bytes in tb_buf[]
1122 int tb_maplen; // nr of mapped bytes in tb_buf[]
1123 int tb_silent; // nr of silently mapped bytes in tb_buf[]
1124 int tb_no_abbr_cnt; // nr of bytes without abbrev. in tb_buf[]
1125 int tb_change_cnt; // nr of time tb_buf was changed; never zero
Bram Moolenaar071d4272004-06-13 20:20:40 +00001126} typebuf_T;
1127
Bram Moolenaar9bf703d2019-11-30 19:44:38 +01001128// Struct to hold the saved typeahead for save_typeahead().
Bram Moolenaar071d4272004-06-13 20:20:40 +00001129typedef struct
1130{
1131 typebuf_T save_typebuf;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001132 int typebuf_valid; // TRUE when save_typebuf valid
Bram Moolenaar13df0fe2009-07-09 16:24:19 +00001133 int old_char;
1134 int old_mod_mask;
Bram Moolenaar0a36fec2014-02-11 15:10:43 +01001135 buffheader_T save_readbuf1;
1136 buffheader_T save_readbuf2;
Bram Moolenaar071d4272004-06-13 20:20:40 +00001137#ifdef USE_INPUT_BUF
1138 char_u *save_inputbuf;
1139#endif
1140} tasave_T;
1141
1142/*
1143 * Used for conversion of terminal I/O and script files.
1144 */
1145typedef struct
1146{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001147 int vc_type; // zero or one of the CONV_ values
1148 int vc_factor; // max. expansion factor
Bram Moolenaar4f974752019-02-17 17:44:42 +01001149# ifdef MSWIN
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001150 int vc_cpfrom; // codepage to convert from (CONV_CODEPAGE)
1151 int vc_cpto; // codepage to convert to (CONV_CODEPAGE)
Bram Moolenaar071d4272004-06-13 20:20:40 +00001152# endif
1153# ifdef USE_ICONV
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001154 iconv_t vc_fd; // for CONV_ICONV
Bram Moolenaar071d4272004-06-13 20:20:40 +00001155# endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001156 int vc_fail; // fail for invalid char, don't use '?'
Bram Moolenaar071d4272004-06-13 20:20:40 +00001157} vimconv_T;
1158
1159/*
Bram Moolenaar5f32ece2019-07-21 21:51:59 +02001160 * Structure used for the command line history.
1161 */
1162typedef struct hist_entry
1163{
Bram Moolenaar4aea03e2019-09-25 22:37:17 +02001164 int hisnum; // identifying number
1165 int viminfo; // when TRUE hisstr comes from viminfo
1166 char_u *hisstr; // actual entry, separator char after the NUL
1167 time_t time_set; // when it was typed, zero if unknown
Bram Moolenaar5f32ece2019-07-21 21:51:59 +02001168} histentry_T;
1169
Bram Moolenaar071d4272004-06-13 20:20:40 +00001170#define CONV_NONE 0
1171#define CONV_TO_UTF8 1
Bram Moolenaar3fdfa4a2004-10-07 21:02:47 +00001172#define CONV_9_TO_UTF8 2
1173#define CONV_TO_LATIN1 3
1174#define CONV_TO_LATIN9 4
1175#define CONV_ICONV 5
Bram Moolenaar4f974752019-02-17 17:44:42 +01001176#ifdef MSWIN
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001177# define CONV_CODEPAGE 10 // codepage -> codepage
Bram Moolenaar071d4272004-06-13 20:20:40 +00001178#endif
1179#ifdef MACOS_X
Bram Moolenaar3fdfa4a2004-10-07 21:02:47 +00001180# define CONV_MAC_LATIN1 20
1181# define CONV_LATIN1_MAC 21
1182# define CONV_MAC_UTF8 22
1183# define CONV_UTF8_MAC 23
Bram Moolenaar071d4272004-06-13 20:20:40 +00001184#endif
1185
1186/*
1187 * Structure used for mappings and abbreviations.
1188 */
1189typedef struct mapblock mapblock_T;
1190struct mapblock
1191{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001192 mapblock_T *m_next; // next mapblock in list
1193 char_u *m_keys; // mapped from, lhs
1194 char_u *m_str; // mapped to, rhs
1195 char_u *m_orig_str; // rhs as entered by the user
1196 int m_keylen; // strlen(m_keys)
1197 int m_mode; // valid mode
Bram Moolenaar459fd782019-10-13 16:43:39 +02001198 int m_simplified; // m_keys was simplified, do not use this map
1199 // if seenModifyOtherKeys is TRUE
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001200 int m_noremap; // if non-zero no re-mapping for m_str
1201 char m_silent; // <silent> used, don't echo commands
1202 char m_nowait; // <nowait> used
Bram Moolenaarae5bce12005-08-15 21:41:48 +00001203#ifdef FEAT_EVAL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001204 char m_expr; // <expr> used, m_str is an expression
1205 sctx_T m_script_ctx; // SCTX where map was defined
Bram Moolenaar071d4272004-06-13 20:20:40 +00001206#endif
1207};
1208
1209/*
1210 * Used for highlighting in the status line.
1211 */
1212struct stl_hlrec
1213{
1214 char_u *start;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001215 int userhl; // 0: no HL, 1-9: User HL, < 0 for syn ID
Bram Moolenaar071d4272004-06-13 20:20:40 +00001216};
1217
Bram Moolenaar860cae12010-06-05 23:22:07 +02001218
1219/*
1220 * Syntax items - usually buffer-specific.
1221 */
1222
Bram Moolenaar9bf703d2019-11-30 19:44:38 +01001223/*
1224 * Item for a hashtable. "hi_key" can be one of three values:
Bram Moolenaardcaf10e2005-01-21 11:55:25 +00001225 * NULL: Never been used
1226 * HI_KEY_REMOVED: Entry was removed
1227 * Otherwise: Used item, pointer to the actual key; this usually is
1228 * inside the item, subtract an offset to locate the item.
1229 * This reduces the size of hashitem by 1/3.
1230 */
1231typedef struct hashitem_S
1232{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001233 long_u hi_hash; // cached hash number of hi_key
Bram Moolenaardcaf10e2005-01-21 11:55:25 +00001234 char_u *hi_key;
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001235} hashitem_T;
Bram Moolenaardcaf10e2005-01-21 11:55:25 +00001236
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001237// The address of "hash_removed" is used as a magic number for hi_key to
1238// indicate a removed item.
Bram Moolenaardcaf10e2005-01-21 11:55:25 +00001239#define HI_KEY_REMOVED &hash_removed
1240#define HASHITEM_EMPTY(hi) ((hi)->hi_key == NULL || (hi)->hi_key == &hash_removed)
1241
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001242// Initial size for a hashtable. Our items are relatively small and growing
1243// is expensive, thus use 16 as a start. Must be a power of 2.
Bram Moolenaarac3150d2019-07-28 16:36:39 +02001244// This allows for storing 10 items (2/3 of 16) before a resize is needed.
Bram Moolenaardcaf10e2005-01-21 11:55:25 +00001245#define HT_INIT_SIZE 16
1246
1247typedef struct hashtable_S
1248{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001249 long_u ht_mask; // mask used for hash value (nr of items in
1250 // array is "ht_mask" + 1)
1251 long_u ht_used; // number of items used
1252 long_u ht_filled; // number of items used + removed
1253 int ht_locked; // counter for hash_lock()
1254 int ht_error; // when set growing failed, can't add more
1255 // items before growing works
1256 hashitem_T *ht_array; // points to the array, allocated when it's
1257 // not "ht_smallarray"
1258 hashitem_T ht_smallarray[HT_INIT_SIZE]; // initial array
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001259} hashtab_T;
1260
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001261typedef long_u hash_T; // Type for hi_hash
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001262
1263
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001264// Use 64-bit Number.
Bram Moolenaar82f654e2020-02-17 22:12:50 +01001265#ifdef MSWIN
1266# ifdef PROTO
Bram Moolenaarf9706e92020-02-22 14:27:04 +01001267 // workaround for cproto that doesn't recognize __int64
1268 typedef long varnumber_T;
1269 typedef unsigned long uvarnumber_T;
1270# define VARNUM_MIN LONG_MIN
1271# define VARNUM_MAX LONG_MAX
1272# define UVARNUM_MAX ULONG_MAX
Bram Moolenaar82f654e2020-02-17 22:12:50 +01001273# else
Bram Moolenaarf9706e92020-02-22 14:27:04 +01001274 typedef __int64 varnumber_T;
1275 typedef unsigned __int64 uvarnumber_T;
1276# define VARNUM_MIN _I64_MIN
1277# define VARNUM_MAX _I64_MAX
1278# define UVARNUM_MAX _UI64_MAX
Bram Moolenaar22fcfad2016-07-01 18:17:26 +02001279# endif
Bram Moolenaarf9706e92020-02-22 14:27:04 +01001280#elif defined(HAVE_NO_LONG_LONG)
1281# if defined(HAVE_STDINT_H)
1282 typedef int64_t varnumber_T;
1283 typedef uint64_t uvarnumber_T;
1284# define VARNUM_MIN INT64_MIN
1285# define VARNUM_MAX INT64_MAX
1286# define UVARNUM_MAX UINT64_MAX
1287# else
1288 // this may cause trouble for code that depends on 64 bit ints
1289 typedef long varnumber_T;
1290 typedef unsigned long uvarnumber_T;
1291# define VARNUM_MIN LONG_MIN
1292# define VARNUM_MAX LONG_MAX
1293# define UVARNUM_MAX ULONG_MAX
1294# endif
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001295#else
Bram Moolenaarf9706e92020-02-22 14:27:04 +01001296 typedef long long varnumber_T;
1297 typedef unsigned long long uvarnumber_T;
Bram Moolenaarc593bec2020-02-25 21:26:49 +01001298# ifdef LLONG_MIN
1299# define VARNUM_MIN LLONG_MIN
1300# define VARNUM_MAX LLONG_MAX
1301# define UVARNUM_MAX ULLONG_MAX
1302# else
1303# define VARNUM_MIN LONG_LONG_MIN
1304# define VARNUM_MAX LONG_LONG_MAX
1305# define UVARNUM_MAX ULONG_LONG_MAX
1306# endif
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001307#endif
Bram Moolenaar22fcfad2016-07-01 18:17:26 +02001308
Bram Moolenaara65c2882020-04-08 11:31:48 +02001309// On rare systems "char" is unsigned, sometimes we really want a signed 8-bit
1310// value.
1311typedef signed char int8_T;
1312
Bram Moolenaarc1a11ed2008-06-24 22:09:24 +00001313typedef double float_T;
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001314
1315typedef struct listvar_S list_T;
1316typedef struct dictvar_S dict_T;
Bram Moolenaar1735bc92016-03-14 23:05:14 +01001317typedef struct partial_S partial_T;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01001318typedef struct blobvar_S blob_T;
Bram Moolenaar6463ca22016-02-13 17:04:46 +01001319
Bram Moolenaar3a97bb32019-06-01 13:28:35 +02001320// Struct that holds both a normal function name and a partial_T, as used for a
1321// callback argument.
1322// When used temporarily "cb_name" is not allocated. The refcounts to either
1323// the function or the partial are incremented and need to be decremented
1324// later with free_callback().
1325typedef struct {
1326 char_u *cb_name;
1327 partial_T *cb_partial;
1328 int cb_free_name; // cb_name was allocated
1329} callback_T;
1330
Bram Moolenaar20431c92020-03-20 18:39:46 +01001331typedef struct isn_S isn_T; // instruction
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001332typedef struct dfunc_S dfunc_T; // :def function
1333
Bram Moolenaar835dc632016-02-07 14:27:38 +01001334typedef struct jobvar_S job_T;
Bram Moolenaar6463ca22016-02-13 17:04:46 +01001335typedef struct readq_S readq_T;
Bram Moolenaar97bd5e62017-08-18 20:50:30 +02001336typedef struct writeq_S writeq_T;
Bram Moolenaar6463ca22016-02-13 17:04:46 +01001337typedef struct jsonq_S jsonq_T;
1338typedef struct cbq_S cbq_T;
1339typedef struct channel_S channel_T;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001340typedef struct cctx_S cctx_T;
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001341
Bram Moolenaara03f2332016-02-06 18:09:59 +01001342typedef enum
1343{
Bram Moolenaar4c683752020-04-05 21:38:23 +02001344 VAR_UNKNOWN = 0, // not set, any type or "void" allowed
1345 VAR_ANY, // used for "any" type
1346 VAR_VOID, // no value (function not returning anything)
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001347 VAR_BOOL, // "v_number" is used: VVAL_TRUE or VVAL_FALSE
1348 VAR_SPECIAL, // "v_number" is used: VVAL_NULL or VVAL_NONE
1349 VAR_NUMBER, // "v_number" is used
1350 VAR_FLOAT, // "v_float" is used
1351 VAR_STRING, // "v_string" is used
1352 VAR_BLOB, // "v_blob" is used
1353 VAR_FUNC, // "v_string" is function name
1354 VAR_PARTIAL, // "v_partial" is used
1355 VAR_LIST, // "v_list" is used
1356 VAR_DICT, // "v_dict" is used
1357 VAR_JOB, // "v_job" is used
1358 VAR_CHANNEL, // "v_channel" is used
Bram Moolenaara03f2332016-02-06 18:09:59 +01001359} vartype_T;
1360
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001361// A type specification.
1362typedef struct type_S type_T;
1363struct type_S {
1364 vartype_T tt_type;
Bram Moolenaar1378fbc2020-04-11 20:50:33 +02001365 int8_T tt_argcount; // for func, incl. vararg, -1 for unknown
Bram Moolenaar5deeb3f2020-04-05 17:08:17 +02001366 char tt_min_argcount; // number of non-optional arguments
1367 char tt_flags; // TTFLAG_ values
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001368 type_T *tt_member; // for list, dict, func return type
Bram Moolenaar5deeb3f2020-04-05 17:08:17 +02001369 type_T **tt_args; // func argument types, allocated
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001370};
1371
Bram Moolenaard77a8522020-04-03 21:59:57 +02001372#define TTFLAG_VARARGS 1 // func args ends with "..."
1373#define TTFLAG_OPTARG 2 // func arg type with "?"
1374
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001375/*
1376 * Structure to hold an internal variable without a name.
1377 */
1378typedef struct
1379{
Bram Moolenaara03f2332016-02-06 18:09:59 +01001380 vartype_T v_type;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001381 char v_lock; // see below: VAR_LOCKED, VAR_FIXED
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001382 union
1383 {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001384 varnumber_T v_number; // number value
Bram Moolenaarc1a11ed2008-06-24 22:09:24 +00001385#ifdef FEAT_FLOAT
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001386 float_T v_float; // floating number value
Bram Moolenaarc1a11ed2008-06-24 22:09:24 +00001387#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001388 char_u *v_string; // string value (can be NULL!)
1389 list_T *v_list; // list value (can be NULL!)
1390 dict_T *v_dict; // dict value (can be NULL!)
1391 partial_T *v_partial; // closure: function with args
Bram Moolenaar509ce2a2016-03-11 22:52:15 +01001392#ifdef FEAT_JOB_CHANNEL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001393 job_T *v_job; // job value (can be NULL!)
1394 channel_T *v_channel; // channel value (can be NULL!)
Bram Moolenaar77073442016-02-13 23:23:53 +01001395#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001396 blob_T *v_blob; // blob value (can be NULL!)
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001397 } vval;
1398} typval_T;
1399
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001400// Values for "dv_scope".
1401#define VAR_SCOPE 1 // a:, v:, s:, etc. scope dictionaries
1402#define VAR_DEF_SCOPE 2 // l:, g: scope dictionaries: here funcrefs are not
1403 // allowed to mask existing functions
Bram Moolenaarbdb62052012-07-16 17:31:53 +02001404
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001405// Values for "v_lock".
1406#define VAR_LOCKED 1 // locked with lock(), can use unlock()
1407#define VAR_FIXED 2 // locked forever
Bram Moolenaar2ce06f62005-01-31 19:19:04 +00001408
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001409/*
1410 * Structure to hold an item of a list: an internal variable without a name.
1411 */
1412typedef struct listitem_S listitem_T;
1413
1414struct listitem_S
1415{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001416 listitem_T *li_next; // next item in list
1417 listitem_T *li_prev; // previous item in list
1418 typval_T li_tv; // type and value of the variable
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001419};
1420
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001421// Struct used by those that are using an item in a list.
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001422typedef struct listwatch_S listwatch_T;
1423
1424struct listwatch_S
1425{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001426 listitem_T *lw_item; // item being watched
1427 listwatch_T *lw_next; // next watcher
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001428};
1429
1430/*
1431 * Structure to hold info about a list.
Bram Moolenaar1a840242018-03-08 21:46:43 +01001432 * Order of members is optimized to reduce padding.
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001433 * When created by range() it will at first have special value:
1434 * lv_first == &range_list_item;
1435 * and use lv_start, lv_end, lv_stride.
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001436 */
1437struct listvar_S
1438{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001439 listitem_T *lv_first; // first item, NULL if none
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001440 listwatch_T *lv_watch; // first watcher, NULL if none
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001441 union {
1442 struct { // used for non-materialized range list:
1443 // "lv_first" is &range_list_item
1444 varnumber_T lv_start;
1445 varnumber_T lv_end;
1446 int lv_stride;
Bram Moolenaar0ff6aad2020-01-29 21:27:21 +01001447 } nonmat;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001448 struct { // used for materialized list
1449 listitem_T *lv_last; // last item, NULL if none
1450 listitem_T *lv_idx_item; // when not NULL item at index "lv_idx"
1451 int lv_idx; // cached index of an item
Bram Moolenaar0ff6aad2020-01-29 21:27:21 +01001452 } mat;
1453 } lv_u;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001454 list_T *lv_copylist; // copied list used by deepcopy()
1455 list_T *lv_used_next; // next list in used lists list
1456 list_T *lv_used_prev; // previous list in used lists list
1457 int lv_refcount; // reference count
1458 int lv_len; // number of items
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001459 int lv_with_items; // number of items following this struct that
1460 // should not be freed
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001461 int lv_copyID; // ID used by deepcopy()
1462 char lv_lock; // zero, VAR_LOCKED, VAR_FIXED
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001463};
1464
1465/*
Bram Moolenaardf48fb42016-07-22 21:50:18 +02001466 * Static list with 10 items. Use init_static_list() to initialize.
1467 */
1468typedef struct {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001469 list_T sl_list; // must be first
Bram Moolenaardf48fb42016-07-22 21:50:18 +02001470 listitem_T sl_items[10];
1471} staticList10_T;
1472
1473/*
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001474 * Structure to hold an item of a Dictionary.
1475 * Also used for a variable.
1476 * The key is copied into "di_key" to avoid an extra alloc/free for it.
1477 */
1478struct dictitem_S
1479{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001480 typval_T di_tv; // type and value of the variable
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001481 char_u di_flags; // DI_FLAGS_ flags (only used for variable)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001482 char_u di_key[1]; // key (actually longer!)
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001483};
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001484typedef struct dictitem_S dictitem_T;
1485
Bram Moolenaard7c96872019-06-15 17:12:48 +02001486/*
1487 * A dictitem with a 16 character key (plus NUL). This is an efficient way to
1488 * have a fixed-size dictitem.
1489 */
1490#define DICTITEM16_KEY_LEN 16
Bram Moolenaarbee6c0c2016-03-25 15:40:50 +01001491struct dictitem16_S
1492{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001493 typval_T di_tv; // type and value of the variable
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001494 char_u di_flags; // DI_FLAGS_ flags (only used for variable)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001495 char_u di_key[DICTITEM16_KEY_LEN + 1]; // key
Bram Moolenaarbee6c0c2016-03-25 15:40:50 +01001496};
1497typedef struct dictitem16_S dictitem16_T;
1498
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001499// Flags for "di_flags"
1500#define DI_FLAGS_RO 0x01 // read-only variable
1501#define DI_FLAGS_RO_SBX 0x02 // read-only in the sandbox
1502#define DI_FLAGS_FIX 0x04 // fixed: no :unlet or remove()
1503#define DI_FLAGS_LOCK 0x08 // locked variable
1504#define DI_FLAGS_ALLOC 0x10 // separately allocated
1505#define DI_FLAGS_RELOAD 0x20 // set when script sourced again
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001506
1507/*
1508 * Structure to hold info about a Dictionary.
1509 */
1510struct dictvar_S
1511{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001512 char dv_lock; // zero, VAR_LOCKED, VAR_FIXED
1513 char dv_scope; // zero, VAR_SCOPE, VAR_DEF_SCOPE
1514 int dv_refcount; // reference count
1515 int dv_copyID; // ID used by deepcopy()
1516 hashtab_T dv_hashtab; // hashtab that refers to the items
1517 dict_T *dv_copydict; // copied dict used by deepcopy()
1518 dict_T *dv_used_next; // next dict in used dicts list
1519 dict_T *dv_used_prev; // previous dict in used dicts list
Bram Moolenaar8f999f12005-01-25 22:12:55 +00001520};
1521
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01001522/*
1523 * Structure to hold info about a blob.
1524 */
1525struct blobvar_S
1526{
1527 garray_T bv_ga; // growarray with the data
1528 int bv_refcount; // reference count
1529 char bv_lock; // zero, VAR_LOCKED, VAR_FIXED
1530};
1531
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001532#if defined(FEAT_EVAL) || defined(PROTO)
1533typedef struct funccall_S funccall_T;
1534
Bram Moolenaar25e0f582020-05-25 22:36:50 +02001535// values used for "uf_dfunc_idx"
Bram Moolenaar0cb5bcf2020-06-20 18:19:09 +02001536typedef enum {
1537 UF_NOT_COMPILED,
1538 UF_TO_BE_COMPILED,
1539 UF_COMPILED
1540} def_status_T;
Bram Moolenaar822ba242020-05-24 23:00:18 +02001541
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001542/*
1543 * Structure to hold info for a user function.
1544 */
1545typedef struct
1546{
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001547 int uf_varargs; // variable nr of arguments (old style)
1548 int uf_flags; // FC_ flags
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02001549 int uf_calls; // nr of active calls
1550 int uf_cleared; // func_clear() was already called
Bram Moolenaar0cb5bcf2020-06-20 18:19:09 +02001551 def_status_T uf_def_status; // UF_NOT_COMPILED, UF_TO_BE_COMPILED, etc.
1552 int uf_dfunc_idx; // only valid if uf_def_status is UF_COMPILED
Bram Moolenaar5deeb3f2020-04-05 17:08:17 +02001553 garray_T uf_args; // arguments, including optional arguments
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02001554 garray_T uf_def_args; // default argument expressions
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001555
1556 // for :def (for :function uf_ret_type is NULL)
1557 type_T **uf_arg_types; // argument types (count == uf_args.ga_len)
1558 type_T *uf_ret_type; // return type
1559 garray_T uf_type_list; // types used in arg and return types
Bram Moolenaar170fcfc2020-02-06 17:51:35 +01001560 int *uf_def_arg_idx; // instruction indexes for evaluating
1561 // uf_def_args; length: uf_def_args.ga_len + 1
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001562 char_u *uf_va_name; // name from "...name" or NULL
1563 type_T *uf_va_type; // type from "...name: type" or NULL
Bram Moolenaar5deeb3f2020-04-05 17:08:17 +02001564 type_T *uf_func_type; // type of the function, &t_func_any if unknown
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001565
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02001566 garray_T uf_lines; // function lines
Bram Moolenaar27e80c82018-10-14 21:41:01 +02001567# ifdef FEAT_PROFILE
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02001568 int uf_profiling; // TRUE when func is being profiled
Bram Moolenaarad648092018-06-30 18:28:03 +02001569 int uf_prof_initialized;
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02001570 // profiling the function as a whole
1571 int uf_tm_count; // nr of calls
1572 proftime_T uf_tm_total; // time spent in function + children
1573 proftime_T uf_tm_self; // time spent in function itself
1574 proftime_T uf_tm_children; // time spent in children this call
1575 // profiling the function per line
1576 int *uf_tml_count; // nr of times line was executed
1577 proftime_T *uf_tml_total; // time spent in a line + children
1578 proftime_T *uf_tml_self; // time spent in a line itself
1579 proftime_T uf_tml_start; // start time for current line
1580 proftime_T uf_tml_children; // time spent in children for this line
1581 proftime_T uf_tml_wait; // start wait time for current line
1582 int uf_tml_idx; // index of line being timed; -1 if none
1583 int uf_tml_execed; // line being timed was executed
Bram Moolenaar27e80c82018-10-14 21:41:01 +02001584# endif
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02001585 sctx_T uf_script_ctx; // SCTX where function was defined,
1586 // used for s: variables
1587 int uf_refcount; // reference count, see func_name_refcount()
Bram Moolenaarc8cd2b32020-05-01 19:29:08 +02001588
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02001589 funccall_T *uf_scoped; // l: local variables for closure
Bram Moolenaarc8cd2b32020-05-01 19:29:08 +02001590
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01001591 char_u *uf_name_exp; // if "uf_name[]" starts with SNR the name with
1592 // "<SNR>" as a string, otherwise NULL
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02001593 char_u uf_name[1]; // name of function (actually longer); can
1594 // start with <SNR>123_ (<SNR> is K_SPECIAL
1595 // KS_EXTRA KE_SNR)
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001596} ufunc_T;
1597
Bram Moolenaarc8cd2b32020-05-01 19:29:08 +02001598// flags used in uf_flags
1599#define FC_ABORT 0x01 // abort function on error
1600#define FC_RANGE 0x02 // function accepts range
1601#define FC_DICT 0x04 // Dict function, uses "self"
1602#define FC_CLOSURE 0x08 // closure, uses outer scope variables
1603#define FC_DELETED 0x10 // :delfunction used while uf_refcount > 0
1604#define FC_REMOVED 0x20 // function redefined while uf_refcount > 0
1605#define FC_SANDBOX 0x40 // function defined in the sandbox
1606#define FC_DEAD 0x80 // function kept only for reference to dfunc
1607#define FC_EXPORT 0x100 // "export def Func()"
1608#define FC_NOARGS 0x200 // no a: variables in lambda
1609#define FC_VIM9 0x400 // defined in vim9 script file
1610
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02001611#define MAX_FUNC_ARGS 20 // maximum number of function arguments
1612#define VAR_SHORT_LEN 20 // short variable name length
1613#define FIXVAR_CNT 12 // number of fixed variables
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001614
Bram Moolenaar9bf703d2019-11-30 19:44:38 +01001615/*
Bram Moolenaarbf67ea12020-05-02 17:52:42 +02001616 * Structure to hold info for a function that is currently being executed.
Bram Moolenaar9bf703d2019-11-30 19:44:38 +01001617 */
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001618struct funccall_S
1619{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001620 ufunc_T *func; // function being called
1621 int linenr; // next line to be executed
1622 int returned; // ":return" used
1623 struct // fixed variables for arguments
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001624 {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001625 dictitem_T var; // variable (without room for name)
1626 char_u room[VAR_SHORT_LEN]; // room for the name
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001627 } fixvar[FIXVAR_CNT];
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001628 dict_T l_vars; // l: local function variables
1629 dictitem_T l_vars_var; // variable for l: scope
1630 dict_T l_avars; // a: argument variables
1631 dictitem_T l_avars_var; // variable for a: scope
1632 list_T l_varlist; // list for a:000
1633 listitem_T l_listitems[MAX_FUNC_ARGS]; // listitems for a:000
1634 typval_T *rettv; // return value
1635 linenr_T breakpoint; // next line with breakpoint or zero
1636 int dbg_tick; // debug_tick when breakpoint was set
1637 int level; // top nesting level of executed function
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001638#ifdef FEAT_PROFILE
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001639 proftime_T prof_child; // time spent in a child
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001640#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001641 funccall_T *caller; // calling function or NULL
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001642
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001643 // for closure
1644 int fc_refcount; // number of user functions that reference this
1645 // funccal
1646 int fc_copyID; // for garbage collection
1647 garray_T fc_funcs; // list of ufunc_T* which keep a reference to
1648 // "func"
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001649};
1650
1651/*
1652 * Struct used by trans_function_name()
1653 */
1654typedef struct
1655{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001656 dict_T *fd_dict; // Dictionary used
1657 char_u *fd_newkey; // new key in "dict" in allocated memory
1658 dictitem_T *fd_di; // Dictionary item used
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001659} funcdict_T;
1660
Bram Moolenaar27e80c82018-10-14 21:41:01 +02001661typedef struct funccal_entry funccal_entry_T;
1662struct funccal_entry {
1663 void *top_funccal;
1664 funccal_entry_T *next;
1665};
1666
Bram Moolenaar9bf703d2019-11-30 19:44:38 +01001667// From user function to hashitem and back.
Bram Moolenaar660a10a2019-07-14 15:48:38 +02001668#define UF2HIKEY(fp) ((fp)->uf_name)
1669#define HIKEY2UF(p) ((ufunc_T *)((p) - offsetof(ufunc_T, uf_name)))
1670#define HI2UF(hi) HIKEY2UF((hi)->hi_key)
1671
Bram Moolenaar9bf703d2019-11-30 19:44:38 +01001672/*
Bram Moolenaar7ebcba62020-01-12 17:42:55 +01001673 * Holds the hashtab with variables local to each sourced script.
1674 * Each item holds a variable (nameless) that points to the dict_T.
1675 */
1676typedef struct
1677{
1678 dictitem_T sv_var;
1679 dict_T sv_dict;
1680} scriptvar_T;
1681
1682/*
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001683 * Entry for "sn_var_vals". Used for script-local variables.
1684 */
1685typedef struct {
1686 char_u *sv_name; // points into "sn_vars" di_key
1687 typval_T *sv_tv; // points into "sn_vars" di_tv
1688 type_T *sv_type;
1689 int sv_const;
1690 int sv_export; // "export let var = val"
1691} svar_T;
1692
1693typedef struct {
1694 char_u *imp_name; // name imported as (allocated)
1695 int imp_sid; // script ID of "from"
1696
1697 // for "import * as Name", "imp_name" is "Name"
1698 int imp_all;
1699
1700 // for variable
1701 type_T *imp_type;
1702 int imp_var_vals_idx; // index in sn_var_vals of "from"
1703
1704 // for function
1705 char_u *imp_funcname; // user func name (NOT allocated)
1706} imported_T;
1707
1708/*
Bram Moolenaar9bf703d2019-11-30 19:44:38 +01001709 * Growarray to store info about already sourced scripts.
Bram Moolenaarfa55cfc2019-07-13 22:59:32 +02001710 * For Unix also store the dev/ino, so that we don't have to stat() each
Bram Moolenaar9bf703d2019-11-30 19:44:38 +01001711 * script when going through the list.
1712 */
Bram Moolenaar7ebcba62020-01-12 17:42:55 +01001713typedef struct
Bram Moolenaarfa55cfc2019-07-13 22:59:32 +02001714{
1715 char_u *sn_name;
Bram Moolenaar7ebcba62020-01-12 17:42:55 +01001716
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001717 scriptvar_T *sn_vars; // stores s: variables for this script
1718 garray_T sn_var_vals; // same variables as a list of svar_T
1719
1720 garray_T sn_imports; // imported items, imported_T
1721
1722 garray_T sn_type_list; // keeps types used by variables
1723
Bram Moolenaar7ebcba62020-01-12 17:42:55 +01001724 int sn_version; // :scriptversion
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001725 int sn_had_command; // TRUE if any command was executed
1726 char_u *sn_save_cpo; // 'cpo' value when :vim9script found
Bram Moolenaar7ebcba62020-01-12 17:42:55 +01001727
Bram Moolenaarfa55cfc2019-07-13 22:59:32 +02001728# ifdef FEAT_PROFILE
Bram Moolenaar4aea03e2019-09-25 22:37:17 +02001729 int sn_prof_on; // TRUE when script is/was profiled
1730 int sn_pr_force; // forceit: profile functions in this script
1731 proftime_T sn_pr_child; // time set when going into first child
1732 int sn_pr_nest; // nesting for sn_pr_child
1733 // profiling the script as a whole
1734 int sn_pr_count; // nr of times sourced
1735 proftime_T sn_pr_total; // time spent in script + children
1736 proftime_T sn_pr_self; // time spent in script itself
1737 proftime_T sn_pr_start; // time at script start
1738 proftime_T sn_pr_children; // time in children after script start
1739 // profiling the script per line
1740 garray_T sn_prl_ga; // things stored for every line
1741 proftime_T sn_prl_start; // start time for current line
1742 proftime_T sn_prl_children; // time spent in children for this line
1743 proftime_T sn_prl_wait; // wait start time for current line
1744 int sn_prl_idx; // index of line being timed; -1 if none
1745 int sn_prl_execed; // line being timed was executed
Bram Moolenaarfa55cfc2019-07-13 22:59:32 +02001746# endif
1747} scriptitem_T;
1748
Bram Moolenaar5409f5d2020-06-24 18:37:35 +02001749// Struct passed through eval() functions.
1750// See EVALARG_EVALUATE for a fixed value with eval_flags set to EVAL_EVALUATE.
1751typedef struct {
1752 int eval_flags; // EVAL_ flag values below
1753
1754 // copied from exarg_T when "getline" is "getsourceline". Can be NULL.
1755 void *eval_cookie; // argument for getline()
1756} evalarg_T;
1757
1758// Flags for expression evaluation.
1759#define EVAL_EVALUATE 1 // when missing don't actually evaluate
1760#define EVAL_CONSTANT 2 // when not a constant return FAIL
1761
Bram Moolenaarfa55cfc2019-07-13 22:59:32 +02001762# ifdef FEAT_PROFILE
Bram Moolenaar9bf703d2019-11-30 19:44:38 +01001763/*
1764 * Struct used in sn_prl_ga for every line of a script.
1765 */
Bram Moolenaarfa55cfc2019-07-13 22:59:32 +02001766typedef struct sn_prl_S
1767{
Bram Moolenaar4aea03e2019-09-25 22:37:17 +02001768 int snp_count; // nr of times line was executed
1769 proftime_T sn_prl_total; // time spent in a line + children
1770 proftime_T sn_prl_self; // time spent in a line itself
Bram Moolenaarfa55cfc2019-07-13 22:59:32 +02001771} sn_prl_T;
1772
1773# define PRL_ITEM(si, idx) (((sn_prl_T *)(si)->sn_prl_ga.ga_data)[(idx)])
1774# endif
Bram Moolenaaracadbea2016-08-01 16:35:59 +02001775#else
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001776// dummy typedefs for use in function prototypes
Bram Moolenaaracadbea2016-08-01 16:35:59 +02001777typedef struct
1778{
1779 int dummy;
1780} ufunc_T;
1781typedef struct
1782{
1783 int dummy;
Bram Moolenaarfa55cfc2019-07-13 22:59:32 +02001784} funccall_T;
1785typedef struct
1786{
1787 int dummy;
Bram Moolenaaracadbea2016-08-01 16:35:59 +02001788} funcdict_T;
Bram Moolenaard95c3c22018-10-14 22:38:09 +02001789typedef struct
1790{
1791 int dummy;
1792} funccal_entry_T;
Bram Moolenaarfa55cfc2019-07-13 22:59:32 +02001793typedef struct
1794{
1795 int dummy;
1796} scriptitem_T;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001797#endif
1798
Bram Moolenaar505e43a2019-08-03 18:28:17 +02001799// Struct passed between functions dealing with function call execution.
1800//
1801// "argv_func", when not NULL, can be used to fill in arguments only when the
1802// invoked function uses them. It is called like this:
Bram Moolenaarb0745b22019-11-09 22:28:11 +01001803// new_argcount = argv_func(current_argcount, argv, partial_argcount,
1804// called_func_argcount)
Bram Moolenaar505e43a2019-08-03 18:28:17 +02001805//
1806typedef struct {
Bram Moolenaarb0745b22019-11-09 22:28:11 +01001807 int (* argv_func)(int, typval_T *, int, int);
Bram Moolenaar505e43a2019-08-03 18:28:17 +02001808 linenr_T firstline; // first line of range
1809 linenr_T lastline; // last line of range
1810 int *doesrange; // if not NULL: return: function handled range
1811 int evaluate; // actually evaluate expressions
1812 partial_T *partial; // for extra arguments
1813 dict_T *selfdict; // Dictionary for "self"
Bram Moolenaarac92e252019-08-03 21:58:38 +02001814 typval_T *basetv; // base for base->method()
Bram Moolenaar505e43a2019-08-03 18:28:17 +02001815} funcexe_T;
1816
Bram Moolenaarf7779c62020-05-03 15:38:16 +02001817/*
1818 * Structure to hold the context of a compiled function, used by closures
1819 * defined in that function.
1820 */
1821typedef struct funcstack_S
1822{
1823 garray_T fs_ga; // contains the stack, with:
1824 // - arguments
1825 // - frame
1826 // - local variables
1827
1828 int fs_refcount; // nr of closures referencing this funcstack
1829 int fs_copyID; // for garray_T collection
1830} funcstack_T;
1831
Bram Moolenaar1735bc92016-03-14 23:05:14 +01001832struct partial_S
1833{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001834 int pt_refcount; // reference count
1835 char_u *pt_name; // function name; when NULL use
1836 // pt_func->uf_name
1837 ufunc_T *pt_func; // function pointer; when NULL lookup function
1838 // with pt_name
1839 int pt_auto; // when TRUE the partial was created for using
1840 // dict.member in handle_subscript()
Bram Moolenaarf7779c62020-05-03 15:38:16 +02001841
1842 // For a compiled closure: the arguments and local variables.
1843 garray_T *pt_ectx_stack; // where to find local vars
1844 int pt_ectx_frame; // index of function frame in uf_ectx_stack
1845 funcstack_T *pt_funcstack; // copy of stack, used after context
1846 // function returns
1847
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001848 int pt_argc; // number of arguments
1849 typval_T *pt_argv; // arguments in allocated array
Bram Moolenaarf7779c62020-05-03 15:38:16 +02001850
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001851 dict_T *pt_dict; // dict for "self"
Bram Moolenaarb68b3462020-05-06 21:06:30 +02001852 int pt_copyID; // funcstack may contain pointer to partial
Bram Moolenaar1735bc92016-03-14 23:05:14 +01001853};
1854
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01001855typedef struct AutoPatCmd_S AutoPatCmd;
1856
1857/*
1858 * Entry in the execution stack "exestack".
1859 */
1860typedef enum {
1861 ETYPE_TOP, // toplevel
1862 ETYPE_SCRIPT, // sourcing script, use es_info.sctx
1863 ETYPE_UFUNC, // user function, use es_info.ufunc
1864 ETYPE_AUCMD, // autocomand, use es_info.aucmd
1865 ETYPE_MODELINE, // modeline, use es_info.sctx
1866 ETYPE_EXCEPT, // exception, use es_info.exception
1867 ETYPE_ARGS, // command line argument
1868 ETYPE_ENV, // environment variable
1869 ETYPE_INTERNAL, // internal operation
1870 ETYPE_SPELL, // loading spell file
1871} etype_T;
1872
1873typedef struct {
1874 long es_lnum; // replaces "sourcing_lnum"
1875 char_u *es_name; // replaces "sourcing_name"
1876 etype_T es_type;
1877 union {
1878 sctx_T *sctx; // script and modeline info
1879#if defined(FEAT_EVAL)
1880 ufunc_T *ufunc; // function info
1881#endif
1882 AutoPatCmd *aucmd; // autocommand info
1883 except_T *except; // exception info
1884 } es_info;
1885} estack_T;
1886
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001887// Information returned by get_tty_info().
Bram Moolenaar6b93b0e2017-08-13 20:28:53 +02001888typedef struct {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001889 int backspace; // what the Backspace key produces
1890 int enter; // what the Enter key produces
1891 int interrupt; // interrupt character
1892 int nl_does_cr; // TRUE when a NL is expanded to CR-NL on output
Bram Moolenaar6b93b0e2017-08-13 20:28:53 +02001893} ttyinfo_T;
1894
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001895// Status of a job. Order matters!
Bram Moolenaar835dc632016-02-07 14:27:38 +01001896typedef enum
1897{
1898 JOB_FAILED,
1899 JOB_STARTED,
Bram Moolenaarea3ece42018-04-17 20:14:39 +02001900 JOB_ENDED, // detected job done
1901 JOB_FINISHED, // job done and cleanup done
Bram Moolenaar835dc632016-02-07 14:27:38 +01001902} jobstatus_T;
1903
1904/*
1905 * Structure to hold info about a Job.
1906 */
1907struct jobvar_S
1908{
Bram Moolenaar65edff82016-02-21 16:40:11 +01001909 job_T *jv_next;
1910 job_T *jv_prev;
Bram Moolenaar835dc632016-02-07 14:27:38 +01001911#ifdef UNIX
1912 pid_t jv_pid;
Bram Moolenaar835dc632016-02-07 14:27:38 +01001913#endif
Bram Moolenaar4f974752019-02-17 17:44:42 +01001914#ifdef MSWIN
Bram Moolenaar76467df2016-02-12 19:30:26 +01001915 PROCESS_INFORMATION jv_proc_info;
Bram Moolenaar14207f42016-10-27 21:13:10 +02001916 HANDLE jv_job_object;
Bram Moolenaar835dc632016-02-07 14:27:38 +01001917#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001918 char_u *jv_tty_in; // controlling tty input, allocated
1919 char_u *jv_tty_out; // controlling tty output, allocated
Bram Moolenaar835dc632016-02-07 14:27:38 +01001920 jobstatus_T jv_status;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001921 char_u *jv_stoponexit; // allocated
Bram Moolenaarb3051ce2019-01-31 15:52:11 +01001922#ifdef UNIX
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001923 char_u *jv_termsig; // allocated
Bram Moolenaarb3051ce2019-01-31 15:52:11 +01001924#endif
Bram Moolenaar4f974752019-02-17 17:44:42 +01001925#ifdef MSWIN
Bram Moolenaarc6ddce32019-02-08 12:47:03 +01001926 char_u *jv_tty_type; // allocated
1927#endif
Bram Moolenaareab089d2016-02-21 19:32:02 +01001928 int jv_exitval;
Bram Moolenaar3a97bb32019-06-01 13:28:35 +02001929 callback_T jv_exit_cb;
Bram Moolenaar835dc632016-02-07 14:27:38 +01001930
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001931 buf_T *jv_in_buf; // buffer from "in-name"
Bram Moolenaar014069a2016-03-03 22:51:40 +01001932
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001933 int jv_refcount; // reference count
Bram Moolenaar107e1ee2016-04-08 17:07:19 +02001934 int jv_copyID;
1935
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001936 channel_T *jv_channel; // channel for I/O, reference counted
1937 char **jv_argv; // command line used to start the job
Bram Moolenaar835dc632016-02-07 14:27:38 +01001938};
1939
Bram Moolenaar6463ca22016-02-13 17:04:46 +01001940/*
1941 * Structures to hold info about a Channel.
1942 */
1943struct readq_S
1944{
Bram Moolenaar77073442016-02-13 23:23:53 +01001945 char_u *rq_buffer;
Bram Moolenaar9ed96ef2016-06-04 17:17:11 +02001946 long_u rq_buflen;
Bram Moolenaar77073442016-02-13 23:23:53 +01001947 readq_T *rq_next;
1948 readq_T *rq_prev;
Bram Moolenaar6463ca22016-02-13 17:04:46 +01001949};
1950
Bram Moolenaar97bd5e62017-08-18 20:50:30 +02001951struct writeq_S
1952{
1953 garray_T wq_ga;
1954 writeq_T *wq_next;
1955 writeq_T *wq_prev;
1956};
1957
Bram Moolenaar6463ca22016-02-13 17:04:46 +01001958struct jsonq_S
1959{
Bram Moolenaar77073442016-02-13 23:23:53 +01001960 typval_T *jq_value;
1961 jsonq_T *jq_next;
1962 jsonq_T *jq_prev;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001963 int jq_no_callback; // TRUE when no callback was found
Bram Moolenaar6463ca22016-02-13 17:04:46 +01001964};
1965
1966struct cbq_S
1967{
Bram Moolenaar3a97bb32019-06-01 13:28:35 +02001968 callback_T cq_callback;
Bram Moolenaar77073442016-02-13 23:23:53 +01001969 int cq_seq_nr;
1970 cbq_T *cq_next;
1971 cbq_T *cq_prev;
Bram Moolenaar6463ca22016-02-13 17:04:46 +01001972};
1973
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001974// mode for a channel
Bram Moolenaar6463ca22016-02-13 17:04:46 +01001975typedef enum
1976{
Bram Moolenaar77073442016-02-13 23:23:53 +01001977 MODE_NL = 0,
1978 MODE_RAW,
Bram Moolenaar6463ca22016-02-13 17:04:46 +01001979 MODE_JSON,
Bram Moolenaarea3ece42018-04-17 20:14:39 +02001980 MODE_JS,
Bram Moolenaar6463ca22016-02-13 17:04:46 +01001981} ch_mode_T;
1982
Bram Moolenaar580984e2016-03-20 21:17:13 +01001983typedef enum {
Bram Moolenaarea3ece42018-04-17 20:14:39 +02001984 JIO_PIPE, // default
Bram Moolenaar580984e2016-03-20 21:17:13 +01001985 JIO_NULL,
1986 JIO_FILE,
1987 JIO_BUFFER,
1988 JIO_OUT
1989} job_io_T;
1990
Bram Moolenaar7c9aec42017-08-03 13:51:25 +02001991#define CH_PART_FD(part) ch_part[part].ch_fd
1992
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02001993// Ordering matters, it is used in for loops: IN is last, only SOCK/OUT/ERR
1994// are polled.
Bram Moolenaardc0ccae2016-10-09 17:28:01 +02001995typedef enum {
1996 PART_SOCK = 0,
Bram Moolenaar7c9aec42017-08-03 13:51:25 +02001997#define CH_SOCK_FD CH_PART_FD(PART_SOCK)
Bram Moolenaar509ce2a2016-03-11 22:52:15 +01001998#ifdef FEAT_JOB_CHANNEL
Bram Moolenaardc0ccae2016-10-09 17:28:01 +02001999 PART_OUT,
Bram Moolenaar7c9aec42017-08-03 13:51:25 +02002000# define CH_OUT_FD CH_PART_FD(PART_OUT)
Bram Moolenaardc0ccae2016-10-09 17:28:01 +02002001 PART_ERR,
Bram Moolenaar7c9aec42017-08-03 13:51:25 +02002002# define CH_ERR_FD CH_PART_FD(PART_ERR)
Bram Moolenaardc0ccae2016-10-09 17:28:01 +02002003 PART_IN,
Bram Moolenaar7c9aec42017-08-03 13:51:25 +02002004# define CH_IN_FD CH_PART_FD(PART_IN)
Bram Moolenaar7b3ca762016-02-14 19:13:43 +01002005#endif
Bram Moolenaarea3ece42018-04-17 20:14:39 +02002006 PART_COUNT,
Bram Moolenaardc0ccae2016-10-09 17:28:01 +02002007} ch_part_T;
2008
2009#define INVALID_FD (-1)
Bram Moolenaar7b3ca762016-02-14 19:13:43 +01002010
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002011// The per-fd info for a channel.
Bram Moolenaar7b3ca762016-02-14 19:13:43 +01002012typedef struct {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002013 sock_T ch_fd; // socket/stdin/stdout/stderr, -1 if not used
Bram Moolenaar7b3ca762016-02-14 19:13:43 +01002014
2015# if defined(UNIX) && !defined(HAVE_SELECT)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002016 int ch_poll_idx; // used by channel_poll_setup()
Bram Moolenaar7b3ca762016-02-14 19:13:43 +01002017# endif
2018
2019#ifdef FEAT_GUI_X11
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002020 XtInputId ch_inputHandler; // Cookie for input
Bram Moolenaar7b3ca762016-02-14 19:13:43 +01002021#endif
2022#ifdef FEAT_GUI_GTK
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002023 gint ch_inputHandler; // Cookie for input
Bram Moolenaar7b3ca762016-02-14 19:13:43 +01002024#endif
Bram Moolenaar42d38a22016-02-20 18:18:59 +01002025
2026 ch_mode_T ch_mode;
Bram Moolenaar580984e2016-03-20 21:17:13 +01002027 job_io_T ch_io;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002028 int ch_timeout; // request timeout in msec
Bram Moolenaar42d38a22016-02-20 18:18:59 +01002029
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002030 readq_T ch_head; // header for circular raw read queue
2031 jsonq_T ch_json_head; // header for circular json read queue
2032 garray_T ch_block_ids; // list of IDs that channel_read_json_block()
2033 // is waiting for
2034 // When ch_wait_len is non-zero use ch_deadline to wait for incomplete
2035 // message to be complete. The value is the length of the incomplete
2036 // message when the deadline was set. If it gets longer (something was
2037 // received) the deadline is reset.
Bram Moolenaar88989cc2017-02-06 21:56:09 +01002038 size_t ch_wait_len;
Bram Moolenaar4f974752019-02-17 17:44:42 +01002039#ifdef MSWIN
Bram Moolenaarba61ac02016-03-20 16:40:37 +01002040 DWORD ch_deadline;
2041#else
2042 struct timeval ch_deadline;
2043#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002044 int ch_block_write; // for testing: 0 when not used, -1 when write
2045 // does not block, 1 simulate blocking
2046 int ch_nonblocking; // write() is non-blocking
2047 writeq_T ch_writeque; // header for write queue
Bram Moolenaar42d38a22016-02-20 18:18:59 +01002048
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002049 cbq_T ch_cb_head; // dummy node for per-request callbacks
2050 callback_T ch_callback; // call when a msg is not handled
Bram Moolenaar014069a2016-03-03 22:51:40 +01002051
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002052 bufref_T ch_bufref; // buffer to read from or write to
2053 int ch_nomodifiable; // TRUE when buffer can be 'nomodifiable'
2054 int ch_nomod_error; // TRUE when e_modifiable was given
2055 int ch_buf_append; // write appended lines instead top-bot
2056 linenr_T ch_buf_top; // next line to send
2057 linenr_T ch_buf_bot; // last line to send
Bram Moolenaar42d38a22016-02-20 18:18:59 +01002058} chanpart_T;
Bram Moolenaar7b3ca762016-02-14 19:13:43 +01002059
Bram Moolenaar6463ca22016-02-13 17:04:46 +01002060struct channel_S {
Bram Moolenaar77073442016-02-13 23:23:53 +01002061 channel_T *ch_next;
2062 channel_T *ch_prev;
2063
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002064 int ch_id; // ID of the channel
2065 int ch_last_msg_id; // ID of the last message
Bram Moolenaar77073442016-02-13 23:23:53 +01002066
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002067 chanpart_T ch_part[PART_COUNT]; // info for socket, out, err and in
2068 int ch_write_text_mode; // write buffer lines with CR, not NL
Bram Moolenaar6463ca22016-02-13 17:04:46 +01002069
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002070 char *ch_hostname; // only for socket, allocated
2071 int ch_port; // only for socket
Bram Moolenaar580984e2016-03-20 21:17:13 +01002072
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002073 int ch_to_be_closed; // bitset of readable fds to be closed.
2074 // When all readable fds have been closed,
2075 // set to (1 << PART_COUNT).
2076 int ch_to_be_freed; // When TRUE channel must be freed when it's
2077 // safe to invoke callbacks.
2078 int ch_error; // When TRUE an error was reported. Avoids
2079 // giving pages full of error messages when
2080 // the other side has exited, only mention the
2081 // first error until the connection works
2082 // again.
Bram Moolenaar16eb4f82016-02-14 23:02:34 +01002083
Bram Moolenaar4e221c92016-02-23 13:20:22 +01002084 void (*ch_nb_close_cb)(void);
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002085 // callback for Netbeans when channel is
2086 // closed
Bram Moolenaar6463ca22016-02-13 17:04:46 +01002087
Bram Moolenaar4f974752019-02-17 17:44:42 +01002088#ifdef MSWIN
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002089 int ch_named_pipe; // using named pipe instead of pty
Bram Moolenaar2dc9d262017-09-08 14:39:30 +02002090#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002091 callback_T ch_callback; // call when any msg is not handled
2092 callback_T ch_close_cb; // call when channel is closed
Bram Moolenaar958dc692016-12-01 15:34:12 +01002093 int ch_drop_never;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002094 int ch_keep_open; // do not close on read error
Bram Moolenaar0b146882018-09-06 16:27:24 +02002095 int ch_nonblock;
Bram Moolenaar6463ca22016-02-13 17:04:46 +01002096
Bram Moolenaaraa5df7e2019-02-03 14:53:10 +01002097 job_T *ch_job; // Job that uses this channel; this does not
2098 // count as a reference to avoid a circular
2099 // reference, the job refers to the channel.
2100 int ch_job_killed; // TRUE when there was a job and it was killed
2101 // or we know it died.
2102 int ch_anonymous_pipe; // ConPTY
2103 int ch_killing; // TerminateJobObject() was called
Bram Moolenaar77073442016-02-13 23:23:53 +01002104
Bram Moolenaaraa5df7e2019-02-03 14:53:10 +01002105 int ch_refcount; // reference count
Bram Moolenaar107e1ee2016-04-08 17:07:19 +02002106 int ch_copyID;
Bram Moolenaar6463ca22016-02-13 17:04:46 +01002107};
2108
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002109#define JO_MODE 0x0001 // channel mode
2110#define JO_IN_MODE 0x0002 // stdin mode
2111#define JO_OUT_MODE 0x0004 // stdout mode
2112#define JO_ERR_MODE 0x0008 // stderr mode
2113#define JO_CALLBACK 0x0010 // channel callback
2114#define JO_OUT_CALLBACK 0x0020 // stdout callback
2115#define JO_ERR_CALLBACK 0x0040 // stderr callback
2116#define JO_CLOSE_CALLBACK 0x0080 // "close_cb"
2117#define JO_WAITTIME 0x0100 // only for ch_open()
2118#define JO_TIMEOUT 0x0200 // all timeouts
2119#define JO_OUT_TIMEOUT 0x0400 // stdout timeouts
2120#define JO_ERR_TIMEOUT 0x0800 // stderr timeouts
2121#define JO_PART 0x1000 // "part"
2122#define JO_ID 0x2000 // "id"
2123#define JO_STOPONEXIT 0x4000 // "stoponexit"
2124#define JO_EXIT_CB 0x8000 // "exit_cb"
2125#define JO_OUT_IO 0x10000 // "out_io"
2126#define JO_ERR_IO 0x20000 // "err_io" (JO_OUT_IO << 1)
2127#define JO_IN_IO 0x40000 // "in_io" (JO_OUT_IO << 2)
2128#define JO_OUT_NAME 0x80000 // "out_name"
2129#define JO_ERR_NAME 0x100000 // "err_name" (JO_OUT_NAME << 1)
2130#define JO_IN_NAME 0x200000 // "in_name" (JO_OUT_NAME << 2)
2131#define JO_IN_TOP 0x400000 // "in_top"
2132#define JO_IN_BOT 0x800000 // "in_bot"
2133#define JO_OUT_BUF 0x1000000 // "out_buf"
2134#define JO_ERR_BUF 0x2000000 // "err_buf" (JO_OUT_BUF << 1)
2135#define JO_IN_BUF 0x4000000 // "in_buf" (JO_OUT_BUF << 2)
2136#define JO_CHANNEL 0x8000000 // "channel"
2137#define JO_BLOCK_WRITE 0x10000000 // "block_write"
2138#define JO_OUT_MODIFIABLE 0x20000000 // "out_modifiable"
2139#define JO_ERR_MODIFIABLE 0x40000000 // "err_modifiable" (JO_OUT_ << 1)
Bram Moolenaar8b877ac2016-03-28 19:16:20 +02002140#define JO_ALL 0x7fffffff
Bram Moolenaar40ea1da2016-02-19 22:33:35 +01002141
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002142#define JO2_OUT_MSG 0x0001 // "out_msg"
2143#define JO2_ERR_MSG 0x0002 // "err_msg" (JO_OUT_ << 1)
2144#define JO2_TERM_NAME 0x0004 // "term_name"
2145#define JO2_TERM_FINISH 0x0008 // "term_finish"
2146#define JO2_ENV 0x0010 // "env"
2147#define JO2_CWD 0x0020 // "cwd"
2148#define JO2_TERM_ROWS 0x0040 // "term_rows"
2149#define JO2_TERM_COLS 0x0080 // "term_cols"
2150#define JO2_VERTICAL 0x0100 // "vertical"
2151#define JO2_CURWIN 0x0200 // "curwin"
2152#define JO2_HIDDEN 0x0400 // "hidden"
2153#define JO2_TERM_OPENCMD 0x0800 // "term_opencmd"
2154#define JO2_EOF_CHARS 0x1000 // "eof_chars"
2155#define JO2_NORESTORE 0x2000 // "norestore"
2156#define JO2_TERM_KILL 0x4000 // "term_kill"
2157#define JO2_ANSI_COLORS 0x8000 // "ansi_colors"
2158#define JO2_TTY_TYPE 0x10000 // "tty_type"
2159#define JO2_BUFNR 0x20000 // "bufnr"
Bram Moolenaard2842ea2019-09-26 23:08:54 +02002160#define JO2_TERM_API 0x40000 // "term_api"
Bram Moolenaar83d47902020-03-26 20:34:00 +01002161#define JO2_TERM_HIGHLIGHT 0x80000 // "highlight"
Bram Moolenaar169ebb02016-09-07 23:32:23 +02002162
Bram Moolenaarb6b52522016-02-20 23:30:07 +01002163#define JO_MODE_ALL (JO_MODE + JO_IN_MODE + JO_OUT_MODE + JO_ERR_MODE)
Bram Moolenaar4e221c92016-02-23 13:20:22 +01002164#define JO_CB_ALL \
2165 (JO_CALLBACK + JO_OUT_CALLBACK + JO_ERR_CALLBACK + JO_CLOSE_CALLBACK)
Bram Moolenaarb6b52522016-02-20 23:30:07 +01002166#define JO_TIMEOUT_ALL (JO_TIMEOUT + JO_OUT_TIMEOUT + JO_ERR_TIMEOUT)
2167
Bram Moolenaar9a6e33a2016-02-16 19:25:12 +01002168/*
Bram Moolenaar910b8aa2016-02-16 21:03:07 +01002169 * Options for job and channel commands.
Bram Moolenaar9a6e33a2016-02-16 19:25:12 +01002170 */
2171typedef struct
2172{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002173 int jo_set; // JO_ bits for values that were set
2174 int jo_set2; // JO2_ bits for values that were set
Bram Moolenaar40ea1da2016-02-19 22:33:35 +01002175
2176 ch_mode_T jo_mode;
Bram Moolenaarb6b52522016-02-20 23:30:07 +01002177 ch_mode_T jo_in_mode;
2178 ch_mode_T jo_out_mode;
2179 ch_mode_T jo_err_mode;
Bram Moolenaar0b146882018-09-06 16:27:24 +02002180 int jo_noblock;
Bram Moolenaar187db502016-02-27 14:44:26 +01002181
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002182 job_io_T jo_io[4]; // PART_OUT, PART_ERR, PART_IN
Bram Moolenaar187db502016-02-27 14:44:26 +01002183 char_u jo_io_name_buf[4][NUMBUFLEN];
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002184 char_u *jo_io_name[4]; // not allocated!
Bram Moolenaar29fd0382016-03-09 23:14:07 +01002185 int jo_io_buf[4];
Bram Moolenaar5a1feb82017-07-22 18:04:08 +02002186 int jo_pty;
Bram Moolenaar9f5842e2016-05-29 16:17:08 +02002187 int jo_modifiable[4];
Bram Moolenaar169ebb02016-09-07 23:32:23 +02002188 int jo_message[4];
Bram Moolenaarde279892016-03-11 22:19:44 +01002189 channel_T *jo_channel;
Bram Moolenaar187db502016-02-27 14:44:26 +01002190
Bram Moolenaar014069a2016-03-03 22:51:40 +01002191 linenr_T jo_in_top;
2192 linenr_T jo_in_bot;
2193
Bram Moolenaar3a97bb32019-06-01 13:28:35 +02002194 callback_T jo_callback;
2195 callback_T jo_out_cb;
2196 callback_T jo_err_cb;
2197 callback_T jo_close_cb;
2198 callback_T jo_exit_cb;
Bram Moolenaar958dc692016-12-01 15:34:12 +01002199 int jo_drop_never;
Bram Moolenaar40ea1da2016-02-19 22:33:35 +01002200 int jo_waittime;
2201 int jo_timeout;
Bram Moolenaarb6b52522016-02-20 23:30:07 +01002202 int jo_out_timeout;
2203 int jo_err_timeout;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002204 int jo_block_write; // for testing only
Bram Moolenaar6f3a5442016-02-20 19:56:13 +01002205 int jo_part;
2206 int jo_id;
Bram Moolenaar21109272020-01-30 16:27:20 +01002207 char_u jo_stoponexit_buf[NUMBUFLEN];
Bram Moolenaar65edff82016-02-21 16:40:11 +01002208 char_u *jo_stoponexit;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002209 dict_T *jo_env; // environment variables
Bram Moolenaar05aafed2017-08-11 19:12:11 +02002210 char_u jo_cwd_buf[NUMBUFLEN];
2211 char_u *jo_cwd;
Bram Moolenaar58556cd2017-07-20 23:04:46 +02002212
2213#ifdef FEAT_TERMINAL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002214 // when non-zero run the job in a terminal window of this size
Bram Moolenaar58556cd2017-07-20 23:04:46 +02002215 int jo_term_rows;
2216 int jo_term_cols;
Bram Moolenaar08d384f2017-08-11 21:51:23 +02002217 int jo_vertical;
Bram Moolenaarda43b612017-08-11 22:27:50 +02002218 int jo_curwin;
Bram Moolenaar87abab92019-06-03 21:14:59 +02002219 buf_T *jo_bufnr_buf;
Bram Moolenaar8cad9302017-08-12 14:32:32 +02002220 int jo_hidden;
Bram Moolenaar4d8bac82018-03-09 21:33:34 +01002221 int jo_term_norestore;
Bram Moolenaar21109272020-01-30 16:27:20 +01002222 char_u jo_term_name_buf[NUMBUFLEN];
Bram Moolenaar78712a72017-08-05 14:50:12 +02002223 char_u *jo_term_name;
Bram Moolenaar21109272020-01-30 16:27:20 +01002224 char_u jo_term_opencmd_buf[NUMBUFLEN];
Bram Moolenaar37c45832017-08-12 16:01:04 +02002225 char_u *jo_term_opencmd;
Bram Moolenaardd693ce2017-08-10 23:15:19 +02002226 int jo_term_finish;
Bram Moolenaar21109272020-01-30 16:27:20 +01002227 char_u jo_eof_chars_buf[NUMBUFLEN];
Bram Moolenaar3346cc42017-09-02 14:54:21 +02002228 char_u *jo_eof_chars;
Bram Moolenaar21109272020-01-30 16:27:20 +01002229 char_u jo_term_kill_buf[NUMBUFLEN];
Bram Moolenaar25cdd9c2018-03-10 20:28:12 +01002230 char_u *jo_term_kill;
Bram Moolenaarf59c6e82018-04-10 15:59:11 +02002231# if defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS)
2232 long_u jo_ansi_colors[16];
2233# endif
Bram Moolenaar83d47902020-03-26 20:34:00 +01002234 char_u jo_term_highlight_buf[NUMBUFLEN];
2235 char_u *jo_term_highlight;
Bram Moolenaarc6ddce32019-02-08 12:47:03 +01002236 int jo_tty_type; // first character of "tty_type"
Bram Moolenaard2842ea2019-09-26 23:08:54 +02002237 char_u jo_term_api_buf[NUMBUFLEN];
Bram Moolenaar21109272020-01-30 16:27:20 +01002238 char_u *jo_term_api;
Bram Moolenaar58556cd2017-07-20 23:04:46 +02002239#endif
Bram Moolenaar9a6e33a2016-02-16 19:25:12 +01002240} jobopt_T;
2241
Bram Moolenaar6d2399b2019-05-11 19:14:16 +02002242#ifdef FEAT_EVAL
2243/*
2244 * Structure used for listeners added with listener_add().
2245 */
2246typedef struct listener_S listener_T;
2247struct listener_S
2248{
2249 listener_T *lr_next;
2250 int lr_id;
Bram Moolenaar3a97bb32019-06-01 13:28:35 +02002251 callback_T lr_callback;
Bram Moolenaar6d2399b2019-05-11 19:14:16 +02002252};
2253#endif
Bram Moolenaar6463ca22016-02-13 17:04:46 +01002254
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002255/*
2256 * structure used for explicit stack while garbage collecting hash tables
2257 */
Bram Moolenaar2459a5e2015-02-03 12:55:18 +01002258typedef struct ht_stack_S
2259{
2260 hashtab_T *ht;
2261 struct ht_stack_S *prev;
2262} ht_stack_T;
2263
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002264/*
2265 * structure used for explicit stack while garbage collecting lists
2266 */
Bram Moolenaar2459a5e2015-02-03 12:55:18 +01002267typedef struct list_stack_S
2268{
2269 list_T *list;
2270 struct list_stack_S *prev;
2271} list_stack_T;
2272
Bram Moolenaar45e18cb2019-04-28 18:05:35 +02002273/*
2274 * Structure used for iterating over dictionary items.
2275 * Initialize with dict_iterate_start().
2276 */
2277typedef struct
2278{
2279 long_u dit_todo;
2280 hashitem_T *dit_hi;
2281} dict_iterator_T;
2282
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002283// values for b_syn_spell: what to do with toplevel text
2284#define SYNSPL_DEFAULT 0 // spell check if @Spell not defined
2285#define SYNSPL_TOP 1 // spell check toplevel text
2286#define SYNSPL_NOTOP 2 // don't spell check toplevel text
Bram Moolenaarce0842a2005-07-18 21:58:11 +00002287
Bram Moolenaare35a52a2020-05-31 19:48:53 +02002288// values for b_syn_foldlevel: how to compute foldlevel on a line
2289#define SYNFLD_START 0 // use level of item at start of line
2290#define SYNFLD_MINIMUM 1 // use lowest local minimum level on line
2291
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002292// avoid #ifdefs for when b_spell is not available
Bram Moolenaarb9a02fc2006-03-12 22:08:12 +00002293#ifdef FEAT_SPELL
Bram Moolenaar4770d092006-01-12 23:22:24 +00002294# define B_SPELL(buf) ((buf)->b_spell)
2295#else
2296# define B_SPELL(buf) (0)
2297#endif
2298
Bram Moolenaard12f5c12006-01-25 22:10:52 +00002299typedef struct qf_info_S qf_info_T;
Bram Moolenaardcaf10e2005-01-21 11:55:25 +00002300
Bram Moolenaarf7512552013-06-06 14:55:19 +02002301#ifdef FEAT_PROFILE
Bram Moolenaar8a7f5a22013-06-06 14:01:46 +02002302/*
2303 * Used for :syntime: timing of executing a syntax pattern.
2304 */
2305typedef struct {
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002306 proftime_T total; // total time used
2307 proftime_T slowest; // time of slowest call
2308 long count; // nr of times used
2309 long match; // nr of times matched
Bram Moolenaar8a7f5a22013-06-06 14:01:46 +02002310} syn_time_T;
2311#endif
2312
Bram Moolenaar51fe3b12019-05-26 20:10:06 +02002313typedef struct timer_S timer_T;
2314struct timer_S
2315{
2316 long tr_id;
2317#ifdef FEAT_TIMERS
2318 timer_T *tr_next;
2319 timer_T *tr_prev;
Bram Moolenaar3a97bb32019-06-01 13:28:35 +02002320 proftime_T tr_due; // when the callback is to be invoked
2321 char tr_firing; // when TRUE callback is being called
2322 char tr_paused; // when TRUE callback is not invoked
2323 int tr_repeat; // number of times to repeat, -1 forever
2324 long tr_interval; // msec
2325 callback_T tr_callback;
Bram Moolenaar51fe3b12019-05-26 20:10:06 +02002326 int tr_emsg_count;
2327#endif
2328};
2329
Bram Moolenaar8f4ac012014-08-10 13:38:34 +02002330#ifdef FEAT_CRYPT
2331/*
2332 * Structure to hold the type of encryption and the state of encryption or
2333 * decryption.
2334 */
2335typedef struct {
2336 int method_nr;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002337 void *method_state; // method-specific state information
Bram Moolenaar8f4ac012014-08-10 13:38:34 +02002338} cryptstate_T;
2339
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002340// values for method_nr
Bram Moolenaar8f4ac012014-08-10 13:38:34 +02002341# define CRYPT_M_ZIP 0
2342# define CRYPT_M_BF 1
2343# define CRYPT_M_BF2 2
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002344# define CRYPT_M_COUNT 3 // number of crypt methods
Bram Moolenaar987411d2019-01-18 22:48:34 +01002345
2346// Currently all crypt methods work inplace. If one is added that isn't then
2347// define this.
2348// # define CRYPT_NOT_INPLACE 1
Bram Moolenaar8f4ac012014-08-10 13:38:34 +02002349#endif
2350
Bram Moolenaar05ad5ff2019-11-30 22:48:27 +01002351#ifdef FEAT_PROP_POPUP
Bram Moolenaarac1f1bc2019-05-30 21:24:26 +02002352typedef enum {
2353 POPPOS_BOTLEFT,
2354 POPPOS_TOPLEFT,
2355 POPPOS_BOTRIGHT,
2356 POPPOS_TOPRIGHT,
Bram Moolenaar4dd8fe02019-11-09 15:33:31 +01002357 POPPOS_CENTER,
2358 POPPOS_NONE
Bram Moolenaarac1f1bc2019-05-30 21:24:26 +02002359} poppos_T;
Bram Moolenaar6c009a32019-06-08 16:06:28 +02002360
Bram Moolenaar2e62b562019-06-30 18:07:00 +02002361typedef enum {
2362 POPCLOSE_NONE,
2363 POPCLOSE_BUTTON,
2364 POPCLOSE_CLICK
2365} popclose_T;
2366
Bram Moolenaar68d48f42019-06-12 22:42:41 +02002367# define POPUPWIN_DEFAULT_ZINDEX 50
2368# define POPUPMENU_ZINDEX 100
Bram Moolenaara42d9452019-06-15 21:46:30 +02002369# define POPUPWIN_DIALOG_ZINDEX 200
2370# define POPUPWIN_NOTIFICATION_ZINDEX 300
Bram Moolenaarac1f1bc2019-05-30 21:24:26 +02002371#endif
Bram Moolenaar8f4ac012014-08-10 13:38:34 +02002372
Bram Moolenaar362ce482012-06-06 19:02:45 +02002373/*
2374 * These are items normally related to a buffer. But when using ":ownsyntax"
2375 * a window may have its own instance.
2376 */
Bram Moolenaar860cae12010-06-05 23:22:07 +02002377typedef struct {
2378#ifdef FEAT_SYN_HL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002379 hashtab_T b_keywtab; // syntax keywords hash table
2380 hashtab_T b_keywtab_ic; // idem, ignore case
2381 int b_syn_error; // TRUE when error occurred in HL
Bram Moolenaar06f1ed22017-06-18 22:41:03 +02002382# ifdef FEAT_RELTIME
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002383 int b_syn_slow; // TRUE when 'redrawtime' reached
Bram Moolenaar06f1ed22017-06-18 22:41:03 +02002384# endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002385 int b_syn_ic; // ignore case for :syn cmds
Bram Moolenaare35a52a2020-05-31 19:48:53 +02002386 int b_syn_foldlevel; // how to compute foldlevel on a line
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002387 int b_syn_spell; // SYNSPL_ values
2388 garray_T b_syn_patterns; // table for syntax patterns
2389 garray_T b_syn_clusters; // table for syntax clusters
2390 int b_spell_cluster_id; // @Spell cluster ID or 0
2391 int b_nospell_cluster_id; // @NoSpell cluster ID or 0
2392 int b_syn_containedin; // TRUE when there is an item with a
2393 // "containedin" argument
2394 int b_syn_sync_flags; // flags about how to sync
2395 short b_syn_sync_id; // group to sync on
2396 long b_syn_sync_minlines; // minimal sync lines offset
2397 long b_syn_sync_maxlines; // maximal sync lines offset
2398 long b_syn_sync_linebreaks; // offset for multi-line pattern
2399 char_u *b_syn_linecont_pat; // line continuation pattern
2400 regprog_T *b_syn_linecont_prog; // line continuation program
Bram Moolenaarf7512552013-06-06 14:55:19 +02002401#ifdef FEAT_PROFILE
Bram Moolenaar8a7f5a22013-06-06 14:01:46 +02002402 syn_time_T b_syn_linecont_time;
2403#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002404 int b_syn_linecont_ic; // ignore-case flag for above
2405 int b_syn_topgrp; // for ":syntax include"
Bram Moolenaar860cae12010-06-05 23:22:07 +02002406# ifdef FEAT_CONCEAL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002407 int b_syn_conceal; // auto-conceal for :syn cmds
Bram Moolenaar860cae12010-06-05 23:22:07 +02002408# endif
2409# ifdef FEAT_FOLDING
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002410 int b_syn_folditems; // number of patterns with the HL_FOLD
2411 // flag set
Bram Moolenaar860cae12010-06-05 23:22:07 +02002412# endif
Bram Moolenaar8765a4a2010-07-27 22:41:43 +02002413 /*
2414 * b_sst_array[] contains the state stack for a number of lines, for the
2415 * start of that line (col == 0). This avoids having to recompute the
2416 * syntax state too often.
2417 * b_sst_array[] is allocated to hold the state for all displayed lines,
2418 * and states for 1 out of about 20 other lines.
2419 * b_sst_array pointer to an array of synstate_T
2420 * b_sst_len number of entries in b_sst_array[]
2421 * b_sst_first pointer to first used entry in b_sst_array[] or NULL
2422 * b_sst_firstfree pointer to first free entry in b_sst_array[] or NULL
2423 * b_sst_freecount number of free entries in b_sst_array[]
2424 * b_sst_check_lnum entries after this lnum need to be checked for
2425 * validity (MAXLNUM means no check needed)
2426 */
Bram Moolenaar860cae12010-06-05 23:22:07 +02002427 synstate_T *b_sst_array;
2428 int b_sst_len;
2429 synstate_T *b_sst_first;
2430 synstate_T *b_sst_firstfree;
2431 int b_sst_freecount;
2432 linenr_T b_sst_check_lnum;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002433 short_u b_sst_lasttick; // last display tick
2434#endif // FEAT_SYN_HL
Bram Moolenaar860cae12010-06-05 23:22:07 +02002435
2436#ifdef FEAT_SPELL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002437 // for spell checking
2438 garray_T b_langp; // list of pointers to slang_T, see spell.c
2439 char_u b_spell_ismw[256]; // flags: is midword char
2440 char_u *b_spell_ismw_mb; // multi-byte midword chars
2441 char_u *b_p_spc; // 'spellcapcheck'
2442 regprog_T *b_cap_prog; // program for 'spellcapcheck'
2443 char_u *b_p_spf; // 'spellfile'
2444 char_u *b_p_spl; // 'spelllang'
Bram Moolenaar215f49c2020-06-10 22:12:04 +02002445 char_u *b_p_spo; // 'spelloptions'
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002446 int b_cjk; // all CJK letters as OK
Bram Moolenaar860cae12010-06-05 23:22:07 +02002447#endif
Bram Moolenaar8765a4a2010-07-27 22:41:43 +02002448#if !defined(FEAT_SYN_HL) && !defined(FEAT_SPELL)
2449 int dummy;
2450#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002451 char_u b_syn_chartab[32]; // syntax iskeyword option
2452 char_u *b_syn_isk; // iskeyword option
Bram Moolenaar860cae12010-06-05 23:22:07 +02002453} synblock_T;
2454
2455
Bram Moolenaar071d4272004-06-13 20:20:40 +00002456/*
2457 * buffer: structure that holds information about one file
2458 *
2459 * Several windows can share a single Buffer
2460 * A buffer is unallocated if there is no memfile for it.
2461 * A buffer is new if the associated file has never been loaded yet.
2462 */
2463
Bram Moolenaar071d4272004-06-13 20:20:40 +00002464struct file_buffer
2465{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002466 memline_T b_ml; // associated memline (also contains line
2467 // count)
Bram Moolenaar071d4272004-06-13 20:20:40 +00002468
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002469 buf_T *b_next; // links in list of buffers
Bram Moolenaar071d4272004-06-13 20:20:40 +00002470 buf_T *b_prev;
2471
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002472 int b_nwindows; // nr of windows open on this buffer
Bram Moolenaar071d4272004-06-13 20:20:40 +00002473
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002474 int b_flags; // various BF_ flags
2475 int b_locked; // Buffer is being closed or referenced, don't
2476 // let autocommands wipe it out.
Bram Moolenaar071d4272004-06-13 20:20:40 +00002477
2478 /*
2479 * b_ffname has the full path of the file (NULL for no name).
2480 * b_sfname is the name as the user typed it (or NULL).
2481 * b_fname is the same as b_sfname, unless ":cd" has been done,
2482 * then it is the same as b_ffname (NULL for no name).
2483 */
Bram Moolenaar3d6014f2018-10-11 19:27:47 +02002484 char_u *b_ffname; // full path file name, allocated
2485 char_u *b_sfname; // short file name, allocated, may be equal to
2486 // b_ffname
2487 char_u *b_fname; // current file name, points to b_ffname or
2488 // b_sfname
Bram Moolenaar071d4272004-06-13 20:20:40 +00002489
2490#ifdef UNIX
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002491 int b_dev_valid; // TRUE when b_dev has a valid number
2492 dev_t b_dev; // device number
2493 ino_t b_ino; // inode number
Bram Moolenaar071d4272004-06-13 20:20:40 +00002494#endif
2495#ifdef FEAT_CW_EDITOR
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002496 FSSpec b_FSSpec; // MacOS File Identification
Bram Moolenaar071d4272004-06-13 20:20:40 +00002497#endif
2498#ifdef VMS
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002499 char b_fab_rfm; // Record format
2500 char b_fab_rat; // Record attribute
2501 unsigned int b_fab_mrs; // Max record size
Bram Moolenaar071d4272004-06-13 20:20:40 +00002502#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002503 int b_fnum; // buffer number for this file.
Bram Moolenaar480778b2016-07-14 22:09:39 +02002504 char_u b_key[VIM_SIZEOF_INT * 2 + 1];
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002505 // key used for buf_hashtab, holds b_fnum as
2506 // hex string
Bram Moolenaar071d4272004-06-13 20:20:40 +00002507
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002508 int b_changed; // 'modified': Set to TRUE if something in the
2509 // file has been changed and not written out.
2510 dictitem16_T b_ct_di; // holds the b:changedtick value in
2511 // b_ct_di.di_tv.vval.v_number;
2512 // incremented for each change, also for undo
Bram Moolenaar95c526e2017-02-25 14:59:34 +01002513#define CHANGEDTICK(buf) ((buf)->b_ct_di.di_tv.vval.v_number)
Bram Moolenaar071d4272004-06-13 20:20:40 +00002514
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002515 varnumber_T b_last_changedtick; // b:changedtick when TextChanged or
2516 // TextChangedI was last triggered.
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002517 varnumber_T b_last_changedtick_pum; // b:changedtick when TextChangedP was
2518 // last triggered.
Bram Moolenaar5a093432018-02-10 18:15:19 +01002519
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002520 int b_saving; // Set to TRUE if we are in the middle of
2521 // saving the buffer.
Bram Moolenaar071d4272004-06-13 20:20:40 +00002522
2523 /*
2524 * Changes to a buffer require updating of the display. To minimize the
2525 * work, remember changes made and update everything at once.
2526 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002527 int b_mod_set; // TRUE when there are changes since the last
2528 // time the display was updated
2529 linenr_T b_mod_top; // topmost lnum that was changed
2530 linenr_T b_mod_bot; // lnum below last changed line, AFTER the
2531 // change
2532 long b_mod_xlines; // number of extra buffer lines inserted;
2533 // negative when lines were deleted
Bram Moolenaar071d4272004-06-13 20:20:40 +00002534
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002535 wininfo_T *b_wininfo; // list of last used info for each window
Bram Moolenaar071d4272004-06-13 20:20:40 +00002536
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002537 long b_mtime; // last change time of original file
2538 long b_mtime_read; // last change time when reading
2539 off_T b_orig_size; // size of original file in bytes
2540 int b_orig_mode; // mode of original file
Bram Moolenaarab9c89b2016-07-03 17:47:26 +02002541#ifdef FEAT_VIMINFO
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002542 time_T b_last_used; // time when the buffer was last used; used
2543 // for viminfo
Bram Moolenaarab9c89b2016-07-03 17:47:26 +02002544#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00002545
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002546 pos_T b_namedm[NMARKS]; // current named marks (mark.c)
Bram Moolenaar071d4272004-06-13 20:20:40 +00002547
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002548 // These variables are set when VIsual_active becomes FALSE
Bram Moolenaara23ccb82006-02-27 00:08:02 +00002549 visualinfo_T b_visual;
Bram Moolenaarf7ff6e82014-03-23 15:13:05 +01002550#ifdef FEAT_EVAL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002551 int b_visual_mode_eval; // b_visual.vi_mode for visualmode()
Bram Moolenaar071d4272004-06-13 20:20:40 +00002552#endif
2553
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002554 pos_T b_last_cursor; // cursor position when last unloading this
2555 // buffer
2556 pos_T b_last_insert; // where Insert mode was left
2557 pos_T b_last_change; // position of last change: '. mark
Bram Moolenaar071d4272004-06-13 20:20:40 +00002558
2559#ifdef FEAT_JUMPLIST
2560 /*
2561 * the changelist contains old change positions
2562 */
2563 pos_T b_changelist[JUMPLISTSIZE];
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002564 int b_changelistlen; // number of active entries
2565 int b_new_change; // set by u_savecommon()
Bram Moolenaar071d4272004-06-13 20:20:40 +00002566#endif
2567
2568 /*
2569 * Character table, only used in charset.c for 'iskeyword'
2570 * 32 bytes of 8 bits: 1 bit per character 0-255.
2571 */
2572 char_u b_chartab[32];
2573
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002574 // Table used for mappings local to a buffer.
Bram Moolenaar071d4272004-06-13 20:20:40 +00002575 mapblock_T *(b_maphash[256]);
2576
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002577 // First abbreviation local to a buffer.
Bram Moolenaar071d4272004-06-13 20:20:40 +00002578 mapblock_T *b_first_abbr;
Bram Moolenaarb66bab32019-08-01 14:28:24 +02002579
Bram Moolenaarac9fb182019-04-27 13:04:13 +02002580 // User commands local to the buffer.
Bram Moolenaar071d4272004-06-13 20:20:40 +00002581 garray_T b_ucmds;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002582 // start and end of an operator, also used for '[ and ']
Bram Moolenaar071d4272004-06-13 20:20:40 +00002583 pos_T b_op_start;
Bram Moolenaar4aea03e2019-09-25 22:37:17 +02002584 pos_T b_op_start_orig; // used for Insstart_orig
Bram Moolenaar071d4272004-06-13 20:20:40 +00002585 pos_T b_op_end;
2586
2587#ifdef FEAT_VIMINFO
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002588 int b_marks_read; // Have we read viminfo marks yet?
Bram Moolenaar071d4272004-06-13 20:20:40 +00002589#endif
2590
2591 /*
2592 * The following only used in undo.c.
2593 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002594 u_header_T *b_u_oldhead; // pointer to oldest header
2595 u_header_T *b_u_newhead; // pointer to newest header; may not be valid
2596 // if b_u_curhead is not NULL
2597 u_header_T *b_u_curhead; // pointer to current header
2598 int b_u_numhead; // current number of headers
2599 int b_u_synced; // entry lists are synced
2600 long b_u_seq_last; // last used undo sequence number
2601 long b_u_save_nr_last; // counter for last file write
2602 long b_u_seq_cur; // hu_seq of header below which we are now
2603 time_T b_u_time_cur; // uh_time of header below which we are now
2604 long b_u_save_nr_cur; // file write nr after which we are now
Bram Moolenaar071d4272004-06-13 20:20:40 +00002605
2606 /*
2607 * variables for "U" command in undo.c
2608 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002609 undoline_T b_u_line_ptr; // saved line for "U" command
2610 linenr_T b_u_line_lnum; // line number of line in u_line
2611 colnr_T b_u_line_colnr; // optional column number
Bram Moolenaar071d4272004-06-13 20:20:40 +00002612
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002613 int b_scanned; // ^N/^P have scanned this buffer
Bram Moolenaar071d4272004-06-13 20:20:40 +00002614
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002615 // flags for use of ":lmap" and IM control
2616 long b_p_iminsert; // input mode for insert
2617 long b_p_imsearch; // input mode for search
2618#define B_IMODE_USE_INSERT -1 // Use b_p_iminsert value for search
2619#define B_IMODE_NONE 0 // Input via none
2620#define B_IMODE_LMAP 1 // Input via langmap
2621#define B_IMODE_IM 2 // Input via input method
Bram Moolenaar6315a9a2017-11-25 15:20:02 +01002622#define B_IMODE_LAST 2
Bram Moolenaar071d4272004-06-13 20:20:40 +00002623
2624#ifdef FEAT_KEYMAP
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002625 short b_kmap_state; // using "lmap" mappings
2626# define KEYMAP_INIT 1 // 'keymap' was set, call keymap_init()
2627# define KEYMAP_LOADED 2 // 'keymap' mappings have been loaded
2628 garray_T b_kmap_ga; // the keymap table
Bram Moolenaar071d4272004-06-13 20:20:40 +00002629#endif
2630
2631 /*
2632 * Options local to a buffer.
2633 * They are here because their value depends on the type of file
2634 * or contents of the file being edited.
2635 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002636 int b_p_initialized; // set when options initialized
Bram Moolenaar071d4272004-06-13 20:20:40 +00002637
Bram Moolenaar5e3cb7e2006-02-27 23:58:35 +00002638#ifdef FEAT_EVAL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002639 sctx_T b_p_script_ctx[BV_COUNT]; // SCTXs for buffer-local options
Bram Moolenaar5e3cb7e2006-02-27 23:58:35 +00002640#endif
2641
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002642 int b_p_ai; // 'autoindent'
2643 int b_p_ai_nopaste; // b_p_ai saved for paste mode
2644 char_u *b_p_bkc; // 'backupcopy'
2645 unsigned b_bkc_flags; // flags for 'backupcopy'
2646 int b_p_ci; // 'copyindent'
2647 int b_p_bin; // 'binary'
2648 int b_p_bomb; // 'bomb'
2649 char_u *b_p_bh; // 'bufhidden'
2650 char_u *b_p_bt; // 'buftype'
Bram Moolenaar1f2903c2017-07-23 19:51:01 +02002651#ifdef FEAT_QUICKFIX
Bram Moolenaarc1542742016-07-20 21:44:37 +02002652#define BUF_HAS_QF_ENTRY 1
2653#define BUF_HAS_LL_ENTRY 2
Bram Moolenaar2f095a42016-06-03 19:05:49 +02002654 int b_has_qf_entry;
Bram Moolenaar071d4272004-06-13 20:20:40 +00002655#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002656 int b_p_bl; // 'buflisted'
Bram Moolenaar071d4272004-06-13 20:20:40 +00002657#ifdef FEAT_CINDENT
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002658 int b_p_cin; // 'cindent'
2659 char_u *b_p_cino; // 'cinoptions'
2660 char_u *b_p_cink; // 'cinkeys'
Bram Moolenaar071d4272004-06-13 20:20:40 +00002661#endif
2662#if defined(FEAT_CINDENT) || defined(FEAT_SMARTINDENT)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002663 char_u *b_p_cinw; // 'cinwords'
Bram Moolenaar071d4272004-06-13 20:20:40 +00002664#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002665 char_u *b_p_com; // 'comments'
Bram Moolenaar071d4272004-06-13 20:20:40 +00002666#ifdef FEAT_FOLDING
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002667 char_u *b_p_cms; // 'commentstring'
Bram Moolenaar071d4272004-06-13 20:20:40 +00002668#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002669 char_u *b_p_cpt; // 'complete'
Bram Moolenaarac3150d2019-07-28 16:36:39 +02002670#ifdef BACKSLASH_IN_FILENAME
2671 char_u *b_p_csl; // 'completeslash'
2672#endif
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +00002673#ifdef FEAT_COMPL_FUNC
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002674 char_u *b_p_cfu; // 'completefunc'
2675 char_u *b_p_ofu; // 'omnifunc'
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +00002676#endif
Bram Moolenaar45e18cb2019-04-28 18:05:35 +02002677#ifdef FEAT_EVAL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002678 char_u *b_p_tfu; // 'tagfunc'
Bram Moolenaar45e18cb2019-04-28 18:05:35 +02002679#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002680 int b_p_eol; // 'endofline'
2681 int b_p_fixeol; // 'fixendofline'
2682 int b_p_et; // 'expandtab'
2683 int b_p_et_nobin; // b_p_et saved for binary mode
2684 int b_p_et_nopaste; // b_p_et saved for paste mode
2685 char_u *b_p_fenc; // 'fileencoding'
2686 char_u *b_p_ff; // 'fileformat'
2687 char_u *b_p_ft; // 'filetype'
2688 char_u *b_p_fo; // 'formatoptions'
2689 char_u *b_p_flp; // 'formatlistpat'
2690 int b_p_inf; // 'infercase'
2691 char_u *b_p_isk; // 'iskeyword'
Bram Moolenaar071d4272004-06-13 20:20:40 +00002692#ifdef FEAT_FIND_ID
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002693 char_u *b_p_def; // 'define' local value
2694 char_u *b_p_inc; // 'include'
Bram Moolenaar071d4272004-06-13 20:20:40 +00002695# ifdef FEAT_EVAL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002696 char_u *b_p_inex; // 'includeexpr'
2697 long_u b_p_inex_flags; // flags for 'includeexpr'
Bram Moolenaar071d4272004-06-13 20:20:40 +00002698# endif
2699#endif
2700#if defined(FEAT_CINDENT) && defined(FEAT_EVAL)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002701 char_u *b_p_inde; // 'indentexpr'
2702 long_u b_p_inde_flags; // flags for 'indentexpr'
2703 char_u *b_p_indk; // 'indentkeys'
Bram Moolenaar071d4272004-06-13 20:20:40 +00002704#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002705 char_u *b_p_fp; // 'formatprg'
Bram Moolenaar1d2ba7f2006-02-14 22:29:30 +00002706#if defined(FEAT_EVAL)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002707 char_u *b_p_fex; // 'formatexpr'
2708 long_u b_p_fex_flags; // flags for 'formatexpr'
Bram Moolenaar1d2ba7f2006-02-14 22:29:30 +00002709#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00002710#ifdef FEAT_CRYPT
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002711 char_u *b_p_key; // 'key'
Bram Moolenaar071d4272004-06-13 20:20:40 +00002712#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002713 char_u *b_p_kp; // 'keywordprg'
Bram Moolenaar071d4272004-06-13 20:20:40 +00002714#ifdef FEAT_LISP
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002715 int b_p_lisp; // 'lisp'
Bram Moolenaar071d4272004-06-13 20:20:40 +00002716#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002717 char_u *b_p_menc; // 'makeencoding'
2718 char_u *b_p_mps; // 'matchpairs'
2719 int b_p_ml; // 'modeline'
2720 int b_p_ml_nobin; // b_p_ml saved for binary mode
2721 int b_p_ma; // 'modifiable'
2722 char_u *b_p_nf; // 'nrformats'
2723 int b_p_pi; // 'preserveindent'
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +00002724#ifdef FEAT_TEXTOBJ
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002725 char_u *b_p_qe; // 'quoteescape'
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +00002726#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002727 int b_p_ro; // 'readonly'
2728 long b_p_sw; // 'shiftwidth'
2729 int b_p_sn; // 'shortname'
Bram Moolenaar071d4272004-06-13 20:20:40 +00002730#ifdef FEAT_SMARTINDENT
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002731 int b_p_si; // 'smartindent'
Bram Moolenaar071d4272004-06-13 20:20:40 +00002732#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002733 long b_p_sts; // 'softtabstop'
2734 long b_p_sts_nopaste; // b_p_sts saved for paste mode
Bram Moolenaar071d4272004-06-13 20:20:40 +00002735#ifdef FEAT_SEARCHPATH
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002736 char_u *b_p_sua; // 'suffixesadd'
Bram Moolenaar071d4272004-06-13 20:20:40 +00002737#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002738 int b_p_swf; // 'swapfile'
Bram Moolenaar071d4272004-06-13 20:20:40 +00002739#ifdef FEAT_SYN_HL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002740 long b_p_smc; // 'synmaxcol'
2741 char_u *b_p_syn; // 'syntax'
Bram Moolenaarb9a02fc2006-03-12 22:08:12 +00002742#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002743 long b_p_ts; // 'tabstop'
2744 int b_p_tx; // 'textmode'
2745 long b_p_tw; // 'textwidth'
2746 long b_p_tw_nobin; // b_p_tw saved for binary mode
2747 long b_p_tw_nopaste; // b_p_tw saved for paste mode
2748 long b_p_wm; // 'wrapmargin'
2749 long b_p_wm_nobin; // b_p_wm saved for binary mode
2750 long b_p_wm_nopaste; // b_p_wm saved for paste mode
Bram Moolenaar04958cb2018-06-23 19:23:02 +02002751#ifdef FEAT_VARTABS
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002752 char_u *b_p_vsts; // 'varsofttabstop'
2753 int *b_p_vsts_array; // 'varsofttabstop' in internal format
2754 char_u *b_p_vsts_nopaste; // b_p_vsts saved for paste mode
2755 char_u *b_p_vts; // 'vartabstop'
2756 int *b_p_vts_array; // 'vartabstop' in internal format
Bram Moolenaar04958cb2018-06-23 19:23:02 +02002757#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00002758#ifdef FEAT_KEYMAP
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002759 char_u *b_p_keymap; // 'keymap'
Bram Moolenaar071d4272004-06-13 20:20:40 +00002760#endif
2761
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002762 /*
2763 * local values for options which are normally global
2764 */
Bram Moolenaar071d4272004-06-13 20:20:40 +00002765#ifdef FEAT_QUICKFIX
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002766 char_u *b_p_gp; // 'grepprg' local value
2767 char_u *b_p_mp; // 'makeprg' local value
2768 char_u *b_p_efm; // 'errorformat' local value
Bram Moolenaar071d4272004-06-13 20:20:40 +00002769#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002770 char_u *b_p_ep; // 'equalprg' local value
2771 char_u *b_p_path; // 'path' local value
2772 int b_p_ar; // 'autoread' local value
2773 char_u *b_p_tags; // 'tags' local value
2774 char_u *b_p_tc; // 'tagcase' local value
2775 unsigned b_tc_flags; // flags for 'tagcase'
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002776 char_u *b_p_dict; // 'dictionary' local value
2777 char_u *b_p_tsr; // 'thesaurus' local value
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002778 long b_p_ul; // 'undolevels' local value
Bram Moolenaar55debbe2010-05-23 23:34:36 +02002779#ifdef FEAT_PERSISTENT_UNDO
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002780 int b_p_udf; // 'undofile'
Bram Moolenaar55debbe2010-05-23 23:34:36 +02002781#endif
Bram Moolenaaraf6c1312014-03-12 18:55:58 +01002782#ifdef FEAT_LISP
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002783 char_u *b_p_lw; // 'lispwords' local value
Bram Moolenaaraf6c1312014-03-12 18:55:58 +01002784#endif
Bram Moolenaare1fc5152018-04-21 19:49:08 +02002785#ifdef FEAT_TERMINAL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002786 long b_p_twsl; // 'termwinscroll'
Bram Moolenaare1fc5152018-04-21 19:49:08 +02002787#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00002788
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002789 /*
2790 * end of buffer options
2791 */
Bram Moolenaar071d4272004-06-13 20:20:40 +00002792
Bram Moolenaar6bcbcc52013-11-05 07:13:41 +01002793#ifdef FEAT_CINDENT
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002794 // values set from b_p_cino
Bram Moolenaar6bcbcc52013-11-05 07:13:41 +01002795 int b_ind_level;
2796 int b_ind_open_imag;
2797 int b_ind_no_brace;
2798 int b_ind_first_open;
2799 int b_ind_open_extra;
2800 int b_ind_close_extra;
2801 int b_ind_open_left_imag;
2802 int b_ind_jump_label;
2803 int b_ind_case;
2804 int b_ind_case_code;
2805 int b_ind_case_break;
2806 int b_ind_param;
2807 int b_ind_func_type;
2808 int b_ind_comment;
2809 int b_ind_in_comment;
2810 int b_ind_in_comment2;
2811 int b_ind_cpp_baseclass;
2812 int b_ind_continuation;
2813 int b_ind_unclosed;
2814 int b_ind_unclosed2;
2815 int b_ind_unclosed_noignore;
2816 int b_ind_unclosed_wrapped;
2817 int b_ind_unclosed_whiteok;
2818 int b_ind_matching_paren;
2819 int b_ind_paren_prev;
2820 int b_ind_maxparen;
2821 int b_ind_maxcomment;
2822 int b_ind_scopedecl;
2823 int b_ind_scopedecl_code;
2824 int b_ind_java;
2825 int b_ind_js;
2826 int b_ind_keep_case_label;
2827 int b_ind_hash_comment;
2828 int b_ind_cpp_namespace;
2829 int b_ind_if_for_while;
Bram Moolenaar7720ba82017-03-08 22:19:26 +01002830 int b_ind_cpp_extern_c;
Bram Moolenaard881b512020-05-31 17:49:30 +02002831 int b_ind_pragma;
Bram Moolenaar6bcbcc52013-11-05 07:13:41 +01002832#endif
2833
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002834 linenr_T b_no_eol_lnum; // non-zero lnum when last line of next binary
2835 // write should not have an end-of-line
Bram Moolenaarcab35ad2011-02-15 17:39:22 +01002836
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002837 int b_start_eol; // last line had eol when it was read
2838 int b_start_ffc; // first char of 'ff' when edit started
2839 char_u *b_start_fenc; // 'fileencoding' when edit started or NULL
2840 int b_bad_char; // "++bad=" argument when edit started or 0
2841 int b_start_bomb; // 'bomb' when it was read
Bram Moolenaar071d4272004-06-13 20:20:40 +00002842
2843#ifdef FEAT_EVAL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002844 dictitem_T b_bufvar; // variable for "b:" Dictionary
2845 dict_T *b_vars; // internal variables, local to buffer
Bram Moolenaar6d2399b2019-05-11 19:14:16 +02002846
2847 listener_T *b_listener;
Bram Moolenaardda41442019-05-16 22:11:47 +02002848 list_T *b_recorded_changes;
Bram Moolenaar071d4272004-06-13 20:20:40 +00002849#endif
Bram Moolenaar05ad5ff2019-11-30 22:48:27 +01002850#ifdef FEAT_PROP_POPUP
Bram Moolenaarb413d2e2018-12-25 23:15:46 +01002851 int b_has_textprop; // TRUE when text props were added
2852 hashtab_T *b_proptypes; // text property types local to buffer
Bram Moolenaar98aefe72018-12-13 22:20:09 +01002853#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00002854
Bram Moolenaar9b2200a2006-03-20 21:55:45 +00002855#if defined(FEAT_BEVAL) && defined(FEAT_EVAL)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002856 char_u *b_p_bexpr; // 'balloonexpr' local value
2857 long_u b_p_bexpr_flags;// flags for 'balloonexpr'
Bram Moolenaar9b2200a2006-03-20 21:55:45 +00002858#endif
Bram Moolenaar49771f42010-07-20 17:32:38 +02002859#ifdef FEAT_CRYPT
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002860 char_u *b_p_cm; // 'cryptmethod'
Bram Moolenaar49771f42010-07-20 17:32:38 +02002861#endif
Bram Moolenaar9b2200a2006-03-20 21:55:45 +00002862
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002863 // When a buffer is created, it starts without a swap file. b_may_swap is
2864 // then set to indicate that a swap file may be opened later. It is reset
2865 // if a swap file could not be opened.
Bram Moolenaar071d4272004-06-13 20:20:40 +00002866 int b_may_swap;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002867 int b_did_warn; // Set to 1 if user has been warned on first
2868 // change of a read-only file
Bram Moolenaar4770d092006-01-12 23:22:24 +00002869
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002870 // Two special kinds of buffers:
2871 // help buffer - used for help files, won't use a swap file.
2872 // spell buffer - used for spell info, never displayed and doesn't have a
2873 // file name.
2874 int b_help; // TRUE for help file buffer (when set b_p_bt
2875 // is "help")
Bram Moolenaarb9a02fc2006-03-12 22:08:12 +00002876#ifdef FEAT_SPELL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002877 int b_spell; // TRUE for a spell file buffer, most fields
2878 // are not used! Use the B_SPELL macro to
2879 // access b_spell without #ifdef.
Bram Moolenaar4770d092006-01-12 23:22:24 +00002880#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00002881
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002882 int b_shortname; // this file has an 8.3 file name
Bram Moolenaar071d4272004-06-13 20:20:40 +00002883
Bram Moolenaarf2732452018-06-03 14:47:35 +02002884#ifdef FEAT_JOB_CHANNEL
Bram Moolenaar3a97bb32019-06-01 13:28:35 +02002885 char_u *b_prompt_text; // set by prompt_setprompt()
2886 callback_T b_prompt_callback; // set by prompt_setcallback()
2887 callback_T b_prompt_interrupt; // set by prompt_setinterrupt()
2888 int b_prompt_insert; // value for restart_edit when entering
2889 // a prompt buffer window.
Bram Moolenaarf2732452018-06-03 14:47:35 +02002890#endif
Bram Moolenaar325b7a22004-07-05 15:58:32 +00002891#ifdef FEAT_MZSCHEME
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002892 void *b_mzscheme_ref; // The MzScheme reference to this buffer
Bram Moolenaar325b7a22004-07-05 15:58:32 +00002893#endif
2894
Bram Moolenaar071d4272004-06-13 20:20:40 +00002895#ifdef FEAT_PERL
Bram Moolenaare344bea2005-09-01 20:46:49 +00002896 void *b_perl_private;
Bram Moolenaar071d4272004-06-13 20:20:40 +00002897#endif
2898
2899#ifdef FEAT_PYTHON
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002900 void *b_python_ref; // The Python reference to this buffer
Bram Moolenaar071d4272004-06-13 20:20:40 +00002901#endif
2902
Bram Moolenaarbd5e15f2010-07-17 21:19:38 +02002903#ifdef FEAT_PYTHON3
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002904 void *b_python3_ref; // The Python3 reference to this buffer
Bram Moolenaarbd5e15f2010-07-17 21:19:38 +02002905#endif
2906
Bram Moolenaar071d4272004-06-13 20:20:40 +00002907#ifdef FEAT_TCL
Bram Moolenaare344bea2005-09-01 20:46:49 +00002908 void *b_tcl_ref;
Bram Moolenaar071d4272004-06-13 20:20:40 +00002909#endif
2910
2911#ifdef FEAT_RUBY
Bram Moolenaare344bea2005-09-01 20:46:49 +00002912 void *b_ruby_ref;
Bram Moolenaar071d4272004-06-13 20:20:40 +00002913#endif
2914
Bram Moolenaar860cae12010-06-05 23:22:07 +02002915#if defined(FEAT_SYN_HL) || defined(FEAT_SPELL)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002916 synblock_T b_s; // Info related to syntax highlighting. w_s
2917 // normally points to this, but some windows
2918 // may use a different synblock_T.
Bram Moolenaarb9a02fc2006-03-12 22:08:12 +00002919#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00002920
2921#ifdef FEAT_SIGNS
Bram Moolenaar6656c2e2019-10-24 15:00:04 +02002922 sign_entry_T *b_signlist; // list of placed signs
Bram Moolenaar3b7b8362015-03-20 18:11:48 +01002923# ifdef FEAT_NETBEANS_INTG
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002924 int b_has_sign_column; // Flag that is set when a first sign is
2925 // added and remains set until the end of
2926 // the netbeans session.
Bram Moolenaar3b7b8362015-03-20 18:11:48 +01002927# endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00002928#endif
2929
2930#ifdef FEAT_NETBEANS_INTG
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002931 int b_netbeans_file; // TRUE when buffer is owned by NetBeans
2932 int b_was_netbeans_file;// TRUE if b_netbeans_file was once set
Bram Moolenaar071d4272004-06-13 20:20:40 +00002933#endif
Bram Moolenaar509ce2a2016-03-11 22:52:15 +01002934#ifdef FEAT_JOB_CHANNEL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002935 int b_write_to_channel; // TRUE when appended lines are written to
2936 // a channel.
Bram Moolenaar99ef0622016-03-06 20:22:25 +01002937#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00002938
Bram Moolenaar8f4ac012014-08-10 13:38:34 +02002939#ifdef FEAT_CRYPT
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002940 cryptstate_T *b_cryptstate; // Encryption state while reading or writing
2941 // the file. NULL when not using encryption.
Bram Moolenaar8f4ac012014-08-10 13:38:34 +02002942#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002943 int b_mapped_ctrl_c; // modes where CTRL-C is mapped
Bram Moolenaar8f4ac012014-08-10 13:38:34 +02002944
Bram Moolenaare4f25e42017-07-07 11:54:15 +02002945#ifdef FEAT_TERMINAL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002946 term_T *b_term; // When not NULL this buffer is for a terminal
2947 // window.
Bram Moolenaare4f25e42017-07-07 11:54:15 +02002948#endif
Bram Moolenaare828b762018-09-10 17:51:58 +02002949#ifdef FEAT_DIFF
2950 int b_diff_failed; // internal diff failed for this buffer
2951#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002952}; // file_buffer
Bram Moolenaar071d4272004-06-13 20:20:40 +00002953
Bram Moolenaar997fb4b2006-02-17 21:53:23 +00002954
2955#ifdef FEAT_DIFF
2956/*
2957 * Stuff for diff mode.
2958 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002959# define DB_COUNT 8 // up to eight buffers can be diff'ed
Bram Moolenaar997fb4b2006-02-17 21:53:23 +00002960
2961/*
2962 * Each diffblock defines where a block of lines starts in each of the buffers
2963 * and how many lines it occupies in that buffer. When the lines are missing
2964 * in the buffer the df_count[] is zero. This is all counted in
2965 * buffer lines.
2966 * There is always at least one unchanged line in between the diffs.
2967 * Otherwise it would have been included in the diff above or below it.
2968 * df_lnum[] + df_count[] is the lnum below the change. When in one buffer
2969 * lines have been inserted, in the other buffer df_lnum[] is the line below
2970 * the insertion and df_count[] is zero. When appending lines at the end of
2971 * the buffer, df_lnum[] is one beyond the end!
2972 * This is using a linked list, because the number of differences is expected
2973 * to be reasonable small. The list is sorted on lnum.
2974 */
2975typedef struct diffblock_S diff_T;
2976struct diffblock_S
2977{
2978 diff_T *df_next;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02002979 linenr_T df_lnum[DB_COUNT]; // line number in buffer
2980 linenr_T df_count[DB_COUNT]; // nr of inserted/changed lines
Bram Moolenaar997fb4b2006-02-17 21:53:23 +00002981};
2982#endif
2983
Bram Moolenaar746ebd32009-06-16 14:01:43 +00002984#define SNAP_HELP_IDX 0
Bram Moolenaarf2bd8ef2018-03-04 18:08:14 +01002985#define SNAP_AUCMD_IDX 1
2986#define SNAP_COUNT 2
Bram Moolenaar746ebd32009-06-16 14:01:43 +00002987
Bram Moolenaar997fb4b2006-02-17 21:53:23 +00002988/*
2989 * Tab pages point to the top frame of each tab page.
2990 * Note: Most values are NOT valid for the current tab page! Use "curwin",
2991 * "firstwin", etc. for that. "tp_topframe" is always valid and can be
2992 * compared against "topframe" to find the current tab page.
2993 */
2994typedef struct tabpage_S tabpage_T;
2995struct tabpage_S
2996{
Bram Moolenaar4d784b22019-05-25 19:51:39 +02002997 tabpage_T *tp_next; // next tabpage or NULL
2998 frame_T *tp_topframe; // topframe for the windows
2999 win_T *tp_curwin; // current window in this Tab page
3000 win_T *tp_prevwin; // previous window in this Tab page
3001 win_T *tp_firstwin; // first window in this Tab page
3002 win_T *tp_lastwin; // last window in this Tab page
Bram Moolenaar05ad5ff2019-11-30 22:48:27 +01003003#ifdef FEAT_PROP_POPUP
Bram Moolenaar4d784b22019-05-25 19:51:39 +02003004 win_T *tp_first_popupwin; // first popup window in this Tab page
3005#endif
3006 long tp_old_Rows; // Rows when Tab page was left
3007 long tp_old_Columns; // Columns when Tab page was left
3008 long tp_ch_used; // value of 'cmdheight' when frame size
3009 // was set
Bram Moolenaar9b2200a2006-03-20 21:55:45 +00003010#ifdef FEAT_GUI
3011 int tp_prev_which_scrollbars[3];
Bram Moolenaar4d784b22019-05-25 19:51:39 +02003012 // previous value of which_scrollbars
Bram Moolenaar9b2200a2006-03-20 21:55:45 +00003013#endif
Bram Moolenaar00aa0692019-04-27 20:37:57 +02003014
3015 char_u *tp_localdir; // absolute path of local directory or
3016 // NULL
Bram Moolenaar002bc792020-06-05 22:33:42 +02003017 char_u *tp_prevdir; // previous directory
3018
Bram Moolenaar997fb4b2006-02-17 21:53:23 +00003019#ifdef FEAT_DIFF
3020 diff_T *tp_first_diff;
3021 buf_T *(tp_diffbuf[DB_COUNT]);
Bram Moolenaare3521d92018-09-16 14:10:31 +02003022 int tp_diff_invalid; // list of diffs is outdated
3023 int tp_diff_update; // update diffs before redrawing
Bram Moolenaar997fb4b2006-02-17 21:53:23 +00003024#endif
Bram Moolenaar4d784b22019-05-25 19:51:39 +02003025 frame_T *(tp_snapshot[SNAP_COUNT]); // window layout snapshots
Bram Moolenaar910f66f2006-04-05 20:41:53 +00003026#ifdef FEAT_EVAL
Bram Moolenaar4d784b22019-05-25 19:51:39 +02003027 dictitem_T tp_winvar; // variable for "t:" Dictionary
3028 dict_T *tp_vars; // internal variables, local to tab page
Bram Moolenaar910f66f2006-04-05 20:41:53 +00003029#endif
Bram Moolenaar5e538ec2013-05-15 15:12:29 +02003030
3031#ifdef FEAT_PYTHON
Bram Moolenaar4d784b22019-05-25 19:51:39 +02003032 void *tp_python_ref; // The Python value for this tab page
Bram Moolenaar5e538ec2013-05-15 15:12:29 +02003033#endif
3034
3035#ifdef FEAT_PYTHON3
Bram Moolenaar4d784b22019-05-25 19:51:39 +02003036 void *tp_python3_ref; // The Python value for this tab page
Bram Moolenaar5e538ec2013-05-15 15:12:29 +02003037#endif
Bram Moolenaar997fb4b2006-02-17 21:53:23 +00003038};
3039
Bram Moolenaar071d4272004-06-13 20:20:40 +00003040/*
3041 * Structure to cache info for displayed lines in w_lines[].
3042 * Each logical line has one entry.
3043 * The entry tells how the logical line is currently displayed in the window.
3044 * This is updated when displaying the window.
3045 * When the display is changed (e.g., when clearing the screen) w_lines_valid
3046 * is changed to exclude invalid entries.
3047 * When making changes to the buffer, wl_valid is reset to indicate wl_size
3048 * may not reflect what is actually in the buffer. When wl_valid is FALSE,
3049 * the entries can only be used to count the number of displayed lines used.
3050 * wl_lnum and wl_lastlnum are invalid too.
3051 */
3052typedef struct w_line
3053{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003054 linenr_T wl_lnum; // buffer line number for logical line
3055 short_u wl_size; // height in screen lines
3056 char wl_valid; // TRUE values are valid for text in buffer
Bram Moolenaar071d4272004-06-13 20:20:40 +00003057#ifdef FEAT_FOLDING
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003058 char wl_folded; // TRUE when this is a range of folded lines
3059 linenr_T wl_lastlnum; // last buffer line number for logical line
Bram Moolenaar071d4272004-06-13 20:20:40 +00003060#endif
3061} wline_T;
3062
3063/*
3064 * Windows are kept in a tree of frames. Each frame has a column (FR_COL)
3065 * or row (FR_ROW) layout or is a leaf, which has a window.
3066 */
Bram Moolenaar1d2ba7f2006-02-14 22:29:30 +00003067struct frame_S
Bram Moolenaar071d4272004-06-13 20:20:40 +00003068{
Bram Moolenaarcce713d2019-03-04 11:40:12 +01003069 char fr_layout; // FR_LEAF, FR_COL or FR_ROW
Bram Moolenaar071d4272004-06-13 20:20:40 +00003070 int fr_width;
Bram Moolenaarcce713d2019-03-04 11:40:12 +01003071 int fr_newwidth; // new width used in win_equal_rec()
Bram Moolenaar071d4272004-06-13 20:20:40 +00003072 int fr_height;
Bram Moolenaarcce713d2019-03-04 11:40:12 +01003073 int fr_newheight; // new height used in win_equal_rec()
3074 frame_T *fr_parent; // containing frame or NULL
3075 frame_T *fr_next; // frame right or below in same parent, NULL
3076 // for last
3077 frame_T *fr_prev; // frame left or above in same parent, NULL
3078 // for first
3079 // fr_child and fr_win are mutually exclusive
3080 frame_T *fr_child; // first contained frame
3081 win_T *fr_win; // window that fills this frame
Bram Moolenaar071d4272004-06-13 20:20:40 +00003082};
3083
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003084#define FR_LEAF 0 // frame is a leaf
3085#define FR_ROW 1 // frame with a row of windows
3086#define FR_COL 2 // frame with a column of windows
Bram Moolenaar071d4272004-06-13 20:20:40 +00003087
3088/*
Bram Moolenaar6ee10162007-07-26 20:58:42 +00003089 * Struct used for highlighting 'hlsearch' matches, matches defined by
3090 * ":match" and matches defined by match functions.
3091 * For 'hlsearch' there is one pattern for all windows. For ":match" and the
3092 * match functions there is a different pattern for each window.
3093 */
3094typedef struct
3095{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003096 regmmatch_T rm; // points to the regexp program; contains last
3097 // found match (may continue in next line)
3098 buf_T *buf; // the buffer to search for a match
3099 linenr_T lnum; // the line to search for a match
3100 int attr; // attributes to be used for a match
3101 int attr_cur; // attributes currently active in win_line()
3102 linenr_T first_lnum; // first lnum to search for multi-line pat
3103 colnr_T startcol; // in win_line() points to char where HL starts
3104 colnr_T endcol; // in win_line() points to char where HL ends
3105 int is_addpos; // position specified directly by
3106 // matchaddpos(). TRUE/FALSE
Bram Moolenaar91a4e822008-01-19 14:59:58 +00003107#ifdef FEAT_RELTIME
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003108 proftime_T tm; // for a time limit
Bram Moolenaar91a4e822008-01-19 14:59:58 +00003109#endif
Bram Moolenaar6ee10162007-07-26 20:58:42 +00003110} match_T;
3111
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003112// number of positions supported by matchaddpos()
Bram Moolenaarb3414592014-06-17 17:48:32 +02003113#define MAXPOSMATCH 8
3114
3115/*
3116 * Same as lpos_T, but with additional field len.
3117 */
3118typedef struct
3119{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003120 linenr_T lnum; // line number
3121 colnr_T col; // column number
3122 int len; // length: 0 - to the end of line
Bram Moolenaarb3414592014-06-17 17:48:32 +02003123} llpos_T;
3124
3125/*
3126 * posmatch_T provides an array for storing match items for matchaddpos()
3127 * function.
3128 */
3129typedef struct posmatch posmatch_T;
3130struct posmatch
3131{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003132 llpos_T pos[MAXPOSMATCH]; // array of positions
3133 int cur; // internal position counter
3134 linenr_T toplnum; // top buffer line
3135 linenr_T botlnum; // bottom buffer line
Bram Moolenaarb3414592014-06-17 17:48:32 +02003136};
3137
Bram Moolenaar6ee10162007-07-26 20:58:42 +00003138/*
3139 * matchitem_T provides a linked list for storing match items for ":match" and
3140 * the match functions.
3141 */
3142typedef struct matchitem matchitem_T;
3143struct matchitem
3144{
3145 matchitem_T *next;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003146 int id; // match ID
3147 int priority; // match priority
3148 char_u *pattern; // pattern to highlight
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003149 regmmatch_T match; // regexp program for pattern
3150 posmatch_T pos; // position matches
3151 match_T hl; // struct for doing the actual highlighting
Bram Moolenaard6beab02019-11-10 15:07:19 +01003152 int hlg_id; // highlight group ID
Bram Moolenaar6561d522015-07-21 15:48:27 +02003153#ifdef FEAT_CONCEAL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003154 int conceal_char; // cchar for Conceal highlighting
Bram Moolenaar6561d522015-07-21 15:48:27 +02003155#endif
Bram Moolenaar6ee10162007-07-26 20:58:42 +00003156};
3157
Bram Moolenaara68e5952019-04-25 22:22:01 +02003158// Structure to store last cursor position and topline. Used by check_lnums()
3159// and reset_lnums().
3160typedef struct
3161{
3162 int w_topline_save; // original topline value
3163 int w_topline_corr; // corrected topline value
3164 pos_T w_cursor_save; // original cursor position
3165 pos_T w_cursor_corr; // corrected cursor position
3166} pos_save_T;
3167
Bram Moolenaar1b9645d2017-09-17 23:03:31 +02003168#ifdef FEAT_MENU
3169typedef struct {
3170 int wb_startcol;
3171 int wb_endcol;
3172 vimmenu_T *wb_menu;
3173} winbar_item_T;
3174#endif
3175
Bram Moolenaar6ee10162007-07-26 20:58:42 +00003176/*
Bram Moolenaar071d4272004-06-13 20:20:40 +00003177 * Structure which contains all information that belongs to a window
3178 *
3179 * All row numbers are relative to the start of the window, except w_winrow.
3180 */
Bram Moolenaar1d2ba7f2006-02-14 22:29:30 +00003181struct window_S
Bram Moolenaar071d4272004-06-13 20:20:40 +00003182{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003183 int w_id; // unique window ID
Bram Moolenaar86edef62016-03-13 18:07:30 +01003184
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003185 buf_T *w_buffer; // buffer we are a window into
Bram Moolenaar4d784b22019-05-25 19:51:39 +02003186
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003187 win_T *w_prev; // link to previous window
3188 win_T *w_next; // link to next window
Bram Moolenaar071d4272004-06-13 20:20:40 +00003189
Bram Moolenaar860cae12010-06-05 23:22:07 +02003190#if defined(FEAT_SYN_HL) || defined(FEAT_SPELL)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003191 synblock_T *w_s; // for :ownsyntax
Bram Moolenaar860cae12010-06-05 23:22:07 +02003192#endif
3193
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003194 int w_closing; // window is being closed, don't let
3195 // autocommands close it too.
Bram Moolenaar071d4272004-06-13 20:20:40 +00003196
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003197 frame_T *w_frame; // frame containing this window
Bram Moolenaar071d4272004-06-13 20:20:40 +00003198
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003199 pos_T w_cursor; // cursor position in buffer
Bram Moolenaar071d4272004-06-13 20:20:40 +00003200
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003201 colnr_T w_curswant; // The column we'd like to be at. This is
3202 // used to try to stay in the same column
3203 // for up/down cursor motions.
Bram Moolenaar071d4272004-06-13 20:20:40 +00003204
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003205 int w_set_curswant; // If set, then update w_curswant the next
3206 // time through cursupdate() to the
3207 // current virtual column
Bram Moolenaar071d4272004-06-13 20:20:40 +00003208
Bram Moolenaar4a5abbd2018-10-02 18:26:10 +02003209#ifdef FEAT_SYN_HL
3210 linenr_T w_last_cursorline; // where last time 'cursorline' was drawn
3211#endif
3212
Bram Moolenaar071d4272004-06-13 20:20:40 +00003213 /*
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003214 * the next seven are used to update the Visual highlighting
Bram Moolenaar071d4272004-06-13 20:20:40 +00003215 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003216 char w_old_visual_mode; // last known VIsual_mode
3217 linenr_T w_old_cursor_lnum; // last known end of visual part
3218 colnr_T w_old_cursor_fcol; // first column for block visual part
3219 colnr_T w_old_cursor_lcol; // last column for block visual part
3220 linenr_T w_old_visual_lnum; // last known start of visual part
3221 colnr_T w_old_visual_col; // last known start of visual part
3222 colnr_T w_old_curswant; // last known value of Curswant
Bram Moolenaar071d4272004-06-13 20:20:40 +00003223
3224 /*
Bram Moolenaard4153d42008-11-15 15:06:17 +00003225 * "w_topline", "w_leftcol" and "w_skipcol" specify the offsets for
3226 * displaying the buffer.
Bram Moolenaar071d4272004-06-13 20:20:40 +00003227 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003228 linenr_T w_topline; // buffer line number of the line at the
3229 // top of the window
3230 char w_topline_was_set; // flag set to TRUE when topline is set,
3231 // e.g. by winrestview()
Bram Moolenaar071d4272004-06-13 20:20:40 +00003232#ifdef FEAT_DIFF
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003233 int w_topfill; // number of filler lines above w_topline
3234 int w_old_topfill; // w_topfill at last redraw
3235 int w_botfill; // TRUE when filler lines are actually
3236 // below w_topline (at end of file)
3237 int w_old_botfill; // w_botfill at last redraw
Bram Moolenaar071d4272004-06-13 20:20:40 +00003238#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003239 colnr_T w_leftcol; // window column number of the left most
3240 // character in the window; used when
3241 // 'wrap' is off
3242 colnr_T w_skipcol; // starting column when a single line
3243 // doesn't fit in the window
Bram Moolenaar071d4272004-06-13 20:20:40 +00003244
3245 /*
3246 * Layout of the window in the screen.
3247 * May need to add "msg_scrolled" to "w_winrow" in rare situations.
3248 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003249 int w_winrow; // first row of window in screen
3250 int w_height; // number of rows in window, excluding
3251 // status/command/winbar line(s)
3252 int w_status_height; // number of status lines (0 or 1)
3253 int w_wincol; // Leftmost column of window in screen.
3254 int w_width; // Width of window, excluding separation.
3255 int w_vsep_width; // Number of separator columns (0 or 1).
3256 pos_save_T w_save_cursor; // backup of cursor pos and topline
Bram Moolenaar05ad5ff2019-11-30 22:48:27 +01003257#ifdef FEAT_PROP_POPUP
Bram Moolenaarac1f1bc2019-05-30 21:24:26 +02003258 int w_popup_flags; // POPF_ values
Bram Moolenaarafe45b62019-11-13 22:35:19 +01003259 int w_popup_handled; // POPUP_HANDLE[0-9] flags
Bram Moolenaareb2310d2019-06-16 20:09:10 +02003260 char_u *w_popup_title;
Bram Moolenaarac1f1bc2019-05-30 21:24:26 +02003261 poppos_T w_popup_pos;
Bram Moolenaar042fb4b2019-06-02 14:49:56 +02003262 int w_popup_fixed; // do not shift popup to fit on screen
Bram Moolenaar12034e22019-08-25 22:25:02 +02003263 int w_popup_prop_type; // when not zero: textprop type ID
3264 win_T *w_popup_prop_win; // window to search for textprop
3265 int w_popup_prop_id; // when not zero: textprop ID
Bram Moolenaar4d784b22019-05-25 19:51:39 +02003266 int w_zindex;
Bram Moolenaar60cdb302019-05-27 21:54:10 +02003267 int w_minheight; // "minheight" for popup window
3268 int w_minwidth; // "minwidth" for popup window
Bram Moolenaar4d784b22019-05-25 19:51:39 +02003269 int w_maxheight; // "maxheight" for popup window
3270 int w_maxwidth; // "maxwidth" for popup window
Bram Moolenaar60cdb302019-05-27 21:54:10 +02003271 int w_wantline; // "line" for popup window
3272 int w_wantcol; // "col" for popup window
Bram Moolenaar8d241042019-06-12 23:40:01 +02003273 int w_firstline; // "firstline" for popup window
Bram Moolenaar75fb0852019-06-25 05:15:58 +02003274 int w_want_scrollbar; // when zero don't use a scrollbar
Bram Moolenaarf9c85f52019-06-29 07:41:35 +02003275 int w_has_scrollbar; // 1 if scrollbar displayed, 0 otherwise
Bram Moolenaar4cd583c2019-06-26 05:13:57 +02003276 char_u *w_scrollbar_highlight; // "scrollbarhighlight"
3277 char_u *w_thumb_highlight; // "thumbhighlight"
Bram Moolenaar2fd8e352019-06-01 20:16:48 +02003278 int w_popup_padding[4]; // popup padding top/right/bot/left
3279 int w_popup_border[4]; // popup border top/right/bot/left
Bram Moolenaar790498b2019-06-01 22:15:29 +02003280 char_u *w_border_highlight[4]; // popup border highlight
3281 int w_border_char[8]; // popup border characters
Bram Moolenaard529ba52019-07-02 23:13:53 +02003282
3283 int w_popup_leftoff; // columns left of the screen
3284 int w_popup_rightoff; // columns right of the screen
Bram Moolenaar12034e22019-08-25 22:25:02 +02003285 varnumber_T w_popup_last_changedtick; // b:changedtick of popup buffer
3286 // when position was computed
3287 varnumber_T w_popup_prop_changedtick; // b:changedtick of buffer with
3288 // w_popup_prop_type when position
3289 // was computed
3290 int w_popup_prop_topline; // w_topline of window with
3291 // w_popup_prop_type when position was
3292 // computed
Bram Moolenaar3d2a3cb2019-09-08 17:12:01 +02003293 linenr_T w_popup_last_curline; // last known w_cursor.lnum of window
3294 // with "cursorline" set
Bram Moolenaar9eaac892019-06-01 22:49:29 +02003295 callback_T w_close_cb; // popup close callback
Bram Moolenaarbf0eff02019-06-01 17:13:36 +02003296 callback_T w_filter_cb; // popup filter callback
Bram Moolenaar581ba392019-09-03 22:08:33 +02003297 int w_filter_mode; // mode when filter callback is used
Bram Moolenaar3397f742019-06-02 18:40:06 +02003298
3299 win_T *w_popup_curwin; // close popup if curwin differs
3300 linenr_T w_popup_lnum; // close popup if cursor not on this line
3301 colnr_T w_popup_mincol; // close popup if cursor before this col
3302 colnr_T w_popup_maxcol; // close popup if cursor after this col
Bram Moolenaar56a63122019-07-07 18:38:34 +02003303 int w_popup_mouse_row; // close popup if mouse moves away
3304 int w_popup_mouse_mincol; // close popup if mouse moves away
3305 int w_popup_mouse_maxcol; // close popup if mouse moves away
Bram Moolenaar2e62b562019-06-30 18:07:00 +02003306 popclose_T w_popup_close; // allow closing the popup with the mouse
Bram Moolenaar3397f742019-06-02 18:40:06 +02003307
Bram Moolenaar4f0d0022019-07-26 22:20:03 +02003308 list_T *w_popup_mask; // list of lists for "mask"
3309 char_u *w_popup_mask_cells; // cached mask cells
3310 int w_popup_mask_height; // height of w_popup_mask_cells
3311 int w_popup_mask_width; // width of w_popup_mask_cells
Bram Moolenaar35d5af62019-05-26 20:44:10 +02003312# if defined(FEAT_TIMERS)
Bram Moolenaar51fe3b12019-05-26 20:10:06 +02003313 timer_T *w_popup_timer; // timer for closing popup window
Bram Moolenaar35d5af62019-05-26 20:44:10 +02003314# endif
Bram Moolenaar4d784b22019-05-25 19:51:39 +02003315#endif
Bram Moolenaara68e5952019-04-25 22:22:01 +02003316
Bram Moolenaare0de17d2017-09-24 16:24:34 +02003317
Bram Moolenaar071d4272004-06-13 20:20:40 +00003318 /*
3319 * === start of cached values ====
3320 */
3321 /*
3322 * Recomputing is minimized by storing the result of computations.
3323 * Use functions in screen.c to check if they are valid and to update.
3324 * w_valid is a bitfield of flags, which indicate if specific values are
3325 * valid or need to be recomputed. See screen.c for values.
3326 */
3327 int w_valid;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003328 pos_T w_valid_cursor; // last known position of w_cursor, used
3329 // to adjust w_valid
3330 colnr_T w_valid_leftcol; // last known w_leftcol
Bram Moolenaar071d4272004-06-13 20:20:40 +00003331
3332 /*
3333 * w_cline_height is the number of physical lines taken by the buffer line
3334 * that the cursor is on. We use this to avoid extra calls to plines().
3335 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003336 int w_cline_height; // current size of cursor line
Bram Moolenaar071d4272004-06-13 20:20:40 +00003337#ifdef FEAT_FOLDING
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003338 int w_cline_folded; // cursor line is folded
Bram Moolenaar071d4272004-06-13 20:20:40 +00003339#endif
3340
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003341 int w_cline_row; // starting row of the cursor line
Bram Moolenaar071d4272004-06-13 20:20:40 +00003342
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003343 colnr_T w_virtcol; // column number of the cursor in the
3344 // buffer line, as opposed to the column
3345 // number we're at on the screen. This
3346 // makes a difference on lines which span
3347 // more than one screen line or when
3348 // w_leftcol is non-zero
Bram Moolenaar071d4272004-06-13 20:20:40 +00003349
3350 /*
3351 * w_wrow and w_wcol specify the cursor position in the window.
3352 * This is related to positions in the window, not in the display or
3353 * buffer, thus w_wrow is relative to w_winrow.
3354 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003355 int w_wrow, w_wcol; // cursor position in window
Bram Moolenaar071d4272004-06-13 20:20:40 +00003356
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003357 linenr_T w_botline; // number of the line below the bottom of
3358 // the window
3359 int w_empty_rows; // number of ~ rows in window
Bram Moolenaar071d4272004-06-13 20:20:40 +00003360#ifdef FEAT_DIFF
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003361 int w_filler_rows; // number of filler rows at the end of the
3362 // window
Bram Moolenaar071d4272004-06-13 20:20:40 +00003363#endif
3364
3365 /*
3366 * Info about the lines currently in the window is remembered to avoid
3367 * recomputing it every time. The allocated size of w_lines[] is Rows.
3368 * Only the w_lines_valid entries are actually valid.
3369 * When the display is up-to-date w_lines[0].wl_lnum is equal to w_topline
3370 * and w_lines[w_lines_valid - 1].wl_lnum is equal to w_botline.
3371 * Between changing text and updating the display w_lines[] represents
3372 * what is currently displayed. wl_valid is reset to indicated this.
3373 * This is used for efficient redrawing.
3374 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003375 int w_lines_valid; // number of valid entries
Bram Moolenaar071d4272004-06-13 20:20:40 +00003376 wline_T *w_lines;
3377
3378#ifdef FEAT_FOLDING
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003379 garray_T w_folds; // array of nested folds
3380 char w_fold_manual; // when TRUE: some folds are opened/closed
3381 // manually
3382 char w_foldinvalid; // when TRUE: folding needs to be
3383 // recomputed
Bram Moolenaar071d4272004-06-13 20:20:40 +00003384#endif
Bram Moolenaar592e0a22004-07-03 16:05:59 +00003385#ifdef FEAT_LINEBREAK
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003386 int w_nrwidth; // width of 'number' and 'relativenumber'
3387 // column being used
Bram Moolenaar592e0a22004-07-03 16:05:59 +00003388#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00003389
3390 /*
3391 * === end of cached values ===
3392 */
3393
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003394 int w_redr_type; // type of redraw to be performed on win
3395 int w_upd_rows; // number of window lines to update when
3396 // w_redr_type is REDRAW_TOP
3397 linenr_T w_redraw_top; // when != 0: first line needing redraw
3398 linenr_T w_redraw_bot; // when != 0: last line needing redraw
3399 int w_redr_status; // if TRUE status line must be redrawn
Bram Moolenaar071d4272004-06-13 20:20:40 +00003400
3401#ifdef FEAT_CMDL_INFO
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003402 // remember what is shown in the ruler for this window (if 'ruler' set)
3403 pos_T w_ru_cursor; // cursor position shown in ruler
3404 colnr_T w_ru_virtcol; // virtcol shown in ruler
3405 linenr_T w_ru_topline; // topline shown in ruler
3406 linenr_T w_ru_line_count; // line count used for ruler
Bram Moolenaar071d4272004-06-13 20:20:40 +00003407# ifdef FEAT_DIFF
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003408 int w_ru_topfill; // topfill shown in ruler
Bram Moolenaar071d4272004-06-13 20:20:40 +00003409# endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003410 char w_ru_empty; // TRUE if ruler shows 0-1 (empty line)
Bram Moolenaar071d4272004-06-13 20:20:40 +00003411#endif
3412
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003413 int w_alt_fnum; // alternate file (for # and CTRL-^)
Bram Moolenaar071d4272004-06-13 20:20:40 +00003414
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003415 alist_T *w_alist; // pointer to arglist for this window
3416 int w_arg_idx; // current index in argument list (can be
3417 // out of range!)
3418 int w_arg_idx_invalid; // editing another file than w_arg_idx
Bram Moolenaar071d4272004-06-13 20:20:40 +00003419
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003420 char_u *w_localdir; // absolute path of local directory or
3421 // NULL
Bram Moolenaar002bc792020-06-05 22:33:42 +02003422 char_u *w_prevdir; // previous directory
Bram Moolenaar1b9645d2017-09-17 23:03:31 +02003423#ifdef FEAT_MENU
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003424 vimmenu_T *w_winbar; // The root of the WinBar menu hierarchy.
3425 winbar_item_T *w_winbar_items; // list of items in the WinBar
3426 int w_winbar_height; // 1 if there is a window toolbar
Bram Moolenaar1b9645d2017-09-17 23:03:31 +02003427#endif
3428
Bram Moolenaar071d4272004-06-13 20:20:40 +00003429 /*
3430 * Options local to a window.
3431 * They are local because they influence the layout of the window or
3432 * depend on the window layout.
3433 * There are two values: w_onebuf_opt is local to the buffer currently in
3434 * this window, w_allbuf_opt is for all buffers in this window.
3435 */
3436 winopt_T w_onebuf_opt;
3437 winopt_T w_allbuf_opt;
3438
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003439 // A few options have local flags for P_INSECURE.
Bram Moolenaard1f56e62006-02-22 21:25:37 +00003440#ifdef FEAT_STL_OPT
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003441 long_u w_p_stl_flags; // flags for 'statusline'
Bram Moolenaard1f56e62006-02-22 21:25:37 +00003442#endif
3443#ifdef FEAT_EVAL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003444 long_u w_p_fde_flags; // flags for 'foldexpr'
3445 long_u w_p_fdt_flags; // flags for 'foldtext'
Bram Moolenaard1f56e62006-02-22 21:25:37 +00003446#endif
Bram Moolenaar1a384422010-07-14 19:53:30 +02003447#ifdef FEAT_SYN_HL
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003448 int *w_p_cc_cols; // array of columns to highlight or NULL
Bram Moolenaar017ba072019-09-14 21:01:23 +02003449 char_u w_p_culopt_flags; // flags for cursorline highlighting
Bram Moolenaar1a384422010-07-14 19:53:30 +02003450#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003451 long w_p_siso; // 'sidescrolloff' local value
3452 long w_p_so; // 'scrolloff' local value
Bram Moolenaard1f56e62006-02-22 21:25:37 +00003453
Bram Moolenaarb81f56f2020-02-23 15:29:46 +01003454#ifdef FEAT_LINEBREAK
3455 int w_briopt_min; // minimum width for breakindent
3456 int w_briopt_shift; // additional shift for breakindent
3457 int w_briopt_sbr; // sbr in 'briopt'
3458#endif
3459
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003460 // transform a pointer to a "onebuf" option into a "allbuf" option
Bram Moolenaar071d4272004-06-13 20:20:40 +00003461#define GLOBAL_WO(p) ((char *)p + sizeof(winopt_T))
3462
Bram Moolenaar071d4272004-06-13 20:20:40 +00003463 long w_scbind_pos;
Bram Moolenaar071d4272004-06-13 20:20:40 +00003464
3465#ifdef FEAT_EVAL
Bram Moolenaar4aea03e2019-09-25 22:37:17 +02003466 dictitem_T w_winvar; // variable for "w:" Dictionary
3467 dict_T *w_vars; // internal variables, local to window
Bram Moolenaar071d4272004-06-13 20:20:40 +00003468#endif
3469
Bram Moolenaar071d4272004-06-13 20:20:40 +00003470 /*
3471 * The w_prev_pcmark field is used to check whether we really did jump to
3472 * a new line after setting the w_pcmark. If not, then we revert to
3473 * using the previous w_pcmark.
3474 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003475 pos_T w_pcmark; // previous context mark
3476 pos_T w_prev_pcmark; // previous w_pcmark
Bram Moolenaar071d4272004-06-13 20:20:40 +00003477
3478#ifdef FEAT_JUMPLIST
3479 /*
3480 * the jumplist contains old cursor positions
3481 */
3482 xfmark_T w_jumplist[JUMPLISTSIZE];
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003483 int w_jumplistlen; // number of active entries
3484 int w_jumplistidx; // current position
Bram Moolenaar071d4272004-06-13 20:20:40 +00003485
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003486 int w_changelistidx; // current position in b_changelist
Bram Moolenaar071d4272004-06-13 20:20:40 +00003487#endif
3488
3489#ifdef FEAT_SEARCH_EXTRA
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003490 matchitem_T *w_match_head; // head of match list
3491 int w_next_match_id; // next match ID
Bram Moolenaar071d4272004-06-13 20:20:40 +00003492#endif
3493
3494 /*
3495 * the tagstack grows from 0 upwards:
3496 * entry 0: older
3497 * entry 1: newer
3498 * entry 2: newest
3499 */
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003500 taggy_T w_tagstack[TAGSTACKSIZE]; // the tag stack
3501 int w_tagstackidx; // idx just below active entry
3502 int w_tagstacklen; // number of tags on stack
Bram Moolenaar071d4272004-06-13 20:20:40 +00003503
3504 /*
3505 * w_fraction is the fractional row of the cursor within the window, from
3506 * 0 at the top row to FRACTION_MULT at the last row.
3507 * w_prev_fraction_row was the actual cursor row when w_fraction was last
3508 * calculated.
3509 */
3510 int w_fraction;
3511 int w_prev_fraction_row;
3512
3513#ifdef FEAT_GUI
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003514 scrollbar_T w_scrollbars[2]; // vert. Scrollbars for this window
Bram Moolenaar071d4272004-06-13 20:20:40 +00003515#endif
Bram Moolenaar592e0a22004-07-03 16:05:59 +00003516#ifdef FEAT_LINEBREAK
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003517 linenr_T w_nrwidth_line_count; // line count when ml_nrwidth_width
3518 // was computed.
3519 long w_nuw_cached; // 'numberwidth' option cached
3520 int w_nrwidth_width; // nr of chars to print line count.
Bram Moolenaar592e0a22004-07-03 16:05:59 +00003521#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00003522
Bram Moolenaard12f5c12006-01-25 22:10:52 +00003523#ifdef FEAT_QUICKFIX
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003524 qf_info_T *w_llist; // Location list for this window
Bram Moolenaard12f5c12006-01-25 22:10:52 +00003525 /*
3526 * Location list reference used in the location list window.
3527 * In a non-location list window, w_llist_ref is NULL.
3528 */
3529 qf_info_T *w_llist_ref;
3530#endif
3531
Bram Moolenaar325b7a22004-07-05 15:58:32 +00003532#ifdef FEAT_MZSCHEME
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003533 void *w_mzscheme_ref; // The MzScheme value for this window
Bram Moolenaar325b7a22004-07-05 15:58:32 +00003534#endif
3535
Bram Moolenaar071d4272004-06-13 20:20:40 +00003536#ifdef FEAT_PERL
Bram Moolenaare344bea2005-09-01 20:46:49 +00003537 void *w_perl_private;
Bram Moolenaar071d4272004-06-13 20:20:40 +00003538#endif
3539
3540#ifdef FEAT_PYTHON
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003541 void *w_python_ref; // The Python value for this window
Bram Moolenaar071d4272004-06-13 20:20:40 +00003542#endif
3543
Bram Moolenaarbd5e15f2010-07-17 21:19:38 +02003544#ifdef FEAT_PYTHON3
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003545 void *w_python3_ref; // The Python value for this window
Bram Moolenaarbd5e15f2010-07-17 21:19:38 +02003546#endif
3547
Bram Moolenaar071d4272004-06-13 20:20:40 +00003548#ifdef FEAT_TCL
Bram Moolenaare344bea2005-09-01 20:46:49 +00003549 void *w_tcl_ref;
Bram Moolenaar071d4272004-06-13 20:20:40 +00003550#endif
3551
3552#ifdef FEAT_RUBY
Bram Moolenaare344bea2005-09-01 20:46:49 +00003553 void *w_ruby_ref;
Bram Moolenaar071d4272004-06-13 20:20:40 +00003554#endif
3555};
3556
3557/*
3558 * Arguments for operators.
3559 */
Bram Moolenaare344bea2005-09-01 20:46:49 +00003560typedef struct oparg_S
Bram Moolenaar071d4272004-06-13 20:20:40 +00003561{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003562 int op_type; // current pending operator type
3563 int regname; // register to use for the operator
3564 int motion_type; // type of the current cursor motion
3565 int motion_force; // force motion type: 'v', 'V' or CTRL-V
3566 int use_reg_one; // TRUE if delete uses reg 1 even when not
3567 // linewise
3568 int inclusive; // TRUE if char motion is inclusive (only
3569 // valid when motion_type is MCHAR
3570 int end_adjusted; // backuped b_op_end one char (only used by
3571 // do_format())
3572 pos_T start; // start of the operator
3573 pos_T end; // end of the operator
3574 pos_T cursor_start; // cursor position before motion for "gw"
Bram Moolenaar071d4272004-06-13 20:20:40 +00003575
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003576 long line_count; // number of lines from op_start to op_end
3577 // (inclusive)
3578 int empty; // op_start and op_end the same (only used by
3579 // do_change())
3580 int is_VIsual; // operator on Visual area
3581 int block_mode; // current operator is Visual block mode
3582 colnr_T start_vcol; // start col for block mode operator
3583 colnr_T end_vcol; // end col for block mode operator
3584 long prev_opcount; // ca.opcount saved for K_CURSORHOLD
3585 long prev_count0; // ca.count0 saved for K_CURSORHOLD
Bram Moolenaar071d4272004-06-13 20:20:40 +00003586} oparg_T;
3587
3588/*
3589 * Arguments for Normal mode commands.
3590 */
Bram Moolenaare344bea2005-09-01 20:46:49 +00003591typedef struct cmdarg_S
Bram Moolenaar071d4272004-06-13 20:20:40 +00003592{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003593 oparg_T *oap; // Operator arguments
3594 int prechar; // prefix character (optional, always 'g')
3595 int cmdchar; // command character
3596 int nchar; // next command character (optional)
3597 int ncharC1; // first composing character (optional)
3598 int ncharC2; // second composing character (optional)
3599 int extra_char; // yet another character (optional)
3600 long opcount; // count before an operator
3601 long count0; // count before command, default 0
3602 long count1; // count before command, default 1
3603 int arg; // extra argument from nv_cmds[]
3604 int retval; // return: CA_* values
3605 char_u *searchbuf; // return: pointer to search pattern or NULL
Bram Moolenaar071d4272004-06-13 20:20:40 +00003606} cmdarg_T;
3607
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003608// values for retval:
3609#define CA_COMMAND_BUSY 1 // skip restarting edit() once
3610#define CA_NO_ADJ_OP_END 2 // don't adjust operator end
Bram Moolenaar071d4272004-06-13 20:20:40 +00003611
3612#ifdef CURSOR_SHAPE
3613/*
3614 * struct to store values from 'guicursor' and 'mouseshape'
3615 */
Bram Moolenaar9bf703d2019-11-30 19:44:38 +01003616// Indexes in shape_table[]
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003617#define SHAPE_IDX_N 0 // Normal mode
3618#define SHAPE_IDX_V 1 // Visual mode
3619#define SHAPE_IDX_I 2 // Insert mode
3620#define SHAPE_IDX_R 3 // Replace mode
3621#define SHAPE_IDX_C 4 // Command line Normal mode
3622#define SHAPE_IDX_CI 5 // Command line Insert mode
3623#define SHAPE_IDX_CR 6 // Command line Replace mode
3624#define SHAPE_IDX_O 7 // Operator-pending mode
3625#define SHAPE_IDX_VE 8 // Visual mode with 'selection' exclusive
3626#define SHAPE_IDX_CLINE 9 // On command line
3627#define SHAPE_IDX_STATUS 10 // A status line
3628#define SHAPE_IDX_SDRAG 11 // dragging a status line
3629#define SHAPE_IDX_VSEP 12 // A vertical separator line
3630#define SHAPE_IDX_VDRAG 13 // dragging a vertical separator line
3631#define SHAPE_IDX_MORE 14 // Hit-return or More
3632#define SHAPE_IDX_MOREL 15 // Hit-return or More in last line
3633#define SHAPE_IDX_SM 16 // showing matching paren
Bram Moolenaar071d4272004-06-13 20:20:40 +00003634#define SHAPE_IDX_COUNT 17
3635
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003636#define SHAPE_BLOCK 0 // block cursor
3637#define SHAPE_HOR 1 // horizontal bar cursor
3638#define SHAPE_VER 2 // vertical bar cursor
Bram Moolenaar071d4272004-06-13 20:20:40 +00003639
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003640#define MSHAPE_NUMBERED 1000 // offset for shapes identified by number
3641#define MSHAPE_HIDE 1 // hide mouse pointer
Bram Moolenaar071d4272004-06-13 20:20:40 +00003642
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003643#define SHAPE_MOUSE 1 // used for mouse pointer shape
3644#define SHAPE_CURSOR 2 // used for text cursor shape
Bram Moolenaar071d4272004-06-13 20:20:40 +00003645
3646typedef struct cursor_entry
3647{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003648 int shape; // one of the SHAPE_ defines
3649 int mshape; // one of the MSHAPE defines
3650 int percentage; // percentage of cell for bar
3651 long blinkwait; // blinking, wait time before blinking starts
3652 long blinkon; // blinking, on time
3653 long blinkoff; // blinking, off time
3654 int id; // highlight group ID
3655 int id_lm; // highlight group ID for :lmap mode
3656 char *name; // mode name (fixed)
3657 char used_for; // SHAPE_MOUSE and/or SHAPE_CURSOR
Bram Moolenaar071d4272004-06-13 20:20:40 +00003658} cursorentry_T;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003659#endif // CURSOR_SHAPE
Bram Moolenaar071d4272004-06-13 20:20:40 +00003660
3661#ifdef FEAT_MENU
3662
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003663// Indices into vimmenu_T->strings[] and vimmenu_T->noremap[] for each mode
Bram Moolenaar071d4272004-06-13 20:20:40 +00003664#define MENU_INDEX_INVALID -1
3665#define MENU_INDEX_NORMAL 0
3666#define MENU_INDEX_VISUAL 1
Bram Moolenaar9b2200a2006-03-20 21:55:45 +00003667#define MENU_INDEX_SELECT 2
3668#define MENU_INDEX_OP_PENDING 3
3669#define MENU_INDEX_INSERT 4
3670#define MENU_INDEX_CMDLINE 5
Bram Moolenaar4c5d8152018-10-19 22:36:53 +02003671#define MENU_INDEX_TERMINAL 6
3672#define MENU_INDEX_TIP 7
3673#define MENU_MODES 8
Bram Moolenaar071d4272004-06-13 20:20:40 +00003674
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003675// Menu modes
Bram Moolenaar071d4272004-06-13 20:20:40 +00003676#define MENU_NORMAL_MODE (1 << MENU_INDEX_NORMAL)
3677#define MENU_VISUAL_MODE (1 << MENU_INDEX_VISUAL)
Bram Moolenaar9b2200a2006-03-20 21:55:45 +00003678#define MENU_SELECT_MODE (1 << MENU_INDEX_SELECT)
Bram Moolenaar071d4272004-06-13 20:20:40 +00003679#define MENU_OP_PENDING_MODE (1 << MENU_INDEX_OP_PENDING)
3680#define MENU_INSERT_MODE (1 << MENU_INDEX_INSERT)
3681#define MENU_CMDLINE_MODE (1 << MENU_INDEX_CMDLINE)
Bram Moolenaar4c5d8152018-10-19 22:36:53 +02003682#define MENU_TERMINAL_MODE (1 << MENU_INDEX_TERMINAL)
Bram Moolenaar071d4272004-06-13 20:20:40 +00003683#define MENU_TIP_MODE (1 << MENU_INDEX_TIP)
3684#define MENU_ALL_MODES ((1 << MENU_INDEX_TIP) - 1)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003685// note MENU_INDEX_TIP is not a 'real' mode
Bram Moolenaar071d4272004-06-13 20:20:40 +00003686
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003687// Start a menu name with this to not include it on the main menu bar
Bram Moolenaar071d4272004-06-13 20:20:40 +00003688#define MNU_HIDDEN_CHAR ']'
3689
Bram Moolenaar071d4272004-06-13 20:20:40 +00003690struct VimMenu
3691{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003692 int modes; // Which modes is this menu visible for?
3693 int enabled; // for which modes the menu is enabled
3694 char_u *name; // Name of menu, possibly translated
3695 char_u *dname; // Displayed Name ("name" without '&')
Bram Moolenaar70b11cd2010-05-14 22:24:40 +02003696#ifdef FEAT_MULTI_LANG
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003697 char_u *en_name; // "name" untranslated, NULL when "name"
3698 // was not translated
3699 char_u *en_dname; // "dname" untranslated, NULL when "dname"
3700 // was not translated
Bram Moolenaar70b11cd2010-05-14 22:24:40 +02003701#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003702 int mnemonic; // mnemonic key (after '&')
3703 char_u *actext; // accelerator text (after TAB)
3704 int priority; // Menu order priority
Bram Moolenaar071d4272004-06-13 20:20:40 +00003705#ifdef FEAT_GUI
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003706 void (*cb)(vimmenu_T *); // Call-back function
Bram Moolenaar071d4272004-06-13 20:20:40 +00003707#endif
3708#ifdef FEAT_TOOLBAR
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003709 char_u *iconfile; // name of file for icon or NULL
3710 int iconidx; // icon index (-1 if not set)
3711 int icon_builtin; // icon names is BuiltIn{nr}
Bram Moolenaar071d4272004-06-13 20:20:40 +00003712#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003713 char_u *strings[MENU_MODES]; // Mapped string for each mode
3714 int noremap[MENU_MODES]; // A REMAP_ flag for each mode
3715 char silent[MENU_MODES]; // A silent flag for each mode
3716 vimmenu_T *children; // Children of sub-menu
3717 vimmenu_T *parent; // Parent of menu
3718 vimmenu_T *next; // Next item in menu
Bram Moolenaar071d4272004-06-13 20:20:40 +00003719#ifdef FEAT_GUI_X11
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003720 Widget id; // Manage this to enable item
3721 Widget submenu_id; // If this is submenu, add children here
Bram Moolenaar071d4272004-06-13 20:20:40 +00003722#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00003723#ifdef FEAT_GUI_GTK
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003724 GtkWidget *id; // Manage this to enable item
3725 GtkWidget *submenu_id; // If this is submenu, add children here
Bram Moolenaar98921892016-02-23 17:14:37 +01003726# if defined(GTK_CHECK_VERSION) && !GTK_CHECK_VERSION(3,4,0)
Bram Moolenaar071d4272004-06-13 20:20:40 +00003727 GtkWidget *tearoff_handle;
Bram Moolenaar98921892016-02-23 17:14:37 +01003728# endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003729 GtkWidget *label; // Used by "set wak=" code.
Bram Moolenaar071d4272004-06-13 20:20:40 +00003730#endif
3731#ifdef FEAT_GUI_MOTIF
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003732 int sensitive; // turn button on/off
3733 char **xpm; // pixmap data
3734 char *xpm_fname; // file with pixmap data
Bram Moolenaar071d4272004-06-13 20:20:40 +00003735#endif
Bram Moolenaarec2dad62005-01-02 11:36:03 +00003736#ifdef FEAT_GUI_ATHENA
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003737 Pixmap image; // Toolbar image
Bram Moolenaar071d4272004-06-13 20:20:40 +00003738#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00003739#ifdef FEAT_BEVAL_TIP
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003740 BalloonEval *tip; // tooltip for this menu item
Bram Moolenaar071d4272004-06-13 20:20:40 +00003741#endif
Bram Moolenaar4f974752019-02-17 17:44:42 +01003742#ifdef FEAT_GUI_MSWIN
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003743 UINT id; // Id of menu item
3744 HMENU submenu_id; // If this is submenu, add children here
3745 HWND tearoff_handle; // hWnd of tearoff if created
Bram Moolenaar071d4272004-06-13 20:20:40 +00003746#endif
Bram Moolenaarb3f74062020-02-26 16:16:53 +01003747#if FEAT_GUI_HAIKU
3748 BMenuItem *id; // Id of menu item
3749 BMenu *submenu_id; // If this is submenu, add children here
3750# ifdef FEAT_TOOLBAR
3751 BPictureButton *button;
3752# endif
3753#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00003754#ifdef FEAT_GUI_MAC
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003755// MenuHandle id;
3756// short index; // the item index within the father menu
Bram Moolenaar32aa1022019-11-02 22:54:41 +01003757 short menu_id; // the menu id to which this item belongs
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003758 short submenu_id; // the menu id of the children (could be
3759 // get through some tricks)
Bram Moolenaar071d4272004-06-13 20:20:40 +00003760 MenuHandle menu_handle;
3761 MenuHandle submenu_handle;
3762#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00003763#ifdef FEAT_GUI_PHOTON
3764 PtWidget_t *id;
3765 PtWidget_t *submenu_id;
3766#endif
3767};
3768#else
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003769// For generating prototypes when FEAT_MENU isn't defined.
Bram Moolenaar071d4272004-06-13 20:20:40 +00003770typedef int vimmenu_T;
3771
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003772#endif // FEAT_MENU
Bram Moolenaar071d4272004-06-13 20:20:40 +00003773
3774/*
3775 * Struct to save values in before executing autocommands for a buffer that is
Bram Moolenaarf2bd8ef2018-03-04 18:08:14 +01003776 * not the current buffer.
Bram Moolenaar071d4272004-06-13 20:20:40 +00003777 */
3778typedef struct
3779{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003780 buf_T *save_curbuf; // saved curbuf
3781 int use_aucmd_win; // using aucmd_win
3782 win_T *save_curwin; // saved curwin
3783 win_T *new_curwin; // new curwin
3784 win_T *save_prevwin; // saved prevwin
3785 bufref_T new_curbuf; // new curbuf
3786 char_u *globaldir; // saved value of globaldir
Bram Moolenaar071d4272004-06-13 20:20:40 +00003787} aco_save_T;
3788
3789/*
3790 * Generic option table item, only used for printer at the moment.
3791 */
3792typedef struct
3793{
3794 const char *name;
3795 int hasnum;
3796 long number;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003797 char_u *string; // points into option string
Bram Moolenaar071d4272004-06-13 20:20:40 +00003798 int strlen;
3799 int present;
3800} option_table_T;
3801
3802/*
3803 * Structure to hold printing color and font attributes.
3804 */
3805typedef struct
3806{
3807 long_u fg_color;
3808 long_u bg_color;
3809 int bold;
3810 int italic;
3811 int underline;
Bram Moolenaare2cc9702005-03-15 22:43:58 +00003812 int undercurl;
Bram Moolenaar071d4272004-06-13 20:20:40 +00003813} prt_text_attr_T;
3814
3815/*
3816 * Structure passed back to the generic printer code.
3817 */
3818typedef struct
3819{
3820 int n_collated_copies;
3821 int n_uncollated_copies;
3822 int duplex;
3823 int chars_per_line;
3824 int lines_per_page;
3825 int has_color;
3826 prt_text_attr_T number;
3827#ifdef FEAT_SYN_HL
3828 int modec;
3829 int do_syntax;
3830#endif
3831 int user_abort;
3832 char_u *jobname;
3833#ifdef FEAT_POSTSCRIPT
3834 char_u *outfile;
3835 char_u *arguments;
3836#endif
3837} prt_settings_T;
3838
3839#define PRINT_NUMBER_WIDTH 8
Bram Moolenaar8b6144b2006-02-08 09:20:24 +00003840
3841/*
3842 * Used for popup menu items.
3843 */
3844typedef struct
3845{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003846 char_u *pum_text; // main menu text
3847 char_u *pum_kind; // extra kind text (may be truncated)
3848 char_u *pum_extra; // extra menu text (may be truncated)
3849 char_u *pum_info; // extra info
Bram Moolenaar8b6144b2006-02-08 09:20:24 +00003850} pumitem_T;
Bram Moolenaara23ccb82006-02-27 00:08:02 +00003851
3852/*
3853 * Structure used for get_tagfname().
3854 */
3855typedef struct
3856{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003857 char_u *tn_tags; // value of 'tags' when starting
3858 char_u *tn_np; // current position in tn_tags
Bram Moolenaara23ccb82006-02-27 00:08:02 +00003859 int tn_did_filefind_init;
3860 int tn_hf_idx;
3861 void *tn_search_ctx;
3862} tagname_T;
3863
Bram Moolenaar55debbe2010-05-23 23:34:36 +02003864typedef struct {
3865 UINT32_T total[2];
3866 UINT32_T state[8];
3867 char_u buffer[64];
3868} context_sha256_T;
Bram Moolenaar520e1e42016-01-23 19:46:28 +01003869
3870/*
Bram Moolenaarc6f9f732018-02-11 19:06:26 +01003871 * types for expressions.
3872 */
3873typedef enum
3874{
Bram Moolenaar87396072019-12-31 22:36:18 +01003875 EXPR_UNKNOWN = 0,
3876 EXPR_EQUAL, // ==
3877 EXPR_NEQUAL, // !=
3878 EXPR_GREATER, // >
3879 EXPR_GEQUAL, // >=
3880 EXPR_SMALLER, // <
3881 EXPR_SEQUAL, // <=
3882 EXPR_MATCH, // =~
3883 EXPR_NOMATCH, // !~
3884 EXPR_IS, // is
3885 EXPR_ISNOT, // isnot
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003886 // used with ISN_OPNR
3887 EXPR_ADD, // +
3888 EXPR_SUB, // -
3889 EXPR_MULT, // *
3890 EXPR_DIV, // /
3891 EXPR_REM, // %
Bram Moolenaarc6f9f732018-02-11 19:06:26 +01003892} exptype_T;
3893
3894/*
Bram Moolenaar520e1e42016-01-23 19:46:28 +01003895 * Structure used for reading in json_decode().
3896 */
Bram Moolenaar56ead342016-02-02 18:20:08 +01003897struct js_reader
Bram Moolenaar520e1e42016-01-23 19:46:28 +01003898{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003899 char_u *js_buf; // text to be decoded
3900 char_u *js_end; // NUL in js_buf
3901 int js_used; // bytes used from js_buf
Bram Moolenaar56ead342016-02-02 18:20:08 +01003902 int (*js_fill)(struct js_reader *);
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003903 // function to fill the buffer or NULL;
3904 // return TRUE when the buffer was filled
3905 void *js_cookie; // can be used by js_fill
3906 int js_cookie_arg; // can be used by js_fill
Bram Moolenaar56ead342016-02-02 18:20:08 +01003907};
3908typedef struct js_reader js_read_T;
Bram Moolenaar975b5272016-03-15 23:10:59 +01003909
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003910// Maximum number of commands from + or -c arguments.
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02003911#define MAX_ARG_CMDS 10
3912
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003913// values for "window_layout"
3914#define WIN_HOR 1 // "-o" horizontally split windows
3915#define WIN_VER 2 // "-O" vertically split windows
3916#define WIN_TABS 3 // "-p" windows on tab pages
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02003917
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003918// Struct for various parameters passed between main() and other functions.
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02003919typedef struct
3920{
3921 int argc;
3922 char **argv;
3923
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003924 char_u *fname; // first file to edit
Bram Moolenaara8e691d2016-08-07 15:19:26 +02003925
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003926 int evim_mode; // started as "evim"
3927 char_u *use_vimrc; // vimrc from -u argument
3928 int clean; // --clean argument
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02003929
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003930 int n_commands; // no. of commands from + or -c
3931 char_u *commands[MAX_ARG_CMDS]; // commands from + or -c arg.
3932 char_u cmds_tofree[MAX_ARG_CMDS]; // commands that need free()
3933 int n_pre_commands; // no. of commands from --cmd
3934 char_u *pre_commands[MAX_ARG_CMDS]; // commands from --cmd argument
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02003935
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003936 int edit_type; // type of editing to do
3937 char_u *tagname; // tag from -t argument
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02003938#ifdef FEAT_QUICKFIX
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003939 char_u *use_ef; // 'errorfile' from -q argument
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02003940#endif
3941
3942 int want_full_screen;
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003943 int not_a_term; // no warning for missing term?
3944 int tty_fail; // exit if not a tty
3945 char_u *term; // specified terminal name
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02003946#ifdef FEAT_CRYPT
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003947 int ask_for_key; // -x argument
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02003948#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003949 int no_swap_file; // "-n" argument used
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02003950#ifdef FEAT_EVAL
3951 int use_debug_break_level;
3952#endif
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003953 int window_count; // number of windows to use
3954 int window_layout; // 0, WIN_HOR, WIN_VER or WIN_TABS
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02003955
3956#ifdef FEAT_CLIENTSERVER
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003957 int serverArg; // TRUE when argument for a server
3958 char_u *serverName_arg; // cmdline arg for server name
3959 char_u *serverStr; // remote server command
3960 char_u *serverStrEnc; // encoding of serverStr
3961 char_u *servername; // allocated name for our server
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02003962#endif
3963#if !defined(UNIX)
3964# define EXPAND_FILENAMES
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003965 int literal; // don't expand file names
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02003966#endif
3967#ifdef MSWIN
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003968 int full_path; // file name argument was full path
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02003969#endif
3970#ifdef FEAT_DIFF
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02003971 int diff_mode; // start with 'diff' set
Bram Moolenaar502ae4b2016-07-16 19:50:13 +02003972#endif
3973} mparm_T;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003974
3975/*
3976 * Structure returned by get_lval() and used by set_var_lval().
3977 * For a plain name:
3978 * "name" points to the variable name.
3979 * "exp_name" is NULL.
3980 * "tv" is NULL
3981 * For a magic braces name:
3982 * "name" points to the expanded variable name.
3983 * "exp_name" is non-NULL, to be freed later.
3984 * "tv" is NULL
3985 * For an index in a list:
3986 * "name" points to the (expanded) variable name.
3987 * "exp_name" NULL or non-NULL, to be freed later.
3988 * "tv" points to the (first) list item value
3989 * "li" points to the (first) list item
3990 * "range", "n1", "n2" and "empty2" indicate what items are used.
3991 * For an existing Dict item:
3992 * "name" points to the (expanded) variable name.
3993 * "exp_name" NULL or non-NULL, to be freed later.
3994 * "tv" points to the dict item value
3995 * "newkey" is NULL
3996 * For a non-existing Dict item:
3997 * "name" points to the (expanded) variable name.
3998 * "exp_name" NULL or non-NULL, to be freed later.
3999 * "tv" points to the Dictionary typval_T
4000 * "newkey" is the key for the new item.
4001 */
4002typedef struct lval_S
4003{
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004004 char_u *ll_name; // start of variable name (can be NULL)
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004005 char_u *ll_name_end; // end of variable name (can be NULL)
4006 type_T *ll_type; // type of variable (can be NULL)
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004007 char_u *ll_exp_name; // NULL or expanded name in allocated memory.
4008 typval_T *ll_tv; // Typeval of item being used. If "newkey"
4009 // isn't NULL it's the Dict to which to add
4010 // the item.
4011 listitem_T *ll_li; // The list item or NULL.
4012 list_T *ll_list; // The list or NULL.
4013 int ll_range; // TRUE when a [i:j] range was used
Bram Moolenaard6beab02019-11-10 15:07:19 +01004014 int ll_empty2; // Second index is empty: [i:]
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004015 long ll_n1; // First index for list
4016 long ll_n2; // Second index for list range
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004017 dict_T *ll_dict; // The Dictionary or NULL
4018 dictitem_T *ll_di; // The dictitem or NULL
4019 char_u *ll_newkey; // New key for Dict in alloc. mem or NULL.
4020 blob_T *ll_blob; // The Blob or NULL
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004021} lval_T;
Bram Moolenaara21a6a92017-09-23 16:33:50 +02004022
Bram Moolenaar6cb39f92019-07-04 16:05:14 +02004023// Structure used to save the current state. Used when executing Normal mode
4024// commands while in any other mode.
Bram Moolenaara21a6a92017-09-23 16:33:50 +02004025typedef struct {
4026 int save_msg_scroll;
4027 int save_restart_edit;
4028 int save_msg_didout;
4029 int save_State;
4030 int save_insertmode;
4031 int save_finish_op;
4032 int save_opcount;
Bram Moolenaarcce713d2019-03-04 11:40:12 +01004033 int save_reg_executing;
Bram Moolenaara21a6a92017-09-23 16:33:50 +02004034 tasave_T tabuf;
4035} save_state_T;
Bram Moolenaarb0f42ba2018-05-12 15:38:26 +02004036
4037typedef struct {
4038 varnumber_T vv_prevcount;
4039 varnumber_T vv_count;
4040 varnumber_T vv_count1;
4041} vimvars_save_T;
Bram Moolenaar1063f3d2019-05-07 22:06:52 +02004042
4043// Scope for changing directory
4044typedef enum {
4045 CDSCOPE_GLOBAL, // :cd
4046 CDSCOPE_TABPAGE, // :tcd
4047 CDSCOPE_WINDOW // :lcd
4048} cdscope_T;
Bram Moolenaar451d4b52019-06-12 20:22:27 +02004049
Bram Moolenaardefa0672019-07-21 19:25:37 +02004050// Variable flavor
4051typedef enum
4052{
Bram Moolenaar4aea03e2019-09-25 22:37:17 +02004053 VAR_FLAVOUR_DEFAULT, // doesn't start with uppercase
4054 VAR_FLAVOUR_SESSION, // starts with uppercase, some lower
4055 VAR_FLAVOUR_VIMINFO // all uppercase
Bram Moolenaardefa0672019-07-21 19:25:37 +02004056} var_flavour_T;
4057
Bram Moolenaar451d4b52019-06-12 20:22:27 +02004058// argument for mouse_find_win()
4059typedef enum {
4060 IGNORE_POPUP, // only check non-popup windows
4061 FIND_POPUP, // also find popup windows
4062 FAIL_POPUP // return NULL if mouse on popup window
4063} mouse_find_T;
Bram Moolenaarc3328162019-07-23 22:15:25 +02004064
4065// Symbolic names for some registers.
4066#define DELETION_REGISTER 36
4067#ifdef FEAT_CLIPBOARD
4068# define STAR_REGISTER 37
4069# ifdef FEAT_X11
4070# define PLUS_REGISTER 38
4071# else
4072# define PLUS_REGISTER STAR_REGISTER // there is only one
4073# endif
4074#endif
4075#ifdef FEAT_DND
4076# define TILDE_REGISTER (PLUS_REGISTER + 1)
4077#endif
4078
4079#ifdef FEAT_CLIPBOARD
4080# ifdef FEAT_DND
4081# define NUM_REGISTERS (TILDE_REGISTER + 1)
4082# else
4083# define NUM_REGISTERS (PLUS_REGISTER + 1)
4084# endif
4085#else
4086# define NUM_REGISTERS 37
4087#endif
4088
Bram Moolenaar4aea03e2019-09-25 22:37:17 +02004089// structure used by block_prep, op_delete and op_yank for blockwise operators
4090// also op_change, op_shift, op_insert, op_replace - AKelly
4091struct block_def
4092{
4093 int startspaces; // 'extra' cols before first char
4094 int endspaces; // 'extra' cols after last char
4095 int textlen; // chars in block
4096 char_u *textstart; // pointer to 1st char (partially) in block
4097 colnr_T textcol; // index of chars (partially) in block
4098 colnr_T start_vcol; // start col of 1st char wholly inside block
4099 colnr_T end_vcol; // start col of 1st char wholly after block
4100 int is_short; // TRUE if line is too short to fit in block
4101 int is_MAX; // TRUE if curswant==MAXCOL when starting
4102 int is_oneChar; // TRUE if block within one character
4103 int pre_whitesp; // screen cols of ws before block
4104 int pre_whitesp_c; // chars of ws before block
4105 colnr_T end_char_vcols; // number of vcols of post-block char
4106 colnr_T start_char_vcols; // number of vcols of pre-block char
4107};
4108
Bram Moolenaarc3328162019-07-23 22:15:25 +02004109// Each yank register has an array of pointers to lines.
4110typedef struct
4111{
4112 char_u **y_array; // pointer to array of line pointers
4113 linenr_T y_size; // number of lines in y_array
4114 char_u y_type; // MLINE, MCHAR or MBLOCK
4115 colnr_T y_width; // only set if y_type == MBLOCK
4116#ifdef FEAT_VIMINFO
4117 time_t y_time_set;
4118#endif
4119} yankreg_T;
4120
4121// The offset for a search command is store in a soff struct
4122// Note: only spats[0].off is really used
4123typedef struct soffset
4124{
4125 int dir; // search direction, '/' or '?'
4126 int line; // search has line offset
4127 int end; // search set cursor at end
4128 long off; // line or char offset
4129} soffset_T;
4130
4131// A search pattern and its attributes are stored in a spat struct
4132typedef struct spat
4133{
4134 char_u *pat; // the pattern (in allocated memory) or NULL
4135 int magic; // magicness of the pattern
4136 int no_scs; // no smartcase for this pattern
4137 soffset_T off;
4138} spat_T;
Bram Moolenaar473952e2019-09-28 16:30:04 +02004139
Bram Moolenaar92ea26b2019-10-18 20:53:34 +02004140/*
4141 * Optional extra arguments for searchit().
4142 */
4143typedef struct
4144{
4145 linenr_T sa_stop_lnum; // stop after this line number when != 0
4146#ifdef FEAT_RELTIME
4147 proftime_T *sa_tm; // timeout limit or NULL
4148 int sa_timed_out; // set when timed out
4149#endif
4150 int sa_wrapped; // search wrapped around
4151} searchit_arg_T;
4152
Bram Moolenaaradc17a52020-06-06 18:37:51 +02004153
Bram Moolenaar473952e2019-09-28 16:30:04 +02004154#define WRITEBUFSIZE 8192 // size of normal write buffer
4155
4156#define FIO_LATIN1 0x01 // convert Latin1
4157#define FIO_UTF8 0x02 // convert UTF-8
4158#define FIO_UCS2 0x04 // convert UCS-2
4159#define FIO_UCS4 0x08 // convert UCS-4
4160#define FIO_UTF16 0x10 // convert UTF-16
4161#ifdef MSWIN
4162# define FIO_CODEPAGE 0x20 // convert MS-Windows codepage
4163# define FIO_PUT_CP(x) (((x) & 0xffff) << 16) // put codepage in top word
4164# define FIO_GET_CP(x) (((x)>>16) & 0xffff) // get codepage from top word
4165#endif
4166#ifdef MACOS_CONVERT
4167# define FIO_MACROMAN 0x20 // convert MacRoman
4168#endif
4169#define FIO_ENDIAN_L 0x80 // little endian
4170#define FIO_ENCRYPTED 0x1000 // encrypt written bytes
4171#define FIO_NOCONVERT 0x2000 // skip encoding conversion
4172#define FIO_UCSBOM 0x4000 // check for BOM at start of file
4173#define FIO_ALL -1 // allow all formats
4174
4175// When converting, a read() or write() may leave some bytes to be converted
4176// for the next call. The value is guessed...
4177#define CONV_RESTLEN 30
4178
4179// We have to guess how much a sequence of bytes may expand when converting
4180// with iconv() to be able to allocate a buffer.
4181#define ICONV_MULT 8