blob: 39f6aa9abf69682466cc3b130dcbb062888bdc54 [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},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002107 {"confirm", 1, 4, FEARG_1, arg4_string_string_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002108 ret_number, f_confirm},
2109 {"copy", 1, 1, FEARG_1, NULL,
Bram Moolenaar381692b2022-02-02 20:01:27 +00002110 ret_copy, f_copy},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002111 {"cos", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002112 ret_float, f_cos},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002113 {"cosh", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002114 ret_float, f_cosh},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002115 {"count", 2, 4, FEARG_1, arg24_count,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002116 ret_number, f_count},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002117 {"cscope_connection",0,3, 0, arg3_number_string_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002118 ret_number, f_cscope_connection},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002119 {"cursor", 1, 3, FEARG_1, arg13_cursor,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002120 ret_number, f_cursor},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002121 {"debugbreak", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002122 ret_number,
Bram Moolenaar4f974752019-02-17 17:44:42 +01002123#ifdef MSWIN
Bram Moolenaar15c47602020-03-26 22:16:48 +01002124 f_debugbreak
2125#else
2126 NULL
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02002127#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002128 },
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002129 {"deepcopy", 1, 2, FEARG_1, arg12_deepcopy,
Bram Moolenaar381692b2022-02-02 20:01:27 +00002130 ret_copy, f_deepcopy},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002131 {"delete", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002132 ret_number_bool, f_delete},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002133 {"deletebufline", 2, 3, FEARG_1, arg3_buffer_lnum_lnum,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002134 ret_number_bool, f_deletebufline},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002135 {"did_filetype", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002136 ret_number_bool, f_did_filetype},
Yegappan Lakshmananfa378352024-02-01 22:05:27 +01002137 {"diff", 2, 3, FEARG_1, arg3_diff,
Yegappan Lakshmanana0010a12024-02-12 20:21:26 +01002138 ret_any, f_diff},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002139 {"diff_filler", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002140 ret_number, f_diff_filler},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002141 {"diff_hlID", 2, 2, FEARG_1, arg2_lnum_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002142 ret_number, f_diff_hlID},
h-east29b85712021-07-26 21:54:04 +02002143 {"digraph_get", 1, 1, FEARG_1, arg1_string,
2144 ret_string, f_digraph_get},
zeertzjqd4d12072024-07-16 20:34:16 +02002145 {"digraph_getlist", 0, 1, FEARG_1, arg1_bool,
h-east29b85712021-07-26 21:54:04 +02002146 ret_list_string_items, f_digraph_getlist},
Yegappan Lakshmananfc3b7752021-09-08 14:57:42 +02002147 {"digraph_set", 2, 2, FEARG_1, arg2_string,
h-east29b85712021-07-26 21:54:04 +02002148 ret_bool, f_digraph_set},
zeertzjqd4d12072024-07-16 20:34:16 +02002149 {"digraph_setlist", 1, 1, FEARG_1, arg1_list_string,
h-east29b85712021-07-26 21:54:04 +02002150 ret_bool, f_digraph_setlist},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002151 {"echoraw", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002152 ret_void, f_echoraw},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002153 {"empty", 1, 1, FEARG_1, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002154 ret_number_bool, f_empty},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002155 {"environ", 0, 0, 0, NULL,
2156 ret_dict_string, f_environ},
Bram Moolenaar80adaa82023-07-07 18:57:40 +01002157 {"err_teapot", 0, 1, 0, NULL,
2158 ret_number_bool, f_err_teapot},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002159 {"escape", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002160 ret_string, f_escape},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002161 {"eval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002162 ret_any, f_eval},
2163 {"eventhandler", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002164 ret_number_bool, f_eventhandler},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002165 {"executable", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002166 ret_number, f_executable},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002167 {"execute", 1, 2, FEARG_1, arg12_execute,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002168 ret_string, f_execute},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002169 {"exepath", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002170 ret_string, f_exepath},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002171 {"exists", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002172 ret_number_bool, f_exists},
Bram Moolenaar26735992021-08-08 14:43:22 +02002173 {"exists_compiled", 1, 1, FEARG_1, arg1_string,
2174 ret_number_bool, f_exists_compiled},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002175 {"exp", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002176 ret_float, f_exp},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002177 {"expand", 1, 3, FEARG_1, arg3_string_bool_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002178 ret_any, f_expand},
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01002179 {"expandcmd", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002180 ret_string, f_expandcmd},
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01002181 {"extend", 2, 3, FEARG_1, arg23_extend,
Bram Moolenaar81330182022-02-01 12:11:58 +00002182 ret_extend, f_extend},
Bram Moolenaarb0e6b512021-01-12 20:23:40 +01002183 {"extendnew", 2, 3, FEARG_1, arg23_extendnew,
2184 ret_first_cont, f_extendnew},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002185 {"feedkeys", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002186 ret_void, f_feedkeys},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002187 {"file_readable", 1, 1, FEARG_1, arg1_string, // obsolete
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002188 ret_number_bool, f_filereadable},
Shougo Matsushita60c87432024-06-03 22:59:27 +02002189 {"filecopy", 2, 2, FEARG_1, arg2_string,
2190 ret_number_bool, f_filecopy},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002191 {"filereadable", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002192 ret_number_bool, f_filereadable},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002193 {"filewritable", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002194 ret_number, f_filewritable},
Bram Moolenaar18024052021-12-25 21:43:28 +00002195 {"filter", 2, 2, FEARG_1, arg2_filter,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002196 ret_first_arg, f_filter},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002197 {"finddir", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar08018222021-12-22 18:45:37 +00002198 ret_finddir, f_finddir},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002199 {"findfile", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar10c83dd2021-09-04 14:49:56 +02002200 ret_any, f_findfile},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002201 {"flatten", 1, 2, FEARG_1, arg2_list_any_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002202 ret_list_any, f_flatten},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002203 {"flattennew", 1, 2, FEARG_1, arg2_list_any_number,
Bram Moolenaar3b690062021-02-01 20:14:51 +01002204 ret_list_any, f_flattennew},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002205 {"float2nr", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002206 ret_number, f_float2nr},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002207 {"floor", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002208 ret_float, f_floor},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002209 {"fmod", 2, 2, FEARG_1, arg2_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002210 ret_float, f_fmod},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002211 {"fnameescape", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002212 ret_string, f_fnameescape},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002213 {"fnamemodify", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002214 ret_string, f_fnamemodify},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002215 {"foldclosed", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002216 ret_number, f_foldclosed},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002217 {"foldclosedend", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002218 ret_number, f_foldclosedend},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002219 {"foldlevel", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002220 ret_number, f_foldlevel},
2221 {"foldtext", 0, 0, 0, NULL,
2222 ret_string, f_foldtext},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002223 {"foldtextresult", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002224 ret_string, f_foldtextresult},
Ernie Raele79e2072024-01-13 11:47:33 +01002225 {"foreach", 2, 2, FEARG_1, arg2_foreach,
2226 ret_first_arg, f_foreach},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002227 {"foreground", 0, 0, 0, NULL,
2228 ret_void, f_foreground},
Bram Moolenaardd44b582022-09-15 22:03:57 +01002229 {"fullcommand", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar038e09e2021-02-06 12:38:51 +01002230 ret_string, f_fullcommand},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002231 {"funcref", 1, 3, FEARG_1, arg3_any_list_dict,
Bram Moolenaar2f9f4cc2021-12-20 09:36:27 +00002232 ret_func_unknown, f_funcref},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002233 {"function", 1, 3, FEARG_1, arg3_any_list_dict,
Bram Moolenaar2f9f4cc2021-12-20 09:36:27 +00002234 ret_func_unknown, f_function},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002235 {"garbagecollect", 0, 1, 0, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002236 ret_void, f_garbagecollect},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002237 {"get", 2, 3, FEARG_1, arg23_get,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002238 ret_any, f_get},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002239 {"getbufinfo", 0, 1, FEARG_1, arg1_buffer_or_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002240 ret_list_dict_any, f_getbufinfo},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002241 {"getbufline", 2, 3, FEARG_1, arg3_buffer_lnum_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002242 ret_list_string, f_getbufline},
Bram Moolenaarce30ccc2022-11-21 19:57:04 +00002243 {"getbufoneline", 2, 2, FEARG_1, arg2_buffer_lnum,
2244 ret_string, f_getbufoneline},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002245 {"getbufvar", 2, 3, FEARG_1, arg3_buffer_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002246 ret_any, f_getbufvar},
mikoto20001083cae2024-11-11 21:24:14 +01002247 {"getcellpixels", 0, 0, 0, NULL,
mikoto2000a73dfc22024-11-18 21:12:21 +01002248 ret_list_any, f_getcellpixels},
Kota Kato66bb9ae2023-01-17 18:31:56 +00002249 {"getcellwidths", 0, 0, 0, NULL,
2250 ret_list_any, f_getcellwidths},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002251 {"getchangelist", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002252 ret_list_any, f_getchangelist},
zeertzjqe0a2ab32025-02-02 09:14:35 +01002253 {"getchar", 0, 2, 0, arg12_getchar,
Bram Moolenaar3a7503c2021-06-07 18:29:17 +02002254 ret_any, f_getchar},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002255 {"getcharmod", 0, 0, 0, NULL,
2256 ret_number, f_getcharmod},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002257 {"getcharpos", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar6f02b002021-01-10 20:22:54 +01002258 ret_list_number, f_getcharpos},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002259 {"getcharsearch", 0, 0, 0, NULL,
2260 ret_dict_any, f_getcharsearch},
zeertzjqe0a2ab32025-02-02 09:14:35 +01002261 {"getcharstr", 0, 2, 0, arg12_getchar,
Bram Moolenaar3a7503c2021-06-07 18:29:17 +02002262 ret_string, f_getcharstr},
Ruslan Russkikh0407d622024-10-08 22:21:05 +02002263 {"getcmdcomplpat", 0, 0, 0, NULL,
2264 ret_string, f_getcmdcomplpat},
Shougo Matsushita79d599b2022-05-07 12:48:29 +01002265 {"getcmdcompltype", 0, 0, 0, NULL,
2266 ret_string, f_getcmdcompltype},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002267 {"getcmdline", 0, 0, 0, NULL,
2268 ret_string, f_getcmdline},
2269 {"getcmdpos", 0, 0, 0, NULL,
2270 ret_number, f_getcmdpos},
Shougo Matsushita69084282024-09-23 20:34:47 +02002271 {"getcmdprompt", 0, 0, 0, NULL,
2272 ret_string, f_getcmdprompt},
Shougo Matsushita79d599b2022-05-07 12:48:29 +01002273 {"getcmdscreenpos", 0, 0, 0, NULL,
2274 ret_number, f_getcmdscreenpos},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002275 {"getcmdtype", 0, 0, 0, NULL,
2276 ret_string, f_getcmdtype},
2277 {"getcmdwintype", 0, 0, 0, NULL,
2278 ret_string, f_getcmdwintype},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002279 {"getcompletion", 2, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002280 ret_list_string, f_getcompletion},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002281 {"getcurpos", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002282 ret_list_number, f_getcurpos},
Bram Moolenaar82e46e52022-02-05 18:12:34 +00002283 {"getcursorcharpos", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar6f02b002021-01-10 20:22:54 +01002284 ret_list_number, f_getcursorcharpos},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002285 {"getcwd", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002286 ret_string, f_getcwd},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002287 {"getenv", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar7ad67d12021-03-10 16:08:26 +01002288 ret_any, f_getenv},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002289 {"getfontname", 0, 1, 0, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002290 ret_string, f_getfontname},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002291 {"getfperm", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002292 ret_string, f_getfperm},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002293 {"getfsize", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002294 ret_number, f_getfsize},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002295 {"getftime", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002296 ret_number, f_getftime},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002297 {"getftype", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002298 ret_string, f_getftype},
2299 {"getimstatus", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002300 ret_number_bool, f_getimstatus},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002301 {"getjumplist", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002302 ret_list_any, f_getjumplist},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002303 {"getline", 1, 2, FEARG_1, arg2_lnum,
Bram Moolenaar078a4612022-01-04 15:17:03 +00002304 ret_getline, f_getline},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002305 {"getloclist", 1, 2, 0, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002306 ret_list_or_dict_1, f_getloclist},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002307 {"getmarklist", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002308 ret_list_dict_any, f_getmarklist},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002309 {"getmatches", 0, 1, 0, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002310 ret_list_dict_any, f_getmatches},
2311 {"getmousepos", 0, 0, 0, NULL,
2312 ret_dict_number, f_getmousepos},
Bram Moolenaar24dc19c2022-11-14 19:49:15 +00002313 {"getmouseshape", 0, 0, 0, NULL,
2314 ret_string, f_getmouseshape},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002315 {"getpid", 0, 0, 0, NULL,
2316 ret_number, f_getpid},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002317 {"getpos", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002318 ret_list_number, f_getpos},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002319 {"getqflist", 0, 1, 0, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002320 ret_list_or_dict_0, f_getqflist},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002321 {"getreg", 0, 3, FEARG_1, arg3_string_bool_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002322 ret_getreg, f_getreg},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002323 {"getreginfo", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002324 ret_dict_any, f_getreginfo},
Shougo Matsushita19b71882024-02-28 22:48:12 +01002325 {"getregion", 2, 3, FEARG_1, arg3_list_list_dict,
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01002326 ret_list_string, f_getregion},
zeertzjqd4d12072024-07-16 20:34:16 +02002327 {"getregionpos", 2, 3, FEARG_1, arg3_list_list_dict,
2328 ret_list_regionpos, f_getregionpos},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002329 {"getregtype", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002330 ret_string, f_getregtype},
Yegappan Lakshmanan520f6ef2022-08-25 17:40:40 +01002331 {"getscriptinfo", 0, 1, 0, arg1_dict_any,
Yegappan Lakshmananf768c3d2022-08-22 13:15:13 +01002332 ret_list_dict_any, f_getscriptinfo},
ichizok663d18d2025-01-02 18:06:00 +01002333 {"getstacktrace", 0, 0, 0, NULL,
2334 ret_list_dict_any, f_getstacktrace},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002335 {"gettabinfo", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002336 ret_list_dict_any, f_gettabinfo},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002337 {"gettabvar", 2, 3, FEARG_1, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002338 ret_any, f_gettabvar},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002339 {"gettabwinvar", 3, 4, FEARG_1, arg4_number_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002340 ret_any, f_gettabwinvar},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002341 {"gettagstack", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002342 ret_dict_any, f_gettagstack},
Christ van Willegence0ef912024-06-20 23:41:59 +02002343 {"gettext", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002344 ret_string, f_gettext},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002345 {"getwininfo", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002346 ret_list_dict_any, f_getwininfo},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002347 {"getwinpos", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002348 ret_list_number, f_getwinpos},
2349 {"getwinposx", 0, 0, 0, NULL,
2350 ret_number, f_getwinposx},
2351 {"getwinposy", 0, 0, 0, NULL,
2352 ret_number, f_getwinposy},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002353 {"getwinvar", 2, 3, FEARG_1, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002354 ret_any, f_getwinvar},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002355 {"glob", 1, 4, FEARG_1, arg14_glob,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002356 ret_any, f_glob},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002357 {"glob2regpat", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002358 ret_string, f_glob2regpat},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002359 {"globpath", 2, 5, FEARG_2, arg25_globpath,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002360 ret_any, f_globpath},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002361 {"has", 1, 2, 0, arg2_string_bool,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002362 ret_number_bool, f_has},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002363 {"has_key", 2, 2, FEARG_1, arg2_dict_any_string_or_nr,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002364 ret_number_bool, f_has_key},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002365 {"haslocaldir", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002366 ret_number, f_haslocaldir},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002367 {"hasmapto", 1, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002368 ret_number_bool, f_hasmapto},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002369 {"highlightID", 1, 1, FEARG_1, arg1_string, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02002370 ret_number, f_hlID},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002371 {"highlight_exists",1, 1, FEARG_1, arg1_string, // obsolete
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002372 ret_number_bool, f_hlexists},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002373 {"histadd", 2, 2, FEARG_2, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002374 ret_number_bool, f_histadd},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002375 {"histdel", 1, 2, FEARG_1, arg2_string_string_or_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002376 ret_number_bool, f_histdel},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002377 {"histget", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002378 ret_string, f_histget},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002379 {"histnr", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002380 ret_number, f_histnr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002381 {"hlID", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002382 ret_number, f_hlID},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002383 {"hlexists", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002384 ret_number_bool, f_hlexists},
Yegappan Lakshmanand1a8d652021-11-03 21:56:45 +00002385 {"hlget", 0, 2, FEARG_1, arg2_string_bool,
2386 ret_list_dict_any, f_hlget},
2387 {"hlset", 1, 1, FEARG_1, arg1_list_any,
2388 ret_number_bool, f_hlset},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002389 {"hostname", 0, 0, 0, NULL,
2390 ret_string, f_hostname},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002391 {"iconv", 3, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002392 ret_string, f_iconv},
Ernie Raelc8e158b2024-07-09 18:39:52 +02002393 {"id", 1, 1, FEARG_1, NULL,
2394 ret_string, f_id},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002395 {"indent", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002396 ret_number, f_indent},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002397 {"index", 2, 4, FEARG_1, arg24_index,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002398 ret_number, f_index},
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01002399 {"indexof", 2, 3, FEARG_1, arg23_index,
2400 ret_number, f_indexof},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002401 {"input", 1, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002402 ret_string, f_input},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002403 {"inputdialog", 1, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002404 ret_string, f_inputdialog},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002405 {"inputlist", 1, 1, FEARG_1, arg1_list_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002406 ret_number, f_inputlist},
2407 {"inputrestore", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002408 ret_number_bool, f_inputrestore},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002409 {"inputsave", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002410 ret_number_bool, f_inputsave},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002411 {"inputsecret", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002412 ret_string, f_inputsecret},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002413 {"insert", 2, 3, FEARG_1, arg23_insert,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002414 ret_first_arg, f_insert},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002415 {"instanceof", 2, VARGS, FEARG_1|FE_X, arg2_instanceof,
LemonBoyafe04662023-08-23 21:08:11 +02002416 ret_bool, f_instanceof},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002417 {"interrupt", 0, 0, 0, NULL,
2418 ret_void, f_interrupt},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002419 {"invert", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002420 ret_number, f_invert},
LemonBoydca1d402022-04-28 15:26:33 +01002421 {"isabsolutepath", 1, 1, FEARG_1, arg1_string,
2422 ret_number_bool, f_isabsolutepath},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002423 {"isdirectory", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002424 ret_number_bool, f_isdirectory},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002425 {"isinf", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002426 ret_number, MATH_FUNC(f_isinf)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002427 {"islocked", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002428 ret_number_bool, f_islocked},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002429 {"isnan", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002430 ret_number_bool, MATH_FUNC(f_isnan)},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01002431 {"items", 1, 1, FEARG_1, arg1_string_list_tuple_or_dict,
Bram Moolenaarefc5db52021-07-07 21:21:30 +02002432 ret_list_items, f_items},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002433 {"job_getchannel", 1, 1, FEARG_1, arg1_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002434 ret_channel, JOB_FUNC(f_job_getchannel)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002435 {"job_info", 0, 1, FEARG_1, arg1_job,
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01002436 ret_job_info, JOB_FUNC(f_job_info)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002437 {"job_setoptions", 2, 2, FEARG_1, arg2_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002438 ret_void, JOB_FUNC(f_job_setoptions)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002439 {"job_start", 1, 2, FEARG_1, arg2_string_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002440 ret_job, JOB_FUNC(f_job_start)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002441 {"job_status", 1, 1, FEARG_1, arg1_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002442 ret_string, JOB_FUNC(f_job_status)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002443 {"job_stop", 1, 2, FEARG_1, arg2_job_string_or_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002444 ret_number_bool, JOB_FUNC(f_job_stop)},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01002445 {"join", 1, 2, FEARG_1, arg2_list_or_tuple_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002446 ret_string, f_join},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002447 {"js_decode", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002448 ret_any, f_js_decode},
2449 {"js_encode", 1, 1, FEARG_1, NULL,
2450 ret_string, f_js_encode},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002451 {"json_decode", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002452 ret_any, f_json_decode},
2453 {"json_encode", 1, 1, FEARG_1, NULL,
2454 ret_string, f_json_encode},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002455 {"keys", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002456 ret_list_string, f_keys},
zeertzjqcdc83932022-09-12 13:38:41 +01002457 {"keytrans", 1, 1, FEARG_1, arg1_string,
2458 ret_string, f_keytrans},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002459 {"last_buffer_nr", 0, 0, 0, NULL, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02002460 ret_number, f_last_buffer_nr},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002461 {"len", 1, 1, FEARG_1, arg1_len,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002462 ret_number, f_len},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002463 {"libcall", 3, 3, FEARG_3, arg3_libcall,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002464 ret_string, f_libcall},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002465 {"libcallnr", 3, 3, FEARG_3, arg3_libcall,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002466 ret_number, f_libcallnr},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002467 {"line", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002468 ret_number, f_line},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002469 {"line2byte", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002470 ret_number, f_line2byte},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002471 {"lispindent", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002472 ret_number, f_lispindent},
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +02002473 {"list2blob", 1, 1, FEARG_1, arg1_list_number,
2474 ret_blob, f_list2blob},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002475 {"list2str", 1, 2, FEARG_1, arg2_list_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002476 ret_string, f_list2str},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01002477 {"list2tuple", 1, 1, FEARG_1, arg1_list_any,
2478 ret_tuple_any, f_list2tuple},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002479 {"listener_add", 1, 2, FEARG_2, arg2_any_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002480 ret_number, f_listener_add},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002481 {"listener_flush", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002482 ret_void, f_listener_flush},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002483 {"listener_remove", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002484 ret_number_bool, f_listener_remove},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002485 {"localtime", 0, 0, 0, NULL,
2486 ret_number, f_localtime},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002487 {"log", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002488 ret_float, f_log},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002489 {"log10", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002490 ret_float, f_log10},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002491 {"luaeval", 1, 2, FEARG_1, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002492 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002493#ifdef FEAT_LUA
Bram Moolenaar15c47602020-03-26 22:16:48 +01002494 f_luaeval
2495#else
2496 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002497#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002498 },
Bram Moolenaar18024052021-12-25 21:43:28 +00002499 {"map", 2, 2, FEARG_1, arg2_map,
Bram Moolenaarea696852020-11-09 18:31:39 +01002500 ret_first_cont, f_map},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002501 {"maparg", 1, 4, FEARG_1, arg14_maparg,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002502 ret_maparg, f_maparg},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002503 {"mapcheck", 1, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002504 ret_string, f_mapcheck},
Ernie Rael09661202022-04-25 14:40:44 +01002505 {"maplist", 0, 1, 0, arg1_bool,
2506 ret_list_dict_any, f_maplist},
Bram Moolenaar18024052021-12-25 21:43:28 +00002507 {"mapnew", 2, 2, FEARG_1, arg2_mapnew,
Bram Moolenaarea696852020-11-09 18:31:39 +01002508 ret_first_cont, f_mapnew},
Ernie Rael51d04d12022-05-04 15:40:22 +01002509 {"mapset", 1, 3, FEARG_1, arg3_string_or_dict_bool_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002510 ret_void, f_mapset},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002511 {"match", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002512 ret_any, f_match},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002513 {"matchadd", 2, 5, FEARG_1, arg25_matchadd,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002514 ret_number, f_matchadd},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002515 {"matchaddpos", 2, 5, FEARG_1, arg25_matchaddpos,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002516 ret_number, f_matchaddpos},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002517 {"matcharg", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002518 ret_list_string, f_matcharg},
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01002519 {"matchbufline", 4, 5, FEARG_1, arg45_matchbufline,
2520 ret_list_any, f_matchbufline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002521 {"matchdelete", 1, 2, FEARG_1, arg2_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002522 ret_number_bool, f_matchdelete},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002523 {"matchend", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002524 ret_number, f_matchend},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002525 {"matchfuzzy", 2, 3, FEARG_1, arg3_list_string_dict,
Yegappan Lakshmanan2d8e9982023-06-24 16:42:25 +01002526 ret_list_any, f_matchfuzzy},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002527 {"matchfuzzypos", 2, 3, FEARG_1, arg3_list_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002528 ret_list_any, f_matchfuzzypos},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002529 {"matchlist", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002530 ret_list_string, f_matchlist},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002531 {"matchstr", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002532 ret_string, f_matchstr},
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01002533 {"matchstrlist", 2, 3, FEARG_1, arg23_matchstrlist,
2534 ret_list_any, f_matchstrlist},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002535 {"matchstrpos", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002536 ret_list_any, f_matchstrpos},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01002537 {"max", 1, 1, FEARG_1, arg1_list_or_tuple_or_dict,
Bram Moolenaar9ae37052021-01-22 22:31:10 +01002538 ret_number, f_max},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002539 {"menu_info", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002540 ret_dict_any,
Bram Moolenaara2cbdea2020-03-16 21:08:31 +01002541#ifdef FEAT_MENU
Bram Moolenaar15c47602020-03-26 22:16:48 +01002542 f_menu_info
2543#else
2544 NULL
Bram Moolenaara2cbdea2020-03-16 21:08:31 +01002545#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002546 },
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01002547 {"min", 1, 1, FEARG_1, arg1_list_or_tuple_or_dict,
Bram Moolenaar9ae37052021-01-22 22:31:10 +01002548 ret_number, f_min},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002549 {"mkdir", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002550 ret_number_bool, f_mkdir},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002551 {"mode", 0, 1, FEARG_1, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002552 ret_string, f_mode},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002553 {"mzeval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002554 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002555#ifdef FEAT_MZSCHEME
Bram Moolenaar15c47602020-03-26 22:16:48 +01002556 f_mzeval
2557#else
2558 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002559#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002560 },
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002561 {"nextnonblank", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002562 ret_number, f_nextnonblank},
Christ van Willegenc0786752025-02-01 15:42:16 +01002563 {"ngettext", 3, 4, FEARG_3, arg4_string_string_number_string,
2564 ret_string, f_ngettext},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002565 {"nr2char", 1, 2, FEARG_1, arg2_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002566 ret_string, f_nr2char},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002567 {"or", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002568 ret_number, f_or},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002569 {"pathshorten", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002570 ret_string, f_pathshorten},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002571 {"perleval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002572 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002573#ifdef FEAT_PERL
Bram Moolenaar15c47602020-03-26 22:16:48 +01002574 f_perleval
2575#else
2576 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002577#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002578 },
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002579 {"popup_atcursor", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002580 ret_number, PROP_FUNC(f_popup_atcursor)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002581 {"popup_beval", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002582 ret_number, PROP_FUNC(f_popup_beval)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002583 {"popup_clear", 0, 1, 0, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002584 ret_void, PROP_FUNC(f_popup_clear)},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002585 {"popup_close", 1, 2, FEARG_1, arg2_number_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002586 ret_void, PROP_FUNC(f_popup_close)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002587 {"popup_create", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002588 ret_number, PROP_FUNC(f_popup_create)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002589 {"popup_dialog", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002590 ret_number, PROP_FUNC(f_popup_dialog)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002591 {"popup_filter_menu", 2, 2, 0, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002592 ret_bool, PROP_FUNC(f_popup_filter_menu)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002593 {"popup_filter_yesno", 2, 2, 0, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002594 ret_bool, PROP_FUNC(f_popup_filter_yesno)},
Bram Moolenaarbdc09a12022-10-07 14:31:45 +01002595 {"popup_findecho", 0, 0, 0, NULL,
2596 ret_number, PROP_FUNC(f_popup_findecho)},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002597 {"popup_findinfo", 0, 0, 0, NULL,
2598 ret_number, PROP_FUNC(f_popup_findinfo)},
2599 {"popup_findpreview", 0, 0, 0, NULL,
2600 ret_number, PROP_FUNC(f_popup_findpreview)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002601 {"popup_getoptions", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002602 ret_dict_any, PROP_FUNC(f_popup_getoptions)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002603 {"popup_getpos", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002604 ret_dict_any, PROP_FUNC(f_popup_getpos)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002605 {"popup_hide", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002606 ret_void, PROP_FUNC(f_popup_hide)},
2607 {"popup_list", 0, 0, 0, NULL,
2608 ret_list_number, PROP_FUNC(f_popup_list)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002609 {"popup_locate", 2, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002610 ret_number, PROP_FUNC(f_popup_locate)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002611 {"popup_menu", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002612 ret_number, PROP_FUNC(f_popup_menu)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002613 {"popup_move", 2, 2, FEARG_1, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002614 ret_void, PROP_FUNC(f_popup_move)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002615 {"popup_notification", 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_notification)},
Christian Brabandtfbc37f12024-06-18 20:50:58 +02002617 {"popup_setbuf", 2, 2, FEARG_1, arg2_number_buffer,
2618 ret_number_bool, PROP_FUNC(f_popup_setbuf)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002619 {"popup_setoptions", 2, 2, FEARG_1, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002620 ret_void, PROP_FUNC(f_popup_setoptions)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002621 {"popup_settext", 2, 2, FEARG_1, arg2_number_string_or_list,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002622 ret_void, PROP_FUNC(f_popup_settext)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002623 {"popup_show", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002624 ret_void, PROP_FUNC(f_popup_show)},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002625 {"pow", 2, 2, FEARG_1, arg2_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002626 ret_float, f_pow},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002627 {"prevnonblank", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002628 ret_number, f_prevnonblank},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002629 {"printf", 1, 19, FEARG_2, arg119_printf,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002630 ret_string, f_printf},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002631 {"prompt_getprompt", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002632 ret_string, JOB_FUNC(f_prompt_getprompt)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002633 {"prompt_setcallback", 2, 2, FEARG_1, arg2_buffer_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002634 ret_void, JOB_FUNC(f_prompt_setcallback)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002635 {"prompt_setinterrupt", 2, 2, FEARG_1, arg2_buffer_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002636 ret_void, JOB_FUNC(f_prompt_setinterrupt)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002637 {"prompt_setprompt", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002638 ret_void, JOB_FUNC(f_prompt_setprompt)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002639 {"prop_add", 3, 3, FEARG_1, arg3_number_number_dict,
Bram Moolenaar7f9969c2022-07-25 18:13:54 +01002640 ret_number, PROP_FUNC(f_prop_add)},
Yegappan Lakshmananccfb7c62021-08-16 21:39:09 +02002641 {"prop_add_list", 2, 2, FEARG_1, arg2_dict_any_list_any,
2642 ret_void, PROP_FUNC(f_prop_add_list)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002643 {"prop_clear", 1, 3, FEARG_1, arg3_number_number_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002644 ret_void, PROP_FUNC(f_prop_clear)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002645 {"prop_find", 1, 2, FEARG_1, arg2_dict_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002646 ret_dict_any, PROP_FUNC(f_prop_find)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002647 {"prop_list", 1, 2, FEARG_1, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002648 ret_list_dict_any, PROP_FUNC(f_prop_list)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002649 {"prop_remove", 1, 3, FEARG_1, arg3_dict_number_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002650 ret_number, PROP_FUNC(f_prop_remove)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002651 {"prop_type_add", 2, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002652 ret_void, PROP_FUNC(f_prop_type_add)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002653 {"prop_type_change", 2, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002654 ret_void, PROP_FUNC(f_prop_type_change)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002655 {"prop_type_delete", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002656 ret_void, PROP_FUNC(f_prop_type_delete)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002657 {"prop_type_get", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002658 ret_dict_any, PROP_FUNC(f_prop_type_get)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002659 {"prop_type_list", 0, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002660 ret_list_string, PROP_FUNC(f_prop_type_list)},
2661 {"pum_getpos", 0, 0, 0, NULL,
2662 ret_dict_number, f_pum_getpos},
2663 {"pumvisible", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002664 ret_number_bool, f_pumvisible},
Ben Jacksonea19e782024-11-06 21:50:05 +01002665 {"py3eval", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002666 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002667#ifdef FEAT_PYTHON3
Bram Moolenaar15c47602020-03-26 22:16:48 +01002668 f_py3eval
2669#else
2670 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002671#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002672 },
Ben Jacksonea19e782024-11-06 21:50:05 +01002673 {"pyeval", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002674 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002675#ifdef FEAT_PYTHON
Bram Moolenaar15c47602020-03-26 22:16:48 +01002676 f_pyeval
2677#else
2678 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002679#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002680 },
Ben Jacksonea19e782024-11-06 21:50:05 +01002681 {"pyxeval", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002682 ret_any,
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01002683#if defined(FEAT_PYTHON) || defined(FEAT_PYTHON3)
Bram Moolenaar15c47602020-03-26 22:16:48 +01002684 f_pyxeval
2685#else
2686 NULL
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01002687#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002688 },
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002689 {"rand", 0, 1, FEARG_1, arg1_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002690 ret_number, f_rand},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002691 {"range", 1, 3, FEARG_1, arg3_number,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00002692 ret_list_number, f_range},
K.Takata11df3ae2022-10-19 14:02:40 +01002693 {"readblob", 1, 3, FEARG_1, arg3_string_number_number,
Bram Moolenaarc423ad72021-01-13 20:38:03 +01002694 ret_blob, f_readblob},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002695 {"readdir", 1, 3, FEARG_1, arg3_string_any_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002696 ret_list_string, f_readdir},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002697 {"readdirex", 1, 3, FEARG_1, arg3_string_any_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002698 ret_list_dict_any, f_readdirex},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002699 {"readfile", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaarc423ad72021-01-13 20:38:03 +01002700 ret_list_string, f_readfile},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002701 {"reduce", 2, 3, FEARG_1, arg23_reduce,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002702 ret_any, f_reduce},
2703 {"reg_executing", 0, 0, 0, NULL,
2704 ret_string, f_reg_executing},
2705 {"reg_recording", 0, 0, 0, NULL,
2706 ret_string, f_reg_recording},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002707 {"reltime", 0, 2, FEARG_1, arg2_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002708 ret_list_any, f_reltime},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002709 {"reltimefloat", 1, 1, FEARG_1, arg1_list_number,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002710 ret_float, f_reltimefloat},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002711 {"reltimestr", 1, 1, FEARG_1, arg1_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002712 ret_string, f_reltimestr},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002713 {"remote_expr", 2, 4, FEARG_1, arg24_remote_expr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002714 ret_string, f_remote_expr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002715 {"remote_foreground", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002716 ret_string, f_remote_foreground},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002717 {"remote_peek", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002718 ret_number, f_remote_peek},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002719 {"remote_read", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002720 ret_string, f_remote_read},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002721 {"remote_send", 2, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002722 ret_string, f_remote_send},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002723 {"remote_startserver", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002724 ret_void, f_remote_startserver},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002725 {"remove", 2, 3, FEARG_1, arg23_remove,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002726 ret_remove, f_remove},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002727 {"rename", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002728 ret_number_bool, f_rename},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002729 {"repeat", 2, 2, FEARG_1, arg2_repeat,
Bram Moolenaar1780f082021-07-31 22:03:59 +02002730 ret_repeat, f_repeat},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002731 {"resolve", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002732 ret_string, f_resolve},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01002733 {"reverse", 1, 1, FEARG_1, arg1_reverse,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002734 ret_first_arg, f_reverse},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002735 {"round", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002736 ret_float, f_round},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002737 {"rubyeval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002738 ret_any,
Bram Moolenaare99be0e2019-03-26 22:51:09 +01002739#ifdef FEAT_RUBY
Bram Moolenaar15c47602020-03-26 22:16:48 +01002740 f_rubyeval
2741#else
2742 NULL
Bram Moolenaare99be0e2019-03-26 22:51:09 +01002743#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002744 },
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002745 {"screenattr", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002746 ret_number, f_screenattr},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002747 {"screenchar", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002748 ret_number, f_screenchar},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002749 {"screenchars", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002750 ret_list_number, f_screenchars},
2751 {"screencol", 0, 0, 0, NULL,
2752 ret_number, f_screencol},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002753 {"screenpos", 3, 3, FEARG_1, arg3_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002754 ret_dict_number, f_screenpos},
2755 {"screenrow", 0, 0, 0, NULL,
2756 ret_number, f_screenrow},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002757 {"screenstring", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002758 ret_string, f_screenstring},
Bram Moolenaarcd268012021-07-22 19:11:08 +02002759 {"search", 1, 5, FEARG_1, arg15_search,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002760 ret_number, f_search},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002761 {"searchcount", 0, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002762 ret_dict_any, f_searchcount},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002763 {"searchdecl", 1, 3, FEARG_1, arg3_string_bool_bool,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002764 ret_number_bool, f_searchdecl},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002765 {"searchpair", 3, 7, 0, arg37_searchpair,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002766 ret_number, f_searchpair},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002767 {"searchpairpos", 3, 7, 0, arg37_searchpair,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002768 ret_list_number, f_searchpairpos},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002769 {"searchpos", 1, 5, FEARG_1, arg15_search,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002770 ret_list_number, f_searchpos},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002771 {"server2client", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002772 ret_number_bool, f_server2client},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002773 {"serverlist", 0, 0, 0, NULL,
2774 ret_string, f_serverlist},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002775 {"setbufline", 3, 3, FEARG_3, arg3_setbufline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002776 ret_number_bool, f_setbufline},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002777 {"setbufvar", 3, 3, FEARG_3, arg3_buffer_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002778 ret_void, f_setbufvar},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002779 {"setcellwidths", 1, 1, FEARG_1, arg1_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002780 ret_void, f_setcellwidths},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002781 {"setcharpos", 2, 2, FEARG_2, arg2_string_list_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002782 ret_number_bool, f_setcharpos},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002783 {"setcharsearch", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002784 ret_void, f_setcharsearch},
Shougo Matsushita07ea5f12022-08-27 12:22:25 +01002785 {"setcmdline", 1, 2, FEARG_1, arg2_string_number,
2786 ret_number_bool, f_setcmdline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002787 {"setcmdpos", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002788 ret_number_bool, f_setcmdpos},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002789 {"setcursorcharpos", 1, 3, FEARG_1, arg13_cursor,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002790 ret_number_bool, f_setcursorcharpos},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002791 {"setenv", 2, 2, FEARG_2, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002792 ret_void, f_setenv},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002793 {"setfperm", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002794 ret_number_bool, f_setfperm},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002795 {"setline", 2, 2, FEARG_2, arg2_setline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002796 ret_number_bool, f_setline},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002797 {"setloclist", 2, 4, FEARG_2, arg24_setloclist,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002798 ret_number_bool, f_setloclist},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002799 {"setmatches", 1, 2, FEARG_1, arg2_list_any_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002800 ret_number_bool, f_setmatches},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002801 {"setpos", 2, 2, FEARG_2, arg2_string_list_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002802 ret_number_bool, f_setpos},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002803 {"setqflist", 1, 3, FEARG_1, arg13_setqflist,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002804 ret_number_bool, f_setqflist},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002805 {"setreg", 2, 3, FEARG_2, arg3_string_any_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002806 ret_number_bool, f_setreg},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002807 {"settabvar", 3, 3, FEARG_3, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002808 ret_void, f_settabvar},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002809 {"settabwinvar", 4, 4, FEARG_4, arg4_number_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002810 ret_void, f_settabwinvar},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002811 {"settagstack", 2, 3, FEARG_2, arg23_settagstack,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002812 ret_number_bool, f_settagstack},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002813 {"setwinvar", 3, 3, FEARG_3, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002814 ret_void, f_setwinvar},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002815 {"sha256", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002816 ret_string,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002817#ifdef FEAT_CRYPT
Bram Moolenaar15c47602020-03-26 22:16:48 +01002818 f_sha256
2819#else
2820 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002821#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002822 },
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002823 {"shellescape", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002824 ret_string, f_shellescape},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002825 {"shiftwidth", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002826 ret_number, f_shiftwidth},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002827 {"sign_define", 1, 2, FEARG_1, arg2_string_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002828 ret_any, SIGN_FUNC(f_sign_define)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002829 {"sign_getdefined", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002830 ret_list_dict_any, SIGN_FUNC(f_sign_getdefined)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002831 {"sign_getplaced", 0, 2, FEARG_1, arg02_sign_getplaced,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002832 ret_list_dict_any, SIGN_FUNC(f_sign_getplaced)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002833 {"sign_jump", 3, 3, FEARG_1, arg3_number_string_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002834 ret_number, SIGN_FUNC(f_sign_jump)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002835 {"sign_place", 4, 5, FEARG_1, arg45_sign_place,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002836 ret_number, SIGN_FUNC(f_sign_place)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002837 {"sign_placelist", 1, 1, FEARG_1, arg1_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002838 ret_list_number, SIGN_FUNC(f_sign_placelist)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002839 {"sign_undefine", 0, 1, FEARG_1, arg1_string_or_list_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002840 ret_number_bool, SIGN_FUNC(f_sign_undefine)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002841 {"sign_unplace", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002842 ret_number_bool, SIGN_FUNC(f_sign_unplace)},
Sean Dewara63780b2021-11-03 13:15:47 +00002843 {"sign_unplacelist", 1, 1, FEARG_1, arg1_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002844 ret_list_number, SIGN_FUNC(f_sign_unplacelist)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002845 {"simplify", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002846 ret_string, f_simplify},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002847 {"sin", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002848 ret_float, f_sin},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002849 {"sinh", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002850 ret_float, f_sinh},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002851 {"slice", 2, 3, FEARG_1, arg23_slice,
Bram Moolenaar00eb9952022-02-05 19:23:18 +00002852 ret_slice, f_slice},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002853 {"sort", 1, 3, FEARG_1, arg13_sortuniq,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002854 ret_first_arg, f_sort},
2855 {"sound_clear", 0, 0, 0, NULL,
2856 ret_void, SOUND_FUNC(f_sound_clear)},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002857 {"sound_playevent", 1, 2, FEARG_1, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002858 ret_number, SOUND_FUNC(f_sound_playevent)},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002859 {"sound_playfile", 1, 2, FEARG_1, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002860 ret_number, SOUND_FUNC(f_sound_playfile)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002861 {"sound_stop", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002862 ret_void, SOUND_FUNC(f_sound_stop)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002863 {"soundfold", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002864 ret_string, f_soundfold},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002865 {"spellbadword", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002866 ret_list_string, f_spellbadword},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002867 {"spellsuggest", 1, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002868 ret_list_string, f_spellsuggest},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002869 {"split", 1, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002870 ret_list_string, f_split},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002871 {"sqrt", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002872 ret_float, f_sqrt},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002873 {"srand", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002874 ret_list_number, f_srand},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002875 {"state", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002876 ret_string, f_state},
Yegappan Lakshmanana11b23c2025-01-16 19:16:42 +01002877 {"str2blob", 1, 2, FEARG_1, arg2_list_string_dict,
Yegappan Lakshmanan1aefe1d2025-01-14 17:29:42 +01002878 ret_blob, f_str2blob},
Bram Moolenaar80a070c2021-08-08 15:51:10 +02002879 {"str2float", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002880 ret_float, f_str2float},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002881 {"str2list", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002882 ret_list_number, f_str2list},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002883 {"str2nr", 1, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002884 ret_number, f_str2nr},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002885 {"strcharlen", 1, 1, FEARG_1, arg1_string_or_nr,
Bram Moolenaar70ce8a12021-03-14 19:02:09 +01002886 ret_number, f_strcharlen},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002887 {"strcharpart", 2, 4, FEARG_1, arg24_strpart,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002888 ret_string, f_strcharpart},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002889 {"strchars", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002890 ret_number, f_strchars},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002891 {"strdisplaywidth", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002892 ret_number, f_strdisplaywidth},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002893 {"strftime", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002894 ret_string,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002895#ifdef HAVE_STRFTIME
Bram Moolenaar15c47602020-03-26 22:16:48 +01002896 f_strftime
2897#else
2898 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002899#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002900 },
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002901 {"strgetchar", 2, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002902 ret_number, f_strgetchar},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002903 {"stridx", 2, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002904 ret_number, f_stridx},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002905 {"string", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002906 ret_string, f_string},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002907 {"strlen", 1, 1, FEARG_1, arg1_string_or_nr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002908 ret_number, f_strlen},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002909 {"strpart", 2, 4, FEARG_1, arg24_strpart,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002910 ret_string, f_strpart},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002911 {"strptime", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002912 ret_number,
Bram Moolenaar10455d42019-11-21 15:36:18 +01002913#ifdef HAVE_STRPTIME
Bram Moolenaar15c47602020-03-26 22:16:48 +01002914 f_strptime
2915#else
2916 NULL
Bram Moolenaar10455d42019-11-21 15:36:18 +01002917#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002918 },
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002919 {"strridx", 2, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002920 ret_number, f_strridx},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002921 {"strtrans", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002922 ret_string, f_strtrans},
Christian Brabandt67672ef2023-04-24 21:09:54 +01002923 {"strutf16len", 1, 2, FEARG_1, arg2_string_bool,
2924 ret_number, f_strutf16len},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002925 {"strwidth", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002926 ret_number, f_strwidth},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002927 {"submatch", 1, 2, FEARG_1, arg2_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002928 ret_string, f_submatch},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002929 {"substitute", 4, 4, FEARG_1, arg4_string_string_any_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002930 ret_string, f_substitute},
Bram Moolenaarc216a7a2022-12-05 13:50:55 +00002931 {"swapfilelist", 0, 0, 0, NULL,
2932 ret_list_string, f_swapfilelist},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002933 {"swapinfo", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002934 ret_dict_any, f_swapinfo},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002935 {"swapname", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002936 ret_string, f_swapname},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002937 {"synID", 3, 3, 0, arg3_lnum_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002938 ret_number, f_synID},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002939 {"synIDattr", 2, 3, FEARG_1, arg3_number_string_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002940 ret_string, f_synIDattr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002941 {"synIDtrans", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002942 ret_number, f_synIDtrans},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002943 {"synconcealed", 2, 2, 0, arg2_lnum_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002944 ret_list_any, f_synconcealed},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002945 {"synstack", 2, 2, 0, arg2_lnum_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002946 ret_list_number, f_synstack},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002947 {"system", 1, 2, FEARG_1, arg12_system,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002948 ret_string, f_system},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002949 {"systemlist", 1, 2, FEARG_1, arg12_system,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002950 ret_list_string, f_systemlist},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002951 {"tabpagebuflist", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002952 ret_list_number, f_tabpagebuflist},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002953 {"tabpagenr", 0, 1, 0, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002954 ret_number, f_tabpagenr},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002955 {"tabpagewinnr", 1, 2, FEARG_1, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002956 ret_number, f_tabpagewinnr},
2957 {"tagfiles", 0, 0, 0, NULL,
2958 ret_list_string, f_tagfiles},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002959 {"taglist", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002960 ret_list_dict_any, f_taglist},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002961 {"tan", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002962 ret_float, f_tan},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002963 {"tanh", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002964 ret_float, f_tanh},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002965 {"tempname", 0, 0, 0, NULL,
2966 ret_string, f_tempname},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002967 {"term_dumpdiff", 2, 3, FEARG_1, arg3_string_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002968 ret_number, TERM_FUNC(f_term_dumpdiff)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002969 {"term_dumpload", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002970 ret_number, TERM_FUNC(f_term_dumpload)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002971 {"term_dumpwrite", 2, 3, FEARG_2, arg3_buffer_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002972 ret_void, TERM_FUNC(f_term_dumpwrite)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002973 {"term_getaltscreen", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002974 ret_number, TERM_FUNC(f_term_getaltscreen)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002975 {"term_getansicolors", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002976 ret_list_string,
Bram Moolenaarbd5e6222020-03-26 23:13:34 +01002977#if defined(FEAT_TERMINAL) && (defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS))
Bram Moolenaar15c47602020-03-26 22:16:48 +01002978 f_term_getansicolors
2979#else
2980 NULL
Bram Moolenaarc6df10e2017-07-29 20:15:08 +02002981#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002982 },
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002983 {"term_getattr", 2, 2, FEARG_1, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002984 ret_number, TERM_FUNC(f_term_getattr)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002985 {"term_getcursor", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002986 ret_list_any, TERM_FUNC(f_term_getcursor)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002987 {"term_getjob", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002988 ret_job, TERM_FUNC(f_term_getjob)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002989 {"term_getline", 2, 2, FEARG_1, arg2_buffer_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002990 ret_string, TERM_FUNC(f_term_getline)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002991 {"term_getscrolled", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002992 ret_number, TERM_FUNC(f_term_getscrolled)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002993 {"term_getsize", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002994 ret_list_number, TERM_FUNC(f_term_getsize)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002995 {"term_getstatus", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002996 ret_string, TERM_FUNC(f_term_getstatus)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002997 {"term_gettitle", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002998 ret_string, TERM_FUNC(f_term_gettitle)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002999 {"term_gettty", 1, 2, FEARG_1, arg2_buffer_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003000 ret_string, TERM_FUNC(f_term_gettty)},
3001 {"term_list", 0, 0, 0, NULL,
3002 ret_list_number, TERM_FUNC(f_term_list)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003003 {"term_scrape", 2, 2, FEARG_1, arg2_buffer_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003004 ret_list_dict_any, TERM_FUNC(f_term_scrape)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003005 {"term_sendkeys", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003006 ret_void, TERM_FUNC(f_term_sendkeys)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003007 {"term_setansicolors", 2, 2, FEARG_1, arg2_buffer_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003008 ret_void,
Bram Moolenaarbd5e6222020-03-26 23:13:34 +01003009#if defined(FEAT_TERMINAL) && (defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS))
Bram Moolenaar15c47602020-03-26 22:16:48 +01003010 f_term_setansicolors
3011#else
3012 NULL
3013#endif
3014 },
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003015 {"term_setapi", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003016 ret_void, TERM_FUNC(f_term_setapi)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003017 {"term_setkill", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003018 ret_void, TERM_FUNC(f_term_setkill)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003019 {"term_setrestore", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003020 ret_void, TERM_FUNC(f_term_setrestore)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003021 {"term_setsize", 3, 3, FEARG_1, arg3_buffer_number_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003022 ret_void, TERM_FUNC(f_term_setsize)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003023 {"term_start", 1, 2, FEARG_1, arg2_string_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003024 ret_number, TERM_FUNC(f_term_start)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003025 {"term_wait", 1, 2, FEARG_1, arg2_buffer_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003026 ret_void, TERM_FUNC(f_term_wait)},
3027 {"terminalprops", 0, 0, 0, NULL,
3028 ret_dict_string, f_terminalprops},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003029 {"test_alloc_fail", 3, 3, FEARG_1, arg3_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003030 ret_void, f_test_alloc_fail},
3031 {"test_autochdir", 0, 0, 0, NULL,
3032 ret_void, f_test_autochdir},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003033 {"test_feedinput", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003034 ret_void, f_test_feedinput},
3035 {"test_garbagecollect_now", 0, 0, 0, NULL,
3036 ret_void, f_test_garbagecollect_now},
3037 {"test_garbagecollect_soon", 0, 0, 0, NULL,
3038 ret_void, f_test_garbagecollect_soon},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003039 {"test_getvalue", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003040 ret_number, f_test_getvalue},
Yegappan Lakshmanan06011e12022-01-30 12:37:29 +00003041 {"test_gui_event", 2, 2, FEARG_1, arg2_string_dict,
3042 ret_bool, f_test_gui_event},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003043 {"test_ignore_error", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003044 ret_void, f_test_ignore_error},
Christopher Plewright20b795e2022-12-20 20:01:58 +00003045 {"test_mswin_event", 2, 2, FEARG_1, arg2_string_dict,
3046 ret_number, f_test_mswin_event},
Bram Moolenaar94738d82020-10-21 14:25:07 +02003047 {"test_null_blob", 0, 0, 0, NULL,
3048 ret_blob, f_test_null_blob},
3049 {"test_null_channel", 0, 0, 0, NULL,
3050 ret_channel, JOB_FUNC(f_test_null_channel)},
3051 {"test_null_dict", 0, 0, 0, NULL,
3052 ret_dict_any, f_test_null_dict},
3053 {"test_null_function", 0, 0, 0, NULL,
3054 ret_func_any, f_test_null_function},
3055 {"test_null_job", 0, 0, 0, NULL,
3056 ret_job, JOB_FUNC(f_test_null_job)},
3057 {"test_null_list", 0, 0, 0, NULL,
3058 ret_list_any, f_test_null_list},
3059 {"test_null_partial", 0, 0, 0, NULL,
3060 ret_func_any, f_test_null_partial},
3061 {"test_null_string", 0, 0, 0, NULL,
3062 ret_string, f_test_null_string},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01003063 {"test_null_tuple", 0, 0, 0, NULL,
3064 ret_tuple_any, f_test_null_tuple},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003065 {"test_option_not_set", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003066 ret_void, f_test_option_not_set},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02003067 {"test_override", 2, 2, FEARG_2, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003068 ret_void, f_test_override},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003069 {"test_refcount", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003070 ret_number, f_test_refcount},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003071 {"test_setmouse", 2, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003072 ret_void, f_test_setmouse},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003073 {"test_settime", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003074 ret_void, f_test_settime},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003075 {"test_srand_seed", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003076 ret_void, f_test_srand_seed},
3077 {"test_unknown", 0, 0, 0, NULL,
3078 ret_any, f_test_unknown},
3079 {"test_void", 0, 0, 0, NULL,
3080 ret_void, f_test_void},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02003081 {"timer_info", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003082 ret_list_dict_any, TIMER_FUNC(f_timer_info)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003083 {"timer_pause", 2, 2, FEARG_1, arg2_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003084 ret_void, TIMER_FUNC(f_timer_pause)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02003085 {"timer_start", 2, 3, FEARG_1, arg3_number_any_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003086 ret_number, TIMER_FUNC(f_timer_start)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02003087 {"timer_stop", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003088 ret_void, TIMER_FUNC(f_timer_stop)},
3089 {"timer_stopall", 0, 0, 0, NULL,
3090 ret_void, TIMER_FUNC(f_timer_stopall)},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003091 {"tolower", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003092 ret_string, f_tolower},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003093 {"toupper", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003094 ret_string, f_toupper},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003095 {"tr", 3, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003096 ret_string, f_tr},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003097 {"trim", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003098 ret_string, f_trim},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003099 {"trunc", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01003100 ret_float, f_trunc},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01003101 {"tuple2list", 1, 1, FEARG_1, arg1_tuple_any,
3102 ret_list_any, f_tuple2list},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003103 {"type", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003104 ret_number, f_type},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003105 {"typename", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaara47e05f2021-01-12 21:49:00 +01003106 ret_string, f_typename},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02003107 {"undofile", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003108 ret_string, f_undofile},
Devin J. Pohly5fee1112023-04-23 20:26:59 -05003109 {"undotree", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003110 ret_dict_any, f_undotree},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02003111 {"uniq", 1, 3, FEARG_1, arg13_sortuniq,
Bram Moolenaar08018222021-12-22 18:45:37 +00003112 ret_first_arg, f_uniq},
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01003113 {"utf16idx", 2, 4, FEARG_1, arg4_string_number_bool_bool,
Christian Brabandt67672ef2023-04-24 21:09:54 +01003114 ret_number, f_utf16idx},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02003115 {"values", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar32517c42023-01-15 18:17:12 +00003116 ret_list_member, f_values},
zeertzjq825cf812023-08-17 22:55:25 +02003117 {"virtcol", 1, 3, FEARG_1, arg3_string_or_list_bool_number,
LemonBoy0f7a3e12022-05-26 12:10:37 +01003118 ret_virtcol, f_virtcol},
Bram Moolenaar5a6ec102022-05-27 21:58:00 +01003119 {"virtcol2col", 3, 3, FEARG_1, arg3_number,
3120 ret_number, f_virtcol2col},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02003121 {"visualmode", 0, 1, 0, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003122 ret_string, f_visualmode},
3123 {"wildmenumode", 0, 0, 0, NULL,
3124 ret_number, f_wildmenumode},
Bram Moolenaar52312242021-07-11 18:23:19 +02003125 {"win_execute", 2, 3, FEARG_2, arg23_win_execute,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003126 ret_string, f_win_execute},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02003127 {"win_findbuf", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003128 ret_list_number, f_win_findbuf},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02003129 {"win_getid", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003130 ret_number, f_win_getid},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003131 {"win_gettype", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003132 ret_string, f_win_gettype},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003133 {"win_gotoid", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01003134 ret_number_bool, f_win_gotoid},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003135 {"win_id2tabwin", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003136 ret_list_number, f_win_id2tabwin},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003137 {"win_id2win", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003138 ret_number, f_win_id2win},
Daniel Steinbergee630312022-01-10 13:36:34 +00003139 {"win_move_separator", 2, 2, FEARG_1, arg2_number,
3140 ret_number_bool, f_win_move_separator},
3141 {"win_move_statusline", 2, 2, FEARG_1, arg2_number,
3142 ret_number_bool, f_win_move_statusline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003143 {"win_screenpos", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003144 ret_list_number, f_win_screenpos},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02003145 {"win_splitmove", 2, 3, FEARG_1, arg3_number_number_dict,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01003146 ret_number_bool, f_win_splitmove},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003147 {"winbufnr", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003148 ret_number, f_winbufnr},
3149 {"wincol", 0, 0, 0, NULL,
3150 ret_number, f_wincol},
3151 {"windowsversion", 0, 0, 0, NULL,
3152 ret_string, f_windowsversion},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003153 {"winheight", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003154 ret_number, f_winheight},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003155 {"winlayout", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003156 ret_list_any, f_winlayout},
3157 {"winline", 0, 0, 0, NULL,
3158 ret_number, f_winline},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02003159 {"winnr", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003160 ret_number, f_winnr},
3161 {"winrestcmd", 0, 0, 0, NULL,
3162 ret_string, f_winrestcmd},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02003163 {"winrestview", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003164 ret_void, f_winrestview},
3165 {"winsaveview", 0, 0, 0, NULL,
Bram Moolenaar43b69b32021-01-07 20:23:33 +01003166 ret_dict_number, f_winsaveview},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003167 {"winwidth", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003168 ret_number, f_winwidth},
3169 {"wordcount", 0, 0, 0, NULL,
3170 ret_dict_number, f_wordcount},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02003171 {"writefile", 2, 3, FEARG_1, arg23_writefile,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01003172 ret_number_bool, f_writefile},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003173 {"xor", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003174 ret_number, f_xor},
Bram Moolenaarac92e252019-08-03 21:58:38 +02003175};
3176
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003177/*
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003178 * Return true if specified function allows a type as an argument.
3179 */
3180 static int
3181func_allows_type(int idx)
3182{
3183 return (global_functions[idx].f_argtype & FE_X) != 0;
3184}
3185
3186/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003187 * Function given to ExpandGeneric() to obtain the list of internal
3188 * or user defined function names.
3189 */
3190 char_u *
3191get_function_name(expand_T *xp, int idx)
3192{
3193 static int intidx = -1;
3194 char_u *name;
3195
3196 if (idx == 0)
3197 intidx = -1;
3198 if (intidx < 0)
3199 {
3200 name = get_user_func_name(xp, idx);
naohiro ono5aec7552021-08-19 21:20:41 +02003201 if (name != NULL)
Bram Moolenaar1bb4de52021-01-13 19:48:46 +01003202 {
naohiro ono5aec7552021-08-19 21:20:41 +02003203 if (*name != NUL && *name != '<'
3204 && STRNCMP("g:", xp->xp_pattern, 2) == 0)
Bram Moolenaar1bb4de52021-01-13 19:48:46 +01003205 return cat_prefix_varname('g', name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003206 return name;
Bram Moolenaar1bb4de52021-01-13 19:48:46 +01003207 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003208 }
K.Takataeeec2542021-06-02 13:28:16 +02003209 if (++intidx < (int)ARRAY_LENGTH(global_functions))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003210 {
Kota Kato90c23532023-01-18 15:27:38 +00003211 // Skip if the function doesn't have an implementation (feature not
3212 // implemented).
3213 if (global_functions[intidx].f_func == NULL)
3214 return (char_u *)"";
Bram Moolenaarac92e252019-08-03 21:58:38 +02003215 STRCPY(IObuff, global_functions[intidx].f_name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003216 STRCAT(IObuff, "(");
Bram Moolenaarac92e252019-08-03 21:58:38 +02003217 if (global_functions[intidx].f_max_argc == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003218 STRCAT(IObuff, ")");
3219 return IObuff;
3220 }
3221
3222 return NULL;
3223}
3224
3225/*
3226 * Function given to ExpandGeneric() to obtain the list of internal or
3227 * user defined variable or function names.
3228 */
3229 char_u *
3230get_expr_name(expand_T *xp, int idx)
3231{
3232 static int intidx = -1;
3233 char_u *name;
3234
3235 if (idx == 0)
3236 intidx = -1;
3237 if (intidx < 0)
3238 {
3239 name = get_function_name(xp, idx);
3240 if (name != NULL)
3241 return name;
3242 }
3243 return get_user_var_name(xp, ++intidx);
3244}
3245
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003246/*
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003247 * Find internal function "name" in table "global_functions".
Bram Moolenaar15c47602020-03-26 22:16:48 +01003248 * Return index, or -1 if not found or "implemented" is TRUE and the function
3249 * is not implemented.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003250 */
Bram Moolenaar15c47602020-03-26 22:16:48 +01003251 static int
3252find_internal_func_opt(char_u *name, int implemented)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003253{
3254 int first = 0;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003255 int last;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003256 int cmp;
3257 int x;
3258
K.Takataeeec2542021-06-02 13:28:16 +02003259 last = (int)ARRAY_LENGTH(global_functions) - 1;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003260
3261 // Find the function name in the table. Binary search.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003262 while (first <= last)
3263 {
3264 x = first + ((unsigned)(last - first) >> 1);
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003265 cmp = STRCMP(name, global_functions[x].f_name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003266 if (cmp < 0)
3267 last = x - 1;
3268 else if (cmp > 0)
3269 first = x + 1;
Bram Moolenaar15c47602020-03-26 22:16:48 +01003270 else if (implemented && global_functions[x].f_func == NULL)
3271 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003272 else
3273 return x;
3274 }
3275 return -1;
3276}
3277
Bram Moolenaar15c47602020-03-26 22:16:48 +01003278/*
3279 * Find internal function "name" in table "global_functions".
3280 * Return index, or -1 if not found or the function is not implemented.
3281 */
3282 int
3283find_internal_func(char_u *name)
3284{
3285 return find_internal_func_opt(name, TRUE);
3286}
3287
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003288 int
Bram Moolenaarac92e252019-08-03 21:58:38 +02003289has_internal_func(char_u *name)
3290{
Bram Moolenaar15c47602020-03-26 22:16:48 +01003291 return find_internal_func_opt(name, TRUE) >= 0;
3292}
3293
3294 static int
3295has_internal_func_name(char_u *name)
3296{
3297 return find_internal_func_opt(name, FALSE) >= 0;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003298}
3299
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003300 char *
3301internal_func_name(int idx)
3302{
3303 return global_functions[idx].f_name;
3304}
3305
Bram Moolenaar94738d82020-10-21 14:25:07 +02003306/*
Dominique Pellefe8ebdb2021-05-13 14:55:55 +02003307 * Check the argument types for builtin function "idx".
Bram Moolenaar94738d82020-10-21 14:25:07 +02003308 * Uses the list of types on the type stack: "types".
3309 * Return FAIL and gives an error message when a type is wrong.
3310 */
3311 int
Bram Moolenaar351ead02021-01-16 16:07:01 +01003312internal_func_check_arg_types(
Bram Moolenaar078a4612022-01-04 15:17:03 +00003313 type2_T *types,
Bram Moolenaar351ead02021-01-16 16:07:01 +01003314 int idx,
3315 int argcount,
3316 cctx_T *cctx)
Bram Moolenaar94738d82020-10-21 14:25:07 +02003317{
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003318 // Some internal functions accept types like Class as arguments. For other
3319 // functions, check the arguments are not types.
3320 if (!(func_allows_type(idx)))
3321 {
zeertzjqd9be94c2024-07-14 10:20:20 +02003322 for (int i = 0; i < argcount; ++i)
3323 if (check_type_is_value(types[i].type_curr) == FAIL)
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003324 return FAIL;
3325 }
3326
Bram Moolenaar94738d82020-10-21 14:25:07 +02003327 argcheck_T *argchecks = global_functions[idx].f_argcheck;
Bram Moolenaar94738d82020-10-21 14:25:07 +02003328
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003329 if (argchecks == NULL)
3330 return OK;
Bram Moolenaar94738d82020-10-21 14:25:07 +02003331
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003332 argcontext_T context;
3333
3334 context.arg_count = argcount;
3335 context.arg_types = types;
3336 context.arg_cctx = cctx;
Ernie Raela8f7f922023-12-14 20:17:04 +01003337 for (int i = 0; i < argcount && argchecks[i] != NULL; ++i)
3338 {
3339 context.arg_idx = i;
3340 if (argchecks[i](types[i].type_curr, types[i].type_decl,
3341 &context) == FAIL)
3342 return FAIL;
3343 }
Bram Moolenaar94738d82020-10-21 14:25:07 +02003344 return OK;
3345}
3346
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003347/*
Bram Moolenaar7a40ff02021-07-04 15:54:08 +02003348 * Get the argument count for function "idx".
3349 * "argcount" is the total argument count, "min_argcount" the non-optional
3350 * argument count.
3351 */
3352 void
3353internal_func_get_argcount(int idx, int *argcount, int *min_argcount)
3354{
3355 *argcount = global_functions[idx].f_max_argc;
3356 *min_argcount = global_functions[idx].f_min_argc;
3357}
3358
3359/*
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003360 * Call the "f_retfunc" function to obtain the return type of function "idx".
Bram Moolenaar81330182022-02-01 12:11:58 +00003361 * "decl_type" is set to the declared type.
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003362 * "argtypes" is the list of argument types or NULL when there are no
3363 * arguments.
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02003364 * "argcount" may be less than the actual count when only getting the type.
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003365 */
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003366 type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00003367internal_func_ret_type(
3368 int idx,
3369 int argcount,
3370 type2_T *argtypes,
Bram Moolenaar32517c42023-01-15 18:17:12 +00003371 type_T **decl_type,
3372 garray_T *type_gap)
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003373{
Bram Moolenaar81330182022-02-01 12:11:58 +00003374 type_T *ret;
3375
Bram Moolenaar32517c42023-01-15 18:17:12 +00003376 current_type_gap = type_gap;
Bram Moolenaar81330182022-02-01 12:11:58 +00003377 *decl_type = NULL;
3378 ret = global_functions[idx].f_retfunc(argcount, argtypes, decl_type);
3379 if (*decl_type == NULL)
3380 *decl_type = ret;
Bram Moolenaar32517c42023-01-15 18:17:12 +00003381 current_type_gap = NULL;
Bram Moolenaar81330182022-02-01 12:11:58 +00003382 return ret;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003383}
3384
3385/*
Bram Moolenaar75ab91f2021-01-10 22:42:50 +01003386 * Return TRUE if "idx" is for the map() function.
3387 */
3388 int
3389internal_func_is_map(int idx)
3390{
3391 return global_functions[idx].f_func == f_map;
3392}
3393
3394/*
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003395 * Check the argument count to use for internal function "idx".
Bram Moolenaar389df252020-07-09 21:20:47 +02003396 * Returns -1 for failure, 0 if no method base accepted, 1 if method base is
3397 * first argument, 2 if method base is second argument, etc. 9 if method base
3398 * is last argument.
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003399 */
3400 int
3401check_internal_func(int idx, int argcount)
3402{
Bram Moolenaar0917e862023-02-18 14:42:44 +00003403 funcerror_T res;
3404 char *name;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003405
3406 if (argcount < global_functions[idx].f_min_argc)
3407 res = FCERR_TOOFEW;
3408 else if (argcount > global_functions[idx].f_max_argc)
3409 res = FCERR_TOOMANY;
3410 else
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003411 return global_functions[idx].f_argtype & FEARG_MASK;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003412
3413 name = internal_func_name(idx);
3414 if (res == FCERR_TOOMANY)
Bram Moolenaare1242042021-12-16 20:56:57 +00003415 semsg(_(e_too_many_arguments_for_function_str), name);
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003416 else
Bram Moolenaare1242042021-12-16 20:56:57 +00003417 semsg(_(e_not_enough_arguments_for_function_str), name);
Bram Moolenaar389df252020-07-09 21:20:47 +02003418 return -1;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003419}
3420
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003421/*
3422 * Some internal functions accept types like Class as arguments. For other
3423 * functions, check the arguments are not types.
3424 *
3425 * Return OK/FAIL.
3426 */
3427 static int
3428check_args_for_type(int idx, int argcount, typval_T *argvars)
3429{
3430 if (!func_allows_type(idx))
3431 {
3432 for (int i = 0; i < argcount; ++i)
3433 if (check_typval_is_value(&argvars[i]) == FAIL)
3434 return FAIL;
3435 }
3436 return OK;
3437}
3438
Bram Moolenaar0917e862023-02-18 14:42:44 +00003439 funcerror_T
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003440call_internal_func(
3441 char_u *name,
3442 int argcount,
3443 typval_T *argvars,
3444 typval_T *rettv)
3445{
3446 int i;
3447
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003448 i = find_internal_func(name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003449 if (i < 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01003450 return FCERR_UNKNOWN;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003451 if (argcount < global_functions[i].f_min_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003452 return FCERR_TOOFEW;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003453 if (argcount > global_functions[i].f_max_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003454 return FCERR_TOOMANY;
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003455 if (check_args_for_type(i, argcount, argvars) == FAIL)
3456 return FCERR_OTHER;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003457 argvars[argcount].v_type = VAR_UNKNOWN;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003458 global_functions[i].f_func(argvars, rettv);
Bram Moolenaaref140542019-12-31 21:27:13 +01003459 return FCERR_NONE;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003460}
3461
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003462 void
3463call_internal_func_by_idx(
3464 int idx,
3465 typval_T *argvars,
3466 typval_T *rettv)
3467{
3468 global_functions[idx].f_func(argvars, rettv);
3469}
3470
Bram Moolenaarac92e252019-08-03 21:58:38 +02003471/*
3472 * Invoke a method for base->method().
3473 */
Bram Moolenaar0917e862023-02-18 14:42:44 +00003474 funcerror_T
Bram Moolenaarac92e252019-08-03 21:58:38 +02003475call_internal_method(
3476 char_u *name,
3477 int argcount,
3478 typval_T *argvars,
3479 typval_T *rettv,
3480 typval_T *basetv)
3481{
Bram Moolenaarac92e252019-08-03 21:58:38 +02003482 int fi;
3483 typval_T argv[MAX_FUNC_ARGS + 1];
3484
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003485 fi = find_internal_func(name);
Bram Moolenaar91746392019-08-16 22:22:31 +02003486 if (fi < 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01003487 return FCERR_UNKNOWN;
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003488 if ((global_functions[fi].f_argtype & FEARG_MASK) == 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01003489 return FCERR_NOTMETHOD;
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003490 if (argcount + 1 < global_functions[fi].f_min_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003491 return FCERR_TOOFEW;
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003492 if (argcount + 1 > global_functions[fi].f_max_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003493 return FCERR_TOOMANY;
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003494 if (check_args_for_type(fi, argcount, argvars) == FAIL)
3495 return FCERR_OTHER;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003496
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003497 if ((global_functions[fi].f_argtype & FEARG_MASK) == FEARG_2)
Bram Moolenaar25e42232019-08-04 15:04:10 +02003498 {
Bram Moolenaarb7f22702023-04-27 16:24:07 +01003499 if (argcount < 1)
3500 return FCERR_TOOFEW;
3501
Bram Moolenaar25e42232019-08-04 15:04:10 +02003502 // base value goes second
3503 argv[0] = argvars[0];
3504 argv[1] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003505 for (int i = 1; i < argcount; ++i)
Bram Moolenaar25e42232019-08-04 15:04:10 +02003506 argv[i + 1] = argvars[i];
3507 }
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003508 else if ((global_functions[fi].f_argtype & FEARG_MASK) == FEARG_3)
Bram Moolenaar24278d22019-08-16 21:49:22 +02003509 {
Bram Moolenaarb7f22702023-04-27 16:24:07 +01003510 if (argcount < 2)
3511 return FCERR_TOOFEW;
3512
Bram Moolenaar24278d22019-08-16 21:49:22 +02003513 // base value goes third
3514 argv[0] = argvars[0];
3515 argv[1] = argvars[1];
3516 argv[2] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003517 for (int i = 2; i < argcount; ++i)
Bram Moolenaar24278d22019-08-16 21:49:22 +02003518 argv[i + 1] = argvars[i];
3519 }
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003520 else if ((global_functions[fi].f_argtype & FEARG_MASK) == FEARG_4)
Bram Moolenaaraad222c2019-09-06 22:46:09 +02003521 {
Bram Moolenaarb7f22702023-04-27 16:24:07 +01003522 if (argcount < 3)
3523 return FCERR_TOOFEW;
3524
Bram Moolenaaraad222c2019-09-06 22:46:09 +02003525 // base value goes fourth
3526 argv[0] = argvars[0];
3527 argv[1] = argvars[1];
3528 argv[2] = argvars[2];
3529 argv[3] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003530 for (int i = 3; i < argcount; ++i)
Bram Moolenaaraad222c2019-09-06 22:46:09 +02003531 argv[i + 1] = argvars[i];
3532 }
Bram Moolenaar25e42232019-08-04 15:04:10 +02003533 else
3534 {
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003535 // FEARG_1: base value goes first
Bram Moolenaar25e42232019-08-04 15:04:10 +02003536 argv[0] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003537 for (int i = 0; i < argcount; ++i)
Bram Moolenaar25e42232019-08-04 15:04:10 +02003538 argv[i + 1] = argvars[i];
3539 }
Bram Moolenaarac92e252019-08-03 21:58:38 +02003540 argv[argcount + 1].v_type = VAR_UNKNOWN;
3541
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003542 if (check_args_for_type(fi, argcount + 1, argv) == FAIL)
3543 return FCERR_OTHER;
3544
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003545 global_functions[fi].f_func(argv, rettv);
Bram Moolenaaref140542019-12-31 21:27:13 +01003546 return FCERR_NONE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003547}
3548
3549/*
3550 * Return TRUE for a non-zero Number and a non-empty String.
3551 */
Bram Moolenaar0e57dd82019-09-16 22:56:03 +02003552 int
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003553non_zero_arg(typval_T *argvars)
3554{
3555 return ((argvars[0].v_type == VAR_NUMBER
3556 && argvars[0].vval.v_number != 0)
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01003557 || (argvars[0].v_type == VAR_BOOL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003558 && argvars[0].vval.v_number == VVAL_TRUE)
3559 || (argvars[0].v_type == VAR_STRING
3560 && argvars[0].vval.v_string != NULL
3561 && *argvars[0].vval.v_string != NUL));
3562}
3563
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003564/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003565 * "and(expr, expr)" function
3566 */
3567 static void
3568f_and(typval_T *argvars, typval_T *rettv)
3569{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003570 if (in_vim9script()
3571 && (check_for_number_arg(argvars, 0) == FAIL
3572 || check_for_number_arg(argvars, 1) == FAIL))
3573 return;
3574
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003575 rettv->vval.v_number = tv_get_number_chk(&argvars[0], NULL)
3576 & tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaarca851592018-06-06 21:04:07 +02003577}
3578
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003579/*
Bram Moolenaar59716a22017-03-01 20:32:44 +01003580 * "balloon_show()" function
3581 */
3582#ifdef FEAT_BEVAL
3583 static void
Bram Moolenaarbe0a2592019-05-09 13:50:16 +02003584f_balloon_gettext(typval_T *argvars UNUSED, typval_T *rettv)
3585{
3586 rettv->v_type = VAR_STRING;
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003587 if (balloonEval == NULL)
3588 return;
3589
3590 if (balloonEval->msg == NULL)
3591 rettv->vval.v_string = NULL;
3592 else
3593 rettv->vval.v_string = vim_strsave(balloonEval->msg);
Bram Moolenaarbe0a2592019-05-09 13:50:16 +02003594}
3595
3596 static void
Bram Moolenaar59716a22017-03-01 20:32:44 +01003597f_balloon_show(typval_T *argvars, typval_T *rettv UNUSED)
3598{
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003599 if (balloonEval == NULL)
3600 return;
3601
3602 if (in_vim9script()
3603 && check_for_string_or_list_arg(argvars, 0) == FAIL)
3604 return;
3605
3606 if (argvars[0].v_type == VAR_LIST
3607# ifdef FEAT_GUI
3608 && !gui.in_use
3609# endif
3610 )
Bram Moolenaar246fe032017-11-19 19:56:27 +01003611 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003612 list_T *l = argvars[0].vval.v_list;
3613
3614 // empty list removes the balloon
3615 post_balloon(balloonEval, NULL,
3616 l == NULL || l->lv_len == 0 ? NULL : l);
3617 }
3618 else
3619 {
3620 char_u *mesg;
3621
3622 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003623 return;
3624
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003625 mesg = tv_get_string_chk(&argvars[0]);
3626 if (mesg != NULL)
3627 // empty string removes the balloon
3628 post_balloon(balloonEval, *mesg == NUL ? NULL : mesg, NULL);
Bram Moolenaar246fe032017-11-19 19:56:27 +01003629 }
3630}
3631
Bram Moolenaar669a8282017-11-19 20:13:05 +01003632# if defined(FEAT_BEVAL_TERM)
Bram Moolenaar246fe032017-11-19 19:56:27 +01003633 static void
3634f_balloon_split(typval_T *argvars, typval_T *rettv UNUSED)
3635{
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003636 if (rettv_list_alloc(rettv) != OK)
3637 return;
3638
3639 char_u *msg;
3640
3641 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
3642 return;
3643 msg = tv_get_string_chk(&argvars[0]);
3644 if (msg != NULL)
Bram Moolenaar246fe032017-11-19 19:56:27 +01003645 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003646 pumitem_T *array;
3647 int size = split_message(msg, &array);
Bram Moolenaar246fe032017-11-19 19:56:27 +01003648
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003649 // Skip the first and last item, they are always empty.
3650 for (int i = 1; i < size - 1; ++i)
3651 list_append_string(rettv->vval.v_list, array[i].pum_text, -1);
3652 while (size > 0)
3653 vim_free(array[--size].pum_text);
3654 vim_free(array);
Bram Moolenaar246fe032017-11-19 19:56:27 +01003655 }
Bram Moolenaar59716a22017-03-01 20:32:44 +01003656}
Bram Moolenaar669a8282017-11-19 20:13:05 +01003657# endif
Bram Moolenaar59716a22017-03-01 20:32:44 +01003658#endif
3659
Yegappan Lakshmanan810785c2024-12-30 10:29:44 +01003660// Base64 character set
3661static const char_u base64_table[] = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
3662
3663// Base64 decoding table (initialized in init_base64_dec_table() below)
3664static char_u base64_dec_table[256];
3665
3666/*
3667 * Initialize the base64 decoding table
3668 */
3669 static void
3670init_base64_dec_table(void)
3671{
3672 static int base64_dec_tbl_initialized = FALSE;
3673
3674 if (base64_dec_tbl_initialized)
3675 return;
3676
3677 // Unsupported characters are set to 0xFF
3678 vim_memset(base64_dec_table, 0xFF, sizeof(base64_dec_table));
3679
3680 // Initialize the index for the base64 alphabets
3681 for (size_t i = 0; i < sizeof(base64_table) - 1; i++)
3682 base64_dec_table[(char_u)base64_table[i]] = (char_u)i;
3683
3684 // base64 padding character
3685 base64_dec_table['='] = 0;
3686
3687 base64_dec_tbl_initialized = TRUE;
3688}
3689
3690/*
3691 * Encode the bytes in "blob" using base-64 encoding.
3692 */
3693 static char_u *
3694base64_encode(blob_T *blob)
3695{
3696 size_t input_len = blob->bv_ga.ga_len;
3697 size_t encoded_len = ((input_len + 2) / 3) * 4;
3698 char_u *data = blob->bv_ga.ga_data;
3699
3700 char_u *encoded = alloc(encoded_len + 1);
3701 if (encoded == NULL)
3702 return NULL;
3703
3704 size_t i, j;
3705 for (i = 0, j = 0; i < input_len;)
3706 {
3707 int_u octet_a = i < input_len ? data[i++] : 0;
3708 int_u octet_b = i < input_len ? data[i++] : 0;
3709 int_u octet_c = i < input_len ? data[i++] : 0;
3710
3711 int_u triple = (octet_a << 16) | (octet_b << 8) | octet_c;
3712
3713 encoded[j++] = base64_table[(triple >> 18) & 0x3F];
3714 encoded[j++] = base64_table[(triple >> 12) & 0x3F];
3715 encoded[j++] = (!octet_b && i >= input_len) ? '='
3716 : base64_table[(triple >> 6) & 0x3F];
3717 encoded[j++] = (!octet_c && i >= input_len) ? '='
3718 : base64_table[triple & 0x3F];
3719 }
3720 encoded[j] = NUL;
3721
3722 return encoded;
3723}
3724
3725/*
3726 * Decode the string "data" using base-64 encoding.
3727 */
3728 static void
3729base64_decode(const char_u *data, blob_T *blob)
3730{
3731 size_t input_len = STRLEN(data);
3732
3733 if (input_len == 0)
3734 return;
3735
3736 if (input_len % 4 != 0)
3737 {
3738 // Invalid input length
3739 semsg(_(e_invalid_argument_str), data);
3740 return;
3741 }
3742
3743 init_base64_dec_table();
3744
3745 size_t decoded_len = (input_len / 4) * 3;
3746 if (data[input_len - 1] == '=')
3747 decoded_len--;
3748 if (data[input_len - 2] == '=')
3749 decoded_len--;
3750
3751 size_t i, j;
3752 for (i = 0, j = 0; i < input_len;)
3753 {
3754 int_u sextet_a = base64_dec_table[(char_u)data[i++]];
3755 int_u sextet_b = base64_dec_table[(char_u)data[i++]];
3756 int_u sextet_c = base64_dec_table[(char_u)data[i++]];
3757 int_u sextet_d = base64_dec_table[(char_u)data[i++]];
3758
3759 if (sextet_a == 0xFF || sextet_b == 0xFF || sextet_c == 0xFF
3760 || sextet_d == 0xFF)
3761 {
3762 // Invalid character
3763 semsg(_(e_invalid_argument_str), data);
3764 ga_clear(&blob->bv_ga);
3765 return;
3766 }
3767
3768 int_u triple = (sextet_a << 18) | (sextet_b << 12)
3769 | (sextet_c << 6) | sextet_d;
3770
3771 if (j < decoded_len)
3772 {
3773 ga_append(&blob->bv_ga, (triple >> 16) & 0xFF);
3774 j++;
3775 }
3776 if (j < decoded_len)
3777 {
3778 ga_append(&blob->bv_ga, (triple >> 8) & 0xFF);
3779 j++;
3780 }
3781 if (j < decoded_len)
3782 {
3783 ga_append(&blob->bv_ga, triple & 0xFF);
3784 j++;
3785 }
3786
3787 if (j == decoded_len)
3788 {
3789 // Check for invalid padding bytes (based on the
3790 // "Base64 Malleability in Practice" ACM paper).
3791 if ((data[input_len - 2] == '=' && ((sextet_b & 0xF) != 0))
3792 || ((data[input_len - 1] == '=') && ((sextet_c & 0x3) != 0)))
3793 {
3794 semsg(_(e_invalid_argument_str), data);
3795 ga_clear(&blob->bv_ga);
3796 return;
3797 }
3798 }
3799 }
3800}
3801
3802/*
3803 * "base64_decode(string)" function
3804 */
3805 static void
3806f_base64_decode(typval_T *argvars, typval_T *rettv)
3807{
3808 if (check_for_string_arg(argvars, 0) == FAIL)
3809 return;
3810
3811 if (rettv_blob_alloc(rettv) == FAIL)
3812 return;
3813
3814 char_u *str = tv_get_string_chk(&argvars[0]);
3815 if (str != NULL)
3816 base64_decode(str, rettv->vval.v_blob);
3817}
3818
3819/*
3820 * "base64_encode(blob)" function
3821 */
3822 static void
3823f_base64_encode(typval_T *argvars, typval_T *rettv)
3824{
3825 if (check_for_blob_arg(argvars, 0) == FAIL)
3826 return;
3827
3828 rettv->v_type = VAR_STRING;
3829 rettv->vval.v_string = NULL;
3830
3831 blob_T *blob = argvars->vval.v_blob;
3832 if (blob != NULL)
3833 rettv->vval.v_string = base64_encode(blob);
3834}
3835
Bram Moolenaar59716a22017-03-01 20:32:44 +01003836/*
Bram Moolenaar6b7b7192019-01-11 13:42:41 +01003837 * Get the buffer from "arg" and give an error and return NULL if it is not
3838 * valid.
3839 */
Bram Moolenaara3347722019-05-11 21:14:24 +02003840 buf_T *
Bram Moolenaar6b7b7192019-01-11 13:42:41 +01003841get_buf_arg(typval_T *arg)
3842{
3843 buf_T *buf;
3844
3845 ++emsg_off;
3846 buf = tv_get_buf(arg, FALSE);
3847 --emsg_off;
3848 if (buf == NULL)
Bram Moolenaard82a47d2022-01-05 20:24:39 +00003849 semsg(_(e_invalid_buffer_name_str), tv_get_string(arg));
Bram Moolenaar6b7b7192019-01-11 13:42:41 +01003850 return buf;
3851}
3852
3853/*
Christ van Willegence0ef912024-06-20 23:41:59 +02003854 * "bindtextdomain(package, path)" function
3855 */
3856 static void
Christ van Willegen8252ef12024-07-11 21:36:21 +02003857f_bindtextdomain(typval_T *argvars, typval_T *rettv)
Christ van Willegence0ef912024-06-20 23:41:59 +02003858{
Christ van Willegen8252ef12024-07-11 21:36:21 +02003859 rettv->v_type = VAR_BOOL;
3860 rettv->vval.v_number = VVAL_TRUE;
3861
Christ van Willegence0ef912024-06-20 23:41:59 +02003862 if (check_for_nonempty_string_arg(argvars, 0) == FAIL
3863 || check_for_nonempty_string_arg(argvars, 1) == FAIL)
3864 return;
3865
3866 if (strcmp((const char *)argvars[0].vval.v_string, VIMPACKAGE) == 0)
3867 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[0]));
3868 else
Christ van Willegen8252ef12024-07-11 21:36:21 +02003869 {
3870 if (bindtextdomain((const char *)argvars[0].vval.v_string, (const char *)argvars[1].vval.v_string) == NULL)
3871 {
3872 do_outofmem_msg((long)0);
3873 rettv->vval.v_number = VVAL_FALSE;
3874 }
3875 }
Christ van Willegence0ef912024-06-20 23:41:59 +02003876
3877 return;
3878}
3879
3880/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003881 * "byte2line(byte)" function
3882 */
3883 static void
3884f_byte2line(typval_T *argvars UNUSED, typval_T *rettv)
3885{
3886#ifndef FEAT_BYTEOFF
3887 rettv->vval.v_number = -1;
3888#else
3889 long boff = 0;
3890
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003891 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
3892 return;
3893
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01003894 boff = tv_get_number(&argvars[0]) - 1; // boff gets -1 on type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003895 if (boff < 0)
3896 rettv->vval.v_number = -1;
3897 else
3898 rettv->vval.v_number = ml_find_line_or_offset(curbuf,
3899 (linenr_T)0, &boff);
3900#endif
3901}
3902
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003903/*
3904 * "call(func, arglist [, dict])" function
3905 */
3906 static void
3907f_call(typval_T *argvars, typval_T *rettv)
3908{
3909 char_u *func;
3910 partial_T *partial = NULL;
3911 dict_T *selfdict = NULL;
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003912 char_u *tofree = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003913
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02003914 if (in_vim9script()
Bram Moolenaar223d0a62021-12-25 19:29:21 +00003915 && (check_for_string_or_func_arg(argvars, 0) == FAIL
3916 || check_for_list_arg(argvars, 1) == FAIL
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02003917 || check_for_opt_dict_arg(argvars, 2) == FAIL))
3918 return;
3919
Bram Moolenaard83392a2022-09-01 12:22:46 +01003920 if (check_for_list_arg(argvars, 1) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003921 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003922 if (argvars[1].vval.v_list == NULL)
3923 return;
3924
3925 if (argvars[0].v_type == VAR_FUNC)
3926 func = argvars[0].vval.v_string;
3927 else if (argvars[0].v_type == VAR_PARTIAL)
3928 {
3929 partial = argvars[0].vval.v_partial;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02003930 func = partial_name(partial);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003931 }
3932 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003933 func = tv_get_string(&argvars[0]);
Dominique Pellefe8ebdb2021-05-13 14:55:55 +02003934 if (func == NULL || *func == NUL)
3935 return; // type error, empty name or null function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003936
Yegappan Lakshmanan9904cbc2025-01-15 18:25:19 +01003937 if (argvars[0].v_type == VAR_STRING)
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003938 {
Yegappan Lakshmanan9904cbc2025-01-15 18:25:19 +01003939 char_u *p = func;
3940 tofree = trans_function_name(&p, NULL, FALSE, TFN_INT|TFN_QUIET);
3941 if (tofree == NULL)
3942 {
3943 emsg_funcname(e_unknown_function_str, func);
3944 return;
3945 }
3946 func = tofree;
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003947 }
3948
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003949 if (argvars[2].v_type != VAR_UNKNOWN)
3950 {
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +01003951 if (check_for_dict_arg(argvars, 2) == FAIL)
Yegappan Lakshmanan6289f912025-01-14 17:13:36 +01003952 goto done;
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +01003953
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003954 selfdict = argvars[2].vval.v_dict;
3955 }
3956
3957 (void)func_call(func, &argvars[1], partial, selfdict, rettv);
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003958
Yegappan Lakshmanan6289f912025-01-14 17:13:36 +01003959done:
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003960 vim_free(tofree);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003961}
3962
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003963/*
3964 * "changenr()" function
3965 */
3966 static void
3967f_changenr(typval_T *argvars UNUSED, typval_T *rettv)
3968{
3969 rettv->vval.v_number = curbuf->b_u_seq_cur;
3970}
3971
3972/*
3973 * "char2nr(string)" function
3974 */
3975 static void
3976f_char2nr(typval_T *argvars, typval_T *rettv)
3977{
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02003978 if (in_vim9script()
3979 && (check_for_string_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02003980 || check_for_opt_bool_arg(argvars, 1) == FAIL))
Bram Moolenaarc5809432021-03-27 21:23:30 +01003981 return;
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02003982
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003983 if (has_mbyte)
3984 {
3985 int utf8 = 0;
3986
3987 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaar24f77502020-09-04 19:50:57 +02003988 utf8 = (int)tv_get_bool_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003989
3990 if (utf8)
Bram Moolenaarbdace832019-03-02 10:13:42 +01003991 rettv->vval.v_number = utf_ptr2char(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003992 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003993 rettv->vval.v_number = (*mb_ptr2char)(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003994 }
3995 else
Bram Moolenaar13505972019-01-24 15:04:48 +01003996 rettv->vval.v_number = tv_get_string(&argvars[0])[0];
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003997}
3998
Bram Moolenaar17793ef2020-12-28 12:56:58 +01003999/*
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004000 * Get the current cursor column and store it in 'rettv'. If 'charcol' is TRUE,
4001 * returns the character index of the column. Otherwise, returns the byte index
4002 * of the column.
4003 */
4004 static void
4005get_col(typval_T *argvars, typval_T *rettv, int charcol)
4006{
4007 colnr_T col = 0;
4008 pos_T *fp;
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00004009 switchwin_T switchwin;
4010 int winchanged = FALSE;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004011
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00004012 if (check_for_string_or_list_arg(argvars, 0) == FAIL
4013 || check_for_opt_number_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004014 return;
4015
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00004016 if (argvars[1].v_type != VAR_UNKNOWN)
4017 {
4018 tabpage_T *tp;
4019 win_T *wp;
4020
4021 // use the window specified in the second argument
4022 wp = win_id2wp_tp((int)tv_get_number(&argvars[1]), &tp);
4023 if (wp == NULL || tp == NULL)
4024 return;
4025
4026 if (switch_win_noblock(&switchwin, wp, tp, TRUE) != OK)
4027 return;
4028
4029 check_cursor();
4030 winchanged = TRUE;
4031 }
4032
4033 int fnum = curbuf->b_fnum;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004034 fp = var2fpos(&argvars[0], FALSE, &fnum, charcol);
4035 if (fp != NULL && fnum == curbuf->b_fnum)
4036 {
4037 if (fp->col == MAXCOL)
4038 {
4039 // '> can be MAXCOL, get the length of the line then
4040 if (fp->lnum <= curbuf->b_ml.ml_line_count)
John Marriottbfcc8952024-03-11 22:04:45 +01004041 col = ml_get_len(fp->lnum) + 1;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004042 else
4043 col = MAXCOL;
4044 }
4045 else
4046 {
4047 col = fp->col + 1;
4048 // col(".") when the cursor is on the NUL at the end of the line
4049 // because of "coladd" can be seen as an extra column.
4050 if (virtual_active() && fp == &curwin->w_cursor)
4051 {
4052 char_u *p = ml_get_cursor();
4053
4054 if (curwin->w_cursor.coladd >= (colnr_T)chartabsize(p,
4055 curwin->w_virtcol - curwin->w_cursor.coladd))
4056 {
4057 int l;
4058
4059 if (*p != NUL && p[(l = (*mb_ptr2len)(p))] == NUL)
4060 col += l;
4061 }
4062 }
4063 }
4064 }
4065 rettv->vval.v_number = col;
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00004066
4067 if (winchanged)
4068 restore_win_noblock(&switchwin, TRUE);
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004069}
4070
4071/*
4072 * "charcol()" function
4073 */
4074 static void
4075f_charcol(typval_T *argvars, typval_T *rettv)
4076{
4077 get_col(argvars, rettv, TRUE);
4078}
4079
Bram Moolenaar29b7d7a2019-07-22 23:03:57 +02004080 win_T *
Bram Moolenaaraff74912019-03-30 18:11:49 +01004081get_optional_window(typval_T *argvars, int idx)
4082{
4083 win_T *win = curwin;
4084
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00004085 if (argvars[idx].v_type == VAR_UNKNOWN)
4086 return curwin;
4087
4088 win = find_win_by_nr_or_id(&argvars[idx]);
4089 if (win == NULL)
Bram Moolenaaraff74912019-03-30 18:11:49 +01004090 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00004091 emsg(_(e_invalid_window_number));
4092 return NULL;
Bram Moolenaaraff74912019-03-30 18:11:49 +01004093 }
4094 return win;
4095}
4096
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004097/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004098 * "col(string)" function
4099 */
4100 static void
4101f_col(typval_T *argvars, typval_T *rettv)
4102{
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004103 get_col(argvars, rettv, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004104}
4105
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004106/*
4107 * "confirm(message, buttons[, default [, type]])" function
4108 */
4109 static void
4110f_confirm(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
4111{
4112#if defined(FEAT_GUI_DIALOG) || defined(FEAT_CON_DIALOG)
4113 char_u *message;
4114 char_u *buttons = NULL;
4115 char_u buf[NUMBUFLEN];
4116 char_u buf2[NUMBUFLEN];
4117 int def = 1;
4118 int type = VIM_GENERIC;
4119 char_u *typestr;
4120 int error = FALSE;
4121
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02004122 if (in_vim9script()
4123 && (check_for_string_arg(argvars, 0) == FAIL
4124 || (check_for_opt_string_arg(argvars, 1) == FAIL
4125 || (argvars[1].v_type != VAR_UNKNOWN
4126 && (check_for_opt_number_arg(argvars, 2) == FAIL
4127 || (argvars[2].v_type != VAR_UNKNOWN
4128 && check_for_opt_string_arg(argvars, 3) == FAIL))))))
Bram Moolenaarc5809432021-03-27 21:23:30 +01004129 return;
4130
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004131 message = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004132 if (message == NULL)
4133 error = TRUE;
4134 if (argvars[1].v_type != VAR_UNKNOWN)
4135 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004136 buttons = tv_get_string_buf_chk(&argvars[1], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004137 if (buttons == NULL)
4138 error = TRUE;
4139 if (argvars[2].v_type != VAR_UNKNOWN)
4140 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004141 def = (int)tv_get_number_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004142 if (argvars[3].v_type != VAR_UNKNOWN)
4143 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004144 typestr = tv_get_string_buf_chk(&argvars[3], buf2);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004145 if (typestr == NULL)
4146 error = TRUE;
4147 else
4148 {
4149 switch (TOUPPER_ASC(*typestr))
4150 {
4151 case 'E': type = VIM_ERROR; break;
4152 case 'Q': type = VIM_QUESTION; break;
4153 case 'I': type = VIM_INFO; break;
4154 case 'W': type = VIM_WARNING; break;
4155 case 'G': type = VIM_GENERIC; break;
4156 }
4157 }
4158 }
4159 }
4160 }
4161
4162 if (buttons == NULL || *buttons == NUL)
4163 buttons = (char_u *)_("&Ok");
4164
4165 if (!error)
4166 rettv->vval.v_number = do_dialog(type, NULL, message, buttons,
4167 def, NULL, FALSE);
4168#endif
4169}
4170
4171/*
4172 * "copy()" function
4173 */
4174 static void
4175f_copy(typval_T *argvars, typval_T *rettv)
4176{
Bram Moolenaar381692b2022-02-02 20:01:27 +00004177 item_copy(&argvars[0], rettv, FALSE, TRUE, 0);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004178}
4179
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004180/*
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004181 * Set the cursor position.
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01004182 * If "charcol" is TRUE, then use the column number as a character offset.
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004183 * Otherwise use the column number as a byte offset.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004184 */
4185 static void
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004186set_cursorpos(typval_T *argvars, typval_T *rettv, int charcol)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004187{
Bram Moolenaar79f23442022-10-10 12:42:57 +01004188 long lnum, col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004189 long coladd = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004190 int set_curswant = TRUE;
4191
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004192 if (in_vim9script()
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004193 && (check_for_string_or_number_or_list_arg(argvars, 0) == FAIL
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02004194 || check_for_opt_number_arg(argvars, 1) == FAIL
4195 || (argvars[1].v_type != VAR_UNKNOWN
4196 && check_for_opt_number_arg(argvars, 2) == FAIL)))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004197 return;
4198
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004199 rettv->vval.v_number = -1;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004200 if (argvars[0].v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004201 {
4202 pos_T pos;
4203 colnr_T curswant = -1;
4204
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004205 if (list2fpos(argvars, &pos, NULL, &curswant, charcol) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004206 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00004207 emsg(_(e_invalid_argument));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004208 return;
4209 }
Bram Moolenaar79f23442022-10-10 12:42:57 +01004210 lnum = pos.lnum;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004211 col = pos.col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004212 coladd = pos.coladd;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004213 if (curswant >= 0)
4214 {
4215 curwin->w_curswant = curswant - 1;
4216 set_curswant = FALSE;
4217 }
4218 }
Bram Moolenaar79f23442022-10-10 12:42:57 +01004219 else if ((argvars[0].v_type == VAR_NUMBER
4220 || argvars[0].v_type == VAR_STRING)
4221 && (argvars[1].v_type == VAR_NUMBER
4222 || argvars[1].v_type == VAR_STRING))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004223 {
Bram Moolenaar79f23442022-10-10 12:42:57 +01004224 lnum = tv_get_lnum(argvars);
4225 if (lnum < 0)
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00004226 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[0]));
Bram Moolenaar79f23442022-10-10 12:42:57 +01004227 else if (lnum == 0)
4228 lnum = curwin->w_cursor.lnum;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004229 col = (long)tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004230 if (charcol)
Bram Moolenaar79f23442022-10-10 12:42:57 +01004231 col = buf_charidx_to_byteidx(curbuf, lnum, col) + 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004232 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004233 coladd = (long)tv_get_number_chk(&argvars[2], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004234 }
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004235 else
4236 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00004237 emsg(_(e_invalid_argument));
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004238 return;
4239 }
Bram Moolenaar79f23442022-10-10 12:42:57 +01004240 if (lnum < 0 || col < 0 || coladd < 0)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004241 return; // type error; errmsg already given
Bram Moolenaar79f23442022-10-10 12:42:57 +01004242 if (lnum > 0)
4243 curwin->w_cursor.lnum = lnum;
zeertzjq2ffdae72024-05-02 13:06:24 +02004244 if (col != MAXCOL && --col < 0)
4245 col = 0;
4246 curwin->w_cursor.col = col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004247 curwin->w_cursor.coladd = coladd;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004248
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004249 // Make sure the cursor is in a valid position.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004250 check_cursor();
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004251 // Correct cursor for multi-byte character.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004252 if (has_mbyte)
4253 mb_adjust_cursor();
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004254
4255 curwin->w_set_curswant = set_curswant;
4256 rettv->vval.v_number = 0;
4257}
4258
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004259/*
4260 * "cursor(lnum, col)" function, or
4261 * "cursor(list)"
4262 *
4263 * Moves the cursor to the specified line and column.
4264 * Returns 0 when the position could be set, -1 otherwise.
4265 */
4266 static void
4267f_cursor(typval_T *argvars, typval_T *rettv)
4268{
4269 set_cursorpos(argvars, rettv, FALSE);
4270}
4271
Bram Moolenaar4f974752019-02-17 17:44:42 +01004272#ifdef MSWIN
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004273/*
4274 * "debugbreak()" function
4275 */
4276 static void
4277f_debugbreak(typval_T *argvars, typval_T *rettv)
4278{
4279 int pid;
4280
4281 rettv->vval.v_number = FAIL;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004282 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
4283 return;
4284
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004285 pid = (int)tv_get_number(&argvars[0]);
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004286 if (pid == 0)
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004287 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00004288 emsg(_(e_invalid_argument));
4289 return;
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004290 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00004291
4292 HANDLE hProcess = OpenProcess(PROCESS_ALL_ACCESS, 0, pid);
4293 if (hProcess == NULL)
4294 return;
4295
4296 DebugBreakProcess(hProcess);
4297 CloseHandle(hProcess);
4298 rettv->vval.v_number = OK;
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004299}
4300#endif
4301
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004302/*
4303 * "deepcopy()" function
4304 */
4305 static void
4306f_deepcopy(typval_T *argvars, typval_T *rettv)
4307{
Bram Moolenaar239f8d92021-01-17 13:21:20 +01004308 varnumber_T noref = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004309
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +01004310 if (check_for_opt_bool_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004311 return;
4312
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004313 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaar239f8d92021-01-17 13:21:20 +01004314 noref = tv_get_bool_chk(&argvars[1], NULL);
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +01004315
4316 item_copy(&argvars[0], rettv, TRUE, TRUE, noref == 0 ? get_copyID() : 0);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004317}
4318
4319/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004320 * "did_filetype()" function
4321 */
4322 static void
4323f_did_filetype(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
4324{
zeertzjq5bf6c212024-03-31 18:41:27 +02004325 rettv->vval.v_number = curbuf->b_did_filetype;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004326}
4327
4328/*
Bram Moolenaar4132eb52020-02-14 16:53:00 +01004329 * "echoraw({expr})" function
4330 */
4331 static void
4332f_echoraw(typval_T *argvars, typval_T *rettv UNUSED)
4333{
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02004334 char_u *str;
Bram Moolenaar4132eb52020-02-14 16:53:00 +01004335
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02004336 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
4337 return;
4338
4339 str = tv_get_string_chk(&argvars[0]);
Bram Moolenaar4132eb52020-02-14 16:53:00 +01004340 if (str != NULL && *str != NUL)
4341 {
4342 out_str(str);
4343 out_flush();
4344 }
4345}
4346
4347/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004348 * "empty({expr})" function
4349 */
4350 static void
4351f_empty(typval_T *argvars, typval_T *rettv)
4352{
4353 int n = FALSE;
4354
4355 switch (argvars[0].v_type)
4356 {
4357 case VAR_STRING:
4358 case VAR_FUNC:
4359 n = argvars[0].vval.v_string == NULL
4360 || *argvars[0].vval.v_string == NUL;
4361 break;
4362 case VAR_PARTIAL:
Yegappan Lakshmananda9d3452024-05-02 13:02:36 +02004363 n = argvars[0].vval.v_partial == NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004364 break;
4365 case VAR_NUMBER:
4366 n = argvars[0].vval.v_number == 0;
4367 break;
4368 case VAR_FLOAT:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004369 n = argvars[0].vval.v_float == 0.0;
4370 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004371 case VAR_LIST:
4372 n = argvars[0].vval.v_list == NULL
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004373 || argvars[0].vval.v_list->lv_len == 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004374 break;
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01004375 case VAR_TUPLE:
4376 n = tuple_len(argvars[0].vval.v_tuple) == 0;
4377 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004378 case VAR_DICT:
4379 n = argvars[0].vval.v_dict == NULL
4380 || argvars[0].vval.v_dict->dv_hashtab.ht_used == 0;
4381 break;
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01004382 case VAR_BOOL:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004383 case VAR_SPECIAL:
4384 n = argvars[0].vval.v_number != VVAL_TRUE;
4385 break;
Bram Moolenaar00b28d62022-12-08 15:32:33 +00004386 case VAR_CLASS:
4387 n = argvars[0].vval.v_class != NULL;
4388 break;
4389 case VAR_OBJECT:
Yegappan Lakshmanand3eae7b2024-03-03 16:26:58 +01004390 n = object_empty(argvars[0].vval.v_object);
Bram Moolenaar00b28d62022-12-08 15:32:33 +00004391 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004392
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01004393 case VAR_BLOB:
4394 n = argvars[0].vval.v_blob == NULL
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01004395 || argvars[0].vval.v_blob->bv_ga.ga_len == 0;
4396 break;
4397
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004398 case VAR_JOB:
4399#ifdef FEAT_JOB_CHANNEL
4400 n = argvars[0].vval.v_job == NULL
4401 || argvars[0].vval.v_job->jv_status != JOB_STARTED;
4402 break;
4403#endif
4404 case VAR_CHANNEL:
4405#ifdef FEAT_JOB_CHANNEL
4406 n = argvars[0].vval.v_channel == NULL
4407 || !channel_is_open(argvars[0].vval.v_channel);
4408 break;
4409#endif
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +02004410 case VAR_TYPEALIAS:
4411 n = argvars[0].vval.v_typealias == NULL
4412 || argvars[0].vval.v_typealias->ta_name == NULL
4413 || *argvars[0].vval.v_typealias->ta_name == NUL;
4414 break;
4415
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004416 case VAR_UNKNOWN:
Bram Moolenaar4c683752020-04-05 21:38:23 +02004417 case VAR_ANY:
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004418 case VAR_VOID:
Bram Moolenaarf18332f2021-05-07 17:55:55 +02004419 case VAR_INSTR:
Bram Moolenaardd589232020-02-29 17:38:12 +01004420 internal_error_no_abort("f_empty(UNKNOWN)");
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004421 n = TRUE;
4422 break;
4423 }
4424
4425 rettv->vval.v_number = n;
4426}
4427
4428/*
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004429 * "environ()" function
4430 */
4431 static void
4432f_environ(typval_T *argvars UNUSED, typval_T *rettv)
4433{
4434#if !defined(AMIGA)
4435 int i = 0;
4436 char_u *entry, *value;
Bram Moolenaar68aaff42022-04-17 10:57:44 +01004437# if defined (MSWIN)
4438# if !defined(_UCRT)
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004439 extern wchar_t **_wenviron;
Bram Moolenaar68aaff42022-04-17 10:57:44 +01004440# endif
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004441# else
4442 extern char **environ;
4443# endif
4444
Bram Moolenaar93a10962022-06-16 11:42:09 +01004445 if (rettv_dict_alloc(rettv) == FAIL)
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004446 return;
4447
4448# ifdef MSWIN
4449 if (*_wenviron == NULL)
4450 return;
4451# else
4452 if (*environ == NULL)
4453 return;
4454# endif
4455
4456 for (i = 0; ; ++i)
4457 {
4458# ifdef MSWIN
4459 short_u *p;
4460
4461 if ((p = (short_u *)_wenviron[i]) == NULL)
4462 return;
4463 entry = utf16_to_enc(p, NULL);
4464# else
4465 if ((entry = (char_u *)environ[i]) == NULL)
4466 return;
4467 entry = vim_strsave(entry);
4468# endif
4469 if (entry == NULL) // out of memory
4470 return;
4471 if ((value = vim_strchr(entry, '=')) == NULL)
4472 {
4473 vim_free(entry);
4474 continue;
4475 }
4476 *value++ = NUL;
4477 dict_add_string(rettv->vval.v_dict, (char *)entry, value);
4478 vim_free(entry);
4479 }
4480#endif
4481}
4482
4483/*
Bram Moolenaar80adaa82023-07-07 18:57:40 +01004484 * "err_teapot()" function
4485 */
4486 static void
4487f_err_teapot(typval_T *argvars, typval_T *rettv UNUSED)
4488{
4489 if (argvars[0].v_type != VAR_UNKNOWN)
4490 {
4491 if (argvars[0].v_type == VAR_STRING)
4492 {
4493 char_u *s = tv_get_string_strict(&argvars[0]);
Sean Dewarb0efa492023-07-08 10:35:19 +01004494 if (*skipwhite(s) == NUL)
Bram Moolenaar80adaa82023-07-07 18:57:40 +01004495 return;
4496 }
4497
4498 int err = FALSE;
4499 int do_503 = eval_expr_to_bool(&argvars[0], &err);
4500 if (!err && do_503)
4501 {
4502 emsg(_(e_coffee_currently_not_available));
4503 return;
4504 }
4505 }
4506
4507 emsg(_(e_im_a_teapot));
4508}
4509
4510/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004511 * "escape({string}, {chars})" function
4512 */
4513 static void
4514f_escape(typval_T *argvars, typval_T *rettv)
4515{
4516 char_u buf[NUMBUFLEN];
4517
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004518 if (in_vim9script()
4519 && (check_for_string_arg(argvars, 0) == FAIL
4520 || check_for_string_arg(argvars, 1) == FAIL))
4521 return;
4522
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004523 rettv->vval.v_string = vim_strsave_escaped(tv_get_string(&argvars[0]),
4524 tv_get_string_buf(&argvars[1], buf));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004525 rettv->v_type = VAR_STRING;
4526}
4527
4528/*
4529 * "eval()" function
4530 */
4531 static void
4532f_eval(typval_T *argvars, typval_T *rettv)
4533{
4534 char_u *s, *p;
4535
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004536 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
4537 return;
4538
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004539 s = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004540 if (s != NULL)
4541 s = skipwhite(s);
4542
4543 p = s;
Bram Moolenaar5409f5d2020-06-24 18:37:35 +02004544 if (s == NULL || eval1(&s, rettv, &EVALARG_EVALUATE) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004545 {
4546 if (p != NULL && !aborting())
Bram Moolenaar108010a2021-06-27 22:03:33 +02004547 semsg(_(e_invalid_expression_str), p);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004548 need_clr_eos = FALSE;
4549 rettv->v_type = VAR_NUMBER;
4550 rettv->vval.v_number = 0;
4551 }
4552 else if (*s != NUL)
Bram Moolenaar74409f62022-01-01 15:58:22 +00004553 semsg(_(e_trailing_characters_str), s);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004554}
4555
4556/*
4557 * "eventhandler()" function
4558 */
4559 static void
4560f_eventhandler(typval_T *argvars UNUSED, typval_T *rettv)
4561{
Bram Moolenaardfc33a62020-04-29 22:30:13 +02004562 rettv->vval.v_number = vgetc_busy || input_busy;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004563}
4564
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004565static garray_T redir_execute_ga;
4566
4567/*
4568 * Append "value[value_len]" to the execute() output.
4569 */
4570 void
4571execute_redir_str(char_u *value, int value_len)
4572{
4573 int len;
4574
4575 if (value_len == -1)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004576 len = (int)STRLEN(value); // Append the entire string
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004577 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004578 len = value_len; // Append only "value_len" characters
Yegappan Lakshmananfadc02a2023-01-27 21:03:12 +00004579 if (ga_grow(&redir_execute_ga, len) == FAIL)
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00004580 return;
4581
4582 mch_memmove((char *)redir_execute_ga.ga_data
4583 + redir_execute_ga.ga_len, value, len);
4584 redir_execute_ga.ga_len += len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004585}
4586
Dominique Pelle748b3082022-01-08 12:41:16 +00004587#if defined(FEAT_LUA) || defined(PROTO)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004588/*
Yegappan Lakshmanan11328bc2021-08-06 21:34:38 +02004589 * Get next line from a string containing NL separated lines.
4590 * Called by do_cmdline() to get the next line.
4591 * Returns an allocated string, or NULL when at the end of the string.
4592 */
4593 static char_u *
4594get_str_line(
4595 int c UNUSED,
4596 void *cookie,
4597 int indent UNUSED,
4598 getline_opt_T options UNUSED)
4599{
4600 char_u *start = *(char_u **)cookie;
4601 char_u *line;
4602 char_u *p;
4603
4604 p = start;
4605 if (p == NULL || *p == NUL)
4606 return NULL;
4607 p = vim_strchr(p, '\n');
4608 if (p == NULL)
4609 line = vim_strsave(start);
4610 else
4611 {
4612 line = vim_strnsave(start, p - start);
4613 p++;
4614 }
4615
4616 *(char_u **)cookie = p;
4617 return line;
4618}
4619
4620/*
4621 * Execute a series of Ex commands in 'str'
4622 */
4623 void
4624execute_cmds_from_string(char_u *str)
4625{
4626 do_cmdline(NULL, get_str_line, (void *)&str,
4627 DOCMD_NOWAIT|DOCMD_VERBOSE|DOCMD_REPEAT|DOCMD_KEYTYPED);
4628}
Dominique Pelle748b3082022-01-08 12:41:16 +00004629#endif
Yegappan Lakshmanan11328bc2021-08-06 21:34:38 +02004630
4631/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004632 * Get next line from a list.
4633 * Called by do_cmdline() to get the next line.
4634 * Returns allocated string, or NULL for end of function.
4635 */
Bram Moolenaara7583c42022-05-07 21:14:05 +01004636 char_u *
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004637get_list_line(
4638 int c UNUSED,
4639 void *cookie,
Bram Moolenaare96a2492019-06-25 04:12:16 +02004640 int indent UNUSED,
Bram Moolenaar66250c92020-08-20 15:02:42 +02004641 getline_opt_T options UNUSED)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004642{
4643 listitem_T **p = (listitem_T **)cookie;
4644 listitem_T *item = *p;
4645 char_u buf[NUMBUFLEN];
4646 char_u *s;
4647
4648 if (item == NULL)
4649 return NULL;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004650 s = tv_get_string_buf_chk(&item->li_tv, buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004651 *p = item->li_next;
4652 return s == NULL ? NULL : vim_strsave(s);
4653}
4654
4655/*
4656 * "execute()" function
4657 */
Bram Moolenaar261f3462019-09-07 15:45:32 +02004658 void
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004659execute_common(typval_T *argvars, typval_T *rettv, int arg_off)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004660{
4661 char_u *cmd = NULL;
4662 list_T *list = NULL;
4663 int save_msg_silent = msg_silent;
4664 int save_emsg_silent = emsg_silent;
4665 int save_emsg_noredir = emsg_noredir;
4666 int save_redir_execute = redir_execute;
Bram Moolenaar20951482017-12-25 13:44:43 +01004667 int save_redir_off = redir_off;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004668 garray_T save_ga;
Bram Moolenaar10ccaa12018-12-07 16:38:23 +01004669 int save_msg_col = msg_col;
Kota Kato3d3f6ac2022-08-04 18:50:14 +01004670 int save_sticky_cmdmod_flags = sticky_cmdmod_flags;
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004671 int echo_output = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004672
4673 rettv->vval.v_string = NULL;
4674 rettv->v_type = VAR_STRING;
4675
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004676 if (argvars[arg_off].v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004677 {
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004678 list = argvars[arg_off].vval.v_list;
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004679 if (list == NULL || list->lv_len == 0)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004680 // empty list, no commands, empty output
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004681 return;
4682 ++list->lv_refcount;
4683 }
Bram Moolenaare2a8f072020-01-08 19:32:18 +01004684 else if (argvars[arg_off].v_type == VAR_JOB
4685 || argvars[arg_off].v_type == VAR_CHANNEL)
4686 {
Bram Moolenaar68db9962021-05-09 23:19:22 +02004687 semsg(_(e_using_invalid_value_as_string_str),
4688 vartype_name(argvars[arg_off].v_type));
Bram Moolenaare2a8f072020-01-08 19:32:18 +01004689 return;
4690 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004691 else
4692 {
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004693 cmd = tv_get_string_chk(&argvars[arg_off]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004694 if (cmd == NULL)
4695 return;
4696 }
4697
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004698 if (argvars[arg_off + 1].v_type != VAR_UNKNOWN)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004699 {
4700 char_u buf[NUMBUFLEN];
Bram Moolenaar3cfa5b12021-06-06 14:14:39 +02004701 char_u *s = tv_get_string_buf_chk_strict(&argvars[arg_off + 1], buf,
4702 in_vim9script());
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004703
4704 if (s == NULL)
4705 return;
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004706 if (*s == NUL)
4707 echo_output = TRUE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004708 if (STRNCMP(s, "silent", 6) == 0)
4709 ++msg_silent;
4710 if (STRCMP(s, "silent!") == 0)
4711 {
4712 emsg_silent = TRUE;
4713 emsg_noredir = TRUE;
4714 }
4715 }
4716 else
4717 ++msg_silent;
4718
4719 if (redir_execute)
4720 save_ga = redir_execute_ga;
Bram Moolenaar04935fb2022-01-08 16:19:22 +00004721 ga_init2(&redir_execute_ga, sizeof(char), 500);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004722 redir_execute = TRUE;
Bram Moolenaar20951482017-12-25 13:44:43 +01004723 redir_off = FALSE;
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004724 if (!echo_output)
4725 msg_col = 0; // prevent leading spaces
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004726
Kota Kato3d3f6ac2022-08-04 18:50:14 +01004727 // For "legacy call execute('cmd')" and "vim9cmd execute('cmd')" apply the
4728 // command modifiers to "cmd".
4729 sticky_cmdmod_flags = cmdmod.cmod_flags & (CMOD_LEGACY | CMOD_VIM9CMD);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004730 if (cmd != NULL)
4731 do_cmdline_cmd(cmd);
4732 else
4733 {
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004734 listitem_T *item;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004735
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02004736 CHECK_LIST_MATERIALIZE(list);
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004737 item = list->lv_first;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004738 do_cmdline(NULL, get_list_line, (void *)&item,
4739 DOCMD_NOWAIT|DOCMD_VERBOSE|DOCMD_REPEAT|DOCMD_KEYTYPED);
4740 --list->lv_refcount;
4741 }
Kota Kato3d3f6ac2022-08-04 18:50:14 +01004742 sticky_cmdmod_flags = save_sticky_cmdmod_flags;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004743
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004744 // Need to append a NUL to the result.
Bram Moolenaard297f352017-01-29 20:31:21 +01004745 if (ga_grow(&redir_execute_ga, 1) == OK)
4746 {
4747 ((char *)redir_execute_ga.ga_data)[redir_execute_ga.ga_len] = NUL;
4748 rettv->vval.v_string = redir_execute_ga.ga_data;
4749 }
4750 else
4751 {
4752 ga_clear(&redir_execute_ga);
4753 rettv->vval.v_string = NULL;
4754 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004755 msg_silent = save_msg_silent;
4756 emsg_silent = save_emsg_silent;
4757 emsg_noredir = save_emsg_noredir;
4758
4759 redir_execute = save_redir_execute;
4760 if (redir_execute)
4761 redir_execute_ga = save_ga;
Bram Moolenaar20951482017-12-25 13:44:43 +01004762 redir_off = save_redir_off;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004763
Bram Moolenaar10ccaa12018-12-07 16:38:23 +01004764 // "silent reg" or "silent echo x" leaves msg_col somewhere in the line.
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004765 if (echo_output)
4766 // When not working silently: put it in column zero. A following
4767 // "echon" will overwrite the message, unavoidably.
4768 msg_col = 0;
4769 else
4770 // When working silently: Put it back where it was, since nothing
4771 // should have been written.
4772 msg_col = save_msg_col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004773}
4774
4775/*
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004776 * "execute()" function
4777 */
4778 static void
4779f_execute(typval_T *argvars, typval_T *rettv)
4780{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004781 if (in_vim9script()
4782 && (check_for_string_or_list_arg(argvars, 0) == FAIL
4783 || check_for_opt_string_arg(argvars, 1) == FAIL))
4784 return;
4785
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004786 execute_common(argvars, rettv, 0);
4787}
4788
4789/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004790 * "exists()" function
4791 */
Bram Moolenaarbb7ee7a2021-08-02 20:06:50 +02004792 void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004793f_exists(typval_T *argvars, typval_T *rettv)
4794{
4795 char_u *p;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004796 int n = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004797
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004798 if (in_vim9script() && check_for_nonempty_string_arg(argvars, 0) == FAIL)
4799 return;
4800
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004801 p = tv_get_string(&argvars[0]);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004802 if (*p == '$') // environment variable
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004803 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004804 // first try "normal" environment variables (fast)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004805 if (mch_getenv(p + 1) != NULL)
4806 n = TRUE;
4807 else
4808 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004809 // try expanding things like $VIM and ${HOME}
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004810 p = expand_env_save(p);
4811 if (p != NULL && *p != '$')
4812 n = TRUE;
4813 vim_free(p);
4814 }
4815 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004816 else if (*p == '&' || *p == '+') // option
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004817 {
Bram Moolenaar9a78e6d2020-07-01 18:29:55 +02004818 n = (eval_option(&p, NULL, TRUE) == OK);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004819 if (*skipwhite(p) != NUL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004820 n = FALSE; // trailing garbage
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004821 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004822 else if (*p == '*') // internal or user defined function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004823 {
Bram Moolenaarb54c3ff2016-07-31 14:11:58 +02004824 n = function_exists(p + 1, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004825 }
Bram Moolenaar15c47602020-03-26 22:16:48 +01004826 else if (*p == '?') // internal function only
4827 {
4828 n = has_internal_func_name(p + 1);
4829 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004830 else if (*p == ':')
4831 {
4832 n = cmd_exists(p + 1);
4833 }
4834 else if (*p == '#')
4835 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004836 if (p[1] == '#')
4837 n = autocmd_supported(p + 2);
4838 else
4839 n = au_exists(p + 1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004840 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004841 else // internal variable
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004842 {
Bram Moolenaarc6f9f732018-02-11 19:06:26 +01004843 n = var_exists(p);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004844 }
4845
4846 rettv->vval.v_number = n;
4847}
4848
Bram Moolenaar26735992021-08-08 14:43:22 +02004849 static void
4850f_exists_compiled(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
4851{
4852 emsg(_(e_exists_compiled_can_only_be_used_in_def_function));
4853}
4854
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004855/*
4856 * "expand()" function
4857 */
4858 static void
4859f_expand(typval_T *argvars, typval_T *rettv)
4860{
4861 char_u *s;
Mike Williams51024bb2024-05-30 07:46:30 +02004862 size_t len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004863 int options = WILD_SILENT|WILD_USE_NL|WILD_LIST_NOTFOUND;
4864 expand_T xpc;
4865 int error = FALSE;
4866 char_u *result;
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004867#ifdef BACKSLASH_IN_FILENAME
4868 char_u *p_csl_save = p_csl;
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004869#endif
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004870
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004871 if (in_vim9script()
4872 && (check_for_string_arg(argvars, 0) == FAIL
4873 || check_for_opt_bool_arg(argvars, 1) == FAIL
4874 || (argvars[1].v_type != VAR_UNKNOWN
4875 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
4876 return;
4877
4878#ifdef BACKSLASH_IN_FILENAME
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004879 // avoid using 'completeslash' here
4880 p_csl = empty_option;
4881#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004882
4883 rettv->v_type = VAR_STRING;
4884 if (argvars[1].v_type != VAR_UNKNOWN
4885 && argvars[2].v_type != VAR_UNKNOWN
Bram Moolenaar551d25e2020-09-02 21:37:56 +02004886 && tv_get_bool_chk(&argvars[2], &error)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004887 && !error)
Bram Moolenaar45cf6e92017-04-30 20:25:19 +02004888 rettv_list_set(rettv, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004889
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004890 s = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004891 if (*s == '%' || *s == '#' || *s == '<')
4892 {
Bram Moolenaar57544522022-04-12 12:54:11 +01004893 char *errormsg = NULL;
4894
4895 if (p_verbose == 0)
4896 ++emsg_off;
Bram Moolenaara96edb72022-04-28 17:52:24 +01004897 result = eval_vars(s, s, &len, NULL, &errormsg, NULL, FALSE);
Bram Moolenaar57544522022-04-12 12:54:11 +01004898 if (p_verbose == 0)
4899 --emsg_off;
4900 else if (errormsg != NULL)
4901 emsg(errormsg);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004902 if (rettv->v_type == VAR_LIST)
4903 {
Bram Moolenaar93a10962022-06-16 11:42:09 +01004904 if (rettv_list_alloc(rettv) == OK && result != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004905 list_append_string(rettv->vval.v_list, result, -1);
Bram Moolenaar86173482019-10-01 17:02:16 +02004906 vim_free(result);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004907 }
4908 else
4909 rettv->vval.v_string = result;
4910 }
4911 else
4912 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004913 // When the optional second argument is non-zero, don't remove matches
4914 // for 'wildignore' and don't put matches for 'suffixes' at the end.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004915 if (argvars[1].v_type != VAR_UNKNOWN
Bram Moolenaar551d25e2020-09-02 21:37:56 +02004916 && tv_get_bool_chk(&argvars[1], &error))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004917 options |= WILD_KEEP_ALL;
4918 if (!error)
4919 {
4920 ExpandInit(&xpc);
4921 xpc.xp_context = EXPAND_FILES;
4922 if (p_wic)
4923 options += WILD_ICASE;
4924 if (rettv->v_type == VAR_STRING)
4925 rettv->vval.v_string = ExpandOne(&xpc, s, NULL,
4926 options, WILD_ALL);
Bram Moolenaar93a10962022-06-16 11:42:09 +01004927 else if (rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004928 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004929 ExpandOne(&xpc, s, NULL, options, WILD_ALL_KEEP);
Bram Moolenaar848db572022-09-20 19:04:32 +01004930 for (int i = 0; i < xpc.xp_numfiles; i++)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004931 list_append_string(rettv->vval.v_list, xpc.xp_files[i], -1);
4932 ExpandCleanup(&xpc);
4933 }
4934 }
4935 else
4936 rettv->vval.v_string = NULL;
4937 }
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004938#ifdef BACKSLASH_IN_FILENAME
4939 p_csl = p_csl_save;
4940#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004941}
4942
4943/*
Bram Moolenaar80dad482019-06-09 17:22:31 +02004944 * "expandcmd()" function
4945 * Expand all the special characters in a command string.
4946 */
4947 static void
4948f_expandcmd(typval_T *argvars, typval_T *rettv)
4949{
4950 exarg_T eap;
4951 char_u *cmdstr;
4952 char *errormsg = NULL;
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004953 int emsgoff = TRUE;
Bram Moolenaar80dad482019-06-09 17:22:31 +02004954
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004955 if (in_vim9script()
4956 && (check_for_string_arg(argvars, 0) == FAIL
4957 || check_for_opt_dict_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004958 return;
4959
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004960 if (argvars[1].v_type == VAR_DICT
Bram Moolenaard61efa52022-07-23 09:52:04 +01004961 && dict_get_bool(argvars[1].vval.v_dict, "errmsg", VVAL_FALSE))
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004962 emsgoff = FALSE;
4963
Bram Moolenaar80dad482019-06-09 17:22:31 +02004964 rettv->v_type = VAR_STRING;
4965 cmdstr = vim_strsave(tv_get_string(&argvars[0]));
4966
Yegappan Lakshmanan960dcbd2023-03-07 17:45:11 +00004967 CLEAR_FIELD(eap);
Bram Moolenaar80dad482019-06-09 17:22:31 +02004968 eap.cmd = cmdstr;
4969 eap.arg = cmdstr;
Bram Moolenaar8071cb22019-07-12 17:58:01 +02004970 eap.argt |= EX_NOSPC;
Bram Moolenaar80dad482019-06-09 17:22:31 +02004971 eap.usefilter = FALSE;
4972 eap.nextcmd = NULL;
4973 eap.cmdidx = CMD_USER;
4974
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004975 if (emsgoff)
4976 ++emsg_off;
4977 if (expand_filename(&eap, &cmdstr, &errormsg) == FAIL)
4978 if (!emsgoff && errormsg != NULL && *errormsg != NUL)
4979 emsg(errormsg);
4980 if (emsgoff)
4981 --emsg_off;
Bram Moolenaar80dad482019-06-09 17:22:31 +02004982
4983 rettv->vval.v_string = cmdstr;
4984}
4985
4986/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004987 * "feedkeys()" function
4988 */
4989 static void
4990f_feedkeys(typval_T *argvars, typval_T *rettv UNUSED)
4991{
4992 int remap = TRUE;
4993 int insert = FALSE;
4994 char_u *keys, *flags;
4995 char_u nbuf[NUMBUFLEN];
4996 int typed = FALSE;
4997 int execute = FALSE;
Bram Moolenaara9725222022-01-16 13:30:33 +00004998 int context = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004999 int dangerous = FALSE;
Bram Moolenaar5e66b422019-01-24 21:58:10 +01005000 int lowlevel = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005001
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005002 // This is not allowed in the sandbox. If the commands would still be
5003 // executed in the sandbox it would be OK, but it probably happens later,
5004 // when "sandbox" is no longer set.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005005 if (check_secure())
5006 return;
5007
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005008 if (in_vim9script()
5009 && (check_for_string_arg(argvars, 0) == FAIL
5010 || check_for_opt_string_arg(argvars, 1) == FAIL))
5011 return;
5012
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005013 keys = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005014
5015 if (argvars[1].v_type != VAR_UNKNOWN)
5016 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005017 flags = tv_get_string_buf(&argvars[1], nbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005018 for ( ; *flags != NUL; ++flags)
5019 {
5020 switch (*flags)
5021 {
5022 case 'n': remap = FALSE; break;
5023 case 'm': remap = TRUE; break;
5024 case 't': typed = TRUE; break;
5025 case 'i': insert = TRUE; break;
5026 case 'x': execute = TRUE; break;
Bram Moolenaara9725222022-01-16 13:30:33 +00005027 case 'c': context = TRUE; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005028 case '!': dangerous = TRUE; break;
Bram Moolenaar5e66b422019-01-24 21:58:10 +01005029 case 'L': lowlevel = TRUE; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005030 }
5031 }
5032 }
5033
5034 if (*keys != NUL || execute)
5035 {
Christopher Plewright20b795e2022-12-20 20:01:58 +00005036 if (lowlevel
5037#ifdef FEAT_VTP
5038 && (!is_term_win32()
5039 || (keys[0] == 3 && ctrl_c_interrupts && typed))
5040#endif
5041 )
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005042 {
Bram Moolenaar5e66b422019-01-24 21:58:10 +01005043#ifdef USE_INPUT_BUF
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005044 ch_log(NULL, "feedkeys() lowlevel: %s", keys);
Bram Moolenaar9645e2d2020-03-20 20:48:49 +01005045
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005046 int len = (int)STRLEN(keys);
5047 for (int idx = 0; idx < len; ++idx)
5048 {
5049 // if a CTRL-C was typed, set got_int, similar to what
5050 // happens in fill_input_buf()
5051 if (keys[idx] == 3 && ctrl_c_interrupts && typed)
5052 got_int = TRUE;
5053 add_to_input_buf(keys + idx, 1);
5054 }
Bram Moolenaar5e66b422019-01-24 21:58:10 +01005055#else
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005056 emsg(_(e_lowlevel_input_not_supported));
Bram Moolenaar5e66b422019-01-24 21:58:10 +01005057#endif
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005058 }
5059 else
5060 {
5061 // Need to escape K_SPECIAL and CSI before putting the string in
5062 // the typeahead buffer.
5063 char_u *keys_esc = vim_strsave_escape_csi(keys);
5064 if (keys_esc == NULL)
5065 return;
5066
5067 ch_log(NULL, "feedkeys(%s): %s", typed ? "typed" : "", keys);
5068
5069 ins_typebuf(keys_esc, (remap ? REMAP_YES : REMAP_NONE),
5070 insert ? 0 : typebuf.tb_len, !typed, FALSE);
5071 if (vgetc_busy
Bram Moolenaar5d7be4f2017-06-25 13:40:17 +02005072#ifdef FEAT_TIMERS
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005073 || timer_busy
Bram Moolenaar5d7be4f2017-06-25 13:40:17 +02005074#endif
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005075 || input_busy)
5076 typebuf_was_filled = TRUE;
5077
Bram Moolenaar8d4ce562019-01-30 22:01:40 +01005078 vim_free(keys_esc);
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005079 }
Bram Moolenaar8d4ce562019-01-30 22:01:40 +01005080
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005081 if (execute)
5082 {
5083 int save_msg_scroll = msg_scroll;
5084 sctx_T save_sctx;
5085
5086 // Avoid a 1 second delay when the keys start Insert mode.
5087 msg_scroll = FALSE;
5088
5089 ch_log(NULL, "feedkeys() executing");
5090
5091 if (context)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005092 {
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005093 save_sctx = current_sctx;
5094 current_sctx.sc_sid = 0;
5095 current_sctx.sc_version = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005096 }
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005097
5098 if (!dangerous)
5099 {
5100 ++ex_normal_busy;
5101 ++in_feedkeys;
5102 }
5103 exec_normal(TRUE, lowlevel, TRUE);
5104 if (!dangerous)
5105 {
5106 --ex_normal_busy;
5107 --in_feedkeys;
5108 }
5109
5110 msg_scroll |= save_msg_scroll;
5111
5112 if (context)
5113 current_sctx = save_sctx;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005114 }
5115 }
5116}
5117
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005118/*
5119 * "fnameescape({string})" function
5120 */
5121 static void
5122f_fnameescape(typval_T *argvars, typval_T *rettv)
5123{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005124 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5125 return;
5126
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005127 rettv->vval.v_string = vim_strsave_fnameescape(
Bram Moolenaar21c1a0c2021-10-17 17:20:23 +01005128 tv_get_string(&argvars[0]), VSE_NONE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005129 rettv->v_type = VAR_STRING;
5130}
5131
5132/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005133 * "foreground()" function
5134 */
5135 static void
5136f_foreground(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
5137{
5138#ifdef FEAT_GUI
5139 if (gui.in_use)
Bram Moolenaarafde13b2019-04-28 19:46:49 +02005140 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005141 gui_mch_set_foreground();
Bram Moolenaarafde13b2019-04-28 19:46:49 +02005142 return;
5143 }
5144#endif
5145#if defined(MSWIN) && (!defined(FEAT_GUI) || defined(VIMDLL))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005146 win32_set_foreground();
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005147#endif
5148}
5149
Bakudankun375141e2022-09-09 18:46:47 +01005150/*
5151 * "function()" function
5152 * "funcref()" function
5153 */
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005154 static void
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005155common_function(typval_T *argvars, typval_T *rettv, int is_funcref)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005156{
5157 char_u *s;
5158 char_u *name;
5159 int use_string = FALSE;
5160 partial_T *arg_pt = NULL;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005161 char_u *trans_name = NULL;
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02005162 int is_global = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005163
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02005164 if (in_vim9script()
Bram Moolenaarae1068a2021-12-25 19:43:44 +00005165 && (check_for_string_or_func_arg(argvars, 0) == FAIL
5166 || check_for_opt_list_arg(argvars, 1) == FAIL
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02005167 || (argvars[1].v_type != VAR_UNKNOWN
5168 && check_for_opt_dict_arg(argvars, 2) == FAIL)))
5169 return;
5170
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005171 if (argvars[0].v_type == VAR_FUNC)
5172 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005173 // function(MyFunc, [arg], dict)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005174 s = argvars[0].vval.v_string;
5175 }
5176 else if (argvars[0].v_type == VAR_PARTIAL
5177 && argvars[0].vval.v_partial != NULL)
5178 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005179 // function(dict.MyFunc, [arg])
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005180 arg_pt = argvars[0].vval.v_partial;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005181 s = partial_name(arg_pt);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005182 }
5183 else
5184 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005185 // function('MyFunc', [arg], dict)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005186 s = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005187 use_string = TRUE;
5188 }
Bram Moolenaar60b6e6f2021-08-28 12:49:27 +02005189 if (s == NULL)
5190 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00005191 semsg(_(e_invalid_argument_str), "NULL");
Bram Moolenaar60b6e6f2021-08-28 12:49:27 +02005192 return;
5193 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005194
Bram Moolenaar843b8842016-08-21 14:36:15 +02005195 if ((use_string && vim_strchr(s, AUTOLOAD_CHAR) == NULL) || is_funcref)
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005196 {
5197 name = s;
Bram Moolenaareba3b7f2021-11-30 18:25:08 +00005198 trans_name = save_function_name(&name, &is_global, FALSE,
5199 TFN_INT | TFN_QUIET | TFN_NO_AUTOLOAD | TFN_NO_DEREF, NULL);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005200 if (*name != NUL)
5201 s = NULL;
5202 }
5203
Bram Moolenaar843b8842016-08-21 14:36:15 +02005204 if (s == NULL || *s == NUL || (use_string && VIM_ISDIGIT(*s))
5205 || (is_funcref && trans_name == NULL))
Yegappan Lakshmanan655b7342022-03-06 14:27:10 +00005206 semsg(_(e_invalid_argument_str),
5207 use_string ? tv_get_string(&argvars[0]) : s);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005208 // Don't check an autoload name for existence here.
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005209 else if (trans_name != NULL && (is_funcref
Bram Moolenaard9d2fd02022-01-13 21:15:21 +00005210 ? find_func(trans_name, is_global) == NULL
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02005211 : !translated_function_exists(trans_name, is_global)))
Bram Moolenaara6f79292022-01-04 21:30:47 +00005212 semsg(_(e_unknown_function_str_2), s);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005213 else
5214 {
5215 int dict_idx = 0;
5216 int arg_idx = 0;
5217 list_T *list = NULL;
5218
5219 if (STRNCMP(s, "s:", 2) == 0 || STRNCMP(s, "<SID>", 5) == 0)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005220 // Expand s: and <SID> into <SNR>nr_, so that the function can
5221 // also be called from another script. Using trans_function_name()
5222 // would also work, but some plugins depend on the name being
5223 // printable text.
Yegappan Lakshmanane7f4abd2021-12-24 20:47:38 +00005224 name = get_scriptlocal_funcname(s);
Bram Moolenaarc2f17f72022-02-21 13:13:50 +00005225 else if (trans_name != NULL && *trans_name == K_SPECIAL)
5226 name = alloc_printable_func_name(trans_name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005227 else
5228 name = vim_strsave(s);
5229
5230 if (argvars[1].v_type != VAR_UNKNOWN)
5231 {
5232 if (argvars[2].v_type != VAR_UNKNOWN)
5233 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005234 // function(name, [args], dict)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005235 arg_idx = 1;
5236 dict_idx = 2;
5237 }
5238 else if (argvars[1].v_type == VAR_DICT)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005239 // function(name, dict)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005240 dict_idx = 1;
5241 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005242 // function(name, [args])
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005243 arg_idx = 1;
5244 if (dict_idx > 0)
5245 {
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +01005246 if (check_for_dict_arg(argvars, dict_idx) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005247 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005248 vim_free(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005249 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005250 }
5251 if (argvars[dict_idx].vval.v_dict == NULL)
5252 dict_idx = 0;
5253 }
5254 if (arg_idx > 0)
5255 {
5256 if (argvars[arg_idx].v_type != VAR_LIST)
5257 {
Bram Moolenaard82a47d2022-01-05 20:24:39 +00005258 emsg(_(e_second_argument_of_function_must_be_list_or_dict));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005259 vim_free(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005260 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005261 }
5262 list = argvars[arg_idx].vval.v_list;
5263 if (list == NULL || list->lv_len == 0)
5264 arg_idx = 0;
Bram Moolenaar4c054e92019-11-10 00:13:50 +01005265 else if (list->lv_len > MAX_FUNC_ARGS)
5266 {
Yegappan Lakshmanan5018a832022-04-02 21:12:21 +01005267 emsg_funcname(e_too_many_arguments_for_function_str, s);
Bram Moolenaar4c054e92019-11-10 00:13:50 +01005268 vim_free(name);
5269 goto theend;
5270 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005271 }
5272 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005273 if (dict_idx > 0 || arg_idx > 0 || arg_pt != NULL || is_funcref)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005274 {
Bram Moolenaarc799fe22019-05-28 23:08:19 +02005275 partial_T *pt = ALLOC_CLEAR_ONE(partial_T);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005276
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005277 // result is a VAR_PARTIAL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005278 if (pt == NULL)
5279 vim_free(name);
5280 else
5281 {
5282 if (arg_idx > 0 || (arg_pt != NULL && arg_pt->pt_argc > 0))
5283 {
5284 listitem_T *li;
5285 int i = 0;
5286 int arg_len = 0;
5287 int lv_len = 0;
5288
5289 if (arg_pt != NULL)
5290 arg_len = arg_pt->pt_argc;
5291 if (list != NULL)
5292 lv_len = list->lv_len;
5293 pt->pt_argc = arg_len + lv_len;
Bram Moolenaarc799fe22019-05-28 23:08:19 +02005294 pt->pt_argv = ALLOC_MULT(typval_T, pt->pt_argc);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005295 if (pt->pt_argv == NULL)
5296 {
5297 vim_free(pt);
5298 vim_free(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005299 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005300 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005301 for (i = 0; i < arg_len; i++)
5302 copy_tv(&arg_pt->pt_argv[i], &pt->pt_argv[i]);
5303 if (lv_len > 0)
Bram Moolenaar50985eb2020-01-27 22:09:39 +01005304 {
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02005305 CHECK_LIST_MATERIALIZE(list);
Bram Moolenaaraeea7212020-04-02 18:50:46 +02005306 FOR_ALL_LIST_ITEMS(list, li)
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005307 copy_tv(&li->li_tv, &pt->pt_argv[i++]);
Bram Moolenaar50985eb2020-01-27 22:09:39 +01005308 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005309 }
5310
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005311 // For "function(dict.func, [], dict)" and "func" is a partial
5312 // use "dict". That is backwards compatible.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005313 if (dict_idx > 0)
5314 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005315 // The dict is bound explicitly, pt_auto is FALSE.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005316 pt->pt_dict = argvars[dict_idx].vval.v_dict;
5317 ++pt->pt_dict->dv_refcount;
5318 }
5319 else if (arg_pt != NULL)
5320 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005321 // If the dict was bound automatically the result is also
5322 // bound automatically.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005323 pt->pt_dict = arg_pt->pt_dict;
5324 pt->pt_auto = arg_pt->pt_auto;
5325 if (pt->pt_dict != NULL)
5326 ++pt->pt_dict->dv_refcount;
Yegappan Lakshmanan29bb67f2023-10-14 11:18:50 +02005327 pt->pt_obj = arg_pt->pt_obj;
5328 if (pt->pt_obj != NULL)
5329 ++pt->pt_obj->obj_refcount;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005330 }
5331
5332 pt->pt_refcount = 1;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005333 if (arg_pt != NULL && arg_pt->pt_func != NULL)
5334 {
5335 pt->pt_func = arg_pt->pt_func;
5336 func_ptr_ref(pt->pt_func);
5337 vim_free(name);
5338 }
5339 else if (is_funcref)
5340 {
Bram Moolenaard9d2fd02022-01-13 21:15:21 +00005341 pt->pt_func = find_func(trans_name, is_global);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005342 func_ptr_ref(pt->pt_func);
5343 vim_free(name);
5344 }
5345 else
5346 {
5347 pt->pt_name = name;
5348 func_ref(name);
5349 }
Bram Moolenaar92368aa2022-02-07 17:50:39 +00005350
5351 if (arg_pt != NULL)
Bram Moolenaar7aca5ca2022-02-07 19:56:43 +00005352 {
5353 pt->pt_outer_partial = arg_pt;
5354 ++arg_pt->pt_refcount;
5355 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005356 }
5357 rettv->v_type = VAR_PARTIAL;
5358 rettv->vval.v_partial = pt;
5359 }
5360 else
5361 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005362 // result is a VAR_FUNC
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005363 rettv->v_type = VAR_FUNC;
5364 rettv->vval.v_string = name;
5365 func_ref(name);
5366 }
5367 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005368theend:
5369 vim_free(trans_name);
5370}
5371
5372/*
5373 * "funcref()" function
5374 */
5375 static void
5376f_funcref(typval_T *argvars, typval_T *rettv)
5377{
5378 common_function(argvars, rettv, TRUE);
5379}
5380
5381/*
5382 * "function()" function
5383 */
5384 static void
5385f_function(typval_T *argvars, typval_T *rettv)
5386{
5387 common_function(argvars, rettv, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005388}
5389
5390/*
5391 * "garbagecollect()" function
5392 */
5393 static void
5394f_garbagecollect(typval_T *argvars, typval_T *rettv UNUSED)
5395{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005396 if (in_vim9script() && check_for_opt_bool_arg(argvars, 0) == FAIL)
5397 return;
5398
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005399 // This is postponed until we are back at the toplevel, because we may be
5400 // using Lists and Dicts internally. E.g.: ":echo [garbagecollect()]".
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005401 want_garbage_collect = TRUE;
5402
Bram Moolenaar2df47312020-09-05 17:30:44 +02005403 if (argvars[0].v_type != VAR_UNKNOWN && tv_get_bool(&argvars[0]) == 1)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005404 garbage_collect_at_exit = TRUE;
5405}
5406
5407/*
5408 * "get()" function
5409 */
5410 static void
5411f_get(typval_T *argvars, typval_T *rettv)
5412{
5413 listitem_T *li;
5414 list_T *l;
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01005415 tuple_T *tuple;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005416 dictitem_T *di;
5417 dict_T *d;
5418 typval_T *tv = NULL;
Bram Moolenaarf91aac52019-07-28 13:21:01 +02005419 int what_is_dict = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005420
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005421 if (argvars[0].v_type == VAR_BLOB)
5422 {
5423 int error = FALSE;
5424 int idx = tv_get_number_chk(&argvars[1], &error);
5425
5426 if (!error)
5427 {
5428 rettv->v_type = VAR_NUMBER;
Bram Moolenaar2ea773b2019-01-15 22:16:42 +01005429 if (idx < 0)
5430 idx = blob_len(argvars[0].vval.v_blob) + idx;
5431 if (idx < 0 || idx >= blob_len(argvars[0].vval.v_blob))
5432 rettv->vval.v_number = -1;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005433 else
Bram Moolenaar2ea773b2019-01-15 22:16:42 +01005434 {
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005435 rettv->vval.v_number = blob_get(argvars[0].vval.v_blob, idx);
Bram Moolenaar2ea773b2019-01-15 22:16:42 +01005436 tv = rettv;
5437 }
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005438 }
5439 }
5440 else if (argvars[0].v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005441 {
5442 if ((l = argvars[0].vval.v_list) != NULL)
5443 {
5444 int error = FALSE;
5445
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005446 li = list_find(l, (long)tv_get_number_chk(&argvars[1], &error));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005447 if (!error && li != NULL)
5448 tv = &li->li_tv;
5449 }
5450 }
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01005451 else if (argvars[0].v_type == VAR_TUPLE)
5452 {
5453 if ((tuple = argvars[0].vval.v_tuple) != NULL)
5454 {
5455 int error = FALSE;
5456 long idx;
5457
5458 idx = (long)tv_get_number_chk(&argvars[1], &error);
5459 if (!error)
5460 tv = tuple_find(tuple, idx);
5461 }
5462 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005463 else if (argvars[0].v_type == VAR_DICT)
5464 {
5465 if ((d = argvars[0].vval.v_dict) != NULL)
5466 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005467 di = dict_find(d, tv_get_string(&argvars[1]), -1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005468 if (di != NULL)
5469 tv = &di->di_tv;
5470 }
5471 }
5472 else if (argvars[0].v_type == VAR_PARTIAL || argvars[0].v_type == VAR_FUNC)
5473 {
5474 partial_T *pt;
5475 partial_T fref_pt;
5476
5477 if (argvars[0].v_type == VAR_PARTIAL)
5478 pt = argvars[0].vval.v_partial;
5479 else
5480 {
Bram Moolenaara80faa82020-04-12 19:37:17 +02005481 CLEAR_FIELD(fref_pt);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005482 fref_pt.pt_name = argvars[0].vval.v_string;
5483 pt = &fref_pt;
5484 }
5485
5486 if (pt != NULL)
5487 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005488 char_u *what = tv_get_string(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005489
5490 if (STRCMP(what, "func") == 0 || STRCMP(what, "name") == 0)
5491 {
Bram Moolenaar1ae8c262022-06-27 11:45:52 +01005492 char_u *name = partial_name(pt);
5493
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005494 rettv->v_type = (*what == 'f' ? VAR_FUNC : VAR_STRING);
Bram Moolenaar1ae8c262022-06-27 11:45:52 +01005495 if (name == NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005496 rettv->vval.v_string = NULL;
5497 else
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005498 {
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005499 if (rettv->v_type == VAR_FUNC)
Bram Moolenaar1ae8c262022-06-27 11:45:52 +01005500 func_ref(name);
5501 if (*what == 'n' && pt->pt_name == NULL
5502 && pt->pt_func != NULL)
5503 // use <SNR> instead of the byte code
5504 name = printable_func_name(pt->pt_func);
5505 rettv->vval.v_string = vim_strsave(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005506 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005507 }
5508 else if (STRCMP(what, "dict") == 0)
Bram Moolenaarf91aac52019-07-28 13:21:01 +02005509 {
5510 what_is_dict = TRUE;
5511 if (pt->pt_dict != NULL)
5512 rettv_dict_set(rettv, pt->pt_dict);
5513 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005514 else if (STRCMP(what, "args") == 0)
5515 {
5516 rettv->v_type = VAR_LIST;
5517 if (rettv_list_alloc(rettv) == OK)
5518 {
5519 int i;
5520
5521 for (i = 0; i < pt->pt_argc; ++i)
5522 list_append_tv(rettv->vval.v_list, &pt->pt_argv[i]);
5523 }
5524 }
LemonBoy48b7d052024-07-09 18:24:59 +02005525 else if (STRCMP(what, "arity") == 0)
5526 {
5527 int required = 0, optional = 0, varargs = FALSE;
5528 char_u *name = partial_name(pt);
5529
5530 get_func_arity(name, &required, &optional, &varargs);
5531
5532 rettv->v_type = VAR_DICT;
5533 if (rettv_dict_alloc(rettv) == OK)
5534 {
5535 dict_T *dict = rettv->vval.v_dict;
5536
5537 // Take into account the arguments of the partial, if any.
5538 // Note that it is possible to supply more arguments than the function
5539 // accepts.
5540 if (pt->pt_argc >= required + optional)
5541 required = optional = 0;
5542 else if (pt->pt_argc > required)
5543 {
5544 optional -= pt->pt_argc - required;
5545 required = 0;
5546 }
5547 else
5548 required -= pt->pt_argc;
5549
5550 dict_add_number(dict, "required", required);
5551 dict_add_number(dict, "optional", optional);
5552 dict_add_bool(dict, "varargs", varargs);
5553 }
5554 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005555 else
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00005556 semsg(_(e_invalid_argument_str), what);
Bram Moolenaarf91aac52019-07-28 13:21:01 +02005557
5558 // When {what} == "dict" and pt->pt_dict == NULL, evaluate the
5559 // third argument
5560 if (!what_is_dict)
5561 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005562 }
5563 }
5564 else
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01005565 semsg(_(e_argument_of_str_must_be_list_tuple_dictionary_or_blob), "get()");
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005566
5567 if (tv == NULL)
5568 {
5569 if (argvars[2].v_type != VAR_UNKNOWN)
5570 copy_tv(&argvars[2], rettv);
5571 }
5572 else
5573 copy_tv(tv, rettv);
5574}
5575
Bram Moolenaarb5ae48e2016-08-12 22:23:25 +02005576/*
mikoto2000a73dfc22024-11-18 21:12:21 +01005577 * "getcellpixels()" function
5578 */
5579 static void
5580f_getcellpixels(typval_T *argvars UNUSED, typval_T *rettv)
5581{
5582 if (rettv_list_alloc(rettv) == FAIL)
5583 return;
5584
5585#if defined(FEAT_GUI)
5586 if (gui.in_use)
5587 {
5588 // success pixel size and no gui.
5589 list_append_number(rettv->vval.v_list, (varnumber_T)gui.char_width);
5590 list_append_number(rettv->vval.v_list, (varnumber_T)gui.char_height);
5591 }
5592 else
5593#endif
5594 {
5595 struct cellsize cs;
5596#if defined(UNIX)
5597 mch_calc_cell_size(&cs);
5598#else
5599 // Non-Unix CUIs are not supported, so set this to -1x-1.
5600 cs.cs_xpixel = -1;
5601 cs.cs_ypixel = -1;
5602#endif
5603
5604 // failed get pixel size.
5605 if (cs.cs_xpixel == -1)
5606 return;
5607
5608 // success pixel size and no gui.
5609 list_append_number(rettv->vval.v_list, (varnumber_T)cs.cs_xpixel);
5610 list_append_number(rettv->vval.v_list, (varnumber_T)cs.cs_ypixel);
5611 }
5612
5613}
5614
5615/*
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005616 * "getchangelist()" function
5617 */
5618 static void
5619f_getchangelist(typval_T *argvars, typval_T *rettv)
5620{
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005621 buf_T *buf;
5622 int i;
5623 list_T *l;
5624 dict_T *d;
LemonBoydb0ea7f2022-04-10 17:59:26 +01005625 int changelistindex;
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005626
Bram Moolenaar93a10962022-06-16 11:42:09 +01005627 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005628 return;
5629
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005630 if (in_vim9script() && check_for_opt_buffer_arg(argvars, 0) == FAIL)
5631 return;
5632
Bram Moolenaar4c313b12019-08-24 22:58:31 +02005633 if (argvars[0].v_type == VAR_UNKNOWN)
5634 buf = curbuf;
5635 else
Bram Moolenaara5d38412020-09-02 21:02:35 +02005636 buf = tv_get_buf_from_arg(&argvars[0]);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005637 if (buf == NULL)
5638 return;
5639
5640 l = list_alloc();
5641 if (l == NULL)
5642 return;
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005643 if (list_append_list(rettv->vval.v_list, l) == FAIL)
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005644 {
5645 vim_free(l);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005646 return;
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005647 }
5648
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005649 /*
LemonBoydb0ea7f2022-04-10 17:59:26 +01005650 * The current window change list index tracks only the position for the
5651 * current buffer. For other buffers use the stored index for the current
5652 * window, or, if that's not available, the change list length.
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005653 */
LemonBoydb0ea7f2022-04-10 17:59:26 +01005654 if (buf == curwin->w_buffer)
5655 {
5656 changelistindex = curwin->w_changelistidx;
5657 }
5658 else
5659 {
5660 wininfo_T *wip;
5661
5662 FOR_ALL_BUF_WININFO(buf, wip)
5663 if (wip->wi_win == curwin)
5664 break;
5665 changelistindex = wip != NULL ? wip->wi_changelistidx
5666 : buf->b_changelistlen;
5667 }
5668 list_append_number(rettv->vval.v_list, (varnumber_T)changelistindex);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005669
5670 for (i = 0; i < buf->b_changelistlen; ++i)
5671 {
5672 if (buf->b_changelist[i].lnum == 0)
5673 continue;
5674 if ((d = dict_alloc()) == NULL)
5675 return;
5676 if (list_append_dict(l, d) == FAIL)
5677 return;
Bram Moolenaare0be1672018-07-08 16:50:37 +02005678 dict_add_number(d, "lnum", (long)buf->b_changelist[i].lnum);
5679 dict_add_number(d, "col", (long)buf->b_changelist[i].col);
Bram Moolenaare0be1672018-07-08 16:50:37 +02005680 dict_add_number(d, "coladd", (long)buf->b_changelist[i].coladd);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005681 }
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005682}
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005683
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005684 static void
5685getpos_both(
5686 typval_T *argvars,
5687 typval_T *rettv,
5688 int getcurpos,
5689 int charcol)
5690{
5691 pos_T *fp = NULL;
5692 pos_T pos;
5693 win_T *wp = curwin;
5694 list_T *l;
5695 int fnum = -1;
5696
5697 if (rettv_list_alloc(rettv) == OK)
5698 {
5699 l = rettv->vval.v_list;
5700 if (getcurpos)
5701 {
5702 if (argvars[0].v_type != VAR_UNKNOWN)
5703 {
5704 wp = find_win_by_nr_or_id(&argvars[0]);
5705 if (wp != NULL)
5706 fp = &wp->w_cursor;
5707 }
5708 else
5709 fp = &curwin->w_cursor;
5710 if (fp != NULL && charcol)
5711 {
5712 pos = *fp;
Bram Moolenaar91458462021-01-13 20:08:38 +01005713 pos.col =
5714 buf_byteidx_to_charidx(wp->w_buffer, pos.lnum, pos.col);
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005715 fp = &pos;
5716 }
5717 }
5718 else
5719 fp = var2fpos(&argvars[0], TRUE, &fnum, charcol);
5720 if (fnum != -1)
5721 list_append_number(l, (varnumber_T)fnum);
5722 else
5723 list_append_number(l, (varnumber_T)0);
5724 list_append_number(l, (fp != NULL) ? (varnumber_T)fp->lnum
5725 : (varnumber_T)0);
5726 list_append_number(l, (fp != NULL)
5727 ? (varnumber_T)(fp->col == MAXCOL ? MAXCOL : fp->col + 1)
5728 : (varnumber_T)0);
5729 list_append_number(l, (fp != NULL) ? (varnumber_T)fp->coladd :
5730 (varnumber_T)0);
5731 if (getcurpos)
5732 {
5733 int save_set_curswant = curwin->w_set_curswant;
5734 colnr_T save_curswant = curwin->w_curswant;
5735 colnr_T save_virtcol = curwin->w_virtcol;
5736
5737 if (wp == curwin)
5738 update_curswant();
5739 list_append_number(l, wp == NULL ? 0 : wp->w_curswant == MAXCOL
5740 ? (varnumber_T)MAXCOL : (varnumber_T)wp->w_curswant + 1);
5741
5742 // Do not change "curswant", as it is unexpected that a get
5743 // function has a side effect.
5744 if (wp == curwin && save_set_curswant)
5745 {
5746 curwin->w_set_curswant = save_set_curswant;
5747 curwin->w_curswant = save_curswant;
5748 curwin->w_virtcol = save_virtcol;
5749 curwin->w_valid &= ~VALID_VIRTCOL;
5750 }
5751 }
5752 }
5753 else
5754 rettv->vval.v_number = FALSE;
5755}
5756
5757/*
5758 * "getcharpos()" function
5759 */
5760 static void
5761f_getcharpos(typval_T *argvars UNUSED, typval_T *rettv)
5762{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005763 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5764 return;
5765
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005766 getpos_both(argvars, rettv, FALSE, TRUE);
5767}
5768
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005769/*
5770 * "getcharsearch()" function
5771 */
5772 static void
5773f_getcharsearch(typval_T *argvars UNUSED, typval_T *rettv)
5774{
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00005775 if (rettv_dict_alloc(rettv) != OK)
5776 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005777
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00005778 dict_T *dict = rettv->vval.v_dict;
5779
5780 dict_add_string(dict, "char", last_csearch());
5781 dict_add_number(dict, "forward", last_csearch_forward());
5782 dict_add_number(dict, "until", last_csearch_until());
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005783}
5784
5785/*
Bram Moolenaar691ddee2019-05-09 14:52:41 +02005786 * "getenv()" function
5787 */
5788 static void
5789f_getenv(typval_T *argvars, typval_T *rettv)
5790{
5791 int mustfree = FALSE;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005792 char_u *p;
Bram Moolenaar691ddee2019-05-09 14:52:41 +02005793
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005794 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5795 return;
5796
5797 p = vim_getenv(tv_get_string(&argvars[0]), &mustfree);
Bram Moolenaar691ddee2019-05-09 14:52:41 +02005798 if (p == NULL)
5799 {
5800 rettv->v_type = VAR_SPECIAL;
5801 rettv->vval.v_number = VVAL_NULL;
5802 return;
5803 }
5804 if (!mustfree)
5805 p = vim_strsave(p);
5806 rettv->vval.v_string = p;
5807 rettv->v_type = VAR_STRING;
5808}
5809
5810/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005811 * "getfontname()" function
5812 */
5813 static void
5814f_getfontname(typval_T *argvars UNUSED, typval_T *rettv)
5815{
5816 rettv->v_type = VAR_STRING;
5817 rettv->vval.v_string = NULL;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005818
5819 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
5820 return;
5821
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005822#ifdef FEAT_GUI
5823 if (gui.in_use)
5824 {
5825 GuiFont font;
5826 char_u *name = NULL;
5827
5828 if (argvars[0].v_type == VAR_UNKNOWN)
5829 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005830 // Get the "Normal" font. Either the name saved by
5831 // hl_set_font_name() or from the font ID.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005832 font = gui.norm_font;
5833 name = hl_get_font_name();
5834 }
5835 else
5836 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005837 name = tv_get_string(&argvars[0]);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005838 if (STRCMP(name, "*") == 0) // don't use font dialog
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005839 return;
5840 font = gui_mch_get_font(name, FALSE);
5841 if (font == NOFONT)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005842 return; // Invalid font name, return empty string.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005843 }
5844 rettv->vval.v_string = gui_mch_get_fontname(font, name);
5845 if (argvars[0].v_type != VAR_UNKNOWN)
5846 gui_mch_free_font(font);
5847 }
5848#endif
5849}
5850
5851/*
Bram Moolenaar4f505882018-02-10 21:06:32 +01005852 * "getjumplist()" function
5853 */
5854 static void
5855f_getjumplist(typval_T *argvars, typval_T *rettv)
5856{
Bram Moolenaar4f505882018-02-10 21:06:32 +01005857 win_T *wp;
5858 int i;
5859 list_T *l;
5860 dict_T *d;
Bram Moolenaar4f505882018-02-10 21:06:32 +01005861
Bram Moolenaar93a10962022-06-16 11:42:09 +01005862 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar4f505882018-02-10 21:06:32 +01005863 return;
5864
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005865 if (in_vim9script()
5866 && (check_for_opt_number_arg(argvars, 0) == FAIL
5867 || (argvars[0].v_type != VAR_UNKNOWN
5868 && check_for_opt_number_arg(argvars, 1) == FAIL)))
5869 return;
5870
Bram Moolenaar00aa0692019-04-27 20:37:57 +02005871 wp = find_tabwin(&argvars[0], &argvars[1], NULL);
Bram Moolenaar4f505882018-02-10 21:06:32 +01005872 if (wp == NULL)
5873 return;
5874
Bram Moolenaar57ee2b62019-02-12 22:15:06 +01005875 cleanup_jumplist(wp, TRUE);
5876
Bram Moolenaar4f505882018-02-10 21:06:32 +01005877 l = list_alloc();
5878 if (l == NULL)
5879 return;
Bram Moolenaar4f505882018-02-10 21:06:32 +01005880 if (list_append_list(rettv->vval.v_list, l) == FAIL)
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005881 {
5882 vim_free(l);
Bram Moolenaar4f505882018-02-10 21:06:32 +01005883 return;
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005884 }
5885
Bram Moolenaar4f505882018-02-10 21:06:32 +01005886 list_append_number(rettv->vval.v_list, (varnumber_T)wp->w_jumplistidx);
5887
5888 for (i = 0; i < wp->w_jumplistlen; ++i)
5889 {
Bram Moolenaara7e18d22018-02-11 14:29:49 +01005890 if (wp->w_jumplist[i].fmark.mark.lnum == 0)
5891 continue;
Bram Moolenaar4f505882018-02-10 21:06:32 +01005892 if ((d = dict_alloc()) == NULL)
5893 return;
5894 if (list_append_dict(l, d) == FAIL)
5895 return;
Bram Moolenaare0be1672018-07-08 16:50:37 +02005896 dict_add_number(d, "lnum", (long)wp->w_jumplist[i].fmark.mark.lnum);
5897 dict_add_number(d, "col", (long)wp->w_jumplist[i].fmark.mark.col);
Bram Moolenaare0be1672018-07-08 16:50:37 +02005898 dict_add_number(d, "coladd", (long)wp->w_jumplist[i].fmark.mark.coladd);
Bram Moolenaare0be1672018-07-08 16:50:37 +02005899 dict_add_number(d, "bufnr", (long)wp->w_jumplist[i].fmark.fnum);
Bram Moolenaara7e18d22018-02-11 14:29:49 +01005900 if (wp->w_jumplist[i].fname != NULL)
Bram Moolenaare0be1672018-07-08 16:50:37 +02005901 dict_add_string(d, "filename", wp->w_jumplist[i].fname);
Bram Moolenaar4f505882018-02-10 21:06:32 +01005902 }
Bram Moolenaar4f505882018-02-10 21:06:32 +01005903}
5904
5905/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005906 * "getpid()" function
5907 */
5908 static void
5909f_getpid(typval_T *argvars UNUSED, typval_T *rettv)
5910{
5911 rettv->vval.v_number = mch_get_pid();
5912}
5913
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005914/*
5915 * "getcurpos()" function
5916 */
5917 static void
5918f_getcurpos(typval_T *argvars, typval_T *rettv)
5919{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005920 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
5921 return;
5922
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005923 getpos_both(argvars, rettv, TRUE, FALSE);
5924}
5925
5926 static void
5927f_getcursorcharpos(typval_T *argvars, typval_T *rettv)
5928{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005929 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
5930 return;
5931
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005932 getpos_both(argvars, rettv, TRUE, TRUE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005933}
5934
5935/*
5936 * "getpos(string)" function
5937 */
5938 static void
5939f_getpos(typval_T *argvars, typval_T *rettv)
5940{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005941 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5942 return;
5943
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005944 getpos_both(argvars, rettv, FALSE, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005945}
5946
5947/*
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005948 * Convert from block_def to string
5949 */
Gary Johnson88d4f252024-06-01 20:51:33 +02005950 static char_u *
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005951block_def2str(struct block_def *bd)
5952{
5953 char_u *p, *ret;
5954 size_t size = bd->startspaces + bd->endspaces + bd->textlen;
5955
5956 ret = alloc(size + 1);
5957 if (ret != NULL)
5958 {
5959 p = ret;
5960 vim_memset(p, ' ', bd->startspaces);
5961 p += bd->startspaces;
5962 mch_memmove(p, bd->textstart, bd->textlen);
5963 p += bd->textlen;
5964 vim_memset(p, ' ', bd->endspaces);
5965 *(p + bd->endspaces) = NUL;
5966 }
5967 return ret;
5968}
5969
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005970 static int
5971getregionpos(
5972 typval_T *argvars,
5973 typval_T *rettv,
zeertzjqc95e64f2024-05-20 14:00:31 +02005974 pos_T *p1,
5975 pos_T *p2,
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005976 int *inclusive,
5977 int *region_type,
zeertzjqafc22952024-05-24 19:07:12 +02005978 oparg_T *oap)
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005979{
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005980 int fnum1 = -1, fnum2 = -1;
5981 char_u *type;
5982 buf_T *findbuf;
5983 char_u default_type[] = "v";
zeertzjqafc22952024-05-24 19:07:12 +02005984 int block_width = 0;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005985 int is_select_exclusive;
5986 int l;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005987
5988 if (rettv_list_alloc(rettv) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005989 return FAIL;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005990
Shougo Matsushita19b71882024-02-28 22:48:12 +01005991 if (check_for_list_arg(argvars, 0) == FAIL
5992 || check_for_list_arg(argvars, 1) == FAIL
5993 || check_for_opt_dict_arg(argvars, 2) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005994 return FAIL;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005995
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005996 if (list2fpos(&argvars[0], p1, &fnum1, NULL, FALSE) != OK
5997 || list2fpos(&argvars[1], p2, &fnum2, NULL, FALSE) != OK
Shougo Matsushita84bf6e62024-03-06 21:10:18 +01005998 || fnum1 != fnum2)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005999 return FAIL;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006000
Shougo Matsushita19b71882024-02-28 22:48:12 +01006001 if (argvars[2].v_type == VAR_DICT)
6002 {
6003 is_select_exclusive = dict_get_bool(
6004 argvars[2].vval.v_dict, "exclusive", *p_sel == 'e');
6005 type = dict_get_string(
6006 argvars[2].vval.v_dict, "type", FALSE);
6007 if (type == NULL)
6008 type = default_type;
6009 }
6010 else
6011 {
6012 is_select_exclusive = *p_sel == 'e';
6013 type = default_type;
6014 }
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006015
6016 if (type[0] == 'v' && type[1] == NUL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006017 *region_type = MCHAR;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006018 else if (type[0] == 'V' && type[1] == NUL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006019 *region_type = MLINE;
zeertzjqafc22952024-05-24 19:07:12 +02006020 else if (type[0] == Ctrl_V)
6021 {
6022 char_u *p = type + 1;
6023
6024 if (*p != NUL && ((block_width = getdigits(&p)) <= 0 || *p != NUL))
6025 {
6026 semsg(_(e_invalid_value_for_argument_str_str), "type", type);
6027 return FAIL;
6028 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006029 *region_type = MBLOCK;
zeertzjqafc22952024-05-24 19:07:12 +02006030 }
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006031 else
zeertzjq26dd09a2024-03-10 15:46:58 +01006032 {
6033 semsg(_(e_invalid_value_for_argument_str_str), "type", type);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006034 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01006035 }
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006036
zeertzjq5406eb82024-03-11 21:36:42 +01006037 findbuf = fnum1 != 0 ? buflist_findnr(fnum1) : curbuf;
6038 if (findbuf == NULL || findbuf->b_ml.ml_mfp == NULL)
Shougo Matsushita84bf6e62024-03-06 21:10:18 +01006039 {
zeertzjq5406eb82024-03-11 21:36:42 +01006040 emsg(_(e_buffer_is_not_loaded));
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006041 return FAIL;
Shougo Matsushita84bf6e62024-03-06 21:10:18 +01006042 }
6043
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006044 if (p1->lnum < 1 || p1->lnum > findbuf->b_ml.ml_line_count)
zeertzjq26dd09a2024-03-10 15:46:58 +01006045 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006046 semsg(_(e_invalid_line_number_nr), p1->lnum);
6047 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01006048 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006049 if (p1->col == MAXCOL)
6050 p1->col = ml_get_buf_len(findbuf, p1->lnum) + 1;
6051 else if (p1->col < 1 || p1->col > ml_get_buf_len(findbuf, p1->lnum) + 1)
zeertzjq26dd09a2024-03-10 15:46:58 +01006052 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006053 semsg(_(e_invalid_column_number_nr), p1->col);
6054 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01006055 }
zeertzjq2ffdae72024-05-02 13:06:24 +02006056
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006057 if (p2->lnum < 1 || p2->lnum > findbuf->b_ml.ml_line_count)
zeertzjq26dd09a2024-03-10 15:46:58 +01006058 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006059 semsg(_(e_invalid_line_number_nr), p2->lnum);
6060 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01006061 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006062 if (p2->col == MAXCOL)
6063 p2->col = ml_get_buf_len(findbuf, p2->lnum) + 1;
6064 else if (p2->col < 1 || p2->col > ml_get_buf_len(findbuf, p2->lnum) + 1)
zeertzjq26dd09a2024-03-10 15:46:58 +01006065 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006066 semsg(_(e_invalid_column_number_nr), p2->col);
6067 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01006068 }
6069
6070 curbuf = findbuf;
zeertzjq5406eb82024-03-11 21:36:42 +01006071 curwin->w_buffer = curbuf;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006072 virtual_op = virtual_active();
6073
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006074 // NOTE: Adjustment is needed.
6075 p1->col--;
6076 p2->col--;
Shougo Matsushita19b71882024-02-28 22:48:12 +01006077
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006078 if (!LT_POS(*p1, *p2))
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006079 {
6080 // swap position
6081 pos_T p;
6082
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006083 p = *p1;
6084 *p1 = *p2;
6085 *p2 = p;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006086 }
6087
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006088 if (*region_type == MCHAR)
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006089 {
zeertzjq701ad502024-05-23 07:47:55 +02006090 // Handle 'selection' == "exclusive".
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006091 if (is_select_exclusive && !EQUAL_POS(*p1, *p2))
zeertzjq701ad502024-05-23 07:47:55 +02006092 // When backing up to previous line, inclusive becomes false.
6093 *inclusive = !unadjust_for_sel_inner(p2);
6094 // If p2 is on NUL (end of line), inclusive becomes false.
6095 if (*inclusive && !virtual_op && *ml_get_pos(p2) == NUL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006096 *inclusive = FALSE;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006097 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006098 else if (*region_type == MBLOCK)
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006099 {
6100 colnr_T sc1, ec1, sc2, ec2;
6101
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006102 getvvcol(curwin, p1, &sc1, NULL, &ec1);
6103 getvvcol(curwin, p2, &sc2, NULL, &ec2);
zeertzjqafc22952024-05-24 19:07:12 +02006104 oap->motion_type = MBLOCK;
6105 oap->inclusive = TRUE;
6106 oap->op_type = OP_NOP;
6107 oap->start = *p1;
6108 oap->end = *p2;
6109 oap->start_vcol = MIN(sc1, sc2);
6110 if (block_width > 0)
6111 oap->end_vcol = oap->start_vcol + block_width - 1;
6112 else if (is_select_exclusive && ec1 < sc2 && 0 < sc2 && ec2 > ec1)
6113 oap->end_vcol = sc2 - 1;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006114 else
zeertzjqafc22952024-05-24 19:07:12 +02006115 oap->end_vcol = MAX(ec1, ec2);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006116 }
6117
6118 // Include the trailing byte of a multi-byte char.
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006119 l = mb_ptr2len((char_u *)ml_get_pos(p2));
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006120 if (l > 1)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006121 p2->col += l - 1;
6122
6123 return OK;
6124}
6125
6126/*
6127 * "getregion()" function
6128 */
6129 static void
6130f_getregion(typval_T *argvars, typval_T *rettv)
6131{
6132 pos_T p1, p2;
6133 int inclusive = TRUE;
6134 int region_type = -1;
6135 oparg_T oa;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006136
6137 buf_T *save_curbuf;
6138 int save_virtual;
6139 char_u *akt = NULL;
6140 linenr_T lnum;
6141
6142 save_curbuf = curbuf;
6143 save_virtual = virtual_op;
6144
6145 if (getregionpos(argvars, rettv,
zeertzjqc95e64f2024-05-20 14:00:31 +02006146 &p1, &p2, &inclusive, &region_type, &oa) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006147 return;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006148
6149 for (lnum = p1.lnum; lnum <= p2.lnum; lnum++)
6150 {
6151 int ret = 0;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006152 struct block_def bd;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006153
6154 if (region_type == MLINE)
6155 akt = vim_strsave(ml_get(lnum));
6156 else if (region_type == MBLOCK)
6157 {
zeertzjq5e3674b2024-02-22 19:51:34 +01006158 block_prep(&oa, &bd, lnum, FALSE);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006159 akt = block_def2str(&bd);
6160 }
6161 else if (p1.lnum < lnum && lnum < p2.lnum)
6162 akt = vim_strsave(ml_get(lnum));
6163 else
6164 {
6165 charwise_block_prep(p1, p2, &bd, lnum, inclusive);
6166 akt = block_def2str(&bd);
6167 }
6168
6169 if (akt)
6170 {
6171 ret = list_append_string(rettv->vval.v_list, akt, -1);
6172 vim_free(akt);
6173 }
6174
6175 if (akt == NULL || ret == FAIL)
6176 {
zeertzjq5e3674b2024-02-22 19:51:34 +01006177 clear_tv(rettv);
6178 (void)rettv_list_alloc(rettv);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006179 break;
6180 }
6181 }
6182
zeertzjqc95e64f2024-05-20 14:00:31 +02006183 // getregionpos() may change curbuf and virtual_op
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006184 curbuf = save_curbuf;
6185 curwin->w_buffer = curbuf;
6186 virtual_op = save_virtual;
6187}
6188
6189 static void
zeertzjqc95e64f2024-05-20 14:00:31 +02006190add_regionpos_range(typval_T *rettv, pos_T p1, pos_T p2)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006191{
6192 list_T *l1, *l2, *l3;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006193
6194 l1 = list_alloc();
6195 if (l1 == NULL)
6196 return;
6197
6198 if (list_append_list(rettv->vval.v_list, l1) == FAIL)
6199 {
6200 vim_free(l1);
6201 return;
6202 }
6203
6204 l2 = list_alloc();
6205 if (l2 == NULL)
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006206 {
6207 vim_free(l1);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006208 return;
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006209 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006210
6211 if (list_append_list(l1, l2) == FAIL)
6212 {
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006213 vim_free(l1);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006214 vim_free(l2);
6215 return;
6216 }
6217
6218 l3 = list_alloc();
6219 if (l3 == NULL)
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006220 {
6221 vim_free(l1);
6222 vim_free(l2);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006223 return;
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006224 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006225
6226 if (list_append_list(l1, l3) == FAIL)
6227 {
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006228 vim_free(l1);
6229 vim_free(l2);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006230 vim_free(l3);
6231 return;
6232 }
6233
zeertzjqc95e64f2024-05-20 14:00:31 +02006234 list_append_number(l2, curbuf->b_fnum);
6235 list_append_number(l2, p1.lnum);
zeertzjq2b09de92024-05-24 07:48:51 +02006236 list_append_number(l2, p1.col);
zeertzjqc95e64f2024-05-20 14:00:31 +02006237 list_append_number(l2, p1.coladd);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006238
zeertzjqc95e64f2024-05-20 14:00:31 +02006239 list_append_number(l3, curbuf->b_fnum);
6240 list_append_number(l3, p2.lnum);
zeertzjq2b09de92024-05-24 07:48:51 +02006241 list_append_number(l3, p2.col);
zeertzjqc95e64f2024-05-20 14:00:31 +02006242 list_append_number(l3, p2.coladd);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006243}
6244
6245/*
6246 * "getregionpos()" function
6247 */
6248 static void
6249f_getregionpos(typval_T *argvars, typval_T *rettv)
6250{
6251 pos_T p1, p2;
6252 int inclusive = TRUE;
6253 int region_type = -1;
zeertzjq2b09de92024-05-24 07:48:51 +02006254 int allow_eol = FALSE;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006255 oparg_T oa;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006256 int lnum;
6257
6258 buf_T *save_curbuf;
6259 int save_virtual;
6260
6261 save_curbuf = curbuf;
6262 save_virtual = virtual_op;
6263
6264 if (getregionpos(argvars, rettv,
zeertzjqc95e64f2024-05-20 14:00:31 +02006265 &p1, &p2, &inclusive, &region_type, &oa) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006266 return;
6267
zeertzjq2b09de92024-05-24 07:48:51 +02006268 if (argvars[2].v_type == VAR_DICT)
6269 allow_eol = dict_get_bool(argvars[2].vval.v_dict, "eol", FALSE);
6270
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006271 for (lnum = p1.lnum; lnum <= p2.lnum; lnum++)
6272 {
zeertzjq2b09de92024-05-24 07:48:51 +02006273 pos_T ret_p1, ret_p2;
zeertzjqef733742024-05-26 18:42:18 +02006274 char_u *line = ml_get(lnum);
zeertzjq2b09de92024-05-24 07:48:51 +02006275 colnr_T line_len = ml_get_len(lnum);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006276
6277 if (region_type == MLINE)
6278 {
zeertzjqc95e64f2024-05-20 14:00:31 +02006279 ret_p1.col = 1;
6280 ret_p1.coladd = 0;
6281 ret_p2.col = MAXCOL;
6282 ret_p2.coladd = 0;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006283 }
6284 else
6285 {
zeertzjq52a6f342024-05-22 16:42:44 +02006286 struct block_def bd;
6287
zeertzjqc95e64f2024-05-20 14:00:31 +02006288 if (region_type == MBLOCK)
6289 block_prep(&oa, &bd, lnum, FALSE);
6290 else
6291 charwise_block_prep(p1, p2, &bd, lnum, inclusive);
zeertzjq52a6f342024-05-22 16:42:44 +02006292
6293 if (bd.is_oneChar) // selection entirely inside one char
6294 {
6295 if (region_type == MBLOCK)
6296 {
zeertzjqef733742024-05-26 18:42:18 +02006297 ret_p1.col = mb_prevptr(line, bd.textstart) - line + 1;
zeertzjq52a6f342024-05-22 16:42:44 +02006298 ret_p1.coladd = bd.start_char_vcols
6299 - (bd.start_vcol - oa.start_vcol);
6300 }
6301 else
6302 {
6303 ret_p1.col = p1.col + 1;
6304 ret_p1.coladd = p1.coladd;
6305 }
6306 }
zeertzjq2b09de92024-05-24 07:48:51 +02006307 else if (region_type == MBLOCK && oa.start_vcol > bd.start_vcol)
6308 {
6309 // blockwise selection entirely beyond end of line
6310 ret_p1.col = MAXCOL;
6311 ret_p1.coladd = oa.start_vcol - bd.start_vcol;
6312 bd.is_oneChar = TRUE;
6313 }
zeertzjq52a6f342024-05-22 16:42:44 +02006314 else if (bd.startspaces > 0)
zeertzjqc95e64f2024-05-20 14:00:31 +02006315 {
zeertzjqef733742024-05-26 18:42:18 +02006316 ret_p1.col = mb_prevptr(line, bd.textstart) - line + 1;
zeertzjqc95e64f2024-05-20 14:00:31 +02006317 ret_p1.coladd = bd.start_char_vcols - bd.startspaces;
6318 }
6319 else
6320 {
6321 ret_p1.col = bd.textcol + 1;
6322 ret_p1.coladd = 0;
6323 }
zeertzjq52a6f342024-05-22 16:42:44 +02006324
6325 if (bd.is_oneChar) // selection entirely inside one char
6326 {
6327 ret_p2.col = ret_p1.col;
zeertzjq2b09de92024-05-24 07:48:51 +02006328 ret_p2.coladd = ret_p1.coladd + bd.startspaces + bd.endspaces;
zeertzjq52a6f342024-05-22 16:42:44 +02006329 }
6330 else if (bd.endspaces > 0)
zeertzjqc95e64f2024-05-20 14:00:31 +02006331 {
6332 ret_p2.col = bd.textcol + bd.textlen + 1;
6333 ret_p2.coladd = bd.endspaces;
6334 }
6335 else
6336 {
6337 ret_p2.col = bd.textcol + bd.textlen;
6338 ret_p2.coladd = 0;
6339 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006340 }
6341
zeertzjq2b09de92024-05-24 07:48:51 +02006342 if (!allow_eol && ret_p1.col > line_len)
6343 {
6344 ret_p1.col = 0;
6345 ret_p1.coladd = 0;
6346 }
6347 else if (ret_p1.col > line_len + 1)
6348 ret_p1.col = line_len + 1;
6349
6350 if (!allow_eol && ret_p2.col > line_len)
6351 {
6352 ret_p2.col = ret_p1.col == 0 ? 0 : line_len;
6353 ret_p2.coladd = 0;
6354 }
6355 else if (ret_p2.col > line_len + 1)
6356 ret_p2.col = line_len + 1;
6357
zeertzjqc95e64f2024-05-20 14:00:31 +02006358 ret_p1.lnum = lnum;
6359 ret_p2.lnum = lnum;
6360 add_regionpos_range(rettv, ret_p1, ret_p2);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006361 }
6362
6363 // getregionpos() may change curbuf and virtual_op
zeertzjq5406eb82024-03-11 21:36:42 +01006364 curbuf = save_curbuf;
6365 curwin->w_buffer = curbuf;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006366 virtual_op = save_virtual;
6367}
6368
6369/*
zeertzjqd3f00f52021-12-24 12:02:43 +00006370 * Common between getreg(), getreginfo() and getregtype(): get the register
6371 * name from the first argument.
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006372 * Returns zero on error.
6373 */
6374 static int
6375getreg_get_regname(typval_T *argvars)
6376{
6377 char_u *strregname;
6378
6379 if (argvars[0].v_type != VAR_UNKNOWN)
6380 {
6381 strregname = tv_get_string_chk(&argvars[0]);
6382 if (strregname != NULL && in_vim9script() && STRLEN(strregname) > 1)
6383 {
6384 semsg(_(e_register_name_must_be_one_char_str), strregname);
6385 strregname = NULL;
6386 }
6387 if (strregname == NULL) // type error; errmsg already given
6388 return 0;
6389 }
6390 else
6391 // Default to v:register
6392 strregname = get_vim_var_str(VV_REG);
6393
6394 return *strregname == 0 ? '"' : *strregname;
6395}
6396
6397/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006398 * "getreg()" function
6399 */
6400 static void
6401f_getreg(typval_T *argvars, typval_T *rettv)
6402{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006403 int regname;
6404 int arg2 = FALSE;
6405 int return_list = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006406
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02006407 if (in_vim9script()
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006408 && (check_for_opt_string_arg(argvars, 0) == FAIL
6409 || (argvars[0].v_type != VAR_UNKNOWN
6410 && (check_for_opt_bool_arg(argvars, 1) == FAIL
6411 || (argvars[1].v_type != VAR_UNKNOWN
6412 && check_for_opt_bool_arg(argvars, 2) == FAIL)))))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02006413 return;
6414
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006415 regname = getreg_get_regname(argvars);
6416 if (regname == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006417 return;
6418
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006419 if (argvars[0].v_type != VAR_UNKNOWN && argvars[1].v_type != VAR_UNKNOWN)
6420 {
6421 int error = FALSE;
6422
6423 arg2 = (int)tv_get_bool_chk(&argvars[1], &error);
6424
6425 if (!error && argvars[2].v_type != VAR_UNKNOWN)
6426 return_list = (int)tv_get_bool_chk(&argvars[2], &error);
6427 if (error)
6428 return;
6429 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006430
6431 if (return_list)
6432 {
6433 rettv->v_type = VAR_LIST;
6434 rettv->vval.v_list = (list_T *)get_reg_contents(regname,
6435 (arg2 ? GREG_EXPR_SRC : 0) | GREG_LIST);
6436 if (rettv->vval.v_list == NULL)
6437 (void)rettv_list_alloc(rettv);
6438 else
6439 ++rettv->vval.v_list->lv_refcount;
6440 }
6441 else
6442 {
6443 rettv->v_type = VAR_STRING;
6444 rettv->vval.v_string = get_reg_contents(regname,
6445 arg2 ? GREG_EXPR_SRC : 0);
6446 }
6447}
6448
6449/*
6450 * "getregtype()" function
6451 */
6452 static void
6453f_getregtype(typval_T *argvars, typval_T *rettv)
6454{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006455 int regname;
6456 char_u buf[NUMBUFLEN + 2];
6457 long reglen = 0;
6458
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006459 // on error return an empty string
6460 rettv->v_type = VAR_STRING;
6461 rettv->vval.v_string = NULL;
6462
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006463 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
6464 return;
6465
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006466 regname = getreg_get_regname(argvars);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006467 if (regname == 0)
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006468 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006469
6470 buf[0] = NUL;
6471 buf[1] = NUL;
6472 switch (get_reg_type(regname, &reglen))
6473 {
6474 case MLINE: buf[0] = 'V'; break;
6475 case MCHAR: buf[0] = 'v'; break;
6476 case MBLOCK:
6477 buf[0] = Ctrl_V;
6478 sprintf((char *)buf + 1, "%ld", reglen + 1);
6479 break;
6480 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006481 rettv->vval.v_string = vim_strsave(buf);
6482}
6483
Bram Moolenaarb5ae48e2016-08-12 22:23:25 +02006484/*
Bram Moolenaarf49cc602018-11-11 15:21:05 +01006485 * "gettagstack()" function
6486 */
6487 static void
6488f_gettagstack(typval_T *argvars, typval_T *rettv)
6489{
6490 win_T *wp = curwin; // default is current window
6491
Bram Moolenaar93a10962022-06-16 11:42:09 +01006492 if (rettv_dict_alloc(rettv) == FAIL)
Bram Moolenaarf49cc602018-11-11 15:21:05 +01006493 return;
6494
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006495 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
6496 return;
6497
Bram Moolenaarf49cc602018-11-11 15:21:05 +01006498 if (argvars[0].v_type != VAR_UNKNOWN)
6499 {
6500 wp = find_win_by_nr_or_id(&argvars[0]);
6501 if (wp == NULL)
6502 return;
6503 }
6504
6505 get_tagstack(wp, rettv->vval.v_dict);
6506}
6507
Bram Moolenaar0b39c3f2020-08-30 15:52:10 +02006508/*
6509 * "gettext()" function
6510 */
6511 static void
6512f_gettext(typval_T *argvars, typval_T *rettv)
6513{
Christ van Willegence0ef912024-06-20 23:41:59 +02006514#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
6515 char *prev = NULL;
6516#endif
6517
6518 if (check_for_nonempty_string_arg(argvars, 0) == FAIL
6519 || check_for_opt_string_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006520 return;
6521
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +01006522 rettv->v_type = VAR_STRING;
Christ van Willegence0ef912024-06-20 23:41:59 +02006523
6524 if (argvars[1].v_type == VAR_STRING &&
6525 argvars[1].vval.v_string != NULL &&
6526 *(argvars[1].vval.v_string) != NUL)
6527 {
6528#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
6529 prev = bind_textdomain_codeset((const char *)argvars[1].vval.v_string, (char *)p_enc);
6530#endif
6531
6532#if defined(HAVE_DGETTEXT)
6533 rettv->vval.v_string = vim_strsave((char_u *)dgettext((const char *)argvars[1].vval.v_string, (const char *)argvars[0].vval.v_string));
6534#else
6535 textdomain((const char *)argvars[1].vval.v_string);
6536 rettv->vval.v_string = vim_strsave((char_u *)_(argvars[0].vval.v_string));
6537 textdomain(VIMPACKAGE);
6538#endif
6539
6540#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
6541 if (prev != NULL)
6542 bind_textdomain_codeset((const char *)argvars[1].vval.v_string, prev);
6543#endif
6544 }
6545 else
6546 rettv->vval.v_string = vim_strsave((char_u *)_(argvars[0].vval.v_string));
Bram Moolenaar0b39c3f2020-08-30 15:52:10 +02006547}
6548
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01006549// for VIM_VERSION_ defines
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006550#include "version.h"
6551
6552/*
6553 * "has()" function
6554 */
Bram Moolenaara259d8d2020-01-31 20:10:50 +01006555 void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006556f_has(typval_T *argvars, typval_T *rettv)
6557{
6558 int i;
6559 char_u *name;
Bram Moolenaar79296512020-03-22 16:17:14 +01006560 int x = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006561 int n = FALSE;
Bram Moolenaar79296512020-03-22 16:17:14 +01006562 typedef struct {
6563 char *name;
6564 short present;
6565 } has_item_T;
6566 static has_item_T has_list[] =
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006567 {
Bram Moolenaar79296512020-03-22 16:17:14 +01006568 {"amiga",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006569#ifdef AMIGA
Bram Moolenaar79296512020-03-22 16:17:14 +01006570 1
Bram Moolenaar39536dd2019-01-29 22:58:21 +01006571#else
Bram Moolenaar79296512020-03-22 16:17:14 +01006572 0
Bram Moolenaar39536dd2019-01-29 22:58:21 +01006573#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006574 },
6575 {"arp",
6576#if defined(AMIGA) && defined(FEAT_ARP)
6577 1
6578#else
6579 0
6580#endif
6581 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006582 {"haiku",
6583#ifdef __HAIKU__
6584 1
6585#else
6586 0
6587#endif
6588 },
6589 {"bsd",
Zhaoming Luoa41dfcd2025-02-06 21:39:35 +01006590#if defined(BSD) && !defined(MACOS_X) && !defined(__GNU__)
Bram Moolenaar79296512020-03-22 16:17:14 +01006591 1
6592#else
6593 0
6594#endif
6595 },
6596 {"hpux",
6597#ifdef hpux
6598 1
6599#else
6600 0
6601#endif
6602 },
Zhaoming Luoa41dfcd2025-02-06 21:39:35 +01006603 {"hurd",
6604#ifdef __GNU__
6605 1
6606#else
6607 0
6608#endif
6609 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006610 {"linux",
6611#ifdef __linux__
6612 1
6613#else
6614 0
6615#endif
6616 },
6617 {"mac", // Mac OS X (and, once, Mac OS Classic)
6618#ifdef MACOS_X
6619 1
6620#else
6621 0
6622#endif
6623 },
6624 {"osx", // Mac OS X
6625#ifdef MACOS_X
6626 1
6627#else
6628 0
6629#endif
6630 },
6631 {"macunix", // Mac OS X, with the darwin feature
6632#if defined(MACOS_X) && defined(MACOS_X_DARWIN)
6633 1
6634#else
6635 0
6636#endif
6637 },
6638 {"osxdarwin", // synonym for macunix
6639#if defined(MACOS_X) && defined(MACOS_X_DARWIN)
6640 1
6641#else
6642 0
6643#endif
6644 },
6645 {"qnx",
6646#ifdef __QNX__
6647 1
6648#else
6649 0
6650#endif
6651 },
6652 {"sun",
6653#ifdef SUN_SYSTEM
6654 1
6655#else
6656 0
6657#endif
6658 },
6659 {"unix",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006660#ifdef UNIX
Bram Moolenaar79296512020-03-22 16:17:14 +01006661 1
6662#else
6663 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006664#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006665 },
6666 {"vms",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006667#ifdef VMS
Bram Moolenaar79296512020-03-22 16:17:14 +01006668 1
6669#else
6670 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006671#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006672 },
6673 {"win32",
Bram Moolenaar4f974752019-02-17 17:44:42 +01006674#ifdef MSWIN
Bram Moolenaar79296512020-03-22 16:17:14 +01006675 1
6676#else
6677 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006678#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006679 },
6680 {"win32unix",
K.Takata972db232022-02-04 10:45:38 +00006681#ifdef WIN32UNIX
Bram Moolenaar79296512020-03-22 16:17:14 +01006682 1
6683#else
6684 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006685#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006686 },
6687 {"win64",
Bram Moolenaar44b443c2019-02-18 22:14:18 +01006688#ifdef _WIN64
Bram Moolenaar79296512020-03-22 16:17:14 +01006689 1
6690#else
6691 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006692#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006693 },
Bram Moolenaar424bcae2022-01-31 14:59:41 +00006694 {"ebcdic", 0 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006695 {"fname_case",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006696#ifndef CASE_INSENSITIVE_FILENAME
Bram Moolenaar79296512020-03-22 16:17:14 +01006697 1
6698#else
6699 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006700#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006701 },
6702 {"acl",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006703#ifdef HAVE_ACL
Bram Moolenaar79296512020-03-22 16:17:14 +01006704 1
6705#else
6706 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006707#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006708 },
6709 {"arabic",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006710#ifdef FEAT_ARABIC
Bram Moolenaar79296512020-03-22 16:17:14 +01006711 1
6712#else
6713 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006714#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006715 },
6716 {"autocmd", 1},
6717 {"autochdir",
Bram Moolenaar83ec2a72018-07-27 22:08:59 +02006718#ifdef FEAT_AUTOCHDIR
Bram Moolenaar79296512020-03-22 16:17:14 +01006719 1
6720#else
6721 0
Bram Moolenaar83ec2a72018-07-27 22:08:59 +02006722#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006723 },
6724 {"autoservername",
Bram Moolenaare42a6d22017-11-12 19:21:51 +01006725#ifdef FEAT_AUTOSERVERNAME
Bram Moolenaar79296512020-03-22 16:17:14 +01006726 1
6727#else
6728 0
Bram Moolenaare42a6d22017-11-12 19:21:51 +01006729#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006730 },
6731 {"balloon_eval",
Bram Moolenaarc3719bd2017-11-18 22:13:31 +01006732#ifdef FEAT_BEVAL_GUI
Bram Moolenaar79296512020-03-22 16:17:14 +01006733 1
6734#else
6735 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006736#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006737 },
6738 {"balloon_multiline",
Bram Moolenaar0bd663a2022-01-22 10:24:47 +00006739#ifdef FEAT_BEVAL_GUI
Bram Moolenaar79296512020-03-22 16:17:14 +01006740 1
6741#else
6742 0
6743#endif
6744 },
6745 {"balloon_eval_term",
Bram Moolenaarc3719bd2017-11-18 22:13:31 +01006746#ifdef FEAT_BEVAL_TERM
Bram Moolenaar79296512020-03-22 16:17:14 +01006747 1
6748#else
6749 0
Bram Moolenaar51b0f372017-11-18 18:52:04 +01006750#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006751 },
Bram Moolenaar2ee347f2022-08-26 17:53:44 +01006752 {"builtin_terms", 1},
6753 {"all_builtin_terms", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006754 {"browsefilter",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006755#if defined(FEAT_BROWSE) && (defined(USE_FILE_CHOOSER) \
Bram Moolenaar4f974752019-02-17 17:44:42 +01006756 || defined(FEAT_GUI_MSWIN) \
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006757 || defined(FEAT_GUI_MOTIF))
Bram Moolenaar79296512020-03-22 16:17:14 +01006758 1
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006759#else
Bram Moolenaar79296512020-03-22 16:17:14 +01006760 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006761#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006762 },
6763 {"byte_offset",
6764#ifdef FEAT_BYTEOFF
6765 1
6766#else
6767 0
6768#endif
6769 },
6770 {"channel",
6771#ifdef FEAT_JOB_CHANNEL
6772 1
6773#else
6774 0
6775#endif
6776 },
Bram Moolenaar8e145b82022-05-21 20:17:31 +01006777 {"cindent", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006778 {"clientserver",
6779#ifdef FEAT_CLIENTSERVER
6780 1
6781#else
6782 0
6783#endif
6784 },
6785 {"clipboard",
6786#ifdef FEAT_CLIPBOARD
6787 1
6788#else
6789 0
6790#endif
6791 },
6792 {"cmdline_compl", 1},
6793 {"cmdline_hist", 1},
Martin Tournoij7904fa42022-10-04 16:28:45 +01006794 {"cmdwin", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006795 {"comments", 1},
6796 {"conceal",
6797#ifdef FEAT_CONCEAL
6798 1
6799#else
6800 0
6801#endif
6802 },
6803 {"cryptv",
6804#ifdef FEAT_CRYPT
6805 1
6806#else
6807 0
6808#endif
6809 },
6810 {"crypt-blowfish",
6811#ifdef FEAT_CRYPT
6812 1
6813#else
6814 0
6815#endif
6816 },
6817 {"crypt-blowfish2",
6818#ifdef FEAT_CRYPT
6819 1
6820#else
6821 0
6822#endif
6823 },
6824 {"cscope",
6825#ifdef FEAT_CSCOPE
6826 1
6827#else
6828 0
6829#endif
6830 },
6831 {"cursorbind", 1},
6832 {"cursorshape",
6833#ifdef CURSOR_SHAPE
6834 1
6835#else
6836 0
6837#endif
6838 },
6839 {"debug",
6840#ifdef DEBUG
6841 1
6842#else
6843 0
6844#endif
6845 },
6846 {"dialog_con",
6847#ifdef FEAT_CON_DIALOG
6848 1
6849#else
6850 0
6851#endif
6852 },
glepnirdf461152024-04-04 22:23:29 +02006853 {"dialog_con_gui",
6854#if defined(FEAT_CON_DIALOG) && defined(FEAT_GUI_DIALOG)
6855 1
6856#else
6857 0
6858#endif
6859 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006860 {"dialog_gui",
6861#ifdef FEAT_GUI_DIALOG
6862 1
6863#else
6864 0
6865#endif
6866 },
6867 {"diff",
6868#ifdef FEAT_DIFF
6869 1
6870#else
6871 0
6872#endif
6873 },
6874 {"digraphs",
6875#ifdef FEAT_DIGRAPHS
6876 1
6877#else
6878 0
6879#endif
6880 },
6881 {"directx",
6882#ifdef FEAT_DIRECTX
6883 1
6884#else
6885 0
6886#endif
6887 },
6888 {"dnd",
6889#ifdef FEAT_DND
6890 1
6891#else
6892 0
6893#endif
6894 },
Bram Moolenaar1d1ce612021-06-27 19:02:52 +02006895 {"drop_file",
6896#ifdef HAVE_DROP_FILE
6897 1
6898#else
6899 0
6900#endif
6901 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006902 {"emacs_tags",
6903#ifdef FEAT_EMACS_TAGS
6904 1
6905#else
6906 0
6907#endif
6908 },
6909 {"eval", 1}, // always present, of course!
6910 {"ex_extra", 1}, // graduated feature
6911 {"extra_search",
6912#ifdef FEAT_SEARCH_EXTRA
6913 1
6914#else
6915 0
6916#endif
6917 },
Bram Moolenaarf80f40a2022-08-25 16:02:23 +01006918 {"file_in_path", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006919 {"filterpipe",
6920#if defined(FEAT_FILTERPIPE) && !defined(VIMDLL)
6921 1
6922#else
6923 0
6924#endif
6925 },
6926 {"find_in_path",
6927#ifdef FEAT_FIND_ID
6928 1
6929#else
6930 0
6931#endif
6932 },
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01006933 {"float", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006934 {"folding",
6935#ifdef FEAT_FOLDING
6936 1
6937#else
6938 0
6939#endif
6940 },
Bram Moolenaarc8ac3a02022-09-04 12:29:28 +01006941 {"footer", 0},
Bram Moolenaar79296512020-03-22 16:17:14 +01006942 {"fork",
6943#if !defined(USE_SYSTEM) && defined(UNIX)
6944 1
6945#else
6946 0
6947#endif
6948 },
6949 {"gettext",
6950#ifdef FEAT_GETTEXT
6951 1
6952#else
6953 0
6954#endif
6955 },
6956 {"gui",
6957#ifdef FEAT_GUI
6958 1
6959#else
6960 0
6961#endif
6962 },
Bram Moolenaar0b962e52022-04-03 18:02:37 +01006963 {"gui_neXtaw", 0 },
6964 {"gui_athena", 0 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006965 {"gui_gtk",
6966#ifdef FEAT_GUI_GTK
6967 1
6968#else
6969 0
6970#endif
6971 },
6972 {"gui_gtk2",
6973#if defined(FEAT_GUI_GTK) && !defined(USE_GTK3)
6974 1
6975#else
6976 0
6977#endif
6978 },
6979 {"gui_gtk3",
6980#if defined(FEAT_GUI_GTK) && defined(USE_GTK3)
6981 1
6982#else
6983 0
6984#endif
6985 },
6986 {"gui_gnome",
6987#ifdef FEAT_GUI_GNOME
6988 1
6989#else
6990 0
6991#endif
6992 },
6993 {"gui_haiku",
6994#ifdef FEAT_GUI_HAIKU
6995 1
6996#else
6997 0
6998#endif
6999 },
Bram Moolenaar097148e2020-08-11 21:58:20 +02007000 {"gui_mac", 0},
Bram Moolenaar79296512020-03-22 16:17:14 +01007001 {"gui_motif",
7002#ifdef FEAT_GUI_MOTIF
7003 1
7004#else
7005 0
7006#endif
7007 },
7008 {"gui_photon",
7009#ifdef FEAT_GUI_PHOTON
7010 1
7011#else
7012 0
7013#endif
7014 },
7015 {"gui_win32",
7016#ifdef FEAT_GUI_MSWIN
7017 1
7018#else
7019 0
7020#endif
7021 },
7022 {"iconv",
7023#if defined(HAVE_ICONV_H) && defined(USE_ICONV)
7024 1
7025#else
7026 0
7027#endif
7028 },
7029 {"insert_expand", 1},
Bram Moolenaarbfe13cc2020-04-12 17:53:12 +02007030 {"ipv6",
7031#ifdef FEAT_IPV6
7032 1
7033#else
7034 0
7035#endif
7036 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007037 {"job",
7038#ifdef FEAT_JOB_CHANNEL
7039 1
7040#else
7041 0
7042#endif
7043 },
Bram Moolenaar739f13a2021-12-13 13:12:53 +00007044 {"jumplist", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007045 {"keymap",
7046#ifdef FEAT_KEYMAP
7047 1
7048#else
7049 0
7050#endif
7051 },
7052 {"lambda", 1}, // always with FEAT_EVAL, since 7.4.2120 with closure
7053 {"langmap",
7054#ifdef FEAT_LANGMAP
7055 1
7056#else
7057 0
7058#endif
7059 },
7060 {"libcall",
7061#ifdef FEAT_LIBCALL
7062 1
7063#else
7064 0
7065#endif
7066 },
7067 {"linebreak",
7068#ifdef FEAT_LINEBREAK
7069 1
7070#else
7071 0
7072#endif
7073 },
Bram Moolenaar8e145b82022-05-21 20:17:31 +01007074 {"lispindent", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007075 {"listcmds", 1},
7076 {"localmap", 1},
7077 {"lua",
7078#if defined(FEAT_LUA) && !defined(DYNAMIC_LUA)
7079 1
7080#else
7081 0
7082#endif
7083 },
7084 {"menu",
7085#ifdef FEAT_MENU
7086 1
7087#else
7088 0
7089#endif
7090 },
7091 {"mksession",
7092#ifdef FEAT_SESSION
7093 1
7094#else
7095 0
7096#endif
7097 },
7098 {"modify_fname", 1},
7099 {"mouse", 1},
7100 {"mouseshape",
7101#ifdef FEAT_MOUSESHAPE
7102 1
7103#else
7104 0
7105#endif
7106 },
7107 {"mouse_dec",
7108#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_DEC)
7109 1
7110#else
7111 0
7112#endif
7113 },
7114 {"mouse_gpm",
Bram Moolenaar33fc4a62022-02-23 18:07:38 +00007115#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_GPM) && !defined(DYNAMIC_GPM)
Bram Moolenaar79296512020-03-22 16:17:14 +01007116 1
7117#else
7118 0
7119#endif
7120 },
7121 {"mouse_jsbterm",
7122#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_JSB)
7123 1
7124#else
7125 0
7126#endif
7127 },
7128 {"mouse_netterm",
7129#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_NET)
7130 1
7131#else
7132 0
7133#endif
7134 },
7135 {"mouse_pterm",
7136#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_PTERM)
7137 1
7138#else
7139 0
7140#endif
7141 },
7142 {"mouse_sgr",
7143#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_XTERM)
7144 1
7145#else
7146 0
7147#endif
7148 },
7149 {"mouse_sysmouse",
7150#if (defined(UNIX) || defined(VMS)) && defined(FEAT_SYSMOUSE)
7151 1
7152#else
7153 0
7154#endif
7155 },
7156 {"mouse_urxvt",
7157#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_URXVT)
7158 1
7159#else
7160 0
7161#endif
7162 },
7163 {"mouse_xterm",
7164#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_XTERM)
7165 1
7166#else
7167 0
7168#endif
7169 },
7170 {"multi_byte", 1},
7171 {"multi_byte_ime",
7172#ifdef FEAT_MBYTE_IME
7173 1
7174#else
7175 0
7176#endif
7177 },
7178 {"multi_lang",
7179#ifdef FEAT_MULTI_LANG
7180 1
7181#else
7182 0
7183#endif
7184 },
7185 {"mzscheme",
7186#if defined(FEAT_MZSCHEME) && !defined(DYNAMIC_MZSCHEME)
7187 1
7188#else
7189 0
7190#endif
7191 },
Leah Neukirchen0a7984a2021-10-14 21:27:55 +01007192 {"nanotime",
7193#ifdef ST_MTIM_NSEC
7194 1
7195#else
7196 0
7197#endif
7198 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007199 {"num64", 1},
7200 {"ole",
7201#ifdef FEAT_OLE
7202 1
7203#else
7204 0
7205#endif
7206 },
7207 {"packages",
7208#ifdef FEAT_EVAL
7209 1
7210#else
7211 0
7212#endif
7213 },
Bram Moolenaar2bd9dbc2022-08-25 18:12:06 +01007214 {"path_extra", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007215 {"perl",
7216#if defined(FEAT_PERL) && !defined(DYNAMIC_PERL)
7217 1
7218#else
7219 0
7220#endif
7221 },
7222 {"persistent_undo",
7223#ifdef FEAT_PERSISTENT_UNDO
7224 1
7225#else
7226 0
7227#endif
7228 },
7229 {"python_compiled",
7230#if defined(FEAT_PYTHON)
7231 1
7232#else
7233 0
7234#endif
7235 },
7236 {"python_dynamic",
7237#if defined(FEAT_PYTHON) && defined(DYNAMIC_PYTHON)
7238 1
7239#else
7240 0
7241#endif
7242 },
7243 {"python",
7244#if defined(FEAT_PYTHON) && !defined(DYNAMIC_PYTHON)
7245 1
7246#else
7247 0
7248#endif
7249 },
7250 {"pythonx",
7251#if (defined(FEAT_PYTHON) && !defined(DYNAMIC_PYTHON)) \
7252 || (defined(FEAT_PYTHON3) && !defined(DYNAMIC_PYTHON3))
7253 1
7254#else
7255 0
7256#endif
7257 },
7258 {"python3_compiled",
7259#if defined(FEAT_PYTHON3)
7260 1
7261#else
7262 0
7263#endif
7264 },
7265 {"python3_dynamic",
7266#if defined(FEAT_PYTHON3) && defined(DYNAMIC_PYTHON3)
7267 1
7268#else
7269 0
7270#endif
7271 },
Yee Cheng Chinc13b3d12023-08-20 21:18:38 +02007272 {"python3_stable",
7273#if defined(FEAT_PYTHON3) && defined(DYNAMIC_PYTHON3_STABLE_ABI)
7274 1
7275#else
7276 0
7277#endif
7278 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007279 {"python3",
7280#if defined(FEAT_PYTHON3) && !defined(DYNAMIC_PYTHON3)
7281 1
7282#else
7283 0
7284#endif
7285 },
7286 {"popupwin",
7287#ifdef FEAT_PROP_POPUP
7288 1
7289#else
7290 0
7291#endif
7292 },
7293 {"postscript",
7294#ifdef FEAT_POSTSCRIPT
7295 1
7296#else
7297 0
7298#endif
7299 },
7300 {"printer",
7301#ifdef FEAT_PRINTER
7302 1
7303#else
7304 0
7305#endif
7306 },
7307 {"profile",
7308#ifdef FEAT_PROFILE
7309 1
7310#else
7311 0
7312#endif
7313 },
Ernie Rael076de792023-03-16 21:43:15 +00007314 {"prof_nsec",
Bram Moolenaar08210f82023-04-13 19:15:54 +01007315#ifdef PROF_NSEC
Ernie Rael076de792023-03-16 21:43:15 +00007316 1
7317#else
7318 0
7319#endif
7320 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007321 {"reltime",
7322#ifdef FEAT_RELTIME
7323 1
7324#else
7325 0
7326#endif
7327 },
7328 {"quickfix",
7329#ifdef FEAT_QUICKFIX
7330 1
7331#else
7332 0
7333#endif
7334 },
7335 {"rightleft",
7336#ifdef FEAT_RIGHTLEFT
7337 1
7338#else
7339 0
7340#endif
7341 },
7342 {"ruby",
7343#if defined(FEAT_RUBY) && !defined(DYNAMIC_RUBY)
7344 1
7345#else
7346 0
7347#endif
7348 },
7349 {"scrollbind", 1},
Martin Tournoijba43e762022-10-13 22:12:15 +01007350 {"showcmd", 1},
7351 {"cmdline_info", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007352 {"signs",
7353#ifdef FEAT_SIGNS
7354 1
7355#else
7356 0
7357#endif
7358 },
Bram Moolenaar8e145b82022-05-21 20:17:31 +01007359 {"smartindent", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007360 {"startuptime",
7361#ifdef STARTUPTIME
7362 1
7363#else
7364 0
7365#endif
7366 },
7367 {"statusline",
7368#ifdef FEAT_STL_OPT
7369 1
7370#else
7371 0
7372#endif
7373 },
7374 {"netbeans_intg",
7375#ifdef FEAT_NETBEANS_INTG
7376 1
7377#else
7378 0
7379#endif
7380 },
Christian Brabandtf573c6e2021-06-20 14:02:16 +02007381 {"sodium",
K.Takatad68b2fc2022-02-12 11:18:37 +00007382#if defined(FEAT_SODIUM) && !defined(DYNAMIC_SODIUM)
Christian Brabandtf573c6e2021-06-20 14:02:16 +02007383 1
7384#else
7385 0
7386#endif
7387 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007388 {"sound",
7389#ifdef FEAT_SOUND
7390 1
7391#else
7392 0
7393#endif
7394 },
7395 {"spell",
7396#ifdef FEAT_SPELL
7397 1
7398#else
7399 0
7400#endif
7401 },
7402 {"syntax",
7403#ifdef FEAT_SYN_HL
7404 1
7405#else
7406 0
7407#endif
7408 },
7409 {"system",
7410#if defined(USE_SYSTEM) || !defined(UNIX)
7411 1
7412#else
7413 0
7414#endif
7415 },
Yegappan Lakshmanan655b7342022-03-06 14:27:10 +00007416 {"tag_binary", 1}, // graduated feature
Bram Moolenaar79296512020-03-22 16:17:14 +01007417 {"tcl",
7418#if defined(FEAT_TCL) && !defined(DYNAMIC_TCL)
7419 1
7420#else
7421 0
7422#endif
7423 },
7424 {"termguicolors",
7425#ifdef FEAT_TERMGUICOLORS
7426 1
7427#else
7428 0
7429#endif
7430 },
7431 {"terminal",
7432#if defined(FEAT_TERMINAL) && !defined(MSWIN)
7433 1
7434#else
7435 0
7436#endif
7437 },
7438 {"terminfo",
7439#ifdef TERMINFO
7440 1
7441#else
7442 0
7443#endif
7444 },
7445 {"termresponse",
7446#ifdef FEAT_TERMRESPONSE
7447 1
7448#else
7449 0
7450#endif
7451 },
Bram Moolenaar88774872022-08-16 20:24:29 +01007452 {"textobjects", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007453 {"textprop",
7454#ifdef FEAT_PROP_POPUP
7455 1
7456#else
7457 0
7458#endif
7459 },
7460 {"tgetent",
7461#ifdef HAVE_TGETENT
7462 1
7463#else
7464 0
7465#endif
7466 },
7467 {"timers",
7468#ifdef FEAT_TIMERS
7469 1
7470#else
7471 0
7472#endif
7473 },
Bram Moolenaar651fca82021-11-29 20:39:38 +00007474 {"title", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007475 {"toolbar",
7476#ifdef FEAT_TOOLBAR
7477 1
7478#else
7479 0
7480#endif
7481 },
7482 {"unnamedplus",
7483#if defined(FEAT_CLIPBOARD) && defined(FEAT_X11)
7484 1
7485#else
7486 0
7487#endif
7488 },
7489 {"user-commands", 1}, // was accidentally included in 5.4
7490 {"user_commands", 1},
7491 {"vartabs",
7492#ifdef FEAT_VARTABS
7493 1
7494#else
7495 0
7496#endif
7497 },
7498 {"vertsplit", 1},
7499 {"viminfo",
7500#ifdef FEAT_VIMINFO
7501 1
7502#else
7503 0
7504#endif
7505 },
Bram Moolenaarb79ee0c2022-01-01 12:17:00 +00007506 {"vim9script", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007507 {"vimscript-1", 1},
7508 {"vimscript-2", 1},
7509 {"vimscript-3", 1},
7510 {"vimscript-4", 1},
7511 {"virtualedit", 1},
7512 {"visual", 1},
7513 {"visualextra", 1},
7514 {"vreplace", 1},
7515 {"vtp",
7516#ifdef FEAT_VTP
7517 1
7518#else
7519 0
7520#endif
7521 },
Bram Moolenaar074fbd42022-08-26 16:41:14 +01007522 {"wildignore", 1},
Bram Moolenaar54162322022-08-26 16:58:51 +01007523 {"wildmenu", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007524 {"windows", 1},
7525 {"winaltkeys",
7526#ifdef FEAT_WAK
7527 1
7528#else
7529 0
7530#endif
7531 },
7532 {"writebackup",
7533#ifdef FEAT_WRITEBACKUP
7534 1
7535#else
7536 0
7537#endif
7538 },
Christian Brabandte085dfd2023-09-30 12:49:18 +02007539 {"xattr",
7540#ifdef FEAT_XATTR
7541 1
7542#else
7543 0
7544#endif
7545 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007546 {"xim",
7547#ifdef FEAT_XIM
7548 1
7549#else
7550 0
7551#endif
7552 },
7553 {"xfontset",
7554#ifdef FEAT_XFONTSET
7555 1
7556#else
7557 0
7558#endif
7559 },
7560 {"xpm",
7561#if defined(FEAT_XPM_W32) || defined(HAVE_XPM)
7562 1
7563#else
7564 0
7565#endif
7566 },
7567 {"xpm_w32", // for backward compatibility
7568#ifdef FEAT_XPM_W32
7569 1
7570#else
7571 0
7572#endif
7573 },
7574 {"xsmp",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007575#ifdef USE_XSMP
Bram Moolenaar79296512020-03-22 16:17:14 +01007576 1
7577#else
7578 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007579#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007580 },
7581 {"xsmp_interact",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007582#ifdef USE_XSMP_INTERACT
Bram Moolenaar79296512020-03-22 16:17:14 +01007583 1
7584#else
7585 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007586#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007587 },
7588 {"xterm_clipboard",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007589#ifdef FEAT_XCLIPBOARD
Bram Moolenaar79296512020-03-22 16:17:14 +01007590 1
7591#else
7592 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007593#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007594 },
7595 {"xterm_save",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007596#ifdef FEAT_XTERM_SAVE
Bram Moolenaar79296512020-03-22 16:17:14 +01007597 1
7598#else
7599 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007600#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007601 },
7602 {"X11",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007603#if defined(UNIX) && defined(FEAT_X11)
Bram Moolenaar79296512020-03-22 16:17:14 +01007604 1
7605#else
7606 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007607#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007608 },
Bram Moolenaar80adaa82023-07-07 18:57:40 +01007609 {":tearoff",
7610// same #ifdef as used for ex_tearoff().
7611#if defined(FEAT_GUI_MSWIN) && defined(FEAT_MENU) && defined(FEAT_TEAROFF)
7612 1
7613#else
7614 0
7615#endif
7616 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007617 {NULL, 0}
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007618 };
7619
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02007620 if (in_vim9script()
7621 && (check_for_string_arg(argvars, 0) == FAIL
7622 || check_for_opt_bool_arg(argvars, 1) == FAIL))
7623 return;
7624
Bram Moolenaard155d7a2018-12-21 16:04:21 +01007625 name = tv_get_string(&argvars[0]);
Bram Moolenaar79296512020-03-22 16:17:14 +01007626 for (i = 0; has_list[i].name != NULL; ++i)
7627 if (STRICMP(name, has_list[i].name) == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007628 {
Bram Moolenaar79296512020-03-22 16:17:14 +01007629 x = TRUE;
7630 n = has_list[i].present;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007631 break;
7632 }
7633
Bram Moolenaar79296512020-03-22 16:17:14 +01007634 // features also in has_list[] but sometimes enabled at runtime
7635 if (x == TRUE && n == FALSE)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007636 {
Bram Moolenaar79296512020-03-22 16:17:14 +01007637 if (0)
Bram Moolenaar86b9a3e2020-04-07 19:57:29 +02007638 {
7639 // intentionally empty
7640 }
Bram Moolenaar79296512020-03-22 16:17:14 +01007641#ifdef VIMDLL
7642 else if (STRICMP(name, "filterpipe") == 0)
7643 n = gui.in_use || gui.starting;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007644#endif
7645#if defined(USE_ICONV) && defined(DYNAMIC_ICONV)
7646 else if (STRICMP(name, "iconv") == 0)
7647 n = iconv_enabled(FALSE);
7648#endif
7649#ifdef DYNAMIC_LUA
7650 else if (STRICMP(name, "lua") == 0)
7651 n = lua_enabled(FALSE);
7652#endif
7653#ifdef DYNAMIC_MZSCHEME
7654 else if (STRICMP(name, "mzscheme") == 0)
7655 n = mzscheme_enabled(FALSE);
7656#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007657#ifdef DYNAMIC_PERL
7658 else if (STRICMP(name, "perl") == 0)
7659 n = perl_enabled(FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007660#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007661#ifdef DYNAMIC_PYTHON
7662 else if (STRICMP(name, "python") == 0)
7663 n = python_enabled(FALSE);
7664#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007665#ifdef DYNAMIC_PYTHON3
7666 else if (STRICMP(name, "python3") == 0)
7667 n = python3_enabled(FALSE);
7668#endif
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01007669#if defined(DYNAMIC_PYTHON) || defined(DYNAMIC_PYTHON3)
7670 else if (STRICMP(name, "pythonx") == 0)
7671 {
7672# if defined(DYNAMIC_PYTHON) && defined(DYNAMIC_PYTHON3)
7673 if (p_pyx == 0)
7674 n = python3_enabled(FALSE) || python_enabled(FALSE);
7675 else if (p_pyx == 3)
7676 n = python3_enabled(FALSE);
7677 else if (p_pyx == 2)
7678 n = python_enabled(FALSE);
7679# elif defined(DYNAMIC_PYTHON)
7680 n = python_enabled(FALSE);
7681# elif defined(DYNAMIC_PYTHON3)
7682 n = python3_enabled(FALSE);
7683# endif
7684 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007685#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007686#ifdef DYNAMIC_RUBY
7687 else if (STRICMP(name, "ruby") == 0)
7688 n = ruby_enabled(FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007689#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007690#ifdef DYNAMIC_TCL
7691 else if (STRICMP(name, "tcl") == 0)
7692 n = tcl_enabled(FALSE);
Bram Moolenaar4b8366b2019-05-04 17:34:34 +02007693#endif
K.Takatad68b2fc2022-02-12 11:18:37 +00007694#ifdef DYNAMIC_SODIUM
7695 else if (STRICMP(name, "sodium") == 0)
7696 n = sodium_enabled(FALSE);
7697#endif
Bram Moolenaar4f974752019-02-17 17:44:42 +01007698#if defined(FEAT_TERMINAL) && defined(MSWIN)
Bram Moolenaara83e3962017-08-17 14:39:07 +02007699 else if (STRICMP(name, "terminal") == 0)
7700 n = terminal_enabled();
7701#endif
Bram Moolenaar33fc4a62022-02-23 18:07:38 +00007702#ifdef DYNAMIC_GPM
7703 else if (STRICMP(name, "mouse_gpm") == 0)
7704 n = gpm_available();
7705#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007706 }
7707
Bram Moolenaar79296512020-03-22 16:17:14 +01007708 // features not in has_list[]
7709 if (x == FALSE)
7710 {
7711 if (STRNICMP(name, "patch", 5) == 0)
7712 {
7713 x = TRUE;
7714 if (name[5] == '-'
7715 && STRLEN(name) >= 11
K.Takatad90f91f2022-07-30 15:43:59 +01007716 && (name[6] >= '1' && name[6] <= '9'))
Bram Moolenaar79296512020-03-22 16:17:14 +01007717 {
K.Takatad90f91f2022-07-30 15:43:59 +01007718 char *end;
7719 int major, minor;
Bram Moolenaar79296512020-03-22 16:17:14 +01007720
K.Takatad90f91f2022-07-30 15:43:59 +01007721 // This works for patch-8.1.2, patch-9.0.3, patch-10.0.4, etc.
7722 // Not for patch-9.10.5.
7723 major = (int)strtoul((char *)name + 6, &end, 10);
7724 if (*end == '.' && vim_isdigit(end[1])
7725 && end[2] == '.' && vim_isdigit(end[3]))
7726 {
7727 minor = atoi(end + 1);
7728
7729 // Expect "patch-9.9.01234".
7730 n = (major < VIM_VERSION_MAJOR
7731 || (major == VIM_VERSION_MAJOR
7732 && (minor < VIM_VERSION_MINOR
7733 || (minor == VIM_VERSION_MINOR
7734 && has_patch(atoi(end + 3))))));
7735 }
Bram Moolenaar79296512020-03-22 16:17:14 +01007736 }
Keith Thompson184f71c2024-01-04 21:19:04 +01007737 else if (SAFE_isdigit(name[5]))
Bram Moolenaar79296512020-03-22 16:17:14 +01007738 n = has_patch(atoi((char *)name + 5));
7739 }
7740 else if (STRICMP(name, "vim_starting") == 0)
7741 {
7742 x = TRUE;
7743 n = (starting != 0);
7744 }
7745 else if (STRICMP(name, "ttyin") == 0)
7746 {
7747 x = TRUE;
7748 n = mch_input_isatty();
7749 }
7750 else if (STRICMP(name, "ttyout") == 0)
7751 {
7752 x = TRUE;
7753 n = stdout_isatty;
7754 }
7755 else if (STRICMP(name, "multi_byte_encoding") == 0)
7756 {
7757 x = TRUE;
7758 n = has_mbyte;
7759 }
7760 else if (STRICMP(name, "gui_running") == 0)
7761 {
7762 x = TRUE;
7763#ifdef FEAT_GUI
7764 n = (gui.in_use || gui.starting);
7765#endif
7766 }
7767 else if (STRICMP(name, "browse") == 0)
7768 {
7769 x = TRUE;
7770#if defined(FEAT_GUI) && defined(FEAT_BROWSE)
7771 n = gui.in_use; // gui_mch_browse() works when GUI is running
7772#endif
7773 }
7774 else if (STRICMP(name, "syntax_items") == 0)
7775 {
7776 x = TRUE;
7777#ifdef FEAT_SYN_HL
7778 n = syntax_present(curwin);
7779#endif
7780 }
7781 else if (STRICMP(name, "vcon") == 0)
7782 {
7783 x = TRUE;
7784#ifdef FEAT_VTP
7785 n = is_term_win32() && has_vtp_working();
7786#endif
7787 }
7788 else if (STRICMP(name, "netbeans_enabled") == 0)
7789 {
7790 x = TRUE;
7791#ifdef FEAT_NETBEANS_INTG
7792 n = netbeans_active();
7793#endif
7794 }
7795 else if (STRICMP(name, "mouse_gpm_enabled") == 0)
7796 {
7797 x = TRUE;
7798#ifdef FEAT_MOUSE_GPM
7799 n = gpm_enabled();
7800#endif
7801 }
7802 else if (STRICMP(name, "conpty") == 0)
7803 {
7804 x = TRUE;
7805#if defined(FEAT_TERMINAL) && defined(MSWIN)
7806 n = use_conpty();
7807#endif
7808 }
7809 else if (STRICMP(name, "clipboard_working") == 0)
7810 {
7811 x = TRUE;
7812#ifdef FEAT_CLIPBOARD
7813 n = clip_star.available;
7814#endif
7815 }
7816 }
7817
Bram Moolenaar04637e22020-09-05 18:45:29 +02007818 if (argvars[1].v_type != VAR_UNKNOWN && tv_get_bool(&argvars[1]))
Bram Moolenaar79296512020-03-22 16:17:14 +01007819 // return whether feature could ever be enabled
7820 rettv->vval.v_number = x;
7821 else
7822 // return whether feature is enabled
7823 rettv->vval.v_number = n;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007824}
7825
7826/*
Bram Moolenaar8cebd432020-11-08 12:49:47 +01007827 * Return TRUE if "feature" can change later.
7828 * Also when checking for the feature has side effects, such as loading a DLL.
7829 */
7830 int
7831dynamic_feature(char_u *feature)
7832{
7833 return (feature == NULL
Bram Moolenaar8cebd432020-11-08 12:49:47 +01007834#if defined(FEAT_GUI) && defined(FEAT_BROWSE)
7835 || (STRICMP(feature, "browse") == 0 && !gui.in_use)
7836#endif
7837#ifdef VIMDLL
7838 || STRICMP(feature, "filterpipe") == 0
7839#endif
Bram Moolenaar29b281b2020-11-10 20:58:00 +01007840#if defined(FEAT_GUI) && !defined(ALWAYS_USE_GUI) && !defined(VIMDLL)
Bram Moolenaar8cebd432020-11-08 12:49:47 +01007841 // this can only change on Unix where the ":gui" command could be
7842 // used.
7843 || (STRICMP(feature, "gui_running") == 0 && !gui.in_use)
7844#endif
7845#if defined(USE_ICONV) && defined(DYNAMIC_ICONV)
7846 || STRICMP(feature, "iconv") == 0
7847#endif
7848#ifdef DYNAMIC_LUA
7849 || STRICMP(feature, "lua") == 0
7850#endif
7851#ifdef FEAT_MOUSE_GPM
7852 || (STRICMP(feature, "mouse_gpm_enabled") == 0 && !gpm_enabled())
7853#endif
7854#ifdef DYNAMIC_MZSCHEME
7855 || STRICMP(feature, "mzscheme") == 0
7856#endif
7857#ifdef FEAT_NETBEANS_INTG
7858 || STRICMP(feature, "netbeans_enabled") == 0
7859#endif
7860#ifdef DYNAMIC_PERL
7861 || STRICMP(feature, "perl") == 0
7862#endif
7863#ifdef DYNAMIC_PYTHON
7864 || STRICMP(feature, "python") == 0
7865#endif
7866#ifdef DYNAMIC_PYTHON3
7867 || STRICMP(feature, "python3") == 0
7868#endif
7869#if defined(DYNAMIC_PYTHON) || defined(DYNAMIC_PYTHON3)
7870 || STRICMP(feature, "pythonx") == 0
7871#endif
7872#ifdef DYNAMIC_RUBY
7873 || STRICMP(feature, "ruby") == 0
7874#endif
7875#ifdef FEAT_SYN_HL
7876 || STRICMP(feature, "syntax_items") == 0
7877#endif
7878#ifdef DYNAMIC_TCL
7879 || STRICMP(feature, "tcl") == 0
7880#endif
7881 // once "starting" is zero it will stay that way
7882 || (STRICMP(feature, "vim_starting") == 0 && starting != 0)
7883 || STRICMP(feature, "multi_byte_encoding") == 0
7884#if defined(FEAT_TERMINAL) && defined(MSWIN)
7885 || STRICMP(feature, "conpty") == 0
7886#endif
7887 );
7888}
7889
7890/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007891 * "haslocaldir()" function
7892 */
7893 static void
7894f_haslocaldir(typval_T *argvars, typval_T *rettv)
7895{
Bram Moolenaar00aa0692019-04-27 20:37:57 +02007896 tabpage_T *tp = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007897 win_T *wp = NULL;
7898
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02007899 if (in_vim9script()
7900 && (check_for_opt_number_arg(argvars, 0) == FAIL
7901 || (argvars[0].v_type != VAR_UNKNOWN
7902 && check_for_opt_number_arg(argvars, 1) == FAIL)))
7903 return;
7904
Bram Moolenaar00aa0692019-04-27 20:37:57 +02007905 wp = find_tabwin(&argvars[0], &argvars[1], &tp);
7906
7907 // Check for window-local and tab-local directories
7908 if (wp != NULL && wp->w_localdir != NULL)
7909 rettv->vval.v_number = 1;
7910 else if (tp != NULL && tp->tp_localdir != NULL)
7911 rettv->vval.v_number = 2;
7912 else
7913 rettv->vval.v_number = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007914}
7915
7916/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007917 * "highlightID(name)" function
7918 */
7919 static void
7920f_hlID(typval_T *argvars, typval_T *rettv)
7921{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02007922 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
7923 return;
7924
Bram Moolenaard155d7a2018-12-21 16:04:21 +01007925 rettv->vval.v_number = syn_name2id(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007926}
7927
7928/*
7929 * "highlight_exists()" function
7930 */
7931 static void
7932f_hlexists(typval_T *argvars, typval_T *rettv)
7933{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02007934 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
7935 return;
7936
Bram Moolenaard155d7a2018-12-21 16:04:21 +01007937 rettv->vval.v_number = highlight_exists(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007938}
7939
7940/*
7941 * "hostname()" function
7942 */
7943 static void
7944f_hostname(typval_T *argvars UNUSED, typval_T *rettv)
7945{
7946 char_u hostname[256];
7947
7948 mch_get_host_name(hostname, 256);
7949 rettv->v_type = VAR_STRING;
7950 rettv->vval.v_string = vim_strsave(hostname);
7951}
7952
7953/*
Ernie Raelc8e158b2024-07-09 18:39:52 +02007954 * "id()" function
7955 * Identity. Return address of item as a hex string, %p format.
7956 * Currently only valid for object/container types.
7957 * Return empty string if not an object.
7958 */
Zoltan Arpadffy10231ac2024-08-18 16:59:20 +02007959#ifdef VMS // VMS does not have defined uintptr_t
7960# if defined(HAVE_NO_LONG_LONG)
7961typedef unsigned int uintptr_t;
7962# else
7963typedef unsigned long long uintptr_t;
7964# endif
7965#endif // VMS
7966
John Marriottb3b2bee2024-07-14 11:12:51 +02007967 static void
Ernie Raelc8e158b2024-07-09 18:39:52 +02007968f_id(typval_T *argvars, typval_T *rettv)
7969{
Ernie Rael05124252024-07-11 22:10:45 +02007970 char numbuf[NUMBUFLEN];
7971 char *p = numbuf;
Ernie Raelc8e158b2024-07-09 18:39:52 +02007972
7973 switch (argvars[0].v_type)
7974 {
7975 case VAR_LIST:
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01007976 case VAR_TUPLE:
Ernie Raelc8e158b2024-07-09 18:39:52 +02007977 case VAR_DICT:
7978 case VAR_OBJECT:
7979 case VAR_JOB:
7980 case VAR_CHANNEL:
7981 case VAR_BLOB:
7982 // Assume pointer value in typval_T vval union at common location.
7983 if (argvars[0].vval.v_object != NULL)
Ernie Rael05124252024-07-11 22:10:45 +02007984 {
7985 // "v" gets the address as an integer
7986 uintptr_t v = (uintptr_t)(void *)argvars[0].vval.v_object;
7987 // Build a hex string from the item's address; it is in
7988 // reverse order. Ignore trailing zeros.
7989 for (; p < numbuf + sizeof(uintptr_t) * 2 && v != 0;
7990 ++p, v >>= 4)
7991 *p = "0123456789abcdef"[v & 0xf];
7992 }
Ernie Raelc8e158b2024-07-09 18:39:52 +02007993 default:
Ernie Rael05124252024-07-11 22:10:45 +02007994 break;
Ernie Raelc8e158b2024-07-09 18:39:52 +02007995 }
Ernie Rael05124252024-07-11 22:10:45 +02007996 *p = NUL;
Ernie Raelc8e158b2024-07-09 18:39:52 +02007997
7998 rettv->v_type = VAR_STRING;
Ernie Rael05124252024-07-11 22:10:45 +02007999 rettv->vval.v_string = vim_strsave((char_u *)numbuf);
Ernie Raelc8e158b2024-07-09 18:39:52 +02008000}
8001
8002/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008003 * index() function for a blob
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008004 */
8005 static void
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008006index_func_blob(typval_T *argvars, typval_T *rettv)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008007{
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008008 typval_T tv;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008009 blob_T *b;
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008010 int start = 0;
8011 int error = FALSE;
8012 int ic = FALSE;
8013
8014 b = argvars[0].vval.v_blob;
8015 if (b == NULL)
8016 return;
8017
8018 if (argvars[2].v_type != VAR_UNKNOWN)
8019 {
8020 start = tv_get_number_chk(&argvars[2], &error);
8021 if (error)
8022 return;
8023 }
8024
8025 if (start < 0)
8026 {
8027 start = blob_len(b) + start;
8028 if (start < 0)
8029 start = 0;
8030 }
8031
8032 for (int idx = start; idx < blob_len(b); ++idx)
8033 {
8034 tv.v_type = VAR_NUMBER;
8035 tv.vval.v_number = blob_get(b, idx);
8036 if (tv_equal(&tv, &argvars[1], ic))
8037 {
8038 rettv->vval.v_number = idx;
8039 return;
8040 }
8041 }
8042}
8043
8044/*
8045 * index() function for a tuple
8046 */
8047 static void
8048index_func_tuple(typval_T *argvars, typval_T *rettv)
8049{
8050 tuple_T *tuple = argvars[0].vval.v_tuple;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008051 int ic = FALSE;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008052 int error = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008053
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008054 if (tuple == NULL)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008055 return;
8056
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008057 int start_idx = 0;
8058 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008059 {
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008060 start_idx = tv_get_number_chk(&argvars[2], &error);
8061 if (!error && argvars[3].v_type != VAR_UNKNOWN)
8062 ic = (int)tv_get_bool_chk(&argvars[3], &error);
8063 if (error)
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008064 return;
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008065 }
Bram Moolenaar05500ec2019-01-13 19:10:33 +01008066
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008067 rettv->vval.v_number = index_tuple(tuple, &argvars[1], start_idx, ic);
8068}
8069
8070/*
8071 * index() function for a list
8072 */
8073 static void
8074index_func_list(typval_T *argvars, typval_T *rettv)
8075{
8076 list_T *l;
8077 listitem_T *item;
8078 long idx = 0;
8079 int ic = FALSE;
8080 int error = FALSE;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008081
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008082 l = argvars[0].vval.v_list;
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00008083 if (l == NULL)
8084 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008085
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00008086 CHECK_LIST_MATERIALIZE(l);
8087 item = l->lv_first;
8088 if (argvars[2].v_type != VAR_UNKNOWN)
8089 {
8090 // Start at specified item. Use the cached index that list_find()
8091 // sets, so that a negative number also works.
8092 item = list_find(l, (long)tv_get_number_chk(&argvars[2], &error));
8093 idx = l->lv_u.mat.lv_idx;
8094 if (argvars[3].v_type != VAR_UNKNOWN)
8095 ic = (int)tv_get_bool_chk(&argvars[3], &error);
8096 if (error)
8097 item = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008098 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00008099
8100 for ( ; item != NULL; item = item->li_next, ++idx)
Yinzuo Jiang7ccd1a22024-07-04 17:20:53 +02008101 if (tv_equal(&item->li_tv, &argvars[1], ic))
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00008102 {
8103 rettv->vval.v_number = idx;
8104 break;
8105 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008106}
8107
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008108/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008109 * "index()" function
8110 */
8111 static void
8112f_index(typval_T *argvars, typval_T *rettv)
8113{
8114 rettv->vval.v_number = -1;
8115
8116 if (in_vim9script()
8117 && (check_for_list_or_tuple_or_blob_arg(argvars, 0) == FAIL
8118 || (argvars[0].v_type == VAR_BLOB
8119 && check_for_number_arg(argvars, 1) == FAIL)
8120 || check_for_opt_number_arg(argvars, 2) == FAIL
8121 || (argvars[2].v_type != VAR_UNKNOWN
8122 && check_for_opt_bool_arg(argvars, 3) == FAIL)))
8123 return;
8124
8125 if (argvars[0].v_type == VAR_BLOB)
8126 index_func_blob(argvars, rettv);
8127 else if (argvars[0].v_type == VAR_TUPLE)
8128 index_func_tuple(argvars, rettv);
8129 else if (argvars[0].v_type == VAR_LIST)
8130 index_func_list(argvars, rettv);
8131 else
8132 emsg(_(e_list_or_blob_required));
8133}
8134
8135/*
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008136 * Evaluate 'expr' with the v:key and v:val arguments and return the result.
8137 * The expression is expected to return a boolean value. The caller should set
8138 * the VV_KEY and VV_VAL vim variables before calling this function.
8139 */
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008140 int
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008141indexof_eval_expr(typval_T *expr)
8142{
8143 typval_T argv[3];
8144 typval_T newtv;
8145 varnumber_T found;
8146 int error = FALSE;
8147
8148 argv[0] = *get_vim_var_tv(VV_KEY);
8149 argv[1] = *get_vim_var_tv(VV_VAL);
8150 newtv.v_type = VAR_UNKNOWN;
8151
zeertzjqad0c4422023-08-17 22:15:47 +02008152 if (eval_expr_typval(expr, FALSE, argv, 2, NULL, &newtv) == FAIL)
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008153 return FALSE;
8154
8155 found = tv_get_bool_chk(&newtv, &error);
Yegappan Lakshmanan63acae12022-08-14 12:07:11 +01008156 clear_tv(&newtv);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008157
8158 return error ? FALSE : found;
8159}
8160
8161/*
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008162 * Evaluate 'expr' for each byte in the Blob 'b' starting with the byte at
8163 * 'startidx' and return the index of the byte where 'expr' is TRUE. Returns
8164 * -1 if 'expr' doesn't evaluate to TRUE for any of the bytes.
8165 */
8166 static int
8167indexof_blob(blob_T *b, long startidx, typval_T *expr)
8168{
8169 long idx = 0;
8170
8171 if (b == NULL)
8172 return -1;
8173
8174 if (startidx < 0)
8175 {
8176 // negative index: index from the last byte
8177 startidx = blob_len(b) + startidx;
8178 if (startidx < 0)
8179 startidx = 0;
8180 }
8181
8182 set_vim_var_type(VV_KEY, VAR_NUMBER);
8183 set_vim_var_type(VV_VAL, VAR_NUMBER);
8184
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008185 int called_emsg_start = called_emsg;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008186 for (idx = startidx; idx < blob_len(b); ++idx)
8187 {
8188 set_vim_var_nr(VV_KEY, idx);
8189 set_vim_var_nr(VV_VAL, blob_get(b, idx));
8190
8191 if (indexof_eval_expr(expr))
8192 return idx;
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008193
8194 if (called_emsg != called_emsg_start)
8195 return -1;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008196 }
8197
8198 return -1;
8199}
8200
8201/*
8202 * Evaluate 'expr' for each item in the List 'l' starting with the item at
8203 * 'startidx' and return the index of the item where 'expr' is TRUE. Returns
8204 * -1 if 'expr' doesn't evaluate to TRUE for any of the items.
8205 */
8206 static int
8207indexof_list(list_T *l, long startidx, typval_T *expr)
8208{
8209 listitem_T *item;
8210 long idx = 0;
Yegappan Lakshmanan63acae12022-08-14 12:07:11 +01008211 int found;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008212
8213 if (l == NULL)
8214 return -1;
8215
8216 CHECK_LIST_MATERIALIZE(l);
8217
8218 if (startidx == 0)
8219 item = l->lv_first;
8220 else
8221 {
8222 // Start at specified item. Use the cached index that list_find()
8223 // sets, so that a negative number also works.
8224 item = list_find(l, startidx);
8225 if (item != NULL)
8226 idx = l->lv_u.mat.lv_idx;
8227 }
8228
8229 set_vim_var_type(VV_KEY, VAR_NUMBER);
8230
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008231 int called_emsg_start = called_emsg;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008232 for ( ; item != NULL; item = item->li_next, ++idx)
8233 {
8234 set_vim_var_nr(VV_KEY, idx);
8235 copy_tv(&item->li_tv, get_vim_var_tv(VV_VAL));
8236
Yegappan Lakshmanan63acae12022-08-14 12:07:11 +01008237 found = indexof_eval_expr(expr);
8238 clear_tv(get_vim_var_tv(VV_VAL));
8239
8240 if (found)
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008241 return idx;
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008242
8243 if (called_emsg != called_emsg_start)
8244 return -1;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008245 }
8246
8247 return -1;
8248}
8249
8250/*
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008251 * "indexof()" function
8252 */
8253 static void
8254f_indexof(typval_T *argvars, typval_T *rettv)
8255{
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008256 long startidx = 0;
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008257 typval_T save_val;
8258 typval_T save_key;
8259 int save_did_emsg;
8260
8261 rettv->vval.v_number = -1;
8262
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008263 if (check_for_list_or_tuple_or_blob_arg(argvars, 0) == FAIL
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008264 || check_for_string_or_func_arg(argvars, 1) == FAIL
8265 || check_for_opt_dict_arg(argvars, 2) == FAIL)
8266 return;
8267
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008268 if ((argvars[1].v_type == VAR_STRING &&
8269 (argvars[1].vval.v_string == NULL
8270 || *argvars[1].vval.v_string == NUL))
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008271 || (argvars[1].v_type == VAR_FUNC
8272 && argvars[1].vval.v_partial == NULL))
8273 return;
8274
8275 if (argvars[2].v_type == VAR_DICT)
8276 startidx = dict_get_number_def(argvars[2].vval.v_dict, "startidx", 0);
8277
8278 prepare_vimvar(VV_VAL, &save_val);
8279 prepare_vimvar(VV_KEY, &save_key);
8280
8281 // We reset "did_emsg" to be able to detect whether an error occurred
8282 // during evaluation of the expression.
8283 save_did_emsg = did_emsg;
8284 did_emsg = FALSE;
8285
8286 if (argvars[0].v_type == VAR_BLOB)
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008287 rettv->vval.v_number = indexof_blob(argvars[0].vval.v_blob, startidx,
8288 &argvars[1]);
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008289 else if (argvars[0].v_type == VAR_TUPLE)
8290 rettv->vval.v_number = indexof_tuple(argvars[0].vval.v_tuple, startidx,
8291 &argvars[1]);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008292 else
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008293 rettv->vval.v_number = indexof_list(argvars[0].vval.v_list, startidx,
8294 &argvars[1]);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008295
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008296 restore_vimvar(VV_KEY, &save_key);
8297 restore_vimvar(VV_VAL, &save_val);
8298 did_emsg |= save_did_emsg;
8299}
8300
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008301static int inputsecret_flag = 0;
8302
8303/*
8304 * "input()" function
8305 * Also handles inputsecret() when inputsecret is set.
8306 */
8307 static void
8308f_input(typval_T *argvars, typval_T *rettv)
8309{
8310 get_user_input(argvars, rettv, FALSE, inputsecret_flag);
8311}
8312
8313/*
8314 * "inputdialog()" function
8315 */
8316 static void
8317f_inputdialog(typval_T *argvars, typval_T *rettv)
8318{
8319#if defined(FEAT_GUI_TEXTDIALOG)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008320 // Use a GUI dialog if the GUI is running and 'c' is not in 'guioptions'
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008321 if (gui.in_use && vim_strchr(p_go, GO_CONDIALOG) == NULL)
8322 {
8323 char_u *message;
8324 char_u buf[NUMBUFLEN];
8325 char_u *defstr = (char_u *)"";
8326
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008327 if (in_vim9script()
8328 && (check_for_string_arg(argvars, 0) == FAIL
8329 || check_for_opt_string_arg(argvars, 1) == FAIL
8330 || (argvars[1].v_type != VAR_UNKNOWN
8331 && check_for_opt_string_arg(argvars, 2) == FAIL)))
8332 return;
8333
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008334 message = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008335 if (argvars[1].v_type != VAR_UNKNOWN
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008336 && (defstr = tv_get_string_buf_chk(&argvars[1], buf)) != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008337 vim_strncpy(IObuff, defstr, IOSIZE - 1);
8338 else
8339 IObuff[0] = NUL;
8340 if (message != NULL && defstr != NULL
8341 && do_dialog(VIM_QUESTION, NULL, message,
8342 (char_u *)_("&OK\n&Cancel"), 1, IObuff, FALSE) == 1)
8343 rettv->vval.v_string = vim_strsave(IObuff);
8344 else
8345 {
8346 if (message != NULL && defstr != NULL
8347 && argvars[1].v_type != VAR_UNKNOWN
8348 && argvars[2].v_type != VAR_UNKNOWN)
8349 rettv->vval.v_string = vim_strsave(
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008350 tv_get_string_buf(&argvars[2], buf));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008351 else
8352 rettv->vval.v_string = NULL;
8353 }
8354 rettv->v_type = VAR_STRING;
8355 }
8356 else
8357#endif
8358 get_user_input(argvars, rettv, TRUE, inputsecret_flag);
8359}
8360
8361/*
8362 * "inputlist()" function
8363 */
8364 static void
8365f_inputlist(typval_T *argvars, typval_T *rettv)
8366{
Bram Moolenaar50985eb2020-01-27 22:09:39 +01008367 list_T *l;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008368 listitem_T *li;
8369 int selected;
8370 int mouse_used;
8371
8372#ifdef NO_CONSOLE_INPUT
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008373 // While starting up, there is no place to enter text. When running tests
8374 // with --not-a-term we assume feedkeys() will be used.
Bram Moolenaar91d348a2017-07-29 20:16:03 +02008375 if (no_console_input() && !is_not_a_term())
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008376 return;
8377#endif
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008378 if (in_vim9script() && check_for_list_arg(argvars, 0) == FAIL)
8379 return;
8380
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008381 if (argvars[0].v_type != VAR_LIST || argvars[0].vval.v_list == NULL)
8382 {
Bram Moolenaar3a846e62022-01-01 16:21:00 +00008383 semsg(_(e_argument_of_str_must_be_list), "inputlist()");
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008384 return;
8385 }
8386
8387 msg_start();
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008388 msg_row = Rows - 1; // for when 'cmdheight' > 1
8389 lines_left = Rows; // avoid more prompt
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008390 msg_scroll = TRUE;
8391 msg_clr_eos();
8392
Bram Moolenaar50985eb2020-01-27 22:09:39 +01008393 l = argvars[0].vval.v_list;
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02008394 CHECK_LIST_MATERIALIZE(l);
Bram Moolenaar00d253e2020-04-06 22:13:01 +02008395 FOR_ALL_LIST_ITEMS(l, li)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008396 {
Bram Moolenaar32526b32019-01-19 17:43:09 +01008397 msg_puts((char *)tv_get_string(&li->li_tv));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008398 msg_putchar('\n');
8399 }
8400
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008401 // Ask for choice.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008402 selected = prompt_for_number(&mouse_used);
8403 if (mouse_used)
8404 selected -= lines_left;
8405
8406 rettv->vval.v_number = selected;
8407}
8408
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008409static garray_T ga_userinput = {0, 0, sizeof(tasave_T), 4, NULL};
8410
8411/*
8412 * "inputrestore()" function
8413 */
8414 static void
8415f_inputrestore(typval_T *argvars UNUSED, typval_T *rettv)
8416{
8417 if (ga_userinput.ga_len > 0)
8418 {
8419 --ga_userinput.ga_len;
8420 restore_typeahead((tasave_T *)(ga_userinput.ga_data)
Bram Moolenaarc41badb2021-06-07 22:04:52 +02008421 + ga_userinput.ga_len, TRUE);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008422 // default return is zero == OK
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008423 }
8424 else if (p_verbose > 1)
8425 {
Bram Moolenaar32526b32019-01-19 17:43:09 +01008426 verb_msg(_("called inputrestore() more often than inputsave()"));
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008427 rettv->vval.v_number = 1; // Failed
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008428 }
8429}
8430
8431/*
8432 * "inputsave()" function
8433 */
8434 static void
8435f_inputsave(typval_T *argvars UNUSED, typval_T *rettv)
8436{
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008437 // Add an entry to the stack of typeahead storage.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008438 if (ga_grow(&ga_userinput, 1) == OK)
8439 {
8440 save_typeahead((tasave_T *)(ga_userinput.ga_data)
8441 + ga_userinput.ga_len);
8442 ++ga_userinput.ga_len;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008443 // default return is zero == OK
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008444 }
8445 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008446 rettv->vval.v_number = 1; // Failed
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008447}
8448
8449/*
8450 * "inputsecret()" function
8451 */
8452 static void
8453f_inputsecret(typval_T *argvars, typval_T *rettv)
8454{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008455 if (in_vim9script()
8456 && (check_for_string_arg(argvars, 0) == FAIL
8457 || check_for_opt_string_arg(argvars, 1) == FAIL))
8458 return;
8459
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008460 ++cmdline_star;
8461 ++inputsecret_flag;
8462 f_input(argvars, rettv);
8463 --cmdline_star;
8464 --inputsecret_flag;
8465}
8466
8467/*
Bram Moolenaar67a2deb2019-11-25 00:05:32 +01008468 * "interrupt()" function
8469 */
8470 static void
8471f_interrupt(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
8472{
8473 got_int = TRUE;
8474}
8475
8476/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008477 * "invert(expr)" function
8478 */
8479 static void
8480f_invert(typval_T *argvars, typval_T *rettv)
8481{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008482 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
8483 return;
8484
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008485 rettv->vval.v_number = ~tv_get_number_chk(&argvars[0], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008486}
8487
8488/*
Ernie Rael4c8da022023-10-11 21:35:11 +02008489 * Free resources in lval_root allocated by fill_exec_lval_root().
8490 */
8491 static void
8492free_lval_root(lval_root_T *root)
8493{
8494 if (root->lr_tv != NULL)
8495 free_tv(root->lr_tv);
8496 class_unref(root->lr_cl_exec);
8497 root->lr_tv = NULL;
8498 root->lr_cl_exec = NULL;
8499}
8500
8501/*
8502 * This is used if executing in a method, the argument string is a
Ernie Rael0f058d12023-10-14 11:25:04 +02008503 * variable/item expr/reference. It may start with a potential class/object
8504 * variable.
Ernie Rael4c8da022023-10-11 21:35:11 +02008505 *
Ernie Rael0f058d12023-10-14 11:25:04 +02008506 * Adjust "root" as needed; lr_tv may be changed or freed.
Ernie Rael4c8da022023-10-11 21:35:11 +02008507 *
8508 * Always returns OK.
8509 * Free resources and return FAIL if the root should not be used. Otherwise OK.
8510 */
8511
8512 static int
Ernie Rael0f058d12023-10-14 11:25:04 +02008513fix_variable_reference_lval_root(lval_root_T *root, char_u *name)
Ernie Rael4c8da022023-10-11 21:35:11 +02008514{
Ernie Rael4c8da022023-10-11 21:35:11 +02008515
Ernie Rael0f058d12023-10-14 11:25:04 +02008516 // Check if lr_tv is the name of an object/class reference: name start with
8517 // "this" or name is class variable. Clear lr_tv if neither.
8518 int found_member = FALSE;
Ernie Rael4c8da022023-10-11 21:35:11 +02008519 if (root->lr_tv->v_type == VAR_OBJECT)
8520 {
Ernie Rael0f058d12023-10-14 11:25:04 +02008521 if (STRNCMP("this.", name, 5) == 0 ||STRCMP("this", name) == 0)
8522 found_member = TRUE;
Ernie Rael4c8da022023-10-11 21:35:11 +02008523 }
Ernie Rael0f058d12023-10-14 11:25:04 +02008524 if (!found_member) // not object member, try class member
Ernie Rael4c8da022023-10-11 21:35:11 +02008525 {
8526 // Explicitly check if the name is a class member.
8527 // If it's not then do nothing.
Ernie Rael0f058d12023-10-14 11:25:04 +02008528 char_u *end;
Ernie Rael4c8da022023-10-11 21:35:11 +02008529 for (end = name; ASCII_ISALNUM(*end) || *end == '_'; ++end)
8530 ;
Ernie Rael0f058d12023-10-14 11:25:04 +02008531 int idx = class_member_idx(root->lr_cl_exec, name, end - name);
8532 if (idx >= 0)
Ernie Rael4c8da022023-10-11 21:35:11 +02008533 {
Ernie Rael0f058d12023-10-14 11:25:04 +02008534 // A class variable, replace lr_tv with it
8535 clear_tv(root->lr_tv);
8536 copy_tv(&root->lr_cl_exec->class_members_tv[idx], root->lr_tv);
8537 found_member = TRUE;
Ernie Rael4c8da022023-10-11 21:35:11 +02008538 }
8539 }
Ernie Rael0f058d12023-10-14 11:25:04 +02008540 if (!found_member)
Ernie Rael4c8da022023-10-11 21:35:11 +02008541 {
8542 free_tv(root->lr_tv);
8543 root->lr_tv = NULL; // Not a member variable
8544 }
Ernie Rael4c8da022023-10-11 21:35:11 +02008545 // If FAIL, then must free_lval_root(root);
8546 return OK;
8547}
8548
8549/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008550 * "islocked()" function
8551 */
8552 static void
8553f_islocked(typval_T *argvars, typval_T *rettv)
8554{
8555 lval_T lv;
8556 char_u *end;
8557 dictitem_T *di;
8558
8559 rettv->vval.v_number = -1;
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02008560
8561 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
8562 return;
8563
Ernie Rael4c8da022023-10-11 21:35:11 +02008564 char_u *name = tv_get_string(&argvars[0]);
8565#ifdef LOG_LOCKVAR
8566 ch_log(NULL, "LKVAR: f_islocked(): name: %s", name);
8567#endif
8568
8569 lval_root_T aroot; // fully initialized in fill_exec_lval_root
8570 lval_root_T *root = NULL;
8571
8572 // Set up lval_root if executing in a method.
8573 if (fill_exec_lval_root(&aroot) == OK)
8574 {
8575 // Almost always produces a valid lval_root since lr_cl_exec is used
8576 // for access verification, lr_tv may be set to NULL.
Ernie Rael0f058d12023-10-14 11:25:04 +02008577 if (fix_variable_reference_lval_root(&aroot, name) == OK)
Ernie Rael4c8da022023-10-11 21:35:11 +02008578 root = &aroot;
Ernie Rael4c8da022023-10-11 21:35:11 +02008579 }
8580
8581 lval_root_T *lval_root_save = lval_root;
8582 lval_root = root;
8583 end = get_lval(name, NULL, &lv, FALSE, FALSE,
Bram Moolenaarbd77aa92021-08-12 17:06:05 +02008584 GLV_NO_AUTOLOAD | GLV_READ_ONLY | GLV_NO_DECL,
8585 FNE_CHECK_START);
Ernie Rael4c8da022023-10-11 21:35:11 +02008586 lval_root = lval_root_save;
8587
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008588 if (end != NULL && lv.ll_name != NULL)
8589 {
8590 if (*end != NUL)
Bram Moolenaar1840a7b2021-07-13 20:32:29 +02008591 {
8592 semsg(_(lv.ll_name == lv.ll_name_end
Bram Moolenaar0bd663a2022-01-22 10:24:47 +00008593 ? e_invalid_argument_str : e_trailing_characters_str), end);
Bram Moolenaar1840a7b2021-07-13 20:32:29 +02008594 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008595 else
8596 {
8597 if (lv.ll_tv == NULL)
8598 {
Bram Moolenaar79518e22017-02-17 16:31:35 +01008599 di = find_var(lv.ll_name, NULL, TRUE);
8600 if (di != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008601 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008602 // Consider a variable locked when:
8603 // 1. the variable itself is locked
8604 // 2. the value of the variable is locked.
8605 // 3. the List or Dict value is locked.
Bram Moolenaar79518e22017-02-17 16:31:35 +01008606 rettv->vval.v_number = ((di->di_flags & DI_FLAGS_LOCK)
8607 || tv_islocked(&di->di_tv));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008608 }
8609 }
Ernie Rael4c8da022023-10-11 21:35:11 +02008610 else if (lv.ll_is_root)
8611 {
8612 rettv->vval.v_number = tv_islocked(lv.ll_tv);
8613 }
Ernie Rael9771b2a2023-10-07 22:05:40 +02008614 else if (lv.ll_object != NULL)
8615 {
8616 typval_T *tv = ((typval_T *)(lv.ll_object + 1)) + lv.ll_oi;
8617 rettv->vval.v_number = tv_islocked(tv);
8618#ifdef LOG_LOCKVAR
8619 ch_log(NULL, "LKVAR: f_islocked(): name %s (obj)", lv.ll_name);
8620#endif
8621 }
8622 else if (lv.ll_class != NULL)
8623 {
8624 typval_T *tv = &lv.ll_class->class_members_tv[lv.ll_oi];
8625 rettv->vval.v_number = tv_islocked(tv);
8626#ifdef LOG_LOCKVAR
8627 ch_log(NULL, "LKVAR: f_islocked(): name %s (cl)", lv.ll_name);
8628#endif
8629 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008630 else if (lv.ll_range)
Bram Moolenaar677658a2022-01-05 16:09:06 +00008631 emsg(_(e_range_not_allowed));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008632 else if (lv.ll_newkey != NULL)
Bram Moolenaara9fa8c52023-01-02 18:10:04 +00008633 semsg(_(e_key_not_present_in_dictionary_str), lv.ll_newkey);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008634 else if (lv.ll_list != NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008635 // List item.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008636 rettv->vval.v_number = tv_islocked(&lv.ll_li->li_tv);
Yegappan Lakshmanan038be272025-03-26 18:46:21 +01008637 else if (lv.ll_tuple != NULL)
8638 // Tuple item.
8639 rettv->vval.v_number = tv_islocked(lv.ll_tv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008640 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008641 // Dictionary item.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008642 rettv->vval.v_number = tv_islocked(&lv.ll_di->di_tv);
8643 }
8644 }
8645
Ernie Rael4c8da022023-10-11 21:35:11 +02008646 if (root != NULL)
8647 free_lval_root(root);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008648 clear_lval(&lv);
8649}
8650
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008651/*
zeertzjqcdc83932022-09-12 13:38:41 +01008652 * "keytrans()" function
8653 */
8654 static void
8655f_keytrans(typval_T *argvars, typval_T *rettv)
8656{
8657 char_u *escaped;
8658
8659 rettv->v_type = VAR_STRING;
8660 if (check_for_string_arg(argvars, 0) == FAIL
8661 || argvars[0].vval.v_string == NULL)
8662 return;
8663 // Need to escape K_SPECIAL and CSI for mb_unescape().
8664 escaped = vim_strsave_escape_csi(argvars[0].vval.v_string);
8665 rettv->vval.v_string = str2special_save(escaped, TRUE, TRUE);
8666 vim_free(escaped);
8667}
8668
8669/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008670 * "last_buffer_nr()" function.
8671 */
8672 static void
8673f_last_buffer_nr(typval_T *argvars UNUSED, typval_T *rettv)
8674{
8675 int n = 0;
8676 buf_T *buf;
8677
Bram Moolenaar29323592016-07-24 22:04:11 +02008678 FOR_ALL_BUFFERS(buf)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008679 if (n < buf->b_fnum)
8680 n = buf->b_fnum;
8681
8682 rettv->vval.v_number = n;
8683}
8684
8685/*
8686 * "len()" function
8687 */
LemonBoy58f331a2022-04-02 21:59:06 +01008688 void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008689f_len(typval_T *argvars, typval_T *rettv)
8690{
8691 switch (argvars[0].v_type)
8692 {
8693 case VAR_STRING:
8694 case VAR_NUMBER:
8695 rettv->vval.v_number = (varnumber_T)STRLEN(
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008696 tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008697 break;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008698 case VAR_BLOB:
8699 rettv->vval.v_number = blob_len(argvars[0].vval.v_blob);
8700 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008701 case VAR_LIST:
8702 rettv->vval.v_number = list_len(argvars[0].vval.v_list);
8703 break;
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008704 case VAR_TUPLE:
8705 rettv->vval.v_number = tuple_len(argvars[0].vval.v_tuple);
8706 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008707 case VAR_DICT:
8708 rettv->vval.v_number = dict_len(argvars[0].vval.v_dict);
8709 break;
Yegappan Lakshmanand3eae7b2024-03-03 16:26:58 +01008710 case VAR_OBJECT:
8711 rettv->vval.v_number = object_len(argvars[0].vval.v_object);
8712 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008713 case VAR_UNKNOWN:
Bram Moolenaar4c683752020-04-05 21:38:23 +02008714 case VAR_ANY:
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01008715 case VAR_VOID:
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01008716 case VAR_BOOL:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008717 case VAR_SPECIAL:
8718 case VAR_FLOAT:
8719 case VAR_FUNC:
8720 case VAR_PARTIAL:
8721 case VAR_JOB:
8722 case VAR_CHANNEL:
Bram Moolenaarf18332f2021-05-07 17:55:55 +02008723 case VAR_INSTR:
Bram Moolenaar00b28d62022-12-08 15:32:33 +00008724 case VAR_CLASS:
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +02008725 case VAR_TYPEALIAS:
Bram Moolenaara6f79292022-01-04 21:30:47 +00008726 emsg(_(e_invalid_type_for_len));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008727 break;
8728 }
8729}
8730
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008731 static void
Bram Moolenaar6d721c72017-01-17 16:56:28 +01008732libcall_common(typval_T *argvars UNUSED, typval_T *rettv, int type)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008733{
8734#ifdef FEAT_LIBCALL
8735 char_u *string_in;
8736 char_u **string_result;
8737 int nr_result;
8738#endif
8739
8740 rettv->v_type = type;
8741 if (type != VAR_NUMBER)
8742 rettv->vval.v_string = NULL;
8743
8744 if (check_restricted() || check_secure())
8745 return;
8746
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02008747 if (in_vim9script()
8748 && (check_for_string_arg(argvars, 0) == FAIL
8749 || check_for_string_arg(argvars, 1) == FAIL
8750 || check_for_string_or_number_arg(argvars, 2) == FAIL))
8751 return;
8752
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008753#ifdef FEAT_LIBCALL
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008754 // The first two args must be strings, otherwise it's meaningless
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008755 if (argvars[0].v_type == VAR_STRING && argvars[1].v_type == VAR_STRING)
8756 {
8757 string_in = NULL;
8758 if (argvars[2].v_type == VAR_STRING)
8759 string_in = argvars[2].vval.v_string;
8760 if (type == VAR_NUMBER)
Bram Moolenaar87e15872021-09-02 19:53:07 +02008761 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008762 string_result = NULL;
Bram Moolenaar87e15872021-09-02 19:53:07 +02008763 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008764 else
Bram Moolenaar87e15872021-09-02 19:53:07 +02008765 {
8766 rettv->vval.v_string = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008767 string_result = &rettv->vval.v_string;
Bram Moolenaar87e15872021-09-02 19:53:07 +02008768 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008769 if (mch_libcall(argvars[0].vval.v_string,
8770 argvars[1].vval.v_string,
8771 string_in,
8772 argvars[2].vval.v_number,
8773 string_result,
8774 &nr_result) == OK
8775 && type == VAR_NUMBER)
8776 rettv->vval.v_number = nr_result;
8777 }
8778#endif
8779}
8780
8781/*
8782 * "libcall()" function
8783 */
8784 static void
8785f_libcall(typval_T *argvars, typval_T *rettv)
8786{
8787 libcall_common(argvars, rettv, VAR_STRING);
8788}
8789
8790/*
8791 * "libcallnr()" function
8792 */
8793 static void
8794f_libcallnr(typval_T *argvars, typval_T *rettv)
8795{
8796 libcall_common(argvars, rettv, VAR_NUMBER);
8797}
8798
8799/*
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008800 * "line(string, [winid])" function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008801 */
8802 static void
8803f_line(typval_T *argvars, typval_T *rettv)
8804{
8805 linenr_T lnum = 0;
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008806 pos_T *fp = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008807 int fnum;
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008808 int id;
8809 tabpage_T *tp;
8810 win_T *wp;
Bram Moolenaar18f47402022-01-06 13:24:51 +00008811 switchwin_T switchwin;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008812
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02008813 if (in_vim9script()
8814 && (check_for_string_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008815 || check_for_opt_number_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02008816 return;
8817
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008818 if (argvars[1].v_type != VAR_UNKNOWN)
8819 {
8820 // use window specified in the second argument
8821 id = (int)tv_get_number(&argvars[1]);
8822 wp = win_id2wp_tp(id, &tp);
8823 if (wp != NULL && tp != NULL)
8824 {
Bram Moolenaar18f47402022-01-06 13:24:51 +00008825 if (switch_win_noblock(&switchwin, wp, tp, TRUE) == OK)
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008826 {
John Marriott69f85c62024-10-31 10:53:43 +01008827#ifdef FEAT_DIFF
Christian Brabandt05a40e02024-10-29 20:29:04 +01008828 // in diff mode, prevent that the window scrolls
8829 // and keep the topline
8830 if (curwin->w_p_diff && switchwin.sw_curwin->w_p_diff)
8831 skip_update_topline = TRUE;
John Marriott69f85c62024-10-31 10:53:43 +01008832#endif
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008833 check_cursor();
Bram Moolenaar6f02b002021-01-10 20:22:54 +01008834 fp = var2fpos(&argvars[0], TRUE, &fnum, FALSE);
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008835 }
John Marriott69f85c62024-10-31 10:53:43 +01008836#ifdef FEAT_DIFF
Christian Brabandt05a40e02024-10-29 20:29:04 +01008837 if (curwin->w_p_diff && switchwin.sw_curwin->w_p_diff)
8838 skip_update_topline = FALSE;
John Marriott69f85c62024-10-31 10:53:43 +01008839#endif
Bram Moolenaar18f47402022-01-06 13:24:51 +00008840 restore_win_noblock(&switchwin, TRUE);
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008841 }
8842 }
8843 else
8844 // use current window
Bram Moolenaar6f02b002021-01-10 20:22:54 +01008845 fp = var2fpos(&argvars[0], TRUE, &fnum, FALSE);
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008846
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008847 if (fp != NULL)
8848 lnum = fp->lnum;
8849 rettv->vval.v_number = lnum;
8850}
8851
8852/*
8853 * "line2byte(lnum)" function
8854 */
8855 static void
8856f_line2byte(typval_T *argvars UNUSED, typval_T *rettv)
8857{
8858#ifndef FEAT_BYTEOFF
8859 rettv->vval.v_number = -1;
8860#else
8861 linenr_T lnum;
8862
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008863 if (in_vim9script() && check_for_lnum_arg(argvars, 0) == FAIL)
8864 return;
8865
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008866 lnum = tv_get_lnum(argvars);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008867 if (lnum < 1 || lnum > curbuf->b_ml.ml_line_count + 1)
8868 rettv->vval.v_number = -1;
8869 else
8870 rettv->vval.v_number = ml_find_line_or_offset(curbuf, lnum, NULL);
8871 if (rettv->vval.v_number >= 0)
8872 ++rettv->vval.v_number;
8873#endif
8874}
8875
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008876#ifdef FEAT_LUA
8877/*
8878 * "luaeval()" function
8879 */
8880 static void
8881f_luaeval(typval_T *argvars, typval_T *rettv)
8882{
8883 char_u *str;
8884 char_u buf[NUMBUFLEN];
8885
Bram Moolenaar8c62a082019-02-08 14:34:10 +01008886 if (check_restricted() || check_secure())
8887 return;
8888
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02008889 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
8890 return;
8891
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008892 str = tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008893 do_luaeval(str, argvars + 1, rettv);
8894}
8895#endif
8896
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008897typedef enum
8898{
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008899 MATCH_END, // matchend()
8900 MATCH_MATCH, // match()
8901 MATCH_STR, // matchstr()
8902 MATCH_LIST, // matchlist()
8903 MATCH_POS // matchstrpos()
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008904} matchtype_T;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008905
8906 static void
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008907find_some_match(typval_T *argvars, typval_T *rettv, matchtype_T type)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008908{
8909 char_u *str = NULL;
8910 long len = 0;
8911 char_u *expr = NULL;
8912 char_u *pat;
8913 regmatch_T regmatch;
8914 char_u patbuf[NUMBUFLEN];
8915 char_u strbuf[NUMBUFLEN];
8916 char_u *save_cpo;
8917 long start = 0;
8918 long nth = 1;
8919 colnr_T startcol = 0;
8920 int match = 0;
8921 list_T *l = NULL;
8922 listitem_T *li = NULL;
8923 long idx = 0;
8924 char_u *tofree = NULL;
8925
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008926 // Make 'cpoptions' empty, the 'l' flag should not be used here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008927 save_cpo = p_cpo;
Bram Moolenaare5a2dc82021-01-03 19:52:05 +01008928 p_cpo = empty_option;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008929
8930 rettv->vval.v_number = -1;
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008931 if (type == MATCH_LIST || type == MATCH_POS)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008932 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008933 // type MATCH_LIST: return empty list when there are no matches.
8934 // type MATCH_POS: return ["", -1, -1, -1]
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008935 if (rettv_list_alloc(rettv) == FAIL)
8936 goto theend;
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008937 if (type == MATCH_POS
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008938 && (list_append_string(rettv->vval.v_list,
8939 (char_u *)"", 0) == FAIL
8940 || list_append_number(rettv->vval.v_list,
8941 (varnumber_T)-1) == FAIL
8942 || list_append_number(rettv->vval.v_list,
8943 (varnumber_T)-1) == FAIL
8944 || list_append_number(rettv->vval.v_list,
8945 (varnumber_T)-1) == FAIL))
8946 {
8947 list_free(rettv->vval.v_list);
8948 rettv->vval.v_list = NULL;
8949 goto theend;
8950 }
8951 }
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008952 else if (type == MATCH_STR)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008953 {
8954 rettv->v_type = VAR_STRING;
8955 rettv->vval.v_string = NULL;
8956 }
8957
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02008958 if (in_vim9script()
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008959 && (check_for_string_or_list_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008960 || check_for_string_arg(argvars, 1) == FAIL
8961 || check_for_opt_number_arg(argvars, 2) == FAIL
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02008962 || (argvars[2].v_type != VAR_UNKNOWN
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008963 && check_for_opt_number_arg(argvars, 3) == FAIL)))
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02008964 goto theend;
8965
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008966 if (argvars[0].v_type == VAR_LIST)
8967 {
8968 if ((l = argvars[0].vval.v_list) == NULL)
8969 goto theend;
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02008970 CHECK_LIST_MATERIALIZE(l);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008971 li = l->lv_first;
8972 }
8973 else
8974 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008975 expr = str = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008976 len = (long)STRLEN(str);
8977 }
8978
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008979 pat = tv_get_string_buf_chk(&argvars[1], patbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008980 if (pat == NULL)
8981 goto theend;
8982
8983 if (argvars[2].v_type != VAR_UNKNOWN)
8984 {
8985 int error = FALSE;
8986
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008987 start = (long)tv_get_number_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008988 if (error)
8989 goto theend;
8990 if (l != NULL)
8991 {
8992 li = list_find(l, start);
8993 if (li == NULL)
8994 goto theend;
Bram Moolenaar0ff6aad2020-01-29 21:27:21 +01008995 idx = l->lv_u.mat.lv_idx; // use the cached index
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008996 }
8997 else
8998 {
8999 if (start < 0)
9000 start = 0;
9001 if (start > len)
9002 goto theend;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009003 // When "count" argument is there ignore matches before "start",
9004 // otherwise skip part of the string. Differs when pattern is "^"
9005 // or "\<".
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009006 if (argvars[3].v_type != VAR_UNKNOWN)
9007 startcol = start;
9008 else
9009 {
9010 str += start;
9011 len -= start;
9012 }
9013 }
9014
9015 if (argvars[3].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009016 nth = (long)tv_get_number_chk(&argvars[3], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009017 if (error)
9018 goto theend;
9019 }
9020
9021 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
9022 if (regmatch.regprog != NULL)
9023 {
9024 regmatch.rm_ic = p_ic;
9025
9026 for (;;)
9027 {
9028 if (l != NULL)
9029 {
9030 if (li == NULL)
9031 {
9032 match = FALSE;
9033 break;
9034 }
9035 vim_free(tofree);
9036 expr = str = echo_string(&li->li_tv, &tofree, strbuf, 0);
9037 if (str == NULL)
9038 break;
9039 }
9040
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +00009041 match = vim_regexec_nl(&regmatch, str, startcol);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009042
9043 if (match && --nth <= 0)
9044 break;
9045 if (l == NULL && !match)
9046 break;
9047
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009048 // Advance to just after the match.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009049 if (l != NULL)
9050 {
9051 li = li->li_next;
9052 ++idx;
9053 }
9054 else
9055 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009056 startcol = (colnr_T)(regmatch.startp[0]
9057 + (*mb_ptr2len)(regmatch.startp[0]) - str);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009058 if (startcol > (colnr_T)len
9059 || str + startcol <= regmatch.startp[0])
9060 {
9061 match = FALSE;
9062 break;
9063 }
9064 }
9065 }
9066
9067 if (match)
9068 {
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009069 if (type == MATCH_POS)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009070 {
9071 listitem_T *li1 = rettv->vval.v_list->lv_first;
9072 listitem_T *li2 = li1->li_next;
9073 listitem_T *li3 = li2->li_next;
9074 listitem_T *li4 = li3->li_next;
9075
9076 vim_free(li1->li_tv.vval.v_string);
9077 li1->li_tv.vval.v_string = vim_strnsave(regmatch.startp[0],
Bram Moolenaardf44a272020-06-07 20:49:05 +02009078 regmatch.endp[0] - regmatch.startp[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009079 li3->li_tv.vval.v_number =
9080 (varnumber_T)(regmatch.startp[0] - expr);
9081 li4->li_tv.vval.v_number =
9082 (varnumber_T)(regmatch.endp[0] - expr);
9083 if (l != NULL)
9084 li2->li_tv.vval.v_number = (varnumber_T)idx;
9085 }
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009086 else if (type == MATCH_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009087 {
9088 int i;
9089
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009090 // return list with matched string and submatches
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009091 for (i = 0; i < NSUBEXP; ++i)
9092 {
9093 if (regmatch.endp[i] == NULL)
9094 {
9095 if (list_append_string(rettv->vval.v_list,
9096 (char_u *)"", 0) == FAIL)
9097 break;
9098 }
9099 else if (list_append_string(rettv->vval.v_list,
9100 regmatch.startp[i],
9101 (int)(regmatch.endp[i] - regmatch.startp[i]))
9102 == FAIL)
9103 break;
9104 }
9105 }
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009106 else if (type == MATCH_STR)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009107 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009108 // return matched string
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009109 if (l != NULL)
9110 copy_tv(&li->li_tv, rettv);
9111 else
9112 rettv->vval.v_string = vim_strnsave(regmatch.startp[0],
Bram Moolenaardf44a272020-06-07 20:49:05 +02009113 regmatch.endp[0] - regmatch.startp[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009114 }
9115 else if (l != NULL)
9116 rettv->vval.v_number = idx;
9117 else
9118 {
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009119 if (type != MATCH_END)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009120 rettv->vval.v_number =
9121 (varnumber_T)(regmatch.startp[0] - str);
9122 else
9123 rettv->vval.v_number =
9124 (varnumber_T)(regmatch.endp[0] - str);
9125 rettv->vval.v_number += (varnumber_T)(str - expr);
9126 }
9127 }
9128 vim_regfree(regmatch.regprog);
9129 }
9130
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009131theend:
9132 if (type == MATCH_POS && l == NULL && rettv->vval.v_list != NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009133 // matchstrpos() without a list: drop the second item.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009134 listitem_remove(rettv->vval.v_list,
9135 rettv->vval.v_list->lv_first->li_next);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009136 vim_free(tofree);
9137 p_cpo = save_cpo;
9138}
9139
9140/*
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01009141 * Return all the matches in string "str" for pattern "rmp".
9142 * The matches are returned in the List "mlist".
9143 * If "submatches" is TRUE, then submatch information is also returned.
9144 * "matchbuf" is TRUE when called for matchbufline().
9145 */
9146 static int
9147get_matches_in_str(
9148 char_u *str,
9149 regmatch_T *rmp,
9150 list_T *mlist,
9151 int idx,
9152 int submatches,
9153 int matchbuf)
9154{
9155 long len = (long)STRLEN(str);
9156 int match = 0;
9157 colnr_T startidx = 0;
9158
9159 for (;;)
9160 {
9161 match = vim_regexec_nl(rmp, str, startidx);
9162 if (!match)
9163 break;
9164
9165 dict_T *d = dict_alloc();
9166 if (d == NULL)
9167 return FAIL;
9168 if (list_append_dict(mlist, d) == FAIL)
Satoru Kitaguchiba737662025-04-06 16:04:59 +02009169 return FAIL;
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01009170
9171 if (dict_add_number(d, matchbuf ? "lnum" : "idx", idx) == FAIL)
9172 return FAIL;
9173
9174 if (dict_add_number(d, "byteidx",
9175 (colnr_T)(rmp->startp[0] - str)) == FAIL)
9176 return FAIL;
9177
9178 if (dict_add_string_len(d, "text", rmp->startp[0],
9179 (int)(rmp->endp[0] - rmp->startp[0])) == FAIL)
9180 return FAIL;
9181
9182 if (submatches)
9183 {
9184 list_T *sml = list_alloc();
9185 if (sml == NULL)
9186 return FAIL;
9187
9188 if (dict_add_list(d, "submatches", sml) == FAIL)
9189 return FAIL;
9190
9191 // return a list with the submatches
9192 for (int i = 1; i < NSUBEXP; ++i)
9193 {
9194 if (rmp->endp[i] == NULL)
9195 {
9196 if (list_append_string(sml, (char_u *)"", 0) == FAIL)
9197 return FAIL;
9198 }
9199 else if (list_append_string(sml, rmp->startp[i],
9200 (int)(rmp->endp[i] - rmp->startp[i])) == FAIL)
9201 return FAIL;
9202 }
9203 }
9204 startidx = (colnr_T)(rmp->endp[0] - str);
9205 if (startidx >= (colnr_T)len || str + startidx <= rmp->startp[0])
9206 break;
9207 }
9208
9209 return OK;
9210}
9211
9212/*
9213 * "matchbufline()" function
9214 */
9215 static void
9216f_matchbufline(typval_T *argvars, typval_T *rettv)
9217{
9218 list_T *retlist = NULL;
9219 char_u *save_cpo;
9220 char_u patbuf[NUMBUFLEN];
9221 regmatch_T regmatch;
9222
9223 rettv->vval.v_number = -1;
9224 if (rettv_list_alloc(rettv) != OK)
9225 return;
9226 retlist = rettv->vval.v_list;
9227
9228 if (check_for_buffer_arg(argvars, 0) == FAIL
9229 || check_for_string_arg(argvars, 1) == FAIL
9230 || check_for_lnum_arg(argvars, 2) == FAIL
9231 || check_for_lnum_arg(argvars, 3) == FAIL
9232 || check_for_opt_dict_arg(argvars, 4) == FAIL)
9233 return;
9234
9235 int prev_did_emsg = did_emsg;
9236 buf_T *buf = tv_get_buf(&argvars[0], FALSE);
9237 if (buf == NULL)
9238 {
9239 if (did_emsg == prev_did_emsg)
9240 semsg(_(e_invalid_buffer_name_str), tv_get_string(&argvars[0]));
9241 return;
9242 }
9243 if (buf->b_ml.ml_mfp == NULL)
9244 {
9245 emsg(_(e_buffer_is_not_loaded));
9246 return;
9247 }
9248
9249 char_u *pat = tv_get_string_buf(&argvars[1], patbuf);
9250
9251 int did_emsg_before = did_emsg;
9252 linenr_T slnum = tv_get_lnum_buf(&argvars[2], buf);
9253 if (did_emsg > did_emsg_before)
9254 return;
9255 if (slnum < 1)
9256 {
9257 semsg(_(e_invalid_value_for_argument_str), "lnum");
9258 return;
9259 }
9260
9261 linenr_T elnum = tv_get_lnum_buf(&argvars[3], buf);
9262 if (did_emsg > did_emsg_before)
9263 return;
9264 if (elnum < 1 || elnum < slnum)
9265 {
9266 semsg(_(e_invalid_value_for_argument_str), "end_lnum");
9267 return;
9268 }
9269
9270 if (elnum > buf->b_ml.ml_line_count)
9271 elnum = buf->b_ml.ml_line_count;
9272
9273 int submatches = FALSE;
9274 if (argvars[4].v_type != VAR_UNKNOWN)
9275 {
9276 dict_T *d = argvars[4].vval.v_dict;
9277 if (d != NULL)
9278 {
9279 dictitem_T *di = dict_find(d, (char_u *)"submatches", -1);
9280 if (di != NULL)
9281 {
9282 if (di->di_tv.v_type != VAR_BOOL)
9283 {
9284 semsg(_(e_invalid_value_for_argument_str), "submatches");
9285 return;
9286 }
9287 submatches = tv_get_bool(&di->di_tv);
9288 }
9289 }
9290 }
9291
9292 // Make 'cpoptions' empty, the 'l' flag should not be used here.
9293 save_cpo = p_cpo;
9294 p_cpo = empty_option;
9295
9296 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
9297 if (regmatch.regprog == NULL)
9298 goto theend;
9299 regmatch.rm_ic = p_ic;
9300
9301 while (slnum <= elnum)
9302 {
9303 char_u *str = ml_get_buf(buf, slnum, FALSE);
9304 if (get_matches_in_str(str, &regmatch, retlist, slnum, submatches,
9305 TRUE) == FAIL)
9306 goto cleanup;
9307 slnum++;
9308 }
9309
9310cleanup:
9311 vim_regfree(regmatch.regprog);
9312
9313theend:
9314 p_cpo = save_cpo;
9315}
9316
9317/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009318 * "match()" function
9319 */
9320 static void
9321f_match(typval_T *argvars, typval_T *rettv)
9322{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009323 find_some_match(argvars, rettv, MATCH_MATCH);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009324}
9325
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009326/*
9327 * "matchend()" function
9328 */
9329 static void
9330f_matchend(typval_T *argvars, typval_T *rettv)
9331{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009332 find_some_match(argvars, rettv, MATCH_END);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009333}
9334
9335/*
9336 * "matchlist()" function
9337 */
9338 static void
9339f_matchlist(typval_T *argvars, typval_T *rettv)
9340{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009341 find_some_match(argvars, rettv, MATCH_LIST);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009342}
9343
9344/*
9345 * "matchstr()" function
9346 */
9347 static void
9348f_matchstr(typval_T *argvars, typval_T *rettv)
9349{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009350 find_some_match(argvars, rettv, MATCH_STR);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009351}
9352
9353/*
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01009354 * "matchstrlist()" function
9355 */
9356 static void
9357f_matchstrlist(typval_T *argvars, typval_T *rettv)
9358{
9359 list_T *retlist = NULL;
9360 char_u *save_cpo;
9361 list_T *l = NULL;
9362 listitem_T *li = NULL;
9363 char_u patbuf[NUMBUFLEN];
9364 regmatch_T regmatch;
9365
9366 rettv->vval.v_number = -1;
9367 if (rettv_list_alloc(rettv) != OK)
9368 return;
9369 retlist = rettv->vval.v_list;
9370
9371 if (check_for_list_arg(argvars, 0) == FAIL
9372 || check_for_string_arg(argvars, 1) == FAIL
9373 || check_for_opt_dict_arg(argvars, 2) == FAIL)
9374 return;
9375
9376 if ((l = argvars[0].vval.v_list) == NULL)
9377 return;
9378
9379 char_u *pat = tv_get_string_buf_chk(&argvars[1], patbuf);
9380 if (pat == NULL)
9381 return;
9382
9383 // Make 'cpoptions' empty, the 'l' flag should not be used here.
9384 save_cpo = p_cpo;
9385 p_cpo = empty_option;
9386
9387 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
9388 if (regmatch.regprog == NULL)
9389 goto theend;
9390 regmatch.rm_ic = p_ic;
9391
9392 int submatches = FALSE;
9393 if (argvars[2].v_type != VAR_UNKNOWN)
9394 {
9395 dict_T *d = argvars[2].vval.v_dict;
9396 if (d != NULL)
9397 {
9398 dictitem_T *di = dict_find(d, (char_u *)"submatches", -1);
9399 if (di != NULL)
9400 {
9401 if (di->di_tv.v_type != VAR_BOOL)
9402 {
9403 semsg(_(e_invalid_value_for_argument_str), "submatches");
9404 goto cleanup;
9405 }
9406 submatches = tv_get_bool(&di->di_tv);
9407 }
9408 }
9409 }
9410
9411 int idx = 0;
9412 CHECK_LIST_MATERIALIZE(l);
9413 FOR_ALL_LIST_ITEMS(l, li)
9414 {
9415 if (li->li_tv.v_type == VAR_STRING && li->li_tv.vval.v_string != NULL)
9416 {
9417 char_u *str = li->li_tv.vval.v_string;
9418 if (get_matches_in_str(str, &regmatch, retlist, idx, submatches,
9419 FALSE) == FAIL)
9420 goto cleanup;
9421 }
9422 idx++;
9423 }
9424
9425cleanup:
9426 vim_regfree(regmatch.regprog);
9427
9428theend:
9429 p_cpo = save_cpo;
9430}
9431
9432/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009433 * "matchstrpos()" function
9434 */
9435 static void
9436f_matchstrpos(typval_T *argvars, typval_T *rettv)
9437{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009438 find_some_match(argvars, rettv, MATCH_POS);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009439}
9440
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009441 static void
9442max_min(typval_T *argvars, typval_T *rettv, int domax)
9443{
9444 varnumber_T n = 0;
9445 varnumber_T i;
9446 int error = FALSE;
9447
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01009448 if (in_vim9script() &&
9449 check_for_list_or_tuple_or_dict_arg(argvars, 0) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009450 return;
9451
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009452 if (argvars[0].v_type == VAR_LIST)
9453 {
9454 list_T *l;
9455 listitem_T *li;
9456
9457 l = argvars[0].vval.v_list;
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009458 if (l != NULL && l->lv_len > 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009459 {
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009460 if (l->lv_first == &range_list_item)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009461 {
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009462 if ((l->lv_u.nonmat.lv_stride > 0) ^ domax)
9463 n = l->lv_u.nonmat.lv_start;
9464 else
=?UTF-8?q?Dundar=20G=C3=B6c?=d5cec1f2022-01-29 15:19:23 +00009465 n = l->lv_u.nonmat.lv_start + ((varnumber_T)l->lv_len - 1)
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009466 * l->lv_u.nonmat.lv_stride;
9467 }
9468 else
9469 {
9470 li = l->lv_first;
9471 if (li != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009472 {
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009473 n = tv_get_number_chk(&li->li_tv, &error);
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009474 if (error)
9475 return; // type error; errmsg already given
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009476 for (;;)
9477 {
9478 li = li->li_next;
9479 if (li == NULL)
9480 break;
9481 i = tv_get_number_chk(&li->li_tv, &error);
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009482 if (error)
9483 return; // type error; errmsg already given
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009484 if (domax ? i > n : i < n)
9485 n = i;
9486 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009487 }
9488 }
9489 }
9490 }
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01009491 else if (argvars[0].v_type == VAR_TUPLE)
9492 {
9493 n = tuple_max_min(argvars[0].vval.v_tuple, domax, &error);
9494 if (error)
9495 return;
9496 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009497 else if (argvars[0].v_type == VAR_DICT)
9498 {
9499 dict_T *d;
9500 int first = TRUE;
9501 hashitem_T *hi;
9502 int todo;
9503
9504 d = argvars[0].vval.v_dict;
9505 if (d != NULL)
9506 {
9507 todo = (int)d->dv_hashtab.ht_used;
Yegappan Lakshmanan14113fd2023-03-07 17:13:51 +00009508 FOR_ALL_HASHTAB_ITEMS(&d->dv_hashtab, hi, todo)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009509 {
9510 if (!HASHITEM_EMPTY(hi))
9511 {
9512 --todo;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009513 i = tv_get_number_chk(&HI2DI(hi)->di_tv, &error);
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009514 if (error)
9515 return; // type error; errmsg already given
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009516 if (first)
9517 {
9518 n = i;
9519 first = FALSE;
9520 }
9521 else if (domax ? i > n : i < n)
9522 n = i;
9523 }
9524 }
9525 }
9526 }
9527 else
Bram Moolenaar460ae5d2022-01-01 14:19:49 +00009528 semsg(_(e_argument_of_str_must_be_list_or_dictionary), domax ? "max()" : "min()");
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009529
9530 rettv->vval.v_number = n;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009531}
9532
9533/*
9534 * "max()" function
9535 */
9536 static void
9537f_max(typval_T *argvars, typval_T *rettv)
9538{
9539 max_min(argvars, rettv, TRUE);
9540}
9541
9542/*
9543 * "min()" function
9544 */
9545 static void
9546f_min(typval_T *argvars, typval_T *rettv)
9547{
9548 max_min(argvars, rettv, FALSE);
9549}
9550
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009551#if defined(FEAT_MZSCHEME) || defined(PROTO)
9552/*
9553 * "mzeval()" function
9554 */
9555 static void
9556f_mzeval(typval_T *argvars, typval_T *rettv)
9557{
9558 char_u *str;
9559 char_u buf[NUMBUFLEN];
9560
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009561 if (check_restricted() || check_secure())
9562 return;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009563
9564 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
9565 return;
9566
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009567 str = tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009568 do_mzeval(str, rettv);
9569}
9570
9571 void
9572mzscheme_call_vim(char_u *name, typval_T *args, typval_T *rettv)
9573{
9574 typval_T argvars[3];
9575
9576 argvars[0].v_type = VAR_STRING;
9577 argvars[0].vval.v_string = name;
9578 copy_tv(args, &argvars[1]);
9579 argvars[2].v_type = VAR_UNKNOWN;
9580 f_call(argvars, rettv);
9581 clear_tv(&argvars[1]);
9582}
9583#endif
9584
9585/*
9586 * "nextnonblank()" function
9587 */
9588 static void
9589f_nextnonblank(typval_T *argvars, typval_T *rettv)
9590{
9591 linenr_T lnum;
9592
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009593 if (in_vim9script() && check_for_lnum_arg(argvars, 0) == FAIL)
9594 return;
9595
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009596 for (lnum = tv_get_lnum(argvars); ; ++lnum)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009597 {
9598 if (lnum < 0 || lnum > curbuf->b_ml.ml_line_count)
9599 {
9600 lnum = 0;
9601 break;
9602 }
9603 if (*skipwhite(ml_get(lnum)) != NUL)
9604 break;
9605 }
9606 rettv->vval.v_number = lnum;
9607}
9608
Christ van Willegenc0786752025-02-01 15:42:16 +01009609
9610/*
9611 * "ngettext()" function
9612 */
9613 static void
9614f_ngettext(typval_T *argvars, typval_T *rettv)
9615{
9616#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
9617 char *prev = NULL;
9618#endif
9619
9620 if (check_for_nonempty_string_arg(argvars, 0) == FAIL
9621 || check_for_nonempty_string_arg(argvars, 1) == FAIL
9622 || check_for_number_arg(argvars, 2) == FAIL
9623 || check_for_opt_string_arg(argvars, 3) == FAIL)
9624 return;
9625
9626 rettv->v_type = VAR_STRING;
9627
9628 if (argvars[3].v_type == VAR_STRING &&
9629 argvars[3].vval.v_string != NULL &&
9630 *(argvars[3].vval.v_string) != NUL)
9631 {
9632#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
9633 prev = bind_textdomain_codeset((const char *)argvars[3].vval.v_string, (char *)p_enc);
9634#endif
9635
9636#if defined(HAVE_DNGETTEXT)
9637 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));
9638#else
9639 textdomain((const char *)argvars[3].vval.v_string);
9640 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));
9641 textdomain(VIMPACKAGE);
9642#endif
9643
9644#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
9645 if (prev != NULL)
9646 bind_textdomain_codeset((const char *)argvars[3].vval.v_string, prev);
9647#endif
9648 }
9649 else
9650 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));
9651}
9652
9653
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009654/*
9655 * "nr2char()" function
9656 */
9657 static void
9658f_nr2char(typval_T *argvars, typval_T *rettv)
9659{
9660 char_u buf[NUMBUFLEN];
9661
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02009662 if (in_vim9script()
9663 && (check_for_number_arg(argvars, 0) == FAIL
9664 || check_for_opt_bool_arg(argvars, 1) == FAIL))
9665 return;
9666
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009667 if (has_mbyte)
9668 {
9669 int utf8 = 0;
9670
9671 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaared6a4302020-09-05 20:29:41 +02009672 utf8 = (int)tv_get_bool_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009673 if (utf8)
Bram Moolenaarbdace832019-03-02 10:13:42 +01009674 buf[utf_char2bytes((int)tv_get_number(&argvars[0]), buf)] = NUL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009675 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009676 buf[(*mb_char2bytes)((int)tv_get_number(&argvars[0]), buf)] = NUL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009677 }
9678 else
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009679 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009680 buf[0] = (char_u)tv_get_number(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009681 buf[1] = NUL;
9682 }
9683 rettv->v_type = VAR_STRING;
9684 rettv->vval.v_string = vim_strsave(buf);
9685}
9686
9687/*
9688 * "or(expr, expr)" function
9689 */
9690 static void
9691f_or(typval_T *argvars, typval_T *rettv)
9692{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009693 if (in_vim9script()
9694 && (check_for_number_arg(argvars, 0) == FAIL
9695 || check_for_number_arg(argvars, 1) == FAIL))
9696 return;
9697
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009698 rettv->vval.v_number = tv_get_number_chk(&argvars[0], NULL)
9699 | tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009700}
9701
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009702#ifdef FEAT_PERL
9703/*
9704 * "perleval()" function
9705 */
9706 static void
9707f_perleval(typval_T *argvars, typval_T *rettv)
9708{
9709 char_u *str;
9710 char_u buf[NUMBUFLEN];
9711
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009712 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
9713 return;
9714
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009715 str = tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009716 do_perleval(str, rettv);
9717}
9718#endif
9719
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009720/*
9721 * "prevnonblank()" function
9722 */
9723 static void
9724f_prevnonblank(typval_T *argvars, typval_T *rettv)
9725{
9726 linenr_T lnum;
9727
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009728 if (in_vim9script() && check_for_lnum_arg(argvars, 0) == FAIL)
9729 return;
9730
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009731 lnum = tv_get_lnum(argvars);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009732 if (lnum < 1 || lnum > curbuf->b_ml.ml_line_count)
9733 lnum = 0;
9734 else
9735 while (lnum >= 1 && *skipwhite(ml_get(lnum)) == NUL)
9736 --lnum;
9737 rettv->vval.v_number = lnum;
9738}
9739
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009740// This dummy va_list is here because:
9741// - passing a NULL pointer doesn't work when va_list isn't a pointer
9742// - locally in the function results in a "used before set" warning
9743// - using va_start() to initialize it gives "function with fixed args" error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009744static va_list ap;
9745
9746/*
9747 * "printf()" function
9748 */
9749 static void
9750f_printf(typval_T *argvars, typval_T *rettv)
9751{
9752 char_u buf[NUMBUFLEN];
9753 int len;
9754 char_u *s;
9755 int saved_did_emsg = did_emsg;
9756 char *fmt;
9757
9758 rettv->v_type = VAR_STRING;
9759 rettv->vval.v_string = NULL;
9760
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02009761 if (in_vim9script() && check_for_string_or_number_arg(argvars, 0) == FAIL)
9762 return;
9763
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009764 // Get the required length, allocate the buffer and do it for real.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009765 did_emsg = FALSE;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009766 fmt = (char *)tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar8327d1d2017-07-11 22:34:51 +02009767 len = vim_vsnprintf_typval(NULL, 0, fmt, ap, argvars + 1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009768 if (!did_emsg)
9769 {
9770 s = alloc(len + 1);
9771 if (s != NULL)
9772 {
9773 rettv->vval.v_string = s;
Bram Moolenaar8327d1d2017-07-11 22:34:51 +02009774 (void)vim_vsnprintf_typval((char *)s, len + 1, fmt,
9775 ap, argvars + 1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009776 }
9777 }
9778 did_emsg |= saved_did_emsg;
9779}
9780
9781/*
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009782 * "pum_getpos()" function
9783 */
9784 static void
9785f_pum_getpos(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
9786{
Bram Moolenaar93a10962022-06-16 11:42:09 +01009787 if (rettv_dict_alloc(rettv) == FAIL)
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009788 return;
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009789 pum_set_event_info(rettv->vval.v_dict);
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009790}
9791
9792/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009793 * "pumvisible()" function
9794 */
9795 static void
9796f_pumvisible(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
9797{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009798 if (pum_visible())
9799 rettv->vval.v_number = 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009800}
9801
9802#ifdef FEAT_PYTHON3
9803/*
9804 * "py3eval()" function
9805 */
9806 static void
9807f_py3eval(typval_T *argvars, typval_T *rettv)
9808{
9809 char_u *str;
9810 char_u buf[NUMBUFLEN];
Ben Jacksonea19e782024-11-06 21:50:05 +01009811 dict_T *locals;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009812
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009813 if (check_restricted() || check_secure())
9814 return;
9815
Ben Jacksonea19e782024-11-06 21:50:05 +01009816 if (in_vim9script()
9817 && (check_for_string_arg(argvars, 0) == FAIL
9818 || check_for_opt_dict_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009819 return;
9820
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009821 if (p_pyx == 0)
9822 p_pyx = 3;
9823
Ben Jacksonea19e782024-11-06 21:50:05 +01009824 if (argvars[1].v_type == VAR_DICT)
9825 {
9826 locals = argvars[1].vval.v_dict;
9827 }
9828 else if (argvars[1].v_type != VAR_UNKNOWN)
9829 {
9830 emsg(_(e_dictionary_required));
9831 return;
9832 }
9833 else
9834 {
9835 locals = NULL;
9836 }
9837
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009838 str = tv_get_string_buf(&argvars[0], buf);
Ben Jacksonea19e782024-11-06 21:50:05 +01009839 do_py3eval(str, locals, rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009840}
9841#endif
9842
9843#ifdef FEAT_PYTHON
9844/*
9845 * "pyeval()" function
9846 */
9847 static void
9848f_pyeval(typval_T *argvars, typval_T *rettv)
9849{
9850 char_u *str;
9851 char_u buf[NUMBUFLEN];
Ben Jacksonea19e782024-11-06 21:50:05 +01009852 dict_T *locals;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009853
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009854 if (check_restricted() || check_secure())
9855 return;
9856
Ben Jacksonea19e782024-11-06 21:50:05 +01009857 if (in_vim9script() && (
9858 check_for_string_arg(argvars, 0) == FAIL ||
9859 check_for_opt_dict_arg(argvars, 1) == FAIL ) )
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009860 return;
9861
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009862 if (p_pyx == 0)
9863 p_pyx = 2;
9864
Ben Jacksonea19e782024-11-06 21:50:05 +01009865 if (argvars[1].v_type == VAR_DICT)
9866 {
9867 locals = argvars[1].vval.v_dict;
9868 }
9869 else if (argvars[1].v_type != VAR_UNKNOWN)
9870 {
9871 emsg( "Invalid argument: must be dict" );
9872 return;
9873 }
9874 else
9875 {
9876 locals = NULL;
9877 }
9878
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009879 str = tv_get_string_buf(&argvars[0], buf);
Ben Jacksonea19e782024-11-06 21:50:05 +01009880 do_pyeval(str, locals, rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009881}
9882#endif
9883
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009884#if defined(FEAT_PYTHON) || defined(FEAT_PYTHON3)
9885/*
9886 * "pyxeval()" function
9887 */
9888 static void
9889f_pyxeval(typval_T *argvars, typval_T *rettv)
9890{
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009891 if (check_restricted() || check_secure())
9892 return;
9893
Ben Jacksonea19e782024-11-06 21:50:05 +01009894 if (in_vim9script()
9895 && (check_for_string_arg(argvars, 0) == FAIL
9896 || check_for_opt_dict_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009897 return;
9898
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009899# if defined(FEAT_PYTHON) && defined(FEAT_PYTHON3)
9900 init_pyxversion();
9901 if (p_pyx == 2)
9902 f_pyeval(argvars, rettv);
9903 else
9904 f_py3eval(argvars, rettv);
9905# elif defined(FEAT_PYTHON)
9906 f_pyeval(argvars, rettv);
9907# elif defined(FEAT_PYTHON3)
9908 f_py3eval(argvars, rettv);
9909# endif
9910}
9911#endif
9912
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009913static UINT32_T srand_seed_for_testing = 0;
9914static int srand_seed_for_testing_is_used = FALSE;
9915
9916 static void
9917f_test_srand_seed(typval_T *argvars, typval_T *rettv UNUSED)
9918{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009919 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
9920 return;
9921
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009922 if (argvars[0].v_type == VAR_UNKNOWN)
Bram Moolenaar7633fe52020-06-22 19:10:56 +02009923 srand_seed_for_testing_is_used = FALSE;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009924 else
9925 {
Bram Moolenaar7633fe52020-06-22 19:10:56 +02009926 srand_seed_for_testing = (UINT32_T)tv_get_number(&argvars[0]);
9927 srand_seed_for_testing_is_used = TRUE;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009928 }
9929}
9930
9931 static void
9932init_srand(UINT32_T *x)
9933{
LemonBoy9987fe82024-07-04 13:20:49 +02009934 struct {
9935 union {
9936 UINT32_T number;
9937 char_u bytes[sizeof(UINT32_T)];
9938 } contents;
9939 } buf;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009940
9941 if (srand_seed_for_testing_is_used)
9942 {
Bram Moolenaar7633fe52020-06-22 19:10:56 +02009943 *x = srand_seed_for_testing;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009944 return;
9945 }
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009946
LemonBoy9987fe82024-07-04 13:20:49 +02009947 if (mch_get_random(buf.contents.bytes, sizeof(buf.contents.bytes)) == OK)
9948 {
9949 *x = buf.contents.number;
9950 return;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009951 }
LemonBoy9987fe82024-07-04 13:20:49 +02009952
9953 // The system's random number generator doesn't work, fall back to:
9954 // - randombytes_random()
9955 // - reltime() or time()
9956 // - XOR with process ID
9957#if defined(FEAT_SODIUM)
9958 if (crypt_sodium_init() >= 0)
9959 *x = crypt_sodium_randombytes_random();
9960 else
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009961#endif
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009962 {
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009963#if defined(FEAT_RELTIME)
LemonBoy9987fe82024-07-04 13:20:49 +02009964 proftime_T res;
9965 profile_start(&res);
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009966# if defined(MSWIN)
LemonBoy9987fe82024-07-04 13:20:49 +02009967 *x = (UINT32_T)res.LowPart;
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009968# else
LemonBoy9987fe82024-07-04 13:20:49 +02009969 *x = (UINT32_T)res.tv_fsec;
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009970# endif
9971#else
LemonBoy9987fe82024-07-04 13:20:49 +02009972 *x = vim_time();
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009973#endif
LemonBoy9987fe82024-07-04 13:20:49 +02009974 *x ^= mch_get_pid();
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009975 }
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009976}
9977
kylo252ae6f1d82022-02-16 19:24:07 +00009978#define ROTL(x, k) (((x) << (k)) | ((x) >> (32 - (k))))
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009979#define SPLITMIX32(x, z) ( \
kylo252ae6f1d82022-02-16 19:24:07 +00009980 (z) = ((x) += 0x9e3779b9), \
9981 (z) = ((z) ^ ((z) >> 16)) * 0x85ebca6b, \
9982 (z) = ((z) ^ ((z) >> 13)) * 0xc2b2ae35, \
9983 (z) ^ ((z) >> 16) \
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009984 )
9985#define SHUFFLE_XOSHIRO128STARSTAR(x, y, z, w) \
kylo252ae6f1d82022-02-16 19:24:07 +00009986 result = ROTL((y) * 5, 7) * 9; \
9987 t = (y) << 9; \
9988 (z) ^= (x); \
9989 (w) ^= (y); \
9990 (y) ^= (z), (x) ^= (w); \
9991 (z) ^= t; \
9992 (w) = ROTL(w, 11);
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009993
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009994/*
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009995 * "rand()" function
9996 */
9997 static void
9998f_rand(typval_T *argvars, typval_T *rettv)
9999{
10000 list_T *l = NULL;
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010001 static UINT32_T gx, gy, gz, gw;
10002 static int initialized = FALSE;
Bram Moolenaarf8c1f922019-11-28 22:13:14 +010010003 listitem_T *lx, *ly, *lz, *lw;
Bram Moolenaar0fd797e2020-11-05 20:46:32 +010010004 UINT32_T x = 0, y, z, w, t, result;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010005
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010006 if (in_vim9script() && check_for_opt_list_arg(argvars, 0) == FAIL)
10007 return;
10008
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010009 if (argvars[0].v_type == VAR_UNKNOWN)
10010 {
Bram Moolenaarf8c1f922019-11-28 22:13:14 +010010011 // When no argument is given use the global seed list.
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010012 if (initialized == FALSE)
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010013 {
Bram Moolenaarf8c1f922019-11-28 22:13:14 +010010014 // Initialize the global seed list.
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010015 init_srand(&x);
10016
10017 gx = SPLITMIX32(x, z);
10018 gy = SPLITMIX32(x, z);
10019 gz = SPLITMIX32(x, z);
10020 gw = SPLITMIX32(x, z);
10021 initialized = TRUE;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010022 }
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010023
10024 SHUFFLE_XOSHIRO128STARSTAR(gx, gy, gz, gw);
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010025 }
10026 else if (argvars[0].v_type == VAR_LIST)
10027 {
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010028 l = argvars[0].vval.v_list;
Bram Moolenaarf8c1f922019-11-28 22:13:14 +010010029 if (l == NULL || list_len(l) != 4)
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010030 goto theend;
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010031
10032 lx = list_find(l, 0L);
10033 ly = list_find(l, 1L);
10034 lz = list_find(l, 2L);
10035 lw = list_find(l, 3L);
10036 if (lx->li_tv.v_type != VAR_NUMBER) goto theend;
10037 if (ly->li_tv.v_type != VAR_NUMBER) goto theend;
10038 if (lz->li_tv.v_type != VAR_NUMBER) goto theend;
10039 if (lw->li_tv.v_type != VAR_NUMBER) goto theend;
10040 x = (UINT32_T)lx->li_tv.vval.v_number;
10041 y = (UINT32_T)ly->li_tv.vval.v_number;
10042 z = (UINT32_T)lz->li_tv.vval.v_number;
10043 w = (UINT32_T)lw->li_tv.vval.v_number;
10044
10045 SHUFFLE_XOSHIRO128STARSTAR(x, y, z, w);
10046
10047 lx->li_tv.vval.v_number = (varnumber_T)x;
10048 ly->li_tv.vval.v_number = (varnumber_T)y;
10049 lz->li_tv.vval.v_number = (varnumber_T)z;
10050 lw->li_tv.vval.v_number = (varnumber_T)w;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010051 }
10052 else
10053 goto theend;
10054
10055 rettv->v_type = VAR_NUMBER;
Bram Moolenaarf8c1f922019-11-28 22:13:14 +010010056 rettv->vval.v_number = (varnumber_T)result;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010057 return;
10058
10059theend:
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010060 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[0]));
Bram Moolenaarf8c1f922019-11-28 22:13:14 +010010061 rettv->v_type = VAR_NUMBER;
10062 rettv->vval.v_number = -1;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010063}
10064
10065/*
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010066 * "srand()" function
10067 */
10068 static void
10069f_srand(typval_T *argvars, typval_T *rettv)
10070{
10071 UINT32_T x = 0, z;
10072
10073 if (rettv_list_alloc(rettv) == FAIL)
10074 return;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010075
10076 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
10077 return;
10078
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010079 if (argvars[0].v_type == VAR_UNKNOWN)
10080 {
10081 init_srand(&x);
10082 }
10083 else
10084 {
10085 int error = FALSE;
10086
10087 x = (UINT32_T)tv_get_number_chk(&argvars[0], &error);
10088 if (error)
10089 return;
10090 }
10091
10092 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
10093 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
10094 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
10095 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
10096}
10097
10098#undef ROTL
10099#undef SPLITMIX32
10100#undef SHUFFLE_XOSHIRO128STARSTAR
10101
10102/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010103 * "range()" function
10104 */
10105 static void
10106f_range(typval_T *argvars, typval_T *rettv)
10107{
10108 varnumber_T start;
10109 varnumber_T end;
10110 varnumber_T stride = 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010111 int error = FALSE;
10112
Bram Moolenaar93a10962022-06-16 11:42:09 +010010113 if (rettv_list_alloc(rettv) == FAIL)
Yegappan Lakshmananca195cc2022-06-14 13:42:26 +010010114 return;
10115
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010116 if (in_vim9script()
10117 && (check_for_number_arg(argvars, 0) == FAIL
10118 || check_for_opt_number_arg(argvars, 1) == FAIL
10119 || (argvars[1].v_type != VAR_UNKNOWN
10120 && check_for_opt_number_arg(argvars, 2) == FAIL)))
10121 return;
10122
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010123 start = tv_get_number_chk(&argvars[0], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010124 if (argvars[1].v_type == VAR_UNKNOWN)
10125 {
10126 end = start - 1;
10127 start = 0;
10128 }
10129 else
10130 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010131 end = tv_get_number_chk(&argvars[1], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010132 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010133 stride = tv_get_number_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010134 }
10135
10136 if (error)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010137 return; // type error; errmsg already given
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010138 if (stride == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010139 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010140 emsg(_(e_stride_is_zero));
10141 return;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010010142 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010143 if (stride > 0 ? end + 1 < start : end - 1 > start)
10144 {
10145 emsg(_(e_start_past_end));
10146 return;
10147 }
10148
10149 list_T *list = rettv->vval.v_list;
10150
10151 // Create a non-materialized list. This is much more efficient and
10152 // works with ":for". If used otherwise CHECK_LIST_MATERIALIZE() must
10153 // be called.
10154 list->lv_first = &range_list_item;
10155 list->lv_u.nonmat.lv_start = start;
10156 list->lv_u.nonmat.lv_end = end;
10157 list->lv_u.nonmat.lv_stride = stride;
Christian Brabandtdf63da92023-11-23 20:14:28 +010010158 if (stride > 0 ? end < start : end > start)
10159 list->lv_len = 0;
10160 else
10161 list->lv_len = (end - start) / stride + 1;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010010162}
10163
10164/*
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020010165 * Materialize "list".
10166 * Do not call directly, use CHECK_LIST_MATERIALIZE()
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010010167 */
10168 void
10169range_list_materialize(list_T *list)
10170{
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020010171 varnumber_T start = list->lv_u.nonmat.lv_start;
10172 varnumber_T end = list->lv_u.nonmat.lv_end;
Bram Moolenaar70c43d82022-01-26 21:01:15 +000010173 int stride = list->lv_u.nonmat.lv_stride;
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020010174 varnumber_T i;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010010175
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020010176 list->lv_first = NULL;
10177 list->lv_u.mat.lv_last = NULL;
10178 list->lv_len = 0;
10179 list->lv_u.mat.lv_idx_item = NULL;
10180 for (i = start; stride > 0 ? i <= end : i >= end; i += stride)
Bram Moolenaar70c43d82022-01-26 21:01:15 +000010181 {
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +000010182 if (list_append_number(list, i) == FAIL)
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020010183 break;
Bram Moolenaar70c43d82022-01-26 21:01:15 +000010184 if (list->lv_lock & VAR_ITEMS_LOCKED)
10185 list->lv_u.mat.lv_last->li_tv.v_lock = VAR_LOCKED;
10186 }
10187 list->lv_lock &= ~VAR_ITEMS_LOCKED;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010188}
10189
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010190/*
10191 * "getreginfo()" function
10192 */
10193 static void
10194f_getreginfo(typval_T *argvars, typval_T *rettv)
10195{
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010196 int regname;
10197 char_u buf[NUMBUFLEN + 2];
10198 long reglen = 0;
10199 dict_T *dict;
10200 list_T *list;
10201
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010202 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
10203 return;
10204
zeertzjqd3f00f52021-12-24 12:02:43 +000010205 regname = getreg_get_regname(argvars);
10206 if (regname == 0)
10207 return;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010208
zeertzjqd3f00f52021-12-24 12:02:43 +000010209 if (regname == '@')
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010210 regname = '"';
10211
10212 if (rettv_dict_alloc(rettv) == FAIL)
10213 return;
10214 dict = rettv->vval.v_dict;
10215
10216 list = (list_T *)get_reg_contents(regname, GREG_EXPR_SRC | GREG_LIST);
10217 if (list == NULL)
10218 return;
Bram Moolenaar91639192020-06-29 19:55:58 +020010219 (void)dict_add_list(dict, "regcontents", list);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010220
10221 buf[0] = NUL;
10222 buf[1] = NUL;
10223 switch (get_reg_type(regname, &reglen))
10224 {
10225 case MLINE: buf[0] = 'V'; break;
10226 case MCHAR: buf[0] = 'v'; break;
10227 case MBLOCK:
10228 vim_snprintf((char *)buf, sizeof(buf), "%c%ld", Ctrl_V,
10229 reglen + 1);
10230 break;
10231 }
Bram Moolenaar91639192020-06-29 19:55:58 +020010232 (void)dict_add_string(dict, (char *)"regtype", buf);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010233
10234 buf[0] = get_register_name(get_unname_register());
10235 buf[1] = NUL;
10236 if (regname == '"')
Bram Moolenaar91639192020-06-29 19:55:58 +020010237 (void)dict_add_string(dict, (char *)"points_to", buf);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010238 else
10239 {
10240 dictitem_T *item = dictitem_alloc((char_u *)"isunnamed");
10241
10242 if (item != NULL)
10243 {
Bram Moolenaar82946e12022-11-24 11:31:29 +000010244 item->di_tv.v_type = VAR_BOOL;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010245 item->di_tv.vval.v_number = regname == buf[0]
Bram Moolenaar418a29f2021-02-10 22:23:41 +010010246 ? VVAL_TRUE : VVAL_FALSE;
Bram Moolenaar91639192020-06-29 19:55:58 +020010247 (void)dict_add(dict, item);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010248 }
10249 }
10250}
10251
Bram Moolenaar0b6d9112018-05-22 20:35:17 +020010252 static void
10253return_register(int regname, typval_T *rettv)
10254{
10255 char_u buf[2] = {0, 0};
10256
10257 buf[0] = (char_u)regname;
10258 rettv->v_type = VAR_STRING;
10259 rettv->vval.v_string = vim_strsave(buf);
10260}
10261
10262/*
10263 * "reg_executing()" function
10264 */
10265 static void
10266f_reg_executing(typval_T *argvars UNUSED, typval_T *rettv)
10267{
10268 return_register(reg_executing, rettv);
10269}
10270
10271/*
10272 * "reg_recording()" function
10273 */
10274 static void
10275f_reg_recording(typval_T *argvars UNUSED, typval_T *rettv)
10276{
10277 return_register(reg_recording, rettv);
10278}
10279
Bram Moolenaar7416f3e2017-03-18 18:10:13 +010010280/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010281 * "rename({from}, {to})" function
10282 */
10283 static void
10284f_rename(typval_T *argvars, typval_T *rettv)
10285{
10286 char_u buf[NUMBUFLEN];
10287
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010288 rettv->vval.v_number = -1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010289 if (check_restricted() || check_secure())
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010290 return;
10291
10292 if (in_vim9script()
10293 && (check_for_string_arg(argvars, 0) == FAIL
10294 || check_for_string_arg(argvars, 1) == FAIL))
10295 return;
10296
10297 rettv->vval.v_number = vim_rename(tv_get_string(&argvars[0]),
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010298 tv_get_string_buf(&argvars[1], buf));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010299}
10300
10301/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010302 * Repeat the list "l" "n" times and set "rettv" to the new list.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010303 */
10304 static void
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010305repeat_list(list_T *l, int n, typval_T *rettv)
10306{
10307 if (rettv_list_alloc(rettv) == FAIL
10308 || l == NULL
10309 || n <= 0)
10310 return;
10311
10312 while (n-- > 0)
10313 if (list_extend(rettv->vval.v_list, l, NULL) == FAIL)
10314 break;
10315}
10316
10317/*
10318 * Repeat the blob "b" "n" times and set "rettv" to the new blob.
10319 */
10320 static void
10321repeat_blob(typval_T *blob_tv, int n, typval_T *rettv)
10322{
10323 int slen;
10324 int len;
10325 int i;
10326 blob_T *blob = blob_tv->vval.v_blob;
10327
10328 if (rettv_blob_alloc(rettv) == FAIL
10329 || blob == NULL
10330 || n <= 0)
10331 return;
10332
10333 slen = blob->bv_ga.ga_len;
10334 len = (int)slen * n;
10335 if (len <= 0)
10336 return;
10337
10338 if (ga_grow(&rettv->vval.v_blob->bv_ga, len) == FAIL)
10339 return;
10340
10341 rettv->vval.v_blob->bv_ga.ga_len = len;
10342
10343 for (i = 0; i < slen; ++i)
10344 if (blob_get(blob, i) != 0)
10345 break;
10346
10347 if (i == slen)
10348 // No need to copy since all bytes are already zero
10349 return;
10350
10351 for (i = 0; i < n; ++i)
10352 blob_set_range(rettv->vval.v_blob,
10353 (long)i * slen, ((long)i + 1) * slen - 1, blob_tv);
10354}
10355
10356/*
10357 * Repeat the string "str" "n" times and set "rettv" to the new string.
10358 */
10359 static void
10360repeat_string(typval_T *str_tv, int n, typval_T *rettv)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010361{
10362 char_u *p;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010363 int slen;
10364 int len;
10365 char_u *r;
10366 int i;
10367
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010368 p = tv_get_string(str_tv);
10369 rettv->v_type = VAR_STRING;
10370 rettv->vval.v_string = NULL;
10371
10372 slen = (int)STRLEN(p);
10373 len = slen * n;
10374 if (len <= 0)
10375 return;
10376
10377 r = alloc(len + 1);
10378 if (r == NULL)
10379 return;
10380
10381 for (i = 0; i < n; i++)
10382 mch_memmove(r + i * slen, p, (size_t)slen);
10383 r[len] = NUL;
10384
10385 rettv->vval.v_string = r;
10386}
10387
10388/*
10389 * "repeat()" function
10390 */
10391 static void
10392f_repeat(typval_T *argvars, typval_T *rettv)
10393{
10394 varnumber_T n;
10395
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +020010396 if (in_vim9script()
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010397 && (check_for_repeat_func_arg(argvars, 0) == FAIL
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010398 || check_for_number_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +020010399 return;
10400
Bakudankun375141e2022-09-09 18:46:47 +010010401 n = tv_get_number(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010402 if (argvars[0].v_type == VAR_LIST)
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010403 repeat_list(argvars[0].vval.v_list, n, rettv);
10404 else if (argvars[0].v_type == VAR_TUPLE)
10405 tuple_repeat(argvars[0].vval.v_tuple, n, rettv);
Bakudankun375141e2022-09-09 18:46:47 +010010406 else if (argvars[0].v_type == VAR_BLOB)
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010407 repeat_blob(&argvars[0], n, rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010408 else
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010409 repeat_string(&argvars[0], n, rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010410}
10411
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010412#define SP_NOMOVE 0x01 // don't move cursor
10413#define SP_REPEAT 0x02 // repeat to find outer pair
10414#define SP_RETCOUNT 0x04 // return matchcount
10415#define SP_SETPCMARK 0x08 // set previous context mark
10416#define SP_START 0x10 // accept match at start position
10417#define SP_SUBPAT 0x20 // return nr of matching sub-pattern
10418#define SP_END 0x40 // leave cursor at end of match
10419#define SP_COLUMN 0x80 // start at cursor column
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010420
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010421/*
10422 * Get flags for a search function.
10423 * Possibly sets "p_ws".
10424 * Returns BACKWARD, FORWARD or zero (for an error).
10425 */
10426 static int
10427get_search_arg(typval_T *varp, int *flagsp)
10428{
10429 int dir = FORWARD;
10430 char_u *flags;
10431 char_u nbuf[NUMBUFLEN];
10432 int mask;
10433
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010434 if (varp->v_type == VAR_UNKNOWN)
10435 return FORWARD;
10436
10437 flags = tv_get_string_buf_chk(varp, nbuf);
10438 if (flags == NULL)
10439 return 0; // type error; errmsg already given
10440 while (*flags != NUL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010441 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010442 switch (*flags)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010443 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010444 case 'b': dir = BACKWARD; break;
10445 case 'w': p_ws = TRUE; break;
10446 case 'W': p_ws = FALSE; break;
10447 default: mask = 0;
10448 if (flagsp != NULL)
10449 switch (*flags)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010450 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010451 case 'c': mask = SP_START; break;
10452 case 'e': mask = SP_END; break;
10453 case 'm': mask = SP_RETCOUNT; break;
10454 case 'n': mask = SP_NOMOVE; break;
10455 case 'p': mask = SP_SUBPAT; break;
10456 case 'r': mask = SP_REPEAT; break;
10457 case 's': mask = SP_SETPCMARK; break;
10458 case 'z': mask = SP_COLUMN; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010459 }
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010460 if (mask == 0)
10461 {
10462 semsg(_(e_invalid_argument_str), flags);
10463 dir = 0;
10464 }
10465 else
10466 *flagsp |= mask;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010467 }
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010468 if (dir == 0)
10469 break;
10470 ++flags;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010471 }
10472 return dir;
10473}
10474
10475/*
10476 * Shared by search() and searchpos() functions.
10477 */
10478 static int
10479search_cmn(typval_T *argvars, pos_T *match_pos, int *flagsp)
10480{
10481 int flags;
10482 char_u *pat;
John Marriott8c85a2a2024-05-20 19:18:26 +020010483 size_t patlen;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010484 pos_T pos;
10485 pos_T save_cursor;
10486 int save_p_ws = p_ws;
10487 int dir;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010488 int retval = 0; // default: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010489 long lnum_stop = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010490#ifdef FEAT_RELTIME
10491 long time_limit = 0;
10492#endif
10493 int options = SEARCH_KEEP;
10494 int subpatnum;
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010495 searchit_arg_T sia;
Bram Moolenaara9c01042020-06-07 14:50:50 +020010496 int use_skip = FALSE;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010497 pos_T firstpos;
10498
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +020010499 if (in_vim9script()
10500 && (check_for_string_arg(argvars, 0) == FAIL
10501 || check_for_opt_string_arg(argvars, 1) == FAIL
10502 || (argvars[1].v_type != VAR_UNKNOWN
10503 && (check_for_opt_number_arg(argvars, 2) == FAIL
10504 || (argvars[2].v_type != VAR_UNKNOWN
10505 && check_for_opt_number_arg(argvars, 3) == FAIL)))))
10506 goto theend;
10507
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010508 pat = tv_get_string(&argvars[0]);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010509 dir = get_search_arg(&argvars[1], flagsp); // may set p_ws
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010510 if (dir == 0)
10511 goto theend;
10512 flags = *flagsp;
10513 if (flags & SP_START)
10514 options |= SEARCH_START;
10515 if (flags & SP_END)
10516 options |= SEARCH_END;
10517 if (flags & SP_COLUMN)
10518 options |= SEARCH_COL;
10519
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010520 // Optional arguments: line number to stop searching, timeout and skip.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010521 if (argvars[1].v_type != VAR_UNKNOWN && argvars[2].v_type != VAR_UNKNOWN)
10522 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010523 lnum_stop = (long)tv_get_number_chk(&argvars[2], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010524 if (lnum_stop < 0)
10525 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010526 if (argvars[3].v_type != VAR_UNKNOWN)
10527 {
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010528#ifdef FEAT_RELTIME
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010529 time_limit = (long)tv_get_number_chk(&argvars[3], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010530 if (time_limit < 0)
10531 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010532#endif
Bram Moolenaara9c01042020-06-07 14:50:50 +020010533 use_skip = eval_expr_valid_arg(&argvars[4]);
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010534 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010535 }
10536
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010537 /*
10538 * This function does not accept SP_REPEAT and SP_RETCOUNT flags.
10539 * Check to make sure only those flags are set.
10540 * Also, Only the SP_NOMOVE or the SP_SETPCMARK flag can be set. Both
10541 * flags cannot be set. Check for that condition also.
10542 */
10543 if (((flags & (SP_REPEAT | SP_RETCOUNT)) != 0)
10544 || ((flags & SP_NOMOVE) && (flags & SP_SETPCMARK)))
10545 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010546 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[1]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010547 goto theend;
10548 }
10549
10550 pos = save_cursor = curwin->w_cursor;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010551 CLEAR_FIELD(firstpos);
Bram Moolenaara80faa82020-04-12 19:37:17 +020010552 CLEAR_FIELD(sia);
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010553 sia.sa_stop_lnum = (linenr_T)lnum_stop;
10554#ifdef FEAT_RELTIME
Paul Ollis65745772022-06-05 16:55:54 +010010555 sia.sa_tm = time_limit;
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010556#endif
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010557
John Marriott8c85a2a2024-05-20 19:18:26 +020010558 patlen = STRLEN(pat);
10559
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010560 // Repeat until {skip} returns FALSE.
10561 for (;;)
10562 {
John Marriott8c85a2a2024-05-20 19:18:26 +020010563 subpatnum = searchit(curwin, curbuf, &pos, NULL, dir, pat, patlen, 1L,
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010564 options, RE_SEARCH, &sia);
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010565 // finding the first match again means there is no match where {skip}
10566 // evaluates to zero.
10567 if (firstpos.lnum != 0 && EQUAL_POS(pos, firstpos))
10568 subpatnum = FAIL;
10569
Bram Moolenaara9c01042020-06-07 14:50:50 +020010570 if (subpatnum == FAIL || !use_skip)
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010571 // didn't find it or no skip argument
10572 break;
Bram Moolenaar3d79f0a2023-01-22 20:14:26 +000010573 if (firstpos.lnum == 0)
10574 firstpos = pos;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010575
Bram Moolenaara9c01042020-06-07 14:50:50 +020010576 // If the skip expression matches, ignore this match.
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010577 {
10578 int do_skip;
10579 int err;
10580 pos_T save_pos = curwin->w_cursor;
10581
10582 curwin->w_cursor = pos;
Bram Moolenaara9c01042020-06-07 14:50:50 +020010583 err = FALSE;
10584 do_skip = eval_expr_to_bool(&argvars[4], &err);
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010585 curwin->w_cursor = save_pos;
10586 if (err)
10587 {
10588 // Evaluating {skip} caused an error, break here.
10589 subpatnum = FAIL;
10590 break;
10591 }
10592 if (!do_skip)
10593 break;
10594 }
zeertzjq180246c2022-06-23 12:04:46 +010010595
10596 // clear the start flag to avoid getting stuck here
10597 options &= ~SEARCH_START;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010598 }
10599
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010600 if (subpatnum != FAIL)
10601 {
10602 if (flags & SP_SUBPAT)
10603 retval = subpatnum;
10604 else
10605 retval = pos.lnum;
10606 if (flags & SP_SETPCMARK)
10607 setpcmark();
10608 curwin->w_cursor = pos;
10609 if (match_pos != NULL)
10610 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010611 // Store the match cursor position
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010612 match_pos->lnum = pos.lnum;
10613 match_pos->col = pos.col + 1;
10614 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010615 // "/$" will put the cursor after the end of the line, may need to
10616 // correct that here
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010617 check_cursor();
10618 }
10619
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010620 // If 'n' flag is used: restore cursor position.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010621 if (flags & SP_NOMOVE)
10622 curwin->w_cursor = save_cursor;
10623 else
10624 curwin->w_set_curswant = TRUE;
10625theend:
10626 p_ws = save_p_ws;
10627
10628 return retval;
10629}
10630
Bram Moolenaare99be0e2019-03-26 22:51:09 +010010631#ifdef FEAT_RUBY
10632/*
10633 * "rubyeval()" function
10634 */
10635 static void
10636f_rubyeval(typval_T *argvars, typval_T *rettv)
10637{
10638 char_u *str;
10639 char_u buf[NUMBUFLEN];
10640
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010641 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
10642 return;
10643
Bram Moolenaare99be0e2019-03-26 22:51:09 +010010644 str = tv_get_string_buf(&argvars[0], buf);
10645 do_rubyeval(str, rettv);
10646}
10647#endif
10648
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010649/*
10650 * "screenattr()" function
10651 */
10652 static void
10653f_screenattr(typval_T *argvars, typval_T *rettv)
10654{
10655 int row;
10656 int col;
10657 int c;
10658
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010659 if (in_vim9script()
10660 && (check_for_number_arg(argvars, 0) == FAIL
10661 || check_for_number_arg(argvars, 1) == FAIL))
10662 return;
10663
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010664 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10665 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010666 if (row < 0 || row >= screen_Rows
10667 || col < 0 || col >= screen_Columns)
10668 c = -1;
10669 else
10670 c = ScreenAttrs[LineOffset[row] + col];
10671 rettv->vval.v_number = c;
10672}
10673
10674/*
10675 * "screenchar()" function
10676 */
10677 static void
10678f_screenchar(typval_T *argvars, typval_T *rettv)
10679{
10680 int row;
10681 int col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010682 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 Moolenaar2912abb2019-03-29 14:16:42 +010010691 if (row < 0 || row >= screen_Rows || col < 0 || col >= screen_Columns)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010692 c = -1;
10693 else
10694 {
zeertzjq47eec672023-06-01 20:26:55 +010010695 char_u buf[MB_MAXBYTES + 1];
10696 screen_getbytes(row, col, buf, NULL);
10697 c = (*mb_ptr2char)(buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010698 }
10699 rettv->vval.v_number = c;
10700}
10701
10702/*
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010703 * "screenchars()" function
10704 */
10705 static void
10706f_screenchars(typval_T *argvars, typval_T *rettv)
10707{
10708 int row;
10709 int col;
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010710 int c;
10711 int i;
10712
10713 if (rettv_list_alloc(rettv) == FAIL)
10714 return;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010715
10716 if (in_vim9script()
10717 && (check_for_number_arg(argvars, 0) == FAIL
10718 || check_for_number_arg(argvars, 1) == FAIL))
10719 return;
10720
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010721 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10722 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
10723 if (row < 0 || row >= screen_Rows || col < 0 || col >= screen_Columns)
10724 return;
10725
zeertzjq47eec672023-06-01 20:26:55 +010010726 char_u buf[MB_MAXBYTES + 1];
10727 screen_getbytes(row, col, buf, NULL);
10728 int pcc[MAX_MCO];
10729 if (enc_utf8)
10730 c = utfc_ptr2char(buf, pcc);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010731 else
zeertzjq47eec672023-06-01 20:26:55 +010010732 c = (*mb_ptr2char)(buf);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010733 list_append_number(rettv->vval.v_list, (varnumber_T)c);
10734
10735 if (enc_utf8)
zeertzjq47eec672023-06-01 20:26:55 +010010736 for (i = 0; i < Screen_mco && pcc[i] != 0; ++i)
10737 list_append_number(rettv->vval.v_list, (varnumber_T)pcc[i]);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010738}
10739
10740/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010741 * "screencol()" function
10742 *
10743 * First column is 1 to be consistent with virtcol().
10744 */
10745 static void
10746f_screencol(typval_T *argvars UNUSED, typval_T *rettv)
10747{
10748 rettv->vval.v_number = screen_screencol() + 1;
10749}
10750
10751/*
10752 * "screenrow()" function
10753 */
10754 static void
10755f_screenrow(typval_T *argvars UNUSED, typval_T *rettv)
10756{
10757 rettv->vval.v_number = screen_screenrow() + 1;
10758}
10759
10760/*
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010761 * "screenstring()" function
10762 */
10763 static void
10764f_screenstring(typval_T *argvars, typval_T *rettv)
10765{
10766 int row;
10767 int col;
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010768 char_u buf[MB_MAXBYTES + 1];
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010769
10770 rettv->vval.v_string = NULL;
10771 rettv->v_type = VAR_STRING;
10772
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010773 if (in_vim9script()
10774 && (check_for_number_arg(argvars, 0) == FAIL
10775 || check_for_number_arg(argvars, 1) == FAIL))
10776 return;
10777
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010778 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10779 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
10780 if (row < 0 || row >= screen_Rows || col < 0 || col >= screen_Columns)
10781 return;
10782
zeertzjq47eec672023-06-01 20:26:55 +010010783 screen_getbytes(row, col, buf, NULL);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010784 rettv->vval.v_string = vim_strsave(buf);
10785}
10786
10787/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010788 * "search()" function
10789 */
10790 static void
10791f_search(typval_T *argvars, typval_T *rettv)
10792{
10793 int flags = 0;
10794
10795 rettv->vval.v_number = search_cmn(argvars, NULL, &flags);
10796}
10797
10798/*
10799 * "searchdecl()" function
10800 */
10801 static void
10802f_searchdecl(typval_T *argvars, typval_T *rettv)
10803{
Bram Moolenaar30788d32020-09-05 21:35:16 +020010804 int locally = TRUE;
10805 int thisblock = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010806 int error = FALSE;
10807 char_u *name;
10808
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010809 rettv->vval.v_number = 1; // default: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010810
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020010811 if (in_vim9script()
10812 && (check_for_string_arg(argvars, 0) == FAIL
10813 || check_for_opt_bool_arg(argvars, 1) == FAIL
10814 || (argvars[1].v_type != VAR_UNKNOWN
10815 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
10816 return;
10817
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010818 name = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010819 if (argvars[1].v_type != VAR_UNKNOWN)
10820 {
Bram Moolenaar30788d32020-09-05 21:35:16 +020010821 locally = !(int)tv_get_bool_chk(&argvars[1], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010822 if (!error && argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar30788d32020-09-05 21:35:16 +020010823 thisblock = (int)tv_get_bool_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010824 }
10825 if (!error && name != NULL)
10826 rettv->vval.v_number = find_decl(name, (int)STRLEN(name),
10827 locally, thisblock, SEARCH_KEEP) == FAIL;
10828}
10829
10830/*
10831 * Used by searchpair() and searchpairpos()
10832 */
10833 static int
10834searchpair_cmn(typval_T *argvars, pos_T *match_pos)
10835{
10836 char_u *spat, *mpat, *epat;
Bram Moolenaar48570482017-10-30 21:48:41 +010010837 typval_T *skip;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010838 int save_p_ws = p_ws;
10839 int dir;
10840 int flags = 0;
10841 char_u nbuf1[NUMBUFLEN];
10842 char_u nbuf2[NUMBUFLEN];
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010843 int retval = 0; // default: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010844 long lnum_stop = 0;
10845 long time_limit = 0;
10846
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +020010847 if (in_vim9script()
10848 && (check_for_string_arg(argvars, 0) == FAIL
10849 || check_for_string_arg(argvars, 1) == FAIL
10850 || check_for_string_arg(argvars, 2) == FAIL
10851 || check_for_opt_string_arg(argvars, 3) == FAIL
10852 || (argvars[3].v_type != VAR_UNKNOWN
10853 && argvars[4].v_type != VAR_UNKNOWN
10854 && (check_for_opt_number_arg(argvars, 5) == FAIL
10855 || (argvars[5].v_type != VAR_UNKNOWN
10856 && check_for_opt_number_arg(argvars, 6) == FAIL)))))
10857 goto theend;
10858
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010859 // Get the three pattern arguments: start, middle, end. Will result in an
10860 // error if not a valid argument.
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010861 spat = tv_get_string_chk(&argvars[0]);
10862 mpat = tv_get_string_buf_chk(&argvars[1], nbuf1);
10863 epat = tv_get_string_buf_chk(&argvars[2], nbuf2);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010864 if (spat == NULL || mpat == NULL || epat == NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010865 goto theend; // type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010866
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010867 // Handle the optional fourth argument: flags
10868 dir = get_search_arg(&argvars[3], &flags); // may set p_ws
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010869 if (dir == 0)
10870 goto theend;
10871
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010872 // Don't accept SP_END or SP_SUBPAT.
10873 // Only one of the SP_NOMOVE or SP_SETPCMARK flags can be set.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010874 if ((flags & (SP_END | SP_SUBPAT)) != 0
10875 || ((flags & SP_NOMOVE) && (flags & SP_SETPCMARK)))
10876 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010877 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[3]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010878 goto theend;
10879 }
10880
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010881 // Using 'r' implies 'W', otherwise it doesn't work.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010882 if (flags & SP_REPEAT)
10883 p_ws = FALSE;
10884
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010885 // Optional fifth argument: skip expression
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010886 if (argvars[3].v_type == VAR_UNKNOWN
10887 || argvars[4].v_type == VAR_UNKNOWN)
Bram Moolenaar48570482017-10-30 21:48:41 +010010888 skip = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010889 else
10890 {
Bram Moolenaara9c01042020-06-07 14:50:50 +020010891 // Type is checked later.
Bram Moolenaar48570482017-10-30 21:48:41 +010010892 skip = &argvars[4];
Bram Moolenaara9c01042020-06-07 14:50:50 +020010893
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010894 if (argvars[5].v_type != VAR_UNKNOWN)
10895 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010896 lnum_stop = (long)tv_get_number_chk(&argvars[5], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010897 if (lnum_stop < 0)
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010898 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010899 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[5]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010900 goto theend;
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010901 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010902#ifdef FEAT_RELTIME
10903 if (argvars[6].v_type != VAR_UNKNOWN)
10904 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010905 time_limit = (long)tv_get_number_chk(&argvars[6], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010906 if (time_limit < 0)
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010907 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010908 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[6]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010909 goto theend;
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010910 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010911 }
10912#endif
10913 }
10914 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010915
10916 retval = do_searchpair(spat, mpat, epat, dir, skip, flags,
10917 match_pos, lnum_stop, time_limit);
10918
10919theend:
10920 p_ws = save_p_ws;
10921
10922 return retval;
10923}
10924
10925/*
10926 * "searchpair()" function
10927 */
10928 static void
10929f_searchpair(typval_T *argvars, typval_T *rettv)
10930{
10931 rettv->vval.v_number = searchpair_cmn(argvars, NULL);
10932}
10933
10934/*
10935 * "searchpairpos()" function
10936 */
10937 static void
10938f_searchpairpos(typval_T *argvars, typval_T *rettv)
10939{
10940 pos_T match_pos;
10941 int lnum = 0;
10942 int col = 0;
10943
10944 if (rettv_list_alloc(rettv) == FAIL)
10945 return;
10946
10947 if (searchpair_cmn(argvars, &match_pos) > 0)
10948 {
10949 lnum = match_pos.lnum;
10950 col = match_pos.col;
10951 }
10952
10953 list_append_number(rettv->vval.v_list, (varnumber_T)lnum);
10954 list_append_number(rettv->vval.v_list, (varnumber_T)col);
10955}
10956
10957/*
10958 * Search for a start/middle/end thing.
10959 * Used by searchpair(), see its documentation for the details.
10960 * Returns 0 or -1 for no match,
10961 */
10962 long
10963do_searchpair(
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010964 char_u *spat, // start pattern
10965 char_u *mpat, // middle pattern
10966 char_u *epat, // end pattern
10967 int dir, // BACKWARD or FORWARD
10968 typval_T *skip, // skip expression
10969 int flags, // SP_SETPCMARK and other SP_ values
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010970 pos_T *match_pos,
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010971 linenr_T lnum_stop, // stop at this line if not zero
10972 long time_limit UNUSED) // stop after this many msec
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010973{
10974 char_u *save_cpo;
10975 char_u *pat, *pat2 = NULL, *pat3 = NULL;
John Marriott8c85a2a2024-05-20 19:18:26 +020010976 size_t patlen;
10977 size_t spatlen;
10978 size_t epatlen;
10979 size_t pat2size;
10980 size_t pat2len;
10981 size_t pat3size;
10982 size_t pat3len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010983 long retval = 0;
10984 pos_T pos;
10985 pos_T firstpos;
10986 pos_T foundpos;
10987 pos_T save_cursor;
10988 pos_T save_pos;
10989 int n;
10990 int r;
10991 int nest = 1;
Bram Moolenaar48570482017-10-30 21:48:41 +010010992 int use_skip = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010993 int err;
10994 int options = SEARCH_KEEP;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010995
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010996 // Make 'cpoptions' empty, the 'l' flag should not be used here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010997 save_cpo = p_cpo;
10998 p_cpo = empty_option;
10999
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011000 // Make two search patterns: start/end (pat2, for in nested pairs) and
11001 // start/middle/end (pat3, for the top pair).
John Marriott8c85a2a2024-05-20 19:18:26 +020011002 spatlen = STRLEN(spat);
11003 epatlen = STRLEN(epat);
11004 pat2size = spatlen + epatlen + 17;
11005 pat2 = alloc(pat2size);
11006 if (pat2 == NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011007 goto theend;
John Marriott8c85a2a2024-05-20 19:18:26 +020011008 pat3size = spatlen + STRLEN(mpat) + epatlen + 25;
11009 pat3 = alloc(pat3size);
11010 if (pat3 == NULL)
11011 goto theend;
11012 pat2len = vim_snprintf((char *)pat2, pat2size, "\\m\\(%s\\m\\)\\|\\(%s\\m\\)", spat, epat);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011013 if (*mpat == NUL)
John Marriott8c85a2a2024-05-20 19:18:26 +020011014 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011015 STRCPY(pat3, pat2);
John Marriott8c85a2a2024-05-20 19:18:26 +020011016 pat3len = pat2len;
11017 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011018 else
John Marriott8c85a2a2024-05-20 19:18:26 +020011019 pat3len = vim_snprintf((char *)pat3, pat3size, "\\m\\(%s\\m\\)\\|\\(%s\\m\\)\\|\\(%s\\m\\)",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011020 spat, epat, mpat);
11021 if (flags & SP_START)
11022 options |= SEARCH_START;
11023
Bram Moolenaar48570482017-10-30 21:48:41 +010011024 if (skip != NULL)
Bram Moolenaara9c01042020-06-07 14:50:50 +020011025 use_skip = eval_expr_valid_arg(skip);
Bram Moolenaar48570482017-10-30 21:48:41 +010011026
Bram Moolenaar5ea38d12022-06-16 21:20:48 +010011027#ifdef FEAT_RELTIME
11028 if (time_limit > 0)
11029 init_regexp_timeout(time_limit);
11030#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011031 save_cursor = curwin->w_cursor;
11032 pos = curwin->w_cursor;
Bram Moolenaarb5aedf32017-03-12 18:23:53 +010011033 CLEAR_POS(&firstpos);
11034 CLEAR_POS(&foundpos);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011035 pat = pat3;
John Marriott8c85a2a2024-05-20 19:18:26 +020011036 patlen = pat3len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011037 for (;;)
11038 {
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020011039 searchit_arg_T sia;
11040
Bram Moolenaara80faa82020-04-12 19:37:17 +020011041 CLEAR_FIELD(sia);
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020011042 sia.sa_stop_lnum = lnum_stop;
John Marriott8c85a2a2024-05-20 19:18:26 +020011043 n = searchit(curwin, curbuf, &pos, NULL, dir, pat, patlen, 1L,
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020011044 options, RE_SEARCH, &sia);
Bram Moolenaarb5aedf32017-03-12 18:23:53 +010011045 if (n == FAIL || (firstpos.lnum != 0 && EQUAL_POS(pos, firstpos)))
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011046 // didn't find it or found the first match again: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011047 break;
11048
11049 if (firstpos.lnum == 0)
11050 firstpos = pos;
Bram Moolenaarb5aedf32017-03-12 18:23:53 +010011051 if (EQUAL_POS(pos, foundpos))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011052 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011053 // Found the same position again. Can happen with a pattern that
11054 // has "\zs" at the end and searching backwards. Advance one
11055 // character and try again.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011056 if (dir == BACKWARD)
11057 decl(&pos);
11058 else
11059 incl(&pos);
11060 }
11061 foundpos = pos;
11062
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011063 // clear the start flag to avoid getting stuck here
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011064 options &= ~SEARCH_START;
11065
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011066 // If the skip pattern matches, ignore this match.
Bram Moolenaar48570482017-10-30 21:48:41 +010011067 if (use_skip)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011068 {
11069 save_pos = curwin->w_cursor;
11070 curwin->w_cursor = pos;
Bram Moolenaar48570482017-10-30 21:48:41 +010011071 err = FALSE;
11072 r = eval_expr_to_bool(skip, &err);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011073 curwin->w_cursor = save_pos;
11074 if (err)
11075 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011076 // Evaluating {skip} caused an error, break here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011077 curwin->w_cursor = save_cursor;
11078 retval = -1;
11079 break;
11080 }
11081 if (r)
11082 continue;
11083 }
11084
11085 if ((dir == BACKWARD && n == 3) || (dir == FORWARD && n == 2))
11086 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011087 // Found end when searching backwards or start when searching
11088 // forward: nested pair.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011089 ++nest;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011090 pat = pat2; // nested, don't search for middle
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011091 }
11092 else
11093 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011094 // Found end when searching forward or start when searching
11095 // backward: end of (nested) pair; or found middle in outer pair.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011096 if (--nest == 1)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011097 pat = pat3; // outer level, search for middle
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011098 }
11099
11100 if (nest == 0)
11101 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011102 // Found the match: return matchcount or line number.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011103 if (flags & SP_RETCOUNT)
11104 ++retval;
11105 else
11106 retval = pos.lnum;
11107 if (flags & SP_SETPCMARK)
11108 setpcmark();
11109 curwin->w_cursor = pos;
11110 if (!(flags & SP_REPEAT))
11111 break;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011112 nest = 1; // search for next unmatched
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011113 }
11114 }
11115
11116 if (match_pos != NULL)
11117 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011118 // Store the match cursor position
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011119 match_pos->lnum = curwin->w_cursor.lnum;
11120 match_pos->col = curwin->w_cursor.col + 1;
11121 }
11122
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011123 // If 'n' flag is used or search failed: restore cursor position.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011124 if ((flags & SP_NOMOVE) || retval == 0)
11125 curwin->w_cursor = save_cursor;
11126
11127theend:
Bram Moolenaar5ea38d12022-06-16 21:20:48 +010011128#ifdef FEAT_RELTIME
Bram Moolenaar0f618382022-08-26 21:33:04 +010011129 if (time_limit > 0)
11130 disable_regexp_timeout();
Bram Moolenaar5ea38d12022-06-16 21:20:48 +010011131#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011132 vim_free(pat2);
11133 vim_free(pat3);
11134 if (p_cpo == empty_option)
11135 p_cpo = save_cpo;
11136 else
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010011137 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011138 // Darn, evaluating the {skip} expression changed the value.
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010011139 // If it's still empty it was changed and restored, need to restore in
11140 // the complicated way.
11141 if (*p_cpo == NUL)
Bram Moolenaar31e5c602022-04-15 13:53:33 +010011142 set_option_value_give_err((char_u *)"cpo", 0L, save_cpo, 0);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011143 free_string_option(save_cpo);
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010011144 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011145
11146 return retval;
11147}
11148
11149/*
11150 * "searchpos()" function
11151 */
11152 static void
11153f_searchpos(typval_T *argvars, typval_T *rettv)
11154{
11155 pos_T match_pos;
11156 int lnum = 0;
11157 int col = 0;
11158 int n;
11159 int flags = 0;
11160
11161 if (rettv_list_alloc(rettv) == FAIL)
11162 return;
11163
11164 n = search_cmn(argvars, &match_pos, &flags);
11165 if (n > 0)
11166 {
11167 lnum = match_pos.lnum;
11168 col = match_pos.col;
11169 }
11170
11171 list_append_number(rettv->vval.v_list, (varnumber_T)lnum);
11172 list_append_number(rettv->vval.v_list, (varnumber_T)col);
11173 if (flags & SP_SUBPAT)
11174 list_append_number(rettv->vval.v_list, (varnumber_T)n);
11175}
11176
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011177/*
11178 * Set the cursor or mark position.
zeertzjq47eec672023-06-01 20:26:55 +010011179 * If "charpos" is TRUE, then use the column number as a character offset.
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011180 * Otherwise use the column number as a byte offset.
11181 */
11182 static void
11183set_position(typval_T *argvars, typval_T *rettv, int charpos)
11184{
11185 pos_T pos;
11186 int fnum;
11187 char_u *name;
11188 colnr_T curswant = -1;
11189
11190 rettv->vval.v_number = -1;
11191
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011192 if (in_vim9script()
11193 && (check_for_string_arg(argvars, 0) == FAIL
11194 || check_for_list_arg(argvars, 1) == FAIL))
11195 return;
11196
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011197 name = tv_get_string_chk(argvars);
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011198 if (name == NULL)
11199 return;
11200
11201 if (list2fpos(&argvars[1], &pos, &fnum, &curswant, charpos) != OK)
11202 return;
11203
11204 if (pos.col != MAXCOL && --pos.col < 0)
11205 pos.col = 0;
11206 if ((name[0] == '.' && name[1] == NUL))
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011207 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011208 // set cursor; "fnum" is ignored
11209 curwin->w_cursor = pos;
11210 if (curswant >= 0)
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011211 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011212 curwin->w_curswant = curswant - 1;
11213 curwin->w_set_curswant = FALSE;
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011214 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011215 check_cursor();
11216 rettv->vval.v_number = 0;
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011217 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011218 else if (name[0] == '\'' && name[1] != NUL && name[2] == NUL)
11219 {
11220 // set mark
11221 if (setmark_pos(name[1], &pos, fnum) == OK)
11222 rettv->vval.v_number = 0;
11223 }
11224 else
11225 emsg(_(e_invalid_argument));
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011226}
11227/*
11228 * "setcharpos()" function
11229 */
11230 static void
11231f_setcharpos(typval_T *argvars, typval_T *rettv)
11232{
11233 set_position(argvars, rettv, TRUE);
11234}
11235
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011236 static void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011237f_setcharsearch(typval_T *argvars, typval_T *rettv UNUSED)
11238{
11239 dict_T *d;
11240 dictitem_T *di;
11241 char_u *csearch;
11242
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +010011243 if (check_for_dict_arg(argvars, 0) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011244 return;
11245
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011246 if ((d = argvars[0].vval.v_dict) == NULL)
11247 return;
11248
11249 csearch = dict_get_string(d, "char", FALSE);
11250 if (csearch != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011251 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011252 if (enc_utf8)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011253 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011254 int pcc[MAX_MCO];
11255 int c = utfc_ptr2char(csearch, pcc);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011256
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011257 set_last_csearch(c, csearch, utfc_ptr2len(csearch));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011258 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011259 else
11260 set_last_csearch(PTR2CHAR(csearch),
11261 csearch, mb_ptr2len(csearch));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011262 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011263
11264 di = dict_find(d, (char_u *)"forward", -1);
11265 if (di != NULL)
11266 set_csearch_direction((int)tv_get_number(&di->di_tv)
11267 ? FORWARD : BACKWARD);
11268
11269 di = dict_find(d, (char_u *)"until", -1);
11270 if (di != NULL)
11271 set_csearch_until(!!tv_get_number(&di->di_tv));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011272}
11273
11274/*
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011275 * "setcursorcharpos" function
11276 */
11277 static void
Bram Moolenaar3af15ab2021-01-17 16:16:23 +010011278f_setcursorcharpos(typval_T *argvars, typval_T *rettv)
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011279{
11280 set_cursorpos(argvars, rettv, TRUE);
11281}
11282
11283/*
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011284 * "setenv()" function
11285 */
11286 static void
11287f_setenv(typval_T *argvars, typval_T *rettv UNUSED)
11288{
11289 char_u namebuf[NUMBUFLEN];
11290 char_u valbuf[NUMBUFLEN];
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020011291 char_u *name;
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011292
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020011293 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11294 return;
11295
zeertzjqfcaeb3d2023-11-28 20:46:29 +010011296 // setting an environment variable may be dangerous, e.g. you could
Christian Brabandt6b89dd62023-10-26 22:14:17 +020011297 // setenv GCONV_PATH=/tmp and then have iconv() unexpectedly call
11298 // a shell command using some shared library:
11299 if (check_restricted() || check_secure())
11300 return;
11301
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020011302 name = tv_get_string_buf(&argvars[0], namebuf);
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011303 if (argvars[1].v_type == VAR_SPECIAL
11304 && argvars[1].vval.v_number == VVAL_NULL)
LemonBoy77142312022-04-15 20:50:46 +010011305 vim_unsetenv_ext(name);
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011306 else
LemonBoy77142312022-04-15 20:50:46 +010011307 vim_setenv_ext(name, tv_get_string_buf(&argvars[1], valbuf));
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011308}
11309
11310/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011311 * "setfperm({fname}, {mode})" function
11312 */
11313 static void
11314f_setfperm(typval_T *argvars, typval_T *rettv)
11315{
11316 char_u *fname;
11317 char_u modebuf[NUMBUFLEN];
11318 char_u *mode_str;
11319 int i;
11320 int mask;
11321 int mode = 0;
11322
11323 rettv->vval.v_number = 0;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011324
11325 if (in_vim9script()
11326 && (check_for_string_arg(argvars, 0) == FAIL
11327 || check_for_string_arg(argvars, 1) == FAIL))
11328 return;
11329
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011330 fname = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011331 if (fname == NULL)
11332 return;
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011333 mode_str = tv_get_string_buf_chk(&argvars[1], modebuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011334 if (mode_str == NULL)
11335 return;
11336 if (STRLEN(mode_str) != 9)
11337 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000011338 semsg(_(e_invalid_argument_str), mode_str);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011339 return;
11340 }
11341
11342 mask = 1;
11343 for (i = 8; i >= 0; --i)
11344 {
11345 if (mode_str[i] != '-')
11346 mode |= mask;
11347 mask = mask << 1;
11348 }
11349 rettv->vval.v_number = mch_setperm(fname, mode) == OK;
11350}
11351
11352/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011353 * "setpos()" function
11354 */
11355 static void
11356f_setpos(typval_T *argvars, typval_T *rettv)
11357{
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011358 set_position(argvars, rettv, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011359}
11360
11361/*
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011362 * Translate a register type string to the yank type and block length
11363 */
11364 static int
11365get_yank_type(char_u **pp, char_u *yank_type, long *block_len)
11366{
11367 char_u *stropt = *pp;
11368 switch (*stropt)
11369 {
11370 case 'v': case 'c': // character-wise selection
11371 *yank_type = MCHAR;
11372 break;
11373 case 'V': case 'l': // line-wise selection
11374 *yank_type = MLINE;
11375 break;
11376 case 'b': case Ctrl_V: // block-wise selection
11377 *yank_type = MBLOCK;
11378 if (VIM_ISDIGIT(stropt[1]))
11379 {
11380 ++stropt;
11381 *block_len = getdigits(&stropt) - 1;
11382 --stropt;
11383 }
11384 break;
11385 default:
11386 return FAIL;
11387 }
11388 *pp = stropt;
11389 return OK;
11390}
11391
11392/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011393 * "setreg()" function
11394 */
11395 static void
11396f_setreg(typval_T *argvars, typval_T *rettv)
11397{
11398 int regname;
11399 char_u *strregname;
11400 char_u *stropt;
11401 char_u *strval;
11402 int append;
11403 char_u yank_type;
11404 long block_len;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011405 typval_T *regcontents;
11406 int pointreg;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011407
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020011408 if (in_vim9script()
11409 && (check_for_string_arg(argvars, 0) == FAIL
11410 || check_for_opt_string_arg(argvars, 2) == FAIL))
11411 return;
11412
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011413 pointreg = 0;
11414 regcontents = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011415 block_len = -1;
11416 yank_type = MAUTO;
11417 append = FALSE;
11418
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011419 strregname = tv_get_string_chk(argvars);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011420 rettv->vval.v_number = 1; // FAIL is default
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011421
11422 if (strregname == NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011423 return; // type error; errmsg already given
Bram Moolenaar418a29f2021-02-10 22:23:41 +010011424 if (in_vim9script() && STRLEN(strregname) > 1)
11425 {
11426 semsg(_(e_register_name_must_be_one_char_str), strregname);
11427 return;
11428 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011429 regname = *strregname;
11430 if (regname == 0 || regname == '@')
11431 regname = '"';
11432
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011433 if (argvars[1].v_type == VAR_DICT)
11434 {
11435 dict_T *d = argvars[1].vval.v_dict;
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011436 dictitem_T *di;
11437
11438 if (d == NULL || d->dv_hashtab.ht_used == 0)
11439 {
11440 // Empty dict, clear the register (like setreg(0, []))
11441 char_u *lstval[2] = {NULL, NULL};
11442 write_reg_contents_lst(regname, lstval, 0, FALSE, MAUTO, -1);
11443 return;
11444 }
11445
11446 di = dict_find(d, (char_u *)"regcontents", -1);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011447 if (di != NULL)
11448 regcontents = &di->di_tv;
11449
Bram Moolenaard61efa52022-07-23 09:52:04 +010011450 stropt = dict_get_string(d, "regtype", FALSE);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011451 if (stropt != NULL)
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011452 {
11453 int ret = get_yank_type(&stropt, &yank_type, &block_len);
11454
11455 if (ret == FAIL || *++stropt != NUL)
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011456 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000011457 semsg(_(e_invalid_value_for_argument_str), "value");
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011458 return;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011459 }
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011460 }
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011461
11462 if (regname == '"')
11463 {
Bram Moolenaard61efa52022-07-23 09:52:04 +010011464 stropt = dict_get_string(d, "points_to", FALSE);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011465 if (stropt != NULL)
11466 {
11467 pointreg = *stropt;
11468 regname = pointreg;
11469 }
11470 }
Bram Moolenaard61efa52022-07-23 09:52:04 +010011471 else if (dict_get_bool(d, "isunnamed", -1) > 0)
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011472 pointreg = regname;
11473 }
11474 else
11475 regcontents = &argvars[1];
11476
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011477 if (argvars[2].v_type != VAR_UNKNOWN)
11478 {
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011479 if (yank_type != MAUTO)
11480 {
Bram Moolenaare1242042021-12-16 20:56:57 +000011481 semsg(_(e_too_many_arguments_for_function_str), "setreg");
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011482 return;
11483 }
11484
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011485 stropt = tv_get_string_chk(&argvars[2]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011486 if (stropt == NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011487 return; // type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011488 for (; *stropt != NUL; ++stropt)
11489 switch (*stropt)
11490 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011491 case 'a': case 'A': // append
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011492 append = TRUE;
11493 break;
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011494 default:
11495 get_yank_type(&stropt, &yank_type, &block_len);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011496 }
11497 }
11498
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011499 if (regcontents && regcontents->v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011500 {
11501 char_u **lstval;
11502 char_u **allocval;
11503 char_u buf[NUMBUFLEN];
11504 char_u **curval;
11505 char_u **curallocval;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011506 list_T *ll = regcontents->vval.v_list;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011507 listitem_T *li;
11508 int len;
11509
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011510 // If the list is NULL handle like an empty list.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011511 len = ll == NULL ? 0 : ll->lv_len;
11512
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011513 // First half: use for pointers to result lines; second half: use for
11514 // pointers to allocated copies.
Bram Moolenaarc799fe22019-05-28 23:08:19 +020011515 lstval = ALLOC_MULT(char_u *, (len + 1) * 2);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011516 if (lstval == NULL)
11517 return;
11518 curval = lstval;
11519 allocval = lstval + len + 2;
11520 curallocval = allocval;
11521
Bram Moolenaar50985eb2020-01-27 22:09:39 +010011522 if (ll != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011523 {
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020011524 CHECK_LIST_MATERIALIZE(ll);
Bram Moolenaar00d253e2020-04-06 22:13:01 +020011525 FOR_ALL_LIST_ITEMS(ll, li)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011526 {
Bram Moolenaar50985eb2020-01-27 22:09:39 +010011527 strval = tv_get_string_buf_chk(&li->li_tv, buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011528 if (strval == NULL)
11529 goto free_lstval;
Bram Moolenaar50985eb2020-01-27 22:09:39 +010011530 if (strval == buf)
11531 {
11532 // Need to make a copy, next tv_get_string_buf_chk() will
11533 // overwrite the string.
11534 strval = vim_strsave(buf);
11535 if (strval == NULL)
11536 goto free_lstval;
11537 *curallocval++ = strval;
11538 }
11539 *curval++ = strval;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011540 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011541 }
11542 *curval++ = NULL;
11543
11544 write_reg_contents_lst(regname, lstval, -1,
11545 append, yank_type, block_len);
11546free_lstval:
11547 while (curallocval > allocval)
11548 vim_free(*--curallocval);
11549 vim_free(lstval);
11550 }
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011551 else if (regcontents)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011552 {
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011553 strval = tv_get_string_chk(regcontents);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011554 if (strval == NULL)
11555 return;
11556 write_reg_contents_ex(regname, strval, -1,
11557 append, yank_type, block_len);
11558 }
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011559 if (pointreg != 0)
11560 get_yank_register(pointreg, TRUE);
11561
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011562 rettv->vval.v_number = 0;
11563}
11564
11565/*
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011566 * "settagstack()" function
11567 */
11568 static void
11569f_settagstack(typval_T *argvars, typval_T *rettv)
11570{
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011571 win_T *wp;
11572 dict_T *d;
11573 int action = 'r';
11574
11575 rettv->vval.v_number = -1;
11576
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011577 if (in_vim9script()
11578 && (check_for_number_arg(argvars, 0) == FAIL
11579 || check_for_dict_arg(argvars, 1) == FAIL
11580 || check_for_opt_string_arg(argvars, 2) == FAIL))
11581 return;
11582
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011583 // first argument: window number or id
11584 wp = find_win_by_nr_or_id(&argvars[0]);
11585 if (wp == NULL)
11586 return;
11587
11588 // second argument: dict with items to set in the tag stack
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +010011589 if (check_for_dict_arg(argvars, 1) == FAIL)
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011590 return;
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011591 d = argvars[1].vval.v_dict;
11592 if (d == NULL)
11593 return;
11594
11595 // third argument: action - 'a' for append and 'r' for replace.
11596 // default is to replace the stack.
11597 if (argvars[2].v_type == VAR_UNKNOWN)
11598 action = 'r';
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +010011599 else if (check_for_string_arg(argvars, 2) == FAIL)
11600 return;
11601 else
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011602 {
11603 char_u *actstr;
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011604 actstr = tv_get_string_chk(&argvars[2]);
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011605 if (actstr == NULL)
11606 return;
Bram Moolenaar271fa082020-01-02 14:02:16 +010011607 if ((*actstr == 'r' || *actstr == 'a' || *actstr == 't')
11608 && actstr[1] == NUL)
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011609 action = *actstr;
11610 else
11611 {
Bram Moolenaard82a47d2022-01-05 20:24:39 +000011612 semsg(_(e_invalid_action_str_2), actstr);
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011613 return;
11614 }
11615 }
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011616
11617 if (set_tagstack(wp, d, action) == OK)
11618 rettv->vval.v_number = 0;
11619}
11620
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011621#ifdef FEAT_CRYPT
11622/*
11623 * "sha256({string})" function
11624 */
11625 static void
11626f_sha256(typval_T *argvars, typval_T *rettv)
11627{
11628 char_u *p;
11629
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011630 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11631 return;
11632
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011633 p = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011634 rettv->vval.v_string = vim_strsave(
11635 sha256_bytes(p, (int)STRLEN(p), NULL, 0));
11636 rettv->v_type = VAR_STRING;
11637}
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011638#endif // FEAT_CRYPT
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011639
11640/*
11641 * "shellescape({string})" function
11642 */
11643 static void
11644f_shellescape(typval_T *argvars, typval_T *rettv)
11645{
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011646 int do_special;
Bram Moolenaar20615522017-06-05 18:46:26 +020011647
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011648 if (in_vim9script()
11649 && (check_for_string_arg(argvars, 0) == FAIL
11650 || check_for_opt_bool_arg(argvars, 1) == FAIL))
11651 return;
11652
11653 do_special = non_zero_arg(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011654 rettv->vval.v_string = vim_strsave_shellescape(
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011655 tv_get_string(&argvars[0]), do_special, do_special);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011656 rettv->v_type = VAR_STRING;
11657}
11658
11659/*
11660 * shiftwidth() function
11661 */
11662 static void
11663f_shiftwidth(typval_T *argvars UNUSED, typval_T *rettv)
11664{
Bram Moolenaarf9514162018-11-22 03:08:29 +010011665 rettv->vval.v_number = 0;
11666
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011667 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
11668 return;
11669
Bram Moolenaarf9514162018-11-22 03:08:29 +010011670 if (argvars[0].v_type != VAR_UNKNOWN)
11671 {
11672 long col;
11673
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011674 col = (long)tv_get_number_chk(argvars, NULL);
Bram Moolenaarf9514162018-11-22 03:08:29 +010011675 if (col < 0)
11676 return; // type error; errmsg already given
11677#ifdef FEAT_VARTABS
Gary Johnson88d4f252024-06-01 20:51:33 +020011678 rettv->vval.v_number = get_sw_value_col(curbuf, col, FALSE);
Bram Moolenaarf9514162018-11-22 03:08:29 +010011679 return;
11680#endif
11681 }
11682
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011683 rettv->vval.v_number = get_sw_value(curbuf);
11684}
11685
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011686/*
11687 * "soundfold({word})" function
11688 */
11689 static void
11690f_soundfold(typval_T *argvars, typval_T *rettv)
11691{
11692 char_u *s;
11693
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011694 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11695 return;
11696
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011697 rettv->v_type = VAR_STRING;
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011698 s = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011699#ifdef FEAT_SPELL
11700 rettv->vval.v_string = eval_soundfold(s);
11701#else
11702 rettv->vval.v_string = vim_strsave(s);
11703#endif
11704}
11705
11706/*
11707 * "spellbadword()" function
11708 */
11709 static void
11710f_spellbadword(typval_T *argvars UNUSED, typval_T *rettv)
11711{
11712 char_u *word = (char_u *)"";
11713 hlf_T attr = HLF_COUNT;
11714 int len = 0;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011715#ifdef FEAT_SPELL
11716 int wo_spell_save = curwin->w_p_spell;
11717
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011718 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
11719 return;
11720
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011721 if (!curwin->w_p_spell)
11722 {
Yegappan Lakshmananaf936912023-02-20 12:16:39 +000011723 parse_spelllang(curwin);
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011724 curwin->w_p_spell = TRUE;
11725 }
11726
11727 if (*curwin->w_s->b_p_spl == NUL)
11728 {
Bram Moolenaar460ae5d2022-01-01 14:19:49 +000011729 emsg(_(e_spell_checking_is_not_possible));
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011730 curwin->w_p_spell = wo_spell_save;
11731 return;
11732 }
11733#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011734
11735 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011736 {
11737#ifdef FEAT_SPELL
11738 curwin->w_p_spell = wo_spell_save;
11739#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011740 return;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011741 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011742
11743#ifdef FEAT_SPELL
11744 if (argvars[0].v_type == VAR_UNKNOWN)
11745 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011746 // Find the start and length of the badly spelled word.
Christ van Willegen - van Noort8e4c4c72024-05-17 18:49:27 +020011747 len = spell_move_to(curwin, FORWARD, SMT_ALL, TRUE, &attr);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011748 if (len != 0)
Bram Moolenaarb73fa622017-12-21 20:27:47 +010011749 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011750 word = ml_get_cursor();
Bram Moolenaarb73fa622017-12-21 20:27:47 +010011751 curwin->w_set_curswant = TRUE;
11752 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011753 }
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011754 else if (*curbuf->b_s.b_p_spl != NUL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011755 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011756 char_u *str = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011757 int capcol = -1;
11758
11759 if (str != NULL)
11760 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011761 // Check the argument for spelling.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011762 while (*str != NUL)
11763 {
11764 len = spell_check(curwin, str, &attr, &capcol, FALSE);
11765 if (attr != HLF_COUNT)
11766 {
11767 word = str;
11768 break;
11769 }
11770 str += len;
Bram Moolenaar66ab9162018-07-20 20:28:48 +020011771 capcol -= len;
Bram Moolenaar0c779e82019-08-09 17:01:02 +020011772 len = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011773 }
11774 }
11775 }
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011776 curwin->w_p_spell = wo_spell_save;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011777#endif
11778
11779 list_append_string(rettv->vval.v_list, word, len);
11780 list_append_string(rettv->vval.v_list, (char_u *)(
11781 attr == HLF_SPB ? "bad" :
11782 attr == HLF_SPR ? "rare" :
11783 attr == HLF_SPL ? "local" :
11784 attr == HLF_SPC ? "caps" :
11785 ""), -1);
11786}
11787
11788/*
11789 * "spellsuggest()" function
11790 */
11791 static void
11792f_spellsuggest(typval_T *argvars UNUSED, typval_T *rettv)
11793{
11794#ifdef FEAT_SPELL
11795 char_u *str;
11796 int typeerr = FALSE;
11797 int maxcount;
11798 garray_T ga;
11799 int i;
11800 listitem_T *li;
11801 int need_capital = FALSE;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011802 int wo_spell_save = curwin->w_p_spell;
11803
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011804 if (in_vim9script()
11805 && (check_for_string_arg(argvars, 0) == FAIL
11806 || check_for_opt_number_arg(argvars, 1) == FAIL
11807 || (argvars[1].v_type != VAR_UNKNOWN
11808 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
11809 return;
11810
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011811 if (!curwin->w_p_spell)
11812 {
Yegappan Lakshmananaf936912023-02-20 12:16:39 +000011813 parse_spelllang(curwin);
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011814 curwin->w_p_spell = TRUE;
11815 }
11816
11817 if (*curwin->w_s->b_p_spl == NUL)
11818 {
Bram Moolenaar460ae5d2022-01-01 14:19:49 +000011819 emsg(_(e_spell_checking_is_not_possible));
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011820 curwin->w_p_spell = wo_spell_save;
11821 return;
11822 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011823#endif
11824
11825 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011826 {
11827#ifdef FEAT_SPELL
11828 curwin->w_p_spell = wo_spell_save;
11829#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011830 return;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011831 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011832
11833#ifdef FEAT_SPELL
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011834 str = tv_get_string(&argvars[0]);
11835 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011836 {
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011837 maxcount = (int)tv_get_number_chk(&argvars[1], &typeerr);
11838 if (maxcount <= 0)
11839 return;
11840 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011841 {
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011842 need_capital = (int)tv_get_bool_chk(&argvars[2], &typeerr);
11843 if (typeerr)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011844 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011845 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011846 }
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011847 else
11848 maxcount = 25;
11849
11850 spell_suggest_list(&ga, str, maxcount, need_capital, FALSE);
11851
11852 for (i = 0; i < ga.ga_len; ++i)
11853 {
11854 str = ((char_u **)ga.ga_data)[i];
11855
11856 li = listitem_alloc();
11857 if (li == NULL)
11858 vim_free(str);
11859 else
11860 {
11861 li->li_tv.v_type = VAR_STRING;
11862 li->li_tv.v_lock = 0;
11863 li->li_tv.vval.v_string = str;
11864 list_append(rettv->vval.v_list, li);
11865 }
11866 }
11867 ga_clear(&ga);
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011868 curwin->w_p_spell = wo_spell_save;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011869#endif
11870}
11871
11872 static void
11873f_split(typval_T *argvars, typval_T *rettv)
11874{
11875 char_u *str;
11876 char_u *end;
11877 char_u *pat = NULL;
11878 regmatch_T regmatch;
11879 char_u patbuf[NUMBUFLEN];
11880 char_u *save_cpo;
11881 int match;
11882 colnr_T col = 0;
11883 int keepempty = FALSE;
11884 int typeerr = FALSE;
11885
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011886 if (in_vim9script()
11887 && (check_for_string_arg(argvars, 0) == FAIL
11888 || check_for_opt_string_arg(argvars, 1) == FAIL
11889 || (argvars[1].v_type != VAR_UNKNOWN
11890 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
11891 return;
11892
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011893 // Make 'cpoptions' empty, the 'l' flag should not be used here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011894 save_cpo = p_cpo;
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010011895 p_cpo = empty_option;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011896
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011897 str = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011898 if (argvars[1].v_type != VAR_UNKNOWN)
11899 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011900 pat = tv_get_string_buf_chk(&argvars[1], patbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011901 if (pat == NULL)
11902 typeerr = TRUE;
11903 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar3986b942020-09-06 16:09:04 +020011904 keepempty = (int)tv_get_bool_chk(&argvars[2], &typeerr);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011905 }
11906 if (pat == NULL || *pat == NUL)
11907 pat = (char_u *)"[\\x01- ]\\+";
11908
11909 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar7d5e7442020-07-21 22:25:51 +020011910 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011911 if (typeerr)
Bram Moolenaar7d5e7442020-07-21 22:25:51 +020011912 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011913
11914 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
11915 if (regmatch.regprog != NULL)
11916 {
11917 regmatch.rm_ic = FALSE;
11918 while (*str != NUL || keepempty)
11919 {
11920 if (*str == NUL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011921 match = FALSE; // empty item at the end
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011922 else
11923 match = vim_regexec_nl(&regmatch, str, col);
11924 if (match)
11925 end = regmatch.startp[0];
11926 else
11927 end = str + STRLEN(str);
11928 if (keepempty || end > str || (rettv->vval.v_list->lv_len > 0
11929 && *str != NUL && match && end < regmatch.endp[0]))
11930 {
11931 if (list_append_string(rettv->vval.v_list, str,
11932 (int)(end - str)) == FAIL)
11933 break;
11934 }
11935 if (!match)
11936 break;
Bram Moolenaar13505972019-01-24 15:04:48 +010011937 // Advance to just after the match.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011938 if (regmatch.endp[0] > str)
11939 col = 0;
11940 else
Bram Moolenaar13505972019-01-24 15:04:48 +010011941 // Don't get stuck at the same match.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011942 col = (*mb_ptr2len)(regmatch.endp[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011943 str = regmatch.endp[0];
11944 }
11945
11946 vim_regfree(regmatch.regprog);
11947 }
11948
Bram Moolenaar7d5e7442020-07-21 22:25:51 +020011949theend:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011950 p_cpo = save_cpo;
11951}
11952
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011953/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011954 * "submatch()" function
11955 */
11956 static void
11957f_submatch(typval_T *argvars, typval_T *rettv)
11958{
11959 int error = FALSE;
11960 int no;
11961 int retList = 0;
11962
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011963 if (in_vim9script()
11964 && (check_for_number_arg(argvars, 0) == FAIL
11965 || check_for_opt_bool_arg(argvars, 1) == FAIL))
11966 return;
11967
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011968 no = (int)tv_get_number_chk(&argvars[0], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011969 if (error)
11970 return;
Bram Moolenaar989f5922016-08-21 15:26:54 +020011971 if (no < 0 || no >= NSUBEXP)
11972 {
Bram Moolenaard82a47d2022-01-05 20:24:39 +000011973 semsg(_(e_invalid_submatch_number_nr), no);
Bram Moolenaar79518e22017-02-17 16:31:35 +010011974 return;
Bram Moolenaar989f5922016-08-21 15:26:54 +020011975 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011976 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaarad304702020-09-06 18:22:53 +020011977 retList = (int)tv_get_bool_chk(&argvars[1], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011978 if (error)
11979 return;
11980
11981 if (retList == 0)
11982 {
11983 rettv->v_type = VAR_STRING;
11984 rettv->vval.v_string = reg_submatch(no);
11985 }
11986 else
11987 {
11988 rettv->v_type = VAR_LIST;
11989 rettv->vval.v_list = reg_submatch_list(no);
11990 }
11991}
11992
11993/*
11994 * "substitute()" function
11995 */
11996 static void
11997f_substitute(typval_T *argvars, typval_T *rettv)
11998{
11999 char_u patbuf[NUMBUFLEN];
12000 char_u subbuf[NUMBUFLEN];
12001 char_u flagsbuf[NUMBUFLEN];
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +020012002 char_u *str;
12003 char_u *pat;
Bram Moolenaar72ab7292016-07-19 19:10:51 +020012004 char_u *sub = NULL;
12005 typval_T *expr = NULL;
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +020012006 char_u *flg;
12007
12008 if (in_vim9script()
12009 && (check_for_string_arg(argvars, 0) == FAIL
12010 || check_for_string_arg(argvars, 1) == FAIL
12011 || check_for_string_arg(argvars, 3) == FAIL))
12012 return;
12013
12014 str = tv_get_string_chk(&argvars[0]);
12015 pat = tv_get_string_buf_chk(&argvars[1], patbuf);
12016 flg = tv_get_string_buf_chk(&argvars[3], flagsbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012017
LemonBoyf3b48952022-05-05 13:53:03 +010012018 if (argvars[2].v_type == VAR_FUNC
12019 || argvars[2].v_type == VAR_PARTIAL
Bram Moolenaar00b28d62022-12-08 15:32:33 +000012020 || argvars[2].v_type == VAR_INSTR
12021 || argvars[2].v_type == VAR_CLASS
12022 || argvars[2].v_type == VAR_OBJECT)
Bram Moolenaar72ab7292016-07-19 19:10:51 +020012023 expr = &argvars[2];
12024 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012025 sub = tv_get_string_buf_chk(&argvars[2], subbuf);
Bram Moolenaar72ab7292016-07-19 19:10:51 +020012026
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012027 rettv->v_type = VAR_STRING;
Bram Moolenaar72ab7292016-07-19 19:10:51 +020012028 if (str == NULL || pat == NULL || (sub == NULL && expr == NULL)
12029 || flg == NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012030 rettv->vval.v_string = NULL;
12031 else
John Marriottbd4614f2024-11-18 20:25:21 +010012032 rettv->vval.v_string = do_string_sub(str, STRLEN(str), pat, sub, expr, flg, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012033}
12034
12035/*
Bram Moolenaarc216a7a2022-12-05 13:50:55 +000012036 * "swapfilelist()" function
12037 */
12038 static void
12039f_swapfilelist(typval_T *argvars UNUSED, typval_T *rettv)
12040{
12041 if (rettv_list_alloc(rettv) == FAIL)
12042 return;
12043 recover_names(NULL, FALSE, rettv->vval.v_list, 0, NULL);
12044}
12045
12046/*
Bram Moolenaar00f123a2018-08-21 20:28:54 +020012047 * "swapinfo(swap_filename)" function
12048 */
12049 static void
12050f_swapinfo(typval_T *argvars, typval_T *rettv)
12051{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012052 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
12053 return;
12054
Bram Moolenaar00f123a2018-08-21 20:28:54 +020012055 if (rettv_dict_alloc(rettv) == OK)
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012056 get_b0_dict(tv_get_string(argvars), rettv->vval.v_dict);
Bram Moolenaar00f123a2018-08-21 20:28:54 +020012057}
12058
12059/*
Bram Moolenaar110bd602018-09-16 18:46:59 +020012060 * "swapname(expr)" function
12061 */
12062 static void
12063f_swapname(typval_T *argvars, typval_T *rettv)
12064{
12065 buf_T *buf;
12066
12067 rettv->v_type = VAR_STRING;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012068
12069 if (in_vim9script() && check_for_buffer_arg(argvars, 0) == FAIL)
12070 return;
12071
Bram Moolenaarf2d79fa2019-01-03 22:19:27 +010012072 buf = tv_get_buf(&argvars[0], FALSE);
Bram Moolenaar110bd602018-09-16 18:46:59 +020012073 if (buf == NULL || buf->b_ml.ml_mfp == NULL
12074 || buf->b_ml.ml_mfp->mf_fname == NULL)
12075 rettv->vval.v_string = NULL;
12076 else
12077 rettv->vval.v_string = vim_strsave(buf->b_ml.ml_mfp->mf_fname);
12078}
12079
12080/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012081 * "synID(lnum, col, trans)" function
12082 */
12083 static void
12084f_synID(typval_T *argvars UNUSED, typval_T *rettv)
12085{
12086 int id = 0;
12087#ifdef FEAT_SYN_HL
12088 linenr_T lnum;
12089 colnr_T col;
12090 int trans;
12091 int transerr = FALSE;
12092
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020012093 if (in_vim9script()
Yegappan Lakshmanancd917202021-07-21 19:09:09 +020012094 && (check_for_lnum_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020012095 || check_for_number_arg(argvars, 1) == FAIL
12096 || check_for_bool_arg(argvars, 2) == FAIL))
12097 return;
12098
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012099 lnum = tv_get_lnum(argvars); // -1 on type error
12100 col = (linenr_T)tv_get_number(&argvars[1]) - 1; // -1 on type error
Bram Moolenaarfcb6d702020-09-05 21:41:56 +020012101 trans = (int)tv_get_bool_chk(&argvars[2], &transerr);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012102
12103 if (!transerr && lnum >= 1 && lnum <= curbuf->b_ml.ml_line_count
John Marriottbfcc8952024-03-11 22:04:45 +010012104 && col >= 0 && col < (long)ml_get_len(lnum))
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +000012105 id = syn_get_id(curwin, lnum, col, trans, NULL, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012106#endif
12107
12108 rettv->vval.v_number = id;
12109}
12110
12111/*
12112 * "synIDattr(id, what [, mode])" function
12113 */
12114 static void
12115f_synIDattr(typval_T *argvars UNUSED, typval_T *rettv)
12116{
12117 char_u *p = NULL;
12118#ifdef FEAT_SYN_HL
12119 int id;
12120 char_u *what;
12121 char_u *mode;
12122 char_u modebuf[NUMBUFLEN];
12123 int modec;
12124
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +020012125 if (in_vim9script()
12126 && (check_for_number_arg(argvars, 0) == FAIL
Yegappan Lakshmananf8dbd582021-09-26 19:04:05 +010012127 || check_for_string_arg(argvars, 1) == FAIL
12128 || check_for_opt_string_arg(argvars, 2) == FAIL))
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +020012129 return;
12130
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012131 id = (int)tv_get_number(&argvars[0]);
12132 what = tv_get_string(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012133 if (argvars[2].v_type != VAR_UNKNOWN)
12134 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012135 mode = tv_get_string_buf(&argvars[2], modebuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012136 modec = TOLOWER_ASC(mode[0]);
12137 if (modec != 't' && modec != 'c' && modec != 'g')
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012138 modec = 0; // replace invalid with current
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012139 }
12140 else
12141 {
12142#if defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS)
12143 if (USE_24BIT)
12144 modec = 'g';
12145 else
12146#endif
12147 if (t_colors > 1)
Dominique Pelle4781d6f2021-05-18 21:46:31 +020012148 modec = 'c';
12149 else
12150 modec = 't';
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012151 }
12152
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012153 switch (TOLOWER_ASC(what[0]))
12154 {
12155 case 'b':
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012156 if (TOLOWER_ASC(what[1]) == 'g') // bg[#]
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012157 p = highlight_color(id, what, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012158 else // bold
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012159 p = highlight_has_attr(id, HL_BOLD, modec);
12160 break;
12161
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012162 case 'f': // fg[#] or font
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012163 p = highlight_color(id, what, modec);
12164 break;
12165
12166 case 'i':
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012167 if (TOLOWER_ASC(what[1]) == 'n') // inverse
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012168 p = highlight_has_attr(id, HL_INVERSE, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012169 else // italic
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012170 p = highlight_has_attr(id, HL_ITALIC, modec);
12171 break;
12172
Martin Tournoijba43e762022-10-13 22:12:15 +010012173 case 'n':
Bram Moolenaarde786322022-07-30 14:56:17 +010012174 if (TOLOWER_ASC(what[1]) == 'o') // nocombine
12175 p = highlight_has_attr(id, HL_NOCOMBINE, modec);
12176 else // name
12177 p = get_highlight_name_ext(NULL, id - 1, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012178 break;
12179
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012180 case 'r': // reverse
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012181 p = highlight_has_attr(id, HL_INVERSE, modec);
12182 break;
12183
12184 case 's':
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012185 if (TOLOWER_ASC(what[1]) == 'p') // sp[#]
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012186 p = highlight_color(id, what, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012187 // strikeout
Bram Moolenaarcf4b00c2017-09-02 18:33:56 +020012188 else if (TOLOWER_ASC(what[1]) == 't' &&
12189 TOLOWER_ASC(what[2]) == 'r')
12190 p = highlight_has_attr(id, HL_STRIKETHROUGH, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012191 else // standout
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012192 p = highlight_has_attr(id, HL_STANDOUT, modec);
12193 break;
12194
12195 case 'u':
Bram Moolenaar84f54632022-06-29 18:39:11 +010012196 if (STRLEN(what) >= 9)
12197 {
12198 if (TOLOWER_ASC(what[5]) == 'l')
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012199 // underline
Bram Moolenaar84f54632022-06-29 18:39:11 +010012200 p = highlight_has_attr(id, HL_UNDERLINE, modec);
12201 else if (TOLOWER_ASC(what[5]) != 'd')
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012202 // undercurl
Bram Moolenaar84f54632022-06-29 18:39:11 +010012203 p = highlight_has_attr(id, HL_UNDERCURL, modec);
12204 else if (TOLOWER_ASC(what[6]) != 'o')
12205 // underdashed
12206 p = highlight_has_attr(id, HL_UNDERDASHED, modec);
12207 else if (TOLOWER_ASC(what[7]) == 'u')
12208 // underdouble
12209 p = highlight_has_attr(id, HL_UNDERDOUBLE, modec);
12210 else
12211 // underdotted
12212 p = highlight_has_attr(id, HL_UNDERDOTTED, modec);
12213 }
12214 else
12215 // ul
12216 p = highlight_color(id, what, modec);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012217 break;
12218 }
12219
12220 if (p != NULL)
12221 p = vim_strsave(p);
12222#endif
12223 rettv->v_type = VAR_STRING;
12224 rettv->vval.v_string = p;
12225}
12226
12227/*
12228 * "synIDtrans(id)" function
12229 */
12230 static void
12231f_synIDtrans(typval_T *argvars UNUSED, typval_T *rettv)
12232{
12233 int id;
12234
12235#ifdef FEAT_SYN_HL
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012236 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
12237 return;
12238
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012239 id = (int)tv_get_number(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012240
12241 if (id > 0)
12242 id = syn_get_final_id(id);
12243 else
12244#endif
12245 id = 0;
12246
12247 rettv->vval.v_number = id;
12248}
12249
12250/*
12251 * "synconcealed(lnum, col)" function
12252 */
12253 static void
12254f_synconcealed(typval_T *argvars UNUSED, typval_T *rettv)
12255{
12256#if defined(FEAT_SYN_HL) && defined(FEAT_CONCEAL)
12257 linenr_T lnum;
12258 colnr_T col;
12259 int syntax_flags = 0;
12260 int cchar;
12261 int matchid = 0;
12262 char_u str[NUMBUFLEN];
12263#endif
12264
Bram Moolenaar45cf6e92017-04-30 20:25:19 +020012265 rettv_list_set(rettv, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012266
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020012267 if (in_vim9script()
Yegappan Lakshmanancd917202021-07-21 19:09:09 +020012268 && (check_for_lnum_arg(argvars, 0) == FAIL
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020012269 || check_for_number_arg(argvars, 1) == FAIL))
12270 return;
12271
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012272#if defined(FEAT_SYN_HL) && defined(FEAT_CONCEAL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012273 lnum = tv_get_lnum(argvars); // -1 on type error
12274 col = (colnr_T)tv_get_number(&argvars[1]) - 1; // -1 on type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012275
Bram Moolenaara80faa82020-04-12 19:37:17 +020012276 CLEAR_FIELD(str);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012277
Bram Moolenaar93a10962022-06-16 11:42:09 +010012278 if (rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012279 {
12280 if (lnum >= 1 && lnum <= curbuf->b_ml.ml_line_count
John Marriottbfcc8952024-03-11 22:04:45 +010012281 && col >= 0 && col <= (long)ml_get_len(lnum)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012282 && curwin->w_p_cole > 0)
12283 {
12284 (void)syn_get_id(curwin, lnum, col, FALSE, NULL, FALSE);
12285 syntax_flags = get_syntax_info(&matchid);
12286
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012287 // get the conceal character
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012288 if ((syntax_flags & HL_CONCEAL) && curwin->w_p_cole < 3)
12289 {
12290 cchar = syn_get_sub_char();
Bram Moolenaar4d785892017-06-22 22:00:50 +020012291 if (cchar == NUL && curwin->w_p_cole == 1)
Bram Moolenaareed9d462021-02-15 20:38:25 +010012292 cchar = (curwin->w_lcs_chars.conceal == NUL) ? ' '
12293 : curwin->w_lcs_chars.conceal;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012294 if (cchar != NUL)
12295 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012296 if (has_mbyte)
12297 (*mb_char2bytes)(cchar, str);
12298 else
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012299 str[0] = cchar;
12300 }
12301 }
12302 }
12303
12304 list_append_number(rettv->vval.v_list,
12305 (syntax_flags & HL_CONCEAL) != 0);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012306 // -1 to auto-determine strlen
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012307 list_append_string(rettv->vval.v_list, str, -1);
12308 list_append_number(rettv->vval.v_list, matchid);
12309 }
12310#endif
12311}
12312
12313/*
12314 * "synstack(lnum, col)" function
12315 */
12316 static void
12317f_synstack(typval_T *argvars UNUSED, typval_T *rettv)
12318{
12319#ifdef FEAT_SYN_HL
12320 linenr_T lnum;
12321 colnr_T col;
12322 int i;
12323 int id;
12324#endif
12325
Bram Moolenaar45cf6e92017-04-30 20:25:19 +020012326 rettv_list_set(rettv, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012327
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020012328 if (in_vim9script()
Yegappan Lakshmanancd917202021-07-21 19:09:09 +020012329 && (check_for_lnum_arg(argvars, 0) == FAIL
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020012330 || check_for_number_arg(argvars, 1) == FAIL))
12331 return;
12332
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012333#ifdef FEAT_SYN_HL
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012334 lnum = tv_get_lnum(argvars); // -1 on type error
12335 col = (colnr_T)tv_get_number(&argvars[1]) - 1; // -1 on type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012336
12337 if (lnum >= 1 && lnum <= curbuf->b_ml.ml_line_count
John Marriottbfcc8952024-03-11 22:04:45 +010012338 && col >= 0 && col <= (long)ml_get_len(lnum)
Bram Moolenaar93a10962022-06-16 11:42:09 +010012339 && rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012340 {
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +000012341 (void)syn_get_id(curwin, lnum, col, FALSE, NULL, TRUE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012342 for (i = 0; ; ++i)
12343 {
12344 id = syn_get_stack_item(i);
12345 if (id < 0)
12346 break;
12347 if (list_append_number(rettv->vval.v_list, id) == FAIL)
12348 break;
12349 }
12350 }
12351#endif
12352}
12353
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012354/*
12355 * "tabpagebuflist()" function
12356 */
12357 static void
12358f_tabpagebuflist(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
12359{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012360 tabpage_T *tp;
12361 win_T *wp = NULL;
12362
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012363 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
12364 return;
12365
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012366 if (argvars[0].v_type == VAR_UNKNOWN)
12367 wp = firstwin;
12368 else
12369 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012370 tp = find_tabpage((int)tv_get_number(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012371 if (tp != NULL)
12372 wp = (tp == curtab) ? firstwin : tp->tp_firstwin;
12373 }
Bram Moolenaar93a10962022-06-16 11:42:09 +010012374 if (wp != NULL && rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012375 {
12376 for (; wp != NULL; wp = wp->w_next)
12377 if (list_append_number(rettv->vval.v_list,
12378 wp->w_buffer->b_fnum) == FAIL)
12379 break;
12380 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012381}
12382
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012383/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012384 * "tagfiles()" function
12385 */
12386 static void
12387f_tagfiles(typval_T *argvars UNUSED, typval_T *rettv)
12388{
12389 char_u *fname;
12390 tagname_T tn;
12391 int first;
12392
12393 if (rettv_list_alloc(rettv) == FAIL)
12394 return;
12395 fname = alloc(MAXPATHL);
12396 if (fname == NULL)
12397 return;
12398
12399 for (first = TRUE; ; first = FALSE)
12400 if (get_tagfname(&tn, first, fname) == FAIL
12401 || list_append_string(rettv->vval.v_list, fname, -1) == FAIL)
12402 break;
12403 tagname_free(&tn);
12404 vim_free(fname);
12405}
12406
12407/*
12408 * "taglist()" function
12409 */
12410 static void
12411f_taglist(typval_T *argvars, typval_T *rettv)
12412{
Bram Moolenaarc6aafba2017-03-21 17:09:10 +010012413 char_u *fname = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012414 char_u *tag_pattern;
12415
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012416 if (in_vim9script()
12417 && (check_for_string_arg(argvars, 0) == FAIL
12418 || check_for_opt_string_arg(argvars, 1) == FAIL))
12419 return;
12420
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012421 tag_pattern = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012422
12423 rettv->vval.v_number = FALSE;
12424 if (*tag_pattern == NUL)
12425 return;
12426
Bram Moolenaarc6aafba2017-03-21 17:09:10 +010012427 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012428 fname = tv_get_string(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012429 if (rettv_list_alloc(rettv) == OK)
Bram Moolenaarc6aafba2017-03-21 17:09:10 +010012430 (void)get_tags(rettv->vval.v_list, tag_pattern, fname);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012431}
12432
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012433/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012434 * "type(expr)" function
12435 */
12436 static void
12437f_type(typval_T *argvars, typval_T *rettv)
12438{
12439 int n = -1;
12440
12441 switch (argvars[0].v_type)
12442 {
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +010012443 case VAR_NUMBER: n = VAR_TYPE_NUMBER; break;
12444 case VAR_STRING: n = VAR_TYPE_STRING; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012445 case VAR_PARTIAL:
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +010012446 case VAR_FUNC: n = VAR_TYPE_FUNC; break;
12447 case VAR_LIST: n = VAR_TYPE_LIST; break;
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010012448 case VAR_TUPLE: n = VAR_TYPE_TUPLE; break;
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +010012449 case VAR_DICT: n = VAR_TYPE_DICT; break;
12450 case VAR_FLOAT: n = VAR_TYPE_FLOAT; break;
12451 case VAR_BOOL: n = VAR_TYPE_BOOL; break;
12452 case VAR_SPECIAL: n = VAR_TYPE_NONE; break;
Bram Moolenaarf562e722016-07-19 17:25:25 +020012453 case VAR_JOB: n = VAR_TYPE_JOB; break;
12454 case VAR_CHANNEL: n = VAR_TYPE_CHANNEL; break;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +010012455 case VAR_BLOB: n = VAR_TYPE_BLOB; break;
Bram Moolenaarf18332f2021-05-07 17:55:55 +020012456 case VAR_INSTR: n = VAR_TYPE_INSTR; break;
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +020012457 case VAR_TYPEALIAS: n = VAR_TYPE_TYPEALIAS; break;
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012458 case VAR_CLASS:
12459 {
12460 class_T *cl = argvars[0].vval.v_class;
Yegappan Lakshmananda9d3452024-05-02 13:02:36 +020012461 if (cl != NULL && IS_ENUM(cl))
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012462 n = VAR_TYPE_ENUM;
12463 else
12464 n = VAR_TYPE_CLASS;
12465 break;
12466 }
12467 case VAR_OBJECT:
12468 {
Yegappan Lakshmananb2e42b92024-05-01 11:44:17 +020012469 object_T *obj = argvars[0].vval.v_object;
12470
12471 if (obj == NULL)
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012472 n = VAR_TYPE_OBJECT;
Yegappan Lakshmananb2e42b92024-05-01 11:44:17 +020012473 else
12474 {
12475 class_T *cl = argvars[0].vval.v_object->obj_class;
12476 if (IS_ENUM(cl))
12477 n = VAR_TYPE_ENUMVALUE;
12478 else
12479 n = VAR_TYPE_OBJECT;
12480 }
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012481 break;
12482 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012483 case VAR_UNKNOWN:
Bram Moolenaar4c683752020-04-05 21:38:23 +020012484 case VAR_ANY:
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010012485 case VAR_VOID:
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012486 internal_error_no_abort("f_type(UNKNOWN)");
12487 n = -1;
12488 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012489 }
12490 rettv->vval.v_number = n;
12491}
12492
12493/*
zeertzjq825cf812023-08-17 22:55:25 +020012494 * "virtcol({expr}, [, {list} [, {winid}]])" function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012495 */
12496 static void
12497f_virtcol(typval_T *argvars, typval_T *rettv)
12498{
LemonBoy0f7a3e12022-05-26 12:10:37 +010012499 colnr_T vcol_start = 0;
12500 colnr_T vcol_end = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012501 pos_T *fp;
zeertzjq825cf812023-08-17 22:55:25 +020012502 switchwin_T switchwin;
12503 int winchanged = FALSE;
Bram Moolenaarb3d33d82020-01-15 20:36:55 +010012504 int len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012505
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012506 if (in_vim9script()
LemonBoy0f7a3e12022-05-26 12:10:37 +010012507 && (check_for_string_or_list_arg(argvars, 0) == FAIL
12508 || (argvars[1].v_type != VAR_UNKNOWN
zeertzjq825cf812023-08-17 22:55:25 +020012509 && (check_for_bool_arg(argvars, 1) == FAIL
12510 || check_for_opt_number_arg(argvars, 2) == FAIL))))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012511 return;
12512
zeertzjq825cf812023-08-17 22:55:25 +020012513 if (argvars[1].v_type != VAR_UNKNOWN && argvars[2].v_type != VAR_UNKNOWN)
12514 {
12515 tabpage_T *tp;
12516 win_T *wp;
12517
12518 // use the window specified in the third argument
12519 wp = win_id2wp_tp((int)tv_get_number(&argvars[2]), &tp);
12520 if (wp == NULL || tp == NULL)
12521 goto theend;
12522
12523 if (switch_win_noblock(&switchwin, wp, tp, TRUE) != OK)
12524 goto theend;
12525
12526 check_cursor();
12527 winchanged = TRUE;
12528 }
12529
12530 int fnum = curbuf->b_fnum;
Bram Moolenaar6f02b002021-01-10 20:22:54 +010012531 fp = var2fpos(&argvars[0], FALSE, &fnum, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012532 if (fp != NULL && fp->lnum <= curbuf->b_ml.ml_line_count
LemonBoy0f7a3e12022-05-26 12:10:37 +010012533 && fnum == curbuf->b_fnum)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012534 {
Bram Moolenaarb3d33d82020-01-15 20:36:55 +010012535 // Limit the column to a valid value, getvvcol() doesn't check.
12536 if (fp->col < 0)
12537 fp->col = 0;
12538 else
12539 {
John Marriottbfcc8952024-03-11 22:04:45 +010012540 len = (int)ml_get_len(fp->lnum);
Bram Moolenaarb3d33d82020-01-15 20:36:55 +010012541 if (fp->col > len)
12542 fp->col = len;
12543 }
LemonBoy0f7a3e12022-05-26 12:10:37 +010012544 getvvcol(curwin, fp, &vcol_start, NULL, &vcol_end);
12545 ++vcol_start;
12546 ++vcol_end;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012547 }
12548
zeertzjq825cf812023-08-17 22:55:25 +020012549theend:
LemonBoy0f7a3e12022-05-26 12:10:37 +010012550 if (argvars[1].v_type != VAR_UNKNOWN && tv_get_bool(&argvars[1]))
12551 {
12552 if (rettv_list_alloc(rettv) == OK)
12553 {
12554 list_append_number(rettv->vval.v_list, vcol_start);
12555 list_append_number(rettv->vval.v_list, vcol_end);
12556 }
12557 else
12558 rettv->vval.v_number = 0;
12559 }
12560 else
12561 rettv->vval.v_number = vcol_end;
zeertzjq825cf812023-08-17 22:55:25 +020012562
12563 if (winchanged)
12564 restore_win_noblock(&switchwin, TRUE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012565}
12566
12567/*
12568 * "visualmode()" function
12569 */
12570 static void
12571f_visualmode(typval_T *argvars, typval_T *rettv)
12572{
12573 char_u str[2];
12574
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012575 if (in_vim9script() && check_for_opt_bool_arg(argvars, 0) == FAIL)
12576 return;
12577
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012578 rettv->v_type = VAR_STRING;
12579 str[0] = curbuf->b_visual_mode_eval;
12580 str[1] = NUL;
12581 rettv->vval.v_string = vim_strsave(str);
12582
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012583 // A non-zero number or non-empty string argument: reset mode.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012584 if (non_zero_arg(&argvars[0]))
12585 curbuf->b_visual_mode_eval = NUL;
12586}
12587
12588/*
12589 * "wildmenumode()" function
12590 */
12591 static void
12592f_wildmenumode(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
12593{
Bram Moolenaar24959102022-05-07 20:01:16 +010012594 if (wild_menu_showing || ((State & MODE_CMDLINE) && cmdline_pum_active()))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012595 rettv->vval.v_number = 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012596}
12597
12598/*
Bram Moolenaar0c1e3742019-12-27 13:49:24 +010012599 * "windowsversion()" function
12600 */
12601 static void
12602f_windowsversion(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
12603{
12604 rettv->v_type = VAR_STRING;
12605 rettv->vval.v_string = vim_strsave((char_u *)windowsVersion);
12606}
12607
12608/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012609 * "wordcount()" function
12610 */
12611 static void
12612f_wordcount(typval_T *argvars UNUSED, typval_T *rettv)
12613{
12614 if (rettv_dict_alloc(rettv) == FAIL)
12615 return;
12616 cursor_pos_info(rettv->vval.v_dict);
12617}
12618
12619/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012620 * "xor(expr, expr)" function
12621 */
12622 static void
12623f_xor(typval_T *argvars, typval_T *rettv)
12624{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012625 if (in_vim9script()
12626 && (check_for_number_arg(argvars, 0) == FAIL
12627 || check_for_number_arg(argvars, 1) == FAIL))
12628 return;
12629
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012630 rettv->vval.v_number = tv_get_number_chk(&argvars[0], NULL)
12631 ^ tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012632}
12633
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012634#endif // FEAT_EVAL