blob: eb312172b36c1abcecc2fc9dd6394b24bbef7f50 [file] [log] [blame]
Bram Moolenaaredf3f972016-08-29 22:49:24 +02001/* vi:set ts=8 sts=4 sw=4 noet:
Bram Moolenaar071d4272004-06-13 20:20:40 +00002 *
3 * VIM - Vi IMproved by Bram Moolenaar
4 *
5 * Do ":help uganda" in Vim to read copying and usage conditions.
6 * Do ":help credits" in Vim to see a list of people who contributed.
7 */
8
9#ifndef VIM__H
10# define VIM__H
11
Bram Moolenaar32d19c12018-09-13 17:26:54 +020012#include "protodef.h"
Bram Moolenaar0f1e6432017-11-18 20:22:24 +010013
Bram Moolenaar4f974752019-02-17 17:44:42 +010014// _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
Bram Moolenaar4f974752019-02-17 17:44:42 +010018#endif
19
zeertzjq44068e92022-06-16 11:14:55 +010020#if defined(MSWIN) && !defined(PROTO)
Bram Moolenaar2f189752020-02-12 21:15:43 +010021# include <io.h>
Bram Moolenaar9c263032010-12-17 18:06:06 +010022#endif
23
Bram Moolenaarc3308352019-09-01 16:24:56 +020024// ============ the header file puzzle: order matters =========
Bram Moolenaar071d4272004-06-13 20:20:40 +000025
Bram Moolenaarc3308352019-09-01 16:24:56 +020026#ifdef HAVE_CONFIG_H // GNU autoconf (or something else) was here
Bram Moolenaar071d4272004-06-13 20:20:40 +000027# include "auto/config.h"
28# define HAVE_PATHDEF
29
30/*
Bram Moolenaarc1762cc2007-05-10 16:56:30 +000031 * Check if configure correctly managed to find sizeof(int). If this failed,
Bram Moolenaar071d4272004-06-13 20:20:40 +000032 * 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 */
Bram Moolenaara2aa31a2014-02-23 22:52:40 +010035# if (VIM_SIZEOF_INT == 0)
Bram Moolenaar2c02d382020-01-23 16:52:01 +010036# error configure did not run properly. Check auto/config.log.
Bram Moolenaar071d4272004-06-13 20:20:40 +000037# endif
38
James McCoy4a953772024-03-25 16:22:23 +010039# if (defined(__linux__) && !defined(__ANDROID__)) || defined(__CYGWIN__) || defined(__GNU__)
Bram Moolenaar6a228c62019-11-26 13:29:01 +010040// Needed for strptime(). Needs to be done early, since header files can
41// include other header files and end up including time.h, where these symbols
42// matter for Vim.
43// 700 is needed for mkdtemp().
44# ifndef _XOPEN_SOURCE
45# define _XOPEN_SOURCE 700
Gary Johnson44db6032021-10-28 20:49:06 +010046
47// On old systems, defining _XOPEN_SOURCE causes _BSD_SOURCE, _SVID_SOURCE
48// and/or // _DEFAULT_SOURCE not to be defined, so do that here. Those are
49// needed to include nanosecond-resolution timestamps in struct stat. On new
50// systems, _DEFAULT_SOURCE is needed to avoid warning messages about using
51// deprecated _BSD_SOURCE or _SVID_SOURCE.
52# ifndef _BSD_SOURCE
53# define _BSD_SOURCE 1
54# endif
55# ifndef _SVID_SOURCE
56# define _SVID_SOURCE 1
57# endif
58# ifndef _DEFAULT_SOURCE
59# define _DEFAULT_SOURCE 1
60# endif
Bram Moolenaar6a228c62019-11-26 13:29:01 +010061# endif
Bram Moolenaar6a228c62019-11-26 13:29:01 +010062# endif
63
Bram Moolenaar071d4272004-06-13 20:20:40 +000064/*
Bram Moolenaarc1762cc2007-05-10 16:56:30 +000065 * Cygwin may have fchdir() in a newer release, but in most versions it
Bram Moolenaar071d4272004-06-13 20:20:40 +000066 * doesn't work well and avoiding it keeps the binary backward compatible.
67 */
68# if defined(__CYGWIN32__) && defined(HAVE_FCHDIR)
69# undef HAVE_FCHDIR
70# endif
Bram Moolenaarfa7584c2010-05-19 21:57:45 +020071
Bram Moolenaarc3308352019-09-01 16:24:56 +020072// We may need to define the uint32_t on non-Unix system, but using the same
73// identifier causes conflicts. Therefore use UINT32_T.
Bram Moolenaar7db5fc82010-05-24 11:59:29 +020074# define UINT32_TYPEDEF uint32_t
Bram Moolenaarfa7584c2010-05-19 21:57:45 +020075#endif
76
Bram Moolenaare0a76582021-05-30 14:02:05 +020077// for INT_MAX, LONG_MAX et al.
78#include <limits.h>
79
Bram Moolenaar7db5fc82010-05-24 11:59:29 +020080#if !defined(UINT32_TYPEDEF)
Bram Moolenaarc3308352019-09-01 16:24:56 +020081# if defined(uint32_t) // this doesn't catch typedefs, unfortunately
Bram Moolenaar7db5fc82010-05-24 11:59:29 +020082# define UINT32_TYPEDEF uint32_t
Bram Moolenaarfa7584c2010-05-19 21:57:45 +020083# else
Bram Moolenaarc3308352019-09-01 16:24:56 +020084 // Fall back to assuming unsigned int is 32 bit. If this is wrong then the
85 // test in blowfish.c will fail.
Bram Moolenaar7db5fc82010-05-24 11:59:29 +020086# define UINT32_TYPEDEF unsigned int
Bram Moolenaarfa7584c2010-05-19 21:57:45 +020087# endif
Bram Moolenaar071d4272004-06-13 20:20:40 +000088#endif
89
Bram Moolenaarc3308352019-09-01 16:24:56 +020090// user ID of root is usually zero, but not for everybody
Bram Moolenaar311d9822007-02-27 15:48:28 +000091#ifdef __TANDEM
Bram Moolenaar25153e12010-02-24 14:47:08 +010092# ifndef _TANDEM_SOURCE
93# define _TANDEM_SOURCE
94# endif
Bram Moolenaar311d9822007-02-27 15:48:28 +000095# include <floss.h>
96# define ROOT_UID 65535
Bram Moolenaar03305f32014-03-24 19:44:09 +010097# define OLDXAW
98# if (_TANDEM_ARCH_ == 2 && __H_Series_RVU >= 621)
99# define SA_ONSTACK_COMPATIBILITY
100# endif
Bram Moolenaar311d9822007-02-27 15:48:28 +0000101#else
102# define ROOT_UID 0
103#endif
104
Sevan Janiyan063c5622023-09-18 20:04:32 +0200105/* Include MAC_OS_X_VERSION_* macros */
106#ifdef HAVE_AVAILABILITYMACROS_H
107# include <AvailabilityMacros.h>
108#endif
109
Bram Moolenaar071d4272004-06-13 20:20:40 +0000110/*
Bram Moolenaard0573012017-10-28 21:11:06 +0200111 * MACOS_X compiling for Mac OS X
112 * MACOS_X_DARWIN integrating the darwin feature into MACOS_X
Bram Moolenaar071d4272004-06-13 20:20:40 +0000113 */
Bram Moolenaard0573012017-10-28 21:11:06 +0200114#if defined(MACOS_X_DARWIN) && !defined(MACOS_X)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000115# define MACOS_X
Bram Moolenaar071d4272004-06-13 20:20:40 +0000116#endif
Bram Moolenaarc3308352019-09-01 16:24:56 +0200117// Unless made through the Makefile enforce GUI on Mac
Bram Moolenaard0573012017-10-28 21:11:06 +0200118#if defined(MACOS_X) && !defined(HAVE_CONFIG_H)
119# define UNIX
Bram Moolenaar071d4272004-06-13 20:20:40 +0000120#endif
121
Bram Moolenaar071d4272004-06-13 20:20:40 +0000122#if defined(FEAT_GUI_MOTIF) \
123 || defined(FEAT_GUI_GTK) \
Bram Moolenaarb3f74062020-02-26 16:16:53 +0100124 || defined(FEAT_GUI_HAIKU) \
Bram Moolenaar4f974752019-02-17 17:44:42 +0100125 || defined(FEAT_GUI_MSWIN) \
Bram Moolenaarcef9dcc2005-12-06 19:50:41 +0000126 || defined(FEAT_GUI_PHOTON)
Bram Moolenaarab79bcb2004-07-18 21:34:53 +0000127# if !defined(FEAT_GUI) && !defined(NO_X11_INCLUDES)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000128# define FEAT_GUI
129# endif
130#endif
131
Bram Moolenaarc3308352019-09-01 16:24:56 +0200132// Check support for rendering options
Bram Moolenaarb5a7a8b2014-08-06 14:52:30 +0200133#ifdef FEAT_GUI
134# if defined(FEAT_DIRECTX)
135# define FEAT_RENDER_OPTIONS
136# endif
137#endif
138
Bram Moolenaar071d4272004-06-13 20:20:40 +0000139/*
Bram Moolenaara2aa31a2014-02-23 22:52:40 +0100140 * VIM_SIZEOF_INT is used in feature.h, and the system-specific included files
141 * need items from feature.h. Therefore define VIM_SIZEOF_INT here.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000142 */
Bram Moolenaar4f974752019-02-17 17:44:42 +0100143#ifdef MSWIN
Bram Moolenaara2aa31a2014-02-23 22:52:40 +0100144# define VIM_SIZEOF_INT 4
Bram Moolenaar071d4272004-06-13 20:20:40 +0000145#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +0000146
147#ifdef AMIGA
Bram Moolenaarc3308352019-09-01 16:24:56 +0200148 // Be conservative about sizeof(int). It could be 4 too.
149# ifndef FEAT_GUI_GTK // avoid problems when generating prototypes
Bram Moolenaar071d4272004-06-13 20:20:40 +0000150# ifdef __GNUC__
Bram Moolenaara2aa31a2014-02-23 22:52:40 +0100151# define VIM_SIZEOF_INT 4
Bram Moolenaar071d4272004-06-13 20:20:40 +0000152# else
Bram Moolenaara2aa31a2014-02-23 22:52:40 +0100153# define VIM_SIZEOF_INT 2
Bram Moolenaar071d4272004-06-13 20:20:40 +0000154# endif
155# endif
156#endif
Bram Moolenaard0573012017-10-28 21:11:06 +0200157#if defined(MACOS_X) && !defined(HAVE_CONFIG_H)
158# define VIM_SIZEOF_INT __SIZEOF_INT__
Bram Moolenaar071d4272004-06-13 20:20:40 +0000159#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +0000160
Bram Moolenaar30276f22019-01-24 17:59:39 +0100161#if VIM_SIZEOF_INT < 4 && !defined(PROTO)
Bram Moolenaar2c02d382020-01-23 16:52:01 +0100162# error Vim only works with 32 bit int or larger
Bram Moolenaar30276f22019-01-24 17:59:39 +0100163#endif
164
Bram Moolenaarb822cb02016-07-30 14:12:23 +0200165/*
166 * #defines for optionals and features
Martin Tournoij7904fa42022-10-04 16:28:45 +0100167 * Also defines FEAT_TINY, FEAT_NORMAL, etc. when FEAT_HUGE is defined.
Bram Moolenaarb822cb02016-07-30 14:12:23 +0200168 */
169#include "feature.h"
170
Yee Cheng Chin4314e4f2022-10-08 13:50:05 +0100171#if defined(MACOS_X_DARWIN)
172# if defined(FEAT_NORMAL) && !defined(FEAT_CLIPBOARD)
173# define FEAT_CLIPBOARD
174# endif
Sevan Janiyan063c5622023-09-18 20:04:32 +0200175# if defined(FEAT_HUGE) && !defined(FEAT_SOUND) && \
Yee Cheng Chinf59cbef2023-10-02 21:28:50 +0200176 defined(__clang_major__) && __clang_major__ >= 7 && \
177 defined(MAC_OS_X_VERSION_MIN_REQUIRED) && MAC_OS_X_VERSION_MIN_REQUIRED >= 1060
Yee Cheng Chin4314e4f2022-10-08 13:50:05 +0100178# define FEAT_SOUND
179# endif
180# if defined(FEAT_SOUND)
181# define FEAT_SOUND_MACOSX
182# endif
Bram Moolenaarb822cb02016-07-30 14:12:23 +0200183#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +0000184
Bram Moolenaarc3308352019-09-01 16:24:56 +0200185// +x11 is only enabled when it's both available and wanted.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000186#if defined(HAVE_X11) && defined(WANT_X11)
187# define FEAT_X11
188#endif
189
Bram Moolenaarab79bcb2004-07-18 21:34:53 +0000190#ifdef NO_X11_INCLUDES
Bram Moolenaarc3308352019-09-01 16:24:56 +0200191 // In os_mac_conv.c and os_macosx.m NO_X11_INCLUDES is defined to avoid
192 // X11 headers. Disable all X11 related things to avoid conflicts.
Bram Moolenaarab79bcb2004-07-18 21:34:53 +0000193# ifdef FEAT_X11
194# undef FEAT_X11
195# endif
Bram Moolenaared39e1d2008-08-09 17:55:22 +0000196# ifdef FEAT_GUI_X11
197# undef FEAT_GUI_X11
198# endif
Bram Moolenaarab79bcb2004-07-18 21:34:53 +0000199# ifdef FEAT_XCLIPBOARD
200# undef FEAT_XCLIPBOARD
201# endif
202# ifdef FEAT_GUI_MOTIF
203# undef FEAT_GUI_MOTIF
204# endif
Bram Moolenaarab79bcb2004-07-18 21:34:53 +0000205# ifdef FEAT_GUI_GTK
206# undef FEAT_GUI_GTK
207# endif
208# ifdef FEAT_BEVAL_TIP
209# undef FEAT_BEVAL_TIP
210# endif
211# ifdef FEAT_XIM
212# undef FEAT_XIM
213# endif
214# ifdef FEAT_CLIENTSERVER
215# undef FEAT_CLIENTSERVER
216# endif
217#endif
218
Bram Moolenaarc3308352019-09-01 16:24:56 +0200219// The Mac conversion stuff doesn't work under X11.
Bram Moolenaar264b74f2019-01-24 17:18:42 +0100220#if defined(MACOS_X_DARWIN)
Bram Moolenaardb003512006-03-15 22:48:35 +0000221# define MACOS_CONVERT
222#endif
223
Bram Moolenaarc3308352019-09-01 16:24:56 +0200224// Can't use "PACKAGE" here, conflicts with a Perl include file.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000225#ifndef VIMPACKAGE
226# define VIMPACKAGE "vim"
227#endif
228
229/*
230 * Find out if function definitions should include argument types
231 */
232#ifdef AZTEC_C
233# include <functions.h>
Bram Moolenaar071d4272004-06-13 20:20:40 +0000234#endif
235
236#ifdef SASC
237# include <clib/exec_protos.h>
Bram Moolenaar071d4272004-06-13 20:20:40 +0000238#endif
239
240#ifdef _DCC
241# include <clib/exec_protos.h>
Bram Moolenaar071d4272004-06-13 20:20:40 +0000242#endif
243
Bram Moolenaarb3f74062020-02-26 16:16:53 +0100244#ifdef __HAIKU__
245# include "os_haiku.h"
246# define __ARGS(x) x
247#endif
248
Bram Moolenaara06ecab2016-07-16 14:47:36 +0200249#if (defined(UNIX) || defined(VMS)) \
Bram Moolenaar071d4272004-06-13 20:20:40 +0000250 && (!defined(MACOS_X) || defined(HAVE_CONFIG_H))
Bram Moolenaarc3308352019-09-01 16:24:56 +0200251# include "os_unix.h" // bring lots of system header files
ichizok378447f2023-05-11 22:25:42 +0100252#else
253 // For all non-Unix systems: use old-fashioned signal().
254# define mch_signal(signum, sighandler) signal(signum, sighandler)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000255#endif
256
Bram Moolenaarc3308352019-09-01 16:24:56 +0200257// Mark unused function arguments with UNUSED, so that gcc -Wunused-parameter
258// can be used to check for mistakes.
ola.soder@axis.combd89d442022-02-11 19:27:55 +0000259#ifndef UNUSED
260# if defined(HAVE_ATTRIBUTE_UNUSED) || defined(__MINGW32__)
Bram Moolenaarb20b9e12019-09-21 20:48:04 +0200261# define UNUSED __attribute__((unused))
ola.soder@axis.combd89d442022-02-11 19:27:55 +0000262# else
263# if defined __has_attribute
264# if __has_attribute(unused)
265# define UNUSED __attribute__((unused))
266# endif
267# endif
Bram Moolenaarb20b9e12019-09-21 20:48:04 +0200268# endif
ola.soder@axis.combd89d442022-02-11 19:27:55 +0000269# ifndef UNUSED
270# define UNUSED
271# endif
Bram Moolenaar0c094b92009-05-14 20:20:33 +0000272#endif
273
Bram Moolenaarc3308352019-09-01 16:24:56 +0200274// Used to check for "sun", "__sun" is used by newer compilers.
Bram Moolenaara899e6e2016-12-03 16:40:51 +0100275#if defined(__sun)
276# define SUN_SYSTEM
277#endif
278
Bram Moolenaarc3308352019-09-01 16:24:56 +0200279// If we're compiling in C++ (currently only KVim), the system
280// headers must have the correct prototypes or nothing will build.
281// Conversely, our prototypes might clash due to throw() specifiers and
282// cause compilation failures even though the headers are correct. For
283// a concrete example, gcc-3.2 enforces exception specifications, and
284// glibc-2.2.5 has them in their system headers.
Bram Moolenaar843ee412004-06-30 16:16:41 +0000285#if !defined(__cplusplus) && defined(UNIX) \
Bram Moolenaarc3308352019-09-01 16:24:56 +0200286 && !defined(MACOS_X) // MACOS_X doesn't yet support osdef.h
287# include "auto/osdef.h" // bring missing declarations in
Bram Moolenaar071d4272004-06-13 20:20:40 +0000288#endif
289
Bram Moolenaar071d4272004-06-13 20:20:40 +0000290#ifdef AMIGA
291# include "os_amiga.h"
292#endif
293
Bram Moolenaar4f974752019-02-17 17:44:42 +0100294#ifdef MSWIN
Bram Moolenaar071d4272004-06-13 20:20:40 +0000295# include "os_win32.h"
296#endif
297
Bram Moolenaard0573012017-10-28 21:11:06 +0200298#if defined(MACOS_X)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000299# include "os_mac.h"
300#endif
301
Bram Moolenaar071d4272004-06-13 20:20:40 +0000302#ifdef __QNX__
303# include "os_qnx.h"
304#endif
305
Bram Moolenaar071d4272004-06-13 20:20:40 +0000306#ifdef X_LOCALE
307# include <X11/Xlocale.h>
308#else
309# ifdef HAVE_LOCALE_H
310# include <locale.h>
311# endif
312#endif
313
314/*
315 * Maximum length of a path (for non-unix systems) Make it a bit long, to stay
316 * on the safe side. But not too long to put on the stack.
317 */
318#ifndef MAXPATHL
319# ifdef MAXPATHLEN
320# define MAXPATHL MAXPATHLEN
321# else
322# define MAXPATHL 256
323# endif
324#endif
325#ifdef BACKSLASH_IN_FILENAME
Bram Moolenaaraebaf892008-05-28 14:49:58 +0000326# define PATH_ESC_CHARS ((char_u *)" \t\n*?[{`%#'\"|!<")
Bram Moolenaar21c1a0c2021-10-17 17:20:23 +0100327# define BUFFER_ESC_CHARS ((char_u *)" \t\n*?[`%#'\"|!<")
Bram Moolenaar071d4272004-06-13 20:20:40 +0000328#else
Bram Moolenaar03cd93a2008-11-20 09:27:32 +0000329# ifdef VMS
Bram Moolenaarc3308352019-09-01 16:24:56 +0200330 // VMS allows a lot of characters in the file name
Bram Moolenaar03cd93a2008-11-20 09:27:32 +0000331# define PATH_ESC_CHARS ((char_u *)" \t\n*?{`\\%#'\"|!")
332# define SHELL_ESC_CHARS ((char_u *)" \t\n*?{`\\%#'|!()&")
333# else
334# define PATH_ESC_CHARS ((char_u *)" \t\n*?[{`$\\%#'\"|!<")
335# define SHELL_ESC_CHARS ((char_u *)" \t\n*?[{`$\\%#'\"|!<>();&")
336# endif
Bram Moolenaar21c1a0c2021-10-17 17:20:23 +0100337# define BUFFER_ESC_CHARS ((char_u *)" \t\n*?[`$\\%#'\"|!<")
Bram Moolenaar071d4272004-06-13 20:20:40 +0000338#endif
339
Bram Moolenaarc3308352019-09-01 16:24:56 +0200340// length of a buffer to store a number in ASCII (64 bits binary + NUL)
Bram Moolenaar887c1fe2016-01-02 17:56:35 +0100341#define NUMBUFLEN 65
342
Bram Moolenaarc3308352019-09-01 16:24:56 +0200343// flags for vim_str2nr()
Bram Moolenaarc17e66c2020-06-02 21:38:22 +0200344#define STR2NR_BIN 0x01
345#define STR2NR_OCT 0x02
346#define STR2NR_HEX 0x04
347#define STR2NR_OOCT 0x08 // Octal with prefix "0o": 0o777
348#define STR2NR_ALL (STR2NR_BIN + STR2NR_OCT + STR2NR_HEX + STR2NR_OOCT)
349#define STR2NR_NO_OCT (STR2NR_BIN + STR2NR_HEX + STR2NR_OOCT)
Bram Moolenaar60a8de22019-09-15 14:33:22 +0200350
351#define STR2NR_FORCE 0x80 // only when ONE of the above is used
352
353#define STR2NR_QUOTE 0x10 // ignore embedded single quotes
Bram Moolenaar071d4272004-06-13 20:20:40 +0000354
355/*
356 * Shorthand for unsigned variables. Many systems, but not all, have u_char
357 * already defined, so we use char_u to avoid trouble.
358 */
359typedef unsigned char char_u;
360typedef unsigned short short_u;
361typedef unsigned int int_u;
Bram Moolenaar88c86eb2019-01-17 17:13:30 +0100362
Bram Moolenaarc3308352019-09-01 16:24:56 +0200363// Make sure long_u is big enough to hold a pointer.
364// On Win64, longs are 32 bits and pointers are 64 bits.
365// For printf() and scanf(), we need to take care of long_u specifically.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000366#ifdef _WIN64
Bram Moolenaar55d5c032010-07-17 23:52:29 +0200367typedef unsigned __int64 long_u;
368typedef __int64 long_i;
Bram Moolenaard695ba72020-05-10 13:42:43 +0200369# define SCANF_HEX_LONG_U "%llx"
370# define SCANF_DECIMAL_LONG_U "%llu"
371# define PRINTF_HEX_LONG_U "0x%llx"
Bram Moolenaar071d4272004-06-13 20:20:40 +0000372#else
K.Takata250155a2022-01-26 11:16:52 +0000373typedef unsigned long long_u;
374typedef long long_i;
Bram Moolenaarcb4cef22008-03-16 15:04:34 +0000375# define SCANF_HEX_LONG_U "%lx"
376# define SCANF_DECIMAL_LONG_U "%lu"
377# define PRINTF_HEX_LONG_U "0x%lx"
Bram Moolenaar071d4272004-06-13 20:20:40 +0000378#endif
Bram Moolenaarcb4cef22008-03-16 15:04:34 +0000379#define PRINTF_DECIMAL_LONG_U SCANF_DECIMAL_LONG_U
Bram Moolenaar071d4272004-06-13 20:20:40 +0000380
381/*
Bram Moolenaara2aa31a2014-02-23 22:52:40 +0100382 * Only systems which use configure will have SIZEOF_OFF_T and VIM_SIZEOF_LONG
Bram Moolenaar914703b2010-05-31 21:59:46 +0200383 * defined, which is ok since those are the same systems which can have
384 * varying sizes for off_t. The other systems will continue to use "%ld" to
385 * print off_t since off_t is simply a typedef to long for them.
386 */
Bram Moolenaara2aa31a2014-02-23 22:52:40 +0100387#if defined(SIZEOF_OFF_T) && (SIZEOF_OFF_T > VIM_SIZEOF_LONG)
Bram Moolenaar914703b2010-05-31 21:59:46 +0200388# define LONG_LONG_OFF_T
389#endif
390
391/*
Bram Moolenaar8767f522016-07-01 17:17:39 +0200392 * We use 64-bit file functions here, if available. E.g. ftello() returns
393 * off_t instead of long, which helps if long is 32 bit and off_t is 64 bit.
394 * We assume that when fseeko() is available then ftello() is too.
395 * Note that Windows has different function names.
396 */
zeertzjq44068e92022-06-16 11:14:55 +0100397#if defined(MSWIN) && !defined(PROTO)
Bram Moolenaar8767f522016-07-01 17:17:39 +0200398typedef __int64 off_T;
399# ifdef __MINGW32__
400# define vim_lseek lseek64
401# define vim_fseek fseeko64
402# define vim_ftell ftello64
403# else
404# define vim_lseek _lseeki64
405# define vim_fseek _fseeki64
406# define vim_ftell _ftelli64
407# endif
408#else
Bram Moolenaard90b6c02016-08-28 18:10:45 +0200409# ifdef PROTO
410typedef long off_T;
411# else
Bram Moolenaar8767f522016-07-01 17:17:39 +0200412typedef off_t off_T;
Bram Moolenaard90b6c02016-08-28 18:10:45 +0200413# endif
Bram Moolenaar8767f522016-07-01 17:17:39 +0200414# ifdef HAVE_FSEEKO
415# define vim_lseek lseek
416# define vim_ftell ftello
417# define vim_fseek fseeko
418# else
419# define vim_lseek lseek
420# define vim_ftell ftell
421# define vim_fseek(a, b, c) fseek(a, (long)b, c)
422# endif
423#endif
424
425/*
Bram Moolenaar071d4272004-06-13 20:20:40 +0000426 * The characters and attributes cached for the screen.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000427 */
Bram Moolenaar7e8fd632006-02-18 22:14:51 +0000428typedef char_u schar_T;
Bram Moolenaar3918c952005-03-15 22:34:55 +0000429typedef unsigned short sattr_T;
Bram Moolenaar9f45ccd2017-09-02 20:40:35 +0200430#define MAX_TYPENR 65535
Bram Moolenaar071d4272004-06-13 20:20:40 +0000431
432/*
433 * The u8char_T can hold one decoded UTF-8 character.
Bram Moolenaar9ba61172019-01-24 18:20:17 +0100434 * We use 32 bits, since some Asian characters don't fit in 16 bits.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000435 */
Bram Moolenaar9ba61172019-01-24 18:20:17 +0100436typedef unsigned int u8char_T; // int is 32 bits or more
Bram Moolenaar071d4272004-06-13 20:20:40 +0000437
Ernie Raelfda700c2023-11-30 18:20:00 +0100438/*
439 * The vimlong_T has sizeof(vimlong_T) >= 2 * sizeof(int).
440 * One use is simple handling of overflow in int calculations.
441 */
Zoltan Arpadffy1c8e2332023-12-05 16:04:23 +0100442#if defined(VMS) && defined(VAX)
443// unsupported compiler
444typedef long vimlong_T;
445#else
Ernie Raelfda700c2023-11-30 18:20:00 +0100446typedef long long vimlong_T;
Zoltan Arpadffy1c8e2332023-12-05 16:04:23 +0100447#endif
Ernie Raelfda700c2023-11-30 18:20:00 +0100448
Bram Moolenaarc3308352019-09-01 16:24:56 +0200449#ifndef UNIX // For Unix this is included in os_unix.h
Bram Moolenaar071d4272004-06-13 20:20:40 +0000450# include <stdio.h>
451# include <ctype.h>
452#endif
453
454#include "ascii.h"
455#include "keymap.h"
Bram Moolenaar1d69ef42021-11-19 11:35:32 +0000456#include "termdefs.h"
Bram Moolenaar071d4272004-06-13 20:20:40 +0000457#include "macros.h"
458
459#ifdef LATTICE
460# include <sys/types.h>
461# include <sys/stat.h>
462#endif
463#ifdef _DCC
464# include <sys/stat.h>
465#endif
Bram Moolenaar48e330a2016-02-23 14:53:34 +0100466#if defined(MSWIN)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000467# include <sys/stat.h>
468#endif
469
Bram Moolenaar4f974752019-02-17 17:44:42 +0100470#if defined(HAVE_ERRNO_H) || defined(MSWIN)
Bram Moolenaarb57aa922010-12-17 20:24:01 +0100471# include <errno.h>
472#endif
473
Bram Moolenaar071d4272004-06-13 20:20:40 +0000474/*
475 * Allow other (non-unix) systems to configure themselves now
476 * These are also in os_unix.h, because osdef.sh needs them there.
477 */
478#ifndef UNIX
Bram Moolenaarc3308352019-09-01 16:24:56 +0200479// Note: Some systems need both string.h and strings.h (Savage). If the
480// system can't handle this, define NO_STRINGS_WITH_STRING_H.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000481# ifdef HAVE_STRING_H
482# include <string.h>
483# endif
484# if defined(HAVE_STRINGS_H) && !defined(NO_STRINGS_WITH_STRING_H)
Bram Moolenaar08ed30e2013-01-17 17:17:26 +0100485# include <strings.h>
Bram Moolenaar071d4272004-06-13 20:20:40 +0000486# endif
487# ifdef HAVE_STAT_H
488# include <stat.h>
489# endif
490# ifdef HAVE_STDLIB_H
491# include <stdlib.h>
492# endif
Bram Moolenaarc3308352019-09-01 16:24:56 +0200493#endif // NON-UNIX
Bram Moolenaar071d4272004-06-13 20:20:40 +0000494
495#include <assert.h>
496
Bram Moolenaarfa7584c2010-05-19 21:57:45 +0200497#ifdef HAVE_STDINT_H
498# include <stdint.h>
499#endif
500#ifdef HAVE_INTTYPES_H
501# include <inttypes.h>
502#endif
Bram Moolenaar8fef2ad2005-04-23 20:42:23 +0000503#ifdef HAVE_WCTYPE_H
504# include <wctype.h>
505#endif
Bram Moolenaarba4ef272016-01-30 21:48:49 +0100506#include <stdarg.h>
Zoltan Arpadffy1c8e2332023-12-05 16:04:23 +0100507// older compilers do not define va_copy
508#ifndef va_copy
509# define va_copy(dst, src) ((dst) = (src))
510#endif
Bram Moolenaar8fef2ad2005-04-23 20:42:23 +0000511
Bram Moolenaarc3308352019-09-01 16:24:56 +0200512// for offsetof()
Bram Moolenaar84026842016-07-17 20:37:43 +0200513#include <stddef.h>
514
Bram Moolenaar08ed30e2013-01-17 17:17:26 +0100515#if defined(HAVE_SYS_SELECT_H) && \
Bram Moolenaar581f6dc2010-03-10 16:12:48 +0100516 (!defined(HAVE_SYS_TIME_H) || defined(SYS_SELECT_WITH_SYS_TIME))
Bram Moolenaar08ed30e2013-01-17 17:17:26 +0100517# include <sys/select.h>
518#endif
Bram Moolenaar581f6dc2010-03-10 16:12:48 +0100519
Bram Moolenaar08ed30e2013-01-17 17:17:26 +0100520#ifndef HAVE_SELECT
521# ifdef HAVE_SYS_POLL_H
522# include <sys/poll.h>
Bram Moolenaar4f974752019-02-17 17:44:42 +0100523# elif defined(MSWIN)
Bram Moolenaarf12d9832016-01-29 21:11:25 +0100524# define HAVE_SELECT
Bram Moolenaar08ed30e2013-01-17 17:17:26 +0100525# else
526# ifdef HAVE_POLL_H
527# include <poll.h>
Bram Moolenaar581f6dc2010-03-10 16:12:48 +0100528# endif
529# endif
Bram Moolenaar08ed30e2013-01-17 17:17:26 +0100530#endif
Bram Moolenaar581f6dc2010-03-10 16:12:48 +0100531
Bram Moolenaar131530a2021-07-29 20:37:49 +0200532#ifdef HAVE_SODIUM
533# include <sodium.h>
534#endif
535
Bram Moolenaarc3308352019-09-01 16:24:56 +0200536// ================ end of the header file puzzle ===============
Bram Moolenaar071d4272004-06-13 20:20:40 +0000537
538/*
539 * For dynamically loaded imm library. Currently, only for Win32.
540 */
541#ifdef DYNAMIC_IME
542# ifndef FEAT_MBYTE_IME
543# define FEAT_MBYTE_IME
544# endif
545#endif
546
547/*
Bram Moolenaar071d4272004-06-13 20:20:40 +0000548 * For dynamically loaded gettext library. Currently, only for Win32.
549 */
550#ifdef DYNAMIC_GETTEXT
551# ifndef FEAT_GETTEXT
552# define FEAT_GETTEXT
553# endif
Bram Moolenaarc3308352019-09-01 16:24:56 +0200554// These are in os_win32.c
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000555extern char *(*dyn_libintl_gettext)(const char *msgid);
Bram Moolenaaree695f72016-08-03 22:08:45 +0200556extern char *(*dyn_libintl_ngettext)(const char *msgid, const char *msgid_plural, unsigned long n);
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000557extern char *(*dyn_libintl_bindtextdomain)(const char *domainname, const char *dirname);
558extern char *(*dyn_libintl_bind_textdomain_codeset)(const char *domainname, const char *codeset);
559extern char *(*dyn_libintl_textdomain)(const char *domainname);
Bram Moolenaar0eb035c2019-04-02 22:15:55 +0200560extern int (*dyn_libintl_wputenv)(const wchar_t *envstring);
Bram Moolenaar071d4272004-06-13 20:20:40 +0000561#endif
562
563
564/*
565 * The _() stuff is for using gettext(). It is a no-op when libintl.h is not
566 * found or the +multilang feature is disabled.
Bram Moolenaarda6e8912018-08-21 15:12:14 +0200567 * Use NGETTEXT(single, multi, number) to get plural behavior:
568 * - single - message for singular form
569 * - multi - message for plural form
570 * - number - the count
Bram Moolenaar071d4272004-06-13 20:20:40 +0000571 */
572#ifdef FEAT_GETTEXT
573# ifdef DYNAMIC_GETTEXT
574# define _(x) (*dyn_libintl_gettext)((char *)(x))
Bram Moolenaar1c465442017-03-12 20:10:05 +0100575# define NGETTEXT(x, xs, n) (*dyn_libintl_ngettext)((char *)(x), (char *)(xs), (n))
Bram Moolenaar071d4272004-06-13 20:20:40 +0000576# define N_(x) x
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000577# define bindtextdomain(domain, dir) (*dyn_libintl_bindtextdomain)((domain), (dir))
578# define bind_textdomain_codeset(domain, codeset) (*dyn_libintl_bind_textdomain_codeset)((domain), (codeset))
579# if !defined(HAVE_BIND_TEXTDOMAIN_CODESET)
580# define HAVE_BIND_TEXTDOMAIN_CODESET 1
581# endif
Bram Moolenaar071d4272004-06-13 20:20:40 +0000582# define textdomain(domain) (*dyn_libintl_textdomain)(domain)
Bram Moolenaar7c23d1d2017-02-01 13:14:16 +0100583# define libintl_wputenv(envstring) (*dyn_libintl_wputenv)(envstring)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000584# else
585# include <libintl.h>
586# define _(x) gettext((char *)(x))
Bram Moolenaar1c465442017-03-12 20:10:05 +0100587# define NGETTEXT(x, xs, n) ngettext((x), (xs), (n))
Bram Moolenaar071d4272004-06-13 20:20:40 +0000588# ifdef gettext_noop
589# define N_(x) gettext_noop(x)
590# else
591# define N_(x) x
592# endif
593# endif
594#else
595# define _(x) ((char *)(x))
Bram Moolenaar1c465442017-03-12 20:10:05 +0100596# define NGETTEXT(x, xs, n) (((n) == 1) ? (char *)(x) : (char *)(xs))
Bram Moolenaar071d4272004-06-13 20:20:40 +0000597# define N_(x) x
598# ifdef bindtextdomain
599# undef bindtextdomain
600# endif
Christ van Willegen8252ef12024-07-11 21:36:21 +0200601# define bindtextdomain(x, y) ""
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000602# ifdef bind_textdomain_codeset
603# undef bind_textdomain_codeset
604# endif
Bram Moolenaarc3308352019-09-01 16:24:56 +0200605# define bind_textdomain_codeset(x, y) // empty
Bram Moolenaar071d4272004-06-13 20:20:40 +0000606# ifdef textdomain
607# undef textdomain
608# endif
Bram Moolenaarc3308352019-09-01 16:24:56 +0200609# define textdomain(x) // empty
Bram Moolenaar071d4272004-06-13 20:20:40 +0000610#endif
611
612/*
Bram Moolenaara4d158b2022-08-14 14:17:45 +0100613 * Flags for update_screen().
614 * The higher the value, the higher the priority.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000615 */
Bram Moolenaara4d158b2022-08-14 14:17:45 +0100616#define UPD_VALID_NO_UPDATE 5 // no new changes, keep the command line if
Bram Moolenaarc3308352019-09-01 16:24:56 +0200617 // possible
Bram Moolenaara4d158b2022-08-14 14:17:45 +0100618#define UPD_VALID 10 // buffer not changed, or changes marked
Bram Moolenaarc3308352019-09-01 16:24:56 +0200619 // with b_mod_*
Bram Moolenaara4d158b2022-08-14 14:17:45 +0100620#define UPD_INVERTED 20 // redisplay inverted part that changed
621#define UPD_INVERTED_ALL 25 // redisplay whole inverted part
622#define UPD_REDRAW_TOP 30 // display first w_upd_rows screen lines
623#define UPD_SOME_VALID 35 // like UPD_NOT_VALID but may scroll
624#define UPD_NOT_VALID 40 // buffer needs complete redraw
625#define UPD_CLEAR 50 // screen messed up, clear it
Bram Moolenaar071d4272004-06-13 20:20:40 +0000626
Bram Moolenaar7528d1f2019-09-19 23:06:20 +0200627// flags for screen_line()
628#define SLF_RIGHTLEFT 1
629#define SLF_POPUP 2
zeertzjqd0c1b772024-03-16 15:03:33 +0100630#define SLF_INC_VCOL 4
Bram Moolenaar7528d1f2019-09-19 23:06:20 +0200631
632#define MB_FILLER_CHAR '<' // character used when a double-width character
633 // doesn't fit.
634
Bram Moolenaar071d4272004-06-13 20:20:40 +0000635/*
Bram Moolenaar071d4272004-06-13 20:20:40 +0000636 * Flags for w_valid.
637 * These are set when something in a window structure becomes invalid, except
638 * when the cursor is moved. Call check_cursor_moved() before testing one of
639 * the flags.
640 * These are reset when that thing has been updated and is valid again.
641 *
642 * Every function that invalidates one of these must call one of the
643 * invalidate_* functions.
644 *
645 * w_valid is supposed to be used only in screen.c. From other files, use the
646 * functions that set or reset the flags.
647 *
648 * VALID_BOTLINE VALID_BOTLINE_AP
649 * on on w_botline valid
650 * off on w_botline approximated
651 * off off w_botline not valid
652 * on off not possible
653 */
Bram Moolenaar4d784b22019-05-25 19:51:39 +0200654#define VALID_WROW 0x01 // w_wrow (window row) is valid
655#define VALID_WCOL 0x02 // w_wcol (window col) is valid
656#define VALID_VIRTCOL 0x04 // w_virtcol (file col) is valid
657#define VALID_CHEIGHT 0x08 // w_cline_height and w_cline_folded valid
658#define VALID_CROW 0x10 // w_cline_row is valid
Jaehwang Jungeb80b832024-04-26 18:48:48 +0200659#define VALID_BOTLINE 0x20 // w_botline and w_empty_rows are valid
660#define VALID_BOTLINE_AP 0x40 // w_botline is approximated
Bram Moolenaar4d784b22019-05-25 19:51:39 +0200661#define VALID_TOPLINE 0x80 // w_topline is valid (for cursor position)
Bram Moolenaar2cd0dce2019-05-26 22:17:52 +0200662
663// Values for w_popup_flags.
Bram Moolenaar9bcb70c2019-08-01 21:11:05 +0200664#define POPF_IS_POPUP 0x01 // this is a popup window
665#define POPF_HIDDEN 0x02 // popup is not displayed
Bram Moolenaar27724252022-05-08 15:00:04 +0100666#define POPF_HIDDEN_FORCE 0x04 // popup is explicitly set to not be displayed
667#define POPF_CURSORLINE 0x08 // popup is highlighting at the cursorline
668#define POPF_ON_CMDLINE 0x10 // popup overlaps command line
669#define POPF_DRAG 0x20 // popup can be moved by dragging border
670#define POPF_DRAGALL 0x40 // popup can be moved by dragging everywhere
671#define POPF_RESIZE 0x80 // popup can be resized by dragging
672#define POPF_MAPPING 0x100 // mapping keys
673#define POPF_INFO 0x200 // used for info of popup menu
674#define POPF_INFO_MENU 0x400 // align info popup with popup menu
675#define POPF_POSINVERT 0x800 // vertical position can be inverted
Bram Moolenaarafe45b62019-11-13 22:35:19 +0100676
677// flags used in w_popup_handled
678#define POPUP_HANDLED_1 0x01 // used by mouse_find_win()
679#define POPUP_HANDLED_2 0x02 // used by popup_do_filter()
680#define POPUP_HANDLED_3 0x04 // used by popup_check_cursor_pos()
681#define POPUP_HANDLED_4 0x08 // used by may_update_popup_mask()
682#define POPUP_HANDLED_5 0x10 // used by update_popups()
Bram Moolenaar13d5c3f2019-07-28 21:42:38 +0200683
Bram Moolenaar071d4272004-06-13 20:20:40 +0000684/*
685 * Terminal highlighting attribute bits.
Bram Moolenaar42b4dda2010-03-02 15:56:05 +0100686 * Attributes above HL_ALL are used for syntax highlighting.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000687 */
688#define HL_NORMAL 0x00
689#define HL_INVERSE 0x01
690#define HL_BOLD 0x02
691#define HL_ITALIC 0x04
692#define HL_UNDERLINE 0x08
Bram Moolenaar3918c952005-03-15 22:34:55 +0000693#define HL_UNDERCURL 0x10
Bram Moolenaar84f54632022-06-29 18:39:11 +0100694#define HL_UNDERDOUBLE 0x20
695#define HL_UNDERDOTTED 0x40
696#define HL_UNDERDASHED 0x80
697#define HL_STANDOUT 0x100
698#define HL_NOCOMBINE 0x200
699#define HL_STRIKETHROUGH 0x400
700#define HL_ALL 0x7ff
Bram Moolenaar071d4272004-06-13 20:20:40 +0000701
Bram Moolenaarc3308352019-09-01 16:24:56 +0200702// special attribute addition: Put message in history
Bram Moolenaar071d4272004-06-13 20:20:40 +0000703#define MSG_HIST 0x1000
704
705/*
Bram Moolenaar24959102022-05-07 20:01:16 +0100706 * Values for State.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000707 *
Bram Moolenaar24959102022-05-07 20:01:16 +0100708 * The lower bits up to 0x80 are used to distinguish normal/visual/op_pending
709 * /cmdline/insert/replace/terminal mode. This is used for mapping. If none
710 * of these bits are set, no mapping is done. See the comment above do_map().
711 * The upper bits are used to distinguish between other states and variants of
712 * the base modes.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000713 */
Bram Moolenaar24959102022-05-07 20:01:16 +0100714#define MODE_NORMAL 0x01 // Normal mode, command expected
715#define MODE_VISUAL 0x02 // Visual mode - use get_real_state()
716#define MODE_OP_PENDING 0x04 // Normal mode, operator is pending - use
Bram Moolenaarc3308352019-09-01 16:24:56 +0200717 // get_real_state()
Bram Moolenaar24959102022-05-07 20:01:16 +0100718#define MODE_CMDLINE 0x08 // Editing the command line
719#define MODE_INSERT 0x10 // Insert mode, also for Replace mode
720#define MODE_LANGMAP 0x20 // Language mapping, can be combined with
721 // MODE_INSERT and MODE_CMDLINE
722#define MODE_SELECT 0x40 // Select mode, use get_real_state()
723#define MODE_TERMINAL 0x80 // Terminal mode
Bram Moolenaar071d4272004-06-13 20:20:40 +0000724
Bram Moolenaar24959102022-05-07 20:01:16 +0100725#define MAP_ALL_MODES 0xff // all mode bits used for mapping
Bram Moolenaar071d4272004-06-13 20:20:40 +0000726
Bram Moolenaar24959102022-05-07 20:01:16 +0100727#define REPLACE_FLAG 0x100 // Replace mode flag
728#define MODE_REPLACE (REPLACE_FLAG | MODE_INSERT)
729#define VREPLACE_FLAG 0x200 // Virtual-replace mode flag
730#define MODE_VREPLACE (REPLACE_FLAG | VREPLACE_FLAG | MODE_INSERT)
731#define MODE_LREPLACE (REPLACE_FLAG | MODE_LANGMAP)
732
733#define MODE_NORMAL_BUSY (0x1000 | MODE_NORMAL)
734 // Normal mode, busy with a command
735#define MODE_HITRETURN (0x2000 | MODE_NORMAL)
736 // waiting for return or command
737#define MODE_ASKMORE 0x3000 // Asking if you want --more--
738#define MODE_SETWSIZE 0x4000 // window size has changed
739#define MODE_EXTERNCMD 0x5000 // executing an external command
740#define MODE_SHOWMATCH (0x6000 | MODE_INSERT) // show matching paren
741#define MODE_CONFIRM 0x7000 // ":confirm" prompt
Bram Moolenaar581ba392019-09-03 22:08:33 +0200742#define MODE_ALL 0xffff
Bram Moolenaar071d4272004-06-13 20:20:40 +0000743
Bram Moolenaar24959102022-05-07 20:01:16 +0100744#define MODE_MAX_LENGTH 4 // max mode length used by get_mode(),
745 // including the terminating NUL
Bram Moolenaar149667a2006-06-23 14:33:23 +0000746
Bram Moolenaarc3308352019-09-01 16:24:56 +0200747// directions
Bram Moolenaar071d4272004-06-13 20:20:40 +0000748#define FORWARD 1
749#define BACKWARD (-1)
750#define FORWARD_FILE 3
751#define BACKWARD_FILE (-3)
752
Bram Moolenaarc3308352019-09-01 16:24:56 +0200753// return values for functions
Bram Moolenaar071d4272004-06-13 20:20:40 +0000754#if !(defined(OK) && (OK == 1))
Bram Moolenaarc3308352019-09-01 16:24:56 +0200755// OK already defined to 1 in MacOS X curses, skip this
Bram Moolenaar071d4272004-06-13 20:20:40 +0000756# define OK 1
757#endif
758#define FAIL 0
Bram Moolenaarc3308352019-09-01 16:24:56 +0200759#define NOTDONE 2 // not OK or FAIL but skipped
Bram Moolenaar071d4272004-06-13 20:20:40 +0000760
Bram Moolenaarc3308352019-09-01 16:24:56 +0200761// flags for b_flags
Bram Moolenaarc7f1e402019-08-03 13:29:46 +0200762#define BF_RECOVERED 0x01 // buffer has been recovered
763#define BF_CHECK_RO 0x02 // need to check readonly when loading file
764 // into buffer (set by ":e", may be reset by
765 // ":buf"
766#define BF_NEVERLOADED 0x04 // file has never been loaded into buffer,
767 // many variables still need to be set
768#define BF_NOTEDITED 0x08 // Set when file name is changed after
769 // starting to edit, reset when file is
770 // written out.
771#define BF_NEW 0x10 // file didn't exist when editing started
772#define BF_NEW_W 0x20 // Warned for BF_NEW and file created
773#define BF_READERR 0x40 // got errors while reading the file
774#define BF_DUMMY 0x80 // dummy buffer, only used internally
775#define BF_PRESERVED 0x100 // ":preserve" was used
776#define BF_SYN_SET 0x200 // 'syntax' option was set
Bram Moolenaar2debf1c2019-08-04 20:44:19 +0200777#define BF_NO_SEA 0x400 // no swap_exists_action (ATTENTION prompt)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000778
Bram Moolenaarc3308352019-09-01 16:24:56 +0200779// Mask to check for flags that prevent normal writing
Bram Moolenaar071d4272004-06-13 20:20:40 +0000780#define BF_WRITE_MASK (BF_NOTEDITED + BF_NEW + BF_READERR)
781
782/*
783 * values for xp_context when doing command line completion
784 */
Bram Moolenaar071d4272004-06-13 20:20:40 +0000785#define EXPAND_UNSUCCESSFUL (-2)
786#define EXPAND_OK (-1)
787#define EXPAND_NOTHING 0
788#define EXPAND_COMMANDS 1
789#define EXPAND_FILES 2
790#define EXPAND_DIRECTORIES 3
791#define EXPAND_SETTINGS 4
792#define EXPAND_BOOL_SETTINGS 5
793#define EXPAND_TAGS 6
794#define EXPAND_OLD_SETTING 7
795#define EXPAND_HELP 8
796#define EXPAND_BUFFERS 9
797#define EXPAND_EVENTS 10
798#define EXPAND_MENUS 11
799#define EXPAND_SYNTAX 12
800#define EXPAND_HIGHLIGHT 13
801#define EXPAND_AUGROUP 14
802#define EXPAND_USER_VARS 15
803#define EXPAND_MAPPINGS 16
804#define EXPAND_TAGS_LISTFILES 17
805#define EXPAND_FUNCTIONS 18
806#define EXPAND_USER_FUNC 19
807#define EXPAND_EXPRESSION 20
808#define EXPAND_MENUNAMES 21
809#define EXPAND_USER_COMMANDS 22
810#define EXPAND_USER_CMD_FLAGS 23
811#define EXPAND_USER_NARGS 24
812#define EXPAND_USER_COMPLETE 25
813#define EXPAND_ENV_VARS 26
814#define EXPAND_LANGUAGE 27
815#define EXPAND_COLORS 28
816#define EXPAND_COMPILER 29
817#define EXPAND_USER_DEFINED 30
Bram Moolenaara466c992005-07-09 21:03:22 +0000818#define EXPAND_USER_LIST 31
Bram Moolenaar362e1a32006-03-06 23:29:24 +0000819#define EXPAND_SHELLCMD 32
Bram Moolenaarf4580d82009-03-18 11:52:53 +0000820#define EXPAND_CSCOPE 33
Bram Moolenaar3c65e312009-04-29 16:47:23 +0000821#define EXPAND_SIGN 34
Bram Moolenaarf86f26c2010-02-03 15:14:22 +0100822#define EXPAND_PROFILE 35
Bram Moolenaar42b4dda2010-03-02 15:56:05 +0100823#define EXPAND_BEHAVE 36
Bram Moolenaar883f5d02010-06-21 06:24:34 +0200824#define EXPAND_FILETYPE 37
Bram Moolenaar1587a1e2010-07-29 20:59:59 +0200825#define EXPAND_FILES_IN_PATH 38
826#define EXPAND_OWNSYNTAX 39
Bram Moolenaar9b486ca2011-05-19 18:26:40 +0200827#define EXPAND_LOCALES 40
Bram Moolenaar5ae636b2012-04-30 18:48:53 +0200828#define EXPAND_HISTORY 41
Bram Moolenaar24305862012-08-15 14:05:05 +0200829#define EXPAND_USER 42
Bram Moolenaarcd9c4622013-06-08 15:24:48 +0200830#define EXPAND_SYNTIME 43
Bram Moolenaarf1d6ccf2014-12-08 04:16:44 +0100831#define EXPAND_USER_ADDR_TYPE 44
Bram Moolenaar35ca0e72016-03-05 17:41:49 +0100832#define EXPAND_PACKADD 45
Bram Moolenaar9e507ca2016-10-15 15:39:39 +0200833#define EXPAND_MESSAGES 46
Bram Moolenaarcae92dc2017-08-06 15:22:15 +0200834#define EXPAND_MAPCLEAR 47
Bram Moolenaarcd43eff2018-03-29 15:55:38 +0200835#define EXPAND_ARGLIST 48
Bram Moolenaarae7dba82019-12-29 13:56:33 +0100836#define EXPAND_DIFF_BUFFERS 49
Bram Moolenaar4ee9d8e2021-06-13 18:38:48 +0200837#define EXPAND_DISASSEMBLE 50
Bram Moolenaar6e2e2cc2022-03-14 19:24:46 +0000838#define EXPAND_BREAKPOINT 51
Yegappan Lakshmanan454ce672022-03-24 11:22:13 +0000839#define EXPAND_SCRIPTNAMES 52
roota6759382023-01-21 21:56:06 +0000840#define EXPAND_RUNTIME 53
Yee Cheng Chin900894b2023-09-29 20:42:32 +0200841#define EXPAND_STRING_SETTING 54
842#define EXPAND_SETTING_SUBTRACT 55
Yee Cheng Chin989426b2023-10-14 11:46:51 +0200843#define EXPAND_ARGOPT 56
844#define EXPAND_TERMINALOPT 57
Doug Kearns81642d92024-01-04 22:37:44 +0100845#define EXPAND_KEYMAP 58
LemonBoya20bf692024-07-11 22:35:53 +0200846#define EXPAND_DIRS_IN_CDPATH 59
Ruslan Russkikh0407d622024-10-08 22:21:05 +0200847#define EXPAND_SHELLCMDLINE 60
Yegappan Lakshmanana13f3a42024-11-02 18:40:10 +0100848#define EXPAND_FINDFUNC 61
LemonBoya20bf692024-07-11 22:35:53 +0200849
Bram Moolenaar071d4272004-06-13 20:20:40 +0000850
Bram Moolenaarc3308352019-09-01 16:24:56 +0200851// Values for exmode_active (0 is no exmode)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000852#define EXMODE_NORMAL 1
853#define EXMODE_VIM 2
854
Bram Moolenaarc3308352019-09-01 16:24:56 +0200855// Values for nextwild() and ExpandOne(). See ExpandOne() for meaning.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000856#define WILD_FREE 1
857#define WILD_EXPAND_FREE 2
858#define WILD_EXPAND_KEEP 3
859#define WILD_NEXT 4
860#define WILD_PREV 5
861#define WILD_ALL 6
862#define WILD_LONGEST 7
Bram Moolenaar146e9c32012-03-07 19:18:23 +0100863#define WILD_ALL_KEEP 8
Yegappan Lakshmanan3908ef52022-02-08 12:08:07 +0000864#define WILD_CANCEL 9
865#define WILD_APPLY 10
Yegappan Lakshmanan5cffa8d2022-03-16 13:33:53 +0000866#define WILD_PAGEUP 11
867#define WILD_PAGEDOWN 12
Bram Moolenaar071d4272004-06-13 20:20:40 +0000868
Bram Moolenaar50f91d22019-08-02 19:52:15 +0200869#define WILD_LIST_NOTFOUND 0x01
870#define WILD_HOME_REPLACE 0x02
871#define WILD_USE_NL 0x04
872#define WILD_NO_BEEP 0x08
873#define WILD_ADD_SLASH 0x10
874#define WILD_KEEP_ALL 0x20
875#define WILD_SILENT 0x40
876#define WILD_ESCAPE 0x80
877#define WILD_ICASE 0x100
878#define WILD_ALLLINKS 0x200
879#define WILD_IGNORE_COMPLETESLASH 0x400
Bram Moolenaar2b78ab52019-10-19 22:50:20 +0200880#define WILD_NOERROR 0x800 // sets EW_NOERROR
Bram Moolenaar52410572019-10-27 05:12:45 +0100881#define WILD_BUFLASTUSED 0x1000
Bram Moolenaarae7dba82019-12-29 13:56:33 +0100882#define BUF_DIFF_FILTER 0x2000
Bram Moolenaar071d4272004-06-13 20:20:40 +0000883
Bram Moolenaar99499b12019-05-23 21:35:48 +0200884// Flags for expand_wildcards()
885#define EW_DIR 0x01 // include directory names
886#define EW_FILE 0x02 // include file names
887#define EW_NOTFOUND 0x04 // include not found names
888#define EW_ADDSLASH 0x08 // append slash to directory name
889#define EW_KEEPALL 0x10 // keep all matches
890#define EW_SILENT 0x20 // don't print "1 returned" from shell
891#define EW_EXEC 0x40 // executable files
892#define EW_PATH 0x80 // search in 'path' too
893#define EW_ICASE 0x100 // ignore case
894#define EW_NOERROR 0x200 // no error for bad regexp
895#define EW_NOTWILD 0x400 // add match with literal name if exists
896#define EW_KEEPDOLLAR 0x800 // do not escape $, $var is expanded
897// Note: mostly EW_NOTFOUND and EW_SILENT are mutually exclusive: EW_NOTFOUND
898// is used when executing commands and EW_SILENT for interactive expanding.
899#define EW_ALLLINKS 0x1000 // also links not pointing to existing file
900#define EW_SHELLCMD 0x2000 // called from expand_shellcmd(), don't check
901 // if executable is in $PATH
902#define EW_DODOT 0x4000 // also files starting with a dot
903#define EW_EMPTYOK 0x8000 // no matches is not an error
904#define EW_NOTENV 0x10000 // do not expand environment variables
LemonBoya20bf692024-07-11 22:35:53 +0200905#define EW_CDPATH 0x20000 // search in 'cdpath' too
Bram Moolenaar071d4272004-06-13 20:20:40 +0000906
Bram Moolenaarc3308352019-09-01 16:24:56 +0200907// Flags for find_file_*() functions.
908#define FINDFILE_FILE 0 // only files
909#define FINDFILE_DIR 1 // only directories
910#define FINDFILE_BOTH 2 // files and directories
Bram Moolenaar4d0ec162008-02-20 11:24:52 +0000911
kylo2529dac9b12022-03-27 20:05:17 +0100912#define W_ENDCOL(wp) ((wp)->w_wincol + (wp)->w_width)
Bram Moolenaara5a2be22017-09-19 22:08:04 +0200913#ifdef FEAT_MENU
kylo2529dac9b12022-03-27 20:05:17 +0100914# define W_WINROW(wp) ((wp)->w_winrow + (wp)->w_winbar_height)
Bram Moolenaara5a2be22017-09-19 22:08:04 +0200915#else
916# define W_WINROW(wp) (wp->w_winrow)
917#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +0000918
Bram Moolenaarc3308352019-09-01 16:24:56 +0200919// Values for the find_pattern_in_path() function args 'type' and 'action':
Bram Moolenaar071d4272004-06-13 20:20:40 +0000920#define FIND_ANY 1
921#define FIND_DEFINE 2
922#define CHECK_PATH 3
923
924#define ACTION_SHOW 1
925#define ACTION_GOTO 2
926#define ACTION_SPLIT 3
927#define ACTION_SHOW_ALL 4
Bram Moolenaare2c453d2019-08-21 14:37:09 +0200928#define ACTION_EXPAND 5
Bram Moolenaar071d4272004-06-13 20:20:40 +0000929
930#ifdef FEAT_SYN_HL
Bram Moolenaarc3308352019-09-01 16:24:56 +0200931# define SST_MIN_ENTRIES 150 // minimal size for state stack array
932# define SST_MAX_ENTRIES 1000 // maximal size for state stack array
933# define SST_FIX_STATES 7 // size of sst_stack[].
934# define SST_DIST 16 // normal distance between entries
kylo2529dac9b12022-03-27 20:05:17 +0100935# define SST_INVALID ((synstate_T *)-1) // invalid syn_state pointer
Bram Moolenaar860cae12010-06-05 23:22:07 +0200936
Bram Moolenaarc3308352019-09-01 16:24:56 +0200937# define HL_CONTAINED 0x01 // not used on toplevel
938# define HL_TRANSP 0x02 // has no highlighting
939# define HL_ONELINE 0x04 // match within one line only
940# define HL_HAS_EOL 0x08 // end pattern that matches with $
941# define HL_SYNC_HERE 0x10 // sync point after this item (syncing only)
942# define HL_SYNC_THERE 0x20 // sync point at current line (syncing only)
943# define HL_MATCH 0x40 // use match ID instead of item ID
944# define HL_SKIPNL 0x80 // nextgroup can skip newlines
945# define HL_SKIPWHITE 0x100 // nextgroup can skip white space
946# define HL_SKIPEMPTY 0x200 // nextgroup can skip empty lines
947# define HL_KEEPEND 0x400 // end match always kept
948# define HL_EXCLUDENL 0x800 // exclude NL from match
949# define HL_DISPLAY 0x1000 // only used for displaying, not syncing
950# define HL_FOLD 0x2000 // define fold
951# define HL_EXTEND 0x4000 // ignore a keepend
952# define HL_MATCHCONT 0x8000 // match continued from previous line
953# define HL_TRANS_CONT 0x10000 // transparent item without contains arg
954# define HL_CONCEAL 0x20000 // can be concealed
955# define HL_CONCEALENDS 0x40000 // can be concealed
Theodore Duboisf50d5362025-02-05 23:59:25 +0100956# define HL_INCLUDED_TOPLEVEL 0x80000 // toplevel item in included syntax, allowed by contains=TOP
Bram Moolenaar071d4272004-06-13 20:20:40 +0000957#endif
958
Bram Moolenaarc3308352019-09-01 16:24:56 +0200959// Values for 'options' argument in do_search() and searchit()
960#define SEARCH_REV 0x01 // go in reverse of previous dir.
961#define SEARCH_ECHO 0x02 // echo the search command and handle options
962#define SEARCH_MSG 0x0c // give messages (yes, it's not 0x04)
963#define SEARCH_NFMSG 0x08 // give all messages except not found
964#define SEARCH_OPT 0x10 // interpret optional flags
965#define SEARCH_HIS 0x20 // put search pattern in history
966#define SEARCH_END 0x40 // put cursor at end of match
967#define SEARCH_NOOF 0x80 // don't add offset to position
968#define SEARCH_START 0x100 // start search without col offset
969#define SEARCH_MARK 0x200 // set previous context mark
970#define SEARCH_KEEP 0x400 // keep previous search pattern
971#define SEARCH_PEEK 0x800 // peek for typed char, cancel search
972#define SEARCH_COL 0x1000 // start at specified column instead of zero
Bram Moolenaar071d4272004-06-13 20:20:40 +0000973
Bram Moolenaar17627312019-06-02 19:53:44 +0200974// Values for find_ident_under_cursor()
975#define FIND_IDENT 1 // find identifier (word)
976#define FIND_STRING 2 // find any string (WORD)
977#define FIND_EVAL 4 // include "->", "[]" and "."
978#define FIND_NOERROR 8 // no error when no word found
Bram Moolenaar071d4272004-06-13 20:20:40 +0000979
Bram Moolenaarc3308352019-09-01 16:24:56 +0200980// Values for file_name_in_line()
981#define FNAME_MESS 1 // give error message
982#define FNAME_EXP 2 // expand to path
983#define FNAME_HYP 4 // check for hypertext link
984#define FNAME_INCL 8 // apply 'includeexpr'
985#define FNAME_REL 16 // ".." and "./" are relative to the (current)
986 // file instead of the current directory
987#define FNAME_UNESC 32 // remove backslashes used for escaping
Bram Moolenaar071d4272004-06-13 20:20:40 +0000988
Bram Moolenaarc3308352019-09-01 16:24:56 +0200989// Values for buflist_getfile()
990#define GETF_SETMARK 0x01 // set pcmark before jumping
991#define GETF_ALT 0x02 // jumping to alternate file (not buf num)
992#define GETF_SWITCH 0x04 // respect 'switchbuf' settings when jumping
Bram Moolenaar071d4272004-06-13 20:20:40 +0000993
Bram Moolenaarc3308352019-09-01 16:24:56 +0200994// Return values of getfile()
995#define GETFILE_ERROR 1 // normal error
996#define GETFILE_NOT_WRITTEN 2 // "not written" error
997#define GETFILE_SAME_FILE 0 // success, same file
kylo2529dac9b12022-03-27 20:05:17 +0100998#define GETFILE_OPEN_OTHER (-1) // success, opened another file
Bram Moolenaar8ad80de2017-06-05 16:01:59 +0200999#define GETFILE_UNUSED 8
1000#define GETFILE_SUCCESS(x) ((x) <= 0)
1001
Bram Moolenaar00b0d6d2019-08-21 22:25:30 +02001002// Values for buflist_new() flags
1003#define BLN_CURBUF 1 // may re-use curbuf for new buffer
1004#define BLN_LISTED 2 // put new buffer in buffer list
1005#define BLN_DUMMY 4 // allocating dummy buffer
1006#define BLN_NEW 8 // create a new buffer
1007#define BLN_NOOPT 16 // don't copy options to existing buffer
1008#define BLN_DUMMY_OK 32 // also find an existing dummy buffer
1009#define BLN_REUSE 64 // may re-use number from buf_reuse
Bram Moolenaar89b693e2020-10-25 17:09:50 +01001010#define BLN_NOCURWIN 128 // buffer is not associated with curwin
Bram Moolenaar071d4272004-06-13 20:20:40 +00001011
Bram Moolenaarc3308352019-09-01 16:24:56 +02001012// Values for in_cinkeys()
Bram Moolenaar071d4272004-06-13 20:20:40 +00001013#define KEY_OPEN_FORW 0x101
1014#define KEY_OPEN_BACK 0x102
Bram Moolenaarc3308352019-09-01 16:24:56 +02001015#define KEY_COMPLETE 0x103 // end of completion
Bram Moolenaar071d4272004-06-13 20:20:40 +00001016
zeertzjq44068e92022-06-16 11:14:55 +01001017// Used for the first argument of do_map()
zeertzjqfdf135a2024-10-24 21:43:43 +02001018#define MAPTYPE_MAP 0
1019#define MAPTYPE_UNMAP 1
1020#define MAPTYPE_NOREMAP 2
1021#define MAPTYPE_UNMAP_LHS 3
zeertzjq44068e92022-06-16 11:14:55 +01001022
Bram Moolenaarc3308352019-09-01 16:24:56 +02001023// Values for "noremap" argument of ins_typebuf(). Also used for
1024// map->m_noremap and menu->noremap[].
1025#define REMAP_YES 0 // allow remapping
kylo2529dac9b12022-03-27 20:05:17 +01001026#define REMAP_NONE (-1) // no remapping
1027#define REMAP_SCRIPT (-2) // remap script-local mappings only
1028#define REMAP_SKIP (-3) // no remapping for first char
Bram Moolenaar071d4272004-06-13 20:20:40 +00001029
Bram Moolenaarc3308352019-09-01 16:24:56 +02001030// Values for mch_call_shell() second argument
1031#define SHELL_FILTER 1 // filtering text
1032#define SHELL_EXPAND 2 // expanding wildcards
1033#define SHELL_COOKED 4 // set term to cooked mode
1034#define SHELL_DOOUT 8 // redirecting output
1035#define SHELL_SILENT 16 // don't print error returned by command
1036#define SHELL_READ 32 // read lines and insert into buffer
1037#define SHELL_WRITE 64 // write lines from buffer
Bram Moolenaar071d4272004-06-13 20:20:40 +00001038
Bram Moolenaarc3308352019-09-01 16:24:56 +02001039// Values returned by mch_nodetype()
1040#define NODE_NORMAL 0 // file or directory, check with mch_isdir()
1041#define NODE_WRITABLE 1 // something we can write to (character
1042 // device, fifo, socket, ..)
1043#define NODE_OTHER 2 // non-writable thing (e.g., block device)
Bram Moolenaar071d4272004-06-13 20:20:40 +00001044
Bram Moolenaarc3308352019-09-01 16:24:56 +02001045// Values for readfile() flags
1046#define READ_NEW 0x01 // read a file into a new buffer
1047#define READ_FILTER 0x02 // read filter output
1048#define READ_STDIN 0x04 // read from stdin
1049#define READ_BUFFER 0x08 // read from curbuf (converting stdin)
1050#define READ_DUMMY 0x10 // reading into a dummy buffer
1051#define READ_KEEP_UNDO 0x20 // keep undo info
1052#define READ_FIFO 0x40 // read from fifo or socket
Bram Moolenaar1d30fde2021-10-20 21:58:42 +01001053#define READ_NOWINENTER 0x80 // do not trigger BufWinEnter
Bram Moolenaarb1d2c812022-08-26 11:55:01 +01001054#define READ_NOFILE 0x100 // do not read a file, do trigger BufReadCmd
Bram Moolenaar071d4272004-06-13 20:20:40 +00001055
Bram Moolenaarc3308352019-09-01 16:24:56 +02001056// Values for change_indent()
1057#define INDENT_SET 1 // set indent
1058#define INDENT_INC 2 // increase indent
1059#define INDENT_DEC 3 // decrease indent
Bram Moolenaar071d4272004-06-13 20:20:40 +00001060
Bram Moolenaarc3308352019-09-01 16:24:56 +02001061// Values for flags argument for findmatchlimit()
1062#define FM_BACKWARD 0x01 // search backwards
1063#define FM_FORWARD 0x02 // search forwards
1064#define FM_BLOCKSTOP 0x04 // stop at start/end of block
1065#define FM_SKIPCOMM 0x08 // skip comments
Bram Moolenaar071d4272004-06-13 20:20:40 +00001066
Bram Moolenaar00b0d6d2019-08-21 22:25:30 +02001067// Values for action argument for do_buffer() and close_buffer()
1068#define DOBUF_GOTO 0 // go to specified buffer
1069#define DOBUF_SPLIT 1 // split window and go to specified buffer
1070#define DOBUF_UNLOAD 2 // unload specified buffer(s)
1071#define DOBUF_DEL 3 // delete specified buffer(s) from buflist
1072#define DOBUF_WIPE 4 // delete specified buffer(s) really
Dominique Pelleaf4a61a2021-12-27 17:21:41 +00001073#define DOBUF_WIPE_REUSE 5 // like DOBUF_WIPE and keep number for reuse
Bram Moolenaar071d4272004-06-13 20:20:40 +00001074
Bram Moolenaarc3308352019-09-01 16:24:56 +02001075// Values for start argument for do_buffer()
1076#define DOBUF_CURRENT 0 // "count" buffer from current buffer
1077#define DOBUF_FIRST 1 // "count" buffer from first buffer
1078#define DOBUF_LAST 2 // "count" buffer from last buffer
1079#define DOBUF_MOD 3 // "count" mod. buffer from current buffer
Bram Moolenaar071d4272004-06-13 20:20:40 +00001080
Bram Moolenaar7b4f76c2021-06-10 21:07:48 +02001081// Values for flags argument of do_buffer()
1082#define DOBUF_FORCEIT 1 // :cmd!
1083#define DOBUF_NOPOPUP 2 // skip popup window buffers
LemonBoy893eeeb2024-07-10 20:20:48 +02001084#define DOBUF_SKIPHELP 4 // skip or keep help buffers depending on b_help of the
1085 // starting buffer
Bram Moolenaar7b4f76c2021-06-10 21:07:48 +02001086
Bram Moolenaarc3308352019-09-01 16:24:56 +02001087// Values for sub_cmd and which_pat argument for search_regcomp()
1088// Also used for which_pat argument for searchit()
1089#define RE_SEARCH 0 // save/use pat in/from search_pattern
1090#define RE_SUBST 1 // save/use pat in/from subst_pattern
1091#define RE_BOTH 2 // save pat in both patterns
1092#define RE_LAST 2 // use last used pattern if "pat" is NULL
Bram Moolenaar071d4272004-06-13 20:20:40 +00001093
Bram Moolenaarc3308352019-09-01 16:24:56 +02001094// Second argument for vim_regcomp().
1095#define RE_MAGIC 1 // 'magic' option
1096#define RE_STRING 2 // match in string instead of buffer text
1097#define RE_STRICT 4 // don't allow [abc] without ]
1098#define RE_AUTO 8 // automatic engine selection
Bram Moolenaar071d4272004-06-13 20:20:40 +00001099
1100#ifdef FEAT_SYN_HL
Bram Moolenaarc3308352019-09-01 16:24:56 +02001101// values for reg_do_extmatch
1102# define REX_SET 1 // to allow \z\(...\),
1103# define REX_USE 2 // to allow \z\1 et al.
Bram Moolenaarbcf94422018-06-23 14:21:42 +02001104# define REX_ALL (REX_SET | REX_USE)
Bram Moolenaar071d4272004-06-13 20:20:40 +00001105#endif
1106
Bram Moolenaarc3308352019-09-01 16:24:56 +02001107// Return values for fullpathcmp()
1108// Note: can use (fullpathcmp() & FPC_SAME) to check for equal files
1109#define FPC_SAME 1 // both exist and are the same file.
1110#define FPC_DIFF 2 // both exist and are different files.
1111#define FPC_NOTX 4 // both don't exist.
1112#define FPC_DIFFX 6 // one of them doesn't exist.
1113#define FPC_SAMEX 7 // both don't exist and file names are same.
Bram Moolenaar071d4272004-06-13 20:20:40 +00001114
Bram Moolenaarc3308352019-09-01 16:24:56 +02001115// flags for do_ecmd()
1116#define ECMD_HIDE 0x01 // don't free the current buffer
1117#define ECMD_SET_HELP 0x02 // set b_help flag of (new) buffer before
1118 // opening file
1119#define ECMD_OLDBUF 0x04 // use existing buffer if it exists
1120#define ECMD_FORCEIT 0x08 // ! used in Ex command
1121#define ECMD_ADDBUF 0x10 // don't edit, just add to buffer list
Bram Moolenaar59d8e562020-11-07 18:41:10 +01001122#define ECMD_ALTBUF 0x20 // like ECMD_ADDBUF and set the alternate file
Bram Moolenaar1d30fde2021-10-20 21:58:42 +01001123#define ECMD_NOWINENTER 0x40 // do not trigger BufWinEnter
Bram Moolenaar071d4272004-06-13 20:20:40 +00001124
Bram Moolenaarc3308352019-09-01 16:24:56 +02001125// for lnum argument in do_ecmd()
1126#define ECMD_LASTL (linenr_T)0 // use last position in loaded file
kylo2529dac9b12022-03-27 20:05:17 +01001127#define ECMD_LAST ((linenr_T)-1) // use last position in all files
Bram Moolenaarc3308352019-09-01 16:24:56 +02001128#define ECMD_ONE (linenr_T)1 // use first line
Bram Moolenaar071d4272004-06-13 20:20:40 +00001129
Bram Moolenaarc3308352019-09-01 16:24:56 +02001130// flags for do_cmdline()
1131#define DOCMD_VERBOSE 0x01 // included command in error message
1132#define DOCMD_NOWAIT 0x02 // don't call wait_return() and friends
1133#define DOCMD_REPEAT 0x04 // repeat exec. until getline() returns NULL
1134#define DOCMD_KEYTYPED 0x08 // don't reset KeyTyped
1135#define DOCMD_EXCRESET 0x10 // reset exception environment (for debugging)
1136#define DOCMD_KEEPLINE 0x20 // keep typed line for repeating with "."
Bram Moolenaardc987762022-01-16 15:52:35 +00001137#define DOCMD_RANGEOK 0x40 // can use a range without ":" in Vim9 script
Bram Moolenaar071d4272004-06-13 20:20:40 +00001138
Bram Moolenaarc3308352019-09-01 16:24:56 +02001139// flags for beginline()
1140#define BL_WHITE 1 // cursor on first non-white in the line
1141#define BL_SOL 2 // use 'sol' option
1142#define BL_FIX 4 // don't leave cursor on a NUL
Bram Moolenaar071d4272004-06-13 20:20:40 +00001143
Bram Moolenaarc3308352019-09-01 16:24:56 +02001144// flags for mf_sync()
1145#define MFS_ALL 1 // also sync blocks with negative numbers
1146#define MFS_STOP 2 // stop syncing when a character is available
1147#define MFS_FLUSH 4 // flushed file to disk
1148#define MFS_ZERO 8 // only write block 0
Bram Moolenaar071d4272004-06-13 20:20:40 +00001149
Bram Moolenaarc3308352019-09-01 16:24:56 +02001150// flags for buf_copy_options()
1151#define BCO_ENTER 1 // going to enter the buffer
1152#define BCO_ALWAYS 2 // always copy the options
1153#define BCO_NOHELP 4 // don't touch the help related options
Bram Moolenaar071d4272004-06-13 20:20:40 +00001154
Bram Moolenaarc3308352019-09-01 16:24:56 +02001155// flags for do_put()
1156#define PUT_FIXINDENT 1 // make indent look nice
1157#define PUT_CURSEND 2 // leave cursor after end of new text
1158#define PUT_CURSLINE 4 // leave cursor on last line of new text
1159#define PUT_LINE 8 // put register as lines
1160#define PUT_LINE_SPLIT 16 // split line for linewise register
1161#define PUT_LINE_FORWARD 32 // put linewise register below Visual sel.
Christian Brabandt2fa93842021-05-30 22:17:25 +02001162#define PUT_BLOCK_INNER 64 // in block mode, do not add trailing spaces
Bram Moolenaar071d4272004-06-13 20:20:40 +00001163
Bram Moolenaarc3308352019-09-01 16:24:56 +02001164// flags for set_indent()
1165#define SIN_CHANGED 1 // call changed_bytes() when line changed
1166#define SIN_INSERT 2 // insert indent before existing text
1167#define SIN_UNDO 4 // save line for undo before changing it
Bram Moolenaar071d4272004-06-13 20:20:40 +00001168
Bram Moolenaarc3308352019-09-01 16:24:56 +02001169// flags for insertchar()
1170#define INSCHAR_FORMAT 1 // force formatting
1171#define INSCHAR_DO_COM 2 // format comments
1172#define INSCHAR_CTRLV 4 // char typed just after CTRL-V
1173#define INSCHAR_NO_FEX 8 // don't use 'formatexpr'
1174#define INSCHAR_COM_LIST 16 // format comments with list/2nd line indent
Bram Moolenaar071d4272004-06-13 20:20:40 +00001175
Bram Moolenaarc3308352019-09-01 16:24:56 +02001176// flags for open_line()
Bram Moolenaar7e667782022-05-23 13:10:48 +01001177#define OPENLINE_DELSPACES 0x01 // delete spaces after cursor
1178#define OPENLINE_DO_COM 0x02 // format comments
1179#define OPENLINE_KEEPTRAIL 0x04 // keep trailing spaces
1180#define OPENLINE_MARKFIX 0x08 // fix mark positions
1181#define OPENLINE_COM_LIST 0x10 // format comments with list/2nd line indent
1182#define OPENLINE_FORMAT 0x20 // formatting long comment
Bram Moolenaar071d4272004-06-13 20:20:40 +00001183
Bram Moolenaarc3308352019-09-01 16:24:56 +02001184// There are five history tables:
1185#define HIST_CMD 0 // colon commands
1186#define HIST_SEARCH 1 // search commands
1187#define HIST_EXPR 2 // expressions (from entering = register)
1188#define HIST_INPUT 3 // input() lines
1189#define HIST_DEBUG 4 // debug commands
1190#define HIST_COUNT 5 // number of history tables
Bram Moolenaar071d4272004-06-13 20:20:40 +00001191
Bram Moolenaarc3308352019-09-01 16:24:56 +02001192// The type numbers are fixed for backwards compatibility.
Bram Moolenaarc60954b2016-06-06 21:20:10 +02001193#define BARTYPE_VERSION 1
1194#define BARTYPE_HISTORY 2
Bram Moolenaar46bbb0c2016-06-11 21:04:39 +02001195#define BARTYPE_REGISTER 3
Bram Moolenaar2d358992016-06-12 21:20:54 +02001196#define BARTYPE_MARK 4
Bram Moolenaarc60954b2016-06-06 21:20:10 +02001197
Bram Moolenaar2d358992016-06-12 21:20:54 +02001198#define VIMINFO_VERSION 4
Bram Moolenaar1fd99c12016-06-09 20:24:28 +02001199#define VIMINFO_VERSION_WITH_HISTORY 2
Bram Moolenaar46bbb0c2016-06-11 21:04:39 +02001200#define VIMINFO_VERSION_WITH_REGISTERS 3
Bram Moolenaar2d358992016-06-12 21:20:54 +02001201#define VIMINFO_VERSION_WITH_MARKS 4
Bram Moolenaar1fd99c12016-06-09 20:24:28 +02001202
Bram Moolenaar071d4272004-06-13 20:20:40 +00001203/*
Bram Moolenaar071d4272004-06-13 20:20:40 +00001204 * Values for do_tag().
1205 */
Bram Moolenaarc3308352019-09-01 16:24:56 +02001206#define DT_TAG 1 // jump to newer position or same tag again
1207#define DT_POP 2 // jump to older position
1208#define DT_NEXT 3 // jump to next match of same tag
1209#define DT_PREV 4 // jump to previous match of same tag
1210#define DT_FIRST 5 // jump to first match of same tag
1211#define DT_LAST 6 // jump to first match of same tag
1212#define DT_SELECT 7 // jump to selection from list
1213#define DT_HELP 8 // like DT_TAG, but no wildcards
1214#define DT_JUMP 9 // jump to new tag or selection from list
1215#define DT_CSCOPE 10 // cscope find command (like tjump)
1216#define DT_LTAG 11 // tag using location list
1217#define DT_FREE 99 // free cached matches
Bram Moolenaar071d4272004-06-13 20:20:40 +00001218
1219/*
1220 * flags for find_tags().
1221 */
Bram Moolenaar45e18cb2019-04-28 18:05:35 +02001222#define TAG_HELP 1 // only search for help tags
1223#define TAG_NAMES 2 // only return name of tag
1224#define TAG_REGEXP 4 // use tag pattern as regexp
1225#define TAG_NOIC 8 // don't always ignore case
Bram Moolenaar071d4272004-06-13 20:20:40 +00001226#ifdef FEAT_CSCOPE
Bram Moolenaar45e18cb2019-04-28 18:05:35 +02001227# define TAG_CSCOPE 16 // cscope tag
Bram Moolenaar071d4272004-06-13 20:20:40 +00001228#endif
Bram Moolenaar45e18cb2019-04-28 18:05:35 +02001229#define TAG_VERBOSE 32 // message verbosity
1230#define TAG_INS_COMP 64 // Currently doing insert completion
1231#define TAG_KEEP_LANG 128 // keep current language
1232#define TAG_NO_TAGFUNC 256 // do not use 'tagfunc'
Bram Moolenaar071d4272004-06-13 20:20:40 +00001233
Bram Moolenaar45e18cb2019-04-28 18:05:35 +02001234#define TAG_MANY 300 // When finding many tags (for completion),
1235 // find up to this many tags
Bram Moolenaar071d4272004-06-13 20:20:40 +00001236
1237/*
1238 * Types of dialogs passed to do_vim_dialog().
1239 */
1240#define VIM_GENERIC 0
1241#define VIM_ERROR 1
1242#define VIM_WARNING 2
1243#define VIM_INFO 3
1244#define VIM_QUESTION 4
Bram Moolenaarc3308352019-09-01 16:24:56 +02001245#define VIM_LAST_TYPE 4 // sentinel value
Bram Moolenaar071d4272004-06-13 20:20:40 +00001246
1247/*
1248 * Return values for functions like gui_yesnocancel()
1249 */
Bram Moolenaar071d4272004-06-13 20:20:40 +00001250#define VIM_YES 2
1251#define VIM_NO 3
1252#define VIM_CANCEL 4
1253#define VIM_ALL 5
1254#define VIM_DISCARDALL 6
1255
1256/*
1257 * arguments for win_split()
1258 */
Bram Moolenaar21c3a802022-08-31 17:49:14 +01001259#define WSP_ROOM 0x01 // require enough room
1260#define WSP_VERT 0x02 // split/equalize vertically
1261#define WSP_HOR 0x04 // equalize horizontally
1262#define WSP_TOP 0x08 // window at top-left of shell
1263#define WSP_BOT 0x10 // window at bottom-right of shell
1264#define WSP_HELP 0x20 // creating the help window
1265#define WSP_BELOW 0x40 // put new window below/right
1266#define WSP_ABOVE 0x80 // put new window above/left
1267#define WSP_NEWLOC 0x100 // don't copy location list
Sean Dewar0fd44a52024-02-20 20:28:15 +01001268#define WSP_FORCE_ROOM 0x200 // ignore "not enough room" errors
Bram Moolenaar071d4272004-06-13 20:20:40 +00001269
1270/*
Bram Moolenaar2e2a2812006-03-27 20:55:21 +00001271 * arguments for gui_set_shellsize()
1272 */
Bram Moolenaarc3308352019-09-01 16:24:56 +02001273#define RESIZE_VERT 1 // resize vertically
1274#define RESIZE_HOR 2 // resize horizontally
1275#define RESIZE_BOTH 15 // resize in both directions
Bram Moolenaar2e2a2812006-03-27 20:55:21 +00001276
1277/*
Bram Moolenaar45d3b142013-11-09 03:31:51 +01001278 * flags for check_changed()
1279 */
Bram Moolenaarc3308352019-09-01 16:24:56 +02001280#define CCGD_AW 1 // do autowrite if buffer was changed
1281#define CCGD_MULTWIN 2 // check also when several wins for the buf
1282#define CCGD_FORCEIT 4 // ! used
1283#define CCGD_ALLBUF 8 // may write all buffers
1284#define CCGD_EXCMD 16 // may suggest using !
Bram Moolenaar45d3b142013-11-09 03:31:51 +01001285
1286/*
Bram Moolenaar071d4272004-06-13 20:20:40 +00001287 * "flags" values for option-setting functions.
1288 * When OPT_GLOBAL and OPT_LOCAL are both missing, set both local and global
1289 * values, get local value.
1290 */
Bram Moolenaar6b915c02020-01-18 15:53:19 +01001291#define OPT_FREE 0x01 // free old value if it was allocated
1292#define OPT_GLOBAL 0x02 // use global value
1293#define OPT_LOCAL 0x04 // use local value
1294#define OPT_MODELINE 0x08 // option in modeline
1295#define OPT_WINONLY 0x10 // only set window-local options
1296#define OPT_NOWIN 0x20 // don't set window-local options
1297#define OPT_ONECOLUMN 0x40 // list options one per line
Bram Moolenaar37294bd2021-03-10 13:40:08 +01001298#define OPT_NO_REDRAW 0x80 // ignore redraw flags on option
Bram Moolenaar635bd602021-04-16 19:58:22 +02001299#define OPT_SKIPRTP 0x100 // "skiprtp" in 'sessionoptions'
Bram Moolenaar071d4272004-06-13 20:20:40 +00001300
Bram Moolenaarc3308352019-09-01 16:24:56 +02001301// Magic chars used in confirm dialog strings
Bram Moolenaar071d4272004-06-13 20:20:40 +00001302#define DLG_BUTTON_SEP '\n'
1303#define DLG_HOTKEY_CHAR '&'
1304
Bram Moolenaarc3308352019-09-01 16:24:56 +02001305// Values for "starting"
1306#define NO_SCREEN 2 // no screen updating yet
1307#define NO_BUFFERS 1 // not all buffers loaded yet
1308// 0 not starting anymore
Bram Moolenaar071d4272004-06-13 20:20:40 +00001309
Bram Moolenaarc3308352019-09-01 16:24:56 +02001310// Values for swap_exists_action: what to do when swap file already exists
1311#define SEA_NONE 0 // don't use dialog
1312#define SEA_DIALOG 1 // use dialog when possible
1313#define SEA_QUIT 2 // quit editing the file
1314#define SEA_RECOVER 3 // recover the file
Bram Moolenaar188639d2022-04-04 16:57:21 +01001315#define SEA_READONLY 4 // no dialog, mark buffer as read-only
Bram Moolenaar071d4272004-06-13 20:20:40 +00001316
1317/*
1318 * Minimal size for block 0 of a swap file.
1319 * NOTE: This depends on size of struct block0! It's not done with a sizeof(),
1320 * because struct block0 is defined in memline.c (Sorry).
1321 * The maximal block size is arbitrary.
1322 */
1323#define MIN_SWAP_PAGE_SIZE 1048
1324#define MAX_SWAP_PAGE_SIZE 50000
1325
Bram Moolenaarc3308352019-09-01 16:24:56 +02001326// Special values for current_sctx.sc_sid.
kylo2529dac9b12022-03-27 20:05:17 +01001327#define SID_MODELINE (-1) // when using a modeline
1328#define SID_CMDARG (-2) // for "--cmd" argument
1329#define SID_CARG (-3) // for "-c" argument
1330#define SID_ENV (-4) // for sourcing environment variable
1331#define SID_ERROR (-5) // option was reset because of an error
1332#define SID_NONE (-6) // don't set scriptID
1333#define SID_WINLAYOUT (-7) // changing window size
Bram Moolenaar071d4272004-06-13 20:20:40 +00001334
1335/*
1336 * Events for autocommands.
1337 */
1338enum auto_event
1339{
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001340 EVENT_BUFADD = 0, // after adding a buffer to the buffer list
1341 EVENT_BUFDELETE, // deleting a buffer from the buffer list
1342 EVENT_BUFENTER, // after entering a buffer
1343 EVENT_BUFFILEPOST, // after renaming a buffer
1344 EVENT_BUFFILEPRE, // before renaming a buffer
1345 EVENT_BUFHIDDEN, // just after buffer becomes hidden
1346 EVENT_BUFLEAVE, // before leaving a buffer
1347 EVENT_BUFNEW, // after creating any buffer
1348 EVENT_BUFNEWFILE, // when creating a buffer for a new file
1349 EVENT_BUFREADCMD, // read buffer using command
1350 EVENT_BUFREADPOST, // after reading a buffer
1351 EVENT_BUFREADPRE, // before reading a buffer
1352 EVENT_BUFUNLOAD, // just before unloading a buffer
1353 EVENT_BUFWINENTER, // after showing a buffer in a window
1354 EVENT_BUFWINLEAVE, // just after buffer removed from window
1355 EVENT_BUFWIPEOUT, // just before really deleting a buffer
1356 EVENT_BUFWRITECMD, // write buffer using command
1357 EVENT_BUFWRITEPOST, // after writing a buffer
1358 EVENT_BUFWRITEPRE, // before writing a buffer
Bram Moolenaarc4568ab2018-11-16 16:21:05 +01001359 EVENT_CMDLINECHANGED, // command line was modified
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001360 EVENT_CMDLINEENTER, // after entering the command line
1361 EVENT_CMDLINELEAVE, // before leaving the command line
1362 EVENT_CMDUNDEFINED, // command undefined
1363 EVENT_CMDWINENTER, // after entering the cmdline window
1364 EVENT_CMDWINLEAVE, // before leaving the cmdline window
1365 EVENT_COLORSCHEME, // after loading a colorscheme
1366 EVENT_COLORSCHEMEPRE, // before loading a colorscheme
Bram Moolenaard7f246c2019-04-08 18:15:41 +02001367 EVENT_COMPLETECHANGED, // after completion popup menu changed
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001368 EVENT_COMPLETEDONE, // after finishing insert complete
Bram Moolenaar3f169ce2020-01-26 22:43:31 +01001369 EVENT_COMPLETEDONEPRE, // idem, before clearing info
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001370 EVENT_CURSORHOLD, // cursor in same position for a while
1371 EVENT_CURSORHOLDI, // idem, in Insert mode
1372 EVENT_CURSORMOVED, // cursor was moved
Shougo Matsushitad0952142024-06-20 22:05:16 +02001373 EVENT_CURSORMOVEDC, // cursor was moved in Command line mode
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001374 EVENT_CURSORMOVEDI, // cursor was moved in Insert mode
1375 EVENT_DIFFUPDATED, // after diffs were updated
1376 EVENT_DIRCHANGED, // after user changed directory
Bram Moolenaar28e8f732022-02-09 12:58:20 +00001377 EVENT_DIRCHANGEDPRE, // before directory changes
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001378 EVENT_ENCODINGCHANGED, // after changing the 'encoding' option
1379 EVENT_EXITPRE, // before exiting
1380 EVENT_FILEAPPENDCMD, // append to a file using command
1381 EVENT_FILEAPPENDPOST, // after appending to a file
1382 EVENT_FILEAPPENDPRE, // before appending to a file
1383 EVENT_FILECHANGEDRO, // before first change to read-only file
1384 EVENT_FILECHANGEDSHELL, // after shell command that changed file
1385 EVENT_FILECHANGEDSHELLPOST, // after (not) reloading changed file
1386 EVENT_FILEREADCMD, // read from a file using command
1387 EVENT_FILEREADPOST, // after reading a file
1388 EVENT_FILEREADPRE, // before reading a file
1389 EVENT_FILETYPE, // new file type detected (user defined)
1390 EVENT_FILEWRITECMD, // write to a file using command
1391 EVENT_FILEWRITEPOST, // after writing a file
1392 EVENT_FILEWRITEPRE, // before writing a file
1393 EVENT_FILTERREADPOST, // after reading from a filter
1394 EVENT_FILTERREADPRE, // before reading from a filter
1395 EVENT_FILTERWRITEPOST, // after writing to a filter
1396 EVENT_FILTERWRITEPRE, // before writing to a filter
1397 EVENT_FOCUSGAINED, // got the focus
1398 EVENT_FOCUSLOST, // lost the focus to another app
1399 EVENT_FUNCUNDEFINED, // if calling a function which doesn't exist
1400 EVENT_GUIENTER, // after starting the GUI
1401 EVENT_GUIFAILED, // after starting the GUI failed
1402 EVENT_INSERTCHANGE, // when changing Insert/Replace mode
1403 EVENT_INSERTCHARPRE, // before inserting a char
1404 EVENT_INSERTENTER, // when entering Insert mode
Bram Moolenaarb53e13a2020-10-21 12:19:53 +02001405 EVENT_INSERTLEAVEPRE, // just before leaving Insert mode
1406 EVENT_INSERTLEAVE, // just after leaving Insert mode
Shougo Matsushita83678842024-07-11 22:05:12 +02001407 EVENT_KEYINPUTPRE, // before key input
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001408 EVENT_MENUPOPUP, // just before popup menu is displayed
=?UTF-8?q?Magnus=20Gro=C3=9F?=f1e88762021-09-12 13:39:55 +02001409 EVENT_MODECHANGED, // after changing the mode
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001410 EVENT_OPTIONSET, // option was set
1411 EVENT_QUICKFIXCMDPOST, // after :make, :grep etc.
1412 EVENT_QUICKFIXCMDPRE, // before :make, :grep etc.
1413 EVENT_QUITPRE, // before :quit
1414 EVENT_REMOTEREPLY, // upon string reception from a remote vim
Bram Moolenaar8aeec402019-09-15 23:02:04 +02001415 EVENT_SAFESTATE, // going to wait for a character
Bram Moolenaar69198cb2019-09-16 21:58:13 +02001416 EVENT_SAFESTATEAGAIN, // still waiting for a character
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001417 EVENT_SESSIONLOADPOST, // after loading a session file
Colin Kennedye5f22802024-03-26 18:20:16 +01001418 EVENT_SESSIONWRITEPOST, // after writing a session file
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001419 EVENT_SHELLCMDPOST, // after ":!cmd"
1420 EVENT_SHELLFILTERPOST, // after ":1,2!cmd", ":w !cmd", ":r !cmd".
Bram Moolenaarbe5ee862020-06-10 20:56:58 +02001421 EVENT_SIGUSR1, // after the SIGUSR1 signal
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001422 EVENT_SOURCECMD, // sourcing a Vim script using command
1423 EVENT_SOURCEPRE, // before sourcing a Vim script
Bram Moolenaar2b618522019-01-12 13:26:03 +01001424 EVENT_SOURCEPOST, // after sourcing a Vim script
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001425 EVENT_SPELLFILEMISSING, // spell file missing
1426 EVENT_STDINREADPOST, // after reading from stdin
1427 EVENT_STDINREADPRE, // before reading from stdin
1428 EVENT_SWAPEXISTS, // found existing swap file
1429 EVENT_SYNTAX, // syntax selected
1430 EVENT_TABCLOSED, // after closing a tab page
1431 EVENT_TABENTER, // after entering a tab page
1432 EVENT_TABLEAVE, // before leaving a tab page
1433 EVENT_TABNEW, // when entering a new tab page
1434 EVENT_TERMCHANGED, // after changing 'term'
1435 EVENT_TERMINALOPEN, // after a terminal buffer was created
Bram Moolenaarb53e13a2020-10-21 12:19:53 +02001436 EVENT_TERMINALWINOPEN, // after a terminal buffer was created and
1437 // entering its window
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001438 EVENT_TERMRESPONSE, // after setting "v:termresponse"
Danek Duvalld7d56032024-01-14 20:19:59 +01001439 EVENT_TERMRESPONSEALL, // after setting terminal response vars
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001440 EVENT_TEXTCHANGED, // text was modified not in Insert mode
Bram Moolenaar6ed545e2022-05-09 20:09:23 +01001441 EVENT_TEXTCHANGEDI, // text was modified in Insert mode
1442 EVENT_TEXTCHANGEDP, // TextChangedI with popup menu visible
Shougo Matsushita4ccaedf2022-10-15 11:48:00 +01001443 EVENT_TEXTCHANGEDT, // text was modified in Terminal mode
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001444 EVENT_TEXTYANKPOST, // after some text was yanked
1445 EVENT_USER, // user defined autocommand
1446 EVENT_VIMENTER, // after starting Vim
1447 EVENT_VIMLEAVE, // before exiting Vim
1448 EVENT_VIMLEAVEPRE, // before exiting Vim and writing .viminfo
1449 EVENT_VIMRESIZED, // after Vim window was resized
1450 EVENT_WINENTER, // after entering a window
1451 EVENT_WINLEAVE, // before leaving a window
Sergey Vlasov1f47db72024-01-25 23:07:00 +01001452 EVENT_WINNEWPRE, // before creating a new window
1453 EVENT_WINNEW, // after creating a new window
naohiro ono23beefe2021-11-13 12:38:49 +00001454 EVENT_WINCLOSED, // after closing a window
Bram Moolenaar100118c2020-12-11 19:30:34 +01001455 EVENT_VIMSUSPEND, // before Vim is suspended
1456 EVENT_VIMRESUME, // after Vim is resumed
Bram Moolenaar35fc61c2022-11-22 12:40:50 +00001457 EVENT_WINRESIZED, // after a window was resized
1458 EVENT_WINSCROLLED, // after a window was scrolled or resized
Bram Moolenaare87303a2018-03-11 17:02:12 +01001459
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001460 NUM_EVENTS // MUST be the last one
Bram Moolenaar071d4272004-06-13 20:20:40 +00001461};
1462
Bram Moolenaarcf0c5542006-02-09 23:48:02 +00001463typedef enum auto_event event_T;
Bram Moolenaar071d4272004-06-13 20:20:40 +00001464
1465/*
1466 * Values for index in highlight_attr[].
Gianmaria Bajo6a7c7742023-03-10 16:35:53 +00001467 * When making changes, also update HL_FLAGS below!
1468 * And update the default value of 'highlight': HIGHLIGHT_INIT in optiondefs.h
Bram Moolenaar071d4272004-06-13 20:20:40 +00001469 */
Bram Moolenaar482aaeb2005-09-29 18:26:07 +00001470typedef enum
Bram Moolenaar071d4272004-06-13 20:20:40 +00001471{
Bram Moolenaarc3308352019-09-01 16:24:56 +02001472 HLF_8 = 0 // Meta & special keys listed with ":map", text that is
1473 // displayed different from what it is
1474 , HLF_EOB // after the last line in the buffer
1475 , HLF_AT // @ characters at end of screen, characters that
1476 // don't really exist in the text
1477 , HLF_D // directories in CTRL-D listing
1478 , HLF_E // error messages
1479 , HLF_H // obsolete, ignored
1480 , HLF_I // incremental search
1481 , HLF_L // last search string
LemonBoya4399382022-04-09 21:04:08 +01001482 , HLF_LC // last search string under cursor
Bram Moolenaarc3308352019-09-01 16:24:56 +02001483 , HLF_M // "--More--" message
1484 , HLF_CM // Mode (e.g., "-- INSERT --")
1485 , HLF_N // line number for ":number" and ":#" commands
Bram Moolenaarefae76a2019-10-27 22:54:58 +01001486 , HLF_LNA // LineNrAbove
1487 , HLF_LNB // LineNrBelow
Bram Moolenaarc3308352019-09-01 16:24:56 +02001488 , HLF_CLN // current line number
Bram Moolenaare413ea02021-11-24 16:20:13 +00001489 , HLF_CLS // current line sign column
1490 , HLF_CLF // current line fold
Bram Moolenaarc3308352019-09-01 16:24:56 +02001491 , HLF_R // return to continue message and yes/no questions
1492 , HLF_S // status lines
1493 , HLF_SNC // status lines of not-current windows
1494 , HLF_C // column to separate vertically split windows
1495 , HLF_T // Titles for output from ":set all", ":autocmd" etc.
1496 , HLF_V // Visual mode
1497 , HLF_VNC // Visual mode, autoselecting and not clipboard owner
1498 , HLF_W // warning messages
1499 , HLF_WM // Wildmenu highlight
1500 , HLF_FL // Folded line
1501 , HLF_FC // Fold column
1502 , HLF_ADD // Added diff line
1503 , HLF_CHD // Changed diff line
1504 , HLF_DED // Deleted diff line
1505 , HLF_TXD // Text Changed in diff line
1506 , HLF_CONCEAL // Concealed text
1507 , HLF_SC // Sign column
1508 , HLF_SPB // SpellBad
1509 , HLF_SPC // SpellCap
1510 , HLF_SPR // SpellRare
1511 , HLF_SPL // SpellLocal
1512 , HLF_PNI // popup menu normal item
1513 , HLF_PSI // popup menu selected item
glepnir40c1c332024-06-11 19:37:04 +02001514 , HLF_PMNI // popup menu matched text in normal item
1515 , HLF_PMSI // popup menu matched text in selected item
Gianmaria Bajo6a7c7742023-03-10 16:35:53 +00001516 , HLF_PNK // popup menu normal item "kind"
1517 , HLF_PSK // popup menu selected item "kind"
1518 , HLF_PNX // popup menu normal item "menu" (extra text)
1519 , HLF_PSX // popup menu selected item "menu" (extra text)
Bram Moolenaarc3308352019-09-01 16:24:56 +02001520 , HLF_PSB // popup menu scrollbar
1521 , HLF_PST // popup menu scrollbar thumb
1522 , HLF_TP // tabpage line
1523 , HLF_TPS // tabpage line selected
1524 , HLF_TPF // tabpage line filler
1525 , HLF_CUC // 'cursorcolumn'
1526 , HLF_CUL // 'cursorline'
1527 , HLF_MC // 'colorcolumn'
1528 , HLF_QFL // quickfix window line currently selected
1529 , HLF_ST // status lines of terminal windows
1530 , HLF_STNC // status lines of not-current terminal windows
Shougo Matsushitabe2b03c2024-04-08 22:11:50 +02001531 , HLF_MSG // message area
Bram Moolenaarc3308352019-09-01 16:24:56 +02001532 , HLF_COUNT // MUST be the last one
Bram Moolenaar482aaeb2005-09-29 18:26:07 +00001533} hlf_T;
Bram Moolenaar071d4272004-06-13 20:20:40 +00001534
Bram Moolenaarc3308352019-09-01 16:24:56 +02001535// The HL_FLAGS must be in the same order as the HLF_ enums!
1536// When changing this also adjust the default for 'highlight'.
LemonBoya4399382022-04-09 21:04:08 +01001537#define HL_FLAGS {'8', '~', '@', 'd', 'e', 'h', 'i', 'l', 'y', 'm', 'M', \
Bram Moolenaare413ea02021-11-24 16:20:13 +00001538 'n', 'a', 'b', 'N', 'G', 'O', 'r', 's', 'S', 'c', 't', 'v', 'V', \
Bram Moolenaarefae76a2019-10-27 22:54:58 +01001539 'w', 'W', 'f', 'F', 'A', 'C', 'D', 'T', '-', '>', \
Bram Moolenaarbb15b652005-10-03 21:52:09 +00001540 'B', 'P', 'R', 'L', \
glepnir40c1c332024-06-11 19:37:04 +02001541 '+', '=', 'k', '<','[', ']', '{', '}', 'x', 'X', \
Gianmaria Bajo6a7c7742023-03-10 16:35:53 +00001542 '*', '#', '_', '!', '.', 'o', 'q', \
Shougo Matsushitabe2b03c2024-04-08 22:11:50 +02001543 'z', 'Z', 'g'}
Bram Moolenaar071d4272004-06-13 20:20:40 +00001544
1545/*
Christ van Willegen - van Noort8e4c4c72024-05-17 18:49:27 +02001546 * Values for behaviour in spell_move_to
1547 */
1548typedef enum
1549{
1550 SMT_ALL = 0 // Move to "all" words
1551 , SMT_BAD // Move to "bad" words only
1552 , SMT_RARE // Move to "rare" words only
1553} smt_T;
1554/*
Bram Moolenaar071d4272004-06-13 20:20:40 +00001555 * Boolean constants
1556 */
1557#ifndef TRUE
Bram Moolenaarc3308352019-09-01 16:24:56 +02001558# define FALSE 0 // note: this is an int, not a long!
Bram Moolenaar071d4272004-06-13 20:20:40 +00001559# define TRUE 1
1560#endif
1561
Bram Moolenaarc3308352019-09-01 16:24:56 +02001562#define MAYBE 2 // sometimes used for a variant on TRUE
Bram Moolenaar071d4272004-06-13 20:20:40 +00001563
Bram Moolenaar1d97db32022-06-04 22:15:54 +01001564#define LOG_ALWAYS 9 // must be different from TRUE and FALSE
1565
1566#ifdef FEAT_JOB_CHANNEL
1567// If "--log logfile" was used or ch_logfile() was called then log some or all
1568// terminal output.
1569# define MAY_WANT_TO_LOG_THIS if (ch_log_output == FALSE) ch_log_output = TRUE;
1570#else
1571// no logging support
1572# define MAY_WANT_TO_LOG_THIS
1573#endif
1574
Bram Moolenaar7db5fc82010-05-24 11:59:29 +02001575#ifndef UINT32_T
1576typedef UINT32_TYPEDEF UINT32_T;
1577#endif
1578
Bram Moolenaar071d4272004-06-13 20:20:40 +00001579/*
1580 * Operator IDs; The order must correspond to opchars[] in ops.c!
1581 */
Bram Moolenaarc3308352019-09-01 16:24:56 +02001582#define OP_NOP 0 // no pending operation
1583#define OP_DELETE 1 // "d" delete operator
1584#define OP_YANK 2 // "y" yank operator
1585#define OP_CHANGE 3 // "c" change operator
1586#define OP_LSHIFT 4 // "<" left shift operator
1587#define OP_RSHIFT 5 // ">" right shift operator
1588#define OP_FILTER 6 // "!" filter operator
1589#define OP_TILDE 7 // "g~" switch case operator
1590#define OP_INDENT 8 // "=" indent operator
1591#define OP_FORMAT 9 // "gq" format operator
1592#define OP_COLON 10 // ":" colon operator
1593#define OP_UPPER 11 // "gU" make upper case operator
1594#define OP_LOWER 12 // "gu" make lower case operator
1595#define OP_JOIN 13 // "J" join operator, only for Visual mode
1596#define OP_JOIN_NS 14 // "gJ" join operator, only for Visual mode
1597#define OP_ROT13 15 // "g?" rot-13 encoding
1598#define OP_REPLACE 16 // "r" replace chars, only for Visual mode
1599#define OP_INSERT 17 // "I" Insert column, only for Visual mode
1600#define OP_APPEND 18 // "A" Append column, only for Visual mode
1601#define OP_FOLD 19 // "zf" define a fold
1602#define OP_FOLDOPEN 20 // "zo" open folds
1603#define OP_FOLDOPENREC 21 // "zO" open folds recursively
1604#define OP_FOLDCLOSE 22 // "zc" close folds
1605#define OP_FOLDCLOSEREC 23 // "zC" close folds recursively
1606#define OP_FOLDDEL 24 // "zd" delete folds
1607#define OP_FOLDDELREC 25 // "zD" delete folds recursively
1608#define OP_FORMAT2 26 // "gw" format operator, keeps cursor pos
1609#define OP_FUNCTION 27 // "g@" call 'operatorfunc'
1610#define OP_NR_ADD 28 // "<C-A>" Add to the number or alphabetic
1611 // character (OP_ADD conflicts with Perl)
1612#define OP_NR_SUB 29 // "<C-X>" Subtract from the number or
1613 // alphabetic character
Bram Moolenaar071d4272004-06-13 20:20:40 +00001614
1615/*
1616 * Motion types, used for operators and for yank/delete registers.
1617 */
Bram Moolenaarc3308352019-09-01 16:24:56 +02001618#define MCHAR 0 // character-wise movement/register
1619#define MLINE 1 // line-wise movement/register
1620#define MBLOCK 2 // block-wise register
Bram Moolenaar071d4272004-06-13 20:20:40 +00001621
Bram Moolenaarc3308352019-09-01 16:24:56 +02001622#define MAUTO 0xff // Decide between MLINE/MCHAR
Bram Moolenaar071d4272004-06-13 20:20:40 +00001623
1624/*
1625 * Minimum screen size
1626 */
Bram Moolenaarc3308352019-09-01 16:24:56 +02001627#define MIN_COLUMNS 12 // minimal columns for screen
1628#define MIN_LINES 2 // minimal lines for screen
Milly2cddf0e2024-11-28 18:16:55 +01001629#define MIN_CMDHEIGHT 1 // minimal height for command line
Bram Moolenaarc3308352019-09-01 16:24:56 +02001630#define STATUS_HEIGHT 1 // height of a status line under a window
1631#ifdef FEAT_MENU // height of a status line under a window
Bram Moolenaar3167c3e2017-11-25 14:19:43 +01001632# define WINBAR_HEIGHT(wp) (wp)->w_winbar_height
Bram Moolenaar415a6932017-12-05 20:31:07 +01001633# define VISIBLE_HEIGHT(wp) ((wp)->w_height + (wp)->w_winbar_height)
Bram Moolenaar3167c3e2017-11-25 14:19:43 +01001634#else
1635# define WINBAR_HEIGHT(wp) 0
Bram Moolenaar415a6932017-12-05 20:31:07 +01001636# define VISIBLE_HEIGHT(wp) (wp)->w_height
Bram Moolenaar3167c3e2017-11-25 14:19:43 +01001637#endif
Bram Moolenaarc3308352019-09-01 16:24:56 +02001638#define QF_WINHEIGHT 10 // default height for quickfix window
Bram Moolenaar071d4272004-06-13 20:20:40 +00001639
1640/*
1641 * Buffer sizes
1642 */
1643#ifndef CMDBUFFSIZE
Bram Moolenaarc3308352019-09-01 16:24:56 +02001644# define CMDBUFFSIZE 256 // size of the command processing buffer
Bram Moolenaar071d4272004-06-13 20:20:40 +00001645#endif
1646
Bram Moolenaarc3308352019-09-01 16:24:56 +02001647#define LSIZE 512 // max. size of a line in the tags file
Bram Moolenaar071d4272004-06-13 20:20:40 +00001648
Bram Moolenaarc3308352019-09-01 16:24:56 +02001649#define IOSIZE (1024+1) // file i/o and sprintf buffer size
Bram Moolenaard9d30582005-05-18 22:10:28 +00001650
Bram Moolenaarc3308352019-09-01 16:24:56 +02001651#define DIALOG_MSG_SIZE 1000 // buffer size for dialog_msg()
Bram Moolenaard9462e32011-04-11 21:35:11 +02001652
Bram Moolenaarc3308352019-09-01 16:24:56 +02001653#define MSG_BUF_LEN 480 // length of buffer for small messages
1654#define MSG_BUF_CLEN (MSG_BUF_LEN / 6) // cell length (worst case: utf-8
1655 // takes 6 bytes for one cell)
Bram Moolenaar071d4272004-06-13 20:20:40 +00001656
Bram Moolenaarc3308352019-09-01 16:24:56 +02001657#define FOLD_TEXT_LEN 51 // buffer size for get_foldtext()
Bram Moolenaaree695f72016-08-03 22:08:45 +02001658
Bram Moolenaarc3308352019-09-01 16:24:56 +02001659// Size of the buffer used for tgetent(). Unfortunately this is largely
1660// undocumented, some systems use 1024. Using a buffer that is too small
1661// causes a buffer overrun and a crash. Use the maximum known value to stay
1662// on the safe side.
1663#define TBUFSZ 2048 // buffer size for termcap entry
Bram Moolenaar071d4272004-06-13 20:20:40 +00001664
1665/*
1666 * Maximum length of key sequence to be mapped.
1667 * Must be able to hold an Amiga resize report.
1668 */
1669#define MAXMAPLEN 50
1670
Bram Moolenaarc0ceeeb2022-03-30 21:12:27 +01001671// maximum length of a function name, including SID and NUL
1672#define MAX_FUNC_NAME_LEN 200
1673
Bram Moolenaarc3308352019-09-01 16:24:56 +02001674// Size in bytes of the hash used in the undo file.
Bram Moolenaar55debbe2010-05-23 23:34:36 +02001675#define UNDO_HASH_SIZE 32
1676
Bram Moolenaara7241f52008-06-24 20:39:31 +00001677#ifdef HAVE_FCNTL_H
1678# include <fcntl.h>
1679#endif
1680
Bram Moolenaar071d4272004-06-13 20:20:40 +00001681#ifdef BINARY_FILE_IO
Bram Moolenaarc3308352019-09-01 16:24:56 +02001682# define WRITEBIN "wb" // no CR-LF translation
Bram Moolenaar071d4272004-06-13 20:20:40 +00001683# define READBIN "rb"
1684# define APPENDBIN "ab"
1685#else
1686# define WRITEBIN "w"
1687# define READBIN "r"
1688# define APPENDBIN "a"
1689#endif
1690
1691/*
K.Takatab247e062022-02-07 10:45:23 +00001692 * Cygwin doesn't have a global way of making open() use binary I/O.
Bram Moolenaar071d4272004-06-13 20:20:40 +00001693 * Use O_BINARY for all open() calls.
1694 */
K.Takatab247e062022-02-07 10:45:23 +00001695#ifdef __CYGWIN__
Bram Moolenaar071d4272004-06-13 20:20:40 +00001696# define O_EXTRA O_BINARY
1697#else
1698# define O_EXTRA 0
1699#endif
1700
Bram Moolenaara5792f52005-11-23 21:25:05 +00001701#ifndef O_NOFOLLOW
1702# define O_NOFOLLOW 0
1703#endif
1704
Bram Moolenaar071d4272004-06-13 20:20:40 +00001705#ifndef W_OK
Bram Moolenaarc3308352019-09-01 16:24:56 +02001706# define W_OK 2 // for systems that don't have W_OK in unistd.h
Bram Moolenaar071d4272004-06-13 20:20:40 +00001707#endif
1708#ifndef R_OK
Bram Moolenaarc3308352019-09-01 16:24:56 +02001709# define R_OK 4 // for systems that don't have R_OK in unistd.h
Bram Moolenaar071d4272004-06-13 20:20:40 +00001710#endif
1711
Bram Moolenaarc799fe22019-05-28 23:08:19 +02001712// Allocate memory for one type and cast the returned pointer to have the
1713// compiler check the types.
1714#define ALLOC_ONE(type) (type *)alloc(sizeof(type))
Yegappan Lakshmanan5a2d4a32022-02-26 10:31:32 +00001715#define ALLOC_ONE_ID(type, id) (type *)alloc_id(sizeof(type), id)
Bram Moolenaarc799fe22019-05-28 23:08:19 +02001716#define ALLOC_MULT(type, count) (type *)alloc(sizeof(type) * (count))
1717#define ALLOC_CLEAR_ONE(type) (type *)alloc_clear(sizeof(type))
Yegappan Lakshmanan5a2d4a32022-02-26 10:31:32 +00001718#define ALLOC_CLEAR_ONE_ID(type, id) (type *)alloc_clear_id(sizeof(type), id)
Bram Moolenaarc799fe22019-05-28 23:08:19 +02001719#define ALLOC_CLEAR_MULT(type, count) (type *)alloc_clear(sizeof(type) * (count))
1720#define LALLOC_CLEAR_ONE(type) (type *)lalloc_clear(sizeof(type), FALSE)
1721#define LALLOC_CLEAR_MULT(type, count) (type *)lalloc_clear(sizeof(type) * (count), FALSE)
1722#define LALLOC_MULT(type, count) (type *)lalloc(sizeof(type) * (count), FALSE)
1723
Bram Moolenaara80faa82020-04-12 19:37:17 +02001724#ifdef HAVE_MEMSET
1725# define vim_memset(ptr, c, size) memset((ptr), (c), (size))
1726#else
1727void *vim_memset(void *, int, size_t);
1728#endif
1729#define CLEAR_FIELD(field) vim_memset(&(field), 0, sizeof(field))
1730#define CLEAR_POINTER(ptr) vim_memset((ptr), 0, sizeof(*(ptr)))
1731
Bram Moolenaar071d4272004-06-13 20:20:40 +00001732/*
1733 * defines to avoid typecasts from (char_u *) to (char *) and back
Bram Moolenaar944cc9c2022-06-27 22:17:37 +01001734 * (vim_strchr() and vim_strrchr() are now in strings.c)
Bram Moolenaar071d4272004-06-13 20:20:40 +00001735 */
1736#define STRLEN(s) strlen((char *)(s))
1737#define STRCPY(d, s) strcpy((char *)(d), (char *)(s))
1738#define STRNCPY(d, s, n) strncpy((char *)(d), (char *)(s), (size_t)(n))
1739#define STRCMP(d, s) strcmp((char *)(d), (char *)(s))
1740#define STRNCMP(d, s, n) strncmp((char *)(d), (char *)(s), (size_t)(n))
1741#ifdef HAVE_STRCASECMP
1742# define STRICMP(d, s) strcasecmp((char *)(d), (char *)(s))
1743#else
1744# ifdef HAVE_STRICMP
1745# define STRICMP(d, s) stricmp((char *)(d), (char *)(s))
1746# else
1747# define STRICMP(d, s) vim_stricmp((char *)(d), (char *)(s))
1748# endif
1749#endif
Bram Moolenaar84cf6bd2020-06-16 20:03:43 +02001750#ifdef HAVE_STRCOLL
1751# define STRCOLL(d, s) strcoll((char *)(d), (char *)(s))
1752#else
1753# define STRCOLL(d, s) strcmp((char *)(d), (char *)(s))
1754#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00001755
Bram Moolenaarc3308352019-09-01 16:24:56 +02001756// Like strcpy() but allows overlapped source and destination.
Bram Moolenaara7241f52008-06-24 20:39:31 +00001757#define STRMOVE(d, s) mch_memmove((d), (s), STRLEN(s) + 1)
1758
Bram Moolenaar071d4272004-06-13 20:20:40 +00001759#ifdef HAVE_STRNCASECMP
1760# define STRNICMP(d, s, n) strncasecmp((char *)(d), (char *)(s), (size_t)(n))
1761#else
1762# ifdef HAVE_STRNICMP
1763# define STRNICMP(d, s, n) strnicmp((char *)(d), (char *)(s), (size_t)(n))
1764# else
1765# define STRNICMP(d, s, n) vim_strnicmp((char *)(d), (char *)(s), (size_t)(n))
1766# endif
1767#endif
1768
Bram Moolenaarc3308352019-09-01 16:24:56 +02001769// We need to call mb_stricmp() even when we aren't dealing with a multi-byte
1770// encoding because mb_stricmp() takes care of all ascii and non-ascii
1771// encodings, including characters with umlauts in latin1, etc., while
1772// STRICMP() only handles the system locale version, which often does not
1773// handle non-ascii properly.
Bram Moolenaara245a5b2007-08-11 11:58:23 +00001774
1775# define MB_STRICMP(d, s) mb_strnicmp((char_u *)(d), (char_u *)(s), (int)MAXCOL)
1776# define MB_STRNICMP(d, s, n) mb_strnicmp((char_u *)(d), (char_u *)(s), (int)(n))
Christian Brabandt22e8e122024-07-30 20:39:18 +02001777# define MB_STRNICMP2(d, s, n1, n2) mb_strnicmp2((char_u *)(d), (char_u *)(s), (n1), (n2))
Bram Moolenaar071d4272004-06-13 20:20:40 +00001778
1779#define STRCAT(d, s) strcat((char *)(d), (char *)(s))
1780#define STRNCAT(d, s, n) strncat((char *)(d), (char *)(s), (size_t)(n))
1781
1782#ifdef HAVE_STRPBRK
1783# define vim_strpbrk(s, cs) (char_u *)strpbrk((char *)(s), (char *)(cs))
1784#endif
1785
Bram Moolenaar071d4272004-06-13 20:20:40 +00001786#define OUT_STR(s) out_str((char_u *)(s))
1787#define OUT_STR_NF(s) out_str_nf((char_u *)(s))
Bram Moolenaar071d4272004-06-13 20:20:40 +00001788
Bram Moolenaar8a633e32016-04-21 21:10:14 +02001789#ifdef FEAT_GUI
Bram Moolenaar61be73b2016-04-29 22:59:22 +02001790# ifdef FEAT_TERMGUICOLORS
1791# define GUI_FUNCTION(f) (gui.in_use ? gui_##f : termgui_##f)
Bram Moolenaar187147a2016-05-01 13:09:57 +02001792# define GUI_FUNCTION2(f, pixel) (gui.in_use \
1793 ? ((pixel) != INVALCOLOR \
1794 ? gui_##f((pixel)) \
Bram Moolenaar424d74b2016-08-25 23:02:11 +02001795 : INVALCOLOR) \
Bram Moolenaar187147a2016-05-01 13:09:57 +02001796 : termgui_##f((pixel)))
Bram Moolenaar61be73b2016-04-29 22:59:22 +02001797# define USE_24BIT (gui.in_use || p_tgc)
Bram Moolenaar8a633e32016-04-21 21:10:14 +02001798# else
1799# define GUI_FUNCTION(f) gui_##f
Bram Moolenaar187147a2016-05-01 13:09:57 +02001800# define GUI_FUNCTION2(f,pixel) ((pixel) != INVALCOLOR \
1801 ? gui_##f((pixel)) \
Bram Moolenaar424d74b2016-08-25 23:02:11 +02001802 : INVALCOLOR)
Bram Moolenaar8a633e32016-04-21 21:10:14 +02001803# define USE_24BIT gui.in_use
1804# endif
1805#else
Bram Moolenaar61be73b2016-04-29 22:59:22 +02001806# ifdef FEAT_TERMGUICOLORS
1807# define GUI_FUNCTION(f) termgui_##f
Bram Moolenaar187147a2016-05-01 13:09:57 +02001808# define GUI_FUNCTION2(f, pixel) termgui_##f((pixel))
Bram Moolenaar61be73b2016-04-29 22:59:22 +02001809# define USE_24BIT p_tgc
Bram Moolenaar8a633e32016-04-21 21:10:14 +02001810# endif
1811#endif
Bram Moolenaar61be73b2016-04-29 22:59:22 +02001812#ifdef FEAT_TERMGUICOLORS
1813# define IS_CTERM (t_colors > 1 || p_tgc)
Bram Moolenaar8a633e32016-04-21 21:10:14 +02001814#else
1815# define IS_CTERM (t_colors > 1)
1816#endif
1817#ifdef GUI_FUNCTION
1818# define GUI_MCH_GET_RGB GUI_FUNCTION(mch_get_rgb)
Bram Moolenaar187147a2016-05-01 13:09:57 +02001819# define GUI_MCH_GET_RGB2(pixel) GUI_FUNCTION2(mch_get_rgb, (pixel))
Bram Moolenaar8a633e32016-04-21 21:10:14 +02001820# define GUI_MCH_GET_COLOR GUI_FUNCTION(mch_get_color)
1821# define GUI_GET_COLOR GUI_FUNCTION(get_color)
1822#endif
1823
Bram Moolenaarc3308352019-09-01 16:24:56 +02001824// Prefer using emsgf(), because perror() may send the output to the wrong
1825// destination and mess up the screen.
Bram Moolenaar071d4272004-06-13 20:20:40 +00001826#ifdef HAVE_STRERROR
kylo2529dac9b12022-03-27 20:05:17 +01001827# define PERROR(msg) (void)semsg("%s: %s", (char *)(msg), strerror(errno))
Bram Moolenaar071d4272004-06-13 20:20:40 +00001828#else
Bram Moolenaarb869c0d2016-07-20 00:10:51 +02001829# define PERROR(msg) do_perror(msg)
Bram Moolenaar071d4272004-06-13 20:20:40 +00001830#endif
1831
Bram Moolenaarc3308352019-09-01 16:24:56 +02001832typedef long linenr_T; // line number type
1833typedef int colnr_T; // column number type
1834typedef unsigned short disptick_T; // display tick type
Bram Moolenaar071d4272004-06-13 20:20:40 +00001835
Bram Moolenaar071d4272004-06-13 20:20:40 +00001836/*
1837 * Well, you won't believe it, but some S/390 machines ("host", now also known
Bram Moolenaar883f5d02010-06-21 06:24:34 +02001838 * as zServer) use 31 bit pointers. There are also some newer machines, that
Bram Moolenaar071d4272004-06-13 20:20:40 +00001839 * use 64 bit pointers. I don't know how to distinguish between 31 and 64 bit
1840 * machines, so the best way is to assume 31 bits whenever we detect OS/390
1841 * Unix.
1842 * With this we restrict the maximum line length to 1073741823. I guess this is
1843 * not a real problem. BTW: Longer lines are split.
1844 */
Bram Moolenaar30276f22019-01-24 17:59:39 +01001845#ifdef __MVS__
Bram Moolenaarc9629252019-02-19 21:24:54 +01001846# define MAXCOL (0x3fffffffL) // maximum column number, 30 bits
1847# define MAXLNUM (0x3fffffffL) // maximum (invalid) line number
Bram Moolenaar071d4272004-06-13 20:20:40 +00001848#else
Bram Moolenaar8e385552022-02-12 21:16:21 +00001849 // MAXCOL used to be INT_MAX, but with 64 bit ints that results in running
1850 // out of memory when trying to allocate a very long line.
1851# define MAXCOL 0x7fffffffL // maximum column number
Bram Moolenaarc9629252019-02-19 21:24:54 +01001852# define MAXLNUM LONG_MAX // maximum (invalid) line number
Bram Moolenaar071d4272004-06-13 20:20:40 +00001853#endif
1854
Bram Moolenaarc9629252019-02-19 21:24:54 +01001855#define SHOWCMD_COLS 10 // columns needed by shown command
Bram Moolenaar071d4272004-06-13 20:20:40 +00001856
Bram Moolenaarc9629252019-02-19 21:24:54 +01001857typedef void *vim_acl_T; // dummy to pass an ACL to a function
Bram Moolenaar071d4272004-06-13 20:20:40 +00001858
Bram Moolenaar52c0de12017-01-26 21:36:34 +01001859#ifndef mch_memmove
Bram Moolenaar3a118be2017-01-27 21:22:19 +01001860# define mch_memmove(to, from, len) memmove((char*)(to), (char*)(from), (size_t)(len))
Bram Moolenaar071d4272004-06-13 20:20:40 +00001861#endif
1862
1863/*
1864 * fnamecmp() is used to compare file names.
1865 * On some systems case in a file name does not matter, on others it does.
1866 * (this does not account for maximum name lengths and things like "../dir",
1867 * thus it is not 100% accurate!)
1868 */
Bram Moolenaar71afbfe2013-03-19 16:49:16 +01001869#define fnamecmp(x, y) vim_fnamecmp((char_u *)(x), (char_u *)(y))
1870#define fnamencmp(x, y, n) vim_fnamencmp((char_u *)(x), (char_u *)(y), (size_t)(n))
Bram Moolenaar071d4272004-06-13 20:20:40 +00001871
Bram Moolenaare7fedb62015-12-31 19:07:19 +01001872#if defined(UNIX) || defined(FEAT_GUI) || defined(VMS) \
Bram Moolenaar071d4272004-06-13 20:20:40 +00001873 || defined(FEAT_CLIENTSERVER)
1874# define USE_INPUT_BUF
1875#endif
1876
Bram Moolenaar540fc6f2010-12-17 16:27:16 +01001877#ifndef EINTR
1878# define read_eintr(fd, buf, count) vim_read((fd), (buf), (count))
1879# define write_eintr(fd, buf, count) vim_write((fd), (buf), (count))
1880#endif
1881
Bram Moolenaar071d4272004-06-13 20:20:40 +00001882#ifdef MSWIN
Bram Moolenaarc3308352019-09-01 16:24:56 +02001883// On MS-Windows the third argument isn't size_t. This matters for Win64,
1884// where sizeof(size_t)==8, not 4
Bram Moolenaar071d4272004-06-13 20:20:40 +00001885# define vim_read(fd, buf, count) read((fd), (char *)(buf), (unsigned int)(count))
1886# define vim_write(fd, buf, count) write((fd), (char *)(buf), (unsigned int)(count))
1887#else
1888# define vim_read(fd, buf, count) read((fd), (char *)(buf), (size_t) (count))
1889# define vim_write(fd, buf, count) write((fd), (char *)(buf), (size_t) (count))
1890#endif
1891
1892/*
1893 * Enums need a typecast to be used as array index (for Ultrix).
1894 */
Bram Moolenaar8820b482017-03-16 17:23:31 +01001895#define HL_ATTR(n) highlight_attr[(int)(n)]
1896#define TERM_STR(n) term_strings[(int)(n)]
Bram Moolenaar071d4272004-06-13 20:20:40 +00001897
1898/*
Bram Moolenaara226a6d2006-02-26 23:59:20 +00001899 * EXTERN is only defined in main.c. That's where global variables are
1900 * actually defined and initialized.
1901 */
1902#ifndef EXTERN
1903# define EXTERN extern
1904# define INIT(x)
Bram Moolenaarea8b7ae2020-01-01 15:46:47 +01001905# define INIT2(a, b)
1906# define INIT3(a, b, c)
1907# define INIT4(a, b, c, d)
1908# define INIT5(a, b, c, d, e)
Bram Moolenaar5deeb3f2020-04-05 17:08:17 +02001909# define INIT6(a, b, c, d, e, f)
Bram Moolenaara226a6d2006-02-26 23:59:20 +00001910#else
1911# ifndef INIT
1912# define INIT(x) x
Bram Moolenaarea8b7ae2020-01-01 15:46:47 +01001913# define INIT2(a, b) = {a, b}
1914# define INIT3(a, b, c) = {a, b, c}
1915# define INIT4(a, b, c, d) = {a, b, c, d}
1916# define INIT5(a, b, c, d, e) = {a, b, c, d, e}
Bram Moolenaar5deeb3f2020-04-05 17:08:17 +02001917# define INIT6(a, b, c, d, e, f) = {a, b, c, d, e, f}
Bram Moolenaara226a6d2006-02-26 23:59:20 +00001918# define DO_INIT
1919# endif
1920#endif
1921
Bram Moolenaarc3308352019-09-01 16:24:56 +02001922#define MAX_MCO 6 // maximum value for 'maxcombine'
Bram Moolenaar362e1a32006-03-06 23:29:24 +00001923
Bram Moolenaarc3308352019-09-01 16:24:56 +02001924// Maximum number of bytes in a multi-byte character. It can be one 32-bit
1925// character of up to 6 bytes, or one 16-bit character of up to three bytes
1926// plus six following composing characters of three bytes each.
Bram Moolenaar264b74f2019-01-24 17:18:42 +01001927#define MB_MAXBYTES 21
Bram Moolenaar362e1a32006-03-06 23:29:24 +00001928
Bram Moolenaar91a4e822008-01-19 14:59:58 +00001929#if (defined(FEAT_PROFILE) || defined(FEAT_RELTIME)) && !defined(PROTO)
Bram Moolenaar4f974752019-02-17 17:44:42 +01001930# ifdef MSWIN
Bram Moolenaar91a4e822008-01-19 14:59:58 +00001931typedef LARGE_INTEGER proftime_T;
Ernie Rael076de792023-03-16 21:43:15 +00001932# define PROF_TIME_BLANK " "
1933# define PROF_TOTALS_HEADER "count total (s) self (s)"
Bram Moolenaar91a4e822008-01-19 14:59:58 +00001934# else
Ernie Rael076de792023-03-16 21:43:15 +00001935 // Use tv_fsec for fraction of second (micro or nano) of proftime_T
Bram Moolenaar08210f82023-04-13 19:15:54 +01001936# if defined(HAVE_TIMER_CREATE) && defined(HAVE_CLOCK_GETTIME)
1937# define PROF_NSEC 1
Ernie Rael076de792023-03-16 21:43:15 +00001938typedef struct timespec proftime_T;
1939# define PROF_GET_TIME(tm) clock_gettime(CLOCK_MONOTONIC, tm)
1940# define tv_fsec tv_nsec
1941# define TV_FSEC_SEC 1000000000L
1942# define PROF_TIME_FORMAT "%3ld.%09ld"
1943# define PROF_TIME_BLANK " "
1944# define PROF_TOTALS_HEADER "count total (s) self (s)"
1945# else
Bram Moolenaar91a4e822008-01-19 14:59:58 +00001946typedef struct timeval proftime_T;
Ernie Rael076de792023-03-16 21:43:15 +00001947# define PROF_GET_TIME(tm) gettimeofday(tm, NULL)
1948# define tv_fsec tv_usec
1949# define TV_FSEC_SEC 1000000
1950# define PROF_TIME_FORMAT "%3ld.%06ld"
1951# define PROF_TIME_BLANK " "
1952# define PROF_TOTALS_HEADER "count total (s) self (s)"
1953# endif
Bram Moolenaar91a4e822008-01-19 14:59:58 +00001954# endif
1955#else
Bram Moolenaarc3308352019-09-01 16:24:56 +02001956typedef int proftime_T; // dummy for function prototypes
Bram Moolenaar91a4e822008-01-19 14:59:58 +00001957#endif
1958
Bram Moolenaare99d4222021-06-13 14:01:26 +02001959// Type of compilation passed to compile_def_function()
1960typedef enum {
1961 CT_NONE, // use df_instr
1962 CT_PROFILE, // use df_instr_prof
1963 CT_DEBUG // use df_instr_debug, overrules CT_PROFILE
1964} compiletype_T;
1965
Bram Moolenaarf4fba6d2016-06-26 16:44:24 +02001966/*
1967 * When compiling with 32 bit Perl time_t is 32 bits in the Perl code but 64
1968 * bits elsewhere. That causes memory corruption. Define time_T and use it
1969 * for global variables to avoid that.
1970 */
Bram Moolenaard90b6c02016-08-28 18:10:45 +02001971#ifdef PROTO
1972typedef long time_T;
Bram Moolenaarf4fba6d2016-06-26 16:44:24 +02001973#else
Bram Moolenaar4f974752019-02-17 17:44:42 +01001974# ifdef MSWIN
Bram Moolenaard90b6c02016-08-28 18:10:45 +02001975typedef __time64_t time_T;
1976# else
Bram Moolenaarf4fba6d2016-06-26 16:44:24 +02001977typedef time_t time_T;
Bram Moolenaard90b6c02016-08-28 18:10:45 +02001978# endif
Bram Moolenaarf4fba6d2016-06-26 16:44:24 +02001979#endif
1980
Bram Moolenaard8070362016-02-15 21:56:54 +01001981#ifdef _WIN64
Bram Moolenaard090d7b2016-02-13 17:09:53 +01001982typedef __int64 sock_T;
Bram Moolenaarf8b7d892016-02-13 17:24:26 +01001983#else
Bram Moolenaard090d7b2016-02-13 17:09:53 +01001984typedef int sock_T;
Bram Moolenaard090d7b2016-02-13 17:09:53 +01001985#endif
1986
Bram Moolenaarc3308352019-09-01 16:24:56 +02001987// Include option.h before structs.h, because the number of window-local and
1988// buffer-local options is used there.
1989#include "option.h" // options and default values
Bram Moolenaar40e280d2017-11-19 20:34:59 +01001990
Bram Moolenaarc3308352019-09-01 16:24:56 +02001991#include "beval.h" // BalloonEval
Bram Moolenaara226a6d2006-02-26 23:59:20 +00001992
Bram Moolenaarc3308352019-09-01 16:24:56 +02001993// Note that gui.h is included by structs.h
Bram Moolenaar071d4272004-06-13 20:20:40 +00001994
Bram Moolenaarc3308352019-09-01 16:24:56 +02001995#include "structs.h" // defines many structures
Jonathon7c7a4e62025-01-12 09:58:00 +01001996#include "xdiff/xdiff.h" // TODO: maybe remove this, but this brings in mmfile_t so it can compile
Bram Moolenaar071d4272004-06-13 20:20:40 +00001997
Bram Moolenaar28fb79d2016-01-09 22:28:33 +01001998#include "alloc.h"
1999
Bram Moolenaarc3308352019-09-01 16:24:56 +02002000// Values for "do_profiling".
2001#define PROF_NONE 0 // profiling not started
2002#define PROF_YES 1 // profiling busy
2003#define PROF_PAUSED 2 // profiling paused
Bram Moolenaar371d5402006-03-20 21:47:49 +00002004
Bram Moolenaar071d4272004-06-13 20:20:40 +00002005
Bram Moolenaarc3308352019-09-01 16:24:56 +02002006// Codes for mouse button events in lower three bits:
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002007#define MOUSE_LEFT 0x00
2008#define MOUSE_MIDDLE 0x01
2009#define MOUSE_RIGHT 0x02
2010#define MOUSE_RELEASE 0x03
Bram Moolenaar071d4272004-06-13 20:20:40 +00002011
Bram Moolenaarc3308352019-09-01 16:24:56 +02002012// bit masks for modifiers:
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002013#define MOUSE_SHIFT 0x04
2014#define MOUSE_ALT 0x08
2015#define MOUSE_CTRL 0x10
Bram Moolenaar071d4272004-06-13 20:20:40 +00002016
Bram Moolenaarc3308352019-09-01 16:24:56 +02002017// mouse buttons that are handled like a key press (GUI only)
2018// Note that the scroll wheel keys are inverted: MOUSE_5 scrolls lines up but
2019// the result of this is that the window moves down, similarly MOUSE_6 scrolls
2020// columns left but the window moves right.
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002021#define MOUSE_4 0x100 // scroll wheel down
2022#define MOUSE_5 0x200 // scroll wheel up
Bram Moolenaar071d4272004-06-13 20:20:40 +00002023
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002024#define MOUSE_X1 0x300 // Mouse-button X1 (6th)
2025#define MOUSE_X2 0x400 // Mouse-button X2
Bram Moolenaar071d4272004-06-13 20:20:40 +00002026
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002027#define MOUSE_6 0x500 // scroll wheel left
2028#define MOUSE_7 0x600 // scroll wheel right
Bram Moolenaar8d9b40e2010-07-25 15:49:07 +02002029
Bram Moolenaar445f11d2021-06-08 20:13:31 +02002030#define MOUSE_MOVE 0x700 // report mouse moved
2031
Bram Moolenaarc3308352019-09-01 16:24:56 +02002032// 0x20 is reserved by xterm
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002033#define MOUSE_DRAG_XTERM 0x40
Bram Moolenaar071d4272004-06-13 20:20:40 +00002034
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002035#define MOUSE_DRAG (0x40 | MOUSE_RELEASE)
Bram Moolenaar071d4272004-06-13 20:20:40 +00002036
Bram Moolenaarc3308352019-09-01 16:24:56 +02002037// Lowest button code for using the mouse wheel (xterm only)
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002038#define MOUSEWHEEL_LOW 0x60
Bram Moolenaar071d4272004-06-13 20:20:40 +00002039
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002040#define MOUSE_CLICK_MASK 0x03
Bram Moolenaar071d4272004-06-13 20:20:40 +00002041
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002042#define NUM_MOUSE_CLICKS(code) \
Bram Moolenaar071d4272004-06-13 20:20:40 +00002043 (((unsigned)((code) & 0xC0) >> 6) + 1)
2044
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002045#define SET_NUM_MOUSE_CLICKS(code, num) \
kylo2529dac9b12022-03-27 20:05:17 +01002046 ((code) = ((code) & 0x3f) | ((((num) - 1) & 3) << 6))
Bram Moolenaar071d4272004-06-13 20:20:40 +00002047
Bram Moolenaarc3308352019-09-01 16:24:56 +02002048// Added to mouse column for GUI when 'mousefocus' wants to give focus to a
2049// window by simulating a click on its status line. We could use up to 128 *
2050// 128 = 16384 columns, now it's reduced to 10000.
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002051#define MOUSE_COLOFF 10000
Bram Moolenaar6f3058f2005-04-24 21:58:05 +00002052
Bram Moolenaar071d4272004-06-13 20:20:40 +00002053/*
zeertzjq3d19c812022-11-04 21:58:36 +00002054 * jump_to_mouse() returns one of first five these values, possibly with
2055 * some of the other four added.
Bram Moolenaar071d4272004-06-13 20:20:40 +00002056 */
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002057#define IN_UNKNOWN 0
2058#define IN_BUFFER 1
2059#define IN_STATUS_LINE 2 // on status or command line
2060#define IN_SEP_LINE 4 // on vertical separator line
2061#define IN_OTHER_WIN 8 // in other window but can't go there
2062#define CURSOR_MOVED 0x100
2063#define MOUSE_FOLD_CLOSE 0x200 // clicked on '-' in fold column
2064#define MOUSE_FOLD_OPEN 0x400 // clicked on '+' in fold column
2065#define MOUSE_WINBAR 0x800 // in window toolbar
Bram Moolenaar071d4272004-06-13 20:20:40 +00002066
Bram Moolenaarc3308352019-09-01 16:24:56 +02002067// flags for jump_to_mouse()
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002068#define MOUSE_FOCUS 0x01 // need to stay in this window
2069#define MOUSE_MAY_VIS 0x02 // may start Visual mode
2070#define MOUSE_DID_MOVE 0x04 // only act when mouse has moved
2071#define MOUSE_SETPOS 0x08 // only set current mouse position
2072#define MOUSE_MAY_STOP_VIS 0x10 // may stop Visual mode
2073#define MOUSE_RELEASED 0x20 // button was released
Bram Moolenaar071d4272004-06-13 20:20:40 +00002074
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002075#if defined(UNIX) && defined(HAVE_GETTIMEOFDAY) && defined(HAVE_SYS_TIME_H)
2076# define CHECK_DOUBLE_CLICK 1 // Checking for double clicks ourselves.
2077#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00002078
Bram Moolenaar071d4272004-06-13 20:20:40 +00002079
Bram Moolenaarc3308352019-09-01 16:24:56 +02002080// defines for eval_vars()
Bram Moolenaar071d4272004-06-13 20:20:40 +00002081#define VALID_PATH 1
2082#define VALID_HEAD 2
2083
Bram Moolenaar84cf6bd2020-06-16 20:03:43 +02002084// Defines for Vim variables. These must match vimvars[] in evalvars.c!
Bram Moolenaar071d4272004-06-13 20:20:40 +00002085#define VV_COUNT 0
2086#define VV_COUNT1 1
2087#define VV_PREVCOUNT 2
2088#define VV_ERRMSG 3
2089#define VV_WARNINGMSG 4
2090#define VV_STATUSMSG 5
2091#define VV_SHELL_ERROR 6
2092#define VV_THIS_SESSION 7
2093#define VV_VERSION 8
2094#define VV_LNUM 9
2095#define VV_TERMRESPONSE 10
2096#define VV_FNAME 11
2097#define VV_LANG 12
2098#define VV_LC_TIME 13
2099#define VV_CTYPE 14
2100#define VV_CC_FROM 15
2101#define VV_CC_TO 16
2102#define VV_FNAME_IN 17
2103#define VV_FNAME_OUT 18
2104#define VV_FNAME_NEW 19
2105#define VV_FNAME_DIFF 20
2106#define VV_CMDARG 21
2107#define VV_FOLDSTART 22
2108#define VV_FOLDEND 23
2109#define VV_FOLDDASHES 24
2110#define VV_FOLDLEVEL 25
2111#define VV_PROGNAME 26
2112#define VV_SEND_SERVER 27
2113#define VV_DYING 28
2114#define VV_EXCEPTION 29
2115#define VV_THROWPOINT 30
2116#define VV_REG 31
2117#define VV_CMDBANG 32
Bram Moolenaar843ee412004-06-30 16:16:41 +00002118#define VV_INSERTMODE 33
Bram Moolenaar6d14ccd2005-01-15 22:08:30 +00002119#define VV_VAL 34
2120#define VV_KEY 35
Bram Moolenaar05159a02005-02-26 23:04:13 +00002121#define VV_PROFILING 36
Bram Moolenaar19a09a12005-03-04 23:39:37 +00002122#define VV_FCS_REASON 37
2123#define VV_FCS_CHOICE 38
Bram Moolenaar52b4b552005-03-07 23:00:57 +00002124#define VV_BEVAL_BUFNR 39
2125#define VV_BEVAL_WINNR 40
Bram Moolenaarc9721bd2016-06-04 17:41:03 +02002126#define VV_BEVAL_WINID 41
2127#define VV_BEVAL_LNUM 42
2128#define VV_BEVAL_COL 43
2129#define VV_BEVAL_TEXT 44
2130#define VV_SCROLLSTART 45
2131#define VV_SWAPNAME 46
2132#define VV_SWAPCHOICE 47
2133#define VV_SWAPCOMMAND 48
2134#define VV_CHAR 49
2135#define VV_MOUSE_WIN 50
Bram Moolenaar511972d2016-06-04 18:09:59 +02002136#define VV_MOUSE_WINID 51
2137#define VV_MOUSE_LNUM 52
2138#define VV_MOUSE_COL 53
2139#define VV_OP 54
2140#define VV_SEARCHFORWARD 55
2141#define VV_HLSEARCH 56
2142#define VV_OLDFILES 57
2143#define VV_WINDOWID 58
2144#define VV_PROGPATH 59
2145#define VV_COMPLETED_ITEM 60
2146#define VV_OPTION_NEW 61
2147#define VV_OPTION_OLD 62
Bram Moolenaard7c96872019-06-15 17:12:48 +02002148#define VV_OPTION_OLDLOCAL 63
2149#define VV_OPTION_OLDGLOBAL 64
2150#define VV_OPTION_COMMAND 65
2151#define VV_OPTION_TYPE 66
2152#define VV_ERRORS 67
2153#define VV_FALSE 68
2154#define VV_TRUE 69
Bram Moolenaarf9706e92020-02-22 14:27:04 +01002155#define VV_NONE 70
2156#define VV_NULL 71
Bram Moolenaar57d5a012021-01-21 21:42:31 +01002157#define VV_NUMBERMAX 72
2158#define VV_NUMBERMIN 73
2159#define VV_NUMBERSIZE 74
2160#define VV_VIM_DID_ENTER 75
2161#define VV_TESTING 76
2162#define VV_TYPE_NUMBER 77
2163#define VV_TYPE_STRING 78
2164#define VV_TYPE_FUNC 79
2165#define VV_TYPE_LIST 80
2166#define VV_TYPE_DICT 81
2167#define VV_TYPE_FLOAT 82
2168#define VV_TYPE_BOOL 83
2169#define VV_TYPE_NONE 84
2170#define VV_TYPE_JOB 85
2171#define VV_TYPE_CHANNEL 86
2172#define VV_TYPE_BLOB 87
Bram Moolenaarc0c2c262023-01-12 21:08:53 +00002173#define VV_TYPE_CLASS 88
2174#define VV_TYPE_OBJECT 89
2175#define VV_TERMRFGRESP 90
2176#define VV_TERMRBGRESP 91
2177#define VV_TERMU7RESP 92
2178#define VV_TERMSTYLERESP 93
2179#define VV_TERMBLINKRESP 94
2180#define VV_EVENT 95
2181#define VV_VERSIONLONG 96
2182#define VV_ECHOSPACE 97
2183#define VV_ARGV 98
2184#define VV_COLLATE 99
2185#define VV_EXITING 100
2186#define VV_COLORNAMES 101
2187#define VV_SIZEOFINT 102
2188#define VV_SIZEOFLONG 103
2189#define VV_SIZEOFPOINTER 104
2190#define VV_MAXCOL 105
Yee Cheng Chinc13b3d12023-08-20 21:18:38 +02002191#define VV_PYTHON3_VERSION 106
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +02002192#define VV_TYPE_TYPEALIAS 107
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +01002193#define VV_TYPE_ENUM 108
2194#define VV_TYPE_ENUMVALUE 109
ichizok663d18d2025-01-02 18:06:00 +01002195#define VV_STACKTRACE 110
2196#define VV_LEN 111 // number of v: vars
Bram Moolenaar520e1e42016-01-23 19:46:28 +01002197
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01002198// used for v_number in VAR_BOOL and VAR_SPECIAL
2199#define VVAL_FALSE 0L // VAR_BOOL
2200#define VVAL_TRUE 1L // VAR_BOOL
2201#define VVAL_NONE 2L // VAR_SPECIAL
2202#define VVAL_NULL 3L // VAR_SPECIAL
Bram Moolenaar071d4272004-06-13 20:20:40 +00002203
Bram Moolenaard7c96872019-06-15 17:12:48 +02002204// Type values for type().
Bram Moolenaarf562e722016-07-19 17:25:25 +02002205#define VAR_TYPE_NUMBER 0
2206#define VAR_TYPE_STRING 1
2207#define VAR_TYPE_FUNC 2
2208#define VAR_TYPE_LIST 3
2209#define VAR_TYPE_DICT 4
2210#define VAR_TYPE_FLOAT 5
2211#define VAR_TYPE_BOOL 6
2212#define VAR_TYPE_NONE 7
2213#define VAR_TYPE_JOB 8
2214#define VAR_TYPE_CHANNEL 9
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01002215#define VAR_TYPE_BLOB 10
Bram Moolenaarf18332f2021-05-07 17:55:55 +02002216#define VAR_TYPE_INSTR 11
Bram Moolenaar00b28d62022-12-08 15:32:33 +00002217#define VAR_TYPE_CLASS 12
2218#define VAR_TYPE_OBJECT 13
Yegappan Lakshmanan2a71b542023-12-14 20:03:03 +01002219#define VAR_TYPE_TYPEALIAS 14
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +01002220#define VAR_TYPE_ENUM 15
2221#define VAR_TYPE_ENUMVALUE 16
Bram Moolenaarf562e722016-07-19 17:25:25 +02002222
Bram Moolenaarc3308352019-09-01 16:24:56 +02002223#define DICT_MAXNEST 100 // maximum nesting of lists and dicts
Bram Moolenaar0522ba02019-08-27 22:48:30 +02002224
Bram Moolenaar652dee42022-01-28 20:47:49 +00002225#define TABSTOP_MAX 9999
2226
Bram Moolenaar071d4272004-06-13 20:20:40 +00002227#ifdef FEAT_CLIPBOARD
2228
Bram Moolenaarc3308352019-09-01 16:24:56 +02002229// VIM_ATOM_NAME is the older Vim-specific selection type for X11. Still
2230// supported for when a mix of Vim versions is used. VIMENC_ATOM_NAME includes
2231// the encoding to support Vims using different 'encoding' values.
Bram Moolenaar08ed30e2013-01-17 17:17:26 +01002232# define VIM_ATOM_NAME "_VIM_TEXT"
2233# define VIMENC_ATOM_NAME "_VIMENC_TEXT"
Bram Moolenaar071d4272004-06-13 20:20:40 +00002234
Bram Moolenaarc3308352019-09-01 16:24:56 +02002235// Selection states for modeless selection
Bram Moolenaar071d4272004-06-13 20:20:40 +00002236# define SELECT_CLEARED 0
2237# define SELECT_IN_PROGRESS 1
2238# define SELECT_DONE 2
2239
2240# define SELECT_MODE_CHAR 0
2241# define SELECT_MODE_WORD 1
2242# define SELECT_MODE_LINE 2
2243
Bram Moolenaar4f974752019-02-17 17:44:42 +01002244# ifdef FEAT_GUI_MSWIN
Bram Moolenaar071d4272004-06-13 20:20:40 +00002245# ifdef FEAT_OLE
2246# define WM_OLE (WM_APP+0)
2247# endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00002248# endif
2249
Bram Moolenaarc3308352019-09-01 16:24:56 +02002250// Info about selected text
Bram Moolenaard2cea962019-06-14 23:14:45 +02002251typedef struct
Bram Moolenaar071d4272004-06-13 20:20:40 +00002252{
Bram Moolenaarbd75b532019-06-14 23:41:55 +02002253 int available; // Is clipboard available?
2254 int owned; // Flag: do we own the selection?
2255 pos_T start; // Start of selected area
2256 pos_T end; // End of selected area
2257 int vmode; // Visual mode character
Bram Moolenaar071d4272004-06-13 20:20:40 +00002258
Bram Moolenaarbd75b532019-06-14 23:41:55 +02002259 // Fields for selection that doesn't use Visual mode
Bram Moolenaar071d4272004-06-13 20:20:40 +00002260 short_u origin_row;
2261 short_u origin_start_col;
2262 short_u origin_end_col;
2263 short_u word_start_col;
2264 short_u word_end_col;
Bram Moolenaar05ad5ff2019-11-30 22:48:27 +01002265#ifdef FEAT_PROP_POPUP
Bram Moolenaarbd75b532019-06-14 23:41:55 +02002266 // limits for selection inside a popup window
2267 short_u min_col;
2268 short_u max_col;
2269 short_u min_row;
2270 short_u max_row;
2271#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00002272
Bram Moolenaarbd75b532019-06-14 23:41:55 +02002273 pos_T prev; // Previous position
2274 short_u state; // Current selection state
2275 short_u mode; // Select by char, word, or line.
Bram Moolenaar071d4272004-06-13 20:20:40 +00002276
2277# if defined(FEAT_GUI_X11) || defined(FEAT_XCLIPBOARD)
Bram Moolenaarbd75b532019-06-14 23:41:55 +02002278 Atom sel_atom; // PRIMARY/CLIPBOARD selection ID
Bram Moolenaar071d4272004-06-13 20:20:40 +00002279# endif
2280
2281# ifdef FEAT_GUI_GTK
Bram Moolenaarbd75b532019-06-14 23:41:55 +02002282 GdkAtom gtk_sel_atom; // PRIMARY/CLIPBOARD selection ID
Bram Moolenaar071d4272004-06-13 20:20:40 +00002283# endif
2284
Bram Moolenaar693e40c2013-02-26 14:56:42 +01002285# if defined(MSWIN) || defined(FEAT_CYGWIN_WIN32_CLIPBOARD)
Bram Moolenaarbd75b532019-06-14 23:41:55 +02002286 int_u format; // Vim's own special clipboard format
2287 int_u format_raw; // Vim's raw text clipboard format
Bram Moolenaar071d4272004-06-13 20:20:40 +00002288# endif
Bram Moolenaarb3f74062020-02-26 16:16:53 +01002289# ifdef FEAT_GUI_HAIKU
2290 // No clipboard at the moment. TODO?
2291# endif
Bram Moolenaard2cea962019-06-14 23:14:45 +02002292} Clipboard_T;
Bram Moolenaar071d4272004-06-13 20:20:40 +00002293#else
Bram Moolenaard2cea962019-06-14 23:14:45 +02002294typedef int Clipboard_T; // This is required for the prototypes.
Bram Moolenaar071d4272004-06-13 20:20:40 +00002295#endif
2296
K.Takatac351dc12022-01-24 11:24:08 +00002297// Use 64-bit stat structure on MS-Windows.
2298#ifdef MSWIN
Bram Moolenaar8767f522016-07-01 17:17:39 +02002299typedef struct _stat64 stat_T;
2300#else
2301typedef struct stat stat_T;
2302#endif
2303
Bram Moolenaar952d9d82021-08-02 18:07:18 +02002304#if (defined(__GNUC__) || defined(__clang__)) && !defined(__MINGW32__)
2305# define ATTRIBUTE_FORMAT_PRINTF(fmt_idx, arg_idx) \
2306 __attribute__((format(printf, fmt_idx, arg_idx)))
2307#else
2308# define ATTRIBUTE_FORMAT_PRINTF(fmt_idx, arg_idx)
2309#endif
2310
2311#if defined(__GNUC__) || defined(__clang__)
ichizoke1240652022-01-07 20:01:07 +00002312# define likely(x) __builtin_expect((x), 1)
2313# define unlikely(x) __builtin_expect((x), 0)
2314# define ATTRIBUTE_COLD __attribute__((cold))
Bram Moolenaar952d9d82021-08-02 18:07:18 +02002315#else
ichizok8bb3fe42021-12-28 15:51:45 +00002316# define unlikely(x) (x)
2317# define likely(x) (x)
Bram Moolenaar952d9d82021-08-02 18:07:18 +02002318# define ATTRIBUTE_COLD
Bram Moolenaare80757c2018-04-10 12:42:44 +02002319#endif
2320
Bram Moolenaar4f25b1a2020-09-10 19:25:05 +02002321typedef enum {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002322 ASSERT_EQUAL,
2323 ASSERT_NOTEQUAL,
2324 ASSERT_MATCH,
2325 ASSERT_NOTMATCH,
zeertzjq53f5e512023-05-04 18:58:22 +01002326 ASSERT_FAILS,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002327 ASSERT_OTHER
2328} assert_type_T;
2329
Bram Moolenaarc3308352019-09-01 16:24:56 +02002330// Mode for bracketed_paste().
Bram Moolenaarec2da362017-01-21 20:04:22 +01002331typedef enum {
Bram Moolenaarc3308352019-09-01 16:24:56 +02002332 PASTE_INSERT, // insert mode
2333 PASTE_CMDLINE, // command line
2334 PASTE_EX, // ex mode line
2335 PASTE_ONE_CHAR // return first character
Bram Moolenaarec2da362017-01-21 20:04:22 +01002336} paste_mode_T;
2337
Bram Moolenaar6a2633b2018-10-07 23:16:36 +02002338// Argument for flush_buffers().
2339typedef enum {
2340 FLUSH_MINIMAL,
2341 FLUSH_TYPEAHEAD, // flush current typebuf contents
2342 FLUSH_INPUT // flush typebuf and inchar() input
2343} flush_buffers_T;
2344
Bram Moolenaardca7abe2019-10-20 18:17:57 +02002345// Argument for prepare_tagpreview()
2346typedef enum {
2347 USEPOPUP_NONE,
2348 USEPOPUP_NORMAL, // use info popup
2349 USEPOPUP_HIDDEN // use info popup initially hidden
2350} use_popup_T;
2351
Bram Moolenaar4f25b1a2020-09-10 19:25:05 +02002352// Argument for estack_sfile().
2353typedef enum {
2354 ESTACK_NONE,
2355 ESTACK_SFILE,
LemonBoy6013d002022-04-09 21:42:10 +01002356 ESTACK_STACK,
2357 ESTACK_SCRIPT,
Bram Moolenaar4f25b1a2020-09-10 19:25:05 +02002358} estack_arg_T;
2359
Bram Moolenaar63a2e362022-11-23 20:20:18 +00002360// Return value of match_keyprotocol()
2361typedef enum {
2362 KEYPROTOCOL_NONE,
2363 KEYPROTOCOL_MOK2,
2364 KEYPROTOCOL_KITTY,
2365 KEYPROTOCOL_FAIL
2366} keyprot_T;
2367
Bram Moolenaar0917e862023-02-18 14:42:44 +00002368// errors for when calling a function
2369typedef enum {
2370 FCERR_NONE, // no error
2371 FCERR_UNKNOWN, // unknown function
2372 FCERR_TOOMANY, // too many arguments
2373 FCERR_TOOFEW, // too few arguments
2374 FCERR_SCRIPT, // missing script context
2375 FCERR_DICT, // missing dict
2376 FCERR_OTHER, // another kind of error
2377 FCERR_DELETED, // function was deleted
2378 FCERR_NOTMETHOD, // function cannot be used as a method
2379 FCERR_FAILED, // error while executing the function
2380} funcerror_T;
2381
Yegappan Lakshmananaf936912023-02-20 12:16:39 +00002382/*
glepnir6a89c942024-10-01 20:32:12 +02002383 * Array indexes used for cp_text[].
2384 */
2385typedef enum {
2386 CPT_ABBR, // "abbr"
2387 CPT_KIND, // "kind"
2388 CPT_MENU, // "menu"
2389 CPT_INFO, // "info"
2390 CPT_COUNT, // Number of entries
2391} cpitem_T;
2392
2393/*
Yegappan Lakshmananaf936912023-02-20 12:16:39 +00002394 * Type for the callback function that is invoked after an option value is
2395 * changed to validate and apply the new value.
Yegappan Lakshmanana23a11b2023-02-21 14:27:41 +00002396 *
2397 * Returns NULL if the option value is valid is successfully applied.
2398 * Otherwise returns an error message.
Yegappan Lakshmananaf936912023-02-20 12:16:39 +00002399 */
2400typedef char *(*opt_did_set_cb_T)(optset_T *args);
2401
Yee Cheng Chin900894b2023-09-29 20:42:32 +02002402/*
2403 * Type for the callback function that is invoked when expanding possible
2404 * string option values during cmdline completion.
2405 *
2406 * Strings in returned matches will be managed and freed by caller.
2407 *
2408 * Returns OK if the expansion succeeded (numMatches and matches have to be
2409 * set). Otherwise returns FAIL.
2410 *
2411 * Note: If returned FAIL or *numMatches is 0, *matches will NOT be freed by
2412 * caller.
2413 */
2414typedef int (*opt_expand_cb_T)(optexpand_T *args, int *numMatches, char_u ***matches);
2415
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002416// Flags for assignment functions.
Bram Moolenaar6586a012022-09-30 11:04:50 +01002417#define ASSIGN_VAR 0 // ":var" (nothing special)
Bram Moolenaarf93bbd02021-04-10 22:35:43 +02002418#define ASSIGN_FINAL 0x01 // ":final"
2419#define ASSIGN_CONST 0x02 // ":const"
2420#define ASSIGN_NO_DECL 0x04 // "name = expr" without ":let"/":const"/":final"
2421#define ASSIGN_DECL 0x08 // may declare variable if it does not exist
2422#define ASSIGN_UNPACK 0x10 // using [a, b] = list
Bram Moolenaarf2253962021-04-13 20:53:13 +02002423#define ASSIGN_NO_MEMBER_TYPE 0x20 // use "any" for list and dict member type
Bram Moolenaarf6a8d422021-04-13 21:48:03 +02002424#define ASSIGN_FOR_LOOP 0x40 // assigning to loop variable
Bram Moolenaar859cc212022-03-28 15:22:35 +01002425#define ASSIGN_INIT 0x80 // not assigning a value, just a declaration
Bram Moolenaar766ae5b2022-09-14 00:30:51 +01002426#define ASSIGN_UPDATE_BLOCK_ID 0x100 // update sav_block_id
Yegappan Lakshmanan1af35632024-02-06 11:03:36 +01002427#define ASSIGN_COMPOUND_OP 0x200 // compound operator e.g. "+="
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002428
Bram Moolenaarc3308352019-09-01 16:24:56 +02002429#include "ex_cmds.h" // Ex command defines
2430#include "spell.h" // spell checking stuff
Bram Moolenaar6cfdb2a2016-07-19 17:01:31 +02002431
Bram Moolenaarc3308352019-09-01 16:24:56 +02002432#include "proto.h" // function prototypes
Bram Moolenaar071d4272004-06-13 20:20:40 +00002433
Bram Moolenaarc3308352019-09-01 16:24:56 +02002434// This has to go after the include of proto.h, as proto/gui.pro declares
2435// functions of these names. The declarations would break if the defines had
2436// been seen at that stage. But it must be before globals.h, where error_ga
2437// is declared.
Bram Moolenaarb3f74062020-02-26 16:16:53 +01002438#if !defined(MSWIN) && !defined(FEAT_GUI_X11) && !defined(FEAT_GUI_HAIKU) \
Bram Moolenaar097148e2020-08-11 21:58:20 +02002439 && !defined(FEAT_GUI_GTK) && !defined(PROTO)
Bram Moolenaar071d4272004-06-13 20:20:40 +00002440# define mch_errmsg(str) fprintf(stderr, "%s", (str))
2441# define display_errors() fflush(stderr)
2442# define mch_msg(str) printf("%s", (str))
2443#else
2444# define USE_MCH_ERRMSG
2445#endif
2446
Bram Moolenaar264b74f2019-01-24 17:18:42 +01002447# if defined(FEAT_EVAL) \
K.Takata4ac893f2022-01-20 12:44:28 +00002448 && (!defined(FEAT_GUI_MSWIN) || !defined(FEAT_MBYTE_IME))
Bram Moolenaarc3308352019-09-01 16:24:56 +02002449// Whether IME is supported by im_get_status() defined in mbyte.c.
K.Takata4ac893f2022-01-20 12:44:28 +00002450// For Win32 GUI it's in gui_w32.c when FEAT_MBYTE_IME is defined.
Bram Moolenaarf2bd8ef2018-03-04 18:08:14 +01002451# define IME_WITHOUT_XIM
2452#endif
2453
Bram Moolenaar264b74f2019-01-24 17:18:42 +01002454#if defined(FEAT_XIM) \
Bram Moolenaarf2bd8ef2018-03-04 18:08:14 +01002455 || defined(IME_WITHOUT_XIM) \
K.Takata4ac893f2022-01-20 12:44:28 +00002456 || (defined(FEAT_GUI_MSWIN) && defined(FEAT_MBYTE_IME))
Bram Moolenaarc3308352019-09-01 16:24:56 +02002457// im_set_active() is available
Bram Moolenaarf2bd8ef2018-03-04 18:08:14 +01002458# define HAVE_INPUT_METHOD
2459#endif
2460
Bram Moolenaaraab21c32005-01-25 21:46:35 +00002461#ifndef FEAT_LINEBREAK
Bram Moolenaarc3308352019-09-01 16:24:56 +02002462// Without the 'numberwidth' option line numbers are always 7 chars.
Bram Moolenaaraab21c32005-01-25 21:46:35 +00002463# define number_width(x) 7
2464#endif
2465
Bram Moolenaarc3308352019-09-01 16:24:56 +02002466// This must come after including proto.h.
2467// For VMS this is defined in macros.h.
Bram Moolenaar4f974752019-02-17 17:44:42 +01002468#if !defined(MSWIN) && !defined(VMS)
Bram Moolenaarb6843a02017-08-02 22:07:12 +02002469# define mch_open(n, m, p) open((n), (m), (p))
2470# define mch_fopen(n, p) fopen((n), (p))
2471#endif
Bram Moolenaaraab21c32005-01-25 21:46:35 +00002472
Bram Moolenaarc3308352019-09-01 16:24:56 +02002473#include "globals.h" // global variables and messages
Bram Moolenaarbc4c5052020-08-13 22:47:35 +02002474#include "errors.h" // error messages
Bram Moolenaar071d4272004-06-13 20:20:40 +00002475
Bram Moolenaar071d4272004-06-13 20:20:40 +00002476/*
2477 * If console dialog not supported, but GUI dialog is, use the GUI one.
2478 */
2479#if defined(FEAT_GUI_DIALOG) && !defined(FEAT_CON_DIALOG)
2480# define do_dialog gui_mch_dialog
2481#endif
2482
2483/*
2484 * Default filters for gui_mch_browse().
2485 * The filters are almost system independent. Except for the difference
2486 * between "*" and "*.*" for MSDOS-like systems.
2487 * NOTE: Motif only uses the very first pattern. Therefore
2488 * BROWSE_FILTER_DEFAULT should start with a "*" pattern.
2489 */
2490#ifdef FEAT_BROWSE
2491# ifdef BACKSLASH_IN_FILENAME
2492# define BROWSE_FILTER_MACROS \
Bram Moolenaarc36651b2018-04-29 12:22:56 +02002493 (char_u *)N_("Vim macro files (*.vim)\t*.vim\nAll Files (*.*)\t*.*\n")
2494# define BROWSE_FILTER_ALL_FILES (char_u *)N_("All Files (*.*)\t*.*\n")
Bram Moolenaar071d4272004-06-13 20:20:40 +00002495# define BROWSE_FILTER_DEFAULT \
Bram Moolenaarc36651b2018-04-29 12:22:56 +02002496 (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")
Bram Moolenaar071d4272004-06-13 20:20:40 +00002497# else
2498# define BROWSE_FILTER_MACROS \
Bram Moolenaarc36651b2018-04-29 12:22:56 +02002499 (char_u *)N_("Vim macro files (*.vim)\t*.vim\nAll Files (*)\t*\n")
2500# define BROWSE_FILTER_ALL_FILES (char_u *)N_("All Files (*)\t*\n")
Bram Moolenaar071d4272004-06-13 20:20:40 +00002501# define BROWSE_FILTER_DEFAULT \
Bram Moolenaarc36651b2018-04-29 12:22:56 +02002502 (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")
Bram Moolenaar071d4272004-06-13 20:20:40 +00002503# endif
Bram Moolenaarc3308352019-09-01 16:24:56 +02002504# define BROWSE_SAVE 1 // flag for do_browse()
2505# define BROWSE_DIR 2 // flag for do_browse()
Bram Moolenaar071d4272004-06-13 20:20:40 +00002506#endif
2507
Bram Moolenaar442b4222010-05-24 21:34:22 +02002508#ifdef _MSC_VER
Bram Moolenaarc3308352019-09-01 16:24:56 +02002509// Avoid useless warning "conversion from X to Y of greater size".
Bram Moolenaar442b4222010-05-24 21:34:22 +02002510 #pragma warning(disable : 4312)
Bram Moolenaarc3308352019-09-01 16:24:56 +02002511// Avoid warning for old style function declarators
Bram Moolenaareb292852015-02-10 18:47:58 +01002512 #pragma warning(disable : 4131)
Bram Moolenaarc3308352019-09-01 16:24:56 +02002513// Avoid warning for conversion to type with smaller range
Bram Moolenaareb292852015-02-10 18:47:58 +01002514 #pragma warning(disable : 4244)
Bram Moolenaarc3308352019-09-01 16:24:56 +02002515// Avoid warning for conversion to larger size
Bram Moolenaareb292852015-02-10 18:47:58 +01002516 #pragma warning(disable : 4306)
Bram Moolenaarc3308352019-09-01 16:24:56 +02002517// Avoid warning for unreferenced formal parameter
Bram Moolenaareb292852015-02-10 18:47:58 +01002518 #pragma warning(disable : 4100)
Bram Moolenaarc3308352019-09-01 16:24:56 +02002519// Avoid warning for differs in indirection to slightly different base type
Bram Moolenaareb292852015-02-10 18:47:58 +01002520 #pragma warning(disable : 4057)
Bram Moolenaarc3308352019-09-01 16:24:56 +02002521// Avoid warning for constant conditional expression
Bram Moolenaareb292852015-02-10 18:47:58 +01002522 #pragma warning(disable : 4127)
Bram Moolenaarc3308352019-09-01 16:24:56 +02002523// Avoid warning for assignment within conditional
Bram Moolenaareb292852015-02-10 18:47:58 +01002524 #pragma warning(disable : 4706)
Bram Moolenaar442b4222010-05-24 21:34:22 +02002525#endif
2526
Bram Moolenaarc3308352019-09-01 16:24:56 +02002527// Note: a NULL argument for vim_realloc() is not portable, don't use it.
Bram Moolenaar071d4272004-06-13 20:20:40 +00002528#if defined(MEM_PROFILE)
2529# define vim_realloc(ptr, size) mem_realloc((ptr), (size))
2530#else
2531# define vim_realloc(ptr, size) realloc((ptr), (size))
2532#endif
2533
Bram Moolenaar071d4272004-06-13 20:20:40 +00002534/*
2535 * Return byte length of character that starts with byte "b".
2536 * Returns 1 for a single-byte character.
2537 * MB_BYTE2LEN_CHECK() can be used to count a special key as one byte.
2538 * Don't call MB_BYTE2LEN(b) with b < 0 or b > 255!
2539 */
Bram Moolenaar264b74f2019-01-24 17:18:42 +01002540#define MB_BYTE2LEN(b) mb_bytelen_tab[b]
2541#define MB_BYTE2LEN_CHECK(b) (((b) < 0 || (b) > 255) ? 1 : mb_bytelen_tab[b])
Bram Moolenaar071d4272004-06-13 20:20:40 +00002542
Bram Moolenaarc3308352019-09-01 16:24:56 +02002543// properties used in enc_canon_table[] (first three mutually exclusive)
Bram Moolenaar264b74f2019-01-24 17:18:42 +01002544#define ENC_8BIT 0x01
2545#define ENC_DBCS 0x02
2546#define ENC_UNICODE 0x04
Bram Moolenaar071d4272004-06-13 20:20:40 +00002547
Bram Moolenaarc3308352019-09-01 16:24:56 +02002548#define ENC_ENDIAN_B 0x10 // Unicode: Big endian
2549#define ENC_ENDIAN_L 0x20 // Unicode: Little endian
Bram Moolenaar071d4272004-06-13 20:20:40 +00002550
Bram Moolenaarc3308352019-09-01 16:24:56 +02002551#define ENC_2BYTE 0x40 // Unicode: UCS-2
2552#define ENC_4BYTE 0x80 // Unicode: UCS-4
2553#define ENC_2WORD 0x100 // Unicode: UTF-16
Bram Moolenaar071d4272004-06-13 20:20:40 +00002554
Bram Moolenaarc3308352019-09-01 16:24:56 +02002555#define ENC_LATIN1 0x200 // Latin1
2556#define ENC_LATIN9 0x400 // Latin9
2557#define ENC_MACROMAN 0x800 // Mac Roman (not Macro Man! :-)
Bram Moolenaar071d4272004-06-13 20:20:40 +00002558
Bram Moolenaar264b74f2019-01-24 17:18:42 +01002559#ifdef USE_ICONV
2560# ifndef EILSEQ
2561# define EILSEQ 123
Bram Moolenaar071d4272004-06-13 20:20:40 +00002562# endif
Bram Moolenaar264b74f2019-01-24 17:18:42 +01002563# ifdef DYNAMIC_ICONV
Bram Moolenaarc3308352019-09-01 16:24:56 +02002564// On Win32 iconv.dll is dynamically loaded.
Bram Moolenaar264b74f2019-01-24 17:18:42 +01002565# define ICONV_ERRNO (*iconv_errno())
2566# define ICONV_E2BIG 7
2567# define ICONV_EINVAL 22
2568# define ICONV_EILSEQ 42
2569# else
2570# define ICONV_ERRNO errno
2571# define ICONV_E2BIG E2BIG
2572# define ICONV_EINVAL EINVAL
2573# define ICONV_EILSEQ EILSEQ
2574# endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00002575#endif
2576
Bram Moolenaarc3308352019-09-01 16:24:56 +02002577#define SIGN_BYTE 1 // byte value used where sign is displayed;
2578 // attribute value is sign type
Bram Moolenaar071d4272004-06-13 20:20:40 +00002579
2580#ifdef FEAT_NETBEANS_INTG
Bram Moolenaarc3308352019-09-01 16:24:56 +02002581# define MULTISIGN_BYTE 2 // byte value used where sign is displayed if
2582 // multiple signs exist on the line
Bram Moolenaar071d4272004-06-13 20:20:40 +00002583#endif
2584
2585#if defined(FEAT_GUI) && defined(FEAT_XCLIPBOARD)
2586# ifdef FEAT_GUI_GTK
Bram Moolenaarc3308352019-09-01 16:24:56 +02002587 // Avoid using a global variable for the X display. It's ugly
2588 // and is likely to cause trouble in multihead environments.
Bram Moolenaar071d4272004-06-13 20:20:40 +00002589# define X_DISPLAY ((gui.in_use) ? gui_mch_get_display() : xterm_dpy)
2590# else
2591# define X_DISPLAY (gui.in_use ? gui.dpy : xterm_dpy)
2592# endif
2593#else
2594# ifdef FEAT_GUI
2595# ifdef FEAT_GUI_GTK
2596# define X_DISPLAY ((gui.in_use) ? gui_mch_get_display() : (Display *)NULL)
2597# else
2598# define X_DISPLAY gui.dpy
2599# endif
2600# else
2601# define X_DISPLAY xterm_dpy
2602# endif
2603#endif
2604
Bram Moolenaar77c604d2012-07-10 13:41:14 +02002605#if defined(FEAT_BROWSE) && defined(GTK_CHECK_VERSION)
2606# if GTK_CHECK_VERSION(2,4,0)
2607# define USE_FILE_CHOOSER
2608# endif
2609#endif
2610
Bram Moolenaar25328e32018-09-11 21:30:09 +02002611#ifdef FEAT_GUI_GTK
2612# if !GTK_CHECK_VERSION(2,14,0)
2613# define gtk_widget_get_window(wid) ((wid)->window)
Bram Moolenaar664323e2018-09-18 22:30:07 +02002614# define gtk_plug_get_socket_window(wid) ((wid)->socket_window)
2615# define gtk_selection_data_get_data(sel) ((sel)->data)
2616# define gtk_selection_data_get_data_type(sel) ((sel)->type)
2617# define gtk_selection_data_get_format(sel) ((sel)->format)
2618# define gtk_selection_data_get_length(sel) ((sel)->length)
2619# define gtk_adjustment_set_lower(adj, low) \
2620 do { (adj)->lower = low; } while (0)
2621# define gtk_adjustment_set_upper(adj, up) \
2622 do { (adj)->upper = up; } while (0)
2623# define gtk_adjustment_set_page_size(adj, size) \
2624 do { (adj)->page_size = size; } while (0)
2625# define gtk_adjustment_set_page_increment(adj, inc) \
2626 do { (adj)->page_increment = inc; } while (0)
2627# define gtk_adjustment_set_step_increment(adj, inc) \
2628 do { (adj)->step_increment = inc; } while (0)
2629# endif
2630# if !GTK_CHECK_VERSION(2,16,0)
2631# define gtk_selection_data_get_selection(sel) ((sel)->selection)
2632# endif
2633# if !GTK_CHECK_VERSION(2,18,0)
2634# define gtk_widget_get_allocation(wid, alloc) \
2635 do { *(alloc) = (wid)->allocation; } while (0)
2636# define gtk_widget_set_allocation(wid, alloc) \
2637 do { (wid)->allocation = *(alloc); } while (0)
2638# define gtk_widget_get_has_window(wid) !GTK_WIDGET_NO_WINDOW(wid)
2639# define gtk_widget_get_sensitive(wid) GTK_WIDGET_SENSITIVE(wid)
2640# define gtk_widget_get_visible(wid) GTK_WIDGET_VISIBLE(wid)
2641# define gtk_widget_has_focus(wid) GTK_WIDGET_HAS_FOCUS(wid)
2642# define gtk_widget_set_window(wid, win) \
2643 do { (wid)->window = (win); } while (0)
2644# define gtk_widget_set_can_default(wid, can) \
Bram Moolenaarebfec1c2023-01-22 21:14:53 +00002645 do { if (can) \
2646 { GTK_WIDGET_SET_FLAGS(wid, GTK_CAN_DEFAULT); } \
2647 else \
2648 { GTK_WIDGET_UNSET_FLAGS(wid, GTK_CAN_DEFAULT); } } while (0)
Bram Moolenaar664323e2018-09-18 22:30:07 +02002649# define gtk_widget_set_can_focus(wid, can) \
Bram Moolenaarebfec1c2023-01-22 21:14:53 +00002650 do { if (can) \
2651 { GTK_WIDGET_SET_FLAGS(wid, GTK_CAN_FOCUS); } \
2652 else \
2653 { GTK_WIDGET_UNSET_FLAGS(wid, GTK_CAN_FOCUS); } } while (0)
Bram Moolenaar664323e2018-09-18 22:30:07 +02002654# define gtk_widget_set_visible(wid, vis) \
Bram Moolenaarebfec1c2023-01-22 21:14:53 +00002655 do { if (vis) \
2656 { gtk_widget_show(wid); } \
2657 else \
2658 { gtk_widget_hide(wid); } } while (0)
Bram Moolenaar664323e2018-09-18 22:30:07 +02002659# endif
2660# if !GTK_CHECK_VERSION(2,20,0)
2661# define gtk_widget_get_mapped(wid) GTK_WIDGET_MAPPED(wid)
2662# define gtk_widget_get_realized(wid) GTK_WIDGET_REALIZED(wid)
2663# define gtk_widget_set_mapped(wid, map) \
Bram Moolenaarebfec1c2023-01-22 21:14:53 +00002664 do { if (map) \
2665 { GTK_WIDGET_SET_FLAGS(wid, GTK_MAPPED); } \
2666 else \
2667 { GTK_WIDGET_UNSET_FLAGS(wid, GTK_MAPPED); } } while (0)
Bram Moolenaar664323e2018-09-18 22:30:07 +02002668# define gtk_widget_set_realized(wid, rea) \
Bram Moolenaarebfec1c2023-01-22 21:14:53 +00002669 do { if (rea) \
2670 { GTK_WIDGET_SET_FLAGS(wid, GTK_REALIZED); } \
2671 else \
2672 { GTK_WIDGET_UNSET_FLAGS(wid, GTK_REALIZED); } } while (0)
Bram Moolenaar25328e32018-09-11 21:30:09 +02002673# endif
2674#endif
2675
Bram Moolenaar03005972008-11-20 13:12:36 +00002676#ifndef FEAT_NETBEANS_INTG
2677# undef NBDEBUG
2678#endif
Bram Moolenaarc3308352019-09-01 16:24:56 +02002679#ifdef NBDEBUG // Netbeans debugging.
Bram Moolenaar071d4272004-06-13 20:20:40 +00002680# include "nbdebug.h"
2681#else
2682# define nbdebug(a)
Bram Moolenaar071d4272004-06-13 20:20:40 +00002683#endif
2684
2685#ifdef IN_PERL_FILE
2686 /*
2687 * Avoid clashes between Perl and Vim namespace.
2688 */
Bram Moolenaar071d4272004-06-13 20:20:40 +00002689# undef STRLEN
2690# undef FF
2691# undef OP_DELETE
2692# undef OP_JOIN
Bram Moolenaarc3308352019-09-01 16:24:56 +02002693 // remove MAX and MIN, included by glib.h, redefined by sys/param.h
Bram Moolenaar071d4272004-06-13 20:20:40 +00002694# ifdef MAX
2695# undef MAX
2696# endif
2697# ifdef MIN
2698# undef MIN
2699# endif
Bram Moolenaarc3308352019-09-01 16:24:56 +02002700 // We use _() for gettext(), Perl uses it for function prototypes...
Bram Moolenaar071d4272004-06-13 20:20:40 +00002701# ifdef _
2702# undef _
2703# endif
2704# ifdef DEBUG
2705# undef DEBUG
2706# endif
2707# ifdef _DEBUG
2708# undef _DEBUG
2709# endif
2710# ifdef instr
2711# undef instr
2712# endif
Bram Moolenaarc3308352019-09-01 16:24:56 +02002713 // bool may cause trouble on some old versions of Mac OS X but is required
2714 // on a few other systems and for Perl
Bram Moolenaard0573012017-10-28 21:11:06 +02002715# if (defined(MACOS_X) && !defined(MAC_OS_X_VERSION_10_6)) \
2716 && defined(bool) && !defined(FEAT_PERL)
Bram Moolenaar071d4272004-06-13 20:20:40 +00002717# undef bool
2718# endif
2719
Bram Moolenaar071d4272004-06-13 20:20:40 +00002720#endif
2721
Bram Moolenaarc3308352019-09-01 16:24:56 +02002722// values for vim_handle_signal() that are not a signal
kylo2529dac9b12022-03-27 20:05:17 +01002723#define SIGNAL_BLOCK (-1)
2724#define SIGNAL_UNBLOCK (-2)
Bram Moolenaare7fedb62015-12-31 19:07:19 +01002725#if !defined(UNIX) && !defined(VMS)
Bram Moolenaar5eba4c22005-07-12 22:40:29 +00002726# define vim_handle_signal(x) 0
Bram Moolenaar293ee4d2004-12-09 21:34:53 +00002727#endif
2728
Bram Moolenaarc3308352019-09-01 16:24:56 +02002729// flags for skip_vimgrep_pat()
Bram Moolenaar05159a02005-02-26 23:04:13 +00002730#define VGR_GLOBAL 1
2731#define VGR_NOJUMP 2
Yegappan Lakshmananbb01a1e2021-04-26 21:17:52 +02002732#define VGR_FUZZY 4
Bram Moolenaar05159a02005-02-26 23:04:13 +00002733
Bram Moolenaarc3308352019-09-01 16:24:56 +02002734// behavior for bad character, "++bad=" argument
2735#define BAD_REPLACE '?' // replace it with '?' (default)
kylo2529dac9b12022-03-27 20:05:17 +01002736#define BAD_KEEP (-1) // leave it
2737#define BAD_DROP (-2) // erase it
Bram Moolenaarb0bf8582005-12-13 20:02:15 +00002738
Bram Moolenaarc3308352019-09-01 16:24:56 +02002739// last argument for do_source()
Bram Moolenaar910f66f2006-04-05 20:41:53 +00002740#define DOSO_NONE 0
Bram Moolenaarc3308352019-09-01 16:24:56 +02002741#define DOSO_VIMRC 1 // loading vimrc file
2742#define DOSO_GVIMRC 2 // loading gvimrc file
Bram Moolenaar371d5402006-03-20 21:47:49 +00002743
Bram Moolenaarc3308352019-09-01 16:24:56 +02002744// flags for read_viminfo() and children
Bram Moolenaar3ff656f2021-02-10 19:22:15 +01002745#define VIF_WANT_INFO 1 // load non-mark info
2746#define VIF_WANT_MARKS 2 // load file marks
2747#define VIF_ONLY_CURBUF 4 // bail out after loading marks for curbuf
2748#define VIF_FORCEIT 8 // overwrite info already read
2749#define VIF_GET_OLDFILES 16 // load v:oldfiles
Bram Moolenaard812df62008-11-09 12:46:09 +00002750
Bram Moolenaarc3308352019-09-01 16:24:56 +02002751// flags for buf_freeall()
Bram Moolenaara6e8f882019-12-14 16:18:15 +01002752#define BFA_DEL 1 // buffer is going to be deleted
2753#define BFA_WIPE 2 // buffer is going to be wiped out
2754#define BFA_KEEP_UNDO 4 // do not free undo information
2755#define BFA_IGNORE_ABORT 8 // do not abort for aborting()
Bram Moolenaar59f931e2010-07-24 20:27:03 +02002756
Bram Moolenaarc3308352019-09-01 16:24:56 +02002757// direction for nv_mousescroll() and ins_mousescroll()
2758#define MSCR_DOWN 0 // DOWN must be FALSE
Bram Moolenaar8d9b40e2010-07-25 15:49:07 +02002759#define MSCR_UP 1
kylo2529dac9b12022-03-27 20:05:17 +01002760#define MSCR_LEFT (-1)
2761#define MSCR_RIGHT (-2)
Bram Moolenaar8d9b40e2010-07-25 15:49:07 +02002762
kylo2529dac9b12022-03-27 20:05:17 +01002763#define KEYLEN_PART_KEY (-1) // keylen value for incomplete key-code
2764#define KEYLEN_PART_MAP (-2) // keylen value for incomplete mapping
Bram Moolenaarc3308352019-09-01 16:24:56 +02002765#define KEYLEN_REMOVED 9999 // keylen value for removed sequence
Bram Moolenaar946ffd42010-12-30 12:30:31 +01002766
Bram Moolenaarc3308352019-09-01 16:24:56 +02002767// Return values from win32_fileinfo().
Bram Moolenaar1c32dff2011-05-05 16:41:24 +02002768#define FILEINFO_OK 0
Bram Moolenaarc3308352019-09-01 16:24:56 +02002769#define FILEINFO_ENC_FAIL 1 // enc_to_utf16() failed
2770#define FILEINFO_READ_FAIL 2 // CreateFile() failed
2771#define FILEINFO_INFO_FAIL 3 // GetFileInformationByHandle() failed
Bram Moolenaar1c32dff2011-05-05 16:41:24 +02002772
Bram Moolenaarc3308352019-09-01 16:24:56 +02002773// Return value from get_option_value_strict
2774#define SOPT_BOOL 0x01 // Boolean option
2775#define SOPT_NUM 0x02 // Number option
2776#define SOPT_STRING 0x04 // String option
2777#define SOPT_GLOBAL 0x08 // Option has global value
2778#define SOPT_WIN 0x10 // Option has window-local value
2779#define SOPT_BUF 0x20 // Option has buffer-local value
2780#define SOPT_UNSET 0x40 // Option does not have local value set
Bram Moolenaar84e0f6c2013-05-06 03:52:55 +02002781
Bram Moolenaarc3308352019-09-01 16:24:56 +02002782// Option types for various functions in option.c
2783#define SREQ_GLOBAL 0 // Request global option
2784#define SREQ_WIN 1 // Request window-local option
2785#define SREQ_BUF 2 // Request buffer-local option
Bram Moolenaar84e0f6c2013-05-06 03:52:55 +02002786
Bram Moolenaarc3308352019-09-01 16:24:56 +02002787// Flags for get_reg_contents
2788#define GREG_NO_EXPR 1 // Do not allow expression register
2789#define GREG_EXPR_SRC 2 // Return expression itself for "=" register
2790#define GREG_LIST 4 // Return list
Bram Moolenaarb7cb42b2014-04-02 19:55:10 +02002791
Bram Moolenaarc3308352019-09-01 16:24:56 +02002792// Character used as separated in autoload function/variable names.
Bram Moolenaar018acca2013-05-30 13:37:28 +02002793#define AUTOLOAD_CHAR '#'
2794
Bram Moolenaar509ce2a2016-03-11 22:52:15 +01002795#ifdef FEAT_JOB_CHANNEL
Bram Moolenaare0874f82016-01-24 20:36:41 +01002796# define MAX_OPEN_CHANNELS 10
2797#else
2798# define MAX_OPEN_CHANNELS 0
2799#endif
2800
Bram Moolenaar4f974752019-02-17 17:44:42 +01002801#if defined(MSWIN)
Bram Moolenaar24058382019-01-24 23:11:49 +01002802# define MAX_NAMED_PIPE_SIZE 65535
2803#endif
2804
Bram Moolenaarc3308352019-09-01 16:24:56 +02002805// Options for json_encode() and json_decode.
2806#define JSON_JS 1 // use JS instead of JSON
2807#define JSON_NO_NONE 2 // v:none item not allowed
2808#define JSON_NL 4 // append a NL
Bram Moolenaar595e64e2016-02-07 19:19:53 +01002809
Bram Moolenaarc3308352019-09-01 16:24:56 +02002810// Used for flags of do_in_path()
2811#define DIP_ALL 0x01 // all matches, not just the first one
2812#define DIP_DIR 0x02 // find directories instead of files.
2813#define DIP_ERR 0x04 // give an error message when none found.
2814#define DIP_START 0x08 // also use "start" directory in 'packpath'
2815#define DIP_OPT 0x10 // also use "opt" directory in 'packpath'
2816#define DIP_NORTP 0x20 // do not use 'runtimepath'
2817#define DIP_NOAFTER 0x40 // skip "after" directories
2818#define DIP_AFTER 0x80 // only use "after" directories
Bram Moolenaar6bef5302016-03-12 21:28:26 +01002819
Bram Moolenaarc3308352019-09-01 16:24:56 +02002820// Lowest number used for window ID. Cannot have this many windows.
Bram Moolenaar888ccac2016-06-04 18:49:36 +02002821#define LOWEST_WIN_ID 1000
2822
Bram Moolenaarc3308352019-09-01 16:24:56 +02002823// Used by the garbage collector.
Bram Moolenaarcd524592016-07-17 14:57:05 +02002824#define COPYID_INC 2
2825#define COPYID_MASK (~0x1)
2826
Bram Moolenaarc3308352019-09-01 16:24:56 +02002827// Values for trans_function_name() argument:
Bram Moolenaar8f22f5c2020-12-19 22:10:13 +01002828#define TFN_INT 0x01 // internal function name OK
2829#define TFN_QUIET 0x02 // no error messages
2830#define TFN_NO_AUTOLOAD 0x04 // do not use script autoloading
2831#define TFN_NO_DEREF 0x08 // do not dereference a Funcref
2832#define TFN_READ_ONLY 0x10 // will not change the var
2833#define TFN_NO_DECL 0x20 // only used for GLV_NO_DECL
Bram Moolenaar2ef951d2021-01-03 20:55:26 +01002834#define TFN_COMPILING 0x40 // only used for GLV_COMPILING
Bram Moolenaar937610b2022-01-19 17:21:29 +00002835#define TFN_NEW_FUNC 0x80 // defining a new function
Bram Moolenaarffdaca92022-12-09 21:41:48 +00002836#define TFN_ASSIGN_WITH_OP 0x100 // only for GLV_ASSIGN_WITH_OP
2837#define TFN_IN_CLASS 0x200 // function in a class
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002838
Bram Moolenaarc3308352019-09-01 16:24:56 +02002839// Values for get_lval() flags argument:
2840#define GLV_QUIET TFN_QUIET // no error messages
2841#define GLV_NO_AUTOLOAD TFN_NO_AUTOLOAD // do not use script autoloading
2842#define GLV_READ_ONLY TFN_READ_ONLY // will not change the var
Bram Moolenaar8f22f5c2020-12-19 22:10:13 +01002843#define GLV_NO_DECL TFN_NO_DECL // assignment without :var or :let
Bram Moolenaar2ef951d2021-01-03 20:55:26 +01002844#define GLV_COMPILING TFN_COMPILING // variable may be defined later
Bram Moolenaar22ebd172022-04-01 15:26:58 +01002845#define GLV_ASSIGN_WITH_OP TFN_ASSIGN_WITH_OP // assignment with operator
Bram Moolenaar99a7c0d2023-02-21 19:55:14 +00002846#define GLV_PREFER_FUNC 0x10000 // prefer function above variable
Yegappan Lakshmananb5a07192023-10-05 20:14:43 +02002847#define GLV_FOR_LOOP 0x20000 // assigning to a loop variable
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002848
Bram Moolenaarc3308352019-09-01 16:24:56 +02002849#define DO_NOT_FREE_CNT 99999 // refcount for dict or list that should not
2850 // be freed.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002851
Bram Moolenaar5cab73f2020-02-06 19:25:19 +01002852// fixed buffer length for fname_trans_sid()
2853#define FLEN_FIXED 40
2854
Bram Moolenaarc3308352019-09-01 16:24:56 +02002855// flags for find_name_end()
2856#define FNE_INCL_BR 1 // include [] in name
2857#define FNE_CHECK_START 2 // check name starts with valid character
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002858
Bram Moolenaarc3308352019-09-01 16:24:56 +02002859// BSD is supposed to cover FreeBSD and similar systems.
Bram Moolenaar1a2ab992017-11-28 21:06:18 +01002860#if (defined(SUN_SYSTEM) || defined(BSD) || defined(__FreeBSD_kernel__)) \
Bram Moolenaard569bb02018-08-11 13:57:20 +02002861 && (defined(S_ISCHR) || defined(S_IFCHR))
Bram Moolenaarf04507d2016-08-20 15:05:39 +02002862# define OPEN_CHR_FILES
2863#endif
2864
Bram Moolenaarc3308352019-09-01 16:24:56 +02002865// stat macros
Bram Moolenaard569bb02018-08-11 13:57:20 +02002866#ifndef S_ISDIR
2867# ifdef S_IFDIR
2868# define S_ISDIR(m) (((m) & S_IFMT) == S_IFDIR)
2869# else
2870# define S_ISDIR(m) 0
2871# endif
2872#endif
2873#ifndef S_ISREG
2874# ifdef S_IFREG
2875# define S_ISREG(m) (((m) & S_IFMT) == S_IFREG)
2876# else
2877# define S_ISREG(m) 0
2878# endif
2879#endif
2880#ifndef S_ISBLK
2881# ifdef S_IFBLK
2882# define S_ISBLK(m) (((m) & S_IFMT) == S_IFBLK)
2883# else
2884# define S_ISBLK(m) 0
2885# endif
2886#endif
2887#ifndef S_ISSOCK
2888# ifdef S_IFSOCK
2889# define S_ISSOCK(m) (((m) & S_IFMT) == S_IFSOCK)
2890# else
2891# define S_ISSOCK(m) 0
2892# endif
2893#endif
2894#ifndef S_ISFIFO
2895# ifdef S_IFIFO
2896# define S_ISFIFO(m) (((m) & S_IFMT) == S_IFIFO)
2897# else
2898# define S_ISFIFO(m) 0
2899# endif
2900#endif
2901#ifndef S_ISCHR
2902# ifdef S_IFCHR
2903# define S_ISCHR(m) (((m) & S_IFMT) == S_IFCHR)
2904# else
2905# define S_ISCHR(m) 0
2906# endif
2907#endif
2908#ifndef S_ISLNK
2909# ifdef S_IFLNK
2910# define S_ISLNK(m) (((m) & S_IFMT) == S_IFLNK)
2911# else
2912# define S_ISLNK(m) 0
2913# endif
2914#endif
2915
Bram Moolenaar833eb1d2016-11-24 17:22:50 +01002916#if defined(HAVE_GETTIMEOFDAY) && defined(HAVE_SYS_TIME_H)
2917# define ELAPSED_TIMEVAL
kylo2529dac9b12022-03-27 20:05:17 +01002918# define ELAPSED_INIT(v) gettimeofday(&(v), NULL)
2919# define ELAPSED_FUNC(v) elapsed(&(v))
Bram Moolenaar1ac56c22019-01-17 22:28:22 +01002920typedef struct timeval elapsed_T;
2921long elapsed(struct timeval *start_tv);
Bram Moolenaar4f974752019-02-17 17:44:42 +01002922#elif defined(MSWIN)
Bram Moolenaar1ac56c22019-01-17 22:28:22 +01002923# define ELAPSED_TICKCOUNT
2924# define ELAPSED_INIT(v) v = GetTickCount()
2925# define ELAPSED_FUNC(v) elapsed(v)
Bram Moolenaar1c321dc2019-02-01 20:42:22 +01002926# ifdef PROTO
2927typedef int DWORD;
2928# endif
Bram Moolenaar1ac56c22019-01-17 22:28:22 +01002929typedef DWORD elapsed_T;
2930# ifndef PROTO
2931long elapsed(DWORD start_tick);
Bram Moolenaar833eb1d2016-11-24 17:22:50 +01002932# endif
2933#endif
2934
Bram Moolenaarc3308352019-09-01 16:24:56 +02002935// Replacement for nchar used by nv_replace().
kylo2529dac9b12022-03-27 20:05:17 +01002936#define REPLACE_CR_NCHAR (-1)
2937#define REPLACE_NL_NCHAR (-2)
Bram Moolenaarf12519d2018-02-06 22:52:49 +01002938
Bram Moolenaarc3308352019-09-01 16:24:56 +02002939// flags for term_start()
Bram Moolenaar13568252018-03-16 20:46:58 +01002940#define TERM_START_NOJOB 1
2941#define TERM_START_FORCEIT 2
2942#define TERM_START_SYSTEM 4
2943
Bram Moolenaar40385db2018-08-07 22:31:44 +02002944// Used for icon/title save and restore.
2945#define SAVE_RESTORE_TITLE 1
2946#define SAVE_RESTORE_ICON 2
2947#define SAVE_RESTORE_BOTH (SAVE_RESTORE_TITLE | SAVE_RESTORE_ICON)
2948
Bram Moolenaarf3333b02019-05-19 22:53:40 +02002949// Flags for adjust_prop_columns()
2950#define APC_SAVE_FOR_UNDO 1 // call u_savesub() before making changes
2951#define APC_SUBSTITUTE 2 // text is replaced, not inserted
Bram Moolenaard8d4cfc2022-08-15 15:55:10 +01002952#define APC_INDENT 4 // changing indent
Bram Moolenaarf3333b02019-05-19 22:53:40 +02002953
Bram Moolenaarc662ec92019-06-23 00:15:57 +02002954#define CLIP_ZINDEX 32000
2955
Bram Moolenaar459fd782019-10-13 16:43:39 +02002956// Flags for replace_termcodes()
2957#define REPTERM_FROM_PART 1
2958#define REPTERM_DO_LT 2
2959#define REPTERM_SPECIAL 4
2960#define REPTERM_NO_SIMPLIFY 8
2961
Bram Moolenaarebe9d342020-05-30 21:52:54 +02002962// Flags for find_special_key()
2963#define FSK_KEYCODE 0x01 // prefer key code, e.g. K_DEL instead of DEL
2964#define FSK_KEEP_X_KEY 0x02 // don't translate xHome to Home key
2965#define FSK_IN_STRING 0x04 // TRUE in string, double quote is escaped
2966#define FSK_SIMPLIFY 0x08 // simplify <C-H> and <A-x>
Bram Moolenaar584b8532023-01-14 21:07:07 +00002967#define FSK_FROM_PART 0x10 // left-hand-side of mapping
Bram Moolenaarebe9d342020-05-30 21:52:54 +02002968
Bram Moolenaar84cf6bd2020-06-16 20:03:43 +02002969// Flags for the readdirex function, how to sort the result
2970#define READDIR_SORT_NONE 0 // do not sort
2971#define READDIR_SORT_BYTE 1 // sort by byte order (strcmp), default
2972#define READDIR_SORT_IC 2 // sort ignoring case (strcasecmp)
2973#define READDIR_SORT_COLLATE 3 // sort according to collation (strcoll)
2974
Bram Moolenaar0981c872020-08-23 14:28:37 +02002975// Flags for mch_delay.
2976#define MCH_DELAY_IGNOREINPUT 1
2977#define MCH_DELAY_SETTMODE 2
2978
Bram Moolenaarcb4e80f2021-03-13 20:57:19 +01002979// Flags for eval_variable().
2980#define EVAL_VAR_VERBOSE 1 // may give error message
2981#define EVAL_VAR_NOAUTOLOAD 2 // do not use script autoloading
2982#define EVAL_VAR_IMPORT 4 // may return special variable for import
Bram Moolenaar052ff292021-12-11 13:54:46 +00002983#define EVAL_VAR_NO_FUNC 8 // do not look for a function
Bram Moolenaarcb4e80f2021-03-13 20:57:19 +01002984
Yegappan Lakshmananbb01a1e2021-04-26 21:17:52 +02002985// Maximum number of characters that can be fuzzy matched
2986#define MAX_FUZZY_MATCHES 256
2987
Bram Moolenaar60dc8272021-07-29 22:48:54 +02002988// flags for equal_type()
2989#define ETYPE_ARG_UNKNOWN 1
2990
Bram Moolenaar73b8b0a2021-08-01 14:52:32 +02002991// flags used by user commands and :autocmd
2992#define UC_BUFFER 1 // -buffer: local to current buffer
2993#define UC_VIM9 2 // {} argument: Vim9 syntax.
2994
zeertzjqbb404f52022-07-23 06:25:29 +01002995// flags used by vim_strsave_fnameescape()
Bram Moolenaar21c1a0c2021-10-17 17:20:23 +01002996#define VSE_NONE 0
2997#define VSE_SHELL 1 // escape for a shell command
2998#define VSE_BUFFER 2 // escape for a ":buffer" command
Bram Moolenaar73b8b0a2021-08-01 14:52:32 +02002999
Bram Moolenaaracc4b562022-01-24 13:54:45 +00003000// Flags used by find_func_even_dead()
3001#define FFED_IS_GLOBAL 1 // "g:" was used
3002#define FFED_NO_GLOBAL 2 // only check for script-local functions
3003
Yegappan Lakshmanana061f342022-05-22 19:13:49 +01003004#define MAX_LSHIFT_BITS (varnumber_T)((sizeof(uvarnumber_T) * 8) - 1)
Bram Moolenaar113d9de2022-08-08 15:49:18 +01003005
Bram Moolenaar554d0312023-01-05 19:59:18 +00003006// Flags used by "class_flags" of define_function()
3007#define CF_CLASS 1 // inside a class
3008#define CF_INTERFACE 2 // inside an interface
Yegappan Lakshmanan7bcd25c2023-09-08 19:27:51 +02003009#define CF_ABSTRACT_METHOD 4 // inside an abstract class
Bram Moolenaar554d0312023-01-05 19:59:18 +00003010
Bram Moolenaarc3308352019-09-01 16:24:56 +02003011#endif // VIM__H