blob: b8569d85e2de852248a8c8faa12977a3065780d7 [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
Zoltan Arpadffy7cedae32025-03-24 20:31:12 +010090// C89 does not define SIZE_MAX
91#if defined(__hpux) || defined(VMS)
92# ifndef SIZE_MAX
93# define SIZE_MAX ((size_t)(-1))
94# endif
95#endif
96
Bram Moolenaarc3308352019-09-01 16:24:56 +020097// user ID of root is usually zero, but not for everybody
Bram Moolenaar311d9822007-02-27 15:48:28 +000098#ifdef __TANDEM
Bram Moolenaar25153e12010-02-24 14:47:08 +010099# ifndef _TANDEM_SOURCE
100# define _TANDEM_SOURCE
101# endif
Bram Moolenaar311d9822007-02-27 15:48:28 +0000102# include <floss.h>
103# define ROOT_UID 65535
Bram Moolenaar03305f32014-03-24 19:44:09 +0100104# define OLDXAW
105# if (_TANDEM_ARCH_ == 2 && __H_Series_RVU >= 621)
106# define SA_ONSTACK_COMPATIBILITY
107# endif
Bram Moolenaar311d9822007-02-27 15:48:28 +0000108#else
109# define ROOT_UID 0
110#endif
111
Sevan Janiyan063c5622023-09-18 20:04:32 +0200112/* Include MAC_OS_X_VERSION_* macros */
113#ifdef HAVE_AVAILABILITYMACROS_H
114# include <AvailabilityMacros.h>
115#endif
116
Bram Moolenaar071d4272004-06-13 20:20:40 +0000117/*
Bram Moolenaard0573012017-10-28 21:11:06 +0200118 * MACOS_X compiling for Mac OS X
119 * MACOS_X_DARWIN integrating the darwin feature into MACOS_X
Bram Moolenaar071d4272004-06-13 20:20:40 +0000120 */
Bram Moolenaard0573012017-10-28 21:11:06 +0200121#if defined(MACOS_X_DARWIN) && !defined(MACOS_X)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000122# define MACOS_X
Bram Moolenaar071d4272004-06-13 20:20:40 +0000123#endif
Bram Moolenaarc3308352019-09-01 16:24:56 +0200124// Unless made through the Makefile enforce GUI on Mac
Bram Moolenaard0573012017-10-28 21:11:06 +0200125#if defined(MACOS_X) && !defined(HAVE_CONFIG_H)
126# define UNIX
Bram Moolenaar071d4272004-06-13 20:20:40 +0000127#endif
128
Bram Moolenaar071d4272004-06-13 20:20:40 +0000129#if defined(FEAT_GUI_MOTIF) \
130 || defined(FEAT_GUI_GTK) \
Bram Moolenaarb3f74062020-02-26 16:16:53 +0100131 || defined(FEAT_GUI_HAIKU) \
Bram Moolenaar4f974752019-02-17 17:44:42 +0100132 || defined(FEAT_GUI_MSWIN) \
Bram Moolenaarcef9dcc2005-12-06 19:50:41 +0000133 || defined(FEAT_GUI_PHOTON)
Bram Moolenaarab79bcb2004-07-18 21:34:53 +0000134# if !defined(FEAT_GUI) && !defined(NO_X11_INCLUDES)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000135# define FEAT_GUI
136# endif
137#endif
138
Bram Moolenaarc3308352019-09-01 16:24:56 +0200139// Check support for rendering options
Bram Moolenaarb5a7a8b2014-08-06 14:52:30 +0200140#ifdef FEAT_GUI
141# if defined(FEAT_DIRECTX)
142# define FEAT_RENDER_OPTIONS
143# endif
144#endif
145
Bram Moolenaar071d4272004-06-13 20:20:40 +0000146/*
Bram Moolenaara2aa31a2014-02-23 22:52:40 +0100147 * VIM_SIZEOF_INT is used in feature.h, and the system-specific included files
148 * need items from feature.h. Therefore define VIM_SIZEOF_INT here.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000149 */
Bram Moolenaar4f974752019-02-17 17:44:42 +0100150#ifdef MSWIN
Bram Moolenaara2aa31a2014-02-23 22:52:40 +0100151# define VIM_SIZEOF_INT 4
Bram Moolenaar071d4272004-06-13 20:20:40 +0000152#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +0000153
154#ifdef AMIGA
Bram Moolenaarc3308352019-09-01 16:24:56 +0200155 // Be conservative about sizeof(int). It could be 4 too.
156# ifndef FEAT_GUI_GTK // avoid problems when generating prototypes
Bram Moolenaar071d4272004-06-13 20:20:40 +0000157# ifdef __GNUC__
Bram Moolenaara2aa31a2014-02-23 22:52:40 +0100158# define VIM_SIZEOF_INT 4
Bram Moolenaar071d4272004-06-13 20:20:40 +0000159# else
Bram Moolenaara2aa31a2014-02-23 22:52:40 +0100160# define VIM_SIZEOF_INT 2
Bram Moolenaar071d4272004-06-13 20:20:40 +0000161# endif
162# endif
163#endif
Bram Moolenaard0573012017-10-28 21:11:06 +0200164#if defined(MACOS_X) && !defined(HAVE_CONFIG_H)
165# define VIM_SIZEOF_INT __SIZEOF_INT__
Bram Moolenaar071d4272004-06-13 20:20:40 +0000166#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +0000167
Bram Moolenaar30276f22019-01-24 17:59:39 +0100168#if VIM_SIZEOF_INT < 4 && !defined(PROTO)
Bram Moolenaar2c02d382020-01-23 16:52:01 +0100169# error Vim only works with 32 bit int or larger
Bram Moolenaar30276f22019-01-24 17:59:39 +0100170#endif
171
Bram Moolenaarb822cb02016-07-30 14:12:23 +0200172/*
173 * #defines for optionals and features
Martin Tournoij7904fa42022-10-04 16:28:45 +0100174 * Also defines FEAT_TINY, FEAT_NORMAL, etc. when FEAT_HUGE is defined.
Bram Moolenaarb822cb02016-07-30 14:12:23 +0200175 */
176#include "feature.h"
177
Yee Cheng Chin4314e4f2022-10-08 13:50:05 +0100178#if defined(MACOS_X_DARWIN)
179# if defined(FEAT_NORMAL) && !defined(FEAT_CLIPBOARD)
180# define FEAT_CLIPBOARD
181# endif
Sevan Janiyan063c5622023-09-18 20:04:32 +0200182# if defined(FEAT_HUGE) && !defined(FEAT_SOUND) && \
Yee Cheng Chinf59cbef2023-10-02 21:28:50 +0200183 defined(__clang_major__) && __clang_major__ >= 7 && \
184 defined(MAC_OS_X_VERSION_MIN_REQUIRED) && MAC_OS_X_VERSION_MIN_REQUIRED >= 1060
Yee Cheng Chin4314e4f2022-10-08 13:50:05 +0100185# define FEAT_SOUND
186# endif
187# if defined(FEAT_SOUND)
188# define FEAT_SOUND_MACOSX
189# endif
Bram Moolenaarb822cb02016-07-30 14:12:23 +0200190#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +0000191
Bram Moolenaarc3308352019-09-01 16:24:56 +0200192// +x11 is only enabled when it's both available and wanted.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000193#if defined(HAVE_X11) && defined(WANT_X11)
194# define FEAT_X11
195#endif
196
Foxe Chenb90c2392025-06-27 21:10:35 +0200197#if defined(HAVE_WAYLAND) && defined(WANT_WAYLAND)
198#define FEAT_WAYLAND
199#endif
200
Bram Moolenaarab79bcb2004-07-18 21:34:53 +0000201#ifdef NO_X11_INCLUDES
Bram Moolenaarc3308352019-09-01 16:24:56 +0200202 // In os_mac_conv.c and os_macosx.m NO_X11_INCLUDES is defined to avoid
203 // X11 headers. Disable all X11 related things to avoid conflicts.
Bram Moolenaarab79bcb2004-07-18 21:34:53 +0000204# ifdef FEAT_X11
205# undef FEAT_X11
206# endif
Bram Moolenaared39e1d2008-08-09 17:55:22 +0000207# ifdef FEAT_GUI_X11
208# undef FEAT_GUI_X11
209# endif
Bram Moolenaarab79bcb2004-07-18 21:34:53 +0000210# ifdef FEAT_XCLIPBOARD
211# undef FEAT_XCLIPBOARD
212# endif
213# ifdef FEAT_GUI_MOTIF
214# undef FEAT_GUI_MOTIF
215# endif
Bram Moolenaarab79bcb2004-07-18 21:34:53 +0000216# ifdef FEAT_GUI_GTK
217# undef FEAT_GUI_GTK
218# endif
219# ifdef FEAT_BEVAL_TIP
220# undef FEAT_BEVAL_TIP
221# endif
222# ifdef FEAT_XIM
223# undef FEAT_XIM
224# endif
225# ifdef FEAT_CLIENTSERVER
226# undef FEAT_CLIENTSERVER
227# endif
228#endif
229
Bram Moolenaarc3308352019-09-01 16:24:56 +0200230// The Mac conversion stuff doesn't work under X11.
Bram Moolenaar264b74f2019-01-24 17:18:42 +0100231#if defined(MACOS_X_DARWIN)
Bram Moolenaardb003512006-03-15 22:48:35 +0000232# define MACOS_CONVERT
233#endif
234
Bram Moolenaarc3308352019-09-01 16:24:56 +0200235// Can't use "PACKAGE" here, conflicts with a Perl include file.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000236#ifndef VIMPACKAGE
237# define VIMPACKAGE "vim"
238#endif
239
240/*
241 * Find out if function definitions should include argument types
242 */
243#ifdef AZTEC_C
244# include <functions.h>
Bram Moolenaar071d4272004-06-13 20:20:40 +0000245#endif
246
247#ifdef SASC
248# include <clib/exec_protos.h>
Bram Moolenaar071d4272004-06-13 20:20:40 +0000249#endif
250
251#ifdef _DCC
252# include <clib/exec_protos.h>
Bram Moolenaar071d4272004-06-13 20:20:40 +0000253#endif
254
Bram Moolenaarb3f74062020-02-26 16:16:53 +0100255#ifdef __HAIKU__
256# include "os_haiku.h"
257# define __ARGS(x) x
258#endif
259
Bram Moolenaara06ecab2016-07-16 14:47:36 +0200260#if (defined(UNIX) || defined(VMS)) \
Bram Moolenaar071d4272004-06-13 20:20:40 +0000261 && (!defined(MACOS_X) || defined(HAVE_CONFIG_H))
Bram Moolenaarc3308352019-09-01 16:24:56 +0200262# include "os_unix.h" // bring lots of system header files
ichizok378447f2023-05-11 22:25:42 +0100263#else
264 // For all non-Unix systems: use old-fashioned signal().
265# define mch_signal(signum, sighandler) signal(signum, sighandler)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000266#endif
267
Bram Moolenaarc3308352019-09-01 16:24:56 +0200268// Mark unused function arguments with UNUSED, so that gcc -Wunused-parameter
269// can be used to check for mistakes.
ola.soder@axis.combd89d442022-02-11 19:27:55 +0000270#ifndef UNUSED
271# if defined(HAVE_ATTRIBUTE_UNUSED) || defined(__MINGW32__)
Bram Moolenaarb20b9e12019-09-21 20:48:04 +0200272# define UNUSED __attribute__((unused))
ola.soder@axis.combd89d442022-02-11 19:27:55 +0000273# else
274# if defined __has_attribute
275# if __has_attribute(unused)
276# define UNUSED __attribute__((unused))
277# endif
278# endif
Bram Moolenaarb20b9e12019-09-21 20:48:04 +0200279# endif
ola.soder@axis.combd89d442022-02-11 19:27:55 +0000280# ifndef UNUSED
281# define UNUSED
282# endif
Bram Moolenaar0c094b92009-05-14 20:20:33 +0000283#endif
284
Bram Moolenaarc3308352019-09-01 16:24:56 +0200285// Used to check for "sun", "__sun" is used by newer compilers.
Bram Moolenaara899e6e2016-12-03 16:40:51 +0100286#if defined(__sun)
287# define SUN_SYSTEM
288#endif
289
Bram Moolenaarc3308352019-09-01 16:24:56 +0200290// If we're compiling in C++ (currently only KVim), the system
291// headers must have the correct prototypes or nothing will build.
292// Conversely, our prototypes might clash due to throw() specifiers and
293// cause compilation failures even though the headers are correct. For
294// a concrete example, gcc-3.2 enforces exception specifications, and
295// glibc-2.2.5 has them in their system headers.
Bram Moolenaar843ee412004-06-30 16:16:41 +0000296#if !defined(__cplusplus) && defined(UNIX) \
Bram Moolenaarc3308352019-09-01 16:24:56 +0200297 && !defined(MACOS_X) // MACOS_X doesn't yet support osdef.h
298# include "auto/osdef.h" // bring missing declarations in
Bram Moolenaar071d4272004-06-13 20:20:40 +0000299#endif
300
Bram Moolenaar071d4272004-06-13 20:20:40 +0000301#ifdef AMIGA
302# include "os_amiga.h"
303#endif
304
Bram Moolenaar4f974752019-02-17 17:44:42 +0100305#ifdef MSWIN
Bram Moolenaar071d4272004-06-13 20:20:40 +0000306# include "os_win32.h"
307#endif
308
Bram Moolenaard0573012017-10-28 21:11:06 +0200309#if defined(MACOS_X)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000310# include "os_mac.h"
311#endif
312
Bram Moolenaar071d4272004-06-13 20:20:40 +0000313#ifdef __QNX__
314# include "os_qnx.h"
315#endif
316
Bram Moolenaar071d4272004-06-13 20:20:40 +0000317#ifdef X_LOCALE
318# include <X11/Xlocale.h>
319#else
320# ifdef HAVE_LOCALE_H
321# include <locale.h>
322# endif
323#endif
324
325/*
326 * Maximum length of a path (for non-unix systems) Make it a bit long, to stay
327 * on the safe side. But not too long to put on the stack.
328 */
329#ifndef MAXPATHL
330# ifdef MAXPATHLEN
331# define MAXPATHL MAXPATHLEN
332# else
333# define MAXPATHL 256
334# endif
335#endif
336#ifdef BACKSLASH_IN_FILENAME
Bram Moolenaaraebaf892008-05-28 14:49:58 +0000337# define PATH_ESC_CHARS ((char_u *)" \t\n*?[{`%#'\"|!<")
Bram Moolenaar21c1a0c2021-10-17 17:20:23 +0100338# define BUFFER_ESC_CHARS ((char_u *)" \t\n*?[`%#'\"|!<")
Bram Moolenaar071d4272004-06-13 20:20:40 +0000339#else
Bram Moolenaar03cd93a2008-11-20 09:27:32 +0000340# ifdef VMS
Bram Moolenaarc3308352019-09-01 16:24:56 +0200341 // VMS allows a lot of characters in the file name
Bram Moolenaar03cd93a2008-11-20 09:27:32 +0000342# define PATH_ESC_CHARS ((char_u *)" \t\n*?{`\\%#'\"|!")
343# define SHELL_ESC_CHARS ((char_u *)" \t\n*?{`\\%#'|!()&")
344# else
345# define PATH_ESC_CHARS ((char_u *)" \t\n*?[{`$\\%#'\"|!<")
346# define SHELL_ESC_CHARS ((char_u *)" \t\n*?[{`$\\%#'\"|!<>();&")
347# endif
Bram Moolenaar21c1a0c2021-10-17 17:20:23 +0100348# define BUFFER_ESC_CHARS ((char_u *)" \t\n*?[`$\\%#'\"|!<")
Bram Moolenaar071d4272004-06-13 20:20:40 +0000349#endif
350
Bram Moolenaarc3308352019-09-01 16:24:56 +0200351// length of a buffer to store a number in ASCII (64 bits binary + NUL)
Bram Moolenaar887c1fe2016-01-02 17:56:35 +0100352#define NUMBUFLEN 65
353
Bram Moolenaarc3308352019-09-01 16:24:56 +0200354// flags for vim_str2nr()
Bram Moolenaarc17e66c2020-06-02 21:38:22 +0200355#define STR2NR_BIN 0x01
356#define STR2NR_OCT 0x02
357#define STR2NR_HEX 0x04
358#define STR2NR_OOCT 0x08 // Octal with prefix "0o": 0o777
359#define STR2NR_ALL (STR2NR_BIN + STR2NR_OCT + STR2NR_HEX + STR2NR_OOCT)
360#define STR2NR_NO_OCT (STR2NR_BIN + STR2NR_HEX + STR2NR_OOCT)
Bram Moolenaar60a8de22019-09-15 14:33:22 +0200361
362#define STR2NR_FORCE 0x80 // only when ONE of the above is used
363
364#define STR2NR_QUOTE 0x10 // ignore embedded single quotes
Bram Moolenaar071d4272004-06-13 20:20:40 +0000365
366/*
367 * Shorthand for unsigned variables. Many systems, but not all, have u_char
368 * already defined, so we use char_u to avoid trouble.
369 */
370typedef unsigned char char_u;
371typedef unsigned short short_u;
372typedef unsigned int int_u;
Bram Moolenaar88c86eb2019-01-17 17:13:30 +0100373
Bram Moolenaarc3308352019-09-01 16:24:56 +0200374// Make sure long_u is big enough to hold a pointer.
375// On Win64, longs are 32 bits and pointers are 64 bits.
376// For printf() and scanf(), we need to take care of long_u specifically.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000377#ifdef _WIN64
Bram Moolenaar55d5c032010-07-17 23:52:29 +0200378typedef unsigned __int64 long_u;
379typedef __int64 long_i;
Bram Moolenaard695ba72020-05-10 13:42:43 +0200380# define SCANF_HEX_LONG_U "%llx"
381# define SCANF_DECIMAL_LONG_U "%llu"
382# define PRINTF_HEX_LONG_U "0x%llx"
Bram Moolenaar071d4272004-06-13 20:20:40 +0000383#else
K.Takata250155a2022-01-26 11:16:52 +0000384typedef unsigned long long_u;
385typedef long long_i;
Bram Moolenaarcb4cef22008-03-16 15:04:34 +0000386# define SCANF_HEX_LONG_U "%lx"
387# define SCANF_DECIMAL_LONG_U "%lu"
388# define PRINTF_HEX_LONG_U "0x%lx"
Bram Moolenaar071d4272004-06-13 20:20:40 +0000389#endif
Bram Moolenaarcb4cef22008-03-16 15:04:34 +0000390#define PRINTF_DECIMAL_LONG_U SCANF_DECIMAL_LONG_U
Bram Moolenaar071d4272004-06-13 20:20:40 +0000391
392/*
Bram Moolenaara2aa31a2014-02-23 22:52:40 +0100393 * Only systems which use configure will have SIZEOF_OFF_T and VIM_SIZEOF_LONG
Bram Moolenaar914703b2010-05-31 21:59:46 +0200394 * defined, which is ok since those are the same systems which can have
395 * varying sizes for off_t. The other systems will continue to use "%ld" to
396 * print off_t since off_t is simply a typedef to long for them.
397 */
Bram Moolenaara2aa31a2014-02-23 22:52:40 +0100398#if defined(SIZEOF_OFF_T) && (SIZEOF_OFF_T > VIM_SIZEOF_LONG)
Bram Moolenaar914703b2010-05-31 21:59:46 +0200399# define LONG_LONG_OFF_T
400#endif
401
402/*
Bram Moolenaar8767f522016-07-01 17:17:39 +0200403 * We use 64-bit file functions here, if available. E.g. ftello() returns
404 * off_t instead of long, which helps if long is 32 bit and off_t is 64 bit.
405 * We assume that when fseeko() is available then ftello() is too.
406 * Note that Windows has different function names.
407 */
zeertzjq44068e92022-06-16 11:14:55 +0100408#if defined(MSWIN) && !defined(PROTO)
Bram Moolenaar8767f522016-07-01 17:17:39 +0200409typedef __int64 off_T;
410# ifdef __MINGW32__
411# define vim_lseek lseek64
412# define vim_fseek fseeko64
413# define vim_ftell ftello64
414# else
415# define vim_lseek _lseeki64
416# define vim_fseek _fseeki64
417# define vim_ftell _ftelli64
418# endif
419#else
Bram Moolenaard90b6c02016-08-28 18:10:45 +0200420# ifdef PROTO
421typedef long off_T;
422# else
Bram Moolenaar8767f522016-07-01 17:17:39 +0200423typedef off_t off_T;
Bram Moolenaard90b6c02016-08-28 18:10:45 +0200424# endif
Bram Moolenaar8767f522016-07-01 17:17:39 +0200425# ifdef HAVE_FSEEKO
426# define vim_lseek lseek
427# define vim_ftell ftello
428# define vim_fseek fseeko
429# else
430# define vim_lseek lseek
431# define vim_ftell ftell
432# define vim_fseek(a, b, c) fseek(a, (long)b, c)
433# endif
434#endif
435
436/*
Bram Moolenaar071d4272004-06-13 20:20:40 +0000437 * The characters and attributes cached for the screen.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000438 */
Bram Moolenaar7e8fd632006-02-18 22:14:51 +0000439typedef char_u schar_T;
Bram Moolenaar3918c952005-03-15 22:34:55 +0000440typedef unsigned short sattr_T;
Bram Moolenaar9f45ccd2017-09-02 20:40:35 +0200441#define MAX_TYPENR 65535
Bram Moolenaar071d4272004-06-13 20:20:40 +0000442
443/*
444 * The u8char_T can hold one decoded UTF-8 character.
Bram Moolenaar9ba61172019-01-24 18:20:17 +0100445 * We use 32 bits, since some Asian characters don't fit in 16 bits.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000446 */
Bram Moolenaar9ba61172019-01-24 18:20:17 +0100447typedef unsigned int u8char_T; // int is 32 bits or more
Bram Moolenaar071d4272004-06-13 20:20:40 +0000448
Ernie Raelfda700c2023-11-30 18:20:00 +0100449/*
450 * The vimlong_T has sizeof(vimlong_T) >= 2 * sizeof(int).
451 * One use is simple handling of overflow in int calculations.
452 */
Zoltan Arpadffy1c8e2332023-12-05 16:04:23 +0100453#if defined(VMS) && defined(VAX)
454// unsupported compiler
455typedef long vimlong_T;
456#else
Ernie Raelfda700c2023-11-30 18:20:00 +0100457typedef long long vimlong_T;
Zoltan Arpadffy1c8e2332023-12-05 16:04:23 +0100458#endif
Ernie Raelfda700c2023-11-30 18:20:00 +0100459
Bram Moolenaarc3308352019-09-01 16:24:56 +0200460#ifndef UNIX // For Unix this is included in os_unix.h
Bram Moolenaar071d4272004-06-13 20:20:40 +0000461# include <stdio.h>
462# include <ctype.h>
463#endif
464
465#include "ascii.h"
466#include "keymap.h"
Bram Moolenaar1d69ef42021-11-19 11:35:32 +0000467#include "termdefs.h"
Bram Moolenaar071d4272004-06-13 20:20:40 +0000468#include "macros.h"
469
470#ifdef LATTICE
471# include <sys/types.h>
472# include <sys/stat.h>
473#endif
474#ifdef _DCC
475# include <sys/stat.h>
476#endif
Bram Moolenaar48e330a2016-02-23 14:53:34 +0100477#if defined(MSWIN)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000478# include <sys/stat.h>
479#endif
480
Bram Moolenaar4f974752019-02-17 17:44:42 +0100481#if defined(HAVE_ERRNO_H) || defined(MSWIN)
Bram Moolenaarb57aa922010-12-17 20:24:01 +0100482# include <errno.h>
483#endif
484
Bram Moolenaar071d4272004-06-13 20:20:40 +0000485/*
486 * Allow other (non-unix) systems to configure themselves now
487 * These are also in os_unix.h, because osdef.sh needs them there.
488 */
489#ifndef UNIX
Bram Moolenaarc3308352019-09-01 16:24:56 +0200490// Note: Some systems need both string.h and strings.h (Savage). If the
491// system can't handle this, define NO_STRINGS_WITH_STRING_H.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000492# ifdef HAVE_STRING_H
493# include <string.h>
494# endif
495# if defined(HAVE_STRINGS_H) && !defined(NO_STRINGS_WITH_STRING_H)
Bram Moolenaar08ed30e2013-01-17 17:17:26 +0100496# include <strings.h>
Bram Moolenaar071d4272004-06-13 20:20:40 +0000497# endif
498# ifdef HAVE_STAT_H
499# include <stat.h>
500# endif
501# ifdef HAVE_STDLIB_H
502# include <stdlib.h>
503# endif
Bram Moolenaarc3308352019-09-01 16:24:56 +0200504#endif // NON-UNIX
Bram Moolenaar071d4272004-06-13 20:20:40 +0000505
506#include <assert.h>
507
Bram Moolenaarfa7584c2010-05-19 21:57:45 +0200508#ifdef HAVE_STDINT_H
509# include <stdint.h>
510#endif
511#ifdef HAVE_INTTYPES_H
512# include <inttypes.h>
513#endif
Bram Moolenaar8fef2ad2005-04-23 20:42:23 +0000514#ifdef HAVE_WCTYPE_H
515# include <wctype.h>
516#endif
Bram Moolenaarba4ef272016-01-30 21:48:49 +0100517#include <stdarg.h>
Zoltan Arpadffy1c8e2332023-12-05 16:04:23 +0100518// older compilers do not define va_copy
519#ifndef va_copy
520# define va_copy(dst, src) ((dst) = (src))
521#endif
Bram Moolenaar8fef2ad2005-04-23 20:42:23 +0000522
Bram Moolenaarc3308352019-09-01 16:24:56 +0200523// for offsetof()
Bram Moolenaar84026842016-07-17 20:37:43 +0200524#include <stddef.h>
525
Bram Moolenaar08ed30e2013-01-17 17:17:26 +0100526#if defined(HAVE_SYS_SELECT_H) && \
Bram Moolenaar581f6dc2010-03-10 16:12:48 +0100527 (!defined(HAVE_SYS_TIME_H) || defined(SYS_SELECT_WITH_SYS_TIME))
Bram Moolenaar08ed30e2013-01-17 17:17:26 +0100528# include <sys/select.h>
529#endif
Bram Moolenaar581f6dc2010-03-10 16:12:48 +0100530
Bram Moolenaar08ed30e2013-01-17 17:17:26 +0100531#ifndef HAVE_SELECT
532# ifdef HAVE_SYS_POLL_H
533# include <sys/poll.h>
Bram Moolenaar4f974752019-02-17 17:44:42 +0100534# elif defined(MSWIN)
Bram Moolenaarf12d9832016-01-29 21:11:25 +0100535# define HAVE_SELECT
Bram Moolenaar08ed30e2013-01-17 17:17:26 +0100536# else
537# ifdef HAVE_POLL_H
538# include <poll.h>
Bram Moolenaar581f6dc2010-03-10 16:12:48 +0100539# endif
540# endif
Bram Moolenaar08ed30e2013-01-17 17:17:26 +0100541#endif
Bram Moolenaar581f6dc2010-03-10 16:12:48 +0100542
Bram Moolenaar131530a2021-07-29 20:37:49 +0200543#ifdef HAVE_SODIUM
544# include <sodium.h>
545#endif
546
Bram Moolenaarc3308352019-09-01 16:24:56 +0200547// ================ end of the header file puzzle ===============
Bram Moolenaar071d4272004-06-13 20:20:40 +0000548
549/*
550 * For dynamically loaded imm library. Currently, only for Win32.
551 */
552#ifdef DYNAMIC_IME
553# ifndef FEAT_MBYTE_IME
554# define FEAT_MBYTE_IME
555# endif
556#endif
557
558/*
Bram Moolenaar071d4272004-06-13 20:20:40 +0000559 * For dynamically loaded gettext library. Currently, only for Win32.
560 */
561#ifdef DYNAMIC_GETTEXT
562# ifndef FEAT_GETTEXT
563# define FEAT_GETTEXT
564# endif
Bram Moolenaarc3308352019-09-01 16:24:56 +0200565// These are in os_win32.c
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000566extern char *(*dyn_libintl_gettext)(const char *msgid);
Bram Moolenaaree695f72016-08-03 22:08:45 +0200567extern char *(*dyn_libintl_ngettext)(const char *msgid, const char *msgid_plural, unsigned long n);
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000568extern char *(*dyn_libintl_bindtextdomain)(const char *domainname, const char *dirname);
569extern char *(*dyn_libintl_bind_textdomain_codeset)(const char *domainname, const char *codeset);
570extern char *(*dyn_libintl_textdomain)(const char *domainname);
Bram Moolenaar0eb035c2019-04-02 22:15:55 +0200571extern int (*dyn_libintl_wputenv)(const wchar_t *envstring);
Bram Moolenaar071d4272004-06-13 20:20:40 +0000572#endif
573
574
575/*
576 * The _() stuff is for using gettext(). It is a no-op when libintl.h is not
577 * found or the +multilang feature is disabled.
Bram Moolenaarda6e8912018-08-21 15:12:14 +0200578 * Use NGETTEXT(single, multi, number) to get plural behavior:
579 * - single - message for singular form
580 * - multi - message for plural form
581 * - number - the count
Bram Moolenaar071d4272004-06-13 20:20:40 +0000582 */
583#ifdef FEAT_GETTEXT
584# ifdef DYNAMIC_GETTEXT
585# define _(x) (*dyn_libintl_gettext)((char *)(x))
Bram Moolenaar1c465442017-03-12 20:10:05 +0100586# define NGETTEXT(x, xs, n) (*dyn_libintl_ngettext)((char *)(x), (char *)(xs), (n))
Bram Moolenaar071d4272004-06-13 20:20:40 +0000587# define N_(x) x
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000588# define bindtextdomain(domain, dir) (*dyn_libintl_bindtextdomain)((domain), (dir))
589# define bind_textdomain_codeset(domain, codeset) (*dyn_libintl_bind_textdomain_codeset)((domain), (codeset))
590# if !defined(HAVE_BIND_TEXTDOMAIN_CODESET)
591# define HAVE_BIND_TEXTDOMAIN_CODESET 1
592# endif
Bram Moolenaar071d4272004-06-13 20:20:40 +0000593# define textdomain(domain) (*dyn_libintl_textdomain)(domain)
Bram Moolenaar7c23d1d2017-02-01 13:14:16 +0100594# define libintl_wputenv(envstring) (*dyn_libintl_wputenv)(envstring)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000595# else
596# include <libintl.h>
597# define _(x) gettext((char *)(x))
Bram Moolenaar1c465442017-03-12 20:10:05 +0100598# define NGETTEXT(x, xs, n) ngettext((x), (xs), (n))
Bram Moolenaar071d4272004-06-13 20:20:40 +0000599# ifdef gettext_noop
600# define N_(x) gettext_noop(x)
601# else
602# define N_(x) x
603# endif
604# endif
605#else
606# define _(x) ((char *)(x))
Bram Moolenaar1c465442017-03-12 20:10:05 +0100607# define NGETTEXT(x, xs, n) (((n) == 1) ? (char *)(x) : (char *)(xs))
Bram Moolenaar071d4272004-06-13 20:20:40 +0000608# define N_(x) x
609# ifdef bindtextdomain
610# undef bindtextdomain
611# endif
Christ van Willegen8252ef12024-07-11 21:36:21 +0200612# define bindtextdomain(x, y) ""
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000613# ifdef bind_textdomain_codeset
614# undef bind_textdomain_codeset
615# endif
Bram Moolenaarc3308352019-09-01 16:24:56 +0200616# define bind_textdomain_codeset(x, y) // empty
Bram Moolenaar071d4272004-06-13 20:20:40 +0000617# ifdef textdomain
618# undef textdomain
619# endif
Bram Moolenaarc3308352019-09-01 16:24:56 +0200620# define textdomain(x) // empty
Bram Moolenaar071d4272004-06-13 20:20:40 +0000621#endif
622
623/*
Bram Moolenaara4d158b2022-08-14 14:17:45 +0100624 * Flags for update_screen().
625 * The higher the value, the higher the priority.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000626 */
Bram Moolenaara4d158b2022-08-14 14:17:45 +0100627#define UPD_VALID_NO_UPDATE 5 // no new changes, keep the command line if
Bram Moolenaarc3308352019-09-01 16:24:56 +0200628 // possible
Bram Moolenaara4d158b2022-08-14 14:17:45 +0100629#define UPD_VALID 10 // buffer not changed, or changes marked
Bram Moolenaarc3308352019-09-01 16:24:56 +0200630 // with b_mod_*
Bram Moolenaara4d158b2022-08-14 14:17:45 +0100631#define UPD_INVERTED 20 // redisplay inverted part that changed
632#define UPD_INVERTED_ALL 25 // redisplay whole inverted part
633#define UPD_REDRAW_TOP 30 // display first w_upd_rows screen lines
634#define UPD_SOME_VALID 35 // like UPD_NOT_VALID but may scroll
635#define UPD_NOT_VALID 40 // buffer needs complete redraw
636#define UPD_CLEAR 50 // screen messed up, clear it
Bram Moolenaar071d4272004-06-13 20:20:40 +0000637
Bram Moolenaar7528d1f2019-09-19 23:06:20 +0200638// flags for screen_line()
639#define SLF_RIGHTLEFT 1
640#define SLF_POPUP 2
zeertzjqd0c1b772024-03-16 15:03:33 +0100641#define SLF_INC_VCOL 4
Bram Moolenaar7528d1f2019-09-19 23:06:20 +0200642
643#define MB_FILLER_CHAR '<' // character used when a double-width character
644 // doesn't fit.
645
Bram Moolenaar071d4272004-06-13 20:20:40 +0000646/*
Bram Moolenaar071d4272004-06-13 20:20:40 +0000647 * Flags for w_valid.
648 * These are set when something in a window structure becomes invalid, except
649 * when the cursor is moved. Call check_cursor_moved() before testing one of
650 * the flags.
651 * These are reset when that thing has been updated and is valid again.
652 *
653 * Every function that invalidates one of these must call one of the
654 * invalidate_* functions.
655 *
656 * w_valid is supposed to be used only in screen.c. From other files, use the
657 * functions that set or reset the flags.
658 *
659 * VALID_BOTLINE VALID_BOTLINE_AP
660 * on on w_botline valid
661 * off on w_botline approximated
662 * off off w_botline not valid
663 * on off not possible
664 */
Bram Moolenaar4d784b22019-05-25 19:51:39 +0200665#define VALID_WROW 0x01 // w_wrow (window row) is valid
666#define VALID_WCOL 0x02 // w_wcol (window col) is valid
667#define VALID_VIRTCOL 0x04 // w_virtcol (file col) is valid
668#define VALID_CHEIGHT 0x08 // w_cline_height and w_cline_folded valid
669#define VALID_CROW 0x10 // w_cline_row is valid
Jaehwang Jungeb80b832024-04-26 18:48:48 +0200670#define VALID_BOTLINE 0x20 // w_botline and w_empty_rows are valid
671#define VALID_BOTLINE_AP 0x40 // w_botline is approximated
Bram Moolenaar4d784b22019-05-25 19:51:39 +0200672#define VALID_TOPLINE 0x80 // w_topline is valid (for cursor position)
Bram Moolenaar2cd0dce2019-05-26 22:17:52 +0200673
674// Values for w_popup_flags.
Bram Moolenaar9bcb70c2019-08-01 21:11:05 +0200675#define POPF_IS_POPUP 0x01 // this is a popup window
676#define POPF_HIDDEN 0x02 // popup is not displayed
Bram Moolenaar27724252022-05-08 15:00:04 +0100677#define POPF_HIDDEN_FORCE 0x04 // popup is explicitly set to not be displayed
678#define POPF_CURSORLINE 0x08 // popup is highlighting at the cursorline
679#define POPF_ON_CMDLINE 0x10 // popup overlaps command line
680#define POPF_DRAG 0x20 // popup can be moved by dragging border
681#define POPF_DRAGALL 0x40 // popup can be moved by dragging everywhere
682#define POPF_RESIZE 0x80 // popup can be resized by dragging
683#define POPF_MAPPING 0x100 // mapping keys
684#define POPF_INFO 0x200 // used for info of popup menu
685#define POPF_INFO_MENU 0x400 // align info popup with popup menu
686#define POPF_POSINVERT 0x800 // vertical position can be inverted
Bram Moolenaarafe45b62019-11-13 22:35:19 +0100687
688// flags used in w_popup_handled
689#define POPUP_HANDLED_1 0x01 // used by mouse_find_win()
690#define POPUP_HANDLED_2 0x02 // used by popup_do_filter()
691#define POPUP_HANDLED_3 0x04 // used by popup_check_cursor_pos()
692#define POPUP_HANDLED_4 0x08 // used by may_update_popup_mask()
693#define POPUP_HANDLED_5 0x10 // used by update_popups()
Bram Moolenaar13d5c3f2019-07-28 21:42:38 +0200694
Bram Moolenaar071d4272004-06-13 20:20:40 +0000695/*
696 * Terminal highlighting attribute bits.
Bram Moolenaar42b4dda2010-03-02 15:56:05 +0100697 * Attributes above HL_ALL are used for syntax highlighting.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000698 */
699#define HL_NORMAL 0x00
700#define HL_INVERSE 0x01
701#define HL_BOLD 0x02
702#define HL_ITALIC 0x04
703#define HL_UNDERLINE 0x08
Bram Moolenaar3918c952005-03-15 22:34:55 +0000704#define HL_UNDERCURL 0x10
Bram Moolenaar84f54632022-06-29 18:39:11 +0100705#define HL_UNDERDOUBLE 0x20
706#define HL_UNDERDOTTED 0x40
707#define HL_UNDERDASHED 0x80
708#define HL_STANDOUT 0x100
709#define HL_NOCOMBINE 0x200
710#define HL_STRIKETHROUGH 0x400
711#define HL_ALL 0x7ff
Bram Moolenaar071d4272004-06-13 20:20:40 +0000712
Bram Moolenaarc3308352019-09-01 16:24:56 +0200713// special attribute addition: Put message in history
Bram Moolenaar071d4272004-06-13 20:20:40 +0000714#define MSG_HIST 0x1000
715
716/*
Bram Moolenaar24959102022-05-07 20:01:16 +0100717 * Values for State.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000718 *
Bram Moolenaar24959102022-05-07 20:01:16 +0100719 * The lower bits up to 0x80 are used to distinguish normal/visual/op_pending
720 * /cmdline/insert/replace/terminal mode. This is used for mapping. If none
721 * of these bits are set, no mapping is done. See the comment above do_map().
722 * The upper bits are used to distinguish between other states and variants of
723 * the base modes.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000724 */
Bram Moolenaar24959102022-05-07 20:01:16 +0100725#define MODE_NORMAL 0x01 // Normal mode, command expected
726#define MODE_VISUAL 0x02 // Visual mode - use get_real_state()
727#define MODE_OP_PENDING 0x04 // Normal mode, operator is pending - use
Bram Moolenaarc3308352019-09-01 16:24:56 +0200728 // get_real_state()
Bram Moolenaar24959102022-05-07 20:01:16 +0100729#define MODE_CMDLINE 0x08 // Editing the command line
730#define MODE_INSERT 0x10 // Insert mode, also for Replace mode
731#define MODE_LANGMAP 0x20 // Language mapping, can be combined with
732 // MODE_INSERT and MODE_CMDLINE
733#define MODE_SELECT 0x40 // Select mode, use get_real_state()
734#define MODE_TERMINAL 0x80 // Terminal mode
Bram Moolenaar071d4272004-06-13 20:20:40 +0000735
Bram Moolenaar24959102022-05-07 20:01:16 +0100736#define MAP_ALL_MODES 0xff // all mode bits used for mapping
Bram Moolenaar071d4272004-06-13 20:20:40 +0000737
Bram Moolenaar24959102022-05-07 20:01:16 +0100738#define REPLACE_FLAG 0x100 // Replace mode flag
739#define MODE_REPLACE (REPLACE_FLAG | MODE_INSERT)
740#define VREPLACE_FLAG 0x200 // Virtual-replace mode flag
741#define MODE_VREPLACE (REPLACE_FLAG | VREPLACE_FLAG | MODE_INSERT)
742#define MODE_LREPLACE (REPLACE_FLAG | MODE_LANGMAP)
743
744#define MODE_NORMAL_BUSY (0x1000 | MODE_NORMAL)
745 // Normal mode, busy with a command
746#define MODE_HITRETURN (0x2000 | MODE_NORMAL)
747 // waiting for return or command
748#define MODE_ASKMORE 0x3000 // Asking if you want --more--
749#define MODE_SETWSIZE 0x4000 // window size has changed
750#define MODE_EXTERNCMD 0x5000 // executing an external command
751#define MODE_SHOWMATCH (0x6000 | MODE_INSERT) // show matching paren
752#define MODE_CONFIRM 0x7000 // ":confirm" prompt
Bram Moolenaar581ba392019-09-03 22:08:33 +0200753#define MODE_ALL 0xffff
Bram Moolenaar071d4272004-06-13 20:20:40 +0000754
Bram Moolenaar24959102022-05-07 20:01:16 +0100755#define MODE_MAX_LENGTH 4 // max mode length used by get_mode(),
756 // including the terminating NUL
Bram Moolenaar149667a2006-06-23 14:33:23 +0000757
Bram Moolenaarc3308352019-09-01 16:24:56 +0200758// directions
Bram Moolenaar071d4272004-06-13 20:20:40 +0000759#define FORWARD 1
760#define BACKWARD (-1)
761#define FORWARD_FILE 3
762#define BACKWARD_FILE (-3)
763
Bram Moolenaarc3308352019-09-01 16:24:56 +0200764// return values for functions
Bram Moolenaar071d4272004-06-13 20:20:40 +0000765#if !(defined(OK) && (OK == 1))
Bram Moolenaarc3308352019-09-01 16:24:56 +0200766// OK already defined to 1 in MacOS X curses, skip this
Bram Moolenaar071d4272004-06-13 20:20:40 +0000767# define OK 1
768#endif
769#define FAIL 0
Bram Moolenaarc3308352019-09-01 16:24:56 +0200770#define NOTDONE 2 // not OK or FAIL but skipped
Bram Moolenaar071d4272004-06-13 20:20:40 +0000771
Bram Moolenaarc3308352019-09-01 16:24:56 +0200772// flags for b_flags
Bram Moolenaarc7f1e402019-08-03 13:29:46 +0200773#define BF_RECOVERED 0x01 // buffer has been recovered
774#define BF_CHECK_RO 0x02 // need to check readonly when loading file
775 // into buffer (set by ":e", may be reset by
776 // ":buf"
777#define BF_NEVERLOADED 0x04 // file has never been loaded into buffer,
778 // many variables still need to be set
779#define BF_NOTEDITED 0x08 // Set when file name is changed after
780 // starting to edit, reset when file is
781 // written out.
782#define BF_NEW 0x10 // file didn't exist when editing started
783#define BF_NEW_W 0x20 // Warned for BF_NEW and file created
784#define BF_READERR 0x40 // got errors while reading the file
785#define BF_DUMMY 0x80 // dummy buffer, only used internally
786#define BF_PRESERVED 0x100 // ":preserve" was used
787#define BF_SYN_SET 0x200 // 'syntax' option was set
Bram Moolenaar2debf1c2019-08-04 20:44:19 +0200788#define BF_NO_SEA 0x400 // no swap_exists_action (ATTENTION prompt)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000789
Bram Moolenaarc3308352019-09-01 16:24:56 +0200790// Mask to check for flags that prevent normal writing
Bram Moolenaar071d4272004-06-13 20:20:40 +0000791#define BF_WRITE_MASK (BF_NOTEDITED + BF_NEW + BF_READERR)
792
793/*
794 * values for xp_context when doing command line completion
795 */
Bram Moolenaar071d4272004-06-13 20:20:40 +0000796#define EXPAND_UNSUCCESSFUL (-2)
797#define EXPAND_OK (-1)
798#define EXPAND_NOTHING 0
799#define EXPAND_COMMANDS 1
800#define EXPAND_FILES 2
801#define EXPAND_DIRECTORIES 3
802#define EXPAND_SETTINGS 4
803#define EXPAND_BOOL_SETTINGS 5
804#define EXPAND_TAGS 6
805#define EXPAND_OLD_SETTING 7
806#define EXPAND_HELP 8
807#define EXPAND_BUFFERS 9
808#define EXPAND_EVENTS 10
809#define EXPAND_MENUS 11
810#define EXPAND_SYNTAX 12
811#define EXPAND_HIGHLIGHT 13
812#define EXPAND_AUGROUP 14
813#define EXPAND_USER_VARS 15
814#define EXPAND_MAPPINGS 16
815#define EXPAND_TAGS_LISTFILES 17
816#define EXPAND_FUNCTIONS 18
817#define EXPAND_USER_FUNC 19
818#define EXPAND_EXPRESSION 20
819#define EXPAND_MENUNAMES 21
820#define EXPAND_USER_COMMANDS 22
821#define EXPAND_USER_CMD_FLAGS 23
822#define EXPAND_USER_NARGS 24
823#define EXPAND_USER_COMPLETE 25
824#define EXPAND_ENV_VARS 26
825#define EXPAND_LANGUAGE 27
826#define EXPAND_COLORS 28
827#define EXPAND_COMPILER 29
828#define EXPAND_USER_DEFINED 30
Bram Moolenaara466c992005-07-09 21:03:22 +0000829#define EXPAND_USER_LIST 31
Bram Moolenaar362e1a32006-03-06 23:29:24 +0000830#define EXPAND_SHELLCMD 32
Bram Moolenaarf4580d82009-03-18 11:52:53 +0000831#define EXPAND_CSCOPE 33
Bram Moolenaar3c65e312009-04-29 16:47:23 +0000832#define EXPAND_SIGN 34
Bram Moolenaarf86f26c2010-02-03 15:14:22 +0100833#define EXPAND_PROFILE 35
Bram Moolenaar42b4dda2010-03-02 15:56:05 +0100834#define EXPAND_BEHAVE 36
Bram Moolenaar883f5d02010-06-21 06:24:34 +0200835#define EXPAND_FILETYPE 37
Bram Moolenaar1587a1e2010-07-29 20:59:59 +0200836#define EXPAND_FILES_IN_PATH 38
837#define EXPAND_OWNSYNTAX 39
Bram Moolenaar9b486ca2011-05-19 18:26:40 +0200838#define EXPAND_LOCALES 40
Bram Moolenaar5ae636b2012-04-30 18:48:53 +0200839#define EXPAND_HISTORY 41
Bram Moolenaar24305862012-08-15 14:05:05 +0200840#define EXPAND_USER 42
Bram Moolenaarcd9c4622013-06-08 15:24:48 +0200841#define EXPAND_SYNTIME 43
Bram Moolenaarf1d6ccf2014-12-08 04:16:44 +0100842#define EXPAND_USER_ADDR_TYPE 44
Bram Moolenaar35ca0e72016-03-05 17:41:49 +0100843#define EXPAND_PACKADD 45
Bram Moolenaar9e507ca2016-10-15 15:39:39 +0200844#define EXPAND_MESSAGES 46
Bram Moolenaarcae92dc2017-08-06 15:22:15 +0200845#define EXPAND_MAPCLEAR 47
Bram Moolenaarcd43eff2018-03-29 15:55:38 +0200846#define EXPAND_ARGLIST 48
Bram Moolenaarae7dba82019-12-29 13:56:33 +0100847#define EXPAND_DIFF_BUFFERS 49
Bram Moolenaar4ee9d8e2021-06-13 18:38:48 +0200848#define EXPAND_DISASSEMBLE 50
Bram Moolenaar6e2e2cc2022-03-14 19:24:46 +0000849#define EXPAND_BREAKPOINT 51
Yegappan Lakshmanan454ce672022-03-24 11:22:13 +0000850#define EXPAND_SCRIPTNAMES 52
roota6759382023-01-21 21:56:06 +0000851#define EXPAND_RUNTIME 53
Yee Cheng Chin900894b2023-09-29 20:42:32 +0200852#define EXPAND_STRING_SETTING 54
853#define EXPAND_SETTING_SUBTRACT 55
Yee Cheng Chin989426b2023-10-14 11:46:51 +0200854#define EXPAND_ARGOPT 56
855#define EXPAND_TERMINALOPT 57
Doug Kearns81642d92024-01-04 22:37:44 +0100856#define EXPAND_KEYMAP 58
LemonBoya20bf692024-07-11 22:35:53 +0200857#define EXPAND_DIRS_IN_CDPATH 59
Ruslan Russkikh0407d622024-10-08 22:21:05 +0200858#define EXPAND_SHELLCMDLINE 60
Yegappan Lakshmanana13f3a42024-11-02 18:40:10 +0100859#define EXPAND_FINDFUNC 61
Yee Cheng China7b81202025-02-23 09:32:47 +0100860#define EXPAND_HIGHLIGHT_GROUP 62
Christian Brabandta3422aa2025-04-23 21:04:24 +0200861#define EXPAND_FILETYPECMD 63
Girish Palya6b49fba2025-06-28 19:47:34 +0200862#define EXPAND_PATTERN_IN_BUF 64
LemonBoya20bf692024-07-11 22:35:53 +0200863
Bram Moolenaar071d4272004-06-13 20:20:40 +0000864
Bram Moolenaarc3308352019-09-01 16:24:56 +0200865// Values for exmode_active (0 is no exmode)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000866#define EXMODE_NORMAL 1
867#define EXMODE_VIM 2
868
Bram Moolenaarc3308352019-09-01 16:24:56 +0200869// Values for nextwild() and ExpandOne(). See ExpandOne() for meaning.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000870#define WILD_FREE 1
871#define WILD_EXPAND_FREE 2
872#define WILD_EXPAND_KEEP 3
873#define WILD_NEXT 4
874#define WILD_PREV 5
875#define WILD_ALL 6
876#define WILD_LONGEST 7
Bram Moolenaar146e9c32012-03-07 19:18:23 +0100877#define WILD_ALL_KEEP 8
Yegappan Lakshmanan3908ef52022-02-08 12:08:07 +0000878#define WILD_CANCEL 9
879#define WILD_APPLY 10
Yegappan Lakshmanan5cffa8d2022-03-16 13:33:53 +0000880#define WILD_PAGEUP 11
881#define WILD_PAGEDOWN 12
Bram Moolenaar071d4272004-06-13 20:20:40 +0000882
Bram Moolenaar50f91d22019-08-02 19:52:15 +0200883#define WILD_LIST_NOTFOUND 0x01
884#define WILD_HOME_REPLACE 0x02
885#define WILD_USE_NL 0x04
886#define WILD_NO_BEEP 0x08
887#define WILD_ADD_SLASH 0x10
888#define WILD_KEEP_ALL 0x20
889#define WILD_SILENT 0x40
890#define WILD_ESCAPE 0x80
891#define WILD_ICASE 0x100
892#define WILD_ALLLINKS 0x200
893#define WILD_IGNORE_COMPLETESLASH 0x400
Bram Moolenaar2b78ab52019-10-19 22:50:20 +0200894#define WILD_NOERROR 0x800 // sets EW_NOERROR
Bram Moolenaar52410572019-10-27 05:12:45 +0100895#define WILD_BUFLASTUSED 0x1000
Bram Moolenaarae7dba82019-12-29 13:56:33 +0100896#define BUF_DIFF_FILTER 0x2000
Girish Palya2bacc3e2025-03-02 22:55:57 +0100897#define WILD_KEEP_SOLE_ITEM 0x4000
Girish Palya6b49fba2025-06-28 19:47:34 +0200898#define WILD_MAY_EXPAND_PATTERN 0x8000
Bram Moolenaar071d4272004-06-13 20:20:40 +0000899
Bram Moolenaar99499b12019-05-23 21:35:48 +0200900// Flags for expand_wildcards()
901#define EW_DIR 0x01 // include directory names
902#define EW_FILE 0x02 // include file names
903#define EW_NOTFOUND 0x04 // include not found names
904#define EW_ADDSLASH 0x08 // append slash to directory name
905#define EW_KEEPALL 0x10 // keep all matches
906#define EW_SILENT 0x20 // don't print "1 returned" from shell
907#define EW_EXEC 0x40 // executable files
908#define EW_PATH 0x80 // search in 'path' too
909#define EW_ICASE 0x100 // ignore case
910#define EW_NOERROR 0x200 // no error for bad regexp
911#define EW_NOTWILD 0x400 // add match with literal name if exists
912#define EW_KEEPDOLLAR 0x800 // do not escape $, $var is expanded
913// Note: mostly EW_NOTFOUND and EW_SILENT are mutually exclusive: EW_NOTFOUND
914// is used when executing commands and EW_SILENT for interactive expanding.
915#define EW_ALLLINKS 0x1000 // also links not pointing to existing file
916#define EW_SHELLCMD 0x2000 // called from expand_shellcmd(), don't check
917 // if executable is in $PATH
918#define EW_DODOT 0x4000 // also files starting with a dot
919#define EW_EMPTYOK 0x8000 // no matches is not an error
920#define EW_NOTENV 0x10000 // do not expand environment variables
LemonBoya20bf692024-07-11 22:35:53 +0200921#define EW_CDPATH 0x20000 // search in 'cdpath' too
Bram Moolenaar071d4272004-06-13 20:20:40 +0000922
Bram Moolenaarc3308352019-09-01 16:24:56 +0200923// Flags for find_file_*() functions.
924#define FINDFILE_FILE 0 // only files
925#define FINDFILE_DIR 1 // only directories
926#define FINDFILE_BOTH 2 // files and directories
Bram Moolenaar4d0ec162008-02-20 11:24:52 +0000927
Naruhiko Nishinobe5bd4d2025-05-14 21:20:28 +0200928#if defined(FEAT_TABPANEL)
929# define COLUMNS_WITHOUT_TPL() (Columns - tabpanel_width())
Hirohito Higashie5c96e32025-06-16 19:39:24 +0200930# define TPL_LCOL() tabpanel_leftcol()
Naruhiko Nishinobe5bd4d2025-05-14 21:20:28 +0200931#else
932# define COLUMNS_WITHOUT_TPL() Columns
Hirohito Higashie5c96e32025-06-16 19:39:24 +0200933# define TPL_LCOL() 0
Naruhiko Nishinobe5bd4d2025-05-14 21:20:28 +0200934#endif
935
kylo2529dac9b12022-03-27 20:05:17 +0100936#define W_ENDCOL(wp) ((wp)->w_wincol + (wp)->w_width)
Bram Moolenaara5a2be22017-09-19 22:08:04 +0200937#ifdef FEAT_MENU
kylo2529dac9b12022-03-27 20:05:17 +0100938# define W_WINROW(wp) ((wp)->w_winrow + (wp)->w_winbar_height)
Bram Moolenaara5a2be22017-09-19 22:08:04 +0200939#else
940# define W_WINROW(wp) (wp->w_winrow)
941#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +0000942
Bram Moolenaarc3308352019-09-01 16:24:56 +0200943// Values for the find_pattern_in_path() function args 'type' and 'action':
Bram Moolenaar071d4272004-06-13 20:20:40 +0000944#define FIND_ANY 1
945#define FIND_DEFINE 2
946#define CHECK_PATH 3
947
948#define ACTION_SHOW 1
949#define ACTION_GOTO 2
950#define ACTION_SPLIT 3
951#define ACTION_SHOW_ALL 4
Bram Moolenaare2c453d2019-08-21 14:37:09 +0200952#define ACTION_EXPAND 5
Bram Moolenaar071d4272004-06-13 20:20:40 +0000953
954#ifdef FEAT_SYN_HL
Bram Moolenaarc3308352019-09-01 16:24:56 +0200955# define SST_MIN_ENTRIES 150 // minimal size for state stack array
956# define SST_MAX_ENTRIES 1000 // maximal size for state stack array
957# define SST_FIX_STATES 7 // size of sst_stack[].
958# define SST_DIST 16 // normal distance between entries
kylo2529dac9b12022-03-27 20:05:17 +0100959# define SST_INVALID ((synstate_T *)-1) // invalid syn_state pointer
Bram Moolenaar860cae12010-06-05 23:22:07 +0200960
Bram Moolenaarc3308352019-09-01 16:24:56 +0200961# define HL_CONTAINED 0x01 // not used on toplevel
962# define HL_TRANSP 0x02 // has no highlighting
963# define HL_ONELINE 0x04 // match within one line only
964# define HL_HAS_EOL 0x08 // end pattern that matches with $
965# define HL_SYNC_HERE 0x10 // sync point after this item (syncing only)
966# define HL_SYNC_THERE 0x20 // sync point at current line (syncing only)
967# define HL_MATCH 0x40 // use match ID instead of item ID
968# define HL_SKIPNL 0x80 // nextgroup can skip newlines
969# define HL_SKIPWHITE 0x100 // nextgroup can skip white space
970# define HL_SKIPEMPTY 0x200 // nextgroup can skip empty lines
971# define HL_KEEPEND 0x400 // end match always kept
972# define HL_EXCLUDENL 0x800 // exclude NL from match
973# define HL_DISPLAY 0x1000 // only used for displaying, not syncing
974# define HL_FOLD 0x2000 // define fold
975# define HL_EXTEND 0x4000 // ignore a keepend
976# define HL_MATCHCONT 0x8000 // match continued from previous line
977# define HL_TRANS_CONT 0x10000 // transparent item without contains arg
978# define HL_CONCEAL 0x20000 // can be concealed
979# define HL_CONCEALENDS 0x40000 // can be concealed
Theodore Duboisf50d5362025-02-05 23:59:25 +0100980# define HL_INCLUDED_TOPLEVEL 0x80000 // toplevel item in included syntax, allowed by contains=TOP
Bram Moolenaar071d4272004-06-13 20:20:40 +0000981#endif
982
Bram Moolenaarc3308352019-09-01 16:24:56 +0200983// Values for 'options' argument in do_search() and searchit()
984#define SEARCH_REV 0x01 // go in reverse of previous dir.
985#define SEARCH_ECHO 0x02 // echo the search command and handle options
986#define SEARCH_MSG 0x0c // give messages (yes, it's not 0x04)
987#define SEARCH_NFMSG 0x08 // give all messages except not found
988#define SEARCH_OPT 0x10 // interpret optional flags
989#define SEARCH_HIS 0x20 // put search pattern in history
990#define SEARCH_END 0x40 // put cursor at end of match
991#define SEARCH_NOOF 0x80 // don't add offset to position
992#define SEARCH_START 0x100 // start search without col offset
993#define SEARCH_MARK 0x200 // set previous context mark
994#define SEARCH_KEEP 0x400 // keep previous search pattern
995#define SEARCH_PEEK 0x800 // peek for typed char, cancel search
996#define SEARCH_COL 0x1000 // start at specified column instead of zero
Bram Moolenaar071d4272004-06-13 20:20:40 +0000997
Bram Moolenaar17627312019-06-02 19:53:44 +0200998// Values for find_ident_under_cursor()
999#define FIND_IDENT 1 // find identifier (word)
1000#define FIND_STRING 2 // find any string (WORD)
1001#define FIND_EVAL 4 // include "->", "[]" and "."
1002#define FIND_NOERROR 8 // no error when no word found
Bram Moolenaar071d4272004-06-13 20:20:40 +00001003
Bram Moolenaarc3308352019-09-01 16:24:56 +02001004// Values for file_name_in_line()
1005#define FNAME_MESS 1 // give error message
1006#define FNAME_EXP 2 // expand to path
1007#define FNAME_HYP 4 // check for hypertext link
1008#define FNAME_INCL 8 // apply 'includeexpr'
1009#define FNAME_REL 16 // ".." and "./" are relative to the (current)
1010 // file instead of the current directory
1011#define FNAME_UNESC 32 // remove backslashes used for escaping
Bram Moolenaar071d4272004-06-13 20:20:40 +00001012
Bram Moolenaarc3308352019-09-01 16:24:56 +02001013// Values for buflist_getfile()
1014#define GETF_SETMARK 0x01 // set pcmark before jumping
1015#define GETF_ALT 0x02 // jumping to alternate file (not buf num)
1016#define GETF_SWITCH 0x04 // respect 'switchbuf' settings when jumping
Bram Moolenaar071d4272004-06-13 20:20:40 +00001017
Bram Moolenaarc3308352019-09-01 16:24:56 +02001018// Return values of getfile()
1019#define GETFILE_ERROR 1 // normal error
1020#define GETFILE_NOT_WRITTEN 2 // "not written" error
1021#define GETFILE_SAME_FILE 0 // success, same file
kylo2529dac9b12022-03-27 20:05:17 +01001022#define GETFILE_OPEN_OTHER (-1) // success, opened another file
Bram Moolenaar8ad80de2017-06-05 16:01:59 +02001023#define GETFILE_UNUSED 8
1024#define GETFILE_SUCCESS(x) ((x) <= 0)
1025
Bram Moolenaar00b0d6d2019-08-21 22:25:30 +02001026// Values for buflist_new() flags
1027#define BLN_CURBUF 1 // may re-use curbuf for new buffer
1028#define BLN_LISTED 2 // put new buffer in buffer list
1029#define BLN_DUMMY 4 // allocating dummy buffer
1030#define BLN_NEW 8 // create a new buffer
1031#define BLN_NOOPT 16 // don't copy options to existing buffer
1032#define BLN_DUMMY_OK 32 // also find an existing dummy buffer
1033#define BLN_REUSE 64 // may re-use number from buf_reuse
Bram Moolenaar89b693e2020-10-25 17:09:50 +01001034#define BLN_NOCURWIN 128 // buffer is not associated with curwin
Bram Moolenaar071d4272004-06-13 20:20:40 +00001035
Bram Moolenaarc3308352019-09-01 16:24:56 +02001036// Values for in_cinkeys()
Bram Moolenaar071d4272004-06-13 20:20:40 +00001037#define KEY_OPEN_FORW 0x101
1038#define KEY_OPEN_BACK 0x102
Bram Moolenaarc3308352019-09-01 16:24:56 +02001039#define KEY_COMPLETE 0x103 // end of completion
Bram Moolenaar071d4272004-06-13 20:20:40 +00001040
zeertzjq44068e92022-06-16 11:14:55 +01001041// Used for the first argument of do_map()
zeertzjqfdf135a2024-10-24 21:43:43 +02001042#define MAPTYPE_MAP 0
1043#define MAPTYPE_UNMAP 1
1044#define MAPTYPE_NOREMAP 2
1045#define MAPTYPE_UNMAP_LHS 3
zeertzjq44068e92022-06-16 11:14:55 +01001046
Bram Moolenaarc3308352019-09-01 16:24:56 +02001047// Values for "noremap" argument of ins_typebuf(). Also used for
1048// map->m_noremap and menu->noremap[].
1049#define REMAP_YES 0 // allow remapping
kylo2529dac9b12022-03-27 20:05:17 +01001050#define REMAP_NONE (-1) // no remapping
1051#define REMAP_SCRIPT (-2) // remap script-local mappings only
1052#define REMAP_SKIP (-3) // no remapping for first char
Bram Moolenaar071d4272004-06-13 20:20:40 +00001053
Bram Moolenaarc3308352019-09-01 16:24:56 +02001054// Values for mch_call_shell() second argument
1055#define SHELL_FILTER 1 // filtering text
1056#define SHELL_EXPAND 2 // expanding wildcards
1057#define SHELL_COOKED 4 // set term to cooked mode
1058#define SHELL_DOOUT 8 // redirecting output
1059#define SHELL_SILENT 16 // don't print error returned by command
1060#define SHELL_READ 32 // read lines and insert into buffer
1061#define SHELL_WRITE 64 // write lines from buffer
Bram Moolenaar071d4272004-06-13 20:20:40 +00001062
Bram Moolenaarc3308352019-09-01 16:24:56 +02001063// Values returned by mch_nodetype()
1064#define NODE_NORMAL 0 // file or directory, check with mch_isdir()
1065#define NODE_WRITABLE 1 // something we can write to (character
1066 // device, fifo, socket, ..)
1067#define NODE_OTHER 2 // non-writable thing (e.g., block device)
Bram Moolenaar071d4272004-06-13 20:20:40 +00001068
Bram Moolenaarc3308352019-09-01 16:24:56 +02001069// Values for readfile() flags
1070#define READ_NEW 0x01 // read a file into a new buffer
1071#define READ_FILTER 0x02 // read filter output
1072#define READ_STDIN 0x04 // read from stdin
1073#define READ_BUFFER 0x08 // read from curbuf (converting stdin)
1074#define READ_DUMMY 0x10 // reading into a dummy buffer
1075#define READ_KEEP_UNDO 0x20 // keep undo info
1076#define READ_FIFO 0x40 // read from fifo or socket
Bram Moolenaar1d30fde2021-10-20 21:58:42 +01001077#define READ_NOWINENTER 0x80 // do not trigger BufWinEnter
Bram Moolenaarb1d2c812022-08-26 11:55:01 +01001078#define READ_NOFILE 0x100 // do not read a file, do trigger BufReadCmd
Bram Moolenaar071d4272004-06-13 20:20:40 +00001079
Bram Moolenaarc3308352019-09-01 16:24:56 +02001080// Values for change_indent()
1081#define INDENT_SET 1 // set indent
1082#define INDENT_INC 2 // increase indent
1083#define INDENT_DEC 3 // decrease indent
Bram Moolenaar071d4272004-06-13 20:20:40 +00001084
Bram Moolenaarc3308352019-09-01 16:24:56 +02001085// Values for flags argument for findmatchlimit()
1086#define FM_BACKWARD 0x01 // search backwards
1087#define FM_FORWARD 0x02 // search forwards
1088#define FM_BLOCKSTOP 0x04 // stop at start/end of block
1089#define FM_SKIPCOMM 0x08 // skip comments
Bram Moolenaar071d4272004-06-13 20:20:40 +00001090
Bram Moolenaar00b0d6d2019-08-21 22:25:30 +02001091// Values for action argument for do_buffer() and close_buffer()
1092#define DOBUF_GOTO 0 // go to specified buffer
1093#define DOBUF_SPLIT 1 // split window and go to specified buffer
1094#define DOBUF_UNLOAD 2 // unload specified buffer(s)
1095#define DOBUF_DEL 3 // delete specified buffer(s) from buflist
1096#define DOBUF_WIPE 4 // delete specified buffer(s) really
Dominique Pelleaf4a61a2021-12-27 17:21:41 +00001097#define DOBUF_WIPE_REUSE 5 // like DOBUF_WIPE and keep number for reuse
Bram Moolenaar071d4272004-06-13 20:20:40 +00001098
Bram Moolenaarc3308352019-09-01 16:24:56 +02001099// Values for start argument for do_buffer()
1100#define DOBUF_CURRENT 0 // "count" buffer from current buffer
1101#define DOBUF_FIRST 1 // "count" buffer from first buffer
1102#define DOBUF_LAST 2 // "count" buffer from last buffer
1103#define DOBUF_MOD 3 // "count" mod. buffer from current buffer
Bram Moolenaar071d4272004-06-13 20:20:40 +00001104
Bram Moolenaar7b4f76c2021-06-10 21:07:48 +02001105// Values for flags argument of do_buffer()
1106#define DOBUF_FORCEIT 1 // :cmd!
1107#define DOBUF_NOPOPUP 2 // skip popup window buffers
LemonBoy893eeeb2024-07-10 20:20:48 +02001108#define DOBUF_SKIPHELP 4 // skip or keep help buffers depending on b_help of the
1109 // starting buffer
Bram Moolenaar7b4f76c2021-06-10 21:07:48 +02001110
Bram Moolenaarc3308352019-09-01 16:24:56 +02001111// Values for sub_cmd and which_pat argument for search_regcomp()
1112// Also used for which_pat argument for searchit()
1113#define RE_SEARCH 0 // save/use pat in/from search_pattern
1114#define RE_SUBST 1 // save/use pat in/from subst_pattern
1115#define RE_BOTH 2 // save pat in both patterns
1116#define RE_LAST 2 // use last used pattern if "pat" is NULL
Bram Moolenaar071d4272004-06-13 20:20:40 +00001117
Bram Moolenaarc3308352019-09-01 16:24:56 +02001118// Second argument for vim_regcomp().
1119#define RE_MAGIC 1 // 'magic' option
1120#define RE_STRING 2 // match in string instead of buffer text
1121#define RE_STRICT 4 // don't allow [abc] without ]
1122#define RE_AUTO 8 // automatic engine selection
Bram Moolenaar071d4272004-06-13 20:20:40 +00001123
1124#ifdef FEAT_SYN_HL
Bram Moolenaarc3308352019-09-01 16:24:56 +02001125// values for reg_do_extmatch
1126# define REX_SET 1 // to allow \z\(...\),
1127# define REX_USE 2 // to allow \z\1 et al.
Bram Moolenaarbcf94422018-06-23 14:21:42 +02001128# define REX_ALL (REX_SET | REX_USE)
Bram Moolenaar071d4272004-06-13 20:20:40 +00001129#endif
1130
Bram Moolenaarc3308352019-09-01 16:24:56 +02001131// Return values for fullpathcmp()
1132// Note: can use (fullpathcmp() & FPC_SAME) to check for equal files
1133#define FPC_SAME 1 // both exist and are the same file.
1134#define FPC_DIFF 2 // both exist and are different files.
1135#define FPC_NOTX 4 // both don't exist.
1136#define FPC_DIFFX 6 // one of them doesn't exist.
1137#define FPC_SAMEX 7 // both don't exist and file names are same.
Bram Moolenaar071d4272004-06-13 20:20:40 +00001138
Bram Moolenaarc3308352019-09-01 16:24:56 +02001139// flags for do_ecmd()
1140#define ECMD_HIDE 0x01 // don't free the current buffer
1141#define ECMD_SET_HELP 0x02 // set b_help flag of (new) buffer before
1142 // opening file
1143#define ECMD_OLDBUF 0x04 // use existing buffer if it exists
1144#define ECMD_FORCEIT 0x08 // ! used in Ex command
1145#define ECMD_ADDBUF 0x10 // don't edit, just add to buffer list
Bram Moolenaar59d8e562020-11-07 18:41:10 +01001146#define ECMD_ALTBUF 0x20 // like ECMD_ADDBUF and set the alternate file
Bram Moolenaar1d30fde2021-10-20 21:58:42 +01001147#define ECMD_NOWINENTER 0x40 // do not trigger BufWinEnter
Bram Moolenaar071d4272004-06-13 20:20:40 +00001148
Bram Moolenaarc3308352019-09-01 16:24:56 +02001149// for lnum argument in do_ecmd()
1150#define ECMD_LASTL (linenr_T)0 // use last position in loaded file
kylo2529dac9b12022-03-27 20:05:17 +01001151#define ECMD_LAST ((linenr_T)-1) // use last position in all files
Bram Moolenaarc3308352019-09-01 16:24:56 +02001152#define ECMD_ONE (linenr_T)1 // use first line
Bram Moolenaar071d4272004-06-13 20:20:40 +00001153
Bram Moolenaarc3308352019-09-01 16:24:56 +02001154// flags for do_cmdline()
1155#define DOCMD_VERBOSE 0x01 // included command in error message
1156#define DOCMD_NOWAIT 0x02 // don't call wait_return() and friends
1157#define DOCMD_REPEAT 0x04 // repeat exec. until getline() returns NULL
1158#define DOCMD_KEYTYPED 0x08 // don't reset KeyTyped
1159#define DOCMD_EXCRESET 0x10 // reset exception environment (for debugging)
1160#define DOCMD_KEEPLINE 0x20 // keep typed line for repeating with "."
Bram Moolenaardc987762022-01-16 15:52:35 +00001161#define DOCMD_RANGEOK 0x40 // can use a range without ":" in Vim9 script
Bram Moolenaar071d4272004-06-13 20:20:40 +00001162
Bram Moolenaarc3308352019-09-01 16:24:56 +02001163// flags for beginline()
1164#define BL_WHITE 1 // cursor on first non-white in the line
1165#define BL_SOL 2 // use 'sol' option
1166#define BL_FIX 4 // don't leave cursor on a NUL
Bram Moolenaar071d4272004-06-13 20:20:40 +00001167
Bram Moolenaarc3308352019-09-01 16:24:56 +02001168// flags for mf_sync()
1169#define MFS_ALL 1 // also sync blocks with negative numbers
1170#define MFS_STOP 2 // stop syncing when a character is available
1171#define MFS_FLUSH 4 // flushed file to disk
1172#define MFS_ZERO 8 // only write block 0
Bram Moolenaar071d4272004-06-13 20:20:40 +00001173
Bram Moolenaarc3308352019-09-01 16:24:56 +02001174// flags for buf_copy_options()
1175#define BCO_ENTER 1 // going to enter the buffer
1176#define BCO_ALWAYS 2 // always copy the options
1177#define BCO_NOHELP 4 // don't touch the help related options
Bram Moolenaar071d4272004-06-13 20:20:40 +00001178
Bram Moolenaarc3308352019-09-01 16:24:56 +02001179// flags for do_put()
1180#define PUT_FIXINDENT 1 // make indent look nice
1181#define PUT_CURSEND 2 // leave cursor after end of new text
1182#define PUT_CURSLINE 4 // leave cursor on last line of new text
1183#define PUT_LINE 8 // put register as lines
1184#define PUT_LINE_SPLIT 16 // split line for linewise register
1185#define PUT_LINE_FORWARD 32 // put linewise register below Visual sel.
Christian Brabandt2fa93842021-05-30 22:17:25 +02001186#define PUT_BLOCK_INNER 64 // in block mode, do not add trailing spaces
Bram Moolenaar071d4272004-06-13 20:20:40 +00001187
Bram Moolenaarc3308352019-09-01 16:24:56 +02001188// flags for set_indent()
1189#define SIN_CHANGED 1 // call changed_bytes() when line changed
1190#define SIN_INSERT 2 // insert indent before existing text
1191#define SIN_UNDO 4 // save line for undo before changing it
Bram Moolenaar071d4272004-06-13 20:20:40 +00001192
Bram Moolenaarc3308352019-09-01 16:24:56 +02001193// flags for insertchar()
1194#define INSCHAR_FORMAT 1 // force formatting
1195#define INSCHAR_DO_COM 2 // format comments
1196#define INSCHAR_CTRLV 4 // char typed just after CTRL-V
1197#define INSCHAR_NO_FEX 8 // don't use 'formatexpr'
1198#define INSCHAR_COM_LIST 16 // format comments with list/2nd line indent
Bram Moolenaar071d4272004-06-13 20:20:40 +00001199
Bram Moolenaarc3308352019-09-01 16:24:56 +02001200// flags for open_line()
glepnir5090a1f2025-02-24 19:10:37 +01001201#define OPENLINE_DELSPACES 0x01 // delete spaces after cursor
1202#define OPENLINE_DO_COM 0x02 // format comments
1203#define OPENLINE_KEEPTRAIL 0x04 // keep trailing spaces
1204#define OPENLINE_MARKFIX 0x08 // fix mark positions
1205#define OPENLINE_COM_LIST 0x10 // format comments with list/2nd line indent
1206#define OPENLINE_FORMAT 0x20 // formatting long comment
1207#define OPENLINE_FORCE_INDENT 0x40 // use second_line_indent without indent logic
Bram Moolenaar071d4272004-06-13 20:20:40 +00001208
Bram Moolenaarc3308352019-09-01 16:24:56 +02001209// There are five history tables:
1210#define HIST_CMD 0 // colon commands
1211#define HIST_SEARCH 1 // search commands
1212#define HIST_EXPR 2 // expressions (from entering = register)
1213#define HIST_INPUT 3 // input() lines
1214#define HIST_DEBUG 4 // debug commands
1215#define HIST_COUNT 5 // number of history tables
Bram Moolenaar071d4272004-06-13 20:20:40 +00001216
Bram Moolenaarc3308352019-09-01 16:24:56 +02001217// The type numbers are fixed for backwards compatibility.
Bram Moolenaarc60954b2016-06-06 21:20:10 +02001218#define BARTYPE_VERSION 1
1219#define BARTYPE_HISTORY 2
Bram Moolenaar46bbb0c2016-06-11 21:04:39 +02001220#define BARTYPE_REGISTER 3
Bram Moolenaar2d358992016-06-12 21:20:54 +02001221#define BARTYPE_MARK 4
Bram Moolenaarc60954b2016-06-06 21:20:10 +02001222
Bram Moolenaar2d358992016-06-12 21:20:54 +02001223#define VIMINFO_VERSION 4
Bram Moolenaar1fd99c12016-06-09 20:24:28 +02001224#define VIMINFO_VERSION_WITH_HISTORY 2
Bram Moolenaar46bbb0c2016-06-11 21:04:39 +02001225#define VIMINFO_VERSION_WITH_REGISTERS 3
Bram Moolenaar2d358992016-06-12 21:20:54 +02001226#define VIMINFO_VERSION_WITH_MARKS 4
Bram Moolenaar1fd99c12016-06-09 20:24:28 +02001227
Bram Moolenaar071d4272004-06-13 20:20:40 +00001228/*
Bram Moolenaar071d4272004-06-13 20:20:40 +00001229 * Values for do_tag().
1230 */
Bram Moolenaarc3308352019-09-01 16:24:56 +02001231#define DT_TAG 1 // jump to newer position or same tag again
1232#define DT_POP 2 // jump to older position
1233#define DT_NEXT 3 // jump to next match of same tag
1234#define DT_PREV 4 // jump to previous match of same tag
1235#define DT_FIRST 5 // jump to first match of same tag
1236#define DT_LAST 6 // jump to first match of same tag
1237#define DT_SELECT 7 // jump to selection from list
1238#define DT_HELP 8 // like DT_TAG, but no wildcards
1239#define DT_JUMP 9 // jump to new tag or selection from list
1240#define DT_CSCOPE 10 // cscope find command (like tjump)
1241#define DT_LTAG 11 // tag using location list
1242#define DT_FREE 99 // free cached matches
Bram Moolenaar071d4272004-06-13 20:20:40 +00001243
1244/*
1245 * flags for find_tags().
1246 */
Bram Moolenaar45e18cb2019-04-28 18:05:35 +02001247#define TAG_HELP 1 // only search for help tags
1248#define TAG_NAMES 2 // only return name of tag
1249#define TAG_REGEXP 4 // use tag pattern as regexp
1250#define TAG_NOIC 8 // don't always ignore case
Bram Moolenaar071d4272004-06-13 20:20:40 +00001251#ifdef FEAT_CSCOPE
Bram Moolenaar45e18cb2019-04-28 18:05:35 +02001252# define TAG_CSCOPE 16 // cscope tag
Bram Moolenaar071d4272004-06-13 20:20:40 +00001253#endif
Bram Moolenaar45e18cb2019-04-28 18:05:35 +02001254#define TAG_VERBOSE 32 // message verbosity
1255#define TAG_INS_COMP 64 // Currently doing insert completion
1256#define TAG_KEEP_LANG 128 // keep current language
1257#define TAG_NO_TAGFUNC 256 // do not use 'tagfunc'
Bram Moolenaar071d4272004-06-13 20:20:40 +00001258
Bram Moolenaar45e18cb2019-04-28 18:05:35 +02001259#define TAG_MANY 300 // When finding many tags (for completion),
1260 // find up to this many tags
Bram Moolenaar071d4272004-06-13 20:20:40 +00001261
1262/*
1263 * Types of dialogs passed to do_vim_dialog().
1264 */
1265#define VIM_GENERIC 0
1266#define VIM_ERROR 1
1267#define VIM_WARNING 2
1268#define VIM_INFO 3
1269#define VIM_QUESTION 4
Bram Moolenaarc3308352019-09-01 16:24:56 +02001270#define VIM_LAST_TYPE 4 // sentinel value
Bram Moolenaar071d4272004-06-13 20:20:40 +00001271
1272/*
1273 * Return values for functions like gui_yesnocancel()
1274 */
Bram Moolenaar071d4272004-06-13 20:20:40 +00001275#define VIM_YES 2
1276#define VIM_NO 3
1277#define VIM_CANCEL 4
1278#define VIM_ALL 5
1279#define VIM_DISCARDALL 6
1280
1281/*
1282 * arguments for win_split()
1283 */
Bram Moolenaar21c3a802022-08-31 17:49:14 +01001284#define WSP_ROOM 0x01 // require enough room
1285#define WSP_VERT 0x02 // split/equalize vertically
1286#define WSP_HOR 0x04 // equalize horizontally
1287#define WSP_TOP 0x08 // window at top-left of shell
1288#define WSP_BOT 0x10 // window at bottom-right of shell
1289#define WSP_HELP 0x20 // creating the help window
1290#define WSP_BELOW 0x40 // put new window below/right
1291#define WSP_ABOVE 0x80 // put new window above/left
1292#define WSP_NEWLOC 0x100 // don't copy location list
Sean Dewar0fd44a52024-02-20 20:28:15 +01001293#define WSP_FORCE_ROOM 0x200 // ignore "not enough room" errors
Bram Moolenaar071d4272004-06-13 20:20:40 +00001294
1295/*
Bram Moolenaar2e2a2812006-03-27 20:55:21 +00001296 * arguments for gui_set_shellsize()
1297 */
Bram Moolenaarc3308352019-09-01 16:24:56 +02001298#define RESIZE_VERT 1 // resize vertically
1299#define RESIZE_HOR 2 // resize horizontally
1300#define RESIZE_BOTH 15 // resize in both directions
Bram Moolenaar2e2a2812006-03-27 20:55:21 +00001301
1302/*
Bram Moolenaar45d3b142013-11-09 03:31:51 +01001303 * flags for check_changed()
1304 */
Bram Moolenaarc3308352019-09-01 16:24:56 +02001305#define CCGD_AW 1 // do autowrite if buffer was changed
1306#define CCGD_MULTWIN 2 // check also when several wins for the buf
1307#define CCGD_FORCEIT 4 // ! used
1308#define CCGD_ALLBUF 8 // may write all buffers
1309#define CCGD_EXCMD 16 // may suggest using !
Bram Moolenaar45d3b142013-11-09 03:31:51 +01001310
1311/*
Bram Moolenaar071d4272004-06-13 20:20:40 +00001312 * "flags" values for option-setting functions.
1313 * When OPT_GLOBAL and OPT_LOCAL are both missing, set both local and global
1314 * values, get local value.
1315 */
Bram Moolenaar6b915c02020-01-18 15:53:19 +01001316#define OPT_FREE 0x01 // free old value if it was allocated
1317#define OPT_GLOBAL 0x02 // use global value
1318#define OPT_LOCAL 0x04 // use local value
1319#define OPT_MODELINE 0x08 // option in modeline
1320#define OPT_WINONLY 0x10 // only set window-local options
1321#define OPT_NOWIN 0x20 // don't set window-local options
1322#define OPT_ONECOLUMN 0x40 // list options one per line
Bram Moolenaar37294bd2021-03-10 13:40:08 +01001323#define OPT_NO_REDRAW 0x80 // ignore redraw flags on option
Bram Moolenaar635bd602021-04-16 19:58:22 +02001324#define OPT_SKIPRTP 0x100 // "skiprtp" in 'sessionoptions'
Bram Moolenaar071d4272004-06-13 20:20:40 +00001325
Bram Moolenaarc3308352019-09-01 16:24:56 +02001326// Magic chars used in confirm dialog strings
Bram Moolenaar071d4272004-06-13 20:20:40 +00001327#define DLG_BUTTON_SEP '\n'
1328#define DLG_HOTKEY_CHAR '&'
1329
Bram Moolenaarc3308352019-09-01 16:24:56 +02001330// Values for "starting"
1331#define NO_SCREEN 2 // no screen updating yet
1332#define NO_BUFFERS 1 // not all buffers loaded yet
1333// 0 not starting anymore
Bram Moolenaar071d4272004-06-13 20:20:40 +00001334
Bram Moolenaarc3308352019-09-01 16:24:56 +02001335// Values for swap_exists_action: what to do when swap file already exists
1336#define SEA_NONE 0 // don't use dialog
1337#define SEA_DIALOG 1 // use dialog when possible
1338#define SEA_QUIT 2 // quit editing the file
1339#define SEA_RECOVER 3 // recover the file
Bram Moolenaar188639d2022-04-04 16:57:21 +01001340#define SEA_READONLY 4 // no dialog, mark buffer as read-only
Bram Moolenaar071d4272004-06-13 20:20:40 +00001341
1342/*
1343 * Minimal size for block 0 of a swap file.
1344 * NOTE: This depends on size of struct block0! It's not done with a sizeof(),
1345 * because struct block0 is defined in memline.c (Sorry).
1346 * The maximal block size is arbitrary.
1347 */
1348#define MIN_SWAP_PAGE_SIZE 1048
1349#define MAX_SWAP_PAGE_SIZE 50000
1350
Bram Moolenaarc3308352019-09-01 16:24:56 +02001351// Special values for current_sctx.sc_sid.
kylo2529dac9b12022-03-27 20:05:17 +01001352#define SID_MODELINE (-1) // when using a modeline
1353#define SID_CMDARG (-2) // for "--cmd" argument
1354#define SID_CARG (-3) // for "-c" argument
1355#define SID_ENV (-4) // for sourcing environment variable
1356#define SID_ERROR (-5) // option was reset because of an error
1357#define SID_NONE (-6) // don't set scriptID
1358#define SID_WINLAYOUT (-7) // changing window size
Bram Moolenaar071d4272004-06-13 20:20:40 +00001359
1360/*
Luuk van Baalb7147f82025-02-08 18:52:39 +01001361 * Events for autocommands. Must be kept in sync with "event_tab".
Bram Moolenaar071d4272004-06-13 20:20:40 +00001362 */
1363enum auto_event
1364{
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001365 EVENT_BUFADD = 0, // after adding a buffer to the buffer list
Luuk van Baalb7147f82025-02-08 18:52:39 +01001366 EVENT_BUFCREATE, // UNUSED: BufCreate == BufAdd
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001367 EVENT_BUFDELETE, // deleting a buffer from the buffer list
1368 EVENT_BUFENTER, // after entering a buffer
1369 EVENT_BUFFILEPOST, // after renaming a buffer
1370 EVENT_BUFFILEPRE, // before renaming a buffer
1371 EVENT_BUFHIDDEN, // just after buffer becomes hidden
1372 EVENT_BUFLEAVE, // before leaving a buffer
1373 EVENT_BUFNEW, // after creating any buffer
1374 EVENT_BUFNEWFILE, // when creating a buffer for a new file
Luuk van Baalb7147f82025-02-08 18:52:39 +01001375 EVENT_BUFREAD, // UNUSED: BufRead == BufReadPost
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001376 EVENT_BUFREADCMD, // read buffer using command
1377 EVENT_BUFREADPOST, // after reading a buffer
1378 EVENT_BUFREADPRE, // before reading a buffer
1379 EVENT_BUFUNLOAD, // just before unloading a buffer
1380 EVENT_BUFWINENTER, // after showing a buffer in a window
1381 EVENT_BUFWINLEAVE, // just after buffer removed from window
1382 EVENT_BUFWIPEOUT, // just before really deleting a buffer
Luuk van Baalb7147f82025-02-08 18:52:39 +01001383 EVENT_BUFWRITE, // UNUSED: BufWrite == BufWritePost
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001384 EVENT_BUFWRITECMD, // write buffer using command
1385 EVENT_BUFWRITEPOST, // after writing a buffer
1386 EVENT_BUFWRITEPRE, // before writing a buffer
Bram Moolenaarc4568ab2018-11-16 16:21:05 +01001387 EVENT_CMDLINECHANGED, // command line was modified
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001388 EVENT_CMDLINEENTER, // after entering the command line
Girish Palya92f68e22025-04-21 11:12:41 +02001389 EVENT_CMDLINELEAVEPRE, // just before leaving the command line
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001390 EVENT_CMDLINELEAVE, // before leaving the command line
1391 EVENT_CMDUNDEFINED, // command undefined
1392 EVENT_CMDWINENTER, // after entering the cmdline window
1393 EVENT_CMDWINLEAVE, // before leaving the cmdline window
1394 EVENT_COLORSCHEME, // after loading a colorscheme
1395 EVENT_COLORSCHEMEPRE, // before loading a colorscheme
Bram Moolenaard7f246c2019-04-08 18:15:41 +02001396 EVENT_COMPLETECHANGED, // after completion popup menu changed
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001397 EVENT_COMPLETEDONE, // after finishing insert complete
Bram Moolenaar3f169ce2020-01-26 22:43:31 +01001398 EVENT_COMPLETEDONEPRE, // idem, before clearing info
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001399 EVENT_CURSORHOLD, // cursor in same position for a while
1400 EVENT_CURSORHOLDI, // idem, in Insert mode
1401 EVENT_CURSORMOVED, // cursor was moved
Shougo Matsushitad0952142024-06-20 22:05:16 +02001402 EVENT_CURSORMOVEDC, // cursor was moved in Command line mode
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001403 EVENT_CURSORMOVEDI, // cursor was moved in Insert mode
1404 EVENT_DIFFUPDATED, // after diffs were updated
1405 EVENT_DIRCHANGED, // after user changed directory
Bram Moolenaar28e8f732022-02-09 12:58:20 +00001406 EVENT_DIRCHANGEDPRE, // before directory changes
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001407 EVENT_ENCODINGCHANGED, // after changing the 'encoding' option
1408 EVENT_EXITPRE, // before exiting
1409 EVENT_FILEAPPENDCMD, // append to a file using command
1410 EVENT_FILEAPPENDPOST, // after appending to a file
1411 EVENT_FILEAPPENDPRE, // before appending to a file
1412 EVENT_FILECHANGEDRO, // before first change to read-only file
1413 EVENT_FILECHANGEDSHELL, // after shell command that changed file
1414 EVENT_FILECHANGEDSHELLPOST, // after (not) reloading changed file
Luuk van Baalb7147f82025-02-08 18:52:39 +01001415 EVENT_FILEENCODING, // UNUSED: FileEncoding == EncodingChanged
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001416 EVENT_FILEREADCMD, // read from a file using command
1417 EVENT_FILEREADPOST, // after reading a file
1418 EVENT_FILEREADPRE, // before reading a file
1419 EVENT_FILETYPE, // new file type detected (user defined)
1420 EVENT_FILEWRITECMD, // write to a file using command
1421 EVENT_FILEWRITEPOST, // after writing a file
1422 EVENT_FILEWRITEPRE, // before writing a file
1423 EVENT_FILTERREADPOST, // after reading from a filter
1424 EVENT_FILTERREADPRE, // before reading from a filter
1425 EVENT_FILTERWRITEPOST, // after writing to a filter
1426 EVENT_FILTERWRITEPRE, // before writing to a filter
1427 EVENT_FOCUSGAINED, // got the focus
1428 EVENT_FOCUSLOST, // lost the focus to another app
1429 EVENT_FUNCUNDEFINED, // if calling a function which doesn't exist
1430 EVENT_GUIENTER, // after starting the GUI
1431 EVENT_GUIFAILED, // after starting the GUI failed
1432 EVENT_INSERTCHANGE, // when changing Insert/Replace mode
1433 EVENT_INSERTCHARPRE, // before inserting a char
1434 EVENT_INSERTENTER, // when entering Insert mode
Bram Moolenaarb53e13a2020-10-21 12:19:53 +02001435 EVENT_INSERTLEAVE, // just after leaving Insert mode
Luuk van Baalb7147f82025-02-08 18:52:39 +01001436 EVENT_INSERTLEAVEPRE, // just before leaving Insert mode
Shougo Matsushita83678842024-07-11 22:05:12 +02001437 EVENT_KEYINPUTPRE, // before key input
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001438 EVENT_MENUPOPUP, // just before popup menu is displayed
=?UTF-8?q?Magnus=20Gro=C3=9F?=f1e88762021-09-12 13:39:55 +02001439 EVENT_MODECHANGED, // after changing the mode
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001440 EVENT_OPTIONSET, // option was set
1441 EVENT_QUICKFIXCMDPOST, // after :make, :grep etc.
1442 EVENT_QUICKFIXCMDPRE, // before :make, :grep etc.
1443 EVENT_QUITPRE, // before :quit
1444 EVENT_REMOTEREPLY, // upon string reception from a remote vim
Bram Moolenaar8aeec402019-09-15 23:02:04 +02001445 EVENT_SAFESTATE, // going to wait for a character
Bram Moolenaar69198cb2019-09-16 21:58:13 +02001446 EVENT_SAFESTATEAGAIN, // still waiting for a character
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001447 EVENT_SESSIONLOADPOST, // after loading a session file
Colin Kennedye5f22802024-03-26 18:20:16 +01001448 EVENT_SESSIONWRITEPOST, // after writing a session file
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001449 EVENT_SHELLCMDPOST, // after ":!cmd"
1450 EVENT_SHELLFILTERPOST, // after ":1,2!cmd", ":w !cmd", ":r !cmd".
Bram Moolenaarbe5ee862020-06-10 20:56:58 +02001451 EVENT_SIGUSR1, // after the SIGUSR1 signal
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001452 EVENT_SOURCECMD, // sourcing a Vim script using command
Bram Moolenaar2b618522019-01-12 13:26:03 +01001453 EVENT_SOURCEPOST, // after sourcing a Vim script
Luuk van Baalb7147f82025-02-08 18:52:39 +01001454 EVENT_SOURCEPRE, // before sourcing a Vim script
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001455 EVENT_SPELLFILEMISSING, // spell file missing
1456 EVENT_STDINREADPOST, // after reading from stdin
1457 EVENT_STDINREADPRE, // before reading from stdin
1458 EVENT_SWAPEXISTS, // found existing swap file
1459 EVENT_SYNTAX, // syntax selected
1460 EVENT_TABCLOSED, // after closing a tab page
Jim Zhou5606ca52025-03-13 21:58:25 +01001461 EVENT_TABCLOSEDPRE, // before closing a tab page
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001462 EVENT_TABENTER, // after entering a tab page
1463 EVENT_TABLEAVE, // before leaving a tab page
1464 EVENT_TABNEW, // when entering a new tab page
1465 EVENT_TERMCHANGED, // after changing 'term'
1466 EVENT_TERMINALOPEN, // after a terminal buffer was created
Bram Moolenaarb53e13a2020-10-21 12:19:53 +02001467 EVENT_TERMINALWINOPEN, // after a terminal buffer was created and
1468 // entering its window
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001469 EVENT_TERMRESPONSE, // after setting "v:termresponse"
Danek Duvalld7d56032024-01-14 20:19:59 +01001470 EVENT_TERMRESPONSEALL, // after setting terminal response vars
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001471 EVENT_TEXTCHANGED, // text was modified not in Insert mode
Bram Moolenaar6ed545e2022-05-09 20:09:23 +01001472 EVENT_TEXTCHANGEDI, // text was modified in Insert mode
1473 EVENT_TEXTCHANGEDP, // TextChangedI with popup menu visible
Shougo Matsushita4ccaedf2022-10-15 11:48:00 +01001474 EVENT_TEXTCHANGEDT, // text was modified in Terminal mode
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001475 EVENT_TEXTYANKPOST, // after some text was yanked
1476 EVENT_USER, // user defined autocommand
1477 EVENT_VIMENTER, // after starting Vim
1478 EVENT_VIMLEAVE, // before exiting Vim
1479 EVENT_VIMLEAVEPRE, // before exiting Vim and writing .viminfo
1480 EVENT_VIMRESIZED, // after Vim window was resized
Luuk van Baalb7147f82025-02-08 18:52:39 +01001481 EVENT_VIMRESUME, // after Vim is resumed
1482 EVENT_VIMSUSPEND, // before Vim is suspended
1483 EVENT_WINCLOSED, // after closing a window
Bram Moolenaare8fa05b2018-09-16 15:48:06 +02001484 EVENT_WINENTER, // after entering a window
1485 EVENT_WINLEAVE, // before leaving a window
Sergey Vlasov1f47db72024-01-25 23:07:00 +01001486 EVENT_WINNEW, // after creating a new window
Luuk van Baalb7147f82025-02-08 18:52:39 +01001487 EVENT_WINNEWPRE, // before creating a new window
Bram Moolenaar35fc61c2022-11-22 12:40:50 +00001488 EVENT_WINRESIZED, // after a window was resized
1489 EVENT_WINSCROLLED, // after a window was scrolled or resized
Bram Moolenaare87303a2018-03-11 17:02:12 +01001490
Luuk van Baalb7147f82025-02-08 18:52:39 +01001491 NUM_EVENTS, // MUST be the last one
Bram Moolenaar071d4272004-06-13 20:20:40 +00001492};
1493
Bram Moolenaarcf0c5542006-02-09 23:48:02 +00001494typedef enum auto_event event_T;
Bram Moolenaar071d4272004-06-13 20:20:40 +00001495
1496/*
1497 * Values for index in highlight_attr[].
Gianmaria Bajo6a7c7742023-03-10 16:35:53 +00001498 * When making changes, also update HL_FLAGS below!
1499 * And update the default value of 'highlight': HIGHLIGHT_INIT in optiondefs.h
Bram Moolenaar071d4272004-06-13 20:20:40 +00001500 */
Bram Moolenaar482aaeb2005-09-29 18:26:07 +00001501typedef enum
Bram Moolenaar071d4272004-06-13 20:20:40 +00001502{
Bram Moolenaarc3308352019-09-01 16:24:56 +02001503 HLF_8 = 0 // Meta & special keys listed with ":map", text that is
1504 // displayed different from what it is
1505 , HLF_EOB // after the last line in the buffer
1506 , HLF_AT // @ characters at end of screen, characters that
1507 // don't really exist in the text
1508 , HLF_D // directories in CTRL-D listing
1509 , HLF_E // error messages
1510 , HLF_H // obsolete, ignored
1511 , HLF_I // incremental search
1512 , HLF_L // last search string
LemonBoya4399382022-04-09 21:04:08 +01001513 , HLF_LC // last search string under cursor
Bram Moolenaarc3308352019-09-01 16:24:56 +02001514 , HLF_M // "--More--" message
1515 , HLF_CM // Mode (e.g., "-- INSERT --")
1516 , HLF_N // line number for ":number" and ":#" commands
Bram Moolenaarefae76a2019-10-27 22:54:58 +01001517 , HLF_LNA // LineNrAbove
1518 , HLF_LNB // LineNrBelow
Bram Moolenaarc3308352019-09-01 16:24:56 +02001519 , HLF_CLN // current line number
Bram Moolenaare413ea02021-11-24 16:20:13 +00001520 , HLF_CLS // current line sign column
1521 , HLF_CLF // current line fold
Bram Moolenaarc3308352019-09-01 16:24:56 +02001522 , HLF_R // return to continue message and yes/no questions
1523 , HLF_S // status lines
1524 , HLF_SNC // status lines of not-current windows
1525 , HLF_C // column to separate vertically split windows
1526 , HLF_T // Titles for output from ":set all", ":autocmd" etc.
1527 , HLF_V // Visual mode
1528 , HLF_VNC // Visual mode, autoselecting and not clipboard owner
1529 , HLF_W // warning messages
1530 , HLF_WM // Wildmenu highlight
1531 , HLF_FL // Folded line
1532 , HLF_FC // Fold column
1533 , HLF_ADD // Added diff line
1534 , HLF_CHD // Changed diff line
1535 , HLF_DED // Deleted diff line
Yee Cheng Chin9943d472025-03-26 19:41:02 +01001536 , HLF_TXD // Text Changed in changed diff line
1537 , HLF_TXA // Text Added in changed diff line
Bram Moolenaarc3308352019-09-01 16:24:56 +02001538 , HLF_CONCEAL // Concealed text
1539 , HLF_SC // Sign column
1540 , HLF_SPB // SpellBad
1541 , HLF_SPC // SpellCap
1542 , HLF_SPR // SpellRare
1543 , HLF_SPL // SpellLocal
1544 , HLF_PNI // popup menu normal item
1545 , HLF_PSI // popup menu selected item
glepnir40c1c332024-06-11 19:37:04 +02001546 , HLF_PMNI // popup menu matched text in normal item
1547 , HLF_PMSI // popup menu matched text in selected item
Gianmaria Bajo6a7c7742023-03-10 16:35:53 +00001548 , HLF_PNK // popup menu normal item "kind"
1549 , HLF_PSK // popup menu selected item "kind"
1550 , HLF_PNX // popup menu normal item "menu" (extra text)
1551 , HLF_PSX // popup menu selected item "menu" (extra text)
Bram Moolenaarc3308352019-09-01 16:24:56 +02001552 , HLF_PSB // popup menu scrollbar
1553 , HLF_PST // popup menu scrollbar thumb
1554 , HLF_TP // tabpage line
1555 , HLF_TPS // tabpage line selected
1556 , HLF_TPF // tabpage line filler
1557 , HLF_CUC // 'cursorcolumn'
1558 , HLF_CUL // 'cursorline'
1559 , HLF_MC // 'colorcolumn'
1560 , HLF_QFL // quickfix window line currently selected
1561 , HLF_ST // status lines of terminal windows
1562 , HLF_STNC // status lines of not-current terminal windows
Shougo Matsushitabe2b03c2024-04-08 22:11:50 +02001563 , HLF_MSG // message area
Naruhiko Nishinobe5bd4d2025-05-14 21:20:28 +02001564 , HLF_TPL // tabpanel
1565 , HLF_TPLS // tabpanel selected
1566 , HLF_TPLF // tabpanel filler
Bram Moolenaarc3308352019-09-01 16:24:56 +02001567 , HLF_COUNT // MUST be the last one
Bram Moolenaar482aaeb2005-09-29 18:26:07 +00001568} hlf_T;
Bram Moolenaar071d4272004-06-13 20:20:40 +00001569
Bram Moolenaarc3308352019-09-01 16:24:56 +02001570// The HL_FLAGS must be in the same order as the HLF_ enums!
1571// When changing this also adjust the default for 'highlight'.
LemonBoya4399382022-04-09 21:04:08 +01001572#define HL_FLAGS {'8', '~', '@', 'd', 'e', 'h', 'i', 'l', 'y', 'm', 'M', \
Bram Moolenaare413ea02021-11-24 16:20:13 +00001573 'n', 'a', 'b', 'N', 'G', 'O', 'r', 's', 'S', 'c', 't', 'v', 'V', \
Yee Cheng Chin9943d472025-03-26 19:41:02 +01001574 'w', 'W', 'f', 'F', 'A', 'C', 'D', 'T', 'E', '-', '>', \
Bram Moolenaarbb15b652005-10-03 21:52:09 +00001575 'B', 'P', 'R', 'L', \
glepnir40c1c332024-06-11 19:37:04 +02001576 '+', '=', 'k', '<','[', ']', '{', '}', 'x', 'X', \
Gianmaria Bajo6a7c7742023-03-10 16:35:53 +00001577 '*', '#', '_', '!', '.', 'o', 'q', \
Naruhiko Nishinobe5bd4d2025-05-14 21:20:28 +02001578 'z', 'Z', 'g', \
1579 '%', '^', '&' }
Bram Moolenaar071d4272004-06-13 20:20:40 +00001580
1581/*
Christ van Willegen - van Noort8e4c4c72024-05-17 18:49:27 +02001582 * Values for behaviour in spell_move_to
1583 */
1584typedef enum
1585{
1586 SMT_ALL = 0 // Move to "all" words
1587 , SMT_BAD // Move to "bad" words only
1588 , SMT_RARE // Move to "rare" words only
1589} smt_T;
1590/*
Bram Moolenaar071d4272004-06-13 20:20:40 +00001591 * Boolean constants
1592 */
1593#ifndef TRUE
Bram Moolenaarc3308352019-09-01 16:24:56 +02001594# define FALSE 0 // note: this is an int, not a long!
Bram Moolenaar071d4272004-06-13 20:20:40 +00001595# define TRUE 1
1596#endif
1597
Bram Moolenaarc3308352019-09-01 16:24:56 +02001598#define MAYBE 2 // sometimes used for a variant on TRUE
Bram Moolenaar071d4272004-06-13 20:20:40 +00001599
Bram Moolenaar1d97db32022-06-04 22:15:54 +01001600#define LOG_ALWAYS 9 // must be different from TRUE and FALSE
1601
1602#ifdef FEAT_JOB_CHANNEL
1603// If "--log logfile" was used or ch_logfile() was called then log some or all
1604// terminal output.
1605# define MAY_WANT_TO_LOG_THIS if (ch_log_output == FALSE) ch_log_output = TRUE;
1606#else
1607// no logging support
1608# define MAY_WANT_TO_LOG_THIS
1609#endif
1610
Bram Moolenaar7db5fc82010-05-24 11:59:29 +02001611#ifndef UINT32_T
1612typedef UINT32_TYPEDEF UINT32_T;
1613#endif
1614
Bram Moolenaar071d4272004-06-13 20:20:40 +00001615/*
1616 * Operator IDs; The order must correspond to opchars[] in ops.c!
1617 */
Bram Moolenaarc3308352019-09-01 16:24:56 +02001618#define OP_NOP 0 // no pending operation
1619#define OP_DELETE 1 // "d" delete operator
1620#define OP_YANK 2 // "y" yank operator
1621#define OP_CHANGE 3 // "c" change operator
1622#define OP_LSHIFT 4 // "<" left shift operator
1623#define OP_RSHIFT 5 // ">" right shift operator
1624#define OP_FILTER 6 // "!" filter operator
1625#define OP_TILDE 7 // "g~" switch case operator
1626#define OP_INDENT 8 // "=" indent operator
1627#define OP_FORMAT 9 // "gq" format operator
1628#define OP_COLON 10 // ":" colon operator
1629#define OP_UPPER 11 // "gU" make upper case operator
1630#define OP_LOWER 12 // "gu" make lower case operator
1631#define OP_JOIN 13 // "J" join operator, only for Visual mode
1632#define OP_JOIN_NS 14 // "gJ" join operator, only for Visual mode
1633#define OP_ROT13 15 // "g?" rot-13 encoding
1634#define OP_REPLACE 16 // "r" replace chars, only for Visual mode
1635#define OP_INSERT 17 // "I" Insert column, only for Visual mode
1636#define OP_APPEND 18 // "A" Append column, only for Visual mode
1637#define OP_FOLD 19 // "zf" define a fold
1638#define OP_FOLDOPEN 20 // "zo" open folds
1639#define OP_FOLDOPENREC 21 // "zO" open folds recursively
1640#define OP_FOLDCLOSE 22 // "zc" close folds
1641#define OP_FOLDCLOSEREC 23 // "zC" close folds recursively
1642#define OP_FOLDDEL 24 // "zd" delete folds
1643#define OP_FOLDDELREC 25 // "zD" delete folds recursively
1644#define OP_FORMAT2 26 // "gw" format operator, keeps cursor pos
1645#define OP_FUNCTION 27 // "g@" call 'operatorfunc'
1646#define OP_NR_ADD 28 // "<C-A>" Add to the number or alphabetic
1647 // character (OP_ADD conflicts with Perl)
1648#define OP_NR_SUB 29 // "<C-X>" Subtract from the number or
1649 // alphabetic character
Bram Moolenaar071d4272004-06-13 20:20:40 +00001650
1651/*
1652 * Motion types, used for operators and for yank/delete registers.
1653 */
Bram Moolenaarc3308352019-09-01 16:24:56 +02001654#define MCHAR 0 // character-wise movement/register
1655#define MLINE 1 // line-wise movement/register
1656#define MBLOCK 2 // block-wise register
Bram Moolenaar071d4272004-06-13 20:20:40 +00001657
Bram Moolenaarc3308352019-09-01 16:24:56 +02001658#define MAUTO 0xff // Decide between MLINE/MCHAR
Bram Moolenaar071d4272004-06-13 20:20:40 +00001659
1660/*
1661 * Minimum screen size
1662 */
Bram Moolenaarc3308352019-09-01 16:24:56 +02001663#define MIN_COLUMNS 12 // minimal columns for screen
1664#define MIN_LINES 2 // minimal lines for screen
Milly2cddf0e2024-11-28 18:16:55 +01001665#define MIN_CMDHEIGHT 1 // minimal height for command line
Bram Moolenaarc3308352019-09-01 16:24:56 +02001666#define STATUS_HEIGHT 1 // height of a status line under a window
1667#ifdef FEAT_MENU // height of a status line under a window
Bram Moolenaar3167c3e2017-11-25 14:19:43 +01001668# define WINBAR_HEIGHT(wp) (wp)->w_winbar_height
Bram Moolenaar415a6932017-12-05 20:31:07 +01001669# define VISIBLE_HEIGHT(wp) ((wp)->w_height + (wp)->w_winbar_height)
Bram Moolenaar3167c3e2017-11-25 14:19:43 +01001670#else
1671# define WINBAR_HEIGHT(wp) 0
Bram Moolenaar415a6932017-12-05 20:31:07 +01001672# define VISIBLE_HEIGHT(wp) (wp)->w_height
Bram Moolenaar3167c3e2017-11-25 14:19:43 +01001673#endif
Bram Moolenaarc3308352019-09-01 16:24:56 +02001674#define QF_WINHEIGHT 10 // default height for quickfix window
Bram Moolenaar071d4272004-06-13 20:20:40 +00001675
1676/*
1677 * Buffer sizes
1678 */
1679#ifndef CMDBUFFSIZE
Bram Moolenaarc3308352019-09-01 16:24:56 +02001680# define CMDBUFFSIZE 256 // size of the command processing buffer
Bram Moolenaar071d4272004-06-13 20:20:40 +00001681#endif
1682
Bram Moolenaarc3308352019-09-01 16:24:56 +02001683#define LSIZE 512 // max. size of a line in the tags file
Bram Moolenaar071d4272004-06-13 20:20:40 +00001684
Bram Moolenaarc3308352019-09-01 16:24:56 +02001685#define IOSIZE (1024+1) // file i/o and sprintf buffer size
Bram Moolenaard9d30582005-05-18 22:10:28 +00001686
Bram Moolenaarc3308352019-09-01 16:24:56 +02001687#define DIALOG_MSG_SIZE 1000 // buffer size for dialog_msg()
Bram Moolenaard9462e32011-04-11 21:35:11 +02001688
Bram Moolenaarc3308352019-09-01 16:24:56 +02001689#define MSG_BUF_LEN 480 // length of buffer for small messages
1690#define MSG_BUF_CLEN (MSG_BUF_LEN / 6) // cell length (worst case: utf-8
1691 // takes 6 bytes for one cell)
Bram Moolenaar071d4272004-06-13 20:20:40 +00001692
Bram Moolenaarc3308352019-09-01 16:24:56 +02001693#define FOLD_TEXT_LEN 51 // buffer size for get_foldtext()
Bram Moolenaaree695f72016-08-03 22:08:45 +02001694
Bram Moolenaarc3308352019-09-01 16:24:56 +02001695// Size of the buffer used for tgetent(). Unfortunately this is largely
1696// undocumented, some systems use 1024. Using a buffer that is too small
1697// causes a buffer overrun and a crash. Use the maximum known value to stay
1698// on the safe side.
1699#define TBUFSZ 2048 // buffer size for termcap entry
Bram Moolenaar071d4272004-06-13 20:20:40 +00001700
1701/*
1702 * Maximum length of key sequence to be mapped.
1703 * Must be able to hold an Amiga resize report.
1704 */
1705#define MAXMAPLEN 50
1706
Bram Moolenaarc0ceeeb2022-03-30 21:12:27 +01001707// maximum length of a function name, including SID and NUL
1708#define MAX_FUNC_NAME_LEN 200
1709
Bram Moolenaarc3308352019-09-01 16:24:56 +02001710// Size in bytes of the hash used in the undo file.
Bram Moolenaar55debbe2010-05-23 23:34:36 +02001711#define UNDO_HASH_SIZE 32
1712
Bram Moolenaara7241f52008-06-24 20:39:31 +00001713#ifdef HAVE_FCNTL_H
1714# include <fcntl.h>
1715#endif
1716
Bram Moolenaar071d4272004-06-13 20:20:40 +00001717#ifdef BINARY_FILE_IO
Bram Moolenaarc3308352019-09-01 16:24:56 +02001718# define WRITEBIN "wb" // no CR-LF translation
Bram Moolenaar071d4272004-06-13 20:20:40 +00001719# define READBIN "rb"
1720# define APPENDBIN "ab"
1721#else
1722# define WRITEBIN "w"
1723# define READBIN "r"
1724# define APPENDBIN "a"
1725#endif
1726
1727/*
K.Takatab247e062022-02-07 10:45:23 +00001728 * Cygwin doesn't have a global way of making open() use binary I/O.
Bram Moolenaar071d4272004-06-13 20:20:40 +00001729 * Use O_BINARY for all open() calls.
1730 */
K.Takatab247e062022-02-07 10:45:23 +00001731#ifdef __CYGWIN__
Bram Moolenaar071d4272004-06-13 20:20:40 +00001732# define O_EXTRA O_BINARY
1733#else
1734# define O_EXTRA 0
1735#endif
1736
Bram Moolenaara5792f52005-11-23 21:25:05 +00001737#ifndef O_NOFOLLOW
1738# define O_NOFOLLOW 0
1739#endif
1740
Bram Moolenaar071d4272004-06-13 20:20:40 +00001741#ifndef W_OK
Bram Moolenaarc3308352019-09-01 16:24:56 +02001742# define W_OK 2 // for systems that don't have W_OK in unistd.h
Bram Moolenaar071d4272004-06-13 20:20:40 +00001743#endif
1744#ifndef R_OK
Bram Moolenaarc3308352019-09-01 16:24:56 +02001745# define R_OK 4 // for systems that don't have R_OK in unistd.h
Bram Moolenaar071d4272004-06-13 20:20:40 +00001746#endif
1747
Bram Moolenaarc799fe22019-05-28 23:08:19 +02001748// Allocate memory for one type and cast the returned pointer to have the
1749// compiler check the types.
1750#define ALLOC_ONE(type) (type *)alloc(sizeof(type))
Yegappan Lakshmanan5a2d4a32022-02-26 10:31:32 +00001751#define ALLOC_ONE_ID(type, id) (type *)alloc_id(sizeof(type), id)
Bram Moolenaarc799fe22019-05-28 23:08:19 +02001752#define ALLOC_MULT(type, count) (type *)alloc(sizeof(type) * (count))
1753#define ALLOC_CLEAR_ONE(type) (type *)alloc_clear(sizeof(type))
Yegappan Lakshmanan5a2d4a32022-02-26 10:31:32 +00001754#define ALLOC_CLEAR_ONE_ID(type, id) (type *)alloc_clear_id(sizeof(type), id)
Bram Moolenaarc799fe22019-05-28 23:08:19 +02001755#define ALLOC_CLEAR_MULT(type, count) (type *)alloc_clear(sizeof(type) * (count))
1756#define LALLOC_CLEAR_ONE(type) (type *)lalloc_clear(sizeof(type), FALSE)
1757#define LALLOC_CLEAR_MULT(type, count) (type *)lalloc_clear(sizeof(type) * (count), FALSE)
1758#define LALLOC_MULT(type, count) (type *)lalloc(sizeof(type) * (count), FALSE)
1759
Bram Moolenaara80faa82020-04-12 19:37:17 +02001760#ifdef HAVE_MEMSET
1761# define vim_memset(ptr, c, size) memset((ptr), (c), (size))
1762#else
1763void *vim_memset(void *, int, size_t);
1764#endif
1765#define CLEAR_FIELD(field) vim_memset(&(field), 0, sizeof(field))
1766#define CLEAR_POINTER(ptr) vim_memset((ptr), 0, sizeof(*(ptr)))
1767
Bram Moolenaar071d4272004-06-13 20:20:40 +00001768/*
1769 * defines to avoid typecasts from (char_u *) to (char *) and back
Bram Moolenaar944cc9c2022-06-27 22:17:37 +01001770 * (vim_strchr() and vim_strrchr() are now in strings.c)
Bram Moolenaar071d4272004-06-13 20:20:40 +00001771 */
1772#define STRLEN(s) strlen((char *)(s))
1773#define STRCPY(d, s) strcpy((char *)(d), (char *)(s))
1774#define STRNCPY(d, s, n) strncpy((char *)(d), (char *)(s), (size_t)(n))
1775#define STRCMP(d, s) strcmp((char *)(d), (char *)(s))
1776#define STRNCMP(d, s, n) strncmp((char *)(d), (char *)(s), (size_t)(n))
1777#ifdef HAVE_STRCASECMP
1778# define STRICMP(d, s) strcasecmp((char *)(d), (char *)(s))
1779#else
1780# ifdef HAVE_STRICMP
1781# define STRICMP(d, s) stricmp((char *)(d), (char *)(s))
1782# else
1783# define STRICMP(d, s) vim_stricmp((char *)(d), (char *)(s))
1784# endif
1785#endif
Bram Moolenaar84cf6bd2020-06-16 20:03:43 +02001786#ifdef HAVE_STRCOLL
1787# define STRCOLL(d, s) strcoll((char *)(d), (char *)(s))
1788#else
1789# define STRCOLL(d, s) strcmp((char *)(d), (char *)(s))
1790#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00001791
Bram Moolenaarc3308352019-09-01 16:24:56 +02001792// Like strcpy() but allows overlapped source and destination.
Bram Moolenaara7241f52008-06-24 20:39:31 +00001793#define STRMOVE(d, s) mch_memmove((d), (s), STRLEN(s) + 1)
1794
Bram Moolenaar071d4272004-06-13 20:20:40 +00001795#ifdef HAVE_STRNCASECMP
1796# define STRNICMP(d, s, n) strncasecmp((char *)(d), (char *)(s), (size_t)(n))
1797#else
1798# ifdef HAVE_STRNICMP
1799# define STRNICMP(d, s, n) strnicmp((char *)(d), (char *)(s), (size_t)(n))
1800# else
1801# define STRNICMP(d, s, n) vim_strnicmp((char *)(d), (char *)(s), (size_t)(n))
1802# endif
1803#endif
1804
Bram Moolenaarc3308352019-09-01 16:24:56 +02001805// We need to call mb_stricmp() even when we aren't dealing with a multi-byte
1806// encoding because mb_stricmp() takes care of all ascii and non-ascii
1807// encodings, including characters with umlauts in latin1, etc., while
1808// STRICMP() only handles the system locale version, which often does not
1809// handle non-ascii properly.
Bram Moolenaara245a5b2007-08-11 11:58:23 +00001810
1811# define MB_STRICMP(d, s) mb_strnicmp((char_u *)(d), (char_u *)(s), (int)MAXCOL)
1812# define MB_STRNICMP(d, s, n) mb_strnicmp((char_u *)(d), (char_u *)(s), (int)(n))
Christian Brabandt22e8e122024-07-30 20:39:18 +02001813# define MB_STRNICMP2(d, s, n1, n2) mb_strnicmp2((char_u *)(d), (char_u *)(s), (n1), (n2))
Bram Moolenaar071d4272004-06-13 20:20:40 +00001814
1815#define STRCAT(d, s) strcat((char *)(d), (char *)(s))
1816#define STRNCAT(d, s, n) strncat((char *)(d), (char *)(s), (size_t)(n))
1817
1818#ifdef HAVE_STRPBRK
1819# define vim_strpbrk(s, cs) (char_u *)strpbrk((char *)(s), (char *)(cs))
1820#endif
1821
Bram Moolenaar071d4272004-06-13 20:20:40 +00001822#define OUT_STR(s) out_str((char_u *)(s))
1823#define OUT_STR_NF(s) out_str_nf((char_u *)(s))
Bram Moolenaar071d4272004-06-13 20:20:40 +00001824
Bram Moolenaar8a633e32016-04-21 21:10:14 +02001825#ifdef FEAT_GUI
Bram Moolenaar61be73b2016-04-29 22:59:22 +02001826# ifdef FEAT_TERMGUICOLORS
1827# define GUI_FUNCTION(f) (gui.in_use ? gui_##f : termgui_##f)
Bram Moolenaar187147a2016-05-01 13:09:57 +02001828# define GUI_FUNCTION2(f, pixel) (gui.in_use \
1829 ? ((pixel) != INVALCOLOR \
1830 ? gui_##f((pixel)) \
Bram Moolenaar424d74b2016-08-25 23:02:11 +02001831 : INVALCOLOR) \
Bram Moolenaar187147a2016-05-01 13:09:57 +02001832 : termgui_##f((pixel)))
Bram Moolenaar61be73b2016-04-29 22:59:22 +02001833# define USE_24BIT (gui.in_use || p_tgc)
Bram Moolenaar8a633e32016-04-21 21:10:14 +02001834# else
1835# define GUI_FUNCTION(f) gui_##f
Bram Moolenaar187147a2016-05-01 13:09:57 +02001836# define GUI_FUNCTION2(f,pixel) ((pixel) != INVALCOLOR \
1837 ? gui_##f((pixel)) \
Bram Moolenaar424d74b2016-08-25 23:02:11 +02001838 : INVALCOLOR)
Bram Moolenaar8a633e32016-04-21 21:10:14 +02001839# define USE_24BIT gui.in_use
1840# endif
1841#else
Bram Moolenaar61be73b2016-04-29 22:59:22 +02001842# ifdef FEAT_TERMGUICOLORS
1843# define GUI_FUNCTION(f) termgui_##f
Bram Moolenaar187147a2016-05-01 13:09:57 +02001844# define GUI_FUNCTION2(f, pixel) termgui_##f((pixel))
Bram Moolenaar61be73b2016-04-29 22:59:22 +02001845# define USE_24BIT p_tgc
Bram Moolenaar8a633e32016-04-21 21:10:14 +02001846# endif
1847#endif
Bram Moolenaar61be73b2016-04-29 22:59:22 +02001848#ifdef FEAT_TERMGUICOLORS
1849# define IS_CTERM (t_colors > 1 || p_tgc)
Bram Moolenaar8a633e32016-04-21 21:10:14 +02001850#else
1851# define IS_CTERM (t_colors > 1)
1852#endif
1853#ifdef GUI_FUNCTION
1854# define GUI_MCH_GET_RGB GUI_FUNCTION(mch_get_rgb)
Bram Moolenaar187147a2016-05-01 13:09:57 +02001855# define GUI_MCH_GET_RGB2(pixel) GUI_FUNCTION2(mch_get_rgb, (pixel))
Bram Moolenaar8a633e32016-04-21 21:10:14 +02001856# define GUI_MCH_GET_COLOR GUI_FUNCTION(mch_get_color)
1857# define GUI_GET_COLOR GUI_FUNCTION(get_color)
1858#endif
1859
Bram Moolenaarc3308352019-09-01 16:24:56 +02001860// Prefer using emsgf(), because perror() may send the output to the wrong
1861// destination and mess up the screen.
Bram Moolenaar071d4272004-06-13 20:20:40 +00001862#ifdef HAVE_STRERROR
kylo2529dac9b12022-03-27 20:05:17 +01001863# define PERROR(msg) (void)semsg("%s: %s", (char *)(msg), strerror(errno))
Bram Moolenaar071d4272004-06-13 20:20:40 +00001864#else
Bram Moolenaarb869c0d2016-07-20 00:10:51 +02001865# define PERROR(msg) do_perror(msg)
Bram Moolenaar071d4272004-06-13 20:20:40 +00001866#endif
1867
Bram Moolenaarc3308352019-09-01 16:24:56 +02001868typedef long linenr_T; // line number type
1869typedef int colnr_T; // column number type
1870typedef unsigned short disptick_T; // display tick type
Bram Moolenaar071d4272004-06-13 20:20:40 +00001871
Bram Moolenaar071d4272004-06-13 20:20:40 +00001872/*
1873 * Well, you won't believe it, but some S/390 machines ("host", now also known
Bram Moolenaar883f5d02010-06-21 06:24:34 +02001874 * as zServer) use 31 bit pointers. There are also some newer machines, that
Bram Moolenaar071d4272004-06-13 20:20:40 +00001875 * use 64 bit pointers. I don't know how to distinguish between 31 and 64 bit
1876 * machines, so the best way is to assume 31 bits whenever we detect OS/390
1877 * Unix.
1878 * With this we restrict the maximum line length to 1073741823. I guess this is
1879 * not a real problem. BTW: Longer lines are split.
1880 */
Bram Moolenaar30276f22019-01-24 17:59:39 +01001881#ifdef __MVS__
Bram Moolenaarc9629252019-02-19 21:24:54 +01001882# define MAXCOL (0x3fffffffL) // maximum column number, 30 bits
1883# define MAXLNUM (0x3fffffffL) // maximum (invalid) line number
Bram Moolenaar071d4272004-06-13 20:20:40 +00001884#else
Bram Moolenaar8e385552022-02-12 21:16:21 +00001885 // MAXCOL used to be INT_MAX, but with 64 bit ints that results in running
1886 // out of memory when trying to allocate a very long line.
1887# define MAXCOL 0x7fffffffL // maximum column number
Bram Moolenaarc9629252019-02-19 21:24:54 +01001888# define MAXLNUM LONG_MAX // maximum (invalid) line number
Bram Moolenaar071d4272004-06-13 20:20:40 +00001889#endif
1890
Bram Moolenaarc9629252019-02-19 21:24:54 +01001891#define SHOWCMD_COLS 10 // columns needed by shown command
Bram Moolenaar071d4272004-06-13 20:20:40 +00001892
Bram Moolenaarc9629252019-02-19 21:24:54 +01001893typedef void *vim_acl_T; // dummy to pass an ACL to a function
Bram Moolenaar071d4272004-06-13 20:20:40 +00001894
Bram Moolenaar52c0de12017-01-26 21:36:34 +01001895#ifndef mch_memmove
Bram Moolenaar3a118be2017-01-27 21:22:19 +01001896# define mch_memmove(to, from, len) memmove((char*)(to), (char*)(from), (size_t)(len))
Bram Moolenaar071d4272004-06-13 20:20:40 +00001897#endif
1898
1899/*
1900 * fnamecmp() is used to compare file names.
1901 * On some systems case in a file name does not matter, on others it does.
1902 * (this does not account for maximum name lengths and things like "../dir",
1903 * thus it is not 100% accurate!)
1904 */
Bram Moolenaar71afbfe2013-03-19 16:49:16 +01001905#define fnamecmp(x, y) vim_fnamecmp((char_u *)(x), (char_u *)(y))
1906#define fnamencmp(x, y, n) vim_fnamencmp((char_u *)(x), (char_u *)(y), (size_t)(n))
Bram Moolenaar071d4272004-06-13 20:20:40 +00001907
Bram Moolenaare7fedb62015-12-31 19:07:19 +01001908#if defined(UNIX) || defined(FEAT_GUI) || defined(VMS) \
Bram Moolenaar071d4272004-06-13 20:20:40 +00001909 || defined(FEAT_CLIENTSERVER)
1910# define USE_INPUT_BUF
1911#endif
1912
Bram Moolenaar540fc6f2010-12-17 16:27:16 +01001913#ifndef EINTR
1914# define read_eintr(fd, buf, count) vim_read((fd), (buf), (count))
1915# define write_eintr(fd, buf, count) vim_write((fd), (buf), (count))
1916#endif
1917
Bram Moolenaar071d4272004-06-13 20:20:40 +00001918#ifdef MSWIN
Bram Moolenaarc3308352019-09-01 16:24:56 +02001919// On MS-Windows the third argument isn't size_t. This matters for Win64,
1920// where sizeof(size_t)==8, not 4
Bram Moolenaar071d4272004-06-13 20:20:40 +00001921# define vim_read(fd, buf, count) read((fd), (char *)(buf), (unsigned int)(count))
1922# define vim_write(fd, buf, count) write((fd), (char *)(buf), (unsigned int)(count))
1923#else
1924# define vim_read(fd, buf, count) read((fd), (char *)(buf), (size_t) (count))
1925# define vim_write(fd, buf, count) write((fd), (char *)(buf), (size_t) (count))
1926#endif
1927
1928/*
1929 * Enums need a typecast to be used as array index (for Ultrix).
1930 */
Bram Moolenaar8820b482017-03-16 17:23:31 +01001931#define HL_ATTR(n) highlight_attr[(int)(n)]
1932#define TERM_STR(n) term_strings[(int)(n)]
Bram Moolenaar071d4272004-06-13 20:20:40 +00001933
1934/*
Bram Moolenaara226a6d2006-02-26 23:59:20 +00001935 * EXTERN is only defined in main.c. That's where global variables are
1936 * actually defined and initialized.
1937 */
1938#ifndef EXTERN
1939# define EXTERN extern
1940# define INIT(x)
Bram Moolenaarea8b7ae2020-01-01 15:46:47 +01001941# define INIT2(a, b)
1942# define INIT3(a, b, c)
1943# define INIT4(a, b, c, d)
1944# define INIT5(a, b, c, d, e)
Bram Moolenaar5deeb3f2020-04-05 17:08:17 +02001945# define INIT6(a, b, c, d, e, f)
Bram Moolenaara226a6d2006-02-26 23:59:20 +00001946#else
1947# ifndef INIT
1948# define INIT(x) x
Bram Moolenaarea8b7ae2020-01-01 15:46:47 +01001949# define INIT2(a, b) = {a, b}
1950# define INIT3(a, b, c) = {a, b, c}
1951# define INIT4(a, b, c, d) = {a, b, c, d}
1952# define INIT5(a, b, c, d, e) = {a, b, c, d, e}
Bram Moolenaar5deeb3f2020-04-05 17:08:17 +02001953# define INIT6(a, b, c, d, e, f) = {a, b, c, d, e, f}
Bram Moolenaara226a6d2006-02-26 23:59:20 +00001954# define DO_INIT
1955# endif
1956#endif
1957
Bram Moolenaarc3308352019-09-01 16:24:56 +02001958#define MAX_MCO 6 // maximum value for 'maxcombine'
Bram Moolenaar362e1a32006-03-06 23:29:24 +00001959
Bram Moolenaarc3308352019-09-01 16:24:56 +02001960// Maximum number of bytes in a multi-byte character. It can be one 32-bit
1961// character of up to 6 bytes, or one 16-bit character of up to three bytes
1962// plus six following composing characters of three bytes each.
Bram Moolenaar264b74f2019-01-24 17:18:42 +01001963#define MB_MAXBYTES 21
Bram Moolenaar362e1a32006-03-06 23:29:24 +00001964
Bram Moolenaar91a4e822008-01-19 14:59:58 +00001965#if (defined(FEAT_PROFILE) || defined(FEAT_RELTIME)) && !defined(PROTO)
Bram Moolenaar4f974752019-02-17 17:44:42 +01001966# ifdef MSWIN
Bram Moolenaar91a4e822008-01-19 14:59:58 +00001967typedef LARGE_INTEGER proftime_T;
Ernie Rael076de792023-03-16 21:43:15 +00001968# define PROF_TIME_BLANK " "
1969# define PROF_TOTALS_HEADER "count total (s) self (s)"
Bram Moolenaar91a4e822008-01-19 14:59:58 +00001970# else
Ernie Rael076de792023-03-16 21:43:15 +00001971 // Use tv_fsec for fraction of second (micro or nano) of proftime_T
Bram Moolenaar08210f82023-04-13 19:15:54 +01001972# if defined(HAVE_TIMER_CREATE) && defined(HAVE_CLOCK_GETTIME)
1973# define PROF_NSEC 1
Ernie Rael076de792023-03-16 21:43:15 +00001974typedef struct timespec proftime_T;
1975# define PROF_GET_TIME(tm) clock_gettime(CLOCK_MONOTONIC, tm)
1976# define tv_fsec tv_nsec
1977# define TV_FSEC_SEC 1000000000L
1978# define PROF_TIME_FORMAT "%3ld.%09ld"
1979# define PROF_TIME_BLANK " "
1980# define PROF_TOTALS_HEADER "count total (s) self (s)"
1981# else
Bram Moolenaar91a4e822008-01-19 14:59:58 +00001982typedef struct timeval proftime_T;
Ernie Rael076de792023-03-16 21:43:15 +00001983# define PROF_GET_TIME(tm) gettimeofday(tm, NULL)
1984# define tv_fsec tv_usec
1985# define TV_FSEC_SEC 1000000
1986# define PROF_TIME_FORMAT "%3ld.%06ld"
1987# define PROF_TIME_BLANK " "
1988# define PROF_TOTALS_HEADER "count total (s) self (s)"
1989# endif
Bram Moolenaar91a4e822008-01-19 14:59:58 +00001990# endif
1991#else
Bram Moolenaarc3308352019-09-01 16:24:56 +02001992typedef int proftime_T; // dummy for function prototypes
Bram Moolenaar91a4e822008-01-19 14:59:58 +00001993#endif
1994
Bram Moolenaare99d4222021-06-13 14:01:26 +02001995// Type of compilation passed to compile_def_function()
1996typedef enum {
1997 CT_NONE, // use df_instr
1998 CT_PROFILE, // use df_instr_prof
1999 CT_DEBUG // use df_instr_debug, overrules CT_PROFILE
2000} compiletype_T;
2001
Bram Moolenaarf4fba6d2016-06-26 16:44:24 +02002002/*
2003 * When compiling with 32 bit Perl time_t is 32 bits in the Perl code but 64
2004 * bits elsewhere. That causes memory corruption. Define time_T and use it
2005 * for global variables to avoid that.
2006 */
Bram Moolenaard90b6c02016-08-28 18:10:45 +02002007#ifdef PROTO
2008typedef long time_T;
Bram Moolenaarf4fba6d2016-06-26 16:44:24 +02002009#else
Bram Moolenaar4f974752019-02-17 17:44:42 +01002010# ifdef MSWIN
Bram Moolenaard90b6c02016-08-28 18:10:45 +02002011typedef __time64_t time_T;
2012# else
Bram Moolenaarf4fba6d2016-06-26 16:44:24 +02002013typedef time_t time_T;
Bram Moolenaard90b6c02016-08-28 18:10:45 +02002014# endif
Bram Moolenaarf4fba6d2016-06-26 16:44:24 +02002015#endif
2016
Bram Moolenaard8070362016-02-15 21:56:54 +01002017#ifdef _WIN64
Bram Moolenaard090d7b2016-02-13 17:09:53 +01002018typedef __int64 sock_T;
Bram Moolenaarf8b7d892016-02-13 17:24:26 +01002019#else
Bram Moolenaard090d7b2016-02-13 17:09:53 +01002020typedef int sock_T;
Bram Moolenaard090d7b2016-02-13 17:09:53 +01002021#endif
2022
Bram Moolenaarc3308352019-09-01 16:24:56 +02002023// Include option.h before structs.h, because the number of window-local and
2024// buffer-local options is used there.
2025#include "option.h" // options and default values
Bram Moolenaar40e280d2017-11-19 20:34:59 +01002026
Bram Moolenaarc3308352019-09-01 16:24:56 +02002027#include "beval.h" // BalloonEval
Bram Moolenaara226a6d2006-02-26 23:59:20 +00002028
Bram Moolenaarc3308352019-09-01 16:24:56 +02002029// Note that gui.h is included by structs.h
Bram Moolenaar071d4272004-06-13 20:20:40 +00002030
Bram Moolenaarc3308352019-09-01 16:24:56 +02002031#include "structs.h" // defines many structures
Jonathon7c7a4e62025-01-12 09:58:00 +01002032#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 +00002033
Bram Moolenaar28fb79d2016-01-09 22:28:33 +01002034#include "alloc.h"
2035
Bram Moolenaarc3308352019-09-01 16:24:56 +02002036// Values for "do_profiling".
2037#define PROF_NONE 0 // profiling not started
2038#define PROF_YES 1 // profiling busy
2039#define PROF_PAUSED 2 // profiling paused
Bram Moolenaar371d5402006-03-20 21:47:49 +00002040
Bram Moolenaar071d4272004-06-13 20:20:40 +00002041
Bram Moolenaarc3308352019-09-01 16:24:56 +02002042// Codes for mouse button events in lower three bits:
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002043#define MOUSE_LEFT 0x00
2044#define MOUSE_MIDDLE 0x01
2045#define MOUSE_RIGHT 0x02
2046#define MOUSE_RELEASE 0x03
Bram Moolenaar071d4272004-06-13 20:20:40 +00002047
Bram Moolenaarc3308352019-09-01 16:24:56 +02002048// bit masks for modifiers:
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002049#define MOUSE_SHIFT 0x04
2050#define MOUSE_ALT 0x08
2051#define MOUSE_CTRL 0x10
Bram Moolenaar071d4272004-06-13 20:20:40 +00002052
Bram Moolenaarc3308352019-09-01 16:24:56 +02002053// mouse buttons that are handled like a key press (GUI only)
2054// Note that the scroll wheel keys are inverted: MOUSE_5 scrolls lines up but
2055// the result of this is that the window moves down, similarly MOUSE_6 scrolls
2056// columns left but the window moves right.
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002057#define MOUSE_4 0x100 // scroll wheel down
2058#define MOUSE_5 0x200 // scroll wheel up
Bram Moolenaar071d4272004-06-13 20:20:40 +00002059
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002060#define MOUSE_X1 0x300 // Mouse-button X1 (6th)
2061#define MOUSE_X2 0x400 // Mouse-button X2
Bram Moolenaar071d4272004-06-13 20:20:40 +00002062
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002063#define MOUSE_6 0x500 // scroll wheel left
2064#define MOUSE_7 0x600 // scroll wheel right
Bram Moolenaar8d9b40e2010-07-25 15:49:07 +02002065
Bram Moolenaar445f11d2021-06-08 20:13:31 +02002066#define MOUSE_MOVE 0x700 // report mouse moved
2067
Bram Moolenaarc3308352019-09-01 16:24:56 +02002068// 0x20 is reserved by xterm
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002069#define MOUSE_DRAG_XTERM 0x40
Bram Moolenaar071d4272004-06-13 20:20:40 +00002070
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002071#define MOUSE_DRAG (0x40 | MOUSE_RELEASE)
Bram Moolenaar071d4272004-06-13 20:20:40 +00002072
Bram Moolenaarc3308352019-09-01 16:24:56 +02002073// Lowest button code for using the mouse wheel (xterm only)
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002074#define MOUSEWHEEL_LOW 0x60
Bram Moolenaar071d4272004-06-13 20:20:40 +00002075
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002076#define MOUSE_CLICK_MASK 0x03
Bram Moolenaar071d4272004-06-13 20:20:40 +00002077
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002078#define NUM_MOUSE_CLICKS(code) \
Bram Moolenaar071d4272004-06-13 20:20:40 +00002079 (((unsigned)((code) & 0xC0) >> 6) + 1)
2080
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002081#define SET_NUM_MOUSE_CLICKS(code, num) \
kylo2529dac9b12022-03-27 20:05:17 +01002082 ((code) = ((code) & 0x3f) | ((((num) - 1) & 3) << 6))
Bram Moolenaar071d4272004-06-13 20:20:40 +00002083
Bram Moolenaarc3308352019-09-01 16:24:56 +02002084// Added to mouse column for GUI when 'mousefocus' wants to give focus to a
2085// window by simulating a click on its status line. We could use up to 128 *
2086// 128 = 16384 columns, now it's reduced to 10000.
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002087#define MOUSE_COLOFF 10000
Bram Moolenaar6f3058f2005-04-24 21:58:05 +00002088
Bram Moolenaar071d4272004-06-13 20:20:40 +00002089/*
zeertzjq3d19c812022-11-04 21:58:36 +00002090 * jump_to_mouse() returns one of first five these values, possibly with
2091 * some of the other four added.
Bram Moolenaar071d4272004-06-13 20:20:40 +00002092 */
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002093#define IN_UNKNOWN 0
2094#define IN_BUFFER 1
2095#define IN_STATUS_LINE 2 // on status or command line
2096#define IN_SEP_LINE 4 // on vertical separator line
2097#define IN_OTHER_WIN 8 // in other window but can't go there
2098#define CURSOR_MOVED 0x100
2099#define MOUSE_FOLD_CLOSE 0x200 // clicked on '-' in fold column
2100#define MOUSE_FOLD_OPEN 0x400 // clicked on '+' in fold column
2101#define MOUSE_WINBAR 0x800 // in window toolbar
Bram Moolenaar071d4272004-06-13 20:20:40 +00002102
Bram Moolenaarc3308352019-09-01 16:24:56 +02002103// flags for jump_to_mouse()
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002104#define MOUSE_FOCUS 0x01 // need to stay in this window
2105#define MOUSE_MAY_VIS 0x02 // may start Visual mode
2106#define MOUSE_DID_MOVE 0x04 // only act when mouse has moved
2107#define MOUSE_SETPOS 0x08 // only set current mouse position
2108#define MOUSE_MAY_STOP_VIS 0x10 // may stop Visual mode
2109#define MOUSE_RELEASED 0x20 // button was released
Bram Moolenaar071d4272004-06-13 20:20:40 +00002110
Bram Moolenaara1cb1d12019-10-17 23:00:07 +02002111#if defined(UNIX) && defined(HAVE_GETTIMEOFDAY) && defined(HAVE_SYS_TIME_H)
2112# define CHECK_DOUBLE_CLICK 1 // Checking for double clicks ourselves.
2113#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00002114
Bram Moolenaar071d4272004-06-13 20:20:40 +00002115
Bram Moolenaarc3308352019-09-01 16:24:56 +02002116// defines for eval_vars()
Bram Moolenaar071d4272004-06-13 20:20:40 +00002117#define VALID_PATH 1
2118#define VALID_HEAD 2
2119
Bram Moolenaar84cf6bd2020-06-16 20:03:43 +02002120// Defines for Vim variables. These must match vimvars[] in evalvars.c!
Bram Moolenaar071d4272004-06-13 20:20:40 +00002121#define VV_COUNT 0
2122#define VV_COUNT1 1
2123#define VV_PREVCOUNT 2
2124#define VV_ERRMSG 3
2125#define VV_WARNINGMSG 4
2126#define VV_STATUSMSG 5
2127#define VV_SHELL_ERROR 6
2128#define VV_THIS_SESSION 7
2129#define VV_VERSION 8
2130#define VV_LNUM 9
2131#define VV_TERMRESPONSE 10
2132#define VV_FNAME 11
2133#define VV_LANG 12
2134#define VV_LC_TIME 13
2135#define VV_CTYPE 14
2136#define VV_CC_FROM 15
2137#define VV_CC_TO 16
2138#define VV_FNAME_IN 17
2139#define VV_FNAME_OUT 18
2140#define VV_FNAME_NEW 19
2141#define VV_FNAME_DIFF 20
2142#define VV_CMDARG 21
2143#define VV_FOLDSTART 22
2144#define VV_FOLDEND 23
2145#define VV_FOLDDASHES 24
2146#define VV_FOLDLEVEL 25
2147#define VV_PROGNAME 26
2148#define VV_SEND_SERVER 27
2149#define VV_DYING 28
2150#define VV_EXCEPTION 29
2151#define VV_THROWPOINT 30
2152#define VV_REG 31
2153#define VV_CMDBANG 32
Bram Moolenaar843ee412004-06-30 16:16:41 +00002154#define VV_INSERTMODE 33
Bram Moolenaar6d14ccd2005-01-15 22:08:30 +00002155#define VV_VAL 34
2156#define VV_KEY 35
Bram Moolenaar05159a02005-02-26 23:04:13 +00002157#define VV_PROFILING 36
Bram Moolenaar19a09a12005-03-04 23:39:37 +00002158#define VV_FCS_REASON 37
2159#define VV_FCS_CHOICE 38
Bram Moolenaar52b4b552005-03-07 23:00:57 +00002160#define VV_BEVAL_BUFNR 39
2161#define VV_BEVAL_WINNR 40
Bram Moolenaarc9721bd2016-06-04 17:41:03 +02002162#define VV_BEVAL_WINID 41
2163#define VV_BEVAL_LNUM 42
2164#define VV_BEVAL_COL 43
2165#define VV_BEVAL_TEXT 44
2166#define VV_SCROLLSTART 45
2167#define VV_SWAPNAME 46
2168#define VV_SWAPCHOICE 47
2169#define VV_SWAPCOMMAND 48
2170#define VV_CHAR 49
2171#define VV_MOUSE_WIN 50
Bram Moolenaar511972d2016-06-04 18:09:59 +02002172#define VV_MOUSE_WINID 51
2173#define VV_MOUSE_LNUM 52
2174#define VV_MOUSE_COL 53
2175#define VV_OP 54
2176#define VV_SEARCHFORWARD 55
2177#define VV_HLSEARCH 56
2178#define VV_OLDFILES 57
2179#define VV_WINDOWID 58
2180#define VV_PROGPATH 59
2181#define VV_COMPLETED_ITEM 60
2182#define VV_OPTION_NEW 61
2183#define VV_OPTION_OLD 62
Bram Moolenaard7c96872019-06-15 17:12:48 +02002184#define VV_OPTION_OLDLOCAL 63
2185#define VV_OPTION_OLDGLOBAL 64
2186#define VV_OPTION_COMMAND 65
2187#define VV_OPTION_TYPE 66
2188#define VV_ERRORS 67
2189#define VV_FALSE 68
2190#define VV_TRUE 69
Bram Moolenaarf9706e92020-02-22 14:27:04 +01002191#define VV_NONE 70
2192#define VV_NULL 71
Bram Moolenaar57d5a012021-01-21 21:42:31 +01002193#define VV_NUMBERMAX 72
2194#define VV_NUMBERMIN 73
2195#define VV_NUMBERSIZE 74
2196#define VV_VIM_DID_ENTER 75
2197#define VV_TESTING 76
2198#define VV_TYPE_NUMBER 77
2199#define VV_TYPE_STRING 78
2200#define VV_TYPE_FUNC 79
2201#define VV_TYPE_LIST 80
2202#define VV_TYPE_DICT 81
2203#define VV_TYPE_FLOAT 82
2204#define VV_TYPE_BOOL 83
2205#define VV_TYPE_NONE 84
2206#define VV_TYPE_JOB 85
2207#define VV_TYPE_CHANNEL 86
2208#define VV_TYPE_BLOB 87
Bram Moolenaarc0c2c262023-01-12 21:08:53 +00002209#define VV_TYPE_CLASS 88
2210#define VV_TYPE_OBJECT 89
2211#define VV_TERMRFGRESP 90
2212#define VV_TERMRBGRESP 91
2213#define VV_TERMU7RESP 92
2214#define VV_TERMSTYLERESP 93
2215#define VV_TERMBLINKRESP 94
2216#define VV_EVENT 95
2217#define VV_VERSIONLONG 96
2218#define VV_ECHOSPACE 97
2219#define VV_ARGV 98
2220#define VV_COLLATE 99
2221#define VV_EXITING 100
2222#define VV_COLORNAMES 101
2223#define VV_SIZEOFINT 102
2224#define VV_SIZEOFLONG 103
2225#define VV_SIZEOFPOINTER 104
2226#define VV_MAXCOL 105
Yee Cheng Chinc13b3d12023-08-20 21:18:38 +02002227#define VV_PYTHON3_VERSION 106
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +02002228#define VV_TYPE_TYPEALIAS 107
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +01002229#define VV_TYPE_ENUM 108
2230#define VV_TYPE_ENUMVALUE 109
ichizok663d18d2025-01-02 18:06:00 +01002231#define VV_STACKTRACE 110
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01002232#define VV_TYPE_TUPLE 111
Foxe Chenb90c2392025-06-27 21:10:35 +02002233#define VV_WAYLAND_DISPLAY 112
2234#define VV_CLIPMETHOD 113
2235#define VV_LEN 114 // number of v: vars
Bram Moolenaar520e1e42016-01-23 19:46:28 +01002236
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01002237// used for v_number in VAR_BOOL and VAR_SPECIAL
2238#define VVAL_FALSE 0L // VAR_BOOL
2239#define VVAL_TRUE 1L // VAR_BOOL
2240#define VVAL_NONE 2L // VAR_SPECIAL
2241#define VVAL_NULL 3L // VAR_SPECIAL
Bram Moolenaar071d4272004-06-13 20:20:40 +00002242
Bram Moolenaard7c96872019-06-15 17:12:48 +02002243// Type values for type().
Bram Moolenaarf562e722016-07-19 17:25:25 +02002244#define VAR_TYPE_NUMBER 0
2245#define VAR_TYPE_STRING 1
2246#define VAR_TYPE_FUNC 2
2247#define VAR_TYPE_LIST 3
2248#define VAR_TYPE_DICT 4
2249#define VAR_TYPE_FLOAT 5
2250#define VAR_TYPE_BOOL 6
2251#define VAR_TYPE_NONE 7
2252#define VAR_TYPE_JOB 8
2253#define VAR_TYPE_CHANNEL 9
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01002254#define VAR_TYPE_BLOB 10
Bram Moolenaarf18332f2021-05-07 17:55:55 +02002255#define VAR_TYPE_INSTR 11
Bram Moolenaar00b28d62022-12-08 15:32:33 +00002256#define VAR_TYPE_CLASS 12
2257#define VAR_TYPE_OBJECT 13
Yegappan Lakshmanan2a71b542023-12-14 20:03:03 +01002258#define VAR_TYPE_TYPEALIAS 14
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +01002259#define VAR_TYPE_ENUM 15
2260#define VAR_TYPE_ENUMVALUE 16
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01002261#define VAR_TYPE_TUPLE 17
Bram Moolenaarf562e722016-07-19 17:25:25 +02002262
Bram Moolenaarc3308352019-09-01 16:24:56 +02002263#define DICT_MAXNEST 100 // maximum nesting of lists and dicts
Bram Moolenaar0522ba02019-08-27 22:48:30 +02002264
Bram Moolenaar652dee42022-01-28 20:47:49 +00002265#define TABSTOP_MAX 9999
2266
Bram Moolenaar071d4272004-06-13 20:20:40 +00002267#ifdef FEAT_CLIPBOARD
2268
Bram Moolenaarc3308352019-09-01 16:24:56 +02002269// VIM_ATOM_NAME is the older Vim-specific selection type for X11. Still
2270// supported for when a mix of Vim versions is used. VIMENC_ATOM_NAME includes
2271// the encoding to support Vims using different 'encoding' values.
Bram Moolenaar08ed30e2013-01-17 17:17:26 +01002272# define VIM_ATOM_NAME "_VIM_TEXT"
2273# define VIMENC_ATOM_NAME "_VIMENC_TEXT"
Bram Moolenaar071d4272004-06-13 20:20:40 +00002274
Bram Moolenaarc3308352019-09-01 16:24:56 +02002275// Selection states for modeless selection
Bram Moolenaar071d4272004-06-13 20:20:40 +00002276# define SELECT_CLEARED 0
2277# define SELECT_IN_PROGRESS 1
2278# define SELECT_DONE 2
2279
2280# define SELECT_MODE_CHAR 0
2281# define SELECT_MODE_WORD 1
2282# define SELECT_MODE_LINE 2
2283
Bram Moolenaar4f974752019-02-17 17:44:42 +01002284# ifdef FEAT_GUI_MSWIN
Bram Moolenaar071d4272004-06-13 20:20:40 +00002285# ifdef FEAT_OLE
2286# define WM_OLE (WM_APP+0)
2287# endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00002288# endif
2289
Foxe Chenb90c2392025-06-27 21:10:35 +02002290typedef enum {
2291 CLIPMETHOD_FAIL,
2292 CLIPMETHOD_NONE,
2293 CLIPMETHOD_WAYLAND,
2294 CLIPMETHOD_X11,
2295} clipmethod_T;
2296
Bram Moolenaarc3308352019-09-01 16:24:56 +02002297// Info about selected text
Bram Moolenaard2cea962019-06-14 23:14:45 +02002298typedef struct
Bram Moolenaar071d4272004-06-13 20:20:40 +00002299{
Bram Moolenaarbd75b532019-06-14 23:41:55 +02002300 int available; // Is clipboard available?
2301 int owned; // Flag: do we own the selection?
2302 pos_T start; // Start of selected area
2303 pos_T end; // End of selected area
2304 int vmode; // Visual mode character
Bram Moolenaar071d4272004-06-13 20:20:40 +00002305
Bram Moolenaarbd75b532019-06-14 23:41:55 +02002306 // Fields for selection that doesn't use Visual mode
Bram Moolenaar071d4272004-06-13 20:20:40 +00002307 short_u origin_row;
2308 short_u origin_start_col;
2309 short_u origin_end_col;
2310 short_u word_start_col;
2311 short_u word_end_col;
Bram Moolenaar05ad5ff2019-11-30 22:48:27 +01002312#ifdef FEAT_PROP_POPUP
Bram Moolenaarbd75b532019-06-14 23:41:55 +02002313 // limits for selection inside a popup window
2314 short_u min_col;
2315 short_u max_col;
2316 short_u min_row;
2317 short_u max_row;
2318#endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00002319
Bram Moolenaarbd75b532019-06-14 23:41:55 +02002320 pos_T prev; // Previous position
2321 short_u state; // Current selection state
2322 short_u mode; // Select by char, word, or line.
Bram Moolenaar071d4272004-06-13 20:20:40 +00002323
2324# if defined(FEAT_GUI_X11) || defined(FEAT_XCLIPBOARD)
Bram Moolenaarbd75b532019-06-14 23:41:55 +02002325 Atom sel_atom; // PRIMARY/CLIPBOARD selection ID
Bram Moolenaar071d4272004-06-13 20:20:40 +00002326# endif
2327
2328# ifdef FEAT_GUI_GTK
Bram Moolenaarbd75b532019-06-14 23:41:55 +02002329 GdkAtom gtk_sel_atom; // PRIMARY/CLIPBOARD selection ID
Bram Moolenaar071d4272004-06-13 20:20:40 +00002330# endif
2331
Bram Moolenaar693e40c2013-02-26 14:56:42 +01002332# if defined(MSWIN) || defined(FEAT_CYGWIN_WIN32_CLIPBOARD)
Bram Moolenaarbd75b532019-06-14 23:41:55 +02002333 int_u format; // Vim's own special clipboard format
2334 int_u format_raw; // Vim's raw text clipboard format
Bram Moolenaar071d4272004-06-13 20:20:40 +00002335# endif
Bram Moolenaarb3f74062020-02-26 16:16:53 +01002336# ifdef FEAT_GUI_HAIKU
2337 // No clipboard at the moment. TODO?
2338# endif
Bram Moolenaard2cea962019-06-14 23:14:45 +02002339} Clipboard_T;
Bram Moolenaar071d4272004-06-13 20:20:40 +00002340#else
Bram Moolenaard2cea962019-06-14 23:14:45 +02002341typedef int Clipboard_T; // This is required for the prototypes.
Bram Moolenaar071d4272004-06-13 20:20:40 +00002342#endif
2343
K.Takatac351dc12022-01-24 11:24:08 +00002344// Use 64-bit stat structure on MS-Windows.
2345#ifdef MSWIN
Bram Moolenaar8767f522016-07-01 17:17:39 +02002346typedef struct _stat64 stat_T;
2347#else
2348typedef struct stat stat_T;
2349#endif
2350
Bram Moolenaar952d9d82021-08-02 18:07:18 +02002351#if (defined(__GNUC__) || defined(__clang__)) && !defined(__MINGW32__)
2352# define ATTRIBUTE_FORMAT_PRINTF(fmt_idx, arg_idx) \
2353 __attribute__((format(printf, fmt_idx, arg_idx)))
2354#else
2355# define ATTRIBUTE_FORMAT_PRINTF(fmt_idx, arg_idx)
2356#endif
2357
2358#if defined(__GNUC__) || defined(__clang__)
ichizoke1240652022-01-07 20:01:07 +00002359# define likely(x) __builtin_expect((x), 1)
2360# define unlikely(x) __builtin_expect((x), 0)
2361# define ATTRIBUTE_COLD __attribute__((cold))
Bram Moolenaar952d9d82021-08-02 18:07:18 +02002362#else
ichizok8bb3fe42021-12-28 15:51:45 +00002363# define unlikely(x) (x)
2364# define likely(x) (x)
Bram Moolenaar952d9d82021-08-02 18:07:18 +02002365# define ATTRIBUTE_COLD
Bram Moolenaare80757c2018-04-10 12:42:44 +02002366#endif
2367
Bram Moolenaar4f25b1a2020-09-10 19:25:05 +02002368typedef enum {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002369 ASSERT_EQUAL,
2370 ASSERT_NOTEQUAL,
2371 ASSERT_MATCH,
2372 ASSERT_NOTMATCH,
zeertzjq53f5e512023-05-04 18:58:22 +01002373 ASSERT_FAILS,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002374 ASSERT_OTHER
2375} assert_type_T;
2376
Bram Moolenaarc3308352019-09-01 16:24:56 +02002377// Mode for bracketed_paste().
Bram Moolenaarec2da362017-01-21 20:04:22 +01002378typedef enum {
Bram Moolenaarc3308352019-09-01 16:24:56 +02002379 PASTE_INSERT, // insert mode
2380 PASTE_CMDLINE, // command line
2381 PASTE_EX, // ex mode line
2382 PASTE_ONE_CHAR // return first character
Bram Moolenaarec2da362017-01-21 20:04:22 +01002383} paste_mode_T;
2384
Bram Moolenaar6a2633b2018-10-07 23:16:36 +02002385// Argument for flush_buffers().
2386typedef enum {
2387 FLUSH_MINIMAL,
2388 FLUSH_TYPEAHEAD, // flush current typebuf contents
2389 FLUSH_INPUT // flush typebuf and inchar() input
2390} flush_buffers_T;
2391
Bram Moolenaardca7abe2019-10-20 18:17:57 +02002392// Argument for prepare_tagpreview()
2393typedef enum {
2394 USEPOPUP_NONE,
2395 USEPOPUP_NORMAL, // use info popup
2396 USEPOPUP_HIDDEN // use info popup initially hidden
2397} use_popup_T;
2398
Bram Moolenaar4f25b1a2020-09-10 19:25:05 +02002399// Argument for estack_sfile().
2400typedef enum {
2401 ESTACK_NONE,
2402 ESTACK_SFILE,
LemonBoy6013d002022-04-09 21:42:10 +01002403 ESTACK_STACK,
2404 ESTACK_SCRIPT,
Bram Moolenaar4f25b1a2020-09-10 19:25:05 +02002405} estack_arg_T;
2406
Bram Moolenaar63a2e362022-11-23 20:20:18 +00002407// Return value of match_keyprotocol()
2408typedef enum {
2409 KEYPROTOCOL_NONE,
2410 KEYPROTOCOL_MOK2,
2411 KEYPROTOCOL_KITTY,
2412 KEYPROTOCOL_FAIL
2413} keyprot_T;
2414
Bram Moolenaar0917e862023-02-18 14:42:44 +00002415// errors for when calling a function
2416typedef enum {
2417 FCERR_NONE, // no error
2418 FCERR_UNKNOWN, // unknown function
2419 FCERR_TOOMANY, // too many arguments
2420 FCERR_TOOFEW, // too few arguments
2421 FCERR_SCRIPT, // missing script context
2422 FCERR_DICT, // missing dict
2423 FCERR_OTHER, // another kind of error
2424 FCERR_DELETED, // function was deleted
2425 FCERR_NOTMETHOD, // function cannot be used as a method
2426 FCERR_FAILED, // error while executing the function
2427} funcerror_T;
2428
Yegappan Lakshmananaf936912023-02-20 12:16:39 +00002429/*
glepnir6a89c942024-10-01 20:32:12 +02002430 * Array indexes used for cp_text[].
2431 */
2432typedef enum {
2433 CPT_ABBR, // "abbr"
2434 CPT_KIND, // "kind"
2435 CPT_MENU, // "menu"
2436 CPT_INFO, // "info"
2437 CPT_COUNT, // Number of entries
2438} cpitem_T;
2439
2440/*
Yegappan Lakshmananaf936912023-02-20 12:16:39 +00002441 * Type for the callback function that is invoked after an option value is
2442 * changed to validate and apply the new value.
Yegappan Lakshmanana23a11b2023-02-21 14:27:41 +00002443 *
2444 * Returns NULL if the option value is valid is successfully applied.
2445 * Otherwise returns an error message.
Yegappan Lakshmananaf936912023-02-20 12:16:39 +00002446 */
2447typedef char *(*opt_did_set_cb_T)(optset_T *args);
2448
Yee Cheng Chin900894b2023-09-29 20:42:32 +02002449/*
2450 * Type for the callback function that is invoked when expanding possible
2451 * string option values during cmdline completion.
2452 *
2453 * Strings in returned matches will be managed and freed by caller.
2454 *
2455 * Returns OK if the expansion succeeded (numMatches and matches have to be
2456 * set). Otherwise returns FAIL.
2457 *
2458 * Note: If returned FAIL or *numMatches is 0, *matches will NOT be freed by
2459 * caller.
2460 */
2461typedef int (*opt_expand_cb_T)(optexpand_T *args, int *numMatches, char_u ***matches);
2462
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002463// Flags for assignment functions.
Bram Moolenaar6586a012022-09-30 11:04:50 +01002464#define ASSIGN_VAR 0 // ":var" (nothing special)
Bram Moolenaarf93bbd02021-04-10 22:35:43 +02002465#define ASSIGN_FINAL 0x01 // ":final"
2466#define ASSIGN_CONST 0x02 // ":const"
2467#define ASSIGN_NO_DECL 0x04 // "name = expr" without ":let"/":const"/":final"
2468#define ASSIGN_DECL 0x08 // may declare variable if it does not exist
2469#define ASSIGN_UNPACK 0x10 // using [a, b] = list
Bram Moolenaarf2253962021-04-13 20:53:13 +02002470#define ASSIGN_NO_MEMBER_TYPE 0x20 // use "any" for list and dict member type
Bram Moolenaarf6a8d422021-04-13 21:48:03 +02002471#define ASSIGN_FOR_LOOP 0x40 // assigning to loop variable
Bram Moolenaar859cc212022-03-28 15:22:35 +01002472#define ASSIGN_INIT 0x80 // not assigning a value, just a declaration
Bram Moolenaar766ae5b2022-09-14 00:30:51 +01002473#define ASSIGN_UPDATE_BLOCK_ID 0x100 // update sav_block_id
Yegappan Lakshmanan1af35632024-02-06 11:03:36 +01002474#define ASSIGN_COMPOUND_OP 0x200 // compound operator e.g. "+="
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002475
Bram Moolenaarc3308352019-09-01 16:24:56 +02002476#include "ex_cmds.h" // Ex command defines
2477#include "spell.h" // spell checking stuff
Bram Moolenaar6cfdb2a2016-07-19 17:01:31 +02002478
Bram Moolenaarc3308352019-09-01 16:24:56 +02002479#include "proto.h" // function prototypes
Bram Moolenaar071d4272004-06-13 20:20:40 +00002480
Bram Moolenaarc3308352019-09-01 16:24:56 +02002481// This has to go after the include of proto.h, as proto/gui.pro declares
2482// functions of these names. The declarations would break if the defines had
2483// been seen at that stage. But it must be before globals.h, where error_ga
2484// is declared.
Bram Moolenaarb3f74062020-02-26 16:16:53 +01002485#if !defined(MSWIN) && !defined(FEAT_GUI_X11) && !defined(FEAT_GUI_HAIKU) \
Bram Moolenaar097148e2020-08-11 21:58:20 +02002486 && !defined(FEAT_GUI_GTK) && !defined(PROTO)
Bram Moolenaar071d4272004-06-13 20:20:40 +00002487# define mch_errmsg(str) fprintf(stderr, "%s", (str))
2488# define display_errors() fflush(stderr)
2489# define mch_msg(str) printf("%s", (str))
2490#else
2491# define USE_MCH_ERRMSG
2492#endif
2493
Bram Moolenaar264b74f2019-01-24 17:18:42 +01002494# if defined(FEAT_EVAL) \
K.Takata4ac893f2022-01-20 12:44:28 +00002495 && (!defined(FEAT_GUI_MSWIN) || !defined(FEAT_MBYTE_IME))
Bram Moolenaarc3308352019-09-01 16:24:56 +02002496// Whether IME is supported by im_get_status() defined in mbyte.c.
K.Takata4ac893f2022-01-20 12:44:28 +00002497// For Win32 GUI it's in gui_w32.c when FEAT_MBYTE_IME is defined.
Bram Moolenaarf2bd8ef2018-03-04 18:08:14 +01002498# define IME_WITHOUT_XIM
2499#endif
2500
Bram Moolenaar264b74f2019-01-24 17:18:42 +01002501#if defined(FEAT_XIM) \
Bram Moolenaarf2bd8ef2018-03-04 18:08:14 +01002502 || defined(IME_WITHOUT_XIM) \
K.Takata4ac893f2022-01-20 12:44:28 +00002503 || (defined(FEAT_GUI_MSWIN) && defined(FEAT_MBYTE_IME))
Bram Moolenaarc3308352019-09-01 16:24:56 +02002504// im_set_active() is available
Bram Moolenaarf2bd8ef2018-03-04 18:08:14 +01002505# define HAVE_INPUT_METHOD
2506#endif
2507
Bram Moolenaaraab21c32005-01-25 21:46:35 +00002508#ifndef FEAT_LINEBREAK
Bram Moolenaarc3308352019-09-01 16:24:56 +02002509// Without the 'numberwidth' option line numbers are always 7 chars.
Bram Moolenaaraab21c32005-01-25 21:46:35 +00002510# define number_width(x) 7
2511#endif
2512
Bram Moolenaarc3308352019-09-01 16:24:56 +02002513// This must come after including proto.h.
2514// For VMS this is defined in macros.h.
Bram Moolenaar4f974752019-02-17 17:44:42 +01002515#if !defined(MSWIN) && !defined(VMS)
Bram Moolenaarb6843a02017-08-02 22:07:12 +02002516# define mch_open(n, m, p) open((n), (m), (p))
2517# define mch_fopen(n, p) fopen((n), (p))
2518#endif
Bram Moolenaaraab21c32005-01-25 21:46:35 +00002519
Bram Moolenaarc3308352019-09-01 16:24:56 +02002520#include "globals.h" // global variables and messages
Bram Moolenaarbc4c5052020-08-13 22:47:35 +02002521#include "errors.h" // error messages
Bram Moolenaar071d4272004-06-13 20:20:40 +00002522
Bram Moolenaar071d4272004-06-13 20:20:40 +00002523/*
2524 * If console dialog not supported, but GUI dialog is, use the GUI one.
2525 */
2526#if defined(FEAT_GUI_DIALOG) && !defined(FEAT_CON_DIALOG)
2527# define do_dialog gui_mch_dialog
2528#endif
2529
2530/*
2531 * Default filters for gui_mch_browse().
2532 * The filters are almost system independent. Except for the difference
2533 * between "*" and "*.*" for MSDOS-like systems.
2534 * NOTE: Motif only uses the very first pattern. Therefore
2535 * BROWSE_FILTER_DEFAULT should start with a "*" pattern.
2536 */
2537#ifdef FEAT_BROWSE
2538# ifdef BACKSLASH_IN_FILENAME
2539# define BROWSE_FILTER_MACROS \
Bram Moolenaarc36651b2018-04-29 12:22:56 +02002540 (char_u *)N_("Vim macro files (*.vim)\t*.vim\nAll Files (*.*)\t*.*\n")
2541# define BROWSE_FILTER_ALL_FILES (char_u *)N_("All Files (*.*)\t*.*\n")
Bram Moolenaar071d4272004-06-13 20:20:40 +00002542# define BROWSE_FILTER_DEFAULT \
Bram Moolenaarc36651b2018-04-29 12:22:56 +02002543 (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 +00002544# else
2545# define BROWSE_FILTER_MACROS \
Bram Moolenaarc36651b2018-04-29 12:22:56 +02002546 (char_u *)N_("Vim macro files (*.vim)\t*.vim\nAll Files (*)\t*\n")
2547# define BROWSE_FILTER_ALL_FILES (char_u *)N_("All Files (*)\t*\n")
Bram Moolenaar071d4272004-06-13 20:20:40 +00002548# define BROWSE_FILTER_DEFAULT \
Bram Moolenaarc36651b2018-04-29 12:22:56 +02002549 (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 +00002550# endif
Bram Moolenaarc3308352019-09-01 16:24:56 +02002551# define BROWSE_SAVE 1 // flag for do_browse()
2552# define BROWSE_DIR 2 // flag for do_browse()
Bram Moolenaar071d4272004-06-13 20:20:40 +00002553#endif
2554
Bram Moolenaar442b4222010-05-24 21:34:22 +02002555#ifdef _MSC_VER
Bram Moolenaarc3308352019-09-01 16:24:56 +02002556// Avoid useless warning "conversion from X to Y of greater size".
Bram Moolenaar442b4222010-05-24 21:34:22 +02002557 #pragma warning(disable : 4312)
Bram Moolenaarc3308352019-09-01 16:24:56 +02002558// Avoid warning for old style function declarators
Bram Moolenaareb292852015-02-10 18:47:58 +01002559 #pragma warning(disable : 4131)
Bram Moolenaarc3308352019-09-01 16:24:56 +02002560// Avoid warning for conversion to type with smaller range
Bram Moolenaareb292852015-02-10 18:47:58 +01002561 #pragma warning(disable : 4244)
Bram Moolenaarc3308352019-09-01 16:24:56 +02002562// Avoid warning for conversion to larger size
Bram Moolenaareb292852015-02-10 18:47:58 +01002563 #pragma warning(disable : 4306)
Bram Moolenaarc3308352019-09-01 16:24:56 +02002564// Avoid warning for unreferenced formal parameter
Bram Moolenaareb292852015-02-10 18:47:58 +01002565 #pragma warning(disable : 4100)
Bram Moolenaarc3308352019-09-01 16:24:56 +02002566// Avoid warning for differs in indirection to slightly different base type
Bram Moolenaareb292852015-02-10 18:47:58 +01002567 #pragma warning(disable : 4057)
Bram Moolenaarc3308352019-09-01 16:24:56 +02002568// Avoid warning for constant conditional expression
Bram Moolenaareb292852015-02-10 18:47:58 +01002569 #pragma warning(disable : 4127)
Bram Moolenaarc3308352019-09-01 16:24:56 +02002570// Avoid warning for assignment within conditional
Bram Moolenaareb292852015-02-10 18:47:58 +01002571 #pragma warning(disable : 4706)
Bram Moolenaar442b4222010-05-24 21:34:22 +02002572#endif
2573
Bram Moolenaarc3308352019-09-01 16:24:56 +02002574// Note: a NULL argument for vim_realloc() is not portable, don't use it.
Bram Moolenaar071d4272004-06-13 20:20:40 +00002575#if defined(MEM_PROFILE)
2576# define vim_realloc(ptr, size) mem_realloc((ptr), (size))
2577#else
2578# define vim_realloc(ptr, size) realloc((ptr), (size))
2579#endif
2580
Bram Moolenaar071d4272004-06-13 20:20:40 +00002581/*
2582 * Return byte length of character that starts with byte "b".
2583 * Returns 1 for a single-byte character.
2584 * MB_BYTE2LEN_CHECK() can be used to count a special key as one byte.
2585 * Don't call MB_BYTE2LEN(b) with b < 0 or b > 255!
2586 */
Bram Moolenaar264b74f2019-01-24 17:18:42 +01002587#define MB_BYTE2LEN(b) mb_bytelen_tab[b]
2588#define MB_BYTE2LEN_CHECK(b) (((b) < 0 || (b) > 255) ? 1 : mb_bytelen_tab[b])
Bram Moolenaar071d4272004-06-13 20:20:40 +00002589
Bram Moolenaarc3308352019-09-01 16:24:56 +02002590// properties used in enc_canon_table[] (first three mutually exclusive)
Bram Moolenaar264b74f2019-01-24 17:18:42 +01002591#define ENC_8BIT 0x01
2592#define ENC_DBCS 0x02
2593#define ENC_UNICODE 0x04
Bram Moolenaar071d4272004-06-13 20:20:40 +00002594
Bram Moolenaarc3308352019-09-01 16:24:56 +02002595#define ENC_ENDIAN_B 0x10 // Unicode: Big endian
2596#define ENC_ENDIAN_L 0x20 // Unicode: Little endian
Bram Moolenaar071d4272004-06-13 20:20:40 +00002597
Bram Moolenaarc3308352019-09-01 16:24:56 +02002598#define ENC_2BYTE 0x40 // Unicode: UCS-2
2599#define ENC_4BYTE 0x80 // Unicode: UCS-4
2600#define ENC_2WORD 0x100 // Unicode: UTF-16
Bram Moolenaar071d4272004-06-13 20:20:40 +00002601
Bram Moolenaarc3308352019-09-01 16:24:56 +02002602#define ENC_LATIN1 0x200 // Latin1
2603#define ENC_LATIN9 0x400 // Latin9
2604#define ENC_MACROMAN 0x800 // Mac Roman (not Macro Man! :-)
Bram Moolenaar071d4272004-06-13 20:20:40 +00002605
Bram Moolenaar264b74f2019-01-24 17:18:42 +01002606#ifdef USE_ICONV
2607# ifndef EILSEQ
2608# define EILSEQ 123
Bram Moolenaar071d4272004-06-13 20:20:40 +00002609# endif
Bram Moolenaar264b74f2019-01-24 17:18:42 +01002610# ifdef DYNAMIC_ICONV
Bram Moolenaarc3308352019-09-01 16:24:56 +02002611// On Win32 iconv.dll is dynamically loaded.
Bram Moolenaar264b74f2019-01-24 17:18:42 +01002612# define ICONV_ERRNO (*iconv_errno())
2613# define ICONV_E2BIG 7
2614# define ICONV_EINVAL 22
2615# define ICONV_EILSEQ 42
2616# else
2617# define ICONV_ERRNO errno
2618# define ICONV_E2BIG E2BIG
2619# define ICONV_EINVAL EINVAL
2620# define ICONV_EILSEQ EILSEQ
2621# endif
Bram Moolenaar071d4272004-06-13 20:20:40 +00002622#endif
2623
Bram Moolenaarc3308352019-09-01 16:24:56 +02002624#define SIGN_BYTE 1 // byte value used where sign is displayed;
2625 // attribute value is sign type
Bram Moolenaar071d4272004-06-13 20:20:40 +00002626
2627#ifdef FEAT_NETBEANS_INTG
Bram Moolenaarc3308352019-09-01 16:24:56 +02002628# define MULTISIGN_BYTE 2 // byte value used where sign is displayed if
2629 // multiple signs exist on the line
Bram Moolenaar071d4272004-06-13 20:20:40 +00002630#endif
2631
2632#if defined(FEAT_GUI) && defined(FEAT_XCLIPBOARD)
2633# ifdef FEAT_GUI_GTK
Bram Moolenaarc3308352019-09-01 16:24:56 +02002634 // Avoid using a global variable for the X display. It's ugly
2635 // and is likely to cause trouble in multihead environments.
Bram Moolenaar071d4272004-06-13 20:20:40 +00002636# define X_DISPLAY ((gui.in_use) ? gui_mch_get_display() : xterm_dpy)
2637# else
2638# define X_DISPLAY (gui.in_use ? gui.dpy : xterm_dpy)
2639# endif
2640#else
2641# ifdef FEAT_GUI
2642# ifdef FEAT_GUI_GTK
2643# define X_DISPLAY ((gui.in_use) ? gui_mch_get_display() : (Display *)NULL)
2644# else
2645# define X_DISPLAY gui.dpy
2646# endif
2647# else
2648# define X_DISPLAY xterm_dpy
2649# endif
2650#endif
2651
Bram Moolenaar77c604d2012-07-10 13:41:14 +02002652#if defined(FEAT_BROWSE) && defined(GTK_CHECK_VERSION)
2653# if GTK_CHECK_VERSION(2,4,0)
2654# define USE_FILE_CHOOSER
2655# endif
2656#endif
2657
Bram Moolenaar25328e32018-09-11 21:30:09 +02002658#ifdef FEAT_GUI_GTK
2659# if !GTK_CHECK_VERSION(2,14,0)
2660# define gtk_widget_get_window(wid) ((wid)->window)
Bram Moolenaar664323e2018-09-18 22:30:07 +02002661# define gtk_plug_get_socket_window(wid) ((wid)->socket_window)
2662# define gtk_selection_data_get_data(sel) ((sel)->data)
2663# define gtk_selection_data_get_data_type(sel) ((sel)->type)
2664# define gtk_selection_data_get_format(sel) ((sel)->format)
2665# define gtk_selection_data_get_length(sel) ((sel)->length)
2666# define gtk_adjustment_set_lower(adj, low) \
2667 do { (adj)->lower = low; } while (0)
2668# define gtk_adjustment_set_upper(adj, up) \
2669 do { (adj)->upper = up; } while (0)
2670# define gtk_adjustment_set_page_size(adj, size) \
2671 do { (adj)->page_size = size; } while (0)
2672# define gtk_adjustment_set_page_increment(adj, inc) \
2673 do { (adj)->page_increment = inc; } while (0)
2674# define gtk_adjustment_set_step_increment(adj, inc) \
2675 do { (adj)->step_increment = inc; } while (0)
2676# endif
2677# if !GTK_CHECK_VERSION(2,16,0)
2678# define gtk_selection_data_get_selection(sel) ((sel)->selection)
2679# endif
2680# if !GTK_CHECK_VERSION(2,18,0)
2681# define gtk_widget_get_allocation(wid, alloc) \
2682 do { *(alloc) = (wid)->allocation; } while (0)
2683# define gtk_widget_set_allocation(wid, alloc) \
2684 do { (wid)->allocation = *(alloc); } while (0)
2685# define gtk_widget_get_has_window(wid) !GTK_WIDGET_NO_WINDOW(wid)
2686# define gtk_widget_get_sensitive(wid) GTK_WIDGET_SENSITIVE(wid)
2687# define gtk_widget_get_visible(wid) GTK_WIDGET_VISIBLE(wid)
2688# define gtk_widget_has_focus(wid) GTK_WIDGET_HAS_FOCUS(wid)
2689# define gtk_widget_set_window(wid, win) \
2690 do { (wid)->window = (win); } while (0)
2691# define gtk_widget_set_can_default(wid, can) \
Bram Moolenaarebfec1c2023-01-22 21:14:53 +00002692 do { if (can) \
2693 { GTK_WIDGET_SET_FLAGS(wid, GTK_CAN_DEFAULT); } \
2694 else \
2695 { GTK_WIDGET_UNSET_FLAGS(wid, GTK_CAN_DEFAULT); } } while (0)
Bram Moolenaar664323e2018-09-18 22:30:07 +02002696# define gtk_widget_set_can_focus(wid, can) \
Bram Moolenaarebfec1c2023-01-22 21:14:53 +00002697 do { if (can) \
2698 { GTK_WIDGET_SET_FLAGS(wid, GTK_CAN_FOCUS); } \
2699 else \
2700 { GTK_WIDGET_UNSET_FLAGS(wid, GTK_CAN_FOCUS); } } while (0)
Bram Moolenaar664323e2018-09-18 22:30:07 +02002701# define gtk_widget_set_visible(wid, vis) \
Bram Moolenaarebfec1c2023-01-22 21:14:53 +00002702 do { if (vis) \
2703 { gtk_widget_show(wid); } \
2704 else \
2705 { gtk_widget_hide(wid); } } while (0)
Bram Moolenaar664323e2018-09-18 22:30:07 +02002706# endif
2707# if !GTK_CHECK_VERSION(2,20,0)
2708# define gtk_widget_get_mapped(wid) GTK_WIDGET_MAPPED(wid)
2709# define gtk_widget_get_realized(wid) GTK_WIDGET_REALIZED(wid)
2710# define gtk_widget_set_mapped(wid, map) \
Bram Moolenaarebfec1c2023-01-22 21:14:53 +00002711 do { if (map) \
2712 { GTK_WIDGET_SET_FLAGS(wid, GTK_MAPPED); } \
2713 else \
2714 { GTK_WIDGET_UNSET_FLAGS(wid, GTK_MAPPED); } } while (0)
Bram Moolenaar664323e2018-09-18 22:30:07 +02002715# define gtk_widget_set_realized(wid, rea) \
Bram Moolenaarebfec1c2023-01-22 21:14:53 +00002716 do { if (rea) \
2717 { GTK_WIDGET_SET_FLAGS(wid, GTK_REALIZED); } \
2718 else \
2719 { GTK_WIDGET_UNSET_FLAGS(wid, GTK_REALIZED); } } while (0)
Bram Moolenaar25328e32018-09-11 21:30:09 +02002720# endif
2721#endif
2722
Bram Moolenaar03005972008-11-20 13:12:36 +00002723#ifndef FEAT_NETBEANS_INTG
2724# undef NBDEBUG
2725#endif
Bram Moolenaarc3308352019-09-01 16:24:56 +02002726#ifdef NBDEBUG // Netbeans debugging.
Bram Moolenaar071d4272004-06-13 20:20:40 +00002727# include "nbdebug.h"
2728#else
2729# define nbdebug(a)
Bram Moolenaar071d4272004-06-13 20:20:40 +00002730#endif
2731
2732#ifdef IN_PERL_FILE
2733 /*
2734 * Avoid clashes between Perl and Vim namespace.
2735 */
Bram Moolenaar071d4272004-06-13 20:20:40 +00002736# undef STRLEN
2737# undef FF
2738# undef OP_DELETE
2739# undef OP_JOIN
Bram Moolenaarc3308352019-09-01 16:24:56 +02002740 // remove MAX and MIN, included by glib.h, redefined by sys/param.h
Bram Moolenaar071d4272004-06-13 20:20:40 +00002741# ifdef MAX
2742# undef MAX
2743# endif
2744# ifdef MIN
2745# undef MIN
2746# endif
Bram Moolenaarc3308352019-09-01 16:24:56 +02002747 // We use _() for gettext(), Perl uses it for function prototypes...
Bram Moolenaar071d4272004-06-13 20:20:40 +00002748# ifdef _
2749# undef _
2750# endif
2751# ifdef DEBUG
2752# undef DEBUG
2753# endif
2754# ifdef _DEBUG
2755# undef _DEBUG
2756# endif
2757# ifdef instr
2758# undef instr
2759# endif
Bram Moolenaarc3308352019-09-01 16:24:56 +02002760 // bool may cause trouble on some old versions of Mac OS X but is required
2761 // on a few other systems and for Perl
Bram Moolenaard0573012017-10-28 21:11:06 +02002762# if (defined(MACOS_X) && !defined(MAC_OS_X_VERSION_10_6)) \
2763 && defined(bool) && !defined(FEAT_PERL)
Bram Moolenaar071d4272004-06-13 20:20:40 +00002764# undef bool
2765# endif
2766
Bram Moolenaar071d4272004-06-13 20:20:40 +00002767#endif
2768
Bram Moolenaarc3308352019-09-01 16:24:56 +02002769// values for vim_handle_signal() that are not a signal
kylo2529dac9b12022-03-27 20:05:17 +01002770#define SIGNAL_BLOCK (-1)
2771#define SIGNAL_UNBLOCK (-2)
Bram Moolenaare7fedb62015-12-31 19:07:19 +01002772#if !defined(UNIX) && !defined(VMS)
Bram Moolenaar5eba4c22005-07-12 22:40:29 +00002773# define vim_handle_signal(x) 0
Bram Moolenaar293ee4d2004-12-09 21:34:53 +00002774#endif
2775
Bram Moolenaarc3308352019-09-01 16:24:56 +02002776// flags for skip_vimgrep_pat()
Bram Moolenaar05159a02005-02-26 23:04:13 +00002777#define VGR_GLOBAL 1
2778#define VGR_NOJUMP 2
Yegappan Lakshmananbb01a1e2021-04-26 21:17:52 +02002779#define VGR_FUZZY 4
Bram Moolenaar05159a02005-02-26 23:04:13 +00002780
Bram Moolenaarc3308352019-09-01 16:24:56 +02002781// behavior for bad character, "++bad=" argument
2782#define BAD_REPLACE '?' // replace it with '?' (default)
kylo2529dac9b12022-03-27 20:05:17 +01002783#define BAD_KEEP (-1) // leave it
2784#define BAD_DROP (-2) // erase it
Bram Moolenaarb0bf8582005-12-13 20:02:15 +00002785
Bram Moolenaarc3308352019-09-01 16:24:56 +02002786// last argument for do_source()
Bram Moolenaar910f66f2006-04-05 20:41:53 +00002787#define DOSO_NONE 0
Bram Moolenaarc3308352019-09-01 16:24:56 +02002788#define DOSO_VIMRC 1 // loading vimrc file
2789#define DOSO_GVIMRC 2 // loading gvimrc file
Bram Moolenaar371d5402006-03-20 21:47:49 +00002790
Bram Moolenaarc3308352019-09-01 16:24:56 +02002791// flags for read_viminfo() and children
Bram Moolenaar3ff656f2021-02-10 19:22:15 +01002792#define VIF_WANT_INFO 1 // load non-mark info
2793#define VIF_WANT_MARKS 2 // load file marks
2794#define VIF_ONLY_CURBUF 4 // bail out after loading marks for curbuf
2795#define VIF_FORCEIT 8 // overwrite info already read
2796#define VIF_GET_OLDFILES 16 // load v:oldfiles
Bram Moolenaard812df62008-11-09 12:46:09 +00002797
Bram Moolenaarc3308352019-09-01 16:24:56 +02002798// flags for buf_freeall()
Bram Moolenaara6e8f882019-12-14 16:18:15 +01002799#define BFA_DEL 1 // buffer is going to be deleted
2800#define BFA_WIPE 2 // buffer is going to be wiped out
2801#define BFA_KEEP_UNDO 4 // do not free undo information
2802#define BFA_IGNORE_ABORT 8 // do not abort for aborting()
Bram Moolenaar59f931e2010-07-24 20:27:03 +02002803
Bram Moolenaarc3308352019-09-01 16:24:56 +02002804// direction for nv_mousescroll() and ins_mousescroll()
2805#define MSCR_DOWN 0 // DOWN must be FALSE
Bram Moolenaar8d9b40e2010-07-25 15:49:07 +02002806#define MSCR_UP 1
kylo2529dac9b12022-03-27 20:05:17 +01002807#define MSCR_LEFT (-1)
2808#define MSCR_RIGHT (-2)
Bram Moolenaar8d9b40e2010-07-25 15:49:07 +02002809
kylo2529dac9b12022-03-27 20:05:17 +01002810#define KEYLEN_PART_KEY (-1) // keylen value for incomplete key-code
2811#define KEYLEN_PART_MAP (-2) // keylen value for incomplete mapping
Bram Moolenaarc3308352019-09-01 16:24:56 +02002812#define KEYLEN_REMOVED 9999 // keylen value for removed sequence
Bram Moolenaar946ffd42010-12-30 12:30:31 +01002813
Bram Moolenaarc3308352019-09-01 16:24:56 +02002814// Return values from win32_fileinfo().
Bram Moolenaar1c32dff2011-05-05 16:41:24 +02002815#define FILEINFO_OK 0
Bram Moolenaarc3308352019-09-01 16:24:56 +02002816#define FILEINFO_ENC_FAIL 1 // enc_to_utf16() failed
2817#define FILEINFO_READ_FAIL 2 // CreateFile() failed
2818#define FILEINFO_INFO_FAIL 3 // GetFileInformationByHandle() failed
Bram Moolenaar1c32dff2011-05-05 16:41:24 +02002819
Bram Moolenaarc3308352019-09-01 16:24:56 +02002820// Return value from get_option_value_strict
2821#define SOPT_BOOL 0x01 // Boolean option
2822#define SOPT_NUM 0x02 // Number option
2823#define SOPT_STRING 0x04 // String option
2824#define SOPT_GLOBAL 0x08 // Option has global value
2825#define SOPT_WIN 0x10 // Option has window-local value
2826#define SOPT_BUF 0x20 // Option has buffer-local value
2827#define SOPT_UNSET 0x40 // Option does not have local value set
Bram Moolenaar84e0f6c2013-05-06 03:52:55 +02002828
Bram Moolenaarc3308352019-09-01 16:24:56 +02002829// Option types for various functions in option.c
2830#define SREQ_GLOBAL 0 // Request global option
2831#define SREQ_WIN 1 // Request window-local option
2832#define SREQ_BUF 2 // Request buffer-local option
Bram Moolenaar84e0f6c2013-05-06 03:52:55 +02002833
Bram Moolenaarc3308352019-09-01 16:24:56 +02002834// Flags for get_reg_contents
2835#define GREG_NO_EXPR 1 // Do not allow expression register
2836#define GREG_EXPR_SRC 2 // Return expression itself for "=" register
2837#define GREG_LIST 4 // Return list
Bram Moolenaarb7cb42b2014-04-02 19:55:10 +02002838
Bram Moolenaarc3308352019-09-01 16:24:56 +02002839// Character used as separated in autoload function/variable names.
Bram Moolenaar018acca2013-05-30 13:37:28 +02002840#define AUTOLOAD_CHAR '#'
2841
Bram Moolenaar509ce2a2016-03-11 22:52:15 +01002842#ifdef FEAT_JOB_CHANNEL
Bram Moolenaare0874f82016-01-24 20:36:41 +01002843# define MAX_OPEN_CHANNELS 10
2844#else
2845# define MAX_OPEN_CHANNELS 0
2846#endif
2847
Bram Moolenaar4f974752019-02-17 17:44:42 +01002848#if defined(MSWIN)
Bram Moolenaar24058382019-01-24 23:11:49 +01002849# define MAX_NAMED_PIPE_SIZE 65535
2850#endif
2851
Bram Moolenaarc3308352019-09-01 16:24:56 +02002852// Options for json_encode() and json_decode.
2853#define JSON_JS 1 // use JS instead of JSON
2854#define JSON_NO_NONE 2 // v:none item not allowed
2855#define JSON_NL 4 // append a NL
Bram Moolenaar595e64e2016-02-07 19:19:53 +01002856
Bram Moolenaarc3308352019-09-01 16:24:56 +02002857// Used for flags of do_in_path()
2858#define DIP_ALL 0x01 // all matches, not just the first one
2859#define DIP_DIR 0x02 // find directories instead of files.
2860#define DIP_ERR 0x04 // give an error message when none found.
2861#define DIP_START 0x08 // also use "start" directory in 'packpath'
2862#define DIP_OPT 0x10 // also use "opt" directory in 'packpath'
2863#define DIP_NORTP 0x20 // do not use 'runtimepath'
2864#define DIP_NOAFTER 0x40 // skip "after" directories
2865#define DIP_AFTER 0x80 // only use "after" directories
Bram Moolenaar6bef5302016-03-12 21:28:26 +01002866
Bram Moolenaarc3308352019-09-01 16:24:56 +02002867// Lowest number used for window ID. Cannot have this many windows.
Bram Moolenaar888ccac2016-06-04 18:49:36 +02002868#define LOWEST_WIN_ID 1000
2869
Bram Moolenaarc3308352019-09-01 16:24:56 +02002870// Used by the garbage collector.
Bram Moolenaarcd524592016-07-17 14:57:05 +02002871#define COPYID_INC 2
2872#define COPYID_MASK (~0x1)
2873
Bram Moolenaarc3308352019-09-01 16:24:56 +02002874// Values for trans_function_name() argument:
Bram Moolenaar8f22f5c2020-12-19 22:10:13 +01002875#define TFN_INT 0x01 // internal function name OK
2876#define TFN_QUIET 0x02 // no error messages
2877#define TFN_NO_AUTOLOAD 0x04 // do not use script autoloading
2878#define TFN_NO_DEREF 0x08 // do not dereference a Funcref
2879#define TFN_READ_ONLY 0x10 // will not change the var
2880#define TFN_NO_DECL 0x20 // only used for GLV_NO_DECL
Bram Moolenaar2ef951d2021-01-03 20:55:26 +01002881#define TFN_COMPILING 0x40 // only used for GLV_COMPILING
Bram Moolenaar937610b2022-01-19 17:21:29 +00002882#define TFN_NEW_FUNC 0x80 // defining a new function
Bram Moolenaarffdaca92022-12-09 21:41:48 +00002883#define TFN_ASSIGN_WITH_OP 0x100 // only for GLV_ASSIGN_WITH_OP
2884#define TFN_IN_CLASS 0x200 // function in a class
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002885
Bram Moolenaarc3308352019-09-01 16:24:56 +02002886// Values for get_lval() flags argument:
2887#define GLV_QUIET TFN_QUIET // no error messages
2888#define GLV_NO_AUTOLOAD TFN_NO_AUTOLOAD // do not use script autoloading
2889#define GLV_READ_ONLY TFN_READ_ONLY // will not change the var
Bram Moolenaar8f22f5c2020-12-19 22:10:13 +01002890#define GLV_NO_DECL TFN_NO_DECL // assignment without :var or :let
Bram Moolenaar2ef951d2021-01-03 20:55:26 +01002891#define GLV_COMPILING TFN_COMPILING // variable may be defined later
Bram Moolenaar22ebd172022-04-01 15:26:58 +01002892#define GLV_ASSIGN_WITH_OP TFN_ASSIGN_WITH_OP // assignment with operator
Bram Moolenaar99a7c0d2023-02-21 19:55:14 +00002893#define GLV_PREFER_FUNC 0x10000 // prefer function above variable
Yegappan Lakshmananb5a07192023-10-05 20:14:43 +02002894#define GLV_FOR_LOOP 0x20000 // assigning to a loop variable
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002895
Bram Moolenaarc3308352019-09-01 16:24:56 +02002896#define DO_NOT_FREE_CNT 99999 // refcount for dict or list that should not
2897 // be freed.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002898
Bram Moolenaar5cab73f2020-02-06 19:25:19 +01002899// fixed buffer length for fname_trans_sid()
2900#define FLEN_FIXED 40
2901
Bram Moolenaarc3308352019-09-01 16:24:56 +02002902// flags for find_name_end()
2903#define FNE_INCL_BR 1 // include [] in name
2904#define FNE_CHECK_START 2 // check name starts with valid character
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002905
Bram Moolenaarc3308352019-09-01 16:24:56 +02002906// BSD is supposed to cover FreeBSD and similar systems.
Bram Moolenaar1a2ab992017-11-28 21:06:18 +01002907#if (defined(SUN_SYSTEM) || defined(BSD) || defined(__FreeBSD_kernel__)) \
Bram Moolenaard569bb02018-08-11 13:57:20 +02002908 && (defined(S_ISCHR) || defined(S_IFCHR))
Bram Moolenaarf04507d2016-08-20 15:05:39 +02002909# define OPEN_CHR_FILES
2910#endif
2911
Bram Moolenaarc3308352019-09-01 16:24:56 +02002912// stat macros
Bram Moolenaard569bb02018-08-11 13:57:20 +02002913#ifndef S_ISDIR
2914# ifdef S_IFDIR
2915# define S_ISDIR(m) (((m) & S_IFMT) == S_IFDIR)
2916# else
2917# define S_ISDIR(m) 0
2918# endif
2919#endif
2920#ifndef S_ISREG
2921# ifdef S_IFREG
2922# define S_ISREG(m) (((m) & S_IFMT) == S_IFREG)
2923# else
2924# define S_ISREG(m) 0
2925# endif
2926#endif
2927#ifndef S_ISBLK
2928# ifdef S_IFBLK
2929# define S_ISBLK(m) (((m) & S_IFMT) == S_IFBLK)
2930# else
2931# define S_ISBLK(m) 0
2932# endif
2933#endif
2934#ifndef S_ISSOCK
2935# ifdef S_IFSOCK
2936# define S_ISSOCK(m) (((m) & S_IFMT) == S_IFSOCK)
2937# else
2938# define S_ISSOCK(m) 0
2939# endif
2940#endif
2941#ifndef S_ISFIFO
2942# ifdef S_IFIFO
2943# define S_ISFIFO(m) (((m) & S_IFMT) == S_IFIFO)
2944# else
2945# define S_ISFIFO(m) 0
2946# endif
2947#endif
2948#ifndef S_ISCHR
2949# ifdef S_IFCHR
2950# define S_ISCHR(m) (((m) & S_IFMT) == S_IFCHR)
2951# else
2952# define S_ISCHR(m) 0
2953# endif
2954#endif
2955#ifndef S_ISLNK
2956# ifdef S_IFLNK
2957# define S_ISLNK(m) (((m) & S_IFMT) == S_IFLNK)
2958# else
2959# define S_ISLNK(m) 0
2960# endif
2961#endif
2962
Bram Moolenaar833eb1d2016-11-24 17:22:50 +01002963#if defined(HAVE_GETTIMEOFDAY) && defined(HAVE_SYS_TIME_H)
2964# define ELAPSED_TIMEVAL
kylo2529dac9b12022-03-27 20:05:17 +01002965# define ELAPSED_INIT(v) gettimeofday(&(v), NULL)
2966# define ELAPSED_FUNC(v) elapsed(&(v))
Bram Moolenaar1ac56c22019-01-17 22:28:22 +01002967typedef struct timeval elapsed_T;
2968long elapsed(struct timeval *start_tv);
Bram Moolenaar4f974752019-02-17 17:44:42 +01002969#elif defined(MSWIN)
Bram Moolenaar1ac56c22019-01-17 22:28:22 +01002970# define ELAPSED_TICKCOUNT
2971# define ELAPSED_INIT(v) v = GetTickCount()
2972# define ELAPSED_FUNC(v) elapsed(v)
Bram Moolenaar1c321dc2019-02-01 20:42:22 +01002973# ifdef PROTO
2974typedef int DWORD;
2975# endif
Bram Moolenaar1ac56c22019-01-17 22:28:22 +01002976typedef DWORD elapsed_T;
2977# ifndef PROTO
2978long elapsed(DWORD start_tick);
Bram Moolenaar833eb1d2016-11-24 17:22:50 +01002979# endif
2980#endif
2981
Bram Moolenaarc3308352019-09-01 16:24:56 +02002982// Replacement for nchar used by nv_replace().
kylo2529dac9b12022-03-27 20:05:17 +01002983#define REPLACE_CR_NCHAR (-1)
2984#define REPLACE_NL_NCHAR (-2)
Bram Moolenaarf12519d2018-02-06 22:52:49 +01002985
Bram Moolenaarc3308352019-09-01 16:24:56 +02002986// flags for term_start()
Bram Moolenaar13568252018-03-16 20:46:58 +01002987#define TERM_START_NOJOB 1
2988#define TERM_START_FORCEIT 2
2989#define TERM_START_SYSTEM 4
2990
Bram Moolenaar40385db2018-08-07 22:31:44 +02002991// Used for icon/title save and restore.
2992#define SAVE_RESTORE_TITLE 1
2993#define SAVE_RESTORE_ICON 2
2994#define SAVE_RESTORE_BOTH (SAVE_RESTORE_TITLE | SAVE_RESTORE_ICON)
2995
Bram Moolenaarf3333b02019-05-19 22:53:40 +02002996// Flags for adjust_prop_columns()
2997#define APC_SAVE_FOR_UNDO 1 // call u_savesub() before making changes
2998#define APC_SUBSTITUTE 2 // text is replaced, not inserted
Bram Moolenaard8d4cfc2022-08-15 15:55:10 +01002999#define APC_INDENT 4 // changing indent
Bram Moolenaarf3333b02019-05-19 22:53:40 +02003000
Bram Moolenaarc662ec92019-06-23 00:15:57 +02003001#define CLIP_ZINDEX 32000
3002
Bram Moolenaar459fd782019-10-13 16:43:39 +02003003// Flags for replace_termcodes()
3004#define REPTERM_FROM_PART 1
3005#define REPTERM_DO_LT 2
3006#define REPTERM_SPECIAL 4
3007#define REPTERM_NO_SIMPLIFY 8
3008
Bram Moolenaarebe9d342020-05-30 21:52:54 +02003009// Flags for find_special_key()
3010#define FSK_KEYCODE 0x01 // prefer key code, e.g. K_DEL instead of DEL
3011#define FSK_KEEP_X_KEY 0x02 // don't translate xHome to Home key
3012#define FSK_IN_STRING 0x04 // TRUE in string, double quote is escaped
3013#define FSK_SIMPLIFY 0x08 // simplify <C-H> and <A-x>
Bram Moolenaar584b8532023-01-14 21:07:07 +00003014#define FSK_FROM_PART 0x10 // left-hand-side of mapping
Bram Moolenaarebe9d342020-05-30 21:52:54 +02003015
Bram Moolenaar84cf6bd2020-06-16 20:03:43 +02003016// Flags for the readdirex function, how to sort the result
3017#define READDIR_SORT_NONE 0 // do not sort
3018#define READDIR_SORT_BYTE 1 // sort by byte order (strcmp), default
3019#define READDIR_SORT_IC 2 // sort ignoring case (strcasecmp)
3020#define READDIR_SORT_COLLATE 3 // sort according to collation (strcoll)
3021
Bram Moolenaar0981c872020-08-23 14:28:37 +02003022// Flags for mch_delay.
3023#define MCH_DELAY_IGNOREINPUT 1
3024#define MCH_DELAY_SETTMODE 2
3025
Bram Moolenaarcb4e80f2021-03-13 20:57:19 +01003026// Flags for eval_variable().
3027#define EVAL_VAR_VERBOSE 1 // may give error message
3028#define EVAL_VAR_NOAUTOLOAD 2 // do not use script autoloading
3029#define EVAL_VAR_IMPORT 4 // may return special variable for import
Bram Moolenaar052ff292021-12-11 13:54:46 +00003030#define EVAL_VAR_NO_FUNC 8 // do not look for a function
Bram Moolenaarcb4e80f2021-03-13 20:57:19 +01003031
Yegappan Lakshmananbb01a1e2021-04-26 21:17:52 +02003032// Maximum number of characters that can be fuzzy matched
3033#define MAX_FUZZY_MATCHES 256
3034
Bram Moolenaar60dc8272021-07-29 22:48:54 +02003035// flags for equal_type()
3036#define ETYPE_ARG_UNKNOWN 1
3037
Bram Moolenaar73b8b0a2021-08-01 14:52:32 +02003038// flags used by user commands and :autocmd
3039#define UC_BUFFER 1 // -buffer: local to current buffer
3040#define UC_VIM9 2 // {} argument: Vim9 syntax.
3041
zeertzjqbb404f52022-07-23 06:25:29 +01003042// flags used by vim_strsave_fnameescape()
Bram Moolenaar21c1a0c2021-10-17 17:20:23 +01003043#define VSE_NONE 0
3044#define VSE_SHELL 1 // escape for a shell command
3045#define VSE_BUFFER 2 // escape for a ":buffer" command
Bram Moolenaar73b8b0a2021-08-01 14:52:32 +02003046
Bram Moolenaaracc4b562022-01-24 13:54:45 +00003047// Flags used by find_func_even_dead()
3048#define FFED_IS_GLOBAL 1 // "g:" was used
3049#define FFED_NO_GLOBAL 2 // only check for script-local functions
3050
Yegappan Lakshmanana061f342022-05-22 19:13:49 +01003051#define MAX_LSHIFT_BITS (varnumber_T)((sizeof(uvarnumber_T) * 8) - 1)
Bram Moolenaar113d9de2022-08-08 15:49:18 +01003052
Bram Moolenaar554d0312023-01-05 19:59:18 +00003053// Flags used by "class_flags" of define_function()
3054#define CF_CLASS 1 // inside a class
3055#define CF_INTERFACE 2 // inside an interface
Yegappan Lakshmanan7bcd25c2023-09-08 19:27:51 +02003056#define CF_ABSTRACT_METHOD 4 // inside an abstract class
Bram Moolenaar554d0312023-01-05 19:59:18 +00003057
Bram Moolenaarc3308352019-09-01 16:24:56 +02003058#endif // VIM__H