blob: 2b630cafc28bbbfd27d1c9c497cf9867e62afb66 [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};
Yegappan Lakshmanana11b23c2025-01-16 19:16:42 +01001132static argcheck_T arg2_list_string_dict[] = {arg_list_string, arg_dict_any};
Bram Moolenaarfa103972022-09-29 19:14:42 +01001133static argcheck_T arg2_listblobmod_item[] = {arg_list_or_blob_mod, arg_item_of_prev};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001134static argcheck_T arg2_lnum[] = {arg_lnum, arg_lnum};
1135static argcheck_T arg2_lnum_number[] = {arg_lnum, arg_number};
1136static argcheck_T arg2_number[] = {arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001137static argcheck_T arg2_number_any[] = {arg_number, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001138static argcheck_T arg2_number_bool[] = {arg_number, arg_bool};
1139static argcheck_T arg2_number_dict_any[] = {arg_number, arg_dict_any};
1140static argcheck_T arg2_number_list[] = {arg_number, arg_list_any};
1141static argcheck_T arg2_number_string[] = {arg_number, arg_string};
Christian Brabandtfbc37f12024-06-18 20:50:58 +02001142static argcheck_T arg2_number_buffer[] = {arg_number, arg_buffer};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001143static argcheck_T arg2_number_string_or_list[] = {arg_number, arg_string_or_list_any};
1144static argcheck_T arg2_str_or_nr_or_list_dict[] = {arg_str_or_nr_or_list, arg_dict_any};
1145static argcheck_T arg2_string[] = {arg_string, arg_string};
Ernie Raela8f7f922023-12-14 20:17:04 +01001146static argcheck_T arg2_string_any[] = {arg_string, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001147static argcheck_T arg2_string_bool[] = {arg_string, arg_bool};
1148static argcheck_T arg2_string_chan_or_job[] = {arg_string, arg_chan_or_job};
1149static argcheck_T arg2_string_dict[] = {arg_string, arg_dict_any};
1150static argcheck_T arg2_string_list_number[] = {arg_string, arg_list_number};
1151static argcheck_T arg2_string_number[] = {arg_string, arg_number};
1152static argcheck_T arg2_string_or_list_dict[] = {arg_string_or_list_any, arg_dict_any};
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00001153static argcheck_T arg2_string_or_list_number[] = {arg_string_or_list_any, arg_number};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001154static argcheck_T arg2_string_string_or_number[] = {arg_string, arg_string_or_nr};
Yegappan Lakshmanan1aefe1d2025-01-14 17:29:42 +01001155static argcheck_T arg2_blob_dict[] = {arg_blob, arg_dict_any};
Ernie Raela8f7f922023-12-14 20:17:04 +01001156static argcheck_T arg3_any_list_dict[] = {arg_any, arg_list_any, arg_dict_any};
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001157static argcheck_T arg3_buffer_lnum_lnum[] = {arg_buffer, arg_lnum, arg_lnum};
1158static argcheck_T arg3_buffer_number_number[] = {arg_buffer, arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001159static argcheck_T arg3_buffer_string_any[] = {arg_buffer, arg_string, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001160static argcheck_T arg3_buffer_string_dict[] = {arg_buffer, arg_string, arg_dict_any};
1161static argcheck_T arg3_dict_number_number[] = {arg_dict_any, arg_number, arg_number};
Yegappan Lakshmananfa378352024-02-01 22:05:27 +01001162static argcheck_T arg3_diff[] = {arg_list_string, arg_list_string, arg_dict_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001163static argcheck_T arg3_list_string_dict[] = {arg_list_any, arg_string, arg_dict_any};
Shougo Matsushita19b71882024-02-28 22:48:12 +01001164static argcheck_T arg3_list_list_dict[] = {arg_list_any, arg_list_any, arg_dict_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001165static argcheck_T arg3_lnum_number_bool[] = {arg_lnum, arg_number, arg_bool};
1166static argcheck_T arg3_number[] = {arg_number, arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001167static argcheck_T arg3_number_any_dict[] = {arg_number, arg_any, arg_dict_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001168static argcheck_T arg3_number_number_dict[] = {arg_number, arg_number, arg_dict_any};
Ernie Raela8f7f922023-12-14 20:17:04 +01001169static argcheck_T arg3_number_string_any[] = {arg_number, arg_string, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001170static argcheck_T arg3_number_string_buffer[] = {arg_number, arg_string, arg_buffer};
1171static argcheck_T arg3_number_string_string[] = {arg_number, arg_string, arg_string};
1172static argcheck_T arg3_string[] = {arg_string, arg_string, arg_string};
Ernie Raela8f7f922023-12-14 20:17:04 +01001173static argcheck_T arg3_string_any_dict[] = {arg_string, arg_any, arg_dict_any};
1174static argcheck_T arg3_string_any_string[] = {arg_string, arg_any, arg_string};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001175static argcheck_T arg3_string_bool_bool[] = {arg_string, arg_bool, arg_bool};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001176static argcheck_T arg3_string_number_bool[] = {arg_string, arg_number, arg_bool};
K.Takata11df3ae2022-10-19 14:02:40 +01001177static argcheck_T arg3_string_number_number[] = {arg_string, arg_number, arg_number};
Ernie Rael51d04d12022-05-04 15:40:22 +01001178static argcheck_T arg3_string_or_dict_bool_dict[] = {arg_string_or_dict_any, arg_bool, arg_dict_any};
zeertzjq825cf812023-08-17 22:55:25 +02001179static argcheck_T arg3_string_or_list_bool_number[] = {arg_string_or_list_any, arg_bool, arg_number};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001180static argcheck_T arg3_string_string_bool[] = {arg_string, arg_string, arg_bool};
1181static argcheck_T arg3_string_string_dict[] = {arg_string, arg_string, arg_dict_any};
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02001182static argcheck_T arg3_string_string_number[] = {arg_string, arg_string, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001183static argcheck_T arg4_number_number_string_any[] = {arg_number, arg_number, arg_string, arg_any};
1184static argcheck_T arg4_string_string_any_string[] = {arg_string, arg_string, arg_any, arg_string};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001185static argcheck_T arg4_string_string_number_string[] = {arg_string, arg_string, arg_number, arg_string};
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01001186static argcheck_T arg4_string_number_bool_bool[] = {arg_string, arg_number, arg_bool, arg_bool};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001187/* Function specific argument types (not covered by the above) */
Ernie Raela8f7f922023-12-14 20:17:04 +01001188static 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 +02001189static 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 +02001190static argcheck_T arg4_browse[] = {arg_bool, arg_string, arg_string, arg_string};
Ernie Raela8f7f922023-12-14 20:17:04 +01001191static argcheck_T arg23_chanexpr[] = {arg_chan_or_job, arg_any, arg_dict_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001192static argcheck_T arg23_chanraw[] = {arg_chan_or_job, arg_string_or_blob, arg_dict_any};
Ernie Raela8f7f922023-12-14 20:17:04 +01001193static argcheck_T arg24_count[] = {arg_string_or_list_or_dict, arg_any, arg_bool, arg_number};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001194static argcheck_T arg13_cursor[] = {arg_cursor1, arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001195static argcheck_T arg12_deepcopy[] = {arg_any, arg_bool};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001196static argcheck_T arg12_execute[] = {arg_string_or_list_string, arg_string};
Bram Moolenaarfa103972022-09-29 19:14:42 +01001197static argcheck_T arg23_extend[] = {arg_list_or_dict_mod, arg_same_as_prev, arg_extend3};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001198static argcheck_T arg23_extendnew[] = {arg_list_or_dict, arg_same_struct_as_prev, arg_extend3};
Ernie Raela8f7f922023-12-14 20:17:04 +01001199static argcheck_T arg23_get[] = {arg_get1, arg_string_or_nr, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001200static argcheck_T arg14_glob[] = {arg_string, arg_bool, arg_bool, arg_bool};
1201static argcheck_T arg25_globpath[] = {arg_string, arg_string, arg_bool, arg_bool, arg_bool};
1202static argcheck_T arg24_index[] = {arg_list_or_blob, arg_item_of_prev, arg_number, arg_bool};
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01001203static argcheck_T arg23_index[] = {arg_list_or_blob, arg_filter_func, arg_dict_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001204static argcheck_T arg23_insert[] = {arg_list_or_blob, arg_item_of_prev, arg_number};
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001205static argcheck_T arg1_len[] = {arg_len1};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001206static argcheck_T arg3_libcall[] = {arg_string, arg_string, arg_string_or_nr};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001207static argcheck_T arg14_maparg[] = {arg_string, arg_string, arg_bool, arg_bool};
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001208static argcheck_T arg2_filter[] = {arg_list_or_dict_or_blob_or_string_mod, arg_filter_func};
Ernie Raele79e2072024-01-13 11:47:33 +01001209static argcheck_T arg2_foreach[] = {arg_list_or_dict_or_blob_or_string, arg_foreach_func};
Ernie Rael2025af12023-12-12 16:58:00 +01001210static argcheck_T arg2_instanceof[] = {arg_object, varargs_class, NULL };
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001211static argcheck_T arg2_map[] = {arg_list_or_dict_or_blob_or_string_mod, arg_map_func};
Ernie Raela8f7f922023-12-14 20:17:04 +01001212static argcheck_T arg2_mapnew[] = {arg_list_or_dict_or_blob_or_string, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001213static argcheck_T arg25_matchadd[] = {arg_string, arg_string, arg_number, arg_number, arg_dict_any};
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001214static argcheck_T arg25_matchaddpos[] = {arg_string, arg_list_any, arg_number, arg_number, arg_dict_any};
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01001215static argcheck_T arg23_matchstrlist[] = {arg_list_string, arg_string, arg_dict_any};
1216static argcheck_T arg45_matchbufline[] = {arg_buffer, arg_string, arg_lnum, arg_lnum, arg_dict_any};
Ernie Raela8f7f922023-12-14 20:17:04 +01001217static 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};
1218static argcheck_T arg23_reduce[] = {arg_string_list_or_blob, arg_any, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001219static argcheck_T arg24_remote_expr[] = {arg_string, arg_string, arg_string, arg_number};
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001220static argcheck_T arg23_remove[] = {arg_list_or_dict_or_blob_mod, arg_remove2, arg_number};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001221static argcheck_T arg2_repeat[] = {arg_repeat1, arg_number};
Bram Moolenaar73199812021-12-26 17:18:14 +00001222static argcheck_T arg15_search[] = {arg_string, arg_string, arg_number, arg_number, arg_string_or_func};
1223static 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 +02001224static argcheck_T arg3_setbufline[] = {arg_buffer, arg_lnum, arg_str_or_nr_or_list};
Ernie Raela8f7f922023-12-14 20:17:04 +01001225static argcheck_T arg2_setline[] = {arg_lnum, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001226static argcheck_T arg24_setloclist[] = {arg_number, arg_list_any, arg_string, arg_dict_any};
1227static argcheck_T arg13_setqflist[] = {arg_list_any, arg_string, arg_dict_any};
1228static argcheck_T arg23_settagstack[] = {arg_number, arg_dict_any, arg_string};
1229static argcheck_T arg02_sign_getplaced[] = {arg_buffer, arg_dict_any};
1230static argcheck_T arg45_sign_place[] = {arg_number, arg_string, arg_string, arg_buffer, arg_dict_any};
1231static argcheck_T arg23_slice[] = {arg_slice1, arg_number, arg_number};
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001232static argcheck_T arg13_sortuniq[] = {arg_list_any_mod, arg_sort_how, arg_dict_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001233static argcheck_T arg24_strpart[] = {arg_string, arg_number, arg_number, arg_bool};
1234static argcheck_T arg12_system[] = {arg_string, arg_str_or_nr_or_list};
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02001235static argcheck_T arg23_win_execute[] = {arg_number, arg_string_or_list_string, arg_string};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001236static argcheck_T arg23_writefile[] = {arg_list_or_blob, arg_string, arg_string};
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02001237static argcheck_T arg24_match_func[] = {arg_string_or_list_any, arg_string, arg_number, arg_number};
Bram Moolenaarcd268012021-07-22 19:11:08 +02001238
Bram Moolenaar32517c42023-01-15 18:17:12 +00001239// Can be used by functions called through "f_retfunc" to create new types.
1240static garray_T *current_type_gap = NULL;
Bram Moolenaar94738d82020-10-21 14:25:07 +02001241
1242/*
1243 * Functions that return the return type of a builtin function.
Bram Moolenaara1224cb2020-10-22 12:31:49 +02001244 * Note that "argtypes" is NULL if "argcount" is zero.
Bram Moolenaar94738d82020-10-21 14:25:07 +02001245 */
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001246 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001247ret_void(int argcount UNUSED,
1248 type2_T *argtypes UNUSED,
1249 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001250{
1251 return &t_void;
1252}
1253 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001254ret_any(int argcount UNUSED,
1255 type2_T *argtypes UNUSED,
1256 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001257{
1258 return &t_any;
1259}
1260 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001261ret_bool(int argcount UNUSED,
1262 type2_T *argtypes UNUSED,
1263 type_T **decl_type UNUSED)
Bram Moolenaar403dc312020-10-17 19:29:51 +02001264{
1265 return &t_bool;
1266}
1267 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001268ret_number_bool(int argcount UNUSED,
1269 type2_T *argtypes UNUSED,
1270 type_T **decl_type UNUSED)
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001271{
1272 return &t_number_bool;
1273}
1274 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001275ret_number(int argcount UNUSED,
1276 type2_T *argtypes UNUSED,
1277 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001278{
1279 return &t_number;
1280}
1281 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001282ret_float(int argcount UNUSED,
1283 type2_T *argtypes UNUSED,
1284 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001285{
1286 return &t_float;
1287}
1288 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001289ret_string(int argcount UNUSED,
1290 type2_T *argtypes UNUSED,
1291 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001292{
1293 return &t_string;
1294}
Bram Moolenaare69f6d02020-04-01 22:11:01 +02001295 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001296ret_list_any(int argcount UNUSED,
1297 type2_T *argtypes UNUSED,
1298 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001299{
1300 return &t_list_any;
1301}
1302 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001303ret_list_number(int argcount UNUSED,
1304 type2_T *argtypes UNUSED,
Bram Moolenaar81330182022-02-01 12:11:58 +00001305 type_T **decl_type)
1306{
Bram Moolenaar81330182022-02-01 12:11:58 +00001307 *decl_type = &t_list_any;
1308 return &t_list_number;
1309}
1310 static type_T *
1311ret_list_string(int argcount UNUSED,
1312 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001313 type_T **decl_type)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001314{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001315 *decl_type = &t_list_any;
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001316 return &t_list_string;
1317}
1318 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001319ret_list_dict_any(int argcount UNUSED,
1320 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001321 type_T **decl_type)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001322{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001323 *decl_type = &t_list_any;
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001324 return &t_list_dict_any;
1325}
1326 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001327ret_list_items(int argcount UNUSED,
1328 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001329 type_T **decl_type)
Bram Moolenaarefc5db52021-07-07 21:21:30 +02001330{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001331 *decl_type = &t_list_any;
Bram Moolenaarefc5db52021-07-07 21:21:30 +02001332 return &t_list_list_any;
1333}
mityu61065042021-07-19 20:07:21 +02001334 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001335ret_list_string_items(int argcount UNUSED,
1336 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001337 type_T **decl_type)
mityu61065042021-07-19 20:07:21 +02001338{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001339 *decl_type = &t_list_any;
mityu61065042021-07-19 20:07:21 +02001340 return &t_list_list_string;
1341}
Bram Moolenaarefc5db52021-07-07 21:21:30 +02001342 static type_T *
zeertzjqd4d12072024-07-16 20:34:16 +02001343ret_list_regionpos(int argcount UNUSED,
1344 type2_T *argtypes UNUSED,
1345 type_T **decl_type)
1346{
1347 *decl_type = &t_list_any;
1348 return &t_list_list_list_number;
1349}
1350 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001351ret_dict_any(int argcount UNUSED,
1352 type2_T *argtypes UNUSED,
1353 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001354{
1355 return &t_dict_any;
1356}
1357 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001358ret_job_info(int argcount,
1359 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001360 type_T **decl_type)
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01001361{
1362 if (argcount == 0)
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001363 {
1364 *decl_type = &t_list_any;
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01001365 return &t_list_job;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001366 }
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01001367 return &t_dict_any;
1368}
1369 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001370ret_dict_number(int argcount UNUSED,
1371 type2_T *argtypes UNUSED,
1372 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001373{
1374 return &t_dict_number;
1375}
1376 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001377ret_dict_string(int argcount UNUSED,
1378 type2_T *argtypes UNUSED,
1379 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001380{
1381 return &t_dict_string;
1382}
1383 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001384ret_blob(int argcount UNUSED,
1385 type2_T *argtypes UNUSED,
1386 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001387{
1388 return &t_blob;
1389}
1390 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001391ret_func_any(int argcount UNUSED,
1392 type2_T *argtypes UNUSED,
1393 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001394{
Bram Moolenaare69f6d02020-04-01 22:11:01 +02001395 return &t_func_any;
1396}
1397 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001398ret_func_unknown(int argcount UNUSED,
1399 type2_T *argtypes UNUSED,
1400 type_T **decl_type UNUSED)
Bram Moolenaar2f9f4cc2021-12-20 09:36:27 +00001401{
1402 return &t_func_unknown;
1403}
1404 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001405ret_channel(int argcount UNUSED,
1406 type2_T *argtypes UNUSED,
1407 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001408{
1409 return &t_channel;
1410}
1411 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001412ret_job(int argcount UNUSED,
1413 type2_T *argtypes UNUSED,
1414 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001415{
1416 return &t_job;
1417}
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001418 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001419ret_first_arg(int argcount,
1420 type2_T *argtypes,
1421 type_T **decl_type)
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001422{
1423 if (argcount > 0)
Bram Moolenaar81330182022-02-01 12:11:58 +00001424 {
1425 *decl_type = argtypes[0].type_decl;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001426 return argtypes[0].type_curr;
Bram Moolenaar81330182022-02-01 12:11:58 +00001427 }
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001428 return &t_void;
1429}
Bram Moolenaar1780f082021-07-31 22:03:59 +02001430 static type_T *
Bram Moolenaar00eb9952022-02-05 19:23:18 +00001431ret_slice(int argcount,
1432 type2_T *argtypes,
1433 type_T **decl_type)
1434{
1435 if (argcount > 0)
1436 {
1437 if (argtypes[0].type_decl != NULL)
1438 {
1439 switch (argtypes[0].type_decl->tt_type)
1440 {
1441 case VAR_STRING: *decl_type = &t_string; break;
1442 case VAR_BLOB: *decl_type = &t_blob; break;
1443 case VAR_LIST: *decl_type = &t_list_any; break;
1444 default: break;
1445 }
1446 }
1447 return argtypes[0].type_curr;
1448 }
1449 return &t_void;
1450}
1451 static type_T *
Bram Moolenaar381692b2022-02-02 20:01:27 +00001452ret_copy(int argcount,
1453 type2_T *argtypes,
1454 type_T **decl_type)
1455{
1456 if (argcount > 0)
1457 {
1458 if (argtypes[0].type_decl != NULL)
1459 {
1460 if (argtypes[0].type_decl->tt_type == VAR_LIST)
1461 *decl_type = &t_list_any;
1462 else if (argtypes[0].type_decl->tt_type == VAR_DICT)
1463 *decl_type = &t_dict_any;
1464 else
1465 *decl_type = argtypes[0].type_decl;
1466 }
1467 if (argtypes[0].type_curr != NULL)
1468 {
1469 if (argtypes[0].type_curr->tt_type == VAR_LIST)
1470 return &t_list_any;
1471 else if (argtypes[0].type_curr->tt_type == VAR_DICT)
1472 return &t_dict_any;
1473 }
1474 return argtypes[0].type_curr;
1475 }
1476 return &t_void;
1477}
1478 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001479ret_extend(int argcount,
1480 type2_T *argtypes,
1481 type_T **decl_type)
1482{
1483 if (argcount > 0)
1484 {
1485 *decl_type = argtypes[0].type_decl;
1486 // if the second argument has a different current type then the current
1487 // type is "any"
1488 if (argcount > 1 && !equal_type(argtypes[0].type_curr,
1489 argtypes[1].type_curr, 0))
1490 {
1491 if (argtypes[0].type_curr->tt_type == VAR_LIST)
1492 return &t_list_any;
1493 if (argtypes[0].type_curr->tt_type == VAR_DICT)
1494 return &t_dict_any;
1495 }
1496 return argtypes[0].type_curr;
1497 }
1498 return &t_void;
1499}
1500 static type_T *
1501ret_repeat(int argcount,
1502 type2_T *argtypes,
1503 type_T **decl_type UNUSED)
Bram Moolenaar1780f082021-07-31 22:03:59 +02001504{
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001505 if (argcount == 0)
1506 return &t_any;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001507 if (argtypes[0].type_curr == &t_number)
Bram Moolenaar1780f082021-07-31 22:03:59 +02001508 return &t_string;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001509 return argtypes[0].type_curr;
Bram Moolenaar1780f082021-07-31 22:03:59 +02001510}
Bram Moolenaarea696852020-11-09 18:31:39 +01001511// for map(): returns first argument but item type may differ
1512 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001513ret_first_cont(int argcount,
1514 type2_T *argtypes,
1515 type_T **decl_type UNUSED)
Bram Moolenaarea696852020-11-09 18:31:39 +01001516{
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001517 if (argcount > 0)
1518 {
Bram Moolenaar078a4612022-01-04 15:17:03 +00001519 if (argtypes[0].type_curr->tt_type == VAR_LIST)
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001520 return &t_list_any;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001521 if (argtypes[0].type_curr->tt_type == VAR_DICT)
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001522 return &t_dict_any;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001523 if (argtypes[0].type_curr->tt_type == VAR_BLOB)
1524 return argtypes[0].type_curr;
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001525 }
Bram Moolenaarea696852020-11-09 18:31:39 +01001526 return &t_any;
1527}
Bram Moolenaar078a4612022-01-04 15:17:03 +00001528// for getline()
1529 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001530ret_getline(int argcount,
1531 type2_T *argtypes UNUSED,
1532 type_T **decl_type UNUSED)
Bram Moolenaar078a4612022-01-04 15:17:03 +00001533{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001534 if (argcount == 1)
1535 return &t_string;
1536 *decl_type = &t_list_any;
1537 return &t_list_string;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001538}
Bram Moolenaar08018222021-12-22 18:45:37 +00001539// for finddir()
1540 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001541ret_finddir(int argcount,
1542 type2_T *argtypes UNUSED,
1543 type_T **decl_type UNUSED)
Bram Moolenaar08018222021-12-22 18:45:37 +00001544{
1545 if (argcount < 3)
1546 return &t_string;
1547 // Depending on the count would be a string or a list of strings.
1548 return &t_any;
1549}
Bram Moolenaar32517c42023-01-15 18:17:12 +00001550// for values(): list of member of first argument
1551 static type_T *
1552ret_list_member(int argcount,
1553 type2_T *argtypes,
1554 type_T **decl_type)
1555{
1556 if (argcount > 0)
1557 {
1558 type_T *t = argtypes[0].type_decl;
1559 if (current_type_gap != NULL
1560 && (t->tt_type == VAR_DICT || t->tt_type == VAR_LIST))
1561 t = get_list_type(t->tt_member, current_type_gap);
1562 else
1563 t = &t_list_any;
1564 *decl_type = t;
1565
1566 t = argtypes[0].type_curr;
1567 if (current_type_gap != NULL
1568 && (t->tt_type == VAR_DICT || t->tt_type == VAR_LIST))
1569 return get_list_type(t->tt_member, current_type_gap);
1570 }
1571 return &t_list_any;
1572}
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001573
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001574/*
1575 * Used for getqflist(): returns list if there is no argument, dict if there is
1576 * one.
1577 */
1578 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001579ret_list_or_dict_0(int argcount,
1580 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001581 type_T **decl_type)
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001582{
1583 if (argcount > 0)
1584 return &t_dict_any;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001585 *decl_type = &t_list_any;
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001586 return &t_list_dict_any;
1587}
1588
1589/*
1590 * Used for getloclist(): returns list if there is one argument, dict if there
1591 * are two.
1592 */
1593 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001594ret_list_or_dict_1(int argcount,
1595 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001596 type_T **decl_type)
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001597{
1598 if (argcount > 1)
1599 return &t_dict_any;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001600 *decl_type = &t_list_any;
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001601 return &t_list_dict_any;
1602}
1603
Bram Moolenaar846178a2020-07-05 17:04:13 +02001604 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001605ret_argv(int argcount,
1606 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001607 type_T **decl_type)
Bram Moolenaar846178a2020-07-05 17:04:13 +02001608{
1609 // argv() returns list of strings
1610 if (argcount == 0)
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001611 {
1612 *decl_type = &t_list_any;
Bram Moolenaar846178a2020-07-05 17:04:13 +02001613 return &t_list_string;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001614 }
Bram Moolenaar846178a2020-07-05 17:04:13 +02001615
1616 // argv(0) returns a string, but argv(-1] returns a list
1617 return &t_any;
1618}
1619
Bram Moolenaarad7c2492020-07-05 20:55:29 +02001620 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001621ret_remove(int argcount,
1622 type2_T *argtypes,
Bram Moolenaar2ac037f2022-05-09 14:12:14 +01001623 type_T **decl_type)
Bram Moolenaarad7c2492020-07-05 20:55:29 +02001624{
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001625 if (argcount > 0)
Bram Moolenaar5e654232020-09-16 15:22:00 +02001626 {
Bram Moolenaar078a4612022-01-04 15:17:03 +00001627 if (argtypes[0].type_curr->tt_type == VAR_LIST
1628 || argtypes[0].type_curr->tt_type == VAR_DICT)
Bram Moolenaar81330182022-02-01 12:11:58 +00001629 {
Bram Moolenaar2ac037f2022-05-09 14:12:14 +01001630 if (argcount == 3)
1631 {
1632 *decl_type = argtypes[0].type_decl;
1633 return argtypes[0].type_curr;
1634 }
Bram Moolenaar81330182022-02-01 12:11:58 +00001635 if (argtypes[0].type_curr->tt_type
1636 == argtypes[0].type_decl->tt_type)
1637 *decl_type = argtypes[0].type_decl->tt_member;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001638 return argtypes[0].type_curr->tt_member;
Bram Moolenaar81330182022-02-01 12:11:58 +00001639 }
Bram Moolenaar078a4612022-01-04 15:17:03 +00001640 if (argtypes[0].type_curr->tt_type == VAR_BLOB)
Bram Moolenaar5e654232020-09-16 15:22:00 +02001641 return &t_number;
1642 }
Bram Moolenaarad7c2492020-07-05 20:55:29 +02001643 return &t_any;
1644}
1645
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001646 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001647ret_getreg(int argcount,
1648 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001649 type_T **decl_type)
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001650{
1651 // Assume that if the third argument is passed it's non-zero
1652 if (argcount == 3)
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001653 {
1654 *decl_type = &t_list_any;
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001655 return &t_list_string;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001656 }
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001657 return &t_string;
1658}
1659
Bram Moolenaar4a6d1b62020-08-08 17:55:49 +02001660 static type_T *
LemonBoy0f7a3e12022-05-26 12:10:37 +01001661ret_virtcol(int argcount,
1662 type2_T *argtypes UNUSED,
1663 type_T **decl_type)
1664{
1665 // Assume that if the second argument is passed it's non-zero
zeertzjq825cf812023-08-17 22:55:25 +02001666 if (argcount > 1)
LemonBoy0f7a3e12022-05-26 12:10:37 +01001667 {
1668 *decl_type = &t_list_any;
1669 return &t_list_number;
1670 }
1671 return &t_number;
1672}
1673
1674 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001675ret_maparg(int argcount,
1676 type2_T *argtypes UNUSED,
1677 type_T **decl_type UNUSED)
Bram Moolenaar4a6d1b62020-08-08 17:55:49 +02001678{
1679 // Assume that if the fourth argument is passed it's non-zero
1680 if (argcount == 4)
1681 return &t_dict_any;
1682 return &t_string;
1683}
1684
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001685/*
1686 * Array with names and number of arguments of all internal functions
1687 * MUST BE KEPT SORTED IN strcmp() ORDER FOR BINARY SEARCH!
Ernie Rael2025af12023-12-12 16:58:00 +01001688 *
Ernie Raela8f7f922023-12-14 20:17:04 +01001689 * The builtin function may be varargs. In that case
Ernie Rael2025af12023-12-12 16:58:00 +01001690 * - f_max_argc == VARGS
Ernie Raela8f7f922023-12-14 20:17:04 +01001691 * - For varargs, f_argcheck must be NULL terminated. The last non-null
1692 * entry in f_argcheck should validate all the remaining args.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001693 */
Bram Moolenaarac92e252019-08-03 21:58:38 +02001694typedef struct
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001695{
Bram Moolenaar25e42232019-08-04 15:04:10 +02001696 char *f_name; // function name
1697 char f_min_argc; // minimal number of arguments
1698 char f_max_argc; // maximal number of arguments
Ernie Raeld8bf87c2023-12-16 14:03:33 +01001699 char f_argtype; // for method: FEARG_ values; bits FE_
Ernie Raela8f7f922023-12-14 20:17:04 +01001700 argcheck_T *f_argcheck; // list of functions to check argument types;
1701 // use "arg_any" (not NULL) to accept an
1702 // argument of any type
Bram Moolenaar81330182022-02-01 12:11:58 +00001703 type_T *(*f_retfunc)(int argcount, type2_T *argtypes,
1704 type_T **decl_type);
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001705 // return type function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001706 void (*f_func)(typval_T *args, typval_T *rvar);
Bram Moolenaar25e42232019-08-04 15:04:10 +02001707 // implementation of function
Bram Moolenaarac92e252019-08-03 21:58:38 +02001708} funcentry_T;
1709
Ernie Rael2025af12023-12-12 16:58:00 +01001710// Set f_max_argc to VARGS for varargs.
1711#define VARGS CHAR_MAX
1712
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02001713// values for f_argtype; zero means it cannot be used as a method
Ernie Raeld8bf87c2023-12-16 14:03:33 +01001714#define FEARG_1 0x01 // base is the first argument
1715#define FEARG_2 0x02 // base is the second argument
1716#define FEARG_3 0x03 // base is the third argument
1717#define FEARG_4 0x04 // base is the fourth argument
1718#define FEARG_MASK 0x0F // bits in f_argtype used as argument index
1719#define FE_X 0x10 // builtin accepts a non-value (class, typealias)
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02001720
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001721#if defined(HAVE_MATH_H)
Bram Moolenaar15c47602020-03-26 22:16:48 +01001722# define MATH_FUNC(name) name
1723#else
1724# define MATH_FUNC(name) NULL
1725#endif
1726#ifdef FEAT_TIMERS
1727# define TIMER_FUNC(name) name
1728#else
1729# define TIMER_FUNC(name) NULL
1730#endif
1731#ifdef FEAT_JOB_CHANNEL
1732# define JOB_FUNC(name) name
1733#else
1734# define JOB_FUNC(name) NULL
1735#endif
1736#ifdef FEAT_PROP_POPUP
1737# define PROP_FUNC(name) name
1738#else
1739# define PROP_FUNC(name) NULL
1740#endif
1741#ifdef FEAT_SIGNS
1742# define SIGN_FUNC(name) name
1743#else
1744# define SIGN_FUNC(name) NULL
1745#endif
1746#ifdef FEAT_SOUND
1747# define SOUND_FUNC(name) name
1748#else
1749# define SOUND_FUNC(name) NULL
1750#endif
1751#ifdef FEAT_TERMINAL
1752# define TERM_FUNC(name) name
1753#else
1754# define TERM_FUNC(name) NULL
1755#endif
1756
Bram Moolenaarac92e252019-08-03 21:58:38 +02001757static funcentry_T global_functions[] =
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001758{
Bram Moolenaar94738d82020-10-21 14:25:07 +02001759 {"abs", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001760 ret_any, f_abs},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001761 {"acos", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001762 ret_float, f_acos},
Bram Moolenaarfa103972022-09-29 19:14:42 +01001763 {"add", 2, 2, FEARG_1, arg2_listblobmod_item,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001764 ret_first_arg, f_add},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001765 {"and", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001766 ret_number, f_and},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001767 {"append", 2, 2, FEARG_2, arg2_setline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001768 ret_number_bool, f_append},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001769 {"appendbufline", 3, 3, FEARG_3, arg3_setbufline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001770 ret_number_bool, f_appendbufline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001771 {"argc", 0, 1, 0, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001772 ret_number, f_argc},
1773 {"argidx", 0, 0, 0, NULL,
1774 ret_number, f_argidx},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001775 {"arglistid", 0, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001776 ret_number, f_arglistid},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001777 {"argv", 0, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001778 ret_argv, f_argv},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001779 {"asin", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001780 ret_float, f_asin},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001781 {"assert_beeps", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001782 ret_number_bool, f_assert_beeps},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001783 {"assert_equal", 2, 3, FEARG_2, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001784 ret_number_bool, f_assert_equal},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001785 {"assert_equalfile", 2, 3, FEARG_1, arg3_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001786 ret_number_bool, f_assert_equalfile},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001787 {"assert_exception", 1, 2, 0, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001788 ret_number_bool, f_assert_exception},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001789 {"assert_fails", 1, 5, FEARG_1, arg15_assert_fails,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001790 ret_number_bool, f_assert_fails},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001791 {"assert_false", 1, 2, FEARG_1, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001792 ret_number_bool, f_assert_false},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001793 {"assert_inrange", 3, 4, FEARG_3, arg34_assert_inrange,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001794 ret_number_bool, f_assert_inrange},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001795 {"assert_match", 2, 3, FEARG_2, arg3_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001796 ret_number_bool, f_assert_match},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001797 {"assert_nobeep", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar5b8cabf2021-04-02 18:55:57 +02001798 ret_number_bool, f_assert_nobeep},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001799 {"assert_notequal", 2, 3, FEARG_2, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001800 ret_number_bool, f_assert_notequal},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001801 {"assert_notmatch", 2, 3, FEARG_2, arg3_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001802 ret_number_bool, f_assert_notmatch},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02001803 {"assert_report", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001804 ret_number_bool, f_assert_report},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001805 {"assert_true", 1, 2, FEARG_1, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001806 ret_number_bool, f_assert_true},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001807 {"atan", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001808 ret_float, f_atan},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001809 {"atan2", 2, 2, FEARG_1, arg2_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001810 ret_float, f_atan2},
Yegappan Lakshmanan1755a912022-05-19 10:31:47 +01001811 {"autocmd_add", 1, 1, FEARG_1, arg1_list_any,
1812 ret_number_bool, f_autocmd_add},
1813 {"autocmd_delete", 1, 1, FEARG_1, arg1_list_any,
1814 ret_number_bool, f_autocmd_delete},
1815 {"autocmd_get", 0, 1, FEARG_1, arg1_dict_any,
1816 ret_list_dict_any, f_autocmd_get},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001817 {"balloon_gettext", 0, 0, 0, NULL,
1818 ret_string,
Bram Moolenaar59716a22017-03-01 20:32:44 +01001819#ifdef FEAT_BEVAL
Bram Moolenaar15c47602020-03-26 22:16:48 +01001820 f_balloon_gettext
1821#else
1822 NULL
Bram Moolenaar59716a22017-03-01 20:32:44 +01001823#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01001824 },
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02001825 {"balloon_show", 1, 1, FEARG_1, arg1_string_or_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001826 ret_void,
Bram Moolenaar15c47602020-03-26 22:16:48 +01001827#ifdef FEAT_BEVAL
1828 f_balloon_show
1829#else
1830 NULL
1831#endif
1832 },
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001833 {"balloon_split", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001834 ret_list_string,
Bram Moolenaar15c47602020-03-26 22:16:48 +01001835#if defined(FEAT_BEVAL_TERM)
1836 f_balloon_split
1837#else
1838 NULL
1839#endif
1840 },
Yegappan Lakshmanan810785c2024-12-30 10:29:44 +01001841 {"base64_decode", 1, 1, FEARG_1, arg1_string,
1842 ret_blob, f_base64_decode},
1843 {"base64_encode", 1, 1, FEARG_1, arg1_blob,
1844 ret_string, f_base64_encode},
Christ van Willegence0ef912024-06-20 23:41:59 +02001845 {"bindtextdomain", 2, 2, 0, arg2_string,
Christ van Willegen8252ef12024-07-11 21:36:21 +02001846 ret_bool, f_bindtextdomain},
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +02001847 {"blob2list", 1, 1, FEARG_1, arg1_blob,
1848 ret_list_number, f_blob2list},
Yegappan Lakshmanan1aefe1d2025-01-14 17:29:42 +01001849 {"blob2str", 1, 2, FEARG_1, arg2_blob_dict,
1850 ret_string, f_blob2str},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001851 {"browse", 4, 4, 0, arg4_browse,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001852 ret_string, f_browse},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001853 {"browsedir", 2, 2, 0, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001854 ret_string, f_browsedir},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001855 {"bufadd", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001856 ret_number, f_bufadd},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001857 {"bufexists", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001858 ret_number_bool, f_bufexists},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001859 {"buffer_exists", 1, 1, FEARG_1, arg1_buffer, // obsolete
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001860 ret_number_bool, f_bufexists},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001861 {"buffer_name", 0, 1, FEARG_1, arg1_buffer, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02001862 ret_string, f_bufname},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001863 {"buffer_number", 0, 1, FEARG_1, arg1_buffer, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02001864 ret_number, f_bufnr},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001865 {"buflisted", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001866 ret_number_bool, f_buflisted},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001867 {"bufload", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001868 ret_void, f_bufload},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001869 {"bufloaded", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001870 ret_number_bool, f_bufloaded},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001871 {"bufname", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001872 ret_string, f_bufname},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001873 {"bufnr", 0, 2, FEARG_1, arg2_buffer_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001874 ret_number, f_bufnr},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001875 {"bufwinid", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001876 ret_number, f_bufwinid},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001877 {"bufwinnr", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001878 ret_number, f_bufwinnr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001879 {"byte2line", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001880 ret_number, f_byte2line},
Christian Brabandt67672ef2023-04-24 21:09:54 +01001881 {"byteidx", 2, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001882 ret_number, f_byteidx},
Christian Brabandt67672ef2023-04-24 21:09:54 +01001883 {"byteidxcomp", 2, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001884 ret_number, f_byteidxcomp},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001885 {"call", 2, 3, FEARG_1, arg3_any_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001886 ret_any, f_call},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001887 {"ceil", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001888 ret_float, f_ceil},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001889 {"ch_canread", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001890 ret_number_bool, JOB_FUNC(f_ch_canread)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001891 {"ch_close", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001892 ret_void, JOB_FUNC(f_ch_close)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001893 {"ch_close_in", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001894 ret_void, JOB_FUNC(f_ch_close_in)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001895 {"ch_evalexpr", 2, 3, FEARG_1, arg23_chanexpr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001896 ret_any, JOB_FUNC(f_ch_evalexpr)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001897 {"ch_evalraw", 2, 3, FEARG_1, arg23_chanraw,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001898 ret_any, JOB_FUNC(f_ch_evalraw)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001899 {"ch_getbufnr", 2, 2, FEARG_1, arg2_chan_or_job_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001900 ret_number, JOB_FUNC(f_ch_getbufnr)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001901 {"ch_getjob", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001902 ret_job, JOB_FUNC(f_ch_getjob)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001903 {"ch_info", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001904 ret_dict_any, JOB_FUNC(f_ch_info)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001905 {"ch_log", 1, 2, FEARG_1, arg2_string_chan_or_job,
Bram Moolenaar4c5678f2022-11-30 18:12:19 +00001906 ret_void, f_ch_log},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001907 {"ch_logfile", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar4c5678f2022-11-30 18:12:19 +00001908 ret_void, f_ch_logfile},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001909 {"ch_open", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001910 ret_channel, JOB_FUNC(f_ch_open)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001911 {"ch_read", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001912 ret_string, JOB_FUNC(f_ch_read)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001913 {"ch_readblob", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001914 ret_blob, JOB_FUNC(f_ch_readblob)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001915 {"ch_readraw", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001916 ret_string, JOB_FUNC(f_ch_readraw)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001917 {"ch_sendexpr", 2, 3, FEARG_1, arg23_chanexpr,
Yegappan Lakshmanan3b470ae2022-04-16 10:41:27 +01001918 ret_any, JOB_FUNC(f_ch_sendexpr)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001919 {"ch_sendraw", 2, 3, FEARG_1, arg23_chanraw,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001920 ret_void, JOB_FUNC(f_ch_sendraw)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001921 {"ch_setoptions", 2, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001922 ret_void, JOB_FUNC(f_ch_setoptions)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001923 {"ch_status", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001924 ret_string, JOB_FUNC(f_ch_status)},
1925 {"changenr", 0, 0, 0, NULL,
1926 ret_number, f_changenr},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02001927 {"char2nr", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001928 ret_number, f_char2nr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001929 {"charclass", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001930 ret_number, f_charclass},
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00001931 {"charcol", 1, 2, FEARG_1, arg2_string_or_list_number,
Bram Moolenaar6f02b002021-01-10 20:22:54 +01001932 ret_number, f_charcol},
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01001933 {"charidx", 2, 4, FEARG_1, arg4_string_number_bool_bool,
Bram Moolenaar17793ef2020-12-28 12:56:58 +01001934 ret_number, f_charidx},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001935 {"chdir", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001936 ret_string, f_chdir},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001937 {"cindent", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001938 ret_number, f_cindent},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001939 {"clearmatches", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001940 ret_void, f_clearmatches},
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00001941 {"col", 1, 2, FEARG_1, arg2_string_or_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001942 ret_number, f_col},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001943 {"complete", 2, 2, FEARG_2, arg2_number_list,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001944 ret_void, f_complete},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001945 {"complete_add", 1, 1, FEARG_1, arg1_dict_or_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001946 ret_number, f_complete_add},
1947 {"complete_check", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001948 ret_number_bool, f_complete_check},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001949 {"complete_info", 0, 1, FEARG_1, arg1_list_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001950 ret_dict_any, f_complete_info},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001951 {"confirm", 1, 4, FEARG_1, arg4_string_string_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001952 ret_number, f_confirm},
1953 {"copy", 1, 1, FEARG_1, NULL,
Bram Moolenaar381692b2022-02-02 20:01:27 +00001954 ret_copy, f_copy},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001955 {"cos", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001956 ret_float, f_cos},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001957 {"cosh", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001958 ret_float, f_cosh},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001959 {"count", 2, 4, FEARG_1, arg24_count,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001960 ret_number, f_count},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001961 {"cscope_connection",0,3, 0, arg3_number_string_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001962 ret_number, f_cscope_connection},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001963 {"cursor", 1, 3, FEARG_1, arg13_cursor,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001964 ret_number, f_cursor},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001965 {"debugbreak", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001966 ret_number,
Bram Moolenaar4f974752019-02-17 17:44:42 +01001967#ifdef MSWIN
Bram Moolenaar15c47602020-03-26 22:16:48 +01001968 f_debugbreak
1969#else
1970 NULL
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02001971#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01001972 },
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001973 {"deepcopy", 1, 2, FEARG_1, arg12_deepcopy,
Bram Moolenaar381692b2022-02-02 20:01:27 +00001974 ret_copy, f_deepcopy},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001975 {"delete", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001976 ret_number_bool, f_delete},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001977 {"deletebufline", 2, 3, FEARG_1, arg3_buffer_lnum_lnum,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001978 ret_number_bool, f_deletebufline},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001979 {"did_filetype", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001980 ret_number_bool, f_did_filetype},
Yegappan Lakshmananfa378352024-02-01 22:05:27 +01001981 {"diff", 2, 3, FEARG_1, arg3_diff,
Yegappan Lakshmanana0010a12024-02-12 20:21:26 +01001982 ret_any, f_diff},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001983 {"diff_filler", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001984 ret_number, f_diff_filler},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001985 {"diff_hlID", 2, 2, FEARG_1, arg2_lnum_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001986 ret_number, f_diff_hlID},
h-east29b85712021-07-26 21:54:04 +02001987 {"digraph_get", 1, 1, FEARG_1, arg1_string,
1988 ret_string, f_digraph_get},
zeertzjqd4d12072024-07-16 20:34:16 +02001989 {"digraph_getlist", 0, 1, FEARG_1, arg1_bool,
h-east29b85712021-07-26 21:54:04 +02001990 ret_list_string_items, f_digraph_getlist},
Yegappan Lakshmananfc3b7752021-09-08 14:57:42 +02001991 {"digraph_set", 2, 2, FEARG_1, arg2_string,
h-east29b85712021-07-26 21:54:04 +02001992 ret_bool, f_digraph_set},
zeertzjqd4d12072024-07-16 20:34:16 +02001993 {"digraph_setlist", 1, 1, FEARG_1, arg1_list_string,
h-east29b85712021-07-26 21:54:04 +02001994 ret_bool, f_digraph_setlist},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001995 {"echoraw", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001996 ret_void, f_echoraw},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001997 {"empty", 1, 1, FEARG_1, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001998 ret_number_bool, f_empty},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001999 {"environ", 0, 0, 0, NULL,
2000 ret_dict_string, f_environ},
Bram Moolenaar80adaa82023-07-07 18:57:40 +01002001 {"err_teapot", 0, 1, 0, NULL,
2002 ret_number_bool, f_err_teapot},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002003 {"escape", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002004 ret_string, f_escape},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002005 {"eval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002006 ret_any, f_eval},
2007 {"eventhandler", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002008 ret_number_bool, f_eventhandler},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002009 {"executable", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002010 ret_number, f_executable},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002011 {"execute", 1, 2, FEARG_1, arg12_execute,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002012 ret_string, f_execute},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002013 {"exepath", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002014 ret_string, f_exepath},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002015 {"exists", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002016 ret_number_bool, f_exists},
Bram Moolenaar26735992021-08-08 14:43:22 +02002017 {"exists_compiled", 1, 1, FEARG_1, arg1_string,
2018 ret_number_bool, f_exists_compiled},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002019 {"exp", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002020 ret_float, f_exp},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002021 {"expand", 1, 3, FEARG_1, arg3_string_bool_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002022 ret_any, f_expand},
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01002023 {"expandcmd", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002024 ret_string, f_expandcmd},
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01002025 {"extend", 2, 3, FEARG_1, arg23_extend,
Bram Moolenaar81330182022-02-01 12:11:58 +00002026 ret_extend, f_extend},
Bram Moolenaarb0e6b512021-01-12 20:23:40 +01002027 {"extendnew", 2, 3, FEARG_1, arg23_extendnew,
2028 ret_first_cont, f_extendnew},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002029 {"feedkeys", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002030 ret_void, f_feedkeys},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002031 {"file_readable", 1, 1, FEARG_1, arg1_string, // obsolete
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002032 ret_number_bool, f_filereadable},
Shougo Matsushita60c87432024-06-03 22:59:27 +02002033 {"filecopy", 2, 2, FEARG_1, arg2_string,
2034 ret_number_bool, f_filecopy},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002035 {"filereadable", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002036 ret_number_bool, f_filereadable},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002037 {"filewritable", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002038 ret_number, f_filewritable},
Bram Moolenaar18024052021-12-25 21:43:28 +00002039 {"filter", 2, 2, FEARG_1, arg2_filter,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002040 ret_first_arg, f_filter},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002041 {"finddir", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar08018222021-12-22 18:45:37 +00002042 ret_finddir, f_finddir},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002043 {"findfile", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar10c83dd2021-09-04 14:49:56 +02002044 ret_any, f_findfile},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002045 {"flatten", 1, 2, FEARG_1, arg2_list_any_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002046 ret_list_any, f_flatten},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002047 {"flattennew", 1, 2, FEARG_1, arg2_list_any_number,
Bram Moolenaar3b690062021-02-01 20:14:51 +01002048 ret_list_any, f_flattennew},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002049 {"float2nr", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002050 ret_number, f_float2nr},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002051 {"floor", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002052 ret_float, f_floor},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002053 {"fmod", 2, 2, FEARG_1, arg2_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002054 ret_float, f_fmod},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002055 {"fnameescape", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002056 ret_string, f_fnameescape},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002057 {"fnamemodify", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002058 ret_string, f_fnamemodify},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002059 {"foldclosed", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002060 ret_number, f_foldclosed},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002061 {"foldclosedend", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002062 ret_number, f_foldclosedend},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002063 {"foldlevel", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002064 ret_number, f_foldlevel},
2065 {"foldtext", 0, 0, 0, NULL,
2066 ret_string, f_foldtext},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002067 {"foldtextresult", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002068 ret_string, f_foldtextresult},
Ernie Raele79e2072024-01-13 11:47:33 +01002069 {"foreach", 2, 2, FEARG_1, arg2_foreach,
2070 ret_first_arg, f_foreach},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002071 {"foreground", 0, 0, 0, NULL,
2072 ret_void, f_foreground},
Bram Moolenaardd44b582022-09-15 22:03:57 +01002073 {"fullcommand", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar038e09e2021-02-06 12:38:51 +01002074 ret_string, f_fullcommand},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002075 {"funcref", 1, 3, FEARG_1, arg3_any_list_dict,
Bram Moolenaar2f9f4cc2021-12-20 09:36:27 +00002076 ret_func_unknown, f_funcref},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002077 {"function", 1, 3, FEARG_1, arg3_any_list_dict,
Bram Moolenaar2f9f4cc2021-12-20 09:36:27 +00002078 ret_func_unknown, f_function},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002079 {"garbagecollect", 0, 1, 0, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002080 ret_void, f_garbagecollect},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002081 {"get", 2, 3, FEARG_1, arg23_get,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002082 ret_any, f_get},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002083 {"getbufinfo", 0, 1, FEARG_1, arg1_buffer_or_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002084 ret_list_dict_any, f_getbufinfo},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002085 {"getbufline", 2, 3, FEARG_1, arg3_buffer_lnum_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002086 ret_list_string, f_getbufline},
Bram Moolenaarce30ccc2022-11-21 19:57:04 +00002087 {"getbufoneline", 2, 2, FEARG_1, arg2_buffer_lnum,
2088 ret_string, f_getbufoneline},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002089 {"getbufvar", 2, 3, FEARG_1, arg3_buffer_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002090 ret_any, f_getbufvar},
mikoto20001083cae2024-11-11 21:24:14 +01002091 {"getcellpixels", 0, 0, 0, NULL,
mikoto2000a73dfc22024-11-18 21:12:21 +01002092 ret_list_any, f_getcellpixels},
Kota Kato66bb9ae2023-01-17 18:31:56 +00002093 {"getcellwidths", 0, 0, 0, NULL,
2094 ret_list_any, f_getcellwidths},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002095 {"getchangelist", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002096 ret_list_any, f_getchangelist},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002097 {"getchar", 0, 1, 0, arg1_bool,
Bram Moolenaar3a7503c2021-06-07 18:29:17 +02002098 ret_any, f_getchar},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002099 {"getcharmod", 0, 0, 0, NULL,
2100 ret_number, f_getcharmod},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002101 {"getcharpos", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar6f02b002021-01-10 20:22:54 +01002102 ret_list_number, f_getcharpos},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002103 {"getcharsearch", 0, 0, 0, NULL,
2104 ret_dict_any, f_getcharsearch},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002105 {"getcharstr", 0, 1, 0, arg1_bool,
Bram Moolenaar3a7503c2021-06-07 18:29:17 +02002106 ret_string, f_getcharstr},
Ruslan Russkikh0407d622024-10-08 22:21:05 +02002107 {"getcmdcomplpat", 0, 0, 0, NULL,
2108 ret_string, f_getcmdcomplpat},
Shougo Matsushita79d599b2022-05-07 12:48:29 +01002109 {"getcmdcompltype", 0, 0, 0, NULL,
2110 ret_string, f_getcmdcompltype},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002111 {"getcmdline", 0, 0, 0, NULL,
2112 ret_string, f_getcmdline},
2113 {"getcmdpos", 0, 0, 0, NULL,
2114 ret_number, f_getcmdpos},
Shougo Matsushita69084282024-09-23 20:34:47 +02002115 {"getcmdprompt", 0, 0, 0, NULL,
2116 ret_string, f_getcmdprompt},
Shougo Matsushita79d599b2022-05-07 12:48:29 +01002117 {"getcmdscreenpos", 0, 0, 0, NULL,
2118 ret_number, f_getcmdscreenpos},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002119 {"getcmdtype", 0, 0, 0, NULL,
2120 ret_string, f_getcmdtype},
2121 {"getcmdwintype", 0, 0, 0, NULL,
2122 ret_string, f_getcmdwintype},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002123 {"getcompletion", 2, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002124 ret_list_string, f_getcompletion},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002125 {"getcurpos", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002126 ret_list_number, f_getcurpos},
Bram Moolenaar82e46e52022-02-05 18:12:34 +00002127 {"getcursorcharpos", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar6f02b002021-01-10 20:22:54 +01002128 ret_list_number, f_getcursorcharpos},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002129 {"getcwd", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002130 ret_string, f_getcwd},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002131 {"getenv", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar7ad67d12021-03-10 16:08:26 +01002132 ret_any, f_getenv},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002133 {"getfontname", 0, 1, 0, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002134 ret_string, f_getfontname},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002135 {"getfperm", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002136 ret_string, f_getfperm},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002137 {"getfsize", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002138 ret_number, f_getfsize},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002139 {"getftime", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002140 ret_number, f_getftime},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002141 {"getftype", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002142 ret_string, f_getftype},
2143 {"getimstatus", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002144 ret_number_bool, f_getimstatus},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002145 {"getjumplist", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002146 ret_list_any, f_getjumplist},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002147 {"getline", 1, 2, FEARG_1, arg2_lnum,
Bram Moolenaar078a4612022-01-04 15:17:03 +00002148 ret_getline, f_getline},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002149 {"getloclist", 1, 2, 0, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002150 ret_list_or_dict_1, f_getloclist},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002151 {"getmarklist", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002152 ret_list_dict_any, f_getmarklist},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002153 {"getmatches", 0, 1, 0, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002154 ret_list_dict_any, f_getmatches},
2155 {"getmousepos", 0, 0, 0, NULL,
2156 ret_dict_number, f_getmousepos},
Bram Moolenaar24dc19c2022-11-14 19:49:15 +00002157 {"getmouseshape", 0, 0, 0, NULL,
2158 ret_string, f_getmouseshape},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002159 {"getpid", 0, 0, 0, NULL,
2160 ret_number, f_getpid},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002161 {"getpos", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002162 ret_list_number, f_getpos},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002163 {"getqflist", 0, 1, 0, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002164 ret_list_or_dict_0, f_getqflist},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002165 {"getreg", 0, 3, FEARG_1, arg3_string_bool_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002166 ret_getreg, f_getreg},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002167 {"getreginfo", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002168 ret_dict_any, f_getreginfo},
Shougo Matsushita19b71882024-02-28 22:48:12 +01002169 {"getregion", 2, 3, FEARG_1, arg3_list_list_dict,
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01002170 ret_list_string, f_getregion},
zeertzjqd4d12072024-07-16 20:34:16 +02002171 {"getregionpos", 2, 3, FEARG_1, arg3_list_list_dict,
2172 ret_list_regionpos, f_getregionpos},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002173 {"getregtype", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002174 ret_string, f_getregtype},
Yegappan Lakshmanan520f6ef2022-08-25 17:40:40 +01002175 {"getscriptinfo", 0, 1, 0, arg1_dict_any,
Yegappan Lakshmananf768c3d2022-08-22 13:15:13 +01002176 ret_list_dict_any, f_getscriptinfo},
ichizok663d18d2025-01-02 18:06:00 +01002177 {"getstacktrace", 0, 0, 0, NULL,
2178 ret_list_dict_any, f_getstacktrace},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002179 {"gettabinfo", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002180 ret_list_dict_any, f_gettabinfo},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002181 {"gettabvar", 2, 3, FEARG_1, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002182 ret_any, f_gettabvar},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002183 {"gettabwinvar", 3, 4, FEARG_1, arg4_number_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002184 ret_any, f_gettabwinvar},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002185 {"gettagstack", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002186 ret_dict_any, f_gettagstack},
Christ van Willegence0ef912024-06-20 23:41:59 +02002187 {"gettext", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002188 ret_string, f_gettext},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002189 {"getwininfo", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002190 ret_list_dict_any, f_getwininfo},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002191 {"getwinpos", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002192 ret_list_number, f_getwinpos},
2193 {"getwinposx", 0, 0, 0, NULL,
2194 ret_number, f_getwinposx},
2195 {"getwinposy", 0, 0, 0, NULL,
2196 ret_number, f_getwinposy},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002197 {"getwinvar", 2, 3, FEARG_1, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002198 ret_any, f_getwinvar},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002199 {"glob", 1, 4, FEARG_1, arg14_glob,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002200 ret_any, f_glob},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002201 {"glob2regpat", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002202 ret_string, f_glob2regpat},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002203 {"globpath", 2, 5, FEARG_2, arg25_globpath,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002204 ret_any, f_globpath},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002205 {"has", 1, 2, 0, arg2_string_bool,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002206 ret_number_bool, f_has},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002207 {"has_key", 2, 2, FEARG_1, arg2_dict_any_string_or_nr,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002208 ret_number_bool, f_has_key},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002209 {"haslocaldir", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002210 ret_number, f_haslocaldir},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002211 {"hasmapto", 1, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002212 ret_number_bool, f_hasmapto},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002213 {"highlightID", 1, 1, FEARG_1, arg1_string, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02002214 ret_number, f_hlID},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002215 {"highlight_exists",1, 1, FEARG_1, arg1_string, // obsolete
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002216 ret_number_bool, f_hlexists},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002217 {"histadd", 2, 2, FEARG_2, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002218 ret_number_bool, f_histadd},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002219 {"histdel", 1, 2, FEARG_1, arg2_string_string_or_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002220 ret_number_bool, f_histdel},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002221 {"histget", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002222 ret_string, f_histget},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002223 {"histnr", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002224 ret_number, f_histnr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002225 {"hlID", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002226 ret_number, f_hlID},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002227 {"hlexists", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002228 ret_number_bool, f_hlexists},
Yegappan Lakshmanand1a8d652021-11-03 21:56:45 +00002229 {"hlget", 0, 2, FEARG_1, arg2_string_bool,
2230 ret_list_dict_any, f_hlget},
2231 {"hlset", 1, 1, FEARG_1, arg1_list_any,
2232 ret_number_bool, f_hlset},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002233 {"hostname", 0, 0, 0, NULL,
2234 ret_string, f_hostname},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002235 {"iconv", 3, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002236 ret_string, f_iconv},
Ernie Raelc8e158b2024-07-09 18:39:52 +02002237 {"id", 1, 1, FEARG_1, NULL,
2238 ret_string, f_id},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002239 {"indent", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002240 ret_number, f_indent},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002241 {"index", 2, 4, FEARG_1, arg24_index,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002242 ret_number, f_index},
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01002243 {"indexof", 2, 3, FEARG_1, arg23_index,
2244 ret_number, f_indexof},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002245 {"input", 1, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002246 ret_string, f_input},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002247 {"inputdialog", 1, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002248 ret_string, f_inputdialog},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002249 {"inputlist", 1, 1, FEARG_1, arg1_list_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002250 ret_number, f_inputlist},
2251 {"inputrestore", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002252 ret_number_bool, f_inputrestore},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002253 {"inputsave", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002254 ret_number_bool, f_inputsave},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002255 {"inputsecret", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002256 ret_string, f_inputsecret},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002257 {"insert", 2, 3, FEARG_1, arg23_insert,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002258 ret_first_arg, f_insert},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002259 {"instanceof", 2, VARGS, FEARG_1|FE_X, arg2_instanceof,
LemonBoyafe04662023-08-23 21:08:11 +02002260 ret_bool, f_instanceof},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002261 {"interrupt", 0, 0, 0, NULL,
2262 ret_void, f_interrupt},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002263 {"invert", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002264 ret_number, f_invert},
LemonBoydca1d402022-04-28 15:26:33 +01002265 {"isabsolutepath", 1, 1, FEARG_1, arg1_string,
2266 ret_number_bool, f_isabsolutepath},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002267 {"isdirectory", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002268 ret_number_bool, f_isdirectory},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002269 {"isinf", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002270 ret_number, MATH_FUNC(f_isinf)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002271 {"islocked", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002272 ret_number_bool, f_islocked},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002273 {"isnan", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002274 ret_number_bool, MATH_FUNC(f_isnan)},
Bram Moolenaar3e518a82022-08-30 17:45:33 +01002275 {"items", 1, 1, FEARG_1, arg1_string_or_list_or_dict,
Bram Moolenaarefc5db52021-07-07 21:21:30 +02002276 ret_list_items, f_items},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002277 {"job_getchannel", 1, 1, FEARG_1, arg1_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002278 ret_channel, JOB_FUNC(f_job_getchannel)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002279 {"job_info", 0, 1, FEARG_1, arg1_job,
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01002280 ret_job_info, JOB_FUNC(f_job_info)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002281 {"job_setoptions", 2, 2, FEARG_1, arg2_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002282 ret_void, JOB_FUNC(f_job_setoptions)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002283 {"job_start", 1, 2, FEARG_1, arg2_string_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002284 ret_job, JOB_FUNC(f_job_start)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002285 {"job_status", 1, 1, FEARG_1, arg1_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002286 ret_string, JOB_FUNC(f_job_status)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002287 {"job_stop", 1, 2, FEARG_1, arg2_job_string_or_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002288 ret_number_bool, JOB_FUNC(f_job_stop)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002289 {"join", 1, 2, FEARG_1, arg2_list_any_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002290 ret_string, f_join},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002291 {"js_decode", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002292 ret_any, f_js_decode},
2293 {"js_encode", 1, 1, FEARG_1, NULL,
2294 ret_string, f_js_encode},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002295 {"json_decode", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002296 ret_any, f_json_decode},
2297 {"json_encode", 1, 1, FEARG_1, NULL,
2298 ret_string, f_json_encode},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002299 {"keys", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002300 ret_list_string, f_keys},
zeertzjqcdc83932022-09-12 13:38:41 +01002301 {"keytrans", 1, 1, FEARG_1, arg1_string,
2302 ret_string, f_keytrans},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002303 {"last_buffer_nr", 0, 0, 0, NULL, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02002304 ret_number, f_last_buffer_nr},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002305 {"len", 1, 1, FEARG_1, arg1_len,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002306 ret_number, f_len},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002307 {"libcall", 3, 3, FEARG_3, arg3_libcall,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002308 ret_string, f_libcall},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002309 {"libcallnr", 3, 3, FEARG_3, arg3_libcall,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002310 ret_number, f_libcallnr},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002311 {"line", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002312 ret_number, f_line},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002313 {"line2byte", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002314 ret_number, f_line2byte},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002315 {"lispindent", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002316 ret_number, f_lispindent},
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +02002317 {"list2blob", 1, 1, FEARG_1, arg1_list_number,
2318 ret_blob, f_list2blob},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002319 {"list2str", 1, 2, FEARG_1, arg2_list_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002320 ret_string, f_list2str},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002321 {"listener_add", 1, 2, FEARG_2, arg2_any_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002322 ret_number, f_listener_add},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002323 {"listener_flush", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002324 ret_void, f_listener_flush},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002325 {"listener_remove", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002326 ret_number_bool, f_listener_remove},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002327 {"localtime", 0, 0, 0, NULL,
2328 ret_number, f_localtime},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002329 {"log", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002330 ret_float, f_log},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002331 {"log10", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002332 ret_float, f_log10},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002333 {"luaeval", 1, 2, FEARG_1, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002334 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002335#ifdef FEAT_LUA
Bram Moolenaar15c47602020-03-26 22:16:48 +01002336 f_luaeval
2337#else
2338 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002339#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002340 },
Bram Moolenaar18024052021-12-25 21:43:28 +00002341 {"map", 2, 2, FEARG_1, arg2_map,
Bram Moolenaarea696852020-11-09 18:31:39 +01002342 ret_first_cont, f_map},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002343 {"maparg", 1, 4, FEARG_1, arg14_maparg,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002344 ret_maparg, f_maparg},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002345 {"mapcheck", 1, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002346 ret_string, f_mapcheck},
Ernie Rael09661202022-04-25 14:40:44 +01002347 {"maplist", 0, 1, 0, arg1_bool,
2348 ret_list_dict_any, f_maplist},
Bram Moolenaar18024052021-12-25 21:43:28 +00002349 {"mapnew", 2, 2, FEARG_1, arg2_mapnew,
Bram Moolenaarea696852020-11-09 18:31:39 +01002350 ret_first_cont, f_mapnew},
Ernie Rael51d04d12022-05-04 15:40:22 +01002351 {"mapset", 1, 3, FEARG_1, arg3_string_or_dict_bool_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002352 ret_void, f_mapset},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002353 {"match", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002354 ret_any, f_match},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002355 {"matchadd", 2, 5, FEARG_1, arg25_matchadd,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002356 ret_number, f_matchadd},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002357 {"matchaddpos", 2, 5, FEARG_1, arg25_matchaddpos,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002358 ret_number, f_matchaddpos},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002359 {"matcharg", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002360 ret_list_string, f_matcharg},
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01002361 {"matchbufline", 4, 5, FEARG_1, arg45_matchbufline,
2362 ret_list_any, f_matchbufline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002363 {"matchdelete", 1, 2, FEARG_1, arg2_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002364 ret_number_bool, f_matchdelete},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002365 {"matchend", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002366 ret_number, f_matchend},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002367 {"matchfuzzy", 2, 3, FEARG_1, arg3_list_string_dict,
Yegappan Lakshmanan2d8e9982023-06-24 16:42:25 +01002368 ret_list_any, f_matchfuzzy},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002369 {"matchfuzzypos", 2, 3, FEARG_1, arg3_list_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002370 ret_list_any, f_matchfuzzypos},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002371 {"matchlist", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002372 ret_list_string, f_matchlist},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002373 {"matchstr", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002374 ret_string, f_matchstr},
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01002375 {"matchstrlist", 2, 3, FEARG_1, arg23_matchstrlist,
2376 ret_list_any, f_matchstrlist},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002377 {"matchstrpos", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002378 ret_list_any, f_matchstrpos},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002379 {"max", 1, 1, FEARG_1, arg1_list_or_dict,
Bram Moolenaar9ae37052021-01-22 22:31:10 +01002380 ret_number, f_max},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002381 {"menu_info", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002382 ret_dict_any,
Bram Moolenaara2cbdea2020-03-16 21:08:31 +01002383#ifdef FEAT_MENU
Bram Moolenaar15c47602020-03-26 22:16:48 +01002384 f_menu_info
2385#else
2386 NULL
Bram Moolenaara2cbdea2020-03-16 21:08:31 +01002387#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002388 },
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002389 {"min", 1, 1, FEARG_1, arg1_list_or_dict,
Bram Moolenaar9ae37052021-01-22 22:31:10 +01002390 ret_number, f_min},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002391 {"mkdir", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002392 ret_number_bool, f_mkdir},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002393 {"mode", 0, 1, FEARG_1, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002394 ret_string, f_mode},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002395 {"mzeval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002396 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002397#ifdef FEAT_MZSCHEME
Bram Moolenaar15c47602020-03-26 22:16:48 +01002398 f_mzeval
2399#else
2400 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002401#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002402 },
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002403 {"nextnonblank", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002404 ret_number, f_nextnonblank},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002405 {"nr2char", 1, 2, FEARG_1, arg2_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002406 ret_string, f_nr2char},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002407 {"or", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002408 ret_number, f_or},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002409 {"pathshorten", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002410 ret_string, f_pathshorten},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002411 {"perleval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002412 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002413#ifdef FEAT_PERL
Bram Moolenaar15c47602020-03-26 22:16:48 +01002414 f_perleval
2415#else
2416 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002417#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002418 },
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002419 {"popup_atcursor", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002420 ret_number, PROP_FUNC(f_popup_atcursor)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002421 {"popup_beval", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002422 ret_number, PROP_FUNC(f_popup_beval)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002423 {"popup_clear", 0, 1, 0, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002424 ret_void, PROP_FUNC(f_popup_clear)},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002425 {"popup_close", 1, 2, FEARG_1, arg2_number_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002426 ret_void, PROP_FUNC(f_popup_close)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002427 {"popup_create", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002428 ret_number, PROP_FUNC(f_popup_create)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002429 {"popup_dialog", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002430 ret_number, PROP_FUNC(f_popup_dialog)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002431 {"popup_filter_menu", 2, 2, 0, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002432 ret_bool, PROP_FUNC(f_popup_filter_menu)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002433 {"popup_filter_yesno", 2, 2, 0, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002434 ret_bool, PROP_FUNC(f_popup_filter_yesno)},
Bram Moolenaarbdc09a12022-10-07 14:31:45 +01002435 {"popup_findecho", 0, 0, 0, NULL,
2436 ret_number, PROP_FUNC(f_popup_findecho)},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002437 {"popup_findinfo", 0, 0, 0, NULL,
2438 ret_number, PROP_FUNC(f_popup_findinfo)},
2439 {"popup_findpreview", 0, 0, 0, NULL,
2440 ret_number, PROP_FUNC(f_popup_findpreview)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002441 {"popup_getoptions", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002442 ret_dict_any, PROP_FUNC(f_popup_getoptions)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002443 {"popup_getpos", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002444 ret_dict_any, PROP_FUNC(f_popup_getpos)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002445 {"popup_hide", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002446 ret_void, PROP_FUNC(f_popup_hide)},
2447 {"popup_list", 0, 0, 0, NULL,
2448 ret_list_number, PROP_FUNC(f_popup_list)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002449 {"popup_locate", 2, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002450 ret_number, PROP_FUNC(f_popup_locate)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002451 {"popup_menu", 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_menu)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002453 {"popup_move", 2, 2, FEARG_1, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002454 ret_void, PROP_FUNC(f_popup_move)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002455 {"popup_notification", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002456 ret_number, PROP_FUNC(f_popup_notification)},
Christian Brabandtfbc37f12024-06-18 20:50:58 +02002457 {"popup_setbuf", 2, 2, FEARG_1, arg2_number_buffer,
2458 ret_number_bool, PROP_FUNC(f_popup_setbuf)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002459 {"popup_setoptions", 2, 2, FEARG_1, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002460 ret_void, PROP_FUNC(f_popup_setoptions)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002461 {"popup_settext", 2, 2, FEARG_1, arg2_number_string_or_list,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002462 ret_void, PROP_FUNC(f_popup_settext)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002463 {"popup_show", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002464 ret_void, PROP_FUNC(f_popup_show)},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002465 {"pow", 2, 2, FEARG_1, arg2_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002466 ret_float, f_pow},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002467 {"prevnonblank", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002468 ret_number, f_prevnonblank},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002469 {"printf", 1, 19, FEARG_2, arg119_printf,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002470 ret_string, f_printf},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002471 {"prompt_getprompt", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002472 ret_string, JOB_FUNC(f_prompt_getprompt)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002473 {"prompt_setcallback", 2, 2, FEARG_1, arg2_buffer_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002474 ret_void, JOB_FUNC(f_prompt_setcallback)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002475 {"prompt_setinterrupt", 2, 2, FEARG_1, arg2_buffer_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002476 ret_void, JOB_FUNC(f_prompt_setinterrupt)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002477 {"prompt_setprompt", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002478 ret_void, JOB_FUNC(f_prompt_setprompt)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002479 {"prop_add", 3, 3, FEARG_1, arg3_number_number_dict,
Bram Moolenaar7f9969c2022-07-25 18:13:54 +01002480 ret_number, PROP_FUNC(f_prop_add)},
Yegappan Lakshmananccfb7c62021-08-16 21:39:09 +02002481 {"prop_add_list", 2, 2, FEARG_1, arg2_dict_any_list_any,
2482 ret_void, PROP_FUNC(f_prop_add_list)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002483 {"prop_clear", 1, 3, FEARG_1, arg3_number_number_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002484 ret_void, PROP_FUNC(f_prop_clear)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002485 {"prop_find", 1, 2, FEARG_1, arg2_dict_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002486 ret_dict_any, PROP_FUNC(f_prop_find)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002487 {"prop_list", 1, 2, FEARG_1, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002488 ret_list_dict_any, PROP_FUNC(f_prop_list)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002489 {"prop_remove", 1, 3, FEARG_1, arg3_dict_number_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002490 ret_number, PROP_FUNC(f_prop_remove)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002491 {"prop_type_add", 2, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002492 ret_void, PROP_FUNC(f_prop_type_add)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002493 {"prop_type_change", 2, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002494 ret_void, PROP_FUNC(f_prop_type_change)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002495 {"prop_type_delete", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002496 ret_void, PROP_FUNC(f_prop_type_delete)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002497 {"prop_type_get", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002498 ret_dict_any, PROP_FUNC(f_prop_type_get)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002499 {"prop_type_list", 0, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002500 ret_list_string, PROP_FUNC(f_prop_type_list)},
2501 {"pum_getpos", 0, 0, 0, NULL,
2502 ret_dict_number, f_pum_getpos},
2503 {"pumvisible", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002504 ret_number_bool, f_pumvisible},
Ben Jacksonea19e782024-11-06 21:50:05 +01002505 {"py3eval", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002506 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002507#ifdef FEAT_PYTHON3
Bram Moolenaar15c47602020-03-26 22:16:48 +01002508 f_py3eval
2509#else
2510 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002511#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002512 },
Ben Jacksonea19e782024-11-06 21:50:05 +01002513 {"pyeval", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002514 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002515#ifdef FEAT_PYTHON
Bram Moolenaar15c47602020-03-26 22:16:48 +01002516 f_pyeval
2517#else
2518 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002519#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002520 },
Ben Jacksonea19e782024-11-06 21:50:05 +01002521 {"pyxeval", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002522 ret_any,
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01002523#if defined(FEAT_PYTHON) || defined(FEAT_PYTHON3)
Bram Moolenaar15c47602020-03-26 22:16:48 +01002524 f_pyxeval
2525#else
2526 NULL
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01002527#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002528 },
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002529 {"rand", 0, 1, FEARG_1, arg1_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002530 ret_number, f_rand},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002531 {"range", 1, 3, FEARG_1, arg3_number,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00002532 ret_list_number, f_range},
K.Takata11df3ae2022-10-19 14:02:40 +01002533 {"readblob", 1, 3, FEARG_1, arg3_string_number_number,
Bram Moolenaarc423ad72021-01-13 20:38:03 +01002534 ret_blob, f_readblob},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002535 {"readdir", 1, 3, FEARG_1, arg3_string_any_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002536 ret_list_string, f_readdir},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002537 {"readdirex", 1, 3, FEARG_1, arg3_string_any_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002538 ret_list_dict_any, f_readdirex},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002539 {"readfile", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaarc423ad72021-01-13 20:38:03 +01002540 ret_list_string, f_readfile},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002541 {"reduce", 2, 3, FEARG_1, arg23_reduce,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002542 ret_any, f_reduce},
2543 {"reg_executing", 0, 0, 0, NULL,
2544 ret_string, f_reg_executing},
2545 {"reg_recording", 0, 0, 0, NULL,
2546 ret_string, f_reg_recording},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002547 {"reltime", 0, 2, FEARG_1, arg2_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002548 ret_list_any, f_reltime},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002549 {"reltimefloat", 1, 1, FEARG_1, arg1_list_number,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002550 ret_float, f_reltimefloat},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002551 {"reltimestr", 1, 1, FEARG_1, arg1_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002552 ret_string, f_reltimestr},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002553 {"remote_expr", 2, 4, FEARG_1, arg24_remote_expr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002554 ret_string, f_remote_expr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002555 {"remote_foreground", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002556 ret_string, f_remote_foreground},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002557 {"remote_peek", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002558 ret_number, f_remote_peek},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002559 {"remote_read", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002560 ret_string, f_remote_read},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002561 {"remote_send", 2, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002562 ret_string, f_remote_send},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002563 {"remote_startserver", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002564 ret_void, f_remote_startserver},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002565 {"remove", 2, 3, FEARG_1, arg23_remove,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002566 ret_remove, f_remove},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002567 {"rename", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002568 ret_number_bool, f_rename},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002569 {"repeat", 2, 2, FEARG_1, arg2_repeat,
Bram Moolenaar1780f082021-07-31 22:03:59 +02002570 ret_repeat, f_repeat},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002571 {"resolve", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002572 ret_string, f_resolve},
Yegappan Lakshmananf9dc2782023-05-11 15:02:56 +01002573 {"reverse", 1, 1, FEARG_1, arg1_string_or_list_or_blob_mod,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002574 ret_first_arg, f_reverse},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002575 {"round", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002576 ret_float, f_round},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002577 {"rubyeval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002578 ret_any,
Bram Moolenaare99be0e2019-03-26 22:51:09 +01002579#ifdef FEAT_RUBY
Bram Moolenaar15c47602020-03-26 22:16:48 +01002580 f_rubyeval
2581#else
2582 NULL
Bram Moolenaare99be0e2019-03-26 22:51:09 +01002583#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002584 },
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002585 {"screenattr", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002586 ret_number, f_screenattr},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002587 {"screenchar", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002588 ret_number, f_screenchar},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002589 {"screenchars", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002590 ret_list_number, f_screenchars},
2591 {"screencol", 0, 0, 0, NULL,
2592 ret_number, f_screencol},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002593 {"screenpos", 3, 3, FEARG_1, arg3_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002594 ret_dict_number, f_screenpos},
2595 {"screenrow", 0, 0, 0, NULL,
2596 ret_number, f_screenrow},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002597 {"screenstring", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002598 ret_string, f_screenstring},
Bram Moolenaarcd268012021-07-22 19:11:08 +02002599 {"search", 1, 5, FEARG_1, arg15_search,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002600 ret_number, f_search},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002601 {"searchcount", 0, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002602 ret_dict_any, f_searchcount},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002603 {"searchdecl", 1, 3, FEARG_1, arg3_string_bool_bool,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002604 ret_number_bool, f_searchdecl},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002605 {"searchpair", 3, 7, 0, arg37_searchpair,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002606 ret_number, f_searchpair},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002607 {"searchpairpos", 3, 7, 0, arg37_searchpair,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002608 ret_list_number, f_searchpairpos},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002609 {"searchpos", 1, 5, FEARG_1, arg15_search,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002610 ret_list_number, f_searchpos},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002611 {"server2client", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002612 ret_number_bool, f_server2client},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002613 {"serverlist", 0, 0, 0, NULL,
2614 ret_string, f_serverlist},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002615 {"setbufline", 3, 3, FEARG_3, arg3_setbufline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002616 ret_number_bool, f_setbufline},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002617 {"setbufvar", 3, 3, FEARG_3, arg3_buffer_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002618 ret_void, f_setbufvar},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002619 {"setcellwidths", 1, 1, FEARG_1, arg1_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002620 ret_void, f_setcellwidths},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002621 {"setcharpos", 2, 2, FEARG_2, arg2_string_list_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002622 ret_number_bool, f_setcharpos},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002623 {"setcharsearch", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002624 ret_void, f_setcharsearch},
Shougo Matsushita07ea5f12022-08-27 12:22:25 +01002625 {"setcmdline", 1, 2, FEARG_1, arg2_string_number,
2626 ret_number_bool, f_setcmdline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002627 {"setcmdpos", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002628 ret_number_bool, f_setcmdpos},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002629 {"setcursorcharpos", 1, 3, FEARG_1, arg13_cursor,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002630 ret_number_bool, f_setcursorcharpos},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002631 {"setenv", 2, 2, FEARG_2, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002632 ret_void, f_setenv},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002633 {"setfperm", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002634 ret_number_bool, f_setfperm},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002635 {"setline", 2, 2, FEARG_2, arg2_setline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002636 ret_number_bool, f_setline},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002637 {"setloclist", 2, 4, FEARG_2, arg24_setloclist,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002638 ret_number_bool, f_setloclist},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002639 {"setmatches", 1, 2, FEARG_1, arg2_list_any_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002640 ret_number_bool, f_setmatches},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002641 {"setpos", 2, 2, FEARG_2, arg2_string_list_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002642 ret_number_bool, f_setpos},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002643 {"setqflist", 1, 3, FEARG_1, arg13_setqflist,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002644 ret_number_bool, f_setqflist},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002645 {"setreg", 2, 3, FEARG_2, arg3_string_any_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002646 ret_number_bool, f_setreg},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002647 {"settabvar", 3, 3, FEARG_3, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002648 ret_void, f_settabvar},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002649 {"settabwinvar", 4, 4, FEARG_4, arg4_number_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002650 ret_void, f_settabwinvar},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002651 {"settagstack", 2, 3, FEARG_2, arg23_settagstack,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002652 ret_number_bool, f_settagstack},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002653 {"setwinvar", 3, 3, FEARG_3, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002654 ret_void, f_setwinvar},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002655 {"sha256", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002656 ret_string,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002657#ifdef FEAT_CRYPT
Bram Moolenaar15c47602020-03-26 22:16:48 +01002658 f_sha256
2659#else
2660 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002661#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002662 },
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002663 {"shellescape", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002664 ret_string, f_shellescape},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002665 {"shiftwidth", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002666 ret_number, f_shiftwidth},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002667 {"sign_define", 1, 2, FEARG_1, arg2_string_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002668 ret_any, SIGN_FUNC(f_sign_define)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002669 {"sign_getdefined", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002670 ret_list_dict_any, SIGN_FUNC(f_sign_getdefined)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002671 {"sign_getplaced", 0, 2, FEARG_1, arg02_sign_getplaced,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002672 ret_list_dict_any, SIGN_FUNC(f_sign_getplaced)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002673 {"sign_jump", 3, 3, FEARG_1, arg3_number_string_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002674 ret_number, SIGN_FUNC(f_sign_jump)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002675 {"sign_place", 4, 5, FEARG_1, arg45_sign_place,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002676 ret_number, SIGN_FUNC(f_sign_place)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002677 {"sign_placelist", 1, 1, FEARG_1, arg1_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002678 ret_list_number, SIGN_FUNC(f_sign_placelist)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002679 {"sign_undefine", 0, 1, FEARG_1, arg1_string_or_list_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002680 ret_number_bool, SIGN_FUNC(f_sign_undefine)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002681 {"sign_unplace", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002682 ret_number_bool, SIGN_FUNC(f_sign_unplace)},
Sean Dewara63780b2021-11-03 13:15:47 +00002683 {"sign_unplacelist", 1, 1, FEARG_1, arg1_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002684 ret_list_number, SIGN_FUNC(f_sign_unplacelist)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002685 {"simplify", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002686 ret_string, f_simplify},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002687 {"sin", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002688 ret_float, f_sin},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002689 {"sinh", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002690 ret_float, f_sinh},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002691 {"slice", 2, 3, FEARG_1, arg23_slice,
Bram Moolenaar00eb9952022-02-05 19:23:18 +00002692 ret_slice, f_slice},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002693 {"sort", 1, 3, FEARG_1, arg13_sortuniq,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002694 ret_first_arg, f_sort},
2695 {"sound_clear", 0, 0, 0, NULL,
2696 ret_void, SOUND_FUNC(f_sound_clear)},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002697 {"sound_playevent", 1, 2, FEARG_1, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002698 ret_number, SOUND_FUNC(f_sound_playevent)},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002699 {"sound_playfile", 1, 2, FEARG_1, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002700 ret_number, SOUND_FUNC(f_sound_playfile)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002701 {"sound_stop", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002702 ret_void, SOUND_FUNC(f_sound_stop)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002703 {"soundfold", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002704 ret_string, f_soundfold},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002705 {"spellbadword", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002706 ret_list_string, f_spellbadword},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002707 {"spellsuggest", 1, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002708 ret_list_string, f_spellsuggest},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002709 {"split", 1, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002710 ret_list_string, f_split},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002711 {"sqrt", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002712 ret_float, f_sqrt},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002713 {"srand", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002714 ret_list_number, f_srand},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002715 {"state", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002716 ret_string, f_state},
Yegappan Lakshmanana11b23c2025-01-16 19:16:42 +01002717 {"str2blob", 1, 2, FEARG_1, arg2_list_string_dict,
Yegappan Lakshmanan1aefe1d2025-01-14 17:29:42 +01002718 ret_blob, f_str2blob},
Bram Moolenaar80a070c2021-08-08 15:51:10 +02002719 {"str2float", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002720 ret_float, f_str2float},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002721 {"str2list", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002722 ret_list_number, f_str2list},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002723 {"str2nr", 1, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002724 ret_number, f_str2nr},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002725 {"strcharlen", 1, 1, FEARG_1, arg1_string_or_nr,
Bram Moolenaar70ce8a12021-03-14 19:02:09 +01002726 ret_number, f_strcharlen},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002727 {"strcharpart", 2, 4, FEARG_1, arg24_strpart,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002728 ret_string, f_strcharpart},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002729 {"strchars", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002730 ret_number, f_strchars},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002731 {"strdisplaywidth", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002732 ret_number, f_strdisplaywidth},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002733 {"strftime", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002734 ret_string,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002735#ifdef HAVE_STRFTIME
Bram Moolenaar15c47602020-03-26 22:16:48 +01002736 f_strftime
2737#else
2738 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002739#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002740 },
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002741 {"strgetchar", 2, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002742 ret_number, f_strgetchar},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002743 {"stridx", 2, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002744 ret_number, f_stridx},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002745 {"string", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002746 ret_string, f_string},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002747 {"strlen", 1, 1, FEARG_1, arg1_string_or_nr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002748 ret_number, f_strlen},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002749 {"strpart", 2, 4, FEARG_1, arg24_strpart,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002750 ret_string, f_strpart},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002751 {"strptime", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002752 ret_number,
Bram Moolenaar10455d42019-11-21 15:36:18 +01002753#ifdef HAVE_STRPTIME
Bram Moolenaar15c47602020-03-26 22:16:48 +01002754 f_strptime
2755#else
2756 NULL
Bram Moolenaar10455d42019-11-21 15:36:18 +01002757#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002758 },
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002759 {"strridx", 2, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002760 ret_number, f_strridx},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002761 {"strtrans", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002762 ret_string, f_strtrans},
Christian Brabandt67672ef2023-04-24 21:09:54 +01002763 {"strutf16len", 1, 2, FEARG_1, arg2_string_bool,
2764 ret_number, f_strutf16len},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002765 {"strwidth", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002766 ret_number, f_strwidth},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002767 {"submatch", 1, 2, FEARG_1, arg2_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002768 ret_string, f_submatch},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002769 {"substitute", 4, 4, FEARG_1, arg4_string_string_any_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002770 ret_string, f_substitute},
Bram Moolenaarc216a7a2022-12-05 13:50:55 +00002771 {"swapfilelist", 0, 0, 0, NULL,
2772 ret_list_string, f_swapfilelist},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002773 {"swapinfo", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002774 ret_dict_any, f_swapinfo},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002775 {"swapname", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002776 ret_string, f_swapname},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002777 {"synID", 3, 3, 0, arg3_lnum_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002778 ret_number, f_synID},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002779 {"synIDattr", 2, 3, FEARG_1, arg3_number_string_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002780 ret_string, f_synIDattr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002781 {"synIDtrans", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002782 ret_number, f_synIDtrans},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002783 {"synconcealed", 2, 2, 0, arg2_lnum_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002784 ret_list_any, f_synconcealed},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002785 {"synstack", 2, 2, 0, arg2_lnum_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002786 ret_list_number, f_synstack},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002787 {"system", 1, 2, FEARG_1, arg12_system,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002788 ret_string, f_system},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002789 {"systemlist", 1, 2, FEARG_1, arg12_system,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002790 ret_list_string, f_systemlist},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002791 {"tabpagebuflist", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002792 ret_list_number, f_tabpagebuflist},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002793 {"tabpagenr", 0, 1, 0, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002794 ret_number, f_tabpagenr},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002795 {"tabpagewinnr", 1, 2, FEARG_1, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002796 ret_number, f_tabpagewinnr},
2797 {"tagfiles", 0, 0, 0, NULL,
2798 ret_list_string, f_tagfiles},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002799 {"taglist", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002800 ret_list_dict_any, f_taglist},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002801 {"tan", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002802 ret_float, f_tan},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002803 {"tanh", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002804 ret_float, f_tanh},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002805 {"tempname", 0, 0, 0, NULL,
2806 ret_string, f_tempname},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002807 {"term_dumpdiff", 2, 3, FEARG_1, arg3_string_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002808 ret_number, TERM_FUNC(f_term_dumpdiff)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002809 {"term_dumpload", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002810 ret_number, TERM_FUNC(f_term_dumpload)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002811 {"term_dumpwrite", 2, 3, FEARG_2, arg3_buffer_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002812 ret_void, TERM_FUNC(f_term_dumpwrite)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002813 {"term_getaltscreen", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002814 ret_number, TERM_FUNC(f_term_getaltscreen)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002815 {"term_getansicolors", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002816 ret_list_string,
Bram Moolenaarbd5e6222020-03-26 23:13:34 +01002817#if defined(FEAT_TERMINAL) && (defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS))
Bram Moolenaar15c47602020-03-26 22:16:48 +01002818 f_term_getansicolors
2819#else
2820 NULL
Bram Moolenaarc6df10e2017-07-29 20:15:08 +02002821#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002822 },
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002823 {"term_getattr", 2, 2, FEARG_1, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002824 ret_number, TERM_FUNC(f_term_getattr)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002825 {"term_getcursor", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002826 ret_list_any, TERM_FUNC(f_term_getcursor)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002827 {"term_getjob", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002828 ret_job, TERM_FUNC(f_term_getjob)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002829 {"term_getline", 2, 2, FEARG_1, arg2_buffer_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002830 ret_string, TERM_FUNC(f_term_getline)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002831 {"term_getscrolled", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002832 ret_number, TERM_FUNC(f_term_getscrolled)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002833 {"term_getsize", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002834 ret_list_number, TERM_FUNC(f_term_getsize)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002835 {"term_getstatus", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002836 ret_string, TERM_FUNC(f_term_getstatus)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002837 {"term_gettitle", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002838 ret_string, TERM_FUNC(f_term_gettitle)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002839 {"term_gettty", 1, 2, FEARG_1, arg2_buffer_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002840 ret_string, TERM_FUNC(f_term_gettty)},
2841 {"term_list", 0, 0, 0, NULL,
2842 ret_list_number, TERM_FUNC(f_term_list)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002843 {"term_scrape", 2, 2, FEARG_1, arg2_buffer_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002844 ret_list_dict_any, TERM_FUNC(f_term_scrape)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002845 {"term_sendkeys", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002846 ret_void, TERM_FUNC(f_term_sendkeys)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002847 {"term_setansicolors", 2, 2, FEARG_1, arg2_buffer_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002848 ret_void,
Bram Moolenaarbd5e6222020-03-26 23:13:34 +01002849#if defined(FEAT_TERMINAL) && (defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS))
Bram Moolenaar15c47602020-03-26 22:16:48 +01002850 f_term_setansicolors
2851#else
2852 NULL
2853#endif
2854 },
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002855 {"term_setapi", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002856 ret_void, TERM_FUNC(f_term_setapi)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002857 {"term_setkill", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002858 ret_void, TERM_FUNC(f_term_setkill)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002859 {"term_setrestore", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002860 ret_void, TERM_FUNC(f_term_setrestore)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002861 {"term_setsize", 3, 3, FEARG_1, arg3_buffer_number_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002862 ret_void, TERM_FUNC(f_term_setsize)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002863 {"term_start", 1, 2, FEARG_1, arg2_string_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002864 ret_number, TERM_FUNC(f_term_start)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002865 {"term_wait", 1, 2, FEARG_1, arg2_buffer_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002866 ret_void, TERM_FUNC(f_term_wait)},
2867 {"terminalprops", 0, 0, 0, NULL,
2868 ret_dict_string, f_terminalprops},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002869 {"test_alloc_fail", 3, 3, FEARG_1, arg3_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002870 ret_void, f_test_alloc_fail},
2871 {"test_autochdir", 0, 0, 0, NULL,
2872 ret_void, f_test_autochdir},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002873 {"test_feedinput", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002874 ret_void, f_test_feedinput},
2875 {"test_garbagecollect_now", 0, 0, 0, NULL,
2876 ret_void, f_test_garbagecollect_now},
2877 {"test_garbagecollect_soon", 0, 0, 0, NULL,
2878 ret_void, f_test_garbagecollect_soon},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002879 {"test_getvalue", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002880 ret_number, f_test_getvalue},
Yegappan Lakshmanan06011e12022-01-30 12:37:29 +00002881 {"test_gui_event", 2, 2, FEARG_1, arg2_string_dict,
2882 ret_bool, f_test_gui_event},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002883 {"test_ignore_error", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002884 ret_void, f_test_ignore_error},
Christopher Plewright20b795e2022-12-20 20:01:58 +00002885 {"test_mswin_event", 2, 2, FEARG_1, arg2_string_dict,
2886 ret_number, f_test_mswin_event},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002887 {"test_null_blob", 0, 0, 0, NULL,
2888 ret_blob, f_test_null_blob},
2889 {"test_null_channel", 0, 0, 0, NULL,
2890 ret_channel, JOB_FUNC(f_test_null_channel)},
2891 {"test_null_dict", 0, 0, 0, NULL,
2892 ret_dict_any, f_test_null_dict},
2893 {"test_null_function", 0, 0, 0, NULL,
2894 ret_func_any, f_test_null_function},
2895 {"test_null_job", 0, 0, 0, NULL,
2896 ret_job, JOB_FUNC(f_test_null_job)},
2897 {"test_null_list", 0, 0, 0, NULL,
2898 ret_list_any, f_test_null_list},
2899 {"test_null_partial", 0, 0, 0, NULL,
2900 ret_func_any, f_test_null_partial},
2901 {"test_null_string", 0, 0, 0, NULL,
2902 ret_string, f_test_null_string},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002903 {"test_option_not_set", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002904 ret_void, f_test_option_not_set},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002905 {"test_override", 2, 2, FEARG_2, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002906 ret_void, f_test_override},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002907 {"test_refcount", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002908 ret_number, f_test_refcount},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002909 {"test_setmouse", 2, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002910 ret_void, f_test_setmouse},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002911 {"test_settime", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002912 ret_void, f_test_settime},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002913 {"test_srand_seed", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002914 ret_void, f_test_srand_seed},
2915 {"test_unknown", 0, 0, 0, NULL,
2916 ret_any, f_test_unknown},
2917 {"test_void", 0, 0, 0, NULL,
2918 ret_void, f_test_void},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002919 {"timer_info", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002920 ret_list_dict_any, TIMER_FUNC(f_timer_info)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002921 {"timer_pause", 2, 2, FEARG_1, arg2_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002922 ret_void, TIMER_FUNC(f_timer_pause)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002923 {"timer_start", 2, 3, FEARG_1, arg3_number_any_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002924 ret_number, TIMER_FUNC(f_timer_start)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002925 {"timer_stop", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002926 ret_void, TIMER_FUNC(f_timer_stop)},
2927 {"timer_stopall", 0, 0, 0, NULL,
2928 ret_void, TIMER_FUNC(f_timer_stopall)},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002929 {"tolower", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002930 ret_string, f_tolower},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002931 {"toupper", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002932 ret_string, f_toupper},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002933 {"tr", 3, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002934 ret_string, f_tr},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002935 {"trim", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002936 ret_string, f_trim},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002937 {"trunc", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002938 ret_float, f_trunc},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002939 {"type", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002940 ret_number, f_type},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002941 {"typename", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaara47e05f2021-01-12 21:49:00 +01002942 ret_string, f_typename},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002943 {"undofile", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002944 ret_string, f_undofile},
Devin J. Pohly5fee1112023-04-23 20:26:59 -05002945 {"undotree", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002946 ret_dict_any, f_undotree},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002947 {"uniq", 1, 3, FEARG_1, arg13_sortuniq,
Bram Moolenaar08018222021-12-22 18:45:37 +00002948 ret_first_arg, f_uniq},
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01002949 {"utf16idx", 2, 4, FEARG_1, arg4_string_number_bool_bool,
Christian Brabandt67672ef2023-04-24 21:09:54 +01002950 ret_number, f_utf16idx},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002951 {"values", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar32517c42023-01-15 18:17:12 +00002952 ret_list_member, f_values},
zeertzjq825cf812023-08-17 22:55:25 +02002953 {"virtcol", 1, 3, FEARG_1, arg3_string_or_list_bool_number,
LemonBoy0f7a3e12022-05-26 12:10:37 +01002954 ret_virtcol, f_virtcol},
Bram Moolenaar5a6ec102022-05-27 21:58:00 +01002955 {"virtcol2col", 3, 3, FEARG_1, arg3_number,
2956 ret_number, f_virtcol2col},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002957 {"visualmode", 0, 1, 0, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002958 ret_string, f_visualmode},
2959 {"wildmenumode", 0, 0, 0, NULL,
2960 ret_number, f_wildmenumode},
Bram Moolenaar52312242021-07-11 18:23:19 +02002961 {"win_execute", 2, 3, FEARG_2, arg23_win_execute,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002962 ret_string, f_win_execute},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002963 {"win_findbuf", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002964 ret_list_number, f_win_findbuf},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002965 {"win_getid", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002966 ret_number, f_win_getid},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002967 {"win_gettype", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002968 ret_string, f_win_gettype},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002969 {"win_gotoid", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002970 ret_number_bool, f_win_gotoid},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002971 {"win_id2tabwin", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002972 ret_list_number, f_win_id2tabwin},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002973 {"win_id2win", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002974 ret_number, f_win_id2win},
Daniel Steinbergee630312022-01-10 13:36:34 +00002975 {"win_move_separator", 2, 2, FEARG_1, arg2_number,
2976 ret_number_bool, f_win_move_separator},
2977 {"win_move_statusline", 2, 2, FEARG_1, arg2_number,
2978 ret_number_bool, f_win_move_statusline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002979 {"win_screenpos", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002980 ret_list_number, f_win_screenpos},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002981 {"win_splitmove", 2, 3, FEARG_1, arg3_number_number_dict,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002982 ret_number_bool, f_win_splitmove},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002983 {"winbufnr", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002984 ret_number, f_winbufnr},
2985 {"wincol", 0, 0, 0, NULL,
2986 ret_number, f_wincol},
2987 {"windowsversion", 0, 0, 0, NULL,
2988 ret_string, f_windowsversion},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002989 {"winheight", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002990 ret_number, f_winheight},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002991 {"winlayout", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002992 ret_list_any, f_winlayout},
2993 {"winline", 0, 0, 0, NULL,
2994 ret_number, f_winline},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002995 {"winnr", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002996 ret_number, f_winnr},
2997 {"winrestcmd", 0, 0, 0, NULL,
2998 ret_string, f_winrestcmd},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002999 {"winrestview", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003000 ret_void, f_winrestview},
3001 {"winsaveview", 0, 0, 0, NULL,
Bram Moolenaar43b69b32021-01-07 20:23:33 +01003002 ret_dict_number, f_winsaveview},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003003 {"winwidth", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003004 ret_number, f_winwidth},
3005 {"wordcount", 0, 0, 0, NULL,
3006 ret_dict_number, f_wordcount},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02003007 {"writefile", 2, 3, FEARG_1, arg23_writefile,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01003008 ret_number_bool, f_writefile},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003009 {"xor", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003010 ret_number, f_xor},
Bram Moolenaarac92e252019-08-03 21:58:38 +02003011};
3012
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003013/*
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003014 * Return true if specified function allows a type as an argument.
3015 */
3016 static int
3017func_allows_type(int idx)
3018{
3019 return (global_functions[idx].f_argtype & FE_X) != 0;
3020}
3021
3022/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003023 * Function given to ExpandGeneric() to obtain the list of internal
3024 * or user defined function names.
3025 */
3026 char_u *
3027get_function_name(expand_T *xp, int idx)
3028{
3029 static int intidx = -1;
3030 char_u *name;
3031
3032 if (idx == 0)
3033 intidx = -1;
3034 if (intidx < 0)
3035 {
3036 name = get_user_func_name(xp, idx);
naohiro ono5aec7552021-08-19 21:20:41 +02003037 if (name != NULL)
Bram Moolenaar1bb4de52021-01-13 19:48:46 +01003038 {
naohiro ono5aec7552021-08-19 21:20:41 +02003039 if (*name != NUL && *name != '<'
3040 && STRNCMP("g:", xp->xp_pattern, 2) == 0)
Bram Moolenaar1bb4de52021-01-13 19:48:46 +01003041 return cat_prefix_varname('g', name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003042 return name;
Bram Moolenaar1bb4de52021-01-13 19:48:46 +01003043 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003044 }
K.Takataeeec2542021-06-02 13:28:16 +02003045 if (++intidx < (int)ARRAY_LENGTH(global_functions))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003046 {
Kota Kato90c23532023-01-18 15:27:38 +00003047 // Skip if the function doesn't have an implementation (feature not
3048 // implemented).
3049 if (global_functions[intidx].f_func == NULL)
3050 return (char_u *)"";
Bram Moolenaarac92e252019-08-03 21:58:38 +02003051 STRCPY(IObuff, global_functions[intidx].f_name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003052 STRCAT(IObuff, "(");
Bram Moolenaarac92e252019-08-03 21:58:38 +02003053 if (global_functions[intidx].f_max_argc == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003054 STRCAT(IObuff, ")");
3055 return IObuff;
3056 }
3057
3058 return NULL;
3059}
3060
3061/*
3062 * Function given to ExpandGeneric() to obtain the list of internal or
3063 * user defined variable or function names.
3064 */
3065 char_u *
3066get_expr_name(expand_T *xp, int idx)
3067{
3068 static int intidx = -1;
3069 char_u *name;
3070
3071 if (idx == 0)
3072 intidx = -1;
3073 if (intidx < 0)
3074 {
3075 name = get_function_name(xp, idx);
3076 if (name != NULL)
3077 return name;
3078 }
3079 return get_user_var_name(xp, ++intidx);
3080}
3081
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003082/*
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003083 * Find internal function "name" in table "global_functions".
Bram Moolenaar15c47602020-03-26 22:16:48 +01003084 * Return index, or -1 if not found or "implemented" is TRUE and the function
3085 * is not implemented.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003086 */
Bram Moolenaar15c47602020-03-26 22:16:48 +01003087 static int
3088find_internal_func_opt(char_u *name, int implemented)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003089{
3090 int first = 0;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003091 int last;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003092 int cmp;
3093 int x;
3094
K.Takataeeec2542021-06-02 13:28:16 +02003095 last = (int)ARRAY_LENGTH(global_functions) - 1;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003096
3097 // Find the function name in the table. Binary search.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003098 while (first <= last)
3099 {
3100 x = first + ((unsigned)(last - first) >> 1);
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003101 cmp = STRCMP(name, global_functions[x].f_name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003102 if (cmp < 0)
3103 last = x - 1;
3104 else if (cmp > 0)
3105 first = x + 1;
Bram Moolenaar15c47602020-03-26 22:16:48 +01003106 else if (implemented && global_functions[x].f_func == NULL)
3107 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003108 else
3109 return x;
3110 }
3111 return -1;
3112}
3113
Bram Moolenaar15c47602020-03-26 22:16:48 +01003114/*
3115 * Find internal function "name" in table "global_functions".
3116 * Return index, or -1 if not found or the function is not implemented.
3117 */
3118 int
3119find_internal_func(char_u *name)
3120{
3121 return find_internal_func_opt(name, TRUE);
3122}
3123
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003124 int
Bram Moolenaarac92e252019-08-03 21:58:38 +02003125has_internal_func(char_u *name)
3126{
Bram Moolenaar15c47602020-03-26 22:16:48 +01003127 return find_internal_func_opt(name, TRUE) >= 0;
3128}
3129
3130 static int
3131has_internal_func_name(char_u *name)
3132{
3133 return find_internal_func_opt(name, FALSE) >= 0;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003134}
3135
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003136 char *
3137internal_func_name(int idx)
3138{
3139 return global_functions[idx].f_name;
3140}
3141
Bram Moolenaar94738d82020-10-21 14:25:07 +02003142/*
Dominique Pellefe8ebdb2021-05-13 14:55:55 +02003143 * Check the argument types for builtin function "idx".
Bram Moolenaar94738d82020-10-21 14:25:07 +02003144 * Uses the list of types on the type stack: "types".
3145 * Return FAIL and gives an error message when a type is wrong.
3146 */
3147 int
Bram Moolenaar351ead02021-01-16 16:07:01 +01003148internal_func_check_arg_types(
Bram Moolenaar078a4612022-01-04 15:17:03 +00003149 type2_T *types,
Bram Moolenaar351ead02021-01-16 16:07:01 +01003150 int idx,
3151 int argcount,
3152 cctx_T *cctx)
Bram Moolenaar94738d82020-10-21 14:25:07 +02003153{
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003154 // Some internal functions accept types like Class as arguments. For other
3155 // functions, check the arguments are not types.
3156 if (!(func_allows_type(idx)))
3157 {
zeertzjqd9be94c2024-07-14 10:20:20 +02003158 for (int i = 0; i < argcount; ++i)
3159 if (check_type_is_value(types[i].type_curr) == FAIL)
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003160 return FAIL;
3161 }
3162
Bram Moolenaar94738d82020-10-21 14:25:07 +02003163 argcheck_T *argchecks = global_functions[idx].f_argcheck;
Bram Moolenaar94738d82020-10-21 14:25:07 +02003164
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003165 if (argchecks == NULL)
3166 return OK;
Bram Moolenaar94738d82020-10-21 14:25:07 +02003167
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003168 argcontext_T context;
3169
3170 context.arg_count = argcount;
3171 context.arg_types = types;
3172 context.arg_cctx = cctx;
Ernie Raela8f7f922023-12-14 20:17:04 +01003173 for (int i = 0; i < argcount && argchecks[i] != NULL; ++i)
3174 {
3175 context.arg_idx = i;
3176 if (argchecks[i](types[i].type_curr, types[i].type_decl,
3177 &context) == FAIL)
3178 return FAIL;
3179 }
Bram Moolenaar94738d82020-10-21 14:25:07 +02003180 return OK;
3181}
3182
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003183/*
Bram Moolenaar7a40ff02021-07-04 15:54:08 +02003184 * Get the argument count for function "idx".
3185 * "argcount" is the total argument count, "min_argcount" the non-optional
3186 * argument count.
3187 */
3188 void
3189internal_func_get_argcount(int idx, int *argcount, int *min_argcount)
3190{
3191 *argcount = global_functions[idx].f_max_argc;
3192 *min_argcount = global_functions[idx].f_min_argc;
3193}
3194
3195/*
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003196 * Call the "f_retfunc" function to obtain the return type of function "idx".
Bram Moolenaar81330182022-02-01 12:11:58 +00003197 * "decl_type" is set to the declared type.
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003198 * "argtypes" is the list of argument types or NULL when there are no
3199 * arguments.
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02003200 * "argcount" may be less than the actual count when only getting the type.
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003201 */
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003202 type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00003203internal_func_ret_type(
3204 int idx,
3205 int argcount,
3206 type2_T *argtypes,
Bram Moolenaar32517c42023-01-15 18:17:12 +00003207 type_T **decl_type,
3208 garray_T *type_gap)
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003209{
Bram Moolenaar81330182022-02-01 12:11:58 +00003210 type_T *ret;
3211
Bram Moolenaar32517c42023-01-15 18:17:12 +00003212 current_type_gap = type_gap;
Bram Moolenaar81330182022-02-01 12:11:58 +00003213 *decl_type = NULL;
3214 ret = global_functions[idx].f_retfunc(argcount, argtypes, decl_type);
3215 if (*decl_type == NULL)
3216 *decl_type = ret;
Bram Moolenaar32517c42023-01-15 18:17:12 +00003217 current_type_gap = NULL;
Bram Moolenaar81330182022-02-01 12:11:58 +00003218 return ret;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003219}
3220
3221/*
Bram Moolenaar75ab91f2021-01-10 22:42:50 +01003222 * Return TRUE if "idx" is for the map() function.
3223 */
3224 int
3225internal_func_is_map(int idx)
3226{
3227 return global_functions[idx].f_func == f_map;
3228}
3229
3230/*
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003231 * Check the argument count to use for internal function "idx".
Bram Moolenaar389df252020-07-09 21:20:47 +02003232 * Returns -1 for failure, 0 if no method base accepted, 1 if method base is
3233 * first argument, 2 if method base is second argument, etc. 9 if method base
3234 * is last argument.
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003235 */
3236 int
3237check_internal_func(int idx, int argcount)
3238{
Bram Moolenaar0917e862023-02-18 14:42:44 +00003239 funcerror_T res;
3240 char *name;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003241
3242 if (argcount < global_functions[idx].f_min_argc)
3243 res = FCERR_TOOFEW;
3244 else if (argcount > global_functions[idx].f_max_argc)
3245 res = FCERR_TOOMANY;
3246 else
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003247 return global_functions[idx].f_argtype & FEARG_MASK;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003248
3249 name = internal_func_name(idx);
3250 if (res == FCERR_TOOMANY)
Bram Moolenaare1242042021-12-16 20:56:57 +00003251 semsg(_(e_too_many_arguments_for_function_str), name);
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003252 else
Bram Moolenaare1242042021-12-16 20:56:57 +00003253 semsg(_(e_not_enough_arguments_for_function_str), name);
Bram Moolenaar389df252020-07-09 21:20:47 +02003254 return -1;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003255}
3256
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003257/*
3258 * Some internal functions accept types like Class as arguments. For other
3259 * functions, check the arguments are not types.
3260 *
3261 * Return OK/FAIL.
3262 */
3263 static int
3264check_args_for_type(int idx, int argcount, typval_T *argvars)
3265{
3266 if (!func_allows_type(idx))
3267 {
3268 for (int i = 0; i < argcount; ++i)
3269 if (check_typval_is_value(&argvars[i]) == FAIL)
3270 return FAIL;
3271 }
3272 return OK;
3273}
3274
Bram Moolenaar0917e862023-02-18 14:42:44 +00003275 funcerror_T
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003276call_internal_func(
3277 char_u *name,
3278 int argcount,
3279 typval_T *argvars,
3280 typval_T *rettv)
3281{
3282 int i;
3283
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003284 i = find_internal_func(name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003285 if (i < 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01003286 return FCERR_UNKNOWN;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003287 if (argcount < global_functions[i].f_min_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003288 return FCERR_TOOFEW;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003289 if (argcount > global_functions[i].f_max_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003290 return FCERR_TOOMANY;
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003291 if (check_args_for_type(i, argcount, argvars) == FAIL)
3292 return FCERR_OTHER;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003293 argvars[argcount].v_type = VAR_UNKNOWN;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003294 global_functions[i].f_func(argvars, rettv);
Bram Moolenaaref140542019-12-31 21:27:13 +01003295 return FCERR_NONE;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003296}
3297
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003298 void
3299call_internal_func_by_idx(
3300 int idx,
3301 typval_T *argvars,
3302 typval_T *rettv)
3303{
3304 global_functions[idx].f_func(argvars, rettv);
3305}
3306
Bram Moolenaarac92e252019-08-03 21:58:38 +02003307/*
3308 * Invoke a method for base->method().
3309 */
Bram Moolenaar0917e862023-02-18 14:42:44 +00003310 funcerror_T
Bram Moolenaarac92e252019-08-03 21:58:38 +02003311call_internal_method(
3312 char_u *name,
3313 int argcount,
3314 typval_T *argvars,
3315 typval_T *rettv,
3316 typval_T *basetv)
3317{
Bram Moolenaarac92e252019-08-03 21:58:38 +02003318 int fi;
3319 typval_T argv[MAX_FUNC_ARGS + 1];
3320
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003321 fi = find_internal_func(name);
Bram Moolenaar91746392019-08-16 22:22:31 +02003322 if (fi < 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01003323 return FCERR_UNKNOWN;
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003324 if ((global_functions[fi].f_argtype & FEARG_MASK) == 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01003325 return FCERR_NOTMETHOD;
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003326 if (argcount + 1 < global_functions[fi].f_min_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003327 return FCERR_TOOFEW;
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003328 if (argcount + 1 > global_functions[fi].f_max_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003329 return FCERR_TOOMANY;
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003330 if (check_args_for_type(fi, argcount, argvars) == FAIL)
3331 return FCERR_OTHER;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003332
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003333 if ((global_functions[fi].f_argtype & FEARG_MASK) == FEARG_2)
Bram Moolenaar25e42232019-08-04 15:04:10 +02003334 {
Bram Moolenaarb7f22702023-04-27 16:24:07 +01003335 if (argcount < 1)
3336 return FCERR_TOOFEW;
3337
Bram Moolenaar25e42232019-08-04 15:04:10 +02003338 // base value goes second
3339 argv[0] = argvars[0];
3340 argv[1] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003341 for (int i = 1; i < argcount; ++i)
Bram Moolenaar25e42232019-08-04 15:04:10 +02003342 argv[i + 1] = argvars[i];
3343 }
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003344 else if ((global_functions[fi].f_argtype & FEARG_MASK) == FEARG_3)
Bram Moolenaar24278d22019-08-16 21:49:22 +02003345 {
Bram Moolenaarb7f22702023-04-27 16:24:07 +01003346 if (argcount < 2)
3347 return FCERR_TOOFEW;
3348
Bram Moolenaar24278d22019-08-16 21:49:22 +02003349 // base value goes third
3350 argv[0] = argvars[0];
3351 argv[1] = argvars[1];
3352 argv[2] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003353 for (int i = 2; i < argcount; ++i)
Bram Moolenaar24278d22019-08-16 21:49:22 +02003354 argv[i + 1] = argvars[i];
3355 }
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003356 else if ((global_functions[fi].f_argtype & FEARG_MASK) == FEARG_4)
Bram Moolenaaraad222c2019-09-06 22:46:09 +02003357 {
Bram Moolenaarb7f22702023-04-27 16:24:07 +01003358 if (argcount < 3)
3359 return FCERR_TOOFEW;
3360
Bram Moolenaaraad222c2019-09-06 22:46:09 +02003361 // base value goes fourth
3362 argv[0] = argvars[0];
3363 argv[1] = argvars[1];
3364 argv[2] = argvars[2];
3365 argv[3] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003366 for (int i = 3; i < argcount; ++i)
Bram Moolenaaraad222c2019-09-06 22:46:09 +02003367 argv[i + 1] = argvars[i];
3368 }
Bram Moolenaar25e42232019-08-04 15:04:10 +02003369 else
3370 {
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003371 // FEARG_1: base value goes first
Bram Moolenaar25e42232019-08-04 15:04:10 +02003372 argv[0] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003373 for (int i = 0; i < argcount; ++i)
Bram Moolenaar25e42232019-08-04 15:04:10 +02003374 argv[i + 1] = argvars[i];
3375 }
Bram Moolenaarac92e252019-08-03 21:58:38 +02003376 argv[argcount + 1].v_type = VAR_UNKNOWN;
3377
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003378 if (check_args_for_type(fi, argcount + 1, argv) == FAIL)
3379 return FCERR_OTHER;
3380
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003381 global_functions[fi].f_func(argv, rettv);
Bram Moolenaaref140542019-12-31 21:27:13 +01003382 return FCERR_NONE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003383}
3384
3385/*
3386 * Return TRUE for a non-zero Number and a non-empty String.
3387 */
Bram Moolenaar0e57dd82019-09-16 22:56:03 +02003388 int
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003389non_zero_arg(typval_T *argvars)
3390{
3391 return ((argvars[0].v_type == VAR_NUMBER
3392 && argvars[0].vval.v_number != 0)
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01003393 || (argvars[0].v_type == VAR_BOOL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003394 && argvars[0].vval.v_number == VVAL_TRUE)
3395 || (argvars[0].v_type == VAR_STRING
3396 && argvars[0].vval.v_string != NULL
3397 && *argvars[0].vval.v_string != NUL));
3398}
3399
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003400/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003401 * "and(expr, expr)" function
3402 */
3403 static void
3404f_and(typval_T *argvars, typval_T *rettv)
3405{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003406 if (in_vim9script()
3407 && (check_for_number_arg(argvars, 0) == FAIL
3408 || check_for_number_arg(argvars, 1) == FAIL))
3409 return;
3410
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003411 rettv->vval.v_number = tv_get_number_chk(&argvars[0], NULL)
3412 & tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaarca851592018-06-06 21:04:07 +02003413}
3414
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003415/*
Bram Moolenaar59716a22017-03-01 20:32:44 +01003416 * "balloon_show()" function
3417 */
3418#ifdef FEAT_BEVAL
3419 static void
Bram Moolenaarbe0a2592019-05-09 13:50:16 +02003420f_balloon_gettext(typval_T *argvars UNUSED, typval_T *rettv)
3421{
3422 rettv->v_type = VAR_STRING;
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003423 if (balloonEval == NULL)
3424 return;
3425
3426 if (balloonEval->msg == NULL)
3427 rettv->vval.v_string = NULL;
3428 else
3429 rettv->vval.v_string = vim_strsave(balloonEval->msg);
Bram Moolenaarbe0a2592019-05-09 13:50:16 +02003430}
3431
3432 static void
Bram Moolenaar59716a22017-03-01 20:32:44 +01003433f_balloon_show(typval_T *argvars, typval_T *rettv UNUSED)
3434{
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003435 if (balloonEval == NULL)
3436 return;
3437
3438 if (in_vim9script()
3439 && check_for_string_or_list_arg(argvars, 0) == FAIL)
3440 return;
3441
3442 if (argvars[0].v_type == VAR_LIST
3443# ifdef FEAT_GUI
3444 && !gui.in_use
3445# endif
3446 )
Bram Moolenaar246fe032017-11-19 19:56:27 +01003447 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003448 list_T *l = argvars[0].vval.v_list;
3449
3450 // empty list removes the balloon
3451 post_balloon(balloonEval, NULL,
3452 l == NULL || l->lv_len == 0 ? NULL : l);
3453 }
3454 else
3455 {
3456 char_u *mesg;
3457
3458 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003459 return;
3460
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003461 mesg = tv_get_string_chk(&argvars[0]);
3462 if (mesg != NULL)
3463 // empty string removes the balloon
3464 post_balloon(balloonEval, *mesg == NUL ? NULL : mesg, NULL);
Bram Moolenaar246fe032017-11-19 19:56:27 +01003465 }
3466}
3467
Bram Moolenaar669a8282017-11-19 20:13:05 +01003468# if defined(FEAT_BEVAL_TERM)
Bram Moolenaar246fe032017-11-19 19:56:27 +01003469 static void
3470f_balloon_split(typval_T *argvars, typval_T *rettv UNUSED)
3471{
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003472 if (rettv_list_alloc(rettv) != OK)
3473 return;
3474
3475 char_u *msg;
3476
3477 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
3478 return;
3479 msg = tv_get_string_chk(&argvars[0]);
3480 if (msg != NULL)
Bram Moolenaar246fe032017-11-19 19:56:27 +01003481 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003482 pumitem_T *array;
3483 int size = split_message(msg, &array);
Bram Moolenaar246fe032017-11-19 19:56:27 +01003484
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003485 // Skip the first and last item, they are always empty.
3486 for (int i = 1; i < size - 1; ++i)
3487 list_append_string(rettv->vval.v_list, array[i].pum_text, -1);
3488 while (size > 0)
3489 vim_free(array[--size].pum_text);
3490 vim_free(array);
Bram Moolenaar246fe032017-11-19 19:56:27 +01003491 }
Bram Moolenaar59716a22017-03-01 20:32:44 +01003492}
Bram Moolenaar669a8282017-11-19 20:13:05 +01003493# endif
Bram Moolenaar59716a22017-03-01 20:32:44 +01003494#endif
3495
Yegappan Lakshmanan810785c2024-12-30 10:29:44 +01003496// Base64 character set
3497static const char_u base64_table[] = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
3498
3499// Base64 decoding table (initialized in init_base64_dec_table() below)
3500static char_u base64_dec_table[256];
3501
3502/*
3503 * Initialize the base64 decoding table
3504 */
3505 static void
3506init_base64_dec_table(void)
3507{
3508 static int base64_dec_tbl_initialized = FALSE;
3509
3510 if (base64_dec_tbl_initialized)
3511 return;
3512
3513 // Unsupported characters are set to 0xFF
3514 vim_memset(base64_dec_table, 0xFF, sizeof(base64_dec_table));
3515
3516 // Initialize the index for the base64 alphabets
3517 for (size_t i = 0; i < sizeof(base64_table) - 1; i++)
3518 base64_dec_table[(char_u)base64_table[i]] = (char_u)i;
3519
3520 // base64 padding character
3521 base64_dec_table['='] = 0;
3522
3523 base64_dec_tbl_initialized = TRUE;
3524}
3525
3526/*
3527 * Encode the bytes in "blob" using base-64 encoding.
3528 */
3529 static char_u *
3530base64_encode(blob_T *blob)
3531{
3532 size_t input_len = blob->bv_ga.ga_len;
3533 size_t encoded_len = ((input_len + 2) / 3) * 4;
3534 char_u *data = blob->bv_ga.ga_data;
3535
3536 char_u *encoded = alloc(encoded_len + 1);
3537 if (encoded == NULL)
3538 return NULL;
3539
3540 size_t i, j;
3541 for (i = 0, j = 0; i < input_len;)
3542 {
3543 int_u octet_a = i < input_len ? data[i++] : 0;
3544 int_u octet_b = i < input_len ? data[i++] : 0;
3545 int_u octet_c = i < input_len ? data[i++] : 0;
3546
3547 int_u triple = (octet_a << 16) | (octet_b << 8) | octet_c;
3548
3549 encoded[j++] = base64_table[(triple >> 18) & 0x3F];
3550 encoded[j++] = base64_table[(triple >> 12) & 0x3F];
3551 encoded[j++] = (!octet_b && i >= input_len) ? '='
3552 : base64_table[(triple >> 6) & 0x3F];
3553 encoded[j++] = (!octet_c && i >= input_len) ? '='
3554 : base64_table[triple & 0x3F];
3555 }
3556 encoded[j] = NUL;
3557
3558 return encoded;
3559}
3560
3561/*
3562 * Decode the string "data" using base-64 encoding.
3563 */
3564 static void
3565base64_decode(const char_u *data, blob_T *blob)
3566{
3567 size_t input_len = STRLEN(data);
3568
3569 if (input_len == 0)
3570 return;
3571
3572 if (input_len % 4 != 0)
3573 {
3574 // Invalid input length
3575 semsg(_(e_invalid_argument_str), data);
3576 return;
3577 }
3578
3579 init_base64_dec_table();
3580
3581 size_t decoded_len = (input_len / 4) * 3;
3582 if (data[input_len - 1] == '=')
3583 decoded_len--;
3584 if (data[input_len - 2] == '=')
3585 decoded_len--;
3586
3587 size_t i, j;
3588 for (i = 0, j = 0; i < input_len;)
3589 {
3590 int_u sextet_a = base64_dec_table[(char_u)data[i++]];
3591 int_u sextet_b = base64_dec_table[(char_u)data[i++]];
3592 int_u sextet_c = base64_dec_table[(char_u)data[i++]];
3593 int_u sextet_d = base64_dec_table[(char_u)data[i++]];
3594
3595 if (sextet_a == 0xFF || sextet_b == 0xFF || sextet_c == 0xFF
3596 || sextet_d == 0xFF)
3597 {
3598 // Invalid character
3599 semsg(_(e_invalid_argument_str), data);
3600 ga_clear(&blob->bv_ga);
3601 return;
3602 }
3603
3604 int_u triple = (sextet_a << 18) | (sextet_b << 12)
3605 | (sextet_c << 6) | sextet_d;
3606
3607 if (j < decoded_len)
3608 {
3609 ga_append(&blob->bv_ga, (triple >> 16) & 0xFF);
3610 j++;
3611 }
3612 if (j < decoded_len)
3613 {
3614 ga_append(&blob->bv_ga, (triple >> 8) & 0xFF);
3615 j++;
3616 }
3617 if (j < decoded_len)
3618 {
3619 ga_append(&blob->bv_ga, triple & 0xFF);
3620 j++;
3621 }
3622
3623 if (j == decoded_len)
3624 {
3625 // Check for invalid padding bytes (based on the
3626 // "Base64 Malleability in Practice" ACM paper).
3627 if ((data[input_len - 2] == '=' && ((sextet_b & 0xF) != 0))
3628 || ((data[input_len - 1] == '=') && ((sextet_c & 0x3) != 0)))
3629 {
3630 semsg(_(e_invalid_argument_str), data);
3631 ga_clear(&blob->bv_ga);
3632 return;
3633 }
3634 }
3635 }
3636}
3637
3638/*
3639 * "base64_decode(string)" function
3640 */
3641 static void
3642f_base64_decode(typval_T *argvars, typval_T *rettv)
3643{
3644 if (check_for_string_arg(argvars, 0) == FAIL)
3645 return;
3646
3647 if (rettv_blob_alloc(rettv) == FAIL)
3648 return;
3649
3650 char_u *str = tv_get_string_chk(&argvars[0]);
3651 if (str != NULL)
3652 base64_decode(str, rettv->vval.v_blob);
3653}
3654
3655/*
3656 * "base64_encode(blob)" function
3657 */
3658 static void
3659f_base64_encode(typval_T *argvars, typval_T *rettv)
3660{
3661 if (check_for_blob_arg(argvars, 0) == FAIL)
3662 return;
3663
3664 rettv->v_type = VAR_STRING;
3665 rettv->vval.v_string = NULL;
3666
3667 blob_T *blob = argvars->vval.v_blob;
3668 if (blob != NULL)
3669 rettv->vval.v_string = base64_encode(blob);
3670}
3671
Bram Moolenaar59716a22017-03-01 20:32:44 +01003672/*
Bram Moolenaar6b7b7192019-01-11 13:42:41 +01003673 * Get the buffer from "arg" and give an error and return NULL if it is not
3674 * valid.
3675 */
Bram Moolenaara3347722019-05-11 21:14:24 +02003676 buf_T *
Bram Moolenaar6b7b7192019-01-11 13:42:41 +01003677get_buf_arg(typval_T *arg)
3678{
3679 buf_T *buf;
3680
3681 ++emsg_off;
3682 buf = tv_get_buf(arg, FALSE);
3683 --emsg_off;
3684 if (buf == NULL)
Bram Moolenaard82a47d2022-01-05 20:24:39 +00003685 semsg(_(e_invalid_buffer_name_str), tv_get_string(arg));
Bram Moolenaar6b7b7192019-01-11 13:42:41 +01003686 return buf;
3687}
3688
3689/*
Christ van Willegence0ef912024-06-20 23:41:59 +02003690 * "bindtextdomain(package, path)" function
3691 */
3692 static void
Christ van Willegen8252ef12024-07-11 21:36:21 +02003693f_bindtextdomain(typval_T *argvars, typval_T *rettv)
Christ van Willegence0ef912024-06-20 23:41:59 +02003694{
Christ van Willegen8252ef12024-07-11 21:36:21 +02003695 rettv->v_type = VAR_BOOL;
3696 rettv->vval.v_number = VVAL_TRUE;
3697
Christ van Willegence0ef912024-06-20 23:41:59 +02003698 if (check_for_nonempty_string_arg(argvars, 0) == FAIL
3699 || check_for_nonempty_string_arg(argvars, 1) == FAIL)
3700 return;
3701
3702 if (strcmp((const char *)argvars[0].vval.v_string, VIMPACKAGE) == 0)
3703 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[0]));
3704 else
Christ van Willegen8252ef12024-07-11 21:36:21 +02003705 {
3706 if (bindtextdomain((const char *)argvars[0].vval.v_string, (const char *)argvars[1].vval.v_string) == NULL)
3707 {
3708 do_outofmem_msg((long)0);
3709 rettv->vval.v_number = VVAL_FALSE;
3710 }
3711 }
Christ van Willegence0ef912024-06-20 23:41:59 +02003712
3713 return;
3714}
3715
3716/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003717 * "byte2line(byte)" function
3718 */
3719 static void
3720f_byte2line(typval_T *argvars UNUSED, typval_T *rettv)
3721{
3722#ifndef FEAT_BYTEOFF
3723 rettv->vval.v_number = -1;
3724#else
3725 long boff = 0;
3726
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003727 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
3728 return;
3729
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01003730 boff = tv_get_number(&argvars[0]) - 1; // boff gets -1 on type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003731 if (boff < 0)
3732 rettv->vval.v_number = -1;
3733 else
3734 rettv->vval.v_number = ml_find_line_or_offset(curbuf,
3735 (linenr_T)0, &boff);
3736#endif
3737}
3738
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003739/*
3740 * "call(func, arglist [, dict])" function
3741 */
3742 static void
3743f_call(typval_T *argvars, typval_T *rettv)
3744{
3745 char_u *func;
3746 partial_T *partial = NULL;
3747 dict_T *selfdict = NULL;
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003748 char_u *tofree = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003749
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02003750 if (in_vim9script()
Bram Moolenaar223d0a62021-12-25 19:29:21 +00003751 && (check_for_string_or_func_arg(argvars, 0) == FAIL
3752 || check_for_list_arg(argvars, 1) == FAIL
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02003753 || check_for_opt_dict_arg(argvars, 2) == FAIL))
3754 return;
3755
Bram Moolenaard83392a2022-09-01 12:22:46 +01003756 if (check_for_list_arg(argvars, 1) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003757 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003758 if (argvars[1].vval.v_list == NULL)
3759 return;
3760
3761 if (argvars[0].v_type == VAR_FUNC)
3762 func = argvars[0].vval.v_string;
3763 else if (argvars[0].v_type == VAR_PARTIAL)
3764 {
3765 partial = argvars[0].vval.v_partial;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02003766 func = partial_name(partial);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003767 }
3768 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003769 func = tv_get_string(&argvars[0]);
Dominique Pellefe8ebdb2021-05-13 14:55:55 +02003770 if (func == NULL || *func == NUL)
3771 return; // type error, empty name or null function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003772
Yegappan Lakshmanan9904cbc2025-01-15 18:25:19 +01003773 if (argvars[0].v_type == VAR_STRING)
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003774 {
Yegappan Lakshmanan9904cbc2025-01-15 18:25:19 +01003775 char_u *p = func;
3776 tofree = trans_function_name(&p, NULL, FALSE, TFN_INT|TFN_QUIET);
3777 if (tofree == NULL)
3778 {
3779 emsg_funcname(e_unknown_function_str, func);
3780 return;
3781 }
3782 func = tofree;
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003783 }
3784
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003785 if (argvars[2].v_type != VAR_UNKNOWN)
3786 {
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +01003787 if (check_for_dict_arg(argvars, 2) == FAIL)
Yegappan Lakshmanan6289f912025-01-14 17:13:36 +01003788 goto done;
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +01003789
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003790 selfdict = argvars[2].vval.v_dict;
3791 }
3792
3793 (void)func_call(func, &argvars[1], partial, selfdict, rettv);
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003794
Yegappan Lakshmanan6289f912025-01-14 17:13:36 +01003795done:
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003796 vim_free(tofree);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003797}
3798
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003799/*
3800 * "changenr()" function
3801 */
3802 static void
3803f_changenr(typval_T *argvars UNUSED, typval_T *rettv)
3804{
3805 rettv->vval.v_number = curbuf->b_u_seq_cur;
3806}
3807
3808/*
3809 * "char2nr(string)" function
3810 */
3811 static void
3812f_char2nr(typval_T *argvars, typval_T *rettv)
3813{
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02003814 if (in_vim9script()
3815 && (check_for_string_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02003816 || check_for_opt_bool_arg(argvars, 1) == FAIL))
Bram Moolenaarc5809432021-03-27 21:23:30 +01003817 return;
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02003818
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003819 if (has_mbyte)
3820 {
3821 int utf8 = 0;
3822
3823 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaar24f77502020-09-04 19:50:57 +02003824 utf8 = (int)tv_get_bool_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003825
3826 if (utf8)
Bram Moolenaarbdace832019-03-02 10:13:42 +01003827 rettv->vval.v_number = utf_ptr2char(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003828 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003829 rettv->vval.v_number = (*mb_ptr2char)(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003830 }
3831 else
Bram Moolenaar13505972019-01-24 15:04:48 +01003832 rettv->vval.v_number = tv_get_string(&argvars[0])[0];
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003833}
3834
Bram Moolenaar17793ef2020-12-28 12:56:58 +01003835/*
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003836 * Get the current cursor column and store it in 'rettv'. If 'charcol' is TRUE,
3837 * returns the character index of the column. Otherwise, returns the byte index
3838 * of the column.
3839 */
3840 static void
3841get_col(typval_T *argvars, typval_T *rettv, int charcol)
3842{
3843 colnr_T col = 0;
3844 pos_T *fp;
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00003845 switchwin_T switchwin;
3846 int winchanged = FALSE;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003847
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00003848 if (check_for_string_or_list_arg(argvars, 0) == FAIL
3849 || check_for_opt_number_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003850 return;
3851
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00003852 if (argvars[1].v_type != VAR_UNKNOWN)
3853 {
3854 tabpage_T *tp;
3855 win_T *wp;
3856
3857 // use the window specified in the second argument
3858 wp = win_id2wp_tp((int)tv_get_number(&argvars[1]), &tp);
3859 if (wp == NULL || tp == NULL)
3860 return;
3861
3862 if (switch_win_noblock(&switchwin, wp, tp, TRUE) != OK)
3863 return;
3864
3865 check_cursor();
3866 winchanged = TRUE;
3867 }
3868
3869 int fnum = curbuf->b_fnum;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003870 fp = var2fpos(&argvars[0], FALSE, &fnum, charcol);
3871 if (fp != NULL && fnum == curbuf->b_fnum)
3872 {
3873 if (fp->col == MAXCOL)
3874 {
3875 // '> can be MAXCOL, get the length of the line then
3876 if (fp->lnum <= curbuf->b_ml.ml_line_count)
John Marriottbfcc8952024-03-11 22:04:45 +01003877 col = ml_get_len(fp->lnum) + 1;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003878 else
3879 col = MAXCOL;
3880 }
3881 else
3882 {
3883 col = fp->col + 1;
3884 // col(".") when the cursor is on the NUL at the end of the line
3885 // because of "coladd" can be seen as an extra column.
3886 if (virtual_active() && fp == &curwin->w_cursor)
3887 {
3888 char_u *p = ml_get_cursor();
3889
3890 if (curwin->w_cursor.coladd >= (colnr_T)chartabsize(p,
3891 curwin->w_virtcol - curwin->w_cursor.coladd))
3892 {
3893 int l;
3894
3895 if (*p != NUL && p[(l = (*mb_ptr2len)(p))] == NUL)
3896 col += l;
3897 }
3898 }
3899 }
3900 }
3901 rettv->vval.v_number = col;
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00003902
3903 if (winchanged)
3904 restore_win_noblock(&switchwin, TRUE);
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003905}
3906
3907/*
3908 * "charcol()" function
3909 */
3910 static void
3911f_charcol(typval_T *argvars, typval_T *rettv)
3912{
3913 get_col(argvars, rettv, TRUE);
3914}
3915
Bram Moolenaar29b7d7a2019-07-22 23:03:57 +02003916 win_T *
Bram Moolenaaraff74912019-03-30 18:11:49 +01003917get_optional_window(typval_T *argvars, int idx)
3918{
3919 win_T *win = curwin;
3920
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003921 if (argvars[idx].v_type == VAR_UNKNOWN)
3922 return curwin;
3923
3924 win = find_win_by_nr_or_id(&argvars[idx]);
3925 if (win == NULL)
Bram Moolenaaraff74912019-03-30 18:11:49 +01003926 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003927 emsg(_(e_invalid_window_number));
3928 return NULL;
Bram Moolenaaraff74912019-03-30 18:11:49 +01003929 }
3930 return win;
3931}
3932
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003933/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003934 * "col(string)" function
3935 */
3936 static void
3937f_col(typval_T *argvars, typval_T *rettv)
3938{
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003939 get_col(argvars, rettv, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003940}
3941
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003942/*
3943 * "confirm(message, buttons[, default [, type]])" function
3944 */
3945 static void
3946f_confirm(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
3947{
3948#if defined(FEAT_GUI_DIALOG) || defined(FEAT_CON_DIALOG)
3949 char_u *message;
3950 char_u *buttons = NULL;
3951 char_u buf[NUMBUFLEN];
3952 char_u buf2[NUMBUFLEN];
3953 int def = 1;
3954 int type = VIM_GENERIC;
3955 char_u *typestr;
3956 int error = FALSE;
3957
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02003958 if (in_vim9script()
3959 && (check_for_string_arg(argvars, 0) == FAIL
3960 || (check_for_opt_string_arg(argvars, 1) == FAIL
3961 || (argvars[1].v_type != VAR_UNKNOWN
3962 && (check_for_opt_number_arg(argvars, 2) == FAIL
3963 || (argvars[2].v_type != VAR_UNKNOWN
3964 && check_for_opt_string_arg(argvars, 3) == FAIL))))))
Bram Moolenaarc5809432021-03-27 21:23:30 +01003965 return;
3966
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003967 message = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003968 if (message == NULL)
3969 error = TRUE;
3970 if (argvars[1].v_type != VAR_UNKNOWN)
3971 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003972 buttons = tv_get_string_buf_chk(&argvars[1], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003973 if (buttons == NULL)
3974 error = TRUE;
3975 if (argvars[2].v_type != VAR_UNKNOWN)
3976 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003977 def = (int)tv_get_number_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003978 if (argvars[3].v_type != VAR_UNKNOWN)
3979 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003980 typestr = tv_get_string_buf_chk(&argvars[3], buf2);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003981 if (typestr == NULL)
3982 error = TRUE;
3983 else
3984 {
3985 switch (TOUPPER_ASC(*typestr))
3986 {
3987 case 'E': type = VIM_ERROR; break;
3988 case 'Q': type = VIM_QUESTION; break;
3989 case 'I': type = VIM_INFO; break;
3990 case 'W': type = VIM_WARNING; break;
3991 case 'G': type = VIM_GENERIC; break;
3992 }
3993 }
3994 }
3995 }
3996 }
3997
3998 if (buttons == NULL || *buttons == NUL)
3999 buttons = (char_u *)_("&Ok");
4000
4001 if (!error)
4002 rettv->vval.v_number = do_dialog(type, NULL, message, buttons,
4003 def, NULL, FALSE);
4004#endif
4005}
4006
4007/*
4008 * "copy()" function
4009 */
4010 static void
4011f_copy(typval_T *argvars, typval_T *rettv)
4012{
Bram Moolenaar381692b2022-02-02 20:01:27 +00004013 item_copy(&argvars[0], rettv, FALSE, TRUE, 0);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004014}
4015
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004016/*
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004017 * Set the cursor position.
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01004018 * If "charcol" is TRUE, then use the column number as a character offset.
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004019 * Otherwise use the column number as a byte offset.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004020 */
4021 static void
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004022set_cursorpos(typval_T *argvars, typval_T *rettv, int charcol)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004023{
Bram Moolenaar79f23442022-10-10 12:42:57 +01004024 long lnum, col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004025 long coladd = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004026 int set_curswant = TRUE;
4027
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004028 if (in_vim9script()
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004029 && (check_for_string_or_number_or_list_arg(argvars, 0) == FAIL
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02004030 || check_for_opt_number_arg(argvars, 1) == FAIL
4031 || (argvars[1].v_type != VAR_UNKNOWN
4032 && check_for_opt_number_arg(argvars, 2) == FAIL)))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004033 return;
4034
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004035 rettv->vval.v_number = -1;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004036 if (argvars[0].v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004037 {
4038 pos_T pos;
4039 colnr_T curswant = -1;
4040
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004041 if (list2fpos(argvars, &pos, NULL, &curswant, charcol) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004042 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00004043 emsg(_(e_invalid_argument));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004044 return;
4045 }
Bram Moolenaar79f23442022-10-10 12:42:57 +01004046 lnum = pos.lnum;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004047 col = pos.col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004048 coladd = pos.coladd;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004049 if (curswant >= 0)
4050 {
4051 curwin->w_curswant = curswant - 1;
4052 set_curswant = FALSE;
4053 }
4054 }
Bram Moolenaar79f23442022-10-10 12:42:57 +01004055 else if ((argvars[0].v_type == VAR_NUMBER
4056 || argvars[0].v_type == VAR_STRING)
4057 && (argvars[1].v_type == VAR_NUMBER
4058 || argvars[1].v_type == VAR_STRING))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004059 {
Bram Moolenaar79f23442022-10-10 12:42:57 +01004060 lnum = tv_get_lnum(argvars);
4061 if (lnum < 0)
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00004062 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[0]));
Bram Moolenaar79f23442022-10-10 12:42:57 +01004063 else if (lnum == 0)
4064 lnum = curwin->w_cursor.lnum;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004065 col = (long)tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004066 if (charcol)
Bram Moolenaar79f23442022-10-10 12:42:57 +01004067 col = buf_charidx_to_byteidx(curbuf, lnum, col) + 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004068 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004069 coladd = (long)tv_get_number_chk(&argvars[2], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004070 }
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004071 else
4072 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00004073 emsg(_(e_invalid_argument));
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004074 return;
4075 }
Bram Moolenaar79f23442022-10-10 12:42:57 +01004076 if (lnum < 0 || col < 0 || coladd < 0)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004077 return; // type error; errmsg already given
Bram Moolenaar79f23442022-10-10 12:42:57 +01004078 if (lnum > 0)
4079 curwin->w_cursor.lnum = lnum;
zeertzjq2ffdae72024-05-02 13:06:24 +02004080 if (col != MAXCOL && --col < 0)
4081 col = 0;
4082 curwin->w_cursor.col = col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004083 curwin->w_cursor.coladd = coladd;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004084
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004085 // Make sure the cursor is in a valid position.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004086 check_cursor();
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004087 // Correct cursor for multi-byte character.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004088 if (has_mbyte)
4089 mb_adjust_cursor();
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004090
4091 curwin->w_set_curswant = set_curswant;
4092 rettv->vval.v_number = 0;
4093}
4094
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004095/*
4096 * "cursor(lnum, col)" function, or
4097 * "cursor(list)"
4098 *
4099 * Moves the cursor to the specified line and column.
4100 * Returns 0 when the position could be set, -1 otherwise.
4101 */
4102 static void
4103f_cursor(typval_T *argvars, typval_T *rettv)
4104{
4105 set_cursorpos(argvars, rettv, FALSE);
4106}
4107
Bram Moolenaar4f974752019-02-17 17:44:42 +01004108#ifdef MSWIN
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004109/*
4110 * "debugbreak()" function
4111 */
4112 static void
4113f_debugbreak(typval_T *argvars, typval_T *rettv)
4114{
4115 int pid;
4116
4117 rettv->vval.v_number = FAIL;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004118 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
4119 return;
4120
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004121 pid = (int)tv_get_number(&argvars[0]);
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004122 if (pid == 0)
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004123 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00004124 emsg(_(e_invalid_argument));
4125 return;
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004126 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00004127
4128 HANDLE hProcess = OpenProcess(PROCESS_ALL_ACCESS, 0, pid);
4129 if (hProcess == NULL)
4130 return;
4131
4132 DebugBreakProcess(hProcess);
4133 CloseHandle(hProcess);
4134 rettv->vval.v_number = OK;
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004135}
4136#endif
4137
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004138/*
4139 * "deepcopy()" function
4140 */
4141 static void
4142f_deepcopy(typval_T *argvars, typval_T *rettv)
4143{
Bram Moolenaar239f8d92021-01-17 13:21:20 +01004144 varnumber_T noref = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004145
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +01004146 if (check_for_opt_bool_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004147 return;
4148
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004149 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaar239f8d92021-01-17 13:21:20 +01004150 noref = tv_get_bool_chk(&argvars[1], NULL);
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +01004151
4152 item_copy(&argvars[0], rettv, TRUE, TRUE, noref == 0 ? get_copyID() : 0);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004153}
4154
4155/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004156 * "did_filetype()" function
4157 */
4158 static void
4159f_did_filetype(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
4160{
zeertzjq5bf6c212024-03-31 18:41:27 +02004161 rettv->vval.v_number = curbuf->b_did_filetype;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004162}
4163
4164/*
Bram Moolenaar4132eb52020-02-14 16:53:00 +01004165 * "echoraw({expr})" function
4166 */
4167 static void
4168f_echoraw(typval_T *argvars, typval_T *rettv UNUSED)
4169{
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02004170 char_u *str;
Bram Moolenaar4132eb52020-02-14 16:53:00 +01004171
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02004172 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
4173 return;
4174
4175 str = tv_get_string_chk(&argvars[0]);
Bram Moolenaar4132eb52020-02-14 16:53:00 +01004176 if (str != NULL && *str != NUL)
4177 {
4178 out_str(str);
4179 out_flush();
4180 }
4181}
4182
4183/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004184 * "empty({expr})" function
4185 */
4186 static void
4187f_empty(typval_T *argvars, typval_T *rettv)
4188{
4189 int n = FALSE;
4190
4191 switch (argvars[0].v_type)
4192 {
4193 case VAR_STRING:
4194 case VAR_FUNC:
4195 n = argvars[0].vval.v_string == NULL
4196 || *argvars[0].vval.v_string == NUL;
4197 break;
4198 case VAR_PARTIAL:
Yegappan Lakshmananda9d3452024-05-02 13:02:36 +02004199 n = argvars[0].vval.v_partial == NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004200 break;
4201 case VAR_NUMBER:
4202 n = argvars[0].vval.v_number == 0;
4203 break;
4204 case VAR_FLOAT:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004205 n = argvars[0].vval.v_float == 0.0;
4206 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004207 case VAR_LIST:
4208 n = argvars[0].vval.v_list == NULL
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004209 || argvars[0].vval.v_list->lv_len == 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004210 break;
4211 case VAR_DICT:
4212 n = argvars[0].vval.v_dict == NULL
4213 || argvars[0].vval.v_dict->dv_hashtab.ht_used == 0;
4214 break;
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01004215 case VAR_BOOL:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004216 case VAR_SPECIAL:
4217 n = argvars[0].vval.v_number != VVAL_TRUE;
4218 break;
Bram Moolenaar00b28d62022-12-08 15:32:33 +00004219 case VAR_CLASS:
4220 n = argvars[0].vval.v_class != NULL;
4221 break;
4222 case VAR_OBJECT:
Yegappan Lakshmanand3eae7b2024-03-03 16:26:58 +01004223 n = object_empty(argvars[0].vval.v_object);
Bram Moolenaar00b28d62022-12-08 15:32:33 +00004224 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004225
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01004226 case VAR_BLOB:
4227 n = argvars[0].vval.v_blob == NULL
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01004228 || argvars[0].vval.v_blob->bv_ga.ga_len == 0;
4229 break;
4230
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004231 case VAR_JOB:
4232#ifdef FEAT_JOB_CHANNEL
4233 n = argvars[0].vval.v_job == NULL
4234 || argvars[0].vval.v_job->jv_status != JOB_STARTED;
4235 break;
4236#endif
4237 case VAR_CHANNEL:
4238#ifdef FEAT_JOB_CHANNEL
4239 n = argvars[0].vval.v_channel == NULL
4240 || !channel_is_open(argvars[0].vval.v_channel);
4241 break;
4242#endif
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +02004243 case VAR_TYPEALIAS:
4244 n = argvars[0].vval.v_typealias == NULL
4245 || argvars[0].vval.v_typealias->ta_name == NULL
4246 || *argvars[0].vval.v_typealias->ta_name == NUL;
4247 break;
4248
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004249 case VAR_UNKNOWN:
Bram Moolenaar4c683752020-04-05 21:38:23 +02004250 case VAR_ANY:
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004251 case VAR_VOID:
Bram Moolenaarf18332f2021-05-07 17:55:55 +02004252 case VAR_INSTR:
Bram Moolenaardd589232020-02-29 17:38:12 +01004253 internal_error_no_abort("f_empty(UNKNOWN)");
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004254 n = TRUE;
4255 break;
4256 }
4257
4258 rettv->vval.v_number = n;
4259}
4260
4261/*
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004262 * "environ()" function
4263 */
4264 static void
4265f_environ(typval_T *argvars UNUSED, typval_T *rettv)
4266{
4267#if !defined(AMIGA)
4268 int i = 0;
4269 char_u *entry, *value;
Bram Moolenaar68aaff42022-04-17 10:57:44 +01004270# if defined (MSWIN)
4271# if !defined(_UCRT)
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004272 extern wchar_t **_wenviron;
Bram Moolenaar68aaff42022-04-17 10:57:44 +01004273# endif
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004274# else
4275 extern char **environ;
4276# endif
4277
Bram Moolenaar93a10962022-06-16 11:42:09 +01004278 if (rettv_dict_alloc(rettv) == FAIL)
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004279 return;
4280
4281# ifdef MSWIN
4282 if (*_wenviron == NULL)
4283 return;
4284# else
4285 if (*environ == NULL)
4286 return;
4287# endif
4288
4289 for (i = 0; ; ++i)
4290 {
4291# ifdef MSWIN
4292 short_u *p;
4293
4294 if ((p = (short_u *)_wenviron[i]) == NULL)
4295 return;
4296 entry = utf16_to_enc(p, NULL);
4297# else
4298 if ((entry = (char_u *)environ[i]) == NULL)
4299 return;
4300 entry = vim_strsave(entry);
4301# endif
4302 if (entry == NULL) // out of memory
4303 return;
4304 if ((value = vim_strchr(entry, '=')) == NULL)
4305 {
4306 vim_free(entry);
4307 continue;
4308 }
4309 *value++ = NUL;
4310 dict_add_string(rettv->vval.v_dict, (char *)entry, value);
4311 vim_free(entry);
4312 }
4313#endif
4314}
4315
4316/*
Bram Moolenaar80adaa82023-07-07 18:57:40 +01004317 * "err_teapot()" function
4318 */
4319 static void
4320f_err_teapot(typval_T *argvars, typval_T *rettv UNUSED)
4321{
4322 if (argvars[0].v_type != VAR_UNKNOWN)
4323 {
4324 if (argvars[0].v_type == VAR_STRING)
4325 {
4326 char_u *s = tv_get_string_strict(&argvars[0]);
Sean Dewarb0efa492023-07-08 10:35:19 +01004327 if (*skipwhite(s) == NUL)
Bram Moolenaar80adaa82023-07-07 18:57:40 +01004328 return;
4329 }
4330
4331 int err = FALSE;
4332 int do_503 = eval_expr_to_bool(&argvars[0], &err);
4333 if (!err && do_503)
4334 {
4335 emsg(_(e_coffee_currently_not_available));
4336 return;
4337 }
4338 }
4339
4340 emsg(_(e_im_a_teapot));
4341}
4342
4343/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004344 * "escape({string}, {chars})" function
4345 */
4346 static void
4347f_escape(typval_T *argvars, typval_T *rettv)
4348{
4349 char_u buf[NUMBUFLEN];
4350
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004351 if (in_vim9script()
4352 && (check_for_string_arg(argvars, 0) == FAIL
4353 || check_for_string_arg(argvars, 1) == FAIL))
4354 return;
4355
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004356 rettv->vval.v_string = vim_strsave_escaped(tv_get_string(&argvars[0]),
4357 tv_get_string_buf(&argvars[1], buf));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004358 rettv->v_type = VAR_STRING;
4359}
4360
4361/*
4362 * "eval()" function
4363 */
4364 static void
4365f_eval(typval_T *argvars, typval_T *rettv)
4366{
4367 char_u *s, *p;
4368
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004369 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
4370 return;
4371
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004372 s = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004373 if (s != NULL)
4374 s = skipwhite(s);
4375
4376 p = s;
Bram Moolenaar5409f5d2020-06-24 18:37:35 +02004377 if (s == NULL || eval1(&s, rettv, &EVALARG_EVALUATE) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004378 {
4379 if (p != NULL && !aborting())
Bram Moolenaar108010a2021-06-27 22:03:33 +02004380 semsg(_(e_invalid_expression_str), p);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004381 need_clr_eos = FALSE;
4382 rettv->v_type = VAR_NUMBER;
4383 rettv->vval.v_number = 0;
4384 }
4385 else if (*s != NUL)
Bram Moolenaar74409f62022-01-01 15:58:22 +00004386 semsg(_(e_trailing_characters_str), s);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004387}
4388
4389/*
4390 * "eventhandler()" function
4391 */
4392 static void
4393f_eventhandler(typval_T *argvars UNUSED, typval_T *rettv)
4394{
Bram Moolenaardfc33a62020-04-29 22:30:13 +02004395 rettv->vval.v_number = vgetc_busy || input_busy;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004396}
4397
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004398static garray_T redir_execute_ga;
4399
4400/*
4401 * Append "value[value_len]" to the execute() output.
4402 */
4403 void
4404execute_redir_str(char_u *value, int value_len)
4405{
4406 int len;
4407
4408 if (value_len == -1)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004409 len = (int)STRLEN(value); // Append the entire string
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004410 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004411 len = value_len; // Append only "value_len" characters
Yegappan Lakshmananfadc02a2023-01-27 21:03:12 +00004412 if (ga_grow(&redir_execute_ga, len) == FAIL)
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00004413 return;
4414
4415 mch_memmove((char *)redir_execute_ga.ga_data
4416 + redir_execute_ga.ga_len, value, len);
4417 redir_execute_ga.ga_len += len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004418}
4419
Dominique Pelle748b3082022-01-08 12:41:16 +00004420#if defined(FEAT_LUA) || defined(PROTO)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004421/*
Yegappan Lakshmanan11328bc2021-08-06 21:34:38 +02004422 * Get next line from a string containing NL separated lines.
4423 * Called by do_cmdline() to get the next line.
4424 * Returns an allocated string, or NULL when at the end of the string.
4425 */
4426 static char_u *
4427get_str_line(
4428 int c UNUSED,
4429 void *cookie,
4430 int indent UNUSED,
4431 getline_opt_T options UNUSED)
4432{
4433 char_u *start = *(char_u **)cookie;
4434 char_u *line;
4435 char_u *p;
4436
4437 p = start;
4438 if (p == NULL || *p == NUL)
4439 return NULL;
4440 p = vim_strchr(p, '\n');
4441 if (p == NULL)
4442 line = vim_strsave(start);
4443 else
4444 {
4445 line = vim_strnsave(start, p - start);
4446 p++;
4447 }
4448
4449 *(char_u **)cookie = p;
4450 return line;
4451}
4452
4453/*
4454 * Execute a series of Ex commands in 'str'
4455 */
4456 void
4457execute_cmds_from_string(char_u *str)
4458{
4459 do_cmdline(NULL, get_str_line, (void *)&str,
4460 DOCMD_NOWAIT|DOCMD_VERBOSE|DOCMD_REPEAT|DOCMD_KEYTYPED);
4461}
Dominique Pelle748b3082022-01-08 12:41:16 +00004462#endif
Yegappan Lakshmanan11328bc2021-08-06 21:34:38 +02004463
4464/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004465 * Get next line from a list.
4466 * Called by do_cmdline() to get the next line.
4467 * Returns allocated string, or NULL for end of function.
4468 */
Bram Moolenaara7583c42022-05-07 21:14:05 +01004469 char_u *
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004470get_list_line(
4471 int c UNUSED,
4472 void *cookie,
Bram Moolenaare96a2492019-06-25 04:12:16 +02004473 int indent UNUSED,
Bram Moolenaar66250c92020-08-20 15:02:42 +02004474 getline_opt_T options UNUSED)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004475{
4476 listitem_T **p = (listitem_T **)cookie;
4477 listitem_T *item = *p;
4478 char_u buf[NUMBUFLEN];
4479 char_u *s;
4480
4481 if (item == NULL)
4482 return NULL;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004483 s = tv_get_string_buf_chk(&item->li_tv, buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004484 *p = item->li_next;
4485 return s == NULL ? NULL : vim_strsave(s);
4486}
4487
4488/*
4489 * "execute()" function
4490 */
Bram Moolenaar261f3462019-09-07 15:45:32 +02004491 void
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004492execute_common(typval_T *argvars, typval_T *rettv, int arg_off)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004493{
4494 char_u *cmd = NULL;
4495 list_T *list = NULL;
4496 int save_msg_silent = msg_silent;
4497 int save_emsg_silent = emsg_silent;
4498 int save_emsg_noredir = emsg_noredir;
4499 int save_redir_execute = redir_execute;
Bram Moolenaar20951482017-12-25 13:44:43 +01004500 int save_redir_off = redir_off;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004501 garray_T save_ga;
Bram Moolenaar10ccaa12018-12-07 16:38:23 +01004502 int save_msg_col = msg_col;
Kota Kato3d3f6ac2022-08-04 18:50:14 +01004503 int save_sticky_cmdmod_flags = sticky_cmdmod_flags;
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004504 int echo_output = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004505
4506 rettv->vval.v_string = NULL;
4507 rettv->v_type = VAR_STRING;
4508
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004509 if (argvars[arg_off].v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004510 {
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004511 list = argvars[arg_off].vval.v_list;
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004512 if (list == NULL || list->lv_len == 0)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004513 // empty list, no commands, empty output
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004514 return;
4515 ++list->lv_refcount;
4516 }
Bram Moolenaare2a8f072020-01-08 19:32:18 +01004517 else if (argvars[arg_off].v_type == VAR_JOB
4518 || argvars[arg_off].v_type == VAR_CHANNEL)
4519 {
Bram Moolenaar68db9962021-05-09 23:19:22 +02004520 semsg(_(e_using_invalid_value_as_string_str),
4521 vartype_name(argvars[arg_off].v_type));
Bram Moolenaare2a8f072020-01-08 19:32:18 +01004522 return;
4523 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004524 else
4525 {
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004526 cmd = tv_get_string_chk(&argvars[arg_off]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004527 if (cmd == NULL)
4528 return;
4529 }
4530
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004531 if (argvars[arg_off + 1].v_type != VAR_UNKNOWN)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004532 {
4533 char_u buf[NUMBUFLEN];
Bram Moolenaar3cfa5b12021-06-06 14:14:39 +02004534 char_u *s = tv_get_string_buf_chk_strict(&argvars[arg_off + 1], buf,
4535 in_vim9script());
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004536
4537 if (s == NULL)
4538 return;
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004539 if (*s == NUL)
4540 echo_output = TRUE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004541 if (STRNCMP(s, "silent", 6) == 0)
4542 ++msg_silent;
4543 if (STRCMP(s, "silent!") == 0)
4544 {
4545 emsg_silent = TRUE;
4546 emsg_noredir = TRUE;
4547 }
4548 }
4549 else
4550 ++msg_silent;
4551
4552 if (redir_execute)
4553 save_ga = redir_execute_ga;
Bram Moolenaar04935fb2022-01-08 16:19:22 +00004554 ga_init2(&redir_execute_ga, sizeof(char), 500);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004555 redir_execute = TRUE;
Bram Moolenaar20951482017-12-25 13:44:43 +01004556 redir_off = FALSE;
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004557 if (!echo_output)
4558 msg_col = 0; // prevent leading spaces
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004559
Kota Kato3d3f6ac2022-08-04 18:50:14 +01004560 // For "legacy call execute('cmd')" and "vim9cmd execute('cmd')" apply the
4561 // command modifiers to "cmd".
4562 sticky_cmdmod_flags = cmdmod.cmod_flags & (CMOD_LEGACY | CMOD_VIM9CMD);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004563 if (cmd != NULL)
4564 do_cmdline_cmd(cmd);
4565 else
4566 {
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004567 listitem_T *item;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004568
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02004569 CHECK_LIST_MATERIALIZE(list);
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004570 item = list->lv_first;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004571 do_cmdline(NULL, get_list_line, (void *)&item,
4572 DOCMD_NOWAIT|DOCMD_VERBOSE|DOCMD_REPEAT|DOCMD_KEYTYPED);
4573 --list->lv_refcount;
4574 }
Kota Kato3d3f6ac2022-08-04 18:50:14 +01004575 sticky_cmdmod_flags = save_sticky_cmdmod_flags;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004576
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004577 // Need to append a NUL to the result.
Bram Moolenaard297f352017-01-29 20:31:21 +01004578 if (ga_grow(&redir_execute_ga, 1) == OK)
4579 {
4580 ((char *)redir_execute_ga.ga_data)[redir_execute_ga.ga_len] = NUL;
4581 rettv->vval.v_string = redir_execute_ga.ga_data;
4582 }
4583 else
4584 {
4585 ga_clear(&redir_execute_ga);
4586 rettv->vval.v_string = NULL;
4587 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004588 msg_silent = save_msg_silent;
4589 emsg_silent = save_emsg_silent;
4590 emsg_noredir = save_emsg_noredir;
4591
4592 redir_execute = save_redir_execute;
4593 if (redir_execute)
4594 redir_execute_ga = save_ga;
Bram Moolenaar20951482017-12-25 13:44:43 +01004595 redir_off = save_redir_off;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004596
Bram Moolenaar10ccaa12018-12-07 16:38:23 +01004597 // "silent reg" or "silent echo x" leaves msg_col somewhere in the line.
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004598 if (echo_output)
4599 // When not working silently: put it in column zero. A following
4600 // "echon" will overwrite the message, unavoidably.
4601 msg_col = 0;
4602 else
4603 // When working silently: Put it back where it was, since nothing
4604 // should have been written.
4605 msg_col = save_msg_col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004606}
4607
4608/*
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004609 * "execute()" function
4610 */
4611 static void
4612f_execute(typval_T *argvars, typval_T *rettv)
4613{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004614 if (in_vim9script()
4615 && (check_for_string_or_list_arg(argvars, 0) == FAIL
4616 || check_for_opt_string_arg(argvars, 1) == FAIL))
4617 return;
4618
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004619 execute_common(argvars, rettv, 0);
4620}
4621
4622/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004623 * "exists()" function
4624 */
Bram Moolenaarbb7ee7a2021-08-02 20:06:50 +02004625 void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004626f_exists(typval_T *argvars, typval_T *rettv)
4627{
4628 char_u *p;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004629 int n = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004630
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004631 if (in_vim9script() && check_for_nonempty_string_arg(argvars, 0) == FAIL)
4632 return;
4633
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004634 p = tv_get_string(&argvars[0]);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004635 if (*p == '$') // environment variable
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004636 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004637 // first try "normal" environment variables (fast)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004638 if (mch_getenv(p + 1) != NULL)
4639 n = TRUE;
4640 else
4641 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004642 // try expanding things like $VIM and ${HOME}
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004643 p = expand_env_save(p);
4644 if (p != NULL && *p != '$')
4645 n = TRUE;
4646 vim_free(p);
4647 }
4648 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004649 else if (*p == '&' || *p == '+') // option
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004650 {
Bram Moolenaar9a78e6d2020-07-01 18:29:55 +02004651 n = (eval_option(&p, NULL, TRUE) == OK);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004652 if (*skipwhite(p) != NUL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004653 n = FALSE; // trailing garbage
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004654 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004655 else if (*p == '*') // internal or user defined function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004656 {
Bram Moolenaarb54c3ff2016-07-31 14:11:58 +02004657 n = function_exists(p + 1, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004658 }
Bram Moolenaar15c47602020-03-26 22:16:48 +01004659 else if (*p == '?') // internal function only
4660 {
4661 n = has_internal_func_name(p + 1);
4662 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004663 else if (*p == ':')
4664 {
4665 n = cmd_exists(p + 1);
4666 }
4667 else if (*p == '#')
4668 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004669 if (p[1] == '#')
4670 n = autocmd_supported(p + 2);
4671 else
4672 n = au_exists(p + 1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004673 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004674 else // internal variable
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004675 {
Bram Moolenaarc6f9f732018-02-11 19:06:26 +01004676 n = var_exists(p);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004677 }
4678
4679 rettv->vval.v_number = n;
4680}
4681
Bram Moolenaar26735992021-08-08 14:43:22 +02004682 static void
4683f_exists_compiled(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
4684{
4685 emsg(_(e_exists_compiled_can_only_be_used_in_def_function));
4686}
4687
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004688/*
4689 * "expand()" function
4690 */
4691 static void
4692f_expand(typval_T *argvars, typval_T *rettv)
4693{
4694 char_u *s;
Mike Williams51024bb2024-05-30 07:46:30 +02004695 size_t len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004696 int options = WILD_SILENT|WILD_USE_NL|WILD_LIST_NOTFOUND;
4697 expand_T xpc;
4698 int error = FALSE;
4699 char_u *result;
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004700#ifdef BACKSLASH_IN_FILENAME
4701 char_u *p_csl_save = p_csl;
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004702#endif
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004703
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004704 if (in_vim9script()
4705 && (check_for_string_arg(argvars, 0) == FAIL
4706 || check_for_opt_bool_arg(argvars, 1) == FAIL
4707 || (argvars[1].v_type != VAR_UNKNOWN
4708 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
4709 return;
4710
4711#ifdef BACKSLASH_IN_FILENAME
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004712 // avoid using 'completeslash' here
4713 p_csl = empty_option;
4714#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004715
4716 rettv->v_type = VAR_STRING;
4717 if (argvars[1].v_type != VAR_UNKNOWN
4718 && argvars[2].v_type != VAR_UNKNOWN
Bram Moolenaar551d25e2020-09-02 21:37:56 +02004719 && tv_get_bool_chk(&argvars[2], &error)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004720 && !error)
Bram Moolenaar45cf6e92017-04-30 20:25:19 +02004721 rettv_list_set(rettv, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004722
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004723 s = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004724 if (*s == '%' || *s == '#' || *s == '<')
4725 {
Bram Moolenaar57544522022-04-12 12:54:11 +01004726 char *errormsg = NULL;
4727
4728 if (p_verbose == 0)
4729 ++emsg_off;
Bram Moolenaara96edb72022-04-28 17:52:24 +01004730 result = eval_vars(s, s, &len, NULL, &errormsg, NULL, FALSE);
Bram Moolenaar57544522022-04-12 12:54:11 +01004731 if (p_verbose == 0)
4732 --emsg_off;
4733 else if (errormsg != NULL)
4734 emsg(errormsg);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004735 if (rettv->v_type == VAR_LIST)
4736 {
Bram Moolenaar93a10962022-06-16 11:42:09 +01004737 if (rettv_list_alloc(rettv) == OK && result != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004738 list_append_string(rettv->vval.v_list, result, -1);
Bram Moolenaar86173482019-10-01 17:02:16 +02004739 vim_free(result);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004740 }
4741 else
4742 rettv->vval.v_string = result;
4743 }
4744 else
4745 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004746 // When the optional second argument is non-zero, don't remove matches
4747 // for 'wildignore' and don't put matches for 'suffixes' at the end.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004748 if (argvars[1].v_type != VAR_UNKNOWN
Bram Moolenaar551d25e2020-09-02 21:37:56 +02004749 && tv_get_bool_chk(&argvars[1], &error))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004750 options |= WILD_KEEP_ALL;
4751 if (!error)
4752 {
4753 ExpandInit(&xpc);
4754 xpc.xp_context = EXPAND_FILES;
4755 if (p_wic)
4756 options += WILD_ICASE;
4757 if (rettv->v_type == VAR_STRING)
4758 rettv->vval.v_string = ExpandOne(&xpc, s, NULL,
4759 options, WILD_ALL);
Bram Moolenaar93a10962022-06-16 11:42:09 +01004760 else if (rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004761 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004762 ExpandOne(&xpc, s, NULL, options, WILD_ALL_KEEP);
Bram Moolenaar848db572022-09-20 19:04:32 +01004763 for (int i = 0; i < xpc.xp_numfiles; i++)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004764 list_append_string(rettv->vval.v_list, xpc.xp_files[i], -1);
4765 ExpandCleanup(&xpc);
4766 }
4767 }
4768 else
4769 rettv->vval.v_string = NULL;
4770 }
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004771#ifdef BACKSLASH_IN_FILENAME
4772 p_csl = p_csl_save;
4773#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004774}
4775
4776/*
Bram Moolenaar80dad482019-06-09 17:22:31 +02004777 * "expandcmd()" function
4778 * Expand all the special characters in a command string.
4779 */
4780 static void
4781f_expandcmd(typval_T *argvars, typval_T *rettv)
4782{
4783 exarg_T eap;
4784 char_u *cmdstr;
4785 char *errormsg = NULL;
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004786 int emsgoff = TRUE;
Bram Moolenaar80dad482019-06-09 17:22:31 +02004787
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004788 if (in_vim9script()
4789 && (check_for_string_arg(argvars, 0) == FAIL
4790 || check_for_opt_dict_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004791 return;
4792
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004793 if (argvars[1].v_type == VAR_DICT
Bram Moolenaard61efa52022-07-23 09:52:04 +01004794 && dict_get_bool(argvars[1].vval.v_dict, "errmsg", VVAL_FALSE))
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004795 emsgoff = FALSE;
4796
Bram Moolenaar80dad482019-06-09 17:22:31 +02004797 rettv->v_type = VAR_STRING;
4798 cmdstr = vim_strsave(tv_get_string(&argvars[0]));
4799
Yegappan Lakshmanan960dcbd2023-03-07 17:45:11 +00004800 CLEAR_FIELD(eap);
Bram Moolenaar80dad482019-06-09 17:22:31 +02004801 eap.cmd = cmdstr;
4802 eap.arg = cmdstr;
Bram Moolenaar8071cb22019-07-12 17:58:01 +02004803 eap.argt |= EX_NOSPC;
Bram Moolenaar80dad482019-06-09 17:22:31 +02004804 eap.usefilter = FALSE;
4805 eap.nextcmd = NULL;
4806 eap.cmdidx = CMD_USER;
4807
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004808 if (emsgoff)
4809 ++emsg_off;
4810 if (expand_filename(&eap, &cmdstr, &errormsg) == FAIL)
4811 if (!emsgoff && errormsg != NULL && *errormsg != NUL)
4812 emsg(errormsg);
4813 if (emsgoff)
4814 --emsg_off;
Bram Moolenaar80dad482019-06-09 17:22:31 +02004815
4816 rettv->vval.v_string = cmdstr;
4817}
4818
4819/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004820 * "feedkeys()" function
4821 */
4822 static void
4823f_feedkeys(typval_T *argvars, typval_T *rettv UNUSED)
4824{
4825 int remap = TRUE;
4826 int insert = FALSE;
4827 char_u *keys, *flags;
4828 char_u nbuf[NUMBUFLEN];
4829 int typed = FALSE;
4830 int execute = FALSE;
Bram Moolenaara9725222022-01-16 13:30:33 +00004831 int context = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004832 int dangerous = FALSE;
Bram Moolenaar5e66b422019-01-24 21:58:10 +01004833 int lowlevel = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004834
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004835 // This is not allowed in the sandbox. If the commands would still be
4836 // executed in the sandbox it would be OK, but it probably happens later,
4837 // when "sandbox" is no longer set.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004838 if (check_secure())
4839 return;
4840
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004841 if (in_vim9script()
4842 && (check_for_string_arg(argvars, 0) == FAIL
4843 || check_for_opt_string_arg(argvars, 1) == FAIL))
4844 return;
4845
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004846 keys = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004847
4848 if (argvars[1].v_type != VAR_UNKNOWN)
4849 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004850 flags = tv_get_string_buf(&argvars[1], nbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004851 for ( ; *flags != NUL; ++flags)
4852 {
4853 switch (*flags)
4854 {
4855 case 'n': remap = FALSE; break;
4856 case 'm': remap = TRUE; break;
4857 case 't': typed = TRUE; break;
4858 case 'i': insert = TRUE; break;
4859 case 'x': execute = TRUE; break;
Bram Moolenaara9725222022-01-16 13:30:33 +00004860 case 'c': context = TRUE; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004861 case '!': dangerous = TRUE; break;
Bram Moolenaar5e66b422019-01-24 21:58:10 +01004862 case 'L': lowlevel = TRUE; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004863 }
4864 }
4865 }
4866
4867 if (*keys != NUL || execute)
4868 {
Christopher Plewright20b795e2022-12-20 20:01:58 +00004869 if (lowlevel
4870#ifdef FEAT_VTP
4871 && (!is_term_win32()
4872 || (keys[0] == 3 && ctrl_c_interrupts && typed))
4873#endif
4874 )
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004875 {
Bram Moolenaar5e66b422019-01-24 21:58:10 +01004876#ifdef USE_INPUT_BUF
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004877 ch_log(NULL, "feedkeys() lowlevel: %s", keys);
Bram Moolenaar9645e2d2020-03-20 20:48:49 +01004878
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004879 int len = (int)STRLEN(keys);
4880 for (int idx = 0; idx < len; ++idx)
4881 {
4882 // if a CTRL-C was typed, set got_int, similar to what
4883 // happens in fill_input_buf()
4884 if (keys[idx] == 3 && ctrl_c_interrupts && typed)
4885 got_int = TRUE;
4886 add_to_input_buf(keys + idx, 1);
4887 }
Bram Moolenaar5e66b422019-01-24 21:58:10 +01004888#else
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004889 emsg(_(e_lowlevel_input_not_supported));
Bram Moolenaar5e66b422019-01-24 21:58:10 +01004890#endif
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004891 }
4892 else
4893 {
4894 // Need to escape K_SPECIAL and CSI before putting the string in
4895 // the typeahead buffer.
4896 char_u *keys_esc = vim_strsave_escape_csi(keys);
4897 if (keys_esc == NULL)
4898 return;
4899
4900 ch_log(NULL, "feedkeys(%s): %s", typed ? "typed" : "", keys);
4901
4902 ins_typebuf(keys_esc, (remap ? REMAP_YES : REMAP_NONE),
4903 insert ? 0 : typebuf.tb_len, !typed, FALSE);
4904 if (vgetc_busy
Bram Moolenaar5d7be4f2017-06-25 13:40:17 +02004905#ifdef FEAT_TIMERS
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004906 || timer_busy
Bram Moolenaar5d7be4f2017-06-25 13:40:17 +02004907#endif
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004908 || input_busy)
4909 typebuf_was_filled = TRUE;
4910
Bram Moolenaar8d4ce562019-01-30 22:01:40 +01004911 vim_free(keys_esc);
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004912 }
Bram Moolenaar8d4ce562019-01-30 22:01:40 +01004913
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004914 if (execute)
4915 {
4916 int save_msg_scroll = msg_scroll;
4917 sctx_T save_sctx;
4918
4919 // Avoid a 1 second delay when the keys start Insert mode.
4920 msg_scroll = FALSE;
4921
4922 ch_log(NULL, "feedkeys() executing");
4923
4924 if (context)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004925 {
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004926 save_sctx = current_sctx;
4927 current_sctx.sc_sid = 0;
4928 current_sctx.sc_version = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004929 }
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004930
4931 if (!dangerous)
4932 {
4933 ++ex_normal_busy;
4934 ++in_feedkeys;
4935 }
4936 exec_normal(TRUE, lowlevel, TRUE);
4937 if (!dangerous)
4938 {
4939 --ex_normal_busy;
4940 --in_feedkeys;
4941 }
4942
4943 msg_scroll |= save_msg_scroll;
4944
4945 if (context)
4946 current_sctx = save_sctx;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004947 }
4948 }
4949}
4950
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004951/*
4952 * "fnameescape({string})" function
4953 */
4954 static void
4955f_fnameescape(typval_T *argvars, typval_T *rettv)
4956{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004957 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
4958 return;
4959
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004960 rettv->vval.v_string = vim_strsave_fnameescape(
Bram Moolenaar21c1a0c2021-10-17 17:20:23 +01004961 tv_get_string(&argvars[0]), VSE_NONE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004962 rettv->v_type = VAR_STRING;
4963}
4964
4965/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004966 * "foreground()" function
4967 */
4968 static void
4969f_foreground(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
4970{
4971#ifdef FEAT_GUI
4972 if (gui.in_use)
Bram Moolenaarafde13b2019-04-28 19:46:49 +02004973 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004974 gui_mch_set_foreground();
Bram Moolenaarafde13b2019-04-28 19:46:49 +02004975 return;
4976 }
4977#endif
4978#if defined(MSWIN) && (!defined(FEAT_GUI) || defined(VIMDLL))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004979 win32_set_foreground();
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004980#endif
4981}
4982
Bakudankun375141e2022-09-09 18:46:47 +01004983/*
4984 * "function()" function
4985 * "funcref()" function
4986 */
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004987 static void
Bram Moolenaar437bafe2016-08-01 15:40:54 +02004988common_function(typval_T *argvars, typval_T *rettv, int is_funcref)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004989{
4990 char_u *s;
4991 char_u *name;
4992 int use_string = FALSE;
4993 partial_T *arg_pt = NULL;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02004994 char_u *trans_name = NULL;
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02004995 int is_global = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004996
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02004997 if (in_vim9script()
Bram Moolenaarae1068a2021-12-25 19:43:44 +00004998 && (check_for_string_or_func_arg(argvars, 0) == FAIL
4999 || check_for_opt_list_arg(argvars, 1) == FAIL
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02005000 || (argvars[1].v_type != VAR_UNKNOWN
5001 && check_for_opt_dict_arg(argvars, 2) == FAIL)))
5002 return;
5003
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005004 if (argvars[0].v_type == VAR_FUNC)
5005 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005006 // function(MyFunc, [arg], dict)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005007 s = argvars[0].vval.v_string;
5008 }
5009 else if (argvars[0].v_type == VAR_PARTIAL
5010 && argvars[0].vval.v_partial != NULL)
5011 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005012 // function(dict.MyFunc, [arg])
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005013 arg_pt = argvars[0].vval.v_partial;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005014 s = partial_name(arg_pt);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005015 }
5016 else
5017 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005018 // function('MyFunc', [arg], dict)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005019 s = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005020 use_string = TRUE;
5021 }
Bram Moolenaar60b6e6f2021-08-28 12:49:27 +02005022 if (s == NULL)
5023 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00005024 semsg(_(e_invalid_argument_str), "NULL");
Bram Moolenaar60b6e6f2021-08-28 12:49:27 +02005025 return;
5026 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005027
Bram Moolenaar843b8842016-08-21 14:36:15 +02005028 if ((use_string && vim_strchr(s, AUTOLOAD_CHAR) == NULL) || is_funcref)
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005029 {
5030 name = s;
Bram Moolenaareba3b7f2021-11-30 18:25:08 +00005031 trans_name = save_function_name(&name, &is_global, FALSE,
5032 TFN_INT | TFN_QUIET | TFN_NO_AUTOLOAD | TFN_NO_DEREF, NULL);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005033 if (*name != NUL)
5034 s = NULL;
5035 }
5036
Bram Moolenaar843b8842016-08-21 14:36:15 +02005037 if (s == NULL || *s == NUL || (use_string && VIM_ISDIGIT(*s))
5038 || (is_funcref && trans_name == NULL))
Yegappan Lakshmanan655b7342022-03-06 14:27:10 +00005039 semsg(_(e_invalid_argument_str),
5040 use_string ? tv_get_string(&argvars[0]) : s);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005041 // Don't check an autoload name for existence here.
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005042 else if (trans_name != NULL && (is_funcref
Bram Moolenaard9d2fd02022-01-13 21:15:21 +00005043 ? find_func(trans_name, is_global) == NULL
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02005044 : !translated_function_exists(trans_name, is_global)))
Bram Moolenaara6f79292022-01-04 21:30:47 +00005045 semsg(_(e_unknown_function_str_2), s);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005046 else
5047 {
5048 int dict_idx = 0;
5049 int arg_idx = 0;
5050 list_T *list = NULL;
5051
5052 if (STRNCMP(s, "s:", 2) == 0 || STRNCMP(s, "<SID>", 5) == 0)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005053 // Expand s: and <SID> into <SNR>nr_, so that the function can
5054 // also be called from another script. Using trans_function_name()
5055 // would also work, but some plugins depend on the name being
5056 // printable text.
Yegappan Lakshmanane7f4abd2021-12-24 20:47:38 +00005057 name = get_scriptlocal_funcname(s);
Bram Moolenaarc2f17f72022-02-21 13:13:50 +00005058 else if (trans_name != NULL && *trans_name == K_SPECIAL)
5059 name = alloc_printable_func_name(trans_name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005060 else
5061 name = vim_strsave(s);
5062
5063 if (argvars[1].v_type != VAR_UNKNOWN)
5064 {
5065 if (argvars[2].v_type != VAR_UNKNOWN)
5066 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005067 // function(name, [args], dict)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005068 arg_idx = 1;
5069 dict_idx = 2;
5070 }
5071 else if (argvars[1].v_type == VAR_DICT)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005072 // function(name, dict)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005073 dict_idx = 1;
5074 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005075 // function(name, [args])
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005076 arg_idx = 1;
5077 if (dict_idx > 0)
5078 {
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +01005079 if (check_for_dict_arg(argvars, dict_idx) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005080 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005081 vim_free(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005082 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005083 }
5084 if (argvars[dict_idx].vval.v_dict == NULL)
5085 dict_idx = 0;
5086 }
5087 if (arg_idx > 0)
5088 {
5089 if (argvars[arg_idx].v_type != VAR_LIST)
5090 {
Bram Moolenaard82a47d2022-01-05 20:24:39 +00005091 emsg(_(e_second_argument_of_function_must_be_list_or_dict));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005092 vim_free(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005093 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005094 }
5095 list = argvars[arg_idx].vval.v_list;
5096 if (list == NULL || list->lv_len == 0)
5097 arg_idx = 0;
Bram Moolenaar4c054e92019-11-10 00:13:50 +01005098 else if (list->lv_len > MAX_FUNC_ARGS)
5099 {
Yegappan Lakshmanan5018a832022-04-02 21:12:21 +01005100 emsg_funcname(e_too_many_arguments_for_function_str, s);
Bram Moolenaar4c054e92019-11-10 00:13:50 +01005101 vim_free(name);
5102 goto theend;
5103 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005104 }
5105 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005106 if (dict_idx > 0 || arg_idx > 0 || arg_pt != NULL || is_funcref)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005107 {
Bram Moolenaarc799fe22019-05-28 23:08:19 +02005108 partial_T *pt = ALLOC_CLEAR_ONE(partial_T);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005109
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005110 // result is a VAR_PARTIAL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005111 if (pt == NULL)
5112 vim_free(name);
5113 else
5114 {
5115 if (arg_idx > 0 || (arg_pt != NULL && arg_pt->pt_argc > 0))
5116 {
5117 listitem_T *li;
5118 int i = 0;
5119 int arg_len = 0;
5120 int lv_len = 0;
5121
5122 if (arg_pt != NULL)
5123 arg_len = arg_pt->pt_argc;
5124 if (list != NULL)
5125 lv_len = list->lv_len;
5126 pt->pt_argc = arg_len + lv_len;
Bram Moolenaarc799fe22019-05-28 23:08:19 +02005127 pt->pt_argv = ALLOC_MULT(typval_T, pt->pt_argc);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005128 if (pt->pt_argv == NULL)
5129 {
5130 vim_free(pt);
5131 vim_free(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005132 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005133 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005134 for (i = 0; i < arg_len; i++)
5135 copy_tv(&arg_pt->pt_argv[i], &pt->pt_argv[i]);
5136 if (lv_len > 0)
Bram Moolenaar50985eb2020-01-27 22:09:39 +01005137 {
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02005138 CHECK_LIST_MATERIALIZE(list);
Bram Moolenaaraeea7212020-04-02 18:50:46 +02005139 FOR_ALL_LIST_ITEMS(list, li)
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005140 copy_tv(&li->li_tv, &pt->pt_argv[i++]);
Bram Moolenaar50985eb2020-01-27 22:09:39 +01005141 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005142 }
5143
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005144 // For "function(dict.func, [], dict)" and "func" is a partial
5145 // use "dict". That is backwards compatible.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005146 if (dict_idx > 0)
5147 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005148 // The dict is bound explicitly, pt_auto is FALSE.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005149 pt->pt_dict = argvars[dict_idx].vval.v_dict;
5150 ++pt->pt_dict->dv_refcount;
5151 }
5152 else if (arg_pt != NULL)
5153 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005154 // If the dict was bound automatically the result is also
5155 // bound automatically.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005156 pt->pt_dict = arg_pt->pt_dict;
5157 pt->pt_auto = arg_pt->pt_auto;
5158 if (pt->pt_dict != NULL)
5159 ++pt->pt_dict->dv_refcount;
Yegappan Lakshmanan29bb67f2023-10-14 11:18:50 +02005160 pt->pt_obj = arg_pt->pt_obj;
5161 if (pt->pt_obj != NULL)
5162 ++pt->pt_obj->obj_refcount;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005163 }
5164
5165 pt->pt_refcount = 1;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005166 if (arg_pt != NULL && arg_pt->pt_func != NULL)
5167 {
5168 pt->pt_func = arg_pt->pt_func;
5169 func_ptr_ref(pt->pt_func);
5170 vim_free(name);
5171 }
5172 else if (is_funcref)
5173 {
Bram Moolenaard9d2fd02022-01-13 21:15:21 +00005174 pt->pt_func = find_func(trans_name, is_global);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005175 func_ptr_ref(pt->pt_func);
5176 vim_free(name);
5177 }
5178 else
5179 {
5180 pt->pt_name = name;
5181 func_ref(name);
5182 }
Bram Moolenaar92368aa2022-02-07 17:50:39 +00005183
5184 if (arg_pt != NULL)
Bram Moolenaar7aca5ca2022-02-07 19:56:43 +00005185 {
5186 pt->pt_outer_partial = arg_pt;
5187 ++arg_pt->pt_refcount;
5188 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005189 }
5190 rettv->v_type = VAR_PARTIAL;
5191 rettv->vval.v_partial = pt;
5192 }
5193 else
5194 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005195 // result is a VAR_FUNC
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005196 rettv->v_type = VAR_FUNC;
5197 rettv->vval.v_string = name;
5198 func_ref(name);
5199 }
5200 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005201theend:
5202 vim_free(trans_name);
5203}
5204
5205/*
5206 * "funcref()" function
5207 */
5208 static void
5209f_funcref(typval_T *argvars, typval_T *rettv)
5210{
5211 common_function(argvars, rettv, TRUE);
5212}
5213
5214/*
5215 * "function()" function
5216 */
5217 static void
5218f_function(typval_T *argvars, typval_T *rettv)
5219{
5220 common_function(argvars, rettv, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005221}
5222
5223/*
5224 * "garbagecollect()" function
5225 */
5226 static void
5227f_garbagecollect(typval_T *argvars, typval_T *rettv UNUSED)
5228{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005229 if (in_vim9script() && check_for_opt_bool_arg(argvars, 0) == FAIL)
5230 return;
5231
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005232 // This is postponed until we are back at the toplevel, because we may be
5233 // using Lists and Dicts internally. E.g.: ":echo [garbagecollect()]".
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005234 want_garbage_collect = TRUE;
5235
Bram Moolenaar2df47312020-09-05 17:30:44 +02005236 if (argvars[0].v_type != VAR_UNKNOWN && tv_get_bool(&argvars[0]) == 1)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005237 garbage_collect_at_exit = TRUE;
5238}
5239
5240/*
5241 * "get()" function
5242 */
5243 static void
5244f_get(typval_T *argvars, typval_T *rettv)
5245{
5246 listitem_T *li;
5247 list_T *l;
5248 dictitem_T *di;
5249 dict_T *d;
5250 typval_T *tv = NULL;
Bram Moolenaarf91aac52019-07-28 13:21:01 +02005251 int what_is_dict = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005252
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005253 if (argvars[0].v_type == VAR_BLOB)
5254 {
5255 int error = FALSE;
5256 int idx = tv_get_number_chk(&argvars[1], &error);
5257
5258 if (!error)
5259 {
5260 rettv->v_type = VAR_NUMBER;
Bram Moolenaar2ea773b2019-01-15 22:16:42 +01005261 if (idx < 0)
5262 idx = blob_len(argvars[0].vval.v_blob) + idx;
5263 if (idx < 0 || idx >= blob_len(argvars[0].vval.v_blob))
5264 rettv->vval.v_number = -1;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005265 else
Bram Moolenaar2ea773b2019-01-15 22:16:42 +01005266 {
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005267 rettv->vval.v_number = blob_get(argvars[0].vval.v_blob, idx);
Bram Moolenaar2ea773b2019-01-15 22:16:42 +01005268 tv = rettv;
5269 }
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005270 }
5271 }
5272 else if (argvars[0].v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005273 {
5274 if ((l = argvars[0].vval.v_list) != NULL)
5275 {
5276 int error = FALSE;
5277
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005278 li = list_find(l, (long)tv_get_number_chk(&argvars[1], &error));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005279 if (!error && li != NULL)
5280 tv = &li->li_tv;
5281 }
5282 }
5283 else if (argvars[0].v_type == VAR_DICT)
5284 {
5285 if ((d = argvars[0].vval.v_dict) != NULL)
5286 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005287 di = dict_find(d, tv_get_string(&argvars[1]), -1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005288 if (di != NULL)
5289 tv = &di->di_tv;
5290 }
5291 }
5292 else if (argvars[0].v_type == VAR_PARTIAL || argvars[0].v_type == VAR_FUNC)
5293 {
5294 partial_T *pt;
5295 partial_T fref_pt;
5296
5297 if (argvars[0].v_type == VAR_PARTIAL)
5298 pt = argvars[0].vval.v_partial;
5299 else
5300 {
Bram Moolenaara80faa82020-04-12 19:37:17 +02005301 CLEAR_FIELD(fref_pt);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005302 fref_pt.pt_name = argvars[0].vval.v_string;
5303 pt = &fref_pt;
5304 }
5305
5306 if (pt != NULL)
5307 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005308 char_u *what = tv_get_string(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005309
5310 if (STRCMP(what, "func") == 0 || STRCMP(what, "name") == 0)
5311 {
Bram Moolenaar1ae8c262022-06-27 11:45:52 +01005312 char_u *name = partial_name(pt);
5313
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005314 rettv->v_type = (*what == 'f' ? VAR_FUNC : VAR_STRING);
Bram Moolenaar1ae8c262022-06-27 11:45:52 +01005315 if (name == NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005316 rettv->vval.v_string = NULL;
5317 else
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005318 {
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005319 if (rettv->v_type == VAR_FUNC)
Bram Moolenaar1ae8c262022-06-27 11:45:52 +01005320 func_ref(name);
5321 if (*what == 'n' && pt->pt_name == NULL
5322 && pt->pt_func != NULL)
5323 // use <SNR> instead of the byte code
5324 name = printable_func_name(pt->pt_func);
5325 rettv->vval.v_string = vim_strsave(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005326 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005327 }
5328 else if (STRCMP(what, "dict") == 0)
Bram Moolenaarf91aac52019-07-28 13:21:01 +02005329 {
5330 what_is_dict = TRUE;
5331 if (pt->pt_dict != NULL)
5332 rettv_dict_set(rettv, pt->pt_dict);
5333 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005334 else if (STRCMP(what, "args") == 0)
5335 {
5336 rettv->v_type = VAR_LIST;
5337 if (rettv_list_alloc(rettv) == OK)
5338 {
5339 int i;
5340
5341 for (i = 0; i < pt->pt_argc; ++i)
5342 list_append_tv(rettv->vval.v_list, &pt->pt_argv[i]);
5343 }
5344 }
LemonBoy48b7d052024-07-09 18:24:59 +02005345 else if (STRCMP(what, "arity") == 0)
5346 {
5347 int required = 0, optional = 0, varargs = FALSE;
5348 char_u *name = partial_name(pt);
5349
5350 get_func_arity(name, &required, &optional, &varargs);
5351
5352 rettv->v_type = VAR_DICT;
5353 if (rettv_dict_alloc(rettv) == OK)
5354 {
5355 dict_T *dict = rettv->vval.v_dict;
5356
5357 // Take into account the arguments of the partial, if any.
5358 // Note that it is possible to supply more arguments than the function
5359 // accepts.
5360 if (pt->pt_argc >= required + optional)
5361 required = optional = 0;
5362 else if (pt->pt_argc > required)
5363 {
5364 optional -= pt->pt_argc - required;
5365 required = 0;
5366 }
5367 else
5368 required -= pt->pt_argc;
5369
5370 dict_add_number(dict, "required", required);
5371 dict_add_number(dict, "optional", optional);
5372 dict_add_bool(dict, "varargs", varargs);
5373 }
5374 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005375 else
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00005376 semsg(_(e_invalid_argument_str), what);
Bram Moolenaarf91aac52019-07-28 13:21:01 +02005377
5378 // When {what} == "dict" and pt->pt_dict == NULL, evaluate the
5379 // third argument
5380 if (!what_is_dict)
5381 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005382 }
5383 }
5384 else
Bram Moolenaar460ae5d2022-01-01 14:19:49 +00005385 semsg(_(e_argument_of_str_must_be_list_dictionary_or_blob), "get()");
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005386
5387 if (tv == NULL)
5388 {
5389 if (argvars[2].v_type != VAR_UNKNOWN)
5390 copy_tv(&argvars[2], rettv);
5391 }
5392 else
5393 copy_tv(tv, rettv);
5394}
5395
Bram Moolenaarb5ae48e2016-08-12 22:23:25 +02005396/*
mikoto2000a73dfc22024-11-18 21:12:21 +01005397 * "getcellpixels()" function
5398 */
5399 static void
5400f_getcellpixels(typval_T *argvars UNUSED, typval_T *rettv)
5401{
5402 if (rettv_list_alloc(rettv) == FAIL)
5403 return;
5404
5405#if defined(FEAT_GUI)
5406 if (gui.in_use)
5407 {
5408 // success pixel size and no gui.
5409 list_append_number(rettv->vval.v_list, (varnumber_T)gui.char_width);
5410 list_append_number(rettv->vval.v_list, (varnumber_T)gui.char_height);
5411 }
5412 else
5413#endif
5414 {
5415 struct cellsize cs;
5416#if defined(UNIX)
5417 mch_calc_cell_size(&cs);
5418#else
5419 // Non-Unix CUIs are not supported, so set this to -1x-1.
5420 cs.cs_xpixel = -1;
5421 cs.cs_ypixel = -1;
5422#endif
5423
5424 // failed get pixel size.
5425 if (cs.cs_xpixel == -1)
5426 return;
5427
5428 // success pixel size and no gui.
5429 list_append_number(rettv->vval.v_list, (varnumber_T)cs.cs_xpixel);
5430 list_append_number(rettv->vval.v_list, (varnumber_T)cs.cs_ypixel);
5431 }
5432
5433}
5434
5435/*
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005436 * "getchangelist()" function
5437 */
5438 static void
5439f_getchangelist(typval_T *argvars, typval_T *rettv)
5440{
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005441 buf_T *buf;
5442 int i;
5443 list_T *l;
5444 dict_T *d;
LemonBoydb0ea7f2022-04-10 17:59:26 +01005445 int changelistindex;
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005446
Bram Moolenaar93a10962022-06-16 11:42:09 +01005447 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005448 return;
5449
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005450 if (in_vim9script() && check_for_opt_buffer_arg(argvars, 0) == FAIL)
5451 return;
5452
Bram Moolenaar4c313b12019-08-24 22:58:31 +02005453 if (argvars[0].v_type == VAR_UNKNOWN)
5454 buf = curbuf;
5455 else
Bram Moolenaara5d38412020-09-02 21:02:35 +02005456 buf = tv_get_buf_from_arg(&argvars[0]);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005457 if (buf == NULL)
5458 return;
5459
5460 l = list_alloc();
5461 if (l == NULL)
5462 return;
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005463 if (list_append_list(rettv->vval.v_list, l) == FAIL)
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005464 {
5465 vim_free(l);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005466 return;
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005467 }
5468
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005469 /*
LemonBoydb0ea7f2022-04-10 17:59:26 +01005470 * The current window change list index tracks only the position for the
5471 * current buffer. For other buffers use the stored index for the current
5472 * window, or, if that's not available, the change list length.
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005473 */
LemonBoydb0ea7f2022-04-10 17:59:26 +01005474 if (buf == curwin->w_buffer)
5475 {
5476 changelistindex = curwin->w_changelistidx;
5477 }
5478 else
5479 {
5480 wininfo_T *wip;
5481
5482 FOR_ALL_BUF_WININFO(buf, wip)
5483 if (wip->wi_win == curwin)
5484 break;
5485 changelistindex = wip != NULL ? wip->wi_changelistidx
5486 : buf->b_changelistlen;
5487 }
5488 list_append_number(rettv->vval.v_list, (varnumber_T)changelistindex);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005489
5490 for (i = 0; i < buf->b_changelistlen; ++i)
5491 {
5492 if (buf->b_changelist[i].lnum == 0)
5493 continue;
5494 if ((d = dict_alloc()) == NULL)
5495 return;
5496 if (list_append_dict(l, d) == FAIL)
5497 return;
Bram Moolenaare0be1672018-07-08 16:50:37 +02005498 dict_add_number(d, "lnum", (long)buf->b_changelist[i].lnum);
5499 dict_add_number(d, "col", (long)buf->b_changelist[i].col);
Bram Moolenaare0be1672018-07-08 16:50:37 +02005500 dict_add_number(d, "coladd", (long)buf->b_changelist[i].coladd);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005501 }
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005502}
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005503
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005504 static void
5505getpos_both(
5506 typval_T *argvars,
5507 typval_T *rettv,
5508 int getcurpos,
5509 int charcol)
5510{
5511 pos_T *fp = NULL;
5512 pos_T pos;
5513 win_T *wp = curwin;
5514 list_T *l;
5515 int fnum = -1;
5516
5517 if (rettv_list_alloc(rettv) == OK)
5518 {
5519 l = rettv->vval.v_list;
5520 if (getcurpos)
5521 {
5522 if (argvars[0].v_type != VAR_UNKNOWN)
5523 {
5524 wp = find_win_by_nr_or_id(&argvars[0]);
5525 if (wp != NULL)
5526 fp = &wp->w_cursor;
5527 }
5528 else
5529 fp = &curwin->w_cursor;
5530 if (fp != NULL && charcol)
5531 {
5532 pos = *fp;
Bram Moolenaar91458462021-01-13 20:08:38 +01005533 pos.col =
5534 buf_byteidx_to_charidx(wp->w_buffer, pos.lnum, pos.col);
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005535 fp = &pos;
5536 }
5537 }
5538 else
5539 fp = var2fpos(&argvars[0], TRUE, &fnum, charcol);
5540 if (fnum != -1)
5541 list_append_number(l, (varnumber_T)fnum);
5542 else
5543 list_append_number(l, (varnumber_T)0);
5544 list_append_number(l, (fp != NULL) ? (varnumber_T)fp->lnum
5545 : (varnumber_T)0);
5546 list_append_number(l, (fp != NULL)
5547 ? (varnumber_T)(fp->col == MAXCOL ? MAXCOL : fp->col + 1)
5548 : (varnumber_T)0);
5549 list_append_number(l, (fp != NULL) ? (varnumber_T)fp->coladd :
5550 (varnumber_T)0);
5551 if (getcurpos)
5552 {
5553 int save_set_curswant = curwin->w_set_curswant;
5554 colnr_T save_curswant = curwin->w_curswant;
5555 colnr_T save_virtcol = curwin->w_virtcol;
5556
5557 if (wp == curwin)
5558 update_curswant();
5559 list_append_number(l, wp == NULL ? 0 : wp->w_curswant == MAXCOL
5560 ? (varnumber_T)MAXCOL : (varnumber_T)wp->w_curswant + 1);
5561
5562 // Do not change "curswant", as it is unexpected that a get
5563 // function has a side effect.
5564 if (wp == curwin && save_set_curswant)
5565 {
5566 curwin->w_set_curswant = save_set_curswant;
5567 curwin->w_curswant = save_curswant;
5568 curwin->w_virtcol = save_virtcol;
5569 curwin->w_valid &= ~VALID_VIRTCOL;
5570 }
5571 }
5572 }
5573 else
5574 rettv->vval.v_number = FALSE;
5575}
5576
5577/*
5578 * "getcharpos()" function
5579 */
5580 static void
5581f_getcharpos(typval_T *argvars UNUSED, typval_T *rettv)
5582{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005583 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5584 return;
5585
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005586 getpos_both(argvars, rettv, FALSE, TRUE);
5587}
5588
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005589/*
5590 * "getcharsearch()" function
5591 */
5592 static void
5593f_getcharsearch(typval_T *argvars UNUSED, typval_T *rettv)
5594{
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00005595 if (rettv_dict_alloc(rettv) != OK)
5596 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005597
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00005598 dict_T *dict = rettv->vval.v_dict;
5599
5600 dict_add_string(dict, "char", last_csearch());
5601 dict_add_number(dict, "forward", last_csearch_forward());
5602 dict_add_number(dict, "until", last_csearch_until());
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005603}
5604
5605/*
Bram Moolenaar691ddee2019-05-09 14:52:41 +02005606 * "getenv()" function
5607 */
5608 static void
5609f_getenv(typval_T *argvars, typval_T *rettv)
5610{
5611 int mustfree = FALSE;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005612 char_u *p;
Bram Moolenaar691ddee2019-05-09 14:52:41 +02005613
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005614 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5615 return;
5616
5617 p = vim_getenv(tv_get_string(&argvars[0]), &mustfree);
Bram Moolenaar691ddee2019-05-09 14:52:41 +02005618 if (p == NULL)
5619 {
5620 rettv->v_type = VAR_SPECIAL;
5621 rettv->vval.v_number = VVAL_NULL;
5622 return;
5623 }
5624 if (!mustfree)
5625 p = vim_strsave(p);
5626 rettv->vval.v_string = p;
5627 rettv->v_type = VAR_STRING;
5628}
5629
5630/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005631 * "getfontname()" function
5632 */
5633 static void
5634f_getfontname(typval_T *argvars UNUSED, typval_T *rettv)
5635{
5636 rettv->v_type = VAR_STRING;
5637 rettv->vval.v_string = NULL;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005638
5639 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
5640 return;
5641
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005642#ifdef FEAT_GUI
5643 if (gui.in_use)
5644 {
5645 GuiFont font;
5646 char_u *name = NULL;
5647
5648 if (argvars[0].v_type == VAR_UNKNOWN)
5649 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005650 // Get the "Normal" font. Either the name saved by
5651 // hl_set_font_name() or from the font ID.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005652 font = gui.norm_font;
5653 name = hl_get_font_name();
5654 }
5655 else
5656 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005657 name = tv_get_string(&argvars[0]);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005658 if (STRCMP(name, "*") == 0) // don't use font dialog
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005659 return;
5660 font = gui_mch_get_font(name, FALSE);
5661 if (font == NOFONT)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005662 return; // Invalid font name, return empty string.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005663 }
5664 rettv->vval.v_string = gui_mch_get_fontname(font, name);
5665 if (argvars[0].v_type != VAR_UNKNOWN)
5666 gui_mch_free_font(font);
5667 }
5668#endif
5669}
5670
5671/*
Bram Moolenaar4f505882018-02-10 21:06:32 +01005672 * "getjumplist()" function
5673 */
5674 static void
5675f_getjumplist(typval_T *argvars, typval_T *rettv)
5676{
Bram Moolenaar4f505882018-02-10 21:06:32 +01005677 win_T *wp;
5678 int i;
5679 list_T *l;
5680 dict_T *d;
Bram Moolenaar4f505882018-02-10 21:06:32 +01005681
Bram Moolenaar93a10962022-06-16 11:42:09 +01005682 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar4f505882018-02-10 21:06:32 +01005683 return;
5684
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005685 if (in_vim9script()
5686 && (check_for_opt_number_arg(argvars, 0) == FAIL
5687 || (argvars[0].v_type != VAR_UNKNOWN
5688 && check_for_opt_number_arg(argvars, 1) == FAIL)))
5689 return;
5690
Bram Moolenaar00aa0692019-04-27 20:37:57 +02005691 wp = find_tabwin(&argvars[0], &argvars[1], NULL);
Bram Moolenaar4f505882018-02-10 21:06:32 +01005692 if (wp == NULL)
5693 return;
5694
Bram Moolenaar57ee2b62019-02-12 22:15:06 +01005695 cleanup_jumplist(wp, TRUE);
5696
Bram Moolenaar4f505882018-02-10 21:06:32 +01005697 l = list_alloc();
5698 if (l == NULL)
5699 return;
Bram Moolenaar4f505882018-02-10 21:06:32 +01005700 if (list_append_list(rettv->vval.v_list, l) == FAIL)
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005701 {
5702 vim_free(l);
Bram Moolenaar4f505882018-02-10 21:06:32 +01005703 return;
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005704 }
5705
Bram Moolenaar4f505882018-02-10 21:06:32 +01005706 list_append_number(rettv->vval.v_list, (varnumber_T)wp->w_jumplistidx);
5707
5708 for (i = 0; i < wp->w_jumplistlen; ++i)
5709 {
Bram Moolenaara7e18d22018-02-11 14:29:49 +01005710 if (wp->w_jumplist[i].fmark.mark.lnum == 0)
5711 continue;
Bram Moolenaar4f505882018-02-10 21:06:32 +01005712 if ((d = dict_alloc()) == NULL)
5713 return;
5714 if (list_append_dict(l, d) == FAIL)
5715 return;
Bram Moolenaare0be1672018-07-08 16:50:37 +02005716 dict_add_number(d, "lnum", (long)wp->w_jumplist[i].fmark.mark.lnum);
5717 dict_add_number(d, "col", (long)wp->w_jumplist[i].fmark.mark.col);
Bram Moolenaare0be1672018-07-08 16:50:37 +02005718 dict_add_number(d, "coladd", (long)wp->w_jumplist[i].fmark.mark.coladd);
Bram Moolenaare0be1672018-07-08 16:50:37 +02005719 dict_add_number(d, "bufnr", (long)wp->w_jumplist[i].fmark.fnum);
Bram Moolenaara7e18d22018-02-11 14:29:49 +01005720 if (wp->w_jumplist[i].fname != NULL)
Bram Moolenaare0be1672018-07-08 16:50:37 +02005721 dict_add_string(d, "filename", wp->w_jumplist[i].fname);
Bram Moolenaar4f505882018-02-10 21:06:32 +01005722 }
Bram Moolenaar4f505882018-02-10 21:06:32 +01005723}
5724
5725/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005726 * "getpid()" function
5727 */
5728 static void
5729f_getpid(typval_T *argvars UNUSED, typval_T *rettv)
5730{
5731 rettv->vval.v_number = mch_get_pid();
5732}
5733
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005734/*
5735 * "getcurpos()" function
5736 */
5737 static void
5738f_getcurpos(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, FALSE);
5744}
5745
5746 static void
5747f_getcursorcharpos(typval_T *argvars, typval_T *rettv)
5748{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005749 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
5750 return;
5751
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005752 getpos_both(argvars, rettv, TRUE, TRUE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005753}
5754
5755/*
5756 * "getpos(string)" function
5757 */
5758 static void
5759f_getpos(typval_T *argvars, typval_T *rettv)
5760{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005761 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5762 return;
5763
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005764 getpos_both(argvars, rettv, FALSE, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005765}
5766
5767/*
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005768 * Convert from block_def to string
5769 */
Gary Johnson88d4f252024-06-01 20:51:33 +02005770 static char_u *
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005771block_def2str(struct block_def *bd)
5772{
5773 char_u *p, *ret;
5774 size_t size = bd->startspaces + bd->endspaces + bd->textlen;
5775
5776 ret = alloc(size + 1);
5777 if (ret != NULL)
5778 {
5779 p = ret;
5780 vim_memset(p, ' ', bd->startspaces);
5781 p += bd->startspaces;
5782 mch_memmove(p, bd->textstart, bd->textlen);
5783 p += bd->textlen;
5784 vim_memset(p, ' ', bd->endspaces);
5785 *(p + bd->endspaces) = NUL;
5786 }
5787 return ret;
5788}
5789
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005790 static int
5791getregionpos(
5792 typval_T *argvars,
5793 typval_T *rettv,
zeertzjqc95e64f2024-05-20 14:00:31 +02005794 pos_T *p1,
5795 pos_T *p2,
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005796 int *inclusive,
5797 int *region_type,
zeertzjqafc22952024-05-24 19:07:12 +02005798 oparg_T *oap)
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005799{
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005800 int fnum1 = -1, fnum2 = -1;
5801 char_u *type;
5802 buf_T *findbuf;
5803 char_u default_type[] = "v";
zeertzjqafc22952024-05-24 19:07:12 +02005804 int block_width = 0;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005805 int is_select_exclusive;
5806 int l;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005807
5808 if (rettv_list_alloc(rettv) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005809 return FAIL;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005810
Shougo Matsushita19b71882024-02-28 22:48:12 +01005811 if (check_for_list_arg(argvars, 0) == FAIL
5812 || check_for_list_arg(argvars, 1) == FAIL
5813 || check_for_opt_dict_arg(argvars, 2) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005814 return FAIL;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005815
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005816 if (list2fpos(&argvars[0], p1, &fnum1, NULL, FALSE) != OK
5817 || list2fpos(&argvars[1], p2, &fnum2, NULL, FALSE) != OK
Shougo Matsushita84bf6e62024-03-06 21:10:18 +01005818 || fnum1 != fnum2)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005819 return FAIL;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005820
Shougo Matsushita19b71882024-02-28 22:48:12 +01005821 if (argvars[2].v_type == VAR_DICT)
5822 {
5823 is_select_exclusive = dict_get_bool(
5824 argvars[2].vval.v_dict, "exclusive", *p_sel == 'e');
5825 type = dict_get_string(
5826 argvars[2].vval.v_dict, "type", FALSE);
5827 if (type == NULL)
5828 type = default_type;
5829 }
5830 else
5831 {
5832 is_select_exclusive = *p_sel == 'e';
5833 type = default_type;
5834 }
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005835
5836 if (type[0] == 'v' && type[1] == NUL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005837 *region_type = MCHAR;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005838 else if (type[0] == 'V' && type[1] == NUL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005839 *region_type = MLINE;
zeertzjqafc22952024-05-24 19:07:12 +02005840 else if (type[0] == Ctrl_V)
5841 {
5842 char_u *p = type + 1;
5843
5844 if (*p != NUL && ((block_width = getdigits(&p)) <= 0 || *p != NUL))
5845 {
5846 semsg(_(e_invalid_value_for_argument_str_str), "type", type);
5847 return FAIL;
5848 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005849 *region_type = MBLOCK;
zeertzjqafc22952024-05-24 19:07:12 +02005850 }
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005851 else
zeertzjq26dd09a2024-03-10 15:46:58 +01005852 {
5853 semsg(_(e_invalid_value_for_argument_str_str), "type", type);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005854 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01005855 }
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005856
zeertzjq5406eb82024-03-11 21:36:42 +01005857 findbuf = fnum1 != 0 ? buflist_findnr(fnum1) : curbuf;
5858 if (findbuf == NULL || findbuf->b_ml.ml_mfp == NULL)
Shougo Matsushita84bf6e62024-03-06 21:10:18 +01005859 {
zeertzjq5406eb82024-03-11 21:36:42 +01005860 emsg(_(e_buffer_is_not_loaded));
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005861 return FAIL;
Shougo Matsushita84bf6e62024-03-06 21:10:18 +01005862 }
5863
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005864 if (p1->lnum < 1 || p1->lnum > findbuf->b_ml.ml_line_count)
zeertzjq26dd09a2024-03-10 15:46:58 +01005865 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005866 semsg(_(e_invalid_line_number_nr), p1->lnum);
5867 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01005868 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005869 if (p1->col == MAXCOL)
5870 p1->col = ml_get_buf_len(findbuf, p1->lnum) + 1;
5871 else if (p1->col < 1 || p1->col > ml_get_buf_len(findbuf, p1->lnum) + 1)
zeertzjq26dd09a2024-03-10 15:46:58 +01005872 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005873 semsg(_(e_invalid_column_number_nr), p1->col);
5874 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01005875 }
zeertzjq2ffdae72024-05-02 13:06:24 +02005876
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005877 if (p2->lnum < 1 || p2->lnum > findbuf->b_ml.ml_line_count)
zeertzjq26dd09a2024-03-10 15:46:58 +01005878 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005879 semsg(_(e_invalid_line_number_nr), p2->lnum);
5880 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01005881 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005882 if (p2->col == MAXCOL)
5883 p2->col = ml_get_buf_len(findbuf, p2->lnum) + 1;
5884 else if (p2->col < 1 || p2->col > ml_get_buf_len(findbuf, p2->lnum) + 1)
zeertzjq26dd09a2024-03-10 15:46:58 +01005885 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005886 semsg(_(e_invalid_column_number_nr), p2->col);
5887 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01005888 }
5889
5890 curbuf = findbuf;
zeertzjq5406eb82024-03-11 21:36:42 +01005891 curwin->w_buffer = curbuf;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005892 virtual_op = virtual_active();
5893
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005894 // NOTE: Adjustment is needed.
5895 p1->col--;
5896 p2->col--;
Shougo Matsushita19b71882024-02-28 22:48:12 +01005897
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005898 if (!LT_POS(*p1, *p2))
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005899 {
5900 // swap position
5901 pos_T p;
5902
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005903 p = *p1;
5904 *p1 = *p2;
5905 *p2 = p;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005906 }
5907
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005908 if (*region_type == MCHAR)
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005909 {
zeertzjq701ad502024-05-23 07:47:55 +02005910 // Handle 'selection' == "exclusive".
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005911 if (is_select_exclusive && !EQUAL_POS(*p1, *p2))
zeertzjq701ad502024-05-23 07:47:55 +02005912 // When backing up to previous line, inclusive becomes false.
5913 *inclusive = !unadjust_for_sel_inner(p2);
5914 // If p2 is on NUL (end of line), inclusive becomes false.
5915 if (*inclusive && !virtual_op && *ml_get_pos(p2) == NUL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005916 *inclusive = FALSE;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005917 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005918 else if (*region_type == MBLOCK)
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005919 {
5920 colnr_T sc1, ec1, sc2, ec2;
5921
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005922 getvvcol(curwin, p1, &sc1, NULL, &ec1);
5923 getvvcol(curwin, p2, &sc2, NULL, &ec2);
zeertzjqafc22952024-05-24 19:07:12 +02005924 oap->motion_type = MBLOCK;
5925 oap->inclusive = TRUE;
5926 oap->op_type = OP_NOP;
5927 oap->start = *p1;
5928 oap->end = *p2;
5929 oap->start_vcol = MIN(sc1, sc2);
5930 if (block_width > 0)
5931 oap->end_vcol = oap->start_vcol + block_width - 1;
5932 else if (is_select_exclusive && ec1 < sc2 && 0 < sc2 && ec2 > ec1)
5933 oap->end_vcol = sc2 - 1;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005934 else
zeertzjqafc22952024-05-24 19:07:12 +02005935 oap->end_vcol = MAX(ec1, ec2);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005936 }
5937
5938 // Include the trailing byte of a multi-byte char.
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005939 l = mb_ptr2len((char_u *)ml_get_pos(p2));
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005940 if (l > 1)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005941 p2->col += l - 1;
5942
5943 return OK;
5944}
5945
5946/*
5947 * "getregion()" function
5948 */
5949 static void
5950f_getregion(typval_T *argvars, typval_T *rettv)
5951{
5952 pos_T p1, p2;
5953 int inclusive = TRUE;
5954 int region_type = -1;
5955 oparg_T oa;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005956
5957 buf_T *save_curbuf;
5958 int save_virtual;
5959 char_u *akt = NULL;
5960 linenr_T lnum;
5961
5962 save_curbuf = curbuf;
5963 save_virtual = virtual_op;
5964
5965 if (getregionpos(argvars, rettv,
zeertzjqc95e64f2024-05-20 14:00:31 +02005966 &p1, &p2, &inclusive, &region_type, &oa) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005967 return;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005968
5969 for (lnum = p1.lnum; lnum <= p2.lnum; lnum++)
5970 {
5971 int ret = 0;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005972 struct block_def bd;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005973
5974 if (region_type == MLINE)
5975 akt = vim_strsave(ml_get(lnum));
5976 else if (region_type == MBLOCK)
5977 {
zeertzjq5e3674b2024-02-22 19:51:34 +01005978 block_prep(&oa, &bd, lnum, FALSE);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005979 akt = block_def2str(&bd);
5980 }
5981 else if (p1.lnum < lnum && lnum < p2.lnum)
5982 akt = vim_strsave(ml_get(lnum));
5983 else
5984 {
5985 charwise_block_prep(p1, p2, &bd, lnum, inclusive);
5986 akt = block_def2str(&bd);
5987 }
5988
5989 if (akt)
5990 {
5991 ret = list_append_string(rettv->vval.v_list, akt, -1);
5992 vim_free(akt);
5993 }
5994
5995 if (akt == NULL || ret == FAIL)
5996 {
zeertzjq5e3674b2024-02-22 19:51:34 +01005997 clear_tv(rettv);
5998 (void)rettv_list_alloc(rettv);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005999 break;
6000 }
6001 }
6002
zeertzjqc95e64f2024-05-20 14:00:31 +02006003 // getregionpos() may change curbuf and virtual_op
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006004 curbuf = save_curbuf;
6005 curwin->w_buffer = curbuf;
6006 virtual_op = save_virtual;
6007}
6008
6009 static void
zeertzjqc95e64f2024-05-20 14:00:31 +02006010add_regionpos_range(typval_T *rettv, pos_T p1, pos_T p2)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006011{
6012 list_T *l1, *l2, *l3;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006013
6014 l1 = list_alloc();
6015 if (l1 == NULL)
6016 return;
6017
6018 if (list_append_list(rettv->vval.v_list, l1) == FAIL)
6019 {
6020 vim_free(l1);
6021 return;
6022 }
6023
6024 l2 = list_alloc();
6025 if (l2 == NULL)
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006026 {
6027 vim_free(l1);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006028 return;
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006029 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006030
6031 if (list_append_list(l1, l2) == FAIL)
6032 {
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006033 vim_free(l1);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006034 vim_free(l2);
6035 return;
6036 }
6037
6038 l3 = list_alloc();
6039 if (l3 == NULL)
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006040 {
6041 vim_free(l1);
6042 vim_free(l2);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006043 return;
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006044 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006045
6046 if (list_append_list(l1, l3) == FAIL)
6047 {
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006048 vim_free(l1);
6049 vim_free(l2);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006050 vim_free(l3);
6051 return;
6052 }
6053
zeertzjqc95e64f2024-05-20 14:00:31 +02006054 list_append_number(l2, curbuf->b_fnum);
6055 list_append_number(l2, p1.lnum);
zeertzjq2b09de92024-05-24 07:48:51 +02006056 list_append_number(l2, p1.col);
zeertzjqc95e64f2024-05-20 14:00:31 +02006057 list_append_number(l2, p1.coladd);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006058
zeertzjqc95e64f2024-05-20 14:00:31 +02006059 list_append_number(l3, curbuf->b_fnum);
6060 list_append_number(l3, p2.lnum);
zeertzjq2b09de92024-05-24 07:48:51 +02006061 list_append_number(l3, p2.col);
zeertzjqc95e64f2024-05-20 14:00:31 +02006062 list_append_number(l3, p2.coladd);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006063}
6064
6065/*
6066 * "getregionpos()" function
6067 */
6068 static void
6069f_getregionpos(typval_T *argvars, typval_T *rettv)
6070{
6071 pos_T p1, p2;
6072 int inclusive = TRUE;
6073 int region_type = -1;
zeertzjq2b09de92024-05-24 07:48:51 +02006074 int allow_eol = FALSE;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006075 oparg_T oa;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006076 int lnum;
6077
6078 buf_T *save_curbuf;
6079 int save_virtual;
6080
6081 save_curbuf = curbuf;
6082 save_virtual = virtual_op;
6083
6084 if (getregionpos(argvars, rettv,
zeertzjqc95e64f2024-05-20 14:00:31 +02006085 &p1, &p2, &inclusive, &region_type, &oa) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006086 return;
6087
zeertzjq2b09de92024-05-24 07:48:51 +02006088 if (argvars[2].v_type == VAR_DICT)
6089 allow_eol = dict_get_bool(argvars[2].vval.v_dict, "eol", FALSE);
6090
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006091 for (lnum = p1.lnum; lnum <= p2.lnum; lnum++)
6092 {
zeertzjq2b09de92024-05-24 07:48:51 +02006093 pos_T ret_p1, ret_p2;
zeertzjqef733742024-05-26 18:42:18 +02006094 char_u *line = ml_get(lnum);
zeertzjq2b09de92024-05-24 07:48:51 +02006095 colnr_T line_len = ml_get_len(lnum);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006096
6097 if (region_type == MLINE)
6098 {
zeertzjqc95e64f2024-05-20 14:00:31 +02006099 ret_p1.col = 1;
6100 ret_p1.coladd = 0;
6101 ret_p2.col = MAXCOL;
6102 ret_p2.coladd = 0;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006103 }
6104 else
6105 {
zeertzjq52a6f342024-05-22 16:42:44 +02006106 struct block_def bd;
6107
zeertzjqc95e64f2024-05-20 14:00:31 +02006108 if (region_type == MBLOCK)
6109 block_prep(&oa, &bd, lnum, FALSE);
6110 else
6111 charwise_block_prep(p1, p2, &bd, lnum, inclusive);
zeertzjq52a6f342024-05-22 16:42:44 +02006112
6113 if (bd.is_oneChar) // selection entirely inside one char
6114 {
6115 if (region_type == MBLOCK)
6116 {
zeertzjqef733742024-05-26 18:42:18 +02006117 ret_p1.col = mb_prevptr(line, bd.textstart) - line + 1;
zeertzjq52a6f342024-05-22 16:42:44 +02006118 ret_p1.coladd = bd.start_char_vcols
6119 - (bd.start_vcol - oa.start_vcol);
6120 }
6121 else
6122 {
6123 ret_p1.col = p1.col + 1;
6124 ret_p1.coladd = p1.coladd;
6125 }
6126 }
zeertzjq2b09de92024-05-24 07:48:51 +02006127 else if (region_type == MBLOCK && oa.start_vcol > bd.start_vcol)
6128 {
6129 // blockwise selection entirely beyond end of line
6130 ret_p1.col = MAXCOL;
6131 ret_p1.coladd = oa.start_vcol - bd.start_vcol;
6132 bd.is_oneChar = TRUE;
6133 }
zeertzjq52a6f342024-05-22 16:42:44 +02006134 else if (bd.startspaces > 0)
zeertzjqc95e64f2024-05-20 14:00:31 +02006135 {
zeertzjqef733742024-05-26 18:42:18 +02006136 ret_p1.col = mb_prevptr(line, bd.textstart) - line + 1;
zeertzjqc95e64f2024-05-20 14:00:31 +02006137 ret_p1.coladd = bd.start_char_vcols - bd.startspaces;
6138 }
6139 else
6140 {
6141 ret_p1.col = bd.textcol + 1;
6142 ret_p1.coladd = 0;
6143 }
zeertzjq52a6f342024-05-22 16:42:44 +02006144
6145 if (bd.is_oneChar) // selection entirely inside one char
6146 {
6147 ret_p2.col = ret_p1.col;
zeertzjq2b09de92024-05-24 07:48:51 +02006148 ret_p2.coladd = ret_p1.coladd + bd.startspaces + bd.endspaces;
zeertzjq52a6f342024-05-22 16:42:44 +02006149 }
6150 else if (bd.endspaces > 0)
zeertzjqc95e64f2024-05-20 14:00:31 +02006151 {
6152 ret_p2.col = bd.textcol + bd.textlen + 1;
6153 ret_p2.coladd = bd.endspaces;
6154 }
6155 else
6156 {
6157 ret_p2.col = bd.textcol + bd.textlen;
6158 ret_p2.coladd = 0;
6159 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006160 }
6161
zeertzjq2b09de92024-05-24 07:48:51 +02006162 if (!allow_eol && ret_p1.col > line_len)
6163 {
6164 ret_p1.col = 0;
6165 ret_p1.coladd = 0;
6166 }
6167 else if (ret_p1.col > line_len + 1)
6168 ret_p1.col = line_len + 1;
6169
6170 if (!allow_eol && ret_p2.col > line_len)
6171 {
6172 ret_p2.col = ret_p1.col == 0 ? 0 : line_len;
6173 ret_p2.coladd = 0;
6174 }
6175 else if (ret_p2.col > line_len + 1)
6176 ret_p2.col = line_len + 1;
6177
zeertzjqc95e64f2024-05-20 14:00:31 +02006178 ret_p1.lnum = lnum;
6179 ret_p2.lnum = lnum;
6180 add_regionpos_range(rettv, ret_p1, ret_p2);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006181 }
6182
6183 // getregionpos() may change curbuf and virtual_op
zeertzjq5406eb82024-03-11 21:36:42 +01006184 curbuf = save_curbuf;
6185 curwin->w_buffer = curbuf;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006186 virtual_op = save_virtual;
6187}
6188
6189/*
zeertzjqd3f00f52021-12-24 12:02:43 +00006190 * Common between getreg(), getreginfo() and getregtype(): get the register
6191 * name from the first argument.
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006192 * Returns zero on error.
6193 */
6194 static int
6195getreg_get_regname(typval_T *argvars)
6196{
6197 char_u *strregname;
6198
6199 if (argvars[0].v_type != VAR_UNKNOWN)
6200 {
6201 strregname = tv_get_string_chk(&argvars[0]);
6202 if (strregname != NULL && in_vim9script() && STRLEN(strregname) > 1)
6203 {
6204 semsg(_(e_register_name_must_be_one_char_str), strregname);
6205 strregname = NULL;
6206 }
6207 if (strregname == NULL) // type error; errmsg already given
6208 return 0;
6209 }
6210 else
6211 // Default to v:register
6212 strregname = get_vim_var_str(VV_REG);
6213
6214 return *strregname == 0 ? '"' : *strregname;
6215}
6216
6217/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006218 * "getreg()" function
6219 */
6220 static void
6221f_getreg(typval_T *argvars, typval_T *rettv)
6222{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006223 int regname;
6224 int arg2 = FALSE;
6225 int return_list = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006226
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02006227 if (in_vim9script()
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006228 && (check_for_opt_string_arg(argvars, 0) == FAIL
6229 || (argvars[0].v_type != VAR_UNKNOWN
6230 && (check_for_opt_bool_arg(argvars, 1) == FAIL
6231 || (argvars[1].v_type != VAR_UNKNOWN
6232 && check_for_opt_bool_arg(argvars, 2) == FAIL)))))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02006233 return;
6234
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006235 regname = getreg_get_regname(argvars);
6236 if (regname == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006237 return;
6238
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006239 if (argvars[0].v_type != VAR_UNKNOWN && argvars[1].v_type != VAR_UNKNOWN)
6240 {
6241 int error = FALSE;
6242
6243 arg2 = (int)tv_get_bool_chk(&argvars[1], &error);
6244
6245 if (!error && argvars[2].v_type != VAR_UNKNOWN)
6246 return_list = (int)tv_get_bool_chk(&argvars[2], &error);
6247 if (error)
6248 return;
6249 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006250
6251 if (return_list)
6252 {
6253 rettv->v_type = VAR_LIST;
6254 rettv->vval.v_list = (list_T *)get_reg_contents(regname,
6255 (arg2 ? GREG_EXPR_SRC : 0) | GREG_LIST);
6256 if (rettv->vval.v_list == NULL)
6257 (void)rettv_list_alloc(rettv);
6258 else
6259 ++rettv->vval.v_list->lv_refcount;
6260 }
6261 else
6262 {
6263 rettv->v_type = VAR_STRING;
6264 rettv->vval.v_string = get_reg_contents(regname,
6265 arg2 ? GREG_EXPR_SRC : 0);
6266 }
6267}
6268
6269/*
6270 * "getregtype()" function
6271 */
6272 static void
6273f_getregtype(typval_T *argvars, typval_T *rettv)
6274{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006275 int regname;
6276 char_u buf[NUMBUFLEN + 2];
6277 long reglen = 0;
6278
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006279 // on error return an empty string
6280 rettv->v_type = VAR_STRING;
6281 rettv->vval.v_string = NULL;
6282
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006283 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
6284 return;
6285
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006286 regname = getreg_get_regname(argvars);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006287 if (regname == 0)
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006288 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006289
6290 buf[0] = NUL;
6291 buf[1] = NUL;
6292 switch (get_reg_type(regname, &reglen))
6293 {
6294 case MLINE: buf[0] = 'V'; break;
6295 case MCHAR: buf[0] = 'v'; break;
6296 case MBLOCK:
6297 buf[0] = Ctrl_V;
6298 sprintf((char *)buf + 1, "%ld", reglen + 1);
6299 break;
6300 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006301 rettv->vval.v_string = vim_strsave(buf);
6302}
6303
Bram Moolenaarb5ae48e2016-08-12 22:23:25 +02006304/*
Bram Moolenaarf49cc602018-11-11 15:21:05 +01006305 * "gettagstack()" function
6306 */
6307 static void
6308f_gettagstack(typval_T *argvars, typval_T *rettv)
6309{
6310 win_T *wp = curwin; // default is current window
6311
Bram Moolenaar93a10962022-06-16 11:42:09 +01006312 if (rettv_dict_alloc(rettv) == FAIL)
Bram Moolenaarf49cc602018-11-11 15:21:05 +01006313 return;
6314
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006315 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
6316 return;
6317
Bram Moolenaarf49cc602018-11-11 15:21:05 +01006318 if (argvars[0].v_type != VAR_UNKNOWN)
6319 {
6320 wp = find_win_by_nr_or_id(&argvars[0]);
6321 if (wp == NULL)
6322 return;
6323 }
6324
6325 get_tagstack(wp, rettv->vval.v_dict);
6326}
6327
Bram Moolenaar0b39c3f2020-08-30 15:52:10 +02006328/*
6329 * "gettext()" function
6330 */
6331 static void
6332f_gettext(typval_T *argvars, typval_T *rettv)
6333{
Christ van Willegence0ef912024-06-20 23:41:59 +02006334#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
6335 char *prev = NULL;
6336#endif
6337
6338 if (check_for_nonempty_string_arg(argvars, 0) == FAIL
6339 || check_for_opt_string_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006340 return;
6341
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +01006342 rettv->v_type = VAR_STRING;
Christ van Willegence0ef912024-06-20 23:41:59 +02006343
6344 if (argvars[1].v_type == VAR_STRING &&
6345 argvars[1].vval.v_string != NULL &&
6346 *(argvars[1].vval.v_string) != NUL)
6347 {
6348#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
6349 prev = bind_textdomain_codeset((const char *)argvars[1].vval.v_string, (char *)p_enc);
6350#endif
6351
6352#if defined(HAVE_DGETTEXT)
6353 rettv->vval.v_string = vim_strsave((char_u *)dgettext((const char *)argvars[1].vval.v_string, (const char *)argvars[0].vval.v_string));
6354#else
6355 textdomain((const char *)argvars[1].vval.v_string);
6356 rettv->vval.v_string = vim_strsave((char_u *)_(argvars[0].vval.v_string));
6357 textdomain(VIMPACKAGE);
6358#endif
6359
6360#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
6361 if (prev != NULL)
6362 bind_textdomain_codeset((const char *)argvars[1].vval.v_string, prev);
6363#endif
6364 }
6365 else
6366 rettv->vval.v_string = vim_strsave((char_u *)_(argvars[0].vval.v_string));
Bram Moolenaar0b39c3f2020-08-30 15:52:10 +02006367}
6368
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01006369// for VIM_VERSION_ defines
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006370#include "version.h"
6371
6372/*
6373 * "has()" function
6374 */
Bram Moolenaara259d8d2020-01-31 20:10:50 +01006375 void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006376f_has(typval_T *argvars, typval_T *rettv)
6377{
6378 int i;
6379 char_u *name;
Bram Moolenaar79296512020-03-22 16:17:14 +01006380 int x = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006381 int n = FALSE;
Bram Moolenaar79296512020-03-22 16:17:14 +01006382 typedef struct {
6383 char *name;
6384 short present;
6385 } has_item_T;
6386 static has_item_T has_list[] =
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006387 {
Bram Moolenaar79296512020-03-22 16:17:14 +01006388 {"amiga",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006389#ifdef AMIGA
Bram Moolenaar79296512020-03-22 16:17:14 +01006390 1
Bram Moolenaar39536dd2019-01-29 22:58:21 +01006391#else
Bram Moolenaar79296512020-03-22 16:17:14 +01006392 0
Bram Moolenaar39536dd2019-01-29 22:58:21 +01006393#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006394 },
6395 {"arp",
6396#if defined(AMIGA) && defined(FEAT_ARP)
6397 1
6398#else
6399 0
6400#endif
6401 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006402 {"haiku",
6403#ifdef __HAIKU__
6404 1
6405#else
6406 0
6407#endif
6408 },
6409 {"bsd",
6410#if defined(BSD) && !defined(MACOS_X)
6411 1
6412#else
6413 0
6414#endif
6415 },
6416 {"hpux",
6417#ifdef hpux
6418 1
6419#else
6420 0
6421#endif
6422 },
6423 {"linux",
6424#ifdef __linux__
6425 1
6426#else
6427 0
6428#endif
6429 },
6430 {"mac", // Mac OS X (and, once, Mac OS Classic)
6431#ifdef MACOS_X
6432 1
6433#else
6434 0
6435#endif
6436 },
6437 {"osx", // Mac OS X
6438#ifdef MACOS_X
6439 1
6440#else
6441 0
6442#endif
6443 },
6444 {"macunix", // Mac OS X, with the darwin feature
6445#if defined(MACOS_X) && defined(MACOS_X_DARWIN)
6446 1
6447#else
6448 0
6449#endif
6450 },
6451 {"osxdarwin", // synonym for macunix
6452#if defined(MACOS_X) && defined(MACOS_X_DARWIN)
6453 1
6454#else
6455 0
6456#endif
6457 },
6458 {"qnx",
6459#ifdef __QNX__
6460 1
6461#else
6462 0
6463#endif
6464 },
6465 {"sun",
6466#ifdef SUN_SYSTEM
6467 1
6468#else
6469 0
6470#endif
6471 },
6472 {"unix",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006473#ifdef UNIX
Bram Moolenaar79296512020-03-22 16:17:14 +01006474 1
6475#else
6476 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006477#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006478 },
6479 {"vms",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006480#ifdef VMS
Bram Moolenaar79296512020-03-22 16:17:14 +01006481 1
6482#else
6483 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006484#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006485 },
6486 {"win32",
Bram Moolenaar4f974752019-02-17 17:44:42 +01006487#ifdef MSWIN
Bram Moolenaar79296512020-03-22 16:17:14 +01006488 1
6489#else
6490 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006491#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006492 },
6493 {"win32unix",
K.Takata972db232022-02-04 10:45:38 +00006494#ifdef WIN32UNIX
Bram Moolenaar79296512020-03-22 16:17:14 +01006495 1
6496#else
6497 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006498#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006499 },
6500 {"win64",
Bram Moolenaar44b443c2019-02-18 22:14:18 +01006501#ifdef _WIN64
Bram Moolenaar79296512020-03-22 16:17:14 +01006502 1
6503#else
6504 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006505#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006506 },
Bram Moolenaar424bcae2022-01-31 14:59:41 +00006507 {"ebcdic", 0 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006508 {"fname_case",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006509#ifndef CASE_INSENSITIVE_FILENAME
Bram Moolenaar79296512020-03-22 16:17:14 +01006510 1
6511#else
6512 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006513#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006514 },
6515 {"acl",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006516#ifdef HAVE_ACL
Bram Moolenaar79296512020-03-22 16:17:14 +01006517 1
6518#else
6519 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006520#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006521 },
6522 {"arabic",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006523#ifdef FEAT_ARABIC
Bram Moolenaar79296512020-03-22 16:17:14 +01006524 1
6525#else
6526 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006527#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006528 },
6529 {"autocmd", 1},
6530 {"autochdir",
Bram Moolenaar83ec2a72018-07-27 22:08:59 +02006531#ifdef FEAT_AUTOCHDIR
Bram Moolenaar79296512020-03-22 16:17:14 +01006532 1
6533#else
6534 0
Bram Moolenaar83ec2a72018-07-27 22:08:59 +02006535#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006536 },
6537 {"autoservername",
Bram Moolenaare42a6d22017-11-12 19:21:51 +01006538#ifdef FEAT_AUTOSERVERNAME
Bram Moolenaar79296512020-03-22 16:17:14 +01006539 1
6540#else
6541 0
Bram Moolenaare42a6d22017-11-12 19:21:51 +01006542#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006543 },
6544 {"balloon_eval",
Bram Moolenaarc3719bd2017-11-18 22:13:31 +01006545#ifdef FEAT_BEVAL_GUI
Bram Moolenaar79296512020-03-22 16:17:14 +01006546 1
6547#else
6548 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006549#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006550 },
6551 {"balloon_multiline",
Bram Moolenaar0bd663a2022-01-22 10:24:47 +00006552#ifdef FEAT_BEVAL_GUI
Bram Moolenaar79296512020-03-22 16:17:14 +01006553 1
6554#else
6555 0
6556#endif
6557 },
6558 {"balloon_eval_term",
Bram Moolenaarc3719bd2017-11-18 22:13:31 +01006559#ifdef FEAT_BEVAL_TERM
Bram Moolenaar79296512020-03-22 16:17:14 +01006560 1
6561#else
6562 0
Bram Moolenaar51b0f372017-11-18 18:52:04 +01006563#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006564 },
Bram Moolenaar2ee347f2022-08-26 17:53:44 +01006565 {"builtin_terms", 1},
6566 {"all_builtin_terms", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006567 {"browsefilter",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006568#if defined(FEAT_BROWSE) && (defined(USE_FILE_CHOOSER) \
Bram Moolenaar4f974752019-02-17 17:44:42 +01006569 || defined(FEAT_GUI_MSWIN) \
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006570 || defined(FEAT_GUI_MOTIF))
Bram Moolenaar79296512020-03-22 16:17:14 +01006571 1
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006572#else
Bram Moolenaar79296512020-03-22 16:17:14 +01006573 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006574#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006575 },
6576 {"byte_offset",
6577#ifdef FEAT_BYTEOFF
6578 1
6579#else
6580 0
6581#endif
6582 },
6583 {"channel",
6584#ifdef FEAT_JOB_CHANNEL
6585 1
6586#else
6587 0
6588#endif
6589 },
Bram Moolenaar8e145b82022-05-21 20:17:31 +01006590 {"cindent", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006591 {"clientserver",
6592#ifdef FEAT_CLIENTSERVER
6593 1
6594#else
6595 0
6596#endif
6597 },
6598 {"clipboard",
6599#ifdef FEAT_CLIPBOARD
6600 1
6601#else
6602 0
6603#endif
6604 },
6605 {"cmdline_compl", 1},
6606 {"cmdline_hist", 1},
Martin Tournoij7904fa42022-10-04 16:28:45 +01006607 {"cmdwin", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006608 {"comments", 1},
6609 {"conceal",
6610#ifdef FEAT_CONCEAL
6611 1
6612#else
6613 0
6614#endif
6615 },
6616 {"cryptv",
6617#ifdef FEAT_CRYPT
6618 1
6619#else
6620 0
6621#endif
6622 },
6623 {"crypt-blowfish",
6624#ifdef FEAT_CRYPT
6625 1
6626#else
6627 0
6628#endif
6629 },
6630 {"crypt-blowfish2",
6631#ifdef FEAT_CRYPT
6632 1
6633#else
6634 0
6635#endif
6636 },
6637 {"cscope",
6638#ifdef FEAT_CSCOPE
6639 1
6640#else
6641 0
6642#endif
6643 },
6644 {"cursorbind", 1},
6645 {"cursorshape",
6646#ifdef CURSOR_SHAPE
6647 1
6648#else
6649 0
6650#endif
6651 },
6652 {"debug",
6653#ifdef DEBUG
6654 1
6655#else
6656 0
6657#endif
6658 },
6659 {"dialog_con",
6660#ifdef FEAT_CON_DIALOG
6661 1
6662#else
6663 0
6664#endif
6665 },
glepnirdf461152024-04-04 22:23:29 +02006666 {"dialog_con_gui",
6667#if defined(FEAT_CON_DIALOG) && defined(FEAT_GUI_DIALOG)
6668 1
6669#else
6670 0
6671#endif
6672 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006673 {"dialog_gui",
6674#ifdef FEAT_GUI_DIALOG
6675 1
6676#else
6677 0
6678#endif
6679 },
6680 {"diff",
6681#ifdef FEAT_DIFF
6682 1
6683#else
6684 0
6685#endif
6686 },
6687 {"digraphs",
6688#ifdef FEAT_DIGRAPHS
6689 1
6690#else
6691 0
6692#endif
6693 },
6694 {"directx",
6695#ifdef FEAT_DIRECTX
6696 1
6697#else
6698 0
6699#endif
6700 },
6701 {"dnd",
6702#ifdef FEAT_DND
6703 1
6704#else
6705 0
6706#endif
6707 },
Bram Moolenaar1d1ce612021-06-27 19:02:52 +02006708 {"drop_file",
6709#ifdef HAVE_DROP_FILE
6710 1
6711#else
6712 0
6713#endif
6714 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006715 {"emacs_tags",
6716#ifdef FEAT_EMACS_TAGS
6717 1
6718#else
6719 0
6720#endif
6721 },
6722 {"eval", 1}, // always present, of course!
6723 {"ex_extra", 1}, // graduated feature
6724 {"extra_search",
6725#ifdef FEAT_SEARCH_EXTRA
6726 1
6727#else
6728 0
6729#endif
6730 },
Bram Moolenaarf80f40a2022-08-25 16:02:23 +01006731 {"file_in_path", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006732 {"filterpipe",
6733#if defined(FEAT_FILTERPIPE) && !defined(VIMDLL)
6734 1
6735#else
6736 0
6737#endif
6738 },
6739 {"find_in_path",
6740#ifdef FEAT_FIND_ID
6741 1
6742#else
6743 0
6744#endif
6745 },
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01006746 {"float", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006747 {"folding",
6748#ifdef FEAT_FOLDING
6749 1
6750#else
6751 0
6752#endif
6753 },
Bram Moolenaarc8ac3a02022-09-04 12:29:28 +01006754 {"footer", 0},
Bram Moolenaar79296512020-03-22 16:17:14 +01006755 {"fork",
6756#if !defined(USE_SYSTEM) && defined(UNIX)
6757 1
6758#else
6759 0
6760#endif
6761 },
6762 {"gettext",
6763#ifdef FEAT_GETTEXT
6764 1
6765#else
6766 0
6767#endif
6768 },
6769 {"gui",
6770#ifdef FEAT_GUI
6771 1
6772#else
6773 0
6774#endif
6775 },
Bram Moolenaar0b962e52022-04-03 18:02:37 +01006776 {"gui_neXtaw", 0 },
6777 {"gui_athena", 0 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006778 {"gui_gtk",
6779#ifdef FEAT_GUI_GTK
6780 1
6781#else
6782 0
6783#endif
6784 },
6785 {"gui_gtk2",
6786#if defined(FEAT_GUI_GTK) && !defined(USE_GTK3)
6787 1
6788#else
6789 0
6790#endif
6791 },
6792 {"gui_gtk3",
6793#if defined(FEAT_GUI_GTK) && defined(USE_GTK3)
6794 1
6795#else
6796 0
6797#endif
6798 },
6799 {"gui_gnome",
6800#ifdef FEAT_GUI_GNOME
6801 1
6802#else
6803 0
6804#endif
6805 },
6806 {"gui_haiku",
6807#ifdef FEAT_GUI_HAIKU
6808 1
6809#else
6810 0
6811#endif
6812 },
Bram Moolenaar097148e2020-08-11 21:58:20 +02006813 {"gui_mac", 0},
Bram Moolenaar79296512020-03-22 16:17:14 +01006814 {"gui_motif",
6815#ifdef FEAT_GUI_MOTIF
6816 1
6817#else
6818 0
6819#endif
6820 },
6821 {"gui_photon",
6822#ifdef FEAT_GUI_PHOTON
6823 1
6824#else
6825 0
6826#endif
6827 },
6828 {"gui_win32",
6829#ifdef FEAT_GUI_MSWIN
6830 1
6831#else
6832 0
6833#endif
6834 },
6835 {"iconv",
6836#if defined(HAVE_ICONV_H) && defined(USE_ICONV)
6837 1
6838#else
6839 0
6840#endif
6841 },
6842 {"insert_expand", 1},
Bram Moolenaarbfe13cc2020-04-12 17:53:12 +02006843 {"ipv6",
6844#ifdef FEAT_IPV6
6845 1
6846#else
6847 0
6848#endif
6849 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006850 {"job",
6851#ifdef FEAT_JOB_CHANNEL
6852 1
6853#else
6854 0
6855#endif
6856 },
Bram Moolenaar739f13a2021-12-13 13:12:53 +00006857 {"jumplist", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006858 {"keymap",
6859#ifdef FEAT_KEYMAP
6860 1
6861#else
6862 0
6863#endif
6864 },
6865 {"lambda", 1}, // always with FEAT_EVAL, since 7.4.2120 with closure
6866 {"langmap",
6867#ifdef FEAT_LANGMAP
6868 1
6869#else
6870 0
6871#endif
6872 },
6873 {"libcall",
6874#ifdef FEAT_LIBCALL
6875 1
6876#else
6877 0
6878#endif
6879 },
6880 {"linebreak",
6881#ifdef FEAT_LINEBREAK
6882 1
6883#else
6884 0
6885#endif
6886 },
Bram Moolenaar8e145b82022-05-21 20:17:31 +01006887 {"lispindent", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006888 {"listcmds", 1},
6889 {"localmap", 1},
6890 {"lua",
6891#if defined(FEAT_LUA) && !defined(DYNAMIC_LUA)
6892 1
6893#else
6894 0
6895#endif
6896 },
6897 {"menu",
6898#ifdef FEAT_MENU
6899 1
6900#else
6901 0
6902#endif
6903 },
6904 {"mksession",
6905#ifdef FEAT_SESSION
6906 1
6907#else
6908 0
6909#endif
6910 },
6911 {"modify_fname", 1},
6912 {"mouse", 1},
6913 {"mouseshape",
6914#ifdef FEAT_MOUSESHAPE
6915 1
6916#else
6917 0
6918#endif
6919 },
6920 {"mouse_dec",
6921#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_DEC)
6922 1
6923#else
6924 0
6925#endif
6926 },
6927 {"mouse_gpm",
Bram Moolenaar33fc4a62022-02-23 18:07:38 +00006928#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_GPM) && !defined(DYNAMIC_GPM)
Bram Moolenaar79296512020-03-22 16:17:14 +01006929 1
6930#else
6931 0
6932#endif
6933 },
6934 {"mouse_jsbterm",
6935#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_JSB)
6936 1
6937#else
6938 0
6939#endif
6940 },
6941 {"mouse_netterm",
6942#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_NET)
6943 1
6944#else
6945 0
6946#endif
6947 },
6948 {"mouse_pterm",
6949#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_PTERM)
6950 1
6951#else
6952 0
6953#endif
6954 },
6955 {"mouse_sgr",
6956#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_XTERM)
6957 1
6958#else
6959 0
6960#endif
6961 },
6962 {"mouse_sysmouse",
6963#if (defined(UNIX) || defined(VMS)) && defined(FEAT_SYSMOUSE)
6964 1
6965#else
6966 0
6967#endif
6968 },
6969 {"mouse_urxvt",
6970#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_URXVT)
6971 1
6972#else
6973 0
6974#endif
6975 },
6976 {"mouse_xterm",
6977#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_XTERM)
6978 1
6979#else
6980 0
6981#endif
6982 },
6983 {"multi_byte", 1},
6984 {"multi_byte_ime",
6985#ifdef FEAT_MBYTE_IME
6986 1
6987#else
6988 0
6989#endif
6990 },
6991 {"multi_lang",
6992#ifdef FEAT_MULTI_LANG
6993 1
6994#else
6995 0
6996#endif
6997 },
6998 {"mzscheme",
6999#if defined(FEAT_MZSCHEME) && !defined(DYNAMIC_MZSCHEME)
7000 1
7001#else
7002 0
7003#endif
7004 },
Leah Neukirchen0a7984a2021-10-14 21:27:55 +01007005 {"nanotime",
7006#ifdef ST_MTIM_NSEC
7007 1
7008#else
7009 0
7010#endif
7011 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007012 {"num64", 1},
7013 {"ole",
7014#ifdef FEAT_OLE
7015 1
7016#else
7017 0
7018#endif
7019 },
7020 {"packages",
7021#ifdef FEAT_EVAL
7022 1
7023#else
7024 0
7025#endif
7026 },
Bram Moolenaar2bd9dbc2022-08-25 18:12:06 +01007027 {"path_extra", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007028 {"perl",
7029#if defined(FEAT_PERL) && !defined(DYNAMIC_PERL)
7030 1
7031#else
7032 0
7033#endif
7034 },
7035 {"persistent_undo",
7036#ifdef FEAT_PERSISTENT_UNDO
7037 1
7038#else
7039 0
7040#endif
7041 },
7042 {"python_compiled",
7043#if defined(FEAT_PYTHON)
7044 1
7045#else
7046 0
7047#endif
7048 },
7049 {"python_dynamic",
7050#if defined(FEAT_PYTHON) && defined(DYNAMIC_PYTHON)
7051 1
7052#else
7053 0
7054#endif
7055 },
7056 {"python",
7057#if defined(FEAT_PYTHON) && !defined(DYNAMIC_PYTHON)
7058 1
7059#else
7060 0
7061#endif
7062 },
7063 {"pythonx",
7064#if (defined(FEAT_PYTHON) && !defined(DYNAMIC_PYTHON)) \
7065 || (defined(FEAT_PYTHON3) && !defined(DYNAMIC_PYTHON3))
7066 1
7067#else
7068 0
7069#endif
7070 },
7071 {"python3_compiled",
7072#if defined(FEAT_PYTHON3)
7073 1
7074#else
7075 0
7076#endif
7077 },
7078 {"python3_dynamic",
7079#if defined(FEAT_PYTHON3) && defined(DYNAMIC_PYTHON3)
7080 1
7081#else
7082 0
7083#endif
7084 },
Yee Cheng Chinc13b3d12023-08-20 21:18:38 +02007085 {"python3_stable",
7086#if defined(FEAT_PYTHON3) && defined(DYNAMIC_PYTHON3_STABLE_ABI)
7087 1
7088#else
7089 0
7090#endif
7091 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007092 {"python3",
7093#if defined(FEAT_PYTHON3) && !defined(DYNAMIC_PYTHON3)
7094 1
7095#else
7096 0
7097#endif
7098 },
7099 {"popupwin",
7100#ifdef FEAT_PROP_POPUP
7101 1
7102#else
7103 0
7104#endif
7105 },
7106 {"postscript",
7107#ifdef FEAT_POSTSCRIPT
7108 1
7109#else
7110 0
7111#endif
7112 },
7113 {"printer",
7114#ifdef FEAT_PRINTER
7115 1
7116#else
7117 0
7118#endif
7119 },
7120 {"profile",
7121#ifdef FEAT_PROFILE
7122 1
7123#else
7124 0
7125#endif
7126 },
Ernie Rael076de792023-03-16 21:43:15 +00007127 {"prof_nsec",
Bram Moolenaar08210f82023-04-13 19:15:54 +01007128#ifdef PROF_NSEC
Ernie Rael076de792023-03-16 21:43:15 +00007129 1
7130#else
7131 0
7132#endif
7133 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007134 {"reltime",
7135#ifdef FEAT_RELTIME
7136 1
7137#else
7138 0
7139#endif
7140 },
7141 {"quickfix",
7142#ifdef FEAT_QUICKFIX
7143 1
7144#else
7145 0
7146#endif
7147 },
7148 {"rightleft",
7149#ifdef FEAT_RIGHTLEFT
7150 1
7151#else
7152 0
7153#endif
7154 },
7155 {"ruby",
7156#if defined(FEAT_RUBY) && !defined(DYNAMIC_RUBY)
7157 1
7158#else
7159 0
7160#endif
7161 },
7162 {"scrollbind", 1},
Martin Tournoijba43e762022-10-13 22:12:15 +01007163 {"showcmd", 1},
7164 {"cmdline_info", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007165 {"signs",
7166#ifdef FEAT_SIGNS
7167 1
7168#else
7169 0
7170#endif
7171 },
Bram Moolenaar8e145b82022-05-21 20:17:31 +01007172 {"smartindent", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007173 {"startuptime",
7174#ifdef STARTUPTIME
7175 1
7176#else
7177 0
7178#endif
7179 },
7180 {"statusline",
7181#ifdef FEAT_STL_OPT
7182 1
7183#else
7184 0
7185#endif
7186 },
7187 {"netbeans_intg",
7188#ifdef FEAT_NETBEANS_INTG
7189 1
7190#else
7191 0
7192#endif
7193 },
Christian Brabandtf573c6e2021-06-20 14:02:16 +02007194 {"sodium",
K.Takatad68b2fc2022-02-12 11:18:37 +00007195#if defined(FEAT_SODIUM) && !defined(DYNAMIC_SODIUM)
Christian Brabandtf573c6e2021-06-20 14:02:16 +02007196 1
7197#else
7198 0
7199#endif
7200 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007201 {"sound",
7202#ifdef FEAT_SOUND
7203 1
7204#else
7205 0
7206#endif
7207 },
7208 {"spell",
7209#ifdef FEAT_SPELL
7210 1
7211#else
7212 0
7213#endif
7214 },
7215 {"syntax",
7216#ifdef FEAT_SYN_HL
7217 1
7218#else
7219 0
7220#endif
7221 },
7222 {"system",
7223#if defined(USE_SYSTEM) || !defined(UNIX)
7224 1
7225#else
7226 0
7227#endif
7228 },
Yegappan Lakshmanan655b7342022-03-06 14:27:10 +00007229 {"tag_binary", 1}, // graduated feature
Bram Moolenaar79296512020-03-22 16:17:14 +01007230 {"tcl",
7231#if defined(FEAT_TCL) && !defined(DYNAMIC_TCL)
7232 1
7233#else
7234 0
7235#endif
7236 },
7237 {"termguicolors",
7238#ifdef FEAT_TERMGUICOLORS
7239 1
7240#else
7241 0
7242#endif
7243 },
7244 {"terminal",
7245#if defined(FEAT_TERMINAL) && !defined(MSWIN)
7246 1
7247#else
7248 0
7249#endif
7250 },
7251 {"terminfo",
7252#ifdef TERMINFO
7253 1
7254#else
7255 0
7256#endif
7257 },
7258 {"termresponse",
7259#ifdef FEAT_TERMRESPONSE
7260 1
7261#else
7262 0
7263#endif
7264 },
Bram Moolenaar88774872022-08-16 20:24:29 +01007265 {"textobjects", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007266 {"textprop",
7267#ifdef FEAT_PROP_POPUP
7268 1
7269#else
7270 0
7271#endif
7272 },
7273 {"tgetent",
7274#ifdef HAVE_TGETENT
7275 1
7276#else
7277 0
7278#endif
7279 },
7280 {"timers",
7281#ifdef FEAT_TIMERS
7282 1
7283#else
7284 0
7285#endif
7286 },
Bram Moolenaar651fca82021-11-29 20:39:38 +00007287 {"title", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007288 {"toolbar",
7289#ifdef FEAT_TOOLBAR
7290 1
7291#else
7292 0
7293#endif
7294 },
7295 {"unnamedplus",
7296#if defined(FEAT_CLIPBOARD) && defined(FEAT_X11)
7297 1
7298#else
7299 0
7300#endif
7301 },
7302 {"user-commands", 1}, // was accidentally included in 5.4
7303 {"user_commands", 1},
7304 {"vartabs",
7305#ifdef FEAT_VARTABS
7306 1
7307#else
7308 0
7309#endif
7310 },
7311 {"vertsplit", 1},
7312 {"viminfo",
7313#ifdef FEAT_VIMINFO
7314 1
7315#else
7316 0
7317#endif
7318 },
Bram Moolenaarb79ee0c2022-01-01 12:17:00 +00007319 {"vim9script", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007320 {"vimscript-1", 1},
7321 {"vimscript-2", 1},
7322 {"vimscript-3", 1},
7323 {"vimscript-4", 1},
7324 {"virtualedit", 1},
7325 {"visual", 1},
7326 {"visualextra", 1},
7327 {"vreplace", 1},
7328 {"vtp",
7329#ifdef FEAT_VTP
7330 1
7331#else
7332 0
7333#endif
7334 },
Bram Moolenaar074fbd42022-08-26 16:41:14 +01007335 {"wildignore", 1},
Bram Moolenaar54162322022-08-26 16:58:51 +01007336 {"wildmenu", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007337 {"windows", 1},
7338 {"winaltkeys",
7339#ifdef FEAT_WAK
7340 1
7341#else
7342 0
7343#endif
7344 },
7345 {"writebackup",
7346#ifdef FEAT_WRITEBACKUP
7347 1
7348#else
7349 0
7350#endif
7351 },
Christian Brabandte085dfd2023-09-30 12:49:18 +02007352 {"xattr",
7353#ifdef FEAT_XATTR
7354 1
7355#else
7356 0
7357#endif
7358 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007359 {"xim",
7360#ifdef FEAT_XIM
7361 1
7362#else
7363 0
7364#endif
7365 },
7366 {"xfontset",
7367#ifdef FEAT_XFONTSET
7368 1
7369#else
7370 0
7371#endif
7372 },
7373 {"xpm",
7374#if defined(FEAT_XPM_W32) || defined(HAVE_XPM)
7375 1
7376#else
7377 0
7378#endif
7379 },
7380 {"xpm_w32", // for backward compatibility
7381#ifdef FEAT_XPM_W32
7382 1
7383#else
7384 0
7385#endif
7386 },
7387 {"xsmp",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007388#ifdef USE_XSMP
Bram Moolenaar79296512020-03-22 16:17:14 +01007389 1
7390#else
7391 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007392#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007393 },
7394 {"xsmp_interact",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007395#ifdef USE_XSMP_INTERACT
Bram Moolenaar79296512020-03-22 16:17:14 +01007396 1
7397#else
7398 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007399#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007400 },
7401 {"xterm_clipboard",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007402#ifdef FEAT_XCLIPBOARD
Bram Moolenaar79296512020-03-22 16:17:14 +01007403 1
7404#else
7405 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007406#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007407 },
7408 {"xterm_save",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007409#ifdef FEAT_XTERM_SAVE
Bram Moolenaar79296512020-03-22 16:17:14 +01007410 1
7411#else
7412 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007413#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007414 },
7415 {"X11",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007416#if defined(UNIX) && defined(FEAT_X11)
Bram Moolenaar79296512020-03-22 16:17:14 +01007417 1
7418#else
7419 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007420#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007421 },
Bram Moolenaar80adaa82023-07-07 18:57:40 +01007422 {":tearoff",
7423// same #ifdef as used for ex_tearoff().
7424#if defined(FEAT_GUI_MSWIN) && defined(FEAT_MENU) && defined(FEAT_TEAROFF)
7425 1
7426#else
7427 0
7428#endif
7429 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007430 {NULL, 0}
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007431 };
7432
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02007433 if (in_vim9script()
7434 && (check_for_string_arg(argvars, 0) == FAIL
7435 || check_for_opt_bool_arg(argvars, 1) == FAIL))
7436 return;
7437
Bram Moolenaard155d7a2018-12-21 16:04:21 +01007438 name = tv_get_string(&argvars[0]);
Bram Moolenaar79296512020-03-22 16:17:14 +01007439 for (i = 0; has_list[i].name != NULL; ++i)
7440 if (STRICMP(name, has_list[i].name) == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007441 {
Bram Moolenaar79296512020-03-22 16:17:14 +01007442 x = TRUE;
7443 n = has_list[i].present;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007444 break;
7445 }
7446
Bram Moolenaar79296512020-03-22 16:17:14 +01007447 // features also in has_list[] but sometimes enabled at runtime
7448 if (x == TRUE && n == FALSE)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007449 {
Bram Moolenaar79296512020-03-22 16:17:14 +01007450 if (0)
Bram Moolenaar86b9a3e2020-04-07 19:57:29 +02007451 {
7452 // intentionally empty
7453 }
Bram Moolenaar79296512020-03-22 16:17:14 +01007454#ifdef VIMDLL
7455 else if (STRICMP(name, "filterpipe") == 0)
7456 n = gui.in_use || gui.starting;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007457#endif
7458#if defined(USE_ICONV) && defined(DYNAMIC_ICONV)
7459 else if (STRICMP(name, "iconv") == 0)
7460 n = iconv_enabled(FALSE);
7461#endif
7462#ifdef DYNAMIC_LUA
7463 else if (STRICMP(name, "lua") == 0)
7464 n = lua_enabled(FALSE);
7465#endif
7466#ifdef DYNAMIC_MZSCHEME
7467 else if (STRICMP(name, "mzscheme") == 0)
7468 n = mzscheme_enabled(FALSE);
7469#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007470#ifdef DYNAMIC_PERL
7471 else if (STRICMP(name, "perl") == 0)
7472 n = perl_enabled(FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007473#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007474#ifdef DYNAMIC_PYTHON
7475 else if (STRICMP(name, "python") == 0)
7476 n = python_enabled(FALSE);
7477#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007478#ifdef DYNAMIC_PYTHON3
7479 else if (STRICMP(name, "python3") == 0)
7480 n = python3_enabled(FALSE);
7481#endif
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01007482#if defined(DYNAMIC_PYTHON) || defined(DYNAMIC_PYTHON3)
7483 else if (STRICMP(name, "pythonx") == 0)
7484 {
7485# if defined(DYNAMIC_PYTHON) && defined(DYNAMIC_PYTHON3)
7486 if (p_pyx == 0)
7487 n = python3_enabled(FALSE) || python_enabled(FALSE);
7488 else if (p_pyx == 3)
7489 n = python3_enabled(FALSE);
7490 else if (p_pyx == 2)
7491 n = python_enabled(FALSE);
7492# elif defined(DYNAMIC_PYTHON)
7493 n = python_enabled(FALSE);
7494# elif defined(DYNAMIC_PYTHON3)
7495 n = python3_enabled(FALSE);
7496# endif
7497 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007498#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007499#ifdef DYNAMIC_RUBY
7500 else if (STRICMP(name, "ruby") == 0)
7501 n = ruby_enabled(FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007502#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007503#ifdef DYNAMIC_TCL
7504 else if (STRICMP(name, "tcl") == 0)
7505 n = tcl_enabled(FALSE);
Bram Moolenaar4b8366b2019-05-04 17:34:34 +02007506#endif
K.Takatad68b2fc2022-02-12 11:18:37 +00007507#ifdef DYNAMIC_SODIUM
7508 else if (STRICMP(name, "sodium") == 0)
7509 n = sodium_enabled(FALSE);
7510#endif
Bram Moolenaar4f974752019-02-17 17:44:42 +01007511#if defined(FEAT_TERMINAL) && defined(MSWIN)
Bram Moolenaara83e3962017-08-17 14:39:07 +02007512 else if (STRICMP(name, "terminal") == 0)
7513 n = terminal_enabled();
7514#endif
Bram Moolenaar33fc4a62022-02-23 18:07:38 +00007515#ifdef DYNAMIC_GPM
7516 else if (STRICMP(name, "mouse_gpm") == 0)
7517 n = gpm_available();
7518#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007519 }
7520
Bram Moolenaar79296512020-03-22 16:17:14 +01007521 // features not in has_list[]
7522 if (x == FALSE)
7523 {
7524 if (STRNICMP(name, "patch", 5) == 0)
7525 {
7526 x = TRUE;
7527 if (name[5] == '-'
7528 && STRLEN(name) >= 11
K.Takatad90f91f2022-07-30 15:43:59 +01007529 && (name[6] >= '1' && name[6] <= '9'))
Bram Moolenaar79296512020-03-22 16:17:14 +01007530 {
K.Takatad90f91f2022-07-30 15:43:59 +01007531 char *end;
7532 int major, minor;
Bram Moolenaar79296512020-03-22 16:17:14 +01007533
K.Takatad90f91f2022-07-30 15:43:59 +01007534 // This works for patch-8.1.2, patch-9.0.3, patch-10.0.4, etc.
7535 // Not for patch-9.10.5.
7536 major = (int)strtoul((char *)name + 6, &end, 10);
7537 if (*end == '.' && vim_isdigit(end[1])
7538 && end[2] == '.' && vim_isdigit(end[3]))
7539 {
7540 minor = atoi(end + 1);
7541
7542 // Expect "patch-9.9.01234".
7543 n = (major < VIM_VERSION_MAJOR
7544 || (major == VIM_VERSION_MAJOR
7545 && (minor < VIM_VERSION_MINOR
7546 || (minor == VIM_VERSION_MINOR
7547 && has_patch(atoi(end + 3))))));
7548 }
Bram Moolenaar79296512020-03-22 16:17:14 +01007549 }
Keith Thompson184f71c2024-01-04 21:19:04 +01007550 else if (SAFE_isdigit(name[5]))
Bram Moolenaar79296512020-03-22 16:17:14 +01007551 n = has_patch(atoi((char *)name + 5));
7552 }
7553 else if (STRICMP(name, "vim_starting") == 0)
7554 {
7555 x = TRUE;
7556 n = (starting != 0);
7557 }
7558 else if (STRICMP(name, "ttyin") == 0)
7559 {
7560 x = TRUE;
7561 n = mch_input_isatty();
7562 }
7563 else if (STRICMP(name, "ttyout") == 0)
7564 {
7565 x = TRUE;
7566 n = stdout_isatty;
7567 }
7568 else if (STRICMP(name, "multi_byte_encoding") == 0)
7569 {
7570 x = TRUE;
7571 n = has_mbyte;
7572 }
7573 else if (STRICMP(name, "gui_running") == 0)
7574 {
7575 x = TRUE;
7576#ifdef FEAT_GUI
7577 n = (gui.in_use || gui.starting);
7578#endif
7579 }
7580 else if (STRICMP(name, "browse") == 0)
7581 {
7582 x = TRUE;
7583#if defined(FEAT_GUI) && defined(FEAT_BROWSE)
7584 n = gui.in_use; // gui_mch_browse() works when GUI is running
7585#endif
7586 }
7587 else if (STRICMP(name, "syntax_items") == 0)
7588 {
7589 x = TRUE;
7590#ifdef FEAT_SYN_HL
7591 n = syntax_present(curwin);
7592#endif
7593 }
7594 else if (STRICMP(name, "vcon") == 0)
7595 {
7596 x = TRUE;
7597#ifdef FEAT_VTP
7598 n = is_term_win32() && has_vtp_working();
7599#endif
7600 }
7601 else if (STRICMP(name, "netbeans_enabled") == 0)
7602 {
7603 x = TRUE;
7604#ifdef FEAT_NETBEANS_INTG
7605 n = netbeans_active();
7606#endif
7607 }
7608 else if (STRICMP(name, "mouse_gpm_enabled") == 0)
7609 {
7610 x = TRUE;
7611#ifdef FEAT_MOUSE_GPM
7612 n = gpm_enabled();
7613#endif
7614 }
7615 else if (STRICMP(name, "conpty") == 0)
7616 {
7617 x = TRUE;
7618#if defined(FEAT_TERMINAL) && defined(MSWIN)
7619 n = use_conpty();
7620#endif
7621 }
7622 else if (STRICMP(name, "clipboard_working") == 0)
7623 {
7624 x = TRUE;
7625#ifdef FEAT_CLIPBOARD
7626 n = clip_star.available;
7627#endif
7628 }
7629 }
7630
Bram Moolenaar04637e22020-09-05 18:45:29 +02007631 if (argvars[1].v_type != VAR_UNKNOWN && tv_get_bool(&argvars[1]))
Bram Moolenaar79296512020-03-22 16:17:14 +01007632 // return whether feature could ever be enabled
7633 rettv->vval.v_number = x;
7634 else
7635 // return whether feature is enabled
7636 rettv->vval.v_number = n;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007637}
7638
7639/*
Bram Moolenaar8cebd432020-11-08 12:49:47 +01007640 * Return TRUE if "feature" can change later.
7641 * Also when checking for the feature has side effects, such as loading a DLL.
7642 */
7643 int
7644dynamic_feature(char_u *feature)
7645{
7646 return (feature == NULL
Bram Moolenaar8cebd432020-11-08 12:49:47 +01007647#if defined(FEAT_GUI) && defined(FEAT_BROWSE)
7648 || (STRICMP(feature, "browse") == 0 && !gui.in_use)
7649#endif
7650#ifdef VIMDLL
7651 || STRICMP(feature, "filterpipe") == 0
7652#endif
Bram Moolenaar29b281b2020-11-10 20:58:00 +01007653#if defined(FEAT_GUI) && !defined(ALWAYS_USE_GUI) && !defined(VIMDLL)
Bram Moolenaar8cebd432020-11-08 12:49:47 +01007654 // this can only change on Unix where the ":gui" command could be
7655 // used.
7656 || (STRICMP(feature, "gui_running") == 0 && !gui.in_use)
7657#endif
7658#if defined(USE_ICONV) && defined(DYNAMIC_ICONV)
7659 || STRICMP(feature, "iconv") == 0
7660#endif
7661#ifdef DYNAMIC_LUA
7662 || STRICMP(feature, "lua") == 0
7663#endif
7664#ifdef FEAT_MOUSE_GPM
7665 || (STRICMP(feature, "mouse_gpm_enabled") == 0 && !gpm_enabled())
7666#endif
7667#ifdef DYNAMIC_MZSCHEME
7668 || STRICMP(feature, "mzscheme") == 0
7669#endif
7670#ifdef FEAT_NETBEANS_INTG
7671 || STRICMP(feature, "netbeans_enabled") == 0
7672#endif
7673#ifdef DYNAMIC_PERL
7674 || STRICMP(feature, "perl") == 0
7675#endif
7676#ifdef DYNAMIC_PYTHON
7677 || STRICMP(feature, "python") == 0
7678#endif
7679#ifdef DYNAMIC_PYTHON3
7680 || STRICMP(feature, "python3") == 0
7681#endif
7682#if defined(DYNAMIC_PYTHON) || defined(DYNAMIC_PYTHON3)
7683 || STRICMP(feature, "pythonx") == 0
7684#endif
7685#ifdef DYNAMIC_RUBY
7686 || STRICMP(feature, "ruby") == 0
7687#endif
7688#ifdef FEAT_SYN_HL
7689 || STRICMP(feature, "syntax_items") == 0
7690#endif
7691#ifdef DYNAMIC_TCL
7692 || STRICMP(feature, "tcl") == 0
7693#endif
7694 // once "starting" is zero it will stay that way
7695 || (STRICMP(feature, "vim_starting") == 0 && starting != 0)
7696 || STRICMP(feature, "multi_byte_encoding") == 0
7697#if defined(FEAT_TERMINAL) && defined(MSWIN)
7698 || STRICMP(feature, "conpty") == 0
7699#endif
7700 );
7701}
7702
7703/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007704 * "haslocaldir()" function
7705 */
7706 static void
7707f_haslocaldir(typval_T *argvars, typval_T *rettv)
7708{
Bram Moolenaar00aa0692019-04-27 20:37:57 +02007709 tabpage_T *tp = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007710 win_T *wp = NULL;
7711
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02007712 if (in_vim9script()
7713 && (check_for_opt_number_arg(argvars, 0) == FAIL
7714 || (argvars[0].v_type != VAR_UNKNOWN
7715 && check_for_opt_number_arg(argvars, 1) == FAIL)))
7716 return;
7717
Bram Moolenaar00aa0692019-04-27 20:37:57 +02007718 wp = find_tabwin(&argvars[0], &argvars[1], &tp);
7719
7720 // Check for window-local and tab-local directories
7721 if (wp != NULL && wp->w_localdir != NULL)
7722 rettv->vval.v_number = 1;
7723 else if (tp != NULL && tp->tp_localdir != NULL)
7724 rettv->vval.v_number = 2;
7725 else
7726 rettv->vval.v_number = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007727}
7728
7729/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007730 * "highlightID(name)" function
7731 */
7732 static void
7733f_hlID(typval_T *argvars, typval_T *rettv)
7734{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02007735 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
7736 return;
7737
Bram Moolenaard155d7a2018-12-21 16:04:21 +01007738 rettv->vval.v_number = syn_name2id(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007739}
7740
7741/*
7742 * "highlight_exists()" function
7743 */
7744 static void
7745f_hlexists(typval_T *argvars, typval_T *rettv)
7746{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02007747 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
7748 return;
7749
Bram Moolenaard155d7a2018-12-21 16:04:21 +01007750 rettv->vval.v_number = highlight_exists(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007751}
7752
7753/*
7754 * "hostname()" function
7755 */
7756 static void
7757f_hostname(typval_T *argvars UNUSED, typval_T *rettv)
7758{
7759 char_u hostname[256];
7760
7761 mch_get_host_name(hostname, 256);
7762 rettv->v_type = VAR_STRING;
7763 rettv->vval.v_string = vim_strsave(hostname);
7764}
7765
7766/*
Ernie Raelc8e158b2024-07-09 18:39:52 +02007767 * "id()" function
7768 * Identity. Return address of item as a hex string, %p format.
7769 * Currently only valid for object/container types.
7770 * Return empty string if not an object.
7771 */
Zoltan Arpadffy10231ac2024-08-18 16:59:20 +02007772#ifdef VMS // VMS does not have defined uintptr_t
7773# if defined(HAVE_NO_LONG_LONG)
7774typedef unsigned int uintptr_t;
7775# else
7776typedef unsigned long long uintptr_t;
7777# endif
7778#endif // VMS
7779
John Marriottb3b2bee2024-07-14 11:12:51 +02007780 static void
Ernie Raelc8e158b2024-07-09 18:39:52 +02007781f_id(typval_T *argvars, typval_T *rettv)
7782{
Ernie Rael05124252024-07-11 22:10:45 +02007783 char numbuf[NUMBUFLEN];
7784 char *p = numbuf;
Ernie Raelc8e158b2024-07-09 18:39:52 +02007785
7786 switch (argvars[0].v_type)
7787 {
7788 case VAR_LIST:
7789 case VAR_DICT:
7790 case VAR_OBJECT:
7791 case VAR_JOB:
7792 case VAR_CHANNEL:
7793 case VAR_BLOB:
7794 // Assume pointer value in typval_T vval union at common location.
7795 if (argvars[0].vval.v_object != NULL)
Ernie Rael05124252024-07-11 22:10:45 +02007796 {
7797 // "v" gets the address as an integer
7798 uintptr_t v = (uintptr_t)(void *)argvars[0].vval.v_object;
7799 // Build a hex string from the item's address; it is in
7800 // reverse order. Ignore trailing zeros.
7801 for (; p < numbuf + sizeof(uintptr_t) * 2 && v != 0;
7802 ++p, v >>= 4)
7803 *p = "0123456789abcdef"[v & 0xf];
7804 }
Ernie Raelc8e158b2024-07-09 18:39:52 +02007805 default:
Ernie Rael05124252024-07-11 22:10:45 +02007806 break;
Ernie Raelc8e158b2024-07-09 18:39:52 +02007807 }
Ernie Rael05124252024-07-11 22:10:45 +02007808 *p = NUL;
Ernie Raelc8e158b2024-07-09 18:39:52 +02007809
7810 rettv->v_type = VAR_STRING;
Ernie Rael05124252024-07-11 22:10:45 +02007811 rettv->vval.v_string = vim_strsave((char_u *)numbuf);
Ernie Raelc8e158b2024-07-09 18:39:52 +02007812}
7813
7814/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007815 * "index()" function
7816 */
7817 static void
7818f_index(typval_T *argvars, typval_T *rettv)
7819{
7820 list_T *l;
7821 listitem_T *item;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007822 blob_T *b;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007823 long idx = 0;
7824 int ic = FALSE;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007825 int error = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007826
7827 rettv->vval.v_number = -1;
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02007828
7829 if (in_vim9script()
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02007830 && (check_for_list_or_blob_arg(argvars, 0) == FAIL
7831 || (argvars[0].v_type == VAR_BLOB
7832 && check_for_number_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02007833 || check_for_opt_number_arg(argvars, 2) == FAIL
7834 || (argvars[2].v_type != VAR_UNKNOWN
7835 && check_for_opt_bool_arg(argvars, 3) == FAIL)))
7836 return;
7837
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007838 if (argvars[0].v_type == VAR_BLOB)
7839 {
7840 typval_T tv;
7841 int start = 0;
7842
7843 if (argvars[2].v_type != VAR_UNKNOWN)
7844 {
7845 start = tv_get_number_chk(&argvars[2], &error);
7846 if (error)
7847 return;
7848 }
7849 b = argvars[0].vval.v_blob;
7850 if (b == NULL)
7851 return;
Bram Moolenaar05500ec2019-01-13 19:10:33 +01007852 if (start < 0)
7853 {
7854 start = blob_len(b) + start;
7855 if (start < 0)
7856 start = 0;
7857 }
7858
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007859 for (idx = start; idx < blob_len(b); ++idx)
7860 {
7861 tv.v_type = VAR_NUMBER;
7862 tv.vval.v_number = blob_get(b, idx);
Yinzuo Jiang7ccd1a22024-07-04 17:20:53 +02007863 if (tv_equal(&tv, &argvars[1], ic))
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007864 {
7865 rettv->vval.v_number = idx;
7866 return;
7867 }
7868 }
7869 return;
7870 }
7871 else if (argvars[0].v_type != VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007872 {
Bram Moolenaar460ae5d2022-01-01 14:19:49 +00007873 emsg(_(e_list_or_blob_required));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007874 return;
7875 }
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007876
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007877 l = argvars[0].vval.v_list;
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00007878 if (l == NULL)
7879 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007880
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00007881 CHECK_LIST_MATERIALIZE(l);
7882 item = l->lv_first;
7883 if (argvars[2].v_type != VAR_UNKNOWN)
7884 {
7885 // Start at specified item. Use the cached index that list_find()
7886 // sets, so that a negative number also works.
7887 item = list_find(l, (long)tv_get_number_chk(&argvars[2], &error));
7888 idx = l->lv_u.mat.lv_idx;
7889 if (argvars[3].v_type != VAR_UNKNOWN)
7890 ic = (int)tv_get_bool_chk(&argvars[3], &error);
7891 if (error)
7892 item = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007893 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00007894
7895 for ( ; item != NULL; item = item->li_next, ++idx)
Yinzuo Jiang7ccd1a22024-07-04 17:20:53 +02007896 if (tv_equal(&item->li_tv, &argvars[1], ic))
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00007897 {
7898 rettv->vval.v_number = idx;
7899 break;
7900 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007901}
7902
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01007903/*
7904 * Evaluate 'expr' with the v:key and v:val arguments and return the result.
7905 * The expression is expected to return a boolean value. The caller should set
7906 * the VV_KEY and VV_VAL vim variables before calling this function.
7907 */
7908 static int
7909indexof_eval_expr(typval_T *expr)
7910{
7911 typval_T argv[3];
7912 typval_T newtv;
7913 varnumber_T found;
7914 int error = FALSE;
7915
7916 argv[0] = *get_vim_var_tv(VV_KEY);
7917 argv[1] = *get_vim_var_tv(VV_VAL);
7918 newtv.v_type = VAR_UNKNOWN;
7919
zeertzjqad0c4422023-08-17 22:15:47 +02007920 if (eval_expr_typval(expr, FALSE, argv, 2, NULL, &newtv) == FAIL)
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01007921 return FALSE;
7922
7923 found = tv_get_bool_chk(&newtv, &error);
Yegappan Lakshmanan63acae12022-08-14 12:07:11 +01007924 clear_tv(&newtv);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01007925
7926 return error ? FALSE : found;
7927}
7928
7929/*
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01007930 * Evaluate 'expr' for each byte in the Blob 'b' starting with the byte at
7931 * 'startidx' and return the index of the byte where 'expr' is TRUE. Returns
7932 * -1 if 'expr' doesn't evaluate to TRUE for any of the bytes.
7933 */
7934 static int
7935indexof_blob(blob_T *b, long startidx, typval_T *expr)
7936{
7937 long idx = 0;
7938
7939 if (b == NULL)
7940 return -1;
7941
7942 if (startidx < 0)
7943 {
7944 // negative index: index from the last byte
7945 startidx = blob_len(b) + startidx;
7946 if (startidx < 0)
7947 startidx = 0;
7948 }
7949
7950 set_vim_var_type(VV_KEY, VAR_NUMBER);
7951 set_vim_var_type(VV_VAL, VAR_NUMBER);
7952
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02007953 int called_emsg_start = called_emsg;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01007954 for (idx = startidx; idx < blob_len(b); ++idx)
7955 {
7956 set_vim_var_nr(VV_KEY, idx);
7957 set_vim_var_nr(VV_VAL, blob_get(b, idx));
7958
7959 if (indexof_eval_expr(expr))
7960 return idx;
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02007961
7962 if (called_emsg != called_emsg_start)
7963 return -1;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01007964 }
7965
7966 return -1;
7967}
7968
7969/*
7970 * Evaluate 'expr' for each item in the List 'l' starting with the item at
7971 * 'startidx' and return the index of the item where 'expr' is TRUE. Returns
7972 * -1 if 'expr' doesn't evaluate to TRUE for any of the items.
7973 */
7974 static int
7975indexof_list(list_T *l, long startidx, typval_T *expr)
7976{
7977 listitem_T *item;
7978 long idx = 0;
Yegappan Lakshmanan63acae12022-08-14 12:07:11 +01007979 int found;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01007980
7981 if (l == NULL)
7982 return -1;
7983
7984 CHECK_LIST_MATERIALIZE(l);
7985
7986 if (startidx == 0)
7987 item = l->lv_first;
7988 else
7989 {
7990 // Start at specified item. Use the cached index that list_find()
7991 // sets, so that a negative number also works.
7992 item = list_find(l, startidx);
7993 if (item != NULL)
7994 idx = l->lv_u.mat.lv_idx;
7995 }
7996
7997 set_vim_var_type(VV_KEY, VAR_NUMBER);
7998
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02007999 int called_emsg_start = called_emsg;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008000 for ( ; item != NULL; item = item->li_next, ++idx)
8001 {
8002 set_vim_var_nr(VV_KEY, idx);
8003 copy_tv(&item->li_tv, get_vim_var_tv(VV_VAL));
8004
Yegappan Lakshmanan63acae12022-08-14 12:07:11 +01008005 found = indexof_eval_expr(expr);
8006 clear_tv(get_vim_var_tv(VV_VAL));
8007
8008 if (found)
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008009 return idx;
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008010
8011 if (called_emsg != called_emsg_start)
8012 return -1;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008013 }
8014
8015 return -1;
8016}
8017
8018/*
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008019 * "indexof()" function
8020 */
8021 static void
8022f_indexof(typval_T *argvars, typval_T *rettv)
8023{
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008024 long startidx = 0;
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008025 typval_T save_val;
8026 typval_T save_key;
8027 int save_did_emsg;
8028
8029 rettv->vval.v_number = -1;
8030
8031 if (check_for_list_or_blob_arg(argvars, 0) == FAIL
8032 || check_for_string_or_func_arg(argvars, 1) == FAIL
8033 || check_for_opt_dict_arg(argvars, 2) == FAIL)
8034 return;
8035
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008036 if ((argvars[1].v_type == VAR_STRING &&
8037 (argvars[1].vval.v_string == NULL
8038 || *argvars[1].vval.v_string == NUL))
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008039 || (argvars[1].v_type == VAR_FUNC
8040 && argvars[1].vval.v_partial == NULL))
8041 return;
8042
8043 if (argvars[2].v_type == VAR_DICT)
8044 startidx = dict_get_number_def(argvars[2].vval.v_dict, "startidx", 0);
8045
8046 prepare_vimvar(VV_VAL, &save_val);
8047 prepare_vimvar(VV_KEY, &save_key);
8048
8049 // We reset "did_emsg" to be able to detect whether an error occurred
8050 // during evaluation of the expression.
8051 save_did_emsg = did_emsg;
8052 did_emsg = FALSE;
8053
8054 if (argvars[0].v_type == VAR_BLOB)
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008055 rettv->vval.v_number = indexof_blob(argvars[0].vval.v_blob, startidx,
8056 &argvars[1]);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008057 else
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008058 rettv->vval.v_number = indexof_list(argvars[0].vval.v_list, startidx,
8059 &argvars[1]);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008060
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008061 restore_vimvar(VV_KEY, &save_key);
8062 restore_vimvar(VV_VAL, &save_val);
8063 did_emsg |= save_did_emsg;
8064}
8065
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008066static int inputsecret_flag = 0;
8067
8068/*
8069 * "input()" function
8070 * Also handles inputsecret() when inputsecret is set.
8071 */
8072 static void
8073f_input(typval_T *argvars, typval_T *rettv)
8074{
8075 get_user_input(argvars, rettv, FALSE, inputsecret_flag);
8076}
8077
8078/*
8079 * "inputdialog()" function
8080 */
8081 static void
8082f_inputdialog(typval_T *argvars, typval_T *rettv)
8083{
8084#if defined(FEAT_GUI_TEXTDIALOG)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008085 // Use a GUI dialog if the GUI is running and 'c' is not in 'guioptions'
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008086 if (gui.in_use && vim_strchr(p_go, GO_CONDIALOG) == NULL)
8087 {
8088 char_u *message;
8089 char_u buf[NUMBUFLEN];
8090 char_u *defstr = (char_u *)"";
8091
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008092 if (in_vim9script()
8093 && (check_for_string_arg(argvars, 0) == FAIL
8094 || check_for_opt_string_arg(argvars, 1) == FAIL
8095 || (argvars[1].v_type != VAR_UNKNOWN
8096 && check_for_opt_string_arg(argvars, 2) == FAIL)))
8097 return;
8098
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008099 message = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008100 if (argvars[1].v_type != VAR_UNKNOWN
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008101 && (defstr = tv_get_string_buf_chk(&argvars[1], buf)) != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008102 vim_strncpy(IObuff, defstr, IOSIZE - 1);
8103 else
8104 IObuff[0] = NUL;
8105 if (message != NULL && defstr != NULL
8106 && do_dialog(VIM_QUESTION, NULL, message,
8107 (char_u *)_("&OK\n&Cancel"), 1, IObuff, FALSE) == 1)
8108 rettv->vval.v_string = vim_strsave(IObuff);
8109 else
8110 {
8111 if (message != NULL && defstr != NULL
8112 && argvars[1].v_type != VAR_UNKNOWN
8113 && argvars[2].v_type != VAR_UNKNOWN)
8114 rettv->vval.v_string = vim_strsave(
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008115 tv_get_string_buf(&argvars[2], buf));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008116 else
8117 rettv->vval.v_string = NULL;
8118 }
8119 rettv->v_type = VAR_STRING;
8120 }
8121 else
8122#endif
8123 get_user_input(argvars, rettv, TRUE, inputsecret_flag);
8124}
8125
8126/*
8127 * "inputlist()" function
8128 */
8129 static void
8130f_inputlist(typval_T *argvars, typval_T *rettv)
8131{
Bram Moolenaar50985eb2020-01-27 22:09:39 +01008132 list_T *l;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008133 listitem_T *li;
8134 int selected;
8135 int mouse_used;
8136
8137#ifdef NO_CONSOLE_INPUT
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008138 // While starting up, there is no place to enter text. When running tests
8139 // with --not-a-term we assume feedkeys() will be used.
Bram Moolenaar91d348a2017-07-29 20:16:03 +02008140 if (no_console_input() && !is_not_a_term())
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008141 return;
8142#endif
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008143 if (in_vim9script() && check_for_list_arg(argvars, 0) == FAIL)
8144 return;
8145
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008146 if (argvars[0].v_type != VAR_LIST || argvars[0].vval.v_list == NULL)
8147 {
Bram Moolenaar3a846e62022-01-01 16:21:00 +00008148 semsg(_(e_argument_of_str_must_be_list), "inputlist()");
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008149 return;
8150 }
8151
8152 msg_start();
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008153 msg_row = Rows - 1; // for when 'cmdheight' > 1
8154 lines_left = Rows; // avoid more prompt
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008155 msg_scroll = TRUE;
8156 msg_clr_eos();
8157
Bram Moolenaar50985eb2020-01-27 22:09:39 +01008158 l = argvars[0].vval.v_list;
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02008159 CHECK_LIST_MATERIALIZE(l);
Bram Moolenaar00d253e2020-04-06 22:13:01 +02008160 FOR_ALL_LIST_ITEMS(l, li)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008161 {
Bram Moolenaar32526b32019-01-19 17:43:09 +01008162 msg_puts((char *)tv_get_string(&li->li_tv));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008163 msg_putchar('\n');
8164 }
8165
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008166 // Ask for choice.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008167 selected = prompt_for_number(&mouse_used);
8168 if (mouse_used)
8169 selected -= lines_left;
8170
8171 rettv->vval.v_number = selected;
8172}
8173
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008174static garray_T ga_userinput = {0, 0, sizeof(tasave_T), 4, NULL};
8175
8176/*
8177 * "inputrestore()" function
8178 */
8179 static void
8180f_inputrestore(typval_T *argvars UNUSED, typval_T *rettv)
8181{
8182 if (ga_userinput.ga_len > 0)
8183 {
8184 --ga_userinput.ga_len;
8185 restore_typeahead((tasave_T *)(ga_userinput.ga_data)
Bram Moolenaarc41badb2021-06-07 22:04:52 +02008186 + ga_userinput.ga_len, TRUE);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008187 // default return is zero == OK
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008188 }
8189 else if (p_verbose > 1)
8190 {
Bram Moolenaar32526b32019-01-19 17:43:09 +01008191 verb_msg(_("called inputrestore() more often than inputsave()"));
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008192 rettv->vval.v_number = 1; // Failed
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008193 }
8194}
8195
8196/*
8197 * "inputsave()" function
8198 */
8199 static void
8200f_inputsave(typval_T *argvars UNUSED, typval_T *rettv)
8201{
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008202 // Add an entry to the stack of typeahead storage.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008203 if (ga_grow(&ga_userinput, 1) == OK)
8204 {
8205 save_typeahead((tasave_T *)(ga_userinput.ga_data)
8206 + ga_userinput.ga_len);
8207 ++ga_userinput.ga_len;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008208 // default return is zero == OK
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008209 }
8210 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008211 rettv->vval.v_number = 1; // Failed
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008212}
8213
8214/*
8215 * "inputsecret()" function
8216 */
8217 static void
8218f_inputsecret(typval_T *argvars, typval_T *rettv)
8219{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008220 if (in_vim9script()
8221 && (check_for_string_arg(argvars, 0) == FAIL
8222 || check_for_opt_string_arg(argvars, 1) == FAIL))
8223 return;
8224
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008225 ++cmdline_star;
8226 ++inputsecret_flag;
8227 f_input(argvars, rettv);
8228 --cmdline_star;
8229 --inputsecret_flag;
8230}
8231
8232/*
Bram Moolenaar67a2deb2019-11-25 00:05:32 +01008233 * "interrupt()" function
8234 */
8235 static void
8236f_interrupt(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
8237{
8238 got_int = TRUE;
8239}
8240
8241/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008242 * "invert(expr)" function
8243 */
8244 static void
8245f_invert(typval_T *argvars, typval_T *rettv)
8246{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008247 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
8248 return;
8249
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008250 rettv->vval.v_number = ~tv_get_number_chk(&argvars[0], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008251}
8252
8253/*
Ernie Rael4c8da022023-10-11 21:35:11 +02008254 * Free resources in lval_root allocated by fill_exec_lval_root().
8255 */
8256 static void
8257free_lval_root(lval_root_T *root)
8258{
8259 if (root->lr_tv != NULL)
8260 free_tv(root->lr_tv);
8261 class_unref(root->lr_cl_exec);
8262 root->lr_tv = NULL;
8263 root->lr_cl_exec = NULL;
8264}
8265
8266/*
8267 * This is used if executing in a method, the argument string is a
Ernie Rael0f058d12023-10-14 11:25:04 +02008268 * variable/item expr/reference. It may start with a potential class/object
8269 * variable.
Ernie Rael4c8da022023-10-11 21:35:11 +02008270 *
Ernie Rael0f058d12023-10-14 11:25:04 +02008271 * Adjust "root" as needed; lr_tv may be changed or freed.
Ernie Rael4c8da022023-10-11 21:35:11 +02008272 *
8273 * Always returns OK.
8274 * Free resources and return FAIL if the root should not be used. Otherwise OK.
8275 */
8276
8277 static int
Ernie Rael0f058d12023-10-14 11:25:04 +02008278fix_variable_reference_lval_root(lval_root_T *root, char_u *name)
Ernie Rael4c8da022023-10-11 21:35:11 +02008279{
Ernie Rael4c8da022023-10-11 21:35:11 +02008280
Ernie Rael0f058d12023-10-14 11:25:04 +02008281 // Check if lr_tv is the name of an object/class reference: name start with
8282 // "this" or name is class variable. Clear lr_tv if neither.
8283 int found_member = FALSE;
Ernie Rael4c8da022023-10-11 21:35:11 +02008284 if (root->lr_tv->v_type == VAR_OBJECT)
8285 {
Ernie Rael0f058d12023-10-14 11:25:04 +02008286 if (STRNCMP("this.", name, 5) == 0 ||STRCMP("this", name) == 0)
8287 found_member = TRUE;
Ernie Rael4c8da022023-10-11 21:35:11 +02008288 }
Ernie Rael0f058d12023-10-14 11:25:04 +02008289 if (!found_member) // not object member, try class member
Ernie Rael4c8da022023-10-11 21:35:11 +02008290 {
8291 // Explicitly check if the name is a class member.
8292 // If it's not then do nothing.
Ernie Rael0f058d12023-10-14 11:25:04 +02008293 char_u *end;
Ernie Rael4c8da022023-10-11 21:35:11 +02008294 for (end = name; ASCII_ISALNUM(*end) || *end == '_'; ++end)
8295 ;
Ernie Rael0f058d12023-10-14 11:25:04 +02008296 int idx = class_member_idx(root->lr_cl_exec, name, end - name);
8297 if (idx >= 0)
Ernie Rael4c8da022023-10-11 21:35:11 +02008298 {
Ernie Rael0f058d12023-10-14 11:25:04 +02008299 // A class variable, replace lr_tv with it
8300 clear_tv(root->lr_tv);
8301 copy_tv(&root->lr_cl_exec->class_members_tv[idx], root->lr_tv);
8302 found_member = TRUE;
Ernie Rael4c8da022023-10-11 21:35:11 +02008303 }
8304 }
Ernie Rael0f058d12023-10-14 11:25:04 +02008305 if (!found_member)
Ernie Rael4c8da022023-10-11 21:35:11 +02008306 {
8307 free_tv(root->lr_tv);
8308 root->lr_tv = NULL; // Not a member variable
8309 }
Ernie Rael4c8da022023-10-11 21:35:11 +02008310 // If FAIL, then must free_lval_root(root);
8311 return OK;
8312}
8313
8314/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008315 * "islocked()" function
8316 */
8317 static void
8318f_islocked(typval_T *argvars, typval_T *rettv)
8319{
8320 lval_T lv;
8321 char_u *end;
8322 dictitem_T *di;
8323
8324 rettv->vval.v_number = -1;
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02008325
8326 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
8327 return;
8328
Ernie Rael4c8da022023-10-11 21:35:11 +02008329 char_u *name = tv_get_string(&argvars[0]);
8330#ifdef LOG_LOCKVAR
8331 ch_log(NULL, "LKVAR: f_islocked(): name: %s", name);
8332#endif
8333
8334 lval_root_T aroot; // fully initialized in fill_exec_lval_root
8335 lval_root_T *root = NULL;
8336
8337 // Set up lval_root if executing in a method.
8338 if (fill_exec_lval_root(&aroot) == OK)
8339 {
8340 // Almost always produces a valid lval_root since lr_cl_exec is used
8341 // for access verification, lr_tv may be set to NULL.
Ernie Rael0f058d12023-10-14 11:25:04 +02008342 if (fix_variable_reference_lval_root(&aroot, name) == OK)
Ernie Rael4c8da022023-10-11 21:35:11 +02008343 root = &aroot;
Ernie Rael4c8da022023-10-11 21:35:11 +02008344 }
8345
8346 lval_root_T *lval_root_save = lval_root;
8347 lval_root = root;
8348 end = get_lval(name, NULL, &lv, FALSE, FALSE,
Bram Moolenaarbd77aa92021-08-12 17:06:05 +02008349 GLV_NO_AUTOLOAD | GLV_READ_ONLY | GLV_NO_DECL,
8350 FNE_CHECK_START);
Ernie Rael4c8da022023-10-11 21:35:11 +02008351 lval_root = lval_root_save;
8352
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008353 if (end != NULL && lv.ll_name != NULL)
8354 {
8355 if (*end != NUL)
Bram Moolenaar1840a7b2021-07-13 20:32:29 +02008356 {
8357 semsg(_(lv.ll_name == lv.ll_name_end
Bram Moolenaar0bd663a2022-01-22 10:24:47 +00008358 ? e_invalid_argument_str : e_trailing_characters_str), end);
Bram Moolenaar1840a7b2021-07-13 20:32:29 +02008359 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008360 else
8361 {
8362 if (lv.ll_tv == NULL)
8363 {
Bram Moolenaar79518e22017-02-17 16:31:35 +01008364 di = find_var(lv.ll_name, NULL, TRUE);
8365 if (di != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008366 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008367 // Consider a variable locked when:
8368 // 1. the variable itself is locked
8369 // 2. the value of the variable is locked.
8370 // 3. the List or Dict value is locked.
Bram Moolenaar79518e22017-02-17 16:31:35 +01008371 rettv->vval.v_number = ((di->di_flags & DI_FLAGS_LOCK)
8372 || tv_islocked(&di->di_tv));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008373 }
8374 }
Ernie Rael4c8da022023-10-11 21:35:11 +02008375 else if (lv.ll_is_root)
8376 {
8377 rettv->vval.v_number = tv_islocked(lv.ll_tv);
8378 }
Ernie Rael9771b2a2023-10-07 22:05:40 +02008379 else if (lv.ll_object != NULL)
8380 {
8381 typval_T *tv = ((typval_T *)(lv.ll_object + 1)) + lv.ll_oi;
8382 rettv->vval.v_number = tv_islocked(tv);
8383#ifdef LOG_LOCKVAR
8384 ch_log(NULL, "LKVAR: f_islocked(): name %s (obj)", lv.ll_name);
8385#endif
8386 }
8387 else if (lv.ll_class != NULL)
8388 {
8389 typval_T *tv = &lv.ll_class->class_members_tv[lv.ll_oi];
8390 rettv->vval.v_number = tv_islocked(tv);
8391#ifdef LOG_LOCKVAR
8392 ch_log(NULL, "LKVAR: f_islocked(): name %s (cl)", lv.ll_name);
8393#endif
8394 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008395 else if (lv.ll_range)
Bram Moolenaar677658a2022-01-05 16:09:06 +00008396 emsg(_(e_range_not_allowed));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008397 else if (lv.ll_newkey != NULL)
Bram Moolenaara9fa8c52023-01-02 18:10:04 +00008398 semsg(_(e_key_not_present_in_dictionary_str), lv.ll_newkey);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008399 else if (lv.ll_list != NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008400 // List item.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008401 rettv->vval.v_number = tv_islocked(&lv.ll_li->li_tv);
8402 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008403 // Dictionary item.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008404 rettv->vval.v_number = tv_islocked(&lv.ll_di->di_tv);
8405 }
8406 }
8407
Ernie Rael4c8da022023-10-11 21:35:11 +02008408 if (root != NULL)
8409 free_lval_root(root);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008410 clear_lval(&lv);
8411}
8412
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008413/*
zeertzjqcdc83932022-09-12 13:38:41 +01008414 * "keytrans()" function
8415 */
8416 static void
8417f_keytrans(typval_T *argvars, typval_T *rettv)
8418{
8419 char_u *escaped;
8420
8421 rettv->v_type = VAR_STRING;
8422 if (check_for_string_arg(argvars, 0) == FAIL
8423 || argvars[0].vval.v_string == NULL)
8424 return;
8425 // Need to escape K_SPECIAL and CSI for mb_unescape().
8426 escaped = vim_strsave_escape_csi(argvars[0].vval.v_string);
8427 rettv->vval.v_string = str2special_save(escaped, TRUE, TRUE);
8428 vim_free(escaped);
8429}
8430
8431/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008432 * "last_buffer_nr()" function.
8433 */
8434 static void
8435f_last_buffer_nr(typval_T *argvars UNUSED, typval_T *rettv)
8436{
8437 int n = 0;
8438 buf_T *buf;
8439
Bram Moolenaar29323592016-07-24 22:04:11 +02008440 FOR_ALL_BUFFERS(buf)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008441 if (n < buf->b_fnum)
8442 n = buf->b_fnum;
8443
8444 rettv->vval.v_number = n;
8445}
8446
8447/*
8448 * "len()" function
8449 */
LemonBoy58f331a2022-04-02 21:59:06 +01008450 void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008451f_len(typval_T *argvars, typval_T *rettv)
8452{
8453 switch (argvars[0].v_type)
8454 {
8455 case VAR_STRING:
8456 case VAR_NUMBER:
8457 rettv->vval.v_number = (varnumber_T)STRLEN(
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008458 tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008459 break;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008460 case VAR_BLOB:
8461 rettv->vval.v_number = blob_len(argvars[0].vval.v_blob);
8462 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008463 case VAR_LIST:
8464 rettv->vval.v_number = list_len(argvars[0].vval.v_list);
8465 break;
8466 case VAR_DICT:
8467 rettv->vval.v_number = dict_len(argvars[0].vval.v_dict);
8468 break;
Yegappan Lakshmanand3eae7b2024-03-03 16:26:58 +01008469 case VAR_OBJECT:
8470 rettv->vval.v_number = object_len(argvars[0].vval.v_object);
8471 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008472 case VAR_UNKNOWN:
Bram Moolenaar4c683752020-04-05 21:38:23 +02008473 case VAR_ANY:
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01008474 case VAR_VOID:
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01008475 case VAR_BOOL:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008476 case VAR_SPECIAL:
8477 case VAR_FLOAT:
8478 case VAR_FUNC:
8479 case VAR_PARTIAL:
8480 case VAR_JOB:
8481 case VAR_CHANNEL:
Bram Moolenaarf18332f2021-05-07 17:55:55 +02008482 case VAR_INSTR:
Bram Moolenaar00b28d62022-12-08 15:32:33 +00008483 case VAR_CLASS:
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +02008484 case VAR_TYPEALIAS:
Bram Moolenaara6f79292022-01-04 21:30:47 +00008485 emsg(_(e_invalid_type_for_len));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008486 break;
8487 }
8488}
8489
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008490 static void
Bram Moolenaar6d721c72017-01-17 16:56:28 +01008491libcall_common(typval_T *argvars UNUSED, typval_T *rettv, int type)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008492{
8493#ifdef FEAT_LIBCALL
8494 char_u *string_in;
8495 char_u **string_result;
8496 int nr_result;
8497#endif
8498
8499 rettv->v_type = type;
8500 if (type != VAR_NUMBER)
8501 rettv->vval.v_string = NULL;
8502
8503 if (check_restricted() || check_secure())
8504 return;
8505
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02008506 if (in_vim9script()
8507 && (check_for_string_arg(argvars, 0) == FAIL
8508 || check_for_string_arg(argvars, 1) == FAIL
8509 || check_for_string_or_number_arg(argvars, 2) == FAIL))
8510 return;
8511
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008512#ifdef FEAT_LIBCALL
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008513 // The first two args must be strings, otherwise it's meaningless
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008514 if (argvars[0].v_type == VAR_STRING && argvars[1].v_type == VAR_STRING)
8515 {
8516 string_in = NULL;
8517 if (argvars[2].v_type == VAR_STRING)
8518 string_in = argvars[2].vval.v_string;
8519 if (type == VAR_NUMBER)
Bram Moolenaar87e15872021-09-02 19:53:07 +02008520 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008521 string_result = NULL;
Bram Moolenaar87e15872021-09-02 19:53:07 +02008522 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008523 else
Bram Moolenaar87e15872021-09-02 19:53:07 +02008524 {
8525 rettv->vval.v_string = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008526 string_result = &rettv->vval.v_string;
Bram Moolenaar87e15872021-09-02 19:53:07 +02008527 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008528 if (mch_libcall(argvars[0].vval.v_string,
8529 argvars[1].vval.v_string,
8530 string_in,
8531 argvars[2].vval.v_number,
8532 string_result,
8533 &nr_result) == OK
8534 && type == VAR_NUMBER)
8535 rettv->vval.v_number = nr_result;
8536 }
8537#endif
8538}
8539
8540/*
8541 * "libcall()" function
8542 */
8543 static void
8544f_libcall(typval_T *argvars, typval_T *rettv)
8545{
8546 libcall_common(argvars, rettv, VAR_STRING);
8547}
8548
8549/*
8550 * "libcallnr()" function
8551 */
8552 static void
8553f_libcallnr(typval_T *argvars, typval_T *rettv)
8554{
8555 libcall_common(argvars, rettv, VAR_NUMBER);
8556}
8557
8558/*
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008559 * "line(string, [winid])" function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008560 */
8561 static void
8562f_line(typval_T *argvars, typval_T *rettv)
8563{
8564 linenr_T lnum = 0;
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008565 pos_T *fp = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008566 int fnum;
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008567 int id;
8568 tabpage_T *tp;
8569 win_T *wp;
Bram Moolenaar18f47402022-01-06 13:24:51 +00008570 switchwin_T switchwin;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008571
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02008572 if (in_vim9script()
8573 && (check_for_string_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008574 || check_for_opt_number_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02008575 return;
8576
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008577 if (argvars[1].v_type != VAR_UNKNOWN)
8578 {
8579 // use window specified in the second argument
8580 id = (int)tv_get_number(&argvars[1]);
8581 wp = win_id2wp_tp(id, &tp);
8582 if (wp != NULL && tp != NULL)
8583 {
Bram Moolenaar18f47402022-01-06 13:24:51 +00008584 if (switch_win_noblock(&switchwin, wp, tp, TRUE) == OK)
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 // in diff mode, prevent that the window scrolls
8588 // and keep the topline
8589 if (curwin->w_p_diff && switchwin.sw_curwin->w_p_diff)
8590 skip_update_topline = TRUE;
John Marriott69f85c62024-10-31 10:53:43 +01008591#endif
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008592 check_cursor();
Bram Moolenaar6f02b002021-01-10 20:22:54 +01008593 fp = var2fpos(&argvars[0], TRUE, &fnum, FALSE);
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008594 }
John Marriott69f85c62024-10-31 10:53:43 +01008595#ifdef FEAT_DIFF
Christian Brabandt05a40e02024-10-29 20:29:04 +01008596 if (curwin->w_p_diff && switchwin.sw_curwin->w_p_diff)
8597 skip_update_topline = FALSE;
John Marriott69f85c62024-10-31 10:53:43 +01008598#endif
Bram Moolenaar18f47402022-01-06 13:24:51 +00008599 restore_win_noblock(&switchwin, TRUE);
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008600 }
8601 }
8602 else
8603 // use current window
Bram Moolenaar6f02b002021-01-10 20:22:54 +01008604 fp = var2fpos(&argvars[0], TRUE, &fnum, FALSE);
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008605
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008606 if (fp != NULL)
8607 lnum = fp->lnum;
8608 rettv->vval.v_number = lnum;
8609}
8610
8611/*
8612 * "line2byte(lnum)" function
8613 */
8614 static void
8615f_line2byte(typval_T *argvars UNUSED, typval_T *rettv)
8616{
8617#ifndef FEAT_BYTEOFF
8618 rettv->vval.v_number = -1;
8619#else
8620 linenr_T lnum;
8621
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008622 if (in_vim9script() && check_for_lnum_arg(argvars, 0) == FAIL)
8623 return;
8624
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008625 lnum = tv_get_lnum(argvars);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008626 if (lnum < 1 || lnum > curbuf->b_ml.ml_line_count + 1)
8627 rettv->vval.v_number = -1;
8628 else
8629 rettv->vval.v_number = ml_find_line_or_offset(curbuf, lnum, NULL);
8630 if (rettv->vval.v_number >= 0)
8631 ++rettv->vval.v_number;
8632#endif
8633}
8634
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008635#ifdef FEAT_LUA
8636/*
8637 * "luaeval()" function
8638 */
8639 static void
8640f_luaeval(typval_T *argvars, typval_T *rettv)
8641{
8642 char_u *str;
8643 char_u buf[NUMBUFLEN];
8644
Bram Moolenaar8c62a082019-02-08 14:34:10 +01008645 if (check_restricted() || check_secure())
8646 return;
8647
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02008648 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
8649 return;
8650
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008651 str = tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008652 do_luaeval(str, argvars + 1, rettv);
8653}
8654#endif
8655
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008656typedef enum
8657{
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008658 MATCH_END, // matchend()
8659 MATCH_MATCH, // match()
8660 MATCH_STR, // matchstr()
8661 MATCH_LIST, // matchlist()
8662 MATCH_POS // matchstrpos()
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008663} matchtype_T;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008664
8665 static void
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008666find_some_match(typval_T *argvars, typval_T *rettv, matchtype_T type)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008667{
8668 char_u *str = NULL;
8669 long len = 0;
8670 char_u *expr = NULL;
8671 char_u *pat;
8672 regmatch_T regmatch;
8673 char_u patbuf[NUMBUFLEN];
8674 char_u strbuf[NUMBUFLEN];
8675 char_u *save_cpo;
8676 long start = 0;
8677 long nth = 1;
8678 colnr_T startcol = 0;
8679 int match = 0;
8680 list_T *l = NULL;
8681 listitem_T *li = NULL;
8682 long idx = 0;
8683 char_u *tofree = NULL;
8684
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008685 // Make 'cpoptions' empty, the 'l' flag should not be used here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008686 save_cpo = p_cpo;
Bram Moolenaare5a2dc82021-01-03 19:52:05 +01008687 p_cpo = empty_option;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008688
8689 rettv->vval.v_number = -1;
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008690 if (type == MATCH_LIST || type == MATCH_POS)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008691 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008692 // type MATCH_LIST: return empty list when there are no matches.
8693 // type MATCH_POS: return ["", -1, -1, -1]
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008694 if (rettv_list_alloc(rettv) == FAIL)
8695 goto theend;
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008696 if (type == MATCH_POS
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008697 && (list_append_string(rettv->vval.v_list,
8698 (char_u *)"", 0) == FAIL
8699 || list_append_number(rettv->vval.v_list,
8700 (varnumber_T)-1) == FAIL
8701 || list_append_number(rettv->vval.v_list,
8702 (varnumber_T)-1) == FAIL
8703 || list_append_number(rettv->vval.v_list,
8704 (varnumber_T)-1) == FAIL))
8705 {
8706 list_free(rettv->vval.v_list);
8707 rettv->vval.v_list = NULL;
8708 goto theend;
8709 }
8710 }
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008711 else if (type == MATCH_STR)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008712 {
8713 rettv->v_type = VAR_STRING;
8714 rettv->vval.v_string = NULL;
8715 }
8716
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02008717 if (in_vim9script()
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008718 && (check_for_string_or_list_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008719 || check_for_string_arg(argvars, 1) == FAIL
8720 || check_for_opt_number_arg(argvars, 2) == FAIL
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02008721 || (argvars[2].v_type != VAR_UNKNOWN
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008722 && check_for_opt_number_arg(argvars, 3) == FAIL)))
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02008723 goto theend;
8724
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008725 if (argvars[0].v_type == VAR_LIST)
8726 {
8727 if ((l = argvars[0].vval.v_list) == NULL)
8728 goto theend;
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02008729 CHECK_LIST_MATERIALIZE(l);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008730 li = l->lv_first;
8731 }
8732 else
8733 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008734 expr = str = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008735 len = (long)STRLEN(str);
8736 }
8737
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008738 pat = tv_get_string_buf_chk(&argvars[1], patbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008739 if (pat == NULL)
8740 goto theend;
8741
8742 if (argvars[2].v_type != VAR_UNKNOWN)
8743 {
8744 int error = FALSE;
8745
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008746 start = (long)tv_get_number_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008747 if (error)
8748 goto theend;
8749 if (l != NULL)
8750 {
8751 li = list_find(l, start);
8752 if (li == NULL)
8753 goto theend;
Bram Moolenaar0ff6aad2020-01-29 21:27:21 +01008754 idx = l->lv_u.mat.lv_idx; // use the cached index
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008755 }
8756 else
8757 {
8758 if (start < 0)
8759 start = 0;
8760 if (start > len)
8761 goto theend;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008762 // When "count" argument is there ignore matches before "start",
8763 // otherwise skip part of the string. Differs when pattern is "^"
8764 // or "\<".
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008765 if (argvars[3].v_type != VAR_UNKNOWN)
8766 startcol = start;
8767 else
8768 {
8769 str += start;
8770 len -= start;
8771 }
8772 }
8773
8774 if (argvars[3].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008775 nth = (long)tv_get_number_chk(&argvars[3], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008776 if (error)
8777 goto theend;
8778 }
8779
8780 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
8781 if (regmatch.regprog != NULL)
8782 {
8783 regmatch.rm_ic = p_ic;
8784
8785 for (;;)
8786 {
8787 if (l != NULL)
8788 {
8789 if (li == NULL)
8790 {
8791 match = FALSE;
8792 break;
8793 }
8794 vim_free(tofree);
8795 expr = str = echo_string(&li->li_tv, &tofree, strbuf, 0);
8796 if (str == NULL)
8797 break;
8798 }
8799
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +00008800 match = vim_regexec_nl(&regmatch, str, startcol);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008801
8802 if (match && --nth <= 0)
8803 break;
8804 if (l == NULL && !match)
8805 break;
8806
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008807 // Advance to just after the match.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008808 if (l != NULL)
8809 {
8810 li = li->li_next;
8811 ++idx;
8812 }
8813 else
8814 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008815 startcol = (colnr_T)(regmatch.startp[0]
8816 + (*mb_ptr2len)(regmatch.startp[0]) - str);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008817 if (startcol > (colnr_T)len
8818 || str + startcol <= regmatch.startp[0])
8819 {
8820 match = FALSE;
8821 break;
8822 }
8823 }
8824 }
8825
8826 if (match)
8827 {
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008828 if (type == MATCH_POS)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008829 {
8830 listitem_T *li1 = rettv->vval.v_list->lv_first;
8831 listitem_T *li2 = li1->li_next;
8832 listitem_T *li3 = li2->li_next;
8833 listitem_T *li4 = li3->li_next;
8834
8835 vim_free(li1->li_tv.vval.v_string);
8836 li1->li_tv.vval.v_string = vim_strnsave(regmatch.startp[0],
Bram Moolenaardf44a272020-06-07 20:49:05 +02008837 regmatch.endp[0] - regmatch.startp[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008838 li3->li_tv.vval.v_number =
8839 (varnumber_T)(regmatch.startp[0] - expr);
8840 li4->li_tv.vval.v_number =
8841 (varnumber_T)(regmatch.endp[0] - expr);
8842 if (l != NULL)
8843 li2->li_tv.vval.v_number = (varnumber_T)idx;
8844 }
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008845 else if (type == MATCH_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008846 {
8847 int i;
8848
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008849 // return list with matched string and submatches
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008850 for (i = 0; i < NSUBEXP; ++i)
8851 {
8852 if (regmatch.endp[i] == NULL)
8853 {
8854 if (list_append_string(rettv->vval.v_list,
8855 (char_u *)"", 0) == FAIL)
8856 break;
8857 }
8858 else if (list_append_string(rettv->vval.v_list,
8859 regmatch.startp[i],
8860 (int)(regmatch.endp[i] - regmatch.startp[i]))
8861 == FAIL)
8862 break;
8863 }
8864 }
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008865 else if (type == MATCH_STR)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008866 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008867 // return matched string
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008868 if (l != NULL)
8869 copy_tv(&li->li_tv, rettv);
8870 else
8871 rettv->vval.v_string = vim_strnsave(regmatch.startp[0],
Bram Moolenaardf44a272020-06-07 20:49:05 +02008872 regmatch.endp[0] - regmatch.startp[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008873 }
8874 else if (l != NULL)
8875 rettv->vval.v_number = idx;
8876 else
8877 {
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008878 if (type != MATCH_END)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008879 rettv->vval.v_number =
8880 (varnumber_T)(regmatch.startp[0] - str);
8881 else
8882 rettv->vval.v_number =
8883 (varnumber_T)(regmatch.endp[0] - str);
8884 rettv->vval.v_number += (varnumber_T)(str - expr);
8885 }
8886 }
8887 vim_regfree(regmatch.regprog);
8888 }
8889
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008890theend:
8891 if (type == MATCH_POS && l == NULL && rettv->vval.v_list != NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008892 // matchstrpos() without a list: drop the second item.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008893 listitem_remove(rettv->vval.v_list,
8894 rettv->vval.v_list->lv_first->li_next);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008895 vim_free(tofree);
8896 p_cpo = save_cpo;
8897}
8898
8899/*
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01008900 * Return all the matches in string "str" for pattern "rmp".
8901 * The matches are returned in the List "mlist".
8902 * If "submatches" is TRUE, then submatch information is also returned.
8903 * "matchbuf" is TRUE when called for matchbufline().
8904 */
8905 static int
8906get_matches_in_str(
8907 char_u *str,
8908 regmatch_T *rmp,
8909 list_T *mlist,
8910 int idx,
8911 int submatches,
8912 int matchbuf)
8913{
8914 long len = (long)STRLEN(str);
8915 int match = 0;
8916 colnr_T startidx = 0;
8917
8918 for (;;)
8919 {
8920 match = vim_regexec_nl(rmp, str, startidx);
8921 if (!match)
8922 break;
8923
8924 dict_T *d = dict_alloc();
8925 if (d == NULL)
8926 return FAIL;
8927 if (list_append_dict(mlist, d) == FAIL)
8928 return FAIL;;
8929
8930 if (dict_add_number(d, matchbuf ? "lnum" : "idx", idx) == FAIL)
8931 return FAIL;
8932
8933 if (dict_add_number(d, "byteidx",
8934 (colnr_T)(rmp->startp[0] - str)) == FAIL)
8935 return FAIL;
8936
8937 if (dict_add_string_len(d, "text", rmp->startp[0],
8938 (int)(rmp->endp[0] - rmp->startp[0])) == FAIL)
8939 return FAIL;
8940
8941 if (submatches)
8942 {
8943 list_T *sml = list_alloc();
8944 if (sml == NULL)
8945 return FAIL;
8946
8947 if (dict_add_list(d, "submatches", sml) == FAIL)
8948 return FAIL;
8949
8950 // return a list with the submatches
8951 for (int i = 1; i < NSUBEXP; ++i)
8952 {
8953 if (rmp->endp[i] == NULL)
8954 {
8955 if (list_append_string(sml, (char_u *)"", 0) == FAIL)
8956 return FAIL;
8957 }
8958 else if (list_append_string(sml, rmp->startp[i],
8959 (int)(rmp->endp[i] - rmp->startp[i])) == FAIL)
8960 return FAIL;
8961 }
8962 }
8963 startidx = (colnr_T)(rmp->endp[0] - str);
8964 if (startidx >= (colnr_T)len || str + startidx <= rmp->startp[0])
8965 break;
8966 }
8967
8968 return OK;
8969}
8970
8971/*
8972 * "matchbufline()" function
8973 */
8974 static void
8975f_matchbufline(typval_T *argvars, typval_T *rettv)
8976{
8977 list_T *retlist = NULL;
8978 char_u *save_cpo;
8979 char_u patbuf[NUMBUFLEN];
8980 regmatch_T regmatch;
8981
8982 rettv->vval.v_number = -1;
8983 if (rettv_list_alloc(rettv) != OK)
8984 return;
8985 retlist = rettv->vval.v_list;
8986
8987 if (check_for_buffer_arg(argvars, 0) == FAIL
8988 || check_for_string_arg(argvars, 1) == FAIL
8989 || check_for_lnum_arg(argvars, 2) == FAIL
8990 || check_for_lnum_arg(argvars, 3) == FAIL
8991 || check_for_opt_dict_arg(argvars, 4) == FAIL)
8992 return;
8993
8994 int prev_did_emsg = did_emsg;
8995 buf_T *buf = tv_get_buf(&argvars[0], FALSE);
8996 if (buf == NULL)
8997 {
8998 if (did_emsg == prev_did_emsg)
8999 semsg(_(e_invalid_buffer_name_str), tv_get_string(&argvars[0]));
9000 return;
9001 }
9002 if (buf->b_ml.ml_mfp == NULL)
9003 {
9004 emsg(_(e_buffer_is_not_loaded));
9005 return;
9006 }
9007
9008 char_u *pat = tv_get_string_buf(&argvars[1], patbuf);
9009
9010 int did_emsg_before = did_emsg;
9011 linenr_T slnum = tv_get_lnum_buf(&argvars[2], buf);
9012 if (did_emsg > did_emsg_before)
9013 return;
9014 if (slnum < 1)
9015 {
9016 semsg(_(e_invalid_value_for_argument_str), "lnum");
9017 return;
9018 }
9019
9020 linenr_T elnum = tv_get_lnum_buf(&argvars[3], buf);
9021 if (did_emsg > did_emsg_before)
9022 return;
9023 if (elnum < 1 || elnum < slnum)
9024 {
9025 semsg(_(e_invalid_value_for_argument_str), "end_lnum");
9026 return;
9027 }
9028
9029 if (elnum > buf->b_ml.ml_line_count)
9030 elnum = buf->b_ml.ml_line_count;
9031
9032 int submatches = FALSE;
9033 if (argvars[4].v_type != VAR_UNKNOWN)
9034 {
9035 dict_T *d = argvars[4].vval.v_dict;
9036 if (d != NULL)
9037 {
9038 dictitem_T *di = dict_find(d, (char_u *)"submatches", -1);
9039 if (di != NULL)
9040 {
9041 if (di->di_tv.v_type != VAR_BOOL)
9042 {
9043 semsg(_(e_invalid_value_for_argument_str), "submatches");
9044 return;
9045 }
9046 submatches = tv_get_bool(&di->di_tv);
9047 }
9048 }
9049 }
9050
9051 // Make 'cpoptions' empty, the 'l' flag should not be used here.
9052 save_cpo = p_cpo;
9053 p_cpo = empty_option;
9054
9055 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
9056 if (regmatch.regprog == NULL)
9057 goto theend;
9058 regmatch.rm_ic = p_ic;
9059
9060 while (slnum <= elnum)
9061 {
9062 char_u *str = ml_get_buf(buf, slnum, FALSE);
9063 if (get_matches_in_str(str, &regmatch, retlist, slnum, submatches,
9064 TRUE) == FAIL)
9065 goto cleanup;
9066 slnum++;
9067 }
9068
9069cleanup:
9070 vim_regfree(regmatch.regprog);
9071
9072theend:
9073 p_cpo = save_cpo;
9074}
9075
9076/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009077 * "match()" function
9078 */
9079 static void
9080f_match(typval_T *argvars, typval_T *rettv)
9081{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009082 find_some_match(argvars, rettv, MATCH_MATCH);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009083}
9084
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009085/*
9086 * "matchend()" function
9087 */
9088 static void
9089f_matchend(typval_T *argvars, typval_T *rettv)
9090{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009091 find_some_match(argvars, rettv, MATCH_END);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009092}
9093
9094/*
9095 * "matchlist()" function
9096 */
9097 static void
9098f_matchlist(typval_T *argvars, typval_T *rettv)
9099{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009100 find_some_match(argvars, rettv, MATCH_LIST);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009101}
9102
9103/*
9104 * "matchstr()" function
9105 */
9106 static void
9107f_matchstr(typval_T *argvars, typval_T *rettv)
9108{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009109 find_some_match(argvars, rettv, MATCH_STR);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009110}
9111
9112/*
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01009113 * "matchstrlist()" function
9114 */
9115 static void
9116f_matchstrlist(typval_T *argvars, typval_T *rettv)
9117{
9118 list_T *retlist = NULL;
9119 char_u *save_cpo;
9120 list_T *l = NULL;
9121 listitem_T *li = NULL;
9122 char_u patbuf[NUMBUFLEN];
9123 regmatch_T regmatch;
9124
9125 rettv->vval.v_number = -1;
9126 if (rettv_list_alloc(rettv) != OK)
9127 return;
9128 retlist = rettv->vval.v_list;
9129
9130 if (check_for_list_arg(argvars, 0) == FAIL
9131 || check_for_string_arg(argvars, 1) == FAIL
9132 || check_for_opt_dict_arg(argvars, 2) == FAIL)
9133 return;
9134
9135 if ((l = argvars[0].vval.v_list) == NULL)
9136 return;
9137
9138 char_u *pat = tv_get_string_buf_chk(&argvars[1], patbuf);
9139 if (pat == NULL)
9140 return;
9141
9142 // Make 'cpoptions' empty, the 'l' flag should not be used here.
9143 save_cpo = p_cpo;
9144 p_cpo = empty_option;
9145
9146 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
9147 if (regmatch.regprog == NULL)
9148 goto theend;
9149 regmatch.rm_ic = p_ic;
9150
9151 int submatches = FALSE;
9152 if (argvars[2].v_type != VAR_UNKNOWN)
9153 {
9154 dict_T *d = argvars[2].vval.v_dict;
9155 if (d != NULL)
9156 {
9157 dictitem_T *di = dict_find(d, (char_u *)"submatches", -1);
9158 if (di != NULL)
9159 {
9160 if (di->di_tv.v_type != VAR_BOOL)
9161 {
9162 semsg(_(e_invalid_value_for_argument_str), "submatches");
9163 goto cleanup;
9164 }
9165 submatches = tv_get_bool(&di->di_tv);
9166 }
9167 }
9168 }
9169
9170 int idx = 0;
9171 CHECK_LIST_MATERIALIZE(l);
9172 FOR_ALL_LIST_ITEMS(l, li)
9173 {
9174 if (li->li_tv.v_type == VAR_STRING && li->li_tv.vval.v_string != NULL)
9175 {
9176 char_u *str = li->li_tv.vval.v_string;
9177 if (get_matches_in_str(str, &regmatch, retlist, idx, submatches,
9178 FALSE) == FAIL)
9179 goto cleanup;
9180 }
9181 idx++;
9182 }
9183
9184cleanup:
9185 vim_regfree(regmatch.regprog);
9186
9187theend:
9188 p_cpo = save_cpo;
9189}
9190
9191/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009192 * "matchstrpos()" function
9193 */
9194 static void
9195f_matchstrpos(typval_T *argvars, typval_T *rettv)
9196{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009197 find_some_match(argvars, rettv, MATCH_POS);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009198}
9199
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009200 static void
9201max_min(typval_T *argvars, typval_T *rettv, int domax)
9202{
9203 varnumber_T n = 0;
9204 varnumber_T i;
9205 int error = FALSE;
9206
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009207 if (in_vim9script() && check_for_list_or_dict_arg(argvars, 0) == FAIL)
9208 return;
9209
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009210 if (argvars[0].v_type == VAR_LIST)
9211 {
9212 list_T *l;
9213 listitem_T *li;
9214
9215 l = argvars[0].vval.v_list;
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009216 if (l != NULL && l->lv_len > 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009217 {
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009218 if (l->lv_first == &range_list_item)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009219 {
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009220 if ((l->lv_u.nonmat.lv_stride > 0) ^ domax)
9221 n = l->lv_u.nonmat.lv_start;
9222 else
=?UTF-8?q?Dundar=20G=C3=B6c?=d5cec1f2022-01-29 15:19:23 +00009223 n = l->lv_u.nonmat.lv_start + ((varnumber_T)l->lv_len - 1)
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009224 * l->lv_u.nonmat.lv_stride;
9225 }
9226 else
9227 {
9228 li = l->lv_first;
9229 if (li != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009230 {
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009231 n = tv_get_number_chk(&li->li_tv, &error);
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009232 if (error)
9233 return; // type error; errmsg already given
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009234 for (;;)
9235 {
9236 li = li->li_next;
9237 if (li == NULL)
9238 break;
9239 i = tv_get_number_chk(&li->li_tv, &error);
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009240 if (error)
9241 return; // type error; errmsg already given
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009242 if (domax ? i > n : i < n)
9243 n = i;
9244 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009245 }
9246 }
9247 }
9248 }
9249 else if (argvars[0].v_type == VAR_DICT)
9250 {
9251 dict_T *d;
9252 int first = TRUE;
9253 hashitem_T *hi;
9254 int todo;
9255
9256 d = argvars[0].vval.v_dict;
9257 if (d != NULL)
9258 {
9259 todo = (int)d->dv_hashtab.ht_used;
Yegappan Lakshmanan14113fd2023-03-07 17:13:51 +00009260 FOR_ALL_HASHTAB_ITEMS(&d->dv_hashtab, hi, todo)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009261 {
9262 if (!HASHITEM_EMPTY(hi))
9263 {
9264 --todo;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009265 i = tv_get_number_chk(&HI2DI(hi)->di_tv, &error);
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009266 if (error)
9267 return; // type error; errmsg already given
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009268 if (first)
9269 {
9270 n = i;
9271 first = FALSE;
9272 }
9273 else if (domax ? i > n : i < n)
9274 n = i;
9275 }
9276 }
9277 }
9278 }
9279 else
Bram Moolenaar460ae5d2022-01-01 14:19:49 +00009280 semsg(_(e_argument_of_str_must_be_list_or_dictionary), domax ? "max()" : "min()");
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009281
9282 rettv->vval.v_number = n;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009283}
9284
9285/*
9286 * "max()" function
9287 */
9288 static void
9289f_max(typval_T *argvars, typval_T *rettv)
9290{
9291 max_min(argvars, rettv, TRUE);
9292}
9293
9294/*
9295 * "min()" function
9296 */
9297 static void
9298f_min(typval_T *argvars, typval_T *rettv)
9299{
9300 max_min(argvars, rettv, FALSE);
9301}
9302
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009303#if defined(FEAT_MZSCHEME) || defined(PROTO)
9304/*
9305 * "mzeval()" function
9306 */
9307 static void
9308f_mzeval(typval_T *argvars, typval_T *rettv)
9309{
9310 char_u *str;
9311 char_u buf[NUMBUFLEN];
9312
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009313 if (check_restricted() || check_secure())
9314 return;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009315
9316 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
9317 return;
9318
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009319 str = tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009320 do_mzeval(str, rettv);
9321}
9322
9323 void
9324mzscheme_call_vim(char_u *name, typval_T *args, typval_T *rettv)
9325{
9326 typval_T argvars[3];
9327
9328 argvars[0].v_type = VAR_STRING;
9329 argvars[0].vval.v_string = name;
9330 copy_tv(args, &argvars[1]);
9331 argvars[2].v_type = VAR_UNKNOWN;
9332 f_call(argvars, rettv);
9333 clear_tv(&argvars[1]);
9334}
9335#endif
9336
9337/*
9338 * "nextnonblank()" function
9339 */
9340 static void
9341f_nextnonblank(typval_T *argvars, typval_T *rettv)
9342{
9343 linenr_T lnum;
9344
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009345 if (in_vim9script() && check_for_lnum_arg(argvars, 0) == FAIL)
9346 return;
9347
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009348 for (lnum = tv_get_lnum(argvars); ; ++lnum)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009349 {
9350 if (lnum < 0 || lnum > curbuf->b_ml.ml_line_count)
9351 {
9352 lnum = 0;
9353 break;
9354 }
9355 if (*skipwhite(ml_get(lnum)) != NUL)
9356 break;
9357 }
9358 rettv->vval.v_number = lnum;
9359}
9360
9361/*
9362 * "nr2char()" function
9363 */
9364 static void
9365f_nr2char(typval_T *argvars, typval_T *rettv)
9366{
9367 char_u buf[NUMBUFLEN];
9368
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02009369 if (in_vim9script()
9370 && (check_for_number_arg(argvars, 0) == FAIL
9371 || check_for_opt_bool_arg(argvars, 1) == FAIL))
9372 return;
9373
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009374 if (has_mbyte)
9375 {
9376 int utf8 = 0;
9377
9378 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaared6a4302020-09-05 20:29:41 +02009379 utf8 = (int)tv_get_bool_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009380 if (utf8)
Bram Moolenaarbdace832019-03-02 10:13:42 +01009381 buf[utf_char2bytes((int)tv_get_number(&argvars[0]), buf)] = NUL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009382 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009383 buf[(*mb_char2bytes)((int)tv_get_number(&argvars[0]), buf)] = NUL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009384 }
9385 else
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009386 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009387 buf[0] = (char_u)tv_get_number(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009388 buf[1] = NUL;
9389 }
9390 rettv->v_type = VAR_STRING;
9391 rettv->vval.v_string = vim_strsave(buf);
9392}
9393
9394/*
9395 * "or(expr, expr)" function
9396 */
9397 static void
9398f_or(typval_T *argvars, typval_T *rettv)
9399{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009400 if (in_vim9script()
9401 && (check_for_number_arg(argvars, 0) == FAIL
9402 || check_for_number_arg(argvars, 1) == FAIL))
9403 return;
9404
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009405 rettv->vval.v_number = tv_get_number_chk(&argvars[0], NULL)
9406 | tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009407}
9408
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009409#ifdef FEAT_PERL
9410/*
9411 * "perleval()" function
9412 */
9413 static void
9414f_perleval(typval_T *argvars, typval_T *rettv)
9415{
9416 char_u *str;
9417 char_u buf[NUMBUFLEN];
9418
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009419 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
9420 return;
9421
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009422 str = tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009423 do_perleval(str, rettv);
9424}
9425#endif
9426
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009427/*
9428 * "prevnonblank()" function
9429 */
9430 static void
9431f_prevnonblank(typval_T *argvars, typval_T *rettv)
9432{
9433 linenr_T lnum;
9434
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009435 if (in_vim9script() && check_for_lnum_arg(argvars, 0) == FAIL)
9436 return;
9437
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009438 lnum = tv_get_lnum(argvars);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009439 if (lnum < 1 || lnum > curbuf->b_ml.ml_line_count)
9440 lnum = 0;
9441 else
9442 while (lnum >= 1 && *skipwhite(ml_get(lnum)) == NUL)
9443 --lnum;
9444 rettv->vval.v_number = lnum;
9445}
9446
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009447// This dummy va_list is here because:
9448// - passing a NULL pointer doesn't work when va_list isn't a pointer
9449// - locally in the function results in a "used before set" warning
9450// - using va_start() to initialize it gives "function with fixed args" error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009451static va_list ap;
9452
9453/*
9454 * "printf()" function
9455 */
9456 static void
9457f_printf(typval_T *argvars, typval_T *rettv)
9458{
9459 char_u buf[NUMBUFLEN];
9460 int len;
9461 char_u *s;
9462 int saved_did_emsg = did_emsg;
9463 char *fmt;
9464
9465 rettv->v_type = VAR_STRING;
9466 rettv->vval.v_string = NULL;
9467
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02009468 if (in_vim9script() && check_for_string_or_number_arg(argvars, 0) == FAIL)
9469 return;
9470
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009471 // Get the required length, allocate the buffer and do it for real.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009472 did_emsg = FALSE;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009473 fmt = (char *)tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar8327d1d2017-07-11 22:34:51 +02009474 len = vim_vsnprintf_typval(NULL, 0, fmt, ap, argvars + 1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009475 if (!did_emsg)
9476 {
9477 s = alloc(len + 1);
9478 if (s != NULL)
9479 {
9480 rettv->vval.v_string = s;
Bram Moolenaar8327d1d2017-07-11 22:34:51 +02009481 (void)vim_vsnprintf_typval((char *)s, len + 1, fmt,
9482 ap, argvars + 1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009483 }
9484 }
9485 did_emsg |= saved_did_emsg;
9486}
9487
9488/*
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009489 * "pum_getpos()" function
9490 */
9491 static void
9492f_pum_getpos(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
9493{
Bram Moolenaar93a10962022-06-16 11:42:09 +01009494 if (rettv_dict_alloc(rettv) == FAIL)
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009495 return;
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009496 pum_set_event_info(rettv->vval.v_dict);
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009497}
9498
9499/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009500 * "pumvisible()" function
9501 */
9502 static void
9503f_pumvisible(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
9504{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009505 if (pum_visible())
9506 rettv->vval.v_number = 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009507}
9508
9509#ifdef FEAT_PYTHON3
9510/*
9511 * "py3eval()" function
9512 */
9513 static void
9514f_py3eval(typval_T *argvars, typval_T *rettv)
9515{
9516 char_u *str;
9517 char_u buf[NUMBUFLEN];
Ben Jacksonea19e782024-11-06 21:50:05 +01009518 dict_T *locals;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009519
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009520 if (check_restricted() || check_secure())
9521 return;
9522
Ben Jacksonea19e782024-11-06 21:50:05 +01009523 if (in_vim9script()
9524 && (check_for_string_arg(argvars, 0) == FAIL
9525 || check_for_opt_dict_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009526 return;
9527
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009528 if (p_pyx == 0)
9529 p_pyx = 3;
9530
Ben Jacksonea19e782024-11-06 21:50:05 +01009531 if (argvars[1].v_type == VAR_DICT)
9532 {
9533 locals = argvars[1].vval.v_dict;
9534 }
9535 else if (argvars[1].v_type != VAR_UNKNOWN)
9536 {
9537 emsg(_(e_dictionary_required));
9538 return;
9539 }
9540 else
9541 {
9542 locals = NULL;
9543 }
9544
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009545 str = tv_get_string_buf(&argvars[0], buf);
Ben Jacksonea19e782024-11-06 21:50:05 +01009546 do_py3eval(str, locals, rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009547}
9548#endif
9549
9550#ifdef FEAT_PYTHON
9551/*
9552 * "pyeval()" function
9553 */
9554 static void
9555f_pyeval(typval_T *argvars, typval_T *rettv)
9556{
9557 char_u *str;
9558 char_u buf[NUMBUFLEN];
Ben Jacksonea19e782024-11-06 21:50:05 +01009559 dict_T *locals;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009560
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009561 if (check_restricted() || check_secure())
9562 return;
9563
Ben Jacksonea19e782024-11-06 21:50:05 +01009564 if (in_vim9script() && (
9565 check_for_string_arg(argvars, 0) == FAIL ||
9566 check_for_opt_dict_arg(argvars, 1) == FAIL ) )
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009567 return;
9568
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009569 if (p_pyx == 0)
9570 p_pyx = 2;
9571
Ben Jacksonea19e782024-11-06 21:50:05 +01009572 if (argvars[1].v_type == VAR_DICT)
9573 {
9574 locals = argvars[1].vval.v_dict;
9575 }
9576 else if (argvars[1].v_type != VAR_UNKNOWN)
9577 {
9578 emsg( "Invalid argument: must be dict" );
9579 return;
9580 }
9581 else
9582 {
9583 locals = NULL;
9584 }
9585
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009586 str = tv_get_string_buf(&argvars[0], buf);
Ben Jacksonea19e782024-11-06 21:50:05 +01009587 do_pyeval(str, locals, rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009588}
9589#endif
9590
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009591#if defined(FEAT_PYTHON) || defined(FEAT_PYTHON3)
9592/*
9593 * "pyxeval()" function
9594 */
9595 static void
9596f_pyxeval(typval_T *argvars, typval_T *rettv)
9597{
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009598 if (check_restricted() || check_secure())
9599 return;
9600
Ben Jacksonea19e782024-11-06 21:50:05 +01009601 if (in_vim9script()
9602 && (check_for_string_arg(argvars, 0) == FAIL
9603 || check_for_opt_dict_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009604 return;
9605
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009606# if defined(FEAT_PYTHON) && defined(FEAT_PYTHON3)
9607 init_pyxversion();
9608 if (p_pyx == 2)
9609 f_pyeval(argvars, rettv);
9610 else
9611 f_py3eval(argvars, rettv);
9612# elif defined(FEAT_PYTHON)
9613 f_pyeval(argvars, rettv);
9614# elif defined(FEAT_PYTHON3)
9615 f_py3eval(argvars, rettv);
9616# endif
9617}
9618#endif
9619
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009620static UINT32_T srand_seed_for_testing = 0;
9621static int srand_seed_for_testing_is_used = FALSE;
9622
9623 static void
9624f_test_srand_seed(typval_T *argvars, typval_T *rettv UNUSED)
9625{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009626 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
9627 return;
9628
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009629 if (argvars[0].v_type == VAR_UNKNOWN)
Bram Moolenaar7633fe52020-06-22 19:10:56 +02009630 srand_seed_for_testing_is_used = FALSE;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009631 else
9632 {
Bram Moolenaar7633fe52020-06-22 19:10:56 +02009633 srand_seed_for_testing = (UINT32_T)tv_get_number(&argvars[0]);
9634 srand_seed_for_testing_is_used = TRUE;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009635 }
9636}
9637
9638 static void
9639init_srand(UINT32_T *x)
9640{
LemonBoy9987fe82024-07-04 13:20:49 +02009641 struct {
9642 union {
9643 UINT32_T number;
9644 char_u bytes[sizeof(UINT32_T)];
9645 } contents;
9646 } buf;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009647
9648 if (srand_seed_for_testing_is_used)
9649 {
Bram Moolenaar7633fe52020-06-22 19:10:56 +02009650 *x = srand_seed_for_testing;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009651 return;
9652 }
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009653
LemonBoy9987fe82024-07-04 13:20:49 +02009654 if (mch_get_random(buf.contents.bytes, sizeof(buf.contents.bytes)) == OK)
9655 {
9656 *x = buf.contents.number;
9657 return;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009658 }
LemonBoy9987fe82024-07-04 13:20:49 +02009659
9660 // The system's random number generator doesn't work, fall back to:
9661 // - randombytes_random()
9662 // - reltime() or time()
9663 // - XOR with process ID
9664#if defined(FEAT_SODIUM)
9665 if (crypt_sodium_init() >= 0)
9666 *x = crypt_sodium_randombytes_random();
9667 else
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009668#endif
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009669 {
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009670#if defined(FEAT_RELTIME)
LemonBoy9987fe82024-07-04 13:20:49 +02009671 proftime_T res;
9672 profile_start(&res);
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009673# if defined(MSWIN)
LemonBoy9987fe82024-07-04 13:20:49 +02009674 *x = (UINT32_T)res.LowPart;
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009675# else
LemonBoy9987fe82024-07-04 13:20:49 +02009676 *x = (UINT32_T)res.tv_fsec;
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009677# endif
9678#else
LemonBoy9987fe82024-07-04 13:20:49 +02009679 *x = vim_time();
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009680#endif
LemonBoy9987fe82024-07-04 13:20:49 +02009681 *x ^= mch_get_pid();
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009682 }
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009683}
9684
kylo252ae6f1d82022-02-16 19:24:07 +00009685#define ROTL(x, k) (((x) << (k)) | ((x) >> (32 - (k))))
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009686#define SPLITMIX32(x, z) ( \
kylo252ae6f1d82022-02-16 19:24:07 +00009687 (z) = ((x) += 0x9e3779b9), \
9688 (z) = ((z) ^ ((z) >> 16)) * 0x85ebca6b, \
9689 (z) = ((z) ^ ((z) >> 13)) * 0xc2b2ae35, \
9690 (z) ^ ((z) >> 16) \
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009691 )
9692#define SHUFFLE_XOSHIRO128STARSTAR(x, y, z, w) \
kylo252ae6f1d82022-02-16 19:24:07 +00009693 result = ROTL((y) * 5, 7) * 9; \
9694 t = (y) << 9; \
9695 (z) ^= (x); \
9696 (w) ^= (y); \
9697 (y) ^= (z), (x) ^= (w); \
9698 (z) ^= t; \
9699 (w) = ROTL(w, 11);
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009700
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009701/*
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009702 * "rand()" function
9703 */
9704 static void
9705f_rand(typval_T *argvars, typval_T *rettv)
9706{
9707 list_T *l = NULL;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009708 static UINT32_T gx, gy, gz, gw;
9709 static int initialized = FALSE;
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009710 listitem_T *lx, *ly, *lz, *lw;
Bram Moolenaar0fd797e2020-11-05 20:46:32 +01009711 UINT32_T x = 0, y, z, w, t, result;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009712
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009713 if (in_vim9script() && check_for_opt_list_arg(argvars, 0) == FAIL)
9714 return;
9715
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009716 if (argvars[0].v_type == VAR_UNKNOWN)
9717 {
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009718 // When no argument is given use the global seed list.
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009719 if (initialized == FALSE)
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009720 {
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009721 // Initialize the global seed list.
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009722 init_srand(&x);
9723
9724 gx = SPLITMIX32(x, z);
9725 gy = SPLITMIX32(x, z);
9726 gz = SPLITMIX32(x, z);
9727 gw = SPLITMIX32(x, z);
9728 initialized = TRUE;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009729 }
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009730
9731 SHUFFLE_XOSHIRO128STARSTAR(gx, gy, gz, gw);
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009732 }
9733 else if (argvars[0].v_type == VAR_LIST)
9734 {
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009735 l = argvars[0].vval.v_list;
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009736 if (l == NULL || list_len(l) != 4)
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009737 goto theend;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009738
9739 lx = list_find(l, 0L);
9740 ly = list_find(l, 1L);
9741 lz = list_find(l, 2L);
9742 lw = list_find(l, 3L);
9743 if (lx->li_tv.v_type != VAR_NUMBER) goto theend;
9744 if (ly->li_tv.v_type != VAR_NUMBER) goto theend;
9745 if (lz->li_tv.v_type != VAR_NUMBER) goto theend;
9746 if (lw->li_tv.v_type != VAR_NUMBER) goto theend;
9747 x = (UINT32_T)lx->li_tv.vval.v_number;
9748 y = (UINT32_T)ly->li_tv.vval.v_number;
9749 z = (UINT32_T)lz->li_tv.vval.v_number;
9750 w = (UINT32_T)lw->li_tv.vval.v_number;
9751
9752 SHUFFLE_XOSHIRO128STARSTAR(x, y, z, w);
9753
9754 lx->li_tv.vval.v_number = (varnumber_T)x;
9755 ly->li_tv.vval.v_number = (varnumber_T)y;
9756 lz->li_tv.vval.v_number = (varnumber_T)z;
9757 lw->li_tv.vval.v_number = (varnumber_T)w;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009758 }
9759 else
9760 goto theend;
9761
9762 rettv->v_type = VAR_NUMBER;
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009763 rettv->vval.v_number = (varnumber_T)result;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009764 return;
9765
9766theend:
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00009767 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[0]));
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009768 rettv->v_type = VAR_NUMBER;
9769 rettv->vval.v_number = -1;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009770}
9771
9772/*
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009773 * "srand()" function
9774 */
9775 static void
9776f_srand(typval_T *argvars, typval_T *rettv)
9777{
9778 UINT32_T x = 0, z;
9779
9780 if (rettv_list_alloc(rettv) == FAIL)
9781 return;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009782
9783 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
9784 return;
9785
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009786 if (argvars[0].v_type == VAR_UNKNOWN)
9787 {
9788 init_srand(&x);
9789 }
9790 else
9791 {
9792 int error = FALSE;
9793
9794 x = (UINT32_T)tv_get_number_chk(&argvars[0], &error);
9795 if (error)
9796 return;
9797 }
9798
9799 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
9800 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
9801 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
9802 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
9803}
9804
9805#undef ROTL
9806#undef SPLITMIX32
9807#undef SHUFFLE_XOSHIRO128STARSTAR
9808
9809/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009810 * "range()" function
9811 */
9812 static void
9813f_range(typval_T *argvars, typval_T *rettv)
9814{
9815 varnumber_T start;
9816 varnumber_T end;
9817 varnumber_T stride = 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009818 int error = FALSE;
9819
Bram Moolenaar93a10962022-06-16 11:42:09 +01009820 if (rettv_list_alloc(rettv) == FAIL)
Yegappan Lakshmananca195cc2022-06-14 13:42:26 +01009821 return;
9822
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009823 if (in_vim9script()
9824 && (check_for_number_arg(argvars, 0) == FAIL
9825 || check_for_opt_number_arg(argvars, 1) == FAIL
9826 || (argvars[1].v_type != VAR_UNKNOWN
9827 && check_for_opt_number_arg(argvars, 2) == FAIL)))
9828 return;
9829
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009830 start = tv_get_number_chk(&argvars[0], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009831 if (argvars[1].v_type == VAR_UNKNOWN)
9832 {
9833 end = start - 1;
9834 start = 0;
9835 }
9836 else
9837 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009838 end = tv_get_number_chk(&argvars[1], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009839 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009840 stride = tv_get_number_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009841 }
9842
9843 if (error)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009844 return; // type error; errmsg already given
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009845 if (stride == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009846 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00009847 emsg(_(e_stride_is_zero));
9848 return;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01009849 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00009850 if (stride > 0 ? end + 1 < start : end - 1 > start)
9851 {
9852 emsg(_(e_start_past_end));
9853 return;
9854 }
9855
9856 list_T *list = rettv->vval.v_list;
9857
9858 // Create a non-materialized list. This is much more efficient and
9859 // works with ":for". If used otherwise CHECK_LIST_MATERIALIZE() must
9860 // be called.
9861 list->lv_first = &range_list_item;
9862 list->lv_u.nonmat.lv_start = start;
9863 list->lv_u.nonmat.lv_end = end;
9864 list->lv_u.nonmat.lv_stride = stride;
Christian Brabandtdf63da92023-11-23 20:14:28 +01009865 if (stride > 0 ? end < start : end > start)
9866 list->lv_len = 0;
9867 else
9868 list->lv_len = (end - start) / stride + 1;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01009869}
9870
9871/*
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02009872 * Materialize "list".
9873 * Do not call directly, use CHECK_LIST_MATERIALIZE()
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01009874 */
9875 void
9876range_list_materialize(list_T *list)
9877{
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02009878 varnumber_T start = list->lv_u.nonmat.lv_start;
9879 varnumber_T end = list->lv_u.nonmat.lv_end;
Bram Moolenaar70c43d82022-01-26 21:01:15 +00009880 int stride = list->lv_u.nonmat.lv_stride;
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02009881 varnumber_T i;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01009882
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02009883 list->lv_first = NULL;
9884 list->lv_u.mat.lv_last = NULL;
9885 list->lv_len = 0;
9886 list->lv_u.mat.lv_idx_item = NULL;
9887 for (i = start; stride > 0 ? i <= end : i >= end; i += stride)
Bram Moolenaar70c43d82022-01-26 21:01:15 +00009888 {
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +00009889 if (list_append_number(list, i) == FAIL)
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02009890 break;
Bram Moolenaar70c43d82022-01-26 21:01:15 +00009891 if (list->lv_lock & VAR_ITEMS_LOCKED)
9892 list->lv_u.mat.lv_last->li_tv.v_lock = VAR_LOCKED;
9893 }
9894 list->lv_lock &= ~VAR_ITEMS_LOCKED;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009895}
9896
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009897/*
9898 * "getreginfo()" function
9899 */
9900 static void
9901f_getreginfo(typval_T *argvars, typval_T *rettv)
9902{
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009903 int regname;
9904 char_u buf[NUMBUFLEN + 2];
9905 long reglen = 0;
9906 dict_T *dict;
9907 list_T *list;
9908
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009909 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
9910 return;
9911
zeertzjqd3f00f52021-12-24 12:02:43 +00009912 regname = getreg_get_regname(argvars);
9913 if (regname == 0)
9914 return;
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009915
zeertzjqd3f00f52021-12-24 12:02:43 +00009916 if (regname == '@')
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009917 regname = '"';
9918
9919 if (rettv_dict_alloc(rettv) == FAIL)
9920 return;
9921 dict = rettv->vval.v_dict;
9922
9923 list = (list_T *)get_reg_contents(regname, GREG_EXPR_SRC | GREG_LIST);
9924 if (list == NULL)
9925 return;
Bram Moolenaar91639192020-06-29 19:55:58 +02009926 (void)dict_add_list(dict, "regcontents", list);
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009927
9928 buf[0] = NUL;
9929 buf[1] = NUL;
9930 switch (get_reg_type(regname, &reglen))
9931 {
9932 case MLINE: buf[0] = 'V'; break;
9933 case MCHAR: buf[0] = 'v'; break;
9934 case MBLOCK:
9935 vim_snprintf((char *)buf, sizeof(buf), "%c%ld", Ctrl_V,
9936 reglen + 1);
9937 break;
9938 }
Bram Moolenaar91639192020-06-29 19:55:58 +02009939 (void)dict_add_string(dict, (char *)"regtype", buf);
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009940
9941 buf[0] = get_register_name(get_unname_register());
9942 buf[1] = NUL;
9943 if (regname == '"')
Bram Moolenaar91639192020-06-29 19:55:58 +02009944 (void)dict_add_string(dict, (char *)"points_to", buf);
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009945 else
9946 {
9947 dictitem_T *item = dictitem_alloc((char_u *)"isunnamed");
9948
9949 if (item != NULL)
9950 {
Bram Moolenaar82946e12022-11-24 11:31:29 +00009951 item->di_tv.v_type = VAR_BOOL;
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009952 item->di_tv.vval.v_number = regname == buf[0]
Bram Moolenaar418a29f2021-02-10 22:23:41 +01009953 ? VVAL_TRUE : VVAL_FALSE;
Bram Moolenaar91639192020-06-29 19:55:58 +02009954 (void)dict_add(dict, item);
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009955 }
9956 }
9957}
9958
Bram Moolenaar0b6d9112018-05-22 20:35:17 +02009959 static void
9960return_register(int regname, typval_T *rettv)
9961{
9962 char_u buf[2] = {0, 0};
9963
9964 buf[0] = (char_u)regname;
9965 rettv->v_type = VAR_STRING;
9966 rettv->vval.v_string = vim_strsave(buf);
9967}
9968
9969/*
9970 * "reg_executing()" function
9971 */
9972 static void
9973f_reg_executing(typval_T *argvars UNUSED, typval_T *rettv)
9974{
9975 return_register(reg_executing, rettv);
9976}
9977
9978/*
9979 * "reg_recording()" function
9980 */
9981 static void
9982f_reg_recording(typval_T *argvars UNUSED, typval_T *rettv)
9983{
9984 return_register(reg_recording, rettv);
9985}
9986
Bram Moolenaar7416f3e2017-03-18 18:10:13 +01009987/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009988 * "rename({from}, {to})" function
9989 */
9990 static void
9991f_rename(typval_T *argvars, typval_T *rettv)
9992{
9993 char_u buf[NUMBUFLEN];
9994
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009995 rettv->vval.v_number = -1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009996 if (check_restricted() || check_secure())
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009997 return;
9998
9999 if (in_vim9script()
10000 && (check_for_string_arg(argvars, 0) == FAIL
10001 || check_for_string_arg(argvars, 1) == FAIL))
10002 return;
10003
10004 rettv->vval.v_number = vim_rename(tv_get_string(&argvars[0]),
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010005 tv_get_string_buf(&argvars[1], buf));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010006}
10007
10008/*
10009 * "repeat()" function
10010 */
10011 static void
10012f_repeat(typval_T *argvars, typval_T *rettv)
10013{
10014 char_u *p;
Bakudankun375141e2022-09-09 18:46:47 +010010015 varnumber_T n;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010016 int slen;
10017 int len;
10018 char_u *r;
10019 int i;
10020
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +020010021 if (in_vim9script()
Bakudankun375141e2022-09-09 18:46:47 +010010022 && (check_for_string_or_number_or_list_or_blob_arg(argvars, 0)
10023 == FAIL
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010024 || check_for_number_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +020010025 return;
10026
Bakudankun375141e2022-09-09 18:46:47 +010010027 n = tv_get_number(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010028 if (argvars[0].v_type == VAR_LIST)
10029 {
10030 if (rettv_list_alloc(rettv) == OK && argvars[0].vval.v_list != NULL)
10031 while (n-- > 0)
10032 if (list_extend(rettv->vval.v_list,
10033 argvars[0].vval.v_list, NULL) == FAIL)
10034 break;
10035 }
Bakudankun375141e2022-09-09 18:46:47 +010010036 else if (argvars[0].v_type == VAR_BLOB)
10037 {
10038 if (rettv_blob_alloc(rettv) == FAIL
10039 || argvars[0].vval.v_blob == NULL
10040 || n <= 0)
10041 return;
10042
10043 slen = argvars[0].vval.v_blob->bv_ga.ga_len;
10044 len = (int)slen * n;
10045 if (len <= 0)
10046 return;
10047
10048 if (ga_grow(&rettv->vval.v_blob->bv_ga, len) == FAIL)
10049 return;
10050
10051 rettv->vval.v_blob->bv_ga.ga_len = len;
10052
10053 for (i = 0; i < slen; ++i)
10054 if (blob_get(argvars[0].vval.v_blob, i) != 0)
10055 break;
10056
10057 if (i == slen)
10058 // No need to copy since all bytes are already zero
10059 return;
10060
10061 for (i = 0; i < n; ++i)
10062 blob_set_range(rettv->vval.v_blob,
10063 (long)i * slen, ((long)i + 1) * slen - 1, argvars);
10064 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010065 else
10066 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010067 p = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010068 rettv->v_type = VAR_STRING;
10069 rettv->vval.v_string = NULL;
10070
10071 slen = (int)STRLEN(p);
10072 len = slen * n;
10073 if (len <= 0)
10074 return;
10075
10076 r = alloc(len + 1);
10077 if (r != NULL)
10078 {
10079 for (i = 0; i < n; i++)
10080 mch_memmove(r + i * slen, p, (size_t)slen);
10081 r[len] = NUL;
10082 }
10083
10084 rettv->vval.v_string = r;
10085 }
10086}
10087
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010088#define SP_NOMOVE 0x01 // don't move cursor
10089#define SP_REPEAT 0x02 // repeat to find outer pair
10090#define SP_RETCOUNT 0x04 // return matchcount
10091#define SP_SETPCMARK 0x08 // set previous context mark
10092#define SP_START 0x10 // accept match at start position
10093#define SP_SUBPAT 0x20 // return nr of matching sub-pattern
10094#define SP_END 0x40 // leave cursor at end of match
10095#define SP_COLUMN 0x80 // start at cursor column
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010096
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010097/*
10098 * Get flags for a search function.
10099 * Possibly sets "p_ws".
10100 * Returns BACKWARD, FORWARD or zero (for an error).
10101 */
10102 static int
10103get_search_arg(typval_T *varp, int *flagsp)
10104{
10105 int dir = FORWARD;
10106 char_u *flags;
10107 char_u nbuf[NUMBUFLEN];
10108 int mask;
10109
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010110 if (varp->v_type == VAR_UNKNOWN)
10111 return FORWARD;
10112
10113 flags = tv_get_string_buf_chk(varp, nbuf);
10114 if (flags == NULL)
10115 return 0; // type error; errmsg already given
10116 while (*flags != NUL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010117 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010118 switch (*flags)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010119 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010120 case 'b': dir = BACKWARD; break;
10121 case 'w': p_ws = TRUE; break;
10122 case 'W': p_ws = FALSE; break;
10123 default: mask = 0;
10124 if (flagsp != NULL)
10125 switch (*flags)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010126 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010127 case 'c': mask = SP_START; break;
10128 case 'e': mask = SP_END; break;
10129 case 'm': mask = SP_RETCOUNT; break;
10130 case 'n': mask = SP_NOMOVE; break;
10131 case 'p': mask = SP_SUBPAT; break;
10132 case 'r': mask = SP_REPEAT; break;
10133 case 's': mask = SP_SETPCMARK; break;
10134 case 'z': mask = SP_COLUMN; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010135 }
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010136 if (mask == 0)
10137 {
10138 semsg(_(e_invalid_argument_str), flags);
10139 dir = 0;
10140 }
10141 else
10142 *flagsp |= mask;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010143 }
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010144 if (dir == 0)
10145 break;
10146 ++flags;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010147 }
10148 return dir;
10149}
10150
10151/*
10152 * Shared by search() and searchpos() functions.
10153 */
10154 static int
10155search_cmn(typval_T *argvars, pos_T *match_pos, int *flagsp)
10156{
10157 int flags;
10158 char_u *pat;
John Marriott8c85a2a2024-05-20 19:18:26 +020010159 size_t patlen;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010160 pos_T pos;
10161 pos_T save_cursor;
10162 int save_p_ws = p_ws;
10163 int dir;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010164 int retval = 0; // default: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010165 long lnum_stop = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010166#ifdef FEAT_RELTIME
10167 long time_limit = 0;
10168#endif
10169 int options = SEARCH_KEEP;
10170 int subpatnum;
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010171 searchit_arg_T sia;
Bram Moolenaara9c01042020-06-07 14:50:50 +020010172 int use_skip = FALSE;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010173 pos_T firstpos;
10174
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +020010175 if (in_vim9script()
10176 && (check_for_string_arg(argvars, 0) == FAIL
10177 || check_for_opt_string_arg(argvars, 1) == FAIL
10178 || (argvars[1].v_type != VAR_UNKNOWN
10179 && (check_for_opt_number_arg(argvars, 2) == FAIL
10180 || (argvars[2].v_type != VAR_UNKNOWN
10181 && check_for_opt_number_arg(argvars, 3) == FAIL)))))
10182 goto theend;
10183
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010184 pat = tv_get_string(&argvars[0]);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010185 dir = get_search_arg(&argvars[1], flagsp); // may set p_ws
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010186 if (dir == 0)
10187 goto theend;
10188 flags = *flagsp;
10189 if (flags & SP_START)
10190 options |= SEARCH_START;
10191 if (flags & SP_END)
10192 options |= SEARCH_END;
10193 if (flags & SP_COLUMN)
10194 options |= SEARCH_COL;
10195
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010196 // Optional arguments: line number to stop searching, timeout and skip.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010197 if (argvars[1].v_type != VAR_UNKNOWN && argvars[2].v_type != VAR_UNKNOWN)
10198 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010199 lnum_stop = (long)tv_get_number_chk(&argvars[2], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010200 if (lnum_stop < 0)
10201 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010202 if (argvars[3].v_type != VAR_UNKNOWN)
10203 {
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010204#ifdef FEAT_RELTIME
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010205 time_limit = (long)tv_get_number_chk(&argvars[3], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010206 if (time_limit < 0)
10207 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010208#endif
Bram Moolenaara9c01042020-06-07 14:50:50 +020010209 use_skip = eval_expr_valid_arg(&argvars[4]);
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010210 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010211 }
10212
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010213 /*
10214 * This function does not accept SP_REPEAT and SP_RETCOUNT flags.
10215 * Check to make sure only those flags are set.
10216 * Also, Only the SP_NOMOVE or the SP_SETPCMARK flag can be set. Both
10217 * flags cannot be set. Check for that condition also.
10218 */
10219 if (((flags & (SP_REPEAT | SP_RETCOUNT)) != 0)
10220 || ((flags & SP_NOMOVE) && (flags & SP_SETPCMARK)))
10221 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010222 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[1]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010223 goto theend;
10224 }
10225
10226 pos = save_cursor = curwin->w_cursor;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010227 CLEAR_FIELD(firstpos);
Bram Moolenaara80faa82020-04-12 19:37:17 +020010228 CLEAR_FIELD(sia);
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010229 sia.sa_stop_lnum = (linenr_T)lnum_stop;
10230#ifdef FEAT_RELTIME
Paul Ollis65745772022-06-05 16:55:54 +010010231 sia.sa_tm = time_limit;
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010232#endif
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010233
John Marriott8c85a2a2024-05-20 19:18:26 +020010234 patlen = STRLEN(pat);
10235
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010236 // Repeat until {skip} returns FALSE.
10237 for (;;)
10238 {
John Marriott8c85a2a2024-05-20 19:18:26 +020010239 subpatnum = searchit(curwin, curbuf, &pos, NULL, dir, pat, patlen, 1L,
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010240 options, RE_SEARCH, &sia);
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010241 // finding the first match again means there is no match where {skip}
10242 // evaluates to zero.
10243 if (firstpos.lnum != 0 && EQUAL_POS(pos, firstpos))
10244 subpatnum = FAIL;
10245
Bram Moolenaara9c01042020-06-07 14:50:50 +020010246 if (subpatnum == FAIL || !use_skip)
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010247 // didn't find it or no skip argument
10248 break;
Bram Moolenaar3d79f0a2023-01-22 20:14:26 +000010249 if (firstpos.lnum == 0)
10250 firstpos = pos;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010251
Bram Moolenaara9c01042020-06-07 14:50:50 +020010252 // If the skip expression matches, ignore this match.
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010253 {
10254 int do_skip;
10255 int err;
10256 pos_T save_pos = curwin->w_cursor;
10257
10258 curwin->w_cursor = pos;
Bram Moolenaara9c01042020-06-07 14:50:50 +020010259 err = FALSE;
10260 do_skip = eval_expr_to_bool(&argvars[4], &err);
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010261 curwin->w_cursor = save_pos;
10262 if (err)
10263 {
10264 // Evaluating {skip} caused an error, break here.
10265 subpatnum = FAIL;
10266 break;
10267 }
10268 if (!do_skip)
10269 break;
10270 }
zeertzjq180246c2022-06-23 12:04:46 +010010271
10272 // clear the start flag to avoid getting stuck here
10273 options &= ~SEARCH_START;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010274 }
10275
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010276 if (subpatnum != FAIL)
10277 {
10278 if (flags & SP_SUBPAT)
10279 retval = subpatnum;
10280 else
10281 retval = pos.lnum;
10282 if (flags & SP_SETPCMARK)
10283 setpcmark();
10284 curwin->w_cursor = pos;
10285 if (match_pos != NULL)
10286 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010287 // Store the match cursor position
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010288 match_pos->lnum = pos.lnum;
10289 match_pos->col = pos.col + 1;
10290 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010291 // "/$" will put the cursor after the end of the line, may need to
10292 // correct that here
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010293 check_cursor();
10294 }
10295
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010296 // If 'n' flag is used: restore cursor position.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010297 if (flags & SP_NOMOVE)
10298 curwin->w_cursor = save_cursor;
10299 else
10300 curwin->w_set_curswant = TRUE;
10301theend:
10302 p_ws = save_p_ws;
10303
10304 return retval;
10305}
10306
Bram Moolenaare99be0e2019-03-26 22:51:09 +010010307#ifdef FEAT_RUBY
10308/*
10309 * "rubyeval()" function
10310 */
10311 static void
10312f_rubyeval(typval_T *argvars, typval_T *rettv)
10313{
10314 char_u *str;
10315 char_u buf[NUMBUFLEN];
10316
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010317 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
10318 return;
10319
Bram Moolenaare99be0e2019-03-26 22:51:09 +010010320 str = tv_get_string_buf(&argvars[0], buf);
10321 do_rubyeval(str, rettv);
10322}
10323#endif
10324
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010325/*
10326 * "screenattr()" function
10327 */
10328 static void
10329f_screenattr(typval_T *argvars, typval_T *rettv)
10330{
10331 int row;
10332 int col;
10333 int c;
10334
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010335 if (in_vim9script()
10336 && (check_for_number_arg(argvars, 0) == FAIL
10337 || check_for_number_arg(argvars, 1) == FAIL))
10338 return;
10339
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010340 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10341 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010342 if (row < 0 || row >= screen_Rows
10343 || col < 0 || col >= screen_Columns)
10344 c = -1;
10345 else
10346 c = ScreenAttrs[LineOffset[row] + col];
10347 rettv->vval.v_number = c;
10348}
10349
10350/*
10351 * "screenchar()" function
10352 */
10353 static void
10354f_screenchar(typval_T *argvars, typval_T *rettv)
10355{
10356 int row;
10357 int col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010358 int c;
10359
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010360 if (in_vim9script()
10361 && (check_for_number_arg(argvars, 0) == FAIL
10362 || check_for_number_arg(argvars, 1) == FAIL))
10363 return;
10364
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010365 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10366 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010367 if (row < 0 || row >= screen_Rows || col < 0 || col >= screen_Columns)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010368 c = -1;
10369 else
10370 {
zeertzjq47eec672023-06-01 20:26:55 +010010371 char_u buf[MB_MAXBYTES + 1];
10372 screen_getbytes(row, col, buf, NULL);
10373 c = (*mb_ptr2char)(buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010374 }
10375 rettv->vval.v_number = c;
10376}
10377
10378/*
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010379 * "screenchars()" function
10380 */
10381 static void
10382f_screenchars(typval_T *argvars, typval_T *rettv)
10383{
10384 int row;
10385 int col;
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010386 int c;
10387 int i;
10388
10389 if (rettv_list_alloc(rettv) == FAIL)
10390 return;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010391
10392 if (in_vim9script()
10393 && (check_for_number_arg(argvars, 0) == FAIL
10394 || check_for_number_arg(argvars, 1) == FAIL))
10395 return;
10396
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010397 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10398 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
10399 if (row < 0 || row >= screen_Rows || col < 0 || col >= screen_Columns)
10400 return;
10401
zeertzjq47eec672023-06-01 20:26:55 +010010402 char_u buf[MB_MAXBYTES + 1];
10403 screen_getbytes(row, col, buf, NULL);
10404 int pcc[MAX_MCO];
10405 if (enc_utf8)
10406 c = utfc_ptr2char(buf, pcc);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010407 else
zeertzjq47eec672023-06-01 20:26:55 +010010408 c = (*mb_ptr2char)(buf);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010409 list_append_number(rettv->vval.v_list, (varnumber_T)c);
10410
10411 if (enc_utf8)
zeertzjq47eec672023-06-01 20:26:55 +010010412 for (i = 0; i < Screen_mco && pcc[i] != 0; ++i)
10413 list_append_number(rettv->vval.v_list, (varnumber_T)pcc[i]);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010414}
10415
10416/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010417 * "screencol()" function
10418 *
10419 * First column is 1 to be consistent with virtcol().
10420 */
10421 static void
10422f_screencol(typval_T *argvars UNUSED, typval_T *rettv)
10423{
10424 rettv->vval.v_number = screen_screencol() + 1;
10425}
10426
10427/*
10428 * "screenrow()" function
10429 */
10430 static void
10431f_screenrow(typval_T *argvars UNUSED, typval_T *rettv)
10432{
10433 rettv->vval.v_number = screen_screenrow() + 1;
10434}
10435
10436/*
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010437 * "screenstring()" function
10438 */
10439 static void
10440f_screenstring(typval_T *argvars, typval_T *rettv)
10441{
10442 int row;
10443 int col;
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010444 char_u buf[MB_MAXBYTES + 1];
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010445
10446 rettv->vval.v_string = NULL;
10447 rettv->v_type = VAR_STRING;
10448
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010449 if (in_vim9script()
10450 && (check_for_number_arg(argvars, 0) == FAIL
10451 || check_for_number_arg(argvars, 1) == FAIL))
10452 return;
10453
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010454 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10455 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
10456 if (row < 0 || row >= screen_Rows || col < 0 || col >= screen_Columns)
10457 return;
10458
zeertzjq47eec672023-06-01 20:26:55 +010010459 screen_getbytes(row, col, buf, NULL);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010460 rettv->vval.v_string = vim_strsave(buf);
10461}
10462
10463/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010464 * "search()" function
10465 */
10466 static void
10467f_search(typval_T *argvars, typval_T *rettv)
10468{
10469 int flags = 0;
10470
10471 rettv->vval.v_number = search_cmn(argvars, NULL, &flags);
10472}
10473
10474/*
10475 * "searchdecl()" function
10476 */
10477 static void
10478f_searchdecl(typval_T *argvars, typval_T *rettv)
10479{
Bram Moolenaar30788d32020-09-05 21:35:16 +020010480 int locally = TRUE;
10481 int thisblock = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010482 int error = FALSE;
10483 char_u *name;
10484
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010485 rettv->vval.v_number = 1; // default: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010486
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020010487 if (in_vim9script()
10488 && (check_for_string_arg(argvars, 0) == FAIL
10489 || check_for_opt_bool_arg(argvars, 1) == FAIL
10490 || (argvars[1].v_type != VAR_UNKNOWN
10491 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
10492 return;
10493
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010494 name = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010495 if (argvars[1].v_type != VAR_UNKNOWN)
10496 {
Bram Moolenaar30788d32020-09-05 21:35:16 +020010497 locally = !(int)tv_get_bool_chk(&argvars[1], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010498 if (!error && argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar30788d32020-09-05 21:35:16 +020010499 thisblock = (int)tv_get_bool_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010500 }
10501 if (!error && name != NULL)
10502 rettv->vval.v_number = find_decl(name, (int)STRLEN(name),
10503 locally, thisblock, SEARCH_KEEP) == FAIL;
10504}
10505
10506/*
10507 * Used by searchpair() and searchpairpos()
10508 */
10509 static int
10510searchpair_cmn(typval_T *argvars, pos_T *match_pos)
10511{
10512 char_u *spat, *mpat, *epat;
Bram Moolenaar48570482017-10-30 21:48:41 +010010513 typval_T *skip;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010514 int save_p_ws = p_ws;
10515 int dir;
10516 int flags = 0;
10517 char_u nbuf1[NUMBUFLEN];
10518 char_u nbuf2[NUMBUFLEN];
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010519 int retval = 0; // default: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010520 long lnum_stop = 0;
10521 long time_limit = 0;
10522
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +020010523 if (in_vim9script()
10524 && (check_for_string_arg(argvars, 0) == FAIL
10525 || check_for_string_arg(argvars, 1) == FAIL
10526 || check_for_string_arg(argvars, 2) == FAIL
10527 || check_for_opt_string_arg(argvars, 3) == FAIL
10528 || (argvars[3].v_type != VAR_UNKNOWN
10529 && argvars[4].v_type != VAR_UNKNOWN
10530 && (check_for_opt_number_arg(argvars, 5) == FAIL
10531 || (argvars[5].v_type != VAR_UNKNOWN
10532 && check_for_opt_number_arg(argvars, 6) == FAIL)))))
10533 goto theend;
10534
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010535 // Get the three pattern arguments: start, middle, end. Will result in an
10536 // error if not a valid argument.
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010537 spat = tv_get_string_chk(&argvars[0]);
10538 mpat = tv_get_string_buf_chk(&argvars[1], nbuf1);
10539 epat = tv_get_string_buf_chk(&argvars[2], nbuf2);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010540 if (spat == NULL || mpat == NULL || epat == NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010541 goto theend; // type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010542
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010543 // Handle the optional fourth argument: flags
10544 dir = get_search_arg(&argvars[3], &flags); // may set p_ws
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010545 if (dir == 0)
10546 goto theend;
10547
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010548 // Don't accept SP_END or SP_SUBPAT.
10549 // Only one of the SP_NOMOVE or SP_SETPCMARK flags can be set.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010550 if ((flags & (SP_END | SP_SUBPAT)) != 0
10551 || ((flags & SP_NOMOVE) && (flags & SP_SETPCMARK)))
10552 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010553 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[3]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010554 goto theend;
10555 }
10556
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010557 // Using 'r' implies 'W', otherwise it doesn't work.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010558 if (flags & SP_REPEAT)
10559 p_ws = FALSE;
10560
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010561 // Optional fifth argument: skip expression
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010562 if (argvars[3].v_type == VAR_UNKNOWN
10563 || argvars[4].v_type == VAR_UNKNOWN)
Bram Moolenaar48570482017-10-30 21:48:41 +010010564 skip = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010565 else
10566 {
Bram Moolenaara9c01042020-06-07 14:50:50 +020010567 // Type is checked later.
Bram Moolenaar48570482017-10-30 21:48:41 +010010568 skip = &argvars[4];
Bram Moolenaara9c01042020-06-07 14:50:50 +020010569
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010570 if (argvars[5].v_type != VAR_UNKNOWN)
10571 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010572 lnum_stop = (long)tv_get_number_chk(&argvars[5], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010573 if (lnum_stop < 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[5]));
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#ifdef FEAT_RELTIME
10579 if (argvars[6].v_type != VAR_UNKNOWN)
10580 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010581 time_limit = (long)tv_get_number_chk(&argvars[6], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010582 if (time_limit < 0)
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010583 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010584 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[6]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010585 goto theend;
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010586 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010587 }
10588#endif
10589 }
10590 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010591
10592 retval = do_searchpair(spat, mpat, epat, dir, skip, flags,
10593 match_pos, lnum_stop, time_limit);
10594
10595theend:
10596 p_ws = save_p_ws;
10597
10598 return retval;
10599}
10600
10601/*
10602 * "searchpair()" function
10603 */
10604 static void
10605f_searchpair(typval_T *argvars, typval_T *rettv)
10606{
10607 rettv->vval.v_number = searchpair_cmn(argvars, NULL);
10608}
10609
10610/*
10611 * "searchpairpos()" function
10612 */
10613 static void
10614f_searchpairpos(typval_T *argvars, typval_T *rettv)
10615{
10616 pos_T match_pos;
10617 int lnum = 0;
10618 int col = 0;
10619
10620 if (rettv_list_alloc(rettv) == FAIL)
10621 return;
10622
10623 if (searchpair_cmn(argvars, &match_pos) > 0)
10624 {
10625 lnum = match_pos.lnum;
10626 col = match_pos.col;
10627 }
10628
10629 list_append_number(rettv->vval.v_list, (varnumber_T)lnum);
10630 list_append_number(rettv->vval.v_list, (varnumber_T)col);
10631}
10632
10633/*
10634 * Search for a start/middle/end thing.
10635 * Used by searchpair(), see its documentation for the details.
10636 * Returns 0 or -1 for no match,
10637 */
10638 long
10639do_searchpair(
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010640 char_u *spat, // start pattern
10641 char_u *mpat, // middle pattern
10642 char_u *epat, // end pattern
10643 int dir, // BACKWARD or FORWARD
10644 typval_T *skip, // skip expression
10645 int flags, // SP_SETPCMARK and other SP_ values
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010646 pos_T *match_pos,
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010647 linenr_T lnum_stop, // stop at this line if not zero
10648 long time_limit UNUSED) // stop after this many msec
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010649{
10650 char_u *save_cpo;
10651 char_u *pat, *pat2 = NULL, *pat3 = NULL;
John Marriott8c85a2a2024-05-20 19:18:26 +020010652 size_t patlen;
10653 size_t spatlen;
10654 size_t epatlen;
10655 size_t pat2size;
10656 size_t pat2len;
10657 size_t pat3size;
10658 size_t pat3len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010659 long retval = 0;
10660 pos_T pos;
10661 pos_T firstpos;
10662 pos_T foundpos;
10663 pos_T save_cursor;
10664 pos_T save_pos;
10665 int n;
10666 int r;
10667 int nest = 1;
Bram Moolenaar48570482017-10-30 21:48:41 +010010668 int use_skip = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010669 int err;
10670 int options = SEARCH_KEEP;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010671
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010672 // Make 'cpoptions' empty, the 'l' flag should not be used here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010673 save_cpo = p_cpo;
10674 p_cpo = empty_option;
10675
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010676 // Make two search patterns: start/end (pat2, for in nested pairs) and
10677 // start/middle/end (pat3, for the top pair).
John Marriott8c85a2a2024-05-20 19:18:26 +020010678 spatlen = STRLEN(spat);
10679 epatlen = STRLEN(epat);
10680 pat2size = spatlen + epatlen + 17;
10681 pat2 = alloc(pat2size);
10682 if (pat2 == NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010683 goto theend;
John Marriott8c85a2a2024-05-20 19:18:26 +020010684 pat3size = spatlen + STRLEN(mpat) + epatlen + 25;
10685 pat3 = alloc(pat3size);
10686 if (pat3 == NULL)
10687 goto theend;
10688 pat2len = vim_snprintf((char *)pat2, pat2size, "\\m\\(%s\\m\\)\\|\\(%s\\m\\)", spat, epat);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010689 if (*mpat == NUL)
John Marriott8c85a2a2024-05-20 19:18:26 +020010690 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010691 STRCPY(pat3, pat2);
John Marriott8c85a2a2024-05-20 19:18:26 +020010692 pat3len = pat2len;
10693 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010694 else
John Marriott8c85a2a2024-05-20 19:18:26 +020010695 pat3len = vim_snprintf((char *)pat3, pat3size, "\\m\\(%s\\m\\)\\|\\(%s\\m\\)\\|\\(%s\\m\\)",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010696 spat, epat, mpat);
10697 if (flags & SP_START)
10698 options |= SEARCH_START;
10699
Bram Moolenaar48570482017-10-30 21:48:41 +010010700 if (skip != NULL)
Bram Moolenaara9c01042020-06-07 14:50:50 +020010701 use_skip = eval_expr_valid_arg(skip);
Bram Moolenaar48570482017-10-30 21:48:41 +010010702
Bram Moolenaar5ea38d12022-06-16 21:20:48 +010010703#ifdef FEAT_RELTIME
10704 if (time_limit > 0)
10705 init_regexp_timeout(time_limit);
10706#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010707 save_cursor = curwin->w_cursor;
10708 pos = curwin->w_cursor;
Bram Moolenaarb5aedf32017-03-12 18:23:53 +010010709 CLEAR_POS(&firstpos);
10710 CLEAR_POS(&foundpos);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010711 pat = pat3;
John Marriott8c85a2a2024-05-20 19:18:26 +020010712 patlen = pat3len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010713 for (;;)
10714 {
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010715 searchit_arg_T sia;
10716
Bram Moolenaara80faa82020-04-12 19:37:17 +020010717 CLEAR_FIELD(sia);
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010718 sia.sa_stop_lnum = lnum_stop;
John Marriott8c85a2a2024-05-20 19:18:26 +020010719 n = searchit(curwin, curbuf, &pos, NULL, dir, pat, patlen, 1L,
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010720 options, RE_SEARCH, &sia);
Bram Moolenaarb5aedf32017-03-12 18:23:53 +010010721 if (n == FAIL || (firstpos.lnum != 0 && EQUAL_POS(pos, firstpos)))
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010722 // didn't find it or found the first match again: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010723 break;
10724
10725 if (firstpos.lnum == 0)
10726 firstpos = pos;
Bram Moolenaarb5aedf32017-03-12 18:23:53 +010010727 if (EQUAL_POS(pos, foundpos))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010728 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010729 // Found the same position again. Can happen with a pattern that
10730 // has "\zs" at the end and searching backwards. Advance one
10731 // character and try again.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010732 if (dir == BACKWARD)
10733 decl(&pos);
10734 else
10735 incl(&pos);
10736 }
10737 foundpos = pos;
10738
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010739 // clear the start flag to avoid getting stuck here
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010740 options &= ~SEARCH_START;
10741
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010742 // If the skip pattern matches, ignore this match.
Bram Moolenaar48570482017-10-30 21:48:41 +010010743 if (use_skip)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010744 {
10745 save_pos = curwin->w_cursor;
10746 curwin->w_cursor = pos;
Bram Moolenaar48570482017-10-30 21:48:41 +010010747 err = FALSE;
10748 r = eval_expr_to_bool(skip, &err);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010749 curwin->w_cursor = save_pos;
10750 if (err)
10751 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010752 // Evaluating {skip} caused an error, break here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010753 curwin->w_cursor = save_cursor;
10754 retval = -1;
10755 break;
10756 }
10757 if (r)
10758 continue;
10759 }
10760
10761 if ((dir == BACKWARD && n == 3) || (dir == FORWARD && n == 2))
10762 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010763 // Found end when searching backwards or start when searching
10764 // forward: nested pair.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010765 ++nest;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010766 pat = pat2; // nested, don't search for middle
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010767 }
10768 else
10769 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010770 // Found end when searching forward or start when searching
10771 // backward: end of (nested) pair; or found middle in outer pair.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010772 if (--nest == 1)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010773 pat = pat3; // outer level, search for middle
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010774 }
10775
10776 if (nest == 0)
10777 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010778 // Found the match: return matchcount or line number.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010779 if (flags & SP_RETCOUNT)
10780 ++retval;
10781 else
10782 retval = pos.lnum;
10783 if (flags & SP_SETPCMARK)
10784 setpcmark();
10785 curwin->w_cursor = pos;
10786 if (!(flags & SP_REPEAT))
10787 break;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010788 nest = 1; // search for next unmatched
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010789 }
10790 }
10791
10792 if (match_pos != NULL)
10793 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010794 // Store the match cursor position
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010795 match_pos->lnum = curwin->w_cursor.lnum;
10796 match_pos->col = curwin->w_cursor.col + 1;
10797 }
10798
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010799 // If 'n' flag is used or search failed: restore cursor position.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010800 if ((flags & SP_NOMOVE) || retval == 0)
10801 curwin->w_cursor = save_cursor;
10802
10803theend:
Bram Moolenaar5ea38d12022-06-16 21:20:48 +010010804#ifdef FEAT_RELTIME
Bram Moolenaar0f618382022-08-26 21:33:04 +010010805 if (time_limit > 0)
10806 disable_regexp_timeout();
Bram Moolenaar5ea38d12022-06-16 21:20:48 +010010807#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010808 vim_free(pat2);
10809 vim_free(pat3);
10810 if (p_cpo == empty_option)
10811 p_cpo = save_cpo;
10812 else
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010010813 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010814 // Darn, evaluating the {skip} expression changed the value.
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010010815 // If it's still empty it was changed and restored, need to restore in
10816 // the complicated way.
10817 if (*p_cpo == NUL)
Bram Moolenaar31e5c602022-04-15 13:53:33 +010010818 set_option_value_give_err((char_u *)"cpo", 0L, save_cpo, 0);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010819 free_string_option(save_cpo);
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010010820 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010821
10822 return retval;
10823}
10824
10825/*
10826 * "searchpos()" function
10827 */
10828 static void
10829f_searchpos(typval_T *argvars, typval_T *rettv)
10830{
10831 pos_T match_pos;
10832 int lnum = 0;
10833 int col = 0;
10834 int n;
10835 int flags = 0;
10836
10837 if (rettv_list_alloc(rettv) == FAIL)
10838 return;
10839
10840 n = search_cmn(argvars, &match_pos, &flags);
10841 if (n > 0)
10842 {
10843 lnum = match_pos.lnum;
10844 col = match_pos.col;
10845 }
10846
10847 list_append_number(rettv->vval.v_list, (varnumber_T)lnum);
10848 list_append_number(rettv->vval.v_list, (varnumber_T)col);
10849 if (flags & SP_SUBPAT)
10850 list_append_number(rettv->vval.v_list, (varnumber_T)n);
10851}
10852
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010853/*
10854 * Set the cursor or mark position.
zeertzjq47eec672023-06-01 20:26:55 +010010855 * If "charpos" is TRUE, then use the column number as a character offset.
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010856 * Otherwise use the column number as a byte offset.
10857 */
10858 static void
10859set_position(typval_T *argvars, typval_T *rettv, int charpos)
10860{
10861 pos_T pos;
10862 int fnum;
10863 char_u *name;
10864 colnr_T curswant = -1;
10865
10866 rettv->vval.v_number = -1;
10867
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020010868 if (in_vim9script()
10869 && (check_for_string_arg(argvars, 0) == FAIL
10870 || check_for_list_arg(argvars, 1) == FAIL))
10871 return;
10872
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010873 name = tv_get_string_chk(argvars);
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010874 if (name == NULL)
10875 return;
10876
10877 if (list2fpos(&argvars[1], &pos, &fnum, &curswant, charpos) != OK)
10878 return;
10879
10880 if (pos.col != MAXCOL && --pos.col < 0)
10881 pos.col = 0;
10882 if ((name[0] == '.' && name[1] == NUL))
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010883 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010884 // set cursor; "fnum" is ignored
10885 curwin->w_cursor = pos;
10886 if (curswant >= 0)
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010887 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010888 curwin->w_curswant = curswant - 1;
10889 curwin->w_set_curswant = FALSE;
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010890 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010891 check_cursor();
10892 rettv->vval.v_number = 0;
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010893 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010894 else if (name[0] == '\'' && name[1] != NUL && name[2] == NUL)
10895 {
10896 // set mark
10897 if (setmark_pos(name[1], &pos, fnum) == OK)
10898 rettv->vval.v_number = 0;
10899 }
10900 else
10901 emsg(_(e_invalid_argument));
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010902}
10903/*
10904 * "setcharpos()" function
10905 */
10906 static void
10907f_setcharpos(typval_T *argvars, typval_T *rettv)
10908{
10909 set_position(argvars, rettv, TRUE);
10910}
10911
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010912 static void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010913f_setcharsearch(typval_T *argvars, typval_T *rettv UNUSED)
10914{
10915 dict_T *d;
10916 dictitem_T *di;
10917 char_u *csearch;
10918
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +010010919 if (check_for_dict_arg(argvars, 0) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010920 return;
10921
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010922 if ((d = argvars[0].vval.v_dict) == NULL)
10923 return;
10924
10925 csearch = dict_get_string(d, "char", FALSE);
10926 if (csearch != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010927 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010928 if (enc_utf8)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010929 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010930 int pcc[MAX_MCO];
10931 int c = utfc_ptr2char(csearch, pcc);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010932
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010933 set_last_csearch(c, csearch, utfc_ptr2len(csearch));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010934 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010935 else
10936 set_last_csearch(PTR2CHAR(csearch),
10937 csearch, mb_ptr2len(csearch));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010938 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010939
10940 di = dict_find(d, (char_u *)"forward", -1);
10941 if (di != NULL)
10942 set_csearch_direction((int)tv_get_number(&di->di_tv)
10943 ? FORWARD : BACKWARD);
10944
10945 di = dict_find(d, (char_u *)"until", -1);
10946 if (di != NULL)
10947 set_csearch_until(!!tv_get_number(&di->di_tv));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010948}
10949
10950/*
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010951 * "setcursorcharpos" function
10952 */
10953 static void
Bram Moolenaar3af15ab2021-01-17 16:16:23 +010010954f_setcursorcharpos(typval_T *argvars, typval_T *rettv)
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010955{
10956 set_cursorpos(argvars, rettv, TRUE);
10957}
10958
10959/*
Bram Moolenaar691ddee2019-05-09 14:52:41 +020010960 * "setenv()" function
10961 */
10962 static void
10963f_setenv(typval_T *argvars, typval_T *rettv UNUSED)
10964{
10965 char_u namebuf[NUMBUFLEN];
10966 char_u valbuf[NUMBUFLEN];
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020010967 char_u *name;
Bram Moolenaar691ddee2019-05-09 14:52:41 +020010968
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020010969 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
10970 return;
10971
zeertzjqfcaeb3d2023-11-28 20:46:29 +010010972 // setting an environment variable may be dangerous, e.g. you could
Christian Brabandt6b89dd62023-10-26 22:14:17 +020010973 // setenv GCONV_PATH=/tmp and then have iconv() unexpectedly call
10974 // a shell command using some shared library:
10975 if (check_restricted() || check_secure())
10976 return;
10977
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020010978 name = tv_get_string_buf(&argvars[0], namebuf);
Bram Moolenaar691ddee2019-05-09 14:52:41 +020010979 if (argvars[1].v_type == VAR_SPECIAL
10980 && argvars[1].vval.v_number == VVAL_NULL)
LemonBoy77142312022-04-15 20:50:46 +010010981 vim_unsetenv_ext(name);
Bram Moolenaar691ddee2019-05-09 14:52:41 +020010982 else
LemonBoy77142312022-04-15 20:50:46 +010010983 vim_setenv_ext(name, tv_get_string_buf(&argvars[1], valbuf));
Bram Moolenaar691ddee2019-05-09 14:52:41 +020010984}
10985
10986/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010987 * "setfperm({fname}, {mode})" function
10988 */
10989 static void
10990f_setfperm(typval_T *argvars, typval_T *rettv)
10991{
10992 char_u *fname;
10993 char_u modebuf[NUMBUFLEN];
10994 char_u *mode_str;
10995 int i;
10996 int mask;
10997 int mode = 0;
10998
10999 rettv->vval.v_number = 0;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011000
11001 if (in_vim9script()
11002 && (check_for_string_arg(argvars, 0) == FAIL
11003 || check_for_string_arg(argvars, 1) == FAIL))
11004 return;
11005
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011006 fname = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011007 if (fname == NULL)
11008 return;
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011009 mode_str = tv_get_string_buf_chk(&argvars[1], modebuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011010 if (mode_str == NULL)
11011 return;
11012 if (STRLEN(mode_str) != 9)
11013 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000011014 semsg(_(e_invalid_argument_str), mode_str);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011015 return;
11016 }
11017
11018 mask = 1;
11019 for (i = 8; i >= 0; --i)
11020 {
11021 if (mode_str[i] != '-')
11022 mode |= mask;
11023 mask = mask << 1;
11024 }
11025 rettv->vval.v_number = mch_setperm(fname, mode) == OK;
11026}
11027
11028/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011029 * "setpos()" function
11030 */
11031 static void
11032f_setpos(typval_T *argvars, typval_T *rettv)
11033{
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011034 set_position(argvars, rettv, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011035}
11036
11037/*
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011038 * Translate a register type string to the yank type and block length
11039 */
11040 static int
11041get_yank_type(char_u **pp, char_u *yank_type, long *block_len)
11042{
11043 char_u *stropt = *pp;
11044 switch (*stropt)
11045 {
11046 case 'v': case 'c': // character-wise selection
11047 *yank_type = MCHAR;
11048 break;
11049 case 'V': case 'l': // line-wise selection
11050 *yank_type = MLINE;
11051 break;
11052 case 'b': case Ctrl_V: // block-wise selection
11053 *yank_type = MBLOCK;
11054 if (VIM_ISDIGIT(stropt[1]))
11055 {
11056 ++stropt;
11057 *block_len = getdigits(&stropt) - 1;
11058 --stropt;
11059 }
11060 break;
11061 default:
11062 return FAIL;
11063 }
11064 *pp = stropt;
11065 return OK;
11066}
11067
11068/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011069 * "setreg()" function
11070 */
11071 static void
11072f_setreg(typval_T *argvars, typval_T *rettv)
11073{
11074 int regname;
11075 char_u *strregname;
11076 char_u *stropt;
11077 char_u *strval;
11078 int append;
11079 char_u yank_type;
11080 long block_len;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011081 typval_T *regcontents;
11082 int pointreg;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011083
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020011084 if (in_vim9script()
11085 && (check_for_string_arg(argvars, 0) == FAIL
11086 || check_for_opt_string_arg(argvars, 2) == FAIL))
11087 return;
11088
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011089 pointreg = 0;
11090 regcontents = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011091 block_len = -1;
11092 yank_type = MAUTO;
11093 append = FALSE;
11094
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011095 strregname = tv_get_string_chk(argvars);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011096 rettv->vval.v_number = 1; // FAIL is default
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011097
11098 if (strregname == NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011099 return; // type error; errmsg already given
Bram Moolenaar418a29f2021-02-10 22:23:41 +010011100 if (in_vim9script() && STRLEN(strregname) > 1)
11101 {
11102 semsg(_(e_register_name_must_be_one_char_str), strregname);
11103 return;
11104 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011105 regname = *strregname;
11106 if (regname == 0 || regname == '@')
11107 regname = '"';
11108
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011109 if (argvars[1].v_type == VAR_DICT)
11110 {
11111 dict_T *d = argvars[1].vval.v_dict;
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011112 dictitem_T *di;
11113
11114 if (d == NULL || d->dv_hashtab.ht_used == 0)
11115 {
11116 // Empty dict, clear the register (like setreg(0, []))
11117 char_u *lstval[2] = {NULL, NULL};
11118 write_reg_contents_lst(regname, lstval, 0, FALSE, MAUTO, -1);
11119 return;
11120 }
11121
11122 di = dict_find(d, (char_u *)"regcontents", -1);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011123 if (di != NULL)
11124 regcontents = &di->di_tv;
11125
Bram Moolenaard61efa52022-07-23 09:52:04 +010011126 stropt = dict_get_string(d, "regtype", FALSE);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011127 if (stropt != NULL)
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011128 {
11129 int ret = get_yank_type(&stropt, &yank_type, &block_len);
11130
11131 if (ret == FAIL || *++stropt != NUL)
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011132 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000011133 semsg(_(e_invalid_value_for_argument_str), "value");
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011134 return;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011135 }
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011136 }
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011137
11138 if (regname == '"')
11139 {
Bram Moolenaard61efa52022-07-23 09:52:04 +010011140 stropt = dict_get_string(d, "points_to", FALSE);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011141 if (stropt != NULL)
11142 {
11143 pointreg = *stropt;
11144 regname = pointreg;
11145 }
11146 }
Bram Moolenaard61efa52022-07-23 09:52:04 +010011147 else if (dict_get_bool(d, "isunnamed", -1) > 0)
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011148 pointreg = regname;
11149 }
11150 else
11151 regcontents = &argvars[1];
11152
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011153 if (argvars[2].v_type != VAR_UNKNOWN)
11154 {
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011155 if (yank_type != MAUTO)
11156 {
Bram Moolenaare1242042021-12-16 20:56:57 +000011157 semsg(_(e_too_many_arguments_for_function_str), "setreg");
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011158 return;
11159 }
11160
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011161 stropt = tv_get_string_chk(&argvars[2]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011162 if (stropt == NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011163 return; // type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011164 for (; *stropt != NUL; ++stropt)
11165 switch (*stropt)
11166 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011167 case 'a': case 'A': // append
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011168 append = TRUE;
11169 break;
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011170 default:
11171 get_yank_type(&stropt, &yank_type, &block_len);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011172 }
11173 }
11174
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011175 if (regcontents && regcontents->v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011176 {
11177 char_u **lstval;
11178 char_u **allocval;
11179 char_u buf[NUMBUFLEN];
11180 char_u **curval;
11181 char_u **curallocval;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011182 list_T *ll = regcontents->vval.v_list;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011183 listitem_T *li;
11184 int len;
11185
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011186 // If the list is NULL handle like an empty list.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011187 len = ll == NULL ? 0 : ll->lv_len;
11188
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011189 // First half: use for pointers to result lines; second half: use for
11190 // pointers to allocated copies.
Bram Moolenaarc799fe22019-05-28 23:08:19 +020011191 lstval = ALLOC_MULT(char_u *, (len + 1) * 2);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011192 if (lstval == NULL)
11193 return;
11194 curval = lstval;
11195 allocval = lstval + len + 2;
11196 curallocval = allocval;
11197
Bram Moolenaar50985eb2020-01-27 22:09:39 +010011198 if (ll != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011199 {
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020011200 CHECK_LIST_MATERIALIZE(ll);
Bram Moolenaar00d253e2020-04-06 22:13:01 +020011201 FOR_ALL_LIST_ITEMS(ll, li)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011202 {
Bram Moolenaar50985eb2020-01-27 22:09:39 +010011203 strval = tv_get_string_buf_chk(&li->li_tv, buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011204 if (strval == NULL)
11205 goto free_lstval;
Bram Moolenaar50985eb2020-01-27 22:09:39 +010011206 if (strval == buf)
11207 {
11208 // Need to make a copy, next tv_get_string_buf_chk() will
11209 // overwrite the string.
11210 strval = vim_strsave(buf);
11211 if (strval == NULL)
11212 goto free_lstval;
11213 *curallocval++ = strval;
11214 }
11215 *curval++ = strval;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011216 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011217 }
11218 *curval++ = NULL;
11219
11220 write_reg_contents_lst(regname, lstval, -1,
11221 append, yank_type, block_len);
11222free_lstval:
11223 while (curallocval > allocval)
11224 vim_free(*--curallocval);
11225 vim_free(lstval);
11226 }
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011227 else if (regcontents)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011228 {
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011229 strval = tv_get_string_chk(regcontents);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011230 if (strval == NULL)
11231 return;
11232 write_reg_contents_ex(regname, strval, -1,
11233 append, yank_type, block_len);
11234 }
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011235 if (pointreg != 0)
11236 get_yank_register(pointreg, TRUE);
11237
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011238 rettv->vval.v_number = 0;
11239}
11240
11241/*
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011242 * "settagstack()" function
11243 */
11244 static void
11245f_settagstack(typval_T *argvars, typval_T *rettv)
11246{
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011247 win_T *wp;
11248 dict_T *d;
11249 int action = 'r';
11250
11251 rettv->vval.v_number = -1;
11252
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011253 if (in_vim9script()
11254 && (check_for_number_arg(argvars, 0) == FAIL
11255 || check_for_dict_arg(argvars, 1) == FAIL
11256 || check_for_opt_string_arg(argvars, 2) == FAIL))
11257 return;
11258
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011259 // first argument: window number or id
11260 wp = find_win_by_nr_or_id(&argvars[0]);
11261 if (wp == NULL)
11262 return;
11263
11264 // second argument: dict with items to set in the tag stack
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +010011265 if (check_for_dict_arg(argvars, 1) == FAIL)
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011266 return;
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011267 d = argvars[1].vval.v_dict;
11268 if (d == NULL)
11269 return;
11270
11271 // third argument: action - 'a' for append and 'r' for replace.
11272 // default is to replace the stack.
11273 if (argvars[2].v_type == VAR_UNKNOWN)
11274 action = 'r';
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +010011275 else if (check_for_string_arg(argvars, 2) == FAIL)
11276 return;
11277 else
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011278 {
11279 char_u *actstr;
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011280 actstr = tv_get_string_chk(&argvars[2]);
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011281 if (actstr == NULL)
11282 return;
Bram Moolenaar271fa082020-01-02 14:02:16 +010011283 if ((*actstr == 'r' || *actstr == 'a' || *actstr == 't')
11284 && actstr[1] == NUL)
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011285 action = *actstr;
11286 else
11287 {
Bram Moolenaard82a47d2022-01-05 20:24:39 +000011288 semsg(_(e_invalid_action_str_2), actstr);
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011289 return;
11290 }
11291 }
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011292
11293 if (set_tagstack(wp, d, action) == OK)
11294 rettv->vval.v_number = 0;
11295}
11296
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011297#ifdef FEAT_CRYPT
11298/*
11299 * "sha256({string})" function
11300 */
11301 static void
11302f_sha256(typval_T *argvars, typval_T *rettv)
11303{
11304 char_u *p;
11305
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011306 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11307 return;
11308
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011309 p = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011310 rettv->vval.v_string = vim_strsave(
11311 sha256_bytes(p, (int)STRLEN(p), NULL, 0));
11312 rettv->v_type = VAR_STRING;
11313}
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011314#endif // FEAT_CRYPT
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011315
11316/*
11317 * "shellescape({string})" function
11318 */
11319 static void
11320f_shellescape(typval_T *argvars, typval_T *rettv)
11321{
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011322 int do_special;
Bram Moolenaar20615522017-06-05 18:46:26 +020011323
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011324 if (in_vim9script()
11325 && (check_for_string_arg(argvars, 0) == FAIL
11326 || check_for_opt_bool_arg(argvars, 1) == FAIL))
11327 return;
11328
11329 do_special = non_zero_arg(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011330 rettv->vval.v_string = vim_strsave_shellescape(
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011331 tv_get_string(&argvars[0]), do_special, do_special);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011332 rettv->v_type = VAR_STRING;
11333}
11334
11335/*
11336 * shiftwidth() function
11337 */
11338 static void
11339f_shiftwidth(typval_T *argvars UNUSED, typval_T *rettv)
11340{
Bram Moolenaarf9514162018-11-22 03:08:29 +010011341 rettv->vval.v_number = 0;
11342
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011343 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
11344 return;
11345
Bram Moolenaarf9514162018-11-22 03:08:29 +010011346 if (argvars[0].v_type != VAR_UNKNOWN)
11347 {
11348 long col;
11349
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011350 col = (long)tv_get_number_chk(argvars, NULL);
Bram Moolenaarf9514162018-11-22 03:08:29 +010011351 if (col < 0)
11352 return; // type error; errmsg already given
11353#ifdef FEAT_VARTABS
Gary Johnson88d4f252024-06-01 20:51:33 +020011354 rettv->vval.v_number = get_sw_value_col(curbuf, col, FALSE);
Bram Moolenaarf9514162018-11-22 03:08:29 +010011355 return;
11356#endif
11357 }
11358
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011359 rettv->vval.v_number = get_sw_value(curbuf);
11360}
11361
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011362/*
11363 * "soundfold({word})" function
11364 */
11365 static void
11366f_soundfold(typval_T *argvars, typval_T *rettv)
11367{
11368 char_u *s;
11369
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011370 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11371 return;
11372
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011373 rettv->v_type = VAR_STRING;
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011374 s = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011375#ifdef FEAT_SPELL
11376 rettv->vval.v_string = eval_soundfold(s);
11377#else
11378 rettv->vval.v_string = vim_strsave(s);
11379#endif
11380}
11381
11382/*
11383 * "spellbadword()" function
11384 */
11385 static void
11386f_spellbadword(typval_T *argvars UNUSED, typval_T *rettv)
11387{
11388 char_u *word = (char_u *)"";
11389 hlf_T attr = HLF_COUNT;
11390 int len = 0;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011391#ifdef FEAT_SPELL
11392 int wo_spell_save = curwin->w_p_spell;
11393
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011394 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
11395 return;
11396
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011397 if (!curwin->w_p_spell)
11398 {
Yegappan Lakshmananaf936912023-02-20 12:16:39 +000011399 parse_spelllang(curwin);
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011400 curwin->w_p_spell = TRUE;
11401 }
11402
11403 if (*curwin->w_s->b_p_spl == NUL)
11404 {
Bram Moolenaar460ae5d2022-01-01 14:19:49 +000011405 emsg(_(e_spell_checking_is_not_possible));
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011406 curwin->w_p_spell = wo_spell_save;
11407 return;
11408 }
11409#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011410
11411 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011412 {
11413#ifdef FEAT_SPELL
11414 curwin->w_p_spell = wo_spell_save;
11415#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011416 return;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011417 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011418
11419#ifdef FEAT_SPELL
11420 if (argvars[0].v_type == VAR_UNKNOWN)
11421 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011422 // Find the start and length of the badly spelled word.
Christ van Willegen - van Noort8e4c4c72024-05-17 18:49:27 +020011423 len = spell_move_to(curwin, FORWARD, SMT_ALL, TRUE, &attr);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011424 if (len != 0)
Bram Moolenaarb73fa622017-12-21 20:27:47 +010011425 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011426 word = ml_get_cursor();
Bram Moolenaarb73fa622017-12-21 20:27:47 +010011427 curwin->w_set_curswant = TRUE;
11428 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011429 }
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011430 else if (*curbuf->b_s.b_p_spl != NUL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011431 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011432 char_u *str = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011433 int capcol = -1;
11434
11435 if (str != NULL)
11436 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011437 // Check the argument for spelling.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011438 while (*str != NUL)
11439 {
11440 len = spell_check(curwin, str, &attr, &capcol, FALSE);
11441 if (attr != HLF_COUNT)
11442 {
11443 word = str;
11444 break;
11445 }
11446 str += len;
Bram Moolenaar66ab9162018-07-20 20:28:48 +020011447 capcol -= len;
Bram Moolenaar0c779e82019-08-09 17:01:02 +020011448 len = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011449 }
11450 }
11451 }
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011452 curwin->w_p_spell = wo_spell_save;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011453#endif
11454
11455 list_append_string(rettv->vval.v_list, word, len);
11456 list_append_string(rettv->vval.v_list, (char_u *)(
11457 attr == HLF_SPB ? "bad" :
11458 attr == HLF_SPR ? "rare" :
11459 attr == HLF_SPL ? "local" :
11460 attr == HLF_SPC ? "caps" :
11461 ""), -1);
11462}
11463
11464/*
11465 * "spellsuggest()" function
11466 */
11467 static void
11468f_spellsuggest(typval_T *argvars UNUSED, typval_T *rettv)
11469{
11470#ifdef FEAT_SPELL
11471 char_u *str;
11472 int typeerr = FALSE;
11473 int maxcount;
11474 garray_T ga;
11475 int i;
11476 listitem_T *li;
11477 int need_capital = FALSE;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011478 int wo_spell_save = curwin->w_p_spell;
11479
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011480 if (in_vim9script()
11481 && (check_for_string_arg(argvars, 0) == FAIL
11482 || check_for_opt_number_arg(argvars, 1) == FAIL
11483 || (argvars[1].v_type != VAR_UNKNOWN
11484 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
11485 return;
11486
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011487 if (!curwin->w_p_spell)
11488 {
Yegappan Lakshmananaf936912023-02-20 12:16:39 +000011489 parse_spelllang(curwin);
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011490 curwin->w_p_spell = TRUE;
11491 }
11492
11493 if (*curwin->w_s->b_p_spl == NUL)
11494 {
Bram Moolenaar460ae5d2022-01-01 14:19:49 +000011495 emsg(_(e_spell_checking_is_not_possible));
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011496 curwin->w_p_spell = wo_spell_save;
11497 return;
11498 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011499#endif
11500
11501 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011502 {
11503#ifdef FEAT_SPELL
11504 curwin->w_p_spell = wo_spell_save;
11505#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011506 return;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011507 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011508
11509#ifdef FEAT_SPELL
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011510 str = tv_get_string(&argvars[0]);
11511 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011512 {
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011513 maxcount = (int)tv_get_number_chk(&argvars[1], &typeerr);
11514 if (maxcount <= 0)
11515 return;
11516 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011517 {
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011518 need_capital = (int)tv_get_bool_chk(&argvars[2], &typeerr);
11519 if (typeerr)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011520 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011521 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011522 }
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011523 else
11524 maxcount = 25;
11525
11526 spell_suggest_list(&ga, str, maxcount, need_capital, FALSE);
11527
11528 for (i = 0; i < ga.ga_len; ++i)
11529 {
11530 str = ((char_u **)ga.ga_data)[i];
11531
11532 li = listitem_alloc();
11533 if (li == NULL)
11534 vim_free(str);
11535 else
11536 {
11537 li->li_tv.v_type = VAR_STRING;
11538 li->li_tv.v_lock = 0;
11539 li->li_tv.vval.v_string = str;
11540 list_append(rettv->vval.v_list, li);
11541 }
11542 }
11543 ga_clear(&ga);
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011544 curwin->w_p_spell = wo_spell_save;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011545#endif
11546}
11547
11548 static void
11549f_split(typval_T *argvars, typval_T *rettv)
11550{
11551 char_u *str;
11552 char_u *end;
11553 char_u *pat = NULL;
11554 regmatch_T regmatch;
11555 char_u patbuf[NUMBUFLEN];
11556 char_u *save_cpo;
11557 int match;
11558 colnr_T col = 0;
11559 int keepempty = FALSE;
11560 int typeerr = FALSE;
11561
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011562 if (in_vim9script()
11563 && (check_for_string_arg(argvars, 0) == FAIL
11564 || check_for_opt_string_arg(argvars, 1) == FAIL
11565 || (argvars[1].v_type != VAR_UNKNOWN
11566 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
11567 return;
11568
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011569 // Make 'cpoptions' empty, the 'l' flag should not be used here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011570 save_cpo = p_cpo;
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010011571 p_cpo = empty_option;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011572
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011573 str = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011574 if (argvars[1].v_type != VAR_UNKNOWN)
11575 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011576 pat = tv_get_string_buf_chk(&argvars[1], patbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011577 if (pat == NULL)
11578 typeerr = TRUE;
11579 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar3986b942020-09-06 16:09:04 +020011580 keepempty = (int)tv_get_bool_chk(&argvars[2], &typeerr);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011581 }
11582 if (pat == NULL || *pat == NUL)
11583 pat = (char_u *)"[\\x01- ]\\+";
11584
11585 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar7d5e7442020-07-21 22:25:51 +020011586 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011587 if (typeerr)
Bram Moolenaar7d5e7442020-07-21 22:25:51 +020011588 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011589
11590 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
11591 if (regmatch.regprog != NULL)
11592 {
11593 regmatch.rm_ic = FALSE;
11594 while (*str != NUL || keepempty)
11595 {
11596 if (*str == NUL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011597 match = FALSE; // empty item at the end
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011598 else
11599 match = vim_regexec_nl(&regmatch, str, col);
11600 if (match)
11601 end = regmatch.startp[0];
11602 else
11603 end = str + STRLEN(str);
11604 if (keepempty || end > str || (rettv->vval.v_list->lv_len > 0
11605 && *str != NUL && match && end < regmatch.endp[0]))
11606 {
11607 if (list_append_string(rettv->vval.v_list, str,
11608 (int)(end - str)) == FAIL)
11609 break;
11610 }
11611 if (!match)
11612 break;
Bram Moolenaar13505972019-01-24 15:04:48 +010011613 // Advance to just after the match.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011614 if (regmatch.endp[0] > str)
11615 col = 0;
11616 else
Bram Moolenaar13505972019-01-24 15:04:48 +010011617 // Don't get stuck at the same match.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011618 col = (*mb_ptr2len)(regmatch.endp[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011619 str = regmatch.endp[0];
11620 }
11621
11622 vim_regfree(regmatch.regprog);
11623 }
11624
Bram Moolenaar7d5e7442020-07-21 22:25:51 +020011625theend:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011626 p_cpo = save_cpo;
11627}
11628
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011629/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011630 * "submatch()" function
11631 */
11632 static void
11633f_submatch(typval_T *argvars, typval_T *rettv)
11634{
11635 int error = FALSE;
11636 int no;
11637 int retList = 0;
11638
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011639 if (in_vim9script()
11640 && (check_for_number_arg(argvars, 0) == FAIL
11641 || check_for_opt_bool_arg(argvars, 1) == FAIL))
11642 return;
11643
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011644 no = (int)tv_get_number_chk(&argvars[0], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011645 if (error)
11646 return;
Bram Moolenaar989f5922016-08-21 15:26:54 +020011647 if (no < 0 || no >= NSUBEXP)
11648 {
Bram Moolenaard82a47d2022-01-05 20:24:39 +000011649 semsg(_(e_invalid_submatch_number_nr), no);
Bram Moolenaar79518e22017-02-17 16:31:35 +010011650 return;
Bram Moolenaar989f5922016-08-21 15:26:54 +020011651 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011652 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaarad304702020-09-06 18:22:53 +020011653 retList = (int)tv_get_bool_chk(&argvars[1], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011654 if (error)
11655 return;
11656
11657 if (retList == 0)
11658 {
11659 rettv->v_type = VAR_STRING;
11660 rettv->vval.v_string = reg_submatch(no);
11661 }
11662 else
11663 {
11664 rettv->v_type = VAR_LIST;
11665 rettv->vval.v_list = reg_submatch_list(no);
11666 }
11667}
11668
11669/*
11670 * "substitute()" function
11671 */
11672 static void
11673f_substitute(typval_T *argvars, typval_T *rettv)
11674{
11675 char_u patbuf[NUMBUFLEN];
11676 char_u subbuf[NUMBUFLEN];
11677 char_u flagsbuf[NUMBUFLEN];
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +020011678 char_u *str;
11679 char_u *pat;
Bram Moolenaar72ab7292016-07-19 19:10:51 +020011680 char_u *sub = NULL;
11681 typval_T *expr = NULL;
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +020011682 char_u *flg;
11683
11684 if (in_vim9script()
11685 && (check_for_string_arg(argvars, 0) == FAIL
11686 || check_for_string_arg(argvars, 1) == FAIL
11687 || check_for_string_arg(argvars, 3) == FAIL))
11688 return;
11689
11690 str = tv_get_string_chk(&argvars[0]);
11691 pat = tv_get_string_buf_chk(&argvars[1], patbuf);
11692 flg = tv_get_string_buf_chk(&argvars[3], flagsbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011693
LemonBoyf3b48952022-05-05 13:53:03 +010011694 if (argvars[2].v_type == VAR_FUNC
11695 || argvars[2].v_type == VAR_PARTIAL
Bram Moolenaar00b28d62022-12-08 15:32:33 +000011696 || argvars[2].v_type == VAR_INSTR
11697 || argvars[2].v_type == VAR_CLASS
11698 || argvars[2].v_type == VAR_OBJECT)
Bram Moolenaar72ab7292016-07-19 19:10:51 +020011699 expr = &argvars[2];
11700 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011701 sub = tv_get_string_buf_chk(&argvars[2], subbuf);
Bram Moolenaar72ab7292016-07-19 19:10:51 +020011702
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011703 rettv->v_type = VAR_STRING;
Bram Moolenaar72ab7292016-07-19 19:10:51 +020011704 if (str == NULL || pat == NULL || (sub == NULL && expr == NULL)
11705 || flg == NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011706 rettv->vval.v_string = NULL;
11707 else
John Marriottbd4614f2024-11-18 20:25:21 +010011708 rettv->vval.v_string = do_string_sub(str, STRLEN(str), pat, sub, expr, flg, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011709}
11710
11711/*
Bram Moolenaarc216a7a2022-12-05 13:50:55 +000011712 * "swapfilelist()" function
11713 */
11714 static void
11715f_swapfilelist(typval_T *argvars UNUSED, typval_T *rettv)
11716{
11717 if (rettv_list_alloc(rettv) == FAIL)
11718 return;
11719 recover_names(NULL, FALSE, rettv->vval.v_list, 0, NULL);
11720}
11721
11722/*
Bram Moolenaar00f123a2018-08-21 20:28:54 +020011723 * "swapinfo(swap_filename)" function
11724 */
11725 static void
11726f_swapinfo(typval_T *argvars, typval_T *rettv)
11727{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011728 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11729 return;
11730
Bram Moolenaar00f123a2018-08-21 20:28:54 +020011731 if (rettv_dict_alloc(rettv) == OK)
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011732 get_b0_dict(tv_get_string(argvars), rettv->vval.v_dict);
Bram Moolenaar00f123a2018-08-21 20:28:54 +020011733}
11734
11735/*
Bram Moolenaar110bd602018-09-16 18:46:59 +020011736 * "swapname(expr)" function
11737 */
11738 static void
11739f_swapname(typval_T *argvars, typval_T *rettv)
11740{
11741 buf_T *buf;
11742
11743 rettv->v_type = VAR_STRING;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011744
11745 if (in_vim9script() && check_for_buffer_arg(argvars, 0) == FAIL)
11746 return;
11747
Bram Moolenaarf2d79fa2019-01-03 22:19:27 +010011748 buf = tv_get_buf(&argvars[0], FALSE);
Bram Moolenaar110bd602018-09-16 18:46:59 +020011749 if (buf == NULL || buf->b_ml.ml_mfp == NULL
11750 || buf->b_ml.ml_mfp->mf_fname == NULL)
11751 rettv->vval.v_string = NULL;
11752 else
11753 rettv->vval.v_string = vim_strsave(buf->b_ml.ml_mfp->mf_fname);
11754}
11755
11756/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011757 * "synID(lnum, col, trans)" function
11758 */
11759 static void
11760f_synID(typval_T *argvars UNUSED, typval_T *rettv)
11761{
11762 int id = 0;
11763#ifdef FEAT_SYN_HL
11764 linenr_T lnum;
11765 colnr_T col;
11766 int trans;
11767 int transerr = FALSE;
11768
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011769 if (in_vim9script()
Yegappan Lakshmanancd917202021-07-21 19:09:09 +020011770 && (check_for_lnum_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011771 || check_for_number_arg(argvars, 1) == FAIL
11772 || check_for_bool_arg(argvars, 2) == FAIL))
11773 return;
11774
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011775 lnum = tv_get_lnum(argvars); // -1 on type error
11776 col = (linenr_T)tv_get_number(&argvars[1]) - 1; // -1 on type error
Bram Moolenaarfcb6d702020-09-05 21:41:56 +020011777 trans = (int)tv_get_bool_chk(&argvars[2], &transerr);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011778
11779 if (!transerr && lnum >= 1 && lnum <= curbuf->b_ml.ml_line_count
John Marriottbfcc8952024-03-11 22:04:45 +010011780 && col >= 0 && col < (long)ml_get_len(lnum))
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +000011781 id = syn_get_id(curwin, lnum, col, trans, NULL, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011782#endif
11783
11784 rettv->vval.v_number = id;
11785}
11786
11787/*
11788 * "synIDattr(id, what [, mode])" function
11789 */
11790 static void
11791f_synIDattr(typval_T *argvars UNUSED, typval_T *rettv)
11792{
11793 char_u *p = NULL;
11794#ifdef FEAT_SYN_HL
11795 int id;
11796 char_u *what;
11797 char_u *mode;
11798 char_u modebuf[NUMBUFLEN];
11799 int modec;
11800
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +020011801 if (in_vim9script()
11802 && (check_for_number_arg(argvars, 0) == FAIL
Yegappan Lakshmananf8dbd582021-09-26 19:04:05 +010011803 || check_for_string_arg(argvars, 1) == FAIL
11804 || check_for_opt_string_arg(argvars, 2) == FAIL))
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +020011805 return;
11806
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011807 id = (int)tv_get_number(&argvars[0]);
11808 what = tv_get_string(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011809 if (argvars[2].v_type != VAR_UNKNOWN)
11810 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011811 mode = tv_get_string_buf(&argvars[2], modebuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011812 modec = TOLOWER_ASC(mode[0]);
11813 if (modec != 't' && modec != 'c' && modec != 'g')
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011814 modec = 0; // replace invalid with current
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011815 }
11816 else
11817 {
11818#if defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS)
11819 if (USE_24BIT)
11820 modec = 'g';
11821 else
11822#endif
11823 if (t_colors > 1)
Dominique Pelle4781d6f2021-05-18 21:46:31 +020011824 modec = 'c';
11825 else
11826 modec = 't';
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011827 }
11828
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011829 switch (TOLOWER_ASC(what[0]))
11830 {
11831 case 'b':
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011832 if (TOLOWER_ASC(what[1]) == 'g') // bg[#]
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011833 p = highlight_color(id, what, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011834 else // bold
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011835 p = highlight_has_attr(id, HL_BOLD, modec);
11836 break;
11837
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011838 case 'f': // fg[#] or font
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011839 p = highlight_color(id, what, modec);
11840 break;
11841
11842 case 'i':
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011843 if (TOLOWER_ASC(what[1]) == 'n') // inverse
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011844 p = highlight_has_attr(id, HL_INVERSE, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011845 else // italic
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011846 p = highlight_has_attr(id, HL_ITALIC, modec);
11847 break;
11848
Martin Tournoijba43e762022-10-13 22:12:15 +010011849 case 'n':
Bram Moolenaarde786322022-07-30 14:56:17 +010011850 if (TOLOWER_ASC(what[1]) == 'o') // nocombine
11851 p = highlight_has_attr(id, HL_NOCOMBINE, modec);
11852 else // name
11853 p = get_highlight_name_ext(NULL, id - 1, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011854 break;
11855
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011856 case 'r': // reverse
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011857 p = highlight_has_attr(id, HL_INVERSE, modec);
11858 break;
11859
11860 case 's':
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011861 if (TOLOWER_ASC(what[1]) == 'p') // sp[#]
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011862 p = highlight_color(id, what, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011863 // strikeout
Bram Moolenaarcf4b00c2017-09-02 18:33:56 +020011864 else if (TOLOWER_ASC(what[1]) == 't' &&
11865 TOLOWER_ASC(what[2]) == 'r')
11866 p = highlight_has_attr(id, HL_STRIKETHROUGH, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011867 else // standout
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011868 p = highlight_has_attr(id, HL_STANDOUT, modec);
11869 break;
11870
11871 case 'u':
Bram Moolenaar84f54632022-06-29 18:39:11 +010011872 if (STRLEN(what) >= 9)
11873 {
11874 if (TOLOWER_ASC(what[5]) == 'l')
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011875 // underline
Bram Moolenaar84f54632022-06-29 18:39:11 +010011876 p = highlight_has_attr(id, HL_UNDERLINE, modec);
11877 else if (TOLOWER_ASC(what[5]) != 'd')
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011878 // undercurl
Bram Moolenaar84f54632022-06-29 18:39:11 +010011879 p = highlight_has_attr(id, HL_UNDERCURL, modec);
11880 else if (TOLOWER_ASC(what[6]) != 'o')
11881 // underdashed
11882 p = highlight_has_attr(id, HL_UNDERDASHED, modec);
11883 else if (TOLOWER_ASC(what[7]) == 'u')
11884 // underdouble
11885 p = highlight_has_attr(id, HL_UNDERDOUBLE, modec);
11886 else
11887 // underdotted
11888 p = highlight_has_attr(id, HL_UNDERDOTTED, modec);
11889 }
11890 else
11891 // ul
11892 p = highlight_color(id, what, modec);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011893 break;
11894 }
11895
11896 if (p != NULL)
11897 p = vim_strsave(p);
11898#endif
11899 rettv->v_type = VAR_STRING;
11900 rettv->vval.v_string = p;
11901}
11902
11903/*
11904 * "synIDtrans(id)" function
11905 */
11906 static void
11907f_synIDtrans(typval_T *argvars UNUSED, typval_T *rettv)
11908{
11909 int id;
11910
11911#ifdef FEAT_SYN_HL
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011912 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
11913 return;
11914
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011915 id = (int)tv_get_number(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011916
11917 if (id > 0)
11918 id = syn_get_final_id(id);
11919 else
11920#endif
11921 id = 0;
11922
11923 rettv->vval.v_number = id;
11924}
11925
11926/*
11927 * "synconcealed(lnum, col)" function
11928 */
11929 static void
11930f_synconcealed(typval_T *argvars UNUSED, typval_T *rettv)
11931{
11932#if defined(FEAT_SYN_HL) && defined(FEAT_CONCEAL)
11933 linenr_T lnum;
11934 colnr_T col;
11935 int syntax_flags = 0;
11936 int cchar;
11937 int matchid = 0;
11938 char_u str[NUMBUFLEN];
11939#endif
11940
Bram Moolenaar45cf6e92017-04-30 20:25:19 +020011941 rettv_list_set(rettv, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011942
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020011943 if (in_vim9script()
Yegappan Lakshmanancd917202021-07-21 19:09:09 +020011944 && (check_for_lnum_arg(argvars, 0) == FAIL
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020011945 || check_for_number_arg(argvars, 1) == FAIL))
11946 return;
11947
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011948#if defined(FEAT_SYN_HL) && defined(FEAT_CONCEAL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011949 lnum = tv_get_lnum(argvars); // -1 on type error
11950 col = (colnr_T)tv_get_number(&argvars[1]) - 1; // -1 on type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011951
Bram Moolenaara80faa82020-04-12 19:37:17 +020011952 CLEAR_FIELD(str);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011953
Bram Moolenaar93a10962022-06-16 11:42:09 +010011954 if (rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011955 {
11956 if (lnum >= 1 && lnum <= curbuf->b_ml.ml_line_count
John Marriottbfcc8952024-03-11 22:04:45 +010011957 && col >= 0 && col <= (long)ml_get_len(lnum)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011958 && curwin->w_p_cole > 0)
11959 {
11960 (void)syn_get_id(curwin, lnum, col, FALSE, NULL, FALSE);
11961 syntax_flags = get_syntax_info(&matchid);
11962
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011963 // get the conceal character
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011964 if ((syntax_flags & HL_CONCEAL) && curwin->w_p_cole < 3)
11965 {
11966 cchar = syn_get_sub_char();
Bram Moolenaar4d785892017-06-22 22:00:50 +020011967 if (cchar == NUL && curwin->w_p_cole == 1)
Bram Moolenaareed9d462021-02-15 20:38:25 +010011968 cchar = (curwin->w_lcs_chars.conceal == NUL) ? ' '
11969 : curwin->w_lcs_chars.conceal;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011970 if (cchar != NUL)
11971 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011972 if (has_mbyte)
11973 (*mb_char2bytes)(cchar, str);
11974 else
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011975 str[0] = cchar;
11976 }
11977 }
11978 }
11979
11980 list_append_number(rettv->vval.v_list,
11981 (syntax_flags & HL_CONCEAL) != 0);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011982 // -1 to auto-determine strlen
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011983 list_append_string(rettv->vval.v_list, str, -1);
11984 list_append_number(rettv->vval.v_list, matchid);
11985 }
11986#endif
11987}
11988
11989/*
11990 * "synstack(lnum, col)" function
11991 */
11992 static void
11993f_synstack(typval_T *argvars UNUSED, typval_T *rettv)
11994{
11995#ifdef FEAT_SYN_HL
11996 linenr_T lnum;
11997 colnr_T col;
11998 int i;
11999 int id;
12000#endif
12001
Bram Moolenaar45cf6e92017-04-30 20:25:19 +020012002 rettv_list_set(rettv, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012003
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020012004 if (in_vim9script()
Yegappan Lakshmanancd917202021-07-21 19:09:09 +020012005 && (check_for_lnum_arg(argvars, 0) == FAIL
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020012006 || check_for_number_arg(argvars, 1) == FAIL))
12007 return;
12008
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012009#ifdef FEAT_SYN_HL
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012010 lnum = tv_get_lnum(argvars); // -1 on type error
12011 col = (colnr_T)tv_get_number(&argvars[1]) - 1; // -1 on type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012012
12013 if (lnum >= 1 && lnum <= curbuf->b_ml.ml_line_count
John Marriottbfcc8952024-03-11 22:04:45 +010012014 && col >= 0 && col <= (long)ml_get_len(lnum)
Bram Moolenaar93a10962022-06-16 11:42:09 +010012015 && rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012016 {
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +000012017 (void)syn_get_id(curwin, lnum, col, FALSE, NULL, TRUE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012018 for (i = 0; ; ++i)
12019 {
12020 id = syn_get_stack_item(i);
12021 if (id < 0)
12022 break;
12023 if (list_append_number(rettv->vval.v_list, id) == FAIL)
12024 break;
12025 }
12026 }
12027#endif
12028}
12029
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012030/*
12031 * "tabpagebuflist()" function
12032 */
12033 static void
12034f_tabpagebuflist(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
12035{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012036 tabpage_T *tp;
12037 win_T *wp = NULL;
12038
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012039 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
12040 return;
12041
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012042 if (argvars[0].v_type == VAR_UNKNOWN)
12043 wp = firstwin;
12044 else
12045 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012046 tp = find_tabpage((int)tv_get_number(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012047 if (tp != NULL)
12048 wp = (tp == curtab) ? firstwin : tp->tp_firstwin;
12049 }
Bram Moolenaar93a10962022-06-16 11:42:09 +010012050 if (wp != NULL && rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012051 {
12052 for (; wp != NULL; wp = wp->w_next)
12053 if (list_append_number(rettv->vval.v_list,
12054 wp->w_buffer->b_fnum) == FAIL)
12055 break;
12056 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012057}
12058
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012059/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012060 * "tagfiles()" function
12061 */
12062 static void
12063f_tagfiles(typval_T *argvars UNUSED, typval_T *rettv)
12064{
12065 char_u *fname;
12066 tagname_T tn;
12067 int first;
12068
12069 if (rettv_list_alloc(rettv) == FAIL)
12070 return;
12071 fname = alloc(MAXPATHL);
12072 if (fname == NULL)
12073 return;
12074
12075 for (first = TRUE; ; first = FALSE)
12076 if (get_tagfname(&tn, first, fname) == FAIL
12077 || list_append_string(rettv->vval.v_list, fname, -1) == FAIL)
12078 break;
12079 tagname_free(&tn);
12080 vim_free(fname);
12081}
12082
12083/*
12084 * "taglist()" function
12085 */
12086 static void
12087f_taglist(typval_T *argvars, typval_T *rettv)
12088{
Bram Moolenaarc6aafba2017-03-21 17:09:10 +010012089 char_u *fname = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012090 char_u *tag_pattern;
12091
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012092 if (in_vim9script()
12093 && (check_for_string_arg(argvars, 0) == FAIL
12094 || check_for_opt_string_arg(argvars, 1) == FAIL))
12095 return;
12096
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012097 tag_pattern = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012098
12099 rettv->vval.v_number = FALSE;
12100 if (*tag_pattern == NUL)
12101 return;
12102
Bram Moolenaarc6aafba2017-03-21 17:09:10 +010012103 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012104 fname = tv_get_string(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012105 if (rettv_list_alloc(rettv) == OK)
Bram Moolenaarc6aafba2017-03-21 17:09:10 +010012106 (void)get_tags(rettv->vval.v_list, tag_pattern, fname);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012107}
12108
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012109/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012110 * "type(expr)" function
12111 */
12112 static void
12113f_type(typval_T *argvars, typval_T *rettv)
12114{
12115 int n = -1;
12116
12117 switch (argvars[0].v_type)
12118 {
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +010012119 case VAR_NUMBER: n = VAR_TYPE_NUMBER; break;
12120 case VAR_STRING: n = VAR_TYPE_STRING; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012121 case VAR_PARTIAL:
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +010012122 case VAR_FUNC: n = VAR_TYPE_FUNC; break;
12123 case VAR_LIST: n = VAR_TYPE_LIST; break;
12124 case VAR_DICT: n = VAR_TYPE_DICT; break;
12125 case VAR_FLOAT: n = VAR_TYPE_FLOAT; break;
12126 case VAR_BOOL: n = VAR_TYPE_BOOL; break;
12127 case VAR_SPECIAL: n = VAR_TYPE_NONE; break;
Bram Moolenaarf562e722016-07-19 17:25:25 +020012128 case VAR_JOB: n = VAR_TYPE_JOB; break;
12129 case VAR_CHANNEL: n = VAR_TYPE_CHANNEL; break;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +010012130 case VAR_BLOB: n = VAR_TYPE_BLOB; break;
Bram Moolenaarf18332f2021-05-07 17:55:55 +020012131 case VAR_INSTR: n = VAR_TYPE_INSTR; break;
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +020012132 case VAR_TYPEALIAS: n = VAR_TYPE_TYPEALIAS; break;
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012133 case VAR_CLASS:
12134 {
12135 class_T *cl = argvars[0].vval.v_class;
Yegappan Lakshmananda9d3452024-05-02 13:02:36 +020012136 if (cl != NULL && IS_ENUM(cl))
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012137 n = VAR_TYPE_ENUM;
12138 else
12139 n = VAR_TYPE_CLASS;
12140 break;
12141 }
12142 case VAR_OBJECT:
12143 {
Yegappan Lakshmananb2e42b92024-05-01 11:44:17 +020012144 object_T *obj = argvars[0].vval.v_object;
12145
12146 if (obj == NULL)
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012147 n = VAR_TYPE_OBJECT;
Yegappan Lakshmananb2e42b92024-05-01 11:44:17 +020012148 else
12149 {
12150 class_T *cl = argvars[0].vval.v_object->obj_class;
12151 if (IS_ENUM(cl))
12152 n = VAR_TYPE_ENUMVALUE;
12153 else
12154 n = VAR_TYPE_OBJECT;
12155 }
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012156 break;
12157 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012158 case VAR_UNKNOWN:
Bram Moolenaar4c683752020-04-05 21:38:23 +020012159 case VAR_ANY:
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010012160 case VAR_VOID:
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012161 internal_error_no_abort("f_type(UNKNOWN)");
12162 n = -1;
12163 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012164 }
12165 rettv->vval.v_number = n;
12166}
12167
12168/*
zeertzjq825cf812023-08-17 22:55:25 +020012169 * "virtcol({expr}, [, {list} [, {winid}]])" function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012170 */
12171 static void
12172f_virtcol(typval_T *argvars, typval_T *rettv)
12173{
LemonBoy0f7a3e12022-05-26 12:10:37 +010012174 colnr_T vcol_start = 0;
12175 colnr_T vcol_end = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012176 pos_T *fp;
zeertzjq825cf812023-08-17 22:55:25 +020012177 switchwin_T switchwin;
12178 int winchanged = FALSE;
Bram Moolenaarb3d33d82020-01-15 20:36:55 +010012179 int len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012180
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012181 if (in_vim9script()
LemonBoy0f7a3e12022-05-26 12:10:37 +010012182 && (check_for_string_or_list_arg(argvars, 0) == FAIL
12183 || (argvars[1].v_type != VAR_UNKNOWN
zeertzjq825cf812023-08-17 22:55:25 +020012184 && (check_for_bool_arg(argvars, 1) == FAIL
12185 || check_for_opt_number_arg(argvars, 2) == FAIL))))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012186 return;
12187
zeertzjq825cf812023-08-17 22:55:25 +020012188 if (argvars[1].v_type != VAR_UNKNOWN && argvars[2].v_type != VAR_UNKNOWN)
12189 {
12190 tabpage_T *tp;
12191 win_T *wp;
12192
12193 // use the window specified in the third argument
12194 wp = win_id2wp_tp((int)tv_get_number(&argvars[2]), &tp);
12195 if (wp == NULL || tp == NULL)
12196 goto theend;
12197
12198 if (switch_win_noblock(&switchwin, wp, tp, TRUE) != OK)
12199 goto theend;
12200
12201 check_cursor();
12202 winchanged = TRUE;
12203 }
12204
12205 int fnum = curbuf->b_fnum;
Bram Moolenaar6f02b002021-01-10 20:22:54 +010012206 fp = var2fpos(&argvars[0], FALSE, &fnum, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012207 if (fp != NULL && fp->lnum <= curbuf->b_ml.ml_line_count
LemonBoy0f7a3e12022-05-26 12:10:37 +010012208 && fnum == curbuf->b_fnum)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012209 {
Bram Moolenaarb3d33d82020-01-15 20:36:55 +010012210 // Limit the column to a valid value, getvvcol() doesn't check.
12211 if (fp->col < 0)
12212 fp->col = 0;
12213 else
12214 {
John Marriottbfcc8952024-03-11 22:04:45 +010012215 len = (int)ml_get_len(fp->lnum);
Bram Moolenaarb3d33d82020-01-15 20:36:55 +010012216 if (fp->col > len)
12217 fp->col = len;
12218 }
LemonBoy0f7a3e12022-05-26 12:10:37 +010012219 getvvcol(curwin, fp, &vcol_start, NULL, &vcol_end);
12220 ++vcol_start;
12221 ++vcol_end;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012222 }
12223
zeertzjq825cf812023-08-17 22:55:25 +020012224theend:
LemonBoy0f7a3e12022-05-26 12:10:37 +010012225 if (argvars[1].v_type != VAR_UNKNOWN && tv_get_bool(&argvars[1]))
12226 {
12227 if (rettv_list_alloc(rettv) == OK)
12228 {
12229 list_append_number(rettv->vval.v_list, vcol_start);
12230 list_append_number(rettv->vval.v_list, vcol_end);
12231 }
12232 else
12233 rettv->vval.v_number = 0;
12234 }
12235 else
12236 rettv->vval.v_number = vcol_end;
zeertzjq825cf812023-08-17 22:55:25 +020012237
12238 if (winchanged)
12239 restore_win_noblock(&switchwin, TRUE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012240}
12241
12242/*
12243 * "visualmode()" function
12244 */
12245 static void
12246f_visualmode(typval_T *argvars, typval_T *rettv)
12247{
12248 char_u str[2];
12249
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012250 if (in_vim9script() && check_for_opt_bool_arg(argvars, 0) == FAIL)
12251 return;
12252
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012253 rettv->v_type = VAR_STRING;
12254 str[0] = curbuf->b_visual_mode_eval;
12255 str[1] = NUL;
12256 rettv->vval.v_string = vim_strsave(str);
12257
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012258 // A non-zero number or non-empty string argument: reset mode.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012259 if (non_zero_arg(&argvars[0]))
12260 curbuf->b_visual_mode_eval = NUL;
12261}
12262
12263/*
12264 * "wildmenumode()" function
12265 */
12266 static void
12267f_wildmenumode(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
12268{
Bram Moolenaar24959102022-05-07 20:01:16 +010012269 if (wild_menu_showing || ((State & MODE_CMDLINE) && cmdline_pum_active()))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012270 rettv->vval.v_number = 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012271}
12272
12273/*
Bram Moolenaar0c1e3742019-12-27 13:49:24 +010012274 * "windowsversion()" function
12275 */
12276 static void
12277f_windowsversion(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
12278{
12279 rettv->v_type = VAR_STRING;
12280 rettv->vval.v_string = vim_strsave((char_u *)windowsVersion);
12281}
12282
12283/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012284 * "wordcount()" function
12285 */
12286 static void
12287f_wordcount(typval_T *argvars UNUSED, typval_T *rettv)
12288{
12289 if (rettv_dict_alloc(rettv) == FAIL)
12290 return;
12291 cursor_pos_info(rettv->vval.v_dict);
12292}
12293
12294/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012295 * "xor(expr, expr)" function
12296 */
12297 static void
12298f_xor(typval_T *argvars, typval_T *rettv)
12299{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012300 if (in_vim9script()
12301 && (check_for_number_arg(argvars, 0) == FAIL
12302 || check_for_number_arg(argvars, 1) == FAIL))
12303 return;
12304
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012305 rettv->vval.v_number = tv_get_number_chk(&argvars[0], NULL)
12306 ^ tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012307}
12308
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012309#endif // FEAT_EVAL