blob: ec21087e252c79f3ac673148ff97427a4a1d8c84 [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);
Christ van Willegenc0786752025-02-01 15:42:16 +0100122static void f_ngettext(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200123static void f_nr2char(typval_T *argvars, typval_T *rettv);
124static void f_or(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200125#ifdef FEAT_PERL
126static void f_perleval(typval_T *argvars, typval_T *rettv);
127#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200128static void f_prevnonblank(typval_T *argvars, typval_T *rettv);
129static void f_printf(typval_T *argvars, typval_T *rettv);
Bram Moolenaare9bd5722019-08-17 19:36:06 +0200130static void f_pum_getpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200131static void f_pumvisible(typval_T *argvars, typval_T *rettv);
132#ifdef FEAT_PYTHON3
133static void f_py3eval(typval_T *argvars, typval_T *rettv);
134#endif
135#ifdef FEAT_PYTHON
136static void f_pyeval(typval_T *argvars, typval_T *rettv);
137#endif
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +0100138#if defined(FEAT_PYTHON) || defined(FEAT_PYTHON3)
139static void f_pyxeval(typval_T *argvars, typval_T *rettv);
140#endif
Bram Moolenaar4f645c52020-02-08 16:40:39 +0100141static void f_test_srand_seed(typval_T *argvars, typval_T *rettv);
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +0100142static void f_rand(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200143static void f_range(typval_T *argvars, typval_T *rettv);
Bram Moolenaar0b6d9112018-05-22 20:35:17 +0200144static void f_reg_executing(typval_T *argvars, typval_T *rettv);
145static void f_reg_recording(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200146static void f_rename(typval_T *argvars, typval_T *rettv);
147static void f_repeat(typval_T *argvars, typval_T *rettv);
Bram Moolenaare99be0e2019-03-26 22:51:09 +0100148#ifdef FEAT_RUBY
149static void f_rubyeval(typval_T *argvars, typval_T *rettv);
150#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200151static void f_screenattr(typval_T *argvars, typval_T *rettv);
152static void f_screenchar(typval_T *argvars, typval_T *rettv);
Bram Moolenaar2912abb2019-03-29 14:16:42 +0100153static void f_screenchars(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200154static void f_screencol(typval_T *argvars, typval_T *rettv);
155static void f_screenrow(typval_T *argvars, typval_T *rettv);
Bram Moolenaar2912abb2019-03-29 14:16:42 +0100156static void f_screenstring(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200157static void f_search(typval_T *argvars, typval_T *rettv);
158static void f_searchdecl(typval_T *argvars, typval_T *rettv);
159static void f_searchpair(typval_T *argvars, typval_T *rettv);
160static void f_searchpairpos(typval_T *argvars, typval_T *rettv);
161static void f_searchpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar6f02b002021-01-10 20:22:54 +0100162static void f_setcharpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200163static void f_setcharsearch(typval_T *argvars, typval_T *rettv);
Bram Moolenaar6f02b002021-01-10 20:22:54 +0100164static void f_setcursorcharpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar691ddee2019-05-09 14:52:41 +0200165static void f_setenv(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200166static void f_setfperm(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200167static void f_setpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200168static void f_setreg(typval_T *argvars, typval_T *rettv);
Bram Moolenaarf49cc602018-11-11 15:21:05 +0100169static void f_settagstack(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200170#ifdef FEAT_CRYPT
171static void f_sha256(typval_T *argvars, typval_T *rettv);
Bram Moolenaarb005cd82019-09-04 15:54:55 +0200172#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200173static void f_shellescape(typval_T *argvars, typval_T *rettv);
174static void f_shiftwidth(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200175static void f_soundfold(typval_T *argvars, typval_T *rettv);
176static void f_spellbadword(typval_T *argvars, typval_T *rettv);
177static void f_spellsuggest(typval_T *argvars, typval_T *rettv);
178static void f_split(typval_T *argvars, typval_T *rettv);
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +0100179static void f_srand(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200180static void f_submatch(typval_T *argvars, typval_T *rettv);
181static void f_substitute(typval_T *argvars, typval_T *rettv);
Bram Moolenaarc216a7a2022-12-05 13:50:55 +0000182static void f_swapfilelist(typval_T *argvars, typval_T *rettv);
Bram Moolenaar00f123a2018-08-21 20:28:54 +0200183static void f_swapinfo(typval_T *argvars, typval_T *rettv);
Bram Moolenaar110bd602018-09-16 18:46:59 +0200184static void f_swapname(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200185static void f_synID(typval_T *argvars, typval_T *rettv);
186static void f_synIDattr(typval_T *argvars, typval_T *rettv);
187static void f_synIDtrans(typval_T *argvars, typval_T *rettv);
188static void f_synstack(typval_T *argvars, typval_T *rettv);
189static void f_synconcealed(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200190static void f_tabpagebuflist(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200191static void f_taglist(typval_T *argvars, typval_T *rettv);
192static void f_tagfiles(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200193static void f_type(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200194static void f_virtcol(typval_T *argvars, typval_T *rettv);
195static void f_visualmode(typval_T *argvars, typval_T *rettv);
196static void f_wildmenumode(typval_T *argvars, typval_T *rettv);
Bram Moolenaar0c1e3742019-12-27 13:49:24 +0100197static void f_windowsversion(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200198static void f_wordcount(typval_T *argvars, typval_T *rettv);
199static void f_xor(typval_T *argvars, typval_T *rettv);
200
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +0100201
Bram Moolenaar94738d82020-10-21 14:25:07 +0200202/*
203 * Functions that check the argument type of a builtin function.
204 * Each function returns FAIL and gives an error message if the type is wrong.
205 */
206
207// Context passed to an arg_ function.
208typedef struct {
Bram Moolenaarca174532020-10-21 16:42:22 +0200209 int arg_count; // actual argument count
Bram Moolenaar078a4612022-01-04 15:17:03 +0000210 type2_T *arg_types; // list of argument types
Bram Moolenaarca174532020-10-21 16:42:22 +0200211 int arg_idx; // current argument index (first arg is zero)
Bram Moolenaar351ead02021-01-16 16:07:01 +0100212 cctx_T *arg_cctx;
Bram Moolenaar94738d82020-10-21 14:25:07 +0200213} argcontext_T;
214
215// A function to check one argument type. The first argument is the type to
216// check. If needed, other argument types can be obtained with the context.
217// E.g. if "arg_idx" is 1, then (type - 1) is the first argument type.
Ernie Raela8f7f922023-12-14 20:17:04 +0100218// NOTE: Use "arg_any", not NULL, in funcentry_T.f_argcheck array
219// to accept an argument of any type.
Bram Moolenaar078a4612022-01-04 15:17:03 +0000220typedef int (*argcheck_T)(type_T *, type_T *, argcontext_T *);
Bram Moolenaar94738d82020-10-21 14:25:07 +0200221
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100222/*
Bram Moolenaar351ead02021-01-16 16:07:01 +0100223 * Call need_type() to check an argument type.
224 */
225 static int
226check_arg_type(
227 type_T *expected,
228 type_T *actual,
229 argcontext_T *context)
230{
Bram Moolenaarc6951a72022-12-29 20:56:24 +0000231 return need_type(actual, expected, FALSE,
Bram Moolenaar351ead02021-01-16 16:07:01 +0100232 context->arg_idx - context->arg_count, context->arg_idx + 1,
233 context->arg_cctx, FALSE, FALSE);
234}
235
236/*
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100237 * Call need_type() to check an argument type and that it is modifiable
238 */
239 static int
240check_arg_type_mod(
241 type_T *expected,
242 type_T *actual,
243 argcontext_T *context)
244{
Bram Moolenaarc6951a72022-12-29 20:56:24 +0000245 if (need_type(actual, expected, FALSE,
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100246 context->arg_idx - context->arg_count, context->arg_idx + 1,
247 context->arg_cctx, FALSE, FALSE) == FAIL)
248 return FAIL;
249 return arg_type_modifiable(actual, context->arg_idx + 1);
250}
251
252/*
Bram Moolenaarfa103972022-09-29 19:14:42 +0100253 * Give an error if "type" is a constant.
254 */
255 int
256arg_type_modifiable(type_T *type, int arg_idx)
257{
258 char *tofree;
259
260 if ((type->tt_flags & TTFLAG_CONST) == 0)
261 return OK;
262 semsg(_(e_argument_nr_trying_to_modify_const_str),
263 arg_idx, type_name(type, &tofree));
264 vim_free(tofree);
265 return FAIL;
266}
267
268/*
Ernie Raela8f7f922023-12-14 20:17:04 +0100269 * Return OK for any type unconditionally.
270 */
271 static int
272arg_any(type_T *type UNUSED,
273 type_T *decl_type UNUSED,
274 argcontext_T *context UNUSED)
275{
276 return OK;
277}
278
279/*
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100280 * Check "type" is a float or a number.
281 */
Bram Moolenaar94738d82020-10-21 14:25:07 +0200282 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000283arg_float_or_nr(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaar94738d82020-10-21 14:25:07 +0200284{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100285 if (type->tt_type == VAR_FLOAT
286 || type->tt_type == VAR_NUMBER
287 || type_any_or_unknown(type))
Bram Moolenaar94738d82020-10-21 14:25:07 +0200288 return OK;
289 arg_type_mismatch(&t_number, type, context->arg_idx + 1);
290 return FAIL;
291}
292
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100293/*
294 * Check "type" is a number.
295 */
Bram Moolenaarca174532020-10-21 16:42:22 +0200296 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000297arg_number(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarca174532020-10-21 16:42:22 +0200298{
Bram Moolenaar351ead02021-01-16 16:07:01 +0100299 return check_arg_type(&t_number, type, context);
Bram Moolenaarca174532020-10-21 16:42:22 +0200300}
301
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100302/*
LemonBoyafe04662023-08-23 21:08:11 +0200303 * Check "type" is an object.
304 */
305 static int
306arg_object(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
307{
Yegappan Lakshmananb49ad282023-08-27 19:08:40 +0200308 if (type->tt_type == VAR_OBJECT
309 || type_any_or_unknown(type))
310 return OK;
Yegappan Lakshmanande8f8f72025-04-01 20:43:36 +0200311 arg_type_mismatch(&t_object_any, type, context->arg_idx + 1);
Yegappan Lakshmananb49ad282023-08-27 19:08:40 +0200312 return FAIL;
LemonBoyafe04662023-08-23 21:08:11 +0200313}
314
315/*
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200316 * Check "type" is a dict of 'any'.
317 */
318 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000319arg_dict_any(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200320{
321 return check_arg_type(&t_dict_any, type, context);
322}
323
324/*
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +0200325 * Check "type" is a list of 'any'.
326 */
327 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000328arg_list_any(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +0200329{
330 return check_arg_type(&t_list_any, type, context);
331}
332
333/*
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100334 * Check "type" is a list of 'any' and modifiable
335 */
336 static int
337arg_list_any_mod(
338 type_T *type,
339 type_T *decl_type UNUSED,
340 argcontext_T *context)
341{
342 return check_arg_type_mod(&t_list_any, type, context);
343}
344
345/*
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200346 * Check "type" is a list of numbers.
347 */
348 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000349arg_list_number(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200350{
351 return check_arg_type(&t_list_number, type, context);
352}
353
354/*
355 * Check "type" is a list of strings.
356 */
357 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000358arg_list_string(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200359{
360 return check_arg_type(&t_list_string, type, context);
361}
362
363/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100364 * Check "type" is a tuple of 'any'.
365 */
366 static int
367arg_tuple_any(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
368{
369 return check_arg_type(&t_tuple_any, type, context);
370}
371
372/*
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100373 * Check "type" is a string.
374 */
375 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000376arg_string(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100377{
Bram Moolenaar351ead02021-01-16 16:07:01 +0100378 return check_arg_type(&t_string, type, context);
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100379}
380
381/*
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +0200382 * Check "type" is a blob
383 */
384 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000385arg_blob(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +0200386{
387 return check_arg_type(&t_blob, type, context);
388}
389
390/*
Bram Moolenaarf2b26bc2021-01-30 23:05:11 +0100391 * Check "type" is a bool or number 0 or 1.
392 */
393 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000394arg_bool(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarf2b26bc2021-01-30 23:05:11 +0100395{
Bram Moolenaarf2b26bc2021-01-30 23:05:11 +0100396 return check_arg_type(&t_bool, type, context);
397}
398
399/*
zeertzjqe0a2ab32025-02-02 09:14:35 +0100400 * Check "type" is a bool or a number.
401 */
402 static int
403arg_bool_or_nr(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
404{
405 if (type->tt_type == VAR_BOOL
406 || type->tt_type == VAR_NUMBER
407 || type_any_or_unknown(type))
408 return OK;
409 arg_type_mismatch(&t_number, type, context->arg_idx + 1);
410 return FAIL;
411}
412
413/*
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200414 * Check "type" is a list of 'any' or a blob.
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100415 */
Bram Moolenaarca174532020-10-21 16:42:22 +0200416 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000417arg_list_or_blob(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarca174532020-10-21 16:42:22 +0200418{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100419 if (type->tt_type == VAR_LIST
420 || type->tt_type == VAR_BLOB
421 || type_any_or_unknown(type))
Bram Moolenaarca174532020-10-21 16:42:22 +0200422 return OK;
423 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
424 return FAIL;
425}
426
427/*
Bram Moolenaarfa103972022-09-29 19:14:42 +0100428 * Check "type" is a modifiable list of 'any' or a blob.
429 */
430 static int
431arg_list_or_blob_mod(
432 type_T *type,
433 type_T *decl_type,
434 argcontext_T *context)
435{
436 if (arg_list_or_blob(type, decl_type, context) == FAIL)
437 return FAIL;
438 return arg_type_modifiable(type, context->arg_idx + 1);
439}
440
441/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100442 * Check "type" is a list of 'any' or a tuple.
443 */
444 static int
445arg_list_or_tuple(
446 type_T *type,
447 type_T *decl_type UNUSED,
448 argcontext_T *context)
449{
450 if (type->tt_type == VAR_LIST
451 || type->tt_type == VAR_TUPLE
452 || type_any_or_unknown(type))
453 return OK;
454 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
455 return FAIL;
456}
457
458
459/*
460 * Check "type" is a list of 'any', a tuple or a blob.
461 */
462 static int
463arg_list_or_tuple_or_blob(
464 type_T *type,
465 type_T *decl_type UNUSED,
466 argcontext_T *context)
467{
468 if (type->tt_type == VAR_LIST
469 || type->tt_type == VAR_TUPLE
470 || type->tt_type == VAR_BLOB
471 || type_any_or_unknown(type))
472 return OK;
473 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
474 return FAIL;
475}
476
477/*
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200478 * Check "type" is a string or a number
479 */
480 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000481arg_string_or_nr(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200482{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100483 if (type->tt_type == VAR_STRING
484 || type->tt_type == VAR_NUMBER
485 || type_any_or_unknown(type))
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200486 return OK;
487 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
488 return FAIL;
489}
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200490
491/*
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200492 * Check "type" is a buffer (string or a number)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200493 */
494 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000495arg_buffer(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200496{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100497 if (type->tt_type == VAR_STRING
498 || type->tt_type == VAR_NUMBER
499 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200500 return OK;
501 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
502 return FAIL;
503}
504
505/*
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200506 * Check "type" is a buffer or a dict of any
507 */
508 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100509arg_buffer_or_dict_any(
510 type_T *type,
511 type_T *decl_type UNUSED,
512 argcontext_T *context)
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200513{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100514 if (type->tt_type == VAR_STRING
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200515 || type->tt_type == VAR_NUMBER
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100516 || type->tt_type == VAR_DICT
517 || type_any_or_unknown(type))
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200518 return OK;
519 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
520 return FAIL;
521}
522
523/*
524 * Check "type" is a line (string or a number)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200525 */
526 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000527arg_lnum(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200528{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100529 if (type->tt_type == VAR_STRING
530 || type->tt_type == VAR_NUMBER
531 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200532 return OK;
533 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
534 return FAIL;
535}
536
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200537/*
Bram Moolenaarca81f0e2021-06-20 14:41:01 +0200538 * Check "type" is a string or a list of strings.
539 */
540 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100541arg_string_or_list_string(
542 type_T *type,
543 type_T *decl_type UNUSED,
544 argcontext_T *context)
Bram Moolenaarca81f0e2021-06-20 14:41:01 +0200545{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100546 if (type->tt_type == VAR_STRING
547 || type_any_or_unknown(type))
Bram Moolenaarca81f0e2021-06-20 14:41:01 +0200548 return OK;
549 if (type->tt_type != VAR_LIST)
550 {
551 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
552 return FAIL;
553 }
554 if (type->tt_member->tt_type == VAR_ANY
555 || type->tt_member->tt_type == VAR_STRING)
556 return OK;
557
558 arg_type_mismatch(&t_list_string, type, context->arg_idx + 1);
559 return FAIL;
560}
561
562/*
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200563 * Check "type" is a string or a list of 'any'
564 */
565 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100566arg_string_or_list_any(
567 type_T *type,
568 type_T *decl_type UNUSED,
569 argcontext_T *context)
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200570{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100571 if (type->tt_type == VAR_STRING
572 || type->tt_type == VAR_LIST
573 || type_any_or_unknown(type))
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200574 return OK;
575 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
576 return FAIL;
577}
578
579/*
Ernie Rael51d04d12022-05-04 15:40:22 +0100580 * Check "type" is a string or a dict of 'any'
581 */
582 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100583arg_string_or_dict_any(
584 type_T *type,
585 type_T *decl_type UNUSED,
586 argcontext_T *context)
Ernie Rael51d04d12022-05-04 15:40:22 +0100587{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100588 if (type->tt_type == VAR_STRING
589 || type->tt_type == VAR_DICT
590 || type_any_or_unknown(type))
Ernie Rael51d04d12022-05-04 15:40:22 +0100591 return OK;
592 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
593 return FAIL;
594}
595
596/*
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200597 * Check "type" is a string or a blob
598 */
599 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100600arg_string_or_blob(
601 type_T *type,
602 type_T *decl_type UNUSED,
603 argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200604{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100605 if (type->tt_type == VAR_STRING
606 || type->tt_type == VAR_BLOB
607 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200608 return OK;
609 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
610 return FAIL;
611}
612
613/*
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +0200614 * Check "type" is a list of 'any' or a dict of 'any'.
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100615 */
616 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000617arg_list_or_dict(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100618{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100619 if (type->tt_type == VAR_LIST
620 || type->tt_type == VAR_DICT
621 || type_any_or_unknown(type))
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100622 return OK;
623 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
624 return FAIL;
625}
626
627/*
Bram Moolenaarfa103972022-09-29 19:14:42 +0100628 * Check "type" is a list of 'any' or a dict of 'any'. And modifiable.
629 */
630 static int
631arg_list_or_dict_mod(
632 type_T *type,
633 type_T *decl_type,
634 argcontext_T *context)
635{
636 if (arg_list_or_dict(type, decl_type, context) == FAIL)
637 return FAIL;
638 return arg_type_modifiable(type, context->arg_idx + 1);
639}
640
641/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100642 * Check "type" is a list of 'any', a tuple of 'any' or dict of 'any'.
643 */
644 static int
645arg_list_or_tuple_or_dict(
646 type_T *type,
647 type_T *decl_type UNUSED,
648 argcontext_T *context)
649{
650 if (type->tt_type == VAR_LIST
651 || type->tt_type == VAR_TUPLE
652 || type->tt_type == VAR_DICT
653 || type_any_or_unknown(type))
654 return OK;
655 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
656 return FAIL;
657}
658
659/*
660 * Check "type" is a list of 'any', a dict of 'any' or a blob.
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100661 * Also check if "type" is modifiable.
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200662 */
663 static int
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100664arg_list_or_dict_or_blob_mod(
665 type_T *type,
666 type_T *decl_type UNUSED,
667 argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200668{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100669 if (type->tt_type == VAR_LIST
Bram Moolenaar59618fe2021-12-21 12:32:17 +0000670 || type->tt_type == VAR_DICT
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100671 || type->tt_type == VAR_BLOB
672 || type_any_or_unknown(type))
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100673 return arg_type_modifiable(type, context->arg_idx + 1);
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200674 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
675 return FAIL;
676}
677
678/*
Bram Moolenaar2d877592021-12-16 08:21:09 +0000679 * Check "type" is a list of 'any' or a dict of 'any' or a blob or a string.
680 */
681 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100682arg_list_or_dict_or_blob_or_string(
683 type_T *type,
684 type_T *decl_type UNUSED,
685 argcontext_T *context)
Bram Moolenaar2d877592021-12-16 08:21:09 +0000686{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100687 if (type->tt_type == VAR_LIST
Bram Moolenaar59618fe2021-12-21 12:32:17 +0000688 || type->tt_type == VAR_DICT
689 || type->tt_type == VAR_BLOB
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100690 || type->tt_type == VAR_STRING
691 || type_any_or_unknown(type))
Bram Moolenaar2d877592021-12-16 08:21:09 +0000692 return OK;
693 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
694 return FAIL;
695}
696
697/*
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100698 * Check "type" is a list of 'any' or a dict of 'any' or a blob or a string.
699 * Also check the value is modifiable.
700 */
701 static int
702arg_list_or_dict_or_blob_or_string_mod(
703 type_T *type,
704 type_T *decl_type,
705 argcontext_T *context)
706{
707 if (arg_list_or_dict_or_blob_or_string(type, decl_type, context) == FAIL)
708 return FAIL;
709 return arg_type_modifiable(type, context->arg_idx + 1);
710}
711
712/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100713 * Check "type" is a list of 'any', a tuple of 'any', a dict of 'any', a blob
714 * or a string.
715 */
716 static int
717arg_list_tuple_dict_blob_or_string(
718 type_T *type,
719 type_T *decl_type UNUSED,
720 argcontext_T *context)
721{
722 if (type->tt_type == VAR_LIST
723 || type->tt_type == VAR_TUPLE
724 || type->tt_type == VAR_DICT
725 || type->tt_type == VAR_BLOB
726 || type->tt_type == VAR_STRING
727 || type_any_or_unknown(type))
728 return OK;
729 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
730 return FAIL;
731}
732
733
734/*
Ernie Raele79e2072024-01-13 11:47:33 +0100735 * Check second argument of map(), filter(), foreach().
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000736 */
737 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100738check_map_filter_arg2(
739 type_T *type,
740 argcontext_T *context,
741 filtermap_T filtermap)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000742{
743 type_T *expected_member = NULL;
744 type_T *(args[2]);
Bram Moolenaarb1e32ac2023-02-21 12:38:51 +0000745 type_T t_func_exp = {VAR_FUNC, 2, 0, 0, NULL, NULL, args};
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000746
747 if (context->arg_types[0].type_curr->tt_type == VAR_LIST
748 || context->arg_types[0].type_curr->tt_type == VAR_DICT)
749 {
750 // Use the declared type if possible, so that an error is given if
751 // a declared list changes type, but not if a constant list changes
752 // type.
753 if (context->arg_types[0].type_decl->tt_type == VAR_LIST
754 || context->arg_types[0].type_decl->tt_type == VAR_DICT)
755 expected_member = context->arg_types[0].type_decl->tt_member;
756 else
757 expected_member = context->arg_types[0].type_curr->tt_member;
758 }
759 else if (context->arg_types[0].type_curr->tt_type == VAR_STRING)
760 expected_member = &t_string;
761 else if (context->arg_types[0].type_curr->tt_type == VAR_BLOB)
762 expected_member = &t_number;
763
764 args[0] = NULL;
765 args[1] = &t_unknown;
766 if (type->tt_argcount != -1)
767 {
768 if (!(type->tt_argcount == 2 || (type->tt_argcount == 1
769 && (type->tt_flags & TTFLAG_VARARGS))))
770 {
771 emsg(_(e_invalid_number_of_arguments));
772 return FAIL;
773 }
774 if (type->tt_flags & TTFLAG_VARARGS)
775 // check the argument types at runtime
776 t_func_exp.tt_argcount = -1;
777 else
778 {
779 if (context->arg_types[0].type_curr->tt_type == VAR_STRING
780 || context->arg_types[0].type_curr->tt_type == VAR_BLOB
781 || context->arg_types[0].type_curr->tt_type == VAR_LIST)
782 args[0] = &t_number;
783 else if (context->arg_types[0].type_decl->tt_type == VAR_DICT)
784 args[0] = &t_string;
785 if (args[0] != NULL)
786 args[1] = expected_member;
787 }
788 }
789
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100790 if (!type_any_or_unknown(type->tt_member) || args[0] != NULL)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000791 {
792 where_T where = WHERE_INIT;
793
Ernie Raele79e2072024-01-13 11:47:33 +0100794 if (filtermap == FILTERMAP_MAP)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000795 t_func_exp.tt_member = expected_member == NULL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100796 || type_any_or_unknown(type->tt_member)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000797 ? &t_any : expected_member;
Ernie Raele79e2072024-01-13 11:47:33 +0100798 else if (filtermap == FILTERMAP_FILTER)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000799 t_func_exp.tt_member = &t_bool;
Ernie Raele79e2072024-01-13 11:47:33 +0100800 else // filtermap == FILTERMAP_FOREACH
801 t_func_exp.tt_member = &t_unknown;
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000802 if (args[0] == NULL)
803 args[0] = &t_unknown;
Bram Moolenaar6e1a3872022-02-23 19:11:49 +0000804 if (type->tt_argcount == -1)
805 t_func_exp.tt_argcount = -1;
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000806
807 where.wt_index = 2;
LemonBoyc5d27442023-08-19 13:02:35 +0200808 where.wt_kind = WT_ARGUMENT;
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000809 return check_type(&t_func_exp, type, TRUE, where);
810 }
811 return OK;
812}
813
814/*
Bram Moolenaar18024052021-12-25 21:43:28 +0000815 * Check second argument of filter(): func must return a bool.
816 */
817 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000818arg_filter_func(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaar18024052021-12-25 21:43:28 +0000819{
Bram Moolenaar1080c482022-01-26 18:26:21 +0000820 if (type->tt_type == VAR_STRING
821 || type->tt_type == VAR_PARTIAL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100822 || type_any_or_unknown(type))
Bram Moolenaar1080c482022-01-26 18:26:21 +0000823 return OK;
824
825 if (type->tt_type == VAR_FUNC)
Ernie Raele79e2072024-01-13 11:47:33 +0100826 return check_map_filter_arg2(type, context, FILTERMAP_FILTER);
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000827 semsg(_(e_string_or_function_required_for_argument_nr), 2);
828 return FAIL;
Bram Moolenaar18024052021-12-25 21:43:28 +0000829}
830
831/*
Bram Moolenaareddd4fc2022-02-20 15:52:28 +0000832 * Check second argument of map(), the function.
Bram Moolenaar18024052021-12-25 21:43:28 +0000833 */
834 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000835arg_map_func(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaar18024052021-12-25 21:43:28 +0000836{
Bram Moolenaar1080c482022-01-26 18:26:21 +0000837 if (type->tt_type == VAR_STRING
838 || type->tt_type == VAR_PARTIAL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100839 || type_any_or_unknown(type))
Bram Moolenaar1080c482022-01-26 18:26:21 +0000840 return OK;
841
842 if (type->tt_type == VAR_FUNC)
Ernie Raele79e2072024-01-13 11:47:33 +0100843 return check_map_filter_arg2(type, context, FILTERMAP_MAP);
844 semsg(_(e_string_or_function_required_for_argument_nr), 2);
845 return FAIL;
846}
847
848/*
849 * Check second argument of foreach(), the function.
850 */
851 static int
852arg_foreach_func(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
853{
854 if (type->tt_type == VAR_STRING
855 || type->tt_type == VAR_PARTIAL
856 || type_any_or_unknown(type))
857 return OK;
858
859 if (type->tt_type == VAR_FUNC)
860 return check_map_filter_arg2(type, context, FILTERMAP_FOREACH);
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000861 semsg(_(e_string_or_function_required_for_argument_nr), 2);
862 return FAIL;
Bram Moolenaar18024052021-12-25 21:43:28 +0000863}
864
865/*
Bram Moolenaare843efc2022-02-22 21:54:44 +0000866 * Check second argument of sort() and uniq(), the "how" argument.
867 */
868 static int
869arg_sort_how(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
870{
871 if (type->tt_type == VAR_STRING
872 || type->tt_type == VAR_PARTIAL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100873 || type_any_or_unknown(type))
Bram Moolenaare843efc2022-02-22 21:54:44 +0000874 return OK;
875
876 if (type->tt_type == VAR_FUNC)
877 {
878 type_T *(args[2]);
Bram Moolenaarb1e32ac2023-02-21 12:38:51 +0000879 type_T t_func_exp = {VAR_FUNC, 2, 0, 0, &t_number, NULL, args};
Bram Moolenaare843efc2022-02-22 21:54:44 +0000880
881 if (context->arg_types[0].type_curr->tt_type == VAR_LIST)
882 args[0] = context->arg_types[0].type_curr->tt_member;
883 else
884 args[0] = &t_unknown;
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100885 if (!type_any_or_unknown(type->tt_member) || args[0] != &t_unknown)
Bram Moolenaare843efc2022-02-22 21:54:44 +0000886 {
887 where_T where = WHERE_INIT;
888
889 args[1] = args[0];
Bram Moolenaarfa026162022-02-23 21:03:32 +0000890 if (type->tt_argcount == -1)
891 t_func_exp.tt_argcount = -1;
Bram Moolenaare843efc2022-02-22 21:54:44 +0000892 where.wt_index = 2;
LemonBoyc5d27442023-08-19 13:02:35 +0200893 where.wt_kind = WT_ARGUMENT;
Bram Moolenaare843efc2022-02-22 21:54:44 +0000894 return check_type(&t_func_exp, type, TRUE, where);
895 }
896
897 return OK;
898 }
899 semsg(_(e_string_or_function_required_for_argument_nr), 2);
900 return FAIL;
901}
902
903/*
Bram Moolenaar73199812021-12-26 17:18:14 +0000904 * Check an expression argument, can be a string, funcref or partial.
905 * Also accept a bool, a constant resulting from compiling a string argument.
906 * Also accept a number, one and zero are accepted.
907 */
908 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100909arg_string_or_func(
910 type_T *type,
911 type_T *decl_type UNUSED,
912 argcontext_T *context)
Bram Moolenaar73199812021-12-26 17:18:14 +0000913{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100914 if (type->tt_type == VAR_STRING
Bram Moolenaar73199812021-12-26 17:18:14 +0000915 || type->tt_type == VAR_PARTIAL
916 || type->tt_type == VAR_FUNC
917 || type->tt_type == VAR_BOOL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100918 || type->tt_type == VAR_NUMBER
919 || type_any_or_unknown(type))
Bram Moolenaar73199812021-12-26 17:18:14 +0000920 return OK;
921 arg_type_mismatch(&t_func_any, type, context->arg_idx + 1);
922 return FAIL;
923}
924
925/*
Ernie Rael2025af12023-12-12 16:58:00 +0100926 * Check varargs' "type" are class.
LemonBoyafe04662023-08-23 21:08:11 +0200927 */
928 static int
Ernie Rael2025af12023-12-12 16:58:00 +0100929varargs_class(type_T *type UNUSED,
930 type_T *decl_type UNUSED,
931 argcontext_T *context)
LemonBoyafe04662023-08-23 21:08:11 +0200932{
Ernie Rael2025af12023-12-12 16:58:00 +0100933 for (int i = context->arg_idx; i < context->arg_count; ++i)
934 {
935 type2_T *types = &context->arg_types[i];
936 if (types->type_curr->tt_type != VAR_CLASS)
937 {
938 semsg(_(e_class_or_typealias_required_for_argument_nr), i + 1);
939 return FAIL;
940 }
941 }
942 return OK;
LemonBoyafe04662023-08-23 21:08:11 +0200943}
944
945/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100946 * Check "type" is a list of 'any', a tuple, a blob or a string.
rbtnn0ccb5842021-12-18 18:33:46 +0000947 */
948 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100949arg_string_list_tuple_or_blob(
950 type_T *type,
951 type_T *decl_type UNUSED,
952 argcontext_T *context)
rbtnn0ccb5842021-12-18 18:33:46 +0000953{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100954 if (type->tt_type == VAR_LIST
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100955 || type->tt_type == VAR_TUPLE
Bram Moolenaar59618fe2021-12-21 12:32:17 +0000956 || type->tt_type == VAR_BLOB
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100957 || type->tt_type == VAR_STRING
958 || type_any_or_unknown(type))
rbtnn0ccb5842021-12-18 18:33:46 +0000959 return OK;
960 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
961 return FAIL;
962}
963
964/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100965 * Check "type" is a tuple or a modifiable list of 'any' or a blob or a string.
Yegappan Lakshmananf9dc2782023-05-11 15:02:56 +0100966 */
967 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100968arg_reverse(type_T *type, type_T *decl_type, argcontext_T *context)
Yegappan Lakshmananf9dc2782023-05-11 15:02:56 +0100969{
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100970 if (arg_string_list_tuple_or_blob(type, decl_type, context) == FAIL)
Yegappan Lakshmananf9dc2782023-05-11 15:02:56 +0100971 return FAIL;
972 return arg_type_modifiable(type, context->arg_idx + 1);
973}
974
975/*
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +0200976 * Check "type" is a job.
977 */
978 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000979arg_job(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +0200980{
981 return check_arg_type(&t_job, type, context);
982}
983
984/*
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +0200985 * Check "type" is a channel or a job.
986 */
987 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000988arg_chan_or_job(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +0200989{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100990 if (type->tt_type == VAR_CHANNEL
991 || type->tt_type == VAR_JOB
992 || type_any_or_unknown(type))
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +0200993 return OK;
994 arg_type_mismatch(&t_channel, type, context->arg_idx + 1);
995 return FAIL;
996}
997
998/*
Bram Moolenaar078a4612022-01-04 15:17:03 +0000999 * Check "type" can be used as the type_decl of the previous argument.
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01001000 * Must not be used for the first argcheck_T entry.
1001 */
1002 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001003arg_same_as_prev(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01001004{
Bram Moolenaar078a4612022-01-04 15:17:03 +00001005 type_T *prev_type = context->arg_types[context->arg_idx - 1].type_decl;
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01001006
Bram Moolenaar351ead02021-01-16 16:07:01 +01001007 return check_arg_type(prev_type, type, context);
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01001008}
1009
1010/*
Bram Moolenaarb0e6b512021-01-12 20:23:40 +01001011 * Check "type" is the same basic type as the previous argument, checks list or
1012 * dict vs other type, but not member type.
1013 * Must not be used for the first argcheck_T entry.
1014 */
1015 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001016arg_same_struct_as_prev(
1017 type_T *type,
1018 type_T *decl_type UNUSED,
1019 argcontext_T *context)
Bram Moolenaarb0e6b512021-01-12 20:23:40 +01001020{
Bram Moolenaar078a4612022-01-04 15:17:03 +00001021 type_T *prev_type = context->arg_types[context->arg_idx - 1].type_curr;
Bram Moolenaarb0e6b512021-01-12 20:23:40 +01001022
Bram Moolenaar078a4612022-01-04 15:17:03 +00001023 if (prev_type->tt_type != context->arg_types[context->arg_idx].type_curr->tt_type)
Bram Moolenaar351ead02021-01-16 16:07:01 +01001024 return check_arg_type(prev_type, type, context);
Bram Moolenaarb0e6b512021-01-12 20:23:40 +01001025 return OK;
1026}
1027
1028/*
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01001029 * Check "type" is an item of the list or blob of the previous arg.
Bram Moolenaarca174532020-10-21 16:42:22 +02001030 * Must not be used for the first argcheck_T entry.
1031 */
1032 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001033arg_item_of_prev(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarca174532020-10-21 16:42:22 +02001034{
Bram Moolenaar078a4612022-01-04 15:17:03 +00001035 type_T *prev_type = context->arg_types[context->arg_idx - 1].type_curr;
Bram Moolenaarca174532020-10-21 16:42:22 +02001036 type_T *expected;
1037
1038 if (prev_type->tt_type == VAR_LIST)
1039 expected = prev_type->tt_member;
1040 else if (prev_type->tt_type == VAR_BLOB)
1041 expected = &t_number;
1042 else
1043 // probably VAR_ANY, can't check
1044 return OK;
1045
Bram Moolenaar351ead02021-01-16 16:07:01 +01001046 return check_arg_type(expected, type, context);
Bram Moolenaarca174532020-10-21 16:42:22 +02001047}
1048
Bram Moolenaar94738d82020-10-21 14:25:07 +02001049/*
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02001050 * Check "type" is a string or a number or a list
1051 */
1052 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001053arg_str_or_nr_or_list(
1054 type_T *type,
1055 type_T *decl_type UNUSED,
1056 argcontext_T *context)
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02001057{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001058 if (type->tt_type == VAR_STRING
Bram Moolenaar59618fe2021-12-21 12:32:17 +00001059 || type->tt_type == VAR_NUMBER
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001060 || type->tt_type == VAR_LIST
1061 || type_any_or_unknown(type))
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02001062 return OK;
1063 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
1064 return FAIL;
1065}
1066
1067/*
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001068 * Check "type" is a dict of 'any' or a string
1069 */
1070 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001071arg_dict_any_or_string(
1072 type_T *type,
1073 type_T *decl_type UNUSED,
1074 argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001075{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001076 if (type->tt_type == VAR_DICT
1077 || type->tt_type == VAR_STRING
1078 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001079 return OK;
1080 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
1081 return FAIL;
1082}
1083
1084/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001085 * Check "type" which is the third argument of extend() (number or string or
1086 * any)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01001087 */
1088 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001089arg_extend3(type_T *type, type_T *decl_type, argcontext_T *context)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01001090{
Bram Moolenaar078a4612022-01-04 15:17:03 +00001091 type_T *first_type = context->arg_types[context->arg_idx - 2].type_curr;
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01001092
1093 if (first_type->tt_type == VAR_LIST)
Bram Moolenaar078a4612022-01-04 15:17:03 +00001094 return arg_number(type, decl_type, context);
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01001095 if (first_type->tt_type == VAR_DICT)
Bram Moolenaar078a4612022-01-04 15:17:03 +00001096 return arg_string(type, decl_type, context);
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01001097 return OK;
1098}
1099
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001100/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001101 * Check "type" which is the first argument of get() (a blob, a list, a tuple,
1102 * a dict or a funcref)
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001103 */
1104 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001105arg_get1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001106{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001107 if (type->tt_type == VAR_BLOB
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001108 || type->tt_type == VAR_LIST
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001109 || type->tt_type == VAR_TUPLE
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001110 || type->tt_type == VAR_DICT
1111 || type->tt_type == VAR_FUNC
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001112 || type->tt_type == VAR_PARTIAL
1113 || type_any_or_unknown(type))
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001114 return OK;
1115
1116 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
1117 return FAIL;
1118}
1119
1120/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001121 * Check "type" which is the first argument of len() (a string, a number, a
1122 * blob, a list, a tuple, a dict or an object)
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001123 */
1124 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001125arg_len1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001126{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001127 if (type->tt_type == VAR_STRING
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001128 || type->tt_type == VAR_NUMBER
1129 || type->tt_type == VAR_BLOB
1130 || type->tt_type == VAR_LIST
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001131 || type->tt_type == VAR_TUPLE
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001132 || type->tt_type == VAR_DICT
Yegappan Lakshmanand3eae7b2024-03-03 16:26:58 +01001133 || type->tt_type == VAR_OBJECT
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001134 || type_any_or_unknown(type))
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001135 return OK;
1136
1137 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
1138 return FAIL;
1139}
1140
1141/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001142 * Check "type" which is the second argument of remove() (number or string or
1143 * any)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001144 */
1145 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001146arg_remove2(type_T *type, type_T *decl_type, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001147{
Bram Moolenaar078a4612022-01-04 15:17:03 +00001148 type_T *first_type = context->arg_types[context->arg_idx - 1].type_curr;
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001149
1150 if (first_type->tt_type == VAR_LIST || first_type->tt_type == VAR_BLOB)
Bram Moolenaar078a4612022-01-04 15:17:03 +00001151 return arg_number(type, decl_type, context);
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001152 if (first_type->tt_type == VAR_DICT)
Bram Moolenaar078a4612022-01-04 15:17:03 +00001153 return arg_string_or_nr(type, decl_type, context);
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001154 return OK;
1155}
1156
1157/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001158 * Check "type" which is the first argument of repeat() (a string, a number, a
1159 * blob, a list, a tuple or any)
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001160 */
1161 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001162arg_repeat1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001163{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001164 if (type->tt_type == VAR_STRING
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001165 || type->tt_type == VAR_NUMBER
Bakudankun375141e2022-09-09 18:46:47 +01001166 || type->tt_type == VAR_BLOB
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001167 || type->tt_type == VAR_LIST
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001168 || type->tt_type == VAR_TUPLE
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001169 || type_any_or_unknown(type))
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001170 return OK;
1171
1172 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
1173 return FAIL;
1174}
1175
1176/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001177 * Check "type" which is the first argument of slice() (a list, a tuple, a
1178 * blob, a string or any)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001179 */
1180 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001181arg_slice1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001182{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001183 if (type->tt_type == VAR_LIST
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001184 || type->tt_type == VAR_TUPLE
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001185 || type->tt_type == VAR_BLOB
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001186 || type->tt_type == VAR_STRING
1187 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001188 return OK;
1189
1190 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
1191 return FAIL;
1192}
1193
1194/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001195 * Check "type" which is the first argument of count() (a string, a list, a
1196 * tuple, a dict or any)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001197 */
1198 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001199arg_string_list_tuple_or_dict(
1200 type_T *type,
1201 type_T *decl_type UNUSED,
1202 argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001203{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001204 if (type->tt_type == VAR_STRING
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001205 || type->tt_type == VAR_LIST
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001206 || type->tt_type == VAR_TUPLE
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001207 || type->tt_type == VAR_DICT
1208 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001209 return OK;
1210
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001211 semsg(_(e_string_list_tuple_or_dict_required_for_argument_nr),
Bram Moolenaar3e518a82022-08-30 17:45:33 +01001212 context->arg_idx + 1);
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001213 return FAIL;
1214}
1215
1216/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001217 * Check "type" which is the first argument of cursor() (number or string or
1218 * list or any)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001219 */
1220 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001221arg_cursor1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001222{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001223 if (type->tt_type == VAR_NUMBER
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001224 || type->tt_type == VAR_STRING
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001225 || type->tt_type == VAR_LIST
1226 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001227 return OK;
1228
1229 arg_type_mismatch(&t_number, type, context->arg_idx + 1);
1230 return FAIL;
1231}
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01001232
1233/*
Bram Moolenaar94738d82020-10-21 14:25:07 +02001234 * Lists of functions that check the argument types of a builtin function.
1235 */
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +02001236static argcheck_T arg1_blob[] = {arg_blob};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001237static argcheck_T arg1_bool[] = {arg_bool};
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001238static argcheck_T arg1_buffer[] = {arg_buffer};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001239static argcheck_T arg1_buffer_or_dict_any[] = {arg_buffer_or_dict_any};
1240static argcheck_T arg1_chan_or_job[] = {arg_chan_or_job};
1241static argcheck_T arg1_dict_any[] = {arg_dict_any};
1242static argcheck_T arg1_dict_or_string[] = {arg_dict_any_or_string};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001243static argcheck_T arg1_float_or_nr[] = {arg_float_or_nr};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001244static argcheck_T arg1_job[] = {arg_job};
1245static argcheck_T arg1_list_any[] = {arg_list_any};
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001246static argcheck_T arg1_tuple_any[] = {arg_tuple_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001247static argcheck_T arg1_list_number[] = {arg_list_number};
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001248static argcheck_T arg1_reverse[] = {arg_reverse};
1249static argcheck_T arg1_list_or_tuple_or_dict[] = {arg_list_or_tuple_or_dict};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001250static argcheck_T arg1_list_string[] = {arg_list_string};
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001251static argcheck_T arg1_string_list_tuple_or_dict[] = {arg_string_list_tuple_or_dict};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001252static argcheck_T arg1_lnum[] = {arg_lnum};
1253static argcheck_T arg1_number[] = {arg_number};
1254static argcheck_T arg1_string[] = {arg_string};
1255static argcheck_T arg1_string_or_list_any[] = {arg_string_or_list_any};
1256static argcheck_T arg1_string_or_list_string[] = {arg_string_or_list_string};
1257static argcheck_T arg1_string_or_nr[] = {arg_string_or_nr};
Ernie Raela8f7f922023-12-14 20:17:04 +01001258static argcheck_T arg2_any_buffer[] = {arg_any, arg_buffer};
1259static argcheck_T arg2_buffer_any[] = {arg_buffer, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001260static argcheck_T arg2_buffer_bool[] = {arg_buffer, arg_bool};
1261static argcheck_T arg2_buffer_list_any[] = {arg_buffer, arg_list_any};
1262static argcheck_T arg2_buffer_lnum[] = {arg_buffer, arg_lnum};
1263static argcheck_T arg2_buffer_number[] = {arg_buffer, arg_number};
1264static argcheck_T arg2_buffer_string[] = {arg_buffer, arg_string};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001265static argcheck_T arg2_chan_or_job_dict[] = {arg_chan_or_job, arg_dict_any};
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001266static argcheck_T arg2_chan_or_job_string[] = {arg_chan_or_job, arg_string};
Yegappan Lakshmananccfb7c62021-08-16 21:39:09 +02001267static argcheck_T arg2_dict_any_list_any[] = {arg_dict_any, arg_list_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001268static argcheck_T arg2_dict_any_string_or_nr[] = {arg_dict_any, arg_string_or_nr};
1269static argcheck_T arg2_dict_string[] = {arg_dict_any, arg_string};
1270static argcheck_T arg2_float_or_nr[] = {arg_float_or_nr, arg_float_or_nr};
1271static argcheck_T arg2_job_dict[] = {arg_job, arg_dict_any};
1272static argcheck_T arg2_job_string_or_number[] = {arg_job, arg_string_or_nr};
1273static argcheck_T arg2_list_any_number[] = {arg_list_any, arg_number};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001274static argcheck_T arg2_list_number[] = {arg_list_number, arg_list_number};
1275static argcheck_T arg2_list_number_bool[] = {arg_list_number, arg_bool};
Yegappan Lakshmanana11b23c2025-01-16 19:16:42 +01001276static argcheck_T arg2_list_string_dict[] = {arg_list_string, arg_dict_any};
Bram Moolenaarfa103972022-09-29 19:14:42 +01001277static argcheck_T arg2_listblobmod_item[] = {arg_list_or_blob_mod, arg_item_of_prev};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001278static argcheck_T arg2_lnum[] = {arg_lnum, arg_lnum};
1279static argcheck_T arg2_lnum_number[] = {arg_lnum, arg_number};
1280static argcheck_T arg2_number[] = {arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001281static argcheck_T arg2_number_any[] = {arg_number, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001282static argcheck_T arg2_number_bool[] = {arg_number, arg_bool};
1283static argcheck_T arg2_number_dict_any[] = {arg_number, arg_dict_any};
1284static argcheck_T arg2_number_list[] = {arg_number, arg_list_any};
1285static argcheck_T arg2_number_string[] = {arg_number, arg_string};
Christian Brabandtfbc37f12024-06-18 20:50:58 +02001286static argcheck_T arg2_number_buffer[] = {arg_number, arg_buffer};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001287static argcheck_T arg2_number_string_or_list[] = {arg_number, arg_string_or_list_any};
1288static argcheck_T arg2_str_or_nr_or_list_dict[] = {arg_str_or_nr_or_list, arg_dict_any};
1289static argcheck_T arg2_string[] = {arg_string, arg_string};
Ernie Raela8f7f922023-12-14 20:17:04 +01001290static argcheck_T arg2_string_any[] = {arg_string, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001291static argcheck_T arg2_string_bool[] = {arg_string, arg_bool};
1292static argcheck_T arg2_string_chan_or_job[] = {arg_string, arg_chan_or_job};
1293static argcheck_T arg2_string_dict[] = {arg_string, arg_dict_any};
1294static argcheck_T arg2_string_list_number[] = {arg_string, arg_list_number};
1295static argcheck_T arg2_string_number[] = {arg_string, arg_number};
1296static argcheck_T arg2_string_or_list_dict[] = {arg_string_or_list_any, arg_dict_any};
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00001297static argcheck_T arg2_string_or_list_number[] = {arg_string_or_list_any, arg_number};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001298static argcheck_T arg2_string_string_or_number[] = {arg_string, arg_string_or_nr};
Yegappan Lakshmanan1aefe1d2025-01-14 17:29:42 +01001299static argcheck_T arg2_blob_dict[] = {arg_blob, arg_dict_any};
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001300static argcheck_T arg2_list_or_tuple_string[] = {arg_list_or_tuple, arg_string};
Ernie Raela8f7f922023-12-14 20:17:04 +01001301static argcheck_T arg3_any_list_dict[] = {arg_any, arg_list_any, arg_dict_any};
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001302static argcheck_T arg3_buffer_lnum_lnum[] = {arg_buffer, arg_lnum, arg_lnum};
1303static argcheck_T arg3_buffer_number_number[] = {arg_buffer, arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001304static argcheck_T arg3_buffer_string_any[] = {arg_buffer, arg_string, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001305static argcheck_T arg3_buffer_string_dict[] = {arg_buffer, arg_string, arg_dict_any};
1306static argcheck_T arg3_dict_number_number[] = {arg_dict_any, arg_number, arg_number};
Yegappan Lakshmananfa378352024-02-01 22:05:27 +01001307static argcheck_T arg3_diff[] = {arg_list_string, arg_list_string, arg_dict_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001308static argcheck_T arg3_list_string_dict[] = {arg_list_any, arg_string, arg_dict_any};
Shougo Matsushita19b71882024-02-28 22:48:12 +01001309static argcheck_T arg3_list_list_dict[] = {arg_list_any, arg_list_any, arg_dict_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001310static argcheck_T arg3_lnum_number_bool[] = {arg_lnum, arg_number, arg_bool};
1311static argcheck_T arg3_number[] = {arg_number, arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001312static argcheck_T arg3_number_any_dict[] = {arg_number, arg_any, arg_dict_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001313static argcheck_T arg3_number_number_dict[] = {arg_number, arg_number, arg_dict_any};
Ernie Raela8f7f922023-12-14 20:17:04 +01001314static argcheck_T arg3_number_string_any[] = {arg_number, arg_string, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001315static argcheck_T arg3_number_string_buffer[] = {arg_number, arg_string, arg_buffer};
1316static argcheck_T arg3_number_string_string[] = {arg_number, arg_string, arg_string};
1317static argcheck_T arg3_string[] = {arg_string, arg_string, arg_string};
Ernie Raela8f7f922023-12-14 20:17:04 +01001318static argcheck_T arg3_string_any_dict[] = {arg_string, arg_any, arg_dict_any};
1319static argcheck_T arg3_string_any_string[] = {arg_string, arg_any, arg_string};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001320static argcheck_T arg3_string_bool_bool[] = {arg_string, arg_bool, arg_bool};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001321static argcheck_T arg3_string_number_bool[] = {arg_string, arg_number, arg_bool};
K.Takata11df3ae2022-10-19 14:02:40 +01001322static argcheck_T arg3_string_number_number[] = {arg_string, arg_number, arg_number};
Ernie Rael51d04d12022-05-04 15:40:22 +01001323static argcheck_T arg3_string_or_dict_bool_dict[] = {arg_string_or_dict_any, arg_bool, arg_dict_any};
zeertzjq825cf812023-08-17 22:55:25 +02001324static argcheck_T arg3_string_or_list_bool_number[] = {arg_string_or_list_any, arg_bool, arg_number};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001325static argcheck_T arg3_string_string_bool[] = {arg_string, arg_string, arg_bool};
1326static argcheck_T arg3_string_string_dict[] = {arg_string, arg_string, arg_dict_any};
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02001327static argcheck_T arg3_string_string_number[] = {arg_string, arg_string, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001328static argcheck_T arg4_number_number_string_any[] = {arg_number, arg_number, arg_string, arg_any};
1329static argcheck_T arg4_string_string_any_string[] = {arg_string, arg_string, arg_any, arg_string};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001330static argcheck_T arg4_string_string_number_string[] = {arg_string, arg_string, arg_number, arg_string};
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01001331static argcheck_T arg4_string_number_bool_bool[] = {arg_string, arg_number, arg_bool, arg_bool};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001332/* Function specific argument types (not covered by the above) */
Ernie Raela8f7f922023-12-14 20:17:04 +01001333static 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 +02001334static 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 +02001335static argcheck_T arg4_browse[] = {arg_bool, arg_string, arg_string, arg_string};
Ernie Raela8f7f922023-12-14 20:17:04 +01001336static argcheck_T arg23_chanexpr[] = {arg_chan_or_job, arg_any, arg_dict_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001337static argcheck_T arg23_chanraw[] = {arg_chan_or_job, arg_string_or_blob, arg_dict_any};
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001338static argcheck_T arg24_count[] = {arg_string_list_tuple_or_dict, arg_any, arg_bool, arg_number};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001339static argcheck_T arg13_cursor[] = {arg_cursor1, arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001340static argcheck_T arg12_deepcopy[] = {arg_any, arg_bool};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001341static argcheck_T arg12_execute[] = {arg_string_or_list_string, arg_string};
zeertzjqe0a2ab32025-02-02 09:14:35 +01001342static argcheck_T arg12_getchar[] = {arg_bool_or_nr, arg_dict_any};
Bram Moolenaarfa103972022-09-29 19:14:42 +01001343static argcheck_T arg23_extend[] = {arg_list_or_dict_mod, arg_same_as_prev, arg_extend3};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001344static argcheck_T arg23_extendnew[] = {arg_list_or_dict, arg_same_struct_as_prev, arg_extend3};
Ernie Raela8f7f922023-12-14 20:17:04 +01001345static argcheck_T arg23_get[] = {arg_get1, arg_string_or_nr, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001346static argcheck_T arg14_glob[] = {arg_string, arg_bool, arg_bool, arg_bool};
1347static argcheck_T arg25_globpath[] = {arg_string, arg_string, arg_bool, arg_bool, arg_bool};
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001348static argcheck_T arg24_index[] = {arg_list_or_tuple_or_blob, arg_item_of_prev, arg_number, arg_bool};
1349static argcheck_T arg23_index[] = {arg_list_or_tuple_or_blob, arg_filter_func, arg_dict_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001350static argcheck_T arg23_insert[] = {arg_list_or_blob, arg_item_of_prev, arg_number};
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001351static argcheck_T arg1_len[] = {arg_len1};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001352static argcheck_T arg3_libcall[] = {arg_string, arg_string, arg_string_or_nr};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001353static argcheck_T arg14_maparg[] = {arg_string, arg_string, arg_bool, arg_bool};
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001354static argcheck_T arg2_filter[] = {arg_list_or_dict_or_blob_or_string_mod, arg_filter_func};
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001355static argcheck_T arg2_foreach[] = {arg_list_tuple_dict_blob_or_string, arg_foreach_func};
Ernie Rael2025af12023-12-12 16:58:00 +01001356static argcheck_T arg2_instanceof[] = {arg_object, varargs_class, NULL };
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001357static argcheck_T arg2_map[] = {arg_list_or_dict_or_blob_or_string_mod, arg_map_func};
Ernie Raela8f7f922023-12-14 20:17:04 +01001358static argcheck_T arg2_mapnew[] = {arg_list_or_dict_or_blob_or_string, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001359static argcheck_T arg25_matchadd[] = {arg_string, arg_string, arg_number, arg_number, arg_dict_any};
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001360static argcheck_T arg25_matchaddpos[] = {arg_string, arg_list_any, arg_number, arg_number, arg_dict_any};
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01001361static argcheck_T arg23_matchstrlist[] = {arg_list_string, arg_string, arg_dict_any};
1362static argcheck_T arg45_matchbufline[] = {arg_buffer, arg_string, arg_lnum, arg_lnum, arg_dict_any};
Ernie Raela8f7f922023-12-14 20:17:04 +01001363static 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};
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001364static argcheck_T arg23_reduce[] = {arg_string_list_tuple_or_blob, arg_any, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001365static argcheck_T arg24_remote_expr[] = {arg_string, arg_string, arg_string, arg_number};
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001366static argcheck_T arg23_remove[] = {arg_list_or_dict_or_blob_mod, arg_remove2, arg_number};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001367static argcheck_T arg2_repeat[] = {arg_repeat1, arg_number};
Bram Moolenaar73199812021-12-26 17:18:14 +00001368static argcheck_T arg15_search[] = {arg_string, arg_string, arg_number, arg_number, arg_string_or_func};
1369static 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 +02001370static argcheck_T arg3_setbufline[] = {arg_buffer, arg_lnum, arg_str_or_nr_or_list};
Ernie Raela8f7f922023-12-14 20:17:04 +01001371static argcheck_T arg2_setline[] = {arg_lnum, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001372static argcheck_T arg24_setloclist[] = {arg_number, arg_list_any, arg_string, arg_dict_any};
1373static argcheck_T arg13_setqflist[] = {arg_list_any, arg_string, arg_dict_any};
1374static argcheck_T arg23_settagstack[] = {arg_number, arg_dict_any, arg_string};
1375static argcheck_T arg02_sign_getplaced[] = {arg_buffer, arg_dict_any};
1376static argcheck_T arg45_sign_place[] = {arg_number, arg_string, arg_string, arg_buffer, arg_dict_any};
1377static argcheck_T arg23_slice[] = {arg_slice1, arg_number, arg_number};
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001378static argcheck_T arg13_sortuniq[] = {arg_list_any_mod, arg_sort_how, arg_dict_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001379static argcheck_T arg24_strpart[] = {arg_string, arg_number, arg_number, arg_bool};
1380static argcheck_T arg12_system[] = {arg_string, arg_str_or_nr_or_list};
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02001381static argcheck_T arg23_win_execute[] = {arg_number, arg_string_or_list_string, arg_string};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001382static argcheck_T arg23_writefile[] = {arg_list_or_blob, arg_string, arg_string};
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02001383static argcheck_T arg24_match_func[] = {arg_string_or_list_any, arg_string, arg_number, arg_number};
Bram Moolenaarcd268012021-07-22 19:11:08 +02001384
Bram Moolenaar32517c42023-01-15 18:17:12 +00001385// Can be used by functions called through "f_retfunc" to create new types.
1386static garray_T *current_type_gap = NULL;
Bram Moolenaar94738d82020-10-21 14:25:07 +02001387
1388/*
1389 * Functions that return the return type of a builtin function.
Bram Moolenaara1224cb2020-10-22 12:31:49 +02001390 * Note that "argtypes" is NULL if "argcount" is zero.
Bram Moolenaar94738d82020-10-21 14:25:07 +02001391 */
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001392 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001393ret_void(int argcount UNUSED,
1394 type2_T *argtypes UNUSED,
1395 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001396{
1397 return &t_void;
1398}
1399 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001400ret_any(int argcount UNUSED,
1401 type2_T *argtypes UNUSED,
1402 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001403{
1404 return &t_any;
1405}
1406 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001407ret_bool(int argcount UNUSED,
1408 type2_T *argtypes UNUSED,
1409 type_T **decl_type UNUSED)
Bram Moolenaar403dc312020-10-17 19:29:51 +02001410{
1411 return &t_bool;
1412}
1413 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001414ret_number_bool(int argcount UNUSED,
1415 type2_T *argtypes UNUSED,
1416 type_T **decl_type UNUSED)
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001417{
1418 return &t_number_bool;
1419}
1420 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001421ret_number(int argcount UNUSED,
1422 type2_T *argtypes UNUSED,
1423 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001424{
1425 return &t_number;
1426}
1427 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001428ret_float(int argcount UNUSED,
1429 type2_T *argtypes UNUSED,
1430 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001431{
1432 return &t_float;
1433}
1434 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001435ret_string(int argcount UNUSED,
1436 type2_T *argtypes UNUSED,
1437 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001438{
1439 return &t_string;
1440}
Bram Moolenaare69f6d02020-04-01 22:11:01 +02001441 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001442ret_list_any(int argcount UNUSED,
1443 type2_T *argtypes UNUSED,
1444 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001445{
1446 return &t_list_any;
1447}
1448 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001449ret_list_number(int argcount UNUSED,
1450 type2_T *argtypes UNUSED,
Bram Moolenaar81330182022-02-01 12:11:58 +00001451 type_T **decl_type)
1452{
Bram Moolenaar81330182022-02-01 12:11:58 +00001453 *decl_type = &t_list_any;
1454 return &t_list_number;
1455}
1456 static type_T *
1457ret_list_string(int argcount UNUSED,
1458 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001459 type_T **decl_type)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001460{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001461 *decl_type = &t_list_any;
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001462 return &t_list_string;
1463}
1464 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001465ret_list_dict_any(int argcount UNUSED,
1466 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001467 type_T **decl_type)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001468{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001469 *decl_type = &t_list_any;
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001470 return &t_list_dict_any;
1471}
1472 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001473ret_list_items(int argcount UNUSED,
1474 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001475 type_T **decl_type)
Bram Moolenaarefc5db52021-07-07 21:21:30 +02001476{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001477 *decl_type = &t_list_any;
Bram Moolenaarefc5db52021-07-07 21:21:30 +02001478 return &t_list_list_any;
1479}
mityu61065042021-07-19 20:07:21 +02001480 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001481ret_list_string_items(int argcount UNUSED,
1482 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001483 type_T **decl_type)
mityu61065042021-07-19 20:07:21 +02001484{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001485 *decl_type = &t_list_any;
mityu61065042021-07-19 20:07:21 +02001486 return &t_list_list_string;
1487}
Bram Moolenaarefc5db52021-07-07 21:21:30 +02001488 static type_T *
zeertzjqd4d12072024-07-16 20:34:16 +02001489ret_list_regionpos(int argcount UNUSED,
1490 type2_T *argtypes UNUSED,
1491 type_T **decl_type)
1492{
1493 *decl_type = &t_list_any;
1494 return &t_list_list_list_number;
1495}
1496 static type_T *
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001497ret_tuple_any(int argcount UNUSED,
1498 type2_T *argtypes UNUSED,
1499 type_T **decl_type UNUSED)
1500{
1501 return &t_tuple_any;
1502}
1503 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001504ret_dict_any(int argcount UNUSED,
1505 type2_T *argtypes UNUSED,
1506 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001507{
1508 return &t_dict_any;
1509}
1510 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001511ret_job_info(int argcount,
1512 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001513 type_T **decl_type)
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01001514{
1515 if (argcount == 0)
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001516 {
1517 *decl_type = &t_list_any;
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01001518 return &t_list_job;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001519 }
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01001520 return &t_dict_any;
1521}
1522 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001523ret_dict_number(int argcount UNUSED,
1524 type2_T *argtypes UNUSED,
1525 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001526{
1527 return &t_dict_number;
1528}
1529 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001530ret_dict_string(int argcount UNUSED,
1531 type2_T *argtypes UNUSED,
1532 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001533{
1534 return &t_dict_string;
1535}
1536 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001537ret_blob(int argcount UNUSED,
1538 type2_T *argtypes UNUSED,
1539 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001540{
1541 return &t_blob;
1542}
1543 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001544ret_func_any(int argcount UNUSED,
1545 type2_T *argtypes UNUSED,
1546 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001547{
Bram Moolenaare69f6d02020-04-01 22:11:01 +02001548 return &t_func_any;
1549}
1550 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001551ret_func_unknown(int argcount UNUSED,
1552 type2_T *argtypes UNUSED,
1553 type_T **decl_type UNUSED)
Bram Moolenaar2f9f4cc2021-12-20 09:36:27 +00001554{
1555 return &t_func_unknown;
1556}
1557 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001558ret_channel(int argcount UNUSED,
1559 type2_T *argtypes UNUSED,
1560 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001561{
1562 return &t_channel;
1563}
1564 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001565ret_job(int argcount UNUSED,
1566 type2_T *argtypes UNUSED,
1567 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001568{
1569 return &t_job;
1570}
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001571 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001572ret_first_arg(int argcount,
1573 type2_T *argtypes,
1574 type_T **decl_type)
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001575{
1576 if (argcount > 0)
Bram Moolenaar81330182022-02-01 12:11:58 +00001577 {
1578 *decl_type = argtypes[0].type_decl;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001579 return argtypes[0].type_curr;
Bram Moolenaar81330182022-02-01 12:11:58 +00001580 }
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001581 return &t_void;
1582}
Bram Moolenaar1780f082021-07-31 22:03:59 +02001583 static type_T *
Bram Moolenaar00eb9952022-02-05 19:23:18 +00001584ret_slice(int argcount,
1585 type2_T *argtypes,
1586 type_T **decl_type)
1587{
1588 if (argcount > 0)
1589 {
1590 if (argtypes[0].type_decl != NULL)
1591 {
1592 switch (argtypes[0].type_decl->tt_type)
1593 {
1594 case VAR_STRING: *decl_type = &t_string; break;
1595 case VAR_BLOB: *decl_type = &t_blob; break;
1596 case VAR_LIST: *decl_type = &t_list_any; break;
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001597 case VAR_TUPLE: *decl_type = &t_tuple_any; break;
Bram Moolenaar00eb9952022-02-05 19:23:18 +00001598 default: break;
1599 }
1600 }
1601 return argtypes[0].type_curr;
1602 }
1603 return &t_void;
1604}
1605 static type_T *
Bram Moolenaar381692b2022-02-02 20:01:27 +00001606ret_copy(int argcount,
1607 type2_T *argtypes,
1608 type_T **decl_type)
1609{
1610 if (argcount > 0)
1611 {
1612 if (argtypes[0].type_decl != NULL)
1613 {
1614 if (argtypes[0].type_decl->tt_type == VAR_LIST)
1615 *decl_type = &t_list_any;
1616 else if (argtypes[0].type_decl->tt_type == VAR_DICT)
1617 *decl_type = &t_dict_any;
1618 else
1619 *decl_type = argtypes[0].type_decl;
1620 }
1621 if (argtypes[0].type_curr != NULL)
1622 {
1623 if (argtypes[0].type_curr->tt_type == VAR_LIST)
1624 return &t_list_any;
1625 else if (argtypes[0].type_curr->tt_type == VAR_DICT)
1626 return &t_dict_any;
1627 }
1628 return argtypes[0].type_curr;
1629 }
1630 return &t_void;
1631}
1632 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001633ret_extend(int argcount,
1634 type2_T *argtypes,
1635 type_T **decl_type)
1636{
1637 if (argcount > 0)
1638 {
1639 *decl_type = argtypes[0].type_decl;
1640 // if the second argument has a different current type then the current
1641 // type is "any"
1642 if (argcount > 1 && !equal_type(argtypes[0].type_curr,
1643 argtypes[1].type_curr, 0))
1644 {
1645 if (argtypes[0].type_curr->tt_type == VAR_LIST)
1646 return &t_list_any;
1647 if (argtypes[0].type_curr->tt_type == VAR_DICT)
1648 return &t_dict_any;
1649 }
1650 return argtypes[0].type_curr;
1651 }
1652 return &t_void;
1653}
1654 static type_T *
1655ret_repeat(int argcount,
1656 type2_T *argtypes,
1657 type_T **decl_type UNUSED)
Bram Moolenaar1780f082021-07-31 22:03:59 +02001658{
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001659 if (argcount == 0)
1660 return &t_any;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001661 if (argtypes[0].type_curr == &t_number)
Bram Moolenaar1780f082021-07-31 22:03:59 +02001662 return &t_string;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001663 return argtypes[0].type_curr;
Bram Moolenaar1780f082021-07-31 22:03:59 +02001664}
Bram Moolenaarea696852020-11-09 18:31:39 +01001665// for map(): returns first argument but item type may differ
1666 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001667ret_first_cont(int argcount,
1668 type2_T *argtypes,
1669 type_T **decl_type UNUSED)
Bram Moolenaarea696852020-11-09 18:31:39 +01001670{
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001671 if (argcount > 0)
1672 {
Bram Moolenaar078a4612022-01-04 15:17:03 +00001673 if (argtypes[0].type_curr->tt_type == VAR_LIST)
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001674 return &t_list_any;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001675 if (argtypes[0].type_curr->tt_type == VAR_DICT)
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001676 return &t_dict_any;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001677 if (argtypes[0].type_curr->tt_type == VAR_BLOB)
1678 return argtypes[0].type_curr;
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001679 }
Bram Moolenaarea696852020-11-09 18:31:39 +01001680 return &t_any;
1681}
Bram Moolenaar078a4612022-01-04 15:17:03 +00001682// for getline()
1683 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001684ret_getline(int argcount,
1685 type2_T *argtypes UNUSED,
1686 type_T **decl_type UNUSED)
Bram Moolenaar078a4612022-01-04 15:17:03 +00001687{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001688 if (argcount == 1)
1689 return &t_string;
1690 *decl_type = &t_list_any;
1691 return &t_list_string;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001692}
Bram Moolenaar08018222021-12-22 18:45:37 +00001693// for finddir()
1694 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001695ret_finddir(int argcount,
1696 type2_T *argtypes UNUSED,
1697 type_T **decl_type UNUSED)
Bram Moolenaar08018222021-12-22 18:45:37 +00001698{
1699 if (argcount < 3)
1700 return &t_string;
1701 // Depending on the count would be a string or a list of strings.
1702 return &t_any;
1703}
Bram Moolenaar32517c42023-01-15 18:17:12 +00001704// for values(): list of member of first argument
1705 static type_T *
1706ret_list_member(int argcount,
1707 type2_T *argtypes,
1708 type_T **decl_type)
1709{
1710 if (argcount > 0)
1711 {
1712 type_T *t = argtypes[0].type_decl;
1713 if (current_type_gap != NULL
1714 && (t->tt_type == VAR_DICT || t->tt_type == VAR_LIST))
1715 t = get_list_type(t->tt_member, current_type_gap);
1716 else
1717 t = &t_list_any;
1718 *decl_type = t;
1719
1720 t = argtypes[0].type_curr;
1721 if (current_type_gap != NULL
1722 && (t->tt_type == VAR_DICT || t->tt_type == VAR_LIST))
1723 return get_list_type(t->tt_member, current_type_gap);
1724 }
1725 return &t_list_any;
1726}
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001727
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001728/*
1729 * Used for getqflist(): returns list if there is no argument, dict if there is
1730 * one.
1731 */
1732 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001733ret_list_or_dict_0(int argcount,
1734 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001735 type_T **decl_type)
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001736{
1737 if (argcount > 0)
1738 return &t_dict_any;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001739 *decl_type = &t_list_any;
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001740 return &t_list_dict_any;
1741}
1742
1743/*
1744 * Used for getloclist(): returns list if there is one argument, dict if there
1745 * are two.
1746 */
1747 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001748ret_list_or_dict_1(int argcount,
1749 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001750 type_T **decl_type)
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001751{
1752 if (argcount > 1)
1753 return &t_dict_any;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001754 *decl_type = &t_list_any;
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001755 return &t_list_dict_any;
1756}
1757
Bram Moolenaar846178a2020-07-05 17:04:13 +02001758 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001759ret_argv(int argcount,
1760 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001761 type_T **decl_type)
Bram Moolenaar846178a2020-07-05 17:04:13 +02001762{
1763 // argv() returns list of strings
1764 if (argcount == 0)
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001765 {
1766 *decl_type = &t_list_any;
Bram Moolenaar846178a2020-07-05 17:04:13 +02001767 return &t_list_string;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001768 }
Bram Moolenaar846178a2020-07-05 17:04:13 +02001769
1770 // argv(0) returns a string, but argv(-1] returns a list
1771 return &t_any;
1772}
1773
Bram Moolenaarad7c2492020-07-05 20:55:29 +02001774 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001775ret_remove(int argcount,
1776 type2_T *argtypes,
Bram Moolenaar2ac037f2022-05-09 14:12:14 +01001777 type_T **decl_type)
Bram Moolenaarad7c2492020-07-05 20:55:29 +02001778{
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001779 if (argcount > 0)
Bram Moolenaar5e654232020-09-16 15:22:00 +02001780 {
Bram Moolenaar078a4612022-01-04 15:17:03 +00001781 if (argtypes[0].type_curr->tt_type == VAR_LIST
1782 || argtypes[0].type_curr->tt_type == VAR_DICT)
Bram Moolenaar81330182022-02-01 12:11:58 +00001783 {
Bram Moolenaar2ac037f2022-05-09 14:12:14 +01001784 if (argcount == 3)
1785 {
1786 *decl_type = argtypes[0].type_decl;
1787 return argtypes[0].type_curr;
1788 }
Bram Moolenaar81330182022-02-01 12:11:58 +00001789 if (argtypes[0].type_curr->tt_type
1790 == argtypes[0].type_decl->tt_type)
1791 *decl_type = argtypes[0].type_decl->tt_member;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001792 return argtypes[0].type_curr->tt_member;
Bram Moolenaar81330182022-02-01 12:11:58 +00001793 }
Bram Moolenaar078a4612022-01-04 15:17:03 +00001794 if (argtypes[0].type_curr->tt_type == VAR_BLOB)
Bram Moolenaar5e654232020-09-16 15:22:00 +02001795 return &t_number;
1796 }
Bram Moolenaarad7c2492020-07-05 20:55:29 +02001797 return &t_any;
1798}
1799
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001800 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001801ret_getreg(int argcount,
1802 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001803 type_T **decl_type)
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001804{
1805 // Assume that if the third argument is passed it's non-zero
1806 if (argcount == 3)
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001807 {
1808 *decl_type = &t_list_any;
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001809 return &t_list_string;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001810 }
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001811 return &t_string;
1812}
1813
Bram Moolenaar4a6d1b62020-08-08 17:55:49 +02001814 static type_T *
LemonBoy0f7a3e12022-05-26 12:10:37 +01001815ret_virtcol(int argcount,
1816 type2_T *argtypes UNUSED,
1817 type_T **decl_type)
1818{
1819 // Assume that if the second argument is passed it's non-zero
zeertzjq825cf812023-08-17 22:55:25 +02001820 if (argcount > 1)
LemonBoy0f7a3e12022-05-26 12:10:37 +01001821 {
1822 *decl_type = &t_list_any;
1823 return &t_list_number;
1824 }
1825 return &t_number;
1826}
1827
1828 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001829ret_maparg(int argcount,
1830 type2_T *argtypes UNUSED,
1831 type_T **decl_type UNUSED)
Bram Moolenaar4a6d1b62020-08-08 17:55:49 +02001832{
1833 // Assume that if the fourth argument is passed it's non-zero
1834 if (argcount == 4)
1835 return &t_dict_any;
1836 return &t_string;
1837}
1838
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001839/*
1840 * Array with names and number of arguments of all internal functions
1841 * MUST BE KEPT SORTED IN strcmp() ORDER FOR BINARY SEARCH!
Ernie Rael2025af12023-12-12 16:58:00 +01001842 *
Ernie Raela8f7f922023-12-14 20:17:04 +01001843 * The builtin function may be varargs. In that case
Ernie Rael2025af12023-12-12 16:58:00 +01001844 * - f_max_argc == VARGS
Ernie Raela8f7f922023-12-14 20:17:04 +01001845 * - For varargs, f_argcheck must be NULL terminated. The last non-null
1846 * entry in f_argcheck should validate all the remaining args.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001847 */
Bram Moolenaarac92e252019-08-03 21:58:38 +02001848typedef struct
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001849{
Bram Moolenaar25e42232019-08-04 15:04:10 +02001850 char *f_name; // function name
1851 char f_min_argc; // minimal number of arguments
1852 char f_max_argc; // maximal number of arguments
Ernie Raeld8bf87c2023-12-16 14:03:33 +01001853 char f_argtype; // for method: FEARG_ values; bits FE_
Ernie Raela8f7f922023-12-14 20:17:04 +01001854 argcheck_T *f_argcheck; // list of functions to check argument types;
1855 // use "arg_any" (not NULL) to accept an
1856 // argument of any type
Bram Moolenaar81330182022-02-01 12:11:58 +00001857 type_T *(*f_retfunc)(int argcount, type2_T *argtypes,
1858 type_T **decl_type);
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001859 // return type function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001860 void (*f_func)(typval_T *args, typval_T *rvar);
Bram Moolenaar25e42232019-08-04 15:04:10 +02001861 // implementation of function
Bram Moolenaarac92e252019-08-03 21:58:38 +02001862} funcentry_T;
1863
Ernie Rael2025af12023-12-12 16:58:00 +01001864// Set f_max_argc to VARGS for varargs.
1865#define VARGS CHAR_MAX
1866
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02001867// values for f_argtype; zero means it cannot be used as a method
Ernie Raeld8bf87c2023-12-16 14:03:33 +01001868#define FEARG_1 0x01 // base is the first argument
1869#define FEARG_2 0x02 // base is the second argument
1870#define FEARG_3 0x03 // base is the third argument
1871#define FEARG_4 0x04 // base is the fourth argument
1872#define FEARG_MASK 0x0F // bits in f_argtype used as argument index
1873#define FE_X 0x10 // builtin accepts a non-value (class, typealias)
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02001874
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001875#if defined(HAVE_MATH_H)
Bram Moolenaar15c47602020-03-26 22:16:48 +01001876# define MATH_FUNC(name) name
1877#else
1878# define MATH_FUNC(name) NULL
1879#endif
1880#ifdef FEAT_TIMERS
1881# define TIMER_FUNC(name) name
1882#else
1883# define TIMER_FUNC(name) NULL
1884#endif
1885#ifdef FEAT_JOB_CHANNEL
1886# define JOB_FUNC(name) name
1887#else
1888# define JOB_FUNC(name) NULL
1889#endif
1890#ifdef FEAT_PROP_POPUP
1891# define PROP_FUNC(name) name
1892#else
1893# define PROP_FUNC(name) NULL
1894#endif
1895#ifdef FEAT_SIGNS
1896# define SIGN_FUNC(name) name
1897#else
1898# define SIGN_FUNC(name) NULL
1899#endif
1900#ifdef FEAT_SOUND
1901# define SOUND_FUNC(name) name
1902#else
1903# define SOUND_FUNC(name) NULL
1904#endif
1905#ifdef FEAT_TERMINAL
1906# define TERM_FUNC(name) name
1907#else
1908# define TERM_FUNC(name) NULL
1909#endif
1910
Bram Moolenaarac92e252019-08-03 21:58:38 +02001911static funcentry_T global_functions[] =
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001912{
Bram Moolenaar94738d82020-10-21 14:25:07 +02001913 {"abs", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001914 ret_any, f_abs},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001915 {"acos", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001916 ret_float, f_acos},
Bram Moolenaarfa103972022-09-29 19:14:42 +01001917 {"add", 2, 2, FEARG_1, arg2_listblobmod_item,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001918 ret_first_arg, f_add},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001919 {"and", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001920 ret_number, f_and},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001921 {"append", 2, 2, FEARG_2, arg2_setline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001922 ret_number_bool, f_append},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001923 {"appendbufline", 3, 3, FEARG_3, arg3_setbufline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001924 ret_number_bool, f_appendbufline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001925 {"argc", 0, 1, 0, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001926 ret_number, f_argc},
1927 {"argidx", 0, 0, 0, NULL,
1928 ret_number, f_argidx},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001929 {"arglistid", 0, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001930 ret_number, f_arglistid},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001931 {"argv", 0, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001932 ret_argv, f_argv},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001933 {"asin", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001934 ret_float, f_asin},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001935 {"assert_beeps", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001936 ret_number_bool, f_assert_beeps},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001937 {"assert_equal", 2, 3, FEARG_2, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001938 ret_number_bool, f_assert_equal},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001939 {"assert_equalfile", 2, 3, FEARG_1, arg3_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001940 ret_number_bool, f_assert_equalfile},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001941 {"assert_exception", 1, 2, 0, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001942 ret_number_bool, f_assert_exception},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001943 {"assert_fails", 1, 5, FEARG_1, arg15_assert_fails,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001944 ret_number_bool, f_assert_fails},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001945 {"assert_false", 1, 2, FEARG_1, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001946 ret_number_bool, f_assert_false},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001947 {"assert_inrange", 3, 4, FEARG_3, arg34_assert_inrange,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001948 ret_number_bool, f_assert_inrange},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001949 {"assert_match", 2, 3, FEARG_2, arg3_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001950 ret_number_bool, f_assert_match},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001951 {"assert_nobeep", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar5b8cabf2021-04-02 18:55:57 +02001952 ret_number_bool, f_assert_nobeep},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001953 {"assert_notequal", 2, 3, FEARG_2, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001954 ret_number_bool, f_assert_notequal},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001955 {"assert_notmatch", 2, 3, FEARG_2, arg3_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001956 ret_number_bool, f_assert_notmatch},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02001957 {"assert_report", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001958 ret_number_bool, f_assert_report},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001959 {"assert_true", 1, 2, FEARG_1, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001960 ret_number_bool, f_assert_true},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001961 {"atan", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001962 ret_float, f_atan},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001963 {"atan2", 2, 2, FEARG_1, arg2_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001964 ret_float, f_atan2},
Yegappan Lakshmanan1755a912022-05-19 10:31:47 +01001965 {"autocmd_add", 1, 1, FEARG_1, arg1_list_any,
1966 ret_number_bool, f_autocmd_add},
1967 {"autocmd_delete", 1, 1, FEARG_1, arg1_list_any,
1968 ret_number_bool, f_autocmd_delete},
1969 {"autocmd_get", 0, 1, FEARG_1, arg1_dict_any,
1970 ret_list_dict_any, f_autocmd_get},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001971 {"balloon_gettext", 0, 0, 0, NULL,
1972 ret_string,
Bram Moolenaar59716a22017-03-01 20:32:44 +01001973#ifdef FEAT_BEVAL
Bram Moolenaar15c47602020-03-26 22:16:48 +01001974 f_balloon_gettext
1975#else
1976 NULL
Bram Moolenaar59716a22017-03-01 20:32:44 +01001977#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01001978 },
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02001979 {"balloon_show", 1, 1, FEARG_1, arg1_string_or_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001980 ret_void,
Bram Moolenaar15c47602020-03-26 22:16:48 +01001981#ifdef FEAT_BEVAL
1982 f_balloon_show
1983#else
1984 NULL
1985#endif
1986 },
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001987 {"balloon_split", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001988 ret_list_string,
Bram Moolenaar15c47602020-03-26 22:16:48 +01001989#if defined(FEAT_BEVAL_TERM)
1990 f_balloon_split
1991#else
1992 NULL
1993#endif
1994 },
Yegappan Lakshmanan810785c2024-12-30 10:29:44 +01001995 {"base64_decode", 1, 1, FEARG_1, arg1_string,
1996 ret_blob, f_base64_decode},
1997 {"base64_encode", 1, 1, FEARG_1, arg1_blob,
1998 ret_string, f_base64_encode},
Christ van Willegence0ef912024-06-20 23:41:59 +02001999 {"bindtextdomain", 2, 2, 0, arg2_string,
Christ van Willegen8252ef12024-07-11 21:36:21 +02002000 ret_bool, f_bindtextdomain},
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +02002001 {"blob2list", 1, 1, FEARG_1, arg1_blob,
2002 ret_list_number, f_blob2list},
Yegappan Lakshmanan1aefe1d2025-01-14 17:29:42 +01002003 {"blob2str", 1, 2, FEARG_1, arg2_blob_dict,
Yegappan Lakshmanan166b1752025-01-17 11:48:12 +01002004 ret_list_string, f_blob2str},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002005 {"browse", 4, 4, 0, arg4_browse,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002006 ret_string, f_browse},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002007 {"browsedir", 2, 2, 0, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002008 ret_string, f_browsedir},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002009 {"bufadd", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002010 ret_number, f_bufadd},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002011 {"bufexists", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002012 ret_number_bool, f_bufexists},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002013 {"buffer_exists", 1, 1, FEARG_1, arg1_buffer, // obsolete
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002014 ret_number_bool, f_bufexists},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002015 {"buffer_name", 0, 1, FEARG_1, arg1_buffer, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02002016 ret_string, f_bufname},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002017 {"buffer_number", 0, 1, FEARG_1, arg1_buffer, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02002018 ret_number, f_bufnr},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002019 {"buflisted", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002020 ret_number_bool, f_buflisted},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002021 {"bufload", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002022 ret_void, f_bufload},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002023 {"bufloaded", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002024 ret_number_bool, f_bufloaded},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002025 {"bufname", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002026 ret_string, f_bufname},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002027 {"bufnr", 0, 2, FEARG_1, arg2_buffer_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002028 ret_number, f_bufnr},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002029 {"bufwinid", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002030 ret_number, f_bufwinid},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002031 {"bufwinnr", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002032 ret_number, f_bufwinnr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002033 {"byte2line", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002034 ret_number, f_byte2line},
Christian Brabandt67672ef2023-04-24 21:09:54 +01002035 {"byteidx", 2, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002036 ret_number, f_byteidx},
Christian Brabandt67672ef2023-04-24 21:09:54 +01002037 {"byteidxcomp", 2, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002038 ret_number, f_byteidxcomp},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002039 {"call", 2, 3, FEARG_1, arg3_any_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002040 ret_any, f_call},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002041 {"ceil", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002042 ret_float, f_ceil},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002043 {"ch_canread", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002044 ret_number_bool, JOB_FUNC(f_ch_canread)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002045 {"ch_close", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002046 ret_void, JOB_FUNC(f_ch_close)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002047 {"ch_close_in", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002048 ret_void, JOB_FUNC(f_ch_close_in)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002049 {"ch_evalexpr", 2, 3, FEARG_1, arg23_chanexpr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002050 ret_any, JOB_FUNC(f_ch_evalexpr)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002051 {"ch_evalraw", 2, 3, FEARG_1, arg23_chanraw,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002052 ret_any, JOB_FUNC(f_ch_evalraw)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002053 {"ch_getbufnr", 2, 2, FEARG_1, arg2_chan_or_job_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002054 ret_number, JOB_FUNC(f_ch_getbufnr)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002055 {"ch_getjob", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002056 ret_job, JOB_FUNC(f_ch_getjob)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002057 {"ch_info", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002058 ret_dict_any, JOB_FUNC(f_ch_info)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002059 {"ch_log", 1, 2, FEARG_1, arg2_string_chan_or_job,
Bram Moolenaar4c5678f2022-11-30 18:12:19 +00002060 ret_void, f_ch_log},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002061 {"ch_logfile", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar4c5678f2022-11-30 18:12:19 +00002062 ret_void, f_ch_logfile},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002063 {"ch_open", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002064 ret_channel, JOB_FUNC(f_ch_open)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002065 {"ch_read", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002066 ret_string, JOB_FUNC(f_ch_read)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002067 {"ch_readblob", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002068 ret_blob, JOB_FUNC(f_ch_readblob)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002069 {"ch_readraw", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002070 ret_string, JOB_FUNC(f_ch_readraw)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002071 {"ch_sendexpr", 2, 3, FEARG_1, arg23_chanexpr,
Yegappan Lakshmanan3b470ae2022-04-16 10:41:27 +01002072 ret_any, JOB_FUNC(f_ch_sendexpr)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002073 {"ch_sendraw", 2, 3, FEARG_1, arg23_chanraw,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002074 ret_void, JOB_FUNC(f_ch_sendraw)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002075 {"ch_setoptions", 2, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002076 ret_void, JOB_FUNC(f_ch_setoptions)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002077 {"ch_status", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002078 ret_string, JOB_FUNC(f_ch_status)},
2079 {"changenr", 0, 0, 0, NULL,
2080 ret_number, f_changenr},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002081 {"char2nr", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002082 ret_number, f_char2nr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002083 {"charclass", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002084 ret_number, f_charclass},
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00002085 {"charcol", 1, 2, FEARG_1, arg2_string_or_list_number,
Bram Moolenaar6f02b002021-01-10 20:22:54 +01002086 ret_number, f_charcol},
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01002087 {"charidx", 2, 4, FEARG_1, arg4_string_number_bool_bool,
Bram Moolenaar17793ef2020-12-28 12:56:58 +01002088 ret_number, f_charidx},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002089 {"chdir", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002090 ret_string, f_chdir},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002091 {"cindent", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002092 ret_number, f_cindent},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002093 {"clearmatches", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002094 ret_void, f_clearmatches},
Girish Palya92f68e22025-04-21 11:12:41 +02002095 {"cmdcomplete_info",0, 0, 0, NULL,
2096 ret_dict_any, f_cmdcomplete_info},
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00002097 {"col", 1, 2, FEARG_1, arg2_string_or_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002098 ret_number, f_col},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002099 {"complete", 2, 2, FEARG_2, arg2_number_list,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002100 ret_void, f_complete},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002101 {"complete_add", 1, 1, FEARG_1, arg1_dict_or_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002102 ret_number, f_complete_add},
2103 {"complete_check", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002104 ret_number_bool, f_complete_check},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002105 {"complete_info", 0, 1, FEARG_1, arg1_list_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002106 ret_dict_any, f_complete_info},
glepnirbcd59952025-04-24 21:48:35 +02002107 {"complete_match", 0, 2, 0, NULL,
2108 ret_list_any, f_complete_match},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002109 {"confirm", 1, 4, FEARG_1, arg4_string_string_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002110 ret_number, f_confirm},
2111 {"copy", 1, 1, FEARG_1, NULL,
Bram Moolenaar381692b2022-02-02 20:01:27 +00002112 ret_copy, f_copy},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002113 {"cos", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002114 ret_float, f_cos},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002115 {"cosh", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002116 ret_float, f_cosh},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002117 {"count", 2, 4, FEARG_1, arg24_count,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002118 ret_number, f_count},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002119 {"cscope_connection",0,3, 0, arg3_number_string_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002120 ret_number, f_cscope_connection},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002121 {"cursor", 1, 3, FEARG_1, arg13_cursor,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002122 ret_number, f_cursor},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002123 {"debugbreak", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002124 ret_number,
Bram Moolenaar4f974752019-02-17 17:44:42 +01002125#ifdef MSWIN
Bram Moolenaar15c47602020-03-26 22:16:48 +01002126 f_debugbreak
2127#else
2128 NULL
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02002129#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002130 },
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002131 {"deepcopy", 1, 2, FEARG_1, arg12_deepcopy,
Bram Moolenaar381692b2022-02-02 20:01:27 +00002132 ret_copy, f_deepcopy},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002133 {"delete", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002134 ret_number_bool, f_delete},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002135 {"deletebufline", 2, 3, FEARG_1, arg3_buffer_lnum_lnum,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002136 ret_number_bool, f_deletebufline},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002137 {"did_filetype", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002138 ret_number_bool, f_did_filetype},
Yegappan Lakshmananfa378352024-02-01 22:05:27 +01002139 {"diff", 2, 3, FEARG_1, arg3_diff,
Yegappan Lakshmanana0010a12024-02-12 20:21:26 +01002140 ret_any, f_diff},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002141 {"diff_filler", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002142 ret_number, f_diff_filler},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002143 {"diff_hlID", 2, 2, FEARG_1, arg2_lnum_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002144 ret_number, f_diff_hlID},
h-east29b85712021-07-26 21:54:04 +02002145 {"digraph_get", 1, 1, FEARG_1, arg1_string,
2146 ret_string, f_digraph_get},
zeertzjqd4d12072024-07-16 20:34:16 +02002147 {"digraph_getlist", 0, 1, FEARG_1, arg1_bool,
h-east29b85712021-07-26 21:54:04 +02002148 ret_list_string_items, f_digraph_getlist},
Yegappan Lakshmananfc3b7752021-09-08 14:57:42 +02002149 {"digraph_set", 2, 2, FEARG_1, arg2_string,
h-east29b85712021-07-26 21:54:04 +02002150 ret_bool, f_digraph_set},
zeertzjqd4d12072024-07-16 20:34:16 +02002151 {"digraph_setlist", 1, 1, FEARG_1, arg1_list_string,
h-east29b85712021-07-26 21:54:04 +02002152 ret_bool, f_digraph_setlist},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002153 {"echoraw", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002154 ret_void, f_echoraw},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002155 {"empty", 1, 1, FEARG_1, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002156 ret_number_bool, f_empty},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002157 {"environ", 0, 0, 0, NULL,
2158 ret_dict_string, f_environ},
Bram Moolenaar80adaa82023-07-07 18:57:40 +01002159 {"err_teapot", 0, 1, 0, NULL,
2160 ret_number_bool, f_err_teapot},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002161 {"escape", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002162 ret_string, f_escape},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002163 {"eval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002164 ret_any, f_eval},
2165 {"eventhandler", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002166 ret_number_bool, f_eventhandler},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002167 {"executable", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002168 ret_number, f_executable},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002169 {"execute", 1, 2, FEARG_1, arg12_execute,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002170 ret_string, f_execute},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002171 {"exepath", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002172 ret_string, f_exepath},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002173 {"exists", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002174 ret_number_bool, f_exists},
Bram Moolenaar26735992021-08-08 14:43:22 +02002175 {"exists_compiled", 1, 1, FEARG_1, arg1_string,
2176 ret_number_bool, f_exists_compiled},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002177 {"exp", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002178 ret_float, f_exp},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002179 {"expand", 1, 3, FEARG_1, arg3_string_bool_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002180 ret_any, f_expand},
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01002181 {"expandcmd", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002182 ret_string, f_expandcmd},
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01002183 {"extend", 2, 3, FEARG_1, arg23_extend,
Bram Moolenaar81330182022-02-01 12:11:58 +00002184 ret_extend, f_extend},
Bram Moolenaarb0e6b512021-01-12 20:23:40 +01002185 {"extendnew", 2, 3, FEARG_1, arg23_extendnew,
2186 ret_first_cont, f_extendnew},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002187 {"feedkeys", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002188 ret_void, f_feedkeys},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002189 {"file_readable", 1, 1, FEARG_1, arg1_string, // obsolete
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002190 ret_number_bool, f_filereadable},
Shougo Matsushita60c87432024-06-03 22:59:27 +02002191 {"filecopy", 2, 2, FEARG_1, arg2_string,
2192 ret_number_bool, f_filecopy},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002193 {"filereadable", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002194 ret_number_bool, f_filereadable},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002195 {"filewritable", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002196 ret_number, f_filewritable},
Bram Moolenaar18024052021-12-25 21:43:28 +00002197 {"filter", 2, 2, FEARG_1, arg2_filter,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002198 ret_first_arg, f_filter},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002199 {"finddir", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar08018222021-12-22 18:45:37 +00002200 ret_finddir, f_finddir},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002201 {"findfile", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar10c83dd2021-09-04 14:49:56 +02002202 ret_any, f_findfile},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002203 {"flatten", 1, 2, FEARG_1, arg2_list_any_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002204 ret_list_any, f_flatten},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002205 {"flattennew", 1, 2, FEARG_1, arg2_list_any_number,
Bram Moolenaar3b690062021-02-01 20:14:51 +01002206 ret_list_any, f_flattennew},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002207 {"float2nr", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002208 ret_number, f_float2nr},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002209 {"floor", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002210 ret_float, f_floor},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002211 {"fmod", 2, 2, FEARG_1, arg2_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002212 ret_float, f_fmod},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002213 {"fnameescape", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002214 ret_string, f_fnameescape},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002215 {"fnamemodify", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002216 ret_string, f_fnamemodify},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002217 {"foldclosed", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002218 ret_number, f_foldclosed},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002219 {"foldclosedend", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002220 ret_number, f_foldclosedend},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002221 {"foldlevel", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002222 ret_number, f_foldlevel},
2223 {"foldtext", 0, 0, 0, NULL,
2224 ret_string, f_foldtext},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002225 {"foldtextresult", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002226 ret_string, f_foldtextresult},
Ernie Raele79e2072024-01-13 11:47:33 +01002227 {"foreach", 2, 2, FEARG_1, arg2_foreach,
2228 ret_first_arg, f_foreach},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002229 {"foreground", 0, 0, 0, NULL,
2230 ret_void, f_foreground},
Bram Moolenaardd44b582022-09-15 22:03:57 +01002231 {"fullcommand", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar038e09e2021-02-06 12:38:51 +01002232 ret_string, f_fullcommand},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002233 {"funcref", 1, 3, FEARG_1, arg3_any_list_dict,
Bram Moolenaar2f9f4cc2021-12-20 09:36:27 +00002234 ret_func_unknown, f_funcref},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002235 {"function", 1, 3, FEARG_1, arg3_any_list_dict,
Bram Moolenaar2f9f4cc2021-12-20 09:36:27 +00002236 ret_func_unknown, f_function},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002237 {"garbagecollect", 0, 1, 0, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002238 ret_void, f_garbagecollect},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002239 {"get", 2, 3, FEARG_1, arg23_get,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002240 ret_any, f_get},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002241 {"getbufinfo", 0, 1, FEARG_1, arg1_buffer_or_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002242 ret_list_dict_any, f_getbufinfo},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002243 {"getbufline", 2, 3, FEARG_1, arg3_buffer_lnum_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002244 ret_list_string, f_getbufline},
Bram Moolenaarce30ccc2022-11-21 19:57:04 +00002245 {"getbufoneline", 2, 2, FEARG_1, arg2_buffer_lnum,
2246 ret_string, f_getbufoneline},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002247 {"getbufvar", 2, 3, FEARG_1, arg3_buffer_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002248 ret_any, f_getbufvar},
mikoto20001083cae2024-11-11 21:24:14 +01002249 {"getcellpixels", 0, 0, 0, NULL,
mikoto2000a73dfc22024-11-18 21:12:21 +01002250 ret_list_any, f_getcellpixels},
Kota Kato66bb9ae2023-01-17 18:31:56 +00002251 {"getcellwidths", 0, 0, 0, NULL,
2252 ret_list_any, f_getcellwidths},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002253 {"getchangelist", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002254 ret_list_any, f_getchangelist},
zeertzjqe0a2ab32025-02-02 09:14:35 +01002255 {"getchar", 0, 2, 0, arg12_getchar,
Bram Moolenaar3a7503c2021-06-07 18:29:17 +02002256 ret_any, f_getchar},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002257 {"getcharmod", 0, 0, 0, NULL,
2258 ret_number, f_getcharmod},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002259 {"getcharpos", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar6f02b002021-01-10 20:22:54 +01002260 ret_list_number, f_getcharpos},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002261 {"getcharsearch", 0, 0, 0, NULL,
2262 ret_dict_any, f_getcharsearch},
zeertzjqe0a2ab32025-02-02 09:14:35 +01002263 {"getcharstr", 0, 2, 0, arg12_getchar,
Bram Moolenaar3a7503c2021-06-07 18:29:17 +02002264 ret_string, f_getcharstr},
Ruslan Russkikh0407d622024-10-08 22:21:05 +02002265 {"getcmdcomplpat", 0, 0, 0, NULL,
2266 ret_string, f_getcmdcomplpat},
Hirohito Higashi96b3ef22025-07-05 15:31:23 +02002267 {"getcmdcompltype", 0, 0, 0, NULL,
Shougo Matsushita79d599b2022-05-07 12:48:29 +01002268 ret_string, f_getcmdcompltype},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002269 {"getcmdline", 0, 0, 0, NULL,
2270 ret_string, f_getcmdline},
2271 {"getcmdpos", 0, 0, 0, NULL,
2272 ret_number, f_getcmdpos},
Shougo Matsushita69084282024-09-23 20:34:47 +02002273 {"getcmdprompt", 0, 0, 0, NULL,
2274 ret_string, f_getcmdprompt},
Shougo Matsushita79d599b2022-05-07 12:48:29 +01002275 {"getcmdscreenpos", 0, 0, 0, NULL,
2276 ret_number, f_getcmdscreenpos},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002277 {"getcmdtype", 0, 0, 0, NULL,
2278 ret_string, f_getcmdtype},
2279 {"getcmdwintype", 0, 0, 0, NULL,
2280 ret_string, f_getcmdwintype},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002281 {"getcompletion", 2, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002282 ret_list_string, f_getcompletion},
Hirohito Higashi96b3ef22025-07-05 15:31:23 +02002283 {"getcompletiontype", 1, 1, FEARG_1, arg1_string,
2284 ret_string, f_getcompletiontype},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002285 {"getcurpos", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002286 ret_list_number, f_getcurpos},
Bram Moolenaar82e46e52022-02-05 18:12:34 +00002287 {"getcursorcharpos", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar6f02b002021-01-10 20:22:54 +01002288 ret_list_number, f_getcursorcharpos},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002289 {"getcwd", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002290 ret_string, f_getcwd},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002291 {"getenv", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar7ad67d12021-03-10 16:08:26 +01002292 ret_any, f_getenv},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002293 {"getfontname", 0, 1, 0, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002294 ret_string, f_getfontname},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002295 {"getfperm", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002296 ret_string, f_getfperm},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002297 {"getfsize", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002298 ret_number, f_getfsize},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002299 {"getftime", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002300 ret_number, f_getftime},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002301 {"getftype", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002302 ret_string, f_getftype},
2303 {"getimstatus", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002304 ret_number_bool, f_getimstatus},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002305 {"getjumplist", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002306 ret_list_any, f_getjumplist},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002307 {"getline", 1, 2, FEARG_1, arg2_lnum,
Bram Moolenaar078a4612022-01-04 15:17:03 +00002308 ret_getline, f_getline},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002309 {"getloclist", 1, 2, 0, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002310 ret_list_or_dict_1, f_getloclist},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002311 {"getmarklist", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002312 ret_list_dict_any, f_getmarklist},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002313 {"getmatches", 0, 1, 0, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002314 ret_list_dict_any, f_getmatches},
2315 {"getmousepos", 0, 0, 0, NULL,
2316 ret_dict_number, f_getmousepos},
Bram Moolenaar24dc19c2022-11-14 19:49:15 +00002317 {"getmouseshape", 0, 0, 0, NULL,
2318 ret_string, f_getmouseshape},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002319 {"getpid", 0, 0, 0, NULL,
2320 ret_number, f_getpid},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002321 {"getpos", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002322 ret_list_number, f_getpos},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002323 {"getqflist", 0, 1, 0, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002324 ret_list_or_dict_0, f_getqflist},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002325 {"getreg", 0, 3, FEARG_1, arg3_string_bool_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002326 ret_getreg, f_getreg},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002327 {"getreginfo", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002328 ret_dict_any, f_getreginfo},
Shougo Matsushita19b71882024-02-28 22:48:12 +01002329 {"getregion", 2, 3, FEARG_1, arg3_list_list_dict,
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01002330 ret_list_string, f_getregion},
zeertzjqd4d12072024-07-16 20:34:16 +02002331 {"getregionpos", 2, 3, FEARG_1, arg3_list_list_dict,
2332 ret_list_regionpos, f_getregionpos},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002333 {"getregtype", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002334 ret_string, f_getregtype},
Yegappan Lakshmanan520f6ef2022-08-25 17:40:40 +01002335 {"getscriptinfo", 0, 1, 0, arg1_dict_any,
Yegappan Lakshmananf768c3d2022-08-22 13:15:13 +01002336 ret_list_dict_any, f_getscriptinfo},
ichizok663d18d2025-01-02 18:06:00 +01002337 {"getstacktrace", 0, 0, 0, NULL,
2338 ret_list_dict_any, f_getstacktrace},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002339 {"gettabinfo", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002340 ret_list_dict_any, f_gettabinfo},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002341 {"gettabvar", 2, 3, FEARG_1, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002342 ret_any, f_gettabvar},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002343 {"gettabwinvar", 3, 4, FEARG_1, arg4_number_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002344 ret_any, f_gettabwinvar},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002345 {"gettagstack", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002346 ret_dict_any, f_gettagstack},
Christ van Willegence0ef912024-06-20 23:41:59 +02002347 {"gettext", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002348 ret_string, f_gettext},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002349 {"getwininfo", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002350 ret_list_dict_any, f_getwininfo},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002351 {"getwinpos", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002352 ret_list_number, f_getwinpos},
2353 {"getwinposx", 0, 0, 0, NULL,
2354 ret_number, f_getwinposx},
2355 {"getwinposy", 0, 0, 0, NULL,
2356 ret_number, f_getwinposy},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002357 {"getwinvar", 2, 3, FEARG_1, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002358 ret_any, f_getwinvar},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002359 {"glob", 1, 4, FEARG_1, arg14_glob,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002360 ret_any, f_glob},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002361 {"glob2regpat", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002362 ret_string, f_glob2regpat},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002363 {"globpath", 2, 5, FEARG_2, arg25_globpath,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002364 ret_any, f_globpath},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002365 {"has", 1, 2, 0, arg2_string_bool,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002366 ret_number_bool, f_has},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002367 {"has_key", 2, 2, FEARG_1, arg2_dict_any_string_or_nr,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002368 ret_number_bool, f_has_key},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002369 {"haslocaldir", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002370 ret_number, f_haslocaldir},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002371 {"hasmapto", 1, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002372 ret_number_bool, f_hasmapto},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002373 {"highlightID", 1, 1, FEARG_1, arg1_string, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02002374 ret_number, f_hlID},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002375 {"highlight_exists",1, 1, FEARG_1, arg1_string, // obsolete
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002376 ret_number_bool, f_hlexists},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002377 {"histadd", 2, 2, FEARG_2, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002378 ret_number_bool, f_histadd},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002379 {"histdel", 1, 2, FEARG_1, arg2_string_string_or_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002380 ret_number_bool, f_histdel},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002381 {"histget", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002382 ret_string, f_histget},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002383 {"histnr", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002384 ret_number, f_histnr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002385 {"hlID", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002386 ret_number, f_hlID},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002387 {"hlexists", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002388 ret_number_bool, f_hlexists},
Yegappan Lakshmanand1a8d652021-11-03 21:56:45 +00002389 {"hlget", 0, 2, FEARG_1, arg2_string_bool,
2390 ret_list_dict_any, f_hlget},
2391 {"hlset", 1, 1, FEARG_1, arg1_list_any,
2392 ret_number_bool, f_hlset},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002393 {"hostname", 0, 0, 0, NULL,
2394 ret_string, f_hostname},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002395 {"iconv", 3, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002396 ret_string, f_iconv},
Ernie Raelc8e158b2024-07-09 18:39:52 +02002397 {"id", 1, 1, FEARG_1, NULL,
2398 ret_string, f_id},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002399 {"indent", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002400 ret_number, f_indent},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002401 {"index", 2, 4, FEARG_1, arg24_index,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002402 ret_number, f_index},
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01002403 {"indexof", 2, 3, FEARG_1, arg23_index,
2404 ret_number, f_indexof},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002405 {"input", 1, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002406 ret_string, f_input},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002407 {"inputdialog", 1, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002408 ret_string, f_inputdialog},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002409 {"inputlist", 1, 1, FEARG_1, arg1_list_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002410 ret_number, f_inputlist},
2411 {"inputrestore", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002412 ret_number_bool, f_inputrestore},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002413 {"inputsave", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002414 ret_number_bool, f_inputsave},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002415 {"inputsecret", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002416 ret_string, f_inputsecret},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002417 {"insert", 2, 3, FEARG_1, arg23_insert,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002418 ret_first_arg, f_insert},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002419 {"instanceof", 2, VARGS, FEARG_1|FE_X, arg2_instanceof,
LemonBoyafe04662023-08-23 21:08:11 +02002420 ret_bool, f_instanceof},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002421 {"interrupt", 0, 0, 0, NULL,
2422 ret_void, f_interrupt},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002423 {"invert", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002424 ret_number, f_invert},
LemonBoydca1d402022-04-28 15:26:33 +01002425 {"isabsolutepath", 1, 1, FEARG_1, arg1_string,
2426 ret_number_bool, f_isabsolutepath},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002427 {"isdirectory", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002428 ret_number_bool, f_isdirectory},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002429 {"isinf", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002430 ret_number, MATH_FUNC(f_isinf)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002431 {"islocked", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002432 ret_number_bool, f_islocked},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002433 {"isnan", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002434 ret_number_bool, MATH_FUNC(f_isnan)},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01002435 {"items", 1, 1, FEARG_1, arg1_string_list_tuple_or_dict,
Bram Moolenaarefc5db52021-07-07 21:21:30 +02002436 ret_list_items, f_items},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002437 {"job_getchannel", 1, 1, FEARG_1, arg1_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002438 ret_channel, JOB_FUNC(f_job_getchannel)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002439 {"job_info", 0, 1, FEARG_1, arg1_job,
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01002440 ret_job_info, JOB_FUNC(f_job_info)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002441 {"job_setoptions", 2, 2, FEARG_1, arg2_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002442 ret_void, JOB_FUNC(f_job_setoptions)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002443 {"job_start", 1, 2, FEARG_1, arg2_string_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002444 ret_job, JOB_FUNC(f_job_start)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002445 {"job_status", 1, 1, FEARG_1, arg1_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002446 ret_string, JOB_FUNC(f_job_status)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002447 {"job_stop", 1, 2, FEARG_1, arg2_job_string_or_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002448 ret_number_bool, JOB_FUNC(f_job_stop)},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01002449 {"join", 1, 2, FEARG_1, arg2_list_or_tuple_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002450 ret_string, f_join},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002451 {"js_decode", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002452 ret_any, f_js_decode},
2453 {"js_encode", 1, 1, FEARG_1, NULL,
2454 ret_string, f_js_encode},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002455 {"json_decode", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002456 ret_any, f_json_decode},
2457 {"json_encode", 1, 1, FEARG_1, NULL,
2458 ret_string, f_json_encode},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002459 {"keys", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002460 ret_list_string, f_keys},
zeertzjqcdc83932022-09-12 13:38:41 +01002461 {"keytrans", 1, 1, FEARG_1, arg1_string,
2462 ret_string, f_keytrans},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002463 {"last_buffer_nr", 0, 0, 0, NULL, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02002464 ret_number, f_last_buffer_nr},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002465 {"len", 1, 1, FEARG_1, arg1_len,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002466 ret_number, f_len},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002467 {"libcall", 3, 3, FEARG_3, arg3_libcall,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002468 ret_string, f_libcall},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002469 {"libcallnr", 3, 3, FEARG_3, arg3_libcall,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002470 ret_number, f_libcallnr},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002471 {"line", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002472 ret_number, f_line},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002473 {"line2byte", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002474 ret_number, f_line2byte},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002475 {"lispindent", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002476 ret_number, f_lispindent},
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +02002477 {"list2blob", 1, 1, FEARG_1, arg1_list_number,
2478 ret_blob, f_list2blob},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002479 {"list2str", 1, 2, FEARG_1, arg2_list_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002480 ret_string, f_list2str},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01002481 {"list2tuple", 1, 1, FEARG_1, arg1_list_any,
2482 ret_tuple_any, f_list2tuple},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002483 {"listener_add", 1, 2, FEARG_2, arg2_any_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002484 ret_number, f_listener_add},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002485 {"listener_flush", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002486 ret_void, f_listener_flush},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002487 {"listener_remove", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002488 ret_number_bool, f_listener_remove},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002489 {"localtime", 0, 0, 0, NULL,
2490 ret_number, f_localtime},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002491 {"log", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002492 ret_float, f_log},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002493 {"log10", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002494 ret_float, f_log10},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002495 {"luaeval", 1, 2, FEARG_1, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002496 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002497#ifdef FEAT_LUA
Bram Moolenaar15c47602020-03-26 22:16:48 +01002498 f_luaeval
2499#else
2500 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002501#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002502 },
Bram Moolenaar18024052021-12-25 21:43:28 +00002503 {"map", 2, 2, FEARG_1, arg2_map,
Bram Moolenaarea696852020-11-09 18:31:39 +01002504 ret_first_cont, f_map},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002505 {"maparg", 1, 4, FEARG_1, arg14_maparg,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002506 ret_maparg, f_maparg},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002507 {"mapcheck", 1, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002508 ret_string, f_mapcheck},
Ernie Rael09661202022-04-25 14:40:44 +01002509 {"maplist", 0, 1, 0, arg1_bool,
2510 ret_list_dict_any, f_maplist},
Bram Moolenaar18024052021-12-25 21:43:28 +00002511 {"mapnew", 2, 2, FEARG_1, arg2_mapnew,
Bram Moolenaarea696852020-11-09 18:31:39 +01002512 ret_first_cont, f_mapnew},
Ernie Rael51d04d12022-05-04 15:40:22 +01002513 {"mapset", 1, 3, FEARG_1, arg3_string_or_dict_bool_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002514 ret_void, f_mapset},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002515 {"match", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002516 ret_any, f_match},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002517 {"matchadd", 2, 5, FEARG_1, arg25_matchadd,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002518 ret_number, f_matchadd},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002519 {"matchaddpos", 2, 5, FEARG_1, arg25_matchaddpos,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002520 ret_number, f_matchaddpos},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002521 {"matcharg", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002522 ret_list_string, f_matcharg},
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01002523 {"matchbufline", 4, 5, FEARG_1, arg45_matchbufline,
2524 ret_list_any, f_matchbufline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002525 {"matchdelete", 1, 2, FEARG_1, arg2_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002526 ret_number_bool, f_matchdelete},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002527 {"matchend", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002528 ret_number, f_matchend},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002529 {"matchfuzzy", 2, 3, FEARG_1, arg3_list_string_dict,
Yegappan Lakshmanan2d8e9982023-06-24 16:42:25 +01002530 ret_list_any, f_matchfuzzy},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002531 {"matchfuzzypos", 2, 3, FEARG_1, arg3_list_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002532 ret_list_any, f_matchfuzzypos},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002533 {"matchlist", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002534 ret_list_string, f_matchlist},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002535 {"matchstr", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002536 ret_string, f_matchstr},
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01002537 {"matchstrlist", 2, 3, FEARG_1, arg23_matchstrlist,
2538 ret_list_any, f_matchstrlist},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002539 {"matchstrpos", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002540 ret_list_any, f_matchstrpos},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01002541 {"max", 1, 1, FEARG_1, arg1_list_or_tuple_or_dict,
Bram Moolenaar9ae37052021-01-22 22:31:10 +01002542 ret_number, f_max},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002543 {"menu_info", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002544 ret_dict_any,
Bram Moolenaara2cbdea2020-03-16 21:08:31 +01002545#ifdef FEAT_MENU
Bram Moolenaar15c47602020-03-26 22:16:48 +01002546 f_menu_info
2547#else
2548 NULL
Bram Moolenaara2cbdea2020-03-16 21:08:31 +01002549#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002550 },
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01002551 {"min", 1, 1, FEARG_1, arg1_list_or_tuple_or_dict,
Bram Moolenaar9ae37052021-01-22 22:31:10 +01002552 ret_number, f_min},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002553 {"mkdir", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002554 ret_number_bool, f_mkdir},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002555 {"mode", 0, 1, FEARG_1, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002556 ret_string, f_mode},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002557 {"mzeval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002558 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002559#ifdef FEAT_MZSCHEME
Bram Moolenaar15c47602020-03-26 22:16:48 +01002560 f_mzeval
2561#else
2562 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002563#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002564 },
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002565 {"nextnonblank", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002566 ret_number, f_nextnonblank},
Christ van Willegenc0786752025-02-01 15:42:16 +01002567 {"ngettext", 3, 4, FEARG_3, arg4_string_string_number_string,
2568 ret_string, f_ngettext},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002569 {"nr2char", 1, 2, FEARG_1, arg2_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002570 ret_string, f_nr2char},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002571 {"or", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002572 ret_number, f_or},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002573 {"pathshorten", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002574 ret_string, f_pathshorten},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002575 {"perleval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002576 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002577#ifdef FEAT_PERL
Bram Moolenaar15c47602020-03-26 22:16:48 +01002578 f_perleval
2579#else
2580 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002581#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002582 },
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002583 {"popup_atcursor", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002584 ret_number, PROP_FUNC(f_popup_atcursor)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002585 {"popup_beval", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002586 ret_number, PROP_FUNC(f_popup_beval)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002587 {"popup_clear", 0, 1, 0, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002588 ret_void, PROP_FUNC(f_popup_clear)},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002589 {"popup_close", 1, 2, FEARG_1, arg2_number_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002590 ret_void, PROP_FUNC(f_popup_close)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002591 {"popup_create", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002592 ret_number, PROP_FUNC(f_popup_create)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002593 {"popup_dialog", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002594 ret_number, PROP_FUNC(f_popup_dialog)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002595 {"popup_filter_menu", 2, 2, 0, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002596 ret_bool, PROP_FUNC(f_popup_filter_menu)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002597 {"popup_filter_yesno", 2, 2, 0, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002598 ret_bool, PROP_FUNC(f_popup_filter_yesno)},
Bram Moolenaarbdc09a12022-10-07 14:31:45 +01002599 {"popup_findecho", 0, 0, 0, NULL,
2600 ret_number, PROP_FUNC(f_popup_findecho)},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002601 {"popup_findinfo", 0, 0, 0, NULL,
2602 ret_number, PROP_FUNC(f_popup_findinfo)},
2603 {"popup_findpreview", 0, 0, 0, NULL,
2604 ret_number, PROP_FUNC(f_popup_findpreview)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002605 {"popup_getoptions", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002606 ret_dict_any, PROP_FUNC(f_popup_getoptions)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002607 {"popup_getpos", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002608 ret_dict_any, PROP_FUNC(f_popup_getpos)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002609 {"popup_hide", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002610 ret_void, PROP_FUNC(f_popup_hide)},
2611 {"popup_list", 0, 0, 0, NULL,
2612 ret_list_number, PROP_FUNC(f_popup_list)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002613 {"popup_locate", 2, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002614 ret_number, PROP_FUNC(f_popup_locate)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002615 {"popup_menu", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002616 ret_number, PROP_FUNC(f_popup_menu)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002617 {"popup_move", 2, 2, FEARG_1, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002618 ret_void, PROP_FUNC(f_popup_move)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002619 {"popup_notification", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002620 ret_number, PROP_FUNC(f_popup_notification)},
Christian Brabandtfbc37f12024-06-18 20:50:58 +02002621 {"popup_setbuf", 2, 2, FEARG_1, arg2_number_buffer,
2622 ret_number_bool, PROP_FUNC(f_popup_setbuf)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002623 {"popup_setoptions", 2, 2, FEARG_1, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002624 ret_void, PROP_FUNC(f_popup_setoptions)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002625 {"popup_settext", 2, 2, FEARG_1, arg2_number_string_or_list,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002626 ret_void, PROP_FUNC(f_popup_settext)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002627 {"popup_show", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002628 ret_void, PROP_FUNC(f_popup_show)},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002629 {"pow", 2, 2, FEARG_1, arg2_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002630 ret_float, f_pow},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002631 {"prevnonblank", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002632 ret_number, f_prevnonblank},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002633 {"printf", 1, 19, FEARG_2, arg119_printf,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002634 ret_string, f_printf},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002635 {"prompt_getprompt", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002636 ret_string, JOB_FUNC(f_prompt_getprompt)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002637 {"prompt_setcallback", 2, 2, FEARG_1, arg2_buffer_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002638 ret_void, JOB_FUNC(f_prompt_setcallback)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002639 {"prompt_setinterrupt", 2, 2, FEARG_1, arg2_buffer_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002640 ret_void, JOB_FUNC(f_prompt_setinterrupt)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002641 {"prompt_setprompt", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002642 ret_void, JOB_FUNC(f_prompt_setprompt)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002643 {"prop_add", 3, 3, FEARG_1, arg3_number_number_dict,
Bram Moolenaar7f9969c2022-07-25 18:13:54 +01002644 ret_number, PROP_FUNC(f_prop_add)},
Yegappan Lakshmananccfb7c62021-08-16 21:39:09 +02002645 {"prop_add_list", 2, 2, FEARG_1, arg2_dict_any_list_any,
2646 ret_void, PROP_FUNC(f_prop_add_list)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002647 {"prop_clear", 1, 3, FEARG_1, arg3_number_number_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002648 ret_void, PROP_FUNC(f_prop_clear)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002649 {"prop_find", 1, 2, FEARG_1, arg2_dict_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002650 ret_dict_any, PROP_FUNC(f_prop_find)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002651 {"prop_list", 1, 2, FEARG_1, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002652 ret_list_dict_any, PROP_FUNC(f_prop_list)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002653 {"prop_remove", 1, 3, FEARG_1, arg3_dict_number_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002654 ret_number, PROP_FUNC(f_prop_remove)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002655 {"prop_type_add", 2, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002656 ret_void, PROP_FUNC(f_prop_type_add)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002657 {"prop_type_change", 2, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002658 ret_void, PROP_FUNC(f_prop_type_change)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002659 {"prop_type_delete", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002660 ret_void, PROP_FUNC(f_prop_type_delete)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002661 {"prop_type_get", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002662 ret_dict_any, PROP_FUNC(f_prop_type_get)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002663 {"prop_type_list", 0, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002664 ret_list_string, PROP_FUNC(f_prop_type_list)},
2665 {"pum_getpos", 0, 0, 0, NULL,
2666 ret_dict_number, f_pum_getpos},
2667 {"pumvisible", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002668 ret_number_bool, f_pumvisible},
Ben Jacksonea19e782024-11-06 21:50:05 +01002669 {"py3eval", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002670 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002671#ifdef FEAT_PYTHON3
Bram Moolenaar15c47602020-03-26 22:16:48 +01002672 f_py3eval
2673#else
2674 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002675#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002676 },
Ben Jacksonea19e782024-11-06 21:50:05 +01002677 {"pyeval", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002678 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002679#ifdef FEAT_PYTHON
Bram Moolenaar15c47602020-03-26 22:16:48 +01002680 f_pyeval
2681#else
2682 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002683#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002684 },
Ben Jacksonea19e782024-11-06 21:50:05 +01002685 {"pyxeval", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002686 ret_any,
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01002687#if defined(FEAT_PYTHON) || defined(FEAT_PYTHON3)
Bram Moolenaar15c47602020-03-26 22:16:48 +01002688 f_pyxeval
2689#else
2690 NULL
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01002691#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002692 },
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002693 {"rand", 0, 1, FEARG_1, arg1_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002694 ret_number, f_rand},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002695 {"range", 1, 3, FEARG_1, arg3_number,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00002696 ret_list_number, f_range},
K.Takata11df3ae2022-10-19 14:02:40 +01002697 {"readblob", 1, 3, FEARG_1, arg3_string_number_number,
Bram Moolenaarc423ad72021-01-13 20:38:03 +01002698 ret_blob, f_readblob},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002699 {"readdir", 1, 3, FEARG_1, arg3_string_any_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002700 ret_list_string, f_readdir},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002701 {"readdirex", 1, 3, FEARG_1, arg3_string_any_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002702 ret_list_dict_any, f_readdirex},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002703 {"readfile", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaarc423ad72021-01-13 20:38:03 +01002704 ret_list_string, f_readfile},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002705 {"reduce", 2, 3, FEARG_1, arg23_reduce,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002706 ret_any, f_reduce},
2707 {"reg_executing", 0, 0, 0, NULL,
2708 ret_string, f_reg_executing},
2709 {"reg_recording", 0, 0, 0, NULL,
2710 ret_string, f_reg_recording},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002711 {"reltime", 0, 2, FEARG_1, arg2_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002712 ret_list_any, f_reltime},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002713 {"reltimefloat", 1, 1, FEARG_1, arg1_list_number,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002714 ret_float, f_reltimefloat},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002715 {"reltimestr", 1, 1, FEARG_1, arg1_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002716 ret_string, f_reltimestr},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002717 {"remote_expr", 2, 4, FEARG_1, arg24_remote_expr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002718 ret_string, f_remote_expr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002719 {"remote_foreground", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002720 ret_string, f_remote_foreground},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002721 {"remote_peek", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002722 ret_number, f_remote_peek},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002723 {"remote_read", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002724 ret_string, f_remote_read},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002725 {"remote_send", 2, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002726 ret_string, f_remote_send},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002727 {"remote_startserver", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002728 ret_void, f_remote_startserver},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002729 {"remove", 2, 3, FEARG_1, arg23_remove,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002730 ret_remove, f_remove},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002731 {"rename", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002732 ret_number_bool, f_rename},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002733 {"repeat", 2, 2, FEARG_1, arg2_repeat,
Bram Moolenaar1780f082021-07-31 22:03:59 +02002734 ret_repeat, f_repeat},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002735 {"resolve", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002736 ret_string, f_resolve},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01002737 {"reverse", 1, 1, FEARG_1, arg1_reverse,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002738 ret_first_arg, f_reverse},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002739 {"round", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002740 ret_float, f_round},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002741 {"rubyeval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002742 ret_any,
Bram Moolenaare99be0e2019-03-26 22:51:09 +01002743#ifdef FEAT_RUBY
Bram Moolenaar15c47602020-03-26 22:16:48 +01002744 f_rubyeval
2745#else
2746 NULL
Bram Moolenaare99be0e2019-03-26 22:51:09 +01002747#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002748 },
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002749 {"screenattr", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002750 ret_number, f_screenattr},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002751 {"screenchar", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002752 ret_number, f_screenchar},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002753 {"screenchars", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002754 ret_list_number, f_screenchars},
2755 {"screencol", 0, 0, 0, NULL,
2756 ret_number, f_screencol},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002757 {"screenpos", 3, 3, FEARG_1, arg3_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002758 ret_dict_number, f_screenpos},
2759 {"screenrow", 0, 0, 0, NULL,
2760 ret_number, f_screenrow},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002761 {"screenstring", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002762 ret_string, f_screenstring},
Bram Moolenaarcd268012021-07-22 19:11:08 +02002763 {"search", 1, 5, FEARG_1, arg15_search,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002764 ret_number, f_search},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002765 {"searchcount", 0, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002766 ret_dict_any, f_searchcount},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002767 {"searchdecl", 1, 3, FEARG_1, arg3_string_bool_bool,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002768 ret_number_bool, f_searchdecl},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002769 {"searchpair", 3, 7, 0, arg37_searchpair,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002770 ret_number, f_searchpair},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002771 {"searchpairpos", 3, 7, 0, arg37_searchpair,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002772 ret_list_number, f_searchpairpos},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002773 {"searchpos", 1, 5, FEARG_1, arg15_search,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002774 ret_list_number, f_searchpos},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002775 {"server2client", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002776 ret_number_bool, f_server2client},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002777 {"serverlist", 0, 0, 0, NULL,
2778 ret_string, f_serverlist},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002779 {"setbufline", 3, 3, FEARG_3, arg3_setbufline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002780 ret_number_bool, f_setbufline},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002781 {"setbufvar", 3, 3, FEARG_3, arg3_buffer_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002782 ret_void, f_setbufvar},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002783 {"setcellwidths", 1, 1, FEARG_1, arg1_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002784 ret_void, f_setcellwidths},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002785 {"setcharpos", 2, 2, FEARG_2, arg2_string_list_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002786 ret_number_bool, f_setcharpos},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002787 {"setcharsearch", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002788 ret_void, f_setcharsearch},
Shougo Matsushita07ea5f12022-08-27 12:22:25 +01002789 {"setcmdline", 1, 2, FEARG_1, arg2_string_number,
2790 ret_number_bool, f_setcmdline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002791 {"setcmdpos", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002792 ret_number_bool, f_setcmdpos},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002793 {"setcursorcharpos", 1, 3, FEARG_1, arg13_cursor,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002794 ret_number_bool, f_setcursorcharpos},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002795 {"setenv", 2, 2, FEARG_2, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002796 ret_void, f_setenv},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002797 {"setfperm", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002798 ret_number_bool, f_setfperm},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002799 {"setline", 2, 2, FEARG_2, arg2_setline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002800 ret_number_bool, f_setline},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002801 {"setloclist", 2, 4, FEARG_2, arg24_setloclist,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002802 ret_number_bool, f_setloclist},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002803 {"setmatches", 1, 2, FEARG_1, arg2_list_any_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002804 ret_number_bool, f_setmatches},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002805 {"setpos", 2, 2, FEARG_2, arg2_string_list_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002806 ret_number_bool, f_setpos},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002807 {"setqflist", 1, 3, FEARG_1, arg13_setqflist,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002808 ret_number_bool, f_setqflist},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002809 {"setreg", 2, 3, FEARG_2, arg3_string_any_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002810 ret_number_bool, f_setreg},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002811 {"settabvar", 3, 3, FEARG_3, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002812 ret_void, f_settabvar},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002813 {"settabwinvar", 4, 4, FEARG_4, arg4_number_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002814 ret_void, f_settabwinvar},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002815 {"settagstack", 2, 3, FEARG_2, arg23_settagstack,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002816 ret_number_bool, f_settagstack},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002817 {"setwinvar", 3, 3, FEARG_3, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002818 ret_void, f_setwinvar},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002819 {"sha256", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002820 ret_string,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002821#ifdef FEAT_CRYPT
Bram Moolenaar15c47602020-03-26 22:16:48 +01002822 f_sha256
2823#else
2824 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002825#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002826 },
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002827 {"shellescape", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002828 ret_string, f_shellescape},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002829 {"shiftwidth", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002830 ret_number, f_shiftwidth},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002831 {"sign_define", 1, 2, FEARG_1, arg2_string_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002832 ret_any, SIGN_FUNC(f_sign_define)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002833 {"sign_getdefined", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002834 ret_list_dict_any, SIGN_FUNC(f_sign_getdefined)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002835 {"sign_getplaced", 0, 2, FEARG_1, arg02_sign_getplaced,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002836 ret_list_dict_any, SIGN_FUNC(f_sign_getplaced)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002837 {"sign_jump", 3, 3, FEARG_1, arg3_number_string_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002838 ret_number, SIGN_FUNC(f_sign_jump)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002839 {"sign_place", 4, 5, FEARG_1, arg45_sign_place,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002840 ret_number, SIGN_FUNC(f_sign_place)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002841 {"sign_placelist", 1, 1, FEARG_1, arg1_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002842 ret_list_number, SIGN_FUNC(f_sign_placelist)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002843 {"sign_undefine", 0, 1, FEARG_1, arg1_string_or_list_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002844 ret_number_bool, SIGN_FUNC(f_sign_undefine)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002845 {"sign_unplace", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002846 ret_number_bool, SIGN_FUNC(f_sign_unplace)},
Sean Dewara63780b2021-11-03 13:15:47 +00002847 {"sign_unplacelist", 1, 1, FEARG_1, arg1_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002848 ret_list_number, SIGN_FUNC(f_sign_unplacelist)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002849 {"simplify", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002850 ret_string, f_simplify},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002851 {"sin", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002852 ret_float, f_sin},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002853 {"sinh", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002854 ret_float, f_sinh},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002855 {"slice", 2, 3, FEARG_1, arg23_slice,
Bram Moolenaar00eb9952022-02-05 19:23:18 +00002856 ret_slice, f_slice},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002857 {"sort", 1, 3, FEARG_1, arg13_sortuniq,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002858 ret_first_arg, f_sort},
2859 {"sound_clear", 0, 0, 0, NULL,
2860 ret_void, SOUND_FUNC(f_sound_clear)},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002861 {"sound_playevent", 1, 2, FEARG_1, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002862 ret_number, SOUND_FUNC(f_sound_playevent)},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002863 {"sound_playfile", 1, 2, FEARG_1, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002864 ret_number, SOUND_FUNC(f_sound_playfile)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002865 {"sound_stop", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002866 ret_void, SOUND_FUNC(f_sound_stop)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002867 {"soundfold", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002868 ret_string, f_soundfold},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002869 {"spellbadword", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002870 ret_list_string, f_spellbadword},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002871 {"spellsuggest", 1, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002872 ret_list_string, f_spellsuggest},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002873 {"split", 1, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002874 ret_list_string, f_split},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002875 {"sqrt", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002876 ret_float, f_sqrt},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002877 {"srand", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002878 ret_list_number, f_srand},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002879 {"state", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002880 ret_string, f_state},
Yegappan Lakshmanana11b23c2025-01-16 19:16:42 +01002881 {"str2blob", 1, 2, FEARG_1, arg2_list_string_dict,
Yegappan Lakshmanan1aefe1d2025-01-14 17:29:42 +01002882 ret_blob, f_str2blob},
Bram Moolenaar80a070c2021-08-08 15:51:10 +02002883 {"str2float", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002884 ret_float, f_str2float},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002885 {"str2list", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002886 ret_list_number, f_str2list},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002887 {"str2nr", 1, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002888 ret_number, f_str2nr},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002889 {"strcharlen", 1, 1, FEARG_1, arg1_string_or_nr,
Bram Moolenaar70ce8a12021-03-14 19:02:09 +01002890 ret_number, f_strcharlen},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002891 {"strcharpart", 2, 4, FEARG_1, arg24_strpart,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002892 ret_string, f_strcharpart},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002893 {"strchars", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002894 ret_number, f_strchars},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002895 {"strdisplaywidth", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002896 ret_number, f_strdisplaywidth},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002897 {"strftime", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002898 ret_string,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002899#ifdef HAVE_STRFTIME
Bram Moolenaar15c47602020-03-26 22:16:48 +01002900 f_strftime
2901#else
2902 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002903#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002904 },
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002905 {"strgetchar", 2, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002906 ret_number, f_strgetchar},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002907 {"stridx", 2, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002908 ret_number, f_stridx},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002909 {"string", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002910 ret_string, f_string},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002911 {"strlen", 1, 1, FEARG_1, arg1_string_or_nr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002912 ret_number, f_strlen},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002913 {"strpart", 2, 4, FEARG_1, arg24_strpart,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002914 ret_string, f_strpart},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002915 {"strptime", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002916 ret_number,
Bram Moolenaar10455d42019-11-21 15:36:18 +01002917#ifdef HAVE_STRPTIME
Bram Moolenaar15c47602020-03-26 22:16:48 +01002918 f_strptime
2919#else
2920 NULL
Bram Moolenaar10455d42019-11-21 15:36:18 +01002921#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002922 },
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002923 {"strridx", 2, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002924 ret_number, f_strridx},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002925 {"strtrans", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002926 ret_string, f_strtrans},
Christian Brabandt67672ef2023-04-24 21:09:54 +01002927 {"strutf16len", 1, 2, FEARG_1, arg2_string_bool,
2928 ret_number, f_strutf16len},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002929 {"strwidth", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002930 ret_number, f_strwidth},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002931 {"submatch", 1, 2, FEARG_1, arg2_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002932 ret_string, f_submatch},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002933 {"substitute", 4, 4, FEARG_1, arg4_string_string_any_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002934 ret_string, f_substitute},
Bram Moolenaarc216a7a2022-12-05 13:50:55 +00002935 {"swapfilelist", 0, 0, 0, NULL,
2936 ret_list_string, f_swapfilelist},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002937 {"swapinfo", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002938 ret_dict_any, f_swapinfo},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002939 {"swapname", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002940 ret_string, f_swapname},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002941 {"synID", 3, 3, 0, arg3_lnum_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002942 ret_number, f_synID},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002943 {"synIDattr", 2, 3, FEARG_1, arg3_number_string_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002944 ret_string, f_synIDattr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002945 {"synIDtrans", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002946 ret_number, f_synIDtrans},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002947 {"synconcealed", 2, 2, 0, arg2_lnum_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002948 ret_list_any, f_synconcealed},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002949 {"synstack", 2, 2, 0, arg2_lnum_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002950 ret_list_number, f_synstack},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002951 {"system", 1, 2, FEARG_1, arg12_system,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002952 ret_string, f_system},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002953 {"systemlist", 1, 2, FEARG_1, arg12_system,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002954 ret_list_string, f_systemlist},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002955 {"tabpagebuflist", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002956 ret_list_number, f_tabpagebuflist},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002957 {"tabpagenr", 0, 1, 0, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002958 ret_number, f_tabpagenr},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002959 {"tabpagewinnr", 1, 2, FEARG_1, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002960 ret_number, f_tabpagewinnr},
2961 {"tagfiles", 0, 0, 0, NULL,
2962 ret_list_string, f_tagfiles},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002963 {"taglist", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002964 ret_list_dict_any, f_taglist},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002965 {"tan", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002966 ret_float, f_tan},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002967 {"tanh", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002968 ret_float, f_tanh},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002969 {"tempname", 0, 0, 0, NULL,
2970 ret_string, f_tempname},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002971 {"term_dumpdiff", 2, 3, FEARG_1, arg3_string_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002972 ret_number, TERM_FUNC(f_term_dumpdiff)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002973 {"term_dumpload", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002974 ret_number, TERM_FUNC(f_term_dumpload)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002975 {"term_dumpwrite", 2, 3, FEARG_2, arg3_buffer_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002976 ret_void, TERM_FUNC(f_term_dumpwrite)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002977 {"term_getaltscreen", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002978 ret_number, TERM_FUNC(f_term_getaltscreen)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002979 {"term_getansicolors", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002980 ret_list_string,
Bram Moolenaarbd5e6222020-03-26 23:13:34 +01002981#if defined(FEAT_TERMINAL) && (defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS))
Bram Moolenaar15c47602020-03-26 22:16:48 +01002982 f_term_getansicolors
2983#else
2984 NULL
Bram Moolenaarc6df10e2017-07-29 20:15:08 +02002985#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002986 },
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002987 {"term_getattr", 2, 2, FEARG_1, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002988 ret_number, TERM_FUNC(f_term_getattr)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002989 {"term_getcursor", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002990 ret_list_any, TERM_FUNC(f_term_getcursor)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002991 {"term_getjob", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002992 ret_job, TERM_FUNC(f_term_getjob)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002993 {"term_getline", 2, 2, FEARG_1, arg2_buffer_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002994 ret_string, TERM_FUNC(f_term_getline)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002995 {"term_getscrolled", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002996 ret_number, TERM_FUNC(f_term_getscrolled)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002997 {"term_getsize", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002998 ret_list_number, TERM_FUNC(f_term_getsize)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002999 {"term_getstatus", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003000 ret_string, TERM_FUNC(f_term_getstatus)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003001 {"term_gettitle", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003002 ret_string, TERM_FUNC(f_term_gettitle)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003003 {"term_gettty", 1, 2, FEARG_1, arg2_buffer_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003004 ret_string, TERM_FUNC(f_term_gettty)},
3005 {"term_list", 0, 0, 0, NULL,
3006 ret_list_number, TERM_FUNC(f_term_list)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003007 {"term_scrape", 2, 2, FEARG_1, arg2_buffer_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003008 ret_list_dict_any, TERM_FUNC(f_term_scrape)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003009 {"term_sendkeys", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003010 ret_void, TERM_FUNC(f_term_sendkeys)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003011 {"term_setansicolors", 2, 2, FEARG_1, arg2_buffer_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003012 ret_void,
Bram Moolenaarbd5e6222020-03-26 23:13:34 +01003013#if defined(FEAT_TERMINAL) && (defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS))
Bram Moolenaar15c47602020-03-26 22:16:48 +01003014 f_term_setansicolors
3015#else
3016 NULL
3017#endif
3018 },
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003019 {"term_setapi", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003020 ret_void, TERM_FUNC(f_term_setapi)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003021 {"term_setkill", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003022 ret_void, TERM_FUNC(f_term_setkill)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003023 {"term_setrestore", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003024 ret_void, TERM_FUNC(f_term_setrestore)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003025 {"term_setsize", 3, 3, FEARG_1, arg3_buffer_number_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003026 ret_void, TERM_FUNC(f_term_setsize)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003027 {"term_start", 1, 2, FEARG_1, arg2_string_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003028 ret_number, TERM_FUNC(f_term_start)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003029 {"term_wait", 1, 2, FEARG_1, arg2_buffer_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003030 ret_void, TERM_FUNC(f_term_wait)},
3031 {"terminalprops", 0, 0, 0, NULL,
3032 ret_dict_string, f_terminalprops},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003033 {"test_alloc_fail", 3, 3, FEARG_1, arg3_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003034 ret_void, f_test_alloc_fail},
3035 {"test_autochdir", 0, 0, 0, NULL,
3036 ret_void, f_test_autochdir},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003037 {"test_feedinput", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003038 ret_void, f_test_feedinput},
3039 {"test_garbagecollect_now", 0, 0, 0, NULL,
3040 ret_void, f_test_garbagecollect_now},
3041 {"test_garbagecollect_soon", 0, 0, 0, NULL,
3042 ret_void, f_test_garbagecollect_soon},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003043 {"test_getvalue", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003044 ret_number, f_test_getvalue},
Yegappan Lakshmanan06011e12022-01-30 12:37:29 +00003045 {"test_gui_event", 2, 2, FEARG_1, arg2_string_dict,
3046 ret_bool, f_test_gui_event},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003047 {"test_ignore_error", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003048 ret_void, f_test_ignore_error},
Christopher Plewright20b795e2022-12-20 20:01:58 +00003049 {"test_mswin_event", 2, 2, FEARG_1, arg2_string_dict,
3050 ret_number, f_test_mswin_event},
Bram Moolenaar94738d82020-10-21 14:25:07 +02003051 {"test_null_blob", 0, 0, 0, NULL,
3052 ret_blob, f_test_null_blob},
3053 {"test_null_channel", 0, 0, 0, NULL,
3054 ret_channel, JOB_FUNC(f_test_null_channel)},
3055 {"test_null_dict", 0, 0, 0, NULL,
3056 ret_dict_any, f_test_null_dict},
3057 {"test_null_function", 0, 0, 0, NULL,
3058 ret_func_any, f_test_null_function},
3059 {"test_null_job", 0, 0, 0, NULL,
3060 ret_job, JOB_FUNC(f_test_null_job)},
3061 {"test_null_list", 0, 0, 0, NULL,
3062 ret_list_any, f_test_null_list},
3063 {"test_null_partial", 0, 0, 0, NULL,
3064 ret_func_any, f_test_null_partial},
3065 {"test_null_string", 0, 0, 0, NULL,
3066 ret_string, f_test_null_string},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01003067 {"test_null_tuple", 0, 0, 0, NULL,
3068 ret_tuple_any, f_test_null_tuple},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003069 {"test_option_not_set", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003070 ret_void, f_test_option_not_set},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02003071 {"test_override", 2, 2, FEARG_2, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003072 ret_void, f_test_override},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003073 {"test_refcount", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003074 ret_number, f_test_refcount},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003075 {"test_setmouse", 2, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003076 ret_void, f_test_setmouse},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003077 {"test_settime", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003078 ret_void, f_test_settime},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003079 {"test_srand_seed", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003080 ret_void, f_test_srand_seed},
3081 {"test_unknown", 0, 0, 0, NULL,
3082 ret_any, f_test_unknown},
3083 {"test_void", 0, 0, 0, NULL,
3084 ret_void, f_test_void},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02003085 {"timer_info", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003086 ret_list_dict_any, TIMER_FUNC(f_timer_info)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003087 {"timer_pause", 2, 2, FEARG_1, arg2_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003088 ret_void, TIMER_FUNC(f_timer_pause)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02003089 {"timer_start", 2, 3, FEARG_1, arg3_number_any_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003090 ret_number, TIMER_FUNC(f_timer_start)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02003091 {"timer_stop", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003092 ret_void, TIMER_FUNC(f_timer_stop)},
3093 {"timer_stopall", 0, 0, 0, NULL,
3094 ret_void, TIMER_FUNC(f_timer_stopall)},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003095 {"tolower", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003096 ret_string, f_tolower},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003097 {"toupper", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003098 ret_string, f_toupper},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003099 {"tr", 3, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003100 ret_string, f_tr},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003101 {"trim", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003102 ret_string, f_trim},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003103 {"trunc", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01003104 ret_float, f_trunc},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01003105 {"tuple2list", 1, 1, FEARG_1, arg1_tuple_any,
3106 ret_list_any, f_tuple2list},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003107 {"type", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003108 ret_number, f_type},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003109 {"typename", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaara47e05f2021-01-12 21:49:00 +01003110 ret_string, f_typename},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02003111 {"undofile", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003112 ret_string, f_undofile},
Devin J. Pohly5fee1112023-04-23 20:26:59 -05003113 {"undotree", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003114 ret_dict_any, f_undotree},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02003115 {"uniq", 1, 3, FEARG_1, arg13_sortuniq,
Bram Moolenaar08018222021-12-22 18:45:37 +00003116 ret_first_arg, f_uniq},
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01003117 {"utf16idx", 2, 4, FEARG_1, arg4_string_number_bool_bool,
Christian Brabandt67672ef2023-04-24 21:09:54 +01003118 ret_number, f_utf16idx},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02003119 {"values", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar32517c42023-01-15 18:17:12 +00003120 ret_list_member, f_values},
zeertzjq825cf812023-08-17 22:55:25 +02003121 {"virtcol", 1, 3, FEARG_1, arg3_string_or_list_bool_number,
LemonBoy0f7a3e12022-05-26 12:10:37 +01003122 ret_virtcol, f_virtcol},
Bram Moolenaar5a6ec102022-05-27 21:58:00 +01003123 {"virtcol2col", 3, 3, FEARG_1, arg3_number,
3124 ret_number, f_virtcol2col},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02003125 {"visualmode", 0, 1, 0, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003126 ret_string, f_visualmode},
3127 {"wildmenumode", 0, 0, 0, NULL,
3128 ret_number, f_wildmenumode},
Bram Moolenaar52312242021-07-11 18:23:19 +02003129 {"win_execute", 2, 3, FEARG_2, arg23_win_execute,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003130 ret_string, f_win_execute},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02003131 {"win_findbuf", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003132 ret_list_number, f_win_findbuf},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02003133 {"win_getid", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003134 ret_number, f_win_getid},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003135 {"win_gettype", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003136 ret_string, f_win_gettype},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003137 {"win_gotoid", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01003138 ret_number_bool, f_win_gotoid},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003139 {"win_id2tabwin", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003140 ret_list_number, f_win_id2tabwin},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003141 {"win_id2win", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003142 ret_number, f_win_id2win},
Daniel Steinbergee630312022-01-10 13:36:34 +00003143 {"win_move_separator", 2, 2, FEARG_1, arg2_number,
3144 ret_number_bool, f_win_move_separator},
3145 {"win_move_statusline", 2, 2, FEARG_1, arg2_number,
3146 ret_number_bool, f_win_move_statusline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003147 {"win_screenpos", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003148 ret_list_number, f_win_screenpos},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02003149 {"win_splitmove", 2, 3, FEARG_1, arg3_number_number_dict,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01003150 ret_number_bool, f_win_splitmove},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003151 {"winbufnr", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003152 ret_number, f_winbufnr},
3153 {"wincol", 0, 0, 0, NULL,
3154 ret_number, f_wincol},
3155 {"windowsversion", 0, 0, 0, NULL,
3156 ret_string, f_windowsversion},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003157 {"winheight", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003158 ret_number, f_winheight},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003159 {"winlayout", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003160 ret_list_any, f_winlayout},
3161 {"winline", 0, 0, 0, NULL,
3162 ret_number, f_winline},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02003163 {"winnr", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003164 ret_number, f_winnr},
3165 {"winrestcmd", 0, 0, 0, NULL,
3166 ret_string, f_winrestcmd},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02003167 {"winrestview", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003168 ret_void, f_winrestview},
3169 {"winsaveview", 0, 0, 0, NULL,
Bram Moolenaar43b69b32021-01-07 20:23:33 +01003170 ret_dict_number, f_winsaveview},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003171 {"winwidth", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003172 ret_number, f_winwidth},
3173 {"wordcount", 0, 0, 0, NULL,
3174 ret_dict_number, f_wordcount},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02003175 {"writefile", 2, 3, FEARG_1, arg23_writefile,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01003176 ret_number_bool, f_writefile},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003177 {"xor", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003178 ret_number, f_xor},
Bram Moolenaarac92e252019-08-03 21:58:38 +02003179};
3180
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003181/*
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003182 * Return true if specified function allows a type as an argument.
3183 */
3184 static int
3185func_allows_type(int idx)
3186{
3187 return (global_functions[idx].f_argtype & FE_X) != 0;
3188}
3189
3190/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003191 * Function given to ExpandGeneric() to obtain the list of internal
3192 * or user defined function names.
3193 */
3194 char_u *
3195get_function_name(expand_T *xp, int idx)
3196{
3197 static int intidx = -1;
3198 char_u *name;
3199
3200 if (idx == 0)
3201 intidx = -1;
3202 if (intidx < 0)
3203 {
3204 name = get_user_func_name(xp, idx);
naohiro ono5aec7552021-08-19 21:20:41 +02003205 if (name != NULL)
Bram Moolenaar1bb4de52021-01-13 19:48:46 +01003206 {
naohiro ono5aec7552021-08-19 21:20:41 +02003207 if (*name != NUL && *name != '<'
3208 && STRNCMP("g:", xp->xp_pattern, 2) == 0)
Bram Moolenaar1bb4de52021-01-13 19:48:46 +01003209 return cat_prefix_varname('g', name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003210 return name;
Bram Moolenaar1bb4de52021-01-13 19:48:46 +01003211 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003212 }
K.Takataeeec2542021-06-02 13:28:16 +02003213 if (++intidx < (int)ARRAY_LENGTH(global_functions))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003214 {
Kota Kato90c23532023-01-18 15:27:38 +00003215 // Skip if the function doesn't have an implementation (feature not
3216 // implemented).
3217 if (global_functions[intidx].f_func == NULL)
3218 return (char_u *)"";
Bram Moolenaarac92e252019-08-03 21:58:38 +02003219 STRCPY(IObuff, global_functions[intidx].f_name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003220 STRCAT(IObuff, "(");
Bram Moolenaarac92e252019-08-03 21:58:38 +02003221 if (global_functions[intidx].f_max_argc == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003222 STRCAT(IObuff, ")");
3223 return IObuff;
3224 }
3225
3226 return NULL;
3227}
3228
3229/*
3230 * Function given to ExpandGeneric() to obtain the list of internal or
3231 * user defined variable or function names.
3232 */
3233 char_u *
3234get_expr_name(expand_T *xp, int idx)
3235{
3236 static int intidx = -1;
3237 char_u *name;
3238
3239 if (idx == 0)
3240 intidx = -1;
3241 if (intidx < 0)
3242 {
3243 name = get_function_name(xp, idx);
3244 if (name != NULL)
3245 return name;
3246 }
3247 return get_user_var_name(xp, ++intidx);
3248}
3249
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003250/*
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003251 * Find internal function "name" in table "global_functions".
Bram Moolenaar15c47602020-03-26 22:16:48 +01003252 * Return index, or -1 if not found or "implemented" is TRUE and the function
3253 * is not implemented.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003254 */
Bram Moolenaar15c47602020-03-26 22:16:48 +01003255 static int
3256find_internal_func_opt(char_u *name, int implemented)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003257{
3258 int first = 0;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003259 int last;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003260 int cmp;
3261 int x;
3262
K.Takataeeec2542021-06-02 13:28:16 +02003263 last = (int)ARRAY_LENGTH(global_functions) - 1;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003264
3265 // Find the function name in the table. Binary search.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003266 while (first <= last)
3267 {
3268 x = first + ((unsigned)(last - first) >> 1);
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003269 cmp = STRCMP(name, global_functions[x].f_name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003270 if (cmp < 0)
3271 last = x - 1;
3272 else if (cmp > 0)
3273 first = x + 1;
Bram Moolenaar15c47602020-03-26 22:16:48 +01003274 else if (implemented && global_functions[x].f_func == NULL)
3275 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003276 else
3277 return x;
3278 }
3279 return -1;
3280}
3281
Bram Moolenaar15c47602020-03-26 22:16:48 +01003282/*
3283 * Find internal function "name" in table "global_functions".
3284 * Return index, or -1 if not found or the function is not implemented.
3285 */
3286 int
3287find_internal_func(char_u *name)
3288{
3289 return find_internal_func_opt(name, TRUE);
3290}
3291
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003292 int
Bram Moolenaarac92e252019-08-03 21:58:38 +02003293has_internal_func(char_u *name)
3294{
Bram Moolenaar15c47602020-03-26 22:16:48 +01003295 return find_internal_func_opt(name, TRUE) >= 0;
3296}
3297
3298 static int
3299has_internal_func_name(char_u *name)
3300{
3301 return find_internal_func_opt(name, FALSE) >= 0;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003302}
3303
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003304 char *
3305internal_func_name(int idx)
3306{
3307 return global_functions[idx].f_name;
3308}
3309
Bram Moolenaar94738d82020-10-21 14:25:07 +02003310/*
Dominique Pellefe8ebdb2021-05-13 14:55:55 +02003311 * Check the argument types for builtin function "idx".
Bram Moolenaar94738d82020-10-21 14:25:07 +02003312 * Uses the list of types on the type stack: "types".
3313 * Return FAIL and gives an error message when a type is wrong.
3314 */
3315 int
Bram Moolenaar351ead02021-01-16 16:07:01 +01003316internal_func_check_arg_types(
Bram Moolenaar078a4612022-01-04 15:17:03 +00003317 type2_T *types,
Bram Moolenaar351ead02021-01-16 16:07:01 +01003318 int idx,
3319 int argcount,
3320 cctx_T *cctx)
Bram Moolenaar94738d82020-10-21 14:25:07 +02003321{
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003322 // Some internal functions accept types like Class as arguments. For other
3323 // functions, check the arguments are not types.
3324 if (!(func_allows_type(idx)))
3325 {
zeertzjqd9be94c2024-07-14 10:20:20 +02003326 for (int i = 0; i < argcount; ++i)
3327 if (check_type_is_value(types[i].type_curr) == FAIL)
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003328 return FAIL;
3329 }
3330
Bram Moolenaar94738d82020-10-21 14:25:07 +02003331 argcheck_T *argchecks = global_functions[idx].f_argcheck;
Bram Moolenaar94738d82020-10-21 14:25:07 +02003332
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003333 if (argchecks == NULL)
3334 return OK;
Bram Moolenaar94738d82020-10-21 14:25:07 +02003335
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003336 argcontext_T context;
3337
3338 context.arg_count = argcount;
3339 context.arg_types = types;
3340 context.arg_cctx = cctx;
Ernie Raela8f7f922023-12-14 20:17:04 +01003341 for (int i = 0; i < argcount && argchecks[i] != NULL; ++i)
3342 {
3343 context.arg_idx = i;
3344 if (argchecks[i](types[i].type_curr, types[i].type_decl,
3345 &context) == FAIL)
3346 return FAIL;
3347 }
Bram Moolenaar94738d82020-10-21 14:25:07 +02003348 return OK;
3349}
3350
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003351/*
Bram Moolenaar7a40ff02021-07-04 15:54:08 +02003352 * Get the argument count for function "idx".
3353 * "argcount" is the total argument count, "min_argcount" the non-optional
3354 * argument count.
3355 */
3356 void
3357internal_func_get_argcount(int idx, int *argcount, int *min_argcount)
3358{
3359 *argcount = global_functions[idx].f_max_argc;
3360 *min_argcount = global_functions[idx].f_min_argc;
3361}
3362
3363/*
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003364 * Call the "f_retfunc" function to obtain the return type of function "idx".
Bram Moolenaar81330182022-02-01 12:11:58 +00003365 * "decl_type" is set to the declared type.
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003366 * "argtypes" is the list of argument types or NULL when there are no
3367 * arguments.
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02003368 * "argcount" may be less than the actual count when only getting the type.
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003369 */
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003370 type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00003371internal_func_ret_type(
3372 int idx,
3373 int argcount,
3374 type2_T *argtypes,
Bram Moolenaar32517c42023-01-15 18:17:12 +00003375 type_T **decl_type,
3376 garray_T *type_gap)
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003377{
Bram Moolenaar81330182022-02-01 12:11:58 +00003378 type_T *ret;
3379
Bram Moolenaar32517c42023-01-15 18:17:12 +00003380 current_type_gap = type_gap;
Bram Moolenaar81330182022-02-01 12:11:58 +00003381 *decl_type = NULL;
3382 ret = global_functions[idx].f_retfunc(argcount, argtypes, decl_type);
3383 if (*decl_type == NULL)
3384 *decl_type = ret;
Bram Moolenaar32517c42023-01-15 18:17:12 +00003385 current_type_gap = NULL;
Bram Moolenaar81330182022-02-01 12:11:58 +00003386 return ret;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003387}
3388
3389/*
Bram Moolenaar75ab91f2021-01-10 22:42:50 +01003390 * Return TRUE if "idx" is for the map() function.
3391 */
3392 int
3393internal_func_is_map(int idx)
3394{
3395 return global_functions[idx].f_func == f_map;
3396}
3397
3398/*
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003399 * Check the argument count to use for internal function "idx".
Bram Moolenaar389df252020-07-09 21:20:47 +02003400 * Returns -1 for failure, 0 if no method base accepted, 1 if method base is
3401 * first argument, 2 if method base is second argument, etc. 9 if method base
3402 * is last argument.
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003403 */
3404 int
3405check_internal_func(int idx, int argcount)
3406{
Bram Moolenaar0917e862023-02-18 14:42:44 +00003407 funcerror_T res;
3408 char *name;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003409
3410 if (argcount < global_functions[idx].f_min_argc)
3411 res = FCERR_TOOFEW;
3412 else if (argcount > global_functions[idx].f_max_argc)
3413 res = FCERR_TOOMANY;
3414 else
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003415 return global_functions[idx].f_argtype & FEARG_MASK;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003416
3417 name = internal_func_name(idx);
3418 if (res == FCERR_TOOMANY)
Bram Moolenaare1242042021-12-16 20:56:57 +00003419 semsg(_(e_too_many_arguments_for_function_str), name);
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003420 else
Bram Moolenaare1242042021-12-16 20:56:57 +00003421 semsg(_(e_not_enough_arguments_for_function_str), name);
Bram Moolenaar389df252020-07-09 21:20:47 +02003422 return -1;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003423}
3424
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003425/*
3426 * Some internal functions accept types like Class as arguments. For other
3427 * functions, check the arguments are not types.
3428 *
3429 * Return OK/FAIL.
3430 */
3431 static int
3432check_args_for_type(int idx, int argcount, typval_T *argvars)
3433{
3434 if (!func_allows_type(idx))
3435 {
3436 for (int i = 0; i < argcount; ++i)
3437 if (check_typval_is_value(&argvars[i]) == FAIL)
3438 return FAIL;
3439 }
3440 return OK;
3441}
3442
Bram Moolenaar0917e862023-02-18 14:42:44 +00003443 funcerror_T
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003444call_internal_func(
3445 char_u *name,
3446 int argcount,
3447 typval_T *argvars,
3448 typval_T *rettv)
3449{
3450 int i;
3451
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003452 i = find_internal_func(name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003453 if (i < 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01003454 return FCERR_UNKNOWN;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003455 if (argcount < global_functions[i].f_min_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003456 return FCERR_TOOFEW;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003457 if (argcount > global_functions[i].f_max_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003458 return FCERR_TOOMANY;
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003459 if (check_args_for_type(i, argcount, argvars) == FAIL)
3460 return FCERR_OTHER;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003461 argvars[argcount].v_type = VAR_UNKNOWN;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003462 global_functions[i].f_func(argvars, rettv);
Bram Moolenaaref140542019-12-31 21:27:13 +01003463 return FCERR_NONE;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003464}
3465
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003466 void
3467call_internal_func_by_idx(
3468 int idx,
3469 typval_T *argvars,
3470 typval_T *rettv)
3471{
3472 global_functions[idx].f_func(argvars, rettv);
3473}
3474
Bram Moolenaarac92e252019-08-03 21:58:38 +02003475/*
3476 * Invoke a method for base->method().
3477 */
Bram Moolenaar0917e862023-02-18 14:42:44 +00003478 funcerror_T
Bram Moolenaarac92e252019-08-03 21:58:38 +02003479call_internal_method(
3480 char_u *name,
3481 int argcount,
3482 typval_T *argvars,
3483 typval_T *rettv,
3484 typval_T *basetv)
3485{
Bram Moolenaarac92e252019-08-03 21:58:38 +02003486 int fi;
3487 typval_T argv[MAX_FUNC_ARGS + 1];
3488
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003489 fi = find_internal_func(name);
Bram Moolenaar91746392019-08-16 22:22:31 +02003490 if (fi < 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01003491 return FCERR_UNKNOWN;
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003492 if ((global_functions[fi].f_argtype & FEARG_MASK) == 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01003493 return FCERR_NOTMETHOD;
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003494 if (argcount + 1 < global_functions[fi].f_min_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003495 return FCERR_TOOFEW;
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003496 if (argcount + 1 > global_functions[fi].f_max_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003497 return FCERR_TOOMANY;
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003498 if (check_args_for_type(fi, argcount, argvars) == FAIL)
3499 return FCERR_OTHER;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003500
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003501 if ((global_functions[fi].f_argtype & FEARG_MASK) == FEARG_2)
Bram Moolenaar25e42232019-08-04 15:04:10 +02003502 {
Bram Moolenaarb7f22702023-04-27 16:24:07 +01003503 if (argcount < 1)
3504 return FCERR_TOOFEW;
3505
Bram Moolenaar25e42232019-08-04 15:04:10 +02003506 // base value goes second
3507 argv[0] = argvars[0];
3508 argv[1] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003509 for (int i = 1; i < argcount; ++i)
Bram Moolenaar25e42232019-08-04 15:04:10 +02003510 argv[i + 1] = argvars[i];
3511 }
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003512 else if ((global_functions[fi].f_argtype & FEARG_MASK) == FEARG_3)
Bram Moolenaar24278d22019-08-16 21:49:22 +02003513 {
Bram Moolenaarb7f22702023-04-27 16:24:07 +01003514 if (argcount < 2)
3515 return FCERR_TOOFEW;
3516
Bram Moolenaar24278d22019-08-16 21:49:22 +02003517 // base value goes third
3518 argv[0] = argvars[0];
3519 argv[1] = argvars[1];
3520 argv[2] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003521 for (int i = 2; i < argcount; ++i)
Bram Moolenaar24278d22019-08-16 21:49:22 +02003522 argv[i + 1] = argvars[i];
3523 }
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003524 else if ((global_functions[fi].f_argtype & FEARG_MASK) == FEARG_4)
Bram Moolenaaraad222c2019-09-06 22:46:09 +02003525 {
Bram Moolenaarb7f22702023-04-27 16:24:07 +01003526 if (argcount < 3)
3527 return FCERR_TOOFEW;
3528
Bram Moolenaaraad222c2019-09-06 22:46:09 +02003529 // base value goes fourth
3530 argv[0] = argvars[0];
3531 argv[1] = argvars[1];
3532 argv[2] = argvars[2];
3533 argv[3] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003534 for (int i = 3; i < argcount; ++i)
Bram Moolenaaraad222c2019-09-06 22:46:09 +02003535 argv[i + 1] = argvars[i];
3536 }
Bram Moolenaar25e42232019-08-04 15:04:10 +02003537 else
3538 {
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003539 // FEARG_1: base value goes first
Bram Moolenaar25e42232019-08-04 15:04:10 +02003540 argv[0] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003541 for (int i = 0; i < argcount; ++i)
Bram Moolenaar25e42232019-08-04 15:04:10 +02003542 argv[i + 1] = argvars[i];
3543 }
Bram Moolenaarac92e252019-08-03 21:58:38 +02003544 argv[argcount + 1].v_type = VAR_UNKNOWN;
3545
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003546 if (check_args_for_type(fi, argcount + 1, argv) == FAIL)
3547 return FCERR_OTHER;
3548
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003549 global_functions[fi].f_func(argv, rettv);
Bram Moolenaaref140542019-12-31 21:27:13 +01003550 return FCERR_NONE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003551}
3552
3553/*
3554 * Return TRUE for a non-zero Number and a non-empty String.
3555 */
Bram Moolenaar0e57dd82019-09-16 22:56:03 +02003556 int
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003557non_zero_arg(typval_T *argvars)
3558{
3559 return ((argvars[0].v_type == VAR_NUMBER
3560 && argvars[0].vval.v_number != 0)
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01003561 || (argvars[0].v_type == VAR_BOOL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003562 && argvars[0].vval.v_number == VVAL_TRUE)
3563 || (argvars[0].v_type == VAR_STRING
3564 && argvars[0].vval.v_string != NULL
3565 && *argvars[0].vval.v_string != NUL));
3566}
3567
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003568/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003569 * "and(expr, expr)" function
3570 */
3571 static void
3572f_and(typval_T *argvars, typval_T *rettv)
3573{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003574 if (in_vim9script()
3575 && (check_for_number_arg(argvars, 0) == FAIL
3576 || check_for_number_arg(argvars, 1) == FAIL))
3577 return;
3578
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003579 rettv->vval.v_number = tv_get_number_chk(&argvars[0], NULL)
3580 & tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaarca851592018-06-06 21:04:07 +02003581}
3582
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003583/*
Bram Moolenaar59716a22017-03-01 20:32:44 +01003584 * "balloon_show()" function
3585 */
3586#ifdef FEAT_BEVAL
3587 static void
Bram Moolenaarbe0a2592019-05-09 13:50:16 +02003588f_balloon_gettext(typval_T *argvars UNUSED, typval_T *rettv)
3589{
3590 rettv->v_type = VAR_STRING;
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003591 if (balloonEval == NULL)
3592 return;
3593
3594 if (balloonEval->msg == NULL)
3595 rettv->vval.v_string = NULL;
3596 else
3597 rettv->vval.v_string = vim_strsave(balloonEval->msg);
Bram Moolenaarbe0a2592019-05-09 13:50:16 +02003598}
3599
3600 static void
Bram Moolenaar59716a22017-03-01 20:32:44 +01003601f_balloon_show(typval_T *argvars, typval_T *rettv UNUSED)
3602{
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003603 if (balloonEval == NULL)
3604 return;
3605
3606 if (in_vim9script()
3607 && check_for_string_or_list_arg(argvars, 0) == FAIL)
3608 return;
3609
3610 if (argvars[0].v_type == VAR_LIST
3611# ifdef FEAT_GUI
3612 && !gui.in_use
3613# endif
3614 )
Bram Moolenaar246fe032017-11-19 19:56:27 +01003615 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003616 list_T *l = argvars[0].vval.v_list;
3617
3618 // empty list removes the balloon
3619 post_balloon(balloonEval, NULL,
3620 l == NULL || l->lv_len == 0 ? NULL : l);
3621 }
3622 else
3623 {
3624 char_u *mesg;
3625
3626 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003627 return;
3628
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003629 mesg = tv_get_string_chk(&argvars[0]);
3630 if (mesg != NULL)
3631 // empty string removes the balloon
3632 post_balloon(balloonEval, *mesg == NUL ? NULL : mesg, NULL);
Bram Moolenaar246fe032017-11-19 19:56:27 +01003633 }
3634}
3635
Bram Moolenaar669a8282017-11-19 20:13:05 +01003636# if defined(FEAT_BEVAL_TERM)
Bram Moolenaar246fe032017-11-19 19:56:27 +01003637 static void
3638f_balloon_split(typval_T *argvars, typval_T *rettv UNUSED)
3639{
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003640 if (rettv_list_alloc(rettv) != OK)
3641 return;
3642
3643 char_u *msg;
3644
3645 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
3646 return;
3647 msg = tv_get_string_chk(&argvars[0]);
3648 if (msg != NULL)
Bram Moolenaar246fe032017-11-19 19:56:27 +01003649 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003650 pumitem_T *array;
3651 int size = split_message(msg, &array);
Bram Moolenaar246fe032017-11-19 19:56:27 +01003652
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003653 // Skip the first and last item, they are always empty.
3654 for (int i = 1; i < size - 1; ++i)
3655 list_append_string(rettv->vval.v_list, array[i].pum_text, -1);
3656 while (size > 0)
3657 vim_free(array[--size].pum_text);
3658 vim_free(array);
Bram Moolenaar246fe032017-11-19 19:56:27 +01003659 }
Bram Moolenaar59716a22017-03-01 20:32:44 +01003660}
Bram Moolenaar669a8282017-11-19 20:13:05 +01003661# endif
Bram Moolenaar59716a22017-03-01 20:32:44 +01003662#endif
3663
Yegappan Lakshmanan810785c2024-12-30 10:29:44 +01003664// Base64 character set
3665static const char_u base64_table[] = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
3666
3667// Base64 decoding table (initialized in init_base64_dec_table() below)
3668static char_u base64_dec_table[256];
3669
3670/*
3671 * Initialize the base64 decoding table
3672 */
3673 static void
3674init_base64_dec_table(void)
3675{
3676 static int base64_dec_tbl_initialized = FALSE;
3677
3678 if (base64_dec_tbl_initialized)
3679 return;
3680
3681 // Unsupported characters are set to 0xFF
3682 vim_memset(base64_dec_table, 0xFF, sizeof(base64_dec_table));
3683
3684 // Initialize the index for the base64 alphabets
3685 for (size_t i = 0; i < sizeof(base64_table) - 1; i++)
3686 base64_dec_table[(char_u)base64_table[i]] = (char_u)i;
3687
3688 // base64 padding character
3689 base64_dec_table['='] = 0;
3690
3691 base64_dec_tbl_initialized = TRUE;
3692}
3693
3694/*
3695 * Encode the bytes in "blob" using base-64 encoding.
3696 */
3697 static char_u *
3698base64_encode(blob_T *blob)
3699{
3700 size_t input_len = blob->bv_ga.ga_len;
3701 size_t encoded_len = ((input_len + 2) / 3) * 4;
3702 char_u *data = blob->bv_ga.ga_data;
3703
3704 char_u *encoded = alloc(encoded_len + 1);
3705 if (encoded == NULL)
3706 return NULL;
3707
3708 size_t i, j;
3709 for (i = 0, j = 0; i < input_len;)
3710 {
3711 int_u octet_a = i < input_len ? data[i++] : 0;
3712 int_u octet_b = i < input_len ? data[i++] : 0;
3713 int_u octet_c = i < input_len ? data[i++] : 0;
3714
3715 int_u triple = (octet_a << 16) | (octet_b << 8) | octet_c;
3716
3717 encoded[j++] = base64_table[(triple >> 18) & 0x3F];
3718 encoded[j++] = base64_table[(triple >> 12) & 0x3F];
3719 encoded[j++] = (!octet_b && i >= input_len) ? '='
3720 : base64_table[(triple >> 6) & 0x3F];
3721 encoded[j++] = (!octet_c && i >= input_len) ? '='
3722 : base64_table[triple & 0x3F];
3723 }
3724 encoded[j] = NUL;
3725
3726 return encoded;
3727}
3728
3729/*
3730 * Decode the string "data" using base-64 encoding.
3731 */
3732 static void
3733base64_decode(const char_u *data, blob_T *blob)
3734{
3735 size_t input_len = STRLEN(data);
3736
3737 if (input_len == 0)
3738 return;
3739
3740 if (input_len % 4 != 0)
3741 {
3742 // Invalid input length
3743 semsg(_(e_invalid_argument_str), data);
3744 return;
3745 }
3746
3747 init_base64_dec_table();
3748
3749 size_t decoded_len = (input_len / 4) * 3;
3750 if (data[input_len - 1] == '=')
3751 decoded_len--;
3752 if (data[input_len - 2] == '=')
3753 decoded_len--;
3754
3755 size_t i, j;
3756 for (i = 0, j = 0; i < input_len;)
3757 {
3758 int_u sextet_a = base64_dec_table[(char_u)data[i++]];
3759 int_u sextet_b = base64_dec_table[(char_u)data[i++]];
3760 int_u sextet_c = base64_dec_table[(char_u)data[i++]];
3761 int_u sextet_d = base64_dec_table[(char_u)data[i++]];
3762
3763 if (sextet_a == 0xFF || sextet_b == 0xFF || sextet_c == 0xFF
3764 || sextet_d == 0xFF)
3765 {
3766 // Invalid character
3767 semsg(_(e_invalid_argument_str), data);
3768 ga_clear(&blob->bv_ga);
3769 return;
3770 }
3771
3772 int_u triple = (sextet_a << 18) | (sextet_b << 12)
3773 | (sextet_c << 6) | sextet_d;
3774
3775 if (j < decoded_len)
3776 {
3777 ga_append(&blob->bv_ga, (triple >> 16) & 0xFF);
3778 j++;
3779 }
3780 if (j < decoded_len)
3781 {
3782 ga_append(&blob->bv_ga, (triple >> 8) & 0xFF);
3783 j++;
3784 }
3785 if (j < decoded_len)
3786 {
3787 ga_append(&blob->bv_ga, triple & 0xFF);
3788 j++;
3789 }
3790
3791 if (j == decoded_len)
3792 {
3793 // Check for invalid padding bytes (based on the
3794 // "Base64 Malleability in Practice" ACM paper).
3795 if ((data[input_len - 2] == '=' && ((sextet_b & 0xF) != 0))
3796 || ((data[input_len - 1] == '=') && ((sextet_c & 0x3) != 0)))
3797 {
3798 semsg(_(e_invalid_argument_str), data);
3799 ga_clear(&blob->bv_ga);
3800 return;
3801 }
3802 }
3803 }
3804}
3805
3806/*
3807 * "base64_decode(string)" function
3808 */
3809 static void
3810f_base64_decode(typval_T *argvars, typval_T *rettv)
3811{
3812 if (check_for_string_arg(argvars, 0) == FAIL)
3813 return;
3814
3815 if (rettv_blob_alloc(rettv) == FAIL)
3816 return;
3817
3818 char_u *str = tv_get_string_chk(&argvars[0]);
3819 if (str != NULL)
3820 base64_decode(str, rettv->vval.v_blob);
3821}
3822
3823/*
3824 * "base64_encode(blob)" function
3825 */
3826 static void
3827f_base64_encode(typval_T *argvars, typval_T *rettv)
3828{
3829 if (check_for_blob_arg(argvars, 0) == FAIL)
3830 return;
3831
3832 rettv->v_type = VAR_STRING;
3833 rettv->vval.v_string = NULL;
3834
3835 blob_T *blob = argvars->vval.v_blob;
3836 if (blob != NULL)
3837 rettv->vval.v_string = base64_encode(blob);
3838}
3839
Bram Moolenaar59716a22017-03-01 20:32:44 +01003840/*
Bram Moolenaar6b7b7192019-01-11 13:42:41 +01003841 * Get the buffer from "arg" and give an error and return NULL if it is not
3842 * valid.
3843 */
Bram Moolenaara3347722019-05-11 21:14:24 +02003844 buf_T *
Bram Moolenaar6b7b7192019-01-11 13:42:41 +01003845get_buf_arg(typval_T *arg)
3846{
3847 buf_T *buf;
3848
3849 ++emsg_off;
3850 buf = tv_get_buf(arg, FALSE);
3851 --emsg_off;
3852 if (buf == NULL)
Bram Moolenaard82a47d2022-01-05 20:24:39 +00003853 semsg(_(e_invalid_buffer_name_str), tv_get_string(arg));
Bram Moolenaar6b7b7192019-01-11 13:42:41 +01003854 return buf;
3855}
3856
3857/*
Christ van Willegence0ef912024-06-20 23:41:59 +02003858 * "bindtextdomain(package, path)" function
3859 */
3860 static void
Christ van Willegen8252ef12024-07-11 21:36:21 +02003861f_bindtextdomain(typval_T *argvars, typval_T *rettv)
Christ van Willegence0ef912024-06-20 23:41:59 +02003862{
Christ van Willegen8252ef12024-07-11 21:36:21 +02003863 rettv->v_type = VAR_BOOL;
3864 rettv->vval.v_number = VVAL_TRUE;
3865
Christ van Willegence0ef912024-06-20 23:41:59 +02003866 if (check_for_nonempty_string_arg(argvars, 0) == FAIL
3867 || check_for_nonempty_string_arg(argvars, 1) == FAIL)
3868 return;
3869
3870 if (strcmp((const char *)argvars[0].vval.v_string, VIMPACKAGE) == 0)
3871 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[0]));
3872 else
Christ van Willegen8252ef12024-07-11 21:36:21 +02003873 {
3874 if (bindtextdomain((const char *)argvars[0].vval.v_string, (const char *)argvars[1].vval.v_string) == NULL)
3875 {
3876 do_outofmem_msg((long)0);
3877 rettv->vval.v_number = VVAL_FALSE;
3878 }
3879 }
Christ van Willegence0ef912024-06-20 23:41:59 +02003880
3881 return;
3882}
3883
3884/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003885 * "byte2line(byte)" function
3886 */
3887 static void
3888f_byte2line(typval_T *argvars UNUSED, typval_T *rettv)
3889{
3890#ifndef FEAT_BYTEOFF
3891 rettv->vval.v_number = -1;
3892#else
3893 long boff = 0;
3894
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003895 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
3896 return;
3897
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01003898 boff = tv_get_number(&argvars[0]) - 1; // boff gets -1 on type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003899 if (boff < 0)
3900 rettv->vval.v_number = -1;
3901 else
3902 rettv->vval.v_number = ml_find_line_or_offset(curbuf,
3903 (linenr_T)0, &boff);
3904#endif
3905}
3906
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003907/*
3908 * "call(func, arglist [, dict])" function
3909 */
3910 static void
3911f_call(typval_T *argvars, typval_T *rettv)
3912{
3913 char_u *func;
3914 partial_T *partial = NULL;
3915 dict_T *selfdict = NULL;
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003916 char_u *tofree = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003917
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02003918 if (in_vim9script()
Bram Moolenaar223d0a62021-12-25 19:29:21 +00003919 && (check_for_string_or_func_arg(argvars, 0) == FAIL
3920 || check_for_list_arg(argvars, 1) == FAIL
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02003921 || check_for_opt_dict_arg(argvars, 2) == FAIL))
3922 return;
3923
Bram Moolenaard83392a2022-09-01 12:22:46 +01003924 if (check_for_list_arg(argvars, 1) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003925 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003926 if (argvars[1].vval.v_list == NULL)
3927 return;
3928
3929 if (argvars[0].v_type == VAR_FUNC)
3930 func = argvars[0].vval.v_string;
3931 else if (argvars[0].v_type == VAR_PARTIAL)
3932 {
3933 partial = argvars[0].vval.v_partial;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02003934 func = partial_name(partial);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003935 }
3936 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003937 func = tv_get_string(&argvars[0]);
Dominique Pellefe8ebdb2021-05-13 14:55:55 +02003938 if (func == NULL || *func == NUL)
3939 return; // type error, empty name or null function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003940
Yegappan Lakshmanan9904cbc2025-01-15 18:25:19 +01003941 if (argvars[0].v_type == VAR_STRING)
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003942 {
Yegappan Lakshmanan9904cbc2025-01-15 18:25:19 +01003943 char_u *p = func;
3944 tofree = trans_function_name(&p, NULL, FALSE, TFN_INT|TFN_QUIET);
3945 if (tofree == NULL)
3946 {
3947 emsg_funcname(e_unknown_function_str, func);
3948 return;
3949 }
3950 func = tofree;
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003951 }
3952
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003953 if (argvars[2].v_type != VAR_UNKNOWN)
3954 {
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +01003955 if (check_for_dict_arg(argvars, 2) == FAIL)
Yegappan Lakshmanan6289f912025-01-14 17:13:36 +01003956 goto done;
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +01003957
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003958 selfdict = argvars[2].vval.v_dict;
3959 }
3960
3961 (void)func_call(func, &argvars[1], partial, selfdict, rettv);
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003962
Yegappan Lakshmanan6289f912025-01-14 17:13:36 +01003963done:
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003964 vim_free(tofree);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003965}
3966
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003967/*
3968 * "changenr()" function
3969 */
3970 static void
3971f_changenr(typval_T *argvars UNUSED, typval_T *rettv)
3972{
3973 rettv->vval.v_number = curbuf->b_u_seq_cur;
3974}
3975
3976/*
3977 * "char2nr(string)" function
3978 */
3979 static void
3980f_char2nr(typval_T *argvars, typval_T *rettv)
3981{
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02003982 if (in_vim9script()
3983 && (check_for_string_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02003984 || check_for_opt_bool_arg(argvars, 1) == FAIL))
Bram Moolenaarc5809432021-03-27 21:23:30 +01003985 return;
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02003986
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003987 if (has_mbyte)
3988 {
3989 int utf8 = 0;
3990
3991 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaar24f77502020-09-04 19:50:57 +02003992 utf8 = (int)tv_get_bool_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003993
3994 if (utf8)
Bram Moolenaarbdace832019-03-02 10:13:42 +01003995 rettv->vval.v_number = utf_ptr2char(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003996 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003997 rettv->vval.v_number = (*mb_ptr2char)(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003998 }
3999 else
Bram Moolenaar13505972019-01-24 15:04:48 +01004000 rettv->vval.v_number = tv_get_string(&argvars[0])[0];
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004001}
4002
Bram Moolenaar17793ef2020-12-28 12:56:58 +01004003/*
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004004 * Get the current cursor column and store it in 'rettv'. If 'charcol' is TRUE,
4005 * returns the character index of the column. Otherwise, returns the byte index
4006 * of the column.
4007 */
4008 static void
4009get_col(typval_T *argvars, typval_T *rettv, int charcol)
4010{
4011 colnr_T col = 0;
4012 pos_T *fp;
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00004013 switchwin_T switchwin;
4014 int winchanged = FALSE;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004015
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00004016 if (check_for_string_or_list_arg(argvars, 0) == FAIL
4017 || check_for_opt_number_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004018 return;
4019
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00004020 if (argvars[1].v_type != VAR_UNKNOWN)
4021 {
4022 tabpage_T *tp;
4023 win_T *wp;
4024
4025 // use the window specified in the second argument
4026 wp = win_id2wp_tp((int)tv_get_number(&argvars[1]), &tp);
4027 if (wp == NULL || tp == NULL)
4028 return;
4029
4030 if (switch_win_noblock(&switchwin, wp, tp, TRUE) != OK)
4031 return;
4032
4033 check_cursor();
4034 winchanged = TRUE;
4035 }
4036
4037 int fnum = curbuf->b_fnum;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004038 fp = var2fpos(&argvars[0], FALSE, &fnum, charcol);
4039 if (fp != NULL && fnum == curbuf->b_fnum)
4040 {
4041 if (fp->col == MAXCOL)
4042 {
4043 // '> can be MAXCOL, get the length of the line then
4044 if (fp->lnum <= curbuf->b_ml.ml_line_count)
John Marriottbfcc8952024-03-11 22:04:45 +01004045 col = ml_get_len(fp->lnum) + 1;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004046 else
4047 col = MAXCOL;
4048 }
4049 else
4050 {
4051 col = fp->col + 1;
4052 // col(".") when the cursor is on the NUL at the end of the line
4053 // because of "coladd" can be seen as an extra column.
4054 if (virtual_active() && fp == &curwin->w_cursor)
4055 {
4056 char_u *p = ml_get_cursor();
4057
4058 if (curwin->w_cursor.coladd >= (colnr_T)chartabsize(p,
4059 curwin->w_virtcol - curwin->w_cursor.coladd))
4060 {
4061 int l;
4062
4063 if (*p != NUL && p[(l = (*mb_ptr2len)(p))] == NUL)
4064 col += l;
4065 }
4066 }
4067 }
4068 }
4069 rettv->vval.v_number = col;
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00004070
4071 if (winchanged)
4072 restore_win_noblock(&switchwin, TRUE);
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004073}
4074
4075/*
4076 * "charcol()" function
4077 */
4078 static void
4079f_charcol(typval_T *argvars, typval_T *rettv)
4080{
4081 get_col(argvars, rettv, TRUE);
4082}
4083
Bram Moolenaar29b7d7a2019-07-22 23:03:57 +02004084 win_T *
Bram Moolenaaraff74912019-03-30 18:11:49 +01004085get_optional_window(typval_T *argvars, int idx)
4086{
4087 win_T *win = curwin;
4088
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00004089 if (argvars[idx].v_type == VAR_UNKNOWN)
4090 return curwin;
4091
4092 win = find_win_by_nr_or_id(&argvars[idx]);
4093 if (win == NULL)
Bram Moolenaaraff74912019-03-30 18:11:49 +01004094 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00004095 emsg(_(e_invalid_window_number));
4096 return NULL;
Bram Moolenaaraff74912019-03-30 18:11:49 +01004097 }
4098 return win;
4099}
4100
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004101/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004102 * "col(string)" function
4103 */
4104 static void
4105f_col(typval_T *argvars, typval_T *rettv)
4106{
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004107 get_col(argvars, rettv, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004108}
4109
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004110/*
4111 * "confirm(message, buttons[, default [, type]])" function
4112 */
4113 static void
4114f_confirm(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
4115{
4116#if defined(FEAT_GUI_DIALOG) || defined(FEAT_CON_DIALOG)
4117 char_u *message;
4118 char_u *buttons = NULL;
4119 char_u buf[NUMBUFLEN];
4120 char_u buf2[NUMBUFLEN];
4121 int def = 1;
4122 int type = VIM_GENERIC;
4123 char_u *typestr;
4124 int error = FALSE;
4125
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02004126 if (in_vim9script()
4127 && (check_for_string_arg(argvars, 0) == FAIL
4128 || (check_for_opt_string_arg(argvars, 1) == FAIL
4129 || (argvars[1].v_type != VAR_UNKNOWN
4130 && (check_for_opt_number_arg(argvars, 2) == FAIL
4131 || (argvars[2].v_type != VAR_UNKNOWN
4132 && check_for_opt_string_arg(argvars, 3) == FAIL))))))
Bram Moolenaarc5809432021-03-27 21:23:30 +01004133 return;
4134
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004135 message = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004136 if (message == NULL)
4137 error = TRUE;
4138 if (argvars[1].v_type != VAR_UNKNOWN)
4139 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004140 buttons = tv_get_string_buf_chk(&argvars[1], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004141 if (buttons == NULL)
4142 error = TRUE;
4143 if (argvars[2].v_type != VAR_UNKNOWN)
4144 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004145 def = (int)tv_get_number_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004146 if (argvars[3].v_type != VAR_UNKNOWN)
4147 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004148 typestr = tv_get_string_buf_chk(&argvars[3], buf2);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004149 if (typestr == NULL)
4150 error = TRUE;
4151 else
4152 {
4153 switch (TOUPPER_ASC(*typestr))
4154 {
4155 case 'E': type = VIM_ERROR; break;
4156 case 'Q': type = VIM_QUESTION; break;
4157 case 'I': type = VIM_INFO; break;
4158 case 'W': type = VIM_WARNING; break;
4159 case 'G': type = VIM_GENERIC; break;
4160 }
4161 }
4162 }
4163 }
4164 }
4165
4166 if (buttons == NULL || *buttons == NUL)
4167 buttons = (char_u *)_("&Ok");
4168
4169 if (!error)
4170 rettv->vval.v_number = do_dialog(type, NULL, message, buttons,
4171 def, NULL, FALSE);
4172#endif
4173}
4174
4175/*
4176 * "copy()" function
4177 */
4178 static void
4179f_copy(typval_T *argvars, typval_T *rettv)
4180{
Bram Moolenaar381692b2022-02-02 20:01:27 +00004181 item_copy(&argvars[0], rettv, FALSE, TRUE, 0);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004182}
4183
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004184/*
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004185 * Set the cursor position.
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01004186 * If "charcol" is TRUE, then use the column number as a character offset.
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004187 * Otherwise use the column number as a byte offset.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004188 */
4189 static void
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004190set_cursorpos(typval_T *argvars, typval_T *rettv, int charcol)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004191{
Bram Moolenaar79f23442022-10-10 12:42:57 +01004192 long lnum, col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004193 long coladd = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004194 int set_curswant = TRUE;
4195
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004196 if (in_vim9script()
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004197 && (check_for_string_or_number_or_list_arg(argvars, 0) == FAIL
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02004198 || check_for_opt_number_arg(argvars, 1) == FAIL
4199 || (argvars[1].v_type != VAR_UNKNOWN
4200 && check_for_opt_number_arg(argvars, 2) == FAIL)))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004201 return;
4202
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004203 rettv->vval.v_number = -1;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004204 if (argvars[0].v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004205 {
4206 pos_T pos;
4207 colnr_T curswant = -1;
4208
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004209 if (list2fpos(argvars, &pos, NULL, &curswant, charcol) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004210 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00004211 emsg(_(e_invalid_argument));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004212 return;
4213 }
Bram Moolenaar79f23442022-10-10 12:42:57 +01004214 lnum = pos.lnum;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004215 col = pos.col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004216 coladd = pos.coladd;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004217 if (curswant >= 0)
4218 {
4219 curwin->w_curswant = curswant - 1;
4220 set_curswant = FALSE;
4221 }
4222 }
Bram Moolenaar79f23442022-10-10 12:42:57 +01004223 else if ((argvars[0].v_type == VAR_NUMBER
4224 || argvars[0].v_type == VAR_STRING)
4225 && (argvars[1].v_type == VAR_NUMBER
4226 || argvars[1].v_type == VAR_STRING))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004227 {
Bram Moolenaar79f23442022-10-10 12:42:57 +01004228 lnum = tv_get_lnum(argvars);
4229 if (lnum < 0)
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00004230 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[0]));
Bram Moolenaar79f23442022-10-10 12:42:57 +01004231 else if (lnum == 0)
4232 lnum = curwin->w_cursor.lnum;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004233 col = (long)tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004234 if (charcol)
Bram Moolenaar79f23442022-10-10 12:42:57 +01004235 col = buf_charidx_to_byteidx(curbuf, lnum, col) + 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004236 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004237 coladd = (long)tv_get_number_chk(&argvars[2], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004238 }
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004239 else
4240 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00004241 emsg(_(e_invalid_argument));
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004242 return;
4243 }
Bram Moolenaar79f23442022-10-10 12:42:57 +01004244 if (lnum < 0 || col < 0 || coladd < 0)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004245 return; // type error; errmsg already given
Bram Moolenaar79f23442022-10-10 12:42:57 +01004246 if (lnum > 0)
4247 curwin->w_cursor.lnum = lnum;
zeertzjq2ffdae72024-05-02 13:06:24 +02004248 if (col != MAXCOL && --col < 0)
4249 col = 0;
4250 curwin->w_cursor.col = col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004251 curwin->w_cursor.coladd = coladd;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004252
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004253 // Make sure the cursor is in a valid position.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004254 check_cursor();
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004255 // Correct cursor for multi-byte character.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004256 if (has_mbyte)
4257 mb_adjust_cursor();
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004258
4259 curwin->w_set_curswant = set_curswant;
4260 rettv->vval.v_number = 0;
4261}
4262
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004263/*
4264 * "cursor(lnum, col)" function, or
4265 * "cursor(list)"
4266 *
4267 * Moves the cursor to the specified line and column.
4268 * Returns 0 when the position could be set, -1 otherwise.
4269 */
4270 static void
4271f_cursor(typval_T *argvars, typval_T *rettv)
4272{
4273 set_cursorpos(argvars, rettv, FALSE);
4274}
4275
Bram Moolenaar4f974752019-02-17 17:44:42 +01004276#ifdef MSWIN
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004277/*
4278 * "debugbreak()" function
4279 */
4280 static void
4281f_debugbreak(typval_T *argvars, typval_T *rettv)
4282{
4283 int pid;
4284
4285 rettv->vval.v_number = FAIL;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004286 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
4287 return;
4288
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004289 pid = (int)tv_get_number(&argvars[0]);
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004290 if (pid == 0)
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004291 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00004292 emsg(_(e_invalid_argument));
4293 return;
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004294 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00004295
4296 HANDLE hProcess = OpenProcess(PROCESS_ALL_ACCESS, 0, pid);
4297 if (hProcess == NULL)
4298 return;
4299
4300 DebugBreakProcess(hProcess);
4301 CloseHandle(hProcess);
4302 rettv->vval.v_number = OK;
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004303}
4304#endif
4305
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004306/*
4307 * "deepcopy()" function
4308 */
4309 static void
4310f_deepcopy(typval_T *argvars, typval_T *rettv)
4311{
Bram Moolenaar239f8d92021-01-17 13:21:20 +01004312 varnumber_T noref = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004313
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +01004314 if (check_for_opt_bool_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004315 return;
4316
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004317 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaar239f8d92021-01-17 13:21:20 +01004318 noref = tv_get_bool_chk(&argvars[1], NULL);
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +01004319
4320 item_copy(&argvars[0], rettv, TRUE, TRUE, noref == 0 ? get_copyID() : 0);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004321}
4322
4323/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004324 * "did_filetype()" function
4325 */
4326 static void
4327f_did_filetype(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
4328{
zeertzjq5bf6c212024-03-31 18:41:27 +02004329 rettv->vval.v_number = curbuf->b_did_filetype;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004330}
4331
4332/*
Bram Moolenaar4132eb52020-02-14 16:53:00 +01004333 * "echoraw({expr})" function
4334 */
4335 static void
4336f_echoraw(typval_T *argvars, typval_T *rettv UNUSED)
4337{
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02004338 char_u *str;
Bram Moolenaar4132eb52020-02-14 16:53:00 +01004339
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02004340 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
4341 return;
4342
4343 str = tv_get_string_chk(&argvars[0]);
Bram Moolenaar4132eb52020-02-14 16:53:00 +01004344 if (str != NULL && *str != NUL)
4345 {
4346 out_str(str);
4347 out_flush();
4348 }
4349}
4350
4351/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004352 * "empty({expr})" function
4353 */
4354 static void
4355f_empty(typval_T *argvars, typval_T *rettv)
4356{
4357 int n = FALSE;
4358
4359 switch (argvars[0].v_type)
4360 {
4361 case VAR_STRING:
4362 case VAR_FUNC:
4363 n = argvars[0].vval.v_string == NULL
4364 || *argvars[0].vval.v_string == NUL;
4365 break;
4366 case VAR_PARTIAL:
Yegappan Lakshmananda9d3452024-05-02 13:02:36 +02004367 n = argvars[0].vval.v_partial == NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004368 break;
4369 case VAR_NUMBER:
4370 n = argvars[0].vval.v_number == 0;
4371 break;
4372 case VAR_FLOAT:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004373 n = argvars[0].vval.v_float == 0.0;
4374 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004375 case VAR_LIST:
4376 n = argvars[0].vval.v_list == NULL
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004377 || argvars[0].vval.v_list->lv_len == 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004378 break;
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01004379 case VAR_TUPLE:
4380 n = tuple_len(argvars[0].vval.v_tuple) == 0;
4381 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004382 case VAR_DICT:
4383 n = argvars[0].vval.v_dict == NULL
4384 || argvars[0].vval.v_dict->dv_hashtab.ht_used == 0;
4385 break;
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01004386 case VAR_BOOL:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004387 case VAR_SPECIAL:
4388 n = argvars[0].vval.v_number != VVAL_TRUE;
4389 break;
Bram Moolenaar00b28d62022-12-08 15:32:33 +00004390 case VAR_CLASS:
4391 n = argvars[0].vval.v_class != NULL;
4392 break;
4393 case VAR_OBJECT:
Yegappan Lakshmanand3eae7b2024-03-03 16:26:58 +01004394 n = object_empty(argvars[0].vval.v_object);
Bram Moolenaar00b28d62022-12-08 15:32:33 +00004395 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004396
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01004397 case VAR_BLOB:
4398 n = argvars[0].vval.v_blob == NULL
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01004399 || argvars[0].vval.v_blob->bv_ga.ga_len == 0;
4400 break;
4401
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004402 case VAR_JOB:
4403#ifdef FEAT_JOB_CHANNEL
4404 n = argvars[0].vval.v_job == NULL
4405 || argvars[0].vval.v_job->jv_status != JOB_STARTED;
4406 break;
4407#endif
4408 case VAR_CHANNEL:
4409#ifdef FEAT_JOB_CHANNEL
4410 n = argvars[0].vval.v_channel == NULL
4411 || !channel_is_open(argvars[0].vval.v_channel);
4412 break;
4413#endif
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +02004414 case VAR_TYPEALIAS:
4415 n = argvars[0].vval.v_typealias == NULL
4416 || argvars[0].vval.v_typealias->ta_name == NULL
4417 || *argvars[0].vval.v_typealias->ta_name == NUL;
4418 break;
4419
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004420 case VAR_UNKNOWN:
Bram Moolenaar4c683752020-04-05 21:38:23 +02004421 case VAR_ANY:
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004422 case VAR_VOID:
Bram Moolenaarf18332f2021-05-07 17:55:55 +02004423 case VAR_INSTR:
Bram Moolenaardd589232020-02-29 17:38:12 +01004424 internal_error_no_abort("f_empty(UNKNOWN)");
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004425 n = TRUE;
4426 break;
4427 }
4428
4429 rettv->vval.v_number = n;
4430}
4431
4432/*
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004433 * "environ()" function
4434 */
4435 static void
4436f_environ(typval_T *argvars UNUSED, typval_T *rettv)
4437{
4438#if !defined(AMIGA)
4439 int i = 0;
4440 char_u *entry, *value;
Bram Moolenaar68aaff42022-04-17 10:57:44 +01004441# if defined (MSWIN)
4442# if !defined(_UCRT)
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004443 extern wchar_t **_wenviron;
Bram Moolenaar68aaff42022-04-17 10:57:44 +01004444# endif
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004445# else
4446 extern char **environ;
4447# endif
4448
Bram Moolenaar93a10962022-06-16 11:42:09 +01004449 if (rettv_dict_alloc(rettv) == FAIL)
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004450 return;
4451
4452# ifdef MSWIN
4453 if (*_wenviron == NULL)
4454 return;
4455# else
4456 if (*environ == NULL)
4457 return;
4458# endif
4459
4460 for (i = 0; ; ++i)
4461 {
4462# ifdef MSWIN
4463 short_u *p;
4464
4465 if ((p = (short_u *)_wenviron[i]) == NULL)
4466 return;
4467 entry = utf16_to_enc(p, NULL);
4468# else
4469 if ((entry = (char_u *)environ[i]) == NULL)
4470 return;
4471 entry = vim_strsave(entry);
4472# endif
4473 if (entry == NULL) // out of memory
4474 return;
4475 if ((value = vim_strchr(entry, '=')) == NULL)
4476 {
4477 vim_free(entry);
4478 continue;
4479 }
4480 *value++ = NUL;
4481 dict_add_string(rettv->vval.v_dict, (char *)entry, value);
4482 vim_free(entry);
4483 }
4484#endif
4485}
4486
4487/*
Bram Moolenaar80adaa82023-07-07 18:57:40 +01004488 * "err_teapot()" function
4489 */
4490 static void
4491f_err_teapot(typval_T *argvars, typval_T *rettv UNUSED)
4492{
4493 if (argvars[0].v_type != VAR_UNKNOWN)
4494 {
4495 if (argvars[0].v_type == VAR_STRING)
4496 {
4497 char_u *s = tv_get_string_strict(&argvars[0]);
Sean Dewarb0efa492023-07-08 10:35:19 +01004498 if (*skipwhite(s) == NUL)
Bram Moolenaar80adaa82023-07-07 18:57:40 +01004499 return;
4500 }
4501
4502 int err = FALSE;
4503 int do_503 = eval_expr_to_bool(&argvars[0], &err);
4504 if (!err && do_503)
4505 {
4506 emsg(_(e_coffee_currently_not_available));
4507 return;
4508 }
4509 }
4510
4511 emsg(_(e_im_a_teapot));
4512}
4513
4514/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004515 * "escape({string}, {chars})" function
4516 */
4517 static void
4518f_escape(typval_T *argvars, typval_T *rettv)
4519{
4520 char_u buf[NUMBUFLEN];
4521
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004522 if (in_vim9script()
4523 && (check_for_string_arg(argvars, 0) == FAIL
4524 || check_for_string_arg(argvars, 1) == FAIL))
4525 return;
4526
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004527 rettv->vval.v_string = vim_strsave_escaped(tv_get_string(&argvars[0]),
4528 tv_get_string_buf(&argvars[1], buf));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004529 rettv->v_type = VAR_STRING;
4530}
4531
4532/*
4533 * "eval()" function
4534 */
4535 static void
4536f_eval(typval_T *argvars, typval_T *rettv)
4537{
4538 char_u *s, *p;
4539
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004540 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
4541 return;
4542
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004543 s = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004544 if (s != NULL)
4545 s = skipwhite(s);
4546
4547 p = s;
Bram Moolenaar5409f5d2020-06-24 18:37:35 +02004548 if (s == NULL || eval1(&s, rettv, &EVALARG_EVALUATE) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004549 {
4550 if (p != NULL && !aborting())
Bram Moolenaar108010a2021-06-27 22:03:33 +02004551 semsg(_(e_invalid_expression_str), p);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004552 need_clr_eos = FALSE;
4553 rettv->v_type = VAR_NUMBER;
4554 rettv->vval.v_number = 0;
4555 }
4556 else if (*s != NUL)
Bram Moolenaar74409f62022-01-01 15:58:22 +00004557 semsg(_(e_trailing_characters_str), s);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004558}
4559
4560/*
4561 * "eventhandler()" function
4562 */
4563 static void
4564f_eventhandler(typval_T *argvars UNUSED, typval_T *rettv)
4565{
Bram Moolenaardfc33a62020-04-29 22:30:13 +02004566 rettv->vval.v_number = vgetc_busy || input_busy;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004567}
4568
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004569static garray_T redir_execute_ga;
4570
4571/*
4572 * Append "value[value_len]" to the execute() output.
4573 */
4574 void
4575execute_redir_str(char_u *value, int value_len)
4576{
4577 int len;
4578
4579 if (value_len == -1)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004580 len = (int)STRLEN(value); // Append the entire string
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004581 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004582 len = value_len; // Append only "value_len" characters
Yegappan Lakshmananfadc02a2023-01-27 21:03:12 +00004583 if (ga_grow(&redir_execute_ga, len) == FAIL)
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00004584 return;
4585
4586 mch_memmove((char *)redir_execute_ga.ga_data
4587 + redir_execute_ga.ga_len, value, len);
4588 redir_execute_ga.ga_len += len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004589}
4590
Dominique Pelle748b3082022-01-08 12:41:16 +00004591#if defined(FEAT_LUA) || defined(PROTO)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004592/*
Yegappan Lakshmanan11328bc2021-08-06 21:34:38 +02004593 * Get next line from a string containing NL separated lines.
4594 * Called by do_cmdline() to get the next line.
4595 * Returns an allocated string, or NULL when at the end of the string.
4596 */
4597 static char_u *
4598get_str_line(
4599 int c UNUSED,
4600 void *cookie,
4601 int indent UNUSED,
4602 getline_opt_T options UNUSED)
4603{
4604 char_u *start = *(char_u **)cookie;
4605 char_u *line;
4606 char_u *p;
4607
4608 p = start;
4609 if (p == NULL || *p == NUL)
4610 return NULL;
4611 p = vim_strchr(p, '\n');
4612 if (p == NULL)
4613 line = vim_strsave(start);
4614 else
4615 {
4616 line = vim_strnsave(start, p - start);
4617 p++;
4618 }
4619
4620 *(char_u **)cookie = p;
4621 return line;
4622}
4623
4624/*
4625 * Execute a series of Ex commands in 'str'
4626 */
4627 void
4628execute_cmds_from_string(char_u *str)
4629{
4630 do_cmdline(NULL, get_str_line, (void *)&str,
4631 DOCMD_NOWAIT|DOCMD_VERBOSE|DOCMD_REPEAT|DOCMD_KEYTYPED);
4632}
Dominique Pelle748b3082022-01-08 12:41:16 +00004633#endif
Yegappan Lakshmanan11328bc2021-08-06 21:34:38 +02004634
4635/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004636 * Get next line from a list.
4637 * Called by do_cmdline() to get the next line.
4638 * Returns allocated string, or NULL for end of function.
4639 */
Bram Moolenaara7583c42022-05-07 21:14:05 +01004640 char_u *
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004641get_list_line(
4642 int c UNUSED,
4643 void *cookie,
Bram Moolenaare96a2492019-06-25 04:12:16 +02004644 int indent UNUSED,
Bram Moolenaar66250c92020-08-20 15:02:42 +02004645 getline_opt_T options UNUSED)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004646{
4647 listitem_T **p = (listitem_T **)cookie;
4648 listitem_T *item = *p;
4649 char_u buf[NUMBUFLEN];
4650 char_u *s;
4651
4652 if (item == NULL)
4653 return NULL;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004654 s = tv_get_string_buf_chk(&item->li_tv, buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004655 *p = item->li_next;
4656 return s == NULL ? NULL : vim_strsave(s);
4657}
4658
4659/*
4660 * "execute()" function
4661 */
Bram Moolenaar261f3462019-09-07 15:45:32 +02004662 void
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004663execute_common(typval_T *argvars, typval_T *rettv, int arg_off)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004664{
4665 char_u *cmd = NULL;
4666 list_T *list = NULL;
4667 int save_msg_silent = msg_silent;
4668 int save_emsg_silent = emsg_silent;
4669 int save_emsg_noredir = emsg_noredir;
4670 int save_redir_execute = redir_execute;
Bram Moolenaar20951482017-12-25 13:44:43 +01004671 int save_redir_off = redir_off;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004672 garray_T save_ga;
Bram Moolenaar10ccaa12018-12-07 16:38:23 +01004673 int save_msg_col = msg_col;
Kota Kato3d3f6ac2022-08-04 18:50:14 +01004674 int save_sticky_cmdmod_flags = sticky_cmdmod_flags;
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004675 int echo_output = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004676
4677 rettv->vval.v_string = NULL;
4678 rettv->v_type = VAR_STRING;
4679
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004680 if (argvars[arg_off].v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004681 {
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004682 list = argvars[arg_off].vval.v_list;
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004683 if (list == NULL || list->lv_len == 0)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004684 // empty list, no commands, empty output
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004685 return;
4686 ++list->lv_refcount;
4687 }
Bram Moolenaare2a8f072020-01-08 19:32:18 +01004688 else if (argvars[arg_off].v_type == VAR_JOB
4689 || argvars[arg_off].v_type == VAR_CHANNEL)
4690 {
Bram Moolenaar68db9962021-05-09 23:19:22 +02004691 semsg(_(e_using_invalid_value_as_string_str),
4692 vartype_name(argvars[arg_off].v_type));
Bram Moolenaare2a8f072020-01-08 19:32:18 +01004693 return;
4694 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004695 else
4696 {
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004697 cmd = tv_get_string_chk(&argvars[arg_off]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004698 if (cmd == NULL)
4699 return;
4700 }
4701
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004702 if (argvars[arg_off + 1].v_type != VAR_UNKNOWN)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004703 {
4704 char_u buf[NUMBUFLEN];
Bram Moolenaar3cfa5b12021-06-06 14:14:39 +02004705 char_u *s = tv_get_string_buf_chk_strict(&argvars[arg_off + 1], buf,
4706 in_vim9script());
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004707
4708 if (s == NULL)
4709 return;
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004710 if (*s == NUL)
4711 echo_output = TRUE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004712 if (STRNCMP(s, "silent", 6) == 0)
4713 ++msg_silent;
4714 if (STRCMP(s, "silent!") == 0)
4715 {
4716 emsg_silent = TRUE;
4717 emsg_noredir = TRUE;
4718 }
4719 }
4720 else
4721 ++msg_silent;
4722
4723 if (redir_execute)
4724 save_ga = redir_execute_ga;
Bram Moolenaar04935fb2022-01-08 16:19:22 +00004725 ga_init2(&redir_execute_ga, sizeof(char), 500);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004726 redir_execute = TRUE;
Bram Moolenaar20951482017-12-25 13:44:43 +01004727 redir_off = FALSE;
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004728 if (!echo_output)
4729 msg_col = 0; // prevent leading spaces
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004730
Kota Kato3d3f6ac2022-08-04 18:50:14 +01004731 // For "legacy call execute('cmd')" and "vim9cmd execute('cmd')" apply the
4732 // command modifiers to "cmd".
4733 sticky_cmdmod_flags = cmdmod.cmod_flags & (CMOD_LEGACY | CMOD_VIM9CMD);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004734 if (cmd != NULL)
4735 do_cmdline_cmd(cmd);
4736 else
4737 {
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004738 listitem_T *item;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004739
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02004740 CHECK_LIST_MATERIALIZE(list);
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004741 item = list->lv_first;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004742 do_cmdline(NULL, get_list_line, (void *)&item,
4743 DOCMD_NOWAIT|DOCMD_VERBOSE|DOCMD_REPEAT|DOCMD_KEYTYPED);
4744 --list->lv_refcount;
4745 }
Kota Kato3d3f6ac2022-08-04 18:50:14 +01004746 sticky_cmdmod_flags = save_sticky_cmdmod_flags;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004747
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004748 // Need to append a NUL to the result.
Bram Moolenaard297f352017-01-29 20:31:21 +01004749 if (ga_grow(&redir_execute_ga, 1) == OK)
4750 {
4751 ((char *)redir_execute_ga.ga_data)[redir_execute_ga.ga_len] = NUL;
4752 rettv->vval.v_string = redir_execute_ga.ga_data;
4753 }
4754 else
4755 {
4756 ga_clear(&redir_execute_ga);
4757 rettv->vval.v_string = NULL;
4758 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004759 msg_silent = save_msg_silent;
4760 emsg_silent = save_emsg_silent;
4761 emsg_noredir = save_emsg_noredir;
4762
4763 redir_execute = save_redir_execute;
4764 if (redir_execute)
4765 redir_execute_ga = save_ga;
Bram Moolenaar20951482017-12-25 13:44:43 +01004766 redir_off = save_redir_off;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004767
Bram Moolenaar10ccaa12018-12-07 16:38:23 +01004768 // "silent reg" or "silent echo x" leaves msg_col somewhere in the line.
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004769 if (echo_output)
4770 // When not working silently: put it in column zero. A following
4771 // "echon" will overwrite the message, unavoidably.
4772 msg_col = 0;
4773 else
4774 // When working silently: Put it back where it was, since nothing
4775 // should have been written.
4776 msg_col = save_msg_col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004777}
4778
4779/*
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004780 * "execute()" function
4781 */
4782 static void
4783f_execute(typval_T *argvars, typval_T *rettv)
4784{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004785 if (in_vim9script()
4786 && (check_for_string_or_list_arg(argvars, 0) == FAIL
4787 || check_for_opt_string_arg(argvars, 1) == FAIL))
4788 return;
4789
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004790 execute_common(argvars, rettv, 0);
4791}
4792
4793/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004794 * "exists()" function
4795 */
Bram Moolenaarbb7ee7a2021-08-02 20:06:50 +02004796 void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004797f_exists(typval_T *argvars, typval_T *rettv)
4798{
4799 char_u *p;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004800 int n = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004801
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004802 if (in_vim9script() && check_for_nonempty_string_arg(argvars, 0) == FAIL)
4803 return;
4804
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004805 p = tv_get_string(&argvars[0]);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004806 if (*p == '$') // environment variable
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004807 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004808 // first try "normal" environment variables (fast)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004809 if (mch_getenv(p + 1) != NULL)
4810 n = TRUE;
4811 else
4812 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004813 // try expanding things like $VIM and ${HOME}
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004814 p = expand_env_save(p);
4815 if (p != NULL && *p != '$')
4816 n = TRUE;
4817 vim_free(p);
4818 }
4819 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004820 else if (*p == '&' || *p == '+') // option
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004821 {
Bram Moolenaar9a78e6d2020-07-01 18:29:55 +02004822 n = (eval_option(&p, NULL, TRUE) == OK);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004823 if (*skipwhite(p) != NUL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004824 n = FALSE; // trailing garbage
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004825 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004826 else if (*p == '*') // internal or user defined function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004827 {
Bram Moolenaarb54c3ff2016-07-31 14:11:58 +02004828 n = function_exists(p + 1, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004829 }
Bram Moolenaar15c47602020-03-26 22:16:48 +01004830 else if (*p == '?') // internal function only
4831 {
4832 n = has_internal_func_name(p + 1);
4833 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004834 else if (*p == ':')
4835 {
4836 n = cmd_exists(p + 1);
4837 }
4838 else if (*p == '#')
4839 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004840 if (p[1] == '#')
4841 n = autocmd_supported(p + 2);
4842 else
4843 n = au_exists(p + 1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004844 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004845 else // internal variable
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004846 {
Bram Moolenaarc6f9f732018-02-11 19:06:26 +01004847 n = var_exists(p);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004848 }
4849
4850 rettv->vval.v_number = n;
4851}
4852
Bram Moolenaar26735992021-08-08 14:43:22 +02004853 static void
4854f_exists_compiled(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
4855{
4856 emsg(_(e_exists_compiled_can_only_be_used_in_def_function));
4857}
4858
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004859/*
4860 * "expand()" function
4861 */
4862 static void
4863f_expand(typval_T *argvars, typval_T *rettv)
4864{
4865 char_u *s;
Mike Williams51024bb2024-05-30 07:46:30 +02004866 size_t len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004867 int options = WILD_SILENT|WILD_USE_NL|WILD_LIST_NOTFOUND;
4868 expand_T xpc;
4869 int error = FALSE;
4870 char_u *result;
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004871#ifdef BACKSLASH_IN_FILENAME
4872 char_u *p_csl_save = p_csl;
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004873#endif
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004874
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004875 if (in_vim9script()
4876 && (check_for_string_arg(argvars, 0) == FAIL
4877 || check_for_opt_bool_arg(argvars, 1) == FAIL
4878 || (argvars[1].v_type != VAR_UNKNOWN
4879 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
4880 return;
4881
4882#ifdef BACKSLASH_IN_FILENAME
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004883 // avoid using 'completeslash' here
4884 p_csl = empty_option;
4885#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004886
4887 rettv->v_type = VAR_STRING;
4888 if (argvars[1].v_type != VAR_UNKNOWN
4889 && argvars[2].v_type != VAR_UNKNOWN
Bram Moolenaar551d25e2020-09-02 21:37:56 +02004890 && tv_get_bool_chk(&argvars[2], &error)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004891 && !error)
Bram Moolenaar45cf6e92017-04-30 20:25:19 +02004892 rettv_list_set(rettv, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004893
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004894 s = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004895 if (*s == '%' || *s == '#' || *s == '<')
4896 {
Bram Moolenaar57544522022-04-12 12:54:11 +01004897 char *errormsg = NULL;
4898
4899 if (p_verbose == 0)
4900 ++emsg_off;
Bram Moolenaara96edb72022-04-28 17:52:24 +01004901 result = eval_vars(s, s, &len, NULL, &errormsg, NULL, FALSE);
Bram Moolenaar57544522022-04-12 12:54:11 +01004902 if (p_verbose == 0)
4903 --emsg_off;
4904 else if (errormsg != NULL)
4905 emsg(errormsg);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004906 if (rettv->v_type == VAR_LIST)
4907 {
Bram Moolenaar93a10962022-06-16 11:42:09 +01004908 if (rettv_list_alloc(rettv) == OK && result != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004909 list_append_string(rettv->vval.v_list, result, -1);
Bram Moolenaar86173482019-10-01 17:02:16 +02004910 vim_free(result);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004911 }
4912 else
4913 rettv->vval.v_string = result;
4914 }
4915 else
4916 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004917 // When the optional second argument is non-zero, don't remove matches
4918 // for 'wildignore' and don't put matches for 'suffixes' at the end.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004919 if (argvars[1].v_type != VAR_UNKNOWN
Bram Moolenaar551d25e2020-09-02 21:37:56 +02004920 && tv_get_bool_chk(&argvars[1], &error))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004921 options |= WILD_KEEP_ALL;
4922 if (!error)
4923 {
4924 ExpandInit(&xpc);
4925 xpc.xp_context = EXPAND_FILES;
4926 if (p_wic)
4927 options += WILD_ICASE;
4928 if (rettv->v_type == VAR_STRING)
4929 rettv->vval.v_string = ExpandOne(&xpc, s, NULL,
4930 options, WILD_ALL);
Bram Moolenaar93a10962022-06-16 11:42:09 +01004931 else if (rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004932 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004933 ExpandOne(&xpc, s, NULL, options, WILD_ALL_KEEP);
Bram Moolenaar848db572022-09-20 19:04:32 +01004934 for (int i = 0; i < xpc.xp_numfiles; i++)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004935 list_append_string(rettv->vval.v_list, xpc.xp_files[i], -1);
4936 ExpandCleanup(&xpc);
4937 }
4938 }
4939 else
4940 rettv->vval.v_string = NULL;
4941 }
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004942#ifdef BACKSLASH_IN_FILENAME
4943 p_csl = p_csl_save;
4944#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004945}
4946
4947/*
Bram Moolenaar80dad482019-06-09 17:22:31 +02004948 * "expandcmd()" function
4949 * Expand all the special characters in a command string.
4950 */
4951 static void
4952f_expandcmd(typval_T *argvars, typval_T *rettv)
4953{
4954 exarg_T eap;
4955 char_u *cmdstr;
4956 char *errormsg = NULL;
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004957 int emsgoff = TRUE;
Bram Moolenaar80dad482019-06-09 17:22:31 +02004958
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004959 if (in_vim9script()
4960 && (check_for_string_arg(argvars, 0) == FAIL
4961 || check_for_opt_dict_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004962 return;
4963
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004964 if (argvars[1].v_type == VAR_DICT
Bram Moolenaard61efa52022-07-23 09:52:04 +01004965 && dict_get_bool(argvars[1].vval.v_dict, "errmsg", VVAL_FALSE))
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004966 emsgoff = FALSE;
4967
Bram Moolenaar80dad482019-06-09 17:22:31 +02004968 rettv->v_type = VAR_STRING;
4969 cmdstr = vim_strsave(tv_get_string(&argvars[0]));
4970
Yegappan Lakshmanan960dcbd2023-03-07 17:45:11 +00004971 CLEAR_FIELD(eap);
Bram Moolenaar80dad482019-06-09 17:22:31 +02004972 eap.cmd = cmdstr;
4973 eap.arg = cmdstr;
Bram Moolenaar8071cb22019-07-12 17:58:01 +02004974 eap.argt |= EX_NOSPC;
Bram Moolenaar80dad482019-06-09 17:22:31 +02004975 eap.usefilter = FALSE;
4976 eap.nextcmd = NULL;
4977 eap.cmdidx = CMD_USER;
4978
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004979 if (emsgoff)
4980 ++emsg_off;
4981 if (expand_filename(&eap, &cmdstr, &errormsg) == FAIL)
4982 if (!emsgoff && errormsg != NULL && *errormsg != NUL)
4983 emsg(errormsg);
4984 if (emsgoff)
4985 --emsg_off;
Bram Moolenaar80dad482019-06-09 17:22:31 +02004986
4987 rettv->vval.v_string = cmdstr;
4988}
4989
4990/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004991 * "feedkeys()" function
4992 */
4993 static void
4994f_feedkeys(typval_T *argvars, typval_T *rettv UNUSED)
4995{
4996 int remap = TRUE;
4997 int insert = FALSE;
4998 char_u *keys, *flags;
4999 char_u nbuf[NUMBUFLEN];
5000 int typed = FALSE;
5001 int execute = FALSE;
Bram Moolenaara9725222022-01-16 13:30:33 +00005002 int context = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005003 int dangerous = FALSE;
Bram Moolenaar5e66b422019-01-24 21:58:10 +01005004 int lowlevel = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005005
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005006 // This is not allowed in the sandbox. If the commands would still be
5007 // executed in the sandbox it would be OK, but it probably happens later,
5008 // when "sandbox" is no longer set.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005009 if (check_secure())
5010 return;
5011
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005012 if (in_vim9script()
5013 && (check_for_string_arg(argvars, 0) == FAIL
5014 || check_for_opt_string_arg(argvars, 1) == FAIL))
5015 return;
5016
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005017 keys = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005018
5019 if (argvars[1].v_type != VAR_UNKNOWN)
5020 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005021 flags = tv_get_string_buf(&argvars[1], nbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005022 for ( ; *flags != NUL; ++flags)
5023 {
5024 switch (*flags)
5025 {
5026 case 'n': remap = FALSE; break;
5027 case 'm': remap = TRUE; break;
5028 case 't': typed = TRUE; break;
5029 case 'i': insert = TRUE; break;
5030 case 'x': execute = TRUE; break;
Bram Moolenaara9725222022-01-16 13:30:33 +00005031 case 'c': context = TRUE; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005032 case '!': dangerous = TRUE; break;
Bram Moolenaar5e66b422019-01-24 21:58:10 +01005033 case 'L': lowlevel = TRUE; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005034 }
5035 }
5036 }
5037
5038 if (*keys != NUL || execute)
5039 {
Christopher Plewright20b795e2022-12-20 20:01:58 +00005040 if (lowlevel
5041#ifdef FEAT_VTP
5042 && (!is_term_win32()
5043 || (keys[0] == 3 && ctrl_c_interrupts && typed))
5044#endif
5045 )
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005046 {
Bram Moolenaar5e66b422019-01-24 21:58:10 +01005047#ifdef USE_INPUT_BUF
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005048 ch_log(NULL, "feedkeys() lowlevel: %s", keys);
Bram Moolenaar9645e2d2020-03-20 20:48:49 +01005049
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005050 int len = (int)STRLEN(keys);
5051 for (int idx = 0; idx < len; ++idx)
5052 {
5053 // if a CTRL-C was typed, set got_int, similar to what
5054 // happens in fill_input_buf()
5055 if (keys[idx] == 3 && ctrl_c_interrupts && typed)
5056 got_int = TRUE;
5057 add_to_input_buf(keys + idx, 1);
5058 }
Bram Moolenaar5e66b422019-01-24 21:58:10 +01005059#else
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005060 emsg(_(e_lowlevel_input_not_supported));
Bram Moolenaar5e66b422019-01-24 21:58:10 +01005061#endif
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005062 }
5063 else
5064 {
5065 // Need to escape K_SPECIAL and CSI before putting the string in
5066 // the typeahead buffer.
5067 char_u *keys_esc = vim_strsave_escape_csi(keys);
5068 if (keys_esc == NULL)
5069 return;
5070
5071 ch_log(NULL, "feedkeys(%s): %s", typed ? "typed" : "", keys);
5072
5073 ins_typebuf(keys_esc, (remap ? REMAP_YES : REMAP_NONE),
5074 insert ? 0 : typebuf.tb_len, !typed, FALSE);
5075 if (vgetc_busy
Bram Moolenaar5d7be4f2017-06-25 13:40:17 +02005076#ifdef FEAT_TIMERS
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005077 || timer_busy
Bram Moolenaar5d7be4f2017-06-25 13:40:17 +02005078#endif
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005079 || input_busy)
5080 typebuf_was_filled = TRUE;
5081
Bram Moolenaar8d4ce562019-01-30 22:01:40 +01005082 vim_free(keys_esc);
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005083 }
Bram Moolenaar8d4ce562019-01-30 22:01:40 +01005084
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005085 if (execute)
5086 {
5087 int save_msg_scroll = msg_scroll;
5088 sctx_T save_sctx;
5089
5090 // Avoid a 1 second delay when the keys start Insert mode.
5091 msg_scroll = FALSE;
5092
5093 ch_log(NULL, "feedkeys() executing");
5094
5095 if (context)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005096 {
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005097 save_sctx = current_sctx;
5098 current_sctx.sc_sid = 0;
5099 current_sctx.sc_version = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005100 }
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005101
5102 if (!dangerous)
5103 {
5104 ++ex_normal_busy;
5105 ++in_feedkeys;
5106 }
5107 exec_normal(TRUE, lowlevel, TRUE);
5108 if (!dangerous)
5109 {
5110 --ex_normal_busy;
5111 --in_feedkeys;
5112 }
5113
5114 msg_scroll |= save_msg_scroll;
5115
5116 if (context)
5117 current_sctx = save_sctx;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005118 }
5119 }
5120}
5121
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005122/*
5123 * "fnameescape({string})" function
5124 */
5125 static void
5126f_fnameescape(typval_T *argvars, typval_T *rettv)
5127{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005128 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5129 return;
5130
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005131 rettv->vval.v_string = vim_strsave_fnameescape(
Bram Moolenaar21c1a0c2021-10-17 17:20:23 +01005132 tv_get_string(&argvars[0]), VSE_NONE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005133 rettv->v_type = VAR_STRING;
5134}
5135
5136/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005137 * "foreground()" function
5138 */
5139 static void
5140f_foreground(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
5141{
5142#ifdef FEAT_GUI
5143 if (gui.in_use)
Bram Moolenaarafde13b2019-04-28 19:46:49 +02005144 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005145 gui_mch_set_foreground();
Bram Moolenaarafde13b2019-04-28 19:46:49 +02005146 return;
5147 }
5148#endif
5149#if defined(MSWIN) && (!defined(FEAT_GUI) || defined(VIMDLL))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005150 win32_set_foreground();
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005151#endif
5152}
5153
Bakudankun375141e2022-09-09 18:46:47 +01005154/*
5155 * "function()" function
5156 * "funcref()" function
5157 */
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005158 static void
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005159common_function(typval_T *argvars, typval_T *rettv, int is_funcref)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005160{
5161 char_u *s;
5162 char_u *name;
5163 int use_string = FALSE;
5164 partial_T *arg_pt = NULL;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005165 char_u *trans_name = NULL;
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02005166 int is_global = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005167
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02005168 if (in_vim9script()
Bram Moolenaarae1068a2021-12-25 19:43:44 +00005169 && (check_for_string_or_func_arg(argvars, 0) == FAIL
5170 || check_for_opt_list_arg(argvars, 1) == FAIL
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02005171 || (argvars[1].v_type != VAR_UNKNOWN
5172 && check_for_opt_dict_arg(argvars, 2) == FAIL)))
5173 return;
5174
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005175 if (argvars[0].v_type == VAR_FUNC)
5176 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005177 // function(MyFunc, [arg], dict)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005178 s = argvars[0].vval.v_string;
5179 }
5180 else if (argvars[0].v_type == VAR_PARTIAL
5181 && argvars[0].vval.v_partial != NULL)
5182 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005183 // function(dict.MyFunc, [arg])
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005184 arg_pt = argvars[0].vval.v_partial;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005185 s = partial_name(arg_pt);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005186 }
5187 else
5188 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005189 // function('MyFunc', [arg], dict)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005190 s = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005191 use_string = TRUE;
5192 }
Bram Moolenaar60b6e6f2021-08-28 12:49:27 +02005193 if (s == NULL)
5194 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00005195 semsg(_(e_invalid_argument_str), "NULL");
Bram Moolenaar60b6e6f2021-08-28 12:49:27 +02005196 return;
5197 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005198
Bram Moolenaar843b8842016-08-21 14:36:15 +02005199 if ((use_string && vim_strchr(s, AUTOLOAD_CHAR) == NULL) || is_funcref)
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005200 {
5201 name = s;
Bram Moolenaareba3b7f2021-11-30 18:25:08 +00005202 trans_name = save_function_name(&name, &is_global, FALSE,
5203 TFN_INT | TFN_QUIET | TFN_NO_AUTOLOAD | TFN_NO_DEREF, NULL);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005204 if (*name != NUL)
5205 s = NULL;
5206 }
5207
Bram Moolenaar843b8842016-08-21 14:36:15 +02005208 if (s == NULL || *s == NUL || (use_string && VIM_ISDIGIT(*s))
5209 || (is_funcref && trans_name == NULL))
Yegappan Lakshmanan655b7342022-03-06 14:27:10 +00005210 semsg(_(e_invalid_argument_str),
5211 use_string ? tv_get_string(&argvars[0]) : s);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005212 // Don't check an autoload name for existence here.
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005213 else if (trans_name != NULL && (is_funcref
Bram Moolenaard9d2fd02022-01-13 21:15:21 +00005214 ? find_func(trans_name, is_global) == NULL
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02005215 : !translated_function_exists(trans_name, is_global)))
Bram Moolenaara6f79292022-01-04 21:30:47 +00005216 semsg(_(e_unknown_function_str_2), s);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005217 else
5218 {
5219 int dict_idx = 0;
5220 int arg_idx = 0;
5221 list_T *list = NULL;
5222
5223 if (STRNCMP(s, "s:", 2) == 0 || STRNCMP(s, "<SID>", 5) == 0)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005224 // Expand s: and <SID> into <SNR>nr_, so that the function can
5225 // also be called from another script. Using trans_function_name()
5226 // would also work, but some plugins depend on the name being
5227 // printable text.
Yegappan Lakshmanane7f4abd2021-12-24 20:47:38 +00005228 name = get_scriptlocal_funcname(s);
Bram Moolenaarc2f17f72022-02-21 13:13:50 +00005229 else if (trans_name != NULL && *trans_name == K_SPECIAL)
5230 name = alloc_printable_func_name(trans_name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005231 else
5232 name = vim_strsave(s);
5233
5234 if (argvars[1].v_type != VAR_UNKNOWN)
5235 {
5236 if (argvars[2].v_type != VAR_UNKNOWN)
5237 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005238 // function(name, [args], dict)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005239 arg_idx = 1;
5240 dict_idx = 2;
5241 }
5242 else if (argvars[1].v_type == VAR_DICT)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005243 // function(name, dict)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005244 dict_idx = 1;
5245 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005246 // function(name, [args])
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005247 arg_idx = 1;
5248 if (dict_idx > 0)
5249 {
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +01005250 if (check_for_dict_arg(argvars, dict_idx) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005251 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005252 vim_free(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005253 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005254 }
5255 if (argvars[dict_idx].vval.v_dict == NULL)
5256 dict_idx = 0;
5257 }
5258 if (arg_idx > 0)
5259 {
5260 if (argvars[arg_idx].v_type != VAR_LIST)
5261 {
Bram Moolenaard82a47d2022-01-05 20:24:39 +00005262 emsg(_(e_second_argument_of_function_must_be_list_or_dict));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005263 vim_free(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005264 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005265 }
5266 list = argvars[arg_idx].vval.v_list;
5267 if (list == NULL || list->lv_len == 0)
5268 arg_idx = 0;
Bram Moolenaar4c054e92019-11-10 00:13:50 +01005269 else if (list->lv_len > MAX_FUNC_ARGS)
5270 {
Yegappan Lakshmanan5018a832022-04-02 21:12:21 +01005271 emsg_funcname(e_too_many_arguments_for_function_str, s);
Bram Moolenaar4c054e92019-11-10 00:13:50 +01005272 vim_free(name);
5273 goto theend;
5274 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005275 }
5276 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005277 if (dict_idx > 0 || arg_idx > 0 || arg_pt != NULL || is_funcref)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005278 {
Bram Moolenaarc799fe22019-05-28 23:08:19 +02005279 partial_T *pt = ALLOC_CLEAR_ONE(partial_T);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005280
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005281 // result is a VAR_PARTIAL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005282 if (pt == NULL)
5283 vim_free(name);
5284 else
5285 {
5286 if (arg_idx > 0 || (arg_pt != NULL && arg_pt->pt_argc > 0))
5287 {
5288 listitem_T *li;
5289 int i = 0;
5290 int arg_len = 0;
5291 int lv_len = 0;
5292
5293 if (arg_pt != NULL)
5294 arg_len = arg_pt->pt_argc;
5295 if (list != NULL)
5296 lv_len = list->lv_len;
5297 pt->pt_argc = arg_len + lv_len;
Bram Moolenaarc799fe22019-05-28 23:08:19 +02005298 pt->pt_argv = ALLOC_MULT(typval_T, pt->pt_argc);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005299 if (pt->pt_argv == NULL)
5300 {
5301 vim_free(pt);
5302 vim_free(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005303 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005304 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005305 for (i = 0; i < arg_len; i++)
5306 copy_tv(&arg_pt->pt_argv[i], &pt->pt_argv[i]);
5307 if (lv_len > 0)
Bram Moolenaar50985eb2020-01-27 22:09:39 +01005308 {
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02005309 CHECK_LIST_MATERIALIZE(list);
Bram Moolenaaraeea7212020-04-02 18:50:46 +02005310 FOR_ALL_LIST_ITEMS(list, li)
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005311 copy_tv(&li->li_tv, &pt->pt_argv[i++]);
Bram Moolenaar50985eb2020-01-27 22:09:39 +01005312 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005313 }
5314
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005315 // For "function(dict.func, [], dict)" and "func" is a partial
5316 // use "dict". That is backwards compatible.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005317 if (dict_idx > 0)
5318 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005319 // The dict is bound explicitly, pt_auto is FALSE.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005320 pt->pt_dict = argvars[dict_idx].vval.v_dict;
5321 ++pt->pt_dict->dv_refcount;
5322 }
5323 else if (arg_pt != NULL)
5324 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005325 // If the dict was bound automatically the result is also
5326 // bound automatically.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005327 pt->pt_dict = arg_pt->pt_dict;
5328 pt->pt_auto = arg_pt->pt_auto;
5329 if (pt->pt_dict != NULL)
5330 ++pt->pt_dict->dv_refcount;
Yegappan Lakshmanan29bb67f2023-10-14 11:18:50 +02005331 pt->pt_obj = arg_pt->pt_obj;
5332 if (pt->pt_obj != NULL)
5333 ++pt->pt_obj->obj_refcount;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005334 }
5335
5336 pt->pt_refcount = 1;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005337 if (arg_pt != NULL && arg_pt->pt_func != NULL)
5338 {
5339 pt->pt_func = arg_pt->pt_func;
5340 func_ptr_ref(pt->pt_func);
5341 vim_free(name);
5342 }
5343 else if (is_funcref)
5344 {
Bram Moolenaard9d2fd02022-01-13 21:15:21 +00005345 pt->pt_func = find_func(trans_name, is_global);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005346 func_ptr_ref(pt->pt_func);
5347 vim_free(name);
5348 }
5349 else
5350 {
5351 pt->pt_name = name;
5352 func_ref(name);
5353 }
Bram Moolenaar92368aa2022-02-07 17:50:39 +00005354
5355 if (arg_pt != NULL)
Bram Moolenaar7aca5ca2022-02-07 19:56:43 +00005356 {
5357 pt->pt_outer_partial = arg_pt;
5358 ++arg_pt->pt_refcount;
5359 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005360 }
5361 rettv->v_type = VAR_PARTIAL;
5362 rettv->vval.v_partial = pt;
5363 }
5364 else
5365 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005366 // result is a VAR_FUNC
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005367 rettv->v_type = VAR_FUNC;
5368 rettv->vval.v_string = name;
5369 func_ref(name);
5370 }
5371 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005372theend:
5373 vim_free(trans_name);
5374}
5375
5376/*
5377 * "funcref()" function
5378 */
5379 static void
5380f_funcref(typval_T *argvars, typval_T *rettv)
5381{
5382 common_function(argvars, rettv, TRUE);
5383}
5384
5385/*
5386 * "function()" function
5387 */
5388 static void
5389f_function(typval_T *argvars, typval_T *rettv)
5390{
5391 common_function(argvars, rettv, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005392}
5393
5394/*
5395 * "garbagecollect()" function
5396 */
5397 static void
5398f_garbagecollect(typval_T *argvars, typval_T *rettv UNUSED)
5399{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005400 if (in_vim9script() && check_for_opt_bool_arg(argvars, 0) == FAIL)
5401 return;
5402
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005403 // This is postponed until we are back at the toplevel, because we may be
5404 // using Lists and Dicts internally. E.g.: ":echo [garbagecollect()]".
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005405 want_garbage_collect = TRUE;
5406
Bram Moolenaar2df47312020-09-05 17:30:44 +02005407 if (argvars[0].v_type != VAR_UNKNOWN && tv_get_bool(&argvars[0]) == 1)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005408 garbage_collect_at_exit = TRUE;
5409}
5410
5411/*
5412 * "get()" function
5413 */
5414 static void
5415f_get(typval_T *argvars, typval_T *rettv)
5416{
5417 listitem_T *li;
5418 list_T *l;
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01005419 tuple_T *tuple;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005420 dictitem_T *di;
5421 dict_T *d;
5422 typval_T *tv = NULL;
Bram Moolenaarf91aac52019-07-28 13:21:01 +02005423 int what_is_dict = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005424
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005425 if (argvars[0].v_type == VAR_BLOB)
5426 {
5427 int error = FALSE;
5428 int idx = tv_get_number_chk(&argvars[1], &error);
5429
5430 if (!error)
5431 {
5432 rettv->v_type = VAR_NUMBER;
Bram Moolenaar2ea773b2019-01-15 22:16:42 +01005433 if (idx < 0)
5434 idx = blob_len(argvars[0].vval.v_blob) + idx;
5435 if (idx < 0 || idx >= blob_len(argvars[0].vval.v_blob))
5436 rettv->vval.v_number = -1;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005437 else
Bram Moolenaar2ea773b2019-01-15 22:16:42 +01005438 {
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005439 rettv->vval.v_number = blob_get(argvars[0].vval.v_blob, idx);
Bram Moolenaar2ea773b2019-01-15 22:16:42 +01005440 tv = rettv;
5441 }
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005442 }
5443 }
5444 else if (argvars[0].v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005445 {
5446 if ((l = argvars[0].vval.v_list) != NULL)
5447 {
5448 int error = FALSE;
5449
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005450 li = list_find(l, (long)tv_get_number_chk(&argvars[1], &error));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005451 if (!error && li != NULL)
5452 tv = &li->li_tv;
5453 }
5454 }
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01005455 else if (argvars[0].v_type == VAR_TUPLE)
5456 {
5457 if ((tuple = argvars[0].vval.v_tuple) != NULL)
5458 {
5459 int error = FALSE;
5460 long idx;
5461
5462 idx = (long)tv_get_number_chk(&argvars[1], &error);
5463 if (!error)
5464 tv = tuple_find(tuple, idx);
5465 }
5466 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005467 else if (argvars[0].v_type == VAR_DICT)
5468 {
5469 if ((d = argvars[0].vval.v_dict) != NULL)
5470 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005471 di = dict_find(d, tv_get_string(&argvars[1]), -1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005472 if (di != NULL)
5473 tv = &di->di_tv;
5474 }
5475 }
5476 else if (argvars[0].v_type == VAR_PARTIAL || argvars[0].v_type == VAR_FUNC)
5477 {
5478 partial_T *pt;
5479 partial_T fref_pt;
5480
5481 if (argvars[0].v_type == VAR_PARTIAL)
5482 pt = argvars[0].vval.v_partial;
5483 else
5484 {
Bram Moolenaara80faa82020-04-12 19:37:17 +02005485 CLEAR_FIELD(fref_pt);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005486 fref_pt.pt_name = argvars[0].vval.v_string;
5487 pt = &fref_pt;
5488 }
5489
5490 if (pt != NULL)
5491 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005492 char_u *what = tv_get_string(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005493
5494 if (STRCMP(what, "func") == 0 || STRCMP(what, "name") == 0)
5495 {
Bram Moolenaar1ae8c262022-06-27 11:45:52 +01005496 char_u *name = partial_name(pt);
5497
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005498 rettv->v_type = (*what == 'f' ? VAR_FUNC : VAR_STRING);
Bram Moolenaar1ae8c262022-06-27 11:45:52 +01005499 if (name == NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005500 rettv->vval.v_string = NULL;
5501 else
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005502 {
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005503 if (rettv->v_type == VAR_FUNC)
Bram Moolenaar1ae8c262022-06-27 11:45:52 +01005504 func_ref(name);
5505 if (*what == 'n' && pt->pt_name == NULL
5506 && pt->pt_func != NULL)
5507 // use <SNR> instead of the byte code
5508 name = printable_func_name(pt->pt_func);
5509 rettv->vval.v_string = vim_strsave(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005510 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005511 }
5512 else if (STRCMP(what, "dict") == 0)
Bram Moolenaarf91aac52019-07-28 13:21:01 +02005513 {
5514 what_is_dict = TRUE;
5515 if (pt->pt_dict != NULL)
5516 rettv_dict_set(rettv, pt->pt_dict);
5517 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005518 else if (STRCMP(what, "args") == 0)
5519 {
5520 rettv->v_type = VAR_LIST;
5521 if (rettv_list_alloc(rettv) == OK)
5522 {
5523 int i;
5524
5525 for (i = 0; i < pt->pt_argc; ++i)
5526 list_append_tv(rettv->vval.v_list, &pt->pt_argv[i]);
5527 }
5528 }
LemonBoy48b7d052024-07-09 18:24:59 +02005529 else if (STRCMP(what, "arity") == 0)
5530 {
5531 int required = 0, optional = 0, varargs = FALSE;
5532 char_u *name = partial_name(pt);
5533
5534 get_func_arity(name, &required, &optional, &varargs);
5535
5536 rettv->v_type = VAR_DICT;
5537 if (rettv_dict_alloc(rettv) == OK)
5538 {
5539 dict_T *dict = rettv->vval.v_dict;
5540
5541 // Take into account the arguments of the partial, if any.
5542 // Note that it is possible to supply more arguments than the function
5543 // accepts.
5544 if (pt->pt_argc >= required + optional)
5545 required = optional = 0;
5546 else if (pt->pt_argc > required)
5547 {
5548 optional -= pt->pt_argc - required;
5549 required = 0;
5550 }
5551 else
5552 required -= pt->pt_argc;
5553
5554 dict_add_number(dict, "required", required);
5555 dict_add_number(dict, "optional", optional);
5556 dict_add_bool(dict, "varargs", varargs);
5557 }
5558 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005559 else
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00005560 semsg(_(e_invalid_argument_str), what);
Bram Moolenaarf91aac52019-07-28 13:21:01 +02005561
5562 // When {what} == "dict" and pt->pt_dict == NULL, evaluate the
5563 // third argument
5564 if (!what_is_dict)
5565 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005566 }
5567 }
5568 else
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01005569 semsg(_(e_argument_of_str_must_be_list_tuple_dictionary_or_blob), "get()");
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005570
5571 if (tv == NULL)
5572 {
5573 if (argvars[2].v_type != VAR_UNKNOWN)
5574 copy_tv(&argvars[2], rettv);
5575 }
5576 else
5577 copy_tv(tv, rettv);
5578}
5579
Bram Moolenaarb5ae48e2016-08-12 22:23:25 +02005580/*
mikoto2000a73dfc22024-11-18 21:12:21 +01005581 * "getcellpixels()" function
5582 */
5583 static void
5584f_getcellpixels(typval_T *argvars UNUSED, typval_T *rettv)
5585{
5586 if (rettv_list_alloc(rettv) == FAIL)
Naruhiko Nishinoc2a90002025-05-04 20:05:47 +02005587 return;
mikoto2000a73dfc22024-11-18 21:12:21 +01005588
5589#if defined(FEAT_GUI)
5590 if (gui.in_use)
5591 {
Naruhiko Nishinoc2a90002025-05-04 20:05:47 +02005592 // success pixel size and no gui.
5593 list_append_number(rettv->vval.v_list, (varnumber_T)gui.char_width);
5594 list_append_number(rettv->vval.v_list, (varnumber_T)gui.char_height);
mikoto2000a73dfc22024-11-18 21:12:21 +01005595 }
5596 else
5597#endif
5598 {
Naruhiko Nishinoc2a90002025-05-04 20:05:47 +02005599 struct cellsize cs;
mikoto2000a73dfc22024-11-18 21:12:21 +01005600#if defined(UNIX)
Naruhiko Nishinoc2a90002025-05-04 20:05:47 +02005601 mch_calc_cell_size(&cs);
mikoto2000a73dfc22024-11-18 21:12:21 +01005602#else
Naruhiko Nishinoc2a90002025-05-04 20:05:47 +02005603 // Non-Unix CUIs are not supported, so set this to -1x-1.
5604 cs.cs_xpixel = -1;
5605 cs.cs_ypixel = -1;
mikoto2000a73dfc22024-11-18 21:12:21 +01005606#endif
5607
Naruhiko Nishinoc2a90002025-05-04 20:05:47 +02005608 // failed get pixel size.
5609 if (cs.cs_xpixel == -1)
5610 return;
mikoto2000a73dfc22024-11-18 21:12:21 +01005611
Naruhiko Nishinoc2a90002025-05-04 20:05:47 +02005612 // success pixel size and no gui.
5613 list_append_number(rettv->vval.v_list, (varnumber_T)cs.cs_xpixel);
5614 list_append_number(rettv->vval.v_list, (varnumber_T)cs.cs_ypixel);
mikoto2000a73dfc22024-11-18 21:12:21 +01005615 }
5616
5617}
5618
5619/*
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005620 * "getchangelist()" function
5621 */
5622 static void
5623f_getchangelist(typval_T *argvars, typval_T *rettv)
5624{
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005625 buf_T *buf;
5626 int i;
5627 list_T *l;
5628 dict_T *d;
LemonBoydb0ea7f2022-04-10 17:59:26 +01005629 int changelistindex;
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005630
Bram Moolenaar93a10962022-06-16 11:42:09 +01005631 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005632 return;
5633
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005634 if (in_vim9script() && check_for_opt_buffer_arg(argvars, 0) == FAIL)
5635 return;
5636
Bram Moolenaar4c313b12019-08-24 22:58:31 +02005637 if (argvars[0].v_type == VAR_UNKNOWN)
5638 buf = curbuf;
5639 else
Bram Moolenaara5d38412020-09-02 21:02:35 +02005640 buf = tv_get_buf_from_arg(&argvars[0]);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005641 if (buf == NULL)
5642 return;
5643
5644 l = list_alloc();
5645 if (l == NULL)
5646 return;
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005647 if (list_append_list(rettv->vval.v_list, l) == FAIL)
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005648 {
5649 vim_free(l);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005650 return;
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005651 }
5652
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005653 /*
LemonBoydb0ea7f2022-04-10 17:59:26 +01005654 * The current window change list index tracks only the position for the
5655 * current buffer. For other buffers use the stored index for the current
5656 * window, or, if that's not available, the change list length.
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005657 */
LemonBoydb0ea7f2022-04-10 17:59:26 +01005658 if (buf == curwin->w_buffer)
5659 {
5660 changelistindex = curwin->w_changelistidx;
5661 }
5662 else
5663 {
5664 wininfo_T *wip;
5665
5666 FOR_ALL_BUF_WININFO(buf, wip)
5667 if (wip->wi_win == curwin)
5668 break;
5669 changelistindex = wip != NULL ? wip->wi_changelistidx
5670 : buf->b_changelistlen;
5671 }
5672 list_append_number(rettv->vval.v_list, (varnumber_T)changelistindex);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005673
5674 for (i = 0; i < buf->b_changelistlen; ++i)
5675 {
5676 if (buf->b_changelist[i].lnum == 0)
5677 continue;
5678 if ((d = dict_alloc()) == NULL)
5679 return;
5680 if (list_append_dict(l, d) == FAIL)
5681 return;
Bram Moolenaare0be1672018-07-08 16:50:37 +02005682 dict_add_number(d, "lnum", (long)buf->b_changelist[i].lnum);
5683 dict_add_number(d, "col", (long)buf->b_changelist[i].col);
Bram Moolenaare0be1672018-07-08 16:50:37 +02005684 dict_add_number(d, "coladd", (long)buf->b_changelist[i].coladd);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005685 }
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005686}
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005687
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005688 static void
5689getpos_both(
5690 typval_T *argvars,
5691 typval_T *rettv,
5692 int getcurpos,
5693 int charcol)
5694{
5695 pos_T *fp = NULL;
5696 pos_T pos;
5697 win_T *wp = curwin;
5698 list_T *l;
5699 int fnum = -1;
5700
5701 if (rettv_list_alloc(rettv) == OK)
5702 {
5703 l = rettv->vval.v_list;
5704 if (getcurpos)
5705 {
5706 if (argvars[0].v_type != VAR_UNKNOWN)
5707 {
5708 wp = find_win_by_nr_or_id(&argvars[0]);
5709 if (wp != NULL)
5710 fp = &wp->w_cursor;
5711 }
5712 else
5713 fp = &curwin->w_cursor;
5714 if (fp != NULL && charcol)
5715 {
5716 pos = *fp;
Bram Moolenaar91458462021-01-13 20:08:38 +01005717 pos.col =
5718 buf_byteidx_to_charidx(wp->w_buffer, pos.lnum, pos.col);
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005719 fp = &pos;
5720 }
5721 }
5722 else
5723 fp = var2fpos(&argvars[0], TRUE, &fnum, charcol);
5724 if (fnum != -1)
5725 list_append_number(l, (varnumber_T)fnum);
5726 else
5727 list_append_number(l, (varnumber_T)0);
5728 list_append_number(l, (fp != NULL) ? (varnumber_T)fp->lnum
5729 : (varnumber_T)0);
5730 list_append_number(l, (fp != NULL)
5731 ? (varnumber_T)(fp->col == MAXCOL ? MAXCOL : fp->col + 1)
5732 : (varnumber_T)0);
5733 list_append_number(l, (fp != NULL) ? (varnumber_T)fp->coladd :
5734 (varnumber_T)0);
5735 if (getcurpos)
5736 {
5737 int save_set_curswant = curwin->w_set_curswant;
5738 colnr_T save_curswant = curwin->w_curswant;
5739 colnr_T save_virtcol = curwin->w_virtcol;
5740
5741 if (wp == curwin)
5742 update_curswant();
5743 list_append_number(l, wp == NULL ? 0 : wp->w_curswant == MAXCOL
5744 ? (varnumber_T)MAXCOL : (varnumber_T)wp->w_curswant + 1);
5745
5746 // Do not change "curswant", as it is unexpected that a get
5747 // function has a side effect.
5748 if (wp == curwin && save_set_curswant)
5749 {
5750 curwin->w_set_curswant = save_set_curswant;
5751 curwin->w_curswant = save_curswant;
5752 curwin->w_virtcol = save_virtcol;
5753 curwin->w_valid &= ~VALID_VIRTCOL;
5754 }
5755 }
5756 }
5757 else
5758 rettv->vval.v_number = FALSE;
5759}
5760
5761/*
5762 * "getcharpos()" function
5763 */
5764 static void
5765f_getcharpos(typval_T *argvars UNUSED, typval_T *rettv)
5766{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005767 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5768 return;
5769
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005770 getpos_both(argvars, rettv, FALSE, TRUE);
5771}
5772
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005773/*
5774 * "getcharsearch()" function
5775 */
5776 static void
5777f_getcharsearch(typval_T *argvars UNUSED, typval_T *rettv)
5778{
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00005779 if (rettv_dict_alloc(rettv) != OK)
5780 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005781
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00005782 dict_T *dict = rettv->vval.v_dict;
5783
5784 dict_add_string(dict, "char", last_csearch());
5785 dict_add_number(dict, "forward", last_csearch_forward());
5786 dict_add_number(dict, "until", last_csearch_until());
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005787}
5788
5789/*
Bram Moolenaar691ddee2019-05-09 14:52:41 +02005790 * "getenv()" function
5791 */
5792 static void
5793f_getenv(typval_T *argvars, typval_T *rettv)
5794{
5795 int mustfree = FALSE;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005796 char_u *p;
Bram Moolenaar691ddee2019-05-09 14:52:41 +02005797
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005798 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5799 return;
5800
5801 p = vim_getenv(tv_get_string(&argvars[0]), &mustfree);
Bram Moolenaar691ddee2019-05-09 14:52:41 +02005802 if (p == NULL)
5803 {
5804 rettv->v_type = VAR_SPECIAL;
5805 rettv->vval.v_number = VVAL_NULL;
5806 return;
5807 }
5808 if (!mustfree)
5809 p = vim_strsave(p);
5810 rettv->vval.v_string = p;
5811 rettv->v_type = VAR_STRING;
5812}
5813
5814/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005815 * "getfontname()" function
5816 */
5817 static void
5818f_getfontname(typval_T *argvars UNUSED, typval_T *rettv)
5819{
5820 rettv->v_type = VAR_STRING;
5821 rettv->vval.v_string = NULL;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005822
5823 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
5824 return;
5825
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005826#ifdef FEAT_GUI
5827 if (gui.in_use)
5828 {
5829 GuiFont font;
5830 char_u *name = NULL;
5831
5832 if (argvars[0].v_type == VAR_UNKNOWN)
5833 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005834 // Get the "Normal" font. Either the name saved by
5835 // hl_set_font_name() or from the font ID.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005836 font = gui.norm_font;
5837 name = hl_get_font_name();
5838 }
5839 else
5840 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005841 name = tv_get_string(&argvars[0]);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005842 if (STRCMP(name, "*") == 0) // don't use font dialog
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005843 return;
5844 font = gui_mch_get_font(name, FALSE);
5845 if (font == NOFONT)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005846 return; // Invalid font name, return empty string.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005847 }
5848 rettv->vval.v_string = gui_mch_get_fontname(font, name);
5849 if (argvars[0].v_type != VAR_UNKNOWN)
5850 gui_mch_free_font(font);
5851 }
5852#endif
5853}
5854
5855/*
Bram Moolenaar4f505882018-02-10 21:06:32 +01005856 * "getjumplist()" function
5857 */
5858 static void
5859f_getjumplist(typval_T *argvars, typval_T *rettv)
5860{
Bram Moolenaar4f505882018-02-10 21:06:32 +01005861 win_T *wp;
5862 int i;
5863 list_T *l;
5864 dict_T *d;
Bram Moolenaar4f505882018-02-10 21:06:32 +01005865
Bram Moolenaar93a10962022-06-16 11:42:09 +01005866 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar4f505882018-02-10 21:06:32 +01005867 return;
5868
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005869 if (in_vim9script()
5870 && (check_for_opt_number_arg(argvars, 0) == FAIL
5871 || (argvars[0].v_type != VAR_UNKNOWN
5872 && check_for_opt_number_arg(argvars, 1) == FAIL)))
5873 return;
5874
Bram Moolenaar00aa0692019-04-27 20:37:57 +02005875 wp = find_tabwin(&argvars[0], &argvars[1], NULL);
Bram Moolenaar4f505882018-02-10 21:06:32 +01005876 if (wp == NULL)
5877 return;
5878
Bram Moolenaar57ee2b62019-02-12 22:15:06 +01005879 cleanup_jumplist(wp, TRUE);
5880
Bram Moolenaar4f505882018-02-10 21:06:32 +01005881 l = list_alloc();
5882 if (l == NULL)
5883 return;
Bram Moolenaar4f505882018-02-10 21:06:32 +01005884 if (list_append_list(rettv->vval.v_list, l) == FAIL)
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005885 {
5886 vim_free(l);
Bram Moolenaar4f505882018-02-10 21:06:32 +01005887 return;
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005888 }
5889
Bram Moolenaar4f505882018-02-10 21:06:32 +01005890 list_append_number(rettv->vval.v_list, (varnumber_T)wp->w_jumplistidx);
5891
5892 for (i = 0; i < wp->w_jumplistlen; ++i)
5893 {
Bram Moolenaara7e18d22018-02-11 14:29:49 +01005894 if (wp->w_jumplist[i].fmark.mark.lnum == 0)
5895 continue;
Bram Moolenaar4f505882018-02-10 21:06:32 +01005896 if ((d = dict_alloc()) == NULL)
5897 return;
5898 if (list_append_dict(l, d) == FAIL)
5899 return;
Bram Moolenaare0be1672018-07-08 16:50:37 +02005900 dict_add_number(d, "lnum", (long)wp->w_jumplist[i].fmark.mark.lnum);
5901 dict_add_number(d, "col", (long)wp->w_jumplist[i].fmark.mark.col);
Bram Moolenaare0be1672018-07-08 16:50:37 +02005902 dict_add_number(d, "coladd", (long)wp->w_jumplist[i].fmark.mark.coladd);
Bram Moolenaare0be1672018-07-08 16:50:37 +02005903 dict_add_number(d, "bufnr", (long)wp->w_jumplist[i].fmark.fnum);
Bram Moolenaara7e18d22018-02-11 14:29:49 +01005904 if (wp->w_jumplist[i].fname != NULL)
Bram Moolenaare0be1672018-07-08 16:50:37 +02005905 dict_add_string(d, "filename", wp->w_jumplist[i].fname);
Bram Moolenaar4f505882018-02-10 21:06:32 +01005906 }
Bram Moolenaar4f505882018-02-10 21:06:32 +01005907}
5908
5909/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005910 * "getpid()" function
5911 */
5912 static void
5913f_getpid(typval_T *argvars UNUSED, typval_T *rettv)
5914{
5915 rettv->vval.v_number = mch_get_pid();
5916}
5917
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005918/*
5919 * "getcurpos()" function
5920 */
5921 static void
5922f_getcurpos(typval_T *argvars, typval_T *rettv)
5923{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005924 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
5925 return;
5926
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005927 getpos_both(argvars, rettv, TRUE, FALSE);
5928}
5929
5930 static void
5931f_getcursorcharpos(typval_T *argvars, typval_T *rettv)
5932{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005933 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
5934 return;
5935
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005936 getpos_both(argvars, rettv, TRUE, TRUE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005937}
5938
5939/*
5940 * "getpos(string)" function
5941 */
5942 static void
5943f_getpos(typval_T *argvars, typval_T *rettv)
5944{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005945 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5946 return;
5947
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005948 getpos_both(argvars, rettv, FALSE, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005949}
5950
5951/*
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005952 * Convert from block_def to string
5953 */
Gary Johnson88d4f252024-06-01 20:51:33 +02005954 static char_u *
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005955block_def2str(struct block_def *bd)
5956{
5957 char_u *p, *ret;
5958 size_t size = bd->startspaces + bd->endspaces + bd->textlen;
5959
5960 ret = alloc(size + 1);
5961 if (ret != NULL)
5962 {
5963 p = ret;
5964 vim_memset(p, ' ', bd->startspaces);
5965 p += bd->startspaces;
5966 mch_memmove(p, bd->textstart, bd->textlen);
5967 p += bd->textlen;
5968 vim_memset(p, ' ', bd->endspaces);
5969 *(p + bd->endspaces) = NUL;
5970 }
5971 return ret;
5972}
5973
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005974 static int
5975getregionpos(
5976 typval_T *argvars,
5977 typval_T *rettv,
zeertzjqc95e64f2024-05-20 14:00:31 +02005978 pos_T *p1,
5979 pos_T *p2,
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005980 int *inclusive,
5981 int *region_type,
zeertzjqafc22952024-05-24 19:07:12 +02005982 oparg_T *oap)
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005983{
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005984 int fnum1 = -1, fnum2 = -1;
5985 char_u *type;
5986 buf_T *findbuf;
5987 char_u default_type[] = "v";
zeertzjqafc22952024-05-24 19:07:12 +02005988 int block_width = 0;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005989 int is_select_exclusive;
5990 int l;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005991
5992 if (rettv_list_alloc(rettv) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005993 return FAIL;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005994
Shougo Matsushita19b71882024-02-28 22:48:12 +01005995 if (check_for_list_arg(argvars, 0) == FAIL
5996 || check_for_list_arg(argvars, 1) == FAIL
5997 || check_for_opt_dict_arg(argvars, 2) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005998 return FAIL;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005999
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006000 if (list2fpos(&argvars[0], p1, &fnum1, NULL, FALSE) != OK
6001 || list2fpos(&argvars[1], p2, &fnum2, NULL, FALSE) != OK
Shougo Matsushita84bf6e62024-03-06 21:10:18 +01006002 || fnum1 != fnum2)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006003 return FAIL;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006004
Shougo Matsushita19b71882024-02-28 22:48:12 +01006005 if (argvars[2].v_type == VAR_DICT)
6006 {
6007 is_select_exclusive = dict_get_bool(
6008 argvars[2].vval.v_dict, "exclusive", *p_sel == 'e');
6009 type = dict_get_string(
6010 argvars[2].vval.v_dict, "type", FALSE);
6011 if (type == NULL)
6012 type = default_type;
6013 }
6014 else
6015 {
6016 is_select_exclusive = *p_sel == 'e';
6017 type = default_type;
6018 }
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006019
6020 if (type[0] == 'v' && type[1] == NUL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006021 *region_type = MCHAR;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006022 else if (type[0] == 'V' && type[1] == NUL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006023 *region_type = MLINE;
zeertzjqafc22952024-05-24 19:07:12 +02006024 else if (type[0] == Ctrl_V)
6025 {
6026 char_u *p = type + 1;
6027
6028 if (*p != NUL && ((block_width = getdigits(&p)) <= 0 || *p != NUL))
6029 {
6030 semsg(_(e_invalid_value_for_argument_str_str), "type", type);
6031 return FAIL;
6032 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006033 *region_type = MBLOCK;
zeertzjqafc22952024-05-24 19:07:12 +02006034 }
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006035 else
zeertzjq26dd09a2024-03-10 15:46:58 +01006036 {
6037 semsg(_(e_invalid_value_for_argument_str_str), "type", type);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006038 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01006039 }
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006040
zeertzjq5406eb82024-03-11 21:36:42 +01006041 findbuf = fnum1 != 0 ? buflist_findnr(fnum1) : curbuf;
6042 if (findbuf == NULL || findbuf->b_ml.ml_mfp == NULL)
Shougo Matsushita84bf6e62024-03-06 21:10:18 +01006043 {
zeertzjq5406eb82024-03-11 21:36:42 +01006044 emsg(_(e_buffer_is_not_loaded));
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006045 return FAIL;
Shougo Matsushita84bf6e62024-03-06 21:10:18 +01006046 }
6047
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006048 if (p1->lnum < 1 || p1->lnum > findbuf->b_ml.ml_line_count)
zeertzjq26dd09a2024-03-10 15:46:58 +01006049 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006050 semsg(_(e_invalid_line_number_nr), p1->lnum);
6051 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01006052 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006053 if (p1->col == MAXCOL)
6054 p1->col = ml_get_buf_len(findbuf, p1->lnum) + 1;
6055 else if (p1->col < 1 || p1->col > ml_get_buf_len(findbuf, p1->lnum) + 1)
zeertzjq26dd09a2024-03-10 15:46:58 +01006056 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006057 semsg(_(e_invalid_column_number_nr), p1->col);
6058 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01006059 }
zeertzjq2ffdae72024-05-02 13:06:24 +02006060
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006061 if (p2->lnum < 1 || p2->lnum > findbuf->b_ml.ml_line_count)
zeertzjq26dd09a2024-03-10 15:46:58 +01006062 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006063 semsg(_(e_invalid_line_number_nr), p2->lnum);
6064 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01006065 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006066 if (p2->col == MAXCOL)
6067 p2->col = ml_get_buf_len(findbuf, p2->lnum) + 1;
6068 else if (p2->col < 1 || p2->col > ml_get_buf_len(findbuf, p2->lnum) + 1)
zeertzjq26dd09a2024-03-10 15:46:58 +01006069 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006070 semsg(_(e_invalid_column_number_nr), p2->col);
6071 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01006072 }
6073
6074 curbuf = findbuf;
zeertzjq5406eb82024-03-11 21:36:42 +01006075 curwin->w_buffer = curbuf;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006076 virtual_op = virtual_active();
6077
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006078 // NOTE: Adjustment is needed.
6079 p1->col--;
6080 p2->col--;
Shougo Matsushita19b71882024-02-28 22:48:12 +01006081
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006082 if (!LT_POS(*p1, *p2))
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006083 {
6084 // swap position
6085 pos_T p;
6086
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006087 p = *p1;
6088 *p1 = *p2;
6089 *p2 = p;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006090 }
6091
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006092 if (*region_type == MCHAR)
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006093 {
zeertzjq701ad502024-05-23 07:47:55 +02006094 // Handle 'selection' == "exclusive".
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006095 if (is_select_exclusive && !EQUAL_POS(*p1, *p2))
zeertzjq701ad502024-05-23 07:47:55 +02006096 // When backing up to previous line, inclusive becomes false.
6097 *inclusive = !unadjust_for_sel_inner(p2);
6098 // If p2 is on NUL (end of line), inclusive becomes false.
6099 if (*inclusive && !virtual_op && *ml_get_pos(p2) == NUL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006100 *inclusive = FALSE;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006101 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006102 else if (*region_type == MBLOCK)
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006103 {
6104 colnr_T sc1, ec1, sc2, ec2;
6105
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006106 getvvcol(curwin, p1, &sc1, NULL, &ec1);
6107 getvvcol(curwin, p2, &sc2, NULL, &ec2);
zeertzjqafc22952024-05-24 19:07:12 +02006108 oap->motion_type = MBLOCK;
6109 oap->inclusive = TRUE;
6110 oap->op_type = OP_NOP;
6111 oap->start = *p1;
6112 oap->end = *p2;
6113 oap->start_vcol = MIN(sc1, sc2);
6114 if (block_width > 0)
6115 oap->end_vcol = oap->start_vcol + block_width - 1;
6116 else if (is_select_exclusive && ec1 < sc2 && 0 < sc2 && ec2 > ec1)
6117 oap->end_vcol = sc2 - 1;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006118 else
zeertzjqafc22952024-05-24 19:07:12 +02006119 oap->end_vcol = MAX(ec1, ec2);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006120 }
6121
6122 // Include the trailing byte of a multi-byte char.
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006123 l = mb_ptr2len((char_u *)ml_get_pos(p2));
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006124 if (l > 1)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006125 p2->col += l - 1;
6126
6127 return OK;
6128}
6129
6130/*
6131 * "getregion()" function
6132 */
6133 static void
6134f_getregion(typval_T *argvars, typval_T *rettv)
6135{
6136 pos_T p1, p2;
6137 int inclusive = TRUE;
6138 int region_type = -1;
6139 oparg_T oa;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006140
6141 buf_T *save_curbuf;
6142 int save_virtual;
6143 char_u *akt = NULL;
6144 linenr_T lnum;
6145
6146 save_curbuf = curbuf;
6147 save_virtual = virtual_op;
6148
6149 if (getregionpos(argvars, rettv,
zeertzjqc95e64f2024-05-20 14:00:31 +02006150 &p1, &p2, &inclusive, &region_type, &oa) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006151 return;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006152
6153 for (lnum = p1.lnum; lnum <= p2.lnum; lnum++)
6154 {
6155 int ret = 0;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006156 struct block_def bd;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006157
6158 if (region_type == MLINE)
6159 akt = vim_strsave(ml_get(lnum));
6160 else if (region_type == MBLOCK)
6161 {
zeertzjq5e3674b2024-02-22 19:51:34 +01006162 block_prep(&oa, &bd, lnum, FALSE);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006163 akt = block_def2str(&bd);
6164 }
6165 else if (p1.lnum < lnum && lnum < p2.lnum)
6166 akt = vim_strsave(ml_get(lnum));
6167 else
6168 {
6169 charwise_block_prep(p1, p2, &bd, lnum, inclusive);
6170 akt = block_def2str(&bd);
6171 }
6172
6173 if (akt)
6174 {
6175 ret = list_append_string(rettv->vval.v_list, akt, -1);
6176 vim_free(akt);
6177 }
6178
6179 if (akt == NULL || ret == FAIL)
6180 {
zeertzjq5e3674b2024-02-22 19:51:34 +01006181 clear_tv(rettv);
6182 (void)rettv_list_alloc(rettv);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006183 break;
6184 }
6185 }
6186
zeertzjqc95e64f2024-05-20 14:00:31 +02006187 // getregionpos() may change curbuf and virtual_op
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006188 curbuf = save_curbuf;
6189 curwin->w_buffer = curbuf;
6190 virtual_op = save_virtual;
6191}
6192
6193 static void
zeertzjqc95e64f2024-05-20 14:00:31 +02006194add_regionpos_range(typval_T *rettv, pos_T p1, pos_T p2)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006195{
6196 list_T *l1, *l2, *l3;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006197
6198 l1 = list_alloc();
6199 if (l1 == NULL)
6200 return;
6201
6202 if (list_append_list(rettv->vval.v_list, l1) == FAIL)
6203 {
6204 vim_free(l1);
6205 return;
6206 }
6207
6208 l2 = list_alloc();
6209 if (l2 == NULL)
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006210 {
6211 vim_free(l1);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006212 return;
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006213 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006214
6215 if (list_append_list(l1, l2) == FAIL)
6216 {
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006217 vim_free(l1);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006218 vim_free(l2);
6219 return;
6220 }
6221
6222 l3 = list_alloc();
6223 if (l3 == NULL)
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006224 {
6225 vim_free(l1);
6226 vim_free(l2);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006227 return;
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006228 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006229
6230 if (list_append_list(l1, l3) == FAIL)
6231 {
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006232 vim_free(l1);
6233 vim_free(l2);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006234 vim_free(l3);
6235 return;
6236 }
6237
zeertzjqc95e64f2024-05-20 14:00:31 +02006238 list_append_number(l2, curbuf->b_fnum);
6239 list_append_number(l2, p1.lnum);
zeertzjq2b09de92024-05-24 07:48:51 +02006240 list_append_number(l2, p1.col);
zeertzjqc95e64f2024-05-20 14:00:31 +02006241 list_append_number(l2, p1.coladd);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006242
zeertzjqc95e64f2024-05-20 14:00:31 +02006243 list_append_number(l3, curbuf->b_fnum);
6244 list_append_number(l3, p2.lnum);
zeertzjq2b09de92024-05-24 07:48:51 +02006245 list_append_number(l3, p2.col);
zeertzjqc95e64f2024-05-20 14:00:31 +02006246 list_append_number(l3, p2.coladd);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006247}
6248
6249/*
6250 * "getregionpos()" function
6251 */
6252 static void
6253f_getregionpos(typval_T *argvars, typval_T *rettv)
6254{
6255 pos_T p1, p2;
6256 int inclusive = TRUE;
6257 int region_type = -1;
zeertzjq2b09de92024-05-24 07:48:51 +02006258 int allow_eol = FALSE;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006259 oparg_T oa;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006260 int lnum;
6261
6262 buf_T *save_curbuf;
6263 int save_virtual;
6264
6265 save_curbuf = curbuf;
6266 save_virtual = virtual_op;
6267
6268 if (getregionpos(argvars, rettv,
zeertzjqc95e64f2024-05-20 14:00:31 +02006269 &p1, &p2, &inclusive, &region_type, &oa) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006270 return;
6271
zeertzjq2b09de92024-05-24 07:48:51 +02006272 if (argvars[2].v_type == VAR_DICT)
6273 allow_eol = dict_get_bool(argvars[2].vval.v_dict, "eol", FALSE);
6274
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006275 for (lnum = p1.lnum; lnum <= p2.lnum; lnum++)
6276 {
zeertzjq2b09de92024-05-24 07:48:51 +02006277 pos_T ret_p1, ret_p2;
zeertzjqef733742024-05-26 18:42:18 +02006278 char_u *line = ml_get(lnum);
zeertzjq2b09de92024-05-24 07:48:51 +02006279 colnr_T line_len = ml_get_len(lnum);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006280
6281 if (region_type == MLINE)
6282 {
zeertzjqc95e64f2024-05-20 14:00:31 +02006283 ret_p1.col = 1;
6284 ret_p1.coladd = 0;
6285 ret_p2.col = MAXCOL;
6286 ret_p2.coladd = 0;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006287 }
6288 else
6289 {
zeertzjq52a6f342024-05-22 16:42:44 +02006290 struct block_def bd;
6291
zeertzjqc95e64f2024-05-20 14:00:31 +02006292 if (region_type == MBLOCK)
6293 block_prep(&oa, &bd, lnum, FALSE);
6294 else
6295 charwise_block_prep(p1, p2, &bd, lnum, inclusive);
zeertzjq52a6f342024-05-22 16:42:44 +02006296
6297 if (bd.is_oneChar) // selection entirely inside one char
6298 {
6299 if (region_type == MBLOCK)
6300 {
zeertzjqef733742024-05-26 18:42:18 +02006301 ret_p1.col = mb_prevptr(line, bd.textstart) - line + 1;
zeertzjq52a6f342024-05-22 16:42:44 +02006302 ret_p1.coladd = bd.start_char_vcols
6303 - (bd.start_vcol - oa.start_vcol);
6304 }
6305 else
6306 {
6307 ret_p1.col = p1.col + 1;
6308 ret_p1.coladd = p1.coladd;
6309 }
6310 }
zeertzjq2b09de92024-05-24 07:48:51 +02006311 else if (region_type == MBLOCK && oa.start_vcol > bd.start_vcol)
6312 {
6313 // blockwise selection entirely beyond end of line
6314 ret_p1.col = MAXCOL;
6315 ret_p1.coladd = oa.start_vcol - bd.start_vcol;
6316 bd.is_oneChar = TRUE;
6317 }
zeertzjq52a6f342024-05-22 16:42:44 +02006318 else if (bd.startspaces > 0)
zeertzjqc95e64f2024-05-20 14:00:31 +02006319 {
zeertzjqef733742024-05-26 18:42:18 +02006320 ret_p1.col = mb_prevptr(line, bd.textstart) - line + 1;
zeertzjqc95e64f2024-05-20 14:00:31 +02006321 ret_p1.coladd = bd.start_char_vcols - bd.startspaces;
6322 }
6323 else
6324 {
6325 ret_p1.col = bd.textcol + 1;
6326 ret_p1.coladd = 0;
6327 }
zeertzjq52a6f342024-05-22 16:42:44 +02006328
6329 if (bd.is_oneChar) // selection entirely inside one char
6330 {
6331 ret_p2.col = ret_p1.col;
zeertzjq2b09de92024-05-24 07:48:51 +02006332 ret_p2.coladd = ret_p1.coladd + bd.startspaces + bd.endspaces;
zeertzjq52a6f342024-05-22 16:42:44 +02006333 }
6334 else if (bd.endspaces > 0)
zeertzjqc95e64f2024-05-20 14:00:31 +02006335 {
6336 ret_p2.col = bd.textcol + bd.textlen + 1;
6337 ret_p2.coladd = bd.endspaces;
6338 }
6339 else
6340 {
6341 ret_p2.col = bd.textcol + bd.textlen;
6342 ret_p2.coladd = 0;
6343 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006344 }
6345
zeertzjq2b09de92024-05-24 07:48:51 +02006346 if (!allow_eol && ret_p1.col > line_len)
6347 {
6348 ret_p1.col = 0;
6349 ret_p1.coladd = 0;
6350 }
6351 else if (ret_p1.col > line_len + 1)
6352 ret_p1.col = line_len + 1;
6353
6354 if (!allow_eol && ret_p2.col > line_len)
6355 {
6356 ret_p2.col = ret_p1.col == 0 ? 0 : line_len;
6357 ret_p2.coladd = 0;
6358 }
6359 else if (ret_p2.col > line_len + 1)
6360 ret_p2.col = line_len + 1;
6361
zeertzjqc95e64f2024-05-20 14:00:31 +02006362 ret_p1.lnum = lnum;
6363 ret_p2.lnum = lnum;
6364 add_regionpos_range(rettv, ret_p1, ret_p2);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006365 }
6366
6367 // getregionpos() may change curbuf and virtual_op
zeertzjq5406eb82024-03-11 21:36:42 +01006368 curbuf = save_curbuf;
6369 curwin->w_buffer = curbuf;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006370 virtual_op = save_virtual;
6371}
6372
6373/*
zeertzjqd3f00f52021-12-24 12:02:43 +00006374 * Common between getreg(), getreginfo() and getregtype(): get the register
6375 * name from the first argument.
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006376 * Returns zero on error.
6377 */
6378 static int
6379getreg_get_regname(typval_T *argvars)
6380{
6381 char_u *strregname;
6382
6383 if (argvars[0].v_type != VAR_UNKNOWN)
6384 {
6385 strregname = tv_get_string_chk(&argvars[0]);
6386 if (strregname != NULL && in_vim9script() && STRLEN(strregname) > 1)
6387 {
6388 semsg(_(e_register_name_must_be_one_char_str), strregname);
6389 strregname = NULL;
6390 }
6391 if (strregname == NULL) // type error; errmsg already given
6392 return 0;
6393 }
6394 else
6395 // Default to v:register
6396 strregname = get_vim_var_str(VV_REG);
6397
6398 return *strregname == 0 ? '"' : *strregname;
6399}
6400
6401/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006402 * "getreg()" function
6403 */
6404 static void
6405f_getreg(typval_T *argvars, typval_T *rettv)
6406{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006407 int regname;
6408 int arg2 = FALSE;
6409 int return_list = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006410
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02006411 if (in_vim9script()
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006412 && (check_for_opt_string_arg(argvars, 0) == FAIL
6413 || (argvars[0].v_type != VAR_UNKNOWN
6414 && (check_for_opt_bool_arg(argvars, 1) == FAIL
6415 || (argvars[1].v_type != VAR_UNKNOWN
6416 && check_for_opt_bool_arg(argvars, 2) == FAIL)))))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02006417 return;
6418
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006419 regname = getreg_get_regname(argvars);
6420 if (regname == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006421 return;
6422
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006423 if (argvars[0].v_type != VAR_UNKNOWN && argvars[1].v_type != VAR_UNKNOWN)
6424 {
6425 int error = FALSE;
6426
6427 arg2 = (int)tv_get_bool_chk(&argvars[1], &error);
6428
6429 if (!error && argvars[2].v_type != VAR_UNKNOWN)
6430 return_list = (int)tv_get_bool_chk(&argvars[2], &error);
6431 if (error)
6432 return;
6433 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006434
6435 if (return_list)
6436 {
6437 rettv->v_type = VAR_LIST;
6438 rettv->vval.v_list = (list_T *)get_reg_contents(regname,
6439 (arg2 ? GREG_EXPR_SRC : 0) | GREG_LIST);
6440 if (rettv->vval.v_list == NULL)
6441 (void)rettv_list_alloc(rettv);
6442 else
6443 ++rettv->vval.v_list->lv_refcount;
6444 }
6445 else
6446 {
6447 rettv->v_type = VAR_STRING;
6448 rettv->vval.v_string = get_reg_contents(regname,
6449 arg2 ? GREG_EXPR_SRC : 0);
6450 }
6451}
6452
6453/*
6454 * "getregtype()" function
6455 */
6456 static void
6457f_getregtype(typval_T *argvars, typval_T *rettv)
6458{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006459 int regname;
6460 char_u buf[NUMBUFLEN + 2];
6461 long reglen = 0;
6462
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006463 // on error return an empty string
6464 rettv->v_type = VAR_STRING;
6465 rettv->vval.v_string = NULL;
6466
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006467 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
6468 return;
6469
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006470 regname = getreg_get_regname(argvars);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006471 if (regname == 0)
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006472 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006473
6474 buf[0] = NUL;
6475 buf[1] = NUL;
6476 switch (get_reg_type(regname, &reglen))
6477 {
6478 case MLINE: buf[0] = 'V'; break;
6479 case MCHAR: buf[0] = 'v'; break;
6480 case MBLOCK:
6481 buf[0] = Ctrl_V;
6482 sprintf((char *)buf + 1, "%ld", reglen + 1);
6483 break;
6484 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006485 rettv->vval.v_string = vim_strsave(buf);
6486}
6487
Bram Moolenaarb5ae48e2016-08-12 22:23:25 +02006488/*
Bram Moolenaarf49cc602018-11-11 15:21:05 +01006489 * "gettagstack()" function
6490 */
6491 static void
6492f_gettagstack(typval_T *argvars, typval_T *rettv)
6493{
6494 win_T *wp = curwin; // default is current window
6495
Bram Moolenaar93a10962022-06-16 11:42:09 +01006496 if (rettv_dict_alloc(rettv) == FAIL)
Bram Moolenaarf49cc602018-11-11 15:21:05 +01006497 return;
6498
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006499 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
6500 return;
6501
Bram Moolenaarf49cc602018-11-11 15:21:05 +01006502 if (argvars[0].v_type != VAR_UNKNOWN)
6503 {
6504 wp = find_win_by_nr_or_id(&argvars[0]);
6505 if (wp == NULL)
6506 return;
6507 }
6508
6509 get_tagstack(wp, rettv->vval.v_dict);
6510}
6511
Bram Moolenaar0b39c3f2020-08-30 15:52:10 +02006512/*
6513 * "gettext()" function
6514 */
6515 static void
6516f_gettext(typval_T *argvars, typval_T *rettv)
6517{
Christ van Willegence0ef912024-06-20 23:41:59 +02006518#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
6519 char *prev = NULL;
6520#endif
6521
6522 if (check_for_nonempty_string_arg(argvars, 0) == FAIL
6523 || check_for_opt_string_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006524 return;
6525
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +01006526 rettv->v_type = VAR_STRING;
Christ van Willegence0ef912024-06-20 23:41:59 +02006527
6528 if (argvars[1].v_type == VAR_STRING &&
6529 argvars[1].vval.v_string != NULL &&
6530 *(argvars[1].vval.v_string) != NUL)
6531 {
6532#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
6533 prev = bind_textdomain_codeset((const char *)argvars[1].vval.v_string, (char *)p_enc);
6534#endif
6535
6536#if defined(HAVE_DGETTEXT)
6537 rettv->vval.v_string = vim_strsave((char_u *)dgettext((const char *)argvars[1].vval.v_string, (const char *)argvars[0].vval.v_string));
6538#else
6539 textdomain((const char *)argvars[1].vval.v_string);
6540 rettv->vval.v_string = vim_strsave((char_u *)_(argvars[0].vval.v_string));
6541 textdomain(VIMPACKAGE);
6542#endif
6543
6544#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
6545 if (prev != NULL)
6546 bind_textdomain_codeset((const char *)argvars[1].vval.v_string, prev);
6547#endif
6548 }
6549 else
6550 rettv->vval.v_string = vim_strsave((char_u *)_(argvars[0].vval.v_string));
Bram Moolenaar0b39c3f2020-08-30 15:52:10 +02006551}
6552
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01006553// for VIM_VERSION_ defines
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006554#include "version.h"
6555
6556/*
6557 * "has()" function
6558 */
Bram Moolenaara259d8d2020-01-31 20:10:50 +01006559 void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006560f_has(typval_T *argvars, typval_T *rettv)
6561{
6562 int i;
6563 char_u *name;
Bram Moolenaar79296512020-03-22 16:17:14 +01006564 int x = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006565 int n = FALSE;
Bram Moolenaar79296512020-03-22 16:17:14 +01006566 typedef struct {
6567 char *name;
6568 short present;
6569 } has_item_T;
6570 static has_item_T has_list[] =
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006571 {
Bram Moolenaar79296512020-03-22 16:17:14 +01006572 {"amiga",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006573#ifdef AMIGA
Bram Moolenaar79296512020-03-22 16:17:14 +01006574 1
Bram Moolenaar39536dd2019-01-29 22:58:21 +01006575#else
Bram Moolenaar79296512020-03-22 16:17:14 +01006576 0
Bram Moolenaar39536dd2019-01-29 22:58:21 +01006577#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006578 },
6579 {"arp",
6580#if defined(AMIGA) && defined(FEAT_ARP)
6581 1
6582#else
6583 0
6584#endif
6585 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006586 {"haiku",
6587#ifdef __HAIKU__
6588 1
6589#else
6590 0
6591#endif
6592 },
6593 {"bsd",
Zhaoming Luoa41dfcd2025-02-06 21:39:35 +01006594#if defined(BSD) && !defined(MACOS_X) && !defined(__GNU__)
Bram Moolenaar79296512020-03-22 16:17:14 +01006595 1
6596#else
6597 0
6598#endif
6599 },
6600 {"hpux",
6601#ifdef hpux
6602 1
6603#else
6604 0
6605#endif
6606 },
Zhaoming Luoa41dfcd2025-02-06 21:39:35 +01006607 {"hurd",
6608#ifdef __GNU__
6609 1
6610#else
6611 0
6612#endif
6613 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006614 {"linux",
6615#ifdef __linux__
6616 1
6617#else
6618 0
6619#endif
6620 },
6621 {"mac", // Mac OS X (and, once, Mac OS Classic)
6622#ifdef MACOS_X
6623 1
6624#else
6625 0
6626#endif
6627 },
6628 {"osx", // Mac OS X
6629#ifdef MACOS_X
6630 1
6631#else
6632 0
6633#endif
6634 },
6635 {"macunix", // Mac OS X, with the darwin feature
6636#if defined(MACOS_X) && defined(MACOS_X_DARWIN)
6637 1
6638#else
6639 0
6640#endif
6641 },
6642 {"osxdarwin", // synonym for macunix
6643#if defined(MACOS_X) && defined(MACOS_X_DARWIN)
6644 1
6645#else
6646 0
6647#endif
6648 },
6649 {"qnx",
6650#ifdef __QNX__
6651 1
6652#else
6653 0
6654#endif
6655 },
6656 {"sun",
6657#ifdef SUN_SYSTEM
6658 1
6659#else
6660 0
6661#endif
6662 },
6663 {"unix",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006664#ifdef UNIX
Bram Moolenaar79296512020-03-22 16:17:14 +01006665 1
6666#else
6667 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006668#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006669 },
6670 {"vms",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006671#ifdef VMS
Bram Moolenaar79296512020-03-22 16:17:14 +01006672 1
6673#else
6674 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006675#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006676 },
6677 {"win32",
Bram Moolenaar4f974752019-02-17 17:44:42 +01006678#ifdef MSWIN
Bram Moolenaar79296512020-03-22 16:17:14 +01006679 1
6680#else
6681 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006682#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006683 },
6684 {"win32unix",
K.Takata972db232022-02-04 10:45:38 +00006685#ifdef WIN32UNIX
Bram Moolenaar79296512020-03-22 16:17:14 +01006686 1
6687#else
6688 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006689#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006690 },
6691 {"win64",
Bram Moolenaar44b443c2019-02-18 22:14:18 +01006692#ifdef _WIN64
Bram Moolenaar79296512020-03-22 16:17:14 +01006693 1
6694#else
6695 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006696#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006697 },
Bram Moolenaar424bcae2022-01-31 14:59:41 +00006698 {"ebcdic", 0 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006699 {"fname_case",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006700#ifndef CASE_INSENSITIVE_FILENAME
Bram Moolenaar79296512020-03-22 16:17:14 +01006701 1
6702#else
6703 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006704#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006705 },
6706 {"acl",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006707#ifdef HAVE_ACL
Bram Moolenaar79296512020-03-22 16:17:14 +01006708 1
6709#else
6710 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006711#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006712 },
6713 {"arabic",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006714#ifdef FEAT_ARABIC
Bram Moolenaar79296512020-03-22 16:17:14 +01006715 1
6716#else
6717 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006718#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006719 },
6720 {"autocmd", 1},
6721 {"autochdir",
Bram Moolenaar83ec2a72018-07-27 22:08:59 +02006722#ifdef FEAT_AUTOCHDIR
Bram Moolenaar79296512020-03-22 16:17:14 +01006723 1
6724#else
6725 0
Bram Moolenaar83ec2a72018-07-27 22:08:59 +02006726#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006727 },
6728 {"autoservername",
Bram Moolenaare42a6d22017-11-12 19:21:51 +01006729#ifdef FEAT_AUTOSERVERNAME
Bram Moolenaar79296512020-03-22 16:17:14 +01006730 1
6731#else
6732 0
Bram Moolenaare42a6d22017-11-12 19:21:51 +01006733#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006734 },
6735 {"balloon_eval",
Bram Moolenaarc3719bd2017-11-18 22:13:31 +01006736#ifdef FEAT_BEVAL_GUI
Bram Moolenaar79296512020-03-22 16:17:14 +01006737 1
6738#else
6739 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006740#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006741 },
6742 {"balloon_multiline",
Bram Moolenaar0bd663a2022-01-22 10:24:47 +00006743#ifdef FEAT_BEVAL_GUI
Bram Moolenaar79296512020-03-22 16:17:14 +01006744 1
6745#else
6746 0
6747#endif
6748 },
6749 {"balloon_eval_term",
Bram Moolenaarc3719bd2017-11-18 22:13:31 +01006750#ifdef FEAT_BEVAL_TERM
Bram Moolenaar79296512020-03-22 16:17:14 +01006751 1
6752#else
6753 0
Bram Moolenaar51b0f372017-11-18 18:52:04 +01006754#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006755 },
Bram Moolenaar2ee347f2022-08-26 17:53:44 +01006756 {"builtin_terms", 1},
6757 {"all_builtin_terms", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006758 {"browsefilter",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006759#if defined(FEAT_BROWSE) && (defined(USE_FILE_CHOOSER) \
Bram Moolenaar4f974752019-02-17 17:44:42 +01006760 || defined(FEAT_GUI_MSWIN) \
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006761 || defined(FEAT_GUI_MOTIF))
Bram Moolenaar79296512020-03-22 16:17:14 +01006762 1
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006763#else
Bram Moolenaar79296512020-03-22 16:17:14 +01006764 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006765#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006766 },
6767 {"byte_offset",
6768#ifdef FEAT_BYTEOFF
6769 1
6770#else
6771 0
6772#endif
6773 },
6774 {"channel",
6775#ifdef FEAT_JOB_CHANNEL
6776 1
6777#else
6778 0
6779#endif
6780 },
Bram Moolenaar8e145b82022-05-21 20:17:31 +01006781 {"cindent", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006782 {"clientserver",
6783#ifdef FEAT_CLIENTSERVER
6784 1
6785#else
6786 0
6787#endif
6788 },
6789 {"clipboard",
6790#ifdef FEAT_CLIPBOARD
6791 1
6792#else
6793 0
6794#endif
6795 },
6796 {"cmdline_compl", 1},
6797 {"cmdline_hist", 1},
Martin Tournoij7904fa42022-10-04 16:28:45 +01006798 {"cmdwin", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006799 {"comments", 1},
6800 {"conceal",
6801#ifdef FEAT_CONCEAL
6802 1
6803#else
6804 0
6805#endif
6806 },
6807 {"cryptv",
6808#ifdef FEAT_CRYPT
6809 1
6810#else
6811 0
6812#endif
6813 },
6814 {"crypt-blowfish",
6815#ifdef FEAT_CRYPT
6816 1
6817#else
6818 0
6819#endif
6820 },
6821 {"crypt-blowfish2",
6822#ifdef FEAT_CRYPT
6823 1
6824#else
6825 0
6826#endif
6827 },
6828 {"cscope",
6829#ifdef FEAT_CSCOPE
6830 1
6831#else
6832 0
6833#endif
6834 },
6835 {"cursorbind", 1},
6836 {"cursorshape",
6837#ifdef CURSOR_SHAPE
6838 1
6839#else
6840 0
6841#endif
6842 },
6843 {"debug",
6844#ifdef DEBUG
6845 1
6846#else
6847 0
6848#endif
6849 },
6850 {"dialog_con",
6851#ifdef FEAT_CON_DIALOG
6852 1
6853#else
6854 0
6855#endif
6856 },
glepnirdf461152024-04-04 22:23:29 +02006857 {"dialog_con_gui",
6858#if defined(FEAT_CON_DIALOG) && defined(FEAT_GUI_DIALOG)
6859 1
6860#else
6861 0
6862#endif
6863 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006864 {"dialog_gui",
6865#ifdef FEAT_GUI_DIALOG
6866 1
6867#else
6868 0
6869#endif
6870 },
6871 {"diff",
6872#ifdef FEAT_DIFF
6873 1
6874#else
6875 0
6876#endif
6877 },
6878 {"digraphs",
6879#ifdef FEAT_DIGRAPHS
6880 1
6881#else
6882 0
6883#endif
6884 },
6885 {"directx",
6886#ifdef FEAT_DIRECTX
6887 1
6888#else
6889 0
6890#endif
6891 },
6892 {"dnd",
6893#ifdef FEAT_DND
6894 1
6895#else
6896 0
6897#endif
6898 },
Bram Moolenaar1d1ce612021-06-27 19:02:52 +02006899 {"drop_file",
6900#ifdef HAVE_DROP_FILE
6901 1
6902#else
6903 0
6904#endif
6905 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006906 {"emacs_tags",
6907#ifdef FEAT_EMACS_TAGS
6908 1
6909#else
6910 0
6911#endif
6912 },
6913 {"eval", 1}, // always present, of course!
6914 {"ex_extra", 1}, // graduated feature
6915 {"extra_search",
6916#ifdef FEAT_SEARCH_EXTRA
6917 1
6918#else
6919 0
6920#endif
6921 },
Bram Moolenaarf80f40a2022-08-25 16:02:23 +01006922 {"file_in_path", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006923 {"filterpipe",
6924#if defined(FEAT_FILTERPIPE) && !defined(VIMDLL)
6925 1
6926#else
6927 0
6928#endif
6929 },
6930 {"find_in_path",
6931#ifdef FEAT_FIND_ID
6932 1
6933#else
6934 0
6935#endif
6936 },
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01006937 {"float", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006938 {"folding",
6939#ifdef FEAT_FOLDING
6940 1
6941#else
6942 0
6943#endif
6944 },
Bram Moolenaarc8ac3a02022-09-04 12:29:28 +01006945 {"footer", 0},
Bram Moolenaar79296512020-03-22 16:17:14 +01006946 {"fork",
6947#if !defined(USE_SYSTEM) && defined(UNIX)
6948 1
6949#else
6950 0
6951#endif
6952 },
6953 {"gettext",
6954#ifdef FEAT_GETTEXT
6955 1
6956#else
6957 0
6958#endif
6959 },
6960 {"gui",
6961#ifdef FEAT_GUI
6962 1
6963#else
6964 0
6965#endif
6966 },
Bram Moolenaar0b962e52022-04-03 18:02:37 +01006967 {"gui_neXtaw", 0 },
6968 {"gui_athena", 0 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006969 {"gui_gtk",
6970#ifdef FEAT_GUI_GTK
6971 1
6972#else
6973 0
6974#endif
6975 },
6976 {"gui_gtk2",
6977#if defined(FEAT_GUI_GTK) && !defined(USE_GTK3)
6978 1
6979#else
6980 0
6981#endif
6982 },
6983 {"gui_gtk3",
6984#if defined(FEAT_GUI_GTK) && defined(USE_GTK3)
6985 1
6986#else
6987 0
6988#endif
6989 },
6990 {"gui_gnome",
6991#ifdef FEAT_GUI_GNOME
6992 1
6993#else
6994 0
6995#endif
6996 },
6997 {"gui_haiku",
6998#ifdef FEAT_GUI_HAIKU
6999 1
7000#else
7001 0
7002#endif
7003 },
Bram Moolenaar097148e2020-08-11 21:58:20 +02007004 {"gui_mac", 0},
Bram Moolenaar79296512020-03-22 16:17:14 +01007005 {"gui_motif",
7006#ifdef FEAT_GUI_MOTIF
7007 1
7008#else
7009 0
7010#endif
7011 },
7012 {"gui_photon",
7013#ifdef FEAT_GUI_PHOTON
7014 1
7015#else
7016 0
7017#endif
7018 },
7019 {"gui_win32",
7020#ifdef FEAT_GUI_MSWIN
7021 1
7022#else
7023 0
7024#endif
7025 },
7026 {"iconv",
7027#if defined(HAVE_ICONV_H) && defined(USE_ICONV)
7028 1
7029#else
7030 0
7031#endif
7032 },
7033 {"insert_expand", 1},
Bram Moolenaarbfe13cc2020-04-12 17:53:12 +02007034 {"ipv6",
7035#ifdef FEAT_IPV6
7036 1
7037#else
7038 0
7039#endif
7040 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007041 {"job",
7042#ifdef FEAT_JOB_CHANNEL
7043 1
7044#else
7045 0
7046#endif
7047 },
Bram Moolenaar739f13a2021-12-13 13:12:53 +00007048 {"jumplist", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007049 {"keymap",
7050#ifdef FEAT_KEYMAP
7051 1
7052#else
7053 0
7054#endif
7055 },
7056 {"lambda", 1}, // always with FEAT_EVAL, since 7.4.2120 with closure
7057 {"langmap",
7058#ifdef FEAT_LANGMAP
7059 1
7060#else
7061 0
7062#endif
7063 },
7064 {"libcall",
7065#ifdef FEAT_LIBCALL
7066 1
7067#else
7068 0
7069#endif
7070 },
7071 {"linebreak",
7072#ifdef FEAT_LINEBREAK
7073 1
7074#else
7075 0
7076#endif
7077 },
Bram Moolenaar8e145b82022-05-21 20:17:31 +01007078 {"lispindent", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007079 {"listcmds", 1},
7080 {"localmap", 1},
7081 {"lua",
7082#if defined(FEAT_LUA) && !defined(DYNAMIC_LUA)
7083 1
7084#else
7085 0
7086#endif
7087 },
7088 {"menu",
7089#ifdef FEAT_MENU
7090 1
7091#else
7092 0
7093#endif
7094 },
7095 {"mksession",
7096#ifdef FEAT_SESSION
7097 1
7098#else
7099 0
7100#endif
7101 },
7102 {"modify_fname", 1},
7103 {"mouse", 1},
7104 {"mouseshape",
7105#ifdef FEAT_MOUSESHAPE
7106 1
7107#else
7108 0
7109#endif
7110 },
7111 {"mouse_dec",
7112#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_DEC)
7113 1
7114#else
7115 0
7116#endif
7117 },
7118 {"mouse_gpm",
Bram Moolenaar33fc4a62022-02-23 18:07:38 +00007119#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_GPM) && !defined(DYNAMIC_GPM)
Bram Moolenaar79296512020-03-22 16:17:14 +01007120 1
7121#else
7122 0
7123#endif
7124 },
7125 {"mouse_jsbterm",
7126#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_JSB)
7127 1
7128#else
7129 0
7130#endif
7131 },
7132 {"mouse_netterm",
7133#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_NET)
7134 1
7135#else
7136 0
7137#endif
7138 },
7139 {"mouse_pterm",
7140#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_PTERM)
7141 1
7142#else
7143 0
7144#endif
7145 },
7146 {"mouse_sgr",
7147#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_XTERM)
7148 1
7149#else
7150 0
7151#endif
7152 },
7153 {"mouse_sysmouse",
7154#if (defined(UNIX) || defined(VMS)) && defined(FEAT_SYSMOUSE)
7155 1
7156#else
7157 0
7158#endif
7159 },
7160 {"mouse_urxvt",
7161#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_URXVT)
7162 1
7163#else
7164 0
7165#endif
7166 },
7167 {"mouse_xterm",
7168#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_XTERM)
7169 1
7170#else
7171 0
7172#endif
7173 },
7174 {"multi_byte", 1},
7175 {"multi_byte_ime",
7176#ifdef FEAT_MBYTE_IME
7177 1
7178#else
7179 0
7180#endif
7181 },
7182 {"multi_lang",
7183#ifdef FEAT_MULTI_LANG
7184 1
7185#else
7186 0
7187#endif
7188 },
7189 {"mzscheme",
7190#if defined(FEAT_MZSCHEME) && !defined(DYNAMIC_MZSCHEME)
7191 1
7192#else
7193 0
7194#endif
7195 },
Leah Neukirchen0a7984a2021-10-14 21:27:55 +01007196 {"nanotime",
7197#ifdef ST_MTIM_NSEC
7198 1
7199#else
7200 0
7201#endif
7202 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007203 {"num64", 1},
7204 {"ole",
7205#ifdef FEAT_OLE
7206 1
7207#else
7208 0
7209#endif
7210 },
7211 {"packages",
7212#ifdef FEAT_EVAL
7213 1
7214#else
7215 0
7216#endif
7217 },
Bram Moolenaar2bd9dbc2022-08-25 18:12:06 +01007218 {"path_extra", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007219 {"perl",
7220#if defined(FEAT_PERL) && !defined(DYNAMIC_PERL)
7221 1
7222#else
7223 0
7224#endif
7225 },
7226 {"persistent_undo",
7227#ifdef FEAT_PERSISTENT_UNDO
7228 1
7229#else
7230 0
7231#endif
7232 },
7233 {"python_compiled",
7234#if defined(FEAT_PYTHON)
7235 1
7236#else
7237 0
7238#endif
7239 },
7240 {"python_dynamic",
7241#if defined(FEAT_PYTHON) && defined(DYNAMIC_PYTHON)
7242 1
7243#else
7244 0
7245#endif
7246 },
7247 {"python",
7248#if defined(FEAT_PYTHON) && !defined(DYNAMIC_PYTHON)
7249 1
7250#else
7251 0
7252#endif
7253 },
7254 {"pythonx",
7255#if (defined(FEAT_PYTHON) && !defined(DYNAMIC_PYTHON)) \
7256 || (defined(FEAT_PYTHON3) && !defined(DYNAMIC_PYTHON3))
7257 1
7258#else
7259 0
7260#endif
7261 },
7262 {"python3_compiled",
7263#if defined(FEAT_PYTHON3)
7264 1
7265#else
7266 0
7267#endif
7268 },
7269 {"python3_dynamic",
7270#if defined(FEAT_PYTHON3) && defined(DYNAMIC_PYTHON3)
7271 1
7272#else
7273 0
7274#endif
7275 },
Yee Cheng Chinc13b3d12023-08-20 21:18:38 +02007276 {"python3_stable",
7277#if defined(FEAT_PYTHON3) && defined(DYNAMIC_PYTHON3_STABLE_ABI)
7278 1
7279#else
7280 0
7281#endif
7282 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007283 {"python3",
7284#if defined(FEAT_PYTHON3) && !defined(DYNAMIC_PYTHON3)
7285 1
7286#else
7287 0
7288#endif
7289 },
7290 {"popupwin",
7291#ifdef FEAT_PROP_POPUP
7292 1
7293#else
7294 0
7295#endif
7296 },
7297 {"postscript",
7298#ifdef FEAT_POSTSCRIPT
7299 1
7300#else
7301 0
7302#endif
7303 },
7304 {"printer",
7305#ifdef FEAT_PRINTER
7306 1
7307#else
7308 0
7309#endif
7310 },
7311 {"profile",
7312#ifdef FEAT_PROFILE
7313 1
7314#else
7315 0
7316#endif
7317 },
Ernie Rael076de792023-03-16 21:43:15 +00007318 {"prof_nsec",
Bram Moolenaar08210f82023-04-13 19:15:54 +01007319#ifdef PROF_NSEC
Ernie Rael076de792023-03-16 21:43:15 +00007320 1
7321#else
7322 0
7323#endif
7324 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007325 {"reltime",
7326#ifdef FEAT_RELTIME
7327 1
7328#else
7329 0
7330#endif
7331 },
7332 {"quickfix",
7333#ifdef FEAT_QUICKFIX
7334 1
7335#else
7336 0
7337#endif
7338 },
7339 {"rightleft",
7340#ifdef FEAT_RIGHTLEFT
7341 1
7342#else
7343 0
7344#endif
7345 },
7346 {"ruby",
7347#if defined(FEAT_RUBY) && !defined(DYNAMIC_RUBY)
7348 1
7349#else
7350 0
7351#endif
7352 },
7353 {"scrollbind", 1},
Martin Tournoijba43e762022-10-13 22:12:15 +01007354 {"showcmd", 1},
7355 {"cmdline_info", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007356 {"signs",
7357#ifdef FEAT_SIGNS
7358 1
7359#else
7360 0
7361#endif
7362 },
Bram Moolenaar8e145b82022-05-21 20:17:31 +01007363 {"smartindent", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007364 {"startuptime",
7365#ifdef STARTUPTIME
7366 1
7367#else
7368 0
7369#endif
7370 },
7371 {"statusline",
7372#ifdef FEAT_STL_OPT
7373 1
7374#else
7375 0
7376#endif
7377 },
7378 {"netbeans_intg",
7379#ifdef FEAT_NETBEANS_INTG
7380 1
7381#else
7382 0
7383#endif
7384 },
Christian Brabandtf573c6e2021-06-20 14:02:16 +02007385 {"sodium",
K.Takatad68b2fc2022-02-12 11:18:37 +00007386#if defined(FEAT_SODIUM) && !defined(DYNAMIC_SODIUM)
Christian Brabandtf573c6e2021-06-20 14:02:16 +02007387 1
7388#else
7389 0
7390#endif
7391 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007392 {"sound",
7393#ifdef FEAT_SOUND
7394 1
7395#else
7396 0
7397#endif
7398 },
7399 {"spell",
7400#ifdef FEAT_SPELL
7401 1
7402#else
7403 0
7404#endif
7405 },
7406 {"syntax",
7407#ifdef FEAT_SYN_HL
7408 1
7409#else
7410 0
7411#endif
7412 },
7413 {"system",
7414#if defined(USE_SYSTEM) || !defined(UNIX)
7415 1
7416#else
7417 0
7418#endif
7419 },
Naruhiko Nishinobe5bd4d2025-05-14 21:20:28 +02007420 {"tabpanel",
7421#if defined(FEAT_TABPANEL)
7422 1,
7423#else
7424 0,
7425#endif
7426 },
Yegappan Lakshmanan655b7342022-03-06 14:27:10 +00007427 {"tag_binary", 1}, // graduated feature
Bram Moolenaar79296512020-03-22 16:17:14 +01007428 {"tcl",
7429#if defined(FEAT_TCL) && !defined(DYNAMIC_TCL)
7430 1
7431#else
7432 0
7433#endif
7434 },
7435 {"termguicolors",
7436#ifdef FEAT_TERMGUICOLORS
7437 1
7438#else
7439 0
7440#endif
7441 },
7442 {"terminal",
7443#if defined(FEAT_TERMINAL) && !defined(MSWIN)
7444 1
7445#else
7446 0
7447#endif
7448 },
7449 {"terminfo",
7450#ifdef TERMINFO
7451 1
7452#else
7453 0
7454#endif
7455 },
7456 {"termresponse",
7457#ifdef FEAT_TERMRESPONSE
7458 1
7459#else
7460 0
7461#endif
7462 },
Bram Moolenaar88774872022-08-16 20:24:29 +01007463 {"textobjects", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007464 {"textprop",
7465#ifdef FEAT_PROP_POPUP
7466 1
7467#else
7468 0
7469#endif
7470 },
7471 {"tgetent",
7472#ifdef HAVE_TGETENT
7473 1
7474#else
7475 0
7476#endif
7477 },
7478 {"timers",
7479#ifdef FEAT_TIMERS
7480 1
7481#else
7482 0
7483#endif
7484 },
Bram Moolenaar651fca82021-11-29 20:39:38 +00007485 {"title", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007486 {"toolbar",
7487#ifdef FEAT_TOOLBAR
7488 1
7489#else
7490 0
7491#endif
7492 },
7493 {"unnamedplus",
Foxe Chenb90c2392025-06-27 21:10:35 +02007494#if defined(FEAT_CLIPBOARD) && (defined(FEAT_X11) \
7495 || defined(FEAT_WAYLAND_CLIPBOARD))
Bram Moolenaar79296512020-03-22 16:17:14 +01007496 1
7497#else
7498 0
7499#endif
7500 },
7501 {"user-commands", 1}, // was accidentally included in 5.4
7502 {"user_commands", 1},
7503 {"vartabs",
7504#ifdef FEAT_VARTABS
7505 1
7506#else
7507 0
7508#endif
7509 },
7510 {"vertsplit", 1},
7511 {"viminfo",
7512#ifdef FEAT_VIMINFO
7513 1
7514#else
7515 0
7516#endif
7517 },
Bram Moolenaarb79ee0c2022-01-01 12:17:00 +00007518 {"vim9script", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007519 {"vimscript-1", 1},
7520 {"vimscript-2", 1},
7521 {"vimscript-3", 1},
7522 {"vimscript-4", 1},
7523 {"virtualedit", 1},
7524 {"visual", 1},
7525 {"visualextra", 1},
7526 {"vreplace", 1},
7527 {"vtp",
7528#ifdef FEAT_VTP
7529 1
7530#else
7531 0
7532#endif
7533 },
Foxe Chenb90c2392025-06-27 21:10:35 +02007534 {"wayland",
7535#ifdef FEAT_WAYLAND
7536 1
7537#else
7538 0
7539#endif
7540 },
7541 {"wayland_clipboard",
7542#ifdef FEAT_WAYLAND_CLIPBOARD
7543 1
7544#else
7545 0
7546#endif
7547 },
Bram Moolenaar074fbd42022-08-26 16:41:14 +01007548 {"wildignore", 1},
Bram Moolenaar54162322022-08-26 16:58:51 +01007549 {"wildmenu", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007550 {"windows", 1},
7551 {"winaltkeys",
7552#ifdef FEAT_WAK
7553 1
7554#else
7555 0
7556#endif
7557 },
7558 {"writebackup",
7559#ifdef FEAT_WRITEBACKUP
7560 1
7561#else
7562 0
7563#endif
7564 },
Christian Brabandte085dfd2023-09-30 12:49:18 +02007565 {"xattr",
7566#ifdef FEAT_XATTR
7567 1
7568#else
7569 0
7570#endif
7571 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007572 {"xim",
7573#ifdef FEAT_XIM
7574 1
7575#else
7576 0
7577#endif
7578 },
7579 {"xfontset",
7580#ifdef FEAT_XFONTSET
7581 1
7582#else
7583 0
7584#endif
7585 },
7586 {"xpm",
7587#if defined(FEAT_XPM_W32) || defined(HAVE_XPM)
7588 1
7589#else
7590 0
7591#endif
7592 },
7593 {"xpm_w32", // for backward compatibility
7594#ifdef FEAT_XPM_W32
7595 1
7596#else
7597 0
7598#endif
7599 },
7600 {"xsmp",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007601#ifdef USE_XSMP
Bram Moolenaar79296512020-03-22 16:17:14 +01007602 1
7603#else
7604 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007605#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007606 },
7607 {"xsmp_interact",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007608#ifdef USE_XSMP_INTERACT
Bram Moolenaar79296512020-03-22 16:17:14 +01007609 1
7610#else
7611 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007612#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007613 },
7614 {"xterm_clipboard",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007615#ifdef FEAT_XCLIPBOARD
Bram Moolenaar79296512020-03-22 16:17:14 +01007616 1
7617#else
7618 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007619#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007620 },
7621 {"xterm_save",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007622#ifdef FEAT_XTERM_SAVE
Bram Moolenaar79296512020-03-22 16:17:14 +01007623 1
7624#else
7625 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007626#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007627 },
7628 {"X11",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007629#if defined(UNIX) && defined(FEAT_X11)
Bram Moolenaar79296512020-03-22 16:17:14 +01007630 1
7631#else
7632 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007633#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007634 },
Bram Moolenaar80adaa82023-07-07 18:57:40 +01007635 {":tearoff",
7636// same #ifdef as used for ex_tearoff().
7637#if defined(FEAT_GUI_MSWIN) && defined(FEAT_MENU) && defined(FEAT_TEAROFF)
7638 1
7639#else
7640 0
7641#endif
7642 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007643 {NULL, 0}
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007644 };
7645
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02007646 if (in_vim9script()
7647 && (check_for_string_arg(argvars, 0) == FAIL
7648 || check_for_opt_bool_arg(argvars, 1) == FAIL))
7649 return;
7650
Bram Moolenaard155d7a2018-12-21 16:04:21 +01007651 name = tv_get_string(&argvars[0]);
Bram Moolenaar79296512020-03-22 16:17:14 +01007652 for (i = 0; has_list[i].name != NULL; ++i)
7653 if (STRICMP(name, has_list[i].name) == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007654 {
Bram Moolenaar79296512020-03-22 16:17:14 +01007655 x = TRUE;
7656 n = has_list[i].present;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007657 break;
7658 }
7659
Bram Moolenaar79296512020-03-22 16:17:14 +01007660 // features also in has_list[] but sometimes enabled at runtime
7661 if (x == TRUE && n == FALSE)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007662 {
Bram Moolenaar79296512020-03-22 16:17:14 +01007663 if (0)
Bram Moolenaar86b9a3e2020-04-07 19:57:29 +02007664 {
7665 // intentionally empty
7666 }
Bram Moolenaar79296512020-03-22 16:17:14 +01007667#ifdef VIMDLL
7668 else if (STRICMP(name, "filterpipe") == 0)
7669 n = gui.in_use || gui.starting;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007670#endif
7671#if defined(USE_ICONV) && defined(DYNAMIC_ICONV)
7672 else if (STRICMP(name, "iconv") == 0)
7673 n = iconv_enabled(FALSE);
7674#endif
7675#ifdef DYNAMIC_LUA
7676 else if (STRICMP(name, "lua") == 0)
7677 n = lua_enabled(FALSE);
7678#endif
7679#ifdef DYNAMIC_MZSCHEME
7680 else if (STRICMP(name, "mzscheme") == 0)
7681 n = mzscheme_enabled(FALSE);
7682#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007683#ifdef DYNAMIC_PERL
7684 else if (STRICMP(name, "perl") == 0)
7685 n = perl_enabled(FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007686#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007687#ifdef DYNAMIC_PYTHON
7688 else if (STRICMP(name, "python") == 0)
7689 n = python_enabled(FALSE);
7690#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007691#ifdef DYNAMIC_PYTHON3
7692 else if (STRICMP(name, "python3") == 0)
7693 n = python3_enabled(FALSE);
7694#endif
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01007695#if defined(DYNAMIC_PYTHON) || defined(DYNAMIC_PYTHON3)
7696 else if (STRICMP(name, "pythonx") == 0)
7697 {
7698# if defined(DYNAMIC_PYTHON) && defined(DYNAMIC_PYTHON3)
7699 if (p_pyx == 0)
7700 n = python3_enabled(FALSE) || python_enabled(FALSE);
7701 else if (p_pyx == 3)
7702 n = python3_enabled(FALSE);
7703 else if (p_pyx == 2)
7704 n = python_enabled(FALSE);
7705# elif defined(DYNAMIC_PYTHON)
7706 n = python_enabled(FALSE);
7707# elif defined(DYNAMIC_PYTHON3)
7708 n = python3_enabled(FALSE);
7709# endif
7710 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007711#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007712#ifdef DYNAMIC_RUBY
7713 else if (STRICMP(name, "ruby") == 0)
7714 n = ruby_enabled(FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007715#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007716#ifdef DYNAMIC_TCL
7717 else if (STRICMP(name, "tcl") == 0)
7718 n = tcl_enabled(FALSE);
Bram Moolenaar4b8366b2019-05-04 17:34:34 +02007719#endif
K.Takatad68b2fc2022-02-12 11:18:37 +00007720#ifdef DYNAMIC_SODIUM
7721 else if (STRICMP(name, "sodium") == 0)
7722 n = sodium_enabled(FALSE);
7723#endif
Bram Moolenaar4f974752019-02-17 17:44:42 +01007724#if defined(FEAT_TERMINAL) && defined(MSWIN)
Bram Moolenaara83e3962017-08-17 14:39:07 +02007725 else if (STRICMP(name, "terminal") == 0)
7726 n = terminal_enabled();
7727#endif
Bram Moolenaar33fc4a62022-02-23 18:07:38 +00007728#ifdef DYNAMIC_GPM
7729 else if (STRICMP(name, "mouse_gpm") == 0)
7730 n = gpm_available();
7731#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007732 }
7733
Bram Moolenaar79296512020-03-22 16:17:14 +01007734 // features not in has_list[]
7735 if (x == FALSE)
7736 {
7737 if (STRNICMP(name, "patch", 5) == 0)
7738 {
7739 x = TRUE;
7740 if (name[5] == '-'
7741 && STRLEN(name) >= 11
K.Takatad90f91f2022-07-30 15:43:59 +01007742 && (name[6] >= '1' && name[6] <= '9'))
Bram Moolenaar79296512020-03-22 16:17:14 +01007743 {
K.Takatad90f91f2022-07-30 15:43:59 +01007744 char *end;
7745 int major, minor;
Bram Moolenaar79296512020-03-22 16:17:14 +01007746
K.Takatad90f91f2022-07-30 15:43:59 +01007747 // This works for patch-8.1.2, patch-9.0.3, patch-10.0.4, etc.
7748 // Not for patch-9.10.5.
7749 major = (int)strtoul((char *)name + 6, &end, 10);
7750 if (*end == '.' && vim_isdigit(end[1])
7751 && end[2] == '.' && vim_isdigit(end[3]))
7752 {
7753 minor = atoi(end + 1);
7754
7755 // Expect "patch-9.9.01234".
7756 n = (major < VIM_VERSION_MAJOR
7757 || (major == VIM_VERSION_MAJOR
7758 && (minor < VIM_VERSION_MINOR
7759 || (minor == VIM_VERSION_MINOR
7760 && has_patch(atoi(end + 3))))));
7761 }
Bram Moolenaar79296512020-03-22 16:17:14 +01007762 }
Keith Thompson184f71c2024-01-04 21:19:04 +01007763 else if (SAFE_isdigit(name[5]))
Bram Moolenaar79296512020-03-22 16:17:14 +01007764 n = has_patch(atoi((char *)name + 5));
7765 }
7766 else if (STRICMP(name, "vim_starting") == 0)
7767 {
7768 x = TRUE;
7769 n = (starting != 0);
7770 }
7771 else if (STRICMP(name, "ttyin") == 0)
7772 {
7773 x = TRUE;
7774 n = mch_input_isatty();
7775 }
7776 else if (STRICMP(name, "ttyout") == 0)
7777 {
7778 x = TRUE;
7779 n = stdout_isatty;
7780 }
7781 else if (STRICMP(name, "multi_byte_encoding") == 0)
7782 {
7783 x = TRUE;
7784 n = has_mbyte;
7785 }
7786 else if (STRICMP(name, "gui_running") == 0)
7787 {
7788 x = TRUE;
7789#ifdef FEAT_GUI
7790 n = (gui.in_use || gui.starting);
7791#endif
7792 }
7793 else if (STRICMP(name, "browse") == 0)
7794 {
7795 x = TRUE;
7796#if defined(FEAT_GUI) && defined(FEAT_BROWSE)
7797 n = gui.in_use; // gui_mch_browse() works when GUI is running
7798#endif
7799 }
7800 else if (STRICMP(name, "syntax_items") == 0)
7801 {
7802 x = TRUE;
7803#ifdef FEAT_SYN_HL
7804 n = syntax_present(curwin);
7805#endif
7806 }
7807 else if (STRICMP(name, "vcon") == 0)
7808 {
7809 x = TRUE;
7810#ifdef FEAT_VTP
7811 n = is_term_win32() && has_vtp_working();
7812#endif
7813 }
7814 else if (STRICMP(name, "netbeans_enabled") == 0)
7815 {
7816 x = TRUE;
7817#ifdef FEAT_NETBEANS_INTG
7818 n = netbeans_active();
7819#endif
7820 }
7821 else if (STRICMP(name, "mouse_gpm_enabled") == 0)
7822 {
7823 x = TRUE;
7824#ifdef FEAT_MOUSE_GPM
7825 n = gpm_enabled();
7826#endif
7827 }
7828 else if (STRICMP(name, "conpty") == 0)
7829 {
7830 x = TRUE;
7831#if defined(FEAT_TERMINAL) && defined(MSWIN)
7832 n = use_conpty();
7833#endif
7834 }
7835 else if (STRICMP(name, "clipboard_working") == 0)
7836 {
7837 x = TRUE;
7838#ifdef FEAT_CLIPBOARD
7839 n = clip_star.available;
7840#endif
7841 }
7842 }
7843
Bram Moolenaar04637e22020-09-05 18:45:29 +02007844 if (argvars[1].v_type != VAR_UNKNOWN && tv_get_bool(&argvars[1]))
Bram Moolenaar79296512020-03-22 16:17:14 +01007845 // return whether feature could ever be enabled
7846 rettv->vval.v_number = x;
7847 else
7848 // return whether feature is enabled
7849 rettv->vval.v_number = n;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007850}
7851
7852/*
Bram Moolenaar8cebd432020-11-08 12:49:47 +01007853 * Return TRUE if "feature" can change later.
7854 * Also when checking for the feature has side effects, such as loading a DLL.
7855 */
7856 int
7857dynamic_feature(char_u *feature)
7858{
7859 return (feature == NULL
Bram Moolenaar8cebd432020-11-08 12:49:47 +01007860#if defined(FEAT_GUI) && defined(FEAT_BROWSE)
7861 || (STRICMP(feature, "browse") == 0 && !gui.in_use)
7862#endif
7863#ifdef VIMDLL
7864 || STRICMP(feature, "filterpipe") == 0
7865#endif
Bram Moolenaar29b281b2020-11-10 20:58:00 +01007866#if defined(FEAT_GUI) && !defined(ALWAYS_USE_GUI) && !defined(VIMDLL)
Bram Moolenaar8cebd432020-11-08 12:49:47 +01007867 // this can only change on Unix where the ":gui" command could be
7868 // used.
7869 || (STRICMP(feature, "gui_running") == 0 && !gui.in_use)
7870#endif
7871#if defined(USE_ICONV) && defined(DYNAMIC_ICONV)
7872 || STRICMP(feature, "iconv") == 0
7873#endif
7874#ifdef DYNAMIC_LUA
7875 || STRICMP(feature, "lua") == 0
7876#endif
7877#ifdef FEAT_MOUSE_GPM
7878 || (STRICMP(feature, "mouse_gpm_enabled") == 0 && !gpm_enabled())
7879#endif
7880#ifdef DYNAMIC_MZSCHEME
7881 || STRICMP(feature, "mzscheme") == 0
7882#endif
7883#ifdef FEAT_NETBEANS_INTG
7884 || STRICMP(feature, "netbeans_enabled") == 0
7885#endif
7886#ifdef DYNAMIC_PERL
7887 || STRICMP(feature, "perl") == 0
7888#endif
7889#ifdef DYNAMIC_PYTHON
7890 || STRICMP(feature, "python") == 0
7891#endif
7892#ifdef DYNAMIC_PYTHON3
7893 || STRICMP(feature, "python3") == 0
7894#endif
7895#if defined(DYNAMIC_PYTHON) || defined(DYNAMIC_PYTHON3)
7896 || STRICMP(feature, "pythonx") == 0
7897#endif
7898#ifdef DYNAMIC_RUBY
7899 || STRICMP(feature, "ruby") == 0
7900#endif
7901#ifdef FEAT_SYN_HL
7902 || STRICMP(feature, "syntax_items") == 0
7903#endif
7904#ifdef DYNAMIC_TCL
7905 || STRICMP(feature, "tcl") == 0
7906#endif
7907 // once "starting" is zero it will stay that way
7908 || (STRICMP(feature, "vim_starting") == 0 && starting != 0)
7909 || STRICMP(feature, "multi_byte_encoding") == 0
7910#if defined(FEAT_TERMINAL) && defined(MSWIN)
7911 || STRICMP(feature, "conpty") == 0
7912#endif
7913 );
7914}
7915
7916/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007917 * "haslocaldir()" function
7918 */
7919 static void
7920f_haslocaldir(typval_T *argvars, typval_T *rettv)
7921{
Bram Moolenaar00aa0692019-04-27 20:37:57 +02007922 tabpage_T *tp = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007923 win_T *wp = NULL;
7924
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02007925 if (in_vim9script()
7926 && (check_for_opt_number_arg(argvars, 0) == FAIL
7927 || (argvars[0].v_type != VAR_UNKNOWN
7928 && check_for_opt_number_arg(argvars, 1) == FAIL)))
7929 return;
7930
Bram Moolenaar00aa0692019-04-27 20:37:57 +02007931 wp = find_tabwin(&argvars[0], &argvars[1], &tp);
7932
7933 // Check for window-local and tab-local directories
7934 if (wp != NULL && wp->w_localdir != NULL)
7935 rettv->vval.v_number = 1;
7936 else if (tp != NULL && tp->tp_localdir != NULL)
7937 rettv->vval.v_number = 2;
7938 else
7939 rettv->vval.v_number = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007940}
7941
7942/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007943 * "highlightID(name)" function
7944 */
7945 static void
7946f_hlID(typval_T *argvars, typval_T *rettv)
7947{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02007948 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
7949 return;
7950
Bram Moolenaard155d7a2018-12-21 16:04:21 +01007951 rettv->vval.v_number = syn_name2id(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007952}
7953
7954/*
7955 * "highlight_exists()" function
7956 */
7957 static void
7958f_hlexists(typval_T *argvars, typval_T *rettv)
7959{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02007960 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
7961 return;
7962
Bram Moolenaard155d7a2018-12-21 16:04:21 +01007963 rettv->vval.v_number = highlight_exists(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007964}
7965
7966/*
7967 * "hostname()" function
7968 */
7969 static void
7970f_hostname(typval_T *argvars UNUSED, typval_T *rettv)
7971{
7972 char_u hostname[256];
7973
7974 mch_get_host_name(hostname, 256);
7975 rettv->v_type = VAR_STRING;
7976 rettv->vval.v_string = vim_strsave(hostname);
7977}
7978
7979/*
Ernie Raelc8e158b2024-07-09 18:39:52 +02007980 * "id()" function
7981 * Identity. Return address of item as a hex string, %p format.
7982 * Currently only valid for object/container types.
7983 * Return empty string if not an object.
7984 */
Zoltan Arpadffy10231ac2024-08-18 16:59:20 +02007985#ifdef VMS // VMS does not have defined uintptr_t
7986# if defined(HAVE_NO_LONG_LONG)
7987typedef unsigned int uintptr_t;
7988# else
7989typedef unsigned long long uintptr_t;
7990# endif
7991#endif // VMS
7992
John Marriottb3b2bee2024-07-14 11:12:51 +02007993 static void
Ernie Raelc8e158b2024-07-09 18:39:52 +02007994f_id(typval_T *argvars, typval_T *rettv)
7995{
Ernie Rael05124252024-07-11 22:10:45 +02007996 char numbuf[NUMBUFLEN];
7997 char *p = numbuf;
Ernie Raelc8e158b2024-07-09 18:39:52 +02007998
7999 switch (argvars[0].v_type)
8000 {
8001 case VAR_LIST:
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008002 case VAR_TUPLE:
Ernie Raelc8e158b2024-07-09 18:39:52 +02008003 case VAR_DICT:
8004 case VAR_OBJECT:
8005 case VAR_JOB:
8006 case VAR_CHANNEL:
8007 case VAR_BLOB:
8008 // Assume pointer value in typval_T vval union at common location.
8009 if (argvars[0].vval.v_object != NULL)
Ernie Rael05124252024-07-11 22:10:45 +02008010 {
8011 // "v" gets the address as an integer
8012 uintptr_t v = (uintptr_t)(void *)argvars[0].vval.v_object;
8013 // Build a hex string from the item's address; it is in
8014 // reverse order. Ignore trailing zeros.
8015 for (; p < numbuf + sizeof(uintptr_t) * 2 && v != 0;
8016 ++p, v >>= 4)
8017 *p = "0123456789abcdef"[v & 0xf];
8018 }
Ernie Raelc8e158b2024-07-09 18:39:52 +02008019 default:
Ernie Rael05124252024-07-11 22:10:45 +02008020 break;
Ernie Raelc8e158b2024-07-09 18:39:52 +02008021 }
Ernie Rael05124252024-07-11 22:10:45 +02008022 *p = NUL;
Ernie Raelc8e158b2024-07-09 18:39:52 +02008023
8024 rettv->v_type = VAR_STRING;
Ernie Rael05124252024-07-11 22:10:45 +02008025 rettv->vval.v_string = vim_strsave((char_u *)numbuf);
Ernie Raelc8e158b2024-07-09 18:39:52 +02008026}
8027
8028/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008029 * index() function for a blob
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008030 */
8031 static void
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008032index_func_blob(typval_T *argvars, typval_T *rettv)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008033{
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008034 typval_T tv;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008035 blob_T *b;
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008036 int start = 0;
8037 int error = FALSE;
8038 int ic = FALSE;
8039
8040 b = argvars[0].vval.v_blob;
8041 if (b == NULL)
8042 return;
8043
8044 if (argvars[2].v_type != VAR_UNKNOWN)
8045 {
8046 start = tv_get_number_chk(&argvars[2], &error);
8047 if (error)
8048 return;
8049 }
8050
8051 if (start < 0)
8052 {
8053 start = blob_len(b) + start;
8054 if (start < 0)
8055 start = 0;
8056 }
8057
8058 for (int idx = start; idx < blob_len(b); ++idx)
8059 {
8060 tv.v_type = VAR_NUMBER;
8061 tv.vval.v_number = blob_get(b, idx);
8062 if (tv_equal(&tv, &argvars[1], ic))
8063 {
8064 rettv->vval.v_number = idx;
8065 return;
8066 }
8067 }
8068}
8069
8070/*
8071 * index() function for a tuple
8072 */
8073 static void
8074index_func_tuple(typval_T *argvars, typval_T *rettv)
8075{
8076 tuple_T *tuple = argvars[0].vval.v_tuple;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008077 int ic = FALSE;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008078 int error = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008079
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008080 if (tuple == NULL)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008081 return;
8082
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008083 int start_idx = 0;
8084 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008085 {
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008086 start_idx = tv_get_number_chk(&argvars[2], &error);
8087 if (!error && argvars[3].v_type != VAR_UNKNOWN)
8088 ic = (int)tv_get_bool_chk(&argvars[3], &error);
8089 if (error)
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008090 return;
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008091 }
Bram Moolenaar05500ec2019-01-13 19:10:33 +01008092
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008093 rettv->vval.v_number = index_tuple(tuple, &argvars[1], start_idx, ic);
8094}
8095
8096/*
8097 * index() function for a list
8098 */
8099 static void
8100index_func_list(typval_T *argvars, typval_T *rettv)
8101{
8102 list_T *l;
8103 listitem_T *item;
8104 long idx = 0;
8105 int ic = FALSE;
8106 int error = FALSE;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008107
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008108 l = argvars[0].vval.v_list;
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00008109 if (l == NULL)
8110 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008111
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00008112 CHECK_LIST_MATERIALIZE(l);
8113 item = l->lv_first;
8114 if (argvars[2].v_type != VAR_UNKNOWN)
8115 {
8116 // Start at specified item. Use the cached index that list_find()
8117 // sets, so that a negative number also works.
8118 item = list_find(l, (long)tv_get_number_chk(&argvars[2], &error));
8119 idx = l->lv_u.mat.lv_idx;
8120 if (argvars[3].v_type != VAR_UNKNOWN)
8121 ic = (int)tv_get_bool_chk(&argvars[3], &error);
8122 if (error)
8123 item = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008124 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00008125
8126 for ( ; item != NULL; item = item->li_next, ++idx)
Yinzuo Jiang7ccd1a22024-07-04 17:20:53 +02008127 if (tv_equal(&item->li_tv, &argvars[1], ic))
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00008128 {
8129 rettv->vval.v_number = idx;
8130 break;
8131 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008132}
8133
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008134/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008135 * "index()" function
8136 */
8137 static void
8138f_index(typval_T *argvars, typval_T *rettv)
8139{
8140 rettv->vval.v_number = -1;
8141
8142 if (in_vim9script()
8143 && (check_for_list_or_tuple_or_blob_arg(argvars, 0) == FAIL
8144 || (argvars[0].v_type == VAR_BLOB
8145 && check_for_number_arg(argvars, 1) == FAIL)
8146 || check_for_opt_number_arg(argvars, 2) == FAIL
8147 || (argvars[2].v_type != VAR_UNKNOWN
8148 && check_for_opt_bool_arg(argvars, 3) == FAIL)))
8149 return;
8150
8151 if (argvars[0].v_type == VAR_BLOB)
8152 index_func_blob(argvars, rettv);
8153 else if (argvars[0].v_type == VAR_TUPLE)
8154 index_func_tuple(argvars, rettv);
8155 else if (argvars[0].v_type == VAR_LIST)
8156 index_func_list(argvars, rettv);
8157 else
8158 emsg(_(e_list_or_blob_required));
8159}
8160
8161/*
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008162 * Evaluate 'expr' with the v:key and v:val arguments and return the result.
8163 * The expression is expected to return a boolean value. The caller should set
8164 * the VV_KEY and VV_VAL vim variables before calling this function.
8165 */
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008166 int
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008167indexof_eval_expr(typval_T *expr)
8168{
8169 typval_T argv[3];
8170 typval_T newtv;
8171 varnumber_T found;
8172 int error = FALSE;
8173
8174 argv[0] = *get_vim_var_tv(VV_KEY);
8175 argv[1] = *get_vim_var_tv(VV_VAL);
8176 newtv.v_type = VAR_UNKNOWN;
8177
zeertzjqad0c4422023-08-17 22:15:47 +02008178 if (eval_expr_typval(expr, FALSE, argv, 2, NULL, &newtv) == FAIL)
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008179 return FALSE;
8180
8181 found = tv_get_bool_chk(&newtv, &error);
Yegappan Lakshmanan63acae12022-08-14 12:07:11 +01008182 clear_tv(&newtv);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008183
8184 return error ? FALSE : found;
8185}
8186
8187/*
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008188 * Evaluate 'expr' for each byte in the Blob 'b' starting with the byte at
8189 * 'startidx' and return the index of the byte where 'expr' is TRUE. Returns
8190 * -1 if 'expr' doesn't evaluate to TRUE for any of the bytes.
8191 */
8192 static int
8193indexof_blob(blob_T *b, long startidx, typval_T *expr)
8194{
8195 long idx = 0;
8196
8197 if (b == NULL)
8198 return -1;
8199
8200 if (startidx < 0)
8201 {
8202 // negative index: index from the last byte
8203 startidx = blob_len(b) + startidx;
8204 if (startidx < 0)
8205 startidx = 0;
8206 }
8207
8208 set_vim_var_type(VV_KEY, VAR_NUMBER);
8209 set_vim_var_type(VV_VAL, VAR_NUMBER);
8210
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008211 int called_emsg_start = called_emsg;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008212 for (idx = startidx; idx < blob_len(b); ++idx)
8213 {
8214 set_vim_var_nr(VV_KEY, idx);
8215 set_vim_var_nr(VV_VAL, blob_get(b, idx));
8216
8217 if (indexof_eval_expr(expr))
8218 return idx;
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008219
8220 if (called_emsg != called_emsg_start)
8221 return -1;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008222 }
8223
8224 return -1;
8225}
8226
8227/*
8228 * Evaluate 'expr' for each item in the List 'l' starting with the item at
8229 * 'startidx' and return the index of the item where 'expr' is TRUE. Returns
8230 * -1 if 'expr' doesn't evaluate to TRUE for any of the items.
8231 */
8232 static int
8233indexof_list(list_T *l, long startidx, typval_T *expr)
8234{
8235 listitem_T *item;
8236 long idx = 0;
Yegappan Lakshmanan63acae12022-08-14 12:07:11 +01008237 int found;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008238
8239 if (l == NULL)
8240 return -1;
8241
8242 CHECK_LIST_MATERIALIZE(l);
8243
8244 if (startidx == 0)
8245 item = l->lv_first;
8246 else
8247 {
8248 // Start at specified item. Use the cached index that list_find()
8249 // sets, so that a negative number also works.
8250 item = list_find(l, startidx);
8251 if (item != NULL)
8252 idx = l->lv_u.mat.lv_idx;
8253 }
8254
8255 set_vim_var_type(VV_KEY, VAR_NUMBER);
8256
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008257 int called_emsg_start = called_emsg;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008258 for ( ; item != NULL; item = item->li_next, ++idx)
8259 {
8260 set_vim_var_nr(VV_KEY, idx);
8261 copy_tv(&item->li_tv, get_vim_var_tv(VV_VAL));
8262
Yegappan Lakshmanan63acae12022-08-14 12:07:11 +01008263 found = indexof_eval_expr(expr);
8264 clear_tv(get_vim_var_tv(VV_VAL));
8265
8266 if (found)
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008267 return idx;
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008268
8269 if (called_emsg != called_emsg_start)
8270 return -1;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008271 }
8272
8273 return -1;
8274}
8275
8276/*
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008277 * "indexof()" function
8278 */
8279 static void
8280f_indexof(typval_T *argvars, typval_T *rettv)
8281{
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008282 long startidx = 0;
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008283 typval_T save_val;
8284 typval_T save_key;
8285 int save_did_emsg;
8286
8287 rettv->vval.v_number = -1;
8288
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008289 if (check_for_list_or_tuple_or_blob_arg(argvars, 0) == FAIL
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008290 || check_for_string_or_func_arg(argvars, 1) == FAIL
8291 || check_for_opt_dict_arg(argvars, 2) == FAIL)
8292 return;
8293
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008294 if ((argvars[1].v_type == VAR_STRING &&
8295 (argvars[1].vval.v_string == NULL
8296 || *argvars[1].vval.v_string == NUL))
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008297 || (argvars[1].v_type == VAR_FUNC
8298 && argvars[1].vval.v_partial == NULL))
8299 return;
8300
8301 if (argvars[2].v_type == VAR_DICT)
8302 startidx = dict_get_number_def(argvars[2].vval.v_dict, "startidx", 0);
8303
8304 prepare_vimvar(VV_VAL, &save_val);
8305 prepare_vimvar(VV_KEY, &save_key);
8306
8307 // We reset "did_emsg" to be able to detect whether an error occurred
8308 // during evaluation of the expression.
8309 save_did_emsg = did_emsg;
8310 did_emsg = FALSE;
8311
8312 if (argvars[0].v_type == VAR_BLOB)
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008313 rettv->vval.v_number = indexof_blob(argvars[0].vval.v_blob, startidx,
8314 &argvars[1]);
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008315 else if (argvars[0].v_type == VAR_TUPLE)
8316 rettv->vval.v_number = indexof_tuple(argvars[0].vval.v_tuple, startidx,
8317 &argvars[1]);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008318 else
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008319 rettv->vval.v_number = indexof_list(argvars[0].vval.v_list, startidx,
8320 &argvars[1]);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008321
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008322 restore_vimvar(VV_KEY, &save_key);
8323 restore_vimvar(VV_VAL, &save_val);
8324 did_emsg |= save_did_emsg;
8325}
8326
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008327static int inputsecret_flag = 0;
8328
8329/*
8330 * "input()" function
8331 * Also handles inputsecret() when inputsecret is set.
8332 */
8333 static void
8334f_input(typval_T *argvars, typval_T *rettv)
8335{
8336 get_user_input(argvars, rettv, FALSE, inputsecret_flag);
8337}
8338
8339/*
8340 * "inputdialog()" function
8341 */
8342 static void
8343f_inputdialog(typval_T *argvars, typval_T *rettv)
8344{
8345#if defined(FEAT_GUI_TEXTDIALOG)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008346 // Use a GUI dialog if the GUI is running and 'c' is not in 'guioptions'
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008347 if (gui.in_use && vim_strchr(p_go, GO_CONDIALOG) == NULL)
8348 {
8349 char_u *message;
8350 char_u buf[NUMBUFLEN];
8351 char_u *defstr = (char_u *)"";
8352
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008353 if (in_vim9script()
8354 && (check_for_string_arg(argvars, 0) == FAIL
8355 || check_for_opt_string_arg(argvars, 1) == FAIL
8356 || (argvars[1].v_type != VAR_UNKNOWN
8357 && check_for_opt_string_arg(argvars, 2) == FAIL)))
8358 return;
8359
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008360 message = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008361 if (argvars[1].v_type != VAR_UNKNOWN
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008362 && (defstr = tv_get_string_buf_chk(&argvars[1], buf)) != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008363 vim_strncpy(IObuff, defstr, IOSIZE - 1);
8364 else
8365 IObuff[0] = NUL;
8366 if (message != NULL && defstr != NULL
8367 && do_dialog(VIM_QUESTION, NULL, message,
8368 (char_u *)_("&OK\n&Cancel"), 1, IObuff, FALSE) == 1)
8369 rettv->vval.v_string = vim_strsave(IObuff);
8370 else
8371 {
8372 if (message != NULL && defstr != NULL
8373 && argvars[1].v_type != VAR_UNKNOWN
8374 && argvars[2].v_type != VAR_UNKNOWN)
8375 rettv->vval.v_string = vim_strsave(
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008376 tv_get_string_buf(&argvars[2], buf));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008377 else
8378 rettv->vval.v_string = NULL;
8379 }
8380 rettv->v_type = VAR_STRING;
8381 }
8382 else
8383#endif
8384 get_user_input(argvars, rettv, TRUE, inputsecret_flag);
8385}
8386
8387/*
8388 * "inputlist()" function
8389 */
8390 static void
8391f_inputlist(typval_T *argvars, typval_T *rettv)
8392{
Bram Moolenaar50985eb2020-01-27 22:09:39 +01008393 list_T *l;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008394 listitem_T *li;
8395 int selected;
8396 int mouse_used;
8397
8398#ifdef NO_CONSOLE_INPUT
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008399 // While starting up, there is no place to enter text. When running tests
8400 // with --not-a-term we assume feedkeys() will be used.
Bram Moolenaar91d348a2017-07-29 20:16:03 +02008401 if (no_console_input() && !is_not_a_term())
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008402 return;
8403#endif
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008404 if (in_vim9script() && check_for_list_arg(argvars, 0) == FAIL)
8405 return;
8406
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008407 if (argvars[0].v_type != VAR_LIST || argvars[0].vval.v_list == NULL)
8408 {
Bram Moolenaar3a846e62022-01-01 16:21:00 +00008409 semsg(_(e_argument_of_str_must_be_list), "inputlist()");
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008410 return;
8411 }
8412
8413 msg_start();
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008414 msg_row = Rows - 1; // for when 'cmdheight' > 1
8415 lines_left = Rows; // avoid more prompt
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008416 msg_scroll = TRUE;
8417 msg_clr_eos();
8418
Bram Moolenaar50985eb2020-01-27 22:09:39 +01008419 l = argvars[0].vval.v_list;
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02008420 CHECK_LIST_MATERIALIZE(l);
Bram Moolenaar00d253e2020-04-06 22:13:01 +02008421 FOR_ALL_LIST_ITEMS(l, li)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008422 {
Bram Moolenaar32526b32019-01-19 17:43:09 +01008423 msg_puts((char *)tv_get_string(&li->li_tv));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008424 msg_putchar('\n');
8425 }
8426
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008427 // Ask for choice.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008428 selected = prompt_for_number(&mouse_used);
8429 if (mouse_used)
8430 selected -= lines_left;
8431
8432 rettv->vval.v_number = selected;
8433}
8434
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008435static garray_T ga_userinput = {0, 0, sizeof(tasave_T), 4, NULL};
8436
8437/*
8438 * "inputrestore()" function
8439 */
8440 static void
8441f_inputrestore(typval_T *argvars UNUSED, typval_T *rettv)
8442{
8443 if (ga_userinput.ga_len > 0)
8444 {
8445 --ga_userinput.ga_len;
8446 restore_typeahead((tasave_T *)(ga_userinput.ga_data)
Bram Moolenaarc41badb2021-06-07 22:04:52 +02008447 + ga_userinput.ga_len, TRUE);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008448 // default return is zero == OK
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008449 }
8450 else if (p_verbose > 1)
8451 {
Bram Moolenaar32526b32019-01-19 17:43:09 +01008452 verb_msg(_("called inputrestore() more often than inputsave()"));
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008453 rettv->vval.v_number = 1; // Failed
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008454 }
8455}
8456
8457/*
8458 * "inputsave()" function
8459 */
8460 static void
8461f_inputsave(typval_T *argvars UNUSED, typval_T *rettv)
8462{
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008463 // Add an entry to the stack of typeahead storage.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008464 if (ga_grow(&ga_userinput, 1) == OK)
8465 {
8466 save_typeahead((tasave_T *)(ga_userinput.ga_data)
8467 + ga_userinput.ga_len);
8468 ++ga_userinput.ga_len;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008469 // default return is zero == OK
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008470 }
8471 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008472 rettv->vval.v_number = 1; // Failed
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008473}
8474
8475/*
8476 * "inputsecret()" function
8477 */
8478 static void
8479f_inputsecret(typval_T *argvars, typval_T *rettv)
8480{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008481 if (in_vim9script()
8482 && (check_for_string_arg(argvars, 0) == FAIL
8483 || check_for_opt_string_arg(argvars, 1) == FAIL))
8484 return;
8485
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008486 ++cmdline_star;
8487 ++inputsecret_flag;
8488 f_input(argvars, rettv);
8489 --cmdline_star;
8490 --inputsecret_flag;
8491}
8492
8493/*
Bram Moolenaar67a2deb2019-11-25 00:05:32 +01008494 * "interrupt()" function
8495 */
8496 static void
8497f_interrupt(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
8498{
8499 got_int = TRUE;
8500}
8501
8502/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008503 * "invert(expr)" function
8504 */
8505 static void
8506f_invert(typval_T *argvars, typval_T *rettv)
8507{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008508 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
8509 return;
8510
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008511 rettv->vval.v_number = ~tv_get_number_chk(&argvars[0], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008512}
8513
8514/*
Ernie Rael4c8da022023-10-11 21:35:11 +02008515 * Free resources in lval_root allocated by fill_exec_lval_root().
8516 */
8517 static void
8518free_lval_root(lval_root_T *root)
8519{
8520 if (root->lr_tv != NULL)
8521 free_tv(root->lr_tv);
8522 class_unref(root->lr_cl_exec);
8523 root->lr_tv = NULL;
8524 root->lr_cl_exec = NULL;
8525}
8526
8527/*
8528 * This is used if executing in a method, the argument string is a
Ernie Rael0f058d12023-10-14 11:25:04 +02008529 * variable/item expr/reference. It may start with a potential class/object
8530 * variable.
Ernie Rael4c8da022023-10-11 21:35:11 +02008531 *
Ernie Rael0f058d12023-10-14 11:25:04 +02008532 * Adjust "root" as needed; lr_tv may be changed or freed.
Ernie Rael4c8da022023-10-11 21:35:11 +02008533 *
8534 * Always returns OK.
8535 * Free resources and return FAIL if the root should not be used. Otherwise OK.
8536 */
8537
8538 static int
Ernie Rael0f058d12023-10-14 11:25:04 +02008539fix_variable_reference_lval_root(lval_root_T *root, char_u *name)
Ernie Rael4c8da022023-10-11 21:35:11 +02008540{
Ernie Rael4c8da022023-10-11 21:35:11 +02008541
Ernie Rael0f058d12023-10-14 11:25:04 +02008542 // Check if lr_tv is the name of an object/class reference: name start with
8543 // "this" or name is class variable. Clear lr_tv if neither.
8544 int found_member = FALSE;
Ernie Rael4c8da022023-10-11 21:35:11 +02008545 if (root->lr_tv->v_type == VAR_OBJECT)
8546 {
Ernie Rael0f058d12023-10-14 11:25:04 +02008547 if (STRNCMP("this.", name, 5) == 0 ||STRCMP("this", name) == 0)
8548 found_member = TRUE;
Ernie Rael4c8da022023-10-11 21:35:11 +02008549 }
Ernie Rael0f058d12023-10-14 11:25:04 +02008550 if (!found_member) // not object member, try class member
Ernie Rael4c8da022023-10-11 21:35:11 +02008551 {
8552 // Explicitly check if the name is a class member.
8553 // If it's not then do nothing.
Ernie Rael0f058d12023-10-14 11:25:04 +02008554 char_u *end;
Ernie Rael4c8da022023-10-11 21:35:11 +02008555 for (end = name; ASCII_ISALNUM(*end) || *end == '_'; ++end)
8556 ;
Ernie Rael0f058d12023-10-14 11:25:04 +02008557 int idx = class_member_idx(root->lr_cl_exec, name, end - name);
8558 if (idx >= 0)
Ernie Rael4c8da022023-10-11 21:35:11 +02008559 {
Ernie Rael0f058d12023-10-14 11:25:04 +02008560 // A class variable, replace lr_tv with it
8561 clear_tv(root->lr_tv);
8562 copy_tv(&root->lr_cl_exec->class_members_tv[idx], root->lr_tv);
8563 found_member = TRUE;
Ernie Rael4c8da022023-10-11 21:35:11 +02008564 }
8565 }
Ernie Rael0f058d12023-10-14 11:25:04 +02008566 if (!found_member)
Ernie Rael4c8da022023-10-11 21:35:11 +02008567 {
8568 free_tv(root->lr_tv);
8569 root->lr_tv = NULL; // Not a member variable
8570 }
Ernie Rael4c8da022023-10-11 21:35:11 +02008571 // If FAIL, then must free_lval_root(root);
8572 return OK;
8573}
8574
8575/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008576 * "islocked()" function
8577 */
8578 static void
8579f_islocked(typval_T *argvars, typval_T *rettv)
8580{
8581 lval_T lv;
8582 char_u *end;
8583 dictitem_T *di;
8584
8585 rettv->vval.v_number = -1;
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02008586
8587 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
8588 return;
8589
Ernie Rael4c8da022023-10-11 21:35:11 +02008590 char_u *name = tv_get_string(&argvars[0]);
8591#ifdef LOG_LOCKVAR
8592 ch_log(NULL, "LKVAR: f_islocked(): name: %s", name);
8593#endif
8594
8595 lval_root_T aroot; // fully initialized in fill_exec_lval_root
8596 lval_root_T *root = NULL;
8597
8598 // Set up lval_root if executing in a method.
8599 if (fill_exec_lval_root(&aroot) == OK)
8600 {
8601 // Almost always produces a valid lval_root since lr_cl_exec is used
8602 // for access verification, lr_tv may be set to NULL.
Ernie Rael0f058d12023-10-14 11:25:04 +02008603 if (fix_variable_reference_lval_root(&aroot, name) == OK)
Ernie Rael4c8da022023-10-11 21:35:11 +02008604 root = &aroot;
Ernie Rael4c8da022023-10-11 21:35:11 +02008605 }
8606
8607 lval_root_T *lval_root_save = lval_root;
8608 lval_root = root;
8609 end = get_lval(name, NULL, &lv, FALSE, FALSE,
Bram Moolenaarbd77aa92021-08-12 17:06:05 +02008610 GLV_NO_AUTOLOAD | GLV_READ_ONLY | GLV_NO_DECL,
8611 FNE_CHECK_START);
Ernie Rael4c8da022023-10-11 21:35:11 +02008612 lval_root = lval_root_save;
8613
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008614 if (end != NULL && lv.ll_name != NULL)
8615 {
8616 if (*end != NUL)
Bram Moolenaar1840a7b2021-07-13 20:32:29 +02008617 {
8618 semsg(_(lv.ll_name == lv.ll_name_end
Bram Moolenaar0bd663a2022-01-22 10:24:47 +00008619 ? e_invalid_argument_str : e_trailing_characters_str), end);
Bram Moolenaar1840a7b2021-07-13 20:32:29 +02008620 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008621 else
8622 {
8623 if (lv.ll_tv == NULL)
8624 {
Bram Moolenaar79518e22017-02-17 16:31:35 +01008625 di = find_var(lv.ll_name, NULL, TRUE);
8626 if (di != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008627 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008628 // Consider a variable locked when:
8629 // 1. the variable itself is locked
8630 // 2. the value of the variable is locked.
8631 // 3. the List or Dict value is locked.
Bram Moolenaar79518e22017-02-17 16:31:35 +01008632 rettv->vval.v_number = ((di->di_flags & DI_FLAGS_LOCK)
8633 || tv_islocked(&di->di_tv));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008634 }
8635 }
Ernie Rael4c8da022023-10-11 21:35:11 +02008636 else if (lv.ll_is_root)
8637 {
8638 rettv->vval.v_number = tv_islocked(lv.ll_tv);
8639 }
Ernie Rael9771b2a2023-10-07 22:05:40 +02008640 else if (lv.ll_object != NULL)
8641 {
8642 typval_T *tv = ((typval_T *)(lv.ll_object + 1)) + lv.ll_oi;
8643 rettv->vval.v_number = tv_islocked(tv);
8644#ifdef LOG_LOCKVAR
8645 ch_log(NULL, "LKVAR: f_islocked(): name %s (obj)", lv.ll_name);
8646#endif
8647 }
8648 else if (lv.ll_class != NULL)
8649 {
8650 typval_T *tv = &lv.ll_class->class_members_tv[lv.ll_oi];
8651 rettv->vval.v_number = tv_islocked(tv);
8652#ifdef LOG_LOCKVAR
8653 ch_log(NULL, "LKVAR: f_islocked(): name %s (cl)", lv.ll_name);
8654#endif
8655 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008656 else if (lv.ll_range)
Bram Moolenaar677658a2022-01-05 16:09:06 +00008657 emsg(_(e_range_not_allowed));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008658 else if (lv.ll_newkey != NULL)
Bram Moolenaara9fa8c52023-01-02 18:10:04 +00008659 semsg(_(e_key_not_present_in_dictionary_str), lv.ll_newkey);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008660 else if (lv.ll_list != NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008661 // List item.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008662 rettv->vval.v_number = tv_islocked(&lv.ll_li->li_tv);
Yegappan Lakshmanan038be272025-03-26 18:46:21 +01008663 else if (lv.ll_tuple != NULL)
8664 // Tuple item.
8665 rettv->vval.v_number = tv_islocked(lv.ll_tv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008666 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008667 // Dictionary item.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008668 rettv->vval.v_number = tv_islocked(&lv.ll_di->di_tv);
8669 }
8670 }
8671
Ernie Rael4c8da022023-10-11 21:35:11 +02008672 if (root != NULL)
8673 free_lval_root(root);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008674 clear_lval(&lv);
8675}
8676
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008677/*
zeertzjqcdc83932022-09-12 13:38:41 +01008678 * "keytrans()" function
8679 */
8680 static void
8681f_keytrans(typval_T *argvars, typval_T *rettv)
8682{
8683 char_u *escaped;
8684
8685 rettv->v_type = VAR_STRING;
8686 if (check_for_string_arg(argvars, 0) == FAIL
8687 || argvars[0].vval.v_string == NULL)
8688 return;
8689 // Need to escape K_SPECIAL and CSI for mb_unescape().
8690 escaped = vim_strsave_escape_csi(argvars[0].vval.v_string);
8691 rettv->vval.v_string = str2special_save(escaped, TRUE, TRUE);
8692 vim_free(escaped);
8693}
8694
8695/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008696 * "last_buffer_nr()" function.
8697 */
8698 static void
8699f_last_buffer_nr(typval_T *argvars UNUSED, typval_T *rettv)
8700{
8701 int n = 0;
8702 buf_T *buf;
8703
Bram Moolenaar29323592016-07-24 22:04:11 +02008704 FOR_ALL_BUFFERS(buf)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008705 if (n < buf->b_fnum)
8706 n = buf->b_fnum;
8707
8708 rettv->vval.v_number = n;
8709}
8710
8711/*
8712 * "len()" function
8713 */
LemonBoy58f331a2022-04-02 21:59:06 +01008714 void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008715f_len(typval_T *argvars, typval_T *rettv)
8716{
8717 switch (argvars[0].v_type)
8718 {
8719 case VAR_STRING:
8720 case VAR_NUMBER:
8721 rettv->vval.v_number = (varnumber_T)STRLEN(
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008722 tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008723 break;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008724 case VAR_BLOB:
8725 rettv->vval.v_number = blob_len(argvars[0].vval.v_blob);
8726 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008727 case VAR_LIST:
8728 rettv->vval.v_number = list_len(argvars[0].vval.v_list);
8729 break;
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008730 case VAR_TUPLE:
8731 rettv->vval.v_number = tuple_len(argvars[0].vval.v_tuple);
8732 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008733 case VAR_DICT:
8734 rettv->vval.v_number = dict_len(argvars[0].vval.v_dict);
8735 break;
Yegappan Lakshmanand3eae7b2024-03-03 16:26:58 +01008736 case VAR_OBJECT:
8737 rettv->vval.v_number = object_len(argvars[0].vval.v_object);
8738 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008739 case VAR_UNKNOWN:
Bram Moolenaar4c683752020-04-05 21:38:23 +02008740 case VAR_ANY:
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01008741 case VAR_VOID:
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01008742 case VAR_BOOL:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008743 case VAR_SPECIAL:
8744 case VAR_FLOAT:
8745 case VAR_FUNC:
8746 case VAR_PARTIAL:
8747 case VAR_JOB:
8748 case VAR_CHANNEL:
Bram Moolenaarf18332f2021-05-07 17:55:55 +02008749 case VAR_INSTR:
Bram Moolenaar00b28d62022-12-08 15:32:33 +00008750 case VAR_CLASS:
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +02008751 case VAR_TYPEALIAS:
Bram Moolenaara6f79292022-01-04 21:30:47 +00008752 emsg(_(e_invalid_type_for_len));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008753 break;
8754 }
8755}
8756
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008757 static void
Bram Moolenaar6d721c72017-01-17 16:56:28 +01008758libcall_common(typval_T *argvars UNUSED, typval_T *rettv, int type)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008759{
8760#ifdef FEAT_LIBCALL
8761 char_u *string_in;
8762 char_u **string_result;
8763 int nr_result;
8764#endif
8765
8766 rettv->v_type = type;
8767 if (type != VAR_NUMBER)
8768 rettv->vval.v_string = NULL;
8769
8770 if (check_restricted() || check_secure())
8771 return;
8772
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02008773 if (in_vim9script()
8774 && (check_for_string_arg(argvars, 0) == FAIL
8775 || check_for_string_arg(argvars, 1) == FAIL
8776 || check_for_string_or_number_arg(argvars, 2) == FAIL))
8777 return;
8778
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008779#ifdef FEAT_LIBCALL
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008780 // The first two args must be strings, otherwise it's meaningless
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008781 if (argvars[0].v_type == VAR_STRING && argvars[1].v_type == VAR_STRING)
8782 {
8783 string_in = NULL;
8784 if (argvars[2].v_type == VAR_STRING)
8785 string_in = argvars[2].vval.v_string;
8786 if (type == VAR_NUMBER)
Bram Moolenaar87e15872021-09-02 19:53:07 +02008787 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008788 string_result = NULL;
Bram Moolenaar87e15872021-09-02 19:53:07 +02008789 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008790 else
Bram Moolenaar87e15872021-09-02 19:53:07 +02008791 {
8792 rettv->vval.v_string = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008793 string_result = &rettv->vval.v_string;
Bram Moolenaar87e15872021-09-02 19:53:07 +02008794 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008795 if (mch_libcall(argvars[0].vval.v_string,
8796 argvars[1].vval.v_string,
8797 string_in,
8798 argvars[2].vval.v_number,
8799 string_result,
8800 &nr_result) == OK
8801 && type == VAR_NUMBER)
8802 rettv->vval.v_number = nr_result;
8803 }
8804#endif
8805}
8806
8807/*
8808 * "libcall()" function
8809 */
8810 static void
8811f_libcall(typval_T *argvars, typval_T *rettv)
8812{
8813 libcall_common(argvars, rettv, VAR_STRING);
8814}
8815
8816/*
8817 * "libcallnr()" function
8818 */
8819 static void
8820f_libcallnr(typval_T *argvars, typval_T *rettv)
8821{
8822 libcall_common(argvars, rettv, VAR_NUMBER);
8823}
8824
8825/*
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008826 * "line(string, [winid])" function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008827 */
8828 static void
8829f_line(typval_T *argvars, typval_T *rettv)
8830{
8831 linenr_T lnum = 0;
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008832 pos_T *fp = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008833 int fnum;
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008834 int id;
8835 tabpage_T *tp;
8836 win_T *wp;
Bram Moolenaar18f47402022-01-06 13:24:51 +00008837 switchwin_T switchwin;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008838
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02008839 if (in_vim9script()
8840 && (check_for_string_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008841 || check_for_opt_number_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02008842 return;
8843
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008844 if (argvars[1].v_type != VAR_UNKNOWN)
8845 {
8846 // use window specified in the second argument
8847 id = (int)tv_get_number(&argvars[1]);
8848 wp = win_id2wp_tp(id, &tp);
8849 if (wp != NULL && tp != NULL)
8850 {
Bram Moolenaar18f47402022-01-06 13:24:51 +00008851 if (switch_win_noblock(&switchwin, wp, tp, TRUE) == OK)
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008852 {
Luuk van Baalfe803c82025-06-26 20:34:15 +02008853 // With 'splitkeep' != cursor and in diff mode, prevent that the
8854 // window scrolls and keep the topline.
8855 if (*p_spk != 'c'
John Marriott69f85c62024-10-31 10:53:43 +01008856#ifdef FEAT_DIFF
Luuk van Baalfe803c82025-06-26 20:34:15 +02008857 || (curwin->w_p_diff && switchwin.sw_curwin->w_p_diff)
John Marriott69f85c62024-10-31 10:53:43 +01008858#endif
Luuk van Baalfe803c82025-06-26 20:34:15 +02008859 )
8860 skip_update_topline = TRUE;
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008861 check_cursor();
Bram Moolenaar6f02b002021-01-10 20:22:54 +01008862 fp = var2fpos(&argvars[0], TRUE, &fnum, FALSE);
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008863 }
Luuk van Baalfe803c82025-06-26 20:34:15 +02008864 skip_update_topline = FALSE;
Bram Moolenaar18f47402022-01-06 13:24:51 +00008865 restore_win_noblock(&switchwin, TRUE);
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008866 }
8867 }
8868 else
8869 // use current window
Bram Moolenaar6f02b002021-01-10 20:22:54 +01008870 fp = var2fpos(&argvars[0], TRUE, &fnum, FALSE);
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008871
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008872 if (fp != NULL)
8873 lnum = fp->lnum;
8874 rettv->vval.v_number = lnum;
8875}
8876
8877/*
8878 * "line2byte(lnum)" function
8879 */
8880 static void
8881f_line2byte(typval_T *argvars UNUSED, typval_T *rettv)
8882{
8883#ifndef FEAT_BYTEOFF
8884 rettv->vval.v_number = -1;
8885#else
8886 linenr_T lnum;
8887
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008888 if (in_vim9script() && check_for_lnum_arg(argvars, 0) == FAIL)
8889 return;
8890
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008891 lnum = tv_get_lnum(argvars);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008892 if (lnum < 1 || lnum > curbuf->b_ml.ml_line_count + 1)
8893 rettv->vval.v_number = -1;
8894 else
8895 rettv->vval.v_number = ml_find_line_or_offset(curbuf, lnum, NULL);
8896 if (rettv->vval.v_number >= 0)
8897 ++rettv->vval.v_number;
8898#endif
8899}
8900
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008901#ifdef FEAT_LUA
8902/*
8903 * "luaeval()" function
8904 */
8905 static void
8906f_luaeval(typval_T *argvars, typval_T *rettv)
8907{
8908 char_u *str;
8909 char_u buf[NUMBUFLEN];
8910
Bram Moolenaar8c62a082019-02-08 14:34:10 +01008911 if (check_restricted() || check_secure())
8912 return;
8913
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02008914 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
8915 return;
8916
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008917 str = tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008918 do_luaeval(str, argvars + 1, rettv);
8919}
8920#endif
8921
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008922typedef enum
8923{
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008924 MATCH_END, // matchend()
8925 MATCH_MATCH, // match()
8926 MATCH_STR, // matchstr()
8927 MATCH_LIST, // matchlist()
8928 MATCH_POS // matchstrpos()
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008929} matchtype_T;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008930
8931 static void
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008932find_some_match(typval_T *argvars, typval_T *rettv, matchtype_T type)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008933{
8934 char_u *str = NULL;
8935 long len = 0;
8936 char_u *expr = NULL;
8937 char_u *pat;
8938 regmatch_T regmatch;
8939 char_u patbuf[NUMBUFLEN];
8940 char_u strbuf[NUMBUFLEN];
8941 char_u *save_cpo;
8942 long start = 0;
8943 long nth = 1;
8944 colnr_T startcol = 0;
8945 int match = 0;
8946 list_T *l = NULL;
8947 listitem_T *li = NULL;
8948 long idx = 0;
8949 char_u *tofree = NULL;
8950
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008951 // Make 'cpoptions' empty, the 'l' flag should not be used here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008952 save_cpo = p_cpo;
Bram Moolenaare5a2dc82021-01-03 19:52:05 +01008953 p_cpo = empty_option;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008954
8955 rettv->vval.v_number = -1;
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008956 if (type == MATCH_LIST || type == MATCH_POS)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008957 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008958 // type MATCH_LIST: return empty list when there are no matches.
8959 // type MATCH_POS: return ["", -1, -1, -1]
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008960 if (rettv_list_alloc(rettv) == FAIL)
8961 goto theend;
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008962 if (type == MATCH_POS
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008963 && (list_append_string(rettv->vval.v_list,
8964 (char_u *)"", 0) == FAIL
8965 || list_append_number(rettv->vval.v_list,
8966 (varnumber_T)-1) == FAIL
8967 || list_append_number(rettv->vval.v_list,
8968 (varnumber_T)-1) == FAIL
8969 || list_append_number(rettv->vval.v_list,
8970 (varnumber_T)-1) == FAIL))
8971 {
8972 list_free(rettv->vval.v_list);
8973 rettv->vval.v_list = NULL;
8974 goto theend;
8975 }
8976 }
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008977 else if (type == MATCH_STR)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008978 {
8979 rettv->v_type = VAR_STRING;
8980 rettv->vval.v_string = NULL;
8981 }
8982
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02008983 if (in_vim9script()
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008984 && (check_for_string_or_list_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008985 || check_for_string_arg(argvars, 1) == FAIL
8986 || check_for_opt_number_arg(argvars, 2) == FAIL
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02008987 || (argvars[2].v_type != VAR_UNKNOWN
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008988 && check_for_opt_number_arg(argvars, 3) == FAIL)))
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02008989 goto theend;
8990
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008991 if (argvars[0].v_type == VAR_LIST)
8992 {
8993 if ((l = argvars[0].vval.v_list) == NULL)
8994 goto theend;
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02008995 CHECK_LIST_MATERIALIZE(l);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008996 li = l->lv_first;
8997 }
8998 else
8999 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009000 expr = str = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009001 len = (long)STRLEN(str);
9002 }
9003
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009004 pat = tv_get_string_buf_chk(&argvars[1], patbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009005 if (pat == NULL)
9006 goto theend;
9007
9008 if (argvars[2].v_type != VAR_UNKNOWN)
9009 {
9010 int error = FALSE;
9011
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009012 start = (long)tv_get_number_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009013 if (error)
9014 goto theend;
9015 if (l != NULL)
9016 {
9017 li = list_find(l, start);
9018 if (li == NULL)
9019 goto theend;
Bram Moolenaar0ff6aad2020-01-29 21:27:21 +01009020 idx = l->lv_u.mat.lv_idx; // use the cached index
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009021 }
9022 else
9023 {
9024 if (start < 0)
9025 start = 0;
9026 if (start > len)
9027 goto theend;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009028 // When "count" argument is there ignore matches before "start",
9029 // otherwise skip part of the string. Differs when pattern is "^"
9030 // or "\<".
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009031 if (argvars[3].v_type != VAR_UNKNOWN)
9032 startcol = start;
9033 else
9034 {
9035 str += start;
9036 len -= start;
9037 }
9038 }
9039
9040 if (argvars[3].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009041 nth = (long)tv_get_number_chk(&argvars[3], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009042 if (error)
9043 goto theend;
9044 }
9045
9046 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
9047 if (regmatch.regprog != NULL)
9048 {
9049 regmatch.rm_ic = p_ic;
9050
9051 for (;;)
9052 {
9053 if (l != NULL)
9054 {
9055 if (li == NULL)
9056 {
9057 match = FALSE;
9058 break;
9059 }
9060 vim_free(tofree);
9061 expr = str = echo_string(&li->li_tv, &tofree, strbuf, 0);
9062 if (str == NULL)
9063 break;
9064 }
9065
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +00009066 match = vim_regexec_nl(&regmatch, str, startcol);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009067
9068 if (match && --nth <= 0)
9069 break;
9070 if (l == NULL && !match)
9071 break;
9072
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009073 // Advance to just after the match.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009074 if (l != NULL)
9075 {
9076 li = li->li_next;
9077 ++idx;
9078 }
9079 else
9080 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009081 startcol = (colnr_T)(regmatch.startp[0]
9082 + (*mb_ptr2len)(regmatch.startp[0]) - str);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009083 if (startcol > (colnr_T)len
9084 || str + startcol <= regmatch.startp[0])
9085 {
9086 match = FALSE;
9087 break;
9088 }
9089 }
9090 }
9091
9092 if (match)
9093 {
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009094 if (type == MATCH_POS)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009095 {
9096 listitem_T *li1 = rettv->vval.v_list->lv_first;
9097 listitem_T *li2 = li1->li_next;
9098 listitem_T *li3 = li2->li_next;
9099 listitem_T *li4 = li3->li_next;
9100
9101 vim_free(li1->li_tv.vval.v_string);
9102 li1->li_tv.vval.v_string = vim_strnsave(regmatch.startp[0],
Bram Moolenaardf44a272020-06-07 20:49:05 +02009103 regmatch.endp[0] - regmatch.startp[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009104 li3->li_tv.vval.v_number =
9105 (varnumber_T)(regmatch.startp[0] - expr);
9106 li4->li_tv.vval.v_number =
9107 (varnumber_T)(regmatch.endp[0] - expr);
9108 if (l != NULL)
9109 li2->li_tv.vval.v_number = (varnumber_T)idx;
9110 }
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009111 else if (type == MATCH_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009112 {
9113 int i;
9114
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009115 // return list with matched string and submatches
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009116 for (i = 0; i < NSUBEXP; ++i)
9117 {
9118 if (regmatch.endp[i] == NULL)
9119 {
9120 if (list_append_string(rettv->vval.v_list,
9121 (char_u *)"", 0) == FAIL)
9122 break;
9123 }
9124 else if (list_append_string(rettv->vval.v_list,
9125 regmatch.startp[i],
9126 (int)(regmatch.endp[i] - regmatch.startp[i]))
9127 == FAIL)
9128 break;
9129 }
9130 }
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009131 else if (type == MATCH_STR)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009132 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009133 // return matched string
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009134 if (l != NULL)
9135 copy_tv(&li->li_tv, rettv);
9136 else
9137 rettv->vval.v_string = vim_strnsave(regmatch.startp[0],
Bram Moolenaardf44a272020-06-07 20:49:05 +02009138 regmatch.endp[0] - regmatch.startp[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009139 }
9140 else if (l != NULL)
9141 rettv->vval.v_number = idx;
9142 else
9143 {
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009144 if (type != MATCH_END)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009145 rettv->vval.v_number =
9146 (varnumber_T)(regmatch.startp[0] - str);
9147 else
9148 rettv->vval.v_number =
9149 (varnumber_T)(regmatch.endp[0] - str);
9150 rettv->vval.v_number += (varnumber_T)(str - expr);
9151 }
9152 }
9153 vim_regfree(regmatch.regprog);
9154 }
9155
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009156theend:
9157 if (type == MATCH_POS && l == NULL && rettv->vval.v_list != NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009158 // matchstrpos() without a list: drop the second item.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009159 listitem_remove(rettv->vval.v_list,
9160 rettv->vval.v_list->lv_first->li_next);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009161 vim_free(tofree);
9162 p_cpo = save_cpo;
9163}
9164
9165/*
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01009166 * Return all the matches in string "str" for pattern "rmp".
9167 * The matches are returned in the List "mlist".
9168 * If "submatches" is TRUE, then submatch information is also returned.
9169 * "matchbuf" is TRUE when called for matchbufline().
9170 */
9171 static int
9172get_matches_in_str(
9173 char_u *str,
9174 regmatch_T *rmp,
9175 list_T *mlist,
9176 int idx,
9177 int submatches,
9178 int matchbuf)
9179{
9180 long len = (long)STRLEN(str);
9181 int match = 0;
9182 colnr_T startidx = 0;
9183
9184 for (;;)
9185 {
9186 match = vim_regexec_nl(rmp, str, startidx);
9187 if (!match)
9188 break;
9189
9190 dict_T *d = dict_alloc();
9191 if (d == NULL)
9192 return FAIL;
9193 if (list_append_dict(mlist, d) == FAIL)
Satoru Kitaguchiba737662025-04-06 16:04:59 +02009194 return FAIL;
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01009195
9196 if (dict_add_number(d, matchbuf ? "lnum" : "idx", idx) == FAIL)
9197 return FAIL;
9198
9199 if (dict_add_number(d, "byteidx",
9200 (colnr_T)(rmp->startp[0] - str)) == FAIL)
9201 return FAIL;
9202
9203 if (dict_add_string_len(d, "text", rmp->startp[0],
9204 (int)(rmp->endp[0] - rmp->startp[0])) == FAIL)
9205 return FAIL;
9206
9207 if (submatches)
9208 {
9209 list_T *sml = list_alloc();
9210 if (sml == NULL)
9211 return FAIL;
9212
9213 if (dict_add_list(d, "submatches", sml) == FAIL)
9214 return FAIL;
9215
9216 // return a list with the submatches
9217 for (int i = 1; i < NSUBEXP; ++i)
9218 {
9219 if (rmp->endp[i] == NULL)
9220 {
9221 if (list_append_string(sml, (char_u *)"", 0) == FAIL)
9222 return FAIL;
9223 }
9224 else if (list_append_string(sml, rmp->startp[i],
9225 (int)(rmp->endp[i] - rmp->startp[i])) == FAIL)
9226 return FAIL;
9227 }
9228 }
9229 startidx = (colnr_T)(rmp->endp[0] - str);
9230 if (startidx >= (colnr_T)len || str + startidx <= rmp->startp[0])
9231 break;
9232 }
9233
9234 return OK;
9235}
9236
9237/*
9238 * "matchbufline()" function
9239 */
9240 static void
9241f_matchbufline(typval_T *argvars, typval_T *rettv)
9242{
9243 list_T *retlist = NULL;
9244 char_u *save_cpo;
9245 char_u patbuf[NUMBUFLEN];
9246 regmatch_T regmatch;
9247
9248 rettv->vval.v_number = -1;
9249 if (rettv_list_alloc(rettv) != OK)
9250 return;
9251 retlist = rettv->vval.v_list;
9252
9253 if (check_for_buffer_arg(argvars, 0) == FAIL
9254 || check_for_string_arg(argvars, 1) == FAIL
9255 || check_for_lnum_arg(argvars, 2) == FAIL
9256 || check_for_lnum_arg(argvars, 3) == FAIL
9257 || check_for_opt_dict_arg(argvars, 4) == FAIL)
9258 return;
9259
9260 int prev_did_emsg = did_emsg;
9261 buf_T *buf = tv_get_buf(&argvars[0], FALSE);
9262 if (buf == NULL)
9263 {
9264 if (did_emsg == prev_did_emsg)
9265 semsg(_(e_invalid_buffer_name_str), tv_get_string(&argvars[0]));
9266 return;
9267 }
9268 if (buf->b_ml.ml_mfp == NULL)
9269 {
9270 emsg(_(e_buffer_is_not_loaded));
9271 return;
9272 }
9273
9274 char_u *pat = tv_get_string_buf(&argvars[1], patbuf);
9275
9276 int did_emsg_before = did_emsg;
9277 linenr_T slnum = tv_get_lnum_buf(&argvars[2], buf);
9278 if (did_emsg > did_emsg_before)
9279 return;
9280 if (slnum < 1)
9281 {
9282 semsg(_(e_invalid_value_for_argument_str), "lnum");
9283 return;
9284 }
9285
9286 linenr_T elnum = tv_get_lnum_buf(&argvars[3], buf);
9287 if (did_emsg > did_emsg_before)
9288 return;
9289 if (elnum < 1 || elnum < slnum)
9290 {
9291 semsg(_(e_invalid_value_for_argument_str), "end_lnum");
9292 return;
9293 }
9294
9295 if (elnum > buf->b_ml.ml_line_count)
9296 elnum = buf->b_ml.ml_line_count;
9297
9298 int submatches = FALSE;
9299 if (argvars[4].v_type != VAR_UNKNOWN)
9300 {
9301 dict_T *d = argvars[4].vval.v_dict;
9302 if (d != NULL)
9303 {
9304 dictitem_T *di = dict_find(d, (char_u *)"submatches", -1);
9305 if (di != NULL)
9306 {
9307 if (di->di_tv.v_type != VAR_BOOL)
9308 {
9309 semsg(_(e_invalid_value_for_argument_str), "submatches");
9310 return;
9311 }
9312 submatches = tv_get_bool(&di->di_tv);
9313 }
9314 }
9315 }
9316
9317 // Make 'cpoptions' empty, the 'l' flag should not be used here.
9318 save_cpo = p_cpo;
9319 p_cpo = empty_option;
9320
9321 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
9322 if (regmatch.regprog == NULL)
9323 goto theend;
9324 regmatch.rm_ic = p_ic;
9325
9326 while (slnum <= elnum)
9327 {
9328 char_u *str = ml_get_buf(buf, slnum, FALSE);
9329 if (get_matches_in_str(str, &regmatch, retlist, slnum, submatches,
9330 TRUE) == FAIL)
9331 goto cleanup;
9332 slnum++;
9333 }
9334
9335cleanup:
9336 vim_regfree(regmatch.regprog);
9337
9338theend:
9339 p_cpo = save_cpo;
9340}
9341
9342/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009343 * "match()" function
9344 */
9345 static void
9346f_match(typval_T *argvars, typval_T *rettv)
9347{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009348 find_some_match(argvars, rettv, MATCH_MATCH);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009349}
9350
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009351/*
9352 * "matchend()" function
9353 */
9354 static void
9355f_matchend(typval_T *argvars, typval_T *rettv)
9356{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009357 find_some_match(argvars, rettv, MATCH_END);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009358}
9359
9360/*
9361 * "matchlist()" function
9362 */
9363 static void
9364f_matchlist(typval_T *argvars, typval_T *rettv)
9365{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009366 find_some_match(argvars, rettv, MATCH_LIST);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009367}
9368
9369/*
9370 * "matchstr()" function
9371 */
9372 static void
9373f_matchstr(typval_T *argvars, typval_T *rettv)
9374{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009375 find_some_match(argvars, rettv, MATCH_STR);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009376}
9377
9378/*
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01009379 * "matchstrlist()" function
9380 */
9381 static void
9382f_matchstrlist(typval_T *argvars, typval_T *rettv)
9383{
9384 list_T *retlist = NULL;
9385 char_u *save_cpo;
9386 list_T *l = NULL;
9387 listitem_T *li = NULL;
9388 char_u patbuf[NUMBUFLEN];
9389 regmatch_T regmatch;
9390
9391 rettv->vval.v_number = -1;
9392 if (rettv_list_alloc(rettv) != OK)
9393 return;
9394 retlist = rettv->vval.v_list;
9395
9396 if (check_for_list_arg(argvars, 0) == FAIL
9397 || check_for_string_arg(argvars, 1) == FAIL
9398 || check_for_opt_dict_arg(argvars, 2) == FAIL)
9399 return;
9400
9401 if ((l = argvars[0].vval.v_list) == NULL)
9402 return;
9403
9404 char_u *pat = tv_get_string_buf_chk(&argvars[1], patbuf);
9405 if (pat == NULL)
9406 return;
9407
9408 // Make 'cpoptions' empty, the 'l' flag should not be used here.
9409 save_cpo = p_cpo;
9410 p_cpo = empty_option;
9411
9412 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
9413 if (regmatch.regprog == NULL)
9414 goto theend;
9415 regmatch.rm_ic = p_ic;
9416
9417 int submatches = FALSE;
9418 if (argvars[2].v_type != VAR_UNKNOWN)
9419 {
9420 dict_T *d = argvars[2].vval.v_dict;
9421 if (d != NULL)
9422 {
9423 dictitem_T *di = dict_find(d, (char_u *)"submatches", -1);
9424 if (di != NULL)
9425 {
9426 if (di->di_tv.v_type != VAR_BOOL)
9427 {
9428 semsg(_(e_invalid_value_for_argument_str), "submatches");
9429 goto cleanup;
9430 }
9431 submatches = tv_get_bool(&di->di_tv);
9432 }
9433 }
9434 }
9435
9436 int idx = 0;
9437 CHECK_LIST_MATERIALIZE(l);
9438 FOR_ALL_LIST_ITEMS(l, li)
9439 {
9440 if (li->li_tv.v_type == VAR_STRING && li->li_tv.vval.v_string != NULL)
9441 {
9442 char_u *str = li->li_tv.vval.v_string;
9443 if (get_matches_in_str(str, &regmatch, retlist, idx, submatches,
9444 FALSE) == FAIL)
9445 goto cleanup;
9446 }
9447 idx++;
9448 }
9449
9450cleanup:
9451 vim_regfree(regmatch.regprog);
9452
9453theend:
9454 p_cpo = save_cpo;
9455}
9456
9457/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009458 * "matchstrpos()" function
9459 */
9460 static void
9461f_matchstrpos(typval_T *argvars, typval_T *rettv)
9462{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009463 find_some_match(argvars, rettv, MATCH_POS);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009464}
9465
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009466 static void
9467max_min(typval_T *argvars, typval_T *rettv, int domax)
9468{
9469 varnumber_T n = 0;
9470 varnumber_T i;
9471 int error = FALSE;
9472
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01009473 if (in_vim9script() &&
9474 check_for_list_or_tuple_or_dict_arg(argvars, 0) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009475 return;
9476
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009477 if (argvars[0].v_type == VAR_LIST)
9478 {
9479 list_T *l;
9480 listitem_T *li;
9481
9482 l = argvars[0].vval.v_list;
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009483 if (l != NULL && l->lv_len > 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009484 {
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009485 if (l->lv_first == &range_list_item)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009486 {
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009487 if ((l->lv_u.nonmat.lv_stride > 0) ^ domax)
9488 n = l->lv_u.nonmat.lv_start;
9489 else
=?UTF-8?q?Dundar=20G=C3=B6c?=d5cec1f2022-01-29 15:19:23 +00009490 n = l->lv_u.nonmat.lv_start + ((varnumber_T)l->lv_len - 1)
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009491 * l->lv_u.nonmat.lv_stride;
9492 }
9493 else
9494 {
9495 li = l->lv_first;
9496 if (li != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009497 {
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009498 n = tv_get_number_chk(&li->li_tv, &error);
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009499 if (error)
9500 return; // type error; errmsg already given
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009501 for (;;)
9502 {
9503 li = li->li_next;
9504 if (li == NULL)
9505 break;
9506 i = tv_get_number_chk(&li->li_tv, &error);
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009507 if (error)
9508 return; // type error; errmsg already given
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009509 if (domax ? i > n : i < n)
9510 n = i;
9511 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009512 }
9513 }
9514 }
9515 }
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01009516 else if (argvars[0].v_type == VAR_TUPLE)
9517 {
9518 n = tuple_max_min(argvars[0].vval.v_tuple, domax, &error);
9519 if (error)
9520 return;
9521 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009522 else if (argvars[0].v_type == VAR_DICT)
9523 {
9524 dict_T *d;
9525 int first = TRUE;
9526 hashitem_T *hi;
9527 int todo;
9528
9529 d = argvars[0].vval.v_dict;
9530 if (d != NULL)
9531 {
9532 todo = (int)d->dv_hashtab.ht_used;
Yegappan Lakshmanan14113fd2023-03-07 17:13:51 +00009533 FOR_ALL_HASHTAB_ITEMS(&d->dv_hashtab, hi, todo)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009534 {
9535 if (!HASHITEM_EMPTY(hi))
9536 {
9537 --todo;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009538 i = tv_get_number_chk(&HI2DI(hi)->di_tv, &error);
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009539 if (error)
9540 return; // type error; errmsg already given
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009541 if (first)
9542 {
9543 n = i;
9544 first = FALSE;
9545 }
9546 else if (domax ? i > n : i < n)
9547 n = i;
9548 }
9549 }
9550 }
9551 }
9552 else
Bram Moolenaar460ae5d2022-01-01 14:19:49 +00009553 semsg(_(e_argument_of_str_must_be_list_or_dictionary), domax ? "max()" : "min()");
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009554
9555 rettv->vval.v_number = n;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009556}
9557
9558/*
9559 * "max()" function
9560 */
9561 static void
9562f_max(typval_T *argvars, typval_T *rettv)
9563{
9564 max_min(argvars, rettv, TRUE);
9565}
9566
9567/*
9568 * "min()" function
9569 */
9570 static void
9571f_min(typval_T *argvars, typval_T *rettv)
9572{
9573 max_min(argvars, rettv, FALSE);
9574}
9575
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009576#if defined(FEAT_MZSCHEME) || defined(PROTO)
9577/*
9578 * "mzeval()" function
9579 */
9580 static void
9581f_mzeval(typval_T *argvars, typval_T *rettv)
9582{
9583 char_u *str;
9584 char_u buf[NUMBUFLEN];
9585
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009586 if (check_restricted() || check_secure())
9587 return;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009588
9589 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
9590 return;
9591
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009592 str = tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009593 do_mzeval(str, rettv);
9594}
9595
9596 void
9597mzscheme_call_vim(char_u *name, typval_T *args, typval_T *rettv)
9598{
9599 typval_T argvars[3];
9600
9601 argvars[0].v_type = VAR_STRING;
9602 argvars[0].vval.v_string = name;
9603 copy_tv(args, &argvars[1]);
9604 argvars[2].v_type = VAR_UNKNOWN;
9605 f_call(argvars, rettv);
9606 clear_tv(&argvars[1]);
9607}
9608#endif
9609
9610/*
9611 * "nextnonblank()" function
9612 */
9613 static void
9614f_nextnonblank(typval_T *argvars, typval_T *rettv)
9615{
9616 linenr_T lnum;
9617
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009618 if (in_vim9script() && check_for_lnum_arg(argvars, 0) == FAIL)
9619 return;
9620
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009621 for (lnum = tv_get_lnum(argvars); ; ++lnum)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009622 {
9623 if (lnum < 0 || lnum > curbuf->b_ml.ml_line_count)
9624 {
9625 lnum = 0;
9626 break;
9627 }
9628 if (*skipwhite(ml_get(lnum)) != NUL)
9629 break;
9630 }
9631 rettv->vval.v_number = lnum;
9632}
9633
Christ van Willegenc0786752025-02-01 15:42:16 +01009634
9635/*
9636 * "ngettext()" function
9637 */
9638 static void
9639f_ngettext(typval_T *argvars, typval_T *rettv)
9640{
9641#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
9642 char *prev = NULL;
9643#endif
9644
9645 if (check_for_nonempty_string_arg(argvars, 0) == FAIL
9646 || check_for_nonempty_string_arg(argvars, 1) == FAIL
9647 || check_for_number_arg(argvars, 2) == FAIL
9648 || check_for_opt_string_arg(argvars, 3) == FAIL)
9649 return;
9650
9651 rettv->v_type = VAR_STRING;
9652
9653 if (argvars[3].v_type == VAR_STRING &&
9654 argvars[3].vval.v_string != NULL &&
9655 *(argvars[3].vval.v_string) != NUL)
9656 {
9657#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
9658 prev = bind_textdomain_codeset((const char *)argvars[3].vval.v_string, (char *)p_enc);
9659#endif
9660
9661#if defined(HAVE_DNGETTEXT)
9662 rettv->vval.v_string = vim_strsave((char_u *)dngettext((const char *)argvars[3].vval.v_string, (const char *)argvars[0].vval.v_string, (const char *)argvars[1].vval.v_string, (int)argvars[2].vval.v_number));
9663#else
9664 textdomain((const char *)argvars[3].vval.v_string);
9665 rettv->vval.v_string = vim_strsave((char_u *)NGETTEXT((const char *)argvars[0].vval.v_string, (const char *)argvars[1].vval.v_string, argvars[2].vval.v_number));
9666 textdomain(VIMPACKAGE);
9667#endif
9668
9669#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
9670 if (prev != NULL)
9671 bind_textdomain_codeset((const char *)argvars[3].vval.v_string, prev);
9672#endif
9673 }
9674 else
9675 rettv->vval.v_string = vim_strsave((char_u *)NGETTEXT((const char *)argvars[0].vval.v_string, (const char *)argvars[1].vval.v_string, argvars[2].vval.v_number));
9676}
9677
9678
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009679/*
9680 * "nr2char()" function
9681 */
9682 static void
9683f_nr2char(typval_T *argvars, typval_T *rettv)
9684{
9685 char_u buf[NUMBUFLEN];
9686
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02009687 if (in_vim9script()
9688 && (check_for_number_arg(argvars, 0) == FAIL
9689 || check_for_opt_bool_arg(argvars, 1) == FAIL))
9690 return;
9691
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009692 if (has_mbyte)
9693 {
9694 int utf8 = 0;
9695
9696 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaared6a4302020-09-05 20:29:41 +02009697 utf8 = (int)tv_get_bool_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009698 if (utf8)
Bram Moolenaarbdace832019-03-02 10:13:42 +01009699 buf[utf_char2bytes((int)tv_get_number(&argvars[0]), buf)] = NUL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009700 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009701 buf[(*mb_char2bytes)((int)tv_get_number(&argvars[0]), buf)] = NUL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009702 }
9703 else
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009704 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009705 buf[0] = (char_u)tv_get_number(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009706 buf[1] = NUL;
9707 }
9708 rettv->v_type = VAR_STRING;
9709 rettv->vval.v_string = vim_strsave(buf);
9710}
9711
9712/*
9713 * "or(expr, expr)" function
9714 */
9715 static void
9716f_or(typval_T *argvars, typval_T *rettv)
9717{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009718 if (in_vim9script()
9719 && (check_for_number_arg(argvars, 0) == FAIL
9720 || check_for_number_arg(argvars, 1) == FAIL))
9721 return;
9722
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009723 rettv->vval.v_number = tv_get_number_chk(&argvars[0], NULL)
9724 | tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009725}
9726
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009727#ifdef FEAT_PERL
9728/*
9729 * "perleval()" function
9730 */
9731 static void
9732f_perleval(typval_T *argvars, typval_T *rettv)
9733{
9734 char_u *str;
9735 char_u buf[NUMBUFLEN];
9736
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009737 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
9738 return;
9739
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009740 str = tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009741 do_perleval(str, rettv);
9742}
9743#endif
9744
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009745/*
9746 * "prevnonblank()" function
9747 */
9748 static void
9749f_prevnonblank(typval_T *argvars, typval_T *rettv)
9750{
9751 linenr_T lnum;
9752
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009753 if (in_vim9script() && check_for_lnum_arg(argvars, 0) == FAIL)
9754 return;
9755
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009756 lnum = tv_get_lnum(argvars);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009757 if (lnum < 1 || lnum > curbuf->b_ml.ml_line_count)
9758 lnum = 0;
9759 else
9760 while (lnum >= 1 && *skipwhite(ml_get(lnum)) == NUL)
9761 --lnum;
9762 rettv->vval.v_number = lnum;
9763}
9764
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009765// This dummy va_list is here because:
9766// - passing a NULL pointer doesn't work when va_list isn't a pointer
9767// - locally in the function results in a "used before set" warning
9768// - using va_start() to initialize it gives "function with fixed args" error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009769static va_list ap;
9770
9771/*
9772 * "printf()" function
9773 */
9774 static void
9775f_printf(typval_T *argvars, typval_T *rettv)
9776{
9777 char_u buf[NUMBUFLEN];
9778 int len;
9779 char_u *s;
9780 int saved_did_emsg = did_emsg;
9781 char *fmt;
9782
9783 rettv->v_type = VAR_STRING;
9784 rettv->vval.v_string = NULL;
9785
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02009786 if (in_vim9script() && check_for_string_or_number_arg(argvars, 0) == FAIL)
9787 return;
9788
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009789 // Get the required length, allocate the buffer and do it for real.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009790 did_emsg = FALSE;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009791 fmt = (char *)tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar8327d1d2017-07-11 22:34:51 +02009792 len = vim_vsnprintf_typval(NULL, 0, fmt, ap, argvars + 1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009793 if (!did_emsg)
9794 {
9795 s = alloc(len + 1);
9796 if (s != NULL)
9797 {
9798 rettv->vval.v_string = s;
Bram Moolenaar8327d1d2017-07-11 22:34:51 +02009799 (void)vim_vsnprintf_typval((char *)s, len + 1, fmt,
9800 ap, argvars + 1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009801 }
9802 }
9803 did_emsg |= saved_did_emsg;
9804}
9805
9806/*
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009807 * "pum_getpos()" function
9808 */
9809 static void
9810f_pum_getpos(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
9811{
Bram Moolenaar93a10962022-06-16 11:42:09 +01009812 if (rettv_dict_alloc(rettv) == FAIL)
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009813 return;
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009814 pum_set_event_info(rettv->vval.v_dict);
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009815}
9816
9817/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009818 * "pumvisible()" function
9819 */
9820 static void
9821f_pumvisible(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
9822{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009823 if (pum_visible())
9824 rettv->vval.v_number = 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009825}
9826
9827#ifdef FEAT_PYTHON3
9828/*
9829 * "py3eval()" function
9830 */
9831 static void
9832f_py3eval(typval_T *argvars, typval_T *rettv)
9833{
9834 char_u *str;
9835 char_u buf[NUMBUFLEN];
Ben Jacksonea19e782024-11-06 21:50:05 +01009836 dict_T *locals;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009837
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009838 if (check_restricted() || check_secure())
9839 return;
9840
Ben Jacksonea19e782024-11-06 21:50:05 +01009841 if (in_vim9script()
9842 && (check_for_string_arg(argvars, 0) == FAIL
9843 || check_for_opt_dict_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009844 return;
9845
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009846 if (p_pyx == 0)
9847 p_pyx = 3;
9848
Ben Jacksonea19e782024-11-06 21:50:05 +01009849 if (argvars[1].v_type == VAR_DICT)
9850 {
9851 locals = argvars[1].vval.v_dict;
9852 }
9853 else if (argvars[1].v_type != VAR_UNKNOWN)
9854 {
9855 emsg(_(e_dictionary_required));
9856 return;
9857 }
9858 else
9859 {
9860 locals = NULL;
9861 }
9862
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009863 str = tv_get_string_buf(&argvars[0], buf);
Ben Jacksonea19e782024-11-06 21:50:05 +01009864 do_py3eval(str, locals, rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009865}
9866#endif
9867
9868#ifdef FEAT_PYTHON
9869/*
9870 * "pyeval()" function
9871 */
9872 static void
9873f_pyeval(typval_T *argvars, typval_T *rettv)
9874{
9875 char_u *str;
9876 char_u buf[NUMBUFLEN];
Ben Jacksonea19e782024-11-06 21:50:05 +01009877 dict_T *locals;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009878
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009879 if (check_restricted() || check_secure())
9880 return;
9881
Ben Jacksonea19e782024-11-06 21:50:05 +01009882 if (in_vim9script() && (
9883 check_for_string_arg(argvars, 0) == FAIL ||
9884 check_for_opt_dict_arg(argvars, 1) == FAIL ) )
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009885 return;
9886
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009887 if (p_pyx == 0)
9888 p_pyx = 2;
9889
Ben Jacksonea19e782024-11-06 21:50:05 +01009890 if (argvars[1].v_type == VAR_DICT)
9891 {
9892 locals = argvars[1].vval.v_dict;
9893 }
9894 else if (argvars[1].v_type != VAR_UNKNOWN)
9895 {
9896 emsg( "Invalid argument: must be dict" );
9897 return;
9898 }
9899 else
9900 {
9901 locals = NULL;
9902 }
9903
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009904 str = tv_get_string_buf(&argvars[0], buf);
Ben Jacksonea19e782024-11-06 21:50:05 +01009905 do_pyeval(str, locals, rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009906}
9907#endif
9908
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009909#if defined(FEAT_PYTHON) || defined(FEAT_PYTHON3)
9910/*
9911 * "pyxeval()" function
9912 */
9913 static void
9914f_pyxeval(typval_T *argvars, typval_T *rettv)
9915{
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009916 if (check_restricted() || check_secure())
9917 return;
9918
Ben Jacksonea19e782024-11-06 21:50:05 +01009919 if (in_vim9script()
9920 && (check_for_string_arg(argvars, 0) == FAIL
9921 || check_for_opt_dict_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009922 return;
9923
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009924# if defined(FEAT_PYTHON) && defined(FEAT_PYTHON3)
9925 init_pyxversion();
9926 if (p_pyx == 2)
9927 f_pyeval(argvars, rettv);
9928 else
9929 f_py3eval(argvars, rettv);
9930# elif defined(FEAT_PYTHON)
9931 f_pyeval(argvars, rettv);
9932# elif defined(FEAT_PYTHON3)
9933 f_py3eval(argvars, rettv);
9934# endif
9935}
9936#endif
9937
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009938static UINT32_T srand_seed_for_testing = 0;
9939static int srand_seed_for_testing_is_used = FALSE;
9940
9941 static void
9942f_test_srand_seed(typval_T *argvars, typval_T *rettv UNUSED)
9943{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009944 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
9945 return;
9946
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009947 if (argvars[0].v_type == VAR_UNKNOWN)
Bram Moolenaar7633fe52020-06-22 19:10:56 +02009948 srand_seed_for_testing_is_used = FALSE;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009949 else
9950 {
Bram Moolenaar7633fe52020-06-22 19:10:56 +02009951 srand_seed_for_testing = (UINT32_T)tv_get_number(&argvars[0]);
9952 srand_seed_for_testing_is_used = TRUE;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009953 }
9954}
9955
9956 static void
9957init_srand(UINT32_T *x)
9958{
LemonBoy9987fe82024-07-04 13:20:49 +02009959 struct {
9960 union {
9961 UINT32_T number;
9962 char_u bytes[sizeof(UINT32_T)];
9963 } contents;
9964 } buf;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009965
9966 if (srand_seed_for_testing_is_used)
9967 {
Bram Moolenaar7633fe52020-06-22 19:10:56 +02009968 *x = srand_seed_for_testing;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009969 return;
9970 }
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009971
LemonBoy9987fe82024-07-04 13:20:49 +02009972 if (mch_get_random(buf.contents.bytes, sizeof(buf.contents.bytes)) == OK)
9973 {
9974 *x = buf.contents.number;
9975 return;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009976 }
LemonBoy9987fe82024-07-04 13:20:49 +02009977
9978 // The system's random number generator doesn't work, fall back to:
9979 // - randombytes_random()
9980 // - reltime() or time()
9981 // - XOR with process ID
9982#if defined(FEAT_SODIUM)
9983 if (crypt_sodium_init() >= 0)
9984 *x = crypt_sodium_randombytes_random();
9985 else
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009986#endif
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009987 {
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009988#if defined(FEAT_RELTIME)
LemonBoy9987fe82024-07-04 13:20:49 +02009989 proftime_T res;
9990 profile_start(&res);
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009991# if defined(MSWIN)
LemonBoy9987fe82024-07-04 13:20:49 +02009992 *x = (UINT32_T)res.LowPart;
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009993# else
LemonBoy9987fe82024-07-04 13:20:49 +02009994 *x = (UINT32_T)res.tv_fsec;
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009995# endif
9996#else
LemonBoy9987fe82024-07-04 13:20:49 +02009997 *x = vim_time();
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009998#endif
LemonBoy9987fe82024-07-04 13:20:49 +02009999 *x ^= mch_get_pid();
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +000010000 }
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010001}
10002
kylo252ae6f1d82022-02-16 19:24:07 +000010003#define ROTL(x, k) (((x) << (k)) | ((x) >> (32 - (k))))
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010004#define SPLITMIX32(x, z) ( \
kylo252ae6f1d82022-02-16 19:24:07 +000010005 (z) = ((x) += 0x9e3779b9), \
10006 (z) = ((z) ^ ((z) >> 16)) * 0x85ebca6b, \
10007 (z) = ((z) ^ ((z) >> 13)) * 0xc2b2ae35, \
10008 (z) ^ ((z) >> 16) \
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010009 )
10010#define SHUFFLE_XOSHIRO128STARSTAR(x, y, z, w) \
kylo252ae6f1d82022-02-16 19:24:07 +000010011 result = ROTL((y) * 5, 7) * 9; \
10012 t = (y) << 9; \
10013 (z) ^= (x); \
10014 (w) ^= (y); \
10015 (y) ^= (z), (x) ^= (w); \
10016 (z) ^= t; \
10017 (w) = ROTL(w, 11);
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010018
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010019/*
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010020 * "rand()" function
10021 */
10022 static void
10023f_rand(typval_T *argvars, typval_T *rettv)
10024{
10025 list_T *l = NULL;
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010026 static UINT32_T gx, gy, gz, gw;
10027 static int initialized = FALSE;
Bram Moolenaarf8c1f922019-11-28 22:13:14 +010010028 listitem_T *lx, *ly, *lz, *lw;
Bram Moolenaar0fd797e2020-11-05 20:46:32 +010010029 UINT32_T x = 0, y, z, w, t, result;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010030
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010031 if (in_vim9script() && check_for_opt_list_arg(argvars, 0) == FAIL)
10032 return;
10033
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010034 if (argvars[0].v_type == VAR_UNKNOWN)
10035 {
Bram Moolenaarf8c1f922019-11-28 22:13:14 +010010036 // When no argument is given use the global seed list.
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010037 if (initialized == FALSE)
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010038 {
Bram Moolenaarf8c1f922019-11-28 22:13:14 +010010039 // Initialize the global seed list.
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010040 init_srand(&x);
10041
10042 gx = SPLITMIX32(x, z);
10043 gy = SPLITMIX32(x, z);
10044 gz = SPLITMIX32(x, z);
10045 gw = SPLITMIX32(x, z);
10046 initialized = TRUE;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010047 }
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010048
10049 SHUFFLE_XOSHIRO128STARSTAR(gx, gy, gz, gw);
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010050 }
10051 else if (argvars[0].v_type == VAR_LIST)
10052 {
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010053 l = argvars[0].vval.v_list;
Bram Moolenaarf8c1f922019-11-28 22:13:14 +010010054 if (l == NULL || list_len(l) != 4)
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010055 goto theend;
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010056
10057 lx = list_find(l, 0L);
10058 ly = list_find(l, 1L);
10059 lz = list_find(l, 2L);
10060 lw = list_find(l, 3L);
10061 if (lx->li_tv.v_type != VAR_NUMBER) goto theend;
10062 if (ly->li_tv.v_type != VAR_NUMBER) goto theend;
10063 if (lz->li_tv.v_type != VAR_NUMBER) goto theend;
10064 if (lw->li_tv.v_type != VAR_NUMBER) goto theend;
10065 x = (UINT32_T)lx->li_tv.vval.v_number;
10066 y = (UINT32_T)ly->li_tv.vval.v_number;
10067 z = (UINT32_T)lz->li_tv.vval.v_number;
10068 w = (UINT32_T)lw->li_tv.vval.v_number;
10069
10070 SHUFFLE_XOSHIRO128STARSTAR(x, y, z, w);
10071
10072 lx->li_tv.vval.v_number = (varnumber_T)x;
10073 ly->li_tv.vval.v_number = (varnumber_T)y;
10074 lz->li_tv.vval.v_number = (varnumber_T)z;
10075 lw->li_tv.vval.v_number = (varnumber_T)w;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010076 }
10077 else
10078 goto theend;
10079
10080 rettv->v_type = VAR_NUMBER;
Bram Moolenaarf8c1f922019-11-28 22:13:14 +010010081 rettv->vval.v_number = (varnumber_T)result;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010082 return;
10083
10084theend:
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010085 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[0]));
Bram Moolenaarf8c1f922019-11-28 22:13:14 +010010086 rettv->v_type = VAR_NUMBER;
10087 rettv->vval.v_number = -1;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010088}
10089
10090/*
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010091 * "srand()" function
10092 */
10093 static void
10094f_srand(typval_T *argvars, typval_T *rettv)
10095{
10096 UINT32_T x = 0, z;
10097
10098 if (rettv_list_alloc(rettv) == FAIL)
10099 return;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010100
10101 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
10102 return;
10103
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010104 if (argvars[0].v_type == VAR_UNKNOWN)
10105 {
10106 init_srand(&x);
10107 }
10108 else
10109 {
10110 int error = FALSE;
10111
10112 x = (UINT32_T)tv_get_number_chk(&argvars[0], &error);
10113 if (error)
10114 return;
10115 }
10116
10117 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
10118 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
10119 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
10120 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
10121}
10122
10123#undef ROTL
10124#undef SPLITMIX32
10125#undef SHUFFLE_XOSHIRO128STARSTAR
10126
10127/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010128 * "range()" function
10129 */
10130 static void
10131f_range(typval_T *argvars, typval_T *rettv)
10132{
10133 varnumber_T start;
10134 varnumber_T end;
10135 varnumber_T stride = 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010136 int error = FALSE;
10137
Bram Moolenaar93a10962022-06-16 11:42:09 +010010138 if (rettv_list_alloc(rettv) == FAIL)
Yegappan Lakshmananca195cc2022-06-14 13:42:26 +010010139 return;
10140
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010141 if (in_vim9script()
10142 && (check_for_number_arg(argvars, 0) == FAIL
10143 || check_for_opt_number_arg(argvars, 1) == FAIL
10144 || (argvars[1].v_type != VAR_UNKNOWN
10145 && check_for_opt_number_arg(argvars, 2) == FAIL)))
10146 return;
10147
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010148 start = tv_get_number_chk(&argvars[0], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010149 if (argvars[1].v_type == VAR_UNKNOWN)
10150 {
10151 end = start - 1;
10152 start = 0;
10153 }
10154 else
10155 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010156 end = tv_get_number_chk(&argvars[1], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010157 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010158 stride = tv_get_number_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010159 }
10160
10161 if (error)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010162 return; // type error; errmsg already given
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010163 if (stride == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010164 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010165 emsg(_(e_stride_is_zero));
10166 return;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010010167 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010168 if (stride > 0 ? end + 1 < start : end - 1 > start)
10169 {
10170 emsg(_(e_start_past_end));
10171 return;
10172 }
10173
10174 list_T *list = rettv->vval.v_list;
10175
10176 // Create a non-materialized list. This is much more efficient and
10177 // works with ":for". If used otherwise CHECK_LIST_MATERIALIZE() must
10178 // be called.
10179 list->lv_first = &range_list_item;
10180 list->lv_u.nonmat.lv_start = start;
10181 list->lv_u.nonmat.lv_end = end;
10182 list->lv_u.nonmat.lv_stride = stride;
Christian Brabandtdf63da92023-11-23 20:14:28 +010010183 if (stride > 0 ? end < start : end > start)
10184 list->lv_len = 0;
10185 else
10186 list->lv_len = (end - start) / stride + 1;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010010187}
10188
10189/*
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020010190 * Materialize "list".
10191 * Do not call directly, use CHECK_LIST_MATERIALIZE()
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010010192 */
10193 void
10194range_list_materialize(list_T *list)
10195{
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020010196 varnumber_T start = list->lv_u.nonmat.lv_start;
10197 varnumber_T end = list->lv_u.nonmat.lv_end;
Bram Moolenaar70c43d82022-01-26 21:01:15 +000010198 int stride = list->lv_u.nonmat.lv_stride;
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020010199 varnumber_T i;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010010200
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020010201 list->lv_first = NULL;
10202 list->lv_u.mat.lv_last = NULL;
10203 list->lv_len = 0;
10204 list->lv_u.mat.lv_idx_item = NULL;
10205 for (i = start; stride > 0 ? i <= end : i >= end; i += stride)
Bram Moolenaar70c43d82022-01-26 21:01:15 +000010206 {
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +000010207 if (list_append_number(list, i) == FAIL)
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020010208 break;
Bram Moolenaar70c43d82022-01-26 21:01:15 +000010209 if (list->lv_lock & VAR_ITEMS_LOCKED)
10210 list->lv_u.mat.lv_last->li_tv.v_lock = VAR_LOCKED;
10211 }
10212 list->lv_lock &= ~VAR_ITEMS_LOCKED;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010213}
10214
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010215/*
10216 * "getreginfo()" function
10217 */
10218 static void
10219f_getreginfo(typval_T *argvars, typval_T *rettv)
10220{
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010221 int regname;
10222 char_u buf[NUMBUFLEN + 2];
10223 long reglen = 0;
10224 dict_T *dict;
10225 list_T *list;
10226
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010227 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
10228 return;
10229
zeertzjqd3f00f52021-12-24 12:02:43 +000010230 regname = getreg_get_regname(argvars);
10231 if (regname == 0)
10232 return;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010233
zeertzjqd3f00f52021-12-24 12:02:43 +000010234 if (regname == '@')
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010235 regname = '"';
10236
10237 if (rettv_dict_alloc(rettv) == FAIL)
10238 return;
10239 dict = rettv->vval.v_dict;
10240
10241 list = (list_T *)get_reg_contents(regname, GREG_EXPR_SRC | GREG_LIST);
10242 if (list == NULL)
10243 return;
Bram Moolenaar91639192020-06-29 19:55:58 +020010244 (void)dict_add_list(dict, "regcontents", list);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010245
10246 buf[0] = NUL;
10247 buf[1] = NUL;
10248 switch (get_reg_type(regname, &reglen))
10249 {
10250 case MLINE: buf[0] = 'V'; break;
10251 case MCHAR: buf[0] = 'v'; break;
10252 case MBLOCK:
10253 vim_snprintf((char *)buf, sizeof(buf), "%c%ld", Ctrl_V,
10254 reglen + 1);
10255 break;
10256 }
Bram Moolenaar91639192020-06-29 19:55:58 +020010257 (void)dict_add_string(dict, (char *)"regtype", buf);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010258
10259 buf[0] = get_register_name(get_unname_register());
10260 buf[1] = NUL;
10261 if (regname == '"')
Bram Moolenaar91639192020-06-29 19:55:58 +020010262 (void)dict_add_string(dict, (char *)"points_to", buf);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010263 else
10264 {
10265 dictitem_T *item = dictitem_alloc((char_u *)"isunnamed");
10266
10267 if (item != NULL)
10268 {
Bram Moolenaar82946e12022-11-24 11:31:29 +000010269 item->di_tv.v_type = VAR_BOOL;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010270 item->di_tv.vval.v_number = regname == buf[0]
Bram Moolenaar418a29f2021-02-10 22:23:41 +010010271 ? VVAL_TRUE : VVAL_FALSE;
Bram Moolenaar91639192020-06-29 19:55:58 +020010272 (void)dict_add(dict, item);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010273 }
10274 }
10275}
10276
Bram Moolenaar0b6d9112018-05-22 20:35:17 +020010277 static void
10278return_register(int regname, typval_T *rettv)
10279{
10280 char_u buf[2] = {0, 0};
10281
10282 buf[0] = (char_u)regname;
10283 rettv->v_type = VAR_STRING;
10284 rettv->vval.v_string = vim_strsave(buf);
10285}
10286
10287/*
10288 * "reg_executing()" function
10289 */
10290 static void
10291f_reg_executing(typval_T *argvars UNUSED, typval_T *rettv)
10292{
10293 return_register(reg_executing, rettv);
10294}
10295
10296/*
10297 * "reg_recording()" function
10298 */
10299 static void
10300f_reg_recording(typval_T *argvars UNUSED, typval_T *rettv)
10301{
10302 return_register(reg_recording, rettv);
10303}
10304
Bram Moolenaar7416f3e2017-03-18 18:10:13 +010010305/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010306 * "rename({from}, {to})" function
10307 */
10308 static void
10309f_rename(typval_T *argvars, typval_T *rettv)
10310{
10311 char_u buf[NUMBUFLEN];
10312
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010313 rettv->vval.v_number = -1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010314 if (check_restricted() || check_secure())
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010315 return;
10316
10317 if (in_vim9script()
10318 && (check_for_string_arg(argvars, 0) == FAIL
10319 || check_for_string_arg(argvars, 1) == FAIL))
10320 return;
10321
10322 rettv->vval.v_number = vim_rename(tv_get_string(&argvars[0]),
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010323 tv_get_string_buf(&argvars[1], buf));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010324}
10325
10326/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010327 * Repeat the list "l" "n" times and set "rettv" to the new list.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010328 */
10329 static void
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010330repeat_list(list_T *l, int n, typval_T *rettv)
10331{
10332 if (rettv_list_alloc(rettv) == FAIL
10333 || l == NULL
10334 || n <= 0)
10335 return;
10336
10337 while (n-- > 0)
10338 if (list_extend(rettv->vval.v_list, l, NULL) == FAIL)
10339 break;
10340}
10341
10342/*
10343 * Repeat the blob "b" "n" times and set "rettv" to the new blob.
10344 */
10345 static void
10346repeat_blob(typval_T *blob_tv, int n, typval_T *rettv)
10347{
10348 int slen;
10349 int len;
10350 int i;
10351 blob_T *blob = blob_tv->vval.v_blob;
10352
10353 if (rettv_blob_alloc(rettv) == FAIL
10354 || blob == NULL
10355 || n <= 0)
10356 return;
10357
10358 slen = blob->bv_ga.ga_len;
10359 len = (int)slen * n;
10360 if (len <= 0)
10361 return;
10362
10363 if (ga_grow(&rettv->vval.v_blob->bv_ga, len) == FAIL)
10364 return;
10365
10366 rettv->vval.v_blob->bv_ga.ga_len = len;
10367
10368 for (i = 0; i < slen; ++i)
10369 if (blob_get(blob, i) != 0)
10370 break;
10371
10372 if (i == slen)
10373 // No need to copy since all bytes are already zero
10374 return;
10375
10376 for (i = 0; i < n; ++i)
10377 blob_set_range(rettv->vval.v_blob,
10378 (long)i * slen, ((long)i + 1) * slen - 1, blob_tv);
10379}
10380
10381/*
10382 * Repeat the string "str" "n" times and set "rettv" to the new string.
10383 */
10384 static void
10385repeat_string(typval_T *str_tv, int n, typval_T *rettv)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010386{
10387 char_u *p;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010388 int slen;
10389 int len;
10390 char_u *r;
10391 int i;
10392
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010393 p = tv_get_string(str_tv);
10394 rettv->v_type = VAR_STRING;
10395 rettv->vval.v_string = NULL;
10396
10397 slen = (int)STRLEN(p);
10398 len = slen * n;
10399 if (len <= 0)
10400 return;
10401
10402 r = alloc(len + 1);
10403 if (r == NULL)
10404 return;
10405
10406 for (i = 0; i < n; i++)
10407 mch_memmove(r + i * slen, p, (size_t)slen);
10408 r[len] = NUL;
10409
10410 rettv->vval.v_string = r;
10411}
10412
10413/*
10414 * "repeat()" function
10415 */
10416 static void
10417f_repeat(typval_T *argvars, typval_T *rettv)
10418{
10419 varnumber_T n;
10420
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +020010421 if (in_vim9script()
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010422 && (check_for_repeat_func_arg(argvars, 0) == FAIL
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010423 || check_for_number_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +020010424 return;
10425
Bakudankun375141e2022-09-09 18:46:47 +010010426 n = tv_get_number(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010427 if (argvars[0].v_type == VAR_LIST)
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010428 repeat_list(argvars[0].vval.v_list, n, rettv);
10429 else if (argvars[0].v_type == VAR_TUPLE)
10430 tuple_repeat(argvars[0].vval.v_tuple, n, rettv);
Bakudankun375141e2022-09-09 18:46:47 +010010431 else if (argvars[0].v_type == VAR_BLOB)
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010432 repeat_blob(&argvars[0], n, rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010433 else
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010434 repeat_string(&argvars[0], n, rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010435}
10436
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010437#define SP_NOMOVE 0x01 // don't move cursor
10438#define SP_REPEAT 0x02 // repeat to find outer pair
10439#define SP_RETCOUNT 0x04 // return matchcount
10440#define SP_SETPCMARK 0x08 // set previous context mark
10441#define SP_START 0x10 // accept match at start position
10442#define SP_SUBPAT 0x20 // return nr of matching sub-pattern
10443#define SP_END 0x40 // leave cursor at end of match
10444#define SP_COLUMN 0x80 // start at cursor column
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010445
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010446/*
10447 * Get flags for a search function.
10448 * Possibly sets "p_ws".
10449 * Returns BACKWARD, FORWARD or zero (for an error).
10450 */
10451 static int
10452get_search_arg(typval_T *varp, int *flagsp)
10453{
10454 int dir = FORWARD;
10455 char_u *flags;
10456 char_u nbuf[NUMBUFLEN];
10457 int mask;
10458
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010459 if (varp->v_type == VAR_UNKNOWN)
10460 return FORWARD;
10461
10462 flags = tv_get_string_buf_chk(varp, nbuf);
10463 if (flags == NULL)
10464 return 0; // type error; errmsg already given
10465 while (*flags != NUL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010466 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010467 switch (*flags)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010468 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010469 case 'b': dir = BACKWARD; break;
10470 case 'w': p_ws = TRUE; break;
10471 case 'W': p_ws = FALSE; break;
10472 default: mask = 0;
10473 if (flagsp != NULL)
10474 switch (*flags)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010475 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010476 case 'c': mask = SP_START; break;
10477 case 'e': mask = SP_END; break;
10478 case 'm': mask = SP_RETCOUNT; break;
10479 case 'n': mask = SP_NOMOVE; break;
10480 case 'p': mask = SP_SUBPAT; break;
10481 case 'r': mask = SP_REPEAT; break;
10482 case 's': mask = SP_SETPCMARK; break;
10483 case 'z': mask = SP_COLUMN; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010484 }
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010485 if (mask == 0)
10486 {
10487 semsg(_(e_invalid_argument_str), flags);
10488 dir = 0;
10489 }
10490 else
10491 *flagsp |= mask;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010492 }
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010493 if (dir == 0)
10494 break;
10495 ++flags;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010496 }
10497 return dir;
10498}
10499
10500/*
10501 * Shared by search() and searchpos() functions.
10502 */
10503 static int
10504search_cmn(typval_T *argvars, pos_T *match_pos, int *flagsp)
10505{
10506 int flags;
10507 char_u *pat;
John Marriott8c85a2a2024-05-20 19:18:26 +020010508 size_t patlen;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010509 pos_T pos;
10510 pos_T save_cursor;
10511 int save_p_ws = p_ws;
10512 int dir;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010513 int retval = 0; // default: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010514 long lnum_stop = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010515#ifdef FEAT_RELTIME
10516 long time_limit = 0;
10517#endif
10518 int options = SEARCH_KEEP;
10519 int subpatnum;
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010520 searchit_arg_T sia;
Bram Moolenaara9c01042020-06-07 14:50:50 +020010521 int use_skip = FALSE;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010522 pos_T firstpos;
10523
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +020010524 if (in_vim9script()
10525 && (check_for_string_arg(argvars, 0) == FAIL
10526 || check_for_opt_string_arg(argvars, 1) == FAIL
10527 || (argvars[1].v_type != VAR_UNKNOWN
10528 && (check_for_opt_number_arg(argvars, 2) == FAIL
10529 || (argvars[2].v_type != VAR_UNKNOWN
10530 && check_for_opt_number_arg(argvars, 3) == FAIL)))))
10531 goto theend;
10532
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010533 pat = tv_get_string(&argvars[0]);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010534 dir = get_search_arg(&argvars[1], flagsp); // may set p_ws
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010535 if (dir == 0)
10536 goto theend;
10537 flags = *flagsp;
10538 if (flags & SP_START)
10539 options |= SEARCH_START;
10540 if (flags & SP_END)
10541 options |= SEARCH_END;
10542 if (flags & SP_COLUMN)
10543 options |= SEARCH_COL;
10544
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010545 // Optional arguments: line number to stop searching, timeout and skip.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010546 if (argvars[1].v_type != VAR_UNKNOWN && argvars[2].v_type != VAR_UNKNOWN)
10547 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010548 lnum_stop = (long)tv_get_number_chk(&argvars[2], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010549 if (lnum_stop < 0)
10550 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010551 if (argvars[3].v_type != VAR_UNKNOWN)
10552 {
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010553#ifdef FEAT_RELTIME
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010554 time_limit = (long)tv_get_number_chk(&argvars[3], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010555 if (time_limit < 0)
10556 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010557#endif
Bram Moolenaara9c01042020-06-07 14:50:50 +020010558 use_skip = eval_expr_valid_arg(&argvars[4]);
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010559 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010560 }
10561
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010562 /*
10563 * This function does not accept SP_REPEAT and SP_RETCOUNT flags.
10564 * Check to make sure only those flags are set.
10565 * Also, Only the SP_NOMOVE or the SP_SETPCMARK flag can be set. Both
10566 * flags cannot be set. Check for that condition also.
10567 */
10568 if (((flags & (SP_REPEAT | SP_RETCOUNT)) != 0)
10569 || ((flags & SP_NOMOVE) && (flags & SP_SETPCMARK)))
10570 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010571 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[1]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010572 goto theend;
10573 }
10574
10575 pos = save_cursor = curwin->w_cursor;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010576 CLEAR_FIELD(firstpos);
Bram Moolenaara80faa82020-04-12 19:37:17 +020010577 CLEAR_FIELD(sia);
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010578 sia.sa_stop_lnum = (linenr_T)lnum_stop;
10579#ifdef FEAT_RELTIME
Paul Ollis65745772022-06-05 16:55:54 +010010580 sia.sa_tm = time_limit;
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010581#endif
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010582
John Marriott8c85a2a2024-05-20 19:18:26 +020010583 patlen = STRLEN(pat);
10584
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010585 // Repeat until {skip} returns FALSE.
10586 for (;;)
10587 {
John Marriott8c85a2a2024-05-20 19:18:26 +020010588 subpatnum = searchit(curwin, curbuf, &pos, NULL, dir, pat, patlen, 1L,
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010589 options, RE_SEARCH, &sia);
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010590 // finding the first match again means there is no match where {skip}
10591 // evaluates to zero.
10592 if (firstpos.lnum != 0 && EQUAL_POS(pos, firstpos))
10593 subpatnum = FAIL;
10594
Bram Moolenaara9c01042020-06-07 14:50:50 +020010595 if (subpatnum == FAIL || !use_skip)
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010596 // didn't find it or no skip argument
10597 break;
Bram Moolenaar3d79f0a2023-01-22 20:14:26 +000010598 if (firstpos.lnum == 0)
10599 firstpos = pos;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010600
Bram Moolenaara9c01042020-06-07 14:50:50 +020010601 // If the skip expression matches, ignore this match.
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010602 {
10603 int do_skip;
10604 int err;
10605 pos_T save_pos = curwin->w_cursor;
10606
10607 curwin->w_cursor = pos;
Bram Moolenaara9c01042020-06-07 14:50:50 +020010608 err = FALSE;
10609 do_skip = eval_expr_to_bool(&argvars[4], &err);
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010610 curwin->w_cursor = save_pos;
10611 if (err)
10612 {
10613 // Evaluating {skip} caused an error, break here.
10614 subpatnum = FAIL;
10615 break;
10616 }
10617 if (!do_skip)
10618 break;
10619 }
zeertzjq180246c2022-06-23 12:04:46 +010010620
10621 // clear the start flag to avoid getting stuck here
10622 options &= ~SEARCH_START;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010623 }
10624
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010625 if (subpatnum != FAIL)
10626 {
10627 if (flags & SP_SUBPAT)
10628 retval = subpatnum;
10629 else
10630 retval = pos.lnum;
10631 if (flags & SP_SETPCMARK)
10632 setpcmark();
10633 curwin->w_cursor = pos;
10634 if (match_pos != NULL)
10635 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010636 // Store the match cursor position
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010637 match_pos->lnum = pos.lnum;
10638 match_pos->col = pos.col + 1;
10639 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010640 // "/$" will put the cursor after the end of the line, may need to
10641 // correct that here
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010642 check_cursor();
10643 }
10644
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010645 // If 'n' flag is used: restore cursor position.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010646 if (flags & SP_NOMOVE)
10647 curwin->w_cursor = save_cursor;
10648 else
10649 curwin->w_set_curswant = TRUE;
10650theend:
10651 p_ws = save_p_ws;
10652
10653 return retval;
10654}
10655
Bram Moolenaare99be0e2019-03-26 22:51:09 +010010656#ifdef FEAT_RUBY
10657/*
10658 * "rubyeval()" function
10659 */
10660 static void
10661f_rubyeval(typval_T *argvars, typval_T *rettv)
10662{
10663 char_u *str;
10664 char_u buf[NUMBUFLEN];
10665
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010666 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
10667 return;
10668
Bram Moolenaare99be0e2019-03-26 22:51:09 +010010669 str = tv_get_string_buf(&argvars[0], buf);
10670 do_rubyeval(str, rettv);
10671}
10672#endif
10673
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010674/*
10675 * "screenattr()" function
10676 */
10677 static void
10678f_screenattr(typval_T *argvars, typval_T *rettv)
10679{
10680 int row;
10681 int col;
10682 int c;
10683
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010684 if (in_vim9script()
10685 && (check_for_number_arg(argvars, 0) == FAIL
10686 || check_for_number_arg(argvars, 1) == FAIL))
10687 return;
10688
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010689 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10690 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010691 if (row < 0 || row >= screen_Rows
10692 || col < 0 || col >= screen_Columns)
10693 c = -1;
10694 else
10695 c = ScreenAttrs[LineOffset[row] + col];
10696 rettv->vval.v_number = c;
10697}
10698
10699/*
10700 * "screenchar()" function
10701 */
10702 static void
10703f_screenchar(typval_T *argvars, typval_T *rettv)
10704{
10705 int row;
10706 int col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010707 int c;
10708
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010709 if (in_vim9script()
10710 && (check_for_number_arg(argvars, 0) == FAIL
10711 || check_for_number_arg(argvars, 1) == FAIL))
10712 return;
10713
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010714 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10715 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010716 if (row < 0 || row >= screen_Rows || col < 0 || col >= screen_Columns)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010717 c = -1;
10718 else
10719 {
zeertzjq47eec672023-06-01 20:26:55 +010010720 char_u buf[MB_MAXBYTES + 1];
10721 screen_getbytes(row, col, buf, NULL);
10722 c = (*mb_ptr2char)(buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010723 }
10724 rettv->vval.v_number = c;
10725}
10726
10727/*
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010728 * "screenchars()" function
10729 */
10730 static void
10731f_screenchars(typval_T *argvars, typval_T *rettv)
10732{
10733 int row;
10734 int col;
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010735 int c;
10736 int i;
10737
10738 if (rettv_list_alloc(rettv) == FAIL)
10739 return;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010740
10741 if (in_vim9script()
10742 && (check_for_number_arg(argvars, 0) == FAIL
10743 || check_for_number_arg(argvars, 1) == FAIL))
10744 return;
10745
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010746 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10747 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
10748 if (row < 0 || row >= screen_Rows || col < 0 || col >= screen_Columns)
10749 return;
10750
zeertzjq47eec672023-06-01 20:26:55 +010010751 char_u buf[MB_MAXBYTES + 1];
10752 screen_getbytes(row, col, buf, NULL);
10753 int pcc[MAX_MCO];
10754 if (enc_utf8)
10755 c = utfc_ptr2char(buf, pcc);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010756 else
zeertzjq47eec672023-06-01 20:26:55 +010010757 c = (*mb_ptr2char)(buf);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010758 list_append_number(rettv->vval.v_list, (varnumber_T)c);
10759
10760 if (enc_utf8)
zeertzjq47eec672023-06-01 20:26:55 +010010761 for (i = 0; i < Screen_mco && pcc[i] != 0; ++i)
10762 list_append_number(rettv->vval.v_list, (varnumber_T)pcc[i]);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010763}
10764
10765/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010766 * "screencol()" function
10767 *
10768 * First column is 1 to be consistent with virtcol().
10769 */
10770 static void
10771f_screencol(typval_T *argvars UNUSED, typval_T *rettv)
10772{
10773 rettv->vval.v_number = screen_screencol() + 1;
10774}
10775
10776/*
10777 * "screenrow()" function
10778 */
10779 static void
10780f_screenrow(typval_T *argvars UNUSED, typval_T *rettv)
10781{
10782 rettv->vval.v_number = screen_screenrow() + 1;
10783}
10784
10785/*
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010786 * "screenstring()" function
10787 */
10788 static void
10789f_screenstring(typval_T *argvars, typval_T *rettv)
10790{
10791 int row;
10792 int col;
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010793 char_u buf[MB_MAXBYTES + 1];
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010794
10795 rettv->vval.v_string = NULL;
10796 rettv->v_type = VAR_STRING;
10797
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010798 if (in_vim9script()
10799 && (check_for_number_arg(argvars, 0) == FAIL
10800 || check_for_number_arg(argvars, 1) == FAIL))
10801 return;
10802
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010803 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10804 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
10805 if (row < 0 || row >= screen_Rows || col < 0 || col >= screen_Columns)
10806 return;
10807
zeertzjq47eec672023-06-01 20:26:55 +010010808 screen_getbytes(row, col, buf, NULL);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010809 rettv->vval.v_string = vim_strsave(buf);
10810}
10811
10812/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010813 * "search()" function
10814 */
10815 static void
10816f_search(typval_T *argvars, typval_T *rettv)
10817{
10818 int flags = 0;
10819
10820 rettv->vval.v_number = search_cmn(argvars, NULL, &flags);
10821}
10822
10823/*
10824 * "searchdecl()" function
10825 */
10826 static void
10827f_searchdecl(typval_T *argvars, typval_T *rettv)
10828{
Bram Moolenaar30788d32020-09-05 21:35:16 +020010829 int locally = TRUE;
10830 int thisblock = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010831 int error = FALSE;
10832 char_u *name;
10833
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010834 rettv->vval.v_number = 1; // default: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010835
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020010836 if (in_vim9script()
10837 && (check_for_string_arg(argvars, 0) == FAIL
10838 || check_for_opt_bool_arg(argvars, 1) == FAIL
10839 || (argvars[1].v_type != VAR_UNKNOWN
10840 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
10841 return;
10842
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010843 name = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010844 if (argvars[1].v_type != VAR_UNKNOWN)
10845 {
Bram Moolenaar30788d32020-09-05 21:35:16 +020010846 locally = !(int)tv_get_bool_chk(&argvars[1], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010847 if (!error && argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar30788d32020-09-05 21:35:16 +020010848 thisblock = (int)tv_get_bool_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010849 }
10850 if (!error && name != NULL)
10851 rettv->vval.v_number = find_decl(name, (int)STRLEN(name),
10852 locally, thisblock, SEARCH_KEEP) == FAIL;
10853}
10854
10855/*
10856 * Used by searchpair() and searchpairpos()
10857 */
10858 static int
10859searchpair_cmn(typval_T *argvars, pos_T *match_pos)
10860{
10861 char_u *spat, *mpat, *epat;
Bram Moolenaar48570482017-10-30 21:48:41 +010010862 typval_T *skip;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010863 int save_p_ws = p_ws;
10864 int dir;
10865 int flags = 0;
10866 char_u nbuf1[NUMBUFLEN];
10867 char_u nbuf2[NUMBUFLEN];
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010868 int retval = 0; // default: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010869 long lnum_stop = 0;
10870 long time_limit = 0;
10871
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +020010872 if (in_vim9script()
10873 && (check_for_string_arg(argvars, 0) == FAIL
10874 || check_for_string_arg(argvars, 1) == FAIL
10875 || check_for_string_arg(argvars, 2) == FAIL
10876 || check_for_opt_string_arg(argvars, 3) == FAIL
10877 || (argvars[3].v_type != VAR_UNKNOWN
10878 && argvars[4].v_type != VAR_UNKNOWN
10879 && (check_for_opt_number_arg(argvars, 5) == FAIL
10880 || (argvars[5].v_type != VAR_UNKNOWN
10881 && check_for_opt_number_arg(argvars, 6) == FAIL)))))
10882 goto theend;
10883
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010884 // Get the three pattern arguments: start, middle, end. Will result in an
10885 // error if not a valid argument.
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010886 spat = tv_get_string_chk(&argvars[0]);
10887 mpat = tv_get_string_buf_chk(&argvars[1], nbuf1);
10888 epat = tv_get_string_buf_chk(&argvars[2], nbuf2);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010889 if (spat == NULL || mpat == NULL || epat == NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010890 goto theend; // type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010891
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010892 // Handle the optional fourth argument: flags
10893 dir = get_search_arg(&argvars[3], &flags); // may set p_ws
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010894 if (dir == 0)
10895 goto theend;
10896
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010897 // Don't accept SP_END or SP_SUBPAT.
10898 // Only one of the SP_NOMOVE or SP_SETPCMARK flags can be set.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010899 if ((flags & (SP_END | SP_SUBPAT)) != 0
10900 || ((flags & SP_NOMOVE) && (flags & SP_SETPCMARK)))
10901 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010902 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[3]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010903 goto theend;
10904 }
10905
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010906 // Using 'r' implies 'W', otherwise it doesn't work.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010907 if (flags & SP_REPEAT)
10908 p_ws = FALSE;
10909
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010910 // Optional fifth argument: skip expression
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010911 if (argvars[3].v_type == VAR_UNKNOWN
10912 || argvars[4].v_type == VAR_UNKNOWN)
Bram Moolenaar48570482017-10-30 21:48:41 +010010913 skip = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010914 else
10915 {
Bram Moolenaara9c01042020-06-07 14:50:50 +020010916 // Type is checked later.
Bram Moolenaar48570482017-10-30 21:48:41 +010010917 skip = &argvars[4];
Bram Moolenaara9c01042020-06-07 14:50:50 +020010918
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010919 if (argvars[5].v_type != VAR_UNKNOWN)
10920 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010921 lnum_stop = (long)tv_get_number_chk(&argvars[5], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010922 if (lnum_stop < 0)
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010923 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010924 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[5]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010925 goto theend;
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010926 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010927#ifdef FEAT_RELTIME
10928 if (argvars[6].v_type != VAR_UNKNOWN)
10929 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010930 time_limit = (long)tv_get_number_chk(&argvars[6], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010931 if (time_limit < 0)
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010932 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010933 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[6]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010934 goto theend;
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010935 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010936 }
10937#endif
10938 }
10939 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010940
10941 retval = do_searchpair(spat, mpat, epat, dir, skip, flags,
10942 match_pos, lnum_stop, time_limit);
10943
10944theend:
10945 p_ws = save_p_ws;
10946
10947 return retval;
10948}
10949
10950/*
10951 * "searchpair()" function
10952 */
10953 static void
10954f_searchpair(typval_T *argvars, typval_T *rettv)
10955{
10956 rettv->vval.v_number = searchpair_cmn(argvars, NULL);
10957}
10958
10959/*
10960 * "searchpairpos()" function
10961 */
10962 static void
10963f_searchpairpos(typval_T *argvars, typval_T *rettv)
10964{
10965 pos_T match_pos;
10966 int lnum = 0;
10967 int col = 0;
10968
10969 if (rettv_list_alloc(rettv) == FAIL)
10970 return;
10971
10972 if (searchpair_cmn(argvars, &match_pos) > 0)
10973 {
10974 lnum = match_pos.lnum;
10975 col = match_pos.col;
10976 }
10977
10978 list_append_number(rettv->vval.v_list, (varnumber_T)lnum);
10979 list_append_number(rettv->vval.v_list, (varnumber_T)col);
10980}
10981
10982/*
10983 * Search for a start/middle/end thing.
10984 * Used by searchpair(), see its documentation for the details.
10985 * Returns 0 or -1 for no match,
10986 */
10987 long
10988do_searchpair(
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010989 char_u *spat, // start pattern
10990 char_u *mpat, // middle pattern
10991 char_u *epat, // end pattern
10992 int dir, // BACKWARD or FORWARD
10993 typval_T *skip, // skip expression
10994 int flags, // SP_SETPCMARK and other SP_ values
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010995 pos_T *match_pos,
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010996 linenr_T lnum_stop, // stop at this line if not zero
10997 long time_limit UNUSED) // stop after this many msec
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010998{
10999 char_u *save_cpo;
11000 char_u *pat, *pat2 = NULL, *pat3 = NULL;
John Marriott8c85a2a2024-05-20 19:18:26 +020011001 size_t patlen;
11002 size_t spatlen;
11003 size_t epatlen;
11004 size_t pat2size;
11005 size_t pat2len;
11006 size_t pat3size;
11007 size_t pat3len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011008 long retval = 0;
11009 pos_T pos;
11010 pos_T firstpos;
11011 pos_T foundpos;
11012 pos_T save_cursor;
11013 pos_T save_pos;
11014 int n;
11015 int r;
11016 int nest = 1;
Bram Moolenaar48570482017-10-30 21:48:41 +010011017 int use_skip = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011018 int err;
11019 int options = SEARCH_KEEP;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011020
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011021 // Make 'cpoptions' empty, the 'l' flag should not be used here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011022 save_cpo = p_cpo;
11023 p_cpo = empty_option;
11024
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011025 // Make two search patterns: start/end (pat2, for in nested pairs) and
11026 // start/middle/end (pat3, for the top pair).
John Marriott8c85a2a2024-05-20 19:18:26 +020011027 spatlen = STRLEN(spat);
11028 epatlen = STRLEN(epat);
11029 pat2size = spatlen + epatlen + 17;
11030 pat2 = alloc(pat2size);
11031 if (pat2 == NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011032 goto theend;
John Marriott8c85a2a2024-05-20 19:18:26 +020011033 pat3size = spatlen + STRLEN(mpat) + epatlen + 25;
11034 pat3 = alloc(pat3size);
11035 if (pat3 == NULL)
11036 goto theend;
11037 pat2len = vim_snprintf((char *)pat2, pat2size, "\\m\\(%s\\m\\)\\|\\(%s\\m\\)", spat, epat);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011038 if (*mpat == NUL)
John Marriott8c85a2a2024-05-20 19:18:26 +020011039 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011040 STRCPY(pat3, pat2);
John Marriott8c85a2a2024-05-20 19:18:26 +020011041 pat3len = pat2len;
11042 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011043 else
John Marriott8c85a2a2024-05-20 19:18:26 +020011044 pat3len = vim_snprintf((char *)pat3, pat3size, "\\m\\(%s\\m\\)\\|\\(%s\\m\\)\\|\\(%s\\m\\)",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011045 spat, epat, mpat);
11046 if (flags & SP_START)
11047 options |= SEARCH_START;
11048
Bram Moolenaar48570482017-10-30 21:48:41 +010011049 if (skip != NULL)
Bram Moolenaara9c01042020-06-07 14:50:50 +020011050 use_skip = eval_expr_valid_arg(skip);
Bram Moolenaar48570482017-10-30 21:48:41 +010011051
Bram Moolenaar5ea38d12022-06-16 21:20:48 +010011052#ifdef FEAT_RELTIME
11053 if (time_limit > 0)
11054 init_regexp_timeout(time_limit);
11055#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011056 save_cursor = curwin->w_cursor;
11057 pos = curwin->w_cursor;
Bram Moolenaarb5aedf32017-03-12 18:23:53 +010011058 CLEAR_POS(&firstpos);
11059 CLEAR_POS(&foundpos);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011060 pat = pat3;
John Marriott8c85a2a2024-05-20 19:18:26 +020011061 patlen = pat3len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011062 for (;;)
11063 {
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020011064 searchit_arg_T sia;
11065
Bram Moolenaara80faa82020-04-12 19:37:17 +020011066 CLEAR_FIELD(sia);
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020011067 sia.sa_stop_lnum = lnum_stop;
John Marriott8c85a2a2024-05-20 19:18:26 +020011068 n = searchit(curwin, curbuf, &pos, NULL, dir, pat, patlen, 1L,
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020011069 options, RE_SEARCH, &sia);
Bram Moolenaarb5aedf32017-03-12 18:23:53 +010011070 if (n == FAIL || (firstpos.lnum != 0 && EQUAL_POS(pos, firstpos)))
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011071 // didn't find it or found the first match again: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011072 break;
11073
11074 if (firstpos.lnum == 0)
11075 firstpos = pos;
Bram Moolenaarb5aedf32017-03-12 18:23:53 +010011076 if (EQUAL_POS(pos, foundpos))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011077 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011078 // Found the same position again. Can happen with a pattern that
11079 // has "\zs" at the end and searching backwards. Advance one
11080 // character and try again.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011081 if (dir == BACKWARD)
11082 decl(&pos);
11083 else
11084 incl(&pos);
11085 }
11086 foundpos = pos;
11087
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011088 // clear the start flag to avoid getting stuck here
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011089 options &= ~SEARCH_START;
11090
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011091 // If the skip pattern matches, ignore this match.
Bram Moolenaar48570482017-10-30 21:48:41 +010011092 if (use_skip)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011093 {
11094 save_pos = curwin->w_cursor;
11095 curwin->w_cursor = pos;
Bram Moolenaar48570482017-10-30 21:48:41 +010011096 err = FALSE;
11097 r = eval_expr_to_bool(skip, &err);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011098 curwin->w_cursor = save_pos;
11099 if (err)
11100 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011101 // Evaluating {skip} caused an error, break here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011102 curwin->w_cursor = save_cursor;
11103 retval = -1;
11104 break;
11105 }
11106 if (r)
11107 continue;
11108 }
11109
11110 if ((dir == BACKWARD && n == 3) || (dir == FORWARD && n == 2))
11111 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011112 // Found end when searching backwards or start when searching
11113 // forward: nested pair.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011114 ++nest;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011115 pat = pat2; // nested, don't search for middle
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011116 }
11117 else
11118 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011119 // Found end when searching forward or start when searching
11120 // backward: end of (nested) pair; or found middle in outer pair.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011121 if (--nest == 1)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011122 pat = pat3; // outer level, search for middle
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011123 }
11124
11125 if (nest == 0)
11126 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011127 // Found the match: return matchcount or line number.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011128 if (flags & SP_RETCOUNT)
11129 ++retval;
11130 else
11131 retval = pos.lnum;
11132 if (flags & SP_SETPCMARK)
11133 setpcmark();
11134 curwin->w_cursor = pos;
11135 if (!(flags & SP_REPEAT))
11136 break;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011137 nest = 1; // search for next unmatched
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011138 }
11139 }
11140
11141 if (match_pos != NULL)
11142 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011143 // Store the match cursor position
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011144 match_pos->lnum = curwin->w_cursor.lnum;
11145 match_pos->col = curwin->w_cursor.col + 1;
11146 }
11147
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011148 // If 'n' flag is used or search failed: restore cursor position.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011149 if ((flags & SP_NOMOVE) || retval == 0)
11150 curwin->w_cursor = save_cursor;
11151
11152theend:
Bram Moolenaar5ea38d12022-06-16 21:20:48 +010011153#ifdef FEAT_RELTIME
Bram Moolenaar0f618382022-08-26 21:33:04 +010011154 if (time_limit > 0)
11155 disable_regexp_timeout();
Bram Moolenaar5ea38d12022-06-16 21:20:48 +010011156#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011157 vim_free(pat2);
11158 vim_free(pat3);
11159 if (p_cpo == empty_option)
11160 p_cpo = save_cpo;
11161 else
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010011162 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011163 // Darn, evaluating the {skip} expression changed the value.
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010011164 // If it's still empty it was changed and restored, need to restore in
11165 // the complicated way.
11166 if (*p_cpo == NUL)
Bram Moolenaar31e5c602022-04-15 13:53:33 +010011167 set_option_value_give_err((char_u *)"cpo", 0L, save_cpo, 0);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011168 free_string_option(save_cpo);
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010011169 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011170
11171 return retval;
11172}
11173
11174/*
11175 * "searchpos()" function
11176 */
11177 static void
11178f_searchpos(typval_T *argvars, typval_T *rettv)
11179{
11180 pos_T match_pos;
11181 int lnum = 0;
11182 int col = 0;
11183 int n;
11184 int flags = 0;
11185
11186 if (rettv_list_alloc(rettv) == FAIL)
11187 return;
11188
11189 n = search_cmn(argvars, &match_pos, &flags);
11190 if (n > 0)
11191 {
11192 lnum = match_pos.lnum;
11193 col = match_pos.col;
11194 }
11195
11196 list_append_number(rettv->vval.v_list, (varnumber_T)lnum);
11197 list_append_number(rettv->vval.v_list, (varnumber_T)col);
11198 if (flags & SP_SUBPAT)
11199 list_append_number(rettv->vval.v_list, (varnumber_T)n);
11200}
11201
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011202/*
11203 * Set the cursor or mark position.
zeertzjq47eec672023-06-01 20:26:55 +010011204 * If "charpos" is TRUE, then use the column number as a character offset.
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011205 * Otherwise use the column number as a byte offset.
11206 */
11207 static void
11208set_position(typval_T *argvars, typval_T *rettv, int charpos)
11209{
11210 pos_T pos;
11211 int fnum;
11212 char_u *name;
11213 colnr_T curswant = -1;
11214
11215 rettv->vval.v_number = -1;
11216
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011217 if (in_vim9script()
11218 && (check_for_string_arg(argvars, 0) == FAIL
11219 || check_for_list_arg(argvars, 1) == FAIL))
11220 return;
11221
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011222 name = tv_get_string_chk(argvars);
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011223 if (name == NULL)
11224 return;
11225
11226 if (list2fpos(&argvars[1], &pos, &fnum, &curswant, charpos) != OK)
11227 return;
11228
11229 if (pos.col != MAXCOL && --pos.col < 0)
11230 pos.col = 0;
11231 if ((name[0] == '.' && name[1] == NUL))
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011232 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011233 // set cursor; "fnum" is ignored
11234 curwin->w_cursor = pos;
11235 if (curswant >= 0)
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011236 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011237 curwin->w_curswant = curswant - 1;
11238 curwin->w_set_curswant = FALSE;
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011239 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011240 check_cursor();
11241 rettv->vval.v_number = 0;
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011242 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011243 else if (name[0] == '\'' && name[1] != NUL && name[2] == NUL)
11244 {
11245 // set mark
11246 if (setmark_pos(name[1], &pos, fnum) == OK)
11247 rettv->vval.v_number = 0;
11248 }
11249 else
11250 emsg(_(e_invalid_argument));
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011251}
11252/*
11253 * "setcharpos()" function
11254 */
11255 static void
11256f_setcharpos(typval_T *argvars, typval_T *rettv)
11257{
11258 set_position(argvars, rettv, TRUE);
11259}
11260
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011261 static void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011262f_setcharsearch(typval_T *argvars, typval_T *rettv UNUSED)
11263{
11264 dict_T *d;
11265 dictitem_T *di;
11266 char_u *csearch;
11267
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +010011268 if (check_for_dict_arg(argvars, 0) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011269 return;
11270
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011271 if ((d = argvars[0].vval.v_dict) == NULL)
11272 return;
11273
11274 csearch = dict_get_string(d, "char", FALSE);
11275 if (csearch != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011276 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011277 if (enc_utf8)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011278 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011279 int pcc[MAX_MCO];
11280 int c = utfc_ptr2char(csearch, pcc);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011281
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011282 set_last_csearch(c, csearch, utfc_ptr2len(csearch));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011283 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011284 else
11285 set_last_csearch(PTR2CHAR(csearch),
11286 csearch, mb_ptr2len(csearch));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011287 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011288
11289 di = dict_find(d, (char_u *)"forward", -1);
11290 if (di != NULL)
11291 set_csearch_direction((int)tv_get_number(&di->di_tv)
11292 ? FORWARD : BACKWARD);
11293
11294 di = dict_find(d, (char_u *)"until", -1);
11295 if (di != NULL)
11296 set_csearch_until(!!tv_get_number(&di->di_tv));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011297}
11298
11299/*
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011300 * "setcursorcharpos" function
11301 */
11302 static void
Bram Moolenaar3af15ab2021-01-17 16:16:23 +010011303f_setcursorcharpos(typval_T *argvars, typval_T *rettv)
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011304{
11305 set_cursorpos(argvars, rettv, TRUE);
11306}
11307
11308/*
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011309 * "setenv()" function
11310 */
11311 static void
11312f_setenv(typval_T *argvars, typval_T *rettv UNUSED)
11313{
11314 char_u namebuf[NUMBUFLEN];
11315 char_u valbuf[NUMBUFLEN];
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020011316 char_u *name;
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011317
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020011318 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11319 return;
11320
zeertzjqfcaeb3d2023-11-28 20:46:29 +010011321 // setting an environment variable may be dangerous, e.g. you could
Christian Brabandt6b89dd62023-10-26 22:14:17 +020011322 // setenv GCONV_PATH=/tmp and then have iconv() unexpectedly call
11323 // a shell command using some shared library:
11324 if (check_restricted() || check_secure())
11325 return;
11326
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020011327 name = tv_get_string_buf(&argvars[0], namebuf);
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011328 if (argvars[1].v_type == VAR_SPECIAL
11329 && argvars[1].vval.v_number == VVAL_NULL)
LemonBoy77142312022-04-15 20:50:46 +010011330 vim_unsetenv_ext(name);
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011331 else
LemonBoy77142312022-04-15 20:50:46 +010011332 vim_setenv_ext(name, tv_get_string_buf(&argvars[1], valbuf));
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011333}
11334
11335/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011336 * "setfperm({fname}, {mode})" function
11337 */
11338 static void
11339f_setfperm(typval_T *argvars, typval_T *rettv)
11340{
11341 char_u *fname;
11342 char_u modebuf[NUMBUFLEN];
11343 char_u *mode_str;
11344 int i;
11345 int mask;
11346 int mode = 0;
11347
11348 rettv->vval.v_number = 0;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011349
11350 if (in_vim9script()
11351 && (check_for_string_arg(argvars, 0) == FAIL
11352 || check_for_string_arg(argvars, 1) == FAIL))
11353 return;
11354
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011355 fname = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011356 if (fname == NULL)
11357 return;
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011358 mode_str = tv_get_string_buf_chk(&argvars[1], modebuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011359 if (mode_str == NULL)
11360 return;
11361 if (STRLEN(mode_str) != 9)
11362 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000011363 semsg(_(e_invalid_argument_str), mode_str);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011364 return;
11365 }
11366
11367 mask = 1;
11368 for (i = 8; i >= 0; --i)
11369 {
11370 if (mode_str[i] != '-')
11371 mode |= mask;
11372 mask = mask << 1;
11373 }
11374 rettv->vval.v_number = mch_setperm(fname, mode) == OK;
11375}
11376
11377/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011378 * "setpos()" function
11379 */
11380 static void
11381f_setpos(typval_T *argvars, typval_T *rettv)
11382{
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011383 set_position(argvars, rettv, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011384}
11385
11386/*
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011387 * Translate a register type string to the yank type and block length
11388 */
11389 static int
11390get_yank_type(char_u **pp, char_u *yank_type, long *block_len)
11391{
11392 char_u *stropt = *pp;
11393 switch (*stropt)
11394 {
11395 case 'v': case 'c': // character-wise selection
11396 *yank_type = MCHAR;
11397 break;
11398 case 'V': case 'l': // line-wise selection
11399 *yank_type = MLINE;
11400 break;
11401 case 'b': case Ctrl_V: // block-wise selection
11402 *yank_type = MBLOCK;
11403 if (VIM_ISDIGIT(stropt[1]))
11404 {
11405 ++stropt;
11406 *block_len = getdigits(&stropt) - 1;
11407 --stropt;
11408 }
11409 break;
11410 default:
11411 return FAIL;
11412 }
11413 *pp = stropt;
11414 return OK;
11415}
11416
11417/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011418 * "setreg()" function
11419 */
11420 static void
11421f_setreg(typval_T *argvars, typval_T *rettv)
11422{
11423 int regname;
11424 char_u *strregname;
11425 char_u *stropt;
11426 char_u *strval;
11427 int append;
11428 char_u yank_type;
11429 long block_len;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011430 typval_T *regcontents;
11431 int pointreg;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011432
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020011433 if (in_vim9script()
11434 && (check_for_string_arg(argvars, 0) == FAIL
11435 || check_for_opt_string_arg(argvars, 2) == FAIL))
11436 return;
11437
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011438 pointreg = 0;
11439 regcontents = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011440 block_len = -1;
11441 yank_type = MAUTO;
11442 append = FALSE;
11443
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011444 strregname = tv_get_string_chk(argvars);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011445 rettv->vval.v_number = 1; // FAIL is default
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011446
11447 if (strregname == NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011448 return; // type error; errmsg already given
Bram Moolenaar418a29f2021-02-10 22:23:41 +010011449 if (in_vim9script() && STRLEN(strregname) > 1)
11450 {
11451 semsg(_(e_register_name_must_be_one_char_str), strregname);
11452 return;
11453 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011454 regname = *strregname;
11455 if (regname == 0 || regname == '@')
11456 regname = '"';
11457
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011458 if (argvars[1].v_type == VAR_DICT)
11459 {
11460 dict_T *d = argvars[1].vval.v_dict;
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011461 dictitem_T *di;
11462
11463 if (d == NULL || d->dv_hashtab.ht_used == 0)
11464 {
11465 // Empty dict, clear the register (like setreg(0, []))
11466 char_u *lstval[2] = {NULL, NULL};
11467 write_reg_contents_lst(regname, lstval, 0, FALSE, MAUTO, -1);
11468 return;
11469 }
11470
11471 di = dict_find(d, (char_u *)"regcontents", -1);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011472 if (di != NULL)
11473 regcontents = &di->di_tv;
11474
Bram Moolenaard61efa52022-07-23 09:52:04 +010011475 stropt = dict_get_string(d, "regtype", FALSE);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011476 if (stropt != NULL)
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011477 {
11478 int ret = get_yank_type(&stropt, &yank_type, &block_len);
11479
11480 if (ret == FAIL || *++stropt != NUL)
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011481 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000011482 semsg(_(e_invalid_value_for_argument_str), "value");
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011483 return;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011484 }
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011485 }
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011486
11487 if (regname == '"')
11488 {
Bram Moolenaard61efa52022-07-23 09:52:04 +010011489 stropt = dict_get_string(d, "points_to", FALSE);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011490 if (stropt != NULL)
11491 {
11492 pointreg = *stropt;
11493 regname = pointreg;
11494 }
11495 }
Bram Moolenaard61efa52022-07-23 09:52:04 +010011496 else if (dict_get_bool(d, "isunnamed", -1) > 0)
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011497 pointreg = regname;
11498 }
11499 else
11500 regcontents = &argvars[1];
11501
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011502 if (argvars[2].v_type != VAR_UNKNOWN)
11503 {
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011504 if (yank_type != MAUTO)
11505 {
Bram Moolenaare1242042021-12-16 20:56:57 +000011506 semsg(_(e_too_many_arguments_for_function_str), "setreg");
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011507 return;
11508 }
11509
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011510 stropt = tv_get_string_chk(&argvars[2]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011511 if (stropt == NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011512 return; // type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011513 for (; *stropt != NUL; ++stropt)
11514 switch (*stropt)
11515 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011516 case 'a': case 'A': // append
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011517 append = TRUE;
11518 break;
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011519 default:
11520 get_yank_type(&stropt, &yank_type, &block_len);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011521 }
11522 }
11523
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011524 if (regcontents && regcontents->v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011525 {
11526 char_u **lstval;
11527 char_u **allocval;
11528 char_u buf[NUMBUFLEN];
11529 char_u **curval;
11530 char_u **curallocval;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011531 list_T *ll = regcontents->vval.v_list;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011532 listitem_T *li;
11533 int len;
11534
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011535 // If the list is NULL handle like an empty list.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011536 len = ll == NULL ? 0 : ll->lv_len;
11537
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011538 // First half: use for pointers to result lines; second half: use for
11539 // pointers to allocated copies.
Bram Moolenaarc799fe22019-05-28 23:08:19 +020011540 lstval = ALLOC_MULT(char_u *, (len + 1) * 2);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011541 if (lstval == NULL)
11542 return;
11543 curval = lstval;
11544 allocval = lstval + len + 2;
11545 curallocval = allocval;
11546
Bram Moolenaar50985eb2020-01-27 22:09:39 +010011547 if (ll != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011548 {
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020011549 CHECK_LIST_MATERIALIZE(ll);
Bram Moolenaar00d253e2020-04-06 22:13:01 +020011550 FOR_ALL_LIST_ITEMS(ll, li)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011551 {
Bram Moolenaar50985eb2020-01-27 22:09:39 +010011552 strval = tv_get_string_buf_chk(&li->li_tv, buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011553 if (strval == NULL)
11554 goto free_lstval;
Bram Moolenaar50985eb2020-01-27 22:09:39 +010011555 if (strval == buf)
11556 {
11557 // Need to make a copy, next tv_get_string_buf_chk() will
11558 // overwrite the string.
11559 strval = vim_strsave(buf);
11560 if (strval == NULL)
11561 goto free_lstval;
11562 *curallocval++ = strval;
11563 }
11564 *curval++ = strval;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011565 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011566 }
11567 *curval++ = NULL;
11568
11569 write_reg_contents_lst(regname, lstval, -1,
11570 append, yank_type, block_len);
11571free_lstval:
11572 while (curallocval > allocval)
11573 vim_free(*--curallocval);
11574 vim_free(lstval);
11575 }
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011576 else if (regcontents)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011577 {
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011578 strval = tv_get_string_chk(regcontents);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011579 if (strval == NULL)
11580 return;
11581 write_reg_contents_ex(regname, strval, -1,
11582 append, yank_type, block_len);
11583 }
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011584 if (pointreg != 0)
11585 get_yank_register(pointreg, TRUE);
11586
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011587 rettv->vval.v_number = 0;
11588}
11589
11590/*
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011591 * "settagstack()" function
11592 */
11593 static void
11594f_settagstack(typval_T *argvars, typval_T *rettv)
11595{
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011596 win_T *wp;
11597 dict_T *d;
11598 int action = 'r';
11599
11600 rettv->vval.v_number = -1;
11601
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011602 if (in_vim9script()
11603 && (check_for_number_arg(argvars, 0) == FAIL
11604 || check_for_dict_arg(argvars, 1) == FAIL
11605 || check_for_opt_string_arg(argvars, 2) == FAIL))
11606 return;
11607
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011608 // first argument: window number or id
11609 wp = find_win_by_nr_or_id(&argvars[0]);
11610 if (wp == NULL)
11611 return;
11612
11613 // second argument: dict with items to set in the tag stack
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +010011614 if (check_for_dict_arg(argvars, 1) == FAIL)
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011615 return;
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011616 d = argvars[1].vval.v_dict;
11617 if (d == NULL)
11618 return;
11619
11620 // third argument: action - 'a' for append and 'r' for replace.
11621 // default is to replace the stack.
11622 if (argvars[2].v_type == VAR_UNKNOWN)
11623 action = 'r';
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +010011624 else if (check_for_string_arg(argvars, 2) == FAIL)
11625 return;
11626 else
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011627 {
11628 char_u *actstr;
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011629 actstr = tv_get_string_chk(&argvars[2]);
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011630 if (actstr == NULL)
11631 return;
Bram Moolenaar271fa082020-01-02 14:02:16 +010011632 if ((*actstr == 'r' || *actstr == 'a' || *actstr == 't')
11633 && actstr[1] == NUL)
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011634 action = *actstr;
11635 else
11636 {
Bram Moolenaard82a47d2022-01-05 20:24:39 +000011637 semsg(_(e_invalid_action_str_2), actstr);
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011638 return;
11639 }
11640 }
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011641
11642 if (set_tagstack(wp, d, action) == OK)
11643 rettv->vval.v_number = 0;
11644}
11645
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011646#ifdef FEAT_CRYPT
11647/*
11648 * "sha256({string})" function
11649 */
11650 static void
11651f_sha256(typval_T *argvars, typval_T *rettv)
11652{
11653 char_u *p;
11654
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011655 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11656 return;
11657
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011658 p = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011659 rettv->vval.v_string = vim_strsave(
11660 sha256_bytes(p, (int)STRLEN(p), NULL, 0));
11661 rettv->v_type = VAR_STRING;
11662}
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011663#endif // FEAT_CRYPT
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011664
11665/*
11666 * "shellescape({string})" function
11667 */
11668 static void
11669f_shellescape(typval_T *argvars, typval_T *rettv)
11670{
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011671 int do_special;
Bram Moolenaar20615522017-06-05 18:46:26 +020011672
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011673 if (in_vim9script()
11674 && (check_for_string_arg(argvars, 0) == FAIL
11675 || check_for_opt_bool_arg(argvars, 1) == FAIL))
11676 return;
11677
11678 do_special = non_zero_arg(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011679 rettv->vval.v_string = vim_strsave_shellescape(
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011680 tv_get_string(&argvars[0]), do_special, do_special);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011681 rettv->v_type = VAR_STRING;
11682}
11683
11684/*
11685 * shiftwidth() function
11686 */
11687 static void
11688f_shiftwidth(typval_T *argvars UNUSED, typval_T *rettv)
11689{
Bram Moolenaarf9514162018-11-22 03:08:29 +010011690 rettv->vval.v_number = 0;
11691
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011692 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
11693 return;
11694
Bram Moolenaarf9514162018-11-22 03:08:29 +010011695 if (argvars[0].v_type != VAR_UNKNOWN)
11696 {
11697 long col;
11698
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011699 col = (long)tv_get_number_chk(argvars, NULL);
Bram Moolenaarf9514162018-11-22 03:08:29 +010011700 if (col < 0)
11701 return; // type error; errmsg already given
11702#ifdef FEAT_VARTABS
Gary Johnson88d4f252024-06-01 20:51:33 +020011703 rettv->vval.v_number = get_sw_value_col(curbuf, col, FALSE);
Bram Moolenaarf9514162018-11-22 03:08:29 +010011704 return;
11705#endif
11706 }
11707
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011708 rettv->vval.v_number = get_sw_value(curbuf);
11709}
11710
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011711/*
11712 * "soundfold({word})" function
11713 */
11714 static void
11715f_soundfold(typval_T *argvars, typval_T *rettv)
11716{
11717 char_u *s;
11718
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011719 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11720 return;
11721
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011722 rettv->v_type = VAR_STRING;
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011723 s = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011724#ifdef FEAT_SPELL
11725 rettv->vval.v_string = eval_soundfold(s);
11726#else
11727 rettv->vval.v_string = vim_strsave(s);
11728#endif
11729}
11730
11731/*
11732 * "spellbadword()" function
11733 */
11734 static void
11735f_spellbadword(typval_T *argvars UNUSED, typval_T *rettv)
11736{
11737 char_u *word = (char_u *)"";
11738 hlf_T attr = HLF_COUNT;
11739 int len = 0;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011740#ifdef FEAT_SPELL
11741 int wo_spell_save = curwin->w_p_spell;
11742
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011743 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
11744 return;
11745
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011746 if (!curwin->w_p_spell)
11747 {
Yegappan Lakshmananaf936912023-02-20 12:16:39 +000011748 parse_spelllang(curwin);
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011749 curwin->w_p_spell = TRUE;
11750 }
11751
11752 if (*curwin->w_s->b_p_spl == NUL)
11753 {
Bram Moolenaar460ae5d2022-01-01 14:19:49 +000011754 emsg(_(e_spell_checking_is_not_possible));
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011755 curwin->w_p_spell = wo_spell_save;
11756 return;
11757 }
11758#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011759
11760 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011761 {
11762#ifdef FEAT_SPELL
11763 curwin->w_p_spell = wo_spell_save;
11764#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011765 return;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011766 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011767
11768#ifdef FEAT_SPELL
11769 if (argvars[0].v_type == VAR_UNKNOWN)
11770 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011771 // Find the start and length of the badly spelled word.
Christ van Willegen - van Noort8e4c4c72024-05-17 18:49:27 +020011772 len = spell_move_to(curwin, FORWARD, SMT_ALL, TRUE, &attr);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011773 if (len != 0)
Bram Moolenaarb73fa622017-12-21 20:27:47 +010011774 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011775 word = ml_get_cursor();
Bram Moolenaarb73fa622017-12-21 20:27:47 +010011776 curwin->w_set_curswant = TRUE;
11777 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011778 }
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011779 else if (*curbuf->b_s.b_p_spl != NUL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011780 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011781 char_u *str = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011782 int capcol = -1;
11783
11784 if (str != NULL)
11785 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011786 // Check the argument for spelling.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011787 while (*str != NUL)
11788 {
11789 len = spell_check(curwin, str, &attr, &capcol, FALSE);
11790 if (attr != HLF_COUNT)
11791 {
11792 word = str;
11793 break;
11794 }
11795 str += len;
Bram Moolenaar66ab9162018-07-20 20:28:48 +020011796 capcol -= len;
Bram Moolenaar0c779e82019-08-09 17:01:02 +020011797 len = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011798 }
11799 }
11800 }
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011801 curwin->w_p_spell = wo_spell_save;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011802#endif
11803
11804 list_append_string(rettv->vval.v_list, word, len);
11805 list_append_string(rettv->vval.v_list, (char_u *)(
11806 attr == HLF_SPB ? "bad" :
11807 attr == HLF_SPR ? "rare" :
11808 attr == HLF_SPL ? "local" :
11809 attr == HLF_SPC ? "caps" :
11810 ""), -1);
11811}
11812
11813/*
11814 * "spellsuggest()" function
11815 */
11816 static void
11817f_spellsuggest(typval_T *argvars UNUSED, typval_T *rettv)
11818{
11819#ifdef FEAT_SPELL
11820 char_u *str;
11821 int typeerr = FALSE;
11822 int maxcount;
11823 garray_T ga;
11824 int i;
11825 listitem_T *li;
11826 int need_capital = FALSE;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011827 int wo_spell_save = curwin->w_p_spell;
11828
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011829 if (in_vim9script()
11830 && (check_for_string_arg(argvars, 0) == FAIL
11831 || check_for_opt_number_arg(argvars, 1) == FAIL
11832 || (argvars[1].v_type != VAR_UNKNOWN
11833 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
11834 return;
11835
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011836 if (!curwin->w_p_spell)
11837 {
Yegappan Lakshmananaf936912023-02-20 12:16:39 +000011838 parse_spelllang(curwin);
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011839 curwin->w_p_spell = TRUE;
11840 }
11841
11842 if (*curwin->w_s->b_p_spl == NUL)
11843 {
Bram Moolenaar460ae5d2022-01-01 14:19:49 +000011844 emsg(_(e_spell_checking_is_not_possible));
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011845 curwin->w_p_spell = wo_spell_save;
11846 return;
11847 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011848#endif
11849
11850 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011851 {
11852#ifdef FEAT_SPELL
11853 curwin->w_p_spell = wo_spell_save;
11854#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011855 return;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011856 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011857
11858#ifdef FEAT_SPELL
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011859 str = tv_get_string(&argvars[0]);
11860 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011861 {
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011862 maxcount = (int)tv_get_number_chk(&argvars[1], &typeerr);
11863 if (maxcount <= 0)
11864 return;
11865 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011866 {
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011867 need_capital = (int)tv_get_bool_chk(&argvars[2], &typeerr);
11868 if (typeerr)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011869 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011870 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011871 }
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011872 else
11873 maxcount = 25;
11874
11875 spell_suggest_list(&ga, str, maxcount, need_capital, FALSE);
11876
11877 for (i = 0; i < ga.ga_len; ++i)
11878 {
11879 str = ((char_u **)ga.ga_data)[i];
11880
11881 li = listitem_alloc();
11882 if (li == NULL)
11883 vim_free(str);
11884 else
11885 {
11886 li->li_tv.v_type = VAR_STRING;
11887 li->li_tv.v_lock = 0;
11888 li->li_tv.vval.v_string = str;
11889 list_append(rettv->vval.v_list, li);
11890 }
11891 }
11892 ga_clear(&ga);
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011893 curwin->w_p_spell = wo_spell_save;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011894#endif
11895}
11896
11897 static void
11898f_split(typval_T *argvars, typval_T *rettv)
11899{
11900 char_u *str;
11901 char_u *end;
11902 char_u *pat = NULL;
11903 regmatch_T regmatch;
11904 char_u patbuf[NUMBUFLEN];
11905 char_u *save_cpo;
11906 int match;
11907 colnr_T col = 0;
11908 int keepempty = FALSE;
11909 int typeerr = FALSE;
11910
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011911 if (in_vim9script()
11912 && (check_for_string_arg(argvars, 0) == FAIL
11913 || check_for_opt_string_arg(argvars, 1) == FAIL
11914 || (argvars[1].v_type != VAR_UNKNOWN
11915 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
11916 return;
11917
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011918 // Make 'cpoptions' empty, the 'l' flag should not be used here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011919 save_cpo = p_cpo;
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010011920 p_cpo = empty_option;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011921
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011922 str = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011923 if (argvars[1].v_type != VAR_UNKNOWN)
11924 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011925 pat = tv_get_string_buf_chk(&argvars[1], patbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011926 if (pat == NULL)
11927 typeerr = TRUE;
11928 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar3986b942020-09-06 16:09:04 +020011929 keepempty = (int)tv_get_bool_chk(&argvars[2], &typeerr);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011930 }
11931 if (pat == NULL || *pat == NUL)
11932 pat = (char_u *)"[\\x01- ]\\+";
11933
11934 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar7d5e7442020-07-21 22:25:51 +020011935 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011936 if (typeerr)
Bram Moolenaar7d5e7442020-07-21 22:25:51 +020011937 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011938
11939 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
11940 if (regmatch.regprog != NULL)
11941 {
11942 regmatch.rm_ic = FALSE;
11943 while (*str != NUL || keepempty)
11944 {
11945 if (*str == NUL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011946 match = FALSE; // empty item at the end
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011947 else
11948 match = vim_regexec_nl(&regmatch, str, col);
11949 if (match)
11950 end = regmatch.startp[0];
11951 else
11952 end = str + STRLEN(str);
11953 if (keepempty || end > str || (rettv->vval.v_list->lv_len > 0
11954 && *str != NUL && match && end < regmatch.endp[0]))
11955 {
11956 if (list_append_string(rettv->vval.v_list, str,
11957 (int)(end - str)) == FAIL)
11958 break;
11959 }
11960 if (!match)
11961 break;
Bram Moolenaar13505972019-01-24 15:04:48 +010011962 // Advance to just after the match.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011963 if (regmatch.endp[0] > str)
11964 col = 0;
11965 else
Bram Moolenaar13505972019-01-24 15:04:48 +010011966 // Don't get stuck at the same match.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011967 col = (*mb_ptr2len)(regmatch.endp[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011968 str = regmatch.endp[0];
11969 }
11970
11971 vim_regfree(regmatch.regprog);
11972 }
11973
Bram Moolenaar7d5e7442020-07-21 22:25:51 +020011974theend:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011975 p_cpo = save_cpo;
11976}
11977
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011978/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011979 * "submatch()" function
11980 */
11981 static void
11982f_submatch(typval_T *argvars, typval_T *rettv)
11983{
11984 int error = FALSE;
11985 int no;
11986 int retList = 0;
11987
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011988 if (in_vim9script()
11989 && (check_for_number_arg(argvars, 0) == FAIL
11990 || check_for_opt_bool_arg(argvars, 1) == FAIL))
11991 return;
11992
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011993 no = (int)tv_get_number_chk(&argvars[0], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011994 if (error)
11995 return;
Bram Moolenaar989f5922016-08-21 15:26:54 +020011996 if (no < 0 || no >= NSUBEXP)
11997 {
Bram Moolenaard82a47d2022-01-05 20:24:39 +000011998 semsg(_(e_invalid_submatch_number_nr), no);
Bram Moolenaar79518e22017-02-17 16:31:35 +010011999 return;
Bram Moolenaar989f5922016-08-21 15:26:54 +020012000 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012001 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaarad304702020-09-06 18:22:53 +020012002 retList = (int)tv_get_bool_chk(&argvars[1], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012003 if (error)
12004 return;
12005
12006 if (retList == 0)
12007 {
12008 rettv->v_type = VAR_STRING;
12009 rettv->vval.v_string = reg_submatch(no);
12010 }
12011 else
12012 {
12013 rettv->v_type = VAR_LIST;
12014 rettv->vval.v_list = reg_submatch_list(no);
12015 }
12016}
12017
12018/*
12019 * "substitute()" function
12020 */
12021 static void
12022f_substitute(typval_T *argvars, typval_T *rettv)
12023{
12024 char_u patbuf[NUMBUFLEN];
12025 char_u subbuf[NUMBUFLEN];
12026 char_u flagsbuf[NUMBUFLEN];
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +020012027 char_u *str;
12028 char_u *pat;
Bram Moolenaar72ab7292016-07-19 19:10:51 +020012029 char_u *sub = NULL;
12030 typval_T *expr = NULL;
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +020012031 char_u *flg;
12032
12033 if (in_vim9script()
12034 && (check_for_string_arg(argvars, 0) == FAIL
12035 || check_for_string_arg(argvars, 1) == FAIL
12036 || check_for_string_arg(argvars, 3) == FAIL))
12037 return;
12038
12039 str = tv_get_string_chk(&argvars[0]);
12040 pat = tv_get_string_buf_chk(&argvars[1], patbuf);
12041 flg = tv_get_string_buf_chk(&argvars[3], flagsbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012042
LemonBoyf3b48952022-05-05 13:53:03 +010012043 if (argvars[2].v_type == VAR_FUNC
12044 || argvars[2].v_type == VAR_PARTIAL
Bram Moolenaar00b28d62022-12-08 15:32:33 +000012045 || argvars[2].v_type == VAR_INSTR
12046 || argvars[2].v_type == VAR_CLASS
12047 || argvars[2].v_type == VAR_OBJECT)
Bram Moolenaar72ab7292016-07-19 19:10:51 +020012048 expr = &argvars[2];
12049 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012050 sub = tv_get_string_buf_chk(&argvars[2], subbuf);
Bram Moolenaar72ab7292016-07-19 19:10:51 +020012051
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012052 rettv->v_type = VAR_STRING;
Bram Moolenaar72ab7292016-07-19 19:10:51 +020012053 if (str == NULL || pat == NULL || (sub == NULL && expr == NULL)
12054 || flg == NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012055 rettv->vval.v_string = NULL;
12056 else
John Marriottbd4614f2024-11-18 20:25:21 +010012057 rettv->vval.v_string = do_string_sub(str, STRLEN(str), pat, sub, expr, flg, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012058}
12059
12060/*
Bram Moolenaarc216a7a2022-12-05 13:50:55 +000012061 * "swapfilelist()" function
12062 */
12063 static void
12064f_swapfilelist(typval_T *argvars UNUSED, typval_T *rettv)
12065{
12066 if (rettv_list_alloc(rettv) == FAIL)
12067 return;
12068 recover_names(NULL, FALSE, rettv->vval.v_list, 0, NULL);
12069}
12070
12071/*
Bram Moolenaar00f123a2018-08-21 20:28:54 +020012072 * "swapinfo(swap_filename)" function
12073 */
12074 static void
12075f_swapinfo(typval_T *argvars, typval_T *rettv)
12076{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012077 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
12078 return;
12079
Bram Moolenaar00f123a2018-08-21 20:28:54 +020012080 if (rettv_dict_alloc(rettv) == OK)
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012081 get_b0_dict(tv_get_string(argvars), rettv->vval.v_dict);
Bram Moolenaar00f123a2018-08-21 20:28:54 +020012082}
12083
12084/*
Bram Moolenaar110bd602018-09-16 18:46:59 +020012085 * "swapname(expr)" function
12086 */
12087 static void
12088f_swapname(typval_T *argvars, typval_T *rettv)
12089{
12090 buf_T *buf;
12091
12092 rettv->v_type = VAR_STRING;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012093
12094 if (in_vim9script() && check_for_buffer_arg(argvars, 0) == FAIL)
12095 return;
12096
Bram Moolenaarf2d79fa2019-01-03 22:19:27 +010012097 buf = tv_get_buf(&argvars[0], FALSE);
Bram Moolenaar110bd602018-09-16 18:46:59 +020012098 if (buf == NULL || buf->b_ml.ml_mfp == NULL
12099 || buf->b_ml.ml_mfp->mf_fname == NULL)
12100 rettv->vval.v_string = NULL;
12101 else
12102 rettv->vval.v_string = vim_strsave(buf->b_ml.ml_mfp->mf_fname);
12103}
12104
12105/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012106 * "synID(lnum, col, trans)" function
12107 */
12108 static void
12109f_synID(typval_T *argvars UNUSED, typval_T *rettv)
12110{
12111 int id = 0;
12112#ifdef FEAT_SYN_HL
12113 linenr_T lnum;
12114 colnr_T col;
12115 int trans;
12116 int transerr = FALSE;
12117
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020012118 if (in_vim9script()
Yegappan Lakshmanancd917202021-07-21 19:09:09 +020012119 && (check_for_lnum_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020012120 || check_for_number_arg(argvars, 1) == FAIL
12121 || check_for_bool_arg(argvars, 2) == FAIL))
12122 return;
12123
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012124 lnum = tv_get_lnum(argvars); // -1 on type error
12125 col = (linenr_T)tv_get_number(&argvars[1]) - 1; // -1 on type error
Bram Moolenaarfcb6d702020-09-05 21:41:56 +020012126 trans = (int)tv_get_bool_chk(&argvars[2], &transerr);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012127
12128 if (!transerr && lnum >= 1 && lnum <= curbuf->b_ml.ml_line_count
John Marriottbfcc8952024-03-11 22:04:45 +010012129 && col >= 0 && col < (long)ml_get_len(lnum))
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +000012130 id = syn_get_id(curwin, lnum, col, trans, NULL, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012131#endif
12132
12133 rettv->vval.v_number = id;
12134}
12135
12136/*
12137 * "synIDattr(id, what [, mode])" function
12138 */
12139 static void
12140f_synIDattr(typval_T *argvars UNUSED, typval_T *rettv)
12141{
12142 char_u *p = NULL;
12143#ifdef FEAT_SYN_HL
12144 int id;
12145 char_u *what;
12146 char_u *mode;
12147 char_u modebuf[NUMBUFLEN];
12148 int modec;
12149
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +020012150 if (in_vim9script()
12151 && (check_for_number_arg(argvars, 0) == FAIL
Yegappan Lakshmananf8dbd582021-09-26 19:04:05 +010012152 || check_for_string_arg(argvars, 1) == FAIL
12153 || check_for_opt_string_arg(argvars, 2) == FAIL))
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +020012154 return;
12155
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012156 id = (int)tv_get_number(&argvars[0]);
12157 what = tv_get_string(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012158 if (argvars[2].v_type != VAR_UNKNOWN)
12159 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012160 mode = tv_get_string_buf(&argvars[2], modebuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012161 modec = TOLOWER_ASC(mode[0]);
12162 if (modec != 't' && modec != 'c' && modec != 'g')
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012163 modec = 0; // replace invalid with current
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012164 }
12165 else
12166 {
12167#if defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS)
12168 if (USE_24BIT)
12169 modec = 'g';
12170 else
12171#endif
12172 if (t_colors > 1)
Dominique Pelle4781d6f2021-05-18 21:46:31 +020012173 modec = 'c';
12174 else
12175 modec = 't';
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012176 }
12177
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012178 switch (TOLOWER_ASC(what[0]))
12179 {
12180 case 'b':
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012181 if (TOLOWER_ASC(what[1]) == 'g') // bg[#]
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012182 p = highlight_color(id, what, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012183 else // bold
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012184 p = highlight_has_attr(id, HL_BOLD, modec);
12185 break;
12186
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012187 case 'f': // fg[#] or font
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012188 p = highlight_color(id, what, modec);
12189 break;
12190
12191 case 'i':
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012192 if (TOLOWER_ASC(what[1]) == 'n') // inverse
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012193 p = highlight_has_attr(id, HL_INVERSE, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012194 else // italic
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012195 p = highlight_has_attr(id, HL_ITALIC, modec);
12196 break;
12197
Martin Tournoijba43e762022-10-13 22:12:15 +010012198 case 'n':
Bram Moolenaarde786322022-07-30 14:56:17 +010012199 if (TOLOWER_ASC(what[1]) == 'o') // nocombine
12200 p = highlight_has_attr(id, HL_NOCOMBINE, modec);
12201 else // name
12202 p = get_highlight_name_ext(NULL, id - 1, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012203 break;
12204
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012205 case 'r': // reverse
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012206 p = highlight_has_attr(id, HL_INVERSE, modec);
12207 break;
12208
12209 case 's':
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012210 if (TOLOWER_ASC(what[1]) == 'p') // sp[#]
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012211 p = highlight_color(id, what, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012212 // strikeout
Bram Moolenaarcf4b00c2017-09-02 18:33:56 +020012213 else if (TOLOWER_ASC(what[1]) == 't' &&
12214 TOLOWER_ASC(what[2]) == 'r')
12215 p = highlight_has_attr(id, HL_STRIKETHROUGH, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012216 else // standout
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012217 p = highlight_has_attr(id, HL_STANDOUT, modec);
12218 break;
12219
12220 case 'u':
Bram Moolenaar84f54632022-06-29 18:39:11 +010012221 if (STRLEN(what) >= 9)
12222 {
12223 if (TOLOWER_ASC(what[5]) == 'l')
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012224 // underline
Bram Moolenaar84f54632022-06-29 18:39:11 +010012225 p = highlight_has_attr(id, HL_UNDERLINE, modec);
12226 else if (TOLOWER_ASC(what[5]) != 'd')
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012227 // undercurl
Bram Moolenaar84f54632022-06-29 18:39:11 +010012228 p = highlight_has_attr(id, HL_UNDERCURL, modec);
12229 else if (TOLOWER_ASC(what[6]) != 'o')
12230 // underdashed
12231 p = highlight_has_attr(id, HL_UNDERDASHED, modec);
12232 else if (TOLOWER_ASC(what[7]) == 'u')
12233 // underdouble
12234 p = highlight_has_attr(id, HL_UNDERDOUBLE, modec);
12235 else
12236 // underdotted
12237 p = highlight_has_attr(id, HL_UNDERDOTTED, modec);
12238 }
12239 else
12240 // ul
12241 p = highlight_color(id, what, modec);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012242 break;
12243 }
12244
12245 if (p != NULL)
12246 p = vim_strsave(p);
12247#endif
12248 rettv->v_type = VAR_STRING;
12249 rettv->vval.v_string = p;
12250}
12251
12252/*
12253 * "synIDtrans(id)" function
12254 */
12255 static void
12256f_synIDtrans(typval_T *argvars UNUSED, typval_T *rettv)
12257{
12258 int id;
12259
12260#ifdef FEAT_SYN_HL
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012261 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
12262 return;
12263
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012264 id = (int)tv_get_number(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012265
12266 if (id > 0)
12267 id = syn_get_final_id(id);
12268 else
12269#endif
12270 id = 0;
12271
12272 rettv->vval.v_number = id;
12273}
12274
12275/*
12276 * "synconcealed(lnum, col)" function
12277 */
12278 static void
12279f_synconcealed(typval_T *argvars UNUSED, typval_T *rettv)
12280{
12281#if defined(FEAT_SYN_HL) && defined(FEAT_CONCEAL)
12282 linenr_T lnum;
12283 colnr_T col;
12284 int syntax_flags = 0;
12285 int cchar;
12286 int matchid = 0;
12287 char_u str[NUMBUFLEN];
12288#endif
12289
Bram Moolenaar45cf6e92017-04-30 20:25:19 +020012290 rettv_list_set(rettv, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012291
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020012292 if (in_vim9script()
Yegappan Lakshmanancd917202021-07-21 19:09:09 +020012293 && (check_for_lnum_arg(argvars, 0) == FAIL
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020012294 || check_for_number_arg(argvars, 1) == FAIL))
12295 return;
12296
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012297#if defined(FEAT_SYN_HL) && defined(FEAT_CONCEAL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012298 lnum = tv_get_lnum(argvars); // -1 on type error
12299 col = (colnr_T)tv_get_number(&argvars[1]) - 1; // -1 on type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012300
Bram Moolenaara80faa82020-04-12 19:37:17 +020012301 CLEAR_FIELD(str);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012302
Bram Moolenaar93a10962022-06-16 11:42:09 +010012303 if (rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012304 {
12305 if (lnum >= 1 && lnum <= curbuf->b_ml.ml_line_count
John Marriottbfcc8952024-03-11 22:04:45 +010012306 && col >= 0 && col <= (long)ml_get_len(lnum)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012307 && curwin->w_p_cole > 0)
12308 {
12309 (void)syn_get_id(curwin, lnum, col, FALSE, NULL, FALSE);
12310 syntax_flags = get_syntax_info(&matchid);
12311
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012312 // get the conceal character
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012313 if ((syntax_flags & HL_CONCEAL) && curwin->w_p_cole < 3)
12314 {
12315 cchar = syn_get_sub_char();
Bram Moolenaar4d785892017-06-22 22:00:50 +020012316 if (cchar == NUL && curwin->w_p_cole == 1)
Bram Moolenaareed9d462021-02-15 20:38:25 +010012317 cchar = (curwin->w_lcs_chars.conceal == NUL) ? ' '
12318 : curwin->w_lcs_chars.conceal;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012319 if (cchar != NUL)
12320 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012321 if (has_mbyte)
12322 (*mb_char2bytes)(cchar, str);
12323 else
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012324 str[0] = cchar;
12325 }
12326 }
12327 }
12328
12329 list_append_number(rettv->vval.v_list,
12330 (syntax_flags & HL_CONCEAL) != 0);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012331 // -1 to auto-determine strlen
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012332 list_append_string(rettv->vval.v_list, str, -1);
12333 list_append_number(rettv->vval.v_list, matchid);
12334 }
12335#endif
12336}
12337
12338/*
12339 * "synstack(lnum, col)" function
12340 */
12341 static void
12342f_synstack(typval_T *argvars UNUSED, typval_T *rettv)
12343{
12344#ifdef FEAT_SYN_HL
12345 linenr_T lnum;
12346 colnr_T col;
12347 int i;
12348 int id;
12349#endif
12350
Bram Moolenaar45cf6e92017-04-30 20:25:19 +020012351 rettv_list_set(rettv, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012352
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020012353 if (in_vim9script()
Yegappan Lakshmanancd917202021-07-21 19:09:09 +020012354 && (check_for_lnum_arg(argvars, 0) == FAIL
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020012355 || check_for_number_arg(argvars, 1) == FAIL))
12356 return;
12357
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012358#ifdef FEAT_SYN_HL
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012359 lnum = tv_get_lnum(argvars); // -1 on type error
12360 col = (colnr_T)tv_get_number(&argvars[1]) - 1; // -1 on type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012361
12362 if (lnum >= 1 && lnum <= curbuf->b_ml.ml_line_count
John Marriottbfcc8952024-03-11 22:04:45 +010012363 && col >= 0 && col <= (long)ml_get_len(lnum)
Bram Moolenaar93a10962022-06-16 11:42:09 +010012364 && rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012365 {
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +000012366 (void)syn_get_id(curwin, lnum, col, FALSE, NULL, TRUE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012367 for (i = 0; ; ++i)
12368 {
12369 id = syn_get_stack_item(i);
12370 if (id < 0)
12371 break;
12372 if (list_append_number(rettv->vval.v_list, id) == FAIL)
12373 break;
12374 }
12375 }
12376#endif
12377}
12378
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012379/*
12380 * "tabpagebuflist()" function
12381 */
12382 static void
12383f_tabpagebuflist(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
12384{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012385 tabpage_T *tp;
12386 win_T *wp = NULL;
12387
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012388 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
12389 return;
12390
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012391 if (argvars[0].v_type == VAR_UNKNOWN)
12392 wp = firstwin;
12393 else
12394 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012395 tp = find_tabpage((int)tv_get_number(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012396 if (tp != NULL)
12397 wp = (tp == curtab) ? firstwin : tp->tp_firstwin;
12398 }
Bram Moolenaar93a10962022-06-16 11:42:09 +010012399 if (wp != NULL && rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012400 {
12401 for (; wp != NULL; wp = wp->w_next)
12402 if (list_append_number(rettv->vval.v_list,
12403 wp->w_buffer->b_fnum) == FAIL)
12404 break;
12405 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012406}
12407
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012408/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012409 * "tagfiles()" function
12410 */
12411 static void
12412f_tagfiles(typval_T *argvars UNUSED, typval_T *rettv)
12413{
12414 char_u *fname;
12415 tagname_T tn;
12416 int first;
12417
12418 if (rettv_list_alloc(rettv) == FAIL)
12419 return;
12420 fname = alloc(MAXPATHL);
12421 if (fname == NULL)
12422 return;
12423
12424 for (first = TRUE; ; first = FALSE)
12425 if (get_tagfname(&tn, first, fname) == FAIL
12426 || list_append_string(rettv->vval.v_list, fname, -1) == FAIL)
12427 break;
12428 tagname_free(&tn);
12429 vim_free(fname);
12430}
12431
12432/*
12433 * "taglist()" function
12434 */
12435 static void
12436f_taglist(typval_T *argvars, typval_T *rettv)
12437{
Bram Moolenaarc6aafba2017-03-21 17:09:10 +010012438 char_u *fname = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012439 char_u *tag_pattern;
12440
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012441 if (in_vim9script()
12442 && (check_for_string_arg(argvars, 0) == FAIL
12443 || check_for_opt_string_arg(argvars, 1) == FAIL))
12444 return;
12445
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012446 tag_pattern = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012447
12448 rettv->vval.v_number = FALSE;
12449 if (*tag_pattern == NUL)
12450 return;
12451
Bram Moolenaarc6aafba2017-03-21 17:09:10 +010012452 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012453 fname = tv_get_string(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012454 if (rettv_list_alloc(rettv) == OK)
Bram Moolenaarc6aafba2017-03-21 17:09:10 +010012455 (void)get_tags(rettv->vval.v_list, tag_pattern, fname);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012456}
12457
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012458/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012459 * "type(expr)" function
12460 */
12461 static void
12462f_type(typval_T *argvars, typval_T *rettv)
12463{
12464 int n = -1;
12465
12466 switch (argvars[0].v_type)
12467 {
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +010012468 case VAR_NUMBER: n = VAR_TYPE_NUMBER; break;
12469 case VAR_STRING: n = VAR_TYPE_STRING; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012470 case VAR_PARTIAL:
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +010012471 case VAR_FUNC: n = VAR_TYPE_FUNC; break;
12472 case VAR_LIST: n = VAR_TYPE_LIST; break;
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010012473 case VAR_TUPLE: n = VAR_TYPE_TUPLE; break;
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +010012474 case VAR_DICT: n = VAR_TYPE_DICT; break;
12475 case VAR_FLOAT: n = VAR_TYPE_FLOAT; break;
12476 case VAR_BOOL: n = VAR_TYPE_BOOL; break;
12477 case VAR_SPECIAL: n = VAR_TYPE_NONE; break;
Bram Moolenaarf562e722016-07-19 17:25:25 +020012478 case VAR_JOB: n = VAR_TYPE_JOB; break;
12479 case VAR_CHANNEL: n = VAR_TYPE_CHANNEL; break;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +010012480 case VAR_BLOB: n = VAR_TYPE_BLOB; break;
Bram Moolenaarf18332f2021-05-07 17:55:55 +020012481 case VAR_INSTR: n = VAR_TYPE_INSTR; break;
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +020012482 case VAR_TYPEALIAS: n = VAR_TYPE_TYPEALIAS; break;
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012483 case VAR_CLASS:
12484 {
12485 class_T *cl = argvars[0].vval.v_class;
Yegappan Lakshmananda9d3452024-05-02 13:02:36 +020012486 if (cl != NULL && IS_ENUM(cl))
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012487 n = VAR_TYPE_ENUM;
12488 else
12489 n = VAR_TYPE_CLASS;
12490 break;
12491 }
12492 case VAR_OBJECT:
12493 {
Yegappan Lakshmananb2e42b92024-05-01 11:44:17 +020012494 object_T *obj = argvars[0].vval.v_object;
12495
12496 if (obj == NULL)
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012497 n = VAR_TYPE_OBJECT;
Yegappan Lakshmananb2e42b92024-05-01 11:44:17 +020012498 else
12499 {
12500 class_T *cl = argvars[0].vval.v_object->obj_class;
12501 if (IS_ENUM(cl))
12502 n = VAR_TYPE_ENUMVALUE;
12503 else
12504 n = VAR_TYPE_OBJECT;
12505 }
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012506 break;
12507 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012508 case VAR_UNKNOWN:
Bram Moolenaar4c683752020-04-05 21:38:23 +020012509 case VAR_ANY:
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010012510 case VAR_VOID:
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012511 internal_error_no_abort("f_type(UNKNOWN)");
12512 n = -1;
12513 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012514 }
12515 rettv->vval.v_number = n;
12516}
12517
12518/*
zeertzjq825cf812023-08-17 22:55:25 +020012519 * "virtcol({expr}, [, {list} [, {winid}]])" function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012520 */
12521 static void
12522f_virtcol(typval_T *argvars, typval_T *rettv)
12523{
LemonBoy0f7a3e12022-05-26 12:10:37 +010012524 colnr_T vcol_start = 0;
12525 colnr_T vcol_end = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012526 pos_T *fp;
zeertzjq825cf812023-08-17 22:55:25 +020012527 switchwin_T switchwin;
12528 int winchanged = FALSE;
Bram Moolenaarb3d33d82020-01-15 20:36:55 +010012529 int len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012530
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012531 if (in_vim9script()
LemonBoy0f7a3e12022-05-26 12:10:37 +010012532 && (check_for_string_or_list_arg(argvars, 0) == FAIL
12533 || (argvars[1].v_type != VAR_UNKNOWN
zeertzjq825cf812023-08-17 22:55:25 +020012534 && (check_for_bool_arg(argvars, 1) == FAIL
12535 || check_for_opt_number_arg(argvars, 2) == FAIL))))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012536 return;
12537
zeertzjq825cf812023-08-17 22:55:25 +020012538 if (argvars[1].v_type != VAR_UNKNOWN && argvars[2].v_type != VAR_UNKNOWN)
12539 {
12540 tabpage_T *tp;
12541 win_T *wp;
12542
12543 // use the window specified in the third argument
12544 wp = win_id2wp_tp((int)tv_get_number(&argvars[2]), &tp);
12545 if (wp == NULL || tp == NULL)
12546 goto theend;
12547
12548 if (switch_win_noblock(&switchwin, wp, tp, TRUE) != OK)
12549 goto theend;
12550
12551 check_cursor();
12552 winchanged = TRUE;
12553 }
12554
12555 int fnum = curbuf->b_fnum;
Bram Moolenaar6f02b002021-01-10 20:22:54 +010012556 fp = var2fpos(&argvars[0], FALSE, &fnum, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012557 if (fp != NULL && fp->lnum <= curbuf->b_ml.ml_line_count
LemonBoy0f7a3e12022-05-26 12:10:37 +010012558 && fnum == curbuf->b_fnum)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012559 {
Bram Moolenaarb3d33d82020-01-15 20:36:55 +010012560 // Limit the column to a valid value, getvvcol() doesn't check.
12561 if (fp->col < 0)
12562 fp->col = 0;
12563 else
12564 {
John Marriottbfcc8952024-03-11 22:04:45 +010012565 len = (int)ml_get_len(fp->lnum);
Bram Moolenaarb3d33d82020-01-15 20:36:55 +010012566 if (fp->col > len)
12567 fp->col = len;
12568 }
LemonBoy0f7a3e12022-05-26 12:10:37 +010012569 getvvcol(curwin, fp, &vcol_start, NULL, &vcol_end);
12570 ++vcol_start;
12571 ++vcol_end;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012572 }
12573
zeertzjq825cf812023-08-17 22:55:25 +020012574theend:
LemonBoy0f7a3e12022-05-26 12:10:37 +010012575 if (argvars[1].v_type != VAR_UNKNOWN && tv_get_bool(&argvars[1]))
12576 {
12577 if (rettv_list_alloc(rettv) == OK)
12578 {
12579 list_append_number(rettv->vval.v_list, vcol_start);
12580 list_append_number(rettv->vval.v_list, vcol_end);
12581 }
12582 else
12583 rettv->vval.v_number = 0;
12584 }
12585 else
12586 rettv->vval.v_number = vcol_end;
zeertzjq825cf812023-08-17 22:55:25 +020012587
12588 if (winchanged)
12589 restore_win_noblock(&switchwin, TRUE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012590}
12591
12592/*
12593 * "visualmode()" function
12594 */
12595 static void
12596f_visualmode(typval_T *argvars, typval_T *rettv)
12597{
12598 char_u str[2];
12599
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012600 if (in_vim9script() && check_for_opt_bool_arg(argvars, 0) == FAIL)
12601 return;
12602
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012603 rettv->v_type = VAR_STRING;
12604 str[0] = curbuf->b_visual_mode_eval;
12605 str[1] = NUL;
12606 rettv->vval.v_string = vim_strsave(str);
12607
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012608 // A non-zero number or non-empty string argument: reset mode.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012609 if (non_zero_arg(&argvars[0]))
12610 curbuf->b_visual_mode_eval = NUL;
12611}
12612
12613/*
12614 * "wildmenumode()" function
12615 */
12616 static void
12617f_wildmenumode(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
12618{
Bram Moolenaar24959102022-05-07 20:01:16 +010012619 if (wild_menu_showing || ((State & MODE_CMDLINE) && cmdline_pum_active()))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012620 rettv->vval.v_number = 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012621}
12622
12623/*
Bram Moolenaar0c1e3742019-12-27 13:49:24 +010012624 * "windowsversion()" function
12625 */
12626 static void
12627f_windowsversion(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
12628{
12629 rettv->v_type = VAR_STRING;
12630 rettv->vval.v_string = vim_strsave((char_u *)windowsVersion);
12631}
12632
12633/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012634 * "wordcount()" function
12635 */
12636 static void
12637f_wordcount(typval_T *argvars UNUSED, typval_T *rettv)
12638{
12639 if (rettv_dict_alloc(rettv) == FAIL)
12640 return;
12641 cursor_pos_info(rettv->vval.v_dict);
12642}
12643
12644/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012645 * "xor(expr, expr)" function
12646 */
12647 static void
12648f_xor(typval_T *argvars, typval_T *rettv)
12649{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012650 if (in_vim9script()
12651 && (check_for_number_arg(argvars, 0) == FAIL
12652 || check_for_number_arg(argvars, 1) == FAIL))
12653 return;
12654
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012655 rettv->vval.v_number = tv_get_number_chk(&argvars[0], NULL)
12656 ^ tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012657}
12658
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012659#endif // FEAT_EVAL