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