blob: 41444f497df11b2394a4cdfcb324bf9c483cd553 [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;
311 arg_type_mismatch(&t_object, type, context->arg_idx + 1);
312 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/*
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100364 * Check "type" is a string.
365 */
366 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000367arg_string(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100368{
Bram Moolenaar351ead02021-01-16 16:07:01 +0100369 return check_arg_type(&t_string, type, context);
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100370}
371
372/*
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +0200373 * Check "type" is a blob
374 */
375 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000376arg_blob(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +0200377{
378 return check_arg_type(&t_blob, type, context);
379}
380
381/*
Bram Moolenaarf2b26bc2021-01-30 23:05:11 +0100382 * Check "type" is a bool or number 0 or 1.
383 */
384 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000385arg_bool(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarf2b26bc2021-01-30 23:05:11 +0100386{
Bram Moolenaarf2b26bc2021-01-30 23:05:11 +0100387 return check_arg_type(&t_bool, type, context);
388}
389
390/*
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200391 * Check "type" is a list of 'any' or a blob.
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100392 */
Bram Moolenaarca174532020-10-21 16:42:22 +0200393 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000394arg_list_or_blob(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarca174532020-10-21 16:42:22 +0200395{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100396 if (type->tt_type == VAR_LIST
397 || type->tt_type == VAR_BLOB
398 || type_any_or_unknown(type))
Bram Moolenaarca174532020-10-21 16:42:22 +0200399 return OK;
400 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
401 return FAIL;
402}
403
404/*
Bram Moolenaarfa103972022-09-29 19:14:42 +0100405 * Check "type" is a modifiable list of 'any' or a blob.
406 */
407 static int
408arg_list_or_blob_mod(
409 type_T *type,
410 type_T *decl_type,
411 argcontext_T *context)
412{
413 if (arg_list_or_blob(type, decl_type, context) == FAIL)
414 return FAIL;
415 return arg_type_modifiable(type, context->arg_idx + 1);
416}
417
418/*
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200419 * Check "type" is a string or a number
420 */
421 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000422arg_string_or_nr(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200423{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100424 if (type->tt_type == VAR_STRING
425 || type->tt_type == VAR_NUMBER
426 || type_any_or_unknown(type))
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200427 return OK;
428 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
429 return FAIL;
430}
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200431
432/*
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200433 * Check "type" is a buffer (string or a number)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200434 */
435 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000436arg_buffer(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200437{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100438 if (type->tt_type == VAR_STRING
439 || type->tt_type == VAR_NUMBER
440 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200441 return OK;
442 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
443 return FAIL;
444}
445
446/*
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200447 * Check "type" is a buffer or a dict of any
448 */
449 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000450arg_buffer_or_dict_any(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200451{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100452 if (type->tt_type == VAR_STRING
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200453 || type->tt_type == VAR_NUMBER
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100454 || type->tt_type == VAR_DICT
455 || type_any_or_unknown(type))
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200456 return OK;
457 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
458 return FAIL;
459}
460
461/*
462 * Check "type" is a line (string or a number)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200463 */
464 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000465arg_lnum(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200466{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100467 if (type->tt_type == VAR_STRING
468 || type->tt_type == VAR_NUMBER
469 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200470 return OK;
471 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
472 return FAIL;
473}
474
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200475/*
Bram Moolenaarca81f0e2021-06-20 14:41:01 +0200476 * Check "type" is a string or a list of strings.
477 */
478 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000479arg_string_or_list_string(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarca81f0e2021-06-20 14:41:01 +0200480{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100481 if (type->tt_type == VAR_STRING
482 || type_any_or_unknown(type))
Bram Moolenaarca81f0e2021-06-20 14:41:01 +0200483 return OK;
484 if (type->tt_type != VAR_LIST)
485 {
486 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
487 return FAIL;
488 }
489 if (type->tt_member->tt_type == VAR_ANY
490 || type->tt_member->tt_type == VAR_STRING)
491 return OK;
492
493 arg_type_mismatch(&t_list_string, type, context->arg_idx + 1);
494 return FAIL;
495}
496
497/*
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200498 * Check "type" is a string or a list of 'any'
499 */
500 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000501arg_string_or_list_any(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200502{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100503 if (type->tt_type == VAR_STRING
504 || type->tt_type == VAR_LIST
505 || type_any_or_unknown(type))
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200506 return OK;
507 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
508 return FAIL;
509}
510
511/*
Ernie Rael51d04d12022-05-04 15:40:22 +0100512 * Check "type" is a string or a dict of 'any'
513 */
514 static int
515arg_string_or_dict_any(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
516{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100517 if (type->tt_type == VAR_STRING
518 || type->tt_type == VAR_DICT
519 || type_any_or_unknown(type))
Ernie Rael51d04d12022-05-04 15:40:22 +0100520 return OK;
521 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
522 return FAIL;
523}
524
525/*
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200526 * Check "type" is a string or a blob
527 */
528 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000529arg_string_or_blob(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200530{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100531 if (type->tt_type == VAR_STRING
532 || type->tt_type == VAR_BLOB
533 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200534 return OK;
535 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
536 return FAIL;
537}
538
539/*
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +0200540 * Check "type" is a list of 'any' or a dict of 'any'.
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100541 */
542 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000543arg_list_or_dict(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100544{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100545 if (type->tt_type == VAR_LIST
546 || type->tt_type == VAR_DICT
547 || type_any_or_unknown(type))
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100548 return OK;
549 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
550 return FAIL;
551}
552
553/*
Bram Moolenaarfa103972022-09-29 19:14:42 +0100554 * Check "type" is a list of 'any' or a dict of 'any'. And modifiable.
555 */
556 static int
557arg_list_or_dict_mod(
558 type_T *type,
559 type_T *decl_type,
560 argcontext_T *context)
561{
562 if (arg_list_or_dict(type, decl_type, context) == FAIL)
563 return FAIL;
564 return arg_type_modifiable(type, context->arg_idx + 1);
565}
566
567/*
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200568 * Check "type" is a list of 'any' or a dict of 'any' or a blob.
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100569 * Also check if "type" is modifiable.
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200570 */
571 static int
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100572arg_list_or_dict_or_blob_mod(
573 type_T *type,
574 type_T *decl_type UNUSED,
575 argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200576{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100577 if (type->tt_type == VAR_LIST
Bram Moolenaar59618fe2021-12-21 12:32:17 +0000578 || type->tt_type == VAR_DICT
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100579 || type->tt_type == VAR_BLOB
580 || type_any_or_unknown(type))
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100581 return arg_type_modifiable(type, context->arg_idx + 1);
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200582 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
583 return FAIL;
584}
585
586/*
Bram Moolenaar2d877592021-12-16 08:21:09 +0000587 * Check "type" is a list of 'any' or a dict of 'any' or a blob or a string.
588 */
589 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000590arg_list_or_dict_or_blob_or_string(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaar2d877592021-12-16 08:21:09 +0000591{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100592 if (type->tt_type == VAR_LIST
Bram Moolenaar59618fe2021-12-21 12:32:17 +0000593 || type->tt_type == VAR_DICT
594 || type->tt_type == VAR_BLOB
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100595 || type->tt_type == VAR_STRING
596 || type_any_or_unknown(type))
Bram Moolenaar2d877592021-12-16 08:21:09 +0000597 return OK;
598 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
599 return FAIL;
600}
601
602/*
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100603 * Check "type" is a list of 'any' or a dict of 'any' or a blob or a string.
604 * Also check the value is modifiable.
605 */
606 static int
607arg_list_or_dict_or_blob_or_string_mod(
608 type_T *type,
609 type_T *decl_type,
610 argcontext_T *context)
611{
612 if (arg_list_or_dict_or_blob_or_string(type, decl_type, context) == FAIL)
613 return FAIL;
614 return arg_type_modifiable(type, context->arg_idx + 1);
615}
616
617/*
Ernie Raele79e2072024-01-13 11:47:33 +0100618 * Check second argument of map(), filter(), foreach().
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000619 */
620 static int
Ernie Raele79e2072024-01-13 11:47:33 +0100621check_map_filter_arg2(type_T *type, argcontext_T *context,
622 filtermap_T filtermap)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000623{
624 type_T *expected_member = NULL;
625 type_T *(args[2]);
Bram Moolenaarb1e32ac2023-02-21 12:38:51 +0000626 type_T t_func_exp = {VAR_FUNC, 2, 0, 0, NULL, NULL, args};
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000627
628 if (context->arg_types[0].type_curr->tt_type == VAR_LIST
629 || context->arg_types[0].type_curr->tt_type == VAR_DICT)
630 {
631 // Use the declared type if possible, so that an error is given if
632 // a declared list changes type, but not if a constant list changes
633 // type.
634 if (context->arg_types[0].type_decl->tt_type == VAR_LIST
635 || context->arg_types[0].type_decl->tt_type == VAR_DICT)
636 expected_member = context->arg_types[0].type_decl->tt_member;
637 else
638 expected_member = context->arg_types[0].type_curr->tt_member;
639 }
640 else if (context->arg_types[0].type_curr->tt_type == VAR_STRING)
641 expected_member = &t_string;
642 else if (context->arg_types[0].type_curr->tt_type == VAR_BLOB)
643 expected_member = &t_number;
644
645 args[0] = NULL;
646 args[1] = &t_unknown;
647 if (type->tt_argcount != -1)
648 {
649 if (!(type->tt_argcount == 2 || (type->tt_argcount == 1
650 && (type->tt_flags & TTFLAG_VARARGS))))
651 {
652 emsg(_(e_invalid_number_of_arguments));
653 return FAIL;
654 }
655 if (type->tt_flags & TTFLAG_VARARGS)
656 // check the argument types at runtime
657 t_func_exp.tt_argcount = -1;
658 else
659 {
660 if (context->arg_types[0].type_curr->tt_type == VAR_STRING
661 || context->arg_types[0].type_curr->tt_type == VAR_BLOB
662 || context->arg_types[0].type_curr->tt_type == VAR_LIST)
663 args[0] = &t_number;
664 else if (context->arg_types[0].type_decl->tt_type == VAR_DICT)
665 args[0] = &t_string;
666 if (args[0] != NULL)
667 args[1] = expected_member;
668 }
669 }
670
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100671 if (!type_any_or_unknown(type->tt_member) || args[0] != NULL)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000672 {
673 where_T where = WHERE_INIT;
674
Ernie Raele79e2072024-01-13 11:47:33 +0100675 if (filtermap == FILTERMAP_MAP)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000676 t_func_exp.tt_member = expected_member == NULL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100677 || type_any_or_unknown(type->tt_member)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000678 ? &t_any : expected_member;
Ernie Raele79e2072024-01-13 11:47:33 +0100679 else if (filtermap == FILTERMAP_FILTER)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000680 t_func_exp.tt_member = &t_bool;
Ernie Raele79e2072024-01-13 11:47:33 +0100681 else // filtermap == FILTERMAP_FOREACH
682 t_func_exp.tt_member = &t_unknown;
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000683 if (args[0] == NULL)
684 args[0] = &t_unknown;
Bram Moolenaar6e1a3872022-02-23 19:11:49 +0000685 if (type->tt_argcount == -1)
686 t_func_exp.tt_argcount = -1;
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000687
688 where.wt_index = 2;
LemonBoyc5d27442023-08-19 13:02:35 +0200689 where.wt_kind = WT_ARGUMENT;
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000690 return check_type(&t_func_exp, type, TRUE, where);
691 }
692 return OK;
693}
694
695/*
Bram Moolenaar18024052021-12-25 21:43:28 +0000696 * Check second argument of filter(): func must return a bool.
697 */
698 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000699arg_filter_func(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaar18024052021-12-25 21:43:28 +0000700{
Bram Moolenaar1080c482022-01-26 18:26:21 +0000701 if (type->tt_type == VAR_STRING
702 || type->tt_type == VAR_PARTIAL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100703 || type_any_or_unknown(type))
Bram Moolenaar1080c482022-01-26 18:26:21 +0000704 return OK;
705
706 if (type->tt_type == VAR_FUNC)
Ernie Raele79e2072024-01-13 11:47:33 +0100707 return check_map_filter_arg2(type, context, FILTERMAP_FILTER);
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000708 semsg(_(e_string_or_function_required_for_argument_nr), 2);
709 return FAIL;
Bram Moolenaar18024052021-12-25 21:43:28 +0000710}
711
712/*
Bram Moolenaareddd4fc2022-02-20 15:52:28 +0000713 * Check second argument of map(), the function.
Bram Moolenaar18024052021-12-25 21:43:28 +0000714 */
715 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000716arg_map_func(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaar18024052021-12-25 21:43:28 +0000717{
Bram Moolenaar1080c482022-01-26 18:26:21 +0000718 if (type->tt_type == VAR_STRING
719 || type->tt_type == VAR_PARTIAL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100720 || type_any_or_unknown(type))
Bram Moolenaar1080c482022-01-26 18:26:21 +0000721 return OK;
722
723 if (type->tt_type == VAR_FUNC)
Ernie Raele79e2072024-01-13 11:47:33 +0100724 return check_map_filter_arg2(type, context, FILTERMAP_MAP);
725 semsg(_(e_string_or_function_required_for_argument_nr), 2);
726 return FAIL;
727}
728
729/*
730 * Check second argument of foreach(), the function.
731 */
732 static int
733arg_foreach_func(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
734{
735 if (type->tt_type == VAR_STRING
736 || type->tt_type == VAR_PARTIAL
737 || type_any_or_unknown(type))
738 return OK;
739
740 if (type->tt_type == VAR_FUNC)
741 return check_map_filter_arg2(type, context, FILTERMAP_FOREACH);
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000742 semsg(_(e_string_or_function_required_for_argument_nr), 2);
743 return FAIL;
Bram Moolenaar18024052021-12-25 21:43:28 +0000744}
745
746/*
Bram Moolenaare843efc2022-02-22 21:54:44 +0000747 * Check second argument of sort() and uniq(), the "how" argument.
748 */
749 static int
750arg_sort_how(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
751{
752 if (type->tt_type == VAR_STRING
753 || type->tt_type == VAR_PARTIAL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100754 || type_any_or_unknown(type))
Bram Moolenaare843efc2022-02-22 21:54:44 +0000755 return OK;
756
757 if (type->tt_type == VAR_FUNC)
758 {
759 type_T *(args[2]);
Bram Moolenaarb1e32ac2023-02-21 12:38:51 +0000760 type_T t_func_exp = {VAR_FUNC, 2, 0, 0, &t_number, NULL, args};
Bram Moolenaare843efc2022-02-22 21:54:44 +0000761
762 if (context->arg_types[0].type_curr->tt_type == VAR_LIST)
763 args[0] = context->arg_types[0].type_curr->tt_member;
764 else
765 args[0] = &t_unknown;
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100766 if (!type_any_or_unknown(type->tt_member) || args[0] != &t_unknown)
Bram Moolenaare843efc2022-02-22 21:54:44 +0000767 {
768 where_T where = WHERE_INIT;
769
770 args[1] = args[0];
Bram Moolenaarfa026162022-02-23 21:03:32 +0000771 if (type->tt_argcount == -1)
772 t_func_exp.tt_argcount = -1;
Bram Moolenaare843efc2022-02-22 21:54:44 +0000773 where.wt_index = 2;
LemonBoyc5d27442023-08-19 13:02:35 +0200774 where.wt_kind = WT_ARGUMENT;
Bram Moolenaare843efc2022-02-22 21:54:44 +0000775 return check_type(&t_func_exp, type, TRUE, where);
776 }
777
778 return OK;
779 }
780 semsg(_(e_string_or_function_required_for_argument_nr), 2);
781 return FAIL;
782}
783
784/*
Bram Moolenaar73199812021-12-26 17:18:14 +0000785 * Check an expression argument, can be a string, funcref or partial.
786 * Also accept a bool, a constant resulting from compiling a string argument.
787 * Also accept a number, one and zero are accepted.
788 */
789 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000790arg_string_or_func(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaar73199812021-12-26 17:18:14 +0000791{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100792 if (type->tt_type == VAR_STRING
Bram Moolenaar73199812021-12-26 17:18:14 +0000793 || type->tt_type == VAR_PARTIAL
794 || type->tt_type == VAR_FUNC
795 || type->tt_type == VAR_BOOL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100796 || type->tt_type == VAR_NUMBER
797 || type_any_or_unknown(type))
Bram Moolenaar73199812021-12-26 17:18:14 +0000798 return OK;
799 arg_type_mismatch(&t_func_any, type, context->arg_idx + 1);
800 return FAIL;
801}
802
803/*
Ernie Rael2025af12023-12-12 16:58:00 +0100804 * Check varargs' "type" are class.
LemonBoyafe04662023-08-23 21:08:11 +0200805 */
806 static int
Ernie Rael2025af12023-12-12 16:58:00 +0100807varargs_class(type_T *type UNUSED,
808 type_T *decl_type UNUSED,
809 argcontext_T *context)
LemonBoyafe04662023-08-23 21:08:11 +0200810{
Ernie Rael2025af12023-12-12 16:58:00 +0100811 for (int i = context->arg_idx; i < context->arg_count; ++i)
812 {
813 type2_T *types = &context->arg_types[i];
814 if (types->type_curr->tt_type != VAR_CLASS)
815 {
816 semsg(_(e_class_or_typealias_required_for_argument_nr), i + 1);
817 return FAIL;
818 }
819 }
820 return OK;
LemonBoyafe04662023-08-23 21:08:11 +0200821}
822
823/*
rbtnn0ccb5842021-12-18 18:33:46 +0000824 * Check "type" is a list of 'any' or a blob or a string.
825 */
826 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000827arg_string_list_or_blob(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
rbtnn0ccb5842021-12-18 18:33:46 +0000828{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100829 if (type->tt_type == VAR_LIST
Bram Moolenaar59618fe2021-12-21 12:32:17 +0000830 || type->tt_type == VAR_BLOB
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100831 || type->tt_type == VAR_STRING
832 || type_any_or_unknown(type))
rbtnn0ccb5842021-12-18 18:33:46 +0000833 return OK;
834 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
835 return FAIL;
836}
837
838/*
Yegappan Lakshmananf9dc2782023-05-11 15:02:56 +0100839 * Check "type" is a modifiable list of 'any' or a blob or a string.
840 */
841 static int
842arg_string_list_or_blob_mod(type_T *type, type_T *decl_type, argcontext_T *context)
843{
844 if (arg_string_list_or_blob(type, decl_type, context) == FAIL)
845 return FAIL;
846 return arg_type_modifiable(type, context->arg_idx + 1);
847}
848
849/*
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +0200850 * Check "type" is a job.
851 */
852 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000853arg_job(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +0200854{
855 return check_arg_type(&t_job, type, context);
856}
857
858/*
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +0200859 * Check "type" is a channel or a job.
860 */
861 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000862arg_chan_or_job(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +0200863{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100864 if (type->tt_type == VAR_CHANNEL
865 || type->tt_type == VAR_JOB
866 || type_any_or_unknown(type))
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +0200867 return OK;
868 arg_type_mismatch(&t_channel, type, context->arg_idx + 1);
869 return FAIL;
870}
871
872/*
Bram Moolenaar078a4612022-01-04 15:17:03 +0000873 * Check "type" can be used as the type_decl of the previous argument.
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100874 * Must not be used for the first argcheck_T entry.
875 */
876 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000877arg_same_as_prev(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100878{
Bram Moolenaar078a4612022-01-04 15:17:03 +0000879 type_T *prev_type = context->arg_types[context->arg_idx - 1].type_decl;
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100880
Bram Moolenaar351ead02021-01-16 16:07:01 +0100881 return check_arg_type(prev_type, type, context);
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100882}
883
884/*
Bram Moolenaarb0e6b512021-01-12 20:23:40 +0100885 * Check "type" is the same basic type as the previous argument, checks list or
886 * dict vs other type, but not member type.
887 * Must not be used for the first argcheck_T entry.
888 */
889 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000890arg_same_struct_as_prev(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarb0e6b512021-01-12 20:23:40 +0100891{
Bram Moolenaar078a4612022-01-04 15:17:03 +0000892 type_T *prev_type = context->arg_types[context->arg_idx - 1].type_curr;
Bram Moolenaarb0e6b512021-01-12 20:23:40 +0100893
Bram Moolenaar078a4612022-01-04 15:17:03 +0000894 if (prev_type->tt_type != context->arg_types[context->arg_idx].type_curr->tt_type)
Bram Moolenaar351ead02021-01-16 16:07:01 +0100895 return check_arg_type(prev_type, type, context);
Bram Moolenaarb0e6b512021-01-12 20:23:40 +0100896 return OK;
897}
898
899/*
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100900 * Check "type" is an item of the list or blob of the previous arg.
Bram Moolenaarca174532020-10-21 16:42:22 +0200901 * Must not be used for the first argcheck_T entry.
902 */
903 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000904arg_item_of_prev(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarca174532020-10-21 16:42:22 +0200905{
Bram Moolenaar078a4612022-01-04 15:17:03 +0000906 type_T *prev_type = context->arg_types[context->arg_idx - 1].type_curr;
Bram Moolenaarca174532020-10-21 16:42:22 +0200907 type_T *expected;
908
909 if (prev_type->tt_type == VAR_LIST)
910 expected = prev_type->tt_member;
911 else if (prev_type->tt_type == VAR_BLOB)
912 expected = &t_number;
913 else
914 // probably VAR_ANY, can't check
915 return OK;
916
Bram Moolenaar351ead02021-01-16 16:07:01 +0100917 return check_arg_type(expected, type, context);
Bram Moolenaarca174532020-10-21 16:42:22 +0200918}
919
Bram Moolenaar94738d82020-10-21 14:25:07 +0200920/*
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200921 * Check "type" is a string or a number or a list
922 */
923 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000924arg_str_or_nr_or_list(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200925{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100926 if (type->tt_type == VAR_STRING
Bram Moolenaar59618fe2021-12-21 12:32:17 +0000927 || type->tt_type == VAR_NUMBER
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100928 || type->tt_type == VAR_LIST
929 || type_any_or_unknown(type))
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200930 return OK;
931 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
932 return FAIL;
933}
934
935/*
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200936 * Check "type" is a dict of 'any' or a string
937 */
938 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000939arg_dict_any_or_string(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200940{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100941 if (type->tt_type == VAR_DICT
942 || type->tt_type == VAR_STRING
943 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200944 return OK;
945 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
946 return FAIL;
947}
948
949/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +0200950 * Check "type" which is the third argument of extend() (number or string or
951 * any)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100952 */
953 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000954arg_extend3(type_T *type, type_T *decl_type, argcontext_T *context)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100955{
Bram Moolenaar078a4612022-01-04 15:17:03 +0000956 type_T *first_type = context->arg_types[context->arg_idx - 2].type_curr;
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100957
958 if (first_type->tt_type == VAR_LIST)
Bram Moolenaar078a4612022-01-04 15:17:03 +0000959 return arg_number(type, decl_type, context);
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100960 if (first_type->tt_type == VAR_DICT)
Bram Moolenaar078a4612022-01-04 15:17:03 +0000961 return arg_string(type, decl_type, context);
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100962 return OK;
963}
964
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200965/*
Yegappan Lakshmanana764e732021-07-25 15:57:32 +0200966 * Check "type" which is the first argument of get() (blob or list or dict or
967 * funcref)
968 */
969 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000970arg_get1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana764e732021-07-25 15:57:32 +0200971{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100972 if (type->tt_type == VAR_BLOB
Yegappan Lakshmanana764e732021-07-25 15:57:32 +0200973 || type->tt_type == VAR_LIST
974 || type->tt_type == VAR_DICT
975 || type->tt_type == VAR_FUNC
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100976 || type->tt_type == VAR_PARTIAL
977 || type_any_or_unknown(type))
Yegappan Lakshmanana764e732021-07-25 15:57:32 +0200978 return OK;
979
980 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
981 return FAIL;
982}
983
984/*
985 * Check "type" which is the first argument of len() (number or string or
986 * blob or list or dict)
987 */
988 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000989arg_len1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana764e732021-07-25 15:57:32 +0200990{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100991 if (type->tt_type == VAR_STRING
Yegappan Lakshmanana764e732021-07-25 15:57:32 +0200992 || type->tt_type == VAR_NUMBER
993 || type->tt_type == VAR_BLOB
994 || type->tt_type == VAR_LIST
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100995 || type->tt_type == VAR_DICT
Yegappan Lakshmanand3eae7b2024-03-03 16:26:58 +0100996 || type->tt_type == VAR_OBJECT
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100997 || type_any_or_unknown(type))
Yegappan Lakshmanana764e732021-07-25 15:57:32 +0200998 return OK;
999
1000 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
1001 return FAIL;
1002}
1003
1004/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001005 * Check "type" which is the second argument of remove() (number or string or
1006 * any)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001007 */
1008 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001009arg_remove2(type_T *type, type_T *decl_type, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001010{
Bram Moolenaar078a4612022-01-04 15:17:03 +00001011 type_T *first_type = context->arg_types[context->arg_idx - 1].type_curr;
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001012
1013 if (first_type->tt_type == VAR_LIST || first_type->tt_type == VAR_BLOB)
Bram Moolenaar078a4612022-01-04 15:17:03 +00001014 return arg_number(type, decl_type, context);
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001015 if (first_type->tt_type == VAR_DICT)
Bram Moolenaar078a4612022-01-04 15:17:03 +00001016 return arg_string_or_nr(type, decl_type, context);
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001017 return OK;
1018}
1019
1020/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001021 * Check "type" which is the first argument of repeat() (string or number or
1022 * list or any)
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001023 */
1024 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001025arg_repeat1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001026{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001027 if (type->tt_type == VAR_STRING
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001028 || type->tt_type == VAR_NUMBER
Bakudankun375141e2022-09-09 18:46:47 +01001029 || type->tt_type == VAR_BLOB
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001030 || type->tt_type == VAR_LIST
1031 || type_any_or_unknown(type))
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001032 return OK;
1033
1034 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
1035 return FAIL;
1036}
1037
1038/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001039 * Check "type" which is the first argument of slice() (list or blob or string
1040 * or any)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001041 */
1042 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001043arg_slice1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001044{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001045 if (type->tt_type == VAR_LIST
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001046 || type->tt_type == VAR_BLOB
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001047 || type->tt_type == VAR_STRING
1048 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001049 return OK;
1050
1051 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
1052 return FAIL;
1053}
1054
1055/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001056 * Check "type" which is the first argument of count() (string or list or dict
1057 * or any)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001058 */
1059 static int
Bram Moolenaar3e518a82022-08-30 17:45:33 +01001060arg_string_or_list_or_dict(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001061{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001062 if (type->tt_type == VAR_STRING
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001063 || type->tt_type == VAR_LIST
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001064 || type->tt_type == VAR_DICT
1065 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001066 return OK;
1067
Bram Moolenaar3e518a82022-08-30 17:45:33 +01001068 semsg(_(e_string_list_or_dict_required_for_argument_nr),
1069 context->arg_idx + 1);
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001070 return FAIL;
1071}
1072
1073/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001074 * Check "type" which is the first argument of cursor() (number or string or
1075 * list or any)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001076 */
1077 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001078arg_cursor1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001079{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001080 if (type->tt_type == VAR_NUMBER
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001081 || type->tt_type == VAR_STRING
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001082 || type->tt_type == VAR_LIST
1083 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001084 return OK;
1085
1086 arg_type_mismatch(&t_number, type, context->arg_idx + 1);
1087 return FAIL;
1088}
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01001089
1090/*
Bram Moolenaar94738d82020-10-21 14:25:07 +02001091 * Lists of functions that check the argument types of a builtin function.
1092 */
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +02001093static argcheck_T arg1_blob[] = {arg_blob};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001094static argcheck_T arg1_bool[] = {arg_bool};
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001095static argcheck_T arg1_buffer[] = {arg_buffer};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001096static argcheck_T arg1_buffer_or_dict_any[] = {arg_buffer_or_dict_any};
1097static argcheck_T arg1_chan_or_job[] = {arg_chan_or_job};
1098static argcheck_T arg1_dict_any[] = {arg_dict_any};
1099static argcheck_T arg1_dict_or_string[] = {arg_dict_any_or_string};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001100static argcheck_T arg1_float_or_nr[] = {arg_float_or_nr};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001101static argcheck_T arg1_job[] = {arg_job};
1102static argcheck_T arg1_list_any[] = {arg_list_any};
1103static argcheck_T arg1_list_number[] = {arg_list_number};
Yegappan Lakshmananf9dc2782023-05-11 15:02:56 +01001104static argcheck_T arg1_string_or_list_or_blob_mod[] = {arg_string_list_or_blob_mod};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001105static argcheck_T arg1_list_or_dict[] = {arg_list_or_dict};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001106static argcheck_T arg1_list_string[] = {arg_list_string};
Bram Moolenaar3e518a82022-08-30 17:45:33 +01001107static argcheck_T arg1_string_or_list_or_dict[] = {arg_string_or_list_or_dict};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001108static argcheck_T arg1_lnum[] = {arg_lnum};
1109static argcheck_T arg1_number[] = {arg_number};
1110static argcheck_T arg1_string[] = {arg_string};
1111static argcheck_T arg1_string_or_list_any[] = {arg_string_or_list_any};
1112static argcheck_T arg1_string_or_list_string[] = {arg_string_or_list_string};
1113static argcheck_T arg1_string_or_nr[] = {arg_string_or_nr};
Ernie Raela8f7f922023-12-14 20:17:04 +01001114static argcheck_T arg2_any_buffer[] = {arg_any, arg_buffer};
1115static argcheck_T arg2_buffer_any[] = {arg_buffer, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001116static argcheck_T arg2_buffer_bool[] = {arg_buffer, arg_bool};
1117static argcheck_T arg2_buffer_list_any[] = {arg_buffer, arg_list_any};
1118static argcheck_T arg2_buffer_lnum[] = {arg_buffer, arg_lnum};
1119static argcheck_T arg2_buffer_number[] = {arg_buffer, arg_number};
1120static argcheck_T arg2_buffer_string[] = {arg_buffer, arg_string};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001121static argcheck_T arg2_chan_or_job_dict[] = {arg_chan_or_job, arg_dict_any};
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001122static argcheck_T arg2_chan_or_job_string[] = {arg_chan_or_job, arg_string};
Yegappan Lakshmananccfb7c62021-08-16 21:39:09 +02001123static argcheck_T arg2_dict_any_list_any[] = {arg_dict_any, arg_list_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001124static argcheck_T arg2_dict_any_string_or_nr[] = {arg_dict_any, arg_string_or_nr};
1125static argcheck_T arg2_dict_string[] = {arg_dict_any, arg_string};
1126static argcheck_T arg2_float_or_nr[] = {arg_float_or_nr, arg_float_or_nr};
1127static argcheck_T arg2_job_dict[] = {arg_job, arg_dict_any};
1128static argcheck_T arg2_job_string_or_number[] = {arg_job, arg_string_or_nr};
1129static argcheck_T arg2_list_any_number[] = {arg_list_any, arg_number};
1130static argcheck_T arg2_list_any_string[] = {arg_list_any, arg_string};
1131static argcheck_T arg2_list_number[] = {arg_list_number, arg_list_number};
1132static argcheck_T arg2_list_number_bool[] = {arg_list_number, arg_bool};
Yegappan Lakshmanana11b23c2025-01-16 19:16:42 +01001133static argcheck_T arg2_list_string_dict[] = {arg_list_string, arg_dict_any};
Bram Moolenaarfa103972022-09-29 19:14:42 +01001134static argcheck_T arg2_listblobmod_item[] = {arg_list_or_blob_mod, arg_item_of_prev};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001135static argcheck_T arg2_lnum[] = {arg_lnum, arg_lnum};
1136static argcheck_T arg2_lnum_number[] = {arg_lnum, arg_number};
1137static argcheck_T arg2_number[] = {arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001138static argcheck_T arg2_number_any[] = {arg_number, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001139static argcheck_T arg2_number_bool[] = {arg_number, arg_bool};
1140static argcheck_T arg2_number_dict_any[] = {arg_number, arg_dict_any};
1141static argcheck_T arg2_number_list[] = {arg_number, arg_list_any};
1142static argcheck_T arg2_number_string[] = {arg_number, arg_string};
Christian Brabandtfbc37f12024-06-18 20:50:58 +02001143static argcheck_T arg2_number_buffer[] = {arg_number, arg_buffer};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001144static argcheck_T arg2_number_string_or_list[] = {arg_number, arg_string_or_list_any};
1145static argcheck_T arg2_str_or_nr_or_list_dict[] = {arg_str_or_nr_or_list, arg_dict_any};
1146static argcheck_T arg2_string[] = {arg_string, arg_string};
Ernie Raela8f7f922023-12-14 20:17:04 +01001147static argcheck_T arg2_string_any[] = {arg_string, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001148static argcheck_T arg2_string_bool[] = {arg_string, arg_bool};
1149static argcheck_T arg2_string_chan_or_job[] = {arg_string, arg_chan_or_job};
1150static argcheck_T arg2_string_dict[] = {arg_string, arg_dict_any};
1151static argcheck_T arg2_string_list_number[] = {arg_string, arg_list_number};
1152static argcheck_T arg2_string_number[] = {arg_string, arg_number};
1153static argcheck_T arg2_string_or_list_dict[] = {arg_string_or_list_any, arg_dict_any};
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00001154static argcheck_T arg2_string_or_list_number[] = {arg_string_or_list_any, arg_number};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001155static argcheck_T arg2_string_string_or_number[] = {arg_string, arg_string_or_nr};
Yegappan Lakshmanan1aefe1d2025-01-14 17:29:42 +01001156static argcheck_T arg2_blob_dict[] = {arg_blob, arg_dict_any};
Ernie Raela8f7f922023-12-14 20:17:04 +01001157static argcheck_T arg3_any_list_dict[] = {arg_any, arg_list_any, arg_dict_any};
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001158static argcheck_T arg3_buffer_lnum_lnum[] = {arg_buffer, arg_lnum, arg_lnum};
1159static argcheck_T arg3_buffer_number_number[] = {arg_buffer, arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001160static argcheck_T arg3_buffer_string_any[] = {arg_buffer, arg_string, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001161static argcheck_T arg3_buffer_string_dict[] = {arg_buffer, arg_string, arg_dict_any};
1162static argcheck_T arg3_dict_number_number[] = {arg_dict_any, arg_number, arg_number};
Yegappan Lakshmananfa378352024-02-01 22:05:27 +01001163static argcheck_T arg3_diff[] = {arg_list_string, arg_list_string, arg_dict_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001164static argcheck_T arg3_list_string_dict[] = {arg_list_any, arg_string, arg_dict_any};
Shougo Matsushita19b71882024-02-28 22:48:12 +01001165static argcheck_T arg3_list_list_dict[] = {arg_list_any, arg_list_any, arg_dict_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001166static argcheck_T arg3_lnum_number_bool[] = {arg_lnum, arg_number, arg_bool};
1167static argcheck_T arg3_number[] = {arg_number, arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001168static argcheck_T arg3_number_any_dict[] = {arg_number, arg_any, arg_dict_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001169static argcheck_T arg3_number_number_dict[] = {arg_number, arg_number, arg_dict_any};
Ernie Raela8f7f922023-12-14 20:17:04 +01001170static argcheck_T arg3_number_string_any[] = {arg_number, arg_string, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001171static argcheck_T arg3_number_string_buffer[] = {arg_number, arg_string, arg_buffer};
1172static argcheck_T arg3_number_string_string[] = {arg_number, arg_string, arg_string};
1173static argcheck_T arg3_string[] = {arg_string, arg_string, arg_string};
Ernie Raela8f7f922023-12-14 20:17:04 +01001174static argcheck_T arg3_string_any_dict[] = {arg_string, arg_any, arg_dict_any};
1175static argcheck_T arg3_string_any_string[] = {arg_string, arg_any, arg_string};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001176static argcheck_T arg3_string_bool_bool[] = {arg_string, arg_bool, arg_bool};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001177static argcheck_T arg3_string_number_bool[] = {arg_string, arg_number, arg_bool};
K.Takata11df3ae2022-10-19 14:02:40 +01001178static argcheck_T arg3_string_number_number[] = {arg_string, arg_number, arg_number};
Ernie Rael51d04d12022-05-04 15:40:22 +01001179static argcheck_T arg3_string_or_dict_bool_dict[] = {arg_string_or_dict_any, arg_bool, arg_dict_any};
zeertzjq825cf812023-08-17 22:55:25 +02001180static argcheck_T arg3_string_or_list_bool_number[] = {arg_string_or_list_any, arg_bool, arg_number};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001181static argcheck_T arg3_string_string_bool[] = {arg_string, arg_string, arg_bool};
1182static argcheck_T arg3_string_string_dict[] = {arg_string, arg_string, arg_dict_any};
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02001183static argcheck_T arg3_string_string_number[] = {arg_string, arg_string, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001184static argcheck_T arg4_number_number_string_any[] = {arg_number, arg_number, arg_string, arg_any};
1185static argcheck_T arg4_string_string_any_string[] = {arg_string, arg_string, arg_any, arg_string};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001186static argcheck_T arg4_string_string_number_string[] = {arg_string, arg_string, arg_number, arg_string};
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01001187static argcheck_T arg4_string_number_bool_bool[] = {arg_string, arg_number, arg_bool, arg_bool};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001188/* Function specific argument types (not covered by the above) */
Ernie Raela8f7f922023-12-14 20:17:04 +01001189static 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 +02001190static 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 +02001191static argcheck_T arg4_browse[] = {arg_bool, arg_string, arg_string, arg_string};
Ernie Raela8f7f922023-12-14 20:17:04 +01001192static argcheck_T arg23_chanexpr[] = {arg_chan_or_job, arg_any, arg_dict_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001193static argcheck_T arg23_chanraw[] = {arg_chan_or_job, arg_string_or_blob, arg_dict_any};
Ernie Raela8f7f922023-12-14 20:17:04 +01001194static argcheck_T arg24_count[] = {arg_string_or_list_or_dict, arg_any, arg_bool, arg_number};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001195static argcheck_T arg13_cursor[] = {arg_cursor1, arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001196static argcheck_T arg12_deepcopy[] = {arg_any, arg_bool};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001197static argcheck_T arg12_execute[] = {arg_string_or_list_string, arg_string};
Bram Moolenaarfa103972022-09-29 19:14:42 +01001198static argcheck_T arg23_extend[] = {arg_list_or_dict_mod, arg_same_as_prev, arg_extend3};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001199static argcheck_T arg23_extendnew[] = {arg_list_or_dict, arg_same_struct_as_prev, arg_extend3};
Ernie Raela8f7f922023-12-14 20:17:04 +01001200static argcheck_T arg23_get[] = {arg_get1, arg_string_or_nr, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001201static argcheck_T arg14_glob[] = {arg_string, arg_bool, arg_bool, arg_bool};
1202static argcheck_T arg25_globpath[] = {arg_string, arg_string, arg_bool, arg_bool, arg_bool};
1203static argcheck_T arg24_index[] = {arg_list_or_blob, arg_item_of_prev, arg_number, arg_bool};
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01001204static argcheck_T arg23_index[] = {arg_list_or_blob, arg_filter_func, arg_dict_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001205static argcheck_T arg23_insert[] = {arg_list_or_blob, arg_item_of_prev, arg_number};
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001206static argcheck_T arg1_len[] = {arg_len1};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001207static argcheck_T arg3_libcall[] = {arg_string, arg_string, arg_string_or_nr};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001208static argcheck_T arg14_maparg[] = {arg_string, arg_string, arg_bool, arg_bool};
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001209static argcheck_T arg2_filter[] = {arg_list_or_dict_or_blob_or_string_mod, arg_filter_func};
Ernie Raele79e2072024-01-13 11:47:33 +01001210static argcheck_T arg2_foreach[] = {arg_list_or_dict_or_blob_or_string, arg_foreach_func};
Ernie Rael2025af12023-12-12 16:58:00 +01001211static argcheck_T arg2_instanceof[] = {arg_object, varargs_class, NULL };
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001212static argcheck_T arg2_map[] = {arg_list_or_dict_or_blob_or_string_mod, arg_map_func};
Ernie Raela8f7f922023-12-14 20:17:04 +01001213static argcheck_T arg2_mapnew[] = {arg_list_or_dict_or_blob_or_string, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001214static argcheck_T arg25_matchadd[] = {arg_string, arg_string, arg_number, arg_number, arg_dict_any};
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001215static argcheck_T arg25_matchaddpos[] = {arg_string, arg_list_any, arg_number, arg_number, arg_dict_any};
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01001216static argcheck_T arg23_matchstrlist[] = {arg_list_string, arg_string, arg_dict_any};
1217static argcheck_T arg45_matchbufline[] = {arg_buffer, arg_string, arg_lnum, arg_lnum, arg_dict_any};
Ernie Raela8f7f922023-12-14 20:17:04 +01001218static 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};
1219static argcheck_T arg23_reduce[] = {arg_string_list_or_blob, arg_any, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001220static argcheck_T arg24_remote_expr[] = {arg_string, arg_string, arg_string, arg_number};
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001221static argcheck_T arg23_remove[] = {arg_list_or_dict_or_blob_mod, arg_remove2, arg_number};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001222static argcheck_T arg2_repeat[] = {arg_repeat1, arg_number};
Bram Moolenaar73199812021-12-26 17:18:14 +00001223static argcheck_T arg15_search[] = {arg_string, arg_string, arg_number, arg_number, arg_string_or_func};
1224static 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 +02001225static argcheck_T arg3_setbufline[] = {arg_buffer, arg_lnum, arg_str_or_nr_or_list};
Ernie Raela8f7f922023-12-14 20:17:04 +01001226static argcheck_T arg2_setline[] = {arg_lnum, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001227static argcheck_T arg24_setloclist[] = {arg_number, arg_list_any, arg_string, arg_dict_any};
1228static argcheck_T arg13_setqflist[] = {arg_list_any, arg_string, arg_dict_any};
1229static argcheck_T arg23_settagstack[] = {arg_number, arg_dict_any, arg_string};
1230static argcheck_T arg02_sign_getplaced[] = {arg_buffer, arg_dict_any};
1231static argcheck_T arg45_sign_place[] = {arg_number, arg_string, arg_string, arg_buffer, arg_dict_any};
1232static argcheck_T arg23_slice[] = {arg_slice1, arg_number, arg_number};
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001233static argcheck_T arg13_sortuniq[] = {arg_list_any_mod, arg_sort_how, arg_dict_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001234static argcheck_T arg24_strpart[] = {arg_string, arg_number, arg_number, arg_bool};
1235static argcheck_T arg12_system[] = {arg_string, arg_str_or_nr_or_list};
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02001236static argcheck_T arg23_win_execute[] = {arg_number, arg_string_or_list_string, arg_string};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001237static argcheck_T arg23_writefile[] = {arg_list_or_blob, arg_string, arg_string};
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02001238static argcheck_T arg24_match_func[] = {arg_string_or_list_any, arg_string, arg_number, arg_number};
Bram Moolenaarcd268012021-07-22 19:11:08 +02001239
Bram Moolenaar32517c42023-01-15 18:17:12 +00001240// Can be used by functions called through "f_retfunc" to create new types.
1241static garray_T *current_type_gap = NULL;
Bram Moolenaar94738d82020-10-21 14:25:07 +02001242
1243/*
1244 * Functions that return the return type of a builtin function.
Bram Moolenaara1224cb2020-10-22 12:31:49 +02001245 * Note that "argtypes" is NULL if "argcount" is zero.
Bram Moolenaar94738d82020-10-21 14:25:07 +02001246 */
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001247 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001248ret_void(int argcount UNUSED,
1249 type2_T *argtypes UNUSED,
1250 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001251{
1252 return &t_void;
1253}
1254 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001255ret_any(int argcount UNUSED,
1256 type2_T *argtypes UNUSED,
1257 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001258{
1259 return &t_any;
1260}
1261 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001262ret_bool(int argcount UNUSED,
1263 type2_T *argtypes UNUSED,
1264 type_T **decl_type UNUSED)
Bram Moolenaar403dc312020-10-17 19:29:51 +02001265{
1266 return &t_bool;
1267}
1268 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001269ret_number_bool(int argcount UNUSED,
1270 type2_T *argtypes UNUSED,
1271 type_T **decl_type UNUSED)
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001272{
1273 return &t_number_bool;
1274}
1275 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001276ret_number(int argcount UNUSED,
1277 type2_T *argtypes UNUSED,
1278 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001279{
1280 return &t_number;
1281}
1282 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001283ret_float(int argcount UNUSED,
1284 type2_T *argtypes UNUSED,
1285 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001286{
1287 return &t_float;
1288}
1289 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001290ret_string(int argcount UNUSED,
1291 type2_T *argtypes UNUSED,
1292 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001293{
1294 return &t_string;
1295}
Bram Moolenaare69f6d02020-04-01 22:11:01 +02001296 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001297ret_list_any(int argcount UNUSED,
1298 type2_T *argtypes UNUSED,
1299 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001300{
1301 return &t_list_any;
1302}
1303 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001304ret_list_number(int argcount UNUSED,
1305 type2_T *argtypes UNUSED,
Bram Moolenaar81330182022-02-01 12:11:58 +00001306 type_T **decl_type)
1307{
Bram Moolenaar81330182022-02-01 12:11:58 +00001308 *decl_type = &t_list_any;
1309 return &t_list_number;
1310}
1311 static type_T *
1312ret_list_string(int argcount UNUSED,
1313 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001314 type_T **decl_type)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001315{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001316 *decl_type = &t_list_any;
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001317 return &t_list_string;
1318}
1319 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001320ret_list_dict_any(int argcount UNUSED,
1321 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001322 type_T **decl_type)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001323{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001324 *decl_type = &t_list_any;
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001325 return &t_list_dict_any;
1326}
1327 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001328ret_list_items(int argcount UNUSED,
1329 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001330 type_T **decl_type)
Bram Moolenaarefc5db52021-07-07 21:21:30 +02001331{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001332 *decl_type = &t_list_any;
Bram Moolenaarefc5db52021-07-07 21:21:30 +02001333 return &t_list_list_any;
1334}
mityu61065042021-07-19 20:07:21 +02001335 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001336ret_list_string_items(int argcount UNUSED,
1337 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001338 type_T **decl_type)
mityu61065042021-07-19 20:07:21 +02001339{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001340 *decl_type = &t_list_any;
mityu61065042021-07-19 20:07:21 +02001341 return &t_list_list_string;
1342}
Bram Moolenaarefc5db52021-07-07 21:21:30 +02001343 static type_T *
zeertzjqd4d12072024-07-16 20:34:16 +02001344ret_list_regionpos(int argcount UNUSED,
1345 type2_T *argtypes UNUSED,
1346 type_T **decl_type)
1347{
1348 *decl_type = &t_list_any;
1349 return &t_list_list_list_number;
1350}
1351 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001352ret_dict_any(int argcount UNUSED,
1353 type2_T *argtypes UNUSED,
1354 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001355{
1356 return &t_dict_any;
1357}
1358 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001359ret_job_info(int argcount,
1360 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001361 type_T **decl_type)
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01001362{
1363 if (argcount == 0)
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001364 {
1365 *decl_type = &t_list_any;
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01001366 return &t_list_job;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001367 }
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01001368 return &t_dict_any;
1369}
1370 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001371ret_dict_number(int argcount UNUSED,
1372 type2_T *argtypes UNUSED,
1373 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001374{
1375 return &t_dict_number;
1376}
1377 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001378ret_dict_string(int argcount UNUSED,
1379 type2_T *argtypes UNUSED,
1380 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001381{
1382 return &t_dict_string;
1383}
1384 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001385ret_blob(int argcount UNUSED,
1386 type2_T *argtypes UNUSED,
1387 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001388{
1389 return &t_blob;
1390}
1391 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001392ret_func_any(int argcount UNUSED,
1393 type2_T *argtypes UNUSED,
1394 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001395{
Bram Moolenaare69f6d02020-04-01 22:11:01 +02001396 return &t_func_any;
1397}
1398 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001399ret_func_unknown(int argcount UNUSED,
1400 type2_T *argtypes UNUSED,
1401 type_T **decl_type UNUSED)
Bram Moolenaar2f9f4cc2021-12-20 09:36:27 +00001402{
1403 return &t_func_unknown;
1404}
1405 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001406ret_channel(int argcount UNUSED,
1407 type2_T *argtypes UNUSED,
1408 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001409{
1410 return &t_channel;
1411}
1412 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001413ret_job(int argcount UNUSED,
1414 type2_T *argtypes UNUSED,
1415 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001416{
1417 return &t_job;
1418}
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001419 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001420ret_first_arg(int argcount,
1421 type2_T *argtypes,
1422 type_T **decl_type)
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001423{
1424 if (argcount > 0)
Bram Moolenaar81330182022-02-01 12:11:58 +00001425 {
1426 *decl_type = argtypes[0].type_decl;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001427 return argtypes[0].type_curr;
Bram Moolenaar81330182022-02-01 12:11:58 +00001428 }
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001429 return &t_void;
1430}
Bram Moolenaar1780f082021-07-31 22:03:59 +02001431 static type_T *
Bram Moolenaar00eb9952022-02-05 19:23:18 +00001432ret_slice(int argcount,
1433 type2_T *argtypes,
1434 type_T **decl_type)
1435{
1436 if (argcount > 0)
1437 {
1438 if (argtypes[0].type_decl != NULL)
1439 {
1440 switch (argtypes[0].type_decl->tt_type)
1441 {
1442 case VAR_STRING: *decl_type = &t_string; break;
1443 case VAR_BLOB: *decl_type = &t_blob; break;
1444 case VAR_LIST: *decl_type = &t_list_any; break;
1445 default: break;
1446 }
1447 }
1448 return argtypes[0].type_curr;
1449 }
1450 return &t_void;
1451}
1452 static type_T *
Bram Moolenaar381692b2022-02-02 20:01:27 +00001453ret_copy(int argcount,
1454 type2_T *argtypes,
1455 type_T **decl_type)
1456{
1457 if (argcount > 0)
1458 {
1459 if (argtypes[0].type_decl != NULL)
1460 {
1461 if (argtypes[0].type_decl->tt_type == VAR_LIST)
1462 *decl_type = &t_list_any;
1463 else if (argtypes[0].type_decl->tt_type == VAR_DICT)
1464 *decl_type = &t_dict_any;
1465 else
1466 *decl_type = argtypes[0].type_decl;
1467 }
1468 if (argtypes[0].type_curr != NULL)
1469 {
1470 if (argtypes[0].type_curr->tt_type == VAR_LIST)
1471 return &t_list_any;
1472 else if (argtypes[0].type_curr->tt_type == VAR_DICT)
1473 return &t_dict_any;
1474 }
1475 return argtypes[0].type_curr;
1476 }
1477 return &t_void;
1478}
1479 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001480ret_extend(int argcount,
1481 type2_T *argtypes,
1482 type_T **decl_type)
1483{
1484 if (argcount > 0)
1485 {
1486 *decl_type = argtypes[0].type_decl;
1487 // if the second argument has a different current type then the current
1488 // type is "any"
1489 if (argcount > 1 && !equal_type(argtypes[0].type_curr,
1490 argtypes[1].type_curr, 0))
1491 {
1492 if (argtypes[0].type_curr->tt_type == VAR_LIST)
1493 return &t_list_any;
1494 if (argtypes[0].type_curr->tt_type == VAR_DICT)
1495 return &t_dict_any;
1496 }
1497 return argtypes[0].type_curr;
1498 }
1499 return &t_void;
1500}
1501 static type_T *
1502ret_repeat(int argcount,
1503 type2_T *argtypes,
1504 type_T **decl_type UNUSED)
Bram Moolenaar1780f082021-07-31 22:03:59 +02001505{
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001506 if (argcount == 0)
1507 return &t_any;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001508 if (argtypes[0].type_curr == &t_number)
Bram Moolenaar1780f082021-07-31 22:03:59 +02001509 return &t_string;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001510 return argtypes[0].type_curr;
Bram Moolenaar1780f082021-07-31 22:03:59 +02001511}
Bram Moolenaarea696852020-11-09 18:31:39 +01001512// for map(): returns first argument but item type may differ
1513 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001514ret_first_cont(int argcount,
1515 type2_T *argtypes,
1516 type_T **decl_type UNUSED)
Bram Moolenaarea696852020-11-09 18:31:39 +01001517{
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001518 if (argcount > 0)
1519 {
Bram Moolenaar078a4612022-01-04 15:17:03 +00001520 if (argtypes[0].type_curr->tt_type == VAR_LIST)
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001521 return &t_list_any;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001522 if (argtypes[0].type_curr->tt_type == VAR_DICT)
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001523 return &t_dict_any;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001524 if (argtypes[0].type_curr->tt_type == VAR_BLOB)
1525 return argtypes[0].type_curr;
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001526 }
Bram Moolenaarea696852020-11-09 18:31:39 +01001527 return &t_any;
1528}
Bram Moolenaar078a4612022-01-04 15:17:03 +00001529// for getline()
1530 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001531ret_getline(int argcount,
1532 type2_T *argtypes UNUSED,
1533 type_T **decl_type UNUSED)
Bram Moolenaar078a4612022-01-04 15:17:03 +00001534{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001535 if (argcount == 1)
1536 return &t_string;
1537 *decl_type = &t_list_any;
1538 return &t_list_string;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001539}
Bram Moolenaar08018222021-12-22 18:45:37 +00001540// for finddir()
1541 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001542ret_finddir(int argcount,
1543 type2_T *argtypes UNUSED,
1544 type_T **decl_type UNUSED)
Bram Moolenaar08018222021-12-22 18:45:37 +00001545{
1546 if (argcount < 3)
1547 return &t_string;
1548 // Depending on the count would be a string or a list of strings.
1549 return &t_any;
1550}
Bram Moolenaar32517c42023-01-15 18:17:12 +00001551// for values(): list of member of first argument
1552 static type_T *
1553ret_list_member(int argcount,
1554 type2_T *argtypes,
1555 type_T **decl_type)
1556{
1557 if (argcount > 0)
1558 {
1559 type_T *t = argtypes[0].type_decl;
1560 if (current_type_gap != NULL
1561 && (t->tt_type == VAR_DICT || t->tt_type == VAR_LIST))
1562 t = get_list_type(t->tt_member, current_type_gap);
1563 else
1564 t = &t_list_any;
1565 *decl_type = t;
1566
1567 t = argtypes[0].type_curr;
1568 if (current_type_gap != NULL
1569 && (t->tt_type == VAR_DICT || t->tt_type == VAR_LIST))
1570 return get_list_type(t->tt_member, current_type_gap);
1571 }
1572 return &t_list_any;
1573}
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001574
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001575/*
1576 * Used for getqflist(): returns list if there is no argument, dict if there is
1577 * one.
1578 */
1579 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001580ret_list_or_dict_0(int argcount,
1581 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001582 type_T **decl_type)
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001583{
1584 if (argcount > 0)
1585 return &t_dict_any;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001586 *decl_type = &t_list_any;
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001587 return &t_list_dict_any;
1588}
1589
1590/*
1591 * Used for getloclist(): returns list if there is one argument, dict if there
1592 * are two.
1593 */
1594 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001595ret_list_or_dict_1(int argcount,
1596 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001597 type_T **decl_type)
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001598{
1599 if (argcount > 1)
1600 return &t_dict_any;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001601 *decl_type = &t_list_any;
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001602 return &t_list_dict_any;
1603}
1604
Bram Moolenaar846178a2020-07-05 17:04:13 +02001605 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001606ret_argv(int argcount,
1607 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001608 type_T **decl_type)
Bram Moolenaar846178a2020-07-05 17:04:13 +02001609{
1610 // argv() returns list of strings
1611 if (argcount == 0)
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001612 {
1613 *decl_type = &t_list_any;
Bram Moolenaar846178a2020-07-05 17:04:13 +02001614 return &t_list_string;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001615 }
Bram Moolenaar846178a2020-07-05 17:04:13 +02001616
1617 // argv(0) returns a string, but argv(-1] returns a list
1618 return &t_any;
1619}
1620
Bram Moolenaarad7c2492020-07-05 20:55:29 +02001621 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001622ret_remove(int argcount,
1623 type2_T *argtypes,
Bram Moolenaar2ac037f2022-05-09 14:12:14 +01001624 type_T **decl_type)
Bram Moolenaarad7c2492020-07-05 20:55:29 +02001625{
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001626 if (argcount > 0)
Bram Moolenaar5e654232020-09-16 15:22:00 +02001627 {
Bram Moolenaar078a4612022-01-04 15:17:03 +00001628 if (argtypes[0].type_curr->tt_type == VAR_LIST
1629 || argtypes[0].type_curr->tt_type == VAR_DICT)
Bram Moolenaar81330182022-02-01 12:11:58 +00001630 {
Bram Moolenaar2ac037f2022-05-09 14:12:14 +01001631 if (argcount == 3)
1632 {
1633 *decl_type = argtypes[0].type_decl;
1634 return argtypes[0].type_curr;
1635 }
Bram Moolenaar81330182022-02-01 12:11:58 +00001636 if (argtypes[0].type_curr->tt_type
1637 == argtypes[0].type_decl->tt_type)
1638 *decl_type = argtypes[0].type_decl->tt_member;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001639 return argtypes[0].type_curr->tt_member;
Bram Moolenaar81330182022-02-01 12:11:58 +00001640 }
Bram Moolenaar078a4612022-01-04 15:17:03 +00001641 if (argtypes[0].type_curr->tt_type == VAR_BLOB)
Bram Moolenaar5e654232020-09-16 15:22:00 +02001642 return &t_number;
1643 }
Bram Moolenaarad7c2492020-07-05 20:55:29 +02001644 return &t_any;
1645}
1646
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001647 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001648ret_getreg(int argcount,
1649 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001650 type_T **decl_type)
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001651{
1652 // Assume that if the third argument is passed it's non-zero
1653 if (argcount == 3)
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001654 {
1655 *decl_type = &t_list_any;
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001656 return &t_list_string;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001657 }
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001658 return &t_string;
1659}
1660
Bram Moolenaar4a6d1b62020-08-08 17:55:49 +02001661 static type_T *
LemonBoy0f7a3e12022-05-26 12:10:37 +01001662ret_virtcol(int argcount,
1663 type2_T *argtypes UNUSED,
1664 type_T **decl_type)
1665{
1666 // Assume that if the second argument is passed it's non-zero
zeertzjq825cf812023-08-17 22:55:25 +02001667 if (argcount > 1)
LemonBoy0f7a3e12022-05-26 12:10:37 +01001668 {
1669 *decl_type = &t_list_any;
1670 return &t_list_number;
1671 }
1672 return &t_number;
1673}
1674
1675 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001676ret_maparg(int argcount,
1677 type2_T *argtypes UNUSED,
1678 type_T **decl_type UNUSED)
Bram Moolenaar4a6d1b62020-08-08 17:55:49 +02001679{
1680 // Assume that if the fourth argument is passed it's non-zero
1681 if (argcount == 4)
1682 return &t_dict_any;
1683 return &t_string;
1684}
1685
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001686/*
1687 * Array with names and number of arguments of all internal functions
1688 * MUST BE KEPT SORTED IN strcmp() ORDER FOR BINARY SEARCH!
Ernie Rael2025af12023-12-12 16:58:00 +01001689 *
Ernie Raela8f7f922023-12-14 20:17:04 +01001690 * The builtin function may be varargs. In that case
Ernie Rael2025af12023-12-12 16:58:00 +01001691 * - f_max_argc == VARGS
Ernie Raela8f7f922023-12-14 20:17:04 +01001692 * - For varargs, f_argcheck must be NULL terminated. The last non-null
1693 * entry in f_argcheck should validate all the remaining args.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001694 */
Bram Moolenaarac92e252019-08-03 21:58:38 +02001695typedef struct
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001696{
Bram Moolenaar25e42232019-08-04 15:04:10 +02001697 char *f_name; // function name
1698 char f_min_argc; // minimal number of arguments
1699 char f_max_argc; // maximal number of arguments
Ernie Raeld8bf87c2023-12-16 14:03:33 +01001700 char f_argtype; // for method: FEARG_ values; bits FE_
Ernie Raela8f7f922023-12-14 20:17:04 +01001701 argcheck_T *f_argcheck; // list of functions to check argument types;
1702 // use "arg_any" (not NULL) to accept an
1703 // argument of any type
Bram Moolenaar81330182022-02-01 12:11:58 +00001704 type_T *(*f_retfunc)(int argcount, type2_T *argtypes,
1705 type_T **decl_type);
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001706 // return type function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001707 void (*f_func)(typval_T *args, typval_T *rvar);
Bram Moolenaar25e42232019-08-04 15:04:10 +02001708 // implementation of function
Bram Moolenaarac92e252019-08-03 21:58:38 +02001709} funcentry_T;
1710
Ernie Rael2025af12023-12-12 16:58:00 +01001711// Set f_max_argc to VARGS for varargs.
1712#define VARGS CHAR_MAX
1713
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02001714// values for f_argtype; zero means it cannot be used as a method
Ernie Raeld8bf87c2023-12-16 14:03:33 +01001715#define FEARG_1 0x01 // base is the first argument
1716#define FEARG_2 0x02 // base is the second argument
1717#define FEARG_3 0x03 // base is the third argument
1718#define FEARG_4 0x04 // base is the fourth argument
1719#define FEARG_MASK 0x0F // bits in f_argtype used as argument index
1720#define FE_X 0x10 // builtin accepts a non-value (class, typealias)
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02001721
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001722#if defined(HAVE_MATH_H)
Bram Moolenaar15c47602020-03-26 22:16:48 +01001723# define MATH_FUNC(name) name
1724#else
1725# define MATH_FUNC(name) NULL
1726#endif
1727#ifdef FEAT_TIMERS
1728# define TIMER_FUNC(name) name
1729#else
1730# define TIMER_FUNC(name) NULL
1731#endif
1732#ifdef FEAT_JOB_CHANNEL
1733# define JOB_FUNC(name) name
1734#else
1735# define JOB_FUNC(name) NULL
1736#endif
1737#ifdef FEAT_PROP_POPUP
1738# define PROP_FUNC(name) name
1739#else
1740# define PROP_FUNC(name) NULL
1741#endif
1742#ifdef FEAT_SIGNS
1743# define SIGN_FUNC(name) name
1744#else
1745# define SIGN_FUNC(name) NULL
1746#endif
1747#ifdef FEAT_SOUND
1748# define SOUND_FUNC(name) name
1749#else
1750# define SOUND_FUNC(name) NULL
1751#endif
1752#ifdef FEAT_TERMINAL
1753# define TERM_FUNC(name) name
1754#else
1755# define TERM_FUNC(name) NULL
1756#endif
1757
Bram Moolenaarac92e252019-08-03 21:58:38 +02001758static funcentry_T global_functions[] =
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001759{
Bram Moolenaar94738d82020-10-21 14:25:07 +02001760 {"abs", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001761 ret_any, f_abs},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001762 {"acos", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001763 ret_float, f_acos},
Bram Moolenaarfa103972022-09-29 19:14:42 +01001764 {"add", 2, 2, FEARG_1, arg2_listblobmod_item,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001765 ret_first_arg, f_add},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001766 {"and", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001767 ret_number, f_and},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001768 {"append", 2, 2, FEARG_2, arg2_setline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001769 ret_number_bool, f_append},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001770 {"appendbufline", 3, 3, FEARG_3, arg3_setbufline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001771 ret_number_bool, f_appendbufline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001772 {"argc", 0, 1, 0, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001773 ret_number, f_argc},
1774 {"argidx", 0, 0, 0, NULL,
1775 ret_number, f_argidx},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001776 {"arglistid", 0, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001777 ret_number, f_arglistid},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001778 {"argv", 0, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001779 ret_argv, f_argv},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001780 {"asin", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001781 ret_float, f_asin},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001782 {"assert_beeps", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001783 ret_number_bool, f_assert_beeps},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001784 {"assert_equal", 2, 3, FEARG_2, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001785 ret_number_bool, f_assert_equal},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001786 {"assert_equalfile", 2, 3, FEARG_1, arg3_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001787 ret_number_bool, f_assert_equalfile},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001788 {"assert_exception", 1, 2, 0, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001789 ret_number_bool, f_assert_exception},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001790 {"assert_fails", 1, 5, FEARG_1, arg15_assert_fails,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001791 ret_number_bool, f_assert_fails},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001792 {"assert_false", 1, 2, FEARG_1, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001793 ret_number_bool, f_assert_false},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001794 {"assert_inrange", 3, 4, FEARG_3, arg34_assert_inrange,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001795 ret_number_bool, f_assert_inrange},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001796 {"assert_match", 2, 3, FEARG_2, arg3_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001797 ret_number_bool, f_assert_match},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001798 {"assert_nobeep", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar5b8cabf2021-04-02 18:55:57 +02001799 ret_number_bool, f_assert_nobeep},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001800 {"assert_notequal", 2, 3, FEARG_2, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001801 ret_number_bool, f_assert_notequal},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001802 {"assert_notmatch", 2, 3, FEARG_2, arg3_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001803 ret_number_bool, f_assert_notmatch},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02001804 {"assert_report", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001805 ret_number_bool, f_assert_report},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001806 {"assert_true", 1, 2, FEARG_1, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001807 ret_number_bool, f_assert_true},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001808 {"atan", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001809 ret_float, f_atan},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001810 {"atan2", 2, 2, FEARG_1, arg2_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001811 ret_float, f_atan2},
Yegappan Lakshmanan1755a912022-05-19 10:31:47 +01001812 {"autocmd_add", 1, 1, FEARG_1, arg1_list_any,
1813 ret_number_bool, f_autocmd_add},
1814 {"autocmd_delete", 1, 1, FEARG_1, arg1_list_any,
1815 ret_number_bool, f_autocmd_delete},
1816 {"autocmd_get", 0, 1, FEARG_1, arg1_dict_any,
1817 ret_list_dict_any, f_autocmd_get},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001818 {"balloon_gettext", 0, 0, 0, NULL,
1819 ret_string,
Bram Moolenaar59716a22017-03-01 20:32:44 +01001820#ifdef FEAT_BEVAL
Bram Moolenaar15c47602020-03-26 22:16:48 +01001821 f_balloon_gettext
1822#else
1823 NULL
Bram Moolenaar59716a22017-03-01 20:32:44 +01001824#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01001825 },
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02001826 {"balloon_show", 1, 1, FEARG_1, arg1_string_or_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001827 ret_void,
Bram Moolenaar15c47602020-03-26 22:16:48 +01001828#ifdef FEAT_BEVAL
1829 f_balloon_show
1830#else
1831 NULL
1832#endif
1833 },
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001834 {"balloon_split", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001835 ret_list_string,
Bram Moolenaar15c47602020-03-26 22:16:48 +01001836#if defined(FEAT_BEVAL_TERM)
1837 f_balloon_split
1838#else
1839 NULL
1840#endif
1841 },
Yegappan Lakshmanan810785c2024-12-30 10:29:44 +01001842 {"base64_decode", 1, 1, FEARG_1, arg1_string,
1843 ret_blob, f_base64_decode},
1844 {"base64_encode", 1, 1, FEARG_1, arg1_blob,
1845 ret_string, f_base64_encode},
Christ van Willegence0ef912024-06-20 23:41:59 +02001846 {"bindtextdomain", 2, 2, 0, arg2_string,
Christ van Willegen8252ef12024-07-11 21:36:21 +02001847 ret_bool, f_bindtextdomain},
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +02001848 {"blob2list", 1, 1, FEARG_1, arg1_blob,
1849 ret_list_number, f_blob2list},
Yegappan Lakshmanan1aefe1d2025-01-14 17:29:42 +01001850 {"blob2str", 1, 2, FEARG_1, arg2_blob_dict,
Yegappan Lakshmanan166b1752025-01-17 11:48:12 +01001851 ret_list_string, f_blob2str},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001852 {"browse", 4, 4, 0, arg4_browse,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001853 ret_string, f_browse},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001854 {"browsedir", 2, 2, 0, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001855 ret_string, f_browsedir},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001856 {"bufadd", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001857 ret_number, f_bufadd},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001858 {"bufexists", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001859 ret_number_bool, f_bufexists},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001860 {"buffer_exists", 1, 1, FEARG_1, arg1_buffer, // obsolete
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001861 ret_number_bool, f_bufexists},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001862 {"buffer_name", 0, 1, FEARG_1, arg1_buffer, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02001863 ret_string, f_bufname},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001864 {"buffer_number", 0, 1, FEARG_1, arg1_buffer, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02001865 ret_number, f_bufnr},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001866 {"buflisted", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001867 ret_number_bool, f_buflisted},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001868 {"bufload", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001869 ret_void, f_bufload},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001870 {"bufloaded", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001871 ret_number_bool, f_bufloaded},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001872 {"bufname", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001873 ret_string, f_bufname},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001874 {"bufnr", 0, 2, FEARG_1, arg2_buffer_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001875 ret_number, f_bufnr},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001876 {"bufwinid", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001877 ret_number, f_bufwinid},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001878 {"bufwinnr", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001879 ret_number, f_bufwinnr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001880 {"byte2line", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001881 ret_number, f_byte2line},
Christian Brabandt67672ef2023-04-24 21:09:54 +01001882 {"byteidx", 2, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001883 ret_number, f_byteidx},
Christian Brabandt67672ef2023-04-24 21:09:54 +01001884 {"byteidxcomp", 2, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001885 ret_number, f_byteidxcomp},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001886 {"call", 2, 3, FEARG_1, arg3_any_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001887 ret_any, f_call},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001888 {"ceil", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001889 ret_float, f_ceil},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001890 {"ch_canread", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001891 ret_number_bool, JOB_FUNC(f_ch_canread)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001892 {"ch_close", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001893 ret_void, JOB_FUNC(f_ch_close)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001894 {"ch_close_in", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001895 ret_void, JOB_FUNC(f_ch_close_in)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001896 {"ch_evalexpr", 2, 3, FEARG_1, arg23_chanexpr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001897 ret_any, JOB_FUNC(f_ch_evalexpr)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001898 {"ch_evalraw", 2, 3, FEARG_1, arg23_chanraw,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001899 ret_any, JOB_FUNC(f_ch_evalraw)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001900 {"ch_getbufnr", 2, 2, FEARG_1, arg2_chan_or_job_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001901 ret_number, JOB_FUNC(f_ch_getbufnr)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001902 {"ch_getjob", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001903 ret_job, JOB_FUNC(f_ch_getjob)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001904 {"ch_info", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001905 ret_dict_any, JOB_FUNC(f_ch_info)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001906 {"ch_log", 1, 2, FEARG_1, arg2_string_chan_or_job,
Bram Moolenaar4c5678f2022-11-30 18:12:19 +00001907 ret_void, f_ch_log},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001908 {"ch_logfile", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar4c5678f2022-11-30 18:12:19 +00001909 ret_void, f_ch_logfile},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001910 {"ch_open", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001911 ret_channel, JOB_FUNC(f_ch_open)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001912 {"ch_read", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001913 ret_string, JOB_FUNC(f_ch_read)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001914 {"ch_readblob", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001915 ret_blob, JOB_FUNC(f_ch_readblob)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001916 {"ch_readraw", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001917 ret_string, JOB_FUNC(f_ch_readraw)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001918 {"ch_sendexpr", 2, 3, FEARG_1, arg23_chanexpr,
Yegappan Lakshmanan3b470ae2022-04-16 10:41:27 +01001919 ret_any, JOB_FUNC(f_ch_sendexpr)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001920 {"ch_sendraw", 2, 3, FEARG_1, arg23_chanraw,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001921 ret_void, JOB_FUNC(f_ch_sendraw)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001922 {"ch_setoptions", 2, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001923 ret_void, JOB_FUNC(f_ch_setoptions)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001924 {"ch_status", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001925 ret_string, JOB_FUNC(f_ch_status)},
1926 {"changenr", 0, 0, 0, NULL,
1927 ret_number, f_changenr},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02001928 {"char2nr", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001929 ret_number, f_char2nr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001930 {"charclass", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001931 ret_number, f_charclass},
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00001932 {"charcol", 1, 2, FEARG_1, arg2_string_or_list_number,
Bram Moolenaar6f02b002021-01-10 20:22:54 +01001933 ret_number, f_charcol},
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01001934 {"charidx", 2, 4, FEARG_1, arg4_string_number_bool_bool,
Bram Moolenaar17793ef2020-12-28 12:56:58 +01001935 ret_number, f_charidx},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001936 {"chdir", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001937 ret_string, f_chdir},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001938 {"cindent", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001939 ret_number, f_cindent},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001940 {"clearmatches", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001941 ret_void, f_clearmatches},
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00001942 {"col", 1, 2, FEARG_1, arg2_string_or_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001943 ret_number, f_col},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001944 {"complete", 2, 2, FEARG_2, arg2_number_list,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001945 ret_void, f_complete},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001946 {"complete_add", 1, 1, FEARG_1, arg1_dict_or_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001947 ret_number, f_complete_add},
1948 {"complete_check", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001949 ret_number_bool, f_complete_check},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001950 {"complete_info", 0, 1, FEARG_1, arg1_list_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001951 ret_dict_any, f_complete_info},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001952 {"confirm", 1, 4, FEARG_1, arg4_string_string_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001953 ret_number, f_confirm},
1954 {"copy", 1, 1, FEARG_1, NULL,
Bram Moolenaar381692b2022-02-02 20:01:27 +00001955 ret_copy, f_copy},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001956 {"cos", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001957 ret_float, f_cos},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001958 {"cosh", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001959 ret_float, f_cosh},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001960 {"count", 2, 4, FEARG_1, arg24_count,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001961 ret_number, f_count},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001962 {"cscope_connection",0,3, 0, arg3_number_string_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001963 ret_number, f_cscope_connection},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001964 {"cursor", 1, 3, FEARG_1, arg13_cursor,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001965 ret_number, f_cursor},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001966 {"debugbreak", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001967 ret_number,
Bram Moolenaar4f974752019-02-17 17:44:42 +01001968#ifdef MSWIN
Bram Moolenaar15c47602020-03-26 22:16:48 +01001969 f_debugbreak
1970#else
1971 NULL
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02001972#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01001973 },
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001974 {"deepcopy", 1, 2, FEARG_1, arg12_deepcopy,
Bram Moolenaar381692b2022-02-02 20:01:27 +00001975 ret_copy, f_deepcopy},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001976 {"delete", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001977 ret_number_bool, f_delete},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001978 {"deletebufline", 2, 3, FEARG_1, arg3_buffer_lnum_lnum,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001979 ret_number_bool, f_deletebufline},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001980 {"did_filetype", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001981 ret_number_bool, f_did_filetype},
Yegappan Lakshmananfa378352024-02-01 22:05:27 +01001982 {"diff", 2, 3, FEARG_1, arg3_diff,
Yegappan Lakshmanana0010a12024-02-12 20:21:26 +01001983 ret_any, f_diff},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001984 {"diff_filler", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001985 ret_number, f_diff_filler},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001986 {"diff_hlID", 2, 2, FEARG_1, arg2_lnum_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001987 ret_number, f_diff_hlID},
h-east29b85712021-07-26 21:54:04 +02001988 {"digraph_get", 1, 1, FEARG_1, arg1_string,
1989 ret_string, f_digraph_get},
zeertzjqd4d12072024-07-16 20:34:16 +02001990 {"digraph_getlist", 0, 1, FEARG_1, arg1_bool,
h-east29b85712021-07-26 21:54:04 +02001991 ret_list_string_items, f_digraph_getlist},
Yegappan Lakshmananfc3b7752021-09-08 14:57:42 +02001992 {"digraph_set", 2, 2, FEARG_1, arg2_string,
h-east29b85712021-07-26 21:54:04 +02001993 ret_bool, f_digraph_set},
zeertzjqd4d12072024-07-16 20:34:16 +02001994 {"digraph_setlist", 1, 1, FEARG_1, arg1_list_string,
h-east29b85712021-07-26 21:54:04 +02001995 ret_bool, f_digraph_setlist},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001996 {"echoraw", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001997 ret_void, f_echoraw},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001998 {"empty", 1, 1, FEARG_1, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001999 ret_number_bool, f_empty},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002000 {"environ", 0, 0, 0, NULL,
2001 ret_dict_string, f_environ},
Bram Moolenaar80adaa82023-07-07 18:57:40 +01002002 {"err_teapot", 0, 1, 0, NULL,
2003 ret_number_bool, f_err_teapot},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002004 {"escape", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002005 ret_string, f_escape},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002006 {"eval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002007 ret_any, f_eval},
2008 {"eventhandler", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002009 ret_number_bool, f_eventhandler},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002010 {"executable", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002011 ret_number, f_executable},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002012 {"execute", 1, 2, FEARG_1, arg12_execute,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002013 ret_string, f_execute},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002014 {"exepath", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002015 ret_string, f_exepath},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002016 {"exists", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002017 ret_number_bool, f_exists},
Bram Moolenaar26735992021-08-08 14:43:22 +02002018 {"exists_compiled", 1, 1, FEARG_1, arg1_string,
2019 ret_number_bool, f_exists_compiled},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002020 {"exp", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002021 ret_float, f_exp},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002022 {"expand", 1, 3, FEARG_1, arg3_string_bool_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002023 ret_any, f_expand},
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01002024 {"expandcmd", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002025 ret_string, f_expandcmd},
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01002026 {"extend", 2, 3, FEARG_1, arg23_extend,
Bram Moolenaar81330182022-02-01 12:11:58 +00002027 ret_extend, f_extend},
Bram Moolenaarb0e6b512021-01-12 20:23:40 +01002028 {"extendnew", 2, 3, FEARG_1, arg23_extendnew,
2029 ret_first_cont, f_extendnew},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002030 {"feedkeys", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002031 ret_void, f_feedkeys},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002032 {"file_readable", 1, 1, FEARG_1, arg1_string, // obsolete
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002033 ret_number_bool, f_filereadable},
Shougo Matsushita60c87432024-06-03 22:59:27 +02002034 {"filecopy", 2, 2, FEARG_1, arg2_string,
2035 ret_number_bool, f_filecopy},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002036 {"filereadable", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002037 ret_number_bool, f_filereadable},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002038 {"filewritable", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002039 ret_number, f_filewritable},
Bram Moolenaar18024052021-12-25 21:43:28 +00002040 {"filter", 2, 2, FEARG_1, arg2_filter,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002041 ret_first_arg, f_filter},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002042 {"finddir", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar08018222021-12-22 18:45:37 +00002043 ret_finddir, f_finddir},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002044 {"findfile", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar10c83dd2021-09-04 14:49:56 +02002045 ret_any, f_findfile},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002046 {"flatten", 1, 2, FEARG_1, arg2_list_any_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002047 ret_list_any, f_flatten},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002048 {"flattennew", 1, 2, FEARG_1, arg2_list_any_number,
Bram Moolenaar3b690062021-02-01 20:14:51 +01002049 ret_list_any, f_flattennew},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002050 {"float2nr", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002051 ret_number, f_float2nr},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002052 {"floor", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002053 ret_float, f_floor},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002054 {"fmod", 2, 2, FEARG_1, arg2_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002055 ret_float, f_fmod},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002056 {"fnameescape", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002057 ret_string, f_fnameescape},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002058 {"fnamemodify", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002059 ret_string, f_fnamemodify},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002060 {"foldclosed", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002061 ret_number, f_foldclosed},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002062 {"foldclosedend", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002063 ret_number, f_foldclosedend},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002064 {"foldlevel", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002065 ret_number, f_foldlevel},
2066 {"foldtext", 0, 0, 0, NULL,
2067 ret_string, f_foldtext},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002068 {"foldtextresult", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002069 ret_string, f_foldtextresult},
Ernie Raele79e2072024-01-13 11:47:33 +01002070 {"foreach", 2, 2, FEARG_1, arg2_foreach,
2071 ret_first_arg, f_foreach},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002072 {"foreground", 0, 0, 0, NULL,
2073 ret_void, f_foreground},
Bram Moolenaardd44b582022-09-15 22:03:57 +01002074 {"fullcommand", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar038e09e2021-02-06 12:38:51 +01002075 ret_string, f_fullcommand},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002076 {"funcref", 1, 3, FEARG_1, arg3_any_list_dict,
Bram Moolenaar2f9f4cc2021-12-20 09:36:27 +00002077 ret_func_unknown, f_funcref},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002078 {"function", 1, 3, FEARG_1, arg3_any_list_dict,
Bram Moolenaar2f9f4cc2021-12-20 09:36:27 +00002079 ret_func_unknown, f_function},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002080 {"garbagecollect", 0, 1, 0, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002081 ret_void, f_garbagecollect},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002082 {"get", 2, 3, FEARG_1, arg23_get,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002083 ret_any, f_get},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002084 {"getbufinfo", 0, 1, FEARG_1, arg1_buffer_or_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002085 ret_list_dict_any, f_getbufinfo},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002086 {"getbufline", 2, 3, FEARG_1, arg3_buffer_lnum_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002087 ret_list_string, f_getbufline},
Bram Moolenaarce30ccc2022-11-21 19:57:04 +00002088 {"getbufoneline", 2, 2, FEARG_1, arg2_buffer_lnum,
2089 ret_string, f_getbufoneline},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002090 {"getbufvar", 2, 3, FEARG_1, arg3_buffer_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002091 ret_any, f_getbufvar},
mikoto20001083cae2024-11-11 21:24:14 +01002092 {"getcellpixels", 0, 0, 0, NULL,
mikoto2000a73dfc22024-11-18 21:12:21 +01002093 ret_list_any, f_getcellpixels},
Kota Kato66bb9ae2023-01-17 18:31:56 +00002094 {"getcellwidths", 0, 0, 0, NULL,
2095 ret_list_any, f_getcellwidths},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002096 {"getchangelist", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002097 ret_list_any, f_getchangelist},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002098 {"getchar", 0, 1, 0, arg1_bool,
Bram Moolenaar3a7503c2021-06-07 18:29:17 +02002099 ret_any, f_getchar},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002100 {"getcharmod", 0, 0, 0, NULL,
2101 ret_number, f_getcharmod},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002102 {"getcharpos", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar6f02b002021-01-10 20:22:54 +01002103 ret_list_number, f_getcharpos},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002104 {"getcharsearch", 0, 0, 0, NULL,
2105 ret_dict_any, f_getcharsearch},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002106 {"getcharstr", 0, 1, 0, arg1_bool,
Bram Moolenaar3a7503c2021-06-07 18:29:17 +02002107 ret_string, f_getcharstr},
Ruslan Russkikh0407d622024-10-08 22:21:05 +02002108 {"getcmdcomplpat", 0, 0, 0, NULL,
2109 ret_string, f_getcmdcomplpat},
Shougo Matsushita79d599b2022-05-07 12:48:29 +01002110 {"getcmdcompltype", 0, 0, 0, NULL,
2111 ret_string, f_getcmdcompltype},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002112 {"getcmdline", 0, 0, 0, NULL,
2113 ret_string, f_getcmdline},
2114 {"getcmdpos", 0, 0, 0, NULL,
2115 ret_number, f_getcmdpos},
Shougo Matsushita69084282024-09-23 20:34:47 +02002116 {"getcmdprompt", 0, 0, 0, NULL,
2117 ret_string, f_getcmdprompt},
Shougo Matsushita79d599b2022-05-07 12:48:29 +01002118 {"getcmdscreenpos", 0, 0, 0, NULL,
2119 ret_number, f_getcmdscreenpos},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002120 {"getcmdtype", 0, 0, 0, NULL,
2121 ret_string, f_getcmdtype},
2122 {"getcmdwintype", 0, 0, 0, NULL,
2123 ret_string, f_getcmdwintype},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002124 {"getcompletion", 2, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002125 ret_list_string, f_getcompletion},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002126 {"getcurpos", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002127 ret_list_number, f_getcurpos},
Bram Moolenaar82e46e52022-02-05 18:12:34 +00002128 {"getcursorcharpos", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar6f02b002021-01-10 20:22:54 +01002129 ret_list_number, f_getcursorcharpos},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002130 {"getcwd", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002131 ret_string, f_getcwd},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002132 {"getenv", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar7ad67d12021-03-10 16:08:26 +01002133 ret_any, f_getenv},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002134 {"getfontname", 0, 1, 0, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002135 ret_string, f_getfontname},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002136 {"getfperm", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002137 ret_string, f_getfperm},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002138 {"getfsize", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002139 ret_number, f_getfsize},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002140 {"getftime", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002141 ret_number, f_getftime},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002142 {"getftype", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002143 ret_string, f_getftype},
2144 {"getimstatus", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002145 ret_number_bool, f_getimstatus},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002146 {"getjumplist", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002147 ret_list_any, f_getjumplist},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002148 {"getline", 1, 2, FEARG_1, arg2_lnum,
Bram Moolenaar078a4612022-01-04 15:17:03 +00002149 ret_getline, f_getline},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002150 {"getloclist", 1, 2, 0, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002151 ret_list_or_dict_1, f_getloclist},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002152 {"getmarklist", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002153 ret_list_dict_any, f_getmarklist},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002154 {"getmatches", 0, 1, 0, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002155 ret_list_dict_any, f_getmatches},
2156 {"getmousepos", 0, 0, 0, NULL,
2157 ret_dict_number, f_getmousepos},
Bram Moolenaar24dc19c2022-11-14 19:49:15 +00002158 {"getmouseshape", 0, 0, 0, NULL,
2159 ret_string, f_getmouseshape},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002160 {"getpid", 0, 0, 0, NULL,
2161 ret_number, f_getpid},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002162 {"getpos", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002163 ret_list_number, f_getpos},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002164 {"getqflist", 0, 1, 0, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002165 ret_list_or_dict_0, f_getqflist},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002166 {"getreg", 0, 3, FEARG_1, arg3_string_bool_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002167 ret_getreg, f_getreg},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002168 {"getreginfo", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002169 ret_dict_any, f_getreginfo},
Shougo Matsushita19b71882024-02-28 22:48:12 +01002170 {"getregion", 2, 3, FEARG_1, arg3_list_list_dict,
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01002171 ret_list_string, f_getregion},
zeertzjqd4d12072024-07-16 20:34:16 +02002172 {"getregionpos", 2, 3, FEARG_1, arg3_list_list_dict,
2173 ret_list_regionpos, f_getregionpos},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002174 {"getregtype", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002175 ret_string, f_getregtype},
Yegappan Lakshmanan520f6ef2022-08-25 17:40:40 +01002176 {"getscriptinfo", 0, 1, 0, arg1_dict_any,
Yegappan Lakshmananf768c3d2022-08-22 13:15:13 +01002177 ret_list_dict_any, f_getscriptinfo},
ichizok663d18d2025-01-02 18:06:00 +01002178 {"getstacktrace", 0, 0, 0, NULL,
2179 ret_list_dict_any, f_getstacktrace},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002180 {"gettabinfo", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002181 ret_list_dict_any, f_gettabinfo},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002182 {"gettabvar", 2, 3, FEARG_1, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002183 ret_any, f_gettabvar},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002184 {"gettabwinvar", 3, 4, FEARG_1, arg4_number_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002185 ret_any, f_gettabwinvar},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002186 {"gettagstack", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002187 ret_dict_any, f_gettagstack},
Christ van Willegence0ef912024-06-20 23:41:59 +02002188 {"gettext", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002189 ret_string, f_gettext},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002190 {"getwininfo", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002191 ret_list_dict_any, f_getwininfo},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002192 {"getwinpos", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002193 ret_list_number, f_getwinpos},
2194 {"getwinposx", 0, 0, 0, NULL,
2195 ret_number, f_getwinposx},
2196 {"getwinposy", 0, 0, 0, NULL,
2197 ret_number, f_getwinposy},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002198 {"getwinvar", 2, 3, FEARG_1, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002199 ret_any, f_getwinvar},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002200 {"glob", 1, 4, FEARG_1, arg14_glob,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002201 ret_any, f_glob},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002202 {"glob2regpat", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002203 ret_string, f_glob2regpat},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002204 {"globpath", 2, 5, FEARG_2, arg25_globpath,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002205 ret_any, f_globpath},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002206 {"has", 1, 2, 0, arg2_string_bool,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002207 ret_number_bool, f_has},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002208 {"has_key", 2, 2, FEARG_1, arg2_dict_any_string_or_nr,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002209 ret_number_bool, f_has_key},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002210 {"haslocaldir", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002211 ret_number, f_haslocaldir},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002212 {"hasmapto", 1, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002213 ret_number_bool, f_hasmapto},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002214 {"highlightID", 1, 1, FEARG_1, arg1_string, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02002215 ret_number, f_hlID},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002216 {"highlight_exists",1, 1, FEARG_1, arg1_string, // obsolete
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002217 ret_number_bool, f_hlexists},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002218 {"histadd", 2, 2, FEARG_2, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002219 ret_number_bool, f_histadd},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002220 {"histdel", 1, 2, FEARG_1, arg2_string_string_or_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002221 ret_number_bool, f_histdel},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002222 {"histget", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002223 ret_string, f_histget},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002224 {"histnr", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002225 ret_number, f_histnr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002226 {"hlID", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002227 ret_number, f_hlID},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002228 {"hlexists", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002229 ret_number_bool, f_hlexists},
Yegappan Lakshmanand1a8d652021-11-03 21:56:45 +00002230 {"hlget", 0, 2, FEARG_1, arg2_string_bool,
2231 ret_list_dict_any, f_hlget},
2232 {"hlset", 1, 1, FEARG_1, arg1_list_any,
2233 ret_number_bool, f_hlset},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002234 {"hostname", 0, 0, 0, NULL,
2235 ret_string, f_hostname},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002236 {"iconv", 3, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002237 ret_string, f_iconv},
Ernie Raelc8e158b2024-07-09 18:39:52 +02002238 {"id", 1, 1, FEARG_1, NULL,
2239 ret_string, f_id},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002240 {"indent", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002241 ret_number, f_indent},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002242 {"index", 2, 4, FEARG_1, arg24_index,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002243 ret_number, f_index},
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01002244 {"indexof", 2, 3, FEARG_1, arg23_index,
2245 ret_number, f_indexof},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002246 {"input", 1, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002247 ret_string, f_input},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002248 {"inputdialog", 1, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002249 ret_string, f_inputdialog},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002250 {"inputlist", 1, 1, FEARG_1, arg1_list_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002251 ret_number, f_inputlist},
2252 {"inputrestore", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002253 ret_number_bool, f_inputrestore},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002254 {"inputsave", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002255 ret_number_bool, f_inputsave},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002256 {"inputsecret", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002257 ret_string, f_inputsecret},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002258 {"insert", 2, 3, FEARG_1, arg23_insert,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002259 ret_first_arg, f_insert},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002260 {"instanceof", 2, VARGS, FEARG_1|FE_X, arg2_instanceof,
LemonBoyafe04662023-08-23 21:08:11 +02002261 ret_bool, f_instanceof},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002262 {"interrupt", 0, 0, 0, NULL,
2263 ret_void, f_interrupt},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002264 {"invert", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002265 ret_number, f_invert},
LemonBoydca1d402022-04-28 15:26:33 +01002266 {"isabsolutepath", 1, 1, FEARG_1, arg1_string,
2267 ret_number_bool, f_isabsolutepath},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002268 {"isdirectory", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002269 ret_number_bool, f_isdirectory},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002270 {"isinf", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002271 ret_number, MATH_FUNC(f_isinf)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002272 {"islocked", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002273 ret_number_bool, f_islocked},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002274 {"isnan", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002275 ret_number_bool, MATH_FUNC(f_isnan)},
Bram Moolenaar3e518a82022-08-30 17:45:33 +01002276 {"items", 1, 1, FEARG_1, arg1_string_or_list_or_dict,
Bram Moolenaarefc5db52021-07-07 21:21:30 +02002277 ret_list_items, f_items},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002278 {"job_getchannel", 1, 1, FEARG_1, arg1_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002279 ret_channel, JOB_FUNC(f_job_getchannel)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002280 {"job_info", 0, 1, FEARG_1, arg1_job,
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01002281 ret_job_info, JOB_FUNC(f_job_info)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002282 {"job_setoptions", 2, 2, FEARG_1, arg2_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002283 ret_void, JOB_FUNC(f_job_setoptions)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002284 {"job_start", 1, 2, FEARG_1, arg2_string_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002285 ret_job, JOB_FUNC(f_job_start)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002286 {"job_status", 1, 1, FEARG_1, arg1_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002287 ret_string, JOB_FUNC(f_job_status)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002288 {"job_stop", 1, 2, FEARG_1, arg2_job_string_or_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002289 ret_number_bool, JOB_FUNC(f_job_stop)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002290 {"join", 1, 2, FEARG_1, arg2_list_any_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002291 ret_string, f_join},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002292 {"js_decode", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002293 ret_any, f_js_decode},
2294 {"js_encode", 1, 1, FEARG_1, NULL,
2295 ret_string, f_js_encode},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002296 {"json_decode", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002297 ret_any, f_json_decode},
2298 {"json_encode", 1, 1, FEARG_1, NULL,
2299 ret_string, f_json_encode},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002300 {"keys", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002301 ret_list_string, f_keys},
zeertzjqcdc83932022-09-12 13:38:41 +01002302 {"keytrans", 1, 1, FEARG_1, arg1_string,
2303 ret_string, f_keytrans},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002304 {"last_buffer_nr", 0, 0, 0, NULL, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02002305 ret_number, f_last_buffer_nr},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002306 {"len", 1, 1, FEARG_1, arg1_len,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002307 ret_number, f_len},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002308 {"libcall", 3, 3, FEARG_3, arg3_libcall,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002309 ret_string, f_libcall},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002310 {"libcallnr", 3, 3, FEARG_3, arg3_libcall,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002311 ret_number, f_libcallnr},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002312 {"line", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002313 ret_number, f_line},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002314 {"line2byte", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002315 ret_number, f_line2byte},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002316 {"lispindent", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002317 ret_number, f_lispindent},
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +02002318 {"list2blob", 1, 1, FEARG_1, arg1_list_number,
2319 ret_blob, f_list2blob},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002320 {"list2str", 1, 2, FEARG_1, arg2_list_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002321 ret_string, f_list2str},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002322 {"listener_add", 1, 2, FEARG_2, arg2_any_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002323 ret_number, f_listener_add},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002324 {"listener_flush", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002325 ret_void, f_listener_flush},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002326 {"listener_remove", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002327 ret_number_bool, f_listener_remove},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002328 {"localtime", 0, 0, 0, NULL,
2329 ret_number, f_localtime},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002330 {"log", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002331 ret_float, f_log},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002332 {"log10", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002333 ret_float, f_log10},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002334 {"luaeval", 1, 2, FEARG_1, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002335 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002336#ifdef FEAT_LUA
Bram Moolenaar15c47602020-03-26 22:16:48 +01002337 f_luaeval
2338#else
2339 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002340#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002341 },
Bram Moolenaar18024052021-12-25 21:43:28 +00002342 {"map", 2, 2, FEARG_1, arg2_map,
Bram Moolenaarea696852020-11-09 18:31:39 +01002343 ret_first_cont, f_map},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002344 {"maparg", 1, 4, FEARG_1, arg14_maparg,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002345 ret_maparg, f_maparg},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002346 {"mapcheck", 1, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002347 ret_string, f_mapcheck},
Ernie Rael09661202022-04-25 14:40:44 +01002348 {"maplist", 0, 1, 0, arg1_bool,
2349 ret_list_dict_any, f_maplist},
Bram Moolenaar18024052021-12-25 21:43:28 +00002350 {"mapnew", 2, 2, FEARG_1, arg2_mapnew,
Bram Moolenaarea696852020-11-09 18:31:39 +01002351 ret_first_cont, f_mapnew},
Ernie Rael51d04d12022-05-04 15:40:22 +01002352 {"mapset", 1, 3, FEARG_1, arg3_string_or_dict_bool_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002353 ret_void, f_mapset},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002354 {"match", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002355 ret_any, f_match},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002356 {"matchadd", 2, 5, FEARG_1, arg25_matchadd,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002357 ret_number, f_matchadd},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002358 {"matchaddpos", 2, 5, FEARG_1, arg25_matchaddpos,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002359 ret_number, f_matchaddpos},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002360 {"matcharg", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002361 ret_list_string, f_matcharg},
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01002362 {"matchbufline", 4, 5, FEARG_1, arg45_matchbufline,
2363 ret_list_any, f_matchbufline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002364 {"matchdelete", 1, 2, FEARG_1, arg2_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002365 ret_number_bool, f_matchdelete},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002366 {"matchend", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002367 ret_number, f_matchend},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002368 {"matchfuzzy", 2, 3, FEARG_1, arg3_list_string_dict,
Yegappan Lakshmanan2d8e9982023-06-24 16:42:25 +01002369 ret_list_any, f_matchfuzzy},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002370 {"matchfuzzypos", 2, 3, FEARG_1, arg3_list_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002371 ret_list_any, f_matchfuzzypos},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002372 {"matchlist", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002373 ret_list_string, f_matchlist},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002374 {"matchstr", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002375 ret_string, f_matchstr},
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01002376 {"matchstrlist", 2, 3, FEARG_1, arg23_matchstrlist,
2377 ret_list_any, f_matchstrlist},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002378 {"matchstrpos", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002379 ret_list_any, f_matchstrpos},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002380 {"max", 1, 1, FEARG_1, arg1_list_or_dict,
Bram Moolenaar9ae37052021-01-22 22:31:10 +01002381 ret_number, f_max},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002382 {"menu_info", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002383 ret_dict_any,
Bram Moolenaara2cbdea2020-03-16 21:08:31 +01002384#ifdef FEAT_MENU
Bram Moolenaar15c47602020-03-26 22:16:48 +01002385 f_menu_info
2386#else
2387 NULL
Bram Moolenaara2cbdea2020-03-16 21:08:31 +01002388#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002389 },
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002390 {"min", 1, 1, FEARG_1, arg1_list_or_dict,
Bram Moolenaar9ae37052021-01-22 22:31:10 +01002391 ret_number, f_min},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002392 {"mkdir", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002393 ret_number_bool, f_mkdir},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002394 {"mode", 0, 1, FEARG_1, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002395 ret_string, f_mode},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002396 {"mzeval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002397 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002398#ifdef FEAT_MZSCHEME
Bram Moolenaar15c47602020-03-26 22:16:48 +01002399 f_mzeval
2400#else
2401 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002402#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002403 },
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002404 {"nextnonblank", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002405 ret_number, f_nextnonblank},
Christ van Willegenc0786752025-02-01 15:42:16 +01002406 {"ngettext", 3, 4, FEARG_3, arg4_string_string_number_string,
2407 ret_string, f_ngettext},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002408 {"nr2char", 1, 2, FEARG_1, arg2_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002409 ret_string, f_nr2char},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002410 {"or", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002411 ret_number, f_or},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002412 {"pathshorten", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002413 ret_string, f_pathshorten},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002414 {"perleval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002415 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002416#ifdef FEAT_PERL
Bram Moolenaar15c47602020-03-26 22:16:48 +01002417 f_perleval
2418#else
2419 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002420#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002421 },
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002422 {"popup_atcursor", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002423 ret_number, PROP_FUNC(f_popup_atcursor)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002424 {"popup_beval", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002425 ret_number, PROP_FUNC(f_popup_beval)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002426 {"popup_clear", 0, 1, 0, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002427 ret_void, PROP_FUNC(f_popup_clear)},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002428 {"popup_close", 1, 2, FEARG_1, arg2_number_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002429 ret_void, PROP_FUNC(f_popup_close)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002430 {"popup_create", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002431 ret_number, PROP_FUNC(f_popup_create)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002432 {"popup_dialog", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002433 ret_number, PROP_FUNC(f_popup_dialog)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002434 {"popup_filter_menu", 2, 2, 0, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002435 ret_bool, PROP_FUNC(f_popup_filter_menu)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002436 {"popup_filter_yesno", 2, 2, 0, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002437 ret_bool, PROP_FUNC(f_popup_filter_yesno)},
Bram Moolenaarbdc09a12022-10-07 14:31:45 +01002438 {"popup_findecho", 0, 0, 0, NULL,
2439 ret_number, PROP_FUNC(f_popup_findecho)},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002440 {"popup_findinfo", 0, 0, 0, NULL,
2441 ret_number, PROP_FUNC(f_popup_findinfo)},
2442 {"popup_findpreview", 0, 0, 0, NULL,
2443 ret_number, PROP_FUNC(f_popup_findpreview)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002444 {"popup_getoptions", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002445 ret_dict_any, PROP_FUNC(f_popup_getoptions)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002446 {"popup_getpos", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002447 ret_dict_any, PROP_FUNC(f_popup_getpos)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002448 {"popup_hide", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002449 ret_void, PROP_FUNC(f_popup_hide)},
2450 {"popup_list", 0, 0, 0, NULL,
2451 ret_list_number, PROP_FUNC(f_popup_list)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002452 {"popup_locate", 2, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002453 ret_number, PROP_FUNC(f_popup_locate)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002454 {"popup_menu", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002455 ret_number, PROP_FUNC(f_popup_menu)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002456 {"popup_move", 2, 2, FEARG_1, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002457 ret_void, PROP_FUNC(f_popup_move)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002458 {"popup_notification", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002459 ret_number, PROP_FUNC(f_popup_notification)},
Christian Brabandtfbc37f12024-06-18 20:50:58 +02002460 {"popup_setbuf", 2, 2, FEARG_1, arg2_number_buffer,
2461 ret_number_bool, PROP_FUNC(f_popup_setbuf)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002462 {"popup_setoptions", 2, 2, FEARG_1, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002463 ret_void, PROP_FUNC(f_popup_setoptions)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002464 {"popup_settext", 2, 2, FEARG_1, arg2_number_string_or_list,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002465 ret_void, PROP_FUNC(f_popup_settext)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002466 {"popup_show", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002467 ret_void, PROP_FUNC(f_popup_show)},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002468 {"pow", 2, 2, FEARG_1, arg2_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002469 ret_float, f_pow},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002470 {"prevnonblank", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002471 ret_number, f_prevnonblank},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002472 {"printf", 1, 19, FEARG_2, arg119_printf,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002473 ret_string, f_printf},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002474 {"prompt_getprompt", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002475 ret_string, JOB_FUNC(f_prompt_getprompt)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002476 {"prompt_setcallback", 2, 2, FEARG_1, arg2_buffer_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002477 ret_void, JOB_FUNC(f_prompt_setcallback)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002478 {"prompt_setinterrupt", 2, 2, FEARG_1, arg2_buffer_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002479 ret_void, JOB_FUNC(f_prompt_setinterrupt)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002480 {"prompt_setprompt", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002481 ret_void, JOB_FUNC(f_prompt_setprompt)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002482 {"prop_add", 3, 3, FEARG_1, arg3_number_number_dict,
Bram Moolenaar7f9969c2022-07-25 18:13:54 +01002483 ret_number, PROP_FUNC(f_prop_add)},
Yegappan Lakshmananccfb7c62021-08-16 21:39:09 +02002484 {"prop_add_list", 2, 2, FEARG_1, arg2_dict_any_list_any,
2485 ret_void, PROP_FUNC(f_prop_add_list)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002486 {"prop_clear", 1, 3, FEARG_1, arg3_number_number_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002487 ret_void, PROP_FUNC(f_prop_clear)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002488 {"prop_find", 1, 2, FEARG_1, arg2_dict_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002489 ret_dict_any, PROP_FUNC(f_prop_find)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002490 {"prop_list", 1, 2, FEARG_1, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002491 ret_list_dict_any, PROP_FUNC(f_prop_list)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002492 {"prop_remove", 1, 3, FEARG_1, arg3_dict_number_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002493 ret_number, PROP_FUNC(f_prop_remove)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002494 {"prop_type_add", 2, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002495 ret_void, PROP_FUNC(f_prop_type_add)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002496 {"prop_type_change", 2, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002497 ret_void, PROP_FUNC(f_prop_type_change)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002498 {"prop_type_delete", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002499 ret_void, PROP_FUNC(f_prop_type_delete)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002500 {"prop_type_get", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002501 ret_dict_any, PROP_FUNC(f_prop_type_get)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002502 {"prop_type_list", 0, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002503 ret_list_string, PROP_FUNC(f_prop_type_list)},
2504 {"pum_getpos", 0, 0, 0, NULL,
2505 ret_dict_number, f_pum_getpos},
2506 {"pumvisible", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002507 ret_number_bool, f_pumvisible},
Ben Jacksonea19e782024-11-06 21:50:05 +01002508 {"py3eval", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002509 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002510#ifdef FEAT_PYTHON3
Bram Moolenaar15c47602020-03-26 22:16:48 +01002511 f_py3eval
2512#else
2513 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002514#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002515 },
Ben Jacksonea19e782024-11-06 21:50:05 +01002516 {"pyeval", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002517 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002518#ifdef FEAT_PYTHON
Bram Moolenaar15c47602020-03-26 22:16:48 +01002519 f_pyeval
2520#else
2521 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002522#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002523 },
Ben Jacksonea19e782024-11-06 21:50:05 +01002524 {"pyxeval", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002525 ret_any,
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01002526#if defined(FEAT_PYTHON) || defined(FEAT_PYTHON3)
Bram Moolenaar15c47602020-03-26 22:16:48 +01002527 f_pyxeval
2528#else
2529 NULL
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01002530#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002531 },
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002532 {"rand", 0, 1, FEARG_1, arg1_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002533 ret_number, f_rand},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002534 {"range", 1, 3, FEARG_1, arg3_number,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00002535 ret_list_number, f_range},
K.Takata11df3ae2022-10-19 14:02:40 +01002536 {"readblob", 1, 3, FEARG_1, arg3_string_number_number,
Bram Moolenaarc423ad72021-01-13 20:38:03 +01002537 ret_blob, f_readblob},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002538 {"readdir", 1, 3, FEARG_1, arg3_string_any_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002539 ret_list_string, f_readdir},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002540 {"readdirex", 1, 3, FEARG_1, arg3_string_any_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002541 ret_list_dict_any, f_readdirex},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002542 {"readfile", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaarc423ad72021-01-13 20:38:03 +01002543 ret_list_string, f_readfile},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002544 {"reduce", 2, 3, FEARG_1, arg23_reduce,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002545 ret_any, f_reduce},
2546 {"reg_executing", 0, 0, 0, NULL,
2547 ret_string, f_reg_executing},
2548 {"reg_recording", 0, 0, 0, NULL,
2549 ret_string, f_reg_recording},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002550 {"reltime", 0, 2, FEARG_1, arg2_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002551 ret_list_any, f_reltime},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002552 {"reltimefloat", 1, 1, FEARG_1, arg1_list_number,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002553 ret_float, f_reltimefloat},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002554 {"reltimestr", 1, 1, FEARG_1, arg1_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002555 ret_string, f_reltimestr},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002556 {"remote_expr", 2, 4, FEARG_1, arg24_remote_expr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002557 ret_string, f_remote_expr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002558 {"remote_foreground", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002559 ret_string, f_remote_foreground},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002560 {"remote_peek", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002561 ret_number, f_remote_peek},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002562 {"remote_read", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002563 ret_string, f_remote_read},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002564 {"remote_send", 2, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002565 ret_string, f_remote_send},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002566 {"remote_startserver", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002567 ret_void, f_remote_startserver},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002568 {"remove", 2, 3, FEARG_1, arg23_remove,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002569 ret_remove, f_remove},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002570 {"rename", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002571 ret_number_bool, f_rename},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002572 {"repeat", 2, 2, FEARG_1, arg2_repeat,
Bram Moolenaar1780f082021-07-31 22:03:59 +02002573 ret_repeat, f_repeat},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002574 {"resolve", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002575 ret_string, f_resolve},
Yegappan Lakshmananf9dc2782023-05-11 15:02:56 +01002576 {"reverse", 1, 1, FEARG_1, arg1_string_or_list_or_blob_mod,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002577 ret_first_arg, f_reverse},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002578 {"round", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002579 ret_float, f_round},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002580 {"rubyeval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002581 ret_any,
Bram Moolenaare99be0e2019-03-26 22:51:09 +01002582#ifdef FEAT_RUBY
Bram Moolenaar15c47602020-03-26 22:16:48 +01002583 f_rubyeval
2584#else
2585 NULL
Bram Moolenaare99be0e2019-03-26 22:51:09 +01002586#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002587 },
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002588 {"screenattr", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002589 ret_number, f_screenattr},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002590 {"screenchar", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002591 ret_number, f_screenchar},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002592 {"screenchars", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002593 ret_list_number, f_screenchars},
2594 {"screencol", 0, 0, 0, NULL,
2595 ret_number, f_screencol},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002596 {"screenpos", 3, 3, FEARG_1, arg3_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002597 ret_dict_number, f_screenpos},
2598 {"screenrow", 0, 0, 0, NULL,
2599 ret_number, f_screenrow},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002600 {"screenstring", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002601 ret_string, f_screenstring},
Bram Moolenaarcd268012021-07-22 19:11:08 +02002602 {"search", 1, 5, FEARG_1, arg15_search,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002603 ret_number, f_search},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002604 {"searchcount", 0, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002605 ret_dict_any, f_searchcount},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002606 {"searchdecl", 1, 3, FEARG_1, arg3_string_bool_bool,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002607 ret_number_bool, f_searchdecl},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002608 {"searchpair", 3, 7, 0, arg37_searchpair,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002609 ret_number, f_searchpair},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002610 {"searchpairpos", 3, 7, 0, arg37_searchpair,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002611 ret_list_number, f_searchpairpos},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002612 {"searchpos", 1, 5, FEARG_1, arg15_search,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002613 ret_list_number, f_searchpos},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002614 {"server2client", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002615 ret_number_bool, f_server2client},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002616 {"serverlist", 0, 0, 0, NULL,
2617 ret_string, f_serverlist},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002618 {"setbufline", 3, 3, FEARG_3, arg3_setbufline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002619 ret_number_bool, f_setbufline},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002620 {"setbufvar", 3, 3, FEARG_3, arg3_buffer_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002621 ret_void, f_setbufvar},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002622 {"setcellwidths", 1, 1, FEARG_1, arg1_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002623 ret_void, f_setcellwidths},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002624 {"setcharpos", 2, 2, FEARG_2, arg2_string_list_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002625 ret_number_bool, f_setcharpos},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002626 {"setcharsearch", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002627 ret_void, f_setcharsearch},
Shougo Matsushita07ea5f12022-08-27 12:22:25 +01002628 {"setcmdline", 1, 2, FEARG_1, arg2_string_number,
2629 ret_number_bool, f_setcmdline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002630 {"setcmdpos", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002631 ret_number_bool, f_setcmdpos},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002632 {"setcursorcharpos", 1, 3, FEARG_1, arg13_cursor,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002633 ret_number_bool, f_setcursorcharpos},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002634 {"setenv", 2, 2, FEARG_2, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002635 ret_void, f_setenv},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002636 {"setfperm", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002637 ret_number_bool, f_setfperm},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002638 {"setline", 2, 2, FEARG_2, arg2_setline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002639 ret_number_bool, f_setline},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002640 {"setloclist", 2, 4, FEARG_2, arg24_setloclist,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002641 ret_number_bool, f_setloclist},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002642 {"setmatches", 1, 2, FEARG_1, arg2_list_any_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002643 ret_number_bool, f_setmatches},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002644 {"setpos", 2, 2, FEARG_2, arg2_string_list_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002645 ret_number_bool, f_setpos},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002646 {"setqflist", 1, 3, FEARG_1, arg13_setqflist,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002647 ret_number_bool, f_setqflist},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002648 {"setreg", 2, 3, FEARG_2, arg3_string_any_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002649 ret_number_bool, f_setreg},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002650 {"settabvar", 3, 3, FEARG_3, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002651 ret_void, f_settabvar},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002652 {"settabwinvar", 4, 4, FEARG_4, arg4_number_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002653 ret_void, f_settabwinvar},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002654 {"settagstack", 2, 3, FEARG_2, arg23_settagstack,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002655 ret_number_bool, f_settagstack},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002656 {"setwinvar", 3, 3, FEARG_3, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002657 ret_void, f_setwinvar},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002658 {"sha256", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002659 ret_string,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002660#ifdef FEAT_CRYPT
Bram Moolenaar15c47602020-03-26 22:16:48 +01002661 f_sha256
2662#else
2663 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002664#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002665 },
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002666 {"shellescape", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002667 ret_string, f_shellescape},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002668 {"shiftwidth", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002669 ret_number, f_shiftwidth},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002670 {"sign_define", 1, 2, FEARG_1, arg2_string_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002671 ret_any, SIGN_FUNC(f_sign_define)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002672 {"sign_getdefined", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002673 ret_list_dict_any, SIGN_FUNC(f_sign_getdefined)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002674 {"sign_getplaced", 0, 2, FEARG_1, arg02_sign_getplaced,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002675 ret_list_dict_any, SIGN_FUNC(f_sign_getplaced)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002676 {"sign_jump", 3, 3, FEARG_1, arg3_number_string_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002677 ret_number, SIGN_FUNC(f_sign_jump)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002678 {"sign_place", 4, 5, FEARG_1, arg45_sign_place,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002679 ret_number, SIGN_FUNC(f_sign_place)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002680 {"sign_placelist", 1, 1, FEARG_1, arg1_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002681 ret_list_number, SIGN_FUNC(f_sign_placelist)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002682 {"sign_undefine", 0, 1, FEARG_1, arg1_string_or_list_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002683 ret_number_bool, SIGN_FUNC(f_sign_undefine)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002684 {"sign_unplace", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002685 ret_number_bool, SIGN_FUNC(f_sign_unplace)},
Sean Dewara63780b2021-11-03 13:15:47 +00002686 {"sign_unplacelist", 1, 1, FEARG_1, arg1_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002687 ret_list_number, SIGN_FUNC(f_sign_unplacelist)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002688 {"simplify", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002689 ret_string, f_simplify},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002690 {"sin", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002691 ret_float, f_sin},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002692 {"sinh", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002693 ret_float, f_sinh},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002694 {"slice", 2, 3, FEARG_1, arg23_slice,
Bram Moolenaar00eb9952022-02-05 19:23:18 +00002695 ret_slice, f_slice},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002696 {"sort", 1, 3, FEARG_1, arg13_sortuniq,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002697 ret_first_arg, f_sort},
2698 {"sound_clear", 0, 0, 0, NULL,
2699 ret_void, SOUND_FUNC(f_sound_clear)},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002700 {"sound_playevent", 1, 2, FEARG_1, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002701 ret_number, SOUND_FUNC(f_sound_playevent)},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002702 {"sound_playfile", 1, 2, FEARG_1, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002703 ret_number, SOUND_FUNC(f_sound_playfile)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002704 {"sound_stop", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002705 ret_void, SOUND_FUNC(f_sound_stop)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002706 {"soundfold", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002707 ret_string, f_soundfold},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002708 {"spellbadword", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002709 ret_list_string, f_spellbadword},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002710 {"spellsuggest", 1, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002711 ret_list_string, f_spellsuggest},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002712 {"split", 1, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002713 ret_list_string, f_split},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002714 {"sqrt", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002715 ret_float, f_sqrt},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002716 {"srand", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002717 ret_list_number, f_srand},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002718 {"state", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002719 ret_string, f_state},
Yegappan Lakshmanana11b23c2025-01-16 19:16:42 +01002720 {"str2blob", 1, 2, FEARG_1, arg2_list_string_dict,
Yegappan Lakshmanan1aefe1d2025-01-14 17:29:42 +01002721 ret_blob, f_str2blob},
Bram Moolenaar80a070c2021-08-08 15:51:10 +02002722 {"str2float", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002723 ret_float, f_str2float},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002724 {"str2list", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002725 ret_list_number, f_str2list},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002726 {"str2nr", 1, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002727 ret_number, f_str2nr},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002728 {"strcharlen", 1, 1, FEARG_1, arg1_string_or_nr,
Bram Moolenaar70ce8a12021-03-14 19:02:09 +01002729 ret_number, f_strcharlen},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002730 {"strcharpart", 2, 4, FEARG_1, arg24_strpart,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002731 ret_string, f_strcharpart},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002732 {"strchars", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002733 ret_number, f_strchars},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002734 {"strdisplaywidth", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002735 ret_number, f_strdisplaywidth},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002736 {"strftime", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002737 ret_string,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002738#ifdef HAVE_STRFTIME
Bram Moolenaar15c47602020-03-26 22:16:48 +01002739 f_strftime
2740#else
2741 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002742#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002743 },
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002744 {"strgetchar", 2, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002745 ret_number, f_strgetchar},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002746 {"stridx", 2, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002747 ret_number, f_stridx},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002748 {"string", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002749 ret_string, f_string},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002750 {"strlen", 1, 1, FEARG_1, arg1_string_or_nr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002751 ret_number, f_strlen},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002752 {"strpart", 2, 4, FEARG_1, arg24_strpart,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002753 ret_string, f_strpart},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002754 {"strptime", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002755 ret_number,
Bram Moolenaar10455d42019-11-21 15:36:18 +01002756#ifdef HAVE_STRPTIME
Bram Moolenaar15c47602020-03-26 22:16:48 +01002757 f_strptime
2758#else
2759 NULL
Bram Moolenaar10455d42019-11-21 15:36:18 +01002760#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002761 },
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002762 {"strridx", 2, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002763 ret_number, f_strridx},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002764 {"strtrans", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002765 ret_string, f_strtrans},
Christian Brabandt67672ef2023-04-24 21:09:54 +01002766 {"strutf16len", 1, 2, FEARG_1, arg2_string_bool,
2767 ret_number, f_strutf16len},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002768 {"strwidth", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002769 ret_number, f_strwidth},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002770 {"submatch", 1, 2, FEARG_1, arg2_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002771 ret_string, f_submatch},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002772 {"substitute", 4, 4, FEARG_1, arg4_string_string_any_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002773 ret_string, f_substitute},
Bram Moolenaarc216a7a2022-12-05 13:50:55 +00002774 {"swapfilelist", 0, 0, 0, NULL,
2775 ret_list_string, f_swapfilelist},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002776 {"swapinfo", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002777 ret_dict_any, f_swapinfo},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002778 {"swapname", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002779 ret_string, f_swapname},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002780 {"synID", 3, 3, 0, arg3_lnum_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002781 ret_number, f_synID},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002782 {"synIDattr", 2, 3, FEARG_1, arg3_number_string_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002783 ret_string, f_synIDattr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002784 {"synIDtrans", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002785 ret_number, f_synIDtrans},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002786 {"synconcealed", 2, 2, 0, arg2_lnum_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002787 ret_list_any, f_synconcealed},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002788 {"synstack", 2, 2, 0, arg2_lnum_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002789 ret_list_number, f_synstack},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002790 {"system", 1, 2, FEARG_1, arg12_system,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002791 ret_string, f_system},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002792 {"systemlist", 1, 2, FEARG_1, arg12_system,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002793 ret_list_string, f_systemlist},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002794 {"tabpagebuflist", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002795 ret_list_number, f_tabpagebuflist},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002796 {"tabpagenr", 0, 1, 0, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002797 ret_number, f_tabpagenr},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002798 {"tabpagewinnr", 1, 2, FEARG_1, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002799 ret_number, f_tabpagewinnr},
2800 {"tagfiles", 0, 0, 0, NULL,
2801 ret_list_string, f_tagfiles},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002802 {"taglist", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002803 ret_list_dict_any, f_taglist},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002804 {"tan", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002805 ret_float, f_tan},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002806 {"tanh", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002807 ret_float, f_tanh},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002808 {"tempname", 0, 0, 0, NULL,
2809 ret_string, f_tempname},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002810 {"term_dumpdiff", 2, 3, FEARG_1, arg3_string_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002811 ret_number, TERM_FUNC(f_term_dumpdiff)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002812 {"term_dumpload", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002813 ret_number, TERM_FUNC(f_term_dumpload)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002814 {"term_dumpwrite", 2, 3, FEARG_2, arg3_buffer_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002815 ret_void, TERM_FUNC(f_term_dumpwrite)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002816 {"term_getaltscreen", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002817 ret_number, TERM_FUNC(f_term_getaltscreen)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002818 {"term_getansicolors", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002819 ret_list_string,
Bram Moolenaarbd5e6222020-03-26 23:13:34 +01002820#if defined(FEAT_TERMINAL) && (defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS))
Bram Moolenaar15c47602020-03-26 22:16:48 +01002821 f_term_getansicolors
2822#else
2823 NULL
Bram Moolenaarc6df10e2017-07-29 20:15:08 +02002824#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002825 },
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002826 {"term_getattr", 2, 2, FEARG_1, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002827 ret_number, TERM_FUNC(f_term_getattr)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002828 {"term_getcursor", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002829 ret_list_any, TERM_FUNC(f_term_getcursor)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002830 {"term_getjob", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002831 ret_job, TERM_FUNC(f_term_getjob)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002832 {"term_getline", 2, 2, FEARG_1, arg2_buffer_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002833 ret_string, TERM_FUNC(f_term_getline)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002834 {"term_getscrolled", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002835 ret_number, TERM_FUNC(f_term_getscrolled)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002836 {"term_getsize", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002837 ret_list_number, TERM_FUNC(f_term_getsize)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002838 {"term_getstatus", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002839 ret_string, TERM_FUNC(f_term_getstatus)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002840 {"term_gettitle", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002841 ret_string, TERM_FUNC(f_term_gettitle)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002842 {"term_gettty", 1, 2, FEARG_1, arg2_buffer_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002843 ret_string, TERM_FUNC(f_term_gettty)},
2844 {"term_list", 0, 0, 0, NULL,
2845 ret_list_number, TERM_FUNC(f_term_list)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002846 {"term_scrape", 2, 2, FEARG_1, arg2_buffer_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002847 ret_list_dict_any, TERM_FUNC(f_term_scrape)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002848 {"term_sendkeys", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002849 ret_void, TERM_FUNC(f_term_sendkeys)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002850 {"term_setansicolors", 2, 2, FEARG_1, arg2_buffer_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002851 ret_void,
Bram Moolenaarbd5e6222020-03-26 23:13:34 +01002852#if defined(FEAT_TERMINAL) && (defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS))
Bram Moolenaar15c47602020-03-26 22:16:48 +01002853 f_term_setansicolors
2854#else
2855 NULL
2856#endif
2857 },
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002858 {"term_setapi", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002859 ret_void, TERM_FUNC(f_term_setapi)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002860 {"term_setkill", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002861 ret_void, TERM_FUNC(f_term_setkill)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002862 {"term_setrestore", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002863 ret_void, TERM_FUNC(f_term_setrestore)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002864 {"term_setsize", 3, 3, FEARG_1, arg3_buffer_number_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002865 ret_void, TERM_FUNC(f_term_setsize)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002866 {"term_start", 1, 2, FEARG_1, arg2_string_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002867 ret_number, TERM_FUNC(f_term_start)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002868 {"term_wait", 1, 2, FEARG_1, arg2_buffer_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002869 ret_void, TERM_FUNC(f_term_wait)},
2870 {"terminalprops", 0, 0, 0, NULL,
2871 ret_dict_string, f_terminalprops},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002872 {"test_alloc_fail", 3, 3, FEARG_1, arg3_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002873 ret_void, f_test_alloc_fail},
2874 {"test_autochdir", 0, 0, 0, NULL,
2875 ret_void, f_test_autochdir},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002876 {"test_feedinput", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002877 ret_void, f_test_feedinput},
2878 {"test_garbagecollect_now", 0, 0, 0, NULL,
2879 ret_void, f_test_garbagecollect_now},
2880 {"test_garbagecollect_soon", 0, 0, 0, NULL,
2881 ret_void, f_test_garbagecollect_soon},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002882 {"test_getvalue", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002883 ret_number, f_test_getvalue},
Yegappan Lakshmanan06011e12022-01-30 12:37:29 +00002884 {"test_gui_event", 2, 2, FEARG_1, arg2_string_dict,
2885 ret_bool, f_test_gui_event},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002886 {"test_ignore_error", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002887 ret_void, f_test_ignore_error},
Christopher Plewright20b795e2022-12-20 20:01:58 +00002888 {"test_mswin_event", 2, 2, FEARG_1, arg2_string_dict,
2889 ret_number, f_test_mswin_event},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002890 {"test_null_blob", 0, 0, 0, NULL,
2891 ret_blob, f_test_null_blob},
2892 {"test_null_channel", 0, 0, 0, NULL,
2893 ret_channel, JOB_FUNC(f_test_null_channel)},
2894 {"test_null_dict", 0, 0, 0, NULL,
2895 ret_dict_any, f_test_null_dict},
2896 {"test_null_function", 0, 0, 0, NULL,
2897 ret_func_any, f_test_null_function},
2898 {"test_null_job", 0, 0, 0, NULL,
2899 ret_job, JOB_FUNC(f_test_null_job)},
2900 {"test_null_list", 0, 0, 0, NULL,
2901 ret_list_any, f_test_null_list},
2902 {"test_null_partial", 0, 0, 0, NULL,
2903 ret_func_any, f_test_null_partial},
2904 {"test_null_string", 0, 0, 0, NULL,
2905 ret_string, f_test_null_string},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002906 {"test_option_not_set", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002907 ret_void, f_test_option_not_set},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002908 {"test_override", 2, 2, FEARG_2, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002909 ret_void, f_test_override},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002910 {"test_refcount", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002911 ret_number, f_test_refcount},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002912 {"test_setmouse", 2, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002913 ret_void, f_test_setmouse},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002914 {"test_settime", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002915 ret_void, f_test_settime},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002916 {"test_srand_seed", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002917 ret_void, f_test_srand_seed},
2918 {"test_unknown", 0, 0, 0, NULL,
2919 ret_any, f_test_unknown},
2920 {"test_void", 0, 0, 0, NULL,
2921 ret_void, f_test_void},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002922 {"timer_info", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002923 ret_list_dict_any, TIMER_FUNC(f_timer_info)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002924 {"timer_pause", 2, 2, FEARG_1, arg2_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002925 ret_void, TIMER_FUNC(f_timer_pause)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002926 {"timer_start", 2, 3, FEARG_1, arg3_number_any_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002927 ret_number, TIMER_FUNC(f_timer_start)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002928 {"timer_stop", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002929 ret_void, TIMER_FUNC(f_timer_stop)},
2930 {"timer_stopall", 0, 0, 0, NULL,
2931 ret_void, TIMER_FUNC(f_timer_stopall)},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002932 {"tolower", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002933 ret_string, f_tolower},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002934 {"toupper", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002935 ret_string, f_toupper},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002936 {"tr", 3, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002937 ret_string, f_tr},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002938 {"trim", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002939 ret_string, f_trim},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002940 {"trunc", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002941 ret_float, f_trunc},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002942 {"type", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002943 ret_number, f_type},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002944 {"typename", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaara47e05f2021-01-12 21:49:00 +01002945 ret_string, f_typename},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002946 {"undofile", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002947 ret_string, f_undofile},
Devin J. Pohly5fee1112023-04-23 20:26:59 -05002948 {"undotree", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002949 ret_dict_any, f_undotree},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002950 {"uniq", 1, 3, FEARG_1, arg13_sortuniq,
Bram Moolenaar08018222021-12-22 18:45:37 +00002951 ret_first_arg, f_uniq},
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01002952 {"utf16idx", 2, 4, FEARG_1, arg4_string_number_bool_bool,
Christian Brabandt67672ef2023-04-24 21:09:54 +01002953 ret_number, f_utf16idx},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002954 {"values", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar32517c42023-01-15 18:17:12 +00002955 ret_list_member, f_values},
zeertzjq825cf812023-08-17 22:55:25 +02002956 {"virtcol", 1, 3, FEARG_1, arg3_string_or_list_bool_number,
LemonBoy0f7a3e12022-05-26 12:10:37 +01002957 ret_virtcol, f_virtcol},
Bram Moolenaar5a6ec102022-05-27 21:58:00 +01002958 {"virtcol2col", 3, 3, FEARG_1, arg3_number,
2959 ret_number, f_virtcol2col},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002960 {"visualmode", 0, 1, 0, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002961 ret_string, f_visualmode},
2962 {"wildmenumode", 0, 0, 0, NULL,
2963 ret_number, f_wildmenumode},
Bram Moolenaar52312242021-07-11 18:23:19 +02002964 {"win_execute", 2, 3, FEARG_2, arg23_win_execute,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002965 ret_string, f_win_execute},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002966 {"win_findbuf", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002967 ret_list_number, f_win_findbuf},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002968 {"win_getid", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002969 ret_number, f_win_getid},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002970 {"win_gettype", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002971 ret_string, f_win_gettype},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002972 {"win_gotoid", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002973 ret_number_bool, f_win_gotoid},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002974 {"win_id2tabwin", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002975 ret_list_number, f_win_id2tabwin},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002976 {"win_id2win", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002977 ret_number, f_win_id2win},
Daniel Steinbergee630312022-01-10 13:36:34 +00002978 {"win_move_separator", 2, 2, FEARG_1, arg2_number,
2979 ret_number_bool, f_win_move_separator},
2980 {"win_move_statusline", 2, 2, FEARG_1, arg2_number,
2981 ret_number_bool, f_win_move_statusline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002982 {"win_screenpos", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002983 ret_list_number, f_win_screenpos},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002984 {"win_splitmove", 2, 3, FEARG_1, arg3_number_number_dict,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002985 ret_number_bool, f_win_splitmove},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002986 {"winbufnr", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002987 ret_number, f_winbufnr},
2988 {"wincol", 0, 0, 0, NULL,
2989 ret_number, f_wincol},
2990 {"windowsversion", 0, 0, 0, NULL,
2991 ret_string, f_windowsversion},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002992 {"winheight", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002993 ret_number, f_winheight},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002994 {"winlayout", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002995 ret_list_any, f_winlayout},
2996 {"winline", 0, 0, 0, NULL,
2997 ret_number, f_winline},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002998 {"winnr", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002999 ret_number, f_winnr},
3000 {"winrestcmd", 0, 0, 0, NULL,
3001 ret_string, f_winrestcmd},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02003002 {"winrestview", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003003 ret_void, f_winrestview},
3004 {"winsaveview", 0, 0, 0, NULL,
Bram Moolenaar43b69b32021-01-07 20:23:33 +01003005 ret_dict_number, f_winsaveview},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003006 {"winwidth", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003007 ret_number, f_winwidth},
3008 {"wordcount", 0, 0, 0, NULL,
3009 ret_dict_number, f_wordcount},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02003010 {"writefile", 2, 3, FEARG_1, arg23_writefile,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01003011 ret_number_bool, f_writefile},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003012 {"xor", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003013 ret_number, f_xor},
Bram Moolenaarac92e252019-08-03 21:58:38 +02003014};
3015
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003016/*
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003017 * Return true if specified function allows a type as an argument.
3018 */
3019 static int
3020func_allows_type(int idx)
3021{
3022 return (global_functions[idx].f_argtype & FE_X) != 0;
3023}
3024
3025/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003026 * Function given to ExpandGeneric() to obtain the list of internal
3027 * or user defined function names.
3028 */
3029 char_u *
3030get_function_name(expand_T *xp, int idx)
3031{
3032 static int intidx = -1;
3033 char_u *name;
3034
3035 if (idx == 0)
3036 intidx = -1;
3037 if (intidx < 0)
3038 {
3039 name = get_user_func_name(xp, idx);
naohiro ono5aec7552021-08-19 21:20:41 +02003040 if (name != NULL)
Bram Moolenaar1bb4de52021-01-13 19:48:46 +01003041 {
naohiro ono5aec7552021-08-19 21:20:41 +02003042 if (*name != NUL && *name != '<'
3043 && STRNCMP("g:", xp->xp_pattern, 2) == 0)
Bram Moolenaar1bb4de52021-01-13 19:48:46 +01003044 return cat_prefix_varname('g', name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003045 return name;
Bram Moolenaar1bb4de52021-01-13 19:48:46 +01003046 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003047 }
K.Takataeeec2542021-06-02 13:28:16 +02003048 if (++intidx < (int)ARRAY_LENGTH(global_functions))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003049 {
Kota Kato90c23532023-01-18 15:27:38 +00003050 // Skip if the function doesn't have an implementation (feature not
3051 // implemented).
3052 if (global_functions[intidx].f_func == NULL)
3053 return (char_u *)"";
Bram Moolenaarac92e252019-08-03 21:58:38 +02003054 STRCPY(IObuff, global_functions[intidx].f_name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003055 STRCAT(IObuff, "(");
Bram Moolenaarac92e252019-08-03 21:58:38 +02003056 if (global_functions[intidx].f_max_argc == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003057 STRCAT(IObuff, ")");
3058 return IObuff;
3059 }
3060
3061 return NULL;
3062}
3063
3064/*
3065 * Function given to ExpandGeneric() to obtain the list of internal or
3066 * user defined variable or function names.
3067 */
3068 char_u *
3069get_expr_name(expand_T *xp, int idx)
3070{
3071 static int intidx = -1;
3072 char_u *name;
3073
3074 if (idx == 0)
3075 intidx = -1;
3076 if (intidx < 0)
3077 {
3078 name = get_function_name(xp, idx);
3079 if (name != NULL)
3080 return name;
3081 }
3082 return get_user_var_name(xp, ++intidx);
3083}
3084
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003085/*
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003086 * Find internal function "name" in table "global_functions".
Bram Moolenaar15c47602020-03-26 22:16:48 +01003087 * Return index, or -1 if not found or "implemented" is TRUE and the function
3088 * is not implemented.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003089 */
Bram Moolenaar15c47602020-03-26 22:16:48 +01003090 static int
3091find_internal_func_opt(char_u *name, int implemented)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003092{
3093 int first = 0;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003094 int last;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003095 int cmp;
3096 int x;
3097
K.Takataeeec2542021-06-02 13:28:16 +02003098 last = (int)ARRAY_LENGTH(global_functions) - 1;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003099
3100 // Find the function name in the table. Binary search.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003101 while (first <= last)
3102 {
3103 x = first + ((unsigned)(last - first) >> 1);
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003104 cmp = STRCMP(name, global_functions[x].f_name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003105 if (cmp < 0)
3106 last = x - 1;
3107 else if (cmp > 0)
3108 first = x + 1;
Bram Moolenaar15c47602020-03-26 22:16:48 +01003109 else if (implemented && global_functions[x].f_func == NULL)
3110 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003111 else
3112 return x;
3113 }
3114 return -1;
3115}
3116
Bram Moolenaar15c47602020-03-26 22:16:48 +01003117/*
3118 * Find internal function "name" in table "global_functions".
3119 * Return index, or -1 if not found or the function is not implemented.
3120 */
3121 int
3122find_internal_func(char_u *name)
3123{
3124 return find_internal_func_opt(name, TRUE);
3125}
3126
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003127 int
Bram Moolenaarac92e252019-08-03 21:58:38 +02003128has_internal_func(char_u *name)
3129{
Bram Moolenaar15c47602020-03-26 22:16:48 +01003130 return find_internal_func_opt(name, TRUE) >= 0;
3131}
3132
3133 static int
3134has_internal_func_name(char_u *name)
3135{
3136 return find_internal_func_opt(name, FALSE) >= 0;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003137}
3138
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003139 char *
3140internal_func_name(int idx)
3141{
3142 return global_functions[idx].f_name;
3143}
3144
Bram Moolenaar94738d82020-10-21 14:25:07 +02003145/*
Dominique Pellefe8ebdb2021-05-13 14:55:55 +02003146 * Check the argument types for builtin function "idx".
Bram Moolenaar94738d82020-10-21 14:25:07 +02003147 * Uses the list of types on the type stack: "types".
3148 * Return FAIL and gives an error message when a type is wrong.
3149 */
3150 int
Bram Moolenaar351ead02021-01-16 16:07:01 +01003151internal_func_check_arg_types(
Bram Moolenaar078a4612022-01-04 15:17:03 +00003152 type2_T *types,
Bram Moolenaar351ead02021-01-16 16:07:01 +01003153 int idx,
3154 int argcount,
3155 cctx_T *cctx)
Bram Moolenaar94738d82020-10-21 14:25:07 +02003156{
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003157 // Some internal functions accept types like Class as arguments. For other
3158 // functions, check the arguments are not types.
3159 if (!(func_allows_type(idx)))
3160 {
zeertzjqd9be94c2024-07-14 10:20:20 +02003161 for (int i = 0; i < argcount; ++i)
3162 if (check_type_is_value(types[i].type_curr) == FAIL)
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003163 return FAIL;
3164 }
3165
Bram Moolenaar94738d82020-10-21 14:25:07 +02003166 argcheck_T *argchecks = global_functions[idx].f_argcheck;
Bram Moolenaar94738d82020-10-21 14:25:07 +02003167
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003168 if (argchecks == NULL)
3169 return OK;
Bram Moolenaar94738d82020-10-21 14:25:07 +02003170
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003171 argcontext_T context;
3172
3173 context.arg_count = argcount;
3174 context.arg_types = types;
3175 context.arg_cctx = cctx;
Ernie Raela8f7f922023-12-14 20:17:04 +01003176 for (int i = 0; i < argcount && argchecks[i] != NULL; ++i)
3177 {
3178 context.arg_idx = i;
3179 if (argchecks[i](types[i].type_curr, types[i].type_decl,
3180 &context) == FAIL)
3181 return FAIL;
3182 }
Bram Moolenaar94738d82020-10-21 14:25:07 +02003183 return OK;
3184}
3185
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003186/*
Bram Moolenaar7a40ff02021-07-04 15:54:08 +02003187 * Get the argument count for function "idx".
3188 * "argcount" is the total argument count, "min_argcount" the non-optional
3189 * argument count.
3190 */
3191 void
3192internal_func_get_argcount(int idx, int *argcount, int *min_argcount)
3193{
3194 *argcount = global_functions[idx].f_max_argc;
3195 *min_argcount = global_functions[idx].f_min_argc;
3196}
3197
3198/*
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003199 * Call the "f_retfunc" function to obtain the return type of function "idx".
Bram Moolenaar81330182022-02-01 12:11:58 +00003200 * "decl_type" is set to the declared type.
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003201 * "argtypes" is the list of argument types or NULL when there are no
3202 * arguments.
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02003203 * "argcount" may be less than the actual count when only getting the type.
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003204 */
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003205 type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00003206internal_func_ret_type(
3207 int idx,
3208 int argcount,
3209 type2_T *argtypes,
Bram Moolenaar32517c42023-01-15 18:17:12 +00003210 type_T **decl_type,
3211 garray_T *type_gap)
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003212{
Bram Moolenaar81330182022-02-01 12:11:58 +00003213 type_T *ret;
3214
Bram Moolenaar32517c42023-01-15 18:17:12 +00003215 current_type_gap = type_gap;
Bram Moolenaar81330182022-02-01 12:11:58 +00003216 *decl_type = NULL;
3217 ret = global_functions[idx].f_retfunc(argcount, argtypes, decl_type);
3218 if (*decl_type == NULL)
3219 *decl_type = ret;
Bram Moolenaar32517c42023-01-15 18:17:12 +00003220 current_type_gap = NULL;
Bram Moolenaar81330182022-02-01 12:11:58 +00003221 return ret;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003222}
3223
3224/*
Bram Moolenaar75ab91f2021-01-10 22:42:50 +01003225 * Return TRUE if "idx" is for the map() function.
3226 */
3227 int
3228internal_func_is_map(int idx)
3229{
3230 return global_functions[idx].f_func == f_map;
3231}
3232
3233/*
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003234 * Check the argument count to use for internal function "idx".
Bram Moolenaar389df252020-07-09 21:20:47 +02003235 * Returns -1 for failure, 0 if no method base accepted, 1 if method base is
3236 * first argument, 2 if method base is second argument, etc. 9 if method base
3237 * is last argument.
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003238 */
3239 int
3240check_internal_func(int idx, int argcount)
3241{
Bram Moolenaar0917e862023-02-18 14:42:44 +00003242 funcerror_T res;
3243 char *name;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003244
3245 if (argcount < global_functions[idx].f_min_argc)
3246 res = FCERR_TOOFEW;
3247 else if (argcount > global_functions[idx].f_max_argc)
3248 res = FCERR_TOOMANY;
3249 else
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003250 return global_functions[idx].f_argtype & FEARG_MASK;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003251
3252 name = internal_func_name(idx);
3253 if (res == FCERR_TOOMANY)
Bram Moolenaare1242042021-12-16 20:56:57 +00003254 semsg(_(e_too_many_arguments_for_function_str), name);
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003255 else
Bram Moolenaare1242042021-12-16 20:56:57 +00003256 semsg(_(e_not_enough_arguments_for_function_str), name);
Bram Moolenaar389df252020-07-09 21:20:47 +02003257 return -1;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003258}
3259
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003260/*
3261 * Some internal functions accept types like Class as arguments. For other
3262 * functions, check the arguments are not types.
3263 *
3264 * Return OK/FAIL.
3265 */
3266 static int
3267check_args_for_type(int idx, int argcount, typval_T *argvars)
3268{
3269 if (!func_allows_type(idx))
3270 {
3271 for (int i = 0; i < argcount; ++i)
3272 if (check_typval_is_value(&argvars[i]) == FAIL)
3273 return FAIL;
3274 }
3275 return OK;
3276}
3277
Bram Moolenaar0917e862023-02-18 14:42:44 +00003278 funcerror_T
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003279call_internal_func(
3280 char_u *name,
3281 int argcount,
3282 typval_T *argvars,
3283 typval_T *rettv)
3284{
3285 int i;
3286
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003287 i = find_internal_func(name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003288 if (i < 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01003289 return FCERR_UNKNOWN;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003290 if (argcount < global_functions[i].f_min_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003291 return FCERR_TOOFEW;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003292 if (argcount > global_functions[i].f_max_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003293 return FCERR_TOOMANY;
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003294 if (check_args_for_type(i, argcount, argvars) == FAIL)
3295 return FCERR_OTHER;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003296 argvars[argcount].v_type = VAR_UNKNOWN;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003297 global_functions[i].f_func(argvars, rettv);
Bram Moolenaaref140542019-12-31 21:27:13 +01003298 return FCERR_NONE;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003299}
3300
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003301 void
3302call_internal_func_by_idx(
3303 int idx,
3304 typval_T *argvars,
3305 typval_T *rettv)
3306{
3307 global_functions[idx].f_func(argvars, rettv);
3308}
3309
Bram Moolenaarac92e252019-08-03 21:58:38 +02003310/*
3311 * Invoke a method for base->method().
3312 */
Bram Moolenaar0917e862023-02-18 14:42:44 +00003313 funcerror_T
Bram Moolenaarac92e252019-08-03 21:58:38 +02003314call_internal_method(
3315 char_u *name,
3316 int argcount,
3317 typval_T *argvars,
3318 typval_T *rettv,
3319 typval_T *basetv)
3320{
Bram Moolenaarac92e252019-08-03 21:58:38 +02003321 int fi;
3322 typval_T argv[MAX_FUNC_ARGS + 1];
3323
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003324 fi = find_internal_func(name);
Bram Moolenaar91746392019-08-16 22:22:31 +02003325 if (fi < 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01003326 return FCERR_UNKNOWN;
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003327 if ((global_functions[fi].f_argtype & FEARG_MASK) == 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01003328 return FCERR_NOTMETHOD;
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003329 if (argcount + 1 < global_functions[fi].f_min_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003330 return FCERR_TOOFEW;
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003331 if (argcount + 1 > global_functions[fi].f_max_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003332 return FCERR_TOOMANY;
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003333 if (check_args_for_type(fi, argcount, argvars) == FAIL)
3334 return FCERR_OTHER;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003335
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003336 if ((global_functions[fi].f_argtype & FEARG_MASK) == FEARG_2)
Bram Moolenaar25e42232019-08-04 15:04:10 +02003337 {
Bram Moolenaarb7f22702023-04-27 16:24:07 +01003338 if (argcount < 1)
3339 return FCERR_TOOFEW;
3340
Bram Moolenaar25e42232019-08-04 15:04:10 +02003341 // base value goes second
3342 argv[0] = argvars[0];
3343 argv[1] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003344 for (int i = 1; i < argcount; ++i)
Bram Moolenaar25e42232019-08-04 15:04:10 +02003345 argv[i + 1] = argvars[i];
3346 }
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003347 else if ((global_functions[fi].f_argtype & FEARG_MASK) == FEARG_3)
Bram Moolenaar24278d22019-08-16 21:49:22 +02003348 {
Bram Moolenaarb7f22702023-04-27 16:24:07 +01003349 if (argcount < 2)
3350 return FCERR_TOOFEW;
3351
Bram Moolenaar24278d22019-08-16 21:49:22 +02003352 // base value goes third
3353 argv[0] = argvars[0];
3354 argv[1] = argvars[1];
3355 argv[2] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003356 for (int i = 2; i < argcount; ++i)
Bram Moolenaar24278d22019-08-16 21:49:22 +02003357 argv[i + 1] = argvars[i];
3358 }
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003359 else if ((global_functions[fi].f_argtype & FEARG_MASK) == FEARG_4)
Bram Moolenaaraad222c2019-09-06 22:46:09 +02003360 {
Bram Moolenaarb7f22702023-04-27 16:24:07 +01003361 if (argcount < 3)
3362 return FCERR_TOOFEW;
3363
Bram Moolenaaraad222c2019-09-06 22:46:09 +02003364 // base value goes fourth
3365 argv[0] = argvars[0];
3366 argv[1] = argvars[1];
3367 argv[2] = argvars[2];
3368 argv[3] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003369 for (int i = 3; i < argcount; ++i)
Bram Moolenaaraad222c2019-09-06 22:46:09 +02003370 argv[i + 1] = argvars[i];
3371 }
Bram Moolenaar25e42232019-08-04 15:04:10 +02003372 else
3373 {
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003374 // FEARG_1: base value goes first
Bram Moolenaar25e42232019-08-04 15:04:10 +02003375 argv[0] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003376 for (int i = 0; i < argcount; ++i)
Bram Moolenaar25e42232019-08-04 15:04:10 +02003377 argv[i + 1] = argvars[i];
3378 }
Bram Moolenaarac92e252019-08-03 21:58:38 +02003379 argv[argcount + 1].v_type = VAR_UNKNOWN;
3380
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003381 if (check_args_for_type(fi, argcount + 1, argv) == FAIL)
3382 return FCERR_OTHER;
3383
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003384 global_functions[fi].f_func(argv, rettv);
Bram Moolenaaref140542019-12-31 21:27:13 +01003385 return FCERR_NONE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003386}
3387
3388/*
3389 * Return TRUE for a non-zero Number and a non-empty String.
3390 */
Bram Moolenaar0e57dd82019-09-16 22:56:03 +02003391 int
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003392non_zero_arg(typval_T *argvars)
3393{
3394 return ((argvars[0].v_type == VAR_NUMBER
3395 && argvars[0].vval.v_number != 0)
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01003396 || (argvars[0].v_type == VAR_BOOL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003397 && argvars[0].vval.v_number == VVAL_TRUE)
3398 || (argvars[0].v_type == VAR_STRING
3399 && argvars[0].vval.v_string != NULL
3400 && *argvars[0].vval.v_string != NUL));
3401}
3402
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003403/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003404 * "and(expr, expr)" function
3405 */
3406 static void
3407f_and(typval_T *argvars, typval_T *rettv)
3408{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003409 if (in_vim9script()
3410 && (check_for_number_arg(argvars, 0) == FAIL
3411 || check_for_number_arg(argvars, 1) == FAIL))
3412 return;
3413
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003414 rettv->vval.v_number = tv_get_number_chk(&argvars[0], NULL)
3415 & tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaarca851592018-06-06 21:04:07 +02003416}
3417
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003418/*
Bram Moolenaar59716a22017-03-01 20:32:44 +01003419 * "balloon_show()" function
3420 */
3421#ifdef FEAT_BEVAL
3422 static void
Bram Moolenaarbe0a2592019-05-09 13:50:16 +02003423f_balloon_gettext(typval_T *argvars UNUSED, typval_T *rettv)
3424{
3425 rettv->v_type = VAR_STRING;
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003426 if (balloonEval == NULL)
3427 return;
3428
3429 if (balloonEval->msg == NULL)
3430 rettv->vval.v_string = NULL;
3431 else
3432 rettv->vval.v_string = vim_strsave(balloonEval->msg);
Bram Moolenaarbe0a2592019-05-09 13:50:16 +02003433}
3434
3435 static void
Bram Moolenaar59716a22017-03-01 20:32:44 +01003436f_balloon_show(typval_T *argvars, typval_T *rettv UNUSED)
3437{
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003438 if (balloonEval == NULL)
3439 return;
3440
3441 if (in_vim9script()
3442 && check_for_string_or_list_arg(argvars, 0) == FAIL)
3443 return;
3444
3445 if (argvars[0].v_type == VAR_LIST
3446# ifdef FEAT_GUI
3447 && !gui.in_use
3448# endif
3449 )
Bram Moolenaar246fe032017-11-19 19:56:27 +01003450 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003451 list_T *l = argvars[0].vval.v_list;
3452
3453 // empty list removes the balloon
3454 post_balloon(balloonEval, NULL,
3455 l == NULL || l->lv_len == 0 ? NULL : l);
3456 }
3457 else
3458 {
3459 char_u *mesg;
3460
3461 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003462 return;
3463
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003464 mesg = tv_get_string_chk(&argvars[0]);
3465 if (mesg != NULL)
3466 // empty string removes the balloon
3467 post_balloon(balloonEval, *mesg == NUL ? NULL : mesg, NULL);
Bram Moolenaar246fe032017-11-19 19:56:27 +01003468 }
3469}
3470
Bram Moolenaar669a8282017-11-19 20:13:05 +01003471# if defined(FEAT_BEVAL_TERM)
Bram Moolenaar246fe032017-11-19 19:56:27 +01003472 static void
3473f_balloon_split(typval_T *argvars, typval_T *rettv UNUSED)
3474{
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003475 if (rettv_list_alloc(rettv) != OK)
3476 return;
3477
3478 char_u *msg;
3479
3480 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
3481 return;
3482 msg = tv_get_string_chk(&argvars[0]);
3483 if (msg != NULL)
Bram Moolenaar246fe032017-11-19 19:56:27 +01003484 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003485 pumitem_T *array;
3486 int size = split_message(msg, &array);
Bram Moolenaar246fe032017-11-19 19:56:27 +01003487
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003488 // Skip the first and last item, they are always empty.
3489 for (int i = 1; i < size - 1; ++i)
3490 list_append_string(rettv->vval.v_list, array[i].pum_text, -1);
3491 while (size > 0)
3492 vim_free(array[--size].pum_text);
3493 vim_free(array);
Bram Moolenaar246fe032017-11-19 19:56:27 +01003494 }
Bram Moolenaar59716a22017-03-01 20:32:44 +01003495}
Bram Moolenaar669a8282017-11-19 20:13:05 +01003496# endif
Bram Moolenaar59716a22017-03-01 20:32:44 +01003497#endif
3498
Yegappan Lakshmanan810785c2024-12-30 10:29:44 +01003499// Base64 character set
3500static const char_u base64_table[] = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
3501
3502// Base64 decoding table (initialized in init_base64_dec_table() below)
3503static char_u base64_dec_table[256];
3504
3505/*
3506 * Initialize the base64 decoding table
3507 */
3508 static void
3509init_base64_dec_table(void)
3510{
3511 static int base64_dec_tbl_initialized = FALSE;
3512
3513 if (base64_dec_tbl_initialized)
3514 return;
3515
3516 // Unsupported characters are set to 0xFF
3517 vim_memset(base64_dec_table, 0xFF, sizeof(base64_dec_table));
3518
3519 // Initialize the index for the base64 alphabets
3520 for (size_t i = 0; i < sizeof(base64_table) - 1; i++)
3521 base64_dec_table[(char_u)base64_table[i]] = (char_u)i;
3522
3523 // base64 padding character
3524 base64_dec_table['='] = 0;
3525
3526 base64_dec_tbl_initialized = TRUE;
3527}
3528
3529/*
3530 * Encode the bytes in "blob" using base-64 encoding.
3531 */
3532 static char_u *
3533base64_encode(blob_T *blob)
3534{
3535 size_t input_len = blob->bv_ga.ga_len;
3536 size_t encoded_len = ((input_len + 2) / 3) * 4;
3537 char_u *data = blob->bv_ga.ga_data;
3538
3539 char_u *encoded = alloc(encoded_len + 1);
3540 if (encoded == NULL)
3541 return NULL;
3542
3543 size_t i, j;
3544 for (i = 0, j = 0; i < input_len;)
3545 {
3546 int_u octet_a = i < input_len ? data[i++] : 0;
3547 int_u octet_b = i < input_len ? data[i++] : 0;
3548 int_u octet_c = i < input_len ? data[i++] : 0;
3549
3550 int_u triple = (octet_a << 16) | (octet_b << 8) | octet_c;
3551
3552 encoded[j++] = base64_table[(triple >> 18) & 0x3F];
3553 encoded[j++] = base64_table[(triple >> 12) & 0x3F];
3554 encoded[j++] = (!octet_b && i >= input_len) ? '='
3555 : base64_table[(triple >> 6) & 0x3F];
3556 encoded[j++] = (!octet_c && i >= input_len) ? '='
3557 : base64_table[triple & 0x3F];
3558 }
3559 encoded[j] = NUL;
3560
3561 return encoded;
3562}
3563
3564/*
3565 * Decode the string "data" using base-64 encoding.
3566 */
3567 static void
3568base64_decode(const char_u *data, blob_T *blob)
3569{
3570 size_t input_len = STRLEN(data);
3571
3572 if (input_len == 0)
3573 return;
3574
3575 if (input_len % 4 != 0)
3576 {
3577 // Invalid input length
3578 semsg(_(e_invalid_argument_str), data);
3579 return;
3580 }
3581
3582 init_base64_dec_table();
3583
3584 size_t decoded_len = (input_len / 4) * 3;
3585 if (data[input_len - 1] == '=')
3586 decoded_len--;
3587 if (data[input_len - 2] == '=')
3588 decoded_len--;
3589
3590 size_t i, j;
3591 for (i = 0, j = 0; i < input_len;)
3592 {
3593 int_u sextet_a = base64_dec_table[(char_u)data[i++]];
3594 int_u sextet_b = base64_dec_table[(char_u)data[i++]];
3595 int_u sextet_c = base64_dec_table[(char_u)data[i++]];
3596 int_u sextet_d = base64_dec_table[(char_u)data[i++]];
3597
3598 if (sextet_a == 0xFF || sextet_b == 0xFF || sextet_c == 0xFF
3599 || sextet_d == 0xFF)
3600 {
3601 // Invalid character
3602 semsg(_(e_invalid_argument_str), data);
3603 ga_clear(&blob->bv_ga);
3604 return;
3605 }
3606
3607 int_u triple = (sextet_a << 18) | (sextet_b << 12)
3608 | (sextet_c << 6) | sextet_d;
3609
3610 if (j < decoded_len)
3611 {
3612 ga_append(&blob->bv_ga, (triple >> 16) & 0xFF);
3613 j++;
3614 }
3615 if (j < decoded_len)
3616 {
3617 ga_append(&blob->bv_ga, (triple >> 8) & 0xFF);
3618 j++;
3619 }
3620 if (j < decoded_len)
3621 {
3622 ga_append(&blob->bv_ga, triple & 0xFF);
3623 j++;
3624 }
3625
3626 if (j == decoded_len)
3627 {
3628 // Check for invalid padding bytes (based on the
3629 // "Base64 Malleability in Practice" ACM paper).
3630 if ((data[input_len - 2] == '=' && ((sextet_b & 0xF) != 0))
3631 || ((data[input_len - 1] == '=') && ((sextet_c & 0x3) != 0)))
3632 {
3633 semsg(_(e_invalid_argument_str), data);
3634 ga_clear(&blob->bv_ga);
3635 return;
3636 }
3637 }
3638 }
3639}
3640
3641/*
3642 * "base64_decode(string)" function
3643 */
3644 static void
3645f_base64_decode(typval_T *argvars, typval_T *rettv)
3646{
3647 if (check_for_string_arg(argvars, 0) == FAIL)
3648 return;
3649
3650 if (rettv_blob_alloc(rettv) == FAIL)
3651 return;
3652
3653 char_u *str = tv_get_string_chk(&argvars[0]);
3654 if (str != NULL)
3655 base64_decode(str, rettv->vval.v_blob);
3656}
3657
3658/*
3659 * "base64_encode(blob)" function
3660 */
3661 static void
3662f_base64_encode(typval_T *argvars, typval_T *rettv)
3663{
3664 if (check_for_blob_arg(argvars, 0) == FAIL)
3665 return;
3666
3667 rettv->v_type = VAR_STRING;
3668 rettv->vval.v_string = NULL;
3669
3670 blob_T *blob = argvars->vval.v_blob;
3671 if (blob != NULL)
3672 rettv->vval.v_string = base64_encode(blob);
3673}
3674
Bram Moolenaar59716a22017-03-01 20:32:44 +01003675/*
Bram Moolenaar6b7b7192019-01-11 13:42:41 +01003676 * Get the buffer from "arg" and give an error and return NULL if it is not
3677 * valid.
3678 */
Bram Moolenaara3347722019-05-11 21:14:24 +02003679 buf_T *
Bram Moolenaar6b7b7192019-01-11 13:42:41 +01003680get_buf_arg(typval_T *arg)
3681{
3682 buf_T *buf;
3683
3684 ++emsg_off;
3685 buf = tv_get_buf(arg, FALSE);
3686 --emsg_off;
3687 if (buf == NULL)
Bram Moolenaard82a47d2022-01-05 20:24:39 +00003688 semsg(_(e_invalid_buffer_name_str), tv_get_string(arg));
Bram Moolenaar6b7b7192019-01-11 13:42:41 +01003689 return buf;
3690}
3691
3692/*
Christ van Willegence0ef912024-06-20 23:41:59 +02003693 * "bindtextdomain(package, path)" function
3694 */
3695 static void
Christ van Willegen8252ef12024-07-11 21:36:21 +02003696f_bindtextdomain(typval_T *argvars, typval_T *rettv)
Christ van Willegence0ef912024-06-20 23:41:59 +02003697{
Christ van Willegen8252ef12024-07-11 21:36:21 +02003698 rettv->v_type = VAR_BOOL;
3699 rettv->vval.v_number = VVAL_TRUE;
3700
Christ van Willegence0ef912024-06-20 23:41:59 +02003701 if (check_for_nonempty_string_arg(argvars, 0) == FAIL
3702 || check_for_nonempty_string_arg(argvars, 1) == FAIL)
3703 return;
3704
3705 if (strcmp((const char *)argvars[0].vval.v_string, VIMPACKAGE) == 0)
3706 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[0]));
3707 else
Christ van Willegen8252ef12024-07-11 21:36:21 +02003708 {
3709 if (bindtextdomain((const char *)argvars[0].vval.v_string, (const char *)argvars[1].vval.v_string) == NULL)
3710 {
3711 do_outofmem_msg((long)0);
3712 rettv->vval.v_number = VVAL_FALSE;
3713 }
3714 }
Christ van Willegence0ef912024-06-20 23:41:59 +02003715
3716 return;
3717}
3718
3719/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003720 * "byte2line(byte)" function
3721 */
3722 static void
3723f_byte2line(typval_T *argvars UNUSED, typval_T *rettv)
3724{
3725#ifndef FEAT_BYTEOFF
3726 rettv->vval.v_number = -1;
3727#else
3728 long boff = 0;
3729
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003730 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
3731 return;
3732
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01003733 boff = tv_get_number(&argvars[0]) - 1; // boff gets -1 on type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003734 if (boff < 0)
3735 rettv->vval.v_number = -1;
3736 else
3737 rettv->vval.v_number = ml_find_line_or_offset(curbuf,
3738 (linenr_T)0, &boff);
3739#endif
3740}
3741
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003742/*
3743 * "call(func, arglist [, dict])" function
3744 */
3745 static void
3746f_call(typval_T *argvars, typval_T *rettv)
3747{
3748 char_u *func;
3749 partial_T *partial = NULL;
3750 dict_T *selfdict = NULL;
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003751 char_u *tofree = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003752
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02003753 if (in_vim9script()
Bram Moolenaar223d0a62021-12-25 19:29:21 +00003754 && (check_for_string_or_func_arg(argvars, 0) == FAIL
3755 || check_for_list_arg(argvars, 1) == FAIL
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02003756 || check_for_opt_dict_arg(argvars, 2) == FAIL))
3757 return;
3758
Bram Moolenaard83392a2022-09-01 12:22:46 +01003759 if (check_for_list_arg(argvars, 1) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003760 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003761 if (argvars[1].vval.v_list == NULL)
3762 return;
3763
3764 if (argvars[0].v_type == VAR_FUNC)
3765 func = argvars[0].vval.v_string;
3766 else if (argvars[0].v_type == VAR_PARTIAL)
3767 {
3768 partial = argvars[0].vval.v_partial;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02003769 func = partial_name(partial);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003770 }
3771 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003772 func = tv_get_string(&argvars[0]);
Dominique Pellefe8ebdb2021-05-13 14:55:55 +02003773 if (func == NULL || *func == NUL)
3774 return; // type error, empty name or null function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003775
Yegappan Lakshmanan9904cbc2025-01-15 18:25:19 +01003776 if (argvars[0].v_type == VAR_STRING)
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003777 {
Yegappan Lakshmanan9904cbc2025-01-15 18:25:19 +01003778 char_u *p = func;
3779 tofree = trans_function_name(&p, NULL, FALSE, TFN_INT|TFN_QUIET);
3780 if (tofree == NULL)
3781 {
3782 emsg_funcname(e_unknown_function_str, func);
3783 return;
3784 }
3785 func = tofree;
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003786 }
3787
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003788 if (argvars[2].v_type != VAR_UNKNOWN)
3789 {
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +01003790 if (check_for_dict_arg(argvars, 2) == FAIL)
Yegappan Lakshmanan6289f912025-01-14 17:13:36 +01003791 goto done;
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +01003792
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003793 selfdict = argvars[2].vval.v_dict;
3794 }
3795
3796 (void)func_call(func, &argvars[1], partial, selfdict, rettv);
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003797
Yegappan Lakshmanan6289f912025-01-14 17:13:36 +01003798done:
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003799 vim_free(tofree);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003800}
3801
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003802/*
3803 * "changenr()" function
3804 */
3805 static void
3806f_changenr(typval_T *argvars UNUSED, typval_T *rettv)
3807{
3808 rettv->vval.v_number = curbuf->b_u_seq_cur;
3809}
3810
3811/*
3812 * "char2nr(string)" function
3813 */
3814 static void
3815f_char2nr(typval_T *argvars, typval_T *rettv)
3816{
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02003817 if (in_vim9script()
3818 && (check_for_string_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02003819 || check_for_opt_bool_arg(argvars, 1) == FAIL))
Bram Moolenaarc5809432021-03-27 21:23:30 +01003820 return;
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02003821
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003822 if (has_mbyte)
3823 {
3824 int utf8 = 0;
3825
3826 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaar24f77502020-09-04 19:50:57 +02003827 utf8 = (int)tv_get_bool_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003828
3829 if (utf8)
Bram Moolenaarbdace832019-03-02 10:13:42 +01003830 rettv->vval.v_number = utf_ptr2char(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003831 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003832 rettv->vval.v_number = (*mb_ptr2char)(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003833 }
3834 else
Bram Moolenaar13505972019-01-24 15:04:48 +01003835 rettv->vval.v_number = tv_get_string(&argvars[0])[0];
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003836}
3837
Bram Moolenaar17793ef2020-12-28 12:56:58 +01003838/*
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003839 * Get the current cursor column and store it in 'rettv'. If 'charcol' is TRUE,
3840 * returns the character index of the column. Otherwise, returns the byte index
3841 * of the column.
3842 */
3843 static void
3844get_col(typval_T *argvars, typval_T *rettv, int charcol)
3845{
3846 colnr_T col = 0;
3847 pos_T *fp;
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00003848 switchwin_T switchwin;
3849 int winchanged = FALSE;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003850
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00003851 if (check_for_string_or_list_arg(argvars, 0) == FAIL
3852 || check_for_opt_number_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003853 return;
3854
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00003855 if (argvars[1].v_type != VAR_UNKNOWN)
3856 {
3857 tabpage_T *tp;
3858 win_T *wp;
3859
3860 // use the window specified in the second argument
3861 wp = win_id2wp_tp((int)tv_get_number(&argvars[1]), &tp);
3862 if (wp == NULL || tp == NULL)
3863 return;
3864
3865 if (switch_win_noblock(&switchwin, wp, tp, TRUE) != OK)
3866 return;
3867
3868 check_cursor();
3869 winchanged = TRUE;
3870 }
3871
3872 int fnum = curbuf->b_fnum;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003873 fp = var2fpos(&argvars[0], FALSE, &fnum, charcol);
3874 if (fp != NULL && fnum == curbuf->b_fnum)
3875 {
3876 if (fp->col == MAXCOL)
3877 {
3878 // '> can be MAXCOL, get the length of the line then
3879 if (fp->lnum <= curbuf->b_ml.ml_line_count)
John Marriottbfcc8952024-03-11 22:04:45 +01003880 col = ml_get_len(fp->lnum) + 1;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003881 else
3882 col = MAXCOL;
3883 }
3884 else
3885 {
3886 col = fp->col + 1;
3887 // col(".") when the cursor is on the NUL at the end of the line
3888 // because of "coladd" can be seen as an extra column.
3889 if (virtual_active() && fp == &curwin->w_cursor)
3890 {
3891 char_u *p = ml_get_cursor();
3892
3893 if (curwin->w_cursor.coladd >= (colnr_T)chartabsize(p,
3894 curwin->w_virtcol - curwin->w_cursor.coladd))
3895 {
3896 int l;
3897
3898 if (*p != NUL && p[(l = (*mb_ptr2len)(p))] == NUL)
3899 col += l;
3900 }
3901 }
3902 }
3903 }
3904 rettv->vval.v_number = col;
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00003905
3906 if (winchanged)
3907 restore_win_noblock(&switchwin, TRUE);
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003908}
3909
3910/*
3911 * "charcol()" function
3912 */
3913 static void
3914f_charcol(typval_T *argvars, typval_T *rettv)
3915{
3916 get_col(argvars, rettv, TRUE);
3917}
3918
Bram Moolenaar29b7d7a2019-07-22 23:03:57 +02003919 win_T *
Bram Moolenaaraff74912019-03-30 18:11:49 +01003920get_optional_window(typval_T *argvars, int idx)
3921{
3922 win_T *win = curwin;
3923
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003924 if (argvars[idx].v_type == VAR_UNKNOWN)
3925 return curwin;
3926
3927 win = find_win_by_nr_or_id(&argvars[idx]);
3928 if (win == NULL)
Bram Moolenaaraff74912019-03-30 18:11:49 +01003929 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003930 emsg(_(e_invalid_window_number));
3931 return NULL;
Bram Moolenaaraff74912019-03-30 18:11:49 +01003932 }
3933 return win;
3934}
3935
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003936/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003937 * "col(string)" function
3938 */
3939 static void
3940f_col(typval_T *argvars, typval_T *rettv)
3941{
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003942 get_col(argvars, rettv, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003943}
3944
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003945/*
3946 * "confirm(message, buttons[, default [, type]])" function
3947 */
3948 static void
3949f_confirm(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
3950{
3951#if defined(FEAT_GUI_DIALOG) || defined(FEAT_CON_DIALOG)
3952 char_u *message;
3953 char_u *buttons = NULL;
3954 char_u buf[NUMBUFLEN];
3955 char_u buf2[NUMBUFLEN];
3956 int def = 1;
3957 int type = VIM_GENERIC;
3958 char_u *typestr;
3959 int error = FALSE;
3960
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02003961 if (in_vim9script()
3962 && (check_for_string_arg(argvars, 0) == FAIL
3963 || (check_for_opt_string_arg(argvars, 1) == FAIL
3964 || (argvars[1].v_type != VAR_UNKNOWN
3965 && (check_for_opt_number_arg(argvars, 2) == FAIL
3966 || (argvars[2].v_type != VAR_UNKNOWN
3967 && check_for_opt_string_arg(argvars, 3) == FAIL))))))
Bram Moolenaarc5809432021-03-27 21:23:30 +01003968 return;
3969
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003970 message = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003971 if (message == NULL)
3972 error = TRUE;
3973 if (argvars[1].v_type != VAR_UNKNOWN)
3974 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003975 buttons = tv_get_string_buf_chk(&argvars[1], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003976 if (buttons == NULL)
3977 error = TRUE;
3978 if (argvars[2].v_type != VAR_UNKNOWN)
3979 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003980 def = (int)tv_get_number_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003981 if (argvars[3].v_type != VAR_UNKNOWN)
3982 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003983 typestr = tv_get_string_buf_chk(&argvars[3], buf2);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003984 if (typestr == NULL)
3985 error = TRUE;
3986 else
3987 {
3988 switch (TOUPPER_ASC(*typestr))
3989 {
3990 case 'E': type = VIM_ERROR; break;
3991 case 'Q': type = VIM_QUESTION; break;
3992 case 'I': type = VIM_INFO; break;
3993 case 'W': type = VIM_WARNING; break;
3994 case 'G': type = VIM_GENERIC; break;
3995 }
3996 }
3997 }
3998 }
3999 }
4000
4001 if (buttons == NULL || *buttons == NUL)
4002 buttons = (char_u *)_("&Ok");
4003
4004 if (!error)
4005 rettv->vval.v_number = do_dialog(type, NULL, message, buttons,
4006 def, NULL, FALSE);
4007#endif
4008}
4009
4010/*
4011 * "copy()" function
4012 */
4013 static void
4014f_copy(typval_T *argvars, typval_T *rettv)
4015{
Bram Moolenaar381692b2022-02-02 20:01:27 +00004016 item_copy(&argvars[0], rettv, FALSE, TRUE, 0);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004017}
4018
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004019/*
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004020 * Set the cursor position.
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01004021 * If "charcol" is TRUE, then use the column number as a character offset.
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004022 * Otherwise use the column number as a byte offset.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004023 */
4024 static void
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004025set_cursorpos(typval_T *argvars, typval_T *rettv, int charcol)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004026{
Bram Moolenaar79f23442022-10-10 12:42:57 +01004027 long lnum, col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004028 long coladd = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004029 int set_curswant = TRUE;
4030
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004031 if (in_vim9script()
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004032 && (check_for_string_or_number_or_list_arg(argvars, 0) == FAIL
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02004033 || check_for_opt_number_arg(argvars, 1) == FAIL
4034 || (argvars[1].v_type != VAR_UNKNOWN
4035 && check_for_opt_number_arg(argvars, 2) == FAIL)))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004036 return;
4037
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004038 rettv->vval.v_number = -1;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004039 if (argvars[0].v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004040 {
4041 pos_T pos;
4042 colnr_T curswant = -1;
4043
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004044 if (list2fpos(argvars, &pos, NULL, &curswant, charcol) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004045 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00004046 emsg(_(e_invalid_argument));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004047 return;
4048 }
Bram Moolenaar79f23442022-10-10 12:42:57 +01004049 lnum = pos.lnum;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004050 col = pos.col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004051 coladd = pos.coladd;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004052 if (curswant >= 0)
4053 {
4054 curwin->w_curswant = curswant - 1;
4055 set_curswant = FALSE;
4056 }
4057 }
Bram Moolenaar79f23442022-10-10 12:42:57 +01004058 else if ((argvars[0].v_type == VAR_NUMBER
4059 || argvars[0].v_type == VAR_STRING)
4060 && (argvars[1].v_type == VAR_NUMBER
4061 || argvars[1].v_type == VAR_STRING))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004062 {
Bram Moolenaar79f23442022-10-10 12:42:57 +01004063 lnum = tv_get_lnum(argvars);
4064 if (lnum < 0)
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00004065 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[0]));
Bram Moolenaar79f23442022-10-10 12:42:57 +01004066 else if (lnum == 0)
4067 lnum = curwin->w_cursor.lnum;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004068 col = (long)tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004069 if (charcol)
Bram Moolenaar79f23442022-10-10 12:42:57 +01004070 col = buf_charidx_to_byteidx(curbuf, lnum, col) + 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004071 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004072 coladd = (long)tv_get_number_chk(&argvars[2], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004073 }
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004074 else
4075 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00004076 emsg(_(e_invalid_argument));
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004077 return;
4078 }
Bram Moolenaar79f23442022-10-10 12:42:57 +01004079 if (lnum < 0 || col < 0 || coladd < 0)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004080 return; // type error; errmsg already given
Bram Moolenaar79f23442022-10-10 12:42:57 +01004081 if (lnum > 0)
4082 curwin->w_cursor.lnum = lnum;
zeertzjq2ffdae72024-05-02 13:06:24 +02004083 if (col != MAXCOL && --col < 0)
4084 col = 0;
4085 curwin->w_cursor.col = col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004086 curwin->w_cursor.coladd = coladd;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004087
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004088 // Make sure the cursor is in a valid position.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004089 check_cursor();
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004090 // Correct cursor for multi-byte character.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004091 if (has_mbyte)
4092 mb_adjust_cursor();
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004093
4094 curwin->w_set_curswant = set_curswant;
4095 rettv->vval.v_number = 0;
4096}
4097
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004098/*
4099 * "cursor(lnum, col)" function, or
4100 * "cursor(list)"
4101 *
4102 * Moves the cursor to the specified line and column.
4103 * Returns 0 when the position could be set, -1 otherwise.
4104 */
4105 static void
4106f_cursor(typval_T *argvars, typval_T *rettv)
4107{
4108 set_cursorpos(argvars, rettv, FALSE);
4109}
4110
Bram Moolenaar4f974752019-02-17 17:44:42 +01004111#ifdef MSWIN
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004112/*
4113 * "debugbreak()" function
4114 */
4115 static void
4116f_debugbreak(typval_T *argvars, typval_T *rettv)
4117{
4118 int pid;
4119
4120 rettv->vval.v_number = FAIL;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004121 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
4122 return;
4123
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004124 pid = (int)tv_get_number(&argvars[0]);
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004125 if (pid == 0)
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004126 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00004127 emsg(_(e_invalid_argument));
4128 return;
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004129 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00004130
4131 HANDLE hProcess = OpenProcess(PROCESS_ALL_ACCESS, 0, pid);
4132 if (hProcess == NULL)
4133 return;
4134
4135 DebugBreakProcess(hProcess);
4136 CloseHandle(hProcess);
4137 rettv->vval.v_number = OK;
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004138}
4139#endif
4140
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004141/*
4142 * "deepcopy()" function
4143 */
4144 static void
4145f_deepcopy(typval_T *argvars, typval_T *rettv)
4146{
Bram Moolenaar239f8d92021-01-17 13:21:20 +01004147 varnumber_T noref = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004148
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +01004149 if (check_for_opt_bool_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004150 return;
4151
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004152 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaar239f8d92021-01-17 13:21:20 +01004153 noref = tv_get_bool_chk(&argvars[1], NULL);
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +01004154
4155 item_copy(&argvars[0], rettv, TRUE, TRUE, noref == 0 ? get_copyID() : 0);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004156}
4157
4158/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004159 * "did_filetype()" function
4160 */
4161 static void
4162f_did_filetype(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
4163{
zeertzjq5bf6c212024-03-31 18:41:27 +02004164 rettv->vval.v_number = curbuf->b_did_filetype;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004165}
4166
4167/*
Bram Moolenaar4132eb52020-02-14 16:53:00 +01004168 * "echoraw({expr})" function
4169 */
4170 static void
4171f_echoraw(typval_T *argvars, typval_T *rettv UNUSED)
4172{
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02004173 char_u *str;
Bram Moolenaar4132eb52020-02-14 16:53:00 +01004174
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02004175 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
4176 return;
4177
4178 str = tv_get_string_chk(&argvars[0]);
Bram Moolenaar4132eb52020-02-14 16:53:00 +01004179 if (str != NULL && *str != NUL)
4180 {
4181 out_str(str);
4182 out_flush();
4183 }
4184}
4185
4186/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004187 * "empty({expr})" function
4188 */
4189 static void
4190f_empty(typval_T *argvars, typval_T *rettv)
4191{
4192 int n = FALSE;
4193
4194 switch (argvars[0].v_type)
4195 {
4196 case VAR_STRING:
4197 case VAR_FUNC:
4198 n = argvars[0].vval.v_string == NULL
4199 || *argvars[0].vval.v_string == NUL;
4200 break;
4201 case VAR_PARTIAL:
Yegappan Lakshmananda9d3452024-05-02 13:02:36 +02004202 n = argvars[0].vval.v_partial == NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004203 break;
4204 case VAR_NUMBER:
4205 n = argvars[0].vval.v_number == 0;
4206 break;
4207 case VAR_FLOAT:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004208 n = argvars[0].vval.v_float == 0.0;
4209 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004210 case VAR_LIST:
4211 n = argvars[0].vval.v_list == NULL
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004212 || argvars[0].vval.v_list->lv_len == 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004213 break;
4214 case VAR_DICT:
4215 n = argvars[0].vval.v_dict == NULL
4216 || argvars[0].vval.v_dict->dv_hashtab.ht_used == 0;
4217 break;
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01004218 case VAR_BOOL:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004219 case VAR_SPECIAL:
4220 n = argvars[0].vval.v_number != VVAL_TRUE;
4221 break;
Bram Moolenaar00b28d62022-12-08 15:32:33 +00004222 case VAR_CLASS:
4223 n = argvars[0].vval.v_class != NULL;
4224 break;
4225 case VAR_OBJECT:
Yegappan Lakshmanand3eae7b2024-03-03 16:26:58 +01004226 n = object_empty(argvars[0].vval.v_object);
Bram Moolenaar00b28d62022-12-08 15:32:33 +00004227 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004228
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01004229 case VAR_BLOB:
4230 n = argvars[0].vval.v_blob == NULL
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01004231 || argvars[0].vval.v_blob->bv_ga.ga_len == 0;
4232 break;
4233
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004234 case VAR_JOB:
4235#ifdef FEAT_JOB_CHANNEL
4236 n = argvars[0].vval.v_job == NULL
4237 || argvars[0].vval.v_job->jv_status != JOB_STARTED;
4238 break;
4239#endif
4240 case VAR_CHANNEL:
4241#ifdef FEAT_JOB_CHANNEL
4242 n = argvars[0].vval.v_channel == NULL
4243 || !channel_is_open(argvars[0].vval.v_channel);
4244 break;
4245#endif
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +02004246 case VAR_TYPEALIAS:
4247 n = argvars[0].vval.v_typealias == NULL
4248 || argvars[0].vval.v_typealias->ta_name == NULL
4249 || *argvars[0].vval.v_typealias->ta_name == NUL;
4250 break;
4251
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004252 case VAR_UNKNOWN:
Bram Moolenaar4c683752020-04-05 21:38:23 +02004253 case VAR_ANY:
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004254 case VAR_VOID:
Bram Moolenaarf18332f2021-05-07 17:55:55 +02004255 case VAR_INSTR:
Bram Moolenaardd589232020-02-29 17:38:12 +01004256 internal_error_no_abort("f_empty(UNKNOWN)");
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004257 n = TRUE;
4258 break;
4259 }
4260
4261 rettv->vval.v_number = n;
4262}
4263
4264/*
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004265 * "environ()" function
4266 */
4267 static void
4268f_environ(typval_T *argvars UNUSED, typval_T *rettv)
4269{
4270#if !defined(AMIGA)
4271 int i = 0;
4272 char_u *entry, *value;
Bram Moolenaar68aaff42022-04-17 10:57:44 +01004273# if defined (MSWIN)
4274# if !defined(_UCRT)
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004275 extern wchar_t **_wenviron;
Bram Moolenaar68aaff42022-04-17 10:57:44 +01004276# endif
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004277# else
4278 extern char **environ;
4279# endif
4280
Bram Moolenaar93a10962022-06-16 11:42:09 +01004281 if (rettv_dict_alloc(rettv) == FAIL)
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004282 return;
4283
4284# ifdef MSWIN
4285 if (*_wenviron == NULL)
4286 return;
4287# else
4288 if (*environ == NULL)
4289 return;
4290# endif
4291
4292 for (i = 0; ; ++i)
4293 {
4294# ifdef MSWIN
4295 short_u *p;
4296
4297 if ((p = (short_u *)_wenviron[i]) == NULL)
4298 return;
4299 entry = utf16_to_enc(p, NULL);
4300# else
4301 if ((entry = (char_u *)environ[i]) == NULL)
4302 return;
4303 entry = vim_strsave(entry);
4304# endif
4305 if (entry == NULL) // out of memory
4306 return;
4307 if ((value = vim_strchr(entry, '=')) == NULL)
4308 {
4309 vim_free(entry);
4310 continue;
4311 }
4312 *value++ = NUL;
4313 dict_add_string(rettv->vval.v_dict, (char *)entry, value);
4314 vim_free(entry);
4315 }
4316#endif
4317}
4318
4319/*
Bram Moolenaar80adaa82023-07-07 18:57:40 +01004320 * "err_teapot()" function
4321 */
4322 static void
4323f_err_teapot(typval_T *argvars, typval_T *rettv UNUSED)
4324{
4325 if (argvars[0].v_type != VAR_UNKNOWN)
4326 {
4327 if (argvars[0].v_type == VAR_STRING)
4328 {
4329 char_u *s = tv_get_string_strict(&argvars[0]);
Sean Dewarb0efa492023-07-08 10:35:19 +01004330 if (*skipwhite(s) == NUL)
Bram Moolenaar80adaa82023-07-07 18:57:40 +01004331 return;
4332 }
4333
4334 int err = FALSE;
4335 int do_503 = eval_expr_to_bool(&argvars[0], &err);
4336 if (!err && do_503)
4337 {
4338 emsg(_(e_coffee_currently_not_available));
4339 return;
4340 }
4341 }
4342
4343 emsg(_(e_im_a_teapot));
4344}
4345
4346/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004347 * "escape({string}, {chars})" function
4348 */
4349 static void
4350f_escape(typval_T *argvars, typval_T *rettv)
4351{
4352 char_u buf[NUMBUFLEN];
4353
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004354 if (in_vim9script()
4355 && (check_for_string_arg(argvars, 0) == FAIL
4356 || check_for_string_arg(argvars, 1) == FAIL))
4357 return;
4358
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004359 rettv->vval.v_string = vim_strsave_escaped(tv_get_string(&argvars[0]),
4360 tv_get_string_buf(&argvars[1], buf));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004361 rettv->v_type = VAR_STRING;
4362}
4363
4364/*
4365 * "eval()" function
4366 */
4367 static void
4368f_eval(typval_T *argvars, typval_T *rettv)
4369{
4370 char_u *s, *p;
4371
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004372 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
4373 return;
4374
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004375 s = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004376 if (s != NULL)
4377 s = skipwhite(s);
4378
4379 p = s;
Bram Moolenaar5409f5d2020-06-24 18:37:35 +02004380 if (s == NULL || eval1(&s, rettv, &EVALARG_EVALUATE) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004381 {
4382 if (p != NULL && !aborting())
Bram Moolenaar108010a2021-06-27 22:03:33 +02004383 semsg(_(e_invalid_expression_str), p);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004384 need_clr_eos = FALSE;
4385 rettv->v_type = VAR_NUMBER;
4386 rettv->vval.v_number = 0;
4387 }
4388 else if (*s != NUL)
Bram Moolenaar74409f62022-01-01 15:58:22 +00004389 semsg(_(e_trailing_characters_str), s);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004390}
4391
4392/*
4393 * "eventhandler()" function
4394 */
4395 static void
4396f_eventhandler(typval_T *argvars UNUSED, typval_T *rettv)
4397{
Bram Moolenaardfc33a62020-04-29 22:30:13 +02004398 rettv->vval.v_number = vgetc_busy || input_busy;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004399}
4400
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004401static garray_T redir_execute_ga;
4402
4403/*
4404 * Append "value[value_len]" to the execute() output.
4405 */
4406 void
4407execute_redir_str(char_u *value, int value_len)
4408{
4409 int len;
4410
4411 if (value_len == -1)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004412 len = (int)STRLEN(value); // Append the entire string
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004413 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004414 len = value_len; // Append only "value_len" characters
Yegappan Lakshmananfadc02a2023-01-27 21:03:12 +00004415 if (ga_grow(&redir_execute_ga, len) == FAIL)
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00004416 return;
4417
4418 mch_memmove((char *)redir_execute_ga.ga_data
4419 + redir_execute_ga.ga_len, value, len);
4420 redir_execute_ga.ga_len += len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004421}
4422
Dominique Pelle748b3082022-01-08 12:41:16 +00004423#if defined(FEAT_LUA) || defined(PROTO)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004424/*
Yegappan Lakshmanan11328bc2021-08-06 21:34:38 +02004425 * Get next line from a string containing NL separated lines.
4426 * Called by do_cmdline() to get the next line.
4427 * Returns an allocated string, or NULL when at the end of the string.
4428 */
4429 static char_u *
4430get_str_line(
4431 int c UNUSED,
4432 void *cookie,
4433 int indent UNUSED,
4434 getline_opt_T options UNUSED)
4435{
4436 char_u *start = *(char_u **)cookie;
4437 char_u *line;
4438 char_u *p;
4439
4440 p = start;
4441 if (p == NULL || *p == NUL)
4442 return NULL;
4443 p = vim_strchr(p, '\n');
4444 if (p == NULL)
4445 line = vim_strsave(start);
4446 else
4447 {
4448 line = vim_strnsave(start, p - start);
4449 p++;
4450 }
4451
4452 *(char_u **)cookie = p;
4453 return line;
4454}
4455
4456/*
4457 * Execute a series of Ex commands in 'str'
4458 */
4459 void
4460execute_cmds_from_string(char_u *str)
4461{
4462 do_cmdline(NULL, get_str_line, (void *)&str,
4463 DOCMD_NOWAIT|DOCMD_VERBOSE|DOCMD_REPEAT|DOCMD_KEYTYPED);
4464}
Dominique Pelle748b3082022-01-08 12:41:16 +00004465#endif
Yegappan Lakshmanan11328bc2021-08-06 21:34:38 +02004466
4467/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004468 * Get next line from a list.
4469 * Called by do_cmdline() to get the next line.
4470 * Returns allocated string, or NULL for end of function.
4471 */
Bram Moolenaara7583c42022-05-07 21:14:05 +01004472 char_u *
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004473get_list_line(
4474 int c UNUSED,
4475 void *cookie,
Bram Moolenaare96a2492019-06-25 04:12:16 +02004476 int indent UNUSED,
Bram Moolenaar66250c92020-08-20 15:02:42 +02004477 getline_opt_T options UNUSED)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004478{
4479 listitem_T **p = (listitem_T **)cookie;
4480 listitem_T *item = *p;
4481 char_u buf[NUMBUFLEN];
4482 char_u *s;
4483
4484 if (item == NULL)
4485 return NULL;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004486 s = tv_get_string_buf_chk(&item->li_tv, buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004487 *p = item->li_next;
4488 return s == NULL ? NULL : vim_strsave(s);
4489}
4490
4491/*
4492 * "execute()" function
4493 */
Bram Moolenaar261f3462019-09-07 15:45:32 +02004494 void
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004495execute_common(typval_T *argvars, typval_T *rettv, int arg_off)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004496{
4497 char_u *cmd = NULL;
4498 list_T *list = NULL;
4499 int save_msg_silent = msg_silent;
4500 int save_emsg_silent = emsg_silent;
4501 int save_emsg_noredir = emsg_noredir;
4502 int save_redir_execute = redir_execute;
Bram Moolenaar20951482017-12-25 13:44:43 +01004503 int save_redir_off = redir_off;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004504 garray_T save_ga;
Bram Moolenaar10ccaa12018-12-07 16:38:23 +01004505 int save_msg_col = msg_col;
Kota Kato3d3f6ac2022-08-04 18:50:14 +01004506 int save_sticky_cmdmod_flags = sticky_cmdmod_flags;
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004507 int echo_output = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004508
4509 rettv->vval.v_string = NULL;
4510 rettv->v_type = VAR_STRING;
4511
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004512 if (argvars[arg_off].v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004513 {
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004514 list = argvars[arg_off].vval.v_list;
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004515 if (list == NULL || list->lv_len == 0)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004516 // empty list, no commands, empty output
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004517 return;
4518 ++list->lv_refcount;
4519 }
Bram Moolenaare2a8f072020-01-08 19:32:18 +01004520 else if (argvars[arg_off].v_type == VAR_JOB
4521 || argvars[arg_off].v_type == VAR_CHANNEL)
4522 {
Bram Moolenaar68db9962021-05-09 23:19:22 +02004523 semsg(_(e_using_invalid_value_as_string_str),
4524 vartype_name(argvars[arg_off].v_type));
Bram Moolenaare2a8f072020-01-08 19:32:18 +01004525 return;
4526 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004527 else
4528 {
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004529 cmd = tv_get_string_chk(&argvars[arg_off]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004530 if (cmd == NULL)
4531 return;
4532 }
4533
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004534 if (argvars[arg_off + 1].v_type != VAR_UNKNOWN)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004535 {
4536 char_u buf[NUMBUFLEN];
Bram Moolenaar3cfa5b12021-06-06 14:14:39 +02004537 char_u *s = tv_get_string_buf_chk_strict(&argvars[arg_off + 1], buf,
4538 in_vim9script());
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004539
4540 if (s == NULL)
4541 return;
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004542 if (*s == NUL)
4543 echo_output = TRUE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004544 if (STRNCMP(s, "silent", 6) == 0)
4545 ++msg_silent;
4546 if (STRCMP(s, "silent!") == 0)
4547 {
4548 emsg_silent = TRUE;
4549 emsg_noredir = TRUE;
4550 }
4551 }
4552 else
4553 ++msg_silent;
4554
4555 if (redir_execute)
4556 save_ga = redir_execute_ga;
Bram Moolenaar04935fb2022-01-08 16:19:22 +00004557 ga_init2(&redir_execute_ga, sizeof(char), 500);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004558 redir_execute = TRUE;
Bram Moolenaar20951482017-12-25 13:44:43 +01004559 redir_off = FALSE;
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004560 if (!echo_output)
4561 msg_col = 0; // prevent leading spaces
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004562
Kota Kato3d3f6ac2022-08-04 18:50:14 +01004563 // For "legacy call execute('cmd')" and "vim9cmd execute('cmd')" apply the
4564 // command modifiers to "cmd".
4565 sticky_cmdmod_flags = cmdmod.cmod_flags & (CMOD_LEGACY | CMOD_VIM9CMD);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004566 if (cmd != NULL)
4567 do_cmdline_cmd(cmd);
4568 else
4569 {
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004570 listitem_T *item;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004571
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02004572 CHECK_LIST_MATERIALIZE(list);
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004573 item = list->lv_first;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004574 do_cmdline(NULL, get_list_line, (void *)&item,
4575 DOCMD_NOWAIT|DOCMD_VERBOSE|DOCMD_REPEAT|DOCMD_KEYTYPED);
4576 --list->lv_refcount;
4577 }
Kota Kato3d3f6ac2022-08-04 18:50:14 +01004578 sticky_cmdmod_flags = save_sticky_cmdmod_flags;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004579
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004580 // Need to append a NUL to the result.
Bram Moolenaard297f352017-01-29 20:31:21 +01004581 if (ga_grow(&redir_execute_ga, 1) == OK)
4582 {
4583 ((char *)redir_execute_ga.ga_data)[redir_execute_ga.ga_len] = NUL;
4584 rettv->vval.v_string = redir_execute_ga.ga_data;
4585 }
4586 else
4587 {
4588 ga_clear(&redir_execute_ga);
4589 rettv->vval.v_string = NULL;
4590 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004591 msg_silent = save_msg_silent;
4592 emsg_silent = save_emsg_silent;
4593 emsg_noredir = save_emsg_noredir;
4594
4595 redir_execute = save_redir_execute;
4596 if (redir_execute)
4597 redir_execute_ga = save_ga;
Bram Moolenaar20951482017-12-25 13:44:43 +01004598 redir_off = save_redir_off;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004599
Bram Moolenaar10ccaa12018-12-07 16:38:23 +01004600 // "silent reg" or "silent echo x" leaves msg_col somewhere in the line.
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004601 if (echo_output)
4602 // When not working silently: put it in column zero. A following
4603 // "echon" will overwrite the message, unavoidably.
4604 msg_col = 0;
4605 else
4606 // When working silently: Put it back where it was, since nothing
4607 // should have been written.
4608 msg_col = save_msg_col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004609}
4610
4611/*
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004612 * "execute()" function
4613 */
4614 static void
4615f_execute(typval_T *argvars, typval_T *rettv)
4616{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004617 if (in_vim9script()
4618 && (check_for_string_or_list_arg(argvars, 0) == FAIL
4619 || check_for_opt_string_arg(argvars, 1) == FAIL))
4620 return;
4621
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004622 execute_common(argvars, rettv, 0);
4623}
4624
4625/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004626 * "exists()" function
4627 */
Bram Moolenaarbb7ee7a2021-08-02 20:06:50 +02004628 void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004629f_exists(typval_T *argvars, typval_T *rettv)
4630{
4631 char_u *p;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004632 int n = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004633
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004634 if (in_vim9script() && check_for_nonempty_string_arg(argvars, 0) == FAIL)
4635 return;
4636
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004637 p = tv_get_string(&argvars[0]);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004638 if (*p == '$') // environment variable
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004639 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004640 // first try "normal" environment variables (fast)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004641 if (mch_getenv(p + 1) != NULL)
4642 n = TRUE;
4643 else
4644 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004645 // try expanding things like $VIM and ${HOME}
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004646 p = expand_env_save(p);
4647 if (p != NULL && *p != '$')
4648 n = TRUE;
4649 vim_free(p);
4650 }
4651 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004652 else if (*p == '&' || *p == '+') // option
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004653 {
Bram Moolenaar9a78e6d2020-07-01 18:29:55 +02004654 n = (eval_option(&p, NULL, TRUE) == OK);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004655 if (*skipwhite(p) != NUL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004656 n = FALSE; // trailing garbage
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004657 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004658 else if (*p == '*') // internal or user defined function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004659 {
Bram Moolenaarb54c3ff2016-07-31 14:11:58 +02004660 n = function_exists(p + 1, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004661 }
Bram Moolenaar15c47602020-03-26 22:16:48 +01004662 else if (*p == '?') // internal function only
4663 {
4664 n = has_internal_func_name(p + 1);
4665 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004666 else if (*p == ':')
4667 {
4668 n = cmd_exists(p + 1);
4669 }
4670 else if (*p == '#')
4671 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004672 if (p[1] == '#')
4673 n = autocmd_supported(p + 2);
4674 else
4675 n = au_exists(p + 1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004676 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004677 else // internal variable
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004678 {
Bram Moolenaarc6f9f732018-02-11 19:06:26 +01004679 n = var_exists(p);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004680 }
4681
4682 rettv->vval.v_number = n;
4683}
4684
Bram Moolenaar26735992021-08-08 14:43:22 +02004685 static void
4686f_exists_compiled(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
4687{
4688 emsg(_(e_exists_compiled_can_only_be_used_in_def_function));
4689}
4690
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004691/*
4692 * "expand()" function
4693 */
4694 static void
4695f_expand(typval_T *argvars, typval_T *rettv)
4696{
4697 char_u *s;
Mike Williams51024bb2024-05-30 07:46:30 +02004698 size_t len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004699 int options = WILD_SILENT|WILD_USE_NL|WILD_LIST_NOTFOUND;
4700 expand_T xpc;
4701 int error = FALSE;
4702 char_u *result;
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004703#ifdef BACKSLASH_IN_FILENAME
4704 char_u *p_csl_save = p_csl;
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004705#endif
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004706
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004707 if (in_vim9script()
4708 && (check_for_string_arg(argvars, 0) == FAIL
4709 || check_for_opt_bool_arg(argvars, 1) == FAIL
4710 || (argvars[1].v_type != VAR_UNKNOWN
4711 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
4712 return;
4713
4714#ifdef BACKSLASH_IN_FILENAME
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004715 // avoid using 'completeslash' here
4716 p_csl = empty_option;
4717#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004718
4719 rettv->v_type = VAR_STRING;
4720 if (argvars[1].v_type != VAR_UNKNOWN
4721 && argvars[2].v_type != VAR_UNKNOWN
Bram Moolenaar551d25e2020-09-02 21:37:56 +02004722 && tv_get_bool_chk(&argvars[2], &error)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004723 && !error)
Bram Moolenaar45cf6e92017-04-30 20:25:19 +02004724 rettv_list_set(rettv, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004725
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004726 s = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004727 if (*s == '%' || *s == '#' || *s == '<')
4728 {
Bram Moolenaar57544522022-04-12 12:54:11 +01004729 char *errormsg = NULL;
4730
4731 if (p_verbose == 0)
4732 ++emsg_off;
Bram Moolenaara96edb72022-04-28 17:52:24 +01004733 result = eval_vars(s, s, &len, NULL, &errormsg, NULL, FALSE);
Bram Moolenaar57544522022-04-12 12:54:11 +01004734 if (p_verbose == 0)
4735 --emsg_off;
4736 else if (errormsg != NULL)
4737 emsg(errormsg);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004738 if (rettv->v_type == VAR_LIST)
4739 {
Bram Moolenaar93a10962022-06-16 11:42:09 +01004740 if (rettv_list_alloc(rettv) == OK && result != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004741 list_append_string(rettv->vval.v_list, result, -1);
Bram Moolenaar86173482019-10-01 17:02:16 +02004742 vim_free(result);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004743 }
4744 else
4745 rettv->vval.v_string = result;
4746 }
4747 else
4748 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004749 // When the optional second argument is non-zero, don't remove matches
4750 // for 'wildignore' and don't put matches for 'suffixes' at the end.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004751 if (argvars[1].v_type != VAR_UNKNOWN
Bram Moolenaar551d25e2020-09-02 21:37:56 +02004752 && tv_get_bool_chk(&argvars[1], &error))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004753 options |= WILD_KEEP_ALL;
4754 if (!error)
4755 {
4756 ExpandInit(&xpc);
4757 xpc.xp_context = EXPAND_FILES;
4758 if (p_wic)
4759 options += WILD_ICASE;
4760 if (rettv->v_type == VAR_STRING)
4761 rettv->vval.v_string = ExpandOne(&xpc, s, NULL,
4762 options, WILD_ALL);
Bram Moolenaar93a10962022-06-16 11:42:09 +01004763 else if (rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004764 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004765 ExpandOne(&xpc, s, NULL, options, WILD_ALL_KEEP);
Bram Moolenaar848db572022-09-20 19:04:32 +01004766 for (int i = 0; i < xpc.xp_numfiles; i++)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004767 list_append_string(rettv->vval.v_list, xpc.xp_files[i], -1);
4768 ExpandCleanup(&xpc);
4769 }
4770 }
4771 else
4772 rettv->vval.v_string = NULL;
4773 }
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004774#ifdef BACKSLASH_IN_FILENAME
4775 p_csl = p_csl_save;
4776#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004777}
4778
4779/*
Bram Moolenaar80dad482019-06-09 17:22:31 +02004780 * "expandcmd()" function
4781 * Expand all the special characters in a command string.
4782 */
4783 static void
4784f_expandcmd(typval_T *argvars, typval_T *rettv)
4785{
4786 exarg_T eap;
4787 char_u *cmdstr;
4788 char *errormsg = NULL;
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004789 int emsgoff = TRUE;
Bram Moolenaar80dad482019-06-09 17:22:31 +02004790
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004791 if (in_vim9script()
4792 && (check_for_string_arg(argvars, 0) == FAIL
4793 || check_for_opt_dict_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004794 return;
4795
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004796 if (argvars[1].v_type == VAR_DICT
Bram Moolenaard61efa52022-07-23 09:52:04 +01004797 && dict_get_bool(argvars[1].vval.v_dict, "errmsg", VVAL_FALSE))
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004798 emsgoff = FALSE;
4799
Bram Moolenaar80dad482019-06-09 17:22:31 +02004800 rettv->v_type = VAR_STRING;
4801 cmdstr = vim_strsave(tv_get_string(&argvars[0]));
4802
Yegappan Lakshmanan960dcbd2023-03-07 17:45:11 +00004803 CLEAR_FIELD(eap);
Bram Moolenaar80dad482019-06-09 17:22:31 +02004804 eap.cmd = cmdstr;
4805 eap.arg = cmdstr;
Bram Moolenaar8071cb22019-07-12 17:58:01 +02004806 eap.argt |= EX_NOSPC;
Bram Moolenaar80dad482019-06-09 17:22:31 +02004807 eap.usefilter = FALSE;
4808 eap.nextcmd = NULL;
4809 eap.cmdidx = CMD_USER;
4810
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004811 if (emsgoff)
4812 ++emsg_off;
4813 if (expand_filename(&eap, &cmdstr, &errormsg) == FAIL)
4814 if (!emsgoff && errormsg != NULL && *errormsg != NUL)
4815 emsg(errormsg);
4816 if (emsgoff)
4817 --emsg_off;
Bram Moolenaar80dad482019-06-09 17:22:31 +02004818
4819 rettv->vval.v_string = cmdstr;
4820}
4821
4822/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004823 * "feedkeys()" function
4824 */
4825 static void
4826f_feedkeys(typval_T *argvars, typval_T *rettv UNUSED)
4827{
4828 int remap = TRUE;
4829 int insert = FALSE;
4830 char_u *keys, *flags;
4831 char_u nbuf[NUMBUFLEN];
4832 int typed = FALSE;
4833 int execute = FALSE;
Bram Moolenaara9725222022-01-16 13:30:33 +00004834 int context = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004835 int dangerous = FALSE;
Bram Moolenaar5e66b422019-01-24 21:58:10 +01004836 int lowlevel = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004837
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004838 // This is not allowed in the sandbox. If the commands would still be
4839 // executed in the sandbox it would be OK, but it probably happens later,
4840 // when "sandbox" is no longer set.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004841 if (check_secure())
4842 return;
4843
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004844 if (in_vim9script()
4845 && (check_for_string_arg(argvars, 0) == FAIL
4846 || check_for_opt_string_arg(argvars, 1) == FAIL))
4847 return;
4848
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004849 keys = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004850
4851 if (argvars[1].v_type != VAR_UNKNOWN)
4852 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004853 flags = tv_get_string_buf(&argvars[1], nbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004854 for ( ; *flags != NUL; ++flags)
4855 {
4856 switch (*flags)
4857 {
4858 case 'n': remap = FALSE; break;
4859 case 'm': remap = TRUE; break;
4860 case 't': typed = TRUE; break;
4861 case 'i': insert = TRUE; break;
4862 case 'x': execute = TRUE; break;
Bram Moolenaara9725222022-01-16 13:30:33 +00004863 case 'c': context = TRUE; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004864 case '!': dangerous = TRUE; break;
Bram Moolenaar5e66b422019-01-24 21:58:10 +01004865 case 'L': lowlevel = TRUE; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004866 }
4867 }
4868 }
4869
4870 if (*keys != NUL || execute)
4871 {
Christopher Plewright20b795e2022-12-20 20:01:58 +00004872 if (lowlevel
4873#ifdef FEAT_VTP
4874 && (!is_term_win32()
4875 || (keys[0] == 3 && ctrl_c_interrupts && typed))
4876#endif
4877 )
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004878 {
Bram Moolenaar5e66b422019-01-24 21:58:10 +01004879#ifdef USE_INPUT_BUF
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004880 ch_log(NULL, "feedkeys() lowlevel: %s", keys);
Bram Moolenaar9645e2d2020-03-20 20:48:49 +01004881
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004882 int len = (int)STRLEN(keys);
4883 for (int idx = 0; idx < len; ++idx)
4884 {
4885 // if a CTRL-C was typed, set got_int, similar to what
4886 // happens in fill_input_buf()
4887 if (keys[idx] == 3 && ctrl_c_interrupts && typed)
4888 got_int = TRUE;
4889 add_to_input_buf(keys + idx, 1);
4890 }
Bram Moolenaar5e66b422019-01-24 21:58:10 +01004891#else
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004892 emsg(_(e_lowlevel_input_not_supported));
Bram Moolenaar5e66b422019-01-24 21:58:10 +01004893#endif
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004894 }
4895 else
4896 {
4897 // Need to escape K_SPECIAL and CSI before putting the string in
4898 // the typeahead buffer.
4899 char_u *keys_esc = vim_strsave_escape_csi(keys);
4900 if (keys_esc == NULL)
4901 return;
4902
4903 ch_log(NULL, "feedkeys(%s): %s", typed ? "typed" : "", keys);
4904
4905 ins_typebuf(keys_esc, (remap ? REMAP_YES : REMAP_NONE),
4906 insert ? 0 : typebuf.tb_len, !typed, FALSE);
4907 if (vgetc_busy
Bram Moolenaar5d7be4f2017-06-25 13:40:17 +02004908#ifdef FEAT_TIMERS
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004909 || timer_busy
Bram Moolenaar5d7be4f2017-06-25 13:40:17 +02004910#endif
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004911 || input_busy)
4912 typebuf_was_filled = TRUE;
4913
Bram Moolenaar8d4ce562019-01-30 22:01:40 +01004914 vim_free(keys_esc);
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004915 }
Bram Moolenaar8d4ce562019-01-30 22:01:40 +01004916
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004917 if (execute)
4918 {
4919 int save_msg_scroll = msg_scroll;
4920 sctx_T save_sctx;
4921
4922 // Avoid a 1 second delay when the keys start Insert mode.
4923 msg_scroll = FALSE;
4924
4925 ch_log(NULL, "feedkeys() executing");
4926
4927 if (context)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004928 {
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004929 save_sctx = current_sctx;
4930 current_sctx.sc_sid = 0;
4931 current_sctx.sc_version = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004932 }
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004933
4934 if (!dangerous)
4935 {
4936 ++ex_normal_busy;
4937 ++in_feedkeys;
4938 }
4939 exec_normal(TRUE, lowlevel, TRUE);
4940 if (!dangerous)
4941 {
4942 --ex_normal_busy;
4943 --in_feedkeys;
4944 }
4945
4946 msg_scroll |= save_msg_scroll;
4947
4948 if (context)
4949 current_sctx = save_sctx;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004950 }
4951 }
4952}
4953
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004954/*
4955 * "fnameescape({string})" function
4956 */
4957 static void
4958f_fnameescape(typval_T *argvars, typval_T *rettv)
4959{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004960 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
4961 return;
4962
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004963 rettv->vval.v_string = vim_strsave_fnameescape(
Bram Moolenaar21c1a0c2021-10-17 17:20:23 +01004964 tv_get_string(&argvars[0]), VSE_NONE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004965 rettv->v_type = VAR_STRING;
4966}
4967
4968/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004969 * "foreground()" function
4970 */
4971 static void
4972f_foreground(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
4973{
4974#ifdef FEAT_GUI
4975 if (gui.in_use)
Bram Moolenaarafde13b2019-04-28 19:46:49 +02004976 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004977 gui_mch_set_foreground();
Bram Moolenaarafde13b2019-04-28 19:46:49 +02004978 return;
4979 }
4980#endif
4981#if defined(MSWIN) && (!defined(FEAT_GUI) || defined(VIMDLL))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004982 win32_set_foreground();
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004983#endif
4984}
4985
Bakudankun375141e2022-09-09 18:46:47 +01004986/*
4987 * "function()" function
4988 * "funcref()" function
4989 */
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004990 static void
Bram Moolenaar437bafe2016-08-01 15:40:54 +02004991common_function(typval_T *argvars, typval_T *rettv, int is_funcref)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004992{
4993 char_u *s;
4994 char_u *name;
4995 int use_string = FALSE;
4996 partial_T *arg_pt = NULL;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02004997 char_u *trans_name = NULL;
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02004998 int is_global = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004999
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02005000 if (in_vim9script()
Bram Moolenaarae1068a2021-12-25 19:43:44 +00005001 && (check_for_string_or_func_arg(argvars, 0) == FAIL
5002 || check_for_opt_list_arg(argvars, 1) == FAIL
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02005003 || (argvars[1].v_type != VAR_UNKNOWN
5004 && check_for_opt_dict_arg(argvars, 2) == FAIL)))
5005 return;
5006
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005007 if (argvars[0].v_type == VAR_FUNC)
5008 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005009 // function(MyFunc, [arg], dict)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005010 s = argvars[0].vval.v_string;
5011 }
5012 else if (argvars[0].v_type == VAR_PARTIAL
5013 && argvars[0].vval.v_partial != NULL)
5014 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005015 // function(dict.MyFunc, [arg])
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005016 arg_pt = argvars[0].vval.v_partial;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005017 s = partial_name(arg_pt);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005018 }
5019 else
5020 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005021 // function('MyFunc', [arg], dict)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005022 s = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005023 use_string = TRUE;
5024 }
Bram Moolenaar60b6e6f2021-08-28 12:49:27 +02005025 if (s == NULL)
5026 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00005027 semsg(_(e_invalid_argument_str), "NULL");
Bram Moolenaar60b6e6f2021-08-28 12:49:27 +02005028 return;
5029 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005030
Bram Moolenaar843b8842016-08-21 14:36:15 +02005031 if ((use_string && vim_strchr(s, AUTOLOAD_CHAR) == NULL) || is_funcref)
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005032 {
5033 name = s;
Bram Moolenaareba3b7f2021-11-30 18:25:08 +00005034 trans_name = save_function_name(&name, &is_global, FALSE,
5035 TFN_INT | TFN_QUIET | TFN_NO_AUTOLOAD | TFN_NO_DEREF, NULL);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005036 if (*name != NUL)
5037 s = NULL;
5038 }
5039
Bram Moolenaar843b8842016-08-21 14:36:15 +02005040 if (s == NULL || *s == NUL || (use_string && VIM_ISDIGIT(*s))
5041 || (is_funcref && trans_name == NULL))
Yegappan Lakshmanan655b7342022-03-06 14:27:10 +00005042 semsg(_(e_invalid_argument_str),
5043 use_string ? tv_get_string(&argvars[0]) : s);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005044 // Don't check an autoload name for existence here.
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005045 else if (trans_name != NULL && (is_funcref
Bram Moolenaard9d2fd02022-01-13 21:15:21 +00005046 ? find_func(trans_name, is_global) == NULL
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02005047 : !translated_function_exists(trans_name, is_global)))
Bram Moolenaara6f79292022-01-04 21:30:47 +00005048 semsg(_(e_unknown_function_str_2), s);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005049 else
5050 {
5051 int dict_idx = 0;
5052 int arg_idx = 0;
5053 list_T *list = NULL;
5054
5055 if (STRNCMP(s, "s:", 2) == 0 || STRNCMP(s, "<SID>", 5) == 0)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005056 // Expand s: and <SID> into <SNR>nr_, so that the function can
5057 // also be called from another script. Using trans_function_name()
5058 // would also work, but some plugins depend on the name being
5059 // printable text.
Yegappan Lakshmanane7f4abd2021-12-24 20:47:38 +00005060 name = get_scriptlocal_funcname(s);
Bram Moolenaarc2f17f72022-02-21 13:13:50 +00005061 else if (trans_name != NULL && *trans_name == K_SPECIAL)
5062 name = alloc_printable_func_name(trans_name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005063 else
5064 name = vim_strsave(s);
5065
5066 if (argvars[1].v_type != VAR_UNKNOWN)
5067 {
5068 if (argvars[2].v_type != VAR_UNKNOWN)
5069 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005070 // function(name, [args], dict)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005071 arg_idx = 1;
5072 dict_idx = 2;
5073 }
5074 else if (argvars[1].v_type == VAR_DICT)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005075 // function(name, dict)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005076 dict_idx = 1;
5077 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005078 // function(name, [args])
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005079 arg_idx = 1;
5080 if (dict_idx > 0)
5081 {
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +01005082 if (check_for_dict_arg(argvars, dict_idx) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005083 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005084 vim_free(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005085 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005086 }
5087 if (argvars[dict_idx].vval.v_dict == NULL)
5088 dict_idx = 0;
5089 }
5090 if (arg_idx > 0)
5091 {
5092 if (argvars[arg_idx].v_type != VAR_LIST)
5093 {
Bram Moolenaard82a47d2022-01-05 20:24:39 +00005094 emsg(_(e_second_argument_of_function_must_be_list_or_dict));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005095 vim_free(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005096 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005097 }
5098 list = argvars[arg_idx].vval.v_list;
5099 if (list == NULL || list->lv_len == 0)
5100 arg_idx = 0;
Bram Moolenaar4c054e92019-11-10 00:13:50 +01005101 else if (list->lv_len > MAX_FUNC_ARGS)
5102 {
Yegappan Lakshmanan5018a832022-04-02 21:12:21 +01005103 emsg_funcname(e_too_many_arguments_for_function_str, s);
Bram Moolenaar4c054e92019-11-10 00:13:50 +01005104 vim_free(name);
5105 goto theend;
5106 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005107 }
5108 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005109 if (dict_idx > 0 || arg_idx > 0 || arg_pt != NULL || is_funcref)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005110 {
Bram Moolenaarc799fe22019-05-28 23:08:19 +02005111 partial_T *pt = ALLOC_CLEAR_ONE(partial_T);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005112
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005113 // result is a VAR_PARTIAL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005114 if (pt == NULL)
5115 vim_free(name);
5116 else
5117 {
5118 if (arg_idx > 0 || (arg_pt != NULL && arg_pt->pt_argc > 0))
5119 {
5120 listitem_T *li;
5121 int i = 0;
5122 int arg_len = 0;
5123 int lv_len = 0;
5124
5125 if (arg_pt != NULL)
5126 arg_len = arg_pt->pt_argc;
5127 if (list != NULL)
5128 lv_len = list->lv_len;
5129 pt->pt_argc = arg_len + lv_len;
Bram Moolenaarc799fe22019-05-28 23:08:19 +02005130 pt->pt_argv = ALLOC_MULT(typval_T, pt->pt_argc);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005131 if (pt->pt_argv == NULL)
5132 {
5133 vim_free(pt);
5134 vim_free(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005135 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005136 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005137 for (i = 0; i < arg_len; i++)
5138 copy_tv(&arg_pt->pt_argv[i], &pt->pt_argv[i]);
5139 if (lv_len > 0)
Bram Moolenaar50985eb2020-01-27 22:09:39 +01005140 {
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02005141 CHECK_LIST_MATERIALIZE(list);
Bram Moolenaaraeea7212020-04-02 18:50:46 +02005142 FOR_ALL_LIST_ITEMS(list, li)
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005143 copy_tv(&li->li_tv, &pt->pt_argv[i++]);
Bram Moolenaar50985eb2020-01-27 22:09:39 +01005144 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005145 }
5146
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005147 // For "function(dict.func, [], dict)" and "func" is a partial
5148 // use "dict". That is backwards compatible.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005149 if (dict_idx > 0)
5150 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005151 // The dict is bound explicitly, pt_auto is FALSE.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005152 pt->pt_dict = argvars[dict_idx].vval.v_dict;
5153 ++pt->pt_dict->dv_refcount;
5154 }
5155 else if (arg_pt != NULL)
5156 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005157 // If the dict was bound automatically the result is also
5158 // bound automatically.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005159 pt->pt_dict = arg_pt->pt_dict;
5160 pt->pt_auto = arg_pt->pt_auto;
5161 if (pt->pt_dict != NULL)
5162 ++pt->pt_dict->dv_refcount;
Yegappan Lakshmanan29bb67f2023-10-14 11:18:50 +02005163 pt->pt_obj = arg_pt->pt_obj;
5164 if (pt->pt_obj != NULL)
5165 ++pt->pt_obj->obj_refcount;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005166 }
5167
5168 pt->pt_refcount = 1;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005169 if (arg_pt != NULL && arg_pt->pt_func != NULL)
5170 {
5171 pt->pt_func = arg_pt->pt_func;
5172 func_ptr_ref(pt->pt_func);
5173 vim_free(name);
5174 }
5175 else if (is_funcref)
5176 {
Bram Moolenaard9d2fd02022-01-13 21:15:21 +00005177 pt->pt_func = find_func(trans_name, is_global);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005178 func_ptr_ref(pt->pt_func);
5179 vim_free(name);
5180 }
5181 else
5182 {
5183 pt->pt_name = name;
5184 func_ref(name);
5185 }
Bram Moolenaar92368aa2022-02-07 17:50:39 +00005186
5187 if (arg_pt != NULL)
Bram Moolenaar7aca5ca2022-02-07 19:56:43 +00005188 {
5189 pt->pt_outer_partial = arg_pt;
5190 ++arg_pt->pt_refcount;
5191 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005192 }
5193 rettv->v_type = VAR_PARTIAL;
5194 rettv->vval.v_partial = pt;
5195 }
5196 else
5197 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005198 // result is a VAR_FUNC
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005199 rettv->v_type = VAR_FUNC;
5200 rettv->vval.v_string = name;
5201 func_ref(name);
5202 }
5203 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005204theend:
5205 vim_free(trans_name);
5206}
5207
5208/*
5209 * "funcref()" function
5210 */
5211 static void
5212f_funcref(typval_T *argvars, typval_T *rettv)
5213{
5214 common_function(argvars, rettv, TRUE);
5215}
5216
5217/*
5218 * "function()" function
5219 */
5220 static void
5221f_function(typval_T *argvars, typval_T *rettv)
5222{
5223 common_function(argvars, rettv, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005224}
5225
5226/*
5227 * "garbagecollect()" function
5228 */
5229 static void
5230f_garbagecollect(typval_T *argvars, typval_T *rettv UNUSED)
5231{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005232 if (in_vim9script() && check_for_opt_bool_arg(argvars, 0) == FAIL)
5233 return;
5234
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005235 // This is postponed until we are back at the toplevel, because we may be
5236 // using Lists and Dicts internally. E.g.: ":echo [garbagecollect()]".
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005237 want_garbage_collect = TRUE;
5238
Bram Moolenaar2df47312020-09-05 17:30:44 +02005239 if (argvars[0].v_type != VAR_UNKNOWN && tv_get_bool(&argvars[0]) == 1)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005240 garbage_collect_at_exit = TRUE;
5241}
5242
5243/*
5244 * "get()" function
5245 */
5246 static void
5247f_get(typval_T *argvars, typval_T *rettv)
5248{
5249 listitem_T *li;
5250 list_T *l;
5251 dictitem_T *di;
5252 dict_T *d;
5253 typval_T *tv = NULL;
Bram Moolenaarf91aac52019-07-28 13:21:01 +02005254 int what_is_dict = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005255
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005256 if (argvars[0].v_type == VAR_BLOB)
5257 {
5258 int error = FALSE;
5259 int idx = tv_get_number_chk(&argvars[1], &error);
5260
5261 if (!error)
5262 {
5263 rettv->v_type = VAR_NUMBER;
Bram Moolenaar2ea773b2019-01-15 22:16:42 +01005264 if (idx < 0)
5265 idx = blob_len(argvars[0].vval.v_blob) + idx;
5266 if (idx < 0 || idx >= blob_len(argvars[0].vval.v_blob))
5267 rettv->vval.v_number = -1;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005268 else
Bram Moolenaar2ea773b2019-01-15 22:16:42 +01005269 {
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005270 rettv->vval.v_number = blob_get(argvars[0].vval.v_blob, idx);
Bram Moolenaar2ea773b2019-01-15 22:16:42 +01005271 tv = rettv;
5272 }
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005273 }
5274 }
5275 else if (argvars[0].v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005276 {
5277 if ((l = argvars[0].vval.v_list) != NULL)
5278 {
5279 int error = FALSE;
5280
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005281 li = list_find(l, (long)tv_get_number_chk(&argvars[1], &error));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005282 if (!error && li != NULL)
5283 tv = &li->li_tv;
5284 }
5285 }
5286 else if (argvars[0].v_type == VAR_DICT)
5287 {
5288 if ((d = argvars[0].vval.v_dict) != NULL)
5289 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005290 di = dict_find(d, tv_get_string(&argvars[1]), -1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005291 if (di != NULL)
5292 tv = &di->di_tv;
5293 }
5294 }
5295 else if (argvars[0].v_type == VAR_PARTIAL || argvars[0].v_type == VAR_FUNC)
5296 {
5297 partial_T *pt;
5298 partial_T fref_pt;
5299
5300 if (argvars[0].v_type == VAR_PARTIAL)
5301 pt = argvars[0].vval.v_partial;
5302 else
5303 {
Bram Moolenaara80faa82020-04-12 19:37:17 +02005304 CLEAR_FIELD(fref_pt);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005305 fref_pt.pt_name = argvars[0].vval.v_string;
5306 pt = &fref_pt;
5307 }
5308
5309 if (pt != NULL)
5310 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005311 char_u *what = tv_get_string(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005312
5313 if (STRCMP(what, "func") == 0 || STRCMP(what, "name") == 0)
5314 {
Bram Moolenaar1ae8c262022-06-27 11:45:52 +01005315 char_u *name = partial_name(pt);
5316
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005317 rettv->v_type = (*what == 'f' ? VAR_FUNC : VAR_STRING);
Bram Moolenaar1ae8c262022-06-27 11:45:52 +01005318 if (name == NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005319 rettv->vval.v_string = NULL;
5320 else
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005321 {
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005322 if (rettv->v_type == VAR_FUNC)
Bram Moolenaar1ae8c262022-06-27 11:45:52 +01005323 func_ref(name);
5324 if (*what == 'n' && pt->pt_name == NULL
5325 && pt->pt_func != NULL)
5326 // use <SNR> instead of the byte code
5327 name = printable_func_name(pt->pt_func);
5328 rettv->vval.v_string = vim_strsave(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005329 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005330 }
5331 else if (STRCMP(what, "dict") == 0)
Bram Moolenaarf91aac52019-07-28 13:21:01 +02005332 {
5333 what_is_dict = TRUE;
5334 if (pt->pt_dict != NULL)
5335 rettv_dict_set(rettv, pt->pt_dict);
5336 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005337 else if (STRCMP(what, "args") == 0)
5338 {
5339 rettv->v_type = VAR_LIST;
5340 if (rettv_list_alloc(rettv) == OK)
5341 {
5342 int i;
5343
5344 for (i = 0; i < pt->pt_argc; ++i)
5345 list_append_tv(rettv->vval.v_list, &pt->pt_argv[i]);
5346 }
5347 }
LemonBoy48b7d052024-07-09 18:24:59 +02005348 else if (STRCMP(what, "arity") == 0)
5349 {
5350 int required = 0, optional = 0, varargs = FALSE;
5351 char_u *name = partial_name(pt);
5352
5353 get_func_arity(name, &required, &optional, &varargs);
5354
5355 rettv->v_type = VAR_DICT;
5356 if (rettv_dict_alloc(rettv) == OK)
5357 {
5358 dict_T *dict = rettv->vval.v_dict;
5359
5360 // Take into account the arguments of the partial, if any.
5361 // Note that it is possible to supply more arguments than the function
5362 // accepts.
5363 if (pt->pt_argc >= required + optional)
5364 required = optional = 0;
5365 else if (pt->pt_argc > required)
5366 {
5367 optional -= pt->pt_argc - required;
5368 required = 0;
5369 }
5370 else
5371 required -= pt->pt_argc;
5372
5373 dict_add_number(dict, "required", required);
5374 dict_add_number(dict, "optional", optional);
5375 dict_add_bool(dict, "varargs", varargs);
5376 }
5377 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005378 else
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00005379 semsg(_(e_invalid_argument_str), what);
Bram Moolenaarf91aac52019-07-28 13:21:01 +02005380
5381 // When {what} == "dict" and pt->pt_dict == NULL, evaluate the
5382 // third argument
5383 if (!what_is_dict)
5384 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005385 }
5386 }
5387 else
Bram Moolenaar460ae5d2022-01-01 14:19:49 +00005388 semsg(_(e_argument_of_str_must_be_list_dictionary_or_blob), "get()");
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005389
5390 if (tv == NULL)
5391 {
5392 if (argvars[2].v_type != VAR_UNKNOWN)
5393 copy_tv(&argvars[2], rettv);
5394 }
5395 else
5396 copy_tv(tv, rettv);
5397}
5398
Bram Moolenaarb5ae48e2016-08-12 22:23:25 +02005399/*
mikoto2000a73dfc22024-11-18 21:12:21 +01005400 * "getcellpixels()" function
5401 */
5402 static void
5403f_getcellpixels(typval_T *argvars UNUSED, typval_T *rettv)
5404{
5405 if (rettv_list_alloc(rettv) == FAIL)
5406 return;
5407
5408#if defined(FEAT_GUI)
5409 if (gui.in_use)
5410 {
5411 // success pixel size and no gui.
5412 list_append_number(rettv->vval.v_list, (varnumber_T)gui.char_width);
5413 list_append_number(rettv->vval.v_list, (varnumber_T)gui.char_height);
5414 }
5415 else
5416#endif
5417 {
5418 struct cellsize cs;
5419#if defined(UNIX)
5420 mch_calc_cell_size(&cs);
5421#else
5422 // Non-Unix CUIs are not supported, so set this to -1x-1.
5423 cs.cs_xpixel = -1;
5424 cs.cs_ypixel = -1;
5425#endif
5426
5427 // failed get pixel size.
5428 if (cs.cs_xpixel == -1)
5429 return;
5430
5431 // success pixel size and no gui.
5432 list_append_number(rettv->vval.v_list, (varnumber_T)cs.cs_xpixel);
5433 list_append_number(rettv->vval.v_list, (varnumber_T)cs.cs_ypixel);
5434 }
5435
5436}
5437
5438/*
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005439 * "getchangelist()" function
5440 */
5441 static void
5442f_getchangelist(typval_T *argvars, typval_T *rettv)
5443{
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005444 buf_T *buf;
5445 int i;
5446 list_T *l;
5447 dict_T *d;
LemonBoydb0ea7f2022-04-10 17:59:26 +01005448 int changelistindex;
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005449
Bram Moolenaar93a10962022-06-16 11:42:09 +01005450 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005451 return;
5452
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005453 if (in_vim9script() && check_for_opt_buffer_arg(argvars, 0) == FAIL)
5454 return;
5455
Bram Moolenaar4c313b12019-08-24 22:58:31 +02005456 if (argvars[0].v_type == VAR_UNKNOWN)
5457 buf = curbuf;
5458 else
Bram Moolenaara5d38412020-09-02 21:02:35 +02005459 buf = tv_get_buf_from_arg(&argvars[0]);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005460 if (buf == NULL)
5461 return;
5462
5463 l = list_alloc();
5464 if (l == NULL)
5465 return;
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005466 if (list_append_list(rettv->vval.v_list, l) == FAIL)
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005467 {
5468 vim_free(l);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005469 return;
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005470 }
5471
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005472 /*
LemonBoydb0ea7f2022-04-10 17:59:26 +01005473 * The current window change list index tracks only the position for the
5474 * current buffer. For other buffers use the stored index for the current
5475 * window, or, if that's not available, the change list length.
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005476 */
LemonBoydb0ea7f2022-04-10 17:59:26 +01005477 if (buf == curwin->w_buffer)
5478 {
5479 changelistindex = curwin->w_changelistidx;
5480 }
5481 else
5482 {
5483 wininfo_T *wip;
5484
5485 FOR_ALL_BUF_WININFO(buf, wip)
5486 if (wip->wi_win == curwin)
5487 break;
5488 changelistindex = wip != NULL ? wip->wi_changelistidx
5489 : buf->b_changelistlen;
5490 }
5491 list_append_number(rettv->vval.v_list, (varnumber_T)changelistindex);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005492
5493 for (i = 0; i < buf->b_changelistlen; ++i)
5494 {
5495 if (buf->b_changelist[i].lnum == 0)
5496 continue;
5497 if ((d = dict_alloc()) == NULL)
5498 return;
5499 if (list_append_dict(l, d) == FAIL)
5500 return;
Bram Moolenaare0be1672018-07-08 16:50:37 +02005501 dict_add_number(d, "lnum", (long)buf->b_changelist[i].lnum);
5502 dict_add_number(d, "col", (long)buf->b_changelist[i].col);
Bram Moolenaare0be1672018-07-08 16:50:37 +02005503 dict_add_number(d, "coladd", (long)buf->b_changelist[i].coladd);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005504 }
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005505}
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005506
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005507 static void
5508getpos_both(
5509 typval_T *argvars,
5510 typval_T *rettv,
5511 int getcurpos,
5512 int charcol)
5513{
5514 pos_T *fp = NULL;
5515 pos_T pos;
5516 win_T *wp = curwin;
5517 list_T *l;
5518 int fnum = -1;
5519
5520 if (rettv_list_alloc(rettv) == OK)
5521 {
5522 l = rettv->vval.v_list;
5523 if (getcurpos)
5524 {
5525 if (argvars[0].v_type != VAR_UNKNOWN)
5526 {
5527 wp = find_win_by_nr_or_id(&argvars[0]);
5528 if (wp != NULL)
5529 fp = &wp->w_cursor;
5530 }
5531 else
5532 fp = &curwin->w_cursor;
5533 if (fp != NULL && charcol)
5534 {
5535 pos = *fp;
Bram Moolenaar91458462021-01-13 20:08:38 +01005536 pos.col =
5537 buf_byteidx_to_charidx(wp->w_buffer, pos.lnum, pos.col);
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005538 fp = &pos;
5539 }
5540 }
5541 else
5542 fp = var2fpos(&argvars[0], TRUE, &fnum, charcol);
5543 if (fnum != -1)
5544 list_append_number(l, (varnumber_T)fnum);
5545 else
5546 list_append_number(l, (varnumber_T)0);
5547 list_append_number(l, (fp != NULL) ? (varnumber_T)fp->lnum
5548 : (varnumber_T)0);
5549 list_append_number(l, (fp != NULL)
5550 ? (varnumber_T)(fp->col == MAXCOL ? MAXCOL : fp->col + 1)
5551 : (varnumber_T)0);
5552 list_append_number(l, (fp != NULL) ? (varnumber_T)fp->coladd :
5553 (varnumber_T)0);
5554 if (getcurpos)
5555 {
5556 int save_set_curswant = curwin->w_set_curswant;
5557 colnr_T save_curswant = curwin->w_curswant;
5558 colnr_T save_virtcol = curwin->w_virtcol;
5559
5560 if (wp == curwin)
5561 update_curswant();
5562 list_append_number(l, wp == NULL ? 0 : wp->w_curswant == MAXCOL
5563 ? (varnumber_T)MAXCOL : (varnumber_T)wp->w_curswant + 1);
5564
5565 // Do not change "curswant", as it is unexpected that a get
5566 // function has a side effect.
5567 if (wp == curwin && save_set_curswant)
5568 {
5569 curwin->w_set_curswant = save_set_curswant;
5570 curwin->w_curswant = save_curswant;
5571 curwin->w_virtcol = save_virtcol;
5572 curwin->w_valid &= ~VALID_VIRTCOL;
5573 }
5574 }
5575 }
5576 else
5577 rettv->vval.v_number = FALSE;
5578}
5579
5580/*
5581 * "getcharpos()" function
5582 */
5583 static void
5584f_getcharpos(typval_T *argvars UNUSED, typval_T *rettv)
5585{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005586 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5587 return;
5588
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005589 getpos_both(argvars, rettv, FALSE, TRUE);
5590}
5591
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005592/*
5593 * "getcharsearch()" function
5594 */
5595 static void
5596f_getcharsearch(typval_T *argvars UNUSED, typval_T *rettv)
5597{
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00005598 if (rettv_dict_alloc(rettv) != OK)
5599 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005600
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00005601 dict_T *dict = rettv->vval.v_dict;
5602
5603 dict_add_string(dict, "char", last_csearch());
5604 dict_add_number(dict, "forward", last_csearch_forward());
5605 dict_add_number(dict, "until", last_csearch_until());
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005606}
5607
5608/*
Bram Moolenaar691ddee2019-05-09 14:52:41 +02005609 * "getenv()" function
5610 */
5611 static void
5612f_getenv(typval_T *argvars, typval_T *rettv)
5613{
5614 int mustfree = FALSE;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005615 char_u *p;
Bram Moolenaar691ddee2019-05-09 14:52:41 +02005616
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005617 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5618 return;
5619
5620 p = vim_getenv(tv_get_string(&argvars[0]), &mustfree);
Bram Moolenaar691ddee2019-05-09 14:52:41 +02005621 if (p == NULL)
5622 {
5623 rettv->v_type = VAR_SPECIAL;
5624 rettv->vval.v_number = VVAL_NULL;
5625 return;
5626 }
5627 if (!mustfree)
5628 p = vim_strsave(p);
5629 rettv->vval.v_string = p;
5630 rettv->v_type = VAR_STRING;
5631}
5632
5633/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005634 * "getfontname()" function
5635 */
5636 static void
5637f_getfontname(typval_T *argvars UNUSED, typval_T *rettv)
5638{
5639 rettv->v_type = VAR_STRING;
5640 rettv->vval.v_string = NULL;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005641
5642 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
5643 return;
5644
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005645#ifdef FEAT_GUI
5646 if (gui.in_use)
5647 {
5648 GuiFont font;
5649 char_u *name = NULL;
5650
5651 if (argvars[0].v_type == VAR_UNKNOWN)
5652 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005653 // Get the "Normal" font. Either the name saved by
5654 // hl_set_font_name() or from the font ID.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005655 font = gui.norm_font;
5656 name = hl_get_font_name();
5657 }
5658 else
5659 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005660 name = tv_get_string(&argvars[0]);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005661 if (STRCMP(name, "*") == 0) // don't use font dialog
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005662 return;
5663 font = gui_mch_get_font(name, FALSE);
5664 if (font == NOFONT)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005665 return; // Invalid font name, return empty string.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005666 }
5667 rettv->vval.v_string = gui_mch_get_fontname(font, name);
5668 if (argvars[0].v_type != VAR_UNKNOWN)
5669 gui_mch_free_font(font);
5670 }
5671#endif
5672}
5673
5674/*
Bram Moolenaar4f505882018-02-10 21:06:32 +01005675 * "getjumplist()" function
5676 */
5677 static void
5678f_getjumplist(typval_T *argvars, typval_T *rettv)
5679{
Bram Moolenaar4f505882018-02-10 21:06:32 +01005680 win_T *wp;
5681 int i;
5682 list_T *l;
5683 dict_T *d;
Bram Moolenaar4f505882018-02-10 21:06:32 +01005684
Bram Moolenaar93a10962022-06-16 11:42:09 +01005685 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar4f505882018-02-10 21:06:32 +01005686 return;
5687
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005688 if (in_vim9script()
5689 && (check_for_opt_number_arg(argvars, 0) == FAIL
5690 || (argvars[0].v_type != VAR_UNKNOWN
5691 && check_for_opt_number_arg(argvars, 1) == FAIL)))
5692 return;
5693
Bram Moolenaar00aa0692019-04-27 20:37:57 +02005694 wp = find_tabwin(&argvars[0], &argvars[1], NULL);
Bram Moolenaar4f505882018-02-10 21:06:32 +01005695 if (wp == NULL)
5696 return;
5697
Bram Moolenaar57ee2b62019-02-12 22:15:06 +01005698 cleanup_jumplist(wp, TRUE);
5699
Bram Moolenaar4f505882018-02-10 21:06:32 +01005700 l = list_alloc();
5701 if (l == NULL)
5702 return;
Bram Moolenaar4f505882018-02-10 21:06:32 +01005703 if (list_append_list(rettv->vval.v_list, l) == FAIL)
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005704 {
5705 vim_free(l);
Bram Moolenaar4f505882018-02-10 21:06:32 +01005706 return;
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005707 }
5708
Bram Moolenaar4f505882018-02-10 21:06:32 +01005709 list_append_number(rettv->vval.v_list, (varnumber_T)wp->w_jumplistidx);
5710
5711 for (i = 0; i < wp->w_jumplistlen; ++i)
5712 {
Bram Moolenaara7e18d22018-02-11 14:29:49 +01005713 if (wp->w_jumplist[i].fmark.mark.lnum == 0)
5714 continue;
Bram Moolenaar4f505882018-02-10 21:06:32 +01005715 if ((d = dict_alloc()) == NULL)
5716 return;
5717 if (list_append_dict(l, d) == FAIL)
5718 return;
Bram Moolenaare0be1672018-07-08 16:50:37 +02005719 dict_add_number(d, "lnum", (long)wp->w_jumplist[i].fmark.mark.lnum);
5720 dict_add_number(d, "col", (long)wp->w_jumplist[i].fmark.mark.col);
Bram Moolenaare0be1672018-07-08 16:50:37 +02005721 dict_add_number(d, "coladd", (long)wp->w_jumplist[i].fmark.mark.coladd);
Bram Moolenaare0be1672018-07-08 16:50:37 +02005722 dict_add_number(d, "bufnr", (long)wp->w_jumplist[i].fmark.fnum);
Bram Moolenaara7e18d22018-02-11 14:29:49 +01005723 if (wp->w_jumplist[i].fname != NULL)
Bram Moolenaare0be1672018-07-08 16:50:37 +02005724 dict_add_string(d, "filename", wp->w_jumplist[i].fname);
Bram Moolenaar4f505882018-02-10 21:06:32 +01005725 }
Bram Moolenaar4f505882018-02-10 21:06:32 +01005726}
5727
5728/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005729 * "getpid()" function
5730 */
5731 static void
5732f_getpid(typval_T *argvars UNUSED, typval_T *rettv)
5733{
5734 rettv->vval.v_number = mch_get_pid();
5735}
5736
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005737/*
5738 * "getcurpos()" function
5739 */
5740 static void
5741f_getcurpos(typval_T *argvars, typval_T *rettv)
5742{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005743 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
5744 return;
5745
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005746 getpos_both(argvars, rettv, TRUE, FALSE);
5747}
5748
5749 static void
5750f_getcursorcharpos(typval_T *argvars, typval_T *rettv)
5751{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005752 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
5753 return;
5754
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005755 getpos_both(argvars, rettv, TRUE, TRUE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005756}
5757
5758/*
5759 * "getpos(string)" function
5760 */
5761 static void
5762f_getpos(typval_T *argvars, typval_T *rettv)
5763{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005764 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5765 return;
5766
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005767 getpos_both(argvars, rettv, FALSE, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005768}
5769
5770/*
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005771 * Convert from block_def to string
5772 */
Gary Johnson88d4f252024-06-01 20:51:33 +02005773 static char_u *
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005774block_def2str(struct block_def *bd)
5775{
5776 char_u *p, *ret;
5777 size_t size = bd->startspaces + bd->endspaces + bd->textlen;
5778
5779 ret = alloc(size + 1);
5780 if (ret != NULL)
5781 {
5782 p = ret;
5783 vim_memset(p, ' ', bd->startspaces);
5784 p += bd->startspaces;
5785 mch_memmove(p, bd->textstart, bd->textlen);
5786 p += bd->textlen;
5787 vim_memset(p, ' ', bd->endspaces);
5788 *(p + bd->endspaces) = NUL;
5789 }
5790 return ret;
5791}
5792
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005793 static int
5794getregionpos(
5795 typval_T *argvars,
5796 typval_T *rettv,
zeertzjqc95e64f2024-05-20 14:00:31 +02005797 pos_T *p1,
5798 pos_T *p2,
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005799 int *inclusive,
5800 int *region_type,
zeertzjqafc22952024-05-24 19:07:12 +02005801 oparg_T *oap)
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005802{
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005803 int fnum1 = -1, fnum2 = -1;
5804 char_u *type;
5805 buf_T *findbuf;
5806 char_u default_type[] = "v";
zeertzjqafc22952024-05-24 19:07:12 +02005807 int block_width = 0;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005808 int is_select_exclusive;
5809 int l;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005810
5811 if (rettv_list_alloc(rettv) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005812 return FAIL;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005813
Shougo Matsushita19b71882024-02-28 22:48:12 +01005814 if (check_for_list_arg(argvars, 0) == FAIL
5815 || check_for_list_arg(argvars, 1) == FAIL
5816 || check_for_opt_dict_arg(argvars, 2) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005817 return FAIL;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005818
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005819 if (list2fpos(&argvars[0], p1, &fnum1, NULL, FALSE) != OK
5820 || list2fpos(&argvars[1], p2, &fnum2, NULL, FALSE) != OK
Shougo Matsushita84bf6e62024-03-06 21:10:18 +01005821 || fnum1 != fnum2)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005822 return FAIL;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005823
Shougo Matsushita19b71882024-02-28 22:48:12 +01005824 if (argvars[2].v_type == VAR_DICT)
5825 {
5826 is_select_exclusive = dict_get_bool(
5827 argvars[2].vval.v_dict, "exclusive", *p_sel == 'e');
5828 type = dict_get_string(
5829 argvars[2].vval.v_dict, "type", FALSE);
5830 if (type == NULL)
5831 type = default_type;
5832 }
5833 else
5834 {
5835 is_select_exclusive = *p_sel == 'e';
5836 type = default_type;
5837 }
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005838
5839 if (type[0] == 'v' && type[1] == NUL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005840 *region_type = MCHAR;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005841 else if (type[0] == 'V' && type[1] == NUL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005842 *region_type = MLINE;
zeertzjqafc22952024-05-24 19:07:12 +02005843 else if (type[0] == Ctrl_V)
5844 {
5845 char_u *p = type + 1;
5846
5847 if (*p != NUL && ((block_width = getdigits(&p)) <= 0 || *p != NUL))
5848 {
5849 semsg(_(e_invalid_value_for_argument_str_str), "type", type);
5850 return FAIL;
5851 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005852 *region_type = MBLOCK;
zeertzjqafc22952024-05-24 19:07:12 +02005853 }
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005854 else
zeertzjq26dd09a2024-03-10 15:46:58 +01005855 {
5856 semsg(_(e_invalid_value_for_argument_str_str), "type", type);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005857 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01005858 }
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005859
zeertzjq5406eb82024-03-11 21:36:42 +01005860 findbuf = fnum1 != 0 ? buflist_findnr(fnum1) : curbuf;
5861 if (findbuf == NULL || findbuf->b_ml.ml_mfp == NULL)
Shougo Matsushita84bf6e62024-03-06 21:10:18 +01005862 {
zeertzjq5406eb82024-03-11 21:36:42 +01005863 emsg(_(e_buffer_is_not_loaded));
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005864 return FAIL;
Shougo Matsushita84bf6e62024-03-06 21:10:18 +01005865 }
5866
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005867 if (p1->lnum < 1 || p1->lnum > findbuf->b_ml.ml_line_count)
zeertzjq26dd09a2024-03-10 15:46:58 +01005868 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005869 semsg(_(e_invalid_line_number_nr), p1->lnum);
5870 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01005871 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005872 if (p1->col == MAXCOL)
5873 p1->col = ml_get_buf_len(findbuf, p1->lnum) + 1;
5874 else if (p1->col < 1 || p1->col > ml_get_buf_len(findbuf, p1->lnum) + 1)
zeertzjq26dd09a2024-03-10 15:46:58 +01005875 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005876 semsg(_(e_invalid_column_number_nr), p1->col);
5877 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01005878 }
zeertzjq2ffdae72024-05-02 13:06:24 +02005879
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005880 if (p2->lnum < 1 || p2->lnum > findbuf->b_ml.ml_line_count)
zeertzjq26dd09a2024-03-10 15:46:58 +01005881 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005882 semsg(_(e_invalid_line_number_nr), p2->lnum);
5883 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01005884 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005885 if (p2->col == MAXCOL)
5886 p2->col = ml_get_buf_len(findbuf, p2->lnum) + 1;
5887 else if (p2->col < 1 || p2->col > ml_get_buf_len(findbuf, p2->lnum) + 1)
zeertzjq26dd09a2024-03-10 15:46:58 +01005888 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005889 semsg(_(e_invalid_column_number_nr), p2->col);
5890 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01005891 }
5892
5893 curbuf = findbuf;
zeertzjq5406eb82024-03-11 21:36:42 +01005894 curwin->w_buffer = curbuf;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005895 virtual_op = virtual_active();
5896
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005897 // NOTE: Adjustment is needed.
5898 p1->col--;
5899 p2->col--;
Shougo Matsushita19b71882024-02-28 22:48:12 +01005900
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005901 if (!LT_POS(*p1, *p2))
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005902 {
5903 // swap position
5904 pos_T p;
5905
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005906 p = *p1;
5907 *p1 = *p2;
5908 *p2 = p;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005909 }
5910
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005911 if (*region_type == MCHAR)
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005912 {
zeertzjq701ad502024-05-23 07:47:55 +02005913 // Handle 'selection' == "exclusive".
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005914 if (is_select_exclusive && !EQUAL_POS(*p1, *p2))
zeertzjq701ad502024-05-23 07:47:55 +02005915 // When backing up to previous line, inclusive becomes false.
5916 *inclusive = !unadjust_for_sel_inner(p2);
5917 // If p2 is on NUL (end of line), inclusive becomes false.
5918 if (*inclusive && !virtual_op && *ml_get_pos(p2) == NUL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005919 *inclusive = FALSE;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005920 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005921 else if (*region_type == MBLOCK)
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005922 {
5923 colnr_T sc1, ec1, sc2, ec2;
5924
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005925 getvvcol(curwin, p1, &sc1, NULL, &ec1);
5926 getvvcol(curwin, p2, &sc2, NULL, &ec2);
zeertzjqafc22952024-05-24 19:07:12 +02005927 oap->motion_type = MBLOCK;
5928 oap->inclusive = TRUE;
5929 oap->op_type = OP_NOP;
5930 oap->start = *p1;
5931 oap->end = *p2;
5932 oap->start_vcol = MIN(sc1, sc2);
5933 if (block_width > 0)
5934 oap->end_vcol = oap->start_vcol + block_width - 1;
5935 else if (is_select_exclusive && ec1 < sc2 && 0 < sc2 && ec2 > ec1)
5936 oap->end_vcol = sc2 - 1;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005937 else
zeertzjqafc22952024-05-24 19:07:12 +02005938 oap->end_vcol = MAX(ec1, ec2);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005939 }
5940
5941 // Include the trailing byte of a multi-byte char.
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005942 l = mb_ptr2len((char_u *)ml_get_pos(p2));
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005943 if (l > 1)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005944 p2->col += l - 1;
5945
5946 return OK;
5947}
5948
5949/*
5950 * "getregion()" function
5951 */
5952 static void
5953f_getregion(typval_T *argvars, typval_T *rettv)
5954{
5955 pos_T p1, p2;
5956 int inclusive = TRUE;
5957 int region_type = -1;
5958 oparg_T oa;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005959
5960 buf_T *save_curbuf;
5961 int save_virtual;
5962 char_u *akt = NULL;
5963 linenr_T lnum;
5964
5965 save_curbuf = curbuf;
5966 save_virtual = virtual_op;
5967
5968 if (getregionpos(argvars, rettv,
zeertzjqc95e64f2024-05-20 14:00:31 +02005969 &p1, &p2, &inclusive, &region_type, &oa) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005970 return;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005971
5972 for (lnum = p1.lnum; lnum <= p2.lnum; lnum++)
5973 {
5974 int ret = 0;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005975 struct block_def bd;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005976
5977 if (region_type == MLINE)
5978 akt = vim_strsave(ml_get(lnum));
5979 else if (region_type == MBLOCK)
5980 {
zeertzjq5e3674b2024-02-22 19:51:34 +01005981 block_prep(&oa, &bd, lnum, FALSE);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005982 akt = block_def2str(&bd);
5983 }
5984 else if (p1.lnum < lnum && lnum < p2.lnum)
5985 akt = vim_strsave(ml_get(lnum));
5986 else
5987 {
5988 charwise_block_prep(p1, p2, &bd, lnum, inclusive);
5989 akt = block_def2str(&bd);
5990 }
5991
5992 if (akt)
5993 {
5994 ret = list_append_string(rettv->vval.v_list, akt, -1);
5995 vim_free(akt);
5996 }
5997
5998 if (akt == NULL || ret == FAIL)
5999 {
zeertzjq5e3674b2024-02-22 19:51:34 +01006000 clear_tv(rettv);
6001 (void)rettv_list_alloc(rettv);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006002 break;
6003 }
6004 }
6005
zeertzjqc95e64f2024-05-20 14:00:31 +02006006 // getregionpos() may change curbuf and virtual_op
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006007 curbuf = save_curbuf;
6008 curwin->w_buffer = curbuf;
6009 virtual_op = save_virtual;
6010}
6011
6012 static void
zeertzjqc95e64f2024-05-20 14:00:31 +02006013add_regionpos_range(typval_T *rettv, pos_T p1, pos_T p2)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006014{
6015 list_T *l1, *l2, *l3;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006016
6017 l1 = list_alloc();
6018 if (l1 == NULL)
6019 return;
6020
6021 if (list_append_list(rettv->vval.v_list, l1) == FAIL)
6022 {
6023 vim_free(l1);
6024 return;
6025 }
6026
6027 l2 = list_alloc();
6028 if (l2 == NULL)
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006029 {
6030 vim_free(l1);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006031 return;
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006032 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006033
6034 if (list_append_list(l1, l2) == FAIL)
6035 {
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006036 vim_free(l1);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006037 vim_free(l2);
6038 return;
6039 }
6040
6041 l3 = list_alloc();
6042 if (l3 == NULL)
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006043 {
6044 vim_free(l1);
6045 vim_free(l2);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006046 return;
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006047 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006048
6049 if (list_append_list(l1, l3) == FAIL)
6050 {
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006051 vim_free(l1);
6052 vim_free(l2);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006053 vim_free(l3);
6054 return;
6055 }
6056
zeertzjqc95e64f2024-05-20 14:00:31 +02006057 list_append_number(l2, curbuf->b_fnum);
6058 list_append_number(l2, p1.lnum);
zeertzjq2b09de92024-05-24 07:48:51 +02006059 list_append_number(l2, p1.col);
zeertzjqc95e64f2024-05-20 14:00:31 +02006060 list_append_number(l2, p1.coladd);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006061
zeertzjqc95e64f2024-05-20 14:00:31 +02006062 list_append_number(l3, curbuf->b_fnum);
6063 list_append_number(l3, p2.lnum);
zeertzjq2b09de92024-05-24 07:48:51 +02006064 list_append_number(l3, p2.col);
zeertzjqc95e64f2024-05-20 14:00:31 +02006065 list_append_number(l3, p2.coladd);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006066}
6067
6068/*
6069 * "getregionpos()" function
6070 */
6071 static void
6072f_getregionpos(typval_T *argvars, typval_T *rettv)
6073{
6074 pos_T p1, p2;
6075 int inclusive = TRUE;
6076 int region_type = -1;
zeertzjq2b09de92024-05-24 07:48:51 +02006077 int allow_eol = FALSE;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006078 oparg_T oa;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006079 int lnum;
6080
6081 buf_T *save_curbuf;
6082 int save_virtual;
6083
6084 save_curbuf = curbuf;
6085 save_virtual = virtual_op;
6086
6087 if (getregionpos(argvars, rettv,
zeertzjqc95e64f2024-05-20 14:00:31 +02006088 &p1, &p2, &inclusive, &region_type, &oa) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006089 return;
6090
zeertzjq2b09de92024-05-24 07:48:51 +02006091 if (argvars[2].v_type == VAR_DICT)
6092 allow_eol = dict_get_bool(argvars[2].vval.v_dict, "eol", FALSE);
6093
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006094 for (lnum = p1.lnum; lnum <= p2.lnum; lnum++)
6095 {
zeertzjq2b09de92024-05-24 07:48:51 +02006096 pos_T ret_p1, ret_p2;
zeertzjqef733742024-05-26 18:42:18 +02006097 char_u *line = ml_get(lnum);
zeertzjq2b09de92024-05-24 07:48:51 +02006098 colnr_T line_len = ml_get_len(lnum);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006099
6100 if (region_type == MLINE)
6101 {
zeertzjqc95e64f2024-05-20 14:00:31 +02006102 ret_p1.col = 1;
6103 ret_p1.coladd = 0;
6104 ret_p2.col = MAXCOL;
6105 ret_p2.coladd = 0;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006106 }
6107 else
6108 {
zeertzjq52a6f342024-05-22 16:42:44 +02006109 struct block_def bd;
6110
zeertzjqc95e64f2024-05-20 14:00:31 +02006111 if (region_type == MBLOCK)
6112 block_prep(&oa, &bd, lnum, FALSE);
6113 else
6114 charwise_block_prep(p1, p2, &bd, lnum, inclusive);
zeertzjq52a6f342024-05-22 16:42:44 +02006115
6116 if (bd.is_oneChar) // selection entirely inside one char
6117 {
6118 if (region_type == MBLOCK)
6119 {
zeertzjqef733742024-05-26 18:42:18 +02006120 ret_p1.col = mb_prevptr(line, bd.textstart) - line + 1;
zeertzjq52a6f342024-05-22 16:42:44 +02006121 ret_p1.coladd = bd.start_char_vcols
6122 - (bd.start_vcol - oa.start_vcol);
6123 }
6124 else
6125 {
6126 ret_p1.col = p1.col + 1;
6127 ret_p1.coladd = p1.coladd;
6128 }
6129 }
zeertzjq2b09de92024-05-24 07:48:51 +02006130 else if (region_type == MBLOCK && oa.start_vcol > bd.start_vcol)
6131 {
6132 // blockwise selection entirely beyond end of line
6133 ret_p1.col = MAXCOL;
6134 ret_p1.coladd = oa.start_vcol - bd.start_vcol;
6135 bd.is_oneChar = TRUE;
6136 }
zeertzjq52a6f342024-05-22 16:42:44 +02006137 else if (bd.startspaces > 0)
zeertzjqc95e64f2024-05-20 14:00:31 +02006138 {
zeertzjqef733742024-05-26 18:42:18 +02006139 ret_p1.col = mb_prevptr(line, bd.textstart) - line + 1;
zeertzjqc95e64f2024-05-20 14:00:31 +02006140 ret_p1.coladd = bd.start_char_vcols - bd.startspaces;
6141 }
6142 else
6143 {
6144 ret_p1.col = bd.textcol + 1;
6145 ret_p1.coladd = 0;
6146 }
zeertzjq52a6f342024-05-22 16:42:44 +02006147
6148 if (bd.is_oneChar) // selection entirely inside one char
6149 {
6150 ret_p2.col = ret_p1.col;
zeertzjq2b09de92024-05-24 07:48:51 +02006151 ret_p2.coladd = ret_p1.coladd + bd.startspaces + bd.endspaces;
zeertzjq52a6f342024-05-22 16:42:44 +02006152 }
6153 else if (bd.endspaces > 0)
zeertzjqc95e64f2024-05-20 14:00:31 +02006154 {
6155 ret_p2.col = bd.textcol + bd.textlen + 1;
6156 ret_p2.coladd = bd.endspaces;
6157 }
6158 else
6159 {
6160 ret_p2.col = bd.textcol + bd.textlen;
6161 ret_p2.coladd = 0;
6162 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006163 }
6164
zeertzjq2b09de92024-05-24 07:48:51 +02006165 if (!allow_eol && ret_p1.col > line_len)
6166 {
6167 ret_p1.col = 0;
6168 ret_p1.coladd = 0;
6169 }
6170 else if (ret_p1.col > line_len + 1)
6171 ret_p1.col = line_len + 1;
6172
6173 if (!allow_eol && ret_p2.col > line_len)
6174 {
6175 ret_p2.col = ret_p1.col == 0 ? 0 : line_len;
6176 ret_p2.coladd = 0;
6177 }
6178 else if (ret_p2.col > line_len + 1)
6179 ret_p2.col = line_len + 1;
6180
zeertzjqc95e64f2024-05-20 14:00:31 +02006181 ret_p1.lnum = lnum;
6182 ret_p2.lnum = lnum;
6183 add_regionpos_range(rettv, ret_p1, ret_p2);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006184 }
6185
6186 // getregionpos() may change curbuf and virtual_op
zeertzjq5406eb82024-03-11 21:36:42 +01006187 curbuf = save_curbuf;
6188 curwin->w_buffer = curbuf;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006189 virtual_op = save_virtual;
6190}
6191
6192/*
zeertzjqd3f00f52021-12-24 12:02:43 +00006193 * Common between getreg(), getreginfo() and getregtype(): get the register
6194 * name from the first argument.
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006195 * Returns zero on error.
6196 */
6197 static int
6198getreg_get_regname(typval_T *argvars)
6199{
6200 char_u *strregname;
6201
6202 if (argvars[0].v_type != VAR_UNKNOWN)
6203 {
6204 strregname = tv_get_string_chk(&argvars[0]);
6205 if (strregname != NULL && in_vim9script() && STRLEN(strregname) > 1)
6206 {
6207 semsg(_(e_register_name_must_be_one_char_str), strregname);
6208 strregname = NULL;
6209 }
6210 if (strregname == NULL) // type error; errmsg already given
6211 return 0;
6212 }
6213 else
6214 // Default to v:register
6215 strregname = get_vim_var_str(VV_REG);
6216
6217 return *strregname == 0 ? '"' : *strregname;
6218}
6219
6220/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006221 * "getreg()" function
6222 */
6223 static void
6224f_getreg(typval_T *argvars, typval_T *rettv)
6225{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006226 int regname;
6227 int arg2 = FALSE;
6228 int return_list = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006229
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02006230 if (in_vim9script()
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006231 && (check_for_opt_string_arg(argvars, 0) == FAIL
6232 || (argvars[0].v_type != VAR_UNKNOWN
6233 && (check_for_opt_bool_arg(argvars, 1) == FAIL
6234 || (argvars[1].v_type != VAR_UNKNOWN
6235 && check_for_opt_bool_arg(argvars, 2) == FAIL)))))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02006236 return;
6237
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006238 regname = getreg_get_regname(argvars);
6239 if (regname == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006240 return;
6241
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006242 if (argvars[0].v_type != VAR_UNKNOWN && argvars[1].v_type != VAR_UNKNOWN)
6243 {
6244 int error = FALSE;
6245
6246 arg2 = (int)tv_get_bool_chk(&argvars[1], &error);
6247
6248 if (!error && argvars[2].v_type != VAR_UNKNOWN)
6249 return_list = (int)tv_get_bool_chk(&argvars[2], &error);
6250 if (error)
6251 return;
6252 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006253
6254 if (return_list)
6255 {
6256 rettv->v_type = VAR_LIST;
6257 rettv->vval.v_list = (list_T *)get_reg_contents(regname,
6258 (arg2 ? GREG_EXPR_SRC : 0) | GREG_LIST);
6259 if (rettv->vval.v_list == NULL)
6260 (void)rettv_list_alloc(rettv);
6261 else
6262 ++rettv->vval.v_list->lv_refcount;
6263 }
6264 else
6265 {
6266 rettv->v_type = VAR_STRING;
6267 rettv->vval.v_string = get_reg_contents(regname,
6268 arg2 ? GREG_EXPR_SRC : 0);
6269 }
6270}
6271
6272/*
6273 * "getregtype()" function
6274 */
6275 static void
6276f_getregtype(typval_T *argvars, typval_T *rettv)
6277{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006278 int regname;
6279 char_u buf[NUMBUFLEN + 2];
6280 long reglen = 0;
6281
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006282 // on error return an empty string
6283 rettv->v_type = VAR_STRING;
6284 rettv->vval.v_string = NULL;
6285
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006286 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
6287 return;
6288
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006289 regname = getreg_get_regname(argvars);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006290 if (regname == 0)
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006291 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006292
6293 buf[0] = NUL;
6294 buf[1] = NUL;
6295 switch (get_reg_type(regname, &reglen))
6296 {
6297 case MLINE: buf[0] = 'V'; break;
6298 case MCHAR: buf[0] = 'v'; break;
6299 case MBLOCK:
6300 buf[0] = Ctrl_V;
6301 sprintf((char *)buf + 1, "%ld", reglen + 1);
6302 break;
6303 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006304 rettv->vval.v_string = vim_strsave(buf);
6305}
6306
Bram Moolenaarb5ae48e2016-08-12 22:23:25 +02006307/*
Bram Moolenaarf49cc602018-11-11 15:21:05 +01006308 * "gettagstack()" function
6309 */
6310 static void
6311f_gettagstack(typval_T *argvars, typval_T *rettv)
6312{
6313 win_T *wp = curwin; // default is current window
6314
Bram Moolenaar93a10962022-06-16 11:42:09 +01006315 if (rettv_dict_alloc(rettv) == FAIL)
Bram Moolenaarf49cc602018-11-11 15:21:05 +01006316 return;
6317
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006318 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
6319 return;
6320
Bram Moolenaarf49cc602018-11-11 15:21:05 +01006321 if (argvars[0].v_type != VAR_UNKNOWN)
6322 {
6323 wp = find_win_by_nr_or_id(&argvars[0]);
6324 if (wp == NULL)
6325 return;
6326 }
6327
6328 get_tagstack(wp, rettv->vval.v_dict);
6329}
6330
Bram Moolenaar0b39c3f2020-08-30 15:52:10 +02006331/*
6332 * "gettext()" function
6333 */
6334 static void
6335f_gettext(typval_T *argvars, typval_T *rettv)
6336{
Christ van Willegence0ef912024-06-20 23:41:59 +02006337#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
6338 char *prev = NULL;
6339#endif
6340
6341 if (check_for_nonempty_string_arg(argvars, 0) == FAIL
6342 || check_for_opt_string_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006343 return;
6344
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +01006345 rettv->v_type = VAR_STRING;
Christ van Willegence0ef912024-06-20 23:41:59 +02006346
6347 if (argvars[1].v_type == VAR_STRING &&
6348 argvars[1].vval.v_string != NULL &&
6349 *(argvars[1].vval.v_string) != NUL)
6350 {
6351#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
6352 prev = bind_textdomain_codeset((const char *)argvars[1].vval.v_string, (char *)p_enc);
6353#endif
6354
6355#if defined(HAVE_DGETTEXT)
6356 rettv->vval.v_string = vim_strsave((char_u *)dgettext((const char *)argvars[1].vval.v_string, (const char *)argvars[0].vval.v_string));
6357#else
6358 textdomain((const char *)argvars[1].vval.v_string);
6359 rettv->vval.v_string = vim_strsave((char_u *)_(argvars[0].vval.v_string));
6360 textdomain(VIMPACKAGE);
6361#endif
6362
6363#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
6364 if (prev != NULL)
6365 bind_textdomain_codeset((const char *)argvars[1].vval.v_string, prev);
6366#endif
6367 }
6368 else
6369 rettv->vval.v_string = vim_strsave((char_u *)_(argvars[0].vval.v_string));
Bram Moolenaar0b39c3f2020-08-30 15:52:10 +02006370}
6371
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01006372// for VIM_VERSION_ defines
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006373#include "version.h"
6374
6375/*
6376 * "has()" function
6377 */
Bram Moolenaara259d8d2020-01-31 20:10:50 +01006378 void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006379f_has(typval_T *argvars, typval_T *rettv)
6380{
6381 int i;
6382 char_u *name;
Bram Moolenaar79296512020-03-22 16:17:14 +01006383 int x = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006384 int n = FALSE;
Bram Moolenaar79296512020-03-22 16:17:14 +01006385 typedef struct {
6386 char *name;
6387 short present;
6388 } has_item_T;
6389 static has_item_T has_list[] =
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006390 {
Bram Moolenaar79296512020-03-22 16:17:14 +01006391 {"amiga",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006392#ifdef AMIGA
Bram Moolenaar79296512020-03-22 16:17:14 +01006393 1
Bram Moolenaar39536dd2019-01-29 22:58:21 +01006394#else
Bram Moolenaar79296512020-03-22 16:17:14 +01006395 0
Bram Moolenaar39536dd2019-01-29 22:58:21 +01006396#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006397 },
6398 {"arp",
6399#if defined(AMIGA) && defined(FEAT_ARP)
6400 1
6401#else
6402 0
6403#endif
6404 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006405 {"haiku",
6406#ifdef __HAIKU__
6407 1
6408#else
6409 0
6410#endif
6411 },
6412 {"bsd",
6413#if defined(BSD) && !defined(MACOS_X)
6414 1
6415#else
6416 0
6417#endif
6418 },
6419 {"hpux",
6420#ifdef hpux
6421 1
6422#else
6423 0
6424#endif
6425 },
6426 {"linux",
6427#ifdef __linux__
6428 1
6429#else
6430 0
6431#endif
6432 },
6433 {"mac", // Mac OS X (and, once, Mac OS Classic)
6434#ifdef MACOS_X
6435 1
6436#else
6437 0
6438#endif
6439 },
6440 {"osx", // Mac OS X
6441#ifdef MACOS_X
6442 1
6443#else
6444 0
6445#endif
6446 },
6447 {"macunix", // Mac OS X, with the darwin feature
6448#if defined(MACOS_X) && defined(MACOS_X_DARWIN)
6449 1
6450#else
6451 0
6452#endif
6453 },
6454 {"osxdarwin", // synonym for macunix
6455#if defined(MACOS_X) && defined(MACOS_X_DARWIN)
6456 1
6457#else
6458 0
6459#endif
6460 },
6461 {"qnx",
6462#ifdef __QNX__
6463 1
6464#else
6465 0
6466#endif
6467 },
6468 {"sun",
6469#ifdef SUN_SYSTEM
6470 1
6471#else
6472 0
6473#endif
6474 },
6475 {"unix",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006476#ifdef UNIX
Bram Moolenaar79296512020-03-22 16:17:14 +01006477 1
6478#else
6479 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006480#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006481 },
6482 {"vms",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006483#ifdef VMS
Bram Moolenaar79296512020-03-22 16:17:14 +01006484 1
6485#else
6486 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006487#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006488 },
6489 {"win32",
Bram Moolenaar4f974752019-02-17 17:44:42 +01006490#ifdef MSWIN
Bram Moolenaar79296512020-03-22 16:17:14 +01006491 1
6492#else
6493 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006494#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006495 },
6496 {"win32unix",
K.Takata972db232022-02-04 10:45:38 +00006497#ifdef WIN32UNIX
Bram Moolenaar79296512020-03-22 16:17:14 +01006498 1
6499#else
6500 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006501#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006502 },
6503 {"win64",
Bram Moolenaar44b443c2019-02-18 22:14:18 +01006504#ifdef _WIN64
Bram Moolenaar79296512020-03-22 16:17:14 +01006505 1
6506#else
6507 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006508#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006509 },
Bram Moolenaar424bcae2022-01-31 14:59:41 +00006510 {"ebcdic", 0 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006511 {"fname_case",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006512#ifndef CASE_INSENSITIVE_FILENAME
Bram Moolenaar79296512020-03-22 16:17:14 +01006513 1
6514#else
6515 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006516#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006517 },
6518 {"acl",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006519#ifdef HAVE_ACL
Bram Moolenaar79296512020-03-22 16:17:14 +01006520 1
6521#else
6522 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006523#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006524 },
6525 {"arabic",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006526#ifdef FEAT_ARABIC
Bram Moolenaar79296512020-03-22 16:17:14 +01006527 1
6528#else
6529 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006530#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006531 },
6532 {"autocmd", 1},
6533 {"autochdir",
Bram Moolenaar83ec2a72018-07-27 22:08:59 +02006534#ifdef FEAT_AUTOCHDIR
Bram Moolenaar79296512020-03-22 16:17:14 +01006535 1
6536#else
6537 0
Bram Moolenaar83ec2a72018-07-27 22:08:59 +02006538#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006539 },
6540 {"autoservername",
Bram Moolenaare42a6d22017-11-12 19:21:51 +01006541#ifdef FEAT_AUTOSERVERNAME
Bram Moolenaar79296512020-03-22 16:17:14 +01006542 1
6543#else
6544 0
Bram Moolenaare42a6d22017-11-12 19:21:51 +01006545#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006546 },
6547 {"balloon_eval",
Bram Moolenaarc3719bd2017-11-18 22:13:31 +01006548#ifdef FEAT_BEVAL_GUI
Bram Moolenaar79296512020-03-22 16:17:14 +01006549 1
6550#else
6551 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006552#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006553 },
6554 {"balloon_multiline",
Bram Moolenaar0bd663a2022-01-22 10:24:47 +00006555#ifdef FEAT_BEVAL_GUI
Bram Moolenaar79296512020-03-22 16:17:14 +01006556 1
6557#else
6558 0
6559#endif
6560 },
6561 {"balloon_eval_term",
Bram Moolenaarc3719bd2017-11-18 22:13:31 +01006562#ifdef FEAT_BEVAL_TERM
Bram Moolenaar79296512020-03-22 16:17:14 +01006563 1
6564#else
6565 0
Bram Moolenaar51b0f372017-11-18 18:52:04 +01006566#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006567 },
Bram Moolenaar2ee347f2022-08-26 17:53:44 +01006568 {"builtin_terms", 1},
6569 {"all_builtin_terms", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006570 {"browsefilter",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006571#if defined(FEAT_BROWSE) && (defined(USE_FILE_CHOOSER) \
Bram Moolenaar4f974752019-02-17 17:44:42 +01006572 || defined(FEAT_GUI_MSWIN) \
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006573 || defined(FEAT_GUI_MOTIF))
Bram Moolenaar79296512020-03-22 16:17:14 +01006574 1
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006575#else
Bram Moolenaar79296512020-03-22 16:17:14 +01006576 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006577#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006578 },
6579 {"byte_offset",
6580#ifdef FEAT_BYTEOFF
6581 1
6582#else
6583 0
6584#endif
6585 },
6586 {"channel",
6587#ifdef FEAT_JOB_CHANNEL
6588 1
6589#else
6590 0
6591#endif
6592 },
Bram Moolenaar8e145b82022-05-21 20:17:31 +01006593 {"cindent", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006594 {"clientserver",
6595#ifdef FEAT_CLIENTSERVER
6596 1
6597#else
6598 0
6599#endif
6600 },
6601 {"clipboard",
6602#ifdef FEAT_CLIPBOARD
6603 1
6604#else
6605 0
6606#endif
6607 },
6608 {"cmdline_compl", 1},
6609 {"cmdline_hist", 1},
Martin Tournoij7904fa42022-10-04 16:28:45 +01006610 {"cmdwin", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006611 {"comments", 1},
6612 {"conceal",
6613#ifdef FEAT_CONCEAL
6614 1
6615#else
6616 0
6617#endif
6618 },
6619 {"cryptv",
6620#ifdef FEAT_CRYPT
6621 1
6622#else
6623 0
6624#endif
6625 },
6626 {"crypt-blowfish",
6627#ifdef FEAT_CRYPT
6628 1
6629#else
6630 0
6631#endif
6632 },
6633 {"crypt-blowfish2",
6634#ifdef FEAT_CRYPT
6635 1
6636#else
6637 0
6638#endif
6639 },
6640 {"cscope",
6641#ifdef FEAT_CSCOPE
6642 1
6643#else
6644 0
6645#endif
6646 },
6647 {"cursorbind", 1},
6648 {"cursorshape",
6649#ifdef CURSOR_SHAPE
6650 1
6651#else
6652 0
6653#endif
6654 },
6655 {"debug",
6656#ifdef DEBUG
6657 1
6658#else
6659 0
6660#endif
6661 },
6662 {"dialog_con",
6663#ifdef FEAT_CON_DIALOG
6664 1
6665#else
6666 0
6667#endif
6668 },
glepnirdf461152024-04-04 22:23:29 +02006669 {"dialog_con_gui",
6670#if defined(FEAT_CON_DIALOG) && defined(FEAT_GUI_DIALOG)
6671 1
6672#else
6673 0
6674#endif
6675 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006676 {"dialog_gui",
6677#ifdef FEAT_GUI_DIALOG
6678 1
6679#else
6680 0
6681#endif
6682 },
6683 {"diff",
6684#ifdef FEAT_DIFF
6685 1
6686#else
6687 0
6688#endif
6689 },
6690 {"digraphs",
6691#ifdef FEAT_DIGRAPHS
6692 1
6693#else
6694 0
6695#endif
6696 },
6697 {"directx",
6698#ifdef FEAT_DIRECTX
6699 1
6700#else
6701 0
6702#endif
6703 },
6704 {"dnd",
6705#ifdef FEAT_DND
6706 1
6707#else
6708 0
6709#endif
6710 },
Bram Moolenaar1d1ce612021-06-27 19:02:52 +02006711 {"drop_file",
6712#ifdef HAVE_DROP_FILE
6713 1
6714#else
6715 0
6716#endif
6717 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006718 {"emacs_tags",
6719#ifdef FEAT_EMACS_TAGS
6720 1
6721#else
6722 0
6723#endif
6724 },
6725 {"eval", 1}, // always present, of course!
6726 {"ex_extra", 1}, // graduated feature
6727 {"extra_search",
6728#ifdef FEAT_SEARCH_EXTRA
6729 1
6730#else
6731 0
6732#endif
6733 },
Bram Moolenaarf80f40a2022-08-25 16:02:23 +01006734 {"file_in_path", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006735 {"filterpipe",
6736#if defined(FEAT_FILTERPIPE) && !defined(VIMDLL)
6737 1
6738#else
6739 0
6740#endif
6741 },
6742 {"find_in_path",
6743#ifdef FEAT_FIND_ID
6744 1
6745#else
6746 0
6747#endif
6748 },
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01006749 {"float", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006750 {"folding",
6751#ifdef FEAT_FOLDING
6752 1
6753#else
6754 0
6755#endif
6756 },
Bram Moolenaarc8ac3a02022-09-04 12:29:28 +01006757 {"footer", 0},
Bram Moolenaar79296512020-03-22 16:17:14 +01006758 {"fork",
6759#if !defined(USE_SYSTEM) && defined(UNIX)
6760 1
6761#else
6762 0
6763#endif
6764 },
6765 {"gettext",
6766#ifdef FEAT_GETTEXT
6767 1
6768#else
6769 0
6770#endif
6771 },
6772 {"gui",
6773#ifdef FEAT_GUI
6774 1
6775#else
6776 0
6777#endif
6778 },
Bram Moolenaar0b962e52022-04-03 18:02:37 +01006779 {"gui_neXtaw", 0 },
6780 {"gui_athena", 0 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006781 {"gui_gtk",
6782#ifdef FEAT_GUI_GTK
6783 1
6784#else
6785 0
6786#endif
6787 },
6788 {"gui_gtk2",
6789#if defined(FEAT_GUI_GTK) && !defined(USE_GTK3)
6790 1
6791#else
6792 0
6793#endif
6794 },
6795 {"gui_gtk3",
6796#if defined(FEAT_GUI_GTK) && defined(USE_GTK3)
6797 1
6798#else
6799 0
6800#endif
6801 },
6802 {"gui_gnome",
6803#ifdef FEAT_GUI_GNOME
6804 1
6805#else
6806 0
6807#endif
6808 },
6809 {"gui_haiku",
6810#ifdef FEAT_GUI_HAIKU
6811 1
6812#else
6813 0
6814#endif
6815 },
Bram Moolenaar097148e2020-08-11 21:58:20 +02006816 {"gui_mac", 0},
Bram Moolenaar79296512020-03-22 16:17:14 +01006817 {"gui_motif",
6818#ifdef FEAT_GUI_MOTIF
6819 1
6820#else
6821 0
6822#endif
6823 },
6824 {"gui_photon",
6825#ifdef FEAT_GUI_PHOTON
6826 1
6827#else
6828 0
6829#endif
6830 },
6831 {"gui_win32",
6832#ifdef FEAT_GUI_MSWIN
6833 1
6834#else
6835 0
6836#endif
6837 },
6838 {"iconv",
6839#if defined(HAVE_ICONV_H) && defined(USE_ICONV)
6840 1
6841#else
6842 0
6843#endif
6844 },
6845 {"insert_expand", 1},
Bram Moolenaarbfe13cc2020-04-12 17:53:12 +02006846 {"ipv6",
6847#ifdef FEAT_IPV6
6848 1
6849#else
6850 0
6851#endif
6852 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006853 {"job",
6854#ifdef FEAT_JOB_CHANNEL
6855 1
6856#else
6857 0
6858#endif
6859 },
Bram Moolenaar739f13a2021-12-13 13:12:53 +00006860 {"jumplist", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006861 {"keymap",
6862#ifdef FEAT_KEYMAP
6863 1
6864#else
6865 0
6866#endif
6867 },
6868 {"lambda", 1}, // always with FEAT_EVAL, since 7.4.2120 with closure
6869 {"langmap",
6870#ifdef FEAT_LANGMAP
6871 1
6872#else
6873 0
6874#endif
6875 },
6876 {"libcall",
6877#ifdef FEAT_LIBCALL
6878 1
6879#else
6880 0
6881#endif
6882 },
6883 {"linebreak",
6884#ifdef FEAT_LINEBREAK
6885 1
6886#else
6887 0
6888#endif
6889 },
Bram Moolenaar8e145b82022-05-21 20:17:31 +01006890 {"lispindent", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006891 {"listcmds", 1},
6892 {"localmap", 1},
6893 {"lua",
6894#if defined(FEAT_LUA) && !defined(DYNAMIC_LUA)
6895 1
6896#else
6897 0
6898#endif
6899 },
6900 {"menu",
6901#ifdef FEAT_MENU
6902 1
6903#else
6904 0
6905#endif
6906 },
6907 {"mksession",
6908#ifdef FEAT_SESSION
6909 1
6910#else
6911 0
6912#endif
6913 },
6914 {"modify_fname", 1},
6915 {"mouse", 1},
6916 {"mouseshape",
6917#ifdef FEAT_MOUSESHAPE
6918 1
6919#else
6920 0
6921#endif
6922 },
6923 {"mouse_dec",
6924#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_DEC)
6925 1
6926#else
6927 0
6928#endif
6929 },
6930 {"mouse_gpm",
Bram Moolenaar33fc4a62022-02-23 18:07:38 +00006931#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_GPM) && !defined(DYNAMIC_GPM)
Bram Moolenaar79296512020-03-22 16:17:14 +01006932 1
6933#else
6934 0
6935#endif
6936 },
6937 {"mouse_jsbterm",
6938#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_JSB)
6939 1
6940#else
6941 0
6942#endif
6943 },
6944 {"mouse_netterm",
6945#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_NET)
6946 1
6947#else
6948 0
6949#endif
6950 },
6951 {"mouse_pterm",
6952#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_PTERM)
6953 1
6954#else
6955 0
6956#endif
6957 },
6958 {"mouse_sgr",
6959#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_XTERM)
6960 1
6961#else
6962 0
6963#endif
6964 },
6965 {"mouse_sysmouse",
6966#if (defined(UNIX) || defined(VMS)) && defined(FEAT_SYSMOUSE)
6967 1
6968#else
6969 0
6970#endif
6971 },
6972 {"mouse_urxvt",
6973#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_URXVT)
6974 1
6975#else
6976 0
6977#endif
6978 },
6979 {"mouse_xterm",
6980#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_XTERM)
6981 1
6982#else
6983 0
6984#endif
6985 },
6986 {"multi_byte", 1},
6987 {"multi_byte_ime",
6988#ifdef FEAT_MBYTE_IME
6989 1
6990#else
6991 0
6992#endif
6993 },
6994 {"multi_lang",
6995#ifdef FEAT_MULTI_LANG
6996 1
6997#else
6998 0
6999#endif
7000 },
7001 {"mzscheme",
7002#if defined(FEAT_MZSCHEME) && !defined(DYNAMIC_MZSCHEME)
7003 1
7004#else
7005 0
7006#endif
7007 },
Leah Neukirchen0a7984a2021-10-14 21:27:55 +01007008 {"nanotime",
7009#ifdef ST_MTIM_NSEC
7010 1
7011#else
7012 0
7013#endif
7014 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007015 {"num64", 1},
7016 {"ole",
7017#ifdef FEAT_OLE
7018 1
7019#else
7020 0
7021#endif
7022 },
7023 {"packages",
7024#ifdef FEAT_EVAL
7025 1
7026#else
7027 0
7028#endif
7029 },
Bram Moolenaar2bd9dbc2022-08-25 18:12:06 +01007030 {"path_extra", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007031 {"perl",
7032#if defined(FEAT_PERL) && !defined(DYNAMIC_PERL)
7033 1
7034#else
7035 0
7036#endif
7037 },
7038 {"persistent_undo",
7039#ifdef FEAT_PERSISTENT_UNDO
7040 1
7041#else
7042 0
7043#endif
7044 },
7045 {"python_compiled",
7046#if defined(FEAT_PYTHON)
7047 1
7048#else
7049 0
7050#endif
7051 },
7052 {"python_dynamic",
7053#if defined(FEAT_PYTHON) && defined(DYNAMIC_PYTHON)
7054 1
7055#else
7056 0
7057#endif
7058 },
7059 {"python",
7060#if defined(FEAT_PYTHON) && !defined(DYNAMIC_PYTHON)
7061 1
7062#else
7063 0
7064#endif
7065 },
7066 {"pythonx",
7067#if (defined(FEAT_PYTHON) && !defined(DYNAMIC_PYTHON)) \
7068 || (defined(FEAT_PYTHON3) && !defined(DYNAMIC_PYTHON3))
7069 1
7070#else
7071 0
7072#endif
7073 },
7074 {"python3_compiled",
7075#if defined(FEAT_PYTHON3)
7076 1
7077#else
7078 0
7079#endif
7080 },
7081 {"python3_dynamic",
7082#if defined(FEAT_PYTHON3) && defined(DYNAMIC_PYTHON3)
7083 1
7084#else
7085 0
7086#endif
7087 },
Yee Cheng Chinc13b3d12023-08-20 21:18:38 +02007088 {"python3_stable",
7089#if defined(FEAT_PYTHON3) && defined(DYNAMIC_PYTHON3_STABLE_ABI)
7090 1
7091#else
7092 0
7093#endif
7094 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007095 {"python3",
7096#if defined(FEAT_PYTHON3) && !defined(DYNAMIC_PYTHON3)
7097 1
7098#else
7099 0
7100#endif
7101 },
7102 {"popupwin",
7103#ifdef FEAT_PROP_POPUP
7104 1
7105#else
7106 0
7107#endif
7108 },
7109 {"postscript",
7110#ifdef FEAT_POSTSCRIPT
7111 1
7112#else
7113 0
7114#endif
7115 },
7116 {"printer",
7117#ifdef FEAT_PRINTER
7118 1
7119#else
7120 0
7121#endif
7122 },
7123 {"profile",
7124#ifdef FEAT_PROFILE
7125 1
7126#else
7127 0
7128#endif
7129 },
Ernie Rael076de792023-03-16 21:43:15 +00007130 {"prof_nsec",
Bram Moolenaar08210f82023-04-13 19:15:54 +01007131#ifdef PROF_NSEC
Ernie Rael076de792023-03-16 21:43:15 +00007132 1
7133#else
7134 0
7135#endif
7136 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007137 {"reltime",
7138#ifdef FEAT_RELTIME
7139 1
7140#else
7141 0
7142#endif
7143 },
7144 {"quickfix",
7145#ifdef FEAT_QUICKFIX
7146 1
7147#else
7148 0
7149#endif
7150 },
7151 {"rightleft",
7152#ifdef FEAT_RIGHTLEFT
7153 1
7154#else
7155 0
7156#endif
7157 },
7158 {"ruby",
7159#if defined(FEAT_RUBY) && !defined(DYNAMIC_RUBY)
7160 1
7161#else
7162 0
7163#endif
7164 },
7165 {"scrollbind", 1},
Martin Tournoijba43e762022-10-13 22:12:15 +01007166 {"showcmd", 1},
7167 {"cmdline_info", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007168 {"signs",
7169#ifdef FEAT_SIGNS
7170 1
7171#else
7172 0
7173#endif
7174 },
Bram Moolenaar8e145b82022-05-21 20:17:31 +01007175 {"smartindent", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007176 {"startuptime",
7177#ifdef STARTUPTIME
7178 1
7179#else
7180 0
7181#endif
7182 },
7183 {"statusline",
7184#ifdef FEAT_STL_OPT
7185 1
7186#else
7187 0
7188#endif
7189 },
7190 {"netbeans_intg",
7191#ifdef FEAT_NETBEANS_INTG
7192 1
7193#else
7194 0
7195#endif
7196 },
Christian Brabandtf573c6e2021-06-20 14:02:16 +02007197 {"sodium",
K.Takatad68b2fc2022-02-12 11:18:37 +00007198#if defined(FEAT_SODIUM) && !defined(DYNAMIC_SODIUM)
Christian Brabandtf573c6e2021-06-20 14:02:16 +02007199 1
7200#else
7201 0
7202#endif
7203 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007204 {"sound",
7205#ifdef FEAT_SOUND
7206 1
7207#else
7208 0
7209#endif
7210 },
7211 {"spell",
7212#ifdef FEAT_SPELL
7213 1
7214#else
7215 0
7216#endif
7217 },
7218 {"syntax",
7219#ifdef FEAT_SYN_HL
7220 1
7221#else
7222 0
7223#endif
7224 },
7225 {"system",
7226#if defined(USE_SYSTEM) || !defined(UNIX)
7227 1
7228#else
7229 0
7230#endif
7231 },
Yegappan Lakshmanan655b7342022-03-06 14:27:10 +00007232 {"tag_binary", 1}, // graduated feature
Bram Moolenaar79296512020-03-22 16:17:14 +01007233 {"tcl",
7234#if defined(FEAT_TCL) && !defined(DYNAMIC_TCL)
7235 1
7236#else
7237 0
7238#endif
7239 },
7240 {"termguicolors",
7241#ifdef FEAT_TERMGUICOLORS
7242 1
7243#else
7244 0
7245#endif
7246 },
7247 {"terminal",
7248#if defined(FEAT_TERMINAL) && !defined(MSWIN)
7249 1
7250#else
7251 0
7252#endif
7253 },
7254 {"terminfo",
7255#ifdef TERMINFO
7256 1
7257#else
7258 0
7259#endif
7260 },
7261 {"termresponse",
7262#ifdef FEAT_TERMRESPONSE
7263 1
7264#else
7265 0
7266#endif
7267 },
Bram Moolenaar88774872022-08-16 20:24:29 +01007268 {"textobjects", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007269 {"textprop",
7270#ifdef FEAT_PROP_POPUP
7271 1
7272#else
7273 0
7274#endif
7275 },
7276 {"tgetent",
7277#ifdef HAVE_TGETENT
7278 1
7279#else
7280 0
7281#endif
7282 },
7283 {"timers",
7284#ifdef FEAT_TIMERS
7285 1
7286#else
7287 0
7288#endif
7289 },
Bram Moolenaar651fca82021-11-29 20:39:38 +00007290 {"title", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007291 {"toolbar",
7292#ifdef FEAT_TOOLBAR
7293 1
7294#else
7295 0
7296#endif
7297 },
7298 {"unnamedplus",
7299#if defined(FEAT_CLIPBOARD) && defined(FEAT_X11)
7300 1
7301#else
7302 0
7303#endif
7304 },
7305 {"user-commands", 1}, // was accidentally included in 5.4
7306 {"user_commands", 1},
7307 {"vartabs",
7308#ifdef FEAT_VARTABS
7309 1
7310#else
7311 0
7312#endif
7313 },
7314 {"vertsplit", 1},
7315 {"viminfo",
7316#ifdef FEAT_VIMINFO
7317 1
7318#else
7319 0
7320#endif
7321 },
Bram Moolenaarb79ee0c2022-01-01 12:17:00 +00007322 {"vim9script", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007323 {"vimscript-1", 1},
7324 {"vimscript-2", 1},
7325 {"vimscript-3", 1},
7326 {"vimscript-4", 1},
7327 {"virtualedit", 1},
7328 {"visual", 1},
7329 {"visualextra", 1},
7330 {"vreplace", 1},
7331 {"vtp",
7332#ifdef FEAT_VTP
7333 1
7334#else
7335 0
7336#endif
7337 },
Bram Moolenaar074fbd42022-08-26 16:41:14 +01007338 {"wildignore", 1},
Bram Moolenaar54162322022-08-26 16:58:51 +01007339 {"wildmenu", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007340 {"windows", 1},
7341 {"winaltkeys",
7342#ifdef FEAT_WAK
7343 1
7344#else
7345 0
7346#endif
7347 },
7348 {"writebackup",
7349#ifdef FEAT_WRITEBACKUP
7350 1
7351#else
7352 0
7353#endif
7354 },
Christian Brabandte085dfd2023-09-30 12:49:18 +02007355 {"xattr",
7356#ifdef FEAT_XATTR
7357 1
7358#else
7359 0
7360#endif
7361 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007362 {"xim",
7363#ifdef FEAT_XIM
7364 1
7365#else
7366 0
7367#endif
7368 },
7369 {"xfontset",
7370#ifdef FEAT_XFONTSET
7371 1
7372#else
7373 0
7374#endif
7375 },
7376 {"xpm",
7377#if defined(FEAT_XPM_W32) || defined(HAVE_XPM)
7378 1
7379#else
7380 0
7381#endif
7382 },
7383 {"xpm_w32", // for backward compatibility
7384#ifdef FEAT_XPM_W32
7385 1
7386#else
7387 0
7388#endif
7389 },
7390 {"xsmp",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007391#ifdef USE_XSMP
Bram Moolenaar79296512020-03-22 16:17:14 +01007392 1
7393#else
7394 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007395#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007396 },
7397 {"xsmp_interact",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007398#ifdef USE_XSMP_INTERACT
Bram Moolenaar79296512020-03-22 16:17:14 +01007399 1
7400#else
7401 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007402#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007403 },
7404 {"xterm_clipboard",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007405#ifdef FEAT_XCLIPBOARD
Bram Moolenaar79296512020-03-22 16:17:14 +01007406 1
7407#else
7408 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007409#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007410 },
7411 {"xterm_save",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007412#ifdef FEAT_XTERM_SAVE
Bram Moolenaar79296512020-03-22 16:17:14 +01007413 1
7414#else
7415 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007416#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007417 },
7418 {"X11",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007419#if defined(UNIX) && defined(FEAT_X11)
Bram Moolenaar79296512020-03-22 16:17:14 +01007420 1
7421#else
7422 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007423#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007424 },
Bram Moolenaar80adaa82023-07-07 18:57:40 +01007425 {":tearoff",
7426// same #ifdef as used for ex_tearoff().
7427#if defined(FEAT_GUI_MSWIN) && defined(FEAT_MENU) && defined(FEAT_TEAROFF)
7428 1
7429#else
7430 0
7431#endif
7432 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007433 {NULL, 0}
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007434 };
7435
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02007436 if (in_vim9script()
7437 && (check_for_string_arg(argvars, 0) == FAIL
7438 || check_for_opt_bool_arg(argvars, 1) == FAIL))
7439 return;
7440
Bram Moolenaard155d7a2018-12-21 16:04:21 +01007441 name = tv_get_string(&argvars[0]);
Bram Moolenaar79296512020-03-22 16:17:14 +01007442 for (i = 0; has_list[i].name != NULL; ++i)
7443 if (STRICMP(name, has_list[i].name) == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007444 {
Bram Moolenaar79296512020-03-22 16:17:14 +01007445 x = TRUE;
7446 n = has_list[i].present;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007447 break;
7448 }
7449
Bram Moolenaar79296512020-03-22 16:17:14 +01007450 // features also in has_list[] but sometimes enabled at runtime
7451 if (x == TRUE && n == FALSE)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007452 {
Bram Moolenaar79296512020-03-22 16:17:14 +01007453 if (0)
Bram Moolenaar86b9a3e2020-04-07 19:57:29 +02007454 {
7455 // intentionally empty
7456 }
Bram Moolenaar79296512020-03-22 16:17:14 +01007457#ifdef VIMDLL
7458 else if (STRICMP(name, "filterpipe") == 0)
7459 n = gui.in_use || gui.starting;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007460#endif
7461#if defined(USE_ICONV) && defined(DYNAMIC_ICONV)
7462 else if (STRICMP(name, "iconv") == 0)
7463 n = iconv_enabled(FALSE);
7464#endif
7465#ifdef DYNAMIC_LUA
7466 else if (STRICMP(name, "lua") == 0)
7467 n = lua_enabled(FALSE);
7468#endif
7469#ifdef DYNAMIC_MZSCHEME
7470 else if (STRICMP(name, "mzscheme") == 0)
7471 n = mzscheme_enabled(FALSE);
7472#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007473#ifdef DYNAMIC_PERL
7474 else if (STRICMP(name, "perl") == 0)
7475 n = perl_enabled(FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007476#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007477#ifdef DYNAMIC_PYTHON
7478 else if (STRICMP(name, "python") == 0)
7479 n = python_enabled(FALSE);
7480#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007481#ifdef DYNAMIC_PYTHON3
7482 else if (STRICMP(name, "python3") == 0)
7483 n = python3_enabled(FALSE);
7484#endif
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01007485#if defined(DYNAMIC_PYTHON) || defined(DYNAMIC_PYTHON3)
7486 else if (STRICMP(name, "pythonx") == 0)
7487 {
7488# if defined(DYNAMIC_PYTHON) && defined(DYNAMIC_PYTHON3)
7489 if (p_pyx == 0)
7490 n = python3_enabled(FALSE) || python_enabled(FALSE);
7491 else if (p_pyx == 3)
7492 n = python3_enabled(FALSE);
7493 else if (p_pyx == 2)
7494 n = python_enabled(FALSE);
7495# elif defined(DYNAMIC_PYTHON)
7496 n = python_enabled(FALSE);
7497# elif defined(DYNAMIC_PYTHON3)
7498 n = python3_enabled(FALSE);
7499# endif
7500 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007501#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007502#ifdef DYNAMIC_RUBY
7503 else if (STRICMP(name, "ruby") == 0)
7504 n = ruby_enabled(FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007505#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007506#ifdef DYNAMIC_TCL
7507 else if (STRICMP(name, "tcl") == 0)
7508 n = tcl_enabled(FALSE);
Bram Moolenaar4b8366b2019-05-04 17:34:34 +02007509#endif
K.Takatad68b2fc2022-02-12 11:18:37 +00007510#ifdef DYNAMIC_SODIUM
7511 else if (STRICMP(name, "sodium") == 0)
7512 n = sodium_enabled(FALSE);
7513#endif
Bram Moolenaar4f974752019-02-17 17:44:42 +01007514#if defined(FEAT_TERMINAL) && defined(MSWIN)
Bram Moolenaara83e3962017-08-17 14:39:07 +02007515 else if (STRICMP(name, "terminal") == 0)
7516 n = terminal_enabled();
7517#endif
Bram Moolenaar33fc4a62022-02-23 18:07:38 +00007518#ifdef DYNAMIC_GPM
7519 else if (STRICMP(name, "mouse_gpm") == 0)
7520 n = gpm_available();
7521#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007522 }
7523
Bram Moolenaar79296512020-03-22 16:17:14 +01007524 // features not in has_list[]
7525 if (x == FALSE)
7526 {
7527 if (STRNICMP(name, "patch", 5) == 0)
7528 {
7529 x = TRUE;
7530 if (name[5] == '-'
7531 && STRLEN(name) >= 11
K.Takatad90f91f2022-07-30 15:43:59 +01007532 && (name[6] >= '1' && name[6] <= '9'))
Bram Moolenaar79296512020-03-22 16:17:14 +01007533 {
K.Takatad90f91f2022-07-30 15:43:59 +01007534 char *end;
7535 int major, minor;
Bram Moolenaar79296512020-03-22 16:17:14 +01007536
K.Takatad90f91f2022-07-30 15:43:59 +01007537 // This works for patch-8.1.2, patch-9.0.3, patch-10.0.4, etc.
7538 // Not for patch-9.10.5.
7539 major = (int)strtoul((char *)name + 6, &end, 10);
7540 if (*end == '.' && vim_isdigit(end[1])
7541 && end[2] == '.' && vim_isdigit(end[3]))
7542 {
7543 minor = atoi(end + 1);
7544
7545 // Expect "patch-9.9.01234".
7546 n = (major < VIM_VERSION_MAJOR
7547 || (major == VIM_VERSION_MAJOR
7548 && (minor < VIM_VERSION_MINOR
7549 || (minor == VIM_VERSION_MINOR
7550 && has_patch(atoi(end + 3))))));
7551 }
Bram Moolenaar79296512020-03-22 16:17:14 +01007552 }
Keith Thompson184f71c2024-01-04 21:19:04 +01007553 else if (SAFE_isdigit(name[5]))
Bram Moolenaar79296512020-03-22 16:17:14 +01007554 n = has_patch(atoi((char *)name + 5));
7555 }
7556 else if (STRICMP(name, "vim_starting") == 0)
7557 {
7558 x = TRUE;
7559 n = (starting != 0);
7560 }
7561 else if (STRICMP(name, "ttyin") == 0)
7562 {
7563 x = TRUE;
7564 n = mch_input_isatty();
7565 }
7566 else if (STRICMP(name, "ttyout") == 0)
7567 {
7568 x = TRUE;
7569 n = stdout_isatty;
7570 }
7571 else if (STRICMP(name, "multi_byte_encoding") == 0)
7572 {
7573 x = TRUE;
7574 n = has_mbyte;
7575 }
7576 else if (STRICMP(name, "gui_running") == 0)
7577 {
7578 x = TRUE;
7579#ifdef FEAT_GUI
7580 n = (gui.in_use || gui.starting);
7581#endif
7582 }
7583 else if (STRICMP(name, "browse") == 0)
7584 {
7585 x = TRUE;
7586#if defined(FEAT_GUI) && defined(FEAT_BROWSE)
7587 n = gui.in_use; // gui_mch_browse() works when GUI is running
7588#endif
7589 }
7590 else if (STRICMP(name, "syntax_items") == 0)
7591 {
7592 x = TRUE;
7593#ifdef FEAT_SYN_HL
7594 n = syntax_present(curwin);
7595#endif
7596 }
7597 else if (STRICMP(name, "vcon") == 0)
7598 {
7599 x = TRUE;
7600#ifdef FEAT_VTP
7601 n = is_term_win32() && has_vtp_working();
7602#endif
7603 }
7604 else if (STRICMP(name, "netbeans_enabled") == 0)
7605 {
7606 x = TRUE;
7607#ifdef FEAT_NETBEANS_INTG
7608 n = netbeans_active();
7609#endif
7610 }
7611 else if (STRICMP(name, "mouse_gpm_enabled") == 0)
7612 {
7613 x = TRUE;
7614#ifdef FEAT_MOUSE_GPM
7615 n = gpm_enabled();
7616#endif
7617 }
7618 else if (STRICMP(name, "conpty") == 0)
7619 {
7620 x = TRUE;
7621#if defined(FEAT_TERMINAL) && defined(MSWIN)
7622 n = use_conpty();
7623#endif
7624 }
7625 else if (STRICMP(name, "clipboard_working") == 0)
7626 {
7627 x = TRUE;
7628#ifdef FEAT_CLIPBOARD
7629 n = clip_star.available;
7630#endif
7631 }
7632 }
7633
Bram Moolenaar04637e22020-09-05 18:45:29 +02007634 if (argvars[1].v_type != VAR_UNKNOWN && tv_get_bool(&argvars[1]))
Bram Moolenaar79296512020-03-22 16:17:14 +01007635 // return whether feature could ever be enabled
7636 rettv->vval.v_number = x;
7637 else
7638 // return whether feature is enabled
7639 rettv->vval.v_number = n;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007640}
7641
7642/*
Bram Moolenaar8cebd432020-11-08 12:49:47 +01007643 * Return TRUE if "feature" can change later.
7644 * Also when checking for the feature has side effects, such as loading a DLL.
7645 */
7646 int
7647dynamic_feature(char_u *feature)
7648{
7649 return (feature == NULL
Bram Moolenaar8cebd432020-11-08 12:49:47 +01007650#if defined(FEAT_GUI) && defined(FEAT_BROWSE)
7651 || (STRICMP(feature, "browse") == 0 && !gui.in_use)
7652#endif
7653#ifdef VIMDLL
7654 || STRICMP(feature, "filterpipe") == 0
7655#endif
Bram Moolenaar29b281b2020-11-10 20:58:00 +01007656#if defined(FEAT_GUI) && !defined(ALWAYS_USE_GUI) && !defined(VIMDLL)
Bram Moolenaar8cebd432020-11-08 12:49:47 +01007657 // this can only change on Unix where the ":gui" command could be
7658 // used.
7659 || (STRICMP(feature, "gui_running") == 0 && !gui.in_use)
7660#endif
7661#if defined(USE_ICONV) && defined(DYNAMIC_ICONV)
7662 || STRICMP(feature, "iconv") == 0
7663#endif
7664#ifdef DYNAMIC_LUA
7665 || STRICMP(feature, "lua") == 0
7666#endif
7667#ifdef FEAT_MOUSE_GPM
7668 || (STRICMP(feature, "mouse_gpm_enabled") == 0 && !gpm_enabled())
7669#endif
7670#ifdef DYNAMIC_MZSCHEME
7671 || STRICMP(feature, "mzscheme") == 0
7672#endif
7673#ifdef FEAT_NETBEANS_INTG
7674 || STRICMP(feature, "netbeans_enabled") == 0
7675#endif
7676#ifdef DYNAMIC_PERL
7677 || STRICMP(feature, "perl") == 0
7678#endif
7679#ifdef DYNAMIC_PYTHON
7680 || STRICMP(feature, "python") == 0
7681#endif
7682#ifdef DYNAMIC_PYTHON3
7683 || STRICMP(feature, "python3") == 0
7684#endif
7685#if defined(DYNAMIC_PYTHON) || defined(DYNAMIC_PYTHON3)
7686 || STRICMP(feature, "pythonx") == 0
7687#endif
7688#ifdef DYNAMIC_RUBY
7689 || STRICMP(feature, "ruby") == 0
7690#endif
7691#ifdef FEAT_SYN_HL
7692 || STRICMP(feature, "syntax_items") == 0
7693#endif
7694#ifdef DYNAMIC_TCL
7695 || STRICMP(feature, "tcl") == 0
7696#endif
7697 // once "starting" is zero it will stay that way
7698 || (STRICMP(feature, "vim_starting") == 0 && starting != 0)
7699 || STRICMP(feature, "multi_byte_encoding") == 0
7700#if defined(FEAT_TERMINAL) && defined(MSWIN)
7701 || STRICMP(feature, "conpty") == 0
7702#endif
7703 );
7704}
7705
7706/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007707 * "haslocaldir()" function
7708 */
7709 static void
7710f_haslocaldir(typval_T *argvars, typval_T *rettv)
7711{
Bram Moolenaar00aa0692019-04-27 20:37:57 +02007712 tabpage_T *tp = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007713 win_T *wp = NULL;
7714
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02007715 if (in_vim9script()
7716 && (check_for_opt_number_arg(argvars, 0) == FAIL
7717 || (argvars[0].v_type != VAR_UNKNOWN
7718 && check_for_opt_number_arg(argvars, 1) == FAIL)))
7719 return;
7720
Bram Moolenaar00aa0692019-04-27 20:37:57 +02007721 wp = find_tabwin(&argvars[0], &argvars[1], &tp);
7722
7723 // Check for window-local and tab-local directories
7724 if (wp != NULL && wp->w_localdir != NULL)
7725 rettv->vval.v_number = 1;
7726 else if (tp != NULL && tp->tp_localdir != NULL)
7727 rettv->vval.v_number = 2;
7728 else
7729 rettv->vval.v_number = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007730}
7731
7732/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007733 * "highlightID(name)" function
7734 */
7735 static void
7736f_hlID(typval_T *argvars, typval_T *rettv)
7737{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02007738 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
7739 return;
7740
Bram Moolenaard155d7a2018-12-21 16:04:21 +01007741 rettv->vval.v_number = syn_name2id(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007742}
7743
7744/*
7745 * "highlight_exists()" function
7746 */
7747 static void
7748f_hlexists(typval_T *argvars, typval_T *rettv)
7749{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02007750 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
7751 return;
7752
Bram Moolenaard155d7a2018-12-21 16:04:21 +01007753 rettv->vval.v_number = highlight_exists(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007754}
7755
7756/*
7757 * "hostname()" function
7758 */
7759 static void
7760f_hostname(typval_T *argvars UNUSED, typval_T *rettv)
7761{
7762 char_u hostname[256];
7763
7764 mch_get_host_name(hostname, 256);
7765 rettv->v_type = VAR_STRING;
7766 rettv->vval.v_string = vim_strsave(hostname);
7767}
7768
7769/*
Ernie Raelc8e158b2024-07-09 18:39:52 +02007770 * "id()" function
7771 * Identity. Return address of item as a hex string, %p format.
7772 * Currently only valid for object/container types.
7773 * Return empty string if not an object.
7774 */
Zoltan Arpadffy10231ac2024-08-18 16:59:20 +02007775#ifdef VMS // VMS does not have defined uintptr_t
7776# if defined(HAVE_NO_LONG_LONG)
7777typedef unsigned int uintptr_t;
7778# else
7779typedef unsigned long long uintptr_t;
7780# endif
7781#endif // VMS
7782
John Marriottb3b2bee2024-07-14 11:12:51 +02007783 static void
Ernie Raelc8e158b2024-07-09 18:39:52 +02007784f_id(typval_T *argvars, typval_T *rettv)
7785{
Ernie Rael05124252024-07-11 22:10:45 +02007786 char numbuf[NUMBUFLEN];
7787 char *p = numbuf;
Ernie Raelc8e158b2024-07-09 18:39:52 +02007788
7789 switch (argvars[0].v_type)
7790 {
7791 case VAR_LIST:
7792 case VAR_DICT:
7793 case VAR_OBJECT:
7794 case VAR_JOB:
7795 case VAR_CHANNEL:
7796 case VAR_BLOB:
7797 // Assume pointer value in typval_T vval union at common location.
7798 if (argvars[0].vval.v_object != NULL)
Ernie Rael05124252024-07-11 22:10:45 +02007799 {
7800 // "v" gets the address as an integer
7801 uintptr_t v = (uintptr_t)(void *)argvars[0].vval.v_object;
7802 // Build a hex string from the item's address; it is in
7803 // reverse order. Ignore trailing zeros.
7804 for (; p < numbuf + sizeof(uintptr_t) * 2 && v != 0;
7805 ++p, v >>= 4)
7806 *p = "0123456789abcdef"[v & 0xf];
7807 }
Ernie Raelc8e158b2024-07-09 18:39:52 +02007808 default:
Ernie Rael05124252024-07-11 22:10:45 +02007809 break;
Ernie Raelc8e158b2024-07-09 18:39:52 +02007810 }
Ernie Rael05124252024-07-11 22:10:45 +02007811 *p = NUL;
Ernie Raelc8e158b2024-07-09 18:39:52 +02007812
7813 rettv->v_type = VAR_STRING;
Ernie Rael05124252024-07-11 22:10:45 +02007814 rettv->vval.v_string = vim_strsave((char_u *)numbuf);
Ernie Raelc8e158b2024-07-09 18:39:52 +02007815}
7816
7817/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007818 * "index()" function
7819 */
7820 static void
7821f_index(typval_T *argvars, typval_T *rettv)
7822{
7823 list_T *l;
7824 listitem_T *item;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007825 blob_T *b;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007826 long idx = 0;
7827 int ic = FALSE;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007828 int error = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007829
7830 rettv->vval.v_number = -1;
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02007831
7832 if (in_vim9script()
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02007833 && (check_for_list_or_blob_arg(argvars, 0) == FAIL
7834 || (argvars[0].v_type == VAR_BLOB
7835 && check_for_number_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02007836 || check_for_opt_number_arg(argvars, 2) == FAIL
7837 || (argvars[2].v_type != VAR_UNKNOWN
7838 && check_for_opt_bool_arg(argvars, 3) == FAIL)))
7839 return;
7840
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007841 if (argvars[0].v_type == VAR_BLOB)
7842 {
7843 typval_T tv;
7844 int start = 0;
7845
7846 if (argvars[2].v_type != VAR_UNKNOWN)
7847 {
7848 start = tv_get_number_chk(&argvars[2], &error);
7849 if (error)
7850 return;
7851 }
7852 b = argvars[0].vval.v_blob;
7853 if (b == NULL)
7854 return;
Bram Moolenaar05500ec2019-01-13 19:10:33 +01007855 if (start < 0)
7856 {
7857 start = blob_len(b) + start;
7858 if (start < 0)
7859 start = 0;
7860 }
7861
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007862 for (idx = start; idx < blob_len(b); ++idx)
7863 {
7864 tv.v_type = VAR_NUMBER;
7865 tv.vval.v_number = blob_get(b, idx);
Yinzuo Jiang7ccd1a22024-07-04 17:20:53 +02007866 if (tv_equal(&tv, &argvars[1], ic))
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007867 {
7868 rettv->vval.v_number = idx;
7869 return;
7870 }
7871 }
7872 return;
7873 }
7874 else if (argvars[0].v_type != VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007875 {
Bram Moolenaar460ae5d2022-01-01 14:19:49 +00007876 emsg(_(e_list_or_blob_required));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007877 return;
7878 }
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007879
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007880 l = argvars[0].vval.v_list;
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00007881 if (l == NULL)
7882 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007883
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00007884 CHECK_LIST_MATERIALIZE(l);
7885 item = l->lv_first;
7886 if (argvars[2].v_type != VAR_UNKNOWN)
7887 {
7888 // Start at specified item. Use the cached index that list_find()
7889 // sets, so that a negative number also works.
7890 item = list_find(l, (long)tv_get_number_chk(&argvars[2], &error));
7891 idx = l->lv_u.mat.lv_idx;
7892 if (argvars[3].v_type != VAR_UNKNOWN)
7893 ic = (int)tv_get_bool_chk(&argvars[3], &error);
7894 if (error)
7895 item = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007896 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00007897
7898 for ( ; item != NULL; item = item->li_next, ++idx)
Yinzuo Jiang7ccd1a22024-07-04 17:20:53 +02007899 if (tv_equal(&item->li_tv, &argvars[1], ic))
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00007900 {
7901 rettv->vval.v_number = idx;
7902 break;
7903 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007904}
7905
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01007906/*
7907 * Evaluate 'expr' with the v:key and v:val arguments and return the result.
7908 * The expression is expected to return a boolean value. The caller should set
7909 * the VV_KEY and VV_VAL vim variables before calling this function.
7910 */
7911 static int
7912indexof_eval_expr(typval_T *expr)
7913{
7914 typval_T argv[3];
7915 typval_T newtv;
7916 varnumber_T found;
7917 int error = FALSE;
7918
7919 argv[0] = *get_vim_var_tv(VV_KEY);
7920 argv[1] = *get_vim_var_tv(VV_VAL);
7921 newtv.v_type = VAR_UNKNOWN;
7922
zeertzjqad0c4422023-08-17 22:15:47 +02007923 if (eval_expr_typval(expr, FALSE, argv, 2, NULL, &newtv) == FAIL)
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01007924 return FALSE;
7925
7926 found = tv_get_bool_chk(&newtv, &error);
Yegappan Lakshmanan63acae12022-08-14 12:07:11 +01007927 clear_tv(&newtv);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01007928
7929 return error ? FALSE : found;
7930}
7931
7932/*
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01007933 * Evaluate 'expr' for each byte in the Blob 'b' starting with the byte at
7934 * 'startidx' and return the index of the byte where 'expr' is TRUE. Returns
7935 * -1 if 'expr' doesn't evaluate to TRUE for any of the bytes.
7936 */
7937 static int
7938indexof_blob(blob_T *b, long startidx, typval_T *expr)
7939{
7940 long idx = 0;
7941
7942 if (b == NULL)
7943 return -1;
7944
7945 if (startidx < 0)
7946 {
7947 // negative index: index from the last byte
7948 startidx = blob_len(b) + startidx;
7949 if (startidx < 0)
7950 startidx = 0;
7951 }
7952
7953 set_vim_var_type(VV_KEY, VAR_NUMBER);
7954 set_vim_var_type(VV_VAL, VAR_NUMBER);
7955
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02007956 int called_emsg_start = called_emsg;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01007957 for (idx = startidx; idx < blob_len(b); ++idx)
7958 {
7959 set_vim_var_nr(VV_KEY, idx);
7960 set_vim_var_nr(VV_VAL, blob_get(b, idx));
7961
7962 if (indexof_eval_expr(expr))
7963 return idx;
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02007964
7965 if (called_emsg != called_emsg_start)
7966 return -1;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01007967 }
7968
7969 return -1;
7970}
7971
7972/*
7973 * Evaluate 'expr' for each item in the List 'l' starting with the item at
7974 * 'startidx' and return the index of the item where 'expr' is TRUE. Returns
7975 * -1 if 'expr' doesn't evaluate to TRUE for any of the items.
7976 */
7977 static int
7978indexof_list(list_T *l, long startidx, typval_T *expr)
7979{
7980 listitem_T *item;
7981 long idx = 0;
Yegappan Lakshmanan63acae12022-08-14 12:07:11 +01007982 int found;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01007983
7984 if (l == NULL)
7985 return -1;
7986
7987 CHECK_LIST_MATERIALIZE(l);
7988
7989 if (startidx == 0)
7990 item = l->lv_first;
7991 else
7992 {
7993 // Start at specified item. Use the cached index that list_find()
7994 // sets, so that a negative number also works.
7995 item = list_find(l, startidx);
7996 if (item != NULL)
7997 idx = l->lv_u.mat.lv_idx;
7998 }
7999
8000 set_vim_var_type(VV_KEY, VAR_NUMBER);
8001
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008002 int called_emsg_start = called_emsg;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008003 for ( ; item != NULL; item = item->li_next, ++idx)
8004 {
8005 set_vim_var_nr(VV_KEY, idx);
8006 copy_tv(&item->li_tv, get_vim_var_tv(VV_VAL));
8007
Yegappan Lakshmanan63acae12022-08-14 12:07:11 +01008008 found = indexof_eval_expr(expr);
8009 clear_tv(get_vim_var_tv(VV_VAL));
8010
8011 if (found)
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008012 return idx;
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008013
8014 if (called_emsg != called_emsg_start)
8015 return -1;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008016 }
8017
8018 return -1;
8019}
8020
8021/*
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008022 * "indexof()" function
8023 */
8024 static void
8025f_indexof(typval_T *argvars, typval_T *rettv)
8026{
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008027 long startidx = 0;
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008028 typval_T save_val;
8029 typval_T save_key;
8030 int save_did_emsg;
8031
8032 rettv->vval.v_number = -1;
8033
8034 if (check_for_list_or_blob_arg(argvars, 0) == FAIL
8035 || check_for_string_or_func_arg(argvars, 1) == FAIL
8036 || check_for_opt_dict_arg(argvars, 2) == FAIL)
8037 return;
8038
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008039 if ((argvars[1].v_type == VAR_STRING &&
8040 (argvars[1].vval.v_string == NULL
8041 || *argvars[1].vval.v_string == NUL))
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008042 || (argvars[1].v_type == VAR_FUNC
8043 && argvars[1].vval.v_partial == NULL))
8044 return;
8045
8046 if (argvars[2].v_type == VAR_DICT)
8047 startidx = dict_get_number_def(argvars[2].vval.v_dict, "startidx", 0);
8048
8049 prepare_vimvar(VV_VAL, &save_val);
8050 prepare_vimvar(VV_KEY, &save_key);
8051
8052 // We reset "did_emsg" to be able to detect whether an error occurred
8053 // during evaluation of the expression.
8054 save_did_emsg = did_emsg;
8055 did_emsg = FALSE;
8056
8057 if (argvars[0].v_type == VAR_BLOB)
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008058 rettv->vval.v_number = indexof_blob(argvars[0].vval.v_blob, startidx,
8059 &argvars[1]);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008060 else
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008061 rettv->vval.v_number = indexof_list(argvars[0].vval.v_list, startidx,
8062 &argvars[1]);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008063
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008064 restore_vimvar(VV_KEY, &save_key);
8065 restore_vimvar(VV_VAL, &save_val);
8066 did_emsg |= save_did_emsg;
8067}
8068
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008069static int inputsecret_flag = 0;
8070
8071/*
8072 * "input()" function
8073 * Also handles inputsecret() when inputsecret is set.
8074 */
8075 static void
8076f_input(typval_T *argvars, typval_T *rettv)
8077{
8078 get_user_input(argvars, rettv, FALSE, inputsecret_flag);
8079}
8080
8081/*
8082 * "inputdialog()" function
8083 */
8084 static void
8085f_inputdialog(typval_T *argvars, typval_T *rettv)
8086{
8087#if defined(FEAT_GUI_TEXTDIALOG)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008088 // Use a GUI dialog if the GUI is running and 'c' is not in 'guioptions'
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008089 if (gui.in_use && vim_strchr(p_go, GO_CONDIALOG) == NULL)
8090 {
8091 char_u *message;
8092 char_u buf[NUMBUFLEN];
8093 char_u *defstr = (char_u *)"";
8094
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008095 if (in_vim9script()
8096 && (check_for_string_arg(argvars, 0) == FAIL
8097 || check_for_opt_string_arg(argvars, 1) == FAIL
8098 || (argvars[1].v_type != VAR_UNKNOWN
8099 && check_for_opt_string_arg(argvars, 2) == FAIL)))
8100 return;
8101
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008102 message = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008103 if (argvars[1].v_type != VAR_UNKNOWN
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008104 && (defstr = tv_get_string_buf_chk(&argvars[1], buf)) != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008105 vim_strncpy(IObuff, defstr, IOSIZE - 1);
8106 else
8107 IObuff[0] = NUL;
8108 if (message != NULL && defstr != NULL
8109 && do_dialog(VIM_QUESTION, NULL, message,
8110 (char_u *)_("&OK\n&Cancel"), 1, IObuff, FALSE) == 1)
8111 rettv->vval.v_string = vim_strsave(IObuff);
8112 else
8113 {
8114 if (message != NULL && defstr != NULL
8115 && argvars[1].v_type != VAR_UNKNOWN
8116 && argvars[2].v_type != VAR_UNKNOWN)
8117 rettv->vval.v_string = vim_strsave(
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008118 tv_get_string_buf(&argvars[2], buf));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008119 else
8120 rettv->vval.v_string = NULL;
8121 }
8122 rettv->v_type = VAR_STRING;
8123 }
8124 else
8125#endif
8126 get_user_input(argvars, rettv, TRUE, inputsecret_flag);
8127}
8128
8129/*
8130 * "inputlist()" function
8131 */
8132 static void
8133f_inputlist(typval_T *argvars, typval_T *rettv)
8134{
Bram Moolenaar50985eb2020-01-27 22:09:39 +01008135 list_T *l;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008136 listitem_T *li;
8137 int selected;
8138 int mouse_used;
8139
8140#ifdef NO_CONSOLE_INPUT
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008141 // While starting up, there is no place to enter text. When running tests
8142 // with --not-a-term we assume feedkeys() will be used.
Bram Moolenaar91d348a2017-07-29 20:16:03 +02008143 if (no_console_input() && !is_not_a_term())
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008144 return;
8145#endif
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008146 if (in_vim9script() && check_for_list_arg(argvars, 0) == FAIL)
8147 return;
8148
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008149 if (argvars[0].v_type != VAR_LIST || argvars[0].vval.v_list == NULL)
8150 {
Bram Moolenaar3a846e62022-01-01 16:21:00 +00008151 semsg(_(e_argument_of_str_must_be_list), "inputlist()");
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008152 return;
8153 }
8154
8155 msg_start();
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008156 msg_row = Rows - 1; // for when 'cmdheight' > 1
8157 lines_left = Rows; // avoid more prompt
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008158 msg_scroll = TRUE;
8159 msg_clr_eos();
8160
Bram Moolenaar50985eb2020-01-27 22:09:39 +01008161 l = argvars[0].vval.v_list;
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02008162 CHECK_LIST_MATERIALIZE(l);
Bram Moolenaar00d253e2020-04-06 22:13:01 +02008163 FOR_ALL_LIST_ITEMS(l, li)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008164 {
Bram Moolenaar32526b32019-01-19 17:43:09 +01008165 msg_puts((char *)tv_get_string(&li->li_tv));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008166 msg_putchar('\n');
8167 }
8168
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008169 // Ask for choice.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008170 selected = prompt_for_number(&mouse_used);
8171 if (mouse_used)
8172 selected -= lines_left;
8173
8174 rettv->vval.v_number = selected;
8175}
8176
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008177static garray_T ga_userinput = {0, 0, sizeof(tasave_T), 4, NULL};
8178
8179/*
8180 * "inputrestore()" function
8181 */
8182 static void
8183f_inputrestore(typval_T *argvars UNUSED, typval_T *rettv)
8184{
8185 if (ga_userinput.ga_len > 0)
8186 {
8187 --ga_userinput.ga_len;
8188 restore_typeahead((tasave_T *)(ga_userinput.ga_data)
Bram Moolenaarc41badb2021-06-07 22:04:52 +02008189 + ga_userinput.ga_len, TRUE);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008190 // default return is zero == OK
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008191 }
8192 else if (p_verbose > 1)
8193 {
Bram Moolenaar32526b32019-01-19 17:43:09 +01008194 verb_msg(_("called inputrestore() more often than inputsave()"));
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008195 rettv->vval.v_number = 1; // Failed
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008196 }
8197}
8198
8199/*
8200 * "inputsave()" function
8201 */
8202 static void
8203f_inputsave(typval_T *argvars UNUSED, typval_T *rettv)
8204{
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008205 // Add an entry to the stack of typeahead storage.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008206 if (ga_grow(&ga_userinput, 1) == OK)
8207 {
8208 save_typeahead((tasave_T *)(ga_userinput.ga_data)
8209 + ga_userinput.ga_len);
8210 ++ga_userinput.ga_len;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008211 // default return is zero == OK
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008212 }
8213 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008214 rettv->vval.v_number = 1; // Failed
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008215}
8216
8217/*
8218 * "inputsecret()" function
8219 */
8220 static void
8221f_inputsecret(typval_T *argvars, typval_T *rettv)
8222{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008223 if (in_vim9script()
8224 && (check_for_string_arg(argvars, 0) == FAIL
8225 || check_for_opt_string_arg(argvars, 1) == FAIL))
8226 return;
8227
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008228 ++cmdline_star;
8229 ++inputsecret_flag;
8230 f_input(argvars, rettv);
8231 --cmdline_star;
8232 --inputsecret_flag;
8233}
8234
8235/*
Bram Moolenaar67a2deb2019-11-25 00:05:32 +01008236 * "interrupt()" function
8237 */
8238 static void
8239f_interrupt(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
8240{
8241 got_int = TRUE;
8242}
8243
8244/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008245 * "invert(expr)" function
8246 */
8247 static void
8248f_invert(typval_T *argvars, typval_T *rettv)
8249{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008250 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
8251 return;
8252
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008253 rettv->vval.v_number = ~tv_get_number_chk(&argvars[0], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008254}
8255
8256/*
Ernie Rael4c8da022023-10-11 21:35:11 +02008257 * Free resources in lval_root allocated by fill_exec_lval_root().
8258 */
8259 static void
8260free_lval_root(lval_root_T *root)
8261{
8262 if (root->lr_tv != NULL)
8263 free_tv(root->lr_tv);
8264 class_unref(root->lr_cl_exec);
8265 root->lr_tv = NULL;
8266 root->lr_cl_exec = NULL;
8267}
8268
8269/*
8270 * This is used if executing in a method, the argument string is a
Ernie Rael0f058d12023-10-14 11:25:04 +02008271 * variable/item expr/reference. It may start with a potential class/object
8272 * variable.
Ernie Rael4c8da022023-10-11 21:35:11 +02008273 *
Ernie Rael0f058d12023-10-14 11:25:04 +02008274 * Adjust "root" as needed; lr_tv may be changed or freed.
Ernie Rael4c8da022023-10-11 21:35:11 +02008275 *
8276 * Always returns OK.
8277 * Free resources and return FAIL if the root should not be used. Otherwise OK.
8278 */
8279
8280 static int
Ernie Rael0f058d12023-10-14 11:25:04 +02008281fix_variable_reference_lval_root(lval_root_T *root, char_u *name)
Ernie Rael4c8da022023-10-11 21:35:11 +02008282{
Ernie Rael4c8da022023-10-11 21:35:11 +02008283
Ernie Rael0f058d12023-10-14 11:25:04 +02008284 // Check if lr_tv is the name of an object/class reference: name start with
8285 // "this" or name is class variable. Clear lr_tv if neither.
8286 int found_member = FALSE;
Ernie Rael4c8da022023-10-11 21:35:11 +02008287 if (root->lr_tv->v_type == VAR_OBJECT)
8288 {
Ernie Rael0f058d12023-10-14 11:25:04 +02008289 if (STRNCMP("this.", name, 5) == 0 ||STRCMP("this", name) == 0)
8290 found_member = TRUE;
Ernie Rael4c8da022023-10-11 21:35:11 +02008291 }
Ernie Rael0f058d12023-10-14 11:25:04 +02008292 if (!found_member) // not object member, try class member
Ernie Rael4c8da022023-10-11 21:35:11 +02008293 {
8294 // Explicitly check if the name is a class member.
8295 // If it's not then do nothing.
Ernie Rael0f058d12023-10-14 11:25:04 +02008296 char_u *end;
Ernie Rael4c8da022023-10-11 21:35:11 +02008297 for (end = name; ASCII_ISALNUM(*end) || *end == '_'; ++end)
8298 ;
Ernie Rael0f058d12023-10-14 11:25:04 +02008299 int idx = class_member_idx(root->lr_cl_exec, name, end - name);
8300 if (idx >= 0)
Ernie Rael4c8da022023-10-11 21:35:11 +02008301 {
Ernie Rael0f058d12023-10-14 11:25:04 +02008302 // A class variable, replace lr_tv with it
8303 clear_tv(root->lr_tv);
8304 copy_tv(&root->lr_cl_exec->class_members_tv[idx], root->lr_tv);
8305 found_member = TRUE;
Ernie Rael4c8da022023-10-11 21:35:11 +02008306 }
8307 }
Ernie Rael0f058d12023-10-14 11:25:04 +02008308 if (!found_member)
Ernie Rael4c8da022023-10-11 21:35:11 +02008309 {
8310 free_tv(root->lr_tv);
8311 root->lr_tv = NULL; // Not a member variable
8312 }
Ernie Rael4c8da022023-10-11 21:35:11 +02008313 // If FAIL, then must free_lval_root(root);
8314 return OK;
8315}
8316
8317/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008318 * "islocked()" function
8319 */
8320 static void
8321f_islocked(typval_T *argvars, typval_T *rettv)
8322{
8323 lval_T lv;
8324 char_u *end;
8325 dictitem_T *di;
8326
8327 rettv->vval.v_number = -1;
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02008328
8329 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
8330 return;
8331
Ernie Rael4c8da022023-10-11 21:35:11 +02008332 char_u *name = tv_get_string(&argvars[0]);
8333#ifdef LOG_LOCKVAR
8334 ch_log(NULL, "LKVAR: f_islocked(): name: %s", name);
8335#endif
8336
8337 lval_root_T aroot; // fully initialized in fill_exec_lval_root
8338 lval_root_T *root = NULL;
8339
8340 // Set up lval_root if executing in a method.
8341 if (fill_exec_lval_root(&aroot) == OK)
8342 {
8343 // Almost always produces a valid lval_root since lr_cl_exec is used
8344 // for access verification, lr_tv may be set to NULL.
Ernie Rael0f058d12023-10-14 11:25:04 +02008345 if (fix_variable_reference_lval_root(&aroot, name) == OK)
Ernie Rael4c8da022023-10-11 21:35:11 +02008346 root = &aroot;
Ernie Rael4c8da022023-10-11 21:35:11 +02008347 }
8348
8349 lval_root_T *lval_root_save = lval_root;
8350 lval_root = root;
8351 end = get_lval(name, NULL, &lv, FALSE, FALSE,
Bram Moolenaarbd77aa92021-08-12 17:06:05 +02008352 GLV_NO_AUTOLOAD | GLV_READ_ONLY | GLV_NO_DECL,
8353 FNE_CHECK_START);
Ernie Rael4c8da022023-10-11 21:35:11 +02008354 lval_root = lval_root_save;
8355
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008356 if (end != NULL && lv.ll_name != NULL)
8357 {
8358 if (*end != NUL)
Bram Moolenaar1840a7b2021-07-13 20:32:29 +02008359 {
8360 semsg(_(lv.ll_name == lv.ll_name_end
Bram Moolenaar0bd663a2022-01-22 10:24:47 +00008361 ? e_invalid_argument_str : e_trailing_characters_str), end);
Bram Moolenaar1840a7b2021-07-13 20:32:29 +02008362 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008363 else
8364 {
8365 if (lv.ll_tv == NULL)
8366 {
Bram Moolenaar79518e22017-02-17 16:31:35 +01008367 di = find_var(lv.ll_name, NULL, TRUE);
8368 if (di != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008369 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008370 // Consider a variable locked when:
8371 // 1. the variable itself is locked
8372 // 2. the value of the variable is locked.
8373 // 3. the List or Dict value is locked.
Bram Moolenaar79518e22017-02-17 16:31:35 +01008374 rettv->vval.v_number = ((di->di_flags & DI_FLAGS_LOCK)
8375 || tv_islocked(&di->di_tv));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008376 }
8377 }
Ernie Rael4c8da022023-10-11 21:35:11 +02008378 else if (lv.ll_is_root)
8379 {
8380 rettv->vval.v_number = tv_islocked(lv.ll_tv);
8381 }
Ernie Rael9771b2a2023-10-07 22:05:40 +02008382 else if (lv.ll_object != NULL)
8383 {
8384 typval_T *tv = ((typval_T *)(lv.ll_object + 1)) + lv.ll_oi;
8385 rettv->vval.v_number = tv_islocked(tv);
8386#ifdef LOG_LOCKVAR
8387 ch_log(NULL, "LKVAR: f_islocked(): name %s (obj)", lv.ll_name);
8388#endif
8389 }
8390 else if (lv.ll_class != NULL)
8391 {
8392 typval_T *tv = &lv.ll_class->class_members_tv[lv.ll_oi];
8393 rettv->vval.v_number = tv_islocked(tv);
8394#ifdef LOG_LOCKVAR
8395 ch_log(NULL, "LKVAR: f_islocked(): name %s (cl)", lv.ll_name);
8396#endif
8397 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008398 else if (lv.ll_range)
Bram Moolenaar677658a2022-01-05 16:09:06 +00008399 emsg(_(e_range_not_allowed));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008400 else if (lv.ll_newkey != NULL)
Bram Moolenaara9fa8c52023-01-02 18:10:04 +00008401 semsg(_(e_key_not_present_in_dictionary_str), lv.ll_newkey);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008402 else if (lv.ll_list != NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008403 // List item.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008404 rettv->vval.v_number = tv_islocked(&lv.ll_li->li_tv);
8405 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008406 // Dictionary item.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008407 rettv->vval.v_number = tv_islocked(&lv.ll_di->di_tv);
8408 }
8409 }
8410
Ernie Rael4c8da022023-10-11 21:35:11 +02008411 if (root != NULL)
8412 free_lval_root(root);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008413 clear_lval(&lv);
8414}
8415
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008416/*
zeertzjqcdc83932022-09-12 13:38:41 +01008417 * "keytrans()" function
8418 */
8419 static void
8420f_keytrans(typval_T *argvars, typval_T *rettv)
8421{
8422 char_u *escaped;
8423
8424 rettv->v_type = VAR_STRING;
8425 if (check_for_string_arg(argvars, 0) == FAIL
8426 || argvars[0].vval.v_string == NULL)
8427 return;
8428 // Need to escape K_SPECIAL and CSI for mb_unescape().
8429 escaped = vim_strsave_escape_csi(argvars[0].vval.v_string);
8430 rettv->vval.v_string = str2special_save(escaped, TRUE, TRUE);
8431 vim_free(escaped);
8432}
8433
8434/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008435 * "last_buffer_nr()" function.
8436 */
8437 static void
8438f_last_buffer_nr(typval_T *argvars UNUSED, typval_T *rettv)
8439{
8440 int n = 0;
8441 buf_T *buf;
8442
Bram Moolenaar29323592016-07-24 22:04:11 +02008443 FOR_ALL_BUFFERS(buf)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008444 if (n < buf->b_fnum)
8445 n = buf->b_fnum;
8446
8447 rettv->vval.v_number = n;
8448}
8449
8450/*
8451 * "len()" function
8452 */
LemonBoy58f331a2022-04-02 21:59:06 +01008453 void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008454f_len(typval_T *argvars, typval_T *rettv)
8455{
8456 switch (argvars[0].v_type)
8457 {
8458 case VAR_STRING:
8459 case VAR_NUMBER:
8460 rettv->vval.v_number = (varnumber_T)STRLEN(
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008461 tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008462 break;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008463 case VAR_BLOB:
8464 rettv->vval.v_number = blob_len(argvars[0].vval.v_blob);
8465 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008466 case VAR_LIST:
8467 rettv->vval.v_number = list_len(argvars[0].vval.v_list);
8468 break;
8469 case VAR_DICT:
8470 rettv->vval.v_number = dict_len(argvars[0].vval.v_dict);
8471 break;
Yegappan Lakshmanand3eae7b2024-03-03 16:26:58 +01008472 case VAR_OBJECT:
8473 rettv->vval.v_number = object_len(argvars[0].vval.v_object);
8474 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008475 case VAR_UNKNOWN:
Bram Moolenaar4c683752020-04-05 21:38:23 +02008476 case VAR_ANY:
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01008477 case VAR_VOID:
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01008478 case VAR_BOOL:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008479 case VAR_SPECIAL:
8480 case VAR_FLOAT:
8481 case VAR_FUNC:
8482 case VAR_PARTIAL:
8483 case VAR_JOB:
8484 case VAR_CHANNEL:
Bram Moolenaarf18332f2021-05-07 17:55:55 +02008485 case VAR_INSTR:
Bram Moolenaar00b28d62022-12-08 15:32:33 +00008486 case VAR_CLASS:
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +02008487 case VAR_TYPEALIAS:
Bram Moolenaara6f79292022-01-04 21:30:47 +00008488 emsg(_(e_invalid_type_for_len));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008489 break;
8490 }
8491}
8492
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008493 static void
Bram Moolenaar6d721c72017-01-17 16:56:28 +01008494libcall_common(typval_T *argvars UNUSED, typval_T *rettv, int type)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008495{
8496#ifdef FEAT_LIBCALL
8497 char_u *string_in;
8498 char_u **string_result;
8499 int nr_result;
8500#endif
8501
8502 rettv->v_type = type;
8503 if (type != VAR_NUMBER)
8504 rettv->vval.v_string = NULL;
8505
8506 if (check_restricted() || check_secure())
8507 return;
8508
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02008509 if (in_vim9script()
8510 && (check_for_string_arg(argvars, 0) == FAIL
8511 || check_for_string_arg(argvars, 1) == FAIL
8512 || check_for_string_or_number_arg(argvars, 2) == FAIL))
8513 return;
8514
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008515#ifdef FEAT_LIBCALL
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008516 // The first two args must be strings, otherwise it's meaningless
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008517 if (argvars[0].v_type == VAR_STRING && argvars[1].v_type == VAR_STRING)
8518 {
8519 string_in = NULL;
8520 if (argvars[2].v_type == VAR_STRING)
8521 string_in = argvars[2].vval.v_string;
8522 if (type == VAR_NUMBER)
Bram Moolenaar87e15872021-09-02 19:53:07 +02008523 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008524 string_result = NULL;
Bram Moolenaar87e15872021-09-02 19:53:07 +02008525 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008526 else
Bram Moolenaar87e15872021-09-02 19:53:07 +02008527 {
8528 rettv->vval.v_string = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008529 string_result = &rettv->vval.v_string;
Bram Moolenaar87e15872021-09-02 19:53:07 +02008530 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008531 if (mch_libcall(argvars[0].vval.v_string,
8532 argvars[1].vval.v_string,
8533 string_in,
8534 argvars[2].vval.v_number,
8535 string_result,
8536 &nr_result) == OK
8537 && type == VAR_NUMBER)
8538 rettv->vval.v_number = nr_result;
8539 }
8540#endif
8541}
8542
8543/*
8544 * "libcall()" function
8545 */
8546 static void
8547f_libcall(typval_T *argvars, typval_T *rettv)
8548{
8549 libcall_common(argvars, rettv, VAR_STRING);
8550}
8551
8552/*
8553 * "libcallnr()" function
8554 */
8555 static void
8556f_libcallnr(typval_T *argvars, typval_T *rettv)
8557{
8558 libcall_common(argvars, rettv, VAR_NUMBER);
8559}
8560
8561/*
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008562 * "line(string, [winid])" function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008563 */
8564 static void
8565f_line(typval_T *argvars, typval_T *rettv)
8566{
8567 linenr_T lnum = 0;
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008568 pos_T *fp = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008569 int fnum;
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008570 int id;
8571 tabpage_T *tp;
8572 win_T *wp;
Bram Moolenaar18f47402022-01-06 13:24:51 +00008573 switchwin_T switchwin;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008574
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02008575 if (in_vim9script()
8576 && (check_for_string_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008577 || check_for_opt_number_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02008578 return;
8579
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008580 if (argvars[1].v_type != VAR_UNKNOWN)
8581 {
8582 // use window specified in the second argument
8583 id = (int)tv_get_number(&argvars[1]);
8584 wp = win_id2wp_tp(id, &tp);
8585 if (wp != NULL && tp != NULL)
8586 {
Bram Moolenaar18f47402022-01-06 13:24:51 +00008587 if (switch_win_noblock(&switchwin, wp, tp, TRUE) == OK)
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008588 {
John Marriott69f85c62024-10-31 10:53:43 +01008589#ifdef FEAT_DIFF
Christian Brabandt05a40e02024-10-29 20:29:04 +01008590 // in diff mode, prevent that the window scrolls
8591 // and keep the topline
8592 if (curwin->w_p_diff && switchwin.sw_curwin->w_p_diff)
8593 skip_update_topline = TRUE;
John Marriott69f85c62024-10-31 10:53:43 +01008594#endif
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008595 check_cursor();
Bram Moolenaar6f02b002021-01-10 20:22:54 +01008596 fp = var2fpos(&argvars[0], TRUE, &fnum, FALSE);
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008597 }
John Marriott69f85c62024-10-31 10:53:43 +01008598#ifdef FEAT_DIFF
Christian Brabandt05a40e02024-10-29 20:29:04 +01008599 if (curwin->w_p_diff && switchwin.sw_curwin->w_p_diff)
8600 skip_update_topline = FALSE;
John Marriott69f85c62024-10-31 10:53:43 +01008601#endif
Bram Moolenaar18f47402022-01-06 13:24:51 +00008602 restore_win_noblock(&switchwin, TRUE);
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008603 }
8604 }
8605 else
8606 // use current window
Bram Moolenaar6f02b002021-01-10 20:22:54 +01008607 fp = var2fpos(&argvars[0], TRUE, &fnum, FALSE);
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008608
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008609 if (fp != NULL)
8610 lnum = fp->lnum;
8611 rettv->vval.v_number = lnum;
8612}
8613
8614/*
8615 * "line2byte(lnum)" function
8616 */
8617 static void
8618f_line2byte(typval_T *argvars UNUSED, typval_T *rettv)
8619{
8620#ifndef FEAT_BYTEOFF
8621 rettv->vval.v_number = -1;
8622#else
8623 linenr_T lnum;
8624
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008625 if (in_vim9script() && check_for_lnum_arg(argvars, 0) == FAIL)
8626 return;
8627
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008628 lnum = tv_get_lnum(argvars);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008629 if (lnum < 1 || lnum > curbuf->b_ml.ml_line_count + 1)
8630 rettv->vval.v_number = -1;
8631 else
8632 rettv->vval.v_number = ml_find_line_or_offset(curbuf, lnum, NULL);
8633 if (rettv->vval.v_number >= 0)
8634 ++rettv->vval.v_number;
8635#endif
8636}
8637
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008638#ifdef FEAT_LUA
8639/*
8640 * "luaeval()" function
8641 */
8642 static void
8643f_luaeval(typval_T *argvars, typval_T *rettv)
8644{
8645 char_u *str;
8646 char_u buf[NUMBUFLEN];
8647
Bram Moolenaar8c62a082019-02-08 14:34:10 +01008648 if (check_restricted() || check_secure())
8649 return;
8650
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02008651 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
8652 return;
8653
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008654 str = tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008655 do_luaeval(str, argvars + 1, rettv);
8656}
8657#endif
8658
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008659typedef enum
8660{
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008661 MATCH_END, // matchend()
8662 MATCH_MATCH, // match()
8663 MATCH_STR, // matchstr()
8664 MATCH_LIST, // matchlist()
8665 MATCH_POS // matchstrpos()
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008666} matchtype_T;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008667
8668 static void
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008669find_some_match(typval_T *argvars, typval_T *rettv, matchtype_T type)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008670{
8671 char_u *str = NULL;
8672 long len = 0;
8673 char_u *expr = NULL;
8674 char_u *pat;
8675 regmatch_T regmatch;
8676 char_u patbuf[NUMBUFLEN];
8677 char_u strbuf[NUMBUFLEN];
8678 char_u *save_cpo;
8679 long start = 0;
8680 long nth = 1;
8681 colnr_T startcol = 0;
8682 int match = 0;
8683 list_T *l = NULL;
8684 listitem_T *li = NULL;
8685 long idx = 0;
8686 char_u *tofree = NULL;
8687
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008688 // Make 'cpoptions' empty, the 'l' flag should not be used here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008689 save_cpo = p_cpo;
Bram Moolenaare5a2dc82021-01-03 19:52:05 +01008690 p_cpo = empty_option;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008691
8692 rettv->vval.v_number = -1;
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008693 if (type == MATCH_LIST || type == MATCH_POS)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008694 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008695 // type MATCH_LIST: return empty list when there are no matches.
8696 // type MATCH_POS: return ["", -1, -1, -1]
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008697 if (rettv_list_alloc(rettv) == FAIL)
8698 goto theend;
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008699 if (type == MATCH_POS
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008700 && (list_append_string(rettv->vval.v_list,
8701 (char_u *)"", 0) == FAIL
8702 || list_append_number(rettv->vval.v_list,
8703 (varnumber_T)-1) == FAIL
8704 || list_append_number(rettv->vval.v_list,
8705 (varnumber_T)-1) == FAIL
8706 || list_append_number(rettv->vval.v_list,
8707 (varnumber_T)-1) == FAIL))
8708 {
8709 list_free(rettv->vval.v_list);
8710 rettv->vval.v_list = NULL;
8711 goto theend;
8712 }
8713 }
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008714 else if (type == MATCH_STR)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008715 {
8716 rettv->v_type = VAR_STRING;
8717 rettv->vval.v_string = NULL;
8718 }
8719
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02008720 if (in_vim9script()
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008721 && (check_for_string_or_list_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008722 || check_for_string_arg(argvars, 1) == FAIL
8723 || check_for_opt_number_arg(argvars, 2) == FAIL
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02008724 || (argvars[2].v_type != VAR_UNKNOWN
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008725 && check_for_opt_number_arg(argvars, 3) == FAIL)))
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02008726 goto theend;
8727
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008728 if (argvars[0].v_type == VAR_LIST)
8729 {
8730 if ((l = argvars[0].vval.v_list) == NULL)
8731 goto theend;
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02008732 CHECK_LIST_MATERIALIZE(l);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008733 li = l->lv_first;
8734 }
8735 else
8736 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008737 expr = str = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008738 len = (long)STRLEN(str);
8739 }
8740
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008741 pat = tv_get_string_buf_chk(&argvars[1], patbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008742 if (pat == NULL)
8743 goto theend;
8744
8745 if (argvars[2].v_type != VAR_UNKNOWN)
8746 {
8747 int error = FALSE;
8748
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008749 start = (long)tv_get_number_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008750 if (error)
8751 goto theend;
8752 if (l != NULL)
8753 {
8754 li = list_find(l, start);
8755 if (li == NULL)
8756 goto theend;
Bram Moolenaar0ff6aad2020-01-29 21:27:21 +01008757 idx = l->lv_u.mat.lv_idx; // use the cached index
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008758 }
8759 else
8760 {
8761 if (start < 0)
8762 start = 0;
8763 if (start > len)
8764 goto theend;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008765 // When "count" argument is there ignore matches before "start",
8766 // otherwise skip part of the string. Differs when pattern is "^"
8767 // or "\<".
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008768 if (argvars[3].v_type != VAR_UNKNOWN)
8769 startcol = start;
8770 else
8771 {
8772 str += start;
8773 len -= start;
8774 }
8775 }
8776
8777 if (argvars[3].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008778 nth = (long)tv_get_number_chk(&argvars[3], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008779 if (error)
8780 goto theend;
8781 }
8782
8783 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
8784 if (regmatch.regprog != NULL)
8785 {
8786 regmatch.rm_ic = p_ic;
8787
8788 for (;;)
8789 {
8790 if (l != NULL)
8791 {
8792 if (li == NULL)
8793 {
8794 match = FALSE;
8795 break;
8796 }
8797 vim_free(tofree);
8798 expr = str = echo_string(&li->li_tv, &tofree, strbuf, 0);
8799 if (str == NULL)
8800 break;
8801 }
8802
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +00008803 match = vim_regexec_nl(&regmatch, str, startcol);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008804
8805 if (match && --nth <= 0)
8806 break;
8807 if (l == NULL && !match)
8808 break;
8809
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008810 // Advance to just after the match.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008811 if (l != NULL)
8812 {
8813 li = li->li_next;
8814 ++idx;
8815 }
8816 else
8817 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008818 startcol = (colnr_T)(regmatch.startp[0]
8819 + (*mb_ptr2len)(regmatch.startp[0]) - str);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008820 if (startcol > (colnr_T)len
8821 || str + startcol <= regmatch.startp[0])
8822 {
8823 match = FALSE;
8824 break;
8825 }
8826 }
8827 }
8828
8829 if (match)
8830 {
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008831 if (type == MATCH_POS)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008832 {
8833 listitem_T *li1 = rettv->vval.v_list->lv_first;
8834 listitem_T *li2 = li1->li_next;
8835 listitem_T *li3 = li2->li_next;
8836 listitem_T *li4 = li3->li_next;
8837
8838 vim_free(li1->li_tv.vval.v_string);
8839 li1->li_tv.vval.v_string = vim_strnsave(regmatch.startp[0],
Bram Moolenaardf44a272020-06-07 20:49:05 +02008840 regmatch.endp[0] - regmatch.startp[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008841 li3->li_tv.vval.v_number =
8842 (varnumber_T)(regmatch.startp[0] - expr);
8843 li4->li_tv.vval.v_number =
8844 (varnumber_T)(regmatch.endp[0] - expr);
8845 if (l != NULL)
8846 li2->li_tv.vval.v_number = (varnumber_T)idx;
8847 }
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008848 else if (type == MATCH_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008849 {
8850 int i;
8851
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008852 // return list with matched string and submatches
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008853 for (i = 0; i < NSUBEXP; ++i)
8854 {
8855 if (regmatch.endp[i] == NULL)
8856 {
8857 if (list_append_string(rettv->vval.v_list,
8858 (char_u *)"", 0) == FAIL)
8859 break;
8860 }
8861 else if (list_append_string(rettv->vval.v_list,
8862 regmatch.startp[i],
8863 (int)(regmatch.endp[i] - regmatch.startp[i]))
8864 == FAIL)
8865 break;
8866 }
8867 }
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008868 else if (type == MATCH_STR)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008869 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008870 // return matched string
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008871 if (l != NULL)
8872 copy_tv(&li->li_tv, rettv);
8873 else
8874 rettv->vval.v_string = vim_strnsave(regmatch.startp[0],
Bram Moolenaardf44a272020-06-07 20:49:05 +02008875 regmatch.endp[0] - regmatch.startp[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008876 }
8877 else if (l != NULL)
8878 rettv->vval.v_number = idx;
8879 else
8880 {
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008881 if (type != MATCH_END)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008882 rettv->vval.v_number =
8883 (varnumber_T)(regmatch.startp[0] - str);
8884 else
8885 rettv->vval.v_number =
8886 (varnumber_T)(regmatch.endp[0] - str);
8887 rettv->vval.v_number += (varnumber_T)(str - expr);
8888 }
8889 }
8890 vim_regfree(regmatch.regprog);
8891 }
8892
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008893theend:
8894 if (type == MATCH_POS && l == NULL && rettv->vval.v_list != NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008895 // matchstrpos() without a list: drop the second item.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008896 listitem_remove(rettv->vval.v_list,
8897 rettv->vval.v_list->lv_first->li_next);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008898 vim_free(tofree);
8899 p_cpo = save_cpo;
8900}
8901
8902/*
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01008903 * Return all the matches in string "str" for pattern "rmp".
8904 * The matches are returned in the List "mlist".
8905 * If "submatches" is TRUE, then submatch information is also returned.
8906 * "matchbuf" is TRUE when called for matchbufline().
8907 */
8908 static int
8909get_matches_in_str(
8910 char_u *str,
8911 regmatch_T *rmp,
8912 list_T *mlist,
8913 int idx,
8914 int submatches,
8915 int matchbuf)
8916{
8917 long len = (long)STRLEN(str);
8918 int match = 0;
8919 colnr_T startidx = 0;
8920
8921 for (;;)
8922 {
8923 match = vim_regexec_nl(rmp, str, startidx);
8924 if (!match)
8925 break;
8926
8927 dict_T *d = dict_alloc();
8928 if (d == NULL)
8929 return FAIL;
8930 if (list_append_dict(mlist, d) == FAIL)
8931 return FAIL;;
8932
8933 if (dict_add_number(d, matchbuf ? "lnum" : "idx", idx) == FAIL)
8934 return FAIL;
8935
8936 if (dict_add_number(d, "byteidx",
8937 (colnr_T)(rmp->startp[0] - str)) == FAIL)
8938 return FAIL;
8939
8940 if (dict_add_string_len(d, "text", rmp->startp[0],
8941 (int)(rmp->endp[0] - rmp->startp[0])) == FAIL)
8942 return FAIL;
8943
8944 if (submatches)
8945 {
8946 list_T *sml = list_alloc();
8947 if (sml == NULL)
8948 return FAIL;
8949
8950 if (dict_add_list(d, "submatches", sml) == FAIL)
8951 return FAIL;
8952
8953 // return a list with the submatches
8954 for (int i = 1; i < NSUBEXP; ++i)
8955 {
8956 if (rmp->endp[i] == NULL)
8957 {
8958 if (list_append_string(sml, (char_u *)"", 0) == FAIL)
8959 return FAIL;
8960 }
8961 else if (list_append_string(sml, rmp->startp[i],
8962 (int)(rmp->endp[i] - rmp->startp[i])) == FAIL)
8963 return FAIL;
8964 }
8965 }
8966 startidx = (colnr_T)(rmp->endp[0] - str);
8967 if (startidx >= (colnr_T)len || str + startidx <= rmp->startp[0])
8968 break;
8969 }
8970
8971 return OK;
8972}
8973
8974/*
8975 * "matchbufline()" function
8976 */
8977 static void
8978f_matchbufline(typval_T *argvars, typval_T *rettv)
8979{
8980 list_T *retlist = NULL;
8981 char_u *save_cpo;
8982 char_u patbuf[NUMBUFLEN];
8983 regmatch_T regmatch;
8984
8985 rettv->vval.v_number = -1;
8986 if (rettv_list_alloc(rettv) != OK)
8987 return;
8988 retlist = rettv->vval.v_list;
8989
8990 if (check_for_buffer_arg(argvars, 0) == FAIL
8991 || check_for_string_arg(argvars, 1) == FAIL
8992 || check_for_lnum_arg(argvars, 2) == FAIL
8993 || check_for_lnum_arg(argvars, 3) == FAIL
8994 || check_for_opt_dict_arg(argvars, 4) == FAIL)
8995 return;
8996
8997 int prev_did_emsg = did_emsg;
8998 buf_T *buf = tv_get_buf(&argvars[0], FALSE);
8999 if (buf == NULL)
9000 {
9001 if (did_emsg == prev_did_emsg)
9002 semsg(_(e_invalid_buffer_name_str), tv_get_string(&argvars[0]));
9003 return;
9004 }
9005 if (buf->b_ml.ml_mfp == NULL)
9006 {
9007 emsg(_(e_buffer_is_not_loaded));
9008 return;
9009 }
9010
9011 char_u *pat = tv_get_string_buf(&argvars[1], patbuf);
9012
9013 int did_emsg_before = did_emsg;
9014 linenr_T slnum = tv_get_lnum_buf(&argvars[2], buf);
9015 if (did_emsg > did_emsg_before)
9016 return;
9017 if (slnum < 1)
9018 {
9019 semsg(_(e_invalid_value_for_argument_str), "lnum");
9020 return;
9021 }
9022
9023 linenr_T elnum = tv_get_lnum_buf(&argvars[3], buf);
9024 if (did_emsg > did_emsg_before)
9025 return;
9026 if (elnum < 1 || elnum < slnum)
9027 {
9028 semsg(_(e_invalid_value_for_argument_str), "end_lnum");
9029 return;
9030 }
9031
9032 if (elnum > buf->b_ml.ml_line_count)
9033 elnum = buf->b_ml.ml_line_count;
9034
9035 int submatches = FALSE;
9036 if (argvars[4].v_type != VAR_UNKNOWN)
9037 {
9038 dict_T *d = argvars[4].vval.v_dict;
9039 if (d != NULL)
9040 {
9041 dictitem_T *di = dict_find(d, (char_u *)"submatches", -1);
9042 if (di != NULL)
9043 {
9044 if (di->di_tv.v_type != VAR_BOOL)
9045 {
9046 semsg(_(e_invalid_value_for_argument_str), "submatches");
9047 return;
9048 }
9049 submatches = tv_get_bool(&di->di_tv);
9050 }
9051 }
9052 }
9053
9054 // Make 'cpoptions' empty, the 'l' flag should not be used here.
9055 save_cpo = p_cpo;
9056 p_cpo = empty_option;
9057
9058 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
9059 if (regmatch.regprog == NULL)
9060 goto theend;
9061 regmatch.rm_ic = p_ic;
9062
9063 while (slnum <= elnum)
9064 {
9065 char_u *str = ml_get_buf(buf, slnum, FALSE);
9066 if (get_matches_in_str(str, &regmatch, retlist, slnum, submatches,
9067 TRUE) == FAIL)
9068 goto cleanup;
9069 slnum++;
9070 }
9071
9072cleanup:
9073 vim_regfree(regmatch.regprog);
9074
9075theend:
9076 p_cpo = save_cpo;
9077}
9078
9079/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009080 * "match()" function
9081 */
9082 static void
9083f_match(typval_T *argvars, typval_T *rettv)
9084{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009085 find_some_match(argvars, rettv, MATCH_MATCH);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009086}
9087
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009088/*
9089 * "matchend()" function
9090 */
9091 static void
9092f_matchend(typval_T *argvars, typval_T *rettv)
9093{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009094 find_some_match(argvars, rettv, MATCH_END);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009095}
9096
9097/*
9098 * "matchlist()" function
9099 */
9100 static void
9101f_matchlist(typval_T *argvars, typval_T *rettv)
9102{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009103 find_some_match(argvars, rettv, MATCH_LIST);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009104}
9105
9106/*
9107 * "matchstr()" function
9108 */
9109 static void
9110f_matchstr(typval_T *argvars, typval_T *rettv)
9111{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009112 find_some_match(argvars, rettv, MATCH_STR);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009113}
9114
9115/*
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01009116 * "matchstrlist()" function
9117 */
9118 static void
9119f_matchstrlist(typval_T *argvars, typval_T *rettv)
9120{
9121 list_T *retlist = NULL;
9122 char_u *save_cpo;
9123 list_T *l = NULL;
9124 listitem_T *li = NULL;
9125 char_u patbuf[NUMBUFLEN];
9126 regmatch_T regmatch;
9127
9128 rettv->vval.v_number = -1;
9129 if (rettv_list_alloc(rettv) != OK)
9130 return;
9131 retlist = rettv->vval.v_list;
9132
9133 if (check_for_list_arg(argvars, 0) == FAIL
9134 || check_for_string_arg(argvars, 1) == FAIL
9135 || check_for_opt_dict_arg(argvars, 2) == FAIL)
9136 return;
9137
9138 if ((l = argvars[0].vval.v_list) == NULL)
9139 return;
9140
9141 char_u *pat = tv_get_string_buf_chk(&argvars[1], patbuf);
9142 if (pat == NULL)
9143 return;
9144
9145 // Make 'cpoptions' empty, the 'l' flag should not be used here.
9146 save_cpo = p_cpo;
9147 p_cpo = empty_option;
9148
9149 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
9150 if (regmatch.regprog == NULL)
9151 goto theend;
9152 regmatch.rm_ic = p_ic;
9153
9154 int submatches = FALSE;
9155 if (argvars[2].v_type != VAR_UNKNOWN)
9156 {
9157 dict_T *d = argvars[2].vval.v_dict;
9158 if (d != NULL)
9159 {
9160 dictitem_T *di = dict_find(d, (char_u *)"submatches", -1);
9161 if (di != NULL)
9162 {
9163 if (di->di_tv.v_type != VAR_BOOL)
9164 {
9165 semsg(_(e_invalid_value_for_argument_str), "submatches");
9166 goto cleanup;
9167 }
9168 submatches = tv_get_bool(&di->di_tv);
9169 }
9170 }
9171 }
9172
9173 int idx = 0;
9174 CHECK_LIST_MATERIALIZE(l);
9175 FOR_ALL_LIST_ITEMS(l, li)
9176 {
9177 if (li->li_tv.v_type == VAR_STRING && li->li_tv.vval.v_string != NULL)
9178 {
9179 char_u *str = li->li_tv.vval.v_string;
9180 if (get_matches_in_str(str, &regmatch, retlist, idx, submatches,
9181 FALSE) == FAIL)
9182 goto cleanup;
9183 }
9184 idx++;
9185 }
9186
9187cleanup:
9188 vim_regfree(regmatch.regprog);
9189
9190theend:
9191 p_cpo = save_cpo;
9192}
9193
9194/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009195 * "matchstrpos()" function
9196 */
9197 static void
9198f_matchstrpos(typval_T *argvars, typval_T *rettv)
9199{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009200 find_some_match(argvars, rettv, MATCH_POS);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009201}
9202
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009203 static void
9204max_min(typval_T *argvars, typval_T *rettv, int domax)
9205{
9206 varnumber_T n = 0;
9207 varnumber_T i;
9208 int error = FALSE;
9209
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009210 if (in_vim9script() && check_for_list_or_dict_arg(argvars, 0) == FAIL)
9211 return;
9212
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009213 if (argvars[0].v_type == VAR_LIST)
9214 {
9215 list_T *l;
9216 listitem_T *li;
9217
9218 l = argvars[0].vval.v_list;
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009219 if (l != NULL && l->lv_len > 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009220 {
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009221 if (l->lv_first == &range_list_item)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009222 {
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009223 if ((l->lv_u.nonmat.lv_stride > 0) ^ domax)
9224 n = l->lv_u.nonmat.lv_start;
9225 else
=?UTF-8?q?Dundar=20G=C3=B6c?=d5cec1f2022-01-29 15:19:23 +00009226 n = l->lv_u.nonmat.lv_start + ((varnumber_T)l->lv_len - 1)
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009227 * l->lv_u.nonmat.lv_stride;
9228 }
9229 else
9230 {
9231 li = l->lv_first;
9232 if (li != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009233 {
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009234 n = tv_get_number_chk(&li->li_tv, &error);
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009235 if (error)
9236 return; // type error; errmsg already given
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009237 for (;;)
9238 {
9239 li = li->li_next;
9240 if (li == NULL)
9241 break;
9242 i = tv_get_number_chk(&li->li_tv, &error);
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009243 if (error)
9244 return; // type error; errmsg already given
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009245 if (domax ? i > n : i < n)
9246 n = i;
9247 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009248 }
9249 }
9250 }
9251 }
9252 else if (argvars[0].v_type == VAR_DICT)
9253 {
9254 dict_T *d;
9255 int first = TRUE;
9256 hashitem_T *hi;
9257 int todo;
9258
9259 d = argvars[0].vval.v_dict;
9260 if (d != NULL)
9261 {
9262 todo = (int)d->dv_hashtab.ht_used;
Yegappan Lakshmanan14113fd2023-03-07 17:13:51 +00009263 FOR_ALL_HASHTAB_ITEMS(&d->dv_hashtab, hi, todo)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009264 {
9265 if (!HASHITEM_EMPTY(hi))
9266 {
9267 --todo;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009268 i = tv_get_number_chk(&HI2DI(hi)->di_tv, &error);
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009269 if (error)
9270 return; // type error; errmsg already given
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009271 if (first)
9272 {
9273 n = i;
9274 first = FALSE;
9275 }
9276 else if (domax ? i > n : i < n)
9277 n = i;
9278 }
9279 }
9280 }
9281 }
9282 else
Bram Moolenaar460ae5d2022-01-01 14:19:49 +00009283 semsg(_(e_argument_of_str_must_be_list_or_dictionary), domax ? "max()" : "min()");
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009284
9285 rettv->vval.v_number = n;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009286}
9287
9288/*
9289 * "max()" function
9290 */
9291 static void
9292f_max(typval_T *argvars, typval_T *rettv)
9293{
9294 max_min(argvars, rettv, TRUE);
9295}
9296
9297/*
9298 * "min()" function
9299 */
9300 static void
9301f_min(typval_T *argvars, typval_T *rettv)
9302{
9303 max_min(argvars, rettv, FALSE);
9304}
9305
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009306#if defined(FEAT_MZSCHEME) || defined(PROTO)
9307/*
9308 * "mzeval()" function
9309 */
9310 static void
9311f_mzeval(typval_T *argvars, typval_T *rettv)
9312{
9313 char_u *str;
9314 char_u buf[NUMBUFLEN];
9315
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009316 if (check_restricted() || check_secure())
9317 return;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009318
9319 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
9320 return;
9321
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009322 str = tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009323 do_mzeval(str, rettv);
9324}
9325
9326 void
9327mzscheme_call_vim(char_u *name, typval_T *args, typval_T *rettv)
9328{
9329 typval_T argvars[3];
9330
9331 argvars[0].v_type = VAR_STRING;
9332 argvars[0].vval.v_string = name;
9333 copy_tv(args, &argvars[1]);
9334 argvars[2].v_type = VAR_UNKNOWN;
9335 f_call(argvars, rettv);
9336 clear_tv(&argvars[1]);
9337}
9338#endif
9339
9340/*
9341 * "nextnonblank()" function
9342 */
9343 static void
9344f_nextnonblank(typval_T *argvars, typval_T *rettv)
9345{
9346 linenr_T lnum;
9347
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009348 if (in_vim9script() && check_for_lnum_arg(argvars, 0) == FAIL)
9349 return;
9350
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009351 for (lnum = tv_get_lnum(argvars); ; ++lnum)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009352 {
9353 if (lnum < 0 || lnum > curbuf->b_ml.ml_line_count)
9354 {
9355 lnum = 0;
9356 break;
9357 }
9358 if (*skipwhite(ml_get(lnum)) != NUL)
9359 break;
9360 }
9361 rettv->vval.v_number = lnum;
9362}
9363
Christ van Willegenc0786752025-02-01 15:42:16 +01009364
9365/*
9366 * "ngettext()" function
9367 */
9368 static void
9369f_ngettext(typval_T *argvars, typval_T *rettv)
9370{
9371#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
9372 char *prev = NULL;
9373#endif
9374
9375 if (check_for_nonempty_string_arg(argvars, 0) == FAIL
9376 || check_for_nonempty_string_arg(argvars, 1) == FAIL
9377 || check_for_number_arg(argvars, 2) == FAIL
9378 || check_for_opt_string_arg(argvars, 3) == FAIL)
9379 return;
9380
9381 rettv->v_type = VAR_STRING;
9382
9383 if (argvars[3].v_type == VAR_STRING &&
9384 argvars[3].vval.v_string != NULL &&
9385 *(argvars[3].vval.v_string) != NUL)
9386 {
9387#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
9388 prev = bind_textdomain_codeset((const char *)argvars[3].vval.v_string, (char *)p_enc);
9389#endif
9390
9391#if defined(HAVE_DNGETTEXT)
9392 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));
9393#else
9394 textdomain((const char *)argvars[3].vval.v_string);
9395 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));
9396 textdomain(VIMPACKAGE);
9397#endif
9398
9399#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
9400 if (prev != NULL)
9401 bind_textdomain_codeset((const char *)argvars[3].vval.v_string, prev);
9402#endif
9403 }
9404 else
9405 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));
9406}
9407
9408
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009409/*
9410 * "nr2char()" function
9411 */
9412 static void
9413f_nr2char(typval_T *argvars, typval_T *rettv)
9414{
9415 char_u buf[NUMBUFLEN];
9416
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02009417 if (in_vim9script()
9418 && (check_for_number_arg(argvars, 0) == FAIL
9419 || check_for_opt_bool_arg(argvars, 1) == FAIL))
9420 return;
9421
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009422 if (has_mbyte)
9423 {
9424 int utf8 = 0;
9425
9426 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaared6a4302020-09-05 20:29:41 +02009427 utf8 = (int)tv_get_bool_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009428 if (utf8)
Bram Moolenaarbdace832019-03-02 10:13:42 +01009429 buf[utf_char2bytes((int)tv_get_number(&argvars[0]), buf)] = NUL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009430 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009431 buf[(*mb_char2bytes)((int)tv_get_number(&argvars[0]), buf)] = NUL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009432 }
9433 else
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009434 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009435 buf[0] = (char_u)tv_get_number(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009436 buf[1] = NUL;
9437 }
9438 rettv->v_type = VAR_STRING;
9439 rettv->vval.v_string = vim_strsave(buf);
9440}
9441
9442/*
9443 * "or(expr, expr)" function
9444 */
9445 static void
9446f_or(typval_T *argvars, typval_T *rettv)
9447{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009448 if (in_vim9script()
9449 && (check_for_number_arg(argvars, 0) == FAIL
9450 || check_for_number_arg(argvars, 1) == FAIL))
9451 return;
9452
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009453 rettv->vval.v_number = tv_get_number_chk(&argvars[0], NULL)
9454 | tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009455}
9456
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009457#ifdef FEAT_PERL
9458/*
9459 * "perleval()" function
9460 */
9461 static void
9462f_perleval(typval_T *argvars, typval_T *rettv)
9463{
9464 char_u *str;
9465 char_u buf[NUMBUFLEN];
9466
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009467 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
9468 return;
9469
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009470 str = tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009471 do_perleval(str, rettv);
9472}
9473#endif
9474
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009475/*
9476 * "prevnonblank()" function
9477 */
9478 static void
9479f_prevnonblank(typval_T *argvars, typval_T *rettv)
9480{
9481 linenr_T lnum;
9482
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009483 if (in_vim9script() && check_for_lnum_arg(argvars, 0) == FAIL)
9484 return;
9485
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009486 lnum = tv_get_lnum(argvars);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009487 if (lnum < 1 || lnum > curbuf->b_ml.ml_line_count)
9488 lnum = 0;
9489 else
9490 while (lnum >= 1 && *skipwhite(ml_get(lnum)) == NUL)
9491 --lnum;
9492 rettv->vval.v_number = lnum;
9493}
9494
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009495// This dummy va_list is here because:
9496// - passing a NULL pointer doesn't work when va_list isn't a pointer
9497// - locally in the function results in a "used before set" warning
9498// - using va_start() to initialize it gives "function with fixed args" error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009499static va_list ap;
9500
9501/*
9502 * "printf()" function
9503 */
9504 static void
9505f_printf(typval_T *argvars, typval_T *rettv)
9506{
9507 char_u buf[NUMBUFLEN];
9508 int len;
9509 char_u *s;
9510 int saved_did_emsg = did_emsg;
9511 char *fmt;
9512
9513 rettv->v_type = VAR_STRING;
9514 rettv->vval.v_string = NULL;
9515
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02009516 if (in_vim9script() && check_for_string_or_number_arg(argvars, 0) == FAIL)
9517 return;
9518
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009519 // Get the required length, allocate the buffer and do it for real.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009520 did_emsg = FALSE;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009521 fmt = (char *)tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar8327d1d2017-07-11 22:34:51 +02009522 len = vim_vsnprintf_typval(NULL, 0, fmt, ap, argvars + 1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009523 if (!did_emsg)
9524 {
9525 s = alloc(len + 1);
9526 if (s != NULL)
9527 {
9528 rettv->vval.v_string = s;
Bram Moolenaar8327d1d2017-07-11 22:34:51 +02009529 (void)vim_vsnprintf_typval((char *)s, len + 1, fmt,
9530 ap, argvars + 1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009531 }
9532 }
9533 did_emsg |= saved_did_emsg;
9534}
9535
9536/*
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009537 * "pum_getpos()" function
9538 */
9539 static void
9540f_pum_getpos(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
9541{
Bram Moolenaar93a10962022-06-16 11:42:09 +01009542 if (rettv_dict_alloc(rettv) == FAIL)
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009543 return;
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009544 pum_set_event_info(rettv->vval.v_dict);
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009545}
9546
9547/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009548 * "pumvisible()" function
9549 */
9550 static void
9551f_pumvisible(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
9552{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009553 if (pum_visible())
9554 rettv->vval.v_number = 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009555}
9556
9557#ifdef FEAT_PYTHON3
9558/*
9559 * "py3eval()" function
9560 */
9561 static void
9562f_py3eval(typval_T *argvars, typval_T *rettv)
9563{
9564 char_u *str;
9565 char_u buf[NUMBUFLEN];
Ben Jacksonea19e782024-11-06 21:50:05 +01009566 dict_T *locals;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009567
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009568 if (check_restricted() || check_secure())
9569 return;
9570
Ben Jacksonea19e782024-11-06 21:50:05 +01009571 if (in_vim9script()
9572 && (check_for_string_arg(argvars, 0) == FAIL
9573 || check_for_opt_dict_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009574 return;
9575
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009576 if (p_pyx == 0)
9577 p_pyx = 3;
9578
Ben Jacksonea19e782024-11-06 21:50:05 +01009579 if (argvars[1].v_type == VAR_DICT)
9580 {
9581 locals = argvars[1].vval.v_dict;
9582 }
9583 else if (argvars[1].v_type != VAR_UNKNOWN)
9584 {
9585 emsg(_(e_dictionary_required));
9586 return;
9587 }
9588 else
9589 {
9590 locals = NULL;
9591 }
9592
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009593 str = tv_get_string_buf(&argvars[0], buf);
Ben Jacksonea19e782024-11-06 21:50:05 +01009594 do_py3eval(str, locals, rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009595}
9596#endif
9597
9598#ifdef FEAT_PYTHON
9599/*
9600 * "pyeval()" function
9601 */
9602 static void
9603f_pyeval(typval_T *argvars, typval_T *rettv)
9604{
9605 char_u *str;
9606 char_u buf[NUMBUFLEN];
Ben Jacksonea19e782024-11-06 21:50:05 +01009607 dict_T *locals;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009608
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009609 if (check_restricted() || check_secure())
9610 return;
9611
Ben Jacksonea19e782024-11-06 21:50:05 +01009612 if (in_vim9script() && (
9613 check_for_string_arg(argvars, 0) == FAIL ||
9614 check_for_opt_dict_arg(argvars, 1) == FAIL ) )
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009615 return;
9616
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009617 if (p_pyx == 0)
9618 p_pyx = 2;
9619
Ben Jacksonea19e782024-11-06 21:50:05 +01009620 if (argvars[1].v_type == VAR_DICT)
9621 {
9622 locals = argvars[1].vval.v_dict;
9623 }
9624 else if (argvars[1].v_type != VAR_UNKNOWN)
9625 {
9626 emsg( "Invalid argument: must be dict" );
9627 return;
9628 }
9629 else
9630 {
9631 locals = NULL;
9632 }
9633
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009634 str = tv_get_string_buf(&argvars[0], buf);
Ben Jacksonea19e782024-11-06 21:50:05 +01009635 do_pyeval(str, locals, rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009636}
9637#endif
9638
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009639#if defined(FEAT_PYTHON) || defined(FEAT_PYTHON3)
9640/*
9641 * "pyxeval()" function
9642 */
9643 static void
9644f_pyxeval(typval_T *argvars, typval_T *rettv)
9645{
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009646 if (check_restricted() || check_secure())
9647 return;
9648
Ben Jacksonea19e782024-11-06 21:50:05 +01009649 if (in_vim9script()
9650 && (check_for_string_arg(argvars, 0) == FAIL
9651 || check_for_opt_dict_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009652 return;
9653
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009654# if defined(FEAT_PYTHON) && defined(FEAT_PYTHON3)
9655 init_pyxversion();
9656 if (p_pyx == 2)
9657 f_pyeval(argvars, rettv);
9658 else
9659 f_py3eval(argvars, rettv);
9660# elif defined(FEAT_PYTHON)
9661 f_pyeval(argvars, rettv);
9662# elif defined(FEAT_PYTHON3)
9663 f_py3eval(argvars, rettv);
9664# endif
9665}
9666#endif
9667
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009668static UINT32_T srand_seed_for_testing = 0;
9669static int srand_seed_for_testing_is_used = FALSE;
9670
9671 static void
9672f_test_srand_seed(typval_T *argvars, typval_T *rettv UNUSED)
9673{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009674 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
9675 return;
9676
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009677 if (argvars[0].v_type == VAR_UNKNOWN)
Bram Moolenaar7633fe52020-06-22 19:10:56 +02009678 srand_seed_for_testing_is_used = FALSE;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009679 else
9680 {
Bram Moolenaar7633fe52020-06-22 19:10:56 +02009681 srand_seed_for_testing = (UINT32_T)tv_get_number(&argvars[0]);
9682 srand_seed_for_testing_is_used = TRUE;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009683 }
9684}
9685
9686 static void
9687init_srand(UINT32_T *x)
9688{
LemonBoy9987fe82024-07-04 13:20:49 +02009689 struct {
9690 union {
9691 UINT32_T number;
9692 char_u bytes[sizeof(UINT32_T)];
9693 } contents;
9694 } buf;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009695
9696 if (srand_seed_for_testing_is_used)
9697 {
Bram Moolenaar7633fe52020-06-22 19:10:56 +02009698 *x = srand_seed_for_testing;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009699 return;
9700 }
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009701
LemonBoy9987fe82024-07-04 13:20:49 +02009702 if (mch_get_random(buf.contents.bytes, sizeof(buf.contents.bytes)) == OK)
9703 {
9704 *x = buf.contents.number;
9705 return;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009706 }
LemonBoy9987fe82024-07-04 13:20:49 +02009707
9708 // The system's random number generator doesn't work, fall back to:
9709 // - randombytes_random()
9710 // - reltime() or time()
9711 // - XOR with process ID
9712#if defined(FEAT_SODIUM)
9713 if (crypt_sodium_init() >= 0)
9714 *x = crypt_sodium_randombytes_random();
9715 else
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009716#endif
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009717 {
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009718#if defined(FEAT_RELTIME)
LemonBoy9987fe82024-07-04 13:20:49 +02009719 proftime_T res;
9720 profile_start(&res);
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009721# if defined(MSWIN)
LemonBoy9987fe82024-07-04 13:20:49 +02009722 *x = (UINT32_T)res.LowPart;
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009723# else
LemonBoy9987fe82024-07-04 13:20:49 +02009724 *x = (UINT32_T)res.tv_fsec;
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009725# endif
9726#else
LemonBoy9987fe82024-07-04 13:20:49 +02009727 *x = vim_time();
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009728#endif
LemonBoy9987fe82024-07-04 13:20:49 +02009729 *x ^= mch_get_pid();
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009730 }
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009731}
9732
kylo252ae6f1d82022-02-16 19:24:07 +00009733#define ROTL(x, k) (((x) << (k)) | ((x) >> (32 - (k))))
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009734#define SPLITMIX32(x, z) ( \
kylo252ae6f1d82022-02-16 19:24:07 +00009735 (z) = ((x) += 0x9e3779b9), \
9736 (z) = ((z) ^ ((z) >> 16)) * 0x85ebca6b, \
9737 (z) = ((z) ^ ((z) >> 13)) * 0xc2b2ae35, \
9738 (z) ^ ((z) >> 16) \
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009739 )
9740#define SHUFFLE_XOSHIRO128STARSTAR(x, y, z, w) \
kylo252ae6f1d82022-02-16 19:24:07 +00009741 result = ROTL((y) * 5, 7) * 9; \
9742 t = (y) << 9; \
9743 (z) ^= (x); \
9744 (w) ^= (y); \
9745 (y) ^= (z), (x) ^= (w); \
9746 (z) ^= t; \
9747 (w) = ROTL(w, 11);
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009748
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009749/*
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009750 * "rand()" function
9751 */
9752 static void
9753f_rand(typval_T *argvars, typval_T *rettv)
9754{
9755 list_T *l = NULL;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009756 static UINT32_T gx, gy, gz, gw;
9757 static int initialized = FALSE;
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009758 listitem_T *lx, *ly, *lz, *lw;
Bram Moolenaar0fd797e2020-11-05 20:46:32 +01009759 UINT32_T x = 0, y, z, w, t, result;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009760
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009761 if (in_vim9script() && check_for_opt_list_arg(argvars, 0) == FAIL)
9762 return;
9763
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009764 if (argvars[0].v_type == VAR_UNKNOWN)
9765 {
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009766 // When no argument is given use the global seed list.
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009767 if (initialized == FALSE)
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009768 {
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009769 // Initialize the global seed list.
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009770 init_srand(&x);
9771
9772 gx = SPLITMIX32(x, z);
9773 gy = SPLITMIX32(x, z);
9774 gz = SPLITMIX32(x, z);
9775 gw = SPLITMIX32(x, z);
9776 initialized = TRUE;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009777 }
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009778
9779 SHUFFLE_XOSHIRO128STARSTAR(gx, gy, gz, gw);
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009780 }
9781 else if (argvars[0].v_type == VAR_LIST)
9782 {
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009783 l = argvars[0].vval.v_list;
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009784 if (l == NULL || list_len(l) != 4)
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009785 goto theend;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009786
9787 lx = list_find(l, 0L);
9788 ly = list_find(l, 1L);
9789 lz = list_find(l, 2L);
9790 lw = list_find(l, 3L);
9791 if (lx->li_tv.v_type != VAR_NUMBER) goto theend;
9792 if (ly->li_tv.v_type != VAR_NUMBER) goto theend;
9793 if (lz->li_tv.v_type != VAR_NUMBER) goto theend;
9794 if (lw->li_tv.v_type != VAR_NUMBER) goto theend;
9795 x = (UINT32_T)lx->li_tv.vval.v_number;
9796 y = (UINT32_T)ly->li_tv.vval.v_number;
9797 z = (UINT32_T)lz->li_tv.vval.v_number;
9798 w = (UINT32_T)lw->li_tv.vval.v_number;
9799
9800 SHUFFLE_XOSHIRO128STARSTAR(x, y, z, w);
9801
9802 lx->li_tv.vval.v_number = (varnumber_T)x;
9803 ly->li_tv.vval.v_number = (varnumber_T)y;
9804 lz->li_tv.vval.v_number = (varnumber_T)z;
9805 lw->li_tv.vval.v_number = (varnumber_T)w;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009806 }
9807 else
9808 goto theend;
9809
9810 rettv->v_type = VAR_NUMBER;
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009811 rettv->vval.v_number = (varnumber_T)result;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009812 return;
9813
9814theend:
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00009815 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[0]));
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009816 rettv->v_type = VAR_NUMBER;
9817 rettv->vval.v_number = -1;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009818}
9819
9820/*
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009821 * "srand()" function
9822 */
9823 static void
9824f_srand(typval_T *argvars, typval_T *rettv)
9825{
9826 UINT32_T x = 0, z;
9827
9828 if (rettv_list_alloc(rettv) == FAIL)
9829 return;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009830
9831 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
9832 return;
9833
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009834 if (argvars[0].v_type == VAR_UNKNOWN)
9835 {
9836 init_srand(&x);
9837 }
9838 else
9839 {
9840 int error = FALSE;
9841
9842 x = (UINT32_T)tv_get_number_chk(&argvars[0], &error);
9843 if (error)
9844 return;
9845 }
9846
9847 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
9848 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
9849 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
9850 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
9851}
9852
9853#undef ROTL
9854#undef SPLITMIX32
9855#undef SHUFFLE_XOSHIRO128STARSTAR
9856
9857/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009858 * "range()" function
9859 */
9860 static void
9861f_range(typval_T *argvars, typval_T *rettv)
9862{
9863 varnumber_T start;
9864 varnumber_T end;
9865 varnumber_T stride = 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009866 int error = FALSE;
9867
Bram Moolenaar93a10962022-06-16 11:42:09 +01009868 if (rettv_list_alloc(rettv) == FAIL)
Yegappan Lakshmananca195cc2022-06-14 13:42:26 +01009869 return;
9870
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009871 if (in_vim9script()
9872 && (check_for_number_arg(argvars, 0) == FAIL
9873 || check_for_opt_number_arg(argvars, 1) == FAIL
9874 || (argvars[1].v_type != VAR_UNKNOWN
9875 && check_for_opt_number_arg(argvars, 2) == FAIL)))
9876 return;
9877
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009878 start = tv_get_number_chk(&argvars[0], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009879 if (argvars[1].v_type == VAR_UNKNOWN)
9880 {
9881 end = start - 1;
9882 start = 0;
9883 }
9884 else
9885 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009886 end = tv_get_number_chk(&argvars[1], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009887 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009888 stride = tv_get_number_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009889 }
9890
9891 if (error)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009892 return; // type error; errmsg already given
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009893 if (stride == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009894 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00009895 emsg(_(e_stride_is_zero));
9896 return;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01009897 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00009898 if (stride > 0 ? end + 1 < start : end - 1 > start)
9899 {
9900 emsg(_(e_start_past_end));
9901 return;
9902 }
9903
9904 list_T *list = rettv->vval.v_list;
9905
9906 // Create a non-materialized list. This is much more efficient and
9907 // works with ":for". If used otherwise CHECK_LIST_MATERIALIZE() must
9908 // be called.
9909 list->lv_first = &range_list_item;
9910 list->lv_u.nonmat.lv_start = start;
9911 list->lv_u.nonmat.lv_end = end;
9912 list->lv_u.nonmat.lv_stride = stride;
Christian Brabandtdf63da92023-11-23 20:14:28 +01009913 if (stride > 0 ? end < start : end > start)
9914 list->lv_len = 0;
9915 else
9916 list->lv_len = (end - start) / stride + 1;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01009917}
9918
9919/*
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02009920 * Materialize "list".
9921 * Do not call directly, use CHECK_LIST_MATERIALIZE()
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01009922 */
9923 void
9924range_list_materialize(list_T *list)
9925{
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02009926 varnumber_T start = list->lv_u.nonmat.lv_start;
9927 varnumber_T end = list->lv_u.nonmat.lv_end;
Bram Moolenaar70c43d82022-01-26 21:01:15 +00009928 int stride = list->lv_u.nonmat.lv_stride;
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02009929 varnumber_T i;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01009930
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02009931 list->lv_first = NULL;
9932 list->lv_u.mat.lv_last = NULL;
9933 list->lv_len = 0;
9934 list->lv_u.mat.lv_idx_item = NULL;
9935 for (i = start; stride > 0 ? i <= end : i >= end; i += stride)
Bram Moolenaar70c43d82022-01-26 21:01:15 +00009936 {
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +00009937 if (list_append_number(list, i) == FAIL)
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02009938 break;
Bram Moolenaar70c43d82022-01-26 21:01:15 +00009939 if (list->lv_lock & VAR_ITEMS_LOCKED)
9940 list->lv_u.mat.lv_last->li_tv.v_lock = VAR_LOCKED;
9941 }
9942 list->lv_lock &= ~VAR_ITEMS_LOCKED;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009943}
9944
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009945/*
9946 * "getreginfo()" function
9947 */
9948 static void
9949f_getreginfo(typval_T *argvars, typval_T *rettv)
9950{
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009951 int regname;
9952 char_u buf[NUMBUFLEN + 2];
9953 long reglen = 0;
9954 dict_T *dict;
9955 list_T *list;
9956
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009957 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
9958 return;
9959
zeertzjqd3f00f52021-12-24 12:02:43 +00009960 regname = getreg_get_regname(argvars);
9961 if (regname == 0)
9962 return;
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009963
zeertzjqd3f00f52021-12-24 12:02:43 +00009964 if (regname == '@')
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009965 regname = '"';
9966
9967 if (rettv_dict_alloc(rettv) == FAIL)
9968 return;
9969 dict = rettv->vval.v_dict;
9970
9971 list = (list_T *)get_reg_contents(regname, GREG_EXPR_SRC | GREG_LIST);
9972 if (list == NULL)
9973 return;
Bram Moolenaar91639192020-06-29 19:55:58 +02009974 (void)dict_add_list(dict, "regcontents", list);
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009975
9976 buf[0] = NUL;
9977 buf[1] = NUL;
9978 switch (get_reg_type(regname, &reglen))
9979 {
9980 case MLINE: buf[0] = 'V'; break;
9981 case MCHAR: buf[0] = 'v'; break;
9982 case MBLOCK:
9983 vim_snprintf((char *)buf, sizeof(buf), "%c%ld", Ctrl_V,
9984 reglen + 1);
9985 break;
9986 }
Bram Moolenaar91639192020-06-29 19:55:58 +02009987 (void)dict_add_string(dict, (char *)"regtype", buf);
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009988
9989 buf[0] = get_register_name(get_unname_register());
9990 buf[1] = NUL;
9991 if (regname == '"')
Bram Moolenaar91639192020-06-29 19:55:58 +02009992 (void)dict_add_string(dict, (char *)"points_to", buf);
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009993 else
9994 {
9995 dictitem_T *item = dictitem_alloc((char_u *)"isunnamed");
9996
9997 if (item != NULL)
9998 {
Bram Moolenaar82946e12022-11-24 11:31:29 +00009999 item->di_tv.v_type = VAR_BOOL;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010000 item->di_tv.vval.v_number = regname == buf[0]
Bram Moolenaar418a29f2021-02-10 22:23:41 +010010001 ? VVAL_TRUE : VVAL_FALSE;
Bram Moolenaar91639192020-06-29 19:55:58 +020010002 (void)dict_add(dict, item);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010003 }
10004 }
10005}
10006
Bram Moolenaar0b6d9112018-05-22 20:35:17 +020010007 static void
10008return_register(int regname, typval_T *rettv)
10009{
10010 char_u buf[2] = {0, 0};
10011
10012 buf[0] = (char_u)regname;
10013 rettv->v_type = VAR_STRING;
10014 rettv->vval.v_string = vim_strsave(buf);
10015}
10016
10017/*
10018 * "reg_executing()" function
10019 */
10020 static void
10021f_reg_executing(typval_T *argvars UNUSED, typval_T *rettv)
10022{
10023 return_register(reg_executing, rettv);
10024}
10025
10026/*
10027 * "reg_recording()" function
10028 */
10029 static void
10030f_reg_recording(typval_T *argvars UNUSED, typval_T *rettv)
10031{
10032 return_register(reg_recording, rettv);
10033}
10034
Bram Moolenaar7416f3e2017-03-18 18:10:13 +010010035/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010036 * "rename({from}, {to})" function
10037 */
10038 static void
10039f_rename(typval_T *argvars, typval_T *rettv)
10040{
10041 char_u buf[NUMBUFLEN];
10042
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010043 rettv->vval.v_number = -1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010044 if (check_restricted() || check_secure())
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010045 return;
10046
10047 if (in_vim9script()
10048 && (check_for_string_arg(argvars, 0) == FAIL
10049 || check_for_string_arg(argvars, 1) == FAIL))
10050 return;
10051
10052 rettv->vval.v_number = vim_rename(tv_get_string(&argvars[0]),
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010053 tv_get_string_buf(&argvars[1], buf));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010054}
10055
10056/*
10057 * "repeat()" function
10058 */
10059 static void
10060f_repeat(typval_T *argvars, typval_T *rettv)
10061{
10062 char_u *p;
Bakudankun375141e2022-09-09 18:46:47 +010010063 varnumber_T n;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010064 int slen;
10065 int len;
10066 char_u *r;
10067 int i;
10068
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +020010069 if (in_vim9script()
Bakudankun375141e2022-09-09 18:46:47 +010010070 && (check_for_string_or_number_or_list_or_blob_arg(argvars, 0)
10071 == FAIL
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010072 || check_for_number_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +020010073 return;
10074
Bakudankun375141e2022-09-09 18:46:47 +010010075 n = tv_get_number(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010076 if (argvars[0].v_type == VAR_LIST)
10077 {
10078 if (rettv_list_alloc(rettv) == OK && argvars[0].vval.v_list != NULL)
10079 while (n-- > 0)
10080 if (list_extend(rettv->vval.v_list,
10081 argvars[0].vval.v_list, NULL) == FAIL)
10082 break;
10083 }
Bakudankun375141e2022-09-09 18:46:47 +010010084 else if (argvars[0].v_type == VAR_BLOB)
10085 {
10086 if (rettv_blob_alloc(rettv) == FAIL
10087 || argvars[0].vval.v_blob == NULL
10088 || n <= 0)
10089 return;
10090
10091 slen = argvars[0].vval.v_blob->bv_ga.ga_len;
10092 len = (int)slen * n;
10093 if (len <= 0)
10094 return;
10095
10096 if (ga_grow(&rettv->vval.v_blob->bv_ga, len) == FAIL)
10097 return;
10098
10099 rettv->vval.v_blob->bv_ga.ga_len = len;
10100
10101 for (i = 0; i < slen; ++i)
10102 if (blob_get(argvars[0].vval.v_blob, i) != 0)
10103 break;
10104
10105 if (i == slen)
10106 // No need to copy since all bytes are already zero
10107 return;
10108
10109 for (i = 0; i < n; ++i)
10110 blob_set_range(rettv->vval.v_blob,
10111 (long)i * slen, ((long)i + 1) * slen - 1, argvars);
10112 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010113 else
10114 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010115 p = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010116 rettv->v_type = VAR_STRING;
10117 rettv->vval.v_string = NULL;
10118
10119 slen = (int)STRLEN(p);
10120 len = slen * n;
10121 if (len <= 0)
10122 return;
10123
10124 r = alloc(len + 1);
10125 if (r != NULL)
10126 {
10127 for (i = 0; i < n; i++)
10128 mch_memmove(r + i * slen, p, (size_t)slen);
10129 r[len] = NUL;
10130 }
10131
10132 rettv->vval.v_string = r;
10133 }
10134}
10135
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010136#define SP_NOMOVE 0x01 // don't move cursor
10137#define SP_REPEAT 0x02 // repeat to find outer pair
10138#define SP_RETCOUNT 0x04 // return matchcount
10139#define SP_SETPCMARK 0x08 // set previous context mark
10140#define SP_START 0x10 // accept match at start position
10141#define SP_SUBPAT 0x20 // return nr of matching sub-pattern
10142#define SP_END 0x40 // leave cursor at end of match
10143#define SP_COLUMN 0x80 // start at cursor column
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010144
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010145/*
10146 * Get flags for a search function.
10147 * Possibly sets "p_ws".
10148 * Returns BACKWARD, FORWARD or zero (for an error).
10149 */
10150 static int
10151get_search_arg(typval_T *varp, int *flagsp)
10152{
10153 int dir = FORWARD;
10154 char_u *flags;
10155 char_u nbuf[NUMBUFLEN];
10156 int mask;
10157
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010158 if (varp->v_type == VAR_UNKNOWN)
10159 return FORWARD;
10160
10161 flags = tv_get_string_buf_chk(varp, nbuf);
10162 if (flags == NULL)
10163 return 0; // type error; errmsg already given
10164 while (*flags != NUL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010165 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010166 switch (*flags)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010167 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010168 case 'b': dir = BACKWARD; break;
10169 case 'w': p_ws = TRUE; break;
10170 case 'W': p_ws = FALSE; break;
10171 default: mask = 0;
10172 if (flagsp != NULL)
10173 switch (*flags)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010174 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010175 case 'c': mask = SP_START; break;
10176 case 'e': mask = SP_END; break;
10177 case 'm': mask = SP_RETCOUNT; break;
10178 case 'n': mask = SP_NOMOVE; break;
10179 case 'p': mask = SP_SUBPAT; break;
10180 case 'r': mask = SP_REPEAT; break;
10181 case 's': mask = SP_SETPCMARK; break;
10182 case 'z': mask = SP_COLUMN; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010183 }
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010184 if (mask == 0)
10185 {
10186 semsg(_(e_invalid_argument_str), flags);
10187 dir = 0;
10188 }
10189 else
10190 *flagsp |= mask;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010191 }
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010192 if (dir == 0)
10193 break;
10194 ++flags;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010195 }
10196 return dir;
10197}
10198
10199/*
10200 * Shared by search() and searchpos() functions.
10201 */
10202 static int
10203search_cmn(typval_T *argvars, pos_T *match_pos, int *flagsp)
10204{
10205 int flags;
10206 char_u *pat;
John Marriott8c85a2a2024-05-20 19:18:26 +020010207 size_t patlen;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010208 pos_T pos;
10209 pos_T save_cursor;
10210 int save_p_ws = p_ws;
10211 int dir;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010212 int retval = 0; // default: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010213 long lnum_stop = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010214#ifdef FEAT_RELTIME
10215 long time_limit = 0;
10216#endif
10217 int options = SEARCH_KEEP;
10218 int subpatnum;
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010219 searchit_arg_T sia;
Bram Moolenaara9c01042020-06-07 14:50:50 +020010220 int use_skip = FALSE;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010221 pos_T firstpos;
10222
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +020010223 if (in_vim9script()
10224 && (check_for_string_arg(argvars, 0) == FAIL
10225 || check_for_opt_string_arg(argvars, 1) == FAIL
10226 || (argvars[1].v_type != VAR_UNKNOWN
10227 && (check_for_opt_number_arg(argvars, 2) == FAIL
10228 || (argvars[2].v_type != VAR_UNKNOWN
10229 && check_for_opt_number_arg(argvars, 3) == FAIL)))))
10230 goto theend;
10231
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010232 pat = tv_get_string(&argvars[0]);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010233 dir = get_search_arg(&argvars[1], flagsp); // may set p_ws
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010234 if (dir == 0)
10235 goto theend;
10236 flags = *flagsp;
10237 if (flags & SP_START)
10238 options |= SEARCH_START;
10239 if (flags & SP_END)
10240 options |= SEARCH_END;
10241 if (flags & SP_COLUMN)
10242 options |= SEARCH_COL;
10243
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010244 // Optional arguments: line number to stop searching, timeout and skip.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010245 if (argvars[1].v_type != VAR_UNKNOWN && argvars[2].v_type != VAR_UNKNOWN)
10246 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010247 lnum_stop = (long)tv_get_number_chk(&argvars[2], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010248 if (lnum_stop < 0)
10249 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010250 if (argvars[3].v_type != VAR_UNKNOWN)
10251 {
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010252#ifdef FEAT_RELTIME
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010253 time_limit = (long)tv_get_number_chk(&argvars[3], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010254 if (time_limit < 0)
10255 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010256#endif
Bram Moolenaara9c01042020-06-07 14:50:50 +020010257 use_skip = eval_expr_valid_arg(&argvars[4]);
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010258 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010259 }
10260
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010261 /*
10262 * This function does not accept SP_REPEAT and SP_RETCOUNT flags.
10263 * Check to make sure only those flags are set.
10264 * Also, Only the SP_NOMOVE or the SP_SETPCMARK flag can be set. Both
10265 * flags cannot be set. Check for that condition also.
10266 */
10267 if (((flags & (SP_REPEAT | SP_RETCOUNT)) != 0)
10268 || ((flags & SP_NOMOVE) && (flags & SP_SETPCMARK)))
10269 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010270 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[1]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010271 goto theend;
10272 }
10273
10274 pos = save_cursor = curwin->w_cursor;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010275 CLEAR_FIELD(firstpos);
Bram Moolenaara80faa82020-04-12 19:37:17 +020010276 CLEAR_FIELD(sia);
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010277 sia.sa_stop_lnum = (linenr_T)lnum_stop;
10278#ifdef FEAT_RELTIME
Paul Ollis65745772022-06-05 16:55:54 +010010279 sia.sa_tm = time_limit;
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010280#endif
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010281
John Marriott8c85a2a2024-05-20 19:18:26 +020010282 patlen = STRLEN(pat);
10283
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010284 // Repeat until {skip} returns FALSE.
10285 for (;;)
10286 {
John Marriott8c85a2a2024-05-20 19:18:26 +020010287 subpatnum = searchit(curwin, curbuf, &pos, NULL, dir, pat, patlen, 1L,
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010288 options, RE_SEARCH, &sia);
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010289 // finding the first match again means there is no match where {skip}
10290 // evaluates to zero.
10291 if (firstpos.lnum != 0 && EQUAL_POS(pos, firstpos))
10292 subpatnum = FAIL;
10293
Bram Moolenaara9c01042020-06-07 14:50:50 +020010294 if (subpatnum == FAIL || !use_skip)
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010295 // didn't find it or no skip argument
10296 break;
Bram Moolenaar3d79f0a2023-01-22 20:14:26 +000010297 if (firstpos.lnum == 0)
10298 firstpos = pos;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010299
Bram Moolenaara9c01042020-06-07 14:50:50 +020010300 // If the skip expression matches, ignore this match.
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010301 {
10302 int do_skip;
10303 int err;
10304 pos_T save_pos = curwin->w_cursor;
10305
10306 curwin->w_cursor = pos;
Bram Moolenaara9c01042020-06-07 14:50:50 +020010307 err = FALSE;
10308 do_skip = eval_expr_to_bool(&argvars[4], &err);
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010309 curwin->w_cursor = save_pos;
10310 if (err)
10311 {
10312 // Evaluating {skip} caused an error, break here.
10313 subpatnum = FAIL;
10314 break;
10315 }
10316 if (!do_skip)
10317 break;
10318 }
zeertzjq180246c2022-06-23 12:04:46 +010010319
10320 // clear the start flag to avoid getting stuck here
10321 options &= ~SEARCH_START;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010322 }
10323
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010324 if (subpatnum != FAIL)
10325 {
10326 if (flags & SP_SUBPAT)
10327 retval = subpatnum;
10328 else
10329 retval = pos.lnum;
10330 if (flags & SP_SETPCMARK)
10331 setpcmark();
10332 curwin->w_cursor = pos;
10333 if (match_pos != NULL)
10334 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010335 // Store the match cursor position
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010336 match_pos->lnum = pos.lnum;
10337 match_pos->col = pos.col + 1;
10338 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010339 // "/$" will put the cursor after the end of the line, may need to
10340 // correct that here
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010341 check_cursor();
10342 }
10343
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010344 // If 'n' flag is used: restore cursor position.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010345 if (flags & SP_NOMOVE)
10346 curwin->w_cursor = save_cursor;
10347 else
10348 curwin->w_set_curswant = TRUE;
10349theend:
10350 p_ws = save_p_ws;
10351
10352 return retval;
10353}
10354
Bram Moolenaare99be0e2019-03-26 22:51:09 +010010355#ifdef FEAT_RUBY
10356/*
10357 * "rubyeval()" function
10358 */
10359 static void
10360f_rubyeval(typval_T *argvars, typval_T *rettv)
10361{
10362 char_u *str;
10363 char_u buf[NUMBUFLEN];
10364
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010365 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
10366 return;
10367
Bram Moolenaare99be0e2019-03-26 22:51:09 +010010368 str = tv_get_string_buf(&argvars[0], buf);
10369 do_rubyeval(str, rettv);
10370}
10371#endif
10372
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010373/*
10374 * "screenattr()" function
10375 */
10376 static void
10377f_screenattr(typval_T *argvars, typval_T *rettv)
10378{
10379 int row;
10380 int col;
10381 int c;
10382
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010383 if (in_vim9script()
10384 && (check_for_number_arg(argvars, 0) == FAIL
10385 || check_for_number_arg(argvars, 1) == FAIL))
10386 return;
10387
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010388 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10389 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010390 if (row < 0 || row >= screen_Rows
10391 || col < 0 || col >= screen_Columns)
10392 c = -1;
10393 else
10394 c = ScreenAttrs[LineOffset[row] + col];
10395 rettv->vval.v_number = c;
10396}
10397
10398/*
10399 * "screenchar()" function
10400 */
10401 static void
10402f_screenchar(typval_T *argvars, typval_T *rettv)
10403{
10404 int row;
10405 int col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010406 int c;
10407
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010408 if (in_vim9script()
10409 && (check_for_number_arg(argvars, 0) == FAIL
10410 || check_for_number_arg(argvars, 1) == FAIL))
10411 return;
10412
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010413 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10414 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010415 if (row < 0 || row >= screen_Rows || col < 0 || col >= screen_Columns)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010416 c = -1;
10417 else
10418 {
zeertzjq47eec672023-06-01 20:26:55 +010010419 char_u buf[MB_MAXBYTES + 1];
10420 screen_getbytes(row, col, buf, NULL);
10421 c = (*mb_ptr2char)(buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010422 }
10423 rettv->vval.v_number = c;
10424}
10425
10426/*
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010427 * "screenchars()" function
10428 */
10429 static void
10430f_screenchars(typval_T *argvars, typval_T *rettv)
10431{
10432 int row;
10433 int col;
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010434 int c;
10435 int i;
10436
10437 if (rettv_list_alloc(rettv) == FAIL)
10438 return;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010439
10440 if (in_vim9script()
10441 && (check_for_number_arg(argvars, 0) == FAIL
10442 || check_for_number_arg(argvars, 1) == FAIL))
10443 return;
10444
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010445 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10446 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
10447 if (row < 0 || row >= screen_Rows || col < 0 || col >= screen_Columns)
10448 return;
10449
zeertzjq47eec672023-06-01 20:26:55 +010010450 char_u buf[MB_MAXBYTES + 1];
10451 screen_getbytes(row, col, buf, NULL);
10452 int pcc[MAX_MCO];
10453 if (enc_utf8)
10454 c = utfc_ptr2char(buf, pcc);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010455 else
zeertzjq47eec672023-06-01 20:26:55 +010010456 c = (*mb_ptr2char)(buf);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010457 list_append_number(rettv->vval.v_list, (varnumber_T)c);
10458
10459 if (enc_utf8)
zeertzjq47eec672023-06-01 20:26:55 +010010460 for (i = 0; i < Screen_mco && pcc[i] != 0; ++i)
10461 list_append_number(rettv->vval.v_list, (varnumber_T)pcc[i]);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010462}
10463
10464/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010465 * "screencol()" function
10466 *
10467 * First column is 1 to be consistent with virtcol().
10468 */
10469 static void
10470f_screencol(typval_T *argvars UNUSED, typval_T *rettv)
10471{
10472 rettv->vval.v_number = screen_screencol() + 1;
10473}
10474
10475/*
10476 * "screenrow()" function
10477 */
10478 static void
10479f_screenrow(typval_T *argvars UNUSED, typval_T *rettv)
10480{
10481 rettv->vval.v_number = screen_screenrow() + 1;
10482}
10483
10484/*
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010485 * "screenstring()" function
10486 */
10487 static void
10488f_screenstring(typval_T *argvars, typval_T *rettv)
10489{
10490 int row;
10491 int col;
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010492 char_u buf[MB_MAXBYTES + 1];
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010493
10494 rettv->vval.v_string = NULL;
10495 rettv->v_type = VAR_STRING;
10496
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010497 if (in_vim9script()
10498 && (check_for_number_arg(argvars, 0) == FAIL
10499 || check_for_number_arg(argvars, 1) == FAIL))
10500 return;
10501
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010502 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10503 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
10504 if (row < 0 || row >= screen_Rows || col < 0 || col >= screen_Columns)
10505 return;
10506
zeertzjq47eec672023-06-01 20:26:55 +010010507 screen_getbytes(row, col, buf, NULL);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010508 rettv->vval.v_string = vim_strsave(buf);
10509}
10510
10511/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010512 * "search()" function
10513 */
10514 static void
10515f_search(typval_T *argvars, typval_T *rettv)
10516{
10517 int flags = 0;
10518
10519 rettv->vval.v_number = search_cmn(argvars, NULL, &flags);
10520}
10521
10522/*
10523 * "searchdecl()" function
10524 */
10525 static void
10526f_searchdecl(typval_T *argvars, typval_T *rettv)
10527{
Bram Moolenaar30788d32020-09-05 21:35:16 +020010528 int locally = TRUE;
10529 int thisblock = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010530 int error = FALSE;
10531 char_u *name;
10532
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010533 rettv->vval.v_number = 1; // default: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010534
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020010535 if (in_vim9script()
10536 && (check_for_string_arg(argvars, 0) == FAIL
10537 || check_for_opt_bool_arg(argvars, 1) == FAIL
10538 || (argvars[1].v_type != VAR_UNKNOWN
10539 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
10540 return;
10541
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010542 name = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010543 if (argvars[1].v_type != VAR_UNKNOWN)
10544 {
Bram Moolenaar30788d32020-09-05 21:35:16 +020010545 locally = !(int)tv_get_bool_chk(&argvars[1], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010546 if (!error && argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar30788d32020-09-05 21:35:16 +020010547 thisblock = (int)tv_get_bool_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010548 }
10549 if (!error && name != NULL)
10550 rettv->vval.v_number = find_decl(name, (int)STRLEN(name),
10551 locally, thisblock, SEARCH_KEEP) == FAIL;
10552}
10553
10554/*
10555 * Used by searchpair() and searchpairpos()
10556 */
10557 static int
10558searchpair_cmn(typval_T *argvars, pos_T *match_pos)
10559{
10560 char_u *spat, *mpat, *epat;
Bram Moolenaar48570482017-10-30 21:48:41 +010010561 typval_T *skip;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010562 int save_p_ws = p_ws;
10563 int dir;
10564 int flags = 0;
10565 char_u nbuf1[NUMBUFLEN];
10566 char_u nbuf2[NUMBUFLEN];
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010567 int retval = 0; // default: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010568 long lnum_stop = 0;
10569 long time_limit = 0;
10570
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +020010571 if (in_vim9script()
10572 && (check_for_string_arg(argvars, 0) == FAIL
10573 || check_for_string_arg(argvars, 1) == FAIL
10574 || check_for_string_arg(argvars, 2) == FAIL
10575 || check_for_opt_string_arg(argvars, 3) == FAIL
10576 || (argvars[3].v_type != VAR_UNKNOWN
10577 && argvars[4].v_type != VAR_UNKNOWN
10578 && (check_for_opt_number_arg(argvars, 5) == FAIL
10579 || (argvars[5].v_type != VAR_UNKNOWN
10580 && check_for_opt_number_arg(argvars, 6) == FAIL)))))
10581 goto theend;
10582
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010583 // Get the three pattern arguments: start, middle, end. Will result in an
10584 // error if not a valid argument.
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010585 spat = tv_get_string_chk(&argvars[0]);
10586 mpat = tv_get_string_buf_chk(&argvars[1], nbuf1);
10587 epat = tv_get_string_buf_chk(&argvars[2], nbuf2);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010588 if (spat == NULL || mpat == NULL || epat == NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010589 goto theend; // type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010590
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010591 // Handle the optional fourth argument: flags
10592 dir = get_search_arg(&argvars[3], &flags); // may set p_ws
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010593 if (dir == 0)
10594 goto theend;
10595
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010596 // Don't accept SP_END or SP_SUBPAT.
10597 // Only one of the SP_NOMOVE or SP_SETPCMARK flags can be set.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010598 if ((flags & (SP_END | SP_SUBPAT)) != 0
10599 || ((flags & SP_NOMOVE) && (flags & SP_SETPCMARK)))
10600 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010601 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[3]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010602 goto theend;
10603 }
10604
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010605 // Using 'r' implies 'W', otherwise it doesn't work.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010606 if (flags & SP_REPEAT)
10607 p_ws = FALSE;
10608
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010609 // Optional fifth argument: skip expression
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010610 if (argvars[3].v_type == VAR_UNKNOWN
10611 || argvars[4].v_type == VAR_UNKNOWN)
Bram Moolenaar48570482017-10-30 21:48:41 +010010612 skip = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010613 else
10614 {
Bram Moolenaara9c01042020-06-07 14:50:50 +020010615 // Type is checked later.
Bram Moolenaar48570482017-10-30 21:48:41 +010010616 skip = &argvars[4];
Bram Moolenaara9c01042020-06-07 14:50:50 +020010617
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010618 if (argvars[5].v_type != VAR_UNKNOWN)
10619 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010620 lnum_stop = (long)tv_get_number_chk(&argvars[5], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010621 if (lnum_stop < 0)
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010622 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010623 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[5]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010624 goto theend;
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010625 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010626#ifdef FEAT_RELTIME
10627 if (argvars[6].v_type != VAR_UNKNOWN)
10628 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010629 time_limit = (long)tv_get_number_chk(&argvars[6], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010630 if (time_limit < 0)
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010631 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010632 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[6]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010633 goto theend;
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010634 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010635 }
10636#endif
10637 }
10638 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010639
10640 retval = do_searchpair(spat, mpat, epat, dir, skip, flags,
10641 match_pos, lnum_stop, time_limit);
10642
10643theend:
10644 p_ws = save_p_ws;
10645
10646 return retval;
10647}
10648
10649/*
10650 * "searchpair()" function
10651 */
10652 static void
10653f_searchpair(typval_T *argvars, typval_T *rettv)
10654{
10655 rettv->vval.v_number = searchpair_cmn(argvars, NULL);
10656}
10657
10658/*
10659 * "searchpairpos()" function
10660 */
10661 static void
10662f_searchpairpos(typval_T *argvars, typval_T *rettv)
10663{
10664 pos_T match_pos;
10665 int lnum = 0;
10666 int col = 0;
10667
10668 if (rettv_list_alloc(rettv) == FAIL)
10669 return;
10670
10671 if (searchpair_cmn(argvars, &match_pos) > 0)
10672 {
10673 lnum = match_pos.lnum;
10674 col = match_pos.col;
10675 }
10676
10677 list_append_number(rettv->vval.v_list, (varnumber_T)lnum);
10678 list_append_number(rettv->vval.v_list, (varnumber_T)col);
10679}
10680
10681/*
10682 * Search for a start/middle/end thing.
10683 * Used by searchpair(), see its documentation for the details.
10684 * Returns 0 or -1 for no match,
10685 */
10686 long
10687do_searchpair(
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010688 char_u *spat, // start pattern
10689 char_u *mpat, // middle pattern
10690 char_u *epat, // end pattern
10691 int dir, // BACKWARD or FORWARD
10692 typval_T *skip, // skip expression
10693 int flags, // SP_SETPCMARK and other SP_ values
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010694 pos_T *match_pos,
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010695 linenr_T lnum_stop, // stop at this line if not zero
10696 long time_limit UNUSED) // stop after this many msec
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010697{
10698 char_u *save_cpo;
10699 char_u *pat, *pat2 = NULL, *pat3 = NULL;
John Marriott8c85a2a2024-05-20 19:18:26 +020010700 size_t patlen;
10701 size_t spatlen;
10702 size_t epatlen;
10703 size_t pat2size;
10704 size_t pat2len;
10705 size_t pat3size;
10706 size_t pat3len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010707 long retval = 0;
10708 pos_T pos;
10709 pos_T firstpos;
10710 pos_T foundpos;
10711 pos_T save_cursor;
10712 pos_T save_pos;
10713 int n;
10714 int r;
10715 int nest = 1;
Bram Moolenaar48570482017-10-30 21:48:41 +010010716 int use_skip = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010717 int err;
10718 int options = SEARCH_KEEP;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010719
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010720 // Make 'cpoptions' empty, the 'l' flag should not be used here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010721 save_cpo = p_cpo;
10722 p_cpo = empty_option;
10723
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010724 // Make two search patterns: start/end (pat2, for in nested pairs) and
10725 // start/middle/end (pat3, for the top pair).
John Marriott8c85a2a2024-05-20 19:18:26 +020010726 spatlen = STRLEN(spat);
10727 epatlen = STRLEN(epat);
10728 pat2size = spatlen + epatlen + 17;
10729 pat2 = alloc(pat2size);
10730 if (pat2 == NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010731 goto theend;
John Marriott8c85a2a2024-05-20 19:18:26 +020010732 pat3size = spatlen + STRLEN(mpat) + epatlen + 25;
10733 pat3 = alloc(pat3size);
10734 if (pat3 == NULL)
10735 goto theend;
10736 pat2len = vim_snprintf((char *)pat2, pat2size, "\\m\\(%s\\m\\)\\|\\(%s\\m\\)", spat, epat);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010737 if (*mpat == NUL)
John Marriott8c85a2a2024-05-20 19:18:26 +020010738 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010739 STRCPY(pat3, pat2);
John Marriott8c85a2a2024-05-20 19:18:26 +020010740 pat3len = pat2len;
10741 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010742 else
John Marriott8c85a2a2024-05-20 19:18:26 +020010743 pat3len = vim_snprintf((char *)pat3, pat3size, "\\m\\(%s\\m\\)\\|\\(%s\\m\\)\\|\\(%s\\m\\)",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010744 spat, epat, mpat);
10745 if (flags & SP_START)
10746 options |= SEARCH_START;
10747
Bram Moolenaar48570482017-10-30 21:48:41 +010010748 if (skip != NULL)
Bram Moolenaara9c01042020-06-07 14:50:50 +020010749 use_skip = eval_expr_valid_arg(skip);
Bram Moolenaar48570482017-10-30 21:48:41 +010010750
Bram Moolenaar5ea38d12022-06-16 21:20:48 +010010751#ifdef FEAT_RELTIME
10752 if (time_limit > 0)
10753 init_regexp_timeout(time_limit);
10754#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010755 save_cursor = curwin->w_cursor;
10756 pos = curwin->w_cursor;
Bram Moolenaarb5aedf32017-03-12 18:23:53 +010010757 CLEAR_POS(&firstpos);
10758 CLEAR_POS(&foundpos);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010759 pat = pat3;
John Marriott8c85a2a2024-05-20 19:18:26 +020010760 patlen = pat3len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010761 for (;;)
10762 {
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010763 searchit_arg_T sia;
10764
Bram Moolenaara80faa82020-04-12 19:37:17 +020010765 CLEAR_FIELD(sia);
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010766 sia.sa_stop_lnum = lnum_stop;
John Marriott8c85a2a2024-05-20 19:18:26 +020010767 n = searchit(curwin, curbuf, &pos, NULL, dir, pat, patlen, 1L,
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010768 options, RE_SEARCH, &sia);
Bram Moolenaarb5aedf32017-03-12 18:23:53 +010010769 if (n == FAIL || (firstpos.lnum != 0 && EQUAL_POS(pos, firstpos)))
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010770 // didn't find it or found the first match again: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010771 break;
10772
10773 if (firstpos.lnum == 0)
10774 firstpos = pos;
Bram Moolenaarb5aedf32017-03-12 18:23:53 +010010775 if (EQUAL_POS(pos, foundpos))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010776 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010777 // Found the same position again. Can happen with a pattern that
10778 // has "\zs" at the end and searching backwards. Advance one
10779 // character and try again.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010780 if (dir == BACKWARD)
10781 decl(&pos);
10782 else
10783 incl(&pos);
10784 }
10785 foundpos = pos;
10786
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010787 // clear the start flag to avoid getting stuck here
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010788 options &= ~SEARCH_START;
10789
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010790 // If the skip pattern matches, ignore this match.
Bram Moolenaar48570482017-10-30 21:48:41 +010010791 if (use_skip)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010792 {
10793 save_pos = curwin->w_cursor;
10794 curwin->w_cursor = pos;
Bram Moolenaar48570482017-10-30 21:48:41 +010010795 err = FALSE;
10796 r = eval_expr_to_bool(skip, &err);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010797 curwin->w_cursor = save_pos;
10798 if (err)
10799 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010800 // Evaluating {skip} caused an error, break here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010801 curwin->w_cursor = save_cursor;
10802 retval = -1;
10803 break;
10804 }
10805 if (r)
10806 continue;
10807 }
10808
10809 if ((dir == BACKWARD && n == 3) || (dir == FORWARD && n == 2))
10810 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010811 // Found end when searching backwards or start when searching
10812 // forward: nested pair.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010813 ++nest;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010814 pat = pat2; // nested, don't search for middle
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010815 }
10816 else
10817 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010818 // Found end when searching forward or start when searching
10819 // backward: end of (nested) pair; or found middle in outer pair.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010820 if (--nest == 1)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010821 pat = pat3; // outer level, search for middle
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010822 }
10823
10824 if (nest == 0)
10825 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010826 // Found the match: return matchcount or line number.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010827 if (flags & SP_RETCOUNT)
10828 ++retval;
10829 else
10830 retval = pos.lnum;
10831 if (flags & SP_SETPCMARK)
10832 setpcmark();
10833 curwin->w_cursor = pos;
10834 if (!(flags & SP_REPEAT))
10835 break;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010836 nest = 1; // search for next unmatched
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010837 }
10838 }
10839
10840 if (match_pos != NULL)
10841 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010842 // Store the match cursor position
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010843 match_pos->lnum = curwin->w_cursor.lnum;
10844 match_pos->col = curwin->w_cursor.col + 1;
10845 }
10846
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010847 // If 'n' flag is used or search failed: restore cursor position.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010848 if ((flags & SP_NOMOVE) || retval == 0)
10849 curwin->w_cursor = save_cursor;
10850
10851theend:
Bram Moolenaar5ea38d12022-06-16 21:20:48 +010010852#ifdef FEAT_RELTIME
Bram Moolenaar0f618382022-08-26 21:33:04 +010010853 if (time_limit > 0)
10854 disable_regexp_timeout();
Bram Moolenaar5ea38d12022-06-16 21:20:48 +010010855#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010856 vim_free(pat2);
10857 vim_free(pat3);
10858 if (p_cpo == empty_option)
10859 p_cpo = save_cpo;
10860 else
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010010861 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010862 // Darn, evaluating the {skip} expression changed the value.
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010010863 // If it's still empty it was changed and restored, need to restore in
10864 // the complicated way.
10865 if (*p_cpo == NUL)
Bram Moolenaar31e5c602022-04-15 13:53:33 +010010866 set_option_value_give_err((char_u *)"cpo", 0L, save_cpo, 0);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010867 free_string_option(save_cpo);
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010010868 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010869
10870 return retval;
10871}
10872
10873/*
10874 * "searchpos()" function
10875 */
10876 static void
10877f_searchpos(typval_T *argvars, typval_T *rettv)
10878{
10879 pos_T match_pos;
10880 int lnum = 0;
10881 int col = 0;
10882 int n;
10883 int flags = 0;
10884
10885 if (rettv_list_alloc(rettv) == FAIL)
10886 return;
10887
10888 n = search_cmn(argvars, &match_pos, &flags);
10889 if (n > 0)
10890 {
10891 lnum = match_pos.lnum;
10892 col = match_pos.col;
10893 }
10894
10895 list_append_number(rettv->vval.v_list, (varnumber_T)lnum);
10896 list_append_number(rettv->vval.v_list, (varnumber_T)col);
10897 if (flags & SP_SUBPAT)
10898 list_append_number(rettv->vval.v_list, (varnumber_T)n);
10899}
10900
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010901/*
10902 * Set the cursor or mark position.
zeertzjq47eec672023-06-01 20:26:55 +010010903 * If "charpos" is TRUE, then use the column number as a character offset.
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010904 * Otherwise use the column number as a byte offset.
10905 */
10906 static void
10907set_position(typval_T *argvars, typval_T *rettv, int charpos)
10908{
10909 pos_T pos;
10910 int fnum;
10911 char_u *name;
10912 colnr_T curswant = -1;
10913
10914 rettv->vval.v_number = -1;
10915
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020010916 if (in_vim9script()
10917 && (check_for_string_arg(argvars, 0) == FAIL
10918 || check_for_list_arg(argvars, 1) == FAIL))
10919 return;
10920
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010921 name = tv_get_string_chk(argvars);
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010922 if (name == NULL)
10923 return;
10924
10925 if (list2fpos(&argvars[1], &pos, &fnum, &curswant, charpos) != OK)
10926 return;
10927
10928 if (pos.col != MAXCOL && --pos.col < 0)
10929 pos.col = 0;
10930 if ((name[0] == '.' && name[1] == NUL))
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010931 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010932 // set cursor; "fnum" is ignored
10933 curwin->w_cursor = pos;
10934 if (curswant >= 0)
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010935 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010936 curwin->w_curswant = curswant - 1;
10937 curwin->w_set_curswant = FALSE;
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010938 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010939 check_cursor();
10940 rettv->vval.v_number = 0;
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010941 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010942 else if (name[0] == '\'' && name[1] != NUL && name[2] == NUL)
10943 {
10944 // set mark
10945 if (setmark_pos(name[1], &pos, fnum) == OK)
10946 rettv->vval.v_number = 0;
10947 }
10948 else
10949 emsg(_(e_invalid_argument));
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010950}
10951/*
10952 * "setcharpos()" function
10953 */
10954 static void
10955f_setcharpos(typval_T *argvars, typval_T *rettv)
10956{
10957 set_position(argvars, rettv, TRUE);
10958}
10959
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010960 static void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010961f_setcharsearch(typval_T *argvars, typval_T *rettv UNUSED)
10962{
10963 dict_T *d;
10964 dictitem_T *di;
10965 char_u *csearch;
10966
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +010010967 if (check_for_dict_arg(argvars, 0) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010968 return;
10969
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010970 if ((d = argvars[0].vval.v_dict) == NULL)
10971 return;
10972
10973 csearch = dict_get_string(d, "char", FALSE);
10974 if (csearch != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010975 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010976 if (enc_utf8)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010977 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010978 int pcc[MAX_MCO];
10979 int c = utfc_ptr2char(csearch, pcc);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010980
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010981 set_last_csearch(c, csearch, utfc_ptr2len(csearch));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010982 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010983 else
10984 set_last_csearch(PTR2CHAR(csearch),
10985 csearch, mb_ptr2len(csearch));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010986 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010987
10988 di = dict_find(d, (char_u *)"forward", -1);
10989 if (di != NULL)
10990 set_csearch_direction((int)tv_get_number(&di->di_tv)
10991 ? FORWARD : BACKWARD);
10992
10993 di = dict_find(d, (char_u *)"until", -1);
10994 if (di != NULL)
10995 set_csearch_until(!!tv_get_number(&di->di_tv));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010996}
10997
10998/*
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010999 * "setcursorcharpos" function
11000 */
11001 static void
Bram Moolenaar3af15ab2021-01-17 16:16:23 +010011002f_setcursorcharpos(typval_T *argvars, typval_T *rettv)
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011003{
11004 set_cursorpos(argvars, rettv, TRUE);
11005}
11006
11007/*
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011008 * "setenv()" function
11009 */
11010 static void
11011f_setenv(typval_T *argvars, typval_T *rettv UNUSED)
11012{
11013 char_u namebuf[NUMBUFLEN];
11014 char_u valbuf[NUMBUFLEN];
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020011015 char_u *name;
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011016
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020011017 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11018 return;
11019
zeertzjqfcaeb3d2023-11-28 20:46:29 +010011020 // setting an environment variable may be dangerous, e.g. you could
Christian Brabandt6b89dd62023-10-26 22:14:17 +020011021 // setenv GCONV_PATH=/tmp and then have iconv() unexpectedly call
11022 // a shell command using some shared library:
11023 if (check_restricted() || check_secure())
11024 return;
11025
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020011026 name = tv_get_string_buf(&argvars[0], namebuf);
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011027 if (argvars[1].v_type == VAR_SPECIAL
11028 && argvars[1].vval.v_number == VVAL_NULL)
LemonBoy77142312022-04-15 20:50:46 +010011029 vim_unsetenv_ext(name);
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011030 else
LemonBoy77142312022-04-15 20:50:46 +010011031 vim_setenv_ext(name, tv_get_string_buf(&argvars[1], valbuf));
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011032}
11033
11034/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011035 * "setfperm({fname}, {mode})" function
11036 */
11037 static void
11038f_setfperm(typval_T *argvars, typval_T *rettv)
11039{
11040 char_u *fname;
11041 char_u modebuf[NUMBUFLEN];
11042 char_u *mode_str;
11043 int i;
11044 int mask;
11045 int mode = 0;
11046
11047 rettv->vval.v_number = 0;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011048
11049 if (in_vim9script()
11050 && (check_for_string_arg(argvars, 0) == FAIL
11051 || check_for_string_arg(argvars, 1) == FAIL))
11052 return;
11053
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011054 fname = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011055 if (fname == NULL)
11056 return;
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011057 mode_str = tv_get_string_buf_chk(&argvars[1], modebuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011058 if (mode_str == NULL)
11059 return;
11060 if (STRLEN(mode_str) != 9)
11061 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000011062 semsg(_(e_invalid_argument_str), mode_str);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011063 return;
11064 }
11065
11066 mask = 1;
11067 for (i = 8; i >= 0; --i)
11068 {
11069 if (mode_str[i] != '-')
11070 mode |= mask;
11071 mask = mask << 1;
11072 }
11073 rettv->vval.v_number = mch_setperm(fname, mode) == OK;
11074}
11075
11076/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011077 * "setpos()" function
11078 */
11079 static void
11080f_setpos(typval_T *argvars, typval_T *rettv)
11081{
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011082 set_position(argvars, rettv, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011083}
11084
11085/*
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011086 * Translate a register type string to the yank type and block length
11087 */
11088 static int
11089get_yank_type(char_u **pp, char_u *yank_type, long *block_len)
11090{
11091 char_u *stropt = *pp;
11092 switch (*stropt)
11093 {
11094 case 'v': case 'c': // character-wise selection
11095 *yank_type = MCHAR;
11096 break;
11097 case 'V': case 'l': // line-wise selection
11098 *yank_type = MLINE;
11099 break;
11100 case 'b': case Ctrl_V: // block-wise selection
11101 *yank_type = MBLOCK;
11102 if (VIM_ISDIGIT(stropt[1]))
11103 {
11104 ++stropt;
11105 *block_len = getdigits(&stropt) - 1;
11106 --stropt;
11107 }
11108 break;
11109 default:
11110 return FAIL;
11111 }
11112 *pp = stropt;
11113 return OK;
11114}
11115
11116/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011117 * "setreg()" function
11118 */
11119 static void
11120f_setreg(typval_T *argvars, typval_T *rettv)
11121{
11122 int regname;
11123 char_u *strregname;
11124 char_u *stropt;
11125 char_u *strval;
11126 int append;
11127 char_u yank_type;
11128 long block_len;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011129 typval_T *regcontents;
11130 int pointreg;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011131
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020011132 if (in_vim9script()
11133 && (check_for_string_arg(argvars, 0) == FAIL
11134 || check_for_opt_string_arg(argvars, 2) == FAIL))
11135 return;
11136
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011137 pointreg = 0;
11138 regcontents = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011139 block_len = -1;
11140 yank_type = MAUTO;
11141 append = FALSE;
11142
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011143 strregname = tv_get_string_chk(argvars);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011144 rettv->vval.v_number = 1; // FAIL is default
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011145
11146 if (strregname == NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011147 return; // type error; errmsg already given
Bram Moolenaar418a29f2021-02-10 22:23:41 +010011148 if (in_vim9script() && STRLEN(strregname) > 1)
11149 {
11150 semsg(_(e_register_name_must_be_one_char_str), strregname);
11151 return;
11152 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011153 regname = *strregname;
11154 if (regname == 0 || regname == '@')
11155 regname = '"';
11156
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011157 if (argvars[1].v_type == VAR_DICT)
11158 {
11159 dict_T *d = argvars[1].vval.v_dict;
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011160 dictitem_T *di;
11161
11162 if (d == NULL || d->dv_hashtab.ht_used == 0)
11163 {
11164 // Empty dict, clear the register (like setreg(0, []))
11165 char_u *lstval[2] = {NULL, NULL};
11166 write_reg_contents_lst(regname, lstval, 0, FALSE, MAUTO, -1);
11167 return;
11168 }
11169
11170 di = dict_find(d, (char_u *)"regcontents", -1);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011171 if (di != NULL)
11172 regcontents = &di->di_tv;
11173
Bram Moolenaard61efa52022-07-23 09:52:04 +010011174 stropt = dict_get_string(d, "regtype", FALSE);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011175 if (stropt != NULL)
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011176 {
11177 int ret = get_yank_type(&stropt, &yank_type, &block_len);
11178
11179 if (ret == FAIL || *++stropt != NUL)
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011180 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000011181 semsg(_(e_invalid_value_for_argument_str), "value");
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011182 return;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011183 }
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011184 }
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011185
11186 if (regname == '"')
11187 {
Bram Moolenaard61efa52022-07-23 09:52:04 +010011188 stropt = dict_get_string(d, "points_to", FALSE);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011189 if (stropt != NULL)
11190 {
11191 pointreg = *stropt;
11192 regname = pointreg;
11193 }
11194 }
Bram Moolenaard61efa52022-07-23 09:52:04 +010011195 else if (dict_get_bool(d, "isunnamed", -1) > 0)
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011196 pointreg = regname;
11197 }
11198 else
11199 regcontents = &argvars[1];
11200
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011201 if (argvars[2].v_type != VAR_UNKNOWN)
11202 {
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011203 if (yank_type != MAUTO)
11204 {
Bram Moolenaare1242042021-12-16 20:56:57 +000011205 semsg(_(e_too_many_arguments_for_function_str), "setreg");
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011206 return;
11207 }
11208
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011209 stropt = tv_get_string_chk(&argvars[2]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011210 if (stropt == NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011211 return; // type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011212 for (; *stropt != NUL; ++stropt)
11213 switch (*stropt)
11214 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011215 case 'a': case 'A': // append
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011216 append = TRUE;
11217 break;
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011218 default:
11219 get_yank_type(&stropt, &yank_type, &block_len);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011220 }
11221 }
11222
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011223 if (regcontents && regcontents->v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011224 {
11225 char_u **lstval;
11226 char_u **allocval;
11227 char_u buf[NUMBUFLEN];
11228 char_u **curval;
11229 char_u **curallocval;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011230 list_T *ll = regcontents->vval.v_list;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011231 listitem_T *li;
11232 int len;
11233
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011234 // If the list is NULL handle like an empty list.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011235 len = ll == NULL ? 0 : ll->lv_len;
11236
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011237 // First half: use for pointers to result lines; second half: use for
11238 // pointers to allocated copies.
Bram Moolenaarc799fe22019-05-28 23:08:19 +020011239 lstval = ALLOC_MULT(char_u *, (len + 1) * 2);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011240 if (lstval == NULL)
11241 return;
11242 curval = lstval;
11243 allocval = lstval + len + 2;
11244 curallocval = allocval;
11245
Bram Moolenaar50985eb2020-01-27 22:09:39 +010011246 if (ll != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011247 {
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020011248 CHECK_LIST_MATERIALIZE(ll);
Bram Moolenaar00d253e2020-04-06 22:13:01 +020011249 FOR_ALL_LIST_ITEMS(ll, li)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011250 {
Bram Moolenaar50985eb2020-01-27 22:09:39 +010011251 strval = tv_get_string_buf_chk(&li->li_tv, buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011252 if (strval == NULL)
11253 goto free_lstval;
Bram Moolenaar50985eb2020-01-27 22:09:39 +010011254 if (strval == buf)
11255 {
11256 // Need to make a copy, next tv_get_string_buf_chk() will
11257 // overwrite the string.
11258 strval = vim_strsave(buf);
11259 if (strval == NULL)
11260 goto free_lstval;
11261 *curallocval++ = strval;
11262 }
11263 *curval++ = strval;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011264 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011265 }
11266 *curval++ = NULL;
11267
11268 write_reg_contents_lst(regname, lstval, -1,
11269 append, yank_type, block_len);
11270free_lstval:
11271 while (curallocval > allocval)
11272 vim_free(*--curallocval);
11273 vim_free(lstval);
11274 }
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011275 else if (regcontents)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011276 {
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011277 strval = tv_get_string_chk(regcontents);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011278 if (strval == NULL)
11279 return;
11280 write_reg_contents_ex(regname, strval, -1,
11281 append, yank_type, block_len);
11282 }
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011283 if (pointreg != 0)
11284 get_yank_register(pointreg, TRUE);
11285
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011286 rettv->vval.v_number = 0;
11287}
11288
11289/*
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011290 * "settagstack()" function
11291 */
11292 static void
11293f_settagstack(typval_T *argvars, typval_T *rettv)
11294{
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011295 win_T *wp;
11296 dict_T *d;
11297 int action = 'r';
11298
11299 rettv->vval.v_number = -1;
11300
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011301 if (in_vim9script()
11302 && (check_for_number_arg(argvars, 0) == FAIL
11303 || check_for_dict_arg(argvars, 1) == FAIL
11304 || check_for_opt_string_arg(argvars, 2) == FAIL))
11305 return;
11306
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011307 // first argument: window number or id
11308 wp = find_win_by_nr_or_id(&argvars[0]);
11309 if (wp == NULL)
11310 return;
11311
11312 // second argument: dict with items to set in the tag stack
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +010011313 if (check_for_dict_arg(argvars, 1) == FAIL)
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011314 return;
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011315 d = argvars[1].vval.v_dict;
11316 if (d == NULL)
11317 return;
11318
11319 // third argument: action - 'a' for append and 'r' for replace.
11320 // default is to replace the stack.
11321 if (argvars[2].v_type == VAR_UNKNOWN)
11322 action = 'r';
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +010011323 else if (check_for_string_arg(argvars, 2) == FAIL)
11324 return;
11325 else
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011326 {
11327 char_u *actstr;
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011328 actstr = tv_get_string_chk(&argvars[2]);
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011329 if (actstr == NULL)
11330 return;
Bram Moolenaar271fa082020-01-02 14:02:16 +010011331 if ((*actstr == 'r' || *actstr == 'a' || *actstr == 't')
11332 && actstr[1] == NUL)
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011333 action = *actstr;
11334 else
11335 {
Bram Moolenaard82a47d2022-01-05 20:24:39 +000011336 semsg(_(e_invalid_action_str_2), actstr);
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011337 return;
11338 }
11339 }
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011340
11341 if (set_tagstack(wp, d, action) == OK)
11342 rettv->vval.v_number = 0;
11343}
11344
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011345#ifdef FEAT_CRYPT
11346/*
11347 * "sha256({string})" function
11348 */
11349 static void
11350f_sha256(typval_T *argvars, typval_T *rettv)
11351{
11352 char_u *p;
11353
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011354 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11355 return;
11356
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011357 p = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011358 rettv->vval.v_string = vim_strsave(
11359 sha256_bytes(p, (int)STRLEN(p), NULL, 0));
11360 rettv->v_type = VAR_STRING;
11361}
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011362#endif // FEAT_CRYPT
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011363
11364/*
11365 * "shellescape({string})" function
11366 */
11367 static void
11368f_shellescape(typval_T *argvars, typval_T *rettv)
11369{
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011370 int do_special;
Bram Moolenaar20615522017-06-05 18:46:26 +020011371
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011372 if (in_vim9script()
11373 && (check_for_string_arg(argvars, 0) == FAIL
11374 || check_for_opt_bool_arg(argvars, 1) == FAIL))
11375 return;
11376
11377 do_special = non_zero_arg(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011378 rettv->vval.v_string = vim_strsave_shellescape(
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011379 tv_get_string(&argvars[0]), do_special, do_special);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011380 rettv->v_type = VAR_STRING;
11381}
11382
11383/*
11384 * shiftwidth() function
11385 */
11386 static void
11387f_shiftwidth(typval_T *argvars UNUSED, typval_T *rettv)
11388{
Bram Moolenaarf9514162018-11-22 03:08:29 +010011389 rettv->vval.v_number = 0;
11390
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011391 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
11392 return;
11393
Bram Moolenaarf9514162018-11-22 03:08:29 +010011394 if (argvars[0].v_type != VAR_UNKNOWN)
11395 {
11396 long col;
11397
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011398 col = (long)tv_get_number_chk(argvars, NULL);
Bram Moolenaarf9514162018-11-22 03:08:29 +010011399 if (col < 0)
11400 return; // type error; errmsg already given
11401#ifdef FEAT_VARTABS
Gary Johnson88d4f252024-06-01 20:51:33 +020011402 rettv->vval.v_number = get_sw_value_col(curbuf, col, FALSE);
Bram Moolenaarf9514162018-11-22 03:08:29 +010011403 return;
11404#endif
11405 }
11406
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011407 rettv->vval.v_number = get_sw_value(curbuf);
11408}
11409
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011410/*
11411 * "soundfold({word})" function
11412 */
11413 static void
11414f_soundfold(typval_T *argvars, typval_T *rettv)
11415{
11416 char_u *s;
11417
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011418 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11419 return;
11420
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011421 rettv->v_type = VAR_STRING;
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011422 s = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011423#ifdef FEAT_SPELL
11424 rettv->vval.v_string = eval_soundfold(s);
11425#else
11426 rettv->vval.v_string = vim_strsave(s);
11427#endif
11428}
11429
11430/*
11431 * "spellbadword()" function
11432 */
11433 static void
11434f_spellbadword(typval_T *argvars UNUSED, typval_T *rettv)
11435{
11436 char_u *word = (char_u *)"";
11437 hlf_T attr = HLF_COUNT;
11438 int len = 0;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011439#ifdef FEAT_SPELL
11440 int wo_spell_save = curwin->w_p_spell;
11441
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011442 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
11443 return;
11444
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011445 if (!curwin->w_p_spell)
11446 {
Yegappan Lakshmananaf936912023-02-20 12:16:39 +000011447 parse_spelllang(curwin);
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011448 curwin->w_p_spell = TRUE;
11449 }
11450
11451 if (*curwin->w_s->b_p_spl == NUL)
11452 {
Bram Moolenaar460ae5d2022-01-01 14:19:49 +000011453 emsg(_(e_spell_checking_is_not_possible));
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011454 curwin->w_p_spell = wo_spell_save;
11455 return;
11456 }
11457#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011458
11459 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011460 {
11461#ifdef FEAT_SPELL
11462 curwin->w_p_spell = wo_spell_save;
11463#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011464 return;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011465 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011466
11467#ifdef FEAT_SPELL
11468 if (argvars[0].v_type == VAR_UNKNOWN)
11469 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011470 // Find the start and length of the badly spelled word.
Christ van Willegen - van Noort8e4c4c72024-05-17 18:49:27 +020011471 len = spell_move_to(curwin, FORWARD, SMT_ALL, TRUE, &attr);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011472 if (len != 0)
Bram Moolenaarb73fa622017-12-21 20:27:47 +010011473 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011474 word = ml_get_cursor();
Bram Moolenaarb73fa622017-12-21 20:27:47 +010011475 curwin->w_set_curswant = TRUE;
11476 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011477 }
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011478 else if (*curbuf->b_s.b_p_spl != NUL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011479 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011480 char_u *str = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011481 int capcol = -1;
11482
11483 if (str != NULL)
11484 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011485 // Check the argument for spelling.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011486 while (*str != NUL)
11487 {
11488 len = spell_check(curwin, str, &attr, &capcol, FALSE);
11489 if (attr != HLF_COUNT)
11490 {
11491 word = str;
11492 break;
11493 }
11494 str += len;
Bram Moolenaar66ab9162018-07-20 20:28:48 +020011495 capcol -= len;
Bram Moolenaar0c779e82019-08-09 17:01:02 +020011496 len = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011497 }
11498 }
11499 }
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011500 curwin->w_p_spell = wo_spell_save;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011501#endif
11502
11503 list_append_string(rettv->vval.v_list, word, len);
11504 list_append_string(rettv->vval.v_list, (char_u *)(
11505 attr == HLF_SPB ? "bad" :
11506 attr == HLF_SPR ? "rare" :
11507 attr == HLF_SPL ? "local" :
11508 attr == HLF_SPC ? "caps" :
11509 ""), -1);
11510}
11511
11512/*
11513 * "spellsuggest()" function
11514 */
11515 static void
11516f_spellsuggest(typval_T *argvars UNUSED, typval_T *rettv)
11517{
11518#ifdef FEAT_SPELL
11519 char_u *str;
11520 int typeerr = FALSE;
11521 int maxcount;
11522 garray_T ga;
11523 int i;
11524 listitem_T *li;
11525 int need_capital = FALSE;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011526 int wo_spell_save = curwin->w_p_spell;
11527
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011528 if (in_vim9script()
11529 && (check_for_string_arg(argvars, 0) == FAIL
11530 || check_for_opt_number_arg(argvars, 1) == FAIL
11531 || (argvars[1].v_type != VAR_UNKNOWN
11532 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
11533 return;
11534
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011535 if (!curwin->w_p_spell)
11536 {
Yegappan Lakshmananaf936912023-02-20 12:16:39 +000011537 parse_spelllang(curwin);
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011538 curwin->w_p_spell = TRUE;
11539 }
11540
11541 if (*curwin->w_s->b_p_spl == NUL)
11542 {
Bram Moolenaar460ae5d2022-01-01 14:19:49 +000011543 emsg(_(e_spell_checking_is_not_possible));
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011544 curwin->w_p_spell = wo_spell_save;
11545 return;
11546 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011547#endif
11548
11549 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011550 {
11551#ifdef FEAT_SPELL
11552 curwin->w_p_spell = wo_spell_save;
11553#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011554 return;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011555 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011556
11557#ifdef FEAT_SPELL
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011558 str = tv_get_string(&argvars[0]);
11559 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011560 {
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011561 maxcount = (int)tv_get_number_chk(&argvars[1], &typeerr);
11562 if (maxcount <= 0)
11563 return;
11564 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011565 {
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011566 need_capital = (int)tv_get_bool_chk(&argvars[2], &typeerr);
11567 if (typeerr)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011568 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011569 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011570 }
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011571 else
11572 maxcount = 25;
11573
11574 spell_suggest_list(&ga, str, maxcount, need_capital, FALSE);
11575
11576 for (i = 0; i < ga.ga_len; ++i)
11577 {
11578 str = ((char_u **)ga.ga_data)[i];
11579
11580 li = listitem_alloc();
11581 if (li == NULL)
11582 vim_free(str);
11583 else
11584 {
11585 li->li_tv.v_type = VAR_STRING;
11586 li->li_tv.v_lock = 0;
11587 li->li_tv.vval.v_string = str;
11588 list_append(rettv->vval.v_list, li);
11589 }
11590 }
11591 ga_clear(&ga);
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011592 curwin->w_p_spell = wo_spell_save;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011593#endif
11594}
11595
11596 static void
11597f_split(typval_T *argvars, typval_T *rettv)
11598{
11599 char_u *str;
11600 char_u *end;
11601 char_u *pat = NULL;
11602 regmatch_T regmatch;
11603 char_u patbuf[NUMBUFLEN];
11604 char_u *save_cpo;
11605 int match;
11606 colnr_T col = 0;
11607 int keepempty = FALSE;
11608 int typeerr = FALSE;
11609
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011610 if (in_vim9script()
11611 && (check_for_string_arg(argvars, 0) == FAIL
11612 || check_for_opt_string_arg(argvars, 1) == FAIL
11613 || (argvars[1].v_type != VAR_UNKNOWN
11614 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
11615 return;
11616
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011617 // Make 'cpoptions' empty, the 'l' flag should not be used here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011618 save_cpo = p_cpo;
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010011619 p_cpo = empty_option;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011620
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011621 str = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011622 if (argvars[1].v_type != VAR_UNKNOWN)
11623 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011624 pat = tv_get_string_buf_chk(&argvars[1], patbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011625 if (pat == NULL)
11626 typeerr = TRUE;
11627 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar3986b942020-09-06 16:09:04 +020011628 keepempty = (int)tv_get_bool_chk(&argvars[2], &typeerr);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011629 }
11630 if (pat == NULL || *pat == NUL)
11631 pat = (char_u *)"[\\x01- ]\\+";
11632
11633 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar7d5e7442020-07-21 22:25:51 +020011634 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011635 if (typeerr)
Bram Moolenaar7d5e7442020-07-21 22:25:51 +020011636 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011637
11638 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
11639 if (regmatch.regprog != NULL)
11640 {
11641 regmatch.rm_ic = FALSE;
11642 while (*str != NUL || keepempty)
11643 {
11644 if (*str == NUL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011645 match = FALSE; // empty item at the end
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011646 else
11647 match = vim_regexec_nl(&regmatch, str, col);
11648 if (match)
11649 end = regmatch.startp[0];
11650 else
11651 end = str + STRLEN(str);
11652 if (keepempty || end > str || (rettv->vval.v_list->lv_len > 0
11653 && *str != NUL && match && end < regmatch.endp[0]))
11654 {
11655 if (list_append_string(rettv->vval.v_list, str,
11656 (int)(end - str)) == FAIL)
11657 break;
11658 }
11659 if (!match)
11660 break;
Bram Moolenaar13505972019-01-24 15:04:48 +010011661 // Advance to just after the match.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011662 if (regmatch.endp[0] > str)
11663 col = 0;
11664 else
Bram Moolenaar13505972019-01-24 15:04:48 +010011665 // Don't get stuck at the same match.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011666 col = (*mb_ptr2len)(regmatch.endp[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011667 str = regmatch.endp[0];
11668 }
11669
11670 vim_regfree(regmatch.regprog);
11671 }
11672
Bram Moolenaar7d5e7442020-07-21 22:25:51 +020011673theend:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011674 p_cpo = save_cpo;
11675}
11676
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011677/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011678 * "submatch()" function
11679 */
11680 static void
11681f_submatch(typval_T *argvars, typval_T *rettv)
11682{
11683 int error = FALSE;
11684 int no;
11685 int retList = 0;
11686
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011687 if (in_vim9script()
11688 && (check_for_number_arg(argvars, 0) == FAIL
11689 || check_for_opt_bool_arg(argvars, 1) == FAIL))
11690 return;
11691
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011692 no = (int)tv_get_number_chk(&argvars[0], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011693 if (error)
11694 return;
Bram Moolenaar989f5922016-08-21 15:26:54 +020011695 if (no < 0 || no >= NSUBEXP)
11696 {
Bram Moolenaard82a47d2022-01-05 20:24:39 +000011697 semsg(_(e_invalid_submatch_number_nr), no);
Bram Moolenaar79518e22017-02-17 16:31:35 +010011698 return;
Bram Moolenaar989f5922016-08-21 15:26:54 +020011699 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011700 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaarad304702020-09-06 18:22:53 +020011701 retList = (int)tv_get_bool_chk(&argvars[1], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011702 if (error)
11703 return;
11704
11705 if (retList == 0)
11706 {
11707 rettv->v_type = VAR_STRING;
11708 rettv->vval.v_string = reg_submatch(no);
11709 }
11710 else
11711 {
11712 rettv->v_type = VAR_LIST;
11713 rettv->vval.v_list = reg_submatch_list(no);
11714 }
11715}
11716
11717/*
11718 * "substitute()" function
11719 */
11720 static void
11721f_substitute(typval_T *argvars, typval_T *rettv)
11722{
11723 char_u patbuf[NUMBUFLEN];
11724 char_u subbuf[NUMBUFLEN];
11725 char_u flagsbuf[NUMBUFLEN];
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +020011726 char_u *str;
11727 char_u *pat;
Bram Moolenaar72ab7292016-07-19 19:10:51 +020011728 char_u *sub = NULL;
11729 typval_T *expr = NULL;
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +020011730 char_u *flg;
11731
11732 if (in_vim9script()
11733 && (check_for_string_arg(argvars, 0) == FAIL
11734 || check_for_string_arg(argvars, 1) == FAIL
11735 || check_for_string_arg(argvars, 3) == FAIL))
11736 return;
11737
11738 str = tv_get_string_chk(&argvars[0]);
11739 pat = tv_get_string_buf_chk(&argvars[1], patbuf);
11740 flg = tv_get_string_buf_chk(&argvars[3], flagsbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011741
LemonBoyf3b48952022-05-05 13:53:03 +010011742 if (argvars[2].v_type == VAR_FUNC
11743 || argvars[2].v_type == VAR_PARTIAL
Bram Moolenaar00b28d62022-12-08 15:32:33 +000011744 || argvars[2].v_type == VAR_INSTR
11745 || argvars[2].v_type == VAR_CLASS
11746 || argvars[2].v_type == VAR_OBJECT)
Bram Moolenaar72ab7292016-07-19 19:10:51 +020011747 expr = &argvars[2];
11748 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011749 sub = tv_get_string_buf_chk(&argvars[2], subbuf);
Bram Moolenaar72ab7292016-07-19 19:10:51 +020011750
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011751 rettv->v_type = VAR_STRING;
Bram Moolenaar72ab7292016-07-19 19:10:51 +020011752 if (str == NULL || pat == NULL || (sub == NULL && expr == NULL)
11753 || flg == NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011754 rettv->vval.v_string = NULL;
11755 else
John Marriottbd4614f2024-11-18 20:25:21 +010011756 rettv->vval.v_string = do_string_sub(str, STRLEN(str), pat, sub, expr, flg, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011757}
11758
11759/*
Bram Moolenaarc216a7a2022-12-05 13:50:55 +000011760 * "swapfilelist()" function
11761 */
11762 static void
11763f_swapfilelist(typval_T *argvars UNUSED, typval_T *rettv)
11764{
11765 if (rettv_list_alloc(rettv) == FAIL)
11766 return;
11767 recover_names(NULL, FALSE, rettv->vval.v_list, 0, NULL);
11768}
11769
11770/*
Bram Moolenaar00f123a2018-08-21 20:28:54 +020011771 * "swapinfo(swap_filename)" function
11772 */
11773 static void
11774f_swapinfo(typval_T *argvars, typval_T *rettv)
11775{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011776 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11777 return;
11778
Bram Moolenaar00f123a2018-08-21 20:28:54 +020011779 if (rettv_dict_alloc(rettv) == OK)
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011780 get_b0_dict(tv_get_string(argvars), rettv->vval.v_dict);
Bram Moolenaar00f123a2018-08-21 20:28:54 +020011781}
11782
11783/*
Bram Moolenaar110bd602018-09-16 18:46:59 +020011784 * "swapname(expr)" function
11785 */
11786 static void
11787f_swapname(typval_T *argvars, typval_T *rettv)
11788{
11789 buf_T *buf;
11790
11791 rettv->v_type = VAR_STRING;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011792
11793 if (in_vim9script() && check_for_buffer_arg(argvars, 0) == FAIL)
11794 return;
11795
Bram Moolenaarf2d79fa2019-01-03 22:19:27 +010011796 buf = tv_get_buf(&argvars[0], FALSE);
Bram Moolenaar110bd602018-09-16 18:46:59 +020011797 if (buf == NULL || buf->b_ml.ml_mfp == NULL
11798 || buf->b_ml.ml_mfp->mf_fname == NULL)
11799 rettv->vval.v_string = NULL;
11800 else
11801 rettv->vval.v_string = vim_strsave(buf->b_ml.ml_mfp->mf_fname);
11802}
11803
11804/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011805 * "synID(lnum, col, trans)" function
11806 */
11807 static void
11808f_synID(typval_T *argvars UNUSED, typval_T *rettv)
11809{
11810 int id = 0;
11811#ifdef FEAT_SYN_HL
11812 linenr_T lnum;
11813 colnr_T col;
11814 int trans;
11815 int transerr = FALSE;
11816
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011817 if (in_vim9script()
Yegappan Lakshmanancd917202021-07-21 19:09:09 +020011818 && (check_for_lnum_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011819 || check_for_number_arg(argvars, 1) == FAIL
11820 || check_for_bool_arg(argvars, 2) == FAIL))
11821 return;
11822
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011823 lnum = tv_get_lnum(argvars); // -1 on type error
11824 col = (linenr_T)tv_get_number(&argvars[1]) - 1; // -1 on type error
Bram Moolenaarfcb6d702020-09-05 21:41:56 +020011825 trans = (int)tv_get_bool_chk(&argvars[2], &transerr);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011826
11827 if (!transerr && lnum >= 1 && lnum <= curbuf->b_ml.ml_line_count
John Marriottbfcc8952024-03-11 22:04:45 +010011828 && col >= 0 && col < (long)ml_get_len(lnum))
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +000011829 id = syn_get_id(curwin, lnum, col, trans, NULL, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011830#endif
11831
11832 rettv->vval.v_number = id;
11833}
11834
11835/*
11836 * "synIDattr(id, what [, mode])" function
11837 */
11838 static void
11839f_synIDattr(typval_T *argvars UNUSED, typval_T *rettv)
11840{
11841 char_u *p = NULL;
11842#ifdef FEAT_SYN_HL
11843 int id;
11844 char_u *what;
11845 char_u *mode;
11846 char_u modebuf[NUMBUFLEN];
11847 int modec;
11848
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +020011849 if (in_vim9script()
11850 && (check_for_number_arg(argvars, 0) == FAIL
Yegappan Lakshmananf8dbd582021-09-26 19:04:05 +010011851 || check_for_string_arg(argvars, 1) == FAIL
11852 || check_for_opt_string_arg(argvars, 2) == FAIL))
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +020011853 return;
11854
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011855 id = (int)tv_get_number(&argvars[0]);
11856 what = tv_get_string(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011857 if (argvars[2].v_type != VAR_UNKNOWN)
11858 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011859 mode = tv_get_string_buf(&argvars[2], modebuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011860 modec = TOLOWER_ASC(mode[0]);
11861 if (modec != 't' && modec != 'c' && modec != 'g')
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011862 modec = 0; // replace invalid with current
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011863 }
11864 else
11865 {
11866#if defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS)
11867 if (USE_24BIT)
11868 modec = 'g';
11869 else
11870#endif
11871 if (t_colors > 1)
Dominique Pelle4781d6f2021-05-18 21:46:31 +020011872 modec = 'c';
11873 else
11874 modec = 't';
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011875 }
11876
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011877 switch (TOLOWER_ASC(what[0]))
11878 {
11879 case 'b':
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011880 if (TOLOWER_ASC(what[1]) == 'g') // bg[#]
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011881 p = highlight_color(id, what, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011882 else // bold
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011883 p = highlight_has_attr(id, HL_BOLD, modec);
11884 break;
11885
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011886 case 'f': // fg[#] or font
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011887 p = highlight_color(id, what, modec);
11888 break;
11889
11890 case 'i':
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011891 if (TOLOWER_ASC(what[1]) == 'n') // inverse
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011892 p = highlight_has_attr(id, HL_INVERSE, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011893 else // italic
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011894 p = highlight_has_attr(id, HL_ITALIC, modec);
11895 break;
11896
Martin Tournoijba43e762022-10-13 22:12:15 +010011897 case 'n':
Bram Moolenaarde786322022-07-30 14:56:17 +010011898 if (TOLOWER_ASC(what[1]) == 'o') // nocombine
11899 p = highlight_has_attr(id, HL_NOCOMBINE, modec);
11900 else // name
11901 p = get_highlight_name_ext(NULL, id - 1, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011902 break;
11903
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011904 case 'r': // reverse
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011905 p = highlight_has_attr(id, HL_INVERSE, modec);
11906 break;
11907
11908 case 's':
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011909 if (TOLOWER_ASC(what[1]) == 'p') // sp[#]
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011910 p = highlight_color(id, what, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011911 // strikeout
Bram Moolenaarcf4b00c2017-09-02 18:33:56 +020011912 else if (TOLOWER_ASC(what[1]) == 't' &&
11913 TOLOWER_ASC(what[2]) == 'r')
11914 p = highlight_has_attr(id, HL_STRIKETHROUGH, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011915 else // standout
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011916 p = highlight_has_attr(id, HL_STANDOUT, modec);
11917 break;
11918
11919 case 'u':
Bram Moolenaar84f54632022-06-29 18:39:11 +010011920 if (STRLEN(what) >= 9)
11921 {
11922 if (TOLOWER_ASC(what[5]) == 'l')
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011923 // underline
Bram Moolenaar84f54632022-06-29 18:39:11 +010011924 p = highlight_has_attr(id, HL_UNDERLINE, modec);
11925 else if (TOLOWER_ASC(what[5]) != 'd')
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011926 // undercurl
Bram Moolenaar84f54632022-06-29 18:39:11 +010011927 p = highlight_has_attr(id, HL_UNDERCURL, modec);
11928 else if (TOLOWER_ASC(what[6]) != 'o')
11929 // underdashed
11930 p = highlight_has_attr(id, HL_UNDERDASHED, modec);
11931 else if (TOLOWER_ASC(what[7]) == 'u')
11932 // underdouble
11933 p = highlight_has_attr(id, HL_UNDERDOUBLE, modec);
11934 else
11935 // underdotted
11936 p = highlight_has_attr(id, HL_UNDERDOTTED, modec);
11937 }
11938 else
11939 // ul
11940 p = highlight_color(id, what, modec);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011941 break;
11942 }
11943
11944 if (p != NULL)
11945 p = vim_strsave(p);
11946#endif
11947 rettv->v_type = VAR_STRING;
11948 rettv->vval.v_string = p;
11949}
11950
11951/*
11952 * "synIDtrans(id)" function
11953 */
11954 static void
11955f_synIDtrans(typval_T *argvars UNUSED, typval_T *rettv)
11956{
11957 int id;
11958
11959#ifdef FEAT_SYN_HL
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011960 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
11961 return;
11962
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011963 id = (int)tv_get_number(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011964
11965 if (id > 0)
11966 id = syn_get_final_id(id);
11967 else
11968#endif
11969 id = 0;
11970
11971 rettv->vval.v_number = id;
11972}
11973
11974/*
11975 * "synconcealed(lnum, col)" function
11976 */
11977 static void
11978f_synconcealed(typval_T *argvars UNUSED, typval_T *rettv)
11979{
11980#if defined(FEAT_SYN_HL) && defined(FEAT_CONCEAL)
11981 linenr_T lnum;
11982 colnr_T col;
11983 int syntax_flags = 0;
11984 int cchar;
11985 int matchid = 0;
11986 char_u str[NUMBUFLEN];
11987#endif
11988
Bram Moolenaar45cf6e92017-04-30 20:25:19 +020011989 rettv_list_set(rettv, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011990
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020011991 if (in_vim9script()
Yegappan Lakshmanancd917202021-07-21 19:09:09 +020011992 && (check_for_lnum_arg(argvars, 0) == FAIL
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020011993 || check_for_number_arg(argvars, 1) == FAIL))
11994 return;
11995
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011996#if defined(FEAT_SYN_HL) && defined(FEAT_CONCEAL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011997 lnum = tv_get_lnum(argvars); // -1 on type error
11998 col = (colnr_T)tv_get_number(&argvars[1]) - 1; // -1 on type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011999
Bram Moolenaara80faa82020-04-12 19:37:17 +020012000 CLEAR_FIELD(str);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012001
Bram Moolenaar93a10962022-06-16 11:42:09 +010012002 if (rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012003 {
12004 if (lnum >= 1 && lnum <= curbuf->b_ml.ml_line_count
John Marriottbfcc8952024-03-11 22:04:45 +010012005 && col >= 0 && col <= (long)ml_get_len(lnum)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012006 && curwin->w_p_cole > 0)
12007 {
12008 (void)syn_get_id(curwin, lnum, col, FALSE, NULL, FALSE);
12009 syntax_flags = get_syntax_info(&matchid);
12010
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012011 // get the conceal character
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012012 if ((syntax_flags & HL_CONCEAL) && curwin->w_p_cole < 3)
12013 {
12014 cchar = syn_get_sub_char();
Bram Moolenaar4d785892017-06-22 22:00:50 +020012015 if (cchar == NUL && curwin->w_p_cole == 1)
Bram Moolenaareed9d462021-02-15 20:38:25 +010012016 cchar = (curwin->w_lcs_chars.conceal == NUL) ? ' '
12017 : curwin->w_lcs_chars.conceal;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012018 if (cchar != NUL)
12019 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012020 if (has_mbyte)
12021 (*mb_char2bytes)(cchar, str);
12022 else
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012023 str[0] = cchar;
12024 }
12025 }
12026 }
12027
12028 list_append_number(rettv->vval.v_list,
12029 (syntax_flags & HL_CONCEAL) != 0);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012030 // -1 to auto-determine strlen
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012031 list_append_string(rettv->vval.v_list, str, -1);
12032 list_append_number(rettv->vval.v_list, matchid);
12033 }
12034#endif
12035}
12036
12037/*
12038 * "synstack(lnum, col)" function
12039 */
12040 static void
12041f_synstack(typval_T *argvars UNUSED, typval_T *rettv)
12042{
12043#ifdef FEAT_SYN_HL
12044 linenr_T lnum;
12045 colnr_T col;
12046 int i;
12047 int id;
12048#endif
12049
Bram Moolenaar45cf6e92017-04-30 20:25:19 +020012050 rettv_list_set(rettv, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012051
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020012052 if (in_vim9script()
Yegappan Lakshmanancd917202021-07-21 19:09:09 +020012053 && (check_for_lnum_arg(argvars, 0) == FAIL
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020012054 || check_for_number_arg(argvars, 1) == FAIL))
12055 return;
12056
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012057#ifdef FEAT_SYN_HL
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012058 lnum = tv_get_lnum(argvars); // -1 on type error
12059 col = (colnr_T)tv_get_number(&argvars[1]) - 1; // -1 on type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012060
12061 if (lnum >= 1 && lnum <= curbuf->b_ml.ml_line_count
John Marriottbfcc8952024-03-11 22:04:45 +010012062 && col >= 0 && col <= (long)ml_get_len(lnum)
Bram Moolenaar93a10962022-06-16 11:42:09 +010012063 && rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012064 {
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +000012065 (void)syn_get_id(curwin, lnum, col, FALSE, NULL, TRUE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012066 for (i = 0; ; ++i)
12067 {
12068 id = syn_get_stack_item(i);
12069 if (id < 0)
12070 break;
12071 if (list_append_number(rettv->vval.v_list, id) == FAIL)
12072 break;
12073 }
12074 }
12075#endif
12076}
12077
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012078/*
12079 * "tabpagebuflist()" function
12080 */
12081 static void
12082f_tabpagebuflist(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
12083{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012084 tabpage_T *tp;
12085 win_T *wp = NULL;
12086
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012087 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
12088 return;
12089
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012090 if (argvars[0].v_type == VAR_UNKNOWN)
12091 wp = firstwin;
12092 else
12093 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012094 tp = find_tabpage((int)tv_get_number(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012095 if (tp != NULL)
12096 wp = (tp == curtab) ? firstwin : tp->tp_firstwin;
12097 }
Bram Moolenaar93a10962022-06-16 11:42:09 +010012098 if (wp != NULL && rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012099 {
12100 for (; wp != NULL; wp = wp->w_next)
12101 if (list_append_number(rettv->vval.v_list,
12102 wp->w_buffer->b_fnum) == FAIL)
12103 break;
12104 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012105}
12106
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012107/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012108 * "tagfiles()" function
12109 */
12110 static void
12111f_tagfiles(typval_T *argvars UNUSED, typval_T *rettv)
12112{
12113 char_u *fname;
12114 tagname_T tn;
12115 int first;
12116
12117 if (rettv_list_alloc(rettv) == FAIL)
12118 return;
12119 fname = alloc(MAXPATHL);
12120 if (fname == NULL)
12121 return;
12122
12123 for (first = TRUE; ; first = FALSE)
12124 if (get_tagfname(&tn, first, fname) == FAIL
12125 || list_append_string(rettv->vval.v_list, fname, -1) == FAIL)
12126 break;
12127 tagname_free(&tn);
12128 vim_free(fname);
12129}
12130
12131/*
12132 * "taglist()" function
12133 */
12134 static void
12135f_taglist(typval_T *argvars, typval_T *rettv)
12136{
Bram Moolenaarc6aafba2017-03-21 17:09:10 +010012137 char_u *fname = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012138 char_u *tag_pattern;
12139
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012140 if (in_vim9script()
12141 && (check_for_string_arg(argvars, 0) == FAIL
12142 || check_for_opt_string_arg(argvars, 1) == FAIL))
12143 return;
12144
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012145 tag_pattern = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012146
12147 rettv->vval.v_number = FALSE;
12148 if (*tag_pattern == NUL)
12149 return;
12150
Bram Moolenaarc6aafba2017-03-21 17:09:10 +010012151 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012152 fname = tv_get_string(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012153 if (rettv_list_alloc(rettv) == OK)
Bram Moolenaarc6aafba2017-03-21 17:09:10 +010012154 (void)get_tags(rettv->vval.v_list, tag_pattern, fname);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012155}
12156
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012157/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012158 * "type(expr)" function
12159 */
12160 static void
12161f_type(typval_T *argvars, typval_T *rettv)
12162{
12163 int n = -1;
12164
12165 switch (argvars[0].v_type)
12166 {
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +010012167 case VAR_NUMBER: n = VAR_TYPE_NUMBER; break;
12168 case VAR_STRING: n = VAR_TYPE_STRING; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012169 case VAR_PARTIAL:
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +010012170 case VAR_FUNC: n = VAR_TYPE_FUNC; break;
12171 case VAR_LIST: n = VAR_TYPE_LIST; break;
12172 case VAR_DICT: n = VAR_TYPE_DICT; break;
12173 case VAR_FLOAT: n = VAR_TYPE_FLOAT; break;
12174 case VAR_BOOL: n = VAR_TYPE_BOOL; break;
12175 case VAR_SPECIAL: n = VAR_TYPE_NONE; break;
Bram Moolenaarf562e722016-07-19 17:25:25 +020012176 case VAR_JOB: n = VAR_TYPE_JOB; break;
12177 case VAR_CHANNEL: n = VAR_TYPE_CHANNEL; break;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +010012178 case VAR_BLOB: n = VAR_TYPE_BLOB; break;
Bram Moolenaarf18332f2021-05-07 17:55:55 +020012179 case VAR_INSTR: n = VAR_TYPE_INSTR; break;
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +020012180 case VAR_TYPEALIAS: n = VAR_TYPE_TYPEALIAS; break;
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012181 case VAR_CLASS:
12182 {
12183 class_T *cl = argvars[0].vval.v_class;
Yegappan Lakshmananda9d3452024-05-02 13:02:36 +020012184 if (cl != NULL && IS_ENUM(cl))
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012185 n = VAR_TYPE_ENUM;
12186 else
12187 n = VAR_TYPE_CLASS;
12188 break;
12189 }
12190 case VAR_OBJECT:
12191 {
Yegappan Lakshmananb2e42b92024-05-01 11:44:17 +020012192 object_T *obj = argvars[0].vval.v_object;
12193
12194 if (obj == NULL)
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012195 n = VAR_TYPE_OBJECT;
Yegappan Lakshmananb2e42b92024-05-01 11:44:17 +020012196 else
12197 {
12198 class_T *cl = argvars[0].vval.v_object->obj_class;
12199 if (IS_ENUM(cl))
12200 n = VAR_TYPE_ENUMVALUE;
12201 else
12202 n = VAR_TYPE_OBJECT;
12203 }
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012204 break;
12205 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012206 case VAR_UNKNOWN:
Bram Moolenaar4c683752020-04-05 21:38:23 +020012207 case VAR_ANY:
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010012208 case VAR_VOID:
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012209 internal_error_no_abort("f_type(UNKNOWN)");
12210 n = -1;
12211 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012212 }
12213 rettv->vval.v_number = n;
12214}
12215
12216/*
zeertzjq825cf812023-08-17 22:55:25 +020012217 * "virtcol({expr}, [, {list} [, {winid}]])" function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012218 */
12219 static void
12220f_virtcol(typval_T *argvars, typval_T *rettv)
12221{
LemonBoy0f7a3e12022-05-26 12:10:37 +010012222 colnr_T vcol_start = 0;
12223 colnr_T vcol_end = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012224 pos_T *fp;
zeertzjq825cf812023-08-17 22:55:25 +020012225 switchwin_T switchwin;
12226 int winchanged = FALSE;
Bram Moolenaarb3d33d82020-01-15 20:36:55 +010012227 int len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012228
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012229 if (in_vim9script()
LemonBoy0f7a3e12022-05-26 12:10:37 +010012230 && (check_for_string_or_list_arg(argvars, 0) == FAIL
12231 || (argvars[1].v_type != VAR_UNKNOWN
zeertzjq825cf812023-08-17 22:55:25 +020012232 && (check_for_bool_arg(argvars, 1) == FAIL
12233 || check_for_opt_number_arg(argvars, 2) == FAIL))))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012234 return;
12235
zeertzjq825cf812023-08-17 22:55:25 +020012236 if (argvars[1].v_type != VAR_UNKNOWN && argvars[2].v_type != VAR_UNKNOWN)
12237 {
12238 tabpage_T *tp;
12239 win_T *wp;
12240
12241 // use the window specified in the third argument
12242 wp = win_id2wp_tp((int)tv_get_number(&argvars[2]), &tp);
12243 if (wp == NULL || tp == NULL)
12244 goto theend;
12245
12246 if (switch_win_noblock(&switchwin, wp, tp, TRUE) != OK)
12247 goto theend;
12248
12249 check_cursor();
12250 winchanged = TRUE;
12251 }
12252
12253 int fnum = curbuf->b_fnum;
Bram Moolenaar6f02b002021-01-10 20:22:54 +010012254 fp = var2fpos(&argvars[0], FALSE, &fnum, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012255 if (fp != NULL && fp->lnum <= curbuf->b_ml.ml_line_count
LemonBoy0f7a3e12022-05-26 12:10:37 +010012256 && fnum == curbuf->b_fnum)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012257 {
Bram Moolenaarb3d33d82020-01-15 20:36:55 +010012258 // Limit the column to a valid value, getvvcol() doesn't check.
12259 if (fp->col < 0)
12260 fp->col = 0;
12261 else
12262 {
John Marriottbfcc8952024-03-11 22:04:45 +010012263 len = (int)ml_get_len(fp->lnum);
Bram Moolenaarb3d33d82020-01-15 20:36:55 +010012264 if (fp->col > len)
12265 fp->col = len;
12266 }
LemonBoy0f7a3e12022-05-26 12:10:37 +010012267 getvvcol(curwin, fp, &vcol_start, NULL, &vcol_end);
12268 ++vcol_start;
12269 ++vcol_end;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012270 }
12271
zeertzjq825cf812023-08-17 22:55:25 +020012272theend:
LemonBoy0f7a3e12022-05-26 12:10:37 +010012273 if (argvars[1].v_type != VAR_UNKNOWN && tv_get_bool(&argvars[1]))
12274 {
12275 if (rettv_list_alloc(rettv) == OK)
12276 {
12277 list_append_number(rettv->vval.v_list, vcol_start);
12278 list_append_number(rettv->vval.v_list, vcol_end);
12279 }
12280 else
12281 rettv->vval.v_number = 0;
12282 }
12283 else
12284 rettv->vval.v_number = vcol_end;
zeertzjq825cf812023-08-17 22:55:25 +020012285
12286 if (winchanged)
12287 restore_win_noblock(&switchwin, TRUE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012288}
12289
12290/*
12291 * "visualmode()" function
12292 */
12293 static void
12294f_visualmode(typval_T *argvars, typval_T *rettv)
12295{
12296 char_u str[2];
12297
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012298 if (in_vim9script() && check_for_opt_bool_arg(argvars, 0) == FAIL)
12299 return;
12300
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012301 rettv->v_type = VAR_STRING;
12302 str[0] = curbuf->b_visual_mode_eval;
12303 str[1] = NUL;
12304 rettv->vval.v_string = vim_strsave(str);
12305
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012306 // A non-zero number or non-empty string argument: reset mode.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012307 if (non_zero_arg(&argvars[0]))
12308 curbuf->b_visual_mode_eval = NUL;
12309}
12310
12311/*
12312 * "wildmenumode()" function
12313 */
12314 static void
12315f_wildmenumode(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
12316{
Bram Moolenaar24959102022-05-07 20:01:16 +010012317 if (wild_menu_showing || ((State & MODE_CMDLINE) && cmdline_pum_active()))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012318 rettv->vval.v_number = 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012319}
12320
12321/*
Bram Moolenaar0c1e3742019-12-27 13:49:24 +010012322 * "windowsversion()" function
12323 */
12324 static void
12325f_windowsversion(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
12326{
12327 rettv->v_type = VAR_STRING;
12328 rettv->vval.v_string = vim_strsave((char_u *)windowsVersion);
12329}
12330
12331/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012332 * "wordcount()" function
12333 */
12334 static void
12335f_wordcount(typval_T *argvars UNUSED, typval_T *rettv)
12336{
12337 if (rettv_dict_alloc(rettv) == FAIL)
12338 return;
12339 cursor_pos_info(rettv->vval.v_dict);
12340}
12341
12342/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012343 * "xor(expr, expr)" function
12344 */
12345 static void
12346f_xor(typval_T *argvars, typval_T *rettv)
12347{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012348 if (in_vim9script()
12349 && (check_for_number_arg(argvars, 0) == FAIL
12350 || check_for_number_arg(argvars, 1) == FAIL))
12351 return;
12352
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012353 rettv->vval.v_number = tv_get_number_chk(&argvars[0], NULL)
12354 ^ tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012355}
12356
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012357#endif // FEAT_EVAL