xref: /vim-8.2.3635/src/vim.h (revision 4e63f942)
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 #ifndef VIM__H
10 # define VIM__H
11 
12 #include "protodef.h"
13 
14 // _WIN32 is defined as 1 when the compilation target is 32-bit or 64-bit.
15 // Note: If you want to check for 64-bit use the _WIN64 macro.
16 #if defined(WIN32) || defined(_WIN32)
17 # define MSWIN
18 #endif
19 
20 #ifdef MSWIN
21 # include "vimio.h"
22 #endif
23 
24 /* ============ the header file puzzle (ca. 50-100 pieces) ========= */
25 
26 #ifdef HAVE_CONFIG_H	/* GNU autoconf (or something else) was here */
27 # include "auto/config.h"
28 # define HAVE_PATHDEF
29 
30 /*
31  * Check if configure correctly managed to find sizeof(int).  If this failed,
32  * it becomes zero.  This is likely a problem of not being able to run the
33  * test program.  Other items from configure may also be wrong then!
34  */
35 # if (VIM_SIZEOF_INT == 0)
36     Error: configure did not run properly.  Check auto/config.log.
37 # endif
38 
39 // for INT_MAX, LONG_MAX et al.
40 #include <limits.h>
41 
42 /*
43  * Cygwin may have fchdir() in a newer release, but in most versions it
44  * doesn't work well and avoiding it keeps the binary backward compatible.
45  */
46 # if defined(__CYGWIN32__) && defined(HAVE_FCHDIR)
47 #  undef HAVE_FCHDIR
48 # endif
49 
50 /* We may need to define the uint32_t on non-Unix system, but using the same
51  * identifier causes conflicts.  Therefore use UINT32_T. */
52 # define UINT32_TYPEDEF uint32_t
53 #endif
54 
55 #if !defined(UINT32_TYPEDEF)
56 # if defined(uint32_t)  /* this doesn't catch typedefs, unfortunately */
57 #  define UINT32_TYPEDEF uint32_t
58 # else
59   /* Fall back to assuming unsigned int is 32 bit.  If this is wrong then the
60    * test in blowfish.c will fail. */
61 #  define UINT32_TYPEDEF unsigned int
62 # endif
63 #endif
64 
65 /* user ID of root is usually zero, but not for everybody */
66 #ifdef __TANDEM
67 # ifndef _TANDEM_SOURCE
68 #  define _TANDEM_SOURCE
69 # endif
70 # include <floss.h>
71 # define ROOT_UID 65535
72 # define OLDXAW
73 # if (_TANDEM_ARCH_ == 2 && __H_Series_RVU >= 621)
74 #  define SA_ONSTACK_COMPATIBILITY
75 # endif
76 #else
77 # define ROOT_UID 0
78 #endif
79 
80 /*
81  * MACOS_X	    compiling for Mac OS X
82  * MACOS_X_DARWIN   integrating the darwin feature into MACOS_X
83  */
84 #if defined(MACOS_X_DARWIN) && !defined(MACOS_X)
85 # define MACOS_X
86 #endif
87 /* Unless made through the Makefile enforce GUI on Mac */
88 #if defined(MACOS_X) && !defined(HAVE_CONFIG_H)
89 # define UNIX
90 # define FEAT_GUI_MAC
91 #endif
92 
93 #if defined(FEAT_GUI_MOTIF) \
94     || defined(FEAT_GUI_GTK) \
95     || defined(FEAT_GUI_ATHENA) \
96     || defined(FEAT_GUI_MAC) \
97     || defined(FEAT_GUI_MSWIN) \
98     || defined(FEAT_GUI_PHOTON)
99 # define FEAT_GUI_ENABLED  /* also defined with NO_X11_INCLUDES */
100 # if !defined(FEAT_GUI) && !defined(NO_X11_INCLUDES)
101 #  define FEAT_GUI
102 # endif
103 #endif
104 
105 /* Check support for rendering options */
106 #ifdef FEAT_GUI
107 # if defined(FEAT_DIRECTX)
108 #  define FEAT_RENDER_OPTIONS
109 # endif
110 #endif
111 
112 /* Visual Studio 2005 has 'deprecated' many of the standard CRT functions */
113 #if _MSC_VER >= 1400
114 # define _CRT_SECURE_NO_DEPRECATE
115 # define _CRT_NONSTDC_NO_DEPRECATE
116 #endif
117 
118 /*
119  * VIM_SIZEOF_INT is used in feature.h, and the system-specific included files
120  * need items from feature.h.  Therefore define VIM_SIZEOF_INT here.
121  */
122 #ifdef MSWIN
123 # define VIM_SIZEOF_INT 4
124 #endif
125 
126 #ifdef AMIGA
127   /* Be conservative about sizeof(int). It could be 4 too. */
128 # ifndef FEAT_GUI_GTK	/* avoid problems when generating prototypes */
129 #  ifdef __GNUC__
130 #   define VIM_SIZEOF_INT	4
131 #  else
132 #   define VIM_SIZEOF_INT	2
133 #  endif
134 # endif
135 #endif
136 #if defined(MACOS_X) && !defined(HAVE_CONFIG_H)
137 #  define VIM_SIZEOF_INT __SIZEOF_INT__
138 #endif
139 
140 #if VIM_SIZEOF_INT < 4 && !defined(PROTO)
141     Error: Vim only works with 32 bit int or larger
142 #endif
143 
144 /*
145  * #defines for optionals and features
146  * Also defines FEAT_TINY, FEAT_SMALL, etc. when FEAT_HUGE is defined.
147  */
148 #include "feature.h"
149 
150 #if defined(MACOS_X_DARWIN)
151 # if defined(FEAT_SMALL) && !defined(FEAT_CLIPBOARD)
152 #  define FEAT_CLIPBOARD
153 # endif
154 # if defined(FEAT_SMALL) && !defined(FEAT_MOUSE)
155 #  define FEAT_MOUSE
156 # endif
157 #endif
158 
159 /* +x11 is only enabled when it's both available and wanted. */
160 #if defined(HAVE_X11) && defined(WANT_X11)
161 # define FEAT_X11
162 #endif
163 
164 #ifdef NO_X11_INCLUDES
165     /* In os_mac_conv.c and os_macosx.m NO_X11_INCLUDES is defined to avoid
166      * X11 headers.  Disable all X11 related things to avoid conflicts. */
167 # ifdef FEAT_X11
168 #  undef FEAT_X11
169 # endif
170 # ifdef FEAT_GUI_X11
171 #  undef FEAT_GUI_X11
172 # endif
173 # ifdef FEAT_XCLIPBOARD
174 #  undef FEAT_XCLIPBOARD
175 # endif
176 # ifdef FEAT_GUI_MOTIF
177 #  undef FEAT_GUI_MOTIF
178 # endif
179 # ifdef FEAT_GUI_ATHENA
180 #  undef FEAT_GUI_ATHENA
181 # endif
182 # ifdef FEAT_GUI_GTK
183 #  undef FEAT_GUI_GTK
184 # endif
185 # ifdef FEAT_BEVAL_TIP
186 #  undef FEAT_BEVAL_TIP
187 # endif
188 # ifdef FEAT_XIM
189 #  undef FEAT_XIM
190 # endif
191 # ifdef FEAT_CLIENTSERVER
192 #  undef FEAT_CLIENTSERVER
193 # endif
194 #endif
195 
196 /* The Mac conversion stuff doesn't work under X11. */
197 #if defined(MACOS_X_DARWIN)
198 # define MACOS_CONVERT
199 #endif
200 
201 /* Can't use "PACKAGE" here, conflicts with a Perl include file. */
202 #ifndef VIMPACKAGE
203 # define VIMPACKAGE	"vim"
204 #endif
205 
206 /*
207  * Find out if function definitions should include argument types
208  */
209 #ifdef AZTEC_C
210 # include <functions.h>
211 #endif
212 
213 #ifdef SASC
214 # include <clib/exec_protos.h>
215 #endif
216 
217 #ifdef _DCC
218 # include <clib/exec_protos.h>
219 #endif
220 
221 #ifdef __BEOS__
222 # include "os_beos.h"
223 #endif
224 
225 #if (defined(UNIX) || defined(VMS)) \
226 	&& (!defined(MACOS_X) || defined(HAVE_CONFIG_H))
227 # include "os_unix.h"	    /* bring lots of system header files */
228 #endif
229 
230 /* Mark unused function arguments with UNUSED, so that gcc -Wunused-parameter
231  * can be used to check for mistakes. */
232 #ifdef HAVE_ATTRIBUTE_UNUSED
233 # define UNUSED __attribute__((unused))
234 #else
235 # define UNUSED
236 #endif
237 
238 /* Used to check for "sun", "__sun" is used by newer compilers. */
239 #if defined(__sun)
240 # define SUN_SYSTEM
241 #endif
242 
243 /* If we're compiling in C++ (currently only KVim), the system
244  * headers must have the correct prototypes or nothing will build.
245  * Conversely, our prototypes might clash due to throw() specifiers and
246  * cause compilation failures even though the headers are correct.  For
247  * a concrete example, gcc-3.2 enforces exception specifications, and
248  * glibc-2.2.5 has them in their system headers.
249  */
250 #if !defined(__cplusplus) && defined(UNIX) \
251 	&& !defined(MACOS_X) /* MACOS_X doesn't yet support osdef.h */
252 # include "auto/osdef.h"	/* bring missing declarations in */
253 #endif
254 
255 #ifdef AMIGA
256 # include "os_amiga.h"
257 #endif
258 
259 #ifdef MSWIN
260 # include "os_win32.h"
261 #endif
262 
263 #ifdef __MINT__
264 # include "os_mint.h"
265 #endif
266 
267 #if defined(MACOS_X)
268 # include "os_mac.h"
269 #endif
270 
271 #ifdef __QNX__
272 # include "os_qnx.h"
273 #endif
274 
275 #ifdef X_LOCALE
276 # include <X11/Xlocale.h>
277 #else
278 # ifdef HAVE_LOCALE_H
279 #  include <locale.h>
280 # endif
281 #endif
282 
283 /*
284  * Maximum length of a path (for non-unix systems) Make it a bit long, to stay
285  * on the safe side.  But not too long to put on the stack.
286  */
287 #ifndef MAXPATHL
288 # ifdef MAXPATHLEN
289 #  define MAXPATHL  MAXPATHLEN
290 # else
291 #  define MAXPATHL  256
292 # endif
293 #endif
294 #ifdef BACKSLASH_IN_FILENAME
295 # define PATH_ESC_CHARS ((char_u *)" \t\n*?[{`%#'\"|!<")
296 #else
297 # ifdef VMS
298     /* VMS allows a lot of characters in the file name */
299 #  define PATH_ESC_CHARS ((char_u *)" \t\n*?{`\\%#'\"|!")
300 #  define SHELL_ESC_CHARS ((char_u *)" \t\n*?{`\\%#'|!()&")
301 # else
302 #  define PATH_ESC_CHARS ((char_u *)" \t\n*?[{`$\\%#'\"|!<")
303 #  define SHELL_ESC_CHARS ((char_u *)" \t\n*?[{`$\\%#'\"|!<>();&")
304 # endif
305 #endif
306 
307 /* length of a buffer to store a number in ASCII (64 bits binary + NUL) */
308 #define NUMBUFLEN 65
309 
310 /* flags for vim_str2nr() */
311 #define STR2NR_BIN 1
312 #define STR2NR_OCT 2
313 #define STR2NR_HEX 4
314 #define STR2NR_ALL (STR2NR_BIN + STR2NR_OCT + STR2NR_HEX)
315 #define STR2NR_FORCE 8 /* only when ONE of the above is used */
316 
317 /*
318  * Shorthand for unsigned variables. Many systems, but not all, have u_char
319  * already defined, so we use char_u to avoid trouble.
320  */
321 typedef unsigned char	char_u;
322 typedef unsigned short	short_u;
323 typedef unsigned int	int_u;
324 
325 /* Older systems do not have support for long long
326  * use a typedef instead of hadcoded long long */
327 #ifdef HAVE_NO_LONG_LONG
328  typedef long long_long_T;
329  typedef long unsigned long_long_u_T;
330 #else
331  typedef long long long_long_T;
332  typedef long long unsigned long_long_u_T;
333 #endif
334 
335 /* Make sure long_u is big enough to hold a pointer.
336  * On Win64, longs are 32 bits and pointers are 64 bits.
337  * For printf() and scanf(), we need to take care of long_u specifically. */
338 #ifdef _WIN64
339 typedef unsigned __int64	long_u;
340 typedef		 __int64	long_i;
341 # define SCANF_HEX_LONG_U       "%Ix"
342 # define SCANF_DECIMAL_LONG_U   "%Iu"
343 # define PRINTF_HEX_LONG_U      "0x%Ix"
344 #else
345   /* Microsoft-specific. The __w64 keyword should be specified on any typedefs
346    * that change size between 32-bit and 64-bit platforms.  For any such type,
347    * __w64 should appear only on the 32-bit definition of the typedef.
348    * Define __w64 as an empty token for everything but MSVC 7.x or later.
349    */
350 # if !defined(_MSC_VER)	|| (_MSC_VER < 1300)
351 #  define __w64
352 # endif
353 typedef unsigned long __w64	long_u;
354 typedef		 long __w64     long_i;
355 # define SCANF_HEX_LONG_U       "%lx"
356 # define SCANF_DECIMAL_LONG_U   "%lu"
357 # define PRINTF_HEX_LONG_U      "0x%lx"
358 #endif
359 #define PRINTF_DECIMAL_LONG_U SCANF_DECIMAL_LONG_U
360 
361 /*
362  * Only systems which use configure will have SIZEOF_OFF_T and VIM_SIZEOF_LONG
363  * defined, which is ok since those are the same systems which can have
364  * varying sizes for off_t.  The other systems will continue to use "%ld" to
365  * print off_t since off_t is simply a typedef to long for them.
366  */
367 #if defined(SIZEOF_OFF_T) && (SIZEOF_OFF_T > VIM_SIZEOF_LONG)
368 # define LONG_LONG_OFF_T
369 #endif
370 
371 /*
372  * We use 64-bit file functions here, if available.  E.g. ftello() returns
373  * off_t instead of long, which helps if long is 32 bit and off_t is 64 bit.
374  * We assume that when fseeko() is available then ftello() is too.
375  * Note that Windows has different function names.
376  */
377 #if (defined(_MSC_VER) && (_MSC_VER >= 1300)) || defined(__MINGW32__)
378 typedef __int64 off_T;
379 # ifdef __MINGW32__
380 #  define vim_lseek lseek64
381 #  define vim_fseek fseeko64
382 #  define vim_ftell ftello64
383 # else
384 #  define vim_lseek _lseeki64
385 #  define vim_fseek _fseeki64
386 #  define vim_ftell _ftelli64
387 # endif
388 #else
389 # ifdef PROTO
390 typedef long off_T;
391 # else
392 typedef off_t off_T;
393 # endif
394 # ifdef HAVE_FSEEKO
395 #  define vim_lseek lseek
396 #  define vim_ftell ftello
397 #  define vim_fseek fseeko
398 # else
399 #  define vim_lseek lseek
400 #  define vim_ftell ftell
401 #  define vim_fseek(a, b, c)	fseek(a, (long)b, c)
402 # endif
403 #endif
404 
405 /*
406  * The characters and attributes cached for the screen.
407  */
408 typedef char_u schar_T;
409 typedef unsigned short sattr_T;
410 #define MAX_TYPENR 65535
411 
412 /*
413  * The u8char_T can hold one decoded UTF-8 character.
414  * We use 32 bits, since some Asian characters don't fit in 16 bits.
415  */
416 typedef unsigned int u8char_T;	// int is 32 bits or more
417 
418 #ifndef UNIX		    /* For Unix this is included in os_unix.h */
419 # include <stdio.h>
420 # include <ctype.h>
421 #endif
422 
423 #include "ascii.h"
424 #include "keymap.h"
425 #include "term.h"
426 #include "macros.h"
427 
428 #ifdef LATTICE
429 # include <sys/types.h>
430 # include <sys/stat.h>
431 #endif
432 #ifdef _DCC
433 # include <sys/stat.h>
434 #endif
435 #if defined(MSWIN)
436 # include <sys/stat.h>
437 #endif
438 
439 #if defined(HAVE_ERRNO_H) || defined(MSWIN)
440 # include <errno.h>
441 #endif
442 
443 /*
444  * Allow other (non-unix) systems to configure themselves now
445  * These are also in os_unix.h, because osdef.sh needs them there.
446  */
447 #ifndef UNIX
448 /* Note: Some systems need both string.h and strings.h (Savage).  If the
449  * system can't handle this, define NO_STRINGS_WITH_STRING_H. */
450 # ifdef HAVE_STRING_H
451 #  include <string.h>
452 # endif
453 # if defined(HAVE_STRINGS_H) && !defined(NO_STRINGS_WITH_STRING_H)
454 #  include <strings.h>
455 # endif
456 # ifdef HAVE_STAT_H
457 #  include <stat.h>
458 # endif
459 # ifdef HAVE_STDLIB_H
460 #  include <stdlib.h>
461 # endif
462 #endif /* NON-UNIX */
463 
464 #include <assert.h>
465 
466 #ifdef HAVE_STDINT_H
467 # include <stdint.h>
468 #endif
469 #ifdef HAVE_INTTYPES_H
470 # include <inttypes.h>
471 #endif
472 #ifdef HAVE_WCTYPE_H
473 # include <wctype.h>
474 #endif
475 #include <stdarg.h>
476 
477 /* for offsetof() */
478 #include <stddef.h>
479 
480 #if defined(HAVE_SYS_SELECT_H) && \
481 	(!defined(HAVE_SYS_TIME_H) || defined(SYS_SELECT_WITH_SYS_TIME))
482 # include <sys/select.h>
483 #endif
484 
485 #ifndef HAVE_SELECT
486 # ifdef HAVE_SYS_POLL_H
487 #  include <sys/poll.h>
488 # elif defined(MSWIN)
489 #  define HAVE_SELECT
490 # else
491 #  ifdef HAVE_POLL_H
492 #   include <poll.h>
493 #  endif
494 # endif
495 #endif
496 
497 /* ================ end of the header file puzzle =============== */
498 
499 /*
500  * For dynamically loaded imm library. Currently, only for Win32.
501  */
502 #ifdef DYNAMIC_IME
503 # ifndef FEAT_MBYTE_IME
504 #  define FEAT_MBYTE_IME
505 # endif
506 #endif
507 
508 /*
509  * For dynamically loaded gettext library.  Currently, only for Win32.
510  */
511 #ifdef DYNAMIC_GETTEXT
512 # ifndef FEAT_GETTEXT
513 #  define FEAT_GETTEXT
514 # endif
515 /* These are in os_win32.c */
516 extern char *(*dyn_libintl_gettext)(const char *msgid);
517 extern char *(*dyn_libintl_ngettext)(const char *msgid, const char *msgid_plural, unsigned long n);
518 extern char *(*dyn_libintl_bindtextdomain)(const char *domainname, const char *dirname);
519 extern char *(*dyn_libintl_bind_textdomain_codeset)(const char *domainname, const char *codeset);
520 extern char *(*dyn_libintl_textdomain)(const char *domainname);
521 extern int (*dyn_libintl_wputenv)(const wchar_t *envstring);
522 #endif
523 
524 
525 /*
526  * The _() stuff is for using gettext().  It is a no-op when libintl.h is not
527  * found or the +multilang feature is disabled.
528  * Use NGETTEXT(single, multi, number) to get plural behavior:
529  * - single - message for singular form
530  * - multi  - message for plural form
531  * - number - the count
532  */
533 #ifdef FEAT_GETTEXT
534 # ifdef DYNAMIC_GETTEXT
535 #  define _(x) (*dyn_libintl_gettext)((char *)(x))
536 #  define NGETTEXT(x, xs, n) (*dyn_libintl_ngettext)((char *)(x), (char *)(xs), (n))
537 #  define N_(x) x
538 #  define bindtextdomain(domain, dir) (*dyn_libintl_bindtextdomain)((domain), (dir))
539 #  define bind_textdomain_codeset(domain, codeset) (*dyn_libintl_bind_textdomain_codeset)((domain), (codeset))
540 #  if !defined(HAVE_BIND_TEXTDOMAIN_CODESET)
541 #   define HAVE_BIND_TEXTDOMAIN_CODESET 1
542 #  endif
543 #  define textdomain(domain) (*dyn_libintl_textdomain)(domain)
544 #  define libintl_wputenv(envstring) (*dyn_libintl_wputenv)(envstring)
545 # else
546 #  include <libintl.h>
547 #  define _(x) gettext((char *)(x))
548 #  define NGETTEXT(x, xs, n) ngettext((x), (xs), (n))
549 #  ifdef gettext_noop
550 #   define N_(x) gettext_noop(x)
551 #  else
552 #   define N_(x) x
553 #  endif
554 # endif
555 #else
556 # define _(x) ((char *)(x))
557 # define NGETTEXT(x, xs, n) (((n) == 1) ? (char *)(x) : (char *)(xs))
558 # define N_(x) x
559 # ifdef bindtextdomain
560 #  undef bindtextdomain
561 # endif
562 # define bindtextdomain(x, y) /* empty */
563 # ifdef bind_textdomain_codeset
564 #  undef bind_textdomain_codeset
565 # endif
566 # define bind_textdomain_codeset(x, y) /* empty */
567 # ifdef textdomain
568 #  undef textdomain
569 # endif
570 # define textdomain(x) /* empty */
571 #endif
572 
573 /*
574  * flags for update_screen()
575  * The higher the value, the higher the priority
576  */
577 #define VALID_NO_UPDATE		 5  /* no new changes, keep the command line if
578 				       possible */
579 #define VALID			10  /* buffer not changed, or changes marked
580 				       with b_mod_* */
581 #define INVERTED		20  /* redisplay inverted part that changed */
582 #define INVERTED_ALL		25  /* redisplay whole inverted part */
583 #define REDRAW_TOP		30  /* display first w_upd_rows screen lines */
584 #define SOME_VALID		35  /* like NOT_VALID but may scroll */
585 #define NOT_VALID		40  /* buffer needs complete redraw */
586 #define CLEAR			50  /* screen messed up, clear it */
587 
588 /*
589  * Flags for w_valid.
590  * These are set when something in a window structure becomes invalid, except
591  * when the cursor is moved.  Call check_cursor_moved() before testing one of
592  * the flags.
593  * These are reset when that thing has been updated and is valid again.
594  *
595  * Every function that invalidates one of these must call one of the
596  * invalidate_* functions.
597  *
598  * w_valid is supposed to be used only in screen.c.  From other files, use the
599  * functions that set or reset the flags.
600  *
601  * VALID_BOTLINE    VALID_BOTLINE_AP
602  *     on		on		w_botline valid
603  *     off		on		w_botline approximated
604  *     off		off		w_botline not valid
605  *     on		off		not possible
606  */
607 #define VALID_WROW	0x01	// w_wrow (window row) is valid
608 #define VALID_WCOL	0x02	// w_wcol (window col) is valid
609 #define VALID_VIRTCOL	0x04	// w_virtcol (file col) is valid
610 #define VALID_CHEIGHT	0x08	// w_cline_height and w_cline_folded valid
611 #define VALID_CROW	0x10	// w_cline_row is valid
612 #define VALID_BOTLINE	0x20	// w_botine and w_empty_rows are valid
613 #define VALID_BOTLINE_AP 0x40	// w_botine is approximated
614 #define VALID_TOPLINE	0x80	// w_topline is valid (for cursor position)
615 
616 // Values for w_popup_flags.
617 #define POPF_IS_POPUP	1	// this is a popup window
618 #define POPF_HIDDEN	2	// popup is not displayed
619 #define POPF_HANDLED	4	// popup was just redrawn or filtered
620 #ifdef FEAT_TEXT_PROP
621 # define WIN_IS_POPUP(wp) ((wp)->w_popup_flags != 0)
622 #else
623 # define WIN_IS_POPUP(wp) 0
624 #endif
625 
626 /*
627  * Terminal highlighting attribute bits.
628  * Attributes above HL_ALL are used for syntax highlighting.
629  */
630 #define HL_NORMAL		0x00
631 #define HL_INVERSE		0x01
632 #define HL_BOLD			0x02
633 #define HL_ITALIC		0x04
634 #define HL_UNDERLINE		0x08
635 #define HL_UNDERCURL		0x10
636 #define HL_STANDOUT		0x20
637 #define HL_NOCOMBINE		0x40
638 #define HL_STRIKETHROUGH	0x80
639 #define HL_ALL			0xff
640 
641 /* special attribute addition: Put message in history */
642 #define MSG_HIST		0x1000
643 
644 /*
645  * values for State
646  *
647  * The lower bits up to 0x20 are used to distinguish normal/visual/op_pending
648  * and cmdline/insert+replace mode.  This is used for mapping.  If none of
649  * these bits are set, no mapping is done.
650  * The upper bits are used to distinguish between other states.
651  */
652 #define NORMAL		0x01	/* Normal mode, command expected */
653 #define VISUAL		0x02	/* Visual mode - use get_real_state() */
654 #define OP_PENDING	0x04	/* Normal mode, operator is pending - use
655 				   get_real_state() */
656 #define CMDLINE		0x08	/* Editing command line */
657 #define INSERT		0x10	/* Insert mode */
658 #define LANGMAP		0x20	/* Language mapping, can be combined with
659 				   INSERT and CMDLINE */
660 
661 #define REPLACE_FLAG	0x40	/* Replace mode flag */
662 #define REPLACE		(REPLACE_FLAG + INSERT)
663 #define VREPLACE_FLAG	0x80	/* Virtual-replace mode flag */
664 #define VREPLACE	(REPLACE_FLAG + VREPLACE_FLAG + INSERT)
665 #define LREPLACE	(REPLACE_FLAG + LANGMAP)
666 
667 #define NORMAL_BUSY	(0x100 + NORMAL) /* Normal mode, busy with a command */
668 #define HITRETURN	(0x200 + NORMAL) /* waiting for return or command */
669 #define ASKMORE		0x300	/* Asking if you want --more-- */
670 #define SETWSIZE	0x400	/* window size has changed */
671 #define ABBREV		0x500	/* abbreviation instead of mapping */
672 #define EXTERNCMD	0x600	/* executing an external command */
673 #define SHOWMATCH	(0x700 + INSERT) /* show matching paren */
674 #define CONFIRM		0x800	/* ":confirm" prompt */
675 #define SELECTMODE	0x1000	/* Select mode, only for mappings */
676 #define TERMINAL        0x2000  /* Terminal mode */
677 
678 /* all mode bits used for mapping */
679 #define MAP_ALL_MODES	(0x3f | SELECTMODE | TERMINAL)
680 
681 /* directions */
682 #define FORWARD			1
683 #define BACKWARD		(-1)
684 #define FORWARD_FILE		3
685 #define BACKWARD_FILE		(-3)
686 
687 /* return values for functions */
688 #if !(defined(OK) && (OK == 1))
689 /* OK already defined to 1 in MacOS X curses, skip this */
690 # define OK			1
691 #endif
692 #define FAIL			0
693 #define NOTDONE			2   /* not OK or FAIL but skipped */
694 
695 /* flags for b_flags */
696 #define BF_RECOVERED	0x01	/* buffer has been recovered */
697 #define BF_CHECK_RO	0x02	/* need to check readonly when loading file
698 				   into buffer (set by ":e", may be reset by
699 				   ":buf" */
700 #define BF_NEVERLOADED	0x04	/* file has never been loaded into buffer,
701 				   many variables still need to be set */
702 #define BF_NOTEDITED	0x08	/* Set when file name is changed after
703 				   starting to edit, reset when file is
704 				   written out. */
705 #define BF_NEW		0x10	/* file didn't exist when editing started */
706 #define BF_NEW_W	0x20	/* Warned for BF_NEW and file created */
707 #define BF_READERR	0x40	/* got errors while reading the file */
708 #define BF_DUMMY	0x80	/* dummy buffer, only used internally */
709 #define BF_PRESERVED	0x100	/* ":preserve" was used */
710 
711 /* Mask to check for flags that prevent normal writing */
712 #define BF_WRITE_MASK	(BF_NOTEDITED + BF_NEW + BF_READERR)
713 
714 /*
715  * values for xp_context when doing command line completion
716  */
717 #define EXPAND_UNSUCCESSFUL	(-2)
718 #define EXPAND_OK		(-1)
719 #define EXPAND_NOTHING		0
720 #define EXPAND_COMMANDS		1
721 #define EXPAND_FILES		2
722 #define EXPAND_DIRECTORIES	3
723 #define EXPAND_SETTINGS		4
724 #define EXPAND_BOOL_SETTINGS	5
725 #define EXPAND_TAGS		6
726 #define EXPAND_OLD_SETTING	7
727 #define EXPAND_HELP		8
728 #define EXPAND_BUFFERS		9
729 #define EXPAND_EVENTS		10
730 #define EXPAND_MENUS		11
731 #define EXPAND_SYNTAX		12
732 #define EXPAND_HIGHLIGHT	13
733 #define EXPAND_AUGROUP		14
734 #define EXPAND_USER_VARS	15
735 #define EXPAND_MAPPINGS		16
736 #define EXPAND_TAGS_LISTFILES	17
737 #define EXPAND_FUNCTIONS	18
738 #define EXPAND_USER_FUNC	19
739 #define EXPAND_EXPRESSION	20
740 #define EXPAND_MENUNAMES	21
741 #define EXPAND_USER_COMMANDS	22
742 #define EXPAND_USER_CMD_FLAGS	23
743 #define EXPAND_USER_NARGS	24
744 #define EXPAND_USER_COMPLETE	25
745 #define EXPAND_ENV_VARS		26
746 #define EXPAND_LANGUAGE		27
747 #define EXPAND_COLORS		28
748 #define EXPAND_COMPILER		29
749 #define EXPAND_USER_DEFINED	30
750 #define EXPAND_USER_LIST	31
751 #define EXPAND_SHELLCMD		32
752 #define EXPAND_CSCOPE		33
753 #define EXPAND_SIGN		34
754 #define EXPAND_PROFILE		35
755 #define EXPAND_BEHAVE		36
756 #define EXPAND_FILETYPE		37
757 #define EXPAND_FILES_IN_PATH	38
758 #define EXPAND_OWNSYNTAX	39
759 #define EXPAND_LOCALES		40
760 #define EXPAND_HISTORY		41
761 #define EXPAND_USER		42
762 #define EXPAND_SYNTIME		43
763 #define EXPAND_USER_ADDR_TYPE	44
764 #define EXPAND_PACKADD		45
765 #define EXPAND_MESSAGES		46
766 #define EXPAND_MAPCLEAR		47
767 #define EXPAND_ARGLIST		48
768 
769 /* Values for exmode_active (0 is no exmode) */
770 #define EXMODE_NORMAL		1
771 #define EXMODE_VIM		2
772 
773 /* Values for nextwild() and ExpandOne().  See ExpandOne() for meaning. */
774 #define WILD_FREE		1
775 #define WILD_EXPAND_FREE	2
776 #define WILD_EXPAND_KEEP	3
777 #define WILD_NEXT		4
778 #define WILD_PREV		5
779 #define WILD_ALL		6
780 #define WILD_LONGEST		7
781 #define WILD_ALL_KEEP		8
782 
783 #define WILD_LIST_NOTFOUND	0x01
784 #define WILD_HOME_REPLACE	0x02
785 #define WILD_USE_NL		0x04
786 #define WILD_NO_BEEP		0x08
787 #define WILD_ADD_SLASH		0x10
788 #define WILD_KEEP_ALL		0x20
789 #define WILD_SILENT		0x40
790 #define WILD_ESCAPE		0x80
791 #define WILD_ICASE		0x100
792 #define WILD_ALLLINKS		0x200
793 
794 // Flags for expand_wildcards()
795 #define EW_DIR		0x01	// include directory names
796 #define EW_FILE		0x02	// include file names
797 #define EW_NOTFOUND	0x04	// include not found names
798 #define EW_ADDSLASH	0x08	// append slash to directory name
799 #define EW_KEEPALL	0x10	// keep all matches
800 #define EW_SILENT	0x20	// don't print "1 returned" from shell
801 #define EW_EXEC		0x40	// executable files
802 #define EW_PATH		0x80	// search in 'path' too
803 #define EW_ICASE	0x100	// ignore case
804 #define EW_NOERROR	0x200	// no error for bad regexp
805 #define EW_NOTWILD	0x400	// add match with literal name if exists
806 #define EW_KEEPDOLLAR	0x800	// do not escape $, $var is expanded
807 // Note: mostly EW_NOTFOUND and EW_SILENT are mutually exclusive: EW_NOTFOUND
808 // is used when executing commands and EW_SILENT for interactive expanding.
809 #define EW_ALLLINKS	0x1000	// also links not pointing to existing file
810 #define EW_SHELLCMD	0x2000	// called from expand_shellcmd(), don't check
811 				// if executable is in $PATH
812 #define EW_DODOT	0x4000	// also files starting with a dot
813 #define EW_EMPTYOK	0x8000	// no matches is not an error
814 #define EW_NOTENV	0x10000	// do not expand environment variables
815 
816 /* Flags for find_file_*() functions. */
817 #define FINDFILE_FILE	0	/* only files */
818 #define FINDFILE_DIR	1	/* only directories */
819 #define FINDFILE_BOTH	2	/* files and directories */
820 
821 #define W_ENDCOL(wp)	(wp->w_wincol + wp->w_width)
822 #ifdef FEAT_MENU
823 # define W_WINROW(wp)	(wp->w_winrow + wp->w_winbar_height)
824 #else
825 # define W_WINROW(wp)	(wp->w_winrow)
826 #endif
827 
828 #ifdef NO_EXPANDPATH
829 # define gen_expand_wildcards mch_expand_wildcards
830 #endif
831 
832 /* Values for the find_pattern_in_path() function args 'type' and 'action': */
833 #define FIND_ANY	1
834 #define FIND_DEFINE	2
835 #define CHECK_PATH	3
836 
837 #define ACTION_SHOW	1
838 #define ACTION_GOTO	2
839 #define ACTION_SPLIT	3
840 #define ACTION_SHOW_ALL	4
841 #ifdef FEAT_INS_EXPAND
842 # define ACTION_EXPAND	5
843 #endif
844 
845 #ifdef FEAT_SYN_HL
846 # define SST_MIN_ENTRIES 150	/* minimal size for state stack array */
847 # define SST_MAX_ENTRIES 1000	/* maximal size for state stack array */
848 # define SST_FIX_STATES	 7	/* size of sst_stack[]. */
849 # define SST_DIST	 16	/* normal distance between entries */
850 # define SST_INVALID	(synstate_T *)-1	/* invalid syn_state pointer */
851 
852 # define HL_CONTAINED	0x01	/* not used on toplevel */
853 # define HL_TRANSP	0x02	/* has no highlighting	*/
854 # define HL_ONELINE	0x04	/* match within one line only */
855 # define HL_HAS_EOL	0x08	/* end pattern that matches with $ */
856 # define HL_SYNC_HERE	0x10	/* sync point after this item (syncing only) */
857 # define HL_SYNC_THERE	0x20	/* sync point at current line (syncing only) */
858 # define HL_MATCH	0x40	/* use match ID instead of item ID */
859 # define HL_SKIPNL	0x80	/* nextgroup can skip newlines */
860 # define HL_SKIPWHITE	0x100	/* nextgroup can skip white space */
861 # define HL_SKIPEMPTY	0x200	/* nextgroup can skip empty lines */
862 # define HL_KEEPEND	0x400	/* end match always kept */
863 # define HL_EXCLUDENL	0x800	/* exclude NL from match */
864 # define HL_DISPLAY	0x1000	/* only used for displaying, not syncing */
865 # define HL_FOLD	0x2000	/* define fold */
866 # define HL_EXTEND	0x4000	/* ignore a keepend */
867 # define HL_MATCHCONT	0x8000	/* match continued from previous line */
868 # define HL_TRANS_CONT	0x10000 /* transparent item without contains arg */
869 # define HL_CONCEAL	0x20000 /* can be concealed */
870 # define HL_CONCEALENDS	0x40000 /* can be concealed */
871 #endif
872 
873 /* Values for 'options' argument in do_search() and searchit() */
874 #define SEARCH_REV    0x01  /* go in reverse of previous dir. */
875 #define SEARCH_ECHO   0x02  /* echo the search command and handle options */
876 #define SEARCH_MSG    0x0c  /* give messages (yes, it's not 0x04) */
877 #define SEARCH_NFMSG  0x08  /* give all messages except not found */
878 #define SEARCH_OPT    0x10  /* interpret optional flags */
879 #define SEARCH_HIS    0x20  /* put search pattern in history */
880 #define SEARCH_END    0x40  /* put cursor at end of match */
881 #define SEARCH_NOOF   0x80  /* don't add offset to position */
882 #define SEARCH_START 0x100  /* start search without col offset */
883 #define SEARCH_MARK  0x200  /* set previous context mark */
884 #define SEARCH_KEEP  0x400  /* keep previous search pattern */
885 #define SEARCH_PEEK  0x800  /* peek for typed char, cancel search */
886 #define SEARCH_COL  0x1000  /* start at specified column instead of zero */
887 
888 // Values for find_ident_under_cursor()
889 #define FIND_IDENT	1	// find identifier (word)
890 #define FIND_STRING	2	// find any string (WORD)
891 #define FIND_EVAL	4	// include "->", "[]" and "."
892 #define FIND_NOERROR	8	// no error when no word found
893 
894 /* Values for file_name_in_line() */
895 #define FNAME_MESS	1	/* give error message */
896 #define FNAME_EXP	2	/* expand to path */
897 #define FNAME_HYP	4	/* check for hypertext link */
898 #define FNAME_INCL	8	/* apply 'includeexpr' */
899 #define FNAME_REL	16	/* ".." and "./" are relative to the (current)
900 				   file instead of the current directory */
901 #define FNAME_UNESC	32	/* remove backslashes used for escaping */
902 
903 /* Values for buflist_getfile() */
904 #define GETF_SETMARK	0x01	/* set pcmark before jumping */
905 #define GETF_ALT	0x02	/* jumping to alternate file (not buf num) */
906 #define GETF_SWITCH	0x04	/* respect 'switchbuf' settings when jumping */
907 
908 /* Return values of getfile() */
909 #define GETFILE_ERROR	    1	/* normal error */
910 #define GETFILE_NOT_WRITTEN 2	/* "not written" error */
911 #define GETFILE_SAME_FILE   0	/* success, same file */
912 #define GETFILE_OPEN_OTHER -1	/* success, opened another file */
913 #define GETFILE_UNUSED	    8
914 #define GETFILE_SUCCESS(x)  ((x) <= 0)
915 
916 /* Values for buflist_new() flags */
917 #define BLN_CURBUF	1	/* may re-use curbuf for new buffer */
918 #define BLN_LISTED	2	/* put new buffer in buffer list */
919 #define BLN_DUMMY	4	/* allocating dummy buffer */
920 #define BLN_NEW		8	/* create a new buffer */
921 #define BLN_NOOPT	16	/* don't copy options to existing buffer */
922 #define BLN_DUMMY_OK	32	/* also find an existing dummy buffer */
923 
924 /* Values for in_cinkeys() */
925 #define KEY_OPEN_FORW	0x101
926 #define KEY_OPEN_BACK	0x102
927 #define KEY_COMPLETE	0x103	/* end of completion */
928 
929 /* Values for "noremap" argument of ins_typebuf().  Also used for
930  * map->m_noremap and menu->noremap[]. */
931 #define REMAP_YES	0	/* allow remapping */
932 #define REMAP_NONE	-1	/* no remapping */
933 #define REMAP_SCRIPT	-2	/* remap script-local mappings only */
934 #define REMAP_SKIP	-3	/* no remapping for first char */
935 
936 /* Values for mch_call_shell() second argument */
937 #define SHELL_FILTER	1	/* filtering text */
938 #define SHELL_EXPAND	2	/* expanding wildcards */
939 #define SHELL_COOKED	4	/* set term to cooked mode */
940 #define SHELL_DOOUT	8	/* redirecting output */
941 #define SHELL_SILENT	16	/* don't print error returned by command */
942 #define SHELL_READ	32	/* read lines and insert into buffer */
943 #define SHELL_WRITE	64	/* write lines from buffer */
944 
945 /* Values returned by mch_nodetype() */
946 #define NODE_NORMAL	0	/* file or directory, check with mch_isdir()*/
947 #define NODE_WRITABLE	1	/* something we can write to (character
948 				   device, fifo, socket, ..) */
949 #define NODE_OTHER	2	/* non-writable thing (e.g., block device) */
950 
951 /* Values for readfile() flags */
952 #define READ_NEW	0x01	/* read a file into a new buffer */
953 #define READ_FILTER	0x02	/* read filter output */
954 #define READ_STDIN	0x04	/* read from stdin */
955 #define READ_BUFFER	0x08	/* read from curbuf (converting stdin) */
956 #define READ_DUMMY	0x10	/* reading into a dummy buffer */
957 #define READ_KEEP_UNDO	0x20	/* keep undo info */
958 #define READ_FIFO	0x40	/* read from fifo or socket */
959 
960 /* Values for change_indent() */
961 #define INDENT_SET	1	/* set indent */
962 #define INDENT_INC	2	/* increase indent */
963 #define INDENT_DEC	3	/* decrease indent */
964 
965 /* Values for flags argument for findmatchlimit() */
966 #define FM_BACKWARD	0x01	/* search backwards */
967 #define FM_FORWARD	0x02	/* search forwards */
968 #define FM_BLOCKSTOP	0x04	/* stop at start/end of block */
969 #define FM_SKIPCOMM	0x08	/* skip comments */
970 
971 /* Values for action argument for do_buffer() */
972 #define DOBUF_GOTO	0	/* go to specified buffer */
973 #define DOBUF_SPLIT	1	/* split window and go to specified buffer */
974 #define DOBUF_UNLOAD	2	/* unload specified buffer(s) */
975 #define DOBUF_DEL	3	/* delete specified buffer(s) from buflist */
976 #define DOBUF_WIPE	4	/* delete specified buffer(s) really */
977 
978 /* Values for start argument for do_buffer() */
979 #define DOBUF_CURRENT	0	/* "count" buffer from current buffer */
980 #define DOBUF_FIRST	1	/* "count" buffer from first buffer */
981 #define DOBUF_LAST	2	/* "count" buffer from last buffer */
982 #define DOBUF_MOD	3	/* "count" mod. buffer from current buffer */
983 
984 /* Values for sub_cmd and which_pat argument for search_regcomp() */
985 /* Also used for which_pat argument for searchit() */
986 #define RE_SEARCH	0	/* save/use pat in/from search_pattern */
987 #define RE_SUBST	1	/* save/use pat in/from subst_pattern */
988 #define RE_BOTH		2	/* save pat in both patterns */
989 #define RE_LAST		2	/* use last used pattern if "pat" is NULL */
990 
991 /* Second argument for vim_regcomp(). */
992 #define RE_MAGIC	1	/* 'magic' option */
993 #define RE_STRING	2	/* match in string instead of buffer text */
994 #define RE_STRICT	4	/* don't allow [abc] without ] */
995 #define RE_AUTO		8	/* automatic engine selection */
996 
997 #ifdef FEAT_SYN_HL
998 /* values for reg_do_extmatch */
999 # define REX_SET	1	/* to allow \z\(...\), */
1000 # define REX_USE	2	/* to allow \z\1 et al. */
1001 # define REX_ALL	(REX_SET | REX_USE)
1002 #endif
1003 
1004 /* Return values for fullpathcmp() */
1005 /* Note: can use (fullpathcmp() & FPC_SAME) to check for equal files */
1006 #define FPC_SAME	1	/* both exist and are the same file. */
1007 #define FPC_DIFF	2	/* both exist and are different files. */
1008 #define FPC_NOTX	4	/* both don't exist. */
1009 #define FPC_DIFFX	6	/* one of them doesn't exist. */
1010 #define FPC_SAMEX	7	/* both don't exist and file names are same. */
1011 
1012 /* flags for do_ecmd() */
1013 #define ECMD_HIDE	0x01	/* don't free the current buffer */
1014 #define ECMD_SET_HELP	0x02	/* set b_help flag of (new) buffer before
1015 				   opening file */
1016 #define ECMD_OLDBUF	0x04	/* use existing buffer if it exists */
1017 #define ECMD_FORCEIT	0x08	/* ! used in Ex command */
1018 #define ECMD_ADDBUF	0x10	/* don't edit, just add to buffer list */
1019 
1020 /* for lnum argument in do_ecmd() */
1021 #define ECMD_LASTL	(linenr_T)0	/* use last position in loaded file */
1022 #define ECMD_LAST	(linenr_T)-1	/* use last position in all files */
1023 #define ECMD_ONE	(linenr_T)1	/* use first line */
1024 
1025 /* flags for do_cmdline() */
1026 #define DOCMD_VERBOSE	0x01	/* included command in error message */
1027 #define DOCMD_NOWAIT	0x02	/* don't call wait_return() and friends */
1028 #define DOCMD_REPEAT	0x04	/* repeat exec. until getline() returns NULL */
1029 #define DOCMD_KEYTYPED	0x08	/* don't reset KeyTyped */
1030 #define DOCMD_EXCRESET	0x10	/* reset exception environment (for debugging)*/
1031 #define DOCMD_KEEPLINE  0x20	/* keep typed line for repeating with "." */
1032 
1033 /* flags for beginline() */
1034 #define BL_WHITE	1	/* cursor on first non-white in the line */
1035 #define BL_SOL		2	/* use 'sol' option */
1036 #define BL_FIX		4	/* don't leave cursor on a NUL */
1037 
1038 /* flags for mf_sync() */
1039 #define MFS_ALL		1	/* also sync blocks with negative numbers */
1040 #define MFS_STOP	2	/* stop syncing when a character is available */
1041 #define MFS_FLUSH	4	/* flushed file to disk */
1042 #define MFS_ZERO	8	/* only write block 0 */
1043 
1044 /* flags for buf_copy_options() */
1045 #define BCO_ENTER	1	/* going to enter the buffer */
1046 #define BCO_ALWAYS	2	/* always copy the options */
1047 #define BCO_NOHELP	4	/* don't touch the help related options */
1048 
1049 /* flags for do_put() */
1050 #define PUT_FIXINDENT	1	/* make indent look nice */
1051 #define PUT_CURSEND	2	/* leave cursor after end of new text */
1052 #define PUT_CURSLINE	4	/* leave cursor on last line of new text */
1053 #define PUT_LINE	8	/* put register as lines */
1054 #define PUT_LINE_SPLIT	16	/* split line for linewise register */
1055 #define PUT_LINE_FORWARD 32	/* put linewise register below Visual sel. */
1056 
1057 /* flags for set_indent() */
1058 #define SIN_CHANGED	1	/* call changed_bytes() when line changed */
1059 #define SIN_INSERT	2	/* insert indent before existing text */
1060 #define SIN_UNDO	4	/* save line for undo before changing it */
1061 
1062 /* flags for insertchar() */
1063 #define INSCHAR_FORMAT	1	/* force formatting */
1064 #define INSCHAR_DO_COM	2	/* format comments */
1065 #define INSCHAR_CTRLV	4	/* char typed just after CTRL-V */
1066 #define INSCHAR_NO_FEX	8	/* don't use 'formatexpr' */
1067 #define INSCHAR_COM_LIST 16	/* format comments with list/2nd line indent */
1068 
1069 /* flags for open_line() */
1070 #define OPENLINE_DELSPACES  1	/* delete spaces after cursor */
1071 #define OPENLINE_DO_COM	    2	/* format comments */
1072 #define OPENLINE_KEEPTRAIL  4	/* keep trailing spaces */
1073 #define OPENLINE_MARKFIX    8	/* fix mark positions */
1074 #define OPENLINE_COM_LIST  16	/* format comments with list/2nd line indent */
1075 
1076 /*
1077  * There are five history tables:
1078  */
1079 #define HIST_CMD	0	/* colon commands */
1080 #define HIST_SEARCH	1	/* search commands */
1081 #define HIST_EXPR	2	/* expressions (from entering = register) */
1082 #define HIST_INPUT	3	/* input() lines */
1083 #define HIST_DEBUG	4	/* debug commands */
1084 #define HIST_COUNT	5	/* number of history tables */
1085 
1086 /* The type numbers are fixed for backwards compatibility. */
1087 #define BARTYPE_VERSION 1
1088 #define BARTYPE_HISTORY 2
1089 #define BARTYPE_REGISTER 3
1090 #define BARTYPE_MARK 4
1091 
1092 #define VIMINFO_VERSION 4
1093 #define VIMINFO_VERSION_WITH_HISTORY 2
1094 #define VIMINFO_VERSION_WITH_REGISTERS 3
1095 #define VIMINFO_VERSION_WITH_MARKS 4
1096 
1097 typedef enum {
1098     BVAL_NR,
1099     BVAL_STRING,
1100     BVAL_EMPTY
1101 } btype_T;
1102 
1103 typedef struct {
1104     btype_T	bv_type;
1105     long	bv_nr;
1106     char_u	*bv_string;
1107     int		bv_len;		/* length of bv_string */
1108     int		bv_allocated;	/* bv_string was allocated */
1109 } bval_T;
1110 
1111 /*
1112  * Values for do_tag().
1113  */
1114 #define DT_TAG		1	/* jump to newer position or same tag again */
1115 #define DT_POP		2	/* jump to older position */
1116 #define DT_NEXT		3	/* jump to next match of same tag */
1117 #define DT_PREV		4	/* jump to previous match of same tag */
1118 #define DT_FIRST	5	/* jump to first match of same tag */
1119 #define DT_LAST		6	/* jump to first match of same tag */
1120 #define DT_SELECT	7	/* jump to selection from list */
1121 #define DT_HELP		8	/* like DT_TAG, but no wildcards */
1122 #define DT_JUMP		9	/* jump to new tag or selection from list */
1123 #define DT_CSCOPE	10	/* cscope find command (like tjump) */
1124 #define DT_LTAG		11	/* tag using location list */
1125 #define DT_FREE		99	/* free cached matches */
1126 
1127 /*
1128  * flags for find_tags().
1129  */
1130 #define TAG_HELP	1	// only search for help tags
1131 #define TAG_NAMES	2	// only return name of tag
1132 #define	TAG_REGEXP	4	// use tag pattern as regexp
1133 #define	TAG_NOIC	8	// don't always ignore case
1134 #ifdef FEAT_CSCOPE
1135 # define TAG_CSCOPE	16	// cscope tag
1136 #endif
1137 #define TAG_VERBOSE	32	// message verbosity
1138 #define TAG_INS_COMP	64	// Currently doing insert completion
1139 #define TAG_KEEP_LANG	128	// keep current language
1140 #define TAG_NO_TAGFUNC	256	// do not use 'tagfunc'
1141 
1142 #define TAG_MANY	300	// When finding many tags (for completion),
1143 				// find up to this many tags
1144 
1145 /*
1146  * Types of dialogs passed to do_vim_dialog().
1147  */
1148 #define VIM_GENERIC	0
1149 #define VIM_ERROR	1
1150 #define VIM_WARNING	2
1151 #define VIM_INFO	3
1152 #define VIM_QUESTION	4
1153 #define VIM_LAST_TYPE	4	/* sentinel value */
1154 
1155 /*
1156  * Return values for functions like gui_yesnocancel()
1157  */
1158 #define VIM_YES		2
1159 #define VIM_NO		3
1160 #define VIM_CANCEL	4
1161 #define VIM_ALL		5
1162 #define VIM_DISCARDALL  6
1163 
1164 /*
1165  * arguments for win_split()
1166  */
1167 #define WSP_ROOM	1	/* require enough room */
1168 #define WSP_VERT	2	/* split vertically */
1169 #define WSP_TOP		4	/* window at top-left of shell */
1170 #define WSP_BOT		8	/* window at bottom-right of shell */
1171 #define WSP_HELP	16	/* creating the help window */
1172 #define WSP_BELOW	32	/* put new window below/right */
1173 #define WSP_ABOVE	64	/* put new window above/left */
1174 #define WSP_NEWLOC	128	/* don't copy location list */
1175 
1176 /*
1177  * arguments for gui_set_shellsize()
1178  */
1179 #define RESIZE_VERT	1	/* resize vertically */
1180 #define RESIZE_HOR	2	/* resize horizontally */
1181 #define RESIZE_BOTH	15	/* resize in both directions */
1182 
1183 /*
1184  * flags for check_changed()
1185  */
1186 #define CCGD_AW		1	/* do autowrite if buffer was changed */
1187 #define CCGD_MULTWIN	2	/* check also when several wins for the buf */
1188 #define CCGD_FORCEIT	4	/* ! used */
1189 #define CCGD_ALLBUF	8	/* may write all buffers */
1190 #define CCGD_EXCMD	16	/* may suggest using ! */
1191 
1192 /*
1193  * "flags" values for option-setting functions.
1194  * When OPT_GLOBAL and OPT_LOCAL are both missing, set both local and global
1195  * values, get local value.
1196  */
1197 #define OPT_FREE	1	/* free old value if it was allocated */
1198 #define OPT_GLOBAL	2	/* use global value */
1199 #define OPT_LOCAL	4	/* use local value */
1200 #define OPT_MODELINE	8	/* option in modeline */
1201 #define OPT_WINONLY	16	/* only set window-local options */
1202 #define OPT_NOWIN	32	/* don't set window-local options */
1203 
1204 /* Magic chars used in confirm dialog strings */
1205 #define DLG_BUTTON_SEP	'\n'
1206 #define DLG_HOTKEY_CHAR	'&'
1207 
1208 /* Values for "starting" */
1209 #define NO_SCREEN	2	/* no screen updating yet */
1210 #define NO_BUFFERS	1	/* not all buffers loaded yet */
1211 /*			0	   not starting anymore */
1212 
1213 /* Values for swap_exists_action: what to do when swap file already exists */
1214 #define SEA_NONE	0	/* don't use dialog */
1215 #define SEA_DIALOG	1	/* use dialog when possible */
1216 #define SEA_QUIT	2	/* quit editing the file */
1217 #define SEA_RECOVER	3	/* recover the file */
1218 
1219 /*
1220  * Minimal size for block 0 of a swap file.
1221  * NOTE: This depends on size of struct block0! It's not done with a sizeof(),
1222  * because struct block0 is defined in memline.c (Sorry).
1223  * The maximal block size is arbitrary.
1224  */
1225 #define MIN_SWAP_PAGE_SIZE 1048
1226 #define MAX_SWAP_PAGE_SIZE 50000
1227 
1228 /* Special values for current_sctx.sc_sid. */
1229 #define SID_MODELINE	-1	/* when using a modeline */
1230 #define SID_CMDARG	-2	/* for "--cmd" argument */
1231 #define SID_CARG	-3	/* for "-c" argument */
1232 #define SID_ENV		-4	/* for sourcing environment variable */
1233 #define SID_ERROR	-5	/* option was reset because of an error */
1234 #define SID_NONE	-6	/* don't set scriptID */
1235 
1236 /*
1237  * Events for autocommands.
1238  */
1239 enum auto_event
1240 {
1241     EVENT_BUFADD = 0,		// after adding a buffer to the buffer list
1242     EVENT_BUFDELETE,		// deleting a buffer from the buffer list
1243     EVENT_BUFENTER,		// after entering a buffer
1244     EVENT_BUFFILEPOST,		// after renaming a buffer
1245     EVENT_BUFFILEPRE,		// before renaming a buffer
1246     EVENT_BUFHIDDEN,		// just after buffer becomes hidden
1247     EVENT_BUFLEAVE,		// before leaving a buffer
1248     EVENT_BUFNEW,		// after creating any buffer
1249     EVENT_BUFNEWFILE,		// when creating a buffer for a new file
1250     EVENT_BUFREADCMD,		// read buffer using command
1251     EVENT_BUFREADPOST,		// after reading a buffer
1252     EVENT_BUFREADPRE,		// before reading a buffer
1253     EVENT_BUFUNLOAD,		// just before unloading a buffer
1254     EVENT_BUFWINENTER,		// after showing a buffer in a window
1255     EVENT_BUFWINLEAVE,		// just after buffer removed from window
1256     EVENT_BUFWIPEOUT,		// just before really deleting a buffer
1257     EVENT_BUFWRITECMD,		// write buffer using command
1258     EVENT_BUFWRITEPOST,		// after writing a buffer
1259     EVENT_BUFWRITEPRE,		// before writing a buffer
1260     EVENT_CMDLINECHANGED,	// command line was modified
1261     EVENT_CMDLINEENTER,		// after entering the command line
1262     EVENT_CMDLINELEAVE,		// before leaving the command line
1263     EVENT_CMDUNDEFINED,		// command undefined
1264     EVENT_CMDWINENTER,		// after entering the cmdline window
1265     EVENT_CMDWINLEAVE,		// before leaving the cmdline window
1266     EVENT_COLORSCHEME,		// after loading a colorscheme
1267     EVENT_COLORSCHEMEPRE,	// before loading a colorscheme
1268     EVENT_COMPLETECHANGED,	// after completion popup menu changed
1269     EVENT_COMPLETEDONE,		// after finishing insert complete
1270     EVENT_CURSORHOLD,		// cursor in same position for a while
1271     EVENT_CURSORHOLDI,		// idem, in Insert mode
1272     EVENT_CURSORMOVED,		// cursor was moved
1273     EVENT_CURSORMOVEDI,		// cursor was moved in Insert mode
1274     EVENT_DIFFUPDATED,		// after diffs were updated
1275     EVENT_DIRCHANGED,		// after user changed directory
1276     EVENT_ENCODINGCHANGED,	// after changing the 'encoding' option
1277     EVENT_EXITPRE,		// before exiting
1278     EVENT_FILEAPPENDCMD,	// append to a file using command
1279     EVENT_FILEAPPENDPOST,	// after appending to a file
1280     EVENT_FILEAPPENDPRE,	// before appending to a file
1281     EVENT_FILECHANGEDRO,	// before first change to read-only file
1282     EVENT_FILECHANGEDSHELL,	// after shell command that changed file
1283     EVENT_FILECHANGEDSHELLPOST,	// after (not) reloading changed file
1284     EVENT_FILEREADCMD,		// read from a file using command
1285     EVENT_FILEREADPOST,		// after reading a file
1286     EVENT_FILEREADPRE,		// before reading a file
1287     EVENT_FILETYPE,		// new file type detected (user defined)
1288     EVENT_FILEWRITECMD,		// write to a file using command
1289     EVENT_FILEWRITEPOST,	// after writing a file
1290     EVENT_FILEWRITEPRE,		// before writing a file
1291     EVENT_FILTERREADPOST,	// after reading from a filter
1292     EVENT_FILTERREADPRE,	// before reading from a filter
1293     EVENT_FILTERWRITEPOST,	// after writing to a filter
1294     EVENT_FILTERWRITEPRE,	// before writing to a filter
1295     EVENT_FOCUSGAINED,		// got the focus
1296     EVENT_FOCUSLOST,		// lost the focus to another app
1297     EVENT_FUNCUNDEFINED,	// if calling a function which doesn't exist
1298     EVENT_GUIENTER,		// after starting the GUI
1299     EVENT_GUIFAILED,		// after starting the GUI failed
1300     EVENT_INSERTCHANGE,		// when changing Insert/Replace mode
1301     EVENT_INSERTCHARPRE,	// before inserting a char
1302     EVENT_INSERTENTER,		// when entering Insert mode
1303     EVENT_INSERTLEAVE,		// when leaving Insert mode
1304     EVENT_MENUPOPUP,		// just before popup menu is displayed
1305     EVENT_OPTIONSET,		// option was set
1306     EVENT_QUICKFIXCMDPOST,	// after :make, :grep etc.
1307     EVENT_QUICKFIXCMDPRE,	// before :make, :grep etc.
1308     EVENT_QUITPRE,		// before :quit
1309     EVENT_REMOTEREPLY,		// upon string reception from a remote vim
1310     EVENT_SESSIONLOADPOST,	// after loading a session file
1311     EVENT_SHELLCMDPOST,		// after ":!cmd"
1312     EVENT_SHELLFILTERPOST,	// after ":1,2!cmd", ":w !cmd", ":r !cmd".
1313     EVENT_SOURCECMD,		// sourcing a Vim script using command
1314     EVENT_SOURCEPRE,		// before sourcing a Vim script
1315     EVENT_SOURCEPOST,		// after sourcing a Vim script
1316     EVENT_SPELLFILEMISSING,	// spell file missing
1317     EVENT_STDINREADPOST,	// after reading from stdin
1318     EVENT_STDINREADPRE,		// before reading from stdin
1319     EVENT_SWAPEXISTS,		// found existing swap file
1320     EVENT_SYNTAX,		// syntax selected
1321     EVENT_TABCLOSED,		// after closing a tab page
1322     EVENT_TABENTER,		// after entering a tab page
1323     EVENT_TABLEAVE,		// before leaving a tab page
1324     EVENT_TABNEW,		// when entering a new tab page
1325     EVENT_TERMCHANGED,		// after changing 'term'
1326     EVENT_TERMINALOPEN,		// after a terminal buffer was created
1327     EVENT_TERMRESPONSE,		// after setting "v:termresponse"
1328     EVENT_TEXTCHANGED,		// text was modified not in Insert mode
1329     EVENT_TEXTCHANGEDI,         // text was modified in Insert mode
1330     EVENT_TEXTCHANGEDP,         // TextChangedI with popup menu visible
1331     EVENT_TEXTYANKPOST,		// after some text was yanked
1332     EVENT_USER,			// user defined autocommand
1333     EVENT_VIMENTER,		// after starting Vim
1334     EVENT_VIMLEAVE,		// before exiting Vim
1335     EVENT_VIMLEAVEPRE,		// before exiting Vim and writing .viminfo
1336     EVENT_VIMRESIZED,		// after Vim window was resized
1337     EVENT_WINENTER,		// after entering a window
1338     EVENT_WINLEAVE,		// before leaving a window
1339     EVENT_WINNEW,		// when entering a new window
1340 
1341     NUM_EVENTS			// MUST be the last one
1342 };
1343 
1344 typedef enum auto_event event_T;
1345 
1346 /*
1347  * Values for index in highlight_attr[].
1348  * When making changes, also update HL_FLAGS below!  And update the default
1349  * value of 'highlight' in option.c.
1350  */
1351 typedef enum
1352 {
1353     HLF_8 = 0	    /* Meta & special keys listed with ":map", text that is
1354 		       displayed different from what it is */
1355     , HLF_EOB	    /* after the last line in the buffer */
1356     , HLF_AT	    /* @ characters at end of screen, characters that
1357 		       don't really exist in the text */
1358     , HLF_D	    /* directories in CTRL-D listing */
1359     , HLF_E	    /* error messages */
1360     , HLF_H	    /* obsolete, ignored */
1361     , HLF_I	    /* incremental search */
1362     , HLF_L	    /* last search string */
1363     , HLF_M	    /* "--More--" message */
1364     , HLF_CM	    /* Mode (e.g., "-- INSERT --") */
1365     , HLF_N	    /* line number for ":number" and ":#" commands */
1366     , HLF_CLN	    /* current line number */
1367     , HLF_R	    /* return to continue message and yes/no questions */
1368     , HLF_S	    /* status lines */
1369     , HLF_SNC	    /* status lines of not-current windows */
1370     , HLF_C	    /* column to separate vertically split windows */
1371     , HLF_T	    /* Titles for output from ":set all", ":autocmd" etc. */
1372     , HLF_V	    /* Visual mode */
1373     , HLF_VNC	    /* Visual mode, autoselecting and not clipboard owner */
1374     , HLF_W	    /* warning messages */
1375     , HLF_WM	    /* Wildmenu highlight */
1376     , HLF_FL	    /* Folded line */
1377     , HLF_FC	    /* Fold column */
1378     , HLF_ADD	    /* Added diff line */
1379     , HLF_CHD	    /* Changed diff line */
1380     , HLF_DED	    /* Deleted diff line */
1381     , HLF_TXD	    /* Text Changed in diff line */
1382     , HLF_CONCEAL   /* Concealed text */
1383     , HLF_SC	    /* Sign column */
1384     , HLF_SPB	    /* SpellBad */
1385     , HLF_SPC	    /* SpellCap */
1386     , HLF_SPR	    /* SpellRare */
1387     , HLF_SPL	    /* SpellLocal */
1388     , HLF_PNI	    /* popup menu normal item */
1389     , HLF_PSI	    /* popup menu selected item */
1390     , HLF_PSB	    /* popup menu scrollbar */
1391     , HLF_PST	    /* popup menu scrollbar thumb */
1392     , HLF_TP	    /* tabpage line */
1393     , HLF_TPS	    /* tabpage line selected */
1394     , HLF_TPF	    /* tabpage line filler */
1395     , HLF_CUC	    /* 'cursorcolumn' */
1396     , HLF_CUL	    /* 'cursorline' */
1397     , HLF_MC	    /* 'colorcolumn' */
1398     , HLF_QFL	    /* quickfix window line currently selected */
1399     , HLF_ST	    /* status lines of terminal windows */
1400     , HLF_STNC	    /* status lines of not-current terminal windows */
1401     , HLF_COUNT	    /* MUST be the last one */
1402 } hlf_T;
1403 
1404 /* The HL_FLAGS must be in the same order as the HLF_ enums!
1405  * When changing this also adjust the default for 'highlight'. */
1406 #define HL_FLAGS {'8', '~', '@', 'd', 'e', 'h', 'i', 'l', 'm', 'M', \
1407 		  'n', 'N', 'r', 's', 'S', 'c', 't', 'v', 'V', 'w', 'W', \
1408 		  'f', 'F', 'A', 'C', 'D', 'T', '-', '>', \
1409 		  'B', 'P', 'R', 'L', \
1410 		  '+', '=', 'x', 'X', '*', '#', '_', '!', '.', 'o', 'q', \
1411 		  'z', 'Z'}
1412 
1413 /*
1414  * Boolean constants
1415  */
1416 #ifndef TRUE
1417 # define FALSE	0	    /* note: this is an int, not a long! */
1418 # define TRUE	1
1419 #endif
1420 
1421 #define MAYBE	2	    /* sometimes used for a variant on TRUE */
1422 
1423 #ifndef UINT32_T
1424 typedef UINT32_TYPEDEF UINT32_T;
1425 #endif
1426 
1427 /*
1428  * Operator IDs; The order must correspond to opchars[] in ops.c!
1429  */
1430 #define OP_NOP		0	/* no pending operation */
1431 #define OP_DELETE	1	/* "d"  delete operator */
1432 #define OP_YANK		2	/* "y"  yank operator */
1433 #define OP_CHANGE	3	/* "c"  change operator */
1434 #define OP_LSHIFT	4	/* "<"  left shift operator */
1435 #define OP_RSHIFT	5	/* ">"  right shift operator */
1436 #define OP_FILTER	6	/* "!"  filter operator */
1437 #define OP_TILDE	7	/* "g~" switch case operator */
1438 #define OP_INDENT	8	/* "="  indent operator */
1439 #define OP_FORMAT	9	/* "gq" format operator */
1440 #define OP_COLON	10	/* ":"  colon operator */
1441 #define OP_UPPER	11	/* "gU" make upper case operator */
1442 #define OP_LOWER	12	/* "gu" make lower case operator */
1443 #define OP_JOIN		13	/* "J"  join operator, only for Visual mode */
1444 #define OP_JOIN_NS	14	/* "gJ"  join operator, only for Visual mode */
1445 #define OP_ROT13	15	/* "g?" rot-13 encoding */
1446 #define OP_REPLACE	16	/* "r"  replace chars, only for Visual mode */
1447 #define OP_INSERT	17	/* "I"  Insert column, only for Visual mode */
1448 #define OP_APPEND	18	/* "A"  Append column, only for Visual mode */
1449 #define OP_FOLD		19	/* "zf" define a fold */
1450 #define OP_FOLDOPEN	20	/* "zo" open folds */
1451 #define OP_FOLDOPENREC	21	/* "zO" open folds recursively */
1452 #define OP_FOLDCLOSE	22	/* "zc" close folds */
1453 #define OP_FOLDCLOSEREC	23	/* "zC" close folds recursively */
1454 #define OP_FOLDDEL	24	/* "zd" delete folds */
1455 #define OP_FOLDDELREC	25	/* "zD" delete folds recursively */
1456 #define OP_FORMAT2	26	/* "gw" format operator, keeps cursor pos */
1457 #define OP_FUNCTION	27	/* "g@" call 'operatorfunc' */
1458 #define OP_NR_ADD	28	/* "<C-A>" Add to the number or alphabetic
1459 				   character (OP_ADD conflicts with Perl) */
1460 #define OP_NR_SUB	29	/* "<C-X>" Subtract from the number or
1461 				   alphabetic character */
1462 
1463 /*
1464  * Motion types, used for operators and for yank/delete registers.
1465  */
1466 #define MCHAR	0		/* character-wise movement/register */
1467 #define MLINE	1		/* line-wise movement/register */
1468 #define MBLOCK	2		/* block-wise register */
1469 
1470 #define MAUTO	0xff		/* Decide between MLINE/MCHAR */
1471 
1472 /*
1473  * Minimum screen size
1474  */
1475 #define MIN_COLUMNS	12	/* minimal columns for screen */
1476 #define MIN_LINES	2	/* minimal lines for screen */
1477 #define STATUS_HEIGHT	1	/* height of a status line under a window */
1478 #ifdef FEAT_MENU		/* height of a status line under a window */
1479 # define WINBAR_HEIGHT(wp)	(wp)->w_winbar_height
1480 # define VISIBLE_HEIGHT(wp)	((wp)->w_height + (wp)->w_winbar_height)
1481 #else
1482 # define WINBAR_HEIGHT(wp)	0
1483 # define VISIBLE_HEIGHT(wp)	(wp)->w_height
1484 #endif
1485 #define QF_WINHEIGHT	10	/* default height for quickfix window */
1486 
1487 /*
1488  * Buffer sizes
1489  */
1490 #ifndef CMDBUFFSIZE
1491 # define CMDBUFFSIZE	256	/* size of the command processing buffer */
1492 #endif
1493 
1494 #define LSIZE	    512		/* max. size of a line in the tags file */
1495 
1496 #define IOSIZE	   (1024+1)	/* file i/o and sprintf buffer size */
1497 
1498 #define DIALOG_MSG_SIZE 1000	/* buffer size for dialog_msg() */
1499 
1500 #define MSG_BUF_LEN 480	/* length of buffer for small messages */
1501 #define MSG_BUF_CLEN  (MSG_BUF_LEN / 6)    /* cell length (worst case: utf-8
1502 					       takes 6 bytes for one cell) */
1503 
1504 #define FOLD_TEXT_LEN  51	/* buffer size for get_foldtext() */
1505 
1506 /* Size of the buffer used for tgetent().  Unfortunately this is largely
1507  * undocumented, some systems use 1024.  Using a buffer that is too small
1508  * causes a buffer overrun and a crash.  Use the maximum known value to stay
1509  * on the safe side. */
1510 #define TBUFSZ 2048		/* buffer size for termcap entry */
1511 
1512 /*
1513  * Maximum length of key sequence to be mapped.
1514  * Must be able to hold an Amiga resize report.
1515  */
1516 #define MAXMAPLEN   50
1517 
1518 /* Size in bytes of the hash used in the undo file. */
1519 #define UNDO_HASH_SIZE 32
1520 
1521 #ifdef HAVE_FCNTL_H
1522 # include <fcntl.h>
1523 #endif
1524 
1525 #ifdef BINARY_FILE_IO
1526 # define WRITEBIN   "wb"	/* no CR-LF translation */
1527 # define READBIN    "rb"
1528 # define APPENDBIN  "ab"
1529 #else
1530 # define WRITEBIN   "w"
1531 # define READBIN    "r"
1532 # define APPENDBIN  "a"
1533 #endif
1534 
1535 /*
1536  * EMX doesn't have a global way of making open() use binary I/O.
1537  * Use O_BINARY for all open() calls.
1538  */
1539 #if defined(__CYGWIN32__)
1540 # define O_EXTRA    O_BINARY
1541 #else
1542 # define O_EXTRA    0
1543 #endif
1544 
1545 #ifndef O_NOFOLLOW
1546 # define O_NOFOLLOW 0
1547 #endif
1548 
1549 #ifndef W_OK
1550 # define W_OK 2		/* for systems that don't have W_OK in unistd.h */
1551 #endif
1552 #ifndef R_OK
1553 # define R_OK 4		/* for systems that don't have R_OK in unistd.h */
1554 #endif
1555 
1556 // Allocate memory for one type and cast the returned pointer to have the
1557 // compiler check the types.
1558 #define ALLOC_ONE(type)  (type *)alloc(sizeof(type))
1559 #define ALLOC_MULT(type, count)  (type *)alloc(sizeof(type) * (count))
1560 #define ALLOC_CLEAR_ONE(type)  (type *)alloc_clear(sizeof(type))
1561 #define ALLOC_CLEAR_MULT(type, count)  (type *)alloc_clear(sizeof(type) * (count))
1562 #define LALLOC_CLEAR_ONE(type)  (type *)lalloc_clear(sizeof(type), FALSE)
1563 #define LALLOC_CLEAR_MULT(type, count)  (type *)lalloc_clear(sizeof(type) * (count), FALSE)
1564 #define LALLOC_MULT(type, count)  (type *)lalloc(sizeof(type) * (count), FALSE)
1565 
1566 /*
1567  * defines to avoid typecasts from (char_u *) to (char *) and back
1568  * (vim_strchr() and vim_strrchr() are now in alloc.c)
1569  */
1570 #define STRLEN(s)	    strlen((char *)(s))
1571 #define STRCPY(d, s)	    strcpy((char *)(d), (char *)(s))
1572 #define STRNCPY(d, s, n)    strncpy((char *)(d), (char *)(s), (size_t)(n))
1573 #define STRCMP(d, s)	    strcmp((char *)(d), (char *)(s))
1574 #define STRNCMP(d, s, n)    strncmp((char *)(d), (char *)(s), (size_t)(n))
1575 #ifdef HAVE_STRCASECMP
1576 # define STRICMP(d, s)	    strcasecmp((char *)(d), (char *)(s))
1577 #else
1578 # ifdef HAVE_STRICMP
1579 #  define STRICMP(d, s)	    stricmp((char *)(d), (char *)(s))
1580 # else
1581 #  define STRICMP(d, s)	    vim_stricmp((char *)(d), (char *)(s))
1582 # endif
1583 #endif
1584 
1585 /* Like strcpy() but allows overlapped source and destination. */
1586 #define STRMOVE(d, s)	    mch_memmove((d), (s), STRLEN(s) + 1)
1587 
1588 #ifdef HAVE_STRNCASECMP
1589 # define STRNICMP(d, s, n)  strncasecmp((char *)(d), (char *)(s), (size_t)(n))
1590 #else
1591 # ifdef HAVE_STRNICMP
1592 #  define STRNICMP(d, s, n) strnicmp((char *)(d), (char *)(s), (size_t)(n))
1593 # else
1594 #  define STRNICMP(d, s, n) vim_strnicmp((char *)(d), (char *)(s), (size_t)(n))
1595 # endif
1596 #endif
1597 
1598 /* We need to call mb_stricmp() even when we aren't dealing with a multi-byte
1599  * encoding because mb_stricmp() takes care of all ascii and non-ascii
1600  * encodings, including characters with umlauts in latin1, etc., while
1601  * STRICMP() only handles the system locale version, which often does not
1602  * handle non-ascii properly. */
1603 
1604 # define MB_STRICMP(d, s)	mb_strnicmp((char_u *)(d), (char_u *)(s), (int)MAXCOL)
1605 # define MB_STRNICMP(d, s, n)	mb_strnicmp((char_u *)(d), (char_u *)(s), (int)(n))
1606 
1607 #define STRCAT(d, s)	    strcat((char *)(d), (char *)(s))
1608 #define STRNCAT(d, s, n)    strncat((char *)(d), (char *)(s), (size_t)(n))
1609 
1610 #ifdef HAVE_STRPBRK
1611 # define vim_strpbrk(s, cs) (char_u *)strpbrk((char *)(s), (char *)(cs))
1612 #endif
1613 
1614 #define OUT_STR(s)		    out_str((char_u *)(s))
1615 #define OUT_STR_NF(s)		    out_str_nf((char_u *)(s))
1616 
1617 #ifdef FEAT_GUI
1618 # ifdef FEAT_TERMGUICOLORS
1619 #  define GUI_FUNCTION(f)	    (gui.in_use ? gui_##f : termgui_##f)
1620 #  define GUI_FUNCTION2(f, pixel)   (gui.in_use \
1621 				    ?  ((pixel) != INVALCOLOR \
1622 					? gui_##f((pixel)) \
1623 					: INVALCOLOR) \
1624 				    : termgui_##f((pixel)))
1625 #  define USE_24BIT		    (gui.in_use || p_tgc)
1626 # else
1627 #  define GUI_FUNCTION(f)	    gui_##f
1628 #  define GUI_FUNCTION2(f,pixel)    ((pixel) != INVALCOLOR \
1629 				     ? gui_##f((pixel)) \
1630 				     : INVALCOLOR)
1631 #  define USE_24BIT		    gui.in_use
1632 # endif
1633 #else
1634 # ifdef FEAT_TERMGUICOLORS
1635 #  define GUI_FUNCTION(f)	    termgui_##f
1636 #  define GUI_FUNCTION2(f, pixel)   termgui_##f((pixel))
1637 #  define USE_24BIT		    p_tgc
1638 # endif
1639 #endif
1640 #ifdef FEAT_TERMGUICOLORS
1641 # define IS_CTERM		    (t_colors > 1 || p_tgc)
1642 #else
1643 # define IS_CTERM		    (t_colors > 1)
1644 #endif
1645 #ifdef GUI_FUNCTION
1646 # define GUI_MCH_GET_RGB	    GUI_FUNCTION(mch_get_rgb)
1647 # define GUI_MCH_GET_RGB2(pixel)    GUI_FUNCTION2(mch_get_rgb, (pixel))
1648 # define GUI_MCH_GET_COLOR	    GUI_FUNCTION(mch_get_color)
1649 # define GUI_GET_COLOR		    GUI_FUNCTION(get_color)
1650 #endif
1651 
1652 /* Prefer using emsgf(), because perror() may send the output to the wrong
1653  * destination and mess up the screen. */
1654 #ifdef HAVE_STRERROR
1655 # define PERROR(msg)		    (void)semsg("%s: %s", (char *)msg, strerror(errno))
1656 #else
1657 # define PERROR(msg)		    do_perror(msg)
1658 #endif
1659 
1660 typedef long	linenr_T;		/* line number type */
1661 typedef int	colnr_T;		/* column number type */
1662 typedef unsigned short disptick_T;	/* display tick type */
1663 
1664 /*
1665  * Well, you won't believe it, but some S/390 machines ("host", now also known
1666  * as zServer) use 31 bit pointers. There are also some newer machines, that
1667  * use 64 bit pointers. I don't know how to distinguish between 31 and 64 bit
1668  * machines, so the best way is to assume 31 bits whenever we detect OS/390
1669  * Unix.
1670  * With this we restrict the maximum line length to 1073741823. I guess this is
1671  * not a real problem. BTW:  Longer lines are split.
1672  */
1673 #ifdef __MVS__
1674 # define MAXCOL (0x3fffffffL)		// maximum column number, 30 bits
1675 # define MAXLNUM (0x3fffffffL)		// maximum (invalid) line number
1676 #else
1677 # define MAXCOL  INT_MAX		// maximum column number
1678 # define MAXLNUM LONG_MAX		// maximum (invalid) line number
1679 #endif
1680 
1681 #define SHOWCMD_COLS 10			// columns needed by shown command
1682 #define STL_MAX_ITEM 80			// max nr of %<flag> in statusline
1683 
1684 typedef void	    *vim_acl_T;		// dummy to pass an ACL to a function
1685 
1686 #ifndef mch_memmove
1687 # define mch_memmove(to, from, len) memmove((char*)(to), (char*)(from), (size_t)(len))
1688 #endif
1689 
1690 /*
1691  * fnamecmp() is used to compare file names.
1692  * On some systems case in a file name does not matter, on others it does.
1693  * (this does not account for maximum name lengths and things like "../dir",
1694  * thus it is not 100% accurate!)
1695  */
1696 #define fnamecmp(x, y) vim_fnamecmp((char_u *)(x), (char_u *)(y))
1697 #define fnamencmp(x, y, n) vim_fnamencmp((char_u *)(x), (char_u *)(y), (size_t)(n))
1698 
1699 #ifdef HAVE_MEMSET
1700 # define vim_memset(ptr, c, size)   memset((ptr), (c), (size))
1701 #else
1702 void *vim_memset(void *, int, size_t);
1703 #endif
1704 
1705 #if defined(UNIX) || defined(FEAT_GUI) || defined(VMS) \
1706 	|| defined(FEAT_CLIENTSERVER)
1707 # define USE_INPUT_BUF
1708 #endif
1709 
1710 #ifndef EINTR
1711 # define read_eintr(fd, buf, count) vim_read((fd), (buf), (count))
1712 # define write_eintr(fd, buf, count) vim_write((fd), (buf), (count))
1713 #endif
1714 
1715 #ifdef MSWIN
1716 /* On MS-Windows the third argument isn't size_t.  This matters for Win64,
1717  * where sizeof(size_t)==8, not 4 */
1718 # define vim_read(fd, buf, count)   read((fd), (char *)(buf), (unsigned int)(count))
1719 # define vim_write(fd, buf, count)  write((fd), (char *)(buf), (unsigned int)(count))
1720 #else
1721 # define vim_read(fd, buf, count)   read((fd), (char *)(buf), (size_t) (count))
1722 # define vim_write(fd, buf, count)  write((fd), (char *)(buf), (size_t) (count))
1723 #endif
1724 
1725 /*
1726  * Enums need a typecast to be used as array index (for Ultrix).
1727  */
1728 #define HL_ATTR(n)	highlight_attr[(int)(n)]
1729 #define TERM_STR(n)	term_strings[(int)(n)]
1730 
1731 /*
1732  * EXTERN is only defined in main.c.  That's where global variables are
1733  * actually defined and initialized.
1734  */
1735 #ifndef EXTERN
1736 # define EXTERN extern
1737 # define INIT(x)
1738 #else
1739 # ifndef INIT
1740 #  define INIT(x) x
1741 #  define DO_INIT
1742 #  define COMMA ,
1743 # endif
1744 #endif
1745 
1746 #define MAX_MCO	6	/* maximum value for 'maxcombine' */
1747 
1748 /* Maximum number of bytes in a multi-byte character.  It can be one 32-bit
1749  * character of up to 6 bytes, or one 16-bit character of up to three bytes
1750  * plus six following composing characters of three bytes each. */
1751 #define MB_MAXBYTES	21
1752 
1753 #if (defined(FEAT_PROFILE) || defined(FEAT_RELTIME)) && !defined(PROTO)
1754 # ifdef MSWIN
1755 typedef LARGE_INTEGER proftime_T;
1756 # else
1757 typedef struct timeval proftime_T;
1758 # endif
1759 #else
1760 typedef int proftime_T;	    /* dummy for function prototypes */
1761 #endif
1762 
1763 /*
1764  * When compiling with 32 bit Perl time_t is 32 bits in the Perl code but 64
1765  * bits elsewhere.  That causes memory corruption.  Define time_T and use it
1766  * for global variables to avoid that.
1767  */
1768 #ifdef PROTO
1769 typedef long  time_T;
1770 #else
1771 # ifdef MSWIN
1772 typedef __time64_t  time_T;
1773 # else
1774 typedef time_t	    time_T;
1775 # endif
1776 #endif
1777 
1778 #ifdef _WIN64
1779 typedef __int64 sock_T;
1780 #else
1781 typedef int sock_T;
1782 #endif
1783 
1784 /* Include option.h before structs.h, because the number of window-local and
1785  * buffer-local options is used there. */
1786 #include "option.h"	/* options and default values */
1787 
1788 #include "beval.h"	/* BalloonEval */
1789 
1790 /* Note that gui.h is included by structs.h */
1791 
1792 #include "structs.h"	/* defines many structures */
1793 
1794 #include "alloc.h"
1795 
1796 /* Values for "do_profiling". */
1797 #define PROF_NONE	0	/* profiling not started */
1798 #define PROF_YES	1	/* profiling busy */
1799 #define PROF_PAUSED	2	/* profiling paused */
1800 
1801 #ifdef FEAT_MOUSE
1802 
1803 /* Codes for mouse button events in lower three bits: */
1804 # define MOUSE_LEFT	0x00
1805 # define MOUSE_MIDDLE	0x01
1806 # define MOUSE_RIGHT	0x02
1807 # define MOUSE_RELEASE	0x03
1808 
1809 /* bit masks for modifiers: */
1810 # define MOUSE_SHIFT	0x04
1811 # define MOUSE_ALT	0x08
1812 # define MOUSE_CTRL	0x10
1813 
1814 /* mouse buttons that are handled like a key press (GUI only) */
1815 /* Note that the scroll wheel keys are inverted: MOUSE_5 scrolls lines up but
1816  * the result of this is that the window moves down, similarly MOUSE_6 scrolls
1817  * columns left but the window moves right. */
1818 # define MOUSE_4	0x100	/* scroll wheel down */
1819 # define MOUSE_5	0x200	/* scroll wheel up */
1820 
1821 # define MOUSE_X1	0x300 /* Mouse-button X1 (6th) */
1822 # define MOUSE_X2	0x400 /* Mouse-button X2 */
1823 
1824 # define MOUSE_6	0x500	/* scroll wheel left */
1825 # define MOUSE_7	0x600	/* scroll wheel right */
1826 
1827 /* 0x20 is reserved by xterm */
1828 # define MOUSE_DRAG_XTERM   0x40
1829 
1830 # define MOUSE_DRAG	(0x40 | MOUSE_RELEASE)
1831 
1832 /* Lowest button code for using the mouse wheel (xterm only) */
1833 # define MOUSEWHEEL_LOW		0x60
1834 
1835 # define MOUSE_CLICK_MASK	0x03
1836 
1837 # define NUM_MOUSE_CLICKS(code) \
1838     (((unsigned)((code) & 0xC0) >> 6) + 1)
1839 
1840 # define SET_NUM_MOUSE_CLICKS(code, num) \
1841     (code) = ((code) & 0x3f) | ((((num) - 1) & 3) << 6)
1842 
1843 /* Added to mouse column for GUI when 'mousefocus' wants to give focus to a
1844  * window by simulating a click on its status line.  We could use up to 128 *
1845  * 128 = 16384 columns, now it's reduced to 10000. */
1846 # define MOUSE_COLOFF 10000
1847 
1848 /*
1849  * jump_to_mouse() returns one of first four these values, possibly with
1850  * some of the other three added.
1851  */
1852 # define IN_UNKNOWN		0
1853 # define IN_BUFFER		1
1854 # define IN_STATUS_LINE		2	/* on status or command line */
1855 # define IN_SEP_LINE		4	/* on vertical separator line */
1856 # define IN_OTHER_WIN		8	/* in other window but can't go there */
1857 # define CURSOR_MOVED		0x100
1858 # define MOUSE_FOLD_CLOSE	0x200	/* clicked on '-' in fold column */
1859 # define MOUSE_FOLD_OPEN	0x400	/* clicked on '+' in fold column */
1860 # define MOUSE_WINBAR		0x800	/* in window toolbar */
1861 
1862 /* flags for jump_to_mouse() */
1863 # define MOUSE_FOCUS		0x01	/* need to stay in this window */
1864 # define MOUSE_MAY_VIS		0x02	/* may start Visual mode */
1865 # define MOUSE_DID_MOVE		0x04	/* only act when mouse has moved */
1866 # define MOUSE_SETPOS		0x08	/* only set current mouse position */
1867 # define MOUSE_MAY_STOP_VIS	0x10	/* may stop Visual mode */
1868 # define MOUSE_RELEASED		0x20	/* button was released */
1869 
1870 # if defined(UNIX) && defined(HAVE_GETTIMEOFDAY) && defined(HAVE_SYS_TIME_H)
1871 #  define CHECK_DOUBLE_CLICK 1	/* Checking for double clicks ourselves. */
1872 # endif
1873 
1874 #endif /* FEAT_MOUSE */
1875 
1876 /* defines for eval_vars() */
1877 #define VALID_PATH		1
1878 #define VALID_HEAD		2
1879 
1880 /* Defines for Vim variables.  These must match vimvars[] in eval.c! */
1881 #define VV_COUNT	0
1882 #define VV_COUNT1	1
1883 #define VV_PREVCOUNT	2
1884 #define VV_ERRMSG	3
1885 #define VV_WARNINGMSG	4
1886 #define VV_STATUSMSG	5
1887 #define VV_SHELL_ERROR	6
1888 #define VV_THIS_SESSION	7
1889 #define VV_VERSION	8
1890 #define VV_LNUM		9
1891 #define VV_TERMRESPONSE	10
1892 #define VV_FNAME	11
1893 #define VV_LANG		12
1894 #define VV_LC_TIME	13
1895 #define VV_CTYPE	14
1896 #define VV_CC_FROM	15
1897 #define VV_CC_TO	16
1898 #define VV_FNAME_IN	17
1899 #define VV_FNAME_OUT	18
1900 #define VV_FNAME_NEW	19
1901 #define VV_FNAME_DIFF	20
1902 #define VV_CMDARG	21
1903 #define VV_FOLDSTART	22
1904 #define VV_FOLDEND	23
1905 #define VV_FOLDDASHES	24
1906 #define VV_FOLDLEVEL	25
1907 #define VV_PROGNAME	26
1908 #define VV_SEND_SERVER	27
1909 #define VV_DYING	28
1910 #define VV_EXCEPTION	29
1911 #define VV_THROWPOINT	30
1912 #define VV_REG		31
1913 #define VV_CMDBANG	32
1914 #define VV_INSERTMODE	33
1915 #define VV_VAL		34
1916 #define VV_KEY		35
1917 #define VV_PROFILING	36
1918 #define VV_FCS_REASON	37
1919 #define VV_FCS_CHOICE	38
1920 #define VV_BEVAL_BUFNR	39
1921 #define VV_BEVAL_WINNR	40
1922 #define VV_BEVAL_WINID	41
1923 #define VV_BEVAL_LNUM	42
1924 #define VV_BEVAL_COL	43
1925 #define VV_BEVAL_TEXT	44
1926 #define VV_SCROLLSTART	45
1927 #define VV_SWAPNAME	46
1928 #define VV_SWAPCHOICE	47
1929 #define VV_SWAPCOMMAND	48
1930 #define VV_CHAR		49
1931 #define VV_MOUSE_WIN	50
1932 #define VV_MOUSE_WINID	51
1933 #define VV_MOUSE_LNUM   52
1934 #define VV_MOUSE_COL	53
1935 #define VV_OP		54
1936 #define VV_SEARCHFORWARD 55
1937 #define VV_HLSEARCH	56
1938 #define VV_OLDFILES	57
1939 #define VV_WINDOWID	58
1940 #define VV_PROGPATH	59
1941 #define VV_COMPLETED_ITEM 60
1942 #define VV_OPTION_NEW   61
1943 #define VV_OPTION_OLD   62
1944 #define VV_OPTION_OLDLOCAL 63
1945 #define VV_OPTION_OLDGLOBAL 64
1946 #define VV_OPTION_COMMAND 65
1947 #define VV_OPTION_TYPE  66
1948 #define VV_ERRORS	67
1949 #define VV_FALSE	68
1950 #define VV_TRUE		69
1951 #define VV_NULL		70
1952 #define VV_NONE		71
1953 #define VV_VIM_DID_ENTER 72
1954 #define VV_TESTING	73
1955 #define VV_TYPE_NUMBER	74
1956 #define VV_TYPE_STRING	75
1957 #define VV_TYPE_FUNC	76
1958 #define VV_TYPE_LIST	77
1959 #define VV_TYPE_DICT	78
1960 #define VV_TYPE_FLOAT	79
1961 #define VV_TYPE_BOOL	80
1962 #define VV_TYPE_NONE	81
1963 #define VV_TYPE_JOB	82
1964 #define VV_TYPE_CHANNEL	83
1965 #define VV_TYPE_BLOB	84
1966 #define VV_TERMRFGRESP	85
1967 #define VV_TERMRBGRESP	86
1968 #define VV_TERMU7RESP	87
1969 #define VV_TERMSTYLERESP 88
1970 #define VV_TERMBLINKRESP 89
1971 #define VV_EVENT	90
1972 #define VV_VERSIONLONG	91
1973 #define VV_LEN		92	// number of v: vars
1974 
1975 // used for v_number in VAR_SPECIAL
1976 #define VVAL_FALSE	0L
1977 #define VVAL_TRUE	1L
1978 #define VVAL_NONE	2L
1979 #define VVAL_NULL	3L
1980 
1981 // Type values for type().
1982 #define VAR_TYPE_NUMBER	    0
1983 #define VAR_TYPE_STRING	    1
1984 #define VAR_TYPE_FUNC	    2
1985 #define VAR_TYPE_LIST	    3
1986 #define VAR_TYPE_DICT	    4
1987 #define VAR_TYPE_FLOAT	    5
1988 #define VAR_TYPE_BOOL	    6
1989 #define VAR_TYPE_NONE	    7
1990 #define VAR_TYPE_JOB	    8
1991 #define VAR_TYPE_CHANNEL    9
1992 #define VAR_TYPE_BLOB	    10
1993 
1994 #ifdef FEAT_CLIPBOARD
1995 
1996 /* VIM_ATOM_NAME is the older Vim-specific selection type for X11.  Still
1997  * supported for when a mix of Vim versions is used. VIMENC_ATOM_NAME includes
1998  * the encoding to support Vims using different 'encoding' values. */
1999 # define VIM_ATOM_NAME "_VIM_TEXT"
2000 # define VIMENC_ATOM_NAME "_VIMENC_TEXT"
2001 
2002 /* Selection states for modeless selection */
2003 # define SELECT_CLEARED		0
2004 # define SELECT_IN_PROGRESS	1
2005 # define SELECT_DONE		2
2006 
2007 # define SELECT_MODE_CHAR	0
2008 # define SELECT_MODE_WORD	1
2009 # define SELECT_MODE_LINE	2
2010 
2011 # ifdef FEAT_GUI_MSWIN
2012 #  ifdef FEAT_OLE
2013 #   define WM_OLE (WM_APP+0)
2014 #  endif
2015 # endif
2016 
2017 /* Info about selected text */
2018 typedef struct
2019 {
2020     int		available;	// Is clipboard available?
2021     int		owned;		// Flag: do we own the selection?
2022     pos_T	start;		// Start of selected area
2023     pos_T	end;		// End of selected area
2024     int		vmode;		// Visual mode character
2025 
2026     // Fields for selection that doesn't use Visual mode
2027     short_u	origin_row;
2028     short_u	origin_start_col;
2029     short_u	origin_end_col;
2030     short_u	word_start_col;
2031     short_u	word_end_col;
2032 #ifdef FEAT_TEXT_PROP
2033     // limits for selection inside a popup window
2034     short_u	min_col;
2035     short_u	max_col;
2036     short_u	min_row;
2037     short_u	max_row;
2038 #endif
2039 
2040     pos_T	prev;		// Previous position
2041     short_u	state;		// Current selection state
2042     short_u	mode;		// Select by char, word, or line.
2043 
2044 # if defined(FEAT_GUI_X11) || defined(FEAT_XCLIPBOARD)
2045     Atom	sel_atom;	// PRIMARY/CLIPBOARD selection ID
2046 # endif
2047 
2048 # ifdef FEAT_GUI_GTK
2049     GdkAtom     gtk_sel_atom;	// PRIMARY/CLIPBOARD selection ID
2050 # endif
2051 
2052 # if defined(MSWIN) || defined(FEAT_CYGWIN_WIN32_CLIPBOARD)
2053     int_u	format;		// Vim's own special clipboard format
2054     int_u	format_raw;	// Vim's raw text clipboard format
2055 # endif
2056 } Clipboard_T;
2057 #else
2058 typedef int Clipboard_T;	// This is required for the prototypes.
2059 #endif
2060 
2061 /* Use 64-bit stat structure if available. */
2062 #if (defined(_MSC_VER) && (_MSC_VER >= 1300)) || defined(__MINGW32__)
2063 # define HAVE_STAT64
2064 typedef struct _stat64 stat_T;
2065 #else
2066 typedef struct stat stat_T;
2067 #endif
2068 
2069 #if defined(__GNUC__) && !defined(__MINGW32__)
2070 # define USE_PRINTF_FORMAT_ATTRIBUTE
2071 #endif
2072 
2073 typedef enum
2074 {
2075     ASSERT_EQUAL,
2076     ASSERT_NOTEQUAL,
2077     ASSERT_MATCH,
2078     ASSERT_NOTMATCH,
2079     ASSERT_OTHER
2080 } assert_type_T;
2081 
2082 /* Mode for bracketed_paste(). */
2083 typedef enum {
2084     PASTE_INSERT,	/* insert mode */
2085     PASTE_CMDLINE,	/* command line */
2086     PASTE_EX,		/* ex mode line */
2087     PASTE_ONE_CHAR	/* return first character */
2088 } paste_mode_T;
2089 
2090 // Argument for flush_buffers().
2091 typedef enum {
2092     FLUSH_MINIMAL,
2093     FLUSH_TYPEAHEAD,	// flush current typebuf contents
2094     FLUSH_INPUT		// flush typebuf and inchar() input
2095 } flush_buffers_T;
2096 
2097 #include "ex_cmds.h"	    /* Ex command defines */
2098 #include "spell.h"	    /* spell checking stuff */
2099 
2100 #include "proto.h"	    /* function prototypes */
2101 
2102 /* This has to go after the include of proto.h, as proto/gui.pro declares
2103  * functions of these names. The declarations would break if the defines had
2104  * been seen at that stage.  But it must be before globals.h, where error_ga
2105  * is declared. */
2106 #if !defined(MSWIN) && !defined(FEAT_GUI_X11) \
2107 	&& !defined(FEAT_GUI_GTK) && !defined(FEAT_GUI_MAC) && !defined(PROTO)
2108 # define mch_errmsg(str)	fprintf(stderr, "%s", (str))
2109 # define display_errors()	fflush(stderr)
2110 # define mch_msg(str)		printf("%s", (str))
2111 #else
2112 # define USE_MCH_ERRMSG
2113 #endif
2114 
2115 # if defined(FEAT_EVAL) \
2116 	&& (!defined(FEAT_GUI_MSWIN) \
2117 	     || !(defined(FEAT_MBYTE_IME) || defined(GLOBAL_IME))) \
2118 	&& !(defined(FEAT_GUI_MAC) && defined(MACOS_CONVERT))
2119 /* Whether IME is supported by im_get_status() defined in mbyte.c.
2120  * For Win32 GUI it's in gui_w32.c when FEAT_MBYTE_IME or GLOBAL_IME is defined.
2121  * for Mac it is in gui_mac.c for the GUI or in os_mac_conv.c when
2122  * MACOS_CONVERT is defined. */
2123 # define IME_WITHOUT_XIM
2124 #endif
2125 
2126 #if defined(FEAT_XIM) \
2127 	|| defined(IME_WITHOUT_XIM) \
2128 	|| (defined(FEAT_GUI_MSWIN) \
2129 	    && (defined(FEAT_MBYTE_IME) || defined(GLOBAL_IME))) \
2130 	|| defined(FEAT_GUI_MAC)
2131 /* im_set_active() is available */
2132 # define HAVE_INPUT_METHOD
2133 #endif
2134 
2135 #ifndef FEAT_LINEBREAK
2136 /* Without the 'numberwidth' option line numbers are always 7 chars. */
2137 # define number_width(x) 7
2138 #endif
2139 
2140 /* This must come after including proto.h.
2141  * For VMS this is defined in macros.h. */
2142 #if !defined(MSWIN) && !defined(VMS)
2143 # define mch_open(n, m, p)	open((n), (m), (p))
2144 # define mch_fopen(n, p)	fopen((n), (p))
2145 #endif
2146 
2147 #include "globals.h"	    /* global variables and messages */
2148 
2149 /*
2150  * If console dialog not supported, but GUI dialog is, use the GUI one.
2151  */
2152 #if defined(FEAT_GUI_DIALOG) && !defined(FEAT_CON_DIALOG)
2153 # define do_dialog gui_mch_dialog
2154 #endif
2155 
2156 /*
2157  * Default filters for gui_mch_browse().
2158  * The filters are almost system independent.  Except for the difference
2159  * between "*" and "*.*" for MSDOS-like systems.
2160  * NOTE: Motif only uses the very first pattern.  Therefore
2161  * BROWSE_FILTER_DEFAULT should start with a "*" pattern.
2162  */
2163 #ifdef FEAT_BROWSE
2164 # ifdef BACKSLASH_IN_FILENAME
2165 #  define BROWSE_FILTER_MACROS \
2166 	(char_u *)N_("Vim macro files (*.vim)\t*.vim\nAll Files (*.*)\t*.*\n")
2167 #  define BROWSE_FILTER_ALL_FILES (char_u *)N_("All Files (*.*)\t*.*\n")
2168 #  define BROWSE_FILTER_DEFAULT \
2169 	(char_u *)N_("All Files (*.*)\t*.*\nC source (*.c, *.h)\t*.c;*.h\nC++ source (*.cpp, *.hpp)\t*.cpp;*.hpp\nVB code (*.bas, *.frm)\t*.bas;*.frm\nVim files (*.vim, _vimrc, _gvimrc)\t*.vim;_vimrc;_gvimrc\n")
2170 # else
2171 #  define BROWSE_FILTER_MACROS \
2172 	(char_u *)N_("Vim macro files (*.vim)\t*.vim\nAll Files (*)\t*\n")
2173 #  define BROWSE_FILTER_ALL_FILES (char_u *)N_("All Files (*)\t*\n")
2174 #  define BROWSE_FILTER_DEFAULT \
2175 	(char_u *)N_("All Files (*)\t*\nC source (*.c, *.h)\t*.c;*.h\nC++ source (*.cpp, *.hpp)\t*.cpp;*.hpp\nVim files (*.vim, _vimrc, _gvimrc)\t*.vim;_vimrc;_gvimrc\n")
2176 # endif
2177 # define BROWSE_SAVE 1	    /* flag for do_browse() */
2178 # define BROWSE_DIR 2	    /* flag for do_browse() */
2179 #endif
2180 
2181 #ifdef _MSC_VER
2182 /* Avoid useless warning "conversion from X to Y of greater size". */
2183  #pragma warning(disable : 4312)
2184 /* Avoid warning for old style function declarators */
2185  #pragma warning(disable : 4131)
2186 /* Avoid warning for conversion to type with smaller range */
2187  #pragma warning(disable : 4244)
2188 /* Avoid warning for conversion to larger size */
2189  #pragma warning(disable : 4306)
2190 /* Avoid warning for unreferenced formal parameter */
2191  #pragma warning(disable : 4100)
2192 /* Avoid warning for differs in indirection to slightly different base type */
2193  #pragma warning(disable : 4057)
2194 /* Avoid warning for constant conditional expression */
2195  #pragma warning(disable : 4127)
2196 /* Avoid warning for assignment within conditional */
2197  #pragma warning(disable : 4706)
2198 #endif
2199 
2200 /* Note: a NULL argument for vim_realloc() is not portable, don't use it. */
2201 #if defined(MEM_PROFILE)
2202 # define vim_realloc(ptr, size)  mem_realloc((ptr), (size))
2203 #else
2204 # define vim_realloc(ptr, size)  realloc((ptr), (size))
2205 #endif
2206 
2207 /*
2208  * Return byte length of character that starts with byte "b".
2209  * Returns 1 for a single-byte character.
2210  * MB_BYTE2LEN_CHECK() can be used to count a special key as one byte.
2211  * Don't call MB_BYTE2LEN(b) with b < 0 or b > 255!
2212  */
2213 #define MB_BYTE2LEN(b)		mb_bytelen_tab[b]
2214 #define MB_BYTE2LEN_CHECK(b)	(((b) < 0 || (b) > 255) ? 1 : mb_bytelen_tab[b])
2215 
2216 /* properties used in enc_canon_table[] (first three mutually exclusive) */
2217 #define ENC_8BIT	0x01
2218 #define ENC_DBCS	0x02
2219 #define ENC_UNICODE	0x04
2220 
2221 #define ENC_ENDIAN_B	0x10	    /* Unicode: Big endian */
2222 #define ENC_ENDIAN_L	0x20	    /* Unicode: Little endian */
2223 
2224 #define ENC_2BYTE	0x40	    /* Unicode: UCS-2 */
2225 #define ENC_4BYTE	0x80	    /* Unicode: UCS-4 */
2226 #define ENC_2WORD	0x100	    /* Unicode: UTF-16 */
2227 
2228 #define ENC_LATIN1	0x200	    /* Latin1 */
2229 #define ENC_LATIN9	0x400	    /* Latin9 */
2230 #define ENC_MACROMAN	0x800	    /* Mac Roman (not Macro Man! :-) */
2231 
2232 #ifdef USE_ICONV
2233 # ifndef EILSEQ
2234 #  define EILSEQ 123
2235 # endif
2236 # ifdef DYNAMIC_ICONV
2237 /* On Win32 iconv.dll is dynamically loaded. */
2238 #  define ICONV_ERRNO (*iconv_errno())
2239 #  define ICONV_E2BIG  7
2240 #  define ICONV_EINVAL 22
2241 #  define ICONV_EILSEQ 42
2242 # else
2243 #  define ICONV_ERRNO errno
2244 #  define ICONV_E2BIG  E2BIG
2245 #  define ICONV_EINVAL EINVAL
2246 #  define ICONV_EILSEQ EILSEQ
2247 # endif
2248 #endif
2249 
2250 #define SIGN_BYTE 1	    /* byte value used where sign is displayed;
2251 			       attribute value is sign type */
2252 
2253 #ifdef FEAT_NETBEANS_INTG
2254 # define MULTISIGN_BYTE 2   /* byte value used where sign is displayed if
2255 			       multiple signs exist on the line */
2256 #endif
2257 
2258 #if defined(FEAT_GUI) && defined(FEAT_XCLIPBOARD)
2259 # ifdef FEAT_GUI_GTK
2260    /* Avoid using a global variable for the X display.  It's ugly
2261     * and is likely to cause trouble in multihead environments. */
2262 #  define X_DISPLAY	((gui.in_use) ? gui_mch_get_display() : xterm_dpy)
2263 # else
2264 #  define X_DISPLAY	(gui.in_use ? gui.dpy : xterm_dpy)
2265 # endif
2266 #else
2267 # ifdef FEAT_GUI
2268 #  ifdef FEAT_GUI_GTK
2269 #   define X_DISPLAY	((gui.in_use) ? gui_mch_get_display() : (Display *)NULL)
2270 #  else
2271 #   define X_DISPLAY	gui.dpy
2272 #  endif
2273 # else
2274 #  define X_DISPLAY	xterm_dpy
2275 # endif
2276 #endif
2277 
2278 #if defined(FEAT_BROWSE) && defined(GTK_CHECK_VERSION)
2279 # if GTK_CHECK_VERSION(2,4,0)
2280 #  define USE_FILE_CHOOSER
2281 # endif
2282 #endif
2283 
2284 #ifdef FEAT_GUI_GTK
2285 # if !GTK_CHECK_VERSION(2,14,0)
2286 #  define gtk_widget_get_window(wid)	((wid)->window)
2287 #  define gtk_plug_get_socket_window(wid)	((wid)->socket_window)
2288 #  define gtk_selection_data_get_data(sel)	((sel)->data)
2289 #  define gtk_selection_data_get_data_type(sel)	((sel)->type)
2290 #  define gtk_selection_data_get_format(sel)	((sel)->format)
2291 #  define gtk_selection_data_get_length(sel)	((sel)->length)
2292 #  define gtk_adjustment_set_lower(adj, low) \
2293     do { (adj)->lower = low; } while (0)
2294 #  define gtk_adjustment_set_upper(adj, up) \
2295     do { (adj)->upper = up; } while (0)
2296 #  define gtk_adjustment_set_page_size(adj, size) \
2297     do { (adj)->page_size = size; } while (0)
2298 #  define gtk_adjustment_set_page_increment(adj, inc) \
2299     do { (adj)->page_increment = inc; } while (0)
2300 #  define gtk_adjustment_set_step_increment(adj, inc) \
2301     do { (adj)->step_increment = inc; } while (0)
2302 # endif
2303 # if !GTK_CHECK_VERSION(2,16,0)
2304 #  define gtk_selection_data_get_selection(sel)	((sel)->selection)
2305 # endif
2306 # if !GTK_CHECK_VERSION(2,18,0)
2307 #  define gtk_widget_get_allocation(wid, alloc) \
2308     do { *(alloc) = (wid)->allocation; } while (0)
2309 #  define gtk_widget_set_allocation(wid, alloc) \
2310     do { (wid)->allocation = *(alloc); } while (0)
2311 #  define gtk_widget_get_has_window(wid)	!GTK_WIDGET_NO_WINDOW(wid)
2312 #  define gtk_widget_get_sensitive(wid)	GTK_WIDGET_SENSITIVE(wid)
2313 #  define gtk_widget_get_visible(wid)	GTK_WIDGET_VISIBLE(wid)
2314 #  define gtk_widget_has_focus(wid)	GTK_WIDGET_HAS_FOCUS(wid)
2315 #  define gtk_widget_set_window(wid, win) \
2316     do { (wid)->window = (win); } while (0)
2317 #  define gtk_widget_set_can_default(wid, can) \
2318     do { if (can) { GTK_WIDGET_SET_FLAGS(wid, GTK_CAN_DEFAULT); } \
2319 	else { GTK_WIDGET_UNSET_FLAGS(wid, GTK_CAN_DEFAULT); } } while (0)
2320 #  define gtk_widget_set_can_focus(wid, can) \
2321     do { if (can) { GTK_WIDGET_SET_FLAGS(wid, GTK_CAN_FOCUS); } \
2322 	else { GTK_WIDGET_UNSET_FLAGS(wid, GTK_CAN_FOCUS); } } while (0)
2323 #  define gtk_widget_set_visible(wid, vis) \
2324     do { if (vis) { gtk_widget_show(wid); } \
2325 	else { gtk_widget_hide(wid); } } while (0)
2326 # endif
2327 # if !GTK_CHECK_VERSION(2,20,0)
2328 #  define gtk_widget_get_mapped(wid)	GTK_WIDGET_MAPPED(wid)
2329 #  define gtk_widget_get_realized(wid)	GTK_WIDGET_REALIZED(wid)
2330 #  define gtk_widget_set_mapped(wid, map) \
2331     do { if (map) { GTK_WIDGET_SET_FLAGS(wid, GTK_MAPPED); } \
2332 	else { GTK_WIDGET_UNSET_FLAGS(wid, GTK_MAPPED); } } while (0)
2333 #  define gtk_widget_set_realized(wid, rea) \
2334     do { if (rea) { GTK_WIDGET_SET_FLAGS(wid, GTK_REALIZED); } \
2335 	else { GTK_WIDGET_UNSET_FLAGS(wid, GTK_REALIZED); } } while (0)
2336 # endif
2337 #endif
2338 
2339 #ifndef FEAT_NETBEANS_INTG
2340 # undef NBDEBUG
2341 #endif
2342 #ifdef NBDEBUG /* Netbeans debugging. */
2343 # include "nbdebug.h"
2344 #else
2345 # define nbdebug(a)
2346 #endif
2347 
2348 #ifdef IN_PERL_FILE
2349   /*
2350    * Avoid clashes between Perl and Vim namespace.
2351    */
2352 # undef NORMAL
2353 # undef STRLEN
2354 # undef FF
2355 # undef OP_DELETE
2356 # undef OP_JOIN
2357   /* remove MAX and MIN, included by glib.h, redefined by sys/param.h */
2358 # ifdef MAX
2359 #  undef MAX
2360 # endif
2361 # ifdef MIN
2362 #  undef MIN
2363 # endif
2364   /* We use _() for gettext(), Perl uses it for function prototypes... */
2365 # ifdef _
2366 #  undef _
2367 # endif
2368 # ifdef DEBUG
2369 #  undef DEBUG
2370 # endif
2371 # ifdef _DEBUG
2372 #  undef _DEBUG
2373 # endif
2374 # ifdef instr
2375 #  undef instr
2376 # endif
2377   /* bool may cause trouble on some old versions of Mac OS X but is required
2378    * on a few other systems and for Perl */
2379 # if (defined(MACOS_X) && !defined(MAC_OS_X_VERSION_10_6)) \
2380 				       && defined(bool) && !defined(FEAT_PERL)
2381 #  undef bool
2382 # endif
2383 
2384 #endif
2385 
2386 /* values for vim_handle_signal() that are not a signal */
2387 #define SIGNAL_BLOCK	-1
2388 #define SIGNAL_UNBLOCK  -2
2389 #if !defined(UNIX) && !defined(VMS)
2390 # define vim_handle_signal(x) 0
2391 #endif
2392 
2393 /* flags for skip_vimgrep_pat() */
2394 #define VGR_GLOBAL	1
2395 #define VGR_NOJUMP	2
2396 
2397 /* behavior for bad character, "++bad=" argument */
2398 #define BAD_REPLACE	'?'	/* replace it with '?' (default) */
2399 #define BAD_KEEP	-1	/* leave it */
2400 #define BAD_DROP	-2	/* erase it */
2401 
2402 /* last argument for do_source() */
2403 #define DOSO_NONE	0
2404 #define DOSO_VIMRC	1	/* loading vimrc file */
2405 #define DOSO_GVIMRC	2	/* loading gvimrc file */
2406 
2407 /* flags for read_viminfo() and children */
2408 #define VIF_WANT_INFO		1	/* load non-mark info */
2409 #define VIF_WANT_MARKS		2	/* load file marks */
2410 #define VIF_FORCEIT		4	/* overwrite info already read */
2411 #define VIF_GET_OLDFILES	8	/* load v:oldfiles */
2412 
2413 /* flags for buf_freeall() */
2414 #define BFA_DEL		1	/* buffer is going to be deleted */
2415 #define BFA_WIPE	2	/* buffer is going to be wiped out */
2416 #define BFA_KEEP_UNDO	4	/* do not free undo information */
2417 
2418 /* direction for nv_mousescroll() and ins_mousescroll() */
2419 #define MSCR_DOWN	0	/* DOWN must be FALSE */
2420 #define MSCR_UP		1
2421 #define MSCR_LEFT	-1
2422 #define MSCR_RIGHT	-2
2423 
2424 #define KEYLEN_PART_KEY -1	/* keylen value for incomplete key-code */
2425 #define KEYLEN_PART_MAP -2	/* keylen value for incomplete mapping */
2426 #define KEYLEN_REMOVED  9999	/* keylen value for removed sequence */
2427 
2428 /* Return values from win32_fileinfo(). */
2429 #define FILEINFO_OK	     0
2430 #define FILEINFO_ENC_FAIL    1	/* enc_to_utf16() failed */
2431 #define FILEINFO_READ_FAIL   2	/* CreateFile() failed */
2432 #define FILEINFO_INFO_FAIL   3	/* GetFileInformationByHandle() failed */
2433 
2434 /* Return value from get_option_value_strict */
2435 #define SOPT_BOOL	0x01	/* Boolean option */
2436 #define SOPT_NUM	0x02	/* Number option */
2437 #define SOPT_STRING	0x04	/* String option */
2438 #define SOPT_GLOBAL	0x08	/* Option has global value */
2439 #define SOPT_WIN	0x10	/* Option has window-local value */
2440 #define SOPT_BUF	0x20	/* Option has buffer-local value */
2441 #define SOPT_UNSET	0x40	/* Option does not have local value set */
2442 
2443 /* Option types for various functions in option.c */
2444 #define SREQ_GLOBAL	0	/* Request global option */
2445 #define SREQ_WIN	1	/* Request window-local option */
2446 #define SREQ_BUF	2	/* Request buffer-local option */
2447 
2448 /* Flags for get_reg_contents */
2449 #define GREG_NO_EXPR	1	/* Do not allow expression register */
2450 #define GREG_EXPR_SRC	2	/* Return expression itself for "=" register */
2451 #define GREG_LIST	4	/* Return list */
2452 
2453 /* Character used as separated in autoload function/variable names. */
2454 #define AUTOLOAD_CHAR '#'
2455 
2456 #ifdef FEAT_JOB_CHANNEL
2457 # define MAX_OPEN_CHANNELS 10
2458 #else
2459 # define MAX_OPEN_CHANNELS 0
2460 #endif
2461 
2462 #if defined(MSWIN)
2463 # define MAX_NAMED_PIPE_SIZE 65535
2464 #endif
2465 
2466 /* Options for json_encode() and json_decode. */
2467 #define JSON_JS		1   /* use JS instead of JSON */
2468 #define JSON_NO_NONE	2   /* v:none item not allowed */
2469 #define JSON_NL		4   /* append a NL */
2470 
2471 /* Used for flags of do_in_path() */
2472 #define DIP_ALL	    0x01	/* all matches, not just the first one */
2473 #define DIP_DIR	    0x02	/* find directories instead of files. */
2474 #define DIP_ERR	    0x04	/* give an error message when none found. */
2475 #define DIP_START   0x08	/* also use "start" directory in 'packpath' */
2476 #define DIP_OPT	    0x10	/* also use "opt" directory in 'packpath' */
2477 #define DIP_NORTP   0x20	/* do not use 'runtimepath' */
2478 #define DIP_NOAFTER 0x40	/* skip "after" directories */
2479 #define DIP_AFTER   0x80	/* only use "after" directories */
2480 
2481 /* Lowest number used for window ID. Cannot have this many windows. */
2482 #define LOWEST_WIN_ID 1000
2483 
2484 /* Used by the garbage collector. */
2485 #define COPYID_INC 2
2486 #define COPYID_MASK (~0x1)
2487 
2488 /* Values for trans_function_name() argument: */
2489 #define TFN_INT		1	/* internal function name OK */
2490 #define TFN_QUIET	2	/* no error messages */
2491 #define TFN_NO_AUTOLOAD	4	/* do not use script autoloading */
2492 #define TFN_NO_DEREF	8	/* do not dereference a Funcref */
2493 #define TFN_READ_ONLY	16	/* will not change the var */
2494 
2495 /* Values for get_lval() flags argument: */
2496 #define GLV_QUIET	TFN_QUIET	/* no error messages */
2497 #define GLV_NO_AUTOLOAD	TFN_NO_AUTOLOAD	/* do not use script autoloading */
2498 #define GLV_READ_ONLY	TFN_READ_ONLY	/* will not change the var */
2499 
2500 #define DO_NOT_FREE_CNT 99999	/* refcount for dict or list that should not
2501 				   be freed. */
2502 
2503 /* errors for when calling a function */
2504 #define ERROR_UNKNOWN	0
2505 #define ERROR_TOOMANY	1
2506 #define ERROR_TOOFEW	2
2507 #define ERROR_SCRIPT	3
2508 #define ERROR_DICT	4
2509 #define ERROR_NONE	5
2510 #define ERROR_OTHER	6
2511 #define ERROR_DELETED	7
2512 
2513 /* flags for find_name_end() */
2514 #define FNE_INCL_BR	1	/* include [] in name */
2515 #define FNE_CHECK_START	2	/* check name starts with valid character */
2516 
2517 /* BSD is supposed to cover FreeBSD and similar systems. */
2518 #if (defined(SUN_SYSTEM) || defined(BSD) || defined(__FreeBSD_kernel__)) \
2519 	&& (defined(S_ISCHR) || defined(S_IFCHR))
2520 # define OPEN_CHR_FILES
2521 #endif
2522 
2523 /* stat macros */
2524 #ifndef S_ISDIR
2525 # ifdef S_IFDIR
2526 #  define S_ISDIR(m)	(((m) & S_IFMT) == S_IFDIR)
2527 # else
2528 #  define S_ISDIR(m)	0
2529 # endif
2530 #endif
2531 #ifndef S_ISREG
2532 # ifdef S_IFREG
2533 #  define S_ISREG(m)	(((m) & S_IFMT) == S_IFREG)
2534 # else
2535 #  define S_ISREG(m)	0
2536 # endif
2537 #endif
2538 #ifndef S_ISBLK
2539 # ifdef S_IFBLK
2540 #  define S_ISBLK(m)	(((m) & S_IFMT) == S_IFBLK)
2541 # else
2542 #  define S_ISBLK(m)	0
2543 # endif
2544 #endif
2545 #ifndef S_ISSOCK
2546 # ifdef S_IFSOCK
2547 #  define S_ISSOCK(m)	(((m) & S_IFMT) == S_IFSOCK)
2548 # else
2549 #  define S_ISSOCK(m)	0
2550 # endif
2551 #endif
2552 #ifndef S_ISFIFO
2553 # ifdef S_IFIFO
2554 #  define S_ISFIFO(m)	(((m) & S_IFMT) == S_IFIFO)
2555 # else
2556 #  define S_ISFIFO(m)	0
2557 # endif
2558 #endif
2559 #ifndef S_ISCHR
2560 # ifdef S_IFCHR
2561 #  define S_ISCHR(m)	(((m) & S_IFMT) == S_IFCHR)
2562 # else
2563 #  define S_ISCHR(m)	0
2564 # endif
2565 #endif
2566 #ifndef S_ISLNK
2567 # ifdef S_IFLNK
2568 #  define S_ISLNK(m)	(((m) & S_IFMT) == S_IFLNK)
2569 # else
2570 #  define S_ISLNK(m)	0
2571 # endif
2572 #endif
2573 
2574 #if defined(HAVE_GETTIMEOFDAY) && defined(HAVE_SYS_TIME_H)
2575 # define ELAPSED_TIMEVAL
2576 # define ELAPSED_INIT(v) gettimeofday(&v, NULL)
2577 # define ELAPSED_FUNC(v) elapsed(&v)
2578 typedef struct timeval elapsed_T;
2579 long elapsed(struct timeval *start_tv);
2580 #elif defined(MSWIN)
2581 # define ELAPSED_TICKCOUNT
2582 # define ELAPSED_INIT(v) v = GetTickCount()
2583 # define ELAPSED_FUNC(v) elapsed(v)
2584 # ifdef PROTO
2585 typedef int DWORD;
2586 # endif
2587 typedef DWORD elapsed_T;
2588 # ifndef PROTO
2589 long elapsed(DWORD start_tick);
2590 # endif
2591 #endif
2592 
2593 /* Replacement for nchar used by nv_replace(). */
2594 #define REPLACE_CR_NCHAR    -1
2595 #define REPLACE_NL_NCHAR    -2
2596 
2597 /* flags for term_start() */
2598 #define TERM_START_NOJOB	1
2599 #define TERM_START_FORCEIT	2
2600 #define TERM_START_SYSTEM	4
2601 
2602 // Used for icon/title save and restore.
2603 #define SAVE_RESTORE_TITLE	1
2604 #define SAVE_RESTORE_ICON	2
2605 #define SAVE_RESTORE_BOTH	(SAVE_RESTORE_TITLE | SAVE_RESTORE_ICON)
2606 
2607 // Flags for adjust_prop_columns()
2608 #define APC_SAVE_FOR_UNDO	1   // call u_savesub() before making changes
2609 #define APC_SUBSTITUTE		2   // text is replaced, not inserted
2610 
2611 #define CLIP_ZINDEX 32000
2612 
2613 #endif /* VIM__H */
2614