blob: 2aa516dc40c7cbe9b06c70ad1db2c85e334ab29e [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},
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00002095 {"col", 1, 2, FEARG_1, arg2_string_or_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002096 ret_number, f_col},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002097 {"complete", 2, 2, FEARG_2, arg2_number_list,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002098 ret_void, f_complete},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002099 {"complete_add", 1, 1, FEARG_1, arg1_dict_or_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002100 ret_number, f_complete_add},
2101 {"complete_check", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002102 ret_number_bool, f_complete_check},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002103 {"complete_info", 0, 1, FEARG_1, arg1_list_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002104 ret_dict_any, f_complete_info},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002105 {"confirm", 1, 4, FEARG_1, arg4_string_string_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002106 ret_number, f_confirm},
2107 {"copy", 1, 1, FEARG_1, NULL,
Bram Moolenaar381692b2022-02-02 20:01:27 +00002108 ret_copy, f_copy},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002109 {"cos", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002110 ret_float, f_cos},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002111 {"cosh", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002112 ret_float, f_cosh},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002113 {"count", 2, 4, FEARG_1, arg24_count,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002114 ret_number, f_count},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002115 {"cscope_connection",0,3, 0, arg3_number_string_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002116 ret_number, f_cscope_connection},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002117 {"cursor", 1, 3, FEARG_1, arg13_cursor,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002118 ret_number, f_cursor},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002119 {"debugbreak", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002120 ret_number,
Bram Moolenaar4f974752019-02-17 17:44:42 +01002121#ifdef MSWIN
Bram Moolenaar15c47602020-03-26 22:16:48 +01002122 f_debugbreak
2123#else
2124 NULL
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02002125#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002126 },
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002127 {"deepcopy", 1, 2, FEARG_1, arg12_deepcopy,
Bram Moolenaar381692b2022-02-02 20:01:27 +00002128 ret_copy, f_deepcopy},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002129 {"delete", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002130 ret_number_bool, f_delete},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002131 {"deletebufline", 2, 3, FEARG_1, arg3_buffer_lnum_lnum,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002132 ret_number_bool, f_deletebufline},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002133 {"did_filetype", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002134 ret_number_bool, f_did_filetype},
Yegappan Lakshmananfa378352024-02-01 22:05:27 +01002135 {"diff", 2, 3, FEARG_1, arg3_diff,
Yegappan Lakshmanana0010a12024-02-12 20:21:26 +01002136 ret_any, f_diff},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002137 {"diff_filler", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002138 ret_number, f_diff_filler},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002139 {"diff_hlID", 2, 2, FEARG_1, arg2_lnum_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002140 ret_number, f_diff_hlID},
h-east29b85712021-07-26 21:54:04 +02002141 {"digraph_get", 1, 1, FEARG_1, arg1_string,
2142 ret_string, f_digraph_get},
zeertzjqd4d12072024-07-16 20:34:16 +02002143 {"digraph_getlist", 0, 1, FEARG_1, arg1_bool,
h-east29b85712021-07-26 21:54:04 +02002144 ret_list_string_items, f_digraph_getlist},
Yegappan Lakshmananfc3b7752021-09-08 14:57:42 +02002145 {"digraph_set", 2, 2, FEARG_1, arg2_string,
h-east29b85712021-07-26 21:54:04 +02002146 ret_bool, f_digraph_set},
zeertzjqd4d12072024-07-16 20:34:16 +02002147 {"digraph_setlist", 1, 1, FEARG_1, arg1_list_string,
h-east29b85712021-07-26 21:54:04 +02002148 ret_bool, f_digraph_setlist},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002149 {"echoraw", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002150 ret_void, f_echoraw},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002151 {"empty", 1, 1, FEARG_1, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002152 ret_number_bool, f_empty},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002153 {"environ", 0, 0, 0, NULL,
2154 ret_dict_string, f_environ},
Bram Moolenaar80adaa82023-07-07 18:57:40 +01002155 {"err_teapot", 0, 1, 0, NULL,
2156 ret_number_bool, f_err_teapot},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002157 {"escape", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002158 ret_string, f_escape},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002159 {"eval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002160 ret_any, f_eval},
2161 {"eventhandler", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002162 ret_number_bool, f_eventhandler},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002163 {"executable", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002164 ret_number, f_executable},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002165 {"execute", 1, 2, FEARG_1, arg12_execute,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002166 ret_string, f_execute},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002167 {"exepath", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002168 ret_string, f_exepath},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002169 {"exists", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002170 ret_number_bool, f_exists},
Bram Moolenaar26735992021-08-08 14:43:22 +02002171 {"exists_compiled", 1, 1, FEARG_1, arg1_string,
2172 ret_number_bool, f_exists_compiled},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002173 {"exp", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002174 ret_float, f_exp},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002175 {"expand", 1, 3, FEARG_1, arg3_string_bool_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002176 ret_any, f_expand},
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01002177 {"expandcmd", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002178 ret_string, f_expandcmd},
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01002179 {"extend", 2, 3, FEARG_1, arg23_extend,
Bram Moolenaar81330182022-02-01 12:11:58 +00002180 ret_extend, f_extend},
Bram Moolenaarb0e6b512021-01-12 20:23:40 +01002181 {"extendnew", 2, 3, FEARG_1, arg23_extendnew,
2182 ret_first_cont, f_extendnew},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002183 {"feedkeys", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002184 ret_void, f_feedkeys},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002185 {"file_readable", 1, 1, FEARG_1, arg1_string, // obsolete
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002186 ret_number_bool, f_filereadable},
Shougo Matsushita60c87432024-06-03 22:59:27 +02002187 {"filecopy", 2, 2, FEARG_1, arg2_string,
2188 ret_number_bool, f_filecopy},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002189 {"filereadable", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002190 ret_number_bool, f_filereadable},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002191 {"filewritable", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002192 ret_number, f_filewritable},
Bram Moolenaar18024052021-12-25 21:43:28 +00002193 {"filter", 2, 2, FEARG_1, arg2_filter,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002194 ret_first_arg, f_filter},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002195 {"finddir", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar08018222021-12-22 18:45:37 +00002196 ret_finddir, f_finddir},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002197 {"findfile", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar10c83dd2021-09-04 14:49:56 +02002198 ret_any, f_findfile},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002199 {"flatten", 1, 2, FEARG_1, arg2_list_any_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002200 ret_list_any, f_flatten},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002201 {"flattennew", 1, 2, FEARG_1, arg2_list_any_number,
Bram Moolenaar3b690062021-02-01 20:14:51 +01002202 ret_list_any, f_flattennew},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002203 {"float2nr", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002204 ret_number, f_float2nr},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002205 {"floor", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002206 ret_float, f_floor},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002207 {"fmod", 2, 2, FEARG_1, arg2_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002208 ret_float, f_fmod},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002209 {"fnameescape", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002210 ret_string, f_fnameescape},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002211 {"fnamemodify", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002212 ret_string, f_fnamemodify},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002213 {"foldclosed", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002214 ret_number, f_foldclosed},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002215 {"foldclosedend", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002216 ret_number, f_foldclosedend},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002217 {"foldlevel", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002218 ret_number, f_foldlevel},
2219 {"foldtext", 0, 0, 0, NULL,
2220 ret_string, f_foldtext},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002221 {"foldtextresult", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002222 ret_string, f_foldtextresult},
Ernie Raele79e2072024-01-13 11:47:33 +01002223 {"foreach", 2, 2, FEARG_1, arg2_foreach,
2224 ret_first_arg, f_foreach},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002225 {"foreground", 0, 0, 0, NULL,
2226 ret_void, f_foreground},
Bram Moolenaardd44b582022-09-15 22:03:57 +01002227 {"fullcommand", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar038e09e2021-02-06 12:38:51 +01002228 ret_string, f_fullcommand},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002229 {"funcref", 1, 3, FEARG_1, arg3_any_list_dict,
Bram Moolenaar2f9f4cc2021-12-20 09:36:27 +00002230 ret_func_unknown, f_funcref},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002231 {"function", 1, 3, FEARG_1, arg3_any_list_dict,
Bram Moolenaar2f9f4cc2021-12-20 09:36:27 +00002232 ret_func_unknown, f_function},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002233 {"garbagecollect", 0, 1, 0, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002234 ret_void, f_garbagecollect},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002235 {"get", 2, 3, FEARG_1, arg23_get,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002236 ret_any, f_get},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002237 {"getbufinfo", 0, 1, FEARG_1, arg1_buffer_or_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002238 ret_list_dict_any, f_getbufinfo},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002239 {"getbufline", 2, 3, FEARG_1, arg3_buffer_lnum_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002240 ret_list_string, f_getbufline},
Bram Moolenaarce30ccc2022-11-21 19:57:04 +00002241 {"getbufoneline", 2, 2, FEARG_1, arg2_buffer_lnum,
2242 ret_string, f_getbufoneline},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002243 {"getbufvar", 2, 3, FEARG_1, arg3_buffer_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002244 ret_any, f_getbufvar},
mikoto20001083cae2024-11-11 21:24:14 +01002245 {"getcellpixels", 0, 0, 0, NULL,
mikoto2000a73dfc22024-11-18 21:12:21 +01002246 ret_list_any, f_getcellpixels},
Kota Kato66bb9ae2023-01-17 18:31:56 +00002247 {"getcellwidths", 0, 0, 0, NULL,
2248 ret_list_any, f_getcellwidths},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002249 {"getchangelist", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002250 ret_list_any, f_getchangelist},
zeertzjqe0a2ab32025-02-02 09:14:35 +01002251 {"getchar", 0, 2, 0, arg12_getchar,
Bram Moolenaar3a7503c2021-06-07 18:29:17 +02002252 ret_any, f_getchar},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002253 {"getcharmod", 0, 0, 0, NULL,
2254 ret_number, f_getcharmod},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002255 {"getcharpos", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar6f02b002021-01-10 20:22:54 +01002256 ret_list_number, f_getcharpos},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002257 {"getcharsearch", 0, 0, 0, NULL,
2258 ret_dict_any, f_getcharsearch},
zeertzjqe0a2ab32025-02-02 09:14:35 +01002259 {"getcharstr", 0, 2, 0, arg12_getchar,
Bram Moolenaar3a7503c2021-06-07 18:29:17 +02002260 ret_string, f_getcharstr},
Ruslan Russkikh0407d622024-10-08 22:21:05 +02002261 {"getcmdcomplpat", 0, 0, 0, NULL,
2262 ret_string, f_getcmdcomplpat},
Shougo Matsushita79d599b2022-05-07 12:48:29 +01002263 {"getcmdcompltype", 0, 0, 0, NULL,
2264 ret_string, f_getcmdcompltype},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002265 {"getcmdline", 0, 0, 0, NULL,
2266 ret_string, f_getcmdline},
2267 {"getcmdpos", 0, 0, 0, NULL,
2268 ret_number, f_getcmdpos},
Shougo Matsushita69084282024-09-23 20:34:47 +02002269 {"getcmdprompt", 0, 0, 0, NULL,
2270 ret_string, f_getcmdprompt},
Shougo Matsushita79d599b2022-05-07 12:48:29 +01002271 {"getcmdscreenpos", 0, 0, 0, NULL,
2272 ret_number, f_getcmdscreenpos},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002273 {"getcmdtype", 0, 0, 0, NULL,
2274 ret_string, f_getcmdtype},
2275 {"getcmdwintype", 0, 0, 0, NULL,
2276 ret_string, f_getcmdwintype},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002277 {"getcompletion", 2, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002278 ret_list_string, f_getcompletion},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002279 {"getcurpos", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002280 ret_list_number, f_getcurpos},
Bram Moolenaar82e46e52022-02-05 18:12:34 +00002281 {"getcursorcharpos", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar6f02b002021-01-10 20:22:54 +01002282 ret_list_number, f_getcursorcharpos},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002283 {"getcwd", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002284 ret_string, f_getcwd},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002285 {"getenv", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar7ad67d12021-03-10 16:08:26 +01002286 ret_any, f_getenv},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002287 {"getfontname", 0, 1, 0, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002288 ret_string, f_getfontname},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002289 {"getfperm", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002290 ret_string, f_getfperm},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002291 {"getfsize", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002292 ret_number, f_getfsize},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002293 {"getftime", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002294 ret_number, f_getftime},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002295 {"getftype", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002296 ret_string, f_getftype},
2297 {"getimstatus", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002298 ret_number_bool, f_getimstatus},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002299 {"getjumplist", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002300 ret_list_any, f_getjumplist},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002301 {"getline", 1, 2, FEARG_1, arg2_lnum,
Bram Moolenaar078a4612022-01-04 15:17:03 +00002302 ret_getline, f_getline},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002303 {"getloclist", 1, 2, 0, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002304 ret_list_or_dict_1, f_getloclist},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002305 {"getmarklist", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002306 ret_list_dict_any, f_getmarklist},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002307 {"getmatches", 0, 1, 0, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002308 ret_list_dict_any, f_getmatches},
2309 {"getmousepos", 0, 0, 0, NULL,
2310 ret_dict_number, f_getmousepos},
Bram Moolenaar24dc19c2022-11-14 19:49:15 +00002311 {"getmouseshape", 0, 0, 0, NULL,
2312 ret_string, f_getmouseshape},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002313 {"getpid", 0, 0, 0, NULL,
2314 ret_number, f_getpid},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002315 {"getpos", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002316 ret_list_number, f_getpos},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002317 {"getqflist", 0, 1, 0, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002318 ret_list_or_dict_0, f_getqflist},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002319 {"getreg", 0, 3, FEARG_1, arg3_string_bool_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002320 ret_getreg, f_getreg},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002321 {"getreginfo", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002322 ret_dict_any, f_getreginfo},
Shougo Matsushita19b71882024-02-28 22:48:12 +01002323 {"getregion", 2, 3, FEARG_1, arg3_list_list_dict,
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01002324 ret_list_string, f_getregion},
zeertzjqd4d12072024-07-16 20:34:16 +02002325 {"getregionpos", 2, 3, FEARG_1, arg3_list_list_dict,
2326 ret_list_regionpos, f_getregionpos},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002327 {"getregtype", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002328 ret_string, f_getregtype},
Yegappan Lakshmanan520f6ef2022-08-25 17:40:40 +01002329 {"getscriptinfo", 0, 1, 0, arg1_dict_any,
Yegappan Lakshmananf768c3d2022-08-22 13:15:13 +01002330 ret_list_dict_any, f_getscriptinfo},
ichizok663d18d2025-01-02 18:06:00 +01002331 {"getstacktrace", 0, 0, 0, NULL,
2332 ret_list_dict_any, f_getstacktrace},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002333 {"gettabinfo", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002334 ret_list_dict_any, f_gettabinfo},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002335 {"gettabvar", 2, 3, FEARG_1, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002336 ret_any, f_gettabvar},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002337 {"gettabwinvar", 3, 4, FEARG_1, arg4_number_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002338 ret_any, f_gettabwinvar},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002339 {"gettagstack", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002340 ret_dict_any, f_gettagstack},
Christ van Willegence0ef912024-06-20 23:41:59 +02002341 {"gettext", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002342 ret_string, f_gettext},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002343 {"getwininfo", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002344 ret_list_dict_any, f_getwininfo},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002345 {"getwinpos", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002346 ret_list_number, f_getwinpos},
2347 {"getwinposx", 0, 0, 0, NULL,
2348 ret_number, f_getwinposx},
2349 {"getwinposy", 0, 0, 0, NULL,
2350 ret_number, f_getwinposy},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002351 {"getwinvar", 2, 3, FEARG_1, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002352 ret_any, f_getwinvar},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002353 {"glob", 1, 4, FEARG_1, arg14_glob,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002354 ret_any, f_glob},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002355 {"glob2regpat", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002356 ret_string, f_glob2regpat},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002357 {"globpath", 2, 5, FEARG_2, arg25_globpath,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002358 ret_any, f_globpath},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002359 {"has", 1, 2, 0, arg2_string_bool,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002360 ret_number_bool, f_has},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002361 {"has_key", 2, 2, FEARG_1, arg2_dict_any_string_or_nr,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002362 ret_number_bool, f_has_key},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002363 {"haslocaldir", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002364 ret_number, f_haslocaldir},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002365 {"hasmapto", 1, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002366 ret_number_bool, f_hasmapto},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002367 {"highlightID", 1, 1, FEARG_1, arg1_string, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02002368 ret_number, f_hlID},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002369 {"highlight_exists",1, 1, FEARG_1, arg1_string, // obsolete
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002370 ret_number_bool, f_hlexists},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002371 {"histadd", 2, 2, FEARG_2, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002372 ret_number_bool, f_histadd},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002373 {"histdel", 1, 2, FEARG_1, arg2_string_string_or_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002374 ret_number_bool, f_histdel},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002375 {"histget", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002376 ret_string, f_histget},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002377 {"histnr", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002378 ret_number, f_histnr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002379 {"hlID", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002380 ret_number, f_hlID},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002381 {"hlexists", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002382 ret_number_bool, f_hlexists},
Yegappan Lakshmanand1a8d652021-11-03 21:56:45 +00002383 {"hlget", 0, 2, FEARG_1, arg2_string_bool,
2384 ret_list_dict_any, f_hlget},
2385 {"hlset", 1, 1, FEARG_1, arg1_list_any,
2386 ret_number_bool, f_hlset},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002387 {"hostname", 0, 0, 0, NULL,
2388 ret_string, f_hostname},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002389 {"iconv", 3, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002390 ret_string, f_iconv},
Ernie Raelc8e158b2024-07-09 18:39:52 +02002391 {"id", 1, 1, FEARG_1, NULL,
2392 ret_string, f_id},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002393 {"indent", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002394 ret_number, f_indent},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002395 {"index", 2, 4, FEARG_1, arg24_index,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002396 ret_number, f_index},
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01002397 {"indexof", 2, 3, FEARG_1, arg23_index,
2398 ret_number, f_indexof},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002399 {"input", 1, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002400 ret_string, f_input},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002401 {"inputdialog", 1, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002402 ret_string, f_inputdialog},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002403 {"inputlist", 1, 1, FEARG_1, arg1_list_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002404 ret_number, f_inputlist},
2405 {"inputrestore", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002406 ret_number_bool, f_inputrestore},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002407 {"inputsave", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002408 ret_number_bool, f_inputsave},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002409 {"inputsecret", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002410 ret_string, f_inputsecret},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002411 {"insert", 2, 3, FEARG_1, arg23_insert,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002412 ret_first_arg, f_insert},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002413 {"instanceof", 2, VARGS, FEARG_1|FE_X, arg2_instanceof,
LemonBoyafe04662023-08-23 21:08:11 +02002414 ret_bool, f_instanceof},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002415 {"interrupt", 0, 0, 0, NULL,
2416 ret_void, f_interrupt},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002417 {"invert", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002418 ret_number, f_invert},
LemonBoydca1d402022-04-28 15:26:33 +01002419 {"isabsolutepath", 1, 1, FEARG_1, arg1_string,
2420 ret_number_bool, f_isabsolutepath},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002421 {"isdirectory", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002422 ret_number_bool, f_isdirectory},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002423 {"isinf", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002424 ret_number, MATH_FUNC(f_isinf)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002425 {"islocked", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002426 ret_number_bool, f_islocked},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002427 {"isnan", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002428 ret_number_bool, MATH_FUNC(f_isnan)},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01002429 {"items", 1, 1, FEARG_1, arg1_string_list_tuple_or_dict,
Bram Moolenaarefc5db52021-07-07 21:21:30 +02002430 ret_list_items, f_items},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002431 {"job_getchannel", 1, 1, FEARG_1, arg1_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002432 ret_channel, JOB_FUNC(f_job_getchannel)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002433 {"job_info", 0, 1, FEARG_1, arg1_job,
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01002434 ret_job_info, JOB_FUNC(f_job_info)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002435 {"job_setoptions", 2, 2, FEARG_1, arg2_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002436 ret_void, JOB_FUNC(f_job_setoptions)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002437 {"job_start", 1, 2, FEARG_1, arg2_string_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002438 ret_job, JOB_FUNC(f_job_start)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002439 {"job_status", 1, 1, FEARG_1, arg1_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002440 ret_string, JOB_FUNC(f_job_status)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002441 {"job_stop", 1, 2, FEARG_1, arg2_job_string_or_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002442 ret_number_bool, JOB_FUNC(f_job_stop)},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01002443 {"join", 1, 2, FEARG_1, arg2_list_or_tuple_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002444 ret_string, f_join},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002445 {"js_decode", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002446 ret_any, f_js_decode},
2447 {"js_encode", 1, 1, FEARG_1, NULL,
2448 ret_string, f_js_encode},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002449 {"json_decode", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002450 ret_any, f_json_decode},
2451 {"json_encode", 1, 1, FEARG_1, NULL,
2452 ret_string, f_json_encode},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002453 {"keys", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002454 ret_list_string, f_keys},
zeertzjqcdc83932022-09-12 13:38:41 +01002455 {"keytrans", 1, 1, FEARG_1, arg1_string,
2456 ret_string, f_keytrans},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002457 {"last_buffer_nr", 0, 0, 0, NULL, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02002458 ret_number, f_last_buffer_nr},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002459 {"len", 1, 1, FEARG_1, arg1_len,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002460 ret_number, f_len},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002461 {"libcall", 3, 3, FEARG_3, arg3_libcall,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002462 ret_string, f_libcall},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002463 {"libcallnr", 3, 3, FEARG_3, arg3_libcall,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002464 ret_number, f_libcallnr},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002465 {"line", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002466 ret_number, f_line},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002467 {"line2byte", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002468 ret_number, f_line2byte},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002469 {"lispindent", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002470 ret_number, f_lispindent},
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +02002471 {"list2blob", 1, 1, FEARG_1, arg1_list_number,
2472 ret_blob, f_list2blob},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002473 {"list2str", 1, 2, FEARG_1, arg2_list_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002474 ret_string, f_list2str},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01002475 {"list2tuple", 1, 1, FEARG_1, arg1_list_any,
2476 ret_tuple_any, f_list2tuple},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002477 {"listener_add", 1, 2, FEARG_2, arg2_any_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002478 ret_number, f_listener_add},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002479 {"listener_flush", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002480 ret_void, f_listener_flush},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002481 {"listener_remove", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002482 ret_number_bool, f_listener_remove},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002483 {"localtime", 0, 0, 0, NULL,
2484 ret_number, f_localtime},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002485 {"log", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002486 ret_float, f_log},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002487 {"log10", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002488 ret_float, f_log10},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002489 {"luaeval", 1, 2, FEARG_1, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002490 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002491#ifdef FEAT_LUA
Bram Moolenaar15c47602020-03-26 22:16:48 +01002492 f_luaeval
2493#else
2494 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002495#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002496 },
Bram Moolenaar18024052021-12-25 21:43:28 +00002497 {"map", 2, 2, FEARG_1, arg2_map,
Bram Moolenaarea696852020-11-09 18:31:39 +01002498 ret_first_cont, f_map},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002499 {"maparg", 1, 4, FEARG_1, arg14_maparg,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002500 ret_maparg, f_maparg},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002501 {"mapcheck", 1, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002502 ret_string, f_mapcheck},
Ernie Rael09661202022-04-25 14:40:44 +01002503 {"maplist", 0, 1, 0, arg1_bool,
2504 ret_list_dict_any, f_maplist},
Bram Moolenaar18024052021-12-25 21:43:28 +00002505 {"mapnew", 2, 2, FEARG_1, arg2_mapnew,
Bram Moolenaarea696852020-11-09 18:31:39 +01002506 ret_first_cont, f_mapnew},
Ernie Rael51d04d12022-05-04 15:40:22 +01002507 {"mapset", 1, 3, FEARG_1, arg3_string_or_dict_bool_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002508 ret_void, f_mapset},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002509 {"match", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002510 ret_any, f_match},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002511 {"matchadd", 2, 5, FEARG_1, arg25_matchadd,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002512 ret_number, f_matchadd},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002513 {"matchaddpos", 2, 5, FEARG_1, arg25_matchaddpos,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002514 ret_number, f_matchaddpos},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002515 {"matcharg", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002516 ret_list_string, f_matcharg},
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01002517 {"matchbufline", 4, 5, FEARG_1, arg45_matchbufline,
2518 ret_list_any, f_matchbufline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002519 {"matchdelete", 1, 2, FEARG_1, arg2_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002520 ret_number_bool, f_matchdelete},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002521 {"matchend", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002522 ret_number, f_matchend},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002523 {"matchfuzzy", 2, 3, FEARG_1, arg3_list_string_dict,
Yegappan Lakshmanan2d8e9982023-06-24 16:42:25 +01002524 ret_list_any, f_matchfuzzy},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002525 {"matchfuzzypos", 2, 3, FEARG_1, arg3_list_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002526 ret_list_any, f_matchfuzzypos},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002527 {"matchlist", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002528 ret_list_string, f_matchlist},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002529 {"matchstr", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002530 ret_string, f_matchstr},
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01002531 {"matchstrlist", 2, 3, FEARG_1, arg23_matchstrlist,
2532 ret_list_any, f_matchstrlist},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002533 {"matchstrpos", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002534 ret_list_any, f_matchstrpos},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01002535 {"max", 1, 1, FEARG_1, arg1_list_or_tuple_or_dict,
Bram Moolenaar9ae37052021-01-22 22:31:10 +01002536 ret_number, f_max},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002537 {"menu_info", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002538 ret_dict_any,
Bram Moolenaara2cbdea2020-03-16 21:08:31 +01002539#ifdef FEAT_MENU
Bram Moolenaar15c47602020-03-26 22:16:48 +01002540 f_menu_info
2541#else
2542 NULL
Bram Moolenaara2cbdea2020-03-16 21:08:31 +01002543#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002544 },
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01002545 {"min", 1, 1, FEARG_1, arg1_list_or_tuple_or_dict,
Bram Moolenaar9ae37052021-01-22 22:31:10 +01002546 ret_number, f_min},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002547 {"mkdir", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002548 ret_number_bool, f_mkdir},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002549 {"mode", 0, 1, FEARG_1, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002550 ret_string, f_mode},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002551 {"mzeval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002552 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002553#ifdef FEAT_MZSCHEME
Bram Moolenaar15c47602020-03-26 22:16:48 +01002554 f_mzeval
2555#else
2556 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002557#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002558 },
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002559 {"nextnonblank", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002560 ret_number, f_nextnonblank},
Christ van Willegenc0786752025-02-01 15:42:16 +01002561 {"ngettext", 3, 4, FEARG_3, arg4_string_string_number_string,
2562 ret_string, f_ngettext},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002563 {"nr2char", 1, 2, FEARG_1, arg2_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002564 ret_string, f_nr2char},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002565 {"or", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002566 ret_number, f_or},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002567 {"pathshorten", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002568 ret_string, f_pathshorten},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002569 {"perleval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002570 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002571#ifdef FEAT_PERL
Bram Moolenaar15c47602020-03-26 22:16:48 +01002572 f_perleval
2573#else
2574 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002575#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002576 },
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002577 {"popup_atcursor", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002578 ret_number, PROP_FUNC(f_popup_atcursor)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002579 {"popup_beval", 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_beval)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002581 {"popup_clear", 0, 1, 0, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002582 ret_void, PROP_FUNC(f_popup_clear)},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002583 {"popup_close", 1, 2, FEARG_1, arg2_number_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002584 ret_void, PROP_FUNC(f_popup_close)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002585 {"popup_create", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002586 ret_number, PROP_FUNC(f_popup_create)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002587 {"popup_dialog", 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_dialog)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002589 {"popup_filter_menu", 2, 2, 0, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002590 ret_bool, PROP_FUNC(f_popup_filter_menu)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002591 {"popup_filter_yesno", 2, 2, 0, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002592 ret_bool, PROP_FUNC(f_popup_filter_yesno)},
Bram Moolenaarbdc09a12022-10-07 14:31:45 +01002593 {"popup_findecho", 0, 0, 0, NULL,
2594 ret_number, PROP_FUNC(f_popup_findecho)},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002595 {"popup_findinfo", 0, 0, 0, NULL,
2596 ret_number, PROP_FUNC(f_popup_findinfo)},
2597 {"popup_findpreview", 0, 0, 0, NULL,
2598 ret_number, PROP_FUNC(f_popup_findpreview)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002599 {"popup_getoptions", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002600 ret_dict_any, PROP_FUNC(f_popup_getoptions)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002601 {"popup_getpos", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002602 ret_dict_any, PROP_FUNC(f_popup_getpos)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002603 {"popup_hide", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002604 ret_void, PROP_FUNC(f_popup_hide)},
2605 {"popup_list", 0, 0, 0, NULL,
2606 ret_list_number, PROP_FUNC(f_popup_list)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002607 {"popup_locate", 2, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002608 ret_number, PROP_FUNC(f_popup_locate)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002609 {"popup_menu", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002610 ret_number, PROP_FUNC(f_popup_menu)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002611 {"popup_move", 2, 2, FEARG_1, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002612 ret_void, PROP_FUNC(f_popup_move)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002613 {"popup_notification", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002614 ret_number, PROP_FUNC(f_popup_notification)},
Christian Brabandtfbc37f12024-06-18 20:50:58 +02002615 {"popup_setbuf", 2, 2, FEARG_1, arg2_number_buffer,
2616 ret_number_bool, PROP_FUNC(f_popup_setbuf)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002617 {"popup_setoptions", 2, 2, FEARG_1, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002618 ret_void, PROP_FUNC(f_popup_setoptions)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002619 {"popup_settext", 2, 2, FEARG_1, arg2_number_string_or_list,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002620 ret_void, PROP_FUNC(f_popup_settext)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002621 {"popup_show", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002622 ret_void, PROP_FUNC(f_popup_show)},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002623 {"pow", 2, 2, FEARG_1, arg2_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002624 ret_float, f_pow},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002625 {"prevnonblank", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002626 ret_number, f_prevnonblank},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002627 {"printf", 1, 19, FEARG_2, arg119_printf,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002628 ret_string, f_printf},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002629 {"prompt_getprompt", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002630 ret_string, JOB_FUNC(f_prompt_getprompt)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002631 {"prompt_setcallback", 2, 2, FEARG_1, arg2_buffer_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002632 ret_void, JOB_FUNC(f_prompt_setcallback)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002633 {"prompt_setinterrupt", 2, 2, FEARG_1, arg2_buffer_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002634 ret_void, JOB_FUNC(f_prompt_setinterrupt)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002635 {"prompt_setprompt", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002636 ret_void, JOB_FUNC(f_prompt_setprompt)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002637 {"prop_add", 3, 3, FEARG_1, arg3_number_number_dict,
Bram Moolenaar7f9969c2022-07-25 18:13:54 +01002638 ret_number, PROP_FUNC(f_prop_add)},
Yegappan Lakshmananccfb7c62021-08-16 21:39:09 +02002639 {"prop_add_list", 2, 2, FEARG_1, arg2_dict_any_list_any,
2640 ret_void, PROP_FUNC(f_prop_add_list)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002641 {"prop_clear", 1, 3, FEARG_1, arg3_number_number_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002642 ret_void, PROP_FUNC(f_prop_clear)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002643 {"prop_find", 1, 2, FEARG_1, arg2_dict_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002644 ret_dict_any, PROP_FUNC(f_prop_find)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002645 {"prop_list", 1, 2, FEARG_1, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002646 ret_list_dict_any, PROP_FUNC(f_prop_list)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002647 {"prop_remove", 1, 3, FEARG_1, arg3_dict_number_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002648 ret_number, PROP_FUNC(f_prop_remove)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002649 {"prop_type_add", 2, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002650 ret_void, PROP_FUNC(f_prop_type_add)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002651 {"prop_type_change", 2, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002652 ret_void, PROP_FUNC(f_prop_type_change)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002653 {"prop_type_delete", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002654 ret_void, PROP_FUNC(f_prop_type_delete)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002655 {"prop_type_get", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002656 ret_dict_any, PROP_FUNC(f_prop_type_get)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002657 {"prop_type_list", 0, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002658 ret_list_string, PROP_FUNC(f_prop_type_list)},
2659 {"pum_getpos", 0, 0, 0, NULL,
2660 ret_dict_number, f_pum_getpos},
2661 {"pumvisible", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002662 ret_number_bool, f_pumvisible},
Ben Jacksonea19e782024-11-06 21:50:05 +01002663 {"py3eval", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002664 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002665#ifdef FEAT_PYTHON3
Bram Moolenaar15c47602020-03-26 22:16:48 +01002666 f_py3eval
2667#else
2668 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002669#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002670 },
Ben Jacksonea19e782024-11-06 21:50:05 +01002671 {"pyeval", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002672 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002673#ifdef FEAT_PYTHON
Bram Moolenaar15c47602020-03-26 22:16:48 +01002674 f_pyeval
2675#else
2676 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002677#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002678 },
Ben Jacksonea19e782024-11-06 21:50:05 +01002679 {"pyxeval", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002680 ret_any,
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01002681#if defined(FEAT_PYTHON) || defined(FEAT_PYTHON3)
Bram Moolenaar15c47602020-03-26 22:16:48 +01002682 f_pyxeval
2683#else
2684 NULL
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01002685#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002686 },
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002687 {"rand", 0, 1, FEARG_1, arg1_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002688 ret_number, f_rand},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002689 {"range", 1, 3, FEARG_1, arg3_number,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00002690 ret_list_number, f_range},
K.Takata11df3ae2022-10-19 14:02:40 +01002691 {"readblob", 1, 3, FEARG_1, arg3_string_number_number,
Bram Moolenaarc423ad72021-01-13 20:38:03 +01002692 ret_blob, f_readblob},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002693 {"readdir", 1, 3, FEARG_1, arg3_string_any_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002694 ret_list_string, f_readdir},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002695 {"readdirex", 1, 3, FEARG_1, arg3_string_any_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002696 ret_list_dict_any, f_readdirex},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002697 {"readfile", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaarc423ad72021-01-13 20:38:03 +01002698 ret_list_string, f_readfile},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002699 {"reduce", 2, 3, FEARG_1, arg23_reduce,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002700 ret_any, f_reduce},
2701 {"reg_executing", 0, 0, 0, NULL,
2702 ret_string, f_reg_executing},
2703 {"reg_recording", 0, 0, 0, NULL,
2704 ret_string, f_reg_recording},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002705 {"reltime", 0, 2, FEARG_1, arg2_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002706 ret_list_any, f_reltime},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002707 {"reltimefloat", 1, 1, FEARG_1, arg1_list_number,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002708 ret_float, f_reltimefloat},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002709 {"reltimestr", 1, 1, FEARG_1, arg1_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002710 ret_string, f_reltimestr},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002711 {"remote_expr", 2, 4, FEARG_1, arg24_remote_expr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002712 ret_string, f_remote_expr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002713 {"remote_foreground", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002714 ret_string, f_remote_foreground},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002715 {"remote_peek", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002716 ret_number, f_remote_peek},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002717 {"remote_read", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002718 ret_string, f_remote_read},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002719 {"remote_send", 2, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002720 ret_string, f_remote_send},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002721 {"remote_startserver", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002722 ret_void, f_remote_startserver},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002723 {"remove", 2, 3, FEARG_1, arg23_remove,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002724 ret_remove, f_remove},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002725 {"rename", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002726 ret_number_bool, f_rename},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002727 {"repeat", 2, 2, FEARG_1, arg2_repeat,
Bram Moolenaar1780f082021-07-31 22:03:59 +02002728 ret_repeat, f_repeat},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002729 {"resolve", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002730 ret_string, f_resolve},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01002731 {"reverse", 1, 1, FEARG_1, arg1_reverse,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002732 ret_first_arg, f_reverse},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002733 {"round", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002734 ret_float, f_round},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002735 {"rubyeval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002736 ret_any,
Bram Moolenaare99be0e2019-03-26 22:51:09 +01002737#ifdef FEAT_RUBY
Bram Moolenaar15c47602020-03-26 22:16:48 +01002738 f_rubyeval
2739#else
2740 NULL
Bram Moolenaare99be0e2019-03-26 22:51:09 +01002741#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002742 },
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002743 {"screenattr", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002744 ret_number, f_screenattr},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002745 {"screenchar", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002746 ret_number, f_screenchar},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002747 {"screenchars", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002748 ret_list_number, f_screenchars},
2749 {"screencol", 0, 0, 0, NULL,
2750 ret_number, f_screencol},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002751 {"screenpos", 3, 3, FEARG_1, arg3_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002752 ret_dict_number, f_screenpos},
2753 {"screenrow", 0, 0, 0, NULL,
2754 ret_number, f_screenrow},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002755 {"screenstring", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002756 ret_string, f_screenstring},
Bram Moolenaarcd268012021-07-22 19:11:08 +02002757 {"search", 1, 5, FEARG_1, arg15_search,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002758 ret_number, f_search},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002759 {"searchcount", 0, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002760 ret_dict_any, f_searchcount},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002761 {"searchdecl", 1, 3, FEARG_1, arg3_string_bool_bool,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002762 ret_number_bool, f_searchdecl},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002763 {"searchpair", 3, 7, 0, arg37_searchpair,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002764 ret_number, f_searchpair},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002765 {"searchpairpos", 3, 7, 0, arg37_searchpair,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002766 ret_list_number, f_searchpairpos},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002767 {"searchpos", 1, 5, FEARG_1, arg15_search,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002768 ret_list_number, f_searchpos},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002769 {"server2client", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002770 ret_number_bool, f_server2client},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002771 {"serverlist", 0, 0, 0, NULL,
2772 ret_string, f_serverlist},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002773 {"setbufline", 3, 3, FEARG_3, arg3_setbufline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002774 ret_number_bool, f_setbufline},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002775 {"setbufvar", 3, 3, FEARG_3, arg3_buffer_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002776 ret_void, f_setbufvar},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002777 {"setcellwidths", 1, 1, FEARG_1, arg1_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002778 ret_void, f_setcellwidths},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002779 {"setcharpos", 2, 2, FEARG_2, arg2_string_list_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002780 ret_number_bool, f_setcharpos},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002781 {"setcharsearch", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002782 ret_void, f_setcharsearch},
Shougo Matsushita07ea5f12022-08-27 12:22:25 +01002783 {"setcmdline", 1, 2, FEARG_1, arg2_string_number,
2784 ret_number_bool, f_setcmdline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002785 {"setcmdpos", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002786 ret_number_bool, f_setcmdpos},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002787 {"setcursorcharpos", 1, 3, FEARG_1, arg13_cursor,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002788 ret_number_bool, f_setcursorcharpos},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002789 {"setenv", 2, 2, FEARG_2, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002790 ret_void, f_setenv},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002791 {"setfperm", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002792 ret_number_bool, f_setfperm},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002793 {"setline", 2, 2, FEARG_2, arg2_setline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002794 ret_number_bool, f_setline},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002795 {"setloclist", 2, 4, FEARG_2, arg24_setloclist,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002796 ret_number_bool, f_setloclist},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002797 {"setmatches", 1, 2, FEARG_1, arg2_list_any_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002798 ret_number_bool, f_setmatches},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002799 {"setpos", 2, 2, FEARG_2, arg2_string_list_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002800 ret_number_bool, f_setpos},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002801 {"setqflist", 1, 3, FEARG_1, arg13_setqflist,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002802 ret_number_bool, f_setqflist},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002803 {"setreg", 2, 3, FEARG_2, arg3_string_any_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002804 ret_number_bool, f_setreg},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002805 {"settabvar", 3, 3, FEARG_3, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002806 ret_void, f_settabvar},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002807 {"settabwinvar", 4, 4, FEARG_4, arg4_number_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002808 ret_void, f_settabwinvar},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002809 {"settagstack", 2, 3, FEARG_2, arg23_settagstack,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002810 ret_number_bool, f_settagstack},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002811 {"setwinvar", 3, 3, FEARG_3, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002812 ret_void, f_setwinvar},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002813 {"sha256", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002814 ret_string,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002815#ifdef FEAT_CRYPT
Bram Moolenaar15c47602020-03-26 22:16:48 +01002816 f_sha256
2817#else
2818 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002819#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002820 },
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002821 {"shellescape", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002822 ret_string, f_shellescape},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002823 {"shiftwidth", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002824 ret_number, f_shiftwidth},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002825 {"sign_define", 1, 2, FEARG_1, arg2_string_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002826 ret_any, SIGN_FUNC(f_sign_define)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002827 {"sign_getdefined", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002828 ret_list_dict_any, SIGN_FUNC(f_sign_getdefined)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002829 {"sign_getplaced", 0, 2, FEARG_1, arg02_sign_getplaced,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002830 ret_list_dict_any, SIGN_FUNC(f_sign_getplaced)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002831 {"sign_jump", 3, 3, FEARG_1, arg3_number_string_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002832 ret_number, SIGN_FUNC(f_sign_jump)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002833 {"sign_place", 4, 5, FEARG_1, arg45_sign_place,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002834 ret_number, SIGN_FUNC(f_sign_place)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002835 {"sign_placelist", 1, 1, FEARG_1, arg1_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002836 ret_list_number, SIGN_FUNC(f_sign_placelist)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002837 {"sign_undefine", 0, 1, FEARG_1, arg1_string_or_list_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002838 ret_number_bool, SIGN_FUNC(f_sign_undefine)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002839 {"sign_unplace", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002840 ret_number_bool, SIGN_FUNC(f_sign_unplace)},
Sean Dewara63780b2021-11-03 13:15:47 +00002841 {"sign_unplacelist", 1, 1, FEARG_1, arg1_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002842 ret_list_number, SIGN_FUNC(f_sign_unplacelist)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002843 {"simplify", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002844 ret_string, f_simplify},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002845 {"sin", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002846 ret_float, f_sin},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002847 {"sinh", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002848 ret_float, f_sinh},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002849 {"slice", 2, 3, FEARG_1, arg23_slice,
Bram Moolenaar00eb9952022-02-05 19:23:18 +00002850 ret_slice, f_slice},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002851 {"sort", 1, 3, FEARG_1, arg13_sortuniq,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002852 ret_first_arg, f_sort},
2853 {"sound_clear", 0, 0, 0, NULL,
2854 ret_void, SOUND_FUNC(f_sound_clear)},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002855 {"sound_playevent", 1, 2, FEARG_1, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002856 ret_number, SOUND_FUNC(f_sound_playevent)},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002857 {"sound_playfile", 1, 2, FEARG_1, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002858 ret_number, SOUND_FUNC(f_sound_playfile)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002859 {"sound_stop", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002860 ret_void, SOUND_FUNC(f_sound_stop)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002861 {"soundfold", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002862 ret_string, f_soundfold},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002863 {"spellbadword", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002864 ret_list_string, f_spellbadword},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002865 {"spellsuggest", 1, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002866 ret_list_string, f_spellsuggest},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002867 {"split", 1, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002868 ret_list_string, f_split},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002869 {"sqrt", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002870 ret_float, f_sqrt},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002871 {"srand", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002872 ret_list_number, f_srand},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002873 {"state", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002874 ret_string, f_state},
Yegappan Lakshmanana11b23c2025-01-16 19:16:42 +01002875 {"str2blob", 1, 2, FEARG_1, arg2_list_string_dict,
Yegappan Lakshmanan1aefe1d2025-01-14 17:29:42 +01002876 ret_blob, f_str2blob},
Bram Moolenaar80a070c2021-08-08 15:51:10 +02002877 {"str2float", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002878 ret_float, f_str2float},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002879 {"str2list", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002880 ret_list_number, f_str2list},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002881 {"str2nr", 1, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002882 ret_number, f_str2nr},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002883 {"strcharlen", 1, 1, FEARG_1, arg1_string_or_nr,
Bram Moolenaar70ce8a12021-03-14 19:02:09 +01002884 ret_number, f_strcharlen},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002885 {"strcharpart", 2, 4, FEARG_1, arg24_strpart,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002886 ret_string, f_strcharpart},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002887 {"strchars", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002888 ret_number, f_strchars},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002889 {"strdisplaywidth", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002890 ret_number, f_strdisplaywidth},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002891 {"strftime", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002892 ret_string,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002893#ifdef HAVE_STRFTIME
Bram Moolenaar15c47602020-03-26 22:16:48 +01002894 f_strftime
2895#else
2896 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002897#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002898 },
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002899 {"strgetchar", 2, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002900 ret_number, f_strgetchar},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002901 {"stridx", 2, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002902 ret_number, f_stridx},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002903 {"string", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002904 ret_string, f_string},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002905 {"strlen", 1, 1, FEARG_1, arg1_string_or_nr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002906 ret_number, f_strlen},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002907 {"strpart", 2, 4, FEARG_1, arg24_strpart,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002908 ret_string, f_strpart},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002909 {"strptime", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002910 ret_number,
Bram Moolenaar10455d42019-11-21 15:36:18 +01002911#ifdef HAVE_STRPTIME
Bram Moolenaar15c47602020-03-26 22:16:48 +01002912 f_strptime
2913#else
2914 NULL
Bram Moolenaar10455d42019-11-21 15:36:18 +01002915#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002916 },
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002917 {"strridx", 2, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002918 ret_number, f_strridx},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002919 {"strtrans", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002920 ret_string, f_strtrans},
Christian Brabandt67672ef2023-04-24 21:09:54 +01002921 {"strutf16len", 1, 2, FEARG_1, arg2_string_bool,
2922 ret_number, f_strutf16len},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002923 {"strwidth", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002924 ret_number, f_strwidth},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002925 {"submatch", 1, 2, FEARG_1, arg2_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002926 ret_string, f_submatch},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002927 {"substitute", 4, 4, FEARG_1, arg4_string_string_any_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002928 ret_string, f_substitute},
Bram Moolenaarc216a7a2022-12-05 13:50:55 +00002929 {"swapfilelist", 0, 0, 0, NULL,
2930 ret_list_string, f_swapfilelist},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002931 {"swapinfo", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002932 ret_dict_any, f_swapinfo},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002933 {"swapname", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002934 ret_string, f_swapname},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002935 {"synID", 3, 3, 0, arg3_lnum_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002936 ret_number, f_synID},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002937 {"synIDattr", 2, 3, FEARG_1, arg3_number_string_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002938 ret_string, f_synIDattr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002939 {"synIDtrans", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002940 ret_number, f_synIDtrans},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002941 {"synconcealed", 2, 2, 0, arg2_lnum_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002942 ret_list_any, f_synconcealed},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002943 {"synstack", 2, 2, 0, arg2_lnum_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002944 ret_list_number, f_synstack},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002945 {"system", 1, 2, FEARG_1, arg12_system,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002946 ret_string, f_system},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002947 {"systemlist", 1, 2, FEARG_1, arg12_system,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002948 ret_list_string, f_systemlist},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002949 {"tabpagebuflist", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002950 ret_list_number, f_tabpagebuflist},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002951 {"tabpagenr", 0, 1, 0, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002952 ret_number, f_tabpagenr},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002953 {"tabpagewinnr", 1, 2, FEARG_1, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002954 ret_number, f_tabpagewinnr},
2955 {"tagfiles", 0, 0, 0, NULL,
2956 ret_list_string, f_tagfiles},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002957 {"taglist", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002958 ret_list_dict_any, f_taglist},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002959 {"tan", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002960 ret_float, f_tan},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002961 {"tanh", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002962 ret_float, f_tanh},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002963 {"tempname", 0, 0, 0, NULL,
2964 ret_string, f_tempname},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002965 {"term_dumpdiff", 2, 3, FEARG_1, arg3_string_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002966 ret_number, TERM_FUNC(f_term_dumpdiff)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002967 {"term_dumpload", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002968 ret_number, TERM_FUNC(f_term_dumpload)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002969 {"term_dumpwrite", 2, 3, FEARG_2, arg3_buffer_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002970 ret_void, TERM_FUNC(f_term_dumpwrite)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002971 {"term_getaltscreen", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002972 ret_number, TERM_FUNC(f_term_getaltscreen)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002973 {"term_getansicolors", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002974 ret_list_string,
Bram Moolenaarbd5e6222020-03-26 23:13:34 +01002975#if defined(FEAT_TERMINAL) && (defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS))
Bram Moolenaar15c47602020-03-26 22:16:48 +01002976 f_term_getansicolors
2977#else
2978 NULL
Bram Moolenaarc6df10e2017-07-29 20:15:08 +02002979#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002980 },
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002981 {"term_getattr", 2, 2, FEARG_1, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002982 ret_number, TERM_FUNC(f_term_getattr)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002983 {"term_getcursor", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002984 ret_list_any, TERM_FUNC(f_term_getcursor)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002985 {"term_getjob", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002986 ret_job, TERM_FUNC(f_term_getjob)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002987 {"term_getline", 2, 2, FEARG_1, arg2_buffer_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002988 ret_string, TERM_FUNC(f_term_getline)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002989 {"term_getscrolled", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002990 ret_number, TERM_FUNC(f_term_getscrolled)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002991 {"term_getsize", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002992 ret_list_number, TERM_FUNC(f_term_getsize)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002993 {"term_getstatus", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002994 ret_string, TERM_FUNC(f_term_getstatus)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002995 {"term_gettitle", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002996 ret_string, TERM_FUNC(f_term_gettitle)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002997 {"term_gettty", 1, 2, FEARG_1, arg2_buffer_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002998 ret_string, TERM_FUNC(f_term_gettty)},
2999 {"term_list", 0, 0, 0, NULL,
3000 ret_list_number, TERM_FUNC(f_term_list)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003001 {"term_scrape", 2, 2, FEARG_1, arg2_buffer_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003002 ret_list_dict_any, TERM_FUNC(f_term_scrape)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003003 {"term_sendkeys", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003004 ret_void, TERM_FUNC(f_term_sendkeys)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003005 {"term_setansicolors", 2, 2, FEARG_1, arg2_buffer_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003006 ret_void,
Bram Moolenaarbd5e6222020-03-26 23:13:34 +01003007#if defined(FEAT_TERMINAL) && (defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS))
Bram Moolenaar15c47602020-03-26 22:16:48 +01003008 f_term_setansicolors
3009#else
3010 NULL
3011#endif
3012 },
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003013 {"term_setapi", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003014 ret_void, TERM_FUNC(f_term_setapi)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003015 {"term_setkill", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003016 ret_void, TERM_FUNC(f_term_setkill)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003017 {"term_setrestore", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003018 ret_void, TERM_FUNC(f_term_setrestore)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003019 {"term_setsize", 3, 3, FEARG_1, arg3_buffer_number_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003020 ret_void, TERM_FUNC(f_term_setsize)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003021 {"term_start", 1, 2, FEARG_1, arg2_string_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003022 ret_number, TERM_FUNC(f_term_start)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003023 {"term_wait", 1, 2, FEARG_1, arg2_buffer_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003024 ret_void, TERM_FUNC(f_term_wait)},
3025 {"terminalprops", 0, 0, 0, NULL,
3026 ret_dict_string, f_terminalprops},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003027 {"test_alloc_fail", 3, 3, FEARG_1, arg3_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003028 ret_void, f_test_alloc_fail},
3029 {"test_autochdir", 0, 0, 0, NULL,
3030 ret_void, f_test_autochdir},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003031 {"test_feedinput", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003032 ret_void, f_test_feedinput},
3033 {"test_garbagecollect_now", 0, 0, 0, NULL,
3034 ret_void, f_test_garbagecollect_now},
3035 {"test_garbagecollect_soon", 0, 0, 0, NULL,
3036 ret_void, f_test_garbagecollect_soon},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003037 {"test_getvalue", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003038 ret_number, f_test_getvalue},
Yegappan Lakshmanan06011e12022-01-30 12:37:29 +00003039 {"test_gui_event", 2, 2, FEARG_1, arg2_string_dict,
3040 ret_bool, f_test_gui_event},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003041 {"test_ignore_error", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003042 ret_void, f_test_ignore_error},
Christopher Plewright20b795e2022-12-20 20:01:58 +00003043 {"test_mswin_event", 2, 2, FEARG_1, arg2_string_dict,
3044 ret_number, f_test_mswin_event},
Bram Moolenaar94738d82020-10-21 14:25:07 +02003045 {"test_null_blob", 0, 0, 0, NULL,
3046 ret_blob, f_test_null_blob},
3047 {"test_null_channel", 0, 0, 0, NULL,
3048 ret_channel, JOB_FUNC(f_test_null_channel)},
3049 {"test_null_dict", 0, 0, 0, NULL,
3050 ret_dict_any, f_test_null_dict},
3051 {"test_null_function", 0, 0, 0, NULL,
3052 ret_func_any, f_test_null_function},
3053 {"test_null_job", 0, 0, 0, NULL,
3054 ret_job, JOB_FUNC(f_test_null_job)},
3055 {"test_null_list", 0, 0, 0, NULL,
3056 ret_list_any, f_test_null_list},
3057 {"test_null_partial", 0, 0, 0, NULL,
3058 ret_func_any, f_test_null_partial},
3059 {"test_null_string", 0, 0, 0, NULL,
3060 ret_string, f_test_null_string},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01003061 {"test_null_tuple", 0, 0, 0, NULL,
3062 ret_tuple_any, f_test_null_tuple},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003063 {"test_option_not_set", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003064 ret_void, f_test_option_not_set},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02003065 {"test_override", 2, 2, FEARG_2, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003066 ret_void, f_test_override},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003067 {"test_refcount", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003068 ret_number, f_test_refcount},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003069 {"test_setmouse", 2, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003070 ret_void, f_test_setmouse},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003071 {"test_settime", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003072 ret_void, f_test_settime},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003073 {"test_srand_seed", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003074 ret_void, f_test_srand_seed},
3075 {"test_unknown", 0, 0, 0, NULL,
3076 ret_any, f_test_unknown},
3077 {"test_void", 0, 0, 0, NULL,
3078 ret_void, f_test_void},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02003079 {"timer_info", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003080 ret_list_dict_any, TIMER_FUNC(f_timer_info)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003081 {"timer_pause", 2, 2, FEARG_1, arg2_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003082 ret_void, TIMER_FUNC(f_timer_pause)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02003083 {"timer_start", 2, 3, FEARG_1, arg3_number_any_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003084 ret_number, TIMER_FUNC(f_timer_start)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02003085 {"timer_stop", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003086 ret_void, TIMER_FUNC(f_timer_stop)},
3087 {"timer_stopall", 0, 0, 0, NULL,
3088 ret_void, TIMER_FUNC(f_timer_stopall)},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003089 {"tolower", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003090 ret_string, f_tolower},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003091 {"toupper", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003092 ret_string, f_toupper},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003093 {"tr", 3, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003094 ret_string, f_tr},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003095 {"trim", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003096 ret_string, f_trim},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003097 {"trunc", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01003098 ret_float, f_trunc},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01003099 {"tuple2list", 1, 1, FEARG_1, arg1_tuple_any,
3100 ret_list_any, f_tuple2list},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003101 {"type", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003102 ret_number, f_type},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003103 {"typename", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaara47e05f2021-01-12 21:49:00 +01003104 ret_string, f_typename},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02003105 {"undofile", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003106 ret_string, f_undofile},
Devin J. Pohly5fee1112023-04-23 20:26:59 -05003107 {"undotree", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003108 ret_dict_any, f_undotree},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02003109 {"uniq", 1, 3, FEARG_1, arg13_sortuniq,
Bram Moolenaar08018222021-12-22 18:45:37 +00003110 ret_first_arg, f_uniq},
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01003111 {"utf16idx", 2, 4, FEARG_1, arg4_string_number_bool_bool,
Christian Brabandt67672ef2023-04-24 21:09:54 +01003112 ret_number, f_utf16idx},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02003113 {"values", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar32517c42023-01-15 18:17:12 +00003114 ret_list_member, f_values},
zeertzjq825cf812023-08-17 22:55:25 +02003115 {"virtcol", 1, 3, FEARG_1, arg3_string_or_list_bool_number,
LemonBoy0f7a3e12022-05-26 12:10:37 +01003116 ret_virtcol, f_virtcol},
Bram Moolenaar5a6ec102022-05-27 21:58:00 +01003117 {"virtcol2col", 3, 3, FEARG_1, arg3_number,
3118 ret_number, f_virtcol2col},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02003119 {"visualmode", 0, 1, 0, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003120 ret_string, f_visualmode},
3121 {"wildmenumode", 0, 0, 0, NULL,
3122 ret_number, f_wildmenumode},
Bram Moolenaar52312242021-07-11 18:23:19 +02003123 {"win_execute", 2, 3, FEARG_2, arg23_win_execute,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003124 ret_string, f_win_execute},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02003125 {"win_findbuf", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003126 ret_list_number, f_win_findbuf},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02003127 {"win_getid", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003128 ret_number, f_win_getid},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003129 {"win_gettype", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003130 ret_string, f_win_gettype},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003131 {"win_gotoid", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01003132 ret_number_bool, f_win_gotoid},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003133 {"win_id2tabwin", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003134 ret_list_number, f_win_id2tabwin},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003135 {"win_id2win", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003136 ret_number, f_win_id2win},
Daniel Steinbergee630312022-01-10 13:36:34 +00003137 {"win_move_separator", 2, 2, FEARG_1, arg2_number,
3138 ret_number_bool, f_win_move_separator},
3139 {"win_move_statusline", 2, 2, FEARG_1, arg2_number,
3140 ret_number_bool, f_win_move_statusline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003141 {"win_screenpos", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003142 ret_list_number, f_win_screenpos},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02003143 {"win_splitmove", 2, 3, FEARG_1, arg3_number_number_dict,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01003144 ret_number_bool, f_win_splitmove},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003145 {"winbufnr", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003146 ret_number, f_winbufnr},
3147 {"wincol", 0, 0, 0, NULL,
3148 ret_number, f_wincol},
3149 {"windowsversion", 0, 0, 0, NULL,
3150 ret_string, f_windowsversion},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003151 {"winheight", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003152 ret_number, f_winheight},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003153 {"winlayout", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003154 ret_list_any, f_winlayout},
3155 {"winline", 0, 0, 0, NULL,
3156 ret_number, f_winline},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02003157 {"winnr", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003158 ret_number, f_winnr},
3159 {"winrestcmd", 0, 0, 0, NULL,
3160 ret_string, f_winrestcmd},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02003161 {"winrestview", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003162 ret_void, f_winrestview},
3163 {"winsaveview", 0, 0, 0, NULL,
Bram Moolenaar43b69b32021-01-07 20:23:33 +01003164 ret_dict_number, f_winsaveview},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003165 {"winwidth", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003166 ret_number, f_winwidth},
3167 {"wordcount", 0, 0, 0, NULL,
3168 ret_dict_number, f_wordcount},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02003169 {"writefile", 2, 3, FEARG_1, arg23_writefile,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01003170 ret_number_bool, f_writefile},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003171 {"xor", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003172 ret_number, f_xor},
Bram Moolenaarac92e252019-08-03 21:58:38 +02003173};
3174
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003175/*
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003176 * Return true if specified function allows a type as an argument.
3177 */
3178 static int
3179func_allows_type(int idx)
3180{
3181 return (global_functions[idx].f_argtype & FE_X) != 0;
3182}
3183
3184/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003185 * Function given to ExpandGeneric() to obtain the list of internal
3186 * or user defined function names.
3187 */
3188 char_u *
3189get_function_name(expand_T *xp, int idx)
3190{
3191 static int intidx = -1;
3192 char_u *name;
3193
3194 if (idx == 0)
3195 intidx = -1;
3196 if (intidx < 0)
3197 {
3198 name = get_user_func_name(xp, idx);
naohiro ono5aec7552021-08-19 21:20:41 +02003199 if (name != NULL)
Bram Moolenaar1bb4de52021-01-13 19:48:46 +01003200 {
naohiro ono5aec7552021-08-19 21:20:41 +02003201 if (*name != NUL && *name != '<'
3202 && STRNCMP("g:", xp->xp_pattern, 2) == 0)
Bram Moolenaar1bb4de52021-01-13 19:48:46 +01003203 return cat_prefix_varname('g', name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003204 return name;
Bram Moolenaar1bb4de52021-01-13 19:48:46 +01003205 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003206 }
K.Takataeeec2542021-06-02 13:28:16 +02003207 if (++intidx < (int)ARRAY_LENGTH(global_functions))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003208 {
Kota Kato90c23532023-01-18 15:27:38 +00003209 // Skip if the function doesn't have an implementation (feature not
3210 // implemented).
3211 if (global_functions[intidx].f_func == NULL)
3212 return (char_u *)"";
Bram Moolenaarac92e252019-08-03 21:58:38 +02003213 STRCPY(IObuff, global_functions[intidx].f_name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003214 STRCAT(IObuff, "(");
Bram Moolenaarac92e252019-08-03 21:58:38 +02003215 if (global_functions[intidx].f_max_argc == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003216 STRCAT(IObuff, ")");
3217 return IObuff;
3218 }
3219
3220 return NULL;
3221}
3222
3223/*
3224 * Function given to ExpandGeneric() to obtain the list of internal or
3225 * user defined variable or function names.
3226 */
3227 char_u *
3228get_expr_name(expand_T *xp, int idx)
3229{
3230 static int intidx = -1;
3231 char_u *name;
3232
3233 if (idx == 0)
3234 intidx = -1;
3235 if (intidx < 0)
3236 {
3237 name = get_function_name(xp, idx);
3238 if (name != NULL)
3239 return name;
3240 }
3241 return get_user_var_name(xp, ++intidx);
3242}
3243
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003244/*
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003245 * Find internal function "name" in table "global_functions".
Bram Moolenaar15c47602020-03-26 22:16:48 +01003246 * Return index, or -1 if not found or "implemented" is TRUE and the function
3247 * is not implemented.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003248 */
Bram Moolenaar15c47602020-03-26 22:16:48 +01003249 static int
3250find_internal_func_opt(char_u *name, int implemented)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003251{
3252 int first = 0;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003253 int last;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003254 int cmp;
3255 int x;
3256
K.Takataeeec2542021-06-02 13:28:16 +02003257 last = (int)ARRAY_LENGTH(global_functions) - 1;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003258
3259 // Find the function name in the table. Binary search.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003260 while (first <= last)
3261 {
3262 x = first + ((unsigned)(last - first) >> 1);
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003263 cmp = STRCMP(name, global_functions[x].f_name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003264 if (cmp < 0)
3265 last = x - 1;
3266 else if (cmp > 0)
3267 first = x + 1;
Bram Moolenaar15c47602020-03-26 22:16:48 +01003268 else if (implemented && global_functions[x].f_func == NULL)
3269 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003270 else
3271 return x;
3272 }
3273 return -1;
3274}
3275
Bram Moolenaar15c47602020-03-26 22:16:48 +01003276/*
3277 * Find internal function "name" in table "global_functions".
3278 * Return index, or -1 if not found or the function is not implemented.
3279 */
3280 int
3281find_internal_func(char_u *name)
3282{
3283 return find_internal_func_opt(name, TRUE);
3284}
3285
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003286 int
Bram Moolenaarac92e252019-08-03 21:58:38 +02003287has_internal_func(char_u *name)
3288{
Bram Moolenaar15c47602020-03-26 22:16:48 +01003289 return find_internal_func_opt(name, TRUE) >= 0;
3290}
3291
3292 static int
3293has_internal_func_name(char_u *name)
3294{
3295 return find_internal_func_opt(name, FALSE) >= 0;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003296}
3297
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003298 char *
3299internal_func_name(int idx)
3300{
3301 return global_functions[idx].f_name;
3302}
3303
Bram Moolenaar94738d82020-10-21 14:25:07 +02003304/*
Dominique Pellefe8ebdb2021-05-13 14:55:55 +02003305 * Check the argument types for builtin function "idx".
Bram Moolenaar94738d82020-10-21 14:25:07 +02003306 * Uses the list of types on the type stack: "types".
3307 * Return FAIL and gives an error message when a type is wrong.
3308 */
3309 int
Bram Moolenaar351ead02021-01-16 16:07:01 +01003310internal_func_check_arg_types(
Bram Moolenaar078a4612022-01-04 15:17:03 +00003311 type2_T *types,
Bram Moolenaar351ead02021-01-16 16:07:01 +01003312 int idx,
3313 int argcount,
3314 cctx_T *cctx)
Bram Moolenaar94738d82020-10-21 14:25:07 +02003315{
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003316 // Some internal functions accept types like Class as arguments. For other
3317 // functions, check the arguments are not types.
3318 if (!(func_allows_type(idx)))
3319 {
zeertzjqd9be94c2024-07-14 10:20:20 +02003320 for (int i = 0; i < argcount; ++i)
3321 if (check_type_is_value(types[i].type_curr) == FAIL)
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003322 return FAIL;
3323 }
3324
Bram Moolenaar94738d82020-10-21 14:25:07 +02003325 argcheck_T *argchecks = global_functions[idx].f_argcheck;
Bram Moolenaar94738d82020-10-21 14:25:07 +02003326
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003327 if (argchecks == NULL)
3328 return OK;
Bram Moolenaar94738d82020-10-21 14:25:07 +02003329
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003330 argcontext_T context;
3331
3332 context.arg_count = argcount;
3333 context.arg_types = types;
3334 context.arg_cctx = cctx;
Ernie Raela8f7f922023-12-14 20:17:04 +01003335 for (int i = 0; i < argcount && argchecks[i] != NULL; ++i)
3336 {
3337 context.arg_idx = i;
3338 if (argchecks[i](types[i].type_curr, types[i].type_decl,
3339 &context) == FAIL)
3340 return FAIL;
3341 }
Bram Moolenaar94738d82020-10-21 14:25:07 +02003342 return OK;
3343}
3344
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003345/*
Bram Moolenaar7a40ff02021-07-04 15:54:08 +02003346 * Get the argument count for function "idx".
3347 * "argcount" is the total argument count, "min_argcount" the non-optional
3348 * argument count.
3349 */
3350 void
3351internal_func_get_argcount(int idx, int *argcount, int *min_argcount)
3352{
3353 *argcount = global_functions[idx].f_max_argc;
3354 *min_argcount = global_functions[idx].f_min_argc;
3355}
3356
3357/*
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003358 * Call the "f_retfunc" function to obtain the return type of function "idx".
Bram Moolenaar81330182022-02-01 12:11:58 +00003359 * "decl_type" is set to the declared type.
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003360 * "argtypes" is the list of argument types or NULL when there are no
3361 * arguments.
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02003362 * "argcount" may be less than the actual count when only getting the type.
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003363 */
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003364 type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00003365internal_func_ret_type(
3366 int idx,
3367 int argcount,
3368 type2_T *argtypes,
Bram Moolenaar32517c42023-01-15 18:17:12 +00003369 type_T **decl_type,
3370 garray_T *type_gap)
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003371{
Bram Moolenaar81330182022-02-01 12:11:58 +00003372 type_T *ret;
3373
Bram Moolenaar32517c42023-01-15 18:17:12 +00003374 current_type_gap = type_gap;
Bram Moolenaar81330182022-02-01 12:11:58 +00003375 *decl_type = NULL;
3376 ret = global_functions[idx].f_retfunc(argcount, argtypes, decl_type);
3377 if (*decl_type == NULL)
3378 *decl_type = ret;
Bram Moolenaar32517c42023-01-15 18:17:12 +00003379 current_type_gap = NULL;
Bram Moolenaar81330182022-02-01 12:11:58 +00003380 return ret;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003381}
3382
3383/*
Bram Moolenaar75ab91f2021-01-10 22:42:50 +01003384 * Return TRUE if "idx" is for the map() function.
3385 */
3386 int
3387internal_func_is_map(int idx)
3388{
3389 return global_functions[idx].f_func == f_map;
3390}
3391
3392/*
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003393 * Check the argument count to use for internal function "idx".
Bram Moolenaar389df252020-07-09 21:20:47 +02003394 * Returns -1 for failure, 0 if no method base accepted, 1 if method base is
3395 * first argument, 2 if method base is second argument, etc. 9 if method base
3396 * is last argument.
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003397 */
3398 int
3399check_internal_func(int idx, int argcount)
3400{
Bram Moolenaar0917e862023-02-18 14:42:44 +00003401 funcerror_T res;
3402 char *name;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003403
3404 if (argcount < global_functions[idx].f_min_argc)
3405 res = FCERR_TOOFEW;
3406 else if (argcount > global_functions[idx].f_max_argc)
3407 res = FCERR_TOOMANY;
3408 else
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003409 return global_functions[idx].f_argtype & FEARG_MASK;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003410
3411 name = internal_func_name(idx);
3412 if (res == FCERR_TOOMANY)
Bram Moolenaare1242042021-12-16 20:56:57 +00003413 semsg(_(e_too_many_arguments_for_function_str), name);
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003414 else
Bram Moolenaare1242042021-12-16 20:56:57 +00003415 semsg(_(e_not_enough_arguments_for_function_str), name);
Bram Moolenaar389df252020-07-09 21:20:47 +02003416 return -1;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003417}
3418
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003419/*
3420 * Some internal functions accept types like Class as arguments. For other
3421 * functions, check the arguments are not types.
3422 *
3423 * Return OK/FAIL.
3424 */
3425 static int
3426check_args_for_type(int idx, int argcount, typval_T *argvars)
3427{
3428 if (!func_allows_type(idx))
3429 {
3430 for (int i = 0; i < argcount; ++i)
3431 if (check_typval_is_value(&argvars[i]) == FAIL)
3432 return FAIL;
3433 }
3434 return OK;
3435}
3436
Bram Moolenaar0917e862023-02-18 14:42:44 +00003437 funcerror_T
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003438call_internal_func(
3439 char_u *name,
3440 int argcount,
3441 typval_T *argvars,
3442 typval_T *rettv)
3443{
3444 int i;
3445
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003446 i = find_internal_func(name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003447 if (i < 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01003448 return FCERR_UNKNOWN;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003449 if (argcount < global_functions[i].f_min_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003450 return FCERR_TOOFEW;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003451 if (argcount > global_functions[i].f_max_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003452 return FCERR_TOOMANY;
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003453 if (check_args_for_type(i, argcount, argvars) == FAIL)
3454 return FCERR_OTHER;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003455 argvars[argcount].v_type = VAR_UNKNOWN;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003456 global_functions[i].f_func(argvars, rettv);
Bram Moolenaaref140542019-12-31 21:27:13 +01003457 return FCERR_NONE;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003458}
3459
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003460 void
3461call_internal_func_by_idx(
3462 int idx,
3463 typval_T *argvars,
3464 typval_T *rettv)
3465{
3466 global_functions[idx].f_func(argvars, rettv);
3467}
3468
Bram Moolenaarac92e252019-08-03 21:58:38 +02003469/*
3470 * Invoke a method for base->method().
3471 */
Bram Moolenaar0917e862023-02-18 14:42:44 +00003472 funcerror_T
Bram Moolenaarac92e252019-08-03 21:58:38 +02003473call_internal_method(
3474 char_u *name,
3475 int argcount,
3476 typval_T *argvars,
3477 typval_T *rettv,
3478 typval_T *basetv)
3479{
Bram Moolenaarac92e252019-08-03 21:58:38 +02003480 int fi;
3481 typval_T argv[MAX_FUNC_ARGS + 1];
3482
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003483 fi = find_internal_func(name);
Bram Moolenaar91746392019-08-16 22:22:31 +02003484 if (fi < 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01003485 return FCERR_UNKNOWN;
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003486 if ((global_functions[fi].f_argtype & FEARG_MASK) == 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01003487 return FCERR_NOTMETHOD;
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003488 if (argcount + 1 < global_functions[fi].f_min_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003489 return FCERR_TOOFEW;
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003490 if (argcount + 1 > global_functions[fi].f_max_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003491 return FCERR_TOOMANY;
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003492 if (check_args_for_type(fi, argcount, argvars) == FAIL)
3493 return FCERR_OTHER;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003494
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003495 if ((global_functions[fi].f_argtype & FEARG_MASK) == FEARG_2)
Bram Moolenaar25e42232019-08-04 15:04:10 +02003496 {
Bram Moolenaarb7f22702023-04-27 16:24:07 +01003497 if (argcount < 1)
3498 return FCERR_TOOFEW;
3499
Bram Moolenaar25e42232019-08-04 15:04:10 +02003500 // base value goes second
3501 argv[0] = argvars[0];
3502 argv[1] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003503 for (int i = 1; i < argcount; ++i)
Bram Moolenaar25e42232019-08-04 15:04:10 +02003504 argv[i + 1] = argvars[i];
3505 }
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003506 else if ((global_functions[fi].f_argtype & FEARG_MASK) == FEARG_3)
Bram Moolenaar24278d22019-08-16 21:49:22 +02003507 {
Bram Moolenaarb7f22702023-04-27 16:24:07 +01003508 if (argcount < 2)
3509 return FCERR_TOOFEW;
3510
Bram Moolenaar24278d22019-08-16 21:49:22 +02003511 // base value goes third
3512 argv[0] = argvars[0];
3513 argv[1] = argvars[1];
3514 argv[2] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003515 for (int i = 2; i < argcount; ++i)
Bram Moolenaar24278d22019-08-16 21:49:22 +02003516 argv[i + 1] = argvars[i];
3517 }
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003518 else if ((global_functions[fi].f_argtype & FEARG_MASK) == FEARG_4)
Bram Moolenaaraad222c2019-09-06 22:46:09 +02003519 {
Bram Moolenaarb7f22702023-04-27 16:24:07 +01003520 if (argcount < 3)
3521 return FCERR_TOOFEW;
3522
Bram Moolenaaraad222c2019-09-06 22:46:09 +02003523 // base value goes fourth
3524 argv[0] = argvars[0];
3525 argv[1] = argvars[1];
3526 argv[2] = argvars[2];
3527 argv[3] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003528 for (int i = 3; i < argcount; ++i)
Bram Moolenaaraad222c2019-09-06 22:46:09 +02003529 argv[i + 1] = argvars[i];
3530 }
Bram Moolenaar25e42232019-08-04 15:04:10 +02003531 else
3532 {
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003533 // FEARG_1: base value goes first
Bram Moolenaar25e42232019-08-04 15:04:10 +02003534 argv[0] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003535 for (int i = 0; i < argcount; ++i)
Bram Moolenaar25e42232019-08-04 15:04:10 +02003536 argv[i + 1] = argvars[i];
3537 }
Bram Moolenaarac92e252019-08-03 21:58:38 +02003538 argv[argcount + 1].v_type = VAR_UNKNOWN;
3539
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003540 if (check_args_for_type(fi, argcount + 1, argv) == FAIL)
3541 return FCERR_OTHER;
3542
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003543 global_functions[fi].f_func(argv, rettv);
Bram Moolenaaref140542019-12-31 21:27:13 +01003544 return FCERR_NONE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003545}
3546
3547/*
3548 * Return TRUE for a non-zero Number and a non-empty String.
3549 */
Bram Moolenaar0e57dd82019-09-16 22:56:03 +02003550 int
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003551non_zero_arg(typval_T *argvars)
3552{
3553 return ((argvars[0].v_type == VAR_NUMBER
3554 && argvars[0].vval.v_number != 0)
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01003555 || (argvars[0].v_type == VAR_BOOL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003556 && argvars[0].vval.v_number == VVAL_TRUE)
3557 || (argvars[0].v_type == VAR_STRING
3558 && argvars[0].vval.v_string != NULL
3559 && *argvars[0].vval.v_string != NUL));
3560}
3561
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003562/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003563 * "and(expr, expr)" function
3564 */
3565 static void
3566f_and(typval_T *argvars, typval_T *rettv)
3567{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003568 if (in_vim9script()
3569 && (check_for_number_arg(argvars, 0) == FAIL
3570 || check_for_number_arg(argvars, 1) == FAIL))
3571 return;
3572
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003573 rettv->vval.v_number = tv_get_number_chk(&argvars[0], NULL)
3574 & tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaarca851592018-06-06 21:04:07 +02003575}
3576
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003577/*
Bram Moolenaar59716a22017-03-01 20:32:44 +01003578 * "balloon_show()" function
3579 */
3580#ifdef FEAT_BEVAL
3581 static void
Bram Moolenaarbe0a2592019-05-09 13:50:16 +02003582f_balloon_gettext(typval_T *argvars UNUSED, typval_T *rettv)
3583{
3584 rettv->v_type = VAR_STRING;
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003585 if (balloonEval == NULL)
3586 return;
3587
3588 if (balloonEval->msg == NULL)
3589 rettv->vval.v_string = NULL;
3590 else
3591 rettv->vval.v_string = vim_strsave(balloonEval->msg);
Bram Moolenaarbe0a2592019-05-09 13:50:16 +02003592}
3593
3594 static void
Bram Moolenaar59716a22017-03-01 20:32:44 +01003595f_balloon_show(typval_T *argvars, typval_T *rettv UNUSED)
3596{
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003597 if (balloonEval == NULL)
3598 return;
3599
3600 if (in_vim9script()
3601 && check_for_string_or_list_arg(argvars, 0) == FAIL)
3602 return;
3603
3604 if (argvars[0].v_type == VAR_LIST
3605# ifdef FEAT_GUI
3606 && !gui.in_use
3607# endif
3608 )
Bram Moolenaar246fe032017-11-19 19:56:27 +01003609 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003610 list_T *l = argvars[0].vval.v_list;
3611
3612 // empty list removes the balloon
3613 post_balloon(balloonEval, NULL,
3614 l == NULL || l->lv_len == 0 ? NULL : l);
3615 }
3616 else
3617 {
3618 char_u *mesg;
3619
3620 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003621 return;
3622
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003623 mesg = tv_get_string_chk(&argvars[0]);
3624 if (mesg != NULL)
3625 // empty string removes the balloon
3626 post_balloon(balloonEval, *mesg == NUL ? NULL : mesg, NULL);
Bram Moolenaar246fe032017-11-19 19:56:27 +01003627 }
3628}
3629
Bram Moolenaar669a8282017-11-19 20:13:05 +01003630# if defined(FEAT_BEVAL_TERM)
Bram Moolenaar246fe032017-11-19 19:56:27 +01003631 static void
3632f_balloon_split(typval_T *argvars, typval_T *rettv UNUSED)
3633{
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003634 if (rettv_list_alloc(rettv) != OK)
3635 return;
3636
3637 char_u *msg;
3638
3639 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
3640 return;
3641 msg = tv_get_string_chk(&argvars[0]);
3642 if (msg != NULL)
Bram Moolenaar246fe032017-11-19 19:56:27 +01003643 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003644 pumitem_T *array;
3645 int size = split_message(msg, &array);
Bram Moolenaar246fe032017-11-19 19:56:27 +01003646
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003647 // Skip the first and last item, they are always empty.
3648 for (int i = 1; i < size - 1; ++i)
3649 list_append_string(rettv->vval.v_list, array[i].pum_text, -1);
3650 while (size > 0)
3651 vim_free(array[--size].pum_text);
3652 vim_free(array);
Bram Moolenaar246fe032017-11-19 19:56:27 +01003653 }
Bram Moolenaar59716a22017-03-01 20:32:44 +01003654}
Bram Moolenaar669a8282017-11-19 20:13:05 +01003655# endif
Bram Moolenaar59716a22017-03-01 20:32:44 +01003656#endif
3657
Yegappan Lakshmanan810785c2024-12-30 10:29:44 +01003658// Base64 character set
3659static const char_u base64_table[] = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
3660
3661// Base64 decoding table (initialized in init_base64_dec_table() below)
3662static char_u base64_dec_table[256];
3663
3664/*
3665 * Initialize the base64 decoding table
3666 */
3667 static void
3668init_base64_dec_table(void)
3669{
3670 static int base64_dec_tbl_initialized = FALSE;
3671
3672 if (base64_dec_tbl_initialized)
3673 return;
3674
3675 // Unsupported characters are set to 0xFF
3676 vim_memset(base64_dec_table, 0xFF, sizeof(base64_dec_table));
3677
3678 // Initialize the index for the base64 alphabets
3679 for (size_t i = 0; i < sizeof(base64_table) - 1; i++)
3680 base64_dec_table[(char_u)base64_table[i]] = (char_u)i;
3681
3682 // base64 padding character
3683 base64_dec_table['='] = 0;
3684
3685 base64_dec_tbl_initialized = TRUE;
3686}
3687
3688/*
3689 * Encode the bytes in "blob" using base-64 encoding.
3690 */
3691 static char_u *
3692base64_encode(blob_T *blob)
3693{
3694 size_t input_len = blob->bv_ga.ga_len;
3695 size_t encoded_len = ((input_len + 2) / 3) * 4;
3696 char_u *data = blob->bv_ga.ga_data;
3697
3698 char_u *encoded = alloc(encoded_len + 1);
3699 if (encoded == NULL)
3700 return NULL;
3701
3702 size_t i, j;
3703 for (i = 0, j = 0; i < input_len;)
3704 {
3705 int_u octet_a = i < input_len ? data[i++] : 0;
3706 int_u octet_b = i < input_len ? data[i++] : 0;
3707 int_u octet_c = i < input_len ? data[i++] : 0;
3708
3709 int_u triple = (octet_a << 16) | (octet_b << 8) | octet_c;
3710
3711 encoded[j++] = base64_table[(triple >> 18) & 0x3F];
3712 encoded[j++] = base64_table[(triple >> 12) & 0x3F];
3713 encoded[j++] = (!octet_b && i >= input_len) ? '='
3714 : base64_table[(triple >> 6) & 0x3F];
3715 encoded[j++] = (!octet_c && i >= input_len) ? '='
3716 : base64_table[triple & 0x3F];
3717 }
3718 encoded[j] = NUL;
3719
3720 return encoded;
3721}
3722
3723/*
3724 * Decode the string "data" using base-64 encoding.
3725 */
3726 static void
3727base64_decode(const char_u *data, blob_T *blob)
3728{
3729 size_t input_len = STRLEN(data);
3730
3731 if (input_len == 0)
3732 return;
3733
3734 if (input_len % 4 != 0)
3735 {
3736 // Invalid input length
3737 semsg(_(e_invalid_argument_str), data);
3738 return;
3739 }
3740
3741 init_base64_dec_table();
3742
3743 size_t decoded_len = (input_len / 4) * 3;
3744 if (data[input_len - 1] == '=')
3745 decoded_len--;
3746 if (data[input_len - 2] == '=')
3747 decoded_len--;
3748
3749 size_t i, j;
3750 for (i = 0, j = 0; i < input_len;)
3751 {
3752 int_u sextet_a = base64_dec_table[(char_u)data[i++]];
3753 int_u sextet_b = base64_dec_table[(char_u)data[i++]];
3754 int_u sextet_c = base64_dec_table[(char_u)data[i++]];
3755 int_u sextet_d = base64_dec_table[(char_u)data[i++]];
3756
3757 if (sextet_a == 0xFF || sextet_b == 0xFF || sextet_c == 0xFF
3758 || sextet_d == 0xFF)
3759 {
3760 // Invalid character
3761 semsg(_(e_invalid_argument_str), data);
3762 ga_clear(&blob->bv_ga);
3763 return;
3764 }
3765
3766 int_u triple = (sextet_a << 18) | (sextet_b << 12)
3767 | (sextet_c << 6) | sextet_d;
3768
3769 if (j < decoded_len)
3770 {
3771 ga_append(&blob->bv_ga, (triple >> 16) & 0xFF);
3772 j++;
3773 }
3774 if (j < decoded_len)
3775 {
3776 ga_append(&blob->bv_ga, (triple >> 8) & 0xFF);
3777 j++;
3778 }
3779 if (j < decoded_len)
3780 {
3781 ga_append(&blob->bv_ga, triple & 0xFF);
3782 j++;
3783 }
3784
3785 if (j == decoded_len)
3786 {
3787 // Check for invalid padding bytes (based on the
3788 // "Base64 Malleability in Practice" ACM paper).
3789 if ((data[input_len - 2] == '=' && ((sextet_b & 0xF) != 0))
3790 || ((data[input_len - 1] == '=') && ((sextet_c & 0x3) != 0)))
3791 {
3792 semsg(_(e_invalid_argument_str), data);
3793 ga_clear(&blob->bv_ga);
3794 return;
3795 }
3796 }
3797 }
3798}
3799
3800/*
3801 * "base64_decode(string)" function
3802 */
3803 static void
3804f_base64_decode(typval_T *argvars, typval_T *rettv)
3805{
3806 if (check_for_string_arg(argvars, 0) == FAIL)
3807 return;
3808
3809 if (rettv_blob_alloc(rettv) == FAIL)
3810 return;
3811
3812 char_u *str = tv_get_string_chk(&argvars[0]);
3813 if (str != NULL)
3814 base64_decode(str, rettv->vval.v_blob);
3815}
3816
3817/*
3818 * "base64_encode(blob)" function
3819 */
3820 static void
3821f_base64_encode(typval_T *argvars, typval_T *rettv)
3822{
3823 if (check_for_blob_arg(argvars, 0) == FAIL)
3824 return;
3825
3826 rettv->v_type = VAR_STRING;
3827 rettv->vval.v_string = NULL;
3828
3829 blob_T *blob = argvars->vval.v_blob;
3830 if (blob != NULL)
3831 rettv->vval.v_string = base64_encode(blob);
3832}
3833
Bram Moolenaar59716a22017-03-01 20:32:44 +01003834/*
Bram Moolenaar6b7b7192019-01-11 13:42:41 +01003835 * Get the buffer from "arg" and give an error and return NULL if it is not
3836 * valid.
3837 */
Bram Moolenaara3347722019-05-11 21:14:24 +02003838 buf_T *
Bram Moolenaar6b7b7192019-01-11 13:42:41 +01003839get_buf_arg(typval_T *arg)
3840{
3841 buf_T *buf;
3842
3843 ++emsg_off;
3844 buf = tv_get_buf(arg, FALSE);
3845 --emsg_off;
3846 if (buf == NULL)
Bram Moolenaard82a47d2022-01-05 20:24:39 +00003847 semsg(_(e_invalid_buffer_name_str), tv_get_string(arg));
Bram Moolenaar6b7b7192019-01-11 13:42:41 +01003848 return buf;
3849}
3850
3851/*
Christ van Willegence0ef912024-06-20 23:41:59 +02003852 * "bindtextdomain(package, path)" function
3853 */
3854 static void
Christ van Willegen8252ef12024-07-11 21:36:21 +02003855f_bindtextdomain(typval_T *argvars, typval_T *rettv)
Christ van Willegence0ef912024-06-20 23:41:59 +02003856{
Christ van Willegen8252ef12024-07-11 21:36:21 +02003857 rettv->v_type = VAR_BOOL;
3858 rettv->vval.v_number = VVAL_TRUE;
3859
Christ van Willegence0ef912024-06-20 23:41:59 +02003860 if (check_for_nonempty_string_arg(argvars, 0) == FAIL
3861 || check_for_nonempty_string_arg(argvars, 1) == FAIL)
3862 return;
3863
3864 if (strcmp((const char *)argvars[0].vval.v_string, VIMPACKAGE) == 0)
3865 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[0]));
3866 else
Christ van Willegen8252ef12024-07-11 21:36:21 +02003867 {
3868 if (bindtextdomain((const char *)argvars[0].vval.v_string, (const char *)argvars[1].vval.v_string) == NULL)
3869 {
3870 do_outofmem_msg((long)0);
3871 rettv->vval.v_number = VVAL_FALSE;
3872 }
3873 }
Christ van Willegence0ef912024-06-20 23:41:59 +02003874
3875 return;
3876}
3877
3878/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003879 * "byte2line(byte)" function
3880 */
3881 static void
3882f_byte2line(typval_T *argvars UNUSED, typval_T *rettv)
3883{
3884#ifndef FEAT_BYTEOFF
3885 rettv->vval.v_number = -1;
3886#else
3887 long boff = 0;
3888
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003889 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
3890 return;
3891
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01003892 boff = tv_get_number(&argvars[0]) - 1; // boff gets -1 on type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003893 if (boff < 0)
3894 rettv->vval.v_number = -1;
3895 else
3896 rettv->vval.v_number = ml_find_line_or_offset(curbuf,
3897 (linenr_T)0, &boff);
3898#endif
3899}
3900
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003901/*
3902 * "call(func, arglist [, dict])" function
3903 */
3904 static void
3905f_call(typval_T *argvars, typval_T *rettv)
3906{
3907 char_u *func;
3908 partial_T *partial = NULL;
3909 dict_T *selfdict = NULL;
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003910 char_u *tofree = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003911
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02003912 if (in_vim9script()
Bram Moolenaar223d0a62021-12-25 19:29:21 +00003913 && (check_for_string_or_func_arg(argvars, 0) == FAIL
3914 || check_for_list_arg(argvars, 1) == FAIL
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02003915 || check_for_opt_dict_arg(argvars, 2) == FAIL))
3916 return;
3917
Bram Moolenaard83392a2022-09-01 12:22:46 +01003918 if (check_for_list_arg(argvars, 1) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003919 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003920 if (argvars[1].vval.v_list == NULL)
3921 return;
3922
3923 if (argvars[0].v_type == VAR_FUNC)
3924 func = argvars[0].vval.v_string;
3925 else if (argvars[0].v_type == VAR_PARTIAL)
3926 {
3927 partial = argvars[0].vval.v_partial;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02003928 func = partial_name(partial);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003929 }
3930 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003931 func = tv_get_string(&argvars[0]);
Dominique Pellefe8ebdb2021-05-13 14:55:55 +02003932 if (func == NULL || *func == NUL)
3933 return; // type error, empty name or null function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003934
Yegappan Lakshmanan9904cbc2025-01-15 18:25:19 +01003935 if (argvars[0].v_type == VAR_STRING)
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003936 {
Yegappan Lakshmanan9904cbc2025-01-15 18:25:19 +01003937 char_u *p = func;
3938 tofree = trans_function_name(&p, NULL, FALSE, TFN_INT|TFN_QUIET);
3939 if (tofree == NULL)
3940 {
3941 emsg_funcname(e_unknown_function_str, func);
3942 return;
3943 }
3944 func = tofree;
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003945 }
3946
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003947 if (argvars[2].v_type != VAR_UNKNOWN)
3948 {
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +01003949 if (check_for_dict_arg(argvars, 2) == FAIL)
Yegappan Lakshmanan6289f912025-01-14 17:13:36 +01003950 goto done;
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +01003951
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003952 selfdict = argvars[2].vval.v_dict;
3953 }
3954
3955 (void)func_call(func, &argvars[1], partial, selfdict, rettv);
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003956
Yegappan Lakshmanan6289f912025-01-14 17:13:36 +01003957done:
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003958 vim_free(tofree);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003959}
3960
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003961/*
3962 * "changenr()" function
3963 */
3964 static void
3965f_changenr(typval_T *argvars UNUSED, typval_T *rettv)
3966{
3967 rettv->vval.v_number = curbuf->b_u_seq_cur;
3968}
3969
3970/*
3971 * "char2nr(string)" function
3972 */
3973 static void
3974f_char2nr(typval_T *argvars, typval_T *rettv)
3975{
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02003976 if (in_vim9script()
3977 && (check_for_string_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02003978 || check_for_opt_bool_arg(argvars, 1) == FAIL))
Bram Moolenaarc5809432021-03-27 21:23:30 +01003979 return;
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02003980
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003981 if (has_mbyte)
3982 {
3983 int utf8 = 0;
3984
3985 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaar24f77502020-09-04 19:50:57 +02003986 utf8 = (int)tv_get_bool_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003987
3988 if (utf8)
Bram Moolenaarbdace832019-03-02 10:13:42 +01003989 rettv->vval.v_number = utf_ptr2char(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003990 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003991 rettv->vval.v_number = (*mb_ptr2char)(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003992 }
3993 else
Bram Moolenaar13505972019-01-24 15:04:48 +01003994 rettv->vval.v_number = tv_get_string(&argvars[0])[0];
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003995}
3996
Bram Moolenaar17793ef2020-12-28 12:56:58 +01003997/*
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003998 * Get the current cursor column and store it in 'rettv'. If 'charcol' is TRUE,
3999 * returns the character index of the column. Otherwise, returns the byte index
4000 * of the column.
4001 */
4002 static void
4003get_col(typval_T *argvars, typval_T *rettv, int charcol)
4004{
4005 colnr_T col = 0;
4006 pos_T *fp;
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00004007 switchwin_T switchwin;
4008 int winchanged = FALSE;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004009
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00004010 if (check_for_string_or_list_arg(argvars, 0) == FAIL
4011 || check_for_opt_number_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004012 return;
4013
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00004014 if (argvars[1].v_type != VAR_UNKNOWN)
4015 {
4016 tabpage_T *tp;
4017 win_T *wp;
4018
4019 // use the window specified in the second argument
4020 wp = win_id2wp_tp((int)tv_get_number(&argvars[1]), &tp);
4021 if (wp == NULL || tp == NULL)
4022 return;
4023
4024 if (switch_win_noblock(&switchwin, wp, tp, TRUE) != OK)
4025 return;
4026
4027 check_cursor();
4028 winchanged = TRUE;
4029 }
4030
4031 int fnum = curbuf->b_fnum;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004032 fp = var2fpos(&argvars[0], FALSE, &fnum, charcol);
4033 if (fp != NULL && fnum == curbuf->b_fnum)
4034 {
4035 if (fp->col == MAXCOL)
4036 {
4037 // '> can be MAXCOL, get the length of the line then
4038 if (fp->lnum <= curbuf->b_ml.ml_line_count)
John Marriottbfcc8952024-03-11 22:04:45 +01004039 col = ml_get_len(fp->lnum) + 1;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004040 else
4041 col = MAXCOL;
4042 }
4043 else
4044 {
4045 col = fp->col + 1;
4046 // col(".") when the cursor is on the NUL at the end of the line
4047 // because of "coladd" can be seen as an extra column.
4048 if (virtual_active() && fp == &curwin->w_cursor)
4049 {
4050 char_u *p = ml_get_cursor();
4051
4052 if (curwin->w_cursor.coladd >= (colnr_T)chartabsize(p,
4053 curwin->w_virtcol - curwin->w_cursor.coladd))
4054 {
4055 int l;
4056
4057 if (*p != NUL && p[(l = (*mb_ptr2len)(p))] == NUL)
4058 col += l;
4059 }
4060 }
4061 }
4062 }
4063 rettv->vval.v_number = col;
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00004064
4065 if (winchanged)
4066 restore_win_noblock(&switchwin, TRUE);
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004067}
4068
4069/*
4070 * "charcol()" function
4071 */
4072 static void
4073f_charcol(typval_T *argvars, typval_T *rettv)
4074{
4075 get_col(argvars, rettv, TRUE);
4076}
4077
Bram Moolenaar29b7d7a2019-07-22 23:03:57 +02004078 win_T *
Bram Moolenaaraff74912019-03-30 18:11:49 +01004079get_optional_window(typval_T *argvars, int idx)
4080{
4081 win_T *win = curwin;
4082
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00004083 if (argvars[idx].v_type == VAR_UNKNOWN)
4084 return curwin;
4085
4086 win = find_win_by_nr_or_id(&argvars[idx]);
4087 if (win == NULL)
Bram Moolenaaraff74912019-03-30 18:11:49 +01004088 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00004089 emsg(_(e_invalid_window_number));
4090 return NULL;
Bram Moolenaaraff74912019-03-30 18:11:49 +01004091 }
4092 return win;
4093}
4094
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004095/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004096 * "col(string)" function
4097 */
4098 static void
4099f_col(typval_T *argvars, typval_T *rettv)
4100{
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004101 get_col(argvars, rettv, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004102}
4103
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004104/*
4105 * "confirm(message, buttons[, default [, type]])" function
4106 */
4107 static void
4108f_confirm(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
4109{
4110#if defined(FEAT_GUI_DIALOG) || defined(FEAT_CON_DIALOG)
4111 char_u *message;
4112 char_u *buttons = NULL;
4113 char_u buf[NUMBUFLEN];
4114 char_u buf2[NUMBUFLEN];
4115 int def = 1;
4116 int type = VIM_GENERIC;
4117 char_u *typestr;
4118 int error = FALSE;
4119
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02004120 if (in_vim9script()
4121 && (check_for_string_arg(argvars, 0) == FAIL
4122 || (check_for_opt_string_arg(argvars, 1) == FAIL
4123 || (argvars[1].v_type != VAR_UNKNOWN
4124 && (check_for_opt_number_arg(argvars, 2) == FAIL
4125 || (argvars[2].v_type != VAR_UNKNOWN
4126 && check_for_opt_string_arg(argvars, 3) == FAIL))))))
Bram Moolenaarc5809432021-03-27 21:23:30 +01004127 return;
4128
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004129 message = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004130 if (message == NULL)
4131 error = TRUE;
4132 if (argvars[1].v_type != VAR_UNKNOWN)
4133 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004134 buttons = tv_get_string_buf_chk(&argvars[1], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004135 if (buttons == NULL)
4136 error = TRUE;
4137 if (argvars[2].v_type != VAR_UNKNOWN)
4138 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004139 def = (int)tv_get_number_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004140 if (argvars[3].v_type != VAR_UNKNOWN)
4141 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004142 typestr = tv_get_string_buf_chk(&argvars[3], buf2);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004143 if (typestr == NULL)
4144 error = TRUE;
4145 else
4146 {
4147 switch (TOUPPER_ASC(*typestr))
4148 {
4149 case 'E': type = VIM_ERROR; break;
4150 case 'Q': type = VIM_QUESTION; break;
4151 case 'I': type = VIM_INFO; break;
4152 case 'W': type = VIM_WARNING; break;
4153 case 'G': type = VIM_GENERIC; break;
4154 }
4155 }
4156 }
4157 }
4158 }
4159
4160 if (buttons == NULL || *buttons == NUL)
4161 buttons = (char_u *)_("&Ok");
4162
4163 if (!error)
4164 rettv->vval.v_number = do_dialog(type, NULL, message, buttons,
4165 def, NULL, FALSE);
4166#endif
4167}
4168
4169/*
4170 * "copy()" function
4171 */
4172 static void
4173f_copy(typval_T *argvars, typval_T *rettv)
4174{
Bram Moolenaar381692b2022-02-02 20:01:27 +00004175 item_copy(&argvars[0], rettv, FALSE, TRUE, 0);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004176}
4177
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004178/*
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004179 * Set the cursor position.
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01004180 * If "charcol" is TRUE, then use the column number as a character offset.
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004181 * Otherwise use the column number as a byte offset.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004182 */
4183 static void
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004184set_cursorpos(typval_T *argvars, typval_T *rettv, int charcol)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004185{
Bram Moolenaar79f23442022-10-10 12:42:57 +01004186 long lnum, col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004187 long coladd = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004188 int set_curswant = TRUE;
4189
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004190 if (in_vim9script()
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004191 && (check_for_string_or_number_or_list_arg(argvars, 0) == FAIL
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02004192 || check_for_opt_number_arg(argvars, 1) == FAIL
4193 || (argvars[1].v_type != VAR_UNKNOWN
4194 && check_for_opt_number_arg(argvars, 2) == FAIL)))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004195 return;
4196
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004197 rettv->vval.v_number = -1;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004198 if (argvars[0].v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004199 {
4200 pos_T pos;
4201 colnr_T curswant = -1;
4202
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004203 if (list2fpos(argvars, &pos, NULL, &curswant, charcol) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004204 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00004205 emsg(_(e_invalid_argument));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004206 return;
4207 }
Bram Moolenaar79f23442022-10-10 12:42:57 +01004208 lnum = pos.lnum;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004209 col = pos.col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004210 coladd = pos.coladd;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004211 if (curswant >= 0)
4212 {
4213 curwin->w_curswant = curswant - 1;
4214 set_curswant = FALSE;
4215 }
4216 }
Bram Moolenaar79f23442022-10-10 12:42:57 +01004217 else if ((argvars[0].v_type == VAR_NUMBER
4218 || argvars[0].v_type == VAR_STRING)
4219 && (argvars[1].v_type == VAR_NUMBER
4220 || argvars[1].v_type == VAR_STRING))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004221 {
Bram Moolenaar79f23442022-10-10 12:42:57 +01004222 lnum = tv_get_lnum(argvars);
4223 if (lnum < 0)
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00004224 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[0]));
Bram Moolenaar79f23442022-10-10 12:42:57 +01004225 else if (lnum == 0)
4226 lnum = curwin->w_cursor.lnum;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004227 col = (long)tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004228 if (charcol)
Bram Moolenaar79f23442022-10-10 12:42:57 +01004229 col = buf_charidx_to_byteidx(curbuf, lnum, col) + 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004230 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004231 coladd = (long)tv_get_number_chk(&argvars[2], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004232 }
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004233 else
4234 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00004235 emsg(_(e_invalid_argument));
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004236 return;
4237 }
Bram Moolenaar79f23442022-10-10 12:42:57 +01004238 if (lnum < 0 || col < 0 || coladd < 0)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004239 return; // type error; errmsg already given
Bram Moolenaar79f23442022-10-10 12:42:57 +01004240 if (lnum > 0)
4241 curwin->w_cursor.lnum = lnum;
zeertzjq2ffdae72024-05-02 13:06:24 +02004242 if (col != MAXCOL && --col < 0)
4243 col = 0;
4244 curwin->w_cursor.col = col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004245 curwin->w_cursor.coladd = coladd;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004246
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004247 // Make sure the cursor is in a valid position.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004248 check_cursor();
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004249 // Correct cursor for multi-byte character.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004250 if (has_mbyte)
4251 mb_adjust_cursor();
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004252
4253 curwin->w_set_curswant = set_curswant;
4254 rettv->vval.v_number = 0;
4255}
4256
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004257/*
4258 * "cursor(lnum, col)" function, or
4259 * "cursor(list)"
4260 *
4261 * Moves the cursor to the specified line and column.
4262 * Returns 0 when the position could be set, -1 otherwise.
4263 */
4264 static void
4265f_cursor(typval_T *argvars, typval_T *rettv)
4266{
4267 set_cursorpos(argvars, rettv, FALSE);
4268}
4269
Bram Moolenaar4f974752019-02-17 17:44:42 +01004270#ifdef MSWIN
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004271/*
4272 * "debugbreak()" function
4273 */
4274 static void
4275f_debugbreak(typval_T *argvars, typval_T *rettv)
4276{
4277 int pid;
4278
4279 rettv->vval.v_number = FAIL;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004280 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
4281 return;
4282
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004283 pid = (int)tv_get_number(&argvars[0]);
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004284 if (pid == 0)
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004285 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00004286 emsg(_(e_invalid_argument));
4287 return;
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004288 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00004289
4290 HANDLE hProcess = OpenProcess(PROCESS_ALL_ACCESS, 0, pid);
4291 if (hProcess == NULL)
4292 return;
4293
4294 DebugBreakProcess(hProcess);
4295 CloseHandle(hProcess);
4296 rettv->vval.v_number = OK;
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004297}
4298#endif
4299
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004300/*
4301 * "deepcopy()" function
4302 */
4303 static void
4304f_deepcopy(typval_T *argvars, typval_T *rettv)
4305{
Bram Moolenaar239f8d92021-01-17 13:21:20 +01004306 varnumber_T noref = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004307
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +01004308 if (check_for_opt_bool_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004309 return;
4310
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004311 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaar239f8d92021-01-17 13:21:20 +01004312 noref = tv_get_bool_chk(&argvars[1], NULL);
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +01004313
4314 item_copy(&argvars[0], rettv, TRUE, TRUE, noref == 0 ? get_copyID() : 0);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004315}
4316
4317/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004318 * "did_filetype()" function
4319 */
4320 static void
4321f_did_filetype(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
4322{
zeertzjq5bf6c212024-03-31 18:41:27 +02004323 rettv->vval.v_number = curbuf->b_did_filetype;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004324}
4325
4326/*
Bram Moolenaar4132eb52020-02-14 16:53:00 +01004327 * "echoraw({expr})" function
4328 */
4329 static void
4330f_echoraw(typval_T *argvars, typval_T *rettv UNUSED)
4331{
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02004332 char_u *str;
Bram Moolenaar4132eb52020-02-14 16:53:00 +01004333
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02004334 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
4335 return;
4336
4337 str = tv_get_string_chk(&argvars[0]);
Bram Moolenaar4132eb52020-02-14 16:53:00 +01004338 if (str != NULL && *str != NUL)
4339 {
4340 out_str(str);
4341 out_flush();
4342 }
4343}
4344
4345/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004346 * "empty({expr})" function
4347 */
4348 static void
4349f_empty(typval_T *argvars, typval_T *rettv)
4350{
4351 int n = FALSE;
4352
4353 switch (argvars[0].v_type)
4354 {
4355 case VAR_STRING:
4356 case VAR_FUNC:
4357 n = argvars[0].vval.v_string == NULL
4358 || *argvars[0].vval.v_string == NUL;
4359 break;
4360 case VAR_PARTIAL:
Yegappan Lakshmananda9d3452024-05-02 13:02:36 +02004361 n = argvars[0].vval.v_partial == NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004362 break;
4363 case VAR_NUMBER:
4364 n = argvars[0].vval.v_number == 0;
4365 break;
4366 case VAR_FLOAT:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004367 n = argvars[0].vval.v_float == 0.0;
4368 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004369 case VAR_LIST:
4370 n = argvars[0].vval.v_list == NULL
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004371 || argvars[0].vval.v_list->lv_len == 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004372 break;
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01004373 case VAR_TUPLE:
4374 n = tuple_len(argvars[0].vval.v_tuple) == 0;
4375 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004376 case VAR_DICT:
4377 n = argvars[0].vval.v_dict == NULL
4378 || argvars[0].vval.v_dict->dv_hashtab.ht_used == 0;
4379 break;
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01004380 case VAR_BOOL:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004381 case VAR_SPECIAL:
4382 n = argvars[0].vval.v_number != VVAL_TRUE;
4383 break;
Bram Moolenaar00b28d62022-12-08 15:32:33 +00004384 case VAR_CLASS:
4385 n = argvars[0].vval.v_class != NULL;
4386 break;
4387 case VAR_OBJECT:
Yegappan Lakshmanand3eae7b2024-03-03 16:26:58 +01004388 n = object_empty(argvars[0].vval.v_object);
Bram Moolenaar00b28d62022-12-08 15:32:33 +00004389 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004390
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01004391 case VAR_BLOB:
4392 n = argvars[0].vval.v_blob == NULL
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01004393 || argvars[0].vval.v_blob->bv_ga.ga_len == 0;
4394 break;
4395
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004396 case VAR_JOB:
4397#ifdef FEAT_JOB_CHANNEL
4398 n = argvars[0].vval.v_job == NULL
4399 || argvars[0].vval.v_job->jv_status != JOB_STARTED;
4400 break;
4401#endif
4402 case VAR_CHANNEL:
4403#ifdef FEAT_JOB_CHANNEL
4404 n = argvars[0].vval.v_channel == NULL
4405 || !channel_is_open(argvars[0].vval.v_channel);
4406 break;
4407#endif
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +02004408 case VAR_TYPEALIAS:
4409 n = argvars[0].vval.v_typealias == NULL
4410 || argvars[0].vval.v_typealias->ta_name == NULL
4411 || *argvars[0].vval.v_typealias->ta_name == NUL;
4412 break;
4413
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004414 case VAR_UNKNOWN:
Bram Moolenaar4c683752020-04-05 21:38:23 +02004415 case VAR_ANY:
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004416 case VAR_VOID:
Bram Moolenaarf18332f2021-05-07 17:55:55 +02004417 case VAR_INSTR:
Bram Moolenaardd589232020-02-29 17:38:12 +01004418 internal_error_no_abort("f_empty(UNKNOWN)");
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004419 n = TRUE;
4420 break;
4421 }
4422
4423 rettv->vval.v_number = n;
4424}
4425
4426/*
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004427 * "environ()" function
4428 */
4429 static void
4430f_environ(typval_T *argvars UNUSED, typval_T *rettv)
4431{
4432#if !defined(AMIGA)
4433 int i = 0;
4434 char_u *entry, *value;
Bram Moolenaar68aaff42022-04-17 10:57:44 +01004435# if defined (MSWIN)
4436# if !defined(_UCRT)
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004437 extern wchar_t **_wenviron;
Bram Moolenaar68aaff42022-04-17 10:57:44 +01004438# endif
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004439# else
4440 extern char **environ;
4441# endif
4442
Bram Moolenaar93a10962022-06-16 11:42:09 +01004443 if (rettv_dict_alloc(rettv) == FAIL)
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004444 return;
4445
4446# ifdef MSWIN
4447 if (*_wenviron == NULL)
4448 return;
4449# else
4450 if (*environ == NULL)
4451 return;
4452# endif
4453
4454 for (i = 0; ; ++i)
4455 {
4456# ifdef MSWIN
4457 short_u *p;
4458
4459 if ((p = (short_u *)_wenviron[i]) == NULL)
4460 return;
4461 entry = utf16_to_enc(p, NULL);
4462# else
4463 if ((entry = (char_u *)environ[i]) == NULL)
4464 return;
4465 entry = vim_strsave(entry);
4466# endif
4467 if (entry == NULL) // out of memory
4468 return;
4469 if ((value = vim_strchr(entry, '=')) == NULL)
4470 {
4471 vim_free(entry);
4472 continue;
4473 }
4474 *value++ = NUL;
4475 dict_add_string(rettv->vval.v_dict, (char *)entry, value);
4476 vim_free(entry);
4477 }
4478#endif
4479}
4480
4481/*
Bram Moolenaar80adaa82023-07-07 18:57:40 +01004482 * "err_teapot()" function
4483 */
4484 static void
4485f_err_teapot(typval_T *argvars, typval_T *rettv UNUSED)
4486{
4487 if (argvars[0].v_type != VAR_UNKNOWN)
4488 {
4489 if (argvars[0].v_type == VAR_STRING)
4490 {
4491 char_u *s = tv_get_string_strict(&argvars[0]);
Sean Dewarb0efa492023-07-08 10:35:19 +01004492 if (*skipwhite(s) == NUL)
Bram Moolenaar80adaa82023-07-07 18:57:40 +01004493 return;
4494 }
4495
4496 int err = FALSE;
4497 int do_503 = eval_expr_to_bool(&argvars[0], &err);
4498 if (!err && do_503)
4499 {
4500 emsg(_(e_coffee_currently_not_available));
4501 return;
4502 }
4503 }
4504
4505 emsg(_(e_im_a_teapot));
4506}
4507
4508/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004509 * "escape({string}, {chars})" function
4510 */
4511 static void
4512f_escape(typval_T *argvars, typval_T *rettv)
4513{
4514 char_u buf[NUMBUFLEN];
4515
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004516 if (in_vim9script()
4517 && (check_for_string_arg(argvars, 0) == FAIL
4518 || check_for_string_arg(argvars, 1) == FAIL))
4519 return;
4520
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004521 rettv->vval.v_string = vim_strsave_escaped(tv_get_string(&argvars[0]),
4522 tv_get_string_buf(&argvars[1], buf));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004523 rettv->v_type = VAR_STRING;
4524}
4525
4526/*
4527 * "eval()" function
4528 */
4529 static void
4530f_eval(typval_T *argvars, typval_T *rettv)
4531{
4532 char_u *s, *p;
4533
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004534 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
4535 return;
4536
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004537 s = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004538 if (s != NULL)
4539 s = skipwhite(s);
4540
4541 p = s;
Bram Moolenaar5409f5d2020-06-24 18:37:35 +02004542 if (s == NULL || eval1(&s, rettv, &EVALARG_EVALUATE) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004543 {
4544 if (p != NULL && !aborting())
Bram Moolenaar108010a2021-06-27 22:03:33 +02004545 semsg(_(e_invalid_expression_str), p);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004546 need_clr_eos = FALSE;
4547 rettv->v_type = VAR_NUMBER;
4548 rettv->vval.v_number = 0;
4549 }
4550 else if (*s != NUL)
Bram Moolenaar74409f62022-01-01 15:58:22 +00004551 semsg(_(e_trailing_characters_str), s);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004552}
4553
4554/*
4555 * "eventhandler()" function
4556 */
4557 static void
4558f_eventhandler(typval_T *argvars UNUSED, typval_T *rettv)
4559{
Bram Moolenaardfc33a62020-04-29 22:30:13 +02004560 rettv->vval.v_number = vgetc_busy || input_busy;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004561}
4562
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004563static garray_T redir_execute_ga;
4564
4565/*
4566 * Append "value[value_len]" to the execute() output.
4567 */
4568 void
4569execute_redir_str(char_u *value, int value_len)
4570{
4571 int len;
4572
4573 if (value_len == -1)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004574 len = (int)STRLEN(value); // Append the entire string
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004575 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004576 len = value_len; // Append only "value_len" characters
Yegappan Lakshmananfadc02a2023-01-27 21:03:12 +00004577 if (ga_grow(&redir_execute_ga, len) == FAIL)
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00004578 return;
4579
4580 mch_memmove((char *)redir_execute_ga.ga_data
4581 + redir_execute_ga.ga_len, value, len);
4582 redir_execute_ga.ga_len += len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004583}
4584
Dominique Pelle748b3082022-01-08 12:41:16 +00004585#if defined(FEAT_LUA) || defined(PROTO)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004586/*
Yegappan Lakshmanan11328bc2021-08-06 21:34:38 +02004587 * Get next line from a string containing NL separated lines.
4588 * Called by do_cmdline() to get the next line.
4589 * Returns an allocated string, or NULL when at the end of the string.
4590 */
4591 static char_u *
4592get_str_line(
4593 int c UNUSED,
4594 void *cookie,
4595 int indent UNUSED,
4596 getline_opt_T options UNUSED)
4597{
4598 char_u *start = *(char_u **)cookie;
4599 char_u *line;
4600 char_u *p;
4601
4602 p = start;
4603 if (p == NULL || *p == NUL)
4604 return NULL;
4605 p = vim_strchr(p, '\n');
4606 if (p == NULL)
4607 line = vim_strsave(start);
4608 else
4609 {
4610 line = vim_strnsave(start, p - start);
4611 p++;
4612 }
4613
4614 *(char_u **)cookie = p;
4615 return line;
4616}
4617
4618/*
4619 * Execute a series of Ex commands in 'str'
4620 */
4621 void
4622execute_cmds_from_string(char_u *str)
4623{
4624 do_cmdline(NULL, get_str_line, (void *)&str,
4625 DOCMD_NOWAIT|DOCMD_VERBOSE|DOCMD_REPEAT|DOCMD_KEYTYPED);
4626}
Dominique Pelle748b3082022-01-08 12:41:16 +00004627#endif
Yegappan Lakshmanan11328bc2021-08-06 21:34:38 +02004628
4629/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004630 * Get next line from a list.
4631 * Called by do_cmdline() to get the next line.
4632 * Returns allocated string, or NULL for end of function.
4633 */
Bram Moolenaara7583c42022-05-07 21:14:05 +01004634 char_u *
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004635get_list_line(
4636 int c UNUSED,
4637 void *cookie,
Bram Moolenaare96a2492019-06-25 04:12:16 +02004638 int indent UNUSED,
Bram Moolenaar66250c92020-08-20 15:02:42 +02004639 getline_opt_T options UNUSED)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004640{
4641 listitem_T **p = (listitem_T **)cookie;
4642 listitem_T *item = *p;
4643 char_u buf[NUMBUFLEN];
4644 char_u *s;
4645
4646 if (item == NULL)
4647 return NULL;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004648 s = tv_get_string_buf_chk(&item->li_tv, buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004649 *p = item->li_next;
4650 return s == NULL ? NULL : vim_strsave(s);
4651}
4652
4653/*
4654 * "execute()" function
4655 */
Bram Moolenaar261f3462019-09-07 15:45:32 +02004656 void
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004657execute_common(typval_T *argvars, typval_T *rettv, int arg_off)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004658{
4659 char_u *cmd = NULL;
4660 list_T *list = NULL;
4661 int save_msg_silent = msg_silent;
4662 int save_emsg_silent = emsg_silent;
4663 int save_emsg_noredir = emsg_noredir;
4664 int save_redir_execute = redir_execute;
Bram Moolenaar20951482017-12-25 13:44:43 +01004665 int save_redir_off = redir_off;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004666 garray_T save_ga;
Bram Moolenaar10ccaa12018-12-07 16:38:23 +01004667 int save_msg_col = msg_col;
Kota Kato3d3f6ac2022-08-04 18:50:14 +01004668 int save_sticky_cmdmod_flags = sticky_cmdmod_flags;
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004669 int echo_output = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004670
4671 rettv->vval.v_string = NULL;
4672 rettv->v_type = VAR_STRING;
4673
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004674 if (argvars[arg_off].v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004675 {
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004676 list = argvars[arg_off].vval.v_list;
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004677 if (list == NULL || list->lv_len == 0)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004678 // empty list, no commands, empty output
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004679 return;
4680 ++list->lv_refcount;
4681 }
Bram Moolenaare2a8f072020-01-08 19:32:18 +01004682 else if (argvars[arg_off].v_type == VAR_JOB
4683 || argvars[arg_off].v_type == VAR_CHANNEL)
4684 {
Bram Moolenaar68db9962021-05-09 23:19:22 +02004685 semsg(_(e_using_invalid_value_as_string_str),
4686 vartype_name(argvars[arg_off].v_type));
Bram Moolenaare2a8f072020-01-08 19:32:18 +01004687 return;
4688 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004689 else
4690 {
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004691 cmd = tv_get_string_chk(&argvars[arg_off]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004692 if (cmd == NULL)
4693 return;
4694 }
4695
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004696 if (argvars[arg_off + 1].v_type != VAR_UNKNOWN)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004697 {
4698 char_u buf[NUMBUFLEN];
Bram Moolenaar3cfa5b12021-06-06 14:14:39 +02004699 char_u *s = tv_get_string_buf_chk_strict(&argvars[arg_off + 1], buf,
4700 in_vim9script());
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004701
4702 if (s == NULL)
4703 return;
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004704 if (*s == NUL)
4705 echo_output = TRUE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004706 if (STRNCMP(s, "silent", 6) == 0)
4707 ++msg_silent;
4708 if (STRCMP(s, "silent!") == 0)
4709 {
4710 emsg_silent = TRUE;
4711 emsg_noredir = TRUE;
4712 }
4713 }
4714 else
4715 ++msg_silent;
4716
4717 if (redir_execute)
4718 save_ga = redir_execute_ga;
Bram Moolenaar04935fb2022-01-08 16:19:22 +00004719 ga_init2(&redir_execute_ga, sizeof(char), 500);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004720 redir_execute = TRUE;
Bram Moolenaar20951482017-12-25 13:44:43 +01004721 redir_off = FALSE;
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004722 if (!echo_output)
4723 msg_col = 0; // prevent leading spaces
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004724
Kota Kato3d3f6ac2022-08-04 18:50:14 +01004725 // For "legacy call execute('cmd')" and "vim9cmd execute('cmd')" apply the
4726 // command modifiers to "cmd".
4727 sticky_cmdmod_flags = cmdmod.cmod_flags & (CMOD_LEGACY | CMOD_VIM9CMD);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004728 if (cmd != NULL)
4729 do_cmdline_cmd(cmd);
4730 else
4731 {
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004732 listitem_T *item;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004733
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02004734 CHECK_LIST_MATERIALIZE(list);
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004735 item = list->lv_first;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004736 do_cmdline(NULL, get_list_line, (void *)&item,
4737 DOCMD_NOWAIT|DOCMD_VERBOSE|DOCMD_REPEAT|DOCMD_KEYTYPED);
4738 --list->lv_refcount;
4739 }
Kota Kato3d3f6ac2022-08-04 18:50:14 +01004740 sticky_cmdmod_flags = save_sticky_cmdmod_flags;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004741
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004742 // Need to append a NUL to the result.
Bram Moolenaard297f352017-01-29 20:31:21 +01004743 if (ga_grow(&redir_execute_ga, 1) == OK)
4744 {
4745 ((char *)redir_execute_ga.ga_data)[redir_execute_ga.ga_len] = NUL;
4746 rettv->vval.v_string = redir_execute_ga.ga_data;
4747 }
4748 else
4749 {
4750 ga_clear(&redir_execute_ga);
4751 rettv->vval.v_string = NULL;
4752 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004753 msg_silent = save_msg_silent;
4754 emsg_silent = save_emsg_silent;
4755 emsg_noredir = save_emsg_noredir;
4756
4757 redir_execute = save_redir_execute;
4758 if (redir_execute)
4759 redir_execute_ga = save_ga;
Bram Moolenaar20951482017-12-25 13:44:43 +01004760 redir_off = save_redir_off;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004761
Bram Moolenaar10ccaa12018-12-07 16:38:23 +01004762 // "silent reg" or "silent echo x" leaves msg_col somewhere in the line.
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004763 if (echo_output)
4764 // When not working silently: put it in column zero. A following
4765 // "echon" will overwrite the message, unavoidably.
4766 msg_col = 0;
4767 else
4768 // When working silently: Put it back where it was, since nothing
4769 // should have been written.
4770 msg_col = save_msg_col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004771}
4772
4773/*
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004774 * "execute()" function
4775 */
4776 static void
4777f_execute(typval_T *argvars, typval_T *rettv)
4778{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004779 if (in_vim9script()
4780 && (check_for_string_or_list_arg(argvars, 0) == FAIL
4781 || check_for_opt_string_arg(argvars, 1) == FAIL))
4782 return;
4783
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004784 execute_common(argvars, rettv, 0);
4785}
4786
4787/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004788 * "exists()" function
4789 */
Bram Moolenaarbb7ee7a2021-08-02 20:06:50 +02004790 void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004791f_exists(typval_T *argvars, typval_T *rettv)
4792{
4793 char_u *p;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004794 int n = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004795
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004796 if (in_vim9script() && check_for_nonempty_string_arg(argvars, 0) == FAIL)
4797 return;
4798
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004799 p = tv_get_string(&argvars[0]);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004800 if (*p == '$') // environment variable
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004801 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004802 // first try "normal" environment variables (fast)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004803 if (mch_getenv(p + 1) != NULL)
4804 n = TRUE;
4805 else
4806 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004807 // try expanding things like $VIM and ${HOME}
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004808 p = expand_env_save(p);
4809 if (p != NULL && *p != '$')
4810 n = TRUE;
4811 vim_free(p);
4812 }
4813 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004814 else if (*p == '&' || *p == '+') // option
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004815 {
Bram Moolenaar9a78e6d2020-07-01 18:29:55 +02004816 n = (eval_option(&p, NULL, TRUE) == OK);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004817 if (*skipwhite(p) != NUL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004818 n = FALSE; // trailing garbage
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004819 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004820 else if (*p == '*') // internal or user defined function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004821 {
Bram Moolenaarb54c3ff2016-07-31 14:11:58 +02004822 n = function_exists(p + 1, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004823 }
Bram Moolenaar15c47602020-03-26 22:16:48 +01004824 else if (*p == '?') // internal function only
4825 {
4826 n = has_internal_func_name(p + 1);
4827 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004828 else if (*p == ':')
4829 {
4830 n = cmd_exists(p + 1);
4831 }
4832 else if (*p == '#')
4833 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004834 if (p[1] == '#')
4835 n = autocmd_supported(p + 2);
4836 else
4837 n = au_exists(p + 1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004838 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004839 else // internal variable
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004840 {
Bram Moolenaarc6f9f732018-02-11 19:06:26 +01004841 n = var_exists(p);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004842 }
4843
4844 rettv->vval.v_number = n;
4845}
4846
Bram Moolenaar26735992021-08-08 14:43:22 +02004847 static void
4848f_exists_compiled(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
4849{
4850 emsg(_(e_exists_compiled_can_only_be_used_in_def_function));
4851}
4852
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004853/*
4854 * "expand()" function
4855 */
4856 static void
4857f_expand(typval_T *argvars, typval_T *rettv)
4858{
4859 char_u *s;
Mike Williams51024bb2024-05-30 07:46:30 +02004860 size_t len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004861 int options = WILD_SILENT|WILD_USE_NL|WILD_LIST_NOTFOUND;
4862 expand_T xpc;
4863 int error = FALSE;
4864 char_u *result;
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004865#ifdef BACKSLASH_IN_FILENAME
4866 char_u *p_csl_save = p_csl;
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004867#endif
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004868
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004869 if (in_vim9script()
4870 && (check_for_string_arg(argvars, 0) == FAIL
4871 || check_for_opt_bool_arg(argvars, 1) == FAIL
4872 || (argvars[1].v_type != VAR_UNKNOWN
4873 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
4874 return;
4875
4876#ifdef BACKSLASH_IN_FILENAME
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004877 // avoid using 'completeslash' here
4878 p_csl = empty_option;
4879#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004880
4881 rettv->v_type = VAR_STRING;
4882 if (argvars[1].v_type != VAR_UNKNOWN
4883 && argvars[2].v_type != VAR_UNKNOWN
Bram Moolenaar551d25e2020-09-02 21:37:56 +02004884 && tv_get_bool_chk(&argvars[2], &error)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004885 && !error)
Bram Moolenaar45cf6e92017-04-30 20:25:19 +02004886 rettv_list_set(rettv, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004887
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004888 s = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004889 if (*s == '%' || *s == '#' || *s == '<')
4890 {
Bram Moolenaar57544522022-04-12 12:54:11 +01004891 char *errormsg = NULL;
4892
4893 if (p_verbose == 0)
4894 ++emsg_off;
Bram Moolenaara96edb72022-04-28 17:52:24 +01004895 result = eval_vars(s, s, &len, NULL, &errormsg, NULL, FALSE);
Bram Moolenaar57544522022-04-12 12:54:11 +01004896 if (p_verbose == 0)
4897 --emsg_off;
4898 else if (errormsg != NULL)
4899 emsg(errormsg);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004900 if (rettv->v_type == VAR_LIST)
4901 {
Bram Moolenaar93a10962022-06-16 11:42:09 +01004902 if (rettv_list_alloc(rettv) == OK && result != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004903 list_append_string(rettv->vval.v_list, result, -1);
Bram Moolenaar86173482019-10-01 17:02:16 +02004904 vim_free(result);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004905 }
4906 else
4907 rettv->vval.v_string = result;
4908 }
4909 else
4910 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004911 // When the optional second argument is non-zero, don't remove matches
4912 // for 'wildignore' and don't put matches for 'suffixes' at the end.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004913 if (argvars[1].v_type != VAR_UNKNOWN
Bram Moolenaar551d25e2020-09-02 21:37:56 +02004914 && tv_get_bool_chk(&argvars[1], &error))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004915 options |= WILD_KEEP_ALL;
4916 if (!error)
4917 {
4918 ExpandInit(&xpc);
4919 xpc.xp_context = EXPAND_FILES;
4920 if (p_wic)
4921 options += WILD_ICASE;
4922 if (rettv->v_type == VAR_STRING)
4923 rettv->vval.v_string = ExpandOne(&xpc, s, NULL,
4924 options, WILD_ALL);
Bram Moolenaar93a10962022-06-16 11:42:09 +01004925 else if (rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004926 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004927 ExpandOne(&xpc, s, NULL, options, WILD_ALL_KEEP);
Bram Moolenaar848db572022-09-20 19:04:32 +01004928 for (int i = 0; i < xpc.xp_numfiles; i++)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004929 list_append_string(rettv->vval.v_list, xpc.xp_files[i], -1);
4930 ExpandCleanup(&xpc);
4931 }
4932 }
4933 else
4934 rettv->vval.v_string = NULL;
4935 }
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004936#ifdef BACKSLASH_IN_FILENAME
4937 p_csl = p_csl_save;
4938#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004939}
4940
4941/*
Bram Moolenaar80dad482019-06-09 17:22:31 +02004942 * "expandcmd()" function
4943 * Expand all the special characters in a command string.
4944 */
4945 static void
4946f_expandcmd(typval_T *argvars, typval_T *rettv)
4947{
4948 exarg_T eap;
4949 char_u *cmdstr;
4950 char *errormsg = NULL;
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004951 int emsgoff = TRUE;
Bram Moolenaar80dad482019-06-09 17:22:31 +02004952
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004953 if (in_vim9script()
4954 && (check_for_string_arg(argvars, 0) == FAIL
4955 || check_for_opt_dict_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004956 return;
4957
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004958 if (argvars[1].v_type == VAR_DICT
Bram Moolenaard61efa52022-07-23 09:52:04 +01004959 && dict_get_bool(argvars[1].vval.v_dict, "errmsg", VVAL_FALSE))
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004960 emsgoff = FALSE;
4961
Bram Moolenaar80dad482019-06-09 17:22:31 +02004962 rettv->v_type = VAR_STRING;
4963 cmdstr = vim_strsave(tv_get_string(&argvars[0]));
4964
Yegappan Lakshmanan960dcbd2023-03-07 17:45:11 +00004965 CLEAR_FIELD(eap);
Bram Moolenaar80dad482019-06-09 17:22:31 +02004966 eap.cmd = cmdstr;
4967 eap.arg = cmdstr;
Bram Moolenaar8071cb22019-07-12 17:58:01 +02004968 eap.argt |= EX_NOSPC;
Bram Moolenaar80dad482019-06-09 17:22:31 +02004969 eap.usefilter = FALSE;
4970 eap.nextcmd = NULL;
4971 eap.cmdidx = CMD_USER;
4972
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004973 if (emsgoff)
4974 ++emsg_off;
4975 if (expand_filename(&eap, &cmdstr, &errormsg) == FAIL)
4976 if (!emsgoff && errormsg != NULL && *errormsg != NUL)
4977 emsg(errormsg);
4978 if (emsgoff)
4979 --emsg_off;
Bram Moolenaar80dad482019-06-09 17:22:31 +02004980
4981 rettv->vval.v_string = cmdstr;
4982}
4983
4984/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004985 * "feedkeys()" function
4986 */
4987 static void
4988f_feedkeys(typval_T *argvars, typval_T *rettv UNUSED)
4989{
4990 int remap = TRUE;
4991 int insert = FALSE;
4992 char_u *keys, *flags;
4993 char_u nbuf[NUMBUFLEN];
4994 int typed = FALSE;
4995 int execute = FALSE;
Bram Moolenaara9725222022-01-16 13:30:33 +00004996 int context = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004997 int dangerous = FALSE;
Bram Moolenaar5e66b422019-01-24 21:58:10 +01004998 int lowlevel = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004999
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005000 // This is not allowed in the sandbox. If the commands would still be
5001 // executed in the sandbox it would be OK, but it probably happens later,
5002 // when "sandbox" is no longer set.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005003 if (check_secure())
5004 return;
5005
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005006 if (in_vim9script()
5007 && (check_for_string_arg(argvars, 0) == FAIL
5008 || check_for_opt_string_arg(argvars, 1) == FAIL))
5009 return;
5010
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005011 keys = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005012
5013 if (argvars[1].v_type != VAR_UNKNOWN)
5014 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005015 flags = tv_get_string_buf(&argvars[1], nbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005016 for ( ; *flags != NUL; ++flags)
5017 {
5018 switch (*flags)
5019 {
5020 case 'n': remap = FALSE; break;
5021 case 'm': remap = TRUE; break;
5022 case 't': typed = TRUE; break;
5023 case 'i': insert = TRUE; break;
5024 case 'x': execute = TRUE; break;
Bram Moolenaara9725222022-01-16 13:30:33 +00005025 case 'c': context = TRUE; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005026 case '!': dangerous = TRUE; break;
Bram Moolenaar5e66b422019-01-24 21:58:10 +01005027 case 'L': lowlevel = TRUE; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005028 }
5029 }
5030 }
5031
5032 if (*keys != NUL || execute)
5033 {
Christopher Plewright20b795e2022-12-20 20:01:58 +00005034 if (lowlevel
5035#ifdef FEAT_VTP
5036 && (!is_term_win32()
5037 || (keys[0] == 3 && ctrl_c_interrupts && typed))
5038#endif
5039 )
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005040 {
Bram Moolenaar5e66b422019-01-24 21:58:10 +01005041#ifdef USE_INPUT_BUF
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005042 ch_log(NULL, "feedkeys() lowlevel: %s", keys);
Bram Moolenaar9645e2d2020-03-20 20:48:49 +01005043
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005044 int len = (int)STRLEN(keys);
5045 for (int idx = 0; idx < len; ++idx)
5046 {
5047 // if a CTRL-C was typed, set got_int, similar to what
5048 // happens in fill_input_buf()
5049 if (keys[idx] == 3 && ctrl_c_interrupts && typed)
5050 got_int = TRUE;
5051 add_to_input_buf(keys + idx, 1);
5052 }
Bram Moolenaar5e66b422019-01-24 21:58:10 +01005053#else
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005054 emsg(_(e_lowlevel_input_not_supported));
Bram Moolenaar5e66b422019-01-24 21:58:10 +01005055#endif
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005056 }
5057 else
5058 {
5059 // Need to escape K_SPECIAL and CSI before putting the string in
5060 // the typeahead buffer.
5061 char_u *keys_esc = vim_strsave_escape_csi(keys);
5062 if (keys_esc == NULL)
5063 return;
5064
5065 ch_log(NULL, "feedkeys(%s): %s", typed ? "typed" : "", keys);
5066
5067 ins_typebuf(keys_esc, (remap ? REMAP_YES : REMAP_NONE),
5068 insert ? 0 : typebuf.tb_len, !typed, FALSE);
5069 if (vgetc_busy
Bram Moolenaar5d7be4f2017-06-25 13:40:17 +02005070#ifdef FEAT_TIMERS
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005071 || timer_busy
Bram Moolenaar5d7be4f2017-06-25 13:40:17 +02005072#endif
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005073 || input_busy)
5074 typebuf_was_filled = TRUE;
5075
Bram Moolenaar8d4ce562019-01-30 22:01:40 +01005076 vim_free(keys_esc);
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005077 }
Bram Moolenaar8d4ce562019-01-30 22:01:40 +01005078
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005079 if (execute)
5080 {
5081 int save_msg_scroll = msg_scroll;
5082 sctx_T save_sctx;
5083
5084 // Avoid a 1 second delay when the keys start Insert mode.
5085 msg_scroll = FALSE;
5086
5087 ch_log(NULL, "feedkeys() executing");
5088
5089 if (context)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005090 {
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005091 save_sctx = current_sctx;
5092 current_sctx.sc_sid = 0;
5093 current_sctx.sc_version = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005094 }
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005095
5096 if (!dangerous)
5097 {
5098 ++ex_normal_busy;
5099 ++in_feedkeys;
5100 }
5101 exec_normal(TRUE, lowlevel, TRUE);
5102 if (!dangerous)
5103 {
5104 --ex_normal_busy;
5105 --in_feedkeys;
5106 }
5107
5108 msg_scroll |= save_msg_scroll;
5109
5110 if (context)
5111 current_sctx = save_sctx;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005112 }
5113 }
5114}
5115
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005116/*
5117 * "fnameescape({string})" function
5118 */
5119 static void
5120f_fnameescape(typval_T *argvars, typval_T *rettv)
5121{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005122 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5123 return;
5124
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005125 rettv->vval.v_string = vim_strsave_fnameescape(
Bram Moolenaar21c1a0c2021-10-17 17:20:23 +01005126 tv_get_string(&argvars[0]), VSE_NONE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005127 rettv->v_type = VAR_STRING;
5128}
5129
5130/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005131 * "foreground()" function
5132 */
5133 static void
5134f_foreground(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
5135{
5136#ifdef FEAT_GUI
5137 if (gui.in_use)
Bram Moolenaarafde13b2019-04-28 19:46:49 +02005138 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005139 gui_mch_set_foreground();
Bram Moolenaarafde13b2019-04-28 19:46:49 +02005140 return;
5141 }
5142#endif
5143#if defined(MSWIN) && (!defined(FEAT_GUI) || defined(VIMDLL))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005144 win32_set_foreground();
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005145#endif
5146}
5147
Bakudankun375141e2022-09-09 18:46:47 +01005148/*
5149 * "function()" function
5150 * "funcref()" function
5151 */
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005152 static void
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005153common_function(typval_T *argvars, typval_T *rettv, int is_funcref)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005154{
5155 char_u *s;
5156 char_u *name;
5157 int use_string = FALSE;
5158 partial_T *arg_pt = NULL;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005159 char_u *trans_name = NULL;
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02005160 int is_global = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005161
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02005162 if (in_vim9script()
Bram Moolenaarae1068a2021-12-25 19:43:44 +00005163 && (check_for_string_or_func_arg(argvars, 0) == FAIL
5164 || check_for_opt_list_arg(argvars, 1) == FAIL
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02005165 || (argvars[1].v_type != VAR_UNKNOWN
5166 && check_for_opt_dict_arg(argvars, 2) == FAIL)))
5167 return;
5168
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005169 if (argvars[0].v_type == VAR_FUNC)
5170 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005171 // function(MyFunc, [arg], dict)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005172 s = argvars[0].vval.v_string;
5173 }
5174 else if (argvars[0].v_type == VAR_PARTIAL
5175 && argvars[0].vval.v_partial != NULL)
5176 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005177 // function(dict.MyFunc, [arg])
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005178 arg_pt = argvars[0].vval.v_partial;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005179 s = partial_name(arg_pt);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005180 }
5181 else
5182 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005183 // function('MyFunc', [arg], dict)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005184 s = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005185 use_string = TRUE;
5186 }
Bram Moolenaar60b6e6f2021-08-28 12:49:27 +02005187 if (s == NULL)
5188 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00005189 semsg(_(e_invalid_argument_str), "NULL");
Bram Moolenaar60b6e6f2021-08-28 12:49:27 +02005190 return;
5191 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005192
Bram Moolenaar843b8842016-08-21 14:36:15 +02005193 if ((use_string && vim_strchr(s, AUTOLOAD_CHAR) == NULL) || is_funcref)
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005194 {
5195 name = s;
Bram Moolenaareba3b7f2021-11-30 18:25:08 +00005196 trans_name = save_function_name(&name, &is_global, FALSE,
5197 TFN_INT | TFN_QUIET | TFN_NO_AUTOLOAD | TFN_NO_DEREF, NULL);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005198 if (*name != NUL)
5199 s = NULL;
5200 }
5201
Bram Moolenaar843b8842016-08-21 14:36:15 +02005202 if (s == NULL || *s == NUL || (use_string && VIM_ISDIGIT(*s))
5203 || (is_funcref && trans_name == NULL))
Yegappan Lakshmanan655b7342022-03-06 14:27:10 +00005204 semsg(_(e_invalid_argument_str),
5205 use_string ? tv_get_string(&argvars[0]) : s);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005206 // Don't check an autoload name for existence here.
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005207 else if (trans_name != NULL && (is_funcref
Bram Moolenaard9d2fd02022-01-13 21:15:21 +00005208 ? find_func(trans_name, is_global) == NULL
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02005209 : !translated_function_exists(trans_name, is_global)))
Bram Moolenaara6f79292022-01-04 21:30:47 +00005210 semsg(_(e_unknown_function_str_2), s);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005211 else
5212 {
5213 int dict_idx = 0;
5214 int arg_idx = 0;
5215 list_T *list = NULL;
5216
5217 if (STRNCMP(s, "s:", 2) == 0 || STRNCMP(s, "<SID>", 5) == 0)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005218 // Expand s: and <SID> into <SNR>nr_, so that the function can
5219 // also be called from another script. Using trans_function_name()
5220 // would also work, but some plugins depend on the name being
5221 // printable text.
Yegappan Lakshmanane7f4abd2021-12-24 20:47:38 +00005222 name = get_scriptlocal_funcname(s);
Bram Moolenaarc2f17f72022-02-21 13:13:50 +00005223 else if (trans_name != NULL && *trans_name == K_SPECIAL)
5224 name = alloc_printable_func_name(trans_name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005225 else
5226 name = vim_strsave(s);
5227
5228 if (argvars[1].v_type != VAR_UNKNOWN)
5229 {
5230 if (argvars[2].v_type != VAR_UNKNOWN)
5231 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005232 // function(name, [args], dict)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005233 arg_idx = 1;
5234 dict_idx = 2;
5235 }
5236 else if (argvars[1].v_type == VAR_DICT)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005237 // function(name, dict)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005238 dict_idx = 1;
5239 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005240 // function(name, [args])
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005241 arg_idx = 1;
5242 if (dict_idx > 0)
5243 {
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +01005244 if (check_for_dict_arg(argvars, dict_idx) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005245 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005246 vim_free(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005247 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005248 }
5249 if (argvars[dict_idx].vval.v_dict == NULL)
5250 dict_idx = 0;
5251 }
5252 if (arg_idx > 0)
5253 {
5254 if (argvars[arg_idx].v_type != VAR_LIST)
5255 {
Bram Moolenaard82a47d2022-01-05 20:24:39 +00005256 emsg(_(e_second_argument_of_function_must_be_list_or_dict));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005257 vim_free(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005258 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005259 }
5260 list = argvars[arg_idx].vval.v_list;
5261 if (list == NULL || list->lv_len == 0)
5262 arg_idx = 0;
Bram Moolenaar4c054e92019-11-10 00:13:50 +01005263 else if (list->lv_len > MAX_FUNC_ARGS)
5264 {
Yegappan Lakshmanan5018a832022-04-02 21:12:21 +01005265 emsg_funcname(e_too_many_arguments_for_function_str, s);
Bram Moolenaar4c054e92019-11-10 00:13:50 +01005266 vim_free(name);
5267 goto theend;
5268 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005269 }
5270 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005271 if (dict_idx > 0 || arg_idx > 0 || arg_pt != NULL || is_funcref)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005272 {
Bram Moolenaarc799fe22019-05-28 23:08:19 +02005273 partial_T *pt = ALLOC_CLEAR_ONE(partial_T);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005274
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005275 // result is a VAR_PARTIAL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005276 if (pt == NULL)
5277 vim_free(name);
5278 else
5279 {
5280 if (arg_idx > 0 || (arg_pt != NULL && arg_pt->pt_argc > 0))
5281 {
5282 listitem_T *li;
5283 int i = 0;
5284 int arg_len = 0;
5285 int lv_len = 0;
5286
5287 if (arg_pt != NULL)
5288 arg_len = arg_pt->pt_argc;
5289 if (list != NULL)
5290 lv_len = list->lv_len;
5291 pt->pt_argc = arg_len + lv_len;
Bram Moolenaarc799fe22019-05-28 23:08:19 +02005292 pt->pt_argv = ALLOC_MULT(typval_T, pt->pt_argc);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005293 if (pt->pt_argv == NULL)
5294 {
5295 vim_free(pt);
5296 vim_free(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005297 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005298 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005299 for (i = 0; i < arg_len; i++)
5300 copy_tv(&arg_pt->pt_argv[i], &pt->pt_argv[i]);
5301 if (lv_len > 0)
Bram Moolenaar50985eb2020-01-27 22:09:39 +01005302 {
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02005303 CHECK_LIST_MATERIALIZE(list);
Bram Moolenaaraeea7212020-04-02 18:50:46 +02005304 FOR_ALL_LIST_ITEMS(list, li)
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005305 copy_tv(&li->li_tv, &pt->pt_argv[i++]);
Bram Moolenaar50985eb2020-01-27 22:09:39 +01005306 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005307 }
5308
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005309 // For "function(dict.func, [], dict)" and "func" is a partial
5310 // use "dict". That is backwards compatible.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005311 if (dict_idx > 0)
5312 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005313 // The dict is bound explicitly, pt_auto is FALSE.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005314 pt->pt_dict = argvars[dict_idx].vval.v_dict;
5315 ++pt->pt_dict->dv_refcount;
5316 }
5317 else if (arg_pt != NULL)
5318 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005319 // If the dict was bound automatically the result is also
5320 // bound automatically.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005321 pt->pt_dict = arg_pt->pt_dict;
5322 pt->pt_auto = arg_pt->pt_auto;
5323 if (pt->pt_dict != NULL)
5324 ++pt->pt_dict->dv_refcount;
Yegappan Lakshmanan29bb67f2023-10-14 11:18:50 +02005325 pt->pt_obj = arg_pt->pt_obj;
5326 if (pt->pt_obj != NULL)
5327 ++pt->pt_obj->obj_refcount;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005328 }
5329
5330 pt->pt_refcount = 1;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005331 if (arg_pt != NULL && arg_pt->pt_func != NULL)
5332 {
5333 pt->pt_func = arg_pt->pt_func;
5334 func_ptr_ref(pt->pt_func);
5335 vim_free(name);
5336 }
5337 else if (is_funcref)
5338 {
Bram Moolenaard9d2fd02022-01-13 21:15:21 +00005339 pt->pt_func = find_func(trans_name, is_global);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005340 func_ptr_ref(pt->pt_func);
5341 vim_free(name);
5342 }
5343 else
5344 {
5345 pt->pt_name = name;
5346 func_ref(name);
5347 }
Bram Moolenaar92368aa2022-02-07 17:50:39 +00005348
5349 if (arg_pt != NULL)
Bram Moolenaar7aca5ca2022-02-07 19:56:43 +00005350 {
5351 pt->pt_outer_partial = arg_pt;
5352 ++arg_pt->pt_refcount;
5353 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005354 }
5355 rettv->v_type = VAR_PARTIAL;
5356 rettv->vval.v_partial = pt;
5357 }
5358 else
5359 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005360 // result is a VAR_FUNC
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005361 rettv->v_type = VAR_FUNC;
5362 rettv->vval.v_string = name;
5363 func_ref(name);
5364 }
5365 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005366theend:
5367 vim_free(trans_name);
5368}
5369
5370/*
5371 * "funcref()" function
5372 */
5373 static void
5374f_funcref(typval_T *argvars, typval_T *rettv)
5375{
5376 common_function(argvars, rettv, TRUE);
5377}
5378
5379/*
5380 * "function()" function
5381 */
5382 static void
5383f_function(typval_T *argvars, typval_T *rettv)
5384{
5385 common_function(argvars, rettv, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005386}
5387
5388/*
5389 * "garbagecollect()" function
5390 */
5391 static void
5392f_garbagecollect(typval_T *argvars, typval_T *rettv UNUSED)
5393{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005394 if (in_vim9script() && check_for_opt_bool_arg(argvars, 0) == FAIL)
5395 return;
5396
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005397 // This is postponed until we are back at the toplevel, because we may be
5398 // using Lists and Dicts internally. E.g.: ":echo [garbagecollect()]".
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005399 want_garbage_collect = TRUE;
5400
Bram Moolenaar2df47312020-09-05 17:30:44 +02005401 if (argvars[0].v_type != VAR_UNKNOWN && tv_get_bool(&argvars[0]) == 1)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005402 garbage_collect_at_exit = TRUE;
5403}
5404
5405/*
5406 * "get()" function
5407 */
5408 static void
5409f_get(typval_T *argvars, typval_T *rettv)
5410{
5411 listitem_T *li;
5412 list_T *l;
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01005413 tuple_T *tuple;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005414 dictitem_T *di;
5415 dict_T *d;
5416 typval_T *tv = NULL;
Bram Moolenaarf91aac52019-07-28 13:21:01 +02005417 int what_is_dict = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005418
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005419 if (argvars[0].v_type == VAR_BLOB)
5420 {
5421 int error = FALSE;
5422 int idx = tv_get_number_chk(&argvars[1], &error);
5423
5424 if (!error)
5425 {
5426 rettv->v_type = VAR_NUMBER;
Bram Moolenaar2ea773b2019-01-15 22:16:42 +01005427 if (idx < 0)
5428 idx = blob_len(argvars[0].vval.v_blob) + idx;
5429 if (idx < 0 || idx >= blob_len(argvars[0].vval.v_blob))
5430 rettv->vval.v_number = -1;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005431 else
Bram Moolenaar2ea773b2019-01-15 22:16:42 +01005432 {
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005433 rettv->vval.v_number = blob_get(argvars[0].vval.v_blob, idx);
Bram Moolenaar2ea773b2019-01-15 22:16:42 +01005434 tv = rettv;
5435 }
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005436 }
5437 }
5438 else if (argvars[0].v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005439 {
5440 if ((l = argvars[0].vval.v_list) != NULL)
5441 {
5442 int error = FALSE;
5443
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005444 li = list_find(l, (long)tv_get_number_chk(&argvars[1], &error));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005445 if (!error && li != NULL)
5446 tv = &li->li_tv;
5447 }
5448 }
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01005449 else if (argvars[0].v_type == VAR_TUPLE)
5450 {
5451 if ((tuple = argvars[0].vval.v_tuple) != NULL)
5452 {
5453 int error = FALSE;
5454 long idx;
5455
5456 idx = (long)tv_get_number_chk(&argvars[1], &error);
5457 if (!error)
5458 tv = tuple_find(tuple, idx);
5459 }
5460 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005461 else if (argvars[0].v_type == VAR_DICT)
5462 {
5463 if ((d = argvars[0].vval.v_dict) != NULL)
5464 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005465 di = dict_find(d, tv_get_string(&argvars[1]), -1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005466 if (di != NULL)
5467 tv = &di->di_tv;
5468 }
5469 }
5470 else if (argvars[0].v_type == VAR_PARTIAL || argvars[0].v_type == VAR_FUNC)
5471 {
5472 partial_T *pt;
5473 partial_T fref_pt;
5474
5475 if (argvars[0].v_type == VAR_PARTIAL)
5476 pt = argvars[0].vval.v_partial;
5477 else
5478 {
Bram Moolenaara80faa82020-04-12 19:37:17 +02005479 CLEAR_FIELD(fref_pt);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005480 fref_pt.pt_name = argvars[0].vval.v_string;
5481 pt = &fref_pt;
5482 }
5483
5484 if (pt != NULL)
5485 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005486 char_u *what = tv_get_string(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005487
5488 if (STRCMP(what, "func") == 0 || STRCMP(what, "name") == 0)
5489 {
Bram Moolenaar1ae8c262022-06-27 11:45:52 +01005490 char_u *name = partial_name(pt);
5491
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005492 rettv->v_type = (*what == 'f' ? VAR_FUNC : VAR_STRING);
Bram Moolenaar1ae8c262022-06-27 11:45:52 +01005493 if (name == NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005494 rettv->vval.v_string = NULL;
5495 else
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005496 {
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005497 if (rettv->v_type == VAR_FUNC)
Bram Moolenaar1ae8c262022-06-27 11:45:52 +01005498 func_ref(name);
5499 if (*what == 'n' && pt->pt_name == NULL
5500 && pt->pt_func != NULL)
5501 // use <SNR> instead of the byte code
5502 name = printable_func_name(pt->pt_func);
5503 rettv->vval.v_string = vim_strsave(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005504 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005505 }
5506 else if (STRCMP(what, "dict") == 0)
Bram Moolenaarf91aac52019-07-28 13:21:01 +02005507 {
5508 what_is_dict = TRUE;
5509 if (pt->pt_dict != NULL)
5510 rettv_dict_set(rettv, pt->pt_dict);
5511 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005512 else if (STRCMP(what, "args") == 0)
5513 {
5514 rettv->v_type = VAR_LIST;
5515 if (rettv_list_alloc(rettv) == OK)
5516 {
5517 int i;
5518
5519 for (i = 0; i < pt->pt_argc; ++i)
5520 list_append_tv(rettv->vval.v_list, &pt->pt_argv[i]);
5521 }
5522 }
LemonBoy48b7d052024-07-09 18:24:59 +02005523 else if (STRCMP(what, "arity") == 0)
5524 {
5525 int required = 0, optional = 0, varargs = FALSE;
5526 char_u *name = partial_name(pt);
5527
5528 get_func_arity(name, &required, &optional, &varargs);
5529
5530 rettv->v_type = VAR_DICT;
5531 if (rettv_dict_alloc(rettv) == OK)
5532 {
5533 dict_T *dict = rettv->vval.v_dict;
5534
5535 // Take into account the arguments of the partial, if any.
5536 // Note that it is possible to supply more arguments than the function
5537 // accepts.
5538 if (pt->pt_argc >= required + optional)
5539 required = optional = 0;
5540 else if (pt->pt_argc > required)
5541 {
5542 optional -= pt->pt_argc - required;
5543 required = 0;
5544 }
5545 else
5546 required -= pt->pt_argc;
5547
5548 dict_add_number(dict, "required", required);
5549 dict_add_number(dict, "optional", optional);
5550 dict_add_bool(dict, "varargs", varargs);
5551 }
5552 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005553 else
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00005554 semsg(_(e_invalid_argument_str), what);
Bram Moolenaarf91aac52019-07-28 13:21:01 +02005555
5556 // When {what} == "dict" and pt->pt_dict == NULL, evaluate the
5557 // third argument
5558 if (!what_is_dict)
5559 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005560 }
5561 }
5562 else
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01005563 semsg(_(e_argument_of_str_must_be_list_tuple_dictionary_or_blob), "get()");
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005564
5565 if (tv == NULL)
5566 {
5567 if (argvars[2].v_type != VAR_UNKNOWN)
5568 copy_tv(&argvars[2], rettv);
5569 }
5570 else
5571 copy_tv(tv, rettv);
5572}
5573
Bram Moolenaarb5ae48e2016-08-12 22:23:25 +02005574/*
mikoto2000a73dfc22024-11-18 21:12:21 +01005575 * "getcellpixels()" function
5576 */
5577 static void
5578f_getcellpixels(typval_T *argvars UNUSED, typval_T *rettv)
5579{
5580 if (rettv_list_alloc(rettv) == FAIL)
5581 return;
5582
5583#if defined(FEAT_GUI)
5584 if (gui.in_use)
5585 {
5586 // success pixel size and no gui.
5587 list_append_number(rettv->vval.v_list, (varnumber_T)gui.char_width);
5588 list_append_number(rettv->vval.v_list, (varnumber_T)gui.char_height);
5589 }
5590 else
5591#endif
5592 {
5593 struct cellsize cs;
5594#if defined(UNIX)
5595 mch_calc_cell_size(&cs);
5596#else
5597 // Non-Unix CUIs are not supported, so set this to -1x-1.
5598 cs.cs_xpixel = -1;
5599 cs.cs_ypixel = -1;
5600#endif
5601
5602 // failed get pixel size.
5603 if (cs.cs_xpixel == -1)
5604 return;
5605
5606 // success pixel size and no gui.
5607 list_append_number(rettv->vval.v_list, (varnumber_T)cs.cs_xpixel);
5608 list_append_number(rettv->vval.v_list, (varnumber_T)cs.cs_ypixel);
5609 }
5610
5611}
5612
5613/*
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005614 * "getchangelist()" function
5615 */
5616 static void
5617f_getchangelist(typval_T *argvars, typval_T *rettv)
5618{
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005619 buf_T *buf;
5620 int i;
5621 list_T *l;
5622 dict_T *d;
LemonBoydb0ea7f2022-04-10 17:59:26 +01005623 int changelistindex;
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005624
Bram Moolenaar93a10962022-06-16 11:42:09 +01005625 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005626 return;
5627
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005628 if (in_vim9script() && check_for_opt_buffer_arg(argvars, 0) == FAIL)
5629 return;
5630
Bram Moolenaar4c313b12019-08-24 22:58:31 +02005631 if (argvars[0].v_type == VAR_UNKNOWN)
5632 buf = curbuf;
5633 else
Bram Moolenaara5d38412020-09-02 21:02:35 +02005634 buf = tv_get_buf_from_arg(&argvars[0]);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005635 if (buf == NULL)
5636 return;
5637
5638 l = list_alloc();
5639 if (l == NULL)
5640 return;
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005641 if (list_append_list(rettv->vval.v_list, l) == FAIL)
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005642 {
5643 vim_free(l);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005644 return;
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005645 }
5646
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005647 /*
LemonBoydb0ea7f2022-04-10 17:59:26 +01005648 * The current window change list index tracks only the position for the
5649 * current buffer. For other buffers use the stored index for the current
5650 * window, or, if that's not available, the change list length.
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005651 */
LemonBoydb0ea7f2022-04-10 17:59:26 +01005652 if (buf == curwin->w_buffer)
5653 {
5654 changelistindex = curwin->w_changelistidx;
5655 }
5656 else
5657 {
5658 wininfo_T *wip;
5659
5660 FOR_ALL_BUF_WININFO(buf, wip)
5661 if (wip->wi_win == curwin)
5662 break;
5663 changelistindex = wip != NULL ? wip->wi_changelistidx
5664 : buf->b_changelistlen;
5665 }
5666 list_append_number(rettv->vval.v_list, (varnumber_T)changelistindex);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005667
5668 for (i = 0; i < buf->b_changelistlen; ++i)
5669 {
5670 if (buf->b_changelist[i].lnum == 0)
5671 continue;
5672 if ((d = dict_alloc()) == NULL)
5673 return;
5674 if (list_append_dict(l, d) == FAIL)
5675 return;
Bram Moolenaare0be1672018-07-08 16:50:37 +02005676 dict_add_number(d, "lnum", (long)buf->b_changelist[i].lnum);
5677 dict_add_number(d, "col", (long)buf->b_changelist[i].col);
Bram Moolenaare0be1672018-07-08 16:50:37 +02005678 dict_add_number(d, "coladd", (long)buf->b_changelist[i].coladd);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005679 }
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005680}
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005681
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005682 static void
5683getpos_both(
5684 typval_T *argvars,
5685 typval_T *rettv,
5686 int getcurpos,
5687 int charcol)
5688{
5689 pos_T *fp = NULL;
5690 pos_T pos;
5691 win_T *wp = curwin;
5692 list_T *l;
5693 int fnum = -1;
5694
5695 if (rettv_list_alloc(rettv) == OK)
5696 {
5697 l = rettv->vval.v_list;
5698 if (getcurpos)
5699 {
5700 if (argvars[0].v_type != VAR_UNKNOWN)
5701 {
5702 wp = find_win_by_nr_or_id(&argvars[0]);
5703 if (wp != NULL)
5704 fp = &wp->w_cursor;
5705 }
5706 else
5707 fp = &curwin->w_cursor;
5708 if (fp != NULL && charcol)
5709 {
5710 pos = *fp;
Bram Moolenaar91458462021-01-13 20:08:38 +01005711 pos.col =
5712 buf_byteidx_to_charidx(wp->w_buffer, pos.lnum, pos.col);
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005713 fp = &pos;
5714 }
5715 }
5716 else
5717 fp = var2fpos(&argvars[0], TRUE, &fnum, charcol);
5718 if (fnum != -1)
5719 list_append_number(l, (varnumber_T)fnum);
5720 else
5721 list_append_number(l, (varnumber_T)0);
5722 list_append_number(l, (fp != NULL) ? (varnumber_T)fp->lnum
5723 : (varnumber_T)0);
5724 list_append_number(l, (fp != NULL)
5725 ? (varnumber_T)(fp->col == MAXCOL ? MAXCOL : fp->col + 1)
5726 : (varnumber_T)0);
5727 list_append_number(l, (fp != NULL) ? (varnumber_T)fp->coladd :
5728 (varnumber_T)0);
5729 if (getcurpos)
5730 {
5731 int save_set_curswant = curwin->w_set_curswant;
5732 colnr_T save_curswant = curwin->w_curswant;
5733 colnr_T save_virtcol = curwin->w_virtcol;
5734
5735 if (wp == curwin)
5736 update_curswant();
5737 list_append_number(l, wp == NULL ? 0 : wp->w_curswant == MAXCOL
5738 ? (varnumber_T)MAXCOL : (varnumber_T)wp->w_curswant + 1);
5739
5740 // Do not change "curswant", as it is unexpected that a get
5741 // function has a side effect.
5742 if (wp == curwin && save_set_curswant)
5743 {
5744 curwin->w_set_curswant = save_set_curswant;
5745 curwin->w_curswant = save_curswant;
5746 curwin->w_virtcol = save_virtcol;
5747 curwin->w_valid &= ~VALID_VIRTCOL;
5748 }
5749 }
5750 }
5751 else
5752 rettv->vval.v_number = FALSE;
5753}
5754
5755/*
5756 * "getcharpos()" function
5757 */
5758 static void
5759f_getcharpos(typval_T *argvars UNUSED, typval_T *rettv)
5760{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005761 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5762 return;
5763
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005764 getpos_both(argvars, rettv, FALSE, TRUE);
5765}
5766
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005767/*
5768 * "getcharsearch()" function
5769 */
5770 static void
5771f_getcharsearch(typval_T *argvars UNUSED, typval_T *rettv)
5772{
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00005773 if (rettv_dict_alloc(rettv) != OK)
5774 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005775
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00005776 dict_T *dict = rettv->vval.v_dict;
5777
5778 dict_add_string(dict, "char", last_csearch());
5779 dict_add_number(dict, "forward", last_csearch_forward());
5780 dict_add_number(dict, "until", last_csearch_until());
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005781}
5782
5783/*
Bram Moolenaar691ddee2019-05-09 14:52:41 +02005784 * "getenv()" function
5785 */
5786 static void
5787f_getenv(typval_T *argvars, typval_T *rettv)
5788{
5789 int mustfree = FALSE;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005790 char_u *p;
Bram Moolenaar691ddee2019-05-09 14:52:41 +02005791
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005792 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5793 return;
5794
5795 p = vim_getenv(tv_get_string(&argvars[0]), &mustfree);
Bram Moolenaar691ddee2019-05-09 14:52:41 +02005796 if (p == NULL)
5797 {
5798 rettv->v_type = VAR_SPECIAL;
5799 rettv->vval.v_number = VVAL_NULL;
5800 return;
5801 }
5802 if (!mustfree)
5803 p = vim_strsave(p);
5804 rettv->vval.v_string = p;
5805 rettv->v_type = VAR_STRING;
5806}
5807
5808/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005809 * "getfontname()" function
5810 */
5811 static void
5812f_getfontname(typval_T *argvars UNUSED, typval_T *rettv)
5813{
5814 rettv->v_type = VAR_STRING;
5815 rettv->vval.v_string = NULL;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005816
5817 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
5818 return;
5819
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005820#ifdef FEAT_GUI
5821 if (gui.in_use)
5822 {
5823 GuiFont font;
5824 char_u *name = NULL;
5825
5826 if (argvars[0].v_type == VAR_UNKNOWN)
5827 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005828 // Get the "Normal" font. Either the name saved by
5829 // hl_set_font_name() or from the font ID.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005830 font = gui.norm_font;
5831 name = hl_get_font_name();
5832 }
5833 else
5834 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005835 name = tv_get_string(&argvars[0]);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005836 if (STRCMP(name, "*") == 0) // don't use font dialog
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005837 return;
5838 font = gui_mch_get_font(name, FALSE);
5839 if (font == NOFONT)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005840 return; // Invalid font name, return empty string.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005841 }
5842 rettv->vval.v_string = gui_mch_get_fontname(font, name);
5843 if (argvars[0].v_type != VAR_UNKNOWN)
5844 gui_mch_free_font(font);
5845 }
5846#endif
5847}
5848
5849/*
Bram Moolenaar4f505882018-02-10 21:06:32 +01005850 * "getjumplist()" function
5851 */
5852 static void
5853f_getjumplist(typval_T *argvars, typval_T *rettv)
5854{
Bram Moolenaar4f505882018-02-10 21:06:32 +01005855 win_T *wp;
5856 int i;
5857 list_T *l;
5858 dict_T *d;
Bram Moolenaar4f505882018-02-10 21:06:32 +01005859
Bram Moolenaar93a10962022-06-16 11:42:09 +01005860 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar4f505882018-02-10 21:06:32 +01005861 return;
5862
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005863 if (in_vim9script()
5864 && (check_for_opt_number_arg(argvars, 0) == FAIL
5865 || (argvars[0].v_type != VAR_UNKNOWN
5866 && check_for_opt_number_arg(argvars, 1) == FAIL)))
5867 return;
5868
Bram Moolenaar00aa0692019-04-27 20:37:57 +02005869 wp = find_tabwin(&argvars[0], &argvars[1], NULL);
Bram Moolenaar4f505882018-02-10 21:06:32 +01005870 if (wp == NULL)
5871 return;
5872
Bram Moolenaar57ee2b62019-02-12 22:15:06 +01005873 cleanup_jumplist(wp, TRUE);
5874
Bram Moolenaar4f505882018-02-10 21:06:32 +01005875 l = list_alloc();
5876 if (l == NULL)
5877 return;
Bram Moolenaar4f505882018-02-10 21:06:32 +01005878 if (list_append_list(rettv->vval.v_list, l) == FAIL)
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005879 {
5880 vim_free(l);
Bram Moolenaar4f505882018-02-10 21:06:32 +01005881 return;
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005882 }
5883
Bram Moolenaar4f505882018-02-10 21:06:32 +01005884 list_append_number(rettv->vval.v_list, (varnumber_T)wp->w_jumplistidx);
5885
5886 for (i = 0; i < wp->w_jumplistlen; ++i)
5887 {
Bram Moolenaara7e18d22018-02-11 14:29:49 +01005888 if (wp->w_jumplist[i].fmark.mark.lnum == 0)
5889 continue;
Bram Moolenaar4f505882018-02-10 21:06:32 +01005890 if ((d = dict_alloc()) == NULL)
5891 return;
5892 if (list_append_dict(l, d) == FAIL)
5893 return;
Bram Moolenaare0be1672018-07-08 16:50:37 +02005894 dict_add_number(d, "lnum", (long)wp->w_jumplist[i].fmark.mark.lnum);
5895 dict_add_number(d, "col", (long)wp->w_jumplist[i].fmark.mark.col);
Bram Moolenaare0be1672018-07-08 16:50:37 +02005896 dict_add_number(d, "coladd", (long)wp->w_jumplist[i].fmark.mark.coladd);
Bram Moolenaare0be1672018-07-08 16:50:37 +02005897 dict_add_number(d, "bufnr", (long)wp->w_jumplist[i].fmark.fnum);
Bram Moolenaara7e18d22018-02-11 14:29:49 +01005898 if (wp->w_jumplist[i].fname != NULL)
Bram Moolenaare0be1672018-07-08 16:50:37 +02005899 dict_add_string(d, "filename", wp->w_jumplist[i].fname);
Bram Moolenaar4f505882018-02-10 21:06:32 +01005900 }
Bram Moolenaar4f505882018-02-10 21:06:32 +01005901}
5902
5903/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005904 * "getpid()" function
5905 */
5906 static void
5907f_getpid(typval_T *argvars UNUSED, typval_T *rettv)
5908{
5909 rettv->vval.v_number = mch_get_pid();
5910}
5911
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005912/*
5913 * "getcurpos()" function
5914 */
5915 static void
5916f_getcurpos(typval_T *argvars, typval_T *rettv)
5917{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005918 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
5919 return;
5920
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005921 getpos_both(argvars, rettv, TRUE, FALSE);
5922}
5923
5924 static void
5925f_getcursorcharpos(typval_T *argvars, typval_T *rettv)
5926{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005927 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
5928 return;
5929
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005930 getpos_both(argvars, rettv, TRUE, TRUE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005931}
5932
5933/*
5934 * "getpos(string)" function
5935 */
5936 static void
5937f_getpos(typval_T *argvars, typval_T *rettv)
5938{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005939 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5940 return;
5941
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005942 getpos_both(argvars, rettv, FALSE, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005943}
5944
5945/*
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005946 * Convert from block_def to string
5947 */
Gary Johnson88d4f252024-06-01 20:51:33 +02005948 static char_u *
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005949block_def2str(struct block_def *bd)
5950{
5951 char_u *p, *ret;
5952 size_t size = bd->startspaces + bd->endspaces + bd->textlen;
5953
5954 ret = alloc(size + 1);
5955 if (ret != NULL)
5956 {
5957 p = ret;
5958 vim_memset(p, ' ', bd->startspaces);
5959 p += bd->startspaces;
5960 mch_memmove(p, bd->textstart, bd->textlen);
5961 p += bd->textlen;
5962 vim_memset(p, ' ', bd->endspaces);
5963 *(p + bd->endspaces) = NUL;
5964 }
5965 return ret;
5966}
5967
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005968 static int
5969getregionpos(
5970 typval_T *argvars,
5971 typval_T *rettv,
zeertzjqc95e64f2024-05-20 14:00:31 +02005972 pos_T *p1,
5973 pos_T *p2,
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005974 int *inclusive,
5975 int *region_type,
zeertzjqafc22952024-05-24 19:07:12 +02005976 oparg_T *oap)
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005977{
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005978 int fnum1 = -1, fnum2 = -1;
5979 char_u *type;
5980 buf_T *findbuf;
5981 char_u default_type[] = "v";
zeertzjqafc22952024-05-24 19:07:12 +02005982 int block_width = 0;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005983 int is_select_exclusive;
5984 int l;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005985
5986 if (rettv_list_alloc(rettv) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005987 return FAIL;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005988
Shougo Matsushita19b71882024-02-28 22:48:12 +01005989 if (check_for_list_arg(argvars, 0) == FAIL
5990 || check_for_list_arg(argvars, 1) == FAIL
5991 || check_for_opt_dict_arg(argvars, 2) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005992 return FAIL;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005993
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005994 if (list2fpos(&argvars[0], p1, &fnum1, NULL, FALSE) != OK
5995 || list2fpos(&argvars[1], p2, &fnum2, NULL, FALSE) != OK
Shougo Matsushita84bf6e62024-03-06 21:10:18 +01005996 || fnum1 != fnum2)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005997 return FAIL;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005998
Shougo Matsushita19b71882024-02-28 22:48:12 +01005999 if (argvars[2].v_type == VAR_DICT)
6000 {
6001 is_select_exclusive = dict_get_bool(
6002 argvars[2].vval.v_dict, "exclusive", *p_sel == 'e');
6003 type = dict_get_string(
6004 argvars[2].vval.v_dict, "type", FALSE);
6005 if (type == NULL)
6006 type = default_type;
6007 }
6008 else
6009 {
6010 is_select_exclusive = *p_sel == 'e';
6011 type = default_type;
6012 }
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006013
6014 if (type[0] == 'v' && type[1] == NUL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006015 *region_type = MCHAR;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006016 else if (type[0] == 'V' && type[1] == NUL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006017 *region_type = MLINE;
zeertzjqafc22952024-05-24 19:07:12 +02006018 else if (type[0] == Ctrl_V)
6019 {
6020 char_u *p = type + 1;
6021
6022 if (*p != NUL && ((block_width = getdigits(&p)) <= 0 || *p != NUL))
6023 {
6024 semsg(_(e_invalid_value_for_argument_str_str), "type", type);
6025 return FAIL;
6026 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006027 *region_type = MBLOCK;
zeertzjqafc22952024-05-24 19:07:12 +02006028 }
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006029 else
zeertzjq26dd09a2024-03-10 15:46:58 +01006030 {
6031 semsg(_(e_invalid_value_for_argument_str_str), "type", type);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006032 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01006033 }
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006034
zeertzjq5406eb82024-03-11 21:36:42 +01006035 findbuf = fnum1 != 0 ? buflist_findnr(fnum1) : curbuf;
6036 if (findbuf == NULL || findbuf->b_ml.ml_mfp == NULL)
Shougo Matsushita84bf6e62024-03-06 21:10:18 +01006037 {
zeertzjq5406eb82024-03-11 21:36:42 +01006038 emsg(_(e_buffer_is_not_loaded));
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006039 return FAIL;
Shougo Matsushita84bf6e62024-03-06 21:10:18 +01006040 }
6041
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006042 if (p1->lnum < 1 || p1->lnum > findbuf->b_ml.ml_line_count)
zeertzjq26dd09a2024-03-10 15:46:58 +01006043 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006044 semsg(_(e_invalid_line_number_nr), p1->lnum);
6045 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01006046 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006047 if (p1->col == MAXCOL)
6048 p1->col = ml_get_buf_len(findbuf, p1->lnum) + 1;
6049 else if (p1->col < 1 || p1->col > ml_get_buf_len(findbuf, p1->lnum) + 1)
zeertzjq26dd09a2024-03-10 15:46:58 +01006050 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006051 semsg(_(e_invalid_column_number_nr), p1->col);
6052 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01006053 }
zeertzjq2ffdae72024-05-02 13:06:24 +02006054
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006055 if (p2->lnum < 1 || p2->lnum > findbuf->b_ml.ml_line_count)
zeertzjq26dd09a2024-03-10 15:46:58 +01006056 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006057 semsg(_(e_invalid_line_number_nr), p2->lnum);
6058 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01006059 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006060 if (p2->col == MAXCOL)
6061 p2->col = ml_get_buf_len(findbuf, p2->lnum) + 1;
6062 else if (p2->col < 1 || p2->col > ml_get_buf_len(findbuf, p2->lnum) + 1)
zeertzjq26dd09a2024-03-10 15:46:58 +01006063 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006064 semsg(_(e_invalid_column_number_nr), p2->col);
6065 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01006066 }
6067
6068 curbuf = findbuf;
zeertzjq5406eb82024-03-11 21:36:42 +01006069 curwin->w_buffer = curbuf;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006070 virtual_op = virtual_active();
6071
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006072 // NOTE: Adjustment is needed.
6073 p1->col--;
6074 p2->col--;
Shougo Matsushita19b71882024-02-28 22:48:12 +01006075
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006076 if (!LT_POS(*p1, *p2))
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006077 {
6078 // swap position
6079 pos_T p;
6080
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006081 p = *p1;
6082 *p1 = *p2;
6083 *p2 = p;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006084 }
6085
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006086 if (*region_type == MCHAR)
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006087 {
zeertzjq701ad502024-05-23 07:47:55 +02006088 // Handle 'selection' == "exclusive".
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006089 if (is_select_exclusive && !EQUAL_POS(*p1, *p2))
zeertzjq701ad502024-05-23 07:47:55 +02006090 // When backing up to previous line, inclusive becomes false.
6091 *inclusive = !unadjust_for_sel_inner(p2);
6092 // If p2 is on NUL (end of line), inclusive becomes false.
6093 if (*inclusive && !virtual_op && *ml_get_pos(p2) == NUL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006094 *inclusive = FALSE;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006095 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006096 else if (*region_type == MBLOCK)
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006097 {
6098 colnr_T sc1, ec1, sc2, ec2;
6099
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006100 getvvcol(curwin, p1, &sc1, NULL, &ec1);
6101 getvvcol(curwin, p2, &sc2, NULL, &ec2);
zeertzjqafc22952024-05-24 19:07:12 +02006102 oap->motion_type = MBLOCK;
6103 oap->inclusive = TRUE;
6104 oap->op_type = OP_NOP;
6105 oap->start = *p1;
6106 oap->end = *p2;
6107 oap->start_vcol = MIN(sc1, sc2);
6108 if (block_width > 0)
6109 oap->end_vcol = oap->start_vcol + block_width - 1;
6110 else if (is_select_exclusive && ec1 < sc2 && 0 < sc2 && ec2 > ec1)
6111 oap->end_vcol = sc2 - 1;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006112 else
zeertzjqafc22952024-05-24 19:07:12 +02006113 oap->end_vcol = MAX(ec1, ec2);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006114 }
6115
6116 // Include the trailing byte of a multi-byte char.
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006117 l = mb_ptr2len((char_u *)ml_get_pos(p2));
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006118 if (l > 1)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006119 p2->col += l - 1;
6120
6121 return OK;
6122}
6123
6124/*
6125 * "getregion()" function
6126 */
6127 static void
6128f_getregion(typval_T *argvars, typval_T *rettv)
6129{
6130 pos_T p1, p2;
6131 int inclusive = TRUE;
6132 int region_type = -1;
6133 oparg_T oa;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006134
6135 buf_T *save_curbuf;
6136 int save_virtual;
6137 char_u *akt = NULL;
6138 linenr_T lnum;
6139
6140 save_curbuf = curbuf;
6141 save_virtual = virtual_op;
6142
6143 if (getregionpos(argvars, rettv,
zeertzjqc95e64f2024-05-20 14:00:31 +02006144 &p1, &p2, &inclusive, &region_type, &oa) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006145 return;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006146
6147 for (lnum = p1.lnum; lnum <= p2.lnum; lnum++)
6148 {
6149 int ret = 0;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006150 struct block_def bd;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006151
6152 if (region_type == MLINE)
6153 akt = vim_strsave(ml_get(lnum));
6154 else if (region_type == MBLOCK)
6155 {
zeertzjq5e3674b2024-02-22 19:51:34 +01006156 block_prep(&oa, &bd, lnum, FALSE);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006157 akt = block_def2str(&bd);
6158 }
6159 else if (p1.lnum < lnum && lnum < p2.lnum)
6160 akt = vim_strsave(ml_get(lnum));
6161 else
6162 {
6163 charwise_block_prep(p1, p2, &bd, lnum, inclusive);
6164 akt = block_def2str(&bd);
6165 }
6166
6167 if (akt)
6168 {
6169 ret = list_append_string(rettv->vval.v_list, akt, -1);
6170 vim_free(akt);
6171 }
6172
6173 if (akt == NULL || ret == FAIL)
6174 {
zeertzjq5e3674b2024-02-22 19:51:34 +01006175 clear_tv(rettv);
6176 (void)rettv_list_alloc(rettv);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006177 break;
6178 }
6179 }
6180
zeertzjqc95e64f2024-05-20 14:00:31 +02006181 // getregionpos() may change curbuf and virtual_op
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006182 curbuf = save_curbuf;
6183 curwin->w_buffer = curbuf;
6184 virtual_op = save_virtual;
6185}
6186
6187 static void
zeertzjqc95e64f2024-05-20 14:00:31 +02006188add_regionpos_range(typval_T *rettv, pos_T p1, pos_T p2)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006189{
6190 list_T *l1, *l2, *l3;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006191
6192 l1 = list_alloc();
6193 if (l1 == NULL)
6194 return;
6195
6196 if (list_append_list(rettv->vval.v_list, l1) == FAIL)
6197 {
6198 vim_free(l1);
6199 return;
6200 }
6201
6202 l2 = list_alloc();
6203 if (l2 == NULL)
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006204 {
6205 vim_free(l1);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006206 return;
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006207 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006208
6209 if (list_append_list(l1, l2) == FAIL)
6210 {
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006211 vim_free(l1);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006212 vim_free(l2);
6213 return;
6214 }
6215
6216 l3 = list_alloc();
6217 if (l3 == NULL)
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006218 {
6219 vim_free(l1);
6220 vim_free(l2);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006221 return;
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006222 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006223
6224 if (list_append_list(l1, l3) == FAIL)
6225 {
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006226 vim_free(l1);
6227 vim_free(l2);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006228 vim_free(l3);
6229 return;
6230 }
6231
zeertzjqc95e64f2024-05-20 14:00:31 +02006232 list_append_number(l2, curbuf->b_fnum);
6233 list_append_number(l2, p1.lnum);
zeertzjq2b09de92024-05-24 07:48:51 +02006234 list_append_number(l2, p1.col);
zeertzjqc95e64f2024-05-20 14:00:31 +02006235 list_append_number(l2, p1.coladd);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006236
zeertzjqc95e64f2024-05-20 14:00:31 +02006237 list_append_number(l3, curbuf->b_fnum);
6238 list_append_number(l3, p2.lnum);
zeertzjq2b09de92024-05-24 07:48:51 +02006239 list_append_number(l3, p2.col);
zeertzjqc95e64f2024-05-20 14:00:31 +02006240 list_append_number(l3, p2.coladd);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006241}
6242
6243/*
6244 * "getregionpos()" function
6245 */
6246 static void
6247f_getregionpos(typval_T *argvars, typval_T *rettv)
6248{
6249 pos_T p1, p2;
6250 int inclusive = TRUE;
6251 int region_type = -1;
zeertzjq2b09de92024-05-24 07:48:51 +02006252 int allow_eol = FALSE;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006253 oparg_T oa;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006254 int lnum;
6255
6256 buf_T *save_curbuf;
6257 int save_virtual;
6258
6259 save_curbuf = curbuf;
6260 save_virtual = virtual_op;
6261
6262 if (getregionpos(argvars, rettv,
zeertzjqc95e64f2024-05-20 14:00:31 +02006263 &p1, &p2, &inclusive, &region_type, &oa) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006264 return;
6265
zeertzjq2b09de92024-05-24 07:48:51 +02006266 if (argvars[2].v_type == VAR_DICT)
6267 allow_eol = dict_get_bool(argvars[2].vval.v_dict, "eol", FALSE);
6268
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006269 for (lnum = p1.lnum; lnum <= p2.lnum; lnum++)
6270 {
zeertzjq2b09de92024-05-24 07:48:51 +02006271 pos_T ret_p1, ret_p2;
zeertzjqef733742024-05-26 18:42:18 +02006272 char_u *line = ml_get(lnum);
zeertzjq2b09de92024-05-24 07:48:51 +02006273 colnr_T line_len = ml_get_len(lnum);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006274
6275 if (region_type == MLINE)
6276 {
zeertzjqc95e64f2024-05-20 14:00:31 +02006277 ret_p1.col = 1;
6278 ret_p1.coladd = 0;
6279 ret_p2.col = MAXCOL;
6280 ret_p2.coladd = 0;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006281 }
6282 else
6283 {
zeertzjq52a6f342024-05-22 16:42:44 +02006284 struct block_def bd;
6285
zeertzjqc95e64f2024-05-20 14:00:31 +02006286 if (region_type == MBLOCK)
6287 block_prep(&oa, &bd, lnum, FALSE);
6288 else
6289 charwise_block_prep(p1, p2, &bd, lnum, inclusive);
zeertzjq52a6f342024-05-22 16:42:44 +02006290
6291 if (bd.is_oneChar) // selection entirely inside one char
6292 {
6293 if (region_type == MBLOCK)
6294 {
zeertzjqef733742024-05-26 18:42:18 +02006295 ret_p1.col = mb_prevptr(line, bd.textstart) - line + 1;
zeertzjq52a6f342024-05-22 16:42:44 +02006296 ret_p1.coladd = bd.start_char_vcols
6297 - (bd.start_vcol - oa.start_vcol);
6298 }
6299 else
6300 {
6301 ret_p1.col = p1.col + 1;
6302 ret_p1.coladd = p1.coladd;
6303 }
6304 }
zeertzjq2b09de92024-05-24 07:48:51 +02006305 else if (region_type == MBLOCK && oa.start_vcol > bd.start_vcol)
6306 {
6307 // blockwise selection entirely beyond end of line
6308 ret_p1.col = MAXCOL;
6309 ret_p1.coladd = oa.start_vcol - bd.start_vcol;
6310 bd.is_oneChar = TRUE;
6311 }
zeertzjq52a6f342024-05-22 16:42:44 +02006312 else if (bd.startspaces > 0)
zeertzjqc95e64f2024-05-20 14:00:31 +02006313 {
zeertzjqef733742024-05-26 18:42:18 +02006314 ret_p1.col = mb_prevptr(line, bd.textstart) - line + 1;
zeertzjqc95e64f2024-05-20 14:00:31 +02006315 ret_p1.coladd = bd.start_char_vcols - bd.startspaces;
6316 }
6317 else
6318 {
6319 ret_p1.col = bd.textcol + 1;
6320 ret_p1.coladd = 0;
6321 }
zeertzjq52a6f342024-05-22 16:42:44 +02006322
6323 if (bd.is_oneChar) // selection entirely inside one char
6324 {
6325 ret_p2.col = ret_p1.col;
zeertzjq2b09de92024-05-24 07:48:51 +02006326 ret_p2.coladd = ret_p1.coladd + bd.startspaces + bd.endspaces;
zeertzjq52a6f342024-05-22 16:42:44 +02006327 }
6328 else if (bd.endspaces > 0)
zeertzjqc95e64f2024-05-20 14:00:31 +02006329 {
6330 ret_p2.col = bd.textcol + bd.textlen + 1;
6331 ret_p2.coladd = bd.endspaces;
6332 }
6333 else
6334 {
6335 ret_p2.col = bd.textcol + bd.textlen;
6336 ret_p2.coladd = 0;
6337 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006338 }
6339
zeertzjq2b09de92024-05-24 07:48:51 +02006340 if (!allow_eol && ret_p1.col > line_len)
6341 {
6342 ret_p1.col = 0;
6343 ret_p1.coladd = 0;
6344 }
6345 else if (ret_p1.col > line_len + 1)
6346 ret_p1.col = line_len + 1;
6347
6348 if (!allow_eol && ret_p2.col > line_len)
6349 {
6350 ret_p2.col = ret_p1.col == 0 ? 0 : line_len;
6351 ret_p2.coladd = 0;
6352 }
6353 else if (ret_p2.col > line_len + 1)
6354 ret_p2.col = line_len + 1;
6355
zeertzjqc95e64f2024-05-20 14:00:31 +02006356 ret_p1.lnum = lnum;
6357 ret_p2.lnum = lnum;
6358 add_regionpos_range(rettv, ret_p1, ret_p2);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006359 }
6360
6361 // getregionpos() may change curbuf and virtual_op
zeertzjq5406eb82024-03-11 21:36:42 +01006362 curbuf = save_curbuf;
6363 curwin->w_buffer = curbuf;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006364 virtual_op = save_virtual;
6365}
6366
6367/*
zeertzjqd3f00f52021-12-24 12:02:43 +00006368 * Common between getreg(), getreginfo() and getregtype(): get the register
6369 * name from the first argument.
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006370 * Returns zero on error.
6371 */
6372 static int
6373getreg_get_regname(typval_T *argvars)
6374{
6375 char_u *strregname;
6376
6377 if (argvars[0].v_type != VAR_UNKNOWN)
6378 {
6379 strregname = tv_get_string_chk(&argvars[0]);
6380 if (strregname != NULL && in_vim9script() && STRLEN(strregname) > 1)
6381 {
6382 semsg(_(e_register_name_must_be_one_char_str), strregname);
6383 strregname = NULL;
6384 }
6385 if (strregname == NULL) // type error; errmsg already given
6386 return 0;
6387 }
6388 else
6389 // Default to v:register
6390 strregname = get_vim_var_str(VV_REG);
6391
6392 return *strregname == 0 ? '"' : *strregname;
6393}
6394
6395/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006396 * "getreg()" function
6397 */
6398 static void
6399f_getreg(typval_T *argvars, typval_T *rettv)
6400{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006401 int regname;
6402 int arg2 = FALSE;
6403 int return_list = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006404
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02006405 if (in_vim9script()
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006406 && (check_for_opt_string_arg(argvars, 0) == FAIL
6407 || (argvars[0].v_type != VAR_UNKNOWN
6408 && (check_for_opt_bool_arg(argvars, 1) == FAIL
6409 || (argvars[1].v_type != VAR_UNKNOWN
6410 && check_for_opt_bool_arg(argvars, 2) == FAIL)))))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02006411 return;
6412
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006413 regname = getreg_get_regname(argvars);
6414 if (regname == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006415 return;
6416
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006417 if (argvars[0].v_type != VAR_UNKNOWN && argvars[1].v_type != VAR_UNKNOWN)
6418 {
6419 int error = FALSE;
6420
6421 arg2 = (int)tv_get_bool_chk(&argvars[1], &error);
6422
6423 if (!error && argvars[2].v_type != VAR_UNKNOWN)
6424 return_list = (int)tv_get_bool_chk(&argvars[2], &error);
6425 if (error)
6426 return;
6427 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006428
6429 if (return_list)
6430 {
6431 rettv->v_type = VAR_LIST;
6432 rettv->vval.v_list = (list_T *)get_reg_contents(regname,
6433 (arg2 ? GREG_EXPR_SRC : 0) | GREG_LIST);
6434 if (rettv->vval.v_list == NULL)
6435 (void)rettv_list_alloc(rettv);
6436 else
6437 ++rettv->vval.v_list->lv_refcount;
6438 }
6439 else
6440 {
6441 rettv->v_type = VAR_STRING;
6442 rettv->vval.v_string = get_reg_contents(regname,
6443 arg2 ? GREG_EXPR_SRC : 0);
6444 }
6445}
6446
6447/*
6448 * "getregtype()" function
6449 */
6450 static void
6451f_getregtype(typval_T *argvars, typval_T *rettv)
6452{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006453 int regname;
6454 char_u buf[NUMBUFLEN + 2];
6455 long reglen = 0;
6456
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006457 // on error return an empty string
6458 rettv->v_type = VAR_STRING;
6459 rettv->vval.v_string = NULL;
6460
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006461 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
6462 return;
6463
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006464 regname = getreg_get_regname(argvars);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006465 if (regname == 0)
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006466 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006467
6468 buf[0] = NUL;
6469 buf[1] = NUL;
6470 switch (get_reg_type(regname, &reglen))
6471 {
6472 case MLINE: buf[0] = 'V'; break;
6473 case MCHAR: buf[0] = 'v'; break;
6474 case MBLOCK:
6475 buf[0] = Ctrl_V;
6476 sprintf((char *)buf + 1, "%ld", reglen + 1);
6477 break;
6478 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006479 rettv->vval.v_string = vim_strsave(buf);
6480}
6481
Bram Moolenaarb5ae48e2016-08-12 22:23:25 +02006482/*
Bram Moolenaarf49cc602018-11-11 15:21:05 +01006483 * "gettagstack()" function
6484 */
6485 static void
6486f_gettagstack(typval_T *argvars, typval_T *rettv)
6487{
6488 win_T *wp = curwin; // default is current window
6489
Bram Moolenaar93a10962022-06-16 11:42:09 +01006490 if (rettv_dict_alloc(rettv) == FAIL)
Bram Moolenaarf49cc602018-11-11 15:21:05 +01006491 return;
6492
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006493 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
6494 return;
6495
Bram Moolenaarf49cc602018-11-11 15:21:05 +01006496 if (argvars[0].v_type != VAR_UNKNOWN)
6497 {
6498 wp = find_win_by_nr_or_id(&argvars[0]);
6499 if (wp == NULL)
6500 return;
6501 }
6502
6503 get_tagstack(wp, rettv->vval.v_dict);
6504}
6505
Bram Moolenaar0b39c3f2020-08-30 15:52:10 +02006506/*
6507 * "gettext()" function
6508 */
6509 static void
6510f_gettext(typval_T *argvars, typval_T *rettv)
6511{
Christ van Willegence0ef912024-06-20 23:41:59 +02006512#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
6513 char *prev = NULL;
6514#endif
6515
6516 if (check_for_nonempty_string_arg(argvars, 0) == FAIL
6517 || check_for_opt_string_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006518 return;
6519
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +01006520 rettv->v_type = VAR_STRING;
Christ van Willegence0ef912024-06-20 23:41:59 +02006521
6522 if (argvars[1].v_type == VAR_STRING &&
6523 argvars[1].vval.v_string != NULL &&
6524 *(argvars[1].vval.v_string) != NUL)
6525 {
6526#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
6527 prev = bind_textdomain_codeset((const char *)argvars[1].vval.v_string, (char *)p_enc);
6528#endif
6529
6530#if defined(HAVE_DGETTEXT)
6531 rettv->vval.v_string = vim_strsave((char_u *)dgettext((const char *)argvars[1].vval.v_string, (const char *)argvars[0].vval.v_string));
6532#else
6533 textdomain((const char *)argvars[1].vval.v_string);
6534 rettv->vval.v_string = vim_strsave((char_u *)_(argvars[0].vval.v_string));
6535 textdomain(VIMPACKAGE);
6536#endif
6537
6538#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
6539 if (prev != NULL)
6540 bind_textdomain_codeset((const char *)argvars[1].vval.v_string, prev);
6541#endif
6542 }
6543 else
6544 rettv->vval.v_string = vim_strsave((char_u *)_(argvars[0].vval.v_string));
Bram Moolenaar0b39c3f2020-08-30 15:52:10 +02006545}
6546
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01006547// for VIM_VERSION_ defines
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006548#include "version.h"
6549
6550/*
6551 * "has()" function
6552 */
Bram Moolenaara259d8d2020-01-31 20:10:50 +01006553 void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006554f_has(typval_T *argvars, typval_T *rettv)
6555{
6556 int i;
6557 char_u *name;
Bram Moolenaar79296512020-03-22 16:17:14 +01006558 int x = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006559 int n = FALSE;
Bram Moolenaar79296512020-03-22 16:17:14 +01006560 typedef struct {
6561 char *name;
6562 short present;
6563 } has_item_T;
6564 static has_item_T has_list[] =
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006565 {
Bram Moolenaar79296512020-03-22 16:17:14 +01006566 {"amiga",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006567#ifdef AMIGA
Bram Moolenaar79296512020-03-22 16:17:14 +01006568 1
Bram Moolenaar39536dd2019-01-29 22:58:21 +01006569#else
Bram Moolenaar79296512020-03-22 16:17:14 +01006570 0
Bram Moolenaar39536dd2019-01-29 22:58:21 +01006571#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006572 },
6573 {"arp",
6574#if defined(AMIGA) && defined(FEAT_ARP)
6575 1
6576#else
6577 0
6578#endif
6579 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006580 {"haiku",
6581#ifdef __HAIKU__
6582 1
6583#else
6584 0
6585#endif
6586 },
6587 {"bsd",
Zhaoming Luoa41dfcd2025-02-06 21:39:35 +01006588#if defined(BSD) && !defined(MACOS_X) && !defined(__GNU__)
Bram Moolenaar79296512020-03-22 16:17:14 +01006589 1
6590#else
6591 0
6592#endif
6593 },
6594 {"hpux",
6595#ifdef hpux
6596 1
6597#else
6598 0
6599#endif
6600 },
Zhaoming Luoa41dfcd2025-02-06 21:39:35 +01006601 {"hurd",
6602#ifdef __GNU__
6603 1
6604#else
6605 0
6606#endif
6607 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006608 {"linux",
6609#ifdef __linux__
6610 1
6611#else
6612 0
6613#endif
6614 },
6615 {"mac", // Mac OS X (and, once, Mac OS Classic)
6616#ifdef MACOS_X
6617 1
6618#else
6619 0
6620#endif
6621 },
6622 {"osx", // Mac OS X
6623#ifdef MACOS_X
6624 1
6625#else
6626 0
6627#endif
6628 },
6629 {"macunix", // Mac OS X, with the darwin feature
6630#if defined(MACOS_X) && defined(MACOS_X_DARWIN)
6631 1
6632#else
6633 0
6634#endif
6635 },
6636 {"osxdarwin", // synonym for macunix
6637#if defined(MACOS_X) && defined(MACOS_X_DARWIN)
6638 1
6639#else
6640 0
6641#endif
6642 },
6643 {"qnx",
6644#ifdef __QNX__
6645 1
6646#else
6647 0
6648#endif
6649 },
6650 {"sun",
6651#ifdef SUN_SYSTEM
6652 1
6653#else
6654 0
6655#endif
6656 },
6657 {"unix",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006658#ifdef UNIX
Bram Moolenaar79296512020-03-22 16:17:14 +01006659 1
6660#else
6661 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006662#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006663 },
6664 {"vms",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006665#ifdef VMS
Bram Moolenaar79296512020-03-22 16:17:14 +01006666 1
6667#else
6668 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006669#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006670 },
6671 {"win32",
Bram Moolenaar4f974752019-02-17 17:44:42 +01006672#ifdef MSWIN
Bram Moolenaar79296512020-03-22 16:17:14 +01006673 1
6674#else
6675 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006676#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006677 },
6678 {"win32unix",
K.Takata972db232022-02-04 10:45:38 +00006679#ifdef WIN32UNIX
Bram Moolenaar79296512020-03-22 16:17:14 +01006680 1
6681#else
6682 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006683#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006684 },
6685 {"win64",
Bram Moolenaar44b443c2019-02-18 22:14:18 +01006686#ifdef _WIN64
Bram Moolenaar79296512020-03-22 16:17:14 +01006687 1
6688#else
6689 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006690#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006691 },
Bram Moolenaar424bcae2022-01-31 14:59:41 +00006692 {"ebcdic", 0 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006693 {"fname_case",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006694#ifndef CASE_INSENSITIVE_FILENAME
Bram Moolenaar79296512020-03-22 16:17:14 +01006695 1
6696#else
6697 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006698#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006699 },
6700 {"acl",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006701#ifdef HAVE_ACL
Bram Moolenaar79296512020-03-22 16:17:14 +01006702 1
6703#else
6704 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006705#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006706 },
6707 {"arabic",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006708#ifdef FEAT_ARABIC
Bram Moolenaar79296512020-03-22 16:17:14 +01006709 1
6710#else
6711 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006712#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006713 },
6714 {"autocmd", 1},
6715 {"autochdir",
Bram Moolenaar83ec2a72018-07-27 22:08:59 +02006716#ifdef FEAT_AUTOCHDIR
Bram Moolenaar79296512020-03-22 16:17:14 +01006717 1
6718#else
6719 0
Bram Moolenaar83ec2a72018-07-27 22:08:59 +02006720#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006721 },
6722 {"autoservername",
Bram Moolenaare42a6d22017-11-12 19:21:51 +01006723#ifdef FEAT_AUTOSERVERNAME
Bram Moolenaar79296512020-03-22 16:17:14 +01006724 1
6725#else
6726 0
Bram Moolenaare42a6d22017-11-12 19:21:51 +01006727#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006728 },
6729 {"balloon_eval",
Bram Moolenaarc3719bd2017-11-18 22:13:31 +01006730#ifdef FEAT_BEVAL_GUI
Bram Moolenaar79296512020-03-22 16:17:14 +01006731 1
6732#else
6733 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006734#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006735 },
6736 {"balloon_multiline",
Bram Moolenaar0bd663a2022-01-22 10:24:47 +00006737#ifdef FEAT_BEVAL_GUI
Bram Moolenaar79296512020-03-22 16:17:14 +01006738 1
6739#else
6740 0
6741#endif
6742 },
6743 {"balloon_eval_term",
Bram Moolenaarc3719bd2017-11-18 22:13:31 +01006744#ifdef FEAT_BEVAL_TERM
Bram Moolenaar79296512020-03-22 16:17:14 +01006745 1
6746#else
6747 0
Bram Moolenaar51b0f372017-11-18 18:52:04 +01006748#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006749 },
Bram Moolenaar2ee347f2022-08-26 17:53:44 +01006750 {"builtin_terms", 1},
6751 {"all_builtin_terms", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006752 {"browsefilter",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006753#if defined(FEAT_BROWSE) && (defined(USE_FILE_CHOOSER) \
Bram Moolenaar4f974752019-02-17 17:44:42 +01006754 || defined(FEAT_GUI_MSWIN) \
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006755 || defined(FEAT_GUI_MOTIF))
Bram Moolenaar79296512020-03-22 16:17:14 +01006756 1
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006757#else
Bram Moolenaar79296512020-03-22 16:17:14 +01006758 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006759#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006760 },
6761 {"byte_offset",
6762#ifdef FEAT_BYTEOFF
6763 1
6764#else
6765 0
6766#endif
6767 },
6768 {"channel",
6769#ifdef FEAT_JOB_CHANNEL
6770 1
6771#else
6772 0
6773#endif
6774 },
Bram Moolenaar8e145b82022-05-21 20:17:31 +01006775 {"cindent", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006776 {"clientserver",
6777#ifdef FEAT_CLIENTSERVER
6778 1
6779#else
6780 0
6781#endif
6782 },
6783 {"clipboard",
6784#ifdef FEAT_CLIPBOARD
6785 1
6786#else
6787 0
6788#endif
6789 },
6790 {"cmdline_compl", 1},
6791 {"cmdline_hist", 1},
Martin Tournoij7904fa42022-10-04 16:28:45 +01006792 {"cmdwin", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006793 {"comments", 1},
6794 {"conceal",
6795#ifdef FEAT_CONCEAL
6796 1
6797#else
6798 0
6799#endif
6800 },
6801 {"cryptv",
6802#ifdef FEAT_CRYPT
6803 1
6804#else
6805 0
6806#endif
6807 },
6808 {"crypt-blowfish",
6809#ifdef FEAT_CRYPT
6810 1
6811#else
6812 0
6813#endif
6814 },
6815 {"crypt-blowfish2",
6816#ifdef FEAT_CRYPT
6817 1
6818#else
6819 0
6820#endif
6821 },
6822 {"cscope",
6823#ifdef FEAT_CSCOPE
6824 1
6825#else
6826 0
6827#endif
6828 },
6829 {"cursorbind", 1},
6830 {"cursorshape",
6831#ifdef CURSOR_SHAPE
6832 1
6833#else
6834 0
6835#endif
6836 },
6837 {"debug",
6838#ifdef DEBUG
6839 1
6840#else
6841 0
6842#endif
6843 },
6844 {"dialog_con",
6845#ifdef FEAT_CON_DIALOG
6846 1
6847#else
6848 0
6849#endif
6850 },
glepnirdf461152024-04-04 22:23:29 +02006851 {"dialog_con_gui",
6852#if defined(FEAT_CON_DIALOG) && defined(FEAT_GUI_DIALOG)
6853 1
6854#else
6855 0
6856#endif
6857 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006858 {"dialog_gui",
6859#ifdef FEAT_GUI_DIALOG
6860 1
6861#else
6862 0
6863#endif
6864 },
6865 {"diff",
6866#ifdef FEAT_DIFF
6867 1
6868#else
6869 0
6870#endif
6871 },
6872 {"digraphs",
6873#ifdef FEAT_DIGRAPHS
6874 1
6875#else
6876 0
6877#endif
6878 },
6879 {"directx",
6880#ifdef FEAT_DIRECTX
6881 1
6882#else
6883 0
6884#endif
6885 },
6886 {"dnd",
6887#ifdef FEAT_DND
6888 1
6889#else
6890 0
6891#endif
6892 },
Bram Moolenaar1d1ce612021-06-27 19:02:52 +02006893 {"drop_file",
6894#ifdef HAVE_DROP_FILE
6895 1
6896#else
6897 0
6898#endif
6899 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006900 {"emacs_tags",
6901#ifdef FEAT_EMACS_TAGS
6902 1
6903#else
6904 0
6905#endif
6906 },
6907 {"eval", 1}, // always present, of course!
6908 {"ex_extra", 1}, // graduated feature
6909 {"extra_search",
6910#ifdef FEAT_SEARCH_EXTRA
6911 1
6912#else
6913 0
6914#endif
6915 },
Bram Moolenaarf80f40a2022-08-25 16:02:23 +01006916 {"file_in_path", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006917 {"filterpipe",
6918#if defined(FEAT_FILTERPIPE) && !defined(VIMDLL)
6919 1
6920#else
6921 0
6922#endif
6923 },
6924 {"find_in_path",
6925#ifdef FEAT_FIND_ID
6926 1
6927#else
6928 0
6929#endif
6930 },
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01006931 {"float", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006932 {"folding",
6933#ifdef FEAT_FOLDING
6934 1
6935#else
6936 0
6937#endif
6938 },
Bram Moolenaarc8ac3a02022-09-04 12:29:28 +01006939 {"footer", 0},
Bram Moolenaar79296512020-03-22 16:17:14 +01006940 {"fork",
6941#if !defined(USE_SYSTEM) && defined(UNIX)
6942 1
6943#else
6944 0
6945#endif
6946 },
6947 {"gettext",
6948#ifdef FEAT_GETTEXT
6949 1
6950#else
6951 0
6952#endif
6953 },
6954 {"gui",
6955#ifdef FEAT_GUI
6956 1
6957#else
6958 0
6959#endif
6960 },
Bram Moolenaar0b962e52022-04-03 18:02:37 +01006961 {"gui_neXtaw", 0 },
6962 {"gui_athena", 0 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006963 {"gui_gtk",
6964#ifdef FEAT_GUI_GTK
6965 1
6966#else
6967 0
6968#endif
6969 },
6970 {"gui_gtk2",
6971#if defined(FEAT_GUI_GTK) && !defined(USE_GTK3)
6972 1
6973#else
6974 0
6975#endif
6976 },
6977 {"gui_gtk3",
6978#if defined(FEAT_GUI_GTK) && defined(USE_GTK3)
6979 1
6980#else
6981 0
6982#endif
6983 },
6984 {"gui_gnome",
6985#ifdef FEAT_GUI_GNOME
6986 1
6987#else
6988 0
6989#endif
6990 },
6991 {"gui_haiku",
6992#ifdef FEAT_GUI_HAIKU
6993 1
6994#else
6995 0
6996#endif
6997 },
Bram Moolenaar097148e2020-08-11 21:58:20 +02006998 {"gui_mac", 0},
Bram Moolenaar79296512020-03-22 16:17:14 +01006999 {"gui_motif",
7000#ifdef FEAT_GUI_MOTIF
7001 1
7002#else
7003 0
7004#endif
7005 },
7006 {"gui_photon",
7007#ifdef FEAT_GUI_PHOTON
7008 1
7009#else
7010 0
7011#endif
7012 },
7013 {"gui_win32",
7014#ifdef FEAT_GUI_MSWIN
7015 1
7016#else
7017 0
7018#endif
7019 },
7020 {"iconv",
7021#if defined(HAVE_ICONV_H) && defined(USE_ICONV)
7022 1
7023#else
7024 0
7025#endif
7026 },
7027 {"insert_expand", 1},
Bram Moolenaarbfe13cc2020-04-12 17:53:12 +02007028 {"ipv6",
7029#ifdef FEAT_IPV6
7030 1
7031#else
7032 0
7033#endif
7034 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007035 {"job",
7036#ifdef FEAT_JOB_CHANNEL
7037 1
7038#else
7039 0
7040#endif
7041 },
Bram Moolenaar739f13a2021-12-13 13:12:53 +00007042 {"jumplist", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007043 {"keymap",
7044#ifdef FEAT_KEYMAP
7045 1
7046#else
7047 0
7048#endif
7049 },
7050 {"lambda", 1}, // always with FEAT_EVAL, since 7.4.2120 with closure
7051 {"langmap",
7052#ifdef FEAT_LANGMAP
7053 1
7054#else
7055 0
7056#endif
7057 },
7058 {"libcall",
7059#ifdef FEAT_LIBCALL
7060 1
7061#else
7062 0
7063#endif
7064 },
7065 {"linebreak",
7066#ifdef FEAT_LINEBREAK
7067 1
7068#else
7069 0
7070#endif
7071 },
Bram Moolenaar8e145b82022-05-21 20:17:31 +01007072 {"lispindent", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007073 {"listcmds", 1},
7074 {"localmap", 1},
7075 {"lua",
7076#if defined(FEAT_LUA) && !defined(DYNAMIC_LUA)
7077 1
7078#else
7079 0
7080#endif
7081 },
7082 {"menu",
7083#ifdef FEAT_MENU
7084 1
7085#else
7086 0
7087#endif
7088 },
7089 {"mksession",
7090#ifdef FEAT_SESSION
7091 1
7092#else
7093 0
7094#endif
7095 },
7096 {"modify_fname", 1},
7097 {"mouse", 1},
7098 {"mouseshape",
7099#ifdef FEAT_MOUSESHAPE
7100 1
7101#else
7102 0
7103#endif
7104 },
7105 {"mouse_dec",
7106#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_DEC)
7107 1
7108#else
7109 0
7110#endif
7111 },
7112 {"mouse_gpm",
Bram Moolenaar33fc4a62022-02-23 18:07:38 +00007113#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_GPM) && !defined(DYNAMIC_GPM)
Bram Moolenaar79296512020-03-22 16:17:14 +01007114 1
7115#else
7116 0
7117#endif
7118 },
7119 {"mouse_jsbterm",
7120#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_JSB)
7121 1
7122#else
7123 0
7124#endif
7125 },
7126 {"mouse_netterm",
7127#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_NET)
7128 1
7129#else
7130 0
7131#endif
7132 },
7133 {"mouse_pterm",
7134#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_PTERM)
7135 1
7136#else
7137 0
7138#endif
7139 },
7140 {"mouse_sgr",
7141#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_XTERM)
7142 1
7143#else
7144 0
7145#endif
7146 },
7147 {"mouse_sysmouse",
7148#if (defined(UNIX) || defined(VMS)) && defined(FEAT_SYSMOUSE)
7149 1
7150#else
7151 0
7152#endif
7153 },
7154 {"mouse_urxvt",
7155#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_URXVT)
7156 1
7157#else
7158 0
7159#endif
7160 },
7161 {"mouse_xterm",
7162#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_XTERM)
7163 1
7164#else
7165 0
7166#endif
7167 },
7168 {"multi_byte", 1},
7169 {"multi_byte_ime",
7170#ifdef FEAT_MBYTE_IME
7171 1
7172#else
7173 0
7174#endif
7175 },
7176 {"multi_lang",
7177#ifdef FEAT_MULTI_LANG
7178 1
7179#else
7180 0
7181#endif
7182 },
7183 {"mzscheme",
7184#if defined(FEAT_MZSCHEME) && !defined(DYNAMIC_MZSCHEME)
7185 1
7186#else
7187 0
7188#endif
7189 },
Leah Neukirchen0a7984a2021-10-14 21:27:55 +01007190 {"nanotime",
7191#ifdef ST_MTIM_NSEC
7192 1
7193#else
7194 0
7195#endif
7196 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007197 {"num64", 1},
7198 {"ole",
7199#ifdef FEAT_OLE
7200 1
7201#else
7202 0
7203#endif
7204 },
7205 {"packages",
7206#ifdef FEAT_EVAL
7207 1
7208#else
7209 0
7210#endif
7211 },
Bram Moolenaar2bd9dbc2022-08-25 18:12:06 +01007212 {"path_extra", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007213 {"perl",
7214#if defined(FEAT_PERL) && !defined(DYNAMIC_PERL)
7215 1
7216#else
7217 0
7218#endif
7219 },
7220 {"persistent_undo",
7221#ifdef FEAT_PERSISTENT_UNDO
7222 1
7223#else
7224 0
7225#endif
7226 },
7227 {"python_compiled",
7228#if defined(FEAT_PYTHON)
7229 1
7230#else
7231 0
7232#endif
7233 },
7234 {"python_dynamic",
7235#if defined(FEAT_PYTHON) && defined(DYNAMIC_PYTHON)
7236 1
7237#else
7238 0
7239#endif
7240 },
7241 {"python",
7242#if defined(FEAT_PYTHON) && !defined(DYNAMIC_PYTHON)
7243 1
7244#else
7245 0
7246#endif
7247 },
7248 {"pythonx",
7249#if (defined(FEAT_PYTHON) && !defined(DYNAMIC_PYTHON)) \
7250 || (defined(FEAT_PYTHON3) && !defined(DYNAMIC_PYTHON3))
7251 1
7252#else
7253 0
7254#endif
7255 },
7256 {"python3_compiled",
7257#if defined(FEAT_PYTHON3)
7258 1
7259#else
7260 0
7261#endif
7262 },
7263 {"python3_dynamic",
7264#if defined(FEAT_PYTHON3) && defined(DYNAMIC_PYTHON3)
7265 1
7266#else
7267 0
7268#endif
7269 },
Yee Cheng Chinc13b3d12023-08-20 21:18:38 +02007270 {"python3_stable",
7271#if defined(FEAT_PYTHON3) && defined(DYNAMIC_PYTHON3_STABLE_ABI)
7272 1
7273#else
7274 0
7275#endif
7276 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007277 {"python3",
7278#if defined(FEAT_PYTHON3) && !defined(DYNAMIC_PYTHON3)
7279 1
7280#else
7281 0
7282#endif
7283 },
7284 {"popupwin",
7285#ifdef FEAT_PROP_POPUP
7286 1
7287#else
7288 0
7289#endif
7290 },
7291 {"postscript",
7292#ifdef FEAT_POSTSCRIPT
7293 1
7294#else
7295 0
7296#endif
7297 },
7298 {"printer",
7299#ifdef FEAT_PRINTER
7300 1
7301#else
7302 0
7303#endif
7304 },
7305 {"profile",
7306#ifdef FEAT_PROFILE
7307 1
7308#else
7309 0
7310#endif
7311 },
Ernie Rael076de792023-03-16 21:43:15 +00007312 {"prof_nsec",
Bram Moolenaar08210f82023-04-13 19:15:54 +01007313#ifdef PROF_NSEC
Ernie Rael076de792023-03-16 21:43:15 +00007314 1
7315#else
7316 0
7317#endif
7318 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007319 {"reltime",
7320#ifdef FEAT_RELTIME
7321 1
7322#else
7323 0
7324#endif
7325 },
7326 {"quickfix",
7327#ifdef FEAT_QUICKFIX
7328 1
7329#else
7330 0
7331#endif
7332 },
7333 {"rightleft",
7334#ifdef FEAT_RIGHTLEFT
7335 1
7336#else
7337 0
7338#endif
7339 },
7340 {"ruby",
7341#if defined(FEAT_RUBY) && !defined(DYNAMIC_RUBY)
7342 1
7343#else
7344 0
7345#endif
7346 },
7347 {"scrollbind", 1},
Martin Tournoijba43e762022-10-13 22:12:15 +01007348 {"showcmd", 1},
7349 {"cmdline_info", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007350 {"signs",
7351#ifdef FEAT_SIGNS
7352 1
7353#else
7354 0
7355#endif
7356 },
Bram Moolenaar8e145b82022-05-21 20:17:31 +01007357 {"smartindent", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007358 {"startuptime",
7359#ifdef STARTUPTIME
7360 1
7361#else
7362 0
7363#endif
7364 },
7365 {"statusline",
7366#ifdef FEAT_STL_OPT
7367 1
7368#else
7369 0
7370#endif
7371 },
7372 {"netbeans_intg",
7373#ifdef FEAT_NETBEANS_INTG
7374 1
7375#else
7376 0
7377#endif
7378 },
Christian Brabandtf573c6e2021-06-20 14:02:16 +02007379 {"sodium",
K.Takatad68b2fc2022-02-12 11:18:37 +00007380#if defined(FEAT_SODIUM) && !defined(DYNAMIC_SODIUM)
Christian Brabandtf573c6e2021-06-20 14:02:16 +02007381 1
7382#else
7383 0
7384#endif
7385 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007386 {"sound",
7387#ifdef FEAT_SOUND
7388 1
7389#else
7390 0
7391#endif
7392 },
7393 {"spell",
7394#ifdef FEAT_SPELL
7395 1
7396#else
7397 0
7398#endif
7399 },
7400 {"syntax",
7401#ifdef FEAT_SYN_HL
7402 1
7403#else
7404 0
7405#endif
7406 },
7407 {"system",
7408#if defined(USE_SYSTEM) || !defined(UNIX)
7409 1
7410#else
7411 0
7412#endif
7413 },
Yegappan Lakshmanan655b7342022-03-06 14:27:10 +00007414 {"tag_binary", 1}, // graduated feature
Bram Moolenaar79296512020-03-22 16:17:14 +01007415 {"tcl",
7416#if defined(FEAT_TCL) && !defined(DYNAMIC_TCL)
7417 1
7418#else
7419 0
7420#endif
7421 },
7422 {"termguicolors",
7423#ifdef FEAT_TERMGUICOLORS
7424 1
7425#else
7426 0
7427#endif
7428 },
7429 {"terminal",
7430#if defined(FEAT_TERMINAL) && !defined(MSWIN)
7431 1
7432#else
7433 0
7434#endif
7435 },
7436 {"terminfo",
7437#ifdef TERMINFO
7438 1
7439#else
7440 0
7441#endif
7442 },
7443 {"termresponse",
7444#ifdef FEAT_TERMRESPONSE
7445 1
7446#else
7447 0
7448#endif
7449 },
Bram Moolenaar88774872022-08-16 20:24:29 +01007450 {"textobjects", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007451 {"textprop",
7452#ifdef FEAT_PROP_POPUP
7453 1
7454#else
7455 0
7456#endif
7457 },
7458 {"tgetent",
7459#ifdef HAVE_TGETENT
7460 1
7461#else
7462 0
7463#endif
7464 },
7465 {"timers",
7466#ifdef FEAT_TIMERS
7467 1
7468#else
7469 0
7470#endif
7471 },
Bram Moolenaar651fca82021-11-29 20:39:38 +00007472 {"title", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007473 {"toolbar",
7474#ifdef FEAT_TOOLBAR
7475 1
7476#else
7477 0
7478#endif
7479 },
7480 {"unnamedplus",
7481#if defined(FEAT_CLIPBOARD) && defined(FEAT_X11)
7482 1
7483#else
7484 0
7485#endif
7486 },
7487 {"user-commands", 1}, // was accidentally included in 5.4
7488 {"user_commands", 1},
7489 {"vartabs",
7490#ifdef FEAT_VARTABS
7491 1
7492#else
7493 0
7494#endif
7495 },
7496 {"vertsplit", 1},
7497 {"viminfo",
7498#ifdef FEAT_VIMINFO
7499 1
7500#else
7501 0
7502#endif
7503 },
Bram Moolenaarb79ee0c2022-01-01 12:17:00 +00007504 {"vim9script", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007505 {"vimscript-1", 1},
7506 {"vimscript-2", 1},
7507 {"vimscript-3", 1},
7508 {"vimscript-4", 1},
7509 {"virtualedit", 1},
7510 {"visual", 1},
7511 {"visualextra", 1},
7512 {"vreplace", 1},
7513 {"vtp",
7514#ifdef FEAT_VTP
7515 1
7516#else
7517 0
7518#endif
7519 },
Bram Moolenaar074fbd42022-08-26 16:41:14 +01007520 {"wildignore", 1},
Bram Moolenaar54162322022-08-26 16:58:51 +01007521 {"wildmenu", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007522 {"windows", 1},
7523 {"winaltkeys",
7524#ifdef FEAT_WAK
7525 1
7526#else
7527 0
7528#endif
7529 },
7530 {"writebackup",
7531#ifdef FEAT_WRITEBACKUP
7532 1
7533#else
7534 0
7535#endif
7536 },
Christian Brabandte085dfd2023-09-30 12:49:18 +02007537 {"xattr",
7538#ifdef FEAT_XATTR
7539 1
7540#else
7541 0
7542#endif
7543 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007544 {"xim",
7545#ifdef FEAT_XIM
7546 1
7547#else
7548 0
7549#endif
7550 },
7551 {"xfontset",
7552#ifdef FEAT_XFONTSET
7553 1
7554#else
7555 0
7556#endif
7557 },
7558 {"xpm",
7559#if defined(FEAT_XPM_W32) || defined(HAVE_XPM)
7560 1
7561#else
7562 0
7563#endif
7564 },
7565 {"xpm_w32", // for backward compatibility
7566#ifdef FEAT_XPM_W32
7567 1
7568#else
7569 0
7570#endif
7571 },
7572 {"xsmp",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007573#ifdef USE_XSMP
Bram Moolenaar79296512020-03-22 16:17:14 +01007574 1
7575#else
7576 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007577#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007578 },
7579 {"xsmp_interact",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007580#ifdef USE_XSMP_INTERACT
Bram Moolenaar79296512020-03-22 16:17:14 +01007581 1
7582#else
7583 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007584#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007585 },
7586 {"xterm_clipboard",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007587#ifdef FEAT_XCLIPBOARD
Bram Moolenaar79296512020-03-22 16:17:14 +01007588 1
7589#else
7590 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007591#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007592 },
7593 {"xterm_save",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007594#ifdef FEAT_XTERM_SAVE
Bram Moolenaar79296512020-03-22 16:17:14 +01007595 1
7596#else
7597 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007598#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007599 },
7600 {"X11",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007601#if defined(UNIX) && defined(FEAT_X11)
Bram Moolenaar79296512020-03-22 16:17:14 +01007602 1
7603#else
7604 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007605#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007606 },
Bram Moolenaar80adaa82023-07-07 18:57:40 +01007607 {":tearoff",
7608// same #ifdef as used for ex_tearoff().
7609#if defined(FEAT_GUI_MSWIN) && defined(FEAT_MENU) && defined(FEAT_TEAROFF)
7610 1
7611#else
7612 0
7613#endif
7614 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007615 {NULL, 0}
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007616 };
7617
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02007618 if (in_vim9script()
7619 && (check_for_string_arg(argvars, 0) == FAIL
7620 || check_for_opt_bool_arg(argvars, 1) == FAIL))
7621 return;
7622
Bram Moolenaard155d7a2018-12-21 16:04:21 +01007623 name = tv_get_string(&argvars[0]);
Bram Moolenaar79296512020-03-22 16:17:14 +01007624 for (i = 0; has_list[i].name != NULL; ++i)
7625 if (STRICMP(name, has_list[i].name) == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007626 {
Bram Moolenaar79296512020-03-22 16:17:14 +01007627 x = TRUE;
7628 n = has_list[i].present;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007629 break;
7630 }
7631
Bram Moolenaar79296512020-03-22 16:17:14 +01007632 // features also in has_list[] but sometimes enabled at runtime
7633 if (x == TRUE && n == FALSE)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007634 {
Bram Moolenaar79296512020-03-22 16:17:14 +01007635 if (0)
Bram Moolenaar86b9a3e2020-04-07 19:57:29 +02007636 {
7637 // intentionally empty
7638 }
Bram Moolenaar79296512020-03-22 16:17:14 +01007639#ifdef VIMDLL
7640 else if (STRICMP(name, "filterpipe") == 0)
7641 n = gui.in_use || gui.starting;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007642#endif
7643#if defined(USE_ICONV) && defined(DYNAMIC_ICONV)
7644 else if (STRICMP(name, "iconv") == 0)
7645 n = iconv_enabled(FALSE);
7646#endif
7647#ifdef DYNAMIC_LUA
7648 else if (STRICMP(name, "lua") == 0)
7649 n = lua_enabled(FALSE);
7650#endif
7651#ifdef DYNAMIC_MZSCHEME
7652 else if (STRICMP(name, "mzscheme") == 0)
7653 n = mzscheme_enabled(FALSE);
7654#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007655#ifdef DYNAMIC_PERL
7656 else if (STRICMP(name, "perl") == 0)
7657 n = perl_enabled(FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007658#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007659#ifdef DYNAMIC_PYTHON
7660 else if (STRICMP(name, "python") == 0)
7661 n = python_enabled(FALSE);
7662#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007663#ifdef DYNAMIC_PYTHON3
7664 else if (STRICMP(name, "python3") == 0)
7665 n = python3_enabled(FALSE);
7666#endif
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01007667#if defined(DYNAMIC_PYTHON) || defined(DYNAMIC_PYTHON3)
7668 else if (STRICMP(name, "pythonx") == 0)
7669 {
7670# if defined(DYNAMIC_PYTHON) && defined(DYNAMIC_PYTHON3)
7671 if (p_pyx == 0)
7672 n = python3_enabled(FALSE) || python_enabled(FALSE);
7673 else if (p_pyx == 3)
7674 n = python3_enabled(FALSE);
7675 else if (p_pyx == 2)
7676 n = python_enabled(FALSE);
7677# elif defined(DYNAMIC_PYTHON)
7678 n = python_enabled(FALSE);
7679# elif defined(DYNAMIC_PYTHON3)
7680 n = python3_enabled(FALSE);
7681# endif
7682 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007683#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007684#ifdef DYNAMIC_RUBY
7685 else if (STRICMP(name, "ruby") == 0)
7686 n = ruby_enabled(FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007687#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007688#ifdef DYNAMIC_TCL
7689 else if (STRICMP(name, "tcl") == 0)
7690 n = tcl_enabled(FALSE);
Bram Moolenaar4b8366b2019-05-04 17:34:34 +02007691#endif
K.Takatad68b2fc2022-02-12 11:18:37 +00007692#ifdef DYNAMIC_SODIUM
7693 else if (STRICMP(name, "sodium") == 0)
7694 n = sodium_enabled(FALSE);
7695#endif
Bram Moolenaar4f974752019-02-17 17:44:42 +01007696#if defined(FEAT_TERMINAL) && defined(MSWIN)
Bram Moolenaara83e3962017-08-17 14:39:07 +02007697 else if (STRICMP(name, "terminal") == 0)
7698 n = terminal_enabled();
7699#endif
Bram Moolenaar33fc4a62022-02-23 18:07:38 +00007700#ifdef DYNAMIC_GPM
7701 else if (STRICMP(name, "mouse_gpm") == 0)
7702 n = gpm_available();
7703#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007704 }
7705
Bram Moolenaar79296512020-03-22 16:17:14 +01007706 // features not in has_list[]
7707 if (x == FALSE)
7708 {
7709 if (STRNICMP(name, "patch", 5) == 0)
7710 {
7711 x = TRUE;
7712 if (name[5] == '-'
7713 && STRLEN(name) >= 11
K.Takatad90f91f2022-07-30 15:43:59 +01007714 && (name[6] >= '1' && name[6] <= '9'))
Bram Moolenaar79296512020-03-22 16:17:14 +01007715 {
K.Takatad90f91f2022-07-30 15:43:59 +01007716 char *end;
7717 int major, minor;
Bram Moolenaar79296512020-03-22 16:17:14 +01007718
K.Takatad90f91f2022-07-30 15:43:59 +01007719 // This works for patch-8.1.2, patch-9.0.3, patch-10.0.4, etc.
7720 // Not for patch-9.10.5.
7721 major = (int)strtoul((char *)name + 6, &end, 10);
7722 if (*end == '.' && vim_isdigit(end[1])
7723 && end[2] == '.' && vim_isdigit(end[3]))
7724 {
7725 minor = atoi(end + 1);
7726
7727 // Expect "patch-9.9.01234".
7728 n = (major < VIM_VERSION_MAJOR
7729 || (major == VIM_VERSION_MAJOR
7730 && (minor < VIM_VERSION_MINOR
7731 || (minor == VIM_VERSION_MINOR
7732 && has_patch(atoi(end + 3))))));
7733 }
Bram Moolenaar79296512020-03-22 16:17:14 +01007734 }
Keith Thompson184f71c2024-01-04 21:19:04 +01007735 else if (SAFE_isdigit(name[5]))
Bram Moolenaar79296512020-03-22 16:17:14 +01007736 n = has_patch(atoi((char *)name + 5));
7737 }
7738 else if (STRICMP(name, "vim_starting") == 0)
7739 {
7740 x = TRUE;
7741 n = (starting != 0);
7742 }
7743 else if (STRICMP(name, "ttyin") == 0)
7744 {
7745 x = TRUE;
7746 n = mch_input_isatty();
7747 }
7748 else if (STRICMP(name, "ttyout") == 0)
7749 {
7750 x = TRUE;
7751 n = stdout_isatty;
7752 }
7753 else if (STRICMP(name, "multi_byte_encoding") == 0)
7754 {
7755 x = TRUE;
7756 n = has_mbyte;
7757 }
7758 else if (STRICMP(name, "gui_running") == 0)
7759 {
7760 x = TRUE;
7761#ifdef FEAT_GUI
7762 n = (gui.in_use || gui.starting);
7763#endif
7764 }
7765 else if (STRICMP(name, "browse") == 0)
7766 {
7767 x = TRUE;
7768#if defined(FEAT_GUI) && defined(FEAT_BROWSE)
7769 n = gui.in_use; // gui_mch_browse() works when GUI is running
7770#endif
7771 }
7772 else if (STRICMP(name, "syntax_items") == 0)
7773 {
7774 x = TRUE;
7775#ifdef FEAT_SYN_HL
7776 n = syntax_present(curwin);
7777#endif
7778 }
7779 else if (STRICMP(name, "vcon") == 0)
7780 {
7781 x = TRUE;
7782#ifdef FEAT_VTP
7783 n = is_term_win32() && has_vtp_working();
7784#endif
7785 }
7786 else if (STRICMP(name, "netbeans_enabled") == 0)
7787 {
7788 x = TRUE;
7789#ifdef FEAT_NETBEANS_INTG
7790 n = netbeans_active();
7791#endif
7792 }
7793 else if (STRICMP(name, "mouse_gpm_enabled") == 0)
7794 {
7795 x = TRUE;
7796#ifdef FEAT_MOUSE_GPM
7797 n = gpm_enabled();
7798#endif
7799 }
7800 else if (STRICMP(name, "conpty") == 0)
7801 {
7802 x = TRUE;
7803#if defined(FEAT_TERMINAL) && defined(MSWIN)
7804 n = use_conpty();
7805#endif
7806 }
7807 else if (STRICMP(name, "clipboard_working") == 0)
7808 {
7809 x = TRUE;
7810#ifdef FEAT_CLIPBOARD
7811 n = clip_star.available;
7812#endif
7813 }
7814 }
7815
Bram Moolenaar04637e22020-09-05 18:45:29 +02007816 if (argvars[1].v_type != VAR_UNKNOWN && tv_get_bool(&argvars[1]))
Bram Moolenaar79296512020-03-22 16:17:14 +01007817 // return whether feature could ever be enabled
7818 rettv->vval.v_number = x;
7819 else
7820 // return whether feature is enabled
7821 rettv->vval.v_number = n;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007822}
7823
7824/*
Bram Moolenaar8cebd432020-11-08 12:49:47 +01007825 * Return TRUE if "feature" can change later.
7826 * Also when checking for the feature has side effects, such as loading a DLL.
7827 */
7828 int
7829dynamic_feature(char_u *feature)
7830{
7831 return (feature == NULL
Bram Moolenaar8cebd432020-11-08 12:49:47 +01007832#if defined(FEAT_GUI) && defined(FEAT_BROWSE)
7833 || (STRICMP(feature, "browse") == 0 && !gui.in_use)
7834#endif
7835#ifdef VIMDLL
7836 || STRICMP(feature, "filterpipe") == 0
7837#endif
Bram Moolenaar29b281b2020-11-10 20:58:00 +01007838#if defined(FEAT_GUI) && !defined(ALWAYS_USE_GUI) && !defined(VIMDLL)
Bram Moolenaar8cebd432020-11-08 12:49:47 +01007839 // this can only change on Unix where the ":gui" command could be
7840 // used.
7841 || (STRICMP(feature, "gui_running") == 0 && !gui.in_use)
7842#endif
7843#if defined(USE_ICONV) && defined(DYNAMIC_ICONV)
7844 || STRICMP(feature, "iconv") == 0
7845#endif
7846#ifdef DYNAMIC_LUA
7847 || STRICMP(feature, "lua") == 0
7848#endif
7849#ifdef FEAT_MOUSE_GPM
7850 || (STRICMP(feature, "mouse_gpm_enabled") == 0 && !gpm_enabled())
7851#endif
7852#ifdef DYNAMIC_MZSCHEME
7853 || STRICMP(feature, "mzscheme") == 0
7854#endif
7855#ifdef FEAT_NETBEANS_INTG
7856 || STRICMP(feature, "netbeans_enabled") == 0
7857#endif
7858#ifdef DYNAMIC_PERL
7859 || STRICMP(feature, "perl") == 0
7860#endif
7861#ifdef DYNAMIC_PYTHON
7862 || STRICMP(feature, "python") == 0
7863#endif
7864#ifdef DYNAMIC_PYTHON3
7865 || STRICMP(feature, "python3") == 0
7866#endif
7867#if defined(DYNAMIC_PYTHON) || defined(DYNAMIC_PYTHON3)
7868 || STRICMP(feature, "pythonx") == 0
7869#endif
7870#ifdef DYNAMIC_RUBY
7871 || STRICMP(feature, "ruby") == 0
7872#endif
7873#ifdef FEAT_SYN_HL
7874 || STRICMP(feature, "syntax_items") == 0
7875#endif
7876#ifdef DYNAMIC_TCL
7877 || STRICMP(feature, "tcl") == 0
7878#endif
7879 // once "starting" is zero it will stay that way
7880 || (STRICMP(feature, "vim_starting") == 0 && starting != 0)
7881 || STRICMP(feature, "multi_byte_encoding") == 0
7882#if defined(FEAT_TERMINAL) && defined(MSWIN)
7883 || STRICMP(feature, "conpty") == 0
7884#endif
7885 );
7886}
7887
7888/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007889 * "haslocaldir()" function
7890 */
7891 static void
7892f_haslocaldir(typval_T *argvars, typval_T *rettv)
7893{
Bram Moolenaar00aa0692019-04-27 20:37:57 +02007894 tabpage_T *tp = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007895 win_T *wp = NULL;
7896
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02007897 if (in_vim9script()
7898 && (check_for_opt_number_arg(argvars, 0) == FAIL
7899 || (argvars[0].v_type != VAR_UNKNOWN
7900 && check_for_opt_number_arg(argvars, 1) == FAIL)))
7901 return;
7902
Bram Moolenaar00aa0692019-04-27 20:37:57 +02007903 wp = find_tabwin(&argvars[0], &argvars[1], &tp);
7904
7905 // Check for window-local and tab-local directories
7906 if (wp != NULL && wp->w_localdir != NULL)
7907 rettv->vval.v_number = 1;
7908 else if (tp != NULL && tp->tp_localdir != NULL)
7909 rettv->vval.v_number = 2;
7910 else
7911 rettv->vval.v_number = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007912}
7913
7914/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007915 * "highlightID(name)" function
7916 */
7917 static void
7918f_hlID(typval_T *argvars, typval_T *rettv)
7919{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02007920 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
7921 return;
7922
Bram Moolenaard155d7a2018-12-21 16:04:21 +01007923 rettv->vval.v_number = syn_name2id(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007924}
7925
7926/*
7927 * "highlight_exists()" function
7928 */
7929 static void
7930f_hlexists(typval_T *argvars, typval_T *rettv)
7931{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02007932 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
7933 return;
7934
Bram Moolenaard155d7a2018-12-21 16:04:21 +01007935 rettv->vval.v_number = highlight_exists(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007936}
7937
7938/*
7939 * "hostname()" function
7940 */
7941 static void
7942f_hostname(typval_T *argvars UNUSED, typval_T *rettv)
7943{
7944 char_u hostname[256];
7945
7946 mch_get_host_name(hostname, 256);
7947 rettv->v_type = VAR_STRING;
7948 rettv->vval.v_string = vim_strsave(hostname);
7949}
7950
7951/*
Ernie Raelc8e158b2024-07-09 18:39:52 +02007952 * "id()" function
7953 * Identity. Return address of item as a hex string, %p format.
7954 * Currently only valid for object/container types.
7955 * Return empty string if not an object.
7956 */
Zoltan Arpadffy10231ac2024-08-18 16:59:20 +02007957#ifdef VMS // VMS does not have defined uintptr_t
7958# if defined(HAVE_NO_LONG_LONG)
7959typedef unsigned int uintptr_t;
7960# else
7961typedef unsigned long long uintptr_t;
7962# endif
7963#endif // VMS
7964
John Marriottb3b2bee2024-07-14 11:12:51 +02007965 static void
Ernie Raelc8e158b2024-07-09 18:39:52 +02007966f_id(typval_T *argvars, typval_T *rettv)
7967{
Ernie Rael05124252024-07-11 22:10:45 +02007968 char numbuf[NUMBUFLEN];
7969 char *p = numbuf;
Ernie Raelc8e158b2024-07-09 18:39:52 +02007970
7971 switch (argvars[0].v_type)
7972 {
7973 case VAR_LIST:
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01007974 case VAR_TUPLE:
Ernie Raelc8e158b2024-07-09 18:39:52 +02007975 case VAR_DICT:
7976 case VAR_OBJECT:
7977 case VAR_JOB:
7978 case VAR_CHANNEL:
7979 case VAR_BLOB:
7980 // Assume pointer value in typval_T vval union at common location.
7981 if (argvars[0].vval.v_object != NULL)
Ernie Rael05124252024-07-11 22:10:45 +02007982 {
7983 // "v" gets the address as an integer
7984 uintptr_t v = (uintptr_t)(void *)argvars[0].vval.v_object;
7985 // Build a hex string from the item's address; it is in
7986 // reverse order. Ignore trailing zeros.
7987 for (; p < numbuf + sizeof(uintptr_t) * 2 && v != 0;
7988 ++p, v >>= 4)
7989 *p = "0123456789abcdef"[v & 0xf];
7990 }
Ernie Raelc8e158b2024-07-09 18:39:52 +02007991 default:
Ernie Rael05124252024-07-11 22:10:45 +02007992 break;
Ernie Raelc8e158b2024-07-09 18:39:52 +02007993 }
Ernie Rael05124252024-07-11 22:10:45 +02007994 *p = NUL;
Ernie Raelc8e158b2024-07-09 18:39:52 +02007995
7996 rettv->v_type = VAR_STRING;
Ernie Rael05124252024-07-11 22:10:45 +02007997 rettv->vval.v_string = vim_strsave((char_u *)numbuf);
Ernie Raelc8e158b2024-07-09 18:39:52 +02007998}
7999
8000/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008001 * index() function for a blob
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008002 */
8003 static void
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008004index_func_blob(typval_T *argvars, typval_T *rettv)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008005{
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008006 typval_T tv;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008007 blob_T *b;
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008008 int start = 0;
8009 int error = FALSE;
8010 int ic = FALSE;
8011
8012 b = argvars[0].vval.v_blob;
8013 if (b == NULL)
8014 return;
8015
8016 if (argvars[2].v_type != VAR_UNKNOWN)
8017 {
8018 start = tv_get_number_chk(&argvars[2], &error);
8019 if (error)
8020 return;
8021 }
8022
8023 if (start < 0)
8024 {
8025 start = blob_len(b) + start;
8026 if (start < 0)
8027 start = 0;
8028 }
8029
8030 for (int idx = start; idx < blob_len(b); ++idx)
8031 {
8032 tv.v_type = VAR_NUMBER;
8033 tv.vval.v_number = blob_get(b, idx);
8034 if (tv_equal(&tv, &argvars[1], ic))
8035 {
8036 rettv->vval.v_number = idx;
8037 return;
8038 }
8039 }
8040}
8041
8042/*
8043 * index() function for a tuple
8044 */
8045 static void
8046index_func_tuple(typval_T *argvars, typval_T *rettv)
8047{
8048 tuple_T *tuple = argvars[0].vval.v_tuple;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008049 int ic = FALSE;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008050 int error = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008051
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008052 if (tuple == NULL)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008053 return;
8054
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008055 int start_idx = 0;
8056 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008057 {
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008058 start_idx = tv_get_number_chk(&argvars[2], &error);
8059 if (!error && argvars[3].v_type != VAR_UNKNOWN)
8060 ic = (int)tv_get_bool_chk(&argvars[3], &error);
8061 if (error)
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008062 return;
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008063 }
Bram Moolenaar05500ec2019-01-13 19:10:33 +01008064
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008065 rettv->vval.v_number = index_tuple(tuple, &argvars[1], start_idx, ic);
8066}
8067
8068/*
8069 * index() function for a list
8070 */
8071 static void
8072index_func_list(typval_T *argvars, typval_T *rettv)
8073{
8074 list_T *l;
8075 listitem_T *item;
8076 long idx = 0;
8077 int ic = FALSE;
8078 int error = FALSE;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008079
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008080 l = argvars[0].vval.v_list;
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00008081 if (l == NULL)
8082 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008083
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00008084 CHECK_LIST_MATERIALIZE(l);
8085 item = l->lv_first;
8086 if (argvars[2].v_type != VAR_UNKNOWN)
8087 {
8088 // Start at specified item. Use the cached index that list_find()
8089 // sets, so that a negative number also works.
8090 item = list_find(l, (long)tv_get_number_chk(&argvars[2], &error));
8091 idx = l->lv_u.mat.lv_idx;
8092 if (argvars[3].v_type != VAR_UNKNOWN)
8093 ic = (int)tv_get_bool_chk(&argvars[3], &error);
8094 if (error)
8095 item = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008096 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00008097
8098 for ( ; item != NULL; item = item->li_next, ++idx)
Yinzuo Jiang7ccd1a22024-07-04 17:20:53 +02008099 if (tv_equal(&item->li_tv, &argvars[1], ic))
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00008100 {
8101 rettv->vval.v_number = idx;
8102 break;
8103 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008104}
8105
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008106/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008107 * "index()" function
8108 */
8109 static void
8110f_index(typval_T *argvars, typval_T *rettv)
8111{
8112 rettv->vval.v_number = -1;
8113
8114 if (in_vim9script()
8115 && (check_for_list_or_tuple_or_blob_arg(argvars, 0) == FAIL
8116 || (argvars[0].v_type == VAR_BLOB
8117 && check_for_number_arg(argvars, 1) == FAIL)
8118 || check_for_opt_number_arg(argvars, 2) == FAIL
8119 || (argvars[2].v_type != VAR_UNKNOWN
8120 && check_for_opt_bool_arg(argvars, 3) == FAIL)))
8121 return;
8122
8123 if (argvars[0].v_type == VAR_BLOB)
8124 index_func_blob(argvars, rettv);
8125 else if (argvars[0].v_type == VAR_TUPLE)
8126 index_func_tuple(argvars, rettv);
8127 else if (argvars[0].v_type == VAR_LIST)
8128 index_func_list(argvars, rettv);
8129 else
8130 emsg(_(e_list_or_blob_required));
8131}
8132
8133/*
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008134 * Evaluate 'expr' with the v:key and v:val arguments and return the result.
8135 * The expression is expected to return a boolean value. The caller should set
8136 * the VV_KEY and VV_VAL vim variables before calling this function.
8137 */
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008138 int
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008139indexof_eval_expr(typval_T *expr)
8140{
8141 typval_T argv[3];
8142 typval_T newtv;
8143 varnumber_T found;
8144 int error = FALSE;
8145
8146 argv[0] = *get_vim_var_tv(VV_KEY);
8147 argv[1] = *get_vim_var_tv(VV_VAL);
8148 newtv.v_type = VAR_UNKNOWN;
8149
zeertzjqad0c4422023-08-17 22:15:47 +02008150 if (eval_expr_typval(expr, FALSE, argv, 2, NULL, &newtv) == FAIL)
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008151 return FALSE;
8152
8153 found = tv_get_bool_chk(&newtv, &error);
Yegappan Lakshmanan63acae12022-08-14 12:07:11 +01008154 clear_tv(&newtv);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008155
8156 return error ? FALSE : found;
8157}
8158
8159/*
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008160 * Evaluate 'expr' for each byte in the Blob 'b' starting with the byte at
8161 * 'startidx' and return the index of the byte where 'expr' is TRUE. Returns
8162 * -1 if 'expr' doesn't evaluate to TRUE for any of the bytes.
8163 */
8164 static int
8165indexof_blob(blob_T *b, long startidx, typval_T *expr)
8166{
8167 long idx = 0;
8168
8169 if (b == NULL)
8170 return -1;
8171
8172 if (startidx < 0)
8173 {
8174 // negative index: index from the last byte
8175 startidx = blob_len(b) + startidx;
8176 if (startidx < 0)
8177 startidx = 0;
8178 }
8179
8180 set_vim_var_type(VV_KEY, VAR_NUMBER);
8181 set_vim_var_type(VV_VAL, VAR_NUMBER);
8182
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008183 int called_emsg_start = called_emsg;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008184 for (idx = startidx; idx < blob_len(b); ++idx)
8185 {
8186 set_vim_var_nr(VV_KEY, idx);
8187 set_vim_var_nr(VV_VAL, blob_get(b, idx));
8188
8189 if (indexof_eval_expr(expr))
8190 return idx;
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008191
8192 if (called_emsg != called_emsg_start)
8193 return -1;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008194 }
8195
8196 return -1;
8197}
8198
8199/*
8200 * Evaluate 'expr' for each item in the List 'l' starting with the item at
8201 * 'startidx' and return the index of the item where 'expr' is TRUE. Returns
8202 * -1 if 'expr' doesn't evaluate to TRUE for any of the items.
8203 */
8204 static int
8205indexof_list(list_T *l, long startidx, typval_T *expr)
8206{
8207 listitem_T *item;
8208 long idx = 0;
Yegappan Lakshmanan63acae12022-08-14 12:07:11 +01008209 int found;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008210
8211 if (l == NULL)
8212 return -1;
8213
8214 CHECK_LIST_MATERIALIZE(l);
8215
8216 if (startidx == 0)
8217 item = l->lv_first;
8218 else
8219 {
8220 // Start at specified item. Use the cached index that list_find()
8221 // sets, so that a negative number also works.
8222 item = list_find(l, startidx);
8223 if (item != NULL)
8224 idx = l->lv_u.mat.lv_idx;
8225 }
8226
8227 set_vim_var_type(VV_KEY, VAR_NUMBER);
8228
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008229 int called_emsg_start = called_emsg;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008230 for ( ; item != NULL; item = item->li_next, ++idx)
8231 {
8232 set_vim_var_nr(VV_KEY, idx);
8233 copy_tv(&item->li_tv, get_vim_var_tv(VV_VAL));
8234
Yegappan Lakshmanan63acae12022-08-14 12:07:11 +01008235 found = indexof_eval_expr(expr);
8236 clear_tv(get_vim_var_tv(VV_VAL));
8237
8238 if (found)
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008239 return idx;
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008240
8241 if (called_emsg != called_emsg_start)
8242 return -1;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008243 }
8244
8245 return -1;
8246}
8247
8248/*
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008249 * "indexof()" function
8250 */
8251 static void
8252f_indexof(typval_T *argvars, typval_T *rettv)
8253{
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008254 long startidx = 0;
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008255 typval_T save_val;
8256 typval_T save_key;
8257 int save_did_emsg;
8258
8259 rettv->vval.v_number = -1;
8260
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008261 if (check_for_list_or_tuple_or_blob_arg(argvars, 0) == FAIL
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008262 || check_for_string_or_func_arg(argvars, 1) == FAIL
8263 || check_for_opt_dict_arg(argvars, 2) == FAIL)
8264 return;
8265
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008266 if ((argvars[1].v_type == VAR_STRING &&
8267 (argvars[1].vval.v_string == NULL
8268 || *argvars[1].vval.v_string == NUL))
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008269 || (argvars[1].v_type == VAR_FUNC
8270 && argvars[1].vval.v_partial == NULL))
8271 return;
8272
8273 if (argvars[2].v_type == VAR_DICT)
8274 startidx = dict_get_number_def(argvars[2].vval.v_dict, "startidx", 0);
8275
8276 prepare_vimvar(VV_VAL, &save_val);
8277 prepare_vimvar(VV_KEY, &save_key);
8278
8279 // We reset "did_emsg" to be able to detect whether an error occurred
8280 // during evaluation of the expression.
8281 save_did_emsg = did_emsg;
8282 did_emsg = FALSE;
8283
8284 if (argvars[0].v_type == VAR_BLOB)
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008285 rettv->vval.v_number = indexof_blob(argvars[0].vval.v_blob, startidx,
8286 &argvars[1]);
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008287 else if (argvars[0].v_type == VAR_TUPLE)
8288 rettv->vval.v_number = indexof_tuple(argvars[0].vval.v_tuple, startidx,
8289 &argvars[1]);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008290 else
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008291 rettv->vval.v_number = indexof_list(argvars[0].vval.v_list, startidx,
8292 &argvars[1]);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008293
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008294 restore_vimvar(VV_KEY, &save_key);
8295 restore_vimvar(VV_VAL, &save_val);
8296 did_emsg |= save_did_emsg;
8297}
8298
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008299static int inputsecret_flag = 0;
8300
8301/*
8302 * "input()" function
8303 * Also handles inputsecret() when inputsecret is set.
8304 */
8305 static void
8306f_input(typval_T *argvars, typval_T *rettv)
8307{
8308 get_user_input(argvars, rettv, FALSE, inputsecret_flag);
8309}
8310
8311/*
8312 * "inputdialog()" function
8313 */
8314 static void
8315f_inputdialog(typval_T *argvars, typval_T *rettv)
8316{
8317#if defined(FEAT_GUI_TEXTDIALOG)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008318 // Use a GUI dialog if the GUI is running and 'c' is not in 'guioptions'
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008319 if (gui.in_use && vim_strchr(p_go, GO_CONDIALOG) == NULL)
8320 {
8321 char_u *message;
8322 char_u buf[NUMBUFLEN];
8323 char_u *defstr = (char_u *)"";
8324
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008325 if (in_vim9script()
8326 && (check_for_string_arg(argvars, 0) == FAIL
8327 || check_for_opt_string_arg(argvars, 1) == FAIL
8328 || (argvars[1].v_type != VAR_UNKNOWN
8329 && check_for_opt_string_arg(argvars, 2) == FAIL)))
8330 return;
8331
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008332 message = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008333 if (argvars[1].v_type != VAR_UNKNOWN
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008334 && (defstr = tv_get_string_buf_chk(&argvars[1], buf)) != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008335 vim_strncpy(IObuff, defstr, IOSIZE - 1);
8336 else
8337 IObuff[0] = NUL;
8338 if (message != NULL && defstr != NULL
8339 && do_dialog(VIM_QUESTION, NULL, message,
8340 (char_u *)_("&OK\n&Cancel"), 1, IObuff, FALSE) == 1)
8341 rettv->vval.v_string = vim_strsave(IObuff);
8342 else
8343 {
8344 if (message != NULL && defstr != NULL
8345 && argvars[1].v_type != VAR_UNKNOWN
8346 && argvars[2].v_type != VAR_UNKNOWN)
8347 rettv->vval.v_string = vim_strsave(
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008348 tv_get_string_buf(&argvars[2], buf));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008349 else
8350 rettv->vval.v_string = NULL;
8351 }
8352 rettv->v_type = VAR_STRING;
8353 }
8354 else
8355#endif
8356 get_user_input(argvars, rettv, TRUE, inputsecret_flag);
8357}
8358
8359/*
8360 * "inputlist()" function
8361 */
8362 static void
8363f_inputlist(typval_T *argvars, typval_T *rettv)
8364{
Bram Moolenaar50985eb2020-01-27 22:09:39 +01008365 list_T *l;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008366 listitem_T *li;
8367 int selected;
8368 int mouse_used;
8369
8370#ifdef NO_CONSOLE_INPUT
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008371 // While starting up, there is no place to enter text. When running tests
8372 // with --not-a-term we assume feedkeys() will be used.
Bram Moolenaar91d348a2017-07-29 20:16:03 +02008373 if (no_console_input() && !is_not_a_term())
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008374 return;
8375#endif
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008376 if (in_vim9script() && check_for_list_arg(argvars, 0) == FAIL)
8377 return;
8378
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008379 if (argvars[0].v_type != VAR_LIST || argvars[0].vval.v_list == NULL)
8380 {
Bram Moolenaar3a846e62022-01-01 16:21:00 +00008381 semsg(_(e_argument_of_str_must_be_list), "inputlist()");
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008382 return;
8383 }
8384
8385 msg_start();
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008386 msg_row = Rows - 1; // for when 'cmdheight' > 1
8387 lines_left = Rows; // avoid more prompt
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008388 msg_scroll = TRUE;
8389 msg_clr_eos();
8390
Bram Moolenaar50985eb2020-01-27 22:09:39 +01008391 l = argvars[0].vval.v_list;
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02008392 CHECK_LIST_MATERIALIZE(l);
Bram Moolenaar00d253e2020-04-06 22:13:01 +02008393 FOR_ALL_LIST_ITEMS(l, li)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008394 {
Bram Moolenaar32526b32019-01-19 17:43:09 +01008395 msg_puts((char *)tv_get_string(&li->li_tv));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008396 msg_putchar('\n');
8397 }
8398
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008399 // Ask for choice.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008400 selected = prompt_for_number(&mouse_used);
8401 if (mouse_used)
8402 selected -= lines_left;
8403
8404 rettv->vval.v_number = selected;
8405}
8406
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008407static garray_T ga_userinput = {0, 0, sizeof(tasave_T), 4, NULL};
8408
8409/*
8410 * "inputrestore()" function
8411 */
8412 static void
8413f_inputrestore(typval_T *argvars UNUSED, typval_T *rettv)
8414{
8415 if (ga_userinput.ga_len > 0)
8416 {
8417 --ga_userinput.ga_len;
8418 restore_typeahead((tasave_T *)(ga_userinput.ga_data)
Bram Moolenaarc41badb2021-06-07 22:04:52 +02008419 + ga_userinput.ga_len, TRUE);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008420 // default return is zero == OK
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008421 }
8422 else if (p_verbose > 1)
8423 {
Bram Moolenaar32526b32019-01-19 17:43:09 +01008424 verb_msg(_("called inputrestore() more often than inputsave()"));
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008425 rettv->vval.v_number = 1; // Failed
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008426 }
8427}
8428
8429/*
8430 * "inputsave()" function
8431 */
8432 static void
8433f_inputsave(typval_T *argvars UNUSED, typval_T *rettv)
8434{
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008435 // Add an entry to the stack of typeahead storage.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008436 if (ga_grow(&ga_userinput, 1) == OK)
8437 {
8438 save_typeahead((tasave_T *)(ga_userinput.ga_data)
8439 + ga_userinput.ga_len);
8440 ++ga_userinput.ga_len;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008441 // default return is zero == OK
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008442 }
8443 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008444 rettv->vval.v_number = 1; // Failed
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008445}
8446
8447/*
8448 * "inputsecret()" function
8449 */
8450 static void
8451f_inputsecret(typval_T *argvars, typval_T *rettv)
8452{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008453 if (in_vim9script()
8454 && (check_for_string_arg(argvars, 0) == FAIL
8455 || check_for_opt_string_arg(argvars, 1) == FAIL))
8456 return;
8457
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008458 ++cmdline_star;
8459 ++inputsecret_flag;
8460 f_input(argvars, rettv);
8461 --cmdline_star;
8462 --inputsecret_flag;
8463}
8464
8465/*
Bram Moolenaar67a2deb2019-11-25 00:05:32 +01008466 * "interrupt()" function
8467 */
8468 static void
8469f_interrupt(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
8470{
8471 got_int = TRUE;
8472}
8473
8474/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008475 * "invert(expr)" function
8476 */
8477 static void
8478f_invert(typval_T *argvars, typval_T *rettv)
8479{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008480 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
8481 return;
8482
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008483 rettv->vval.v_number = ~tv_get_number_chk(&argvars[0], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008484}
8485
8486/*
Ernie Rael4c8da022023-10-11 21:35:11 +02008487 * Free resources in lval_root allocated by fill_exec_lval_root().
8488 */
8489 static void
8490free_lval_root(lval_root_T *root)
8491{
8492 if (root->lr_tv != NULL)
8493 free_tv(root->lr_tv);
8494 class_unref(root->lr_cl_exec);
8495 root->lr_tv = NULL;
8496 root->lr_cl_exec = NULL;
8497}
8498
8499/*
8500 * This is used if executing in a method, the argument string is a
Ernie Rael0f058d12023-10-14 11:25:04 +02008501 * variable/item expr/reference. It may start with a potential class/object
8502 * variable.
Ernie Rael4c8da022023-10-11 21:35:11 +02008503 *
Ernie Rael0f058d12023-10-14 11:25:04 +02008504 * Adjust "root" as needed; lr_tv may be changed or freed.
Ernie Rael4c8da022023-10-11 21:35:11 +02008505 *
8506 * Always returns OK.
8507 * Free resources and return FAIL if the root should not be used. Otherwise OK.
8508 */
8509
8510 static int
Ernie Rael0f058d12023-10-14 11:25:04 +02008511fix_variable_reference_lval_root(lval_root_T *root, char_u *name)
Ernie Rael4c8da022023-10-11 21:35:11 +02008512{
Ernie Rael4c8da022023-10-11 21:35:11 +02008513
Ernie Rael0f058d12023-10-14 11:25:04 +02008514 // Check if lr_tv is the name of an object/class reference: name start with
8515 // "this" or name is class variable. Clear lr_tv if neither.
8516 int found_member = FALSE;
Ernie Rael4c8da022023-10-11 21:35:11 +02008517 if (root->lr_tv->v_type == VAR_OBJECT)
8518 {
Ernie Rael0f058d12023-10-14 11:25:04 +02008519 if (STRNCMP("this.", name, 5) == 0 ||STRCMP("this", name) == 0)
8520 found_member = TRUE;
Ernie Rael4c8da022023-10-11 21:35:11 +02008521 }
Ernie Rael0f058d12023-10-14 11:25:04 +02008522 if (!found_member) // not object member, try class member
Ernie Rael4c8da022023-10-11 21:35:11 +02008523 {
8524 // Explicitly check if the name is a class member.
8525 // If it's not then do nothing.
Ernie Rael0f058d12023-10-14 11:25:04 +02008526 char_u *end;
Ernie Rael4c8da022023-10-11 21:35:11 +02008527 for (end = name; ASCII_ISALNUM(*end) || *end == '_'; ++end)
8528 ;
Ernie Rael0f058d12023-10-14 11:25:04 +02008529 int idx = class_member_idx(root->lr_cl_exec, name, end - name);
8530 if (idx >= 0)
Ernie Rael4c8da022023-10-11 21:35:11 +02008531 {
Ernie Rael0f058d12023-10-14 11:25:04 +02008532 // A class variable, replace lr_tv with it
8533 clear_tv(root->lr_tv);
8534 copy_tv(&root->lr_cl_exec->class_members_tv[idx], root->lr_tv);
8535 found_member = TRUE;
Ernie Rael4c8da022023-10-11 21:35:11 +02008536 }
8537 }
Ernie Rael0f058d12023-10-14 11:25:04 +02008538 if (!found_member)
Ernie Rael4c8da022023-10-11 21:35:11 +02008539 {
8540 free_tv(root->lr_tv);
8541 root->lr_tv = NULL; // Not a member variable
8542 }
Ernie Rael4c8da022023-10-11 21:35:11 +02008543 // If FAIL, then must free_lval_root(root);
8544 return OK;
8545}
8546
8547/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008548 * "islocked()" function
8549 */
8550 static void
8551f_islocked(typval_T *argvars, typval_T *rettv)
8552{
8553 lval_T lv;
8554 char_u *end;
8555 dictitem_T *di;
8556
8557 rettv->vval.v_number = -1;
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02008558
8559 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
8560 return;
8561
Ernie Rael4c8da022023-10-11 21:35:11 +02008562 char_u *name = tv_get_string(&argvars[0]);
8563#ifdef LOG_LOCKVAR
8564 ch_log(NULL, "LKVAR: f_islocked(): name: %s", name);
8565#endif
8566
8567 lval_root_T aroot; // fully initialized in fill_exec_lval_root
8568 lval_root_T *root = NULL;
8569
8570 // Set up lval_root if executing in a method.
8571 if (fill_exec_lval_root(&aroot) == OK)
8572 {
8573 // Almost always produces a valid lval_root since lr_cl_exec is used
8574 // for access verification, lr_tv may be set to NULL.
Ernie Rael0f058d12023-10-14 11:25:04 +02008575 if (fix_variable_reference_lval_root(&aroot, name) == OK)
Ernie Rael4c8da022023-10-11 21:35:11 +02008576 root = &aroot;
Ernie Rael4c8da022023-10-11 21:35:11 +02008577 }
8578
8579 lval_root_T *lval_root_save = lval_root;
8580 lval_root = root;
8581 end = get_lval(name, NULL, &lv, FALSE, FALSE,
Bram Moolenaarbd77aa92021-08-12 17:06:05 +02008582 GLV_NO_AUTOLOAD | GLV_READ_ONLY | GLV_NO_DECL,
8583 FNE_CHECK_START);
Ernie Rael4c8da022023-10-11 21:35:11 +02008584 lval_root = lval_root_save;
8585
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008586 if (end != NULL && lv.ll_name != NULL)
8587 {
8588 if (*end != NUL)
Bram Moolenaar1840a7b2021-07-13 20:32:29 +02008589 {
8590 semsg(_(lv.ll_name == lv.ll_name_end
Bram Moolenaar0bd663a2022-01-22 10:24:47 +00008591 ? e_invalid_argument_str : e_trailing_characters_str), end);
Bram Moolenaar1840a7b2021-07-13 20:32:29 +02008592 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008593 else
8594 {
8595 if (lv.ll_tv == NULL)
8596 {
Bram Moolenaar79518e22017-02-17 16:31:35 +01008597 di = find_var(lv.ll_name, NULL, TRUE);
8598 if (di != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008599 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008600 // Consider a variable locked when:
8601 // 1. the variable itself is locked
8602 // 2. the value of the variable is locked.
8603 // 3. the List or Dict value is locked.
Bram Moolenaar79518e22017-02-17 16:31:35 +01008604 rettv->vval.v_number = ((di->di_flags & DI_FLAGS_LOCK)
8605 || tv_islocked(&di->di_tv));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008606 }
8607 }
Ernie Rael4c8da022023-10-11 21:35:11 +02008608 else if (lv.ll_is_root)
8609 {
8610 rettv->vval.v_number = tv_islocked(lv.ll_tv);
8611 }
Ernie Rael9771b2a2023-10-07 22:05:40 +02008612 else if (lv.ll_object != NULL)
8613 {
8614 typval_T *tv = ((typval_T *)(lv.ll_object + 1)) + lv.ll_oi;
8615 rettv->vval.v_number = tv_islocked(tv);
8616#ifdef LOG_LOCKVAR
8617 ch_log(NULL, "LKVAR: f_islocked(): name %s (obj)", lv.ll_name);
8618#endif
8619 }
8620 else if (lv.ll_class != NULL)
8621 {
8622 typval_T *tv = &lv.ll_class->class_members_tv[lv.ll_oi];
8623 rettv->vval.v_number = tv_islocked(tv);
8624#ifdef LOG_LOCKVAR
8625 ch_log(NULL, "LKVAR: f_islocked(): name %s (cl)", lv.ll_name);
8626#endif
8627 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008628 else if (lv.ll_range)
Bram Moolenaar677658a2022-01-05 16:09:06 +00008629 emsg(_(e_range_not_allowed));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008630 else if (lv.ll_newkey != NULL)
Bram Moolenaara9fa8c52023-01-02 18:10:04 +00008631 semsg(_(e_key_not_present_in_dictionary_str), lv.ll_newkey);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008632 else if (lv.ll_list != NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008633 // List item.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008634 rettv->vval.v_number = tv_islocked(&lv.ll_li->li_tv);
Yegappan Lakshmanan038be272025-03-26 18:46:21 +01008635 else if (lv.ll_tuple != NULL)
8636 // Tuple item.
8637 rettv->vval.v_number = tv_islocked(lv.ll_tv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008638 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008639 // Dictionary item.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008640 rettv->vval.v_number = tv_islocked(&lv.ll_di->di_tv);
8641 }
8642 }
8643
Ernie Rael4c8da022023-10-11 21:35:11 +02008644 if (root != NULL)
8645 free_lval_root(root);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008646 clear_lval(&lv);
8647}
8648
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008649/*
zeertzjqcdc83932022-09-12 13:38:41 +01008650 * "keytrans()" function
8651 */
8652 static void
8653f_keytrans(typval_T *argvars, typval_T *rettv)
8654{
8655 char_u *escaped;
8656
8657 rettv->v_type = VAR_STRING;
8658 if (check_for_string_arg(argvars, 0) == FAIL
8659 || argvars[0].vval.v_string == NULL)
8660 return;
8661 // Need to escape K_SPECIAL and CSI for mb_unescape().
8662 escaped = vim_strsave_escape_csi(argvars[0].vval.v_string);
8663 rettv->vval.v_string = str2special_save(escaped, TRUE, TRUE);
8664 vim_free(escaped);
8665}
8666
8667/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008668 * "last_buffer_nr()" function.
8669 */
8670 static void
8671f_last_buffer_nr(typval_T *argvars UNUSED, typval_T *rettv)
8672{
8673 int n = 0;
8674 buf_T *buf;
8675
Bram Moolenaar29323592016-07-24 22:04:11 +02008676 FOR_ALL_BUFFERS(buf)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008677 if (n < buf->b_fnum)
8678 n = buf->b_fnum;
8679
8680 rettv->vval.v_number = n;
8681}
8682
8683/*
8684 * "len()" function
8685 */
LemonBoy58f331a2022-04-02 21:59:06 +01008686 void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008687f_len(typval_T *argvars, typval_T *rettv)
8688{
8689 switch (argvars[0].v_type)
8690 {
8691 case VAR_STRING:
8692 case VAR_NUMBER:
8693 rettv->vval.v_number = (varnumber_T)STRLEN(
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008694 tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008695 break;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008696 case VAR_BLOB:
8697 rettv->vval.v_number = blob_len(argvars[0].vval.v_blob);
8698 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008699 case VAR_LIST:
8700 rettv->vval.v_number = list_len(argvars[0].vval.v_list);
8701 break;
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008702 case VAR_TUPLE:
8703 rettv->vval.v_number = tuple_len(argvars[0].vval.v_tuple);
8704 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008705 case VAR_DICT:
8706 rettv->vval.v_number = dict_len(argvars[0].vval.v_dict);
8707 break;
Yegappan Lakshmanand3eae7b2024-03-03 16:26:58 +01008708 case VAR_OBJECT:
8709 rettv->vval.v_number = object_len(argvars[0].vval.v_object);
8710 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008711 case VAR_UNKNOWN:
Bram Moolenaar4c683752020-04-05 21:38:23 +02008712 case VAR_ANY:
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01008713 case VAR_VOID:
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01008714 case VAR_BOOL:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008715 case VAR_SPECIAL:
8716 case VAR_FLOAT:
8717 case VAR_FUNC:
8718 case VAR_PARTIAL:
8719 case VAR_JOB:
8720 case VAR_CHANNEL:
Bram Moolenaarf18332f2021-05-07 17:55:55 +02008721 case VAR_INSTR:
Bram Moolenaar00b28d62022-12-08 15:32:33 +00008722 case VAR_CLASS:
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +02008723 case VAR_TYPEALIAS:
Bram Moolenaara6f79292022-01-04 21:30:47 +00008724 emsg(_(e_invalid_type_for_len));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008725 break;
8726 }
8727}
8728
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008729 static void
Bram Moolenaar6d721c72017-01-17 16:56:28 +01008730libcall_common(typval_T *argvars UNUSED, typval_T *rettv, int type)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008731{
8732#ifdef FEAT_LIBCALL
8733 char_u *string_in;
8734 char_u **string_result;
8735 int nr_result;
8736#endif
8737
8738 rettv->v_type = type;
8739 if (type != VAR_NUMBER)
8740 rettv->vval.v_string = NULL;
8741
8742 if (check_restricted() || check_secure())
8743 return;
8744
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02008745 if (in_vim9script()
8746 && (check_for_string_arg(argvars, 0) == FAIL
8747 || check_for_string_arg(argvars, 1) == FAIL
8748 || check_for_string_or_number_arg(argvars, 2) == FAIL))
8749 return;
8750
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008751#ifdef FEAT_LIBCALL
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008752 // The first two args must be strings, otherwise it's meaningless
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008753 if (argvars[0].v_type == VAR_STRING && argvars[1].v_type == VAR_STRING)
8754 {
8755 string_in = NULL;
8756 if (argvars[2].v_type == VAR_STRING)
8757 string_in = argvars[2].vval.v_string;
8758 if (type == VAR_NUMBER)
Bram Moolenaar87e15872021-09-02 19:53:07 +02008759 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008760 string_result = NULL;
Bram Moolenaar87e15872021-09-02 19:53:07 +02008761 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008762 else
Bram Moolenaar87e15872021-09-02 19:53:07 +02008763 {
8764 rettv->vval.v_string = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008765 string_result = &rettv->vval.v_string;
Bram Moolenaar87e15872021-09-02 19:53:07 +02008766 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008767 if (mch_libcall(argvars[0].vval.v_string,
8768 argvars[1].vval.v_string,
8769 string_in,
8770 argvars[2].vval.v_number,
8771 string_result,
8772 &nr_result) == OK
8773 && type == VAR_NUMBER)
8774 rettv->vval.v_number = nr_result;
8775 }
8776#endif
8777}
8778
8779/*
8780 * "libcall()" function
8781 */
8782 static void
8783f_libcall(typval_T *argvars, typval_T *rettv)
8784{
8785 libcall_common(argvars, rettv, VAR_STRING);
8786}
8787
8788/*
8789 * "libcallnr()" function
8790 */
8791 static void
8792f_libcallnr(typval_T *argvars, typval_T *rettv)
8793{
8794 libcall_common(argvars, rettv, VAR_NUMBER);
8795}
8796
8797/*
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008798 * "line(string, [winid])" function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008799 */
8800 static void
8801f_line(typval_T *argvars, typval_T *rettv)
8802{
8803 linenr_T lnum = 0;
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008804 pos_T *fp = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008805 int fnum;
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008806 int id;
8807 tabpage_T *tp;
8808 win_T *wp;
Bram Moolenaar18f47402022-01-06 13:24:51 +00008809 switchwin_T switchwin;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008810
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02008811 if (in_vim9script()
8812 && (check_for_string_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008813 || check_for_opt_number_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02008814 return;
8815
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008816 if (argvars[1].v_type != VAR_UNKNOWN)
8817 {
8818 // use window specified in the second argument
8819 id = (int)tv_get_number(&argvars[1]);
8820 wp = win_id2wp_tp(id, &tp);
8821 if (wp != NULL && tp != NULL)
8822 {
Bram Moolenaar18f47402022-01-06 13:24:51 +00008823 if (switch_win_noblock(&switchwin, wp, tp, TRUE) == OK)
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008824 {
John Marriott69f85c62024-10-31 10:53:43 +01008825#ifdef FEAT_DIFF
Christian Brabandt05a40e02024-10-29 20:29:04 +01008826 // in diff mode, prevent that the window scrolls
8827 // and keep the topline
8828 if (curwin->w_p_diff && switchwin.sw_curwin->w_p_diff)
8829 skip_update_topline = TRUE;
John Marriott69f85c62024-10-31 10:53:43 +01008830#endif
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008831 check_cursor();
Bram Moolenaar6f02b002021-01-10 20:22:54 +01008832 fp = var2fpos(&argvars[0], TRUE, &fnum, FALSE);
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008833 }
John Marriott69f85c62024-10-31 10:53:43 +01008834#ifdef FEAT_DIFF
Christian Brabandt05a40e02024-10-29 20:29:04 +01008835 if (curwin->w_p_diff && switchwin.sw_curwin->w_p_diff)
8836 skip_update_topline = FALSE;
John Marriott69f85c62024-10-31 10:53:43 +01008837#endif
Bram Moolenaar18f47402022-01-06 13:24:51 +00008838 restore_win_noblock(&switchwin, TRUE);
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008839 }
8840 }
8841 else
8842 // use current window
Bram Moolenaar6f02b002021-01-10 20:22:54 +01008843 fp = var2fpos(&argvars[0], TRUE, &fnum, FALSE);
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008844
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008845 if (fp != NULL)
8846 lnum = fp->lnum;
8847 rettv->vval.v_number = lnum;
8848}
8849
8850/*
8851 * "line2byte(lnum)" function
8852 */
8853 static void
8854f_line2byte(typval_T *argvars UNUSED, typval_T *rettv)
8855{
8856#ifndef FEAT_BYTEOFF
8857 rettv->vval.v_number = -1;
8858#else
8859 linenr_T lnum;
8860
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008861 if (in_vim9script() && check_for_lnum_arg(argvars, 0) == FAIL)
8862 return;
8863
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008864 lnum = tv_get_lnum(argvars);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008865 if (lnum < 1 || lnum > curbuf->b_ml.ml_line_count + 1)
8866 rettv->vval.v_number = -1;
8867 else
8868 rettv->vval.v_number = ml_find_line_or_offset(curbuf, lnum, NULL);
8869 if (rettv->vval.v_number >= 0)
8870 ++rettv->vval.v_number;
8871#endif
8872}
8873
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008874#ifdef FEAT_LUA
8875/*
8876 * "luaeval()" function
8877 */
8878 static void
8879f_luaeval(typval_T *argvars, typval_T *rettv)
8880{
8881 char_u *str;
8882 char_u buf[NUMBUFLEN];
8883
Bram Moolenaar8c62a082019-02-08 14:34:10 +01008884 if (check_restricted() || check_secure())
8885 return;
8886
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02008887 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
8888 return;
8889
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008890 str = tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008891 do_luaeval(str, argvars + 1, rettv);
8892}
8893#endif
8894
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008895typedef enum
8896{
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008897 MATCH_END, // matchend()
8898 MATCH_MATCH, // match()
8899 MATCH_STR, // matchstr()
8900 MATCH_LIST, // matchlist()
8901 MATCH_POS // matchstrpos()
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008902} matchtype_T;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008903
8904 static void
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008905find_some_match(typval_T *argvars, typval_T *rettv, matchtype_T type)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008906{
8907 char_u *str = NULL;
8908 long len = 0;
8909 char_u *expr = NULL;
8910 char_u *pat;
8911 regmatch_T regmatch;
8912 char_u patbuf[NUMBUFLEN];
8913 char_u strbuf[NUMBUFLEN];
8914 char_u *save_cpo;
8915 long start = 0;
8916 long nth = 1;
8917 colnr_T startcol = 0;
8918 int match = 0;
8919 list_T *l = NULL;
8920 listitem_T *li = NULL;
8921 long idx = 0;
8922 char_u *tofree = NULL;
8923
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008924 // Make 'cpoptions' empty, the 'l' flag should not be used here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008925 save_cpo = p_cpo;
Bram Moolenaare5a2dc82021-01-03 19:52:05 +01008926 p_cpo = empty_option;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008927
8928 rettv->vval.v_number = -1;
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008929 if (type == MATCH_LIST || type == MATCH_POS)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008930 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008931 // type MATCH_LIST: return empty list when there are no matches.
8932 // type MATCH_POS: return ["", -1, -1, -1]
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008933 if (rettv_list_alloc(rettv) == FAIL)
8934 goto theend;
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008935 if (type == MATCH_POS
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008936 && (list_append_string(rettv->vval.v_list,
8937 (char_u *)"", 0) == FAIL
8938 || list_append_number(rettv->vval.v_list,
8939 (varnumber_T)-1) == 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 {
8945 list_free(rettv->vval.v_list);
8946 rettv->vval.v_list = NULL;
8947 goto theend;
8948 }
8949 }
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008950 else if (type == MATCH_STR)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008951 {
8952 rettv->v_type = VAR_STRING;
8953 rettv->vval.v_string = NULL;
8954 }
8955
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02008956 if (in_vim9script()
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008957 && (check_for_string_or_list_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008958 || check_for_string_arg(argvars, 1) == FAIL
8959 || check_for_opt_number_arg(argvars, 2) == FAIL
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02008960 || (argvars[2].v_type != VAR_UNKNOWN
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008961 && check_for_opt_number_arg(argvars, 3) == FAIL)))
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02008962 goto theend;
8963
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008964 if (argvars[0].v_type == VAR_LIST)
8965 {
8966 if ((l = argvars[0].vval.v_list) == NULL)
8967 goto theend;
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02008968 CHECK_LIST_MATERIALIZE(l);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008969 li = l->lv_first;
8970 }
8971 else
8972 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008973 expr = str = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008974 len = (long)STRLEN(str);
8975 }
8976
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008977 pat = tv_get_string_buf_chk(&argvars[1], patbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008978 if (pat == NULL)
8979 goto theend;
8980
8981 if (argvars[2].v_type != VAR_UNKNOWN)
8982 {
8983 int error = FALSE;
8984
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008985 start = (long)tv_get_number_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008986 if (error)
8987 goto theend;
8988 if (l != NULL)
8989 {
8990 li = list_find(l, start);
8991 if (li == NULL)
8992 goto theend;
Bram Moolenaar0ff6aad2020-01-29 21:27:21 +01008993 idx = l->lv_u.mat.lv_idx; // use the cached index
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008994 }
8995 else
8996 {
8997 if (start < 0)
8998 start = 0;
8999 if (start > len)
9000 goto theend;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009001 // When "count" argument is there ignore matches before "start",
9002 // otherwise skip part of the string. Differs when pattern is "^"
9003 // or "\<".
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009004 if (argvars[3].v_type != VAR_UNKNOWN)
9005 startcol = start;
9006 else
9007 {
9008 str += start;
9009 len -= start;
9010 }
9011 }
9012
9013 if (argvars[3].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009014 nth = (long)tv_get_number_chk(&argvars[3], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009015 if (error)
9016 goto theend;
9017 }
9018
9019 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
9020 if (regmatch.regprog != NULL)
9021 {
9022 regmatch.rm_ic = p_ic;
9023
9024 for (;;)
9025 {
9026 if (l != NULL)
9027 {
9028 if (li == NULL)
9029 {
9030 match = FALSE;
9031 break;
9032 }
9033 vim_free(tofree);
9034 expr = str = echo_string(&li->li_tv, &tofree, strbuf, 0);
9035 if (str == NULL)
9036 break;
9037 }
9038
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +00009039 match = vim_regexec_nl(&regmatch, str, startcol);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009040
9041 if (match && --nth <= 0)
9042 break;
9043 if (l == NULL && !match)
9044 break;
9045
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009046 // Advance to just after the match.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009047 if (l != NULL)
9048 {
9049 li = li->li_next;
9050 ++idx;
9051 }
9052 else
9053 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009054 startcol = (colnr_T)(regmatch.startp[0]
9055 + (*mb_ptr2len)(regmatch.startp[0]) - str);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009056 if (startcol > (colnr_T)len
9057 || str + startcol <= regmatch.startp[0])
9058 {
9059 match = FALSE;
9060 break;
9061 }
9062 }
9063 }
9064
9065 if (match)
9066 {
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009067 if (type == MATCH_POS)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009068 {
9069 listitem_T *li1 = rettv->vval.v_list->lv_first;
9070 listitem_T *li2 = li1->li_next;
9071 listitem_T *li3 = li2->li_next;
9072 listitem_T *li4 = li3->li_next;
9073
9074 vim_free(li1->li_tv.vval.v_string);
9075 li1->li_tv.vval.v_string = vim_strnsave(regmatch.startp[0],
Bram Moolenaardf44a272020-06-07 20:49:05 +02009076 regmatch.endp[0] - regmatch.startp[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009077 li3->li_tv.vval.v_number =
9078 (varnumber_T)(regmatch.startp[0] - expr);
9079 li4->li_tv.vval.v_number =
9080 (varnumber_T)(regmatch.endp[0] - expr);
9081 if (l != NULL)
9082 li2->li_tv.vval.v_number = (varnumber_T)idx;
9083 }
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009084 else if (type == MATCH_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009085 {
9086 int i;
9087
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009088 // return list with matched string and submatches
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009089 for (i = 0; i < NSUBEXP; ++i)
9090 {
9091 if (regmatch.endp[i] == NULL)
9092 {
9093 if (list_append_string(rettv->vval.v_list,
9094 (char_u *)"", 0) == FAIL)
9095 break;
9096 }
9097 else if (list_append_string(rettv->vval.v_list,
9098 regmatch.startp[i],
9099 (int)(regmatch.endp[i] - regmatch.startp[i]))
9100 == FAIL)
9101 break;
9102 }
9103 }
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009104 else if (type == MATCH_STR)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009105 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009106 // return matched string
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009107 if (l != NULL)
9108 copy_tv(&li->li_tv, rettv);
9109 else
9110 rettv->vval.v_string = vim_strnsave(regmatch.startp[0],
Bram Moolenaardf44a272020-06-07 20:49:05 +02009111 regmatch.endp[0] - regmatch.startp[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009112 }
9113 else if (l != NULL)
9114 rettv->vval.v_number = idx;
9115 else
9116 {
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009117 if (type != MATCH_END)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009118 rettv->vval.v_number =
9119 (varnumber_T)(regmatch.startp[0] - str);
9120 else
9121 rettv->vval.v_number =
9122 (varnumber_T)(regmatch.endp[0] - str);
9123 rettv->vval.v_number += (varnumber_T)(str - expr);
9124 }
9125 }
9126 vim_regfree(regmatch.regprog);
9127 }
9128
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009129theend:
9130 if (type == MATCH_POS && l == NULL && rettv->vval.v_list != NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009131 // matchstrpos() without a list: drop the second item.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009132 listitem_remove(rettv->vval.v_list,
9133 rettv->vval.v_list->lv_first->li_next);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009134 vim_free(tofree);
9135 p_cpo = save_cpo;
9136}
9137
9138/*
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01009139 * Return all the matches in string "str" for pattern "rmp".
9140 * The matches are returned in the List "mlist".
9141 * If "submatches" is TRUE, then submatch information is also returned.
9142 * "matchbuf" is TRUE when called for matchbufline().
9143 */
9144 static int
9145get_matches_in_str(
9146 char_u *str,
9147 regmatch_T *rmp,
9148 list_T *mlist,
9149 int idx,
9150 int submatches,
9151 int matchbuf)
9152{
9153 long len = (long)STRLEN(str);
9154 int match = 0;
9155 colnr_T startidx = 0;
9156
9157 for (;;)
9158 {
9159 match = vim_regexec_nl(rmp, str, startidx);
9160 if (!match)
9161 break;
9162
9163 dict_T *d = dict_alloc();
9164 if (d == NULL)
9165 return FAIL;
9166 if (list_append_dict(mlist, d) == FAIL)
Satoru Kitaguchiba737662025-04-06 16:04:59 +02009167 return FAIL;
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01009168
9169 if (dict_add_number(d, matchbuf ? "lnum" : "idx", idx) == FAIL)
9170 return FAIL;
9171
9172 if (dict_add_number(d, "byteidx",
9173 (colnr_T)(rmp->startp[0] - str)) == FAIL)
9174 return FAIL;
9175
9176 if (dict_add_string_len(d, "text", rmp->startp[0],
9177 (int)(rmp->endp[0] - rmp->startp[0])) == FAIL)
9178 return FAIL;
9179
9180 if (submatches)
9181 {
9182 list_T *sml = list_alloc();
9183 if (sml == NULL)
9184 return FAIL;
9185
9186 if (dict_add_list(d, "submatches", sml) == FAIL)
9187 return FAIL;
9188
9189 // return a list with the submatches
9190 for (int i = 1; i < NSUBEXP; ++i)
9191 {
9192 if (rmp->endp[i] == NULL)
9193 {
9194 if (list_append_string(sml, (char_u *)"", 0) == FAIL)
9195 return FAIL;
9196 }
9197 else if (list_append_string(sml, rmp->startp[i],
9198 (int)(rmp->endp[i] - rmp->startp[i])) == FAIL)
9199 return FAIL;
9200 }
9201 }
9202 startidx = (colnr_T)(rmp->endp[0] - str);
9203 if (startidx >= (colnr_T)len || str + startidx <= rmp->startp[0])
9204 break;
9205 }
9206
9207 return OK;
9208}
9209
9210/*
9211 * "matchbufline()" function
9212 */
9213 static void
9214f_matchbufline(typval_T *argvars, typval_T *rettv)
9215{
9216 list_T *retlist = NULL;
9217 char_u *save_cpo;
9218 char_u patbuf[NUMBUFLEN];
9219 regmatch_T regmatch;
9220
9221 rettv->vval.v_number = -1;
9222 if (rettv_list_alloc(rettv) != OK)
9223 return;
9224 retlist = rettv->vval.v_list;
9225
9226 if (check_for_buffer_arg(argvars, 0) == FAIL
9227 || check_for_string_arg(argvars, 1) == FAIL
9228 || check_for_lnum_arg(argvars, 2) == FAIL
9229 || check_for_lnum_arg(argvars, 3) == FAIL
9230 || check_for_opt_dict_arg(argvars, 4) == FAIL)
9231 return;
9232
9233 int prev_did_emsg = did_emsg;
9234 buf_T *buf = tv_get_buf(&argvars[0], FALSE);
9235 if (buf == NULL)
9236 {
9237 if (did_emsg == prev_did_emsg)
9238 semsg(_(e_invalid_buffer_name_str), tv_get_string(&argvars[0]));
9239 return;
9240 }
9241 if (buf->b_ml.ml_mfp == NULL)
9242 {
9243 emsg(_(e_buffer_is_not_loaded));
9244 return;
9245 }
9246
9247 char_u *pat = tv_get_string_buf(&argvars[1], patbuf);
9248
9249 int did_emsg_before = did_emsg;
9250 linenr_T slnum = tv_get_lnum_buf(&argvars[2], buf);
9251 if (did_emsg > did_emsg_before)
9252 return;
9253 if (slnum < 1)
9254 {
9255 semsg(_(e_invalid_value_for_argument_str), "lnum");
9256 return;
9257 }
9258
9259 linenr_T elnum = tv_get_lnum_buf(&argvars[3], buf);
9260 if (did_emsg > did_emsg_before)
9261 return;
9262 if (elnum < 1 || elnum < slnum)
9263 {
9264 semsg(_(e_invalid_value_for_argument_str), "end_lnum");
9265 return;
9266 }
9267
9268 if (elnum > buf->b_ml.ml_line_count)
9269 elnum = buf->b_ml.ml_line_count;
9270
9271 int submatches = FALSE;
9272 if (argvars[4].v_type != VAR_UNKNOWN)
9273 {
9274 dict_T *d = argvars[4].vval.v_dict;
9275 if (d != NULL)
9276 {
9277 dictitem_T *di = dict_find(d, (char_u *)"submatches", -1);
9278 if (di != NULL)
9279 {
9280 if (di->di_tv.v_type != VAR_BOOL)
9281 {
9282 semsg(_(e_invalid_value_for_argument_str), "submatches");
9283 return;
9284 }
9285 submatches = tv_get_bool(&di->di_tv);
9286 }
9287 }
9288 }
9289
9290 // Make 'cpoptions' empty, the 'l' flag should not be used here.
9291 save_cpo = p_cpo;
9292 p_cpo = empty_option;
9293
9294 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
9295 if (regmatch.regprog == NULL)
9296 goto theend;
9297 regmatch.rm_ic = p_ic;
9298
9299 while (slnum <= elnum)
9300 {
9301 char_u *str = ml_get_buf(buf, slnum, FALSE);
9302 if (get_matches_in_str(str, &regmatch, retlist, slnum, submatches,
9303 TRUE) == FAIL)
9304 goto cleanup;
9305 slnum++;
9306 }
9307
9308cleanup:
9309 vim_regfree(regmatch.regprog);
9310
9311theend:
9312 p_cpo = save_cpo;
9313}
9314
9315/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009316 * "match()" function
9317 */
9318 static void
9319f_match(typval_T *argvars, typval_T *rettv)
9320{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009321 find_some_match(argvars, rettv, MATCH_MATCH);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009322}
9323
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009324/*
9325 * "matchend()" function
9326 */
9327 static void
9328f_matchend(typval_T *argvars, typval_T *rettv)
9329{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009330 find_some_match(argvars, rettv, MATCH_END);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009331}
9332
9333/*
9334 * "matchlist()" function
9335 */
9336 static void
9337f_matchlist(typval_T *argvars, typval_T *rettv)
9338{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009339 find_some_match(argvars, rettv, MATCH_LIST);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009340}
9341
9342/*
9343 * "matchstr()" function
9344 */
9345 static void
9346f_matchstr(typval_T *argvars, typval_T *rettv)
9347{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009348 find_some_match(argvars, rettv, MATCH_STR);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009349}
9350
9351/*
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01009352 * "matchstrlist()" function
9353 */
9354 static void
9355f_matchstrlist(typval_T *argvars, typval_T *rettv)
9356{
9357 list_T *retlist = NULL;
9358 char_u *save_cpo;
9359 list_T *l = NULL;
9360 listitem_T *li = NULL;
9361 char_u patbuf[NUMBUFLEN];
9362 regmatch_T regmatch;
9363
9364 rettv->vval.v_number = -1;
9365 if (rettv_list_alloc(rettv) != OK)
9366 return;
9367 retlist = rettv->vval.v_list;
9368
9369 if (check_for_list_arg(argvars, 0) == FAIL
9370 || check_for_string_arg(argvars, 1) == FAIL
9371 || check_for_opt_dict_arg(argvars, 2) == FAIL)
9372 return;
9373
9374 if ((l = argvars[0].vval.v_list) == NULL)
9375 return;
9376
9377 char_u *pat = tv_get_string_buf_chk(&argvars[1], patbuf);
9378 if (pat == NULL)
9379 return;
9380
9381 // Make 'cpoptions' empty, the 'l' flag should not be used here.
9382 save_cpo = p_cpo;
9383 p_cpo = empty_option;
9384
9385 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
9386 if (regmatch.regprog == NULL)
9387 goto theend;
9388 regmatch.rm_ic = p_ic;
9389
9390 int submatches = FALSE;
9391 if (argvars[2].v_type != VAR_UNKNOWN)
9392 {
9393 dict_T *d = argvars[2].vval.v_dict;
9394 if (d != NULL)
9395 {
9396 dictitem_T *di = dict_find(d, (char_u *)"submatches", -1);
9397 if (di != NULL)
9398 {
9399 if (di->di_tv.v_type != VAR_BOOL)
9400 {
9401 semsg(_(e_invalid_value_for_argument_str), "submatches");
9402 goto cleanup;
9403 }
9404 submatches = tv_get_bool(&di->di_tv);
9405 }
9406 }
9407 }
9408
9409 int idx = 0;
9410 CHECK_LIST_MATERIALIZE(l);
9411 FOR_ALL_LIST_ITEMS(l, li)
9412 {
9413 if (li->li_tv.v_type == VAR_STRING && li->li_tv.vval.v_string != NULL)
9414 {
9415 char_u *str = li->li_tv.vval.v_string;
9416 if (get_matches_in_str(str, &regmatch, retlist, idx, submatches,
9417 FALSE) == FAIL)
9418 goto cleanup;
9419 }
9420 idx++;
9421 }
9422
9423cleanup:
9424 vim_regfree(regmatch.regprog);
9425
9426theend:
9427 p_cpo = save_cpo;
9428}
9429
9430/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009431 * "matchstrpos()" function
9432 */
9433 static void
9434f_matchstrpos(typval_T *argvars, typval_T *rettv)
9435{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009436 find_some_match(argvars, rettv, MATCH_POS);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009437}
9438
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009439 static void
9440max_min(typval_T *argvars, typval_T *rettv, int domax)
9441{
9442 varnumber_T n = 0;
9443 varnumber_T i;
9444 int error = FALSE;
9445
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01009446 if (in_vim9script() &&
9447 check_for_list_or_tuple_or_dict_arg(argvars, 0) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009448 return;
9449
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009450 if (argvars[0].v_type == VAR_LIST)
9451 {
9452 list_T *l;
9453 listitem_T *li;
9454
9455 l = argvars[0].vval.v_list;
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009456 if (l != NULL && l->lv_len > 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009457 {
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009458 if (l->lv_first == &range_list_item)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009459 {
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009460 if ((l->lv_u.nonmat.lv_stride > 0) ^ domax)
9461 n = l->lv_u.nonmat.lv_start;
9462 else
=?UTF-8?q?Dundar=20G=C3=B6c?=d5cec1f2022-01-29 15:19:23 +00009463 n = l->lv_u.nonmat.lv_start + ((varnumber_T)l->lv_len - 1)
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009464 * l->lv_u.nonmat.lv_stride;
9465 }
9466 else
9467 {
9468 li = l->lv_first;
9469 if (li != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009470 {
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009471 n = tv_get_number_chk(&li->li_tv, &error);
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009472 if (error)
9473 return; // type error; errmsg already given
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009474 for (;;)
9475 {
9476 li = li->li_next;
9477 if (li == NULL)
9478 break;
9479 i = tv_get_number_chk(&li->li_tv, &error);
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009480 if (error)
9481 return; // type error; errmsg already given
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009482 if (domax ? i > n : i < n)
9483 n = i;
9484 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009485 }
9486 }
9487 }
9488 }
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01009489 else if (argvars[0].v_type == VAR_TUPLE)
9490 {
9491 n = tuple_max_min(argvars[0].vval.v_tuple, domax, &error);
9492 if (error)
9493 return;
9494 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009495 else if (argvars[0].v_type == VAR_DICT)
9496 {
9497 dict_T *d;
9498 int first = TRUE;
9499 hashitem_T *hi;
9500 int todo;
9501
9502 d = argvars[0].vval.v_dict;
9503 if (d != NULL)
9504 {
9505 todo = (int)d->dv_hashtab.ht_used;
Yegappan Lakshmanan14113fd2023-03-07 17:13:51 +00009506 FOR_ALL_HASHTAB_ITEMS(&d->dv_hashtab, hi, todo)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009507 {
9508 if (!HASHITEM_EMPTY(hi))
9509 {
9510 --todo;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009511 i = tv_get_number_chk(&HI2DI(hi)->di_tv, &error);
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009512 if (error)
9513 return; // type error; errmsg already given
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009514 if (first)
9515 {
9516 n = i;
9517 first = FALSE;
9518 }
9519 else if (domax ? i > n : i < n)
9520 n = i;
9521 }
9522 }
9523 }
9524 }
9525 else
Bram Moolenaar460ae5d2022-01-01 14:19:49 +00009526 semsg(_(e_argument_of_str_must_be_list_or_dictionary), domax ? "max()" : "min()");
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009527
9528 rettv->vval.v_number = n;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009529}
9530
9531/*
9532 * "max()" function
9533 */
9534 static void
9535f_max(typval_T *argvars, typval_T *rettv)
9536{
9537 max_min(argvars, rettv, TRUE);
9538}
9539
9540/*
9541 * "min()" function
9542 */
9543 static void
9544f_min(typval_T *argvars, typval_T *rettv)
9545{
9546 max_min(argvars, rettv, FALSE);
9547}
9548
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009549#if defined(FEAT_MZSCHEME) || defined(PROTO)
9550/*
9551 * "mzeval()" function
9552 */
9553 static void
9554f_mzeval(typval_T *argvars, typval_T *rettv)
9555{
9556 char_u *str;
9557 char_u buf[NUMBUFLEN];
9558
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009559 if (check_restricted() || check_secure())
9560 return;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009561
9562 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
9563 return;
9564
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009565 str = tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009566 do_mzeval(str, rettv);
9567}
9568
9569 void
9570mzscheme_call_vim(char_u *name, typval_T *args, typval_T *rettv)
9571{
9572 typval_T argvars[3];
9573
9574 argvars[0].v_type = VAR_STRING;
9575 argvars[0].vval.v_string = name;
9576 copy_tv(args, &argvars[1]);
9577 argvars[2].v_type = VAR_UNKNOWN;
9578 f_call(argvars, rettv);
9579 clear_tv(&argvars[1]);
9580}
9581#endif
9582
9583/*
9584 * "nextnonblank()" function
9585 */
9586 static void
9587f_nextnonblank(typval_T *argvars, typval_T *rettv)
9588{
9589 linenr_T lnum;
9590
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009591 if (in_vim9script() && check_for_lnum_arg(argvars, 0) == FAIL)
9592 return;
9593
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009594 for (lnum = tv_get_lnum(argvars); ; ++lnum)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009595 {
9596 if (lnum < 0 || lnum > curbuf->b_ml.ml_line_count)
9597 {
9598 lnum = 0;
9599 break;
9600 }
9601 if (*skipwhite(ml_get(lnum)) != NUL)
9602 break;
9603 }
9604 rettv->vval.v_number = lnum;
9605}
9606
Christ van Willegenc0786752025-02-01 15:42:16 +01009607
9608/*
9609 * "ngettext()" function
9610 */
9611 static void
9612f_ngettext(typval_T *argvars, typval_T *rettv)
9613{
9614#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
9615 char *prev = NULL;
9616#endif
9617
9618 if (check_for_nonempty_string_arg(argvars, 0) == FAIL
9619 || check_for_nonempty_string_arg(argvars, 1) == FAIL
9620 || check_for_number_arg(argvars, 2) == FAIL
9621 || check_for_opt_string_arg(argvars, 3) == FAIL)
9622 return;
9623
9624 rettv->v_type = VAR_STRING;
9625
9626 if (argvars[3].v_type == VAR_STRING &&
9627 argvars[3].vval.v_string != NULL &&
9628 *(argvars[3].vval.v_string) != NUL)
9629 {
9630#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
9631 prev = bind_textdomain_codeset((const char *)argvars[3].vval.v_string, (char *)p_enc);
9632#endif
9633
9634#if defined(HAVE_DNGETTEXT)
9635 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));
9636#else
9637 textdomain((const char *)argvars[3].vval.v_string);
9638 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));
9639 textdomain(VIMPACKAGE);
9640#endif
9641
9642#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
9643 if (prev != NULL)
9644 bind_textdomain_codeset((const char *)argvars[3].vval.v_string, prev);
9645#endif
9646 }
9647 else
9648 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));
9649}
9650
9651
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009652/*
9653 * "nr2char()" function
9654 */
9655 static void
9656f_nr2char(typval_T *argvars, typval_T *rettv)
9657{
9658 char_u buf[NUMBUFLEN];
9659
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02009660 if (in_vim9script()
9661 && (check_for_number_arg(argvars, 0) == FAIL
9662 || check_for_opt_bool_arg(argvars, 1) == FAIL))
9663 return;
9664
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009665 if (has_mbyte)
9666 {
9667 int utf8 = 0;
9668
9669 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaared6a4302020-09-05 20:29:41 +02009670 utf8 = (int)tv_get_bool_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009671 if (utf8)
Bram Moolenaarbdace832019-03-02 10:13:42 +01009672 buf[utf_char2bytes((int)tv_get_number(&argvars[0]), buf)] = NUL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009673 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009674 buf[(*mb_char2bytes)((int)tv_get_number(&argvars[0]), buf)] = NUL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009675 }
9676 else
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009677 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009678 buf[0] = (char_u)tv_get_number(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009679 buf[1] = NUL;
9680 }
9681 rettv->v_type = VAR_STRING;
9682 rettv->vval.v_string = vim_strsave(buf);
9683}
9684
9685/*
9686 * "or(expr, expr)" function
9687 */
9688 static void
9689f_or(typval_T *argvars, typval_T *rettv)
9690{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009691 if (in_vim9script()
9692 && (check_for_number_arg(argvars, 0) == FAIL
9693 || check_for_number_arg(argvars, 1) == FAIL))
9694 return;
9695
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009696 rettv->vval.v_number = tv_get_number_chk(&argvars[0], NULL)
9697 | tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009698}
9699
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009700#ifdef FEAT_PERL
9701/*
9702 * "perleval()" function
9703 */
9704 static void
9705f_perleval(typval_T *argvars, typval_T *rettv)
9706{
9707 char_u *str;
9708 char_u buf[NUMBUFLEN];
9709
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009710 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
9711 return;
9712
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009713 str = tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009714 do_perleval(str, rettv);
9715}
9716#endif
9717
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009718/*
9719 * "prevnonblank()" function
9720 */
9721 static void
9722f_prevnonblank(typval_T *argvars, typval_T *rettv)
9723{
9724 linenr_T lnum;
9725
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009726 if (in_vim9script() && check_for_lnum_arg(argvars, 0) == FAIL)
9727 return;
9728
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009729 lnum = tv_get_lnum(argvars);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009730 if (lnum < 1 || lnum > curbuf->b_ml.ml_line_count)
9731 lnum = 0;
9732 else
9733 while (lnum >= 1 && *skipwhite(ml_get(lnum)) == NUL)
9734 --lnum;
9735 rettv->vval.v_number = lnum;
9736}
9737
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009738// This dummy va_list is here because:
9739// - passing a NULL pointer doesn't work when va_list isn't a pointer
9740// - locally in the function results in a "used before set" warning
9741// - using va_start() to initialize it gives "function with fixed args" error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009742static va_list ap;
9743
9744/*
9745 * "printf()" function
9746 */
9747 static void
9748f_printf(typval_T *argvars, typval_T *rettv)
9749{
9750 char_u buf[NUMBUFLEN];
9751 int len;
9752 char_u *s;
9753 int saved_did_emsg = did_emsg;
9754 char *fmt;
9755
9756 rettv->v_type = VAR_STRING;
9757 rettv->vval.v_string = NULL;
9758
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02009759 if (in_vim9script() && check_for_string_or_number_arg(argvars, 0) == FAIL)
9760 return;
9761
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009762 // Get the required length, allocate the buffer and do it for real.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009763 did_emsg = FALSE;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009764 fmt = (char *)tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar8327d1d2017-07-11 22:34:51 +02009765 len = vim_vsnprintf_typval(NULL, 0, fmt, ap, argvars + 1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009766 if (!did_emsg)
9767 {
9768 s = alloc(len + 1);
9769 if (s != NULL)
9770 {
9771 rettv->vval.v_string = s;
Bram Moolenaar8327d1d2017-07-11 22:34:51 +02009772 (void)vim_vsnprintf_typval((char *)s, len + 1, fmt,
9773 ap, argvars + 1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009774 }
9775 }
9776 did_emsg |= saved_did_emsg;
9777}
9778
9779/*
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009780 * "pum_getpos()" function
9781 */
9782 static void
9783f_pum_getpos(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
9784{
Bram Moolenaar93a10962022-06-16 11:42:09 +01009785 if (rettv_dict_alloc(rettv) == FAIL)
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009786 return;
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009787 pum_set_event_info(rettv->vval.v_dict);
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009788}
9789
9790/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009791 * "pumvisible()" function
9792 */
9793 static void
9794f_pumvisible(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
9795{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009796 if (pum_visible())
9797 rettv->vval.v_number = 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009798}
9799
9800#ifdef FEAT_PYTHON3
9801/*
9802 * "py3eval()" function
9803 */
9804 static void
9805f_py3eval(typval_T *argvars, typval_T *rettv)
9806{
9807 char_u *str;
9808 char_u buf[NUMBUFLEN];
Ben Jacksonea19e782024-11-06 21:50:05 +01009809 dict_T *locals;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009810
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009811 if (check_restricted() || check_secure())
9812 return;
9813
Ben Jacksonea19e782024-11-06 21:50:05 +01009814 if (in_vim9script()
9815 && (check_for_string_arg(argvars, 0) == FAIL
9816 || check_for_opt_dict_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009817 return;
9818
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009819 if (p_pyx == 0)
9820 p_pyx = 3;
9821
Ben Jacksonea19e782024-11-06 21:50:05 +01009822 if (argvars[1].v_type == VAR_DICT)
9823 {
9824 locals = argvars[1].vval.v_dict;
9825 }
9826 else if (argvars[1].v_type != VAR_UNKNOWN)
9827 {
9828 emsg(_(e_dictionary_required));
9829 return;
9830 }
9831 else
9832 {
9833 locals = NULL;
9834 }
9835
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009836 str = tv_get_string_buf(&argvars[0], buf);
Ben Jacksonea19e782024-11-06 21:50:05 +01009837 do_py3eval(str, locals, rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009838}
9839#endif
9840
9841#ifdef FEAT_PYTHON
9842/*
9843 * "pyeval()" function
9844 */
9845 static void
9846f_pyeval(typval_T *argvars, typval_T *rettv)
9847{
9848 char_u *str;
9849 char_u buf[NUMBUFLEN];
Ben Jacksonea19e782024-11-06 21:50:05 +01009850 dict_T *locals;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009851
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009852 if (check_restricted() || check_secure())
9853 return;
9854
Ben Jacksonea19e782024-11-06 21:50:05 +01009855 if (in_vim9script() && (
9856 check_for_string_arg(argvars, 0) == FAIL ||
9857 check_for_opt_dict_arg(argvars, 1) == FAIL ) )
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009858 return;
9859
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009860 if (p_pyx == 0)
9861 p_pyx = 2;
9862
Ben Jacksonea19e782024-11-06 21:50:05 +01009863 if (argvars[1].v_type == VAR_DICT)
9864 {
9865 locals = argvars[1].vval.v_dict;
9866 }
9867 else if (argvars[1].v_type != VAR_UNKNOWN)
9868 {
9869 emsg( "Invalid argument: must be dict" );
9870 return;
9871 }
9872 else
9873 {
9874 locals = NULL;
9875 }
9876
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009877 str = tv_get_string_buf(&argvars[0], buf);
Ben Jacksonea19e782024-11-06 21:50:05 +01009878 do_pyeval(str, locals, rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009879}
9880#endif
9881
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009882#if defined(FEAT_PYTHON) || defined(FEAT_PYTHON3)
9883/*
9884 * "pyxeval()" function
9885 */
9886 static void
9887f_pyxeval(typval_T *argvars, typval_T *rettv)
9888{
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009889 if (check_restricted() || check_secure())
9890 return;
9891
Ben Jacksonea19e782024-11-06 21:50:05 +01009892 if (in_vim9script()
9893 && (check_for_string_arg(argvars, 0) == FAIL
9894 || check_for_opt_dict_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009895 return;
9896
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009897# if defined(FEAT_PYTHON) && defined(FEAT_PYTHON3)
9898 init_pyxversion();
9899 if (p_pyx == 2)
9900 f_pyeval(argvars, rettv);
9901 else
9902 f_py3eval(argvars, rettv);
9903# elif defined(FEAT_PYTHON)
9904 f_pyeval(argvars, rettv);
9905# elif defined(FEAT_PYTHON3)
9906 f_py3eval(argvars, rettv);
9907# endif
9908}
9909#endif
9910
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009911static UINT32_T srand_seed_for_testing = 0;
9912static int srand_seed_for_testing_is_used = FALSE;
9913
9914 static void
9915f_test_srand_seed(typval_T *argvars, typval_T *rettv UNUSED)
9916{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009917 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
9918 return;
9919
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009920 if (argvars[0].v_type == VAR_UNKNOWN)
Bram Moolenaar7633fe52020-06-22 19:10:56 +02009921 srand_seed_for_testing_is_used = FALSE;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009922 else
9923 {
Bram Moolenaar7633fe52020-06-22 19:10:56 +02009924 srand_seed_for_testing = (UINT32_T)tv_get_number(&argvars[0]);
9925 srand_seed_for_testing_is_used = TRUE;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009926 }
9927}
9928
9929 static void
9930init_srand(UINT32_T *x)
9931{
LemonBoy9987fe82024-07-04 13:20:49 +02009932 struct {
9933 union {
9934 UINT32_T number;
9935 char_u bytes[sizeof(UINT32_T)];
9936 } contents;
9937 } buf;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009938
9939 if (srand_seed_for_testing_is_used)
9940 {
Bram Moolenaar7633fe52020-06-22 19:10:56 +02009941 *x = srand_seed_for_testing;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009942 return;
9943 }
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009944
LemonBoy9987fe82024-07-04 13:20:49 +02009945 if (mch_get_random(buf.contents.bytes, sizeof(buf.contents.bytes)) == OK)
9946 {
9947 *x = buf.contents.number;
9948 return;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009949 }
LemonBoy9987fe82024-07-04 13:20:49 +02009950
9951 // The system's random number generator doesn't work, fall back to:
9952 // - randombytes_random()
9953 // - reltime() or time()
9954 // - XOR with process ID
9955#if defined(FEAT_SODIUM)
9956 if (crypt_sodium_init() >= 0)
9957 *x = crypt_sodium_randombytes_random();
9958 else
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009959#endif
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009960 {
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009961#if defined(FEAT_RELTIME)
LemonBoy9987fe82024-07-04 13:20:49 +02009962 proftime_T res;
9963 profile_start(&res);
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009964# if defined(MSWIN)
LemonBoy9987fe82024-07-04 13:20:49 +02009965 *x = (UINT32_T)res.LowPart;
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009966# else
LemonBoy9987fe82024-07-04 13:20:49 +02009967 *x = (UINT32_T)res.tv_fsec;
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009968# endif
9969#else
LemonBoy9987fe82024-07-04 13:20:49 +02009970 *x = vim_time();
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009971#endif
LemonBoy9987fe82024-07-04 13:20:49 +02009972 *x ^= mch_get_pid();
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009973 }
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009974}
9975
kylo252ae6f1d82022-02-16 19:24:07 +00009976#define ROTL(x, k) (((x) << (k)) | ((x) >> (32 - (k))))
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009977#define SPLITMIX32(x, z) ( \
kylo252ae6f1d82022-02-16 19:24:07 +00009978 (z) = ((x) += 0x9e3779b9), \
9979 (z) = ((z) ^ ((z) >> 16)) * 0x85ebca6b, \
9980 (z) = ((z) ^ ((z) >> 13)) * 0xc2b2ae35, \
9981 (z) ^ ((z) >> 16) \
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009982 )
9983#define SHUFFLE_XOSHIRO128STARSTAR(x, y, z, w) \
kylo252ae6f1d82022-02-16 19:24:07 +00009984 result = ROTL((y) * 5, 7) * 9; \
9985 t = (y) << 9; \
9986 (z) ^= (x); \
9987 (w) ^= (y); \
9988 (y) ^= (z), (x) ^= (w); \
9989 (z) ^= t; \
9990 (w) = ROTL(w, 11);
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009991
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009992/*
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009993 * "rand()" function
9994 */
9995 static void
9996f_rand(typval_T *argvars, typval_T *rettv)
9997{
9998 list_T *l = NULL;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009999 static UINT32_T gx, gy, gz, gw;
10000 static int initialized = FALSE;
Bram Moolenaarf8c1f922019-11-28 22:13:14 +010010001 listitem_T *lx, *ly, *lz, *lw;
Bram Moolenaar0fd797e2020-11-05 20:46:32 +010010002 UINT32_T x = 0, y, z, w, t, result;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010003
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010004 if (in_vim9script() && check_for_opt_list_arg(argvars, 0) == FAIL)
10005 return;
10006
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010007 if (argvars[0].v_type == VAR_UNKNOWN)
10008 {
Bram Moolenaarf8c1f922019-11-28 22:13:14 +010010009 // When no argument is given use the global seed list.
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010010 if (initialized == FALSE)
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010011 {
Bram Moolenaarf8c1f922019-11-28 22:13:14 +010010012 // Initialize the global seed list.
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010013 init_srand(&x);
10014
10015 gx = SPLITMIX32(x, z);
10016 gy = SPLITMIX32(x, z);
10017 gz = SPLITMIX32(x, z);
10018 gw = SPLITMIX32(x, z);
10019 initialized = TRUE;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010020 }
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010021
10022 SHUFFLE_XOSHIRO128STARSTAR(gx, gy, gz, gw);
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010023 }
10024 else if (argvars[0].v_type == VAR_LIST)
10025 {
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010026 l = argvars[0].vval.v_list;
Bram Moolenaarf8c1f922019-11-28 22:13:14 +010010027 if (l == NULL || list_len(l) != 4)
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010028 goto theend;
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010029
10030 lx = list_find(l, 0L);
10031 ly = list_find(l, 1L);
10032 lz = list_find(l, 2L);
10033 lw = list_find(l, 3L);
10034 if (lx->li_tv.v_type != VAR_NUMBER) goto theend;
10035 if (ly->li_tv.v_type != VAR_NUMBER) goto theend;
10036 if (lz->li_tv.v_type != VAR_NUMBER) goto theend;
10037 if (lw->li_tv.v_type != VAR_NUMBER) goto theend;
10038 x = (UINT32_T)lx->li_tv.vval.v_number;
10039 y = (UINT32_T)ly->li_tv.vval.v_number;
10040 z = (UINT32_T)lz->li_tv.vval.v_number;
10041 w = (UINT32_T)lw->li_tv.vval.v_number;
10042
10043 SHUFFLE_XOSHIRO128STARSTAR(x, y, z, w);
10044
10045 lx->li_tv.vval.v_number = (varnumber_T)x;
10046 ly->li_tv.vval.v_number = (varnumber_T)y;
10047 lz->li_tv.vval.v_number = (varnumber_T)z;
10048 lw->li_tv.vval.v_number = (varnumber_T)w;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010049 }
10050 else
10051 goto theend;
10052
10053 rettv->v_type = VAR_NUMBER;
Bram Moolenaarf8c1f922019-11-28 22:13:14 +010010054 rettv->vval.v_number = (varnumber_T)result;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010055 return;
10056
10057theend:
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010058 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[0]));
Bram Moolenaarf8c1f922019-11-28 22:13:14 +010010059 rettv->v_type = VAR_NUMBER;
10060 rettv->vval.v_number = -1;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010061}
10062
10063/*
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010064 * "srand()" function
10065 */
10066 static void
10067f_srand(typval_T *argvars, typval_T *rettv)
10068{
10069 UINT32_T x = 0, z;
10070
10071 if (rettv_list_alloc(rettv) == FAIL)
10072 return;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010073
10074 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
10075 return;
10076
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010077 if (argvars[0].v_type == VAR_UNKNOWN)
10078 {
10079 init_srand(&x);
10080 }
10081 else
10082 {
10083 int error = FALSE;
10084
10085 x = (UINT32_T)tv_get_number_chk(&argvars[0], &error);
10086 if (error)
10087 return;
10088 }
10089
10090 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
10091 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
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}
10095
10096#undef ROTL
10097#undef SPLITMIX32
10098#undef SHUFFLE_XOSHIRO128STARSTAR
10099
10100/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010101 * "range()" function
10102 */
10103 static void
10104f_range(typval_T *argvars, typval_T *rettv)
10105{
10106 varnumber_T start;
10107 varnumber_T end;
10108 varnumber_T stride = 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010109 int error = FALSE;
10110
Bram Moolenaar93a10962022-06-16 11:42:09 +010010111 if (rettv_list_alloc(rettv) == FAIL)
Yegappan Lakshmananca195cc2022-06-14 13:42:26 +010010112 return;
10113
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010114 if (in_vim9script()
10115 && (check_for_number_arg(argvars, 0) == FAIL
10116 || check_for_opt_number_arg(argvars, 1) == FAIL
10117 || (argvars[1].v_type != VAR_UNKNOWN
10118 && check_for_opt_number_arg(argvars, 2) == FAIL)))
10119 return;
10120
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010121 start = tv_get_number_chk(&argvars[0], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010122 if (argvars[1].v_type == VAR_UNKNOWN)
10123 {
10124 end = start - 1;
10125 start = 0;
10126 }
10127 else
10128 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010129 end = tv_get_number_chk(&argvars[1], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010130 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010131 stride = tv_get_number_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010132 }
10133
10134 if (error)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010135 return; // type error; errmsg already given
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010136 if (stride == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010137 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010138 emsg(_(e_stride_is_zero));
10139 return;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010010140 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010141 if (stride > 0 ? end + 1 < start : end - 1 > start)
10142 {
10143 emsg(_(e_start_past_end));
10144 return;
10145 }
10146
10147 list_T *list = rettv->vval.v_list;
10148
10149 // Create a non-materialized list. This is much more efficient and
10150 // works with ":for". If used otherwise CHECK_LIST_MATERIALIZE() must
10151 // be called.
10152 list->lv_first = &range_list_item;
10153 list->lv_u.nonmat.lv_start = start;
10154 list->lv_u.nonmat.lv_end = end;
10155 list->lv_u.nonmat.lv_stride = stride;
Christian Brabandtdf63da92023-11-23 20:14:28 +010010156 if (stride > 0 ? end < start : end > start)
10157 list->lv_len = 0;
10158 else
10159 list->lv_len = (end - start) / stride + 1;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010010160}
10161
10162/*
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020010163 * Materialize "list".
10164 * Do not call directly, use CHECK_LIST_MATERIALIZE()
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010010165 */
10166 void
10167range_list_materialize(list_T *list)
10168{
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020010169 varnumber_T start = list->lv_u.nonmat.lv_start;
10170 varnumber_T end = list->lv_u.nonmat.lv_end;
Bram Moolenaar70c43d82022-01-26 21:01:15 +000010171 int stride = list->lv_u.nonmat.lv_stride;
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020010172 varnumber_T i;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010010173
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020010174 list->lv_first = NULL;
10175 list->lv_u.mat.lv_last = NULL;
10176 list->lv_len = 0;
10177 list->lv_u.mat.lv_idx_item = NULL;
10178 for (i = start; stride > 0 ? i <= end : i >= end; i += stride)
Bram Moolenaar70c43d82022-01-26 21:01:15 +000010179 {
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +000010180 if (list_append_number(list, i) == FAIL)
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020010181 break;
Bram Moolenaar70c43d82022-01-26 21:01:15 +000010182 if (list->lv_lock & VAR_ITEMS_LOCKED)
10183 list->lv_u.mat.lv_last->li_tv.v_lock = VAR_LOCKED;
10184 }
10185 list->lv_lock &= ~VAR_ITEMS_LOCKED;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010186}
10187
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010188/*
10189 * "getreginfo()" function
10190 */
10191 static void
10192f_getreginfo(typval_T *argvars, typval_T *rettv)
10193{
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010194 int regname;
10195 char_u buf[NUMBUFLEN + 2];
10196 long reglen = 0;
10197 dict_T *dict;
10198 list_T *list;
10199
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010200 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
10201 return;
10202
zeertzjqd3f00f52021-12-24 12:02:43 +000010203 regname = getreg_get_regname(argvars);
10204 if (regname == 0)
10205 return;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010206
zeertzjqd3f00f52021-12-24 12:02:43 +000010207 if (regname == '@')
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010208 regname = '"';
10209
10210 if (rettv_dict_alloc(rettv) == FAIL)
10211 return;
10212 dict = rettv->vval.v_dict;
10213
10214 list = (list_T *)get_reg_contents(regname, GREG_EXPR_SRC | GREG_LIST);
10215 if (list == NULL)
10216 return;
Bram Moolenaar91639192020-06-29 19:55:58 +020010217 (void)dict_add_list(dict, "regcontents", list);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010218
10219 buf[0] = NUL;
10220 buf[1] = NUL;
10221 switch (get_reg_type(regname, &reglen))
10222 {
10223 case MLINE: buf[0] = 'V'; break;
10224 case MCHAR: buf[0] = 'v'; break;
10225 case MBLOCK:
10226 vim_snprintf((char *)buf, sizeof(buf), "%c%ld", Ctrl_V,
10227 reglen + 1);
10228 break;
10229 }
Bram Moolenaar91639192020-06-29 19:55:58 +020010230 (void)dict_add_string(dict, (char *)"regtype", buf);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010231
10232 buf[0] = get_register_name(get_unname_register());
10233 buf[1] = NUL;
10234 if (regname == '"')
Bram Moolenaar91639192020-06-29 19:55:58 +020010235 (void)dict_add_string(dict, (char *)"points_to", buf);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010236 else
10237 {
10238 dictitem_T *item = dictitem_alloc((char_u *)"isunnamed");
10239
10240 if (item != NULL)
10241 {
Bram Moolenaar82946e12022-11-24 11:31:29 +000010242 item->di_tv.v_type = VAR_BOOL;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010243 item->di_tv.vval.v_number = regname == buf[0]
Bram Moolenaar418a29f2021-02-10 22:23:41 +010010244 ? VVAL_TRUE : VVAL_FALSE;
Bram Moolenaar91639192020-06-29 19:55:58 +020010245 (void)dict_add(dict, item);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010246 }
10247 }
10248}
10249
Bram Moolenaar0b6d9112018-05-22 20:35:17 +020010250 static void
10251return_register(int regname, typval_T *rettv)
10252{
10253 char_u buf[2] = {0, 0};
10254
10255 buf[0] = (char_u)regname;
10256 rettv->v_type = VAR_STRING;
10257 rettv->vval.v_string = vim_strsave(buf);
10258}
10259
10260/*
10261 * "reg_executing()" function
10262 */
10263 static void
10264f_reg_executing(typval_T *argvars UNUSED, typval_T *rettv)
10265{
10266 return_register(reg_executing, rettv);
10267}
10268
10269/*
10270 * "reg_recording()" function
10271 */
10272 static void
10273f_reg_recording(typval_T *argvars UNUSED, typval_T *rettv)
10274{
10275 return_register(reg_recording, rettv);
10276}
10277
Bram Moolenaar7416f3e2017-03-18 18:10:13 +010010278/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010279 * "rename({from}, {to})" function
10280 */
10281 static void
10282f_rename(typval_T *argvars, typval_T *rettv)
10283{
10284 char_u buf[NUMBUFLEN];
10285
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010286 rettv->vval.v_number = -1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010287 if (check_restricted() || check_secure())
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010288 return;
10289
10290 if (in_vim9script()
10291 && (check_for_string_arg(argvars, 0) == FAIL
10292 || check_for_string_arg(argvars, 1) == FAIL))
10293 return;
10294
10295 rettv->vval.v_number = vim_rename(tv_get_string(&argvars[0]),
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010296 tv_get_string_buf(&argvars[1], buf));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010297}
10298
10299/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010300 * Repeat the list "l" "n" times and set "rettv" to the new list.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010301 */
10302 static void
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010303repeat_list(list_T *l, int n, typval_T *rettv)
10304{
10305 if (rettv_list_alloc(rettv) == FAIL
10306 || l == NULL
10307 || n <= 0)
10308 return;
10309
10310 while (n-- > 0)
10311 if (list_extend(rettv->vval.v_list, l, NULL) == FAIL)
10312 break;
10313}
10314
10315/*
10316 * Repeat the blob "b" "n" times and set "rettv" to the new blob.
10317 */
10318 static void
10319repeat_blob(typval_T *blob_tv, int n, typval_T *rettv)
10320{
10321 int slen;
10322 int len;
10323 int i;
10324 blob_T *blob = blob_tv->vval.v_blob;
10325
10326 if (rettv_blob_alloc(rettv) == FAIL
10327 || blob == NULL
10328 || n <= 0)
10329 return;
10330
10331 slen = blob->bv_ga.ga_len;
10332 len = (int)slen * n;
10333 if (len <= 0)
10334 return;
10335
10336 if (ga_grow(&rettv->vval.v_blob->bv_ga, len) == FAIL)
10337 return;
10338
10339 rettv->vval.v_blob->bv_ga.ga_len = len;
10340
10341 for (i = 0; i < slen; ++i)
10342 if (blob_get(blob, i) != 0)
10343 break;
10344
10345 if (i == slen)
10346 // No need to copy since all bytes are already zero
10347 return;
10348
10349 for (i = 0; i < n; ++i)
10350 blob_set_range(rettv->vval.v_blob,
10351 (long)i * slen, ((long)i + 1) * slen - 1, blob_tv);
10352}
10353
10354/*
10355 * Repeat the string "str" "n" times and set "rettv" to the new string.
10356 */
10357 static void
10358repeat_string(typval_T *str_tv, int n, typval_T *rettv)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010359{
10360 char_u *p;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010361 int slen;
10362 int len;
10363 char_u *r;
10364 int i;
10365
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010366 p = tv_get_string(str_tv);
10367 rettv->v_type = VAR_STRING;
10368 rettv->vval.v_string = NULL;
10369
10370 slen = (int)STRLEN(p);
10371 len = slen * n;
10372 if (len <= 0)
10373 return;
10374
10375 r = alloc(len + 1);
10376 if (r == NULL)
10377 return;
10378
10379 for (i = 0; i < n; i++)
10380 mch_memmove(r + i * slen, p, (size_t)slen);
10381 r[len] = NUL;
10382
10383 rettv->vval.v_string = r;
10384}
10385
10386/*
10387 * "repeat()" function
10388 */
10389 static void
10390f_repeat(typval_T *argvars, typval_T *rettv)
10391{
10392 varnumber_T n;
10393
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +020010394 if (in_vim9script()
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010395 && (check_for_repeat_func_arg(argvars, 0) == FAIL
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010396 || check_for_number_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +020010397 return;
10398
Bakudankun375141e2022-09-09 18:46:47 +010010399 n = tv_get_number(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010400 if (argvars[0].v_type == VAR_LIST)
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010401 repeat_list(argvars[0].vval.v_list, n, rettv);
10402 else if (argvars[0].v_type == VAR_TUPLE)
10403 tuple_repeat(argvars[0].vval.v_tuple, n, rettv);
Bakudankun375141e2022-09-09 18:46:47 +010010404 else if (argvars[0].v_type == VAR_BLOB)
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010405 repeat_blob(&argvars[0], n, rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010406 else
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010407 repeat_string(&argvars[0], n, rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010408}
10409
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010410#define SP_NOMOVE 0x01 // don't move cursor
10411#define SP_REPEAT 0x02 // repeat to find outer pair
10412#define SP_RETCOUNT 0x04 // return matchcount
10413#define SP_SETPCMARK 0x08 // set previous context mark
10414#define SP_START 0x10 // accept match at start position
10415#define SP_SUBPAT 0x20 // return nr of matching sub-pattern
10416#define SP_END 0x40 // leave cursor at end of match
10417#define SP_COLUMN 0x80 // start at cursor column
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010418
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010419/*
10420 * Get flags for a search function.
10421 * Possibly sets "p_ws".
10422 * Returns BACKWARD, FORWARD or zero (for an error).
10423 */
10424 static int
10425get_search_arg(typval_T *varp, int *flagsp)
10426{
10427 int dir = FORWARD;
10428 char_u *flags;
10429 char_u nbuf[NUMBUFLEN];
10430 int mask;
10431
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010432 if (varp->v_type == VAR_UNKNOWN)
10433 return FORWARD;
10434
10435 flags = tv_get_string_buf_chk(varp, nbuf);
10436 if (flags == NULL)
10437 return 0; // type error; errmsg already given
10438 while (*flags != NUL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010439 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010440 switch (*flags)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010441 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010442 case 'b': dir = BACKWARD; break;
10443 case 'w': p_ws = TRUE; break;
10444 case 'W': p_ws = FALSE; break;
10445 default: mask = 0;
10446 if (flagsp != NULL)
10447 switch (*flags)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010448 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010449 case 'c': mask = SP_START; break;
10450 case 'e': mask = SP_END; break;
10451 case 'm': mask = SP_RETCOUNT; break;
10452 case 'n': mask = SP_NOMOVE; break;
10453 case 'p': mask = SP_SUBPAT; break;
10454 case 'r': mask = SP_REPEAT; break;
10455 case 's': mask = SP_SETPCMARK; break;
10456 case 'z': mask = SP_COLUMN; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010457 }
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010458 if (mask == 0)
10459 {
10460 semsg(_(e_invalid_argument_str), flags);
10461 dir = 0;
10462 }
10463 else
10464 *flagsp |= mask;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010465 }
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010466 if (dir == 0)
10467 break;
10468 ++flags;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010469 }
10470 return dir;
10471}
10472
10473/*
10474 * Shared by search() and searchpos() functions.
10475 */
10476 static int
10477search_cmn(typval_T *argvars, pos_T *match_pos, int *flagsp)
10478{
10479 int flags;
10480 char_u *pat;
John Marriott8c85a2a2024-05-20 19:18:26 +020010481 size_t patlen;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010482 pos_T pos;
10483 pos_T save_cursor;
10484 int save_p_ws = p_ws;
10485 int dir;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010486 int retval = 0; // default: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010487 long lnum_stop = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010488#ifdef FEAT_RELTIME
10489 long time_limit = 0;
10490#endif
10491 int options = SEARCH_KEEP;
10492 int subpatnum;
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010493 searchit_arg_T sia;
Bram Moolenaara9c01042020-06-07 14:50:50 +020010494 int use_skip = FALSE;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010495 pos_T firstpos;
10496
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +020010497 if (in_vim9script()
10498 && (check_for_string_arg(argvars, 0) == FAIL
10499 || check_for_opt_string_arg(argvars, 1) == FAIL
10500 || (argvars[1].v_type != VAR_UNKNOWN
10501 && (check_for_opt_number_arg(argvars, 2) == FAIL
10502 || (argvars[2].v_type != VAR_UNKNOWN
10503 && check_for_opt_number_arg(argvars, 3) == FAIL)))))
10504 goto theend;
10505
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010506 pat = tv_get_string(&argvars[0]);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010507 dir = get_search_arg(&argvars[1], flagsp); // may set p_ws
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010508 if (dir == 0)
10509 goto theend;
10510 flags = *flagsp;
10511 if (flags & SP_START)
10512 options |= SEARCH_START;
10513 if (flags & SP_END)
10514 options |= SEARCH_END;
10515 if (flags & SP_COLUMN)
10516 options |= SEARCH_COL;
10517
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010518 // Optional arguments: line number to stop searching, timeout and skip.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010519 if (argvars[1].v_type != VAR_UNKNOWN && argvars[2].v_type != VAR_UNKNOWN)
10520 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010521 lnum_stop = (long)tv_get_number_chk(&argvars[2], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010522 if (lnum_stop < 0)
10523 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010524 if (argvars[3].v_type != VAR_UNKNOWN)
10525 {
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010526#ifdef FEAT_RELTIME
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010527 time_limit = (long)tv_get_number_chk(&argvars[3], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010528 if (time_limit < 0)
10529 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010530#endif
Bram Moolenaara9c01042020-06-07 14:50:50 +020010531 use_skip = eval_expr_valid_arg(&argvars[4]);
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010532 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010533 }
10534
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010535 /*
10536 * This function does not accept SP_REPEAT and SP_RETCOUNT flags.
10537 * Check to make sure only those flags are set.
10538 * Also, Only the SP_NOMOVE or the SP_SETPCMARK flag can be set. Both
10539 * flags cannot be set. Check for that condition also.
10540 */
10541 if (((flags & (SP_REPEAT | SP_RETCOUNT)) != 0)
10542 || ((flags & SP_NOMOVE) && (flags & SP_SETPCMARK)))
10543 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010544 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[1]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010545 goto theend;
10546 }
10547
10548 pos = save_cursor = curwin->w_cursor;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010549 CLEAR_FIELD(firstpos);
Bram Moolenaara80faa82020-04-12 19:37:17 +020010550 CLEAR_FIELD(sia);
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010551 sia.sa_stop_lnum = (linenr_T)lnum_stop;
10552#ifdef FEAT_RELTIME
Paul Ollis65745772022-06-05 16:55:54 +010010553 sia.sa_tm = time_limit;
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010554#endif
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010555
John Marriott8c85a2a2024-05-20 19:18:26 +020010556 patlen = STRLEN(pat);
10557
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010558 // Repeat until {skip} returns FALSE.
10559 for (;;)
10560 {
John Marriott8c85a2a2024-05-20 19:18:26 +020010561 subpatnum = searchit(curwin, curbuf, &pos, NULL, dir, pat, patlen, 1L,
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010562 options, RE_SEARCH, &sia);
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010563 // finding the first match again means there is no match where {skip}
10564 // evaluates to zero.
10565 if (firstpos.lnum != 0 && EQUAL_POS(pos, firstpos))
10566 subpatnum = FAIL;
10567
Bram Moolenaara9c01042020-06-07 14:50:50 +020010568 if (subpatnum == FAIL || !use_skip)
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010569 // didn't find it or no skip argument
10570 break;
Bram Moolenaar3d79f0a2023-01-22 20:14:26 +000010571 if (firstpos.lnum == 0)
10572 firstpos = pos;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010573
Bram Moolenaara9c01042020-06-07 14:50:50 +020010574 // If the skip expression matches, ignore this match.
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010575 {
10576 int do_skip;
10577 int err;
10578 pos_T save_pos = curwin->w_cursor;
10579
10580 curwin->w_cursor = pos;
Bram Moolenaara9c01042020-06-07 14:50:50 +020010581 err = FALSE;
10582 do_skip = eval_expr_to_bool(&argvars[4], &err);
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010583 curwin->w_cursor = save_pos;
10584 if (err)
10585 {
10586 // Evaluating {skip} caused an error, break here.
10587 subpatnum = FAIL;
10588 break;
10589 }
10590 if (!do_skip)
10591 break;
10592 }
zeertzjq180246c2022-06-23 12:04:46 +010010593
10594 // clear the start flag to avoid getting stuck here
10595 options &= ~SEARCH_START;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010596 }
10597
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010598 if (subpatnum != FAIL)
10599 {
10600 if (flags & SP_SUBPAT)
10601 retval = subpatnum;
10602 else
10603 retval = pos.lnum;
10604 if (flags & SP_SETPCMARK)
10605 setpcmark();
10606 curwin->w_cursor = pos;
10607 if (match_pos != NULL)
10608 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010609 // Store the match cursor position
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010610 match_pos->lnum = pos.lnum;
10611 match_pos->col = pos.col + 1;
10612 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010613 // "/$" will put the cursor after the end of the line, may need to
10614 // correct that here
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010615 check_cursor();
10616 }
10617
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010618 // If 'n' flag is used: restore cursor position.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010619 if (flags & SP_NOMOVE)
10620 curwin->w_cursor = save_cursor;
10621 else
10622 curwin->w_set_curswant = TRUE;
10623theend:
10624 p_ws = save_p_ws;
10625
10626 return retval;
10627}
10628
Bram Moolenaare99be0e2019-03-26 22:51:09 +010010629#ifdef FEAT_RUBY
10630/*
10631 * "rubyeval()" function
10632 */
10633 static void
10634f_rubyeval(typval_T *argvars, typval_T *rettv)
10635{
10636 char_u *str;
10637 char_u buf[NUMBUFLEN];
10638
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010639 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
10640 return;
10641
Bram Moolenaare99be0e2019-03-26 22:51:09 +010010642 str = tv_get_string_buf(&argvars[0], buf);
10643 do_rubyeval(str, rettv);
10644}
10645#endif
10646
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010647/*
10648 * "screenattr()" function
10649 */
10650 static void
10651f_screenattr(typval_T *argvars, typval_T *rettv)
10652{
10653 int row;
10654 int col;
10655 int c;
10656
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010657 if (in_vim9script()
10658 && (check_for_number_arg(argvars, 0) == FAIL
10659 || check_for_number_arg(argvars, 1) == FAIL))
10660 return;
10661
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010662 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10663 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010664 if (row < 0 || row >= screen_Rows
10665 || col < 0 || col >= screen_Columns)
10666 c = -1;
10667 else
10668 c = ScreenAttrs[LineOffset[row] + col];
10669 rettv->vval.v_number = c;
10670}
10671
10672/*
10673 * "screenchar()" function
10674 */
10675 static void
10676f_screenchar(typval_T *argvars, typval_T *rettv)
10677{
10678 int row;
10679 int col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010680 int c;
10681
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010682 if (in_vim9script()
10683 && (check_for_number_arg(argvars, 0) == FAIL
10684 || check_for_number_arg(argvars, 1) == FAIL))
10685 return;
10686
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010687 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10688 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010689 if (row < 0 || row >= screen_Rows || col < 0 || col >= screen_Columns)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010690 c = -1;
10691 else
10692 {
zeertzjq47eec672023-06-01 20:26:55 +010010693 char_u buf[MB_MAXBYTES + 1];
10694 screen_getbytes(row, col, buf, NULL);
10695 c = (*mb_ptr2char)(buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010696 }
10697 rettv->vval.v_number = c;
10698}
10699
10700/*
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010701 * "screenchars()" function
10702 */
10703 static void
10704f_screenchars(typval_T *argvars, typval_T *rettv)
10705{
10706 int row;
10707 int col;
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010708 int c;
10709 int i;
10710
10711 if (rettv_list_alloc(rettv) == FAIL)
10712 return;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010713
10714 if (in_vim9script()
10715 && (check_for_number_arg(argvars, 0) == FAIL
10716 || check_for_number_arg(argvars, 1) == FAIL))
10717 return;
10718
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010719 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10720 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
10721 if (row < 0 || row >= screen_Rows || col < 0 || col >= screen_Columns)
10722 return;
10723
zeertzjq47eec672023-06-01 20:26:55 +010010724 char_u buf[MB_MAXBYTES + 1];
10725 screen_getbytes(row, col, buf, NULL);
10726 int pcc[MAX_MCO];
10727 if (enc_utf8)
10728 c = utfc_ptr2char(buf, pcc);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010729 else
zeertzjq47eec672023-06-01 20:26:55 +010010730 c = (*mb_ptr2char)(buf);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010731 list_append_number(rettv->vval.v_list, (varnumber_T)c);
10732
10733 if (enc_utf8)
zeertzjq47eec672023-06-01 20:26:55 +010010734 for (i = 0; i < Screen_mco && pcc[i] != 0; ++i)
10735 list_append_number(rettv->vval.v_list, (varnumber_T)pcc[i]);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010736}
10737
10738/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010739 * "screencol()" function
10740 *
10741 * First column is 1 to be consistent with virtcol().
10742 */
10743 static void
10744f_screencol(typval_T *argvars UNUSED, typval_T *rettv)
10745{
10746 rettv->vval.v_number = screen_screencol() + 1;
10747}
10748
10749/*
10750 * "screenrow()" function
10751 */
10752 static void
10753f_screenrow(typval_T *argvars UNUSED, typval_T *rettv)
10754{
10755 rettv->vval.v_number = screen_screenrow() + 1;
10756}
10757
10758/*
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010759 * "screenstring()" function
10760 */
10761 static void
10762f_screenstring(typval_T *argvars, typval_T *rettv)
10763{
10764 int row;
10765 int col;
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010766 char_u buf[MB_MAXBYTES + 1];
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010767
10768 rettv->vval.v_string = NULL;
10769 rettv->v_type = VAR_STRING;
10770
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010771 if (in_vim9script()
10772 && (check_for_number_arg(argvars, 0) == FAIL
10773 || check_for_number_arg(argvars, 1) == FAIL))
10774 return;
10775
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010776 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10777 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
10778 if (row < 0 || row >= screen_Rows || col < 0 || col >= screen_Columns)
10779 return;
10780
zeertzjq47eec672023-06-01 20:26:55 +010010781 screen_getbytes(row, col, buf, NULL);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010782 rettv->vval.v_string = vim_strsave(buf);
10783}
10784
10785/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010786 * "search()" function
10787 */
10788 static void
10789f_search(typval_T *argvars, typval_T *rettv)
10790{
10791 int flags = 0;
10792
10793 rettv->vval.v_number = search_cmn(argvars, NULL, &flags);
10794}
10795
10796/*
10797 * "searchdecl()" function
10798 */
10799 static void
10800f_searchdecl(typval_T *argvars, typval_T *rettv)
10801{
Bram Moolenaar30788d32020-09-05 21:35:16 +020010802 int locally = TRUE;
10803 int thisblock = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010804 int error = FALSE;
10805 char_u *name;
10806
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010807 rettv->vval.v_number = 1; // default: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010808
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020010809 if (in_vim9script()
10810 && (check_for_string_arg(argvars, 0) == FAIL
10811 || check_for_opt_bool_arg(argvars, 1) == FAIL
10812 || (argvars[1].v_type != VAR_UNKNOWN
10813 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
10814 return;
10815
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010816 name = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010817 if (argvars[1].v_type != VAR_UNKNOWN)
10818 {
Bram Moolenaar30788d32020-09-05 21:35:16 +020010819 locally = !(int)tv_get_bool_chk(&argvars[1], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010820 if (!error && argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar30788d32020-09-05 21:35:16 +020010821 thisblock = (int)tv_get_bool_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010822 }
10823 if (!error && name != NULL)
10824 rettv->vval.v_number = find_decl(name, (int)STRLEN(name),
10825 locally, thisblock, SEARCH_KEEP) == FAIL;
10826}
10827
10828/*
10829 * Used by searchpair() and searchpairpos()
10830 */
10831 static int
10832searchpair_cmn(typval_T *argvars, pos_T *match_pos)
10833{
10834 char_u *spat, *mpat, *epat;
Bram Moolenaar48570482017-10-30 21:48:41 +010010835 typval_T *skip;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010836 int save_p_ws = p_ws;
10837 int dir;
10838 int flags = 0;
10839 char_u nbuf1[NUMBUFLEN];
10840 char_u nbuf2[NUMBUFLEN];
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010841 int retval = 0; // default: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010842 long lnum_stop = 0;
10843 long time_limit = 0;
10844
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +020010845 if (in_vim9script()
10846 && (check_for_string_arg(argvars, 0) == FAIL
10847 || check_for_string_arg(argvars, 1) == FAIL
10848 || check_for_string_arg(argvars, 2) == FAIL
10849 || check_for_opt_string_arg(argvars, 3) == FAIL
10850 || (argvars[3].v_type != VAR_UNKNOWN
10851 && argvars[4].v_type != VAR_UNKNOWN
10852 && (check_for_opt_number_arg(argvars, 5) == FAIL
10853 || (argvars[5].v_type != VAR_UNKNOWN
10854 && check_for_opt_number_arg(argvars, 6) == FAIL)))))
10855 goto theend;
10856
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010857 // Get the three pattern arguments: start, middle, end. Will result in an
10858 // error if not a valid argument.
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010859 spat = tv_get_string_chk(&argvars[0]);
10860 mpat = tv_get_string_buf_chk(&argvars[1], nbuf1);
10861 epat = tv_get_string_buf_chk(&argvars[2], nbuf2);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010862 if (spat == NULL || mpat == NULL || epat == NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010863 goto theend; // type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010864
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010865 // Handle the optional fourth argument: flags
10866 dir = get_search_arg(&argvars[3], &flags); // may set p_ws
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010867 if (dir == 0)
10868 goto theend;
10869
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010870 // Don't accept SP_END or SP_SUBPAT.
10871 // Only one of the SP_NOMOVE or SP_SETPCMARK flags can be set.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010872 if ((flags & (SP_END | SP_SUBPAT)) != 0
10873 || ((flags & SP_NOMOVE) && (flags & SP_SETPCMARK)))
10874 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010875 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[3]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010876 goto theend;
10877 }
10878
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010879 // Using 'r' implies 'W', otherwise it doesn't work.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010880 if (flags & SP_REPEAT)
10881 p_ws = FALSE;
10882
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010883 // Optional fifth argument: skip expression
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010884 if (argvars[3].v_type == VAR_UNKNOWN
10885 || argvars[4].v_type == VAR_UNKNOWN)
Bram Moolenaar48570482017-10-30 21:48:41 +010010886 skip = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010887 else
10888 {
Bram Moolenaara9c01042020-06-07 14:50:50 +020010889 // Type is checked later.
Bram Moolenaar48570482017-10-30 21:48:41 +010010890 skip = &argvars[4];
Bram Moolenaara9c01042020-06-07 14:50:50 +020010891
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010892 if (argvars[5].v_type != VAR_UNKNOWN)
10893 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010894 lnum_stop = (long)tv_get_number_chk(&argvars[5], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010895 if (lnum_stop < 0)
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010896 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010897 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[5]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010898 goto theend;
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010899 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010900#ifdef FEAT_RELTIME
10901 if (argvars[6].v_type != VAR_UNKNOWN)
10902 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010903 time_limit = (long)tv_get_number_chk(&argvars[6], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010904 if (time_limit < 0)
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010905 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010906 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[6]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010907 goto theend;
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010908 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010909 }
10910#endif
10911 }
10912 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010913
10914 retval = do_searchpair(spat, mpat, epat, dir, skip, flags,
10915 match_pos, lnum_stop, time_limit);
10916
10917theend:
10918 p_ws = save_p_ws;
10919
10920 return retval;
10921}
10922
10923/*
10924 * "searchpair()" function
10925 */
10926 static void
10927f_searchpair(typval_T *argvars, typval_T *rettv)
10928{
10929 rettv->vval.v_number = searchpair_cmn(argvars, NULL);
10930}
10931
10932/*
10933 * "searchpairpos()" function
10934 */
10935 static void
10936f_searchpairpos(typval_T *argvars, typval_T *rettv)
10937{
10938 pos_T match_pos;
10939 int lnum = 0;
10940 int col = 0;
10941
10942 if (rettv_list_alloc(rettv) == FAIL)
10943 return;
10944
10945 if (searchpair_cmn(argvars, &match_pos) > 0)
10946 {
10947 lnum = match_pos.lnum;
10948 col = match_pos.col;
10949 }
10950
10951 list_append_number(rettv->vval.v_list, (varnumber_T)lnum);
10952 list_append_number(rettv->vval.v_list, (varnumber_T)col);
10953}
10954
10955/*
10956 * Search for a start/middle/end thing.
10957 * Used by searchpair(), see its documentation for the details.
10958 * Returns 0 or -1 for no match,
10959 */
10960 long
10961do_searchpair(
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010962 char_u *spat, // start pattern
10963 char_u *mpat, // middle pattern
10964 char_u *epat, // end pattern
10965 int dir, // BACKWARD or FORWARD
10966 typval_T *skip, // skip expression
10967 int flags, // SP_SETPCMARK and other SP_ values
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010968 pos_T *match_pos,
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010969 linenr_T lnum_stop, // stop at this line if not zero
10970 long time_limit UNUSED) // stop after this many msec
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010971{
10972 char_u *save_cpo;
10973 char_u *pat, *pat2 = NULL, *pat3 = NULL;
John Marriott8c85a2a2024-05-20 19:18:26 +020010974 size_t patlen;
10975 size_t spatlen;
10976 size_t epatlen;
10977 size_t pat2size;
10978 size_t pat2len;
10979 size_t pat3size;
10980 size_t pat3len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010981 long retval = 0;
10982 pos_T pos;
10983 pos_T firstpos;
10984 pos_T foundpos;
10985 pos_T save_cursor;
10986 pos_T save_pos;
10987 int n;
10988 int r;
10989 int nest = 1;
Bram Moolenaar48570482017-10-30 21:48:41 +010010990 int use_skip = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010991 int err;
10992 int options = SEARCH_KEEP;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010993
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010994 // Make 'cpoptions' empty, the 'l' flag should not be used here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010995 save_cpo = p_cpo;
10996 p_cpo = empty_option;
10997
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010998 // Make two search patterns: start/end (pat2, for in nested pairs) and
10999 // start/middle/end (pat3, for the top pair).
John Marriott8c85a2a2024-05-20 19:18:26 +020011000 spatlen = STRLEN(spat);
11001 epatlen = STRLEN(epat);
11002 pat2size = spatlen + epatlen + 17;
11003 pat2 = alloc(pat2size);
11004 if (pat2 == NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011005 goto theend;
John Marriott8c85a2a2024-05-20 19:18:26 +020011006 pat3size = spatlen + STRLEN(mpat) + epatlen + 25;
11007 pat3 = alloc(pat3size);
11008 if (pat3 == NULL)
11009 goto theend;
11010 pat2len = vim_snprintf((char *)pat2, pat2size, "\\m\\(%s\\m\\)\\|\\(%s\\m\\)", spat, epat);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011011 if (*mpat == NUL)
John Marriott8c85a2a2024-05-20 19:18:26 +020011012 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011013 STRCPY(pat3, pat2);
John Marriott8c85a2a2024-05-20 19:18:26 +020011014 pat3len = pat2len;
11015 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011016 else
John Marriott8c85a2a2024-05-20 19:18:26 +020011017 pat3len = vim_snprintf((char *)pat3, pat3size, "\\m\\(%s\\m\\)\\|\\(%s\\m\\)\\|\\(%s\\m\\)",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011018 spat, epat, mpat);
11019 if (flags & SP_START)
11020 options |= SEARCH_START;
11021
Bram Moolenaar48570482017-10-30 21:48:41 +010011022 if (skip != NULL)
Bram Moolenaara9c01042020-06-07 14:50:50 +020011023 use_skip = eval_expr_valid_arg(skip);
Bram Moolenaar48570482017-10-30 21:48:41 +010011024
Bram Moolenaar5ea38d12022-06-16 21:20:48 +010011025#ifdef FEAT_RELTIME
11026 if (time_limit > 0)
11027 init_regexp_timeout(time_limit);
11028#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011029 save_cursor = curwin->w_cursor;
11030 pos = curwin->w_cursor;
Bram Moolenaarb5aedf32017-03-12 18:23:53 +010011031 CLEAR_POS(&firstpos);
11032 CLEAR_POS(&foundpos);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011033 pat = pat3;
John Marriott8c85a2a2024-05-20 19:18:26 +020011034 patlen = pat3len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011035 for (;;)
11036 {
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020011037 searchit_arg_T sia;
11038
Bram Moolenaara80faa82020-04-12 19:37:17 +020011039 CLEAR_FIELD(sia);
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020011040 sia.sa_stop_lnum = lnum_stop;
John Marriott8c85a2a2024-05-20 19:18:26 +020011041 n = searchit(curwin, curbuf, &pos, NULL, dir, pat, patlen, 1L,
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020011042 options, RE_SEARCH, &sia);
Bram Moolenaarb5aedf32017-03-12 18:23:53 +010011043 if (n == FAIL || (firstpos.lnum != 0 && EQUAL_POS(pos, firstpos)))
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011044 // didn't find it or found the first match again: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011045 break;
11046
11047 if (firstpos.lnum == 0)
11048 firstpos = pos;
Bram Moolenaarb5aedf32017-03-12 18:23:53 +010011049 if (EQUAL_POS(pos, foundpos))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011050 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011051 // Found the same position again. Can happen with a pattern that
11052 // has "\zs" at the end and searching backwards. Advance one
11053 // character and try again.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011054 if (dir == BACKWARD)
11055 decl(&pos);
11056 else
11057 incl(&pos);
11058 }
11059 foundpos = pos;
11060
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011061 // clear the start flag to avoid getting stuck here
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011062 options &= ~SEARCH_START;
11063
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011064 // If the skip pattern matches, ignore this match.
Bram Moolenaar48570482017-10-30 21:48:41 +010011065 if (use_skip)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011066 {
11067 save_pos = curwin->w_cursor;
11068 curwin->w_cursor = pos;
Bram Moolenaar48570482017-10-30 21:48:41 +010011069 err = FALSE;
11070 r = eval_expr_to_bool(skip, &err);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011071 curwin->w_cursor = save_pos;
11072 if (err)
11073 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011074 // Evaluating {skip} caused an error, break here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011075 curwin->w_cursor = save_cursor;
11076 retval = -1;
11077 break;
11078 }
11079 if (r)
11080 continue;
11081 }
11082
11083 if ((dir == BACKWARD && n == 3) || (dir == FORWARD && n == 2))
11084 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011085 // Found end when searching backwards or start when searching
11086 // forward: nested pair.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011087 ++nest;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011088 pat = pat2; // nested, don't search for middle
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011089 }
11090 else
11091 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011092 // Found end when searching forward or start when searching
11093 // backward: end of (nested) pair; or found middle in outer pair.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011094 if (--nest == 1)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011095 pat = pat3; // outer level, search for middle
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011096 }
11097
11098 if (nest == 0)
11099 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011100 // Found the match: return matchcount or line number.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011101 if (flags & SP_RETCOUNT)
11102 ++retval;
11103 else
11104 retval = pos.lnum;
11105 if (flags & SP_SETPCMARK)
11106 setpcmark();
11107 curwin->w_cursor = pos;
11108 if (!(flags & SP_REPEAT))
11109 break;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011110 nest = 1; // search for next unmatched
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011111 }
11112 }
11113
11114 if (match_pos != NULL)
11115 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011116 // Store the match cursor position
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011117 match_pos->lnum = curwin->w_cursor.lnum;
11118 match_pos->col = curwin->w_cursor.col + 1;
11119 }
11120
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011121 // If 'n' flag is used or search failed: restore cursor position.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011122 if ((flags & SP_NOMOVE) || retval == 0)
11123 curwin->w_cursor = save_cursor;
11124
11125theend:
Bram Moolenaar5ea38d12022-06-16 21:20:48 +010011126#ifdef FEAT_RELTIME
Bram Moolenaar0f618382022-08-26 21:33:04 +010011127 if (time_limit > 0)
11128 disable_regexp_timeout();
Bram Moolenaar5ea38d12022-06-16 21:20:48 +010011129#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011130 vim_free(pat2);
11131 vim_free(pat3);
11132 if (p_cpo == empty_option)
11133 p_cpo = save_cpo;
11134 else
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010011135 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011136 // Darn, evaluating the {skip} expression changed the value.
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010011137 // If it's still empty it was changed and restored, need to restore in
11138 // the complicated way.
11139 if (*p_cpo == NUL)
Bram Moolenaar31e5c602022-04-15 13:53:33 +010011140 set_option_value_give_err((char_u *)"cpo", 0L, save_cpo, 0);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011141 free_string_option(save_cpo);
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010011142 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011143
11144 return retval;
11145}
11146
11147/*
11148 * "searchpos()" function
11149 */
11150 static void
11151f_searchpos(typval_T *argvars, typval_T *rettv)
11152{
11153 pos_T match_pos;
11154 int lnum = 0;
11155 int col = 0;
11156 int n;
11157 int flags = 0;
11158
11159 if (rettv_list_alloc(rettv) == FAIL)
11160 return;
11161
11162 n = search_cmn(argvars, &match_pos, &flags);
11163 if (n > 0)
11164 {
11165 lnum = match_pos.lnum;
11166 col = match_pos.col;
11167 }
11168
11169 list_append_number(rettv->vval.v_list, (varnumber_T)lnum);
11170 list_append_number(rettv->vval.v_list, (varnumber_T)col);
11171 if (flags & SP_SUBPAT)
11172 list_append_number(rettv->vval.v_list, (varnumber_T)n);
11173}
11174
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011175/*
11176 * Set the cursor or mark position.
zeertzjq47eec672023-06-01 20:26:55 +010011177 * If "charpos" is TRUE, then use the column number as a character offset.
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011178 * Otherwise use the column number as a byte offset.
11179 */
11180 static void
11181set_position(typval_T *argvars, typval_T *rettv, int charpos)
11182{
11183 pos_T pos;
11184 int fnum;
11185 char_u *name;
11186 colnr_T curswant = -1;
11187
11188 rettv->vval.v_number = -1;
11189
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011190 if (in_vim9script()
11191 && (check_for_string_arg(argvars, 0) == FAIL
11192 || check_for_list_arg(argvars, 1) == FAIL))
11193 return;
11194
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011195 name = tv_get_string_chk(argvars);
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011196 if (name == NULL)
11197 return;
11198
11199 if (list2fpos(&argvars[1], &pos, &fnum, &curswant, charpos) != OK)
11200 return;
11201
11202 if (pos.col != MAXCOL && --pos.col < 0)
11203 pos.col = 0;
11204 if ((name[0] == '.' && name[1] == NUL))
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011205 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011206 // set cursor; "fnum" is ignored
11207 curwin->w_cursor = pos;
11208 if (curswant >= 0)
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011209 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011210 curwin->w_curswant = curswant - 1;
11211 curwin->w_set_curswant = FALSE;
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011212 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011213 check_cursor();
11214 rettv->vval.v_number = 0;
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011215 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011216 else if (name[0] == '\'' && name[1] != NUL && name[2] == NUL)
11217 {
11218 // set mark
11219 if (setmark_pos(name[1], &pos, fnum) == OK)
11220 rettv->vval.v_number = 0;
11221 }
11222 else
11223 emsg(_(e_invalid_argument));
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011224}
11225/*
11226 * "setcharpos()" function
11227 */
11228 static void
11229f_setcharpos(typval_T *argvars, typval_T *rettv)
11230{
11231 set_position(argvars, rettv, TRUE);
11232}
11233
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011234 static void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011235f_setcharsearch(typval_T *argvars, typval_T *rettv UNUSED)
11236{
11237 dict_T *d;
11238 dictitem_T *di;
11239 char_u *csearch;
11240
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +010011241 if (check_for_dict_arg(argvars, 0) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011242 return;
11243
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011244 if ((d = argvars[0].vval.v_dict) == NULL)
11245 return;
11246
11247 csearch = dict_get_string(d, "char", FALSE);
11248 if (csearch != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011249 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011250 if (enc_utf8)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011251 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011252 int pcc[MAX_MCO];
11253 int c = utfc_ptr2char(csearch, pcc);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011254
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011255 set_last_csearch(c, csearch, utfc_ptr2len(csearch));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011256 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011257 else
11258 set_last_csearch(PTR2CHAR(csearch),
11259 csearch, mb_ptr2len(csearch));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011260 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011261
11262 di = dict_find(d, (char_u *)"forward", -1);
11263 if (di != NULL)
11264 set_csearch_direction((int)tv_get_number(&di->di_tv)
11265 ? FORWARD : BACKWARD);
11266
11267 di = dict_find(d, (char_u *)"until", -1);
11268 if (di != NULL)
11269 set_csearch_until(!!tv_get_number(&di->di_tv));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011270}
11271
11272/*
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011273 * "setcursorcharpos" function
11274 */
11275 static void
Bram Moolenaar3af15ab2021-01-17 16:16:23 +010011276f_setcursorcharpos(typval_T *argvars, typval_T *rettv)
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011277{
11278 set_cursorpos(argvars, rettv, TRUE);
11279}
11280
11281/*
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011282 * "setenv()" function
11283 */
11284 static void
11285f_setenv(typval_T *argvars, typval_T *rettv UNUSED)
11286{
11287 char_u namebuf[NUMBUFLEN];
11288 char_u valbuf[NUMBUFLEN];
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020011289 char_u *name;
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011290
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020011291 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11292 return;
11293
zeertzjqfcaeb3d2023-11-28 20:46:29 +010011294 // setting an environment variable may be dangerous, e.g. you could
Christian Brabandt6b89dd62023-10-26 22:14:17 +020011295 // setenv GCONV_PATH=/tmp and then have iconv() unexpectedly call
11296 // a shell command using some shared library:
11297 if (check_restricted() || check_secure())
11298 return;
11299
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020011300 name = tv_get_string_buf(&argvars[0], namebuf);
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011301 if (argvars[1].v_type == VAR_SPECIAL
11302 && argvars[1].vval.v_number == VVAL_NULL)
LemonBoy77142312022-04-15 20:50:46 +010011303 vim_unsetenv_ext(name);
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011304 else
LemonBoy77142312022-04-15 20:50:46 +010011305 vim_setenv_ext(name, tv_get_string_buf(&argvars[1], valbuf));
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011306}
11307
11308/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011309 * "setfperm({fname}, {mode})" function
11310 */
11311 static void
11312f_setfperm(typval_T *argvars, typval_T *rettv)
11313{
11314 char_u *fname;
11315 char_u modebuf[NUMBUFLEN];
11316 char_u *mode_str;
11317 int i;
11318 int mask;
11319 int mode = 0;
11320
11321 rettv->vval.v_number = 0;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011322
11323 if (in_vim9script()
11324 && (check_for_string_arg(argvars, 0) == FAIL
11325 || check_for_string_arg(argvars, 1) == FAIL))
11326 return;
11327
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011328 fname = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011329 if (fname == NULL)
11330 return;
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011331 mode_str = tv_get_string_buf_chk(&argvars[1], modebuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011332 if (mode_str == NULL)
11333 return;
11334 if (STRLEN(mode_str) != 9)
11335 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000011336 semsg(_(e_invalid_argument_str), mode_str);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011337 return;
11338 }
11339
11340 mask = 1;
11341 for (i = 8; i >= 0; --i)
11342 {
11343 if (mode_str[i] != '-')
11344 mode |= mask;
11345 mask = mask << 1;
11346 }
11347 rettv->vval.v_number = mch_setperm(fname, mode) == OK;
11348}
11349
11350/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011351 * "setpos()" function
11352 */
11353 static void
11354f_setpos(typval_T *argvars, typval_T *rettv)
11355{
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011356 set_position(argvars, rettv, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011357}
11358
11359/*
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011360 * Translate a register type string to the yank type and block length
11361 */
11362 static int
11363get_yank_type(char_u **pp, char_u *yank_type, long *block_len)
11364{
11365 char_u *stropt = *pp;
11366 switch (*stropt)
11367 {
11368 case 'v': case 'c': // character-wise selection
11369 *yank_type = MCHAR;
11370 break;
11371 case 'V': case 'l': // line-wise selection
11372 *yank_type = MLINE;
11373 break;
11374 case 'b': case Ctrl_V: // block-wise selection
11375 *yank_type = MBLOCK;
11376 if (VIM_ISDIGIT(stropt[1]))
11377 {
11378 ++stropt;
11379 *block_len = getdigits(&stropt) - 1;
11380 --stropt;
11381 }
11382 break;
11383 default:
11384 return FAIL;
11385 }
11386 *pp = stropt;
11387 return OK;
11388}
11389
11390/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011391 * "setreg()" function
11392 */
11393 static void
11394f_setreg(typval_T *argvars, typval_T *rettv)
11395{
11396 int regname;
11397 char_u *strregname;
11398 char_u *stropt;
11399 char_u *strval;
11400 int append;
11401 char_u yank_type;
11402 long block_len;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011403 typval_T *regcontents;
11404 int pointreg;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011405
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020011406 if (in_vim9script()
11407 && (check_for_string_arg(argvars, 0) == FAIL
11408 || check_for_opt_string_arg(argvars, 2) == FAIL))
11409 return;
11410
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011411 pointreg = 0;
11412 regcontents = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011413 block_len = -1;
11414 yank_type = MAUTO;
11415 append = FALSE;
11416
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011417 strregname = tv_get_string_chk(argvars);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011418 rettv->vval.v_number = 1; // FAIL is default
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011419
11420 if (strregname == NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011421 return; // type error; errmsg already given
Bram Moolenaar418a29f2021-02-10 22:23:41 +010011422 if (in_vim9script() && STRLEN(strregname) > 1)
11423 {
11424 semsg(_(e_register_name_must_be_one_char_str), strregname);
11425 return;
11426 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011427 regname = *strregname;
11428 if (regname == 0 || regname == '@')
11429 regname = '"';
11430
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011431 if (argvars[1].v_type == VAR_DICT)
11432 {
11433 dict_T *d = argvars[1].vval.v_dict;
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011434 dictitem_T *di;
11435
11436 if (d == NULL || d->dv_hashtab.ht_used == 0)
11437 {
11438 // Empty dict, clear the register (like setreg(0, []))
11439 char_u *lstval[2] = {NULL, NULL};
11440 write_reg_contents_lst(regname, lstval, 0, FALSE, MAUTO, -1);
11441 return;
11442 }
11443
11444 di = dict_find(d, (char_u *)"regcontents", -1);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011445 if (di != NULL)
11446 regcontents = &di->di_tv;
11447
Bram Moolenaard61efa52022-07-23 09:52:04 +010011448 stropt = dict_get_string(d, "regtype", FALSE);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011449 if (stropt != NULL)
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011450 {
11451 int ret = get_yank_type(&stropt, &yank_type, &block_len);
11452
11453 if (ret == FAIL || *++stropt != NUL)
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011454 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000011455 semsg(_(e_invalid_value_for_argument_str), "value");
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011456 return;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011457 }
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011458 }
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011459
11460 if (regname == '"')
11461 {
Bram Moolenaard61efa52022-07-23 09:52:04 +010011462 stropt = dict_get_string(d, "points_to", FALSE);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011463 if (stropt != NULL)
11464 {
11465 pointreg = *stropt;
11466 regname = pointreg;
11467 }
11468 }
Bram Moolenaard61efa52022-07-23 09:52:04 +010011469 else if (dict_get_bool(d, "isunnamed", -1) > 0)
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011470 pointreg = regname;
11471 }
11472 else
11473 regcontents = &argvars[1];
11474
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011475 if (argvars[2].v_type != VAR_UNKNOWN)
11476 {
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011477 if (yank_type != MAUTO)
11478 {
Bram Moolenaare1242042021-12-16 20:56:57 +000011479 semsg(_(e_too_many_arguments_for_function_str), "setreg");
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011480 return;
11481 }
11482
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011483 stropt = tv_get_string_chk(&argvars[2]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011484 if (stropt == NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011485 return; // type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011486 for (; *stropt != NUL; ++stropt)
11487 switch (*stropt)
11488 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011489 case 'a': case 'A': // append
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011490 append = TRUE;
11491 break;
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011492 default:
11493 get_yank_type(&stropt, &yank_type, &block_len);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011494 }
11495 }
11496
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011497 if (regcontents && regcontents->v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011498 {
11499 char_u **lstval;
11500 char_u **allocval;
11501 char_u buf[NUMBUFLEN];
11502 char_u **curval;
11503 char_u **curallocval;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011504 list_T *ll = regcontents->vval.v_list;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011505 listitem_T *li;
11506 int len;
11507
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011508 // If the list is NULL handle like an empty list.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011509 len = ll == NULL ? 0 : ll->lv_len;
11510
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011511 // First half: use for pointers to result lines; second half: use for
11512 // pointers to allocated copies.
Bram Moolenaarc799fe22019-05-28 23:08:19 +020011513 lstval = ALLOC_MULT(char_u *, (len + 1) * 2);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011514 if (lstval == NULL)
11515 return;
11516 curval = lstval;
11517 allocval = lstval + len + 2;
11518 curallocval = allocval;
11519
Bram Moolenaar50985eb2020-01-27 22:09:39 +010011520 if (ll != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011521 {
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020011522 CHECK_LIST_MATERIALIZE(ll);
Bram Moolenaar00d253e2020-04-06 22:13:01 +020011523 FOR_ALL_LIST_ITEMS(ll, li)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011524 {
Bram Moolenaar50985eb2020-01-27 22:09:39 +010011525 strval = tv_get_string_buf_chk(&li->li_tv, buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011526 if (strval == NULL)
11527 goto free_lstval;
Bram Moolenaar50985eb2020-01-27 22:09:39 +010011528 if (strval == buf)
11529 {
11530 // Need to make a copy, next tv_get_string_buf_chk() will
11531 // overwrite the string.
11532 strval = vim_strsave(buf);
11533 if (strval == NULL)
11534 goto free_lstval;
11535 *curallocval++ = strval;
11536 }
11537 *curval++ = strval;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011538 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011539 }
11540 *curval++ = NULL;
11541
11542 write_reg_contents_lst(regname, lstval, -1,
11543 append, yank_type, block_len);
11544free_lstval:
11545 while (curallocval > allocval)
11546 vim_free(*--curallocval);
11547 vim_free(lstval);
11548 }
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011549 else if (regcontents)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011550 {
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011551 strval = tv_get_string_chk(regcontents);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011552 if (strval == NULL)
11553 return;
11554 write_reg_contents_ex(regname, strval, -1,
11555 append, yank_type, block_len);
11556 }
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011557 if (pointreg != 0)
11558 get_yank_register(pointreg, TRUE);
11559
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011560 rettv->vval.v_number = 0;
11561}
11562
11563/*
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011564 * "settagstack()" function
11565 */
11566 static void
11567f_settagstack(typval_T *argvars, typval_T *rettv)
11568{
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011569 win_T *wp;
11570 dict_T *d;
11571 int action = 'r';
11572
11573 rettv->vval.v_number = -1;
11574
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011575 if (in_vim9script()
11576 && (check_for_number_arg(argvars, 0) == FAIL
11577 || check_for_dict_arg(argvars, 1) == FAIL
11578 || check_for_opt_string_arg(argvars, 2) == FAIL))
11579 return;
11580
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011581 // first argument: window number or id
11582 wp = find_win_by_nr_or_id(&argvars[0]);
11583 if (wp == NULL)
11584 return;
11585
11586 // second argument: dict with items to set in the tag stack
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +010011587 if (check_for_dict_arg(argvars, 1) == FAIL)
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011588 return;
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011589 d = argvars[1].vval.v_dict;
11590 if (d == NULL)
11591 return;
11592
11593 // third argument: action - 'a' for append and 'r' for replace.
11594 // default is to replace the stack.
11595 if (argvars[2].v_type == VAR_UNKNOWN)
11596 action = 'r';
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +010011597 else if (check_for_string_arg(argvars, 2) == FAIL)
11598 return;
11599 else
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011600 {
11601 char_u *actstr;
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011602 actstr = tv_get_string_chk(&argvars[2]);
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011603 if (actstr == NULL)
11604 return;
Bram Moolenaar271fa082020-01-02 14:02:16 +010011605 if ((*actstr == 'r' || *actstr == 'a' || *actstr == 't')
11606 && actstr[1] == NUL)
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011607 action = *actstr;
11608 else
11609 {
Bram Moolenaard82a47d2022-01-05 20:24:39 +000011610 semsg(_(e_invalid_action_str_2), actstr);
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011611 return;
11612 }
11613 }
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011614
11615 if (set_tagstack(wp, d, action) == OK)
11616 rettv->vval.v_number = 0;
11617}
11618
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011619#ifdef FEAT_CRYPT
11620/*
11621 * "sha256({string})" function
11622 */
11623 static void
11624f_sha256(typval_T *argvars, typval_T *rettv)
11625{
11626 char_u *p;
11627
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011628 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11629 return;
11630
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011631 p = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011632 rettv->vval.v_string = vim_strsave(
11633 sha256_bytes(p, (int)STRLEN(p), NULL, 0));
11634 rettv->v_type = VAR_STRING;
11635}
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011636#endif // FEAT_CRYPT
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011637
11638/*
11639 * "shellescape({string})" function
11640 */
11641 static void
11642f_shellescape(typval_T *argvars, typval_T *rettv)
11643{
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011644 int do_special;
Bram Moolenaar20615522017-06-05 18:46:26 +020011645
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011646 if (in_vim9script()
11647 && (check_for_string_arg(argvars, 0) == FAIL
11648 || check_for_opt_bool_arg(argvars, 1) == FAIL))
11649 return;
11650
11651 do_special = non_zero_arg(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011652 rettv->vval.v_string = vim_strsave_shellescape(
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011653 tv_get_string(&argvars[0]), do_special, do_special);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011654 rettv->v_type = VAR_STRING;
11655}
11656
11657/*
11658 * shiftwidth() function
11659 */
11660 static void
11661f_shiftwidth(typval_T *argvars UNUSED, typval_T *rettv)
11662{
Bram Moolenaarf9514162018-11-22 03:08:29 +010011663 rettv->vval.v_number = 0;
11664
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011665 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
11666 return;
11667
Bram Moolenaarf9514162018-11-22 03:08:29 +010011668 if (argvars[0].v_type != VAR_UNKNOWN)
11669 {
11670 long col;
11671
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011672 col = (long)tv_get_number_chk(argvars, NULL);
Bram Moolenaarf9514162018-11-22 03:08:29 +010011673 if (col < 0)
11674 return; // type error; errmsg already given
11675#ifdef FEAT_VARTABS
Gary Johnson88d4f252024-06-01 20:51:33 +020011676 rettv->vval.v_number = get_sw_value_col(curbuf, col, FALSE);
Bram Moolenaarf9514162018-11-22 03:08:29 +010011677 return;
11678#endif
11679 }
11680
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011681 rettv->vval.v_number = get_sw_value(curbuf);
11682}
11683
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011684/*
11685 * "soundfold({word})" function
11686 */
11687 static void
11688f_soundfold(typval_T *argvars, typval_T *rettv)
11689{
11690 char_u *s;
11691
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011692 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11693 return;
11694
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011695 rettv->v_type = VAR_STRING;
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011696 s = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011697#ifdef FEAT_SPELL
11698 rettv->vval.v_string = eval_soundfold(s);
11699#else
11700 rettv->vval.v_string = vim_strsave(s);
11701#endif
11702}
11703
11704/*
11705 * "spellbadword()" function
11706 */
11707 static void
11708f_spellbadword(typval_T *argvars UNUSED, typval_T *rettv)
11709{
11710 char_u *word = (char_u *)"";
11711 hlf_T attr = HLF_COUNT;
11712 int len = 0;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011713#ifdef FEAT_SPELL
11714 int wo_spell_save = curwin->w_p_spell;
11715
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011716 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
11717 return;
11718
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011719 if (!curwin->w_p_spell)
11720 {
Yegappan Lakshmananaf936912023-02-20 12:16:39 +000011721 parse_spelllang(curwin);
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011722 curwin->w_p_spell = TRUE;
11723 }
11724
11725 if (*curwin->w_s->b_p_spl == NUL)
11726 {
Bram Moolenaar460ae5d2022-01-01 14:19:49 +000011727 emsg(_(e_spell_checking_is_not_possible));
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011728 curwin->w_p_spell = wo_spell_save;
11729 return;
11730 }
11731#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011732
11733 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011734 {
11735#ifdef FEAT_SPELL
11736 curwin->w_p_spell = wo_spell_save;
11737#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011738 return;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011739 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011740
11741#ifdef FEAT_SPELL
11742 if (argvars[0].v_type == VAR_UNKNOWN)
11743 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011744 // Find the start and length of the badly spelled word.
Christ van Willegen - van Noort8e4c4c72024-05-17 18:49:27 +020011745 len = spell_move_to(curwin, FORWARD, SMT_ALL, TRUE, &attr);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011746 if (len != 0)
Bram Moolenaarb73fa622017-12-21 20:27:47 +010011747 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011748 word = ml_get_cursor();
Bram Moolenaarb73fa622017-12-21 20:27:47 +010011749 curwin->w_set_curswant = TRUE;
11750 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011751 }
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011752 else if (*curbuf->b_s.b_p_spl != NUL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011753 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011754 char_u *str = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011755 int capcol = -1;
11756
11757 if (str != NULL)
11758 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011759 // Check the argument for spelling.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011760 while (*str != NUL)
11761 {
11762 len = spell_check(curwin, str, &attr, &capcol, FALSE);
11763 if (attr != HLF_COUNT)
11764 {
11765 word = str;
11766 break;
11767 }
11768 str += len;
Bram Moolenaar66ab9162018-07-20 20:28:48 +020011769 capcol -= len;
Bram Moolenaar0c779e82019-08-09 17:01:02 +020011770 len = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011771 }
11772 }
11773 }
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011774 curwin->w_p_spell = wo_spell_save;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011775#endif
11776
11777 list_append_string(rettv->vval.v_list, word, len);
11778 list_append_string(rettv->vval.v_list, (char_u *)(
11779 attr == HLF_SPB ? "bad" :
11780 attr == HLF_SPR ? "rare" :
11781 attr == HLF_SPL ? "local" :
11782 attr == HLF_SPC ? "caps" :
11783 ""), -1);
11784}
11785
11786/*
11787 * "spellsuggest()" function
11788 */
11789 static void
11790f_spellsuggest(typval_T *argvars UNUSED, typval_T *rettv)
11791{
11792#ifdef FEAT_SPELL
11793 char_u *str;
11794 int typeerr = FALSE;
11795 int maxcount;
11796 garray_T ga;
11797 int i;
11798 listitem_T *li;
11799 int need_capital = FALSE;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011800 int wo_spell_save = curwin->w_p_spell;
11801
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011802 if (in_vim9script()
11803 && (check_for_string_arg(argvars, 0) == FAIL
11804 || check_for_opt_number_arg(argvars, 1) == FAIL
11805 || (argvars[1].v_type != VAR_UNKNOWN
11806 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
11807 return;
11808
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011809 if (!curwin->w_p_spell)
11810 {
Yegappan Lakshmananaf936912023-02-20 12:16:39 +000011811 parse_spelllang(curwin);
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011812 curwin->w_p_spell = TRUE;
11813 }
11814
11815 if (*curwin->w_s->b_p_spl == NUL)
11816 {
Bram Moolenaar460ae5d2022-01-01 14:19:49 +000011817 emsg(_(e_spell_checking_is_not_possible));
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011818 curwin->w_p_spell = wo_spell_save;
11819 return;
11820 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011821#endif
11822
11823 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011824 {
11825#ifdef FEAT_SPELL
11826 curwin->w_p_spell = wo_spell_save;
11827#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011828 return;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011829 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011830
11831#ifdef FEAT_SPELL
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011832 str = tv_get_string(&argvars[0]);
11833 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011834 {
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011835 maxcount = (int)tv_get_number_chk(&argvars[1], &typeerr);
11836 if (maxcount <= 0)
11837 return;
11838 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011839 {
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011840 need_capital = (int)tv_get_bool_chk(&argvars[2], &typeerr);
11841 if (typeerr)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011842 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011843 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011844 }
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011845 else
11846 maxcount = 25;
11847
11848 spell_suggest_list(&ga, str, maxcount, need_capital, FALSE);
11849
11850 for (i = 0; i < ga.ga_len; ++i)
11851 {
11852 str = ((char_u **)ga.ga_data)[i];
11853
11854 li = listitem_alloc();
11855 if (li == NULL)
11856 vim_free(str);
11857 else
11858 {
11859 li->li_tv.v_type = VAR_STRING;
11860 li->li_tv.v_lock = 0;
11861 li->li_tv.vval.v_string = str;
11862 list_append(rettv->vval.v_list, li);
11863 }
11864 }
11865 ga_clear(&ga);
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011866 curwin->w_p_spell = wo_spell_save;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011867#endif
11868}
11869
11870 static void
11871f_split(typval_T *argvars, typval_T *rettv)
11872{
11873 char_u *str;
11874 char_u *end;
11875 char_u *pat = NULL;
11876 regmatch_T regmatch;
11877 char_u patbuf[NUMBUFLEN];
11878 char_u *save_cpo;
11879 int match;
11880 colnr_T col = 0;
11881 int keepempty = FALSE;
11882 int typeerr = FALSE;
11883
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011884 if (in_vim9script()
11885 && (check_for_string_arg(argvars, 0) == FAIL
11886 || check_for_opt_string_arg(argvars, 1) == FAIL
11887 || (argvars[1].v_type != VAR_UNKNOWN
11888 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
11889 return;
11890
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011891 // Make 'cpoptions' empty, the 'l' flag should not be used here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011892 save_cpo = p_cpo;
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010011893 p_cpo = empty_option;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011894
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011895 str = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011896 if (argvars[1].v_type != VAR_UNKNOWN)
11897 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011898 pat = tv_get_string_buf_chk(&argvars[1], patbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011899 if (pat == NULL)
11900 typeerr = TRUE;
11901 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar3986b942020-09-06 16:09:04 +020011902 keepempty = (int)tv_get_bool_chk(&argvars[2], &typeerr);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011903 }
11904 if (pat == NULL || *pat == NUL)
11905 pat = (char_u *)"[\\x01- ]\\+";
11906
11907 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar7d5e7442020-07-21 22:25:51 +020011908 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011909 if (typeerr)
Bram Moolenaar7d5e7442020-07-21 22:25:51 +020011910 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011911
11912 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
11913 if (regmatch.regprog != NULL)
11914 {
11915 regmatch.rm_ic = FALSE;
11916 while (*str != NUL || keepempty)
11917 {
11918 if (*str == NUL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011919 match = FALSE; // empty item at the end
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011920 else
11921 match = vim_regexec_nl(&regmatch, str, col);
11922 if (match)
11923 end = regmatch.startp[0];
11924 else
11925 end = str + STRLEN(str);
11926 if (keepempty || end > str || (rettv->vval.v_list->lv_len > 0
11927 && *str != NUL && match && end < regmatch.endp[0]))
11928 {
11929 if (list_append_string(rettv->vval.v_list, str,
11930 (int)(end - str)) == FAIL)
11931 break;
11932 }
11933 if (!match)
11934 break;
Bram Moolenaar13505972019-01-24 15:04:48 +010011935 // Advance to just after the match.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011936 if (regmatch.endp[0] > str)
11937 col = 0;
11938 else
Bram Moolenaar13505972019-01-24 15:04:48 +010011939 // Don't get stuck at the same match.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011940 col = (*mb_ptr2len)(regmatch.endp[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011941 str = regmatch.endp[0];
11942 }
11943
11944 vim_regfree(regmatch.regprog);
11945 }
11946
Bram Moolenaar7d5e7442020-07-21 22:25:51 +020011947theend:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011948 p_cpo = save_cpo;
11949}
11950
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011951/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011952 * "submatch()" function
11953 */
11954 static void
11955f_submatch(typval_T *argvars, typval_T *rettv)
11956{
11957 int error = FALSE;
11958 int no;
11959 int retList = 0;
11960
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011961 if (in_vim9script()
11962 && (check_for_number_arg(argvars, 0) == FAIL
11963 || check_for_opt_bool_arg(argvars, 1) == FAIL))
11964 return;
11965
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011966 no = (int)tv_get_number_chk(&argvars[0], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011967 if (error)
11968 return;
Bram Moolenaar989f5922016-08-21 15:26:54 +020011969 if (no < 0 || no >= NSUBEXP)
11970 {
Bram Moolenaard82a47d2022-01-05 20:24:39 +000011971 semsg(_(e_invalid_submatch_number_nr), no);
Bram Moolenaar79518e22017-02-17 16:31:35 +010011972 return;
Bram Moolenaar989f5922016-08-21 15:26:54 +020011973 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011974 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaarad304702020-09-06 18:22:53 +020011975 retList = (int)tv_get_bool_chk(&argvars[1], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011976 if (error)
11977 return;
11978
11979 if (retList == 0)
11980 {
11981 rettv->v_type = VAR_STRING;
11982 rettv->vval.v_string = reg_submatch(no);
11983 }
11984 else
11985 {
11986 rettv->v_type = VAR_LIST;
11987 rettv->vval.v_list = reg_submatch_list(no);
11988 }
11989}
11990
11991/*
11992 * "substitute()" function
11993 */
11994 static void
11995f_substitute(typval_T *argvars, typval_T *rettv)
11996{
11997 char_u patbuf[NUMBUFLEN];
11998 char_u subbuf[NUMBUFLEN];
11999 char_u flagsbuf[NUMBUFLEN];
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +020012000 char_u *str;
12001 char_u *pat;
Bram Moolenaar72ab7292016-07-19 19:10:51 +020012002 char_u *sub = NULL;
12003 typval_T *expr = NULL;
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +020012004 char_u *flg;
12005
12006 if (in_vim9script()
12007 && (check_for_string_arg(argvars, 0) == FAIL
12008 || check_for_string_arg(argvars, 1) == FAIL
12009 || check_for_string_arg(argvars, 3) == FAIL))
12010 return;
12011
12012 str = tv_get_string_chk(&argvars[0]);
12013 pat = tv_get_string_buf_chk(&argvars[1], patbuf);
12014 flg = tv_get_string_buf_chk(&argvars[3], flagsbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012015
LemonBoyf3b48952022-05-05 13:53:03 +010012016 if (argvars[2].v_type == VAR_FUNC
12017 || argvars[2].v_type == VAR_PARTIAL
Bram Moolenaar00b28d62022-12-08 15:32:33 +000012018 || argvars[2].v_type == VAR_INSTR
12019 || argvars[2].v_type == VAR_CLASS
12020 || argvars[2].v_type == VAR_OBJECT)
Bram Moolenaar72ab7292016-07-19 19:10:51 +020012021 expr = &argvars[2];
12022 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012023 sub = tv_get_string_buf_chk(&argvars[2], subbuf);
Bram Moolenaar72ab7292016-07-19 19:10:51 +020012024
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012025 rettv->v_type = VAR_STRING;
Bram Moolenaar72ab7292016-07-19 19:10:51 +020012026 if (str == NULL || pat == NULL || (sub == NULL && expr == NULL)
12027 || flg == NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012028 rettv->vval.v_string = NULL;
12029 else
John Marriottbd4614f2024-11-18 20:25:21 +010012030 rettv->vval.v_string = do_string_sub(str, STRLEN(str), pat, sub, expr, flg, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012031}
12032
12033/*
Bram Moolenaarc216a7a2022-12-05 13:50:55 +000012034 * "swapfilelist()" function
12035 */
12036 static void
12037f_swapfilelist(typval_T *argvars UNUSED, typval_T *rettv)
12038{
12039 if (rettv_list_alloc(rettv) == FAIL)
12040 return;
12041 recover_names(NULL, FALSE, rettv->vval.v_list, 0, NULL);
12042}
12043
12044/*
Bram Moolenaar00f123a2018-08-21 20:28:54 +020012045 * "swapinfo(swap_filename)" function
12046 */
12047 static void
12048f_swapinfo(typval_T *argvars, typval_T *rettv)
12049{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012050 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
12051 return;
12052
Bram Moolenaar00f123a2018-08-21 20:28:54 +020012053 if (rettv_dict_alloc(rettv) == OK)
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012054 get_b0_dict(tv_get_string(argvars), rettv->vval.v_dict);
Bram Moolenaar00f123a2018-08-21 20:28:54 +020012055}
12056
12057/*
Bram Moolenaar110bd602018-09-16 18:46:59 +020012058 * "swapname(expr)" function
12059 */
12060 static void
12061f_swapname(typval_T *argvars, typval_T *rettv)
12062{
12063 buf_T *buf;
12064
12065 rettv->v_type = VAR_STRING;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012066
12067 if (in_vim9script() && check_for_buffer_arg(argvars, 0) == FAIL)
12068 return;
12069
Bram Moolenaarf2d79fa2019-01-03 22:19:27 +010012070 buf = tv_get_buf(&argvars[0], FALSE);
Bram Moolenaar110bd602018-09-16 18:46:59 +020012071 if (buf == NULL || buf->b_ml.ml_mfp == NULL
12072 || buf->b_ml.ml_mfp->mf_fname == NULL)
12073 rettv->vval.v_string = NULL;
12074 else
12075 rettv->vval.v_string = vim_strsave(buf->b_ml.ml_mfp->mf_fname);
12076}
12077
12078/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012079 * "synID(lnum, col, trans)" function
12080 */
12081 static void
12082f_synID(typval_T *argvars UNUSED, typval_T *rettv)
12083{
12084 int id = 0;
12085#ifdef FEAT_SYN_HL
12086 linenr_T lnum;
12087 colnr_T col;
12088 int trans;
12089 int transerr = FALSE;
12090
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020012091 if (in_vim9script()
Yegappan Lakshmanancd917202021-07-21 19:09:09 +020012092 && (check_for_lnum_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020012093 || check_for_number_arg(argvars, 1) == FAIL
12094 || check_for_bool_arg(argvars, 2) == FAIL))
12095 return;
12096
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012097 lnum = tv_get_lnum(argvars); // -1 on type error
12098 col = (linenr_T)tv_get_number(&argvars[1]) - 1; // -1 on type error
Bram Moolenaarfcb6d702020-09-05 21:41:56 +020012099 trans = (int)tv_get_bool_chk(&argvars[2], &transerr);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012100
12101 if (!transerr && lnum >= 1 && lnum <= curbuf->b_ml.ml_line_count
John Marriottbfcc8952024-03-11 22:04:45 +010012102 && col >= 0 && col < (long)ml_get_len(lnum))
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +000012103 id = syn_get_id(curwin, lnum, col, trans, NULL, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012104#endif
12105
12106 rettv->vval.v_number = id;
12107}
12108
12109/*
12110 * "synIDattr(id, what [, mode])" function
12111 */
12112 static void
12113f_synIDattr(typval_T *argvars UNUSED, typval_T *rettv)
12114{
12115 char_u *p = NULL;
12116#ifdef FEAT_SYN_HL
12117 int id;
12118 char_u *what;
12119 char_u *mode;
12120 char_u modebuf[NUMBUFLEN];
12121 int modec;
12122
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +020012123 if (in_vim9script()
12124 && (check_for_number_arg(argvars, 0) == FAIL
Yegappan Lakshmananf8dbd582021-09-26 19:04:05 +010012125 || check_for_string_arg(argvars, 1) == FAIL
12126 || check_for_opt_string_arg(argvars, 2) == FAIL))
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +020012127 return;
12128
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012129 id = (int)tv_get_number(&argvars[0]);
12130 what = tv_get_string(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012131 if (argvars[2].v_type != VAR_UNKNOWN)
12132 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012133 mode = tv_get_string_buf(&argvars[2], modebuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012134 modec = TOLOWER_ASC(mode[0]);
12135 if (modec != 't' && modec != 'c' && modec != 'g')
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012136 modec = 0; // replace invalid with current
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012137 }
12138 else
12139 {
12140#if defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS)
12141 if (USE_24BIT)
12142 modec = 'g';
12143 else
12144#endif
12145 if (t_colors > 1)
Dominique Pelle4781d6f2021-05-18 21:46:31 +020012146 modec = 'c';
12147 else
12148 modec = 't';
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012149 }
12150
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012151 switch (TOLOWER_ASC(what[0]))
12152 {
12153 case 'b':
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012154 if (TOLOWER_ASC(what[1]) == 'g') // bg[#]
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012155 p = highlight_color(id, what, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012156 else // bold
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012157 p = highlight_has_attr(id, HL_BOLD, modec);
12158 break;
12159
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012160 case 'f': // fg[#] or font
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012161 p = highlight_color(id, what, modec);
12162 break;
12163
12164 case 'i':
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012165 if (TOLOWER_ASC(what[1]) == 'n') // inverse
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012166 p = highlight_has_attr(id, HL_INVERSE, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012167 else // italic
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012168 p = highlight_has_attr(id, HL_ITALIC, modec);
12169 break;
12170
Martin Tournoijba43e762022-10-13 22:12:15 +010012171 case 'n':
Bram Moolenaarde786322022-07-30 14:56:17 +010012172 if (TOLOWER_ASC(what[1]) == 'o') // nocombine
12173 p = highlight_has_attr(id, HL_NOCOMBINE, modec);
12174 else // name
12175 p = get_highlight_name_ext(NULL, id - 1, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012176 break;
12177
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012178 case 'r': // reverse
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012179 p = highlight_has_attr(id, HL_INVERSE, modec);
12180 break;
12181
12182 case 's':
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012183 if (TOLOWER_ASC(what[1]) == 'p') // sp[#]
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012184 p = highlight_color(id, what, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012185 // strikeout
Bram Moolenaarcf4b00c2017-09-02 18:33:56 +020012186 else if (TOLOWER_ASC(what[1]) == 't' &&
12187 TOLOWER_ASC(what[2]) == 'r')
12188 p = highlight_has_attr(id, HL_STRIKETHROUGH, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012189 else // standout
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012190 p = highlight_has_attr(id, HL_STANDOUT, modec);
12191 break;
12192
12193 case 'u':
Bram Moolenaar84f54632022-06-29 18:39:11 +010012194 if (STRLEN(what) >= 9)
12195 {
12196 if (TOLOWER_ASC(what[5]) == 'l')
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012197 // underline
Bram Moolenaar84f54632022-06-29 18:39:11 +010012198 p = highlight_has_attr(id, HL_UNDERLINE, modec);
12199 else if (TOLOWER_ASC(what[5]) != 'd')
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012200 // undercurl
Bram Moolenaar84f54632022-06-29 18:39:11 +010012201 p = highlight_has_attr(id, HL_UNDERCURL, modec);
12202 else if (TOLOWER_ASC(what[6]) != 'o')
12203 // underdashed
12204 p = highlight_has_attr(id, HL_UNDERDASHED, modec);
12205 else if (TOLOWER_ASC(what[7]) == 'u')
12206 // underdouble
12207 p = highlight_has_attr(id, HL_UNDERDOUBLE, modec);
12208 else
12209 // underdotted
12210 p = highlight_has_attr(id, HL_UNDERDOTTED, modec);
12211 }
12212 else
12213 // ul
12214 p = highlight_color(id, what, modec);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012215 break;
12216 }
12217
12218 if (p != NULL)
12219 p = vim_strsave(p);
12220#endif
12221 rettv->v_type = VAR_STRING;
12222 rettv->vval.v_string = p;
12223}
12224
12225/*
12226 * "synIDtrans(id)" function
12227 */
12228 static void
12229f_synIDtrans(typval_T *argvars UNUSED, typval_T *rettv)
12230{
12231 int id;
12232
12233#ifdef FEAT_SYN_HL
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012234 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
12235 return;
12236
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012237 id = (int)tv_get_number(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012238
12239 if (id > 0)
12240 id = syn_get_final_id(id);
12241 else
12242#endif
12243 id = 0;
12244
12245 rettv->vval.v_number = id;
12246}
12247
12248/*
12249 * "synconcealed(lnum, col)" function
12250 */
12251 static void
12252f_synconcealed(typval_T *argvars UNUSED, typval_T *rettv)
12253{
12254#if defined(FEAT_SYN_HL) && defined(FEAT_CONCEAL)
12255 linenr_T lnum;
12256 colnr_T col;
12257 int syntax_flags = 0;
12258 int cchar;
12259 int matchid = 0;
12260 char_u str[NUMBUFLEN];
12261#endif
12262
Bram Moolenaar45cf6e92017-04-30 20:25:19 +020012263 rettv_list_set(rettv, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012264
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020012265 if (in_vim9script()
Yegappan Lakshmanancd917202021-07-21 19:09:09 +020012266 && (check_for_lnum_arg(argvars, 0) == FAIL
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020012267 || check_for_number_arg(argvars, 1) == FAIL))
12268 return;
12269
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012270#if defined(FEAT_SYN_HL) && defined(FEAT_CONCEAL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012271 lnum = tv_get_lnum(argvars); // -1 on type error
12272 col = (colnr_T)tv_get_number(&argvars[1]) - 1; // -1 on type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012273
Bram Moolenaara80faa82020-04-12 19:37:17 +020012274 CLEAR_FIELD(str);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012275
Bram Moolenaar93a10962022-06-16 11:42:09 +010012276 if (rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012277 {
12278 if (lnum >= 1 && lnum <= curbuf->b_ml.ml_line_count
John Marriottbfcc8952024-03-11 22:04:45 +010012279 && col >= 0 && col <= (long)ml_get_len(lnum)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012280 && curwin->w_p_cole > 0)
12281 {
12282 (void)syn_get_id(curwin, lnum, col, FALSE, NULL, FALSE);
12283 syntax_flags = get_syntax_info(&matchid);
12284
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012285 // get the conceal character
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012286 if ((syntax_flags & HL_CONCEAL) && curwin->w_p_cole < 3)
12287 {
12288 cchar = syn_get_sub_char();
Bram Moolenaar4d785892017-06-22 22:00:50 +020012289 if (cchar == NUL && curwin->w_p_cole == 1)
Bram Moolenaareed9d462021-02-15 20:38:25 +010012290 cchar = (curwin->w_lcs_chars.conceal == NUL) ? ' '
12291 : curwin->w_lcs_chars.conceal;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012292 if (cchar != NUL)
12293 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012294 if (has_mbyte)
12295 (*mb_char2bytes)(cchar, str);
12296 else
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012297 str[0] = cchar;
12298 }
12299 }
12300 }
12301
12302 list_append_number(rettv->vval.v_list,
12303 (syntax_flags & HL_CONCEAL) != 0);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012304 // -1 to auto-determine strlen
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012305 list_append_string(rettv->vval.v_list, str, -1);
12306 list_append_number(rettv->vval.v_list, matchid);
12307 }
12308#endif
12309}
12310
12311/*
12312 * "synstack(lnum, col)" function
12313 */
12314 static void
12315f_synstack(typval_T *argvars UNUSED, typval_T *rettv)
12316{
12317#ifdef FEAT_SYN_HL
12318 linenr_T lnum;
12319 colnr_T col;
12320 int i;
12321 int id;
12322#endif
12323
Bram Moolenaar45cf6e92017-04-30 20:25:19 +020012324 rettv_list_set(rettv, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012325
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020012326 if (in_vim9script()
Yegappan Lakshmanancd917202021-07-21 19:09:09 +020012327 && (check_for_lnum_arg(argvars, 0) == FAIL
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020012328 || check_for_number_arg(argvars, 1) == FAIL))
12329 return;
12330
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012331#ifdef FEAT_SYN_HL
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012332 lnum = tv_get_lnum(argvars); // -1 on type error
12333 col = (colnr_T)tv_get_number(&argvars[1]) - 1; // -1 on type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012334
12335 if (lnum >= 1 && lnum <= curbuf->b_ml.ml_line_count
John Marriottbfcc8952024-03-11 22:04:45 +010012336 && col >= 0 && col <= (long)ml_get_len(lnum)
Bram Moolenaar93a10962022-06-16 11:42:09 +010012337 && rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012338 {
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +000012339 (void)syn_get_id(curwin, lnum, col, FALSE, NULL, TRUE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012340 for (i = 0; ; ++i)
12341 {
12342 id = syn_get_stack_item(i);
12343 if (id < 0)
12344 break;
12345 if (list_append_number(rettv->vval.v_list, id) == FAIL)
12346 break;
12347 }
12348 }
12349#endif
12350}
12351
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012352/*
12353 * "tabpagebuflist()" function
12354 */
12355 static void
12356f_tabpagebuflist(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
12357{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012358 tabpage_T *tp;
12359 win_T *wp = NULL;
12360
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012361 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
12362 return;
12363
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012364 if (argvars[0].v_type == VAR_UNKNOWN)
12365 wp = firstwin;
12366 else
12367 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012368 tp = find_tabpage((int)tv_get_number(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012369 if (tp != NULL)
12370 wp = (tp == curtab) ? firstwin : tp->tp_firstwin;
12371 }
Bram Moolenaar93a10962022-06-16 11:42:09 +010012372 if (wp != NULL && rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012373 {
12374 for (; wp != NULL; wp = wp->w_next)
12375 if (list_append_number(rettv->vval.v_list,
12376 wp->w_buffer->b_fnum) == FAIL)
12377 break;
12378 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012379}
12380
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012381/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012382 * "tagfiles()" function
12383 */
12384 static void
12385f_tagfiles(typval_T *argvars UNUSED, typval_T *rettv)
12386{
12387 char_u *fname;
12388 tagname_T tn;
12389 int first;
12390
12391 if (rettv_list_alloc(rettv) == FAIL)
12392 return;
12393 fname = alloc(MAXPATHL);
12394 if (fname == NULL)
12395 return;
12396
12397 for (first = TRUE; ; first = FALSE)
12398 if (get_tagfname(&tn, first, fname) == FAIL
12399 || list_append_string(rettv->vval.v_list, fname, -1) == FAIL)
12400 break;
12401 tagname_free(&tn);
12402 vim_free(fname);
12403}
12404
12405/*
12406 * "taglist()" function
12407 */
12408 static void
12409f_taglist(typval_T *argvars, typval_T *rettv)
12410{
Bram Moolenaarc6aafba2017-03-21 17:09:10 +010012411 char_u *fname = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012412 char_u *tag_pattern;
12413
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012414 if (in_vim9script()
12415 && (check_for_string_arg(argvars, 0) == FAIL
12416 || check_for_opt_string_arg(argvars, 1) == FAIL))
12417 return;
12418
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012419 tag_pattern = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012420
12421 rettv->vval.v_number = FALSE;
12422 if (*tag_pattern == NUL)
12423 return;
12424
Bram Moolenaarc6aafba2017-03-21 17:09:10 +010012425 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012426 fname = tv_get_string(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012427 if (rettv_list_alloc(rettv) == OK)
Bram Moolenaarc6aafba2017-03-21 17:09:10 +010012428 (void)get_tags(rettv->vval.v_list, tag_pattern, fname);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012429}
12430
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012431/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012432 * "type(expr)" function
12433 */
12434 static void
12435f_type(typval_T *argvars, typval_T *rettv)
12436{
12437 int n = -1;
12438
12439 switch (argvars[0].v_type)
12440 {
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +010012441 case VAR_NUMBER: n = VAR_TYPE_NUMBER; break;
12442 case VAR_STRING: n = VAR_TYPE_STRING; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012443 case VAR_PARTIAL:
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +010012444 case VAR_FUNC: n = VAR_TYPE_FUNC; break;
12445 case VAR_LIST: n = VAR_TYPE_LIST; break;
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010012446 case VAR_TUPLE: n = VAR_TYPE_TUPLE; break;
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +010012447 case VAR_DICT: n = VAR_TYPE_DICT; break;
12448 case VAR_FLOAT: n = VAR_TYPE_FLOAT; break;
12449 case VAR_BOOL: n = VAR_TYPE_BOOL; break;
12450 case VAR_SPECIAL: n = VAR_TYPE_NONE; break;
Bram Moolenaarf562e722016-07-19 17:25:25 +020012451 case VAR_JOB: n = VAR_TYPE_JOB; break;
12452 case VAR_CHANNEL: n = VAR_TYPE_CHANNEL; break;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +010012453 case VAR_BLOB: n = VAR_TYPE_BLOB; break;
Bram Moolenaarf18332f2021-05-07 17:55:55 +020012454 case VAR_INSTR: n = VAR_TYPE_INSTR; break;
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +020012455 case VAR_TYPEALIAS: n = VAR_TYPE_TYPEALIAS; break;
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012456 case VAR_CLASS:
12457 {
12458 class_T *cl = argvars[0].vval.v_class;
Yegappan Lakshmananda9d3452024-05-02 13:02:36 +020012459 if (cl != NULL && IS_ENUM(cl))
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012460 n = VAR_TYPE_ENUM;
12461 else
12462 n = VAR_TYPE_CLASS;
12463 break;
12464 }
12465 case VAR_OBJECT:
12466 {
Yegappan Lakshmananb2e42b92024-05-01 11:44:17 +020012467 object_T *obj = argvars[0].vval.v_object;
12468
12469 if (obj == NULL)
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012470 n = VAR_TYPE_OBJECT;
Yegappan Lakshmananb2e42b92024-05-01 11:44:17 +020012471 else
12472 {
12473 class_T *cl = argvars[0].vval.v_object->obj_class;
12474 if (IS_ENUM(cl))
12475 n = VAR_TYPE_ENUMVALUE;
12476 else
12477 n = VAR_TYPE_OBJECT;
12478 }
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012479 break;
12480 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012481 case VAR_UNKNOWN:
Bram Moolenaar4c683752020-04-05 21:38:23 +020012482 case VAR_ANY:
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010012483 case VAR_VOID:
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012484 internal_error_no_abort("f_type(UNKNOWN)");
12485 n = -1;
12486 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012487 }
12488 rettv->vval.v_number = n;
12489}
12490
12491/*
zeertzjq825cf812023-08-17 22:55:25 +020012492 * "virtcol({expr}, [, {list} [, {winid}]])" function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012493 */
12494 static void
12495f_virtcol(typval_T *argvars, typval_T *rettv)
12496{
LemonBoy0f7a3e12022-05-26 12:10:37 +010012497 colnr_T vcol_start = 0;
12498 colnr_T vcol_end = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012499 pos_T *fp;
zeertzjq825cf812023-08-17 22:55:25 +020012500 switchwin_T switchwin;
12501 int winchanged = FALSE;
Bram Moolenaarb3d33d82020-01-15 20:36:55 +010012502 int len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012503
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012504 if (in_vim9script()
LemonBoy0f7a3e12022-05-26 12:10:37 +010012505 && (check_for_string_or_list_arg(argvars, 0) == FAIL
12506 || (argvars[1].v_type != VAR_UNKNOWN
zeertzjq825cf812023-08-17 22:55:25 +020012507 && (check_for_bool_arg(argvars, 1) == FAIL
12508 || check_for_opt_number_arg(argvars, 2) == FAIL))))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012509 return;
12510
zeertzjq825cf812023-08-17 22:55:25 +020012511 if (argvars[1].v_type != VAR_UNKNOWN && argvars[2].v_type != VAR_UNKNOWN)
12512 {
12513 tabpage_T *tp;
12514 win_T *wp;
12515
12516 // use the window specified in the third argument
12517 wp = win_id2wp_tp((int)tv_get_number(&argvars[2]), &tp);
12518 if (wp == NULL || tp == NULL)
12519 goto theend;
12520
12521 if (switch_win_noblock(&switchwin, wp, tp, TRUE) != OK)
12522 goto theend;
12523
12524 check_cursor();
12525 winchanged = TRUE;
12526 }
12527
12528 int fnum = curbuf->b_fnum;
Bram Moolenaar6f02b002021-01-10 20:22:54 +010012529 fp = var2fpos(&argvars[0], FALSE, &fnum, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012530 if (fp != NULL && fp->lnum <= curbuf->b_ml.ml_line_count
LemonBoy0f7a3e12022-05-26 12:10:37 +010012531 && fnum == curbuf->b_fnum)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012532 {
Bram Moolenaarb3d33d82020-01-15 20:36:55 +010012533 // Limit the column to a valid value, getvvcol() doesn't check.
12534 if (fp->col < 0)
12535 fp->col = 0;
12536 else
12537 {
John Marriottbfcc8952024-03-11 22:04:45 +010012538 len = (int)ml_get_len(fp->lnum);
Bram Moolenaarb3d33d82020-01-15 20:36:55 +010012539 if (fp->col > len)
12540 fp->col = len;
12541 }
LemonBoy0f7a3e12022-05-26 12:10:37 +010012542 getvvcol(curwin, fp, &vcol_start, NULL, &vcol_end);
12543 ++vcol_start;
12544 ++vcol_end;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012545 }
12546
zeertzjq825cf812023-08-17 22:55:25 +020012547theend:
LemonBoy0f7a3e12022-05-26 12:10:37 +010012548 if (argvars[1].v_type != VAR_UNKNOWN && tv_get_bool(&argvars[1]))
12549 {
12550 if (rettv_list_alloc(rettv) == OK)
12551 {
12552 list_append_number(rettv->vval.v_list, vcol_start);
12553 list_append_number(rettv->vval.v_list, vcol_end);
12554 }
12555 else
12556 rettv->vval.v_number = 0;
12557 }
12558 else
12559 rettv->vval.v_number = vcol_end;
zeertzjq825cf812023-08-17 22:55:25 +020012560
12561 if (winchanged)
12562 restore_win_noblock(&switchwin, TRUE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012563}
12564
12565/*
12566 * "visualmode()" function
12567 */
12568 static void
12569f_visualmode(typval_T *argvars, typval_T *rettv)
12570{
12571 char_u str[2];
12572
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012573 if (in_vim9script() && check_for_opt_bool_arg(argvars, 0) == FAIL)
12574 return;
12575
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012576 rettv->v_type = VAR_STRING;
12577 str[0] = curbuf->b_visual_mode_eval;
12578 str[1] = NUL;
12579 rettv->vval.v_string = vim_strsave(str);
12580
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012581 // A non-zero number or non-empty string argument: reset mode.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012582 if (non_zero_arg(&argvars[0]))
12583 curbuf->b_visual_mode_eval = NUL;
12584}
12585
12586/*
12587 * "wildmenumode()" function
12588 */
12589 static void
12590f_wildmenumode(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
12591{
Bram Moolenaar24959102022-05-07 20:01:16 +010012592 if (wild_menu_showing || ((State & MODE_CMDLINE) && cmdline_pum_active()))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012593 rettv->vval.v_number = 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012594}
12595
12596/*
Bram Moolenaar0c1e3742019-12-27 13:49:24 +010012597 * "windowsversion()" function
12598 */
12599 static void
12600f_windowsversion(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
12601{
12602 rettv->v_type = VAR_STRING;
12603 rettv->vval.v_string = vim_strsave((char_u *)windowsVersion);
12604}
12605
12606/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012607 * "wordcount()" function
12608 */
12609 static void
12610f_wordcount(typval_T *argvars UNUSED, typval_T *rettv)
12611{
12612 if (rettv_dict_alloc(rettv) == FAIL)
12613 return;
12614 cursor_pos_info(rettv->vval.v_dict);
12615}
12616
12617/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012618 * "xor(expr, expr)" function
12619 */
12620 static void
12621f_xor(typval_T *argvars, typval_T *rettv)
12622{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012623 if (in_vim9script()
12624 && (check_for_number_arg(argvars, 0) == FAIL
12625 || check_for_number_arg(argvars, 1) == FAIL))
12626 return;
12627
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012628 rettv->vval.v_number = tv_get_number_chk(&argvars[0], NULL)
12629 ^ tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012630}
12631
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012632#endif // FEAT_EVAL