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