blob: 76955a7ed0fafcf714db610ba6862cef653791f1 [file] [log] [blame]
Bram Moolenaaredf3f972016-08-29 22:49:24 +02001/* vi:set ts=8 sts=4 sw=4 noet:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002 *
3 * VIM - Vi IMproved by Bram Moolenaar
4 *
5 * Do ":help uganda" in Vim to read copying and usage conditions.
6 * Do ":help credits" in Vim to see a list of people who contributed.
7 * See README.txt for an overview of the Vim source code.
8 */
9
10/*
11 * evalfunc.c: Builtin functions
12 */
13#define USING_FLOAT_STUFF
14
15#include "vim.h"
16
17#if defined(FEAT_EVAL) || defined(PROTO)
18
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020019#ifdef VMS
20# include <float.h>
21#endif
22
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020023static void f_and(typval_T *argvars, typval_T *rettv);
Bram Moolenaar59716a22017-03-01 20:32:44 +010024#ifdef FEAT_BEVAL
Bram Moolenaarbe0a2592019-05-09 13:50:16 +020025static void f_balloon_gettext(typval_T *argvars, typval_T *rettv);
Bram Moolenaar59716a22017-03-01 20:32:44 +010026static void f_balloon_show(typval_T *argvars, typval_T *rettv);
Bram Moolenaar669a8282017-11-19 20:13:05 +010027# if defined(FEAT_BEVAL_TERM)
Bram Moolenaar246fe032017-11-19 19:56:27 +010028static void f_balloon_split(typval_T *argvars, typval_T *rettv);
Bram Moolenaar669a8282017-11-19 20:13:05 +010029# endif
Bram Moolenaar59716a22017-03-01 20:32:44 +010030#endif
Yegappan Lakshmanan810785c2024-12-30 10:29:44 +010031static void f_base64_encode(typval_T *argvars, typval_T *rettv);
32static void f_base64_decode(typval_T *argvars, typval_T *rettv);
Christ van Willegence0ef912024-06-20 23:41:59 +020033static void f_bindtextdomain(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020034static void f_byte2line(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020035static void f_call(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020036static void f_changenr(typval_T *argvars, typval_T *rettv);
37static void f_char2nr(typval_T *argvars, typval_T *rettv);
Bram Moolenaar6f02b002021-01-10 20:22:54 +010038static void f_charcol(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020039static void f_col(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020040static void f_confirm(typval_T *argvars, typval_T *rettv);
41static void f_copy(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020042static void f_cursor(typval_T *argsvars, typval_T *rettv);
Bram Moolenaar4f974752019-02-17 17:44:42 +010043#ifdef MSWIN
Bram Moolenaar4551c0a2018-06-20 22:38:21 +020044static void f_debugbreak(typval_T *argvars, typval_T *rettv);
45#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020046static void f_deepcopy(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020047static void f_did_filetype(typval_T *argvars, typval_T *rettv);
Bram Moolenaar4132eb52020-02-14 16:53:00 +010048static void f_echoraw(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020049static void f_empty(typval_T *argvars, typval_T *rettv);
Bram Moolenaar691ddee2019-05-09 14:52:41 +020050static void f_environ(typval_T *argvars, typval_T *rettv);
Bram Moolenaar80adaa82023-07-07 18:57:40 +010051static void f_err_teapot(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020052static void f_escape(typval_T *argvars, typval_T *rettv);
53static void f_eval(typval_T *argvars, typval_T *rettv);
54static void f_eventhandler(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020055static void f_execute(typval_T *argvars, typval_T *rettv);
Bram Moolenaar26735992021-08-08 14:43:22 +020056static void f_exists_compiled(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020057static void f_expand(typval_T *argvars, typval_T *rettv);
Bram Moolenaar80dad482019-06-09 17:22:31 +020058static void f_expandcmd(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020059static void f_feedkeys(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020060static void f_fnameescape(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020061static void f_foreground(typval_T *argvars, typval_T *rettv);
Bram Moolenaar437bafe2016-08-01 15:40:54 +020062static void f_funcref(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020063static void f_function(typval_T *argvars, typval_T *rettv);
64static void f_garbagecollect(typval_T *argvars, typval_T *rettv);
65static void f_get(typval_T *argvars, typval_T *rettv);
mikoto2000a73dfc22024-11-18 21:12:21 +010066static void f_getcellpixels(typval_T *argvars, typval_T *rettv);
Bram Moolenaar07ad8162018-02-13 13:59:59 +010067static void f_getchangelist(typval_T *argvars, typval_T *rettv);
Bram Moolenaar6f02b002021-01-10 20:22:54 +010068static void f_getcharpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020069static void f_getcharsearch(typval_T *argvars, typval_T *rettv);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +010070static void f_getcurpos(typval_T *argvars, typval_T *rettv);
71static void f_getcursorcharpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar691ddee2019-05-09 14:52:41 +020072static void f_getenv(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020073static void f_getfontname(typval_T *argvars, typval_T *rettv);
Bram Moolenaar4f505882018-02-10 21:06:32 +010074static void f_getjumplist(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020075static void f_getpid(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020076static void f_getpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020077static void f_getreg(typval_T *argvars, typval_T *rettv);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020078static void f_getreginfo(typval_T *argvars, typval_T *rettv);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +010079static void f_getregion(typval_T *argvars, typval_T *rettv);
Shougo Matsushitab4757e62024-05-07 20:49:24 +020080static void f_getregionpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020081static void f_getregtype(typval_T *argvars, typval_T *rettv);
Bram Moolenaarf49cc602018-11-11 15:21:05 +010082static void f_gettagstack(typval_T *argvars, typval_T *rettv);
Bram Moolenaar0b39c3f2020-08-30 15:52:10 +020083static void f_gettext(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020084static void f_haslocaldir(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020085static void f_hlID(typval_T *argvars, typval_T *rettv);
86static void f_hlexists(typval_T *argvars, typval_T *rettv);
87static void f_hostname(typval_T *argvars, typval_T *rettv);
Ernie Raelc8e158b2024-07-09 18:39:52 +020088static void f_id(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020089static void f_index(typval_T *argvars, typval_T *rettv);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +010090static void f_indexof(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020091static void f_input(typval_T *argvars, typval_T *rettv);
92static void f_inputdialog(typval_T *argvars, typval_T *rettv);
93static void f_inputlist(typval_T *argvars, typval_T *rettv);
94static void f_inputrestore(typval_T *argvars, typval_T *rettv);
95static void f_inputsave(typval_T *argvars, typval_T *rettv);
96static void f_inputsecret(typval_T *argvars, typval_T *rettv);
Bram Moolenaar67a2deb2019-11-25 00:05:32 +010097static void f_interrupt(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020098static void f_invert(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020099static void f_islocked(typval_T *argvars, typval_T *rettv);
zeertzjqcdc83932022-09-12 13:38:41 +0100100static void f_keytrans(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200101static void f_last_buffer_nr(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200102static void f_libcall(typval_T *argvars, typval_T *rettv);
103static void f_libcallnr(typval_T *argvars, typval_T *rettv);
104static void f_line(typval_T *argvars, typval_T *rettv);
105static void f_line2byte(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200106#ifdef FEAT_LUA
107static void f_luaeval(typval_T *argvars, typval_T *rettv);
108#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200109static void f_match(typval_T *argvars, typval_T *rettv);
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +0100110static void f_matchbufline(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200111static void f_matchend(typval_T *argvars, typval_T *rettv);
112static void f_matchlist(typval_T *argvars, typval_T *rettv);
113static void f_matchstr(typval_T *argvars, typval_T *rettv);
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +0100114static void f_matchstrlist(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200115static void f_matchstrpos(typval_T *argvars, typval_T *rettv);
116static void f_max(typval_T *argvars, typval_T *rettv);
117static void f_min(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200118#ifdef FEAT_MZSCHEME
119static void f_mzeval(typval_T *argvars, typval_T *rettv);
120#endif
121static void f_nextnonblank(typval_T *argvars, typval_T *rettv);
Christ van Willegenc0786752025-02-01 15:42:16 +0100122static void f_ngettext(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200123static void f_nr2char(typval_T *argvars, typval_T *rettv);
124static void f_or(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200125#ifdef FEAT_PERL
126static void f_perleval(typval_T *argvars, typval_T *rettv);
127#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200128static void f_prevnonblank(typval_T *argvars, typval_T *rettv);
129static void f_printf(typval_T *argvars, typval_T *rettv);
Bram Moolenaare9bd5722019-08-17 19:36:06 +0200130static void f_pum_getpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200131static void f_pumvisible(typval_T *argvars, typval_T *rettv);
132#ifdef FEAT_PYTHON3
133static void f_py3eval(typval_T *argvars, typval_T *rettv);
134#endif
135#ifdef FEAT_PYTHON
136static void f_pyeval(typval_T *argvars, typval_T *rettv);
137#endif
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +0100138#if defined(FEAT_PYTHON) || defined(FEAT_PYTHON3)
139static void f_pyxeval(typval_T *argvars, typval_T *rettv);
140#endif
Bram Moolenaar4f645c52020-02-08 16:40:39 +0100141static void f_test_srand_seed(typval_T *argvars, typval_T *rettv);
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +0100142static void f_rand(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200143static void f_range(typval_T *argvars, typval_T *rettv);
Bram Moolenaar0b6d9112018-05-22 20:35:17 +0200144static void f_reg_executing(typval_T *argvars, typval_T *rettv);
145static void f_reg_recording(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200146static void f_rename(typval_T *argvars, typval_T *rettv);
147static void f_repeat(typval_T *argvars, typval_T *rettv);
Bram Moolenaare99be0e2019-03-26 22:51:09 +0100148#ifdef FEAT_RUBY
149static void f_rubyeval(typval_T *argvars, typval_T *rettv);
150#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200151static void f_screenattr(typval_T *argvars, typval_T *rettv);
152static void f_screenchar(typval_T *argvars, typval_T *rettv);
Bram Moolenaar2912abb2019-03-29 14:16:42 +0100153static void f_screenchars(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200154static void f_screencol(typval_T *argvars, typval_T *rettv);
155static void f_screenrow(typval_T *argvars, typval_T *rettv);
Bram Moolenaar2912abb2019-03-29 14:16:42 +0100156static void f_screenstring(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200157static void f_search(typval_T *argvars, typval_T *rettv);
158static void f_searchdecl(typval_T *argvars, typval_T *rettv);
159static void f_searchpair(typval_T *argvars, typval_T *rettv);
160static void f_searchpairpos(typval_T *argvars, typval_T *rettv);
161static void f_searchpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar6f02b002021-01-10 20:22:54 +0100162static void f_setcharpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200163static void f_setcharsearch(typval_T *argvars, typval_T *rettv);
Bram Moolenaar6f02b002021-01-10 20:22:54 +0100164static void f_setcursorcharpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar691ddee2019-05-09 14:52:41 +0200165static void f_setenv(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200166static void f_setfperm(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200167static void f_setpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200168static void f_setreg(typval_T *argvars, typval_T *rettv);
Bram Moolenaarf49cc602018-11-11 15:21:05 +0100169static void f_settagstack(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200170#ifdef FEAT_CRYPT
171static void f_sha256(typval_T *argvars, typval_T *rettv);
Bram Moolenaarb005cd82019-09-04 15:54:55 +0200172#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200173static void f_shellescape(typval_T *argvars, typval_T *rettv);
174static void f_shiftwidth(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200175static void f_soundfold(typval_T *argvars, typval_T *rettv);
176static void f_spellbadword(typval_T *argvars, typval_T *rettv);
177static void f_spellsuggest(typval_T *argvars, typval_T *rettv);
178static void f_split(typval_T *argvars, typval_T *rettv);
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +0100179static void f_srand(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200180static void f_submatch(typval_T *argvars, typval_T *rettv);
181static void f_substitute(typval_T *argvars, typval_T *rettv);
Bram Moolenaarc216a7a2022-12-05 13:50:55 +0000182static void f_swapfilelist(typval_T *argvars, typval_T *rettv);
Bram Moolenaar00f123a2018-08-21 20:28:54 +0200183static void f_swapinfo(typval_T *argvars, typval_T *rettv);
Bram Moolenaar110bd602018-09-16 18:46:59 +0200184static void f_swapname(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200185static void f_synID(typval_T *argvars, typval_T *rettv);
186static void f_synIDattr(typval_T *argvars, typval_T *rettv);
187static void f_synIDtrans(typval_T *argvars, typval_T *rettv);
188static void f_synstack(typval_T *argvars, typval_T *rettv);
189static void f_synconcealed(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200190static void f_tabpagebuflist(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200191static void f_taglist(typval_T *argvars, typval_T *rettv);
192static void f_tagfiles(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200193static void f_type(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200194static void f_virtcol(typval_T *argvars, typval_T *rettv);
195static void f_visualmode(typval_T *argvars, typval_T *rettv);
196static void f_wildmenumode(typval_T *argvars, typval_T *rettv);
Bram Moolenaar0c1e3742019-12-27 13:49:24 +0100197static void f_windowsversion(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200198static void f_wordcount(typval_T *argvars, typval_T *rettv);
199static void f_xor(typval_T *argvars, typval_T *rettv);
200
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +0100201
Bram Moolenaar94738d82020-10-21 14:25:07 +0200202/*
203 * Functions that check the argument type of a builtin function.
204 * Each function returns FAIL and gives an error message if the type is wrong.
205 */
206
207// Context passed to an arg_ function.
208typedef struct {
Bram Moolenaarca174532020-10-21 16:42:22 +0200209 int arg_count; // actual argument count
Bram Moolenaar078a4612022-01-04 15:17:03 +0000210 type2_T *arg_types; // list of argument types
Bram Moolenaarca174532020-10-21 16:42:22 +0200211 int arg_idx; // current argument index (first arg is zero)
Bram Moolenaar351ead02021-01-16 16:07:01 +0100212 cctx_T *arg_cctx;
Bram Moolenaar94738d82020-10-21 14:25:07 +0200213} argcontext_T;
214
215// A function to check one argument type. The first argument is the type to
216// check. If needed, other argument types can be obtained with the context.
217// E.g. if "arg_idx" is 1, then (type - 1) is the first argument type.
Ernie Raela8f7f922023-12-14 20:17:04 +0100218// NOTE: Use "arg_any", not NULL, in funcentry_T.f_argcheck array
219// to accept an argument of any type.
Bram Moolenaar078a4612022-01-04 15:17:03 +0000220typedef int (*argcheck_T)(type_T *, type_T *, argcontext_T *);
Bram Moolenaar94738d82020-10-21 14:25:07 +0200221
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100222/*
Bram Moolenaar351ead02021-01-16 16:07:01 +0100223 * Call need_type() to check an argument type.
224 */
225 static int
226check_arg_type(
227 type_T *expected,
228 type_T *actual,
229 argcontext_T *context)
230{
Bram Moolenaarc6951a72022-12-29 20:56:24 +0000231 return need_type(actual, expected, FALSE,
Bram Moolenaar351ead02021-01-16 16:07:01 +0100232 context->arg_idx - context->arg_count, context->arg_idx + 1,
233 context->arg_cctx, FALSE, FALSE);
234}
235
236/*
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100237 * Call need_type() to check an argument type and that it is modifiable
238 */
239 static int
240check_arg_type_mod(
241 type_T *expected,
242 type_T *actual,
243 argcontext_T *context)
244{
Bram Moolenaarc6951a72022-12-29 20:56:24 +0000245 if (need_type(actual, expected, FALSE,
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100246 context->arg_idx - context->arg_count, context->arg_idx + 1,
247 context->arg_cctx, FALSE, FALSE) == FAIL)
248 return FAIL;
249 return arg_type_modifiable(actual, context->arg_idx + 1);
250}
251
252/*
Bram Moolenaarfa103972022-09-29 19:14:42 +0100253 * Give an error if "type" is a constant.
254 */
255 int
256arg_type_modifiable(type_T *type, int arg_idx)
257{
258 char *tofree;
259
260 if ((type->tt_flags & TTFLAG_CONST) == 0)
261 return OK;
262 semsg(_(e_argument_nr_trying_to_modify_const_str),
263 arg_idx, type_name(type, &tofree));
264 vim_free(tofree);
265 return FAIL;
266}
267
268/*
Ernie Raela8f7f922023-12-14 20:17:04 +0100269 * Return OK for any type unconditionally.
270 */
271 static int
272arg_any(type_T *type UNUSED,
273 type_T *decl_type UNUSED,
274 argcontext_T *context UNUSED)
275{
276 return OK;
277}
278
279/*
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100280 * Check "type" is a float or a number.
281 */
Bram Moolenaar94738d82020-10-21 14:25:07 +0200282 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000283arg_float_or_nr(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaar94738d82020-10-21 14:25:07 +0200284{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100285 if (type->tt_type == VAR_FLOAT
286 || type->tt_type == VAR_NUMBER
287 || type_any_or_unknown(type))
Bram Moolenaar94738d82020-10-21 14:25:07 +0200288 return OK;
289 arg_type_mismatch(&t_number, type, context->arg_idx + 1);
290 return FAIL;
291}
292
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100293/*
294 * Check "type" is a number.
295 */
Bram Moolenaarca174532020-10-21 16:42:22 +0200296 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000297arg_number(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarca174532020-10-21 16:42:22 +0200298{
Bram Moolenaar351ead02021-01-16 16:07:01 +0100299 return check_arg_type(&t_number, type, context);
Bram Moolenaarca174532020-10-21 16:42:22 +0200300}
301
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100302/*
LemonBoyafe04662023-08-23 21:08:11 +0200303 * Check "type" is an object.
304 */
305 static int
306arg_object(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
307{
Yegappan Lakshmananb49ad282023-08-27 19:08:40 +0200308 if (type->tt_type == VAR_OBJECT
309 || type_any_or_unknown(type))
310 return OK;
Yegappan Lakshmanande8f8f72025-04-01 20:43:36 +0200311 arg_type_mismatch(&t_object_any, type, context->arg_idx + 1);
Yegappan Lakshmananb49ad282023-08-27 19:08:40 +0200312 return FAIL;
LemonBoyafe04662023-08-23 21:08:11 +0200313}
314
315/*
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200316 * Check "type" is a dict of 'any'.
317 */
318 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000319arg_dict_any(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200320{
321 return check_arg_type(&t_dict_any, type, context);
322}
323
324/*
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +0200325 * Check "type" is a list of 'any'.
326 */
327 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000328arg_list_any(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +0200329{
330 return check_arg_type(&t_list_any, type, context);
331}
332
333/*
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100334 * Check "type" is a list of 'any' and modifiable
335 */
336 static int
337arg_list_any_mod(
338 type_T *type,
339 type_T *decl_type UNUSED,
340 argcontext_T *context)
341{
342 return check_arg_type_mod(&t_list_any, type, context);
343}
344
345/*
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200346 * Check "type" is a list of numbers.
347 */
348 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000349arg_list_number(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200350{
351 return check_arg_type(&t_list_number, type, context);
352}
353
354/*
355 * Check "type" is a list of strings.
356 */
357 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000358arg_list_string(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200359{
360 return check_arg_type(&t_list_string, type, context);
361}
362
363/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100364 * Check "type" is a tuple of 'any'.
365 */
366 static int
367arg_tuple_any(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
368{
369 return check_arg_type(&t_tuple_any, type, context);
370}
371
372/*
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100373 * Check "type" is a string.
374 */
375 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000376arg_string(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100377{
Bram Moolenaar351ead02021-01-16 16:07:01 +0100378 return check_arg_type(&t_string, type, context);
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100379}
380
381/*
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +0200382 * Check "type" is a blob
383 */
384 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000385arg_blob(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +0200386{
387 return check_arg_type(&t_blob, type, context);
388}
389
390/*
Bram Moolenaarf2b26bc2021-01-30 23:05:11 +0100391 * Check "type" is a bool or number 0 or 1.
392 */
393 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000394arg_bool(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarf2b26bc2021-01-30 23:05:11 +0100395{
Bram Moolenaarf2b26bc2021-01-30 23:05:11 +0100396 return check_arg_type(&t_bool, type, context);
397}
398
399/*
zeertzjqe0a2ab32025-02-02 09:14:35 +0100400 * Check "type" is a bool or a number.
401 */
402 static int
403arg_bool_or_nr(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
404{
405 if (type->tt_type == VAR_BOOL
406 || type->tt_type == VAR_NUMBER
407 || type_any_or_unknown(type))
408 return OK;
409 arg_type_mismatch(&t_number, type, context->arg_idx + 1);
410 return FAIL;
411}
412
413/*
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200414 * Check "type" is a list of 'any' or a blob.
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100415 */
Bram Moolenaarca174532020-10-21 16:42:22 +0200416 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000417arg_list_or_blob(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarca174532020-10-21 16:42:22 +0200418{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100419 if (type->tt_type == VAR_LIST
420 || type->tt_type == VAR_BLOB
421 || type_any_or_unknown(type))
Bram Moolenaarca174532020-10-21 16:42:22 +0200422 return OK;
423 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
424 return FAIL;
425}
426
427/*
Bram Moolenaarfa103972022-09-29 19:14:42 +0100428 * Check "type" is a modifiable list of 'any' or a blob.
429 */
430 static int
431arg_list_or_blob_mod(
432 type_T *type,
433 type_T *decl_type,
434 argcontext_T *context)
435{
436 if (arg_list_or_blob(type, decl_type, context) == FAIL)
437 return FAIL;
438 return arg_type_modifiable(type, context->arg_idx + 1);
439}
440
441/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100442 * Check "type" is a list of 'any' or a tuple.
443 */
444 static int
445arg_list_or_tuple(
446 type_T *type,
447 type_T *decl_type UNUSED,
448 argcontext_T *context)
449{
450 if (type->tt_type == VAR_LIST
451 || type->tt_type == VAR_TUPLE
452 || type_any_or_unknown(type))
453 return OK;
454 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
455 return FAIL;
456}
457
458
459/*
460 * Check "type" is a list of 'any', a tuple or a blob.
461 */
462 static int
463arg_list_or_tuple_or_blob(
464 type_T *type,
465 type_T *decl_type UNUSED,
466 argcontext_T *context)
467{
468 if (type->tt_type == VAR_LIST
469 || type->tt_type == VAR_TUPLE
470 || type->tt_type == VAR_BLOB
471 || type_any_or_unknown(type))
472 return OK;
473 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
474 return FAIL;
475}
476
477/*
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200478 * Check "type" is a string or a number
479 */
480 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000481arg_string_or_nr(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200482{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100483 if (type->tt_type == VAR_STRING
484 || type->tt_type == VAR_NUMBER
485 || type_any_or_unknown(type))
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200486 return OK;
487 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
488 return FAIL;
489}
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200490
491/*
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200492 * Check "type" is a buffer (string or a number)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200493 */
494 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000495arg_buffer(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200496{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100497 if (type->tt_type == VAR_STRING
498 || type->tt_type == VAR_NUMBER
499 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200500 return OK;
501 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
502 return FAIL;
503}
504
505/*
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200506 * Check "type" is a buffer or a dict of any
507 */
508 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100509arg_buffer_or_dict_any(
510 type_T *type,
511 type_T *decl_type UNUSED,
512 argcontext_T *context)
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200513{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100514 if (type->tt_type == VAR_STRING
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200515 || type->tt_type == VAR_NUMBER
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100516 || type->tt_type == VAR_DICT
517 || type_any_or_unknown(type))
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200518 return OK;
519 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
520 return FAIL;
521}
522
523/*
524 * Check "type" is a line (string or a number)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200525 */
526 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000527arg_lnum(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200528{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100529 if (type->tt_type == VAR_STRING
530 || type->tt_type == VAR_NUMBER
531 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200532 return OK;
533 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
534 return FAIL;
535}
536
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200537/*
Bram Moolenaarca81f0e2021-06-20 14:41:01 +0200538 * Check "type" is a string or a list of strings.
539 */
540 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100541arg_string_or_list_string(
542 type_T *type,
543 type_T *decl_type UNUSED,
544 argcontext_T *context)
Bram Moolenaarca81f0e2021-06-20 14:41:01 +0200545{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100546 if (type->tt_type == VAR_STRING
547 || type_any_or_unknown(type))
Bram Moolenaarca81f0e2021-06-20 14:41:01 +0200548 return OK;
549 if (type->tt_type != VAR_LIST)
550 {
551 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
552 return FAIL;
553 }
554 if (type->tt_member->tt_type == VAR_ANY
555 || type->tt_member->tt_type == VAR_STRING)
556 return OK;
557
558 arg_type_mismatch(&t_list_string, type, context->arg_idx + 1);
559 return FAIL;
560}
561
562/*
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200563 * Check "type" is a string or a list of 'any'
564 */
565 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100566arg_string_or_list_any(
567 type_T *type,
568 type_T *decl_type UNUSED,
569 argcontext_T *context)
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200570{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100571 if (type->tt_type == VAR_STRING
572 || type->tt_type == VAR_LIST
573 || type_any_or_unknown(type))
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200574 return OK;
575 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
576 return FAIL;
577}
578
579/*
Ernie Rael51d04d12022-05-04 15:40:22 +0100580 * Check "type" is a string or a dict of 'any'
581 */
582 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100583arg_string_or_dict_any(
584 type_T *type,
585 type_T *decl_type UNUSED,
586 argcontext_T *context)
Ernie Rael51d04d12022-05-04 15:40:22 +0100587{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100588 if (type->tt_type == VAR_STRING
589 || type->tt_type == VAR_DICT
590 || type_any_or_unknown(type))
Ernie Rael51d04d12022-05-04 15:40:22 +0100591 return OK;
592 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
593 return FAIL;
594}
595
596/*
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200597 * Check "type" is a string or a blob
598 */
599 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100600arg_string_or_blob(
601 type_T *type,
602 type_T *decl_type UNUSED,
603 argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200604{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100605 if (type->tt_type == VAR_STRING
606 || type->tt_type == VAR_BLOB
607 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200608 return OK;
609 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
610 return FAIL;
611}
612
613/*
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +0200614 * Check "type" is a list of 'any' or a dict of 'any'.
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100615 */
616 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000617arg_list_or_dict(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100618{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100619 if (type->tt_type == VAR_LIST
620 || type->tt_type == VAR_DICT
621 || type_any_or_unknown(type))
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100622 return OK;
623 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
624 return FAIL;
625}
626
627/*
Bram Moolenaarfa103972022-09-29 19:14:42 +0100628 * Check "type" is a list of 'any' or a dict of 'any'. And modifiable.
629 */
630 static int
631arg_list_or_dict_mod(
632 type_T *type,
633 type_T *decl_type,
634 argcontext_T *context)
635{
636 if (arg_list_or_dict(type, decl_type, context) == FAIL)
637 return FAIL;
638 return arg_type_modifiable(type, context->arg_idx + 1);
639}
640
641/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100642 * Check "type" is a list of 'any', a tuple of 'any' or dict of 'any'.
643 */
644 static int
645arg_list_or_tuple_or_dict(
646 type_T *type,
647 type_T *decl_type UNUSED,
648 argcontext_T *context)
649{
650 if (type->tt_type == VAR_LIST
651 || type->tt_type == VAR_TUPLE
652 || type->tt_type == VAR_DICT
653 || type_any_or_unknown(type))
654 return OK;
655 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
656 return FAIL;
657}
658
659/*
660 * Check "type" is a list of 'any', a dict of 'any' or a blob.
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100661 * Also check if "type" is modifiable.
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200662 */
663 static int
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100664arg_list_or_dict_or_blob_mod(
665 type_T *type,
666 type_T *decl_type UNUSED,
667 argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200668{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100669 if (type->tt_type == VAR_LIST
Bram Moolenaar59618fe2021-12-21 12:32:17 +0000670 || type->tt_type == VAR_DICT
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100671 || type->tt_type == VAR_BLOB
672 || type_any_or_unknown(type))
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100673 return arg_type_modifiable(type, context->arg_idx + 1);
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200674 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
675 return FAIL;
676}
677
678/*
Bram Moolenaar2d877592021-12-16 08:21:09 +0000679 * Check "type" is a list of 'any' or a dict of 'any' or a blob or a string.
680 */
681 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100682arg_list_or_dict_or_blob_or_string(
683 type_T *type,
684 type_T *decl_type UNUSED,
685 argcontext_T *context)
Bram Moolenaar2d877592021-12-16 08:21:09 +0000686{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100687 if (type->tt_type == VAR_LIST
Bram Moolenaar59618fe2021-12-21 12:32:17 +0000688 || type->tt_type == VAR_DICT
689 || type->tt_type == VAR_BLOB
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100690 || type->tt_type == VAR_STRING
691 || type_any_or_unknown(type))
Bram Moolenaar2d877592021-12-16 08:21:09 +0000692 return OK;
693 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
694 return FAIL;
695}
696
697/*
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100698 * Check "type" is a list of 'any' or a dict of 'any' or a blob or a string.
699 * Also check the value is modifiable.
700 */
701 static int
702arg_list_or_dict_or_blob_or_string_mod(
703 type_T *type,
704 type_T *decl_type,
705 argcontext_T *context)
706{
707 if (arg_list_or_dict_or_blob_or_string(type, decl_type, context) == FAIL)
708 return FAIL;
709 return arg_type_modifiable(type, context->arg_idx + 1);
710}
711
712/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100713 * Check "type" is a list of 'any', a tuple of 'any', a dict of 'any', a blob
714 * or a string.
715 */
716 static int
717arg_list_tuple_dict_blob_or_string(
718 type_T *type,
719 type_T *decl_type UNUSED,
720 argcontext_T *context)
721{
722 if (type->tt_type == VAR_LIST
723 || type->tt_type == VAR_TUPLE
724 || type->tt_type == VAR_DICT
725 || type->tt_type == VAR_BLOB
726 || type->tt_type == VAR_STRING
727 || type_any_or_unknown(type))
728 return OK;
729 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
730 return FAIL;
731}
732
733
734/*
Ernie Raele79e2072024-01-13 11:47:33 +0100735 * Check second argument of map(), filter(), foreach().
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000736 */
737 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100738check_map_filter_arg2(
739 type_T *type,
740 argcontext_T *context,
741 filtermap_T filtermap)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000742{
743 type_T *expected_member = NULL;
744 type_T *(args[2]);
Bram Moolenaarb1e32ac2023-02-21 12:38:51 +0000745 type_T t_func_exp = {VAR_FUNC, 2, 0, 0, NULL, NULL, args};
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000746
747 if (context->arg_types[0].type_curr->tt_type == VAR_LIST
748 || context->arg_types[0].type_curr->tt_type == VAR_DICT)
749 {
750 // Use the declared type if possible, so that an error is given if
751 // a declared list changes type, but not if a constant list changes
752 // type.
753 if (context->arg_types[0].type_decl->tt_type == VAR_LIST
754 || context->arg_types[0].type_decl->tt_type == VAR_DICT)
755 expected_member = context->arg_types[0].type_decl->tt_member;
756 else
757 expected_member = context->arg_types[0].type_curr->tt_member;
758 }
759 else if (context->arg_types[0].type_curr->tt_type == VAR_STRING)
760 expected_member = &t_string;
761 else if (context->arg_types[0].type_curr->tt_type == VAR_BLOB)
762 expected_member = &t_number;
763
764 args[0] = NULL;
765 args[1] = &t_unknown;
766 if (type->tt_argcount != -1)
767 {
768 if (!(type->tt_argcount == 2 || (type->tt_argcount == 1
769 && (type->tt_flags & TTFLAG_VARARGS))))
770 {
771 emsg(_(e_invalid_number_of_arguments));
772 return FAIL;
773 }
774 if (type->tt_flags & TTFLAG_VARARGS)
775 // check the argument types at runtime
776 t_func_exp.tt_argcount = -1;
777 else
778 {
779 if (context->arg_types[0].type_curr->tt_type == VAR_STRING
780 || context->arg_types[0].type_curr->tt_type == VAR_BLOB
781 || context->arg_types[0].type_curr->tt_type == VAR_LIST)
782 args[0] = &t_number;
783 else if (context->arg_types[0].type_decl->tt_type == VAR_DICT)
784 args[0] = &t_string;
785 if (args[0] != NULL)
786 args[1] = expected_member;
787 }
788 }
789
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100790 if (!type_any_or_unknown(type->tt_member) || args[0] != NULL)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000791 {
792 where_T where = WHERE_INIT;
793
Ernie Raele79e2072024-01-13 11:47:33 +0100794 if (filtermap == FILTERMAP_MAP)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000795 t_func_exp.tt_member = expected_member == NULL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100796 || type_any_or_unknown(type->tt_member)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000797 ? &t_any : expected_member;
Ernie Raele79e2072024-01-13 11:47:33 +0100798 else if (filtermap == FILTERMAP_FILTER)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000799 t_func_exp.tt_member = &t_bool;
Ernie Raele79e2072024-01-13 11:47:33 +0100800 else // filtermap == FILTERMAP_FOREACH
801 t_func_exp.tt_member = &t_unknown;
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000802 if (args[0] == NULL)
803 args[0] = &t_unknown;
Bram Moolenaar6e1a3872022-02-23 19:11:49 +0000804 if (type->tt_argcount == -1)
805 t_func_exp.tt_argcount = -1;
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000806
807 where.wt_index = 2;
LemonBoyc5d27442023-08-19 13:02:35 +0200808 where.wt_kind = WT_ARGUMENT;
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000809 return check_type(&t_func_exp, type, TRUE, where);
810 }
811 return OK;
812}
813
814/*
Bram Moolenaar18024052021-12-25 21:43:28 +0000815 * Check second argument of filter(): func must return a bool.
816 */
817 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000818arg_filter_func(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaar18024052021-12-25 21:43:28 +0000819{
Bram Moolenaar1080c482022-01-26 18:26:21 +0000820 if (type->tt_type == VAR_STRING
821 || type->tt_type == VAR_PARTIAL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100822 || type_any_or_unknown(type))
Bram Moolenaar1080c482022-01-26 18:26:21 +0000823 return OK;
824
825 if (type->tt_type == VAR_FUNC)
Ernie Raele79e2072024-01-13 11:47:33 +0100826 return check_map_filter_arg2(type, context, FILTERMAP_FILTER);
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000827 semsg(_(e_string_or_function_required_for_argument_nr), 2);
828 return FAIL;
Bram Moolenaar18024052021-12-25 21:43:28 +0000829}
830
831/*
Bram Moolenaareddd4fc2022-02-20 15:52:28 +0000832 * Check second argument of map(), the function.
Bram Moolenaar18024052021-12-25 21:43:28 +0000833 */
834 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000835arg_map_func(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaar18024052021-12-25 21:43:28 +0000836{
Bram Moolenaar1080c482022-01-26 18:26:21 +0000837 if (type->tt_type == VAR_STRING
838 || type->tt_type == VAR_PARTIAL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100839 || type_any_or_unknown(type))
Bram Moolenaar1080c482022-01-26 18:26:21 +0000840 return OK;
841
842 if (type->tt_type == VAR_FUNC)
Ernie Raele79e2072024-01-13 11:47:33 +0100843 return check_map_filter_arg2(type, context, FILTERMAP_MAP);
844 semsg(_(e_string_or_function_required_for_argument_nr), 2);
845 return FAIL;
846}
847
848/*
849 * Check second argument of foreach(), the function.
850 */
851 static int
852arg_foreach_func(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
853{
854 if (type->tt_type == VAR_STRING
855 || type->tt_type == VAR_PARTIAL
856 || type_any_or_unknown(type))
857 return OK;
858
859 if (type->tt_type == VAR_FUNC)
860 return check_map_filter_arg2(type, context, FILTERMAP_FOREACH);
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000861 semsg(_(e_string_or_function_required_for_argument_nr), 2);
862 return FAIL;
Bram Moolenaar18024052021-12-25 21:43:28 +0000863}
864
865/*
Bram Moolenaare843efc2022-02-22 21:54:44 +0000866 * Check second argument of sort() and uniq(), the "how" argument.
867 */
868 static int
869arg_sort_how(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
870{
871 if (type->tt_type == VAR_STRING
872 || type->tt_type == VAR_PARTIAL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100873 || type_any_or_unknown(type))
Bram Moolenaare843efc2022-02-22 21:54:44 +0000874 return OK;
875
876 if (type->tt_type == VAR_FUNC)
877 {
878 type_T *(args[2]);
Bram Moolenaarb1e32ac2023-02-21 12:38:51 +0000879 type_T t_func_exp = {VAR_FUNC, 2, 0, 0, &t_number, NULL, args};
Bram Moolenaare843efc2022-02-22 21:54:44 +0000880
881 if (context->arg_types[0].type_curr->tt_type == VAR_LIST)
882 args[0] = context->arg_types[0].type_curr->tt_member;
883 else
884 args[0] = &t_unknown;
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100885 if (!type_any_or_unknown(type->tt_member) || args[0] != &t_unknown)
Bram Moolenaare843efc2022-02-22 21:54:44 +0000886 {
887 where_T where = WHERE_INIT;
888
889 args[1] = args[0];
Bram Moolenaarfa026162022-02-23 21:03:32 +0000890 if (type->tt_argcount == -1)
891 t_func_exp.tt_argcount = -1;
Bram Moolenaare843efc2022-02-22 21:54:44 +0000892 where.wt_index = 2;
LemonBoyc5d27442023-08-19 13:02:35 +0200893 where.wt_kind = WT_ARGUMENT;
Bram Moolenaare843efc2022-02-22 21:54:44 +0000894 return check_type(&t_func_exp, type, TRUE, where);
895 }
896
897 return OK;
898 }
899 semsg(_(e_string_or_function_required_for_argument_nr), 2);
900 return FAIL;
901}
902
903/*
Bram Moolenaar73199812021-12-26 17:18:14 +0000904 * Check an expression argument, can be a string, funcref or partial.
905 * Also accept a bool, a constant resulting from compiling a string argument.
906 * Also accept a number, one and zero are accepted.
907 */
908 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100909arg_string_or_func(
910 type_T *type,
911 type_T *decl_type UNUSED,
912 argcontext_T *context)
Bram Moolenaar73199812021-12-26 17:18:14 +0000913{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100914 if (type->tt_type == VAR_STRING
Bram Moolenaar73199812021-12-26 17:18:14 +0000915 || type->tt_type == VAR_PARTIAL
916 || type->tt_type == VAR_FUNC
917 || type->tt_type == VAR_BOOL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100918 || type->tt_type == VAR_NUMBER
919 || type_any_or_unknown(type))
Bram Moolenaar73199812021-12-26 17:18:14 +0000920 return OK;
921 arg_type_mismatch(&t_func_any, type, context->arg_idx + 1);
922 return FAIL;
923}
924
925/*
Ernie Rael2025af12023-12-12 16:58:00 +0100926 * Check varargs' "type" are class.
LemonBoyafe04662023-08-23 21:08:11 +0200927 */
928 static int
Ernie Rael2025af12023-12-12 16:58:00 +0100929varargs_class(type_T *type UNUSED,
930 type_T *decl_type UNUSED,
931 argcontext_T *context)
LemonBoyafe04662023-08-23 21:08:11 +0200932{
Ernie Rael2025af12023-12-12 16:58:00 +0100933 for (int i = context->arg_idx; i < context->arg_count; ++i)
934 {
935 type2_T *types = &context->arg_types[i];
936 if (types->type_curr->tt_type != VAR_CLASS)
937 {
938 semsg(_(e_class_or_typealias_required_for_argument_nr), i + 1);
939 return FAIL;
940 }
941 }
942 return OK;
LemonBoyafe04662023-08-23 21:08:11 +0200943}
944
945/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100946 * Check "type" is a list of 'any', a tuple, a blob or a string.
rbtnn0ccb5842021-12-18 18:33:46 +0000947 */
948 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100949arg_string_list_tuple_or_blob(
950 type_T *type,
951 type_T *decl_type UNUSED,
952 argcontext_T *context)
rbtnn0ccb5842021-12-18 18:33:46 +0000953{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100954 if (type->tt_type == VAR_LIST
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100955 || type->tt_type == VAR_TUPLE
Bram Moolenaar59618fe2021-12-21 12:32:17 +0000956 || type->tt_type == VAR_BLOB
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100957 || type->tt_type == VAR_STRING
958 || type_any_or_unknown(type))
rbtnn0ccb5842021-12-18 18:33:46 +0000959 return OK;
960 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
961 return FAIL;
962}
963
964/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100965 * Check "type" is a tuple or a modifiable list of 'any' or a blob or a string.
Yegappan Lakshmananf9dc2782023-05-11 15:02:56 +0100966 */
967 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100968arg_reverse(type_T *type, type_T *decl_type, argcontext_T *context)
Yegappan Lakshmananf9dc2782023-05-11 15:02:56 +0100969{
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +0100970 if (arg_string_list_tuple_or_blob(type, decl_type, context) == FAIL)
Yegappan Lakshmananf9dc2782023-05-11 15:02:56 +0100971 return FAIL;
972 return arg_type_modifiable(type, context->arg_idx + 1);
973}
974
975/*
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +0200976 * Check "type" is a job.
977 */
978 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000979arg_job(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +0200980{
981 return check_arg_type(&t_job, type, context);
982}
983
984/*
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +0200985 * Check "type" is a channel or a job.
986 */
987 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000988arg_chan_or_job(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +0200989{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100990 if (type->tt_type == VAR_CHANNEL
991 || type->tt_type == VAR_JOB
992 || type_any_or_unknown(type))
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +0200993 return OK;
994 arg_type_mismatch(&t_channel, type, context->arg_idx + 1);
995 return FAIL;
996}
997
998/*
Bram Moolenaar078a4612022-01-04 15:17:03 +0000999 * Check "type" can be used as the type_decl of the previous argument.
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01001000 * Must not be used for the first argcheck_T entry.
1001 */
1002 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001003arg_same_as_prev(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01001004{
Bram Moolenaar078a4612022-01-04 15:17:03 +00001005 type_T *prev_type = context->arg_types[context->arg_idx - 1].type_decl;
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01001006
Bram Moolenaar351ead02021-01-16 16:07:01 +01001007 return check_arg_type(prev_type, type, context);
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01001008}
1009
1010/*
Bram Moolenaarb0e6b512021-01-12 20:23:40 +01001011 * Check "type" is the same basic type as the previous argument, checks list or
1012 * dict vs other type, but not member type.
1013 * Must not be used for the first argcheck_T entry.
1014 */
1015 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001016arg_same_struct_as_prev(
1017 type_T *type,
1018 type_T *decl_type UNUSED,
1019 argcontext_T *context)
Bram Moolenaarb0e6b512021-01-12 20:23:40 +01001020{
Bram Moolenaar078a4612022-01-04 15:17:03 +00001021 type_T *prev_type = context->arg_types[context->arg_idx - 1].type_curr;
Bram Moolenaarb0e6b512021-01-12 20:23:40 +01001022
Bram Moolenaar078a4612022-01-04 15:17:03 +00001023 if (prev_type->tt_type != context->arg_types[context->arg_idx].type_curr->tt_type)
Bram Moolenaar351ead02021-01-16 16:07:01 +01001024 return check_arg_type(prev_type, type, context);
Bram Moolenaarb0e6b512021-01-12 20:23:40 +01001025 return OK;
1026}
1027
1028/*
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01001029 * Check "type" is an item of the list or blob of the previous arg.
Bram Moolenaarca174532020-10-21 16:42:22 +02001030 * Must not be used for the first argcheck_T entry.
1031 */
1032 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001033arg_item_of_prev(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarca174532020-10-21 16:42:22 +02001034{
Bram Moolenaar078a4612022-01-04 15:17:03 +00001035 type_T *prev_type = context->arg_types[context->arg_idx - 1].type_curr;
Bram Moolenaarca174532020-10-21 16:42:22 +02001036 type_T *expected;
1037
1038 if (prev_type->tt_type == VAR_LIST)
1039 expected = prev_type->tt_member;
1040 else if (prev_type->tt_type == VAR_BLOB)
1041 expected = &t_number;
1042 else
1043 // probably VAR_ANY, can't check
1044 return OK;
1045
Bram Moolenaar351ead02021-01-16 16:07:01 +01001046 return check_arg_type(expected, type, context);
Bram Moolenaarca174532020-10-21 16:42:22 +02001047}
1048
Bram Moolenaar94738d82020-10-21 14:25:07 +02001049/*
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02001050 * Check "type" is a string or a number or a list
1051 */
1052 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001053arg_str_or_nr_or_list(
1054 type_T *type,
1055 type_T *decl_type UNUSED,
1056 argcontext_T *context)
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02001057{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001058 if (type->tt_type == VAR_STRING
Bram Moolenaar59618fe2021-12-21 12:32:17 +00001059 || type->tt_type == VAR_NUMBER
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001060 || type->tt_type == VAR_LIST
1061 || type_any_or_unknown(type))
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02001062 return OK;
1063 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
1064 return FAIL;
1065}
1066
1067/*
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001068 * Check "type" is a dict of 'any' or a string
1069 */
1070 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001071arg_dict_any_or_string(
1072 type_T *type,
1073 type_T *decl_type UNUSED,
1074 argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001075{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001076 if (type->tt_type == VAR_DICT
1077 || type->tt_type == VAR_STRING
1078 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001079 return OK;
1080 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
1081 return FAIL;
1082}
1083
1084/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001085 * Check "type" which is the third argument of extend() (number or string or
1086 * any)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01001087 */
1088 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001089arg_extend3(type_T *type, type_T *decl_type, argcontext_T *context)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01001090{
Bram Moolenaar078a4612022-01-04 15:17:03 +00001091 type_T *first_type = context->arg_types[context->arg_idx - 2].type_curr;
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01001092
1093 if (first_type->tt_type == VAR_LIST)
Bram Moolenaar078a4612022-01-04 15:17:03 +00001094 return arg_number(type, decl_type, context);
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01001095 if (first_type->tt_type == VAR_DICT)
Bram Moolenaar078a4612022-01-04 15:17:03 +00001096 return arg_string(type, decl_type, context);
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01001097 return OK;
1098}
1099
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001100/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001101 * Check "type" which is the first argument of get() (a blob, a list, a tuple,
1102 * a dict or a funcref)
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001103 */
1104 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001105arg_get1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001106{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001107 if (type->tt_type == VAR_BLOB
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001108 || type->tt_type == VAR_LIST
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001109 || type->tt_type == VAR_TUPLE
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001110 || type->tt_type == VAR_DICT
1111 || type->tt_type == VAR_FUNC
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001112 || type->tt_type == VAR_PARTIAL
1113 || type_any_or_unknown(type))
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001114 return OK;
1115
1116 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
1117 return FAIL;
1118}
1119
1120/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001121 * Check "type" which is the first argument of len() (a string, a number, a
1122 * blob, a list, a tuple, a dict or an object)
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001123 */
1124 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001125arg_len1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001126{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001127 if (type->tt_type == VAR_STRING
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001128 || type->tt_type == VAR_NUMBER
1129 || type->tt_type == VAR_BLOB
1130 || type->tt_type == VAR_LIST
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001131 || type->tt_type == VAR_TUPLE
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001132 || type->tt_type == VAR_DICT
Yegappan Lakshmanand3eae7b2024-03-03 16:26:58 +01001133 || type->tt_type == VAR_OBJECT
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001134 || type_any_or_unknown(type))
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001135 return OK;
1136
1137 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
1138 return FAIL;
1139}
1140
1141/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001142 * Check "type" which is the second argument of remove() (number or string or
1143 * any)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001144 */
1145 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001146arg_remove2(type_T *type, type_T *decl_type, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001147{
Bram Moolenaar078a4612022-01-04 15:17:03 +00001148 type_T *first_type = context->arg_types[context->arg_idx - 1].type_curr;
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001149
1150 if (first_type->tt_type == VAR_LIST || first_type->tt_type == VAR_BLOB)
Bram Moolenaar078a4612022-01-04 15:17:03 +00001151 return arg_number(type, decl_type, context);
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001152 if (first_type->tt_type == VAR_DICT)
Bram Moolenaar078a4612022-01-04 15:17:03 +00001153 return arg_string_or_nr(type, decl_type, context);
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001154 return OK;
1155}
1156
1157/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001158 * Check "type" which is the first argument of repeat() (a string, a number, a
1159 * blob, a list, a tuple or any)
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001160 */
1161 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001162arg_repeat1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001163{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001164 if (type->tt_type == VAR_STRING
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001165 || type->tt_type == VAR_NUMBER
Bakudankun375141e2022-09-09 18:46:47 +01001166 || type->tt_type == VAR_BLOB
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001167 || type->tt_type == VAR_LIST
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001168 || type->tt_type == VAR_TUPLE
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001169 || type_any_or_unknown(type))
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001170 return OK;
1171
1172 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
1173 return FAIL;
1174}
1175
1176/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001177 * Check "type" which is the first argument of slice() (a list, a tuple, a
1178 * blob, a string or any)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001179 */
1180 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001181arg_slice1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001182{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001183 if (type->tt_type == VAR_LIST
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001184 || type->tt_type == VAR_TUPLE
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001185 || type->tt_type == VAR_BLOB
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001186 || type->tt_type == VAR_STRING
1187 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001188 return OK;
1189
1190 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
1191 return FAIL;
1192}
1193
1194/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001195 * Check "type" which is the first argument of count() (a string, a list, a
1196 * tuple, a dict or any)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001197 */
1198 static int
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001199arg_string_list_tuple_or_dict(
1200 type_T *type,
1201 type_T *decl_type UNUSED,
1202 argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001203{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001204 if (type->tt_type == VAR_STRING
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001205 || type->tt_type == VAR_LIST
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001206 || type->tt_type == VAR_TUPLE
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001207 || type->tt_type == VAR_DICT
1208 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001209 return OK;
1210
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001211 semsg(_(e_string_list_tuple_or_dict_required_for_argument_nr),
Bram Moolenaar3e518a82022-08-30 17:45:33 +01001212 context->arg_idx + 1);
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001213 return FAIL;
1214}
1215
1216/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001217 * Check "type" which is the first argument of cursor() (number or string or
1218 * list or any)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001219 */
1220 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001221arg_cursor1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001222{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001223 if (type->tt_type == VAR_NUMBER
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001224 || type->tt_type == VAR_STRING
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001225 || type->tt_type == VAR_LIST
1226 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001227 return OK;
1228
1229 arg_type_mismatch(&t_number, type, context->arg_idx + 1);
1230 return FAIL;
1231}
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01001232
1233/*
Bram Moolenaar94738d82020-10-21 14:25:07 +02001234 * Lists of functions that check the argument types of a builtin function.
1235 */
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +02001236static argcheck_T arg1_blob[] = {arg_blob};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001237static argcheck_T arg1_bool[] = {arg_bool};
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001238static argcheck_T arg1_buffer[] = {arg_buffer};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001239static argcheck_T arg1_buffer_or_dict_any[] = {arg_buffer_or_dict_any};
1240static argcheck_T arg1_chan_or_job[] = {arg_chan_or_job};
1241static argcheck_T arg1_dict_any[] = {arg_dict_any};
1242static argcheck_T arg1_dict_or_string[] = {arg_dict_any_or_string};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001243static argcheck_T arg1_float_or_nr[] = {arg_float_or_nr};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001244static argcheck_T arg1_job[] = {arg_job};
1245static argcheck_T arg1_list_any[] = {arg_list_any};
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001246static argcheck_T arg1_tuple_any[] = {arg_tuple_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001247static argcheck_T arg1_list_number[] = {arg_list_number};
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001248static argcheck_T arg1_reverse[] = {arg_reverse};
1249static argcheck_T arg1_list_or_tuple_or_dict[] = {arg_list_or_tuple_or_dict};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001250static argcheck_T arg1_list_string[] = {arg_list_string};
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001251static argcheck_T arg1_string_list_tuple_or_dict[] = {arg_string_list_tuple_or_dict};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001252static argcheck_T arg1_lnum[] = {arg_lnum};
1253static argcheck_T arg1_number[] = {arg_number};
1254static argcheck_T arg1_string[] = {arg_string};
1255static argcheck_T arg1_string_or_list_any[] = {arg_string_or_list_any};
1256static argcheck_T arg1_string_or_list_string[] = {arg_string_or_list_string};
1257static argcheck_T arg1_string_or_nr[] = {arg_string_or_nr};
Ernie Raela8f7f922023-12-14 20:17:04 +01001258static argcheck_T arg2_any_buffer[] = {arg_any, arg_buffer};
1259static argcheck_T arg2_buffer_any[] = {arg_buffer, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001260static argcheck_T arg2_buffer_bool[] = {arg_buffer, arg_bool};
1261static argcheck_T arg2_buffer_list_any[] = {arg_buffer, arg_list_any};
1262static argcheck_T arg2_buffer_lnum[] = {arg_buffer, arg_lnum};
1263static argcheck_T arg2_buffer_number[] = {arg_buffer, arg_number};
1264static argcheck_T arg2_buffer_string[] = {arg_buffer, arg_string};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001265static argcheck_T arg2_chan_or_job_dict[] = {arg_chan_or_job, arg_dict_any};
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001266static argcheck_T arg2_chan_or_job_string[] = {arg_chan_or_job, arg_string};
Yegappan Lakshmananccfb7c62021-08-16 21:39:09 +02001267static argcheck_T arg2_dict_any_list_any[] = {arg_dict_any, arg_list_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001268static argcheck_T arg2_dict_any_string_or_nr[] = {arg_dict_any, arg_string_or_nr};
1269static argcheck_T arg2_dict_string[] = {arg_dict_any, arg_string};
1270static argcheck_T arg2_float_or_nr[] = {arg_float_or_nr, arg_float_or_nr};
1271static argcheck_T arg2_job_dict[] = {arg_job, arg_dict_any};
1272static argcheck_T arg2_job_string_or_number[] = {arg_job, arg_string_or_nr};
1273static argcheck_T arg2_list_any_number[] = {arg_list_any, arg_number};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001274static argcheck_T arg2_list_number[] = {arg_list_number, arg_list_number};
1275static argcheck_T arg2_list_number_bool[] = {arg_list_number, arg_bool};
Yegappan Lakshmanana11b23c2025-01-16 19:16:42 +01001276static argcheck_T arg2_list_string_dict[] = {arg_list_string, arg_dict_any};
Bram Moolenaarfa103972022-09-29 19:14:42 +01001277static argcheck_T arg2_listblobmod_item[] = {arg_list_or_blob_mod, arg_item_of_prev};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001278static argcheck_T arg2_lnum[] = {arg_lnum, arg_lnum};
1279static argcheck_T arg2_lnum_number[] = {arg_lnum, arg_number};
1280static argcheck_T arg2_number[] = {arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001281static argcheck_T arg2_number_any[] = {arg_number, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001282static argcheck_T arg2_number_bool[] = {arg_number, arg_bool};
1283static argcheck_T arg2_number_dict_any[] = {arg_number, arg_dict_any};
1284static argcheck_T arg2_number_list[] = {arg_number, arg_list_any};
1285static argcheck_T arg2_number_string[] = {arg_number, arg_string};
Christian Brabandtfbc37f12024-06-18 20:50:58 +02001286static argcheck_T arg2_number_buffer[] = {arg_number, arg_buffer};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001287static argcheck_T arg2_number_string_or_list[] = {arg_number, arg_string_or_list_any};
1288static argcheck_T arg2_str_or_nr_or_list_dict[] = {arg_str_or_nr_or_list, arg_dict_any};
1289static argcheck_T arg2_string[] = {arg_string, arg_string};
Ernie Raela8f7f922023-12-14 20:17:04 +01001290static argcheck_T arg2_string_any[] = {arg_string, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001291static argcheck_T arg2_string_bool[] = {arg_string, arg_bool};
1292static argcheck_T arg2_string_chan_or_job[] = {arg_string, arg_chan_or_job};
1293static argcheck_T arg2_string_dict[] = {arg_string, arg_dict_any};
1294static argcheck_T arg2_string_list_number[] = {arg_string, arg_list_number};
1295static argcheck_T arg2_string_number[] = {arg_string, arg_number};
1296static argcheck_T arg2_string_or_list_dict[] = {arg_string_or_list_any, arg_dict_any};
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00001297static argcheck_T arg2_string_or_list_number[] = {arg_string_or_list_any, arg_number};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001298static argcheck_T arg2_string_string_or_number[] = {arg_string, arg_string_or_nr};
Yegappan Lakshmanan1aefe1d2025-01-14 17:29:42 +01001299static argcheck_T arg2_blob_dict[] = {arg_blob, arg_dict_any};
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001300static argcheck_T arg2_list_or_tuple_string[] = {arg_list_or_tuple, arg_string};
Ernie Raela8f7f922023-12-14 20:17:04 +01001301static argcheck_T arg3_any_list_dict[] = {arg_any, arg_list_any, arg_dict_any};
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001302static argcheck_T arg3_buffer_lnum_lnum[] = {arg_buffer, arg_lnum, arg_lnum};
1303static argcheck_T arg3_buffer_number_number[] = {arg_buffer, arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001304static argcheck_T arg3_buffer_string_any[] = {arg_buffer, arg_string, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001305static argcheck_T arg3_buffer_string_dict[] = {arg_buffer, arg_string, arg_dict_any};
1306static argcheck_T arg3_dict_number_number[] = {arg_dict_any, arg_number, arg_number};
Yegappan Lakshmananfa378352024-02-01 22:05:27 +01001307static argcheck_T arg3_diff[] = {arg_list_string, arg_list_string, arg_dict_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001308static argcheck_T arg3_list_string_dict[] = {arg_list_any, arg_string, arg_dict_any};
Shougo Matsushita19b71882024-02-28 22:48:12 +01001309static argcheck_T arg3_list_list_dict[] = {arg_list_any, arg_list_any, arg_dict_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001310static argcheck_T arg3_lnum_number_bool[] = {arg_lnum, arg_number, arg_bool};
1311static argcheck_T arg3_number[] = {arg_number, arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001312static argcheck_T arg3_number_any_dict[] = {arg_number, arg_any, arg_dict_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001313static argcheck_T arg3_number_number_dict[] = {arg_number, arg_number, arg_dict_any};
Ernie Raela8f7f922023-12-14 20:17:04 +01001314static argcheck_T arg3_number_string_any[] = {arg_number, arg_string, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001315static argcheck_T arg3_number_string_buffer[] = {arg_number, arg_string, arg_buffer};
1316static argcheck_T arg3_number_string_string[] = {arg_number, arg_string, arg_string};
1317static argcheck_T arg3_string[] = {arg_string, arg_string, arg_string};
Ernie Raela8f7f922023-12-14 20:17:04 +01001318static argcheck_T arg3_string_any_dict[] = {arg_string, arg_any, arg_dict_any};
1319static argcheck_T arg3_string_any_string[] = {arg_string, arg_any, arg_string};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001320static argcheck_T arg3_string_bool_bool[] = {arg_string, arg_bool, arg_bool};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001321static argcheck_T arg3_string_number_bool[] = {arg_string, arg_number, arg_bool};
K.Takata11df3ae2022-10-19 14:02:40 +01001322static argcheck_T arg3_string_number_number[] = {arg_string, arg_number, arg_number};
Ernie Rael51d04d12022-05-04 15:40:22 +01001323static argcheck_T arg3_string_or_dict_bool_dict[] = {arg_string_or_dict_any, arg_bool, arg_dict_any};
zeertzjq825cf812023-08-17 22:55:25 +02001324static argcheck_T arg3_string_or_list_bool_number[] = {arg_string_or_list_any, arg_bool, arg_number};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001325static argcheck_T arg3_string_string_bool[] = {arg_string, arg_string, arg_bool};
1326static argcheck_T arg3_string_string_dict[] = {arg_string, arg_string, arg_dict_any};
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02001327static argcheck_T arg3_string_string_number[] = {arg_string, arg_string, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001328static argcheck_T arg4_number_number_string_any[] = {arg_number, arg_number, arg_string, arg_any};
1329static argcheck_T arg4_string_string_any_string[] = {arg_string, arg_string, arg_any, arg_string};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001330static argcheck_T arg4_string_string_number_string[] = {arg_string, arg_string, arg_number, arg_string};
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01001331static argcheck_T arg4_string_number_bool_bool[] = {arg_string, arg_number, arg_bool, arg_bool};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001332/* Function specific argument types (not covered by the above) */
Ernie Raela8f7f922023-12-14 20:17:04 +01001333static argcheck_T arg15_assert_fails[] = {arg_string_or_nr, arg_string_or_list_any, arg_any, arg_number, arg_string};
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001334static argcheck_T arg34_assert_inrange[] = {arg_float_or_nr, arg_float_or_nr, arg_float_or_nr, arg_string};
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001335static argcheck_T arg4_browse[] = {arg_bool, arg_string, arg_string, arg_string};
Ernie Raela8f7f922023-12-14 20:17:04 +01001336static argcheck_T arg23_chanexpr[] = {arg_chan_or_job, arg_any, arg_dict_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001337static argcheck_T arg23_chanraw[] = {arg_chan_or_job, arg_string_or_blob, arg_dict_any};
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001338static argcheck_T arg24_count[] = {arg_string_list_tuple_or_dict, arg_any, arg_bool, arg_number};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001339static argcheck_T arg13_cursor[] = {arg_cursor1, arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001340static argcheck_T arg12_deepcopy[] = {arg_any, arg_bool};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001341static argcheck_T arg12_execute[] = {arg_string_or_list_string, arg_string};
zeertzjqe0a2ab32025-02-02 09:14:35 +01001342static argcheck_T arg12_getchar[] = {arg_bool_or_nr, arg_dict_any};
Bram Moolenaarfa103972022-09-29 19:14:42 +01001343static argcheck_T arg23_extend[] = {arg_list_or_dict_mod, arg_same_as_prev, arg_extend3};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001344static argcheck_T arg23_extendnew[] = {arg_list_or_dict, arg_same_struct_as_prev, arg_extend3};
Ernie Raela8f7f922023-12-14 20:17:04 +01001345static argcheck_T arg23_get[] = {arg_get1, arg_string_or_nr, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001346static argcheck_T arg14_glob[] = {arg_string, arg_bool, arg_bool, arg_bool};
1347static argcheck_T arg25_globpath[] = {arg_string, arg_string, arg_bool, arg_bool, arg_bool};
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001348static argcheck_T arg24_index[] = {arg_list_or_tuple_or_blob, arg_item_of_prev, arg_number, arg_bool};
1349static argcheck_T arg23_index[] = {arg_list_or_tuple_or_blob, arg_filter_func, arg_dict_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001350static argcheck_T arg23_insert[] = {arg_list_or_blob, arg_item_of_prev, arg_number};
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001351static argcheck_T arg1_len[] = {arg_len1};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001352static argcheck_T arg3_libcall[] = {arg_string, arg_string, arg_string_or_nr};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001353static argcheck_T arg14_maparg[] = {arg_string, arg_string, arg_bool, arg_bool};
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001354static argcheck_T arg2_filter[] = {arg_list_or_dict_or_blob_or_string_mod, arg_filter_func};
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001355static argcheck_T arg2_foreach[] = {arg_list_tuple_dict_blob_or_string, arg_foreach_func};
Ernie Rael2025af12023-12-12 16:58:00 +01001356static argcheck_T arg2_instanceof[] = {arg_object, varargs_class, NULL };
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001357static argcheck_T arg2_map[] = {arg_list_or_dict_or_blob_or_string_mod, arg_map_func};
Ernie Raela8f7f922023-12-14 20:17:04 +01001358static argcheck_T arg2_mapnew[] = {arg_list_or_dict_or_blob_or_string, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001359static argcheck_T arg25_matchadd[] = {arg_string, arg_string, arg_number, arg_number, arg_dict_any};
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001360static argcheck_T arg25_matchaddpos[] = {arg_string, arg_list_any, arg_number, arg_number, arg_dict_any};
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01001361static argcheck_T arg23_matchstrlist[] = {arg_list_string, arg_string, arg_dict_any};
1362static argcheck_T arg45_matchbufline[] = {arg_buffer, arg_string, arg_lnum, arg_lnum, arg_dict_any};
Ernie Raela8f7f922023-12-14 20:17:04 +01001363static argcheck_T arg119_printf[] = {arg_string_or_nr, arg_any, arg_any, arg_any, arg_any, arg_any, arg_any, arg_any, arg_any, arg_any, arg_any, arg_any, arg_any, arg_any, arg_any, arg_any, arg_any, arg_any, arg_any};
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001364static argcheck_T arg23_reduce[] = {arg_string_list_tuple_or_blob, arg_any, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001365static argcheck_T arg24_remote_expr[] = {arg_string, arg_string, arg_string, arg_number};
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001366static argcheck_T arg23_remove[] = {arg_list_or_dict_or_blob_mod, arg_remove2, arg_number};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001367static argcheck_T arg2_repeat[] = {arg_repeat1, arg_number};
Bram Moolenaar73199812021-12-26 17:18:14 +00001368static argcheck_T arg15_search[] = {arg_string, arg_string, arg_number, arg_number, arg_string_or_func};
1369static argcheck_T arg37_searchpair[] = {arg_string, arg_string, arg_string, arg_string, arg_string_or_func, arg_number, arg_number};
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001370static argcheck_T arg3_setbufline[] = {arg_buffer, arg_lnum, arg_str_or_nr_or_list};
Ernie Raela8f7f922023-12-14 20:17:04 +01001371static argcheck_T arg2_setline[] = {arg_lnum, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001372static argcheck_T arg24_setloclist[] = {arg_number, arg_list_any, arg_string, arg_dict_any};
1373static argcheck_T arg13_setqflist[] = {arg_list_any, arg_string, arg_dict_any};
1374static argcheck_T arg23_settagstack[] = {arg_number, arg_dict_any, arg_string};
1375static argcheck_T arg02_sign_getplaced[] = {arg_buffer, arg_dict_any};
1376static argcheck_T arg45_sign_place[] = {arg_number, arg_string, arg_string, arg_buffer, arg_dict_any};
1377static argcheck_T arg23_slice[] = {arg_slice1, arg_number, arg_number};
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001378static argcheck_T arg13_sortuniq[] = {arg_list_any_mod, arg_sort_how, arg_dict_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001379static argcheck_T arg24_strpart[] = {arg_string, arg_number, arg_number, arg_bool};
1380static argcheck_T arg12_system[] = {arg_string, arg_str_or_nr_or_list};
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02001381static argcheck_T arg23_win_execute[] = {arg_number, arg_string_or_list_string, arg_string};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001382static argcheck_T arg23_writefile[] = {arg_list_or_blob, arg_string, arg_string};
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02001383static argcheck_T arg24_match_func[] = {arg_string_or_list_any, arg_string, arg_number, arg_number};
Bram Moolenaarcd268012021-07-22 19:11:08 +02001384
Bram Moolenaar32517c42023-01-15 18:17:12 +00001385// Can be used by functions called through "f_retfunc" to create new types.
1386static garray_T *current_type_gap = NULL;
Bram Moolenaar94738d82020-10-21 14:25:07 +02001387
1388/*
1389 * Functions that return the return type of a builtin function.
Bram Moolenaara1224cb2020-10-22 12:31:49 +02001390 * Note that "argtypes" is NULL if "argcount" is zero.
Bram Moolenaar94738d82020-10-21 14:25:07 +02001391 */
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001392 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001393ret_void(int argcount UNUSED,
1394 type2_T *argtypes UNUSED,
1395 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001396{
1397 return &t_void;
1398}
1399 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001400ret_any(int argcount UNUSED,
1401 type2_T *argtypes UNUSED,
1402 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001403{
1404 return &t_any;
1405}
1406 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001407ret_bool(int argcount UNUSED,
1408 type2_T *argtypes UNUSED,
1409 type_T **decl_type UNUSED)
Bram Moolenaar403dc312020-10-17 19:29:51 +02001410{
1411 return &t_bool;
1412}
1413 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001414ret_number_bool(int argcount UNUSED,
1415 type2_T *argtypes UNUSED,
1416 type_T **decl_type UNUSED)
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001417{
1418 return &t_number_bool;
1419}
1420 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001421ret_number(int argcount UNUSED,
1422 type2_T *argtypes UNUSED,
1423 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001424{
1425 return &t_number;
1426}
1427 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001428ret_float(int argcount UNUSED,
1429 type2_T *argtypes UNUSED,
1430 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001431{
1432 return &t_float;
1433}
1434 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001435ret_string(int argcount UNUSED,
1436 type2_T *argtypes UNUSED,
1437 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001438{
1439 return &t_string;
1440}
Bram Moolenaare69f6d02020-04-01 22:11:01 +02001441 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001442ret_list_any(int argcount UNUSED,
1443 type2_T *argtypes UNUSED,
1444 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001445{
1446 return &t_list_any;
1447}
1448 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001449ret_list_number(int argcount UNUSED,
1450 type2_T *argtypes UNUSED,
Bram Moolenaar81330182022-02-01 12:11:58 +00001451 type_T **decl_type)
1452{
Bram Moolenaar81330182022-02-01 12:11:58 +00001453 *decl_type = &t_list_any;
1454 return &t_list_number;
1455}
1456 static type_T *
1457ret_list_string(int argcount UNUSED,
1458 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001459 type_T **decl_type)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001460{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001461 *decl_type = &t_list_any;
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001462 return &t_list_string;
1463}
1464 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001465ret_list_dict_any(int argcount UNUSED,
1466 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001467 type_T **decl_type)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001468{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001469 *decl_type = &t_list_any;
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001470 return &t_list_dict_any;
1471}
1472 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001473ret_list_items(int argcount UNUSED,
1474 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001475 type_T **decl_type)
Bram Moolenaarefc5db52021-07-07 21:21:30 +02001476{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001477 *decl_type = &t_list_any;
Bram Moolenaarefc5db52021-07-07 21:21:30 +02001478 return &t_list_list_any;
1479}
mityu61065042021-07-19 20:07:21 +02001480 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001481ret_list_string_items(int argcount UNUSED,
1482 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001483 type_T **decl_type)
mityu61065042021-07-19 20:07:21 +02001484{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001485 *decl_type = &t_list_any;
mityu61065042021-07-19 20:07:21 +02001486 return &t_list_list_string;
1487}
Bram Moolenaarefc5db52021-07-07 21:21:30 +02001488 static type_T *
zeertzjqd4d12072024-07-16 20:34:16 +02001489ret_list_regionpos(int argcount UNUSED,
1490 type2_T *argtypes UNUSED,
1491 type_T **decl_type)
1492{
1493 *decl_type = &t_list_any;
1494 return &t_list_list_list_number;
1495}
1496 static type_T *
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001497ret_tuple_any(int argcount UNUSED,
1498 type2_T *argtypes UNUSED,
1499 type_T **decl_type UNUSED)
1500{
1501 return &t_tuple_any;
1502}
1503 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001504ret_dict_any(int argcount UNUSED,
1505 type2_T *argtypes UNUSED,
1506 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001507{
1508 return &t_dict_any;
1509}
1510 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001511ret_job_info(int argcount,
1512 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001513 type_T **decl_type)
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01001514{
1515 if (argcount == 0)
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001516 {
1517 *decl_type = &t_list_any;
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01001518 return &t_list_job;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001519 }
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01001520 return &t_dict_any;
1521}
1522 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001523ret_dict_number(int argcount UNUSED,
1524 type2_T *argtypes UNUSED,
1525 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001526{
1527 return &t_dict_number;
1528}
1529 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001530ret_dict_string(int argcount UNUSED,
1531 type2_T *argtypes UNUSED,
1532 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001533{
1534 return &t_dict_string;
1535}
1536 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001537ret_blob(int argcount UNUSED,
1538 type2_T *argtypes UNUSED,
1539 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001540{
1541 return &t_blob;
1542}
1543 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001544ret_func_any(int argcount UNUSED,
1545 type2_T *argtypes UNUSED,
1546 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001547{
Bram Moolenaare69f6d02020-04-01 22:11:01 +02001548 return &t_func_any;
1549}
1550 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001551ret_func_unknown(int argcount UNUSED,
1552 type2_T *argtypes UNUSED,
1553 type_T **decl_type UNUSED)
Bram Moolenaar2f9f4cc2021-12-20 09:36:27 +00001554{
1555 return &t_func_unknown;
1556}
1557 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001558ret_channel(int argcount UNUSED,
1559 type2_T *argtypes UNUSED,
1560 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001561{
1562 return &t_channel;
1563}
1564 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001565ret_job(int argcount UNUSED,
1566 type2_T *argtypes UNUSED,
1567 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001568{
1569 return &t_job;
1570}
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001571 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001572ret_first_arg(int argcount,
1573 type2_T *argtypes,
1574 type_T **decl_type)
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001575{
1576 if (argcount > 0)
Bram Moolenaar81330182022-02-01 12:11:58 +00001577 {
1578 *decl_type = argtypes[0].type_decl;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001579 return argtypes[0].type_curr;
Bram Moolenaar81330182022-02-01 12:11:58 +00001580 }
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001581 return &t_void;
1582}
Bram Moolenaar1780f082021-07-31 22:03:59 +02001583 static type_T *
Bram Moolenaar00eb9952022-02-05 19:23:18 +00001584ret_slice(int argcount,
1585 type2_T *argtypes,
1586 type_T **decl_type)
1587{
1588 if (argcount > 0)
1589 {
1590 if (argtypes[0].type_decl != NULL)
1591 {
1592 switch (argtypes[0].type_decl->tt_type)
1593 {
1594 case VAR_STRING: *decl_type = &t_string; break;
1595 case VAR_BLOB: *decl_type = &t_blob; break;
1596 case VAR_LIST: *decl_type = &t_list_any; break;
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01001597 case VAR_TUPLE: *decl_type = &t_tuple_any; break;
Bram Moolenaar00eb9952022-02-05 19:23:18 +00001598 default: break;
1599 }
1600 }
1601 return argtypes[0].type_curr;
1602 }
1603 return &t_void;
1604}
1605 static type_T *
Bram Moolenaar381692b2022-02-02 20:01:27 +00001606ret_copy(int argcount,
1607 type2_T *argtypes,
1608 type_T **decl_type)
1609{
1610 if (argcount > 0)
1611 {
1612 if (argtypes[0].type_decl != NULL)
1613 {
1614 if (argtypes[0].type_decl->tt_type == VAR_LIST)
1615 *decl_type = &t_list_any;
1616 else if (argtypes[0].type_decl->tt_type == VAR_DICT)
1617 *decl_type = &t_dict_any;
1618 else
1619 *decl_type = argtypes[0].type_decl;
1620 }
1621 if (argtypes[0].type_curr != NULL)
1622 {
1623 if (argtypes[0].type_curr->tt_type == VAR_LIST)
1624 return &t_list_any;
1625 else if (argtypes[0].type_curr->tt_type == VAR_DICT)
1626 return &t_dict_any;
1627 }
1628 return argtypes[0].type_curr;
1629 }
1630 return &t_void;
1631}
1632 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001633ret_extend(int argcount,
1634 type2_T *argtypes,
1635 type_T **decl_type)
1636{
1637 if (argcount > 0)
1638 {
1639 *decl_type = argtypes[0].type_decl;
1640 // if the second argument has a different current type then the current
1641 // type is "any"
1642 if (argcount > 1 && !equal_type(argtypes[0].type_curr,
1643 argtypes[1].type_curr, 0))
1644 {
1645 if (argtypes[0].type_curr->tt_type == VAR_LIST)
1646 return &t_list_any;
1647 if (argtypes[0].type_curr->tt_type == VAR_DICT)
1648 return &t_dict_any;
1649 }
1650 return argtypes[0].type_curr;
1651 }
1652 return &t_void;
1653}
1654 static type_T *
1655ret_repeat(int argcount,
1656 type2_T *argtypes,
1657 type_T **decl_type UNUSED)
Bram Moolenaar1780f082021-07-31 22:03:59 +02001658{
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001659 if (argcount == 0)
1660 return &t_any;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001661 if (argtypes[0].type_curr == &t_number)
Bram Moolenaar1780f082021-07-31 22:03:59 +02001662 return &t_string;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001663 return argtypes[0].type_curr;
Bram Moolenaar1780f082021-07-31 22:03:59 +02001664}
Bram Moolenaarea696852020-11-09 18:31:39 +01001665// for map(): returns first argument but item type may differ
1666 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001667ret_first_cont(int argcount,
1668 type2_T *argtypes,
1669 type_T **decl_type UNUSED)
Bram Moolenaarea696852020-11-09 18:31:39 +01001670{
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001671 if (argcount > 0)
1672 {
Bram Moolenaar078a4612022-01-04 15:17:03 +00001673 if (argtypes[0].type_curr->tt_type == VAR_LIST)
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001674 return &t_list_any;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001675 if (argtypes[0].type_curr->tt_type == VAR_DICT)
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001676 return &t_dict_any;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001677 if (argtypes[0].type_curr->tt_type == VAR_BLOB)
1678 return argtypes[0].type_curr;
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001679 }
Bram Moolenaarea696852020-11-09 18:31:39 +01001680 return &t_any;
1681}
Bram Moolenaar078a4612022-01-04 15:17:03 +00001682// for getline()
1683 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001684ret_getline(int argcount,
1685 type2_T *argtypes UNUSED,
1686 type_T **decl_type UNUSED)
Bram Moolenaar078a4612022-01-04 15:17:03 +00001687{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001688 if (argcount == 1)
1689 return &t_string;
1690 *decl_type = &t_list_any;
1691 return &t_list_string;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001692}
Bram Moolenaar08018222021-12-22 18:45:37 +00001693// for finddir()
1694 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001695ret_finddir(int argcount,
1696 type2_T *argtypes UNUSED,
1697 type_T **decl_type UNUSED)
Bram Moolenaar08018222021-12-22 18:45:37 +00001698{
1699 if (argcount < 3)
1700 return &t_string;
1701 // Depending on the count would be a string or a list of strings.
1702 return &t_any;
1703}
Bram Moolenaar32517c42023-01-15 18:17:12 +00001704// for values(): list of member of first argument
1705 static type_T *
1706ret_list_member(int argcount,
1707 type2_T *argtypes,
1708 type_T **decl_type)
1709{
1710 if (argcount > 0)
1711 {
1712 type_T *t = argtypes[0].type_decl;
1713 if (current_type_gap != NULL
1714 && (t->tt_type == VAR_DICT || t->tt_type == VAR_LIST))
1715 t = get_list_type(t->tt_member, current_type_gap);
1716 else
1717 t = &t_list_any;
1718 *decl_type = t;
1719
1720 t = argtypes[0].type_curr;
1721 if (current_type_gap != NULL
1722 && (t->tt_type == VAR_DICT || t->tt_type == VAR_LIST))
1723 return get_list_type(t->tt_member, current_type_gap);
1724 }
1725 return &t_list_any;
1726}
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001727
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001728/*
1729 * Used for getqflist(): returns list if there is no argument, dict if there is
1730 * one.
1731 */
1732 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001733ret_list_or_dict_0(int argcount,
1734 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001735 type_T **decl_type)
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001736{
1737 if (argcount > 0)
1738 return &t_dict_any;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001739 *decl_type = &t_list_any;
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001740 return &t_list_dict_any;
1741}
1742
1743/*
1744 * Used for getloclist(): returns list if there is one argument, dict if there
1745 * are two.
1746 */
1747 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001748ret_list_or_dict_1(int argcount,
1749 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001750 type_T **decl_type)
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001751{
1752 if (argcount > 1)
1753 return &t_dict_any;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001754 *decl_type = &t_list_any;
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001755 return &t_list_dict_any;
1756}
1757
Bram Moolenaar846178a2020-07-05 17:04:13 +02001758 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001759ret_argv(int argcount,
1760 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001761 type_T **decl_type)
Bram Moolenaar846178a2020-07-05 17:04:13 +02001762{
1763 // argv() returns list of strings
1764 if (argcount == 0)
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001765 {
1766 *decl_type = &t_list_any;
Bram Moolenaar846178a2020-07-05 17:04:13 +02001767 return &t_list_string;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001768 }
Bram Moolenaar846178a2020-07-05 17:04:13 +02001769
1770 // argv(0) returns a string, but argv(-1] returns a list
1771 return &t_any;
1772}
1773
Bram Moolenaarad7c2492020-07-05 20:55:29 +02001774 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001775ret_remove(int argcount,
1776 type2_T *argtypes,
Bram Moolenaar2ac037f2022-05-09 14:12:14 +01001777 type_T **decl_type)
Bram Moolenaarad7c2492020-07-05 20:55:29 +02001778{
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001779 if (argcount > 0)
Bram Moolenaar5e654232020-09-16 15:22:00 +02001780 {
Bram Moolenaar078a4612022-01-04 15:17:03 +00001781 if (argtypes[0].type_curr->tt_type == VAR_LIST
1782 || argtypes[0].type_curr->tt_type == VAR_DICT)
Bram Moolenaar81330182022-02-01 12:11:58 +00001783 {
Bram Moolenaar2ac037f2022-05-09 14:12:14 +01001784 if (argcount == 3)
1785 {
1786 *decl_type = argtypes[0].type_decl;
1787 return argtypes[0].type_curr;
1788 }
Bram Moolenaar81330182022-02-01 12:11:58 +00001789 if (argtypes[0].type_curr->tt_type
1790 == argtypes[0].type_decl->tt_type)
1791 *decl_type = argtypes[0].type_decl->tt_member;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001792 return argtypes[0].type_curr->tt_member;
Bram Moolenaar81330182022-02-01 12:11:58 +00001793 }
Bram Moolenaar078a4612022-01-04 15:17:03 +00001794 if (argtypes[0].type_curr->tt_type == VAR_BLOB)
Bram Moolenaar5e654232020-09-16 15:22:00 +02001795 return &t_number;
1796 }
Bram Moolenaarad7c2492020-07-05 20:55:29 +02001797 return &t_any;
1798}
1799
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001800 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001801ret_getreg(int argcount,
1802 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001803 type_T **decl_type)
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001804{
1805 // Assume that if the third argument is passed it's non-zero
1806 if (argcount == 3)
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001807 {
1808 *decl_type = &t_list_any;
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001809 return &t_list_string;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001810 }
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001811 return &t_string;
1812}
1813
Bram Moolenaar4a6d1b62020-08-08 17:55:49 +02001814 static type_T *
LemonBoy0f7a3e12022-05-26 12:10:37 +01001815ret_virtcol(int argcount,
1816 type2_T *argtypes UNUSED,
1817 type_T **decl_type)
1818{
1819 // Assume that if the second argument is passed it's non-zero
zeertzjq825cf812023-08-17 22:55:25 +02001820 if (argcount > 1)
LemonBoy0f7a3e12022-05-26 12:10:37 +01001821 {
1822 *decl_type = &t_list_any;
1823 return &t_list_number;
1824 }
1825 return &t_number;
1826}
1827
1828 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001829ret_maparg(int argcount,
1830 type2_T *argtypes UNUSED,
1831 type_T **decl_type UNUSED)
Bram Moolenaar4a6d1b62020-08-08 17:55:49 +02001832{
1833 // Assume that if the fourth argument is passed it's non-zero
1834 if (argcount == 4)
1835 return &t_dict_any;
1836 return &t_string;
1837}
1838
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001839/*
1840 * Array with names and number of arguments of all internal functions
1841 * MUST BE KEPT SORTED IN strcmp() ORDER FOR BINARY SEARCH!
Ernie Rael2025af12023-12-12 16:58:00 +01001842 *
Ernie Raela8f7f922023-12-14 20:17:04 +01001843 * The builtin function may be varargs. In that case
Ernie Rael2025af12023-12-12 16:58:00 +01001844 * - f_max_argc == VARGS
Ernie Raela8f7f922023-12-14 20:17:04 +01001845 * - For varargs, f_argcheck must be NULL terminated. The last non-null
1846 * entry in f_argcheck should validate all the remaining args.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001847 */
Bram Moolenaarac92e252019-08-03 21:58:38 +02001848typedef struct
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001849{
Bram Moolenaar25e42232019-08-04 15:04:10 +02001850 char *f_name; // function name
1851 char f_min_argc; // minimal number of arguments
1852 char f_max_argc; // maximal number of arguments
Ernie Raeld8bf87c2023-12-16 14:03:33 +01001853 char f_argtype; // for method: FEARG_ values; bits FE_
Ernie Raela8f7f922023-12-14 20:17:04 +01001854 argcheck_T *f_argcheck; // list of functions to check argument types;
1855 // use "arg_any" (not NULL) to accept an
1856 // argument of any type
Bram Moolenaar81330182022-02-01 12:11:58 +00001857 type_T *(*f_retfunc)(int argcount, type2_T *argtypes,
1858 type_T **decl_type);
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001859 // return type function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001860 void (*f_func)(typval_T *args, typval_T *rvar);
Bram Moolenaar25e42232019-08-04 15:04:10 +02001861 // implementation of function
Bram Moolenaarac92e252019-08-03 21:58:38 +02001862} funcentry_T;
1863
Ernie Rael2025af12023-12-12 16:58:00 +01001864// Set f_max_argc to VARGS for varargs.
1865#define VARGS CHAR_MAX
1866
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02001867// values for f_argtype; zero means it cannot be used as a method
Ernie Raeld8bf87c2023-12-16 14:03:33 +01001868#define FEARG_1 0x01 // base is the first argument
1869#define FEARG_2 0x02 // base is the second argument
1870#define FEARG_3 0x03 // base is the third argument
1871#define FEARG_4 0x04 // base is the fourth argument
1872#define FEARG_MASK 0x0F // bits in f_argtype used as argument index
1873#define FE_X 0x10 // builtin accepts a non-value (class, typealias)
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02001874
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001875#if defined(HAVE_MATH_H)
Bram Moolenaar15c47602020-03-26 22:16:48 +01001876# define MATH_FUNC(name) name
1877#else
1878# define MATH_FUNC(name) NULL
1879#endif
1880#ifdef FEAT_TIMERS
1881# define TIMER_FUNC(name) name
1882#else
1883# define TIMER_FUNC(name) NULL
1884#endif
1885#ifdef FEAT_JOB_CHANNEL
1886# define JOB_FUNC(name) name
1887#else
1888# define JOB_FUNC(name) NULL
1889#endif
1890#ifdef FEAT_PROP_POPUP
1891# define PROP_FUNC(name) name
1892#else
1893# define PROP_FUNC(name) NULL
1894#endif
1895#ifdef FEAT_SIGNS
1896# define SIGN_FUNC(name) name
1897#else
1898# define SIGN_FUNC(name) NULL
1899#endif
1900#ifdef FEAT_SOUND
1901# define SOUND_FUNC(name) name
1902#else
1903# define SOUND_FUNC(name) NULL
1904#endif
1905#ifdef FEAT_TERMINAL
1906# define TERM_FUNC(name) name
1907#else
1908# define TERM_FUNC(name) NULL
1909#endif
1910
Bram Moolenaarac92e252019-08-03 21:58:38 +02001911static funcentry_T global_functions[] =
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001912{
Bram Moolenaar94738d82020-10-21 14:25:07 +02001913 {"abs", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001914 ret_any, f_abs},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001915 {"acos", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001916 ret_float, f_acos},
Bram Moolenaarfa103972022-09-29 19:14:42 +01001917 {"add", 2, 2, FEARG_1, arg2_listblobmod_item,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001918 ret_first_arg, f_add},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001919 {"and", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001920 ret_number, f_and},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001921 {"append", 2, 2, FEARG_2, arg2_setline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001922 ret_number_bool, f_append},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001923 {"appendbufline", 3, 3, FEARG_3, arg3_setbufline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001924 ret_number_bool, f_appendbufline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001925 {"argc", 0, 1, 0, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001926 ret_number, f_argc},
1927 {"argidx", 0, 0, 0, NULL,
1928 ret_number, f_argidx},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001929 {"arglistid", 0, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001930 ret_number, f_arglistid},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001931 {"argv", 0, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001932 ret_argv, f_argv},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001933 {"asin", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001934 ret_float, f_asin},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001935 {"assert_beeps", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001936 ret_number_bool, f_assert_beeps},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001937 {"assert_equal", 2, 3, FEARG_2, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001938 ret_number_bool, f_assert_equal},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001939 {"assert_equalfile", 2, 3, FEARG_1, arg3_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001940 ret_number_bool, f_assert_equalfile},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001941 {"assert_exception", 1, 2, 0, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001942 ret_number_bool, f_assert_exception},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001943 {"assert_fails", 1, 5, FEARG_1, arg15_assert_fails,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001944 ret_number_bool, f_assert_fails},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001945 {"assert_false", 1, 2, FEARG_1, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001946 ret_number_bool, f_assert_false},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001947 {"assert_inrange", 3, 4, FEARG_3, arg34_assert_inrange,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001948 ret_number_bool, f_assert_inrange},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001949 {"assert_match", 2, 3, FEARG_2, arg3_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001950 ret_number_bool, f_assert_match},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001951 {"assert_nobeep", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar5b8cabf2021-04-02 18:55:57 +02001952 ret_number_bool, f_assert_nobeep},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001953 {"assert_notequal", 2, 3, FEARG_2, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001954 ret_number_bool, f_assert_notequal},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001955 {"assert_notmatch", 2, 3, FEARG_2, arg3_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001956 ret_number_bool, f_assert_notmatch},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02001957 {"assert_report", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001958 ret_number_bool, f_assert_report},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001959 {"assert_true", 1, 2, FEARG_1, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001960 ret_number_bool, f_assert_true},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001961 {"atan", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001962 ret_float, f_atan},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001963 {"atan2", 2, 2, FEARG_1, arg2_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001964 ret_float, f_atan2},
Yegappan Lakshmanan1755a912022-05-19 10:31:47 +01001965 {"autocmd_add", 1, 1, FEARG_1, arg1_list_any,
1966 ret_number_bool, f_autocmd_add},
1967 {"autocmd_delete", 1, 1, FEARG_1, arg1_list_any,
1968 ret_number_bool, f_autocmd_delete},
1969 {"autocmd_get", 0, 1, FEARG_1, arg1_dict_any,
1970 ret_list_dict_any, f_autocmd_get},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001971 {"balloon_gettext", 0, 0, 0, NULL,
1972 ret_string,
Bram Moolenaar59716a22017-03-01 20:32:44 +01001973#ifdef FEAT_BEVAL
Bram Moolenaar15c47602020-03-26 22:16:48 +01001974 f_balloon_gettext
1975#else
1976 NULL
Bram Moolenaar59716a22017-03-01 20:32:44 +01001977#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01001978 },
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02001979 {"balloon_show", 1, 1, FEARG_1, arg1_string_or_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001980 ret_void,
Bram Moolenaar15c47602020-03-26 22:16:48 +01001981#ifdef FEAT_BEVAL
1982 f_balloon_show
1983#else
1984 NULL
1985#endif
1986 },
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001987 {"balloon_split", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001988 ret_list_string,
Bram Moolenaar15c47602020-03-26 22:16:48 +01001989#if defined(FEAT_BEVAL_TERM)
1990 f_balloon_split
1991#else
1992 NULL
1993#endif
1994 },
Yegappan Lakshmanan810785c2024-12-30 10:29:44 +01001995 {"base64_decode", 1, 1, FEARG_1, arg1_string,
1996 ret_blob, f_base64_decode},
1997 {"base64_encode", 1, 1, FEARG_1, arg1_blob,
1998 ret_string, f_base64_encode},
Christ van Willegence0ef912024-06-20 23:41:59 +02001999 {"bindtextdomain", 2, 2, 0, arg2_string,
Christ van Willegen8252ef12024-07-11 21:36:21 +02002000 ret_bool, f_bindtextdomain},
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +02002001 {"blob2list", 1, 1, FEARG_1, arg1_blob,
2002 ret_list_number, f_blob2list},
Yegappan Lakshmanan1aefe1d2025-01-14 17:29:42 +01002003 {"blob2str", 1, 2, FEARG_1, arg2_blob_dict,
Yegappan Lakshmanan166b1752025-01-17 11:48:12 +01002004 ret_list_string, f_blob2str},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002005 {"browse", 4, 4, 0, arg4_browse,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002006 ret_string, f_browse},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002007 {"browsedir", 2, 2, 0, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002008 ret_string, f_browsedir},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002009 {"bufadd", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002010 ret_number, f_bufadd},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002011 {"bufexists", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002012 ret_number_bool, f_bufexists},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002013 {"buffer_exists", 1, 1, FEARG_1, arg1_buffer, // obsolete
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002014 ret_number_bool, f_bufexists},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002015 {"buffer_name", 0, 1, FEARG_1, arg1_buffer, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02002016 ret_string, f_bufname},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002017 {"buffer_number", 0, 1, FEARG_1, arg1_buffer, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02002018 ret_number, f_bufnr},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002019 {"buflisted", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002020 ret_number_bool, f_buflisted},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002021 {"bufload", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002022 ret_void, f_bufload},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002023 {"bufloaded", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002024 ret_number_bool, f_bufloaded},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002025 {"bufname", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002026 ret_string, f_bufname},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002027 {"bufnr", 0, 2, FEARG_1, arg2_buffer_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002028 ret_number, f_bufnr},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002029 {"bufwinid", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002030 ret_number, f_bufwinid},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002031 {"bufwinnr", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002032 ret_number, f_bufwinnr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002033 {"byte2line", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002034 ret_number, f_byte2line},
Christian Brabandt67672ef2023-04-24 21:09:54 +01002035 {"byteidx", 2, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002036 ret_number, f_byteidx},
Christian Brabandt67672ef2023-04-24 21:09:54 +01002037 {"byteidxcomp", 2, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002038 ret_number, f_byteidxcomp},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002039 {"call", 2, 3, FEARG_1, arg3_any_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002040 ret_any, f_call},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002041 {"ceil", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002042 ret_float, f_ceil},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002043 {"ch_canread", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002044 ret_number_bool, JOB_FUNC(f_ch_canread)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002045 {"ch_close", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002046 ret_void, JOB_FUNC(f_ch_close)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002047 {"ch_close_in", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002048 ret_void, JOB_FUNC(f_ch_close_in)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002049 {"ch_evalexpr", 2, 3, FEARG_1, arg23_chanexpr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002050 ret_any, JOB_FUNC(f_ch_evalexpr)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002051 {"ch_evalraw", 2, 3, FEARG_1, arg23_chanraw,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002052 ret_any, JOB_FUNC(f_ch_evalraw)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002053 {"ch_getbufnr", 2, 2, FEARG_1, arg2_chan_or_job_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002054 ret_number, JOB_FUNC(f_ch_getbufnr)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002055 {"ch_getjob", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002056 ret_job, JOB_FUNC(f_ch_getjob)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002057 {"ch_info", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002058 ret_dict_any, JOB_FUNC(f_ch_info)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002059 {"ch_log", 1, 2, FEARG_1, arg2_string_chan_or_job,
Bram Moolenaar4c5678f2022-11-30 18:12:19 +00002060 ret_void, f_ch_log},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002061 {"ch_logfile", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar4c5678f2022-11-30 18:12:19 +00002062 ret_void, f_ch_logfile},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002063 {"ch_open", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002064 ret_channel, JOB_FUNC(f_ch_open)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002065 {"ch_read", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002066 ret_string, JOB_FUNC(f_ch_read)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002067 {"ch_readblob", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002068 ret_blob, JOB_FUNC(f_ch_readblob)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002069 {"ch_readraw", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002070 ret_string, JOB_FUNC(f_ch_readraw)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002071 {"ch_sendexpr", 2, 3, FEARG_1, arg23_chanexpr,
Yegappan Lakshmanan3b470ae2022-04-16 10:41:27 +01002072 ret_any, JOB_FUNC(f_ch_sendexpr)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002073 {"ch_sendraw", 2, 3, FEARG_1, arg23_chanraw,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002074 ret_void, JOB_FUNC(f_ch_sendraw)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002075 {"ch_setoptions", 2, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002076 ret_void, JOB_FUNC(f_ch_setoptions)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002077 {"ch_status", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002078 ret_string, JOB_FUNC(f_ch_status)},
2079 {"changenr", 0, 0, 0, NULL,
2080 ret_number, f_changenr},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002081 {"char2nr", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002082 ret_number, f_char2nr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002083 {"charclass", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002084 ret_number, f_charclass},
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00002085 {"charcol", 1, 2, FEARG_1, arg2_string_or_list_number,
Bram Moolenaar6f02b002021-01-10 20:22:54 +01002086 ret_number, f_charcol},
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01002087 {"charidx", 2, 4, FEARG_1, arg4_string_number_bool_bool,
Bram Moolenaar17793ef2020-12-28 12:56:58 +01002088 ret_number, f_charidx},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002089 {"chdir", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002090 ret_string, f_chdir},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002091 {"cindent", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002092 ret_number, f_cindent},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002093 {"clearmatches", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002094 ret_void, f_clearmatches},
Girish Palya92f68e22025-04-21 11:12:41 +02002095 {"cmdcomplete_info",0, 0, 0, NULL,
2096 ret_dict_any, f_cmdcomplete_info},
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00002097 {"col", 1, 2, FEARG_1, arg2_string_or_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002098 ret_number, f_col},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002099 {"complete", 2, 2, FEARG_2, arg2_number_list,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002100 ret_void, f_complete},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002101 {"complete_add", 1, 1, FEARG_1, arg1_dict_or_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002102 ret_number, f_complete_add},
2103 {"complete_check", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002104 ret_number_bool, f_complete_check},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002105 {"complete_info", 0, 1, FEARG_1, arg1_list_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002106 ret_dict_any, f_complete_info},
glepnirbcd59952025-04-24 21:48:35 +02002107 {"complete_match", 0, 2, 0, NULL,
2108 ret_list_any, f_complete_match},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002109 {"confirm", 1, 4, FEARG_1, arg4_string_string_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002110 ret_number, f_confirm},
2111 {"copy", 1, 1, FEARG_1, NULL,
Bram Moolenaar381692b2022-02-02 20:01:27 +00002112 ret_copy, f_copy},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002113 {"cos", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002114 ret_float, f_cos},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002115 {"cosh", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002116 ret_float, f_cosh},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002117 {"count", 2, 4, FEARG_1, arg24_count,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002118 ret_number, f_count},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002119 {"cscope_connection",0,3, 0, arg3_number_string_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002120 ret_number, f_cscope_connection},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002121 {"cursor", 1, 3, FEARG_1, arg13_cursor,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002122 ret_number, f_cursor},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002123 {"debugbreak", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002124 ret_number,
Bram Moolenaar4f974752019-02-17 17:44:42 +01002125#ifdef MSWIN
Bram Moolenaar15c47602020-03-26 22:16:48 +01002126 f_debugbreak
2127#else
2128 NULL
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02002129#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002130 },
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002131 {"deepcopy", 1, 2, FEARG_1, arg12_deepcopy,
Bram Moolenaar381692b2022-02-02 20:01:27 +00002132 ret_copy, f_deepcopy},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002133 {"delete", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002134 ret_number_bool, f_delete},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002135 {"deletebufline", 2, 3, FEARG_1, arg3_buffer_lnum_lnum,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002136 ret_number_bool, f_deletebufline},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002137 {"did_filetype", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002138 ret_number_bool, f_did_filetype},
Yegappan Lakshmananfa378352024-02-01 22:05:27 +01002139 {"diff", 2, 3, FEARG_1, arg3_diff,
Yegappan Lakshmanana0010a12024-02-12 20:21:26 +01002140 ret_any, f_diff},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002141 {"diff_filler", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002142 ret_number, f_diff_filler},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002143 {"diff_hlID", 2, 2, FEARG_1, arg2_lnum_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002144 ret_number, f_diff_hlID},
h-east29b85712021-07-26 21:54:04 +02002145 {"digraph_get", 1, 1, FEARG_1, arg1_string,
2146 ret_string, f_digraph_get},
zeertzjqd4d12072024-07-16 20:34:16 +02002147 {"digraph_getlist", 0, 1, FEARG_1, arg1_bool,
h-east29b85712021-07-26 21:54:04 +02002148 ret_list_string_items, f_digraph_getlist},
Yegappan Lakshmananfc3b7752021-09-08 14:57:42 +02002149 {"digraph_set", 2, 2, FEARG_1, arg2_string,
h-east29b85712021-07-26 21:54:04 +02002150 ret_bool, f_digraph_set},
zeertzjqd4d12072024-07-16 20:34:16 +02002151 {"digraph_setlist", 1, 1, FEARG_1, arg1_list_string,
h-east29b85712021-07-26 21:54:04 +02002152 ret_bool, f_digraph_setlist},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002153 {"echoraw", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002154 ret_void, f_echoraw},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002155 {"empty", 1, 1, FEARG_1, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002156 ret_number_bool, f_empty},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002157 {"environ", 0, 0, 0, NULL,
2158 ret_dict_string, f_environ},
Bram Moolenaar80adaa82023-07-07 18:57:40 +01002159 {"err_teapot", 0, 1, 0, NULL,
2160 ret_number_bool, f_err_teapot},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002161 {"escape", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002162 ret_string, f_escape},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002163 {"eval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002164 ret_any, f_eval},
2165 {"eventhandler", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002166 ret_number_bool, f_eventhandler},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002167 {"executable", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002168 ret_number, f_executable},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002169 {"execute", 1, 2, FEARG_1, arg12_execute,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002170 ret_string, f_execute},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002171 {"exepath", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002172 ret_string, f_exepath},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002173 {"exists", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002174 ret_number_bool, f_exists},
Bram Moolenaar26735992021-08-08 14:43:22 +02002175 {"exists_compiled", 1, 1, FEARG_1, arg1_string,
2176 ret_number_bool, f_exists_compiled},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002177 {"exp", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002178 ret_float, f_exp},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002179 {"expand", 1, 3, FEARG_1, arg3_string_bool_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002180 ret_any, f_expand},
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01002181 {"expandcmd", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002182 ret_string, f_expandcmd},
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01002183 {"extend", 2, 3, FEARG_1, arg23_extend,
Bram Moolenaar81330182022-02-01 12:11:58 +00002184 ret_extend, f_extend},
Bram Moolenaarb0e6b512021-01-12 20:23:40 +01002185 {"extendnew", 2, 3, FEARG_1, arg23_extendnew,
2186 ret_first_cont, f_extendnew},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002187 {"feedkeys", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002188 ret_void, f_feedkeys},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002189 {"file_readable", 1, 1, FEARG_1, arg1_string, // obsolete
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002190 ret_number_bool, f_filereadable},
Shougo Matsushita60c87432024-06-03 22:59:27 +02002191 {"filecopy", 2, 2, FEARG_1, arg2_string,
2192 ret_number_bool, f_filecopy},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002193 {"filereadable", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002194 ret_number_bool, f_filereadable},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002195 {"filewritable", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002196 ret_number, f_filewritable},
Bram Moolenaar18024052021-12-25 21:43:28 +00002197 {"filter", 2, 2, FEARG_1, arg2_filter,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002198 ret_first_arg, f_filter},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002199 {"finddir", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar08018222021-12-22 18:45:37 +00002200 ret_finddir, f_finddir},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002201 {"findfile", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar10c83dd2021-09-04 14:49:56 +02002202 ret_any, f_findfile},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002203 {"flatten", 1, 2, FEARG_1, arg2_list_any_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002204 ret_list_any, f_flatten},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002205 {"flattennew", 1, 2, FEARG_1, arg2_list_any_number,
Bram Moolenaar3b690062021-02-01 20:14:51 +01002206 ret_list_any, f_flattennew},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002207 {"float2nr", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002208 ret_number, f_float2nr},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002209 {"floor", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002210 ret_float, f_floor},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002211 {"fmod", 2, 2, FEARG_1, arg2_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002212 ret_float, f_fmod},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002213 {"fnameescape", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002214 ret_string, f_fnameescape},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002215 {"fnamemodify", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002216 ret_string, f_fnamemodify},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002217 {"foldclosed", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002218 ret_number, f_foldclosed},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002219 {"foldclosedend", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002220 ret_number, f_foldclosedend},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002221 {"foldlevel", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002222 ret_number, f_foldlevel},
2223 {"foldtext", 0, 0, 0, NULL,
2224 ret_string, f_foldtext},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002225 {"foldtextresult", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002226 ret_string, f_foldtextresult},
Ernie Raele79e2072024-01-13 11:47:33 +01002227 {"foreach", 2, 2, FEARG_1, arg2_foreach,
2228 ret_first_arg, f_foreach},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002229 {"foreground", 0, 0, 0, NULL,
2230 ret_void, f_foreground},
Bram Moolenaardd44b582022-09-15 22:03:57 +01002231 {"fullcommand", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar038e09e2021-02-06 12:38:51 +01002232 ret_string, f_fullcommand},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002233 {"funcref", 1, 3, FEARG_1, arg3_any_list_dict,
Bram Moolenaar2f9f4cc2021-12-20 09:36:27 +00002234 ret_func_unknown, f_funcref},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002235 {"function", 1, 3, FEARG_1, arg3_any_list_dict,
Bram Moolenaar2f9f4cc2021-12-20 09:36:27 +00002236 ret_func_unknown, f_function},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002237 {"garbagecollect", 0, 1, 0, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002238 ret_void, f_garbagecollect},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002239 {"get", 2, 3, FEARG_1, arg23_get,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002240 ret_any, f_get},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002241 {"getbufinfo", 0, 1, FEARG_1, arg1_buffer_or_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002242 ret_list_dict_any, f_getbufinfo},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002243 {"getbufline", 2, 3, FEARG_1, arg3_buffer_lnum_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002244 ret_list_string, f_getbufline},
Bram Moolenaarce30ccc2022-11-21 19:57:04 +00002245 {"getbufoneline", 2, 2, FEARG_1, arg2_buffer_lnum,
2246 ret_string, f_getbufoneline},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002247 {"getbufvar", 2, 3, FEARG_1, arg3_buffer_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002248 ret_any, f_getbufvar},
mikoto20001083cae2024-11-11 21:24:14 +01002249 {"getcellpixels", 0, 0, 0, NULL,
mikoto2000a73dfc22024-11-18 21:12:21 +01002250 ret_list_any, f_getcellpixels},
Kota Kato66bb9ae2023-01-17 18:31:56 +00002251 {"getcellwidths", 0, 0, 0, NULL,
2252 ret_list_any, f_getcellwidths},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002253 {"getchangelist", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002254 ret_list_any, f_getchangelist},
zeertzjqe0a2ab32025-02-02 09:14:35 +01002255 {"getchar", 0, 2, 0, arg12_getchar,
Bram Moolenaar3a7503c2021-06-07 18:29:17 +02002256 ret_any, f_getchar},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002257 {"getcharmod", 0, 0, 0, NULL,
2258 ret_number, f_getcharmod},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002259 {"getcharpos", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar6f02b002021-01-10 20:22:54 +01002260 ret_list_number, f_getcharpos},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002261 {"getcharsearch", 0, 0, 0, NULL,
2262 ret_dict_any, f_getcharsearch},
zeertzjqe0a2ab32025-02-02 09:14:35 +01002263 {"getcharstr", 0, 2, 0, arg12_getchar,
Bram Moolenaar3a7503c2021-06-07 18:29:17 +02002264 ret_string, f_getcharstr},
Ruslan Russkikh0407d622024-10-08 22:21:05 +02002265 {"getcmdcomplpat", 0, 0, 0, NULL,
2266 ret_string, f_getcmdcomplpat},
Shougo Matsushita79d599b2022-05-07 12:48:29 +01002267 {"getcmdcompltype", 0, 0, 0, NULL,
2268 ret_string, f_getcmdcompltype},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002269 {"getcmdline", 0, 0, 0, NULL,
2270 ret_string, f_getcmdline},
2271 {"getcmdpos", 0, 0, 0, NULL,
2272 ret_number, f_getcmdpos},
Shougo Matsushita69084282024-09-23 20:34:47 +02002273 {"getcmdprompt", 0, 0, 0, NULL,
2274 ret_string, f_getcmdprompt},
Shougo Matsushita79d599b2022-05-07 12:48:29 +01002275 {"getcmdscreenpos", 0, 0, 0, NULL,
2276 ret_number, f_getcmdscreenpos},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002277 {"getcmdtype", 0, 0, 0, NULL,
2278 ret_string, f_getcmdtype},
2279 {"getcmdwintype", 0, 0, 0, NULL,
2280 ret_string, f_getcmdwintype},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002281 {"getcompletion", 2, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002282 ret_list_string, f_getcompletion},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002283 {"getcurpos", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002284 ret_list_number, f_getcurpos},
Bram Moolenaar82e46e52022-02-05 18:12:34 +00002285 {"getcursorcharpos", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar6f02b002021-01-10 20:22:54 +01002286 ret_list_number, f_getcursorcharpos},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002287 {"getcwd", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002288 ret_string, f_getcwd},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002289 {"getenv", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar7ad67d12021-03-10 16:08:26 +01002290 ret_any, f_getenv},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002291 {"getfontname", 0, 1, 0, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002292 ret_string, f_getfontname},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002293 {"getfperm", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002294 ret_string, f_getfperm},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002295 {"getfsize", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002296 ret_number, f_getfsize},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002297 {"getftime", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002298 ret_number, f_getftime},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002299 {"getftype", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002300 ret_string, f_getftype},
2301 {"getimstatus", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002302 ret_number_bool, f_getimstatus},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002303 {"getjumplist", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002304 ret_list_any, f_getjumplist},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002305 {"getline", 1, 2, FEARG_1, arg2_lnum,
Bram Moolenaar078a4612022-01-04 15:17:03 +00002306 ret_getline, f_getline},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002307 {"getloclist", 1, 2, 0, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002308 ret_list_or_dict_1, f_getloclist},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002309 {"getmarklist", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002310 ret_list_dict_any, f_getmarklist},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002311 {"getmatches", 0, 1, 0, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002312 ret_list_dict_any, f_getmatches},
2313 {"getmousepos", 0, 0, 0, NULL,
2314 ret_dict_number, f_getmousepos},
Bram Moolenaar24dc19c2022-11-14 19:49:15 +00002315 {"getmouseshape", 0, 0, 0, NULL,
2316 ret_string, f_getmouseshape},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002317 {"getpid", 0, 0, 0, NULL,
2318 ret_number, f_getpid},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002319 {"getpos", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002320 ret_list_number, f_getpos},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002321 {"getqflist", 0, 1, 0, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002322 ret_list_or_dict_0, f_getqflist},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002323 {"getreg", 0, 3, FEARG_1, arg3_string_bool_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002324 ret_getreg, f_getreg},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002325 {"getreginfo", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002326 ret_dict_any, f_getreginfo},
Shougo Matsushita19b71882024-02-28 22:48:12 +01002327 {"getregion", 2, 3, FEARG_1, arg3_list_list_dict,
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01002328 ret_list_string, f_getregion},
zeertzjqd4d12072024-07-16 20:34:16 +02002329 {"getregionpos", 2, 3, FEARG_1, arg3_list_list_dict,
2330 ret_list_regionpos, f_getregionpos},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002331 {"getregtype", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002332 ret_string, f_getregtype},
Yegappan Lakshmanan520f6ef2022-08-25 17:40:40 +01002333 {"getscriptinfo", 0, 1, 0, arg1_dict_any,
Yegappan Lakshmananf768c3d2022-08-22 13:15:13 +01002334 ret_list_dict_any, f_getscriptinfo},
ichizok663d18d2025-01-02 18:06:00 +01002335 {"getstacktrace", 0, 0, 0, NULL,
2336 ret_list_dict_any, f_getstacktrace},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002337 {"gettabinfo", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002338 ret_list_dict_any, f_gettabinfo},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002339 {"gettabvar", 2, 3, FEARG_1, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002340 ret_any, f_gettabvar},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002341 {"gettabwinvar", 3, 4, FEARG_1, arg4_number_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002342 ret_any, f_gettabwinvar},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002343 {"gettagstack", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002344 ret_dict_any, f_gettagstack},
Christ van Willegence0ef912024-06-20 23:41:59 +02002345 {"gettext", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002346 ret_string, f_gettext},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002347 {"getwininfo", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002348 ret_list_dict_any, f_getwininfo},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002349 {"getwinpos", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002350 ret_list_number, f_getwinpos},
2351 {"getwinposx", 0, 0, 0, NULL,
2352 ret_number, f_getwinposx},
2353 {"getwinposy", 0, 0, 0, NULL,
2354 ret_number, f_getwinposy},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002355 {"getwinvar", 2, 3, FEARG_1, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002356 ret_any, f_getwinvar},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002357 {"glob", 1, 4, FEARG_1, arg14_glob,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002358 ret_any, f_glob},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002359 {"glob2regpat", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002360 ret_string, f_glob2regpat},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002361 {"globpath", 2, 5, FEARG_2, arg25_globpath,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002362 ret_any, f_globpath},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002363 {"has", 1, 2, 0, arg2_string_bool,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002364 ret_number_bool, f_has},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002365 {"has_key", 2, 2, FEARG_1, arg2_dict_any_string_or_nr,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002366 ret_number_bool, f_has_key},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002367 {"haslocaldir", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002368 ret_number, f_haslocaldir},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002369 {"hasmapto", 1, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002370 ret_number_bool, f_hasmapto},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002371 {"highlightID", 1, 1, FEARG_1, arg1_string, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02002372 ret_number, f_hlID},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002373 {"highlight_exists",1, 1, FEARG_1, arg1_string, // obsolete
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002374 ret_number_bool, f_hlexists},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002375 {"histadd", 2, 2, FEARG_2, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002376 ret_number_bool, f_histadd},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002377 {"histdel", 1, 2, FEARG_1, arg2_string_string_or_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002378 ret_number_bool, f_histdel},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002379 {"histget", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002380 ret_string, f_histget},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002381 {"histnr", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002382 ret_number, f_histnr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002383 {"hlID", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002384 ret_number, f_hlID},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002385 {"hlexists", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002386 ret_number_bool, f_hlexists},
Yegappan Lakshmanand1a8d652021-11-03 21:56:45 +00002387 {"hlget", 0, 2, FEARG_1, arg2_string_bool,
2388 ret_list_dict_any, f_hlget},
2389 {"hlset", 1, 1, FEARG_1, arg1_list_any,
2390 ret_number_bool, f_hlset},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002391 {"hostname", 0, 0, 0, NULL,
2392 ret_string, f_hostname},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002393 {"iconv", 3, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002394 ret_string, f_iconv},
Ernie Raelc8e158b2024-07-09 18:39:52 +02002395 {"id", 1, 1, FEARG_1, NULL,
2396 ret_string, f_id},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002397 {"indent", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002398 ret_number, f_indent},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002399 {"index", 2, 4, FEARG_1, arg24_index,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002400 ret_number, f_index},
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01002401 {"indexof", 2, 3, FEARG_1, arg23_index,
2402 ret_number, f_indexof},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002403 {"input", 1, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002404 ret_string, f_input},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002405 {"inputdialog", 1, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002406 ret_string, f_inputdialog},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002407 {"inputlist", 1, 1, FEARG_1, arg1_list_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002408 ret_number, f_inputlist},
2409 {"inputrestore", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002410 ret_number_bool, f_inputrestore},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002411 {"inputsave", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002412 ret_number_bool, f_inputsave},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002413 {"inputsecret", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002414 ret_string, f_inputsecret},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002415 {"insert", 2, 3, FEARG_1, arg23_insert,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002416 ret_first_arg, f_insert},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002417 {"instanceof", 2, VARGS, FEARG_1|FE_X, arg2_instanceof,
LemonBoyafe04662023-08-23 21:08:11 +02002418 ret_bool, f_instanceof},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002419 {"interrupt", 0, 0, 0, NULL,
2420 ret_void, f_interrupt},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002421 {"invert", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002422 ret_number, f_invert},
LemonBoydca1d402022-04-28 15:26:33 +01002423 {"isabsolutepath", 1, 1, FEARG_1, arg1_string,
2424 ret_number_bool, f_isabsolutepath},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002425 {"isdirectory", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002426 ret_number_bool, f_isdirectory},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002427 {"isinf", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002428 ret_number, MATH_FUNC(f_isinf)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002429 {"islocked", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002430 ret_number_bool, f_islocked},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002431 {"isnan", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002432 ret_number_bool, MATH_FUNC(f_isnan)},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01002433 {"items", 1, 1, FEARG_1, arg1_string_list_tuple_or_dict,
Bram Moolenaarefc5db52021-07-07 21:21:30 +02002434 ret_list_items, f_items},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002435 {"job_getchannel", 1, 1, FEARG_1, arg1_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002436 ret_channel, JOB_FUNC(f_job_getchannel)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002437 {"job_info", 0, 1, FEARG_1, arg1_job,
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01002438 ret_job_info, JOB_FUNC(f_job_info)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002439 {"job_setoptions", 2, 2, FEARG_1, arg2_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002440 ret_void, JOB_FUNC(f_job_setoptions)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002441 {"job_start", 1, 2, FEARG_1, arg2_string_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002442 ret_job, JOB_FUNC(f_job_start)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002443 {"job_status", 1, 1, FEARG_1, arg1_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002444 ret_string, JOB_FUNC(f_job_status)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002445 {"job_stop", 1, 2, FEARG_1, arg2_job_string_or_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002446 ret_number_bool, JOB_FUNC(f_job_stop)},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01002447 {"join", 1, 2, FEARG_1, arg2_list_or_tuple_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002448 ret_string, f_join},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002449 {"js_decode", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002450 ret_any, f_js_decode},
2451 {"js_encode", 1, 1, FEARG_1, NULL,
2452 ret_string, f_js_encode},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002453 {"json_decode", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002454 ret_any, f_json_decode},
2455 {"json_encode", 1, 1, FEARG_1, NULL,
2456 ret_string, f_json_encode},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002457 {"keys", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002458 ret_list_string, f_keys},
zeertzjqcdc83932022-09-12 13:38:41 +01002459 {"keytrans", 1, 1, FEARG_1, arg1_string,
2460 ret_string, f_keytrans},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002461 {"last_buffer_nr", 0, 0, 0, NULL, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02002462 ret_number, f_last_buffer_nr},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002463 {"len", 1, 1, FEARG_1, arg1_len,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002464 ret_number, f_len},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002465 {"libcall", 3, 3, FEARG_3, arg3_libcall,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002466 ret_string, f_libcall},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002467 {"libcallnr", 3, 3, FEARG_3, arg3_libcall,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002468 ret_number, f_libcallnr},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002469 {"line", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002470 ret_number, f_line},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002471 {"line2byte", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002472 ret_number, f_line2byte},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002473 {"lispindent", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002474 ret_number, f_lispindent},
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +02002475 {"list2blob", 1, 1, FEARG_1, arg1_list_number,
2476 ret_blob, f_list2blob},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002477 {"list2str", 1, 2, FEARG_1, arg2_list_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002478 ret_string, f_list2str},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01002479 {"list2tuple", 1, 1, FEARG_1, arg1_list_any,
2480 ret_tuple_any, f_list2tuple},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002481 {"listener_add", 1, 2, FEARG_2, arg2_any_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002482 ret_number, f_listener_add},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002483 {"listener_flush", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002484 ret_void, f_listener_flush},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002485 {"listener_remove", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002486 ret_number_bool, f_listener_remove},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002487 {"localtime", 0, 0, 0, NULL,
2488 ret_number, f_localtime},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002489 {"log", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002490 ret_float, f_log},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002491 {"log10", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002492 ret_float, f_log10},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002493 {"luaeval", 1, 2, FEARG_1, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002494 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002495#ifdef FEAT_LUA
Bram Moolenaar15c47602020-03-26 22:16:48 +01002496 f_luaeval
2497#else
2498 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002499#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002500 },
Bram Moolenaar18024052021-12-25 21:43:28 +00002501 {"map", 2, 2, FEARG_1, arg2_map,
Bram Moolenaarea696852020-11-09 18:31:39 +01002502 ret_first_cont, f_map},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002503 {"maparg", 1, 4, FEARG_1, arg14_maparg,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002504 ret_maparg, f_maparg},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002505 {"mapcheck", 1, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002506 ret_string, f_mapcheck},
Ernie Rael09661202022-04-25 14:40:44 +01002507 {"maplist", 0, 1, 0, arg1_bool,
2508 ret_list_dict_any, f_maplist},
Bram Moolenaar18024052021-12-25 21:43:28 +00002509 {"mapnew", 2, 2, FEARG_1, arg2_mapnew,
Bram Moolenaarea696852020-11-09 18:31:39 +01002510 ret_first_cont, f_mapnew},
Ernie Rael51d04d12022-05-04 15:40:22 +01002511 {"mapset", 1, 3, FEARG_1, arg3_string_or_dict_bool_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002512 ret_void, f_mapset},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002513 {"match", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002514 ret_any, f_match},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002515 {"matchadd", 2, 5, FEARG_1, arg25_matchadd,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002516 ret_number, f_matchadd},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002517 {"matchaddpos", 2, 5, FEARG_1, arg25_matchaddpos,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002518 ret_number, f_matchaddpos},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002519 {"matcharg", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002520 ret_list_string, f_matcharg},
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01002521 {"matchbufline", 4, 5, FEARG_1, arg45_matchbufline,
2522 ret_list_any, f_matchbufline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002523 {"matchdelete", 1, 2, FEARG_1, arg2_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002524 ret_number_bool, f_matchdelete},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002525 {"matchend", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002526 ret_number, f_matchend},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002527 {"matchfuzzy", 2, 3, FEARG_1, arg3_list_string_dict,
Yegappan Lakshmanan2d8e9982023-06-24 16:42:25 +01002528 ret_list_any, f_matchfuzzy},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002529 {"matchfuzzypos", 2, 3, FEARG_1, arg3_list_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002530 ret_list_any, f_matchfuzzypos},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002531 {"matchlist", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002532 ret_list_string, f_matchlist},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002533 {"matchstr", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002534 ret_string, f_matchstr},
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01002535 {"matchstrlist", 2, 3, FEARG_1, arg23_matchstrlist,
2536 ret_list_any, f_matchstrlist},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002537 {"matchstrpos", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002538 ret_list_any, f_matchstrpos},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01002539 {"max", 1, 1, FEARG_1, arg1_list_or_tuple_or_dict,
Bram Moolenaar9ae37052021-01-22 22:31:10 +01002540 ret_number, f_max},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002541 {"menu_info", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002542 ret_dict_any,
Bram Moolenaara2cbdea2020-03-16 21:08:31 +01002543#ifdef FEAT_MENU
Bram Moolenaar15c47602020-03-26 22:16:48 +01002544 f_menu_info
2545#else
2546 NULL
Bram Moolenaara2cbdea2020-03-16 21:08:31 +01002547#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002548 },
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01002549 {"min", 1, 1, FEARG_1, arg1_list_or_tuple_or_dict,
Bram Moolenaar9ae37052021-01-22 22:31:10 +01002550 ret_number, f_min},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002551 {"mkdir", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002552 ret_number_bool, f_mkdir},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002553 {"mode", 0, 1, FEARG_1, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002554 ret_string, f_mode},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002555 {"mzeval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002556 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002557#ifdef FEAT_MZSCHEME
Bram Moolenaar15c47602020-03-26 22:16:48 +01002558 f_mzeval
2559#else
2560 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002561#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002562 },
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002563 {"nextnonblank", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002564 ret_number, f_nextnonblank},
Christ van Willegenc0786752025-02-01 15:42:16 +01002565 {"ngettext", 3, 4, FEARG_3, arg4_string_string_number_string,
2566 ret_string, f_ngettext},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002567 {"nr2char", 1, 2, FEARG_1, arg2_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002568 ret_string, f_nr2char},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002569 {"or", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002570 ret_number, f_or},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002571 {"pathshorten", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002572 ret_string, f_pathshorten},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002573 {"perleval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002574 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002575#ifdef FEAT_PERL
Bram Moolenaar15c47602020-03-26 22:16:48 +01002576 f_perleval
2577#else
2578 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002579#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002580 },
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002581 {"popup_atcursor", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002582 ret_number, PROP_FUNC(f_popup_atcursor)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002583 {"popup_beval", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002584 ret_number, PROP_FUNC(f_popup_beval)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002585 {"popup_clear", 0, 1, 0, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002586 ret_void, PROP_FUNC(f_popup_clear)},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002587 {"popup_close", 1, 2, FEARG_1, arg2_number_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002588 ret_void, PROP_FUNC(f_popup_close)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002589 {"popup_create", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002590 ret_number, PROP_FUNC(f_popup_create)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002591 {"popup_dialog", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002592 ret_number, PROP_FUNC(f_popup_dialog)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002593 {"popup_filter_menu", 2, 2, 0, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002594 ret_bool, PROP_FUNC(f_popup_filter_menu)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002595 {"popup_filter_yesno", 2, 2, 0, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002596 ret_bool, PROP_FUNC(f_popup_filter_yesno)},
Bram Moolenaarbdc09a12022-10-07 14:31:45 +01002597 {"popup_findecho", 0, 0, 0, NULL,
2598 ret_number, PROP_FUNC(f_popup_findecho)},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002599 {"popup_findinfo", 0, 0, 0, NULL,
2600 ret_number, PROP_FUNC(f_popup_findinfo)},
2601 {"popup_findpreview", 0, 0, 0, NULL,
2602 ret_number, PROP_FUNC(f_popup_findpreview)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002603 {"popup_getoptions", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002604 ret_dict_any, PROP_FUNC(f_popup_getoptions)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002605 {"popup_getpos", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002606 ret_dict_any, PROP_FUNC(f_popup_getpos)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002607 {"popup_hide", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002608 ret_void, PROP_FUNC(f_popup_hide)},
2609 {"popup_list", 0, 0, 0, NULL,
2610 ret_list_number, PROP_FUNC(f_popup_list)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002611 {"popup_locate", 2, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002612 ret_number, PROP_FUNC(f_popup_locate)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002613 {"popup_menu", 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_menu)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002615 {"popup_move", 2, 2, FEARG_1, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002616 ret_void, PROP_FUNC(f_popup_move)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002617 {"popup_notification", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002618 ret_number, PROP_FUNC(f_popup_notification)},
Christian Brabandtfbc37f12024-06-18 20:50:58 +02002619 {"popup_setbuf", 2, 2, FEARG_1, arg2_number_buffer,
2620 ret_number_bool, PROP_FUNC(f_popup_setbuf)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002621 {"popup_setoptions", 2, 2, FEARG_1, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002622 ret_void, PROP_FUNC(f_popup_setoptions)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002623 {"popup_settext", 2, 2, FEARG_1, arg2_number_string_or_list,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002624 ret_void, PROP_FUNC(f_popup_settext)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002625 {"popup_show", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002626 ret_void, PROP_FUNC(f_popup_show)},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002627 {"pow", 2, 2, FEARG_1, arg2_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002628 ret_float, f_pow},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002629 {"prevnonblank", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002630 ret_number, f_prevnonblank},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002631 {"printf", 1, 19, FEARG_2, arg119_printf,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002632 ret_string, f_printf},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002633 {"prompt_getprompt", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002634 ret_string, JOB_FUNC(f_prompt_getprompt)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002635 {"prompt_setcallback", 2, 2, FEARG_1, arg2_buffer_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002636 ret_void, JOB_FUNC(f_prompt_setcallback)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002637 {"prompt_setinterrupt", 2, 2, FEARG_1, arg2_buffer_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002638 ret_void, JOB_FUNC(f_prompt_setinterrupt)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002639 {"prompt_setprompt", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002640 ret_void, JOB_FUNC(f_prompt_setprompt)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002641 {"prop_add", 3, 3, FEARG_1, arg3_number_number_dict,
Bram Moolenaar7f9969c2022-07-25 18:13:54 +01002642 ret_number, PROP_FUNC(f_prop_add)},
Yegappan Lakshmananccfb7c62021-08-16 21:39:09 +02002643 {"prop_add_list", 2, 2, FEARG_1, arg2_dict_any_list_any,
2644 ret_void, PROP_FUNC(f_prop_add_list)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002645 {"prop_clear", 1, 3, FEARG_1, arg3_number_number_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002646 ret_void, PROP_FUNC(f_prop_clear)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002647 {"prop_find", 1, 2, FEARG_1, arg2_dict_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002648 ret_dict_any, PROP_FUNC(f_prop_find)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002649 {"prop_list", 1, 2, FEARG_1, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002650 ret_list_dict_any, PROP_FUNC(f_prop_list)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002651 {"prop_remove", 1, 3, FEARG_1, arg3_dict_number_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002652 ret_number, PROP_FUNC(f_prop_remove)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002653 {"prop_type_add", 2, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002654 ret_void, PROP_FUNC(f_prop_type_add)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002655 {"prop_type_change", 2, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002656 ret_void, PROP_FUNC(f_prop_type_change)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002657 {"prop_type_delete", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002658 ret_void, PROP_FUNC(f_prop_type_delete)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002659 {"prop_type_get", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002660 ret_dict_any, PROP_FUNC(f_prop_type_get)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002661 {"prop_type_list", 0, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002662 ret_list_string, PROP_FUNC(f_prop_type_list)},
2663 {"pum_getpos", 0, 0, 0, NULL,
2664 ret_dict_number, f_pum_getpos},
2665 {"pumvisible", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002666 ret_number_bool, f_pumvisible},
Ben Jacksonea19e782024-11-06 21:50:05 +01002667 {"py3eval", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002668 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002669#ifdef FEAT_PYTHON3
Bram Moolenaar15c47602020-03-26 22:16:48 +01002670 f_py3eval
2671#else
2672 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002673#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002674 },
Ben Jacksonea19e782024-11-06 21:50:05 +01002675 {"pyeval", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002676 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002677#ifdef FEAT_PYTHON
Bram Moolenaar15c47602020-03-26 22:16:48 +01002678 f_pyeval
2679#else
2680 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002681#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002682 },
Ben Jacksonea19e782024-11-06 21:50:05 +01002683 {"pyxeval", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002684 ret_any,
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01002685#if defined(FEAT_PYTHON) || defined(FEAT_PYTHON3)
Bram Moolenaar15c47602020-03-26 22:16:48 +01002686 f_pyxeval
2687#else
2688 NULL
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01002689#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002690 },
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002691 {"rand", 0, 1, FEARG_1, arg1_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002692 ret_number, f_rand},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002693 {"range", 1, 3, FEARG_1, arg3_number,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00002694 ret_list_number, f_range},
K.Takata11df3ae2022-10-19 14:02:40 +01002695 {"readblob", 1, 3, FEARG_1, arg3_string_number_number,
Bram Moolenaarc423ad72021-01-13 20:38:03 +01002696 ret_blob, f_readblob},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002697 {"readdir", 1, 3, FEARG_1, arg3_string_any_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002698 ret_list_string, f_readdir},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002699 {"readdirex", 1, 3, FEARG_1, arg3_string_any_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002700 ret_list_dict_any, f_readdirex},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002701 {"readfile", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaarc423ad72021-01-13 20:38:03 +01002702 ret_list_string, f_readfile},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002703 {"reduce", 2, 3, FEARG_1, arg23_reduce,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002704 ret_any, f_reduce},
2705 {"reg_executing", 0, 0, 0, NULL,
2706 ret_string, f_reg_executing},
2707 {"reg_recording", 0, 0, 0, NULL,
2708 ret_string, f_reg_recording},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002709 {"reltime", 0, 2, FEARG_1, arg2_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002710 ret_list_any, f_reltime},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002711 {"reltimefloat", 1, 1, FEARG_1, arg1_list_number,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002712 ret_float, f_reltimefloat},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002713 {"reltimestr", 1, 1, FEARG_1, arg1_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002714 ret_string, f_reltimestr},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002715 {"remote_expr", 2, 4, FEARG_1, arg24_remote_expr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002716 ret_string, f_remote_expr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002717 {"remote_foreground", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002718 ret_string, f_remote_foreground},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002719 {"remote_peek", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002720 ret_number, f_remote_peek},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002721 {"remote_read", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002722 ret_string, f_remote_read},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002723 {"remote_send", 2, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002724 ret_string, f_remote_send},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002725 {"remote_startserver", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002726 ret_void, f_remote_startserver},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002727 {"remove", 2, 3, FEARG_1, arg23_remove,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002728 ret_remove, f_remove},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002729 {"rename", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002730 ret_number_bool, f_rename},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002731 {"repeat", 2, 2, FEARG_1, arg2_repeat,
Bram Moolenaar1780f082021-07-31 22:03:59 +02002732 ret_repeat, f_repeat},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002733 {"resolve", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002734 ret_string, f_resolve},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01002735 {"reverse", 1, 1, FEARG_1, arg1_reverse,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002736 ret_first_arg, f_reverse},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002737 {"round", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002738 ret_float, f_round},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002739 {"rubyeval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002740 ret_any,
Bram Moolenaare99be0e2019-03-26 22:51:09 +01002741#ifdef FEAT_RUBY
Bram Moolenaar15c47602020-03-26 22:16:48 +01002742 f_rubyeval
2743#else
2744 NULL
Bram Moolenaare99be0e2019-03-26 22:51:09 +01002745#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002746 },
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002747 {"screenattr", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002748 ret_number, f_screenattr},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002749 {"screenchar", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002750 ret_number, f_screenchar},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002751 {"screenchars", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002752 ret_list_number, f_screenchars},
2753 {"screencol", 0, 0, 0, NULL,
2754 ret_number, f_screencol},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002755 {"screenpos", 3, 3, FEARG_1, arg3_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002756 ret_dict_number, f_screenpos},
2757 {"screenrow", 0, 0, 0, NULL,
2758 ret_number, f_screenrow},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002759 {"screenstring", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002760 ret_string, f_screenstring},
Bram Moolenaarcd268012021-07-22 19:11:08 +02002761 {"search", 1, 5, FEARG_1, arg15_search,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002762 ret_number, f_search},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002763 {"searchcount", 0, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002764 ret_dict_any, f_searchcount},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002765 {"searchdecl", 1, 3, FEARG_1, arg3_string_bool_bool,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002766 ret_number_bool, f_searchdecl},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002767 {"searchpair", 3, 7, 0, arg37_searchpair,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002768 ret_number, f_searchpair},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002769 {"searchpairpos", 3, 7, 0, arg37_searchpair,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002770 ret_list_number, f_searchpairpos},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002771 {"searchpos", 1, 5, FEARG_1, arg15_search,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002772 ret_list_number, f_searchpos},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002773 {"server2client", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002774 ret_number_bool, f_server2client},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002775 {"serverlist", 0, 0, 0, NULL,
2776 ret_string, f_serverlist},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002777 {"setbufline", 3, 3, FEARG_3, arg3_setbufline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002778 ret_number_bool, f_setbufline},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002779 {"setbufvar", 3, 3, FEARG_3, arg3_buffer_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002780 ret_void, f_setbufvar},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002781 {"setcellwidths", 1, 1, FEARG_1, arg1_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002782 ret_void, f_setcellwidths},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002783 {"setcharpos", 2, 2, FEARG_2, arg2_string_list_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002784 ret_number_bool, f_setcharpos},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002785 {"setcharsearch", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002786 ret_void, f_setcharsearch},
Shougo Matsushita07ea5f12022-08-27 12:22:25 +01002787 {"setcmdline", 1, 2, FEARG_1, arg2_string_number,
2788 ret_number_bool, f_setcmdline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002789 {"setcmdpos", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002790 ret_number_bool, f_setcmdpos},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002791 {"setcursorcharpos", 1, 3, FEARG_1, arg13_cursor,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002792 ret_number_bool, f_setcursorcharpos},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002793 {"setenv", 2, 2, FEARG_2, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002794 ret_void, f_setenv},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002795 {"setfperm", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002796 ret_number_bool, f_setfperm},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002797 {"setline", 2, 2, FEARG_2, arg2_setline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002798 ret_number_bool, f_setline},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002799 {"setloclist", 2, 4, FEARG_2, arg24_setloclist,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002800 ret_number_bool, f_setloclist},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002801 {"setmatches", 1, 2, FEARG_1, arg2_list_any_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002802 ret_number_bool, f_setmatches},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002803 {"setpos", 2, 2, FEARG_2, arg2_string_list_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002804 ret_number_bool, f_setpos},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002805 {"setqflist", 1, 3, FEARG_1, arg13_setqflist,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002806 ret_number_bool, f_setqflist},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002807 {"setreg", 2, 3, FEARG_2, arg3_string_any_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002808 ret_number_bool, f_setreg},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002809 {"settabvar", 3, 3, FEARG_3, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002810 ret_void, f_settabvar},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002811 {"settabwinvar", 4, 4, FEARG_4, arg4_number_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002812 ret_void, f_settabwinvar},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002813 {"settagstack", 2, 3, FEARG_2, arg23_settagstack,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002814 ret_number_bool, f_settagstack},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002815 {"setwinvar", 3, 3, FEARG_3, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002816 ret_void, f_setwinvar},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002817 {"sha256", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002818 ret_string,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002819#ifdef FEAT_CRYPT
Bram Moolenaar15c47602020-03-26 22:16:48 +01002820 f_sha256
2821#else
2822 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002823#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002824 },
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002825 {"shellescape", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002826 ret_string, f_shellescape},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002827 {"shiftwidth", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002828 ret_number, f_shiftwidth},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002829 {"sign_define", 1, 2, FEARG_1, arg2_string_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002830 ret_any, SIGN_FUNC(f_sign_define)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002831 {"sign_getdefined", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002832 ret_list_dict_any, SIGN_FUNC(f_sign_getdefined)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002833 {"sign_getplaced", 0, 2, FEARG_1, arg02_sign_getplaced,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002834 ret_list_dict_any, SIGN_FUNC(f_sign_getplaced)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002835 {"sign_jump", 3, 3, FEARG_1, arg3_number_string_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002836 ret_number, SIGN_FUNC(f_sign_jump)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002837 {"sign_place", 4, 5, FEARG_1, arg45_sign_place,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002838 ret_number, SIGN_FUNC(f_sign_place)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002839 {"sign_placelist", 1, 1, FEARG_1, arg1_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002840 ret_list_number, SIGN_FUNC(f_sign_placelist)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002841 {"sign_undefine", 0, 1, FEARG_1, arg1_string_or_list_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002842 ret_number_bool, SIGN_FUNC(f_sign_undefine)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002843 {"sign_unplace", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002844 ret_number_bool, SIGN_FUNC(f_sign_unplace)},
Sean Dewara63780b2021-11-03 13:15:47 +00002845 {"sign_unplacelist", 1, 1, FEARG_1, arg1_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002846 ret_list_number, SIGN_FUNC(f_sign_unplacelist)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002847 {"simplify", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002848 ret_string, f_simplify},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002849 {"sin", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002850 ret_float, f_sin},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002851 {"sinh", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002852 ret_float, f_sinh},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002853 {"slice", 2, 3, FEARG_1, arg23_slice,
Bram Moolenaar00eb9952022-02-05 19:23:18 +00002854 ret_slice, f_slice},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002855 {"sort", 1, 3, FEARG_1, arg13_sortuniq,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002856 ret_first_arg, f_sort},
2857 {"sound_clear", 0, 0, 0, NULL,
2858 ret_void, SOUND_FUNC(f_sound_clear)},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002859 {"sound_playevent", 1, 2, FEARG_1, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002860 ret_number, SOUND_FUNC(f_sound_playevent)},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002861 {"sound_playfile", 1, 2, FEARG_1, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002862 ret_number, SOUND_FUNC(f_sound_playfile)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002863 {"sound_stop", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002864 ret_void, SOUND_FUNC(f_sound_stop)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002865 {"soundfold", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002866 ret_string, f_soundfold},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002867 {"spellbadword", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002868 ret_list_string, f_spellbadword},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002869 {"spellsuggest", 1, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002870 ret_list_string, f_spellsuggest},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002871 {"split", 1, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002872 ret_list_string, f_split},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002873 {"sqrt", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002874 ret_float, f_sqrt},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002875 {"srand", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002876 ret_list_number, f_srand},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002877 {"state", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002878 ret_string, f_state},
Yegappan Lakshmanana11b23c2025-01-16 19:16:42 +01002879 {"str2blob", 1, 2, FEARG_1, arg2_list_string_dict,
Yegappan Lakshmanan1aefe1d2025-01-14 17:29:42 +01002880 ret_blob, f_str2blob},
Bram Moolenaar80a070c2021-08-08 15:51:10 +02002881 {"str2float", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002882 ret_float, f_str2float},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002883 {"str2list", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002884 ret_list_number, f_str2list},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002885 {"str2nr", 1, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002886 ret_number, f_str2nr},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002887 {"strcharlen", 1, 1, FEARG_1, arg1_string_or_nr,
Bram Moolenaar70ce8a12021-03-14 19:02:09 +01002888 ret_number, f_strcharlen},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002889 {"strcharpart", 2, 4, FEARG_1, arg24_strpart,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002890 ret_string, f_strcharpart},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002891 {"strchars", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002892 ret_number, f_strchars},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002893 {"strdisplaywidth", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002894 ret_number, f_strdisplaywidth},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002895 {"strftime", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002896 ret_string,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002897#ifdef HAVE_STRFTIME
Bram Moolenaar15c47602020-03-26 22:16:48 +01002898 f_strftime
2899#else
2900 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002901#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002902 },
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002903 {"strgetchar", 2, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002904 ret_number, f_strgetchar},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002905 {"stridx", 2, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002906 ret_number, f_stridx},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002907 {"string", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002908 ret_string, f_string},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002909 {"strlen", 1, 1, FEARG_1, arg1_string_or_nr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002910 ret_number, f_strlen},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002911 {"strpart", 2, 4, FEARG_1, arg24_strpart,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002912 ret_string, f_strpart},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002913 {"strptime", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002914 ret_number,
Bram Moolenaar10455d42019-11-21 15:36:18 +01002915#ifdef HAVE_STRPTIME
Bram Moolenaar15c47602020-03-26 22:16:48 +01002916 f_strptime
2917#else
2918 NULL
Bram Moolenaar10455d42019-11-21 15:36:18 +01002919#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002920 },
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002921 {"strridx", 2, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002922 ret_number, f_strridx},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002923 {"strtrans", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002924 ret_string, f_strtrans},
Christian Brabandt67672ef2023-04-24 21:09:54 +01002925 {"strutf16len", 1, 2, FEARG_1, arg2_string_bool,
2926 ret_number, f_strutf16len},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002927 {"strwidth", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002928 ret_number, f_strwidth},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002929 {"submatch", 1, 2, FEARG_1, arg2_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002930 ret_string, f_submatch},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002931 {"substitute", 4, 4, FEARG_1, arg4_string_string_any_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002932 ret_string, f_substitute},
Bram Moolenaarc216a7a2022-12-05 13:50:55 +00002933 {"swapfilelist", 0, 0, 0, NULL,
2934 ret_list_string, f_swapfilelist},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002935 {"swapinfo", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002936 ret_dict_any, f_swapinfo},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002937 {"swapname", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002938 ret_string, f_swapname},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002939 {"synID", 3, 3, 0, arg3_lnum_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002940 ret_number, f_synID},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002941 {"synIDattr", 2, 3, FEARG_1, arg3_number_string_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002942 ret_string, f_synIDattr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002943 {"synIDtrans", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002944 ret_number, f_synIDtrans},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002945 {"synconcealed", 2, 2, 0, arg2_lnum_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002946 ret_list_any, f_synconcealed},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002947 {"synstack", 2, 2, 0, arg2_lnum_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002948 ret_list_number, f_synstack},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002949 {"system", 1, 2, FEARG_1, arg12_system,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002950 ret_string, f_system},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002951 {"systemlist", 1, 2, FEARG_1, arg12_system,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002952 ret_list_string, f_systemlist},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002953 {"tabpagebuflist", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002954 ret_list_number, f_tabpagebuflist},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002955 {"tabpagenr", 0, 1, 0, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002956 ret_number, f_tabpagenr},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002957 {"tabpagewinnr", 1, 2, FEARG_1, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002958 ret_number, f_tabpagewinnr},
2959 {"tagfiles", 0, 0, 0, NULL,
2960 ret_list_string, f_tagfiles},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002961 {"taglist", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002962 ret_list_dict_any, f_taglist},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002963 {"tan", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002964 ret_float, f_tan},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002965 {"tanh", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002966 ret_float, f_tanh},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002967 {"tempname", 0, 0, 0, NULL,
2968 ret_string, f_tempname},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002969 {"term_dumpdiff", 2, 3, FEARG_1, arg3_string_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002970 ret_number, TERM_FUNC(f_term_dumpdiff)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002971 {"term_dumpload", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002972 ret_number, TERM_FUNC(f_term_dumpload)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002973 {"term_dumpwrite", 2, 3, FEARG_2, arg3_buffer_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002974 ret_void, TERM_FUNC(f_term_dumpwrite)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002975 {"term_getaltscreen", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002976 ret_number, TERM_FUNC(f_term_getaltscreen)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002977 {"term_getansicolors", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002978 ret_list_string,
Bram Moolenaarbd5e6222020-03-26 23:13:34 +01002979#if defined(FEAT_TERMINAL) && (defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS))
Bram Moolenaar15c47602020-03-26 22:16:48 +01002980 f_term_getansicolors
2981#else
2982 NULL
Bram Moolenaarc6df10e2017-07-29 20:15:08 +02002983#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002984 },
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002985 {"term_getattr", 2, 2, FEARG_1, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002986 ret_number, TERM_FUNC(f_term_getattr)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002987 {"term_getcursor", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002988 ret_list_any, TERM_FUNC(f_term_getcursor)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002989 {"term_getjob", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002990 ret_job, TERM_FUNC(f_term_getjob)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002991 {"term_getline", 2, 2, FEARG_1, arg2_buffer_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002992 ret_string, TERM_FUNC(f_term_getline)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002993 {"term_getscrolled", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002994 ret_number, TERM_FUNC(f_term_getscrolled)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002995 {"term_getsize", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002996 ret_list_number, TERM_FUNC(f_term_getsize)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002997 {"term_getstatus", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002998 ret_string, TERM_FUNC(f_term_getstatus)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002999 {"term_gettitle", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003000 ret_string, TERM_FUNC(f_term_gettitle)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003001 {"term_gettty", 1, 2, FEARG_1, arg2_buffer_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003002 ret_string, TERM_FUNC(f_term_gettty)},
3003 {"term_list", 0, 0, 0, NULL,
3004 ret_list_number, TERM_FUNC(f_term_list)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003005 {"term_scrape", 2, 2, FEARG_1, arg2_buffer_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003006 ret_list_dict_any, TERM_FUNC(f_term_scrape)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003007 {"term_sendkeys", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003008 ret_void, TERM_FUNC(f_term_sendkeys)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003009 {"term_setansicolors", 2, 2, FEARG_1, arg2_buffer_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003010 ret_void,
Bram Moolenaarbd5e6222020-03-26 23:13:34 +01003011#if defined(FEAT_TERMINAL) && (defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS))
Bram Moolenaar15c47602020-03-26 22:16:48 +01003012 f_term_setansicolors
3013#else
3014 NULL
3015#endif
3016 },
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003017 {"term_setapi", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003018 ret_void, TERM_FUNC(f_term_setapi)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003019 {"term_setkill", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003020 ret_void, TERM_FUNC(f_term_setkill)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003021 {"term_setrestore", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003022 ret_void, TERM_FUNC(f_term_setrestore)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003023 {"term_setsize", 3, 3, FEARG_1, arg3_buffer_number_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003024 ret_void, TERM_FUNC(f_term_setsize)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003025 {"term_start", 1, 2, FEARG_1, arg2_string_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003026 ret_number, TERM_FUNC(f_term_start)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003027 {"term_wait", 1, 2, FEARG_1, arg2_buffer_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003028 ret_void, TERM_FUNC(f_term_wait)},
3029 {"terminalprops", 0, 0, 0, NULL,
3030 ret_dict_string, f_terminalprops},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003031 {"test_alloc_fail", 3, 3, FEARG_1, arg3_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003032 ret_void, f_test_alloc_fail},
3033 {"test_autochdir", 0, 0, 0, NULL,
3034 ret_void, f_test_autochdir},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003035 {"test_feedinput", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003036 ret_void, f_test_feedinput},
3037 {"test_garbagecollect_now", 0, 0, 0, NULL,
3038 ret_void, f_test_garbagecollect_now},
3039 {"test_garbagecollect_soon", 0, 0, 0, NULL,
3040 ret_void, f_test_garbagecollect_soon},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003041 {"test_getvalue", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003042 ret_number, f_test_getvalue},
Yegappan Lakshmanan06011e12022-01-30 12:37:29 +00003043 {"test_gui_event", 2, 2, FEARG_1, arg2_string_dict,
3044 ret_bool, f_test_gui_event},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003045 {"test_ignore_error", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003046 ret_void, f_test_ignore_error},
Christopher Plewright20b795e2022-12-20 20:01:58 +00003047 {"test_mswin_event", 2, 2, FEARG_1, arg2_string_dict,
3048 ret_number, f_test_mswin_event},
Bram Moolenaar94738d82020-10-21 14:25:07 +02003049 {"test_null_blob", 0, 0, 0, NULL,
3050 ret_blob, f_test_null_blob},
3051 {"test_null_channel", 0, 0, 0, NULL,
3052 ret_channel, JOB_FUNC(f_test_null_channel)},
3053 {"test_null_dict", 0, 0, 0, NULL,
3054 ret_dict_any, f_test_null_dict},
3055 {"test_null_function", 0, 0, 0, NULL,
3056 ret_func_any, f_test_null_function},
3057 {"test_null_job", 0, 0, 0, NULL,
3058 ret_job, JOB_FUNC(f_test_null_job)},
3059 {"test_null_list", 0, 0, 0, NULL,
3060 ret_list_any, f_test_null_list},
3061 {"test_null_partial", 0, 0, 0, NULL,
3062 ret_func_any, f_test_null_partial},
3063 {"test_null_string", 0, 0, 0, NULL,
3064 ret_string, f_test_null_string},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01003065 {"test_null_tuple", 0, 0, 0, NULL,
3066 ret_tuple_any, f_test_null_tuple},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003067 {"test_option_not_set", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003068 ret_void, f_test_option_not_set},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02003069 {"test_override", 2, 2, FEARG_2, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003070 ret_void, f_test_override},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003071 {"test_refcount", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003072 ret_number, f_test_refcount},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003073 {"test_setmouse", 2, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003074 ret_void, f_test_setmouse},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003075 {"test_settime", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003076 ret_void, f_test_settime},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02003077 {"test_srand_seed", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003078 ret_void, f_test_srand_seed},
3079 {"test_unknown", 0, 0, 0, NULL,
3080 ret_any, f_test_unknown},
3081 {"test_void", 0, 0, 0, NULL,
3082 ret_void, f_test_void},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02003083 {"timer_info", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003084 ret_list_dict_any, TIMER_FUNC(f_timer_info)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02003085 {"timer_pause", 2, 2, FEARG_1, arg2_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003086 ret_void, TIMER_FUNC(f_timer_pause)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02003087 {"timer_start", 2, 3, FEARG_1, arg3_number_any_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003088 ret_number, TIMER_FUNC(f_timer_start)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02003089 {"timer_stop", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003090 ret_void, TIMER_FUNC(f_timer_stop)},
3091 {"timer_stopall", 0, 0, 0, NULL,
3092 ret_void, TIMER_FUNC(f_timer_stopall)},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003093 {"tolower", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003094 ret_string, f_tolower},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003095 {"toupper", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003096 ret_string, f_toupper},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003097 {"tr", 3, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003098 ret_string, f_tr},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003099 {"trim", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003100 ret_string, f_trim},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003101 {"trunc", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01003102 ret_float, f_trunc},
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01003103 {"tuple2list", 1, 1, FEARG_1, arg1_tuple_any,
3104 ret_list_any, f_tuple2list},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003105 {"type", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003106 ret_number, f_type},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003107 {"typename", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaara47e05f2021-01-12 21:49:00 +01003108 ret_string, f_typename},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02003109 {"undofile", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003110 ret_string, f_undofile},
Devin J. Pohly5fee1112023-04-23 20:26:59 -05003111 {"undotree", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003112 ret_dict_any, f_undotree},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02003113 {"uniq", 1, 3, FEARG_1, arg13_sortuniq,
Bram Moolenaar08018222021-12-22 18:45:37 +00003114 ret_first_arg, f_uniq},
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01003115 {"utf16idx", 2, 4, FEARG_1, arg4_string_number_bool_bool,
Christian Brabandt67672ef2023-04-24 21:09:54 +01003116 ret_number, f_utf16idx},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02003117 {"values", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar32517c42023-01-15 18:17:12 +00003118 ret_list_member, f_values},
zeertzjq825cf812023-08-17 22:55:25 +02003119 {"virtcol", 1, 3, FEARG_1, arg3_string_or_list_bool_number,
LemonBoy0f7a3e12022-05-26 12:10:37 +01003120 ret_virtcol, f_virtcol},
Bram Moolenaar5a6ec102022-05-27 21:58:00 +01003121 {"virtcol2col", 3, 3, FEARG_1, arg3_number,
3122 ret_number, f_virtcol2col},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02003123 {"visualmode", 0, 1, 0, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003124 ret_string, f_visualmode},
3125 {"wildmenumode", 0, 0, 0, NULL,
3126 ret_number, f_wildmenumode},
Bram Moolenaar52312242021-07-11 18:23:19 +02003127 {"win_execute", 2, 3, FEARG_2, arg23_win_execute,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003128 ret_string, f_win_execute},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02003129 {"win_findbuf", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003130 ret_list_number, f_win_findbuf},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02003131 {"win_getid", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003132 ret_number, f_win_getid},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003133 {"win_gettype", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003134 ret_string, f_win_gettype},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003135 {"win_gotoid", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01003136 ret_number_bool, f_win_gotoid},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003137 {"win_id2tabwin", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003138 ret_list_number, f_win_id2tabwin},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003139 {"win_id2win", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003140 ret_number, f_win_id2win},
Daniel Steinbergee630312022-01-10 13:36:34 +00003141 {"win_move_separator", 2, 2, FEARG_1, arg2_number,
3142 ret_number_bool, f_win_move_separator},
3143 {"win_move_statusline", 2, 2, FEARG_1, arg2_number,
3144 ret_number_bool, f_win_move_statusline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003145 {"win_screenpos", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003146 ret_list_number, f_win_screenpos},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02003147 {"win_splitmove", 2, 3, FEARG_1, arg3_number_number_dict,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01003148 ret_number_bool, f_win_splitmove},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003149 {"winbufnr", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003150 ret_number, f_winbufnr},
3151 {"wincol", 0, 0, 0, NULL,
3152 ret_number, f_wincol},
3153 {"windowsversion", 0, 0, 0, NULL,
3154 ret_string, f_windowsversion},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003155 {"winheight", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003156 ret_number, f_winheight},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003157 {"winlayout", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003158 ret_list_any, f_winlayout},
3159 {"winline", 0, 0, 0, NULL,
3160 ret_number, f_winline},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02003161 {"winnr", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003162 ret_number, f_winnr},
3163 {"winrestcmd", 0, 0, 0, NULL,
3164 ret_string, f_winrestcmd},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02003165 {"winrestview", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003166 ret_void, f_winrestview},
3167 {"winsaveview", 0, 0, 0, NULL,
Bram Moolenaar43b69b32021-01-07 20:23:33 +01003168 ret_dict_number, f_winsaveview},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003169 {"winwidth", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003170 ret_number, f_winwidth},
3171 {"wordcount", 0, 0, 0, NULL,
3172 ret_dict_number, f_wordcount},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02003173 {"writefile", 2, 3, FEARG_1, arg23_writefile,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01003174 ret_number_bool, f_writefile},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003175 {"xor", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003176 ret_number, f_xor},
Bram Moolenaarac92e252019-08-03 21:58:38 +02003177};
3178
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003179/*
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003180 * Return true if specified function allows a type as an argument.
3181 */
3182 static int
3183func_allows_type(int idx)
3184{
3185 return (global_functions[idx].f_argtype & FE_X) != 0;
3186}
3187
3188/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003189 * Function given to ExpandGeneric() to obtain the list of internal
3190 * or user defined function names.
3191 */
3192 char_u *
3193get_function_name(expand_T *xp, int idx)
3194{
3195 static int intidx = -1;
3196 char_u *name;
3197
3198 if (idx == 0)
3199 intidx = -1;
3200 if (intidx < 0)
3201 {
3202 name = get_user_func_name(xp, idx);
naohiro ono5aec7552021-08-19 21:20:41 +02003203 if (name != NULL)
Bram Moolenaar1bb4de52021-01-13 19:48:46 +01003204 {
naohiro ono5aec7552021-08-19 21:20:41 +02003205 if (*name != NUL && *name != '<'
3206 && STRNCMP("g:", xp->xp_pattern, 2) == 0)
Bram Moolenaar1bb4de52021-01-13 19:48:46 +01003207 return cat_prefix_varname('g', name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003208 return name;
Bram Moolenaar1bb4de52021-01-13 19:48:46 +01003209 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003210 }
K.Takataeeec2542021-06-02 13:28:16 +02003211 if (++intidx < (int)ARRAY_LENGTH(global_functions))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003212 {
Kota Kato90c23532023-01-18 15:27:38 +00003213 // Skip if the function doesn't have an implementation (feature not
3214 // implemented).
3215 if (global_functions[intidx].f_func == NULL)
3216 return (char_u *)"";
Bram Moolenaarac92e252019-08-03 21:58:38 +02003217 STRCPY(IObuff, global_functions[intidx].f_name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003218 STRCAT(IObuff, "(");
Bram Moolenaarac92e252019-08-03 21:58:38 +02003219 if (global_functions[intidx].f_max_argc == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003220 STRCAT(IObuff, ")");
3221 return IObuff;
3222 }
3223
3224 return NULL;
3225}
3226
3227/*
3228 * Function given to ExpandGeneric() to obtain the list of internal or
3229 * user defined variable or function names.
3230 */
3231 char_u *
3232get_expr_name(expand_T *xp, int idx)
3233{
3234 static int intidx = -1;
3235 char_u *name;
3236
3237 if (idx == 0)
3238 intidx = -1;
3239 if (intidx < 0)
3240 {
3241 name = get_function_name(xp, idx);
3242 if (name != NULL)
3243 return name;
3244 }
3245 return get_user_var_name(xp, ++intidx);
3246}
3247
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003248/*
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003249 * Find internal function "name" in table "global_functions".
Bram Moolenaar15c47602020-03-26 22:16:48 +01003250 * Return index, or -1 if not found or "implemented" is TRUE and the function
3251 * is not implemented.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003252 */
Bram Moolenaar15c47602020-03-26 22:16:48 +01003253 static int
3254find_internal_func_opt(char_u *name, int implemented)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003255{
3256 int first = 0;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003257 int last;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003258 int cmp;
3259 int x;
3260
K.Takataeeec2542021-06-02 13:28:16 +02003261 last = (int)ARRAY_LENGTH(global_functions) - 1;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003262
3263 // Find the function name in the table. Binary search.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003264 while (first <= last)
3265 {
3266 x = first + ((unsigned)(last - first) >> 1);
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003267 cmp = STRCMP(name, global_functions[x].f_name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003268 if (cmp < 0)
3269 last = x - 1;
3270 else if (cmp > 0)
3271 first = x + 1;
Bram Moolenaar15c47602020-03-26 22:16:48 +01003272 else if (implemented && global_functions[x].f_func == NULL)
3273 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003274 else
3275 return x;
3276 }
3277 return -1;
3278}
3279
Bram Moolenaar15c47602020-03-26 22:16:48 +01003280/*
3281 * Find internal function "name" in table "global_functions".
3282 * Return index, or -1 if not found or the function is not implemented.
3283 */
3284 int
3285find_internal_func(char_u *name)
3286{
3287 return find_internal_func_opt(name, TRUE);
3288}
3289
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003290 int
Bram Moolenaarac92e252019-08-03 21:58:38 +02003291has_internal_func(char_u *name)
3292{
Bram Moolenaar15c47602020-03-26 22:16:48 +01003293 return find_internal_func_opt(name, TRUE) >= 0;
3294}
3295
3296 static int
3297has_internal_func_name(char_u *name)
3298{
3299 return find_internal_func_opt(name, FALSE) >= 0;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003300}
3301
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003302 char *
3303internal_func_name(int idx)
3304{
3305 return global_functions[idx].f_name;
3306}
3307
Bram Moolenaar94738d82020-10-21 14:25:07 +02003308/*
Dominique Pellefe8ebdb2021-05-13 14:55:55 +02003309 * Check the argument types for builtin function "idx".
Bram Moolenaar94738d82020-10-21 14:25:07 +02003310 * Uses the list of types on the type stack: "types".
3311 * Return FAIL and gives an error message when a type is wrong.
3312 */
3313 int
Bram Moolenaar351ead02021-01-16 16:07:01 +01003314internal_func_check_arg_types(
Bram Moolenaar078a4612022-01-04 15:17:03 +00003315 type2_T *types,
Bram Moolenaar351ead02021-01-16 16:07:01 +01003316 int idx,
3317 int argcount,
3318 cctx_T *cctx)
Bram Moolenaar94738d82020-10-21 14:25:07 +02003319{
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003320 // Some internal functions accept types like Class as arguments. For other
3321 // functions, check the arguments are not types.
3322 if (!(func_allows_type(idx)))
3323 {
zeertzjqd9be94c2024-07-14 10:20:20 +02003324 for (int i = 0; i < argcount; ++i)
3325 if (check_type_is_value(types[i].type_curr) == FAIL)
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003326 return FAIL;
3327 }
3328
Bram Moolenaar94738d82020-10-21 14:25:07 +02003329 argcheck_T *argchecks = global_functions[idx].f_argcheck;
Bram Moolenaar94738d82020-10-21 14:25:07 +02003330
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003331 if (argchecks == NULL)
3332 return OK;
Bram Moolenaar94738d82020-10-21 14:25:07 +02003333
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003334 argcontext_T context;
3335
3336 context.arg_count = argcount;
3337 context.arg_types = types;
3338 context.arg_cctx = cctx;
Ernie Raela8f7f922023-12-14 20:17:04 +01003339 for (int i = 0; i < argcount && argchecks[i] != NULL; ++i)
3340 {
3341 context.arg_idx = i;
3342 if (argchecks[i](types[i].type_curr, types[i].type_decl,
3343 &context) == FAIL)
3344 return FAIL;
3345 }
Bram Moolenaar94738d82020-10-21 14:25:07 +02003346 return OK;
3347}
3348
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003349/*
Bram Moolenaar7a40ff02021-07-04 15:54:08 +02003350 * Get the argument count for function "idx".
3351 * "argcount" is the total argument count, "min_argcount" the non-optional
3352 * argument count.
3353 */
3354 void
3355internal_func_get_argcount(int idx, int *argcount, int *min_argcount)
3356{
3357 *argcount = global_functions[idx].f_max_argc;
3358 *min_argcount = global_functions[idx].f_min_argc;
3359}
3360
3361/*
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003362 * Call the "f_retfunc" function to obtain the return type of function "idx".
Bram Moolenaar81330182022-02-01 12:11:58 +00003363 * "decl_type" is set to the declared type.
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003364 * "argtypes" is the list of argument types or NULL when there are no
3365 * arguments.
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02003366 * "argcount" may be less than the actual count when only getting the type.
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003367 */
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003368 type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00003369internal_func_ret_type(
3370 int idx,
3371 int argcount,
3372 type2_T *argtypes,
Bram Moolenaar32517c42023-01-15 18:17:12 +00003373 type_T **decl_type,
3374 garray_T *type_gap)
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003375{
Bram Moolenaar81330182022-02-01 12:11:58 +00003376 type_T *ret;
3377
Bram Moolenaar32517c42023-01-15 18:17:12 +00003378 current_type_gap = type_gap;
Bram Moolenaar81330182022-02-01 12:11:58 +00003379 *decl_type = NULL;
3380 ret = global_functions[idx].f_retfunc(argcount, argtypes, decl_type);
3381 if (*decl_type == NULL)
3382 *decl_type = ret;
Bram Moolenaar32517c42023-01-15 18:17:12 +00003383 current_type_gap = NULL;
Bram Moolenaar81330182022-02-01 12:11:58 +00003384 return ret;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003385}
3386
3387/*
Bram Moolenaar75ab91f2021-01-10 22:42:50 +01003388 * Return TRUE if "idx" is for the map() function.
3389 */
3390 int
3391internal_func_is_map(int idx)
3392{
3393 return global_functions[idx].f_func == f_map;
3394}
3395
3396/*
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003397 * Check the argument count to use for internal function "idx".
Bram Moolenaar389df252020-07-09 21:20:47 +02003398 * Returns -1 for failure, 0 if no method base accepted, 1 if method base is
3399 * first argument, 2 if method base is second argument, etc. 9 if method base
3400 * is last argument.
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003401 */
3402 int
3403check_internal_func(int idx, int argcount)
3404{
Bram Moolenaar0917e862023-02-18 14:42:44 +00003405 funcerror_T res;
3406 char *name;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003407
3408 if (argcount < global_functions[idx].f_min_argc)
3409 res = FCERR_TOOFEW;
3410 else if (argcount > global_functions[idx].f_max_argc)
3411 res = FCERR_TOOMANY;
3412 else
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003413 return global_functions[idx].f_argtype & FEARG_MASK;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003414
3415 name = internal_func_name(idx);
3416 if (res == FCERR_TOOMANY)
Bram Moolenaare1242042021-12-16 20:56:57 +00003417 semsg(_(e_too_many_arguments_for_function_str), name);
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003418 else
Bram Moolenaare1242042021-12-16 20:56:57 +00003419 semsg(_(e_not_enough_arguments_for_function_str), name);
Bram Moolenaar389df252020-07-09 21:20:47 +02003420 return -1;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003421}
3422
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003423/*
3424 * Some internal functions accept types like Class as arguments. For other
3425 * functions, check the arguments are not types.
3426 *
3427 * Return OK/FAIL.
3428 */
3429 static int
3430check_args_for_type(int idx, int argcount, typval_T *argvars)
3431{
3432 if (!func_allows_type(idx))
3433 {
3434 for (int i = 0; i < argcount; ++i)
3435 if (check_typval_is_value(&argvars[i]) == FAIL)
3436 return FAIL;
3437 }
3438 return OK;
3439}
3440
Bram Moolenaar0917e862023-02-18 14:42:44 +00003441 funcerror_T
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003442call_internal_func(
3443 char_u *name,
3444 int argcount,
3445 typval_T *argvars,
3446 typval_T *rettv)
3447{
3448 int i;
3449
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003450 i = find_internal_func(name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003451 if (i < 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01003452 return FCERR_UNKNOWN;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003453 if (argcount < global_functions[i].f_min_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003454 return FCERR_TOOFEW;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003455 if (argcount > global_functions[i].f_max_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003456 return FCERR_TOOMANY;
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003457 if (check_args_for_type(i, argcount, argvars) == FAIL)
3458 return FCERR_OTHER;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003459 argvars[argcount].v_type = VAR_UNKNOWN;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003460 global_functions[i].f_func(argvars, rettv);
Bram Moolenaaref140542019-12-31 21:27:13 +01003461 return FCERR_NONE;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003462}
3463
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003464 void
3465call_internal_func_by_idx(
3466 int idx,
3467 typval_T *argvars,
3468 typval_T *rettv)
3469{
3470 global_functions[idx].f_func(argvars, rettv);
3471}
3472
Bram Moolenaarac92e252019-08-03 21:58:38 +02003473/*
3474 * Invoke a method for base->method().
3475 */
Bram Moolenaar0917e862023-02-18 14:42:44 +00003476 funcerror_T
Bram Moolenaarac92e252019-08-03 21:58:38 +02003477call_internal_method(
3478 char_u *name,
3479 int argcount,
3480 typval_T *argvars,
3481 typval_T *rettv,
3482 typval_T *basetv)
3483{
Bram Moolenaarac92e252019-08-03 21:58:38 +02003484 int fi;
3485 typval_T argv[MAX_FUNC_ARGS + 1];
3486
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003487 fi = find_internal_func(name);
Bram Moolenaar91746392019-08-16 22:22:31 +02003488 if (fi < 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01003489 return FCERR_UNKNOWN;
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003490 if ((global_functions[fi].f_argtype & FEARG_MASK) == 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01003491 return FCERR_NOTMETHOD;
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003492 if (argcount + 1 < global_functions[fi].f_min_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003493 return FCERR_TOOFEW;
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003494 if (argcount + 1 > global_functions[fi].f_max_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003495 return FCERR_TOOMANY;
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003496 if (check_args_for_type(fi, argcount, argvars) == FAIL)
3497 return FCERR_OTHER;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003498
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003499 if ((global_functions[fi].f_argtype & FEARG_MASK) == FEARG_2)
Bram Moolenaar25e42232019-08-04 15:04:10 +02003500 {
Bram Moolenaarb7f22702023-04-27 16:24:07 +01003501 if (argcount < 1)
3502 return FCERR_TOOFEW;
3503
Bram Moolenaar25e42232019-08-04 15:04:10 +02003504 // base value goes second
3505 argv[0] = argvars[0];
3506 argv[1] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003507 for (int i = 1; i < argcount; ++i)
Bram Moolenaar25e42232019-08-04 15:04:10 +02003508 argv[i + 1] = argvars[i];
3509 }
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003510 else if ((global_functions[fi].f_argtype & FEARG_MASK) == FEARG_3)
Bram Moolenaar24278d22019-08-16 21:49:22 +02003511 {
Bram Moolenaarb7f22702023-04-27 16:24:07 +01003512 if (argcount < 2)
3513 return FCERR_TOOFEW;
3514
Bram Moolenaar24278d22019-08-16 21:49:22 +02003515 // base value goes third
3516 argv[0] = argvars[0];
3517 argv[1] = argvars[1];
3518 argv[2] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003519 for (int i = 2; i < argcount; ++i)
Bram Moolenaar24278d22019-08-16 21:49:22 +02003520 argv[i + 1] = argvars[i];
3521 }
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003522 else if ((global_functions[fi].f_argtype & FEARG_MASK) == FEARG_4)
Bram Moolenaaraad222c2019-09-06 22:46:09 +02003523 {
Bram Moolenaarb7f22702023-04-27 16:24:07 +01003524 if (argcount < 3)
3525 return FCERR_TOOFEW;
3526
Bram Moolenaaraad222c2019-09-06 22:46:09 +02003527 // base value goes fourth
3528 argv[0] = argvars[0];
3529 argv[1] = argvars[1];
3530 argv[2] = argvars[2];
3531 argv[3] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003532 for (int i = 3; i < argcount; ++i)
Bram Moolenaaraad222c2019-09-06 22:46:09 +02003533 argv[i + 1] = argvars[i];
3534 }
Bram Moolenaar25e42232019-08-04 15:04:10 +02003535 else
3536 {
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003537 // FEARG_1: base value goes first
Bram Moolenaar25e42232019-08-04 15:04:10 +02003538 argv[0] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003539 for (int i = 0; i < argcount; ++i)
Bram Moolenaar25e42232019-08-04 15:04:10 +02003540 argv[i + 1] = argvars[i];
3541 }
Bram Moolenaarac92e252019-08-03 21:58:38 +02003542 argv[argcount + 1].v_type = VAR_UNKNOWN;
3543
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003544 if (check_args_for_type(fi, argcount + 1, argv) == FAIL)
3545 return FCERR_OTHER;
3546
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003547 global_functions[fi].f_func(argv, rettv);
Bram Moolenaaref140542019-12-31 21:27:13 +01003548 return FCERR_NONE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003549}
3550
3551/*
3552 * Return TRUE for a non-zero Number and a non-empty String.
3553 */
Bram Moolenaar0e57dd82019-09-16 22:56:03 +02003554 int
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003555non_zero_arg(typval_T *argvars)
3556{
3557 return ((argvars[0].v_type == VAR_NUMBER
3558 && argvars[0].vval.v_number != 0)
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01003559 || (argvars[0].v_type == VAR_BOOL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003560 && argvars[0].vval.v_number == VVAL_TRUE)
3561 || (argvars[0].v_type == VAR_STRING
3562 && argvars[0].vval.v_string != NULL
3563 && *argvars[0].vval.v_string != NUL));
3564}
3565
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003566/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003567 * "and(expr, expr)" function
3568 */
3569 static void
3570f_and(typval_T *argvars, typval_T *rettv)
3571{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003572 if (in_vim9script()
3573 && (check_for_number_arg(argvars, 0) == FAIL
3574 || check_for_number_arg(argvars, 1) == FAIL))
3575 return;
3576
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003577 rettv->vval.v_number = tv_get_number_chk(&argvars[0], NULL)
3578 & tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaarca851592018-06-06 21:04:07 +02003579}
3580
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003581/*
Bram Moolenaar59716a22017-03-01 20:32:44 +01003582 * "balloon_show()" function
3583 */
3584#ifdef FEAT_BEVAL
3585 static void
Bram Moolenaarbe0a2592019-05-09 13:50:16 +02003586f_balloon_gettext(typval_T *argvars UNUSED, typval_T *rettv)
3587{
3588 rettv->v_type = VAR_STRING;
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003589 if (balloonEval == NULL)
3590 return;
3591
3592 if (balloonEval->msg == NULL)
3593 rettv->vval.v_string = NULL;
3594 else
3595 rettv->vval.v_string = vim_strsave(balloonEval->msg);
Bram Moolenaarbe0a2592019-05-09 13:50:16 +02003596}
3597
3598 static void
Bram Moolenaar59716a22017-03-01 20:32:44 +01003599f_balloon_show(typval_T *argvars, typval_T *rettv UNUSED)
3600{
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003601 if (balloonEval == NULL)
3602 return;
3603
3604 if (in_vim9script()
3605 && check_for_string_or_list_arg(argvars, 0) == FAIL)
3606 return;
3607
3608 if (argvars[0].v_type == VAR_LIST
3609# ifdef FEAT_GUI
3610 && !gui.in_use
3611# endif
3612 )
Bram Moolenaar246fe032017-11-19 19:56:27 +01003613 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003614 list_T *l = argvars[0].vval.v_list;
3615
3616 // empty list removes the balloon
3617 post_balloon(balloonEval, NULL,
3618 l == NULL || l->lv_len == 0 ? NULL : l);
3619 }
3620 else
3621 {
3622 char_u *mesg;
3623
3624 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003625 return;
3626
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003627 mesg = tv_get_string_chk(&argvars[0]);
3628 if (mesg != NULL)
3629 // empty string removes the balloon
3630 post_balloon(balloonEval, *mesg == NUL ? NULL : mesg, NULL);
Bram Moolenaar246fe032017-11-19 19:56:27 +01003631 }
3632}
3633
Bram Moolenaar669a8282017-11-19 20:13:05 +01003634# if defined(FEAT_BEVAL_TERM)
Bram Moolenaar246fe032017-11-19 19:56:27 +01003635 static void
3636f_balloon_split(typval_T *argvars, typval_T *rettv UNUSED)
3637{
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003638 if (rettv_list_alloc(rettv) != OK)
3639 return;
3640
3641 char_u *msg;
3642
3643 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
3644 return;
3645 msg = tv_get_string_chk(&argvars[0]);
3646 if (msg != NULL)
Bram Moolenaar246fe032017-11-19 19:56:27 +01003647 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003648 pumitem_T *array;
3649 int size = split_message(msg, &array);
Bram Moolenaar246fe032017-11-19 19:56:27 +01003650
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003651 // Skip the first and last item, they are always empty.
3652 for (int i = 1; i < size - 1; ++i)
3653 list_append_string(rettv->vval.v_list, array[i].pum_text, -1);
3654 while (size > 0)
3655 vim_free(array[--size].pum_text);
3656 vim_free(array);
Bram Moolenaar246fe032017-11-19 19:56:27 +01003657 }
Bram Moolenaar59716a22017-03-01 20:32:44 +01003658}
Bram Moolenaar669a8282017-11-19 20:13:05 +01003659# endif
Bram Moolenaar59716a22017-03-01 20:32:44 +01003660#endif
3661
Yegappan Lakshmanan810785c2024-12-30 10:29:44 +01003662// Base64 character set
3663static const char_u base64_table[] = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
3664
3665// Base64 decoding table (initialized in init_base64_dec_table() below)
3666static char_u base64_dec_table[256];
3667
3668/*
3669 * Initialize the base64 decoding table
3670 */
3671 static void
3672init_base64_dec_table(void)
3673{
3674 static int base64_dec_tbl_initialized = FALSE;
3675
3676 if (base64_dec_tbl_initialized)
3677 return;
3678
3679 // Unsupported characters are set to 0xFF
3680 vim_memset(base64_dec_table, 0xFF, sizeof(base64_dec_table));
3681
3682 // Initialize the index for the base64 alphabets
3683 for (size_t i = 0; i < sizeof(base64_table) - 1; i++)
3684 base64_dec_table[(char_u)base64_table[i]] = (char_u)i;
3685
3686 // base64 padding character
3687 base64_dec_table['='] = 0;
3688
3689 base64_dec_tbl_initialized = TRUE;
3690}
3691
3692/*
3693 * Encode the bytes in "blob" using base-64 encoding.
3694 */
3695 static char_u *
3696base64_encode(blob_T *blob)
3697{
3698 size_t input_len = blob->bv_ga.ga_len;
3699 size_t encoded_len = ((input_len + 2) / 3) * 4;
3700 char_u *data = blob->bv_ga.ga_data;
3701
3702 char_u *encoded = alloc(encoded_len + 1);
3703 if (encoded == NULL)
3704 return NULL;
3705
3706 size_t i, j;
3707 for (i = 0, j = 0; i < input_len;)
3708 {
3709 int_u octet_a = i < input_len ? data[i++] : 0;
3710 int_u octet_b = i < input_len ? data[i++] : 0;
3711 int_u octet_c = i < input_len ? data[i++] : 0;
3712
3713 int_u triple = (octet_a << 16) | (octet_b << 8) | octet_c;
3714
3715 encoded[j++] = base64_table[(triple >> 18) & 0x3F];
3716 encoded[j++] = base64_table[(triple >> 12) & 0x3F];
3717 encoded[j++] = (!octet_b && i >= input_len) ? '='
3718 : base64_table[(triple >> 6) & 0x3F];
3719 encoded[j++] = (!octet_c && i >= input_len) ? '='
3720 : base64_table[triple & 0x3F];
3721 }
3722 encoded[j] = NUL;
3723
3724 return encoded;
3725}
3726
3727/*
3728 * Decode the string "data" using base-64 encoding.
3729 */
3730 static void
3731base64_decode(const char_u *data, blob_T *blob)
3732{
3733 size_t input_len = STRLEN(data);
3734
3735 if (input_len == 0)
3736 return;
3737
3738 if (input_len % 4 != 0)
3739 {
3740 // Invalid input length
3741 semsg(_(e_invalid_argument_str), data);
3742 return;
3743 }
3744
3745 init_base64_dec_table();
3746
3747 size_t decoded_len = (input_len / 4) * 3;
3748 if (data[input_len - 1] == '=')
3749 decoded_len--;
3750 if (data[input_len - 2] == '=')
3751 decoded_len--;
3752
3753 size_t i, j;
3754 for (i = 0, j = 0; i < input_len;)
3755 {
3756 int_u sextet_a = base64_dec_table[(char_u)data[i++]];
3757 int_u sextet_b = base64_dec_table[(char_u)data[i++]];
3758 int_u sextet_c = base64_dec_table[(char_u)data[i++]];
3759 int_u sextet_d = base64_dec_table[(char_u)data[i++]];
3760
3761 if (sextet_a == 0xFF || sextet_b == 0xFF || sextet_c == 0xFF
3762 || sextet_d == 0xFF)
3763 {
3764 // Invalid character
3765 semsg(_(e_invalid_argument_str), data);
3766 ga_clear(&blob->bv_ga);
3767 return;
3768 }
3769
3770 int_u triple = (sextet_a << 18) | (sextet_b << 12)
3771 | (sextet_c << 6) | sextet_d;
3772
3773 if (j < decoded_len)
3774 {
3775 ga_append(&blob->bv_ga, (triple >> 16) & 0xFF);
3776 j++;
3777 }
3778 if (j < decoded_len)
3779 {
3780 ga_append(&blob->bv_ga, (triple >> 8) & 0xFF);
3781 j++;
3782 }
3783 if (j < decoded_len)
3784 {
3785 ga_append(&blob->bv_ga, triple & 0xFF);
3786 j++;
3787 }
3788
3789 if (j == decoded_len)
3790 {
3791 // Check for invalid padding bytes (based on the
3792 // "Base64 Malleability in Practice" ACM paper).
3793 if ((data[input_len - 2] == '=' && ((sextet_b & 0xF) != 0))
3794 || ((data[input_len - 1] == '=') && ((sextet_c & 0x3) != 0)))
3795 {
3796 semsg(_(e_invalid_argument_str), data);
3797 ga_clear(&blob->bv_ga);
3798 return;
3799 }
3800 }
3801 }
3802}
3803
3804/*
3805 * "base64_decode(string)" function
3806 */
3807 static void
3808f_base64_decode(typval_T *argvars, typval_T *rettv)
3809{
3810 if (check_for_string_arg(argvars, 0) == FAIL)
3811 return;
3812
3813 if (rettv_blob_alloc(rettv) == FAIL)
3814 return;
3815
3816 char_u *str = tv_get_string_chk(&argvars[0]);
3817 if (str != NULL)
3818 base64_decode(str, rettv->vval.v_blob);
3819}
3820
3821/*
3822 * "base64_encode(blob)" function
3823 */
3824 static void
3825f_base64_encode(typval_T *argvars, typval_T *rettv)
3826{
3827 if (check_for_blob_arg(argvars, 0) == FAIL)
3828 return;
3829
3830 rettv->v_type = VAR_STRING;
3831 rettv->vval.v_string = NULL;
3832
3833 blob_T *blob = argvars->vval.v_blob;
3834 if (blob != NULL)
3835 rettv->vval.v_string = base64_encode(blob);
3836}
3837
Bram Moolenaar59716a22017-03-01 20:32:44 +01003838/*
Bram Moolenaar6b7b7192019-01-11 13:42:41 +01003839 * Get the buffer from "arg" and give an error and return NULL if it is not
3840 * valid.
3841 */
Bram Moolenaara3347722019-05-11 21:14:24 +02003842 buf_T *
Bram Moolenaar6b7b7192019-01-11 13:42:41 +01003843get_buf_arg(typval_T *arg)
3844{
3845 buf_T *buf;
3846
3847 ++emsg_off;
3848 buf = tv_get_buf(arg, FALSE);
3849 --emsg_off;
3850 if (buf == NULL)
Bram Moolenaard82a47d2022-01-05 20:24:39 +00003851 semsg(_(e_invalid_buffer_name_str), tv_get_string(arg));
Bram Moolenaar6b7b7192019-01-11 13:42:41 +01003852 return buf;
3853}
3854
3855/*
Christ van Willegence0ef912024-06-20 23:41:59 +02003856 * "bindtextdomain(package, path)" function
3857 */
3858 static void
Christ van Willegen8252ef12024-07-11 21:36:21 +02003859f_bindtextdomain(typval_T *argvars, typval_T *rettv)
Christ van Willegence0ef912024-06-20 23:41:59 +02003860{
Christ van Willegen8252ef12024-07-11 21:36:21 +02003861 rettv->v_type = VAR_BOOL;
3862 rettv->vval.v_number = VVAL_TRUE;
3863
Christ van Willegence0ef912024-06-20 23:41:59 +02003864 if (check_for_nonempty_string_arg(argvars, 0) == FAIL
3865 || check_for_nonempty_string_arg(argvars, 1) == FAIL)
3866 return;
3867
3868 if (strcmp((const char *)argvars[0].vval.v_string, VIMPACKAGE) == 0)
3869 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[0]));
3870 else
Christ van Willegen8252ef12024-07-11 21:36:21 +02003871 {
3872 if (bindtextdomain((const char *)argvars[0].vval.v_string, (const char *)argvars[1].vval.v_string) == NULL)
3873 {
3874 do_outofmem_msg((long)0);
3875 rettv->vval.v_number = VVAL_FALSE;
3876 }
3877 }
Christ van Willegence0ef912024-06-20 23:41:59 +02003878
3879 return;
3880}
3881
3882/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003883 * "byte2line(byte)" function
3884 */
3885 static void
3886f_byte2line(typval_T *argvars UNUSED, typval_T *rettv)
3887{
3888#ifndef FEAT_BYTEOFF
3889 rettv->vval.v_number = -1;
3890#else
3891 long boff = 0;
3892
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003893 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
3894 return;
3895
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01003896 boff = tv_get_number(&argvars[0]) - 1; // boff gets -1 on type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003897 if (boff < 0)
3898 rettv->vval.v_number = -1;
3899 else
3900 rettv->vval.v_number = ml_find_line_or_offset(curbuf,
3901 (linenr_T)0, &boff);
3902#endif
3903}
3904
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003905/*
3906 * "call(func, arglist [, dict])" function
3907 */
3908 static void
3909f_call(typval_T *argvars, typval_T *rettv)
3910{
3911 char_u *func;
3912 partial_T *partial = NULL;
3913 dict_T *selfdict = NULL;
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003914 char_u *tofree = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003915
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02003916 if (in_vim9script()
Bram Moolenaar223d0a62021-12-25 19:29:21 +00003917 && (check_for_string_or_func_arg(argvars, 0) == FAIL
3918 || check_for_list_arg(argvars, 1) == FAIL
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02003919 || check_for_opt_dict_arg(argvars, 2) == FAIL))
3920 return;
3921
Bram Moolenaard83392a2022-09-01 12:22:46 +01003922 if (check_for_list_arg(argvars, 1) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003923 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003924 if (argvars[1].vval.v_list == NULL)
3925 return;
3926
3927 if (argvars[0].v_type == VAR_FUNC)
3928 func = argvars[0].vval.v_string;
3929 else if (argvars[0].v_type == VAR_PARTIAL)
3930 {
3931 partial = argvars[0].vval.v_partial;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02003932 func = partial_name(partial);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003933 }
3934 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003935 func = tv_get_string(&argvars[0]);
Dominique Pellefe8ebdb2021-05-13 14:55:55 +02003936 if (func == NULL || *func == NUL)
3937 return; // type error, empty name or null function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003938
Yegappan Lakshmanan9904cbc2025-01-15 18:25:19 +01003939 if (argvars[0].v_type == VAR_STRING)
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003940 {
Yegappan Lakshmanan9904cbc2025-01-15 18:25:19 +01003941 char_u *p = func;
3942 tofree = trans_function_name(&p, NULL, FALSE, TFN_INT|TFN_QUIET);
3943 if (tofree == NULL)
3944 {
3945 emsg_funcname(e_unknown_function_str, func);
3946 return;
3947 }
3948 func = tofree;
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003949 }
3950
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003951 if (argvars[2].v_type != VAR_UNKNOWN)
3952 {
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +01003953 if (check_for_dict_arg(argvars, 2) == FAIL)
Yegappan Lakshmanan6289f912025-01-14 17:13:36 +01003954 goto done;
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +01003955
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003956 selfdict = argvars[2].vval.v_dict;
3957 }
3958
3959 (void)func_call(func, &argvars[1], partial, selfdict, rettv);
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003960
Yegappan Lakshmanan6289f912025-01-14 17:13:36 +01003961done:
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003962 vim_free(tofree);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003963}
3964
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003965/*
3966 * "changenr()" function
3967 */
3968 static void
3969f_changenr(typval_T *argvars UNUSED, typval_T *rettv)
3970{
3971 rettv->vval.v_number = curbuf->b_u_seq_cur;
3972}
3973
3974/*
3975 * "char2nr(string)" function
3976 */
3977 static void
3978f_char2nr(typval_T *argvars, typval_T *rettv)
3979{
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02003980 if (in_vim9script()
3981 && (check_for_string_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02003982 || check_for_opt_bool_arg(argvars, 1) == FAIL))
Bram Moolenaarc5809432021-03-27 21:23:30 +01003983 return;
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02003984
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003985 if (has_mbyte)
3986 {
3987 int utf8 = 0;
3988
3989 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaar24f77502020-09-04 19:50:57 +02003990 utf8 = (int)tv_get_bool_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003991
3992 if (utf8)
Bram Moolenaarbdace832019-03-02 10:13:42 +01003993 rettv->vval.v_number = utf_ptr2char(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003994 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003995 rettv->vval.v_number = (*mb_ptr2char)(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003996 }
3997 else
Bram Moolenaar13505972019-01-24 15:04:48 +01003998 rettv->vval.v_number = tv_get_string(&argvars[0])[0];
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003999}
4000
Bram Moolenaar17793ef2020-12-28 12:56:58 +01004001/*
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004002 * Get the current cursor column and store it in 'rettv'. If 'charcol' is TRUE,
4003 * returns the character index of the column. Otherwise, returns the byte index
4004 * of the column.
4005 */
4006 static void
4007get_col(typval_T *argvars, typval_T *rettv, int charcol)
4008{
4009 colnr_T col = 0;
4010 pos_T *fp;
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00004011 switchwin_T switchwin;
4012 int winchanged = FALSE;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004013
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00004014 if (check_for_string_or_list_arg(argvars, 0) == FAIL
4015 || check_for_opt_number_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004016 return;
4017
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00004018 if (argvars[1].v_type != VAR_UNKNOWN)
4019 {
4020 tabpage_T *tp;
4021 win_T *wp;
4022
4023 // use the window specified in the second argument
4024 wp = win_id2wp_tp((int)tv_get_number(&argvars[1]), &tp);
4025 if (wp == NULL || tp == NULL)
4026 return;
4027
4028 if (switch_win_noblock(&switchwin, wp, tp, TRUE) != OK)
4029 return;
4030
4031 check_cursor();
4032 winchanged = TRUE;
4033 }
4034
4035 int fnum = curbuf->b_fnum;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004036 fp = var2fpos(&argvars[0], FALSE, &fnum, charcol);
4037 if (fp != NULL && fnum == curbuf->b_fnum)
4038 {
4039 if (fp->col == MAXCOL)
4040 {
4041 // '> can be MAXCOL, get the length of the line then
4042 if (fp->lnum <= curbuf->b_ml.ml_line_count)
John Marriottbfcc8952024-03-11 22:04:45 +01004043 col = ml_get_len(fp->lnum) + 1;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004044 else
4045 col = MAXCOL;
4046 }
4047 else
4048 {
4049 col = fp->col + 1;
4050 // col(".") when the cursor is on the NUL at the end of the line
4051 // because of "coladd" can be seen as an extra column.
4052 if (virtual_active() && fp == &curwin->w_cursor)
4053 {
4054 char_u *p = ml_get_cursor();
4055
4056 if (curwin->w_cursor.coladd >= (colnr_T)chartabsize(p,
4057 curwin->w_virtcol - curwin->w_cursor.coladd))
4058 {
4059 int l;
4060
4061 if (*p != NUL && p[(l = (*mb_ptr2len)(p))] == NUL)
4062 col += l;
4063 }
4064 }
4065 }
4066 }
4067 rettv->vval.v_number = col;
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00004068
4069 if (winchanged)
4070 restore_win_noblock(&switchwin, TRUE);
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004071}
4072
4073/*
4074 * "charcol()" function
4075 */
4076 static void
4077f_charcol(typval_T *argvars, typval_T *rettv)
4078{
4079 get_col(argvars, rettv, TRUE);
4080}
4081
Bram Moolenaar29b7d7a2019-07-22 23:03:57 +02004082 win_T *
Bram Moolenaaraff74912019-03-30 18:11:49 +01004083get_optional_window(typval_T *argvars, int idx)
4084{
4085 win_T *win = curwin;
4086
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00004087 if (argvars[idx].v_type == VAR_UNKNOWN)
4088 return curwin;
4089
4090 win = find_win_by_nr_or_id(&argvars[idx]);
4091 if (win == NULL)
Bram Moolenaaraff74912019-03-30 18:11:49 +01004092 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00004093 emsg(_(e_invalid_window_number));
4094 return NULL;
Bram Moolenaaraff74912019-03-30 18:11:49 +01004095 }
4096 return win;
4097}
4098
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004099/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004100 * "col(string)" function
4101 */
4102 static void
4103f_col(typval_T *argvars, typval_T *rettv)
4104{
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004105 get_col(argvars, rettv, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004106}
4107
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004108/*
4109 * "confirm(message, buttons[, default [, type]])" function
4110 */
4111 static void
4112f_confirm(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
4113{
4114#if defined(FEAT_GUI_DIALOG) || defined(FEAT_CON_DIALOG)
4115 char_u *message;
4116 char_u *buttons = NULL;
4117 char_u buf[NUMBUFLEN];
4118 char_u buf2[NUMBUFLEN];
4119 int def = 1;
4120 int type = VIM_GENERIC;
4121 char_u *typestr;
4122 int error = FALSE;
4123
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02004124 if (in_vim9script()
4125 && (check_for_string_arg(argvars, 0) == FAIL
4126 || (check_for_opt_string_arg(argvars, 1) == FAIL
4127 || (argvars[1].v_type != VAR_UNKNOWN
4128 && (check_for_opt_number_arg(argvars, 2) == FAIL
4129 || (argvars[2].v_type != VAR_UNKNOWN
4130 && check_for_opt_string_arg(argvars, 3) == FAIL))))))
Bram Moolenaarc5809432021-03-27 21:23:30 +01004131 return;
4132
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004133 message = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004134 if (message == NULL)
4135 error = TRUE;
4136 if (argvars[1].v_type != VAR_UNKNOWN)
4137 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004138 buttons = tv_get_string_buf_chk(&argvars[1], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004139 if (buttons == NULL)
4140 error = TRUE;
4141 if (argvars[2].v_type != VAR_UNKNOWN)
4142 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004143 def = (int)tv_get_number_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004144 if (argvars[3].v_type != VAR_UNKNOWN)
4145 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004146 typestr = tv_get_string_buf_chk(&argvars[3], buf2);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004147 if (typestr == NULL)
4148 error = TRUE;
4149 else
4150 {
4151 switch (TOUPPER_ASC(*typestr))
4152 {
4153 case 'E': type = VIM_ERROR; break;
4154 case 'Q': type = VIM_QUESTION; break;
4155 case 'I': type = VIM_INFO; break;
4156 case 'W': type = VIM_WARNING; break;
4157 case 'G': type = VIM_GENERIC; break;
4158 }
4159 }
4160 }
4161 }
4162 }
4163
4164 if (buttons == NULL || *buttons == NUL)
4165 buttons = (char_u *)_("&Ok");
4166
4167 if (!error)
4168 rettv->vval.v_number = do_dialog(type, NULL, message, buttons,
4169 def, NULL, FALSE);
4170#endif
4171}
4172
4173/*
4174 * "copy()" function
4175 */
4176 static void
4177f_copy(typval_T *argvars, typval_T *rettv)
4178{
Bram Moolenaar381692b2022-02-02 20:01:27 +00004179 item_copy(&argvars[0], rettv, FALSE, TRUE, 0);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004180}
4181
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004182/*
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004183 * Set the cursor position.
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01004184 * If "charcol" is TRUE, then use the column number as a character offset.
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004185 * Otherwise use the column number as a byte offset.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004186 */
4187 static void
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004188set_cursorpos(typval_T *argvars, typval_T *rettv, int charcol)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004189{
Bram Moolenaar79f23442022-10-10 12:42:57 +01004190 long lnum, col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004191 long coladd = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004192 int set_curswant = TRUE;
4193
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004194 if (in_vim9script()
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004195 && (check_for_string_or_number_or_list_arg(argvars, 0) == FAIL
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02004196 || check_for_opt_number_arg(argvars, 1) == FAIL
4197 || (argvars[1].v_type != VAR_UNKNOWN
4198 && check_for_opt_number_arg(argvars, 2) == FAIL)))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004199 return;
4200
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004201 rettv->vval.v_number = -1;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004202 if (argvars[0].v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004203 {
4204 pos_T pos;
4205 colnr_T curswant = -1;
4206
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004207 if (list2fpos(argvars, &pos, NULL, &curswant, charcol) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004208 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00004209 emsg(_(e_invalid_argument));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004210 return;
4211 }
Bram Moolenaar79f23442022-10-10 12:42:57 +01004212 lnum = pos.lnum;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004213 col = pos.col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004214 coladd = pos.coladd;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004215 if (curswant >= 0)
4216 {
4217 curwin->w_curswant = curswant - 1;
4218 set_curswant = FALSE;
4219 }
4220 }
Bram Moolenaar79f23442022-10-10 12:42:57 +01004221 else if ((argvars[0].v_type == VAR_NUMBER
4222 || argvars[0].v_type == VAR_STRING)
4223 && (argvars[1].v_type == VAR_NUMBER
4224 || argvars[1].v_type == VAR_STRING))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004225 {
Bram Moolenaar79f23442022-10-10 12:42:57 +01004226 lnum = tv_get_lnum(argvars);
4227 if (lnum < 0)
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00004228 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[0]));
Bram Moolenaar79f23442022-10-10 12:42:57 +01004229 else if (lnum == 0)
4230 lnum = curwin->w_cursor.lnum;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004231 col = (long)tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004232 if (charcol)
Bram Moolenaar79f23442022-10-10 12:42:57 +01004233 col = buf_charidx_to_byteidx(curbuf, lnum, col) + 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004234 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004235 coladd = (long)tv_get_number_chk(&argvars[2], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004236 }
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004237 else
4238 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00004239 emsg(_(e_invalid_argument));
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004240 return;
4241 }
Bram Moolenaar79f23442022-10-10 12:42:57 +01004242 if (lnum < 0 || col < 0 || coladd < 0)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004243 return; // type error; errmsg already given
Bram Moolenaar79f23442022-10-10 12:42:57 +01004244 if (lnum > 0)
4245 curwin->w_cursor.lnum = lnum;
zeertzjq2ffdae72024-05-02 13:06:24 +02004246 if (col != MAXCOL && --col < 0)
4247 col = 0;
4248 curwin->w_cursor.col = col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004249 curwin->w_cursor.coladd = coladd;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004250
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004251 // Make sure the cursor is in a valid position.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004252 check_cursor();
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004253 // Correct cursor for multi-byte character.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004254 if (has_mbyte)
4255 mb_adjust_cursor();
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004256
4257 curwin->w_set_curswant = set_curswant;
4258 rettv->vval.v_number = 0;
4259}
4260
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004261/*
4262 * "cursor(lnum, col)" function, or
4263 * "cursor(list)"
4264 *
4265 * Moves the cursor to the specified line and column.
4266 * Returns 0 when the position could be set, -1 otherwise.
4267 */
4268 static void
4269f_cursor(typval_T *argvars, typval_T *rettv)
4270{
4271 set_cursorpos(argvars, rettv, FALSE);
4272}
4273
Bram Moolenaar4f974752019-02-17 17:44:42 +01004274#ifdef MSWIN
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004275/*
4276 * "debugbreak()" function
4277 */
4278 static void
4279f_debugbreak(typval_T *argvars, typval_T *rettv)
4280{
4281 int pid;
4282
4283 rettv->vval.v_number = FAIL;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004284 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
4285 return;
4286
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004287 pid = (int)tv_get_number(&argvars[0]);
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004288 if (pid == 0)
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004289 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00004290 emsg(_(e_invalid_argument));
4291 return;
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004292 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00004293
4294 HANDLE hProcess = OpenProcess(PROCESS_ALL_ACCESS, 0, pid);
4295 if (hProcess == NULL)
4296 return;
4297
4298 DebugBreakProcess(hProcess);
4299 CloseHandle(hProcess);
4300 rettv->vval.v_number = OK;
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004301}
4302#endif
4303
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004304/*
4305 * "deepcopy()" function
4306 */
4307 static void
4308f_deepcopy(typval_T *argvars, typval_T *rettv)
4309{
Bram Moolenaar239f8d92021-01-17 13:21:20 +01004310 varnumber_T noref = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004311
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +01004312 if (check_for_opt_bool_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004313 return;
4314
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004315 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaar239f8d92021-01-17 13:21:20 +01004316 noref = tv_get_bool_chk(&argvars[1], NULL);
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +01004317
4318 item_copy(&argvars[0], rettv, TRUE, TRUE, noref == 0 ? get_copyID() : 0);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004319}
4320
4321/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004322 * "did_filetype()" function
4323 */
4324 static void
4325f_did_filetype(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
4326{
zeertzjq5bf6c212024-03-31 18:41:27 +02004327 rettv->vval.v_number = curbuf->b_did_filetype;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004328}
4329
4330/*
Bram Moolenaar4132eb52020-02-14 16:53:00 +01004331 * "echoraw({expr})" function
4332 */
4333 static void
4334f_echoraw(typval_T *argvars, typval_T *rettv UNUSED)
4335{
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02004336 char_u *str;
Bram Moolenaar4132eb52020-02-14 16:53:00 +01004337
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02004338 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
4339 return;
4340
4341 str = tv_get_string_chk(&argvars[0]);
Bram Moolenaar4132eb52020-02-14 16:53:00 +01004342 if (str != NULL && *str != NUL)
4343 {
4344 out_str(str);
4345 out_flush();
4346 }
4347}
4348
4349/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004350 * "empty({expr})" function
4351 */
4352 static void
4353f_empty(typval_T *argvars, typval_T *rettv)
4354{
4355 int n = FALSE;
4356
4357 switch (argvars[0].v_type)
4358 {
4359 case VAR_STRING:
4360 case VAR_FUNC:
4361 n = argvars[0].vval.v_string == NULL
4362 || *argvars[0].vval.v_string == NUL;
4363 break;
4364 case VAR_PARTIAL:
Yegappan Lakshmananda9d3452024-05-02 13:02:36 +02004365 n = argvars[0].vval.v_partial == NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004366 break;
4367 case VAR_NUMBER:
4368 n = argvars[0].vval.v_number == 0;
4369 break;
4370 case VAR_FLOAT:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004371 n = argvars[0].vval.v_float == 0.0;
4372 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004373 case VAR_LIST:
4374 n = argvars[0].vval.v_list == NULL
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004375 || argvars[0].vval.v_list->lv_len == 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004376 break;
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01004377 case VAR_TUPLE:
4378 n = tuple_len(argvars[0].vval.v_tuple) == 0;
4379 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004380 case VAR_DICT:
4381 n = argvars[0].vval.v_dict == NULL
4382 || argvars[0].vval.v_dict->dv_hashtab.ht_used == 0;
4383 break;
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01004384 case VAR_BOOL:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004385 case VAR_SPECIAL:
4386 n = argvars[0].vval.v_number != VVAL_TRUE;
4387 break;
Bram Moolenaar00b28d62022-12-08 15:32:33 +00004388 case VAR_CLASS:
4389 n = argvars[0].vval.v_class != NULL;
4390 break;
4391 case VAR_OBJECT:
Yegappan Lakshmanand3eae7b2024-03-03 16:26:58 +01004392 n = object_empty(argvars[0].vval.v_object);
Bram Moolenaar00b28d62022-12-08 15:32:33 +00004393 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004394
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01004395 case VAR_BLOB:
4396 n = argvars[0].vval.v_blob == NULL
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01004397 || argvars[0].vval.v_blob->bv_ga.ga_len == 0;
4398 break;
4399
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004400 case VAR_JOB:
4401#ifdef FEAT_JOB_CHANNEL
4402 n = argvars[0].vval.v_job == NULL
4403 || argvars[0].vval.v_job->jv_status != JOB_STARTED;
4404 break;
4405#endif
4406 case VAR_CHANNEL:
4407#ifdef FEAT_JOB_CHANNEL
4408 n = argvars[0].vval.v_channel == NULL
4409 || !channel_is_open(argvars[0].vval.v_channel);
4410 break;
4411#endif
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +02004412 case VAR_TYPEALIAS:
4413 n = argvars[0].vval.v_typealias == NULL
4414 || argvars[0].vval.v_typealias->ta_name == NULL
4415 || *argvars[0].vval.v_typealias->ta_name == NUL;
4416 break;
4417
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004418 case VAR_UNKNOWN:
Bram Moolenaar4c683752020-04-05 21:38:23 +02004419 case VAR_ANY:
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004420 case VAR_VOID:
Bram Moolenaarf18332f2021-05-07 17:55:55 +02004421 case VAR_INSTR:
Bram Moolenaardd589232020-02-29 17:38:12 +01004422 internal_error_no_abort("f_empty(UNKNOWN)");
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004423 n = TRUE;
4424 break;
4425 }
4426
4427 rettv->vval.v_number = n;
4428}
4429
4430/*
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004431 * "environ()" function
4432 */
4433 static void
4434f_environ(typval_T *argvars UNUSED, typval_T *rettv)
4435{
4436#if !defined(AMIGA)
4437 int i = 0;
4438 char_u *entry, *value;
Bram Moolenaar68aaff42022-04-17 10:57:44 +01004439# if defined (MSWIN)
4440# if !defined(_UCRT)
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004441 extern wchar_t **_wenviron;
Bram Moolenaar68aaff42022-04-17 10:57:44 +01004442# endif
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004443# else
4444 extern char **environ;
4445# endif
4446
Bram Moolenaar93a10962022-06-16 11:42:09 +01004447 if (rettv_dict_alloc(rettv) == FAIL)
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004448 return;
4449
4450# ifdef MSWIN
4451 if (*_wenviron == NULL)
4452 return;
4453# else
4454 if (*environ == NULL)
4455 return;
4456# endif
4457
4458 for (i = 0; ; ++i)
4459 {
4460# ifdef MSWIN
4461 short_u *p;
4462
4463 if ((p = (short_u *)_wenviron[i]) == NULL)
4464 return;
4465 entry = utf16_to_enc(p, NULL);
4466# else
4467 if ((entry = (char_u *)environ[i]) == NULL)
4468 return;
4469 entry = vim_strsave(entry);
4470# endif
4471 if (entry == NULL) // out of memory
4472 return;
4473 if ((value = vim_strchr(entry, '=')) == NULL)
4474 {
4475 vim_free(entry);
4476 continue;
4477 }
4478 *value++ = NUL;
4479 dict_add_string(rettv->vval.v_dict, (char *)entry, value);
4480 vim_free(entry);
4481 }
4482#endif
4483}
4484
4485/*
Bram Moolenaar80adaa82023-07-07 18:57:40 +01004486 * "err_teapot()" function
4487 */
4488 static void
4489f_err_teapot(typval_T *argvars, typval_T *rettv UNUSED)
4490{
4491 if (argvars[0].v_type != VAR_UNKNOWN)
4492 {
4493 if (argvars[0].v_type == VAR_STRING)
4494 {
4495 char_u *s = tv_get_string_strict(&argvars[0]);
Sean Dewarb0efa492023-07-08 10:35:19 +01004496 if (*skipwhite(s) == NUL)
Bram Moolenaar80adaa82023-07-07 18:57:40 +01004497 return;
4498 }
4499
4500 int err = FALSE;
4501 int do_503 = eval_expr_to_bool(&argvars[0], &err);
4502 if (!err && do_503)
4503 {
4504 emsg(_(e_coffee_currently_not_available));
4505 return;
4506 }
4507 }
4508
4509 emsg(_(e_im_a_teapot));
4510}
4511
4512/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004513 * "escape({string}, {chars})" function
4514 */
4515 static void
4516f_escape(typval_T *argvars, typval_T *rettv)
4517{
4518 char_u buf[NUMBUFLEN];
4519
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004520 if (in_vim9script()
4521 && (check_for_string_arg(argvars, 0) == FAIL
4522 || check_for_string_arg(argvars, 1) == FAIL))
4523 return;
4524
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004525 rettv->vval.v_string = vim_strsave_escaped(tv_get_string(&argvars[0]),
4526 tv_get_string_buf(&argvars[1], buf));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004527 rettv->v_type = VAR_STRING;
4528}
4529
4530/*
4531 * "eval()" function
4532 */
4533 static void
4534f_eval(typval_T *argvars, typval_T *rettv)
4535{
4536 char_u *s, *p;
4537
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004538 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
4539 return;
4540
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004541 s = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004542 if (s != NULL)
4543 s = skipwhite(s);
4544
4545 p = s;
Bram Moolenaar5409f5d2020-06-24 18:37:35 +02004546 if (s == NULL || eval1(&s, rettv, &EVALARG_EVALUATE) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004547 {
4548 if (p != NULL && !aborting())
Bram Moolenaar108010a2021-06-27 22:03:33 +02004549 semsg(_(e_invalid_expression_str), p);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004550 need_clr_eos = FALSE;
4551 rettv->v_type = VAR_NUMBER;
4552 rettv->vval.v_number = 0;
4553 }
4554 else if (*s != NUL)
Bram Moolenaar74409f62022-01-01 15:58:22 +00004555 semsg(_(e_trailing_characters_str), s);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004556}
4557
4558/*
4559 * "eventhandler()" function
4560 */
4561 static void
4562f_eventhandler(typval_T *argvars UNUSED, typval_T *rettv)
4563{
Bram Moolenaardfc33a62020-04-29 22:30:13 +02004564 rettv->vval.v_number = vgetc_busy || input_busy;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004565}
4566
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004567static garray_T redir_execute_ga;
4568
4569/*
4570 * Append "value[value_len]" to the execute() output.
4571 */
4572 void
4573execute_redir_str(char_u *value, int value_len)
4574{
4575 int len;
4576
4577 if (value_len == -1)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004578 len = (int)STRLEN(value); // Append the entire string
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004579 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004580 len = value_len; // Append only "value_len" characters
Yegappan Lakshmananfadc02a2023-01-27 21:03:12 +00004581 if (ga_grow(&redir_execute_ga, len) == FAIL)
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00004582 return;
4583
4584 mch_memmove((char *)redir_execute_ga.ga_data
4585 + redir_execute_ga.ga_len, value, len);
4586 redir_execute_ga.ga_len += len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004587}
4588
Dominique Pelle748b3082022-01-08 12:41:16 +00004589#if defined(FEAT_LUA) || defined(PROTO)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004590/*
Yegappan Lakshmanan11328bc2021-08-06 21:34:38 +02004591 * Get next line from a string containing NL separated lines.
4592 * Called by do_cmdline() to get the next line.
4593 * Returns an allocated string, or NULL when at the end of the string.
4594 */
4595 static char_u *
4596get_str_line(
4597 int c UNUSED,
4598 void *cookie,
4599 int indent UNUSED,
4600 getline_opt_T options UNUSED)
4601{
4602 char_u *start = *(char_u **)cookie;
4603 char_u *line;
4604 char_u *p;
4605
4606 p = start;
4607 if (p == NULL || *p == NUL)
4608 return NULL;
4609 p = vim_strchr(p, '\n');
4610 if (p == NULL)
4611 line = vim_strsave(start);
4612 else
4613 {
4614 line = vim_strnsave(start, p - start);
4615 p++;
4616 }
4617
4618 *(char_u **)cookie = p;
4619 return line;
4620}
4621
4622/*
4623 * Execute a series of Ex commands in 'str'
4624 */
4625 void
4626execute_cmds_from_string(char_u *str)
4627{
4628 do_cmdline(NULL, get_str_line, (void *)&str,
4629 DOCMD_NOWAIT|DOCMD_VERBOSE|DOCMD_REPEAT|DOCMD_KEYTYPED);
4630}
Dominique Pelle748b3082022-01-08 12:41:16 +00004631#endif
Yegappan Lakshmanan11328bc2021-08-06 21:34:38 +02004632
4633/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004634 * Get next line from a list.
4635 * Called by do_cmdline() to get the next line.
4636 * Returns allocated string, or NULL for end of function.
4637 */
Bram Moolenaara7583c42022-05-07 21:14:05 +01004638 char_u *
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004639get_list_line(
4640 int c UNUSED,
4641 void *cookie,
Bram Moolenaare96a2492019-06-25 04:12:16 +02004642 int indent UNUSED,
Bram Moolenaar66250c92020-08-20 15:02:42 +02004643 getline_opt_T options UNUSED)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004644{
4645 listitem_T **p = (listitem_T **)cookie;
4646 listitem_T *item = *p;
4647 char_u buf[NUMBUFLEN];
4648 char_u *s;
4649
4650 if (item == NULL)
4651 return NULL;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004652 s = tv_get_string_buf_chk(&item->li_tv, buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004653 *p = item->li_next;
4654 return s == NULL ? NULL : vim_strsave(s);
4655}
4656
4657/*
4658 * "execute()" function
4659 */
Bram Moolenaar261f3462019-09-07 15:45:32 +02004660 void
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004661execute_common(typval_T *argvars, typval_T *rettv, int arg_off)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004662{
4663 char_u *cmd = NULL;
4664 list_T *list = NULL;
4665 int save_msg_silent = msg_silent;
4666 int save_emsg_silent = emsg_silent;
4667 int save_emsg_noredir = emsg_noredir;
4668 int save_redir_execute = redir_execute;
Bram Moolenaar20951482017-12-25 13:44:43 +01004669 int save_redir_off = redir_off;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004670 garray_T save_ga;
Bram Moolenaar10ccaa12018-12-07 16:38:23 +01004671 int save_msg_col = msg_col;
Kota Kato3d3f6ac2022-08-04 18:50:14 +01004672 int save_sticky_cmdmod_flags = sticky_cmdmod_flags;
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004673 int echo_output = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004674
4675 rettv->vval.v_string = NULL;
4676 rettv->v_type = VAR_STRING;
4677
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004678 if (argvars[arg_off].v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004679 {
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004680 list = argvars[arg_off].vval.v_list;
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004681 if (list == NULL || list->lv_len == 0)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004682 // empty list, no commands, empty output
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004683 return;
4684 ++list->lv_refcount;
4685 }
Bram Moolenaare2a8f072020-01-08 19:32:18 +01004686 else if (argvars[arg_off].v_type == VAR_JOB
4687 || argvars[arg_off].v_type == VAR_CHANNEL)
4688 {
Bram Moolenaar68db9962021-05-09 23:19:22 +02004689 semsg(_(e_using_invalid_value_as_string_str),
4690 vartype_name(argvars[arg_off].v_type));
Bram Moolenaare2a8f072020-01-08 19:32:18 +01004691 return;
4692 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004693 else
4694 {
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004695 cmd = tv_get_string_chk(&argvars[arg_off]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004696 if (cmd == NULL)
4697 return;
4698 }
4699
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004700 if (argvars[arg_off + 1].v_type != VAR_UNKNOWN)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004701 {
4702 char_u buf[NUMBUFLEN];
Bram Moolenaar3cfa5b12021-06-06 14:14:39 +02004703 char_u *s = tv_get_string_buf_chk_strict(&argvars[arg_off + 1], buf,
4704 in_vim9script());
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004705
4706 if (s == NULL)
4707 return;
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004708 if (*s == NUL)
4709 echo_output = TRUE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004710 if (STRNCMP(s, "silent", 6) == 0)
4711 ++msg_silent;
4712 if (STRCMP(s, "silent!") == 0)
4713 {
4714 emsg_silent = TRUE;
4715 emsg_noredir = TRUE;
4716 }
4717 }
4718 else
4719 ++msg_silent;
4720
4721 if (redir_execute)
4722 save_ga = redir_execute_ga;
Bram Moolenaar04935fb2022-01-08 16:19:22 +00004723 ga_init2(&redir_execute_ga, sizeof(char), 500);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004724 redir_execute = TRUE;
Bram Moolenaar20951482017-12-25 13:44:43 +01004725 redir_off = FALSE;
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004726 if (!echo_output)
4727 msg_col = 0; // prevent leading spaces
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004728
Kota Kato3d3f6ac2022-08-04 18:50:14 +01004729 // For "legacy call execute('cmd')" and "vim9cmd execute('cmd')" apply the
4730 // command modifiers to "cmd".
4731 sticky_cmdmod_flags = cmdmod.cmod_flags & (CMOD_LEGACY | CMOD_VIM9CMD);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004732 if (cmd != NULL)
4733 do_cmdline_cmd(cmd);
4734 else
4735 {
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004736 listitem_T *item;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004737
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02004738 CHECK_LIST_MATERIALIZE(list);
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004739 item = list->lv_first;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004740 do_cmdline(NULL, get_list_line, (void *)&item,
4741 DOCMD_NOWAIT|DOCMD_VERBOSE|DOCMD_REPEAT|DOCMD_KEYTYPED);
4742 --list->lv_refcount;
4743 }
Kota Kato3d3f6ac2022-08-04 18:50:14 +01004744 sticky_cmdmod_flags = save_sticky_cmdmod_flags;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004745
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004746 // Need to append a NUL to the result.
Bram Moolenaard297f352017-01-29 20:31:21 +01004747 if (ga_grow(&redir_execute_ga, 1) == OK)
4748 {
4749 ((char *)redir_execute_ga.ga_data)[redir_execute_ga.ga_len] = NUL;
4750 rettv->vval.v_string = redir_execute_ga.ga_data;
4751 }
4752 else
4753 {
4754 ga_clear(&redir_execute_ga);
4755 rettv->vval.v_string = NULL;
4756 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004757 msg_silent = save_msg_silent;
4758 emsg_silent = save_emsg_silent;
4759 emsg_noredir = save_emsg_noredir;
4760
4761 redir_execute = save_redir_execute;
4762 if (redir_execute)
4763 redir_execute_ga = save_ga;
Bram Moolenaar20951482017-12-25 13:44:43 +01004764 redir_off = save_redir_off;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004765
Bram Moolenaar10ccaa12018-12-07 16:38:23 +01004766 // "silent reg" or "silent echo x" leaves msg_col somewhere in the line.
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004767 if (echo_output)
4768 // When not working silently: put it in column zero. A following
4769 // "echon" will overwrite the message, unavoidably.
4770 msg_col = 0;
4771 else
4772 // When working silently: Put it back where it was, since nothing
4773 // should have been written.
4774 msg_col = save_msg_col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004775}
4776
4777/*
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004778 * "execute()" function
4779 */
4780 static void
4781f_execute(typval_T *argvars, typval_T *rettv)
4782{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004783 if (in_vim9script()
4784 && (check_for_string_or_list_arg(argvars, 0) == FAIL
4785 || check_for_opt_string_arg(argvars, 1) == FAIL))
4786 return;
4787
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004788 execute_common(argvars, rettv, 0);
4789}
4790
4791/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004792 * "exists()" function
4793 */
Bram Moolenaarbb7ee7a2021-08-02 20:06:50 +02004794 void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004795f_exists(typval_T *argvars, typval_T *rettv)
4796{
4797 char_u *p;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004798 int n = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004799
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004800 if (in_vim9script() && check_for_nonempty_string_arg(argvars, 0) == FAIL)
4801 return;
4802
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004803 p = tv_get_string(&argvars[0]);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004804 if (*p == '$') // environment variable
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004805 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004806 // first try "normal" environment variables (fast)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004807 if (mch_getenv(p + 1) != NULL)
4808 n = TRUE;
4809 else
4810 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004811 // try expanding things like $VIM and ${HOME}
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004812 p = expand_env_save(p);
4813 if (p != NULL && *p != '$')
4814 n = TRUE;
4815 vim_free(p);
4816 }
4817 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004818 else if (*p == '&' || *p == '+') // option
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004819 {
Bram Moolenaar9a78e6d2020-07-01 18:29:55 +02004820 n = (eval_option(&p, NULL, TRUE) == OK);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004821 if (*skipwhite(p) != NUL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004822 n = FALSE; // trailing garbage
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004823 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004824 else if (*p == '*') // internal or user defined function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004825 {
Bram Moolenaarb54c3ff2016-07-31 14:11:58 +02004826 n = function_exists(p + 1, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004827 }
Bram Moolenaar15c47602020-03-26 22:16:48 +01004828 else if (*p == '?') // internal function only
4829 {
4830 n = has_internal_func_name(p + 1);
4831 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004832 else if (*p == ':')
4833 {
4834 n = cmd_exists(p + 1);
4835 }
4836 else if (*p == '#')
4837 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004838 if (p[1] == '#')
4839 n = autocmd_supported(p + 2);
4840 else
4841 n = au_exists(p + 1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004842 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004843 else // internal variable
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004844 {
Bram Moolenaarc6f9f732018-02-11 19:06:26 +01004845 n = var_exists(p);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004846 }
4847
4848 rettv->vval.v_number = n;
4849}
4850
Bram Moolenaar26735992021-08-08 14:43:22 +02004851 static void
4852f_exists_compiled(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
4853{
4854 emsg(_(e_exists_compiled_can_only_be_used_in_def_function));
4855}
4856
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004857/*
4858 * "expand()" function
4859 */
4860 static void
4861f_expand(typval_T *argvars, typval_T *rettv)
4862{
4863 char_u *s;
Mike Williams51024bb2024-05-30 07:46:30 +02004864 size_t len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004865 int options = WILD_SILENT|WILD_USE_NL|WILD_LIST_NOTFOUND;
4866 expand_T xpc;
4867 int error = FALSE;
4868 char_u *result;
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004869#ifdef BACKSLASH_IN_FILENAME
4870 char_u *p_csl_save = p_csl;
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004871#endif
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004872
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004873 if (in_vim9script()
4874 && (check_for_string_arg(argvars, 0) == FAIL
4875 || check_for_opt_bool_arg(argvars, 1) == FAIL
4876 || (argvars[1].v_type != VAR_UNKNOWN
4877 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
4878 return;
4879
4880#ifdef BACKSLASH_IN_FILENAME
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004881 // avoid using 'completeslash' here
4882 p_csl = empty_option;
4883#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004884
4885 rettv->v_type = VAR_STRING;
4886 if (argvars[1].v_type != VAR_UNKNOWN
4887 && argvars[2].v_type != VAR_UNKNOWN
Bram Moolenaar551d25e2020-09-02 21:37:56 +02004888 && tv_get_bool_chk(&argvars[2], &error)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004889 && !error)
Bram Moolenaar45cf6e92017-04-30 20:25:19 +02004890 rettv_list_set(rettv, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004891
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004892 s = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004893 if (*s == '%' || *s == '#' || *s == '<')
4894 {
Bram Moolenaar57544522022-04-12 12:54:11 +01004895 char *errormsg = NULL;
4896
4897 if (p_verbose == 0)
4898 ++emsg_off;
Bram Moolenaara96edb72022-04-28 17:52:24 +01004899 result = eval_vars(s, s, &len, NULL, &errormsg, NULL, FALSE);
Bram Moolenaar57544522022-04-12 12:54:11 +01004900 if (p_verbose == 0)
4901 --emsg_off;
4902 else if (errormsg != NULL)
4903 emsg(errormsg);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004904 if (rettv->v_type == VAR_LIST)
4905 {
Bram Moolenaar93a10962022-06-16 11:42:09 +01004906 if (rettv_list_alloc(rettv) == OK && result != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004907 list_append_string(rettv->vval.v_list, result, -1);
Bram Moolenaar86173482019-10-01 17:02:16 +02004908 vim_free(result);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004909 }
4910 else
4911 rettv->vval.v_string = result;
4912 }
4913 else
4914 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004915 // When the optional second argument is non-zero, don't remove matches
4916 // for 'wildignore' and don't put matches for 'suffixes' at the end.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004917 if (argvars[1].v_type != VAR_UNKNOWN
Bram Moolenaar551d25e2020-09-02 21:37:56 +02004918 && tv_get_bool_chk(&argvars[1], &error))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004919 options |= WILD_KEEP_ALL;
4920 if (!error)
4921 {
4922 ExpandInit(&xpc);
4923 xpc.xp_context = EXPAND_FILES;
4924 if (p_wic)
4925 options += WILD_ICASE;
4926 if (rettv->v_type == VAR_STRING)
4927 rettv->vval.v_string = ExpandOne(&xpc, s, NULL,
4928 options, WILD_ALL);
Bram Moolenaar93a10962022-06-16 11:42:09 +01004929 else if (rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004930 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004931 ExpandOne(&xpc, s, NULL, options, WILD_ALL_KEEP);
Bram Moolenaar848db572022-09-20 19:04:32 +01004932 for (int i = 0; i < xpc.xp_numfiles; i++)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004933 list_append_string(rettv->vval.v_list, xpc.xp_files[i], -1);
4934 ExpandCleanup(&xpc);
4935 }
4936 }
4937 else
4938 rettv->vval.v_string = NULL;
4939 }
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004940#ifdef BACKSLASH_IN_FILENAME
4941 p_csl = p_csl_save;
4942#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004943}
4944
4945/*
Bram Moolenaar80dad482019-06-09 17:22:31 +02004946 * "expandcmd()" function
4947 * Expand all the special characters in a command string.
4948 */
4949 static void
4950f_expandcmd(typval_T *argvars, typval_T *rettv)
4951{
4952 exarg_T eap;
4953 char_u *cmdstr;
4954 char *errormsg = NULL;
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004955 int emsgoff = TRUE;
Bram Moolenaar80dad482019-06-09 17:22:31 +02004956
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004957 if (in_vim9script()
4958 && (check_for_string_arg(argvars, 0) == FAIL
4959 || check_for_opt_dict_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004960 return;
4961
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004962 if (argvars[1].v_type == VAR_DICT
Bram Moolenaard61efa52022-07-23 09:52:04 +01004963 && dict_get_bool(argvars[1].vval.v_dict, "errmsg", VVAL_FALSE))
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004964 emsgoff = FALSE;
4965
Bram Moolenaar80dad482019-06-09 17:22:31 +02004966 rettv->v_type = VAR_STRING;
4967 cmdstr = vim_strsave(tv_get_string(&argvars[0]));
4968
Yegappan Lakshmanan960dcbd2023-03-07 17:45:11 +00004969 CLEAR_FIELD(eap);
Bram Moolenaar80dad482019-06-09 17:22:31 +02004970 eap.cmd = cmdstr;
4971 eap.arg = cmdstr;
Bram Moolenaar8071cb22019-07-12 17:58:01 +02004972 eap.argt |= EX_NOSPC;
Bram Moolenaar80dad482019-06-09 17:22:31 +02004973 eap.usefilter = FALSE;
4974 eap.nextcmd = NULL;
4975 eap.cmdidx = CMD_USER;
4976
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004977 if (emsgoff)
4978 ++emsg_off;
4979 if (expand_filename(&eap, &cmdstr, &errormsg) == FAIL)
4980 if (!emsgoff && errormsg != NULL && *errormsg != NUL)
4981 emsg(errormsg);
4982 if (emsgoff)
4983 --emsg_off;
Bram Moolenaar80dad482019-06-09 17:22:31 +02004984
4985 rettv->vval.v_string = cmdstr;
4986}
4987
4988/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004989 * "feedkeys()" function
4990 */
4991 static void
4992f_feedkeys(typval_T *argvars, typval_T *rettv UNUSED)
4993{
4994 int remap = TRUE;
4995 int insert = FALSE;
4996 char_u *keys, *flags;
4997 char_u nbuf[NUMBUFLEN];
4998 int typed = FALSE;
4999 int execute = FALSE;
Bram Moolenaara9725222022-01-16 13:30:33 +00005000 int context = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005001 int dangerous = FALSE;
Bram Moolenaar5e66b422019-01-24 21:58:10 +01005002 int lowlevel = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005003
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005004 // This is not allowed in the sandbox. If the commands would still be
5005 // executed in the sandbox it would be OK, but it probably happens later,
5006 // when "sandbox" is no longer set.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005007 if (check_secure())
5008 return;
5009
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005010 if (in_vim9script()
5011 && (check_for_string_arg(argvars, 0) == FAIL
5012 || check_for_opt_string_arg(argvars, 1) == FAIL))
5013 return;
5014
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005015 keys = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005016
5017 if (argvars[1].v_type != VAR_UNKNOWN)
5018 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005019 flags = tv_get_string_buf(&argvars[1], nbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005020 for ( ; *flags != NUL; ++flags)
5021 {
5022 switch (*flags)
5023 {
5024 case 'n': remap = FALSE; break;
5025 case 'm': remap = TRUE; break;
5026 case 't': typed = TRUE; break;
5027 case 'i': insert = TRUE; break;
5028 case 'x': execute = TRUE; break;
Bram Moolenaara9725222022-01-16 13:30:33 +00005029 case 'c': context = TRUE; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005030 case '!': dangerous = TRUE; break;
Bram Moolenaar5e66b422019-01-24 21:58:10 +01005031 case 'L': lowlevel = TRUE; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005032 }
5033 }
5034 }
5035
5036 if (*keys != NUL || execute)
5037 {
Christopher Plewright20b795e2022-12-20 20:01:58 +00005038 if (lowlevel
5039#ifdef FEAT_VTP
5040 && (!is_term_win32()
5041 || (keys[0] == 3 && ctrl_c_interrupts && typed))
5042#endif
5043 )
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005044 {
Bram Moolenaar5e66b422019-01-24 21:58:10 +01005045#ifdef USE_INPUT_BUF
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005046 ch_log(NULL, "feedkeys() lowlevel: %s", keys);
Bram Moolenaar9645e2d2020-03-20 20:48:49 +01005047
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005048 int len = (int)STRLEN(keys);
5049 for (int idx = 0; idx < len; ++idx)
5050 {
5051 // if a CTRL-C was typed, set got_int, similar to what
5052 // happens in fill_input_buf()
5053 if (keys[idx] == 3 && ctrl_c_interrupts && typed)
5054 got_int = TRUE;
5055 add_to_input_buf(keys + idx, 1);
5056 }
Bram Moolenaar5e66b422019-01-24 21:58:10 +01005057#else
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005058 emsg(_(e_lowlevel_input_not_supported));
Bram Moolenaar5e66b422019-01-24 21:58:10 +01005059#endif
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005060 }
5061 else
5062 {
5063 // Need to escape K_SPECIAL and CSI before putting the string in
5064 // the typeahead buffer.
5065 char_u *keys_esc = vim_strsave_escape_csi(keys);
5066 if (keys_esc == NULL)
5067 return;
5068
5069 ch_log(NULL, "feedkeys(%s): %s", typed ? "typed" : "", keys);
5070
5071 ins_typebuf(keys_esc, (remap ? REMAP_YES : REMAP_NONE),
5072 insert ? 0 : typebuf.tb_len, !typed, FALSE);
5073 if (vgetc_busy
Bram Moolenaar5d7be4f2017-06-25 13:40:17 +02005074#ifdef FEAT_TIMERS
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005075 || timer_busy
Bram Moolenaar5d7be4f2017-06-25 13:40:17 +02005076#endif
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005077 || input_busy)
5078 typebuf_was_filled = TRUE;
5079
Bram Moolenaar8d4ce562019-01-30 22:01:40 +01005080 vim_free(keys_esc);
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005081 }
Bram Moolenaar8d4ce562019-01-30 22:01:40 +01005082
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005083 if (execute)
5084 {
5085 int save_msg_scroll = msg_scroll;
5086 sctx_T save_sctx;
5087
5088 // Avoid a 1 second delay when the keys start Insert mode.
5089 msg_scroll = FALSE;
5090
5091 ch_log(NULL, "feedkeys() executing");
5092
5093 if (context)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005094 {
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005095 save_sctx = current_sctx;
5096 current_sctx.sc_sid = 0;
5097 current_sctx.sc_version = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005098 }
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00005099
5100 if (!dangerous)
5101 {
5102 ++ex_normal_busy;
5103 ++in_feedkeys;
5104 }
5105 exec_normal(TRUE, lowlevel, TRUE);
5106 if (!dangerous)
5107 {
5108 --ex_normal_busy;
5109 --in_feedkeys;
5110 }
5111
5112 msg_scroll |= save_msg_scroll;
5113
5114 if (context)
5115 current_sctx = save_sctx;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005116 }
5117 }
5118}
5119
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005120/*
5121 * "fnameescape({string})" function
5122 */
5123 static void
5124f_fnameescape(typval_T *argvars, typval_T *rettv)
5125{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005126 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5127 return;
5128
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005129 rettv->vval.v_string = vim_strsave_fnameescape(
Bram Moolenaar21c1a0c2021-10-17 17:20:23 +01005130 tv_get_string(&argvars[0]), VSE_NONE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005131 rettv->v_type = VAR_STRING;
5132}
5133
5134/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005135 * "foreground()" function
5136 */
5137 static void
5138f_foreground(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
5139{
5140#ifdef FEAT_GUI
5141 if (gui.in_use)
Bram Moolenaarafde13b2019-04-28 19:46:49 +02005142 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005143 gui_mch_set_foreground();
Bram Moolenaarafde13b2019-04-28 19:46:49 +02005144 return;
5145 }
5146#endif
5147#if defined(MSWIN) && (!defined(FEAT_GUI) || defined(VIMDLL))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005148 win32_set_foreground();
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005149#endif
5150}
5151
Bakudankun375141e2022-09-09 18:46:47 +01005152/*
5153 * "function()" function
5154 * "funcref()" function
5155 */
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005156 static void
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005157common_function(typval_T *argvars, typval_T *rettv, int is_funcref)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005158{
5159 char_u *s;
5160 char_u *name;
5161 int use_string = FALSE;
5162 partial_T *arg_pt = NULL;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005163 char_u *trans_name = NULL;
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02005164 int is_global = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005165
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02005166 if (in_vim9script()
Bram Moolenaarae1068a2021-12-25 19:43:44 +00005167 && (check_for_string_or_func_arg(argvars, 0) == FAIL
5168 || check_for_opt_list_arg(argvars, 1) == FAIL
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02005169 || (argvars[1].v_type != VAR_UNKNOWN
5170 && check_for_opt_dict_arg(argvars, 2) == FAIL)))
5171 return;
5172
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005173 if (argvars[0].v_type == VAR_FUNC)
5174 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005175 // function(MyFunc, [arg], dict)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005176 s = argvars[0].vval.v_string;
5177 }
5178 else if (argvars[0].v_type == VAR_PARTIAL
5179 && argvars[0].vval.v_partial != NULL)
5180 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005181 // function(dict.MyFunc, [arg])
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005182 arg_pt = argvars[0].vval.v_partial;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005183 s = partial_name(arg_pt);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005184 }
5185 else
5186 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005187 // function('MyFunc', [arg], dict)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005188 s = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005189 use_string = TRUE;
5190 }
Bram Moolenaar60b6e6f2021-08-28 12:49:27 +02005191 if (s == NULL)
5192 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00005193 semsg(_(e_invalid_argument_str), "NULL");
Bram Moolenaar60b6e6f2021-08-28 12:49:27 +02005194 return;
5195 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005196
Bram Moolenaar843b8842016-08-21 14:36:15 +02005197 if ((use_string && vim_strchr(s, AUTOLOAD_CHAR) == NULL) || is_funcref)
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005198 {
5199 name = s;
Bram Moolenaareba3b7f2021-11-30 18:25:08 +00005200 trans_name = save_function_name(&name, &is_global, FALSE,
5201 TFN_INT | TFN_QUIET | TFN_NO_AUTOLOAD | TFN_NO_DEREF, NULL);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005202 if (*name != NUL)
5203 s = NULL;
5204 }
5205
Bram Moolenaar843b8842016-08-21 14:36:15 +02005206 if (s == NULL || *s == NUL || (use_string && VIM_ISDIGIT(*s))
5207 || (is_funcref && trans_name == NULL))
Yegappan Lakshmanan655b7342022-03-06 14:27:10 +00005208 semsg(_(e_invalid_argument_str),
5209 use_string ? tv_get_string(&argvars[0]) : s);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005210 // Don't check an autoload name for existence here.
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005211 else if (trans_name != NULL && (is_funcref
Bram Moolenaard9d2fd02022-01-13 21:15:21 +00005212 ? find_func(trans_name, is_global) == NULL
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02005213 : !translated_function_exists(trans_name, is_global)))
Bram Moolenaara6f79292022-01-04 21:30:47 +00005214 semsg(_(e_unknown_function_str_2), s);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005215 else
5216 {
5217 int dict_idx = 0;
5218 int arg_idx = 0;
5219 list_T *list = NULL;
5220
5221 if (STRNCMP(s, "s:", 2) == 0 || STRNCMP(s, "<SID>", 5) == 0)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005222 // Expand s: and <SID> into <SNR>nr_, so that the function can
5223 // also be called from another script. Using trans_function_name()
5224 // would also work, but some plugins depend on the name being
5225 // printable text.
Yegappan Lakshmanane7f4abd2021-12-24 20:47:38 +00005226 name = get_scriptlocal_funcname(s);
Bram Moolenaarc2f17f72022-02-21 13:13:50 +00005227 else if (trans_name != NULL && *trans_name == K_SPECIAL)
5228 name = alloc_printable_func_name(trans_name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005229 else
5230 name = vim_strsave(s);
5231
5232 if (argvars[1].v_type != VAR_UNKNOWN)
5233 {
5234 if (argvars[2].v_type != VAR_UNKNOWN)
5235 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005236 // function(name, [args], dict)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005237 arg_idx = 1;
5238 dict_idx = 2;
5239 }
5240 else if (argvars[1].v_type == VAR_DICT)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005241 // function(name, dict)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005242 dict_idx = 1;
5243 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005244 // function(name, [args])
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005245 arg_idx = 1;
5246 if (dict_idx > 0)
5247 {
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +01005248 if (check_for_dict_arg(argvars, dict_idx) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005249 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005250 vim_free(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005251 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005252 }
5253 if (argvars[dict_idx].vval.v_dict == NULL)
5254 dict_idx = 0;
5255 }
5256 if (arg_idx > 0)
5257 {
5258 if (argvars[arg_idx].v_type != VAR_LIST)
5259 {
Bram Moolenaard82a47d2022-01-05 20:24:39 +00005260 emsg(_(e_second_argument_of_function_must_be_list_or_dict));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005261 vim_free(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005262 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005263 }
5264 list = argvars[arg_idx].vval.v_list;
5265 if (list == NULL || list->lv_len == 0)
5266 arg_idx = 0;
Bram Moolenaar4c054e92019-11-10 00:13:50 +01005267 else if (list->lv_len > MAX_FUNC_ARGS)
5268 {
Yegappan Lakshmanan5018a832022-04-02 21:12:21 +01005269 emsg_funcname(e_too_many_arguments_for_function_str, s);
Bram Moolenaar4c054e92019-11-10 00:13:50 +01005270 vim_free(name);
5271 goto theend;
5272 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005273 }
5274 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005275 if (dict_idx > 0 || arg_idx > 0 || arg_pt != NULL || is_funcref)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005276 {
Bram Moolenaarc799fe22019-05-28 23:08:19 +02005277 partial_T *pt = ALLOC_CLEAR_ONE(partial_T);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005278
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005279 // result is a VAR_PARTIAL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005280 if (pt == NULL)
5281 vim_free(name);
5282 else
5283 {
5284 if (arg_idx > 0 || (arg_pt != NULL && arg_pt->pt_argc > 0))
5285 {
5286 listitem_T *li;
5287 int i = 0;
5288 int arg_len = 0;
5289 int lv_len = 0;
5290
5291 if (arg_pt != NULL)
5292 arg_len = arg_pt->pt_argc;
5293 if (list != NULL)
5294 lv_len = list->lv_len;
5295 pt->pt_argc = arg_len + lv_len;
Bram Moolenaarc799fe22019-05-28 23:08:19 +02005296 pt->pt_argv = ALLOC_MULT(typval_T, pt->pt_argc);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005297 if (pt->pt_argv == NULL)
5298 {
5299 vim_free(pt);
5300 vim_free(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005301 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005302 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005303 for (i = 0; i < arg_len; i++)
5304 copy_tv(&arg_pt->pt_argv[i], &pt->pt_argv[i]);
5305 if (lv_len > 0)
Bram Moolenaar50985eb2020-01-27 22:09:39 +01005306 {
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02005307 CHECK_LIST_MATERIALIZE(list);
Bram Moolenaaraeea7212020-04-02 18:50:46 +02005308 FOR_ALL_LIST_ITEMS(list, li)
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005309 copy_tv(&li->li_tv, &pt->pt_argv[i++]);
Bram Moolenaar50985eb2020-01-27 22:09:39 +01005310 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005311 }
5312
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005313 // For "function(dict.func, [], dict)" and "func" is a partial
5314 // use "dict". That is backwards compatible.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005315 if (dict_idx > 0)
5316 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005317 // The dict is bound explicitly, pt_auto is FALSE.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005318 pt->pt_dict = argvars[dict_idx].vval.v_dict;
5319 ++pt->pt_dict->dv_refcount;
5320 }
5321 else if (arg_pt != NULL)
5322 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005323 // If the dict was bound automatically the result is also
5324 // bound automatically.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005325 pt->pt_dict = arg_pt->pt_dict;
5326 pt->pt_auto = arg_pt->pt_auto;
5327 if (pt->pt_dict != NULL)
5328 ++pt->pt_dict->dv_refcount;
Yegappan Lakshmanan29bb67f2023-10-14 11:18:50 +02005329 pt->pt_obj = arg_pt->pt_obj;
5330 if (pt->pt_obj != NULL)
5331 ++pt->pt_obj->obj_refcount;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005332 }
5333
5334 pt->pt_refcount = 1;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005335 if (arg_pt != NULL && arg_pt->pt_func != NULL)
5336 {
5337 pt->pt_func = arg_pt->pt_func;
5338 func_ptr_ref(pt->pt_func);
5339 vim_free(name);
5340 }
5341 else if (is_funcref)
5342 {
Bram Moolenaard9d2fd02022-01-13 21:15:21 +00005343 pt->pt_func = find_func(trans_name, is_global);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005344 func_ptr_ref(pt->pt_func);
5345 vim_free(name);
5346 }
5347 else
5348 {
5349 pt->pt_name = name;
5350 func_ref(name);
5351 }
Bram Moolenaar92368aa2022-02-07 17:50:39 +00005352
5353 if (arg_pt != NULL)
Bram Moolenaar7aca5ca2022-02-07 19:56:43 +00005354 {
5355 pt->pt_outer_partial = arg_pt;
5356 ++arg_pt->pt_refcount;
5357 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005358 }
5359 rettv->v_type = VAR_PARTIAL;
5360 rettv->vval.v_partial = pt;
5361 }
5362 else
5363 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005364 // result is a VAR_FUNC
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005365 rettv->v_type = VAR_FUNC;
5366 rettv->vval.v_string = name;
5367 func_ref(name);
5368 }
5369 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005370theend:
5371 vim_free(trans_name);
5372}
5373
5374/*
5375 * "funcref()" function
5376 */
5377 static void
5378f_funcref(typval_T *argvars, typval_T *rettv)
5379{
5380 common_function(argvars, rettv, TRUE);
5381}
5382
5383/*
5384 * "function()" function
5385 */
5386 static void
5387f_function(typval_T *argvars, typval_T *rettv)
5388{
5389 common_function(argvars, rettv, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005390}
5391
5392/*
5393 * "garbagecollect()" function
5394 */
5395 static void
5396f_garbagecollect(typval_T *argvars, typval_T *rettv UNUSED)
5397{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005398 if (in_vim9script() && check_for_opt_bool_arg(argvars, 0) == FAIL)
5399 return;
5400
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005401 // This is postponed until we are back at the toplevel, because we may be
5402 // using Lists and Dicts internally. E.g.: ":echo [garbagecollect()]".
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005403 want_garbage_collect = TRUE;
5404
Bram Moolenaar2df47312020-09-05 17:30:44 +02005405 if (argvars[0].v_type != VAR_UNKNOWN && tv_get_bool(&argvars[0]) == 1)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005406 garbage_collect_at_exit = TRUE;
5407}
5408
5409/*
5410 * "get()" function
5411 */
5412 static void
5413f_get(typval_T *argvars, typval_T *rettv)
5414{
5415 listitem_T *li;
5416 list_T *l;
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01005417 tuple_T *tuple;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005418 dictitem_T *di;
5419 dict_T *d;
5420 typval_T *tv = NULL;
Bram Moolenaarf91aac52019-07-28 13:21:01 +02005421 int what_is_dict = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005422
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005423 if (argvars[0].v_type == VAR_BLOB)
5424 {
5425 int error = FALSE;
5426 int idx = tv_get_number_chk(&argvars[1], &error);
5427
5428 if (!error)
5429 {
5430 rettv->v_type = VAR_NUMBER;
Bram Moolenaar2ea773b2019-01-15 22:16:42 +01005431 if (idx < 0)
5432 idx = blob_len(argvars[0].vval.v_blob) + idx;
5433 if (idx < 0 || idx >= blob_len(argvars[0].vval.v_blob))
5434 rettv->vval.v_number = -1;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005435 else
Bram Moolenaar2ea773b2019-01-15 22:16:42 +01005436 {
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005437 rettv->vval.v_number = blob_get(argvars[0].vval.v_blob, idx);
Bram Moolenaar2ea773b2019-01-15 22:16:42 +01005438 tv = rettv;
5439 }
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005440 }
5441 }
5442 else if (argvars[0].v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005443 {
5444 if ((l = argvars[0].vval.v_list) != NULL)
5445 {
5446 int error = FALSE;
5447
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005448 li = list_find(l, (long)tv_get_number_chk(&argvars[1], &error));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005449 if (!error && li != NULL)
5450 tv = &li->li_tv;
5451 }
5452 }
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01005453 else if (argvars[0].v_type == VAR_TUPLE)
5454 {
5455 if ((tuple = argvars[0].vval.v_tuple) != NULL)
5456 {
5457 int error = FALSE;
5458 long idx;
5459
5460 idx = (long)tv_get_number_chk(&argvars[1], &error);
5461 if (!error)
5462 tv = tuple_find(tuple, idx);
5463 }
5464 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005465 else if (argvars[0].v_type == VAR_DICT)
5466 {
5467 if ((d = argvars[0].vval.v_dict) != NULL)
5468 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005469 di = dict_find(d, tv_get_string(&argvars[1]), -1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005470 if (di != NULL)
5471 tv = &di->di_tv;
5472 }
5473 }
5474 else if (argvars[0].v_type == VAR_PARTIAL || argvars[0].v_type == VAR_FUNC)
5475 {
5476 partial_T *pt;
5477 partial_T fref_pt;
5478
5479 if (argvars[0].v_type == VAR_PARTIAL)
5480 pt = argvars[0].vval.v_partial;
5481 else
5482 {
Bram Moolenaara80faa82020-04-12 19:37:17 +02005483 CLEAR_FIELD(fref_pt);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005484 fref_pt.pt_name = argvars[0].vval.v_string;
5485 pt = &fref_pt;
5486 }
5487
5488 if (pt != NULL)
5489 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005490 char_u *what = tv_get_string(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005491
5492 if (STRCMP(what, "func") == 0 || STRCMP(what, "name") == 0)
5493 {
Bram Moolenaar1ae8c262022-06-27 11:45:52 +01005494 char_u *name = partial_name(pt);
5495
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005496 rettv->v_type = (*what == 'f' ? VAR_FUNC : VAR_STRING);
Bram Moolenaar1ae8c262022-06-27 11:45:52 +01005497 if (name == NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005498 rettv->vval.v_string = NULL;
5499 else
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005500 {
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005501 if (rettv->v_type == VAR_FUNC)
Bram Moolenaar1ae8c262022-06-27 11:45:52 +01005502 func_ref(name);
5503 if (*what == 'n' && pt->pt_name == NULL
5504 && pt->pt_func != NULL)
5505 // use <SNR> instead of the byte code
5506 name = printable_func_name(pt->pt_func);
5507 rettv->vval.v_string = vim_strsave(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005508 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005509 }
5510 else if (STRCMP(what, "dict") == 0)
Bram Moolenaarf91aac52019-07-28 13:21:01 +02005511 {
5512 what_is_dict = TRUE;
5513 if (pt->pt_dict != NULL)
5514 rettv_dict_set(rettv, pt->pt_dict);
5515 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005516 else if (STRCMP(what, "args") == 0)
5517 {
5518 rettv->v_type = VAR_LIST;
5519 if (rettv_list_alloc(rettv) == OK)
5520 {
5521 int i;
5522
5523 for (i = 0; i < pt->pt_argc; ++i)
5524 list_append_tv(rettv->vval.v_list, &pt->pt_argv[i]);
5525 }
5526 }
LemonBoy48b7d052024-07-09 18:24:59 +02005527 else if (STRCMP(what, "arity") == 0)
5528 {
5529 int required = 0, optional = 0, varargs = FALSE;
5530 char_u *name = partial_name(pt);
5531
5532 get_func_arity(name, &required, &optional, &varargs);
5533
5534 rettv->v_type = VAR_DICT;
5535 if (rettv_dict_alloc(rettv) == OK)
5536 {
5537 dict_T *dict = rettv->vval.v_dict;
5538
5539 // Take into account the arguments of the partial, if any.
5540 // Note that it is possible to supply more arguments than the function
5541 // accepts.
5542 if (pt->pt_argc >= required + optional)
5543 required = optional = 0;
5544 else if (pt->pt_argc > required)
5545 {
5546 optional -= pt->pt_argc - required;
5547 required = 0;
5548 }
5549 else
5550 required -= pt->pt_argc;
5551
5552 dict_add_number(dict, "required", required);
5553 dict_add_number(dict, "optional", optional);
5554 dict_add_bool(dict, "varargs", varargs);
5555 }
5556 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005557 else
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00005558 semsg(_(e_invalid_argument_str), what);
Bram Moolenaarf91aac52019-07-28 13:21:01 +02005559
5560 // When {what} == "dict" and pt->pt_dict == NULL, evaluate the
5561 // third argument
5562 if (!what_is_dict)
5563 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005564 }
5565 }
5566 else
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01005567 semsg(_(e_argument_of_str_must_be_list_tuple_dictionary_or_blob), "get()");
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005568
5569 if (tv == NULL)
5570 {
5571 if (argvars[2].v_type != VAR_UNKNOWN)
5572 copy_tv(&argvars[2], rettv);
5573 }
5574 else
5575 copy_tv(tv, rettv);
5576}
5577
Bram Moolenaarb5ae48e2016-08-12 22:23:25 +02005578/*
mikoto2000a73dfc22024-11-18 21:12:21 +01005579 * "getcellpixels()" function
5580 */
5581 static void
5582f_getcellpixels(typval_T *argvars UNUSED, typval_T *rettv)
5583{
5584 if (rettv_list_alloc(rettv) == FAIL)
Naruhiko Nishinoc2a90002025-05-04 20:05:47 +02005585 return;
mikoto2000a73dfc22024-11-18 21:12:21 +01005586
5587#if defined(FEAT_GUI)
5588 if (gui.in_use)
5589 {
Naruhiko Nishinoc2a90002025-05-04 20:05:47 +02005590 // success pixel size and no gui.
5591 list_append_number(rettv->vval.v_list, (varnumber_T)gui.char_width);
5592 list_append_number(rettv->vval.v_list, (varnumber_T)gui.char_height);
mikoto2000a73dfc22024-11-18 21:12:21 +01005593 }
5594 else
5595#endif
5596 {
Naruhiko Nishinoc2a90002025-05-04 20:05:47 +02005597 struct cellsize cs;
mikoto2000a73dfc22024-11-18 21:12:21 +01005598#if defined(UNIX)
Naruhiko Nishinoc2a90002025-05-04 20:05:47 +02005599 mch_calc_cell_size(&cs);
mikoto2000a73dfc22024-11-18 21:12:21 +01005600#else
Naruhiko Nishinoc2a90002025-05-04 20:05:47 +02005601 // Non-Unix CUIs are not supported, so set this to -1x-1.
5602 cs.cs_xpixel = -1;
5603 cs.cs_ypixel = -1;
mikoto2000a73dfc22024-11-18 21:12:21 +01005604#endif
5605
Naruhiko Nishinoc2a90002025-05-04 20:05:47 +02005606 // failed get pixel size.
5607 if (cs.cs_xpixel == -1)
5608 return;
mikoto2000a73dfc22024-11-18 21:12:21 +01005609
Naruhiko Nishinoc2a90002025-05-04 20:05:47 +02005610 // success pixel size and no gui.
5611 list_append_number(rettv->vval.v_list, (varnumber_T)cs.cs_xpixel);
5612 list_append_number(rettv->vval.v_list, (varnumber_T)cs.cs_ypixel);
mikoto2000a73dfc22024-11-18 21:12:21 +01005613 }
5614
5615}
5616
5617/*
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005618 * "getchangelist()" function
5619 */
5620 static void
5621f_getchangelist(typval_T *argvars, typval_T *rettv)
5622{
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005623 buf_T *buf;
5624 int i;
5625 list_T *l;
5626 dict_T *d;
LemonBoydb0ea7f2022-04-10 17:59:26 +01005627 int changelistindex;
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005628
Bram Moolenaar93a10962022-06-16 11:42:09 +01005629 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005630 return;
5631
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005632 if (in_vim9script() && check_for_opt_buffer_arg(argvars, 0) == FAIL)
5633 return;
5634
Bram Moolenaar4c313b12019-08-24 22:58:31 +02005635 if (argvars[0].v_type == VAR_UNKNOWN)
5636 buf = curbuf;
5637 else
Bram Moolenaara5d38412020-09-02 21:02:35 +02005638 buf = tv_get_buf_from_arg(&argvars[0]);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005639 if (buf == NULL)
5640 return;
5641
5642 l = list_alloc();
5643 if (l == NULL)
5644 return;
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005645 if (list_append_list(rettv->vval.v_list, l) == FAIL)
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005646 {
5647 vim_free(l);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005648 return;
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005649 }
5650
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005651 /*
LemonBoydb0ea7f2022-04-10 17:59:26 +01005652 * The current window change list index tracks only the position for the
5653 * current buffer. For other buffers use the stored index for the current
5654 * window, or, if that's not available, the change list length.
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005655 */
LemonBoydb0ea7f2022-04-10 17:59:26 +01005656 if (buf == curwin->w_buffer)
5657 {
5658 changelistindex = curwin->w_changelistidx;
5659 }
5660 else
5661 {
5662 wininfo_T *wip;
5663
5664 FOR_ALL_BUF_WININFO(buf, wip)
5665 if (wip->wi_win == curwin)
5666 break;
5667 changelistindex = wip != NULL ? wip->wi_changelistidx
5668 : buf->b_changelistlen;
5669 }
5670 list_append_number(rettv->vval.v_list, (varnumber_T)changelistindex);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005671
5672 for (i = 0; i < buf->b_changelistlen; ++i)
5673 {
5674 if (buf->b_changelist[i].lnum == 0)
5675 continue;
5676 if ((d = dict_alloc()) == NULL)
5677 return;
5678 if (list_append_dict(l, d) == FAIL)
5679 return;
Bram Moolenaare0be1672018-07-08 16:50:37 +02005680 dict_add_number(d, "lnum", (long)buf->b_changelist[i].lnum);
5681 dict_add_number(d, "col", (long)buf->b_changelist[i].col);
Bram Moolenaare0be1672018-07-08 16:50:37 +02005682 dict_add_number(d, "coladd", (long)buf->b_changelist[i].coladd);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005683 }
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005684}
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005685
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005686 static void
5687getpos_both(
5688 typval_T *argvars,
5689 typval_T *rettv,
5690 int getcurpos,
5691 int charcol)
5692{
5693 pos_T *fp = NULL;
5694 pos_T pos;
5695 win_T *wp = curwin;
5696 list_T *l;
5697 int fnum = -1;
5698
5699 if (rettv_list_alloc(rettv) == OK)
5700 {
5701 l = rettv->vval.v_list;
5702 if (getcurpos)
5703 {
5704 if (argvars[0].v_type != VAR_UNKNOWN)
5705 {
5706 wp = find_win_by_nr_or_id(&argvars[0]);
5707 if (wp != NULL)
5708 fp = &wp->w_cursor;
5709 }
5710 else
5711 fp = &curwin->w_cursor;
5712 if (fp != NULL && charcol)
5713 {
5714 pos = *fp;
Bram Moolenaar91458462021-01-13 20:08:38 +01005715 pos.col =
5716 buf_byteidx_to_charidx(wp->w_buffer, pos.lnum, pos.col);
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005717 fp = &pos;
5718 }
5719 }
5720 else
5721 fp = var2fpos(&argvars[0], TRUE, &fnum, charcol);
5722 if (fnum != -1)
5723 list_append_number(l, (varnumber_T)fnum);
5724 else
5725 list_append_number(l, (varnumber_T)0);
5726 list_append_number(l, (fp != NULL) ? (varnumber_T)fp->lnum
5727 : (varnumber_T)0);
5728 list_append_number(l, (fp != NULL)
5729 ? (varnumber_T)(fp->col == MAXCOL ? MAXCOL : fp->col + 1)
5730 : (varnumber_T)0);
5731 list_append_number(l, (fp != NULL) ? (varnumber_T)fp->coladd :
5732 (varnumber_T)0);
5733 if (getcurpos)
5734 {
5735 int save_set_curswant = curwin->w_set_curswant;
5736 colnr_T save_curswant = curwin->w_curswant;
5737 colnr_T save_virtcol = curwin->w_virtcol;
5738
5739 if (wp == curwin)
5740 update_curswant();
5741 list_append_number(l, wp == NULL ? 0 : wp->w_curswant == MAXCOL
5742 ? (varnumber_T)MAXCOL : (varnumber_T)wp->w_curswant + 1);
5743
5744 // Do not change "curswant", as it is unexpected that a get
5745 // function has a side effect.
5746 if (wp == curwin && save_set_curswant)
5747 {
5748 curwin->w_set_curswant = save_set_curswant;
5749 curwin->w_curswant = save_curswant;
5750 curwin->w_virtcol = save_virtcol;
5751 curwin->w_valid &= ~VALID_VIRTCOL;
5752 }
5753 }
5754 }
5755 else
5756 rettv->vval.v_number = FALSE;
5757}
5758
5759/*
5760 * "getcharpos()" function
5761 */
5762 static void
5763f_getcharpos(typval_T *argvars UNUSED, typval_T *rettv)
5764{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005765 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5766 return;
5767
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005768 getpos_both(argvars, rettv, FALSE, TRUE);
5769}
5770
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005771/*
5772 * "getcharsearch()" function
5773 */
5774 static void
5775f_getcharsearch(typval_T *argvars UNUSED, typval_T *rettv)
5776{
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00005777 if (rettv_dict_alloc(rettv) != OK)
5778 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005779
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00005780 dict_T *dict = rettv->vval.v_dict;
5781
5782 dict_add_string(dict, "char", last_csearch());
5783 dict_add_number(dict, "forward", last_csearch_forward());
5784 dict_add_number(dict, "until", last_csearch_until());
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005785}
5786
5787/*
Bram Moolenaar691ddee2019-05-09 14:52:41 +02005788 * "getenv()" function
5789 */
5790 static void
5791f_getenv(typval_T *argvars, typval_T *rettv)
5792{
5793 int mustfree = FALSE;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005794 char_u *p;
Bram Moolenaar691ddee2019-05-09 14:52:41 +02005795
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005796 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5797 return;
5798
5799 p = vim_getenv(tv_get_string(&argvars[0]), &mustfree);
Bram Moolenaar691ddee2019-05-09 14:52:41 +02005800 if (p == NULL)
5801 {
5802 rettv->v_type = VAR_SPECIAL;
5803 rettv->vval.v_number = VVAL_NULL;
5804 return;
5805 }
5806 if (!mustfree)
5807 p = vim_strsave(p);
5808 rettv->vval.v_string = p;
5809 rettv->v_type = VAR_STRING;
5810}
5811
5812/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005813 * "getfontname()" function
5814 */
5815 static void
5816f_getfontname(typval_T *argvars UNUSED, typval_T *rettv)
5817{
5818 rettv->v_type = VAR_STRING;
5819 rettv->vval.v_string = NULL;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005820
5821 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
5822 return;
5823
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005824#ifdef FEAT_GUI
5825 if (gui.in_use)
5826 {
5827 GuiFont font;
5828 char_u *name = NULL;
5829
5830 if (argvars[0].v_type == VAR_UNKNOWN)
5831 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005832 // Get the "Normal" font. Either the name saved by
5833 // hl_set_font_name() or from the font ID.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005834 font = gui.norm_font;
5835 name = hl_get_font_name();
5836 }
5837 else
5838 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005839 name = tv_get_string(&argvars[0]);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005840 if (STRCMP(name, "*") == 0) // don't use font dialog
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005841 return;
5842 font = gui_mch_get_font(name, FALSE);
5843 if (font == NOFONT)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005844 return; // Invalid font name, return empty string.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005845 }
5846 rettv->vval.v_string = gui_mch_get_fontname(font, name);
5847 if (argvars[0].v_type != VAR_UNKNOWN)
5848 gui_mch_free_font(font);
5849 }
5850#endif
5851}
5852
5853/*
Bram Moolenaar4f505882018-02-10 21:06:32 +01005854 * "getjumplist()" function
5855 */
5856 static void
5857f_getjumplist(typval_T *argvars, typval_T *rettv)
5858{
Bram Moolenaar4f505882018-02-10 21:06:32 +01005859 win_T *wp;
5860 int i;
5861 list_T *l;
5862 dict_T *d;
Bram Moolenaar4f505882018-02-10 21:06:32 +01005863
Bram Moolenaar93a10962022-06-16 11:42:09 +01005864 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar4f505882018-02-10 21:06:32 +01005865 return;
5866
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005867 if (in_vim9script()
5868 && (check_for_opt_number_arg(argvars, 0) == FAIL
5869 || (argvars[0].v_type != VAR_UNKNOWN
5870 && check_for_opt_number_arg(argvars, 1) == FAIL)))
5871 return;
5872
Bram Moolenaar00aa0692019-04-27 20:37:57 +02005873 wp = find_tabwin(&argvars[0], &argvars[1], NULL);
Bram Moolenaar4f505882018-02-10 21:06:32 +01005874 if (wp == NULL)
5875 return;
5876
Bram Moolenaar57ee2b62019-02-12 22:15:06 +01005877 cleanup_jumplist(wp, TRUE);
5878
Bram Moolenaar4f505882018-02-10 21:06:32 +01005879 l = list_alloc();
5880 if (l == NULL)
5881 return;
Bram Moolenaar4f505882018-02-10 21:06:32 +01005882 if (list_append_list(rettv->vval.v_list, l) == FAIL)
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005883 {
5884 vim_free(l);
Bram Moolenaar4f505882018-02-10 21:06:32 +01005885 return;
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005886 }
5887
Bram Moolenaar4f505882018-02-10 21:06:32 +01005888 list_append_number(rettv->vval.v_list, (varnumber_T)wp->w_jumplistidx);
5889
5890 for (i = 0; i < wp->w_jumplistlen; ++i)
5891 {
Bram Moolenaara7e18d22018-02-11 14:29:49 +01005892 if (wp->w_jumplist[i].fmark.mark.lnum == 0)
5893 continue;
Bram Moolenaar4f505882018-02-10 21:06:32 +01005894 if ((d = dict_alloc()) == NULL)
5895 return;
5896 if (list_append_dict(l, d) == FAIL)
5897 return;
Bram Moolenaare0be1672018-07-08 16:50:37 +02005898 dict_add_number(d, "lnum", (long)wp->w_jumplist[i].fmark.mark.lnum);
5899 dict_add_number(d, "col", (long)wp->w_jumplist[i].fmark.mark.col);
Bram Moolenaare0be1672018-07-08 16:50:37 +02005900 dict_add_number(d, "coladd", (long)wp->w_jumplist[i].fmark.mark.coladd);
Bram Moolenaare0be1672018-07-08 16:50:37 +02005901 dict_add_number(d, "bufnr", (long)wp->w_jumplist[i].fmark.fnum);
Bram Moolenaara7e18d22018-02-11 14:29:49 +01005902 if (wp->w_jumplist[i].fname != NULL)
Bram Moolenaare0be1672018-07-08 16:50:37 +02005903 dict_add_string(d, "filename", wp->w_jumplist[i].fname);
Bram Moolenaar4f505882018-02-10 21:06:32 +01005904 }
Bram Moolenaar4f505882018-02-10 21:06:32 +01005905}
5906
5907/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005908 * "getpid()" function
5909 */
5910 static void
5911f_getpid(typval_T *argvars UNUSED, typval_T *rettv)
5912{
5913 rettv->vval.v_number = mch_get_pid();
5914}
5915
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005916/*
5917 * "getcurpos()" function
5918 */
5919 static void
5920f_getcurpos(typval_T *argvars, typval_T *rettv)
5921{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005922 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
5923 return;
5924
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005925 getpos_both(argvars, rettv, TRUE, FALSE);
5926}
5927
5928 static void
5929f_getcursorcharpos(typval_T *argvars, typval_T *rettv)
5930{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005931 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
5932 return;
5933
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005934 getpos_both(argvars, rettv, TRUE, TRUE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005935}
5936
5937/*
5938 * "getpos(string)" function
5939 */
5940 static void
5941f_getpos(typval_T *argvars, typval_T *rettv)
5942{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005943 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5944 return;
5945
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005946 getpos_both(argvars, rettv, FALSE, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005947}
5948
5949/*
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005950 * Convert from block_def to string
5951 */
Gary Johnson88d4f252024-06-01 20:51:33 +02005952 static char_u *
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005953block_def2str(struct block_def *bd)
5954{
5955 char_u *p, *ret;
5956 size_t size = bd->startspaces + bd->endspaces + bd->textlen;
5957
5958 ret = alloc(size + 1);
5959 if (ret != NULL)
5960 {
5961 p = ret;
5962 vim_memset(p, ' ', bd->startspaces);
5963 p += bd->startspaces;
5964 mch_memmove(p, bd->textstart, bd->textlen);
5965 p += bd->textlen;
5966 vim_memset(p, ' ', bd->endspaces);
5967 *(p + bd->endspaces) = NUL;
5968 }
5969 return ret;
5970}
5971
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005972 static int
5973getregionpos(
5974 typval_T *argvars,
5975 typval_T *rettv,
zeertzjqc95e64f2024-05-20 14:00:31 +02005976 pos_T *p1,
5977 pos_T *p2,
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005978 int *inclusive,
5979 int *region_type,
zeertzjqafc22952024-05-24 19:07:12 +02005980 oparg_T *oap)
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005981{
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005982 int fnum1 = -1, fnum2 = -1;
5983 char_u *type;
5984 buf_T *findbuf;
5985 char_u default_type[] = "v";
zeertzjqafc22952024-05-24 19:07:12 +02005986 int block_width = 0;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005987 int is_select_exclusive;
5988 int l;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005989
5990 if (rettv_list_alloc(rettv) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005991 return FAIL;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005992
Shougo Matsushita19b71882024-02-28 22:48:12 +01005993 if (check_for_list_arg(argvars, 0) == FAIL
5994 || check_for_list_arg(argvars, 1) == FAIL
5995 || check_for_opt_dict_arg(argvars, 2) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005996 return FAIL;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005997
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005998 if (list2fpos(&argvars[0], p1, &fnum1, NULL, FALSE) != OK
5999 || list2fpos(&argvars[1], p2, &fnum2, NULL, FALSE) != OK
Shougo Matsushita84bf6e62024-03-06 21:10:18 +01006000 || fnum1 != fnum2)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006001 return FAIL;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006002
Shougo Matsushita19b71882024-02-28 22:48:12 +01006003 if (argvars[2].v_type == VAR_DICT)
6004 {
6005 is_select_exclusive = dict_get_bool(
6006 argvars[2].vval.v_dict, "exclusive", *p_sel == 'e');
6007 type = dict_get_string(
6008 argvars[2].vval.v_dict, "type", FALSE);
6009 if (type == NULL)
6010 type = default_type;
6011 }
6012 else
6013 {
6014 is_select_exclusive = *p_sel == 'e';
6015 type = default_type;
6016 }
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006017
6018 if (type[0] == 'v' && type[1] == NUL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006019 *region_type = MCHAR;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006020 else if (type[0] == 'V' && type[1] == NUL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006021 *region_type = MLINE;
zeertzjqafc22952024-05-24 19:07:12 +02006022 else if (type[0] == Ctrl_V)
6023 {
6024 char_u *p = type + 1;
6025
6026 if (*p != NUL && ((block_width = getdigits(&p)) <= 0 || *p != NUL))
6027 {
6028 semsg(_(e_invalid_value_for_argument_str_str), "type", type);
6029 return FAIL;
6030 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006031 *region_type = MBLOCK;
zeertzjqafc22952024-05-24 19:07:12 +02006032 }
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006033 else
zeertzjq26dd09a2024-03-10 15:46:58 +01006034 {
6035 semsg(_(e_invalid_value_for_argument_str_str), "type", type);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006036 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01006037 }
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006038
zeertzjq5406eb82024-03-11 21:36:42 +01006039 findbuf = fnum1 != 0 ? buflist_findnr(fnum1) : curbuf;
6040 if (findbuf == NULL || findbuf->b_ml.ml_mfp == NULL)
Shougo Matsushita84bf6e62024-03-06 21:10:18 +01006041 {
zeertzjq5406eb82024-03-11 21:36:42 +01006042 emsg(_(e_buffer_is_not_loaded));
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006043 return FAIL;
Shougo Matsushita84bf6e62024-03-06 21:10:18 +01006044 }
6045
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006046 if (p1->lnum < 1 || p1->lnum > findbuf->b_ml.ml_line_count)
zeertzjq26dd09a2024-03-10 15:46:58 +01006047 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006048 semsg(_(e_invalid_line_number_nr), p1->lnum);
6049 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01006050 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006051 if (p1->col == MAXCOL)
6052 p1->col = ml_get_buf_len(findbuf, p1->lnum) + 1;
6053 else if (p1->col < 1 || p1->col > ml_get_buf_len(findbuf, p1->lnum) + 1)
zeertzjq26dd09a2024-03-10 15:46:58 +01006054 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006055 semsg(_(e_invalid_column_number_nr), p1->col);
6056 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01006057 }
zeertzjq2ffdae72024-05-02 13:06:24 +02006058
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006059 if (p2->lnum < 1 || p2->lnum > findbuf->b_ml.ml_line_count)
zeertzjq26dd09a2024-03-10 15:46:58 +01006060 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006061 semsg(_(e_invalid_line_number_nr), p2->lnum);
6062 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01006063 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006064 if (p2->col == MAXCOL)
6065 p2->col = ml_get_buf_len(findbuf, p2->lnum) + 1;
6066 else if (p2->col < 1 || p2->col > ml_get_buf_len(findbuf, p2->lnum) + 1)
zeertzjq26dd09a2024-03-10 15:46:58 +01006067 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006068 semsg(_(e_invalid_column_number_nr), p2->col);
6069 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01006070 }
6071
6072 curbuf = findbuf;
zeertzjq5406eb82024-03-11 21:36:42 +01006073 curwin->w_buffer = curbuf;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006074 virtual_op = virtual_active();
6075
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006076 // NOTE: Adjustment is needed.
6077 p1->col--;
6078 p2->col--;
Shougo Matsushita19b71882024-02-28 22:48:12 +01006079
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006080 if (!LT_POS(*p1, *p2))
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006081 {
6082 // swap position
6083 pos_T p;
6084
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006085 p = *p1;
6086 *p1 = *p2;
6087 *p2 = p;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006088 }
6089
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006090 if (*region_type == MCHAR)
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006091 {
zeertzjq701ad502024-05-23 07:47:55 +02006092 // Handle 'selection' == "exclusive".
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006093 if (is_select_exclusive && !EQUAL_POS(*p1, *p2))
zeertzjq701ad502024-05-23 07:47:55 +02006094 // When backing up to previous line, inclusive becomes false.
6095 *inclusive = !unadjust_for_sel_inner(p2);
6096 // If p2 is on NUL (end of line), inclusive becomes false.
6097 if (*inclusive && !virtual_op && *ml_get_pos(p2) == NUL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006098 *inclusive = FALSE;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006099 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006100 else if (*region_type == MBLOCK)
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006101 {
6102 colnr_T sc1, ec1, sc2, ec2;
6103
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006104 getvvcol(curwin, p1, &sc1, NULL, &ec1);
6105 getvvcol(curwin, p2, &sc2, NULL, &ec2);
zeertzjqafc22952024-05-24 19:07:12 +02006106 oap->motion_type = MBLOCK;
6107 oap->inclusive = TRUE;
6108 oap->op_type = OP_NOP;
6109 oap->start = *p1;
6110 oap->end = *p2;
6111 oap->start_vcol = MIN(sc1, sc2);
6112 if (block_width > 0)
6113 oap->end_vcol = oap->start_vcol + block_width - 1;
6114 else if (is_select_exclusive && ec1 < sc2 && 0 < sc2 && ec2 > ec1)
6115 oap->end_vcol = sc2 - 1;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006116 else
zeertzjqafc22952024-05-24 19:07:12 +02006117 oap->end_vcol = MAX(ec1, ec2);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006118 }
6119
6120 // Include the trailing byte of a multi-byte char.
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006121 l = mb_ptr2len((char_u *)ml_get_pos(p2));
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006122 if (l > 1)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006123 p2->col += l - 1;
6124
6125 return OK;
6126}
6127
6128/*
6129 * "getregion()" function
6130 */
6131 static void
6132f_getregion(typval_T *argvars, typval_T *rettv)
6133{
6134 pos_T p1, p2;
6135 int inclusive = TRUE;
6136 int region_type = -1;
6137 oparg_T oa;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006138
6139 buf_T *save_curbuf;
6140 int save_virtual;
6141 char_u *akt = NULL;
6142 linenr_T lnum;
6143
6144 save_curbuf = curbuf;
6145 save_virtual = virtual_op;
6146
6147 if (getregionpos(argvars, rettv,
zeertzjqc95e64f2024-05-20 14:00:31 +02006148 &p1, &p2, &inclusive, &region_type, &oa) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006149 return;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006150
6151 for (lnum = p1.lnum; lnum <= p2.lnum; lnum++)
6152 {
6153 int ret = 0;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006154 struct block_def bd;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006155
6156 if (region_type == MLINE)
6157 akt = vim_strsave(ml_get(lnum));
6158 else if (region_type == MBLOCK)
6159 {
zeertzjq5e3674b2024-02-22 19:51:34 +01006160 block_prep(&oa, &bd, lnum, FALSE);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006161 akt = block_def2str(&bd);
6162 }
6163 else if (p1.lnum < lnum && lnum < p2.lnum)
6164 akt = vim_strsave(ml_get(lnum));
6165 else
6166 {
6167 charwise_block_prep(p1, p2, &bd, lnum, inclusive);
6168 akt = block_def2str(&bd);
6169 }
6170
6171 if (akt)
6172 {
6173 ret = list_append_string(rettv->vval.v_list, akt, -1);
6174 vim_free(akt);
6175 }
6176
6177 if (akt == NULL || ret == FAIL)
6178 {
zeertzjq5e3674b2024-02-22 19:51:34 +01006179 clear_tv(rettv);
6180 (void)rettv_list_alloc(rettv);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006181 break;
6182 }
6183 }
6184
zeertzjqc95e64f2024-05-20 14:00:31 +02006185 // getregionpos() may change curbuf and virtual_op
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006186 curbuf = save_curbuf;
6187 curwin->w_buffer = curbuf;
6188 virtual_op = save_virtual;
6189}
6190
6191 static void
zeertzjqc95e64f2024-05-20 14:00:31 +02006192add_regionpos_range(typval_T *rettv, pos_T p1, pos_T p2)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006193{
6194 list_T *l1, *l2, *l3;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006195
6196 l1 = list_alloc();
6197 if (l1 == NULL)
6198 return;
6199
6200 if (list_append_list(rettv->vval.v_list, l1) == FAIL)
6201 {
6202 vim_free(l1);
6203 return;
6204 }
6205
6206 l2 = list_alloc();
6207 if (l2 == NULL)
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006208 {
6209 vim_free(l1);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006210 return;
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006211 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006212
6213 if (list_append_list(l1, l2) == FAIL)
6214 {
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006215 vim_free(l1);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006216 vim_free(l2);
6217 return;
6218 }
6219
6220 l3 = list_alloc();
6221 if (l3 == NULL)
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006222 {
6223 vim_free(l1);
6224 vim_free(l2);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006225 return;
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006226 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006227
6228 if (list_append_list(l1, l3) == FAIL)
6229 {
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006230 vim_free(l1);
6231 vim_free(l2);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006232 vim_free(l3);
6233 return;
6234 }
6235
zeertzjqc95e64f2024-05-20 14:00:31 +02006236 list_append_number(l2, curbuf->b_fnum);
6237 list_append_number(l2, p1.lnum);
zeertzjq2b09de92024-05-24 07:48:51 +02006238 list_append_number(l2, p1.col);
zeertzjqc95e64f2024-05-20 14:00:31 +02006239 list_append_number(l2, p1.coladd);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006240
zeertzjqc95e64f2024-05-20 14:00:31 +02006241 list_append_number(l3, curbuf->b_fnum);
6242 list_append_number(l3, p2.lnum);
zeertzjq2b09de92024-05-24 07:48:51 +02006243 list_append_number(l3, p2.col);
zeertzjqc95e64f2024-05-20 14:00:31 +02006244 list_append_number(l3, p2.coladd);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006245}
6246
6247/*
6248 * "getregionpos()" function
6249 */
6250 static void
6251f_getregionpos(typval_T *argvars, typval_T *rettv)
6252{
6253 pos_T p1, p2;
6254 int inclusive = TRUE;
6255 int region_type = -1;
zeertzjq2b09de92024-05-24 07:48:51 +02006256 int allow_eol = FALSE;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006257 oparg_T oa;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006258 int lnum;
6259
6260 buf_T *save_curbuf;
6261 int save_virtual;
6262
6263 save_curbuf = curbuf;
6264 save_virtual = virtual_op;
6265
6266 if (getregionpos(argvars, rettv,
zeertzjqc95e64f2024-05-20 14:00:31 +02006267 &p1, &p2, &inclusive, &region_type, &oa) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006268 return;
6269
zeertzjq2b09de92024-05-24 07:48:51 +02006270 if (argvars[2].v_type == VAR_DICT)
6271 allow_eol = dict_get_bool(argvars[2].vval.v_dict, "eol", FALSE);
6272
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006273 for (lnum = p1.lnum; lnum <= p2.lnum; lnum++)
6274 {
zeertzjq2b09de92024-05-24 07:48:51 +02006275 pos_T ret_p1, ret_p2;
zeertzjqef733742024-05-26 18:42:18 +02006276 char_u *line = ml_get(lnum);
zeertzjq2b09de92024-05-24 07:48:51 +02006277 colnr_T line_len = ml_get_len(lnum);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006278
6279 if (region_type == MLINE)
6280 {
zeertzjqc95e64f2024-05-20 14:00:31 +02006281 ret_p1.col = 1;
6282 ret_p1.coladd = 0;
6283 ret_p2.col = MAXCOL;
6284 ret_p2.coladd = 0;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006285 }
6286 else
6287 {
zeertzjq52a6f342024-05-22 16:42:44 +02006288 struct block_def bd;
6289
zeertzjqc95e64f2024-05-20 14:00:31 +02006290 if (region_type == MBLOCK)
6291 block_prep(&oa, &bd, lnum, FALSE);
6292 else
6293 charwise_block_prep(p1, p2, &bd, lnum, inclusive);
zeertzjq52a6f342024-05-22 16:42:44 +02006294
6295 if (bd.is_oneChar) // selection entirely inside one char
6296 {
6297 if (region_type == MBLOCK)
6298 {
zeertzjqef733742024-05-26 18:42:18 +02006299 ret_p1.col = mb_prevptr(line, bd.textstart) - line + 1;
zeertzjq52a6f342024-05-22 16:42:44 +02006300 ret_p1.coladd = bd.start_char_vcols
6301 - (bd.start_vcol - oa.start_vcol);
6302 }
6303 else
6304 {
6305 ret_p1.col = p1.col + 1;
6306 ret_p1.coladd = p1.coladd;
6307 }
6308 }
zeertzjq2b09de92024-05-24 07:48:51 +02006309 else if (region_type == MBLOCK && oa.start_vcol > bd.start_vcol)
6310 {
6311 // blockwise selection entirely beyond end of line
6312 ret_p1.col = MAXCOL;
6313 ret_p1.coladd = oa.start_vcol - bd.start_vcol;
6314 bd.is_oneChar = TRUE;
6315 }
zeertzjq52a6f342024-05-22 16:42:44 +02006316 else if (bd.startspaces > 0)
zeertzjqc95e64f2024-05-20 14:00:31 +02006317 {
zeertzjqef733742024-05-26 18:42:18 +02006318 ret_p1.col = mb_prevptr(line, bd.textstart) - line + 1;
zeertzjqc95e64f2024-05-20 14:00:31 +02006319 ret_p1.coladd = bd.start_char_vcols - bd.startspaces;
6320 }
6321 else
6322 {
6323 ret_p1.col = bd.textcol + 1;
6324 ret_p1.coladd = 0;
6325 }
zeertzjq52a6f342024-05-22 16:42:44 +02006326
6327 if (bd.is_oneChar) // selection entirely inside one char
6328 {
6329 ret_p2.col = ret_p1.col;
zeertzjq2b09de92024-05-24 07:48:51 +02006330 ret_p2.coladd = ret_p1.coladd + bd.startspaces + bd.endspaces;
zeertzjq52a6f342024-05-22 16:42:44 +02006331 }
6332 else if (bd.endspaces > 0)
zeertzjqc95e64f2024-05-20 14:00:31 +02006333 {
6334 ret_p2.col = bd.textcol + bd.textlen + 1;
6335 ret_p2.coladd = bd.endspaces;
6336 }
6337 else
6338 {
6339 ret_p2.col = bd.textcol + bd.textlen;
6340 ret_p2.coladd = 0;
6341 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006342 }
6343
zeertzjq2b09de92024-05-24 07:48:51 +02006344 if (!allow_eol && ret_p1.col > line_len)
6345 {
6346 ret_p1.col = 0;
6347 ret_p1.coladd = 0;
6348 }
6349 else if (ret_p1.col > line_len + 1)
6350 ret_p1.col = line_len + 1;
6351
6352 if (!allow_eol && ret_p2.col > line_len)
6353 {
6354 ret_p2.col = ret_p1.col == 0 ? 0 : line_len;
6355 ret_p2.coladd = 0;
6356 }
6357 else if (ret_p2.col > line_len + 1)
6358 ret_p2.col = line_len + 1;
6359
zeertzjqc95e64f2024-05-20 14:00:31 +02006360 ret_p1.lnum = lnum;
6361 ret_p2.lnum = lnum;
6362 add_regionpos_range(rettv, ret_p1, ret_p2);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006363 }
6364
6365 // getregionpos() may change curbuf and virtual_op
zeertzjq5406eb82024-03-11 21:36:42 +01006366 curbuf = save_curbuf;
6367 curwin->w_buffer = curbuf;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006368 virtual_op = save_virtual;
6369}
6370
6371/*
zeertzjqd3f00f52021-12-24 12:02:43 +00006372 * Common between getreg(), getreginfo() and getregtype(): get the register
6373 * name from the first argument.
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006374 * Returns zero on error.
6375 */
6376 static int
6377getreg_get_regname(typval_T *argvars)
6378{
6379 char_u *strregname;
6380
6381 if (argvars[0].v_type != VAR_UNKNOWN)
6382 {
6383 strregname = tv_get_string_chk(&argvars[0]);
6384 if (strregname != NULL && in_vim9script() && STRLEN(strregname) > 1)
6385 {
6386 semsg(_(e_register_name_must_be_one_char_str), strregname);
6387 strregname = NULL;
6388 }
6389 if (strregname == NULL) // type error; errmsg already given
6390 return 0;
6391 }
6392 else
6393 // Default to v:register
6394 strregname = get_vim_var_str(VV_REG);
6395
6396 return *strregname == 0 ? '"' : *strregname;
6397}
6398
6399/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006400 * "getreg()" function
6401 */
6402 static void
6403f_getreg(typval_T *argvars, typval_T *rettv)
6404{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006405 int regname;
6406 int arg2 = FALSE;
6407 int return_list = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006408
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02006409 if (in_vim9script()
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006410 && (check_for_opt_string_arg(argvars, 0) == FAIL
6411 || (argvars[0].v_type != VAR_UNKNOWN
6412 && (check_for_opt_bool_arg(argvars, 1) == FAIL
6413 || (argvars[1].v_type != VAR_UNKNOWN
6414 && check_for_opt_bool_arg(argvars, 2) == FAIL)))))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02006415 return;
6416
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006417 regname = getreg_get_regname(argvars);
6418 if (regname == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006419 return;
6420
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006421 if (argvars[0].v_type != VAR_UNKNOWN && argvars[1].v_type != VAR_UNKNOWN)
6422 {
6423 int error = FALSE;
6424
6425 arg2 = (int)tv_get_bool_chk(&argvars[1], &error);
6426
6427 if (!error && argvars[2].v_type != VAR_UNKNOWN)
6428 return_list = (int)tv_get_bool_chk(&argvars[2], &error);
6429 if (error)
6430 return;
6431 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006432
6433 if (return_list)
6434 {
6435 rettv->v_type = VAR_LIST;
6436 rettv->vval.v_list = (list_T *)get_reg_contents(regname,
6437 (arg2 ? GREG_EXPR_SRC : 0) | GREG_LIST);
6438 if (rettv->vval.v_list == NULL)
6439 (void)rettv_list_alloc(rettv);
6440 else
6441 ++rettv->vval.v_list->lv_refcount;
6442 }
6443 else
6444 {
6445 rettv->v_type = VAR_STRING;
6446 rettv->vval.v_string = get_reg_contents(regname,
6447 arg2 ? GREG_EXPR_SRC : 0);
6448 }
6449}
6450
6451/*
6452 * "getregtype()" function
6453 */
6454 static void
6455f_getregtype(typval_T *argvars, typval_T *rettv)
6456{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006457 int regname;
6458 char_u buf[NUMBUFLEN + 2];
6459 long reglen = 0;
6460
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006461 // on error return an empty string
6462 rettv->v_type = VAR_STRING;
6463 rettv->vval.v_string = NULL;
6464
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006465 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
6466 return;
6467
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006468 regname = getreg_get_regname(argvars);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006469 if (regname == 0)
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006470 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006471
6472 buf[0] = NUL;
6473 buf[1] = NUL;
6474 switch (get_reg_type(regname, &reglen))
6475 {
6476 case MLINE: buf[0] = 'V'; break;
6477 case MCHAR: buf[0] = 'v'; break;
6478 case MBLOCK:
6479 buf[0] = Ctrl_V;
6480 sprintf((char *)buf + 1, "%ld", reglen + 1);
6481 break;
6482 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006483 rettv->vval.v_string = vim_strsave(buf);
6484}
6485
Bram Moolenaarb5ae48e2016-08-12 22:23:25 +02006486/*
Bram Moolenaarf49cc602018-11-11 15:21:05 +01006487 * "gettagstack()" function
6488 */
6489 static void
6490f_gettagstack(typval_T *argvars, typval_T *rettv)
6491{
6492 win_T *wp = curwin; // default is current window
6493
Bram Moolenaar93a10962022-06-16 11:42:09 +01006494 if (rettv_dict_alloc(rettv) == FAIL)
Bram Moolenaarf49cc602018-11-11 15:21:05 +01006495 return;
6496
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006497 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
6498 return;
6499
Bram Moolenaarf49cc602018-11-11 15:21:05 +01006500 if (argvars[0].v_type != VAR_UNKNOWN)
6501 {
6502 wp = find_win_by_nr_or_id(&argvars[0]);
6503 if (wp == NULL)
6504 return;
6505 }
6506
6507 get_tagstack(wp, rettv->vval.v_dict);
6508}
6509
Bram Moolenaar0b39c3f2020-08-30 15:52:10 +02006510/*
6511 * "gettext()" function
6512 */
6513 static void
6514f_gettext(typval_T *argvars, typval_T *rettv)
6515{
Christ van Willegence0ef912024-06-20 23:41:59 +02006516#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
6517 char *prev = NULL;
6518#endif
6519
6520 if (check_for_nonempty_string_arg(argvars, 0) == FAIL
6521 || check_for_opt_string_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006522 return;
6523
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +01006524 rettv->v_type = VAR_STRING;
Christ van Willegence0ef912024-06-20 23:41:59 +02006525
6526 if (argvars[1].v_type == VAR_STRING &&
6527 argvars[1].vval.v_string != NULL &&
6528 *(argvars[1].vval.v_string) != NUL)
6529 {
6530#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
6531 prev = bind_textdomain_codeset((const char *)argvars[1].vval.v_string, (char *)p_enc);
6532#endif
6533
6534#if defined(HAVE_DGETTEXT)
6535 rettv->vval.v_string = vim_strsave((char_u *)dgettext((const char *)argvars[1].vval.v_string, (const char *)argvars[0].vval.v_string));
6536#else
6537 textdomain((const char *)argvars[1].vval.v_string);
6538 rettv->vval.v_string = vim_strsave((char_u *)_(argvars[0].vval.v_string));
6539 textdomain(VIMPACKAGE);
6540#endif
6541
6542#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
6543 if (prev != NULL)
6544 bind_textdomain_codeset((const char *)argvars[1].vval.v_string, prev);
6545#endif
6546 }
6547 else
6548 rettv->vval.v_string = vim_strsave((char_u *)_(argvars[0].vval.v_string));
Bram Moolenaar0b39c3f2020-08-30 15:52:10 +02006549}
6550
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01006551// for VIM_VERSION_ defines
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006552#include "version.h"
6553
6554/*
6555 * "has()" function
6556 */
Bram Moolenaara259d8d2020-01-31 20:10:50 +01006557 void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006558f_has(typval_T *argvars, typval_T *rettv)
6559{
6560 int i;
6561 char_u *name;
Bram Moolenaar79296512020-03-22 16:17:14 +01006562 int x = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006563 int n = FALSE;
Bram Moolenaar79296512020-03-22 16:17:14 +01006564 typedef struct {
6565 char *name;
6566 short present;
6567 } has_item_T;
6568 static has_item_T has_list[] =
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006569 {
Bram Moolenaar79296512020-03-22 16:17:14 +01006570 {"amiga",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006571#ifdef AMIGA
Bram Moolenaar79296512020-03-22 16:17:14 +01006572 1
Bram Moolenaar39536dd2019-01-29 22:58:21 +01006573#else
Bram Moolenaar79296512020-03-22 16:17:14 +01006574 0
Bram Moolenaar39536dd2019-01-29 22:58:21 +01006575#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006576 },
6577 {"arp",
6578#if defined(AMIGA) && defined(FEAT_ARP)
6579 1
6580#else
6581 0
6582#endif
6583 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006584 {"haiku",
6585#ifdef __HAIKU__
6586 1
6587#else
6588 0
6589#endif
6590 },
6591 {"bsd",
Zhaoming Luoa41dfcd2025-02-06 21:39:35 +01006592#if defined(BSD) && !defined(MACOS_X) && !defined(__GNU__)
Bram Moolenaar79296512020-03-22 16:17:14 +01006593 1
6594#else
6595 0
6596#endif
6597 },
6598 {"hpux",
6599#ifdef hpux
6600 1
6601#else
6602 0
6603#endif
6604 },
Zhaoming Luoa41dfcd2025-02-06 21:39:35 +01006605 {"hurd",
6606#ifdef __GNU__
6607 1
6608#else
6609 0
6610#endif
6611 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006612 {"linux",
6613#ifdef __linux__
6614 1
6615#else
6616 0
6617#endif
6618 },
6619 {"mac", // Mac OS X (and, once, Mac OS Classic)
6620#ifdef MACOS_X
6621 1
6622#else
6623 0
6624#endif
6625 },
6626 {"osx", // Mac OS X
6627#ifdef MACOS_X
6628 1
6629#else
6630 0
6631#endif
6632 },
6633 {"macunix", // Mac OS X, with the darwin feature
6634#if defined(MACOS_X) && defined(MACOS_X_DARWIN)
6635 1
6636#else
6637 0
6638#endif
6639 },
6640 {"osxdarwin", // synonym for macunix
6641#if defined(MACOS_X) && defined(MACOS_X_DARWIN)
6642 1
6643#else
6644 0
6645#endif
6646 },
6647 {"qnx",
6648#ifdef __QNX__
6649 1
6650#else
6651 0
6652#endif
6653 },
6654 {"sun",
6655#ifdef SUN_SYSTEM
6656 1
6657#else
6658 0
6659#endif
6660 },
6661 {"unix",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006662#ifdef UNIX
Bram Moolenaar79296512020-03-22 16:17:14 +01006663 1
6664#else
6665 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006666#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006667 },
6668 {"vms",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006669#ifdef VMS
Bram Moolenaar79296512020-03-22 16:17:14 +01006670 1
6671#else
6672 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006673#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006674 },
6675 {"win32",
Bram Moolenaar4f974752019-02-17 17:44:42 +01006676#ifdef MSWIN
Bram Moolenaar79296512020-03-22 16:17:14 +01006677 1
6678#else
6679 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006680#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006681 },
6682 {"win32unix",
K.Takata972db232022-02-04 10:45:38 +00006683#ifdef WIN32UNIX
Bram Moolenaar79296512020-03-22 16:17:14 +01006684 1
6685#else
6686 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006687#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006688 },
6689 {"win64",
Bram Moolenaar44b443c2019-02-18 22:14:18 +01006690#ifdef _WIN64
Bram Moolenaar79296512020-03-22 16:17:14 +01006691 1
6692#else
6693 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006694#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006695 },
Bram Moolenaar424bcae2022-01-31 14:59:41 +00006696 {"ebcdic", 0 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006697 {"fname_case",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006698#ifndef CASE_INSENSITIVE_FILENAME
Bram Moolenaar79296512020-03-22 16:17:14 +01006699 1
6700#else
6701 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006702#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006703 },
6704 {"acl",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006705#ifdef HAVE_ACL
Bram Moolenaar79296512020-03-22 16:17:14 +01006706 1
6707#else
6708 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006709#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006710 },
6711 {"arabic",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006712#ifdef FEAT_ARABIC
Bram Moolenaar79296512020-03-22 16:17:14 +01006713 1
6714#else
6715 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006716#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006717 },
6718 {"autocmd", 1},
6719 {"autochdir",
Bram Moolenaar83ec2a72018-07-27 22:08:59 +02006720#ifdef FEAT_AUTOCHDIR
Bram Moolenaar79296512020-03-22 16:17:14 +01006721 1
6722#else
6723 0
Bram Moolenaar83ec2a72018-07-27 22:08:59 +02006724#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006725 },
6726 {"autoservername",
Bram Moolenaare42a6d22017-11-12 19:21:51 +01006727#ifdef FEAT_AUTOSERVERNAME
Bram Moolenaar79296512020-03-22 16:17:14 +01006728 1
6729#else
6730 0
Bram Moolenaare42a6d22017-11-12 19:21:51 +01006731#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006732 },
6733 {"balloon_eval",
Bram Moolenaarc3719bd2017-11-18 22:13:31 +01006734#ifdef FEAT_BEVAL_GUI
Bram Moolenaar79296512020-03-22 16:17:14 +01006735 1
6736#else
6737 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006738#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006739 },
6740 {"balloon_multiline",
Bram Moolenaar0bd663a2022-01-22 10:24:47 +00006741#ifdef FEAT_BEVAL_GUI
Bram Moolenaar79296512020-03-22 16:17:14 +01006742 1
6743#else
6744 0
6745#endif
6746 },
6747 {"balloon_eval_term",
Bram Moolenaarc3719bd2017-11-18 22:13:31 +01006748#ifdef FEAT_BEVAL_TERM
Bram Moolenaar79296512020-03-22 16:17:14 +01006749 1
6750#else
6751 0
Bram Moolenaar51b0f372017-11-18 18:52:04 +01006752#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006753 },
Bram Moolenaar2ee347f2022-08-26 17:53:44 +01006754 {"builtin_terms", 1},
6755 {"all_builtin_terms", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006756 {"browsefilter",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006757#if defined(FEAT_BROWSE) && (defined(USE_FILE_CHOOSER) \
Bram Moolenaar4f974752019-02-17 17:44:42 +01006758 || defined(FEAT_GUI_MSWIN) \
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006759 || defined(FEAT_GUI_MOTIF))
Bram Moolenaar79296512020-03-22 16:17:14 +01006760 1
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006761#else
Bram Moolenaar79296512020-03-22 16:17:14 +01006762 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006763#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006764 },
6765 {"byte_offset",
6766#ifdef FEAT_BYTEOFF
6767 1
6768#else
6769 0
6770#endif
6771 },
6772 {"channel",
6773#ifdef FEAT_JOB_CHANNEL
6774 1
6775#else
6776 0
6777#endif
6778 },
Bram Moolenaar8e145b82022-05-21 20:17:31 +01006779 {"cindent", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006780 {"clientserver",
6781#ifdef FEAT_CLIENTSERVER
6782 1
6783#else
6784 0
6785#endif
6786 },
6787 {"clipboard",
6788#ifdef FEAT_CLIPBOARD
6789 1
6790#else
6791 0
6792#endif
6793 },
6794 {"cmdline_compl", 1},
6795 {"cmdline_hist", 1},
Martin Tournoij7904fa42022-10-04 16:28:45 +01006796 {"cmdwin", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006797 {"comments", 1},
6798 {"conceal",
6799#ifdef FEAT_CONCEAL
6800 1
6801#else
6802 0
6803#endif
6804 },
6805 {"cryptv",
6806#ifdef FEAT_CRYPT
6807 1
6808#else
6809 0
6810#endif
6811 },
6812 {"crypt-blowfish",
6813#ifdef FEAT_CRYPT
6814 1
6815#else
6816 0
6817#endif
6818 },
6819 {"crypt-blowfish2",
6820#ifdef FEAT_CRYPT
6821 1
6822#else
6823 0
6824#endif
6825 },
6826 {"cscope",
6827#ifdef FEAT_CSCOPE
6828 1
6829#else
6830 0
6831#endif
6832 },
6833 {"cursorbind", 1},
6834 {"cursorshape",
6835#ifdef CURSOR_SHAPE
6836 1
6837#else
6838 0
6839#endif
6840 },
6841 {"debug",
6842#ifdef DEBUG
6843 1
6844#else
6845 0
6846#endif
6847 },
6848 {"dialog_con",
6849#ifdef FEAT_CON_DIALOG
6850 1
6851#else
6852 0
6853#endif
6854 },
glepnirdf461152024-04-04 22:23:29 +02006855 {"dialog_con_gui",
6856#if defined(FEAT_CON_DIALOG) && defined(FEAT_GUI_DIALOG)
6857 1
6858#else
6859 0
6860#endif
6861 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006862 {"dialog_gui",
6863#ifdef FEAT_GUI_DIALOG
6864 1
6865#else
6866 0
6867#endif
6868 },
6869 {"diff",
6870#ifdef FEAT_DIFF
6871 1
6872#else
6873 0
6874#endif
6875 },
6876 {"digraphs",
6877#ifdef FEAT_DIGRAPHS
6878 1
6879#else
6880 0
6881#endif
6882 },
6883 {"directx",
6884#ifdef FEAT_DIRECTX
6885 1
6886#else
6887 0
6888#endif
6889 },
6890 {"dnd",
6891#ifdef FEAT_DND
6892 1
6893#else
6894 0
6895#endif
6896 },
Bram Moolenaar1d1ce612021-06-27 19:02:52 +02006897 {"drop_file",
6898#ifdef HAVE_DROP_FILE
6899 1
6900#else
6901 0
6902#endif
6903 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006904 {"emacs_tags",
6905#ifdef FEAT_EMACS_TAGS
6906 1
6907#else
6908 0
6909#endif
6910 },
6911 {"eval", 1}, // always present, of course!
6912 {"ex_extra", 1}, // graduated feature
6913 {"extra_search",
6914#ifdef FEAT_SEARCH_EXTRA
6915 1
6916#else
6917 0
6918#endif
6919 },
Bram Moolenaarf80f40a2022-08-25 16:02:23 +01006920 {"file_in_path", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006921 {"filterpipe",
6922#if defined(FEAT_FILTERPIPE) && !defined(VIMDLL)
6923 1
6924#else
6925 0
6926#endif
6927 },
6928 {"find_in_path",
6929#ifdef FEAT_FIND_ID
6930 1
6931#else
6932 0
6933#endif
6934 },
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01006935 {"float", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006936 {"folding",
6937#ifdef FEAT_FOLDING
6938 1
6939#else
6940 0
6941#endif
6942 },
Bram Moolenaarc8ac3a02022-09-04 12:29:28 +01006943 {"footer", 0},
Bram Moolenaar79296512020-03-22 16:17:14 +01006944 {"fork",
6945#if !defined(USE_SYSTEM) && defined(UNIX)
6946 1
6947#else
6948 0
6949#endif
6950 },
6951 {"gettext",
6952#ifdef FEAT_GETTEXT
6953 1
6954#else
6955 0
6956#endif
6957 },
6958 {"gui",
6959#ifdef FEAT_GUI
6960 1
6961#else
6962 0
6963#endif
6964 },
Bram Moolenaar0b962e52022-04-03 18:02:37 +01006965 {"gui_neXtaw", 0 },
6966 {"gui_athena", 0 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006967 {"gui_gtk",
6968#ifdef FEAT_GUI_GTK
6969 1
6970#else
6971 0
6972#endif
6973 },
6974 {"gui_gtk2",
6975#if defined(FEAT_GUI_GTK) && !defined(USE_GTK3)
6976 1
6977#else
6978 0
6979#endif
6980 },
6981 {"gui_gtk3",
6982#if defined(FEAT_GUI_GTK) && defined(USE_GTK3)
6983 1
6984#else
6985 0
6986#endif
6987 },
6988 {"gui_gnome",
6989#ifdef FEAT_GUI_GNOME
6990 1
6991#else
6992 0
6993#endif
6994 },
6995 {"gui_haiku",
6996#ifdef FEAT_GUI_HAIKU
6997 1
6998#else
6999 0
7000#endif
7001 },
Bram Moolenaar097148e2020-08-11 21:58:20 +02007002 {"gui_mac", 0},
Bram Moolenaar79296512020-03-22 16:17:14 +01007003 {"gui_motif",
7004#ifdef FEAT_GUI_MOTIF
7005 1
7006#else
7007 0
7008#endif
7009 },
7010 {"gui_photon",
7011#ifdef FEAT_GUI_PHOTON
7012 1
7013#else
7014 0
7015#endif
7016 },
7017 {"gui_win32",
7018#ifdef FEAT_GUI_MSWIN
7019 1
7020#else
7021 0
7022#endif
7023 },
7024 {"iconv",
7025#if defined(HAVE_ICONV_H) && defined(USE_ICONV)
7026 1
7027#else
7028 0
7029#endif
7030 },
7031 {"insert_expand", 1},
Bram Moolenaarbfe13cc2020-04-12 17:53:12 +02007032 {"ipv6",
7033#ifdef FEAT_IPV6
7034 1
7035#else
7036 0
7037#endif
7038 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007039 {"job",
7040#ifdef FEAT_JOB_CHANNEL
7041 1
7042#else
7043 0
7044#endif
7045 },
Bram Moolenaar739f13a2021-12-13 13:12:53 +00007046 {"jumplist", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007047 {"keymap",
7048#ifdef FEAT_KEYMAP
7049 1
7050#else
7051 0
7052#endif
7053 },
7054 {"lambda", 1}, // always with FEAT_EVAL, since 7.4.2120 with closure
7055 {"langmap",
7056#ifdef FEAT_LANGMAP
7057 1
7058#else
7059 0
7060#endif
7061 },
7062 {"libcall",
7063#ifdef FEAT_LIBCALL
7064 1
7065#else
7066 0
7067#endif
7068 },
7069 {"linebreak",
7070#ifdef FEAT_LINEBREAK
7071 1
7072#else
7073 0
7074#endif
7075 },
Bram Moolenaar8e145b82022-05-21 20:17:31 +01007076 {"lispindent", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007077 {"listcmds", 1},
7078 {"localmap", 1},
7079 {"lua",
7080#if defined(FEAT_LUA) && !defined(DYNAMIC_LUA)
7081 1
7082#else
7083 0
7084#endif
7085 },
7086 {"menu",
7087#ifdef FEAT_MENU
7088 1
7089#else
7090 0
7091#endif
7092 },
7093 {"mksession",
7094#ifdef FEAT_SESSION
7095 1
7096#else
7097 0
7098#endif
7099 },
7100 {"modify_fname", 1},
7101 {"mouse", 1},
7102 {"mouseshape",
7103#ifdef FEAT_MOUSESHAPE
7104 1
7105#else
7106 0
7107#endif
7108 },
7109 {"mouse_dec",
7110#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_DEC)
7111 1
7112#else
7113 0
7114#endif
7115 },
7116 {"mouse_gpm",
Bram Moolenaar33fc4a62022-02-23 18:07:38 +00007117#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_GPM) && !defined(DYNAMIC_GPM)
Bram Moolenaar79296512020-03-22 16:17:14 +01007118 1
7119#else
7120 0
7121#endif
7122 },
7123 {"mouse_jsbterm",
7124#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_JSB)
7125 1
7126#else
7127 0
7128#endif
7129 },
7130 {"mouse_netterm",
7131#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_NET)
7132 1
7133#else
7134 0
7135#endif
7136 },
7137 {"mouse_pterm",
7138#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_PTERM)
7139 1
7140#else
7141 0
7142#endif
7143 },
7144 {"mouse_sgr",
7145#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_XTERM)
7146 1
7147#else
7148 0
7149#endif
7150 },
7151 {"mouse_sysmouse",
7152#if (defined(UNIX) || defined(VMS)) && defined(FEAT_SYSMOUSE)
7153 1
7154#else
7155 0
7156#endif
7157 },
7158 {"mouse_urxvt",
7159#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_URXVT)
7160 1
7161#else
7162 0
7163#endif
7164 },
7165 {"mouse_xterm",
7166#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_XTERM)
7167 1
7168#else
7169 0
7170#endif
7171 },
7172 {"multi_byte", 1},
7173 {"multi_byte_ime",
7174#ifdef FEAT_MBYTE_IME
7175 1
7176#else
7177 0
7178#endif
7179 },
7180 {"multi_lang",
7181#ifdef FEAT_MULTI_LANG
7182 1
7183#else
7184 0
7185#endif
7186 },
7187 {"mzscheme",
7188#if defined(FEAT_MZSCHEME) && !defined(DYNAMIC_MZSCHEME)
7189 1
7190#else
7191 0
7192#endif
7193 },
Leah Neukirchen0a7984a2021-10-14 21:27:55 +01007194 {"nanotime",
7195#ifdef ST_MTIM_NSEC
7196 1
7197#else
7198 0
7199#endif
7200 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007201 {"num64", 1},
7202 {"ole",
7203#ifdef FEAT_OLE
7204 1
7205#else
7206 0
7207#endif
7208 },
7209 {"packages",
7210#ifdef FEAT_EVAL
7211 1
7212#else
7213 0
7214#endif
7215 },
Bram Moolenaar2bd9dbc2022-08-25 18:12:06 +01007216 {"path_extra", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007217 {"perl",
7218#if defined(FEAT_PERL) && !defined(DYNAMIC_PERL)
7219 1
7220#else
7221 0
7222#endif
7223 },
7224 {"persistent_undo",
7225#ifdef FEAT_PERSISTENT_UNDO
7226 1
7227#else
7228 0
7229#endif
7230 },
7231 {"python_compiled",
7232#if defined(FEAT_PYTHON)
7233 1
7234#else
7235 0
7236#endif
7237 },
7238 {"python_dynamic",
7239#if defined(FEAT_PYTHON) && defined(DYNAMIC_PYTHON)
7240 1
7241#else
7242 0
7243#endif
7244 },
7245 {"python",
7246#if defined(FEAT_PYTHON) && !defined(DYNAMIC_PYTHON)
7247 1
7248#else
7249 0
7250#endif
7251 },
7252 {"pythonx",
7253#if (defined(FEAT_PYTHON) && !defined(DYNAMIC_PYTHON)) \
7254 || (defined(FEAT_PYTHON3) && !defined(DYNAMIC_PYTHON3))
7255 1
7256#else
7257 0
7258#endif
7259 },
7260 {"python3_compiled",
7261#if defined(FEAT_PYTHON3)
7262 1
7263#else
7264 0
7265#endif
7266 },
7267 {"python3_dynamic",
7268#if defined(FEAT_PYTHON3) && defined(DYNAMIC_PYTHON3)
7269 1
7270#else
7271 0
7272#endif
7273 },
Yee Cheng Chinc13b3d12023-08-20 21:18:38 +02007274 {"python3_stable",
7275#if defined(FEAT_PYTHON3) && defined(DYNAMIC_PYTHON3_STABLE_ABI)
7276 1
7277#else
7278 0
7279#endif
7280 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007281 {"python3",
7282#if defined(FEAT_PYTHON3) && !defined(DYNAMIC_PYTHON3)
7283 1
7284#else
7285 0
7286#endif
7287 },
7288 {"popupwin",
7289#ifdef FEAT_PROP_POPUP
7290 1
7291#else
7292 0
7293#endif
7294 },
7295 {"postscript",
7296#ifdef FEAT_POSTSCRIPT
7297 1
7298#else
7299 0
7300#endif
7301 },
7302 {"printer",
7303#ifdef FEAT_PRINTER
7304 1
7305#else
7306 0
7307#endif
7308 },
7309 {"profile",
7310#ifdef FEAT_PROFILE
7311 1
7312#else
7313 0
7314#endif
7315 },
Ernie Rael076de792023-03-16 21:43:15 +00007316 {"prof_nsec",
Bram Moolenaar08210f82023-04-13 19:15:54 +01007317#ifdef PROF_NSEC
Ernie Rael076de792023-03-16 21:43:15 +00007318 1
7319#else
7320 0
7321#endif
7322 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007323 {"reltime",
7324#ifdef FEAT_RELTIME
7325 1
7326#else
7327 0
7328#endif
7329 },
7330 {"quickfix",
7331#ifdef FEAT_QUICKFIX
7332 1
7333#else
7334 0
7335#endif
7336 },
7337 {"rightleft",
7338#ifdef FEAT_RIGHTLEFT
7339 1
7340#else
7341 0
7342#endif
7343 },
7344 {"ruby",
7345#if defined(FEAT_RUBY) && !defined(DYNAMIC_RUBY)
7346 1
7347#else
7348 0
7349#endif
7350 },
7351 {"scrollbind", 1},
Martin Tournoijba43e762022-10-13 22:12:15 +01007352 {"showcmd", 1},
7353 {"cmdline_info", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007354 {"signs",
7355#ifdef FEAT_SIGNS
7356 1
7357#else
7358 0
7359#endif
7360 },
Bram Moolenaar8e145b82022-05-21 20:17:31 +01007361 {"smartindent", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007362 {"startuptime",
7363#ifdef STARTUPTIME
7364 1
7365#else
7366 0
7367#endif
7368 },
7369 {"statusline",
7370#ifdef FEAT_STL_OPT
7371 1
7372#else
7373 0
7374#endif
7375 },
7376 {"netbeans_intg",
7377#ifdef FEAT_NETBEANS_INTG
7378 1
7379#else
7380 0
7381#endif
7382 },
Christian Brabandtf573c6e2021-06-20 14:02:16 +02007383 {"sodium",
K.Takatad68b2fc2022-02-12 11:18:37 +00007384#if defined(FEAT_SODIUM) && !defined(DYNAMIC_SODIUM)
Christian Brabandtf573c6e2021-06-20 14:02:16 +02007385 1
7386#else
7387 0
7388#endif
7389 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007390 {"sound",
7391#ifdef FEAT_SOUND
7392 1
7393#else
7394 0
7395#endif
7396 },
7397 {"spell",
7398#ifdef FEAT_SPELL
7399 1
7400#else
7401 0
7402#endif
7403 },
7404 {"syntax",
7405#ifdef FEAT_SYN_HL
7406 1
7407#else
7408 0
7409#endif
7410 },
7411 {"system",
7412#if defined(USE_SYSTEM) || !defined(UNIX)
7413 1
7414#else
7415 0
7416#endif
7417 },
Naruhiko Nishinobe5bd4d2025-05-14 21:20:28 +02007418 {"tabpanel",
7419#if defined(FEAT_TABPANEL)
7420 1,
7421#else
7422 0,
7423#endif
7424 },
Yegappan Lakshmanan655b7342022-03-06 14:27:10 +00007425 {"tag_binary", 1}, // graduated feature
Bram Moolenaar79296512020-03-22 16:17:14 +01007426 {"tcl",
7427#if defined(FEAT_TCL) && !defined(DYNAMIC_TCL)
7428 1
7429#else
7430 0
7431#endif
7432 },
7433 {"termguicolors",
7434#ifdef FEAT_TERMGUICOLORS
7435 1
7436#else
7437 0
7438#endif
7439 },
7440 {"terminal",
7441#if defined(FEAT_TERMINAL) && !defined(MSWIN)
7442 1
7443#else
7444 0
7445#endif
7446 },
7447 {"terminfo",
7448#ifdef TERMINFO
7449 1
7450#else
7451 0
7452#endif
7453 },
7454 {"termresponse",
7455#ifdef FEAT_TERMRESPONSE
7456 1
7457#else
7458 0
7459#endif
7460 },
Bram Moolenaar88774872022-08-16 20:24:29 +01007461 {"textobjects", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007462 {"textprop",
7463#ifdef FEAT_PROP_POPUP
7464 1
7465#else
7466 0
7467#endif
7468 },
7469 {"tgetent",
7470#ifdef HAVE_TGETENT
7471 1
7472#else
7473 0
7474#endif
7475 },
7476 {"timers",
7477#ifdef FEAT_TIMERS
7478 1
7479#else
7480 0
7481#endif
7482 },
Bram Moolenaar651fca82021-11-29 20:39:38 +00007483 {"title", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007484 {"toolbar",
7485#ifdef FEAT_TOOLBAR
7486 1
7487#else
7488 0
7489#endif
7490 },
7491 {"unnamedplus",
7492#if defined(FEAT_CLIPBOARD) && defined(FEAT_X11)
7493 1
7494#else
7495 0
7496#endif
7497 },
7498 {"user-commands", 1}, // was accidentally included in 5.4
7499 {"user_commands", 1},
7500 {"vartabs",
7501#ifdef FEAT_VARTABS
7502 1
7503#else
7504 0
7505#endif
7506 },
7507 {"vertsplit", 1},
7508 {"viminfo",
7509#ifdef FEAT_VIMINFO
7510 1
7511#else
7512 0
7513#endif
7514 },
Bram Moolenaarb79ee0c2022-01-01 12:17:00 +00007515 {"vim9script", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007516 {"vimscript-1", 1},
7517 {"vimscript-2", 1},
7518 {"vimscript-3", 1},
7519 {"vimscript-4", 1},
7520 {"virtualedit", 1},
7521 {"visual", 1},
7522 {"visualextra", 1},
7523 {"vreplace", 1},
7524 {"vtp",
7525#ifdef FEAT_VTP
7526 1
7527#else
7528 0
7529#endif
7530 },
Bram Moolenaar074fbd42022-08-26 16:41:14 +01007531 {"wildignore", 1},
Bram Moolenaar54162322022-08-26 16:58:51 +01007532 {"wildmenu", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007533 {"windows", 1},
7534 {"winaltkeys",
7535#ifdef FEAT_WAK
7536 1
7537#else
7538 0
7539#endif
7540 },
7541 {"writebackup",
7542#ifdef FEAT_WRITEBACKUP
7543 1
7544#else
7545 0
7546#endif
7547 },
Christian Brabandte085dfd2023-09-30 12:49:18 +02007548 {"xattr",
7549#ifdef FEAT_XATTR
7550 1
7551#else
7552 0
7553#endif
7554 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007555 {"xim",
7556#ifdef FEAT_XIM
7557 1
7558#else
7559 0
7560#endif
7561 },
7562 {"xfontset",
7563#ifdef FEAT_XFONTSET
7564 1
7565#else
7566 0
7567#endif
7568 },
7569 {"xpm",
7570#if defined(FEAT_XPM_W32) || defined(HAVE_XPM)
7571 1
7572#else
7573 0
7574#endif
7575 },
7576 {"xpm_w32", // for backward compatibility
7577#ifdef FEAT_XPM_W32
7578 1
7579#else
7580 0
7581#endif
7582 },
7583 {"xsmp",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007584#ifdef USE_XSMP
Bram Moolenaar79296512020-03-22 16:17:14 +01007585 1
7586#else
7587 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007588#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007589 },
7590 {"xsmp_interact",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007591#ifdef USE_XSMP_INTERACT
Bram Moolenaar79296512020-03-22 16:17:14 +01007592 1
7593#else
7594 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007595#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007596 },
7597 {"xterm_clipboard",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007598#ifdef FEAT_XCLIPBOARD
Bram Moolenaar79296512020-03-22 16:17:14 +01007599 1
7600#else
7601 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007602#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007603 },
7604 {"xterm_save",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007605#ifdef FEAT_XTERM_SAVE
Bram Moolenaar79296512020-03-22 16:17:14 +01007606 1
7607#else
7608 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007609#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007610 },
7611 {"X11",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007612#if defined(UNIX) && defined(FEAT_X11)
Bram Moolenaar79296512020-03-22 16:17:14 +01007613 1
7614#else
7615 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007616#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007617 },
Bram Moolenaar80adaa82023-07-07 18:57:40 +01007618 {":tearoff",
7619// same #ifdef as used for ex_tearoff().
7620#if defined(FEAT_GUI_MSWIN) && defined(FEAT_MENU) && defined(FEAT_TEAROFF)
7621 1
7622#else
7623 0
7624#endif
7625 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007626 {NULL, 0}
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007627 };
7628
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02007629 if (in_vim9script()
7630 && (check_for_string_arg(argvars, 0) == FAIL
7631 || check_for_opt_bool_arg(argvars, 1) == FAIL))
7632 return;
7633
Bram Moolenaard155d7a2018-12-21 16:04:21 +01007634 name = tv_get_string(&argvars[0]);
Bram Moolenaar79296512020-03-22 16:17:14 +01007635 for (i = 0; has_list[i].name != NULL; ++i)
7636 if (STRICMP(name, has_list[i].name) == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007637 {
Bram Moolenaar79296512020-03-22 16:17:14 +01007638 x = TRUE;
7639 n = has_list[i].present;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007640 break;
7641 }
7642
Bram Moolenaar79296512020-03-22 16:17:14 +01007643 // features also in has_list[] but sometimes enabled at runtime
7644 if (x == TRUE && n == FALSE)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007645 {
Bram Moolenaar79296512020-03-22 16:17:14 +01007646 if (0)
Bram Moolenaar86b9a3e2020-04-07 19:57:29 +02007647 {
7648 // intentionally empty
7649 }
Bram Moolenaar79296512020-03-22 16:17:14 +01007650#ifdef VIMDLL
7651 else if (STRICMP(name, "filterpipe") == 0)
7652 n = gui.in_use || gui.starting;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007653#endif
7654#if defined(USE_ICONV) && defined(DYNAMIC_ICONV)
7655 else if (STRICMP(name, "iconv") == 0)
7656 n = iconv_enabled(FALSE);
7657#endif
7658#ifdef DYNAMIC_LUA
7659 else if (STRICMP(name, "lua") == 0)
7660 n = lua_enabled(FALSE);
7661#endif
7662#ifdef DYNAMIC_MZSCHEME
7663 else if (STRICMP(name, "mzscheme") == 0)
7664 n = mzscheme_enabled(FALSE);
7665#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007666#ifdef DYNAMIC_PERL
7667 else if (STRICMP(name, "perl") == 0)
7668 n = perl_enabled(FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007669#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007670#ifdef DYNAMIC_PYTHON
7671 else if (STRICMP(name, "python") == 0)
7672 n = python_enabled(FALSE);
7673#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007674#ifdef DYNAMIC_PYTHON3
7675 else if (STRICMP(name, "python3") == 0)
7676 n = python3_enabled(FALSE);
7677#endif
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01007678#if defined(DYNAMIC_PYTHON) || defined(DYNAMIC_PYTHON3)
7679 else if (STRICMP(name, "pythonx") == 0)
7680 {
7681# if defined(DYNAMIC_PYTHON) && defined(DYNAMIC_PYTHON3)
7682 if (p_pyx == 0)
7683 n = python3_enabled(FALSE) || python_enabled(FALSE);
7684 else if (p_pyx == 3)
7685 n = python3_enabled(FALSE);
7686 else if (p_pyx == 2)
7687 n = python_enabled(FALSE);
7688# elif defined(DYNAMIC_PYTHON)
7689 n = python_enabled(FALSE);
7690# elif defined(DYNAMIC_PYTHON3)
7691 n = python3_enabled(FALSE);
7692# endif
7693 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007694#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007695#ifdef DYNAMIC_RUBY
7696 else if (STRICMP(name, "ruby") == 0)
7697 n = ruby_enabled(FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007698#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007699#ifdef DYNAMIC_TCL
7700 else if (STRICMP(name, "tcl") == 0)
7701 n = tcl_enabled(FALSE);
Bram Moolenaar4b8366b2019-05-04 17:34:34 +02007702#endif
K.Takatad68b2fc2022-02-12 11:18:37 +00007703#ifdef DYNAMIC_SODIUM
7704 else if (STRICMP(name, "sodium") == 0)
7705 n = sodium_enabled(FALSE);
7706#endif
Bram Moolenaar4f974752019-02-17 17:44:42 +01007707#if defined(FEAT_TERMINAL) && defined(MSWIN)
Bram Moolenaara83e3962017-08-17 14:39:07 +02007708 else if (STRICMP(name, "terminal") == 0)
7709 n = terminal_enabled();
7710#endif
Bram Moolenaar33fc4a62022-02-23 18:07:38 +00007711#ifdef DYNAMIC_GPM
7712 else if (STRICMP(name, "mouse_gpm") == 0)
7713 n = gpm_available();
7714#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007715 }
7716
Bram Moolenaar79296512020-03-22 16:17:14 +01007717 // features not in has_list[]
7718 if (x == FALSE)
7719 {
7720 if (STRNICMP(name, "patch", 5) == 0)
7721 {
7722 x = TRUE;
7723 if (name[5] == '-'
7724 && STRLEN(name) >= 11
K.Takatad90f91f2022-07-30 15:43:59 +01007725 && (name[6] >= '1' && name[6] <= '9'))
Bram Moolenaar79296512020-03-22 16:17:14 +01007726 {
K.Takatad90f91f2022-07-30 15:43:59 +01007727 char *end;
7728 int major, minor;
Bram Moolenaar79296512020-03-22 16:17:14 +01007729
K.Takatad90f91f2022-07-30 15:43:59 +01007730 // This works for patch-8.1.2, patch-9.0.3, patch-10.0.4, etc.
7731 // Not for patch-9.10.5.
7732 major = (int)strtoul((char *)name + 6, &end, 10);
7733 if (*end == '.' && vim_isdigit(end[1])
7734 && end[2] == '.' && vim_isdigit(end[3]))
7735 {
7736 minor = atoi(end + 1);
7737
7738 // Expect "patch-9.9.01234".
7739 n = (major < VIM_VERSION_MAJOR
7740 || (major == VIM_VERSION_MAJOR
7741 && (minor < VIM_VERSION_MINOR
7742 || (minor == VIM_VERSION_MINOR
7743 && has_patch(atoi(end + 3))))));
7744 }
Bram Moolenaar79296512020-03-22 16:17:14 +01007745 }
Keith Thompson184f71c2024-01-04 21:19:04 +01007746 else if (SAFE_isdigit(name[5]))
Bram Moolenaar79296512020-03-22 16:17:14 +01007747 n = has_patch(atoi((char *)name + 5));
7748 }
7749 else if (STRICMP(name, "vim_starting") == 0)
7750 {
7751 x = TRUE;
7752 n = (starting != 0);
7753 }
7754 else if (STRICMP(name, "ttyin") == 0)
7755 {
7756 x = TRUE;
7757 n = mch_input_isatty();
7758 }
7759 else if (STRICMP(name, "ttyout") == 0)
7760 {
7761 x = TRUE;
7762 n = stdout_isatty;
7763 }
7764 else if (STRICMP(name, "multi_byte_encoding") == 0)
7765 {
7766 x = TRUE;
7767 n = has_mbyte;
7768 }
7769 else if (STRICMP(name, "gui_running") == 0)
7770 {
7771 x = TRUE;
7772#ifdef FEAT_GUI
7773 n = (gui.in_use || gui.starting);
7774#endif
7775 }
7776 else if (STRICMP(name, "browse") == 0)
7777 {
7778 x = TRUE;
7779#if defined(FEAT_GUI) && defined(FEAT_BROWSE)
7780 n = gui.in_use; // gui_mch_browse() works when GUI is running
7781#endif
7782 }
7783 else if (STRICMP(name, "syntax_items") == 0)
7784 {
7785 x = TRUE;
7786#ifdef FEAT_SYN_HL
7787 n = syntax_present(curwin);
7788#endif
7789 }
7790 else if (STRICMP(name, "vcon") == 0)
7791 {
7792 x = TRUE;
7793#ifdef FEAT_VTP
7794 n = is_term_win32() && has_vtp_working();
7795#endif
7796 }
7797 else if (STRICMP(name, "netbeans_enabled") == 0)
7798 {
7799 x = TRUE;
7800#ifdef FEAT_NETBEANS_INTG
7801 n = netbeans_active();
7802#endif
7803 }
7804 else if (STRICMP(name, "mouse_gpm_enabled") == 0)
7805 {
7806 x = TRUE;
7807#ifdef FEAT_MOUSE_GPM
7808 n = gpm_enabled();
7809#endif
7810 }
7811 else if (STRICMP(name, "conpty") == 0)
7812 {
7813 x = TRUE;
7814#if defined(FEAT_TERMINAL) && defined(MSWIN)
7815 n = use_conpty();
7816#endif
7817 }
7818 else if (STRICMP(name, "clipboard_working") == 0)
7819 {
7820 x = TRUE;
7821#ifdef FEAT_CLIPBOARD
7822 n = clip_star.available;
7823#endif
7824 }
7825 }
7826
Bram Moolenaar04637e22020-09-05 18:45:29 +02007827 if (argvars[1].v_type != VAR_UNKNOWN && tv_get_bool(&argvars[1]))
Bram Moolenaar79296512020-03-22 16:17:14 +01007828 // return whether feature could ever be enabled
7829 rettv->vval.v_number = x;
7830 else
7831 // return whether feature is enabled
7832 rettv->vval.v_number = n;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007833}
7834
7835/*
Bram Moolenaar8cebd432020-11-08 12:49:47 +01007836 * Return TRUE if "feature" can change later.
7837 * Also when checking for the feature has side effects, such as loading a DLL.
7838 */
7839 int
7840dynamic_feature(char_u *feature)
7841{
7842 return (feature == NULL
Bram Moolenaar8cebd432020-11-08 12:49:47 +01007843#if defined(FEAT_GUI) && defined(FEAT_BROWSE)
7844 || (STRICMP(feature, "browse") == 0 && !gui.in_use)
7845#endif
7846#ifdef VIMDLL
7847 || STRICMP(feature, "filterpipe") == 0
7848#endif
Bram Moolenaar29b281b2020-11-10 20:58:00 +01007849#if defined(FEAT_GUI) && !defined(ALWAYS_USE_GUI) && !defined(VIMDLL)
Bram Moolenaar8cebd432020-11-08 12:49:47 +01007850 // this can only change on Unix where the ":gui" command could be
7851 // used.
7852 || (STRICMP(feature, "gui_running") == 0 && !gui.in_use)
7853#endif
7854#if defined(USE_ICONV) && defined(DYNAMIC_ICONV)
7855 || STRICMP(feature, "iconv") == 0
7856#endif
7857#ifdef DYNAMIC_LUA
7858 || STRICMP(feature, "lua") == 0
7859#endif
7860#ifdef FEAT_MOUSE_GPM
7861 || (STRICMP(feature, "mouse_gpm_enabled") == 0 && !gpm_enabled())
7862#endif
7863#ifdef DYNAMIC_MZSCHEME
7864 || STRICMP(feature, "mzscheme") == 0
7865#endif
7866#ifdef FEAT_NETBEANS_INTG
7867 || STRICMP(feature, "netbeans_enabled") == 0
7868#endif
7869#ifdef DYNAMIC_PERL
7870 || STRICMP(feature, "perl") == 0
7871#endif
7872#ifdef DYNAMIC_PYTHON
7873 || STRICMP(feature, "python") == 0
7874#endif
7875#ifdef DYNAMIC_PYTHON3
7876 || STRICMP(feature, "python3") == 0
7877#endif
7878#if defined(DYNAMIC_PYTHON) || defined(DYNAMIC_PYTHON3)
7879 || STRICMP(feature, "pythonx") == 0
7880#endif
7881#ifdef DYNAMIC_RUBY
7882 || STRICMP(feature, "ruby") == 0
7883#endif
7884#ifdef FEAT_SYN_HL
7885 || STRICMP(feature, "syntax_items") == 0
7886#endif
7887#ifdef DYNAMIC_TCL
7888 || STRICMP(feature, "tcl") == 0
7889#endif
7890 // once "starting" is zero it will stay that way
7891 || (STRICMP(feature, "vim_starting") == 0 && starting != 0)
7892 || STRICMP(feature, "multi_byte_encoding") == 0
7893#if defined(FEAT_TERMINAL) && defined(MSWIN)
7894 || STRICMP(feature, "conpty") == 0
7895#endif
7896 );
7897}
7898
7899/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007900 * "haslocaldir()" function
7901 */
7902 static void
7903f_haslocaldir(typval_T *argvars, typval_T *rettv)
7904{
Bram Moolenaar00aa0692019-04-27 20:37:57 +02007905 tabpage_T *tp = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007906 win_T *wp = NULL;
7907
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02007908 if (in_vim9script()
7909 && (check_for_opt_number_arg(argvars, 0) == FAIL
7910 || (argvars[0].v_type != VAR_UNKNOWN
7911 && check_for_opt_number_arg(argvars, 1) == FAIL)))
7912 return;
7913
Bram Moolenaar00aa0692019-04-27 20:37:57 +02007914 wp = find_tabwin(&argvars[0], &argvars[1], &tp);
7915
7916 // Check for window-local and tab-local directories
7917 if (wp != NULL && wp->w_localdir != NULL)
7918 rettv->vval.v_number = 1;
7919 else if (tp != NULL && tp->tp_localdir != NULL)
7920 rettv->vval.v_number = 2;
7921 else
7922 rettv->vval.v_number = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007923}
7924
7925/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007926 * "highlightID(name)" function
7927 */
7928 static void
7929f_hlID(typval_T *argvars, typval_T *rettv)
7930{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02007931 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
7932 return;
7933
Bram Moolenaard155d7a2018-12-21 16:04:21 +01007934 rettv->vval.v_number = syn_name2id(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007935}
7936
7937/*
7938 * "highlight_exists()" function
7939 */
7940 static void
7941f_hlexists(typval_T *argvars, typval_T *rettv)
7942{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02007943 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
7944 return;
7945
Bram Moolenaard155d7a2018-12-21 16:04:21 +01007946 rettv->vval.v_number = highlight_exists(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007947}
7948
7949/*
7950 * "hostname()" function
7951 */
7952 static void
7953f_hostname(typval_T *argvars UNUSED, typval_T *rettv)
7954{
7955 char_u hostname[256];
7956
7957 mch_get_host_name(hostname, 256);
7958 rettv->v_type = VAR_STRING;
7959 rettv->vval.v_string = vim_strsave(hostname);
7960}
7961
7962/*
Ernie Raelc8e158b2024-07-09 18:39:52 +02007963 * "id()" function
7964 * Identity. Return address of item as a hex string, %p format.
7965 * Currently only valid for object/container types.
7966 * Return empty string if not an object.
7967 */
Zoltan Arpadffy10231ac2024-08-18 16:59:20 +02007968#ifdef VMS // VMS does not have defined uintptr_t
7969# if defined(HAVE_NO_LONG_LONG)
7970typedef unsigned int uintptr_t;
7971# else
7972typedef unsigned long long uintptr_t;
7973# endif
7974#endif // VMS
7975
John Marriottb3b2bee2024-07-14 11:12:51 +02007976 static void
Ernie Raelc8e158b2024-07-09 18:39:52 +02007977f_id(typval_T *argvars, typval_T *rettv)
7978{
Ernie Rael05124252024-07-11 22:10:45 +02007979 char numbuf[NUMBUFLEN];
7980 char *p = numbuf;
Ernie Raelc8e158b2024-07-09 18:39:52 +02007981
7982 switch (argvars[0].v_type)
7983 {
7984 case VAR_LIST:
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01007985 case VAR_TUPLE:
Ernie Raelc8e158b2024-07-09 18:39:52 +02007986 case VAR_DICT:
7987 case VAR_OBJECT:
7988 case VAR_JOB:
7989 case VAR_CHANNEL:
7990 case VAR_BLOB:
7991 // Assume pointer value in typval_T vval union at common location.
7992 if (argvars[0].vval.v_object != NULL)
Ernie Rael05124252024-07-11 22:10:45 +02007993 {
7994 // "v" gets the address as an integer
7995 uintptr_t v = (uintptr_t)(void *)argvars[0].vval.v_object;
7996 // Build a hex string from the item's address; it is in
7997 // reverse order. Ignore trailing zeros.
7998 for (; p < numbuf + sizeof(uintptr_t) * 2 && v != 0;
7999 ++p, v >>= 4)
8000 *p = "0123456789abcdef"[v & 0xf];
8001 }
Ernie Raelc8e158b2024-07-09 18:39:52 +02008002 default:
Ernie Rael05124252024-07-11 22:10:45 +02008003 break;
Ernie Raelc8e158b2024-07-09 18:39:52 +02008004 }
Ernie Rael05124252024-07-11 22:10:45 +02008005 *p = NUL;
Ernie Raelc8e158b2024-07-09 18:39:52 +02008006
8007 rettv->v_type = VAR_STRING;
Ernie Rael05124252024-07-11 22:10:45 +02008008 rettv->vval.v_string = vim_strsave((char_u *)numbuf);
Ernie Raelc8e158b2024-07-09 18:39:52 +02008009}
8010
8011/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008012 * index() function for a blob
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008013 */
8014 static void
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008015index_func_blob(typval_T *argvars, typval_T *rettv)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008016{
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008017 typval_T tv;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008018 blob_T *b;
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008019 int start = 0;
8020 int error = FALSE;
8021 int ic = FALSE;
8022
8023 b = argvars[0].vval.v_blob;
8024 if (b == NULL)
8025 return;
8026
8027 if (argvars[2].v_type != VAR_UNKNOWN)
8028 {
8029 start = tv_get_number_chk(&argvars[2], &error);
8030 if (error)
8031 return;
8032 }
8033
8034 if (start < 0)
8035 {
8036 start = blob_len(b) + start;
8037 if (start < 0)
8038 start = 0;
8039 }
8040
8041 for (int idx = start; idx < blob_len(b); ++idx)
8042 {
8043 tv.v_type = VAR_NUMBER;
8044 tv.vval.v_number = blob_get(b, idx);
8045 if (tv_equal(&tv, &argvars[1], ic))
8046 {
8047 rettv->vval.v_number = idx;
8048 return;
8049 }
8050 }
8051}
8052
8053/*
8054 * index() function for a tuple
8055 */
8056 static void
8057index_func_tuple(typval_T *argvars, typval_T *rettv)
8058{
8059 tuple_T *tuple = argvars[0].vval.v_tuple;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008060 int ic = FALSE;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008061 int error = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008062
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008063 if (tuple == NULL)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008064 return;
8065
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008066 int start_idx = 0;
8067 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008068 {
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008069 start_idx = tv_get_number_chk(&argvars[2], &error);
8070 if (!error && argvars[3].v_type != VAR_UNKNOWN)
8071 ic = (int)tv_get_bool_chk(&argvars[3], &error);
8072 if (error)
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008073 return;
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008074 }
Bram Moolenaar05500ec2019-01-13 19:10:33 +01008075
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008076 rettv->vval.v_number = index_tuple(tuple, &argvars[1], start_idx, ic);
8077}
8078
8079/*
8080 * index() function for a list
8081 */
8082 static void
8083index_func_list(typval_T *argvars, typval_T *rettv)
8084{
8085 list_T *l;
8086 listitem_T *item;
8087 long idx = 0;
8088 int ic = FALSE;
8089 int error = FALSE;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008090
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008091 l = argvars[0].vval.v_list;
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00008092 if (l == NULL)
8093 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008094
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00008095 CHECK_LIST_MATERIALIZE(l);
8096 item = l->lv_first;
8097 if (argvars[2].v_type != VAR_UNKNOWN)
8098 {
8099 // Start at specified item. Use the cached index that list_find()
8100 // sets, so that a negative number also works.
8101 item = list_find(l, (long)tv_get_number_chk(&argvars[2], &error));
8102 idx = l->lv_u.mat.lv_idx;
8103 if (argvars[3].v_type != VAR_UNKNOWN)
8104 ic = (int)tv_get_bool_chk(&argvars[3], &error);
8105 if (error)
8106 item = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008107 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00008108
8109 for ( ; item != NULL; item = item->li_next, ++idx)
Yinzuo Jiang7ccd1a22024-07-04 17:20:53 +02008110 if (tv_equal(&item->li_tv, &argvars[1], ic))
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00008111 {
8112 rettv->vval.v_number = idx;
8113 break;
8114 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008115}
8116
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008117/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008118 * "index()" function
8119 */
8120 static void
8121f_index(typval_T *argvars, typval_T *rettv)
8122{
8123 rettv->vval.v_number = -1;
8124
8125 if (in_vim9script()
8126 && (check_for_list_or_tuple_or_blob_arg(argvars, 0) == FAIL
8127 || (argvars[0].v_type == VAR_BLOB
8128 && check_for_number_arg(argvars, 1) == FAIL)
8129 || check_for_opt_number_arg(argvars, 2) == FAIL
8130 || (argvars[2].v_type != VAR_UNKNOWN
8131 && check_for_opt_bool_arg(argvars, 3) == FAIL)))
8132 return;
8133
8134 if (argvars[0].v_type == VAR_BLOB)
8135 index_func_blob(argvars, rettv);
8136 else if (argvars[0].v_type == VAR_TUPLE)
8137 index_func_tuple(argvars, rettv);
8138 else if (argvars[0].v_type == VAR_LIST)
8139 index_func_list(argvars, rettv);
8140 else
8141 emsg(_(e_list_or_blob_required));
8142}
8143
8144/*
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008145 * Evaluate 'expr' with the v:key and v:val arguments and return the result.
8146 * The expression is expected to return a boolean value. The caller should set
8147 * the VV_KEY and VV_VAL vim variables before calling this function.
8148 */
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008149 int
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008150indexof_eval_expr(typval_T *expr)
8151{
8152 typval_T argv[3];
8153 typval_T newtv;
8154 varnumber_T found;
8155 int error = FALSE;
8156
8157 argv[0] = *get_vim_var_tv(VV_KEY);
8158 argv[1] = *get_vim_var_tv(VV_VAL);
8159 newtv.v_type = VAR_UNKNOWN;
8160
zeertzjqad0c4422023-08-17 22:15:47 +02008161 if (eval_expr_typval(expr, FALSE, argv, 2, NULL, &newtv) == FAIL)
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008162 return FALSE;
8163
8164 found = tv_get_bool_chk(&newtv, &error);
Yegappan Lakshmanan63acae12022-08-14 12:07:11 +01008165 clear_tv(&newtv);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008166
8167 return error ? FALSE : found;
8168}
8169
8170/*
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008171 * Evaluate 'expr' for each byte in the Blob 'b' starting with the byte at
8172 * 'startidx' and return the index of the byte where 'expr' is TRUE. Returns
8173 * -1 if 'expr' doesn't evaluate to TRUE for any of the bytes.
8174 */
8175 static int
8176indexof_blob(blob_T *b, long startidx, typval_T *expr)
8177{
8178 long idx = 0;
8179
8180 if (b == NULL)
8181 return -1;
8182
8183 if (startidx < 0)
8184 {
8185 // negative index: index from the last byte
8186 startidx = blob_len(b) + startidx;
8187 if (startidx < 0)
8188 startidx = 0;
8189 }
8190
8191 set_vim_var_type(VV_KEY, VAR_NUMBER);
8192 set_vim_var_type(VV_VAL, VAR_NUMBER);
8193
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008194 int called_emsg_start = called_emsg;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008195 for (idx = startidx; idx < blob_len(b); ++idx)
8196 {
8197 set_vim_var_nr(VV_KEY, idx);
8198 set_vim_var_nr(VV_VAL, blob_get(b, idx));
8199
8200 if (indexof_eval_expr(expr))
8201 return idx;
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008202
8203 if (called_emsg != called_emsg_start)
8204 return -1;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008205 }
8206
8207 return -1;
8208}
8209
8210/*
8211 * Evaluate 'expr' for each item in the List 'l' starting with the item at
8212 * 'startidx' and return the index of the item where 'expr' is TRUE. Returns
8213 * -1 if 'expr' doesn't evaluate to TRUE for any of the items.
8214 */
8215 static int
8216indexof_list(list_T *l, long startidx, typval_T *expr)
8217{
8218 listitem_T *item;
8219 long idx = 0;
Yegappan Lakshmanan63acae12022-08-14 12:07:11 +01008220 int found;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008221
8222 if (l == NULL)
8223 return -1;
8224
8225 CHECK_LIST_MATERIALIZE(l);
8226
8227 if (startidx == 0)
8228 item = l->lv_first;
8229 else
8230 {
8231 // Start at specified item. Use the cached index that list_find()
8232 // sets, so that a negative number also works.
8233 item = list_find(l, startidx);
8234 if (item != NULL)
8235 idx = l->lv_u.mat.lv_idx;
8236 }
8237
8238 set_vim_var_type(VV_KEY, VAR_NUMBER);
8239
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008240 int called_emsg_start = called_emsg;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008241 for ( ; item != NULL; item = item->li_next, ++idx)
8242 {
8243 set_vim_var_nr(VV_KEY, idx);
8244 copy_tv(&item->li_tv, get_vim_var_tv(VV_VAL));
8245
Yegappan Lakshmanan63acae12022-08-14 12:07:11 +01008246 found = indexof_eval_expr(expr);
8247 clear_tv(get_vim_var_tv(VV_VAL));
8248
8249 if (found)
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008250 return idx;
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008251
8252 if (called_emsg != called_emsg_start)
8253 return -1;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008254 }
8255
8256 return -1;
8257}
8258
8259/*
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008260 * "indexof()" function
8261 */
8262 static void
8263f_indexof(typval_T *argvars, typval_T *rettv)
8264{
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008265 long startidx = 0;
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008266 typval_T save_val;
8267 typval_T save_key;
8268 int save_did_emsg;
8269
8270 rettv->vval.v_number = -1;
8271
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008272 if (check_for_list_or_tuple_or_blob_arg(argvars, 0) == FAIL
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008273 || check_for_string_or_func_arg(argvars, 1) == FAIL
8274 || check_for_opt_dict_arg(argvars, 2) == FAIL)
8275 return;
8276
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008277 if ((argvars[1].v_type == VAR_STRING &&
8278 (argvars[1].vval.v_string == NULL
8279 || *argvars[1].vval.v_string == NUL))
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008280 || (argvars[1].v_type == VAR_FUNC
8281 && argvars[1].vval.v_partial == NULL))
8282 return;
8283
8284 if (argvars[2].v_type == VAR_DICT)
8285 startidx = dict_get_number_def(argvars[2].vval.v_dict, "startidx", 0);
8286
8287 prepare_vimvar(VV_VAL, &save_val);
8288 prepare_vimvar(VV_KEY, &save_key);
8289
8290 // We reset "did_emsg" to be able to detect whether an error occurred
8291 // during evaluation of the expression.
8292 save_did_emsg = did_emsg;
8293 did_emsg = FALSE;
8294
8295 if (argvars[0].v_type == VAR_BLOB)
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008296 rettv->vval.v_number = indexof_blob(argvars[0].vval.v_blob, startidx,
8297 &argvars[1]);
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008298 else if (argvars[0].v_type == VAR_TUPLE)
8299 rettv->vval.v_number = indexof_tuple(argvars[0].vval.v_tuple, startidx,
8300 &argvars[1]);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008301 else
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008302 rettv->vval.v_number = indexof_list(argvars[0].vval.v_list, startidx,
8303 &argvars[1]);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008304
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008305 restore_vimvar(VV_KEY, &save_key);
8306 restore_vimvar(VV_VAL, &save_val);
8307 did_emsg |= save_did_emsg;
8308}
8309
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008310static int inputsecret_flag = 0;
8311
8312/*
8313 * "input()" function
8314 * Also handles inputsecret() when inputsecret is set.
8315 */
8316 static void
8317f_input(typval_T *argvars, typval_T *rettv)
8318{
8319 get_user_input(argvars, rettv, FALSE, inputsecret_flag);
8320}
8321
8322/*
8323 * "inputdialog()" function
8324 */
8325 static void
8326f_inputdialog(typval_T *argvars, typval_T *rettv)
8327{
8328#if defined(FEAT_GUI_TEXTDIALOG)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008329 // Use a GUI dialog if the GUI is running and 'c' is not in 'guioptions'
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008330 if (gui.in_use && vim_strchr(p_go, GO_CONDIALOG) == NULL)
8331 {
8332 char_u *message;
8333 char_u buf[NUMBUFLEN];
8334 char_u *defstr = (char_u *)"";
8335
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008336 if (in_vim9script()
8337 && (check_for_string_arg(argvars, 0) == FAIL
8338 || check_for_opt_string_arg(argvars, 1) == FAIL
8339 || (argvars[1].v_type != VAR_UNKNOWN
8340 && check_for_opt_string_arg(argvars, 2) == FAIL)))
8341 return;
8342
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008343 message = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008344 if (argvars[1].v_type != VAR_UNKNOWN
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008345 && (defstr = tv_get_string_buf_chk(&argvars[1], buf)) != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008346 vim_strncpy(IObuff, defstr, IOSIZE - 1);
8347 else
8348 IObuff[0] = NUL;
8349 if (message != NULL && defstr != NULL
8350 && do_dialog(VIM_QUESTION, NULL, message,
8351 (char_u *)_("&OK\n&Cancel"), 1, IObuff, FALSE) == 1)
8352 rettv->vval.v_string = vim_strsave(IObuff);
8353 else
8354 {
8355 if (message != NULL && defstr != NULL
8356 && argvars[1].v_type != VAR_UNKNOWN
8357 && argvars[2].v_type != VAR_UNKNOWN)
8358 rettv->vval.v_string = vim_strsave(
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008359 tv_get_string_buf(&argvars[2], buf));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008360 else
8361 rettv->vval.v_string = NULL;
8362 }
8363 rettv->v_type = VAR_STRING;
8364 }
8365 else
8366#endif
8367 get_user_input(argvars, rettv, TRUE, inputsecret_flag);
8368}
8369
8370/*
8371 * "inputlist()" function
8372 */
8373 static void
8374f_inputlist(typval_T *argvars, typval_T *rettv)
8375{
Bram Moolenaar50985eb2020-01-27 22:09:39 +01008376 list_T *l;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008377 listitem_T *li;
8378 int selected;
8379 int mouse_used;
8380
8381#ifdef NO_CONSOLE_INPUT
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008382 // While starting up, there is no place to enter text. When running tests
8383 // with --not-a-term we assume feedkeys() will be used.
Bram Moolenaar91d348a2017-07-29 20:16:03 +02008384 if (no_console_input() && !is_not_a_term())
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008385 return;
8386#endif
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008387 if (in_vim9script() && check_for_list_arg(argvars, 0) == FAIL)
8388 return;
8389
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008390 if (argvars[0].v_type != VAR_LIST || argvars[0].vval.v_list == NULL)
8391 {
Bram Moolenaar3a846e62022-01-01 16:21:00 +00008392 semsg(_(e_argument_of_str_must_be_list), "inputlist()");
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008393 return;
8394 }
8395
8396 msg_start();
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008397 msg_row = Rows - 1; // for when 'cmdheight' > 1
8398 lines_left = Rows; // avoid more prompt
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008399 msg_scroll = TRUE;
8400 msg_clr_eos();
8401
Bram Moolenaar50985eb2020-01-27 22:09:39 +01008402 l = argvars[0].vval.v_list;
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02008403 CHECK_LIST_MATERIALIZE(l);
Bram Moolenaar00d253e2020-04-06 22:13:01 +02008404 FOR_ALL_LIST_ITEMS(l, li)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008405 {
Bram Moolenaar32526b32019-01-19 17:43:09 +01008406 msg_puts((char *)tv_get_string(&li->li_tv));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008407 msg_putchar('\n');
8408 }
8409
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008410 // Ask for choice.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008411 selected = prompt_for_number(&mouse_used);
8412 if (mouse_used)
8413 selected -= lines_left;
8414
8415 rettv->vval.v_number = selected;
8416}
8417
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008418static garray_T ga_userinput = {0, 0, sizeof(tasave_T), 4, NULL};
8419
8420/*
8421 * "inputrestore()" function
8422 */
8423 static void
8424f_inputrestore(typval_T *argvars UNUSED, typval_T *rettv)
8425{
8426 if (ga_userinput.ga_len > 0)
8427 {
8428 --ga_userinput.ga_len;
8429 restore_typeahead((tasave_T *)(ga_userinput.ga_data)
Bram Moolenaarc41badb2021-06-07 22:04:52 +02008430 + ga_userinput.ga_len, TRUE);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008431 // default return is zero == OK
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008432 }
8433 else if (p_verbose > 1)
8434 {
Bram Moolenaar32526b32019-01-19 17:43:09 +01008435 verb_msg(_("called inputrestore() more often than inputsave()"));
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008436 rettv->vval.v_number = 1; // Failed
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008437 }
8438}
8439
8440/*
8441 * "inputsave()" function
8442 */
8443 static void
8444f_inputsave(typval_T *argvars UNUSED, typval_T *rettv)
8445{
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008446 // Add an entry to the stack of typeahead storage.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008447 if (ga_grow(&ga_userinput, 1) == OK)
8448 {
8449 save_typeahead((tasave_T *)(ga_userinput.ga_data)
8450 + ga_userinput.ga_len);
8451 ++ga_userinput.ga_len;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008452 // default return is zero == OK
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008453 }
8454 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008455 rettv->vval.v_number = 1; // Failed
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008456}
8457
8458/*
8459 * "inputsecret()" function
8460 */
8461 static void
8462f_inputsecret(typval_T *argvars, typval_T *rettv)
8463{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008464 if (in_vim9script()
8465 && (check_for_string_arg(argvars, 0) == FAIL
8466 || check_for_opt_string_arg(argvars, 1) == FAIL))
8467 return;
8468
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008469 ++cmdline_star;
8470 ++inputsecret_flag;
8471 f_input(argvars, rettv);
8472 --cmdline_star;
8473 --inputsecret_flag;
8474}
8475
8476/*
Bram Moolenaar67a2deb2019-11-25 00:05:32 +01008477 * "interrupt()" function
8478 */
8479 static void
8480f_interrupt(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
8481{
8482 got_int = TRUE;
8483}
8484
8485/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008486 * "invert(expr)" function
8487 */
8488 static void
8489f_invert(typval_T *argvars, typval_T *rettv)
8490{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008491 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
8492 return;
8493
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008494 rettv->vval.v_number = ~tv_get_number_chk(&argvars[0], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008495}
8496
8497/*
Ernie Rael4c8da022023-10-11 21:35:11 +02008498 * Free resources in lval_root allocated by fill_exec_lval_root().
8499 */
8500 static void
8501free_lval_root(lval_root_T *root)
8502{
8503 if (root->lr_tv != NULL)
8504 free_tv(root->lr_tv);
8505 class_unref(root->lr_cl_exec);
8506 root->lr_tv = NULL;
8507 root->lr_cl_exec = NULL;
8508}
8509
8510/*
8511 * This is used if executing in a method, the argument string is a
Ernie Rael0f058d12023-10-14 11:25:04 +02008512 * variable/item expr/reference. It may start with a potential class/object
8513 * variable.
Ernie Rael4c8da022023-10-11 21:35:11 +02008514 *
Ernie Rael0f058d12023-10-14 11:25:04 +02008515 * Adjust "root" as needed; lr_tv may be changed or freed.
Ernie Rael4c8da022023-10-11 21:35:11 +02008516 *
8517 * Always returns OK.
8518 * Free resources and return FAIL if the root should not be used. Otherwise OK.
8519 */
8520
8521 static int
Ernie Rael0f058d12023-10-14 11:25:04 +02008522fix_variable_reference_lval_root(lval_root_T *root, char_u *name)
Ernie Rael4c8da022023-10-11 21:35:11 +02008523{
Ernie Rael4c8da022023-10-11 21:35:11 +02008524
Ernie Rael0f058d12023-10-14 11:25:04 +02008525 // Check if lr_tv is the name of an object/class reference: name start with
8526 // "this" or name is class variable. Clear lr_tv if neither.
8527 int found_member = FALSE;
Ernie Rael4c8da022023-10-11 21:35:11 +02008528 if (root->lr_tv->v_type == VAR_OBJECT)
8529 {
Ernie Rael0f058d12023-10-14 11:25:04 +02008530 if (STRNCMP("this.", name, 5) == 0 ||STRCMP("this", name) == 0)
8531 found_member = TRUE;
Ernie Rael4c8da022023-10-11 21:35:11 +02008532 }
Ernie Rael0f058d12023-10-14 11:25:04 +02008533 if (!found_member) // not object member, try class member
Ernie Rael4c8da022023-10-11 21:35:11 +02008534 {
8535 // Explicitly check if the name is a class member.
8536 // If it's not then do nothing.
Ernie Rael0f058d12023-10-14 11:25:04 +02008537 char_u *end;
Ernie Rael4c8da022023-10-11 21:35:11 +02008538 for (end = name; ASCII_ISALNUM(*end) || *end == '_'; ++end)
8539 ;
Ernie Rael0f058d12023-10-14 11:25:04 +02008540 int idx = class_member_idx(root->lr_cl_exec, name, end - name);
8541 if (idx >= 0)
Ernie Rael4c8da022023-10-11 21:35:11 +02008542 {
Ernie Rael0f058d12023-10-14 11:25:04 +02008543 // A class variable, replace lr_tv with it
8544 clear_tv(root->lr_tv);
8545 copy_tv(&root->lr_cl_exec->class_members_tv[idx], root->lr_tv);
8546 found_member = TRUE;
Ernie Rael4c8da022023-10-11 21:35:11 +02008547 }
8548 }
Ernie Rael0f058d12023-10-14 11:25:04 +02008549 if (!found_member)
Ernie Rael4c8da022023-10-11 21:35:11 +02008550 {
8551 free_tv(root->lr_tv);
8552 root->lr_tv = NULL; // Not a member variable
8553 }
Ernie Rael4c8da022023-10-11 21:35:11 +02008554 // If FAIL, then must free_lval_root(root);
8555 return OK;
8556}
8557
8558/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008559 * "islocked()" function
8560 */
8561 static void
8562f_islocked(typval_T *argvars, typval_T *rettv)
8563{
8564 lval_T lv;
8565 char_u *end;
8566 dictitem_T *di;
8567
8568 rettv->vval.v_number = -1;
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02008569
8570 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
8571 return;
8572
Ernie Rael4c8da022023-10-11 21:35:11 +02008573 char_u *name = tv_get_string(&argvars[0]);
8574#ifdef LOG_LOCKVAR
8575 ch_log(NULL, "LKVAR: f_islocked(): name: %s", name);
8576#endif
8577
8578 lval_root_T aroot; // fully initialized in fill_exec_lval_root
8579 lval_root_T *root = NULL;
8580
8581 // Set up lval_root if executing in a method.
8582 if (fill_exec_lval_root(&aroot) == OK)
8583 {
8584 // Almost always produces a valid lval_root since lr_cl_exec is used
8585 // for access verification, lr_tv may be set to NULL.
Ernie Rael0f058d12023-10-14 11:25:04 +02008586 if (fix_variable_reference_lval_root(&aroot, name) == OK)
Ernie Rael4c8da022023-10-11 21:35:11 +02008587 root = &aroot;
Ernie Rael4c8da022023-10-11 21:35:11 +02008588 }
8589
8590 lval_root_T *lval_root_save = lval_root;
8591 lval_root = root;
8592 end = get_lval(name, NULL, &lv, FALSE, FALSE,
Bram Moolenaarbd77aa92021-08-12 17:06:05 +02008593 GLV_NO_AUTOLOAD | GLV_READ_ONLY | GLV_NO_DECL,
8594 FNE_CHECK_START);
Ernie Rael4c8da022023-10-11 21:35:11 +02008595 lval_root = lval_root_save;
8596
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008597 if (end != NULL && lv.ll_name != NULL)
8598 {
8599 if (*end != NUL)
Bram Moolenaar1840a7b2021-07-13 20:32:29 +02008600 {
8601 semsg(_(lv.ll_name == lv.ll_name_end
Bram Moolenaar0bd663a2022-01-22 10:24:47 +00008602 ? e_invalid_argument_str : e_trailing_characters_str), end);
Bram Moolenaar1840a7b2021-07-13 20:32:29 +02008603 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008604 else
8605 {
8606 if (lv.ll_tv == NULL)
8607 {
Bram Moolenaar79518e22017-02-17 16:31:35 +01008608 di = find_var(lv.ll_name, NULL, TRUE);
8609 if (di != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008610 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008611 // Consider a variable locked when:
8612 // 1. the variable itself is locked
8613 // 2. the value of the variable is locked.
8614 // 3. the List or Dict value is locked.
Bram Moolenaar79518e22017-02-17 16:31:35 +01008615 rettv->vval.v_number = ((di->di_flags & DI_FLAGS_LOCK)
8616 || tv_islocked(&di->di_tv));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008617 }
8618 }
Ernie Rael4c8da022023-10-11 21:35:11 +02008619 else if (lv.ll_is_root)
8620 {
8621 rettv->vval.v_number = tv_islocked(lv.ll_tv);
8622 }
Ernie Rael9771b2a2023-10-07 22:05:40 +02008623 else if (lv.ll_object != NULL)
8624 {
8625 typval_T *tv = ((typval_T *)(lv.ll_object + 1)) + lv.ll_oi;
8626 rettv->vval.v_number = tv_islocked(tv);
8627#ifdef LOG_LOCKVAR
8628 ch_log(NULL, "LKVAR: f_islocked(): name %s (obj)", lv.ll_name);
8629#endif
8630 }
8631 else if (lv.ll_class != NULL)
8632 {
8633 typval_T *tv = &lv.ll_class->class_members_tv[lv.ll_oi];
8634 rettv->vval.v_number = tv_islocked(tv);
8635#ifdef LOG_LOCKVAR
8636 ch_log(NULL, "LKVAR: f_islocked(): name %s (cl)", lv.ll_name);
8637#endif
8638 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008639 else if (lv.ll_range)
Bram Moolenaar677658a2022-01-05 16:09:06 +00008640 emsg(_(e_range_not_allowed));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008641 else if (lv.ll_newkey != NULL)
Bram Moolenaara9fa8c52023-01-02 18:10:04 +00008642 semsg(_(e_key_not_present_in_dictionary_str), lv.ll_newkey);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008643 else if (lv.ll_list != NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008644 // List item.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008645 rettv->vval.v_number = tv_islocked(&lv.ll_li->li_tv);
Yegappan Lakshmanan038be272025-03-26 18:46:21 +01008646 else if (lv.ll_tuple != NULL)
8647 // Tuple item.
8648 rettv->vval.v_number = tv_islocked(lv.ll_tv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008649 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008650 // Dictionary item.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008651 rettv->vval.v_number = tv_islocked(&lv.ll_di->di_tv);
8652 }
8653 }
8654
Ernie Rael4c8da022023-10-11 21:35:11 +02008655 if (root != NULL)
8656 free_lval_root(root);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008657 clear_lval(&lv);
8658}
8659
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008660/*
zeertzjqcdc83932022-09-12 13:38:41 +01008661 * "keytrans()" function
8662 */
8663 static void
8664f_keytrans(typval_T *argvars, typval_T *rettv)
8665{
8666 char_u *escaped;
8667
8668 rettv->v_type = VAR_STRING;
8669 if (check_for_string_arg(argvars, 0) == FAIL
8670 || argvars[0].vval.v_string == NULL)
8671 return;
8672 // Need to escape K_SPECIAL and CSI for mb_unescape().
8673 escaped = vim_strsave_escape_csi(argvars[0].vval.v_string);
8674 rettv->vval.v_string = str2special_save(escaped, TRUE, TRUE);
8675 vim_free(escaped);
8676}
8677
8678/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008679 * "last_buffer_nr()" function.
8680 */
8681 static void
8682f_last_buffer_nr(typval_T *argvars UNUSED, typval_T *rettv)
8683{
8684 int n = 0;
8685 buf_T *buf;
8686
Bram Moolenaar29323592016-07-24 22:04:11 +02008687 FOR_ALL_BUFFERS(buf)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008688 if (n < buf->b_fnum)
8689 n = buf->b_fnum;
8690
8691 rettv->vval.v_number = n;
8692}
8693
8694/*
8695 * "len()" function
8696 */
LemonBoy58f331a2022-04-02 21:59:06 +01008697 void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008698f_len(typval_T *argvars, typval_T *rettv)
8699{
8700 switch (argvars[0].v_type)
8701 {
8702 case VAR_STRING:
8703 case VAR_NUMBER:
8704 rettv->vval.v_number = (varnumber_T)STRLEN(
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008705 tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008706 break;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008707 case VAR_BLOB:
8708 rettv->vval.v_number = blob_len(argvars[0].vval.v_blob);
8709 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008710 case VAR_LIST:
8711 rettv->vval.v_number = list_len(argvars[0].vval.v_list);
8712 break;
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01008713 case VAR_TUPLE:
8714 rettv->vval.v_number = tuple_len(argvars[0].vval.v_tuple);
8715 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008716 case VAR_DICT:
8717 rettv->vval.v_number = dict_len(argvars[0].vval.v_dict);
8718 break;
Yegappan Lakshmanand3eae7b2024-03-03 16:26:58 +01008719 case VAR_OBJECT:
8720 rettv->vval.v_number = object_len(argvars[0].vval.v_object);
8721 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008722 case VAR_UNKNOWN:
Bram Moolenaar4c683752020-04-05 21:38:23 +02008723 case VAR_ANY:
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01008724 case VAR_VOID:
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01008725 case VAR_BOOL:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008726 case VAR_SPECIAL:
8727 case VAR_FLOAT:
8728 case VAR_FUNC:
8729 case VAR_PARTIAL:
8730 case VAR_JOB:
8731 case VAR_CHANNEL:
Bram Moolenaarf18332f2021-05-07 17:55:55 +02008732 case VAR_INSTR:
Bram Moolenaar00b28d62022-12-08 15:32:33 +00008733 case VAR_CLASS:
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +02008734 case VAR_TYPEALIAS:
Bram Moolenaara6f79292022-01-04 21:30:47 +00008735 emsg(_(e_invalid_type_for_len));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008736 break;
8737 }
8738}
8739
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008740 static void
Bram Moolenaar6d721c72017-01-17 16:56:28 +01008741libcall_common(typval_T *argvars UNUSED, typval_T *rettv, int type)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008742{
8743#ifdef FEAT_LIBCALL
8744 char_u *string_in;
8745 char_u **string_result;
8746 int nr_result;
8747#endif
8748
8749 rettv->v_type = type;
8750 if (type != VAR_NUMBER)
8751 rettv->vval.v_string = NULL;
8752
8753 if (check_restricted() || check_secure())
8754 return;
8755
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02008756 if (in_vim9script()
8757 && (check_for_string_arg(argvars, 0) == FAIL
8758 || check_for_string_arg(argvars, 1) == FAIL
8759 || check_for_string_or_number_arg(argvars, 2) == FAIL))
8760 return;
8761
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008762#ifdef FEAT_LIBCALL
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008763 // The first two args must be strings, otherwise it's meaningless
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008764 if (argvars[0].v_type == VAR_STRING && argvars[1].v_type == VAR_STRING)
8765 {
8766 string_in = NULL;
8767 if (argvars[2].v_type == VAR_STRING)
8768 string_in = argvars[2].vval.v_string;
8769 if (type == VAR_NUMBER)
Bram Moolenaar87e15872021-09-02 19:53:07 +02008770 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008771 string_result = NULL;
Bram Moolenaar87e15872021-09-02 19:53:07 +02008772 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008773 else
Bram Moolenaar87e15872021-09-02 19:53:07 +02008774 {
8775 rettv->vval.v_string = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008776 string_result = &rettv->vval.v_string;
Bram Moolenaar87e15872021-09-02 19:53:07 +02008777 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008778 if (mch_libcall(argvars[0].vval.v_string,
8779 argvars[1].vval.v_string,
8780 string_in,
8781 argvars[2].vval.v_number,
8782 string_result,
8783 &nr_result) == OK
8784 && type == VAR_NUMBER)
8785 rettv->vval.v_number = nr_result;
8786 }
8787#endif
8788}
8789
8790/*
8791 * "libcall()" function
8792 */
8793 static void
8794f_libcall(typval_T *argvars, typval_T *rettv)
8795{
8796 libcall_common(argvars, rettv, VAR_STRING);
8797}
8798
8799/*
8800 * "libcallnr()" function
8801 */
8802 static void
8803f_libcallnr(typval_T *argvars, typval_T *rettv)
8804{
8805 libcall_common(argvars, rettv, VAR_NUMBER);
8806}
8807
8808/*
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008809 * "line(string, [winid])" function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008810 */
8811 static void
8812f_line(typval_T *argvars, typval_T *rettv)
8813{
8814 linenr_T lnum = 0;
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008815 pos_T *fp = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008816 int fnum;
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008817 int id;
8818 tabpage_T *tp;
8819 win_T *wp;
Bram Moolenaar18f47402022-01-06 13:24:51 +00008820 switchwin_T switchwin;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008821
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02008822 if (in_vim9script()
8823 && (check_for_string_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008824 || check_for_opt_number_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02008825 return;
8826
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008827 if (argvars[1].v_type != VAR_UNKNOWN)
8828 {
8829 // use window specified in the second argument
8830 id = (int)tv_get_number(&argvars[1]);
8831 wp = win_id2wp_tp(id, &tp);
8832 if (wp != NULL && tp != NULL)
8833 {
Bram Moolenaar18f47402022-01-06 13:24:51 +00008834 if (switch_win_noblock(&switchwin, wp, tp, TRUE) == OK)
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008835 {
John Marriott69f85c62024-10-31 10:53:43 +01008836#ifdef FEAT_DIFF
Christian Brabandt05a40e02024-10-29 20:29:04 +01008837 // in diff mode, prevent that the window scrolls
8838 // and keep the topline
8839 if (curwin->w_p_diff && switchwin.sw_curwin->w_p_diff)
8840 skip_update_topline = TRUE;
John Marriott69f85c62024-10-31 10:53:43 +01008841#endif
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008842 check_cursor();
Bram Moolenaar6f02b002021-01-10 20:22:54 +01008843 fp = var2fpos(&argvars[0], TRUE, &fnum, FALSE);
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008844 }
John Marriott69f85c62024-10-31 10:53:43 +01008845#ifdef FEAT_DIFF
Christian Brabandt05a40e02024-10-29 20:29:04 +01008846 if (curwin->w_p_diff && switchwin.sw_curwin->w_p_diff)
8847 skip_update_topline = FALSE;
John Marriott69f85c62024-10-31 10:53:43 +01008848#endif
Bram Moolenaar18f47402022-01-06 13:24:51 +00008849 restore_win_noblock(&switchwin, TRUE);
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008850 }
8851 }
8852 else
8853 // use current window
Bram Moolenaar6f02b002021-01-10 20:22:54 +01008854 fp = var2fpos(&argvars[0], TRUE, &fnum, FALSE);
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008855
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008856 if (fp != NULL)
8857 lnum = fp->lnum;
8858 rettv->vval.v_number = lnum;
8859}
8860
8861/*
8862 * "line2byte(lnum)" function
8863 */
8864 static void
8865f_line2byte(typval_T *argvars UNUSED, typval_T *rettv)
8866{
8867#ifndef FEAT_BYTEOFF
8868 rettv->vval.v_number = -1;
8869#else
8870 linenr_T lnum;
8871
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008872 if (in_vim9script() && check_for_lnum_arg(argvars, 0) == FAIL)
8873 return;
8874
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008875 lnum = tv_get_lnum(argvars);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008876 if (lnum < 1 || lnum > curbuf->b_ml.ml_line_count + 1)
8877 rettv->vval.v_number = -1;
8878 else
8879 rettv->vval.v_number = ml_find_line_or_offset(curbuf, lnum, NULL);
8880 if (rettv->vval.v_number >= 0)
8881 ++rettv->vval.v_number;
8882#endif
8883}
8884
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008885#ifdef FEAT_LUA
8886/*
8887 * "luaeval()" function
8888 */
8889 static void
8890f_luaeval(typval_T *argvars, typval_T *rettv)
8891{
8892 char_u *str;
8893 char_u buf[NUMBUFLEN];
8894
Bram Moolenaar8c62a082019-02-08 14:34:10 +01008895 if (check_restricted() || check_secure())
8896 return;
8897
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02008898 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
8899 return;
8900
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008901 str = tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008902 do_luaeval(str, argvars + 1, rettv);
8903}
8904#endif
8905
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008906typedef enum
8907{
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008908 MATCH_END, // matchend()
8909 MATCH_MATCH, // match()
8910 MATCH_STR, // matchstr()
8911 MATCH_LIST, // matchlist()
8912 MATCH_POS // matchstrpos()
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008913} matchtype_T;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008914
8915 static void
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008916find_some_match(typval_T *argvars, typval_T *rettv, matchtype_T type)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008917{
8918 char_u *str = NULL;
8919 long len = 0;
8920 char_u *expr = NULL;
8921 char_u *pat;
8922 regmatch_T regmatch;
8923 char_u patbuf[NUMBUFLEN];
8924 char_u strbuf[NUMBUFLEN];
8925 char_u *save_cpo;
8926 long start = 0;
8927 long nth = 1;
8928 colnr_T startcol = 0;
8929 int match = 0;
8930 list_T *l = NULL;
8931 listitem_T *li = NULL;
8932 long idx = 0;
8933 char_u *tofree = NULL;
8934
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008935 // Make 'cpoptions' empty, the 'l' flag should not be used here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008936 save_cpo = p_cpo;
Bram Moolenaare5a2dc82021-01-03 19:52:05 +01008937 p_cpo = empty_option;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008938
8939 rettv->vval.v_number = -1;
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008940 if (type == MATCH_LIST || type == MATCH_POS)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008941 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008942 // type MATCH_LIST: return empty list when there are no matches.
8943 // type MATCH_POS: return ["", -1, -1, -1]
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008944 if (rettv_list_alloc(rettv) == FAIL)
8945 goto theend;
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008946 if (type == MATCH_POS
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008947 && (list_append_string(rettv->vval.v_list,
8948 (char_u *)"", 0) == FAIL
8949 || list_append_number(rettv->vval.v_list,
8950 (varnumber_T)-1) == FAIL
8951 || list_append_number(rettv->vval.v_list,
8952 (varnumber_T)-1) == FAIL
8953 || list_append_number(rettv->vval.v_list,
8954 (varnumber_T)-1) == FAIL))
8955 {
8956 list_free(rettv->vval.v_list);
8957 rettv->vval.v_list = NULL;
8958 goto theend;
8959 }
8960 }
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008961 else if (type == MATCH_STR)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008962 {
8963 rettv->v_type = VAR_STRING;
8964 rettv->vval.v_string = NULL;
8965 }
8966
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02008967 if (in_vim9script()
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008968 && (check_for_string_or_list_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008969 || check_for_string_arg(argvars, 1) == FAIL
8970 || check_for_opt_number_arg(argvars, 2) == FAIL
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02008971 || (argvars[2].v_type != VAR_UNKNOWN
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008972 && check_for_opt_number_arg(argvars, 3) == FAIL)))
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02008973 goto theend;
8974
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008975 if (argvars[0].v_type == VAR_LIST)
8976 {
8977 if ((l = argvars[0].vval.v_list) == NULL)
8978 goto theend;
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02008979 CHECK_LIST_MATERIALIZE(l);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008980 li = l->lv_first;
8981 }
8982 else
8983 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008984 expr = str = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008985 len = (long)STRLEN(str);
8986 }
8987
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008988 pat = tv_get_string_buf_chk(&argvars[1], patbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008989 if (pat == NULL)
8990 goto theend;
8991
8992 if (argvars[2].v_type != VAR_UNKNOWN)
8993 {
8994 int error = FALSE;
8995
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008996 start = (long)tv_get_number_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008997 if (error)
8998 goto theend;
8999 if (l != NULL)
9000 {
9001 li = list_find(l, start);
9002 if (li == NULL)
9003 goto theend;
Bram Moolenaar0ff6aad2020-01-29 21:27:21 +01009004 idx = l->lv_u.mat.lv_idx; // use the cached index
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009005 }
9006 else
9007 {
9008 if (start < 0)
9009 start = 0;
9010 if (start > len)
9011 goto theend;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009012 // When "count" argument is there ignore matches before "start",
9013 // otherwise skip part of the string. Differs when pattern is "^"
9014 // or "\<".
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009015 if (argvars[3].v_type != VAR_UNKNOWN)
9016 startcol = start;
9017 else
9018 {
9019 str += start;
9020 len -= start;
9021 }
9022 }
9023
9024 if (argvars[3].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009025 nth = (long)tv_get_number_chk(&argvars[3], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009026 if (error)
9027 goto theend;
9028 }
9029
9030 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
9031 if (regmatch.regprog != NULL)
9032 {
9033 regmatch.rm_ic = p_ic;
9034
9035 for (;;)
9036 {
9037 if (l != NULL)
9038 {
9039 if (li == NULL)
9040 {
9041 match = FALSE;
9042 break;
9043 }
9044 vim_free(tofree);
9045 expr = str = echo_string(&li->li_tv, &tofree, strbuf, 0);
9046 if (str == NULL)
9047 break;
9048 }
9049
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +00009050 match = vim_regexec_nl(&regmatch, str, startcol);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009051
9052 if (match && --nth <= 0)
9053 break;
9054 if (l == NULL && !match)
9055 break;
9056
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009057 // Advance to just after the match.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009058 if (l != NULL)
9059 {
9060 li = li->li_next;
9061 ++idx;
9062 }
9063 else
9064 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009065 startcol = (colnr_T)(regmatch.startp[0]
9066 + (*mb_ptr2len)(regmatch.startp[0]) - str);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009067 if (startcol > (colnr_T)len
9068 || str + startcol <= regmatch.startp[0])
9069 {
9070 match = FALSE;
9071 break;
9072 }
9073 }
9074 }
9075
9076 if (match)
9077 {
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009078 if (type == MATCH_POS)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009079 {
9080 listitem_T *li1 = rettv->vval.v_list->lv_first;
9081 listitem_T *li2 = li1->li_next;
9082 listitem_T *li3 = li2->li_next;
9083 listitem_T *li4 = li3->li_next;
9084
9085 vim_free(li1->li_tv.vval.v_string);
9086 li1->li_tv.vval.v_string = vim_strnsave(regmatch.startp[0],
Bram Moolenaardf44a272020-06-07 20:49:05 +02009087 regmatch.endp[0] - regmatch.startp[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009088 li3->li_tv.vval.v_number =
9089 (varnumber_T)(regmatch.startp[0] - expr);
9090 li4->li_tv.vval.v_number =
9091 (varnumber_T)(regmatch.endp[0] - expr);
9092 if (l != NULL)
9093 li2->li_tv.vval.v_number = (varnumber_T)idx;
9094 }
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009095 else if (type == MATCH_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009096 {
9097 int i;
9098
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009099 // return list with matched string and submatches
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009100 for (i = 0; i < NSUBEXP; ++i)
9101 {
9102 if (regmatch.endp[i] == NULL)
9103 {
9104 if (list_append_string(rettv->vval.v_list,
9105 (char_u *)"", 0) == FAIL)
9106 break;
9107 }
9108 else if (list_append_string(rettv->vval.v_list,
9109 regmatch.startp[i],
9110 (int)(regmatch.endp[i] - regmatch.startp[i]))
9111 == FAIL)
9112 break;
9113 }
9114 }
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009115 else if (type == MATCH_STR)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009116 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009117 // return matched string
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009118 if (l != NULL)
9119 copy_tv(&li->li_tv, rettv);
9120 else
9121 rettv->vval.v_string = vim_strnsave(regmatch.startp[0],
Bram Moolenaardf44a272020-06-07 20:49:05 +02009122 regmatch.endp[0] - regmatch.startp[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009123 }
9124 else if (l != NULL)
9125 rettv->vval.v_number = idx;
9126 else
9127 {
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009128 if (type != MATCH_END)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009129 rettv->vval.v_number =
9130 (varnumber_T)(regmatch.startp[0] - str);
9131 else
9132 rettv->vval.v_number =
9133 (varnumber_T)(regmatch.endp[0] - str);
9134 rettv->vval.v_number += (varnumber_T)(str - expr);
9135 }
9136 }
9137 vim_regfree(regmatch.regprog);
9138 }
9139
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009140theend:
9141 if (type == MATCH_POS && l == NULL && rettv->vval.v_list != NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009142 // matchstrpos() without a list: drop the second item.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009143 listitem_remove(rettv->vval.v_list,
9144 rettv->vval.v_list->lv_first->li_next);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009145 vim_free(tofree);
9146 p_cpo = save_cpo;
9147}
9148
9149/*
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01009150 * Return all the matches in string "str" for pattern "rmp".
9151 * The matches are returned in the List "mlist".
9152 * If "submatches" is TRUE, then submatch information is also returned.
9153 * "matchbuf" is TRUE when called for matchbufline().
9154 */
9155 static int
9156get_matches_in_str(
9157 char_u *str,
9158 regmatch_T *rmp,
9159 list_T *mlist,
9160 int idx,
9161 int submatches,
9162 int matchbuf)
9163{
9164 long len = (long)STRLEN(str);
9165 int match = 0;
9166 colnr_T startidx = 0;
9167
9168 for (;;)
9169 {
9170 match = vim_regexec_nl(rmp, str, startidx);
9171 if (!match)
9172 break;
9173
9174 dict_T *d = dict_alloc();
9175 if (d == NULL)
9176 return FAIL;
9177 if (list_append_dict(mlist, d) == FAIL)
Satoru Kitaguchiba737662025-04-06 16:04:59 +02009178 return FAIL;
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01009179
9180 if (dict_add_number(d, matchbuf ? "lnum" : "idx", idx) == FAIL)
9181 return FAIL;
9182
9183 if (dict_add_number(d, "byteidx",
9184 (colnr_T)(rmp->startp[0] - str)) == FAIL)
9185 return FAIL;
9186
9187 if (dict_add_string_len(d, "text", rmp->startp[0],
9188 (int)(rmp->endp[0] - rmp->startp[0])) == FAIL)
9189 return FAIL;
9190
9191 if (submatches)
9192 {
9193 list_T *sml = list_alloc();
9194 if (sml == NULL)
9195 return FAIL;
9196
9197 if (dict_add_list(d, "submatches", sml) == FAIL)
9198 return FAIL;
9199
9200 // return a list with the submatches
9201 for (int i = 1; i < NSUBEXP; ++i)
9202 {
9203 if (rmp->endp[i] == NULL)
9204 {
9205 if (list_append_string(sml, (char_u *)"", 0) == FAIL)
9206 return FAIL;
9207 }
9208 else if (list_append_string(sml, rmp->startp[i],
9209 (int)(rmp->endp[i] - rmp->startp[i])) == FAIL)
9210 return FAIL;
9211 }
9212 }
9213 startidx = (colnr_T)(rmp->endp[0] - str);
9214 if (startidx >= (colnr_T)len || str + startidx <= rmp->startp[0])
9215 break;
9216 }
9217
9218 return OK;
9219}
9220
9221/*
9222 * "matchbufline()" function
9223 */
9224 static void
9225f_matchbufline(typval_T *argvars, typval_T *rettv)
9226{
9227 list_T *retlist = NULL;
9228 char_u *save_cpo;
9229 char_u patbuf[NUMBUFLEN];
9230 regmatch_T regmatch;
9231
9232 rettv->vval.v_number = -1;
9233 if (rettv_list_alloc(rettv) != OK)
9234 return;
9235 retlist = rettv->vval.v_list;
9236
9237 if (check_for_buffer_arg(argvars, 0) == FAIL
9238 || check_for_string_arg(argvars, 1) == FAIL
9239 || check_for_lnum_arg(argvars, 2) == FAIL
9240 || check_for_lnum_arg(argvars, 3) == FAIL
9241 || check_for_opt_dict_arg(argvars, 4) == FAIL)
9242 return;
9243
9244 int prev_did_emsg = did_emsg;
9245 buf_T *buf = tv_get_buf(&argvars[0], FALSE);
9246 if (buf == NULL)
9247 {
9248 if (did_emsg == prev_did_emsg)
9249 semsg(_(e_invalid_buffer_name_str), tv_get_string(&argvars[0]));
9250 return;
9251 }
9252 if (buf->b_ml.ml_mfp == NULL)
9253 {
9254 emsg(_(e_buffer_is_not_loaded));
9255 return;
9256 }
9257
9258 char_u *pat = tv_get_string_buf(&argvars[1], patbuf);
9259
9260 int did_emsg_before = did_emsg;
9261 linenr_T slnum = tv_get_lnum_buf(&argvars[2], buf);
9262 if (did_emsg > did_emsg_before)
9263 return;
9264 if (slnum < 1)
9265 {
9266 semsg(_(e_invalid_value_for_argument_str), "lnum");
9267 return;
9268 }
9269
9270 linenr_T elnum = tv_get_lnum_buf(&argvars[3], buf);
9271 if (did_emsg > did_emsg_before)
9272 return;
9273 if (elnum < 1 || elnum < slnum)
9274 {
9275 semsg(_(e_invalid_value_for_argument_str), "end_lnum");
9276 return;
9277 }
9278
9279 if (elnum > buf->b_ml.ml_line_count)
9280 elnum = buf->b_ml.ml_line_count;
9281
9282 int submatches = FALSE;
9283 if (argvars[4].v_type != VAR_UNKNOWN)
9284 {
9285 dict_T *d = argvars[4].vval.v_dict;
9286 if (d != NULL)
9287 {
9288 dictitem_T *di = dict_find(d, (char_u *)"submatches", -1);
9289 if (di != NULL)
9290 {
9291 if (di->di_tv.v_type != VAR_BOOL)
9292 {
9293 semsg(_(e_invalid_value_for_argument_str), "submatches");
9294 return;
9295 }
9296 submatches = tv_get_bool(&di->di_tv);
9297 }
9298 }
9299 }
9300
9301 // Make 'cpoptions' empty, the 'l' flag should not be used here.
9302 save_cpo = p_cpo;
9303 p_cpo = empty_option;
9304
9305 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
9306 if (regmatch.regprog == NULL)
9307 goto theend;
9308 regmatch.rm_ic = p_ic;
9309
9310 while (slnum <= elnum)
9311 {
9312 char_u *str = ml_get_buf(buf, slnum, FALSE);
9313 if (get_matches_in_str(str, &regmatch, retlist, slnum, submatches,
9314 TRUE) == FAIL)
9315 goto cleanup;
9316 slnum++;
9317 }
9318
9319cleanup:
9320 vim_regfree(regmatch.regprog);
9321
9322theend:
9323 p_cpo = save_cpo;
9324}
9325
9326/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009327 * "match()" function
9328 */
9329 static void
9330f_match(typval_T *argvars, typval_T *rettv)
9331{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009332 find_some_match(argvars, rettv, MATCH_MATCH);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009333}
9334
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009335/*
9336 * "matchend()" function
9337 */
9338 static void
9339f_matchend(typval_T *argvars, typval_T *rettv)
9340{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009341 find_some_match(argvars, rettv, MATCH_END);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009342}
9343
9344/*
9345 * "matchlist()" function
9346 */
9347 static void
9348f_matchlist(typval_T *argvars, typval_T *rettv)
9349{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009350 find_some_match(argvars, rettv, MATCH_LIST);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009351}
9352
9353/*
9354 * "matchstr()" function
9355 */
9356 static void
9357f_matchstr(typval_T *argvars, typval_T *rettv)
9358{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009359 find_some_match(argvars, rettv, MATCH_STR);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009360}
9361
9362/*
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01009363 * "matchstrlist()" function
9364 */
9365 static void
9366f_matchstrlist(typval_T *argvars, typval_T *rettv)
9367{
9368 list_T *retlist = NULL;
9369 char_u *save_cpo;
9370 list_T *l = NULL;
9371 listitem_T *li = NULL;
9372 char_u patbuf[NUMBUFLEN];
9373 regmatch_T regmatch;
9374
9375 rettv->vval.v_number = -1;
9376 if (rettv_list_alloc(rettv) != OK)
9377 return;
9378 retlist = rettv->vval.v_list;
9379
9380 if (check_for_list_arg(argvars, 0) == FAIL
9381 || check_for_string_arg(argvars, 1) == FAIL
9382 || check_for_opt_dict_arg(argvars, 2) == FAIL)
9383 return;
9384
9385 if ((l = argvars[0].vval.v_list) == NULL)
9386 return;
9387
9388 char_u *pat = tv_get_string_buf_chk(&argvars[1], patbuf);
9389 if (pat == NULL)
9390 return;
9391
9392 // Make 'cpoptions' empty, the 'l' flag should not be used here.
9393 save_cpo = p_cpo;
9394 p_cpo = empty_option;
9395
9396 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
9397 if (regmatch.regprog == NULL)
9398 goto theend;
9399 regmatch.rm_ic = p_ic;
9400
9401 int submatches = FALSE;
9402 if (argvars[2].v_type != VAR_UNKNOWN)
9403 {
9404 dict_T *d = argvars[2].vval.v_dict;
9405 if (d != NULL)
9406 {
9407 dictitem_T *di = dict_find(d, (char_u *)"submatches", -1);
9408 if (di != NULL)
9409 {
9410 if (di->di_tv.v_type != VAR_BOOL)
9411 {
9412 semsg(_(e_invalid_value_for_argument_str), "submatches");
9413 goto cleanup;
9414 }
9415 submatches = tv_get_bool(&di->di_tv);
9416 }
9417 }
9418 }
9419
9420 int idx = 0;
9421 CHECK_LIST_MATERIALIZE(l);
9422 FOR_ALL_LIST_ITEMS(l, li)
9423 {
9424 if (li->li_tv.v_type == VAR_STRING && li->li_tv.vval.v_string != NULL)
9425 {
9426 char_u *str = li->li_tv.vval.v_string;
9427 if (get_matches_in_str(str, &regmatch, retlist, idx, submatches,
9428 FALSE) == FAIL)
9429 goto cleanup;
9430 }
9431 idx++;
9432 }
9433
9434cleanup:
9435 vim_regfree(regmatch.regprog);
9436
9437theend:
9438 p_cpo = save_cpo;
9439}
9440
9441/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009442 * "matchstrpos()" function
9443 */
9444 static void
9445f_matchstrpos(typval_T *argvars, typval_T *rettv)
9446{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009447 find_some_match(argvars, rettv, MATCH_POS);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009448}
9449
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009450 static void
9451max_min(typval_T *argvars, typval_T *rettv, int domax)
9452{
9453 varnumber_T n = 0;
9454 varnumber_T i;
9455 int error = FALSE;
9456
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01009457 if (in_vim9script() &&
9458 check_for_list_or_tuple_or_dict_arg(argvars, 0) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009459 return;
9460
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009461 if (argvars[0].v_type == VAR_LIST)
9462 {
9463 list_T *l;
9464 listitem_T *li;
9465
9466 l = argvars[0].vval.v_list;
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009467 if (l != NULL && l->lv_len > 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009468 {
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009469 if (l->lv_first == &range_list_item)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009470 {
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009471 if ((l->lv_u.nonmat.lv_stride > 0) ^ domax)
9472 n = l->lv_u.nonmat.lv_start;
9473 else
=?UTF-8?q?Dundar=20G=C3=B6c?=d5cec1f2022-01-29 15:19:23 +00009474 n = l->lv_u.nonmat.lv_start + ((varnumber_T)l->lv_len - 1)
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009475 * l->lv_u.nonmat.lv_stride;
9476 }
9477 else
9478 {
9479 li = l->lv_first;
9480 if (li != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009481 {
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009482 n = tv_get_number_chk(&li->li_tv, &error);
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009483 if (error)
9484 return; // type error; errmsg already given
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009485 for (;;)
9486 {
9487 li = li->li_next;
9488 if (li == NULL)
9489 break;
9490 i = tv_get_number_chk(&li->li_tv, &error);
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009491 if (error)
9492 return; // type error; errmsg already given
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009493 if (domax ? i > n : i < n)
9494 n = i;
9495 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009496 }
9497 }
9498 }
9499 }
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +01009500 else if (argvars[0].v_type == VAR_TUPLE)
9501 {
9502 n = tuple_max_min(argvars[0].vval.v_tuple, domax, &error);
9503 if (error)
9504 return;
9505 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009506 else if (argvars[0].v_type == VAR_DICT)
9507 {
9508 dict_T *d;
9509 int first = TRUE;
9510 hashitem_T *hi;
9511 int todo;
9512
9513 d = argvars[0].vval.v_dict;
9514 if (d != NULL)
9515 {
9516 todo = (int)d->dv_hashtab.ht_used;
Yegappan Lakshmanan14113fd2023-03-07 17:13:51 +00009517 FOR_ALL_HASHTAB_ITEMS(&d->dv_hashtab, hi, todo)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009518 {
9519 if (!HASHITEM_EMPTY(hi))
9520 {
9521 --todo;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009522 i = tv_get_number_chk(&HI2DI(hi)->di_tv, &error);
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009523 if (error)
9524 return; // type error; errmsg already given
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009525 if (first)
9526 {
9527 n = i;
9528 first = FALSE;
9529 }
9530 else if (domax ? i > n : i < n)
9531 n = i;
9532 }
9533 }
9534 }
9535 }
9536 else
Bram Moolenaar460ae5d2022-01-01 14:19:49 +00009537 semsg(_(e_argument_of_str_must_be_list_or_dictionary), domax ? "max()" : "min()");
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009538
9539 rettv->vval.v_number = n;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009540}
9541
9542/*
9543 * "max()" function
9544 */
9545 static void
9546f_max(typval_T *argvars, typval_T *rettv)
9547{
9548 max_min(argvars, rettv, TRUE);
9549}
9550
9551/*
9552 * "min()" function
9553 */
9554 static void
9555f_min(typval_T *argvars, typval_T *rettv)
9556{
9557 max_min(argvars, rettv, FALSE);
9558}
9559
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009560#if defined(FEAT_MZSCHEME) || defined(PROTO)
9561/*
9562 * "mzeval()" function
9563 */
9564 static void
9565f_mzeval(typval_T *argvars, typval_T *rettv)
9566{
9567 char_u *str;
9568 char_u buf[NUMBUFLEN];
9569
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009570 if (check_restricted() || check_secure())
9571 return;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009572
9573 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
9574 return;
9575
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009576 str = tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009577 do_mzeval(str, rettv);
9578}
9579
9580 void
9581mzscheme_call_vim(char_u *name, typval_T *args, typval_T *rettv)
9582{
9583 typval_T argvars[3];
9584
9585 argvars[0].v_type = VAR_STRING;
9586 argvars[0].vval.v_string = name;
9587 copy_tv(args, &argvars[1]);
9588 argvars[2].v_type = VAR_UNKNOWN;
9589 f_call(argvars, rettv);
9590 clear_tv(&argvars[1]);
9591}
9592#endif
9593
9594/*
9595 * "nextnonblank()" function
9596 */
9597 static void
9598f_nextnonblank(typval_T *argvars, typval_T *rettv)
9599{
9600 linenr_T lnum;
9601
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009602 if (in_vim9script() && check_for_lnum_arg(argvars, 0) == FAIL)
9603 return;
9604
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009605 for (lnum = tv_get_lnum(argvars); ; ++lnum)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009606 {
9607 if (lnum < 0 || lnum > curbuf->b_ml.ml_line_count)
9608 {
9609 lnum = 0;
9610 break;
9611 }
9612 if (*skipwhite(ml_get(lnum)) != NUL)
9613 break;
9614 }
9615 rettv->vval.v_number = lnum;
9616}
9617
Christ van Willegenc0786752025-02-01 15:42:16 +01009618
9619/*
9620 * "ngettext()" function
9621 */
9622 static void
9623f_ngettext(typval_T *argvars, typval_T *rettv)
9624{
9625#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
9626 char *prev = NULL;
9627#endif
9628
9629 if (check_for_nonempty_string_arg(argvars, 0) == FAIL
9630 || check_for_nonempty_string_arg(argvars, 1) == FAIL
9631 || check_for_number_arg(argvars, 2) == FAIL
9632 || check_for_opt_string_arg(argvars, 3) == FAIL)
9633 return;
9634
9635 rettv->v_type = VAR_STRING;
9636
9637 if (argvars[3].v_type == VAR_STRING &&
9638 argvars[3].vval.v_string != NULL &&
9639 *(argvars[3].vval.v_string) != NUL)
9640 {
9641#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
9642 prev = bind_textdomain_codeset((const char *)argvars[3].vval.v_string, (char *)p_enc);
9643#endif
9644
9645#if defined(HAVE_DNGETTEXT)
9646 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));
9647#else
9648 textdomain((const char *)argvars[3].vval.v_string);
9649 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));
9650 textdomain(VIMPACKAGE);
9651#endif
9652
9653#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
9654 if (prev != NULL)
9655 bind_textdomain_codeset((const char *)argvars[3].vval.v_string, prev);
9656#endif
9657 }
9658 else
9659 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));
9660}
9661
9662
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009663/*
9664 * "nr2char()" function
9665 */
9666 static void
9667f_nr2char(typval_T *argvars, typval_T *rettv)
9668{
9669 char_u buf[NUMBUFLEN];
9670
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02009671 if (in_vim9script()
9672 && (check_for_number_arg(argvars, 0) == FAIL
9673 || check_for_opt_bool_arg(argvars, 1) == FAIL))
9674 return;
9675
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009676 if (has_mbyte)
9677 {
9678 int utf8 = 0;
9679
9680 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaared6a4302020-09-05 20:29:41 +02009681 utf8 = (int)tv_get_bool_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009682 if (utf8)
Bram Moolenaarbdace832019-03-02 10:13:42 +01009683 buf[utf_char2bytes((int)tv_get_number(&argvars[0]), buf)] = NUL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009684 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009685 buf[(*mb_char2bytes)((int)tv_get_number(&argvars[0]), buf)] = NUL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009686 }
9687 else
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009688 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009689 buf[0] = (char_u)tv_get_number(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009690 buf[1] = NUL;
9691 }
9692 rettv->v_type = VAR_STRING;
9693 rettv->vval.v_string = vim_strsave(buf);
9694}
9695
9696/*
9697 * "or(expr, expr)" function
9698 */
9699 static void
9700f_or(typval_T *argvars, typval_T *rettv)
9701{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009702 if (in_vim9script()
9703 && (check_for_number_arg(argvars, 0) == FAIL
9704 || check_for_number_arg(argvars, 1) == FAIL))
9705 return;
9706
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009707 rettv->vval.v_number = tv_get_number_chk(&argvars[0], NULL)
9708 | tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009709}
9710
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009711#ifdef FEAT_PERL
9712/*
9713 * "perleval()" function
9714 */
9715 static void
9716f_perleval(typval_T *argvars, typval_T *rettv)
9717{
9718 char_u *str;
9719 char_u buf[NUMBUFLEN];
9720
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009721 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
9722 return;
9723
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009724 str = tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009725 do_perleval(str, rettv);
9726}
9727#endif
9728
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009729/*
9730 * "prevnonblank()" function
9731 */
9732 static void
9733f_prevnonblank(typval_T *argvars, typval_T *rettv)
9734{
9735 linenr_T lnum;
9736
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009737 if (in_vim9script() && check_for_lnum_arg(argvars, 0) == FAIL)
9738 return;
9739
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009740 lnum = tv_get_lnum(argvars);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009741 if (lnum < 1 || lnum > curbuf->b_ml.ml_line_count)
9742 lnum = 0;
9743 else
9744 while (lnum >= 1 && *skipwhite(ml_get(lnum)) == NUL)
9745 --lnum;
9746 rettv->vval.v_number = lnum;
9747}
9748
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009749// This dummy va_list is here because:
9750// - passing a NULL pointer doesn't work when va_list isn't a pointer
9751// - locally in the function results in a "used before set" warning
9752// - using va_start() to initialize it gives "function with fixed args" error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009753static va_list ap;
9754
9755/*
9756 * "printf()" function
9757 */
9758 static void
9759f_printf(typval_T *argvars, typval_T *rettv)
9760{
9761 char_u buf[NUMBUFLEN];
9762 int len;
9763 char_u *s;
9764 int saved_did_emsg = did_emsg;
9765 char *fmt;
9766
9767 rettv->v_type = VAR_STRING;
9768 rettv->vval.v_string = NULL;
9769
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02009770 if (in_vim9script() && check_for_string_or_number_arg(argvars, 0) == FAIL)
9771 return;
9772
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009773 // Get the required length, allocate the buffer and do it for real.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009774 did_emsg = FALSE;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009775 fmt = (char *)tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar8327d1d2017-07-11 22:34:51 +02009776 len = vim_vsnprintf_typval(NULL, 0, fmt, ap, argvars + 1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009777 if (!did_emsg)
9778 {
9779 s = alloc(len + 1);
9780 if (s != NULL)
9781 {
9782 rettv->vval.v_string = s;
Bram Moolenaar8327d1d2017-07-11 22:34:51 +02009783 (void)vim_vsnprintf_typval((char *)s, len + 1, fmt,
9784 ap, argvars + 1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009785 }
9786 }
9787 did_emsg |= saved_did_emsg;
9788}
9789
9790/*
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009791 * "pum_getpos()" function
9792 */
9793 static void
9794f_pum_getpos(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
9795{
Bram Moolenaar93a10962022-06-16 11:42:09 +01009796 if (rettv_dict_alloc(rettv) == FAIL)
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009797 return;
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009798 pum_set_event_info(rettv->vval.v_dict);
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009799}
9800
9801/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009802 * "pumvisible()" function
9803 */
9804 static void
9805f_pumvisible(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
9806{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009807 if (pum_visible())
9808 rettv->vval.v_number = 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009809}
9810
9811#ifdef FEAT_PYTHON3
9812/*
9813 * "py3eval()" function
9814 */
9815 static void
9816f_py3eval(typval_T *argvars, typval_T *rettv)
9817{
9818 char_u *str;
9819 char_u buf[NUMBUFLEN];
Ben Jacksonea19e782024-11-06 21:50:05 +01009820 dict_T *locals;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009821
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009822 if (check_restricted() || check_secure())
9823 return;
9824
Ben Jacksonea19e782024-11-06 21:50:05 +01009825 if (in_vim9script()
9826 && (check_for_string_arg(argvars, 0) == FAIL
9827 || check_for_opt_dict_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009828 return;
9829
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009830 if (p_pyx == 0)
9831 p_pyx = 3;
9832
Ben Jacksonea19e782024-11-06 21:50:05 +01009833 if (argvars[1].v_type == VAR_DICT)
9834 {
9835 locals = argvars[1].vval.v_dict;
9836 }
9837 else if (argvars[1].v_type != VAR_UNKNOWN)
9838 {
9839 emsg(_(e_dictionary_required));
9840 return;
9841 }
9842 else
9843 {
9844 locals = NULL;
9845 }
9846
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009847 str = tv_get_string_buf(&argvars[0], buf);
Ben Jacksonea19e782024-11-06 21:50:05 +01009848 do_py3eval(str, locals, rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009849}
9850#endif
9851
9852#ifdef FEAT_PYTHON
9853/*
9854 * "pyeval()" function
9855 */
9856 static void
9857f_pyeval(typval_T *argvars, typval_T *rettv)
9858{
9859 char_u *str;
9860 char_u buf[NUMBUFLEN];
Ben Jacksonea19e782024-11-06 21:50:05 +01009861 dict_T *locals;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009862
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009863 if (check_restricted() || check_secure())
9864 return;
9865
Ben Jacksonea19e782024-11-06 21:50:05 +01009866 if (in_vim9script() && (
9867 check_for_string_arg(argvars, 0) == FAIL ||
9868 check_for_opt_dict_arg(argvars, 1) == FAIL ) )
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009869 return;
9870
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009871 if (p_pyx == 0)
9872 p_pyx = 2;
9873
Ben Jacksonea19e782024-11-06 21:50:05 +01009874 if (argvars[1].v_type == VAR_DICT)
9875 {
9876 locals = argvars[1].vval.v_dict;
9877 }
9878 else if (argvars[1].v_type != VAR_UNKNOWN)
9879 {
9880 emsg( "Invalid argument: must be dict" );
9881 return;
9882 }
9883 else
9884 {
9885 locals = NULL;
9886 }
9887
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009888 str = tv_get_string_buf(&argvars[0], buf);
Ben Jacksonea19e782024-11-06 21:50:05 +01009889 do_pyeval(str, locals, rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009890}
9891#endif
9892
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009893#if defined(FEAT_PYTHON) || defined(FEAT_PYTHON3)
9894/*
9895 * "pyxeval()" function
9896 */
9897 static void
9898f_pyxeval(typval_T *argvars, typval_T *rettv)
9899{
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009900 if (check_restricted() || check_secure())
9901 return;
9902
Ben Jacksonea19e782024-11-06 21:50:05 +01009903 if (in_vim9script()
9904 && (check_for_string_arg(argvars, 0) == FAIL
9905 || check_for_opt_dict_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009906 return;
9907
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009908# if defined(FEAT_PYTHON) && defined(FEAT_PYTHON3)
9909 init_pyxversion();
9910 if (p_pyx == 2)
9911 f_pyeval(argvars, rettv);
9912 else
9913 f_py3eval(argvars, rettv);
9914# elif defined(FEAT_PYTHON)
9915 f_pyeval(argvars, rettv);
9916# elif defined(FEAT_PYTHON3)
9917 f_py3eval(argvars, rettv);
9918# endif
9919}
9920#endif
9921
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009922static UINT32_T srand_seed_for_testing = 0;
9923static int srand_seed_for_testing_is_used = FALSE;
9924
9925 static void
9926f_test_srand_seed(typval_T *argvars, typval_T *rettv UNUSED)
9927{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009928 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
9929 return;
9930
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009931 if (argvars[0].v_type == VAR_UNKNOWN)
Bram Moolenaar7633fe52020-06-22 19:10:56 +02009932 srand_seed_for_testing_is_used = FALSE;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009933 else
9934 {
Bram Moolenaar7633fe52020-06-22 19:10:56 +02009935 srand_seed_for_testing = (UINT32_T)tv_get_number(&argvars[0]);
9936 srand_seed_for_testing_is_used = TRUE;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009937 }
9938}
9939
9940 static void
9941init_srand(UINT32_T *x)
9942{
LemonBoy9987fe82024-07-04 13:20:49 +02009943 struct {
9944 union {
9945 UINT32_T number;
9946 char_u bytes[sizeof(UINT32_T)];
9947 } contents;
9948 } buf;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009949
9950 if (srand_seed_for_testing_is_used)
9951 {
Bram Moolenaar7633fe52020-06-22 19:10:56 +02009952 *x = srand_seed_for_testing;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009953 return;
9954 }
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009955
LemonBoy9987fe82024-07-04 13:20:49 +02009956 if (mch_get_random(buf.contents.bytes, sizeof(buf.contents.bytes)) == OK)
9957 {
9958 *x = buf.contents.number;
9959 return;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009960 }
LemonBoy9987fe82024-07-04 13:20:49 +02009961
9962 // The system's random number generator doesn't work, fall back to:
9963 // - randombytes_random()
9964 // - reltime() or time()
9965 // - XOR with process ID
9966#if defined(FEAT_SODIUM)
9967 if (crypt_sodium_init() >= 0)
9968 *x = crypt_sodium_randombytes_random();
9969 else
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009970#endif
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009971 {
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009972#if defined(FEAT_RELTIME)
LemonBoy9987fe82024-07-04 13:20:49 +02009973 proftime_T res;
9974 profile_start(&res);
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009975# if defined(MSWIN)
LemonBoy9987fe82024-07-04 13:20:49 +02009976 *x = (UINT32_T)res.LowPart;
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009977# else
LemonBoy9987fe82024-07-04 13:20:49 +02009978 *x = (UINT32_T)res.tv_fsec;
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009979# endif
9980#else
LemonBoy9987fe82024-07-04 13:20:49 +02009981 *x = vim_time();
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009982#endif
LemonBoy9987fe82024-07-04 13:20:49 +02009983 *x ^= mch_get_pid();
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009984 }
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009985}
9986
kylo252ae6f1d82022-02-16 19:24:07 +00009987#define ROTL(x, k) (((x) << (k)) | ((x) >> (32 - (k))))
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009988#define SPLITMIX32(x, z) ( \
kylo252ae6f1d82022-02-16 19:24:07 +00009989 (z) = ((x) += 0x9e3779b9), \
9990 (z) = ((z) ^ ((z) >> 16)) * 0x85ebca6b, \
9991 (z) = ((z) ^ ((z) >> 13)) * 0xc2b2ae35, \
9992 (z) ^ ((z) >> 16) \
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009993 )
9994#define SHUFFLE_XOSHIRO128STARSTAR(x, y, z, w) \
kylo252ae6f1d82022-02-16 19:24:07 +00009995 result = ROTL((y) * 5, 7) * 9; \
9996 t = (y) << 9; \
9997 (z) ^= (x); \
9998 (w) ^= (y); \
9999 (y) ^= (z), (x) ^= (w); \
10000 (z) ^= t; \
10001 (w) = ROTL(w, 11);
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010002
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010003/*
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010004 * "rand()" function
10005 */
10006 static void
10007f_rand(typval_T *argvars, typval_T *rettv)
10008{
10009 list_T *l = NULL;
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010010 static UINT32_T gx, gy, gz, gw;
10011 static int initialized = FALSE;
Bram Moolenaarf8c1f922019-11-28 22:13:14 +010010012 listitem_T *lx, *ly, *lz, *lw;
Bram Moolenaar0fd797e2020-11-05 20:46:32 +010010013 UINT32_T x = 0, y, z, w, t, result;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010014
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010015 if (in_vim9script() && check_for_opt_list_arg(argvars, 0) == FAIL)
10016 return;
10017
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010018 if (argvars[0].v_type == VAR_UNKNOWN)
10019 {
Bram Moolenaarf8c1f922019-11-28 22:13:14 +010010020 // When no argument is given use the global seed list.
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010021 if (initialized == FALSE)
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010022 {
Bram Moolenaarf8c1f922019-11-28 22:13:14 +010010023 // Initialize the global seed list.
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010024 init_srand(&x);
10025
10026 gx = SPLITMIX32(x, z);
10027 gy = SPLITMIX32(x, z);
10028 gz = SPLITMIX32(x, z);
10029 gw = SPLITMIX32(x, z);
10030 initialized = TRUE;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010031 }
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010032
10033 SHUFFLE_XOSHIRO128STARSTAR(gx, gy, gz, gw);
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010034 }
10035 else if (argvars[0].v_type == VAR_LIST)
10036 {
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010037 l = argvars[0].vval.v_list;
Bram Moolenaarf8c1f922019-11-28 22:13:14 +010010038 if (l == NULL || list_len(l) != 4)
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010039 goto theend;
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010040
10041 lx = list_find(l, 0L);
10042 ly = list_find(l, 1L);
10043 lz = list_find(l, 2L);
10044 lw = list_find(l, 3L);
10045 if (lx->li_tv.v_type != VAR_NUMBER) goto theend;
10046 if (ly->li_tv.v_type != VAR_NUMBER) goto theend;
10047 if (lz->li_tv.v_type != VAR_NUMBER) goto theend;
10048 if (lw->li_tv.v_type != VAR_NUMBER) goto theend;
10049 x = (UINT32_T)lx->li_tv.vval.v_number;
10050 y = (UINT32_T)ly->li_tv.vval.v_number;
10051 z = (UINT32_T)lz->li_tv.vval.v_number;
10052 w = (UINT32_T)lw->li_tv.vval.v_number;
10053
10054 SHUFFLE_XOSHIRO128STARSTAR(x, y, z, w);
10055
10056 lx->li_tv.vval.v_number = (varnumber_T)x;
10057 ly->li_tv.vval.v_number = (varnumber_T)y;
10058 lz->li_tv.vval.v_number = (varnumber_T)z;
10059 lw->li_tv.vval.v_number = (varnumber_T)w;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010060 }
10061 else
10062 goto theend;
10063
10064 rettv->v_type = VAR_NUMBER;
Bram Moolenaarf8c1f922019-11-28 22:13:14 +010010065 rettv->vval.v_number = (varnumber_T)result;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010066 return;
10067
10068theend:
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010069 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[0]));
Bram Moolenaarf8c1f922019-11-28 22:13:14 +010010070 rettv->v_type = VAR_NUMBER;
10071 rettv->vval.v_number = -1;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +010010072}
10073
10074/*
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010075 * "srand()" function
10076 */
10077 static void
10078f_srand(typval_T *argvars, typval_T *rettv)
10079{
10080 UINT32_T x = 0, z;
10081
10082 if (rettv_list_alloc(rettv) == FAIL)
10083 return;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010084
10085 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
10086 return;
10087
Bram Moolenaar4f645c52020-02-08 16:40:39 +010010088 if (argvars[0].v_type == VAR_UNKNOWN)
10089 {
10090 init_srand(&x);
10091 }
10092 else
10093 {
10094 int error = FALSE;
10095
10096 x = (UINT32_T)tv_get_number_chk(&argvars[0], &error);
10097 if (error)
10098 return;
10099 }
10100
10101 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
10102 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
10103 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
10104 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
10105}
10106
10107#undef ROTL
10108#undef SPLITMIX32
10109#undef SHUFFLE_XOSHIRO128STARSTAR
10110
10111/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010112 * "range()" function
10113 */
10114 static void
10115f_range(typval_T *argvars, typval_T *rettv)
10116{
10117 varnumber_T start;
10118 varnumber_T end;
10119 varnumber_T stride = 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010120 int error = FALSE;
10121
Bram Moolenaar93a10962022-06-16 11:42:09 +010010122 if (rettv_list_alloc(rettv) == FAIL)
Yegappan Lakshmananca195cc2022-06-14 13:42:26 +010010123 return;
10124
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010125 if (in_vim9script()
10126 && (check_for_number_arg(argvars, 0) == FAIL
10127 || check_for_opt_number_arg(argvars, 1) == FAIL
10128 || (argvars[1].v_type != VAR_UNKNOWN
10129 && check_for_opt_number_arg(argvars, 2) == FAIL)))
10130 return;
10131
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010132 start = tv_get_number_chk(&argvars[0], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010133 if (argvars[1].v_type == VAR_UNKNOWN)
10134 {
10135 end = start - 1;
10136 start = 0;
10137 }
10138 else
10139 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010140 end = tv_get_number_chk(&argvars[1], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010141 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010142 stride = tv_get_number_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010143 }
10144
10145 if (error)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010146 return; // type error; errmsg already given
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010147 if (stride == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010148 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010149 emsg(_(e_stride_is_zero));
10150 return;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010010151 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010152 if (stride > 0 ? end + 1 < start : end - 1 > start)
10153 {
10154 emsg(_(e_start_past_end));
10155 return;
10156 }
10157
10158 list_T *list = rettv->vval.v_list;
10159
10160 // Create a non-materialized list. This is much more efficient and
10161 // works with ":for". If used otherwise CHECK_LIST_MATERIALIZE() must
10162 // be called.
10163 list->lv_first = &range_list_item;
10164 list->lv_u.nonmat.lv_start = start;
10165 list->lv_u.nonmat.lv_end = end;
10166 list->lv_u.nonmat.lv_stride = stride;
Christian Brabandtdf63da92023-11-23 20:14:28 +010010167 if (stride > 0 ? end < start : end > start)
10168 list->lv_len = 0;
10169 else
10170 list->lv_len = (end - start) / stride + 1;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010010171}
10172
10173/*
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020010174 * Materialize "list".
10175 * Do not call directly, use CHECK_LIST_MATERIALIZE()
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010010176 */
10177 void
10178range_list_materialize(list_T *list)
10179{
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020010180 varnumber_T start = list->lv_u.nonmat.lv_start;
10181 varnumber_T end = list->lv_u.nonmat.lv_end;
Bram Moolenaar70c43d82022-01-26 21:01:15 +000010182 int stride = list->lv_u.nonmat.lv_stride;
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020010183 varnumber_T i;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010010184
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020010185 list->lv_first = NULL;
10186 list->lv_u.mat.lv_last = NULL;
10187 list->lv_len = 0;
10188 list->lv_u.mat.lv_idx_item = NULL;
10189 for (i = start; stride > 0 ? i <= end : i >= end; i += stride)
Bram Moolenaar70c43d82022-01-26 21:01:15 +000010190 {
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +000010191 if (list_append_number(list, i) == FAIL)
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020010192 break;
Bram Moolenaar70c43d82022-01-26 21:01:15 +000010193 if (list->lv_lock & VAR_ITEMS_LOCKED)
10194 list->lv_u.mat.lv_last->li_tv.v_lock = VAR_LOCKED;
10195 }
10196 list->lv_lock &= ~VAR_ITEMS_LOCKED;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010197}
10198
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010199/*
10200 * "getreginfo()" function
10201 */
10202 static void
10203f_getreginfo(typval_T *argvars, typval_T *rettv)
10204{
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010205 int regname;
10206 char_u buf[NUMBUFLEN + 2];
10207 long reglen = 0;
10208 dict_T *dict;
10209 list_T *list;
10210
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010211 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
10212 return;
10213
zeertzjqd3f00f52021-12-24 12:02:43 +000010214 regname = getreg_get_regname(argvars);
10215 if (regname == 0)
10216 return;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010217
zeertzjqd3f00f52021-12-24 12:02:43 +000010218 if (regname == '@')
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010219 regname = '"';
10220
10221 if (rettv_dict_alloc(rettv) == FAIL)
10222 return;
10223 dict = rettv->vval.v_dict;
10224
10225 list = (list_T *)get_reg_contents(regname, GREG_EXPR_SRC | GREG_LIST);
10226 if (list == NULL)
10227 return;
Bram Moolenaar91639192020-06-29 19:55:58 +020010228 (void)dict_add_list(dict, "regcontents", list);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010229
10230 buf[0] = NUL;
10231 buf[1] = NUL;
10232 switch (get_reg_type(regname, &reglen))
10233 {
10234 case MLINE: buf[0] = 'V'; break;
10235 case MCHAR: buf[0] = 'v'; break;
10236 case MBLOCK:
10237 vim_snprintf((char *)buf, sizeof(buf), "%c%ld", Ctrl_V,
10238 reglen + 1);
10239 break;
10240 }
Bram Moolenaar91639192020-06-29 19:55:58 +020010241 (void)dict_add_string(dict, (char *)"regtype", buf);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010242
10243 buf[0] = get_register_name(get_unname_register());
10244 buf[1] = NUL;
10245 if (regname == '"')
Bram Moolenaar91639192020-06-29 19:55:58 +020010246 (void)dict_add_string(dict, (char *)"points_to", buf);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010247 else
10248 {
10249 dictitem_T *item = dictitem_alloc((char_u *)"isunnamed");
10250
10251 if (item != NULL)
10252 {
Bram Moolenaar82946e12022-11-24 11:31:29 +000010253 item->di_tv.v_type = VAR_BOOL;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010254 item->di_tv.vval.v_number = regname == buf[0]
Bram Moolenaar418a29f2021-02-10 22:23:41 +010010255 ? VVAL_TRUE : VVAL_FALSE;
Bram Moolenaar91639192020-06-29 19:55:58 +020010256 (void)dict_add(dict, item);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010257 }
10258 }
10259}
10260
Bram Moolenaar0b6d9112018-05-22 20:35:17 +020010261 static void
10262return_register(int regname, typval_T *rettv)
10263{
10264 char_u buf[2] = {0, 0};
10265
10266 buf[0] = (char_u)regname;
10267 rettv->v_type = VAR_STRING;
10268 rettv->vval.v_string = vim_strsave(buf);
10269}
10270
10271/*
10272 * "reg_executing()" function
10273 */
10274 static void
10275f_reg_executing(typval_T *argvars UNUSED, typval_T *rettv)
10276{
10277 return_register(reg_executing, rettv);
10278}
10279
10280/*
10281 * "reg_recording()" function
10282 */
10283 static void
10284f_reg_recording(typval_T *argvars UNUSED, typval_T *rettv)
10285{
10286 return_register(reg_recording, rettv);
10287}
10288
Bram Moolenaar7416f3e2017-03-18 18:10:13 +010010289/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010290 * "rename({from}, {to})" function
10291 */
10292 static void
10293f_rename(typval_T *argvars, typval_T *rettv)
10294{
10295 char_u buf[NUMBUFLEN];
10296
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010297 rettv->vval.v_number = -1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010298 if (check_restricted() || check_secure())
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010299 return;
10300
10301 if (in_vim9script()
10302 && (check_for_string_arg(argvars, 0) == FAIL
10303 || check_for_string_arg(argvars, 1) == FAIL))
10304 return;
10305
10306 rettv->vval.v_number = vim_rename(tv_get_string(&argvars[0]),
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010307 tv_get_string_buf(&argvars[1], buf));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010308}
10309
10310/*
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010311 * Repeat the list "l" "n" times and set "rettv" to the new list.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010312 */
10313 static void
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010314repeat_list(list_T *l, int n, typval_T *rettv)
10315{
10316 if (rettv_list_alloc(rettv) == FAIL
10317 || l == NULL
10318 || n <= 0)
10319 return;
10320
10321 while (n-- > 0)
10322 if (list_extend(rettv->vval.v_list, l, NULL) == FAIL)
10323 break;
10324}
10325
10326/*
10327 * Repeat the blob "b" "n" times and set "rettv" to the new blob.
10328 */
10329 static void
10330repeat_blob(typval_T *blob_tv, int n, typval_T *rettv)
10331{
10332 int slen;
10333 int len;
10334 int i;
10335 blob_T *blob = blob_tv->vval.v_blob;
10336
10337 if (rettv_blob_alloc(rettv) == FAIL
10338 || blob == NULL
10339 || n <= 0)
10340 return;
10341
10342 slen = blob->bv_ga.ga_len;
10343 len = (int)slen * n;
10344 if (len <= 0)
10345 return;
10346
10347 if (ga_grow(&rettv->vval.v_blob->bv_ga, len) == FAIL)
10348 return;
10349
10350 rettv->vval.v_blob->bv_ga.ga_len = len;
10351
10352 for (i = 0; i < slen; ++i)
10353 if (blob_get(blob, i) != 0)
10354 break;
10355
10356 if (i == slen)
10357 // No need to copy since all bytes are already zero
10358 return;
10359
10360 for (i = 0; i < n; ++i)
10361 blob_set_range(rettv->vval.v_blob,
10362 (long)i * slen, ((long)i + 1) * slen - 1, blob_tv);
10363}
10364
10365/*
10366 * Repeat the string "str" "n" times and set "rettv" to the new string.
10367 */
10368 static void
10369repeat_string(typval_T *str_tv, int n, typval_T *rettv)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010370{
10371 char_u *p;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010372 int slen;
10373 int len;
10374 char_u *r;
10375 int i;
10376
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010377 p = tv_get_string(str_tv);
10378 rettv->v_type = VAR_STRING;
10379 rettv->vval.v_string = NULL;
10380
10381 slen = (int)STRLEN(p);
10382 len = slen * n;
10383 if (len <= 0)
10384 return;
10385
10386 r = alloc(len + 1);
10387 if (r == NULL)
10388 return;
10389
10390 for (i = 0; i < n; i++)
10391 mch_memmove(r + i * slen, p, (size_t)slen);
10392 r[len] = NUL;
10393
10394 rettv->vval.v_string = r;
10395}
10396
10397/*
10398 * "repeat()" function
10399 */
10400 static void
10401f_repeat(typval_T *argvars, typval_T *rettv)
10402{
10403 varnumber_T n;
10404
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +020010405 if (in_vim9script()
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010406 && (check_for_repeat_func_arg(argvars, 0) == FAIL
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010407 || check_for_number_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +020010408 return;
10409
Bakudankun375141e2022-09-09 18:46:47 +010010410 n = tv_get_number(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010411 if (argvars[0].v_type == VAR_LIST)
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010412 repeat_list(argvars[0].vval.v_list, n, rettv);
10413 else if (argvars[0].v_type == VAR_TUPLE)
10414 tuple_repeat(argvars[0].vval.v_tuple, n, rettv);
Bakudankun375141e2022-09-09 18:46:47 +010010415 else if (argvars[0].v_type == VAR_BLOB)
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010416 repeat_blob(&argvars[0], n, rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010417 else
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010010418 repeat_string(&argvars[0], n, rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010419}
10420
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010421#define SP_NOMOVE 0x01 // don't move cursor
10422#define SP_REPEAT 0x02 // repeat to find outer pair
10423#define SP_RETCOUNT 0x04 // return matchcount
10424#define SP_SETPCMARK 0x08 // set previous context mark
10425#define SP_START 0x10 // accept match at start position
10426#define SP_SUBPAT 0x20 // return nr of matching sub-pattern
10427#define SP_END 0x40 // leave cursor at end of match
10428#define SP_COLUMN 0x80 // start at cursor column
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010429
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010430/*
10431 * Get flags for a search function.
10432 * Possibly sets "p_ws".
10433 * Returns BACKWARD, FORWARD or zero (for an error).
10434 */
10435 static int
10436get_search_arg(typval_T *varp, int *flagsp)
10437{
10438 int dir = FORWARD;
10439 char_u *flags;
10440 char_u nbuf[NUMBUFLEN];
10441 int mask;
10442
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010443 if (varp->v_type == VAR_UNKNOWN)
10444 return FORWARD;
10445
10446 flags = tv_get_string_buf_chk(varp, nbuf);
10447 if (flags == NULL)
10448 return 0; // type error; errmsg already given
10449 while (*flags != NUL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010450 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010451 switch (*flags)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010452 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010453 case 'b': dir = BACKWARD; break;
10454 case 'w': p_ws = TRUE; break;
10455 case 'W': p_ws = FALSE; break;
10456 default: mask = 0;
10457 if (flagsp != NULL)
10458 switch (*flags)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010459 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010460 case 'c': mask = SP_START; break;
10461 case 'e': mask = SP_END; break;
10462 case 'm': mask = SP_RETCOUNT; break;
10463 case 'n': mask = SP_NOMOVE; break;
10464 case 'p': mask = SP_SUBPAT; break;
10465 case 'r': mask = SP_REPEAT; break;
10466 case 's': mask = SP_SETPCMARK; break;
10467 case 'z': mask = SP_COLUMN; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010468 }
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010469 if (mask == 0)
10470 {
10471 semsg(_(e_invalid_argument_str), flags);
10472 dir = 0;
10473 }
10474 else
10475 *flagsp |= mask;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010476 }
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010477 if (dir == 0)
10478 break;
10479 ++flags;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010480 }
10481 return dir;
10482}
10483
10484/*
10485 * Shared by search() and searchpos() functions.
10486 */
10487 static int
10488search_cmn(typval_T *argvars, pos_T *match_pos, int *flagsp)
10489{
10490 int flags;
10491 char_u *pat;
John Marriott8c85a2a2024-05-20 19:18:26 +020010492 size_t patlen;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010493 pos_T pos;
10494 pos_T save_cursor;
10495 int save_p_ws = p_ws;
10496 int dir;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010497 int retval = 0; // default: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010498 long lnum_stop = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010499#ifdef FEAT_RELTIME
10500 long time_limit = 0;
10501#endif
10502 int options = SEARCH_KEEP;
10503 int subpatnum;
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010504 searchit_arg_T sia;
Bram Moolenaara9c01042020-06-07 14:50:50 +020010505 int use_skip = FALSE;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010506 pos_T firstpos;
10507
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +020010508 if (in_vim9script()
10509 && (check_for_string_arg(argvars, 0) == FAIL
10510 || check_for_opt_string_arg(argvars, 1) == FAIL
10511 || (argvars[1].v_type != VAR_UNKNOWN
10512 && (check_for_opt_number_arg(argvars, 2) == FAIL
10513 || (argvars[2].v_type != VAR_UNKNOWN
10514 && check_for_opt_number_arg(argvars, 3) == FAIL)))))
10515 goto theend;
10516
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010517 pat = tv_get_string(&argvars[0]);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010518 dir = get_search_arg(&argvars[1], flagsp); // may set p_ws
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010519 if (dir == 0)
10520 goto theend;
10521 flags = *flagsp;
10522 if (flags & SP_START)
10523 options |= SEARCH_START;
10524 if (flags & SP_END)
10525 options |= SEARCH_END;
10526 if (flags & SP_COLUMN)
10527 options |= SEARCH_COL;
10528
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010529 // Optional arguments: line number to stop searching, timeout and skip.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010530 if (argvars[1].v_type != VAR_UNKNOWN && argvars[2].v_type != VAR_UNKNOWN)
10531 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010532 lnum_stop = (long)tv_get_number_chk(&argvars[2], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010533 if (lnum_stop < 0)
10534 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010535 if (argvars[3].v_type != VAR_UNKNOWN)
10536 {
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010537#ifdef FEAT_RELTIME
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010538 time_limit = (long)tv_get_number_chk(&argvars[3], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010539 if (time_limit < 0)
10540 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010541#endif
Bram Moolenaara9c01042020-06-07 14:50:50 +020010542 use_skip = eval_expr_valid_arg(&argvars[4]);
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010543 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010544 }
10545
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010546 /*
10547 * This function does not accept SP_REPEAT and SP_RETCOUNT flags.
10548 * Check to make sure only those flags are set.
10549 * Also, Only the SP_NOMOVE or the SP_SETPCMARK flag can be set. Both
10550 * flags cannot be set. Check for that condition also.
10551 */
10552 if (((flags & (SP_REPEAT | SP_RETCOUNT)) != 0)
10553 || ((flags & SP_NOMOVE) && (flags & SP_SETPCMARK)))
10554 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010555 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[1]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010556 goto theend;
10557 }
10558
10559 pos = save_cursor = curwin->w_cursor;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010560 CLEAR_FIELD(firstpos);
Bram Moolenaara80faa82020-04-12 19:37:17 +020010561 CLEAR_FIELD(sia);
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010562 sia.sa_stop_lnum = (linenr_T)lnum_stop;
10563#ifdef FEAT_RELTIME
Paul Ollis65745772022-06-05 16:55:54 +010010564 sia.sa_tm = time_limit;
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010565#endif
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010566
John Marriott8c85a2a2024-05-20 19:18:26 +020010567 patlen = STRLEN(pat);
10568
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010569 // Repeat until {skip} returns FALSE.
10570 for (;;)
10571 {
John Marriott8c85a2a2024-05-20 19:18:26 +020010572 subpatnum = searchit(curwin, curbuf, &pos, NULL, dir, pat, patlen, 1L,
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010573 options, RE_SEARCH, &sia);
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010574 // finding the first match again means there is no match where {skip}
10575 // evaluates to zero.
10576 if (firstpos.lnum != 0 && EQUAL_POS(pos, firstpos))
10577 subpatnum = FAIL;
10578
Bram Moolenaara9c01042020-06-07 14:50:50 +020010579 if (subpatnum == FAIL || !use_skip)
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010580 // didn't find it or no skip argument
10581 break;
Bram Moolenaar3d79f0a2023-01-22 20:14:26 +000010582 if (firstpos.lnum == 0)
10583 firstpos = pos;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010584
Bram Moolenaara9c01042020-06-07 14:50:50 +020010585 // If the skip expression matches, ignore this match.
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010586 {
10587 int do_skip;
10588 int err;
10589 pos_T save_pos = curwin->w_cursor;
10590
10591 curwin->w_cursor = pos;
Bram Moolenaara9c01042020-06-07 14:50:50 +020010592 err = FALSE;
10593 do_skip = eval_expr_to_bool(&argvars[4], &err);
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010594 curwin->w_cursor = save_pos;
10595 if (err)
10596 {
10597 // Evaluating {skip} caused an error, break here.
10598 subpatnum = FAIL;
10599 break;
10600 }
10601 if (!do_skip)
10602 break;
10603 }
zeertzjq180246c2022-06-23 12:04:46 +010010604
10605 // clear the start flag to avoid getting stuck here
10606 options &= ~SEARCH_START;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010607 }
10608
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010609 if (subpatnum != FAIL)
10610 {
10611 if (flags & SP_SUBPAT)
10612 retval = subpatnum;
10613 else
10614 retval = pos.lnum;
10615 if (flags & SP_SETPCMARK)
10616 setpcmark();
10617 curwin->w_cursor = pos;
10618 if (match_pos != NULL)
10619 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010620 // Store the match cursor position
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010621 match_pos->lnum = pos.lnum;
10622 match_pos->col = pos.col + 1;
10623 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010624 // "/$" will put the cursor after the end of the line, may need to
10625 // correct that here
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010626 check_cursor();
10627 }
10628
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010629 // If 'n' flag is used: restore cursor position.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010630 if (flags & SP_NOMOVE)
10631 curwin->w_cursor = save_cursor;
10632 else
10633 curwin->w_set_curswant = TRUE;
10634theend:
10635 p_ws = save_p_ws;
10636
10637 return retval;
10638}
10639
Bram Moolenaare99be0e2019-03-26 22:51:09 +010010640#ifdef FEAT_RUBY
10641/*
10642 * "rubyeval()" function
10643 */
10644 static void
10645f_rubyeval(typval_T *argvars, typval_T *rettv)
10646{
10647 char_u *str;
10648 char_u buf[NUMBUFLEN];
10649
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010650 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
10651 return;
10652
Bram Moolenaare99be0e2019-03-26 22:51:09 +010010653 str = tv_get_string_buf(&argvars[0], buf);
10654 do_rubyeval(str, rettv);
10655}
10656#endif
10657
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010658/*
10659 * "screenattr()" function
10660 */
10661 static void
10662f_screenattr(typval_T *argvars, typval_T *rettv)
10663{
10664 int row;
10665 int col;
10666 int c;
10667
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010668 if (in_vim9script()
10669 && (check_for_number_arg(argvars, 0) == FAIL
10670 || check_for_number_arg(argvars, 1) == FAIL))
10671 return;
10672
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010673 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10674 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010675 if (row < 0 || row >= screen_Rows
10676 || col < 0 || col >= screen_Columns)
10677 c = -1;
10678 else
10679 c = ScreenAttrs[LineOffset[row] + col];
10680 rettv->vval.v_number = c;
10681}
10682
10683/*
10684 * "screenchar()" function
10685 */
10686 static void
10687f_screenchar(typval_T *argvars, typval_T *rettv)
10688{
10689 int row;
10690 int col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010691 int c;
10692
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010693 if (in_vim9script()
10694 && (check_for_number_arg(argvars, 0) == FAIL
10695 || check_for_number_arg(argvars, 1) == FAIL))
10696 return;
10697
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010698 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10699 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010700 if (row < 0 || row >= screen_Rows || col < 0 || col >= screen_Columns)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010701 c = -1;
10702 else
10703 {
zeertzjq47eec672023-06-01 20:26:55 +010010704 char_u buf[MB_MAXBYTES + 1];
10705 screen_getbytes(row, col, buf, NULL);
10706 c = (*mb_ptr2char)(buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010707 }
10708 rettv->vval.v_number = c;
10709}
10710
10711/*
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010712 * "screenchars()" function
10713 */
10714 static void
10715f_screenchars(typval_T *argvars, typval_T *rettv)
10716{
10717 int row;
10718 int col;
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010719 int c;
10720 int i;
10721
10722 if (rettv_list_alloc(rettv) == FAIL)
10723 return;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010724
10725 if (in_vim9script()
10726 && (check_for_number_arg(argvars, 0) == FAIL
10727 || check_for_number_arg(argvars, 1) == FAIL))
10728 return;
10729
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010730 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10731 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
10732 if (row < 0 || row >= screen_Rows || col < 0 || col >= screen_Columns)
10733 return;
10734
zeertzjq47eec672023-06-01 20:26:55 +010010735 char_u buf[MB_MAXBYTES + 1];
10736 screen_getbytes(row, col, buf, NULL);
10737 int pcc[MAX_MCO];
10738 if (enc_utf8)
10739 c = utfc_ptr2char(buf, pcc);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010740 else
zeertzjq47eec672023-06-01 20:26:55 +010010741 c = (*mb_ptr2char)(buf);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010742 list_append_number(rettv->vval.v_list, (varnumber_T)c);
10743
10744 if (enc_utf8)
zeertzjq47eec672023-06-01 20:26:55 +010010745 for (i = 0; i < Screen_mco && pcc[i] != 0; ++i)
10746 list_append_number(rettv->vval.v_list, (varnumber_T)pcc[i]);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010747}
10748
10749/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010750 * "screencol()" function
10751 *
10752 * First column is 1 to be consistent with virtcol().
10753 */
10754 static void
10755f_screencol(typval_T *argvars UNUSED, typval_T *rettv)
10756{
10757 rettv->vval.v_number = screen_screencol() + 1;
10758}
10759
10760/*
10761 * "screenrow()" function
10762 */
10763 static void
10764f_screenrow(typval_T *argvars UNUSED, typval_T *rettv)
10765{
10766 rettv->vval.v_number = screen_screenrow() + 1;
10767}
10768
10769/*
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010770 * "screenstring()" function
10771 */
10772 static void
10773f_screenstring(typval_T *argvars, typval_T *rettv)
10774{
10775 int row;
10776 int col;
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010777 char_u buf[MB_MAXBYTES + 1];
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010778
10779 rettv->vval.v_string = NULL;
10780 rettv->v_type = VAR_STRING;
10781
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010782 if (in_vim9script()
10783 && (check_for_number_arg(argvars, 0) == FAIL
10784 || check_for_number_arg(argvars, 1) == FAIL))
10785 return;
10786
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010787 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10788 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
10789 if (row < 0 || row >= screen_Rows || col < 0 || col >= screen_Columns)
10790 return;
10791
zeertzjq47eec672023-06-01 20:26:55 +010010792 screen_getbytes(row, col, buf, NULL);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010793 rettv->vval.v_string = vim_strsave(buf);
10794}
10795
10796/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010797 * "search()" function
10798 */
10799 static void
10800f_search(typval_T *argvars, typval_T *rettv)
10801{
10802 int flags = 0;
10803
10804 rettv->vval.v_number = search_cmn(argvars, NULL, &flags);
10805}
10806
10807/*
10808 * "searchdecl()" function
10809 */
10810 static void
10811f_searchdecl(typval_T *argvars, typval_T *rettv)
10812{
Bram Moolenaar30788d32020-09-05 21:35:16 +020010813 int locally = TRUE;
10814 int thisblock = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010815 int error = FALSE;
10816 char_u *name;
10817
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010818 rettv->vval.v_number = 1; // default: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010819
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020010820 if (in_vim9script()
10821 && (check_for_string_arg(argvars, 0) == FAIL
10822 || check_for_opt_bool_arg(argvars, 1) == FAIL
10823 || (argvars[1].v_type != VAR_UNKNOWN
10824 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
10825 return;
10826
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010827 name = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010828 if (argvars[1].v_type != VAR_UNKNOWN)
10829 {
Bram Moolenaar30788d32020-09-05 21:35:16 +020010830 locally = !(int)tv_get_bool_chk(&argvars[1], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010831 if (!error && argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar30788d32020-09-05 21:35:16 +020010832 thisblock = (int)tv_get_bool_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010833 }
10834 if (!error && name != NULL)
10835 rettv->vval.v_number = find_decl(name, (int)STRLEN(name),
10836 locally, thisblock, SEARCH_KEEP) == FAIL;
10837}
10838
10839/*
10840 * Used by searchpair() and searchpairpos()
10841 */
10842 static int
10843searchpair_cmn(typval_T *argvars, pos_T *match_pos)
10844{
10845 char_u *spat, *mpat, *epat;
Bram Moolenaar48570482017-10-30 21:48:41 +010010846 typval_T *skip;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010847 int save_p_ws = p_ws;
10848 int dir;
10849 int flags = 0;
10850 char_u nbuf1[NUMBUFLEN];
10851 char_u nbuf2[NUMBUFLEN];
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010852 int retval = 0; // default: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010853 long lnum_stop = 0;
10854 long time_limit = 0;
10855
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +020010856 if (in_vim9script()
10857 && (check_for_string_arg(argvars, 0) == FAIL
10858 || check_for_string_arg(argvars, 1) == FAIL
10859 || check_for_string_arg(argvars, 2) == FAIL
10860 || check_for_opt_string_arg(argvars, 3) == FAIL
10861 || (argvars[3].v_type != VAR_UNKNOWN
10862 && argvars[4].v_type != VAR_UNKNOWN
10863 && (check_for_opt_number_arg(argvars, 5) == FAIL
10864 || (argvars[5].v_type != VAR_UNKNOWN
10865 && check_for_opt_number_arg(argvars, 6) == FAIL)))))
10866 goto theend;
10867
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010868 // Get the three pattern arguments: start, middle, end. Will result in an
10869 // error if not a valid argument.
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010870 spat = tv_get_string_chk(&argvars[0]);
10871 mpat = tv_get_string_buf_chk(&argvars[1], nbuf1);
10872 epat = tv_get_string_buf_chk(&argvars[2], nbuf2);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010873 if (spat == NULL || mpat == NULL || epat == NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010874 goto theend; // type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010875
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010876 // Handle the optional fourth argument: flags
10877 dir = get_search_arg(&argvars[3], &flags); // may set p_ws
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010878 if (dir == 0)
10879 goto theend;
10880
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010881 // Don't accept SP_END or SP_SUBPAT.
10882 // Only one of the SP_NOMOVE or SP_SETPCMARK flags can be set.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010883 if ((flags & (SP_END | SP_SUBPAT)) != 0
10884 || ((flags & SP_NOMOVE) && (flags & SP_SETPCMARK)))
10885 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010886 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[3]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010887 goto theend;
10888 }
10889
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010890 // Using 'r' implies 'W', otherwise it doesn't work.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010891 if (flags & SP_REPEAT)
10892 p_ws = FALSE;
10893
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010894 // Optional fifth argument: skip expression
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010895 if (argvars[3].v_type == VAR_UNKNOWN
10896 || argvars[4].v_type == VAR_UNKNOWN)
Bram Moolenaar48570482017-10-30 21:48:41 +010010897 skip = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010898 else
10899 {
Bram Moolenaara9c01042020-06-07 14:50:50 +020010900 // Type is checked later.
Bram Moolenaar48570482017-10-30 21:48:41 +010010901 skip = &argvars[4];
Bram Moolenaara9c01042020-06-07 14:50:50 +020010902
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010903 if (argvars[5].v_type != VAR_UNKNOWN)
10904 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010905 lnum_stop = (long)tv_get_number_chk(&argvars[5], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010906 if (lnum_stop < 0)
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010907 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010908 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[5]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010909 goto theend;
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010910 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010911#ifdef FEAT_RELTIME
10912 if (argvars[6].v_type != VAR_UNKNOWN)
10913 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010914 time_limit = (long)tv_get_number_chk(&argvars[6], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010915 if (time_limit < 0)
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010916 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010917 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[6]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010918 goto theend;
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010919 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010920 }
10921#endif
10922 }
10923 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010924
10925 retval = do_searchpair(spat, mpat, epat, dir, skip, flags,
10926 match_pos, lnum_stop, time_limit);
10927
10928theend:
10929 p_ws = save_p_ws;
10930
10931 return retval;
10932}
10933
10934/*
10935 * "searchpair()" function
10936 */
10937 static void
10938f_searchpair(typval_T *argvars, typval_T *rettv)
10939{
10940 rettv->vval.v_number = searchpair_cmn(argvars, NULL);
10941}
10942
10943/*
10944 * "searchpairpos()" function
10945 */
10946 static void
10947f_searchpairpos(typval_T *argvars, typval_T *rettv)
10948{
10949 pos_T match_pos;
10950 int lnum = 0;
10951 int col = 0;
10952
10953 if (rettv_list_alloc(rettv) == FAIL)
10954 return;
10955
10956 if (searchpair_cmn(argvars, &match_pos) > 0)
10957 {
10958 lnum = match_pos.lnum;
10959 col = match_pos.col;
10960 }
10961
10962 list_append_number(rettv->vval.v_list, (varnumber_T)lnum);
10963 list_append_number(rettv->vval.v_list, (varnumber_T)col);
10964}
10965
10966/*
10967 * Search for a start/middle/end thing.
10968 * Used by searchpair(), see its documentation for the details.
10969 * Returns 0 or -1 for no match,
10970 */
10971 long
10972do_searchpair(
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010973 char_u *spat, // start pattern
10974 char_u *mpat, // middle pattern
10975 char_u *epat, // end pattern
10976 int dir, // BACKWARD or FORWARD
10977 typval_T *skip, // skip expression
10978 int flags, // SP_SETPCMARK and other SP_ values
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010979 pos_T *match_pos,
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010980 linenr_T lnum_stop, // stop at this line if not zero
10981 long time_limit UNUSED) // stop after this many msec
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010982{
10983 char_u *save_cpo;
10984 char_u *pat, *pat2 = NULL, *pat3 = NULL;
John Marriott8c85a2a2024-05-20 19:18:26 +020010985 size_t patlen;
10986 size_t spatlen;
10987 size_t epatlen;
10988 size_t pat2size;
10989 size_t pat2len;
10990 size_t pat3size;
10991 size_t pat3len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010992 long retval = 0;
10993 pos_T pos;
10994 pos_T firstpos;
10995 pos_T foundpos;
10996 pos_T save_cursor;
10997 pos_T save_pos;
10998 int n;
10999 int r;
11000 int nest = 1;
Bram Moolenaar48570482017-10-30 21:48:41 +010011001 int use_skip = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011002 int err;
11003 int options = SEARCH_KEEP;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011004
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011005 // Make 'cpoptions' empty, the 'l' flag should not be used here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011006 save_cpo = p_cpo;
11007 p_cpo = empty_option;
11008
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011009 // Make two search patterns: start/end (pat2, for in nested pairs) and
11010 // start/middle/end (pat3, for the top pair).
John Marriott8c85a2a2024-05-20 19:18:26 +020011011 spatlen = STRLEN(spat);
11012 epatlen = STRLEN(epat);
11013 pat2size = spatlen + epatlen + 17;
11014 pat2 = alloc(pat2size);
11015 if (pat2 == NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011016 goto theend;
John Marriott8c85a2a2024-05-20 19:18:26 +020011017 pat3size = spatlen + STRLEN(mpat) + epatlen + 25;
11018 pat3 = alloc(pat3size);
11019 if (pat3 == NULL)
11020 goto theend;
11021 pat2len = vim_snprintf((char *)pat2, pat2size, "\\m\\(%s\\m\\)\\|\\(%s\\m\\)", spat, epat);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011022 if (*mpat == NUL)
John Marriott8c85a2a2024-05-20 19:18:26 +020011023 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011024 STRCPY(pat3, pat2);
John Marriott8c85a2a2024-05-20 19:18:26 +020011025 pat3len = pat2len;
11026 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011027 else
John Marriott8c85a2a2024-05-20 19:18:26 +020011028 pat3len = vim_snprintf((char *)pat3, pat3size, "\\m\\(%s\\m\\)\\|\\(%s\\m\\)\\|\\(%s\\m\\)",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011029 spat, epat, mpat);
11030 if (flags & SP_START)
11031 options |= SEARCH_START;
11032
Bram Moolenaar48570482017-10-30 21:48:41 +010011033 if (skip != NULL)
Bram Moolenaara9c01042020-06-07 14:50:50 +020011034 use_skip = eval_expr_valid_arg(skip);
Bram Moolenaar48570482017-10-30 21:48:41 +010011035
Bram Moolenaar5ea38d12022-06-16 21:20:48 +010011036#ifdef FEAT_RELTIME
11037 if (time_limit > 0)
11038 init_regexp_timeout(time_limit);
11039#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011040 save_cursor = curwin->w_cursor;
11041 pos = curwin->w_cursor;
Bram Moolenaarb5aedf32017-03-12 18:23:53 +010011042 CLEAR_POS(&firstpos);
11043 CLEAR_POS(&foundpos);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011044 pat = pat3;
John Marriott8c85a2a2024-05-20 19:18:26 +020011045 patlen = pat3len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011046 for (;;)
11047 {
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020011048 searchit_arg_T sia;
11049
Bram Moolenaara80faa82020-04-12 19:37:17 +020011050 CLEAR_FIELD(sia);
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020011051 sia.sa_stop_lnum = lnum_stop;
John Marriott8c85a2a2024-05-20 19:18:26 +020011052 n = searchit(curwin, curbuf, &pos, NULL, dir, pat, patlen, 1L,
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020011053 options, RE_SEARCH, &sia);
Bram Moolenaarb5aedf32017-03-12 18:23:53 +010011054 if (n == FAIL || (firstpos.lnum != 0 && EQUAL_POS(pos, firstpos)))
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011055 // didn't find it or found the first match again: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011056 break;
11057
11058 if (firstpos.lnum == 0)
11059 firstpos = pos;
Bram Moolenaarb5aedf32017-03-12 18:23:53 +010011060 if (EQUAL_POS(pos, foundpos))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011061 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011062 // Found the same position again. Can happen with a pattern that
11063 // has "\zs" at the end and searching backwards. Advance one
11064 // character and try again.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011065 if (dir == BACKWARD)
11066 decl(&pos);
11067 else
11068 incl(&pos);
11069 }
11070 foundpos = pos;
11071
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011072 // clear the start flag to avoid getting stuck here
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011073 options &= ~SEARCH_START;
11074
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011075 // If the skip pattern matches, ignore this match.
Bram Moolenaar48570482017-10-30 21:48:41 +010011076 if (use_skip)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011077 {
11078 save_pos = curwin->w_cursor;
11079 curwin->w_cursor = pos;
Bram Moolenaar48570482017-10-30 21:48:41 +010011080 err = FALSE;
11081 r = eval_expr_to_bool(skip, &err);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011082 curwin->w_cursor = save_pos;
11083 if (err)
11084 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011085 // Evaluating {skip} caused an error, break here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011086 curwin->w_cursor = save_cursor;
11087 retval = -1;
11088 break;
11089 }
11090 if (r)
11091 continue;
11092 }
11093
11094 if ((dir == BACKWARD && n == 3) || (dir == FORWARD && n == 2))
11095 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011096 // Found end when searching backwards or start when searching
11097 // forward: nested pair.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011098 ++nest;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011099 pat = pat2; // nested, don't search for middle
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011100 }
11101 else
11102 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011103 // Found end when searching forward or start when searching
11104 // backward: end of (nested) pair; or found middle in outer pair.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011105 if (--nest == 1)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011106 pat = pat3; // outer level, search for middle
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011107 }
11108
11109 if (nest == 0)
11110 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011111 // Found the match: return matchcount or line number.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011112 if (flags & SP_RETCOUNT)
11113 ++retval;
11114 else
11115 retval = pos.lnum;
11116 if (flags & SP_SETPCMARK)
11117 setpcmark();
11118 curwin->w_cursor = pos;
11119 if (!(flags & SP_REPEAT))
11120 break;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011121 nest = 1; // search for next unmatched
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011122 }
11123 }
11124
11125 if (match_pos != NULL)
11126 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011127 // Store the match cursor position
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011128 match_pos->lnum = curwin->w_cursor.lnum;
11129 match_pos->col = curwin->w_cursor.col + 1;
11130 }
11131
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011132 // If 'n' flag is used or search failed: restore cursor position.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011133 if ((flags & SP_NOMOVE) || retval == 0)
11134 curwin->w_cursor = save_cursor;
11135
11136theend:
Bram Moolenaar5ea38d12022-06-16 21:20:48 +010011137#ifdef FEAT_RELTIME
Bram Moolenaar0f618382022-08-26 21:33:04 +010011138 if (time_limit > 0)
11139 disable_regexp_timeout();
Bram Moolenaar5ea38d12022-06-16 21:20:48 +010011140#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011141 vim_free(pat2);
11142 vim_free(pat3);
11143 if (p_cpo == empty_option)
11144 p_cpo = save_cpo;
11145 else
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010011146 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011147 // Darn, evaluating the {skip} expression changed the value.
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010011148 // If it's still empty it was changed and restored, need to restore in
11149 // the complicated way.
11150 if (*p_cpo == NUL)
Bram Moolenaar31e5c602022-04-15 13:53:33 +010011151 set_option_value_give_err((char_u *)"cpo", 0L, save_cpo, 0);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011152 free_string_option(save_cpo);
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010011153 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011154
11155 return retval;
11156}
11157
11158/*
11159 * "searchpos()" function
11160 */
11161 static void
11162f_searchpos(typval_T *argvars, typval_T *rettv)
11163{
11164 pos_T match_pos;
11165 int lnum = 0;
11166 int col = 0;
11167 int n;
11168 int flags = 0;
11169
11170 if (rettv_list_alloc(rettv) == FAIL)
11171 return;
11172
11173 n = search_cmn(argvars, &match_pos, &flags);
11174 if (n > 0)
11175 {
11176 lnum = match_pos.lnum;
11177 col = match_pos.col;
11178 }
11179
11180 list_append_number(rettv->vval.v_list, (varnumber_T)lnum);
11181 list_append_number(rettv->vval.v_list, (varnumber_T)col);
11182 if (flags & SP_SUBPAT)
11183 list_append_number(rettv->vval.v_list, (varnumber_T)n);
11184}
11185
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011186/*
11187 * Set the cursor or mark position.
zeertzjq47eec672023-06-01 20:26:55 +010011188 * If "charpos" is TRUE, then use the column number as a character offset.
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011189 * Otherwise use the column number as a byte offset.
11190 */
11191 static void
11192set_position(typval_T *argvars, typval_T *rettv, int charpos)
11193{
11194 pos_T pos;
11195 int fnum;
11196 char_u *name;
11197 colnr_T curswant = -1;
11198
11199 rettv->vval.v_number = -1;
11200
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011201 if (in_vim9script()
11202 && (check_for_string_arg(argvars, 0) == FAIL
11203 || check_for_list_arg(argvars, 1) == FAIL))
11204 return;
11205
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011206 name = tv_get_string_chk(argvars);
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011207 if (name == NULL)
11208 return;
11209
11210 if (list2fpos(&argvars[1], &pos, &fnum, &curswant, charpos) != OK)
11211 return;
11212
11213 if (pos.col != MAXCOL && --pos.col < 0)
11214 pos.col = 0;
11215 if ((name[0] == '.' && name[1] == NUL))
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011216 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011217 // set cursor; "fnum" is ignored
11218 curwin->w_cursor = pos;
11219 if (curswant >= 0)
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011220 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011221 curwin->w_curswant = curswant - 1;
11222 curwin->w_set_curswant = FALSE;
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011223 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011224 check_cursor();
11225 rettv->vval.v_number = 0;
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011226 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011227 else if (name[0] == '\'' && name[1] != NUL && name[2] == NUL)
11228 {
11229 // set mark
11230 if (setmark_pos(name[1], &pos, fnum) == OK)
11231 rettv->vval.v_number = 0;
11232 }
11233 else
11234 emsg(_(e_invalid_argument));
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011235}
11236/*
11237 * "setcharpos()" function
11238 */
11239 static void
11240f_setcharpos(typval_T *argvars, typval_T *rettv)
11241{
11242 set_position(argvars, rettv, TRUE);
11243}
11244
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011245 static void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011246f_setcharsearch(typval_T *argvars, typval_T *rettv UNUSED)
11247{
11248 dict_T *d;
11249 dictitem_T *di;
11250 char_u *csearch;
11251
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +010011252 if (check_for_dict_arg(argvars, 0) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011253 return;
11254
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011255 if ((d = argvars[0].vval.v_dict) == NULL)
11256 return;
11257
11258 csearch = dict_get_string(d, "char", FALSE);
11259 if (csearch != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011260 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011261 if (enc_utf8)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011262 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011263 int pcc[MAX_MCO];
11264 int c = utfc_ptr2char(csearch, pcc);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011265
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011266 set_last_csearch(c, csearch, utfc_ptr2len(csearch));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011267 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011268 else
11269 set_last_csearch(PTR2CHAR(csearch),
11270 csearch, mb_ptr2len(csearch));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011271 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011272
11273 di = dict_find(d, (char_u *)"forward", -1);
11274 if (di != NULL)
11275 set_csearch_direction((int)tv_get_number(&di->di_tv)
11276 ? FORWARD : BACKWARD);
11277
11278 di = dict_find(d, (char_u *)"until", -1);
11279 if (di != NULL)
11280 set_csearch_until(!!tv_get_number(&di->di_tv));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011281}
11282
11283/*
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011284 * "setcursorcharpos" function
11285 */
11286 static void
Bram Moolenaar3af15ab2021-01-17 16:16:23 +010011287f_setcursorcharpos(typval_T *argvars, typval_T *rettv)
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011288{
11289 set_cursorpos(argvars, rettv, TRUE);
11290}
11291
11292/*
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011293 * "setenv()" function
11294 */
11295 static void
11296f_setenv(typval_T *argvars, typval_T *rettv UNUSED)
11297{
11298 char_u namebuf[NUMBUFLEN];
11299 char_u valbuf[NUMBUFLEN];
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020011300 char_u *name;
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011301
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020011302 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11303 return;
11304
zeertzjqfcaeb3d2023-11-28 20:46:29 +010011305 // setting an environment variable may be dangerous, e.g. you could
Christian Brabandt6b89dd62023-10-26 22:14:17 +020011306 // setenv GCONV_PATH=/tmp and then have iconv() unexpectedly call
11307 // a shell command using some shared library:
11308 if (check_restricted() || check_secure())
11309 return;
11310
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020011311 name = tv_get_string_buf(&argvars[0], namebuf);
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011312 if (argvars[1].v_type == VAR_SPECIAL
11313 && argvars[1].vval.v_number == VVAL_NULL)
LemonBoy77142312022-04-15 20:50:46 +010011314 vim_unsetenv_ext(name);
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011315 else
LemonBoy77142312022-04-15 20:50:46 +010011316 vim_setenv_ext(name, tv_get_string_buf(&argvars[1], valbuf));
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011317}
11318
11319/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011320 * "setfperm({fname}, {mode})" function
11321 */
11322 static void
11323f_setfperm(typval_T *argvars, typval_T *rettv)
11324{
11325 char_u *fname;
11326 char_u modebuf[NUMBUFLEN];
11327 char_u *mode_str;
11328 int i;
11329 int mask;
11330 int mode = 0;
11331
11332 rettv->vval.v_number = 0;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011333
11334 if (in_vim9script()
11335 && (check_for_string_arg(argvars, 0) == FAIL
11336 || check_for_string_arg(argvars, 1) == FAIL))
11337 return;
11338
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011339 fname = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011340 if (fname == NULL)
11341 return;
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011342 mode_str = tv_get_string_buf_chk(&argvars[1], modebuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011343 if (mode_str == NULL)
11344 return;
11345 if (STRLEN(mode_str) != 9)
11346 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000011347 semsg(_(e_invalid_argument_str), mode_str);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011348 return;
11349 }
11350
11351 mask = 1;
11352 for (i = 8; i >= 0; --i)
11353 {
11354 if (mode_str[i] != '-')
11355 mode |= mask;
11356 mask = mask << 1;
11357 }
11358 rettv->vval.v_number = mch_setperm(fname, mode) == OK;
11359}
11360
11361/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011362 * "setpos()" function
11363 */
11364 static void
11365f_setpos(typval_T *argvars, typval_T *rettv)
11366{
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011367 set_position(argvars, rettv, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011368}
11369
11370/*
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011371 * Translate a register type string to the yank type and block length
11372 */
11373 static int
11374get_yank_type(char_u **pp, char_u *yank_type, long *block_len)
11375{
11376 char_u *stropt = *pp;
11377 switch (*stropt)
11378 {
11379 case 'v': case 'c': // character-wise selection
11380 *yank_type = MCHAR;
11381 break;
11382 case 'V': case 'l': // line-wise selection
11383 *yank_type = MLINE;
11384 break;
11385 case 'b': case Ctrl_V: // block-wise selection
11386 *yank_type = MBLOCK;
11387 if (VIM_ISDIGIT(stropt[1]))
11388 {
11389 ++stropt;
11390 *block_len = getdigits(&stropt) - 1;
11391 --stropt;
11392 }
11393 break;
11394 default:
11395 return FAIL;
11396 }
11397 *pp = stropt;
11398 return OK;
11399}
11400
11401/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011402 * "setreg()" function
11403 */
11404 static void
11405f_setreg(typval_T *argvars, typval_T *rettv)
11406{
11407 int regname;
11408 char_u *strregname;
11409 char_u *stropt;
11410 char_u *strval;
11411 int append;
11412 char_u yank_type;
11413 long block_len;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011414 typval_T *regcontents;
11415 int pointreg;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011416
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020011417 if (in_vim9script()
11418 && (check_for_string_arg(argvars, 0) == FAIL
11419 || check_for_opt_string_arg(argvars, 2) == FAIL))
11420 return;
11421
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011422 pointreg = 0;
11423 regcontents = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011424 block_len = -1;
11425 yank_type = MAUTO;
11426 append = FALSE;
11427
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011428 strregname = tv_get_string_chk(argvars);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011429 rettv->vval.v_number = 1; // FAIL is default
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011430
11431 if (strregname == NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011432 return; // type error; errmsg already given
Bram Moolenaar418a29f2021-02-10 22:23:41 +010011433 if (in_vim9script() && STRLEN(strregname) > 1)
11434 {
11435 semsg(_(e_register_name_must_be_one_char_str), strregname);
11436 return;
11437 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011438 regname = *strregname;
11439 if (regname == 0 || regname == '@')
11440 regname = '"';
11441
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011442 if (argvars[1].v_type == VAR_DICT)
11443 {
11444 dict_T *d = argvars[1].vval.v_dict;
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011445 dictitem_T *di;
11446
11447 if (d == NULL || d->dv_hashtab.ht_used == 0)
11448 {
11449 // Empty dict, clear the register (like setreg(0, []))
11450 char_u *lstval[2] = {NULL, NULL};
11451 write_reg_contents_lst(regname, lstval, 0, FALSE, MAUTO, -1);
11452 return;
11453 }
11454
11455 di = dict_find(d, (char_u *)"regcontents", -1);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011456 if (di != NULL)
11457 regcontents = &di->di_tv;
11458
Bram Moolenaard61efa52022-07-23 09:52:04 +010011459 stropt = dict_get_string(d, "regtype", FALSE);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011460 if (stropt != NULL)
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011461 {
11462 int ret = get_yank_type(&stropt, &yank_type, &block_len);
11463
11464 if (ret == FAIL || *++stropt != NUL)
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011465 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000011466 semsg(_(e_invalid_value_for_argument_str), "value");
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011467 return;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011468 }
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011469 }
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011470
11471 if (regname == '"')
11472 {
Bram Moolenaard61efa52022-07-23 09:52:04 +010011473 stropt = dict_get_string(d, "points_to", FALSE);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011474 if (stropt != NULL)
11475 {
11476 pointreg = *stropt;
11477 regname = pointreg;
11478 }
11479 }
Bram Moolenaard61efa52022-07-23 09:52:04 +010011480 else if (dict_get_bool(d, "isunnamed", -1) > 0)
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011481 pointreg = regname;
11482 }
11483 else
11484 regcontents = &argvars[1];
11485
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011486 if (argvars[2].v_type != VAR_UNKNOWN)
11487 {
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011488 if (yank_type != MAUTO)
11489 {
Bram Moolenaare1242042021-12-16 20:56:57 +000011490 semsg(_(e_too_many_arguments_for_function_str), "setreg");
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011491 return;
11492 }
11493
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011494 stropt = tv_get_string_chk(&argvars[2]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011495 if (stropt == NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011496 return; // type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011497 for (; *stropt != NUL; ++stropt)
11498 switch (*stropt)
11499 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011500 case 'a': case 'A': // append
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011501 append = TRUE;
11502 break;
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011503 default:
11504 get_yank_type(&stropt, &yank_type, &block_len);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011505 }
11506 }
11507
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011508 if (regcontents && regcontents->v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011509 {
11510 char_u **lstval;
11511 char_u **allocval;
11512 char_u buf[NUMBUFLEN];
11513 char_u **curval;
11514 char_u **curallocval;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011515 list_T *ll = regcontents->vval.v_list;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011516 listitem_T *li;
11517 int len;
11518
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011519 // If the list is NULL handle like an empty list.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011520 len = ll == NULL ? 0 : ll->lv_len;
11521
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011522 // First half: use for pointers to result lines; second half: use for
11523 // pointers to allocated copies.
Bram Moolenaarc799fe22019-05-28 23:08:19 +020011524 lstval = ALLOC_MULT(char_u *, (len + 1) * 2);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011525 if (lstval == NULL)
11526 return;
11527 curval = lstval;
11528 allocval = lstval + len + 2;
11529 curallocval = allocval;
11530
Bram Moolenaar50985eb2020-01-27 22:09:39 +010011531 if (ll != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011532 {
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020011533 CHECK_LIST_MATERIALIZE(ll);
Bram Moolenaar00d253e2020-04-06 22:13:01 +020011534 FOR_ALL_LIST_ITEMS(ll, li)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011535 {
Bram Moolenaar50985eb2020-01-27 22:09:39 +010011536 strval = tv_get_string_buf_chk(&li->li_tv, buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011537 if (strval == NULL)
11538 goto free_lstval;
Bram Moolenaar50985eb2020-01-27 22:09:39 +010011539 if (strval == buf)
11540 {
11541 // Need to make a copy, next tv_get_string_buf_chk() will
11542 // overwrite the string.
11543 strval = vim_strsave(buf);
11544 if (strval == NULL)
11545 goto free_lstval;
11546 *curallocval++ = strval;
11547 }
11548 *curval++ = strval;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011549 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011550 }
11551 *curval++ = NULL;
11552
11553 write_reg_contents_lst(regname, lstval, -1,
11554 append, yank_type, block_len);
11555free_lstval:
11556 while (curallocval > allocval)
11557 vim_free(*--curallocval);
11558 vim_free(lstval);
11559 }
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011560 else if (regcontents)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011561 {
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011562 strval = tv_get_string_chk(regcontents);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011563 if (strval == NULL)
11564 return;
11565 write_reg_contents_ex(regname, strval, -1,
11566 append, yank_type, block_len);
11567 }
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011568 if (pointreg != 0)
11569 get_yank_register(pointreg, TRUE);
11570
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011571 rettv->vval.v_number = 0;
11572}
11573
11574/*
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011575 * "settagstack()" function
11576 */
11577 static void
11578f_settagstack(typval_T *argvars, typval_T *rettv)
11579{
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011580 win_T *wp;
11581 dict_T *d;
11582 int action = 'r';
11583
11584 rettv->vval.v_number = -1;
11585
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011586 if (in_vim9script()
11587 && (check_for_number_arg(argvars, 0) == FAIL
11588 || check_for_dict_arg(argvars, 1) == FAIL
11589 || check_for_opt_string_arg(argvars, 2) == FAIL))
11590 return;
11591
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011592 // first argument: window number or id
11593 wp = find_win_by_nr_or_id(&argvars[0]);
11594 if (wp == NULL)
11595 return;
11596
11597 // second argument: dict with items to set in the tag stack
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +010011598 if (check_for_dict_arg(argvars, 1) == FAIL)
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011599 return;
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011600 d = argvars[1].vval.v_dict;
11601 if (d == NULL)
11602 return;
11603
11604 // third argument: action - 'a' for append and 'r' for replace.
11605 // default is to replace the stack.
11606 if (argvars[2].v_type == VAR_UNKNOWN)
11607 action = 'r';
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +010011608 else if (check_for_string_arg(argvars, 2) == FAIL)
11609 return;
11610 else
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011611 {
11612 char_u *actstr;
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011613 actstr = tv_get_string_chk(&argvars[2]);
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011614 if (actstr == NULL)
11615 return;
Bram Moolenaar271fa082020-01-02 14:02:16 +010011616 if ((*actstr == 'r' || *actstr == 'a' || *actstr == 't')
11617 && actstr[1] == NUL)
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011618 action = *actstr;
11619 else
11620 {
Bram Moolenaard82a47d2022-01-05 20:24:39 +000011621 semsg(_(e_invalid_action_str_2), actstr);
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011622 return;
11623 }
11624 }
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011625
11626 if (set_tagstack(wp, d, action) == OK)
11627 rettv->vval.v_number = 0;
11628}
11629
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011630#ifdef FEAT_CRYPT
11631/*
11632 * "sha256({string})" function
11633 */
11634 static void
11635f_sha256(typval_T *argvars, typval_T *rettv)
11636{
11637 char_u *p;
11638
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011639 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11640 return;
11641
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011642 p = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011643 rettv->vval.v_string = vim_strsave(
11644 sha256_bytes(p, (int)STRLEN(p), NULL, 0));
11645 rettv->v_type = VAR_STRING;
11646}
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011647#endif // FEAT_CRYPT
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011648
11649/*
11650 * "shellescape({string})" function
11651 */
11652 static void
11653f_shellescape(typval_T *argvars, typval_T *rettv)
11654{
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011655 int do_special;
Bram Moolenaar20615522017-06-05 18:46:26 +020011656
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011657 if (in_vim9script()
11658 && (check_for_string_arg(argvars, 0) == FAIL
11659 || check_for_opt_bool_arg(argvars, 1) == FAIL))
11660 return;
11661
11662 do_special = non_zero_arg(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011663 rettv->vval.v_string = vim_strsave_shellescape(
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011664 tv_get_string(&argvars[0]), do_special, do_special);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011665 rettv->v_type = VAR_STRING;
11666}
11667
11668/*
11669 * shiftwidth() function
11670 */
11671 static void
11672f_shiftwidth(typval_T *argvars UNUSED, typval_T *rettv)
11673{
Bram Moolenaarf9514162018-11-22 03:08:29 +010011674 rettv->vval.v_number = 0;
11675
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011676 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
11677 return;
11678
Bram Moolenaarf9514162018-11-22 03:08:29 +010011679 if (argvars[0].v_type != VAR_UNKNOWN)
11680 {
11681 long col;
11682
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011683 col = (long)tv_get_number_chk(argvars, NULL);
Bram Moolenaarf9514162018-11-22 03:08:29 +010011684 if (col < 0)
11685 return; // type error; errmsg already given
11686#ifdef FEAT_VARTABS
Gary Johnson88d4f252024-06-01 20:51:33 +020011687 rettv->vval.v_number = get_sw_value_col(curbuf, col, FALSE);
Bram Moolenaarf9514162018-11-22 03:08:29 +010011688 return;
11689#endif
11690 }
11691
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011692 rettv->vval.v_number = get_sw_value(curbuf);
11693}
11694
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011695/*
11696 * "soundfold({word})" function
11697 */
11698 static void
11699f_soundfold(typval_T *argvars, typval_T *rettv)
11700{
11701 char_u *s;
11702
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011703 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11704 return;
11705
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011706 rettv->v_type = VAR_STRING;
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011707 s = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011708#ifdef FEAT_SPELL
11709 rettv->vval.v_string = eval_soundfold(s);
11710#else
11711 rettv->vval.v_string = vim_strsave(s);
11712#endif
11713}
11714
11715/*
11716 * "spellbadword()" function
11717 */
11718 static void
11719f_spellbadword(typval_T *argvars UNUSED, typval_T *rettv)
11720{
11721 char_u *word = (char_u *)"";
11722 hlf_T attr = HLF_COUNT;
11723 int len = 0;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011724#ifdef FEAT_SPELL
11725 int wo_spell_save = curwin->w_p_spell;
11726
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011727 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
11728 return;
11729
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011730 if (!curwin->w_p_spell)
11731 {
Yegappan Lakshmananaf936912023-02-20 12:16:39 +000011732 parse_spelllang(curwin);
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011733 curwin->w_p_spell = TRUE;
11734 }
11735
11736 if (*curwin->w_s->b_p_spl == NUL)
11737 {
Bram Moolenaar460ae5d2022-01-01 14:19:49 +000011738 emsg(_(e_spell_checking_is_not_possible));
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011739 curwin->w_p_spell = wo_spell_save;
11740 return;
11741 }
11742#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011743
11744 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011745 {
11746#ifdef FEAT_SPELL
11747 curwin->w_p_spell = wo_spell_save;
11748#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011749 return;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011750 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011751
11752#ifdef FEAT_SPELL
11753 if (argvars[0].v_type == VAR_UNKNOWN)
11754 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011755 // Find the start and length of the badly spelled word.
Christ van Willegen - van Noort8e4c4c72024-05-17 18:49:27 +020011756 len = spell_move_to(curwin, FORWARD, SMT_ALL, TRUE, &attr);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011757 if (len != 0)
Bram Moolenaarb73fa622017-12-21 20:27:47 +010011758 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011759 word = ml_get_cursor();
Bram Moolenaarb73fa622017-12-21 20:27:47 +010011760 curwin->w_set_curswant = TRUE;
11761 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011762 }
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011763 else if (*curbuf->b_s.b_p_spl != NUL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011764 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011765 char_u *str = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011766 int capcol = -1;
11767
11768 if (str != NULL)
11769 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011770 // Check the argument for spelling.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011771 while (*str != NUL)
11772 {
11773 len = spell_check(curwin, str, &attr, &capcol, FALSE);
11774 if (attr != HLF_COUNT)
11775 {
11776 word = str;
11777 break;
11778 }
11779 str += len;
Bram Moolenaar66ab9162018-07-20 20:28:48 +020011780 capcol -= len;
Bram Moolenaar0c779e82019-08-09 17:01:02 +020011781 len = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011782 }
11783 }
11784 }
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011785 curwin->w_p_spell = wo_spell_save;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011786#endif
11787
11788 list_append_string(rettv->vval.v_list, word, len);
11789 list_append_string(rettv->vval.v_list, (char_u *)(
11790 attr == HLF_SPB ? "bad" :
11791 attr == HLF_SPR ? "rare" :
11792 attr == HLF_SPL ? "local" :
11793 attr == HLF_SPC ? "caps" :
11794 ""), -1);
11795}
11796
11797/*
11798 * "spellsuggest()" function
11799 */
11800 static void
11801f_spellsuggest(typval_T *argvars UNUSED, typval_T *rettv)
11802{
11803#ifdef FEAT_SPELL
11804 char_u *str;
11805 int typeerr = FALSE;
11806 int maxcount;
11807 garray_T ga;
11808 int i;
11809 listitem_T *li;
11810 int need_capital = FALSE;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011811 int wo_spell_save = curwin->w_p_spell;
11812
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011813 if (in_vim9script()
11814 && (check_for_string_arg(argvars, 0) == FAIL
11815 || check_for_opt_number_arg(argvars, 1) == FAIL
11816 || (argvars[1].v_type != VAR_UNKNOWN
11817 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
11818 return;
11819
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011820 if (!curwin->w_p_spell)
11821 {
Yegappan Lakshmananaf936912023-02-20 12:16:39 +000011822 parse_spelllang(curwin);
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011823 curwin->w_p_spell = TRUE;
11824 }
11825
11826 if (*curwin->w_s->b_p_spl == NUL)
11827 {
Bram Moolenaar460ae5d2022-01-01 14:19:49 +000011828 emsg(_(e_spell_checking_is_not_possible));
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011829 curwin->w_p_spell = wo_spell_save;
11830 return;
11831 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011832#endif
11833
11834 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011835 {
11836#ifdef FEAT_SPELL
11837 curwin->w_p_spell = wo_spell_save;
11838#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011839 return;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011840 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011841
11842#ifdef FEAT_SPELL
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011843 str = tv_get_string(&argvars[0]);
11844 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011845 {
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011846 maxcount = (int)tv_get_number_chk(&argvars[1], &typeerr);
11847 if (maxcount <= 0)
11848 return;
11849 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011850 {
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011851 need_capital = (int)tv_get_bool_chk(&argvars[2], &typeerr);
11852 if (typeerr)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011853 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011854 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011855 }
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011856 else
11857 maxcount = 25;
11858
11859 spell_suggest_list(&ga, str, maxcount, need_capital, FALSE);
11860
11861 for (i = 0; i < ga.ga_len; ++i)
11862 {
11863 str = ((char_u **)ga.ga_data)[i];
11864
11865 li = listitem_alloc();
11866 if (li == NULL)
11867 vim_free(str);
11868 else
11869 {
11870 li->li_tv.v_type = VAR_STRING;
11871 li->li_tv.v_lock = 0;
11872 li->li_tv.vval.v_string = str;
11873 list_append(rettv->vval.v_list, li);
11874 }
11875 }
11876 ga_clear(&ga);
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011877 curwin->w_p_spell = wo_spell_save;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011878#endif
11879}
11880
11881 static void
11882f_split(typval_T *argvars, typval_T *rettv)
11883{
11884 char_u *str;
11885 char_u *end;
11886 char_u *pat = NULL;
11887 regmatch_T regmatch;
11888 char_u patbuf[NUMBUFLEN];
11889 char_u *save_cpo;
11890 int match;
11891 colnr_T col = 0;
11892 int keepempty = FALSE;
11893 int typeerr = FALSE;
11894
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011895 if (in_vim9script()
11896 && (check_for_string_arg(argvars, 0) == FAIL
11897 || check_for_opt_string_arg(argvars, 1) == FAIL
11898 || (argvars[1].v_type != VAR_UNKNOWN
11899 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
11900 return;
11901
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011902 // Make 'cpoptions' empty, the 'l' flag should not be used here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011903 save_cpo = p_cpo;
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010011904 p_cpo = empty_option;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011905
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011906 str = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011907 if (argvars[1].v_type != VAR_UNKNOWN)
11908 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011909 pat = tv_get_string_buf_chk(&argvars[1], patbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011910 if (pat == NULL)
11911 typeerr = TRUE;
11912 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar3986b942020-09-06 16:09:04 +020011913 keepempty = (int)tv_get_bool_chk(&argvars[2], &typeerr);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011914 }
11915 if (pat == NULL || *pat == NUL)
11916 pat = (char_u *)"[\\x01- ]\\+";
11917
11918 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar7d5e7442020-07-21 22:25:51 +020011919 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011920 if (typeerr)
Bram Moolenaar7d5e7442020-07-21 22:25:51 +020011921 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011922
11923 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
11924 if (regmatch.regprog != NULL)
11925 {
11926 regmatch.rm_ic = FALSE;
11927 while (*str != NUL || keepempty)
11928 {
11929 if (*str == NUL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011930 match = FALSE; // empty item at the end
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011931 else
11932 match = vim_regexec_nl(&regmatch, str, col);
11933 if (match)
11934 end = regmatch.startp[0];
11935 else
11936 end = str + STRLEN(str);
11937 if (keepempty || end > str || (rettv->vval.v_list->lv_len > 0
11938 && *str != NUL && match && end < regmatch.endp[0]))
11939 {
11940 if (list_append_string(rettv->vval.v_list, str,
11941 (int)(end - str)) == FAIL)
11942 break;
11943 }
11944 if (!match)
11945 break;
Bram Moolenaar13505972019-01-24 15:04:48 +010011946 // Advance to just after the match.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011947 if (regmatch.endp[0] > str)
11948 col = 0;
11949 else
Bram Moolenaar13505972019-01-24 15:04:48 +010011950 // Don't get stuck at the same match.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011951 col = (*mb_ptr2len)(regmatch.endp[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011952 str = regmatch.endp[0];
11953 }
11954
11955 vim_regfree(regmatch.regprog);
11956 }
11957
Bram Moolenaar7d5e7442020-07-21 22:25:51 +020011958theend:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011959 p_cpo = save_cpo;
11960}
11961
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011962/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011963 * "submatch()" function
11964 */
11965 static void
11966f_submatch(typval_T *argvars, typval_T *rettv)
11967{
11968 int error = FALSE;
11969 int no;
11970 int retList = 0;
11971
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011972 if (in_vim9script()
11973 && (check_for_number_arg(argvars, 0) == FAIL
11974 || check_for_opt_bool_arg(argvars, 1) == FAIL))
11975 return;
11976
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011977 no = (int)tv_get_number_chk(&argvars[0], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011978 if (error)
11979 return;
Bram Moolenaar989f5922016-08-21 15:26:54 +020011980 if (no < 0 || no >= NSUBEXP)
11981 {
Bram Moolenaard82a47d2022-01-05 20:24:39 +000011982 semsg(_(e_invalid_submatch_number_nr), no);
Bram Moolenaar79518e22017-02-17 16:31:35 +010011983 return;
Bram Moolenaar989f5922016-08-21 15:26:54 +020011984 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011985 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaarad304702020-09-06 18:22:53 +020011986 retList = (int)tv_get_bool_chk(&argvars[1], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011987 if (error)
11988 return;
11989
11990 if (retList == 0)
11991 {
11992 rettv->v_type = VAR_STRING;
11993 rettv->vval.v_string = reg_submatch(no);
11994 }
11995 else
11996 {
11997 rettv->v_type = VAR_LIST;
11998 rettv->vval.v_list = reg_submatch_list(no);
11999 }
12000}
12001
12002/*
12003 * "substitute()" function
12004 */
12005 static void
12006f_substitute(typval_T *argvars, typval_T *rettv)
12007{
12008 char_u patbuf[NUMBUFLEN];
12009 char_u subbuf[NUMBUFLEN];
12010 char_u flagsbuf[NUMBUFLEN];
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +020012011 char_u *str;
12012 char_u *pat;
Bram Moolenaar72ab7292016-07-19 19:10:51 +020012013 char_u *sub = NULL;
12014 typval_T *expr = NULL;
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +020012015 char_u *flg;
12016
12017 if (in_vim9script()
12018 && (check_for_string_arg(argvars, 0) == FAIL
12019 || check_for_string_arg(argvars, 1) == FAIL
12020 || check_for_string_arg(argvars, 3) == FAIL))
12021 return;
12022
12023 str = tv_get_string_chk(&argvars[0]);
12024 pat = tv_get_string_buf_chk(&argvars[1], patbuf);
12025 flg = tv_get_string_buf_chk(&argvars[3], flagsbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012026
LemonBoyf3b48952022-05-05 13:53:03 +010012027 if (argvars[2].v_type == VAR_FUNC
12028 || argvars[2].v_type == VAR_PARTIAL
Bram Moolenaar00b28d62022-12-08 15:32:33 +000012029 || argvars[2].v_type == VAR_INSTR
12030 || argvars[2].v_type == VAR_CLASS
12031 || argvars[2].v_type == VAR_OBJECT)
Bram Moolenaar72ab7292016-07-19 19:10:51 +020012032 expr = &argvars[2];
12033 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012034 sub = tv_get_string_buf_chk(&argvars[2], subbuf);
Bram Moolenaar72ab7292016-07-19 19:10:51 +020012035
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012036 rettv->v_type = VAR_STRING;
Bram Moolenaar72ab7292016-07-19 19:10:51 +020012037 if (str == NULL || pat == NULL || (sub == NULL && expr == NULL)
12038 || flg == NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012039 rettv->vval.v_string = NULL;
12040 else
John Marriottbd4614f2024-11-18 20:25:21 +010012041 rettv->vval.v_string = do_string_sub(str, STRLEN(str), pat, sub, expr, flg, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012042}
12043
12044/*
Bram Moolenaarc216a7a2022-12-05 13:50:55 +000012045 * "swapfilelist()" function
12046 */
12047 static void
12048f_swapfilelist(typval_T *argvars UNUSED, typval_T *rettv)
12049{
12050 if (rettv_list_alloc(rettv) == FAIL)
12051 return;
12052 recover_names(NULL, FALSE, rettv->vval.v_list, 0, NULL);
12053}
12054
12055/*
Bram Moolenaar00f123a2018-08-21 20:28:54 +020012056 * "swapinfo(swap_filename)" function
12057 */
12058 static void
12059f_swapinfo(typval_T *argvars, typval_T *rettv)
12060{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012061 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
12062 return;
12063
Bram Moolenaar00f123a2018-08-21 20:28:54 +020012064 if (rettv_dict_alloc(rettv) == OK)
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012065 get_b0_dict(tv_get_string(argvars), rettv->vval.v_dict);
Bram Moolenaar00f123a2018-08-21 20:28:54 +020012066}
12067
12068/*
Bram Moolenaar110bd602018-09-16 18:46:59 +020012069 * "swapname(expr)" function
12070 */
12071 static void
12072f_swapname(typval_T *argvars, typval_T *rettv)
12073{
12074 buf_T *buf;
12075
12076 rettv->v_type = VAR_STRING;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012077
12078 if (in_vim9script() && check_for_buffer_arg(argvars, 0) == FAIL)
12079 return;
12080
Bram Moolenaarf2d79fa2019-01-03 22:19:27 +010012081 buf = tv_get_buf(&argvars[0], FALSE);
Bram Moolenaar110bd602018-09-16 18:46:59 +020012082 if (buf == NULL || buf->b_ml.ml_mfp == NULL
12083 || buf->b_ml.ml_mfp->mf_fname == NULL)
12084 rettv->vval.v_string = NULL;
12085 else
12086 rettv->vval.v_string = vim_strsave(buf->b_ml.ml_mfp->mf_fname);
12087}
12088
12089/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012090 * "synID(lnum, col, trans)" function
12091 */
12092 static void
12093f_synID(typval_T *argvars UNUSED, typval_T *rettv)
12094{
12095 int id = 0;
12096#ifdef FEAT_SYN_HL
12097 linenr_T lnum;
12098 colnr_T col;
12099 int trans;
12100 int transerr = FALSE;
12101
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020012102 if (in_vim9script()
Yegappan Lakshmanancd917202021-07-21 19:09:09 +020012103 && (check_for_lnum_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020012104 || check_for_number_arg(argvars, 1) == FAIL
12105 || check_for_bool_arg(argvars, 2) == FAIL))
12106 return;
12107
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012108 lnum = tv_get_lnum(argvars); // -1 on type error
12109 col = (linenr_T)tv_get_number(&argvars[1]) - 1; // -1 on type error
Bram Moolenaarfcb6d702020-09-05 21:41:56 +020012110 trans = (int)tv_get_bool_chk(&argvars[2], &transerr);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012111
12112 if (!transerr && lnum >= 1 && lnum <= curbuf->b_ml.ml_line_count
John Marriottbfcc8952024-03-11 22:04:45 +010012113 && col >= 0 && col < (long)ml_get_len(lnum))
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +000012114 id = syn_get_id(curwin, lnum, col, trans, NULL, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012115#endif
12116
12117 rettv->vval.v_number = id;
12118}
12119
12120/*
12121 * "synIDattr(id, what [, mode])" function
12122 */
12123 static void
12124f_synIDattr(typval_T *argvars UNUSED, typval_T *rettv)
12125{
12126 char_u *p = NULL;
12127#ifdef FEAT_SYN_HL
12128 int id;
12129 char_u *what;
12130 char_u *mode;
12131 char_u modebuf[NUMBUFLEN];
12132 int modec;
12133
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +020012134 if (in_vim9script()
12135 && (check_for_number_arg(argvars, 0) == FAIL
Yegappan Lakshmananf8dbd582021-09-26 19:04:05 +010012136 || check_for_string_arg(argvars, 1) == FAIL
12137 || check_for_opt_string_arg(argvars, 2) == FAIL))
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +020012138 return;
12139
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012140 id = (int)tv_get_number(&argvars[0]);
12141 what = tv_get_string(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012142 if (argvars[2].v_type != VAR_UNKNOWN)
12143 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012144 mode = tv_get_string_buf(&argvars[2], modebuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012145 modec = TOLOWER_ASC(mode[0]);
12146 if (modec != 't' && modec != 'c' && modec != 'g')
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012147 modec = 0; // replace invalid with current
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012148 }
12149 else
12150 {
12151#if defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS)
12152 if (USE_24BIT)
12153 modec = 'g';
12154 else
12155#endif
12156 if (t_colors > 1)
Dominique Pelle4781d6f2021-05-18 21:46:31 +020012157 modec = 'c';
12158 else
12159 modec = 't';
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012160 }
12161
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012162 switch (TOLOWER_ASC(what[0]))
12163 {
12164 case 'b':
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012165 if (TOLOWER_ASC(what[1]) == 'g') // bg[#]
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012166 p = highlight_color(id, what, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012167 else // bold
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012168 p = highlight_has_attr(id, HL_BOLD, modec);
12169 break;
12170
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012171 case 'f': // fg[#] or font
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012172 p = highlight_color(id, what, modec);
12173 break;
12174
12175 case 'i':
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012176 if (TOLOWER_ASC(what[1]) == 'n') // inverse
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012177 p = highlight_has_attr(id, HL_INVERSE, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012178 else // italic
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012179 p = highlight_has_attr(id, HL_ITALIC, modec);
12180 break;
12181
Martin Tournoijba43e762022-10-13 22:12:15 +010012182 case 'n':
Bram Moolenaarde786322022-07-30 14:56:17 +010012183 if (TOLOWER_ASC(what[1]) == 'o') // nocombine
12184 p = highlight_has_attr(id, HL_NOCOMBINE, modec);
12185 else // name
12186 p = get_highlight_name_ext(NULL, id - 1, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012187 break;
12188
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012189 case 'r': // reverse
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012190 p = highlight_has_attr(id, HL_INVERSE, modec);
12191 break;
12192
12193 case 's':
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012194 if (TOLOWER_ASC(what[1]) == 'p') // sp[#]
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012195 p = highlight_color(id, what, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012196 // strikeout
Bram Moolenaarcf4b00c2017-09-02 18:33:56 +020012197 else if (TOLOWER_ASC(what[1]) == 't' &&
12198 TOLOWER_ASC(what[2]) == 'r')
12199 p = highlight_has_attr(id, HL_STRIKETHROUGH, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012200 else // standout
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012201 p = highlight_has_attr(id, HL_STANDOUT, modec);
12202 break;
12203
12204 case 'u':
Bram Moolenaar84f54632022-06-29 18:39:11 +010012205 if (STRLEN(what) >= 9)
12206 {
12207 if (TOLOWER_ASC(what[5]) == 'l')
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012208 // underline
Bram Moolenaar84f54632022-06-29 18:39:11 +010012209 p = highlight_has_attr(id, HL_UNDERLINE, modec);
12210 else if (TOLOWER_ASC(what[5]) != 'd')
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012211 // undercurl
Bram Moolenaar84f54632022-06-29 18:39:11 +010012212 p = highlight_has_attr(id, HL_UNDERCURL, modec);
12213 else if (TOLOWER_ASC(what[6]) != 'o')
12214 // underdashed
12215 p = highlight_has_attr(id, HL_UNDERDASHED, modec);
12216 else if (TOLOWER_ASC(what[7]) == 'u')
12217 // underdouble
12218 p = highlight_has_attr(id, HL_UNDERDOUBLE, modec);
12219 else
12220 // underdotted
12221 p = highlight_has_attr(id, HL_UNDERDOTTED, modec);
12222 }
12223 else
12224 // ul
12225 p = highlight_color(id, what, modec);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012226 break;
12227 }
12228
12229 if (p != NULL)
12230 p = vim_strsave(p);
12231#endif
12232 rettv->v_type = VAR_STRING;
12233 rettv->vval.v_string = p;
12234}
12235
12236/*
12237 * "synIDtrans(id)" function
12238 */
12239 static void
12240f_synIDtrans(typval_T *argvars UNUSED, typval_T *rettv)
12241{
12242 int id;
12243
12244#ifdef FEAT_SYN_HL
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012245 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
12246 return;
12247
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012248 id = (int)tv_get_number(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012249
12250 if (id > 0)
12251 id = syn_get_final_id(id);
12252 else
12253#endif
12254 id = 0;
12255
12256 rettv->vval.v_number = id;
12257}
12258
12259/*
12260 * "synconcealed(lnum, col)" function
12261 */
12262 static void
12263f_synconcealed(typval_T *argvars UNUSED, typval_T *rettv)
12264{
12265#if defined(FEAT_SYN_HL) && defined(FEAT_CONCEAL)
12266 linenr_T lnum;
12267 colnr_T col;
12268 int syntax_flags = 0;
12269 int cchar;
12270 int matchid = 0;
12271 char_u str[NUMBUFLEN];
12272#endif
12273
Bram Moolenaar45cf6e92017-04-30 20:25:19 +020012274 rettv_list_set(rettv, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012275
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020012276 if (in_vim9script()
Yegappan Lakshmanancd917202021-07-21 19:09:09 +020012277 && (check_for_lnum_arg(argvars, 0) == FAIL
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020012278 || check_for_number_arg(argvars, 1) == FAIL))
12279 return;
12280
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012281#if defined(FEAT_SYN_HL) && defined(FEAT_CONCEAL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012282 lnum = tv_get_lnum(argvars); // -1 on type error
12283 col = (colnr_T)tv_get_number(&argvars[1]) - 1; // -1 on type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012284
Bram Moolenaara80faa82020-04-12 19:37:17 +020012285 CLEAR_FIELD(str);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012286
Bram Moolenaar93a10962022-06-16 11:42:09 +010012287 if (rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012288 {
12289 if (lnum >= 1 && lnum <= curbuf->b_ml.ml_line_count
John Marriottbfcc8952024-03-11 22:04:45 +010012290 && col >= 0 && col <= (long)ml_get_len(lnum)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012291 && curwin->w_p_cole > 0)
12292 {
12293 (void)syn_get_id(curwin, lnum, col, FALSE, NULL, FALSE);
12294 syntax_flags = get_syntax_info(&matchid);
12295
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012296 // get the conceal character
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012297 if ((syntax_flags & HL_CONCEAL) && curwin->w_p_cole < 3)
12298 {
12299 cchar = syn_get_sub_char();
Bram Moolenaar4d785892017-06-22 22:00:50 +020012300 if (cchar == NUL && curwin->w_p_cole == 1)
Bram Moolenaareed9d462021-02-15 20:38:25 +010012301 cchar = (curwin->w_lcs_chars.conceal == NUL) ? ' '
12302 : curwin->w_lcs_chars.conceal;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012303 if (cchar != NUL)
12304 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012305 if (has_mbyte)
12306 (*mb_char2bytes)(cchar, str);
12307 else
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012308 str[0] = cchar;
12309 }
12310 }
12311 }
12312
12313 list_append_number(rettv->vval.v_list,
12314 (syntax_flags & HL_CONCEAL) != 0);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012315 // -1 to auto-determine strlen
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012316 list_append_string(rettv->vval.v_list, str, -1);
12317 list_append_number(rettv->vval.v_list, matchid);
12318 }
12319#endif
12320}
12321
12322/*
12323 * "synstack(lnum, col)" function
12324 */
12325 static void
12326f_synstack(typval_T *argvars UNUSED, typval_T *rettv)
12327{
12328#ifdef FEAT_SYN_HL
12329 linenr_T lnum;
12330 colnr_T col;
12331 int i;
12332 int id;
12333#endif
12334
Bram Moolenaar45cf6e92017-04-30 20:25:19 +020012335 rettv_list_set(rettv, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012336
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020012337 if (in_vim9script()
Yegappan Lakshmanancd917202021-07-21 19:09:09 +020012338 && (check_for_lnum_arg(argvars, 0) == FAIL
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020012339 || check_for_number_arg(argvars, 1) == FAIL))
12340 return;
12341
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012342#ifdef FEAT_SYN_HL
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012343 lnum = tv_get_lnum(argvars); // -1 on type error
12344 col = (colnr_T)tv_get_number(&argvars[1]) - 1; // -1 on type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012345
12346 if (lnum >= 1 && lnum <= curbuf->b_ml.ml_line_count
John Marriottbfcc8952024-03-11 22:04:45 +010012347 && col >= 0 && col <= (long)ml_get_len(lnum)
Bram Moolenaar93a10962022-06-16 11:42:09 +010012348 && rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012349 {
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +000012350 (void)syn_get_id(curwin, lnum, col, FALSE, NULL, TRUE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012351 for (i = 0; ; ++i)
12352 {
12353 id = syn_get_stack_item(i);
12354 if (id < 0)
12355 break;
12356 if (list_append_number(rettv->vval.v_list, id) == FAIL)
12357 break;
12358 }
12359 }
12360#endif
12361}
12362
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012363/*
12364 * "tabpagebuflist()" function
12365 */
12366 static void
12367f_tabpagebuflist(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
12368{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012369 tabpage_T *tp;
12370 win_T *wp = NULL;
12371
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012372 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
12373 return;
12374
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012375 if (argvars[0].v_type == VAR_UNKNOWN)
12376 wp = firstwin;
12377 else
12378 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012379 tp = find_tabpage((int)tv_get_number(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012380 if (tp != NULL)
12381 wp = (tp == curtab) ? firstwin : tp->tp_firstwin;
12382 }
Bram Moolenaar93a10962022-06-16 11:42:09 +010012383 if (wp != NULL && rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012384 {
12385 for (; wp != NULL; wp = wp->w_next)
12386 if (list_append_number(rettv->vval.v_list,
12387 wp->w_buffer->b_fnum) == FAIL)
12388 break;
12389 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012390}
12391
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012392/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012393 * "tagfiles()" function
12394 */
12395 static void
12396f_tagfiles(typval_T *argvars UNUSED, typval_T *rettv)
12397{
12398 char_u *fname;
12399 tagname_T tn;
12400 int first;
12401
12402 if (rettv_list_alloc(rettv) == FAIL)
12403 return;
12404 fname = alloc(MAXPATHL);
12405 if (fname == NULL)
12406 return;
12407
12408 for (first = TRUE; ; first = FALSE)
12409 if (get_tagfname(&tn, first, fname) == FAIL
12410 || list_append_string(rettv->vval.v_list, fname, -1) == FAIL)
12411 break;
12412 tagname_free(&tn);
12413 vim_free(fname);
12414}
12415
12416/*
12417 * "taglist()" function
12418 */
12419 static void
12420f_taglist(typval_T *argvars, typval_T *rettv)
12421{
Bram Moolenaarc6aafba2017-03-21 17:09:10 +010012422 char_u *fname = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012423 char_u *tag_pattern;
12424
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012425 if (in_vim9script()
12426 && (check_for_string_arg(argvars, 0) == FAIL
12427 || check_for_opt_string_arg(argvars, 1) == FAIL))
12428 return;
12429
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012430 tag_pattern = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012431
12432 rettv->vval.v_number = FALSE;
12433 if (*tag_pattern == NUL)
12434 return;
12435
Bram Moolenaarc6aafba2017-03-21 17:09:10 +010012436 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012437 fname = tv_get_string(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012438 if (rettv_list_alloc(rettv) == OK)
Bram Moolenaarc6aafba2017-03-21 17:09:10 +010012439 (void)get_tags(rettv->vval.v_list, tag_pattern, fname);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012440}
12441
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012442/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012443 * "type(expr)" function
12444 */
12445 static void
12446f_type(typval_T *argvars, typval_T *rettv)
12447{
12448 int n = -1;
12449
12450 switch (argvars[0].v_type)
12451 {
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +010012452 case VAR_NUMBER: n = VAR_TYPE_NUMBER; break;
12453 case VAR_STRING: n = VAR_TYPE_STRING; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012454 case VAR_PARTIAL:
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +010012455 case VAR_FUNC: n = VAR_TYPE_FUNC; break;
12456 case VAR_LIST: n = VAR_TYPE_LIST; break;
Yegappan Lakshmanan9cb865e2025-03-23 16:42:16 +010012457 case VAR_TUPLE: n = VAR_TYPE_TUPLE; break;
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +010012458 case VAR_DICT: n = VAR_TYPE_DICT; break;
12459 case VAR_FLOAT: n = VAR_TYPE_FLOAT; break;
12460 case VAR_BOOL: n = VAR_TYPE_BOOL; break;
12461 case VAR_SPECIAL: n = VAR_TYPE_NONE; break;
Bram Moolenaarf562e722016-07-19 17:25:25 +020012462 case VAR_JOB: n = VAR_TYPE_JOB; break;
12463 case VAR_CHANNEL: n = VAR_TYPE_CHANNEL; break;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +010012464 case VAR_BLOB: n = VAR_TYPE_BLOB; break;
Bram Moolenaarf18332f2021-05-07 17:55:55 +020012465 case VAR_INSTR: n = VAR_TYPE_INSTR; break;
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +020012466 case VAR_TYPEALIAS: n = VAR_TYPE_TYPEALIAS; break;
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012467 case VAR_CLASS:
12468 {
12469 class_T *cl = argvars[0].vval.v_class;
Yegappan Lakshmananda9d3452024-05-02 13:02:36 +020012470 if (cl != NULL && IS_ENUM(cl))
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012471 n = VAR_TYPE_ENUM;
12472 else
12473 n = VAR_TYPE_CLASS;
12474 break;
12475 }
12476 case VAR_OBJECT:
12477 {
Yegappan Lakshmananb2e42b92024-05-01 11:44:17 +020012478 object_T *obj = argvars[0].vval.v_object;
12479
12480 if (obj == NULL)
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012481 n = VAR_TYPE_OBJECT;
Yegappan Lakshmananb2e42b92024-05-01 11:44:17 +020012482 else
12483 {
12484 class_T *cl = argvars[0].vval.v_object->obj_class;
12485 if (IS_ENUM(cl))
12486 n = VAR_TYPE_ENUMVALUE;
12487 else
12488 n = VAR_TYPE_OBJECT;
12489 }
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012490 break;
12491 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012492 case VAR_UNKNOWN:
Bram Moolenaar4c683752020-04-05 21:38:23 +020012493 case VAR_ANY:
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010012494 case VAR_VOID:
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012495 internal_error_no_abort("f_type(UNKNOWN)");
12496 n = -1;
12497 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012498 }
12499 rettv->vval.v_number = n;
12500}
12501
12502/*
zeertzjq825cf812023-08-17 22:55:25 +020012503 * "virtcol({expr}, [, {list} [, {winid}]])" function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012504 */
12505 static void
12506f_virtcol(typval_T *argvars, typval_T *rettv)
12507{
LemonBoy0f7a3e12022-05-26 12:10:37 +010012508 colnr_T vcol_start = 0;
12509 colnr_T vcol_end = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012510 pos_T *fp;
zeertzjq825cf812023-08-17 22:55:25 +020012511 switchwin_T switchwin;
12512 int winchanged = FALSE;
Bram Moolenaarb3d33d82020-01-15 20:36:55 +010012513 int len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012514
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012515 if (in_vim9script()
LemonBoy0f7a3e12022-05-26 12:10:37 +010012516 && (check_for_string_or_list_arg(argvars, 0) == FAIL
12517 || (argvars[1].v_type != VAR_UNKNOWN
zeertzjq825cf812023-08-17 22:55:25 +020012518 && (check_for_bool_arg(argvars, 1) == FAIL
12519 || check_for_opt_number_arg(argvars, 2) == FAIL))))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012520 return;
12521
zeertzjq825cf812023-08-17 22:55:25 +020012522 if (argvars[1].v_type != VAR_UNKNOWN && argvars[2].v_type != VAR_UNKNOWN)
12523 {
12524 tabpage_T *tp;
12525 win_T *wp;
12526
12527 // use the window specified in the third argument
12528 wp = win_id2wp_tp((int)tv_get_number(&argvars[2]), &tp);
12529 if (wp == NULL || tp == NULL)
12530 goto theend;
12531
12532 if (switch_win_noblock(&switchwin, wp, tp, TRUE) != OK)
12533 goto theend;
12534
12535 check_cursor();
12536 winchanged = TRUE;
12537 }
12538
12539 int fnum = curbuf->b_fnum;
Bram Moolenaar6f02b002021-01-10 20:22:54 +010012540 fp = var2fpos(&argvars[0], FALSE, &fnum, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012541 if (fp != NULL && fp->lnum <= curbuf->b_ml.ml_line_count
LemonBoy0f7a3e12022-05-26 12:10:37 +010012542 && fnum == curbuf->b_fnum)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012543 {
Bram Moolenaarb3d33d82020-01-15 20:36:55 +010012544 // Limit the column to a valid value, getvvcol() doesn't check.
12545 if (fp->col < 0)
12546 fp->col = 0;
12547 else
12548 {
John Marriottbfcc8952024-03-11 22:04:45 +010012549 len = (int)ml_get_len(fp->lnum);
Bram Moolenaarb3d33d82020-01-15 20:36:55 +010012550 if (fp->col > len)
12551 fp->col = len;
12552 }
LemonBoy0f7a3e12022-05-26 12:10:37 +010012553 getvvcol(curwin, fp, &vcol_start, NULL, &vcol_end);
12554 ++vcol_start;
12555 ++vcol_end;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012556 }
12557
zeertzjq825cf812023-08-17 22:55:25 +020012558theend:
LemonBoy0f7a3e12022-05-26 12:10:37 +010012559 if (argvars[1].v_type != VAR_UNKNOWN && tv_get_bool(&argvars[1]))
12560 {
12561 if (rettv_list_alloc(rettv) == OK)
12562 {
12563 list_append_number(rettv->vval.v_list, vcol_start);
12564 list_append_number(rettv->vval.v_list, vcol_end);
12565 }
12566 else
12567 rettv->vval.v_number = 0;
12568 }
12569 else
12570 rettv->vval.v_number = vcol_end;
zeertzjq825cf812023-08-17 22:55:25 +020012571
12572 if (winchanged)
12573 restore_win_noblock(&switchwin, TRUE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012574}
12575
12576/*
12577 * "visualmode()" function
12578 */
12579 static void
12580f_visualmode(typval_T *argvars, typval_T *rettv)
12581{
12582 char_u str[2];
12583
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012584 if (in_vim9script() && check_for_opt_bool_arg(argvars, 0) == FAIL)
12585 return;
12586
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012587 rettv->v_type = VAR_STRING;
12588 str[0] = curbuf->b_visual_mode_eval;
12589 str[1] = NUL;
12590 rettv->vval.v_string = vim_strsave(str);
12591
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012592 // A non-zero number or non-empty string argument: reset mode.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012593 if (non_zero_arg(&argvars[0]))
12594 curbuf->b_visual_mode_eval = NUL;
12595}
12596
12597/*
12598 * "wildmenumode()" function
12599 */
12600 static void
12601f_wildmenumode(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
12602{
Bram Moolenaar24959102022-05-07 20:01:16 +010012603 if (wild_menu_showing || ((State & MODE_CMDLINE) && cmdline_pum_active()))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012604 rettv->vval.v_number = 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012605}
12606
12607/*
Bram Moolenaar0c1e3742019-12-27 13:49:24 +010012608 * "windowsversion()" function
12609 */
12610 static void
12611f_windowsversion(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
12612{
12613 rettv->v_type = VAR_STRING;
12614 rettv->vval.v_string = vim_strsave((char_u *)windowsVersion);
12615}
12616
12617/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012618 * "wordcount()" function
12619 */
12620 static void
12621f_wordcount(typval_T *argvars UNUSED, typval_T *rettv)
12622{
12623 if (rettv_dict_alloc(rettv) == FAIL)
12624 return;
12625 cursor_pos_info(rettv->vval.v_dict);
12626}
12627
12628/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012629 * "xor(expr, expr)" function
12630 */
12631 static void
12632f_xor(typval_T *argvars, typval_T *rettv)
12633{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012634 if (in_vim9script()
12635 && (check_for_number_arg(argvars, 0) == FAIL
12636 || check_for_number_arg(argvars, 1) == FAIL))
12637 return;
12638
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012639 rettv->vval.v_number = tv_get_number_chk(&argvars[0], NULL)
12640 ^ tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012641}
12642
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012643#endif // FEAT_EVAL