blob: ef30792ad195f00cbbd55356347be0d98c9f3eb1 [file] [log] [blame]
Bram Moolenaaredf3f972016-08-29 22:49:24 +02001/* vi:set ts=8 sts=4 sw=4 noet:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002 *
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 * See README.txt for an overview of the Vim source code.
8 */
9
10/*
11 * evalfunc.c: Builtin functions
12 */
13#define USING_FLOAT_STUFF
14
15#include "vim.h"
16
17#if defined(FEAT_EVAL) || defined(PROTO)
18
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020019#ifdef VMS
20# include <float.h>
21#endif
22
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020023static void f_and(typval_T *argvars, typval_T *rettv);
Bram Moolenaar59716a22017-03-01 20:32:44 +010024#ifdef FEAT_BEVAL
Bram Moolenaarbe0a2592019-05-09 13:50:16 +020025static void f_balloon_gettext(typval_T *argvars, typval_T *rettv);
Bram Moolenaar59716a22017-03-01 20:32:44 +010026static void f_balloon_show(typval_T *argvars, typval_T *rettv);
Bram Moolenaar669a8282017-11-19 20:13:05 +010027# if defined(FEAT_BEVAL_TERM)
Bram Moolenaar246fe032017-11-19 19:56:27 +010028static void f_balloon_split(typval_T *argvars, typval_T *rettv);
Bram Moolenaar669a8282017-11-19 20:13:05 +010029# endif
Bram Moolenaar59716a22017-03-01 20:32:44 +010030#endif
Yegappan Lakshmanan810785c2024-12-30 10:29:44 +010031static void f_base64_encode(typval_T *argvars, typval_T *rettv);
32static void f_base64_decode(typval_T *argvars, typval_T *rettv);
Christ van Willegence0ef912024-06-20 23:41:59 +020033static void f_bindtextdomain(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020034static void f_byte2line(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020035static void f_call(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020036static void f_changenr(typval_T *argvars, typval_T *rettv);
37static void f_char2nr(typval_T *argvars, typval_T *rettv);
Bram Moolenaar6f02b002021-01-10 20:22:54 +010038static void f_charcol(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020039static void f_col(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020040static void f_confirm(typval_T *argvars, typval_T *rettv);
41static void f_copy(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020042static void f_cursor(typval_T *argsvars, typval_T *rettv);
Bram Moolenaar4f974752019-02-17 17:44:42 +010043#ifdef MSWIN
Bram Moolenaar4551c0a2018-06-20 22:38:21 +020044static void f_debugbreak(typval_T *argvars, typval_T *rettv);
45#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020046static void f_deepcopy(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020047static void f_did_filetype(typval_T *argvars, typval_T *rettv);
Bram Moolenaar4132eb52020-02-14 16:53:00 +010048static void f_echoraw(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020049static void f_empty(typval_T *argvars, typval_T *rettv);
Bram Moolenaar691ddee2019-05-09 14:52:41 +020050static void f_environ(typval_T *argvars, typval_T *rettv);
Bram Moolenaar80adaa82023-07-07 18:57:40 +010051static void f_err_teapot(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020052static void f_escape(typval_T *argvars, typval_T *rettv);
53static void f_eval(typval_T *argvars, typval_T *rettv);
54static void f_eventhandler(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020055static void f_execute(typval_T *argvars, typval_T *rettv);
Bram Moolenaar26735992021-08-08 14:43:22 +020056static void f_exists_compiled(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020057static void f_expand(typval_T *argvars, typval_T *rettv);
Bram Moolenaar80dad482019-06-09 17:22:31 +020058static void f_expandcmd(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020059static void f_feedkeys(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020060static void f_fnameescape(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020061static void f_foreground(typval_T *argvars, typval_T *rettv);
Bram Moolenaar437bafe2016-08-01 15:40:54 +020062static void f_funcref(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020063static void f_function(typval_T *argvars, typval_T *rettv);
64static void f_garbagecollect(typval_T *argvars, typval_T *rettv);
65static void f_get(typval_T *argvars, typval_T *rettv);
mikoto2000a73dfc22024-11-18 21:12:21 +010066static void f_getcellpixels(typval_T *argvars, typval_T *rettv);
Bram Moolenaar07ad8162018-02-13 13:59:59 +010067static void f_getchangelist(typval_T *argvars, typval_T *rettv);
Bram Moolenaar6f02b002021-01-10 20:22:54 +010068static void f_getcharpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020069static void f_getcharsearch(typval_T *argvars, typval_T *rettv);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +010070static void f_getcurpos(typval_T *argvars, typval_T *rettv);
71static void f_getcursorcharpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar691ddee2019-05-09 14:52:41 +020072static void f_getenv(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020073static void f_getfontname(typval_T *argvars, typval_T *rettv);
Bram Moolenaar4f505882018-02-10 21:06:32 +010074static void f_getjumplist(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020075static void f_getpid(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020076static void f_getpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020077static void f_getreg(typval_T *argvars, typval_T *rettv);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020078static void f_getreginfo(typval_T *argvars, typval_T *rettv);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +010079static void f_getregion(typval_T *argvars, typval_T *rettv);
Shougo Matsushitab4757e62024-05-07 20:49:24 +020080static void f_getregionpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020081static void f_getregtype(typval_T *argvars, typval_T *rettv);
Bram Moolenaarf49cc602018-11-11 15:21:05 +010082static void f_gettagstack(typval_T *argvars, typval_T *rettv);
Bram Moolenaar0b39c3f2020-08-30 15:52:10 +020083static void f_gettext(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020084static void f_haslocaldir(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020085static void f_hlID(typval_T *argvars, typval_T *rettv);
86static void f_hlexists(typval_T *argvars, typval_T *rettv);
87static void f_hostname(typval_T *argvars, typval_T *rettv);
Ernie Raelc8e158b2024-07-09 18:39:52 +020088static void f_id(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020089static void f_index(typval_T *argvars, typval_T *rettv);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +010090static void f_indexof(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020091static void f_input(typval_T *argvars, typval_T *rettv);
92static void f_inputdialog(typval_T *argvars, typval_T *rettv);
93static void f_inputlist(typval_T *argvars, typval_T *rettv);
94static void f_inputrestore(typval_T *argvars, typval_T *rettv);
95static void f_inputsave(typval_T *argvars, typval_T *rettv);
96static void f_inputsecret(typval_T *argvars, typval_T *rettv);
Bram Moolenaar67a2deb2019-11-25 00:05:32 +010097static void f_interrupt(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020098static void f_invert(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020099static void f_islocked(typval_T *argvars, typval_T *rettv);
zeertzjqcdc83932022-09-12 13:38:41 +0100100static void f_keytrans(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200101static void f_last_buffer_nr(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200102static void f_libcall(typval_T *argvars, typval_T *rettv);
103static void f_libcallnr(typval_T *argvars, typval_T *rettv);
104static void f_line(typval_T *argvars, typval_T *rettv);
105static void f_line2byte(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200106#ifdef FEAT_LUA
107static void f_luaeval(typval_T *argvars, typval_T *rettv);
108#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200109static void f_match(typval_T *argvars, typval_T *rettv);
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +0100110static void f_matchbufline(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200111static void f_matchend(typval_T *argvars, typval_T *rettv);
112static void f_matchlist(typval_T *argvars, typval_T *rettv);
113static void f_matchstr(typval_T *argvars, typval_T *rettv);
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +0100114static void f_matchstrlist(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200115static void f_matchstrpos(typval_T *argvars, typval_T *rettv);
116static void f_max(typval_T *argvars, typval_T *rettv);
117static void f_min(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200118#ifdef FEAT_MZSCHEME
119static void f_mzeval(typval_T *argvars, typval_T *rettv);
120#endif
121static void f_nextnonblank(typval_T *argvars, typval_T *rettv);
122static void f_nr2char(typval_T *argvars, typval_T *rettv);
123static void f_or(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200124#ifdef FEAT_PERL
125static void f_perleval(typval_T *argvars, typval_T *rettv);
126#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200127static void f_prevnonblank(typval_T *argvars, typval_T *rettv);
128static void f_printf(typval_T *argvars, typval_T *rettv);
Bram Moolenaare9bd5722019-08-17 19:36:06 +0200129static void f_pum_getpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200130static void f_pumvisible(typval_T *argvars, typval_T *rettv);
131#ifdef FEAT_PYTHON3
132static void f_py3eval(typval_T *argvars, typval_T *rettv);
133#endif
134#ifdef FEAT_PYTHON
135static void f_pyeval(typval_T *argvars, typval_T *rettv);
136#endif
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +0100137#if defined(FEAT_PYTHON) || defined(FEAT_PYTHON3)
138static void f_pyxeval(typval_T *argvars, typval_T *rettv);
139#endif
Bram Moolenaar4f645c52020-02-08 16:40:39 +0100140static void f_test_srand_seed(typval_T *argvars, typval_T *rettv);
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +0100141static void f_rand(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200142static void f_range(typval_T *argvars, typval_T *rettv);
Bram Moolenaar0b6d9112018-05-22 20:35:17 +0200143static void f_reg_executing(typval_T *argvars, typval_T *rettv);
144static void f_reg_recording(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200145static void f_rename(typval_T *argvars, typval_T *rettv);
146static void f_repeat(typval_T *argvars, typval_T *rettv);
Bram Moolenaare99be0e2019-03-26 22:51:09 +0100147#ifdef FEAT_RUBY
148static void f_rubyeval(typval_T *argvars, typval_T *rettv);
149#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200150static void f_screenattr(typval_T *argvars, typval_T *rettv);
151static void f_screenchar(typval_T *argvars, typval_T *rettv);
Bram Moolenaar2912abb2019-03-29 14:16:42 +0100152static void f_screenchars(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200153static void f_screencol(typval_T *argvars, typval_T *rettv);
154static void f_screenrow(typval_T *argvars, typval_T *rettv);
Bram Moolenaar2912abb2019-03-29 14:16:42 +0100155static void f_screenstring(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200156static void f_search(typval_T *argvars, typval_T *rettv);
157static void f_searchdecl(typval_T *argvars, typval_T *rettv);
158static void f_searchpair(typval_T *argvars, typval_T *rettv);
159static void f_searchpairpos(typval_T *argvars, typval_T *rettv);
160static void f_searchpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar6f02b002021-01-10 20:22:54 +0100161static void f_setcharpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200162static void f_setcharsearch(typval_T *argvars, typval_T *rettv);
Bram Moolenaar6f02b002021-01-10 20:22:54 +0100163static void f_setcursorcharpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar691ddee2019-05-09 14:52:41 +0200164static void f_setenv(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200165static void f_setfperm(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200166static void f_setpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200167static void f_setreg(typval_T *argvars, typval_T *rettv);
Bram Moolenaarf49cc602018-11-11 15:21:05 +0100168static void f_settagstack(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200169#ifdef FEAT_CRYPT
170static void f_sha256(typval_T *argvars, typval_T *rettv);
Bram Moolenaarb005cd82019-09-04 15:54:55 +0200171#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200172static void f_shellescape(typval_T *argvars, typval_T *rettv);
173static void f_shiftwidth(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200174static void f_soundfold(typval_T *argvars, typval_T *rettv);
175static void f_spellbadword(typval_T *argvars, typval_T *rettv);
176static void f_spellsuggest(typval_T *argvars, typval_T *rettv);
177static void f_split(typval_T *argvars, typval_T *rettv);
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +0100178static void f_srand(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200179static void f_submatch(typval_T *argvars, typval_T *rettv);
180static void f_substitute(typval_T *argvars, typval_T *rettv);
Bram Moolenaarc216a7a2022-12-05 13:50:55 +0000181static void f_swapfilelist(typval_T *argvars, typval_T *rettv);
Bram Moolenaar00f123a2018-08-21 20:28:54 +0200182static void f_swapinfo(typval_T *argvars, typval_T *rettv);
Bram Moolenaar110bd602018-09-16 18:46:59 +0200183static void f_swapname(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200184static void f_synID(typval_T *argvars, typval_T *rettv);
185static void f_synIDattr(typval_T *argvars, typval_T *rettv);
186static void f_synIDtrans(typval_T *argvars, typval_T *rettv);
187static void f_synstack(typval_T *argvars, typval_T *rettv);
188static void f_synconcealed(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200189static void f_tabpagebuflist(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200190static void f_taglist(typval_T *argvars, typval_T *rettv);
191static void f_tagfiles(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200192static void f_type(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200193static void f_virtcol(typval_T *argvars, typval_T *rettv);
194static void f_visualmode(typval_T *argvars, typval_T *rettv);
195static void f_wildmenumode(typval_T *argvars, typval_T *rettv);
Bram Moolenaar0c1e3742019-12-27 13:49:24 +0100196static void f_windowsversion(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200197static void f_wordcount(typval_T *argvars, typval_T *rettv);
198static void f_xor(typval_T *argvars, typval_T *rettv);
199
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +0100200
Bram Moolenaar94738d82020-10-21 14:25:07 +0200201/*
202 * Functions that check the argument type of a builtin function.
203 * Each function returns FAIL and gives an error message if the type is wrong.
204 */
205
206// Context passed to an arg_ function.
207typedef struct {
Bram Moolenaarca174532020-10-21 16:42:22 +0200208 int arg_count; // actual argument count
Bram Moolenaar078a4612022-01-04 15:17:03 +0000209 type2_T *arg_types; // list of argument types
Bram Moolenaarca174532020-10-21 16:42:22 +0200210 int arg_idx; // current argument index (first arg is zero)
Bram Moolenaar351ead02021-01-16 16:07:01 +0100211 cctx_T *arg_cctx;
Bram Moolenaar94738d82020-10-21 14:25:07 +0200212} argcontext_T;
213
214// A function to check one argument type. The first argument is the type to
215// check. If needed, other argument types can be obtained with the context.
216// E.g. if "arg_idx" is 1, then (type - 1) is the first argument type.
Ernie Raela8f7f922023-12-14 20:17:04 +0100217// NOTE: Use "arg_any", not NULL, in funcentry_T.f_argcheck array
218// to accept an argument of any type.
Bram Moolenaar078a4612022-01-04 15:17:03 +0000219typedef int (*argcheck_T)(type_T *, type_T *, argcontext_T *);
Bram Moolenaar94738d82020-10-21 14:25:07 +0200220
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100221/*
Bram Moolenaar351ead02021-01-16 16:07:01 +0100222 * Call need_type() to check an argument type.
223 */
224 static int
225check_arg_type(
226 type_T *expected,
227 type_T *actual,
228 argcontext_T *context)
229{
Bram Moolenaarc6951a72022-12-29 20:56:24 +0000230 return need_type(actual, expected, FALSE,
Bram Moolenaar351ead02021-01-16 16:07:01 +0100231 context->arg_idx - context->arg_count, context->arg_idx + 1,
232 context->arg_cctx, FALSE, FALSE);
233}
234
235/*
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100236 * Call need_type() to check an argument type and that it is modifiable
237 */
238 static int
239check_arg_type_mod(
240 type_T *expected,
241 type_T *actual,
242 argcontext_T *context)
243{
Bram Moolenaarc6951a72022-12-29 20:56:24 +0000244 if (need_type(actual, expected, FALSE,
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100245 context->arg_idx - context->arg_count, context->arg_idx + 1,
246 context->arg_cctx, FALSE, FALSE) == FAIL)
247 return FAIL;
248 return arg_type_modifiable(actual, context->arg_idx + 1);
249}
250
251/*
Bram Moolenaarfa103972022-09-29 19:14:42 +0100252 * Give an error if "type" is a constant.
253 */
254 int
255arg_type_modifiable(type_T *type, int arg_idx)
256{
257 char *tofree;
258
259 if ((type->tt_flags & TTFLAG_CONST) == 0)
260 return OK;
261 semsg(_(e_argument_nr_trying_to_modify_const_str),
262 arg_idx, type_name(type, &tofree));
263 vim_free(tofree);
264 return FAIL;
265}
266
267/*
Ernie Raela8f7f922023-12-14 20:17:04 +0100268 * Return OK for any type unconditionally.
269 */
270 static int
271arg_any(type_T *type UNUSED,
272 type_T *decl_type UNUSED,
273 argcontext_T *context UNUSED)
274{
275 return OK;
276}
277
278/*
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100279 * Check "type" is a float or a number.
280 */
Bram Moolenaar94738d82020-10-21 14:25:07 +0200281 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000282arg_float_or_nr(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaar94738d82020-10-21 14:25:07 +0200283{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100284 if (type->tt_type == VAR_FLOAT
285 || type->tt_type == VAR_NUMBER
286 || type_any_or_unknown(type))
Bram Moolenaar94738d82020-10-21 14:25:07 +0200287 return OK;
288 arg_type_mismatch(&t_number, type, context->arg_idx + 1);
289 return FAIL;
290}
291
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100292/*
293 * Check "type" is a number.
294 */
Bram Moolenaarca174532020-10-21 16:42:22 +0200295 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000296arg_number(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarca174532020-10-21 16:42:22 +0200297{
Bram Moolenaar351ead02021-01-16 16:07:01 +0100298 return check_arg_type(&t_number, type, context);
Bram Moolenaarca174532020-10-21 16:42:22 +0200299}
300
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100301/*
LemonBoyafe04662023-08-23 21:08:11 +0200302 * Check "type" is an object.
303 */
304 static int
305arg_object(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
306{
Yegappan Lakshmananb49ad282023-08-27 19:08:40 +0200307 if (type->tt_type == VAR_OBJECT
308 || type_any_or_unknown(type))
309 return OK;
310 arg_type_mismatch(&t_object, type, context->arg_idx + 1);
311 return FAIL;
LemonBoyafe04662023-08-23 21:08:11 +0200312}
313
314/*
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200315 * Check "type" is a dict of 'any'.
316 */
317 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000318arg_dict_any(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200319{
320 return check_arg_type(&t_dict_any, type, context);
321}
322
323/*
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +0200324 * Check "type" is a list of 'any'.
325 */
326 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000327arg_list_any(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +0200328{
329 return check_arg_type(&t_list_any, type, context);
330}
331
332/*
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100333 * Check "type" is a list of 'any' and modifiable
334 */
335 static int
336arg_list_any_mod(
337 type_T *type,
338 type_T *decl_type UNUSED,
339 argcontext_T *context)
340{
341 return check_arg_type_mod(&t_list_any, type, context);
342}
343
344/*
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200345 * Check "type" is a list of numbers.
346 */
347 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000348arg_list_number(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200349{
350 return check_arg_type(&t_list_number, type, context);
351}
352
353/*
354 * Check "type" is a list of strings.
355 */
356 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000357arg_list_string(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200358{
359 return check_arg_type(&t_list_string, type, context);
360}
361
362/*
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100363 * Check "type" is a string.
364 */
365 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000366arg_string(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100367{
Bram Moolenaar351ead02021-01-16 16:07:01 +0100368 return check_arg_type(&t_string, type, context);
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100369}
370
371/*
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +0200372 * Check "type" is a blob
373 */
374 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000375arg_blob(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +0200376{
377 return check_arg_type(&t_blob, type, context);
378}
379
380/*
Bram Moolenaarf2b26bc2021-01-30 23:05:11 +0100381 * Check "type" is a bool or number 0 or 1.
382 */
383 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000384arg_bool(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarf2b26bc2021-01-30 23:05:11 +0100385{
Bram Moolenaarf2b26bc2021-01-30 23:05:11 +0100386 return check_arg_type(&t_bool, type, context);
387}
388
389/*
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200390 * Check "type" is a list of 'any' or a blob.
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100391 */
Bram Moolenaarca174532020-10-21 16:42:22 +0200392 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000393arg_list_or_blob(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarca174532020-10-21 16:42:22 +0200394{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100395 if (type->tt_type == VAR_LIST
396 || type->tt_type == VAR_BLOB
397 || type_any_or_unknown(type))
Bram Moolenaarca174532020-10-21 16:42:22 +0200398 return OK;
399 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
400 return FAIL;
401}
402
403/*
Bram Moolenaarfa103972022-09-29 19:14:42 +0100404 * Check "type" is a modifiable list of 'any' or a blob.
405 */
406 static int
407arg_list_or_blob_mod(
408 type_T *type,
409 type_T *decl_type,
410 argcontext_T *context)
411{
412 if (arg_list_or_blob(type, decl_type, context) == FAIL)
413 return FAIL;
414 return arg_type_modifiable(type, context->arg_idx + 1);
415}
416
417/*
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200418 * Check "type" is a string or a number
419 */
420 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000421arg_string_or_nr(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200422{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100423 if (type->tt_type == VAR_STRING
424 || type->tt_type == VAR_NUMBER
425 || type_any_or_unknown(type))
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200426 return OK;
427 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
428 return FAIL;
429}
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200430
431/*
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200432 * Check "type" is a buffer (string or a number)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200433 */
434 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000435arg_buffer(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200436{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100437 if (type->tt_type == VAR_STRING
438 || type->tt_type == VAR_NUMBER
439 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200440 return OK;
441 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
442 return FAIL;
443}
444
445/*
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200446 * Check "type" is a buffer or a dict of any
447 */
448 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000449arg_buffer_or_dict_any(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200450{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100451 if (type->tt_type == VAR_STRING
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200452 || type->tt_type == VAR_NUMBER
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100453 || type->tt_type == VAR_DICT
454 || type_any_or_unknown(type))
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200455 return OK;
456 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
457 return FAIL;
458}
459
460/*
461 * Check "type" is a line (string or a number)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200462 */
463 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000464arg_lnum(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200465{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100466 if (type->tt_type == VAR_STRING
467 || type->tt_type == VAR_NUMBER
468 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200469 return OK;
470 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
471 return FAIL;
472}
473
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200474/*
Bram Moolenaarca81f0e2021-06-20 14:41:01 +0200475 * Check "type" is a string or a list of strings.
476 */
477 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000478arg_string_or_list_string(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarca81f0e2021-06-20 14:41:01 +0200479{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100480 if (type->tt_type == VAR_STRING
481 || type_any_or_unknown(type))
Bram Moolenaarca81f0e2021-06-20 14:41:01 +0200482 return OK;
483 if (type->tt_type != VAR_LIST)
484 {
485 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
486 return FAIL;
487 }
488 if (type->tt_member->tt_type == VAR_ANY
489 || type->tt_member->tt_type == VAR_STRING)
490 return OK;
491
492 arg_type_mismatch(&t_list_string, type, context->arg_idx + 1);
493 return FAIL;
494}
495
496/*
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200497 * Check "type" is a string or a list of 'any'
498 */
499 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000500arg_string_or_list_any(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200501{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100502 if (type->tt_type == VAR_STRING
503 || type->tt_type == VAR_LIST
504 || type_any_or_unknown(type))
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200505 return OK;
506 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
507 return FAIL;
508}
509
510/*
Ernie Rael51d04d12022-05-04 15:40:22 +0100511 * Check "type" is a string or a dict of 'any'
512 */
513 static int
514arg_string_or_dict_any(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
515{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100516 if (type->tt_type == VAR_STRING
517 || type->tt_type == VAR_DICT
518 || type_any_or_unknown(type))
Ernie Rael51d04d12022-05-04 15:40:22 +0100519 return OK;
520 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
521 return FAIL;
522}
523
524/*
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200525 * Check "type" is a string or a blob
526 */
527 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000528arg_string_or_blob(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200529{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100530 if (type->tt_type == VAR_STRING
531 || type->tt_type == VAR_BLOB
532 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200533 return OK;
534 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
535 return FAIL;
536}
537
538/*
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +0200539 * Check "type" is a list of 'any' or a dict of 'any'.
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100540 */
541 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000542arg_list_or_dict(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100543{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100544 if (type->tt_type == VAR_LIST
545 || type->tt_type == VAR_DICT
546 || type_any_or_unknown(type))
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100547 return OK;
548 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
549 return FAIL;
550}
551
552/*
Bram Moolenaarfa103972022-09-29 19:14:42 +0100553 * Check "type" is a list of 'any' or a dict of 'any'. And modifiable.
554 */
555 static int
556arg_list_or_dict_mod(
557 type_T *type,
558 type_T *decl_type,
559 argcontext_T *context)
560{
561 if (arg_list_or_dict(type, decl_type, context) == FAIL)
562 return FAIL;
563 return arg_type_modifiable(type, context->arg_idx + 1);
564}
565
566/*
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200567 * Check "type" is a list of 'any' or a dict of 'any' or a blob.
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100568 * Also check if "type" is modifiable.
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200569 */
570 static int
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100571arg_list_or_dict_or_blob_mod(
572 type_T *type,
573 type_T *decl_type UNUSED,
574 argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200575{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100576 if (type->tt_type == VAR_LIST
Bram Moolenaar59618fe2021-12-21 12:32:17 +0000577 || type->tt_type == VAR_DICT
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100578 || type->tt_type == VAR_BLOB
579 || type_any_or_unknown(type))
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100580 return arg_type_modifiable(type, context->arg_idx + 1);
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200581 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
582 return FAIL;
583}
584
585/*
Bram Moolenaar2d877592021-12-16 08:21:09 +0000586 * Check "type" is a list of 'any' or a dict of 'any' or a blob or a string.
587 */
588 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000589arg_list_or_dict_or_blob_or_string(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaar2d877592021-12-16 08:21:09 +0000590{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100591 if (type->tt_type == VAR_LIST
Bram Moolenaar59618fe2021-12-21 12:32:17 +0000592 || type->tt_type == VAR_DICT
593 || type->tt_type == VAR_BLOB
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100594 || type->tt_type == VAR_STRING
595 || type_any_or_unknown(type))
Bram Moolenaar2d877592021-12-16 08:21:09 +0000596 return OK;
597 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
598 return FAIL;
599}
600
601/*
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100602 * Check "type" is a list of 'any' or a dict of 'any' or a blob or a string.
603 * Also check the value is modifiable.
604 */
605 static int
606arg_list_or_dict_or_blob_or_string_mod(
607 type_T *type,
608 type_T *decl_type,
609 argcontext_T *context)
610{
611 if (arg_list_or_dict_or_blob_or_string(type, decl_type, context) == FAIL)
612 return FAIL;
613 return arg_type_modifiable(type, context->arg_idx + 1);
614}
615
616/*
Ernie Raele79e2072024-01-13 11:47:33 +0100617 * Check second argument of map(), filter(), foreach().
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000618 */
619 static int
Ernie Raele79e2072024-01-13 11:47:33 +0100620check_map_filter_arg2(type_T *type, argcontext_T *context,
621 filtermap_T filtermap)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000622{
623 type_T *expected_member = NULL;
624 type_T *(args[2]);
Bram Moolenaarb1e32ac2023-02-21 12:38:51 +0000625 type_T t_func_exp = {VAR_FUNC, 2, 0, 0, NULL, NULL, args};
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000626
627 if (context->arg_types[0].type_curr->tt_type == VAR_LIST
628 || context->arg_types[0].type_curr->tt_type == VAR_DICT)
629 {
630 // Use the declared type if possible, so that an error is given if
631 // a declared list changes type, but not if a constant list changes
632 // type.
633 if (context->arg_types[0].type_decl->tt_type == VAR_LIST
634 || context->arg_types[0].type_decl->tt_type == VAR_DICT)
635 expected_member = context->arg_types[0].type_decl->tt_member;
636 else
637 expected_member = context->arg_types[0].type_curr->tt_member;
638 }
639 else if (context->arg_types[0].type_curr->tt_type == VAR_STRING)
640 expected_member = &t_string;
641 else if (context->arg_types[0].type_curr->tt_type == VAR_BLOB)
642 expected_member = &t_number;
643
644 args[0] = NULL;
645 args[1] = &t_unknown;
646 if (type->tt_argcount != -1)
647 {
648 if (!(type->tt_argcount == 2 || (type->tt_argcount == 1
649 && (type->tt_flags & TTFLAG_VARARGS))))
650 {
651 emsg(_(e_invalid_number_of_arguments));
652 return FAIL;
653 }
654 if (type->tt_flags & TTFLAG_VARARGS)
655 // check the argument types at runtime
656 t_func_exp.tt_argcount = -1;
657 else
658 {
659 if (context->arg_types[0].type_curr->tt_type == VAR_STRING
660 || context->arg_types[0].type_curr->tt_type == VAR_BLOB
661 || context->arg_types[0].type_curr->tt_type == VAR_LIST)
662 args[0] = &t_number;
663 else if (context->arg_types[0].type_decl->tt_type == VAR_DICT)
664 args[0] = &t_string;
665 if (args[0] != NULL)
666 args[1] = expected_member;
667 }
668 }
669
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100670 if (!type_any_or_unknown(type->tt_member) || args[0] != NULL)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000671 {
672 where_T where = WHERE_INIT;
673
Ernie Raele79e2072024-01-13 11:47:33 +0100674 if (filtermap == FILTERMAP_MAP)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000675 t_func_exp.tt_member = expected_member == NULL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100676 || type_any_or_unknown(type->tt_member)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000677 ? &t_any : expected_member;
Ernie Raele79e2072024-01-13 11:47:33 +0100678 else if (filtermap == FILTERMAP_FILTER)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000679 t_func_exp.tt_member = &t_bool;
Ernie Raele79e2072024-01-13 11:47:33 +0100680 else // filtermap == FILTERMAP_FOREACH
681 t_func_exp.tt_member = &t_unknown;
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000682 if (args[0] == NULL)
683 args[0] = &t_unknown;
Bram Moolenaar6e1a3872022-02-23 19:11:49 +0000684 if (type->tt_argcount == -1)
685 t_func_exp.tt_argcount = -1;
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000686
687 where.wt_index = 2;
LemonBoyc5d27442023-08-19 13:02:35 +0200688 where.wt_kind = WT_ARGUMENT;
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000689 return check_type(&t_func_exp, type, TRUE, where);
690 }
691 return OK;
692}
693
694/*
Bram Moolenaar18024052021-12-25 21:43:28 +0000695 * Check second argument of filter(): func must return a bool.
696 */
697 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000698arg_filter_func(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaar18024052021-12-25 21:43:28 +0000699{
Bram Moolenaar1080c482022-01-26 18:26:21 +0000700 if (type->tt_type == VAR_STRING
701 || type->tt_type == VAR_PARTIAL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100702 || type_any_or_unknown(type))
Bram Moolenaar1080c482022-01-26 18:26:21 +0000703 return OK;
704
705 if (type->tt_type == VAR_FUNC)
Ernie Raele79e2072024-01-13 11:47:33 +0100706 return check_map_filter_arg2(type, context, FILTERMAP_FILTER);
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000707 semsg(_(e_string_or_function_required_for_argument_nr), 2);
708 return FAIL;
Bram Moolenaar18024052021-12-25 21:43:28 +0000709}
710
711/*
Bram Moolenaareddd4fc2022-02-20 15:52:28 +0000712 * Check second argument of map(), the function.
Bram Moolenaar18024052021-12-25 21:43:28 +0000713 */
714 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000715arg_map_func(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaar18024052021-12-25 21:43:28 +0000716{
Bram Moolenaar1080c482022-01-26 18:26:21 +0000717 if (type->tt_type == VAR_STRING
718 || type->tt_type == VAR_PARTIAL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100719 || type_any_or_unknown(type))
Bram Moolenaar1080c482022-01-26 18:26:21 +0000720 return OK;
721
722 if (type->tt_type == VAR_FUNC)
Ernie Raele79e2072024-01-13 11:47:33 +0100723 return check_map_filter_arg2(type, context, FILTERMAP_MAP);
724 semsg(_(e_string_or_function_required_for_argument_nr), 2);
725 return FAIL;
726}
727
728/*
729 * Check second argument of foreach(), the function.
730 */
731 static int
732arg_foreach_func(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
733{
734 if (type->tt_type == VAR_STRING
735 || type->tt_type == VAR_PARTIAL
736 || type_any_or_unknown(type))
737 return OK;
738
739 if (type->tt_type == VAR_FUNC)
740 return check_map_filter_arg2(type, context, FILTERMAP_FOREACH);
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000741 semsg(_(e_string_or_function_required_for_argument_nr), 2);
742 return FAIL;
Bram Moolenaar18024052021-12-25 21:43:28 +0000743}
744
745/*
Bram Moolenaare843efc2022-02-22 21:54:44 +0000746 * Check second argument of sort() and uniq(), the "how" argument.
747 */
748 static int
749arg_sort_how(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
750{
751 if (type->tt_type == VAR_STRING
752 || type->tt_type == VAR_PARTIAL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100753 || type_any_or_unknown(type))
Bram Moolenaare843efc2022-02-22 21:54:44 +0000754 return OK;
755
756 if (type->tt_type == VAR_FUNC)
757 {
758 type_T *(args[2]);
Bram Moolenaarb1e32ac2023-02-21 12:38:51 +0000759 type_T t_func_exp = {VAR_FUNC, 2, 0, 0, &t_number, NULL, args};
Bram Moolenaare843efc2022-02-22 21:54:44 +0000760
761 if (context->arg_types[0].type_curr->tt_type == VAR_LIST)
762 args[0] = context->arg_types[0].type_curr->tt_member;
763 else
764 args[0] = &t_unknown;
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100765 if (!type_any_or_unknown(type->tt_member) || args[0] != &t_unknown)
Bram Moolenaare843efc2022-02-22 21:54:44 +0000766 {
767 where_T where = WHERE_INIT;
768
769 args[1] = args[0];
Bram Moolenaarfa026162022-02-23 21:03:32 +0000770 if (type->tt_argcount == -1)
771 t_func_exp.tt_argcount = -1;
Bram Moolenaare843efc2022-02-22 21:54:44 +0000772 where.wt_index = 2;
LemonBoyc5d27442023-08-19 13:02:35 +0200773 where.wt_kind = WT_ARGUMENT;
Bram Moolenaare843efc2022-02-22 21:54:44 +0000774 return check_type(&t_func_exp, type, TRUE, where);
775 }
776
777 return OK;
778 }
779 semsg(_(e_string_or_function_required_for_argument_nr), 2);
780 return FAIL;
781}
782
783/*
Bram Moolenaar73199812021-12-26 17:18:14 +0000784 * Check an expression argument, can be a string, funcref or partial.
785 * Also accept a bool, a constant resulting from compiling a string argument.
786 * Also accept a number, one and zero are accepted.
787 */
788 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000789arg_string_or_func(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaar73199812021-12-26 17:18:14 +0000790{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100791 if (type->tt_type == VAR_STRING
Bram Moolenaar73199812021-12-26 17:18:14 +0000792 || type->tt_type == VAR_PARTIAL
793 || type->tt_type == VAR_FUNC
794 || type->tt_type == VAR_BOOL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100795 || type->tt_type == VAR_NUMBER
796 || type_any_or_unknown(type))
Bram Moolenaar73199812021-12-26 17:18:14 +0000797 return OK;
798 arg_type_mismatch(&t_func_any, type, context->arg_idx + 1);
799 return FAIL;
800}
801
802/*
Ernie Rael2025af12023-12-12 16:58:00 +0100803 * Check varargs' "type" are class.
LemonBoyafe04662023-08-23 21:08:11 +0200804 */
805 static int
Ernie Rael2025af12023-12-12 16:58:00 +0100806varargs_class(type_T *type UNUSED,
807 type_T *decl_type UNUSED,
808 argcontext_T *context)
LemonBoyafe04662023-08-23 21:08:11 +0200809{
Ernie Rael2025af12023-12-12 16:58:00 +0100810 for (int i = context->arg_idx; i < context->arg_count; ++i)
811 {
812 type2_T *types = &context->arg_types[i];
813 if (types->type_curr->tt_type != VAR_CLASS)
814 {
815 semsg(_(e_class_or_typealias_required_for_argument_nr), i + 1);
816 return FAIL;
817 }
818 }
819 return OK;
LemonBoyafe04662023-08-23 21:08:11 +0200820}
821
822/*
rbtnn0ccb5842021-12-18 18:33:46 +0000823 * Check "type" is a list of 'any' or a blob or a string.
824 */
825 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000826arg_string_list_or_blob(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
rbtnn0ccb5842021-12-18 18:33:46 +0000827{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100828 if (type->tt_type == VAR_LIST
Bram Moolenaar59618fe2021-12-21 12:32:17 +0000829 || type->tt_type == VAR_BLOB
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100830 || type->tt_type == VAR_STRING
831 || type_any_or_unknown(type))
rbtnn0ccb5842021-12-18 18:33:46 +0000832 return OK;
833 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
834 return FAIL;
835}
836
837/*
Yegappan Lakshmananf9dc2782023-05-11 15:02:56 +0100838 * Check "type" is a modifiable list of 'any' or a blob or a string.
839 */
840 static int
841arg_string_list_or_blob_mod(type_T *type, type_T *decl_type, argcontext_T *context)
842{
843 if (arg_string_list_or_blob(type, decl_type, context) == FAIL)
844 return FAIL;
845 return arg_type_modifiable(type, context->arg_idx + 1);
846}
847
848/*
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +0200849 * Check "type" is a job.
850 */
851 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000852arg_job(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +0200853{
854 return check_arg_type(&t_job, type, context);
855}
856
857/*
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +0200858 * Check "type" is a channel or a job.
859 */
860 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000861arg_chan_or_job(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +0200862{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100863 if (type->tt_type == VAR_CHANNEL
864 || type->tt_type == VAR_JOB
865 || type_any_or_unknown(type))
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +0200866 return OK;
867 arg_type_mismatch(&t_channel, type, context->arg_idx + 1);
868 return FAIL;
869}
870
871/*
Bram Moolenaar078a4612022-01-04 15:17:03 +0000872 * Check "type" can be used as the type_decl of the previous argument.
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100873 * Must not be used for the first argcheck_T entry.
874 */
875 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000876arg_same_as_prev(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100877{
Bram Moolenaar078a4612022-01-04 15:17:03 +0000878 type_T *prev_type = context->arg_types[context->arg_idx - 1].type_decl;
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100879
Bram Moolenaar351ead02021-01-16 16:07:01 +0100880 return check_arg_type(prev_type, type, context);
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100881}
882
883/*
Bram Moolenaarb0e6b512021-01-12 20:23:40 +0100884 * Check "type" is the same basic type as the previous argument, checks list or
885 * dict vs other type, but not member type.
886 * Must not be used for the first argcheck_T entry.
887 */
888 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000889arg_same_struct_as_prev(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarb0e6b512021-01-12 20:23:40 +0100890{
Bram Moolenaar078a4612022-01-04 15:17:03 +0000891 type_T *prev_type = context->arg_types[context->arg_idx - 1].type_curr;
Bram Moolenaarb0e6b512021-01-12 20:23:40 +0100892
Bram Moolenaar078a4612022-01-04 15:17:03 +0000893 if (prev_type->tt_type != context->arg_types[context->arg_idx].type_curr->tt_type)
Bram Moolenaar351ead02021-01-16 16:07:01 +0100894 return check_arg_type(prev_type, type, context);
Bram Moolenaarb0e6b512021-01-12 20:23:40 +0100895 return OK;
896}
897
898/*
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100899 * Check "type" is an item of the list or blob of the previous arg.
Bram Moolenaarca174532020-10-21 16:42:22 +0200900 * Must not be used for the first argcheck_T entry.
901 */
902 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000903arg_item_of_prev(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarca174532020-10-21 16:42:22 +0200904{
Bram Moolenaar078a4612022-01-04 15:17:03 +0000905 type_T *prev_type = context->arg_types[context->arg_idx - 1].type_curr;
Bram Moolenaarca174532020-10-21 16:42:22 +0200906 type_T *expected;
907
908 if (prev_type->tt_type == VAR_LIST)
909 expected = prev_type->tt_member;
910 else if (prev_type->tt_type == VAR_BLOB)
911 expected = &t_number;
912 else
913 // probably VAR_ANY, can't check
914 return OK;
915
Bram Moolenaar351ead02021-01-16 16:07:01 +0100916 return check_arg_type(expected, type, context);
Bram Moolenaarca174532020-10-21 16:42:22 +0200917}
918
Bram Moolenaar94738d82020-10-21 14:25:07 +0200919/*
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200920 * Check "type" is a string or a number or a list
921 */
922 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000923arg_str_or_nr_or_list(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200924{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100925 if (type->tt_type == VAR_STRING
Bram Moolenaar59618fe2021-12-21 12:32:17 +0000926 || type->tt_type == VAR_NUMBER
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100927 || type->tt_type == VAR_LIST
928 || type_any_or_unknown(type))
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200929 return OK;
930 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
931 return FAIL;
932}
933
934/*
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200935 * Check "type" is a dict of 'any' or a string
936 */
937 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000938arg_dict_any_or_string(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200939{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100940 if (type->tt_type == VAR_DICT
941 || type->tt_type == VAR_STRING
942 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200943 return OK;
944 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
945 return FAIL;
946}
947
948/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +0200949 * Check "type" which is the third argument of extend() (number or string or
950 * any)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100951 */
952 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000953arg_extend3(type_T *type, type_T *decl_type, argcontext_T *context)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100954{
Bram Moolenaar078a4612022-01-04 15:17:03 +0000955 type_T *first_type = context->arg_types[context->arg_idx - 2].type_curr;
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100956
957 if (first_type->tt_type == VAR_LIST)
Bram Moolenaar078a4612022-01-04 15:17:03 +0000958 return arg_number(type, decl_type, context);
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100959 if (first_type->tt_type == VAR_DICT)
Bram Moolenaar078a4612022-01-04 15:17:03 +0000960 return arg_string(type, decl_type, context);
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100961 return OK;
962}
963
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200964/*
Yegappan Lakshmanana764e732021-07-25 15:57:32 +0200965 * Check "type" which is the first argument of get() (blob or list or dict or
966 * funcref)
967 */
968 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000969arg_get1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana764e732021-07-25 15:57:32 +0200970{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100971 if (type->tt_type == VAR_BLOB
Yegappan Lakshmanana764e732021-07-25 15:57:32 +0200972 || type->tt_type == VAR_LIST
973 || type->tt_type == VAR_DICT
974 || type->tt_type == VAR_FUNC
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100975 || type->tt_type == VAR_PARTIAL
976 || type_any_or_unknown(type))
Yegappan Lakshmanana764e732021-07-25 15:57:32 +0200977 return OK;
978
979 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
980 return FAIL;
981}
982
983/*
984 * Check "type" which is the first argument of len() (number or string or
985 * blob or list or dict)
986 */
987 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000988arg_len1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana764e732021-07-25 15:57:32 +0200989{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100990 if (type->tt_type == VAR_STRING
Yegappan Lakshmanana764e732021-07-25 15:57:32 +0200991 || type->tt_type == VAR_NUMBER
992 || type->tt_type == VAR_BLOB
993 || type->tt_type == VAR_LIST
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100994 || type->tt_type == VAR_DICT
Yegappan Lakshmanand3eae7b2024-03-03 16:26:58 +0100995 || type->tt_type == VAR_OBJECT
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100996 || type_any_or_unknown(type))
Yegappan Lakshmanana764e732021-07-25 15:57:32 +0200997 return OK;
998
999 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
1000 return FAIL;
1001}
1002
1003/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001004 * Check "type" which is the second argument of remove() (number or string or
1005 * any)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001006 */
1007 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001008arg_remove2(type_T *type, type_T *decl_type, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001009{
Bram Moolenaar078a4612022-01-04 15:17:03 +00001010 type_T *first_type = context->arg_types[context->arg_idx - 1].type_curr;
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001011
1012 if (first_type->tt_type == VAR_LIST || first_type->tt_type == VAR_BLOB)
Bram Moolenaar078a4612022-01-04 15:17:03 +00001013 return arg_number(type, decl_type, context);
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001014 if (first_type->tt_type == VAR_DICT)
Bram Moolenaar078a4612022-01-04 15:17:03 +00001015 return arg_string_or_nr(type, decl_type, context);
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001016 return OK;
1017}
1018
1019/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001020 * Check "type" which is the first argument of repeat() (string or number or
1021 * list or any)
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001022 */
1023 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001024arg_repeat1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001025{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001026 if (type->tt_type == VAR_STRING
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001027 || type->tt_type == VAR_NUMBER
Bakudankun375141e2022-09-09 18:46:47 +01001028 || type->tt_type == VAR_BLOB
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001029 || type->tt_type == VAR_LIST
1030 || type_any_or_unknown(type))
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001031 return OK;
1032
1033 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
1034 return FAIL;
1035}
1036
1037/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001038 * Check "type" which is the first argument of slice() (list or blob or string
1039 * or any)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001040 */
1041 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001042arg_slice1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001043{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001044 if (type->tt_type == VAR_LIST
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001045 || type->tt_type == VAR_BLOB
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001046 || type->tt_type == VAR_STRING
1047 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001048 return OK;
1049
1050 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
1051 return FAIL;
1052}
1053
1054/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001055 * Check "type" which is the first argument of count() (string or list or dict
1056 * or any)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001057 */
1058 static int
Bram Moolenaar3e518a82022-08-30 17:45:33 +01001059arg_string_or_list_or_dict(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001060{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001061 if (type->tt_type == VAR_STRING
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001062 || type->tt_type == VAR_LIST
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001063 || type->tt_type == VAR_DICT
1064 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001065 return OK;
1066
Bram Moolenaar3e518a82022-08-30 17:45:33 +01001067 semsg(_(e_string_list_or_dict_required_for_argument_nr),
1068 context->arg_idx + 1);
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001069 return FAIL;
1070}
1071
1072/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001073 * Check "type" which is the first argument of cursor() (number or string or
1074 * list or any)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001075 */
1076 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001077arg_cursor1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001078{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001079 if (type->tt_type == VAR_NUMBER
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001080 || type->tt_type == VAR_STRING
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001081 || type->tt_type == VAR_LIST
1082 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001083 return OK;
1084
1085 arg_type_mismatch(&t_number, type, context->arg_idx + 1);
1086 return FAIL;
1087}
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01001088
1089/*
Bram Moolenaar94738d82020-10-21 14:25:07 +02001090 * Lists of functions that check the argument types of a builtin function.
1091 */
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +02001092static argcheck_T arg1_blob[] = {arg_blob};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001093static argcheck_T arg1_bool[] = {arg_bool};
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001094static argcheck_T arg1_buffer[] = {arg_buffer};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001095static argcheck_T arg1_buffer_or_dict_any[] = {arg_buffer_or_dict_any};
1096static argcheck_T arg1_chan_or_job[] = {arg_chan_or_job};
1097static argcheck_T arg1_dict_any[] = {arg_dict_any};
1098static argcheck_T arg1_dict_or_string[] = {arg_dict_any_or_string};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001099static argcheck_T arg1_float_or_nr[] = {arg_float_or_nr};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001100static argcheck_T arg1_job[] = {arg_job};
1101static argcheck_T arg1_list_any[] = {arg_list_any};
1102static argcheck_T arg1_list_number[] = {arg_list_number};
Yegappan Lakshmananf9dc2782023-05-11 15:02:56 +01001103static argcheck_T arg1_string_or_list_or_blob_mod[] = {arg_string_list_or_blob_mod};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001104static argcheck_T arg1_list_or_dict[] = {arg_list_or_dict};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001105static argcheck_T arg1_list_string[] = {arg_list_string};
Bram Moolenaar3e518a82022-08-30 17:45:33 +01001106static argcheck_T arg1_string_or_list_or_dict[] = {arg_string_or_list_or_dict};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001107static argcheck_T arg1_lnum[] = {arg_lnum};
1108static argcheck_T arg1_number[] = {arg_number};
1109static argcheck_T arg1_string[] = {arg_string};
1110static argcheck_T arg1_string_or_list_any[] = {arg_string_or_list_any};
1111static argcheck_T arg1_string_or_list_string[] = {arg_string_or_list_string};
1112static argcheck_T arg1_string_or_nr[] = {arg_string_or_nr};
Ernie Raela8f7f922023-12-14 20:17:04 +01001113static argcheck_T arg2_any_buffer[] = {arg_any, arg_buffer};
1114static argcheck_T arg2_buffer_any[] = {arg_buffer, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001115static argcheck_T arg2_buffer_bool[] = {arg_buffer, arg_bool};
1116static argcheck_T arg2_buffer_list_any[] = {arg_buffer, arg_list_any};
1117static argcheck_T arg2_buffer_lnum[] = {arg_buffer, arg_lnum};
1118static argcheck_T arg2_buffer_number[] = {arg_buffer, arg_number};
1119static argcheck_T arg2_buffer_string[] = {arg_buffer, arg_string};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001120static argcheck_T arg2_chan_or_job_dict[] = {arg_chan_or_job, arg_dict_any};
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001121static argcheck_T arg2_chan_or_job_string[] = {arg_chan_or_job, arg_string};
Yegappan Lakshmananccfb7c62021-08-16 21:39:09 +02001122static argcheck_T arg2_dict_any_list_any[] = {arg_dict_any, arg_list_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001123static argcheck_T arg2_dict_any_string_or_nr[] = {arg_dict_any, arg_string_or_nr};
1124static argcheck_T arg2_dict_string[] = {arg_dict_any, arg_string};
1125static argcheck_T arg2_float_or_nr[] = {arg_float_or_nr, arg_float_or_nr};
1126static argcheck_T arg2_job_dict[] = {arg_job, arg_dict_any};
1127static argcheck_T arg2_job_string_or_number[] = {arg_job, arg_string_or_nr};
1128static argcheck_T arg2_list_any_number[] = {arg_list_any, arg_number};
1129static argcheck_T arg2_list_any_string[] = {arg_list_any, arg_string};
1130static argcheck_T arg2_list_number[] = {arg_list_number, arg_list_number};
1131static argcheck_T arg2_list_number_bool[] = {arg_list_number, arg_bool};
Bram Moolenaarfa103972022-09-29 19:14:42 +01001132static argcheck_T arg2_listblobmod_item[] = {arg_list_or_blob_mod, arg_item_of_prev};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001133static argcheck_T arg2_lnum[] = {arg_lnum, arg_lnum};
1134static argcheck_T arg2_lnum_number[] = {arg_lnum, arg_number};
1135static argcheck_T arg2_number[] = {arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001136static argcheck_T arg2_number_any[] = {arg_number, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001137static argcheck_T arg2_number_bool[] = {arg_number, arg_bool};
1138static argcheck_T arg2_number_dict_any[] = {arg_number, arg_dict_any};
1139static argcheck_T arg2_number_list[] = {arg_number, arg_list_any};
1140static argcheck_T arg2_number_string[] = {arg_number, arg_string};
Christian Brabandtfbc37f12024-06-18 20:50:58 +02001141static argcheck_T arg2_number_buffer[] = {arg_number, arg_buffer};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001142static argcheck_T arg2_number_string_or_list[] = {arg_number, arg_string_or_list_any};
1143static argcheck_T arg2_str_or_nr_or_list_dict[] = {arg_str_or_nr_or_list, arg_dict_any};
1144static argcheck_T arg2_string[] = {arg_string, arg_string};
Ernie Raela8f7f922023-12-14 20:17:04 +01001145static argcheck_T arg2_string_any[] = {arg_string, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001146static argcheck_T arg2_string_bool[] = {arg_string, arg_bool};
1147static argcheck_T arg2_string_chan_or_job[] = {arg_string, arg_chan_or_job};
1148static argcheck_T arg2_string_dict[] = {arg_string, arg_dict_any};
1149static argcheck_T arg2_string_list_number[] = {arg_string, arg_list_number};
1150static argcheck_T arg2_string_number[] = {arg_string, arg_number};
1151static argcheck_T arg2_string_or_list_dict[] = {arg_string_or_list_any, arg_dict_any};
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00001152static argcheck_T arg2_string_or_list_number[] = {arg_string_or_list_any, arg_number};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001153static argcheck_T arg2_string_string_or_number[] = {arg_string, arg_string_or_nr};
Ernie Raela8f7f922023-12-14 20:17:04 +01001154static argcheck_T arg3_any_list_dict[] = {arg_any, arg_list_any, arg_dict_any};
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001155static argcheck_T arg3_buffer_lnum_lnum[] = {arg_buffer, arg_lnum, arg_lnum};
1156static argcheck_T arg3_buffer_number_number[] = {arg_buffer, arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001157static argcheck_T arg3_buffer_string_any[] = {arg_buffer, arg_string, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001158static argcheck_T arg3_buffer_string_dict[] = {arg_buffer, arg_string, arg_dict_any};
1159static argcheck_T arg3_dict_number_number[] = {arg_dict_any, arg_number, arg_number};
Yegappan Lakshmananfa378352024-02-01 22:05:27 +01001160static argcheck_T arg3_diff[] = {arg_list_string, arg_list_string, arg_dict_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001161static argcheck_T arg3_list_string_dict[] = {arg_list_any, arg_string, arg_dict_any};
Shougo Matsushita19b71882024-02-28 22:48:12 +01001162static argcheck_T arg3_list_list_dict[] = {arg_list_any, arg_list_any, arg_dict_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001163static argcheck_T arg3_lnum_number_bool[] = {arg_lnum, arg_number, arg_bool};
1164static argcheck_T arg3_number[] = {arg_number, arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001165static argcheck_T arg3_number_any_dict[] = {arg_number, arg_any, arg_dict_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001166static argcheck_T arg3_number_number_dict[] = {arg_number, arg_number, arg_dict_any};
Ernie Raela8f7f922023-12-14 20:17:04 +01001167static argcheck_T arg3_number_string_any[] = {arg_number, arg_string, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001168static argcheck_T arg3_number_string_buffer[] = {arg_number, arg_string, arg_buffer};
1169static argcheck_T arg3_number_string_string[] = {arg_number, arg_string, arg_string};
1170static argcheck_T arg3_string[] = {arg_string, arg_string, arg_string};
Ernie Raela8f7f922023-12-14 20:17:04 +01001171static argcheck_T arg3_string_any_dict[] = {arg_string, arg_any, arg_dict_any};
1172static argcheck_T arg3_string_any_string[] = {arg_string, arg_any, arg_string};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001173static argcheck_T arg3_string_bool_bool[] = {arg_string, arg_bool, arg_bool};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001174static argcheck_T arg3_string_number_bool[] = {arg_string, arg_number, arg_bool};
K.Takata11df3ae2022-10-19 14:02:40 +01001175static argcheck_T arg3_string_number_number[] = {arg_string, arg_number, arg_number};
Ernie Rael51d04d12022-05-04 15:40:22 +01001176static argcheck_T arg3_string_or_dict_bool_dict[] = {arg_string_or_dict_any, arg_bool, arg_dict_any};
zeertzjq825cf812023-08-17 22:55:25 +02001177static argcheck_T arg3_string_or_list_bool_number[] = {arg_string_or_list_any, arg_bool, arg_number};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001178static argcheck_T arg3_string_string_bool[] = {arg_string, arg_string, arg_bool};
1179static argcheck_T arg3_string_string_dict[] = {arg_string, arg_string, arg_dict_any};
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02001180static argcheck_T arg3_string_string_number[] = {arg_string, arg_string, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001181static argcheck_T arg4_number_number_string_any[] = {arg_number, arg_number, arg_string, arg_any};
1182static argcheck_T arg4_string_string_any_string[] = {arg_string, arg_string, arg_any, arg_string};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001183static argcheck_T arg4_string_string_number_string[] = {arg_string, arg_string, arg_number, arg_string};
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01001184static argcheck_T arg4_string_number_bool_bool[] = {arg_string, arg_number, arg_bool, arg_bool};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001185/* Function specific argument types (not covered by the above) */
Ernie Raela8f7f922023-12-14 20:17:04 +01001186static argcheck_T arg15_assert_fails[] = {arg_string_or_nr, arg_string_or_list_any, arg_any, arg_number, arg_string};
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001187static argcheck_T arg34_assert_inrange[] = {arg_float_or_nr, arg_float_or_nr, arg_float_or_nr, arg_string};
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001188static argcheck_T arg4_browse[] = {arg_bool, arg_string, arg_string, arg_string};
Ernie Raela8f7f922023-12-14 20:17:04 +01001189static argcheck_T arg23_chanexpr[] = {arg_chan_or_job, arg_any, arg_dict_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001190static argcheck_T arg23_chanraw[] = {arg_chan_or_job, arg_string_or_blob, arg_dict_any};
Ernie Raela8f7f922023-12-14 20:17:04 +01001191static argcheck_T arg24_count[] = {arg_string_or_list_or_dict, arg_any, arg_bool, arg_number};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001192static argcheck_T arg13_cursor[] = {arg_cursor1, arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001193static argcheck_T arg12_deepcopy[] = {arg_any, arg_bool};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001194static argcheck_T arg12_execute[] = {arg_string_or_list_string, arg_string};
Bram Moolenaarfa103972022-09-29 19:14:42 +01001195static argcheck_T arg23_extend[] = {arg_list_or_dict_mod, arg_same_as_prev, arg_extend3};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001196static argcheck_T arg23_extendnew[] = {arg_list_or_dict, arg_same_struct_as_prev, arg_extend3};
Ernie Raela8f7f922023-12-14 20:17:04 +01001197static argcheck_T arg23_get[] = {arg_get1, arg_string_or_nr, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001198static argcheck_T arg14_glob[] = {arg_string, arg_bool, arg_bool, arg_bool};
1199static argcheck_T arg25_globpath[] = {arg_string, arg_string, arg_bool, arg_bool, arg_bool};
1200static argcheck_T arg24_index[] = {arg_list_or_blob, arg_item_of_prev, arg_number, arg_bool};
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01001201static argcheck_T arg23_index[] = {arg_list_or_blob, arg_filter_func, arg_dict_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001202static argcheck_T arg23_insert[] = {arg_list_or_blob, arg_item_of_prev, arg_number};
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001203static argcheck_T arg1_len[] = {arg_len1};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001204static argcheck_T arg3_libcall[] = {arg_string, arg_string, arg_string_or_nr};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001205static argcheck_T arg14_maparg[] = {arg_string, arg_string, arg_bool, arg_bool};
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001206static argcheck_T arg2_filter[] = {arg_list_or_dict_or_blob_or_string_mod, arg_filter_func};
Ernie Raele79e2072024-01-13 11:47:33 +01001207static argcheck_T arg2_foreach[] = {arg_list_or_dict_or_blob_or_string, arg_foreach_func};
Ernie Rael2025af12023-12-12 16:58:00 +01001208static argcheck_T arg2_instanceof[] = {arg_object, varargs_class, NULL };
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001209static argcheck_T arg2_map[] = {arg_list_or_dict_or_blob_or_string_mod, arg_map_func};
Ernie Raela8f7f922023-12-14 20:17:04 +01001210static argcheck_T arg2_mapnew[] = {arg_list_or_dict_or_blob_or_string, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001211static argcheck_T arg25_matchadd[] = {arg_string, arg_string, arg_number, arg_number, arg_dict_any};
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001212static argcheck_T arg25_matchaddpos[] = {arg_string, arg_list_any, arg_number, arg_number, arg_dict_any};
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01001213static argcheck_T arg23_matchstrlist[] = {arg_list_string, arg_string, arg_dict_any};
1214static argcheck_T arg45_matchbufline[] = {arg_buffer, arg_string, arg_lnum, arg_lnum, arg_dict_any};
Ernie Raela8f7f922023-12-14 20:17:04 +01001215static argcheck_T arg119_printf[] = {arg_string_or_nr, arg_any, arg_any, arg_any, arg_any, arg_any, arg_any, arg_any, arg_any, arg_any, arg_any, arg_any, arg_any, arg_any, arg_any, arg_any, arg_any, arg_any, arg_any};
1216static argcheck_T arg23_reduce[] = {arg_string_list_or_blob, arg_any, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001217static argcheck_T arg24_remote_expr[] = {arg_string, arg_string, arg_string, arg_number};
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001218static argcheck_T arg23_remove[] = {arg_list_or_dict_or_blob_mod, arg_remove2, arg_number};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001219static argcheck_T arg2_repeat[] = {arg_repeat1, arg_number};
Bram Moolenaar73199812021-12-26 17:18:14 +00001220static argcheck_T arg15_search[] = {arg_string, arg_string, arg_number, arg_number, arg_string_or_func};
1221static argcheck_T arg37_searchpair[] = {arg_string, arg_string, arg_string, arg_string, arg_string_or_func, arg_number, arg_number};
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001222static argcheck_T arg3_setbufline[] = {arg_buffer, arg_lnum, arg_str_or_nr_or_list};
Ernie Raela8f7f922023-12-14 20:17:04 +01001223static argcheck_T arg2_setline[] = {arg_lnum, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001224static argcheck_T arg24_setloclist[] = {arg_number, arg_list_any, arg_string, arg_dict_any};
1225static argcheck_T arg13_setqflist[] = {arg_list_any, arg_string, arg_dict_any};
1226static argcheck_T arg23_settagstack[] = {arg_number, arg_dict_any, arg_string};
1227static argcheck_T arg02_sign_getplaced[] = {arg_buffer, arg_dict_any};
1228static argcheck_T arg45_sign_place[] = {arg_number, arg_string, arg_string, arg_buffer, arg_dict_any};
1229static argcheck_T arg23_slice[] = {arg_slice1, arg_number, arg_number};
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001230static argcheck_T arg13_sortuniq[] = {arg_list_any_mod, arg_sort_how, arg_dict_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001231static argcheck_T arg24_strpart[] = {arg_string, arg_number, arg_number, arg_bool};
1232static argcheck_T arg12_system[] = {arg_string, arg_str_or_nr_or_list};
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02001233static argcheck_T arg23_win_execute[] = {arg_number, arg_string_or_list_string, arg_string};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001234static argcheck_T arg23_writefile[] = {arg_list_or_blob, arg_string, arg_string};
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02001235static argcheck_T arg24_match_func[] = {arg_string_or_list_any, arg_string, arg_number, arg_number};
Bram Moolenaarcd268012021-07-22 19:11:08 +02001236
Bram Moolenaar32517c42023-01-15 18:17:12 +00001237// Can be used by functions called through "f_retfunc" to create new types.
1238static garray_T *current_type_gap = NULL;
Bram Moolenaar94738d82020-10-21 14:25:07 +02001239
1240/*
1241 * Functions that return the return type of a builtin function.
Bram Moolenaara1224cb2020-10-22 12:31:49 +02001242 * Note that "argtypes" is NULL if "argcount" is zero.
Bram Moolenaar94738d82020-10-21 14:25:07 +02001243 */
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001244 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001245ret_void(int argcount UNUSED,
1246 type2_T *argtypes UNUSED,
1247 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001248{
1249 return &t_void;
1250}
1251 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001252ret_any(int argcount UNUSED,
1253 type2_T *argtypes UNUSED,
1254 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001255{
1256 return &t_any;
1257}
1258 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001259ret_bool(int argcount UNUSED,
1260 type2_T *argtypes UNUSED,
1261 type_T **decl_type UNUSED)
Bram Moolenaar403dc312020-10-17 19:29:51 +02001262{
1263 return &t_bool;
1264}
1265 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001266ret_number_bool(int argcount UNUSED,
1267 type2_T *argtypes UNUSED,
1268 type_T **decl_type UNUSED)
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001269{
1270 return &t_number_bool;
1271}
1272 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001273ret_number(int argcount UNUSED,
1274 type2_T *argtypes UNUSED,
1275 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001276{
1277 return &t_number;
1278}
1279 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001280ret_float(int argcount UNUSED,
1281 type2_T *argtypes UNUSED,
1282 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001283{
1284 return &t_float;
1285}
1286 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001287ret_string(int argcount UNUSED,
1288 type2_T *argtypes UNUSED,
1289 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001290{
1291 return &t_string;
1292}
Bram Moolenaare69f6d02020-04-01 22:11:01 +02001293 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001294ret_list_any(int argcount UNUSED,
1295 type2_T *argtypes UNUSED,
1296 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001297{
1298 return &t_list_any;
1299}
1300 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001301ret_list_number(int argcount UNUSED,
1302 type2_T *argtypes UNUSED,
Bram Moolenaar81330182022-02-01 12:11:58 +00001303 type_T **decl_type)
1304{
Bram Moolenaar81330182022-02-01 12:11:58 +00001305 *decl_type = &t_list_any;
1306 return &t_list_number;
1307}
1308 static type_T *
1309ret_list_string(int argcount UNUSED,
1310 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001311 type_T **decl_type)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001312{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001313 *decl_type = &t_list_any;
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001314 return &t_list_string;
1315}
1316 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001317ret_list_dict_any(int argcount UNUSED,
1318 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001319 type_T **decl_type)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001320{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001321 *decl_type = &t_list_any;
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001322 return &t_list_dict_any;
1323}
1324 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001325ret_list_items(int argcount UNUSED,
1326 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001327 type_T **decl_type)
Bram Moolenaarefc5db52021-07-07 21:21:30 +02001328{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001329 *decl_type = &t_list_any;
Bram Moolenaarefc5db52021-07-07 21:21:30 +02001330 return &t_list_list_any;
1331}
mityu61065042021-07-19 20:07:21 +02001332 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001333ret_list_string_items(int argcount UNUSED,
1334 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001335 type_T **decl_type)
mityu61065042021-07-19 20:07:21 +02001336{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001337 *decl_type = &t_list_any;
mityu61065042021-07-19 20:07:21 +02001338 return &t_list_list_string;
1339}
Bram Moolenaarefc5db52021-07-07 21:21:30 +02001340 static type_T *
zeertzjqd4d12072024-07-16 20:34:16 +02001341ret_list_regionpos(int argcount UNUSED,
1342 type2_T *argtypes UNUSED,
1343 type_T **decl_type)
1344{
1345 *decl_type = &t_list_any;
1346 return &t_list_list_list_number;
1347}
1348 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001349ret_dict_any(int argcount UNUSED,
1350 type2_T *argtypes UNUSED,
1351 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001352{
1353 return &t_dict_any;
1354}
1355 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001356ret_job_info(int argcount,
1357 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001358 type_T **decl_type)
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01001359{
1360 if (argcount == 0)
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001361 {
1362 *decl_type = &t_list_any;
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01001363 return &t_list_job;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001364 }
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01001365 return &t_dict_any;
1366}
1367 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001368ret_dict_number(int argcount UNUSED,
1369 type2_T *argtypes UNUSED,
1370 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001371{
1372 return &t_dict_number;
1373}
1374 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001375ret_dict_string(int argcount UNUSED,
1376 type2_T *argtypes UNUSED,
1377 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001378{
1379 return &t_dict_string;
1380}
1381 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001382ret_blob(int argcount UNUSED,
1383 type2_T *argtypes UNUSED,
1384 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001385{
1386 return &t_blob;
1387}
1388 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001389ret_func_any(int argcount UNUSED,
1390 type2_T *argtypes UNUSED,
1391 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001392{
Bram Moolenaare69f6d02020-04-01 22:11:01 +02001393 return &t_func_any;
1394}
1395 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001396ret_func_unknown(int argcount UNUSED,
1397 type2_T *argtypes UNUSED,
1398 type_T **decl_type UNUSED)
Bram Moolenaar2f9f4cc2021-12-20 09:36:27 +00001399{
1400 return &t_func_unknown;
1401}
1402 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001403ret_channel(int argcount UNUSED,
1404 type2_T *argtypes UNUSED,
1405 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001406{
1407 return &t_channel;
1408}
1409 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001410ret_job(int argcount UNUSED,
1411 type2_T *argtypes UNUSED,
1412 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001413{
1414 return &t_job;
1415}
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001416 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001417ret_first_arg(int argcount,
1418 type2_T *argtypes,
1419 type_T **decl_type)
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001420{
1421 if (argcount > 0)
Bram Moolenaar81330182022-02-01 12:11:58 +00001422 {
1423 *decl_type = argtypes[0].type_decl;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001424 return argtypes[0].type_curr;
Bram Moolenaar81330182022-02-01 12:11:58 +00001425 }
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001426 return &t_void;
1427}
Bram Moolenaar1780f082021-07-31 22:03:59 +02001428 static type_T *
Bram Moolenaar00eb9952022-02-05 19:23:18 +00001429ret_slice(int argcount,
1430 type2_T *argtypes,
1431 type_T **decl_type)
1432{
1433 if (argcount > 0)
1434 {
1435 if (argtypes[0].type_decl != NULL)
1436 {
1437 switch (argtypes[0].type_decl->tt_type)
1438 {
1439 case VAR_STRING: *decl_type = &t_string; break;
1440 case VAR_BLOB: *decl_type = &t_blob; break;
1441 case VAR_LIST: *decl_type = &t_list_any; break;
1442 default: break;
1443 }
1444 }
1445 return argtypes[0].type_curr;
1446 }
1447 return &t_void;
1448}
1449 static type_T *
Bram Moolenaar381692b2022-02-02 20:01:27 +00001450ret_copy(int argcount,
1451 type2_T *argtypes,
1452 type_T **decl_type)
1453{
1454 if (argcount > 0)
1455 {
1456 if (argtypes[0].type_decl != NULL)
1457 {
1458 if (argtypes[0].type_decl->tt_type == VAR_LIST)
1459 *decl_type = &t_list_any;
1460 else if (argtypes[0].type_decl->tt_type == VAR_DICT)
1461 *decl_type = &t_dict_any;
1462 else
1463 *decl_type = argtypes[0].type_decl;
1464 }
1465 if (argtypes[0].type_curr != NULL)
1466 {
1467 if (argtypes[0].type_curr->tt_type == VAR_LIST)
1468 return &t_list_any;
1469 else if (argtypes[0].type_curr->tt_type == VAR_DICT)
1470 return &t_dict_any;
1471 }
1472 return argtypes[0].type_curr;
1473 }
1474 return &t_void;
1475}
1476 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001477ret_extend(int argcount,
1478 type2_T *argtypes,
1479 type_T **decl_type)
1480{
1481 if (argcount > 0)
1482 {
1483 *decl_type = argtypes[0].type_decl;
1484 // if the second argument has a different current type then the current
1485 // type is "any"
1486 if (argcount > 1 && !equal_type(argtypes[0].type_curr,
1487 argtypes[1].type_curr, 0))
1488 {
1489 if (argtypes[0].type_curr->tt_type == VAR_LIST)
1490 return &t_list_any;
1491 if (argtypes[0].type_curr->tt_type == VAR_DICT)
1492 return &t_dict_any;
1493 }
1494 return argtypes[0].type_curr;
1495 }
1496 return &t_void;
1497}
1498 static type_T *
1499ret_repeat(int argcount,
1500 type2_T *argtypes,
1501 type_T **decl_type UNUSED)
Bram Moolenaar1780f082021-07-31 22:03:59 +02001502{
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001503 if (argcount == 0)
1504 return &t_any;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001505 if (argtypes[0].type_curr == &t_number)
Bram Moolenaar1780f082021-07-31 22:03:59 +02001506 return &t_string;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001507 return argtypes[0].type_curr;
Bram Moolenaar1780f082021-07-31 22:03:59 +02001508}
Bram Moolenaarea696852020-11-09 18:31:39 +01001509// for map(): returns first argument but item type may differ
1510 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001511ret_first_cont(int argcount,
1512 type2_T *argtypes,
1513 type_T **decl_type UNUSED)
Bram Moolenaarea696852020-11-09 18:31:39 +01001514{
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001515 if (argcount > 0)
1516 {
Bram Moolenaar078a4612022-01-04 15:17:03 +00001517 if (argtypes[0].type_curr->tt_type == VAR_LIST)
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001518 return &t_list_any;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001519 if (argtypes[0].type_curr->tt_type == VAR_DICT)
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001520 return &t_dict_any;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001521 if (argtypes[0].type_curr->tt_type == VAR_BLOB)
1522 return argtypes[0].type_curr;
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001523 }
Bram Moolenaarea696852020-11-09 18:31:39 +01001524 return &t_any;
1525}
Bram Moolenaar078a4612022-01-04 15:17:03 +00001526// for getline()
1527 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001528ret_getline(int argcount,
1529 type2_T *argtypes UNUSED,
1530 type_T **decl_type UNUSED)
Bram Moolenaar078a4612022-01-04 15:17:03 +00001531{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001532 if (argcount == 1)
1533 return &t_string;
1534 *decl_type = &t_list_any;
1535 return &t_list_string;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001536}
Bram Moolenaar08018222021-12-22 18:45:37 +00001537// for finddir()
1538 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001539ret_finddir(int argcount,
1540 type2_T *argtypes UNUSED,
1541 type_T **decl_type UNUSED)
Bram Moolenaar08018222021-12-22 18:45:37 +00001542{
1543 if (argcount < 3)
1544 return &t_string;
1545 // Depending on the count would be a string or a list of strings.
1546 return &t_any;
1547}
Bram Moolenaar32517c42023-01-15 18:17:12 +00001548// for values(): list of member of first argument
1549 static type_T *
1550ret_list_member(int argcount,
1551 type2_T *argtypes,
1552 type_T **decl_type)
1553{
1554 if (argcount > 0)
1555 {
1556 type_T *t = argtypes[0].type_decl;
1557 if (current_type_gap != NULL
1558 && (t->tt_type == VAR_DICT || t->tt_type == VAR_LIST))
1559 t = get_list_type(t->tt_member, current_type_gap);
1560 else
1561 t = &t_list_any;
1562 *decl_type = t;
1563
1564 t = argtypes[0].type_curr;
1565 if (current_type_gap != NULL
1566 && (t->tt_type == VAR_DICT || t->tt_type == VAR_LIST))
1567 return get_list_type(t->tt_member, current_type_gap);
1568 }
1569 return &t_list_any;
1570}
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001571
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001572/*
1573 * Used for getqflist(): returns list if there is no argument, dict if there is
1574 * one.
1575 */
1576 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001577ret_list_or_dict_0(int argcount,
1578 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001579 type_T **decl_type)
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001580{
1581 if (argcount > 0)
1582 return &t_dict_any;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001583 *decl_type = &t_list_any;
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001584 return &t_list_dict_any;
1585}
1586
1587/*
1588 * Used for getloclist(): returns list if there is one argument, dict if there
1589 * are two.
1590 */
1591 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001592ret_list_or_dict_1(int argcount,
1593 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001594 type_T **decl_type)
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001595{
1596 if (argcount > 1)
1597 return &t_dict_any;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001598 *decl_type = &t_list_any;
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001599 return &t_list_dict_any;
1600}
1601
Bram Moolenaar846178a2020-07-05 17:04:13 +02001602 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001603ret_argv(int argcount,
1604 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001605 type_T **decl_type)
Bram Moolenaar846178a2020-07-05 17:04:13 +02001606{
1607 // argv() returns list of strings
1608 if (argcount == 0)
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001609 {
1610 *decl_type = &t_list_any;
Bram Moolenaar846178a2020-07-05 17:04:13 +02001611 return &t_list_string;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001612 }
Bram Moolenaar846178a2020-07-05 17:04:13 +02001613
1614 // argv(0) returns a string, but argv(-1] returns a list
1615 return &t_any;
1616}
1617
Bram Moolenaarad7c2492020-07-05 20:55:29 +02001618 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001619ret_remove(int argcount,
1620 type2_T *argtypes,
Bram Moolenaar2ac037f2022-05-09 14:12:14 +01001621 type_T **decl_type)
Bram Moolenaarad7c2492020-07-05 20:55:29 +02001622{
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001623 if (argcount > 0)
Bram Moolenaar5e654232020-09-16 15:22:00 +02001624 {
Bram Moolenaar078a4612022-01-04 15:17:03 +00001625 if (argtypes[0].type_curr->tt_type == VAR_LIST
1626 || argtypes[0].type_curr->tt_type == VAR_DICT)
Bram Moolenaar81330182022-02-01 12:11:58 +00001627 {
Bram Moolenaar2ac037f2022-05-09 14:12:14 +01001628 if (argcount == 3)
1629 {
1630 *decl_type = argtypes[0].type_decl;
1631 return argtypes[0].type_curr;
1632 }
Bram Moolenaar81330182022-02-01 12:11:58 +00001633 if (argtypes[0].type_curr->tt_type
1634 == argtypes[0].type_decl->tt_type)
1635 *decl_type = argtypes[0].type_decl->tt_member;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001636 return argtypes[0].type_curr->tt_member;
Bram Moolenaar81330182022-02-01 12:11:58 +00001637 }
Bram Moolenaar078a4612022-01-04 15:17:03 +00001638 if (argtypes[0].type_curr->tt_type == VAR_BLOB)
Bram Moolenaar5e654232020-09-16 15:22:00 +02001639 return &t_number;
1640 }
Bram Moolenaarad7c2492020-07-05 20:55:29 +02001641 return &t_any;
1642}
1643
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001644 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001645ret_getreg(int argcount,
1646 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001647 type_T **decl_type)
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001648{
1649 // Assume that if the third argument is passed it's non-zero
1650 if (argcount == 3)
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001651 {
1652 *decl_type = &t_list_any;
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001653 return &t_list_string;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001654 }
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001655 return &t_string;
1656}
1657
Bram Moolenaar4a6d1b62020-08-08 17:55:49 +02001658 static type_T *
LemonBoy0f7a3e12022-05-26 12:10:37 +01001659ret_virtcol(int argcount,
1660 type2_T *argtypes UNUSED,
1661 type_T **decl_type)
1662{
1663 // Assume that if the second argument is passed it's non-zero
zeertzjq825cf812023-08-17 22:55:25 +02001664 if (argcount > 1)
LemonBoy0f7a3e12022-05-26 12:10:37 +01001665 {
1666 *decl_type = &t_list_any;
1667 return &t_list_number;
1668 }
1669 return &t_number;
1670}
1671
1672 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001673ret_maparg(int argcount,
1674 type2_T *argtypes UNUSED,
1675 type_T **decl_type UNUSED)
Bram Moolenaar4a6d1b62020-08-08 17:55:49 +02001676{
1677 // Assume that if the fourth argument is passed it's non-zero
1678 if (argcount == 4)
1679 return &t_dict_any;
1680 return &t_string;
1681}
1682
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001683/*
1684 * Array with names and number of arguments of all internal functions
1685 * MUST BE KEPT SORTED IN strcmp() ORDER FOR BINARY SEARCH!
Ernie Rael2025af12023-12-12 16:58:00 +01001686 *
Ernie Raela8f7f922023-12-14 20:17:04 +01001687 * The builtin function may be varargs. In that case
Ernie Rael2025af12023-12-12 16:58:00 +01001688 * - f_max_argc == VARGS
Ernie Raela8f7f922023-12-14 20:17:04 +01001689 * - For varargs, f_argcheck must be NULL terminated. The last non-null
1690 * entry in f_argcheck should validate all the remaining args.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001691 */
Bram Moolenaarac92e252019-08-03 21:58:38 +02001692typedef struct
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001693{
Bram Moolenaar25e42232019-08-04 15:04:10 +02001694 char *f_name; // function name
1695 char f_min_argc; // minimal number of arguments
1696 char f_max_argc; // maximal number of arguments
Ernie Raeld8bf87c2023-12-16 14:03:33 +01001697 char f_argtype; // for method: FEARG_ values; bits FE_
Ernie Raela8f7f922023-12-14 20:17:04 +01001698 argcheck_T *f_argcheck; // list of functions to check argument types;
1699 // use "arg_any" (not NULL) to accept an
1700 // argument of any type
Bram Moolenaar81330182022-02-01 12:11:58 +00001701 type_T *(*f_retfunc)(int argcount, type2_T *argtypes,
1702 type_T **decl_type);
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001703 // return type function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001704 void (*f_func)(typval_T *args, typval_T *rvar);
Bram Moolenaar25e42232019-08-04 15:04:10 +02001705 // implementation of function
Bram Moolenaarac92e252019-08-03 21:58:38 +02001706} funcentry_T;
1707
Ernie Rael2025af12023-12-12 16:58:00 +01001708// Set f_max_argc to VARGS for varargs.
1709#define VARGS CHAR_MAX
1710
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02001711// values for f_argtype; zero means it cannot be used as a method
Ernie Raeld8bf87c2023-12-16 14:03:33 +01001712#define FEARG_1 0x01 // base is the first argument
1713#define FEARG_2 0x02 // base is the second argument
1714#define FEARG_3 0x03 // base is the third argument
1715#define FEARG_4 0x04 // base is the fourth argument
1716#define FEARG_MASK 0x0F // bits in f_argtype used as argument index
1717#define FE_X 0x10 // builtin accepts a non-value (class, typealias)
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02001718
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001719#if defined(HAVE_MATH_H)
Bram Moolenaar15c47602020-03-26 22:16:48 +01001720# define MATH_FUNC(name) name
1721#else
1722# define MATH_FUNC(name) NULL
1723#endif
1724#ifdef FEAT_TIMERS
1725# define TIMER_FUNC(name) name
1726#else
1727# define TIMER_FUNC(name) NULL
1728#endif
1729#ifdef FEAT_JOB_CHANNEL
1730# define JOB_FUNC(name) name
1731#else
1732# define JOB_FUNC(name) NULL
1733#endif
1734#ifdef FEAT_PROP_POPUP
1735# define PROP_FUNC(name) name
1736#else
1737# define PROP_FUNC(name) NULL
1738#endif
1739#ifdef FEAT_SIGNS
1740# define SIGN_FUNC(name) name
1741#else
1742# define SIGN_FUNC(name) NULL
1743#endif
1744#ifdef FEAT_SOUND
1745# define SOUND_FUNC(name) name
1746#else
1747# define SOUND_FUNC(name) NULL
1748#endif
1749#ifdef FEAT_TERMINAL
1750# define TERM_FUNC(name) name
1751#else
1752# define TERM_FUNC(name) NULL
1753#endif
1754
Bram Moolenaarac92e252019-08-03 21:58:38 +02001755static funcentry_T global_functions[] =
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001756{
Bram Moolenaar94738d82020-10-21 14:25:07 +02001757 {"abs", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001758 ret_any, f_abs},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001759 {"acos", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001760 ret_float, f_acos},
Bram Moolenaarfa103972022-09-29 19:14:42 +01001761 {"add", 2, 2, FEARG_1, arg2_listblobmod_item,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001762 ret_first_arg, f_add},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001763 {"and", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001764 ret_number, f_and},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001765 {"append", 2, 2, FEARG_2, arg2_setline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001766 ret_number_bool, f_append},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001767 {"appendbufline", 3, 3, FEARG_3, arg3_setbufline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001768 ret_number_bool, f_appendbufline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001769 {"argc", 0, 1, 0, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001770 ret_number, f_argc},
1771 {"argidx", 0, 0, 0, NULL,
1772 ret_number, f_argidx},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001773 {"arglistid", 0, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001774 ret_number, f_arglistid},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001775 {"argv", 0, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001776 ret_argv, f_argv},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001777 {"asin", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001778 ret_float, f_asin},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001779 {"assert_beeps", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001780 ret_number_bool, f_assert_beeps},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001781 {"assert_equal", 2, 3, FEARG_2, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001782 ret_number_bool, f_assert_equal},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001783 {"assert_equalfile", 2, 3, FEARG_1, arg3_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001784 ret_number_bool, f_assert_equalfile},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001785 {"assert_exception", 1, 2, 0, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001786 ret_number_bool, f_assert_exception},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001787 {"assert_fails", 1, 5, FEARG_1, arg15_assert_fails,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001788 ret_number_bool, f_assert_fails},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001789 {"assert_false", 1, 2, FEARG_1, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001790 ret_number_bool, f_assert_false},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001791 {"assert_inrange", 3, 4, FEARG_3, arg34_assert_inrange,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001792 ret_number_bool, f_assert_inrange},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001793 {"assert_match", 2, 3, FEARG_2, arg3_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001794 ret_number_bool, f_assert_match},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001795 {"assert_nobeep", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar5b8cabf2021-04-02 18:55:57 +02001796 ret_number_bool, f_assert_nobeep},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001797 {"assert_notequal", 2, 3, FEARG_2, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001798 ret_number_bool, f_assert_notequal},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001799 {"assert_notmatch", 2, 3, FEARG_2, arg3_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001800 ret_number_bool, f_assert_notmatch},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02001801 {"assert_report", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001802 ret_number_bool, f_assert_report},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001803 {"assert_true", 1, 2, FEARG_1, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001804 ret_number_bool, f_assert_true},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001805 {"atan", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001806 ret_float, f_atan},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001807 {"atan2", 2, 2, FEARG_1, arg2_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001808 ret_float, f_atan2},
Yegappan Lakshmanan1755a912022-05-19 10:31:47 +01001809 {"autocmd_add", 1, 1, FEARG_1, arg1_list_any,
1810 ret_number_bool, f_autocmd_add},
1811 {"autocmd_delete", 1, 1, FEARG_1, arg1_list_any,
1812 ret_number_bool, f_autocmd_delete},
1813 {"autocmd_get", 0, 1, FEARG_1, arg1_dict_any,
1814 ret_list_dict_any, f_autocmd_get},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001815 {"balloon_gettext", 0, 0, 0, NULL,
1816 ret_string,
Bram Moolenaar59716a22017-03-01 20:32:44 +01001817#ifdef FEAT_BEVAL
Bram Moolenaar15c47602020-03-26 22:16:48 +01001818 f_balloon_gettext
1819#else
1820 NULL
Bram Moolenaar59716a22017-03-01 20:32:44 +01001821#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01001822 },
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02001823 {"balloon_show", 1, 1, FEARG_1, arg1_string_or_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001824 ret_void,
Bram Moolenaar15c47602020-03-26 22:16:48 +01001825#ifdef FEAT_BEVAL
1826 f_balloon_show
1827#else
1828 NULL
1829#endif
1830 },
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001831 {"balloon_split", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001832 ret_list_string,
Bram Moolenaar15c47602020-03-26 22:16:48 +01001833#if defined(FEAT_BEVAL_TERM)
1834 f_balloon_split
1835#else
1836 NULL
1837#endif
1838 },
Yegappan Lakshmanan810785c2024-12-30 10:29:44 +01001839 {"base64_decode", 1, 1, FEARG_1, arg1_string,
1840 ret_blob, f_base64_decode},
1841 {"base64_encode", 1, 1, FEARG_1, arg1_blob,
1842 ret_string, f_base64_encode},
Christ van Willegence0ef912024-06-20 23:41:59 +02001843 {"bindtextdomain", 2, 2, 0, arg2_string,
Christ van Willegen8252ef12024-07-11 21:36:21 +02001844 ret_bool, f_bindtextdomain},
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +02001845 {"blob2list", 1, 1, FEARG_1, arg1_blob,
1846 ret_list_number, f_blob2list},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001847 {"browse", 4, 4, 0, arg4_browse,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001848 ret_string, f_browse},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001849 {"browsedir", 2, 2, 0, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001850 ret_string, f_browsedir},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001851 {"bufadd", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001852 ret_number, f_bufadd},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001853 {"bufexists", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001854 ret_number_bool, f_bufexists},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001855 {"buffer_exists", 1, 1, FEARG_1, arg1_buffer, // obsolete
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001856 ret_number_bool, f_bufexists},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001857 {"buffer_name", 0, 1, FEARG_1, arg1_buffer, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02001858 ret_string, f_bufname},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001859 {"buffer_number", 0, 1, FEARG_1, arg1_buffer, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02001860 ret_number, f_bufnr},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001861 {"buflisted", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001862 ret_number_bool, f_buflisted},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001863 {"bufload", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001864 ret_void, f_bufload},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001865 {"bufloaded", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001866 ret_number_bool, f_bufloaded},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001867 {"bufname", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001868 ret_string, f_bufname},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001869 {"bufnr", 0, 2, FEARG_1, arg2_buffer_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001870 ret_number, f_bufnr},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001871 {"bufwinid", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001872 ret_number, f_bufwinid},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001873 {"bufwinnr", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001874 ret_number, f_bufwinnr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001875 {"byte2line", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001876 ret_number, f_byte2line},
Christian Brabandt67672ef2023-04-24 21:09:54 +01001877 {"byteidx", 2, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001878 ret_number, f_byteidx},
Christian Brabandt67672ef2023-04-24 21:09:54 +01001879 {"byteidxcomp", 2, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001880 ret_number, f_byteidxcomp},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001881 {"call", 2, 3, FEARG_1, arg3_any_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001882 ret_any, f_call},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001883 {"ceil", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001884 ret_float, f_ceil},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001885 {"ch_canread", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001886 ret_number_bool, JOB_FUNC(f_ch_canread)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001887 {"ch_close", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001888 ret_void, JOB_FUNC(f_ch_close)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001889 {"ch_close_in", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001890 ret_void, JOB_FUNC(f_ch_close_in)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001891 {"ch_evalexpr", 2, 3, FEARG_1, arg23_chanexpr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001892 ret_any, JOB_FUNC(f_ch_evalexpr)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001893 {"ch_evalraw", 2, 3, FEARG_1, arg23_chanraw,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001894 ret_any, JOB_FUNC(f_ch_evalraw)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001895 {"ch_getbufnr", 2, 2, FEARG_1, arg2_chan_or_job_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001896 ret_number, JOB_FUNC(f_ch_getbufnr)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001897 {"ch_getjob", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001898 ret_job, JOB_FUNC(f_ch_getjob)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001899 {"ch_info", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001900 ret_dict_any, JOB_FUNC(f_ch_info)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001901 {"ch_log", 1, 2, FEARG_1, arg2_string_chan_or_job,
Bram Moolenaar4c5678f2022-11-30 18:12:19 +00001902 ret_void, f_ch_log},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001903 {"ch_logfile", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar4c5678f2022-11-30 18:12:19 +00001904 ret_void, f_ch_logfile},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001905 {"ch_open", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001906 ret_channel, JOB_FUNC(f_ch_open)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001907 {"ch_read", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001908 ret_string, JOB_FUNC(f_ch_read)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001909 {"ch_readblob", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001910 ret_blob, JOB_FUNC(f_ch_readblob)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001911 {"ch_readraw", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001912 ret_string, JOB_FUNC(f_ch_readraw)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001913 {"ch_sendexpr", 2, 3, FEARG_1, arg23_chanexpr,
Yegappan Lakshmanan3b470ae2022-04-16 10:41:27 +01001914 ret_any, JOB_FUNC(f_ch_sendexpr)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001915 {"ch_sendraw", 2, 3, FEARG_1, arg23_chanraw,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001916 ret_void, JOB_FUNC(f_ch_sendraw)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001917 {"ch_setoptions", 2, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001918 ret_void, JOB_FUNC(f_ch_setoptions)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001919 {"ch_status", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001920 ret_string, JOB_FUNC(f_ch_status)},
1921 {"changenr", 0, 0, 0, NULL,
1922 ret_number, f_changenr},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02001923 {"char2nr", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001924 ret_number, f_char2nr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001925 {"charclass", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001926 ret_number, f_charclass},
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00001927 {"charcol", 1, 2, FEARG_1, arg2_string_or_list_number,
Bram Moolenaar6f02b002021-01-10 20:22:54 +01001928 ret_number, f_charcol},
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01001929 {"charidx", 2, 4, FEARG_1, arg4_string_number_bool_bool,
Bram Moolenaar17793ef2020-12-28 12:56:58 +01001930 ret_number, f_charidx},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001931 {"chdir", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001932 ret_string, f_chdir},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001933 {"cindent", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001934 ret_number, f_cindent},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001935 {"clearmatches", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001936 ret_void, f_clearmatches},
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00001937 {"col", 1, 2, FEARG_1, arg2_string_or_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001938 ret_number, f_col},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001939 {"complete", 2, 2, FEARG_2, arg2_number_list,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001940 ret_void, f_complete},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001941 {"complete_add", 1, 1, FEARG_1, arg1_dict_or_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001942 ret_number, f_complete_add},
1943 {"complete_check", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001944 ret_number_bool, f_complete_check},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001945 {"complete_info", 0, 1, FEARG_1, arg1_list_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001946 ret_dict_any, f_complete_info},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001947 {"confirm", 1, 4, FEARG_1, arg4_string_string_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001948 ret_number, f_confirm},
1949 {"copy", 1, 1, FEARG_1, NULL,
Bram Moolenaar381692b2022-02-02 20:01:27 +00001950 ret_copy, f_copy},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001951 {"cos", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001952 ret_float, f_cos},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001953 {"cosh", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001954 ret_float, f_cosh},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001955 {"count", 2, 4, FEARG_1, arg24_count,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001956 ret_number, f_count},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001957 {"cscope_connection",0,3, 0, arg3_number_string_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001958 ret_number, f_cscope_connection},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001959 {"cursor", 1, 3, FEARG_1, arg13_cursor,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001960 ret_number, f_cursor},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001961 {"debugbreak", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001962 ret_number,
Bram Moolenaar4f974752019-02-17 17:44:42 +01001963#ifdef MSWIN
Bram Moolenaar15c47602020-03-26 22:16:48 +01001964 f_debugbreak
1965#else
1966 NULL
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02001967#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01001968 },
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001969 {"deepcopy", 1, 2, FEARG_1, arg12_deepcopy,
Bram Moolenaar381692b2022-02-02 20:01:27 +00001970 ret_copy, f_deepcopy},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001971 {"delete", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001972 ret_number_bool, f_delete},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001973 {"deletebufline", 2, 3, FEARG_1, arg3_buffer_lnum_lnum,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001974 ret_number_bool, f_deletebufline},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001975 {"did_filetype", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001976 ret_number_bool, f_did_filetype},
Yegappan Lakshmananfa378352024-02-01 22:05:27 +01001977 {"diff", 2, 3, FEARG_1, arg3_diff,
Yegappan Lakshmanana0010a12024-02-12 20:21:26 +01001978 ret_any, f_diff},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001979 {"diff_filler", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001980 ret_number, f_diff_filler},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001981 {"diff_hlID", 2, 2, FEARG_1, arg2_lnum_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001982 ret_number, f_diff_hlID},
h-east29b85712021-07-26 21:54:04 +02001983 {"digraph_get", 1, 1, FEARG_1, arg1_string,
1984 ret_string, f_digraph_get},
zeertzjqd4d12072024-07-16 20:34:16 +02001985 {"digraph_getlist", 0, 1, FEARG_1, arg1_bool,
h-east29b85712021-07-26 21:54:04 +02001986 ret_list_string_items, f_digraph_getlist},
Yegappan Lakshmananfc3b7752021-09-08 14:57:42 +02001987 {"digraph_set", 2, 2, FEARG_1, arg2_string,
h-east29b85712021-07-26 21:54:04 +02001988 ret_bool, f_digraph_set},
zeertzjqd4d12072024-07-16 20:34:16 +02001989 {"digraph_setlist", 1, 1, FEARG_1, arg1_list_string,
h-east29b85712021-07-26 21:54:04 +02001990 ret_bool, f_digraph_setlist},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001991 {"echoraw", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001992 ret_void, f_echoraw},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001993 {"empty", 1, 1, FEARG_1, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001994 ret_number_bool, f_empty},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001995 {"environ", 0, 0, 0, NULL,
1996 ret_dict_string, f_environ},
Bram Moolenaar80adaa82023-07-07 18:57:40 +01001997 {"err_teapot", 0, 1, 0, NULL,
1998 ret_number_bool, f_err_teapot},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001999 {"escape", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002000 ret_string, f_escape},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002001 {"eval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002002 ret_any, f_eval},
2003 {"eventhandler", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002004 ret_number_bool, f_eventhandler},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002005 {"executable", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002006 ret_number, f_executable},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002007 {"execute", 1, 2, FEARG_1, arg12_execute,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002008 ret_string, f_execute},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002009 {"exepath", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002010 ret_string, f_exepath},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002011 {"exists", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002012 ret_number_bool, f_exists},
Bram Moolenaar26735992021-08-08 14:43:22 +02002013 {"exists_compiled", 1, 1, FEARG_1, arg1_string,
2014 ret_number_bool, f_exists_compiled},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002015 {"exp", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002016 ret_float, f_exp},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002017 {"expand", 1, 3, FEARG_1, arg3_string_bool_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002018 ret_any, f_expand},
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01002019 {"expandcmd", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002020 ret_string, f_expandcmd},
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01002021 {"extend", 2, 3, FEARG_1, arg23_extend,
Bram Moolenaar81330182022-02-01 12:11:58 +00002022 ret_extend, f_extend},
Bram Moolenaarb0e6b512021-01-12 20:23:40 +01002023 {"extendnew", 2, 3, FEARG_1, arg23_extendnew,
2024 ret_first_cont, f_extendnew},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002025 {"feedkeys", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002026 ret_void, f_feedkeys},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002027 {"file_readable", 1, 1, FEARG_1, arg1_string, // obsolete
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002028 ret_number_bool, f_filereadable},
Shougo Matsushita60c87432024-06-03 22:59:27 +02002029 {"filecopy", 2, 2, FEARG_1, arg2_string,
2030 ret_number_bool, f_filecopy},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002031 {"filereadable", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002032 ret_number_bool, f_filereadable},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002033 {"filewritable", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002034 ret_number, f_filewritable},
Bram Moolenaar18024052021-12-25 21:43:28 +00002035 {"filter", 2, 2, FEARG_1, arg2_filter,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002036 ret_first_arg, f_filter},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002037 {"finddir", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar08018222021-12-22 18:45:37 +00002038 ret_finddir, f_finddir},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002039 {"findfile", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar10c83dd2021-09-04 14:49:56 +02002040 ret_any, f_findfile},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002041 {"flatten", 1, 2, FEARG_1, arg2_list_any_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002042 ret_list_any, f_flatten},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002043 {"flattennew", 1, 2, FEARG_1, arg2_list_any_number,
Bram Moolenaar3b690062021-02-01 20:14:51 +01002044 ret_list_any, f_flattennew},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002045 {"float2nr", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002046 ret_number, f_float2nr},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002047 {"floor", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002048 ret_float, f_floor},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002049 {"fmod", 2, 2, FEARG_1, arg2_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002050 ret_float, f_fmod},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002051 {"fnameescape", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002052 ret_string, f_fnameescape},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002053 {"fnamemodify", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002054 ret_string, f_fnamemodify},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002055 {"foldclosed", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002056 ret_number, f_foldclosed},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002057 {"foldclosedend", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002058 ret_number, f_foldclosedend},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002059 {"foldlevel", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002060 ret_number, f_foldlevel},
2061 {"foldtext", 0, 0, 0, NULL,
2062 ret_string, f_foldtext},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002063 {"foldtextresult", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002064 ret_string, f_foldtextresult},
Ernie Raele79e2072024-01-13 11:47:33 +01002065 {"foreach", 2, 2, FEARG_1, arg2_foreach,
2066 ret_first_arg, f_foreach},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002067 {"foreground", 0, 0, 0, NULL,
2068 ret_void, f_foreground},
Bram Moolenaardd44b582022-09-15 22:03:57 +01002069 {"fullcommand", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar038e09e2021-02-06 12:38:51 +01002070 ret_string, f_fullcommand},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002071 {"funcref", 1, 3, FEARG_1, arg3_any_list_dict,
Bram Moolenaar2f9f4cc2021-12-20 09:36:27 +00002072 ret_func_unknown, f_funcref},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002073 {"function", 1, 3, FEARG_1, arg3_any_list_dict,
Bram Moolenaar2f9f4cc2021-12-20 09:36:27 +00002074 ret_func_unknown, f_function},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002075 {"garbagecollect", 0, 1, 0, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002076 ret_void, f_garbagecollect},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002077 {"get", 2, 3, FEARG_1, arg23_get,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002078 ret_any, f_get},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002079 {"getbufinfo", 0, 1, FEARG_1, arg1_buffer_or_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002080 ret_list_dict_any, f_getbufinfo},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002081 {"getbufline", 2, 3, FEARG_1, arg3_buffer_lnum_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002082 ret_list_string, f_getbufline},
Bram Moolenaarce30ccc2022-11-21 19:57:04 +00002083 {"getbufoneline", 2, 2, FEARG_1, arg2_buffer_lnum,
2084 ret_string, f_getbufoneline},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002085 {"getbufvar", 2, 3, FEARG_1, arg3_buffer_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002086 ret_any, f_getbufvar},
mikoto20001083cae2024-11-11 21:24:14 +01002087 {"getcellpixels", 0, 0, 0, NULL,
mikoto2000a73dfc22024-11-18 21:12:21 +01002088 ret_list_any, f_getcellpixels},
Kota Kato66bb9ae2023-01-17 18:31:56 +00002089 {"getcellwidths", 0, 0, 0, NULL,
2090 ret_list_any, f_getcellwidths},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002091 {"getchangelist", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002092 ret_list_any, f_getchangelist},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002093 {"getchar", 0, 1, 0, arg1_bool,
Bram Moolenaar3a7503c2021-06-07 18:29:17 +02002094 ret_any, f_getchar},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002095 {"getcharmod", 0, 0, 0, NULL,
2096 ret_number, f_getcharmod},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002097 {"getcharpos", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar6f02b002021-01-10 20:22:54 +01002098 ret_list_number, f_getcharpos},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002099 {"getcharsearch", 0, 0, 0, NULL,
2100 ret_dict_any, f_getcharsearch},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002101 {"getcharstr", 0, 1, 0, arg1_bool,
Bram Moolenaar3a7503c2021-06-07 18:29:17 +02002102 ret_string, f_getcharstr},
Ruslan Russkikh0407d622024-10-08 22:21:05 +02002103 {"getcmdcomplpat", 0, 0, 0, NULL,
2104 ret_string, f_getcmdcomplpat},
Shougo Matsushita79d599b2022-05-07 12:48:29 +01002105 {"getcmdcompltype", 0, 0, 0, NULL,
2106 ret_string, f_getcmdcompltype},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002107 {"getcmdline", 0, 0, 0, NULL,
2108 ret_string, f_getcmdline},
2109 {"getcmdpos", 0, 0, 0, NULL,
2110 ret_number, f_getcmdpos},
Shougo Matsushita69084282024-09-23 20:34:47 +02002111 {"getcmdprompt", 0, 0, 0, NULL,
2112 ret_string, f_getcmdprompt},
Shougo Matsushita79d599b2022-05-07 12:48:29 +01002113 {"getcmdscreenpos", 0, 0, 0, NULL,
2114 ret_number, f_getcmdscreenpos},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002115 {"getcmdtype", 0, 0, 0, NULL,
2116 ret_string, f_getcmdtype},
2117 {"getcmdwintype", 0, 0, 0, NULL,
2118 ret_string, f_getcmdwintype},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002119 {"getcompletion", 2, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002120 ret_list_string, f_getcompletion},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002121 {"getcurpos", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002122 ret_list_number, f_getcurpos},
Bram Moolenaar82e46e52022-02-05 18:12:34 +00002123 {"getcursorcharpos", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar6f02b002021-01-10 20:22:54 +01002124 ret_list_number, f_getcursorcharpos},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002125 {"getcwd", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002126 ret_string, f_getcwd},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002127 {"getenv", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar7ad67d12021-03-10 16:08:26 +01002128 ret_any, f_getenv},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002129 {"getfontname", 0, 1, 0, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002130 ret_string, f_getfontname},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002131 {"getfperm", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002132 ret_string, f_getfperm},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002133 {"getfsize", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002134 ret_number, f_getfsize},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002135 {"getftime", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002136 ret_number, f_getftime},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002137 {"getftype", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002138 ret_string, f_getftype},
2139 {"getimstatus", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002140 ret_number_bool, f_getimstatus},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002141 {"getjumplist", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002142 ret_list_any, f_getjumplist},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002143 {"getline", 1, 2, FEARG_1, arg2_lnum,
Bram Moolenaar078a4612022-01-04 15:17:03 +00002144 ret_getline, f_getline},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002145 {"getloclist", 1, 2, 0, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002146 ret_list_or_dict_1, f_getloclist},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002147 {"getmarklist", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002148 ret_list_dict_any, f_getmarklist},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002149 {"getmatches", 0, 1, 0, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002150 ret_list_dict_any, f_getmatches},
2151 {"getmousepos", 0, 0, 0, NULL,
2152 ret_dict_number, f_getmousepos},
Bram Moolenaar24dc19c2022-11-14 19:49:15 +00002153 {"getmouseshape", 0, 0, 0, NULL,
2154 ret_string, f_getmouseshape},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002155 {"getpid", 0, 0, 0, NULL,
2156 ret_number, f_getpid},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002157 {"getpos", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002158 ret_list_number, f_getpos},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002159 {"getqflist", 0, 1, 0, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002160 ret_list_or_dict_0, f_getqflist},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002161 {"getreg", 0, 3, FEARG_1, arg3_string_bool_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002162 ret_getreg, f_getreg},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002163 {"getreginfo", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002164 ret_dict_any, f_getreginfo},
Shougo Matsushita19b71882024-02-28 22:48:12 +01002165 {"getregion", 2, 3, FEARG_1, arg3_list_list_dict,
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01002166 ret_list_string, f_getregion},
zeertzjqd4d12072024-07-16 20:34:16 +02002167 {"getregionpos", 2, 3, FEARG_1, arg3_list_list_dict,
2168 ret_list_regionpos, f_getregionpos},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002169 {"getregtype", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002170 ret_string, f_getregtype},
Yegappan Lakshmanan520f6ef2022-08-25 17:40:40 +01002171 {"getscriptinfo", 0, 1, 0, arg1_dict_any,
Yegappan Lakshmananf768c3d2022-08-22 13:15:13 +01002172 ret_list_dict_any, f_getscriptinfo},
ichizok663d18d2025-01-02 18:06:00 +01002173 {"getstacktrace", 0, 0, 0, NULL,
2174 ret_list_dict_any, f_getstacktrace},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002175 {"gettabinfo", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002176 ret_list_dict_any, f_gettabinfo},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002177 {"gettabvar", 2, 3, FEARG_1, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002178 ret_any, f_gettabvar},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002179 {"gettabwinvar", 3, 4, FEARG_1, arg4_number_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002180 ret_any, f_gettabwinvar},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002181 {"gettagstack", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002182 ret_dict_any, f_gettagstack},
Christ van Willegence0ef912024-06-20 23:41:59 +02002183 {"gettext", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002184 ret_string, f_gettext},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002185 {"getwininfo", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002186 ret_list_dict_any, f_getwininfo},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002187 {"getwinpos", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002188 ret_list_number, f_getwinpos},
2189 {"getwinposx", 0, 0, 0, NULL,
2190 ret_number, f_getwinposx},
2191 {"getwinposy", 0, 0, 0, NULL,
2192 ret_number, f_getwinposy},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002193 {"getwinvar", 2, 3, FEARG_1, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002194 ret_any, f_getwinvar},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002195 {"glob", 1, 4, FEARG_1, arg14_glob,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002196 ret_any, f_glob},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002197 {"glob2regpat", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002198 ret_string, f_glob2regpat},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002199 {"globpath", 2, 5, FEARG_2, arg25_globpath,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002200 ret_any, f_globpath},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002201 {"has", 1, 2, 0, arg2_string_bool,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002202 ret_number_bool, f_has},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002203 {"has_key", 2, 2, FEARG_1, arg2_dict_any_string_or_nr,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002204 ret_number_bool, f_has_key},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002205 {"haslocaldir", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002206 ret_number, f_haslocaldir},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002207 {"hasmapto", 1, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002208 ret_number_bool, f_hasmapto},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002209 {"highlightID", 1, 1, FEARG_1, arg1_string, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02002210 ret_number, f_hlID},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002211 {"highlight_exists",1, 1, FEARG_1, arg1_string, // obsolete
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002212 ret_number_bool, f_hlexists},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002213 {"histadd", 2, 2, FEARG_2, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002214 ret_number_bool, f_histadd},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002215 {"histdel", 1, 2, FEARG_1, arg2_string_string_or_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002216 ret_number_bool, f_histdel},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002217 {"histget", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002218 ret_string, f_histget},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002219 {"histnr", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002220 ret_number, f_histnr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002221 {"hlID", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002222 ret_number, f_hlID},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002223 {"hlexists", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002224 ret_number_bool, f_hlexists},
Yegappan Lakshmanand1a8d652021-11-03 21:56:45 +00002225 {"hlget", 0, 2, FEARG_1, arg2_string_bool,
2226 ret_list_dict_any, f_hlget},
2227 {"hlset", 1, 1, FEARG_1, arg1_list_any,
2228 ret_number_bool, f_hlset},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002229 {"hostname", 0, 0, 0, NULL,
2230 ret_string, f_hostname},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002231 {"iconv", 3, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002232 ret_string, f_iconv},
Ernie Raelc8e158b2024-07-09 18:39:52 +02002233 {"id", 1, 1, FEARG_1, NULL,
2234 ret_string, f_id},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002235 {"indent", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002236 ret_number, f_indent},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002237 {"index", 2, 4, FEARG_1, arg24_index,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002238 ret_number, f_index},
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01002239 {"indexof", 2, 3, FEARG_1, arg23_index,
2240 ret_number, f_indexof},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002241 {"input", 1, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002242 ret_string, f_input},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002243 {"inputdialog", 1, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002244 ret_string, f_inputdialog},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002245 {"inputlist", 1, 1, FEARG_1, arg1_list_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002246 ret_number, f_inputlist},
2247 {"inputrestore", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002248 ret_number_bool, f_inputrestore},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002249 {"inputsave", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002250 ret_number_bool, f_inputsave},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002251 {"inputsecret", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002252 ret_string, f_inputsecret},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002253 {"insert", 2, 3, FEARG_1, arg23_insert,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002254 ret_first_arg, f_insert},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002255 {"instanceof", 2, VARGS, FEARG_1|FE_X, arg2_instanceof,
LemonBoyafe04662023-08-23 21:08:11 +02002256 ret_bool, f_instanceof},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002257 {"interrupt", 0, 0, 0, NULL,
2258 ret_void, f_interrupt},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002259 {"invert", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002260 ret_number, f_invert},
LemonBoydca1d402022-04-28 15:26:33 +01002261 {"isabsolutepath", 1, 1, FEARG_1, arg1_string,
2262 ret_number_bool, f_isabsolutepath},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002263 {"isdirectory", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002264 ret_number_bool, f_isdirectory},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002265 {"isinf", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002266 ret_number, MATH_FUNC(f_isinf)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002267 {"islocked", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002268 ret_number_bool, f_islocked},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002269 {"isnan", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002270 ret_number_bool, MATH_FUNC(f_isnan)},
Bram Moolenaar3e518a82022-08-30 17:45:33 +01002271 {"items", 1, 1, FEARG_1, arg1_string_or_list_or_dict,
Bram Moolenaarefc5db52021-07-07 21:21:30 +02002272 ret_list_items, f_items},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002273 {"job_getchannel", 1, 1, FEARG_1, arg1_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002274 ret_channel, JOB_FUNC(f_job_getchannel)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002275 {"job_info", 0, 1, FEARG_1, arg1_job,
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01002276 ret_job_info, JOB_FUNC(f_job_info)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002277 {"job_setoptions", 2, 2, FEARG_1, arg2_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002278 ret_void, JOB_FUNC(f_job_setoptions)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002279 {"job_start", 1, 2, FEARG_1, arg2_string_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002280 ret_job, JOB_FUNC(f_job_start)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002281 {"job_status", 1, 1, FEARG_1, arg1_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002282 ret_string, JOB_FUNC(f_job_status)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002283 {"job_stop", 1, 2, FEARG_1, arg2_job_string_or_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002284 ret_number_bool, JOB_FUNC(f_job_stop)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002285 {"join", 1, 2, FEARG_1, arg2_list_any_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002286 ret_string, f_join},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002287 {"js_decode", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002288 ret_any, f_js_decode},
2289 {"js_encode", 1, 1, FEARG_1, NULL,
2290 ret_string, f_js_encode},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002291 {"json_decode", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002292 ret_any, f_json_decode},
2293 {"json_encode", 1, 1, FEARG_1, NULL,
2294 ret_string, f_json_encode},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002295 {"keys", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002296 ret_list_string, f_keys},
zeertzjqcdc83932022-09-12 13:38:41 +01002297 {"keytrans", 1, 1, FEARG_1, arg1_string,
2298 ret_string, f_keytrans},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002299 {"last_buffer_nr", 0, 0, 0, NULL, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02002300 ret_number, f_last_buffer_nr},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002301 {"len", 1, 1, FEARG_1, arg1_len,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002302 ret_number, f_len},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002303 {"libcall", 3, 3, FEARG_3, arg3_libcall,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002304 ret_string, f_libcall},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002305 {"libcallnr", 3, 3, FEARG_3, arg3_libcall,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002306 ret_number, f_libcallnr},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002307 {"line", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002308 ret_number, f_line},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002309 {"line2byte", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002310 ret_number, f_line2byte},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002311 {"lispindent", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002312 ret_number, f_lispindent},
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +02002313 {"list2blob", 1, 1, FEARG_1, arg1_list_number,
2314 ret_blob, f_list2blob},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002315 {"list2str", 1, 2, FEARG_1, arg2_list_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002316 ret_string, f_list2str},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002317 {"listener_add", 1, 2, FEARG_2, arg2_any_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002318 ret_number, f_listener_add},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002319 {"listener_flush", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002320 ret_void, f_listener_flush},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002321 {"listener_remove", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002322 ret_number_bool, f_listener_remove},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002323 {"localtime", 0, 0, 0, NULL,
2324 ret_number, f_localtime},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002325 {"log", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002326 ret_float, f_log},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002327 {"log10", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002328 ret_float, f_log10},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002329 {"luaeval", 1, 2, FEARG_1, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002330 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002331#ifdef FEAT_LUA
Bram Moolenaar15c47602020-03-26 22:16:48 +01002332 f_luaeval
2333#else
2334 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002335#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002336 },
Bram Moolenaar18024052021-12-25 21:43:28 +00002337 {"map", 2, 2, FEARG_1, arg2_map,
Bram Moolenaarea696852020-11-09 18:31:39 +01002338 ret_first_cont, f_map},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002339 {"maparg", 1, 4, FEARG_1, arg14_maparg,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002340 ret_maparg, f_maparg},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002341 {"mapcheck", 1, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002342 ret_string, f_mapcheck},
Ernie Rael09661202022-04-25 14:40:44 +01002343 {"maplist", 0, 1, 0, arg1_bool,
2344 ret_list_dict_any, f_maplist},
Bram Moolenaar18024052021-12-25 21:43:28 +00002345 {"mapnew", 2, 2, FEARG_1, arg2_mapnew,
Bram Moolenaarea696852020-11-09 18:31:39 +01002346 ret_first_cont, f_mapnew},
Ernie Rael51d04d12022-05-04 15:40:22 +01002347 {"mapset", 1, 3, FEARG_1, arg3_string_or_dict_bool_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002348 ret_void, f_mapset},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002349 {"match", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002350 ret_any, f_match},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002351 {"matchadd", 2, 5, FEARG_1, arg25_matchadd,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002352 ret_number, f_matchadd},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002353 {"matchaddpos", 2, 5, FEARG_1, arg25_matchaddpos,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002354 ret_number, f_matchaddpos},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002355 {"matcharg", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002356 ret_list_string, f_matcharg},
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01002357 {"matchbufline", 4, 5, FEARG_1, arg45_matchbufline,
2358 ret_list_any, f_matchbufline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002359 {"matchdelete", 1, 2, FEARG_1, arg2_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002360 ret_number_bool, f_matchdelete},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002361 {"matchend", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002362 ret_number, f_matchend},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002363 {"matchfuzzy", 2, 3, FEARG_1, arg3_list_string_dict,
Yegappan Lakshmanan2d8e9982023-06-24 16:42:25 +01002364 ret_list_any, f_matchfuzzy},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002365 {"matchfuzzypos", 2, 3, FEARG_1, arg3_list_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002366 ret_list_any, f_matchfuzzypos},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002367 {"matchlist", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002368 ret_list_string, f_matchlist},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002369 {"matchstr", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002370 ret_string, f_matchstr},
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01002371 {"matchstrlist", 2, 3, FEARG_1, arg23_matchstrlist,
2372 ret_list_any, f_matchstrlist},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002373 {"matchstrpos", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002374 ret_list_any, f_matchstrpos},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002375 {"max", 1, 1, FEARG_1, arg1_list_or_dict,
Bram Moolenaar9ae37052021-01-22 22:31:10 +01002376 ret_number, f_max},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002377 {"menu_info", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002378 ret_dict_any,
Bram Moolenaara2cbdea2020-03-16 21:08:31 +01002379#ifdef FEAT_MENU
Bram Moolenaar15c47602020-03-26 22:16:48 +01002380 f_menu_info
2381#else
2382 NULL
Bram Moolenaara2cbdea2020-03-16 21:08:31 +01002383#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002384 },
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002385 {"min", 1, 1, FEARG_1, arg1_list_or_dict,
Bram Moolenaar9ae37052021-01-22 22:31:10 +01002386 ret_number, f_min},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002387 {"mkdir", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002388 ret_number_bool, f_mkdir},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002389 {"mode", 0, 1, FEARG_1, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002390 ret_string, f_mode},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002391 {"mzeval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002392 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002393#ifdef FEAT_MZSCHEME
Bram Moolenaar15c47602020-03-26 22:16:48 +01002394 f_mzeval
2395#else
2396 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002397#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002398 },
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002399 {"nextnonblank", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002400 ret_number, f_nextnonblank},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002401 {"nr2char", 1, 2, FEARG_1, arg2_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002402 ret_string, f_nr2char},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002403 {"or", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002404 ret_number, f_or},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002405 {"pathshorten", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002406 ret_string, f_pathshorten},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002407 {"perleval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002408 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002409#ifdef FEAT_PERL
Bram Moolenaar15c47602020-03-26 22:16:48 +01002410 f_perleval
2411#else
2412 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002413#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002414 },
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002415 {"popup_atcursor", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002416 ret_number, PROP_FUNC(f_popup_atcursor)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002417 {"popup_beval", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002418 ret_number, PROP_FUNC(f_popup_beval)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002419 {"popup_clear", 0, 1, 0, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002420 ret_void, PROP_FUNC(f_popup_clear)},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002421 {"popup_close", 1, 2, FEARG_1, arg2_number_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002422 ret_void, PROP_FUNC(f_popup_close)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002423 {"popup_create", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002424 ret_number, PROP_FUNC(f_popup_create)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002425 {"popup_dialog", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002426 ret_number, PROP_FUNC(f_popup_dialog)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002427 {"popup_filter_menu", 2, 2, 0, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002428 ret_bool, PROP_FUNC(f_popup_filter_menu)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002429 {"popup_filter_yesno", 2, 2, 0, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002430 ret_bool, PROP_FUNC(f_popup_filter_yesno)},
Bram Moolenaarbdc09a12022-10-07 14:31:45 +01002431 {"popup_findecho", 0, 0, 0, NULL,
2432 ret_number, PROP_FUNC(f_popup_findecho)},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002433 {"popup_findinfo", 0, 0, 0, NULL,
2434 ret_number, PROP_FUNC(f_popup_findinfo)},
2435 {"popup_findpreview", 0, 0, 0, NULL,
2436 ret_number, PROP_FUNC(f_popup_findpreview)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002437 {"popup_getoptions", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002438 ret_dict_any, PROP_FUNC(f_popup_getoptions)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002439 {"popup_getpos", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002440 ret_dict_any, PROP_FUNC(f_popup_getpos)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002441 {"popup_hide", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002442 ret_void, PROP_FUNC(f_popup_hide)},
2443 {"popup_list", 0, 0, 0, NULL,
2444 ret_list_number, PROP_FUNC(f_popup_list)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002445 {"popup_locate", 2, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002446 ret_number, PROP_FUNC(f_popup_locate)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002447 {"popup_menu", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002448 ret_number, PROP_FUNC(f_popup_menu)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002449 {"popup_move", 2, 2, FEARG_1, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002450 ret_void, PROP_FUNC(f_popup_move)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002451 {"popup_notification", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002452 ret_number, PROP_FUNC(f_popup_notification)},
Christian Brabandtfbc37f12024-06-18 20:50:58 +02002453 {"popup_setbuf", 2, 2, FEARG_1, arg2_number_buffer,
2454 ret_number_bool, PROP_FUNC(f_popup_setbuf)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002455 {"popup_setoptions", 2, 2, FEARG_1, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002456 ret_void, PROP_FUNC(f_popup_setoptions)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002457 {"popup_settext", 2, 2, FEARG_1, arg2_number_string_or_list,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002458 ret_void, PROP_FUNC(f_popup_settext)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002459 {"popup_show", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002460 ret_void, PROP_FUNC(f_popup_show)},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002461 {"pow", 2, 2, FEARG_1, arg2_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002462 ret_float, f_pow},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002463 {"prevnonblank", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002464 ret_number, f_prevnonblank},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002465 {"printf", 1, 19, FEARG_2, arg119_printf,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002466 ret_string, f_printf},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002467 {"prompt_getprompt", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002468 ret_string, JOB_FUNC(f_prompt_getprompt)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002469 {"prompt_setcallback", 2, 2, FEARG_1, arg2_buffer_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002470 ret_void, JOB_FUNC(f_prompt_setcallback)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002471 {"prompt_setinterrupt", 2, 2, FEARG_1, arg2_buffer_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002472 ret_void, JOB_FUNC(f_prompt_setinterrupt)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002473 {"prompt_setprompt", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002474 ret_void, JOB_FUNC(f_prompt_setprompt)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002475 {"prop_add", 3, 3, FEARG_1, arg3_number_number_dict,
Bram Moolenaar7f9969c2022-07-25 18:13:54 +01002476 ret_number, PROP_FUNC(f_prop_add)},
Yegappan Lakshmananccfb7c62021-08-16 21:39:09 +02002477 {"prop_add_list", 2, 2, FEARG_1, arg2_dict_any_list_any,
2478 ret_void, PROP_FUNC(f_prop_add_list)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002479 {"prop_clear", 1, 3, FEARG_1, arg3_number_number_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002480 ret_void, PROP_FUNC(f_prop_clear)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002481 {"prop_find", 1, 2, FEARG_1, arg2_dict_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002482 ret_dict_any, PROP_FUNC(f_prop_find)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002483 {"prop_list", 1, 2, FEARG_1, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002484 ret_list_dict_any, PROP_FUNC(f_prop_list)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002485 {"prop_remove", 1, 3, FEARG_1, arg3_dict_number_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002486 ret_number, PROP_FUNC(f_prop_remove)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002487 {"prop_type_add", 2, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002488 ret_void, PROP_FUNC(f_prop_type_add)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002489 {"prop_type_change", 2, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002490 ret_void, PROP_FUNC(f_prop_type_change)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002491 {"prop_type_delete", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002492 ret_void, PROP_FUNC(f_prop_type_delete)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002493 {"prop_type_get", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002494 ret_dict_any, PROP_FUNC(f_prop_type_get)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002495 {"prop_type_list", 0, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002496 ret_list_string, PROP_FUNC(f_prop_type_list)},
2497 {"pum_getpos", 0, 0, 0, NULL,
2498 ret_dict_number, f_pum_getpos},
2499 {"pumvisible", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002500 ret_number_bool, f_pumvisible},
Ben Jacksonea19e782024-11-06 21:50:05 +01002501 {"py3eval", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002502 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002503#ifdef FEAT_PYTHON3
Bram Moolenaar15c47602020-03-26 22:16:48 +01002504 f_py3eval
2505#else
2506 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002507#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002508 },
Ben Jacksonea19e782024-11-06 21:50:05 +01002509 {"pyeval", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002510 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002511#ifdef FEAT_PYTHON
Bram Moolenaar15c47602020-03-26 22:16:48 +01002512 f_pyeval
2513#else
2514 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002515#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002516 },
Ben Jacksonea19e782024-11-06 21:50:05 +01002517 {"pyxeval", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002518 ret_any,
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01002519#if defined(FEAT_PYTHON) || defined(FEAT_PYTHON3)
Bram Moolenaar15c47602020-03-26 22:16:48 +01002520 f_pyxeval
2521#else
2522 NULL
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01002523#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002524 },
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002525 {"rand", 0, 1, FEARG_1, arg1_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002526 ret_number, f_rand},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002527 {"range", 1, 3, FEARG_1, arg3_number,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00002528 ret_list_number, f_range},
K.Takata11df3ae2022-10-19 14:02:40 +01002529 {"readblob", 1, 3, FEARG_1, arg3_string_number_number,
Bram Moolenaarc423ad72021-01-13 20:38:03 +01002530 ret_blob, f_readblob},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002531 {"readdir", 1, 3, FEARG_1, arg3_string_any_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002532 ret_list_string, f_readdir},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002533 {"readdirex", 1, 3, FEARG_1, arg3_string_any_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002534 ret_list_dict_any, f_readdirex},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002535 {"readfile", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaarc423ad72021-01-13 20:38:03 +01002536 ret_list_string, f_readfile},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002537 {"reduce", 2, 3, FEARG_1, arg23_reduce,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002538 ret_any, f_reduce},
2539 {"reg_executing", 0, 0, 0, NULL,
2540 ret_string, f_reg_executing},
2541 {"reg_recording", 0, 0, 0, NULL,
2542 ret_string, f_reg_recording},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002543 {"reltime", 0, 2, FEARG_1, arg2_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002544 ret_list_any, f_reltime},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002545 {"reltimefloat", 1, 1, FEARG_1, arg1_list_number,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002546 ret_float, f_reltimefloat},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002547 {"reltimestr", 1, 1, FEARG_1, arg1_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002548 ret_string, f_reltimestr},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002549 {"remote_expr", 2, 4, FEARG_1, arg24_remote_expr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002550 ret_string, f_remote_expr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002551 {"remote_foreground", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002552 ret_string, f_remote_foreground},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002553 {"remote_peek", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002554 ret_number, f_remote_peek},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002555 {"remote_read", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002556 ret_string, f_remote_read},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002557 {"remote_send", 2, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002558 ret_string, f_remote_send},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002559 {"remote_startserver", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002560 ret_void, f_remote_startserver},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002561 {"remove", 2, 3, FEARG_1, arg23_remove,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002562 ret_remove, f_remove},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002563 {"rename", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002564 ret_number_bool, f_rename},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002565 {"repeat", 2, 2, FEARG_1, arg2_repeat,
Bram Moolenaar1780f082021-07-31 22:03:59 +02002566 ret_repeat, f_repeat},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002567 {"resolve", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002568 ret_string, f_resolve},
Yegappan Lakshmananf9dc2782023-05-11 15:02:56 +01002569 {"reverse", 1, 1, FEARG_1, arg1_string_or_list_or_blob_mod,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002570 ret_first_arg, f_reverse},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002571 {"round", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002572 ret_float, f_round},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002573 {"rubyeval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002574 ret_any,
Bram Moolenaare99be0e2019-03-26 22:51:09 +01002575#ifdef FEAT_RUBY
Bram Moolenaar15c47602020-03-26 22:16:48 +01002576 f_rubyeval
2577#else
2578 NULL
Bram Moolenaare99be0e2019-03-26 22:51:09 +01002579#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002580 },
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002581 {"screenattr", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002582 ret_number, f_screenattr},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002583 {"screenchar", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002584 ret_number, f_screenchar},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002585 {"screenchars", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002586 ret_list_number, f_screenchars},
2587 {"screencol", 0, 0, 0, NULL,
2588 ret_number, f_screencol},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002589 {"screenpos", 3, 3, FEARG_1, arg3_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002590 ret_dict_number, f_screenpos},
2591 {"screenrow", 0, 0, 0, NULL,
2592 ret_number, f_screenrow},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002593 {"screenstring", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002594 ret_string, f_screenstring},
Bram Moolenaarcd268012021-07-22 19:11:08 +02002595 {"search", 1, 5, FEARG_1, arg15_search,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002596 ret_number, f_search},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002597 {"searchcount", 0, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002598 ret_dict_any, f_searchcount},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002599 {"searchdecl", 1, 3, FEARG_1, arg3_string_bool_bool,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002600 ret_number_bool, f_searchdecl},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002601 {"searchpair", 3, 7, 0, arg37_searchpair,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002602 ret_number, f_searchpair},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002603 {"searchpairpos", 3, 7, 0, arg37_searchpair,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002604 ret_list_number, f_searchpairpos},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002605 {"searchpos", 1, 5, FEARG_1, arg15_search,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002606 ret_list_number, f_searchpos},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002607 {"server2client", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002608 ret_number_bool, f_server2client},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002609 {"serverlist", 0, 0, 0, NULL,
2610 ret_string, f_serverlist},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002611 {"setbufline", 3, 3, FEARG_3, arg3_setbufline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002612 ret_number_bool, f_setbufline},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002613 {"setbufvar", 3, 3, FEARG_3, arg3_buffer_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002614 ret_void, f_setbufvar},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002615 {"setcellwidths", 1, 1, FEARG_1, arg1_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002616 ret_void, f_setcellwidths},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002617 {"setcharpos", 2, 2, FEARG_2, arg2_string_list_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002618 ret_number_bool, f_setcharpos},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002619 {"setcharsearch", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002620 ret_void, f_setcharsearch},
Shougo Matsushita07ea5f12022-08-27 12:22:25 +01002621 {"setcmdline", 1, 2, FEARG_1, arg2_string_number,
2622 ret_number_bool, f_setcmdline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002623 {"setcmdpos", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002624 ret_number_bool, f_setcmdpos},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002625 {"setcursorcharpos", 1, 3, FEARG_1, arg13_cursor,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002626 ret_number_bool, f_setcursorcharpos},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002627 {"setenv", 2, 2, FEARG_2, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002628 ret_void, f_setenv},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002629 {"setfperm", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002630 ret_number_bool, f_setfperm},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002631 {"setline", 2, 2, FEARG_2, arg2_setline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002632 ret_number_bool, f_setline},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002633 {"setloclist", 2, 4, FEARG_2, arg24_setloclist,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002634 ret_number_bool, f_setloclist},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002635 {"setmatches", 1, 2, FEARG_1, arg2_list_any_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002636 ret_number_bool, f_setmatches},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002637 {"setpos", 2, 2, FEARG_2, arg2_string_list_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002638 ret_number_bool, f_setpos},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002639 {"setqflist", 1, 3, FEARG_1, arg13_setqflist,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002640 ret_number_bool, f_setqflist},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002641 {"setreg", 2, 3, FEARG_2, arg3_string_any_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002642 ret_number_bool, f_setreg},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002643 {"settabvar", 3, 3, FEARG_3, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002644 ret_void, f_settabvar},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002645 {"settabwinvar", 4, 4, FEARG_4, arg4_number_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002646 ret_void, f_settabwinvar},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002647 {"settagstack", 2, 3, FEARG_2, arg23_settagstack,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002648 ret_number_bool, f_settagstack},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002649 {"setwinvar", 3, 3, FEARG_3, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002650 ret_void, f_setwinvar},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002651 {"sha256", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002652 ret_string,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002653#ifdef FEAT_CRYPT
Bram Moolenaar15c47602020-03-26 22:16:48 +01002654 f_sha256
2655#else
2656 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002657#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002658 },
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002659 {"shellescape", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002660 ret_string, f_shellescape},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002661 {"shiftwidth", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002662 ret_number, f_shiftwidth},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002663 {"sign_define", 1, 2, FEARG_1, arg2_string_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002664 ret_any, SIGN_FUNC(f_sign_define)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002665 {"sign_getdefined", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002666 ret_list_dict_any, SIGN_FUNC(f_sign_getdefined)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002667 {"sign_getplaced", 0, 2, FEARG_1, arg02_sign_getplaced,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002668 ret_list_dict_any, SIGN_FUNC(f_sign_getplaced)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002669 {"sign_jump", 3, 3, FEARG_1, arg3_number_string_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002670 ret_number, SIGN_FUNC(f_sign_jump)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002671 {"sign_place", 4, 5, FEARG_1, arg45_sign_place,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002672 ret_number, SIGN_FUNC(f_sign_place)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002673 {"sign_placelist", 1, 1, FEARG_1, arg1_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002674 ret_list_number, SIGN_FUNC(f_sign_placelist)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002675 {"sign_undefine", 0, 1, FEARG_1, arg1_string_or_list_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002676 ret_number_bool, SIGN_FUNC(f_sign_undefine)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002677 {"sign_unplace", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002678 ret_number_bool, SIGN_FUNC(f_sign_unplace)},
Sean Dewara63780b2021-11-03 13:15:47 +00002679 {"sign_unplacelist", 1, 1, FEARG_1, arg1_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002680 ret_list_number, SIGN_FUNC(f_sign_unplacelist)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002681 {"simplify", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002682 ret_string, f_simplify},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002683 {"sin", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002684 ret_float, f_sin},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002685 {"sinh", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002686 ret_float, f_sinh},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002687 {"slice", 2, 3, FEARG_1, arg23_slice,
Bram Moolenaar00eb9952022-02-05 19:23:18 +00002688 ret_slice, f_slice},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002689 {"sort", 1, 3, FEARG_1, arg13_sortuniq,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002690 ret_first_arg, f_sort},
2691 {"sound_clear", 0, 0, 0, NULL,
2692 ret_void, SOUND_FUNC(f_sound_clear)},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002693 {"sound_playevent", 1, 2, FEARG_1, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002694 ret_number, SOUND_FUNC(f_sound_playevent)},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002695 {"sound_playfile", 1, 2, FEARG_1, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002696 ret_number, SOUND_FUNC(f_sound_playfile)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002697 {"sound_stop", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002698 ret_void, SOUND_FUNC(f_sound_stop)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002699 {"soundfold", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002700 ret_string, f_soundfold},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002701 {"spellbadword", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002702 ret_list_string, f_spellbadword},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002703 {"spellsuggest", 1, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002704 ret_list_string, f_spellsuggest},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002705 {"split", 1, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002706 ret_list_string, f_split},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002707 {"sqrt", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002708 ret_float, f_sqrt},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002709 {"srand", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002710 ret_list_number, f_srand},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002711 {"state", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002712 ret_string, f_state},
Bram Moolenaar80a070c2021-08-08 15:51:10 +02002713 {"str2float", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002714 ret_float, f_str2float},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002715 {"str2list", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002716 ret_list_number, f_str2list},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002717 {"str2nr", 1, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002718 ret_number, f_str2nr},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002719 {"strcharlen", 1, 1, FEARG_1, arg1_string_or_nr,
Bram Moolenaar70ce8a12021-03-14 19:02:09 +01002720 ret_number, f_strcharlen},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002721 {"strcharpart", 2, 4, FEARG_1, arg24_strpart,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002722 ret_string, f_strcharpart},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002723 {"strchars", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002724 ret_number, f_strchars},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002725 {"strdisplaywidth", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002726 ret_number, f_strdisplaywidth},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002727 {"strftime", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002728 ret_string,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002729#ifdef HAVE_STRFTIME
Bram Moolenaar15c47602020-03-26 22:16:48 +01002730 f_strftime
2731#else
2732 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002733#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002734 },
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002735 {"strgetchar", 2, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002736 ret_number, f_strgetchar},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002737 {"stridx", 2, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002738 ret_number, f_stridx},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002739 {"string", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002740 ret_string, f_string},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002741 {"strlen", 1, 1, FEARG_1, arg1_string_or_nr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002742 ret_number, f_strlen},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002743 {"strpart", 2, 4, FEARG_1, arg24_strpart,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002744 ret_string, f_strpart},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002745 {"strptime", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002746 ret_number,
Bram Moolenaar10455d42019-11-21 15:36:18 +01002747#ifdef HAVE_STRPTIME
Bram Moolenaar15c47602020-03-26 22:16:48 +01002748 f_strptime
2749#else
2750 NULL
Bram Moolenaar10455d42019-11-21 15:36:18 +01002751#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002752 },
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002753 {"strridx", 2, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002754 ret_number, f_strridx},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002755 {"strtrans", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002756 ret_string, f_strtrans},
Christian Brabandt67672ef2023-04-24 21:09:54 +01002757 {"strutf16len", 1, 2, FEARG_1, arg2_string_bool,
2758 ret_number, f_strutf16len},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002759 {"strwidth", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002760 ret_number, f_strwidth},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002761 {"submatch", 1, 2, FEARG_1, arg2_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002762 ret_string, f_submatch},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002763 {"substitute", 4, 4, FEARG_1, arg4_string_string_any_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002764 ret_string, f_substitute},
Bram Moolenaarc216a7a2022-12-05 13:50:55 +00002765 {"swapfilelist", 0, 0, 0, NULL,
2766 ret_list_string, f_swapfilelist},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002767 {"swapinfo", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002768 ret_dict_any, f_swapinfo},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002769 {"swapname", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002770 ret_string, f_swapname},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002771 {"synID", 3, 3, 0, arg3_lnum_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002772 ret_number, f_synID},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002773 {"synIDattr", 2, 3, FEARG_1, arg3_number_string_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002774 ret_string, f_synIDattr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002775 {"synIDtrans", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002776 ret_number, f_synIDtrans},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002777 {"synconcealed", 2, 2, 0, arg2_lnum_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002778 ret_list_any, f_synconcealed},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002779 {"synstack", 2, 2, 0, arg2_lnum_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002780 ret_list_number, f_synstack},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002781 {"system", 1, 2, FEARG_1, arg12_system,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002782 ret_string, f_system},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002783 {"systemlist", 1, 2, FEARG_1, arg12_system,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002784 ret_list_string, f_systemlist},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002785 {"tabpagebuflist", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002786 ret_list_number, f_tabpagebuflist},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002787 {"tabpagenr", 0, 1, 0, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002788 ret_number, f_tabpagenr},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002789 {"tabpagewinnr", 1, 2, FEARG_1, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002790 ret_number, f_tabpagewinnr},
2791 {"tagfiles", 0, 0, 0, NULL,
2792 ret_list_string, f_tagfiles},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002793 {"taglist", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002794 ret_list_dict_any, f_taglist},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002795 {"tan", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002796 ret_float, f_tan},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002797 {"tanh", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002798 ret_float, f_tanh},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002799 {"tempname", 0, 0, 0, NULL,
2800 ret_string, f_tempname},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002801 {"term_dumpdiff", 2, 3, FEARG_1, arg3_string_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002802 ret_number, TERM_FUNC(f_term_dumpdiff)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002803 {"term_dumpload", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002804 ret_number, TERM_FUNC(f_term_dumpload)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002805 {"term_dumpwrite", 2, 3, FEARG_2, arg3_buffer_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002806 ret_void, TERM_FUNC(f_term_dumpwrite)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002807 {"term_getaltscreen", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002808 ret_number, TERM_FUNC(f_term_getaltscreen)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002809 {"term_getansicolors", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002810 ret_list_string,
Bram Moolenaarbd5e6222020-03-26 23:13:34 +01002811#if defined(FEAT_TERMINAL) && (defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS))
Bram Moolenaar15c47602020-03-26 22:16:48 +01002812 f_term_getansicolors
2813#else
2814 NULL
Bram Moolenaarc6df10e2017-07-29 20:15:08 +02002815#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002816 },
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002817 {"term_getattr", 2, 2, FEARG_1, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002818 ret_number, TERM_FUNC(f_term_getattr)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002819 {"term_getcursor", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002820 ret_list_any, TERM_FUNC(f_term_getcursor)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002821 {"term_getjob", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002822 ret_job, TERM_FUNC(f_term_getjob)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002823 {"term_getline", 2, 2, FEARG_1, arg2_buffer_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002824 ret_string, TERM_FUNC(f_term_getline)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002825 {"term_getscrolled", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002826 ret_number, TERM_FUNC(f_term_getscrolled)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002827 {"term_getsize", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002828 ret_list_number, TERM_FUNC(f_term_getsize)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002829 {"term_getstatus", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002830 ret_string, TERM_FUNC(f_term_getstatus)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002831 {"term_gettitle", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002832 ret_string, TERM_FUNC(f_term_gettitle)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002833 {"term_gettty", 1, 2, FEARG_1, arg2_buffer_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002834 ret_string, TERM_FUNC(f_term_gettty)},
2835 {"term_list", 0, 0, 0, NULL,
2836 ret_list_number, TERM_FUNC(f_term_list)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002837 {"term_scrape", 2, 2, FEARG_1, arg2_buffer_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002838 ret_list_dict_any, TERM_FUNC(f_term_scrape)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002839 {"term_sendkeys", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002840 ret_void, TERM_FUNC(f_term_sendkeys)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002841 {"term_setansicolors", 2, 2, FEARG_1, arg2_buffer_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002842 ret_void,
Bram Moolenaarbd5e6222020-03-26 23:13:34 +01002843#if defined(FEAT_TERMINAL) && (defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS))
Bram Moolenaar15c47602020-03-26 22:16:48 +01002844 f_term_setansicolors
2845#else
2846 NULL
2847#endif
2848 },
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002849 {"term_setapi", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002850 ret_void, TERM_FUNC(f_term_setapi)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002851 {"term_setkill", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002852 ret_void, TERM_FUNC(f_term_setkill)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002853 {"term_setrestore", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002854 ret_void, TERM_FUNC(f_term_setrestore)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002855 {"term_setsize", 3, 3, FEARG_1, arg3_buffer_number_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002856 ret_void, TERM_FUNC(f_term_setsize)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002857 {"term_start", 1, 2, FEARG_1, arg2_string_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002858 ret_number, TERM_FUNC(f_term_start)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002859 {"term_wait", 1, 2, FEARG_1, arg2_buffer_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002860 ret_void, TERM_FUNC(f_term_wait)},
2861 {"terminalprops", 0, 0, 0, NULL,
2862 ret_dict_string, f_terminalprops},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002863 {"test_alloc_fail", 3, 3, FEARG_1, arg3_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002864 ret_void, f_test_alloc_fail},
2865 {"test_autochdir", 0, 0, 0, NULL,
2866 ret_void, f_test_autochdir},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002867 {"test_feedinput", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002868 ret_void, f_test_feedinput},
2869 {"test_garbagecollect_now", 0, 0, 0, NULL,
2870 ret_void, f_test_garbagecollect_now},
2871 {"test_garbagecollect_soon", 0, 0, 0, NULL,
2872 ret_void, f_test_garbagecollect_soon},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002873 {"test_getvalue", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002874 ret_number, f_test_getvalue},
Yegappan Lakshmanan06011e12022-01-30 12:37:29 +00002875 {"test_gui_event", 2, 2, FEARG_1, arg2_string_dict,
2876 ret_bool, f_test_gui_event},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002877 {"test_ignore_error", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002878 ret_void, f_test_ignore_error},
Christopher Plewright20b795e2022-12-20 20:01:58 +00002879 {"test_mswin_event", 2, 2, FEARG_1, arg2_string_dict,
2880 ret_number, f_test_mswin_event},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002881 {"test_null_blob", 0, 0, 0, NULL,
2882 ret_blob, f_test_null_blob},
2883 {"test_null_channel", 0, 0, 0, NULL,
2884 ret_channel, JOB_FUNC(f_test_null_channel)},
2885 {"test_null_dict", 0, 0, 0, NULL,
2886 ret_dict_any, f_test_null_dict},
2887 {"test_null_function", 0, 0, 0, NULL,
2888 ret_func_any, f_test_null_function},
2889 {"test_null_job", 0, 0, 0, NULL,
2890 ret_job, JOB_FUNC(f_test_null_job)},
2891 {"test_null_list", 0, 0, 0, NULL,
2892 ret_list_any, f_test_null_list},
2893 {"test_null_partial", 0, 0, 0, NULL,
2894 ret_func_any, f_test_null_partial},
2895 {"test_null_string", 0, 0, 0, NULL,
2896 ret_string, f_test_null_string},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002897 {"test_option_not_set", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002898 ret_void, f_test_option_not_set},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002899 {"test_override", 2, 2, FEARG_2, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002900 ret_void, f_test_override},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002901 {"test_refcount", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002902 ret_number, f_test_refcount},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002903 {"test_setmouse", 2, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002904 ret_void, f_test_setmouse},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002905 {"test_settime", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002906 ret_void, f_test_settime},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002907 {"test_srand_seed", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002908 ret_void, f_test_srand_seed},
2909 {"test_unknown", 0, 0, 0, NULL,
2910 ret_any, f_test_unknown},
2911 {"test_void", 0, 0, 0, NULL,
2912 ret_void, f_test_void},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002913 {"timer_info", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002914 ret_list_dict_any, TIMER_FUNC(f_timer_info)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002915 {"timer_pause", 2, 2, FEARG_1, arg2_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002916 ret_void, TIMER_FUNC(f_timer_pause)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002917 {"timer_start", 2, 3, FEARG_1, arg3_number_any_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002918 ret_number, TIMER_FUNC(f_timer_start)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002919 {"timer_stop", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002920 ret_void, TIMER_FUNC(f_timer_stop)},
2921 {"timer_stopall", 0, 0, 0, NULL,
2922 ret_void, TIMER_FUNC(f_timer_stopall)},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002923 {"tolower", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002924 ret_string, f_tolower},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002925 {"toupper", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002926 ret_string, f_toupper},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002927 {"tr", 3, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002928 ret_string, f_tr},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002929 {"trim", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002930 ret_string, f_trim},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002931 {"trunc", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002932 ret_float, f_trunc},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002933 {"type", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002934 ret_number, f_type},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002935 {"typename", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaara47e05f2021-01-12 21:49:00 +01002936 ret_string, f_typename},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002937 {"undofile", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002938 ret_string, f_undofile},
Devin J. Pohly5fee1112023-04-23 20:26:59 -05002939 {"undotree", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002940 ret_dict_any, f_undotree},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002941 {"uniq", 1, 3, FEARG_1, arg13_sortuniq,
Bram Moolenaar08018222021-12-22 18:45:37 +00002942 ret_first_arg, f_uniq},
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01002943 {"utf16idx", 2, 4, FEARG_1, arg4_string_number_bool_bool,
Christian Brabandt67672ef2023-04-24 21:09:54 +01002944 ret_number, f_utf16idx},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002945 {"values", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar32517c42023-01-15 18:17:12 +00002946 ret_list_member, f_values},
zeertzjq825cf812023-08-17 22:55:25 +02002947 {"virtcol", 1, 3, FEARG_1, arg3_string_or_list_bool_number,
LemonBoy0f7a3e12022-05-26 12:10:37 +01002948 ret_virtcol, f_virtcol},
Bram Moolenaar5a6ec102022-05-27 21:58:00 +01002949 {"virtcol2col", 3, 3, FEARG_1, arg3_number,
2950 ret_number, f_virtcol2col},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002951 {"visualmode", 0, 1, 0, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002952 ret_string, f_visualmode},
2953 {"wildmenumode", 0, 0, 0, NULL,
2954 ret_number, f_wildmenumode},
Bram Moolenaar52312242021-07-11 18:23:19 +02002955 {"win_execute", 2, 3, FEARG_2, arg23_win_execute,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002956 ret_string, f_win_execute},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002957 {"win_findbuf", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002958 ret_list_number, f_win_findbuf},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002959 {"win_getid", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002960 ret_number, f_win_getid},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002961 {"win_gettype", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002962 ret_string, f_win_gettype},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002963 {"win_gotoid", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002964 ret_number_bool, f_win_gotoid},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002965 {"win_id2tabwin", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002966 ret_list_number, f_win_id2tabwin},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002967 {"win_id2win", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002968 ret_number, f_win_id2win},
Daniel Steinbergee630312022-01-10 13:36:34 +00002969 {"win_move_separator", 2, 2, FEARG_1, arg2_number,
2970 ret_number_bool, f_win_move_separator},
2971 {"win_move_statusline", 2, 2, FEARG_1, arg2_number,
2972 ret_number_bool, f_win_move_statusline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002973 {"win_screenpos", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002974 ret_list_number, f_win_screenpos},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002975 {"win_splitmove", 2, 3, FEARG_1, arg3_number_number_dict,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002976 ret_number_bool, f_win_splitmove},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002977 {"winbufnr", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002978 ret_number, f_winbufnr},
2979 {"wincol", 0, 0, 0, NULL,
2980 ret_number, f_wincol},
2981 {"windowsversion", 0, 0, 0, NULL,
2982 ret_string, f_windowsversion},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002983 {"winheight", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002984 ret_number, f_winheight},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002985 {"winlayout", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002986 ret_list_any, f_winlayout},
2987 {"winline", 0, 0, 0, NULL,
2988 ret_number, f_winline},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002989 {"winnr", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002990 ret_number, f_winnr},
2991 {"winrestcmd", 0, 0, 0, NULL,
2992 ret_string, f_winrestcmd},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002993 {"winrestview", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002994 ret_void, f_winrestview},
2995 {"winsaveview", 0, 0, 0, NULL,
Bram Moolenaar43b69b32021-01-07 20:23:33 +01002996 ret_dict_number, f_winsaveview},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002997 {"winwidth", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002998 ret_number, f_winwidth},
2999 {"wordcount", 0, 0, 0, NULL,
3000 ret_dict_number, f_wordcount},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02003001 {"writefile", 2, 3, FEARG_1, arg23_writefile,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01003002 ret_number_bool, f_writefile},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003003 {"xor", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003004 ret_number, f_xor},
Bram Moolenaarac92e252019-08-03 21:58:38 +02003005};
3006
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003007/*
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003008 * Return true if specified function allows a type as an argument.
3009 */
3010 static int
3011func_allows_type(int idx)
3012{
3013 return (global_functions[idx].f_argtype & FE_X) != 0;
3014}
3015
3016/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003017 * Function given to ExpandGeneric() to obtain the list of internal
3018 * or user defined function names.
3019 */
3020 char_u *
3021get_function_name(expand_T *xp, int idx)
3022{
3023 static int intidx = -1;
3024 char_u *name;
3025
3026 if (idx == 0)
3027 intidx = -1;
3028 if (intidx < 0)
3029 {
3030 name = get_user_func_name(xp, idx);
naohiro ono5aec7552021-08-19 21:20:41 +02003031 if (name != NULL)
Bram Moolenaar1bb4de52021-01-13 19:48:46 +01003032 {
naohiro ono5aec7552021-08-19 21:20:41 +02003033 if (*name != NUL && *name != '<'
3034 && STRNCMP("g:", xp->xp_pattern, 2) == 0)
Bram Moolenaar1bb4de52021-01-13 19:48:46 +01003035 return cat_prefix_varname('g', name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003036 return name;
Bram Moolenaar1bb4de52021-01-13 19:48:46 +01003037 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003038 }
K.Takataeeec2542021-06-02 13:28:16 +02003039 if (++intidx < (int)ARRAY_LENGTH(global_functions))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003040 {
Kota Kato90c23532023-01-18 15:27:38 +00003041 // Skip if the function doesn't have an implementation (feature not
3042 // implemented).
3043 if (global_functions[intidx].f_func == NULL)
3044 return (char_u *)"";
Bram Moolenaarac92e252019-08-03 21:58:38 +02003045 STRCPY(IObuff, global_functions[intidx].f_name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003046 STRCAT(IObuff, "(");
Bram Moolenaarac92e252019-08-03 21:58:38 +02003047 if (global_functions[intidx].f_max_argc == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003048 STRCAT(IObuff, ")");
3049 return IObuff;
3050 }
3051
3052 return NULL;
3053}
3054
3055/*
3056 * Function given to ExpandGeneric() to obtain the list of internal or
3057 * user defined variable or function names.
3058 */
3059 char_u *
3060get_expr_name(expand_T *xp, int idx)
3061{
3062 static int intidx = -1;
3063 char_u *name;
3064
3065 if (idx == 0)
3066 intidx = -1;
3067 if (intidx < 0)
3068 {
3069 name = get_function_name(xp, idx);
3070 if (name != NULL)
3071 return name;
3072 }
3073 return get_user_var_name(xp, ++intidx);
3074}
3075
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003076/*
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003077 * Find internal function "name" in table "global_functions".
Bram Moolenaar15c47602020-03-26 22:16:48 +01003078 * Return index, or -1 if not found or "implemented" is TRUE and the function
3079 * is not implemented.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003080 */
Bram Moolenaar15c47602020-03-26 22:16:48 +01003081 static int
3082find_internal_func_opt(char_u *name, int implemented)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003083{
3084 int first = 0;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003085 int last;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003086 int cmp;
3087 int x;
3088
K.Takataeeec2542021-06-02 13:28:16 +02003089 last = (int)ARRAY_LENGTH(global_functions) - 1;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003090
3091 // Find the function name in the table. Binary search.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003092 while (first <= last)
3093 {
3094 x = first + ((unsigned)(last - first) >> 1);
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003095 cmp = STRCMP(name, global_functions[x].f_name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003096 if (cmp < 0)
3097 last = x - 1;
3098 else if (cmp > 0)
3099 first = x + 1;
Bram Moolenaar15c47602020-03-26 22:16:48 +01003100 else if (implemented && global_functions[x].f_func == NULL)
3101 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003102 else
3103 return x;
3104 }
3105 return -1;
3106}
3107
Bram Moolenaar15c47602020-03-26 22:16:48 +01003108/*
3109 * Find internal function "name" in table "global_functions".
3110 * Return index, or -1 if not found or the function is not implemented.
3111 */
3112 int
3113find_internal_func(char_u *name)
3114{
3115 return find_internal_func_opt(name, TRUE);
3116}
3117
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003118 int
Bram Moolenaarac92e252019-08-03 21:58:38 +02003119has_internal_func(char_u *name)
3120{
Bram Moolenaar15c47602020-03-26 22:16:48 +01003121 return find_internal_func_opt(name, TRUE) >= 0;
3122}
3123
3124 static int
3125has_internal_func_name(char_u *name)
3126{
3127 return find_internal_func_opt(name, FALSE) >= 0;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003128}
3129
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003130 char *
3131internal_func_name(int idx)
3132{
3133 return global_functions[idx].f_name;
3134}
3135
Bram Moolenaar94738d82020-10-21 14:25:07 +02003136/*
Dominique Pellefe8ebdb2021-05-13 14:55:55 +02003137 * Check the argument types for builtin function "idx".
Bram Moolenaar94738d82020-10-21 14:25:07 +02003138 * Uses the list of types on the type stack: "types".
3139 * Return FAIL and gives an error message when a type is wrong.
3140 */
3141 int
Bram Moolenaar351ead02021-01-16 16:07:01 +01003142internal_func_check_arg_types(
Bram Moolenaar078a4612022-01-04 15:17:03 +00003143 type2_T *types,
Bram Moolenaar351ead02021-01-16 16:07:01 +01003144 int idx,
3145 int argcount,
3146 cctx_T *cctx)
Bram Moolenaar94738d82020-10-21 14:25:07 +02003147{
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003148 // Some internal functions accept types like Class as arguments. For other
3149 // functions, check the arguments are not types.
3150 if (!(func_allows_type(idx)))
3151 {
zeertzjqd9be94c2024-07-14 10:20:20 +02003152 for (int i = 0; i < argcount; ++i)
3153 if (check_type_is_value(types[i].type_curr) == FAIL)
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003154 return FAIL;
3155 }
3156
Bram Moolenaar94738d82020-10-21 14:25:07 +02003157 argcheck_T *argchecks = global_functions[idx].f_argcheck;
Bram Moolenaar94738d82020-10-21 14:25:07 +02003158
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003159 if (argchecks == NULL)
3160 return OK;
Bram Moolenaar94738d82020-10-21 14:25:07 +02003161
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003162 argcontext_T context;
3163
3164 context.arg_count = argcount;
3165 context.arg_types = types;
3166 context.arg_cctx = cctx;
Ernie Raela8f7f922023-12-14 20:17:04 +01003167 for (int i = 0; i < argcount && argchecks[i] != NULL; ++i)
3168 {
3169 context.arg_idx = i;
3170 if (argchecks[i](types[i].type_curr, types[i].type_decl,
3171 &context) == FAIL)
3172 return FAIL;
3173 }
Bram Moolenaar94738d82020-10-21 14:25:07 +02003174 return OK;
3175}
3176
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003177/*
Bram Moolenaar7a40ff02021-07-04 15:54:08 +02003178 * Get the argument count for function "idx".
3179 * "argcount" is the total argument count, "min_argcount" the non-optional
3180 * argument count.
3181 */
3182 void
3183internal_func_get_argcount(int idx, int *argcount, int *min_argcount)
3184{
3185 *argcount = global_functions[idx].f_max_argc;
3186 *min_argcount = global_functions[idx].f_min_argc;
3187}
3188
3189/*
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003190 * Call the "f_retfunc" function to obtain the return type of function "idx".
Bram Moolenaar81330182022-02-01 12:11:58 +00003191 * "decl_type" is set to the declared type.
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003192 * "argtypes" is the list of argument types or NULL when there are no
3193 * arguments.
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02003194 * "argcount" may be less than the actual count when only getting the type.
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003195 */
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003196 type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00003197internal_func_ret_type(
3198 int idx,
3199 int argcount,
3200 type2_T *argtypes,
Bram Moolenaar32517c42023-01-15 18:17:12 +00003201 type_T **decl_type,
3202 garray_T *type_gap)
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003203{
Bram Moolenaar81330182022-02-01 12:11:58 +00003204 type_T *ret;
3205
Bram Moolenaar32517c42023-01-15 18:17:12 +00003206 current_type_gap = type_gap;
Bram Moolenaar81330182022-02-01 12:11:58 +00003207 *decl_type = NULL;
3208 ret = global_functions[idx].f_retfunc(argcount, argtypes, decl_type);
3209 if (*decl_type == NULL)
3210 *decl_type = ret;
Bram Moolenaar32517c42023-01-15 18:17:12 +00003211 current_type_gap = NULL;
Bram Moolenaar81330182022-02-01 12:11:58 +00003212 return ret;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003213}
3214
3215/*
Bram Moolenaar75ab91f2021-01-10 22:42:50 +01003216 * Return TRUE if "idx" is for the map() function.
3217 */
3218 int
3219internal_func_is_map(int idx)
3220{
3221 return global_functions[idx].f_func == f_map;
3222}
3223
3224/*
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003225 * Check the argument count to use for internal function "idx".
Bram Moolenaar389df252020-07-09 21:20:47 +02003226 * Returns -1 for failure, 0 if no method base accepted, 1 if method base is
3227 * first argument, 2 if method base is second argument, etc. 9 if method base
3228 * is last argument.
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003229 */
3230 int
3231check_internal_func(int idx, int argcount)
3232{
Bram Moolenaar0917e862023-02-18 14:42:44 +00003233 funcerror_T res;
3234 char *name;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003235
3236 if (argcount < global_functions[idx].f_min_argc)
3237 res = FCERR_TOOFEW;
3238 else if (argcount > global_functions[idx].f_max_argc)
3239 res = FCERR_TOOMANY;
3240 else
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003241 return global_functions[idx].f_argtype & FEARG_MASK;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003242
3243 name = internal_func_name(idx);
3244 if (res == FCERR_TOOMANY)
Bram Moolenaare1242042021-12-16 20:56:57 +00003245 semsg(_(e_too_many_arguments_for_function_str), name);
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003246 else
Bram Moolenaare1242042021-12-16 20:56:57 +00003247 semsg(_(e_not_enough_arguments_for_function_str), name);
Bram Moolenaar389df252020-07-09 21:20:47 +02003248 return -1;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003249}
3250
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003251/*
3252 * Some internal functions accept types like Class as arguments. For other
3253 * functions, check the arguments are not types.
3254 *
3255 * Return OK/FAIL.
3256 */
3257 static int
3258check_args_for_type(int idx, int argcount, typval_T *argvars)
3259{
3260 if (!func_allows_type(idx))
3261 {
3262 for (int i = 0; i < argcount; ++i)
3263 if (check_typval_is_value(&argvars[i]) == FAIL)
3264 return FAIL;
3265 }
3266 return OK;
3267}
3268
Bram Moolenaar0917e862023-02-18 14:42:44 +00003269 funcerror_T
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003270call_internal_func(
3271 char_u *name,
3272 int argcount,
3273 typval_T *argvars,
3274 typval_T *rettv)
3275{
3276 int i;
3277
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003278 i = find_internal_func(name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003279 if (i < 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01003280 return FCERR_UNKNOWN;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003281 if (argcount < global_functions[i].f_min_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003282 return FCERR_TOOFEW;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003283 if (argcount > global_functions[i].f_max_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003284 return FCERR_TOOMANY;
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003285 if (check_args_for_type(i, argcount, argvars) == FAIL)
3286 return FCERR_OTHER;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003287 argvars[argcount].v_type = VAR_UNKNOWN;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003288 global_functions[i].f_func(argvars, rettv);
Bram Moolenaaref140542019-12-31 21:27:13 +01003289 return FCERR_NONE;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003290}
3291
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003292 void
3293call_internal_func_by_idx(
3294 int idx,
3295 typval_T *argvars,
3296 typval_T *rettv)
3297{
3298 global_functions[idx].f_func(argvars, rettv);
3299}
3300
Bram Moolenaarac92e252019-08-03 21:58:38 +02003301/*
3302 * Invoke a method for base->method().
3303 */
Bram Moolenaar0917e862023-02-18 14:42:44 +00003304 funcerror_T
Bram Moolenaarac92e252019-08-03 21:58:38 +02003305call_internal_method(
3306 char_u *name,
3307 int argcount,
3308 typval_T *argvars,
3309 typval_T *rettv,
3310 typval_T *basetv)
3311{
Bram Moolenaarac92e252019-08-03 21:58:38 +02003312 int fi;
3313 typval_T argv[MAX_FUNC_ARGS + 1];
3314
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003315 fi = find_internal_func(name);
Bram Moolenaar91746392019-08-16 22:22:31 +02003316 if (fi < 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01003317 return FCERR_UNKNOWN;
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003318 if ((global_functions[fi].f_argtype & FEARG_MASK) == 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01003319 return FCERR_NOTMETHOD;
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003320 if (argcount + 1 < global_functions[fi].f_min_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003321 return FCERR_TOOFEW;
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003322 if (argcount + 1 > global_functions[fi].f_max_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003323 return FCERR_TOOMANY;
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003324 if (check_args_for_type(fi, argcount, argvars) == FAIL)
3325 return FCERR_OTHER;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003326
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003327 if ((global_functions[fi].f_argtype & FEARG_MASK) == FEARG_2)
Bram Moolenaar25e42232019-08-04 15:04:10 +02003328 {
Bram Moolenaarb7f22702023-04-27 16:24:07 +01003329 if (argcount < 1)
3330 return FCERR_TOOFEW;
3331
Bram Moolenaar25e42232019-08-04 15:04:10 +02003332 // base value goes second
3333 argv[0] = argvars[0];
3334 argv[1] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003335 for (int i = 1; i < argcount; ++i)
Bram Moolenaar25e42232019-08-04 15:04:10 +02003336 argv[i + 1] = argvars[i];
3337 }
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003338 else if ((global_functions[fi].f_argtype & FEARG_MASK) == FEARG_3)
Bram Moolenaar24278d22019-08-16 21:49:22 +02003339 {
Bram Moolenaarb7f22702023-04-27 16:24:07 +01003340 if (argcount < 2)
3341 return FCERR_TOOFEW;
3342
Bram Moolenaar24278d22019-08-16 21:49:22 +02003343 // base value goes third
3344 argv[0] = argvars[0];
3345 argv[1] = argvars[1];
3346 argv[2] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003347 for (int i = 2; i < argcount; ++i)
Bram Moolenaar24278d22019-08-16 21:49:22 +02003348 argv[i + 1] = argvars[i];
3349 }
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003350 else if ((global_functions[fi].f_argtype & FEARG_MASK) == FEARG_4)
Bram Moolenaaraad222c2019-09-06 22:46:09 +02003351 {
Bram Moolenaarb7f22702023-04-27 16:24:07 +01003352 if (argcount < 3)
3353 return FCERR_TOOFEW;
3354
Bram Moolenaaraad222c2019-09-06 22:46:09 +02003355 // base value goes fourth
3356 argv[0] = argvars[0];
3357 argv[1] = argvars[1];
3358 argv[2] = argvars[2];
3359 argv[3] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003360 for (int i = 3; i < argcount; ++i)
Bram Moolenaaraad222c2019-09-06 22:46:09 +02003361 argv[i + 1] = argvars[i];
3362 }
Bram Moolenaar25e42232019-08-04 15:04:10 +02003363 else
3364 {
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003365 // FEARG_1: base value goes first
Bram Moolenaar25e42232019-08-04 15:04:10 +02003366 argv[0] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003367 for (int i = 0; i < argcount; ++i)
Bram Moolenaar25e42232019-08-04 15:04:10 +02003368 argv[i + 1] = argvars[i];
3369 }
Bram Moolenaarac92e252019-08-03 21:58:38 +02003370 argv[argcount + 1].v_type = VAR_UNKNOWN;
3371
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003372 if (check_args_for_type(fi, argcount + 1, argv) == FAIL)
3373 return FCERR_OTHER;
3374
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003375 global_functions[fi].f_func(argv, rettv);
Bram Moolenaaref140542019-12-31 21:27:13 +01003376 return FCERR_NONE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003377}
3378
3379/*
3380 * Return TRUE for a non-zero Number and a non-empty String.
3381 */
Bram Moolenaar0e57dd82019-09-16 22:56:03 +02003382 int
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003383non_zero_arg(typval_T *argvars)
3384{
3385 return ((argvars[0].v_type == VAR_NUMBER
3386 && argvars[0].vval.v_number != 0)
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01003387 || (argvars[0].v_type == VAR_BOOL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003388 && argvars[0].vval.v_number == VVAL_TRUE)
3389 || (argvars[0].v_type == VAR_STRING
3390 && argvars[0].vval.v_string != NULL
3391 && *argvars[0].vval.v_string != NUL));
3392}
3393
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003394/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003395 * "and(expr, expr)" function
3396 */
3397 static void
3398f_and(typval_T *argvars, typval_T *rettv)
3399{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003400 if (in_vim9script()
3401 && (check_for_number_arg(argvars, 0) == FAIL
3402 || check_for_number_arg(argvars, 1) == FAIL))
3403 return;
3404
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003405 rettv->vval.v_number = tv_get_number_chk(&argvars[0], NULL)
3406 & tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaarca851592018-06-06 21:04:07 +02003407}
3408
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003409/*
Bram Moolenaar59716a22017-03-01 20:32:44 +01003410 * "balloon_show()" function
3411 */
3412#ifdef FEAT_BEVAL
3413 static void
Bram Moolenaarbe0a2592019-05-09 13:50:16 +02003414f_balloon_gettext(typval_T *argvars UNUSED, typval_T *rettv)
3415{
3416 rettv->v_type = VAR_STRING;
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003417 if (balloonEval == NULL)
3418 return;
3419
3420 if (balloonEval->msg == NULL)
3421 rettv->vval.v_string = NULL;
3422 else
3423 rettv->vval.v_string = vim_strsave(balloonEval->msg);
Bram Moolenaarbe0a2592019-05-09 13:50:16 +02003424}
3425
3426 static void
Bram Moolenaar59716a22017-03-01 20:32:44 +01003427f_balloon_show(typval_T *argvars, typval_T *rettv UNUSED)
3428{
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003429 if (balloonEval == NULL)
3430 return;
3431
3432 if (in_vim9script()
3433 && check_for_string_or_list_arg(argvars, 0) == FAIL)
3434 return;
3435
3436 if (argvars[0].v_type == VAR_LIST
3437# ifdef FEAT_GUI
3438 && !gui.in_use
3439# endif
3440 )
Bram Moolenaar246fe032017-11-19 19:56:27 +01003441 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003442 list_T *l = argvars[0].vval.v_list;
3443
3444 // empty list removes the balloon
3445 post_balloon(balloonEval, NULL,
3446 l == NULL || l->lv_len == 0 ? NULL : l);
3447 }
3448 else
3449 {
3450 char_u *mesg;
3451
3452 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003453 return;
3454
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003455 mesg = tv_get_string_chk(&argvars[0]);
3456 if (mesg != NULL)
3457 // empty string removes the balloon
3458 post_balloon(balloonEval, *mesg == NUL ? NULL : mesg, NULL);
Bram Moolenaar246fe032017-11-19 19:56:27 +01003459 }
3460}
3461
Bram Moolenaar669a8282017-11-19 20:13:05 +01003462# if defined(FEAT_BEVAL_TERM)
Bram Moolenaar246fe032017-11-19 19:56:27 +01003463 static void
3464f_balloon_split(typval_T *argvars, typval_T *rettv UNUSED)
3465{
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003466 if (rettv_list_alloc(rettv) != OK)
3467 return;
3468
3469 char_u *msg;
3470
3471 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
3472 return;
3473 msg = tv_get_string_chk(&argvars[0]);
3474 if (msg != NULL)
Bram Moolenaar246fe032017-11-19 19:56:27 +01003475 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003476 pumitem_T *array;
3477 int size = split_message(msg, &array);
Bram Moolenaar246fe032017-11-19 19:56:27 +01003478
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003479 // Skip the first and last item, they are always empty.
3480 for (int i = 1; i < size - 1; ++i)
3481 list_append_string(rettv->vval.v_list, array[i].pum_text, -1);
3482 while (size > 0)
3483 vim_free(array[--size].pum_text);
3484 vim_free(array);
Bram Moolenaar246fe032017-11-19 19:56:27 +01003485 }
Bram Moolenaar59716a22017-03-01 20:32:44 +01003486}
Bram Moolenaar669a8282017-11-19 20:13:05 +01003487# endif
Bram Moolenaar59716a22017-03-01 20:32:44 +01003488#endif
3489
Yegappan Lakshmanan810785c2024-12-30 10:29:44 +01003490// Base64 character set
3491static const char_u base64_table[] = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
3492
3493// Base64 decoding table (initialized in init_base64_dec_table() below)
3494static char_u base64_dec_table[256];
3495
3496/*
3497 * Initialize the base64 decoding table
3498 */
3499 static void
3500init_base64_dec_table(void)
3501{
3502 static int base64_dec_tbl_initialized = FALSE;
3503
3504 if (base64_dec_tbl_initialized)
3505 return;
3506
3507 // Unsupported characters are set to 0xFF
3508 vim_memset(base64_dec_table, 0xFF, sizeof(base64_dec_table));
3509
3510 // Initialize the index for the base64 alphabets
3511 for (size_t i = 0; i < sizeof(base64_table) - 1; i++)
3512 base64_dec_table[(char_u)base64_table[i]] = (char_u)i;
3513
3514 // base64 padding character
3515 base64_dec_table['='] = 0;
3516
3517 base64_dec_tbl_initialized = TRUE;
3518}
3519
3520/*
3521 * Encode the bytes in "blob" using base-64 encoding.
3522 */
3523 static char_u *
3524base64_encode(blob_T *blob)
3525{
3526 size_t input_len = blob->bv_ga.ga_len;
3527 size_t encoded_len = ((input_len + 2) / 3) * 4;
3528 char_u *data = blob->bv_ga.ga_data;
3529
3530 char_u *encoded = alloc(encoded_len + 1);
3531 if (encoded == NULL)
3532 return NULL;
3533
3534 size_t i, j;
3535 for (i = 0, j = 0; i < input_len;)
3536 {
3537 int_u octet_a = i < input_len ? data[i++] : 0;
3538 int_u octet_b = i < input_len ? data[i++] : 0;
3539 int_u octet_c = i < input_len ? data[i++] : 0;
3540
3541 int_u triple = (octet_a << 16) | (octet_b << 8) | octet_c;
3542
3543 encoded[j++] = base64_table[(triple >> 18) & 0x3F];
3544 encoded[j++] = base64_table[(triple >> 12) & 0x3F];
3545 encoded[j++] = (!octet_b && i >= input_len) ? '='
3546 : base64_table[(triple >> 6) & 0x3F];
3547 encoded[j++] = (!octet_c && i >= input_len) ? '='
3548 : base64_table[triple & 0x3F];
3549 }
3550 encoded[j] = NUL;
3551
3552 return encoded;
3553}
3554
3555/*
3556 * Decode the string "data" using base-64 encoding.
3557 */
3558 static void
3559base64_decode(const char_u *data, blob_T *blob)
3560{
3561 size_t input_len = STRLEN(data);
3562
3563 if (input_len == 0)
3564 return;
3565
3566 if (input_len % 4 != 0)
3567 {
3568 // Invalid input length
3569 semsg(_(e_invalid_argument_str), data);
3570 return;
3571 }
3572
3573 init_base64_dec_table();
3574
3575 size_t decoded_len = (input_len / 4) * 3;
3576 if (data[input_len - 1] == '=')
3577 decoded_len--;
3578 if (data[input_len - 2] == '=')
3579 decoded_len--;
3580
3581 size_t i, j;
3582 for (i = 0, j = 0; i < input_len;)
3583 {
3584 int_u sextet_a = base64_dec_table[(char_u)data[i++]];
3585 int_u sextet_b = base64_dec_table[(char_u)data[i++]];
3586 int_u sextet_c = base64_dec_table[(char_u)data[i++]];
3587 int_u sextet_d = base64_dec_table[(char_u)data[i++]];
3588
3589 if (sextet_a == 0xFF || sextet_b == 0xFF || sextet_c == 0xFF
3590 || sextet_d == 0xFF)
3591 {
3592 // Invalid character
3593 semsg(_(e_invalid_argument_str), data);
3594 ga_clear(&blob->bv_ga);
3595 return;
3596 }
3597
3598 int_u triple = (sextet_a << 18) | (sextet_b << 12)
3599 | (sextet_c << 6) | sextet_d;
3600
3601 if (j < decoded_len)
3602 {
3603 ga_append(&blob->bv_ga, (triple >> 16) & 0xFF);
3604 j++;
3605 }
3606 if (j < decoded_len)
3607 {
3608 ga_append(&blob->bv_ga, (triple >> 8) & 0xFF);
3609 j++;
3610 }
3611 if (j < decoded_len)
3612 {
3613 ga_append(&blob->bv_ga, triple & 0xFF);
3614 j++;
3615 }
3616
3617 if (j == decoded_len)
3618 {
3619 // Check for invalid padding bytes (based on the
3620 // "Base64 Malleability in Practice" ACM paper).
3621 if ((data[input_len - 2] == '=' && ((sextet_b & 0xF) != 0))
3622 || ((data[input_len - 1] == '=') && ((sextet_c & 0x3) != 0)))
3623 {
3624 semsg(_(e_invalid_argument_str), data);
3625 ga_clear(&blob->bv_ga);
3626 return;
3627 }
3628 }
3629 }
3630}
3631
3632/*
3633 * "base64_decode(string)" function
3634 */
3635 static void
3636f_base64_decode(typval_T *argvars, typval_T *rettv)
3637{
3638 if (check_for_string_arg(argvars, 0) == FAIL)
3639 return;
3640
3641 if (rettv_blob_alloc(rettv) == FAIL)
3642 return;
3643
3644 char_u *str = tv_get_string_chk(&argvars[0]);
3645 if (str != NULL)
3646 base64_decode(str, rettv->vval.v_blob);
3647}
3648
3649/*
3650 * "base64_encode(blob)" function
3651 */
3652 static void
3653f_base64_encode(typval_T *argvars, typval_T *rettv)
3654{
3655 if (check_for_blob_arg(argvars, 0) == FAIL)
3656 return;
3657
3658 rettv->v_type = VAR_STRING;
3659 rettv->vval.v_string = NULL;
3660
3661 blob_T *blob = argvars->vval.v_blob;
3662 if (blob != NULL)
3663 rettv->vval.v_string = base64_encode(blob);
3664}
3665
Bram Moolenaar59716a22017-03-01 20:32:44 +01003666/*
Bram Moolenaar6b7b7192019-01-11 13:42:41 +01003667 * Get the buffer from "arg" and give an error and return NULL if it is not
3668 * valid.
3669 */
Bram Moolenaara3347722019-05-11 21:14:24 +02003670 buf_T *
Bram Moolenaar6b7b7192019-01-11 13:42:41 +01003671get_buf_arg(typval_T *arg)
3672{
3673 buf_T *buf;
3674
3675 ++emsg_off;
3676 buf = tv_get_buf(arg, FALSE);
3677 --emsg_off;
3678 if (buf == NULL)
Bram Moolenaard82a47d2022-01-05 20:24:39 +00003679 semsg(_(e_invalid_buffer_name_str), tv_get_string(arg));
Bram Moolenaar6b7b7192019-01-11 13:42:41 +01003680 return buf;
3681}
3682
3683/*
Christ van Willegence0ef912024-06-20 23:41:59 +02003684 * "bindtextdomain(package, path)" function
3685 */
3686 static void
Christ van Willegen8252ef12024-07-11 21:36:21 +02003687f_bindtextdomain(typval_T *argvars, typval_T *rettv)
Christ van Willegence0ef912024-06-20 23:41:59 +02003688{
Christ van Willegen8252ef12024-07-11 21:36:21 +02003689 rettv->v_type = VAR_BOOL;
3690 rettv->vval.v_number = VVAL_TRUE;
3691
Christ van Willegence0ef912024-06-20 23:41:59 +02003692 if (check_for_nonempty_string_arg(argvars, 0) == FAIL
3693 || check_for_nonempty_string_arg(argvars, 1) == FAIL)
3694 return;
3695
3696 if (strcmp((const char *)argvars[0].vval.v_string, VIMPACKAGE) == 0)
3697 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[0]));
3698 else
Christ van Willegen8252ef12024-07-11 21:36:21 +02003699 {
3700 if (bindtextdomain((const char *)argvars[0].vval.v_string, (const char *)argvars[1].vval.v_string) == NULL)
3701 {
3702 do_outofmem_msg((long)0);
3703 rettv->vval.v_number = VVAL_FALSE;
3704 }
3705 }
Christ van Willegence0ef912024-06-20 23:41:59 +02003706
3707 return;
3708}
3709
3710/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003711 * "byte2line(byte)" function
3712 */
3713 static void
3714f_byte2line(typval_T *argvars UNUSED, typval_T *rettv)
3715{
3716#ifndef FEAT_BYTEOFF
3717 rettv->vval.v_number = -1;
3718#else
3719 long boff = 0;
3720
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003721 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
3722 return;
3723
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01003724 boff = tv_get_number(&argvars[0]) - 1; // boff gets -1 on type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003725 if (boff < 0)
3726 rettv->vval.v_number = -1;
3727 else
3728 rettv->vval.v_number = ml_find_line_or_offset(curbuf,
3729 (linenr_T)0, &boff);
3730#endif
3731}
3732
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003733/*
3734 * "call(func, arglist [, dict])" function
3735 */
3736 static void
3737f_call(typval_T *argvars, typval_T *rettv)
3738{
3739 char_u *func;
3740 partial_T *partial = NULL;
3741 dict_T *selfdict = NULL;
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003742 char_u *tofree = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003743
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02003744 if (in_vim9script()
Bram Moolenaar223d0a62021-12-25 19:29:21 +00003745 && (check_for_string_or_func_arg(argvars, 0) == FAIL
3746 || check_for_list_arg(argvars, 1) == FAIL
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02003747 || check_for_opt_dict_arg(argvars, 2) == FAIL))
3748 return;
3749
Bram Moolenaard83392a2022-09-01 12:22:46 +01003750 if (check_for_list_arg(argvars, 1) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003751 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003752 if (argvars[1].vval.v_list == NULL)
3753 return;
3754
3755 if (argvars[0].v_type == VAR_FUNC)
3756 func = argvars[0].vval.v_string;
3757 else if (argvars[0].v_type == VAR_PARTIAL)
3758 {
3759 partial = argvars[0].vval.v_partial;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02003760 func = partial_name(partial);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003761 }
3762 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003763 func = tv_get_string(&argvars[0]);
Dominique Pellefe8ebdb2021-05-13 14:55:55 +02003764 if (func == NULL || *func == NUL)
3765 return; // type error, empty name or null function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003766
Yegappan Lakshmanan6289f912025-01-14 17:13:36 +01003767 char_u *p = func;
3768 tofree = trans_function_name(&p, NULL, FALSE, TFN_INT|TFN_QUIET);
3769 if (tofree == NULL)
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003770 {
Yegappan Lakshmanan6289f912025-01-14 17:13:36 +01003771 emsg_funcname(e_unknown_function_str, func);
3772 return;
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003773 }
Yegappan Lakshmanan6289f912025-01-14 17:13:36 +01003774 func = tofree;
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003775
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003776 if (argvars[2].v_type != VAR_UNKNOWN)
3777 {
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +01003778 if (check_for_dict_arg(argvars, 2) == FAIL)
Yegappan Lakshmanan6289f912025-01-14 17:13:36 +01003779 goto done;
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +01003780
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003781 selfdict = argvars[2].vval.v_dict;
3782 }
3783
3784 (void)func_call(func, &argvars[1], partial, selfdict, rettv);
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003785
Yegappan Lakshmanan6289f912025-01-14 17:13:36 +01003786done:
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003787 vim_free(tofree);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003788}
3789
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003790/*
3791 * "changenr()" function
3792 */
3793 static void
3794f_changenr(typval_T *argvars UNUSED, typval_T *rettv)
3795{
3796 rettv->vval.v_number = curbuf->b_u_seq_cur;
3797}
3798
3799/*
3800 * "char2nr(string)" function
3801 */
3802 static void
3803f_char2nr(typval_T *argvars, typval_T *rettv)
3804{
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02003805 if (in_vim9script()
3806 && (check_for_string_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02003807 || check_for_opt_bool_arg(argvars, 1) == FAIL))
Bram Moolenaarc5809432021-03-27 21:23:30 +01003808 return;
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02003809
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003810 if (has_mbyte)
3811 {
3812 int utf8 = 0;
3813
3814 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaar24f77502020-09-04 19:50:57 +02003815 utf8 = (int)tv_get_bool_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003816
3817 if (utf8)
Bram Moolenaarbdace832019-03-02 10:13:42 +01003818 rettv->vval.v_number = utf_ptr2char(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003819 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003820 rettv->vval.v_number = (*mb_ptr2char)(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003821 }
3822 else
Bram Moolenaar13505972019-01-24 15:04:48 +01003823 rettv->vval.v_number = tv_get_string(&argvars[0])[0];
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003824}
3825
Bram Moolenaar17793ef2020-12-28 12:56:58 +01003826/*
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003827 * Get the current cursor column and store it in 'rettv'. If 'charcol' is TRUE,
3828 * returns the character index of the column. Otherwise, returns the byte index
3829 * of the column.
3830 */
3831 static void
3832get_col(typval_T *argvars, typval_T *rettv, int charcol)
3833{
3834 colnr_T col = 0;
3835 pos_T *fp;
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00003836 switchwin_T switchwin;
3837 int winchanged = FALSE;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003838
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00003839 if (check_for_string_or_list_arg(argvars, 0) == FAIL
3840 || check_for_opt_number_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003841 return;
3842
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00003843 if (argvars[1].v_type != VAR_UNKNOWN)
3844 {
3845 tabpage_T *tp;
3846 win_T *wp;
3847
3848 // use the window specified in the second argument
3849 wp = win_id2wp_tp((int)tv_get_number(&argvars[1]), &tp);
3850 if (wp == NULL || tp == NULL)
3851 return;
3852
3853 if (switch_win_noblock(&switchwin, wp, tp, TRUE) != OK)
3854 return;
3855
3856 check_cursor();
3857 winchanged = TRUE;
3858 }
3859
3860 int fnum = curbuf->b_fnum;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003861 fp = var2fpos(&argvars[0], FALSE, &fnum, charcol);
3862 if (fp != NULL && fnum == curbuf->b_fnum)
3863 {
3864 if (fp->col == MAXCOL)
3865 {
3866 // '> can be MAXCOL, get the length of the line then
3867 if (fp->lnum <= curbuf->b_ml.ml_line_count)
John Marriottbfcc8952024-03-11 22:04:45 +01003868 col = ml_get_len(fp->lnum) + 1;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003869 else
3870 col = MAXCOL;
3871 }
3872 else
3873 {
3874 col = fp->col + 1;
3875 // col(".") when the cursor is on the NUL at the end of the line
3876 // because of "coladd" can be seen as an extra column.
3877 if (virtual_active() && fp == &curwin->w_cursor)
3878 {
3879 char_u *p = ml_get_cursor();
3880
3881 if (curwin->w_cursor.coladd >= (colnr_T)chartabsize(p,
3882 curwin->w_virtcol - curwin->w_cursor.coladd))
3883 {
3884 int l;
3885
3886 if (*p != NUL && p[(l = (*mb_ptr2len)(p))] == NUL)
3887 col += l;
3888 }
3889 }
3890 }
3891 }
3892 rettv->vval.v_number = col;
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00003893
3894 if (winchanged)
3895 restore_win_noblock(&switchwin, TRUE);
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003896}
3897
3898/*
3899 * "charcol()" function
3900 */
3901 static void
3902f_charcol(typval_T *argvars, typval_T *rettv)
3903{
3904 get_col(argvars, rettv, TRUE);
3905}
3906
Bram Moolenaar29b7d7a2019-07-22 23:03:57 +02003907 win_T *
Bram Moolenaaraff74912019-03-30 18:11:49 +01003908get_optional_window(typval_T *argvars, int idx)
3909{
3910 win_T *win = curwin;
3911
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003912 if (argvars[idx].v_type == VAR_UNKNOWN)
3913 return curwin;
3914
3915 win = find_win_by_nr_or_id(&argvars[idx]);
3916 if (win == NULL)
Bram Moolenaaraff74912019-03-30 18:11:49 +01003917 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003918 emsg(_(e_invalid_window_number));
3919 return NULL;
Bram Moolenaaraff74912019-03-30 18:11:49 +01003920 }
3921 return win;
3922}
3923
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003924/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003925 * "col(string)" function
3926 */
3927 static void
3928f_col(typval_T *argvars, typval_T *rettv)
3929{
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003930 get_col(argvars, rettv, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003931}
3932
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003933/*
3934 * "confirm(message, buttons[, default [, type]])" function
3935 */
3936 static void
3937f_confirm(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
3938{
3939#if defined(FEAT_GUI_DIALOG) || defined(FEAT_CON_DIALOG)
3940 char_u *message;
3941 char_u *buttons = NULL;
3942 char_u buf[NUMBUFLEN];
3943 char_u buf2[NUMBUFLEN];
3944 int def = 1;
3945 int type = VIM_GENERIC;
3946 char_u *typestr;
3947 int error = FALSE;
3948
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02003949 if (in_vim9script()
3950 && (check_for_string_arg(argvars, 0) == FAIL
3951 || (check_for_opt_string_arg(argvars, 1) == FAIL
3952 || (argvars[1].v_type != VAR_UNKNOWN
3953 && (check_for_opt_number_arg(argvars, 2) == FAIL
3954 || (argvars[2].v_type != VAR_UNKNOWN
3955 && check_for_opt_string_arg(argvars, 3) == FAIL))))))
Bram Moolenaarc5809432021-03-27 21:23:30 +01003956 return;
3957
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003958 message = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003959 if (message == NULL)
3960 error = TRUE;
3961 if (argvars[1].v_type != VAR_UNKNOWN)
3962 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003963 buttons = tv_get_string_buf_chk(&argvars[1], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003964 if (buttons == NULL)
3965 error = TRUE;
3966 if (argvars[2].v_type != VAR_UNKNOWN)
3967 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003968 def = (int)tv_get_number_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003969 if (argvars[3].v_type != VAR_UNKNOWN)
3970 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003971 typestr = tv_get_string_buf_chk(&argvars[3], buf2);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003972 if (typestr == NULL)
3973 error = TRUE;
3974 else
3975 {
3976 switch (TOUPPER_ASC(*typestr))
3977 {
3978 case 'E': type = VIM_ERROR; break;
3979 case 'Q': type = VIM_QUESTION; break;
3980 case 'I': type = VIM_INFO; break;
3981 case 'W': type = VIM_WARNING; break;
3982 case 'G': type = VIM_GENERIC; break;
3983 }
3984 }
3985 }
3986 }
3987 }
3988
3989 if (buttons == NULL || *buttons == NUL)
3990 buttons = (char_u *)_("&Ok");
3991
3992 if (!error)
3993 rettv->vval.v_number = do_dialog(type, NULL, message, buttons,
3994 def, NULL, FALSE);
3995#endif
3996}
3997
3998/*
3999 * "copy()" function
4000 */
4001 static void
4002f_copy(typval_T *argvars, typval_T *rettv)
4003{
Bram Moolenaar381692b2022-02-02 20:01:27 +00004004 item_copy(&argvars[0], rettv, FALSE, TRUE, 0);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004005}
4006
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004007/*
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004008 * Set the cursor position.
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01004009 * If "charcol" is TRUE, then use the column number as a character offset.
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004010 * Otherwise use the column number as a byte offset.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004011 */
4012 static void
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004013set_cursorpos(typval_T *argvars, typval_T *rettv, int charcol)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004014{
Bram Moolenaar79f23442022-10-10 12:42:57 +01004015 long lnum, col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004016 long coladd = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004017 int set_curswant = TRUE;
4018
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004019 if (in_vim9script()
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004020 && (check_for_string_or_number_or_list_arg(argvars, 0) == FAIL
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02004021 || check_for_opt_number_arg(argvars, 1) == FAIL
4022 || (argvars[1].v_type != VAR_UNKNOWN
4023 && check_for_opt_number_arg(argvars, 2) == FAIL)))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004024 return;
4025
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004026 rettv->vval.v_number = -1;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004027 if (argvars[0].v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004028 {
4029 pos_T pos;
4030 colnr_T curswant = -1;
4031
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004032 if (list2fpos(argvars, &pos, NULL, &curswant, charcol) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004033 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00004034 emsg(_(e_invalid_argument));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004035 return;
4036 }
Bram Moolenaar79f23442022-10-10 12:42:57 +01004037 lnum = pos.lnum;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004038 col = pos.col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004039 coladd = pos.coladd;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004040 if (curswant >= 0)
4041 {
4042 curwin->w_curswant = curswant - 1;
4043 set_curswant = FALSE;
4044 }
4045 }
Bram Moolenaar79f23442022-10-10 12:42:57 +01004046 else if ((argvars[0].v_type == VAR_NUMBER
4047 || argvars[0].v_type == VAR_STRING)
4048 && (argvars[1].v_type == VAR_NUMBER
4049 || argvars[1].v_type == VAR_STRING))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004050 {
Bram Moolenaar79f23442022-10-10 12:42:57 +01004051 lnum = tv_get_lnum(argvars);
4052 if (lnum < 0)
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00004053 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[0]));
Bram Moolenaar79f23442022-10-10 12:42:57 +01004054 else if (lnum == 0)
4055 lnum = curwin->w_cursor.lnum;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004056 col = (long)tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004057 if (charcol)
Bram Moolenaar79f23442022-10-10 12:42:57 +01004058 col = buf_charidx_to_byteidx(curbuf, lnum, col) + 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004059 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004060 coladd = (long)tv_get_number_chk(&argvars[2], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004061 }
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004062 else
4063 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00004064 emsg(_(e_invalid_argument));
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004065 return;
4066 }
Bram Moolenaar79f23442022-10-10 12:42:57 +01004067 if (lnum < 0 || col < 0 || coladd < 0)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004068 return; // type error; errmsg already given
Bram Moolenaar79f23442022-10-10 12:42:57 +01004069 if (lnum > 0)
4070 curwin->w_cursor.lnum = lnum;
zeertzjq2ffdae72024-05-02 13:06:24 +02004071 if (col != MAXCOL && --col < 0)
4072 col = 0;
4073 curwin->w_cursor.col = col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004074 curwin->w_cursor.coladd = coladd;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004075
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004076 // Make sure the cursor is in a valid position.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004077 check_cursor();
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004078 // Correct cursor for multi-byte character.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004079 if (has_mbyte)
4080 mb_adjust_cursor();
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004081
4082 curwin->w_set_curswant = set_curswant;
4083 rettv->vval.v_number = 0;
4084}
4085
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004086/*
4087 * "cursor(lnum, col)" function, or
4088 * "cursor(list)"
4089 *
4090 * Moves the cursor to the specified line and column.
4091 * Returns 0 when the position could be set, -1 otherwise.
4092 */
4093 static void
4094f_cursor(typval_T *argvars, typval_T *rettv)
4095{
4096 set_cursorpos(argvars, rettv, FALSE);
4097}
4098
Bram Moolenaar4f974752019-02-17 17:44:42 +01004099#ifdef MSWIN
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004100/*
4101 * "debugbreak()" function
4102 */
4103 static void
4104f_debugbreak(typval_T *argvars, typval_T *rettv)
4105{
4106 int pid;
4107
4108 rettv->vval.v_number = FAIL;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004109 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
4110 return;
4111
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004112 pid = (int)tv_get_number(&argvars[0]);
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004113 if (pid == 0)
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004114 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00004115 emsg(_(e_invalid_argument));
4116 return;
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004117 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00004118
4119 HANDLE hProcess = OpenProcess(PROCESS_ALL_ACCESS, 0, pid);
4120 if (hProcess == NULL)
4121 return;
4122
4123 DebugBreakProcess(hProcess);
4124 CloseHandle(hProcess);
4125 rettv->vval.v_number = OK;
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004126}
4127#endif
4128
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004129/*
4130 * "deepcopy()" function
4131 */
4132 static void
4133f_deepcopy(typval_T *argvars, typval_T *rettv)
4134{
Bram Moolenaar239f8d92021-01-17 13:21:20 +01004135 varnumber_T noref = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004136
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +01004137 if (check_for_opt_bool_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004138 return;
4139
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004140 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaar239f8d92021-01-17 13:21:20 +01004141 noref = tv_get_bool_chk(&argvars[1], NULL);
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +01004142
4143 item_copy(&argvars[0], rettv, TRUE, TRUE, noref == 0 ? get_copyID() : 0);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004144}
4145
4146/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004147 * "did_filetype()" function
4148 */
4149 static void
4150f_did_filetype(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
4151{
zeertzjq5bf6c212024-03-31 18:41:27 +02004152 rettv->vval.v_number = curbuf->b_did_filetype;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004153}
4154
4155/*
Bram Moolenaar4132eb52020-02-14 16:53:00 +01004156 * "echoraw({expr})" function
4157 */
4158 static void
4159f_echoraw(typval_T *argvars, typval_T *rettv UNUSED)
4160{
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02004161 char_u *str;
Bram Moolenaar4132eb52020-02-14 16:53:00 +01004162
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02004163 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
4164 return;
4165
4166 str = tv_get_string_chk(&argvars[0]);
Bram Moolenaar4132eb52020-02-14 16:53:00 +01004167 if (str != NULL && *str != NUL)
4168 {
4169 out_str(str);
4170 out_flush();
4171 }
4172}
4173
4174/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004175 * "empty({expr})" function
4176 */
4177 static void
4178f_empty(typval_T *argvars, typval_T *rettv)
4179{
4180 int n = FALSE;
4181
4182 switch (argvars[0].v_type)
4183 {
4184 case VAR_STRING:
4185 case VAR_FUNC:
4186 n = argvars[0].vval.v_string == NULL
4187 || *argvars[0].vval.v_string == NUL;
4188 break;
4189 case VAR_PARTIAL:
Yegappan Lakshmananda9d3452024-05-02 13:02:36 +02004190 n = argvars[0].vval.v_partial == NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004191 break;
4192 case VAR_NUMBER:
4193 n = argvars[0].vval.v_number == 0;
4194 break;
4195 case VAR_FLOAT:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004196 n = argvars[0].vval.v_float == 0.0;
4197 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004198 case VAR_LIST:
4199 n = argvars[0].vval.v_list == NULL
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004200 || argvars[0].vval.v_list->lv_len == 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004201 break;
4202 case VAR_DICT:
4203 n = argvars[0].vval.v_dict == NULL
4204 || argvars[0].vval.v_dict->dv_hashtab.ht_used == 0;
4205 break;
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01004206 case VAR_BOOL:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004207 case VAR_SPECIAL:
4208 n = argvars[0].vval.v_number != VVAL_TRUE;
4209 break;
Bram Moolenaar00b28d62022-12-08 15:32:33 +00004210 case VAR_CLASS:
4211 n = argvars[0].vval.v_class != NULL;
4212 break;
4213 case VAR_OBJECT:
Yegappan Lakshmanand3eae7b2024-03-03 16:26:58 +01004214 n = object_empty(argvars[0].vval.v_object);
Bram Moolenaar00b28d62022-12-08 15:32:33 +00004215 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004216
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01004217 case VAR_BLOB:
4218 n = argvars[0].vval.v_blob == NULL
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01004219 || argvars[0].vval.v_blob->bv_ga.ga_len == 0;
4220 break;
4221
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004222 case VAR_JOB:
4223#ifdef FEAT_JOB_CHANNEL
4224 n = argvars[0].vval.v_job == NULL
4225 || argvars[0].vval.v_job->jv_status != JOB_STARTED;
4226 break;
4227#endif
4228 case VAR_CHANNEL:
4229#ifdef FEAT_JOB_CHANNEL
4230 n = argvars[0].vval.v_channel == NULL
4231 || !channel_is_open(argvars[0].vval.v_channel);
4232 break;
4233#endif
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +02004234 case VAR_TYPEALIAS:
4235 n = argvars[0].vval.v_typealias == NULL
4236 || argvars[0].vval.v_typealias->ta_name == NULL
4237 || *argvars[0].vval.v_typealias->ta_name == NUL;
4238 break;
4239
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004240 case VAR_UNKNOWN:
Bram Moolenaar4c683752020-04-05 21:38:23 +02004241 case VAR_ANY:
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004242 case VAR_VOID:
Bram Moolenaarf18332f2021-05-07 17:55:55 +02004243 case VAR_INSTR:
Bram Moolenaardd589232020-02-29 17:38:12 +01004244 internal_error_no_abort("f_empty(UNKNOWN)");
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004245 n = TRUE;
4246 break;
4247 }
4248
4249 rettv->vval.v_number = n;
4250}
4251
4252/*
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004253 * "environ()" function
4254 */
4255 static void
4256f_environ(typval_T *argvars UNUSED, typval_T *rettv)
4257{
4258#if !defined(AMIGA)
4259 int i = 0;
4260 char_u *entry, *value;
Bram Moolenaar68aaff42022-04-17 10:57:44 +01004261# if defined (MSWIN)
4262# if !defined(_UCRT)
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004263 extern wchar_t **_wenviron;
Bram Moolenaar68aaff42022-04-17 10:57:44 +01004264# endif
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004265# else
4266 extern char **environ;
4267# endif
4268
Bram Moolenaar93a10962022-06-16 11:42:09 +01004269 if (rettv_dict_alloc(rettv) == FAIL)
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004270 return;
4271
4272# ifdef MSWIN
4273 if (*_wenviron == NULL)
4274 return;
4275# else
4276 if (*environ == NULL)
4277 return;
4278# endif
4279
4280 for (i = 0; ; ++i)
4281 {
4282# ifdef MSWIN
4283 short_u *p;
4284
4285 if ((p = (short_u *)_wenviron[i]) == NULL)
4286 return;
4287 entry = utf16_to_enc(p, NULL);
4288# else
4289 if ((entry = (char_u *)environ[i]) == NULL)
4290 return;
4291 entry = vim_strsave(entry);
4292# endif
4293 if (entry == NULL) // out of memory
4294 return;
4295 if ((value = vim_strchr(entry, '=')) == NULL)
4296 {
4297 vim_free(entry);
4298 continue;
4299 }
4300 *value++ = NUL;
4301 dict_add_string(rettv->vval.v_dict, (char *)entry, value);
4302 vim_free(entry);
4303 }
4304#endif
4305}
4306
4307/*
Bram Moolenaar80adaa82023-07-07 18:57:40 +01004308 * "err_teapot()" function
4309 */
4310 static void
4311f_err_teapot(typval_T *argvars, typval_T *rettv UNUSED)
4312{
4313 if (argvars[0].v_type != VAR_UNKNOWN)
4314 {
4315 if (argvars[0].v_type == VAR_STRING)
4316 {
4317 char_u *s = tv_get_string_strict(&argvars[0]);
Sean Dewarb0efa492023-07-08 10:35:19 +01004318 if (*skipwhite(s) == NUL)
Bram Moolenaar80adaa82023-07-07 18:57:40 +01004319 return;
4320 }
4321
4322 int err = FALSE;
4323 int do_503 = eval_expr_to_bool(&argvars[0], &err);
4324 if (!err && do_503)
4325 {
4326 emsg(_(e_coffee_currently_not_available));
4327 return;
4328 }
4329 }
4330
4331 emsg(_(e_im_a_teapot));
4332}
4333
4334/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004335 * "escape({string}, {chars})" function
4336 */
4337 static void
4338f_escape(typval_T *argvars, typval_T *rettv)
4339{
4340 char_u buf[NUMBUFLEN];
4341
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004342 if (in_vim9script()
4343 && (check_for_string_arg(argvars, 0) == FAIL
4344 || check_for_string_arg(argvars, 1) == FAIL))
4345 return;
4346
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004347 rettv->vval.v_string = vim_strsave_escaped(tv_get_string(&argvars[0]),
4348 tv_get_string_buf(&argvars[1], buf));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004349 rettv->v_type = VAR_STRING;
4350}
4351
4352/*
4353 * "eval()" function
4354 */
4355 static void
4356f_eval(typval_T *argvars, typval_T *rettv)
4357{
4358 char_u *s, *p;
4359
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004360 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
4361 return;
4362
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004363 s = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004364 if (s != NULL)
4365 s = skipwhite(s);
4366
4367 p = s;
Bram Moolenaar5409f5d2020-06-24 18:37:35 +02004368 if (s == NULL || eval1(&s, rettv, &EVALARG_EVALUATE) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004369 {
4370 if (p != NULL && !aborting())
Bram Moolenaar108010a2021-06-27 22:03:33 +02004371 semsg(_(e_invalid_expression_str), p);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004372 need_clr_eos = FALSE;
4373 rettv->v_type = VAR_NUMBER;
4374 rettv->vval.v_number = 0;
4375 }
4376 else if (*s != NUL)
Bram Moolenaar74409f62022-01-01 15:58:22 +00004377 semsg(_(e_trailing_characters_str), s);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004378}
4379
4380/*
4381 * "eventhandler()" function
4382 */
4383 static void
4384f_eventhandler(typval_T *argvars UNUSED, typval_T *rettv)
4385{
Bram Moolenaardfc33a62020-04-29 22:30:13 +02004386 rettv->vval.v_number = vgetc_busy || input_busy;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004387}
4388
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004389static garray_T redir_execute_ga;
4390
4391/*
4392 * Append "value[value_len]" to the execute() output.
4393 */
4394 void
4395execute_redir_str(char_u *value, int value_len)
4396{
4397 int len;
4398
4399 if (value_len == -1)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004400 len = (int)STRLEN(value); // Append the entire string
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004401 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004402 len = value_len; // Append only "value_len" characters
Yegappan Lakshmananfadc02a2023-01-27 21:03:12 +00004403 if (ga_grow(&redir_execute_ga, len) == FAIL)
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00004404 return;
4405
4406 mch_memmove((char *)redir_execute_ga.ga_data
4407 + redir_execute_ga.ga_len, value, len);
4408 redir_execute_ga.ga_len += len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004409}
4410
Dominique Pelle748b3082022-01-08 12:41:16 +00004411#if defined(FEAT_LUA) || defined(PROTO)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004412/*
Yegappan Lakshmanan11328bc2021-08-06 21:34:38 +02004413 * Get next line from a string containing NL separated lines.
4414 * Called by do_cmdline() to get the next line.
4415 * Returns an allocated string, or NULL when at the end of the string.
4416 */
4417 static char_u *
4418get_str_line(
4419 int c UNUSED,
4420 void *cookie,
4421 int indent UNUSED,
4422 getline_opt_T options UNUSED)
4423{
4424 char_u *start = *(char_u **)cookie;
4425 char_u *line;
4426 char_u *p;
4427
4428 p = start;
4429 if (p == NULL || *p == NUL)
4430 return NULL;
4431 p = vim_strchr(p, '\n');
4432 if (p == NULL)
4433 line = vim_strsave(start);
4434 else
4435 {
4436 line = vim_strnsave(start, p - start);
4437 p++;
4438 }
4439
4440 *(char_u **)cookie = p;
4441 return line;
4442}
4443
4444/*
4445 * Execute a series of Ex commands in 'str'
4446 */
4447 void
4448execute_cmds_from_string(char_u *str)
4449{
4450 do_cmdline(NULL, get_str_line, (void *)&str,
4451 DOCMD_NOWAIT|DOCMD_VERBOSE|DOCMD_REPEAT|DOCMD_KEYTYPED);
4452}
Dominique Pelle748b3082022-01-08 12:41:16 +00004453#endif
Yegappan Lakshmanan11328bc2021-08-06 21:34:38 +02004454
4455/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004456 * Get next line from a list.
4457 * Called by do_cmdline() to get the next line.
4458 * Returns allocated string, or NULL for end of function.
4459 */
Bram Moolenaara7583c42022-05-07 21:14:05 +01004460 char_u *
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004461get_list_line(
4462 int c UNUSED,
4463 void *cookie,
Bram Moolenaare96a2492019-06-25 04:12:16 +02004464 int indent UNUSED,
Bram Moolenaar66250c92020-08-20 15:02:42 +02004465 getline_opt_T options UNUSED)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004466{
4467 listitem_T **p = (listitem_T **)cookie;
4468 listitem_T *item = *p;
4469 char_u buf[NUMBUFLEN];
4470 char_u *s;
4471
4472 if (item == NULL)
4473 return NULL;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004474 s = tv_get_string_buf_chk(&item->li_tv, buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004475 *p = item->li_next;
4476 return s == NULL ? NULL : vim_strsave(s);
4477}
4478
4479/*
4480 * "execute()" function
4481 */
Bram Moolenaar261f3462019-09-07 15:45:32 +02004482 void
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004483execute_common(typval_T *argvars, typval_T *rettv, int arg_off)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004484{
4485 char_u *cmd = NULL;
4486 list_T *list = NULL;
4487 int save_msg_silent = msg_silent;
4488 int save_emsg_silent = emsg_silent;
4489 int save_emsg_noredir = emsg_noredir;
4490 int save_redir_execute = redir_execute;
Bram Moolenaar20951482017-12-25 13:44:43 +01004491 int save_redir_off = redir_off;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004492 garray_T save_ga;
Bram Moolenaar10ccaa12018-12-07 16:38:23 +01004493 int save_msg_col = msg_col;
Kota Kato3d3f6ac2022-08-04 18:50:14 +01004494 int save_sticky_cmdmod_flags = sticky_cmdmod_flags;
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004495 int echo_output = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004496
4497 rettv->vval.v_string = NULL;
4498 rettv->v_type = VAR_STRING;
4499
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004500 if (argvars[arg_off].v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004501 {
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004502 list = argvars[arg_off].vval.v_list;
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004503 if (list == NULL || list->lv_len == 0)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004504 // empty list, no commands, empty output
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004505 return;
4506 ++list->lv_refcount;
4507 }
Bram Moolenaare2a8f072020-01-08 19:32:18 +01004508 else if (argvars[arg_off].v_type == VAR_JOB
4509 || argvars[arg_off].v_type == VAR_CHANNEL)
4510 {
Bram Moolenaar68db9962021-05-09 23:19:22 +02004511 semsg(_(e_using_invalid_value_as_string_str),
4512 vartype_name(argvars[arg_off].v_type));
Bram Moolenaare2a8f072020-01-08 19:32:18 +01004513 return;
4514 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004515 else
4516 {
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004517 cmd = tv_get_string_chk(&argvars[arg_off]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004518 if (cmd == NULL)
4519 return;
4520 }
4521
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004522 if (argvars[arg_off + 1].v_type != VAR_UNKNOWN)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004523 {
4524 char_u buf[NUMBUFLEN];
Bram Moolenaar3cfa5b12021-06-06 14:14:39 +02004525 char_u *s = tv_get_string_buf_chk_strict(&argvars[arg_off + 1], buf,
4526 in_vim9script());
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004527
4528 if (s == NULL)
4529 return;
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004530 if (*s == NUL)
4531 echo_output = TRUE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004532 if (STRNCMP(s, "silent", 6) == 0)
4533 ++msg_silent;
4534 if (STRCMP(s, "silent!") == 0)
4535 {
4536 emsg_silent = TRUE;
4537 emsg_noredir = TRUE;
4538 }
4539 }
4540 else
4541 ++msg_silent;
4542
4543 if (redir_execute)
4544 save_ga = redir_execute_ga;
Bram Moolenaar04935fb2022-01-08 16:19:22 +00004545 ga_init2(&redir_execute_ga, sizeof(char), 500);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004546 redir_execute = TRUE;
Bram Moolenaar20951482017-12-25 13:44:43 +01004547 redir_off = FALSE;
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004548 if (!echo_output)
4549 msg_col = 0; // prevent leading spaces
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004550
Kota Kato3d3f6ac2022-08-04 18:50:14 +01004551 // For "legacy call execute('cmd')" and "vim9cmd execute('cmd')" apply the
4552 // command modifiers to "cmd".
4553 sticky_cmdmod_flags = cmdmod.cmod_flags & (CMOD_LEGACY | CMOD_VIM9CMD);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004554 if (cmd != NULL)
4555 do_cmdline_cmd(cmd);
4556 else
4557 {
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004558 listitem_T *item;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004559
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02004560 CHECK_LIST_MATERIALIZE(list);
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004561 item = list->lv_first;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004562 do_cmdline(NULL, get_list_line, (void *)&item,
4563 DOCMD_NOWAIT|DOCMD_VERBOSE|DOCMD_REPEAT|DOCMD_KEYTYPED);
4564 --list->lv_refcount;
4565 }
Kota Kato3d3f6ac2022-08-04 18:50:14 +01004566 sticky_cmdmod_flags = save_sticky_cmdmod_flags;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004567
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004568 // Need to append a NUL to the result.
Bram Moolenaard297f352017-01-29 20:31:21 +01004569 if (ga_grow(&redir_execute_ga, 1) == OK)
4570 {
4571 ((char *)redir_execute_ga.ga_data)[redir_execute_ga.ga_len] = NUL;
4572 rettv->vval.v_string = redir_execute_ga.ga_data;
4573 }
4574 else
4575 {
4576 ga_clear(&redir_execute_ga);
4577 rettv->vval.v_string = NULL;
4578 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004579 msg_silent = save_msg_silent;
4580 emsg_silent = save_emsg_silent;
4581 emsg_noredir = save_emsg_noredir;
4582
4583 redir_execute = save_redir_execute;
4584 if (redir_execute)
4585 redir_execute_ga = save_ga;
Bram Moolenaar20951482017-12-25 13:44:43 +01004586 redir_off = save_redir_off;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004587
Bram Moolenaar10ccaa12018-12-07 16:38:23 +01004588 // "silent reg" or "silent echo x" leaves msg_col somewhere in the line.
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004589 if (echo_output)
4590 // When not working silently: put it in column zero. A following
4591 // "echon" will overwrite the message, unavoidably.
4592 msg_col = 0;
4593 else
4594 // When working silently: Put it back where it was, since nothing
4595 // should have been written.
4596 msg_col = save_msg_col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004597}
4598
4599/*
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004600 * "execute()" function
4601 */
4602 static void
4603f_execute(typval_T *argvars, typval_T *rettv)
4604{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004605 if (in_vim9script()
4606 && (check_for_string_or_list_arg(argvars, 0) == FAIL
4607 || check_for_opt_string_arg(argvars, 1) == FAIL))
4608 return;
4609
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004610 execute_common(argvars, rettv, 0);
4611}
4612
4613/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004614 * "exists()" function
4615 */
Bram Moolenaarbb7ee7a2021-08-02 20:06:50 +02004616 void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004617f_exists(typval_T *argvars, typval_T *rettv)
4618{
4619 char_u *p;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004620 int n = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004621
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004622 if (in_vim9script() && check_for_nonempty_string_arg(argvars, 0) == FAIL)
4623 return;
4624
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004625 p = tv_get_string(&argvars[0]);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004626 if (*p == '$') // environment variable
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004627 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004628 // first try "normal" environment variables (fast)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004629 if (mch_getenv(p + 1) != NULL)
4630 n = TRUE;
4631 else
4632 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004633 // try expanding things like $VIM and ${HOME}
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004634 p = expand_env_save(p);
4635 if (p != NULL && *p != '$')
4636 n = TRUE;
4637 vim_free(p);
4638 }
4639 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004640 else if (*p == '&' || *p == '+') // option
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004641 {
Bram Moolenaar9a78e6d2020-07-01 18:29:55 +02004642 n = (eval_option(&p, NULL, TRUE) == OK);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004643 if (*skipwhite(p) != NUL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004644 n = FALSE; // trailing garbage
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004645 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004646 else if (*p == '*') // internal or user defined function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004647 {
Bram Moolenaarb54c3ff2016-07-31 14:11:58 +02004648 n = function_exists(p + 1, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004649 }
Bram Moolenaar15c47602020-03-26 22:16:48 +01004650 else if (*p == '?') // internal function only
4651 {
4652 n = has_internal_func_name(p + 1);
4653 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004654 else if (*p == ':')
4655 {
4656 n = cmd_exists(p + 1);
4657 }
4658 else if (*p == '#')
4659 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004660 if (p[1] == '#')
4661 n = autocmd_supported(p + 2);
4662 else
4663 n = au_exists(p + 1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004664 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004665 else // internal variable
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004666 {
Bram Moolenaarc6f9f732018-02-11 19:06:26 +01004667 n = var_exists(p);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004668 }
4669
4670 rettv->vval.v_number = n;
4671}
4672
Bram Moolenaar26735992021-08-08 14:43:22 +02004673 static void
4674f_exists_compiled(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
4675{
4676 emsg(_(e_exists_compiled_can_only_be_used_in_def_function));
4677}
4678
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004679/*
4680 * "expand()" function
4681 */
4682 static void
4683f_expand(typval_T *argvars, typval_T *rettv)
4684{
4685 char_u *s;
Mike Williams51024bb2024-05-30 07:46:30 +02004686 size_t len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004687 int options = WILD_SILENT|WILD_USE_NL|WILD_LIST_NOTFOUND;
4688 expand_T xpc;
4689 int error = FALSE;
4690 char_u *result;
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004691#ifdef BACKSLASH_IN_FILENAME
4692 char_u *p_csl_save = p_csl;
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004693#endif
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004694
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004695 if (in_vim9script()
4696 && (check_for_string_arg(argvars, 0) == FAIL
4697 || check_for_opt_bool_arg(argvars, 1) == FAIL
4698 || (argvars[1].v_type != VAR_UNKNOWN
4699 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
4700 return;
4701
4702#ifdef BACKSLASH_IN_FILENAME
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004703 // avoid using 'completeslash' here
4704 p_csl = empty_option;
4705#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004706
4707 rettv->v_type = VAR_STRING;
4708 if (argvars[1].v_type != VAR_UNKNOWN
4709 && argvars[2].v_type != VAR_UNKNOWN
Bram Moolenaar551d25e2020-09-02 21:37:56 +02004710 && tv_get_bool_chk(&argvars[2], &error)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004711 && !error)
Bram Moolenaar45cf6e92017-04-30 20:25:19 +02004712 rettv_list_set(rettv, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004713
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004714 s = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004715 if (*s == '%' || *s == '#' || *s == '<')
4716 {
Bram Moolenaar57544522022-04-12 12:54:11 +01004717 char *errormsg = NULL;
4718
4719 if (p_verbose == 0)
4720 ++emsg_off;
Bram Moolenaara96edb72022-04-28 17:52:24 +01004721 result = eval_vars(s, s, &len, NULL, &errormsg, NULL, FALSE);
Bram Moolenaar57544522022-04-12 12:54:11 +01004722 if (p_verbose == 0)
4723 --emsg_off;
4724 else if (errormsg != NULL)
4725 emsg(errormsg);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004726 if (rettv->v_type == VAR_LIST)
4727 {
Bram Moolenaar93a10962022-06-16 11:42:09 +01004728 if (rettv_list_alloc(rettv) == OK && result != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004729 list_append_string(rettv->vval.v_list, result, -1);
Bram Moolenaar86173482019-10-01 17:02:16 +02004730 vim_free(result);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004731 }
4732 else
4733 rettv->vval.v_string = result;
4734 }
4735 else
4736 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004737 // When the optional second argument is non-zero, don't remove matches
4738 // for 'wildignore' and don't put matches for 'suffixes' at the end.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004739 if (argvars[1].v_type != VAR_UNKNOWN
Bram Moolenaar551d25e2020-09-02 21:37:56 +02004740 && tv_get_bool_chk(&argvars[1], &error))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004741 options |= WILD_KEEP_ALL;
4742 if (!error)
4743 {
4744 ExpandInit(&xpc);
4745 xpc.xp_context = EXPAND_FILES;
4746 if (p_wic)
4747 options += WILD_ICASE;
4748 if (rettv->v_type == VAR_STRING)
4749 rettv->vval.v_string = ExpandOne(&xpc, s, NULL,
4750 options, WILD_ALL);
Bram Moolenaar93a10962022-06-16 11:42:09 +01004751 else if (rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004752 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004753 ExpandOne(&xpc, s, NULL, options, WILD_ALL_KEEP);
Bram Moolenaar848db572022-09-20 19:04:32 +01004754 for (int i = 0; i < xpc.xp_numfiles; i++)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004755 list_append_string(rettv->vval.v_list, xpc.xp_files[i], -1);
4756 ExpandCleanup(&xpc);
4757 }
4758 }
4759 else
4760 rettv->vval.v_string = NULL;
4761 }
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004762#ifdef BACKSLASH_IN_FILENAME
4763 p_csl = p_csl_save;
4764#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004765}
4766
4767/*
Bram Moolenaar80dad482019-06-09 17:22:31 +02004768 * "expandcmd()" function
4769 * Expand all the special characters in a command string.
4770 */
4771 static void
4772f_expandcmd(typval_T *argvars, typval_T *rettv)
4773{
4774 exarg_T eap;
4775 char_u *cmdstr;
4776 char *errormsg = NULL;
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004777 int emsgoff = TRUE;
Bram Moolenaar80dad482019-06-09 17:22:31 +02004778
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004779 if (in_vim9script()
4780 && (check_for_string_arg(argvars, 0) == FAIL
4781 || check_for_opt_dict_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004782 return;
4783
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004784 if (argvars[1].v_type == VAR_DICT
Bram Moolenaard61efa52022-07-23 09:52:04 +01004785 && dict_get_bool(argvars[1].vval.v_dict, "errmsg", VVAL_FALSE))
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004786 emsgoff = FALSE;
4787
Bram Moolenaar80dad482019-06-09 17:22:31 +02004788 rettv->v_type = VAR_STRING;
4789 cmdstr = vim_strsave(tv_get_string(&argvars[0]));
4790
Yegappan Lakshmanan960dcbd2023-03-07 17:45:11 +00004791 CLEAR_FIELD(eap);
Bram Moolenaar80dad482019-06-09 17:22:31 +02004792 eap.cmd = cmdstr;
4793 eap.arg = cmdstr;
Bram Moolenaar8071cb22019-07-12 17:58:01 +02004794 eap.argt |= EX_NOSPC;
Bram Moolenaar80dad482019-06-09 17:22:31 +02004795 eap.usefilter = FALSE;
4796 eap.nextcmd = NULL;
4797 eap.cmdidx = CMD_USER;
4798
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004799 if (emsgoff)
4800 ++emsg_off;
4801 if (expand_filename(&eap, &cmdstr, &errormsg) == FAIL)
4802 if (!emsgoff && errormsg != NULL && *errormsg != NUL)
4803 emsg(errormsg);
4804 if (emsgoff)
4805 --emsg_off;
Bram Moolenaar80dad482019-06-09 17:22:31 +02004806
4807 rettv->vval.v_string = cmdstr;
4808}
4809
4810/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004811 * "feedkeys()" function
4812 */
4813 static void
4814f_feedkeys(typval_T *argvars, typval_T *rettv UNUSED)
4815{
4816 int remap = TRUE;
4817 int insert = FALSE;
4818 char_u *keys, *flags;
4819 char_u nbuf[NUMBUFLEN];
4820 int typed = FALSE;
4821 int execute = FALSE;
Bram Moolenaara9725222022-01-16 13:30:33 +00004822 int context = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004823 int dangerous = FALSE;
Bram Moolenaar5e66b422019-01-24 21:58:10 +01004824 int lowlevel = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004825
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004826 // This is not allowed in the sandbox. If the commands would still be
4827 // executed in the sandbox it would be OK, but it probably happens later,
4828 // when "sandbox" is no longer set.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004829 if (check_secure())
4830 return;
4831
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004832 if (in_vim9script()
4833 && (check_for_string_arg(argvars, 0) == FAIL
4834 || check_for_opt_string_arg(argvars, 1) == FAIL))
4835 return;
4836
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004837 keys = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004838
4839 if (argvars[1].v_type != VAR_UNKNOWN)
4840 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004841 flags = tv_get_string_buf(&argvars[1], nbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004842 for ( ; *flags != NUL; ++flags)
4843 {
4844 switch (*flags)
4845 {
4846 case 'n': remap = FALSE; break;
4847 case 'm': remap = TRUE; break;
4848 case 't': typed = TRUE; break;
4849 case 'i': insert = TRUE; break;
4850 case 'x': execute = TRUE; break;
Bram Moolenaara9725222022-01-16 13:30:33 +00004851 case 'c': context = TRUE; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004852 case '!': dangerous = TRUE; break;
Bram Moolenaar5e66b422019-01-24 21:58:10 +01004853 case 'L': lowlevel = TRUE; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004854 }
4855 }
4856 }
4857
4858 if (*keys != NUL || execute)
4859 {
Christopher Plewright20b795e2022-12-20 20:01:58 +00004860 if (lowlevel
4861#ifdef FEAT_VTP
4862 && (!is_term_win32()
4863 || (keys[0] == 3 && ctrl_c_interrupts && typed))
4864#endif
4865 )
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004866 {
Bram Moolenaar5e66b422019-01-24 21:58:10 +01004867#ifdef USE_INPUT_BUF
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004868 ch_log(NULL, "feedkeys() lowlevel: %s", keys);
Bram Moolenaar9645e2d2020-03-20 20:48:49 +01004869
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004870 int len = (int)STRLEN(keys);
4871 for (int idx = 0; idx < len; ++idx)
4872 {
4873 // if a CTRL-C was typed, set got_int, similar to what
4874 // happens in fill_input_buf()
4875 if (keys[idx] == 3 && ctrl_c_interrupts && typed)
4876 got_int = TRUE;
4877 add_to_input_buf(keys + idx, 1);
4878 }
Bram Moolenaar5e66b422019-01-24 21:58:10 +01004879#else
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004880 emsg(_(e_lowlevel_input_not_supported));
Bram Moolenaar5e66b422019-01-24 21:58:10 +01004881#endif
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004882 }
4883 else
4884 {
4885 // Need to escape K_SPECIAL and CSI before putting the string in
4886 // the typeahead buffer.
4887 char_u *keys_esc = vim_strsave_escape_csi(keys);
4888 if (keys_esc == NULL)
4889 return;
4890
4891 ch_log(NULL, "feedkeys(%s): %s", typed ? "typed" : "", keys);
4892
4893 ins_typebuf(keys_esc, (remap ? REMAP_YES : REMAP_NONE),
4894 insert ? 0 : typebuf.tb_len, !typed, FALSE);
4895 if (vgetc_busy
Bram Moolenaar5d7be4f2017-06-25 13:40:17 +02004896#ifdef FEAT_TIMERS
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004897 || timer_busy
Bram Moolenaar5d7be4f2017-06-25 13:40:17 +02004898#endif
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004899 || input_busy)
4900 typebuf_was_filled = TRUE;
4901
Bram Moolenaar8d4ce562019-01-30 22:01:40 +01004902 vim_free(keys_esc);
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004903 }
Bram Moolenaar8d4ce562019-01-30 22:01:40 +01004904
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004905 if (execute)
4906 {
4907 int save_msg_scroll = msg_scroll;
4908 sctx_T save_sctx;
4909
4910 // Avoid a 1 second delay when the keys start Insert mode.
4911 msg_scroll = FALSE;
4912
4913 ch_log(NULL, "feedkeys() executing");
4914
4915 if (context)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004916 {
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004917 save_sctx = current_sctx;
4918 current_sctx.sc_sid = 0;
4919 current_sctx.sc_version = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004920 }
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004921
4922 if (!dangerous)
4923 {
4924 ++ex_normal_busy;
4925 ++in_feedkeys;
4926 }
4927 exec_normal(TRUE, lowlevel, TRUE);
4928 if (!dangerous)
4929 {
4930 --ex_normal_busy;
4931 --in_feedkeys;
4932 }
4933
4934 msg_scroll |= save_msg_scroll;
4935
4936 if (context)
4937 current_sctx = save_sctx;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004938 }
4939 }
4940}
4941
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004942/*
4943 * "fnameescape({string})" function
4944 */
4945 static void
4946f_fnameescape(typval_T *argvars, typval_T *rettv)
4947{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004948 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
4949 return;
4950
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004951 rettv->vval.v_string = vim_strsave_fnameescape(
Bram Moolenaar21c1a0c2021-10-17 17:20:23 +01004952 tv_get_string(&argvars[0]), VSE_NONE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004953 rettv->v_type = VAR_STRING;
4954}
4955
4956/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004957 * "foreground()" function
4958 */
4959 static void
4960f_foreground(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
4961{
4962#ifdef FEAT_GUI
4963 if (gui.in_use)
Bram Moolenaarafde13b2019-04-28 19:46:49 +02004964 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004965 gui_mch_set_foreground();
Bram Moolenaarafde13b2019-04-28 19:46:49 +02004966 return;
4967 }
4968#endif
4969#if defined(MSWIN) && (!defined(FEAT_GUI) || defined(VIMDLL))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004970 win32_set_foreground();
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004971#endif
4972}
4973
Bakudankun375141e2022-09-09 18:46:47 +01004974/*
4975 * "function()" function
4976 * "funcref()" function
4977 */
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004978 static void
Bram Moolenaar437bafe2016-08-01 15:40:54 +02004979common_function(typval_T *argvars, typval_T *rettv, int is_funcref)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004980{
4981 char_u *s;
4982 char_u *name;
4983 int use_string = FALSE;
4984 partial_T *arg_pt = NULL;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02004985 char_u *trans_name = NULL;
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02004986 int is_global = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004987
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02004988 if (in_vim9script()
Bram Moolenaarae1068a2021-12-25 19:43:44 +00004989 && (check_for_string_or_func_arg(argvars, 0) == FAIL
4990 || check_for_opt_list_arg(argvars, 1) == FAIL
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02004991 || (argvars[1].v_type != VAR_UNKNOWN
4992 && check_for_opt_dict_arg(argvars, 2) == FAIL)))
4993 return;
4994
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004995 if (argvars[0].v_type == VAR_FUNC)
4996 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004997 // function(MyFunc, [arg], dict)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004998 s = argvars[0].vval.v_string;
4999 }
5000 else if (argvars[0].v_type == VAR_PARTIAL
5001 && argvars[0].vval.v_partial != NULL)
5002 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005003 // function(dict.MyFunc, [arg])
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005004 arg_pt = argvars[0].vval.v_partial;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005005 s = partial_name(arg_pt);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005006 }
5007 else
5008 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005009 // function('MyFunc', [arg], dict)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005010 s = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005011 use_string = TRUE;
5012 }
Bram Moolenaar60b6e6f2021-08-28 12:49:27 +02005013 if (s == NULL)
5014 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00005015 semsg(_(e_invalid_argument_str), "NULL");
Bram Moolenaar60b6e6f2021-08-28 12:49:27 +02005016 return;
5017 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005018
Bram Moolenaar843b8842016-08-21 14:36:15 +02005019 if ((use_string && vim_strchr(s, AUTOLOAD_CHAR) == NULL) || is_funcref)
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005020 {
5021 name = s;
Bram Moolenaareba3b7f2021-11-30 18:25:08 +00005022 trans_name = save_function_name(&name, &is_global, FALSE,
5023 TFN_INT | TFN_QUIET | TFN_NO_AUTOLOAD | TFN_NO_DEREF, NULL);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005024 if (*name != NUL)
5025 s = NULL;
5026 }
5027
Bram Moolenaar843b8842016-08-21 14:36:15 +02005028 if (s == NULL || *s == NUL || (use_string && VIM_ISDIGIT(*s))
5029 || (is_funcref && trans_name == NULL))
Yegappan Lakshmanan655b7342022-03-06 14:27:10 +00005030 semsg(_(e_invalid_argument_str),
5031 use_string ? tv_get_string(&argvars[0]) : s);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005032 // Don't check an autoload name for existence here.
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005033 else if (trans_name != NULL && (is_funcref
Bram Moolenaard9d2fd02022-01-13 21:15:21 +00005034 ? find_func(trans_name, is_global) == NULL
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02005035 : !translated_function_exists(trans_name, is_global)))
Bram Moolenaara6f79292022-01-04 21:30:47 +00005036 semsg(_(e_unknown_function_str_2), s);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005037 else
5038 {
5039 int dict_idx = 0;
5040 int arg_idx = 0;
5041 list_T *list = NULL;
5042
5043 if (STRNCMP(s, "s:", 2) == 0 || STRNCMP(s, "<SID>", 5) == 0)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005044 // Expand s: and <SID> into <SNR>nr_, so that the function can
5045 // also be called from another script. Using trans_function_name()
5046 // would also work, but some plugins depend on the name being
5047 // printable text.
Yegappan Lakshmanane7f4abd2021-12-24 20:47:38 +00005048 name = get_scriptlocal_funcname(s);
Bram Moolenaarc2f17f72022-02-21 13:13:50 +00005049 else if (trans_name != NULL && *trans_name == K_SPECIAL)
5050 name = alloc_printable_func_name(trans_name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005051 else
5052 name = vim_strsave(s);
5053
5054 if (argvars[1].v_type != VAR_UNKNOWN)
5055 {
5056 if (argvars[2].v_type != VAR_UNKNOWN)
5057 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005058 // function(name, [args], dict)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005059 arg_idx = 1;
5060 dict_idx = 2;
5061 }
5062 else if (argvars[1].v_type == VAR_DICT)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005063 // function(name, dict)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005064 dict_idx = 1;
5065 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005066 // function(name, [args])
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005067 arg_idx = 1;
5068 if (dict_idx > 0)
5069 {
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +01005070 if (check_for_dict_arg(argvars, dict_idx) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005071 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005072 vim_free(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005073 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005074 }
5075 if (argvars[dict_idx].vval.v_dict == NULL)
5076 dict_idx = 0;
5077 }
5078 if (arg_idx > 0)
5079 {
5080 if (argvars[arg_idx].v_type != VAR_LIST)
5081 {
Bram Moolenaard82a47d2022-01-05 20:24:39 +00005082 emsg(_(e_second_argument_of_function_must_be_list_or_dict));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005083 vim_free(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005084 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005085 }
5086 list = argvars[arg_idx].vval.v_list;
5087 if (list == NULL || list->lv_len == 0)
5088 arg_idx = 0;
Bram Moolenaar4c054e92019-11-10 00:13:50 +01005089 else if (list->lv_len > MAX_FUNC_ARGS)
5090 {
Yegappan Lakshmanan5018a832022-04-02 21:12:21 +01005091 emsg_funcname(e_too_many_arguments_for_function_str, s);
Bram Moolenaar4c054e92019-11-10 00:13:50 +01005092 vim_free(name);
5093 goto theend;
5094 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005095 }
5096 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005097 if (dict_idx > 0 || arg_idx > 0 || arg_pt != NULL || is_funcref)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005098 {
Bram Moolenaarc799fe22019-05-28 23:08:19 +02005099 partial_T *pt = ALLOC_CLEAR_ONE(partial_T);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005100
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005101 // result is a VAR_PARTIAL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005102 if (pt == NULL)
5103 vim_free(name);
5104 else
5105 {
5106 if (arg_idx > 0 || (arg_pt != NULL && arg_pt->pt_argc > 0))
5107 {
5108 listitem_T *li;
5109 int i = 0;
5110 int arg_len = 0;
5111 int lv_len = 0;
5112
5113 if (arg_pt != NULL)
5114 arg_len = arg_pt->pt_argc;
5115 if (list != NULL)
5116 lv_len = list->lv_len;
5117 pt->pt_argc = arg_len + lv_len;
Bram Moolenaarc799fe22019-05-28 23:08:19 +02005118 pt->pt_argv = ALLOC_MULT(typval_T, pt->pt_argc);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005119 if (pt->pt_argv == NULL)
5120 {
5121 vim_free(pt);
5122 vim_free(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005123 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005124 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005125 for (i = 0; i < arg_len; i++)
5126 copy_tv(&arg_pt->pt_argv[i], &pt->pt_argv[i]);
5127 if (lv_len > 0)
Bram Moolenaar50985eb2020-01-27 22:09:39 +01005128 {
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02005129 CHECK_LIST_MATERIALIZE(list);
Bram Moolenaaraeea7212020-04-02 18:50:46 +02005130 FOR_ALL_LIST_ITEMS(list, li)
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005131 copy_tv(&li->li_tv, &pt->pt_argv[i++]);
Bram Moolenaar50985eb2020-01-27 22:09:39 +01005132 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005133 }
5134
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005135 // For "function(dict.func, [], dict)" and "func" is a partial
5136 // use "dict". That is backwards compatible.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005137 if (dict_idx > 0)
5138 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005139 // The dict is bound explicitly, pt_auto is FALSE.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005140 pt->pt_dict = argvars[dict_idx].vval.v_dict;
5141 ++pt->pt_dict->dv_refcount;
5142 }
5143 else if (arg_pt != NULL)
5144 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005145 // If the dict was bound automatically the result is also
5146 // bound automatically.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005147 pt->pt_dict = arg_pt->pt_dict;
5148 pt->pt_auto = arg_pt->pt_auto;
5149 if (pt->pt_dict != NULL)
5150 ++pt->pt_dict->dv_refcount;
Yegappan Lakshmanan29bb67f2023-10-14 11:18:50 +02005151 pt->pt_obj = arg_pt->pt_obj;
5152 if (pt->pt_obj != NULL)
5153 ++pt->pt_obj->obj_refcount;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005154 }
5155
5156 pt->pt_refcount = 1;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005157 if (arg_pt != NULL && arg_pt->pt_func != NULL)
5158 {
5159 pt->pt_func = arg_pt->pt_func;
5160 func_ptr_ref(pt->pt_func);
5161 vim_free(name);
5162 }
5163 else if (is_funcref)
5164 {
Bram Moolenaard9d2fd02022-01-13 21:15:21 +00005165 pt->pt_func = find_func(trans_name, is_global);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005166 func_ptr_ref(pt->pt_func);
5167 vim_free(name);
5168 }
5169 else
5170 {
5171 pt->pt_name = name;
5172 func_ref(name);
5173 }
Bram Moolenaar92368aa2022-02-07 17:50:39 +00005174
5175 if (arg_pt != NULL)
Bram Moolenaar7aca5ca2022-02-07 19:56:43 +00005176 {
5177 pt->pt_outer_partial = arg_pt;
5178 ++arg_pt->pt_refcount;
5179 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005180 }
5181 rettv->v_type = VAR_PARTIAL;
5182 rettv->vval.v_partial = pt;
5183 }
5184 else
5185 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005186 // result is a VAR_FUNC
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005187 rettv->v_type = VAR_FUNC;
5188 rettv->vval.v_string = name;
5189 func_ref(name);
5190 }
5191 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005192theend:
5193 vim_free(trans_name);
5194}
5195
5196/*
5197 * "funcref()" function
5198 */
5199 static void
5200f_funcref(typval_T *argvars, typval_T *rettv)
5201{
5202 common_function(argvars, rettv, TRUE);
5203}
5204
5205/*
5206 * "function()" function
5207 */
5208 static void
5209f_function(typval_T *argvars, typval_T *rettv)
5210{
5211 common_function(argvars, rettv, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005212}
5213
5214/*
5215 * "garbagecollect()" function
5216 */
5217 static void
5218f_garbagecollect(typval_T *argvars, typval_T *rettv UNUSED)
5219{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005220 if (in_vim9script() && check_for_opt_bool_arg(argvars, 0) == FAIL)
5221 return;
5222
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005223 // This is postponed until we are back at the toplevel, because we may be
5224 // using Lists and Dicts internally. E.g.: ":echo [garbagecollect()]".
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005225 want_garbage_collect = TRUE;
5226
Bram Moolenaar2df47312020-09-05 17:30:44 +02005227 if (argvars[0].v_type != VAR_UNKNOWN && tv_get_bool(&argvars[0]) == 1)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005228 garbage_collect_at_exit = TRUE;
5229}
5230
5231/*
5232 * "get()" function
5233 */
5234 static void
5235f_get(typval_T *argvars, typval_T *rettv)
5236{
5237 listitem_T *li;
5238 list_T *l;
5239 dictitem_T *di;
5240 dict_T *d;
5241 typval_T *tv = NULL;
Bram Moolenaarf91aac52019-07-28 13:21:01 +02005242 int what_is_dict = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005243
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005244 if (argvars[0].v_type == VAR_BLOB)
5245 {
5246 int error = FALSE;
5247 int idx = tv_get_number_chk(&argvars[1], &error);
5248
5249 if (!error)
5250 {
5251 rettv->v_type = VAR_NUMBER;
Bram Moolenaar2ea773b2019-01-15 22:16:42 +01005252 if (idx < 0)
5253 idx = blob_len(argvars[0].vval.v_blob) + idx;
5254 if (idx < 0 || idx >= blob_len(argvars[0].vval.v_blob))
5255 rettv->vval.v_number = -1;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005256 else
Bram Moolenaar2ea773b2019-01-15 22:16:42 +01005257 {
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005258 rettv->vval.v_number = blob_get(argvars[0].vval.v_blob, idx);
Bram Moolenaar2ea773b2019-01-15 22:16:42 +01005259 tv = rettv;
5260 }
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005261 }
5262 }
5263 else if (argvars[0].v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005264 {
5265 if ((l = argvars[0].vval.v_list) != NULL)
5266 {
5267 int error = FALSE;
5268
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005269 li = list_find(l, (long)tv_get_number_chk(&argvars[1], &error));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005270 if (!error && li != NULL)
5271 tv = &li->li_tv;
5272 }
5273 }
5274 else if (argvars[0].v_type == VAR_DICT)
5275 {
5276 if ((d = argvars[0].vval.v_dict) != NULL)
5277 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005278 di = dict_find(d, tv_get_string(&argvars[1]), -1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005279 if (di != NULL)
5280 tv = &di->di_tv;
5281 }
5282 }
5283 else if (argvars[0].v_type == VAR_PARTIAL || argvars[0].v_type == VAR_FUNC)
5284 {
5285 partial_T *pt;
5286 partial_T fref_pt;
5287
5288 if (argvars[0].v_type == VAR_PARTIAL)
5289 pt = argvars[0].vval.v_partial;
5290 else
5291 {
Bram Moolenaara80faa82020-04-12 19:37:17 +02005292 CLEAR_FIELD(fref_pt);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005293 fref_pt.pt_name = argvars[0].vval.v_string;
5294 pt = &fref_pt;
5295 }
5296
5297 if (pt != NULL)
5298 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005299 char_u *what = tv_get_string(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005300
5301 if (STRCMP(what, "func") == 0 || STRCMP(what, "name") == 0)
5302 {
Bram Moolenaar1ae8c262022-06-27 11:45:52 +01005303 char_u *name = partial_name(pt);
5304
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005305 rettv->v_type = (*what == 'f' ? VAR_FUNC : VAR_STRING);
Bram Moolenaar1ae8c262022-06-27 11:45:52 +01005306 if (name == NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005307 rettv->vval.v_string = NULL;
5308 else
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005309 {
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005310 if (rettv->v_type == VAR_FUNC)
Bram Moolenaar1ae8c262022-06-27 11:45:52 +01005311 func_ref(name);
5312 if (*what == 'n' && pt->pt_name == NULL
5313 && pt->pt_func != NULL)
5314 // use <SNR> instead of the byte code
5315 name = printable_func_name(pt->pt_func);
5316 rettv->vval.v_string = vim_strsave(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005317 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005318 }
5319 else if (STRCMP(what, "dict") == 0)
Bram Moolenaarf91aac52019-07-28 13:21:01 +02005320 {
5321 what_is_dict = TRUE;
5322 if (pt->pt_dict != NULL)
5323 rettv_dict_set(rettv, pt->pt_dict);
5324 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005325 else if (STRCMP(what, "args") == 0)
5326 {
5327 rettv->v_type = VAR_LIST;
5328 if (rettv_list_alloc(rettv) == OK)
5329 {
5330 int i;
5331
5332 for (i = 0; i < pt->pt_argc; ++i)
5333 list_append_tv(rettv->vval.v_list, &pt->pt_argv[i]);
5334 }
5335 }
LemonBoy48b7d052024-07-09 18:24:59 +02005336 else if (STRCMP(what, "arity") == 0)
5337 {
5338 int required = 0, optional = 0, varargs = FALSE;
5339 char_u *name = partial_name(pt);
5340
5341 get_func_arity(name, &required, &optional, &varargs);
5342
5343 rettv->v_type = VAR_DICT;
5344 if (rettv_dict_alloc(rettv) == OK)
5345 {
5346 dict_T *dict = rettv->vval.v_dict;
5347
5348 // Take into account the arguments of the partial, if any.
5349 // Note that it is possible to supply more arguments than the function
5350 // accepts.
5351 if (pt->pt_argc >= required + optional)
5352 required = optional = 0;
5353 else if (pt->pt_argc > required)
5354 {
5355 optional -= pt->pt_argc - required;
5356 required = 0;
5357 }
5358 else
5359 required -= pt->pt_argc;
5360
5361 dict_add_number(dict, "required", required);
5362 dict_add_number(dict, "optional", optional);
5363 dict_add_bool(dict, "varargs", varargs);
5364 }
5365 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005366 else
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00005367 semsg(_(e_invalid_argument_str), what);
Bram Moolenaarf91aac52019-07-28 13:21:01 +02005368
5369 // When {what} == "dict" and pt->pt_dict == NULL, evaluate the
5370 // third argument
5371 if (!what_is_dict)
5372 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005373 }
5374 }
5375 else
Bram Moolenaar460ae5d2022-01-01 14:19:49 +00005376 semsg(_(e_argument_of_str_must_be_list_dictionary_or_blob), "get()");
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005377
5378 if (tv == NULL)
5379 {
5380 if (argvars[2].v_type != VAR_UNKNOWN)
5381 copy_tv(&argvars[2], rettv);
5382 }
5383 else
5384 copy_tv(tv, rettv);
5385}
5386
Bram Moolenaarb5ae48e2016-08-12 22:23:25 +02005387/*
mikoto2000a73dfc22024-11-18 21:12:21 +01005388 * "getcellpixels()" function
5389 */
5390 static void
5391f_getcellpixels(typval_T *argvars UNUSED, typval_T *rettv)
5392{
5393 if (rettv_list_alloc(rettv) == FAIL)
5394 return;
5395
5396#if defined(FEAT_GUI)
5397 if (gui.in_use)
5398 {
5399 // success pixel size and no gui.
5400 list_append_number(rettv->vval.v_list, (varnumber_T)gui.char_width);
5401 list_append_number(rettv->vval.v_list, (varnumber_T)gui.char_height);
5402 }
5403 else
5404#endif
5405 {
5406 struct cellsize cs;
5407#if defined(UNIX)
5408 mch_calc_cell_size(&cs);
5409#else
5410 // Non-Unix CUIs are not supported, so set this to -1x-1.
5411 cs.cs_xpixel = -1;
5412 cs.cs_ypixel = -1;
5413#endif
5414
5415 // failed get pixel size.
5416 if (cs.cs_xpixel == -1)
5417 return;
5418
5419 // success pixel size and no gui.
5420 list_append_number(rettv->vval.v_list, (varnumber_T)cs.cs_xpixel);
5421 list_append_number(rettv->vval.v_list, (varnumber_T)cs.cs_ypixel);
5422 }
5423
5424}
5425
5426/*
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005427 * "getchangelist()" function
5428 */
5429 static void
5430f_getchangelist(typval_T *argvars, typval_T *rettv)
5431{
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005432 buf_T *buf;
5433 int i;
5434 list_T *l;
5435 dict_T *d;
LemonBoydb0ea7f2022-04-10 17:59:26 +01005436 int changelistindex;
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005437
Bram Moolenaar93a10962022-06-16 11:42:09 +01005438 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005439 return;
5440
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005441 if (in_vim9script() && check_for_opt_buffer_arg(argvars, 0) == FAIL)
5442 return;
5443
Bram Moolenaar4c313b12019-08-24 22:58:31 +02005444 if (argvars[0].v_type == VAR_UNKNOWN)
5445 buf = curbuf;
5446 else
Bram Moolenaara5d38412020-09-02 21:02:35 +02005447 buf = tv_get_buf_from_arg(&argvars[0]);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005448 if (buf == NULL)
5449 return;
5450
5451 l = list_alloc();
5452 if (l == NULL)
5453 return;
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005454 if (list_append_list(rettv->vval.v_list, l) == FAIL)
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005455 {
5456 vim_free(l);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005457 return;
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005458 }
5459
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005460 /*
LemonBoydb0ea7f2022-04-10 17:59:26 +01005461 * The current window change list index tracks only the position for the
5462 * current buffer. For other buffers use the stored index for the current
5463 * window, or, if that's not available, the change list length.
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005464 */
LemonBoydb0ea7f2022-04-10 17:59:26 +01005465 if (buf == curwin->w_buffer)
5466 {
5467 changelistindex = curwin->w_changelistidx;
5468 }
5469 else
5470 {
5471 wininfo_T *wip;
5472
5473 FOR_ALL_BUF_WININFO(buf, wip)
5474 if (wip->wi_win == curwin)
5475 break;
5476 changelistindex = wip != NULL ? wip->wi_changelistidx
5477 : buf->b_changelistlen;
5478 }
5479 list_append_number(rettv->vval.v_list, (varnumber_T)changelistindex);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005480
5481 for (i = 0; i < buf->b_changelistlen; ++i)
5482 {
5483 if (buf->b_changelist[i].lnum == 0)
5484 continue;
5485 if ((d = dict_alloc()) == NULL)
5486 return;
5487 if (list_append_dict(l, d) == FAIL)
5488 return;
Bram Moolenaare0be1672018-07-08 16:50:37 +02005489 dict_add_number(d, "lnum", (long)buf->b_changelist[i].lnum);
5490 dict_add_number(d, "col", (long)buf->b_changelist[i].col);
Bram Moolenaare0be1672018-07-08 16:50:37 +02005491 dict_add_number(d, "coladd", (long)buf->b_changelist[i].coladd);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005492 }
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005493}
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005494
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005495 static void
5496getpos_both(
5497 typval_T *argvars,
5498 typval_T *rettv,
5499 int getcurpos,
5500 int charcol)
5501{
5502 pos_T *fp = NULL;
5503 pos_T pos;
5504 win_T *wp = curwin;
5505 list_T *l;
5506 int fnum = -1;
5507
5508 if (rettv_list_alloc(rettv) == OK)
5509 {
5510 l = rettv->vval.v_list;
5511 if (getcurpos)
5512 {
5513 if (argvars[0].v_type != VAR_UNKNOWN)
5514 {
5515 wp = find_win_by_nr_or_id(&argvars[0]);
5516 if (wp != NULL)
5517 fp = &wp->w_cursor;
5518 }
5519 else
5520 fp = &curwin->w_cursor;
5521 if (fp != NULL && charcol)
5522 {
5523 pos = *fp;
Bram Moolenaar91458462021-01-13 20:08:38 +01005524 pos.col =
5525 buf_byteidx_to_charidx(wp->w_buffer, pos.lnum, pos.col);
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005526 fp = &pos;
5527 }
5528 }
5529 else
5530 fp = var2fpos(&argvars[0], TRUE, &fnum, charcol);
5531 if (fnum != -1)
5532 list_append_number(l, (varnumber_T)fnum);
5533 else
5534 list_append_number(l, (varnumber_T)0);
5535 list_append_number(l, (fp != NULL) ? (varnumber_T)fp->lnum
5536 : (varnumber_T)0);
5537 list_append_number(l, (fp != NULL)
5538 ? (varnumber_T)(fp->col == MAXCOL ? MAXCOL : fp->col + 1)
5539 : (varnumber_T)0);
5540 list_append_number(l, (fp != NULL) ? (varnumber_T)fp->coladd :
5541 (varnumber_T)0);
5542 if (getcurpos)
5543 {
5544 int save_set_curswant = curwin->w_set_curswant;
5545 colnr_T save_curswant = curwin->w_curswant;
5546 colnr_T save_virtcol = curwin->w_virtcol;
5547
5548 if (wp == curwin)
5549 update_curswant();
5550 list_append_number(l, wp == NULL ? 0 : wp->w_curswant == MAXCOL
5551 ? (varnumber_T)MAXCOL : (varnumber_T)wp->w_curswant + 1);
5552
5553 // Do not change "curswant", as it is unexpected that a get
5554 // function has a side effect.
5555 if (wp == curwin && save_set_curswant)
5556 {
5557 curwin->w_set_curswant = save_set_curswant;
5558 curwin->w_curswant = save_curswant;
5559 curwin->w_virtcol = save_virtcol;
5560 curwin->w_valid &= ~VALID_VIRTCOL;
5561 }
5562 }
5563 }
5564 else
5565 rettv->vval.v_number = FALSE;
5566}
5567
5568/*
5569 * "getcharpos()" function
5570 */
5571 static void
5572f_getcharpos(typval_T *argvars UNUSED, typval_T *rettv)
5573{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005574 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5575 return;
5576
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005577 getpos_both(argvars, rettv, FALSE, TRUE);
5578}
5579
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005580/*
5581 * "getcharsearch()" function
5582 */
5583 static void
5584f_getcharsearch(typval_T *argvars UNUSED, typval_T *rettv)
5585{
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00005586 if (rettv_dict_alloc(rettv) != OK)
5587 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005588
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00005589 dict_T *dict = rettv->vval.v_dict;
5590
5591 dict_add_string(dict, "char", last_csearch());
5592 dict_add_number(dict, "forward", last_csearch_forward());
5593 dict_add_number(dict, "until", last_csearch_until());
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005594}
5595
5596/*
Bram Moolenaar691ddee2019-05-09 14:52:41 +02005597 * "getenv()" function
5598 */
5599 static void
5600f_getenv(typval_T *argvars, typval_T *rettv)
5601{
5602 int mustfree = FALSE;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005603 char_u *p;
Bram Moolenaar691ddee2019-05-09 14:52:41 +02005604
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005605 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5606 return;
5607
5608 p = vim_getenv(tv_get_string(&argvars[0]), &mustfree);
Bram Moolenaar691ddee2019-05-09 14:52:41 +02005609 if (p == NULL)
5610 {
5611 rettv->v_type = VAR_SPECIAL;
5612 rettv->vval.v_number = VVAL_NULL;
5613 return;
5614 }
5615 if (!mustfree)
5616 p = vim_strsave(p);
5617 rettv->vval.v_string = p;
5618 rettv->v_type = VAR_STRING;
5619}
5620
5621/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005622 * "getfontname()" function
5623 */
5624 static void
5625f_getfontname(typval_T *argvars UNUSED, typval_T *rettv)
5626{
5627 rettv->v_type = VAR_STRING;
5628 rettv->vval.v_string = NULL;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005629
5630 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
5631 return;
5632
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005633#ifdef FEAT_GUI
5634 if (gui.in_use)
5635 {
5636 GuiFont font;
5637 char_u *name = NULL;
5638
5639 if (argvars[0].v_type == VAR_UNKNOWN)
5640 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005641 // Get the "Normal" font. Either the name saved by
5642 // hl_set_font_name() or from the font ID.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005643 font = gui.norm_font;
5644 name = hl_get_font_name();
5645 }
5646 else
5647 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005648 name = tv_get_string(&argvars[0]);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005649 if (STRCMP(name, "*") == 0) // don't use font dialog
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005650 return;
5651 font = gui_mch_get_font(name, FALSE);
5652 if (font == NOFONT)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005653 return; // Invalid font name, return empty string.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005654 }
5655 rettv->vval.v_string = gui_mch_get_fontname(font, name);
5656 if (argvars[0].v_type != VAR_UNKNOWN)
5657 gui_mch_free_font(font);
5658 }
5659#endif
5660}
5661
5662/*
Bram Moolenaar4f505882018-02-10 21:06:32 +01005663 * "getjumplist()" function
5664 */
5665 static void
5666f_getjumplist(typval_T *argvars, typval_T *rettv)
5667{
Bram Moolenaar4f505882018-02-10 21:06:32 +01005668 win_T *wp;
5669 int i;
5670 list_T *l;
5671 dict_T *d;
Bram Moolenaar4f505882018-02-10 21:06:32 +01005672
Bram Moolenaar93a10962022-06-16 11:42:09 +01005673 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar4f505882018-02-10 21:06:32 +01005674 return;
5675
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005676 if (in_vim9script()
5677 && (check_for_opt_number_arg(argvars, 0) == FAIL
5678 || (argvars[0].v_type != VAR_UNKNOWN
5679 && check_for_opt_number_arg(argvars, 1) == FAIL)))
5680 return;
5681
Bram Moolenaar00aa0692019-04-27 20:37:57 +02005682 wp = find_tabwin(&argvars[0], &argvars[1], NULL);
Bram Moolenaar4f505882018-02-10 21:06:32 +01005683 if (wp == NULL)
5684 return;
5685
Bram Moolenaar57ee2b62019-02-12 22:15:06 +01005686 cleanup_jumplist(wp, TRUE);
5687
Bram Moolenaar4f505882018-02-10 21:06:32 +01005688 l = list_alloc();
5689 if (l == NULL)
5690 return;
Bram Moolenaar4f505882018-02-10 21:06:32 +01005691 if (list_append_list(rettv->vval.v_list, l) == FAIL)
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005692 {
5693 vim_free(l);
Bram Moolenaar4f505882018-02-10 21:06:32 +01005694 return;
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005695 }
5696
Bram Moolenaar4f505882018-02-10 21:06:32 +01005697 list_append_number(rettv->vval.v_list, (varnumber_T)wp->w_jumplistidx);
5698
5699 for (i = 0; i < wp->w_jumplistlen; ++i)
5700 {
Bram Moolenaara7e18d22018-02-11 14:29:49 +01005701 if (wp->w_jumplist[i].fmark.mark.lnum == 0)
5702 continue;
Bram Moolenaar4f505882018-02-10 21:06:32 +01005703 if ((d = dict_alloc()) == NULL)
5704 return;
5705 if (list_append_dict(l, d) == FAIL)
5706 return;
Bram Moolenaare0be1672018-07-08 16:50:37 +02005707 dict_add_number(d, "lnum", (long)wp->w_jumplist[i].fmark.mark.lnum);
5708 dict_add_number(d, "col", (long)wp->w_jumplist[i].fmark.mark.col);
Bram Moolenaare0be1672018-07-08 16:50:37 +02005709 dict_add_number(d, "coladd", (long)wp->w_jumplist[i].fmark.mark.coladd);
Bram Moolenaare0be1672018-07-08 16:50:37 +02005710 dict_add_number(d, "bufnr", (long)wp->w_jumplist[i].fmark.fnum);
Bram Moolenaara7e18d22018-02-11 14:29:49 +01005711 if (wp->w_jumplist[i].fname != NULL)
Bram Moolenaare0be1672018-07-08 16:50:37 +02005712 dict_add_string(d, "filename", wp->w_jumplist[i].fname);
Bram Moolenaar4f505882018-02-10 21:06:32 +01005713 }
Bram Moolenaar4f505882018-02-10 21:06:32 +01005714}
5715
5716/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005717 * "getpid()" function
5718 */
5719 static void
5720f_getpid(typval_T *argvars UNUSED, typval_T *rettv)
5721{
5722 rettv->vval.v_number = mch_get_pid();
5723}
5724
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005725/*
5726 * "getcurpos()" function
5727 */
5728 static void
5729f_getcurpos(typval_T *argvars, typval_T *rettv)
5730{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005731 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
5732 return;
5733
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005734 getpos_both(argvars, rettv, TRUE, FALSE);
5735}
5736
5737 static void
5738f_getcursorcharpos(typval_T *argvars, typval_T *rettv)
5739{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005740 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
5741 return;
5742
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005743 getpos_both(argvars, rettv, TRUE, TRUE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005744}
5745
5746/*
5747 * "getpos(string)" function
5748 */
5749 static void
5750f_getpos(typval_T *argvars, typval_T *rettv)
5751{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005752 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5753 return;
5754
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005755 getpos_both(argvars, rettv, FALSE, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005756}
5757
5758/*
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005759 * Convert from block_def to string
5760 */
Gary Johnson88d4f252024-06-01 20:51:33 +02005761 static char_u *
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005762block_def2str(struct block_def *bd)
5763{
5764 char_u *p, *ret;
5765 size_t size = bd->startspaces + bd->endspaces + bd->textlen;
5766
5767 ret = alloc(size + 1);
5768 if (ret != NULL)
5769 {
5770 p = ret;
5771 vim_memset(p, ' ', bd->startspaces);
5772 p += bd->startspaces;
5773 mch_memmove(p, bd->textstart, bd->textlen);
5774 p += bd->textlen;
5775 vim_memset(p, ' ', bd->endspaces);
5776 *(p + bd->endspaces) = NUL;
5777 }
5778 return ret;
5779}
5780
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005781 static int
5782getregionpos(
5783 typval_T *argvars,
5784 typval_T *rettv,
zeertzjqc95e64f2024-05-20 14:00:31 +02005785 pos_T *p1,
5786 pos_T *p2,
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005787 int *inclusive,
5788 int *region_type,
zeertzjqafc22952024-05-24 19:07:12 +02005789 oparg_T *oap)
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005790{
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005791 int fnum1 = -1, fnum2 = -1;
5792 char_u *type;
5793 buf_T *findbuf;
5794 char_u default_type[] = "v";
zeertzjqafc22952024-05-24 19:07:12 +02005795 int block_width = 0;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005796 int is_select_exclusive;
5797 int l;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005798
5799 if (rettv_list_alloc(rettv) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005800 return FAIL;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005801
Shougo Matsushita19b71882024-02-28 22:48:12 +01005802 if (check_for_list_arg(argvars, 0) == FAIL
5803 || check_for_list_arg(argvars, 1) == FAIL
5804 || check_for_opt_dict_arg(argvars, 2) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005805 return FAIL;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005806
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005807 if (list2fpos(&argvars[0], p1, &fnum1, NULL, FALSE) != OK
5808 || list2fpos(&argvars[1], p2, &fnum2, NULL, FALSE) != OK
Shougo Matsushita84bf6e62024-03-06 21:10:18 +01005809 || fnum1 != fnum2)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005810 return FAIL;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005811
Shougo Matsushita19b71882024-02-28 22:48:12 +01005812 if (argvars[2].v_type == VAR_DICT)
5813 {
5814 is_select_exclusive = dict_get_bool(
5815 argvars[2].vval.v_dict, "exclusive", *p_sel == 'e');
5816 type = dict_get_string(
5817 argvars[2].vval.v_dict, "type", FALSE);
5818 if (type == NULL)
5819 type = default_type;
5820 }
5821 else
5822 {
5823 is_select_exclusive = *p_sel == 'e';
5824 type = default_type;
5825 }
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005826
5827 if (type[0] == 'v' && type[1] == NUL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005828 *region_type = MCHAR;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005829 else if (type[0] == 'V' && type[1] == NUL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005830 *region_type = MLINE;
zeertzjqafc22952024-05-24 19:07:12 +02005831 else if (type[0] == Ctrl_V)
5832 {
5833 char_u *p = type + 1;
5834
5835 if (*p != NUL && ((block_width = getdigits(&p)) <= 0 || *p != NUL))
5836 {
5837 semsg(_(e_invalid_value_for_argument_str_str), "type", type);
5838 return FAIL;
5839 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005840 *region_type = MBLOCK;
zeertzjqafc22952024-05-24 19:07:12 +02005841 }
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005842 else
zeertzjq26dd09a2024-03-10 15:46:58 +01005843 {
5844 semsg(_(e_invalid_value_for_argument_str_str), "type", type);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005845 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01005846 }
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005847
zeertzjq5406eb82024-03-11 21:36:42 +01005848 findbuf = fnum1 != 0 ? buflist_findnr(fnum1) : curbuf;
5849 if (findbuf == NULL || findbuf->b_ml.ml_mfp == NULL)
Shougo Matsushita84bf6e62024-03-06 21:10:18 +01005850 {
zeertzjq5406eb82024-03-11 21:36:42 +01005851 emsg(_(e_buffer_is_not_loaded));
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005852 return FAIL;
Shougo Matsushita84bf6e62024-03-06 21:10:18 +01005853 }
5854
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005855 if (p1->lnum < 1 || p1->lnum > findbuf->b_ml.ml_line_count)
zeertzjq26dd09a2024-03-10 15:46:58 +01005856 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005857 semsg(_(e_invalid_line_number_nr), p1->lnum);
5858 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01005859 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005860 if (p1->col == MAXCOL)
5861 p1->col = ml_get_buf_len(findbuf, p1->lnum) + 1;
5862 else if (p1->col < 1 || p1->col > ml_get_buf_len(findbuf, p1->lnum) + 1)
zeertzjq26dd09a2024-03-10 15:46:58 +01005863 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005864 semsg(_(e_invalid_column_number_nr), p1->col);
5865 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01005866 }
zeertzjq2ffdae72024-05-02 13:06:24 +02005867
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005868 if (p2->lnum < 1 || p2->lnum > findbuf->b_ml.ml_line_count)
zeertzjq26dd09a2024-03-10 15:46:58 +01005869 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005870 semsg(_(e_invalid_line_number_nr), p2->lnum);
5871 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01005872 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005873 if (p2->col == MAXCOL)
5874 p2->col = ml_get_buf_len(findbuf, p2->lnum) + 1;
5875 else if (p2->col < 1 || p2->col > ml_get_buf_len(findbuf, p2->lnum) + 1)
zeertzjq26dd09a2024-03-10 15:46:58 +01005876 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005877 semsg(_(e_invalid_column_number_nr), p2->col);
5878 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01005879 }
5880
5881 curbuf = findbuf;
zeertzjq5406eb82024-03-11 21:36:42 +01005882 curwin->w_buffer = curbuf;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005883 virtual_op = virtual_active();
5884
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005885 // NOTE: Adjustment is needed.
5886 p1->col--;
5887 p2->col--;
Shougo Matsushita19b71882024-02-28 22:48:12 +01005888
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005889 if (!LT_POS(*p1, *p2))
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005890 {
5891 // swap position
5892 pos_T p;
5893
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005894 p = *p1;
5895 *p1 = *p2;
5896 *p2 = p;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005897 }
5898
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005899 if (*region_type == MCHAR)
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005900 {
zeertzjq701ad502024-05-23 07:47:55 +02005901 // Handle 'selection' == "exclusive".
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005902 if (is_select_exclusive && !EQUAL_POS(*p1, *p2))
zeertzjq701ad502024-05-23 07:47:55 +02005903 // When backing up to previous line, inclusive becomes false.
5904 *inclusive = !unadjust_for_sel_inner(p2);
5905 // If p2 is on NUL (end of line), inclusive becomes false.
5906 if (*inclusive && !virtual_op && *ml_get_pos(p2) == NUL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005907 *inclusive = FALSE;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005908 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005909 else if (*region_type == MBLOCK)
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005910 {
5911 colnr_T sc1, ec1, sc2, ec2;
5912
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005913 getvvcol(curwin, p1, &sc1, NULL, &ec1);
5914 getvvcol(curwin, p2, &sc2, NULL, &ec2);
zeertzjqafc22952024-05-24 19:07:12 +02005915 oap->motion_type = MBLOCK;
5916 oap->inclusive = TRUE;
5917 oap->op_type = OP_NOP;
5918 oap->start = *p1;
5919 oap->end = *p2;
5920 oap->start_vcol = MIN(sc1, sc2);
5921 if (block_width > 0)
5922 oap->end_vcol = oap->start_vcol + block_width - 1;
5923 else if (is_select_exclusive && ec1 < sc2 && 0 < sc2 && ec2 > ec1)
5924 oap->end_vcol = sc2 - 1;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005925 else
zeertzjqafc22952024-05-24 19:07:12 +02005926 oap->end_vcol = MAX(ec1, ec2);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005927 }
5928
5929 // Include the trailing byte of a multi-byte char.
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005930 l = mb_ptr2len((char_u *)ml_get_pos(p2));
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005931 if (l > 1)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005932 p2->col += l - 1;
5933
5934 return OK;
5935}
5936
5937/*
5938 * "getregion()" function
5939 */
5940 static void
5941f_getregion(typval_T *argvars, typval_T *rettv)
5942{
5943 pos_T p1, p2;
5944 int inclusive = TRUE;
5945 int region_type = -1;
5946 oparg_T oa;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005947
5948 buf_T *save_curbuf;
5949 int save_virtual;
5950 char_u *akt = NULL;
5951 linenr_T lnum;
5952
5953 save_curbuf = curbuf;
5954 save_virtual = virtual_op;
5955
5956 if (getregionpos(argvars, rettv,
zeertzjqc95e64f2024-05-20 14:00:31 +02005957 &p1, &p2, &inclusive, &region_type, &oa) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005958 return;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005959
5960 for (lnum = p1.lnum; lnum <= p2.lnum; lnum++)
5961 {
5962 int ret = 0;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005963 struct block_def bd;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005964
5965 if (region_type == MLINE)
5966 akt = vim_strsave(ml_get(lnum));
5967 else if (region_type == MBLOCK)
5968 {
zeertzjq5e3674b2024-02-22 19:51:34 +01005969 block_prep(&oa, &bd, lnum, FALSE);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005970 akt = block_def2str(&bd);
5971 }
5972 else if (p1.lnum < lnum && lnum < p2.lnum)
5973 akt = vim_strsave(ml_get(lnum));
5974 else
5975 {
5976 charwise_block_prep(p1, p2, &bd, lnum, inclusive);
5977 akt = block_def2str(&bd);
5978 }
5979
5980 if (akt)
5981 {
5982 ret = list_append_string(rettv->vval.v_list, akt, -1);
5983 vim_free(akt);
5984 }
5985
5986 if (akt == NULL || ret == FAIL)
5987 {
zeertzjq5e3674b2024-02-22 19:51:34 +01005988 clear_tv(rettv);
5989 (void)rettv_list_alloc(rettv);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005990 break;
5991 }
5992 }
5993
zeertzjqc95e64f2024-05-20 14:00:31 +02005994 // getregionpos() may change curbuf and virtual_op
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005995 curbuf = save_curbuf;
5996 curwin->w_buffer = curbuf;
5997 virtual_op = save_virtual;
5998}
5999
6000 static void
zeertzjqc95e64f2024-05-20 14:00:31 +02006001add_regionpos_range(typval_T *rettv, pos_T p1, pos_T p2)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006002{
6003 list_T *l1, *l2, *l3;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006004
6005 l1 = list_alloc();
6006 if (l1 == NULL)
6007 return;
6008
6009 if (list_append_list(rettv->vval.v_list, l1) == FAIL)
6010 {
6011 vim_free(l1);
6012 return;
6013 }
6014
6015 l2 = list_alloc();
6016 if (l2 == NULL)
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006017 {
6018 vim_free(l1);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006019 return;
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006020 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006021
6022 if (list_append_list(l1, l2) == FAIL)
6023 {
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006024 vim_free(l1);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006025 vim_free(l2);
6026 return;
6027 }
6028
6029 l3 = list_alloc();
6030 if (l3 == NULL)
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006031 {
6032 vim_free(l1);
6033 vim_free(l2);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006034 return;
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006035 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006036
6037 if (list_append_list(l1, l3) == FAIL)
6038 {
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006039 vim_free(l1);
6040 vim_free(l2);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006041 vim_free(l3);
6042 return;
6043 }
6044
zeertzjqc95e64f2024-05-20 14:00:31 +02006045 list_append_number(l2, curbuf->b_fnum);
6046 list_append_number(l2, p1.lnum);
zeertzjq2b09de92024-05-24 07:48:51 +02006047 list_append_number(l2, p1.col);
zeertzjqc95e64f2024-05-20 14:00:31 +02006048 list_append_number(l2, p1.coladd);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006049
zeertzjqc95e64f2024-05-20 14:00:31 +02006050 list_append_number(l3, curbuf->b_fnum);
6051 list_append_number(l3, p2.lnum);
zeertzjq2b09de92024-05-24 07:48:51 +02006052 list_append_number(l3, p2.col);
zeertzjqc95e64f2024-05-20 14:00:31 +02006053 list_append_number(l3, p2.coladd);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006054}
6055
6056/*
6057 * "getregionpos()" function
6058 */
6059 static void
6060f_getregionpos(typval_T *argvars, typval_T *rettv)
6061{
6062 pos_T p1, p2;
6063 int inclusive = TRUE;
6064 int region_type = -1;
zeertzjq2b09de92024-05-24 07:48:51 +02006065 int allow_eol = FALSE;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006066 oparg_T oa;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006067 int lnum;
6068
6069 buf_T *save_curbuf;
6070 int save_virtual;
6071
6072 save_curbuf = curbuf;
6073 save_virtual = virtual_op;
6074
6075 if (getregionpos(argvars, rettv,
zeertzjqc95e64f2024-05-20 14:00:31 +02006076 &p1, &p2, &inclusive, &region_type, &oa) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006077 return;
6078
zeertzjq2b09de92024-05-24 07:48:51 +02006079 if (argvars[2].v_type == VAR_DICT)
6080 allow_eol = dict_get_bool(argvars[2].vval.v_dict, "eol", FALSE);
6081
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006082 for (lnum = p1.lnum; lnum <= p2.lnum; lnum++)
6083 {
zeertzjq2b09de92024-05-24 07:48:51 +02006084 pos_T ret_p1, ret_p2;
zeertzjqef733742024-05-26 18:42:18 +02006085 char_u *line = ml_get(lnum);
zeertzjq2b09de92024-05-24 07:48:51 +02006086 colnr_T line_len = ml_get_len(lnum);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006087
6088 if (region_type == MLINE)
6089 {
zeertzjqc95e64f2024-05-20 14:00:31 +02006090 ret_p1.col = 1;
6091 ret_p1.coladd = 0;
6092 ret_p2.col = MAXCOL;
6093 ret_p2.coladd = 0;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006094 }
6095 else
6096 {
zeertzjq52a6f342024-05-22 16:42:44 +02006097 struct block_def bd;
6098
zeertzjqc95e64f2024-05-20 14:00:31 +02006099 if (region_type == MBLOCK)
6100 block_prep(&oa, &bd, lnum, FALSE);
6101 else
6102 charwise_block_prep(p1, p2, &bd, lnum, inclusive);
zeertzjq52a6f342024-05-22 16:42:44 +02006103
6104 if (bd.is_oneChar) // selection entirely inside one char
6105 {
6106 if (region_type == MBLOCK)
6107 {
zeertzjqef733742024-05-26 18:42:18 +02006108 ret_p1.col = mb_prevptr(line, bd.textstart) - line + 1;
zeertzjq52a6f342024-05-22 16:42:44 +02006109 ret_p1.coladd = bd.start_char_vcols
6110 - (bd.start_vcol - oa.start_vcol);
6111 }
6112 else
6113 {
6114 ret_p1.col = p1.col + 1;
6115 ret_p1.coladd = p1.coladd;
6116 }
6117 }
zeertzjq2b09de92024-05-24 07:48:51 +02006118 else if (region_type == MBLOCK && oa.start_vcol > bd.start_vcol)
6119 {
6120 // blockwise selection entirely beyond end of line
6121 ret_p1.col = MAXCOL;
6122 ret_p1.coladd = oa.start_vcol - bd.start_vcol;
6123 bd.is_oneChar = TRUE;
6124 }
zeertzjq52a6f342024-05-22 16:42:44 +02006125 else if (bd.startspaces > 0)
zeertzjqc95e64f2024-05-20 14:00:31 +02006126 {
zeertzjqef733742024-05-26 18:42:18 +02006127 ret_p1.col = mb_prevptr(line, bd.textstart) - line + 1;
zeertzjqc95e64f2024-05-20 14:00:31 +02006128 ret_p1.coladd = bd.start_char_vcols - bd.startspaces;
6129 }
6130 else
6131 {
6132 ret_p1.col = bd.textcol + 1;
6133 ret_p1.coladd = 0;
6134 }
zeertzjq52a6f342024-05-22 16:42:44 +02006135
6136 if (bd.is_oneChar) // selection entirely inside one char
6137 {
6138 ret_p2.col = ret_p1.col;
zeertzjq2b09de92024-05-24 07:48:51 +02006139 ret_p2.coladd = ret_p1.coladd + bd.startspaces + bd.endspaces;
zeertzjq52a6f342024-05-22 16:42:44 +02006140 }
6141 else if (bd.endspaces > 0)
zeertzjqc95e64f2024-05-20 14:00:31 +02006142 {
6143 ret_p2.col = bd.textcol + bd.textlen + 1;
6144 ret_p2.coladd = bd.endspaces;
6145 }
6146 else
6147 {
6148 ret_p2.col = bd.textcol + bd.textlen;
6149 ret_p2.coladd = 0;
6150 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006151 }
6152
zeertzjq2b09de92024-05-24 07:48:51 +02006153 if (!allow_eol && ret_p1.col > line_len)
6154 {
6155 ret_p1.col = 0;
6156 ret_p1.coladd = 0;
6157 }
6158 else if (ret_p1.col > line_len + 1)
6159 ret_p1.col = line_len + 1;
6160
6161 if (!allow_eol && ret_p2.col > line_len)
6162 {
6163 ret_p2.col = ret_p1.col == 0 ? 0 : line_len;
6164 ret_p2.coladd = 0;
6165 }
6166 else if (ret_p2.col > line_len + 1)
6167 ret_p2.col = line_len + 1;
6168
zeertzjqc95e64f2024-05-20 14:00:31 +02006169 ret_p1.lnum = lnum;
6170 ret_p2.lnum = lnum;
6171 add_regionpos_range(rettv, ret_p1, ret_p2);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006172 }
6173
6174 // getregionpos() may change curbuf and virtual_op
zeertzjq5406eb82024-03-11 21:36:42 +01006175 curbuf = save_curbuf;
6176 curwin->w_buffer = curbuf;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006177 virtual_op = save_virtual;
6178}
6179
6180/*
zeertzjqd3f00f52021-12-24 12:02:43 +00006181 * Common between getreg(), getreginfo() and getregtype(): get the register
6182 * name from the first argument.
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006183 * Returns zero on error.
6184 */
6185 static int
6186getreg_get_regname(typval_T *argvars)
6187{
6188 char_u *strregname;
6189
6190 if (argvars[0].v_type != VAR_UNKNOWN)
6191 {
6192 strregname = tv_get_string_chk(&argvars[0]);
6193 if (strregname != NULL && in_vim9script() && STRLEN(strregname) > 1)
6194 {
6195 semsg(_(e_register_name_must_be_one_char_str), strregname);
6196 strregname = NULL;
6197 }
6198 if (strregname == NULL) // type error; errmsg already given
6199 return 0;
6200 }
6201 else
6202 // Default to v:register
6203 strregname = get_vim_var_str(VV_REG);
6204
6205 return *strregname == 0 ? '"' : *strregname;
6206}
6207
6208/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006209 * "getreg()" function
6210 */
6211 static void
6212f_getreg(typval_T *argvars, typval_T *rettv)
6213{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006214 int regname;
6215 int arg2 = FALSE;
6216 int return_list = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006217
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02006218 if (in_vim9script()
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006219 && (check_for_opt_string_arg(argvars, 0) == FAIL
6220 || (argvars[0].v_type != VAR_UNKNOWN
6221 && (check_for_opt_bool_arg(argvars, 1) == FAIL
6222 || (argvars[1].v_type != VAR_UNKNOWN
6223 && check_for_opt_bool_arg(argvars, 2) == FAIL)))))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02006224 return;
6225
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006226 regname = getreg_get_regname(argvars);
6227 if (regname == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006228 return;
6229
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006230 if (argvars[0].v_type != VAR_UNKNOWN && argvars[1].v_type != VAR_UNKNOWN)
6231 {
6232 int error = FALSE;
6233
6234 arg2 = (int)tv_get_bool_chk(&argvars[1], &error);
6235
6236 if (!error && argvars[2].v_type != VAR_UNKNOWN)
6237 return_list = (int)tv_get_bool_chk(&argvars[2], &error);
6238 if (error)
6239 return;
6240 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006241
6242 if (return_list)
6243 {
6244 rettv->v_type = VAR_LIST;
6245 rettv->vval.v_list = (list_T *)get_reg_contents(regname,
6246 (arg2 ? GREG_EXPR_SRC : 0) | GREG_LIST);
6247 if (rettv->vval.v_list == NULL)
6248 (void)rettv_list_alloc(rettv);
6249 else
6250 ++rettv->vval.v_list->lv_refcount;
6251 }
6252 else
6253 {
6254 rettv->v_type = VAR_STRING;
6255 rettv->vval.v_string = get_reg_contents(regname,
6256 arg2 ? GREG_EXPR_SRC : 0);
6257 }
6258}
6259
6260/*
6261 * "getregtype()" function
6262 */
6263 static void
6264f_getregtype(typval_T *argvars, typval_T *rettv)
6265{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006266 int regname;
6267 char_u buf[NUMBUFLEN + 2];
6268 long reglen = 0;
6269
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006270 // on error return an empty string
6271 rettv->v_type = VAR_STRING;
6272 rettv->vval.v_string = NULL;
6273
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006274 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
6275 return;
6276
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006277 regname = getreg_get_regname(argvars);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006278 if (regname == 0)
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006279 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006280
6281 buf[0] = NUL;
6282 buf[1] = NUL;
6283 switch (get_reg_type(regname, &reglen))
6284 {
6285 case MLINE: buf[0] = 'V'; break;
6286 case MCHAR: buf[0] = 'v'; break;
6287 case MBLOCK:
6288 buf[0] = Ctrl_V;
6289 sprintf((char *)buf + 1, "%ld", reglen + 1);
6290 break;
6291 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006292 rettv->vval.v_string = vim_strsave(buf);
6293}
6294
Bram Moolenaarb5ae48e2016-08-12 22:23:25 +02006295/*
Bram Moolenaarf49cc602018-11-11 15:21:05 +01006296 * "gettagstack()" function
6297 */
6298 static void
6299f_gettagstack(typval_T *argvars, typval_T *rettv)
6300{
6301 win_T *wp = curwin; // default is current window
6302
Bram Moolenaar93a10962022-06-16 11:42:09 +01006303 if (rettv_dict_alloc(rettv) == FAIL)
Bram Moolenaarf49cc602018-11-11 15:21:05 +01006304 return;
6305
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006306 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
6307 return;
6308
Bram Moolenaarf49cc602018-11-11 15:21:05 +01006309 if (argvars[0].v_type != VAR_UNKNOWN)
6310 {
6311 wp = find_win_by_nr_or_id(&argvars[0]);
6312 if (wp == NULL)
6313 return;
6314 }
6315
6316 get_tagstack(wp, rettv->vval.v_dict);
6317}
6318
Bram Moolenaar0b39c3f2020-08-30 15:52:10 +02006319/*
6320 * "gettext()" function
6321 */
6322 static void
6323f_gettext(typval_T *argvars, typval_T *rettv)
6324{
Christ van Willegence0ef912024-06-20 23:41:59 +02006325#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
6326 char *prev = NULL;
6327#endif
6328
6329 if (check_for_nonempty_string_arg(argvars, 0) == FAIL
6330 || check_for_opt_string_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006331 return;
6332
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +01006333 rettv->v_type = VAR_STRING;
Christ van Willegence0ef912024-06-20 23:41:59 +02006334
6335 if (argvars[1].v_type == VAR_STRING &&
6336 argvars[1].vval.v_string != NULL &&
6337 *(argvars[1].vval.v_string) != NUL)
6338 {
6339#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
6340 prev = bind_textdomain_codeset((const char *)argvars[1].vval.v_string, (char *)p_enc);
6341#endif
6342
6343#if defined(HAVE_DGETTEXT)
6344 rettv->vval.v_string = vim_strsave((char_u *)dgettext((const char *)argvars[1].vval.v_string, (const char *)argvars[0].vval.v_string));
6345#else
6346 textdomain((const char *)argvars[1].vval.v_string);
6347 rettv->vval.v_string = vim_strsave((char_u *)_(argvars[0].vval.v_string));
6348 textdomain(VIMPACKAGE);
6349#endif
6350
6351#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
6352 if (prev != NULL)
6353 bind_textdomain_codeset((const char *)argvars[1].vval.v_string, prev);
6354#endif
6355 }
6356 else
6357 rettv->vval.v_string = vim_strsave((char_u *)_(argvars[0].vval.v_string));
Bram Moolenaar0b39c3f2020-08-30 15:52:10 +02006358}
6359
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01006360// for VIM_VERSION_ defines
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006361#include "version.h"
6362
6363/*
6364 * "has()" function
6365 */
Bram Moolenaara259d8d2020-01-31 20:10:50 +01006366 void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006367f_has(typval_T *argvars, typval_T *rettv)
6368{
6369 int i;
6370 char_u *name;
Bram Moolenaar79296512020-03-22 16:17:14 +01006371 int x = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006372 int n = FALSE;
Bram Moolenaar79296512020-03-22 16:17:14 +01006373 typedef struct {
6374 char *name;
6375 short present;
6376 } has_item_T;
6377 static has_item_T has_list[] =
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006378 {
Bram Moolenaar79296512020-03-22 16:17:14 +01006379 {"amiga",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006380#ifdef AMIGA
Bram Moolenaar79296512020-03-22 16:17:14 +01006381 1
Bram Moolenaar39536dd2019-01-29 22:58:21 +01006382#else
Bram Moolenaar79296512020-03-22 16:17:14 +01006383 0
Bram Moolenaar39536dd2019-01-29 22:58:21 +01006384#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006385 },
6386 {"arp",
6387#if defined(AMIGA) && defined(FEAT_ARP)
6388 1
6389#else
6390 0
6391#endif
6392 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006393 {"haiku",
6394#ifdef __HAIKU__
6395 1
6396#else
6397 0
6398#endif
6399 },
6400 {"bsd",
6401#if defined(BSD) && !defined(MACOS_X)
6402 1
6403#else
6404 0
6405#endif
6406 },
6407 {"hpux",
6408#ifdef hpux
6409 1
6410#else
6411 0
6412#endif
6413 },
6414 {"linux",
6415#ifdef __linux__
6416 1
6417#else
6418 0
6419#endif
6420 },
6421 {"mac", // Mac OS X (and, once, Mac OS Classic)
6422#ifdef MACOS_X
6423 1
6424#else
6425 0
6426#endif
6427 },
6428 {"osx", // Mac OS X
6429#ifdef MACOS_X
6430 1
6431#else
6432 0
6433#endif
6434 },
6435 {"macunix", // Mac OS X, with the darwin feature
6436#if defined(MACOS_X) && defined(MACOS_X_DARWIN)
6437 1
6438#else
6439 0
6440#endif
6441 },
6442 {"osxdarwin", // synonym for macunix
6443#if defined(MACOS_X) && defined(MACOS_X_DARWIN)
6444 1
6445#else
6446 0
6447#endif
6448 },
6449 {"qnx",
6450#ifdef __QNX__
6451 1
6452#else
6453 0
6454#endif
6455 },
6456 {"sun",
6457#ifdef SUN_SYSTEM
6458 1
6459#else
6460 0
6461#endif
6462 },
6463 {"unix",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006464#ifdef UNIX
Bram Moolenaar79296512020-03-22 16:17:14 +01006465 1
6466#else
6467 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006468#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006469 },
6470 {"vms",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006471#ifdef VMS
Bram Moolenaar79296512020-03-22 16:17:14 +01006472 1
6473#else
6474 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006475#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006476 },
6477 {"win32",
Bram Moolenaar4f974752019-02-17 17:44:42 +01006478#ifdef MSWIN
Bram Moolenaar79296512020-03-22 16:17:14 +01006479 1
6480#else
6481 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006482#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006483 },
6484 {"win32unix",
K.Takata972db232022-02-04 10:45:38 +00006485#ifdef WIN32UNIX
Bram Moolenaar79296512020-03-22 16:17:14 +01006486 1
6487#else
6488 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006489#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006490 },
6491 {"win64",
Bram Moolenaar44b443c2019-02-18 22:14:18 +01006492#ifdef _WIN64
Bram Moolenaar79296512020-03-22 16:17:14 +01006493 1
6494#else
6495 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006496#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006497 },
Bram Moolenaar424bcae2022-01-31 14:59:41 +00006498 {"ebcdic", 0 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006499 {"fname_case",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006500#ifndef CASE_INSENSITIVE_FILENAME
Bram Moolenaar79296512020-03-22 16:17:14 +01006501 1
6502#else
6503 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006504#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006505 },
6506 {"acl",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006507#ifdef HAVE_ACL
Bram Moolenaar79296512020-03-22 16:17:14 +01006508 1
6509#else
6510 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006511#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006512 },
6513 {"arabic",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006514#ifdef FEAT_ARABIC
Bram Moolenaar79296512020-03-22 16:17:14 +01006515 1
6516#else
6517 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006518#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006519 },
6520 {"autocmd", 1},
6521 {"autochdir",
Bram Moolenaar83ec2a72018-07-27 22:08:59 +02006522#ifdef FEAT_AUTOCHDIR
Bram Moolenaar79296512020-03-22 16:17:14 +01006523 1
6524#else
6525 0
Bram Moolenaar83ec2a72018-07-27 22:08:59 +02006526#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006527 },
6528 {"autoservername",
Bram Moolenaare42a6d22017-11-12 19:21:51 +01006529#ifdef FEAT_AUTOSERVERNAME
Bram Moolenaar79296512020-03-22 16:17:14 +01006530 1
6531#else
6532 0
Bram Moolenaare42a6d22017-11-12 19:21:51 +01006533#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006534 },
6535 {"balloon_eval",
Bram Moolenaarc3719bd2017-11-18 22:13:31 +01006536#ifdef FEAT_BEVAL_GUI
Bram Moolenaar79296512020-03-22 16:17:14 +01006537 1
6538#else
6539 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006540#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006541 },
6542 {"balloon_multiline",
Bram Moolenaar0bd663a2022-01-22 10:24:47 +00006543#ifdef FEAT_BEVAL_GUI
Bram Moolenaar79296512020-03-22 16:17:14 +01006544 1
6545#else
6546 0
6547#endif
6548 },
6549 {"balloon_eval_term",
Bram Moolenaarc3719bd2017-11-18 22:13:31 +01006550#ifdef FEAT_BEVAL_TERM
Bram Moolenaar79296512020-03-22 16:17:14 +01006551 1
6552#else
6553 0
Bram Moolenaar51b0f372017-11-18 18:52:04 +01006554#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006555 },
Bram Moolenaar2ee347f2022-08-26 17:53:44 +01006556 {"builtin_terms", 1},
6557 {"all_builtin_terms", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006558 {"browsefilter",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006559#if defined(FEAT_BROWSE) && (defined(USE_FILE_CHOOSER) \
Bram Moolenaar4f974752019-02-17 17:44:42 +01006560 || defined(FEAT_GUI_MSWIN) \
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006561 || defined(FEAT_GUI_MOTIF))
Bram Moolenaar79296512020-03-22 16:17:14 +01006562 1
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006563#else
Bram Moolenaar79296512020-03-22 16:17:14 +01006564 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006565#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006566 },
6567 {"byte_offset",
6568#ifdef FEAT_BYTEOFF
6569 1
6570#else
6571 0
6572#endif
6573 },
6574 {"channel",
6575#ifdef FEAT_JOB_CHANNEL
6576 1
6577#else
6578 0
6579#endif
6580 },
Bram Moolenaar8e145b82022-05-21 20:17:31 +01006581 {"cindent", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006582 {"clientserver",
6583#ifdef FEAT_CLIENTSERVER
6584 1
6585#else
6586 0
6587#endif
6588 },
6589 {"clipboard",
6590#ifdef FEAT_CLIPBOARD
6591 1
6592#else
6593 0
6594#endif
6595 },
6596 {"cmdline_compl", 1},
6597 {"cmdline_hist", 1},
Martin Tournoij7904fa42022-10-04 16:28:45 +01006598 {"cmdwin", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006599 {"comments", 1},
6600 {"conceal",
6601#ifdef FEAT_CONCEAL
6602 1
6603#else
6604 0
6605#endif
6606 },
6607 {"cryptv",
6608#ifdef FEAT_CRYPT
6609 1
6610#else
6611 0
6612#endif
6613 },
6614 {"crypt-blowfish",
6615#ifdef FEAT_CRYPT
6616 1
6617#else
6618 0
6619#endif
6620 },
6621 {"crypt-blowfish2",
6622#ifdef FEAT_CRYPT
6623 1
6624#else
6625 0
6626#endif
6627 },
6628 {"cscope",
6629#ifdef FEAT_CSCOPE
6630 1
6631#else
6632 0
6633#endif
6634 },
6635 {"cursorbind", 1},
6636 {"cursorshape",
6637#ifdef CURSOR_SHAPE
6638 1
6639#else
6640 0
6641#endif
6642 },
6643 {"debug",
6644#ifdef DEBUG
6645 1
6646#else
6647 0
6648#endif
6649 },
6650 {"dialog_con",
6651#ifdef FEAT_CON_DIALOG
6652 1
6653#else
6654 0
6655#endif
6656 },
glepnirdf461152024-04-04 22:23:29 +02006657 {"dialog_con_gui",
6658#if defined(FEAT_CON_DIALOG) && defined(FEAT_GUI_DIALOG)
6659 1
6660#else
6661 0
6662#endif
6663 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006664 {"dialog_gui",
6665#ifdef FEAT_GUI_DIALOG
6666 1
6667#else
6668 0
6669#endif
6670 },
6671 {"diff",
6672#ifdef FEAT_DIFF
6673 1
6674#else
6675 0
6676#endif
6677 },
6678 {"digraphs",
6679#ifdef FEAT_DIGRAPHS
6680 1
6681#else
6682 0
6683#endif
6684 },
6685 {"directx",
6686#ifdef FEAT_DIRECTX
6687 1
6688#else
6689 0
6690#endif
6691 },
6692 {"dnd",
6693#ifdef FEAT_DND
6694 1
6695#else
6696 0
6697#endif
6698 },
Bram Moolenaar1d1ce612021-06-27 19:02:52 +02006699 {"drop_file",
6700#ifdef HAVE_DROP_FILE
6701 1
6702#else
6703 0
6704#endif
6705 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006706 {"emacs_tags",
6707#ifdef FEAT_EMACS_TAGS
6708 1
6709#else
6710 0
6711#endif
6712 },
6713 {"eval", 1}, // always present, of course!
6714 {"ex_extra", 1}, // graduated feature
6715 {"extra_search",
6716#ifdef FEAT_SEARCH_EXTRA
6717 1
6718#else
6719 0
6720#endif
6721 },
Bram Moolenaarf80f40a2022-08-25 16:02:23 +01006722 {"file_in_path", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006723 {"filterpipe",
6724#if defined(FEAT_FILTERPIPE) && !defined(VIMDLL)
6725 1
6726#else
6727 0
6728#endif
6729 },
6730 {"find_in_path",
6731#ifdef FEAT_FIND_ID
6732 1
6733#else
6734 0
6735#endif
6736 },
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01006737 {"float", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006738 {"folding",
6739#ifdef FEAT_FOLDING
6740 1
6741#else
6742 0
6743#endif
6744 },
Bram Moolenaarc8ac3a02022-09-04 12:29:28 +01006745 {"footer", 0},
Bram Moolenaar79296512020-03-22 16:17:14 +01006746 {"fork",
6747#if !defined(USE_SYSTEM) && defined(UNIX)
6748 1
6749#else
6750 0
6751#endif
6752 },
6753 {"gettext",
6754#ifdef FEAT_GETTEXT
6755 1
6756#else
6757 0
6758#endif
6759 },
6760 {"gui",
6761#ifdef FEAT_GUI
6762 1
6763#else
6764 0
6765#endif
6766 },
Bram Moolenaar0b962e52022-04-03 18:02:37 +01006767 {"gui_neXtaw", 0 },
6768 {"gui_athena", 0 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006769 {"gui_gtk",
6770#ifdef FEAT_GUI_GTK
6771 1
6772#else
6773 0
6774#endif
6775 },
6776 {"gui_gtk2",
6777#if defined(FEAT_GUI_GTK) && !defined(USE_GTK3)
6778 1
6779#else
6780 0
6781#endif
6782 },
6783 {"gui_gtk3",
6784#if defined(FEAT_GUI_GTK) && defined(USE_GTK3)
6785 1
6786#else
6787 0
6788#endif
6789 },
6790 {"gui_gnome",
6791#ifdef FEAT_GUI_GNOME
6792 1
6793#else
6794 0
6795#endif
6796 },
6797 {"gui_haiku",
6798#ifdef FEAT_GUI_HAIKU
6799 1
6800#else
6801 0
6802#endif
6803 },
Bram Moolenaar097148e2020-08-11 21:58:20 +02006804 {"gui_mac", 0},
Bram Moolenaar79296512020-03-22 16:17:14 +01006805 {"gui_motif",
6806#ifdef FEAT_GUI_MOTIF
6807 1
6808#else
6809 0
6810#endif
6811 },
6812 {"gui_photon",
6813#ifdef FEAT_GUI_PHOTON
6814 1
6815#else
6816 0
6817#endif
6818 },
6819 {"gui_win32",
6820#ifdef FEAT_GUI_MSWIN
6821 1
6822#else
6823 0
6824#endif
6825 },
6826 {"iconv",
6827#if defined(HAVE_ICONV_H) && defined(USE_ICONV)
6828 1
6829#else
6830 0
6831#endif
6832 },
6833 {"insert_expand", 1},
Bram Moolenaarbfe13cc2020-04-12 17:53:12 +02006834 {"ipv6",
6835#ifdef FEAT_IPV6
6836 1
6837#else
6838 0
6839#endif
6840 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006841 {"job",
6842#ifdef FEAT_JOB_CHANNEL
6843 1
6844#else
6845 0
6846#endif
6847 },
Bram Moolenaar739f13a2021-12-13 13:12:53 +00006848 {"jumplist", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006849 {"keymap",
6850#ifdef FEAT_KEYMAP
6851 1
6852#else
6853 0
6854#endif
6855 },
6856 {"lambda", 1}, // always with FEAT_EVAL, since 7.4.2120 with closure
6857 {"langmap",
6858#ifdef FEAT_LANGMAP
6859 1
6860#else
6861 0
6862#endif
6863 },
6864 {"libcall",
6865#ifdef FEAT_LIBCALL
6866 1
6867#else
6868 0
6869#endif
6870 },
6871 {"linebreak",
6872#ifdef FEAT_LINEBREAK
6873 1
6874#else
6875 0
6876#endif
6877 },
Bram Moolenaar8e145b82022-05-21 20:17:31 +01006878 {"lispindent", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006879 {"listcmds", 1},
6880 {"localmap", 1},
6881 {"lua",
6882#if defined(FEAT_LUA) && !defined(DYNAMIC_LUA)
6883 1
6884#else
6885 0
6886#endif
6887 },
6888 {"menu",
6889#ifdef FEAT_MENU
6890 1
6891#else
6892 0
6893#endif
6894 },
6895 {"mksession",
6896#ifdef FEAT_SESSION
6897 1
6898#else
6899 0
6900#endif
6901 },
6902 {"modify_fname", 1},
6903 {"mouse", 1},
6904 {"mouseshape",
6905#ifdef FEAT_MOUSESHAPE
6906 1
6907#else
6908 0
6909#endif
6910 },
6911 {"mouse_dec",
6912#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_DEC)
6913 1
6914#else
6915 0
6916#endif
6917 },
6918 {"mouse_gpm",
Bram Moolenaar33fc4a62022-02-23 18:07:38 +00006919#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_GPM) && !defined(DYNAMIC_GPM)
Bram Moolenaar79296512020-03-22 16:17:14 +01006920 1
6921#else
6922 0
6923#endif
6924 },
6925 {"mouse_jsbterm",
6926#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_JSB)
6927 1
6928#else
6929 0
6930#endif
6931 },
6932 {"mouse_netterm",
6933#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_NET)
6934 1
6935#else
6936 0
6937#endif
6938 },
6939 {"mouse_pterm",
6940#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_PTERM)
6941 1
6942#else
6943 0
6944#endif
6945 },
6946 {"mouse_sgr",
6947#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_XTERM)
6948 1
6949#else
6950 0
6951#endif
6952 },
6953 {"mouse_sysmouse",
6954#if (defined(UNIX) || defined(VMS)) && defined(FEAT_SYSMOUSE)
6955 1
6956#else
6957 0
6958#endif
6959 },
6960 {"mouse_urxvt",
6961#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_URXVT)
6962 1
6963#else
6964 0
6965#endif
6966 },
6967 {"mouse_xterm",
6968#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_XTERM)
6969 1
6970#else
6971 0
6972#endif
6973 },
6974 {"multi_byte", 1},
6975 {"multi_byte_ime",
6976#ifdef FEAT_MBYTE_IME
6977 1
6978#else
6979 0
6980#endif
6981 },
6982 {"multi_lang",
6983#ifdef FEAT_MULTI_LANG
6984 1
6985#else
6986 0
6987#endif
6988 },
6989 {"mzscheme",
6990#if defined(FEAT_MZSCHEME) && !defined(DYNAMIC_MZSCHEME)
6991 1
6992#else
6993 0
6994#endif
6995 },
Leah Neukirchen0a7984a2021-10-14 21:27:55 +01006996 {"nanotime",
6997#ifdef ST_MTIM_NSEC
6998 1
6999#else
7000 0
7001#endif
7002 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007003 {"num64", 1},
7004 {"ole",
7005#ifdef FEAT_OLE
7006 1
7007#else
7008 0
7009#endif
7010 },
7011 {"packages",
7012#ifdef FEAT_EVAL
7013 1
7014#else
7015 0
7016#endif
7017 },
Bram Moolenaar2bd9dbc2022-08-25 18:12:06 +01007018 {"path_extra", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007019 {"perl",
7020#if defined(FEAT_PERL) && !defined(DYNAMIC_PERL)
7021 1
7022#else
7023 0
7024#endif
7025 },
7026 {"persistent_undo",
7027#ifdef FEAT_PERSISTENT_UNDO
7028 1
7029#else
7030 0
7031#endif
7032 },
7033 {"python_compiled",
7034#if defined(FEAT_PYTHON)
7035 1
7036#else
7037 0
7038#endif
7039 },
7040 {"python_dynamic",
7041#if defined(FEAT_PYTHON) && defined(DYNAMIC_PYTHON)
7042 1
7043#else
7044 0
7045#endif
7046 },
7047 {"python",
7048#if defined(FEAT_PYTHON) && !defined(DYNAMIC_PYTHON)
7049 1
7050#else
7051 0
7052#endif
7053 },
7054 {"pythonx",
7055#if (defined(FEAT_PYTHON) && !defined(DYNAMIC_PYTHON)) \
7056 || (defined(FEAT_PYTHON3) && !defined(DYNAMIC_PYTHON3))
7057 1
7058#else
7059 0
7060#endif
7061 },
7062 {"python3_compiled",
7063#if defined(FEAT_PYTHON3)
7064 1
7065#else
7066 0
7067#endif
7068 },
7069 {"python3_dynamic",
7070#if defined(FEAT_PYTHON3) && defined(DYNAMIC_PYTHON3)
7071 1
7072#else
7073 0
7074#endif
7075 },
Yee Cheng Chinc13b3d12023-08-20 21:18:38 +02007076 {"python3_stable",
7077#if defined(FEAT_PYTHON3) && defined(DYNAMIC_PYTHON3_STABLE_ABI)
7078 1
7079#else
7080 0
7081#endif
7082 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007083 {"python3",
7084#if defined(FEAT_PYTHON3) && !defined(DYNAMIC_PYTHON3)
7085 1
7086#else
7087 0
7088#endif
7089 },
7090 {"popupwin",
7091#ifdef FEAT_PROP_POPUP
7092 1
7093#else
7094 0
7095#endif
7096 },
7097 {"postscript",
7098#ifdef FEAT_POSTSCRIPT
7099 1
7100#else
7101 0
7102#endif
7103 },
7104 {"printer",
7105#ifdef FEAT_PRINTER
7106 1
7107#else
7108 0
7109#endif
7110 },
7111 {"profile",
7112#ifdef FEAT_PROFILE
7113 1
7114#else
7115 0
7116#endif
7117 },
Ernie Rael076de792023-03-16 21:43:15 +00007118 {"prof_nsec",
Bram Moolenaar08210f82023-04-13 19:15:54 +01007119#ifdef PROF_NSEC
Ernie Rael076de792023-03-16 21:43:15 +00007120 1
7121#else
7122 0
7123#endif
7124 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007125 {"reltime",
7126#ifdef FEAT_RELTIME
7127 1
7128#else
7129 0
7130#endif
7131 },
7132 {"quickfix",
7133#ifdef FEAT_QUICKFIX
7134 1
7135#else
7136 0
7137#endif
7138 },
7139 {"rightleft",
7140#ifdef FEAT_RIGHTLEFT
7141 1
7142#else
7143 0
7144#endif
7145 },
7146 {"ruby",
7147#if defined(FEAT_RUBY) && !defined(DYNAMIC_RUBY)
7148 1
7149#else
7150 0
7151#endif
7152 },
7153 {"scrollbind", 1},
Martin Tournoijba43e762022-10-13 22:12:15 +01007154 {"showcmd", 1},
7155 {"cmdline_info", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007156 {"signs",
7157#ifdef FEAT_SIGNS
7158 1
7159#else
7160 0
7161#endif
7162 },
Bram Moolenaar8e145b82022-05-21 20:17:31 +01007163 {"smartindent", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007164 {"startuptime",
7165#ifdef STARTUPTIME
7166 1
7167#else
7168 0
7169#endif
7170 },
7171 {"statusline",
7172#ifdef FEAT_STL_OPT
7173 1
7174#else
7175 0
7176#endif
7177 },
7178 {"netbeans_intg",
7179#ifdef FEAT_NETBEANS_INTG
7180 1
7181#else
7182 0
7183#endif
7184 },
Christian Brabandtf573c6e2021-06-20 14:02:16 +02007185 {"sodium",
K.Takatad68b2fc2022-02-12 11:18:37 +00007186#if defined(FEAT_SODIUM) && !defined(DYNAMIC_SODIUM)
Christian Brabandtf573c6e2021-06-20 14:02:16 +02007187 1
7188#else
7189 0
7190#endif
7191 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007192 {"sound",
7193#ifdef FEAT_SOUND
7194 1
7195#else
7196 0
7197#endif
7198 },
7199 {"spell",
7200#ifdef FEAT_SPELL
7201 1
7202#else
7203 0
7204#endif
7205 },
7206 {"syntax",
7207#ifdef FEAT_SYN_HL
7208 1
7209#else
7210 0
7211#endif
7212 },
7213 {"system",
7214#if defined(USE_SYSTEM) || !defined(UNIX)
7215 1
7216#else
7217 0
7218#endif
7219 },
Yegappan Lakshmanan655b7342022-03-06 14:27:10 +00007220 {"tag_binary", 1}, // graduated feature
Bram Moolenaar79296512020-03-22 16:17:14 +01007221 {"tcl",
7222#if defined(FEAT_TCL) && !defined(DYNAMIC_TCL)
7223 1
7224#else
7225 0
7226#endif
7227 },
7228 {"termguicolors",
7229#ifdef FEAT_TERMGUICOLORS
7230 1
7231#else
7232 0
7233#endif
7234 },
7235 {"terminal",
7236#if defined(FEAT_TERMINAL) && !defined(MSWIN)
7237 1
7238#else
7239 0
7240#endif
7241 },
7242 {"terminfo",
7243#ifdef TERMINFO
7244 1
7245#else
7246 0
7247#endif
7248 },
7249 {"termresponse",
7250#ifdef FEAT_TERMRESPONSE
7251 1
7252#else
7253 0
7254#endif
7255 },
Bram Moolenaar88774872022-08-16 20:24:29 +01007256 {"textobjects", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007257 {"textprop",
7258#ifdef FEAT_PROP_POPUP
7259 1
7260#else
7261 0
7262#endif
7263 },
7264 {"tgetent",
7265#ifdef HAVE_TGETENT
7266 1
7267#else
7268 0
7269#endif
7270 },
7271 {"timers",
7272#ifdef FEAT_TIMERS
7273 1
7274#else
7275 0
7276#endif
7277 },
Bram Moolenaar651fca82021-11-29 20:39:38 +00007278 {"title", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007279 {"toolbar",
7280#ifdef FEAT_TOOLBAR
7281 1
7282#else
7283 0
7284#endif
7285 },
7286 {"unnamedplus",
7287#if defined(FEAT_CLIPBOARD) && defined(FEAT_X11)
7288 1
7289#else
7290 0
7291#endif
7292 },
7293 {"user-commands", 1}, // was accidentally included in 5.4
7294 {"user_commands", 1},
7295 {"vartabs",
7296#ifdef FEAT_VARTABS
7297 1
7298#else
7299 0
7300#endif
7301 },
7302 {"vertsplit", 1},
7303 {"viminfo",
7304#ifdef FEAT_VIMINFO
7305 1
7306#else
7307 0
7308#endif
7309 },
Bram Moolenaarb79ee0c2022-01-01 12:17:00 +00007310 {"vim9script", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007311 {"vimscript-1", 1},
7312 {"vimscript-2", 1},
7313 {"vimscript-3", 1},
7314 {"vimscript-4", 1},
7315 {"virtualedit", 1},
7316 {"visual", 1},
7317 {"visualextra", 1},
7318 {"vreplace", 1},
7319 {"vtp",
7320#ifdef FEAT_VTP
7321 1
7322#else
7323 0
7324#endif
7325 },
Bram Moolenaar074fbd42022-08-26 16:41:14 +01007326 {"wildignore", 1},
Bram Moolenaar54162322022-08-26 16:58:51 +01007327 {"wildmenu", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007328 {"windows", 1},
7329 {"winaltkeys",
7330#ifdef FEAT_WAK
7331 1
7332#else
7333 0
7334#endif
7335 },
7336 {"writebackup",
7337#ifdef FEAT_WRITEBACKUP
7338 1
7339#else
7340 0
7341#endif
7342 },
Christian Brabandte085dfd2023-09-30 12:49:18 +02007343 {"xattr",
7344#ifdef FEAT_XATTR
7345 1
7346#else
7347 0
7348#endif
7349 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007350 {"xim",
7351#ifdef FEAT_XIM
7352 1
7353#else
7354 0
7355#endif
7356 },
7357 {"xfontset",
7358#ifdef FEAT_XFONTSET
7359 1
7360#else
7361 0
7362#endif
7363 },
7364 {"xpm",
7365#if defined(FEAT_XPM_W32) || defined(HAVE_XPM)
7366 1
7367#else
7368 0
7369#endif
7370 },
7371 {"xpm_w32", // for backward compatibility
7372#ifdef FEAT_XPM_W32
7373 1
7374#else
7375 0
7376#endif
7377 },
7378 {"xsmp",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007379#ifdef USE_XSMP
Bram Moolenaar79296512020-03-22 16:17:14 +01007380 1
7381#else
7382 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007383#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007384 },
7385 {"xsmp_interact",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007386#ifdef USE_XSMP_INTERACT
Bram Moolenaar79296512020-03-22 16:17:14 +01007387 1
7388#else
7389 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007390#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007391 },
7392 {"xterm_clipboard",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007393#ifdef FEAT_XCLIPBOARD
Bram Moolenaar79296512020-03-22 16:17:14 +01007394 1
7395#else
7396 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007397#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007398 },
7399 {"xterm_save",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007400#ifdef FEAT_XTERM_SAVE
Bram Moolenaar79296512020-03-22 16:17:14 +01007401 1
7402#else
7403 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007404#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007405 },
7406 {"X11",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007407#if defined(UNIX) && defined(FEAT_X11)
Bram Moolenaar79296512020-03-22 16:17:14 +01007408 1
7409#else
7410 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007411#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007412 },
Bram Moolenaar80adaa82023-07-07 18:57:40 +01007413 {":tearoff",
7414// same #ifdef as used for ex_tearoff().
7415#if defined(FEAT_GUI_MSWIN) && defined(FEAT_MENU) && defined(FEAT_TEAROFF)
7416 1
7417#else
7418 0
7419#endif
7420 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007421 {NULL, 0}
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007422 };
7423
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02007424 if (in_vim9script()
7425 && (check_for_string_arg(argvars, 0) == FAIL
7426 || check_for_opt_bool_arg(argvars, 1) == FAIL))
7427 return;
7428
Bram Moolenaard155d7a2018-12-21 16:04:21 +01007429 name = tv_get_string(&argvars[0]);
Bram Moolenaar79296512020-03-22 16:17:14 +01007430 for (i = 0; has_list[i].name != NULL; ++i)
7431 if (STRICMP(name, has_list[i].name) == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007432 {
Bram Moolenaar79296512020-03-22 16:17:14 +01007433 x = TRUE;
7434 n = has_list[i].present;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007435 break;
7436 }
7437
Bram Moolenaar79296512020-03-22 16:17:14 +01007438 // features also in has_list[] but sometimes enabled at runtime
7439 if (x == TRUE && n == FALSE)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007440 {
Bram Moolenaar79296512020-03-22 16:17:14 +01007441 if (0)
Bram Moolenaar86b9a3e2020-04-07 19:57:29 +02007442 {
7443 // intentionally empty
7444 }
Bram Moolenaar79296512020-03-22 16:17:14 +01007445#ifdef VIMDLL
7446 else if (STRICMP(name, "filterpipe") == 0)
7447 n = gui.in_use || gui.starting;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007448#endif
7449#if defined(USE_ICONV) && defined(DYNAMIC_ICONV)
7450 else if (STRICMP(name, "iconv") == 0)
7451 n = iconv_enabled(FALSE);
7452#endif
7453#ifdef DYNAMIC_LUA
7454 else if (STRICMP(name, "lua") == 0)
7455 n = lua_enabled(FALSE);
7456#endif
7457#ifdef DYNAMIC_MZSCHEME
7458 else if (STRICMP(name, "mzscheme") == 0)
7459 n = mzscheme_enabled(FALSE);
7460#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007461#ifdef DYNAMIC_PERL
7462 else if (STRICMP(name, "perl") == 0)
7463 n = perl_enabled(FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007464#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007465#ifdef DYNAMIC_PYTHON
7466 else if (STRICMP(name, "python") == 0)
7467 n = python_enabled(FALSE);
7468#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007469#ifdef DYNAMIC_PYTHON3
7470 else if (STRICMP(name, "python3") == 0)
7471 n = python3_enabled(FALSE);
7472#endif
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01007473#if defined(DYNAMIC_PYTHON) || defined(DYNAMIC_PYTHON3)
7474 else if (STRICMP(name, "pythonx") == 0)
7475 {
7476# if defined(DYNAMIC_PYTHON) && defined(DYNAMIC_PYTHON3)
7477 if (p_pyx == 0)
7478 n = python3_enabled(FALSE) || python_enabled(FALSE);
7479 else if (p_pyx == 3)
7480 n = python3_enabled(FALSE);
7481 else if (p_pyx == 2)
7482 n = python_enabled(FALSE);
7483# elif defined(DYNAMIC_PYTHON)
7484 n = python_enabled(FALSE);
7485# elif defined(DYNAMIC_PYTHON3)
7486 n = python3_enabled(FALSE);
7487# endif
7488 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007489#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007490#ifdef DYNAMIC_RUBY
7491 else if (STRICMP(name, "ruby") == 0)
7492 n = ruby_enabled(FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007493#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007494#ifdef DYNAMIC_TCL
7495 else if (STRICMP(name, "tcl") == 0)
7496 n = tcl_enabled(FALSE);
Bram Moolenaar4b8366b2019-05-04 17:34:34 +02007497#endif
K.Takatad68b2fc2022-02-12 11:18:37 +00007498#ifdef DYNAMIC_SODIUM
7499 else if (STRICMP(name, "sodium") == 0)
7500 n = sodium_enabled(FALSE);
7501#endif
Bram Moolenaar4f974752019-02-17 17:44:42 +01007502#if defined(FEAT_TERMINAL) && defined(MSWIN)
Bram Moolenaara83e3962017-08-17 14:39:07 +02007503 else if (STRICMP(name, "terminal") == 0)
7504 n = terminal_enabled();
7505#endif
Bram Moolenaar33fc4a62022-02-23 18:07:38 +00007506#ifdef DYNAMIC_GPM
7507 else if (STRICMP(name, "mouse_gpm") == 0)
7508 n = gpm_available();
7509#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007510 }
7511
Bram Moolenaar79296512020-03-22 16:17:14 +01007512 // features not in has_list[]
7513 if (x == FALSE)
7514 {
7515 if (STRNICMP(name, "patch", 5) == 0)
7516 {
7517 x = TRUE;
7518 if (name[5] == '-'
7519 && STRLEN(name) >= 11
K.Takatad90f91f2022-07-30 15:43:59 +01007520 && (name[6] >= '1' && name[6] <= '9'))
Bram Moolenaar79296512020-03-22 16:17:14 +01007521 {
K.Takatad90f91f2022-07-30 15:43:59 +01007522 char *end;
7523 int major, minor;
Bram Moolenaar79296512020-03-22 16:17:14 +01007524
K.Takatad90f91f2022-07-30 15:43:59 +01007525 // This works for patch-8.1.2, patch-9.0.3, patch-10.0.4, etc.
7526 // Not for patch-9.10.5.
7527 major = (int)strtoul((char *)name + 6, &end, 10);
7528 if (*end == '.' && vim_isdigit(end[1])
7529 && end[2] == '.' && vim_isdigit(end[3]))
7530 {
7531 minor = atoi(end + 1);
7532
7533 // Expect "patch-9.9.01234".
7534 n = (major < VIM_VERSION_MAJOR
7535 || (major == VIM_VERSION_MAJOR
7536 && (minor < VIM_VERSION_MINOR
7537 || (minor == VIM_VERSION_MINOR
7538 && has_patch(atoi(end + 3))))));
7539 }
Bram Moolenaar79296512020-03-22 16:17:14 +01007540 }
Keith Thompson184f71c2024-01-04 21:19:04 +01007541 else if (SAFE_isdigit(name[5]))
Bram Moolenaar79296512020-03-22 16:17:14 +01007542 n = has_patch(atoi((char *)name + 5));
7543 }
7544 else if (STRICMP(name, "vim_starting") == 0)
7545 {
7546 x = TRUE;
7547 n = (starting != 0);
7548 }
7549 else if (STRICMP(name, "ttyin") == 0)
7550 {
7551 x = TRUE;
7552 n = mch_input_isatty();
7553 }
7554 else if (STRICMP(name, "ttyout") == 0)
7555 {
7556 x = TRUE;
7557 n = stdout_isatty;
7558 }
7559 else if (STRICMP(name, "multi_byte_encoding") == 0)
7560 {
7561 x = TRUE;
7562 n = has_mbyte;
7563 }
7564 else if (STRICMP(name, "gui_running") == 0)
7565 {
7566 x = TRUE;
7567#ifdef FEAT_GUI
7568 n = (gui.in_use || gui.starting);
7569#endif
7570 }
7571 else if (STRICMP(name, "browse") == 0)
7572 {
7573 x = TRUE;
7574#if defined(FEAT_GUI) && defined(FEAT_BROWSE)
7575 n = gui.in_use; // gui_mch_browse() works when GUI is running
7576#endif
7577 }
7578 else if (STRICMP(name, "syntax_items") == 0)
7579 {
7580 x = TRUE;
7581#ifdef FEAT_SYN_HL
7582 n = syntax_present(curwin);
7583#endif
7584 }
7585 else if (STRICMP(name, "vcon") == 0)
7586 {
7587 x = TRUE;
7588#ifdef FEAT_VTP
7589 n = is_term_win32() && has_vtp_working();
7590#endif
7591 }
7592 else if (STRICMP(name, "netbeans_enabled") == 0)
7593 {
7594 x = TRUE;
7595#ifdef FEAT_NETBEANS_INTG
7596 n = netbeans_active();
7597#endif
7598 }
7599 else if (STRICMP(name, "mouse_gpm_enabled") == 0)
7600 {
7601 x = TRUE;
7602#ifdef FEAT_MOUSE_GPM
7603 n = gpm_enabled();
7604#endif
7605 }
7606 else if (STRICMP(name, "conpty") == 0)
7607 {
7608 x = TRUE;
7609#if defined(FEAT_TERMINAL) && defined(MSWIN)
7610 n = use_conpty();
7611#endif
7612 }
7613 else if (STRICMP(name, "clipboard_working") == 0)
7614 {
7615 x = TRUE;
7616#ifdef FEAT_CLIPBOARD
7617 n = clip_star.available;
7618#endif
7619 }
7620 }
7621
Bram Moolenaar04637e22020-09-05 18:45:29 +02007622 if (argvars[1].v_type != VAR_UNKNOWN && tv_get_bool(&argvars[1]))
Bram Moolenaar79296512020-03-22 16:17:14 +01007623 // return whether feature could ever be enabled
7624 rettv->vval.v_number = x;
7625 else
7626 // return whether feature is enabled
7627 rettv->vval.v_number = n;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007628}
7629
7630/*
Bram Moolenaar8cebd432020-11-08 12:49:47 +01007631 * Return TRUE if "feature" can change later.
7632 * Also when checking for the feature has side effects, such as loading a DLL.
7633 */
7634 int
7635dynamic_feature(char_u *feature)
7636{
7637 return (feature == NULL
Bram Moolenaar8cebd432020-11-08 12:49:47 +01007638#if defined(FEAT_GUI) && defined(FEAT_BROWSE)
7639 || (STRICMP(feature, "browse") == 0 && !gui.in_use)
7640#endif
7641#ifdef VIMDLL
7642 || STRICMP(feature, "filterpipe") == 0
7643#endif
Bram Moolenaar29b281b2020-11-10 20:58:00 +01007644#if defined(FEAT_GUI) && !defined(ALWAYS_USE_GUI) && !defined(VIMDLL)
Bram Moolenaar8cebd432020-11-08 12:49:47 +01007645 // this can only change on Unix where the ":gui" command could be
7646 // used.
7647 || (STRICMP(feature, "gui_running") == 0 && !gui.in_use)
7648#endif
7649#if defined(USE_ICONV) && defined(DYNAMIC_ICONV)
7650 || STRICMP(feature, "iconv") == 0
7651#endif
7652#ifdef DYNAMIC_LUA
7653 || STRICMP(feature, "lua") == 0
7654#endif
7655#ifdef FEAT_MOUSE_GPM
7656 || (STRICMP(feature, "mouse_gpm_enabled") == 0 && !gpm_enabled())
7657#endif
7658#ifdef DYNAMIC_MZSCHEME
7659 || STRICMP(feature, "mzscheme") == 0
7660#endif
7661#ifdef FEAT_NETBEANS_INTG
7662 || STRICMP(feature, "netbeans_enabled") == 0
7663#endif
7664#ifdef DYNAMIC_PERL
7665 || STRICMP(feature, "perl") == 0
7666#endif
7667#ifdef DYNAMIC_PYTHON
7668 || STRICMP(feature, "python") == 0
7669#endif
7670#ifdef DYNAMIC_PYTHON3
7671 || STRICMP(feature, "python3") == 0
7672#endif
7673#if defined(DYNAMIC_PYTHON) || defined(DYNAMIC_PYTHON3)
7674 || STRICMP(feature, "pythonx") == 0
7675#endif
7676#ifdef DYNAMIC_RUBY
7677 || STRICMP(feature, "ruby") == 0
7678#endif
7679#ifdef FEAT_SYN_HL
7680 || STRICMP(feature, "syntax_items") == 0
7681#endif
7682#ifdef DYNAMIC_TCL
7683 || STRICMP(feature, "tcl") == 0
7684#endif
7685 // once "starting" is zero it will stay that way
7686 || (STRICMP(feature, "vim_starting") == 0 && starting != 0)
7687 || STRICMP(feature, "multi_byte_encoding") == 0
7688#if defined(FEAT_TERMINAL) && defined(MSWIN)
7689 || STRICMP(feature, "conpty") == 0
7690#endif
7691 );
7692}
7693
7694/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007695 * "haslocaldir()" function
7696 */
7697 static void
7698f_haslocaldir(typval_T *argvars, typval_T *rettv)
7699{
Bram Moolenaar00aa0692019-04-27 20:37:57 +02007700 tabpage_T *tp = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007701 win_T *wp = NULL;
7702
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02007703 if (in_vim9script()
7704 && (check_for_opt_number_arg(argvars, 0) == FAIL
7705 || (argvars[0].v_type != VAR_UNKNOWN
7706 && check_for_opt_number_arg(argvars, 1) == FAIL)))
7707 return;
7708
Bram Moolenaar00aa0692019-04-27 20:37:57 +02007709 wp = find_tabwin(&argvars[0], &argvars[1], &tp);
7710
7711 // Check for window-local and tab-local directories
7712 if (wp != NULL && wp->w_localdir != NULL)
7713 rettv->vval.v_number = 1;
7714 else if (tp != NULL && tp->tp_localdir != NULL)
7715 rettv->vval.v_number = 2;
7716 else
7717 rettv->vval.v_number = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007718}
7719
7720/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007721 * "highlightID(name)" function
7722 */
7723 static void
7724f_hlID(typval_T *argvars, typval_T *rettv)
7725{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02007726 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
7727 return;
7728
Bram Moolenaard155d7a2018-12-21 16:04:21 +01007729 rettv->vval.v_number = syn_name2id(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007730}
7731
7732/*
7733 * "highlight_exists()" function
7734 */
7735 static void
7736f_hlexists(typval_T *argvars, typval_T *rettv)
7737{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02007738 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
7739 return;
7740
Bram Moolenaard155d7a2018-12-21 16:04:21 +01007741 rettv->vval.v_number = highlight_exists(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007742}
7743
7744/*
7745 * "hostname()" function
7746 */
7747 static void
7748f_hostname(typval_T *argvars UNUSED, typval_T *rettv)
7749{
7750 char_u hostname[256];
7751
7752 mch_get_host_name(hostname, 256);
7753 rettv->v_type = VAR_STRING;
7754 rettv->vval.v_string = vim_strsave(hostname);
7755}
7756
7757/*
Ernie Raelc8e158b2024-07-09 18:39:52 +02007758 * "id()" function
7759 * Identity. Return address of item as a hex string, %p format.
7760 * Currently only valid for object/container types.
7761 * Return empty string if not an object.
7762 */
Zoltan Arpadffy10231ac2024-08-18 16:59:20 +02007763#ifdef VMS // VMS does not have defined uintptr_t
7764# if defined(HAVE_NO_LONG_LONG)
7765typedef unsigned int uintptr_t;
7766# else
7767typedef unsigned long long uintptr_t;
7768# endif
7769#endif // VMS
7770
John Marriottb3b2bee2024-07-14 11:12:51 +02007771 static void
Ernie Raelc8e158b2024-07-09 18:39:52 +02007772f_id(typval_T *argvars, typval_T *rettv)
7773{
Ernie Rael05124252024-07-11 22:10:45 +02007774 char numbuf[NUMBUFLEN];
7775 char *p = numbuf;
Ernie Raelc8e158b2024-07-09 18:39:52 +02007776
7777 switch (argvars[0].v_type)
7778 {
7779 case VAR_LIST:
7780 case VAR_DICT:
7781 case VAR_OBJECT:
7782 case VAR_JOB:
7783 case VAR_CHANNEL:
7784 case VAR_BLOB:
7785 // Assume pointer value in typval_T vval union at common location.
7786 if (argvars[0].vval.v_object != NULL)
Ernie Rael05124252024-07-11 22:10:45 +02007787 {
7788 // "v" gets the address as an integer
7789 uintptr_t v = (uintptr_t)(void *)argvars[0].vval.v_object;
7790 // Build a hex string from the item's address; it is in
7791 // reverse order. Ignore trailing zeros.
7792 for (; p < numbuf + sizeof(uintptr_t) * 2 && v != 0;
7793 ++p, v >>= 4)
7794 *p = "0123456789abcdef"[v & 0xf];
7795 }
Ernie Raelc8e158b2024-07-09 18:39:52 +02007796 default:
Ernie Rael05124252024-07-11 22:10:45 +02007797 break;
Ernie Raelc8e158b2024-07-09 18:39:52 +02007798 }
Ernie Rael05124252024-07-11 22:10:45 +02007799 *p = NUL;
Ernie Raelc8e158b2024-07-09 18:39:52 +02007800
7801 rettv->v_type = VAR_STRING;
Ernie Rael05124252024-07-11 22:10:45 +02007802 rettv->vval.v_string = vim_strsave((char_u *)numbuf);
Ernie Raelc8e158b2024-07-09 18:39:52 +02007803}
7804
7805/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007806 * "index()" function
7807 */
7808 static void
7809f_index(typval_T *argvars, typval_T *rettv)
7810{
7811 list_T *l;
7812 listitem_T *item;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007813 blob_T *b;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007814 long idx = 0;
7815 int ic = FALSE;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007816 int error = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007817
7818 rettv->vval.v_number = -1;
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02007819
7820 if (in_vim9script()
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02007821 && (check_for_list_or_blob_arg(argvars, 0) == FAIL
7822 || (argvars[0].v_type == VAR_BLOB
7823 && check_for_number_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02007824 || check_for_opt_number_arg(argvars, 2) == FAIL
7825 || (argvars[2].v_type != VAR_UNKNOWN
7826 && check_for_opt_bool_arg(argvars, 3) == FAIL)))
7827 return;
7828
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007829 if (argvars[0].v_type == VAR_BLOB)
7830 {
7831 typval_T tv;
7832 int start = 0;
7833
7834 if (argvars[2].v_type != VAR_UNKNOWN)
7835 {
7836 start = tv_get_number_chk(&argvars[2], &error);
7837 if (error)
7838 return;
7839 }
7840 b = argvars[0].vval.v_blob;
7841 if (b == NULL)
7842 return;
Bram Moolenaar05500ec2019-01-13 19:10:33 +01007843 if (start < 0)
7844 {
7845 start = blob_len(b) + start;
7846 if (start < 0)
7847 start = 0;
7848 }
7849
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007850 for (idx = start; idx < blob_len(b); ++idx)
7851 {
7852 tv.v_type = VAR_NUMBER;
7853 tv.vval.v_number = blob_get(b, idx);
Yinzuo Jiang7ccd1a22024-07-04 17:20:53 +02007854 if (tv_equal(&tv, &argvars[1], ic))
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007855 {
7856 rettv->vval.v_number = idx;
7857 return;
7858 }
7859 }
7860 return;
7861 }
7862 else if (argvars[0].v_type != VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007863 {
Bram Moolenaar460ae5d2022-01-01 14:19:49 +00007864 emsg(_(e_list_or_blob_required));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007865 return;
7866 }
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007867
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007868 l = argvars[0].vval.v_list;
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00007869 if (l == NULL)
7870 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007871
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00007872 CHECK_LIST_MATERIALIZE(l);
7873 item = l->lv_first;
7874 if (argvars[2].v_type != VAR_UNKNOWN)
7875 {
7876 // Start at specified item. Use the cached index that list_find()
7877 // sets, so that a negative number also works.
7878 item = list_find(l, (long)tv_get_number_chk(&argvars[2], &error));
7879 idx = l->lv_u.mat.lv_idx;
7880 if (argvars[3].v_type != VAR_UNKNOWN)
7881 ic = (int)tv_get_bool_chk(&argvars[3], &error);
7882 if (error)
7883 item = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007884 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00007885
7886 for ( ; item != NULL; item = item->li_next, ++idx)
Yinzuo Jiang7ccd1a22024-07-04 17:20:53 +02007887 if (tv_equal(&item->li_tv, &argvars[1], ic))
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00007888 {
7889 rettv->vval.v_number = idx;
7890 break;
7891 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007892}
7893
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01007894/*
7895 * Evaluate 'expr' with the v:key and v:val arguments and return the result.
7896 * The expression is expected to return a boolean value. The caller should set
7897 * the VV_KEY and VV_VAL vim variables before calling this function.
7898 */
7899 static int
7900indexof_eval_expr(typval_T *expr)
7901{
7902 typval_T argv[3];
7903 typval_T newtv;
7904 varnumber_T found;
7905 int error = FALSE;
7906
7907 argv[0] = *get_vim_var_tv(VV_KEY);
7908 argv[1] = *get_vim_var_tv(VV_VAL);
7909 newtv.v_type = VAR_UNKNOWN;
7910
zeertzjqad0c4422023-08-17 22:15:47 +02007911 if (eval_expr_typval(expr, FALSE, argv, 2, NULL, &newtv) == FAIL)
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01007912 return FALSE;
7913
7914 found = tv_get_bool_chk(&newtv, &error);
Yegappan Lakshmanan63acae12022-08-14 12:07:11 +01007915 clear_tv(&newtv);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01007916
7917 return error ? FALSE : found;
7918}
7919
7920/*
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01007921 * Evaluate 'expr' for each byte in the Blob 'b' starting with the byte at
7922 * 'startidx' and return the index of the byte where 'expr' is TRUE. Returns
7923 * -1 if 'expr' doesn't evaluate to TRUE for any of the bytes.
7924 */
7925 static int
7926indexof_blob(blob_T *b, long startidx, typval_T *expr)
7927{
7928 long idx = 0;
7929
7930 if (b == NULL)
7931 return -1;
7932
7933 if (startidx < 0)
7934 {
7935 // negative index: index from the last byte
7936 startidx = blob_len(b) + startidx;
7937 if (startidx < 0)
7938 startidx = 0;
7939 }
7940
7941 set_vim_var_type(VV_KEY, VAR_NUMBER);
7942 set_vim_var_type(VV_VAL, VAR_NUMBER);
7943
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02007944 int called_emsg_start = called_emsg;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01007945 for (idx = startidx; idx < blob_len(b); ++idx)
7946 {
7947 set_vim_var_nr(VV_KEY, idx);
7948 set_vim_var_nr(VV_VAL, blob_get(b, idx));
7949
7950 if (indexof_eval_expr(expr))
7951 return idx;
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02007952
7953 if (called_emsg != called_emsg_start)
7954 return -1;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01007955 }
7956
7957 return -1;
7958}
7959
7960/*
7961 * Evaluate 'expr' for each item in the List 'l' starting with the item at
7962 * 'startidx' and return the index of the item where 'expr' is TRUE. Returns
7963 * -1 if 'expr' doesn't evaluate to TRUE for any of the items.
7964 */
7965 static int
7966indexof_list(list_T *l, long startidx, typval_T *expr)
7967{
7968 listitem_T *item;
7969 long idx = 0;
Yegappan Lakshmanan63acae12022-08-14 12:07:11 +01007970 int found;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01007971
7972 if (l == NULL)
7973 return -1;
7974
7975 CHECK_LIST_MATERIALIZE(l);
7976
7977 if (startidx == 0)
7978 item = l->lv_first;
7979 else
7980 {
7981 // Start at specified item. Use the cached index that list_find()
7982 // sets, so that a negative number also works.
7983 item = list_find(l, startidx);
7984 if (item != NULL)
7985 idx = l->lv_u.mat.lv_idx;
7986 }
7987
7988 set_vim_var_type(VV_KEY, VAR_NUMBER);
7989
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02007990 int called_emsg_start = called_emsg;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01007991 for ( ; item != NULL; item = item->li_next, ++idx)
7992 {
7993 set_vim_var_nr(VV_KEY, idx);
7994 copy_tv(&item->li_tv, get_vim_var_tv(VV_VAL));
7995
Yegappan Lakshmanan63acae12022-08-14 12:07:11 +01007996 found = indexof_eval_expr(expr);
7997 clear_tv(get_vim_var_tv(VV_VAL));
7998
7999 if (found)
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008000 return idx;
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008001
8002 if (called_emsg != called_emsg_start)
8003 return -1;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008004 }
8005
8006 return -1;
8007}
8008
8009/*
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008010 * "indexof()" function
8011 */
8012 static void
8013f_indexof(typval_T *argvars, typval_T *rettv)
8014{
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008015 long startidx = 0;
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008016 typval_T save_val;
8017 typval_T save_key;
8018 int save_did_emsg;
8019
8020 rettv->vval.v_number = -1;
8021
8022 if (check_for_list_or_blob_arg(argvars, 0) == FAIL
8023 || check_for_string_or_func_arg(argvars, 1) == FAIL
8024 || check_for_opt_dict_arg(argvars, 2) == FAIL)
8025 return;
8026
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008027 if ((argvars[1].v_type == VAR_STRING &&
8028 (argvars[1].vval.v_string == NULL
8029 || *argvars[1].vval.v_string == NUL))
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008030 || (argvars[1].v_type == VAR_FUNC
8031 && argvars[1].vval.v_partial == NULL))
8032 return;
8033
8034 if (argvars[2].v_type == VAR_DICT)
8035 startidx = dict_get_number_def(argvars[2].vval.v_dict, "startidx", 0);
8036
8037 prepare_vimvar(VV_VAL, &save_val);
8038 prepare_vimvar(VV_KEY, &save_key);
8039
8040 // We reset "did_emsg" to be able to detect whether an error occurred
8041 // during evaluation of the expression.
8042 save_did_emsg = did_emsg;
8043 did_emsg = FALSE;
8044
8045 if (argvars[0].v_type == VAR_BLOB)
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008046 rettv->vval.v_number = indexof_blob(argvars[0].vval.v_blob, startidx,
8047 &argvars[1]);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008048 else
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008049 rettv->vval.v_number = indexof_list(argvars[0].vval.v_list, startidx,
8050 &argvars[1]);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008051
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008052 restore_vimvar(VV_KEY, &save_key);
8053 restore_vimvar(VV_VAL, &save_val);
8054 did_emsg |= save_did_emsg;
8055}
8056
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008057static int inputsecret_flag = 0;
8058
8059/*
8060 * "input()" function
8061 * Also handles inputsecret() when inputsecret is set.
8062 */
8063 static void
8064f_input(typval_T *argvars, typval_T *rettv)
8065{
8066 get_user_input(argvars, rettv, FALSE, inputsecret_flag);
8067}
8068
8069/*
8070 * "inputdialog()" function
8071 */
8072 static void
8073f_inputdialog(typval_T *argvars, typval_T *rettv)
8074{
8075#if defined(FEAT_GUI_TEXTDIALOG)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008076 // Use a GUI dialog if the GUI is running and 'c' is not in 'guioptions'
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008077 if (gui.in_use && vim_strchr(p_go, GO_CONDIALOG) == NULL)
8078 {
8079 char_u *message;
8080 char_u buf[NUMBUFLEN];
8081 char_u *defstr = (char_u *)"";
8082
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008083 if (in_vim9script()
8084 && (check_for_string_arg(argvars, 0) == FAIL
8085 || check_for_opt_string_arg(argvars, 1) == FAIL
8086 || (argvars[1].v_type != VAR_UNKNOWN
8087 && check_for_opt_string_arg(argvars, 2) == FAIL)))
8088 return;
8089
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008090 message = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008091 if (argvars[1].v_type != VAR_UNKNOWN
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008092 && (defstr = tv_get_string_buf_chk(&argvars[1], buf)) != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008093 vim_strncpy(IObuff, defstr, IOSIZE - 1);
8094 else
8095 IObuff[0] = NUL;
8096 if (message != NULL && defstr != NULL
8097 && do_dialog(VIM_QUESTION, NULL, message,
8098 (char_u *)_("&OK\n&Cancel"), 1, IObuff, FALSE) == 1)
8099 rettv->vval.v_string = vim_strsave(IObuff);
8100 else
8101 {
8102 if (message != NULL && defstr != NULL
8103 && argvars[1].v_type != VAR_UNKNOWN
8104 && argvars[2].v_type != VAR_UNKNOWN)
8105 rettv->vval.v_string = vim_strsave(
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008106 tv_get_string_buf(&argvars[2], buf));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008107 else
8108 rettv->vval.v_string = NULL;
8109 }
8110 rettv->v_type = VAR_STRING;
8111 }
8112 else
8113#endif
8114 get_user_input(argvars, rettv, TRUE, inputsecret_flag);
8115}
8116
8117/*
8118 * "inputlist()" function
8119 */
8120 static void
8121f_inputlist(typval_T *argvars, typval_T *rettv)
8122{
Bram Moolenaar50985eb2020-01-27 22:09:39 +01008123 list_T *l;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008124 listitem_T *li;
8125 int selected;
8126 int mouse_used;
8127
8128#ifdef NO_CONSOLE_INPUT
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008129 // While starting up, there is no place to enter text. When running tests
8130 // with --not-a-term we assume feedkeys() will be used.
Bram Moolenaar91d348a2017-07-29 20:16:03 +02008131 if (no_console_input() && !is_not_a_term())
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008132 return;
8133#endif
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008134 if (in_vim9script() && check_for_list_arg(argvars, 0) == FAIL)
8135 return;
8136
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008137 if (argvars[0].v_type != VAR_LIST || argvars[0].vval.v_list == NULL)
8138 {
Bram Moolenaar3a846e62022-01-01 16:21:00 +00008139 semsg(_(e_argument_of_str_must_be_list), "inputlist()");
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008140 return;
8141 }
8142
8143 msg_start();
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008144 msg_row = Rows - 1; // for when 'cmdheight' > 1
8145 lines_left = Rows; // avoid more prompt
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008146 msg_scroll = TRUE;
8147 msg_clr_eos();
8148
Bram Moolenaar50985eb2020-01-27 22:09:39 +01008149 l = argvars[0].vval.v_list;
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02008150 CHECK_LIST_MATERIALIZE(l);
Bram Moolenaar00d253e2020-04-06 22:13:01 +02008151 FOR_ALL_LIST_ITEMS(l, li)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008152 {
Bram Moolenaar32526b32019-01-19 17:43:09 +01008153 msg_puts((char *)tv_get_string(&li->li_tv));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008154 msg_putchar('\n');
8155 }
8156
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008157 // Ask for choice.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008158 selected = prompt_for_number(&mouse_used);
8159 if (mouse_used)
8160 selected -= lines_left;
8161
8162 rettv->vval.v_number = selected;
8163}
8164
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008165static garray_T ga_userinput = {0, 0, sizeof(tasave_T), 4, NULL};
8166
8167/*
8168 * "inputrestore()" function
8169 */
8170 static void
8171f_inputrestore(typval_T *argvars UNUSED, typval_T *rettv)
8172{
8173 if (ga_userinput.ga_len > 0)
8174 {
8175 --ga_userinput.ga_len;
8176 restore_typeahead((tasave_T *)(ga_userinput.ga_data)
Bram Moolenaarc41badb2021-06-07 22:04:52 +02008177 + ga_userinput.ga_len, TRUE);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008178 // default return is zero == OK
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008179 }
8180 else if (p_verbose > 1)
8181 {
Bram Moolenaar32526b32019-01-19 17:43:09 +01008182 verb_msg(_("called inputrestore() more often than inputsave()"));
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008183 rettv->vval.v_number = 1; // Failed
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008184 }
8185}
8186
8187/*
8188 * "inputsave()" function
8189 */
8190 static void
8191f_inputsave(typval_T *argvars UNUSED, typval_T *rettv)
8192{
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008193 // Add an entry to the stack of typeahead storage.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008194 if (ga_grow(&ga_userinput, 1) == OK)
8195 {
8196 save_typeahead((tasave_T *)(ga_userinput.ga_data)
8197 + ga_userinput.ga_len);
8198 ++ga_userinput.ga_len;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008199 // default return is zero == OK
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008200 }
8201 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008202 rettv->vval.v_number = 1; // Failed
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008203}
8204
8205/*
8206 * "inputsecret()" function
8207 */
8208 static void
8209f_inputsecret(typval_T *argvars, typval_T *rettv)
8210{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008211 if (in_vim9script()
8212 && (check_for_string_arg(argvars, 0) == FAIL
8213 || check_for_opt_string_arg(argvars, 1) == FAIL))
8214 return;
8215
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008216 ++cmdline_star;
8217 ++inputsecret_flag;
8218 f_input(argvars, rettv);
8219 --cmdline_star;
8220 --inputsecret_flag;
8221}
8222
8223/*
Bram Moolenaar67a2deb2019-11-25 00:05:32 +01008224 * "interrupt()" function
8225 */
8226 static void
8227f_interrupt(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
8228{
8229 got_int = TRUE;
8230}
8231
8232/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008233 * "invert(expr)" function
8234 */
8235 static void
8236f_invert(typval_T *argvars, typval_T *rettv)
8237{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008238 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
8239 return;
8240
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008241 rettv->vval.v_number = ~tv_get_number_chk(&argvars[0], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008242}
8243
8244/*
Ernie Rael4c8da022023-10-11 21:35:11 +02008245 * Free resources in lval_root allocated by fill_exec_lval_root().
8246 */
8247 static void
8248free_lval_root(lval_root_T *root)
8249{
8250 if (root->lr_tv != NULL)
8251 free_tv(root->lr_tv);
8252 class_unref(root->lr_cl_exec);
8253 root->lr_tv = NULL;
8254 root->lr_cl_exec = NULL;
8255}
8256
8257/*
8258 * This is used if executing in a method, the argument string is a
Ernie Rael0f058d12023-10-14 11:25:04 +02008259 * variable/item expr/reference. It may start with a potential class/object
8260 * variable.
Ernie Rael4c8da022023-10-11 21:35:11 +02008261 *
Ernie Rael0f058d12023-10-14 11:25:04 +02008262 * Adjust "root" as needed; lr_tv may be changed or freed.
Ernie Rael4c8da022023-10-11 21:35:11 +02008263 *
8264 * Always returns OK.
8265 * Free resources and return FAIL if the root should not be used. Otherwise OK.
8266 */
8267
8268 static int
Ernie Rael0f058d12023-10-14 11:25:04 +02008269fix_variable_reference_lval_root(lval_root_T *root, char_u *name)
Ernie Rael4c8da022023-10-11 21:35:11 +02008270{
Ernie Rael4c8da022023-10-11 21:35:11 +02008271
Ernie Rael0f058d12023-10-14 11:25:04 +02008272 // Check if lr_tv is the name of an object/class reference: name start with
8273 // "this" or name is class variable. Clear lr_tv if neither.
8274 int found_member = FALSE;
Ernie Rael4c8da022023-10-11 21:35:11 +02008275 if (root->lr_tv->v_type == VAR_OBJECT)
8276 {
Ernie Rael0f058d12023-10-14 11:25:04 +02008277 if (STRNCMP("this.", name, 5) == 0 ||STRCMP("this", name) == 0)
8278 found_member = TRUE;
Ernie Rael4c8da022023-10-11 21:35:11 +02008279 }
Ernie Rael0f058d12023-10-14 11:25:04 +02008280 if (!found_member) // not object member, try class member
Ernie Rael4c8da022023-10-11 21:35:11 +02008281 {
8282 // Explicitly check if the name is a class member.
8283 // If it's not then do nothing.
Ernie Rael0f058d12023-10-14 11:25:04 +02008284 char_u *end;
Ernie Rael4c8da022023-10-11 21:35:11 +02008285 for (end = name; ASCII_ISALNUM(*end) || *end == '_'; ++end)
8286 ;
Ernie Rael0f058d12023-10-14 11:25:04 +02008287 int idx = class_member_idx(root->lr_cl_exec, name, end - name);
8288 if (idx >= 0)
Ernie Rael4c8da022023-10-11 21:35:11 +02008289 {
Ernie Rael0f058d12023-10-14 11:25:04 +02008290 // A class variable, replace lr_tv with it
8291 clear_tv(root->lr_tv);
8292 copy_tv(&root->lr_cl_exec->class_members_tv[idx], root->lr_tv);
8293 found_member = TRUE;
Ernie Rael4c8da022023-10-11 21:35:11 +02008294 }
8295 }
Ernie Rael0f058d12023-10-14 11:25:04 +02008296 if (!found_member)
Ernie Rael4c8da022023-10-11 21:35:11 +02008297 {
8298 free_tv(root->lr_tv);
8299 root->lr_tv = NULL; // Not a member variable
8300 }
Ernie Rael4c8da022023-10-11 21:35:11 +02008301 // If FAIL, then must free_lval_root(root);
8302 return OK;
8303}
8304
8305/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008306 * "islocked()" function
8307 */
8308 static void
8309f_islocked(typval_T *argvars, typval_T *rettv)
8310{
8311 lval_T lv;
8312 char_u *end;
8313 dictitem_T *di;
8314
8315 rettv->vval.v_number = -1;
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02008316
8317 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
8318 return;
8319
Ernie Rael4c8da022023-10-11 21:35:11 +02008320 char_u *name = tv_get_string(&argvars[0]);
8321#ifdef LOG_LOCKVAR
8322 ch_log(NULL, "LKVAR: f_islocked(): name: %s", name);
8323#endif
8324
8325 lval_root_T aroot; // fully initialized in fill_exec_lval_root
8326 lval_root_T *root = NULL;
8327
8328 // Set up lval_root if executing in a method.
8329 if (fill_exec_lval_root(&aroot) == OK)
8330 {
8331 // Almost always produces a valid lval_root since lr_cl_exec is used
8332 // for access verification, lr_tv may be set to NULL.
Ernie Rael0f058d12023-10-14 11:25:04 +02008333 if (fix_variable_reference_lval_root(&aroot, name) == OK)
Ernie Rael4c8da022023-10-11 21:35:11 +02008334 root = &aroot;
Ernie Rael4c8da022023-10-11 21:35:11 +02008335 }
8336
8337 lval_root_T *lval_root_save = lval_root;
8338 lval_root = root;
8339 end = get_lval(name, NULL, &lv, FALSE, FALSE,
Bram Moolenaarbd77aa92021-08-12 17:06:05 +02008340 GLV_NO_AUTOLOAD | GLV_READ_ONLY | GLV_NO_DECL,
8341 FNE_CHECK_START);
Ernie Rael4c8da022023-10-11 21:35:11 +02008342 lval_root = lval_root_save;
8343
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008344 if (end != NULL && lv.ll_name != NULL)
8345 {
8346 if (*end != NUL)
Bram Moolenaar1840a7b2021-07-13 20:32:29 +02008347 {
8348 semsg(_(lv.ll_name == lv.ll_name_end
Bram Moolenaar0bd663a2022-01-22 10:24:47 +00008349 ? e_invalid_argument_str : e_trailing_characters_str), end);
Bram Moolenaar1840a7b2021-07-13 20:32:29 +02008350 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008351 else
8352 {
8353 if (lv.ll_tv == NULL)
8354 {
Bram Moolenaar79518e22017-02-17 16:31:35 +01008355 di = find_var(lv.ll_name, NULL, TRUE);
8356 if (di != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008357 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008358 // Consider a variable locked when:
8359 // 1. the variable itself is locked
8360 // 2. the value of the variable is locked.
8361 // 3. the List or Dict value is locked.
Bram Moolenaar79518e22017-02-17 16:31:35 +01008362 rettv->vval.v_number = ((di->di_flags & DI_FLAGS_LOCK)
8363 || tv_islocked(&di->di_tv));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008364 }
8365 }
Ernie Rael4c8da022023-10-11 21:35:11 +02008366 else if (lv.ll_is_root)
8367 {
8368 rettv->vval.v_number = tv_islocked(lv.ll_tv);
8369 }
Ernie Rael9771b2a2023-10-07 22:05:40 +02008370 else if (lv.ll_object != NULL)
8371 {
8372 typval_T *tv = ((typval_T *)(lv.ll_object + 1)) + lv.ll_oi;
8373 rettv->vval.v_number = tv_islocked(tv);
8374#ifdef LOG_LOCKVAR
8375 ch_log(NULL, "LKVAR: f_islocked(): name %s (obj)", lv.ll_name);
8376#endif
8377 }
8378 else if (lv.ll_class != NULL)
8379 {
8380 typval_T *tv = &lv.ll_class->class_members_tv[lv.ll_oi];
8381 rettv->vval.v_number = tv_islocked(tv);
8382#ifdef LOG_LOCKVAR
8383 ch_log(NULL, "LKVAR: f_islocked(): name %s (cl)", lv.ll_name);
8384#endif
8385 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008386 else if (lv.ll_range)
Bram Moolenaar677658a2022-01-05 16:09:06 +00008387 emsg(_(e_range_not_allowed));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008388 else if (lv.ll_newkey != NULL)
Bram Moolenaara9fa8c52023-01-02 18:10:04 +00008389 semsg(_(e_key_not_present_in_dictionary_str), lv.ll_newkey);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008390 else if (lv.ll_list != NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008391 // List item.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008392 rettv->vval.v_number = tv_islocked(&lv.ll_li->li_tv);
8393 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008394 // Dictionary item.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008395 rettv->vval.v_number = tv_islocked(&lv.ll_di->di_tv);
8396 }
8397 }
8398
Ernie Rael4c8da022023-10-11 21:35:11 +02008399 if (root != NULL)
8400 free_lval_root(root);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008401 clear_lval(&lv);
8402}
8403
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008404/*
zeertzjqcdc83932022-09-12 13:38:41 +01008405 * "keytrans()" function
8406 */
8407 static void
8408f_keytrans(typval_T *argvars, typval_T *rettv)
8409{
8410 char_u *escaped;
8411
8412 rettv->v_type = VAR_STRING;
8413 if (check_for_string_arg(argvars, 0) == FAIL
8414 || argvars[0].vval.v_string == NULL)
8415 return;
8416 // Need to escape K_SPECIAL and CSI for mb_unescape().
8417 escaped = vim_strsave_escape_csi(argvars[0].vval.v_string);
8418 rettv->vval.v_string = str2special_save(escaped, TRUE, TRUE);
8419 vim_free(escaped);
8420}
8421
8422/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008423 * "last_buffer_nr()" function.
8424 */
8425 static void
8426f_last_buffer_nr(typval_T *argvars UNUSED, typval_T *rettv)
8427{
8428 int n = 0;
8429 buf_T *buf;
8430
Bram Moolenaar29323592016-07-24 22:04:11 +02008431 FOR_ALL_BUFFERS(buf)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008432 if (n < buf->b_fnum)
8433 n = buf->b_fnum;
8434
8435 rettv->vval.v_number = n;
8436}
8437
8438/*
8439 * "len()" function
8440 */
LemonBoy58f331a2022-04-02 21:59:06 +01008441 void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008442f_len(typval_T *argvars, typval_T *rettv)
8443{
8444 switch (argvars[0].v_type)
8445 {
8446 case VAR_STRING:
8447 case VAR_NUMBER:
8448 rettv->vval.v_number = (varnumber_T)STRLEN(
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008449 tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008450 break;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008451 case VAR_BLOB:
8452 rettv->vval.v_number = blob_len(argvars[0].vval.v_blob);
8453 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008454 case VAR_LIST:
8455 rettv->vval.v_number = list_len(argvars[0].vval.v_list);
8456 break;
8457 case VAR_DICT:
8458 rettv->vval.v_number = dict_len(argvars[0].vval.v_dict);
8459 break;
Yegappan Lakshmanand3eae7b2024-03-03 16:26:58 +01008460 case VAR_OBJECT:
8461 rettv->vval.v_number = object_len(argvars[0].vval.v_object);
8462 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008463 case VAR_UNKNOWN:
Bram Moolenaar4c683752020-04-05 21:38:23 +02008464 case VAR_ANY:
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01008465 case VAR_VOID:
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01008466 case VAR_BOOL:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008467 case VAR_SPECIAL:
8468 case VAR_FLOAT:
8469 case VAR_FUNC:
8470 case VAR_PARTIAL:
8471 case VAR_JOB:
8472 case VAR_CHANNEL:
Bram Moolenaarf18332f2021-05-07 17:55:55 +02008473 case VAR_INSTR:
Bram Moolenaar00b28d62022-12-08 15:32:33 +00008474 case VAR_CLASS:
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +02008475 case VAR_TYPEALIAS:
Bram Moolenaara6f79292022-01-04 21:30:47 +00008476 emsg(_(e_invalid_type_for_len));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008477 break;
8478 }
8479}
8480
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008481 static void
Bram Moolenaar6d721c72017-01-17 16:56:28 +01008482libcall_common(typval_T *argvars UNUSED, typval_T *rettv, int type)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008483{
8484#ifdef FEAT_LIBCALL
8485 char_u *string_in;
8486 char_u **string_result;
8487 int nr_result;
8488#endif
8489
8490 rettv->v_type = type;
8491 if (type != VAR_NUMBER)
8492 rettv->vval.v_string = NULL;
8493
8494 if (check_restricted() || check_secure())
8495 return;
8496
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02008497 if (in_vim9script()
8498 && (check_for_string_arg(argvars, 0) == FAIL
8499 || check_for_string_arg(argvars, 1) == FAIL
8500 || check_for_string_or_number_arg(argvars, 2) == FAIL))
8501 return;
8502
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008503#ifdef FEAT_LIBCALL
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008504 // The first two args must be strings, otherwise it's meaningless
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008505 if (argvars[0].v_type == VAR_STRING && argvars[1].v_type == VAR_STRING)
8506 {
8507 string_in = NULL;
8508 if (argvars[2].v_type == VAR_STRING)
8509 string_in = argvars[2].vval.v_string;
8510 if (type == VAR_NUMBER)
Bram Moolenaar87e15872021-09-02 19:53:07 +02008511 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008512 string_result = NULL;
Bram Moolenaar87e15872021-09-02 19:53:07 +02008513 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008514 else
Bram Moolenaar87e15872021-09-02 19:53:07 +02008515 {
8516 rettv->vval.v_string = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008517 string_result = &rettv->vval.v_string;
Bram Moolenaar87e15872021-09-02 19:53:07 +02008518 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008519 if (mch_libcall(argvars[0].vval.v_string,
8520 argvars[1].vval.v_string,
8521 string_in,
8522 argvars[2].vval.v_number,
8523 string_result,
8524 &nr_result) == OK
8525 && type == VAR_NUMBER)
8526 rettv->vval.v_number = nr_result;
8527 }
8528#endif
8529}
8530
8531/*
8532 * "libcall()" function
8533 */
8534 static void
8535f_libcall(typval_T *argvars, typval_T *rettv)
8536{
8537 libcall_common(argvars, rettv, VAR_STRING);
8538}
8539
8540/*
8541 * "libcallnr()" function
8542 */
8543 static void
8544f_libcallnr(typval_T *argvars, typval_T *rettv)
8545{
8546 libcall_common(argvars, rettv, VAR_NUMBER);
8547}
8548
8549/*
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008550 * "line(string, [winid])" function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008551 */
8552 static void
8553f_line(typval_T *argvars, typval_T *rettv)
8554{
8555 linenr_T lnum = 0;
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008556 pos_T *fp = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008557 int fnum;
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008558 int id;
8559 tabpage_T *tp;
8560 win_T *wp;
Bram Moolenaar18f47402022-01-06 13:24:51 +00008561 switchwin_T switchwin;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008562
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02008563 if (in_vim9script()
8564 && (check_for_string_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008565 || check_for_opt_number_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02008566 return;
8567
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008568 if (argvars[1].v_type != VAR_UNKNOWN)
8569 {
8570 // use window specified in the second argument
8571 id = (int)tv_get_number(&argvars[1]);
8572 wp = win_id2wp_tp(id, &tp);
8573 if (wp != NULL && tp != NULL)
8574 {
Bram Moolenaar18f47402022-01-06 13:24:51 +00008575 if (switch_win_noblock(&switchwin, wp, tp, TRUE) == OK)
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008576 {
John Marriott69f85c62024-10-31 10:53:43 +01008577#ifdef FEAT_DIFF
Christian Brabandt05a40e02024-10-29 20:29:04 +01008578 // in diff mode, prevent that the window scrolls
8579 // and keep the topline
8580 if (curwin->w_p_diff && switchwin.sw_curwin->w_p_diff)
8581 skip_update_topline = TRUE;
John Marriott69f85c62024-10-31 10:53:43 +01008582#endif
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008583 check_cursor();
Bram Moolenaar6f02b002021-01-10 20:22:54 +01008584 fp = var2fpos(&argvars[0], TRUE, &fnum, FALSE);
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008585 }
John Marriott69f85c62024-10-31 10:53:43 +01008586#ifdef FEAT_DIFF
Christian Brabandt05a40e02024-10-29 20:29:04 +01008587 if (curwin->w_p_diff && switchwin.sw_curwin->w_p_diff)
8588 skip_update_topline = FALSE;
John Marriott69f85c62024-10-31 10:53:43 +01008589#endif
Bram Moolenaar18f47402022-01-06 13:24:51 +00008590 restore_win_noblock(&switchwin, TRUE);
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008591 }
8592 }
8593 else
8594 // use current window
Bram Moolenaar6f02b002021-01-10 20:22:54 +01008595 fp = var2fpos(&argvars[0], TRUE, &fnum, FALSE);
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008596
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008597 if (fp != NULL)
8598 lnum = fp->lnum;
8599 rettv->vval.v_number = lnum;
8600}
8601
8602/*
8603 * "line2byte(lnum)" function
8604 */
8605 static void
8606f_line2byte(typval_T *argvars UNUSED, typval_T *rettv)
8607{
8608#ifndef FEAT_BYTEOFF
8609 rettv->vval.v_number = -1;
8610#else
8611 linenr_T lnum;
8612
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008613 if (in_vim9script() && check_for_lnum_arg(argvars, 0) == FAIL)
8614 return;
8615
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008616 lnum = tv_get_lnum(argvars);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008617 if (lnum < 1 || lnum > curbuf->b_ml.ml_line_count + 1)
8618 rettv->vval.v_number = -1;
8619 else
8620 rettv->vval.v_number = ml_find_line_or_offset(curbuf, lnum, NULL);
8621 if (rettv->vval.v_number >= 0)
8622 ++rettv->vval.v_number;
8623#endif
8624}
8625
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008626#ifdef FEAT_LUA
8627/*
8628 * "luaeval()" function
8629 */
8630 static void
8631f_luaeval(typval_T *argvars, typval_T *rettv)
8632{
8633 char_u *str;
8634 char_u buf[NUMBUFLEN];
8635
Bram Moolenaar8c62a082019-02-08 14:34:10 +01008636 if (check_restricted() || check_secure())
8637 return;
8638
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02008639 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
8640 return;
8641
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008642 str = tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008643 do_luaeval(str, argvars + 1, rettv);
8644}
8645#endif
8646
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008647typedef enum
8648{
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008649 MATCH_END, // matchend()
8650 MATCH_MATCH, // match()
8651 MATCH_STR, // matchstr()
8652 MATCH_LIST, // matchlist()
8653 MATCH_POS // matchstrpos()
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008654} matchtype_T;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008655
8656 static void
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008657find_some_match(typval_T *argvars, typval_T *rettv, matchtype_T type)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008658{
8659 char_u *str = NULL;
8660 long len = 0;
8661 char_u *expr = NULL;
8662 char_u *pat;
8663 regmatch_T regmatch;
8664 char_u patbuf[NUMBUFLEN];
8665 char_u strbuf[NUMBUFLEN];
8666 char_u *save_cpo;
8667 long start = 0;
8668 long nth = 1;
8669 colnr_T startcol = 0;
8670 int match = 0;
8671 list_T *l = NULL;
8672 listitem_T *li = NULL;
8673 long idx = 0;
8674 char_u *tofree = NULL;
8675
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008676 // Make 'cpoptions' empty, the 'l' flag should not be used here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008677 save_cpo = p_cpo;
Bram Moolenaare5a2dc82021-01-03 19:52:05 +01008678 p_cpo = empty_option;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008679
8680 rettv->vval.v_number = -1;
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008681 if (type == MATCH_LIST || type == MATCH_POS)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008682 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008683 // type MATCH_LIST: return empty list when there are no matches.
8684 // type MATCH_POS: return ["", -1, -1, -1]
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008685 if (rettv_list_alloc(rettv) == FAIL)
8686 goto theend;
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008687 if (type == MATCH_POS
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008688 && (list_append_string(rettv->vval.v_list,
8689 (char_u *)"", 0) == FAIL
8690 || list_append_number(rettv->vval.v_list,
8691 (varnumber_T)-1) == FAIL
8692 || list_append_number(rettv->vval.v_list,
8693 (varnumber_T)-1) == FAIL
8694 || list_append_number(rettv->vval.v_list,
8695 (varnumber_T)-1) == FAIL))
8696 {
8697 list_free(rettv->vval.v_list);
8698 rettv->vval.v_list = NULL;
8699 goto theend;
8700 }
8701 }
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008702 else if (type == MATCH_STR)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008703 {
8704 rettv->v_type = VAR_STRING;
8705 rettv->vval.v_string = NULL;
8706 }
8707
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02008708 if (in_vim9script()
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008709 && (check_for_string_or_list_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008710 || check_for_string_arg(argvars, 1) == FAIL
8711 || check_for_opt_number_arg(argvars, 2) == FAIL
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02008712 || (argvars[2].v_type != VAR_UNKNOWN
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008713 && check_for_opt_number_arg(argvars, 3) == FAIL)))
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02008714 goto theend;
8715
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008716 if (argvars[0].v_type == VAR_LIST)
8717 {
8718 if ((l = argvars[0].vval.v_list) == NULL)
8719 goto theend;
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02008720 CHECK_LIST_MATERIALIZE(l);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008721 li = l->lv_first;
8722 }
8723 else
8724 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008725 expr = str = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008726 len = (long)STRLEN(str);
8727 }
8728
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008729 pat = tv_get_string_buf_chk(&argvars[1], patbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008730 if (pat == NULL)
8731 goto theend;
8732
8733 if (argvars[2].v_type != VAR_UNKNOWN)
8734 {
8735 int error = FALSE;
8736
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008737 start = (long)tv_get_number_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008738 if (error)
8739 goto theend;
8740 if (l != NULL)
8741 {
8742 li = list_find(l, start);
8743 if (li == NULL)
8744 goto theend;
Bram Moolenaar0ff6aad2020-01-29 21:27:21 +01008745 idx = l->lv_u.mat.lv_idx; // use the cached index
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008746 }
8747 else
8748 {
8749 if (start < 0)
8750 start = 0;
8751 if (start > len)
8752 goto theend;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008753 // When "count" argument is there ignore matches before "start",
8754 // otherwise skip part of the string. Differs when pattern is "^"
8755 // or "\<".
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008756 if (argvars[3].v_type != VAR_UNKNOWN)
8757 startcol = start;
8758 else
8759 {
8760 str += start;
8761 len -= start;
8762 }
8763 }
8764
8765 if (argvars[3].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008766 nth = (long)tv_get_number_chk(&argvars[3], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008767 if (error)
8768 goto theend;
8769 }
8770
8771 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
8772 if (regmatch.regprog != NULL)
8773 {
8774 regmatch.rm_ic = p_ic;
8775
8776 for (;;)
8777 {
8778 if (l != NULL)
8779 {
8780 if (li == NULL)
8781 {
8782 match = FALSE;
8783 break;
8784 }
8785 vim_free(tofree);
8786 expr = str = echo_string(&li->li_tv, &tofree, strbuf, 0);
8787 if (str == NULL)
8788 break;
8789 }
8790
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +00008791 match = vim_regexec_nl(&regmatch, str, startcol);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008792
8793 if (match && --nth <= 0)
8794 break;
8795 if (l == NULL && !match)
8796 break;
8797
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008798 // Advance to just after the match.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008799 if (l != NULL)
8800 {
8801 li = li->li_next;
8802 ++idx;
8803 }
8804 else
8805 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008806 startcol = (colnr_T)(regmatch.startp[0]
8807 + (*mb_ptr2len)(regmatch.startp[0]) - str);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008808 if (startcol > (colnr_T)len
8809 || str + startcol <= regmatch.startp[0])
8810 {
8811 match = FALSE;
8812 break;
8813 }
8814 }
8815 }
8816
8817 if (match)
8818 {
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008819 if (type == MATCH_POS)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008820 {
8821 listitem_T *li1 = rettv->vval.v_list->lv_first;
8822 listitem_T *li2 = li1->li_next;
8823 listitem_T *li3 = li2->li_next;
8824 listitem_T *li4 = li3->li_next;
8825
8826 vim_free(li1->li_tv.vval.v_string);
8827 li1->li_tv.vval.v_string = vim_strnsave(regmatch.startp[0],
Bram Moolenaardf44a272020-06-07 20:49:05 +02008828 regmatch.endp[0] - regmatch.startp[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008829 li3->li_tv.vval.v_number =
8830 (varnumber_T)(regmatch.startp[0] - expr);
8831 li4->li_tv.vval.v_number =
8832 (varnumber_T)(regmatch.endp[0] - expr);
8833 if (l != NULL)
8834 li2->li_tv.vval.v_number = (varnumber_T)idx;
8835 }
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008836 else if (type == MATCH_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008837 {
8838 int i;
8839
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008840 // return list with matched string and submatches
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008841 for (i = 0; i < NSUBEXP; ++i)
8842 {
8843 if (regmatch.endp[i] == NULL)
8844 {
8845 if (list_append_string(rettv->vval.v_list,
8846 (char_u *)"", 0) == FAIL)
8847 break;
8848 }
8849 else if (list_append_string(rettv->vval.v_list,
8850 regmatch.startp[i],
8851 (int)(regmatch.endp[i] - regmatch.startp[i]))
8852 == FAIL)
8853 break;
8854 }
8855 }
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008856 else if (type == MATCH_STR)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008857 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008858 // return matched string
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008859 if (l != NULL)
8860 copy_tv(&li->li_tv, rettv);
8861 else
8862 rettv->vval.v_string = vim_strnsave(regmatch.startp[0],
Bram Moolenaardf44a272020-06-07 20:49:05 +02008863 regmatch.endp[0] - regmatch.startp[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008864 }
8865 else if (l != NULL)
8866 rettv->vval.v_number = idx;
8867 else
8868 {
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008869 if (type != MATCH_END)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008870 rettv->vval.v_number =
8871 (varnumber_T)(regmatch.startp[0] - str);
8872 else
8873 rettv->vval.v_number =
8874 (varnumber_T)(regmatch.endp[0] - str);
8875 rettv->vval.v_number += (varnumber_T)(str - expr);
8876 }
8877 }
8878 vim_regfree(regmatch.regprog);
8879 }
8880
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008881theend:
8882 if (type == MATCH_POS && l == NULL && rettv->vval.v_list != NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008883 // matchstrpos() without a list: drop the second item.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008884 listitem_remove(rettv->vval.v_list,
8885 rettv->vval.v_list->lv_first->li_next);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008886 vim_free(tofree);
8887 p_cpo = save_cpo;
8888}
8889
8890/*
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01008891 * Return all the matches in string "str" for pattern "rmp".
8892 * The matches are returned in the List "mlist".
8893 * If "submatches" is TRUE, then submatch information is also returned.
8894 * "matchbuf" is TRUE when called for matchbufline().
8895 */
8896 static int
8897get_matches_in_str(
8898 char_u *str,
8899 regmatch_T *rmp,
8900 list_T *mlist,
8901 int idx,
8902 int submatches,
8903 int matchbuf)
8904{
8905 long len = (long)STRLEN(str);
8906 int match = 0;
8907 colnr_T startidx = 0;
8908
8909 for (;;)
8910 {
8911 match = vim_regexec_nl(rmp, str, startidx);
8912 if (!match)
8913 break;
8914
8915 dict_T *d = dict_alloc();
8916 if (d == NULL)
8917 return FAIL;
8918 if (list_append_dict(mlist, d) == FAIL)
8919 return FAIL;;
8920
8921 if (dict_add_number(d, matchbuf ? "lnum" : "idx", idx) == FAIL)
8922 return FAIL;
8923
8924 if (dict_add_number(d, "byteidx",
8925 (colnr_T)(rmp->startp[0] - str)) == FAIL)
8926 return FAIL;
8927
8928 if (dict_add_string_len(d, "text", rmp->startp[0],
8929 (int)(rmp->endp[0] - rmp->startp[0])) == FAIL)
8930 return FAIL;
8931
8932 if (submatches)
8933 {
8934 list_T *sml = list_alloc();
8935 if (sml == NULL)
8936 return FAIL;
8937
8938 if (dict_add_list(d, "submatches", sml) == FAIL)
8939 return FAIL;
8940
8941 // return a list with the submatches
8942 for (int i = 1; i < NSUBEXP; ++i)
8943 {
8944 if (rmp->endp[i] == NULL)
8945 {
8946 if (list_append_string(sml, (char_u *)"", 0) == FAIL)
8947 return FAIL;
8948 }
8949 else if (list_append_string(sml, rmp->startp[i],
8950 (int)(rmp->endp[i] - rmp->startp[i])) == FAIL)
8951 return FAIL;
8952 }
8953 }
8954 startidx = (colnr_T)(rmp->endp[0] - str);
8955 if (startidx >= (colnr_T)len || str + startidx <= rmp->startp[0])
8956 break;
8957 }
8958
8959 return OK;
8960}
8961
8962/*
8963 * "matchbufline()" function
8964 */
8965 static void
8966f_matchbufline(typval_T *argvars, typval_T *rettv)
8967{
8968 list_T *retlist = NULL;
8969 char_u *save_cpo;
8970 char_u patbuf[NUMBUFLEN];
8971 regmatch_T regmatch;
8972
8973 rettv->vval.v_number = -1;
8974 if (rettv_list_alloc(rettv) != OK)
8975 return;
8976 retlist = rettv->vval.v_list;
8977
8978 if (check_for_buffer_arg(argvars, 0) == FAIL
8979 || check_for_string_arg(argvars, 1) == FAIL
8980 || check_for_lnum_arg(argvars, 2) == FAIL
8981 || check_for_lnum_arg(argvars, 3) == FAIL
8982 || check_for_opt_dict_arg(argvars, 4) == FAIL)
8983 return;
8984
8985 int prev_did_emsg = did_emsg;
8986 buf_T *buf = tv_get_buf(&argvars[0], FALSE);
8987 if (buf == NULL)
8988 {
8989 if (did_emsg == prev_did_emsg)
8990 semsg(_(e_invalid_buffer_name_str), tv_get_string(&argvars[0]));
8991 return;
8992 }
8993 if (buf->b_ml.ml_mfp == NULL)
8994 {
8995 emsg(_(e_buffer_is_not_loaded));
8996 return;
8997 }
8998
8999 char_u *pat = tv_get_string_buf(&argvars[1], patbuf);
9000
9001 int did_emsg_before = did_emsg;
9002 linenr_T slnum = tv_get_lnum_buf(&argvars[2], buf);
9003 if (did_emsg > did_emsg_before)
9004 return;
9005 if (slnum < 1)
9006 {
9007 semsg(_(e_invalid_value_for_argument_str), "lnum");
9008 return;
9009 }
9010
9011 linenr_T elnum = tv_get_lnum_buf(&argvars[3], buf);
9012 if (did_emsg > did_emsg_before)
9013 return;
9014 if (elnum < 1 || elnum < slnum)
9015 {
9016 semsg(_(e_invalid_value_for_argument_str), "end_lnum");
9017 return;
9018 }
9019
9020 if (elnum > buf->b_ml.ml_line_count)
9021 elnum = buf->b_ml.ml_line_count;
9022
9023 int submatches = FALSE;
9024 if (argvars[4].v_type != VAR_UNKNOWN)
9025 {
9026 dict_T *d = argvars[4].vval.v_dict;
9027 if (d != NULL)
9028 {
9029 dictitem_T *di = dict_find(d, (char_u *)"submatches", -1);
9030 if (di != NULL)
9031 {
9032 if (di->di_tv.v_type != VAR_BOOL)
9033 {
9034 semsg(_(e_invalid_value_for_argument_str), "submatches");
9035 return;
9036 }
9037 submatches = tv_get_bool(&di->di_tv);
9038 }
9039 }
9040 }
9041
9042 // Make 'cpoptions' empty, the 'l' flag should not be used here.
9043 save_cpo = p_cpo;
9044 p_cpo = empty_option;
9045
9046 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
9047 if (regmatch.regprog == NULL)
9048 goto theend;
9049 regmatch.rm_ic = p_ic;
9050
9051 while (slnum <= elnum)
9052 {
9053 char_u *str = ml_get_buf(buf, slnum, FALSE);
9054 if (get_matches_in_str(str, &regmatch, retlist, slnum, submatches,
9055 TRUE) == FAIL)
9056 goto cleanup;
9057 slnum++;
9058 }
9059
9060cleanup:
9061 vim_regfree(regmatch.regprog);
9062
9063theend:
9064 p_cpo = save_cpo;
9065}
9066
9067/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009068 * "match()" function
9069 */
9070 static void
9071f_match(typval_T *argvars, typval_T *rettv)
9072{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009073 find_some_match(argvars, rettv, MATCH_MATCH);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009074}
9075
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009076/*
9077 * "matchend()" function
9078 */
9079 static void
9080f_matchend(typval_T *argvars, typval_T *rettv)
9081{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009082 find_some_match(argvars, rettv, MATCH_END);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009083}
9084
9085/*
9086 * "matchlist()" function
9087 */
9088 static void
9089f_matchlist(typval_T *argvars, typval_T *rettv)
9090{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009091 find_some_match(argvars, rettv, MATCH_LIST);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009092}
9093
9094/*
9095 * "matchstr()" function
9096 */
9097 static void
9098f_matchstr(typval_T *argvars, typval_T *rettv)
9099{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009100 find_some_match(argvars, rettv, MATCH_STR);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009101}
9102
9103/*
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01009104 * "matchstrlist()" function
9105 */
9106 static void
9107f_matchstrlist(typval_T *argvars, typval_T *rettv)
9108{
9109 list_T *retlist = NULL;
9110 char_u *save_cpo;
9111 list_T *l = NULL;
9112 listitem_T *li = NULL;
9113 char_u patbuf[NUMBUFLEN];
9114 regmatch_T regmatch;
9115
9116 rettv->vval.v_number = -1;
9117 if (rettv_list_alloc(rettv) != OK)
9118 return;
9119 retlist = rettv->vval.v_list;
9120
9121 if (check_for_list_arg(argvars, 0) == FAIL
9122 || check_for_string_arg(argvars, 1) == FAIL
9123 || check_for_opt_dict_arg(argvars, 2) == FAIL)
9124 return;
9125
9126 if ((l = argvars[0].vval.v_list) == NULL)
9127 return;
9128
9129 char_u *pat = tv_get_string_buf_chk(&argvars[1], patbuf);
9130 if (pat == NULL)
9131 return;
9132
9133 // Make 'cpoptions' empty, the 'l' flag should not be used here.
9134 save_cpo = p_cpo;
9135 p_cpo = empty_option;
9136
9137 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
9138 if (regmatch.regprog == NULL)
9139 goto theend;
9140 regmatch.rm_ic = p_ic;
9141
9142 int submatches = FALSE;
9143 if (argvars[2].v_type != VAR_UNKNOWN)
9144 {
9145 dict_T *d = argvars[2].vval.v_dict;
9146 if (d != NULL)
9147 {
9148 dictitem_T *di = dict_find(d, (char_u *)"submatches", -1);
9149 if (di != NULL)
9150 {
9151 if (di->di_tv.v_type != VAR_BOOL)
9152 {
9153 semsg(_(e_invalid_value_for_argument_str), "submatches");
9154 goto cleanup;
9155 }
9156 submatches = tv_get_bool(&di->di_tv);
9157 }
9158 }
9159 }
9160
9161 int idx = 0;
9162 CHECK_LIST_MATERIALIZE(l);
9163 FOR_ALL_LIST_ITEMS(l, li)
9164 {
9165 if (li->li_tv.v_type == VAR_STRING && li->li_tv.vval.v_string != NULL)
9166 {
9167 char_u *str = li->li_tv.vval.v_string;
9168 if (get_matches_in_str(str, &regmatch, retlist, idx, submatches,
9169 FALSE) == FAIL)
9170 goto cleanup;
9171 }
9172 idx++;
9173 }
9174
9175cleanup:
9176 vim_regfree(regmatch.regprog);
9177
9178theend:
9179 p_cpo = save_cpo;
9180}
9181
9182/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009183 * "matchstrpos()" function
9184 */
9185 static void
9186f_matchstrpos(typval_T *argvars, typval_T *rettv)
9187{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009188 find_some_match(argvars, rettv, MATCH_POS);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009189}
9190
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009191 static void
9192max_min(typval_T *argvars, typval_T *rettv, int domax)
9193{
9194 varnumber_T n = 0;
9195 varnumber_T i;
9196 int error = FALSE;
9197
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009198 if (in_vim9script() && check_for_list_or_dict_arg(argvars, 0) == FAIL)
9199 return;
9200
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009201 if (argvars[0].v_type == VAR_LIST)
9202 {
9203 list_T *l;
9204 listitem_T *li;
9205
9206 l = argvars[0].vval.v_list;
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009207 if (l != NULL && l->lv_len > 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009208 {
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009209 if (l->lv_first == &range_list_item)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009210 {
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009211 if ((l->lv_u.nonmat.lv_stride > 0) ^ domax)
9212 n = l->lv_u.nonmat.lv_start;
9213 else
=?UTF-8?q?Dundar=20G=C3=B6c?=d5cec1f2022-01-29 15:19:23 +00009214 n = l->lv_u.nonmat.lv_start + ((varnumber_T)l->lv_len - 1)
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009215 * l->lv_u.nonmat.lv_stride;
9216 }
9217 else
9218 {
9219 li = l->lv_first;
9220 if (li != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009221 {
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009222 n = tv_get_number_chk(&li->li_tv, &error);
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009223 if (error)
9224 return; // type error; errmsg already given
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009225 for (;;)
9226 {
9227 li = li->li_next;
9228 if (li == NULL)
9229 break;
9230 i = tv_get_number_chk(&li->li_tv, &error);
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009231 if (error)
9232 return; // type error; errmsg already given
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009233 if (domax ? i > n : i < n)
9234 n = i;
9235 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009236 }
9237 }
9238 }
9239 }
9240 else if (argvars[0].v_type == VAR_DICT)
9241 {
9242 dict_T *d;
9243 int first = TRUE;
9244 hashitem_T *hi;
9245 int todo;
9246
9247 d = argvars[0].vval.v_dict;
9248 if (d != NULL)
9249 {
9250 todo = (int)d->dv_hashtab.ht_used;
Yegappan Lakshmanan14113fd2023-03-07 17:13:51 +00009251 FOR_ALL_HASHTAB_ITEMS(&d->dv_hashtab, hi, todo)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009252 {
9253 if (!HASHITEM_EMPTY(hi))
9254 {
9255 --todo;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009256 i = tv_get_number_chk(&HI2DI(hi)->di_tv, &error);
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009257 if (error)
9258 return; // type error; errmsg already given
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009259 if (first)
9260 {
9261 n = i;
9262 first = FALSE;
9263 }
9264 else if (domax ? i > n : i < n)
9265 n = i;
9266 }
9267 }
9268 }
9269 }
9270 else
Bram Moolenaar460ae5d2022-01-01 14:19:49 +00009271 semsg(_(e_argument_of_str_must_be_list_or_dictionary), domax ? "max()" : "min()");
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009272
9273 rettv->vval.v_number = n;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009274}
9275
9276/*
9277 * "max()" function
9278 */
9279 static void
9280f_max(typval_T *argvars, typval_T *rettv)
9281{
9282 max_min(argvars, rettv, TRUE);
9283}
9284
9285/*
9286 * "min()" function
9287 */
9288 static void
9289f_min(typval_T *argvars, typval_T *rettv)
9290{
9291 max_min(argvars, rettv, FALSE);
9292}
9293
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009294#if defined(FEAT_MZSCHEME) || defined(PROTO)
9295/*
9296 * "mzeval()" function
9297 */
9298 static void
9299f_mzeval(typval_T *argvars, typval_T *rettv)
9300{
9301 char_u *str;
9302 char_u buf[NUMBUFLEN];
9303
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009304 if (check_restricted() || check_secure())
9305 return;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009306
9307 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
9308 return;
9309
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009310 str = tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009311 do_mzeval(str, rettv);
9312}
9313
9314 void
9315mzscheme_call_vim(char_u *name, typval_T *args, typval_T *rettv)
9316{
9317 typval_T argvars[3];
9318
9319 argvars[0].v_type = VAR_STRING;
9320 argvars[0].vval.v_string = name;
9321 copy_tv(args, &argvars[1]);
9322 argvars[2].v_type = VAR_UNKNOWN;
9323 f_call(argvars, rettv);
9324 clear_tv(&argvars[1]);
9325}
9326#endif
9327
9328/*
9329 * "nextnonblank()" function
9330 */
9331 static void
9332f_nextnonblank(typval_T *argvars, typval_T *rettv)
9333{
9334 linenr_T lnum;
9335
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009336 if (in_vim9script() && check_for_lnum_arg(argvars, 0) == FAIL)
9337 return;
9338
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009339 for (lnum = tv_get_lnum(argvars); ; ++lnum)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009340 {
9341 if (lnum < 0 || lnum > curbuf->b_ml.ml_line_count)
9342 {
9343 lnum = 0;
9344 break;
9345 }
9346 if (*skipwhite(ml_get(lnum)) != NUL)
9347 break;
9348 }
9349 rettv->vval.v_number = lnum;
9350}
9351
9352/*
9353 * "nr2char()" function
9354 */
9355 static void
9356f_nr2char(typval_T *argvars, typval_T *rettv)
9357{
9358 char_u buf[NUMBUFLEN];
9359
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02009360 if (in_vim9script()
9361 && (check_for_number_arg(argvars, 0) == FAIL
9362 || check_for_opt_bool_arg(argvars, 1) == FAIL))
9363 return;
9364
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009365 if (has_mbyte)
9366 {
9367 int utf8 = 0;
9368
9369 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaared6a4302020-09-05 20:29:41 +02009370 utf8 = (int)tv_get_bool_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009371 if (utf8)
Bram Moolenaarbdace832019-03-02 10:13:42 +01009372 buf[utf_char2bytes((int)tv_get_number(&argvars[0]), buf)] = NUL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009373 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009374 buf[(*mb_char2bytes)((int)tv_get_number(&argvars[0]), buf)] = NUL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009375 }
9376 else
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009377 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009378 buf[0] = (char_u)tv_get_number(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009379 buf[1] = NUL;
9380 }
9381 rettv->v_type = VAR_STRING;
9382 rettv->vval.v_string = vim_strsave(buf);
9383}
9384
9385/*
9386 * "or(expr, expr)" function
9387 */
9388 static void
9389f_or(typval_T *argvars, typval_T *rettv)
9390{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009391 if (in_vim9script()
9392 && (check_for_number_arg(argvars, 0) == FAIL
9393 || check_for_number_arg(argvars, 1) == FAIL))
9394 return;
9395
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009396 rettv->vval.v_number = tv_get_number_chk(&argvars[0], NULL)
9397 | tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009398}
9399
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009400#ifdef FEAT_PERL
9401/*
9402 * "perleval()" function
9403 */
9404 static void
9405f_perleval(typval_T *argvars, typval_T *rettv)
9406{
9407 char_u *str;
9408 char_u buf[NUMBUFLEN];
9409
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009410 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
9411 return;
9412
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009413 str = tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009414 do_perleval(str, rettv);
9415}
9416#endif
9417
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009418/*
9419 * "prevnonblank()" function
9420 */
9421 static void
9422f_prevnonblank(typval_T *argvars, typval_T *rettv)
9423{
9424 linenr_T lnum;
9425
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009426 if (in_vim9script() && check_for_lnum_arg(argvars, 0) == FAIL)
9427 return;
9428
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009429 lnum = tv_get_lnum(argvars);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009430 if (lnum < 1 || lnum > curbuf->b_ml.ml_line_count)
9431 lnum = 0;
9432 else
9433 while (lnum >= 1 && *skipwhite(ml_get(lnum)) == NUL)
9434 --lnum;
9435 rettv->vval.v_number = lnum;
9436}
9437
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009438// This dummy va_list is here because:
9439// - passing a NULL pointer doesn't work when va_list isn't a pointer
9440// - locally in the function results in a "used before set" warning
9441// - using va_start() to initialize it gives "function with fixed args" error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009442static va_list ap;
9443
9444/*
9445 * "printf()" function
9446 */
9447 static void
9448f_printf(typval_T *argvars, typval_T *rettv)
9449{
9450 char_u buf[NUMBUFLEN];
9451 int len;
9452 char_u *s;
9453 int saved_did_emsg = did_emsg;
9454 char *fmt;
9455
9456 rettv->v_type = VAR_STRING;
9457 rettv->vval.v_string = NULL;
9458
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02009459 if (in_vim9script() && check_for_string_or_number_arg(argvars, 0) == FAIL)
9460 return;
9461
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009462 // Get the required length, allocate the buffer and do it for real.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009463 did_emsg = FALSE;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009464 fmt = (char *)tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar8327d1d2017-07-11 22:34:51 +02009465 len = vim_vsnprintf_typval(NULL, 0, fmt, ap, argvars + 1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009466 if (!did_emsg)
9467 {
9468 s = alloc(len + 1);
9469 if (s != NULL)
9470 {
9471 rettv->vval.v_string = s;
Bram Moolenaar8327d1d2017-07-11 22:34:51 +02009472 (void)vim_vsnprintf_typval((char *)s, len + 1, fmt,
9473 ap, argvars + 1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009474 }
9475 }
9476 did_emsg |= saved_did_emsg;
9477}
9478
9479/*
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009480 * "pum_getpos()" function
9481 */
9482 static void
9483f_pum_getpos(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
9484{
Bram Moolenaar93a10962022-06-16 11:42:09 +01009485 if (rettv_dict_alloc(rettv) == FAIL)
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009486 return;
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009487 pum_set_event_info(rettv->vval.v_dict);
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009488}
9489
9490/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009491 * "pumvisible()" function
9492 */
9493 static void
9494f_pumvisible(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
9495{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009496 if (pum_visible())
9497 rettv->vval.v_number = 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009498}
9499
9500#ifdef FEAT_PYTHON3
9501/*
9502 * "py3eval()" function
9503 */
9504 static void
9505f_py3eval(typval_T *argvars, typval_T *rettv)
9506{
9507 char_u *str;
9508 char_u buf[NUMBUFLEN];
Ben Jacksonea19e782024-11-06 21:50:05 +01009509 dict_T *locals;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009510
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009511 if (check_restricted() || check_secure())
9512 return;
9513
Ben Jacksonea19e782024-11-06 21:50:05 +01009514 if (in_vim9script()
9515 && (check_for_string_arg(argvars, 0) == FAIL
9516 || check_for_opt_dict_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009517 return;
9518
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009519 if (p_pyx == 0)
9520 p_pyx = 3;
9521
Ben Jacksonea19e782024-11-06 21:50:05 +01009522 if (argvars[1].v_type == VAR_DICT)
9523 {
9524 locals = argvars[1].vval.v_dict;
9525 }
9526 else if (argvars[1].v_type != VAR_UNKNOWN)
9527 {
9528 emsg(_(e_dictionary_required));
9529 return;
9530 }
9531 else
9532 {
9533 locals = NULL;
9534 }
9535
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009536 str = tv_get_string_buf(&argvars[0], buf);
Ben Jacksonea19e782024-11-06 21:50:05 +01009537 do_py3eval(str, locals, rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009538}
9539#endif
9540
9541#ifdef FEAT_PYTHON
9542/*
9543 * "pyeval()" function
9544 */
9545 static void
9546f_pyeval(typval_T *argvars, typval_T *rettv)
9547{
9548 char_u *str;
9549 char_u buf[NUMBUFLEN];
Ben Jacksonea19e782024-11-06 21:50:05 +01009550 dict_T *locals;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009551
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009552 if (check_restricted() || check_secure())
9553 return;
9554
Ben Jacksonea19e782024-11-06 21:50:05 +01009555 if (in_vim9script() && (
9556 check_for_string_arg(argvars, 0) == FAIL ||
9557 check_for_opt_dict_arg(argvars, 1) == FAIL ) )
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009558 return;
9559
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009560 if (p_pyx == 0)
9561 p_pyx = 2;
9562
Ben Jacksonea19e782024-11-06 21:50:05 +01009563 if (argvars[1].v_type == VAR_DICT)
9564 {
9565 locals = argvars[1].vval.v_dict;
9566 }
9567 else if (argvars[1].v_type != VAR_UNKNOWN)
9568 {
9569 emsg( "Invalid argument: must be dict" );
9570 return;
9571 }
9572 else
9573 {
9574 locals = NULL;
9575 }
9576
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009577 str = tv_get_string_buf(&argvars[0], buf);
Ben Jacksonea19e782024-11-06 21:50:05 +01009578 do_pyeval(str, locals, rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009579}
9580#endif
9581
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009582#if defined(FEAT_PYTHON) || defined(FEAT_PYTHON3)
9583/*
9584 * "pyxeval()" function
9585 */
9586 static void
9587f_pyxeval(typval_T *argvars, typval_T *rettv)
9588{
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009589 if (check_restricted() || check_secure())
9590 return;
9591
Ben Jacksonea19e782024-11-06 21:50:05 +01009592 if (in_vim9script()
9593 && (check_for_string_arg(argvars, 0) == FAIL
9594 || check_for_opt_dict_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009595 return;
9596
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009597# if defined(FEAT_PYTHON) && defined(FEAT_PYTHON3)
9598 init_pyxversion();
9599 if (p_pyx == 2)
9600 f_pyeval(argvars, rettv);
9601 else
9602 f_py3eval(argvars, rettv);
9603# elif defined(FEAT_PYTHON)
9604 f_pyeval(argvars, rettv);
9605# elif defined(FEAT_PYTHON3)
9606 f_py3eval(argvars, rettv);
9607# endif
9608}
9609#endif
9610
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009611static UINT32_T srand_seed_for_testing = 0;
9612static int srand_seed_for_testing_is_used = FALSE;
9613
9614 static void
9615f_test_srand_seed(typval_T *argvars, typval_T *rettv UNUSED)
9616{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009617 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
9618 return;
9619
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009620 if (argvars[0].v_type == VAR_UNKNOWN)
Bram Moolenaar7633fe52020-06-22 19:10:56 +02009621 srand_seed_for_testing_is_used = FALSE;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009622 else
9623 {
Bram Moolenaar7633fe52020-06-22 19:10:56 +02009624 srand_seed_for_testing = (UINT32_T)tv_get_number(&argvars[0]);
9625 srand_seed_for_testing_is_used = TRUE;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009626 }
9627}
9628
9629 static void
9630init_srand(UINT32_T *x)
9631{
LemonBoy9987fe82024-07-04 13:20:49 +02009632 struct {
9633 union {
9634 UINT32_T number;
9635 char_u bytes[sizeof(UINT32_T)];
9636 } contents;
9637 } buf;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009638
9639 if (srand_seed_for_testing_is_used)
9640 {
Bram Moolenaar7633fe52020-06-22 19:10:56 +02009641 *x = srand_seed_for_testing;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009642 return;
9643 }
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009644
LemonBoy9987fe82024-07-04 13:20:49 +02009645 if (mch_get_random(buf.contents.bytes, sizeof(buf.contents.bytes)) == OK)
9646 {
9647 *x = buf.contents.number;
9648 return;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009649 }
LemonBoy9987fe82024-07-04 13:20:49 +02009650
9651 // The system's random number generator doesn't work, fall back to:
9652 // - randombytes_random()
9653 // - reltime() or time()
9654 // - XOR with process ID
9655#if defined(FEAT_SODIUM)
9656 if (crypt_sodium_init() >= 0)
9657 *x = crypt_sodium_randombytes_random();
9658 else
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009659#endif
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009660 {
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009661#if defined(FEAT_RELTIME)
LemonBoy9987fe82024-07-04 13:20:49 +02009662 proftime_T res;
9663 profile_start(&res);
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009664# if defined(MSWIN)
LemonBoy9987fe82024-07-04 13:20:49 +02009665 *x = (UINT32_T)res.LowPart;
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009666# else
LemonBoy9987fe82024-07-04 13:20:49 +02009667 *x = (UINT32_T)res.tv_fsec;
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009668# endif
9669#else
LemonBoy9987fe82024-07-04 13:20:49 +02009670 *x = vim_time();
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009671#endif
LemonBoy9987fe82024-07-04 13:20:49 +02009672 *x ^= mch_get_pid();
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009673 }
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009674}
9675
kylo252ae6f1d82022-02-16 19:24:07 +00009676#define ROTL(x, k) (((x) << (k)) | ((x) >> (32 - (k))))
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009677#define SPLITMIX32(x, z) ( \
kylo252ae6f1d82022-02-16 19:24:07 +00009678 (z) = ((x) += 0x9e3779b9), \
9679 (z) = ((z) ^ ((z) >> 16)) * 0x85ebca6b, \
9680 (z) = ((z) ^ ((z) >> 13)) * 0xc2b2ae35, \
9681 (z) ^ ((z) >> 16) \
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009682 )
9683#define SHUFFLE_XOSHIRO128STARSTAR(x, y, z, w) \
kylo252ae6f1d82022-02-16 19:24:07 +00009684 result = ROTL((y) * 5, 7) * 9; \
9685 t = (y) << 9; \
9686 (z) ^= (x); \
9687 (w) ^= (y); \
9688 (y) ^= (z), (x) ^= (w); \
9689 (z) ^= t; \
9690 (w) = ROTL(w, 11);
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009691
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009692/*
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009693 * "rand()" function
9694 */
9695 static void
9696f_rand(typval_T *argvars, typval_T *rettv)
9697{
9698 list_T *l = NULL;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009699 static UINT32_T gx, gy, gz, gw;
9700 static int initialized = FALSE;
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009701 listitem_T *lx, *ly, *lz, *lw;
Bram Moolenaar0fd797e2020-11-05 20:46:32 +01009702 UINT32_T x = 0, y, z, w, t, result;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009703
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009704 if (in_vim9script() && check_for_opt_list_arg(argvars, 0) == FAIL)
9705 return;
9706
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009707 if (argvars[0].v_type == VAR_UNKNOWN)
9708 {
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009709 // When no argument is given use the global seed list.
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009710 if (initialized == FALSE)
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009711 {
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009712 // Initialize the global seed list.
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009713 init_srand(&x);
9714
9715 gx = SPLITMIX32(x, z);
9716 gy = SPLITMIX32(x, z);
9717 gz = SPLITMIX32(x, z);
9718 gw = SPLITMIX32(x, z);
9719 initialized = TRUE;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009720 }
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009721
9722 SHUFFLE_XOSHIRO128STARSTAR(gx, gy, gz, gw);
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009723 }
9724 else if (argvars[0].v_type == VAR_LIST)
9725 {
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009726 l = argvars[0].vval.v_list;
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009727 if (l == NULL || list_len(l) != 4)
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009728 goto theend;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009729
9730 lx = list_find(l, 0L);
9731 ly = list_find(l, 1L);
9732 lz = list_find(l, 2L);
9733 lw = list_find(l, 3L);
9734 if (lx->li_tv.v_type != VAR_NUMBER) goto theend;
9735 if (ly->li_tv.v_type != VAR_NUMBER) goto theend;
9736 if (lz->li_tv.v_type != VAR_NUMBER) goto theend;
9737 if (lw->li_tv.v_type != VAR_NUMBER) goto theend;
9738 x = (UINT32_T)lx->li_tv.vval.v_number;
9739 y = (UINT32_T)ly->li_tv.vval.v_number;
9740 z = (UINT32_T)lz->li_tv.vval.v_number;
9741 w = (UINT32_T)lw->li_tv.vval.v_number;
9742
9743 SHUFFLE_XOSHIRO128STARSTAR(x, y, z, w);
9744
9745 lx->li_tv.vval.v_number = (varnumber_T)x;
9746 ly->li_tv.vval.v_number = (varnumber_T)y;
9747 lz->li_tv.vval.v_number = (varnumber_T)z;
9748 lw->li_tv.vval.v_number = (varnumber_T)w;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009749 }
9750 else
9751 goto theend;
9752
9753 rettv->v_type = VAR_NUMBER;
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009754 rettv->vval.v_number = (varnumber_T)result;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009755 return;
9756
9757theend:
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00009758 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[0]));
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009759 rettv->v_type = VAR_NUMBER;
9760 rettv->vval.v_number = -1;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009761}
9762
9763/*
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009764 * "srand()" function
9765 */
9766 static void
9767f_srand(typval_T *argvars, typval_T *rettv)
9768{
9769 UINT32_T x = 0, z;
9770
9771 if (rettv_list_alloc(rettv) == FAIL)
9772 return;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009773
9774 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
9775 return;
9776
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009777 if (argvars[0].v_type == VAR_UNKNOWN)
9778 {
9779 init_srand(&x);
9780 }
9781 else
9782 {
9783 int error = FALSE;
9784
9785 x = (UINT32_T)tv_get_number_chk(&argvars[0], &error);
9786 if (error)
9787 return;
9788 }
9789
9790 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
9791 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
9792 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
9793 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
9794}
9795
9796#undef ROTL
9797#undef SPLITMIX32
9798#undef SHUFFLE_XOSHIRO128STARSTAR
9799
9800/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009801 * "range()" function
9802 */
9803 static void
9804f_range(typval_T *argvars, typval_T *rettv)
9805{
9806 varnumber_T start;
9807 varnumber_T end;
9808 varnumber_T stride = 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009809 int error = FALSE;
9810
Bram Moolenaar93a10962022-06-16 11:42:09 +01009811 if (rettv_list_alloc(rettv) == FAIL)
Yegappan Lakshmananca195cc2022-06-14 13:42:26 +01009812 return;
9813
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009814 if (in_vim9script()
9815 && (check_for_number_arg(argvars, 0) == FAIL
9816 || check_for_opt_number_arg(argvars, 1) == FAIL
9817 || (argvars[1].v_type != VAR_UNKNOWN
9818 && check_for_opt_number_arg(argvars, 2) == FAIL)))
9819 return;
9820
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009821 start = tv_get_number_chk(&argvars[0], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009822 if (argvars[1].v_type == VAR_UNKNOWN)
9823 {
9824 end = start - 1;
9825 start = 0;
9826 }
9827 else
9828 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009829 end = tv_get_number_chk(&argvars[1], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009830 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009831 stride = tv_get_number_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009832 }
9833
9834 if (error)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009835 return; // type error; errmsg already given
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009836 if (stride == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009837 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00009838 emsg(_(e_stride_is_zero));
9839 return;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01009840 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00009841 if (stride > 0 ? end + 1 < start : end - 1 > start)
9842 {
9843 emsg(_(e_start_past_end));
9844 return;
9845 }
9846
9847 list_T *list = rettv->vval.v_list;
9848
9849 // Create a non-materialized list. This is much more efficient and
9850 // works with ":for". If used otherwise CHECK_LIST_MATERIALIZE() must
9851 // be called.
9852 list->lv_first = &range_list_item;
9853 list->lv_u.nonmat.lv_start = start;
9854 list->lv_u.nonmat.lv_end = end;
9855 list->lv_u.nonmat.lv_stride = stride;
Christian Brabandtdf63da92023-11-23 20:14:28 +01009856 if (stride > 0 ? end < start : end > start)
9857 list->lv_len = 0;
9858 else
9859 list->lv_len = (end - start) / stride + 1;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01009860}
9861
9862/*
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02009863 * Materialize "list".
9864 * Do not call directly, use CHECK_LIST_MATERIALIZE()
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01009865 */
9866 void
9867range_list_materialize(list_T *list)
9868{
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02009869 varnumber_T start = list->lv_u.nonmat.lv_start;
9870 varnumber_T end = list->lv_u.nonmat.lv_end;
Bram Moolenaar70c43d82022-01-26 21:01:15 +00009871 int stride = list->lv_u.nonmat.lv_stride;
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02009872 varnumber_T i;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01009873
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02009874 list->lv_first = NULL;
9875 list->lv_u.mat.lv_last = NULL;
9876 list->lv_len = 0;
9877 list->lv_u.mat.lv_idx_item = NULL;
9878 for (i = start; stride > 0 ? i <= end : i >= end; i += stride)
Bram Moolenaar70c43d82022-01-26 21:01:15 +00009879 {
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +00009880 if (list_append_number(list, i) == FAIL)
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02009881 break;
Bram Moolenaar70c43d82022-01-26 21:01:15 +00009882 if (list->lv_lock & VAR_ITEMS_LOCKED)
9883 list->lv_u.mat.lv_last->li_tv.v_lock = VAR_LOCKED;
9884 }
9885 list->lv_lock &= ~VAR_ITEMS_LOCKED;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009886}
9887
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009888/*
9889 * "getreginfo()" function
9890 */
9891 static void
9892f_getreginfo(typval_T *argvars, typval_T *rettv)
9893{
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009894 int regname;
9895 char_u buf[NUMBUFLEN + 2];
9896 long reglen = 0;
9897 dict_T *dict;
9898 list_T *list;
9899
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009900 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
9901 return;
9902
zeertzjqd3f00f52021-12-24 12:02:43 +00009903 regname = getreg_get_regname(argvars);
9904 if (regname == 0)
9905 return;
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009906
zeertzjqd3f00f52021-12-24 12:02:43 +00009907 if (regname == '@')
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009908 regname = '"';
9909
9910 if (rettv_dict_alloc(rettv) == FAIL)
9911 return;
9912 dict = rettv->vval.v_dict;
9913
9914 list = (list_T *)get_reg_contents(regname, GREG_EXPR_SRC | GREG_LIST);
9915 if (list == NULL)
9916 return;
Bram Moolenaar91639192020-06-29 19:55:58 +02009917 (void)dict_add_list(dict, "regcontents", list);
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009918
9919 buf[0] = NUL;
9920 buf[1] = NUL;
9921 switch (get_reg_type(regname, &reglen))
9922 {
9923 case MLINE: buf[0] = 'V'; break;
9924 case MCHAR: buf[0] = 'v'; break;
9925 case MBLOCK:
9926 vim_snprintf((char *)buf, sizeof(buf), "%c%ld", Ctrl_V,
9927 reglen + 1);
9928 break;
9929 }
Bram Moolenaar91639192020-06-29 19:55:58 +02009930 (void)dict_add_string(dict, (char *)"regtype", buf);
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009931
9932 buf[0] = get_register_name(get_unname_register());
9933 buf[1] = NUL;
9934 if (regname == '"')
Bram Moolenaar91639192020-06-29 19:55:58 +02009935 (void)dict_add_string(dict, (char *)"points_to", buf);
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009936 else
9937 {
9938 dictitem_T *item = dictitem_alloc((char_u *)"isunnamed");
9939
9940 if (item != NULL)
9941 {
Bram Moolenaar82946e12022-11-24 11:31:29 +00009942 item->di_tv.v_type = VAR_BOOL;
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009943 item->di_tv.vval.v_number = regname == buf[0]
Bram Moolenaar418a29f2021-02-10 22:23:41 +01009944 ? VVAL_TRUE : VVAL_FALSE;
Bram Moolenaar91639192020-06-29 19:55:58 +02009945 (void)dict_add(dict, item);
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009946 }
9947 }
9948}
9949
Bram Moolenaar0b6d9112018-05-22 20:35:17 +02009950 static void
9951return_register(int regname, typval_T *rettv)
9952{
9953 char_u buf[2] = {0, 0};
9954
9955 buf[0] = (char_u)regname;
9956 rettv->v_type = VAR_STRING;
9957 rettv->vval.v_string = vim_strsave(buf);
9958}
9959
9960/*
9961 * "reg_executing()" function
9962 */
9963 static void
9964f_reg_executing(typval_T *argvars UNUSED, typval_T *rettv)
9965{
9966 return_register(reg_executing, rettv);
9967}
9968
9969/*
9970 * "reg_recording()" function
9971 */
9972 static void
9973f_reg_recording(typval_T *argvars UNUSED, typval_T *rettv)
9974{
9975 return_register(reg_recording, rettv);
9976}
9977
Bram Moolenaar7416f3e2017-03-18 18:10:13 +01009978/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009979 * "rename({from}, {to})" function
9980 */
9981 static void
9982f_rename(typval_T *argvars, typval_T *rettv)
9983{
9984 char_u buf[NUMBUFLEN];
9985
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009986 rettv->vval.v_number = -1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009987 if (check_restricted() || check_secure())
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009988 return;
9989
9990 if (in_vim9script()
9991 && (check_for_string_arg(argvars, 0) == FAIL
9992 || check_for_string_arg(argvars, 1) == FAIL))
9993 return;
9994
9995 rettv->vval.v_number = vim_rename(tv_get_string(&argvars[0]),
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009996 tv_get_string_buf(&argvars[1], buf));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009997}
9998
9999/*
10000 * "repeat()" function
10001 */
10002 static void
10003f_repeat(typval_T *argvars, typval_T *rettv)
10004{
10005 char_u *p;
Bakudankun375141e2022-09-09 18:46:47 +010010006 varnumber_T n;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010007 int slen;
10008 int len;
10009 char_u *r;
10010 int i;
10011
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +020010012 if (in_vim9script()
Bakudankun375141e2022-09-09 18:46:47 +010010013 && (check_for_string_or_number_or_list_or_blob_arg(argvars, 0)
10014 == FAIL
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010015 || check_for_number_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +020010016 return;
10017
Bakudankun375141e2022-09-09 18:46:47 +010010018 n = tv_get_number(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010019 if (argvars[0].v_type == VAR_LIST)
10020 {
10021 if (rettv_list_alloc(rettv) == OK && argvars[0].vval.v_list != NULL)
10022 while (n-- > 0)
10023 if (list_extend(rettv->vval.v_list,
10024 argvars[0].vval.v_list, NULL) == FAIL)
10025 break;
10026 }
Bakudankun375141e2022-09-09 18:46:47 +010010027 else if (argvars[0].v_type == VAR_BLOB)
10028 {
10029 if (rettv_blob_alloc(rettv) == FAIL
10030 || argvars[0].vval.v_blob == NULL
10031 || n <= 0)
10032 return;
10033
10034 slen = argvars[0].vval.v_blob->bv_ga.ga_len;
10035 len = (int)slen * n;
10036 if (len <= 0)
10037 return;
10038
10039 if (ga_grow(&rettv->vval.v_blob->bv_ga, len) == FAIL)
10040 return;
10041
10042 rettv->vval.v_blob->bv_ga.ga_len = len;
10043
10044 for (i = 0; i < slen; ++i)
10045 if (blob_get(argvars[0].vval.v_blob, i) != 0)
10046 break;
10047
10048 if (i == slen)
10049 // No need to copy since all bytes are already zero
10050 return;
10051
10052 for (i = 0; i < n; ++i)
10053 blob_set_range(rettv->vval.v_blob,
10054 (long)i * slen, ((long)i + 1) * slen - 1, argvars);
10055 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010056 else
10057 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010058 p = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010059 rettv->v_type = VAR_STRING;
10060 rettv->vval.v_string = NULL;
10061
10062 slen = (int)STRLEN(p);
10063 len = slen * n;
10064 if (len <= 0)
10065 return;
10066
10067 r = alloc(len + 1);
10068 if (r != NULL)
10069 {
10070 for (i = 0; i < n; i++)
10071 mch_memmove(r + i * slen, p, (size_t)slen);
10072 r[len] = NUL;
10073 }
10074
10075 rettv->vval.v_string = r;
10076 }
10077}
10078
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010079#define SP_NOMOVE 0x01 // don't move cursor
10080#define SP_REPEAT 0x02 // repeat to find outer pair
10081#define SP_RETCOUNT 0x04 // return matchcount
10082#define SP_SETPCMARK 0x08 // set previous context mark
10083#define SP_START 0x10 // accept match at start position
10084#define SP_SUBPAT 0x20 // return nr of matching sub-pattern
10085#define SP_END 0x40 // leave cursor at end of match
10086#define SP_COLUMN 0x80 // start at cursor column
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010087
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010088/*
10089 * Get flags for a search function.
10090 * Possibly sets "p_ws".
10091 * Returns BACKWARD, FORWARD or zero (for an error).
10092 */
10093 static int
10094get_search_arg(typval_T *varp, int *flagsp)
10095{
10096 int dir = FORWARD;
10097 char_u *flags;
10098 char_u nbuf[NUMBUFLEN];
10099 int mask;
10100
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010101 if (varp->v_type == VAR_UNKNOWN)
10102 return FORWARD;
10103
10104 flags = tv_get_string_buf_chk(varp, nbuf);
10105 if (flags == NULL)
10106 return 0; // type error; errmsg already given
10107 while (*flags != NUL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010108 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010109 switch (*flags)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010110 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010111 case 'b': dir = BACKWARD; break;
10112 case 'w': p_ws = TRUE; break;
10113 case 'W': p_ws = FALSE; break;
10114 default: mask = 0;
10115 if (flagsp != NULL)
10116 switch (*flags)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010117 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010118 case 'c': mask = SP_START; break;
10119 case 'e': mask = SP_END; break;
10120 case 'm': mask = SP_RETCOUNT; break;
10121 case 'n': mask = SP_NOMOVE; break;
10122 case 'p': mask = SP_SUBPAT; break;
10123 case 'r': mask = SP_REPEAT; break;
10124 case 's': mask = SP_SETPCMARK; break;
10125 case 'z': mask = SP_COLUMN; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010126 }
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010127 if (mask == 0)
10128 {
10129 semsg(_(e_invalid_argument_str), flags);
10130 dir = 0;
10131 }
10132 else
10133 *flagsp |= mask;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010134 }
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010135 if (dir == 0)
10136 break;
10137 ++flags;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010138 }
10139 return dir;
10140}
10141
10142/*
10143 * Shared by search() and searchpos() functions.
10144 */
10145 static int
10146search_cmn(typval_T *argvars, pos_T *match_pos, int *flagsp)
10147{
10148 int flags;
10149 char_u *pat;
John Marriott8c85a2a2024-05-20 19:18:26 +020010150 size_t patlen;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010151 pos_T pos;
10152 pos_T save_cursor;
10153 int save_p_ws = p_ws;
10154 int dir;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010155 int retval = 0; // default: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010156 long lnum_stop = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010157#ifdef FEAT_RELTIME
10158 long time_limit = 0;
10159#endif
10160 int options = SEARCH_KEEP;
10161 int subpatnum;
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010162 searchit_arg_T sia;
Bram Moolenaara9c01042020-06-07 14:50:50 +020010163 int use_skip = FALSE;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010164 pos_T firstpos;
10165
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +020010166 if (in_vim9script()
10167 && (check_for_string_arg(argvars, 0) == FAIL
10168 || check_for_opt_string_arg(argvars, 1) == FAIL
10169 || (argvars[1].v_type != VAR_UNKNOWN
10170 && (check_for_opt_number_arg(argvars, 2) == FAIL
10171 || (argvars[2].v_type != VAR_UNKNOWN
10172 && check_for_opt_number_arg(argvars, 3) == FAIL)))))
10173 goto theend;
10174
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010175 pat = tv_get_string(&argvars[0]);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010176 dir = get_search_arg(&argvars[1], flagsp); // may set p_ws
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010177 if (dir == 0)
10178 goto theend;
10179 flags = *flagsp;
10180 if (flags & SP_START)
10181 options |= SEARCH_START;
10182 if (flags & SP_END)
10183 options |= SEARCH_END;
10184 if (flags & SP_COLUMN)
10185 options |= SEARCH_COL;
10186
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010187 // Optional arguments: line number to stop searching, timeout and skip.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010188 if (argvars[1].v_type != VAR_UNKNOWN && argvars[2].v_type != VAR_UNKNOWN)
10189 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010190 lnum_stop = (long)tv_get_number_chk(&argvars[2], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010191 if (lnum_stop < 0)
10192 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010193 if (argvars[3].v_type != VAR_UNKNOWN)
10194 {
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010195#ifdef FEAT_RELTIME
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010196 time_limit = (long)tv_get_number_chk(&argvars[3], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010197 if (time_limit < 0)
10198 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010199#endif
Bram Moolenaara9c01042020-06-07 14:50:50 +020010200 use_skip = eval_expr_valid_arg(&argvars[4]);
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010201 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010202 }
10203
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010204 /*
10205 * This function does not accept SP_REPEAT and SP_RETCOUNT flags.
10206 * Check to make sure only those flags are set.
10207 * Also, Only the SP_NOMOVE or the SP_SETPCMARK flag can be set. Both
10208 * flags cannot be set. Check for that condition also.
10209 */
10210 if (((flags & (SP_REPEAT | SP_RETCOUNT)) != 0)
10211 || ((flags & SP_NOMOVE) && (flags & SP_SETPCMARK)))
10212 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010213 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[1]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010214 goto theend;
10215 }
10216
10217 pos = save_cursor = curwin->w_cursor;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010218 CLEAR_FIELD(firstpos);
Bram Moolenaara80faa82020-04-12 19:37:17 +020010219 CLEAR_FIELD(sia);
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010220 sia.sa_stop_lnum = (linenr_T)lnum_stop;
10221#ifdef FEAT_RELTIME
Paul Ollis65745772022-06-05 16:55:54 +010010222 sia.sa_tm = time_limit;
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010223#endif
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010224
John Marriott8c85a2a2024-05-20 19:18:26 +020010225 patlen = STRLEN(pat);
10226
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010227 // Repeat until {skip} returns FALSE.
10228 for (;;)
10229 {
John Marriott8c85a2a2024-05-20 19:18:26 +020010230 subpatnum = searchit(curwin, curbuf, &pos, NULL, dir, pat, patlen, 1L,
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010231 options, RE_SEARCH, &sia);
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010232 // finding the first match again means there is no match where {skip}
10233 // evaluates to zero.
10234 if (firstpos.lnum != 0 && EQUAL_POS(pos, firstpos))
10235 subpatnum = FAIL;
10236
Bram Moolenaara9c01042020-06-07 14:50:50 +020010237 if (subpatnum == FAIL || !use_skip)
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010238 // didn't find it or no skip argument
10239 break;
Bram Moolenaar3d79f0a2023-01-22 20:14:26 +000010240 if (firstpos.lnum == 0)
10241 firstpos = pos;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010242
Bram Moolenaara9c01042020-06-07 14:50:50 +020010243 // If the skip expression matches, ignore this match.
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010244 {
10245 int do_skip;
10246 int err;
10247 pos_T save_pos = curwin->w_cursor;
10248
10249 curwin->w_cursor = pos;
Bram Moolenaara9c01042020-06-07 14:50:50 +020010250 err = FALSE;
10251 do_skip = eval_expr_to_bool(&argvars[4], &err);
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010252 curwin->w_cursor = save_pos;
10253 if (err)
10254 {
10255 // Evaluating {skip} caused an error, break here.
10256 subpatnum = FAIL;
10257 break;
10258 }
10259 if (!do_skip)
10260 break;
10261 }
zeertzjq180246c2022-06-23 12:04:46 +010010262
10263 // clear the start flag to avoid getting stuck here
10264 options &= ~SEARCH_START;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010265 }
10266
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010267 if (subpatnum != FAIL)
10268 {
10269 if (flags & SP_SUBPAT)
10270 retval = subpatnum;
10271 else
10272 retval = pos.lnum;
10273 if (flags & SP_SETPCMARK)
10274 setpcmark();
10275 curwin->w_cursor = pos;
10276 if (match_pos != NULL)
10277 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010278 // Store the match cursor position
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010279 match_pos->lnum = pos.lnum;
10280 match_pos->col = pos.col + 1;
10281 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010282 // "/$" will put the cursor after the end of the line, may need to
10283 // correct that here
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010284 check_cursor();
10285 }
10286
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010287 // If 'n' flag is used: restore cursor position.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010288 if (flags & SP_NOMOVE)
10289 curwin->w_cursor = save_cursor;
10290 else
10291 curwin->w_set_curswant = TRUE;
10292theend:
10293 p_ws = save_p_ws;
10294
10295 return retval;
10296}
10297
Bram Moolenaare99be0e2019-03-26 22:51:09 +010010298#ifdef FEAT_RUBY
10299/*
10300 * "rubyeval()" function
10301 */
10302 static void
10303f_rubyeval(typval_T *argvars, typval_T *rettv)
10304{
10305 char_u *str;
10306 char_u buf[NUMBUFLEN];
10307
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010308 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
10309 return;
10310
Bram Moolenaare99be0e2019-03-26 22:51:09 +010010311 str = tv_get_string_buf(&argvars[0], buf);
10312 do_rubyeval(str, rettv);
10313}
10314#endif
10315
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010316/*
10317 * "screenattr()" function
10318 */
10319 static void
10320f_screenattr(typval_T *argvars, typval_T *rettv)
10321{
10322 int row;
10323 int col;
10324 int c;
10325
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010326 if (in_vim9script()
10327 && (check_for_number_arg(argvars, 0) == FAIL
10328 || check_for_number_arg(argvars, 1) == FAIL))
10329 return;
10330
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010331 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10332 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010333 if (row < 0 || row >= screen_Rows
10334 || col < 0 || col >= screen_Columns)
10335 c = -1;
10336 else
10337 c = ScreenAttrs[LineOffset[row] + col];
10338 rettv->vval.v_number = c;
10339}
10340
10341/*
10342 * "screenchar()" function
10343 */
10344 static void
10345f_screenchar(typval_T *argvars, typval_T *rettv)
10346{
10347 int row;
10348 int col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010349 int c;
10350
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010351 if (in_vim9script()
10352 && (check_for_number_arg(argvars, 0) == FAIL
10353 || check_for_number_arg(argvars, 1) == FAIL))
10354 return;
10355
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010356 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10357 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010358 if (row < 0 || row >= screen_Rows || col < 0 || col >= screen_Columns)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010359 c = -1;
10360 else
10361 {
zeertzjq47eec672023-06-01 20:26:55 +010010362 char_u buf[MB_MAXBYTES + 1];
10363 screen_getbytes(row, col, buf, NULL);
10364 c = (*mb_ptr2char)(buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010365 }
10366 rettv->vval.v_number = c;
10367}
10368
10369/*
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010370 * "screenchars()" function
10371 */
10372 static void
10373f_screenchars(typval_T *argvars, typval_T *rettv)
10374{
10375 int row;
10376 int col;
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010377 int c;
10378 int i;
10379
10380 if (rettv_list_alloc(rettv) == FAIL)
10381 return;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010382
10383 if (in_vim9script()
10384 && (check_for_number_arg(argvars, 0) == FAIL
10385 || check_for_number_arg(argvars, 1) == FAIL))
10386 return;
10387
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010388 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10389 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
10390 if (row < 0 || row >= screen_Rows || col < 0 || col >= screen_Columns)
10391 return;
10392
zeertzjq47eec672023-06-01 20:26:55 +010010393 char_u buf[MB_MAXBYTES + 1];
10394 screen_getbytes(row, col, buf, NULL);
10395 int pcc[MAX_MCO];
10396 if (enc_utf8)
10397 c = utfc_ptr2char(buf, pcc);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010398 else
zeertzjq47eec672023-06-01 20:26:55 +010010399 c = (*mb_ptr2char)(buf);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010400 list_append_number(rettv->vval.v_list, (varnumber_T)c);
10401
10402 if (enc_utf8)
zeertzjq47eec672023-06-01 20:26:55 +010010403 for (i = 0; i < Screen_mco && pcc[i] != 0; ++i)
10404 list_append_number(rettv->vval.v_list, (varnumber_T)pcc[i]);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010405}
10406
10407/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010408 * "screencol()" function
10409 *
10410 * First column is 1 to be consistent with virtcol().
10411 */
10412 static void
10413f_screencol(typval_T *argvars UNUSED, typval_T *rettv)
10414{
10415 rettv->vval.v_number = screen_screencol() + 1;
10416}
10417
10418/*
10419 * "screenrow()" function
10420 */
10421 static void
10422f_screenrow(typval_T *argvars UNUSED, typval_T *rettv)
10423{
10424 rettv->vval.v_number = screen_screenrow() + 1;
10425}
10426
10427/*
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010428 * "screenstring()" function
10429 */
10430 static void
10431f_screenstring(typval_T *argvars, typval_T *rettv)
10432{
10433 int row;
10434 int col;
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010435 char_u buf[MB_MAXBYTES + 1];
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010436
10437 rettv->vval.v_string = NULL;
10438 rettv->v_type = VAR_STRING;
10439
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010440 if (in_vim9script()
10441 && (check_for_number_arg(argvars, 0) == FAIL
10442 || check_for_number_arg(argvars, 1) == FAIL))
10443 return;
10444
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010445 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10446 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
10447 if (row < 0 || row >= screen_Rows || col < 0 || col >= screen_Columns)
10448 return;
10449
zeertzjq47eec672023-06-01 20:26:55 +010010450 screen_getbytes(row, col, buf, NULL);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010451 rettv->vval.v_string = vim_strsave(buf);
10452}
10453
10454/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010455 * "search()" function
10456 */
10457 static void
10458f_search(typval_T *argvars, typval_T *rettv)
10459{
10460 int flags = 0;
10461
10462 rettv->vval.v_number = search_cmn(argvars, NULL, &flags);
10463}
10464
10465/*
10466 * "searchdecl()" function
10467 */
10468 static void
10469f_searchdecl(typval_T *argvars, typval_T *rettv)
10470{
Bram Moolenaar30788d32020-09-05 21:35:16 +020010471 int locally = TRUE;
10472 int thisblock = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010473 int error = FALSE;
10474 char_u *name;
10475
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010476 rettv->vval.v_number = 1; // default: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010477
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020010478 if (in_vim9script()
10479 && (check_for_string_arg(argvars, 0) == FAIL
10480 || check_for_opt_bool_arg(argvars, 1) == FAIL
10481 || (argvars[1].v_type != VAR_UNKNOWN
10482 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
10483 return;
10484
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010485 name = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010486 if (argvars[1].v_type != VAR_UNKNOWN)
10487 {
Bram Moolenaar30788d32020-09-05 21:35:16 +020010488 locally = !(int)tv_get_bool_chk(&argvars[1], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010489 if (!error && argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar30788d32020-09-05 21:35:16 +020010490 thisblock = (int)tv_get_bool_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010491 }
10492 if (!error && name != NULL)
10493 rettv->vval.v_number = find_decl(name, (int)STRLEN(name),
10494 locally, thisblock, SEARCH_KEEP) == FAIL;
10495}
10496
10497/*
10498 * Used by searchpair() and searchpairpos()
10499 */
10500 static int
10501searchpair_cmn(typval_T *argvars, pos_T *match_pos)
10502{
10503 char_u *spat, *mpat, *epat;
Bram Moolenaar48570482017-10-30 21:48:41 +010010504 typval_T *skip;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010505 int save_p_ws = p_ws;
10506 int dir;
10507 int flags = 0;
10508 char_u nbuf1[NUMBUFLEN];
10509 char_u nbuf2[NUMBUFLEN];
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010510 int retval = 0; // default: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010511 long lnum_stop = 0;
10512 long time_limit = 0;
10513
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +020010514 if (in_vim9script()
10515 && (check_for_string_arg(argvars, 0) == FAIL
10516 || check_for_string_arg(argvars, 1) == FAIL
10517 || check_for_string_arg(argvars, 2) == FAIL
10518 || check_for_opt_string_arg(argvars, 3) == FAIL
10519 || (argvars[3].v_type != VAR_UNKNOWN
10520 && argvars[4].v_type != VAR_UNKNOWN
10521 && (check_for_opt_number_arg(argvars, 5) == FAIL
10522 || (argvars[5].v_type != VAR_UNKNOWN
10523 && check_for_opt_number_arg(argvars, 6) == FAIL)))))
10524 goto theend;
10525
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010526 // Get the three pattern arguments: start, middle, end. Will result in an
10527 // error if not a valid argument.
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010528 spat = tv_get_string_chk(&argvars[0]);
10529 mpat = tv_get_string_buf_chk(&argvars[1], nbuf1);
10530 epat = tv_get_string_buf_chk(&argvars[2], nbuf2);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010531 if (spat == NULL || mpat == NULL || epat == NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010532 goto theend; // type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010533
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010534 // Handle the optional fourth argument: flags
10535 dir = get_search_arg(&argvars[3], &flags); // may set p_ws
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010536 if (dir == 0)
10537 goto theend;
10538
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010539 // Don't accept SP_END or SP_SUBPAT.
10540 // Only one of the SP_NOMOVE or SP_SETPCMARK flags can be set.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010541 if ((flags & (SP_END | SP_SUBPAT)) != 0
10542 || ((flags & SP_NOMOVE) && (flags & SP_SETPCMARK)))
10543 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010544 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[3]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010545 goto theend;
10546 }
10547
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010548 // Using 'r' implies 'W', otherwise it doesn't work.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010549 if (flags & SP_REPEAT)
10550 p_ws = FALSE;
10551
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010552 // Optional fifth argument: skip expression
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010553 if (argvars[3].v_type == VAR_UNKNOWN
10554 || argvars[4].v_type == VAR_UNKNOWN)
Bram Moolenaar48570482017-10-30 21:48:41 +010010555 skip = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010556 else
10557 {
Bram Moolenaara9c01042020-06-07 14:50:50 +020010558 // Type is checked later.
Bram Moolenaar48570482017-10-30 21:48:41 +010010559 skip = &argvars[4];
Bram Moolenaara9c01042020-06-07 14:50:50 +020010560
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010561 if (argvars[5].v_type != VAR_UNKNOWN)
10562 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010563 lnum_stop = (long)tv_get_number_chk(&argvars[5], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010564 if (lnum_stop < 0)
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010565 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010566 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[5]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010567 goto theend;
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010568 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010569#ifdef FEAT_RELTIME
10570 if (argvars[6].v_type != VAR_UNKNOWN)
10571 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010572 time_limit = (long)tv_get_number_chk(&argvars[6], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010573 if (time_limit < 0)
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010574 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010575 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[6]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010576 goto theend;
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010577 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010578 }
10579#endif
10580 }
10581 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010582
10583 retval = do_searchpair(spat, mpat, epat, dir, skip, flags,
10584 match_pos, lnum_stop, time_limit);
10585
10586theend:
10587 p_ws = save_p_ws;
10588
10589 return retval;
10590}
10591
10592/*
10593 * "searchpair()" function
10594 */
10595 static void
10596f_searchpair(typval_T *argvars, typval_T *rettv)
10597{
10598 rettv->vval.v_number = searchpair_cmn(argvars, NULL);
10599}
10600
10601/*
10602 * "searchpairpos()" function
10603 */
10604 static void
10605f_searchpairpos(typval_T *argvars, typval_T *rettv)
10606{
10607 pos_T match_pos;
10608 int lnum = 0;
10609 int col = 0;
10610
10611 if (rettv_list_alloc(rettv) == FAIL)
10612 return;
10613
10614 if (searchpair_cmn(argvars, &match_pos) > 0)
10615 {
10616 lnum = match_pos.lnum;
10617 col = match_pos.col;
10618 }
10619
10620 list_append_number(rettv->vval.v_list, (varnumber_T)lnum);
10621 list_append_number(rettv->vval.v_list, (varnumber_T)col);
10622}
10623
10624/*
10625 * Search for a start/middle/end thing.
10626 * Used by searchpair(), see its documentation for the details.
10627 * Returns 0 or -1 for no match,
10628 */
10629 long
10630do_searchpair(
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010631 char_u *spat, // start pattern
10632 char_u *mpat, // middle pattern
10633 char_u *epat, // end pattern
10634 int dir, // BACKWARD or FORWARD
10635 typval_T *skip, // skip expression
10636 int flags, // SP_SETPCMARK and other SP_ values
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010637 pos_T *match_pos,
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010638 linenr_T lnum_stop, // stop at this line if not zero
10639 long time_limit UNUSED) // stop after this many msec
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010640{
10641 char_u *save_cpo;
10642 char_u *pat, *pat2 = NULL, *pat3 = NULL;
John Marriott8c85a2a2024-05-20 19:18:26 +020010643 size_t patlen;
10644 size_t spatlen;
10645 size_t epatlen;
10646 size_t pat2size;
10647 size_t pat2len;
10648 size_t pat3size;
10649 size_t pat3len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010650 long retval = 0;
10651 pos_T pos;
10652 pos_T firstpos;
10653 pos_T foundpos;
10654 pos_T save_cursor;
10655 pos_T save_pos;
10656 int n;
10657 int r;
10658 int nest = 1;
Bram Moolenaar48570482017-10-30 21:48:41 +010010659 int use_skip = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010660 int err;
10661 int options = SEARCH_KEEP;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010662
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010663 // Make 'cpoptions' empty, the 'l' flag should not be used here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010664 save_cpo = p_cpo;
10665 p_cpo = empty_option;
10666
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010667 // Make two search patterns: start/end (pat2, for in nested pairs) and
10668 // start/middle/end (pat3, for the top pair).
John Marriott8c85a2a2024-05-20 19:18:26 +020010669 spatlen = STRLEN(spat);
10670 epatlen = STRLEN(epat);
10671 pat2size = spatlen + epatlen + 17;
10672 pat2 = alloc(pat2size);
10673 if (pat2 == NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010674 goto theend;
John Marriott8c85a2a2024-05-20 19:18:26 +020010675 pat3size = spatlen + STRLEN(mpat) + epatlen + 25;
10676 pat3 = alloc(pat3size);
10677 if (pat3 == NULL)
10678 goto theend;
10679 pat2len = vim_snprintf((char *)pat2, pat2size, "\\m\\(%s\\m\\)\\|\\(%s\\m\\)", spat, epat);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010680 if (*mpat == NUL)
John Marriott8c85a2a2024-05-20 19:18:26 +020010681 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010682 STRCPY(pat3, pat2);
John Marriott8c85a2a2024-05-20 19:18:26 +020010683 pat3len = pat2len;
10684 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010685 else
John Marriott8c85a2a2024-05-20 19:18:26 +020010686 pat3len = vim_snprintf((char *)pat3, pat3size, "\\m\\(%s\\m\\)\\|\\(%s\\m\\)\\|\\(%s\\m\\)",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010687 spat, epat, mpat);
10688 if (flags & SP_START)
10689 options |= SEARCH_START;
10690
Bram Moolenaar48570482017-10-30 21:48:41 +010010691 if (skip != NULL)
Bram Moolenaara9c01042020-06-07 14:50:50 +020010692 use_skip = eval_expr_valid_arg(skip);
Bram Moolenaar48570482017-10-30 21:48:41 +010010693
Bram Moolenaar5ea38d12022-06-16 21:20:48 +010010694#ifdef FEAT_RELTIME
10695 if (time_limit > 0)
10696 init_regexp_timeout(time_limit);
10697#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010698 save_cursor = curwin->w_cursor;
10699 pos = curwin->w_cursor;
Bram Moolenaarb5aedf32017-03-12 18:23:53 +010010700 CLEAR_POS(&firstpos);
10701 CLEAR_POS(&foundpos);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010702 pat = pat3;
John Marriott8c85a2a2024-05-20 19:18:26 +020010703 patlen = pat3len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010704 for (;;)
10705 {
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010706 searchit_arg_T sia;
10707
Bram Moolenaara80faa82020-04-12 19:37:17 +020010708 CLEAR_FIELD(sia);
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010709 sia.sa_stop_lnum = lnum_stop;
John Marriott8c85a2a2024-05-20 19:18:26 +020010710 n = searchit(curwin, curbuf, &pos, NULL, dir, pat, patlen, 1L,
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010711 options, RE_SEARCH, &sia);
Bram Moolenaarb5aedf32017-03-12 18:23:53 +010010712 if (n == FAIL || (firstpos.lnum != 0 && EQUAL_POS(pos, firstpos)))
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010713 // didn't find it or found the first match again: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010714 break;
10715
10716 if (firstpos.lnum == 0)
10717 firstpos = pos;
Bram Moolenaarb5aedf32017-03-12 18:23:53 +010010718 if (EQUAL_POS(pos, foundpos))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010719 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010720 // Found the same position again. Can happen with a pattern that
10721 // has "\zs" at the end and searching backwards. Advance one
10722 // character and try again.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010723 if (dir == BACKWARD)
10724 decl(&pos);
10725 else
10726 incl(&pos);
10727 }
10728 foundpos = pos;
10729
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010730 // clear the start flag to avoid getting stuck here
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010731 options &= ~SEARCH_START;
10732
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010733 // If the skip pattern matches, ignore this match.
Bram Moolenaar48570482017-10-30 21:48:41 +010010734 if (use_skip)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010735 {
10736 save_pos = curwin->w_cursor;
10737 curwin->w_cursor = pos;
Bram Moolenaar48570482017-10-30 21:48:41 +010010738 err = FALSE;
10739 r = eval_expr_to_bool(skip, &err);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010740 curwin->w_cursor = save_pos;
10741 if (err)
10742 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010743 // Evaluating {skip} caused an error, break here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010744 curwin->w_cursor = save_cursor;
10745 retval = -1;
10746 break;
10747 }
10748 if (r)
10749 continue;
10750 }
10751
10752 if ((dir == BACKWARD && n == 3) || (dir == FORWARD && n == 2))
10753 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010754 // Found end when searching backwards or start when searching
10755 // forward: nested pair.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010756 ++nest;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010757 pat = pat2; // nested, don't search for middle
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010758 }
10759 else
10760 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010761 // Found end when searching forward or start when searching
10762 // backward: end of (nested) pair; or found middle in outer pair.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010763 if (--nest == 1)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010764 pat = pat3; // outer level, search for middle
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010765 }
10766
10767 if (nest == 0)
10768 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010769 // Found the match: return matchcount or line number.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010770 if (flags & SP_RETCOUNT)
10771 ++retval;
10772 else
10773 retval = pos.lnum;
10774 if (flags & SP_SETPCMARK)
10775 setpcmark();
10776 curwin->w_cursor = pos;
10777 if (!(flags & SP_REPEAT))
10778 break;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010779 nest = 1; // search for next unmatched
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010780 }
10781 }
10782
10783 if (match_pos != NULL)
10784 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010785 // Store the match cursor position
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010786 match_pos->lnum = curwin->w_cursor.lnum;
10787 match_pos->col = curwin->w_cursor.col + 1;
10788 }
10789
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010790 // If 'n' flag is used or search failed: restore cursor position.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010791 if ((flags & SP_NOMOVE) || retval == 0)
10792 curwin->w_cursor = save_cursor;
10793
10794theend:
Bram Moolenaar5ea38d12022-06-16 21:20:48 +010010795#ifdef FEAT_RELTIME
Bram Moolenaar0f618382022-08-26 21:33:04 +010010796 if (time_limit > 0)
10797 disable_regexp_timeout();
Bram Moolenaar5ea38d12022-06-16 21:20:48 +010010798#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010799 vim_free(pat2);
10800 vim_free(pat3);
10801 if (p_cpo == empty_option)
10802 p_cpo = save_cpo;
10803 else
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010010804 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010805 // Darn, evaluating the {skip} expression changed the value.
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010010806 // If it's still empty it was changed and restored, need to restore in
10807 // the complicated way.
10808 if (*p_cpo == NUL)
Bram Moolenaar31e5c602022-04-15 13:53:33 +010010809 set_option_value_give_err((char_u *)"cpo", 0L, save_cpo, 0);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010810 free_string_option(save_cpo);
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010010811 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010812
10813 return retval;
10814}
10815
10816/*
10817 * "searchpos()" function
10818 */
10819 static void
10820f_searchpos(typval_T *argvars, typval_T *rettv)
10821{
10822 pos_T match_pos;
10823 int lnum = 0;
10824 int col = 0;
10825 int n;
10826 int flags = 0;
10827
10828 if (rettv_list_alloc(rettv) == FAIL)
10829 return;
10830
10831 n = search_cmn(argvars, &match_pos, &flags);
10832 if (n > 0)
10833 {
10834 lnum = match_pos.lnum;
10835 col = match_pos.col;
10836 }
10837
10838 list_append_number(rettv->vval.v_list, (varnumber_T)lnum);
10839 list_append_number(rettv->vval.v_list, (varnumber_T)col);
10840 if (flags & SP_SUBPAT)
10841 list_append_number(rettv->vval.v_list, (varnumber_T)n);
10842}
10843
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010844/*
10845 * Set the cursor or mark position.
zeertzjq47eec672023-06-01 20:26:55 +010010846 * If "charpos" is TRUE, then use the column number as a character offset.
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010847 * Otherwise use the column number as a byte offset.
10848 */
10849 static void
10850set_position(typval_T *argvars, typval_T *rettv, int charpos)
10851{
10852 pos_T pos;
10853 int fnum;
10854 char_u *name;
10855 colnr_T curswant = -1;
10856
10857 rettv->vval.v_number = -1;
10858
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020010859 if (in_vim9script()
10860 && (check_for_string_arg(argvars, 0) == FAIL
10861 || check_for_list_arg(argvars, 1) == FAIL))
10862 return;
10863
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010864 name = tv_get_string_chk(argvars);
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010865 if (name == NULL)
10866 return;
10867
10868 if (list2fpos(&argvars[1], &pos, &fnum, &curswant, charpos) != OK)
10869 return;
10870
10871 if (pos.col != MAXCOL && --pos.col < 0)
10872 pos.col = 0;
10873 if ((name[0] == '.' && name[1] == NUL))
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010874 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010875 // set cursor; "fnum" is ignored
10876 curwin->w_cursor = pos;
10877 if (curswant >= 0)
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010878 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010879 curwin->w_curswant = curswant - 1;
10880 curwin->w_set_curswant = FALSE;
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010881 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010882 check_cursor();
10883 rettv->vval.v_number = 0;
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010884 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010885 else if (name[0] == '\'' && name[1] != NUL && name[2] == NUL)
10886 {
10887 // set mark
10888 if (setmark_pos(name[1], &pos, fnum) == OK)
10889 rettv->vval.v_number = 0;
10890 }
10891 else
10892 emsg(_(e_invalid_argument));
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010893}
10894/*
10895 * "setcharpos()" function
10896 */
10897 static void
10898f_setcharpos(typval_T *argvars, typval_T *rettv)
10899{
10900 set_position(argvars, rettv, TRUE);
10901}
10902
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010903 static void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010904f_setcharsearch(typval_T *argvars, typval_T *rettv UNUSED)
10905{
10906 dict_T *d;
10907 dictitem_T *di;
10908 char_u *csearch;
10909
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +010010910 if (check_for_dict_arg(argvars, 0) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010911 return;
10912
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010913 if ((d = argvars[0].vval.v_dict) == NULL)
10914 return;
10915
10916 csearch = dict_get_string(d, "char", FALSE);
10917 if (csearch != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010918 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010919 if (enc_utf8)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010920 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010921 int pcc[MAX_MCO];
10922 int c = utfc_ptr2char(csearch, pcc);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010923
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010924 set_last_csearch(c, csearch, utfc_ptr2len(csearch));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010925 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010926 else
10927 set_last_csearch(PTR2CHAR(csearch),
10928 csearch, mb_ptr2len(csearch));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010929 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010930
10931 di = dict_find(d, (char_u *)"forward", -1);
10932 if (di != NULL)
10933 set_csearch_direction((int)tv_get_number(&di->di_tv)
10934 ? FORWARD : BACKWARD);
10935
10936 di = dict_find(d, (char_u *)"until", -1);
10937 if (di != NULL)
10938 set_csearch_until(!!tv_get_number(&di->di_tv));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010939}
10940
10941/*
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010942 * "setcursorcharpos" function
10943 */
10944 static void
Bram Moolenaar3af15ab2021-01-17 16:16:23 +010010945f_setcursorcharpos(typval_T *argvars, typval_T *rettv)
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010946{
10947 set_cursorpos(argvars, rettv, TRUE);
10948}
10949
10950/*
Bram Moolenaar691ddee2019-05-09 14:52:41 +020010951 * "setenv()" function
10952 */
10953 static void
10954f_setenv(typval_T *argvars, typval_T *rettv UNUSED)
10955{
10956 char_u namebuf[NUMBUFLEN];
10957 char_u valbuf[NUMBUFLEN];
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020010958 char_u *name;
Bram Moolenaar691ddee2019-05-09 14:52:41 +020010959
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020010960 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
10961 return;
10962
zeertzjqfcaeb3d2023-11-28 20:46:29 +010010963 // setting an environment variable may be dangerous, e.g. you could
Christian Brabandt6b89dd62023-10-26 22:14:17 +020010964 // setenv GCONV_PATH=/tmp and then have iconv() unexpectedly call
10965 // a shell command using some shared library:
10966 if (check_restricted() || check_secure())
10967 return;
10968
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020010969 name = tv_get_string_buf(&argvars[0], namebuf);
Bram Moolenaar691ddee2019-05-09 14:52:41 +020010970 if (argvars[1].v_type == VAR_SPECIAL
10971 && argvars[1].vval.v_number == VVAL_NULL)
LemonBoy77142312022-04-15 20:50:46 +010010972 vim_unsetenv_ext(name);
Bram Moolenaar691ddee2019-05-09 14:52:41 +020010973 else
LemonBoy77142312022-04-15 20:50:46 +010010974 vim_setenv_ext(name, tv_get_string_buf(&argvars[1], valbuf));
Bram Moolenaar691ddee2019-05-09 14:52:41 +020010975}
10976
10977/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010978 * "setfperm({fname}, {mode})" function
10979 */
10980 static void
10981f_setfperm(typval_T *argvars, typval_T *rettv)
10982{
10983 char_u *fname;
10984 char_u modebuf[NUMBUFLEN];
10985 char_u *mode_str;
10986 int i;
10987 int mask;
10988 int mode = 0;
10989
10990 rettv->vval.v_number = 0;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010991
10992 if (in_vim9script()
10993 && (check_for_string_arg(argvars, 0) == FAIL
10994 || check_for_string_arg(argvars, 1) == FAIL))
10995 return;
10996
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010997 fname = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010998 if (fname == NULL)
10999 return;
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011000 mode_str = tv_get_string_buf_chk(&argvars[1], modebuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011001 if (mode_str == NULL)
11002 return;
11003 if (STRLEN(mode_str) != 9)
11004 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000011005 semsg(_(e_invalid_argument_str), mode_str);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011006 return;
11007 }
11008
11009 mask = 1;
11010 for (i = 8; i >= 0; --i)
11011 {
11012 if (mode_str[i] != '-')
11013 mode |= mask;
11014 mask = mask << 1;
11015 }
11016 rettv->vval.v_number = mch_setperm(fname, mode) == OK;
11017}
11018
11019/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011020 * "setpos()" function
11021 */
11022 static void
11023f_setpos(typval_T *argvars, typval_T *rettv)
11024{
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011025 set_position(argvars, rettv, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011026}
11027
11028/*
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011029 * Translate a register type string to the yank type and block length
11030 */
11031 static int
11032get_yank_type(char_u **pp, char_u *yank_type, long *block_len)
11033{
11034 char_u *stropt = *pp;
11035 switch (*stropt)
11036 {
11037 case 'v': case 'c': // character-wise selection
11038 *yank_type = MCHAR;
11039 break;
11040 case 'V': case 'l': // line-wise selection
11041 *yank_type = MLINE;
11042 break;
11043 case 'b': case Ctrl_V: // block-wise selection
11044 *yank_type = MBLOCK;
11045 if (VIM_ISDIGIT(stropt[1]))
11046 {
11047 ++stropt;
11048 *block_len = getdigits(&stropt) - 1;
11049 --stropt;
11050 }
11051 break;
11052 default:
11053 return FAIL;
11054 }
11055 *pp = stropt;
11056 return OK;
11057}
11058
11059/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011060 * "setreg()" function
11061 */
11062 static void
11063f_setreg(typval_T *argvars, typval_T *rettv)
11064{
11065 int regname;
11066 char_u *strregname;
11067 char_u *stropt;
11068 char_u *strval;
11069 int append;
11070 char_u yank_type;
11071 long block_len;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011072 typval_T *regcontents;
11073 int pointreg;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011074
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020011075 if (in_vim9script()
11076 && (check_for_string_arg(argvars, 0) == FAIL
11077 || check_for_opt_string_arg(argvars, 2) == FAIL))
11078 return;
11079
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011080 pointreg = 0;
11081 regcontents = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011082 block_len = -1;
11083 yank_type = MAUTO;
11084 append = FALSE;
11085
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011086 strregname = tv_get_string_chk(argvars);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011087 rettv->vval.v_number = 1; // FAIL is default
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011088
11089 if (strregname == NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011090 return; // type error; errmsg already given
Bram Moolenaar418a29f2021-02-10 22:23:41 +010011091 if (in_vim9script() && STRLEN(strregname) > 1)
11092 {
11093 semsg(_(e_register_name_must_be_one_char_str), strregname);
11094 return;
11095 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011096 regname = *strregname;
11097 if (regname == 0 || regname == '@')
11098 regname = '"';
11099
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011100 if (argvars[1].v_type == VAR_DICT)
11101 {
11102 dict_T *d = argvars[1].vval.v_dict;
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011103 dictitem_T *di;
11104
11105 if (d == NULL || d->dv_hashtab.ht_used == 0)
11106 {
11107 // Empty dict, clear the register (like setreg(0, []))
11108 char_u *lstval[2] = {NULL, NULL};
11109 write_reg_contents_lst(regname, lstval, 0, FALSE, MAUTO, -1);
11110 return;
11111 }
11112
11113 di = dict_find(d, (char_u *)"regcontents", -1);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011114 if (di != NULL)
11115 regcontents = &di->di_tv;
11116
Bram Moolenaard61efa52022-07-23 09:52:04 +010011117 stropt = dict_get_string(d, "regtype", FALSE);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011118 if (stropt != NULL)
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011119 {
11120 int ret = get_yank_type(&stropt, &yank_type, &block_len);
11121
11122 if (ret == FAIL || *++stropt != NUL)
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011123 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000011124 semsg(_(e_invalid_value_for_argument_str), "value");
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011125 return;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011126 }
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011127 }
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011128
11129 if (regname == '"')
11130 {
Bram Moolenaard61efa52022-07-23 09:52:04 +010011131 stropt = dict_get_string(d, "points_to", FALSE);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011132 if (stropt != NULL)
11133 {
11134 pointreg = *stropt;
11135 regname = pointreg;
11136 }
11137 }
Bram Moolenaard61efa52022-07-23 09:52:04 +010011138 else if (dict_get_bool(d, "isunnamed", -1) > 0)
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011139 pointreg = regname;
11140 }
11141 else
11142 regcontents = &argvars[1];
11143
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011144 if (argvars[2].v_type != VAR_UNKNOWN)
11145 {
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011146 if (yank_type != MAUTO)
11147 {
Bram Moolenaare1242042021-12-16 20:56:57 +000011148 semsg(_(e_too_many_arguments_for_function_str), "setreg");
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011149 return;
11150 }
11151
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011152 stropt = tv_get_string_chk(&argvars[2]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011153 if (stropt == NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011154 return; // type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011155 for (; *stropt != NUL; ++stropt)
11156 switch (*stropt)
11157 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011158 case 'a': case 'A': // append
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011159 append = TRUE;
11160 break;
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011161 default:
11162 get_yank_type(&stropt, &yank_type, &block_len);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011163 }
11164 }
11165
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011166 if (regcontents && regcontents->v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011167 {
11168 char_u **lstval;
11169 char_u **allocval;
11170 char_u buf[NUMBUFLEN];
11171 char_u **curval;
11172 char_u **curallocval;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011173 list_T *ll = regcontents->vval.v_list;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011174 listitem_T *li;
11175 int len;
11176
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011177 // If the list is NULL handle like an empty list.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011178 len = ll == NULL ? 0 : ll->lv_len;
11179
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011180 // First half: use for pointers to result lines; second half: use for
11181 // pointers to allocated copies.
Bram Moolenaarc799fe22019-05-28 23:08:19 +020011182 lstval = ALLOC_MULT(char_u *, (len + 1) * 2);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011183 if (lstval == NULL)
11184 return;
11185 curval = lstval;
11186 allocval = lstval + len + 2;
11187 curallocval = allocval;
11188
Bram Moolenaar50985eb2020-01-27 22:09:39 +010011189 if (ll != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011190 {
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020011191 CHECK_LIST_MATERIALIZE(ll);
Bram Moolenaar00d253e2020-04-06 22:13:01 +020011192 FOR_ALL_LIST_ITEMS(ll, li)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011193 {
Bram Moolenaar50985eb2020-01-27 22:09:39 +010011194 strval = tv_get_string_buf_chk(&li->li_tv, buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011195 if (strval == NULL)
11196 goto free_lstval;
Bram Moolenaar50985eb2020-01-27 22:09:39 +010011197 if (strval == buf)
11198 {
11199 // Need to make a copy, next tv_get_string_buf_chk() will
11200 // overwrite the string.
11201 strval = vim_strsave(buf);
11202 if (strval == NULL)
11203 goto free_lstval;
11204 *curallocval++ = strval;
11205 }
11206 *curval++ = strval;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011207 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011208 }
11209 *curval++ = NULL;
11210
11211 write_reg_contents_lst(regname, lstval, -1,
11212 append, yank_type, block_len);
11213free_lstval:
11214 while (curallocval > allocval)
11215 vim_free(*--curallocval);
11216 vim_free(lstval);
11217 }
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011218 else if (regcontents)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011219 {
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011220 strval = tv_get_string_chk(regcontents);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011221 if (strval == NULL)
11222 return;
11223 write_reg_contents_ex(regname, strval, -1,
11224 append, yank_type, block_len);
11225 }
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011226 if (pointreg != 0)
11227 get_yank_register(pointreg, TRUE);
11228
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011229 rettv->vval.v_number = 0;
11230}
11231
11232/*
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011233 * "settagstack()" function
11234 */
11235 static void
11236f_settagstack(typval_T *argvars, typval_T *rettv)
11237{
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011238 win_T *wp;
11239 dict_T *d;
11240 int action = 'r';
11241
11242 rettv->vval.v_number = -1;
11243
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011244 if (in_vim9script()
11245 && (check_for_number_arg(argvars, 0) == FAIL
11246 || check_for_dict_arg(argvars, 1) == FAIL
11247 || check_for_opt_string_arg(argvars, 2) == FAIL))
11248 return;
11249
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011250 // first argument: window number or id
11251 wp = find_win_by_nr_or_id(&argvars[0]);
11252 if (wp == NULL)
11253 return;
11254
11255 // second argument: dict with items to set in the tag stack
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +010011256 if (check_for_dict_arg(argvars, 1) == FAIL)
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011257 return;
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011258 d = argvars[1].vval.v_dict;
11259 if (d == NULL)
11260 return;
11261
11262 // third argument: action - 'a' for append and 'r' for replace.
11263 // default is to replace the stack.
11264 if (argvars[2].v_type == VAR_UNKNOWN)
11265 action = 'r';
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +010011266 else if (check_for_string_arg(argvars, 2) == FAIL)
11267 return;
11268 else
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011269 {
11270 char_u *actstr;
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011271 actstr = tv_get_string_chk(&argvars[2]);
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011272 if (actstr == NULL)
11273 return;
Bram Moolenaar271fa082020-01-02 14:02:16 +010011274 if ((*actstr == 'r' || *actstr == 'a' || *actstr == 't')
11275 && actstr[1] == NUL)
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011276 action = *actstr;
11277 else
11278 {
Bram Moolenaard82a47d2022-01-05 20:24:39 +000011279 semsg(_(e_invalid_action_str_2), actstr);
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011280 return;
11281 }
11282 }
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011283
11284 if (set_tagstack(wp, d, action) == OK)
11285 rettv->vval.v_number = 0;
11286}
11287
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011288#ifdef FEAT_CRYPT
11289/*
11290 * "sha256({string})" function
11291 */
11292 static void
11293f_sha256(typval_T *argvars, typval_T *rettv)
11294{
11295 char_u *p;
11296
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011297 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11298 return;
11299
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011300 p = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011301 rettv->vval.v_string = vim_strsave(
11302 sha256_bytes(p, (int)STRLEN(p), NULL, 0));
11303 rettv->v_type = VAR_STRING;
11304}
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011305#endif // FEAT_CRYPT
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011306
11307/*
11308 * "shellescape({string})" function
11309 */
11310 static void
11311f_shellescape(typval_T *argvars, typval_T *rettv)
11312{
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011313 int do_special;
Bram Moolenaar20615522017-06-05 18:46:26 +020011314
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011315 if (in_vim9script()
11316 && (check_for_string_arg(argvars, 0) == FAIL
11317 || check_for_opt_bool_arg(argvars, 1) == FAIL))
11318 return;
11319
11320 do_special = non_zero_arg(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011321 rettv->vval.v_string = vim_strsave_shellescape(
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011322 tv_get_string(&argvars[0]), do_special, do_special);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011323 rettv->v_type = VAR_STRING;
11324}
11325
11326/*
11327 * shiftwidth() function
11328 */
11329 static void
11330f_shiftwidth(typval_T *argvars UNUSED, typval_T *rettv)
11331{
Bram Moolenaarf9514162018-11-22 03:08:29 +010011332 rettv->vval.v_number = 0;
11333
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011334 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
11335 return;
11336
Bram Moolenaarf9514162018-11-22 03:08:29 +010011337 if (argvars[0].v_type != VAR_UNKNOWN)
11338 {
11339 long col;
11340
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011341 col = (long)tv_get_number_chk(argvars, NULL);
Bram Moolenaarf9514162018-11-22 03:08:29 +010011342 if (col < 0)
11343 return; // type error; errmsg already given
11344#ifdef FEAT_VARTABS
Gary Johnson88d4f252024-06-01 20:51:33 +020011345 rettv->vval.v_number = get_sw_value_col(curbuf, col, FALSE);
Bram Moolenaarf9514162018-11-22 03:08:29 +010011346 return;
11347#endif
11348 }
11349
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011350 rettv->vval.v_number = get_sw_value(curbuf);
11351}
11352
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011353/*
11354 * "soundfold({word})" function
11355 */
11356 static void
11357f_soundfold(typval_T *argvars, typval_T *rettv)
11358{
11359 char_u *s;
11360
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011361 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11362 return;
11363
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011364 rettv->v_type = VAR_STRING;
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011365 s = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011366#ifdef FEAT_SPELL
11367 rettv->vval.v_string = eval_soundfold(s);
11368#else
11369 rettv->vval.v_string = vim_strsave(s);
11370#endif
11371}
11372
11373/*
11374 * "spellbadword()" function
11375 */
11376 static void
11377f_spellbadword(typval_T *argvars UNUSED, typval_T *rettv)
11378{
11379 char_u *word = (char_u *)"";
11380 hlf_T attr = HLF_COUNT;
11381 int len = 0;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011382#ifdef FEAT_SPELL
11383 int wo_spell_save = curwin->w_p_spell;
11384
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011385 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
11386 return;
11387
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011388 if (!curwin->w_p_spell)
11389 {
Yegappan Lakshmananaf936912023-02-20 12:16:39 +000011390 parse_spelllang(curwin);
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011391 curwin->w_p_spell = TRUE;
11392 }
11393
11394 if (*curwin->w_s->b_p_spl == NUL)
11395 {
Bram Moolenaar460ae5d2022-01-01 14:19:49 +000011396 emsg(_(e_spell_checking_is_not_possible));
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011397 curwin->w_p_spell = wo_spell_save;
11398 return;
11399 }
11400#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011401
11402 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011403 {
11404#ifdef FEAT_SPELL
11405 curwin->w_p_spell = wo_spell_save;
11406#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011407 return;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011408 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011409
11410#ifdef FEAT_SPELL
11411 if (argvars[0].v_type == VAR_UNKNOWN)
11412 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011413 // Find the start and length of the badly spelled word.
Christ van Willegen - van Noort8e4c4c72024-05-17 18:49:27 +020011414 len = spell_move_to(curwin, FORWARD, SMT_ALL, TRUE, &attr);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011415 if (len != 0)
Bram Moolenaarb73fa622017-12-21 20:27:47 +010011416 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011417 word = ml_get_cursor();
Bram Moolenaarb73fa622017-12-21 20:27:47 +010011418 curwin->w_set_curswant = TRUE;
11419 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011420 }
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011421 else if (*curbuf->b_s.b_p_spl != NUL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011422 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011423 char_u *str = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011424 int capcol = -1;
11425
11426 if (str != NULL)
11427 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011428 // Check the argument for spelling.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011429 while (*str != NUL)
11430 {
11431 len = spell_check(curwin, str, &attr, &capcol, FALSE);
11432 if (attr != HLF_COUNT)
11433 {
11434 word = str;
11435 break;
11436 }
11437 str += len;
Bram Moolenaar66ab9162018-07-20 20:28:48 +020011438 capcol -= len;
Bram Moolenaar0c779e82019-08-09 17:01:02 +020011439 len = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011440 }
11441 }
11442 }
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011443 curwin->w_p_spell = wo_spell_save;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011444#endif
11445
11446 list_append_string(rettv->vval.v_list, word, len);
11447 list_append_string(rettv->vval.v_list, (char_u *)(
11448 attr == HLF_SPB ? "bad" :
11449 attr == HLF_SPR ? "rare" :
11450 attr == HLF_SPL ? "local" :
11451 attr == HLF_SPC ? "caps" :
11452 ""), -1);
11453}
11454
11455/*
11456 * "spellsuggest()" function
11457 */
11458 static void
11459f_spellsuggest(typval_T *argvars UNUSED, typval_T *rettv)
11460{
11461#ifdef FEAT_SPELL
11462 char_u *str;
11463 int typeerr = FALSE;
11464 int maxcount;
11465 garray_T ga;
11466 int i;
11467 listitem_T *li;
11468 int need_capital = FALSE;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011469 int wo_spell_save = curwin->w_p_spell;
11470
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011471 if (in_vim9script()
11472 && (check_for_string_arg(argvars, 0) == FAIL
11473 || check_for_opt_number_arg(argvars, 1) == FAIL
11474 || (argvars[1].v_type != VAR_UNKNOWN
11475 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
11476 return;
11477
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011478 if (!curwin->w_p_spell)
11479 {
Yegappan Lakshmananaf936912023-02-20 12:16:39 +000011480 parse_spelllang(curwin);
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011481 curwin->w_p_spell = TRUE;
11482 }
11483
11484 if (*curwin->w_s->b_p_spl == NUL)
11485 {
Bram Moolenaar460ae5d2022-01-01 14:19:49 +000011486 emsg(_(e_spell_checking_is_not_possible));
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011487 curwin->w_p_spell = wo_spell_save;
11488 return;
11489 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011490#endif
11491
11492 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011493 {
11494#ifdef FEAT_SPELL
11495 curwin->w_p_spell = wo_spell_save;
11496#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011497 return;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011498 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011499
11500#ifdef FEAT_SPELL
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011501 str = tv_get_string(&argvars[0]);
11502 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011503 {
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011504 maxcount = (int)tv_get_number_chk(&argvars[1], &typeerr);
11505 if (maxcount <= 0)
11506 return;
11507 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011508 {
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011509 need_capital = (int)tv_get_bool_chk(&argvars[2], &typeerr);
11510 if (typeerr)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011511 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011512 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011513 }
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011514 else
11515 maxcount = 25;
11516
11517 spell_suggest_list(&ga, str, maxcount, need_capital, FALSE);
11518
11519 for (i = 0; i < ga.ga_len; ++i)
11520 {
11521 str = ((char_u **)ga.ga_data)[i];
11522
11523 li = listitem_alloc();
11524 if (li == NULL)
11525 vim_free(str);
11526 else
11527 {
11528 li->li_tv.v_type = VAR_STRING;
11529 li->li_tv.v_lock = 0;
11530 li->li_tv.vval.v_string = str;
11531 list_append(rettv->vval.v_list, li);
11532 }
11533 }
11534 ga_clear(&ga);
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011535 curwin->w_p_spell = wo_spell_save;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011536#endif
11537}
11538
11539 static void
11540f_split(typval_T *argvars, typval_T *rettv)
11541{
11542 char_u *str;
11543 char_u *end;
11544 char_u *pat = NULL;
11545 regmatch_T regmatch;
11546 char_u patbuf[NUMBUFLEN];
11547 char_u *save_cpo;
11548 int match;
11549 colnr_T col = 0;
11550 int keepempty = FALSE;
11551 int typeerr = FALSE;
11552
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011553 if (in_vim9script()
11554 && (check_for_string_arg(argvars, 0) == FAIL
11555 || check_for_opt_string_arg(argvars, 1) == FAIL
11556 || (argvars[1].v_type != VAR_UNKNOWN
11557 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
11558 return;
11559
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011560 // Make 'cpoptions' empty, the 'l' flag should not be used here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011561 save_cpo = p_cpo;
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010011562 p_cpo = empty_option;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011563
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011564 str = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011565 if (argvars[1].v_type != VAR_UNKNOWN)
11566 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011567 pat = tv_get_string_buf_chk(&argvars[1], patbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011568 if (pat == NULL)
11569 typeerr = TRUE;
11570 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar3986b942020-09-06 16:09:04 +020011571 keepempty = (int)tv_get_bool_chk(&argvars[2], &typeerr);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011572 }
11573 if (pat == NULL || *pat == NUL)
11574 pat = (char_u *)"[\\x01- ]\\+";
11575
11576 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar7d5e7442020-07-21 22:25:51 +020011577 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011578 if (typeerr)
Bram Moolenaar7d5e7442020-07-21 22:25:51 +020011579 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011580
11581 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
11582 if (regmatch.regprog != NULL)
11583 {
11584 regmatch.rm_ic = FALSE;
11585 while (*str != NUL || keepempty)
11586 {
11587 if (*str == NUL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011588 match = FALSE; // empty item at the end
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011589 else
11590 match = vim_regexec_nl(&regmatch, str, col);
11591 if (match)
11592 end = regmatch.startp[0];
11593 else
11594 end = str + STRLEN(str);
11595 if (keepempty || end > str || (rettv->vval.v_list->lv_len > 0
11596 && *str != NUL && match && end < regmatch.endp[0]))
11597 {
11598 if (list_append_string(rettv->vval.v_list, str,
11599 (int)(end - str)) == FAIL)
11600 break;
11601 }
11602 if (!match)
11603 break;
Bram Moolenaar13505972019-01-24 15:04:48 +010011604 // Advance to just after the match.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011605 if (regmatch.endp[0] > str)
11606 col = 0;
11607 else
Bram Moolenaar13505972019-01-24 15:04:48 +010011608 // Don't get stuck at the same match.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011609 col = (*mb_ptr2len)(regmatch.endp[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011610 str = regmatch.endp[0];
11611 }
11612
11613 vim_regfree(regmatch.regprog);
11614 }
11615
Bram Moolenaar7d5e7442020-07-21 22:25:51 +020011616theend:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011617 p_cpo = save_cpo;
11618}
11619
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011620/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011621 * "submatch()" function
11622 */
11623 static void
11624f_submatch(typval_T *argvars, typval_T *rettv)
11625{
11626 int error = FALSE;
11627 int no;
11628 int retList = 0;
11629
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011630 if (in_vim9script()
11631 && (check_for_number_arg(argvars, 0) == FAIL
11632 || check_for_opt_bool_arg(argvars, 1) == FAIL))
11633 return;
11634
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011635 no = (int)tv_get_number_chk(&argvars[0], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011636 if (error)
11637 return;
Bram Moolenaar989f5922016-08-21 15:26:54 +020011638 if (no < 0 || no >= NSUBEXP)
11639 {
Bram Moolenaard82a47d2022-01-05 20:24:39 +000011640 semsg(_(e_invalid_submatch_number_nr), no);
Bram Moolenaar79518e22017-02-17 16:31:35 +010011641 return;
Bram Moolenaar989f5922016-08-21 15:26:54 +020011642 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011643 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaarad304702020-09-06 18:22:53 +020011644 retList = (int)tv_get_bool_chk(&argvars[1], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011645 if (error)
11646 return;
11647
11648 if (retList == 0)
11649 {
11650 rettv->v_type = VAR_STRING;
11651 rettv->vval.v_string = reg_submatch(no);
11652 }
11653 else
11654 {
11655 rettv->v_type = VAR_LIST;
11656 rettv->vval.v_list = reg_submatch_list(no);
11657 }
11658}
11659
11660/*
11661 * "substitute()" function
11662 */
11663 static void
11664f_substitute(typval_T *argvars, typval_T *rettv)
11665{
11666 char_u patbuf[NUMBUFLEN];
11667 char_u subbuf[NUMBUFLEN];
11668 char_u flagsbuf[NUMBUFLEN];
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +020011669 char_u *str;
11670 char_u *pat;
Bram Moolenaar72ab7292016-07-19 19:10:51 +020011671 char_u *sub = NULL;
11672 typval_T *expr = NULL;
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +020011673 char_u *flg;
11674
11675 if (in_vim9script()
11676 && (check_for_string_arg(argvars, 0) == FAIL
11677 || check_for_string_arg(argvars, 1) == FAIL
11678 || check_for_string_arg(argvars, 3) == FAIL))
11679 return;
11680
11681 str = tv_get_string_chk(&argvars[0]);
11682 pat = tv_get_string_buf_chk(&argvars[1], patbuf);
11683 flg = tv_get_string_buf_chk(&argvars[3], flagsbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011684
LemonBoyf3b48952022-05-05 13:53:03 +010011685 if (argvars[2].v_type == VAR_FUNC
11686 || argvars[2].v_type == VAR_PARTIAL
Bram Moolenaar00b28d62022-12-08 15:32:33 +000011687 || argvars[2].v_type == VAR_INSTR
11688 || argvars[2].v_type == VAR_CLASS
11689 || argvars[2].v_type == VAR_OBJECT)
Bram Moolenaar72ab7292016-07-19 19:10:51 +020011690 expr = &argvars[2];
11691 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011692 sub = tv_get_string_buf_chk(&argvars[2], subbuf);
Bram Moolenaar72ab7292016-07-19 19:10:51 +020011693
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011694 rettv->v_type = VAR_STRING;
Bram Moolenaar72ab7292016-07-19 19:10:51 +020011695 if (str == NULL || pat == NULL || (sub == NULL && expr == NULL)
11696 || flg == NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011697 rettv->vval.v_string = NULL;
11698 else
John Marriottbd4614f2024-11-18 20:25:21 +010011699 rettv->vval.v_string = do_string_sub(str, STRLEN(str), pat, sub, expr, flg, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011700}
11701
11702/*
Bram Moolenaarc216a7a2022-12-05 13:50:55 +000011703 * "swapfilelist()" function
11704 */
11705 static void
11706f_swapfilelist(typval_T *argvars UNUSED, typval_T *rettv)
11707{
11708 if (rettv_list_alloc(rettv) == FAIL)
11709 return;
11710 recover_names(NULL, FALSE, rettv->vval.v_list, 0, NULL);
11711}
11712
11713/*
Bram Moolenaar00f123a2018-08-21 20:28:54 +020011714 * "swapinfo(swap_filename)" function
11715 */
11716 static void
11717f_swapinfo(typval_T *argvars, typval_T *rettv)
11718{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011719 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11720 return;
11721
Bram Moolenaar00f123a2018-08-21 20:28:54 +020011722 if (rettv_dict_alloc(rettv) == OK)
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011723 get_b0_dict(tv_get_string(argvars), rettv->vval.v_dict);
Bram Moolenaar00f123a2018-08-21 20:28:54 +020011724}
11725
11726/*
Bram Moolenaar110bd602018-09-16 18:46:59 +020011727 * "swapname(expr)" function
11728 */
11729 static void
11730f_swapname(typval_T *argvars, typval_T *rettv)
11731{
11732 buf_T *buf;
11733
11734 rettv->v_type = VAR_STRING;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011735
11736 if (in_vim9script() && check_for_buffer_arg(argvars, 0) == FAIL)
11737 return;
11738
Bram Moolenaarf2d79fa2019-01-03 22:19:27 +010011739 buf = tv_get_buf(&argvars[0], FALSE);
Bram Moolenaar110bd602018-09-16 18:46:59 +020011740 if (buf == NULL || buf->b_ml.ml_mfp == NULL
11741 || buf->b_ml.ml_mfp->mf_fname == NULL)
11742 rettv->vval.v_string = NULL;
11743 else
11744 rettv->vval.v_string = vim_strsave(buf->b_ml.ml_mfp->mf_fname);
11745}
11746
11747/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011748 * "synID(lnum, col, trans)" function
11749 */
11750 static void
11751f_synID(typval_T *argvars UNUSED, typval_T *rettv)
11752{
11753 int id = 0;
11754#ifdef FEAT_SYN_HL
11755 linenr_T lnum;
11756 colnr_T col;
11757 int trans;
11758 int transerr = FALSE;
11759
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011760 if (in_vim9script()
Yegappan Lakshmanancd917202021-07-21 19:09:09 +020011761 && (check_for_lnum_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011762 || check_for_number_arg(argvars, 1) == FAIL
11763 || check_for_bool_arg(argvars, 2) == FAIL))
11764 return;
11765
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011766 lnum = tv_get_lnum(argvars); // -1 on type error
11767 col = (linenr_T)tv_get_number(&argvars[1]) - 1; // -1 on type error
Bram Moolenaarfcb6d702020-09-05 21:41:56 +020011768 trans = (int)tv_get_bool_chk(&argvars[2], &transerr);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011769
11770 if (!transerr && lnum >= 1 && lnum <= curbuf->b_ml.ml_line_count
John Marriottbfcc8952024-03-11 22:04:45 +010011771 && col >= 0 && col < (long)ml_get_len(lnum))
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +000011772 id = syn_get_id(curwin, lnum, col, trans, NULL, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011773#endif
11774
11775 rettv->vval.v_number = id;
11776}
11777
11778/*
11779 * "synIDattr(id, what [, mode])" function
11780 */
11781 static void
11782f_synIDattr(typval_T *argvars UNUSED, typval_T *rettv)
11783{
11784 char_u *p = NULL;
11785#ifdef FEAT_SYN_HL
11786 int id;
11787 char_u *what;
11788 char_u *mode;
11789 char_u modebuf[NUMBUFLEN];
11790 int modec;
11791
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +020011792 if (in_vim9script()
11793 && (check_for_number_arg(argvars, 0) == FAIL
Yegappan Lakshmananf8dbd582021-09-26 19:04:05 +010011794 || check_for_string_arg(argvars, 1) == FAIL
11795 || check_for_opt_string_arg(argvars, 2) == FAIL))
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +020011796 return;
11797
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011798 id = (int)tv_get_number(&argvars[0]);
11799 what = tv_get_string(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011800 if (argvars[2].v_type != VAR_UNKNOWN)
11801 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011802 mode = tv_get_string_buf(&argvars[2], modebuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011803 modec = TOLOWER_ASC(mode[0]);
11804 if (modec != 't' && modec != 'c' && modec != 'g')
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011805 modec = 0; // replace invalid with current
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011806 }
11807 else
11808 {
11809#if defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS)
11810 if (USE_24BIT)
11811 modec = 'g';
11812 else
11813#endif
11814 if (t_colors > 1)
Dominique Pelle4781d6f2021-05-18 21:46:31 +020011815 modec = 'c';
11816 else
11817 modec = 't';
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011818 }
11819
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011820 switch (TOLOWER_ASC(what[0]))
11821 {
11822 case 'b':
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011823 if (TOLOWER_ASC(what[1]) == 'g') // bg[#]
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011824 p = highlight_color(id, what, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011825 else // bold
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011826 p = highlight_has_attr(id, HL_BOLD, modec);
11827 break;
11828
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011829 case 'f': // fg[#] or font
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011830 p = highlight_color(id, what, modec);
11831 break;
11832
11833 case 'i':
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011834 if (TOLOWER_ASC(what[1]) == 'n') // inverse
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011835 p = highlight_has_attr(id, HL_INVERSE, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011836 else // italic
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011837 p = highlight_has_attr(id, HL_ITALIC, modec);
11838 break;
11839
Martin Tournoijba43e762022-10-13 22:12:15 +010011840 case 'n':
Bram Moolenaarde786322022-07-30 14:56:17 +010011841 if (TOLOWER_ASC(what[1]) == 'o') // nocombine
11842 p = highlight_has_attr(id, HL_NOCOMBINE, modec);
11843 else // name
11844 p = get_highlight_name_ext(NULL, id - 1, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011845 break;
11846
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011847 case 'r': // reverse
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011848 p = highlight_has_attr(id, HL_INVERSE, modec);
11849 break;
11850
11851 case 's':
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011852 if (TOLOWER_ASC(what[1]) == 'p') // sp[#]
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011853 p = highlight_color(id, what, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011854 // strikeout
Bram Moolenaarcf4b00c2017-09-02 18:33:56 +020011855 else if (TOLOWER_ASC(what[1]) == 't' &&
11856 TOLOWER_ASC(what[2]) == 'r')
11857 p = highlight_has_attr(id, HL_STRIKETHROUGH, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011858 else // standout
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011859 p = highlight_has_attr(id, HL_STANDOUT, modec);
11860 break;
11861
11862 case 'u':
Bram Moolenaar84f54632022-06-29 18:39:11 +010011863 if (STRLEN(what) >= 9)
11864 {
11865 if (TOLOWER_ASC(what[5]) == 'l')
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011866 // underline
Bram Moolenaar84f54632022-06-29 18:39:11 +010011867 p = highlight_has_attr(id, HL_UNDERLINE, modec);
11868 else if (TOLOWER_ASC(what[5]) != 'd')
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011869 // undercurl
Bram Moolenaar84f54632022-06-29 18:39:11 +010011870 p = highlight_has_attr(id, HL_UNDERCURL, modec);
11871 else if (TOLOWER_ASC(what[6]) != 'o')
11872 // underdashed
11873 p = highlight_has_attr(id, HL_UNDERDASHED, modec);
11874 else if (TOLOWER_ASC(what[7]) == 'u')
11875 // underdouble
11876 p = highlight_has_attr(id, HL_UNDERDOUBLE, modec);
11877 else
11878 // underdotted
11879 p = highlight_has_attr(id, HL_UNDERDOTTED, modec);
11880 }
11881 else
11882 // ul
11883 p = highlight_color(id, what, modec);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011884 break;
11885 }
11886
11887 if (p != NULL)
11888 p = vim_strsave(p);
11889#endif
11890 rettv->v_type = VAR_STRING;
11891 rettv->vval.v_string = p;
11892}
11893
11894/*
11895 * "synIDtrans(id)" function
11896 */
11897 static void
11898f_synIDtrans(typval_T *argvars UNUSED, typval_T *rettv)
11899{
11900 int id;
11901
11902#ifdef FEAT_SYN_HL
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011903 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
11904 return;
11905
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011906 id = (int)tv_get_number(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011907
11908 if (id > 0)
11909 id = syn_get_final_id(id);
11910 else
11911#endif
11912 id = 0;
11913
11914 rettv->vval.v_number = id;
11915}
11916
11917/*
11918 * "synconcealed(lnum, col)" function
11919 */
11920 static void
11921f_synconcealed(typval_T *argvars UNUSED, typval_T *rettv)
11922{
11923#if defined(FEAT_SYN_HL) && defined(FEAT_CONCEAL)
11924 linenr_T lnum;
11925 colnr_T col;
11926 int syntax_flags = 0;
11927 int cchar;
11928 int matchid = 0;
11929 char_u str[NUMBUFLEN];
11930#endif
11931
Bram Moolenaar45cf6e92017-04-30 20:25:19 +020011932 rettv_list_set(rettv, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011933
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020011934 if (in_vim9script()
Yegappan Lakshmanancd917202021-07-21 19:09:09 +020011935 && (check_for_lnum_arg(argvars, 0) == FAIL
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020011936 || check_for_number_arg(argvars, 1) == FAIL))
11937 return;
11938
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011939#if defined(FEAT_SYN_HL) && defined(FEAT_CONCEAL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011940 lnum = tv_get_lnum(argvars); // -1 on type error
11941 col = (colnr_T)tv_get_number(&argvars[1]) - 1; // -1 on type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011942
Bram Moolenaara80faa82020-04-12 19:37:17 +020011943 CLEAR_FIELD(str);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011944
Bram Moolenaar93a10962022-06-16 11:42:09 +010011945 if (rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011946 {
11947 if (lnum >= 1 && lnum <= curbuf->b_ml.ml_line_count
John Marriottbfcc8952024-03-11 22:04:45 +010011948 && col >= 0 && col <= (long)ml_get_len(lnum)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011949 && curwin->w_p_cole > 0)
11950 {
11951 (void)syn_get_id(curwin, lnum, col, FALSE, NULL, FALSE);
11952 syntax_flags = get_syntax_info(&matchid);
11953
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011954 // get the conceal character
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011955 if ((syntax_flags & HL_CONCEAL) && curwin->w_p_cole < 3)
11956 {
11957 cchar = syn_get_sub_char();
Bram Moolenaar4d785892017-06-22 22:00:50 +020011958 if (cchar == NUL && curwin->w_p_cole == 1)
Bram Moolenaareed9d462021-02-15 20:38:25 +010011959 cchar = (curwin->w_lcs_chars.conceal == NUL) ? ' '
11960 : curwin->w_lcs_chars.conceal;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011961 if (cchar != NUL)
11962 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011963 if (has_mbyte)
11964 (*mb_char2bytes)(cchar, str);
11965 else
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011966 str[0] = cchar;
11967 }
11968 }
11969 }
11970
11971 list_append_number(rettv->vval.v_list,
11972 (syntax_flags & HL_CONCEAL) != 0);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011973 // -1 to auto-determine strlen
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011974 list_append_string(rettv->vval.v_list, str, -1);
11975 list_append_number(rettv->vval.v_list, matchid);
11976 }
11977#endif
11978}
11979
11980/*
11981 * "synstack(lnum, col)" function
11982 */
11983 static void
11984f_synstack(typval_T *argvars UNUSED, typval_T *rettv)
11985{
11986#ifdef FEAT_SYN_HL
11987 linenr_T lnum;
11988 colnr_T col;
11989 int i;
11990 int id;
11991#endif
11992
Bram Moolenaar45cf6e92017-04-30 20:25:19 +020011993 rettv_list_set(rettv, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011994
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020011995 if (in_vim9script()
Yegappan Lakshmanancd917202021-07-21 19:09:09 +020011996 && (check_for_lnum_arg(argvars, 0) == FAIL
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020011997 || check_for_number_arg(argvars, 1) == FAIL))
11998 return;
11999
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012000#ifdef FEAT_SYN_HL
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012001 lnum = tv_get_lnum(argvars); // -1 on type error
12002 col = (colnr_T)tv_get_number(&argvars[1]) - 1; // -1 on type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012003
12004 if (lnum >= 1 && lnum <= curbuf->b_ml.ml_line_count
John Marriottbfcc8952024-03-11 22:04:45 +010012005 && col >= 0 && col <= (long)ml_get_len(lnum)
Bram Moolenaar93a10962022-06-16 11:42:09 +010012006 && rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012007 {
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +000012008 (void)syn_get_id(curwin, lnum, col, FALSE, NULL, TRUE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012009 for (i = 0; ; ++i)
12010 {
12011 id = syn_get_stack_item(i);
12012 if (id < 0)
12013 break;
12014 if (list_append_number(rettv->vval.v_list, id) == FAIL)
12015 break;
12016 }
12017 }
12018#endif
12019}
12020
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012021/*
12022 * "tabpagebuflist()" function
12023 */
12024 static void
12025f_tabpagebuflist(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
12026{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012027 tabpage_T *tp;
12028 win_T *wp = NULL;
12029
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012030 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
12031 return;
12032
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012033 if (argvars[0].v_type == VAR_UNKNOWN)
12034 wp = firstwin;
12035 else
12036 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012037 tp = find_tabpage((int)tv_get_number(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012038 if (tp != NULL)
12039 wp = (tp == curtab) ? firstwin : tp->tp_firstwin;
12040 }
Bram Moolenaar93a10962022-06-16 11:42:09 +010012041 if (wp != NULL && rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012042 {
12043 for (; wp != NULL; wp = wp->w_next)
12044 if (list_append_number(rettv->vval.v_list,
12045 wp->w_buffer->b_fnum) == FAIL)
12046 break;
12047 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012048}
12049
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012050/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012051 * "tagfiles()" function
12052 */
12053 static void
12054f_tagfiles(typval_T *argvars UNUSED, typval_T *rettv)
12055{
12056 char_u *fname;
12057 tagname_T tn;
12058 int first;
12059
12060 if (rettv_list_alloc(rettv) == FAIL)
12061 return;
12062 fname = alloc(MAXPATHL);
12063 if (fname == NULL)
12064 return;
12065
12066 for (first = TRUE; ; first = FALSE)
12067 if (get_tagfname(&tn, first, fname) == FAIL
12068 || list_append_string(rettv->vval.v_list, fname, -1) == FAIL)
12069 break;
12070 tagname_free(&tn);
12071 vim_free(fname);
12072}
12073
12074/*
12075 * "taglist()" function
12076 */
12077 static void
12078f_taglist(typval_T *argvars, typval_T *rettv)
12079{
Bram Moolenaarc6aafba2017-03-21 17:09:10 +010012080 char_u *fname = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012081 char_u *tag_pattern;
12082
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012083 if (in_vim9script()
12084 && (check_for_string_arg(argvars, 0) == FAIL
12085 || check_for_opt_string_arg(argvars, 1) == FAIL))
12086 return;
12087
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012088 tag_pattern = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012089
12090 rettv->vval.v_number = FALSE;
12091 if (*tag_pattern == NUL)
12092 return;
12093
Bram Moolenaarc6aafba2017-03-21 17:09:10 +010012094 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012095 fname = tv_get_string(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012096 if (rettv_list_alloc(rettv) == OK)
Bram Moolenaarc6aafba2017-03-21 17:09:10 +010012097 (void)get_tags(rettv->vval.v_list, tag_pattern, fname);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012098}
12099
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012100/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012101 * "type(expr)" function
12102 */
12103 static void
12104f_type(typval_T *argvars, typval_T *rettv)
12105{
12106 int n = -1;
12107
12108 switch (argvars[0].v_type)
12109 {
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +010012110 case VAR_NUMBER: n = VAR_TYPE_NUMBER; break;
12111 case VAR_STRING: n = VAR_TYPE_STRING; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012112 case VAR_PARTIAL:
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +010012113 case VAR_FUNC: n = VAR_TYPE_FUNC; break;
12114 case VAR_LIST: n = VAR_TYPE_LIST; break;
12115 case VAR_DICT: n = VAR_TYPE_DICT; break;
12116 case VAR_FLOAT: n = VAR_TYPE_FLOAT; break;
12117 case VAR_BOOL: n = VAR_TYPE_BOOL; break;
12118 case VAR_SPECIAL: n = VAR_TYPE_NONE; break;
Bram Moolenaarf562e722016-07-19 17:25:25 +020012119 case VAR_JOB: n = VAR_TYPE_JOB; break;
12120 case VAR_CHANNEL: n = VAR_TYPE_CHANNEL; break;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +010012121 case VAR_BLOB: n = VAR_TYPE_BLOB; break;
Bram Moolenaarf18332f2021-05-07 17:55:55 +020012122 case VAR_INSTR: n = VAR_TYPE_INSTR; break;
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +020012123 case VAR_TYPEALIAS: n = VAR_TYPE_TYPEALIAS; break;
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012124 case VAR_CLASS:
12125 {
12126 class_T *cl = argvars[0].vval.v_class;
Yegappan Lakshmananda9d3452024-05-02 13:02:36 +020012127 if (cl != NULL && IS_ENUM(cl))
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012128 n = VAR_TYPE_ENUM;
12129 else
12130 n = VAR_TYPE_CLASS;
12131 break;
12132 }
12133 case VAR_OBJECT:
12134 {
Yegappan Lakshmananb2e42b92024-05-01 11:44:17 +020012135 object_T *obj = argvars[0].vval.v_object;
12136
12137 if (obj == NULL)
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012138 n = VAR_TYPE_OBJECT;
Yegappan Lakshmananb2e42b92024-05-01 11:44:17 +020012139 else
12140 {
12141 class_T *cl = argvars[0].vval.v_object->obj_class;
12142 if (IS_ENUM(cl))
12143 n = VAR_TYPE_ENUMVALUE;
12144 else
12145 n = VAR_TYPE_OBJECT;
12146 }
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012147 break;
12148 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012149 case VAR_UNKNOWN:
Bram Moolenaar4c683752020-04-05 21:38:23 +020012150 case VAR_ANY:
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010012151 case VAR_VOID:
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012152 internal_error_no_abort("f_type(UNKNOWN)");
12153 n = -1;
12154 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012155 }
12156 rettv->vval.v_number = n;
12157}
12158
12159/*
zeertzjq825cf812023-08-17 22:55:25 +020012160 * "virtcol({expr}, [, {list} [, {winid}]])" function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012161 */
12162 static void
12163f_virtcol(typval_T *argvars, typval_T *rettv)
12164{
LemonBoy0f7a3e12022-05-26 12:10:37 +010012165 colnr_T vcol_start = 0;
12166 colnr_T vcol_end = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012167 pos_T *fp;
zeertzjq825cf812023-08-17 22:55:25 +020012168 switchwin_T switchwin;
12169 int winchanged = FALSE;
Bram Moolenaarb3d33d82020-01-15 20:36:55 +010012170 int len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012171
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012172 if (in_vim9script()
LemonBoy0f7a3e12022-05-26 12:10:37 +010012173 && (check_for_string_or_list_arg(argvars, 0) == FAIL
12174 || (argvars[1].v_type != VAR_UNKNOWN
zeertzjq825cf812023-08-17 22:55:25 +020012175 && (check_for_bool_arg(argvars, 1) == FAIL
12176 || check_for_opt_number_arg(argvars, 2) == FAIL))))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012177 return;
12178
zeertzjq825cf812023-08-17 22:55:25 +020012179 if (argvars[1].v_type != VAR_UNKNOWN && argvars[2].v_type != VAR_UNKNOWN)
12180 {
12181 tabpage_T *tp;
12182 win_T *wp;
12183
12184 // use the window specified in the third argument
12185 wp = win_id2wp_tp((int)tv_get_number(&argvars[2]), &tp);
12186 if (wp == NULL || tp == NULL)
12187 goto theend;
12188
12189 if (switch_win_noblock(&switchwin, wp, tp, TRUE) != OK)
12190 goto theend;
12191
12192 check_cursor();
12193 winchanged = TRUE;
12194 }
12195
12196 int fnum = curbuf->b_fnum;
Bram Moolenaar6f02b002021-01-10 20:22:54 +010012197 fp = var2fpos(&argvars[0], FALSE, &fnum, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012198 if (fp != NULL && fp->lnum <= curbuf->b_ml.ml_line_count
LemonBoy0f7a3e12022-05-26 12:10:37 +010012199 && fnum == curbuf->b_fnum)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012200 {
Bram Moolenaarb3d33d82020-01-15 20:36:55 +010012201 // Limit the column to a valid value, getvvcol() doesn't check.
12202 if (fp->col < 0)
12203 fp->col = 0;
12204 else
12205 {
John Marriottbfcc8952024-03-11 22:04:45 +010012206 len = (int)ml_get_len(fp->lnum);
Bram Moolenaarb3d33d82020-01-15 20:36:55 +010012207 if (fp->col > len)
12208 fp->col = len;
12209 }
LemonBoy0f7a3e12022-05-26 12:10:37 +010012210 getvvcol(curwin, fp, &vcol_start, NULL, &vcol_end);
12211 ++vcol_start;
12212 ++vcol_end;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012213 }
12214
zeertzjq825cf812023-08-17 22:55:25 +020012215theend:
LemonBoy0f7a3e12022-05-26 12:10:37 +010012216 if (argvars[1].v_type != VAR_UNKNOWN && tv_get_bool(&argvars[1]))
12217 {
12218 if (rettv_list_alloc(rettv) == OK)
12219 {
12220 list_append_number(rettv->vval.v_list, vcol_start);
12221 list_append_number(rettv->vval.v_list, vcol_end);
12222 }
12223 else
12224 rettv->vval.v_number = 0;
12225 }
12226 else
12227 rettv->vval.v_number = vcol_end;
zeertzjq825cf812023-08-17 22:55:25 +020012228
12229 if (winchanged)
12230 restore_win_noblock(&switchwin, TRUE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012231}
12232
12233/*
12234 * "visualmode()" function
12235 */
12236 static void
12237f_visualmode(typval_T *argvars, typval_T *rettv)
12238{
12239 char_u str[2];
12240
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012241 if (in_vim9script() && check_for_opt_bool_arg(argvars, 0) == FAIL)
12242 return;
12243
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012244 rettv->v_type = VAR_STRING;
12245 str[0] = curbuf->b_visual_mode_eval;
12246 str[1] = NUL;
12247 rettv->vval.v_string = vim_strsave(str);
12248
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012249 // A non-zero number or non-empty string argument: reset mode.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012250 if (non_zero_arg(&argvars[0]))
12251 curbuf->b_visual_mode_eval = NUL;
12252}
12253
12254/*
12255 * "wildmenumode()" function
12256 */
12257 static void
12258f_wildmenumode(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
12259{
Bram Moolenaar24959102022-05-07 20:01:16 +010012260 if (wild_menu_showing || ((State & MODE_CMDLINE) && cmdline_pum_active()))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012261 rettv->vval.v_number = 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012262}
12263
12264/*
Bram Moolenaar0c1e3742019-12-27 13:49:24 +010012265 * "windowsversion()" function
12266 */
12267 static void
12268f_windowsversion(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
12269{
12270 rettv->v_type = VAR_STRING;
12271 rettv->vval.v_string = vim_strsave((char_u *)windowsVersion);
12272}
12273
12274/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012275 * "wordcount()" function
12276 */
12277 static void
12278f_wordcount(typval_T *argvars UNUSED, typval_T *rettv)
12279{
12280 if (rettv_dict_alloc(rettv) == FAIL)
12281 return;
12282 cursor_pos_info(rettv->vval.v_dict);
12283}
12284
12285/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012286 * "xor(expr, expr)" function
12287 */
12288 static void
12289f_xor(typval_T *argvars, typval_T *rettv)
12290{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012291 if (in_vim9script()
12292 && (check_for_number_arg(argvars, 0) == FAIL
12293 || check_for_number_arg(argvars, 1) == FAIL))
12294 return;
12295
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012296 rettv->vval.v_number = tv_get_number_chk(&argvars[0], NULL)
12297 ^ tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012298}
12299
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012300#endif // FEAT_EVAL