blob: 69b6a4fa89896a63df7741faa878d74cefe96894 [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/*
zeertzjqe0a2ab32025-02-02 09:14:35 +0100391 * Check "type" is a bool or a number.
392 */
393 static int
394arg_bool_or_nr(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
395{
396 if (type->tt_type == VAR_BOOL
397 || type->tt_type == VAR_NUMBER
398 || type_any_or_unknown(type))
399 return OK;
400 arg_type_mismatch(&t_number, type, context->arg_idx + 1);
401 return FAIL;
402}
403
404/*
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200405 * Check "type" is a list of 'any' or a blob.
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100406 */
Bram Moolenaarca174532020-10-21 16:42:22 +0200407 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000408arg_list_or_blob(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarca174532020-10-21 16:42:22 +0200409{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100410 if (type->tt_type == VAR_LIST
411 || type->tt_type == VAR_BLOB
412 || type_any_or_unknown(type))
Bram Moolenaarca174532020-10-21 16:42:22 +0200413 return OK;
414 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
415 return FAIL;
416}
417
418/*
Bram Moolenaarfa103972022-09-29 19:14:42 +0100419 * Check "type" is a modifiable list of 'any' or a blob.
420 */
421 static int
422arg_list_or_blob_mod(
423 type_T *type,
424 type_T *decl_type,
425 argcontext_T *context)
426{
427 if (arg_list_or_blob(type, decl_type, context) == FAIL)
428 return FAIL;
429 return arg_type_modifiable(type, context->arg_idx + 1);
430}
431
432/*
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200433 * Check "type" is a string or a number
434 */
435 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000436arg_string_or_nr(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +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 Lakshmanana26f56f2021-07-03 11:58:12 +0200441 return OK;
442 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
443 return FAIL;
444}
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200445
446/*
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200447 * Check "type" is a buffer (string or a number)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200448 */
449 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000450arg_buffer(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200451{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100452 if (type->tt_type == VAR_STRING
453 || type->tt_type == VAR_NUMBER
454 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200455 return OK;
456 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
457 return FAIL;
458}
459
460/*
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200461 * Check "type" is a buffer or a dict of any
462 */
463 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000464arg_buffer_or_dict_any(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200465{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100466 if (type->tt_type == VAR_STRING
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200467 || type->tt_type == VAR_NUMBER
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100468 || type->tt_type == VAR_DICT
469 || type_any_or_unknown(type))
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200470 return OK;
471 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
472 return FAIL;
473}
474
475/*
476 * Check "type" is a line (string or a number)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200477 */
478 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000479arg_lnum(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200480{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100481 if (type->tt_type == VAR_STRING
482 || type->tt_type == VAR_NUMBER
483 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200484 return OK;
485 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
486 return FAIL;
487}
488
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200489/*
Bram Moolenaarca81f0e2021-06-20 14:41:01 +0200490 * Check "type" is a string or a list of strings.
491 */
492 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000493arg_string_or_list_string(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarca81f0e2021-06-20 14:41:01 +0200494{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100495 if (type->tt_type == VAR_STRING
496 || type_any_or_unknown(type))
Bram Moolenaarca81f0e2021-06-20 14:41:01 +0200497 return OK;
498 if (type->tt_type != VAR_LIST)
499 {
500 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
501 return FAIL;
502 }
503 if (type->tt_member->tt_type == VAR_ANY
504 || type->tt_member->tt_type == VAR_STRING)
505 return OK;
506
507 arg_type_mismatch(&t_list_string, type, context->arg_idx + 1);
508 return FAIL;
509}
510
511/*
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200512 * Check "type" is a string or a list of 'any'
513 */
514 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000515arg_string_or_list_any(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200516{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100517 if (type->tt_type == VAR_STRING
518 || type->tt_type == VAR_LIST
519 || type_any_or_unknown(type))
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200520 return OK;
521 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
522 return FAIL;
523}
524
525/*
Ernie Rael51d04d12022-05-04 15:40:22 +0100526 * Check "type" is a string or a dict of 'any'
527 */
528 static int
529arg_string_or_dict_any(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
530{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100531 if (type->tt_type == VAR_STRING
532 || type->tt_type == VAR_DICT
533 || type_any_or_unknown(type))
Ernie Rael51d04d12022-05-04 15:40:22 +0100534 return OK;
535 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
536 return FAIL;
537}
538
539/*
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200540 * Check "type" is a string or a blob
541 */
542 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000543arg_string_or_blob(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200544{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100545 if (type->tt_type == VAR_STRING
546 || type->tt_type == VAR_BLOB
547 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200548 return OK;
549 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
550 return FAIL;
551}
552
553/*
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +0200554 * Check "type" is a list of 'any' or a dict of 'any'.
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100555 */
556 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000557arg_list_or_dict(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100558{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100559 if (type->tt_type == VAR_LIST
560 || type->tt_type == VAR_DICT
561 || type_any_or_unknown(type))
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100562 return OK;
563 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
564 return FAIL;
565}
566
567/*
Bram Moolenaarfa103972022-09-29 19:14:42 +0100568 * Check "type" is a list of 'any' or a dict of 'any'. And modifiable.
569 */
570 static int
571arg_list_or_dict_mod(
572 type_T *type,
573 type_T *decl_type,
574 argcontext_T *context)
575{
576 if (arg_list_or_dict(type, decl_type, context) == FAIL)
577 return FAIL;
578 return arg_type_modifiable(type, context->arg_idx + 1);
579}
580
581/*
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200582 * Check "type" is a list of 'any' or a dict of 'any' or a blob.
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100583 * Also check if "type" is modifiable.
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200584 */
585 static int
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100586arg_list_or_dict_or_blob_mod(
587 type_T *type,
588 type_T *decl_type UNUSED,
589 argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200590{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100591 if (type->tt_type == VAR_LIST
Bram Moolenaar59618fe2021-12-21 12:32:17 +0000592 || type->tt_type == VAR_DICT
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100593 || type->tt_type == VAR_BLOB
594 || type_any_or_unknown(type))
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100595 return arg_type_modifiable(type, context->arg_idx + 1);
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200596 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
597 return FAIL;
598}
599
600/*
Bram Moolenaar2d877592021-12-16 08:21:09 +0000601 * Check "type" is a list of 'any' or a dict of 'any' or a blob or a string.
602 */
603 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000604arg_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 +0000605{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100606 if (type->tt_type == VAR_LIST
Bram Moolenaar59618fe2021-12-21 12:32:17 +0000607 || type->tt_type == VAR_DICT
608 || type->tt_type == VAR_BLOB
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100609 || type->tt_type == VAR_STRING
610 || type_any_or_unknown(type))
Bram Moolenaar2d877592021-12-16 08:21:09 +0000611 return OK;
612 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
613 return FAIL;
614}
615
616/*
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100617 * Check "type" is a list of 'any' or a dict of 'any' or a blob or a string.
618 * Also check the value is modifiable.
619 */
620 static int
621arg_list_or_dict_or_blob_or_string_mod(
622 type_T *type,
623 type_T *decl_type,
624 argcontext_T *context)
625{
626 if (arg_list_or_dict_or_blob_or_string(type, decl_type, context) == FAIL)
627 return FAIL;
628 return arg_type_modifiable(type, context->arg_idx + 1);
629}
630
631/*
Ernie Raele79e2072024-01-13 11:47:33 +0100632 * Check second argument of map(), filter(), foreach().
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000633 */
634 static int
Ernie Raele79e2072024-01-13 11:47:33 +0100635check_map_filter_arg2(type_T *type, argcontext_T *context,
636 filtermap_T filtermap)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000637{
638 type_T *expected_member = NULL;
639 type_T *(args[2]);
Bram Moolenaarb1e32ac2023-02-21 12:38:51 +0000640 type_T t_func_exp = {VAR_FUNC, 2, 0, 0, NULL, NULL, args};
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000641
642 if (context->arg_types[0].type_curr->tt_type == VAR_LIST
643 || context->arg_types[0].type_curr->tt_type == VAR_DICT)
644 {
645 // Use the declared type if possible, so that an error is given if
646 // a declared list changes type, but not if a constant list changes
647 // type.
648 if (context->arg_types[0].type_decl->tt_type == VAR_LIST
649 || context->arg_types[0].type_decl->tt_type == VAR_DICT)
650 expected_member = context->arg_types[0].type_decl->tt_member;
651 else
652 expected_member = context->arg_types[0].type_curr->tt_member;
653 }
654 else if (context->arg_types[0].type_curr->tt_type == VAR_STRING)
655 expected_member = &t_string;
656 else if (context->arg_types[0].type_curr->tt_type == VAR_BLOB)
657 expected_member = &t_number;
658
659 args[0] = NULL;
660 args[1] = &t_unknown;
661 if (type->tt_argcount != -1)
662 {
663 if (!(type->tt_argcount == 2 || (type->tt_argcount == 1
664 && (type->tt_flags & TTFLAG_VARARGS))))
665 {
666 emsg(_(e_invalid_number_of_arguments));
667 return FAIL;
668 }
669 if (type->tt_flags & TTFLAG_VARARGS)
670 // check the argument types at runtime
671 t_func_exp.tt_argcount = -1;
672 else
673 {
674 if (context->arg_types[0].type_curr->tt_type == VAR_STRING
675 || context->arg_types[0].type_curr->tt_type == VAR_BLOB
676 || context->arg_types[0].type_curr->tt_type == VAR_LIST)
677 args[0] = &t_number;
678 else if (context->arg_types[0].type_decl->tt_type == VAR_DICT)
679 args[0] = &t_string;
680 if (args[0] != NULL)
681 args[1] = expected_member;
682 }
683 }
684
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100685 if (!type_any_or_unknown(type->tt_member) || args[0] != NULL)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000686 {
687 where_T where = WHERE_INIT;
688
Ernie Raele79e2072024-01-13 11:47:33 +0100689 if (filtermap == FILTERMAP_MAP)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000690 t_func_exp.tt_member = expected_member == NULL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100691 || type_any_or_unknown(type->tt_member)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000692 ? &t_any : expected_member;
Ernie Raele79e2072024-01-13 11:47:33 +0100693 else if (filtermap == FILTERMAP_FILTER)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000694 t_func_exp.tt_member = &t_bool;
Ernie Raele79e2072024-01-13 11:47:33 +0100695 else // filtermap == FILTERMAP_FOREACH
696 t_func_exp.tt_member = &t_unknown;
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000697 if (args[0] == NULL)
698 args[0] = &t_unknown;
Bram Moolenaar6e1a3872022-02-23 19:11:49 +0000699 if (type->tt_argcount == -1)
700 t_func_exp.tt_argcount = -1;
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000701
702 where.wt_index = 2;
LemonBoyc5d27442023-08-19 13:02:35 +0200703 where.wt_kind = WT_ARGUMENT;
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000704 return check_type(&t_func_exp, type, TRUE, where);
705 }
706 return OK;
707}
708
709/*
Bram Moolenaar18024052021-12-25 21:43:28 +0000710 * Check second argument of filter(): func must return a bool.
711 */
712 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000713arg_filter_func(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaar18024052021-12-25 21:43:28 +0000714{
Bram Moolenaar1080c482022-01-26 18:26:21 +0000715 if (type->tt_type == VAR_STRING
716 || type->tt_type == VAR_PARTIAL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100717 || type_any_or_unknown(type))
Bram Moolenaar1080c482022-01-26 18:26:21 +0000718 return OK;
719
720 if (type->tt_type == VAR_FUNC)
Ernie Raele79e2072024-01-13 11:47:33 +0100721 return check_map_filter_arg2(type, context, FILTERMAP_FILTER);
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000722 semsg(_(e_string_or_function_required_for_argument_nr), 2);
723 return FAIL;
Bram Moolenaar18024052021-12-25 21:43:28 +0000724}
725
726/*
Bram Moolenaareddd4fc2022-02-20 15:52:28 +0000727 * Check second argument of map(), the function.
Bram Moolenaar18024052021-12-25 21:43:28 +0000728 */
729 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000730arg_map_func(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaar18024052021-12-25 21:43:28 +0000731{
Bram Moolenaar1080c482022-01-26 18:26:21 +0000732 if (type->tt_type == VAR_STRING
733 || type->tt_type == VAR_PARTIAL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100734 || type_any_or_unknown(type))
Bram Moolenaar1080c482022-01-26 18:26:21 +0000735 return OK;
736
737 if (type->tt_type == VAR_FUNC)
Ernie Raele79e2072024-01-13 11:47:33 +0100738 return check_map_filter_arg2(type, context, FILTERMAP_MAP);
739 semsg(_(e_string_or_function_required_for_argument_nr), 2);
740 return FAIL;
741}
742
743/*
744 * Check second argument of foreach(), the function.
745 */
746 static int
747arg_foreach_func(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
748{
749 if (type->tt_type == VAR_STRING
750 || type->tt_type == VAR_PARTIAL
751 || type_any_or_unknown(type))
752 return OK;
753
754 if (type->tt_type == VAR_FUNC)
755 return check_map_filter_arg2(type, context, FILTERMAP_FOREACH);
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000756 semsg(_(e_string_or_function_required_for_argument_nr), 2);
757 return FAIL;
Bram Moolenaar18024052021-12-25 21:43:28 +0000758}
759
760/*
Bram Moolenaare843efc2022-02-22 21:54:44 +0000761 * Check second argument of sort() and uniq(), the "how" argument.
762 */
763 static int
764arg_sort_how(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
765{
766 if (type->tt_type == VAR_STRING
767 || type->tt_type == VAR_PARTIAL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100768 || type_any_or_unknown(type))
Bram Moolenaare843efc2022-02-22 21:54:44 +0000769 return OK;
770
771 if (type->tt_type == VAR_FUNC)
772 {
773 type_T *(args[2]);
Bram Moolenaarb1e32ac2023-02-21 12:38:51 +0000774 type_T t_func_exp = {VAR_FUNC, 2, 0, 0, &t_number, NULL, args};
Bram Moolenaare843efc2022-02-22 21:54:44 +0000775
776 if (context->arg_types[0].type_curr->tt_type == VAR_LIST)
777 args[0] = context->arg_types[0].type_curr->tt_member;
778 else
779 args[0] = &t_unknown;
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100780 if (!type_any_or_unknown(type->tt_member) || args[0] != &t_unknown)
Bram Moolenaare843efc2022-02-22 21:54:44 +0000781 {
782 where_T where = WHERE_INIT;
783
784 args[1] = args[0];
Bram Moolenaarfa026162022-02-23 21:03:32 +0000785 if (type->tt_argcount == -1)
786 t_func_exp.tt_argcount = -1;
Bram Moolenaare843efc2022-02-22 21:54:44 +0000787 where.wt_index = 2;
LemonBoyc5d27442023-08-19 13:02:35 +0200788 where.wt_kind = WT_ARGUMENT;
Bram Moolenaare843efc2022-02-22 21:54:44 +0000789 return check_type(&t_func_exp, type, TRUE, where);
790 }
791
792 return OK;
793 }
794 semsg(_(e_string_or_function_required_for_argument_nr), 2);
795 return FAIL;
796}
797
798/*
Bram Moolenaar73199812021-12-26 17:18:14 +0000799 * Check an expression argument, can be a string, funcref or partial.
800 * Also accept a bool, a constant resulting from compiling a string argument.
801 * Also accept a number, one and zero are accepted.
802 */
803 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000804arg_string_or_func(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaar73199812021-12-26 17:18:14 +0000805{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100806 if (type->tt_type == VAR_STRING
Bram Moolenaar73199812021-12-26 17:18:14 +0000807 || type->tt_type == VAR_PARTIAL
808 || type->tt_type == VAR_FUNC
809 || type->tt_type == VAR_BOOL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100810 || type->tt_type == VAR_NUMBER
811 || type_any_or_unknown(type))
Bram Moolenaar73199812021-12-26 17:18:14 +0000812 return OK;
813 arg_type_mismatch(&t_func_any, type, context->arg_idx + 1);
814 return FAIL;
815}
816
817/*
Ernie Rael2025af12023-12-12 16:58:00 +0100818 * Check varargs' "type" are class.
LemonBoyafe04662023-08-23 21:08:11 +0200819 */
820 static int
Ernie Rael2025af12023-12-12 16:58:00 +0100821varargs_class(type_T *type UNUSED,
822 type_T *decl_type UNUSED,
823 argcontext_T *context)
LemonBoyafe04662023-08-23 21:08:11 +0200824{
Ernie Rael2025af12023-12-12 16:58:00 +0100825 for (int i = context->arg_idx; i < context->arg_count; ++i)
826 {
827 type2_T *types = &context->arg_types[i];
828 if (types->type_curr->tt_type != VAR_CLASS)
829 {
830 semsg(_(e_class_or_typealias_required_for_argument_nr), i + 1);
831 return FAIL;
832 }
833 }
834 return OK;
LemonBoyafe04662023-08-23 21:08:11 +0200835}
836
837/*
rbtnn0ccb5842021-12-18 18:33:46 +0000838 * Check "type" is a list of 'any' or a blob or a string.
839 */
840 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000841arg_string_list_or_blob(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
rbtnn0ccb5842021-12-18 18:33:46 +0000842{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100843 if (type->tt_type == VAR_LIST
Bram Moolenaar59618fe2021-12-21 12:32:17 +0000844 || type->tt_type == VAR_BLOB
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100845 || type->tt_type == VAR_STRING
846 || type_any_or_unknown(type))
rbtnn0ccb5842021-12-18 18:33:46 +0000847 return OK;
848 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
849 return FAIL;
850}
851
852/*
Yegappan Lakshmananf9dc2782023-05-11 15:02:56 +0100853 * Check "type" is a modifiable list of 'any' or a blob or a string.
854 */
855 static int
856arg_string_list_or_blob_mod(type_T *type, type_T *decl_type, argcontext_T *context)
857{
858 if (arg_string_list_or_blob(type, decl_type, context) == FAIL)
859 return FAIL;
860 return arg_type_modifiable(type, context->arg_idx + 1);
861}
862
863/*
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +0200864 * Check "type" is a job.
865 */
866 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000867arg_job(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +0200868{
869 return check_arg_type(&t_job, type, context);
870}
871
872/*
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +0200873 * Check "type" is a channel or a job.
874 */
875 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000876arg_chan_or_job(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +0200877{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100878 if (type->tt_type == VAR_CHANNEL
879 || type->tt_type == VAR_JOB
880 || type_any_or_unknown(type))
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +0200881 return OK;
882 arg_type_mismatch(&t_channel, type, context->arg_idx + 1);
883 return FAIL;
884}
885
886/*
Bram Moolenaar078a4612022-01-04 15:17:03 +0000887 * Check "type" can be used as the type_decl of the previous argument.
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100888 * Must not be used for the first argcheck_T entry.
889 */
890 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000891arg_same_as_prev(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100892{
Bram Moolenaar078a4612022-01-04 15:17:03 +0000893 type_T *prev_type = context->arg_types[context->arg_idx - 1].type_decl;
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100894
Bram Moolenaar351ead02021-01-16 16:07:01 +0100895 return check_arg_type(prev_type, type, context);
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100896}
897
898/*
Bram Moolenaarb0e6b512021-01-12 20:23:40 +0100899 * Check "type" is the same basic type as the previous argument, checks list or
900 * dict vs other type, but not member type.
901 * Must not be used for the first argcheck_T entry.
902 */
903 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000904arg_same_struct_as_prev(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarb0e6b512021-01-12 20:23:40 +0100905{
Bram Moolenaar078a4612022-01-04 15:17:03 +0000906 type_T *prev_type = context->arg_types[context->arg_idx - 1].type_curr;
Bram Moolenaarb0e6b512021-01-12 20:23:40 +0100907
Bram Moolenaar078a4612022-01-04 15:17:03 +0000908 if (prev_type->tt_type != context->arg_types[context->arg_idx].type_curr->tt_type)
Bram Moolenaar351ead02021-01-16 16:07:01 +0100909 return check_arg_type(prev_type, type, context);
Bram Moolenaarb0e6b512021-01-12 20:23:40 +0100910 return OK;
911}
912
913/*
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100914 * Check "type" is an item of the list or blob of the previous arg.
Bram Moolenaarca174532020-10-21 16:42:22 +0200915 * Must not be used for the first argcheck_T entry.
916 */
917 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000918arg_item_of_prev(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarca174532020-10-21 16:42:22 +0200919{
Bram Moolenaar078a4612022-01-04 15:17:03 +0000920 type_T *prev_type = context->arg_types[context->arg_idx - 1].type_curr;
Bram Moolenaarca174532020-10-21 16:42:22 +0200921 type_T *expected;
922
923 if (prev_type->tt_type == VAR_LIST)
924 expected = prev_type->tt_member;
925 else if (prev_type->tt_type == VAR_BLOB)
926 expected = &t_number;
927 else
928 // probably VAR_ANY, can't check
929 return OK;
930
Bram Moolenaar351ead02021-01-16 16:07:01 +0100931 return check_arg_type(expected, type, context);
Bram Moolenaarca174532020-10-21 16:42:22 +0200932}
933
Bram Moolenaar94738d82020-10-21 14:25:07 +0200934/*
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200935 * Check "type" is a string or a number or a list
936 */
937 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000938arg_str_or_nr_or_list(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200939{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100940 if (type->tt_type == VAR_STRING
Bram Moolenaar59618fe2021-12-21 12:32:17 +0000941 || type->tt_type == VAR_NUMBER
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100942 || type->tt_type == VAR_LIST
943 || type_any_or_unknown(type))
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200944 return OK;
945 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
946 return FAIL;
947}
948
949/*
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200950 * Check "type" is a dict of 'any' or a string
951 */
952 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000953arg_dict_any_or_string(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200954{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100955 if (type->tt_type == VAR_DICT
956 || type->tt_type == VAR_STRING
957 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200958 return OK;
959 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
960 return FAIL;
961}
962
963/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +0200964 * Check "type" which is the third argument of extend() (number or string or
965 * any)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100966 */
967 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000968arg_extend3(type_T *type, type_T *decl_type, argcontext_T *context)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100969{
Bram Moolenaar078a4612022-01-04 15:17:03 +0000970 type_T *first_type = context->arg_types[context->arg_idx - 2].type_curr;
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100971
972 if (first_type->tt_type == VAR_LIST)
Bram Moolenaar078a4612022-01-04 15:17:03 +0000973 return arg_number(type, decl_type, context);
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100974 if (first_type->tt_type == VAR_DICT)
Bram Moolenaar078a4612022-01-04 15:17:03 +0000975 return arg_string(type, decl_type, context);
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100976 return OK;
977}
978
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200979/*
Yegappan Lakshmanana764e732021-07-25 15:57:32 +0200980 * Check "type" which is the first argument of get() (blob or list or dict or
981 * funcref)
982 */
983 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000984arg_get1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana764e732021-07-25 15:57:32 +0200985{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100986 if (type->tt_type == VAR_BLOB
Yegappan Lakshmanana764e732021-07-25 15:57:32 +0200987 || type->tt_type == VAR_LIST
988 || type->tt_type == VAR_DICT
989 || type->tt_type == VAR_FUNC
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100990 || type->tt_type == VAR_PARTIAL
991 || type_any_or_unknown(type))
Yegappan Lakshmanana764e732021-07-25 15:57:32 +0200992 return OK;
993
994 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
995 return FAIL;
996}
997
998/*
999 * Check "type" which is the first argument of len() (number or string or
1000 * blob or list or dict)
1001 */
1002 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001003arg_len1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001004{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001005 if (type->tt_type == VAR_STRING
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001006 || type->tt_type == VAR_NUMBER
1007 || type->tt_type == VAR_BLOB
1008 || type->tt_type == VAR_LIST
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001009 || type->tt_type == VAR_DICT
Yegappan Lakshmanand3eae7b2024-03-03 16:26:58 +01001010 || type->tt_type == VAR_OBJECT
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001011 || type_any_or_unknown(type))
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001012 return OK;
1013
1014 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
1015 return FAIL;
1016}
1017
1018/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001019 * Check "type" which is the second argument of remove() (number or string or
1020 * any)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001021 */
1022 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001023arg_remove2(type_T *type, type_T *decl_type, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001024{
Bram Moolenaar078a4612022-01-04 15:17:03 +00001025 type_T *first_type = context->arg_types[context->arg_idx - 1].type_curr;
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001026
1027 if (first_type->tt_type == VAR_LIST || first_type->tt_type == VAR_BLOB)
Bram Moolenaar078a4612022-01-04 15:17:03 +00001028 return arg_number(type, decl_type, context);
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001029 if (first_type->tt_type == VAR_DICT)
Bram Moolenaar078a4612022-01-04 15:17:03 +00001030 return arg_string_or_nr(type, decl_type, context);
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001031 return OK;
1032}
1033
1034/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001035 * Check "type" which is the first argument of repeat() (string or number or
1036 * list or any)
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001037 */
1038 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001039arg_repeat1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001040{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001041 if (type->tt_type == VAR_STRING
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001042 || type->tt_type == VAR_NUMBER
Bakudankun375141e2022-09-09 18:46:47 +01001043 || type->tt_type == VAR_BLOB
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001044 || type->tt_type == VAR_LIST
1045 || type_any_or_unknown(type))
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001046 return OK;
1047
1048 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
1049 return FAIL;
1050}
1051
1052/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001053 * Check "type" which is the first argument of slice() (list or blob or string
1054 * or any)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001055 */
1056 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001057arg_slice1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001058{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001059 if (type->tt_type == VAR_LIST
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001060 || type->tt_type == VAR_BLOB
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001061 || type->tt_type == VAR_STRING
1062 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001063 return OK;
1064
1065 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
1066 return FAIL;
1067}
1068
1069/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001070 * Check "type" which is the first argument of count() (string or list or dict
1071 * or any)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001072 */
1073 static int
Bram Moolenaar3e518a82022-08-30 17:45:33 +01001074arg_string_or_list_or_dict(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001075{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001076 if (type->tt_type == VAR_STRING
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001077 || type->tt_type == VAR_LIST
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001078 || type->tt_type == VAR_DICT
1079 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001080 return OK;
1081
Bram Moolenaar3e518a82022-08-30 17:45:33 +01001082 semsg(_(e_string_list_or_dict_required_for_argument_nr),
1083 context->arg_idx + 1);
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001084 return FAIL;
1085}
1086
1087/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001088 * Check "type" which is the first argument of cursor() (number or string or
1089 * list or any)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001090 */
1091 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001092arg_cursor1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001093{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001094 if (type->tt_type == VAR_NUMBER
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001095 || type->tt_type == VAR_STRING
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001096 || type->tt_type == VAR_LIST
1097 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001098 return OK;
1099
1100 arg_type_mismatch(&t_number, type, context->arg_idx + 1);
1101 return FAIL;
1102}
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01001103
1104/*
Bram Moolenaar94738d82020-10-21 14:25:07 +02001105 * Lists of functions that check the argument types of a builtin function.
1106 */
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +02001107static argcheck_T arg1_blob[] = {arg_blob};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001108static argcheck_T arg1_bool[] = {arg_bool};
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001109static argcheck_T arg1_buffer[] = {arg_buffer};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001110static argcheck_T arg1_buffer_or_dict_any[] = {arg_buffer_or_dict_any};
1111static argcheck_T arg1_chan_or_job[] = {arg_chan_or_job};
1112static argcheck_T arg1_dict_any[] = {arg_dict_any};
1113static argcheck_T arg1_dict_or_string[] = {arg_dict_any_or_string};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001114static argcheck_T arg1_float_or_nr[] = {arg_float_or_nr};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001115static argcheck_T arg1_job[] = {arg_job};
1116static argcheck_T arg1_list_any[] = {arg_list_any};
1117static argcheck_T arg1_list_number[] = {arg_list_number};
Yegappan Lakshmananf9dc2782023-05-11 15:02:56 +01001118static argcheck_T arg1_string_or_list_or_blob_mod[] = {arg_string_list_or_blob_mod};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001119static argcheck_T arg1_list_or_dict[] = {arg_list_or_dict};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001120static argcheck_T arg1_list_string[] = {arg_list_string};
Bram Moolenaar3e518a82022-08-30 17:45:33 +01001121static argcheck_T arg1_string_or_list_or_dict[] = {arg_string_or_list_or_dict};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001122static argcheck_T arg1_lnum[] = {arg_lnum};
1123static argcheck_T arg1_number[] = {arg_number};
1124static argcheck_T arg1_string[] = {arg_string};
1125static argcheck_T arg1_string_or_list_any[] = {arg_string_or_list_any};
1126static argcheck_T arg1_string_or_list_string[] = {arg_string_or_list_string};
1127static argcheck_T arg1_string_or_nr[] = {arg_string_or_nr};
Ernie Raela8f7f922023-12-14 20:17:04 +01001128static argcheck_T arg2_any_buffer[] = {arg_any, arg_buffer};
1129static argcheck_T arg2_buffer_any[] = {arg_buffer, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001130static argcheck_T arg2_buffer_bool[] = {arg_buffer, arg_bool};
1131static argcheck_T arg2_buffer_list_any[] = {arg_buffer, arg_list_any};
1132static argcheck_T arg2_buffer_lnum[] = {arg_buffer, arg_lnum};
1133static argcheck_T arg2_buffer_number[] = {arg_buffer, arg_number};
1134static argcheck_T arg2_buffer_string[] = {arg_buffer, arg_string};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001135static argcheck_T arg2_chan_or_job_dict[] = {arg_chan_or_job, arg_dict_any};
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001136static argcheck_T arg2_chan_or_job_string[] = {arg_chan_or_job, arg_string};
Yegappan Lakshmananccfb7c62021-08-16 21:39:09 +02001137static argcheck_T arg2_dict_any_list_any[] = {arg_dict_any, arg_list_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001138static argcheck_T arg2_dict_any_string_or_nr[] = {arg_dict_any, arg_string_or_nr};
1139static argcheck_T arg2_dict_string[] = {arg_dict_any, arg_string};
1140static argcheck_T arg2_float_or_nr[] = {arg_float_or_nr, arg_float_or_nr};
1141static argcheck_T arg2_job_dict[] = {arg_job, arg_dict_any};
1142static argcheck_T arg2_job_string_or_number[] = {arg_job, arg_string_or_nr};
1143static argcheck_T arg2_list_any_number[] = {arg_list_any, arg_number};
1144static argcheck_T arg2_list_any_string[] = {arg_list_any, arg_string};
1145static argcheck_T arg2_list_number[] = {arg_list_number, arg_list_number};
1146static argcheck_T arg2_list_number_bool[] = {arg_list_number, arg_bool};
Yegappan Lakshmanana11b23c2025-01-16 19:16:42 +01001147static argcheck_T arg2_list_string_dict[] = {arg_list_string, arg_dict_any};
Bram Moolenaarfa103972022-09-29 19:14:42 +01001148static argcheck_T arg2_listblobmod_item[] = {arg_list_or_blob_mod, arg_item_of_prev};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001149static argcheck_T arg2_lnum[] = {arg_lnum, arg_lnum};
1150static argcheck_T arg2_lnum_number[] = {arg_lnum, arg_number};
1151static argcheck_T arg2_number[] = {arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001152static argcheck_T arg2_number_any[] = {arg_number, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001153static argcheck_T arg2_number_bool[] = {arg_number, arg_bool};
1154static argcheck_T arg2_number_dict_any[] = {arg_number, arg_dict_any};
1155static argcheck_T arg2_number_list[] = {arg_number, arg_list_any};
1156static argcheck_T arg2_number_string[] = {arg_number, arg_string};
Christian Brabandtfbc37f12024-06-18 20:50:58 +02001157static argcheck_T arg2_number_buffer[] = {arg_number, arg_buffer};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001158static argcheck_T arg2_number_string_or_list[] = {arg_number, arg_string_or_list_any};
1159static argcheck_T arg2_str_or_nr_or_list_dict[] = {arg_str_or_nr_or_list, arg_dict_any};
1160static argcheck_T arg2_string[] = {arg_string, arg_string};
Ernie Raela8f7f922023-12-14 20:17:04 +01001161static argcheck_T arg2_string_any[] = {arg_string, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001162static argcheck_T arg2_string_bool[] = {arg_string, arg_bool};
1163static argcheck_T arg2_string_chan_or_job[] = {arg_string, arg_chan_or_job};
1164static argcheck_T arg2_string_dict[] = {arg_string, arg_dict_any};
1165static argcheck_T arg2_string_list_number[] = {arg_string, arg_list_number};
1166static argcheck_T arg2_string_number[] = {arg_string, arg_number};
1167static argcheck_T arg2_string_or_list_dict[] = {arg_string_or_list_any, arg_dict_any};
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00001168static argcheck_T arg2_string_or_list_number[] = {arg_string_or_list_any, arg_number};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001169static argcheck_T arg2_string_string_or_number[] = {arg_string, arg_string_or_nr};
Yegappan Lakshmanan1aefe1d2025-01-14 17:29:42 +01001170static argcheck_T arg2_blob_dict[] = {arg_blob, arg_dict_any};
Ernie Raela8f7f922023-12-14 20:17:04 +01001171static argcheck_T arg3_any_list_dict[] = {arg_any, arg_list_any, arg_dict_any};
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001172static argcheck_T arg3_buffer_lnum_lnum[] = {arg_buffer, arg_lnum, arg_lnum};
1173static argcheck_T arg3_buffer_number_number[] = {arg_buffer, arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001174static argcheck_T arg3_buffer_string_any[] = {arg_buffer, arg_string, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001175static argcheck_T arg3_buffer_string_dict[] = {arg_buffer, arg_string, arg_dict_any};
1176static argcheck_T arg3_dict_number_number[] = {arg_dict_any, arg_number, arg_number};
Yegappan Lakshmananfa378352024-02-01 22:05:27 +01001177static argcheck_T arg3_diff[] = {arg_list_string, arg_list_string, arg_dict_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001178static argcheck_T arg3_list_string_dict[] = {arg_list_any, arg_string, arg_dict_any};
Shougo Matsushita19b71882024-02-28 22:48:12 +01001179static argcheck_T arg3_list_list_dict[] = {arg_list_any, arg_list_any, arg_dict_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001180static argcheck_T arg3_lnum_number_bool[] = {arg_lnum, arg_number, arg_bool};
1181static argcheck_T arg3_number[] = {arg_number, arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001182static argcheck_T arg3_number_any_dict[] = {arg_number, arg_any, arg_dict_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001183static argcheck_T arg3_number_number_dict[] = {arg_number, arg_number, arg_dict_any};
Ernie Raela8f7f922023-12-14 20:17:04 +01001184static argcheck_T arg3_number_string_any[] = {arg_number, arg_string, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001185static argcheck_T arg3_number_string_buffer[] = {arg_number, arg_string, arg_buffer};
1186static argcheck_T arg3_number_string_string[] = {arg_number, arg_string, arg_string};
1187static argcheck_T arg3_string[] = {arg_string, arg_string, arg_string};
Ernie Raela8f7f922023-12-14 20:17:04 +01001188static argcheck_T arg3_string_any_dict[] = {arg_string, arg_any, arg_dict_any};
1189static argcheck_T arg3_string_any_string[] = {arg_string, arg_any, arg_string};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001190static argcheck_T arg3_string_bool_bool[] = {arg_string, arg_bool, arg_bool};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001191static argcheck_T arg3_string_number_bool[] = {arg_string, arg_number, arg_bool};
K.Takata11df3ae2022-10-19 14:02:40 +01001192static argcheck_T arg3_string_number_number[] = {arg_string, arg_number, arg_number};
Ernie Rael51d04d12022-05-04 15:40:22 +01001193static argcheck_T arg3_string_or_dict_bool_dict[] = {arg_string_or_dict_any, arg_bool, arg_dict_any};
zeertzjq825cf812023-08-17 22:55:25 +02001194static argcheck_T arg3_string_or_list_bool_number[] = {arg_string_or_list_any, arg_bool, arg_number};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001195static argcheck_T arg3_string_string_bool[] = {arg_string, arg_string, arg_bool};
1196static argcheck_T arg3_string_string_dict[] = {arg_string, arg_string, arg_dict_any};
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02001197static argcheck_T arg3_string_string_number[] = {arg_string, arg_string, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001198static argcheck_T arg4_number_number_string_any[] = {arg_number, arg_number, arg_string, arg_any};
1199static argcheck_T arg4_string_string_any_string[] = {arg_string, arg_string, arg_any, arg_string};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001200static argcheck_T arg4_string_string_number_string[] = {arg_string, arg_string, arg_number, arg_string};
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01001201static argcheck_T arg4_string_number_bool_bool[] = {arg_string, arg_number, arg_bool, arg_bool};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001202/* Function specific argument types (not covered by the above) */
Ernie Raela8f7f922023-12-14 20:17:04 +01001203static 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 +02001204static 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 +02001205static argcheck_T arg4_browse[] = {arg_bool, arg_string, arg_string, arg_string};
Ernie Raela8f7f922023-12-14 20:17:04 +01001206static argcheck_T arg23_chanexpr[] = {arg_chan_or_job, arg_any, arg_dict_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001207static argcheck_T arg23_chanraw[] = {arg_chan_or_job, arg_string_or_blob, arg_dict_any};
Ernie Raela8f7f922023-12-14 20:17:04 +01001208static argcheck_T arg24_count[] = {arg_string_or_list_or_dict, arg_any, arg_bool, arg_number};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001209static argcheck_T arg13_cursor[] = {arg_cursor1, arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001210static argcheck_T arg12_deepcopy[] = {arg_any, arg_bool};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001211static argcheck_T arg12_execute[] = {arg_string_or_list_string, arg_string};
zeertzjqe0a2ab32025-02-02 09:14:35 +01001212static argcheck_T arg12_getchar[] = {arg_bool_or_nr, arg_dict_any};
Bram Moolenaarfa103972022-09-29 19:14:42 +01001213static argcheck_T arg23_extend[] = {arg_list_or_dict_mod, arg_same_as_prev, arg_extend3};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001214static argcheck_T arg23_extendnew[] = {arg_list_or_dict, arg_same_struct_as_prev, arg_extend3};
Ernie Raela8f7f922023-12-14 20:17:04 +01001215static argcheck_T arg23_get[] = {arg_get1, arg_string_or_nr, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001216static argcheck_T arg14_glob[] = {arg_string, arg_bool, arg_bool, arg_bool};
1217static argcheck_T arg25_globpath[] = {arg_string, arg_string, arg_bool, arg_bool, arg_bool};
1218static argcheck_T arg24_index[] = {arg_list_or_blob, arg_item_of_prev, arg_number, arg_bool};
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01001219static argcheck_T arg23_index[] = {arg_list_or_blob, arg_filter_func, arg_dict_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001220static argcheck_T arg23_insert[] = {arg_list_or_blob, arg_item_of_prev, arg_number};
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001221static argcheck_T arg1_len[] = {arg_len1};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001222static argcheck_T arg3_libcall[] = {arg_string, arg_string, arg_string_or_nr};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001223static argcheck_T arg14_maparg[] = {arg_string, arg_string, arg_bool, arg_bool};
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001224static argcheck_T arg2_filter[] = {arg_list_or_dict_or_blob_or_string_mod, arg_filter_func};
Ernie Raele79e2072024-01-13 11:47:33 +01001225static argcheck_T arg2_foreach[] = {arg_list_or_dict_or_blob_or_string, arg_foreach_func};
Ernie Rael2025af12023-12-12 16:58:00 +01001226static argcheck_T arg2_instanceof[] = {arg_object, varargs_class, NULL };
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001227static argcheck_T arg2_map[] = {arg_list_or_dict_or_blob_or_string_mod, arg_map_func};
Ernie Raela8f7f922023-12-14 20:17:04 +01001228static argcheck_T arg2_mapnew[] = {arg_list_or_dict_or_blob_or_string, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001229static argcheck_T arg25_matchadd[] = {arg_string, arg_string, arg_number, arg_number, arg_dict_any};
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001230static argcheck_T arg25_matchaddpos[] = {arg_string, arg_list_any, arg_number, arg_number, arg_dict_any};
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01001231static argcheck_T arg23_matchstrlist[] = {arg_list_string, arg_string, arg_dict_any};
1232static argcheck_T arg45_matchbufline[] = {arg_buffer, arg_string, arg_lnum, arg_lnum, arg_dict_any};
Ernie Raela8f7f922023-12-14 20:17:04 +01001233static 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};
1234static argcheck_T arg23_reduce[] = {arg_string_list_or_blob, arg_any, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001235static argcheck_T arg24_remote_expr[] = {arg_string, arg_string, arg_string, arg_number};
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001236static argcheck_T arg23_remove[] = {arg_list_or_dict_or_blob_mod, arg_remove2, arg_number};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001237static argcheck_T arg2_repeat[] = {arg_repeat1, arg_number};
Bram Moolenaar73199812021-12-26 17:18:14 +00001238static argcheck_T arg15_search[] = {arg_string, arg_string, arg_number, arg_number, arg_string_or_func};
1239static 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 +02001240static argcheck_T arg3_setbufline[] = {arg_buffer, arg_lnum, arg_str_or_nr_or_list};
Ernie Raela8f7f922023-12-14 20:17:04 +01001241static argcheck_T arg2_setline[] = {arg_lnum, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001242static argcheck_T arg24_setloclist[] = {arg_number, arg_list_any, arg_string, arg_dict_any};
1243static argcheck_T arg13_setqflist[] = {arg_list_any, arg_string, arg_dict_any};
1244static argcheck_T arg23_settagstack[] = {arg_number, arg_dict_any, arg_string};
1245static argcheck_T arg02_sign_getplaced[] = {arg_buffer, arg_dict_any};
1246static argcheck_T arg45_sign_place[] = {arg_number, arg_string, arg_string, arg_buffer, arg_dict_any};
1247static argcheck_T arg23_slice[] = {arg_slice1, arg_number, arg_number};
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001248static argcheck_T arg13_sortuniq[] = {arg_list_any_mod, arg_sort_how, arg_dict_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001249static argcheck_T arg24_strpart[] = {arg_string, arg_number, arg_number, arg_bool};
1250static argcheck_T arg12_system[] = {arg_string, arg_str_or_nr_or_list};
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02001251static argcheck_T arg23_win_execute[] = {arg_number, arg_string_or_list_string, arg_string};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001252static argcheck_T arg23_writefile[] = {arg_list_or_blob, arg_string, arg_string};
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02001253static argcheck_T arg24_match_func[] = {arg_string_or_list_any, arg_string, arg_number, arg_number};
Bram Moolenaarcd268012021-07-22 19:11:08 +02001254
Bram Moolenaar32517c42023-01-15 18:17:12 +00001255// Can be used by functions called through "f_retfunc" to create new types.
1256static garray_T *current_type_gap = NULL;
Bram Moolenaar94738d82020-10-21 14:25:07 +02001257
1258/*
1259 * Functions that return the return type of a builtin function.
Bram Moolenaara1224cb2020-10-22 12:31:49 +02001260 * Note that "argtypes" is NULL if "argcount" is zero.
Bram Moolenaar94738d82020-10-21 14:25:07 +02001261 */
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001262 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001263ret_void(int argcount UNUSED,
1264 type2_T *argtypes UNUSED,
1265 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001266{
1267 return &t_void;
1268}
1269 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001270ret_any(int argcount UNUSED,
1271 type2_T *argtypes UNUSED,
1272 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001273{
1274 return &t_any;
1275}
1276 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001277ret_bool(int argcount UNUSED,
1278 type2_T *argtypes UNUSED,
1279 type_T **decl_type UNUSED)
Bram Moolenaar403dc312020-10-17 19:29:51 +02001280{
1281 return &t_bool;
1282}
1283 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001284ret_number_bool(int argcount UNUSED,
1285 type2_T *argtypes UNUSED,
1286 type_T **decl_type UNUSED)
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001287{
1288 return &t_number_bool;
1289}
1290 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001291ret_number(int argcount UNUSED,
1292 type2_T *argtypes UNUSED,
1293 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001294{
1295 return &t_number;
1296}
1297 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001298ret_float(int argcount UNUSED,
1299 type2_T *argtypes UNUSED,
1300 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001301{
1302 return &t_float;
1303}
1304 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001305ret_string(int argcount UNUSED,
1306 type2_T *argtypes UNUSED,
1307 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001308{
1309 return &t_string;
1310}
Bram Moolenaare69f6d02020-04-01 22:11:01 +02001311 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001312ret_list_any(int argcount UNUSED,
1313 type2_T *argtypes UNUSED,
1314 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001315{
1316 return &t_list_any;
1317}
1318 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001319ret_list_number(int argcount UNUSED,
1320 type2_T *argtypes UNUSED,
Bram Moolenaar81330182022-02-01 12:11:58 +00001321 type_T **decl_type)
1322{
Bram Moolenaar81330182022-02-01 12:11:58 +00001323 *decl_type = &t_list_any;
1324 return &t_list_number;
1325}
1326 static type_T *
1327ret_list_string(int argcount UNUSED,
1328 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001329 type_T **decl_type)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001330{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001331 *decl_type = &t_list_any;
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001332 return &t_list_string;
1333}
1334 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001335ret_list_dict_any(int argcount UNUSED,
1336 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001337 type_T **decl_type)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001338{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001339 *decl_type = &t_list_any;
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001340 return &t_list_dict_any;
1341}
1342 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001343ret_list_items(int argcount UNUSED,
1344 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001345 type_T **decl_type)
Bram Moolenaarefc5db52021-07-07 21:21:30 +02001346{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001347 *decl_type = &t_list_any;
Bram Moolenaarefc5db52021-07-07 21:21:30 +02001348 return &t_list_list_any;
1349}
mityu61065042021-07-19 20:07:21 +02001350 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001351ret_list_string_items(int argcount UNUSED,
1352 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001353 type_T **decl_type)
mityu61065042021-07-19 20:07:21 +02001354{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001355 *decl_type = &t_list_any;
mityu61065042021-07-19 20:07:21 +02001356 return &t_list_list_string;
1357}
Bram Moolenaarefc5db52021-07-07 21:21:30 +02001358 static type_T *
zeertzjqd4d12072024-07-16 20:34:16 +02001359ret_list_regionpos(int argcount UNUSED,
1360 type2_T *argtypes UNUSED,
1361 type_T **decl_type)
1362{
1363 *decl_type = &t_list_any;
1364 return &t_list_list_list_number;
1365}
1366 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001367ret_dict_any(int argcount UNUSED,
1368 type2_T *argtypes UNUSED,
1369 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001370{
1371 return &t_dict_any;
1372}
1373 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001374ret_job_info(int argcount,
1375 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001376 type_T **decl_type)
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01001377{
1378 if (argcount == 0)
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001379 {
1380 *decl_type = &t_list_any;
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01001381 return &t_list_job;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001382 }
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01001383 return &t_dict_any;
1384}
1385 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001386ret_dict_number(int argcount UNUSED,
1387 type2_T *argtypes UNUSED,
1388 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001389{
1390 return &t_dict_number;
1391}
1392 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001393ret_dict_string(int argcount UNUSED,
1394 type2_T *argtypes UNUSED,
1395 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001396{
1397 return &t_dict_string;
1398}
1399 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001400ret_blob(int argcount UNUSED,
1401 type2_T *argtypes UNUSED,
1402 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001403{
1404 return &t_blob;
1405}
1406 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001407ret_func_any(int argcount UNUSED,
1408 type2_T *argtypes UNUSED,
1409 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001410{
Bram Moolenaare69f6d02020-04-01 22:11:01 +02001411 return &t_func_any;
1412}
1413 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001414ret_func_unknown(int argcount UNUSED,
1415 type2_T *argtypes UNUSED,
1416 type_T **decl_type UNUSED)
Bram Moolenaar2f9f4cc2021-12-20 09:36:27 +00001417{
1418 return &t_func_unknown;
1419}
1420 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001421ret_channel(int argcount UNUSED,
1422 type2_T *argtypes UNUSED,
1423 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001424{
1425 return &t_channel;
1426}
1427 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001428ret_job(int argcount UNUSED,
1429 type2_T *argtypes UNUSED,
1430 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001431{
1432 return &t_job;
1433}
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001434 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001435ret_first_arg(int argcount,
1436 type2_T *argtypes,
1437 type_T **decl_type)
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001438{
1439 if (argcount > 0)
Bram Moolenaar81330182022-02-01 12:11:58 +00001440 {
1441 *decl_type = argtypes[0].type_decl;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001442 return argtypes[0].type_curr;
Bram Moolenaar81330182022-02-01 12:11:58 +00001443 }
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001444 return &t_void;
1445}
Bram Moolenaar1780f082021-07-31 22:03:59 +02001446 static type_T *
Bram Moolenaar00eb9952022-02-05 19:23:18 +00001447ret_slice(int argcount,
1448 type2_T *argtypes,
1449 type_T **decl_type)
1450{
1451 if (argcount > 0)
1452 {
1453 if (argtypes[0].type_decl != NULL)
1454 {
1455 switch (argtypes[0].type_decl->tt_type)
1456 {
1457 case VAR_STRING: *decl_type = &t_string; break;
1458 case VAR_BLOB: *decl_type = &t_blob; break;
1459 case VAR_LIST: *decl_type = &t_list_any; break;
1460 default: break;
1461 }
1462 }
1463 return argtypes[0].type_curr;
1464 }
1465 return &t_void;
1466}
1467 static type_T *
Bram Moolenaar381692b2022-02-02 20:01:27 +00001468ret_copy(int argcount,
1469 type2_T *argtypes,
1470 type_T **decl_type)
1471{
1472 if (argcount > 0)
1473 {
1474 if (argtypes[0].type_decl != NULL)
1475 {
1476 if (argtypes[0].type_decl->tt_type == VAR_LIST)
1477 *decl_type = &t_list_any;
1478 else if (argtypes[0].type_decl->tt_type == VAR_DICT)
1479 *decl_type = &t_dict_any;
1480 else
1481 *decl_type = argtypes[0].type_decl;
1482 }
1483 if (argtypes[0].type_curr != NULL)
1484 {
1485 if (argtypes[0].type_curr->tt_type == VAR_LIST)
1486 return &t_list_any;
1487 else if (argtypes[0].type_curr->tt_type == VAR_DICT)
1488 return &t_dict_any;
1489 }
1490 return argtypes[0].type_curr;
1491 }
1492 return &t_void;
1493}
1494 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001495ret_extend(int argcount,
1496 type2_T *argtypes,
1497 type_T **decl_type)
1498{
1499 if (argcount > 0)
1500 {
1501 *decl_type = argtypes[0].type_decl;
1502 // if the second argument has a different current type then the current
1503 // type is "any"
1504 if (argcount > 1 && !equal_type(argtypes[0].type_curr,
1505 argtypes[1].type_curr, 0))
1506 {
1507 if (argtypes[0].type_curr->tt_type == VAR_LIST)
1508 return &t_list_any;
1509 if (argtypes[0].type_curr->tt_type == VAR_DICT)
1510 return &t_dict_any;
1511 }
1512 return argtypes[0].type_curr;
1513 }
1514 return &t_void;
1515}
1516 static type_T *
1517ret_repeat(int argcount,
1518 type2_T *argtypes,
1519 type_T **decl_type UNUSED)
Bram Moolenaar1780f082021-07-31 22:03:59 +02001520{
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001521 if (argcount == 0)
1522 return &t_any;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001523 if (argtypes[0].type_curr == &t_number)
Bram Moolenaar1780f082021-07-31 22:03:59 +02001524 return &t_string;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001525 return argtypes[0].type_curr;
Bram Moolenaar1780f082021-07-31 22:03:59 +02001526}
Bram Moolenaarea696852020-11-09 18:31:39 +01001527// for map(): returns first argument but item type may differ
1528 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001529ret_first_cont(int argcount,
1530 type2_T *argtypes,
1531 type_T **decl_type UNUSED)
Bram Moolenaarea696852020-11-09 18:31:39 +01001532{
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001533 if (argcount > 0)
1534 {
Bram Moolenaar078a4612022-01-04 15:17:03 +00001535 if (argtypes[0].type_curr->tt_type == VAR_LIST)
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001536 return &t_list_any;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001537 if (argtypes[0].type_curr->tt_type == VAR_DICT)
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001538 return &t_dict_any;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001539 if (argtypes[0].type_curr->tt_type == VAR_BLOB)
1540 return argtypes[0].type_curr;
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001541 }
Bram Moolenaarea696852020-11-09 18:31:39 +01001542 return &t_any;
1543}
Bram Moolenaar078a4612022-01-04 15:17:03 +00001544// for getline()
1545 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001546ret_getline(int argcount,
1547 type2_T *argtypes UNUSED,
1548 type_T **decl_type UNUSED)
Bram Moolenaar078a4612022-01-04 15:17:03 +00001549{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001550 if (argcount == 1)
1551 return &t_string;
1552 *decl_type = &t_list_any;
1553 return &t_list_string;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001554}
Bram Moolenaar08018222021-12-22 18:45:37 +00001555// for finddir()
1556 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001557ret_finddir(int argcount,
1558 type2_T *argtypes UNUSED,
1559 type_T **decl_type UNUSED)
Bram Moolenaar08018222021-12-22 18:45:37 +00001560{
1561 if (argcount < 3)
1562 return &t_string;
1563 // Depending on the count would be a string or a list of strings.
1564 return &t_any;
1565}
Bram Moolenaar32517c42023-01-15 18:17:12 +00001566// for values(): list of member of first argument
1567 static type_T *
1568ret_list_member(int argcount,
1569 type2_T *argtypes,
1570 type_T **decl_type)
1571{
1572 if (argcount > 0)
1573 {
1574 type_T *t = argtypes[0].type_decl;
1575 if (current_type_gap != NULL
1576 && (t->tt_type == VAR_DICT || t->tt_type == VAR_LIST))
1577 t = get_list_type(t->tt_member, current_type_gap);
1578 else
1579 t = &t_list_any;
1580 *decl_type = t;
1581
1582 t = argtypes[0].type_curr;
1583 if (current_type_gap != NULL
1584 && (t->tt_type == VAR_DICT || t->tt_type == VAR_LIST))
1585 return get_list_type(t->tt_member, current_type_gap);
1586 }
1587 return &t_list_any;
1588}
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001589
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001590/*
1591 * Used for getqflist(): returns list if there is no argument, dict if there is
1592 * one.
1593 */
1594 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001595ret_list_or_dict_0(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 > 0)
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
1605/*
1606 * Used for getloclist(): returns list if there is one argument, dict if there
1607 * are two.
1608 */
1609 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001610ret_list_or_dict_1(int argcount,
1611 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001612 type_T **decl_type)
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001613{
1614 if (argcount > 1)
1615 return &t_dict_any;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001616 *decl_type = &t_list_any;
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001617 return &t_list_dict_any;
1618}
1619
Bram Moolenaar846178a2020-07-05 17:04:13 +02001620 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001621ret_argv(int argcount,
1622 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001623 type_T **decl_type)
Bram Moolenaar846178a2020-07-05 17:04:13 +02001624{
1625 // argv() returns list of strings
1626 if (argcount == 0)
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001627 {
1628 *decl_type = &t_list_any;
Bram Moolenaar846178a2020-07-05 17:04:13 +02001629 return &t_list_string;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001630 }
Bram Moolenaar846178a2020-07-05 17:04:13 +02001631
1632 // argv(0) returns a string, but argv(-1] returns a list
1633 return &t_any;
1634}
1635
Bram Moolenaarad7c2492020-07-05 20:55:29 +02001636 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001637ret_remove(int argcount,
1638 type2_T *argtypes,
Bram Moolenaar2ac037f2022-05-09 14:12:14 +01001639 type_T **decl_type)
Bram Moolenaarad7c2492020-07-05 20:55:29 +02001640{
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001641 if (argcount > 0)
Bram Moolenaar5e654232020-09-16 15:22:00 +02001642 {
Bram Moolenaar078a4612022-01-04 15:17:03 +00001643 if (argtypes[0].type_curr->tt_type == VAR_LIST
1644 || argtypes[0].type_curr->tt_type == VAR_DICT)
Bram Moolenaar81330182022-02-01 12:11:58 +00001645 {
Bram Moolenaar2ac037f2022-05-09 14:12:14 +01001646 if (argcount == 3)
1647 {
1648 *decl_type = argtypes[0].type_decl;
1649 return argtypes[0].type_curr;
1650 }
Bram Moolenaar81330182022-02-01 12:11:58 +00001651 if (argtypes[0].type_curr->tt_type
1652 == argtypes[0].type_decl->tt_type)
1653 *decl_type = argtypes[0].type_decl->tt_member;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001654 return argtypes[0].type_curr->tt_member;
Bram Moolenaar81330182022-02-01 12:11:58 +00001655 }
Bram Moolenaar078a4612022-01-04 15:17:03 +00001656 if (argtypes[0].type_curr->tt_type == VAR_BLOB)
Bram Moolenaar5e654232020-09-16 15:22:00 +02001657 return &t_number;
1658 }
Bram Moolenaarad7c2492020-07-05 20:55:29 +02001659 return &t_any;
1660}
1661
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001662 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001663ret_getreg(int argcount,
1664 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001665 type_T **decl_type)
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001666{
1667 // Assume that if the third argument is passed it's non-zero
1668 if (argcount == 3)
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001669 {
1670 *decl_type = &t_list_any;
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001671 return &t_list_string;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001672 }
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001673 return &t_string;
1674}
1675
Bram Moolenaar4a6d1b62020-08-08 17:55:49 +02001676 static type_T *
LemonBoy0f7a3e12022-05-26 12:10:37 +01001677ret_virtcol(int argcount,
1678 type2_T *argtypes UNUSED,
1679 type_T **decl_type)
1680{
1681 // Assume that if the second argument is passed it's non-zero
zeertzjq825cf812023-08-17 22:55:25 +02001682 if (argcount > 1)
LemonBoy0f7a3e12022-05-26 12:10:37 +01001683 {
1684 *decl_type = &t_list_any;
1685 return &t_list_number;
1686 }
1687 return &t_number;
1688}
1689
1690 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001691ret_maparg(int argcount,
1692 type2_T *argtypes UNUSED,
1693 type_T **decl_type UNUSED)
Bram Moolenaar4a6d1b62020-08-08 17:55:49 +02001694{
1695 // Assume that if the fourth argument is passed it's non-zero
1696 if (argcount == 4)
1697 return &t_dict_any;
1698 return &t_string;
1699}
1700
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001701/*
1702 * Array with names and number of arguments of all internal functions
1703 * MUST BE KEPT SORTED IN strcmp() ORDER FOR BINARY SEARCH!
Ernie Rael2025af12023-12-12 16:58:00 +01001704 *
Ernie Raela8f7f922023-12-14 20:17:04 +01001705 * The builtin function may be varargs. In that case
Ernie Rael2025af12023-12-12 16:58:00 +01001706 * - f_max_argc == VARGS
Ernie Raela8f7f922023-12-14 20:17:04 +01001707 * - For varargs, f_argcheck must be NULL terminated. The last non-null
1708 * entry in f_argcheck should validate all the remaining args.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001709 */
Bram Moolenaarac92e252019-08-03 21:58:38 +02001710typedef struct
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001711{
Bram Moolenaar25e42232019-08-04 15:04:10 +02001712 char *f_name; // function name
1713 char f_min_argc; // minimal number of arguments
1714 char f_max_argc; // maximal number of arguments
Ernie Raeld8bf87c2023-12-16 14:03:33 +01001715 char f_argtype; // for method: FEARG_ values; bits FE_
Ernie Raela8f7f922023-12-14 20:17:04 +01001716 argcheck_T *f_argcheck; // list of functions to check argument types;
1717 // use "arg_any" (not NULL) to accept an
1718 // argument of any type
Bram Moolenaar81330182022-02-01 12:11:58 +00001719 type_T *(*f_retfunc)(int argcount, type2_T *argtypes,
1720 type_T **decl_type);
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001721 // return type function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001722 void (*f_func)(typval_T *args, typval_T *rvar);
Bram Moolenaar25e42232019-08-04 15:04:10 +02001723 // implementation of function
Bram Moolenaarac92e252019-08-03 21:58:38 +02001724} funcentry_T;
1725
Ernie Rael2025af12023-12-12 16:58:00 +01001726// Set f_max_argc to VARGS for varargs.
1727#define VARGS CHAR_MAX
1728
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02001729// values for f_argtype; zero means it cannot be used as a method
Ernie Raeld8bf87c2023-12-16 14:03:33 +01001730#define FEARG_1 0x01 // base is the first argument
1731#define FEARG_2 0x02 // base is the second argument
1732#define FEARG_3 0x03 // base is the third argument
1733#define FEARG_4 0x04 // base is the fourth argument
1734#define FEARG_MASK 0x0F // bits in f_argtype used as argument index
1735#define FE_X 0x10 // builtin accepts a non-value (class, typealias)
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02001736
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001737#if defined(HAVE_MATH_H)
Bram Moolenaar15c47602020-03-26 22:16:48 +01001738# define MATH_FUNC(name) name
1739#else
1740# define MATH_FUNC(name) NULL
1741#endif
1742#ifdef FEAT_TIMERS
1743# define TIMER_FUNC(name) name
1744#else
1745# define TIMER_FUNC(name) NULL
1746#endif
1747#ifdef FEAT_JOB_CHANNEL
1748# define JOB_FUNC(name) name
1749#else
1750# define JOB_FUNC(name) NULL
1751#endif
1752#ifdef FEAT_PROP_POPUP
1753# define PROP_FUNC(name) name
1754#else
1755# define PROP_FUNC(name) NULL
1756#endif
1757#ifdef FEAT_SIGNS
1758# define SIGN_FUNC(name) name
1759#else
1760# define SIGN_FUNC(name) NULL
1761#endif
1762#ifdef FEAT_SOUND
1763# define SOUND_FUNC(name) name
1764#else
1765# define SOUND_FUNC(name) NULL
1766#endif
1767#ifdef FEAT_TERMINAL
1768# define TERM_FUNC(name) name
1769#else
1770# define TERM_FUNC(name) NULL
1771#endif
1772
Bram Moolenaarac92e252019-08-03 21:58:38 +02001773static funcentry_T global_functions[] =
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001774{
Bram Moolenaar94738d82020-10-21 14:25:07 +02001775 {"abs", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001776 ret_any, f_abs},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001777 {"acos", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001778 ret_float, f_acos},
Bram Moolenaarfa103972022-09-29 19:14:42 +01001779 {"add", 2, 2, FEARG_1, arg2_listblobmod_item,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001780 ret_first_arg, f_add},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001781 {"and", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001782 ret_number, f_and},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001783 {"append", 2, 2, FEARG_2, arg2_setline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001784 ret_number_bool, f_append},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001785 {"appendbufline", 3, 3, FEARG_3, arg3_setbufline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001786 ret_number_bool, f_appendbufline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001787 {"argc", 0, 1, 0, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001788 ret_number, f_argc},
1789 {"argidx", 0, 0, 0, NULL,
1790 ret_number, f_argidx},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001791 {"arglistid", 0, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001792 ret_number, f_arglistid},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001793 {"argv", 0, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001794 ret_argv, f_argv},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001795 {"asin", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001796 ret_float, f_asin},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001797 {"assert_beeps", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001798 ret_number_bool, f_assert_beeps},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001799 {"assert_equal", 2, 3, FEARG_2, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001800 ret_number_bool, f_assert_equal},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001801 {"assert_equalfile", 2, 3, FEARG_1, arg3_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001802 ret_number_bool, f_assert_equalfile},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001803 {"assert_exception", 1, 2, 0, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001804 ret_number_bool, f_assert_exception},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001805 {"assert_fails", 1, 5, FEARG_1, arg15_assert_fails,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001806 ret_number_bool, f_assert_fails},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001807 {"assert_false", 1, 2, FEARG_1, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001808 ret_number_bool, f_assert_false},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001809 {"assert_inrange", 3, 4, FEARG_3, arg34_assert_inrange,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001810 ret_number_bool, f_assert_inrange},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001811 {"assert_match", 2, 3, FEARG_2, arg3_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001812 ret_number_bool, f_assert_match},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001813 {"assert_nobeep", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar5b8cabf2021-04-02 18:55:57 +02001814 ret_number_bool, f_assert_nobeep},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001815 {"assert_notequal", 2, 3, FEARG_2, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001816 ret_number_bool, f_assert_notequal},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001817 {"assert_notmatch", 2, 3, FEARG_2, arg3_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001818 ret_number_bool, f_assert_notmatch},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02001819 {"assert_report", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001820 ret_number_bool, f_assert_report},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001821 {"assert_true", 1, 2, FEARG_1, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001822 ret_number_bool, f_assert_true},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001823 {"atan", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001824 ret_float, f_atan},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001825 {"atan2", 2, 2, FEARG_1, arg2_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001826 ret_float, f_atan2},
Yegappan Lakshmanan1755a912022-05-19 10:31:47 +01001827 {"autocmd_add", 1, 1, FEARG_1, arg1_list_any,
1828 ret_number_bool, f_autocmd_add},
1829 {"autocmd_delete", 1, 1, FEARG_1, arg1_list_any,
1830 ret_number_bool, f_autocmd_delete},
1831 {"autocmd_get", 0, 1, FEARG_1, arg1_dict_any,
1832 ret_list_dict_any, f_autocmd_get},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001833 {"balloon_gettext", 0, 0, 0, NULL,
1834 ret_string,
Bram Moolenaar59716a22017-03-01 20:32:44 +01001835#ifdef FEAT_BEVAL
Bram Moolenaar15c47602020-03-26 22:16:48 +01001836 f_balloon_gettext
1837#else
1838 NULL
Bram Moolenaar59716a22017-03-01 20:32:44 +01001839#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01001840 },
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02001841 {"balloon_show", 1, 1, FEARG_1, arg1_string_or_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001842 ret_void,
Bram Moolenaar15c47602020-03-26 22:16:48 +01001843#ifdef FEAT_BEVAL
1844 f_balloon_show
1845#else
1846 NULL
1847#endif
1848 },
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001849 {"balloon_split", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001850 ret_list_string,
Bram Moolenaar15c47602020-03-26 22:16:48 +01001851#if defined(FEAT_BEVAL_TERM)
1852 f_balloon_split
1853#else
1854 NULL
1855#endif
1856 },
Yegappan Lakshmanan810785c2024-12-30 10:29:44 +01001857 {"base64_decode", 1, 1, FEARG_1, arg1_string,
1858 ret_blob, f_base64_decode},
1859 {"base64_encode", 1, 1, FEARG_1, arg1_blob,
1860 ret_string, f_base64_encode},
Christ van Willegence0ef912024-06-20 23:41:59 +02001861 {"bindtextdomain", 2, 2, 0, arg2_string,
Christ van Willegen8252ef12024-07-11 21:36:21 +02001862 ret_bool, f_bindtextdomain},
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +02001863 {"blob2list", 1, 1, FEARG_1, arg1_blob,
1864 ret_list_number, f_blob2list},
Yegappan Lakshmanan1aefe1d2025-01-14 17:29:42 +01001865 {"blob2str", 1, 2, FEARG_1, arg2_blob_dict,
Yegappan Lakshmanan166b1752025-01-17 11:48:12 +01001866 ret_list_string, f_blob2str},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001867 {"browse", 4, 4, 0, arg4_browse,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001868 ret_string, f_browse},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001869 {"browsedir", 2, 2, 0, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001870 ret_string, f_browsedir},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001871 {"bufadd", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001872 ret_number, f_bufadd},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001873 {"bufexists", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001874 ret_number_bool, f_bufexists},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001875 {"buffer_exists", 1, 1, FEARG_1, arg1_buffer, // obsolete
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001876 ret_number_bool, f_bufexists},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001877 {"buffer_name", 0, 1, FEARG_1, arg1_buffer, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02001878 ret_string, f_bufname},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001879 {"buffer_number", 0, 1, FEARG_1, arg1_buffer, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02001880 ret_number, f_bufnr},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001881 {"buflisted", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001882 ret_number_bool, f_buflisted},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001883 {"bufload", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001884 ret_void, f_bufload},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001885 {"bufloaded", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001886 ret_number_bool, f_bufloaded},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001887 {"bufname", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001888 ret_string, f_bufname},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001889 {"bufnr", 0, 2, FEARG_1, arg2_buffer_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001890 ret_number, f_bufnr},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001891 {"bufwinid", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001892 ret_number, f_bufwinid},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001893 {"bufwinnr", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001894 ret_number, f_bufwinnr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001895 {"byte2line", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001896 ret_number, f_byte2line},
Christian Brabandt67672ef2023-04-24 21:09:54 +01001897 {"byteidx", 2, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001898 ret_number, f_byteidx},
Christian Brabandt67672ef2023-04-24 21:09:54 +01001899 {"byteidxcomp", 2, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001900 ret_number, f_byteidxcomp},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001901 {"call", 2, 3, FEARG_1, arg3_any_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001902 ret_any, f_call},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001903 {"ceil", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001904 ret_float, f_ceil},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001905 {"ch_canread", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001906 ret_number_bool, JOB_FUNC(f_ch_canread)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001907 {"ch_close", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001908 ret_void, JOB_FUNC(f_ch_close)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001909 {"ch_close_in", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001910 ret_void, JOB_FUNC(f_ch_close_in)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001911 {"ch_evalexpr", 2, 3, FEARG_1, arg23_chanexpr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001912 ret_any, JOB_FUNC(f_ch_evalexpr)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001913 {"ch_evalraw", 2, 3, FEARG_1, arg23_chanraw,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001914 ret_any, JOB_FUNC(f_ch_evalraw)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001915 {"ch_getbufnr", 2, 2, FEARG_1, arg2_chan_or_job_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001916 ret_number, JOB_FUNC(f_ch_getbufnr)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001917 {"ch_getjob", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001918 ret_job, JOB_FUNC(f_ch_getjob)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001919 {"ch_info", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001920 ret_dict_any, JOB_FUNC(f_ch_info)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001921 {"ch_log", 1, 2, FEARG_1, arg2_string_chan_or_job,
Bram Moolenaar4c5678f2022-11-30 18:12:19 +00001922 ret_void, f_ch_log},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001923 {"ch_logfile", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar4c5678f2022-11-30 18:12:19 +00001924 ret_void, f_ch_logfile},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001925 {"ch_open", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001926 ret_channel, JOB_FUNC(f_ch_open)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001927 {"ch_read", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001928 ret_string, JOB_FUNC(f_ch_read)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001929 {"ch_readblob", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001930 ret_blob, JOB_FUNC(f_ch_readblob)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001931 {"ch_readraw", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001932 ret_string, JOB_FUNC(f_ch_readraw)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001933 {"ch_sendexpr", 2, 3, FEARG_1, arg23_chanexpr,
Yegappan Lakshmanan3b470ae2022-04-16 10:41:27 +01001934 ret_any, JOB_FUNC(f_ch_sendexpr)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001935 {"ch_sendraw", 2, 3, FEARG_1, arg23_chanraw,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001936 ret_void, JOB_FUNC(f_ch_sendraw)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001937 {"ch_setoptions", 2, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001938 ret_void, JOB_FUNC(f_ch_setoptions)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001939 {"ch_status", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001940 ret_string, JOB_FUNC(f_ch_status)},
1941 {"changenr", 0, 0, 0, NULL,
1942 ret_number, f_changenr},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02001943 {"char2nr", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001944 ret_number, f_char2nr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001945 {"charclass", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001946 ret_number, f_charclass},
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00001947 {"charcol", 1, 2, FEARG_1, arg2_string_or_list_number,
Bram Moolenaar6f02b002021-01-10 20:22:54 +01001948 ret_number, f_charcol},
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01001949 {"charidx", 2, 4, FEARG_1, arg4_string_number_bool_bool,
Bram Moolenaar17793ef2020-12-28 12:56:58 +01001950 ret_number, f_charidx},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001951 {"chdir", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001952 ret_string, f_chdir},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001953 {"cindent", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001954 ret_number, f_cindent},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001955 {"clearmatches", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001956 ret_void, f_clearmatches},
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00001957 {"col", 1, 2, FEARG_1, arg2_string_or_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001958 ret_number, f_col},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001959 {"complete", 2, 2, FEARG_2, arg2_number_list,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001960 ret_void, f_complete},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001961 {"complete_add", 1, 1, FEARG_1, arg1_dict_or_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001962 ret_number, f_complete_add},
1963 {"complete_check", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001964 ret_number_bool, f_complete_check},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001965 {"complete_info", 0, 1, FEARG_1, arg1_list_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001966 ret_dict_any, f_complete_info},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001967 {"confirm", 1, 4, FEARG_1, arg4_string_string_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001968 ret_number, f_confirm},
1969 {"copy", 1, 1, FEARG_1, NULL,
Bram Moolenaar381692b2022-02-02 20:01:27 +00001970 ret_copy, f_copy},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001971 {"cos", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001972 ret_float, f_cos},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001973 {"cosh", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001974 ret_float, f_cosh},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001975 {"count", 2, 4, FEARG_1, arg24_count,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001976 ret_number, f_count},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001977 {"cscope_connection",0,3, 0, arg3_number_string_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001978 ret_number, f_cscope_connection},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001979 {"cursor", 1, 3, FEARG_1, arg13_cursor,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001980 ret_number, f_cursor},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001981 {"debugbreak", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001982 ret_number,
Bram Moolenaar4f974752019-02-17 17:44:42 +01001983#ifdef MSWIN
Bram Moolenaar15c47602020-03-26 22:16:48 +01001984 f_debugbreak
1985#else
1986 NULL
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02001987#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01001988 },
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001989 {"deepcopy", 1, 2, FEARG_1, arg12_deepcopy,
Bram Moolenaar381692b2022-02-02 20:01:27 +00001990 ret_copy, f_deepcopy},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001991 {"delete", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001992 ret_number_bool, f_delete},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001993 {"deletebufline", 2, 3, FEARG_1, arg3_buffer_lnum_lnum,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001994 ret_number_bool, f_deletebufline},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001995 {"did_filetype", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001996 ret_number_bool, f_did_filetype},
Yegappan Lakshmananfa378352024-02-01 22:05:27 +01001997 {"diff", 2, 3, FEARG_1, arg3_diff,
Yegappan Lakshmanana0010a12024-02-12 20:21:26 +01001998 ret_any, f_diff},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001999 {"diff_filler", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002000 ret_number, f_diff_filler},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002001 {"diff_hlID", 2, 2, FEARG_1, arg2_lnum_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002002 ret_number, f_diff_hlID},
h-east29b85712021-07-26 21:54:04 +02002003 {"digraph_get", 1, 1, FEARG_1, arg1_string,
2004 ret_string, f_digraph_get},
zeertzjqd4d12072024-07-16 20:34:16 +02002005 {"digraph_getlist", 0, 1, FEARG_1, arg1_bool,
h-east29b85712021-07-26 21:54:04 +02002006 ret_list_string_items, f_digraph_getlist},
Yegappan Lakshmananfc3b7752021-09-08 14:57:42 +02002007 {"digraph_set", 2, 2, FEARG_1, arg2_string,
h-east29b85712021-07-26 21:54:04 +02002008 ret_bool, f_digraph_set},
zeertzjqd4d12072024-07-16 20:34:16 +02002009 {"digraph_setlist", 1, 1, FEARG_1, arg1_list_string,
h-east29b85712021-07-26 21:54:04 +02002010 ret_bool, f_digraph_setlist},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002011 {"echoraw", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002012 ret_void, f_echoraw},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002013 {"empty", 1, 1, FEARG_1, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002014 ret_number_bool, f_empty},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002015 {"environ", 0, 0, 0, NULL,
2016 ret_dict_string, f_environ},
Bram Moolenaar80adaa82023-07-07 18:57:40 +01002017 {"err_teapot", 0, 1, 0, NULL,
2018 ret_number_bool, f_err_teapot},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002019 {"escape", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002020 ret_string, f_escape},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002021 {"eval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002022 ret_any, f_eval},
2023 {"eventhandler", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002024 ret_number_bool, f_eventhandler},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002025 {"executable", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002026 ret_number, f_executable},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002027 {"execute", 1, 2, FEARG_1, arg12_execute,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002028 ret_string, f_execute},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002029 {"exepath", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002030 ret_string, f_exepath},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002031 {"exists", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002032 ret_number_bool, f_exists},
Bram Moolenaar26735992021-08-08 14:43:22 +02002033 {"exists_compiled", 1, 1, FEARG_1, arg1_string,
2034 ret_number_bool, f_exists_compiled},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002035 {"exp", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002036 ret_float, f_exp},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002037 {"expand", 1, 3, FEARG_1, arg3_string_bool_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002038 ret_any, f_expand},
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01002039 {"expandcmd", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002040 ret_string, f_expandcmd},
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01002041 {"extend", 2, 3, FEARG_1, arg23_extend,
Bram Moolenaar81330182022-02-01 12:11:58 +00002042 ret_extend, f_extend},
Bram Moolenaarb0e6b512021-01-12 20:23:40 +01002043 {"extendnew", 2, 3, FEARG_1, arg23_extendnew,
2044 ret_first_cont, f_extendnew},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002045 {"feedkeys", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002046 ret_void, f_feedkeys},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002047 {"file_readable", 1, 1, FEARG_1, arg1_string, // obsolete
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002048 ret_number_bool, f_filereadable},
Shougo Matsushita60c87432024-06-03 22:59:27 +02002049 {"filecopy", 2, 2, FEARG_1, arg2_string,
2050 ret_number_bool, f_filecopy},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002051 {"filereadable", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002052 ret_number_bool, f_filereadable},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002053 {"filewritable", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002054 ret_number, f_filewritable},
Bram Moolenaar18024052021-12-25 21:43:28 +00002055 {"filter", 2, 2, FEARG_1, arg2_filter,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002056 ret_first_arg, f_filter},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002057 {"finddir", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar08018222021-12-22 18:45:37 +00002058 ret_finddir, f_finddir},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002059 {"findfile", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar10c83dd2021-09-04 14:49:56 +02002060 ret_any, f_findfile},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002061 {"flatten", 1, 2, FEARG_1, arg2_list_any_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002062 ret_list_any, f_flatten},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002063 {"flattennew", 1, 2, FEARG_1, arg2_list_any_number,
Bram Moolenaar3b690062021-02-01 20:14:51 +01002064 ret_list_any, f_flattennew},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002065 {"float2nr", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002066 ret_number, f_float2nr},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002067 {"floor", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002068 ret_float, f_floor},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002069 {"fmod", 2, 2, FEARG_1, arg2_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002070 ret_float, f_fmod},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002071 {"fnameescape", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002072 ret_string, f_fnameescape},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002073 {"fnamemodify", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002074 ret_string, f_fnamemodify},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002075 {"foldclosed", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002076 ret_number, f_foldclosed},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002077 {"foldclosedend", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002078 ret_number, f_foldclosedend},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002079 {"foldlevel", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002080 ret_number, f_foldlevel},
2081 {"foldtext", 0, 0, 0, NULL,
2082 ret_string, f_foldtext},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002083 {"foldtextresult", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002084 ret_string, f_foldtextresult},
Ernie Raele79e2072024-01-13 11:47:33 +01002085 {"foreach", 2, 2, FEARG_1, arg2_foreach,
2086 ret_first_arg, f_foreach},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002087 {"foreground", 0, 0, 0, NULL,
2088 ret_void, f_foreground},
Bram Moolenaardd44b582022-09-15 22:03:57 +01002089 {"fullcommand", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar038e09e2021-02-06 12:38:51 +01002090 ret_string, f_fullcommand},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002091 {"funcref", 1, 3, FEARG_1, arg3_any_list_dict,
Bram Moolenaar2f9f4cc2021-12-20 09:36:27 +00002092 ret_func_unknown, f_funcref},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002093 {"function", 1, 3, FEARG_1, arg3_any_list_dict,
Bram Moolenaar2f9f4cc2021-12-20 09:36:27 +00002094 ret_func_unknown, f_function},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002095 {"garbagecollect", 0, 1, 0, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002096 ret_void, f_garbagecollect},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002097 {"get", 2, 3, FEARG_1, arg23_get,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002098 ret_any, f_get},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002099 {"getbufinfo", 0, 1, FEARG_1, arg1_buffer_or_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002100 ret_list_dict_any, f_getbufinfo},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002101 {"getbufline", 2, 3, FEARG_1, arg3_buffer_lnum_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002102 ret_list_string, f_getbufline},
Bram Moolenaarce30ccc2022-11-21 19:57:04 +00002103 {"getbufoneline", 2, 2, FEARG_1, arg2_buffer_lnum,
2104 ret_string, f_getbufoneline},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002105 {"getbufvar", 2, 3, FEARG_1, arg3_buffer_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002106 ret_any, f_getbufvar},
mikoto20001083cae2024-11-11 21:24:14 +01002107 {"getcellpixels", 0, 0, 0, NULL,
mikoto2000a73dfc22024-11-18 21:12:21 +01002108 ret_list_any, f_getcellpixels},
Kota Kato66bb9ae2023-01-17 18:31:56 +00002109 {"getcellwidths", 0, 0, 0, NULL,
2110 ret_list_any, f_getcellwidths},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002111 {"getchangelist", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002112 ret_list_any, f_getchangelist},
zeertzjqe0a2ab32025-02-02 09:14:35 +01002113 {"getchar", 0, 2, 0, arg12_getchar,
Bram Moolenaar3a7503c2021-06-07 18:29:17 +02002114 ret_any, f_getchar},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002115 {"getcharmod", 0, 0, 0, NULL,
2116 ret_number, f_getcharmod},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002117 {"getcharpos", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar6f02b002021-01-10 20:22:54 +01002118 ret_list_number, f_getcharpos},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002119 {"getcharsearch", 0, 0, 0, NULL,
2120 ret_dict_any, f_getcharsearch},
zeertzjqe0a2ab32025-02-02 09:14:35 +01002121 {"getcharstr", 0, 2, 0, arg12_getchar,
Bram Moolenaar3a7503c2021-06-07 18:29:17 +02002122 ret_string, f_getcharstr},
Ruslan Russkikh0407d622024-10-08 22:21:05 +02002123 {"getcmdcomplpat", 0, 0, 0, NULL,
2124 ret_string, f_getcmdcomplpat},
Shougo Matsushita79d599b2022-05-07 12:48:29 +01002125 {"getcmdcompltype", 0, 0, 0, NULL,
2126 ret_string, f_getcmdcompltype},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002127 {"getcmdline", 0, 0, 0, NULL,
2128 ret_string, f_getcmdline},
2129 {"getcmdpos", 0, 0, 0, NULL,
2130 ret_number, f_getcmdpos},
Shougo Matsushita69084282024-09-23 20:34:47 +02002131 {"getcmdprompt", 0, 0, 0, NULL,
2132 ret_string, f_getcmdprompt},
Shougo Matsushita79d599b2022-05-07 12:48:29 +01002133 {"getcmdscreenpos", 0, 0, 0, NULL,
2134 ret_number, f_getcmdscreenpos},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002135 {"getcmdtype", 0, 0, 0, NULL,
2136 ret_string, f_getcmdtype},
2137 {"getcmdwintype", 0, 0, 0, NULL,
2138 ret_string, f_getcmdwintype},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002139 {"getcompletion", 2, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002140 ret_list_string, f_getcompletion},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002141 {"getcurpos", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002142 ret_list_number, f_getcurpos},
Bram Moolenaar82e46e52022-02-05 18:12:34 +00002143 {"getcursorcharpos", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar6f02b002021-01-10 20:22:54 +01002144 ret_list_number, f_getcursorcharpos},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002145 {"getcwd", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002146 ret_string, f_getcwd},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002147 {"getenv", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar7ad67d12021-03-10 16:08:26 +01002148 ret_any, f_getenv},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002149 {"getfontname", 0, 1, 0, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002150 ret_string, f_getfontname},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002151 {"getfperm", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002152 ret_string, f_getfperm},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002153 {"getfsize", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002154 ret_number, f_getfsize},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002155 {"getftime", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002156 ret_number, f_getftime},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002157 {"getftype", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002158 ret_string, f_getftype},
2159 {"getimstatus", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002160 ret_number_bool, f_getimstatus},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002161 {"getjumplist", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002162 ret_list_any, f_getjumplist},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002163 {"getline", 1, 2, FEARG_1, arg2_lnum,
Bram Moolenaar078a4612022-01-04 15:17:03 +00002164 ret_getline, f_getline},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002165 {"getloclist", 1, 2, 0, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002166 ret_list_or_dict_1, f_getloclist},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002167 {"getmarklist", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002168 ret_list_dict_any, f_getmarklist},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002169 {"getmatches", 0, 1, 0, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002170 ret_list_dict_any, f_getmatches},
2171 {"getmousepos", 0, 0, 0, NULL,
2172 ret_dict_number, f_getmousepos},
Bram Moolenaar24dc19c2022-11-14 19:49:15 +00002173 {"getmouseshape", 0, 0, 0, NULL,
2174 ret_string, f_getmouseshape},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002175 {"getpid", 0, 0, 0, NULL,
2176 ret_number, f_getpid},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002177 {"getpos", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002178 ret_list_number, f_getpos},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002179 {"getqflist", 0, 1, 0, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002180 ret_list_or_dict_0, f_getqflist},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002181 {"getreg", 0, 3, FEARG_1, arg3_string_bool_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002182 ret_getreg, f_getreg},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002183 {"getreginfo", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002184 ret_dict_any, f_getreginfo},
Shougo Matsushita19b71882024-02-28 22:48:12 +01002185 {"getregion", 2, 3, FEARG_1, arg3_list_list_dict,
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01002186 ret_list_string, f_getregion},
zeertzjqd4d12072024-07-16 20:34:16 +02002187 {"getregionpos", 2, 3, FEARG_1, arg3_list_list_dict,
2188 ret_list_regionpos, f_getregionpos},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002189 {"getregtype", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002190 ret_string, f_getregtype},
Yegappan Lakshmanan520f6ef2022-08-25 17:40:40 +01002191 {"getscriptinfo", 0, 1, 0, arg1_dict_any,
Yegappan Lakshmananf768c3d2022-08-22 13:15:13 +01002192 ret_list_dict_any, f_getscriptinfo},
ichizok663d18d2025-01-02 18:06:00 +01002193 {"getstacktrace", 0, 0, 0, NULL,
2194 ret_list_dict_any, f_getstacktrace},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002195 {"gettabinfo", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002196 ret_list_dict_any, f_gettabinfo},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002197 {"gettabvar", 2, 3, FEARG_1, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002198 ret_any, f_gettabvar},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002199 {"gettabwinvar", 3, 4, FEARG_1, arg4_number_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002200 ret_any, f_gettabwinvar},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002201 {"gettagstack", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002202 ret_dict_any, f_gettagstack},
Christ van Willegence0ef912024-06-20 23:41:59 +02002203 {"gettext", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002204 ret_string, f_gettext},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002205 {"getwininfo", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002206 ret_list_dict_any, f_getwininfo},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002207 {"getwinpos", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002208 ret_list_number, f_getwinpos},
2209 {"getwinposx", 0, 0, 0, NULL,
2210 ret_number, f_getwinposx},
2211 {"getwinposy", 0, 0, 0, NULL,
2212 ret_number, f_getwinposy},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002213 {"getwinvar", 2, 3, FEARG_1, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002214 ret_any, f_getwinvar},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002215 {"glob", 1, 4, FEARG_1, arg14_glob,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002216 ret_any, f_glob},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002217 {"glob2regpat", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002218 ret_string, f_glob2regpat},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002219 {"globpath", 2, 5, FEARG_2, arg25_globpath,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002220 ret_any, f_globpath},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002221 {"has", 1, 2, 0, arg2_string_bool,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002222 ret_number_bool, f_has},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002223 {"has_key", 2, 2, FEARG_1, arg2_dict_any_string_or_nr,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002224 ret_number_bool, f_has_key},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002225 {"haslocaldir", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002226 ret_number, f_haslocaldir},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002227 {"hasmapto", 1, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002228 ret_number_bool, f_hasmapto},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002229 {"highlightID", 1, 1, FEARG_1, arg1_string, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02002230 ret_number, f_hlID},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002231 {"highlight_exists",1, 1, FEARG_1, arg1_string, // obsolete
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002232 ret_number_bool, f_hlexists},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002233 {"histadd", 2, 2, FEARG_2, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002234 ret_number_bool, f_histadd},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002235 {"histdel", 1, 2, FEARG_1, arg2_string_string_or_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002236 ret_number_bool, f_histdel},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002237 {"histget", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002238 ret_string, f_histget},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002239 {"histnr", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002240 ret_number, f_histnr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002241 {"hlID", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002242 ret_number, f_hlID},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002243 {"hlexists", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002244 ret_number_bool, f_hlexists},
Yegappan Lakshmanand1a8d652021-11-03 21:56:45 +00002245 {"hlget", 0, 2, FEARG_1, arg2_string_bool,
2246 ret_list_dict_any, f_hlget},
2247 {"hlset", 1, 1, FEARG_1, arg1_list_any,
2248 ret_number_bool, f_hlset},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002249 {"hostname", 0, 0, 0, NULL,
2250 ret_string, f_hostname},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002251 {"iconv", 3, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002252 ret_string, f_iconv},
Ernie Raelc8e158b2024-07-09 18:39:52 +02002253 {"id", 1, 1, FEARG_1, NULL,
2254 ret_string, f_id},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002255 {"indent", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002256 ret_number, f_indent},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002257 {"index", 2, 4, FEARG_1, arg24_index,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002258 ret_number, f_index},
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01002259 {"indexof", 2, 3, FEARG_1, arg23_index,
2260 ret_number, f_indexof},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002261 {"input", 1, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002262 ret_string, f_input},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002263 {"inputdialog", 1, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002264 ret_string, f_inputdialog},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002265 {"inputlist", 1, 1, FEARG_1, arg1_list_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002266 ret_number, f_inputlist},
2267 {"inputrestore", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002268 ret_number_bool, f_inputrestore},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002269 {"inputsave", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002270 ret_number_bool, f_inputsave},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002271 {"inputsecret", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002272 ret_string, f_inputsecret},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002273 {"insert", 2, 3, FEARG_1, arg23_insert,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002274 ret_first_arg, f_insert},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002275 {"instanceof", 2, VARGS, FEARG_1|FE_X, arg2_instanceof,
LemonBoyafe04662023-08-23 21:08:11 +02002276 ret_bool, f_instanceof},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002277 {"interrupt", 0, 0, 0, NULL,
2278 ret_void, f_interrupt},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002279 {"invert", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002280 ret_number, f_invert},
LemonBoydca1d402022-04-28 15:26:33 +01002281 {"isabsolutepath", 1, 1, FEARG_1, arg1_string,
2282 ret_number_bool, f_isabsolutepath},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002283 {"isdirectory", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002284 ret_number_bool, f_isdirectory},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002285 {"isinf", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002286 ret_number, MATH_FUNC(f_isinf)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002287 {"islocked", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002288 ret_number_bool, f_islocked},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002289 {"isnan", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002290 ret_number_bool, MATH_FUNC(f_isnan)},
Bram Moolenaar3e518a82022-08-30 17:45:33 +01002291 {"items", 1, 1, FEARG_1, arg1_string_or_list_or_dict,
Bram Moolenaarefc5db52021-07-07 21:21:30 +02002292 ret_list_items, f_items},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002293 {"job_getchannel", 1, 1, FEARG_1, arg1_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002294 ret_channel, JOB_FUNC(f_job_getchannel)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002295 {"job_info", 0, 1, FEARG_1, arg1_job,
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01002296 ret_job_info, JOB_FUNC(f_job_info)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002297 {"job_setoptions", 2, 2, FEARG_1, arg2_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002298 ret_void, JOB_FUNC(f_job_setoptions)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002299 {"job_start", 1, 2, FEARG_1, arg2_string_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002300 ret_job, JOB_FUNC(f_job_start)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002301 {"job_status", 1, 1, FEARG_1, arg1_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002302 ret_string, JOB_FUNC(f_job_status)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002303 {"job_stop", 1, 2, FEARG_1, arg2_job_string_or_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002304 ret_number_bool, JOB_FUNC(f_job_stop)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002305 {"join", 1, 2, FEARG_1, arg2_list_any_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002306 ret_string, f_join},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002307 {"js_decode", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002308 ret_any, f_js_decode},
2309 {"js_encode", 1, 1, FEARG_1, NULL,
2310 ret_string, f_js_encode},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002311 {"json_decode", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002312 ret_any, f_json_decode},
2313 {"json_encode", 1, 1, FEARG_1, NULL,
2314 ret_string, f_json_encode},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002315 {"keys", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002316 ret_list_string, f_keys},
zeertzjqcdc83932022-09-12 13:38:41 +01002317 {"keytrans", 1, 1, FEARG_1, arg1_string,
2318 ret_string, f_keytrans},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002319 {"last_buffer_nr", 0, 0, 0, NULL, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02002320 ret_number, f_last_buffer_nr},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002321 {"len", 1, 1, FEARG_1, arg1_len,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002322 ret_number, f_len},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002323 {"libcall", 3, 3, FEARG_3, arg3_libcall,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002324 ret_string, f_libcall},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002325 {"libcallnr", 3, 3, FEARG_3, arg3_libcall,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002326 ret_number, f_libcallnr},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002327 {"line", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002328 ret_number, f_line},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002329 {"line2byte", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002330 ret_number, f_line2byte},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002331 {"lispindent", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002332 ret_number, f_lispindent},
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +02002333 {"list2blob", 1, 1, FEARG_1, arg1_list_number,
2334 ret_blob, f_list2blob},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002335 {"list2str", 1, 2, FEARG_1, arg2_list_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002336 ret_string, f_list2str},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002337 {"listener_add", 1, 2, FEARG_2, arg2_any_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002338 ret_number, f_listener_add},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002339 {"listener_flush", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002340 ret_void, f_listener_flush},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002341 {"listener_remove", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002342 ret_number_bool, f_listener_remove},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002343 {"localtime", 0, 0, 0, NULL,
2344 ret_number, f_localtime},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002345 {"log", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002346 ret_float, f_log},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002347 {"log10", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002348 ret_float, f_log10},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002349 {"luaeval", 1, 2, FEARG_1, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002350 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002351#ifdef FEAT_LUA
Bram Moolenaar15c47602020-03-26 22:16:48 +01002352 f_luaeval
2353#else
2354 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002355#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002356 },
Bram Moolenaar18024052021-12-25 21:43:28 +00002357 {"map", 2, 2, FEARG_1, arg2_map,
Bram Moolenaarea696852020-11-09 18:31:39 +01002358 ret_first_cont, f_map},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002359 {"maparg", 1, 4, FEARG_1, arg14_maparg,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002360 ret_maparg, f_maparg},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002361 {"mapcheck", 1, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002362 ret_string, f_mapcheck},
Ernie Rael09661202022-04-25 14:40:44 +01002363 {"maplist", 0, 1, 0, arg1_bool,
2364 ret_list_dict_any, f_maplist},
Bram Moolenaar18024052021-12-25 21:43:28 +00002365 {"mapnew", 2, 2, FEARG_1, arg2_mapnew,
Bram Moolenaarea696852020-11-09 18:31:39 +01002366 ret_first_cont, f_mapnew},
Ernie Rael51d04d12022-05-04 15:40:22 +01002367 {"mapset", 1, 3, FEARG_1, arg3_string_or_dict_bool_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002368 ret_void, f_mapset},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002369 {"match", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002370 ret_any, f_match},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002371 {"matchadd", 2, 5, FEARG_1, arg25_matchadd,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002372 ret_number, f_matchadd},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002373 {"matchaddpos", 2, 5, FEARG_1, arg25_matchaddpos,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002374 ret_number, f_matchaddpos},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002375 {"matcharg", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002376 ret_list_string, f_matcharg},
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01002377 {"matchbufline", 4, 5, FEARG_1, arg45_matchbufline,
2378 ret_list_any, f_matchbufline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002379 {"matchdelete", 1, 2, FEARG_1, arg2_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002380 ret_number_bool, f_matchdelete},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002381 {"matchend", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002382 ret_number, f_matchend},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002383 {"matchfuzzy", 2, 3, FEARG_1, arg3_list_string_dict,
Yegappan Lakshmanan2d8e9982023-06-24 16:42:25 +01002384 ret_list_any, f_matchfuzzy},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002385 {"matchfuzzypos", 2, 3, FEARG_1, arg3_list_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002386 ret_list_any, f_matchfuzzypos},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002387 {"matchlist", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002388 ret_list_string, f_matchlist},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002389 {"matchstr", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002390 ret_string, f_matchstr},
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01002391 {"matchstrlist", 2, 3, FEARG_1, arg23_matchstrlist,
2392 ret_list_any, f_matchstrlist},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002393 {"matchstrpos", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002394 ret_list_any, f_matchstrpos},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002395 {"max", 1, 1, FEARG_1, arg1_list_or_dict,
Bram Moolenaar9ae37052021-01-22 22:31:10 +01002396 ret_number, f_max},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002397 {"menu_info", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002398 ret_dict_any,
Bram Moolenaara2cbdea2020-03-16 21:08:31 +01002399#ifdef FEAT_MENU
Bram Moolenaar15c47602020-03-26 22:16:48 +01002400 f_menu_info
2401#else
2402 NULL
Bram Moolenaara2cbdea2020-03-16 21:08:31 +01002403#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002404 },
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002405 {"min", 1, 1, FEARG_1, arg1_list_or_dict,
Bram Moolenaar9ae37052021-01-22 22:31:10 +01002406 ret_number, f_min},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002407 {"mkdir", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002408 ret_number_bool, f_mkdir},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002409 {"mode", 0, 1, FEARG_1, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002410 ret_string, f_mode},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002411 {"mzeval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002412 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002413#ifdef FEAT_MZSCHEME
Bram Moolenaar15c47602020-03-26 22:16:48 +01002414 f_mzeval
2415#else
2416 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002417#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002418 },
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002419 {"nextnonblank", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002420 ret_number, f_nextnonblank},
Christ van Willegenc0786752025-02-01 15:42:16 +01002421 {"ngettext", 3, 4, FEARG_3, arg4_string_string_number_string,
2422 ret_string, f_ngettext},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002423 {"nr2char", 1, 2, FEARG_1, arg2_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002424 ret_string, f_nr2char},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002425 {"or", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002426 ret_number, f_or},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002427 {"pathshorten", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002428 ret_string, f_pathshorten},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002429 {"perleval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002430 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002431#ifdef FEAT_PERL
Bram Moolenaar15c47602020-03-26 22:16:48 +01002432 f_perleval
2433#else
2434 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002435#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002436 },
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002437 {"popup_atcursor", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002438 ret_number, PROP_FUNC(f_popup_atcursor)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002439 {"popup_beval", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002440 ret_number, PROP_FUNC(f_popup_beval)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002441 {"popup_clear", 0, 1, 0, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002442 ret_void, PROP_FUNC(f_popup_clear)},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002443 {"popup_close", 1, 2, FEARG_1, arg2_number_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002444 ret_void, PROP_FUNC(f_popup_close)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002445 {"popup_create", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002446 ret_number, PROP_FUNC(f_popup_create)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002447 {"popup_dialog", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002448 ret_number, PROP_FUNC(f_popup_dialog)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002449 {"popup_filter_menu", 2, 2, 0, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002450 ret_bool, PROP_FUNC(f_popup_filter_menu)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002451 {"popup_filter_yesno", 2, 2, 0, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002452 ret_bool, PROP_FUNC(f_popup_filter_yesno)},
Bram Moolenaarbdc09a12022-10-07 14:31:45 +01002453 {"popup_findecho", 0, 0, 0, NULL,
2454 ret_number, PROP_FUNC(f_popup_findecho)},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002455 {"popup_findinfo", 0, 0, 0, NULL,
2456 ret_number, PROP_FUNC(f_popup_findinfo)},
2457 {"popup_findpreview", 0, 0, 0, NULL,
2458 ret_number, PROP_FUNC(f_popup_findpreview)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002459 {"popup_getoptions", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002460 ret_dict_any, PROP_FUNC(f_popup_getoptions)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002461 {"popup_getpos", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002462 ret_dict_any, PROP_FUNC(f_popup_getpos)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002463 {"popup_hide", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002464 ret_void, PROP_FUNC(f_popup_hide)},
2465 {"popup_list", 0, 0, 0, NULL,
2466 ret_list_number, PROP_FUNC(f_popup_list)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002467 {"popup_locate", 2, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002468 ret_number, PROP_FUNC(f_popup_locate)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002469 {"popup_menu", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002470 ret_number, PROP_FUNC(f_popup_menu)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002471 {"popup_move", 2, 2, FEARG_1, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002472 ret_void, PROP_FUNC(f_popup_move)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002473 {"popup_notification", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002474 ret_number, PROP_FUNC(f_popup_notification)},
Christian Brabandtfbc37f12024-06-18 20:50:58 +02002475 {"popup_setbuf", 2, 2, FEARG_1, arg2_number_buffer,
2476 ret_number_bool, PROP_FUNC(f_popup_setbuf)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002477 {"popup_setoptions", 2, 2, FEARG_1, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002478 ret_void, PROP_FUNC(f_popup_setoptions)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002479 {"popup_settext", 2, 2, FEARG_1, arg2_number_string_or_list,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002480 ret_void, PROP_FUNC(f_popup_settext)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002481 {"popup_show", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002482 ret_void, PROP_FUNC(f_popup_show)},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002483 {"pow", 2, 2, FEARG_1, arg2_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002484 ret_float, f_pow},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002485 {"prevnonblank", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002486 ret_number, f_prevnonblank},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002487 {"printf", 1, 19, FEARG_2, arg119_printf,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002488 ret_string, f_printf},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002489 {"prompt_getprompt", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002490 ret_string, JOB_FUNC(f_prompt_getprompt)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002491 {"prompt_setcallback", 2, 2, FEARG_1, arg2_buffer_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002492 ret_void, JOB_FUNC(f_prompt_setcallback)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002493 {"prompt_setinterrupt", 2, 2, FEARG_1, arg2_buffer_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002494 ret_void, JOB_FUNC(f_prompt_setinterrupt)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002495 {"prompt_setprompt", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002496 ret_void, JOB_FUNC(f_prompt_setprompt)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002497 {"prop_add", 3, 3, FEARG_1, arg3_number_number_dict,
Bram Moolenaar7f9969c2022-07-25 18:13:54 +01002498 ret_number, PROP_FUNC(f_prop_add)},
Yegappan Lakshmananccfb7c62021-08-16 21:39:09 +02002499 {"prop_add_list", 2, 2, FEARG_1, arg2_dict_any_list_any,
2500 ret_void, PROP_FUNC(f_prop_add_list)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002501 {"prop_clear", 1, 3, FEARG_1, arg3_number_number_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002502 ret_void, PROP_FUNC(f_prop_clear)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002503 {"prop_find", 1, 2, FEARG_1, arg2_dict_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002504 ret_dict_any, PROP_FUNC(f_prop_find)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002505 {"prop_list", 1, 2, FEARG_1, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002506 ret_list_dict_any, PROP_FUNC(f_prop_list)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002507 {"prop_remove", 1, 3, FEARG_1, arg3_dict_number_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002508 ret_number, PROP_FUNC(f_prop_remove)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002509 {"prop_type_add", 2, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002510 ret_void, PROP_FUNC(f_prop_type_add)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002511 {"prop_type_change", 2, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002512 ret_void, PROP_FUNC(f_prop_type_change)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002513 {"prop_type_delete", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002514 ret_void, PROP_FUNC(f_prop_type_delete)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002515 {"prop_type_get", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002516 ret_dict_any, PROP_FUNC(f_prop_type_get)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002517 {"prop_type_list", 0, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002518 ret_list_string, PROP_FUNC(f_prop_type_list)},
2519 {"pum_getpos", 0, 0, 0, NULL,
2520 ret_dict_number, f_pum_getpos},
2521 {"pumvisible", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002522 ret_number_bool, f_pumvisible},
Ben Jacksonea19e782024-11-06 21:50:05 +01002523 {"py3eval", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002524 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002525#ifdef FEAT_PYTHON3
Bram Moolenaar15c47602020-03-26 22:16:48 +01002526 f_py3eval
2527#else
2528 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002529#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002530 },
Ben Jacksonea19e782024-11-06 21:50:05 +01002531 {"pyeval", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002532 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002533#ifdef FEAT_PYTHON
Bram Moolenaar15c47602020-03-26 22:16:48 +01002534 f_pyeval
2535#else
2536 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002537#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002538 },
Ben Jacksonea19e782024-11-06 21:50:05 +01002539 {"pyxeval", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002540 ret_any,
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01002541#if defined(FEAT_PYTHON) || defined(FEAT_PYTHON3)
Bram Moolenaar15c47602020-03-26 22:16:48 +01002542 f_pyxeval
2543#else
2544 NULL
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01002545#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002546 },
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002547 {"rand", 0, 1, FEARG_1, arg1_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002548 ret_number, f_rand},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002549 {"range", 1, 3, FEARG_1, arg3_number,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00002550 ret_list_number, f_range},
K.Takata11df3ae2022-10-19 14:02:40 +01002551 {"readblob", 1, 3, FEARG_1, arg3_string_number_number,
Bram Moolenaarc423ad72021-01-13 20:38:03 +01002552 ret_blob, f_readblob},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002553 {"readdir", 1, 3, FEARG_1, arg3_string_any_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002554 ret_list_string, f_readdir},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002555 {"readdirex", 1, 3, FEARG_1, arg3_string_any_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002556 ret_list_dict_any, f_readdirex},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002557 {"readfile", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaarc423ad72021-01-13 20:38:03 +01002558 ret_list_string, f_readfile},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002559 {"reduce", 2, 3, FEARG_1, arg23_reduce,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002560 ret_any, f_reduce},
2561 {"reg_executing", 0, 0, 0, NULL,
2562 ret_string, f_reg_executing},
2563 {"reg_recording", 0, 0, 0, NULL,
2564 ret_string, f_reg_recording},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002565 {"reltime", 0, 2, FEARG_1, arg2_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002566 ret_list_any, f_reltime},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002567 {"reltimefloat", 1, 1, FEARG_1, arg1_list_number,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002568 ret_float, f_reltimefloat},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002569 {"reltimestr", 1, 1, FEARG_1, arg1_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002570 ret_string, f_reltimestr},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002571 {"remote_expr", 2, 4, FEARG_1, arg24_remote_expr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002572 ret_string, f_remote_expr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002573 {"remote_foreground", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002574 ret_string, f_remote_foreground},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002575 {"remote_peek", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002576 ret_number, f_remote_peek},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002577 {"remote_read", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002578 ret_string, f_remote_read},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002579 {"remote_send", 2, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002580 ret_string, f_remote_send},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002581 {"remote_startserver", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002582 ret_void, f_remote_startserver},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002583 {"remove", 2, 3, FEARG_1, arg23_remove,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002584 ret_remove, f_remove},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002585 {"rename", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002586 ret_number_bool, f_rename},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002587 {"repeat", 2, 2, FEARG_1, arg2_repeat,
Bram Moolenaar1780f082021-07-31 22:03:59 +02002588 ret_repeat, f_repeat},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002589 {"resolve", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002590 ret_string, f_resolve},
Yegappan Lakshmananf9dc2782023-05-11 15:02:56 +01002591 {"reverse", 1, 1, FEARG_1, arg1_string_or_list_or_blob_mod,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002592 ret_first_arg, f_reverse},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002593 {"round", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002594 ret_float, f_round},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002595 {"rubyeval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002596 ret_any,
Bram Moolenaare99be0e2019-03-26 22:51:09 +01002597#ifdef FEAT_RUBY
Bram Moolenaar15c47602020-03-26 22:16:48 +01002598 f_rubyeval
2599#else
2600 NULL
Bram Moolenaare99be0e2019-03-26 22:51:09 +01002601#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002602 },
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002603 {"screenattr", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002604 ret_number, f_screenattr},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002605 {"screenchar", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002606 ret_number, f_screenchar},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002607 {"screenchars", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002608 ret_list_number, f_screenchars},
2609 {"screencol", 0, 0, 0, NULL,
2610 ret_number, f_screencol},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002611 {"screenpos", 3, 3, FEARG_1, arg3_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002612 ret_dict_number, f_screenpos},
2613 {"screenrow", 0, 0, 0, NULL,
2614 ret_number, f_screenrow},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002615 {"screenstring", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002616 ret_string, f_screenstring},
Bram Moolenaarcd268012021-07-22 19:11:08 +02002617 {"search", 1, 5, FEARG_1, arg15_search,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002618 ret_number, f_search},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002619 {"searchcount", 0, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002620 ret_dict_any, f_searchcount},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002621 {"searchdecl", 1, 3, FEARG_1, arg3_string_bool_bool,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002622 ret_number_bool, f_searchdecl},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002623 {"searchpair", 3, 7, 0, arg37_searchpair,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002624 ret_number, f_searchpair},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002625 {"searchpairpos", 3, 7, 0, arg37_searchpair,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002626 ret_list_number, f_searchpairpos},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002627 {"searchpos", 1, 5, FEARG_1, arg15_search,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002628 ret_list_number, f_searchpos},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002629 {"server2client", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002630 ret_number_bool, f_server2client},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002631 {"serverlist", 0, 0, 0, NULL,
2632 ret_string, f_serverlist},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002633 {"setbufline", 3, 3, FEARG_3, arg3_setbufline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002634 ret_number_bool, f_setbufline},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002635 {"setbufvar", 3, 3, FEARG_3, arg3_buffer_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002636 ret_void, f_setbufvar},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002637 {"setcellwidths", 1, 1, FEARG_1, arg1_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002638 ret_void, f_setcellwidths},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002639 {"setcharpos", 2, 2, FEARG_2, arg2_string_list_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002640 ret_number_bool, f_setcharpos},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002641 {"setcharsearch", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002642 ret_void, f_setcharsearch},
Shougo Matsushita07ea5f12022-08-27 12:22:25 +01002643 {"setcmdline", 1, 2, FEARG_1, arg2_string_number,
2644 ret_number_bool, f_setcmdline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002645 {"setcmdpos", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002646 ret_number_bool, f_setcmdpos},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002647 {"setcursorcharpos", 1, 3, FEARG_1, arg13_cursor,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002648 ret_number_bool, f_setcursorcharpos},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002649 {"setenv", 2, 2, FEARG_2, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002650 ret_void, f_setenv},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002651 {"setfperm", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002652 ret_number_bool, f_setfperm},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002653 {"setline", 2, 2, FEARG_2, arg2_setline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002654 ret_number_bool, f_setline},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002655 {"setloclist", 2, 4, FEARG_2, arg24_setloclist,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002656 ret_number_bool, f_setloclist},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002657 {"setmatches", 1, 2, FEARG_1, arg2_list_any_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002658 ret_number_bool, f_setmatches},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002659 {"setpos", 2, 2, FEARG_2, arg2_string_list_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002660 ret_number_bool, f_setpos},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002661 {"setqflist", 1, 3, FEARG_1, arg13_setqflist,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002662 ret_number_bool, f_setqflist},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002663 {"setreg", 2, 3, FEARG_2, arg3_string_any_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002664 ret_number_bool, f_setreg},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002665 {"settabvar", 3, 3, FEARG_3, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002666 ret_void, f_settabvar},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002667 {"settabwinvar", 4, 4, FEARG_4, arg4_number_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002668 ret_void, f_settabwinvar},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002669 {"settagstack", 2, 3, FEARG_2, arg23_settagstack,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002670 ret_number_bool, f_settagstack},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002671 {"setwinvar", 3, 3, FEARG_3, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002672 ret_void, f_setwinvar},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002673 {"sha256", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002674 ret_string,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002675#ifdef FEAT_CRYPT
Bram Moolenaar15c47602020-03-26 22:16:48 +01002676 f_sha256
2677#else
2678 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002679#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002680 },
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002681 {"shellescape", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002682 ret_string, f_shellescape},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002683 {"shiftwidth", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002684 ret_number, f_shiftwidth},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002685 {"sign_define", 1, 2, FEARG_1, arg2_string_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002686 ret_any, SIGN_FUNC(f_sign_define)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002687 {"sign_getdefined", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002688 ret_list_dict_any, SIGN_FUNC(f_sign_getdefined)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002689 {"sign_getplaced", 0, 2, FEARG_1, arg02_sign_getplaced,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002690 ret_list_dict_any, SIGN_FUNC(f_sign_getplaced)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002691 {"sign_jump", 3, 3, FEARG_1, arg3_number_string_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002692 ret_number, SIGN_FUNC(f_sign_jump)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002693 {"sign_place", 4, 5, FEARG_1, arg45_sign_place,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002694 ret_number, SIGN_FUNC(f_sign_place)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002695 {"sign_placelist", 1, 1, FEARG_1, arg1_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002696 ret_list_number, SIGN_FUNC(f_sign_placelist)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002697 {"sign_undefine", 0, 1, FEARG_1, arg1_string_or_list_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002698 ret_number_bool, SIGN_FUNC(f_sign_undefine)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002699 {"sign_unplace", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002700 ret_number_bool, SIGN_FUNC(f_sign_unplace)},
Sean Dewara63780b2021-11-03 13:15:47 +00002701 {"sign_unplacelist", 1, 1, FEARG_1, arg1_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002702 ret_list_number, SIGN_FUNC(f_sign_unplacelist)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002703 {"simplify", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002704 ret_string, f_simplify},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002705 {"sin", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002706 ret_float, f_sin},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002707 {"sinh", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002708 ret_float, f_sinh},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002709 {"slice", 2, 3, FEARG_1, arg23_slice,
Bram Moolenaar00eb9952022-02-05 19:23:18 +00002710 ret_slice, f_slice},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002711 {"sort", 1, 3, FEARG_1, arg13_sortuniq,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002712 ret_first_arg, f_sort},
2713 {"sound_clear", 0, 0, 0, NULL,
2714 ret_void, SOUND_FUNC(f_sound_clear)},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002715 {"sound_playevent", 1, 2, FEARG_1, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002716 ret_number, SOUND_FUNC(f_sound_playevent)},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002717 {"sound_playfile", 1, 2, FEARG_1, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002718 ret_number, SOUND_FUNC(f_sound_playfile)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002719 {"sound_stop", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002720 ret_void, SOUND_FUNC(f_sound_stop)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002721 {"soundfold", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002722 ret_string, f_soundfold},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002723 {"spellbadword", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002724 ret_list_string, f_spellbadword},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002725 {"spellsuggest", 1, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002726 ret_list_string, f_spellsuggest},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002727 {"split", 1, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002728 ret_list_string, f_split},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002729 {"sqrt", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002730 ret_float, f_sqrt},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002731 {"srand", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002732 ret_list_number, f_srand},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002733 {"state", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002734 ret_string, f_state},
Yegappan Lakshmanana11b23c2025-01-16 19:16:42 +01002735 {"str2blob", 1, 2, FEARG_1, arg2_list_string_dict,
Yegappan Lakshmanan1aefe1d2025-01-14 17:29:42 +01002736 ret_blob, f_str2blob},
Bram Moolenaar80a070c2021-08-08 15:51:10 +02002737 {"str2float", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002738 ret_float, f_str2float},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002739 {"str2list", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002740 ret_list_number, f_str2list},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002741 {"str2nr", 1, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002742 ret_number, f_str2nr},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002743 {"strcharlen", 1, 1, FEARG_1, arg1_string_or_nr,
Bram Moolenaar70ce8a12021-03-14 19:02:09 +01002744 ret_number, f_strcharlen},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002745 {"strcharpart", 2, 4, FEARG_1, arg24_strpart,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002746 ret_string, f_strcharpart},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002747 {"strchars", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002748 ret_number, f_strchars},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002749 {"strdisplaywidth", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002750 ret_number, f_strdisplaywidth},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002751 {"strftime", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002752 ret_string,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002753#ifdef HAVE_STRFTIME
Bram Moolenaar15c47602020-03-26 22:16:48 +01002754 f_strftime
2755#else
2756 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002757#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002758 },
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002759 {"strgetchar", 2, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002760 ret_number, f_strgetchar},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002761 {"stridx", 2, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002762 ret_number, f_stridx},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002763 {"string", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002764 ret_string, f_string},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002765 {"strlen", 1, 1, FEARG_1, arg1_string_or_nr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002766 ret_number, f_strlen},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002767 {"strpart", 2, 4, FEARG_1, arg24_strpart,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002768 ret_string, f_strpart},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002769 {"strptime", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002770 ret_number,
Bram Moolenaar10455d42019-11-21 15:36:18 +01002771#ifdef HAVE_STRPTIME
Bram Moolenaar15c47602020-03-26 22:16:48 +01002772 f_strptime
2773#else
2774 NULL
Bram Moolenaar10455d42019-11-21 15:36:18 +01002775#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002776 },
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002777 {"strridx", 2, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002778 ret_number, f_strridx},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002779 {"strtrans", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002780 ret_string, f_strtrans},
Christian Brabandt67672ef2023-04-24 21:09:54 +01002781 {"strutf16len", 1, 2, FEARG_1, arg2_string_bool,
2782 ret_number, f_strutf16len},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002783 {"strwidth", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002784 ret_number, f_strwidth},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002785 {"submatch", 1, 2, FEARG_1, arg2_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002786 ret_string, f_submatch},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002787 {"substitute", 4, 4, FEARG_1, arg4_string_string_any_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002788 ret_string, f_substitute},
Bram Moolenaarc216a7a2022-12-05 13:50:55 +00002789 {"swapfilelist", 0, 0, 0, NULL,
2790 ret_list_string, f_swapfilelist},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002791 {"swapinfo", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002792 ret_dict_any, f_swapinfo},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002793 {"swapname", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002794 ret_string, f_swapname},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002795 {"synID", 3, 3, 0, arg3_lnum_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002796 ret_number, f_synID},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002797 {"synIDattr", 2, 3, FEARG_1, arg3_number_string_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002798 ret_string, f_synIDattr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002799 {"synIDtrans", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002800 ret_number, f_synIDtrans},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002801 {"synconcealed", 2, 2, 0, arg2_lnum_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002802 ret_list_any, f_synconcealed},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002803 {"synstack", 2, 2, 0, arg2_lnum_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002804 ret_list_number, f_synstack},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002805 {"system", 1, 2, FEARG_1, arg12_system,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002806 ret_string, f_system},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002807 {"systemlist", 1, 2, FEARG_1, arg12_system,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002808 ret_list_string, f_systemlist},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002809 {"tabpagebuflist", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002810 ret_list_number, f_tabpagebuflist},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002811 {"tabpagenr", 0, 1, 0, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002812 ret_number, f_tabpagenr},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002813 {"tabpagewinnr", 1, 2, FEARG_1, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002814 ret_number, f_tabpagewinnr},
2815 {"tagfiles", 0, 0, 0, NULL,
2816 ret_list_string, f_tagfiles},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002817 {"taglist", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002818 ret_list_dict_any, f_taglist},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002819 {"tan", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002820 ret_float, f_tan},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002821 {"tanh", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002822 ret_float, f_tanh},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002823 {"tempname", 0, 0, 0, NULL,
2824 ret_string, f_tempname},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002825 {"term_dumpdiff", 2, 3, FEARG_1, arg3_string_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002826 ret_number, TERM_FUNC(f_term_dumpdiff)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002827 {"term_dumpload", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002828 ret_number, TERM_FUNC(f_term_dumpload)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002829 {"term_dumpwrite", 2, 3, FEARG_2, arg3_buffer_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002830 ret_void, TERM_FUNC(f_term_dumpwrite)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002831 {"term_getaltscreen", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002832 ret_number, TERM_FUNC(f_term_getaltscreen)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002833 {"term_getansicolors", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002834 ret_list_string,
Bram Moolenaarbd5e6222020-03-26 23:13:34 +01002835#if defined(FEAT_TERMINAL) && (defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS))
Bram Moolenaar15c47602020-03-26 22:16:48 +01002836 f_term_getansicolors
2837#else
2838 NULL
Bram Moolenaarc6df10e2017-07-29 20:15:08 +02002839#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002840 },
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002841 {"term_getattr", 2, 2, FEARG_1, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002842 ret_number, TERM_FUNC(f_term_getattr)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002843 {"term_getcursor", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002844 ret_list_any, TERM_FUNC(f_term_getcursor)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002845 {"term_getjob", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002846 ret_job, TERM_FUNC(f_term_getjob)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002847 {"term_getline", 2, 2, FEARG_1, arg2_buffer_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002848 ret_string, TERM_FUNC(f_term_getline)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002849 {"term_getscrolled", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002850 ret_number, TERM_FUNC(f_term_getscrolled)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002851 {"term_getsize", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002852 ret_list_number, TERM_FUNC(f_term_getsize)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002853 {"term_getstatus", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002854 ret_string, TERM_FUNC(f_term_getstatus)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002855 {"term_gettitle", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002856 ret_string, TERM_FUNC(f_term_gettitle)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002857 {"term_gettty", 1, 2, FEARG_1, arg2_buffer_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002858 ret_string, TERM_FUNC(f_term_gettty)},
2859 {"term_list", 0, 0, 0, NULL,
2860 ret_list_number, TERM_FUNC(f_term_list)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002861 {"term_scrape", 2, 2, FEARG_1, arg2_buffer_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002862 ret_list_dict_any, TERM_FUNC(f_term_scrape)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002863 {"term_sendkeys", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002864 ret_void, TERM_FUNC(f_term_sendkeys)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002865 {"term_setansicolors", 2, 2, FEARG_1, arg2_buffer_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002866 ret_void,
Bram Moolenaarbd5e6222020-03-26 23:13:34 +01002867#if defined(FEAT_TERMINAL) && (defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS))
Bram Moolenaar15c47602020-03-26 22:16:48 +01002868 f_term_setansicolors
2869#else
2870 NULL
2871#endif
2872 },
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002873 {"term_setapi", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002874 ret_void, TERM_FUNC(f_term_setapi)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002875 {"term_setkill", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002876 ret_void, TERM_FUNC(f_term_setkill)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002877 {"term_setrestore", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002878 ret_void, TERM_FUNC(f_term_setrestore)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002879 {"term_setsize", 3, 3, FEARG_1, arg3_buffer_number_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002880 ret_void, TERM_FUNC(f_term_setsize)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002881 {"term_start", 1, 2, FEARG_1, arg2_string_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002882 ret_number, TERM_FUNC(f_term_start)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002883 {"term_wait", 1, 2, FEARG_1, arg2_buffer_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002884 ret_void, TERM_FUNC(f_term_wait)},
2885 {"terminalprops", 0, 0, 0, NULL,
2886 ret_dict_string, f_terminalprops},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002887 {"test_alloc_fail", 3, 3, FEARG_1, arg3_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002888 ret_void, f_test_alloc_fail},
2889 {"test_autochdir", 0, 0, 0, NULL,
2890 ret_void, f_test_autochdir},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002891 {"test_feedinput", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002892 ret_void, f_test_feedinput},
2893 {"test_garbagecollect_now", 0, 0, 0, NULL,
2894 ret_void, f_test_garbagecollect_now},
2895 {"test_garbagecollect_soon", 0, 0, 0, NULL,
2896 ret_void, f_test_garbagecollect_soon},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002897 {"test_getvalue", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002898 ret_number, f_test_getvalue},
Yegappan Lakshmanan06011e12022-01-30 12:37:29 +00002899 {"test_gui_event", 2, 2, FEARG_1, arg2_string_dict,
2900 ret_bool, f_test_gui_event},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002901 {"test_ignore_error", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002902 ret_void, f_test_ignore_error},
Christopher Plewright20b795e2022-12-20 20:01:58 +00002903 {"test_mswin_event", 2, 2, FEARG_1, arg2_string_dict,
2904 ret_number, f_test_mswin_event},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002905 {"test_null_blob", 0, 0, 0, NULL,
2906 ret_blob, f_test_null_blob},
2907 {"test_null_channel", 0, 0, 0, NULL,
2908 ret_channel, JOB_FUNC(f_test_null_channel)},
2909 {"test_null_dict", 0, 0, 0, NULL,
2910 ret_dict_any, f_test_null_dict},
2911 {"test_null_function", 0, 0, 0, NULL,
2912 ret_func_any, f_test_null_function},
2913 {"test_null_job", 0, 0, 0, NULL,
2914 ret_job, JOB_FUNC(f_test_null_job)},
2915 {"test_null_list", 0, 0, 0, NULL,
2916 ret_list_any, f_test_null_list},
2917 {"test_null_partial", 0, 0, 0, NULL,
2918 ret_func_any, f_test_null_partial},
2919 {"test_null_string", 0, 0, 0, NULL,
2920 ret_string, f_test_null_string},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002921 {"test_option_not_set", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002922 ret_void, f_test_option_not_set},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002923 {"test_override", 2, 2, FEARG_2, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002924 ret_void, f_test_override},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002925 {"test_refcount", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002926 ret_number, f_test_refcount},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002927 {"test_setmouse", 2, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002928 ret_void, f_test_setmouse},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002929 {"test_settime", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002930 ret_void, f_test_settime},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002931 {"test_srand_seed", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002932 ret_void, f_test_srand_seed},
2933 {"test_unknown", 0, 0, 0, NULL,
2934 ret_any, f_test_unknown},
2935 {"test_void", 0, 0, 0, NULL,
2936 ret_void, f_test_void},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002937 {"timer_info", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002938 ret_list_dict_any, TIMER_FUNC(f_timer_info)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002939 {"timer_pause", 2, 2, FEARG_1, arg2_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002940 ret_void, TIMER_FUNC(f_timer_pause)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002941 {"timer_start", 2, 3, FEARG_1, arg3_number_any_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002942 ret_number, TIMER_FUNC(f_timer_start)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002943 {"timer_stop", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002944 ret_void, TIMER_FUNC(f_timer_stop)},
2945 {"timer_stopall", 0, 0, 0, NULL,
2946 ret_void, TIMER_FUNC(f_timer_stopall)},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002947 {"tolower", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002948 ret_string, f_tolower},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002949 {"toupper", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002950 ret_string, f_toupper},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002951 {"tr", 3, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002952 ret_string, f_tr},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002953 {"trim", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002954 ret_string, f_trim},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002955 {"trunc", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002956 ret_float, f_trunc},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002957 {"type", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002958 ret_number, f_type},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002959 {"typename", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaara47e05f2021-01-12 21:49:00 +01002960 ret_string, f_typename},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002961 {"undofile", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002962 ret_string, f_undofile},
Devin J. Pohly5fee1112023-04-23 20:26:59 -05002963 {"undotree", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002964 ret_dict_any, f_undotree},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002965 {"uniq", 1, 3, FEARG_1, arg13_sortuniq,
Bram Moolenaar08018222021-12-22 18:45:37 +00002966 ret_first_arg, f_uniq},
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01002967 {"utf16idx", 2, 4, FEARG_1, arg4_string_number_bool_bool,
Christian Brabandt67672ef2023-04-24 21:09:54 +01002968 ret_number, f_utf16idx},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002969 {"values", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar32517c42023-01-15 18:17:12 +00002970 ret_list_member, f_values},
zeertzjq825cf812023-08-17 22:55:25 +02002971 {"virtcol", 1, 3, FEARG_1, arg3_string_or_list_bool_number,
LemonBoy0f7a3e12022-05-26 12:10:37 +01002972 ret_virtcol, f_virtcol},
Bram Moolenaar5a6ec102022-05-27 21:58:00 +01002973 {"virtcol2col", 3, 3, FEARG_1, arg3_number,
2974 ret_number, f_virtcol2col},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002975 {"visualmode", 0, 1, 0, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002976 ret_string, f_visualmode},
2977 {"wildmenumode", 0, 0, 0, NULL,
2978 ret_number, f_wildmenumode},
Bram Moolenaar52312242021-07-11 18:23:19 +02002979 {"win_execute", 2, 3, FEARG_2, arg23_win_execute,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002980 ret_string, f_win_execute},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002981 {"win_findbuf", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002982 ret_list_number, f_win_findbuf},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002983 {"win_getid", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002984 ret_number, f_win_getid},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002985 {"win_gettype", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002986 ret_string, f_win_gettype},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002987 {"win_gotoid", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002988 ret_number_bool, f_win_gotoid},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002989 {"win_id2tabwin", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002990 ret_list_number, f_win_id2tabwin},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002991 {"win_id2win", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002992 ret_number, f_win_id2win},
Daniel Steinbergee630312022-01-10 13:36:34 +00002993 {"win_move_separator", 2, 2, FEARG_1, arg2_number,
2994 ret_number_bool, f_win_move_separator},
2995 {"win_move_statusline", 2, 2, FEARG_1, arg2_number,
2996 ret_number_bool, f_win_move_statusline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002997 {"win_screenpos", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002998 ret_list_number, f_win_screenpos},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002999 {"win_splitmove", 2, 3, FEARG_1, arg3_number_number_dict,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01003000 ret_number_bool, f_win_splitmove},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003001 {"winbufnr", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003002 ret_number, f_winbufnr},
3003 {"wincol", 0, 0, 0, NULL,
3004 ret_number, f_wincol},
3005 {"windowsversion", 0, 0, 0, NULL,
3006 ret_string, f_windowsversion},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003007 {"winheight", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003008 ret_number, f_winheight},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003009 {"winlayout", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003010 ret_list_any, f_winlayout},
3011 {"winline", 0, 0, 0, NULL,
3012 ret_number, f_winline},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02003013 {"winnr", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003014 ret_number, f_winnr},
3015 {"winrestcmd", 0, 0, 0, NULL,
3016 ret_string, f_winrestcmd},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02003017 {"winrestview", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003018 ret_void, f_winrestview},
3019 {"winsaveview", 0, 0, 0, NULL,
Bram Moolenaar43b69b32021-01-07 20:23:33 +01003020 ret_dict_number, f_winsaveview},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003021 {"winwidth", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003022 ret_number, f_winwidth},
3023 {"wordcount", 0, 0, 0, NULL,
3024 ret_dict_number, f_wordcount},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02003025 {"writefile", 2, 3, FEARG_1, arg23_writefile,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01003026 ret_number_bool, f_writefile},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003027 {"xor", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003028 ret_number, f_xor},
Bram Moolenaarac92e252019-08-03 21:58:38 +02003029};
3030
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003031/*
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003032 * Return true if specified function allows a type as an argument.
3033 */
3034 static int
3035func_allows_type(int idx)
3036{
3037 return (global_functions[idx].f_argtype & FE_X) != 0;
3038}
3039
3040/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003041 * Function given to ExpandGeneric() to obtain the list of internal
3042 * or user defined function names.
3043 */
3044 char_u *
3045get_function_name(expand_T *xp, int idx)
3046{
3047 static int intidx = -1;
3048 char_u *name;
3049
3050 if (idx == 0)
3051 intidx = -1;
3052 if (intidx < 0)
3053 {
3054 name = get_user_func_name(xp, idx);
naohiro ono5aec7552021-08-19 21:20:41 +02003055 if (name != NULL)
Bram Moolenaar1bb4de52021-01-13 19:48:46 +01003056 {
naohiro ono5aec7552021-08-19 21:20:41 +02003057 if (*name != NUL && *name != '<'
3058 && STRNCMP("g:", xp->xp_pattern, 2) == 0)
Bram Moolenaar1bb4de52021-01-13 19:48:46 +01003059 return cat_prefix_varname('g', name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003060 return name;
Bram Moolenaar1bb4de52021-01-13 19:48:46 +01003061 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003062 }
K.Takataeeec2542021-06-02 13:28:16 +02003063 if (++intidx < (int)ARRAY_LENGTH(global_functions))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003064 {
Kota Kato90c23532023-01-18 15:27:38 +00003065 // Skip if the function doesn't have an implementation (feature not
3066 // implemented).
3067 if (global_functions[intidx].f_func == NULL)
3068 return (char_u *)"";
Bram Moolenaarac92e252019-08-03 21:58:38 +02003069 STRCPY(IObuff, global_functions[intidx].f_name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003070 STRCAT(IObuff, "(");
Bram Moolenaarac92e252019-08-03 21:58:38 +02003071 if (global_functions[intidx].f_max_argc == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003072 STRCAT(IObuff, ")");
3073 return IObuff;
3074 }
3075
3076 return NULL;
3077}
3078
3079/*
3080 * Function given to ExpandGeneric() to obtain the list of internal or
3081 * user defined variable or function names.
3082 */
3083 char_u *
3084get_expr_name(expand_T *xp, int idx)
3085{
3086 static int intidx = -1;
3087 char_u *name;
3088
3089 if (idx == 0)
3090 intidx = -1;
3091 if (intidx < 0)
3092 {
3093 name = get_function_name(xp, idx);
3094 if (name != NULL)
3095 return name;
3096 }
3097 return get_user_var_name(xp, ++intidx);
3098}
3099
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003100/*
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003101 * Find internal function "name" in table "global_functions".
Bram Moolenaar15c47602020-03-26 22:16:48 +01003102 * Return index, or -1 if not found or "implemented" is TRUE and the function
3103 * is not implemented.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003104 */
Bram Moolenaar15c47602020-03-26 22:16:48 +01003105 static int
3106find_internal_func_opt(char_u *name, int implemented)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003107{
3108 int first = 0;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003109 int last;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003110 int cmp;
3111 int x;
3112
K.Takataeeec2542021-06-02 13:28:16 +02003113 last = (int)ARRAY_LENGTH(global_functions) - 1;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003114
3115 // Find the function name in the table. Binary search.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003116 while (first <= last)
3117 {
3118 x = first + ((unsigned)(last - first) >> 1);
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003119 cmp = STRCMP(name, global_functions[x].f_name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003120 if (cmp < 0)
3121 last = x - 1;
3122 else if (cmp > 0)
3123 first = x + 1;
Bram Moolenaar15c47602020-03-26 22:16:48 +01003124 else if (implemented && global_functions[x].f_func == NULL)
3125 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003126 else
3127 return x;
3128 }
3129 return -1;
3130}
3131
Bram Moolenaar15c47602020-03-26 22:16:48 +01003132/*
3133 * Find internal function "name" in table "global_functions".
3134 * Return index, or -1 if not found or the function is not implemented.
3135 */
3136 int
3137find_internal_func(char_u *name)
3138{
3139 return find_internal_func_opt(name, TRUE);
3140}
3141
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003142 int
Bram Moolenaarac92e252019-08-03 21:58:38 +02003143has_internal_func(char_u *name)
3144{
Bram Moolenaar15c47602020-03-26 22:16:48 +01003145 return find_internal_func_opt(name, TRUE) >= 0;
3146}
3147
3148 static int
3149has_internal_func_name(char_u *name)
3150{
3151 return find_internal_func_opt(name, FALSE) >= 0;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003152}
3153
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003154 char *
3155internal_func_name(int idx)
3156{
3157 return global_functions[idx].f_name;
3158}
3159
Bram Moolenaar94738d82020-10-21 14:25:07 +02003160/*
Dominique Pellefe8ebdb2021-05-13 14:55:55 +02003161 * Check the argument types for builtin function "idx".
Bram Moolenaar94738d82020-10-21 14:25:07 +02003162 * Uses the list of types on the type stack: "types".
3163 * Return FAIL and gives an error message when a type is wrong.
3164 */
3165 int
Bram Moolenaar351ead02021-01-16 16:07:01 +01003166internal_func_check_arg_types(
Bram Moolenaar078a4612022-01-04 15:17:03 +00003167 type2_T *types,
Bram Moolenaar351ead02021-01-16 16:07:01 +01003168 int idx,
3169 int argcount,
3170 cctx_T *cctx)
Bram Moolenaar94738d82020-10-21 14:25:07 +02003171{
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003172 // Some internal functions accept types like Class as arguments. For other
3173 // functions, check the arguments are not types.
3174 if (!(func_allows_type(idx)))
3175 {
zeertzjqd9be94c2024-07-14 10:20:20 +02003176 for (int i = 0; i < argcount; ++i)
3177 if (check_type_is_value(types[i].type_curr) == FAIL)
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003178 return FAIL;
3179 }
3180
Bram Moolenaar94738d82020-10-21 14:25:07 +02003181 argcheck_T *argchecks = global_functions[idx].f_argcheck;
Bram Moolenaar94738d82020-10-21 14:25:07 +02003182
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003183 if (argchecks == NULL)
3184 return OK;
Bram Moolenaar94738d82020-10-21 14:25:07 +02003185
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003186 argcontext_T context;
3187
3188 context.arg_count = argcount;
3189 context.arg_types = types;
3190 context.arg_cctx = cctx;
Ernie Raela8f7f922023-12-14 20:17:04 +01003191 for (int i = 0; i < argcount && argchecks[i] != NULL; ++i)
3192 {
3193 context.arg_idx = i;
3194 if (argchecks[i](types[i].type_curr, types[i].type_decl,
3195 &context) == FAIL)
3196 return FAIL;
3197 }
Bram Moolenaar94738d82020-10-21 14:25:07 +02003198 return OK;
3199}
3200
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003201/*
Bram Moolenaar7a40ff02021-07-04 15:54:08 +02003202 * Get the argument count for function "idx".
3203 * "argcount" is the total argument count, "min_argcount" the non-optional
3204 * argument count.
3205 */
3206 void
3207internal_func_get_argcount(int idx, int *argcount, int *min_argcount)
3208{
3209 *argcount = global_functions[idx].f_max_argc;
3210 *min_argcount = global_functions[idx].f_min_argc;
3211}
3212
3213/*
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003214 * Call the "f_retfunc" function to obtain the return type of function "idx".
Bram Moolenaar81330182022-02-01 12:11:58 +00003215 * "decl_type" is set to the declared type.
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003216 * "argtypes" is the list of argument types or NULL when there are no
3217 * arguments.
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02003218 * "argcount" may be less than the actual count when only getting the type.
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003219 */
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003220 type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00003221internal_func_ret_type(
3222 int idx,
3223 int argcount,
3224 type2_T *argtypes,
Bram Moolenaar32517c42023-01-15 18:17:12 +00003225 type_T **decl_type,
3226 garray_T *type_gap)
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003227{
Bram Moolenaar81330182022-02-01 12:11:58 +00003228 type_T *ret;
3229
Bram Moolenaar32517c42023-01-15 18:17:12 +00003230 current_type_gap = type_gap;
Bram Moolenaar81330182022-02-01 12:11:58 +00003231 *decl_type = NULL;
3232 ret = global_functions[idx].f_retfunc(argcount, argtypes, decl_type);
3233 if (*decl_type == NULL)
3234 *decl_type = ret;
Bram Moolenaar32517c42023-01-15 18:17:12 +00003235 current_type_gap = NULL;
Bram Moolenaar81330182022-02-01 12:11:58 +00003236 return ret;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003237}
3238
3239/*
Bram Moolenaar75ab91f2021-01-10 22:42:50 +01003240 * Return TRUE if "idx" is for the map() function.
3241 */
3242 int
3243internal_func_is_map(int idx)
3244{
3245 return global_functions[idx].f_func == f_map;
3246}
3247
3248/*
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003249 * Check the argument count to use for internal function "idx".
Bram Moolenaar389df252020-07-09 21:20:47 +02003250 * Returns -1 for failure, 0 if no method base accepted, 1 if method base is
3251 * first argument, 2 if method base is second argument, etc. 9 if method base
3252 * is last argument.
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003253 */
3254 int
3255check_internal_func(int idx, int argcount)
3256{
Bram Moolenaar0917e862023-02-18 14:42:44 +00003257 funcerror_T res;
3258 char *name;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003259
3260 if (argcount < global_functions[idx].f_min_argc)
3261 res = FCERR_TOOFEW;
3262 else if (argcount > global_functions[idx].f_max_argc)
3263 res = FCERR_TOOMANY;
3264 else
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003265 return global_functions[idx].f_argtype & FEARG_MASK;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003266
3267 name = internal_func_name(idx);
3268 if (res == FCERR_TOOMANY)
Bram Moolenaare1242042021-12-16 20:56:57 +00003269 semsg(_(e_too_many_arguments_for_function_str), name);
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003270 else
Bram Moolenaare1242042021-12-16 20:56:57 +00003271 semsg(_(e_not_enough_arguments_for_function_str), name);
Bram Moolenaar389df252020-07-09 21:20:47 +02003272 return -1;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003273}
3274
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003275/*
3276 * Some internal functions accept types like Class as arguments. For other
3277 * functions, check the arguments are not types.
3278 *
3279 * Return OK/FAIL.
3280 */
3281 static int
3282check_args_for_type(int idx, int argcount, typval_T *argvars)
3283{
3284 if (!func_allows_type(idx))
3285 {
3286 for (int i = 0; i < argcount; ++i)
3287 if (check_typval_is_value(&argvars[i]) == FAIL)
3288 return FAIL;
3289 }
3290 return OK;
3291}
3292
Bram Moolenaar0917e862023-02-18 14:42:44 +00003293 funcerror_T
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003294call_internal_func(
3295 char_u *name,
3296 int argcount,
3297 typval_T *argvars,
3298 typval_T *rettv)
3299{
3300 int i;
3301
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003302 i = find_internal_func(name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003303 if (i < 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01003304 return FCERR_UNKNOWN;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003305 if (argcount < global_functions[i].f_min_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003306 return FCERR_TOOFEW;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003307 if (argcount > global_functions[i].f_max_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003308 return FCERR_TOOMANY;
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003309 if (check_args_for_type(i, argcount, argvars) == FAIL)
3310 return FCERR_OTHER;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003311 argvars[argcount].v_type = VAR_UNKNOWN;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003312 global_functions[i].f_func(argvars, rettv);
Bram Moolenaaref140542019-12-31 21:27:13 +01003313 return FCERR_NONE;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003314}
3315
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003316 void
3317call_internal_func_by_idx(
3318 int idx,
3319 typval_T *argvars,
3320 typval_T *rettv)
3321{
3322 global_functions[idx].f_func(argvars, rettv);
3323}
3324
Bram Moolenaarac92e252019-08-03 21:58:38 +02003325/*
3326 * Invoke a method for base->method().
3327 */
Bram Moolenaar0917e862023-02-18 14:42:44 +00003328 funcerror_T
Bram Moolenaarac92e252019-08-03 21:58:38 +02003329call_internal_method(
3330 char_u *name,
3331 int argcount,
3332 typval_T *argvars,
3333 typval_T *rettv,
3334 typval_T *basetv)
3335{
Bram Moolenaarac92e252019-08-03 21:58:38 +02003336 int fi;
3337 typval_T argv[MAX_FUNC_ARGS + 1];
3338
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003339 fi = find_internal_func(name);
Bram Moolenaar91746392019-08-16 22:22:31 +02003340 if (fi < 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01003341 return FCERR_UNKNOWN;
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003342 if ((global_functions[fi].f_argtype & FEARG_MASK) == 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01003343 return FCERR_NOTMETHOD;
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003344 if (argcount + 1 < global_functions[fi].f_min_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003345 return FCERR_TOOFEW;
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003346 if (argcount + 1 > global_functions[fi].f_max_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003347 return FCERR_TOOMANY;
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003348 if (check_args_for_type(fi, argcount, argvars) == FAIL)
3349 return FCERR_OTHER;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003350
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003351 if ((global_functions[fi].f_argtype & FEARG_MASK) == FEARG_2)
Bram Moolenaar25e42232019-08-04 15:04:10 +02003352 {
Bram Moolenaarb7f22702023-04-27 16:24:07 +01003353 if (argcount < 1)
3354 return FCERR_TOOFEW;
3355
Bram Moolenaar25e42232019-08-04 15:04:10 +02003356 // base value goes second
3357 argv[0] = argvars[0];
3358 argv[1] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003359 for (int i = 1; i < argcount; ++i)
Bram Moolenaar25e42232019-08-04 15:04:10 +02003360 argv[i + 1] = argvars[i];
3361 }
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003362 else if ((global_functions[fi].f_argtype & FEARG_MASK) == FEARG_3)
Bram Moolenaar24278d22019-08-16 21:49:22 +02003363 {
Bram Moolenaarb7f22702023-04-27 16:24:07 +01003364 if (argcount < 2)
3365 return FCERR_TOOFEW;
3366
Bram Moolenaar24278d22019-08-16 21:49:22 +02003367 // base value goes third
3368 argv[0] = argvars[0];
3369 argv[1] = argvars[1];
3370 argv[2] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003371 for (int i = 2; i < argcount; ++i)
Bram Moolenaar24278d22019-08-16 21:49:22 +02003372 argv[i + 1] = argvars[i];
3373 }
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003374 else if ((global_functions[fi].f_argtype & FEARG_MASK) == FEARG_4)
Bram Moolenaaraad222c2019-09-06 22:46:09 +02003375 {
Bram Moolenaarb7f22702023-04-27 16:24:07 +01003376 if (argcount < 3)
3377 return FCERR_TOOFEW;
3378
Bram Moolenaaraad222c2019-09-06 22:46:09 +02003379 // base value goes fourth
3380 argv[0] = argvars[0];
3381 argv[1] = argvars[1];
3382 argv[2] = argvars[2];
3383 argv[3] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003384 for (int i = 3; i < argcount; ++i)
Bram Moolenaaraad222c2019-09-06 22:46:09 +02003385 argv[i + 1] = argvars[i];
3386 }
Bram Moolenaar25e42232019-08-04 15:04:10 +02003387 else
3388 {
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003389 // FEARG_1: base value goes first
Bram Moolenaar25e42232019-08-04 15:04:10 +02003390 argv[0] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003391 for (int i = 0; i < argcount; ++i)
Bram Moolenaar25e42232019-08-04 15:04:10 +02003392 argv[i + 1] = argvars[i];
3393 }
Bram Moolenaarac92e252019-08-03 21:58:38 +02003394 argv[argcount + 1].v_type = VAR_UNKNOWN;
3395
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003396 if (check_args_for_type(fi, argcount + 1, argv) == FAIL)
3397 return FCERR_OTHER;
3398
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003399 global_functions[fi].f_func(argv, rettv);
Bram Moolenaaref140542019-12-31 21:27:13 +01003400 return FCERR_NONE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003401}
3402
3403/*
3404 * Return TRUE for a non-zero Number and a non-empty String.
3405 */
Bram Moolenaar0e57dd82019-09-16 22:56:03 +02003406 int
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003407non_zero_arg(typval_T *argvars)
3408{
3409 return ((argvars[0].v_type == VAR_NUMBER
3410 && argvars[0].vval.v_number != 0)
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01003411 || (argvars[0].v_type == VAR_BOOL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003412 && argvars[0].vval.v_number == VVAL_TRUE)
3413 || (argvars[0].v_type == VAR_STRING
3414 && argvars[0].vval.v_string != NULL
3415 && *argvars[0].vval.v_string != NUL));
3416}
3417
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003418/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003419 * "and(expr, expr)" function
3420 */
3421 static void
3422f_and(typval_T *argvars, typval_T *rettv)
3423{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003424 if (in_vim9script()
3425 && (check_for_number_arg(argvars, 0) == FAIL
3426 || check_for_number_arg(argvars, 1) == FAIL))
3427 return;
3428
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003429 rettv->vval.v_number = tv_get_number_chk(&argvars[0], NULL)
3430 & tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaarca851592018-06-06 21:04:07 +02003431}
3432
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003433/*
Bram Moolenaar59716a22017-03-01 20:32:44 +01003434 * "balloon_show()" function
3435 */
3436#ifdef FEAT_BEVAL
3437 static void
Bram Moolenaarbe0a2592019-05-09 13:50:16 +02003438f_balloon_gettext(typval_T *argvars UNUSED, typval_T *rettv)
3439{
3440 rettv->v_type = VAR_STRING;
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003441 if (balloonEval == NULL)
3442 return;
3443
3444 if (balloonEval->msg == NULL)
3445 rettv->vval.v_string = NULL;
3446 else
3447 rettv->vval.v_string = vim_strsave(balloonEval->msg);
Bram Moolenaarbe0a2592019-05-09 13:50:16 +02003448}
3449
3450 static void
Bram Moolenaar59716a22017-03-01 20:32:44 +01003451f_balloon_show(typval_T *argvars, typval_T *rettv UNUSED)
3452{
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003453 if (balloonEval == NULL)
3454 return;
3455
3456 if (in_vim9script()
3457 && check_for_string_or_list_arg(argvars, 0) == FAIL)
3458 return;
3459
3460 if (argvars[0].v_type == VAR_LIST
3461# ifdef FEAT_GUI
3462 && !gui.in_use
3463# endif
3464 )
Bram Moolenaar246fe032017-11-19 19:56:27 +01003465 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003466 list_T *l = argvars[0].vval.v_list;
3467
3468 // empty list removes the balloon
3469 post_balloon(balloonEval, NULL,
3470 l == NULL || l->lv_len == 0 ? NULL : l);
3471 }
3472 else
3473 {
3474 char_u *mesg;
3475
3476 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003477 return;
3478
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003479 mesg = tv_get_string_chk(&argvars[0]);
3480 if (mesg != NULL)
3481 // empty string removes the balloon
3482 post_balloon(balloonEval, *mesg == NUL ? NULL : mesg, NULL);
Bram Moolenaar246fe032017-11-19 19:56:27 +01003483 }
3484}
3485
Bram Moolenaar669a8282017-11-19 20:13:05 +01003486# if defined(FEAT_BEVAL_TERM)
Bram Moolenaar246fe032017-11-19 19:56:27 +01003487 static void
3488f_balloon_split(typval_T *argvars, typval_T *rettv UNUSED)
3489{
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003490 if (rettv_list_alloc(rettv) != OK)
3491 return;
3492
3493 char_u *msg;
3494
3495 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
3496 return;
3497 msg = tv_get_string_chk(&argvars[0]);
3498 if (msg != NULL)
Bram Moolenaar246fe032017-11-19 19:56:27 +01003499 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003500 pumitem_T *array;
3501 int size = split_message(msg, &array);
Bram Moolenaar246fe032017-11-19 19:56:27 +01003502
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003503 // Skip the first and last item, they are always empty.
3504 for (int i = 1; i < size - 1; ++i)
3505 list_append_string(rettv->vval.v_list, array[i].pum_text, -1);
3506 while (size > 0)
3507 vim_free(array[--size].pum_text);
3508 vim_free(array);
Bram Moolenaar246fe032017-11-19 19:56:27 +01003509 }
Bram Moolenaar59716a22017-03-01 20:32:44 +01003510}
Bram Moolenaar669a8282017-11-19 20:13:05 +01003511# endif
Bram Moolenaar59716a22017-03-01 20:32:44 +01003512#endif
3513
Yegappan Lakshmanan810785c2024-12-30 10:29:44 +01003514// Base64 character set
3515static const char_u base64_table[] = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
3516
3517// Base64 decoding table (initialized in init_base64_dec_table() below)
3518static char_u base64_dec_table[256];
3519
3520/*
3521 * Initialize the base64 decoding table
3522 */
3523 static void
3524init_base64_dec_table(void)
3525{
3526 static int base64_dec_tbl_initialized = FALSE;
3527
3528 if (base64_dec_tbl_initialized)
3529 return;
3530
3531 // Unsupported characters are set to 0xFF
3532 vim_memset(base64_dec_table, 0xFF, sizeof(base64_dec_table));
3533
3534 // Initialize the index for the base64 alphabets
3535 for (size_t i = 0; i < sizeof(base64_table) - 1; i++)
3536 base64_dec_table[(char_u)base64_table[i]] = (char_u)i;
3537
3538 // base64 padding character
3539 base64_dec_table['='] = 0;
3540
3541 base64_dec_tbl_initialized = TRUE;
3542}
3543
3544/*
3545 * Encode the bytes in "blob" using base-64 encoding.
3546 */
3547 static char_u *
3548base64_encode(blob_T *blob)
3549{
3550 size_t input_len = blob->bv_ga.ga_len;
3551 size_t encoded_len = ((input_len + 2) / 3) * 4;
3552 char_u *data = blob->bv_ga.ga_data;
3553
3554 char_u *encoded = alloc(encoded_len + 1);
3555 if (encoded == NULL)
3556 return NULL;
3557
3558 size_t i, j;
3559 for (i = 0, j = 0; i < input_len;)
3560 {
3561 int_u octet_a = i < input_len ? data[i++] : 0;
3562 int_u octet_b = i < input_len ? data[i++] : 0;
3563 int_u octet_c = i < input_len ? data[i++] : 0;
3564
3565 int_u triple = (octet_a << 16) | (octet_b << 8) | octet_c;
3566
3567 encoded[j++] = base64_table[(triple >> 18) & 0x3F];
3568 encoded[j++] = base64_table[(triple >> 12) & 0x3F];
3569 encoded[j++] = (!octet_b && i >= input_len) ? '='
3570 : base64_table[(triple >> 6) & 0x3F];
3571 encoded[j++] = (!octet_c && i >= input_len) ? '='
3572 : base64_table[triple & 0x3F];
3573 }
3574 encoded[j] = NUL;
3575
3576 return encoded;
3577}
3578
3579/*
3580 * Decode the string "data" using base-64 encoding.
3581 */
3582 static void
3583base64_decode(const char_u *data, blob_T *blob)
3584{
3585 size_t input_len = STRLEN(data);
3586
3587 if (input_len == 0)
3588 return;
3589
3590 if (input_len % 4 != 0)
3591 {
3592 // Invalid input length
3593 semsg(_(e_invalid_argument_str), data);
3594 return;
3595 }
3596
3597 init_base64_dec_table();
3598
3599 size_t decoded_len = (input_len / 4) * 3;
3600 if (data[input_len - 1] == '=')
3601 decoded_len--;
3602 if (data[input_len - 2] == '=')
3603 decoded_len--;
3604
3605 size_t i, j;
3606 for (i = 0, j = 0; i < input_len;)
3607 {
3608 int_u sextet_a = base64_dec_table[(char_u)data[i++]];
3609 int_u sextet_b = base64_dec_table[(char_u)data[i++]];
3610 int_u sextet_c = base64_dec_table[(char_u)data[i++]];
3611 int_u sextet_d = base64_dec_table[(char_u)data[i++]];
3612
3613 if (sextet_a == 0xFF || sextet_b == 0xFF || sextet_c == 0xFF
3614 || sextet_d == 0xFF)
3615 {
3616 // Invalid character
3617 semsg(_(e_invalid_argument_str), data);
3618 ga_clear(&blob->bv_ga);
3619 return;
3620 }
3621
3622 int_u triple = (sextet_a << 18) | (sextet_b << 12)
3623 | (sextet_c << 6) | sextet_d;
3624
3625 if (j < decoded_len)
3626 {
3627 ga_append(&blob->bv_ga, (triple >> 16) & 0xFF);
3628 j++;
3629 }
3630 if (j < decoded_len)
3631 {
3632 ga_append(&blob->bv_ga, (triple >> 8) & 0xFF);
3633 j++;
3634 }
3635 if (j < decoded_len)
3636 {
3637 ga_append(&blob->bv_ga, triple & 0xFF);
3638 j++;
3639 }
3640
3641 if (j == decoded_len)
3642 {
3643 // Check for invalid padding bytes (based on the
3644 // "Base64 Malleability in Practice" ACM paper).
3645 if ((data[input_len - 2] == '=' && ((sextet_b & 0xF) != 0))
3646 || ((data[input_len - 1] == '=') && ((sextet_c & 0x3) != 0)))
3647 {
3648 semsg(_(e_invalid_argument_str), data);
3649 ga_clear(&blob->bv_ga);
3650 return;
3651 }
3652 }
3653 }
3654}
3655
3656/*
3657 * "base64_decode(string)" function
3658 */
3659 static void
3660f_base64_decode(typval_T *argvars, typval_T *rettv)
3661{
3662 if (check_for_string_arg(argvars, 0) == FAIL)
3663 return;
3664
3665 if (rettv_blob_alloc(rettv) == FAIL)
3666 return;
3667
3668 char_u *str = tv_get_string_chk(&argvars[0]);
3669 if (str != NULL)
3670 base64_decode(str, rettv->vval.v_blob);
3671}
3672
3673/*
3674 * "base64_encode(blob)" function
3675 */
3676 static void
3677f_base64_encode(typval_T *argvars, typval_T *rettv)
3678{
3679 if (check_for_blob_arg(argvars, 0) == FAIL)
3680 return;
3681
3682 rettv->v_type = VAR_STRING;
3683 rettv->vval.v_string = NULL;
3684
3685 blob_T *blob = argvars->vval.v_blob;
3686 if (blob != NULL)
3687 rettv->vval.v_string = base64_encode(blob);
3688}
3689
Bram Moolenaar59716a22017-03-01 20:32:44 +01003690/*
Bram Moolenaar6b7b7192019-01-11 13:42:41 +01003691 * Get the buffer from "arg" and give an error and return NULL if it is not
3692 * valid.
3693 */
Bram Moolenaara3347722019-05-11 21:14:24 +02003694 buf_T *
Bram Moolenaar6b7b7192019-01-11 13:42:41 +01003695get_buf_arg(typval_T *arg)
3696{
3697 buf_T *buf;
3698
3699 ++emsg_off;
3700 buf = tv_get_buf(arg, FALSE);
3701 --emsg_off;
3702 if (buf == NULL)
Bram Moolenaard82a47d2022-01-05 20:24:39 +00003703 semsg(_(e_invalid_buffer_name_str), tv_get_string(arg));
Bram Moolenaar6b7b7192019-01-11 13:42:41 +01003704 return buf;
3705}
3706
3707/*
Christ van Willegence0ef912024-06-20 23:41:59 +02003708 * "bindtextdomain(package, path)" function
3709 */
3710 static void
Christ van Willegen8252ef12024-07-11 21:36:21 +02003711f_bindtextdomain(typval_T *argvars, typval_T *rettv)
Christ van Willegence0ef912024-06-20 23:41:59 +02003712{
Christ van Willegen8252ef12024-07-11 21:36:21 +02003713 rettv->v_type = VAR_BOOL;
3714 rettv->vval.v_number = VVAL_TRUE;
3715
Christ van Willegence0ef912024-06-20 23:41:59 +02003716 if (check_for_nonempty_string_arg(argvars, 0) == FAIL
3717 || check_for_nonempty_string_arg(argvars, 1) == FAIL)
3718 return;
3719
3720 if (strcmp((const char *)argvars[0].vval.v_string, VIMPACKAGE) == 0)
3721 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[0]));
3722 else
Christ van Willegen8252ef12024-07-11 21:36:21 +02003723 {
3724 if (bindtextdomain((const char *)argvars[0].vval.v_string, (const char *)argvars[1].vval.v_string) == NULL)
3725 {
3726 do_outofmem_msg((long)0);
3727 rettv->vval.v_number = VVAL_FALSE;
3728 }
3729 }
Christ van Willegence0ef912024-06-20 23:41:59 +02003730
3731 return;
3732}
3733
3734/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003735 * "byte2line(byte)" function
3736 */
3737 static void
3738f_byte2line(typval_T *argvars UNUSED, typval_T *rettv)
3739{
3740#ifndef FEAT_BYTEOFF
3741 rettv->vval.v_number = -1;
3742#else
3743 long boff = 0;
3744
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003745 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
3746 return;
3747
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01003748 boff = tv_get_number(&argvars[0]) - 1; // boff gets -1 on type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003749 if (boff < 0)
3750 rettv->vval.v_number = -1;
3751 else
3752 rettv->vval.v_number = ml_find_line_or_offset(curbuf,
3753 (linenr_T)0, &boff);
3754#endif
3755}
3756
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003757/*
3758 * "call(func, arglist [, dict])" function
3759 */
3760 static void
3761f_call(typval_T *argvars, typval_T *rettv)
3762{
3763 char_u *func;
3764 partial_T *partial = NULL;
3765 dict_T *selfdict = NULL;
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003766 char_u *tofree = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003767
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02003768 if (in_vim9script()
Bram Moolenaar223d0a62021-12-25 19:29:21 +00003769 && (check_for_string_or_func_arg(argvars, 0) == FAIL
3770 || check_for_list_arg(argvars, 1) == FAIL
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02003771 || check_for_opt_dict_arg(argvars, 2) == FAIL))
3772 return;
3773
Bram Moolenaard83392a2022-09-01 12:22:46 +01003774 if (check_for_list_arg(argvars, 1) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003775 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003776 if (argvars[1].vval.v_list == NULL)
3777 return;
3778
3779 if (argvars[0].v_type == VAR_FUNC)
3780 func = argvars[0].vval.v_string;
3781 else if (argvars[0].v_type == VAR_PARTIAL)
3782 {
3783 partial = argvars[0].vval.v_partial;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02003784 func = partial_name(partial);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003785 }
3786 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003787 func = tv_get_string(&argvars[0]);
Dominique Pellefe8ebdb2021-05-13 14:55:55 +02003788 if (func == NULL || *func == NUL)
3789 return; // type error, empty name or null function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003790
Yegappan Lakshmanan9904cbc2025-01-15 18:25:19 +01003791 if (argvars[0].v_type == VAR_STRING)
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003792 {
Yegappan Lakshmanan9904cbc2025-01-15 18:25:19 +01003793 char_u *p = func;
3794 tofree = trans_function_name(&p, NULL, FALSE, TFN_INT|TFN_QUIET);
3795 if (tofree == NULL)
3796 {
3797 emsg_funcname(e_unknown_function_str, func);
3798 return;
3799 }
3800 func = tofree;
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003801 }
3802
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003803 if (argvars[2].v_type != VAR_UNKNOWN)
3804 {
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +01003805 if (check_for_dict_arg(argvars, 2) == FAIL)
Yegappan Lakshmanan6289f912025-01-14 17:13:36 +01003806 goto done;
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +01003807
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003808 selfdict = argvars[2].vval.v_dict;
3809 }
3810
3811 (void)func_call(func, &argvars[1], partial, selfdict, rettv);
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003812
Yegappan Lakshmanan6289f912025-01-14 17:13:36 +01003813done:
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003814 vim_free(tofree);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003815}
3816
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003817/*
3818 * "changenr()" function
3819 */
3820 static void
3821f_changenr(typval_T *argvars UNUSED, typval_T *rettv)
3822{
3823 rettv->vval.v_number = curbuf->b_u_seq_cur;
3824}
3825
3826/*
3827 * "char2nr(string)" function
3828 */
3829 static void
3830f_char2nr(typval_T *argvars, typval_T *rettv)
3831{
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02003832 if (in_vim9script()
3833 && (check_for_string_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02003834 || check_for_opt_bool_arg(argvars, 1) == FAIL))
Bram Moolenaarc5809432021-03-27 21:23:30 +01003835 return;
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02003836
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003837 if (has_mbyte)
3838 {
3839 int utf8 = 0;
3840
3841 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaar24f77502020-09-04 19:50:57 +02003842 utf8 = (int)tv_get_bool_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003843
3844 if (utf8)
Bram Moolenaarbdace832019-03-02 10:13:42 +01003845 rettv->vval.v_number = utf_ptr2char(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003846 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003847 rettv->vval.v_number = (*mb_ptr2char)(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003848 }
3849 else
Bram Moolenaar13505972019-01-24 15:04:48 +01003850 rettv->vval.v_number = tv_get_string(&argvars[0])[0];
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003851}
3852
Bram Moolenaar17793ef2020-12-28 12:56:58 +01003853/*
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003854 * Get the current cursor column and store it in 'rettv'. If 'charcol' is TRUE,
3855 * returns the character index of the column. Otherwise, returns the byte index
3856 * of the column.
3857 */
3858 static void
3859get_col(typval_T *argvars, typval_T *rettv, int charcol)
3860{
3861 colnr_T col = 0;
3862 pos_T *fp;
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00003863 switchwin_T switchwin;
3864 int winchanged = FALSE;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003865
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00003866 if (check_for_string_or_list_arg(argvars, 0) == FAIL
3867 || check_for_opt_number_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003868 return;
3869
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00003870 if (argvars[1].v_type != VAR_UNKNOWN)
3871 {
3872 tabpage_T *tp;
3873 win_T *wp;
3874
3875 // use the window specified in the second argument
3876 wp = win_id2wp_tp((int)tv_get_number(&argvars[1]), &tp);
3877 if (wp == NULL || tp == NULL)
3878 return;
3879
3880 if (switch_win_noblock(&switchwin, wp, tp, TRUE) != OK)
3881 return;
3882
3883 check_cursor();
3884 winchanged = TRUE;
3885 }
3886
3887 int fnum = curbuf->b_fnum;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003888 fp = var2fpos(&argvars[0], FALSE, &fnum, charcol);
3889 if (fp != NULL && fnum == curbuf->b_fnum)
3890 {
3891 if (fp->col == MAXCOL)
3892 {
3893 // '> can be MAXCOL, get the length of the line then
3894 if (fp->lnum <= curbuf->b_ml.ml_line_count)
John Marriottbfcc8952024-03-11 22:04:45 +01003895 col = ml_get_len(fp->lnum) + 1;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003896 else
3897 col = MAXCOL;
3898 }
3899 else
3900 {
3901 col = fp->col + 1;
3902 // col(".") when the cursor is on the NUL at the end of the line
3903 // because of "coladd" can be seen as an extra column.
3904 if (virtual_active() && fp == &curwin->w_cursor)
3905 {
3906 char_u *p = ml_get_cursor();
3907
3908 if (curwin->w_cursor.coladd >= (colnr_T)chartabsize(p,
3909 curwin->w_virtcol - curwin->w_cursor.coladd))
3910 {
3911 int l;
3912
3913 if (*p != NUL && p[(l = (*mb_ptr2len)(p))] == NUL)
3914 col += l;
3915 }
3916 }
3917 }
3918 }
3919 rettv->vval.v_number = col;
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00003920
3921 if (winchanged)
3922 restore_win_noblock(&switchwin, TRUE);
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003923}
3924
3925/*
3926 * "charcol()" function
3927 */
3928 static void
3929f_charcol(typval_T *argvars, typval_T *rettv)
3930{
3931 get_col(argvars, rettv, TRUE);
3932}
3933
Bram Moolenaar29b7d7a2019-07-22 23:03:57 +02003934 win_T *
Bram Moolenaaraff74912019-03-30 18:11:49 +01003935get_optional_window(typval_T *argvars, int idx)
3936{
3937 win_T *win = curwin;
3938
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003939 if (argvars[idx].v_type == VAR_UNKNOWN)
3940 return curwin;
3941
3942 win = find_win_by_nr_or_id(&argvars[idx]);
3943 if (win == NULL)
Bram Moolenaaraff74912019-03-30 18:11:49 +01003944 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003945 emsg(_(e_invalid_window_number));
3946 return NULL;
Bram Moolenaaraff74912019-03-30 18:11:49 +01003947 }
3948 return win;
3949}
3950
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003951/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003952 * "col(string)" function
3953 */
3954 static void
3955f_col(typval_T *argvars, typval_T *rettv)
3956{
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003957 get_col(argvars, rettv, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003958}
3959
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003960/*
3961 * "confirm(message, buttons[, default [, type]])" function
3962 */
3963 static void
3964f_confirm(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
3965{
3966#if defined(FEAT_GUI_DIALOG) || defined(FEAT_CON_DIALOG)
3967 char_u *message;
3968 char_u *buttons = NULL;
3969 char_u buf[NUMBUFLEN];
3970 char_u buf2[NUMBUFLEN];
3971 int def = 1;
3972 int type = VIM_GENERIC;
3973 char_u *typestr;
3974 int error = FALSE;
3975
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02003976 if (in_vim9script()
3977 && (check_for_string_arg(argvars, 0) == FAIL
3978 || (check_for_opt_string_arg(argvars, 1) == FAIL
3979 || (argvars[1].v_type != VAR_UNKNOWN
3980 && (check_for_opt_number_arg(argvars, 2) == FAIL
3981 || (argvars[2].v_type != VAR_UNKNOWN
3982 && check_for_opt_string_arg(argvars, 3) == FAIL))))))
Bram Moolenaarc5809432021-03-27 21:23:30 +01003983 return;
3984
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003985 message = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003986 if (message == NULL)
3987 error = TRUE;
3988 if (argvars[1].v_type != VAR_UNKNOWN)
3989 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003990 buttons = tv_get_string_buf_chk(&argvars[1], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003991 if (buttons == NULL)
3992 error = TRUE;
3993 if (argvars[2].v_type != VAR_UNKNOWN)
3994 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003995 def = (int)tv_get_number_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003996 if (argvars[3].v_type != VAR_UNKNOWN)
3997 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003998 typestr = tv_get_string_buf_chk(&argvars[3], buf2);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003999 if (typestr == NULL)
4000 error = TRUE;
4001 else
4002 {
4003 switch (TOUPPER_ASC(*typestr))
4004 {
4005 case 'E': type = VIM_ERROR; break;
4006 case 'Q': type = VIM_QUESTION; break;
4007 case 'I': type = VIM_INFO; break;
4008 case 'W': type = VIM_WARNING; break;
4009 case 'G': type = VIM_GENERIC; break;
4010 }
4011 }
4012 }
4013 }
4014 }
4015
4016 if (buttons == NULL || *buttons == NUL)
4017 buttons = (char_u *)_("&Ok");
4018
4019 if (!error)
4020 rettv->vval.v_number = do_dialog(type, NULL, message, buttons,
4021 def, NULL, FALSE);
4022#endif
4023}
4024
4025/*
4026 * "copy()" function
4027 */
4028 static void
4029f_copy(typval_T *argvars, typval_T *rettv)
4030{
Bram Moolenaar381692b2022-02-02 20:01:27 +00004031 item_copy(&argvars[0], rettv, FALSE, TRUE, 0);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004032}
4033
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004034/*
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004035 * Set the cursor position.
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01004036 * If "charcol" is TRUE, then use the column number as a character offset.
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004037 * Otherwise use the column number as a byte offset.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004038 */
4039 static void
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004040set_cursorpos(typval_T *argvars, typval_T *rettv, int charcol)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004041{
Bram Moolenaar79f23442022-10-10 12:42:57 +01004042 long lnum, col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004043 long coladd = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004044 int set_curswant = TRUE;
4045
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004046 if (in_vim9script()
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004047 && (check_for_string_or_number_or_list_arg(argvars, 0) == FAIL
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02004048 || check_for_opt_number_arg(argvars, 1) == FAIL
4049 || (argvars[1].v_type != VAR_UNKNOWN
4050 && check_for_opt_number_arg(argvars, 2) == FAIL)))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004051 return;
4052
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004053 rettv->vval.v_number = -1;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004054 if (argvars[0].v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004055 {
4056 pos_T pos;
4057 colnr_T curswant = -1;
4058
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004059 if (list2fpos(argvars, &pos, NULL, &curswant, charcol) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004060 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00004061 emsg(_(e_invalid_argument));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004062 return;
4063 }
Bram Moolenaar79f23442022-10-10 12:42:57 +01004064 lnum = pos.lnum;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004065 col = pos.col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004066 coladd = pos.coladd;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004067 if (curswant >= 0)
4068 {
4069 curwin->w_curswant = curswant - 1;
4070 set_curswant = FALSE;
4071 }
4072 }
Bram Moolenaar79f23442022-10-10 12:42:57 +01004073 else if ((argvars[0].v_type == VAR_NUMBER
4074 || argvars[0].v_type == VAR_STRING)
4075 && (argvars[1].v_type == VAR_NUMBER
4076 || argvars[1].v_type == VAR_STRING))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004077 {
Bram Moolenaar79f23442022-10-10 12:42:57 +01004078 lnum = tv_get_lnum(argvars);
4079 if (lnum < 0)
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00004080 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[0]));
Bram Moolenaar79f23442022-10-10 12:42:57 +01004081 else if (lnum == 0)
4082 lnum = curwin->w_cursor.lnum;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004083 col = (long)tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004084 if (charcol)
Bram Moolenaar79f23442022-10-10 12:42:57 +01004085 col = buf_charidx_to_byteidx(curbuf, lnum, col) + 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004086 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004087 coladd = (long)tv_get_number_chk(&argvars[2], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004088 }
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004089 else
4090 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00004091 emsg(_(e_invalid_argument));
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004092 return;
4093 }
Bram Moolenaar79f23442022-10-10 12:42:57 +01004094 if (lnum < 0 || col < 0 || coladd < 0)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004095 return; // type error; errmsg already given
Bram Moolenaar79f23442022-10-10 12:42:57 +01004096 if (lnum > 0)
4097 curwin->w_cursor.lnum = lnum;
zeertzjq2ffdae72024-05-02 13:06:24 +02004098 if (col != MAXCOL && --col < 0)
4099 col = 0;
4100 curwin->w_cursor.col = col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004101 curwin->w_cursor.coladd = coladd;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004102
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004103 // Make sure the cursor is in a valid position.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004104 check_cursor();
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004105 // Correct cursor for multi-byte character.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004106 if (has_mbyte)
4107 mb_adjust_cursor();
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004108
4109 curwin->w_set_curswant = set_curswant;
4110 rettv->vval.v_number = 0;
4111}
4112
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004113/*
4114 * "cursor(lnum, col)" function, or
4115 * "cursor(list)"
4116 *
4117 * Moves the cursor to the specified line and column.
4118 * Returns 0 when the position could be set, -1 otherwise.
4119 */
4120 static void
4121f_cursor(typval_T *argvars, typval_T *rettv)
4122{
4123 set_cursorpos(argvars, rettv, FALSE);
4124}
4125
Bram Moolenaar4f974752019-02-17 17:44:42 +01004126#ifdef MSWIN
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004127/*
4128 * "debugbreak()" function
4129 */
4130 static void
4131f_debugbreak(typval_T *argvars, typval_T *rettv)
4132{
4133 int pid;
4134
4135 rettv->vval.v_number = FAIL;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004136 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
4137 return;
4138
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004139 pid = (int)tv_get_number(&argvars[0]);
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004140 if (pid == 0)
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004141 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00004142 emsg(_(e_invalid_argument));
4143 return;
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004144 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00004145
4146 HANDLE hProcess = OpenProcess(PROCESS_ALL_ACCESS, 0, pid);
4147 if (hProcess == NULL)
4148 return;
4149
4150 DebugBreakProcess(hProcess);
4151 CloseHandle(hProcess);
4152 rettv->vval.v_number = OK;
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004153}
4154#endif
4155
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004156/*
4157 * "deepcopy()" function
4158 */
4159 static void
4160f_deepcopy(typval_T *argvars, typval_T *rettv)
4161{
Bram Moolenaar239f8d92021-01-17 13:21:20 +01004162 varnumber_T noref = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004163
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +01004164 if (check_for_opt_bool_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004165 return;
4166
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004167 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaar239f8d92021-01-17 13:21:20 +01004168 noref = tv_get_bool_chk(&argvars[1], NULL);
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +01004169
4170 item_copy(&argvars[0], rettv, TRUE, TRUE, noref == 0 ? get_copyID() : 0);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004171}
4172
4173/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004174 * "did_filetype()" function
4175 */
4176 static void
4177f_did_filetype(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
4178{
zeertzjq5bf6c212024-03-31 18:41:27 +02004179 rettv->vval.v_number = curbuf->b_did_filetype;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004180}
4181
4182/*
Bram Moolenaar4132eb52020-02-14 16:53:00 +01004183 * "echoraw({expr})" function
4184 */
4185 static void
4186f_echoraw(typval_T *argvars, typval_T *rettv UNUSED)
4187{
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02004188 char_u *str;
Bram Moolenaar4132eb52020-02-14 16:53:00 +01004189
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02004190 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
4191 return;
4192
4193 str = tv_get_string_chk(&argvars[0]);
Bram Moolenaar4132eb52020-02-14 16:53:00 +01004194 if (str != NULL && *str != NUL)
4195 {
4196 out_str(str);
4197 out_flush();
4198 }
4199}
4200
4201/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004202 * "empty({expr})" function
4203 */
4204 static void
4205f_empty(typval_T *argvars, typval_T *rettv)
4206{
4207 int n = FALSE;
4208
4209 switch (argvars[0].v_type)
4210 {
4211 case VAR_STRING:
4212 case VAR_FUNC:
4213 n = argvars[0].vval.v_string == NULL
4214 || *argvars[0].vval.v_string == NUL;
4215 break;
4216 case VAR_PARTIAL:
Yegappan Lakshmananda9d3452024-05-02 13:02:36 +02004217 n = argvars[0].vval.v_partial == NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004218 break;
4219 case VAR_NUMBER:
4220 n = argvars[0].vval.v_number == 0;
4221 break;
4222 case VAR_FLOAT:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004223 n = argvars[0].vval.v_float == 0.0;
4224 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004225 case VAR_LIST:
4226 n = argvars[0].vval.v_list == NULL
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004227 || argvars[0].vval.v_list->lv_len == 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004228 break;
4229 case VAR_DICT:
4230 n = argvars[0].vval.v_dict == NULL
4231 || argvars[0].vval.v_dict->dv_hashtab.ht_used == 0;
4232 break;
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01004233 case VAR_BOOL:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004234 case VAR_SPECIAL:
4235 n = argvars[0].vval.v_number != VVAL_TRUE;
4236 break;
Bram Moolenaar00b28d62022-12-08 15:32:33 +00004237 case VAR_CLASS:
4238 n = argvars[0].vval.v_class != NULL;
4239 break;
4240 case VAR_OBJECT:
Yegappan Lakshmanand3eae7b2024-03-03 16:26:58 +01004241 n = object_empty(argvars[0].vval.v_object);
Bram Moolenaar00b28d62022-12-08 15:32:33 +00004242 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004243
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01004244 case VAR_BLOB:
4245 n = argvars[0].vval.v_blob == NULL
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01004246 || argvars[0].vval.v_blob->bv_ga.ga_len == 0;
4247 break;
4248
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004249 case VAR_JOB:
4250#ifdef FEAT_JOB_CHANNEL
4251 n = argvars[0].vval.v_job == NULL
4252 || argvars[0].vval.v_job->jv_status != JOB_STARTED;
4253 break;
4254#endif
4255 case VAR_CHANNEL:
4256#ifdef FEAT_JOB_CHANNEL
4257 n = argvars[0].vval.v_channel == NULL
4258 || !channel_is_open(argvars[0].vval.v_channel);
4259 break;
4260#endif
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +02004261 case VAR_TYPEALIAS:
4262 n = argvars[0].vval.v_typealias == NULL
4263 || argvars[0].vval.v_typealias->ta_name == NULL
4264 || *argvars[0].vval.v_typealias->ta_name == NUL;
4265 break;
4266
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004267 case VAR_UNKNOWN:
Bram Moolenaar4c683752020-04-05 21:38:23 +02004268 case VAR_ANY:
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004269 case VAR_VOID:
Bram Moolenaarf18332f2021-05-07 17:55:55 +02004270 case VAR_INSTR:
Bram Moolenaardd589232020-02-29 17:38:12 +01004271 internal_error_no_abort("f_empty(UNKNOWN)");
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004272 n = TRUE;
4273 break;
4274 }
4275
4276 rettv->vval.v_number = n;
4277}
4278
4279/*
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004280 * "environ()" function
4281 */
4282 static void
4283f_environ(typval_T *argvars UNUSED, typval_T *rettv)
4284{
4285#if !defined(AMIGA)
4286 int i = 0;
4287 char_u *entry, *value;
Bram Moolenaar68aaff42022-04-17 10:57:44 +01004288# if defined (MSWIN)
4289# if !defined(_UCRT)
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004290 extern wchar_t **_wenviron;
Bram Moolenaar68aaff42022-04-17 10:57:44 +01004291# endif
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004292# else
4293 extern char **environ;
4294# endif
4295
Bram Moolenaar93a10962022-06-16 11:42:09 +01004296 if (rettv_dict_alloc(rettv) == FAIL)
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004297 return;
4298
4299# ifdef MSWIN
4300 if (*_wenviron == NULL)
4301 return;
4302# else
4303 if (*environ == NULL)
4304 return;
4305# endif
4306
4307 for (i = 0; ; ++i)
4308 {
4309# ifdef MSWIN
4310 short_u *p;
4311
4312 if ((p = (short_u *)_wenviron[i]) == NULL)
4313 return;
4314 entry = utf16_to_enc(p, NULL);
4315# else
4316 if ((entry = (char_u *)environ[i]) == NULL)
4317 return;
4318 entry = vim_strsave(entry);
4319# endif
4320 if (entry == NULL) // out of memory
4321 return;
4322 if ((value = vim_strchr(entry, '=')) == NULL)
4323 {
4324 vim_free(entry);
4325 continue;
4326 }
4327 *value++ = NUL;
4328 dict_add_string(rettv->vval.v_dict, (char *)entry, value);
4329 vim_free(entry);
4330 }
4331#endif
4332}
4333
4334/*
Bram Moolenaar80adaa82023-07-07 18:57:40 +01004335 * "err_teapot()" function
4336 */
4337 static void
4338f_err_teapot(typval_T *argvars, typval_T *rettv UNUSED)
4339{
4340 if (argvars[0].v_type != VAR_UNKNOWN)
4341 {
4342 if (argvars[0].v_type == VAR_STRING)
4343 {
4344 char_u *s = tv_get_string_strict(&argvars[0]);
Sean Dewarb0efa492023-07-08 10:35:19 +01004345 if (*skipwhite(s) == NUL)
Bram Moolenaar80adaa82023-07-07 18:57:40 +01004346 return;
4347 }
4348
4349 int err = FALSE;
4350 int do_503 = eval_expr_to_bool(&argvars[0], &err);
4351 if (!err && do_503)
4352 {
4353 emsg(_(e_coffee_currently_not_available));
4354 return;
4355 }
4356 }
4357
4358 emsg(_(e_im_a_teapot));
4359}
4360
4361/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004362 * "escape({string}, {chars})" function
4363 */
4364 static void
4365f_escape(typval_T *argvars, typval_T *rettv)
4366{
4367 char_u buf[NUMBUFLEN];
4368
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004369 if (in_vim9script()
4370 && (check_for_string_arg(argvars, 0) == FAIL
4371 || check_for_string_arg(argvars, 1) == FAIL))
4372 return;
4373
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004374 rettv->vval.v_string = vim_strsave_escaped(tv_get_string(&argvars[0]),
4375 tv_get_string_buf(&argvars[1], buf));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004376 rettv->v_type = VAR_STRING;
4377}
4378
4379/*
4380 * "eval()" function
4381 */
4382 static void
4383f_eval(typval_T *argvars, typval_T *rettv)
4384{
4385 char_u *s, *p;
4386
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004387 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
4388 return;
4389
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004390 s = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004391 if (s != NULL)
4392 s = skipwhite(s);
4393
4394 p = s;
Bram Moolenaar5409f5d2020-06-24 18:37:35 +02004395 if (s == NULL || eval1(&s, rettv, &EVALARG_EVALUATE) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004396 {
4397 if (p != NULL && !aborting())
Bram Moolenaar108010a2021-06-27 22:03:33 +02004398 semsg(_(e_invalid_expression_str), p);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004399 need_clr_eos = FALSE;
4400 rettv->v_type = VAR_NUMBER;
4401 rettv->vval.v_number = 0;
4402 }
4403 else if (*s != NUL)
Bram Moolenaar74409f62022-01-01 15:58:22 +00004404 semsg(_(e_trailing_characters_str), s);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004405}
4406
4407/*
4408 * "eventhandler()" function
4409 */
4410 static void
4411f_eventhandler(typval_T *argvars UNUSED, typval_T *rettv)
4412{
Bram Moolenaardfc33a62020-04-29 22:30:13 +02004413 rettv->vval.v_number = vgetc_busy || input_busy;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004414}
4415
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004416static garray_T redir_execute_ga;
4417
4418/*
4419 * Append "value[value_len]" to the execute() output.
4420 */
4421 void
4422execute_redir_str(char_u *value, int value_len)
4423{
4424 int len;
4425
4426 if (value_len == -1)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004427 len = (int)STRLEN(value); // Append the entire string
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004428 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004429 len = value_len; // Append only "value_len" characters
Yegappan Lakshmananfadc02a2023-01-27 21:03:12 +00004430 if (ga_grow(&redir_execute_ga, len) == FAIL)
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00004431 return;
4432
4433 mch_memmove((char *)redir_execute_ga.ga_data
4434 + redir_execute_ga.ga_len, value, len);
4435 redir_execute_ga.ga_len += len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004436}
4437
Dominique Pelle748b3082022-01-08 12:41:16 +00004438#if defined(FEAT_LUA) || defined(PROTO)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004439/*
Yegappan Lakshmanan11328bc2021-08-06 21:34:38 +02004440 * Get next line from a string containing NL separated lines.
4441 * Called by do_cmdline() to get the next line.
4442 * Returns an allocated string, or NULL when at the end of the string.
4443 */
4444 static char_u *
4445get_str_line(
4446 int c UNUSED,
4447 void *cookie,
4448 int indent UNUSED,
4449 getline_opt_T options UNUSED)
4450{
4451 char_u *start = *(char_u **)cookie;
4452 char_u *line;
4453 char_u *p;
4454
4455 p = start;
4456 if (p == NULL || *p == NUL)
4457 return NULL;
4458 p = vim_strchr(p, '\n');
4459 if (p == NULL)
4460 line = vim_strsave(start);
4461 else
4462 {
4463 line = vim_strnsave(start, p - start);
4464 p++;
4465 }
4466
4467 *(char_u **)cookie = p;
4468 return line;
4469}
4470
4471/*
4472 * Execute a series of Ex commands in 'str'
4473 */
4474 void
4475execute_cmds_from_string(char_u *str)
4476{
4477 do_cmdline(NULL, get_str_line, (void *)&str,
4478 DOCMD_NOWAIT|DOCMD_VERBOSE|DOCMD_REPEAT|DOCMD_KEYTYPED);
4479}
Dominique Pelle748b3082022-01-08 12:41:16 +00004480#endif
Yegappan Lakshmanan11328bc2021-08-06 21:34:38 +02004481
4482/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004483 * Get next line from a list.
4484 * Called by do_cmdline() to get the next line.
4485 * Returns allocated string, or NULL for end of function.
4486 */
Bram Moolenaara7583c42022-05-07 21:14:05 +01004487 char_u *
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004488get_list_line(
4489 int c UNUSED,
4490 void *cookie,
Bram Moolenaare96a2492019-06-25 04:12:16 +02004491 int indent UNUSED,
Bram Moolenaar66250c92020-08-20 15:02:42 +02004492 getline_opt_T options UNUSED)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004493{
4494 listitem_T **p = (listitem_T **)cookie;
4495 listitem_T *item = *p;
4496 char_u buf[NUMBUFLEN];
4497 char_u *s;
4498
4499 if (item == NULL)
4500 return NULL;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004501 s = tv_get_string_buf_chk(&item->li_tv, buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004502 *p = item->li_next;
4503 return s == NULL ? NULL : vim_strsave(s);
4504}
4505
4506/*
4507 * "execute()" function
4508 */
Bram Moolenaar261f3462019-09-07 15:45:32 +02004509 void
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004510execute_common(typval_T *argvars, typval_T *rettv, int arg_off)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004511{
4512 char_u *cmd = NULL;
4513 list_T *list = NULL;
4514 int save_msg_silent = msg_silent;
4515 int save_emsg_silent = emsg_silent;
4516 int save_emsg_noredir = emsg_noredir;
4517 int save_redir_execute = redir_execute;
Bram Moolenaar20951482017-12-25 13:44:43 +01004518 int save_redir_off = redir_off;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004519 garray_T save_ga;
Bram Moolenaar10ccaa12018-12-07 16:38:23 +01004520 int save_msg_col = msg_col;
Kota Kato3d3f6ac2022-08-04 18:50:14 +01004521 int save_sticky_cmdmod_flags = sticky_cmdmod_flags;
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004522 int echo_output = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004523
4524 rettv->vval.v_string = NULL;
4525 rettv->v_type = VAR_STRING;
4526
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004527 if (argvars[arg_off].v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004528 {
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004529 list = argvars[arg_off].vval.v_list;
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004530 if (list == NULL || list->lv_len == 0)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004531 // empty list, no commands, empty output
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004532 return;
4533 ++list->lv_refcount;
4534 }
Bram Moolenaare2a8f072020-01-08 19:32:18 +01004535 else if (argvars[arg_off].v_type == VAR_JOB
4536 || argvars[arg_off].v_type == VAR_CHANNEL)
4537 {
Bram Moolenaar68db9962021-05-09 23:19:22 +02004538 semsg(_(e_using_invalid_value_as_string_str),
4539 vartype_name(argvars[arg_off].v_type));
Bram Moolenaare2a8f072020-01-08 19:32:18 +01004540 return;
4541 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004542 else
4543 {
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004544 cmd = tv_get_string_chk(&argvars[arg_off]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004545 if (cmd == NULL)
4546 return;
4547 }
4548
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004549 if (argvars[arg_off + 1].v_type != VAR_UNKNOWN)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004550 {
4551 char_u buf[NUMBUFLEN];
Bram Moolenaar3cfa5b12021-06-06 14:14:39 +02004552 char_u *s = tv_get_string_buf_chk_strict(&argvars[arg_off + 1], buf,
4553 in_vim9script());
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004554
4555 if (s == NULL)
4556 return;
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004557 if (*s == NUL)
4558 echo_output = TRUE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004559 if (STRNCMP(s, "silent", 6) == 0)
4560 ++msg_silent;
4561 if (STRCMP(s, "silent!") == 0)
4562 {
4563 emsg_silent = TRUE;
4564 emsg_noredir = TRUE;
4565 }
4566 }
4567 else
4568 ++msg_silent;
4569
4570 if (redir_execute)
4571 save_ga = redir_execute_ga;
Bram Moolenaar04935fb2022-01-08 16:19:22 +00004572 ga_init2(&redir_execute_ga, sizeof(char), 500);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004573 redir_execute = TRUE;
Bram Moolenaar20951482017-12-25 13:44:43 +01004574 redir_off = FALSE;
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004575 if (!echo_output)
4576 msg_col = 0; // prevent leading spaces
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004577
Kota Kato3d3f6ac2022-08-04 18:50:14 +01004578 // For "legacy call execute('cmd')" and "vim9cmd execute('cmd')" apply the
4579 // command modifiers to "cmd".
4580 sticky_cmdmod_flags = cmdmod.cmod_flags & (CMOD_LEGACY | CMOD_VIM9CMD);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004581 if (cmd != NULL)
4582 do_cmdline_cmd(cmd);
4583 else
4584 {
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004585 listitem_T *item;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004586
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02004587 CHECK_LIST_MATERIALIZE(list);
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004588 item = list->lv_first;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004589 do_cmdline(NULL, get_list_line, (void *)&item,
4590 DOCMD_NOWAIT|DOCMD_VERBOSE|DOCMD_REPEAT|DOCMD_KEYTYPED);
4591 --list->lv_refcount;
4592 }
Kota Kato3d3f6ac2022-08-04 18:50:14 +01004593 sticky_cmdmod_flags = save_sticky_cmdmod_flags;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004594
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004595 // Need to append a NUL to the result.
Bram Moolenaard297f352017-01-29 20:31:21 +01004596 if (ga_grow(&redir_execute_ga, 1) == OK)
4597 {
4598 ((char *)redir_execute_ga.ga_data)[redir_execute_ga.ga_len] = NUL;
4599 rettv->vval.v_string = redir_execute_ga.ga_data;
4600 }
4601 else
4602 {
4603 ga_clear(&redir_execute_ga);
4604 rettv->vval.v_string = NULL;
4605 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004606 msg_silent = save_msg_silent;
4607 emsg_silent = save_emsg_silent;
4608 emsg_noredir = save_emsg_noredir;
4609
4610 redir_execute = save_redir_execute;
4611 if (redir_execute)
4612 redir_execute_ga = save_ga;
Bram Moolenaar20951482017-12-25 13:44:43 +01004613 redir_off = save_redir_off;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004614
Bram Moolenaar10ccaa12018-12-07 16:38:23 +01004615 // "silent reg" or "silent echo x" leaves msg_col somewhere in the line.
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004616 if (echo_output)
4617 // When not working silently: put it in column zero. A following
4618 // "echon" will overwrite the message, unavoidably.
4619 msg_col = 0;
4620 else
4621 // When working silently: Put it back where it was, since nothing
4622 // should have been written.
4623 msg_col = save_msg_col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004624}
4625
4626/*
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004627 * "execute()" function
4628 */
4629 static void
4630f_execute(typval_T *argvars, typval_T *rettv)
4631{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004632 if (in_vim9script()
4633 && (check_for_string_or_list_arg(argvars, 0) == FAIL
4634 || check_for_opt_string_arg(argvars, 1) == FAIL))
4635 return;
4636
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004637 execute_common(argvars, rettv, 0);
4638}
4639
4640/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004641 * "exists()" function
4642 */
Bram Moolenaarbb7ee7a2021-08-02 20:06:50 +02004643 void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004644f_exists(typval_T *argvars, typval_T *rettv)
4645{
4646 char_u *p;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004647 int n = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004648
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004649 if (in_vim9script() && check_for_nonempty_string_arg(argvars, 0) == FAIL)
4650 return;
4651
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004652 p = tv_get_string(&argvars[0]);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004653 if (*p == '$') // environment variable
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004654 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004655 // first try "normal" environment variables (fast)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004656 if (mch_getenv(p + 1) != NULL)
4657 n = TRUE;
4658 else
4659 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004660 // try expanding things like $VIM and ${HOME}
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004661 p = expand_env_save(p);
4662 if (p != NULL && *p != '$')
4663 n = TRUE;
4664 vim_free(p);
4665 }
4666 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004667 else if (*p == '&' || *p == '+') // option
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004668 {
Bram Moolenaar9a78e6d2020-07-01 18:29:55 +02004669 n = (eval_option(&p, NULL, TRUE) == OK);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004670 if (*skipwhite(p) != NUL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004671 n = FALSE; // trailing garbage
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004672 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004673 else if (*p == '*') // internal or user defined function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004674 {
Bram Moolenaarb54c3ff2016-07-31 14:11:58 +02004675 n = function_exists(p + 1, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004676 }
Bram Moolenaar15c47602020-03-26 22:16:48 +01004677 else if (*p == '?') // internal function only
4678 {
4679 n = has_internal_func_name(p + 1);
4680 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004681 else if (*p == ':')
4682 {
4683 n = cmd_exists(p + 1);
4684 }
4685 else if (*p == '#')
4686 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004687 if (p[1] == '#')
4688 n = autocmd_supported(p + 2);
4689 else
4690 n = au_exists(p + 1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004691 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004692 else // internal variable
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004693 {
Bram Moolenaarc6f9f732018-02-11 19:06:26 +01004694 n = var_exists(p);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004695 }
4696
4697 rettv->vval.v_number = n;
4698}
4699
Bram Moolenaar26735992021-08-08 14:43:22 +02004700 static void
4701f_exists_compiled(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
4702{
4703 emsg(_(e_exists_compiled_can_only_be_used_in_def_function));
4704}
4705
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004706/*
4707 * "expand()" function
4708 */
4709 static void
4710f_expand(typval_T *argvars, typval_T *rettv)
4711{
4712 char_u *s;
Mike Williams51024bb2024-05-30 07:46:30 +02004713 size_t len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004714 int options = WILD_SILENT|WILD_USE_NL|WILD_LIST_NOTFOUND;
4715 expand_T xpc;
4716 int error = FALSE;
4717 char_u *result;
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004718#ifdef BACKSLASH_IN_FILENAME
4719 char_u *p_csl_save = p_csl;
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004720#endif
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004721
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004722 if (in_vim9script()
4723 && (check_for_string_arg(argvars, 0) == FAIL
4724 || check_for_opt_bool_arg(argvars, 1) == FAIL
4725 || (argvars[1].v_type != VAR_UNKNOWN
4726 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
4727 return;
4728
4729#ifdef BACKSLASH_IN_FILENAME
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004730 // avoid using 'completeslash' here
4731 p_csl = empty_option;
4732#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004733
4734 rettv->v_type = VAR_STRING;
4735 if (argvars[1].v_type != VAR_UNKNOWN
4736 && argvars[2].v_type != VAR_UNKNOWN
Bram Moolenaar551d25e2020-09-02 21:37:56 +02004737 && tv_get_bool_chk(&argvars[2], &error)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004738 && !error)
Bram Moolenaar45cf6e92017-04-30 20:25:19 +02004739 rettv_list_set(rettv, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004740
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004741 s = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004742 if (*s == '%' || *s == '#' || *s == '<')
4743 {
Bram Moolenaar57544522022-04-12 12:54:11 +01004744 char *errormsg = NULL;
4745
4746 if (p_verbose == 0)
4747 ++emsg_off;
Bram Moolenaara96edb72022-04-28 17:52:24 +01004748 result = eval_vars(s, s, &len, NULL, &errormsg, NULL, FALSE);
Bram Moolenaar57544522022-04-12 12:54:11 +01004749 if (p_verbose == 0)
4750 --emsg_off;
4751 else if (errormsg != NULL)
4752 emsg(errormsg);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004753 if (rettv->v_type == VAR_LIST)
4754 {
Bram Moolenaar93a10962022-06-16 11:42:09 +01004755 if (rettv_list_alloc(rettv) == OK && result != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004756 list_append_string(rettv->vval.v_list, result, -1);
Bram Moolenaar86173482019-10-01 17:02:16 +02004757 vim_free(result);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004758 }
4759 else
4760 rettv->vval.v_string = result;
4761 }
4762 else
4763 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004764 // When the optional second argument is non-zero, don't remove matches
4765 // for 'wildignore' and don't put matches for 'suffixes' at the end.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004766 if (argvars[1].v_type != VAR_UNKNOWN
Bram Moolenaar551d25e2020-09-02 21:37:56 +02004767 && tv_get_bool_chk(&argvars[1], &error))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004768 options |= WILD_KEEP_ALL;
4769 if (!error)
4770 {
4771 ExpandInit(&xpc);
4772 xpc.xp_context = EXPAND_FILES;
4773 if (p_wic)
4774 options += WILD_ICASE;
4775 if (rettv->v_type == VAR_STRING)
4776 rettv->vval.v_string = ExpandOne(&xpc, s, NULL,
4777 options, WILD_ALL);
Bram Moolenaar93a10962022-06-16 11:42:09 +01004778 else if (rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004779 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004780 ExpandOne(&xpc, s, NULL, options, WILD_ALL_KEEP);
Bram Moolenaar848db572022-09-20 19:04:32 +01004781 for (int i = 0; i < xpc.xp_numfiles; i++)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004782 list_append_string(rettv->vval.v_list, xpc.xp_files[i], -1);
4783 ExpandCleanup(&xpc);
4784 }
4785 }
4786 else
4787 rettv->vval.v_string = NULL;
4788 }
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004789#ifdef BACKSLASH_IN_FILENAME
4790 p_csl = p_csl_save;
4791#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004792}
4793
4794/*
Bram Moolenaar80dad482019-06-09 17:22:31 +02004795 * "expandcmd()" function
4796 * Expand all the special characters in a command string.
4797 */
4798 static void
4799f_expandcmd(typval_T *argvars, typval_T *rettv)
4800{
4801 exarg_T eap;
4802 char_u *cmdstr;
4803 char *errormsg = NULL;
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004804 int emsgoff = TRUE;
Bram Moolenaar80dad482019-06-09 17:22:31 +02004805
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004806 if (in_vim9script()
4807 && (check_for_string_arg(argvars, 0) == FAIL
4808 || check_for_opt_dict_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004809 return;
4810
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004811 if (argvars[1].v_type == VAR_DICT
Bram Moolenaard61efa52022-07-23 09:52:04 +01004812 && dict_get_bool(argvars[1].vval.v_dict, "errmsg", VVAL_FALSE))
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004813 emsgoff = FALSE;
4814
Bram Moolenaar80dad482019-06-09 17:22:31 +02004815 rettv->v_type = VAR_STRING;
4816 cmdstr = vim_strsave(tv_get_string(&argvars[0]));
4817
Yegappan Lakshmanan960dcbd2023-03-07 17:45:11 +00004818 CLEAR_FIELD(eap);
Bram Moolenaar80dad482019-06-09 17:22:31 +02004819 eap.cmd = cmdstr;
4820 eap.arg = cmdstr;
Bram Moolenaar8071cb22019-07-12 17:58:01 +02004821 eap.argt |= EX_NOSPC;
Bram Moolenaar80dad482019-06-09 17:22:31 +02004822 eap.usefilter = FALSE;
4823 eap.nextcmd = NULL;
4824 eap.cmdidx = CMD_USER;
4825
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004826 if (emsgoff)
4827 ++emsg_off;
4828 if (expand_filename(&eap, &cmdstr, &errormsg) == FAIL)
4829 if (!emsgoff && errormsg != NULL && *errormsg != NUL)
4830 emsg(errormsg);
4831 if (emsgoff)
4832 --emsg_off;
Bram Moolenaar80dad482019-06-09 17:22:31 +02004833
4834 rettv->vval.v_string = cmdstr;
4835}
4836
4837/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004838 * "feedkeys()" function
4839 */
4840 static void
4841f_feedkeys(typval_T *argvars, typval_T *rettv UNUSED)
4842{
4843 int remap = TRUE;
4844 int insert = FALSE;
4845 char_u *keys, *flags;
4846 char_u nbuf[NUMBUFLEN];
4847 int typed = FALSE;
4848 int execute = FALSE;
Bram Moolenaara9725222022-01-16 13:30:33 +00004849 int context = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004850 int dangerous = FALSE;
Bram Moolenaar5e66b422019-01-24 21:58:10 +01004851 int lowlevel = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004852
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004853 // This is not allowed in the sandbox. If the commands would still be
4854 // executed in the sandbox it would be OK, but it probably happens later,
4855 // when "sandbox" is no longer set.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004856 if (check_secure())
4857 return;
4858
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004859 if (in_vim9script()
4860 && (check_for_string_arg(argvars, 0) == FAIL
4861 || check_for_opt_string_arg(argvars, 1) == FAIL))
4862 return;
4863
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004864 keys = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004865
4866 if (argvars[1].v_type != VAR_UNKNOWN)
4867 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004868 flags = tv_get_string_buf(&argvars[1], nbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004869 for ( ; *flags != NUL; ++flags)
4870 {
4871 switch (*flags)
4872 {
4873 case 'n': remap = FALSE; break;
4874 case 'm': remap = TRUE; break;
4875 case 't': typed = TRUE; break;
4876 case 'i': insert = TRUE; break;
4877 case 'x': execute = TRUE; break;
Bram Moolenaara9725222022-01-16 13:30:33 +00004878 case 'c': context = TRUE; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004879 case '!': dangerous = TRUE; break;
Bram Moolenaar5e66b422019-01-24 21:58:10 +01004880 case 'L': lowlevel = TRUE; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004881 }
4882 }
4883 }
4884
4885 if (*keys != NUL || execute)
4886 {
Christopher Plewright20b795e2022-12-20 20:01:58 +00004887 if (lowlevel
4888#ifdef FEAT_VTP
4889 && (!is_term_win32()
4890 || (keys[0] == 3 && ctrl_c_interrupts && typed))
4891#endif
4892 )
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004893 {
Bram Moolenaar5e66b422019-01-24 21:58:10 +01004894#ifdef USE_INPUT_BUF
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004895 ch_log(NULL, "feedkeys() lowlevel: %s", keys);
Bram Moolenaar9645e2d2020-03-20 20:48:49 +01004896
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004897 int len = (int)STRLEN(keys);
4898 for (int idx = 0; idx < len; ++idx)
4899 {
4900 // if a CTRL-C was typed, set got_int, similar to what
4901 // happens in fill_input_buf()
4902 if (keys[idx] == 3 && ctrl_c_interrupts && typed)
4903 got_int = TRUE;
4904 add_to_input_buf(keys + idx, 1);
4905 }
Bram Moolenaar5e66b422019-01-24 21:58:10 +01004906#else
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004907 emsg(_(e_lowlevel_input_not_supported));
Bram Moolenaar5e66b422019-01-24 21:58:10 +01004908#endif
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004909 }
4910 else
4911 {
4912 // Need to escape K_SPECIAL and CSI before putting the string in
4913 // the typeahead buffer.
4914 char_u *keys_esc = vim_strsave_escape_csi(keys);
4915 if (keys_esc == NULL)
4916 return;
4917
4918 ch_log(NULL, "feedkeys(%s): %s", typed ? "typed" : "", keys);
4919
4920 ins_typebuf(keys_esc, (remap ? REMAP_YES : REMAP_NONE),
4921 insert ? 0 : typebuf.tb_len, !typed, FALSE);
4922 if (vgetc_busy
Bram Moolenaar5d7be4f2017-06-25 13:40:17 +02004923#ifdef FEAT_TIMERS
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004924 || timer_busy
Bram Moolenaar5d7be4f2017-06-25 13:40:17 +02004925#endif
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004926 || input_busy)
4927 typebuf_was_filled = TRUE;
4928
Bram Moolenaar8d4ce562019-01-30 22:01:40 +01004929 vim_free(keys_esc);
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004930 }
Bram Moolenaar8d4ce562019-01-30 22:01:40 +01004931
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004932 if (execute)
4933 {
4934 int save_msg_scroll = msg_scroll;
4935 sctx_T save_sctx;
4936
4937 // Avoid a 1 second delay when the keys start Insert mode.
4938 msg_scroll = FALSE;
4939
4940 ch_log(NULL, "feedkeys() executing");
4941
4942 if (context)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004943 {
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004944 save_sctx = current_sctx;
4945 current_sctx.sc_sid = 0;
4946 current_sctx.sc_version = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004947 }
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004948
4949 if (!dangerous)
4950 {
4951 ++ex_normal_busy;
4952 ++in_feedkeys;
4953 }
4954 exec_normal(TRUE, lowlevel, TRUE);
4955 if (!dangerous)
4956 {
4957 --ex_normal_busy;
4958 --in_feedkeys;
4959 }
4960
4961 msg_scroll |= save_msg_scroll;
4962
4963 if (context)
4964 current_sctx = save_sctx;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004965 }
4966 }
4967}
4968
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004969/*
4970 * "fnameescape({string})" function
4971 */
4972 static void
4973f_fnameescape(typval_T *argvars, typval_T *rettv)
4974{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004975 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
4976 return;
4977
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004978 rettv->vval.v_string = vim_strsave_fnameescape(
Bram Moolenaar21c1a0c2021-10-17 17:20:23 +01004979 tv_get_string(&argvars[0]), VSE_NONE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004980 rettv->v_type = VAR_STRING;
4981}
4982
4983/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004984 * "foreground()" function
4985 */
4986 static void
4987f_foreground(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
4988{
4989#ifdef FEAT_GUI
4990 if (gui.in_use)
Bram Moolenaarafde13b2019-04-28 19:46:49 +02004991 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004992 gui_mch_set_foreground();
Bram Moolenaarafde13b2019-04-28 19:46:49 +02004993 return;
4994 }
4995#endif
4996#if defined(MSWIN) && (!defined(FEAT_GUI) || defined(VIMDLL))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004997 win32_set_foreground();
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004998#endif
4999}
5000
Bakudankun375141e2022-09-09 18:46:47 +01005001/*
5002 * "function()" function
5003 * "funcref()" function
5004 */
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005005 static void
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005006common_function(typval_T *argvars, typval_T *rettv, int is_funcref)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005007{
5008 char_u *s;
5009 char_u *name;
5010 int use_string = FALSE;
5011 partial_T *arg_pt = NULL;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005012 char_u *trans_name = NULL;
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02005013 int is_global = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005014
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02005015 if (in_vim9script()
Bram Moolenaarae1068a2021-12-25 19:43:44 +00005016 && (check_for_string_or_func_arg(argvars, 0) == FAIL
5017 || check_for_opt_list_arg(argvars, 1) == FAIL
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02005018 || (argvars[1].v_type != VAR_UNKNOWN
5019 && check_for_opt_dict_arg(argvars, 2) == FAIL)))
5020 return;
5021
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005022 if (argvars[0].v_type == VAR_FUNC)
5023 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005024 // function(MyFunc, [arg], dict)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005025 s = argvars[0].vval.v_string;
5026 }
5027 else if (argvars[0].v_type == VAR_PARTIAL
5028 && argvars[0].vval.v_partial != NULL)
5029 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005030 // function(dict.MyFunc, [arg])
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005031 arg_pt = argvars[0].vval.v_partial;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005032 s = partial_name(arg_pt);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005033 }
5034 else
5035 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005036 // function('MyFunc', [arg], dict)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005037 s = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005038 use_string = TRUE;
5039 }
Bram Moolenaar60b6e6f2021-08-28 12:49:27 +02005040 if (s == NULL)
5041 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00005042 semsg(_(e_invalid_argument_str), "NULL");
Bram Moolenaar60b6e6f2021-08-28 12:49:27 +02005043 return;
5044 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005045
Bram Moolenaar843b8842016-08-21 14:36:15 +02005046 if ((use_string && vim_strchr(s, AUTOLOAD_CHAR) == NULL) || is_funcref)
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005047 {
5048 name = s;
Bram Moolenaareba3b7f2021-11-30 18:25:08 +00005049 trans_name = save_function_name(&name, &is_global, FALSE,
5050 TFN_INT | TFN_QUIET | TFN_NO_AUTOLOAD | TFN_NO_DEREF, NULL);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005051 if (*name != NUL)
5052 s = NULL;
5053 }
5054
Bram Moolenaar843b8842016-08-21 14:36:15 +02005055 if (s == NULL || *s == NUL || (use_string && VIM_ISDIGIT(*s))
5056 || (is_funcref && trans_name == NULL))
Yegappan Lakshmanan655b7342022-03-06 14:27:10 +00005057 semsg(_(e_invalid_argument_str),
5058 use_string ? tv_get_string(&argvars[0]) : s);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005059 // Don't check an autoload name for existence here.
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005060 else if (trans_name != NULL && (is_funcref
Bram Moolenaard9d2fd02022-01-13 21:15:21 +00005061 ? find_func(trans_name, is_global) == NULL
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02005062 : !translated_function_exists(trans_name, is_global)))
Bram Moolenaara6f79292022-01-04 21:30:47 +00005063 semsg(_(e_unknown_function_str_2), s);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005064 else
5065 {
5066 int dict_idx = 0;
5067 int arg_idx = 0;
5068 list_T *list = NULL;
5069
5070 if (STRNCMP(s, "s:", 2) == 0 || STRNCMP(s, "<SID>", 5) == 0)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005071 // Expand s: and <SID> into <SNR>nr_, so that the function can
5072 // also be called from another script. Using trans_function_name()
5073 // would also work, but some plugins depend on the name being
5074 // printable text.
Yegappan Lakshmanane7f4abd2021-12-24 20:47:38 +00005075 name = get_scriptlocal_funcname(s);
Bram Moolenaarc2f17f72022-02-21 13:13:50 +00005076 else if (trans_name != NULL && *trans_name == K_SPECIAL)
5077 name = alloc_printable_func_name(trans_name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005078 else
5079 name = vim_strsave(s);
5080
5081 if (argvars[1].v_type != VAR_UNKNOWN)
5082 {
5083 if (argvars[2].v_type != VAR_UNKNOWN)
5084 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005085 // function(name, [args], dict)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005086 arg_idx = 1;
5087 dict_idx = 2;
5088 }
5089 else if (argvars[1].v_type == VAR_DICT)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005090 // function(name, dict)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005091 dict_idx = 1;
5092 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005093 // function(name, [args])
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005094 arg_idx = 1;
5095 if (dict_idx > 0)
5096 {
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +01005097 if (check_for_dict_arg(argvars, dict_idx) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005098 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005099 vim_free(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005100 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005101 }
5102 if (argvars[dict_idx].vval.v_dict == NULL)
5103 dict_idx = 0;
5104 }
5105 if (arg_idx > 0)
5106 {
5107 if (argvars[arg_idx].v_type != VAR_LIST)
5108 {
Bram Moolenaard82a47d2022-01-05 20:24:39 +00005109 emsg(_(e_second_argument_of_function_must_be_list_or_dict));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005110 vim_free(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005111 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005112 }
5113 list = argvars[arg_idx].vval.v_list;
5114 if (list == NULL || list->lv_len == 0)
5115 arg_idx = 0;
Bram Moolenaar4c054e92019-11-10 00:13:50 +01005116 else if (list->lv_len > MAX_FUNC_ARGS)
5117 {
Yegappan Lakshmanan5018a832022-04-02 21:12:21 +01005118 emsg_funcname(e_too_many_arguments_for_function_str, s);
Bram Moolenaar4c054e92019-11-10 00:13:50 +01005119 vim_free(name);
5120 goto theend;
5121 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005122 }
5123 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005124 if (dict_idx > 0 || arg_idx > 0 || arg_pt != NULL || is_funcref)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005125 {
Bram Moolenaarc799fe22019-05-28 23:08:19 +02005126 partial_T *pt = ALLOC_CLEAR_ONE(partial_T);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005127
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005128 // result is a VAR_PARTIAL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005129 if (pt == NULL)
5130 vim_free(name);
5131 else
5132 {
5133 if (arg_idx > 0 || (arg_pt != NULL && arg_pt->pt_argc > 0))
5134 {
5135 listitem_T *li;
5136 int i = 0;
5137 int arg_len = 0;
5138 int lv_len = 0;
5139
5140 if (arg_pt != NULL)
5141 arg_len = arg_pt->pt_argc;
5142 if (list != NULL)
5143 lv_len = list->lv_len;
5144 pt->pt_argc = arg_len + lv_len;
Bram Moolenaarc799fe22019-05-28 23:08:19 +02005145 pt->pt_argv = ALLOC_MULT(typval_T, pt->pt_argc);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005146 if (pt->pt_argv == NULL)
5147 {
5148 vim_free(pt);
5149 vim_free(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005150 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005151 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005152 for (i = 0; i < arg_len; i++)
5153 copy_tv(&arg_pt->pt_argv[i], &pt->pt_argv[i]);
5154 if (lv_len > 0)
Bram Moolenaar50985eb2020-01-27 22:09:39 +01005155 {
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02005156 CHECK_LIST_MATERIALIZE(list);
Bram Moolenaaraeea7212020-04-02 18:50:46 +02005157 FOR_ALL_LIST_ITEMS(list, li)
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005158 copy_tv(&li->li_tv, &pt->pt_argv[i++]);
Bram Moolenaar50985eb2020-01-27 22:09:39 +01005159 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005160 }
5161
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005162 // For "function(dict.func, [], dict)" and "func" is a partial
5163 // use "dict". That is backwards compatible.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005164 if (dict_idx > 0)
5165 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005166 // The dict is bound explicitly, pt_auto is FALSE.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005167 pt->pt_dict = argvars[dict_idx].vval.v_dict;
5168 ++pt->pt_dict->dv_refcount;
5169 }
5170 else if (arg_pt != NULL)
5171 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005172 // If the dict was bound automatically the result is also
5173 // bound automatically.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005174 pt->pt_dict = arg_pt->pt_dict;
5175 pt->pt_auto = arg_pt->pt_auto;
5176 if (pt->pt_dict != NULL)
5177 ++pt->pt_dict->dv_refcount;
Yegappan Lakshmanan29bb67f2023-10-14 11:18:50 +02005178 pt->pt_obj = arg_pt->pt_obj;
5179 if (pt->pt_obj != NULL)
5180 ++pt->pt_obj->obj_refcount;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005181 }
5182
5183 pt->pt_refcount = 1;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005184 if (arg_pt != NULL && arg_pt->pt_func != NULL)
5185 {
5186 pt->pt_func = arg_pt->pt_func;
5187 func_ptr_ref(pt->pt_func);
5188 vim_free(name);
5189 }
5190 else if (is_funcref)
5191 {
Bram Moolenaard9d2fd02022-01-13 21:15:21 +00005192 pt->pt_func = find_func(trans_name, is_global);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005193 func_ptr_ref(pt->pt_func);
5194 vim_free(name);
5195 }
5196 else
5197 {
5198 pt->pt_name = name;
5199 func_ref(name);
5200 }
Bram Moolenaar92368aa2022-02-07 17:50:39 +00005201
5202 if (arg_pt != NULL)
Bram Moolenaar7aca5ca2022-02-07 19:56:43 +00005203 {
5204 pt->pt_outer_partial = arg_pt;
5205 ++arg_pt->pt_refcount;
5206 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005207 }
5208 rettv->v_type = VAR_PARTIAL;
5209 rettv->vval.v_partial = pt;
5210 }
5211 else
5212 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005213 // result is a VAR_FUNC
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005214 rettv->v_type = VAR_FUNC;
5215 rettv->vval.v_string = name;
5216 func_ref(name);
5217 }
5218 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005219theend:
5220 vim_free(trans_name);
5221}
5222
5223/*
5224 * "funcref()" function
5225 */
5226 static void
5227f_funcref(typval_T *argvars, typval_T *rettv)
5228{
5229 common_function(argvars, rettv, TRUE);
5230}
5231
5232/*
5233 * "function()" function
5234 */
5235 static void
5236f_function(typval_T *argvars, typval_T *rettv)
5237{
5238 common_function(argvars, rettv, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005239}
5240
5241/*
5242 * "garbagecollect()" function
5243 */
5244 static void
5245f_garbagecollect(typval_T *argvars, typval_T *rettv UNUSED)
5246{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005247 if (in_vim9script() && check_for_opt_bool_arg(argvars, 0) == FAIL)
5248 return;
5249
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005250 // This is postponed until we are back at the toplevel, because we may be
5251 // using Lists and Dicts internally. E.g.: ":echo [garbagecollect()]".
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005252 want_garbage_collect = TRUE;
5253
Bram Moolenaar2df47312020-09-05 17:30:44 +02005254 if (argvars[0].v_type != VAR_UNKNOWN && tv_get_bool(&argvars[0]) == 1)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005255 garbage_collect_at_exit = TRUE;
5256}
5257
5258/*
5259 * "get()" function
5260 */
5261 static void
5262f_get(typval_T *argvars, typval_T *rettv)
5263{
5264 listitem_T *li;
5265 list_T *l;
5266 dictitem_T *di;
5267 dict_T *d;
5268 typval_T *tv = NULL;
Bram Moolenaarf91aac52019-07-28 13:21:01 +02005269 int what_is_dict = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005270
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005271 if (argvars[0].v_type == VAR_BLOB)
5272 {
5273 int error = FALSE;
5274 int idx = tv_get_number_chk(&argvars[1], &error);
5275
5276 if (!error)
5277 {
5278 rettv->v_type = VAR_NUMBER;
Bram Moolenaar2ea773b2019-01-15 22:16:42 +01005279 if (idx < 0)
5280 idx = blob_len(argvars[0].vval.v_blob) + idx;
5281 if (idx < 0 || idx >= blob_len(argvars[0].vval.v_blob))
5282 rettv->vval.v_number = -1;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005283 else
Bram Moolenaar2ea773b2019-01-15 22:16:42 +01005284 {
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005285 rettv->vval.v_number = blob_get(argvars[0].vval.v_blob, idx);
Bram Moolenaar2ea773b2019-01-15 22:16:42 +01005286 tv = rettv;
5287 }
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005288 }
5289 }
5290 else if (argvars[0].v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005291 {
5292 if ((l = argvars[0].vval.v_list) != NULL)
5293 {
5294 int error = FALSE;
5295
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005296 li = list_find(l, (long)tv_get_number_chk(&argvars[1], &error));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005297 if (!error && li != NULL)
5298 tv = &li->li_tv;
5299 }
5300 }
5301 else if (argvars[0].v_type == VAR_DICT)
5302 {
5303 if ((d = argvars[0].vval.v_dict) != NULL)
5304 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005305 di = dict_find(d, tv_get_string(&argvars[1]), -1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005306 if (di != NULL)
5307 tv = &di->di_tv;
5308 }
5309 }
5310 else if (argvars[0].v_type == VAR_PARTIAL || argvars[0].v_type == VAR_FUNC)
5311 {
5312 partial_T *pt;
5313 partial_T fref_pt;
5314
5315 if (argvars[0].v_type == VAR_PARTIAL)
5316 pt = argvars[0].vval.v_partial;
5317 else
5318 {
Bram Moolenaara80faa82020-04-12 19:37:17 +02005319 CLEAR_FIELD(fref_pt);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005320 fref_pt.pt_name = argvars[0].vval.v_string;
5321 pt = &fref_pt;
5322 }
5323
5324 if (pt != NULL)
5325 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005326 char_u *what = tv_get_string(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005327
5328 if (STRCMP(what, "func") == 0 || STRCMP(what, "name") == 0)
5329 {
Bram Moolenaar1ae8c262022-06-27 11:45:52 +01005330 char_u *name = partial_name(pt);
5331
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005332 rettv->v_type = (*what == 'f' ? VAR_FUNC : VAR_STRING);
Bram Moolenaar1ae8c262022-06-27 11:45:52 +01005333 if (name == NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005334 rettv->vval.v_string = NULL;
5335 else
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005336 {
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005337 if (rettv->v_type == VAR_FUNC)
Bram Moolenaar1ae8c262022-06-27 11:45:52 +01005338 func_ref(name);
5339 if (*what == 'n' && pt->pt_name == NULL
5340 && pt->pt_func != NULL)
5341 // use <SNR> instead of the byte code
5342 name = printable_func_name(pt->pt_func);
5343 rettv->vval.v_string = vim_strsave(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005344 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005345 }
5346 else if (STRCMP(what, "dict") == 0)
Bram Moolenaarf91aac52019-07-28 13:21:01 +02005347 {
5348 what_is_dict = TRUE;
5349 if (pt->pt_dict != NULL)
5350 rettv_dict_set(rettv, pt->pt_dict);
5351 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005352 else if (STRCMP(what, "args") == 0)
5353 {
5354 rettv->v_type = VAR_LIST;
5355 if (rettv_list_alloc(rettv) == OK)
5356 {
5357 int i;
5358
5359 for (i = 0; i < pt->pt_argc; ++i)
5360 list_append_tv(rettv->vval.v_list, &pt->pt_argv[i]);
5361 }
5362 }
LemonBoy48b7d052024-07-09 18:24:59 +02005363 else if (STRCMP(what, "arity") == 0)
5364 {
5365 int required = 0, optional = 0, varargs = FALSE;
5366 char_u *name = partial_name(pt);
5367
5368 get_func_arity(name, &required, &optional, &varargs);
5369
5370 rettv->v_type = VAR_DICT;
5371 if (rettv_dict_alloc(rettv) == OK)
5372 {
5373 dict_T *dict = rettv->vval.v_dict;
5374
5375 // Take into account the arguments of the partial, if any.
5376 // Note that it is possible to supply more arguments than the function
5377 // accepts.
5378 if (pt->pt_argc >= required + optional)
5379 required = optional = 0;
5380 else if (pt->pt_argc > required)
5381 {
5382 optional -= pt->pt_argc - required;
5383 required = 0;
5384 }
5385 else
5386 required -= pt->pt_argc;
5387
5388 dict_add_number(dict, "required", required);
5389 dict_add_number(dict, "optional", optional);
5390 dict_add_bool(dict, "varargs", varargs);
5391 }
5392 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005393 else
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00005394 semsg(_(e_invalid_argument_str), what);
Bram Moolenaarf91aac52019-07-28 13:21:01 +02005395
5396 // When {what} == "dict" and pt->pt_dict == NULL, evaluate the
5397 // third argument
5398 if (!what_is_dict)
5399 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005400 }
5401 }
5402 else
Bram Moolenaar460ae5d2022-01-01 14:19:49 +00005403 semsg(_(e_argument_of_str_must_be_list_dictionary_or_blob), "get()");
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005404
5405 if (tv == NULL)
5406 {
5407 if (argvars[2].v_type != VAR_UNKNOWN)
5408 copy_tv(&argvars[2], rettv);
5409 }
5410 else
5411 copy_tv(tv, rettv);
5412}
5413
Bram Moolenaarb5ae48e2016-08-12 22:23:25 +02005414/*
mikoto2000a73dfc22024-11-18 21:12:21 +01005415 * "getcellpixels()" function
5416 */
5417 static void
5418f_getcellpixels(typval_T *argvars UNUSED, typval_T *rettv)
5419{
5420 if (rettv_list_alloc(rettv) == FAIL)
5421 return;
5422
5423#if defined(FEAT_GUI)
5424 if (gui.in_use)
5425 {
5426 // success pixel size and no gui.
5427 list_append_number(rettv->vval.v_list, (varnumber_T)gui.char_width);
5428 list_append_number(rettv->vval.v_list, (varnumber_T)gui.char_height);
5429 }
5430 else
5431#endif
5432 {
5433 struct cellsize cs;
5434#if defined(UNIX)
5435 mch_calc_cell_size(&cs);
5436#else
5437 // Non-Unix CUIs are not supported, so set this to -1x-1.
5438 cs.cs_xpixel = -1;
5439 cs.cs_ypixel = -1;
5440#endif
5441
5442 // failed get pixel size.
5443 if (cs.cs_xpixel == -1)
5444 return;
5445
5446 // success pixel size and no gui.
5447 list_append_number(rettv->vval.v_list, (varnumber_T)cs.cs_xpixel);
5448 list_append_number(rettv->vval.v_list, (varnumber_T)cs.cs_ypixel);
5449 }
5450
5451}
5452
5453/*
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005454 * "getchangelist()" function
5455 */
5456 static void
5457f_getchangelist(typval_T *argvars, typval_T *rettv)
5458{
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005459 buf_T *buf;
5460 int i;
5461 list_T *l;
5462 dict_T *d;
LemonBoydb0ea7f2022-04-10 17:59:26 +01005463 int changelistindex;
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005464
Bram Moolenaar93a10962022-06-16 11:42:09 +01005465 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005466 return;
5467
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005468 if (in_vim9script() && check_for_opt_buffer_arg(argvars, 0) == FAIL)
5469 return;
5470
Bram Moolenaar4c313b12019-08-24 22:58:31 +02005471 if (argvars[0].v_type == VAR_UNKNOWN)
5472 buf = curbuf;
5473 else
Bram Moolenaara5d38412020-09-02 21:02:35 +02005474 buf = tv_get_buf_from_arg(&argvars[0]);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005475 if (buf == NULL)
5476 return;
5477
5478 l = list_alloc();
5479 if (l == NULL)
5480 return;
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005481 if (list_append_list(rettv->vval.v_list, l) == FAIL)
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005482 {
5483 vim_free(l);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005484 return;
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005485 }
5486
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005487 /*
LemonBoydb0ea7f2022-04-10 17:59:26 +01005488 * The current window change list index tracks only the position for the
5489 * current buffer. For other buffers use the stored index for the current
5490 * window, or, if that's not available, the change list length.
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005491 */
LemonBoydb0ea7f2022-04-10 17:59:26 +01005492 if (buf == curwin->w_buffer)
5493 {
5494 changelistindex = curwin->w_changelistidx;
5495 }
5496 else
5497 {
5498 wininfo_T *wip;
5499
5500 FOR_ALL_BUF_WININFO(buf, wip)
5501 if (wip->wi_win == curwin)
5502 break;
5503 changelistindex = wip != NULL ? wip->wi_changelistidx
5504 : buf->b_changelistlen;
5505 }
5506 list_append_number(rettv->vval.v_list, (varnumber_T)changelistindex);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005507
5508 for (i = 0; i < buf->b_changelistlen; ++i)
5509 {
5510 if (buf->b_changelist[i].lnum == 0)
5511 continue;
5512 if ((d = dict_alloc()) == NULL)
5513 return;
5514 if (list_append_dict(l, d) == FAIL)
5515 return;
Bram Moolenaare0be1672018-07-08 16:50:37 +02005516 dict_add_number(d, "lnum", (long)buf->b_changelist[i].lnum);
5517 dict_add_number(d, "col", (long)buf->b_changelist[i].col);
Bram Moolenaare0be1672018-07-08 16:50:37 +02005518 dict_add_number(d, "coladd", (long)buf->b_changelist[i].coladd);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005519 }
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005520}
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005521
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005522 static void
5523getpos_both(
5524 typval_T *argvars,
5525 typval_T *rettv,
5526 int getcurpos,
5527 int charcol)
5528{
5529 pos_T *fp = NULL;
5530 pos_T pos;
5531 win_T *wp = curwin;
5532 list_T *l;
5533 int fnum = -1;
5534
5535 if (rettv_list_alloc(rettv) == OK)
5536 {
5537 l = rettv->vval.v_list;
5538 if (getcurpos)
5539 {
5540 if (argvars[0].v_type != VAR_UNKNOWN)
5541 {
5542 wp = find_win_by_nr_or_id(&argvars[0]);
5543 if (wp != NULL)
5544 fp = &wp->w_cursor;
5545 }
5546 else
5547 fp = &curwin->w_cursor;
5548 if (fp != NULL && charcol)
5549 {
5550 pos = *fp;
Bram Moolenaar91458462021-01-13 20:08:38 +01005551 pos.col =
5552 buf_byteidx_to_charidx(wp->w_buffer, pos.lnum, pos.col);
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005553 fp = &pos;
5554 }
5555 }
5556 else
5557 fp = var2fpos(&argvars[0], TRUE, &fnum, charcol);
5558 if (fnum != -1)
5559 list_append_number(l, (varnumber_T)fnum);
5560 else
5561 list_append_number(l, (varnumber_T)0);
5562 list_append_number(l, (fp != NULL) ? (varnumber_T)fp->lnum
5563 : (varnumber_T)0);
5564 list_append_number(l, (fp != NULL)
5565 ? (varnumber_T)(fp->col == MAXCOL ? MAXCOL : fp->col + 1)
5566 : (varnumber_T)0);
5567 list_append_number(l, (fp != NULL) ? (varnumber_T)fp->coladd :
5568 (varnumber_T)0);
5569 if (getcurpos)
5570 {
5571 int save_set_curswant = curwin->w_set_curswant;
5572 colnr_T save_curswant = curwin->w_curswant;
5573 colnr_T save_virtcol = curwin->w_virtcol;
5574
5575 if (wp == curwin)
5576 update_curswant();
5577 list_append_number(l, wp == NULL ? 0 : wp->w_curswant == MAXCOL
5578 ? (varnumber_T)MAXCOL : (varnumber_T)wp->w_curswant + 1);
5579
5580 // Do not change "curswant", as it is unexpected that a get
5581 // function has a side effect.
5582 if (wp == curwin && save_set_curswant)
5583 {
5584 curwin->w_set_curswant = save_set_curswant;
5585 curwin->w_curswant = save_curswant;
5586 curwin->w_virtcol = save_virtcol;
5587 curwin->w_valid &= ~VALID_VIRTCOL;
5588 }
5589 }
5590 }
5591 else
5592 rettv->vval.v_number = FALSE;
5593}
5594
5595/*
5596 * "getcharpos()" function
5597 */
5598 static void
5599f_getcharpos(typval_T *argvars UNUSED, typval_T *rettv)
5600{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005601 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5602 return;
5603
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005604 getpos_both(argvars, rettv, FALSE, TRUE);
5605}
5606
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005607/*
5608 * "getcharsearch()" function
5609 */
5610 static void
5611f_getcharsearch(typval_T *argvars UNUSED, typval_T *rettv)
5612{
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00005613 if (rettv_dict_alloc(rettv) != OK)
5614 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005615
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00005616 dict_T *dict = rettv->vval.v_dict;
5617
5618 dict_add_string(dict, "char", last_csearch());
5619 dict_add_number(dict, "forward", last_csearch_forward());
5620 dict_add_number(dict, "until", last_csearch_until());
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005621}
5622
5623/*
Bram Moolenaar691ddee2019-05-09 14:52:41 +02005624 * "getenv()" function
5625 */
5626 static void
5627f_getenv(typval_T *argvars, typval_T *rettv)
5628{
5629 int mustfree = FALSE;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005630 char_u *p;
Bram Moolenaar691ddee2019-05-09 14:52:41 +02005631
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005632 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5633 return;
5634
5635 p = vim_getenv(tv_get_string(&argvars[0]), &mustfree);
Bram Moolenaar691ddee2019-05-09 14:52:41 +02005636 if (p == NULL)
5637 {
5638 rettv->v_type = VAR_SPECIAL;
5639 rettv->vval.v_number = VVAL_NULL;
5640 return;
5641 }
5642 if (!mustfree)
5643 p = vim_strsave(p);
5644 rettv->vval.v_string = p;
5645 rettv->v_type = VAR_STRING;
5646}
5647
5648/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005649 * "getfontname()" function
5650 */
5651 static void
5652f_getfontname(typval_T *argvars UNUSED, typval_T *rettv)
5653{
5654 rettv->v_type = VAR_STRING;
5655 rettv->vval.v_string = NULL;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005656
5657 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
5658 return;
5659
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005660#ifdef FEAT_GUI
5661 if (gui.in_use)
5662 {
5663 GuiFont font;
5664 char_u *name = NULL;
5665
5666 if (argvars[0].v_type == VAR_UNKNOWN)
5667 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005668 // Get the "Normal" font. Either the name saved by
5669 // hl_set_font_name() or from the font ID.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005670 font = gui.norm_font;
5671 name = hl_get_font_name();
5672 }
5673 else
5674 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005675 name = tv_get_string(&argvars[0]);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005676 if (STRCMP(name, "*") == 0) // don't use font dialog
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005677 return;
5678 font = gui_mch_get_font(name, FALSE);
5679 if (font == NOFONT)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005680 return; // Invalid font name, return empty string.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005681 }
5682 rettv->vval.v_string = gui_mch_get_fontname(font, name);
5683 if (argvars[0].v_type != VAR_UNKNOWN)
5684 gui_mch_free_font(font);
5685 }
5686#endif
5687}
5688
5689/*
Bram Moolenaar4f505882018-02-10 21:06:32 +01005690 * "getjumplist()" function
5691 */
5692 static void
5693f_getjumplist(typval_T *argvars, typval_T *rettv)
5694{
Bram Moolenaar4f505882018-02-10 21:06:32 +01005695 win_T *wp;
5696 int i;
5697 list_T *l;
5698 dict_T *d;
Bram Moolenaar4f505882018-02-10 21:06:32 +01005699
Bram Moolenaar93a10962022-06-16 11:42:09 +01005700 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar4f505882018-02-10 21:06:32 +01005701 return;
5702
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005703 if (in_vim9script()
5704 && (check_for_opt_number_arg(argvars, 0) == FAIL
5705 || (argvars[0].v_type != VAR_UNKNOWN
5706 && check_for_opt_number_arg(argvars, 1) == FAIL)))
5707 return;
5708
Bram Moolenaar00aa0692019-04-27 20:37:57 +02005709 wp = find_tabwin(&argvars[0], &argvars[1], NULL);
Bram Moolenaar4f505882018-02-10 21:06:32 +01005710 if (wp == NULL)
5711 return;
5712
Bram Moolenaar57ee2b62019-02-12 22:15:06 +01005713 cleanup_jumplist(wp, TRUE);
5714
Bram Moolenaar4f505882018-02-10 21:06:32 +01005715 l = list_alloc();
5716 if (l == NULL)
5717 return;
Bram Moolenaar4f505882018-02-10 21:06:32 +01005718 if (list_append_list(rettv->vval.v_list, l) == FAIL)
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005719 {
5720 vim_free(l);
Bram Moolenaar4f505882018-02-10 21:06:32 +01005721 return;
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005722 }
5723
Bram Moolenaar4f505882018-02-10 21:06:32 +01005724 list_append_number(rettv->vval.v_list, (varnumber_T)wp->w_jumplistidx);
5725
5726 for (i = 0; i < wp->w_jumplistlen; ++i)
5727 {
Bram Moolenaara7e18d22018-02-11 14:29:49 +01005728 if (wp->w_jumplist[i].fmark.mark.lnum == 0)
5729 continue;
Bram Moolenaar4f505882018-02-10 21:06:32 +01005730 if ((d = dict_alloc()) == NULL)
5731 return;
5732 if (list_append_dict(l, d) == FAIL)
5733 return;
Bram Moolenaare0be1672018-07-08 16:50:37 +02005734 dict_add_number(d, "lnum", (long)wp->w_jumplist[i].fmark.mark.lnum);
5735 dict_add_number(d, "col", (long)wp->w_jumplist[i].fmark.mark.col);
Bram Moolenaare0be1672018-07-08 16:50:37 +02005736 dict_add_number(d, "coladd", (long)wp->w_jumplist[i].fmark.mark.coladd);
Bram Moolenaare0be1672018-07-08 16:50:37 +02005737 dict_add_number(d, "bufnr", (long)wp->w_jumplist[i].fmark.fnum);
Bram Moolenaara7e18d22018-02-11 14:29:49 +01005738 if (wp->w_jumplist[i].fname != NULL)
Bram Moolenaare0be1672018-07-08 16:50:37 +02005739 dict_add_string(d, "filename", wp->w_jumplist[i].fname);
Bram Moolenaar4f505882018-02-10 21:06:32 +01005740 }
Bram Moolenaar4f505882018-02-10 21:06:32 +01005741}
5742
5743/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005744 * "getpid()" function
5745 */
5746 static void
5747f_getpid(typval_T *argvars UNUSED, typval_T *rettv)
5748{
5749 rettv->vval.v_number = mch_get_pid();
5750}
5751
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005752/*
5753 * "getcurpos()" function
5754 */
5755 static void
5756f_getcurpos(typval_T *argvars, typval_T *rettv)
5757{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005758 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
5759 return;
5760
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005761 getpos_both(argvars, rettv, TRUE, FALSE);
5762}
5763
5764 static void
5765f_getcursorcharpos(typval_T *argvars, typval_T *rettv)
5766{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005767 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
5768 return;
5769
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005770 getpos_both(argvars, rettv, TRUE, TRUE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005771}
5772
5773/*
5774 * "getpos(string)" function
5775 */
5776 static void
5777f_getpos(typval_T *argvars, typval_T *rettv)
5778{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005779 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5780 return;
5781
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005782 getpos_both(argvars, rettv, FALSE, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005783}
5784
5785/*
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005786 * Convert from block_def to string
5787 */
Gary Johnson88d4f252024-06-01 20:51:33 +02005788 static char_u *
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005789block_def2str(struct block_def *bd)
5790{
5791 char_u *p, *ret;
5792 size_t size = bd->startspaces + bd->endspaces + bd->textlen;
5793
5794 ret = alloc(size + 1);
5795 if (ret != NULL)
5796 {
5797 p = ret;
5798 vim_memset(p, ' ', bd->startspaces);
5799 p += bd->startspaces;
5800 mch_memmove(p, bd->textstart, bd->textlen);
5801 p += bd->textlen;
5802 vim_memset(p, ' ', bd->endspaces);
5803 *(p + bd->endspaces) = NUL;
5804 }
5805 return ret;
5806}
5807
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005808 static int
5809getregionpos(
5810 typval_T *argvars,
5811 typval_T *rettv,
zeertzjqc95e64f2024-05-20 14:00:31 +02005812 pos_T *p1,
5813 pos_T *p2,
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005814 int *inclusive,
5815 int *region_type,
zeertzjqafc22952024-05-24 19:07:12 +02005816 oparg_T *oap)
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005817{
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005818 int fnum1 = -1, fnum2 = -1;
5819 char_u *type;
5820 buf_T *findbuf;
5821 char_u default_type[] = "v";
zeertzjqafc22952024-05-24 19:07:12 +02005822 int block_width = 0;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005823 int is_select_exclusive;
5824 int l;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005825
5826 if (rettv_list_alloc(rettv) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005827 return FAIL;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005828
Shougo Matsushita19b71882024-02-28 22:48:12 +01005829 if (check_for_list_arg(argvars, 0) == FAIL
5830 || check_for_list_arg(argvars, 1) == FAIL
5831 || check_for_opt_dict_arg(argvars, 2) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005832 return FAIL;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005833
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005834 if (list2fpos(&argvars[0], p1, &fnum1, NULL, FALSE) != OK
5835 || list2fpos(&argvars[1], p2, &fnum2, NULL, FALSE) != OK
Shougo Matsushita84bf6e62024-03-06 21:10:18 +01005836 || fnum1 != fnum2)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005837 return FAIL;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005838
Shougo Matsushita19b71882024-02-28 22:48:12 +01005839 if (argvars[2].v_type == VAR_DICT)
5840 {
5841 is_select_exclusive = dict_get_bool(
5842 argvars[2].vval.v_dict, "exclusive", *p_sel == 'e');
5843 type = dict_get_string(
5844 argvars[2].vval.v_dict, "type", FALSE);
5845 if (type == NULL)
5846 type = default_type;
5847 }
5848 else
5849 {
5850 is_select_exclusive = *p_sel == 'e';
5851 type = default_type;
5852 }
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005853
5854 if (type[0] == 'v' && type[1] == NUL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005855 *region_type = MCHAR;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005856 else if (type[0] == 'V' && type[1] == NUL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005857 *region_type = MLINE;
zeertzjqafc22952024-05-24 19:07:12 +02005858 else if (type[0] == Ctrl_V)
5859 {
5860 char_u *p = type + 1;
5861
5862 if (*p != NUL && ((block_width = getdigits(&p)) <= 0 || *p != NUL))
5863 {
5864 semsg(_(e_invalid_value_for_argument_str_str), "type", type);
5865 return FAIL;
5866 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005867 *region_type = MBLOCK;
zeertzjqafc22952024-05-24 19:07:12 +02005868 }
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005869 else
zeertzjq26dd09a2024-03-10 15:46:58 +01005870 {
5871 semsg(_(e_invalid_value_for_argument_str_str), "type", type);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005872 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01005873 }
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005874
zeertzjq5406eb82024-03-11 21:36:42 +01005875 findbuf = fnum1 != 0 ? buflist_findnr(fnum1) : curbuf;
5876 if (findbuf == NULL || findbuf->b_ml.ml_mfp == NULL)
Shougo Matsushita84bf6e62024-03-06 21:10:18 +01005877 {
zeertzjq5406eb82024-03-11 21:36:42 +01005878 emsg(_(e_buffer_is_not_loaded));
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005879 return FAIL;
Shougo Matsushita84bf6e62024-03-06 21:10:18 +01005880 }
5881
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005882 if (p1->lnum < 1 || p1->lnum > findbuf->b_ml.ml_line_count)
zeertzjq26dd09a2024-03-10 15:46:58 +01005883 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005884 semsg(_(e_invalid_line_number_nr), p1->lnum);
5885 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01005886 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005887 if (p1->col == MAXCOL)
5888 p1->col = ml_get_buf_len(findbuf, p1->lnum) + 1;
5889 else if (p1->col < 1 || p1->col > ml_get_buf_len(findbuf, p1->lnum) + 1)
zeertzjq26dd09a2024-03-10 15:46:58 +01005890 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005891 semsg(_(e_invalid_column_number_nr), p1->col);
5892 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01005893 }
zeertzjq2ffdae72024-05-02 13:06:24 +02005894
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005895 if (p2->lnum < 1 || p2->lnum > findbuf->b_ml.ml_line_count)
zeertzjq26dd09a2024-03-10 15:46:58 +01005896 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005897 semsg(_(e_invalid_line_number_nr), p2->lnum);
5898 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01005899 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005900 if (p2->col == MAXCOL)
5901 p2->col = ml_get_buf_len(findbuf, p2->lnum) + 1;
5902 else if (p2->col < 1 || p2->col > ml_get_buf_len(findbuf, p2->lnum) + 1)
zeertzjq26dd09a2024-03-10 15:46:58 +01005903 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005904 semsg(_(e_invalid_column_number_nr), p2->col);
5905 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01005906 }
5907
5908 curbuf = findbuf;
zeertzjq5406eb82024-03-11 21:36:42 +01005909 curwin->w_buffer = curbuf;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005910 virtual_op = virtual_active();
5911
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005912 // NOTE: Adjustment is needed.
5913 p1->col--;
5914 p2->col--;
Shougo Matsushita19b71882024-02-28 22:48:12 +01005915
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005916 if (!LT_POS(*p1, *p2))
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005917 {
5918 // swap position
5919 pos_T p;
5920
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005921 p = *p1;
5922 *p1 = *p2;
5923 *p2 = p;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005924 }
5925
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005926 if (*region_type == MCHAR)
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005927 {
zeertzjq701ad502024-05-23 07:47:55 +02005928 // Handle 'selection' == "exclusive".
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005929 if (is_select_exclusive && !EQUAL_POS(*p1, *p2))
zeertzjq701ad502024-05-23 07:47:55 +02005930 // When backing up to previous line, inclusive becomes false.
5931 *inclusive = !unadjust_for_sel_inner(p2);
5932 // If p2 is on NUL (end of line), inclusive becomes false.
5933 if (*inclusive && !virtual_op && *ml_get_pos(p2) == NUL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005934 *inclusive = FALSE;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005935 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005936 else if (*region_type == MBLOCK)
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005937 {
5938 colnr_T sc1, ec1, sc2, ec2;
5939
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005940 getvvcol(curwin, p1, &sc1, NULL, &ec1);
5941 getvvcol(curwin, p2, &sc2, NULL, &ec2);
zeertzjqafc22952024-05-24 19:07:12 +02005942 oap->motion_type = MBLOCK;
5943 oap->inclusive = TRUE;
5944 oap->op_type = OP_NOP;
5945 oap->start = *p1;
5946 oap->end = *p2;
5947 oap->start_vcol = MIN(sc1, sc2);
5948 if (block_width > 0)
5949 oap->end_vcol = oap->start_vcol + block_width - 1;
5950 else if (is_select_exclusive && ec1 < sc2 && 0 < sc2 && ec2 > ec1)
5951 oap->end_vcol = sc2 - 1;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005952 else
zeertzjqafc22952024-05-24 19:07:12 +02005953 oap->end_vcol = MAX(ec1, ec2);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005954 }
5955
5956 // Include the trailing byte of a multi-byte char.
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005957 l = mb_ptr2len((char_u *)ml_get_pos(p2));
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005958 if (l > 1)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005959 p2->col += l - 1;
5960
5961 return OK;
5962}
5963
5964/*
5965 * "getregion()" function
5966 */
5967 static void
5968f_getregion(typval_T *argvars, typval_T *rettv)
5969{
5970 pos_T p1, p2;
5971 int inclusive = TRUE;
5972 int region_type = -1;
5973 oparg_T oa;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005974
5975 buf_T *save_curbuf;
5976 int save_virtual;
5977 char_u *akt = NULL;
5978 linenr_T lnum;
5979
5980 save_curbuf = curbuf;
5981 save_virtual = virtual_op;
5982
5983 if (getregionpos(argvars, rettv,
zeertzjqc95e64f2024-05-20 14:00:31 +02005984 &p1, &p2, &inclusive, &region_type, &oa) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005985 return;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005986
5987 for (lnum = p1.lnum; lnum <= p2.lnum; lnum++)
5988 {
5989 int ret = 0;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005990 struct block_def bd;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005991
5992 if (region_type == MLINE)
5993 akt = vim_strsave(ml_get(lnum));
5994 else if (region_type == MBLOCK)
5995 {
zeertzjq5e3674b2024-02-22 19:51:34 +01005996 block_prep(&oa, &bd, lnum, FALSE);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005997 akt = block_def2str(&bd);
5998 }
5999 else if (p1.lnum < lnum && lnum < p2.lnum)
6000 akt = vim_strsave(ml_get(lnum));
6001 else
6002 {
6003 charwise_block_prep(p1, p2, &bd, lnum, inclusive);
6004 akt = block_def2str(&bd);
6005 }
6006
6007 if (akt)
6008 {
6009 ret = list_append_string(rettv->vval.v_list, akt, -1);
6010 vim_free(akt);
6011 }
6012
6013 if (akt == NULL || ret == FAIL)
6014 {
zeertzjq5e3674b2024-02-22 19:51:34 +01006015 clear_tv(rettv);
6016 (void)rettv_list_alloc(rettv);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006017 break;
6018 }
6019 }
6020
zeertzjqc95e64f2024-05-20 14:00:31 +02006021 // getregionpos() may change curbuf and virtual_op
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006022 curbuf = save_curbuf;
6023 curwin->w_buffer = curbuf;
6024 virtual_op = save_virtual;
6025}
6026
6027 static void
zeertzjqc95e64f2024-05-20 14:00:31 +02006028add_regionpos_range(typval_T *rettv, pos_T p1, pos_T p2)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006029{
6030 list_T *l1, *l2, *l3;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006031
6032 l1 = list_alloc();
6033 if (l1 == NULL)
6034 return;
6035
6036 if (list_append_list(rettv->vval.v_list, l1) == FAIL)
6037 {
6038 vim_free(l1);
6039 return;
6040 }
6041
6042 l2 = list_alloc();
6043 if (l2 == NULL)
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006044 {
6045 vim_free(l1);
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, l2) == FAIL)
6050 {
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006051 vim_free(l1);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006052 vim_free(l2);
6053 return;
6054 }
6055
6056 l3 = list_alloc();
6057 if (l3 == NULL)
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006058 {
6059 vim_free(l1);
6060 vim_free(l2);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006061 return;
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006062 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006063
6064 if (list_append_list(l1, l3) == FAIL)
6065 {
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006066 vim_free(l1);
6067 vim_free(l2);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006068 vim_free(l3);
6069 return;
6070 }
6071
zeertzjqc95e64f2024-05-20 14:00:31 +02006072 list_append_number(l2, curbuf->b_fnum);
6073 list_append_number(l2, p1.lnum);
zeertzjq2b09de92024-05-24 07:48:51 +02006074 list_append_number(l2, p1.col);
zeertzjqc95e64f2024-05-20 14:00:31 +02006075 list_append_number(l2, p1.coladd);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006076
zeertzjqc95e64f2024-05-20 14:00:31 +02006077 list_append_number(l3, curbuf->b_fnum);
6078 list_append_number(l3, p2.lnum);
zeertzjq2b09de92024-05-24 07:48:51 +02006079 list_append_number(l3, p2.col);
zeertzjqc95e64f2024-05-20 14:00:31 +02006080 list_append_number(l3, p2.coladd);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006081}
6082
6083/*
6084 * "getregionpos()" function
6085 */
6086 static void
6087f_getregionpos(typval_T *argvars, typval_T *rettv)
6088{
6089 pos_T p1, p2;
6090 int inclusive = TRUE;
6091 int region_type = -1;
zeertzjq2b09de92024-05-24 07:48:51 +02006092 int allow_eol = FALSE;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006093 oparg_T oa;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006094 int lnum;
6095
6096 buf_T *save_curbuf;
6097 int save_virtual;
6098
6099 save_curbuf = curbuf;
6100 save_virtual = virtual_op;
6101
6102 if (getregionpos(argvars, rettv,
zeertzjqc95e64f2024-05-20 14:00:31 +02006103 &p1, &p2, &inclusive, &region_type, &oa) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006104 return;
6105
zeertzjq2b09de92024-05-24 07:48:51 +02006106 if (argvars[2].v_type == VAR_DICT)
6107 allow_eol = dict_get_bool(argvars[2].vval.v_dict, "eol", FALSE);
6108
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006109 for (lnum = p1.lnum; lnum <= p2.lnum; lnum++)
6110 {
zeertzjq2b09de92024-05-24 07:48:51 +02006111 pos_T ret_p1, ret_p2;
zeertzjqef733742024-05-26 18:42:18 +02006112 char_u *line = ml_get(lnum);
zeertzjq2b09de92024-05-24 07:48:51 +02006113 colnr_T line_len = ml_get_len(lnum);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006114
6115 if (region_type == MLINE)
6116 {
zeertzjqc95e64f2024-05-20 14:00:31 +02006117 ret_p1.col = 1;
6118 ret_p1.coladd = 0;
6119 ret_p2.col = MAXCOL;
6120 ret_p2.coladd = 0;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006121 }
6122 else
6123 {
zeertzjq52a6f342024-05-22 16:42:44 +02006124 struct block_def bd;
6125
zeertzjqc95e64f2024-05-20 14:00:31 +02006126 if (region_type == MBLOCK)
6127 block_prep(&oa, &bd, lnum, FALSE);
6128 else
6129 charwise_block_prep(p1, p2, &bd, lnum, inclusive);
zeertzjq52a6f342024-05-22 16:42:44 +02006130
6131 if (bd.is_oneChar) // selection entirely inside one char
6132 {
6133 if (region_type == MBLOCK)
6134 {
zeertzjqef733742024-05-26 18:42:18 +02006135 ret_p1.col = mb_prevptr(line, bd.textstart) - line + 1;
zeertzjq52a6f342024-05-22 16:42:44 +02006136 ret_p1.coladd = bd.start_char_vcols
6137 - (bd.start_vcol - oa.start_vcol);
6138 }
6139 else
6140 {
6141 ret_p1.col = p1.col + 1;
6142 ret_p1.coladd = p1.coladd;
6143 }
6144 }
zeertzjq2b09de92024-05-24 07:48:51 +02006145 else if (region_type == MBLOCK && oa.start_vcol > bd.start_vcol)
6146 {
6147 // blockwise selection entirely beyond end of line
6148 ret_p1.col = MAXCOL;
6149 ret_p1.coladd = oa.start_vcol - bd.start_vcol;
6150 bd.is_oneChar = TRUE;
6151 }
zeertzjq52a6f342024-05-22 16:42:44 +02006152 else if (bd.startspaces > 0)
zeertzjqc95e64f2024-05-20 14:00:31 +02006153 {
zeertzjqef733742024-05-26 18:42:18 +02006154 ret_p1.col = mb_prevptr(line, bd.textstart) - line + 1;
zeertzjqc95e64f2024-05-20 14:00:31 +02006155 ret_p1.coladd = bd.start_char_vcols - bd.startspaces;
6156 }
6157 else
6158 {
6159 ret_p1.col = bd.textcol + 1;
6160 ret_p1.coladd = 0;
6161 }
zeertzjq52a6f342024-05-22 16:42:44 +02006162
6163 if (bd.is_oneChar) // selection entirely inside one char
6164 {
6165 ret_p2.col = ret_p1.col;
zeertzjq2b09de92024-05-24 07:48:51 +02006166 ret_p2.coladd = ret_p1.coladd + bd.startspaces + bd.endspaces;
zeertzjq52a6f342024-05-22 16:42:44 +02006167 }
6168 else if (bd.endspaces > 0)
zeertzjqc95e64f2024-05-20 14:00:31 +02006169 {
6170 ret_p2.col = bd.textcol + bd.textlen + 1;
6171 ret_p2.coladd = bd.endspaces;
6172 }
6173 else
6174 {
6175 ret_p2.col = bd.textcol + bd.textlen;
6176 ret_p2.coladd = 0;
6177 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006178 }
6179
zeertzjq2b09de92024-05-24 07:48:51 +02006180 if (!allow_eol && ret_p1.col > line_len)
6181 {
6182 ret_p1.col = 0;
6183 ret_p1.coladd = 0;
6184 }
6185 else if (ret_p1.col > line_len + 1)
6186 ret_p1.col = line_len + 1;
6187
6188 if (!allow_eol && ret_p2.col > line_len)
6189 {
6190 ret_p2.col = ret_p1.col == 0 ? 0 : line_len;
6191 ret_p2.coladd = 0;
6192 }
6193 else if (ret_p2.col > line_len + 1)
6194 ret_p2.col = line_len + 1;
6195
zeertzjqc95e64f2024-05-20 14:00:31 +02006196 ret_p1.lnum = lnum;
6197 ret_p2.lnum = lnum;
6198 add_regionpos_range(rettv, ret_p1, ret_p2);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006199 }
6200
6201 // getregionpos() may change curbuf and virtual_op
zeertzjq5406eb82024-03-11 21:36:42 +01006202 curbuf = save_curbuf;
6203 curwin->w_buffer = curbuf;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006204 virtual_op = save_virtual;
6205}
6206
6207/*
zeertzjqd3f00f52021-12-24 12:02:43 +00006208 * Common between getreg(), getreginfo() and getregtype(): get the register
6209 * name from the first argument.
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006210 * Returns zero on error.
6211 */
6212 static int
6213getreg_get_regname(typval_T *argvars)
6214{
6215 char_u *strregname;
6216
6217 if (argvars[0].v_type != VAR_UNKNOWN)
6218 {
6219 strregname = tv_get_string_chk(&argvars[0]);
6220 if (strregname != NULL && in_vim9script() && STRLEN(strregname) > 1)
6221 {
6222 semsg(_(e_register_name_must_be_one_char_str), strregname);
6223 strregname = NULL;
6224 }
6225 if (strregname == NULL) // type error; errmsg already given
6226 return 0;
6227 }
6228 else
6229 // Default to v:register
6230 strregname = get_vim_var_str(VV_REG);
6231
6232 return *strregname == 0 ? '"' : *strregname;
6233}
6234
6235/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006236 * "getreg()" function
6237 */
6238 static void
6239f_getreg(typval_T *argvars, typval_T *rettv)
6240{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006241 int regname;
6242 int arg2 = FALSE;
6243 int return_list = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006244
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02006245 if (in_vim9script()
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006246 && (check_for_opt_string_arg(argvars, 0) == FAIL
6247 || (argvars[0].v_type != VAR_UNKNOWN
6248 && (check_for_opt_bool_arg(argvars, 1) == FAIL
6249 || (argvars[1].v_type != VAR_UNKNOWN
6250 && check_for_opt_bool_arg(argvars, 2) == FAIL)))))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02006251 return;
6252
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006253 regname = getreg_get_regname(argvars);
6254 if (regname == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006255 return;
6256
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006257 if (argvars[0].v_type != VAR_UNKNOWN && argvars[1].v_type != VAR_UNKNOWN)
6258 {
6259 int error = FALSE;
6260
6261 arg2 = (int)tv_get_bool_chk(&argvars[1], &error);
6262
6263 if (!error && argvars[2].v_type != VAR_UNKNOWN)
6264 return_list = (int)tv_get_bool_chk(&argvars[2], &error);
6265 if (error)
6266 return;
6267 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006268
6269 if (return_list)
6270 {
6271 rettv->v_type = VAR_LIST;
6272 rettv->vval.v_list = (list_T *)get_reg_contents(regname,
6273 (arg2 ? GREG_EXPR_SRC : 0) | GREG_LIST);
6274 if (rettv->vval.v_list == NULL)
6275 (void)rettv_list_alloc(rettv);
6276 else
6277 ++rettv->vval.v_list->lv_refcount;
6278 }
6279 else
6280 {
6281 rettv->v_type = VAR_STRING;
6282 rettv->vval.v_string = get_reg_contents(regname,
6283 arg2 ? GREG_EXPR_SRC : 0);
6284 }
6285}
6286
6287/*
6288 * "getregtype()" function
6289 */
6290 static void
6291f_getregtype(typval_T *argvars, typval_T *rettv)
6292{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006293 int regname;
6294 char_u buf[NUMBUFLEN + 2];
6295 long reglen = 0;
6296
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006297 // on error return an empty string
6298 rettv->v_type = VAR_STRING;
6299 rettv->vval.v_string = NULL;
6300
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006301 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
6302 return;
6303
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006304 regname = getreg_get_regname(argvars);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006305 if (regname == 0)
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006306 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006307
6308 buf[0] = NUL;
6309 buf[1] = NUL;
6310 switch (get_reg_type(regname, &reglen))
6311 {
6312 case MLINE: buf[0] = 'V'; break;
6313 case MCHAR: buf[0] = 'v'; break;
6314 case MBLOCK:
6315 buf[0] = Ctrl_V;
6316 sprintf((char *)buf + 1, "%ld", reglen + 1);
6317 break;
6318 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006319 rettv->vval.v_string = vim_strsave(buf);
6320}
6321
Bram Moolenaarb5ae48e2016-08-12 22:23:25 +02006322/*
Bram Moolenaarf49cc602018-11-11 15:21:05 +01006323 * "gettagstack()" function
6324 */
6325 static void
6326f_gettagstack(typval_T *argvars, typval_T *rettv)
6327{
6328 win_T *wp = curwin; // default is current window
6329
Bram Moolenaar93a10962022-06-16 11:42:09 +01006330 if (rettv_dict_alloc(rettv) == FAIL)
Bram Moolenaarf49cc602018-11-11 15:21:05 +01006331 return;
6332
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006333 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
6334 return;
6335
Bram Moolenaarf49cc602018-11-11 15:21:05 +01006336 if (argvars[0].v_type != VAR_UNKNOWN)
6337 {
6338 wp = find_win_by_nr_or_id(&argvars[0]);
6339 if (wp == NULL)
6340 return;
6341 }
6342
6343 get_tagstack(wp, rettv->vval.v_dict);
6344}
6345
Bram Moolenaar0b39c3f2020-08-30 15:52:10 +02006346/*
6347 * "gettext()" function
6348 */
6349 static void
6350f_gettext(typval_T *argvars, typval_T *rettv)
6351{
Christ van Willegence0ef912024-06-20 23:41:59 +02006352#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
6353 char *prev = NULL;
6354#endif
6355
6356 if (check_for_nonempty_string_arg(argvars, 0) == FAIL
6357 || check_for_opt_string_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006358 return;
6359
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +01006360 rettv->v_type = VAR_STRING;
Christ van Willegence0ef912024-06-20 23:41:59 +02006361
6362 if (argvars[1].v_type == VAR_STRING &&
6363 argvars[1].vval.v_string != NULL &&
6364 *(argvars[1].vval.v_string) != NUL)
6365 {
6366#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
6367 prev = bind_textdomain_codeset((const char *)argvars[1].vval.v_string, (char *)p_enc);
6368#endif
6369
6370#if defined(HAVE_DGETTEXT)
6371 rettv->vval.v_string = vim_strsave((char_u *)dgettext((const char *)argvars[1].vval.v_string, (const char *)argvars[0].vval.v_string));
6372#else
6373 textdomain((const char *)argvars[1].vval.v_string);
6374 rettv->vval.v_string = vim_strsave((char_u *)_(argvars[0].vval.v_string));
6375 textdomain(VIMPACKAGE);
6376#endif
6377
6378#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
6379 if (prev != NULL)
6380 bind_textdomain_codeset((const char *)argvars[1].vval.v_string, prev);
6381#endif
6382 }
6383 else
6384 rettv->vval.v_string = vim_strsave((char_u *)_(argvars[0].vval.v_string));
Bram Moolenaar0b39c3f2020-08-30 15:52:10 +02006385}
6386
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01006387// for VIM_VERSION_ defines
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006388#include "version.h"
6389
6390/*
6391 * "has()" function
6392 */
Bram Moolenaara259d8d2020-01-31 20:10:50 +01006393 void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006394f_has(typval_T *argvars, typval_T *rettv)
6395{
6396 int i;
6397 char_u *name;
Bram Moolenaar79296512020-03-22 16:17:14 +01006398 int x = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006399 int n = FALSE;
Bram Moolenaar79296512020-03-22 16:17:14 +01006400 typedef struct {
6401 char *name;
6402 short present;
6403 } has_item_T;
6404 static has_item_T has_list[] =
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006405 {
Bram Moolenaar79296512020-03-22 16:17:14 +01006406 {"amiga",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006407#ifdef AMIGA
Bram Moolenaar79296512020-03-22 16:17:14 +01006408 1
Bram Moolenaar39536dd2019-01-29 22:58:21 +01006409#else
Bram Moolenaar79296512020-03-22 16:17:14 +01006410 0
Bram Moolenaar39536dd2019-01-29 22:58:21 +01006411#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006412 },
6413 {"arp",
6414#if defined(AMIGA) && defined(FEAT_ARP)
6415 1
6416#else
6417 0
6418#endif
6419 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006420 {"haiku",
6421#ifdef __HAIKU__
6422 1
6423#else
6424 0
6425#endif
6426 },
6427 {"bsd",
6428#if defined(BSD) && !defined(MACOS_X)
6429 1
6430#else
6431 0
6432#endif
6433 },
6434 {"hpux",
6435#ifdef hpux
6436 1
6437#else
6438 0
6439#endif
6440 },
6441 {"linux",
6442#ifdef __linux__
6443 1
6444#else
6445 0
6446#endif
6447 },
6448 {"mac", // Mac OS X (and, once, Mac OS Classic)
6449#ifdef MACOS_X
6450 1
6451#else
6452 0
6453#endif
6454 },
6455 {"osx", // Mac OS X
6456#ifdef MACOS_X
6457 1
6458#else
6459 0
6460#endif
6461 },
6462 {"macunix", // Mac OS X, with the darwin feature
6463#if defined(MACOS_X) && defined(MACOS_X_DARWIN)
6464 1
6465#else
6466 0
6467#endif
6468 },
6469 {"osxdarwin", // synonym for macunix
6470#if defined(MACOS_X) && defined(MACOS_X_DARWIN)
6471 1
6472#else
6473 0
6474#endif
6475 },
6476 {"qnx",
6477#ifdef __QNX__
6478 1
6479#else
6480 0
6481#endif
6482 },
6483 {"sun",
6484#ifdef SUN_SYSTEM
6485 1
6486#else
6487 0
6488#endif
6489 },
6490 {"unix",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006491#ifdef UNIX
Bram Moolenaar79296512020-03-22 16:17:14 +01006492 1
6493#else
6494 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006495#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006496 },
6497 {"vms",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006498#ifdef VMS
Bram Moolenaar79296512020-03-22 16:17:14 +01006499 1
6500#else
6501 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006502#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006503 },
6504 {"win32",
Bram Moolenaar4f974752019-02-17 17:44:42 +01006505#ifdef MSWIN
Bram Moolenaar79296512020-03-22 16:17:14 +01006506 1
6507#else
6508 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006509#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006510 },
6511 {"win32unix",
K.Takata972db232022-02-04 10:45:38 +00006512#ifdef WIN32UNIX
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 {"win64",
Bram Moolenaar44b443c2019-02-18 22:14:18 +01006519#ifdef _WIN64
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 },
Bram Moolenaar424bcae2022-01-31 14:59:41 +00006525 {"ebcdic", 0 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006526 {"fname_case",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006527#ifndef CASE_INSENSITIVE_FILENAME
Bram Moolenaar79296512020-03-22 16:17:14 +01006528 1
6529#else
6530 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006531#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006532 },
6533 {"acl",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006534#ifdef HAVE_ACL
Bram Moolenaar79296512020-03-22 16:17:14 +01006535 1
6536#else
6537 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006538#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006539 },
6540 {"arabic",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006541#ifdef FEAT_ARABIC
Bram Moolenaar79296512020-03-22 16:17:14 +01006542 1
6543#else
6544 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006545#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006546 },
6547 {"autocmd", 1},
6548 {"autochdir",
Bram Moolenaar83ec2a72018-07-27 22:08:59 +02006549#ifdef FEAT_AUTOCHDIR
Bram Moolenaar79296512020-03-22 16:17:14 +01006550 1
6551#else
6552 0
Bram Moolenaar83ec2a72018-07-27 22:08:59 +02006553#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006554 },
6555 {"autoservername",
Bram Moolenaare42a6d22017-11-12 19:21:51 +01006556#ifdef FEAT_AUTOSERVERNAME
Bram Moolenaar79296512020-03-22 16:17:14 +01006557 1
6558#else
6559 0
Bram Moolenaare42a6d22017-11-12 19:21:51 +01006560#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006561 },
6562 {"balloon_eval",
Bram Moolenaarc3719bd2017-11-18 22:13:31 +01006563#ifdef FEAT_BEVAL_GUI
Bram Moolenaar79296512020-03-22 16:17:14 +01006564 1
6565#else
6566 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006567#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006568 },
6569 {"balloon_multiline",
Bram Moolenaar0bd663a2022-01-22 10:24:47 +00006570#ifdef FEAT_BEVAL_GUI
Bram Moolenaar79296512020-03-22 16:17:14 +01006571 1
6572#else
6573 0
6574#endif
6575 },
6576 {"balloon_eval_term",
Bram Moolenaarc3719bd2017-11-18 22:13:31 +01006577#ifdef FEAT_BEVAL_TERM
Bram Moolenaar79296512020-03-22 16:17:14 +01006578 1
6579#else
6580 0
Bram Moolenaar51b0f372017-11-18 18:52:04 +01006581#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006582 },
Bram Moolenaar2ee347f2022-08-26 17:53:44 +01006583 {"builtin_terms", 1},
6584 {"all_builtin_terms", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006585 {"browsefilter",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006586#if defined(FEAT_BROWSE) && (defined(USE_FILE_CHOOSER) \
Bram Moolenaar4f974752019-02-17 17:44:42 +01006587 || defined(FEAT_GUI_MSWIN) \
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006588 || defined(FEAT_GUI_MOTIF))
Bram Moolenaar79296512020-03-22 16:17:14 +01006589 1
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006590#else
Bram Moolenaar79296512020-03-22 16:17:14 +01006591 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006592#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006593 },
6594 {"byte_offset",
6595#ifdef FEAT_BYTEOFF
6596 1
6597#else
6598 0
6599#endif
6600 },
6601 {"channel",
6602#ifdef FEAT_JOB_CHANNEL
6603 1
6604#else
6605 0
6606#endif
6607 },
Bram Moolenaar8e145b82022-05-21 20:17:31 +01006608 {"cindent", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006609 {"clientserver",
6610#ifdef FEAT_CLIENTSERVER
6611 1
6612#else
6613 0
6614#endif
6615 },
6616 {"clipboard",
6617#ifdef FEAT_CLIPBOARD
6618 1
6619#else
6620 0
6621#endif
6622 },
6623 {"cmdline_compl", 1},
6624 {"cmdline_hist", 1},
Martin Tournoij7904fa42022-10-04 16:28:45 +01006625 {"cmdwin", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006626 {"comments", 1},
6627 {"conceal",
6628#ifdef FEAT_CONCEAL
6629 1
6630#else
6631 0
6632#endif
6633 },
6634 {"cryptv",
6635#ifdef FEAT_CRYPT
6636 1
6637#else
6638 0
6639#endif
6640 },
6641 {"crypt-blowfish",
6642#ifdef FEAT_CRYPT
6643 1
6644#else
6645 0
6646#endif
6647 },
6648 {"crypt-blowfish2",
6649#ifdef FEAT_CRYPT
6650 1
6651#else
6652 0
6653#endif
6654 },
6655 {"cscope",
6656#ifdef FEAT_CSCOPE
6657 1
6658#else
6659 0
6660#endif
6661 },
6662 {"cursorbind", 1},
6663 {"cursorshape",
6664#ifdef CURSOR_SHAPE
6665 1
6666#else
6667 0
6668#endif
6669 },
6670 {"debug",
6671#ifdef DEBUG
6672 1
6673#else
6674 0
6675#endif
6676 },
6677 {"dialog_con",
6678#ifdef FEAT_CON_DIALOG
6679 1
6680#else
6681 0
6682#endif
6683 },
glepnirdf461152024-04-04 22:23:29 +02006684 {"dialog_con_gui",
6685#if defined(FEAT_CON_DIALOG) && defined(FEAT_GUI_DIALOG)
6686 1
6687#else
6688 0
6689#endif
6690 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006691 {"dialog_gui",
6692#ifdef FEAT_GUI_DIALOG
6693 1
6694#else
6695 0
6696#endif
6697 },
6698 {"diff",
6699#ifdef FEAT_DIFF
6700 1
6701#else
6702 0
6703#endif
6704 },
6705 {"digraphs",
6706#ifdef FEAT_DIGRAPHS
6707 1
6708#else
6709 0
6710#endif
6711 },
6712 {"directx",
6713#ifdef FEAT_DIRECTX
6714 1
6715#else
6716 0
6717#endif
6718 },
6719 {"dnd",
6720#ifdef FEAT_DND
6721 1
6722#else
6723 0
6724#endif
6725 },
Bram Moolenaar1d1ce612021-06-27 19:02:52 +02006726 {"drop_file",
6727#ifdef HAVE_DROP_FILE
6728 1
6729#else
6730 0
6731#endif
6732 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006733 {"emacs_tags",
6734#ifdef FEAT_EMACS_TAGS
6735 1
6736#else
6737 0
6738#endif
6739 },
6740 {"eval", 1}, // always present, of course!
6741 {"ex_extra", 1}, // graduated feature
6742 {"extra_search",
6743#ifdef FEAT_SEARCH_EXTRA
6744 1
6745#else
6746 0
6747#endif
6748 },
Bram Moolenaarf80f40a2022-08-25 16:02:23 +01006749 {"file_in_path", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006750 {"filterpipe",
6751#if defined(FEAT_FILTERPIPE) && !defined(VIMDLL)
6752 1
6753#else
6754 0
6755#endif
6756 },
6757 {"find_in_path",
6758#ifdef FEAT_FIND_ID
6759 1
6760#else
6761 0
6762#endif
6763 },
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01006764 {"float", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006765 {"folding",
6766#ifdef FEAT_FOLDING
6767 1
6768#else
6769 0
6770#endif
6771 },
Bram Moolenaarc8ac3a02022-09-04 12:29:28 +01006772 {"footer", 0},
Bram Moolenaar79296512020-03-22 16:17:14 +01006773 {"fork",
6774#if !defined(USE_SYSTEM) && defined(UNIX)
6775 1
6776#else
6777 0
6778#endif
6779 },
6780 {"gettext",
6781#ifdef FEAT_GETTEXT
6782 1
6783#else
6784 0
6785#endif
6786 },
6787 {"gui",
6788#ifdef FEAT_GUI
6789 1
6790#else
6791 0
6792#endif
6793 },
Bram Moolenaar0b962e52022-04-03 18:02:37 +01006794 {"gui_neXtaw", 0 },
6795 {"gui_athena", 0 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006796 {"gui_gtk",
6797#ifdef FEAT_GUI_GTK
6798 1
6799#else
6800 0
6801#endif
6802 },
6803 {"gui_gtk2",
6804#if defined(FEAT_GUI_GTK) && !defined(USE_GTK3)
6805 1
6806#else
6807 0
6808#endif
6809 },
6810 {"gui_gtk3",
6811#if defined(FEAT_GUI_GTK) && defined(USE_GTK3)
6812 1
6813#else
6814 0
6815#endif
6816 },
6817 {"gui_gnome",
6818#ifdef FEAT_GUI_GNOME
6819 1
6820#else
6821 0
6822#endif
6823 },
6824 {"gui_haiku",
6825#ifdef FEAT_GUI_HAIKU
6826 1
6827#else
6828 0
6829#endif
6830 },
Bram Moolenaar097148e2020-08-11 21:58:20 +02006831 {"gui_mac", 0},
Bram Moolenaar79296512020-03-22 16:17:14 +01006832 {"gui_motif",
6833#ifdef FEAT_GUI_MOTIF
6834 1
6835#else
6836 0
6837#endif
6838 },
6839 {"gui_photon",
6840#ifdef FEAT_GUI_PHOTON
6841 1
6842#else
6843 0
6844#endif
6845 },
6846 {"gui_win32",
6847#ifdef FEAT_GUI_MSWIN
6848 1
6849#else
6850 0
6851#endif
6852 },
6853 {"iconv",
6854#if defined(HAVE_ICONV_H) && defined(USE_ICONV)
6855 1
6856#else
6857 0
6858#endif
6859 },
6860 {"insert_expand", 1},
Bram Moolenaarbfe13cc2020-04-12 17:53:12 +02006861 {"ipv6",
6862#ifdef FEAT_IPV6
6863 1
6864#else
6865 0
6866#endif
6867 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006868 {"job",
6869#ifdef FEAT_JOB_CHANNEL
6870 1
6871#else
6872 0
6873#endif
6874 },
Bram Moolenaar739f13a2021-12-13 13:12:53 +00006875 {"jumplist", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006876 {"keymap",
6877#ifdef FEAT_KEYMAP
6878 1
6879#else
6880 0
6881#endif
6882 },
6883 {"lambda", 1}, // always with FEAT_EVAL, since 7.4.2120 with closure
6884 {"langmap",
6885#ifdef FEAT_LANGMAP
6886 1
6887#else
6888 0
6889#endif
6890 },
6891 {"libcall",
6892#ifdef FEAT_LIBCALL
6893 1
6894#else
6895 0
6896#endif
6897 },
6898 {"linebreak",
6899#ifdef FEAT_LINEBREAK
6900 1
6901#else
6902 0
6903#endif
6904 },
Bram Moolenaar8e145b82022-05-21 20:17:31 +01006905 {"lispindent", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006906 {"listcmds", 1},
6907 {"localmap", 1},
6908 {"lua",
6909#if defined(FEAT_LUA) && !defined(DYNAMIC_LUA)
6910 1
6911#else
6912 0
6913#endif
6914 },
6915 {"menu",
6916#ifdef FEAT_MENU
6917 1
6918#else
6919 0
6920#endif
6921 },
6922 {"mksession",
6923#ifdef FEAT_SESSION
6924 1
6925#else
6926 0
6927#endif
6928 },
6929 {"modify_fname", 1},
6930 {"mouse", 1},
6931 {"mouseshape",
6932#ifdef FEAT_MOUSESHAPE
6933 1
6934#else
6935 0
6936#endif
6937 },
6938 {"mouse_dec",
6939#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_DEC)
6940 1
6941#else
6942 0
6943#endif
6944 },
6945 {"mouse_gpm",
Bram Moolenaar33fc4a62022-02-23 18:07:38 +00006946#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_GPM) && !defined(DYNAMIC_GPM)
Bram Moolenaar79296512020-03-22 16:17:14 +01006947 1
6948#else
6949 0
6950#endif
6951 },
6952 {"mouse_jsbterm",
6953#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_JSB)
6954 1
6955#else
6956 0
6957#endif
6958 },
6959 {"mouse_netterm",
6960#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_NET)
6961 1
6962#else
6963 0
6964#endif
6965 },
6966 {"mouse_pterm",
6967#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_PTERM)
6968 1
6969#else
6970 0
6971#endif
6972 },
6973 {"mouse_sgr",
6974#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_XTERM)
6975 1
6976#else
6977 0
6978#endif
6979 },
6980 {"mouse_sysmouse",
6981#if (defined(UNIX) || defined(VMS)) && defined(FEAT_SYSMOUSE)
6982 1
6983#else
6984 0
6985#endif
6986 },
6987 {"mouse_urxvt",
6988#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_URXVT)
6989 1
6990#else
6991 0
6992#endif
6993 },
6994 {"mouse_xterm",
6995#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_XTERM)
6996 1
6997#else
6998 0
6999#endif
7000 },
7001 {"multi_byte", 1},
7002 {"multi_byte_ime",
7003#ifdef FEAT_MBYTE_IME
7004 1
7005#else
7006 0
7007#endif
7008 },
7009 {"multi_lang",
7010#ifdef FEAT_MULTI_LANG
7011 1
7012#else
7013 0
7014#endif
7015 },
7016 {"mzscheme",
7017#if defined(FEAT_MZSCHEME) && !defined(DYNAMIC_MZSCHEME)
7018 1
7019#else
7020 0
7021#endif
7022 },
Leah Neukirchen0a7984a2021-10-14 21:27:55 +01007023 {"nanotime",
7024#ifdef ST_MTIM_NSEC
7025 1
7026#else
7027 0
7028#endif
7029 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007030 {"num64", 1},
7031 {"ole",
7032#ifdef FEAT_OLE
7033 1
7034#else
7035 0
7036#endif
7037 },
7038 {"packages",
7039#ifdef FEAT_EVAL
7040 1
7041#else
7042 0
7043#endif
7044 },
Bram Moolenaar2bd9dbc2022-08-25 18:12:06 +01007045 {"path_extra", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007046 {"perl",
7047#if defined(FEAT_PERL) && !defined(DYNAMIC_PERL)
7048 1
7049#else
7050 0
7051#endif
7052 },
7053 {"persistent_undo",
7054#ifdef FEAT_PERSISTENT_UNDO
7055 1
7056#else
7057 0
7058#endif
7059 },
7060 {"python_compiled",
7061#if defined(FEAT_PYTHON)
7062 1
7063#else
7064 0
7065#endif
7066 },
7067 {"python_dynamic",
7068#if defined(FEAT_PYTHON) && defined(DYNAMIC_PYTHON)
7069 1
7070#else
7071 0
7072#endif
7073 },
7074 {"python",
7075#if defined(FEAT_PYTHON) && !defined(DYNAMIC_PYTHON)
7076 1
7077#else
7078 0
7079#endif
7080 },
7081 {"pythonx",
7082#if (defined(FEAT_PYTHON) && !defined(DYNAMIC_PYTHON)) \
7083 || (defined(FEAT_PYTHON3) && !defined(DYNAMIC_PYTHON3))
7084 1
7085#else
7086 0
7087#endif
7088 },
7089 {"python3_compiled",
7090#if defined(FEAT_PYTHON3)
7091 1
7092#else
7093 0
7094#endif
7095 },
7096 {"python3_dynamic",
7097#if defined(FEAT_PYTHON3) && defined(DYNAMIC_PYTHON3)
7098 1
7099#else
7100 0
7101#endif
7102 },
Yee Cheng Chinc13b3d12023-08-20 21:18:38 +02007103 {"python3_stable",
7104#if defined(FEAT_PYTHON3) && defined(DYNAMIC_PYTHON3_STABLE_ABI)
7105 1
7106#else
7107 0
7108#endif
7109 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007110 {"python3",
7111#if defined(FEAT_PYTHON3) && !defined(DYNAMIC_PYTHON3)
7112 1
7113#else
7114 0
7115#endif
7116 },
7117 {"popupwin",
7118#ifdef FEAT_PROP_POPUP
7119 1
7120#else
7121 0
7122#endif
7123 },
7124 {"postscript",
7125#ifdef FEAT_POSTSCRIPT
7126 1
7127#else
7128 0
7129#endif
7130 },
7131 {"printer",
7132#ifdef FEAT_PRINTER
7133 1
7134#else
7135 0
7136#endif
7137 },
7138 {"profile",
7139#ifdef FEAT_PROFILE
7140 1
7141#else
7142 0
7143#endif
7144 },
Ernie Rael076de792023-03-16 21:43:15 +00007145 {"prof_nsec",
Bram Moolenaar08210f82023-04-13 19:15:54 +01007146#ifdef PROF_NSEC
Ernie Rael076de792023-03-16 21:43:15 +00007147 1
7148#else
7149 0
7150#endif
7151 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007152 {"reltime",
7153#ifdef FEAT_RELTIME
7154 1
7155#else
7156 0
7157#endif
7158 },
7159 {"quickfix",
7160#ifdef FEAT_QUICKFIX
7161 1
7162#else
7163 0
7164#endif
7165 },
7166 {"rightleft",
7167#ifdef FEAT_RIGHTLEFT
7168 1
7169#else
7170 0
7171#endif
7172 },
7173 {"ruby",
7174#if defined(FEAT_RUBY) && !defined(DYNAMIC_RUBY)
7175 1
7176#else
7177 0
7178#endif
7179 },
7180 {"scrollbind", 1},
Martin Tournoijba43e762022-10-13 22:12:15 +01007181 {"showcmd", 1},
7182 {"cmdline_info", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007183 {"signs",
7184#ifdef FEAT_SIGNS
7185 1
7186#else
7187 0
7188#endif
7189 },
Bram Moolenaar8e145b82022-05-21 20:17:31 +01007190 {"smartindent", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007191 {"startuptime",
7192#ifdef STARTUPTIME
7193 1
7194#else
7195 0
7196#endif
7197 },
7198 {"statusline",
7199#ifdef FEAT_STL_OPT
7200 1
7201#else
7202 0
7203#endif
7204 },
7205 {"netbeans_intg",
7206#ifdef FEAT_NETBEANS_INTG
7207 1
7208#else
7209 0
7210#endif
7211 },
Christian Brabandtf573c6e2021-06-20 14:02:16 +02007212 {"sodium",
K.Takatad68b2fc2022-02-12 11:18:37 +00007213#if defined(FEAT_SODIUM) && !defined(DYNAMIC_SODIUM)
Christian Brabandtf573c6e2021-06-20 14:02:16 +02007214 1
7215#else
7216 0
7217#endif
7218 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007219 {"sound",
7220#ifdef FEAT_SOUND
7221 1
7222#else
7223 0
7224#endif
7225 },
7226 {"spell",
7227#ifdef FEAT_SPELL
7228 1
7229#else
7230 0
7231#endif
7232 },
7233 {"syntax",
7234#ifdef FEAT_SYN_HL
7235 1
7236#else
7237 0
7238#endif
7239 },
7240 {"system",
7241#if defined(USE_SYSTEM) || !defined(UNIX)
7242 1
7243#else
7244 0
7245#endif
7246 },
Yegappan Lakshmanan655b7342022-03-06 14:27:10 +00007247 {"tag_binary", 1}, // graduated feature
Bram Moolenaar79296512020-03-22 16:17:14 +01007248 {"tcl",
7249#if defined(FEAT_TCL) && !defined(DYNAMIC_TCL)
7250 1
7251#else
7252 0
7253#endif
7254 },
7255 {"termguicolors",
7256#ifdef FEAT_TERMGUICOLORS
7257 1
7258#else
7259 0
7260#endif
7261 },
7262 {"terminal",
7263#if defined(FEAT_TERMINAL) && !defined(MSWIN)
7264 1
7265#else
7266 0
7267#endif
7268 },
7269 {"terminfo",
7270#ifdef TERMINFO
7271 1
7272#else
7273 0
7274#endif
7275 },
7276 {"termresponse",
7277#ifdef FEAT_TERMRESPONSE
7278 1
7279#else
7280 0
7281#endif
7282 },
Bram Moolenaar88774872022-08-16 20:24:29 +01007283 {"textobjects", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007284 {"textprop",
7285#ifdef FEAT_PROP_POPUP
7286 1
7287#else
7288 0
7289#endif
7290 },
7291 {"tgetent",
7292#ifdef HAVE_TGETENT
7293 1
7294#else
7295 0
7296#endif
7297 },
7298 {"timers",
7299#ifdef FEAT_TIMERS
7300 1
7301#else
7302 0
7303#endif
7304 },
Bram Moolenaar651fca82021-11-29 20:39:38 +00007305 {"title", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007306 {"toolbar",
7307#ifdef FEAT_TOOLBAR
7308 1
7309#else
7310 0
7311#endif
7312 },
7313 {"unnamedplus",
7314#if defined(FEAT_CLIPBOARD) && defined(FEAT_X11)
7315 1
7316#else
7317 0
7318#endif
7319 },
7320 {"user-commands", 1}, // was accidentally included in 5.4
7321 {"user_commands", 1},
7322 {"vartabs",
7323#ifdef FEAT_VARTABS
7324 1
7325#else
7326 0
7327#endif
7328 },
7329 {"vertsplit", 1},
7330 {"viminfo",
7331#ifdef FEAT_VIMINFO
7332 1
7333#else
7334 0
7335#endif
7336 },
Bram Moolenaarb79ee0c2022-01-01 12:17:00 +00007337 {"vim9script", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007338 {"vimscript-1", 1},
7339 {"vimscript-2", 1},
7340 {"vimscript-3", 1},
7341 {"vimscript-4", 1},
7342 {"virtualedit", 1},
7343 {"visual", 1},
7344 {"visualextra", 1},
7345 {"vreplace", 1},
7346 {"vtp",
7347#ifdef FEAT_VTP
7348 1
7349#else
7350 0
7351#endif
7352 },
Bram Moolenaar074fbd42022-08-26 16:41:14 +01007353 {"wildignore", 1},
Bram Moolenaar54162322022-08-26 16:58:51 +01007354 {"wildmenu", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007355 {"windows", 1},
7356 {"winaltkeys",
7357#ifdef FEAT_WAK
7358 1
7359#else
7360 0
7361#endif
7362 },
7363 {"writebackup",
7364#ifdef FEAT_WRITEBACKUP
7365 1
7366#else
7367 0
7368#endif
7369 },
Christian Brabandte085dfd2023-09-30 12:49:18 +02007370 {"xattr",
7371#ifdef FEAT_XATTR
7372 1
7373#else
7374 0
7375#endif
7376 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007377 {"xim",
7378#ifdef FEAT_XIM
7379 1
7380#else
7381 0
7382#endif
7383 },
7384 {"xfontset",
7385#ifdef FEAT_XFONTSET
7386 1
7387#else
7388 0
7389#endif
7390 },
7391 {"xpm",
7392#if defined(FEAT_XPM_W32) || defined(HAVE_XPM)
7393 1
7394#else
7395 0
7396#endif
7397 },
7398 {"xpm_w32", // for backward compatibility
7399#ifdef FEAT_XPM_W32
7400 1
7401#else
7402 0
7403#endif
7404 },
7405 {"xsmp",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007406#ifdef USE_XSMP
Bram Moolenaar79296512020-03-22 16:17:14 +01007407 1
7408#else
7409 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007410#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007411 },
7412 {"xsmp_interact",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007413#ifdef USE_XSMP_INTERACT
Bram Moolenaar79296512020-03-22 16:17:14 +01007414 1
7415#else
7416 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007417#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007418 },
7419 {"xterm_clipboard",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007420#ifdef FEAT_XCLIPBOARD
Bram Moolenaar79296512020-03-22 16:17:14 +01007421 1
7422#else
7423 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007424#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007425 },
7426 {"xterm_save",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007427#ifdef FEAT_XTERM_SAVE
Bram Moolenaar79296512020-03-22 16:17:14 +01007428 1
7429#else
7430 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007431#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007432 },
7433 {"X11",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007434#if defined(UNIX) && defined(FEAT_X11)
Bram Moolenaar79296512020-03-22 16:17:14 +01007435 1
7436#else
7437 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007438#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007439 },
Bram Moolenaar80adaa82023-07-07 18:57:40 +01007440 {":tearoff",
7441// same #ifdef as used for ex_tearoff().
7442#if defined(FEAT_GUI_MSWIN) && defined(FEAT_MENU) && defined(FEAT_TEAROFF)
7443 1
7444#else
7445 0
7446#endif
7447 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007448 {NULL, 0}
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007449 };
7450
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02007451 if (in_vim9script()
7452 && (check_for_string_arg(argvars, 0) == FAIL
7453 || check_for_opt_bool_arg(argvars, 1) == FAIL))
7454 return;
7455
Bram Moolenaard155d7a2018-12-21 16:04:21 +01007456 name = tv_get_string(&argvars[0]);
Bram Moolenaar79296512020-03-22 16:17:14 +01007457 for (i = 0; has_list[i].name != NULL; ++i)
7458 if (STRICMP(name, has_list[i].name) == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007459 {
Bram Moolenaar79296512020-03-22 16:17:14 +01007460 x = TRUE;
7461 n = has_list[i].present;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007462 break;
7463 }
7464
Bram Moolenaar79296512020-03-22 16:17:14 +01007465 // features also in has_list[] but sometimes enabled at runtime
7466 if (x == TRUE && n == FALSE)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007467 {
Bram Moolenaar79296512020-03-22 16:17:14 +01007468 if (0)
Bram Moolenaar86b9a3e2020-04-07 19:57:29 +02007469 {
7470 // intentionally empty
7471 }
Bram Moolenaar79296512020-03-22 16:17:14 +01007472#ifdef VIMDLL
7473 else if (STRICMP(name, "filterpipe") == 0)
7474 n = gui.in_use || gui.starting;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007475#endif
7476#if defined(USE_ICONV) && defined(DYNAMIC_ICONV)
7477 else if (STRICMP(name, "iconv") == 0)
7478 n = iconv_enabled(FALSE);
7479#endif
7480#ifdef DYNAMIC_LUA
7481 else if (STRICMP(name, "lua") == 0)
7482 n = lua_enabled(FALSE);
7483#endif
7484#ifdef DYNAMIC_MZSCHEME
7485 else if (STRICMP(name, "mzscheme") == 0)
7486 n = mzscheme_enabled(FALSE);
7487#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007488#ifdef DYNAMIC_PERL
7489 else if (STRICMP(name, "perl") == 0)
7490 n = perl_enabled(FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007491#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007492#ifdef DYNAMIC_PYTHON
7493 else if (STRICMP(name, "python") == 0)
7494 n = python_enabled(FALSE);
7495#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007496#ifdef DYNAMIC_PYTHON3
7497 else if (STRICMP(name, "python3") == 0)
7498 n = python3_enabled(FALSE);
7499#endif
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01007500#if defined(DYNAMIC_PYTHON) || defined(DYNAMIC_PYTHON3)
7501 else if (STRICMP(name, "pythonx") == 0)
7502 {
7503# if defined(DYNAMIC_PYTHON) && defined(DYNAMIC_PYTHON3)
7504 if (p_pyx == 0)
7505 n = python3_enabled(FALSE) || python_enabled(FALSE);
7506 else if (p_pyx == 3)
7507 n = python3_enabled(FALSE);
7508 else if (p_pyx == 2)
7509 n = python_enabled(FALSE);
7510# elif defined(DYNAMIC_PYTHON)
7511 n = python_enabled(FALSE);
7512# elif defined(DYNAMIC_PYTHON3)
7513 n = python3_enabled(FALSE);
7514# endif
7515 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007516#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007517#ifdef DYNAMIC_RUBY
7518 else if (STRICMP(name, "ruby") == 0)
7519 n = ruby_enabled(FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007520#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007521#ifdef DYNAMIC_TCL
7522 else if (STRICMP(name, "tcl") == 0)
7523 n = tcl_enabled(FALSE);
Bram Moolenaar4b8366b2019-05-04 17:34:34 +02007524#endif
K.Takatad68b2fc2022-02-12 11:18:37 +00007525#ifdef DYNAMIC_SODIUM
7526 else if (STRICMP(name, "sodium") == 0)
7527 n = sodium_enabled(FALSE);
7528#endif
Bram Moolenaar4f974752019-02-17 17:44:42 +01007529#if defined(FEAT_TERMINAL) && defined(MSWIN)
Bram Moolenaara83e3962017-08-17 14:39:07 +02007530 else if (STRICMP(name, "terminal") == 0)
7531 n = terminal_enabled();
7532#endif
Bram Moolenaar33fc4a62022-02-23 18:07:38 +00007533#ifdef DYNAMIC_GPM
7534 else if (STRICMP(name, "mouse_gpm") == 0)
7535 n = gpm_available();
7536#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007537 }
7538
Bram Moolenaar79296512020-03-22 16:17:14 +01007539 // features not in has_list[]
7540 if (x == FALSE)
7541 {
7542 if (STRNICMP(name, "patch", 5) == 0)
7543 {
7544 x = TRUE;
7545 if (name[5] == '-'
7546 && STRLEN(name) >= 11
K.Takatad90f91f2022-07-30 15:43:59 +01007547 && (name[6] >= '1' && name[6] <= '9'))
Bram Moolenaar79296512020-03-22 16:17:14 +01007548 {
K.Takatad90f91f2022-07-30 15:43:59 +01007549 char *end;
7550 int major, minor;
Bram Moolenaar79296512020-03-22 16:17:14 +01007551
K.Takatad90f91f2022-07-30 15:43:59 +01007552 // This works for patch-8.1.2, patch-9.0.3, patch-10.0.4, etc.
7553 // Not for patch-9.10.5.
7554 major = (int)strtoul((char *)name + 6, &end, 10);
7555 if (*end == '.' && vim_isdigit(end[1])
7556 && end[2] == '.' && vim_isdigit(end[3]))
7557 {
7558 minor = atoi(end + 1);
7559
7560 // Expect "patch-9.9.01234".
7561 n = (major < VIM_VERSION_MAJOR
7562 || (major == VIM_VERSION_MAJOR
7563 && (minor < VIM_VERSION_MINOR
7564 || (minor == VIM_VERSION_MINOR
7565 && has_patch(atoi(end + 3))))));
7566 }
Bram Moolenaar79296512020-03-22 16:17:14 +01007567 }
Keith Thompson184f71c2024-01-04 21:19:04 +01007568 else if (SAFE_isdigit(name[5]))
Bram Moolenaar79296512020-03-22 16:17:14 +01007569 n = has_patch(atoi((char *)name + 5));
7570 }
7571 else if (STRICMP(name, "vim_starting") == 0)
7572 {
7573 x = TRUE;
7574 n = (starting != 0);
7575 }
7576 else if (STRICMP(name, "ttyin") == 0)
7577 {
7578 x = TRUE;
7579 n = mch_input_isatty();
7580 }
7581 else if (STRICMP(name, "ttyout") == 0)
7582 {
7583 x = TRUE;
7584 n = stdout_isatty;
7585 }
7586 else if (STRICMP(name, "multi_byte_encoding") == 0)
7587 {
7588 x = TRUE;
7589 n = has_mbyte;
7590 }
7591 else if (STRICMP(name, "gui_running") == 0)
7592 {
7593 x = TRUE;
7594#ifdef FEAT_GUI
7595 n = (gui.in_use || gui.starting);
7596#endif
7597 }
7598 else if (STRICMP(name, "browse") == 0)
7599 {
7600 x = TRUE;
7601#if defined(FEAT_GUI) && defined(FEAT_BROWSE)
7602 n = gui.in_use; // gui_mch_browse() works when GUI is running
7603#endif
7604 }
7605 else if (STRICMP(name, "syntax_items") == 0)
7606 {
7607 x = TRUE;
7608#ifdef FEAT_SYN_HL
7609 n = syntax_present(curwin);
7610#endif
7611 }
7612 else if (STRICMP(name, "vcon") == 0)
7613 {
7614 x = TRUE;
7615#ifdef FEAT_VTP
7616 n = is_term_win32() && has_vtp_working();
7617#endif
7618 }
7619 else if (STRICMP(name, "netbeans_enabled") == 0)
7620 {
7621 x = TRUE;
7622#ifdef FEAT_NETBEANS_INTG
7623 n = netbeans_active();
7624#endif
7625 }
7626 else if (STRICMP(name, "mouse_gpm_enabled") == 0)
7627 {
7628 x = TRUE;
7629#ifdef FEAT_MOUSE_GPM
7630 n = gpm_enabled();
7631#endif
7632 }
7633 else if (STRICMP(name, "conpty") == 0)
7634 {
7635 x = TRUE;
7636#if defined(FEAT_TERMINAL) && defined(MSWIN)
7637 n = use_conpty();
7638#endif
7639 }
7640 else if (STRICMP(name, "clipboard_working") == 0)
7641 {
7642 x = TRUE;
7643#ifdef FEAT_CLIPBOARD
7644 n = clip_star.available;
7645#endif
7646 }
7647 }
7648
Bram Moolenaar04637e22020-09-05 18:45:29 +02007649 if (argvars[1].v_type != VAR_UNKNOWN && tv_get_bool(&argvars[1]))
Bram Moolenaar79296512020-03-22 16:17:14 +01007650 // return whether feature could ever be enabled
7651 rettv->vval.v_number = x;
7652 else
7653 // return whether feature is enabled
7654 rettv->vval.v_number = n;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007655}
7656
7657/*
Bram Moolenaar8cebd432020-11-08 12:49:47 +01007658 * Return TRUE if "feature" can change later.
7659 * Also when checking for the feature has side effects, such as loading a DLL.
7660 */
7661 int
7662dynamic_feature(char_u *feature)
7663{
7664 return (feature == NULL
Bram Moolenaar8cebd432020-11-08 12:49:47 +01007665#if defined(FEAT_GUI) && defined(FEAT_BROWSE)
7666 || (STRICMP(feature, "browse") == 0 && !gui.in_use)
7667#endif
7668#ifdef VIMDLL
7669 || STRICMP(feature, "filterpipe") == 0
7670#endif
Bram Moolenaar29b281b2020-11-10 20:58:00 +01007671#if defined(FEAT_GUI) && !defined(ALWAYS_USE_GUI) && !defined(VIMDLL)
Bram Moolenaar8cebd432020-11-08 12:49:47 +01007672 // this can only change on Unix where the ":gui" command could be
7673 // used.
7674 || (STRICMP(feature, "gui_running") == 0 && !gui.in_use)
7675#endif
7676#if defined(USE_ICONV) && defined(DYNAMIC_ICONV)
7677 || STRICMP(feature, "iconv") == 0
7678#endif
7679#ifdef DYNAMIC_LUA
7680 || STRICMP(feature, "lua") == 0
7681#endif
7682#ifdef FEAT_MOUSE_GPM
7683 || (STRICMP(feature, "mouse_gpm_enabled") == 0 && !gpm_enabled())
7684#endif
7685#ifdef DYNAMIC_MZSCHEME
7686 || STRICMP(feature, "mzscheme") == 0
7687#endif
7688#ifdef FEAT_NETBEANS_INTG
7689 || STRICMP(feature, "netbeans_enabled") == 0
7690#endif
7691#ifdef DYNAMIC_PERL
7692 || STRICMP(feature, "perl") == 0
7693#endif
7694#ifdef DYNAMIC_PYTHON
7695 || STRICMP(feature, "python") == 0
7696#endif
7697#ifdef DYNAMIC_PYTHON3
7698 || STRICMP(feature, "python3") == 0
7699#endif
7700#if defined(DYNAMIC_PYTHON) || defined(DYNAMIC_PYTHON3)
7701 || STRICMP(feature, "pythonx") == 0
7702#endif
7703#ifdef DYNAMIC_RUBY
7704 || STRICMP(feature, "ruby") == 0
7705#endif
7706#ifdef FEAT_SYN_HL
7707 || STRICMP(feature, "syntax_items") == 0
7708#endif
7709#ifdef DYNAMIC_TCL
7710 || STRICMP(feature, "tcl") == 0
7711#endif
7712 // once "starting" is zero it will stay that way
7713 || (STRICMP(feature, "vim_starting") == 0 && starting != 0)
7714 || STRICMP(feature, "multi_byte_encoding") == 0
7715#if defined(FEAT_TERMINAL) && defined(MSWIN)
7716 || STRICMP(feature, "conpty") == 0
7717#endif
7718 );
7719}
7720
7721/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007722 * "haslocaldir()" function
7723 */
7724 static void
7725f_haslocaldir(typval_T *argvars, typval_T *rettv)
7726{
Bram Moolenaar00aa0692019-04-27 20:37:57 +02007727 tabpage_T *tp = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007728 win_T *wp = NULL;
7729
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02007730 if (in_vim9script()
7731 && (check_for_opt_number_arg(argvars, 0) == FAIL
7732 || (argvars[0].v_type != VAR_UNKNOWN
7733 && check_for_opt_number_arg(argvars, 1) == FAIL)))
7734 return;
7735
Bram Moolenaar00aa0692019-04-27 20:37:57 +02007736 wp = find_tabwin(&argvars[0], &argvars[1], &tp);
7737
7738 // Check for window-local and tab-local directories
7739 if (wp != NULL && wp->w_localdir != NULL)
7740 rettv->vval.v_number = 1;
7741 else if (tp != NULL && tp->tp_localdir != NULL)
7742 rettv->vval.v_number = 2;
7743 else
7744 rettv->vval.v_number = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007745}
7746
7747/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007748 * "highlightID(name)" function
7749 */
7750 static void
7751f_hlID(typval_T *argvars, typval_T *rettv)
7752{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02007753 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
7754 return;
7755
Bram Moolenaard155d7a2018-12-21 16:04:21 +01007756 rettv->vval.v_number = syn_name2id(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007757}
7758
7759/*
7760 * "highlight_exists()" function
7761 */
7762 static void
7763f_hlexists(typval_T *argvars, typval_T *rettv)
7764{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02007765 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
7766 return;
7767
Bram Moolenaard155d7a2018-12-21 16:04:21 +01007768 rettv->vval.v_number = highlight_exists(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007769}
7770
7771/*
7772 * "hostname()" function
7773 */
7774 static void
7775f_hostname(typval_T *argvars UNUSED, typval_T *rettv)
7776{
7777 char_u hostname[256];
7778
7779 mch_get_host_name(hostname, 256);
7780 rettv->v_type = VAR_STRING;
7781 rettv->vval.v_string = vim_strsave(hostname);
7782}
7783
7784/*
Ernie Raelc8e158b2024-07-09 18:39:52 +02007785 * "id()" function
7786 * Identity. Return address of item as a hex string, %p format.
7787 * Currently only valid for object/container types.
7788 * Return empty string if not an object.
7789 */
Zoltan Arpadffy10231ac2024-08-18 16:59:20 +02007790#ifdef VMS // VMS does not have defined uintptr_t
7791# if defined(HAVE_NO_LONG_LONG)
7792typedef unsigned int uintptr_t;
7793# else
7794typedef unsigned long long uintptr_t;
7795# endif
7796#endif // VMS
7797
John Marriottb3b2bee2024-07-14 11:12:51 +02007798 static void
Ernie Raelc8e158b2024-07-09 18:39:52 +02007799f_id(typval_T *argvars, typval_T *rettv)
7800{
Ernie Rael05124252024-07-11 22:10:45 +02007801 char numbuf[NUMBUFLEN];
7802 char *p = numbuf;
Ernie Raelc8e158b2024-07-09 18:39:52 +02007803
7804 switch (argvars[0].v_type)
7805 {
7806 case VAR_LIST:
7807 case VAR_DICT:
7808 case VAR_OBJECT:
7809 case VAR_JOB:
7810 case VAR_CHANNEL:
7811 case VAR_BLOB:
7812 // Assume pointer value in typval_T vval union at common location.
7813 if (argvars[0].vval.v_object != NULL)
Ernie Rael05124252024-07-11 22:10:45 +02007814 {
7815 // "v" gets the address as an integer
7816 uintptr_t v = (uintptr_t)(void *)argvars[0].vval.v_object;
7817 // Build a hex string from the item's address; it is in
7818 // reverse order. Ignore trailing zeros.
7819 for (; p < numbuf + sizeof(uintptr_t) * 2 && v != 0;
7820 ++p, v >>= 4)
7821 *p = "0123456789abcdef"[v & 0xf];
7822 }
Ernie Raelc8e158b2024-07-09 18:39:52 +02007823 default:
Ernie Rael05124252024-07-11 22:10:45 +02007824 break;
Ernie Raelc8e158b2024-07-09 18:39:52 +02007825 }
Ernie Rael05124252024-07-11 22:10:45 +02007826 *p = NUL;
Ernie Raelc8e158b2024-07-09 18:39:52 +02007827
7828 rettv->v_type = VAR_STRING;
Ernie Rael05124252024-07-11 22:10:45 +02007829 rettv->vval.v_string = vim_strsave((char_u *)numbuf);
Ernie Raelc8e158b2024-07-09 18:39:52 +02007830}
7831
7832/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007833 * "index()" function
7834 */
7835 static void
7836f_index(typval_T *argvars, typval_T *rettv)
7837{
7838 list_T *l;
7839 listitem_T *item;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007840 blob_T *b;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007841 long idx = 0;
7842 int ic = FALSE;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007843 int error = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007844
7845 rettv->vval.v_number = -1;
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02007846
7847 if (in_vim9script()
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02007848 && (check_for_list_or_blob_arg(argvars, 0) == FAIL
7849 || (argvars[0].v_type == VAR_BLOB
7850 && check_for_number_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02007851 || check_for_opt_number_arg(argvars, 2) == FAIL
7852 || (argvars[2].v_type != VAR_UNKNOWN
7853 && check_for_opt_bool_arg(argvars, 3) == FAIL)))
7854 return;
7855
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007856 if (argvars[0].v_type == VAR_BLOB)
7857 {
7858 typval_T tv;
7859 int start = 0;
7860
7861 if (argvars[2].v_type != VAR_UNKNOWN)
7862 {
7863 start = tv_get_number_chk(&argvars[2], &error);
7864 if (error)
7865 return;
7866 }
7867 b = argvars[0].vval.v_blob;
7868 if (b == NULL)
7869 return;
Bram Moolenaar05500ec2019-01-13 19:10:33 +01007870 if (start < 0)
7871 {
7872 start = blob_len(b) + start;
7873 if (start < 0)
7874 start = 0;
7875 }
7876
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007877 for (idx = start; idx < blob_len(b); ++idx)
7878 {
7879 tv.v_type = VAR_NUMBER;
7880 tv.vval.v_number = blob_get(b, idx);
Yinzuo Jiang7ccd1a22024-07-04 17:20:53 +02007881 if (tv_equal(&tv, &argvars[1], ic))
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007882 {
7883 rettv->vval.v_number = idx;
7884 return;
7885 }
7886 }
7887 return;
7888 }
7889 else if (argvars[0].v_type != VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007890 {
Bram Moolenaar460ae5d2022-01-01 14:19:49 +00007891 emsg(_(e_list_or_blob_required));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007892 return;
7893 }
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007894
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007895 l = argvars[0].vval.v_list;
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00007896 if (l == NULL)
7897 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007898
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00007899 CHECK_LIST_MATERIALIZE(l);
7900 item = l->lv_first;
7901 if (argvars[2].v_type != VAR_UNKNOWN)
7902 {
7903 // Start at specified item. Use the cached index that list_find()
7904 // sets, so that a negative number also works.
7905 item = list_find(l, (long)tv_get_number_chk(&argvars[2], &error));
7906 idx = l->lv_u.mat.lv_idx;
7907 if (argvars[3].v_type != VAR_UNKNOWN)
7908 ic = (int)tv_get_bool_chk(&argvars[3], &error);
7909 if (error)
7910 item = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007911 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00007912
7913 for ( ; item != NULL; item = item->li_next, ++idx)
Yinzuo Jiang7ccd1a22024-07-04 17:20:53 +02007914 if (tv_equal(&item->li_tv, &argvars[1], ic))
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00007915 {
7916 rettv->vval.v_number = idx;
7917 break;
7918 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007919}
7920
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01007921/*
7922 * Evaluate 'expr' with the v:key and v:val arguments and return the result.
7923 * The expression is expected to return a boolean value. The caller should set
7924 * the VV_KEY and VV_VAL vim variables before calling this function.
7925 */
7926 static int
7927indexof_eval_expr(typval_T *expr)
7928{
7929 typval_T argv[3];
7930 typval_T newtv;
7931 varnumber_T found;
7932 int error = FALSE;
7933
7934 argv[0] = *get_vim_var_tv(VV_KEY);
7935 argv[1] = *get_vim_var_tv(VV_VAL);
7936 newtv.v_type = VAR_UNKNOWN;
7937
zeertzjqad0c4422023-08-17 22:15:47 +02007938 if (eval_expr_typval(expr, FALSE, argv, 2, NULL, &newtv) == FAIL)
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01007939 return FALSE;
7940
7941 found = tv_get_bool_chk(&newtv, &error);
Yegappan Lakshmanan63acae12022-08-14 12:07:11 +01007942 clear_tv(&newtv);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01007943
7944 return error ? FALSE : found;
7945}
7946
7947/*
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01007948 * Evaluate 'expr' for each byte in the Blob 'b' starting with the byte at
7949 * 'startidx' and return the index of the byte where 'expr' is TRUE. Returns
7950 * -1 if 'expr' doesn't evaluate to TRUE for any of the bytes.
7951 */
7952 static int
7953indexof_blob(blob_T *b, long startidx, typval_T *expr)
7954{
7955 long idx = 0;
7956
7957 if (b == NULL)
7958 return -1;
7959
7960 if (startidx < 0)
7961 {
7962 // negative index: index from the last byte
7963 startidx = blob_len(b) + startidx;
7964 if (startidx < 0)
7965 startidx = 0;
7966 }
7967
7968 set_vim_var_type(VV_KEY, VAR_NUMBER);
7969 set_vim_var_type(VV_VAL, VAR_NUMBER);
7970
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02007971 int called_emsg_start = called_emsg;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01007972 for (idx = startidx; idx < blob_len(b); ++idx)
7973 {
7974 set_vim_var_nr(VV_KEY, idx);
7975 set_vim_var_nr(VV_VAL, blob_get(b, idx));
7976
7977 if (indexof_eval_expr(expr))
7978 return idx;
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02007979
7980 if (called_emsg != called_emsg_start)
7981 return -1;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01007982 }
7983
7984 return -1;
7985}
7986
7987/*
7988 * Evaluate 'expr' for each item in the List 'l' starting with the item at
7989 * 'startidx' and return the index of the item where 'expr' is TRUE. Returns
7990 * -1 if 'expr' doesn't evaluate to TRUE for any of the items.
7991 */
7992 static int
7993indexof_list(list_T *l, long startidx, typval_T *expr)
7994{
7995 listitem_T *item;
7996 long idx = 0;
Yegappan Lakshmanan63acae12022-08-14 12:07:11 +01007997 int found;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01007998
7999 if (l == NULL)
8000 return -1;
8001
8002 CHECK_LIST_MATERIALIZE(l);
8003
8004 if (startidx == 0)
8005 item = l->lv_first;
8006 else
8007 {
8008 // Start at specified item. Use the cached index that list_find()
8009 // sets, so that a negative number also works.
8010 item = list_find(l, startidx);
8011 if (item != NULL)
8012 idx = l->lv_u.mat.lv_idx;
8013 }
8014
8015 set_vim_var_type(VV_KEY, VAR_NUMBER);
8016
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008017 int called_emsg_start = called_emsg;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008018 for ( ; item != NULL; item = item->li_next, ++idx)
8019 {
8020 set_vim_var_nr(VV_KEY, idx);
8021 copy_tv(&item->li_tv, get_vim_var_tv(VV_VAL));
8022
Yegappan Lakshmanan63acae12022-08-14 12:07:11 +01008023 found = indexof_eval_expr(expr);
8024 clear_tv(get_vim_var_tv(VV_VAL));
8025
8026 if (found)
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008027 return idx;
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008028
8029 if (called_emsg != called_emsg_start)
8030 return -1;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008031 }
8032
8033 return -1;
8034}
8035
8036/*
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008037 * "indexof()" function
8038 */
8039 static void
8040f_indexof(typval_T *argvars, typval_T *rettv)
8041{
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008042 long startidx = 0;
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008043 typval_T save_val;
8044 typval_T save_key;
8045 int save_did_emsg;
8046
8047 rettv->vval.v_number = -1;
8048
8049 if (check_for_list_or_blob_arg(argvars, 0) == FAIL
8050 || check_for_string_or_func_arg(argvars, 1) == FAIL
8051 || check_for_opt_dict_arg(argvars, 2) == FAIL)
8052 return;
8053
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008054 if ((argvars[1].v_type == VAR_STRING &&
8055 (argvars[1].vval.v_string == NULL
8056 || *argvars[1].vval.v_string == NUL))
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008057 || (argvars[1].v_type == VAR_FUNC
8058 && argvars[1].vval.v_partial == NULL))
8059 return;
8060
8061 if (argvars[2].v_type == VAR_DICT)
8062 startidx = dict_get_number_def(argvars[2].vval.v_dict, "startidx", 0);
8063
8064 prepare_vimvar(VV_VAL, &save_val);
8065 prepare_vimvar(VV_KEY, &save_key);
8066
8067 // We reset "did_emsg" to be able to detect whether an error occurred
8068 // during evaluation of the expression.
8069 save_did_emsg = did_emsg;
8070 did_emsg = FALSE;
8071
8072 if (argvars[0].v_type == VAR_BLOB)
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008073 rettv->vval.v_number = indexof_blob(argvars[0].vval.v_blob, startidx,
8074 &argvars[1]);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008075 else
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008076 rettv->vval.v_number = indexof_list(argvars[0].vval.v_list, startidx,
8077 &argvars[1]);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008078
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008079 restore_vimvar(VV_KEY, &save_key);
8080 restore_vimvar(VV_VAL, &save_val);
8081 did_emsg |= save_did_emsg;
8082}
8083
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008084static int inputsecret_flag = 0;
8085
8086/*
8087 * "input()" function
8088 * Also handles inputsecret() when inputsecret is set.
8089 */
8090 static void
8091f_input(typval_T *argvars, typval_T *rettv)
8092{
8093 get_user_input(argvars, rettv, FALSE, inputsecret_flag);
8094}
8095
8096/*
8097 * "inputdialog()" function
8098 */
8099 static void
8100f_inputdialog(typval_T *argvars, typval_T *rettv)
8101{
8102#if defined(FEAT_GUI_TEXTDIALOG)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008103 // Use a GUI dialog if the GUI is running and 'c' is not in 'guioptions'
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008104 if (gui.in_use && vim_strchr(p_go, GO_CONDIALOG) == NULL)
8105 {
8106 char_u *message;
8107 char_u buf[NUMBUFLEN];
8108 char_u *defstr = (char_u *)"";
8109
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008110 if (in_vim9script()
8111 && (check_for_string_arg(argvars, 0) == FAIL
8112 || check_for_opt_string_arg(argvars, 1) == FAIL
8113 || (argvars[1].v_type != VAR_UNKNOWN
8114 && check_for_opt_string_arg(argvars, 2) == FAIL)))
8115 return;
8116
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008117 message = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008118 if (argvars[1].v_type != VAR_UNKNOWN
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008119 && (defstr = tv_get_string_buf_chk(&argvars[1], buf)) != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008120 vim_strncpy(IObuff, defstr, IOSIZE - 1);
8121 else
8122 IObuff[0] = NUL;
8123 if (message != NULL && defstr != NULL
8124 && do_dialog(VIM_QUESTION, NULL, message,
8125 (char_u *)_("&OK\n&Cancel"), 1, IObuff, FALSE) == 1)
8126 rettv->vval.v_string = vim_strsave(IObuff);
8127 else
8128 {
8129 if (message != NULL && defstr != NULL
8130 && argvars[1].v_type != VAR_UNKNOWN
8131 && argvars[2].v_type != VAR_UNKNOWN)
8132 rettv->vval.v_string = vim_strsave(
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008133 tv_get_string_buf(&argvars[2], buf));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008134 else
8135 rettv->vval.v_string = NULL;
8136 }
8137 rettv->v_type = VAR_STRING;
8138 }
8139 else
8140#endif
8141 get_user_input(argvars, rettv, TRUE, inputsecret_flag);
8142}
8143
8144/*
8145 * "inputlist()" function
8146 */
8147 static void
8148f_inputlist(typval_T *argvars, typval_T *rettv)
8149{
Bram Moolenaar50985eb2020-01-27 22:09:39 +01008150 list_T *l;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008151 listitem_T *li;
8152 int selected;
8153 int mouse_used;
8154
8155#ifdef NO_CONSOLE_INPUT
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008156 // While starting up, there is no place to enter text. When running tests
8157 // with --not-a-term we assume feedkeys() will be used.
Bram Moolenaar91d348a2017-07-29 20:16:03 +02008158 if (no_console_input() && !is_not_a_term())
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008159 return;
8160#endif
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008161 if (in_vim9script() && check_for_list_arg(argvars, 0) == FAIL)
8162 return;
8163
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008164 if (argvars[0].v_type != VAR_LIST || argvars[0].vval.v_list == NULL)
8165 {
Bram Moolenaar3a846e62022-01-01 16:21:00 +00008166 semsg(_(e_argument_of_str_must_be_list), "inputlist()");
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008167 return;
8168 }
8169
8170 msg_start();
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008171 msg_row = Rows - 1; // for when 'cmdheight' > 1
8172 lines_left = Rows; // avoid more prompt
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008173 msg_scroll = TRUE;
8174 msg_clr_eos();
8175
Bram Moolenaar50985eb2020-01-27 22:09:39 +01008176 l = argvars[0].vval.v_list;
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02008177 CHECK_LIST_MATERIALIZE(l);
Bram Moolenaar00d253e2020-04-06 22:13:01 +02008178 FOR_ALL_LIST_ITEMS(l, li)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008179 {
Bram Moolenaar32526b32019-01-19 17:43:09 +01008180 msg_puts((char *)tv_get_string(&li->li_tv));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008181 msg_putchar('\n');
8182 }
8183
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008184 // Ask for choice.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008185 selected = prompt_for_number(&mouse_used);
8186 if (mouse_used)
8187 selected -= lines_left;
8188
8189 rettv->vval.v_number = selected;
8190}
8191
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008192static garray_T ga_userinput = {0, 0, sizeof(tasave_T), 4, NULL};
8193
8194/*
8195 * "inputrestore()" function
8196 */
8197 static void
8198f_inputrestore(typval_T *argvars UNUSED, typval_T *rettv)
8199{
8200 if (ga_userinput.ga_len > 0)
8201 {
8202 --ga_userinput.ga_len;
8203 restore_typeahead((tasave_T *)(ga_userinput.ga_data)
Bram Moolenaarc41badb2021-06-07 22:04:52 +02008204 + ga_userinput.ga_len, TRUE);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008205 // default return is zero == OK
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008206 }
8207 else if (p_verbose > 1)
8208 {
Bram Moolenaar32526b32019-01-19 17:43:09 +01008209 verb_msg(_("called inputrestore() more often than inputsave()"));
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008210 rettv->vval.v_number = 1; // Failed
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008211 }
8212}
8213
8214/*
8215 * "inputsave()" function
8216 */
8217 static void
8218f_inputsave(typval_T *argvars UNUSED, typval_T *rettv)
8219{
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008220 // Add an entry to the stack of typeahead storage.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008221 if (ga_grow(&ga_userinput, 1) == OK)
8222 {
8223 save_typeahead((tasave_T *)(ga_userinput.ga_data)
8224 + ga_userinput.ga_len);
8225 ++ga_userinput.ga_len;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008226 // default return is zero == OK
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008227 }
8228 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008229 rettv->vval.v_number = 1; // Failed
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008230}
8231
8232/*
8233 * "inputsecret()" function
8234 */
8235 static void
8236f_inputsecret(typval_T *argvars, typval_T *rettv)
8237{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008238 if (in_vim9script()
8239 && (check_for_string_arg(argvars, 0) == FAIL
8240 || check_for_opt_string_arg(argvars, 1) == FAIL))
8241 return;
8242
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008243 ++cmdline_star;
8244 ++inputsecret_flag;
8245 f_input(argvars, rettv);
8246 --cmdline_star;
8247 --inputsecret_flag;
8248}
8249
8250/*
Bram Moolenaar67a2deb2019-11-25 00:05:32 +01008251 * "interrupt()" function
8252 */
8253 static void
8254f_interrupt(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
8255{
8256 got_int = TRUE;
8257}
8258
8259/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008260 * "invert(expr)" function
8261 */
8262 static void
8263f_invert(typval_T *argvars, typval_T *rettv)
8264{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008265 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
8266 return;
8267
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008268 rettv->vval.v_number = ~tv_get_number_chk(&argvars[0], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008269}
8270
8271/*
Ernie Rael4c8da022023-10-11 21:35:11 +02008272 * Free resources in lval_root allocated by fill_exec_lval_root().
8273 */
8274 static void
8275free_lval_root(lval_root_T *root)
8276{
8277 if (root->lr_tv != NULL)
8278 free_tv(root->lr_tv);
8279 class_unref(root->lr_cl_exec);
8280 root->lr_tv = NULL;
8281 root->lr_cl_exec = NULL;
8282}
8283
8284/*
8285 * This is used if executing in a method, the argument string is a
Ernie Rael0f058d12023-10-14 11:25:04 +02008286 * variable/item expr/reference. It may start with a potential class/object
8287 * variable.
Ernie Rael4c8da022023-10-11 21:35:11 +02008288 *
Ernie Rael0f058d12023-10-14 11:25:04 +02008289 * Adjust "root" as needed; lr_tv may be changed or freed.
Ernie Rael4c8da022023-10-11 21:35:11 +02008290 *
8291 * Always returns OK.
8292 * Free resources and return FAIL if the root should not be used. Otherwise OK.
8293 */
8294
8295 static int
Ernie Rael0f058d12023-10-14 11:25:04 +02008296fix_variable_reference_lval_root(lval_root_T *root, char_u *name)
Ernie Rael4c8da022023-10-11 21:35:11 +02008297{
Ernie Rael4c8da022023-10-11 21:35:11 +02008298
Ernie Rael0f058d12023-10-14 11:25:04 +02008299 // Check if lr_tv is the name of an object/class reference: name start with
8300 // "this" or name is class variable. Clear lr_tv if neither.
8301 int found_member = FALSE;
Ernie Rael4c8da022023-10-11 21:35:11 +02008302 if (root->lr_tv->v_type == VAR_OBJECT)
8303 {
Ernie Rael0f058d12023-10-14 11:25:04 +02008304 if (STRNCMP("this.", name, 5) == 0 ||STRCMP("this", name) == 0)
8305 found_member = TRUE;
Ernie Rael4c8da022023-10-11 21:35:11 +02008306 }
Ernie Rael0f058d12023-10-14 11:25:04 +02008307 if (!found_member) // not object member, try class member
Ernie Rael4c8da022023-10-11 21:35:11 +02008308 {
8309 // Explicitly check if the name is a class member.
8310 // If it's not then do nothing.
Ernie Rael0f058d12023-10-14 11:25:04 +02008311 char_u *end;
Ernie Rael4c8da022023-10-11 21:35:11 +02008312 for (end = name; ASCII_ISALNUM(*end) || *end == '_'; ++end)
8313 ;
Ernie Rael0f058d12023-10-14 11:25:04 +02008314 int idx = class_member_idx(root->lr_cl_exec, name, end - name);
8315 if (idx >= 0)
Ernie Rael4c8da022023-10-11 21:35:11 +02008316 {
Ernie Rael0f058d12023-10-14 11:25:04 +02008317 // A class variable, replace lr_tv with it
8318 clear_tv(root->lr_tv);
8319 copy_tv(&root->lr_cl_exec->class_members_tv[idx], root->lr_tv);
8320 found_member = TRUE;
Ernie Rael4c8da022023-10-11 21:35:11 +02008321 }
8322 }
Ernie Rael0f058d12023-10-14 11:25:04 +02008323 if (!found_member)
Ernie Rael4c8da022023-10-11 21:35:11 +02008324 {
8325 free_tv(root->lr_tv);
8326 root->lr_tv = NULL; // Not a member variable
8327 }
Ernie Rael4c8da022023-10-11 21:35:11 +02008328 // If FAIL, then must free_lval_root(root);
8329 return OK;
8330}
8331
8332/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008333 * "islocked()" function
8334 */
8335 static void
8336f_islocked(typval_T *argvars, typval_T *rettv)
8337{
8338 lval_T lv;
8339 char_u *end;
8340 dictitem_T *di;
8341
8342 rettv->vval.v_number = -1;
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02008343
8344 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
8345 return;
8346
Ernie Rael4c8da022023-10-11 21:35:11 +02008347 char_u *name = tv_get_string(&argvars[0]);
8348#ifdef LOG_LOCKVAR
8349 ch_log(NULL, "LKVAR: f_islocked(): name: %s", name);
8350#endif
8351
8352 lval_root_T aroot; // fully initialized in fill_exec_lval_root
8353 lval_root_T *root = NULL;
8354
8355 // Set up lval_root if executing in a method.
8356 if (fill_exec_lval_root(&aroot) == OK)
8357 {
8358 // Almost always produces a valid lval_root since lr_cl_exec is used
8359 // for access verification, lr_tv may be set to NULL.
Ernie Rael0f058d12023-10-14 11:25:04 +02008360 if (fix_variable_reference_lval_root(&aroot, name) == OK)
Ernie Rael4c8da022023-10-11 21:35:11 +02008361 root = &aroot;
Ernie Rael4c8da022023-10-11 21:35:11 +02008362 }
8363
8364 lval_root_T *lval_root_save = lval_root;
8365 lval_root = root;
8366 end = get_lval(name, NULL, &lv, FALSE, FALSE,
Bram Moolenaarbd77aa92021-08-12 17:06:05 +02008367 GLV_NO_AUTOLOAD | GLV_READ_ONLY | GLV_NO_DECL,
8368 FNE_CHECK_START);
Ernie Rael4c8da022023-10-11 21:35:11 +02008369 lval_root = lval_root_save;
8370
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008371 if (end != NULL && lv.ll_name != NULL)
8372 {
8373 if (*end != NUL)
Bram Moolenaar1840a7b2021-07-13 20:32:29 +02008374 {
8375 semsg(_(lv.ll_name == lv.ll_name_end
Bram Moolenaar0bd663a2022-01-22 10:24:47 +00008376 ? e_invalid_argument_str : e_trailing_characters_str), end);
Bram Moolenaar1840a7b2021-07-13 20:32:29 +02008377 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008378 else
8379 {
8380 if (lv.ll_tv == NULL)
8381 {
Bram Moolenaar79518e22017-02-17 16:31:35 +01008382 di = find_var(lv.ll_name, NULL, TRUE);
8383 if (di != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008384 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008385 // Consider a variable locked when:
8386 // 1. the variable itself is locked
8387 // 2. the value of the variable is locked.
8388 // 3. the List or Dict value is locked.
Bram Moolenaar79518e22017-02-17 16:31:35 +01008389 rettv->vval.v_number = ((di->di_flags & DI_FLAGS_LOCK)
8390 || tv_islocked(&di->di_tv));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008391 }
8392 }
Ernie Rael4c8da022023-10-11 21:35:11 +02008393 else if (lv.ll_is_root)
8394 {
8395 rettv->vval.v_number = tv_islocked(lv.ll_tv);
8396 }
Ernie Rael9771b2a2023-10-07 22:05:40 +02008397 else if (lv.ll_object != NULL)
8398 {
8399 typval_T *tv = ((typval_T *)(lv.ll_object + 1)) + lv.ll_oi;
8400 rettv->vval.v_number = tv_islocked(tv);
8401#ifdef LOG_LOCKVAR
8402 ch_log(NULL, "LKVAR: f_islocked(): name %s (obj)", lv.ll_name);
8403#endif
8404 }
8405 else if (lv.ll_class != NULL)
8406 {
8407 typval_T *tv = &lv.ll_class->class_members_tv[lv.ll_oi];
8408 rettv->vval.v_number = tv_islocked(tv);
8409#ifdef LOG_LOCKVAR
8410 ch_log(NULL, "LKVAR: f_islocked(): name %s (cl)", lv.ll_name);
8411#endif
8412 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008413 else if (lv.ll_range)
Bram Moolenaar677658a2022-01-05 16:09:06 +00008414 emsg(_(e_range_not_allowed));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008415 else if (lv.ll_newkey != NULL)
Bram Moolenaara9fa8c52023-01-02 18:10:04 +00008416 semsg(_(e_key_not_present_in_dictionary_str), lv.ll_newkey);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008417 else if (lv.ll_list != NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008418 // List item.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008419 rettv->vval.v_number = tv_islocked(&lv.ll_li->li_tv);
8420 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008421 // Dictionary item.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008422 rettv->vval.v_number = tv_islocked(&lv.ll_di->di_tv);
8423 }
8424 }
8425
Ernie Rael4c8da022023-10-11 21:35:11 +02008426 if (root != NULL)
8427 free_lval_root(root);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008428 clear_lval(&lv);
8429}
8430
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008431/*
zeertzjqcdc83932022-09-12 13:38:41 +01008432 * "keytrans()" function
8433 */
8434 static void
8435f_keytrans(typval_T *argvars, typval_T *rettv)
8436{
8437 char_u *escaped;
8438
8439 rettv->v_type = VAR_STRING;
8440 if (check_for_string_arg(argvars, 0) == FAIL
8441 || argvars[0].vval.v_string == NULL)
8442 return;
8443 // Need to escape K_SPECIAL and CSI for mb_unescape().
8444 escaped = vim_strsave_escape_csi(argvars[0].vval.v_string);
8445 rettv->vval.v_string = str2special_save(escaped, TRUE, TRUE);
8446 vim_free(escaped);
8447}
8448
8449/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008450 * "last_buffer_nr()" function.
8451 */
8452 static void
8453f_last_buffer_nr(typval_T *argvars UNUSED, typval_T *rettv)
8454{
8455 int n = 0;
8456 buf_T *buf;
8457
Bram Moolenaar29323592016-07-24 22:04:11 +02008458 FOR_ALL_BUFFERS(buf)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008459 if (n < buf->b_fnum)
8460 n = buf->b_fnum;
8461
8462 rettv->vval.v_number = n;
8463}
8464
8465/*
8466 * "len()" function
8467 */
LemonBoy58f331a2022-04-02 21:59:06 +01008468 void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008469f_len(typval_T *argvars, typval_T *rettv)
8470{
8471 switch (argvars[0].v_type)
8472 {
8473 case VAR_STRING:
8474 case VAR_NUMBER:
8475 rettv->vval.v_number = (varnumber_T)STRLEN(
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008476 tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008477 break;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008478 case VAR_BLOB:
8479 rettv->vval.v_number = blob_len(argvars[0].vval.v_blob);
8480 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008481 case VAR_LIST:
8482 rettv->vval.v_number = list_len(argvars[0].vval.v_list);
8483 break;
8484 case VAR_DICT:
8485 rettv->vval.v_number = dict_len(argvars[0].vval.v_dict);
8486 break;
Yegappan Lakshmanand3eae7b2024-03-03 16:26:58 +01008487 case VAR_OBJECT:
8488 rettv->vval.v_number = object_len(argvars[0].vval.v_object);
8489 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008490 case VAR_UNKNOWN:
Bram Moolenaar4c683752020-04-05 21:38:23 +02008491 case VAR_ANY:
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01008492 case VAR_VOID:
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01008493 case VAR_BOOL:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008494 case VAR_SPECIAL:
8495 case VAR_FLOAT:
8496 case VAR_FUNC:
8497 case VAR_PARTIAL:
8498 case VAR_JOB:
8499 case VAR_CHANNEL:
Bram Moolenaarf18332f2021-05-07 17:55:55 +02008500 case VAR_INSTR:
Bram Moolenaar00b28d62022-12-08 15:32:33 +00008501 case VAR_CLASS:
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +02008502 case VAR_TYPEALIAS:
Bram Moolenaara6f79292022-01-04 21:30:47 +00008503 emsg(_(e_invalid_type_for_len));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008504 break;
8505 }
8506}
8507
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008508 static void
Bram Moolenaar6d721c72017-01-17 16:56:28 +01008509libcall_common(typval_T *argvars UNUSED, typval_T *rettv, int type)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008510{
8511#ifdef FEAT_LIBCALL
8512 char_u *string_in;
8513 char_u **string_result;
8514 int nr_result;
8515#endif
8516
8517 rettv->v_type = type;
8518 if (type != VAR_NUMBER)
8519 rettv->vval.v_string = NULL;
8520
8521 if (check_restricted() || check_secure())
8522 return;
8523
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02008524 if (in_vim9script()
8525 && (check_for_string_arg(argvars, 0) == FAIL
8526 || check_for_string_arg(argvars, 1) == FAIL
8527 || check_for_string_or_number_arg(argvars, 2) == FAIL))
8528 return;
8529
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008530#ifdef FEAT_LIBCALL
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008531 // The first two args must be strings, otherwise it's meaningless
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008532 if (argvars[0].v_type == VAR_STRING && argvars[1].v_type == VAR_STRING)
8533 {
8534 string_in = NULL;
8535 if (argvars[2].v_type == VAR_STRING)
8536 string_in = argvars[2].vval.v_string;
8537 if (type == VAR_NUMBER)
Bram Moolenaar87e15872021-09-02 19:53:07 +02008538 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008539 string_result = NULL;
Bram Moolenaar87e15872021-09-02 19:53:07 +02008540 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008541 else
Bram Moolenaar87e15872021-09-02 19:53:07 +02008542 {
8543 rettv->vval.v_string = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008544 string_result = &rettv->vval.v_string;
Bram Moolenaar87e15872021-09-02 19:53:07 +02008545 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008546 if (mch_libcall(argvars[0].vval.v_string,
8547 argvars[1].vval.v_string,
8548 string_in,
8549 argvars[2].vval.v_number,
8550 string_result,
8551 &nr_result) == OK
8552 && type == VAR_NUMBER)
8553 rettv->vval.v_number = nr_result;
8554 }
8555#endif
8556}
8557
8558/*
8559 * "libcall()" function
8560 */
8561 static void
8562f_libcall(typval_T *argvars, typval_T *rettv)
8563{
8564 libcall_common(argvars, rettv, VAR_STRING);
8565}
8566
8567/*
8568 * "libcallnr()" function
8569 */
8570 static void
8571f_libcallnr(typval_T *argvars, typval_T *rettv)
8572{
8573 libcall_common(argvars, rettv, VAR_NUMBER);
8574}
8575
8576/*
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008577 * "line(string, [winid])" function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008578 */
8579 static void
8580f_line(typval_T *argvars, typval_T *rettv)
8581{
8582 linenr_T lnum = 0;
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008583 pos_T *fp = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008584 int fnum;
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008585 int id;
8586 tabpage_T *tp;
8587 win_T *wp;
Bram Moolenaar18f47402022-01-06 13:24:51 +00008588 switchwin_T switchwin;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008589
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02008590 if (in_vim9script()
8591 && (check_for_string_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008592 || check_for_opt_number_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02008593 return;
8594
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008595 if (argvars[1].v_type != VAR_UNKNOWN)
8596 {
8597 // use window specified in the second argument
8598 id = (int)tv_get_number(&argvars[1]);
8599 wp = win_id2wp_tp(id, &tp);
8600 if (wp != NULL && tp != NULL)
8601 {
Bram Moolenaar18f47402022-01-06 13:24:51 +00008602 if (switch_win_noblock(&switchwin, wp, tp, TRUE) == OK)
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008603 {
John Marriott69f85c62024-10-31 10:53:43 +01008604#ifdef FEAT_DIFF
Christian Brabandt05a40e02024-10-29 20:29:04 +01008605 // in diff mode, prevent that the window scrolls
8606 // and keep the topline
8607 if (curwin->w_p_diff && switchwin.sw_curwin->w_p_diff)
8608 skip_update_topline = TRUE;
John Marriott69f85c62024-10-31 10:53:43 +01008609#endif
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008610 check_cursor();
Bram Moolenaar6f02b002021-01-10 20:22:54 +01008611 fp = var2fpos(&argvars[0], TRUE, &fnum, FALSE);
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008612 }
John Marriott69f85c62024-10-31 10:53:43 +01008613#ifdef FEAT_DIFF
Christian Brabandt05a40e02024-10-29 20:29:04 +01008614 if (curwin->w_p_diff && switchwin.sw_curwin->w_p_diff)
8615 skip_update_topline = FALSE;
John Marriott69f85c62024-10-31 10:53:43 +01008616#endif
Bram Moolenaar18f47402022-01-06 13:24:51 +00008617 restore_win_noblock(&switchwin, TRUE);
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008618 }
8619 }
8620 else
8621 // use current window
Bram Moolenaar6f02b002021-01-10 20:22:54 +01008622 fp = var2fpos(&argvars[0], TRUE, &fnum, FALSE);
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008623
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008624 if (fp != NULL)
8625 lnum = fp->lnum;
8626 rettv->vval.v_number = lnum;
8627}
8628
8629/*
8630 * "line2byte(lnum)" function
8631 */
8632 static void
8633f_line2byte(typval_T *argvars UNUSED, typval_T *rettv)
8634{
8635#ifndef FEAT_BYTEOFF
8636 rettv->vval.v_number = -1;
8637#else
8638 linenr_T lnum;
8639
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008640 if (in_vim9script() && check_for_lnum_arg(argvars, 0) == FAIL)
8641 return;
8642
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008643 lnum = tv_get_lnum(argvars);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008644 if (lnum < 1 || lnum > curbuf->b_ml.ml_line_count + 1)
8645 rettv->vval.v_number = -1;
8646 else
8647 rettv->vval.v_number = ml_find_line_or_offset(curbuf, lnum, NULL);
8648 if (rettv->vval.v_number >= 0)
8649 ++rettv->vval.v_number;
8650#endif
8651}
8652
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008653#ifdef FEAT_LUA
8654/*
8655 * "luaeval()" function
8656 */
8657 static void
8658f_luaeval(typval_T *argvars, typval_T *rettv)
8659{
8660 char_u *str;
8661 char_u buf[NUMBUFLEN];
8662
Bram Moolenaar8c62a082019-02-08 14:34:10 +01008663 if (check_restricted() || check_secure())
8664 return;
8665
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02008666 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
8667 return;
8668
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008669 str = tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008670 do_luaeval(str, argvars + 1, rettv);
8671}
8672#endif
8673
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008674typedef enum
8675{
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008676 MATCH_END, // matchend()
8677 MATCH_MATCH, // match()
8678 MATCH_STR, // matchstr()
8679 MATCH_LIST, // matchlist()
8680 MATCH_POS // matchstrpos()
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008681} matchtype_T;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008682
8683 static void
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008684find_some_match(typval_T *argvars, typval_T *rettv, matchtype_T type)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008685{
8686 char_u *str = NULL;
8687 long len = 0;
8688 char_u *expr = NULL;
8689 char_u *pat;
8690 regmatch_T regmatch;
8691 char_u patbuf[NUMBUFLEN];
8692 char_u strbuf[NUMBUFLEN];
8693 char_u *save_cpo;
8694 long start = 0;
8695 long nth = 1;
8696 colnr_T startcol = 0;
8697 int match = 0;
8698 list_T *l = NULL;
8699 listitem_T *li = NULL;
8700 long idx = 0;
8701 char_u *tofree = NULL;
8702
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008703 // Make 'cpoptions' empty, the 'l' flag should not be used here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008704 save_cpo = p_cpo;
Bram Moolenaare5a2dc82021-01-03 19:52:05 +01008705 p_cpo = empty_option;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008706
8707 rettv->vval.v_number = -1;
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008708 if (type == MATCH_LIST || type == MATCH_POS)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008709 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008710 // type MATCH_LIST: return empty list when there are no matches.
8711 // type MATCH_POS: return ["", -1, -1, -1]
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008712 if (rettv_list_alloc(rettv) == FAIL)
8713 goto theend;
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008714 if (type == MATCH_POS
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008715 && (list_append_string(rettv->vval.v_list,
8716 (char_u *)"", 0) == FAIL
8717 || list_append_number(rettv->vval.v_list,
8718 (varnumber_T)-1) == FAIL
8719 || list_append_number(rettv->vval.v_list,
8720 (varnumber_T)-1) == FAIL
8721 || list_append_number(rettv->vval.v_list,
8722 (varnumber_T)-1) == FAIL))
8723 {
8724 list_free(rettv->vval.v_list);
8725 rettv->vval.v_list = NULL;
8726 goto theend;
8727 }
8728 }
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008729 else if (type == MATCH_STR)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008730 {
8731 rettv->v_type = VAR_STRING;
8732 rettv->vval.v_string = NULL;
8733 }
8734
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02008735 if (in_vim9script()
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008736 && (check_for_string_or_list_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008737 || check_for_string_arg(argvars, 1) == FAIL
8738 || check_for_opt_number_arg(argvars, 2) == FAIL
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02008739 || (argvars[2].v_type != VAR_UNKNOWN
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008740 && check_for_opt_number_arg(argvars, 3) == FAIL)))
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02008741 goto theend;
8742
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008743 if (argvars[0].v_type == VAR_LIST)
8744 {
8745 if ((l = argvars[0].vval.v_list) == NULL)
8746 goto theend;
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02008747 CHECK_LIST_MATERIALIZE(l);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008748 li = l->lv_first;
8749 }
8750 else
8751 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008752 expr = str = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008753 len = (long)STRLEN(str);
8754 }
8755
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008756 pat = tv_get_string_buf_chk(&argvars[1], patbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008757 if (pat == NULL)
8758 goto theend;
8759
8760 if (argvars[2].v_type != VAR_UNKNOWN)
8761 {
8762 int error = FALSE;
8763
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008764 start = (long)tv_get_number_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008765 if (error)
8766 goto theend;
8767 if (l != NULL)
8768 {
8769 li = list_find(l, start);
8770 if (li == NULL)
8771 goto theend;
Bram Moolenaar0ff6aad2020-01-29 21:27:21 +01008772 idx = l->lv_u.mat.lv_idx; // use the cached index
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008773 }
8774 else
8775 {
8776 if (start < 0)
8777 start = 0;
8778 if (start > len)
8779 goto theend;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008780 // When "count" argument is there ignore matches before "start",
8781 // otherwise skip part of the string. Differs when pattern is "^"
8782 // or "\<".
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008783 if (argvars[3].v_type != VAR_UNKNOWN)
8784 startcol = start;
8785 else
8786 {
8787 str += start;
8788 len -= start;
8789 }
8790 }
8791
8792 if (argvars[3].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008793 nth = (long)tv_get_number_chk(&argvars[3], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008794 if (error)
8795 goto theend;
8796 }
8797
8798 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
8799 if (regmatch.regprog != NULL)
8800 {
8801 regmatch.rm_ic = p_ic;
8802
8803 for (;;)
8804 {
8805 if (l != NULL)
8806 {
8807 if (li == NULL)
8808 {
8809 match = FALSE;
8810 break;
8811 }
8812 vim_free(tofree);
8813 expr = str = echo_string(&li->li_tv, &tofree, strbuf, 0);
8814 if (str == NULL)
8815 break;
8816 }
8817
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +00008818 match = vim_regexec_nl(&regmatch, str, startcol);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008819
8820 if (match && --nth <= 0)
8821 break;
8822 if (l == NULL && !match)
8823 break;
8824
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008825 // Advance to just after the match.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008826 if (l != NULL)
8827 {
8828 li = li->li_next;
8829 ++idx;
8830 }
8831 else
8832 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008833 startcol = (colnr_T)(regmatch.startp[0]
8834 + (*mb_ptr2len)(regmatch.startp[0]) - str);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008835 if (startcol > (colnr_T)len
8836 || str + startcol <= regmatch.startp[0])
8837 {
8838 match = FALSE;
8839 break;
8840 }
8841 }
8842 }
8843
8844 if (match)
8845 {
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008846 if (type == MATCH_POS)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008847 {
8848 listitem_T *li1 = rettv->vval.v_list->lv_first;
8849 listitem_T *li2 = li1->li_next;
8850 listitem_T *li3 = li2->li_next;
8851 listitem_T *li4 = li3->li_next;
8852
8853 vim_free(li1->li_tv.vval.v_string);
8854 li1->li_tv.vval.v_string = vim_strnsave(regmatch.startp[0],
Bram Moolenaardf44a272020-06-07 20:49:05 +02008855 regmatch.endp[0] - regmatch.startp[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008856 li3->li_tv.vval.v_number =
8857 (varnumber_T)(regmatch.startp[0] - expr);
8858 li4->li_tv.vval.v_number =
8859 (varnumber_T)(regmatch.endp[0] - expr);
8860 if (l != NULL)
8861 li2->li_tv.vval.v_number = (varnumber_T)idx;
8862 }
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008863 else if (type == MATCH_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008864 {
8865 int i;
8866
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008867 // return list with matched string and submatches
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008868 for (i = 0; i < NSUBEXP; ++i)
8869 {
8870 if (regmatch.endp[i] == NULL)
8871 {
8872 if (list_append_string(rettv->vval.v_list,
8873 (char_u *)"", 0) == FAIL)
8874 break;
8875 }
8876 else if (list_append_string(rettv->vval.v_list,
8877 regmatch.startp[i],
8878 (int)(regmatch.endp[i] - regmatch.startp[i]))
8879 == FAIL)
8880 break;
8881 }
8882 }
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008883 else if (type == MATCH_STR)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008884 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008885 // return matched string
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008886 if (l != NULL)
8887 copy_tv(&li->li_tv, rettv);
8888 else
8889 rettv->vval.v_string = vim_strnsave(regmatch.startp[0],
Bram Moolenaardf44a272020-06-07 20:49:05 +02008890 regmatch.endp[0] - regmatch.startp[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008891 }
8892 else if (l != NULL)
8893 rettv->vval.v_number = idx;
8894 else
8895 {
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008896 if (type != MATCH_END)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008897 rettv->vval.v_number =
8898 (varnumber_T)(regmatch.startp[0] - str);
8899 else
8900 rettv->vval.v_number =
8901 (varnumber_T)(regmatch.endp[0] - str);
8902 rettv->vval.v_number += (varnumber_T)(str - expr);
8903 }
8904 }
8905 vim_regfree(regmatch.regprog);
8906 }
8907
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008908theend:
8909 if (type == MATCH_POS && l == NULL && rettv->vval.v_list != NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008910 // matchstrpos() without a list: drop the second item.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008911 listitem_remove(rettv->vval.v_list,
8912 rettv->vval.v_list->lv_first->li_next);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008913 vim_free(tofree);
8914 p_cpo = save_cpo;
8915}
8916
8917/*
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01008918 * Return all the matches in string "str" for pattern "rmp".
8919 * The matches are returned in the List "mlist".
8920 * If "submatches" is TRUE, then submatch information is also returned.
8921 * "matchbuf" is TRUE when called for matchbufline().
8922 */
8923 static int
8924get_matches_in_str(
8925 char_u *str,
8926 regmatch_T *rmp,
8927 list_T *mlist,
8928 int idx,
8929 int submatches,
8930 int matchbuf)
8931{
8932 long len = (long)STRLEN(str);
8933 int match = 0;
8934 colnr_T startidx = 0;
8935
8936 for (;;)
8937 {
8938 match = vim_regexec_nl(rmp, str, startidx);
8939 if (!match)
8940 break;
8941
8942 dict_T *d = dict_alloc();
8943 if (d == NULL)
8944 return FAIL;
8945 if (list_append_dict(mlist, d) == FAIL)
8946 return FAIL;;
8947
8948 if (dict_add_number(d, matchbuf ? "lnum" : "idx", idx) == FAIL)
8949 return FAIL;
8950
8951 if (dict_add_number(d, "byteidx",
8952 (colnr_T)(rmp->startp[0] - str)) == FAIL)
8953 return FAIL;
8954
8955 if (dict_add_string_len(d, "text", rmp->startp[0],
8956 (int)(rmp->endp[0] - rmp->startp[0])) == FAIL)
8957 return FAIL;
8958
8959 if (submatches)
8960 {
8961 list_T *sml = list_alloc();
8962 if (sml == NULL)
8963 return FAIL;
8964
8965 if (dict_add_list(d, "submatches", sml) == FAIL)
8966 return FAIL;
8967
8968 // return a list with the submatches
8969 for (int i = 1; i < NSUBEXP; ++i)
8970 {
8971 if (rmp->endp[i] == NULL)
8972 {
8973 if (list_append_string(sml, (char_u *)"", 0) == FAIL)
8974 return FAIL;
8975 }
8976 else if (list_append_string(sml, rmp->startp[i],
8977 (int)(rmp->endp[i] - rmp->startp[i])) == FAIL)
8978 return FAIL;
8979 }
8980 }
8981 startidx = (colnr_T)(rmp->endp[0] - str);
8982 if (startidx >= (colnr_T)len || str + startidx <= rmp->startp[0])
8983 break;
8984 }
8985
8986 return OK;
8987}
8988
8989/*
8990 * "matchbufline()" function
8991 */
8992 static void
8993f_matchbufline(typval_T *argvars, typval_T *rettv)
8994{
8995 list_T *retlist = NULL;
8996 char_u *save_cpo;
8997 char_u patbuf[NUMBUFLEN];
8998 regmatch_T regmatch;
8999
9000 rettv->vval.v_number = -1;
9001 if (rettv_list_alloc(rettv) != OK)
9002 return;
9003 retlist = rettv->vval.v_list;
9004
9005 if (check_for_buffer_arg(argvars, 0) == FAIL
9006 || check_for_string_arg(argvars, 1) == FAIL
9007 || check_for_lnum_arg(argvars, 2) == FAIL
9008 || check_for_lnum_arg(argvars, 3) == FAIL
9009 || check_for_opt_dict_arg(argvars, 4) == FAIL)
9010 return;
9011
9012 int prev_did_emsg = did_emsg;
9013 buf_T *buf = tv_get_buf(&argvars[0], FALSE);
9014 if (buf == NULL)
9015 {
9016 if (did_emsg == prev_did_emsg)
9017 semsg(_(e_invalid_buffer_name_str), tv_get_string(&argvars[0]));
9018 return;
9019 }
9020 if (buf->b_ml.ml_mfp == NULL)
9021 {
9022 emsg(_(e_buffer_is_not_loaded));
9023 return;
9024 }
9025
9026 char_u *pat = tv_get_string_buf(&argvars[1], patbuf);
9027
9028 int did_emsg_before = did_emsg;
9029 linenr_T slnum = tv_get_lnum_buf(&argvars[2], buf);
9030 if (did_emsg > did_emsg_before)
9031 return;
9032 if (slnum < 1)
9033 {
9034 semsg(_(e_invalid_value_for_argument_str), "lnum");
9035 return;
9036 }
9037
9038 linenr_T elnum = tv_get_lnum_buf(&argvars[3], buf);
9039 if (did_emsg > did_emsg_before)
9040 return;
9041 if (elnum < 1 || elnum < slnum)
9042 {
9043 semsg(_(e_invalid_value_for_argument_str), "end_lnum");
9044 return;
9045 }
9046
9047 if (elnum > buf->b_ml.ml_line_count)
9048 elnum = buf->b_ml.ml_line_count;
9049
9050 int submatches = FALSE;
9051 if (argvars[4].v_type != VAR_UNKNOWN)
9052 {
9053 dict_T *d = argvars[4].vval.v_dict;
9054 if (d != NULL)
9055 {
9056 dictitem_T *di = dict_find(d, (char_u *)"submatches", -1);
9057 if (di != NULL)
9058 {
9059 if (di->di_tv.v_type != VAR_BOOL)
9060 {
9061 semsg(_(e_invalid_value_for_argument_str), "submatches");
9062 return;
9063 }
9064 submatches = tv_get_bool(&di->di_tv);
9065 }
9066 }
9067 }
9068
9069 // Make 'cpoptions' empty, the 'l' flag should not be used here.
9070 save_cpo = p_cpo;
9071 p_cpo = empty_option;
9072
9073 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
9074 if (regmatch.regprog == NULL)
9075 goto theend;
9076 regmatch.rm_ic = p_ic;
9077
9078 while (slnum <= elnum)
9079 {
9080 char_u *str = ml_get_buf(buf, slnum, FALSE);
9081 if (get_matches_in_str(str, &regmatch, retlist, slnum, submatches,
9082 TRUE) == FAIL)
9083 goto cleanup;
9084 slnum++;
9085 }
9086
9087cleanup:
9088 vim_regfree(regmatch.regprog);
9089
9090theend:
9091 p_cpo = save_cpo;
9092}
9093
9094/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009095 * "match()" function
9096 */
9097 static void
9098f_match(typval_T *argvars, typval_T *rettv)
9099{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009100 find_some_match(argvars, rettv, MATCH_MATCH);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009101}
9102
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009103/*
9104 * "matchend()" function
9105 */
9106 static void
9107f_matchend(typval_T *argvars, typval_T *rettv)
9108{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009109 find_some_match(argvars, rettv, MATCH_END);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009110}
9111
9112/*
9113 * "matchlist()" function
9114 */
9115 static void
9116f_matchlist(typval_T *argvars, typval_T *rettv)
9117{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009118 find_some_match(argvars, rettv, MATCH_LIST);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009119}
9120
9121/*
9122 * "matchstr()" function
9123 */
9124 static void
9125f_matchstr(typval_T *argvars, typval_T *rettv)
9126{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009127 find_some_match(argvars, rettv, MATCH_STR);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009128}
9129
9130/*
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01009131 * "matchstrlist()" function
9132 */
9133 static void
9134f_matchstrlist(typval_T *argvars, typval_T *rettv)
9135{
9136 list_T *retlist = NULL;
9137 char_u *save_cpo;
9138 list_T *l = NULL;
9139 listitem_T *li = NULL;
9140 char_u patbuf[NUMBUFLEN];
9141 regmatch_T regmatch;
9142
9143 rettv->vval.v_number = -1;
9144 if (rettv_list_alloc(rettv) != OK)
9145 return;
9146 retlist = rettv->vval.v_list;
9147
9148 if (check_for_list_arg(argvars, 0) == FAIL
9149 || check_for_string_arg(argvars, 1) == FAIL
9150 || check_for_opt_dict_arg(argvars, 2) == FAIL)
9151 return;
9152
9153 if ((l = argvars[0].vval.v_list) == NULL)
9154 return;
9155
9156 char_u *pat = tv_get_string_buf_chk(&argvars[1], patbuf);
9157 if (pat == NULL)
9158 return;
9159
9160 // Make 'cpoptions' empty, the 'l' flag should not be used here.
9161 save_cpo = p_cpo;
9162 p_cpo = empty_option;
9163
9164 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
9165 if (regmatch.regprog == NULL)
9166 goto theend;
9167 regmatch.rm_ic = p_ic;
9168
9169 int submatches = FALSE;
9170 if (argvars[2].v_type != VAR_UNKNOWN)
9171 {
9172 dict_T *d = argvars[2].vval.v_dict;
9173 if (d != NULL)
9174 {
9175 dictitem_T *di = dict_find(d, (char_u *)"submatches", -1);
9176 if (di != NULL)
9177 {
9178 if (di->di_tv.v_type != VAR_BOOL)
9179 {
9180 semsg(_(e_invalid_value_for_argument_str), "submatches");
9181 goto cleanup;
9182 }
9183 submatches = tv_get_bool(&di->di_tv);
9184 }
9185 }
9186 }
9187
9188 int idx = 0;
9189 CHECK_LIST_MATERIALIZE(l);
9190 FOR_ALL_LIST_ITEMS(l, li)
9191 {
9192 if (li->li_tv.v_type == VAR_STRING && li->li_tv.vval.v_string != NULL)
9193 {
9194 char_u *str = li->li_tv.vval.v_string;
9195 if (get_matches_in_str(str, &regmatch, retlist, idx, submatches,
9196 FALSE) == FAIL)
9197 goto cleanup;
9198 }
9199 idx++;
9200 }
9201
9202cleanup:
9203 vim_regfree(regmatch.regprog);
9204
9205theend:
9206 p_cpo = save_cpo;
9207}
9208
9209/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009210 * "matchstrpos()" function
9211 */
9212 static void
9213f_matchstrpos(typval_T *argvars, typval_T *rettv)
9214{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009215 find_some_match(argvars, rettv, MATCH_POS);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009216}
9217
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009218 static void
9219max_min(typval_T *argvars, typval_T *rettv, int domax)
9220{
9221 varnumber_T n = 0;
9222 varnumber_T i;
9223 int error = FALSE;
9224
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009225 if (in_vim9script() && check_for_list_or_dict_arg(argvars, 0) == FAIL)
9226 return;
9227
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009228 if (argvars[0].v_type == VAR_LIST)
9229 {
9230 list_T *l;
9231 listitem_T *li;
9232
9233 l = argvars[0].vval.v_list;
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009234 if (l != NULL && l->lv_len > 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009235 {
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009236 if (l->lv_first == &range_list_item)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009237 {
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009238 if ((l->lv_u.nonmat.lv_stride > 0) ^ domax)
9239 n = l->lv_u.nonmat.lv_start;
9240 else
=?UTF-8?q?Dundar=20G=C3=B6c?=d5cec1f2022-01-29 15:19:23 +00009241 n = l->lv_u.nonmat.lv_start + ((varnumber_T)l->lv_len - 1)
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009242 * l->lv_u.nonmat.lv_stride;
9243 }
9244 else
9245 {
9246 li = l->lv_first;
9247 if (li != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009248 {
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009249 n = tv_get_number_chk(&li->li_tv, &error);
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009250 if (error)
9251 return; // type error; errmsg already given
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009252 for (;;)
9253 {
9254 li = li->li_next;
9255 if (li == NULL)
9256 break;
9257 i = tv_get_number_chk(&li->li_tv, &error);
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009258 if (error)
9259 return; // type error; errmsg already given
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009260 if (domax ? i > n : i < n)
9261 n = i;
9262 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009263 }
9264 }
9265 }
9266 }
9267 else if (argvars[0].v_type == VAR_DICT)
9268 {
9269 dict_T *d;
9270 int first = TRUE;
9271 hashitem_T *hi;
9272 int todo;
9273
9274 d = argvars[0].vval.v_dict;
9275 if (d != NULL)
9276 {
9277 todo = (int)d->dv_hashtab.ht_used;
Yegappan Lakshmanan14113fd2023-03-07 17:13:51 +00009278 FOR_ALL_HASHTAB_ITEMS(&d->dv_hashtab, hi, todo)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009279 {
9280 if (!HASHITEM_EMPTY(hi))
9281 {
9282 --todo;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009283 i = tv_get_number_chk(&HI2DI(hi)->di_tv, &error);
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009284 if (error)
9285 return; // type error; errmsg already given
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009286 if (first)
9287 {
9288 n = i;
9289 first = FALSE;
9290 }
9291 else if (domax ? i > n : i < n)
9292 n = i;
9293 }
9294 }
9295 }
9296 }
9297 else
Bram Moolenaar460ae5d2022-01-01 14:19:49 +00009298 semsg(_(e_argument_of_str_must_be_list_or_dictionary), domax ? "max()" : "min()");
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009299
9300 rettv->vval.v_number = n;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009301}
9302
9303/*
9304 * "max()" function
9305 */
9306 static void
9307f_max(typval_T *argvars, typval_T *rettv)
9308{
9309 max_min(argvars, rettv, TRUE);
9310}
9311
9312/*
9313 * "min()" function
9314 */
9315 static void
9316f_min(typval_T *argvars, typval_T *rettv)
9317{
9318 max_min(argvars, rettv, FALSE);
9319}
9320
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009321#if defined(FEAT_MZSCHEME) || defined(PROTO)
9322/*
9323 * "mzeval()" function
9324 */
9325 static void
9326f_mzeval(typval_T *argvars, typval_T *rettv)
9327{
9328 char_u *str;
9329 char_u buf[NUMBUFLEN];
9330
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009331 if (check_restricted() || check_secure())
9332 return;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009333
9334 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
9335 return;
9336
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009337 str = tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009338 do_mzeval(str, rettv);
9339}
9340
9341 void
9342mzscheme_call_vim(char_u *name, typval_T *args, typval_T *rettv)
9343{
9344 typval_T argvars[3];
9345
9346 argvars[0].v_type = VAR_STRING;
9347 argvars[0].vval.v_string = name;
9348 copy_tv(args, &argvars[1]);
9349 argvars[2].v_type = VAR_UNKNOWN;
9350 f_call(argvars, rettv);
9351 clear_tv(&argvars[1]);
9352}
9353#endif
9354
9355/*
9356 * "nextnonblank()" function
9357 */
9358 static void
9359f_nextnonblank(typval_T *argvars, typval_T *rettv)
9360{
9361 linenr_T lnum;
9362
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009363 if (in_vim9script() && check_for_lnum_arg(argvars, 0) == FAIL)
9364 return;
9365
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009366 for (lnum = tv_get_lnum(argvars); ; ++lnum)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009367 {
9368 if (lnum < 0 || lnum > curbuf->b_ml.ml_line_count)
9369 {
9370 lnum = 0;
9371 break;
9372 }
9373 if (*skipwhite(ml_get(lnum)) != NUL)
9374 break;
9375 }
9376 rettv->vval.v_number = lnum;
9377}
9378
Christ van Willegenc0786752025-02-01 15:42:16 +01009379
9380/*
9381 * "ngettext()" function
9382 */
9383 static void
9384f_ngettext(typval_T *argvars, typval_T *rettv)
9385{
9386#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
9387 char *prev = NULL;
9388#endif
9389
9390 if (check_for_nonempty_string_arg(argvars, 0) == FAIL
9391 || check_for_nonempty_string_arg(argvars, 1) == FAIL
9392 || check_for_number_arg(argvars, 2) == FAIL
9393 || check_for_opt_string_arg(argvars, 3) == FAIL)
9394 return;
9395
9396 rettv->v_type = VAR_STRING;
9397
9398 if (argvars[3].v_type == VAR_STRING &&
9399 argvars[3].vval.v_string != NULL &&
9400 *(argvars[3].vval.v_string) != NUL)
9401 {
9402#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
9403 prev = bind_textdomain_codeset((const char *)argvars[3].vval.v_string, (char *)p_enc);
9404#endif
9405
9406#if defined(HAVE_DNGETTEXT)
9407 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));
9408#else
9409 textdomain((const char *)argvars[3].vval.v_string);
9410 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));
9411 textdomain(VIMPACKAGE);
9412#endif
9413
9414#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
9415 if (prev != NULL)
9416 bind_textdomain_codeset((const char *)argvars[3].vval.v_string, prev);
9417#endif
9418 }
9419 else
9420 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));
9421}
9422
9423
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009424/*
9425 * "nr2char()" function
9426 */
9427 static void
9428f_nr2char(typval_T *argvars, typval_T *rettv)
9429{
9430 char_u buf[NUMBUFLEN];
9431
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02009432 if (in_vim9script()
9433 && (check_for_number_arg(argvars, 0) == FAIL
9434 || check_for_opt_bool_arg(argvars, 1) == FAIL))
9435 return;
9436
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009437 if (has_mbyte)
9438 {
9439 int utf8 = 0;
9440
9441 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaared6a4302020-09-05 20:29:41 +02009442 utf8 = (int)tv_get_bool_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009443 if (utf8)
Bram Moolenaarbdace832019-03-02 10:13:42 +01009444 buf[utf_char2bytes((int)tv_get_number(&argvars[0]), buf)] = NUL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009445 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009446 buf[(*mb_char2bytes)((int)tv_get_number(&argvars[0]), buf)] = NUL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009447 }
9448 else
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009449 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009450 buf[0] = (char_u)tv_get_number(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009451 buf[1] = NUL;
9452 }
9453 rettv->v_type = VAR_STRING;
9454 rettv->vval.v_string = vim_strsave(buf);
9455}
9456
9457/*
9458 * "or(expr, expr)" function
9459 */
9460 static void
9461f_or(typval_T *argvars, typval_T *rettv)
9462{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009463 if (in_vim9script()
9464 && (check_for_number_arg(argvars, 0) == FAIL
9465 || check_for_number_arg(argvars, 1) == FAIL))
9466 return;
9467
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009468 rettv->vval.v_number = tv_get_number_chk(&argvars[0], NULL)
9469 | tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009470}
9471
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009472#ifdef FEAT_PERL
9473/*
9474 * "perleval()" function
9475 */
9476 static void
9477f_perleval(typval_T *argvars, typval_T *rettv)
9478{
9479 char_u *str;
9480 char_u buf[NUMBUFLEN];
9481
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009482 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
9483 return;
9484
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009485 str = tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009486 do_perleval(str, rettv);
9487}
9488#endif
9489
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009490/*
9491 * "prevnonblank()" function
9492 */
9493 static void
9494f_prevnonblank(typval_T *argvars, typval_T *rettv)
9495{
9496 linenr_T lnum;
9497
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009498 if (in_vim9script() && check_for_lnum_arg(argvars, 0) == FAIL)
9499 return;
9500
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009501 lnum = tv_get_lnum(argvars);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009502 if (lnum < 1 || lnum > curbuf->b_ml.ml_line_count)
9503 lnum = 0;
9504 else
9505 while (lnum >= 1 && *skipwhite(ml_get(lnum)) == NUL)
9506 --lnum;
9507 rettv->vval.v_number = lnum;
9508}
9509
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009510// This dummy va_list is here because:
9511// - passing a NULL pointer doesn't work when va_list isn't a pointer
9512// - locally in the function results in a "used before set" warning
9513// - using va_start() to initialize it gives "function with fixed args" error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009514static va_list ap;
9515
9516/*
9517 * "printf()" function
9518 */
9519 static void
9520f_printf(typval_T *argvars, typval_T *rettv)
9521{
9522 char_u buf[NUMBUFLEN];
9523 int len;
9524 char_u *s;
9525 int saved_did_emsg = did_emsg;
9526 char *fmt;
9527
9528 rettv->v_type = VAR_STRING;
9529 rettv->vval.v_string = NULL;
9530
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02009531 if (in_vim9script() && check_for_string_or_number_arg(argvars, 0) == FAIL)
9532 return;
9533
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009534 // Get the required length, allocate the buffer and do it for real.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009535 did_emsg = FALSE;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009536 fmt = (char *)tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar8327d1d2017-07-11 22:34:51 +02009537 len = vim_vsnprintf_typval(NULL, 0, fmt, ap, argvars + 1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009538 if (!did_emsg)
9539 {
9540 s = alloc(len + 1);
9541 if (s != NULL)
9542 {
9543 rettv->vval.v_string = s;
Bram Moolenaar8327d1d2017-07-11 22:34:51 +02009544 (void)vim_vsnprintf_typval((char *)s, len + 1, fmt,
9545 ap, argvars + 1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009546 }
9547 }
9548 did_emsg |= saved_did_emsg;
9549}
9550
9551/*
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009552 * "pum_getpos()" function
9553 */
9554 static void
9555f_pum_getpos(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
9556{
Bram Moolenaar93a10962022-06-16 11:42:09 +01009557 if (rettv_dict_alloc(rettv) == FAIL)
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009558 return;
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009559 pum_set_event_info(rettv->vval.v_dict);
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009560}
9561
9562/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009563 * "pumvisible()" function
9564 */
9565 static void
9566f_pumvisible(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
9567{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009568 if (pum_visible())
9569 rettv->vval.v_number = 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009570}
9571
9572#ifdef FEAT_PYTHON3
9573/*
9574 * "py3eval()" function
9575 */
9576 static void
9577f_py3eval(typval_T *argvars, typval_T *rettv)
9578{
9579 char_u *str;
9580 char_u buf[NUMBUFLEN];
Ben Jacksonea19e782024-11-06 21:50:05 +01009581 dict_T *locals;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009582
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009583 if (check_restricted() || check_secure())
9584 return;
9585
Ben Jacksonea19e782024-11-06 21:50:05 +01009586 if (in_vim9script()
9587 && (check_for_string_arg(argvars, 0) == FAIL
9588 || check_for_opt_dict_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009589 return;
9590
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009591 if (p_pyx == 0)
9592 p_pyx = 3;
9593
Ben Jacksonea19e782024-11-06 21:50:05 +01009594 if (argvars[1].v_type == VAR_DICT)
9595 {
9596 locals = argvars[1].vval.v_dict;
9597 }
9598 else if (argvars[1].v_type != VAR_UNKNOWN)
9599 {
9600 emsg(_(e_dictionary_required));
9601 return;
9602 }
9603 else
9604 {
9605 locals = NULL;
9606 }
9607
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009608 str = tv_get_string_buf(&argvars[0], buf);
Ben Jacksonea19e782024-11-06 21:50:05 +01009609 do_py3eval(str, locals, rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009610}
9611#endif
9612
9613#ifdef FEAT_PYTHON
9614/*
9615 * "pyeval()" function
9616 */
9617 static void
9618f_pyeval(typval_T *argvars, typval_T *rettv)
9619{
9620 char_u *str;
9621 char_u buf[NUMBUFLEN];
Ben Jacksonea19e782024-11-06 21:50:05 +01009622 dict_T *locals;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009623
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009624 if (check_restricted() || check_secure())
9625 return;
9626
Ben Jacksonea19e782024-11-06 21:50:05 +01009627 if (in_vim9script() && (
9628 check_for_string_arg(argvars, 0) == FAIL ||
9629 check_for_opt_dict_arg(argvars, 1) == FAIL ) )
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009630 return;
9631
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009632 if (p_pyx == 0)
9633 p_pyx = 2;
9634
Ben Jacksonea19e782024-11-06 21:50:05 +01009635 if (argvars[1].v_type == VAR_DICT)
9636 {
9637 locals = argvars[1].vval.v_dict;
9638 }
9639 else if (argvars[1].v_type != VAR_UNKNOWN)
9640 {
9641 emsg( "Invalid argument: must be dict" );
9642 return;
9643 }
9644 else
9645 {
9646 locals = NULL;
9647 }
9648
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009649 str = tv_get_string_buf(&argvars[0], buf);
Ben Jacksonea19e782024-11-06 21:50:05 +01009650 do_pyeval(str, locals, rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009651}
9652#endif
9653
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009654#if defined(FEAT_PYTHON) || defined(FEAT_PYTHON3)
9655/*
9656 * "pyxeval()" function
9657 */
9658 static void
9659f_pyxeval(typval_T *argvars, typval_T *rettv)
9660{
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009661 if (check_restricted() || check_secure())
9662 return;
9663
Ben Jacksonea19e782024-11-06 21:50:05 +01009664 if (in_vim9script()
9665 && (check_for_string_arg(argvars, 0) == FAIL
9666 || check_for_opt_dict_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009667 return;
9668
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009669# if defined(FEAT_PYTHON) && defined(FEAT_PYTHON3)
9670 init_pyxversion();
9671 if (p_pyx == 2)
9672 f_pyeval(argvars, rettv);
9673 else
9674 f_py3eval(argvars, rettv);
9675# elif defined(FEAT_PYTHON)
9676 f_pyeval(argvars, rettv);
9677# elif defined(FEAT_PYTHON3)
9678 f_py3eval(argvars, rettv);
9679# endif
9680}
9681#endif
9682
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009683static UINT32_T srand_seed_for_testing = 0;
9684static int srand_seed_for_testing_is_used = FALSE;
9685
9686 static void
9687f_test_srand_seed(typval_T *argvars, typval_T *rettv UNUSED)
9688{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009689 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
9690 return;
9691
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009692 if (argvars[0].v_type == VAR_UNKNOWN)
Bram Moolenaar7633fe52020-06-22 19:10:56 +02009693 srand_seed_for_testing_is_used = FALSE;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009694 else
9695 {
Bram Moolenaar7633fe52020-06-22 19:10:56 +02009696 srand_seed_for_testing = (UINT32_T)tv_get_number(&argvars[0]);
9697 srand_seed_for_testing_is_used = TRUE;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009698 }
9699}
9700
9701 static void
9702init_srand(UINT32_T *x)
9703{
LemonBoy9987fe82024-07-04 13:20:49 +02009704 struct {
9705 union {
9706 UINT32_T number;
9707 char_u bytes[sizeof(UINT32_T)];
9708 } contents;
9709 } buf;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009710
9711 if (srand_seed_for_testing_is_used)
9712 {
Bram Moolenaar7633fe52020-06-22 19:10:56 +02009713 *x = srand_seed_for_testing;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009714 return;
9715 }
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009716
LemonBoy9987fe82024-07-04 13:20:49 +02009717 if (mch_get_random(buf.contents.bytes, sizeof(buf.contents.bytes)) == OK)
9718 {
9719 *x = buf.contents.number;
9720 return;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009721 }
LemonBoy9987fe82024-07-04 13:20:49 +02009722
9723 // The system's random number generator doesn't work, fall back to:
9724 // - randombytes_random()
9725 // - reltime() or time()
9726 // - XOR with process ID
9727#if defined(FEAT_SODIUM)
9728 if (crypt_sodium_init() >= 0)
9729 *x = crypt_sodium_randombytes_random();
9730 else
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009731#endif
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009732 {
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009733#if defined(FEAT_RELTIME)
LemonBoy9987fe82024-07-04 13:20:49 +02009734 proftime_T res;
9735 profile_start(&res);
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009736# if defined(MSWIN)
LemonBoy9987fe82024-07-04 13:20:49 +02009737 *x = (UINT32_T)res.LowPart;
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009738# else
LemonBoy9987fe82024-07-04 13:20:49 +02009739 *x = (UINT32_T)res.tv_fsec;
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009740# endif
9741#else
LemonBoy9987fe82024-07-04 13:20:49 +02009742 *x = vim_time();
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009743#endif
LemonBoy9987fe82024-07-04 13:20:49 +02009744 *x ^= mch_get_pid();
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009745 }
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009746}
9747
kylo252ae6f1d82022-02-16 19:24:07 +00009748#define ROTL(x, k) (((x) << (k)) | ((x) >> (32 - (k))))
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009749#define SPLITMIX32(x, z) ( \
kylo252ae6f1d82022-02-16 19:24:07 +00009750 (z) = ((x) += 0x9e3779b9), \
9751 (z) = ((z) ^ ((z) >> 16)) * 0x85ebca6b, \
9752 (z) = ((z) ^ ((z) >> 13)) * 0xc2b2ae35, \
9753 (z) ^ ((z) >> 16) \
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009754 )
9755#define SHUFFLE_XOSHIRO128STARSTAR(x, y, z, w) \
kylo252ae6f1d82022-02-16 19:24:07 +00009756 result = ROTL((y) * 5, 7) * 9; \
9757 t = (y) << 9; \
9758 (z) ^= (x); \
9759 (w) ^= (y); \
9760 (y) ^= (z), (x) ^= (w); \
9761 (z) ^= t; \
9762 (w) = ROTL(w, 11);
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009763
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009764/*
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009765 * "rand()" function
9766 */
9767 static void
9768f_rand(typval_T *argvars, typval_T *rettv)
9769{
9770 list_T *l = NULL;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009771 static UINT32_T gx, gy, gz, gw;
9772 static int initialized = FALSE;
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009773 listitem_T *lx, *ly, *lz, *lw;
Bram Moolenaar0fd797e2020-11-05 20:46:32 +01009774 UINT32_T x = 0, y, z, w, t, result;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009775
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009776 if (in_vim9script() && check_for_opt_list_arg(argvars, 0) == FAIL)
9777 return;
9778
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009779 if (argvars[0].v_type == VAR_UNKNOWN)
9780 {
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009781 // When no argument is given use the global seed list.
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009782 if (initialized == FALSE)
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009783 {
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009784 // Initialize the global seed list.
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009785 init_srand(&x);
9786
9787 gx = SPLITMIX32(x, z);
9788 gy = SPLITMIX32(x, z);
9789 gz = SPLITMIX32(x, z);
9790 gw = SPLITMIX32(x, z);
9791 initialized = TRUE;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009792 }
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009793
9794 SHUFFLE_XOSHIRO128STARSTAR(gx, gy, gz, gw);
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009795 }
9796 else if (argvars[0].v_type == VAR_LIST)
9797 {
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009798 l = argvars[0].vval.v_list;
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009799 if (l == NULL || list_len(l) != 4)
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009800 goto theend;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009801
9802 lx = list_find(l, 0L);
9803 ly = list_find(l, 1L);
9804 lz = list_find(l, 2L);
9805 lw = list_find(l, 3L);
9806 if (lx->li_tv.v_type != VAR_NUMBER) goto theend;
9807 if (ly->li_tv.v_type != VAR_NUMBER) goto theend;
9808 if (lz->li_tv.v_type != VAR_NUMBER) goto theend;
9809 if (lw->li_tv.v_type != VAR_NUMBER) goto theend;
9810 x = (UINT32_T)lx->li_tv.vval.v_number;
9811 y = (UINT32_T)ly->li_tv.vval.v_number;
9812 z = (UINT32_T)lz->li_tv.vval.v_number;
9813 w = (UINT32_T)lw->li_tv.vval.v_number;
9814
9815 SHUFFLE_XOSHIRO128STARSTAR(x, y, z, w);
9816
9817 lx->li_tv.vval.v_number = (varnumber_T)x;
9818 ly->li_tv.vval.v_number = (varnumber_T)y;
9819 lz->li_tv.vval.v_number = (varnumber_T)z;
9820 lw->li_tv.vval.v_number = (varnumber_T)w;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009821 }
9822 else
9823 goto theend;
9824
9825 rettv->v_type = VAR_NUMBER;
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009826 rettv->vval.v_number = (varnumber_T)result;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009827 return;
9828
9829theend:
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00009830 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[0]));
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009831 rettv->v_type = VAR_NUMBER;
9832 rettv->vval.v_number = -1;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009833}
9834
9835/*
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009836 * "srand()" function
9837 */
9838 static void
9839f_srand(typval_T *argvars, typval_T *rettv)
9840{
9841 UINT32_T x = 0, z;
9842
9843 if (rettv_list_alloc(rettv) == FAIL)
9844 return;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009845
9846 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
9847 return;
9848
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009849 if (argvars[0].v_type == VAR_UNKNOWN)
9850 {
9851 init_srand(&x);
9852 }
9853 else
9854 {
9855 int error = FALSE;
9856
9857 x = (UINT32_T)tv_get_number_chk(&argvars[0], &error);
9858 if (error)
9859 return;
9860 }
9861
9862 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
9863 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
9864 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
9865 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
9866}
9867
9868#undef ROTL
9869#undef SPLITMIX32
9870#undef SHUFFLE_XOSHIRO128STARSTAR
9871
9872/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009873 * "range()" function
9874 */
9875 static void
9876f_range(typval_T *argvars, typval_T *rettv)
9877{
9878 varnumber_T start;
9879 varnumber_T end;
9880 varnumber_T stride = 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009881 int error = FALSE;
9882
Bram Moolenaar93a10962022-06-16 11:42:09 +01009883 if (rettv_list_alloc(rettv) == FAIL)
Yegappan Lakshmananca195cc2022-06-14 13:42:26 +01009884 return;
9885
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009886 if (in_vim9script()
9887 && (check_for_number_arg(argvars, 0) == FAIL
9888 || check_for_opt_number_arg(argvars, 1) == FAIL
9889 || (argvars[1].v_type != VAR_UNKNOWN
9890 && check_for_opt_number_arg(argvars, 2) == FAIL)))
9891 return;
9892
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009893 start = tv_get_number_chk(&argvars[0], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009894 if (argvars[1].v_type == VAR_UNKNOWN)
9895 {
9896 end = start - 1;
9897 start = 0;
9898 }
9899 else
9900 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009901 end = tv_get_number_chk(&argvars[1], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009902 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009903 stride = tv_get_number_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009904 }
9905
9906 if (error)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009907 return; // type error; errmsg already given
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009908 if (stride == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009909 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00009910 emsg(_(e_stride_is_zero));
9911 return;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01009912 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00009913 if (stride > 0 ? end + 1 < start : end - 1 > start)
9914 {
9915 emsg(_(e_start_past_end));
9916 return;
9917 }
9918
9919 list_T *list = rettv->vval.v_list;
9920
9921 // Create a non-materialized list. This is much more efficient and
9922 // works with ":for". If used otherwise CHECK_LIST_MATERIALIZE() must
9923 // be called.
9924 list->lv_first = &range_list_item;
9925 list->lv_u.nonmat.lv_start = start;
9926 list->lv_u.nonmat.lv_end = end;
9927 list->lv_u.nonmat.lv_stride = stride;
Christian Brabandtdf63da92023-11-23 20:14:28 +01009928 if (stride > 0 ? end < start : end > start)
9929 list->lv_len = 0;
9930 else
9931 list->lv_len = (end - start) / stride + 1;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01009932}
9933
9934/*
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02009935 * Materialize "list".
9936 * Do not call directly, use CHECK_LIST_MATERIALIZE()
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01009937 */
9938 void
9939range_list_materialize(list_T *list)
9940{
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02009941 varnumber_T start = list->lv_u.nonmat.lv_start;
9942 varnumber_T end = list->lv_u.nonmat.lv_end;
Bram Moolenaar70c43d82022-01-26 21:01:15 +00009943 int stride = list->lv_u.nonmat.lv_stride;
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02009944 varnumber_T i;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01009945
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02009946 list->lv_first = NULL;
9947 list->lv_u.mat.lv_last = NULL;
9948 list->lv_len = 0;
9949 list->lv_u.mat.lv_idx_item = NULL;
9950 for (i = start; stride > 0 ? i <= end : i >= end; i += stride)
Bram Moolenaar70c43d82022-01-26 21:01:15 +00009951 {
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +00009952 if (list_append_number(list, i) == FAIL)
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02009953 break;
Bram Moolenaar70c43d82022-01-26 21:01:15 +00009954 if (list->lv_lock & VAR_ITEMS_LOCKED)
9955 list->lv_u.mat.lv_last->li_tv.v_lock = VAR_LOCKED;
9956 }
9957 list->lv_lock &= ~VAR_ITEMS_LOCKED;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009958}
9959
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009960/*
9961 * "getreginfo()" function
9962 */
9963 static void
9964f_getreginfo(typval_T *argvars, typval_T *rettv)
9965{
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009966 int regname;
9967 char_u buf[NUMBUFLEN + 2];
9968 long reglen = 0;
9969 dict_T *dict;
9970 list_T *list;
9971
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009972 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
9973 return;
9974
zeertzjqd3f00f52021-12-24 12:02:43 +00009975 regname = getreg_get_regname(argvars);
9976 if (regname == 0)
9977 return;
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009978
zeertzjqd3f00f52021-12-24 12:02:43 +00009979 if (regname == '@')
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009980 regname = '"';
9981
9982 if (rettv_dict_alloc(rettv) == FAIL)
9983 return;
9984 dict = rettv->vval.v_dict;
9985
9986 list = (list_T *)get_reg_contents(regname, GREG_EXPR_SRC | GREG_LIST);
9987 if (list == NULL)
9988 return;
Bram Moolenaar91639192020-06-29 19:55:58 +02009989 (void)dict_add_list(dict, "regcontents", list);
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009990
9991 buf[0] = NUL;
9992 buf[1] = NUL;
9993 switch (get_reg_type(regname, &reglen))
9994 {
9995 case MLINE: buf[0] = 'V'; break;
9996 case MCHAR: buf[0] = 'v'; break;
9997 case MBLOCK:
9998 vim_snprintf((char *)buf, sizeof(buf), "%c%ld", Ctrl_V,
9999 reglen + 1);
10000 break;
10001 }
Bram Moolenaar91639192020-06-29 19:55:58 +020010002 (void)dict_add_string(dict, (char *)"regtype", buf);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010003
10004 buf[0] = get_register_name(get_unname_register());
10005 buf[1] = NUL;
10006 if (regname == '"')
Bram Moolenaar91639192020-06-29 19:55:58 +020010007 (void)dict_add_string(dict, (char *)"points_to", buf);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010008 else
10009 {
10010 dictitem_T *item = dictitem_alloc((char_u *)"isunnamed");
10011
10012 if (item != NULL)
10013 {
Bram Moolenaar82946e12022-11-24 11:31:29 +000010014 item->di_tv.v_type = VAR_BOOL;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010015 item->di_tv.vval.v_number = regname == buf[0]
Bram Moolenaar418a29f2021-02-10 22:23:41 +010010016 ? VVAL_TRUE : VVAL_FALSE;
Bram Moolenaar91639192020-06-29 19:55:58 +020010017 (void)dict_add(dict, item);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020010018 }
10019 }
10020}
10021
Bram Moolenaar0b6d9112018-05-22 20:35:17 +020010022 static void
10023return_register(int regname, typval_T *rettv)
10024{
10025 char_u buf[2] = {0, 0};
10026
10027 buf[0] = (char_u)regname;
10028 rettv->v_type = VAR_STRING;
10029 rettv->vval.v_string = vim_strsave(buf);
10030}
10031
10032/*
10033 * "reg_executing()" function
10034 */
10035 static void
10036f_reg_executing(typval_T *argvars UNUSED, typval_T *rettv)
10037{
10038 return_register(reg_executing, rettv);
10039}
10040
10041/*
10042 * "reg_recording()" function
10043 */
10044 static void
10045f_reg_recording(typval_T *argvars UNUSED, typval_T *rettv)
10046{
10047 return_register(reg_recording, rettv);
10048}
10049
Bram Moolenaar7416f3e2017-03-18 18:10:13 +010010050/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010051 * "rename({from}, {to})" function
10052 */
10053 static void
10054f_rename(typval_T *argvars, typval_T *rettv)
10055{
10056 char_u buf[NUMBUFLEN];
10057
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010058 rettv->vval.v_number = -1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010059 if (check_restricted() || check_secure())
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010060 return;
10061
10062 if (in_vim9script()
10063 && (check_for_string_arg(argvars, 0) == FAIL
10064 || check_for_string_arg(argvars, 1) == FAIL))
10065 return;
10066
10067 rettv->vval.v_number = vim_rename(tv_get_string(&argvars[0]),
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010068 tv_get_string_buf(&argvars[1], buf));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010069}
10070
10071/*
10072 * "repeat()" function
10073 */
10074 static void
10075f_repeat(typval_T *argvars, typval_T *rettv)
10076{
10077 char_u *p;
Bakudankun375141e2022-09-09 18:46:47 +010010078 varnumber_T n;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010079 int slen;
10080 int len;
10081 char_u *r;
10082 int i;
10083
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +020010084 if (in_vim9script()
Bakudankun375141e2022-09-09 18:46:47 +010010085 && (check_for_string_or_number_or_list_or_blob_arg(argvars, 0)
10086 == FAIL
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010087 || check_for_number_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +020010088 return;
10089
Bakudankun375141e2022-09-09 18:46:47 +010010090 n = tv_get_number(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010091 if (argvars[0].v_type == VAR_LIST)
10092 {
10093 if (rettv_list_alloc(rettv) == OK && argvars[0].vval.v_list != NULL)
10094 while (n-- > 0)
10095 if (list_extend(rettv->vval.v_list,
10096 argvars[0].vval.v_list, NULL) == FAIL)
10097 break;
10098 }
Bakudankun375141e2022-09-09 18:46:47 +010010099 else if (argvars[0].v_type == VAR_BLOB)
10100 {
10101 if (rettv_blob_alloc(rettv) == FAIL
10102 || argvars[0].vval.v_blob == NULL
10103 || n <= 0)
10104 return;
10105
10106 slen = argvars[0].vval.v_blob->bv_ga.ga_len;
10107 len = (int)slen * n;
10108 if (len <= 0)
10109 return;
10110
10111 if (ga_grow(&rettv->vval.v_blob->bv_ga, len) == FAIL)
10112 return;
10113
10114 rettv->vval.v_blob->bv_ga.ga_len = len;
10115
10116 for (i = 0; i < slen; ++i)
10117 if (blob_get(argvars[0].vval.v_blob, i) != 0)
10118 break;
10119
10120 if (i == slen)
10121 // No need to copy since all bytes are already zero
10122 return;
10123
10124 for (i = 0; i < n; ++i)
10125 blob_set_range(rettv->vval.v_blob,
10126 (long)i * slen, ((long)i + 1) * slen - 1, argvars);
10127 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010128 else
10129 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010130 p = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010131 rettv->v_type = VAR_STRING;
10132 rettv->vval.v_string = NULL;
10133
10134 slen = (int)STRLEN(p);
10135 len = slen * n;
10136 if (len <= 0)
10137 return;
10138
10139 r = alloc(len + 1);
10140 if (r != NULL)
10141 {
10142 for (i = 0; i < n; i++)
10143 mch_memmove(r + i * slen, p, (size_t)slen);
10144 r[len] = NUL;
10145 }
10146
10147 rettv->vval.v_string = r;
10148 }
10149}
10150
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010151#define SP_NOMOVE 0x01 // don't move cursor
10152#define SP_REPEAT 0x02 // repeat to find outer pair
10153#define SP_RETCOUNT 0x04 // return matchcount
10154#define SP_SETPCMARK 0x08 // set previous context mark
10155#define SP_START 0x10 // accept match at start position
10156#define SP_SUBPAT 0x20 // return nr of matching sub-pattern
10157#define SP_END 0x40 // leave cursor at end of match
10158#define SP_COLUMN 0x80 // start at cursor column
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010159
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010160/*
10161 * Get flags for a search function.
10162 * Possibly sets "p_ws".
10163 * Returns BACKWARD, FORWARD or zero (for an error).
10164 */
10165 static int
10166get_search_arg(typval_T *varp, int *flagsp)
10167{
10168 int dir = FORWARD;
10169 char_u *flags;
10170 char_u nbuf[NUMBUFLEN];
10171 int mask;
10172
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010173 if (varp->v_type == VAR_UNKNOWN)
10174 return FORWARD;
10175
10176 flags = tv_get_string_buf_chk(varp, nbuf);
10177 if (flags == NULL)
10178 return 0; // type error; errmsg already given
10179 while (*flags != NUL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010180 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010181 switch (*flags)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010182 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010183 case 'b': dir = BACKWARD; break;
10184 case 'w': p_ws = TRUE; break;
10185 case 'W': p_ws = FALSE; break;
10186 default: mask = 0;
10187 if (flagsp != NULL)
10188 switch (*flags)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010189 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010190 case 'c': mask = SP_START; break;
10191 case 'e': mask = SP_END; break;
10192 case 'm': mask = SP_RETCOUNT; break;
10193 case 'n': mask = SP_NOMOVE; break;
10194 case 'p': mask = SP_SUBPAT; break;
10195 case 'r': mask = SP_REPEAT; break;
10196 case 's': mask = SP_SETPCMARK; break;
10197 case 'z': mask = SP_COLUMN; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010198 }
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010199 if (mask == 0)
10200 {
10201 semsg(_(e_invalid_argument_str), flags);
10202 dir = 0;
10203 }
10204 else
10205 *flagsp |= mask;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010206 }
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010207 if (dir == 0)
10208 break;
10209 ++flags;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010210 }
10211 return dir;
10212}
10213
10214/*
10215 * Shared by search() and searchpos() functions.
10216 */
10217 static int
10218search_cmn(typval_T *argvars, pos_T *match_pos, int *flagsp)
10219{
10220 int flags;
10221 char_u *pat;
John Marriott8c85a2a2024-05-20 19:18:26 +020010222 size_t patlen;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010223 pos_T pos;
10224 pos_T save_cursor;
10225 int save_p_ws = p_ws;
10226 int dir;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010227 int retval = 0; // default: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010228 long lnum_stop = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010229#ifdef FEAT_RELTIME
10230 long time_limit = 0;
10231#endif
10232 int options = SEARCH_KEEP;
10233 int subpatnum;
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010234 searchit_arg_T sia;
Bram Moolenaara9c01042020-06-07 14:50:50 +020010235 int use_skip = FALSE;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010236 pos_T firstpos;
10237
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +020010238 if (in_vim9script()
10239 && (check_for_string_arg(argvars, 0) == FAIL
10240 || check_for_opt_string_arg(argvars, 1) == FAIL
10241 || (argvars[1].v_type != VAR_UNKNOWN
10242 && (check_for_opt_number_arg(argvars, 2) == FAIL
10243 || (argvars[2].v_type != VAR_UNKNOWN
10244 && check_for_opt_number_arg(argvars, 3) == FAIL)))))
10245 goto theend;
10246
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010247 pat = tv_get_string(&argvars[0]);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010248 dir = get_search_arg(&argvars[1], flagsp); // may set p_ws
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010249 if (dir == 0)
10250 goto theend;
10251 flags = *flagsp;
10252 if (flags & SP_START)
10253 options |= SEARCH_START;
10254 if (flags & SP_END)
10255 options |= SEARCH_END;
10256 if (flags & SP_COLUMN)
10257 options |= SEARCH_COL;
10258
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010259 // Optional arguments: line number to stop searching, timeout and skip.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010260 if (argvars[1].v_type != VAR_UNKNOWN && argvars[2].v_type != VAR_UNKNOWN)
10261 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010262 lnum_stop = (long)tv_get_number_chk(&argvars[2], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010263 if (lnum_stop < 0)
10264 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010265 if (argvars[3].v_type != VAR_UNKNOWN)
10266 {
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010267#ifdef FEAT_RELTIME
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010268 time_limit = (long)tv_get_number_chk(&argvars[3], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010269 if (time_limit < 0)
10270 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010271#endif
Bram Moolenaara9c01042020-06-07 14:50:50 +020010272 use_skip = eval_expr_valid_arg(&argvars[4]);
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010273 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010274 }
10275
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010276 /*
10277 * This function does not accept SP_REPEAT and SP_RETCOUNT flags.
10278 * Check to make sure only those flags are set.
10279 * Also, Only the SP_NOMOVE or the SP_SETPCMARK flag can be set. Both
10280 * flags cannot be set. Check for that condition also.
10281 */
10282 if (((flags & (SP_REPEAT | SP_RETCOUNT)) != 0)
10283 || ((flags & SP_NOMOVE) && (flags & SP_SETPCMARK)))
10284 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010285 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[1]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010286 goto theend;
10287 }
10288
10289 pos = save_cursor = curwin->w_cursor;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010290 CLEAR_FIELD(firstpos);
Bram Moolenaara80faa82020-04-12 19:37:17 +020010291 CLEAR_FIELD(sia);
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010292 sia.sa_stop_lnum = (linenr_T)lnum_stop;
10293#ifdef FEAT_RELTIME
Paul Ollis65745772022-06-05 16:55:54 +010010294 sia.sa_tm = time_limit;
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010295#endif
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010296
John Marriott8c85a2a2024-05-20 19:18:26 +020010297 patlen = STRLEN(pat);
10298
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010299 // Repeat until {skip} returns FALSE.
10300 for (;;)
10301 {
John Marriott8c85a2a2024-05-20 19:18:26 +020010302 subpatnum = searchit(curwin, curbuf, &pos, NULL, dir, pat, patlen, 1L,
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010303 options, RE_SEARCH, &sia);
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010304 // finding the first match again means there is no match where {skip}
10305 // evaluates to zero.
10306 if (firstpos.lnum != 0 && EQUAL_POS(pos, firstpos))
10307 subpatnum = FAIL;
10308
Bram Moolenaara9c01042020-06-07 14:50:50 +020010309 if (subpatnum == FAIL || !use_skip)
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010310 // didn't find it or no skip argument
10311 break;
Bram Moolenaar3d79f0a2023-01-22 20:14:26 +000010312 if (firstpos.lnum == 0)
10313 firstpos = pos;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010314
Bram Moolenaara9c01042020-06-07 14:50:50 +020010315 // If the skip expression matches, ignore this match.
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010316 {
10317 int do_skip;
10318 int err;
10319 pos_T save_pos = curwin->w_cursor;
10320
10321 curwin->w_cursor = pos;
Bram Moolenaara9c01042020-06-07 14:50:50 +020010322 err = FALSE;
10323 do_skip = eval_expr_to_bool(&argvars[4], &err);
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010324 curwin->w_cursor = save_pos;
10325 if (err)
10326 {
10327 // Evaluating {skip} caused an error, break here.
10328 subpatnum = FAIL;
10329 break;
10330 }
10331 if (!do_skip)
10332 break;
10333 }
zeertzjq180246c2022-06-23 12:04:46 +010010334
10335 // clear the start flag to avoid getting stuck here
10336 options &= ~SEARCH_START;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010337 }
10338
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010339 if (subpatnum != FAIL)
10340 {
10341 if (flags & SP_SUBPAT)
10342 retval = subpatnum;
10343 else
10344 retval = pos.lnum;
10345 if (flags & SP_SETPCMARK)
10346 setpcmark();
10347 curwin->w_cursor = pos;
10348 if (match_pos != NULL)
10349 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010350 // Store the match cursor position
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010351 match_pos->lnum = pos.lnum;
10352 match_pos->col = pos.col + 1;
10353 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010354 // "/$" will put the cursor after the end of the line, may need to
10355 // correct that here
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010356 check_cursor();
10357 }
10358
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010359 // If 'n' flag is used: restore cursor position.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010360 if (flags & SP_NOMOVE)
10361 curwin->w_cursor = save_cursor;
10362 else
10363 curwin->w_set_curswant = TRUE;
10364theend:
10365 p_ws = save_p_ws;
10366
10367 return retval;
10368}
10369
Bram Moolenaare99be0e2019-03-26 22:51:09 +010010370#ifdef FEAT_RUBY
10371/*
10372 * "rubyeval()" function
10373 */
10374 static void
10375f_rubyeval(typval_T *argvars, typval_T *rettv)
10376{
10377 char_u *str;
10378 char_u buf[NUMBUFLEN];
10379
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010380 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
10381 return;
10382
Bram Moolenaare99be0e2019-03-26 22:51:09 +010010383 str = tv_get_string_buf(&argvars[0], buf);
10384 do_rubyeval(str, rettv);
10385}
10386#endif
10387
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010388/*
10389 * "screenattr()" function
10390 */
10391 static void
10392f_screenattr(typval_T *argvars, typval_T *rettv)
10393{
10394 int row;
10395 int col;
10396 int c;
10397
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010398 if (in_vim9script()
10399 && (check_for_number_arg(argvars, 0) == FAIL
10400 || check_for_number_arg(argvars, 1) == FAIL))
10401 return;
10402
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010403 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10404 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010405 if (row < 0 || row >= screen_Rows
10406 || col < 0 || col >= screen_Columns)
10407 c = -1;
10408 else
10409 c = ScreenAttrs[LineOffset[row] + col];
10410 rettv->vval.v_number = c;
10411}
10412
10413/*
10414 * "screenchar()" function
10415 */
10416 static void
10417f_screenchar(typval_T *argvars, typval_T *rettv)
10418{
10419 int row;
10420 int col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010421 int c;
10422
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010423 if (in_vim9script()
10424 && (check_for_number_arg(argvars, 0) == FAIL
10425 || check_for_number_arg(argvars, 1) == FAIL))
10426 return;
10427
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010428 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10429 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010430 if (row < 0 || row >= screen_Rows || col < 0 || col >= screen_Columns)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010431 c = -1;
10432 else
10433 {
zeertzjq47eec672023-06-01 20:26:55 +010010434 char_u buf[MB_MAXBYTES + 1];
10435 screen_getbytes(row, col, buf, NULL);
10436 c = (*mb_ptr2char)(buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010437 }
10438 rettv->vval.v_number = c;
10439}
10440
10441/*
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010442 * "screenchars()" function
10443 */
10444 static void
10445f_screenchars(typval_T *argvars, typval_T *rettv)
10446{
10447 int row;
10448 int col;
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010449 int c;
10450 int i;
10451
10452 if (rettv_list_alloc(rettv) == FAIL)
10453 return;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010454
10455 if (in_vim9script()
10456 && (check_for_number_arg(argvars, 0) == FAIL
10457 || check_for_number_arg(argvars, 1) == FAIL))
10458 return;
10459
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010460 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10461 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
10462 if (row < 0 || row >= screen_Rows || col < 0 || col >= screen_Columns)
10463 return;
10464
zeertzjq47eec672023-06-01 20:26:55 +010010465 char_u buf[MB_MAXBYTES + 1];
10466 screen_getbytes(row, col, buf, NULL);
10467 int pcc[MAX_MCO];
10468 if (enc_utf8)
10469 c = utfc_ptr2char(buf, pcc);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010470 else
zeertzjq47eec672023-06-01 20:26:55 +010010471 c = (*mb_ptr2char)(buf);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010472 list_append_number(rettv->vval.v_list, (varnumber_T)c);
10473
10474 if (enc_utf8)
zeertzjq47eec672023-06-01 20:26:55 +010010475 for (i = 0; i < Screen_mco && pcc[i] != 0; ++i)
10476 list_append_number(rettv->vval.v_list, (varnumber_T)pcc[i]);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010477}
10478
10479/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010480 * "screencol()" function
10481 *
10482 * First column is 1 to be consistent with virtcol().
10483 */
10484 static void
10485f_screencol(typval_T *argvars UNUSED, typval_T *rettv)
10486{
10487 rettv->vval.v_number = screen_screencol() + 1;
10488}
10489
10490/*
10491 * "screenrow()" function
10492 */
10493 static void
10494f_screenrow(typval_T *argvars UNUSED, typval_T *rettv)
10495{
10496 rettv->vval.v_number = screen_screenrow() + 1;
10497}
10498
10499/*
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010500 * "screenstring()" function
10501 */
10502 static void
10503f_screenstring(typval_T *argvars, typval_T *rettv)
10504{
10505 int row;
10506 int col;
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010507 char_u buf[MB_MAXBYTES + 1];
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010508
10509 rettv->vval.v_string = NULL;
10510 rettv->v_type = VAR_STRING;
10511
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010512 if (in_vim9script()
10513 && (check_for_number_arg(argvars, 0) == FAIL
10514 || check_for_number_arg(argvars, 1) == FAIL))
10515 return;
10516
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010517 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10518 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
10519 if (row < 0 || row >= screen_Rows || col < 0 || col >= screen_Columns)
10520 return;
10521
zeertzjq47eec672023-06-01 20:26:55 +010010522 screen_getbytes(row, col, buf, NULL);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010523 rettv->vval.v_string = vim_strsave(buf);
10524}
10525
10526/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010527 * "search()" function
10528 */
10529 static void
10530f_search(typval_T *argvars, typval_T *rettv)
10531{
10532 int flags = 0;
10533
10534 rettv->vval.v_number = search_cmn(argvars, NULL, &flags);
10535}
10536
10537/*
10538 * "searchdecl()" function
10539 */
10540 static void
10541f_searchdecl(typval_T *argvars, typval_T *rettv)
10542{
Bram Moolenaar30788d32020-09-05 21:35:16 +020010543 int locally = TRUE;
10544 int thisblock = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010545 int error = FALSE;
10546 char_u *name;
10547
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010548 rettv->vval.v_number = 1; // default: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010549
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020010550 if (in_vim9script()
10551 && (check_for_string_arg(argvars, 0) == FAIL
10552 || check_for_opt_bool_arg(argvars, 1) == FAIL
10553 || (argvars[1].v_type != VAR_UNKNOWN
10554 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
10555 return;
10556
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010557 name = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010558 if (argvars[1].v_type != VAR_UNKNOWN)
10559 {
Bram Moolenaar30788d32020-09-05 21:35:16 +020010560 locally = !(int)tv_get_bool_chk(&argvars[1], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010561 if (!error && argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar30788d32020-09-05 21:35:16 +020010562 thisblock = (int)tv_get_bool_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010563 }
10564 if (!error && name != NULL)
10565 rettv->vval.v_number = find_decl(name, (int)STRLEN(name),
10566 locally, thisblock, SEARCH_KEEP) == FAIL;
10567}
10568
10569/*
10570 * Used by searchpair() and searchpairpos()
10571 */
10572 static int
10573searchpair_cmn(typval_T *argvars, pos_T *match_pos)
10574{
10575 char_u *spat, *mpat, *epat;
Bram Moolenaar48570482017-10-30 21:48:41 +010010576 typval_T *skip;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010577 int save_p_ws = p_ws;
10578 int dir;
10579 int flags = 0;
10580 char_u nbuf1[NUMBUFLEN];
10581 char_u nbuf2[NUMBUFLEN];
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010582 int retval = 0; // default: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010583 long lnum_stop = 0;
10584 long time_limit = 0;
10585
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +020010586 if (in_vim9script()
10587 && (check_for_string_arg(argvars, 0) == FAIL
10588 || check_for_string_arg(argvars, 1) == FAIL
10589 || check_for_string_arg(argvars, 2) == FAIL
10590 || check_for_opt_string_arg(argvars, 3) == FAIL
10591 || (argvars[3].v_type != VAR_UNKNOWN
10592 && argvars[4].v_type != VAR_UNKNOWN
10593 && (check_for_opt_number_arg(argvars, 5) == FAIL
10594 || (argvars[5].v_type != VAR_UNKNOWN
10595 && check_for_opt_number_arg(argvars, 6) == FAIL)))))
10596 goto theend;
10597
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010598 // Get the three pattern arguments: start, middle, end. Will result in an
10599 // error if not a valid argument.
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010600 spat = tv_get_string_chk(&argvars[0]);
10601 mpat = tv_get_string_buf_chk(&argvars[1], nbuf1);
10602 epat = tv_get_string_buf_chk(&argvars[2], nbuf2);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010603 if (spat == NULL || mpat == NULL || epat == NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010604 goto theend; // type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010605
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010606 // Handle the optional fourth argument: flags
10607 dir = get_search_arg(&argvars[3], &flags); // may set p_ws
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010608 if (dir == 0)
10609 goto theend;
10610
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010611 // Don't accept SP_END or SP_SUBPAT.
10612 // Only one of the SP_NOMOVE or SP_SETPCMARK flags can be set.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010613 if ((flags & (SP_END | SP_SUBPAT)) != 0
10614 || ((flags & SP_NOMOVE) && (flags & SP_SETPCMARK)))
10615 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010616 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[3]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010617 goto theend;
10618 }
10619
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010620 // Using 'r' implies 'W', otherwise it doesn't work.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010621 if (flags & SP_REPEAT)
10622 p_ws = FALSE;
10623
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010624 // Optional fifth argument: skip expression
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010625 if (argvars[3].v_type == VAR_UNKNOWN
10626 || argvars[4].v_type == VAR_UNKNOWN)
Bram Moolenaar48570482017-10-30 21:48:41 +010010627 skip = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010628 else
10629 {
Bram Moolenaara9c01042020-06-07 14:50:50 +020010630 // Type is checked later.
Bram Moolenaar48570482017-10-30 21:48:41 +010010631 skip = &argvars[4];
Bram Moolenaara9c01042020-06-07 14:50:50 +020010632
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010633 if (argvars[5].v_type != VAR_UNKNOWN)
10634 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010635 lnum_stop = (long)tv_get_number_chk(&argvars[5], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010636 if (lnum_stop < 0)
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010637 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010638 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[5]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010639 goto theend;
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010640 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010641#ifdef FEAT_RELTIME
10642 if (argvars[6].v_type != VAR_UNKNOWN)
10643 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010644 time_limit = (long)tv_get_number_chk(&argvars[6], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010645 if (time_limit < 0)
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010646 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010647 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[6]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010648 goto theend;
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010649 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010650 }
10651#endif
10652 }
10653 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010654
10655 retval = do_searchpair(spat, mpat, epat, dir, skip, flags,
10656 match_pos, lnum_stop, time_limit);
10657
10658theend:
10659 p_ws = save_p_ws;
10660
10661 return retval;
10662}
10663
10664/*
10665 * "searchpair()" function
10666 */
10667 static void
10668f_searchpair(typval_T *argvars, typval_T *rettv)
10669{
10670 rettv->vval.v_number = searchpair_cmn(argvars, NULL);
10671}
10672
10673/*
10674 * "searchpairpos()" function
10675 */
10676 static void
10677f_searchpairpos(typval_T *argvars, typval_T *rettv)
10678{
10679 pos_T match_pos;
10680 int lnum = 0;
10681 int col = 0;
10682
10683 if (rettv_list_alloc(rettv) == FAIL)
10684 return;
10685
10686 if (searchpair_cmn(argvars, &match_pos) > 0)
10687 {
10688 lnum = match_pos.lnum;
10689 col = match_pos.col;
10690 }
10691
10692 list_append_number(rettv->vval.v_list, (varnumber_T)lnum);
10693 list_append_number(rettv->vval.v_list, (varnumber_T)col);
10694}
10695
10696/*
10697 * Search for a start/middle/end thing.
10698 * Used by searchpair(), see its documentation for the details.
10699 * Returns 0 or -1 for no match,
10700 */
10701 long
10702do_searchpair(
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010703 char_u *spat, // start pattern
10704 char_u *mpat, // middle pattern
10705 char_u *epat, // end pattern
10706 int dir, // BACKWARD or FORWARD
10707 typval_T *skip, // skip expression
10708 int flags, // SP_SETPCMARK and other SP_ values
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010709 pos_T *match_pos,
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010710 linenr_T lnum_stop, // stop at this line if not zero
10711 long time_limit UNUSED) // stop after this many msec
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010712{
10713 char_u *save_cpo;
10714 char_u *pat, *pat2 = NULL, *pat3 = NULL;
John Marriott8c85a2a2024-05-20 19:18:26 +020010715 size_t patlen;
10716 size_t spatlen;
10717 size_t epatlen;
10718 size_t pat2size;
10719 size_t pat2len;
10720 size_t pat3size;
10721 size_t pat3len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010722 long retval = 0;
10723 pos_T pos;
10724 pos_T firstpos;
10725 pos_T foundpos;
10726 pos_T save_cursor;
10727 pos_T save_pos;
10728 int n;
10729 int r;
10730 int nest = 1;
Bram Moolenaar48570482017-10-30 21:48:41 +010010731 int use_skip = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010732 int err;
10733 int options = SEARCH_KEEP;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010734
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010735 // Make 'cpoptions' empty, the 'l' flag should not be used here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010736 save_cpo = p_cpo;
10737 p_cpo = empty_option;
10738
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010739 // Make two search patterns: start/end (pat2, for in nested pairs) and
10740 // start/middle/end (pat3, for the top pair).
John Marriott8c85a2a2024-05-20 19:18:26 +020010741 spatlen = STRLEN(spat);
10742 epatlen = STRLEN(epat);
10743 pat2size = spatlen + epatlen + 17;
10744 pat2 = alloc(pat2size);
10745 if (pat2 == NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010746 goto theend;
John Marriott8c85a2a2024-05-20 19:18:26 +020010747 pat3size = spatlen + STRLEN(mpat) + epatlen + 25;
10748 pat3 = alloc(pat3size);
10749 if (pat3 == NULL)
10750 goto theend;
10751 pat2len = vim_snprintf((char *)pat2, pat2size, "\\m\\(%s\\m\\)\\|\\(%s\\m\\)", spat, epat);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010752 if (*mpat == NUL)
John Marriott8c85a2a2024-05-20 19:18:26 +020010753 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010754 STRCPY(pat3, pat2);
John Marriott8c85a2a2024-05-20 19:18:26 +020010755 pat3len = pat2len;
10756 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010757 else
John Marriott8c85a2a2024-05-20 19:18:26 +020010758 pat3len = vim_snprintf((char *)pat3, pat3size, "\\m\\(%s\\m\\)\\|\\(%s\\m\\)\\|\\(%s\\m\\)",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010759 spat, epat, mpat);
10760 if (flags & SP_START)
10761 options |= SEARCH_START;
10762
Bram Moolenaar48570482017-10-30 21:48:41 +010010763 if (skip != NULL)
Bram Moolenaara9c01042020-06-07 14:50:50 +020010764 use_skip = eval_expr_valid_arg(skip);
Bram Moolenaar48570482017-10-30 21:48:41 +010010765
Bram Moolenaar5ea38d12022-06-16 21:20:48 +010010766#ifdef FEAT_RELTIME
10767 if (time_limit > 0)
10768 init_regexp_timeout(time_limit);
10769#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010770 save_cursor = curwin->w_cursor;
10771 pos = curwin->w_cursor;
Bram Moolenaarb5aedf32017-03-12 18:23:53 +010010772 CLEAR_POS(&firstpos);
10773 CLEAR_POS(&foundpos);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010774 pat = pat3;
John Marriott8c85a2a2024-05-20 19:18:26 +020010775 patlen = pat3len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010776 for (;;)
10777 {
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010778 searchit_arg_T sia;
10779
Bram Moolenaara80faa82020-04-12 19:37:17 +020010780 CLEAR_FIELD(sia);
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010781 sia.sa_stop_lnum = lnum_stop;
John Marriott8c85a2a2024-05-20 19:18:26 +020010782 n = searchit(curwin, curbuf, &pos, NULL, dir, pat, patlen, 1L,
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010783 options, RE_SEARCH, &sia);
Bram Moolenaarb5aedf32017-03-12 18:23:53 +010010784 if (n == FAIL || (firstpos.lnum != 0 && EQUAL_POS(pos, firstpos)))
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010785 // didn't find it or found the first match again: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010786 break;
10787
10788 if (firstpos.lnum == 0)
10789 firstpos = pos;
Bram Moolenaarb5aedf32017-03-12 18:23:53 +010010790 if (EQUAL_POS(pos, foundpos))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010791 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010792 // Found the same position again. Can happen with a pattern that
10793 // has "\zs" at the end and searching backwards. Advance one
10794 // character and try again.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010795 if (dir == BACKWARD)
10796 decl(&pos);
10797 else
10798 incl(&pos);
10799 }
10800 foundpos = pos;
10801
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010802 // clear the start flag to avoid getting stuck here
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010803 options &= ~SEARCH_START;
10804
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010805 // If the skip pattern matches, ignore this match.
Bram Moolenaar48570482017-10-30 21:48:41 +010010806 if (use_skip)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010807 {
10808 save_pos = curwin->w_cursor;
10809 curwin->w_cursor = pos;
Bram Moolenaar48570482017-10-30 21:48:41 +010010810 err = FALSE;
10811 r = eval_expr_to_bool(skip, &err);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010812 curwin->w_cursor = save_pos;
10813 if (err)
10814 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010815 // Evaluating {skip} caused an error, break here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010816 curwin->w_cursor = save_cursor;
10817 retval = -1;
10818 break;
10819 }
10820 if (r)
10821 continue;
10822 }
10823
10824 if ((dir == BACKWARD && n == 3) || (dir == FORWARD && n == 2))
10825 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010826 // Found end when searching backwards or start when searching
10827 // forward: nested pair.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010828 ++nest;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010829 pat = pat2; // nested, don't search for middle
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010830 }
10831 else
10832 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010833 // Found end when searching forward or start when searching
10834 // backward: end of (nested) pair; or found middle in outer pair.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010835 if (--nest == 1)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010836 pat = pat3; // outer level, search for middle
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010837 }
10838
10839 if (nest == 0)
10840 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010841 // Found the match: return matchcount or line number.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010842 if (flags & SP_RETCOUNT)
10843 ++retval;
10844 else
10845 retval = pos.lnum;
10846 if (flags & SP_SETPCMARK)
10847 setpcmark();
10848 curwin->w_cursor = pos;
10849 if (!(flags & SP_REPEAT))
10850 break;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010851 nest = 1; // search for next unmatched
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010852 }
10853 }
10854
10855 if (match_pos != NULL)
10856 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010857 // Store the match cursor position
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010858 match_pos->lnum = curwin->w_cursor.lnum;
10859 match_pos->col = curwin->w_cursor.col + 1;
10860 }
10861
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010862 // If 'n' flag is used or search failed: restore cursor position.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010863 if ((flags & SP_NOMOVE) || retval == 0)
10864 curwin->w_cursor = save_cursor;
10865
10866theend:
Bram Moolenaar5ea38d12022-06-16 21:20:48 +010010867#ifdef FEAT_RELTIME
Bram Moolenaar0f618382022-08-26 21:33:04 +010010868 if (time_limit > 0)
10869 disable_regexp_timeout();
Bram Moolenaar5ea38d12022-06-16 21:20:48 +010010870#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010871 vim_free(pat2);
10872 vim_free(pat3);
10873 if (p_cpo == empty_option)
10874 p_cpo = save_cpo;
10875 else
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010010876 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010877 // Darn, evaluating the {skip} expression changed the value.
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010010878 // If it's still empty it was changed and restored, need to restore in
10879 // the complicated way.
10880 if (*p_cpo == NUL)
Bram Moolenaar31e5c602022-04-15 13:53:33 +010010881 set_option_value_give_err((char_u *)"cpo", 0L, save_cpo, 0);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010882 free_string_option(save_cpo);
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010010883 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010884
10885 return retval;
10886}
10887
10888/*
10889 * "searchpos()" function
10890 */
10891 static void
10892f_searchpos(typval_T *argvars, typval_T *rettv)
10893{
10894 pos_T match_pos;
10895 int lnum = 0;
10896 int col = 0;
10897 int n;
10898 int flags = 0;
10899
10900 if (rettv_list_alloc(rettv) == FAIL)
10901 return;
10902
10903 n = search_cmn(argvars, &match_pos, &flags);
10904 if (n > 0)
10905 {
10906 lnum = match_pos.lnum;
10907 col = match_pos.col;
10908 }
10909
10910 list_append_number(rettv->vval.v_list, (varnumber_T)lnum);
10911 list_append_number(rettv->vval.v_list, (varnumber_T)col);
10912 if (flags & SP_SUBPAT)
10913 list_append_number(rettv->vval.v_list, (varnumber_T)n);
10914}
10915
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010916/*
10917 * Set the cursor or mark position.
zeertzjq47eec672023-06-01 20:26:55 +010010918 * If "charpos" is TRUE, then use the column number as a character offset.
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010919 * Otherwise use the column number as a byte offset.
10920 */
10921 static void
10922set_position(typval_T *argvars, typval_T *rettv, int charpos)
10923{
10924 pos_T pos;
10925 int fnum;
10926 char_u *name;
10927 colnr_T curswant = -1;
10928
10929 rettv->vval.v_number = -1;
10930
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020010931 if (in_vim9script()
10932 && (check_for_string_arg(argvars, 0) == FAIL
10933 || check_for_list_arg(argvars, 1) == FAIL))
10934 return;
10935
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010936 name = tv_get_string_chk(argvars);
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010937 if (name == NULL)
10938 return;
10939
10940 if (list2fpos(&argvars[1], &pos, &fnum, &curswant, charpos) != OK)
10941 return;
10942
10943 if (pos.col != MAXCOL && --pos.col < 0)
10944 pos.col = 0;
10945 if ((name[0] == '.' && name[1] == NUL))
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010946 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010947 // set cursor; "fnum" is ignored
10948 curwin->w_cursor = pos;
10949 if (curswant >= 0)
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010950 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010951 curwin->w_curswant = curswant - 1;
10952 curwin->w_set_curswant = FALSE;
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010953 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010954 check_cursor();
10955 rettv->vval.v_number = 0;
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010956 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010957 else if (name[0] == '\'' && name[1] != NUL && name[2] == NUL)
10958 {
10959 // set mark
10960 if (setmark_pos(name[1], &pos, fnum) == OK)
10961 rettv->vval.v_number = 0;
10962 }
10963 else
10964 emsg(_(e_invalid_argument));
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010965}
10966/*
10967 * "setcharpos()" function
10968 */
10969 static void
10970f_setcharpos(typval_T *argvars, typval_T *rettv)
10971{
10972 set_position(argvars, rettv, TRUE);
10973}
10974
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010975 static void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010976f_setcharsearch(typval_T *argvars, typval_T *rettv UNUSED)
10977{
10978 dict_T *d;
10979 dictitem_T *di;
10980 char_u *csearch;
10981
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +010010982 if (check_for_dict_arg(argvars, 0) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010983 return;
10984
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010985 if ((d = argvars[0].vval.v_dict) == NULL)
10986 return;
10987
10988 csearch = dict_get_string(d, "char", FALSE);
10989 if (csearch != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010990 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010991 if (enc_utf8)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010992 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010993 int pcc[MAX_MCO];
10994 int c = utfc_ptr2char(csearch, pcc);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010995
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010996 set_last_csearch(c, csearch, utfc_ptr2len(csearch));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010997 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010998 else
10999 set_last_csearch(PTR2CHAR(csearch),
11000 csearch, mb_ptr2len(csearch));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011001 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000011002
11003 di = dict_find(d, (char_u *)"forward", -1);
11004 if (di != NULL)
11005 set_csearch_direction((int)tv_get_number(&di->di_tv)
11006 ? FORWARD : BACKWARD);
11007
11008 di = dict_find(d, (char_u *)"until", -1);
11009 if (di != NULL)
11010 set_csearch_until(!!tv_get_number(&di->di_tv));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011011}
11012
11013/*
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011014 * "setcursorcharpos" function
11015 */
11016 static void
Bram Moolenaar3af15ab2021-01-17 16:16:23 +010011017f_setcursorcharpos(typval_T *argvars, typval_T *rettv)
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011018{
11019 set_cursorpos(argvars, rettv, TRUE);
11020}
11021
11022/*
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011023 * "setenv()" function
11024 */
11025 static void
11026f_setenv(typval_T *argvars, typval_T *rettv UNUSED)
11027{
11028 char_u namebuf[NUMBUFLEN];
11029 char_u valbuf[NUMBUFLEN];
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020011030 char_u *name;
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011031
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020011032 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11033 return;
11034
zeertzjqfcaeb3d2023-11-28 20:46:29 +010011035 // setting an environment variable may be dangerous, e.g. you could
Christian Brabandt6b89dd62023-10-26 22:14:17 +020011036 // setenv GCONV_PATH=/tmp and then have iconv() unexpectedly call
11037 // a shell command using some shared library:
11038 if (check_restricted() || check_secure())
11039 return;
11040
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020011041 name = tv_get_string_buf(&argvars[0], namebuf);
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011042 if (argvars[1].v_type == VAR_SPECIAL
11043 && argvars[1].vval.v_number == VVAL_NULL)
LemonBoy77142312022-04-15 20:50:46 +010011044 vim_unsetenv_ext(name);
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011045 else
LemonBoy77142312022-04-15 20:50:46 +010011046 vim_setenv_ext(name, tv_get_string_buf(&argvars[1], valbuf));
Bram Moolenaar691ddee2019-05-09 14:52:41 +020011047}
11048
11049/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011050 * "setfperm({fname}, {mode})" function
11051 */
11052 static void
11053f_setfperm(typval_T *argvars, typval_T *rettv)
11054{
11055 char_u *fname;
11056 char_u modebuf[NUMBUFLEN];
11057 char_u *mode_str;
11058 int i;
11059 int mask;
11060 int mode = 0;
11061
11062 rettv->vval.v_number = 0;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011063
11064 if (in_vim9script()
11065 && (check_for_string_arg(argvars, 0) == FAIL
11066 || check_for_string_arg(argvars, 1) == FAIL))
11067 return;
11068
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011069 fname = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011070 if (fname == NULL)
11071 return;
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011072 mode_str = tv_get_string_buf_chk(&argvars[1], modebuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011073 if (mode_str == NULL)
11074 return;
11075 if (STRLEN(mode_str) != 9)
11076 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000011077 semsg(_(e_invalid_argument_str), mode_str);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011078 return;
11079 }
11080
11081 mask = 1;
11082 for (i = 8; i >= 0; --i)
11083 {
11084 if (mode_str[i] != '-')
11085 mode |= mask;
11086 mask = mask << 1;
11087 }
11088 rettv->vval.v_number = mch_setperm(fname, mode) == OK;
11089}
11090
11091/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011092 * "setpos()" function
11093 */
11094 static void
11095f_setpos(typval_T *argvars, typval_T *rettv)
11096{
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011097 set_position(argvars, rettv, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011098}
11099
11100/*
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011101 * Translate a register type string to the yank type and block length
11102 */
11103 static int
11104get_yank_type(char_u **pp, char_u *yank_type, long *block_len)
11105{
11106 char_u *stropt = *pp;
11107 switch (*stropt)
11108 {
11109 case 'v': case 'c': // character-wise selection
11110 *yank_type = MCHAR;
11111 break;
11112 case 'V': case 'l': // line-wise selection
11113 *yank_type = MLINE;
11114 break;
11115 case 'b': case Ctrl_V: // block-wise selection
11116 *yank_type = MBLOCK;
11117 if (VIM_ISDIGIT(stropt[1]))
11118 {
11119 ++stropt;
11120 *block_len = getdigits(&stropt) - 1;
11121 --stropt;
11122 }
11123 break;
11124 default:
11125 return FAIL;
11126 }
11127 *pp = stropt;
11128 return OK;
11129}
11130
11131/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011132 * "setreg()" function
11133 */
11134 static void
11135f_setreg(typval_T *argvars, typval_T *rettv)
11136{
11137 int regname;
11138 char_u *strregname;
11139 char_u *stropt;
11140 char_u *strval;
11141 int append;
11142 char_u yank_type;
11143 long block_len;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011144 typval_T *regcontents;
11145 int pointreg;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011146
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020011147 if (in_vim9script()
11148 && (check_for_string_arg(argvars, 0) == FAIL
11149 || check_for_opt_string_arg(argvars, 2) == FAIL))
11150 return;
11151
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011152 pointreg = 0;
11153 regcontents = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011154 block_len = -1;
11155 yank_type = MAUTO;
11156 append = FALSE;
11157
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011158 strregname = tv_get_string_chk(argvars);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011159 rettv->vval.v_number = 1; // FAIL is default
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011160
11161 if (strregname == NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011162 return; // type error; errmsg already given
Bram Moolenaar418a29f2021-02-10 22:23:41 +010011163 if (in_vim9script() && STRLEN(strregname) > 1)
11164 {
11165 semsg(_(e_register_name_must_be_one_char_str), strregname);
11166 return;
11167 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011168 regname = *strregname;
11169 if (regname == 0 || regname == '@')
11170 regname = '"';
11171
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011172 if (argvars[1].v_type == VAR_DICT)
11173 {
11174 dict_T *d = argvars[1].vval.v_dict;
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011175 dictitem_T *di;
11176
11177 if (d == NULL || d->dv_hashtab.ht_used == 0)
11178 {
11179 // Empty dict, clear the register (like setreg(0, []))
11180 char_u *lstval[2] = {NULL, NULL};
11181 write_reg_contents_lst(regname, lstval, 0, FALSE, MAUTO, -1);
11182 return;
11183 }
11184
11185 di = dict_find(d, (char_u *)"regcontents", -1);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011186 if (di != NULL)
11187 regcontents = &di->di_tv;
11188
Bram Moolenaard61efa52022-07-23 09:52:04 +010011189 stropt = dict_get_string(d, "regtype", FALSE);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011190 if (stropt != NULL)
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011191 {
11192 int ret = get_yank_type(&stropt, &yank_type, &block_len);
11193
11194 if (ret == FAIL || *++stropt != NUL)
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011195 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000011196 semsg(_(e_invalid_value_for_argument_str), "value");
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011197 return;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011198 }
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011199 }
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011200
11201 if (regname == '"')
11202 {
Bram Moolenaard61efa52022-07-23 09:52:04 +010011203 stropt = dict_get_string(d, "points_to", FALSE);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011204 if (stropt != NULL)
11205 {
11206 pointreg = *stropt;
11207 regname = pointreg;
11208 }
11209 }
Bram Moolenaard61efa52022-07-23 09:52:04 +010011210 else if (dict_get_bool(d, "isunnamed", -1) > 0)
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011211 pointreg = regname;
11212 }
11213 else
11214 regcontents = &argvars[1];
11215
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011216 if (argvars[2].v_type != VAR_UNKNOWN)
11217 {
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011218 if (yank_type != MAUTO)
11219 {
Bram Moolenaare1242042021-12-16 20:56:57 +000011220 semsg(_(e_too_many_arguments_for_function_str), "setreg");
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011221 return;
11222 }
11223
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011224 stropt = tv_get_string_chk(&argvars[2]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011225 if (stropt == NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011226 return; // type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011227 for (; *stropt != NUL; ++stropt)
11228 switch (*stropt)
11229 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011230 case 'a': case 'A': // append
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011231 append = TRUE;
11232 break;
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011233 default:
11234 get_yank_type(&stropt, &yank_type, &block_len);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011235 }
11236 }
11237
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011238 if (regcontents && regcontents->v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011239 {
11240 char_u **lstval;
11241 char_u **allocval;
11242 char_u buf[NUMBUFLEN];
11243 char_u **curval;
11244 char_u **curallocval;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011245 list_T *ll = regcontents->vval.v_list;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011246 listitem_T *li;
11247 int len;
11248
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011249 // If the list is NULL handle like an empty list.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011250 len = ll == NULL ? 0 : ll->lv_len;
11251
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011252 // First half: use for pointers to result lines; second half: use for
11253 // pointers to allocated copies.
Bram Moolenaarc799fe22019-05-28 23:08:19 +020011254 lstval = ALLOC_MULT(char_u *, (len + 1) * 2);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011255 if (lstval == NULL)
11256 return;
11257 curval = lstval;
11258 allocval = lstval + len + 2;
11259 curallocval = allocval;
11260
Bram Moolenaar50985eb2020-01-27 22:09:39 +010011261 if (ll != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011262 {
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020011263 CHECK_LIST_MATERIALIZE(ll);
Bram Moolenaar00d253e2020-04-06 22:13:01 +020011264 FOR_ALL_LIST_ITEMS(ll, li)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011265 {
Bram Moolenaar50985eb2020-01-27 22:09:39 +010011266 strval = tv_get_string_buf_chk(&li->li_tv, buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011267 if (strval == NULL)
11268 goto free_lstval;
Bram Moolenaar50985eb2020-01-27 22:09:39 +010011269 if (strval == buf)
11270 {
11271 // Need to make a copy, next tv_get_string_buf_chk() will
11272 // overwrite the string.
11273 strval = vim_strsave(buf);
11274 if (strval == NULL)
11275 goto free_lstval;
11276 *curallocval++ = strval;
11277 }
11278 *curval++ = strval;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011279 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011280 }
11281 *curval++ = NULL;
11282
11283 write_reg_contents_lst(regname, lstval, -1,
11284 append, yank_type, block_len);
11285free_lstval:
11286 while (curallocval > allocval)
11287 vim_free(*--curallocval);
11288 vim_free(lstval);
11289 }
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011290 else if (regcontents)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011291 {
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011292 strval = tv_get_string_chk(regcontents);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011293 if (strval == NULL)
11294 return;
11295 write_reg_contents_ex(regname, strval, -1,
11296 append, yank_type, block_len);
11297 }
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011298 if (pointreg != 0)
11299 get_yank_register(pointreg, TRUE);
11300
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011301 rettv->vval.v_number = 0;
11302}
11303
11304/*
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011305 * "settagstack()" function
11306 */
11307 static void
11308f_settagstack(typval_T *argvars, typval_T *rettv)
11309{
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011310 win_T *wp;
11311 dict_T *d;
11312 int action = 'r';
11313
11314 rettv->vval.v_number = -1;
11315
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011316 if (in_vim9script()
11317 && (check_for_number_arg(argvars, 0) == FAIL
11318 || check_for_dict_arg(argvars, 1) == FAIL
11319 || check_for_opt_string_arg(argvars, 2) == FAIL))
11320 return;
11321
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011322 // first argument: window number or id
11323 wp = find_win_by_nr_or_id(&argvars[0]);
11324 if (wp == NULL)
11325 return;
11326
11327 // second argument: dict with items to set in the tag stack
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +010011328 if (check_for_dict_arg(argvars, 1) == FAIL)
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011329 return;
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011330 d = argvars[1].vval.v_dict;
11331 if (d == NULL)
11332 return;
11333
11334 // third argument: action - 'a' for append and 'r' for replace.
11335 // default is to replace the stack.
11336 if (argvars[2].v_type == VAR_UNKNOWN)
11337 action = 'r';
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +010011338 else if (check_for_string_arg(argvars, 2) == FAIL)
11339 return;
11340 else
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011341 {
11342 char_u *actstr;
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011343 actstr = tv_get_string_chk(&argvars[2]);
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011344 if (actstr == NULL)
11345 return;
Bram Moolenaar271fa082020-01-02 14:02:16 +010011346 if ((*actstr == 'r' || *actstr == 'a' || *actstr == 't')
11347 && actstr[1] == NUL)
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011348 action = *actstr;
11349 else
11350 {
Bram Moolenaard82a47d2022-01-05 20:24:39 +000011351 semsg(_(e_invalid_action_str_2), actstr);
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011352 return;
11353 }
11354 }
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011355
11356 if (set_tagstack(wp, d, action) == OK)
11357 rettv->vval.v_number = 0;
11358}
11359
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011360#ifdef FEAT_CRYPT
11361/*
11362 * "sha256({string})" function
11363 */
11364 static void
11365f_sha256(typval_T *argvars, typval_T *rettv)
11366{
11367 char_u *p;
11368
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011369 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11370 return;
11371
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011372 p = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011373 rettv->vval.v_string = vim_strsave(
11374 sha256_bytes(p, (int)STRLEN(p), NULL, 0));
11375 rettv->v_type = VAR_STRING;
11376}
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011377#endif // FEAT_CRYPT
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011378
11379/*
11380 * "shellescape({string})" function
11381 */
11382 static void
11383f_shellescape(typval_T *argvars, typval_T *rettv)
11384{
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011385 int do_special;
Bram Moolenaar20615522017-06-05 18:46:26 +020011386
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011387 if (in_vim9script()
11388 && (check_for_string_arg(argvars, 0) == FAIL
11389 || check_for_opt_bool_arg(argvars, 1) == FAIL))
11390 return;
11391
11392 do_special = non_zero_arg(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011393 rettv->vval.v_string = vim_strsave_shellescape(
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011394 tv_get_string(&argvars[0]), do_special, do_special);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011395 rettv->v_type = VAR_STRING;
11396}
11397
11398/*
11399 * shiftwidth() function
11400 */
11401 static void
11402f_shiftwidth(typval_T *argvars UNUSED, typval_T *rettv)
11403{
Bram Moolenaarf9514162018-11-22 03:08:29 +010011404 rettv->vval.v_number = 0;
11405
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011406 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
11407 return;
11408
Bram Moolenaarf9514162018-11-22 03:08:29 +010011409 if (argvars[0].v_type != VAR_UNKNOWN)
11410 {
11411 long col;
11412
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011413 col = (long)tv_get_number_chk(argvars, NULL);
Bram Moolenaarf9514162018-11-22 03:08:29 +010011414 if (col < 0)
11415 return; // type error; errmsg already given
11416#ifdef FEAT_VARTABS
Gary Johnson88d4f252024-06-01 20:51:33 +020011417 rettv->vval.v_number = get_sw_value_col(curbuf, col, FALSE);
Bram Moolenaarf9514162018-11-22 03:08:29 +010011418 return;
11419#endif
11420 }
11421
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011422 rettv->vval.v_number = get_sw_value(curbuf);
11423}
11424
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011425/*
11426 * "soundfold({word})" function
11427 */
11428 static void
11429f_soundfold(typval_T *argvars, typval_T *rettv)
11430{
11431 char_u *s;
11432
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011433 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11434 return;
11435
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011436 rettv->v_type = VAR_STRING;
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011437 s = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011438#ifdef FEAT_SPELL
11439 rettv->vval.v_string = eval_soundfold(s);
11440#else
11441 rettv->vval.v_string = vim_strsave(s);
11442#endif
11443}
11444
11445/*
11446 * "spellbadword()" function
11447 */
11448 static void
11449f_spellbadword(typval_T *argvars UNUSED, typval_T *rettv)
11450{
11451 char_u *word = (char_u *)"";
11452 hlf_T attr = HLF_COUNT;
11453 int len = 0;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011454#ifdef FEAT_SPELL
11455 int wo_spell_save = curwin->w_p_spell;
11456
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011457 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
11458 return;
11459
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011460 if (!curwin->w_p_spell)
11461 {
Yegappan Lakshmananaf936912023-02-20 12:16:39 +000011462 parse_spelllang(curwin);
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011463 curwin->w_p_spell = TRUE;
11464 }
11465
11466 if (*curwin->w_s->b_p_spl == NUL)
11467 {
Bram Moolenaar460ae5d2022-01-01 14:19:49 +000011468 emsg(_(e_spell_checking_is_not_possible));
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011469 curwin->w_p_spell = wo_spell_save;
11470 return;
11471 }
11472#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011473
11474 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011475 {
11476#ifdef FEAT_SPELL
11477 curwin->w_p_spell = wo_spell_save;
11478#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011479 return;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011480 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011481
11482#ifdef FEAT_SPELL
11483 if (argvars[0].v_type == VAR_UNKNOWN)
11484 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011485 // Find the start and length of the badly spelled word.
Christ van Willegen - van Noort8e4c4c72024-05-17 18:49:27 +020011486 len = spell_move_to(curwin, FORWARD, SMT_ALL, TRUE, &attr);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011487 if (len != 0)
Bram Moolenaarb73fa622017-12-21 20:27:47 +010011488 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011489 word = ml_get_cursor();
Bram Moolenaarb73fa622017-12-21 20:27:47 +010011490 curwin->w_set_curswant = TRUE;
11491 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011492 }
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011493 else if (*curbuf->b_s.b_p_spl != NUL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011494 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011495 char_u *str = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011496 int capcol = -1;
11497
11498 if (str != NULL)
11499 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011500 // Check the argument for spelling.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011501 while (*str != NUL)
11502 {
11503 len = spell_check(curwin, str, &attr, &capcol, FALSE);
11504 if (attr != HLF_COUNT)
11505 {
11506 word = str;
11507 break;
11508 }
11509 str += len;
Bram Moolenaar66ab9162018-07-20 20:28:48 +020011510 capcol -= len;
Bram Moolenaar0c779e82019-08-09 17:01:02 +020011511 len = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011512 }
11513 }
11514 }
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011515 curwin->w_p_spell = wo_spell_save;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011516#endif
11517
11518 list_append_string(rettv->vval.v_list, word, len);
11519 list_append_string(rettv->vval.v_list, (char_u *)(
11520 attr == HLF_SPB ? "bad" :
11521 attr == HLF_SPR ? "rare" :
11522 attr == HLF_SPL ? "local" :
11523 attr == HLF_SPC ? "caps" :
11524 ""), -1);
11525}
11526
11527/*
11528 * "spellsuggest()" function
11529 */
11530 static void
11531f_spellsuggest(typval_T *argvars UNUSED, typval_T *rettv)
11532{
11533#ifdef FEAT_SPELL
11534 char_u *str;
11535 int typeerr = FALSE;
11536 int maxcount;
11537 garray_T ga;
11538 int i;
11539 listitem_T *li;
11540 int need_capital = FALSE;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011541 int wo_spell_save = curwin->w_p_spell;
11542
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011543 if (in_vim9script()
11544 && (check_for_string_arg(argvars, 0) == FAIL
11545 || check_for_opt_number_arg(argvars, 1) == FAIL
11546 || (argvars[1].v_type != VAR_UNKNOWN
11547 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
11548 return;
11549
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011550 if (!curwin->w_p_spell)
11551 {
Yegappan Lakshmananaf936912023-02-20 12:16:39 +000011552 parse_spelllang(curwin);
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011553 curwin->w_p_spell = TRUE;
11554 }
11555
11556 if (*curwin->w_s->b_p_spl == NUL)
11557 {
Bram Moolenaar460ae5d2022-01-01 14:19:49 +000011558 emsg(_(e_spell_checking_is_not_possible));
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011559 curwin->w_p_spell = wo_spell_save;
11560 return;
11561 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011562#endif
11563
11564 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011565 {
11566#ifdef FEAT_SPELL
11567 curwin->w_p_spell = wo_spell_save;
11568#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011569 return;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011570 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011571
11572#ifdef FEAT_SPELL
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011573 str = tv_get_string(&argvars[0]);
11574 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011575 {
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011576 maxcount = (int)tv_get_number_chk(&argvars[1], &typeerr);
11577 if (maxcount <= 0)
11578 return;
11579 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011580 {
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011581 need_capital = (int)tv_get_bool_chk(&argvars[2], &typeerr);
11582 if (typeerr)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011583 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011584 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011585 }
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011586 else
11587 maxcount = 25;
11588
11589 spell_suggest_list(&ga, str, maxcount, need_capital, FALSE);
11590
11591 for (i = 0; i < ga.ga_len; ++i)
11592 {
11593 str = ((char_u **)ga.ga_data)[i];
11594
11595 li = listitem_alloc();
11596 if (li == NULL)
11597 vim_free(str);
11598 else
11599 {
11600 li->li_tv.v_type = VAR_STRING;
11601 li->li_tv.v_lock = 0;
11602 li->li_tv.vval.v_string = str;
11603 list_append(rettv->vval.v_list, li);
11604 }
11605 }
11606 ga_clear(&ga);
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011607 curwin->w_p_spell = wo_spell_save;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011608#endif
11609}
11610
11611 static void
11612f_split(typval_T *argvars, typval_T *rettv)
11613{
11614 char_u *str;
11615 char_u *end;
11616 char_u *pat = NULL;
11617 regmatch_T regmatch;
11618 char_u patbuf[NUMBUFLEN];
11619 char_u *save_cpo;
11620 int match;
11621 colnr_T col = 0;
11622 int keepempty = FALSE;
11623 int typeerr = FALSE;
11624
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011625 if (in_vim9script()
11626 && (check_for_string_arg(argvars, 0) == FAIL
11627 || check_for_opt_string_arg(argvars, 1) == FAIL
11628 || (argvars[1].v_type != VAR_UNKNOWN
11629 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
11630 return;
11631
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011632 // Make 'cpoptions' empty, the 'l' flag should not be used here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011633 save_cpo = p_cpo;
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010011634 p_cpo = empty_option;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011635
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011636 str = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011637 if (argvars[1].v_type != VAR_UNKNOWN)
11638 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011639 pat = tv_get_string_buf_chk(&argvars[1], patbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011640 if (pat == NULL)
11641 typeerr = TRUE;
11642 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar3986b942020-09-06 16:09:04 +020011643 keepempty = (int)tv_get_bool_chk(&argvars[2], &typeerr);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011644 }
11645 if (pat == NULL || *pat == NUL)
11646 pat = (char_u *)"[\\x01- ]\\+";
11647
11648 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar7d5e7442020-07-21 22:25:51 +020011649 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011650 if (typeerr)
Bram Moolenaar7d5e7442020-07-21 22:25:51 +020011651 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011652
11653 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
11654 if (regmatch.regprog != NULL)
11655 {
11656 regmatch.rm_ic = FALSE;
11657 while (*str != NUL || keepempty)
11658 {
11659 if (*str == NUL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011660 match = FALSE; // empty item at the end
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011661 else
11662 match = vim_regexec_nl(&regmatch, str, col);
11663 if (match)
11664 end = regmatch.startp[0];
11665 else
11666 end = str + STRLEN(str);
11667 if (keepempty || end > str || (rettv->vval.v_list->lv_len > 0
11668 && *str != NUL && match && end < regmatch.endp[0]))
11669 {
11670 if (list_append_string(rettv->vval.v_list, str,
11671 (int)(end - str)) == FAIL)
11672 break;
11673 }
11674 if (!match)
11675 break;
Bram Moolenaar13505972019-01-24 15:04:48 +010011676 // Advance to just after the match.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011677 if (regmatch.endp[0] > str)
11678 col = 0;
11679 else
Bram Moolenaar13505972019-01-24 15:04:48 +010011680 // Don't get stuck at the same match.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011681 col = (*mb_ptr2len)(regmatch.endp[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011682 str = regmatch.endp[0];
11683 }
11684
11685 vim_regfree(regmatch.regprog);
11686 }
11687
Bram Moolenaar7d5e7442020-07-21 22:25:51 +020011688theend:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011689 p_cpo = save_cpo;
11690}
11691
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011692/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011693 * "submatch()" function
11694 */
11695 static void
11696f_submatch(typval_T *argvars, typval_T *rettv)
11697{
11698 int error = FALSE;
11699 int no;
11700 int retList = 0;
11701
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011702 if (in_vim9script()
11703 && (check_for_number_arg(argvars, 0) == FAIL
11704 || check_for_opt_bool_arg(argvars, 1) == FAIL))
11705 return;
11706
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011707 no = (int)tv_get_number_chk(&argvars[0], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011708 if (error)
11709 return;
Bram Moolenaar989f5922016-08-21 15:26:54 +020011710 if (no < 0 || no >= NSUBEXP)
11711 {
Bram Moolenaard82a47d2022-01-05 20:24:39 +000011712 semsg(_(e_invalid_submatch_number_nr), no);
Bram Moolenaar79518e22017-02-17 16:31:35 +010011713 return;
Bram Moolenaar989f5922016-08-21 15:26:54 +020011714 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011715 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaarad304702020-09-06 18:22:53 +020011716 retList = (int)tv_get_bool_chk(&argvars[1], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011717 if (error)
11718 return;
11719
11720 if (retList == 0)
11721 {
11722 rettv->v_type = VAR_STRING;
11723 rettv->vval.v_string = reg_submatch(no);
11724 }
11725 else
11726 {
11727 rettv->v_type = VAR_LIST;
11728 rettv->vval.v_list = reg_submatch_list(no);
11729 }
11730}
11731
11732/*
11733 * "substitute()" function
11734 */
11735 static void
11736f_substitute(typval_T *argvars, typval_T *rettv)
11737{
11738 char_u patbuf[NUMBUFLEN];
11739 char_u subbuf[NUMBUFLEN];
11740 char_u flagsbuf[NUMBUFLEN];
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +020011741 char_u *str;
11742 char_u *pat;
Bram Moolenaar72ab7292016-07-19 19:10:51 +020011743 char_u *sub = NULL;
11744 typval_T *expr = NULL;
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +020011745 char_u *flg;
11746
11747 if (in_vim9script()
11748 && (check_for_string_arg(argvars, 0) == FAIL
11749 || check_for_string_arg(argvars, 1) == FAIL
11750 || check_for_string_arg(argvars, 3) == FAIL))
11751 return;
11752
11753 str = tv_get_string_chk(&argvars[0]);
11754 pat = tv_get_string_buf_chk(&argvars[1], patbuf);
11755 flg = tv_get_string_buf_chk(&argvars[3], flagsbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011756
LemonBoyf3b48952022-05-05 13:53:03 +010011757 if (argvars[2].v_type == VAR_FUNC
11758 || argvars[2].v_type == VAR_PARTIAL
Bram Moolenaar00b28d62022-12-08 15:32:33 +000011759 || argvars[2].v_type == VAR_INSTR
11760 || argvars[2].v_type == VAR_CLASS
11761 || argvars[2].v_type == VAR_OBJECT)
Bram Moolenaar72ab7292016-07-19 19:10:51 +020011762 expr = &argvars[2];
11763 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011764 sub = tv_get_string_buf_chk(&argvars[2], subbuf);
Bram Moolenaar72ab7292016-07-19 19:10:51 +020011765
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011766 rettv->v_type = VAR_STRING;
Bram Moolenaar72ab7292016-07-19 19:10:51 +020011767 if (str == NULL || pat == NULL || (sub == NULL && expr == NULL)
11768 || flg == NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011769 rettv->vval.v_string = NULL;
11770 else
John Marriottbd4614f2024-11-18 20:25:21 +010011771 rettv->vval.v_string = do_string_sub(str, STRLEN(str), pat, sub, expr, flg, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011772}
11773
11774/*
Bram Moolenaarc216a7a2022-12-05 13:50:55 +000011775 * "swapfilelist()" function
11776 */
11777 static void
11778f_swapfilelist(typval_T *argvars UNUSED, typval_T *rettv)
11779{
11780 if (rettv_list_alloc(rettv) == FAIL)
11781 return;
11782 recover_names(NULL, FALSE, rettv->vval.v_list, 0, NULL);
11783}
11784
11785/*
Bram Moolenaar00f123a2018-08-21 20:28:54 +020011786 * "swapinfo(swap_filename)" function
11787 */
11788 static void
11789f_swapinfo(typval_T *argvars, typval_T *rettv)
11790{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011791 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11792 return;
11793
Bram Moolenaar00f123a2018-08-21 20:28:54 +020011794 if (rettv_dict_alloc(rettv) == OK)
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011795 get_b0_dict(tv_get_string(argvars), rettv->vval.v_dict);
Bram Moolenaar00f123a2018-08-21 20:28:54 +020011796}
11797
11798/*
Bram Moolenaar110bd602018-09-16 18:46:59 +020011799 * "swapname(expr)" function
11800 */
11801 static void
11802f_swapname(typval_T *argvars, typval_T *rettv)
11803{
11804 buf_T *buf;
11805
11806 rettv->v_type = VAR_STRING;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011807
11808 if (in_vim9script() && check_for_buffer_arg(argvars, 0) == FAIL)
11809 return;
11810
Bram Moolenaarf2d79fa2019-01-03 22:19:27 +010011811 buf = tv_get_buf(&argvars[0], FALSE);
Bram Moolenaar110bd602018-09-16 18:46:59 +020011812 if (buf == NULL || buf->b_ml.ml_mfp == NULL
11813 || buf->b_ml.ml_mfp->mf_fname == NULL)
11814 rettv->vval.v_string = NULL;
11815 else
11816 rettv->vval.v_string = vim_strsave(buf->b_ml.ml_mfp->mf_fname);
11817}
11818
11819/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011820 * "synID(lnum, col, trans)" function
11821 */
11822 static void
11823f_synID(typval_T *argvars UNUSED, typval_T *rettv)
11824{
11825 int id = 0;
11826#ifdef FEAT_SYN_HL
11827 linenr_T lnum;
11828 colnr_T col;
11829 int trans;
11830 int transerr = FALSE;
11831
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011832 if (in_vim9script()
Yegappan Lakshmanancd917202021-07-21 19:09:09 +020011833 && (check_for_lnum_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011834 || check_for_number_arg(argvars, 1) == FAIL
11835 || check_for_bool_arg(argvars, 2) == FAIL))
11836 return;
11837
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011838 lnum = tv_get_lnum(argvars); // -1 on type error
11839 col = (linenr_T)tv_get_number(&argvars[1]) - 1; // -1 on type error
Bram Moolenaarfcb6d702020-09-05 21:41:56 +020011840 trans = (int)tv_get_bool_chk(&argvars[2], &transerr);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011841
11842 if (!transerr && lnum >= 1 && lnum <= curbuf->b_ml.ml_line_count
John Marriottbfcc8952024-03-11 22:04:45 +010011843 && col >= 0 && col < (long)ml_get_len(lnum))
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +000011844 id = syn_get_id(curwin, lnum, col, trans, NULL, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011845#endif
11846
11847 rettv->vval.v_number = id;
11848}
11849
11850/*
11851 * "synIDattr(id, what [, mode])" function
11852 */
11853 static void
11854f_synIDattr(typval_T *argvars UNUSED, typval_T *rettv)
11855{
11856 char_u *p = NULL;
11857#ifdef FEAT_SYN_HL
11858 int id;
11859 char_u *what;
11860 char_u *mode;
11861 char_u modebuf[NUMBUFLEN];
11862 int modec;
11863
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +020011864 if (in_vim9script()
11865 && (check_for_number_arg(argvars, 0) == FAIL
Yegappan Lakshmananf8dbd582021-09-26 19:04:05 +010011866 || check_for_string_arg(argvars, 1) == FAIL
11867 || check_for_opt_string_arg(argvars, 2) == FAIL))
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +020011868 return;
11869
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011870 id = (int)tv_get_number(&argvars[0]);
11871 what = tv_get_string(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011872 if (argvars[2].v_type != VAR_UNKNOWN)
11873 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011874 mode = tv_get_string_buf(&argvars[2], modebuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011875 modec = TOLOWER_ASC(mode[0]);
11876 if (modec != 't' && modec != 'c' && modec != 'g')
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011877 modec = 0; // replace invalid with current
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011878 }
11879 else
11880 {
11881#if defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS)
11882 if (USE_24BIT)
11883 modec = 'g';
11884 else
11885#endif
11886 if (t_colors > 1)
Dominique Pelle4781d6f2021-05-18 21:46:31 +020011887 modec = 'c';
11888 else
11889 modec = 't';
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011890 }
11891
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011892 switch (TOLOWER_ASC(what[0]))
11893 {
11894 case 'b':
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011895 if (TOLOWER_ASC(what[1]) == 'g') // bg[#]
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011896 p = highlight_color(id, what, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011897 else // bold
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011898 p = highlight_has_attr(id, HL_BOLD, modec);
11899 break;
11900
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011901 case 'f': // fg[#] or font
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011902 p = highlight_color(id, what, modec);
11903 break;
11904
11905 case 'i':
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011906 if (TOLOWER_ASC(what[1]) == 'n') // inverse
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011907 p = highlight_has_attr(id, HL_INVERSE, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011908 else // italic
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011909 p = highlight_has_attr(id, HL_ITALIC, modec);
11910 break;
11911
Martin Tournoijba43e762022-10-13 22:12:15 +010011912 case 'n':
Bram Moolenaarde786322022-07-30 14:56:17 +010011913 if (TOLOWER_ASC(what[1]) == 'o') // nocombine
11914 p = highlight_has_attr(id, HL_NOCOMBINE, modec);
11915 else // name
11916 p = get_highlight_name_ext(NULL, id - 1, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011917 break;
11918
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011919 case 'r': // reverse
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011920 p = highlight_has_attr(id, HL_INVERSE, modec);
11921 break;
11922
11923 case 's':
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011924 if (TOLOWER_ASC(what[1]) == 'p') // sp[#]
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011925 p = highlight_color(id, what, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011926 // strikeout
Bram Moolenaarcf4b00c2017-09-02 18:33:56 +020011927 else if (TOLOWER_ASC(what[1]) == 't' &&
11928 TOLOWER_ASC(what[2]) == 'r')
11929 p = highlight_has_attr(id, HL_STRIKETHROUGH, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011930 else // standout
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011931 p = highlight_has_attr(id, HL_STANDOUT, modec);
11932 break;
11933
11934 case 'u':
Bram Moolenaar84f54632022-06-29 18:39:11 +010011935 if (STRLEN(what) >= 9)
11936 {
11937 if (TOLOWER_ASC(what[5]) == 'l')
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011938 // underline
Bram Moolenaar84f54632022-06-29 18:39:11 +010011939 p = highlight_has_attr(id, HL_UNDERLINE, modec);
11940 else if (TOLOWER_ASC(what[5]) != 'd')
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011941 // undercurl
Bram Moolenaar84f54632022-06-29 18:39:11 +010011942 p = highlight_has_attr(id, HL_UNDERCURL, modec);
11943 else if (TOLOWER_ASC(what[6]) != 'o')
11944 // underdashed
11945 p = highlight_has_attr(id, HL_UNDERDASHED, modec);
11946 else if (TOLOWER_ASC(what[7]) == 'u')
11947 // underdouble
11948 p = highlight_has_attr(id, HL_UNDERDOUBLE, modec);
11949 else
11950 // underdotted
11951 p = highlight_has_attr(id, HL_UNDERDOTTED, modec);
11952 }
11953 else
11954 // ul
11955 p = highlight_color(id, what, modec);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011956 break;
11957 }
11958
11959 if (p != NULL)
11960 p = vim_strsave(p);
11961#endif
11962 rettv->v_type = VAR_STRING;
11963 rettv->vval.v_string = p;
11964}
11965
11966/*
11967 * "synIDtrans(id)" function
11968 */
11969 static void
11970f_synIDtrans(typval_T *argvars UNUSED, typval_T *rettv)
11971{
11972 int id;
11973
11974#ifdef FEAT_SYN_HL
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011975 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
11976 return;
11977
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011978 id = (int)tv_get_number(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011979
11980 if (id > 0)
11981 id = syn_get_final_id(id);
11982 else
11983#endif
11984 id = 0;
11985
11986 rettv->vval.v_number = id;
11987}
11988
11989/*
11990 * "synconcealed(lnum, col)" function
11991 */
11992 static void
11993f_synconcealed(typval_T *argvars UNUSED, typval_T *rettv)
11994{
11995#if defined(FEAT_SYN_HL) && defined(FEAT_CONCEAL)
11996 linenr_T lnum;
11997 colnr_T col;
11998 int syntax_flags = 0;
11999 int cchar;
12000 int matchid = 0;
12001 char_u str[NUMBUFLEN];
12002#endif
12003
Bram Moolenaar45cf6e92017-04-30 20:25:19 +020012004 rettv_list_set(rettv, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012005
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020012006 if (in_vim9script()
Yegappan Lakshmanancd917202021-07-21 19:09:09 +020012007 && (check_for_lnum_arg(argvars, 0) == FAIL
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020012008 || check_for_number_arg(argvars, 1) == FAIL))
12009 return;
12010
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012011#if defined(FEAT_SYN_HL) && defined(FEAT_CONCEAL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012012 lnum = tv_get_lnum(argvars); // -1 on type error
12013 col = (colnr_T)tv_get_number(&argvars[1]) - 1; // -1 on type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012014
Bram Moolenaara80faa82020-04-12 19:37:17 +020012015 CLEAR_FIELD(str);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012016
Bram Moolenaar93a10962022-06-16 11:42:09 +010012017 if (rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012018 {
12019 if (lnum >= 1 && lnum <= curbuf->b_ml.ml_line_count
John Marriottbfcc8952024-03-11 22:04:45 +010012020 && col >= 0 && col <= (long)ml_get_len(lnum)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012021 && curwin->w_p_cole > 0)
12022 {
12023 (void)syn_get_id(curwin, lnum, col, FALSE, NULL, FALSE);
12024 syntax_flags = get_syntax_info(&matchid);
12025
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012026 // get the conceal character
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012027 if ((syntax_flags & HL_CONCEAL) && curwin->w_p_cole < 3)
12028 {
12029 cchar = syn_get_sub_char();
Bram Moolenaar4d785892017-06-22 22:00:50 +020012030 if (cchar == NUL && curwin->w_p_cole == 1)
Bram Moolenaareed9d462021-02-15 20:38:25 +010012031 cchar = (curwin->w_lcs_chars.conceal == NUL) ? ' '
12032 : curwin->w_lcs_chars.conceal;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012033 if (cchar != NUL)
12034 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012035 if (has_mbyte)
12036 (*mb_char2bytes)(cchar, str);
12037 else
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012038 str[0] = cchar;
12039 }
12040 }
12041 }
12042
12043 list_append_number(rettv->vval.v_list,
12044 (syntax_flags & HL_CONCEAL) != 0);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012045 // -1 to auto-determine strlen
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012046 list_append_string(rettv->vval.v_list, str, -1);
12047 list_append_number(rettv->vval.v_list, matchid);
12048 }
12049#endif
12050}
12051
12052/*
12053 * "synstack(lnum, col)" function
12054 */
12055 static void
12056f_synstack(typval_T *argvars UNUSED, typval_T *rettv)
12057{
12058#ifdef FEAT_SYN_HL
12059 linenr_T lnum;
12060 colnr_T col;
12061 int i;
12062 int id;
12063#endif
12064
Bram Moolenaar45cf6e92017-04-30 20:25:19 +020012065 rettv_list_set(rettv, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012066
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020012067 if (in_vim9script()
Yegappan Lakshmanancd917202021-07-21 19:09:09 +020012068 && (check_for_lnum_arg(argvars, 0) == FAIL
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020012069 || check_for_number_arg(argvars, 1) == FAIL))
12070 return;
12071
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012072#ifdef FEAT_SYN_HL
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012073 lnum = tv_get_lnum(argvars); // -1 on type error
12074 col = (colnr_T)tv_get_number(&argvars[1]) - 1; // -1 on type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012075
12076 if (lnum >= 1 && lnum <= curbuf->b_ml.ml_line_count
John Marriottbfcc8952024-03-11 22:04:45 +010012077 && col >= 0 && col <= (long)ml_get_len(lnum)
Bram Moolenaar93a10962022-06-16 11:42:09 +010012078 && rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012079 {
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +000012080 (void)syn_get_id(curwin, lnum, col, FALSE, NULL, TRUE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012081 for (i = 0; ; ++i)
12082 {
12083 id = syn_get_stack_item(i);
12084 if (id < 0)
12085 break;
12086 if (list_append_number(rettv->vval.v_list, id) == FAIL)
12087 break;
12088 }
12089 }
12090#endif
12091}
12092
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012093/*
12094 * "tabpagebuflist()" function
12095 */
12096 static void
12097f_tabpagebuflist(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
12098{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012099 tabpage_T *tp;
12100 win_T *wp = NULL;
12101
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012102 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
12103 return;
12104
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012105 if (argvars[0].v_type == VAR_UNKNOWN)
12106 wp = firstwin;
12107 else
12108 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012109 tp = find_tabpage((int)tv_get_number(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012110 if (tp != NULL)
12111 wp = (tp == curtab) ? firstwin : tp->tp_firstwin;
12112 }
Bram Moolenaar93a10962022-06-16 11:42:09 +010012113 if (wp != NULL && rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012114 {
12115 for (; wp != NULL; wp = wp->w_next)
12116 if (list_append_number(rettv->vval.v_list,
12117 wp->w_buffer->b_fnum) == FAIL)
12118 break;
12119 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012120}
12121
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012122/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012123 * "tagfiles()" function
12124 */
12125 static void
12126f_tagfiles(typval_T *argvars UNUSED, typval_T *rettv)
12127{
12128 char_u *fname;
12129 tagname_T tn;
12130 int first;
12131
12132 if (rettv_list_alloc(rettv) == FAIL)
12133 return;
12134 fname = alloc(MAXPATHL);
12135 if (fname == NULL)
12136 return;
12137
12138 for (first = TRUE; ; first = FALSE)
12139 if (get_tagfname(&tn, first, fname) == FAIL
12140 || list_append_string(rettv->vval.v_list, fname, -1) == FAIL)
12141 break;
12142 tagname_free(&tn);
12143 vim_free(fname);
12144}
12145
12146/*
12147 * "taglist()" function
12148 */
12149 static void
12150f_taglist(typval_T *argvars, typval_T *rettv)
12151{
Bram Moolenaarc6aafba2017-03-21 17:09:10 +010012152 char_u *fname = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012153 char_u *tag_pattern;
12154
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012155 if (in_vim9script()
12156 && (check_for_string_arg(argvars, 0) == FAIL
12157 || check_for_opt_string_arg(argvars, 1) == FAIL))
12158 return;
12159
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012160 tag_pattern = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012161
12162 rettv->vval.v_number = FALSE;
12163 if (*tag_pattern == NUL)
12164 return;
12165
Bram Moolenaarc6aafba2017-03-21 17:09:10 +010012166 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012167 fname = tv_get_string(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012168 if (rettv_list_alloc(rettv) == OK)
Bram Moolenaarc6aafba2017-03-21 17:09:10 +010012169 (void)get_tags(rettv->vval.v_list, tag_pattern, fname);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012170}
12171
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012172/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012173 * "type(expr)" function
12174 */
12175 static void
12176f_type(typval_T *argvars, typval_T *rettv)
12177{
12178 int n = -1;
12179
12180 switch (argvars[0].v_type)
12181 {
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +010012182 case VAR_NUMBER: n = VAR_TYPE_NUMBER; break;
12183 case VAR_STRING: n = VAR_TYPE_STRING; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012184 case VAR_PARTIAL:
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +010012185 case VAR_FUNC: n = VAR_TYPE_FUNC; break;
12186 case VAR_LIST: n = VAR_TYPE_LIST; break;
12187 case VAR_DICT: n = VAR_TYPE_DICT; break;
12188 case VAR_FLOAT: n = VAR_TYPE_FLOAT; break;
12189 case VAR_BOOL: n = VAR_TYPE_BOOL; break;
12190 case VAR_SPECIAL: n = VAR_TYPE_NONE; break;
Bram Moolenaarf562e722016-07-19 17:25:25 +020012191 case VAR_JOB: n = VAR_TYPE_JOB; break;
12192 case VAR_CHANNEL: n = VAR_TYPE_CHANNEL; break;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +010012193 case VAR_BLOB: n = VAR_TYPE_BLOB; break;
Bram Moolenaarf18332f2021-05-07 17:55:55 +020012194 case VAR_INSTR: n = VAR_TYPE_INSTR; break;
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +020012195 case VAR_TYPEALIAS: n = VAR_TYPE_TYPEALIAS; break;
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012196 case VAR_CLASS:
12197 {
12198 class_T *cl = argvars[0].vval.v_class;
Yegappan Lakshmananda9d3452024-05-02 13:02:36 +020012199 if (cl != NULL && IS_ENUM(cl))
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012200 n = VAR_TYPE_ENUM;
12201 else
12202 n = VAR_TYPE_CLASS;
12203 break;
12204 }
12205 case VAR_OBJECT:
12206 {
Yegappan Lakshmananb2e42b92024-05-01 11:44:17 +020012207 object_T *obj = argvars[0].vval.v_object;
12208
12209 if (obj == NULL)
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012210 n = VAR_TYPE_OBJECT;
Yegappan Lakshmananb2e42b92024-05-01 11:44:17 +020012211 else
12212 {
12213 class_T *cl = argvars[0].vval.v_object->obj_class;
12214 if (IS_ENUM(cl))
12215 n = VAR_TYPE_ENUMVALUE;
12216 else
12217 n = VAR_TYPE_OBJECT;
12218 }
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012219 break;
12220 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012221 case VAR_UNKNOWN:
Bram Moolenaar4c683752020-04-05 21:38:23 +020012222 case VAR_ANY:
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010012223 case VAR_VOID:
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012224 internal_error_no_abort("f_type(UNKNOWN)");
12225 n = -1;
12226 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012227 }
12228 rettv->vval.v_number = n;
12229}
12230
12231/*
zeertzjq825cf812023-08-17 22:55:25 +020012232 * "virtcol({expr}, [, {list} [, {winid}]])" function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012233 */
12234 static void
12235f_virtcol(typval_T *argvars, typval_T *rettv)
12236{
LemonBoy0f7a3e12022-05-26 12:10:37 +010012237 colnr_T vcol_start = 0;
12238 colnr_T vcol_end = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012239 pos_T *fp;
zeertzjq825cf812023-08-17 22:55:25 +020012240 switchwin_T switchwin;
12241 int winchanged = FALSE;
Bram Moolenaarb3d33d82020-01-15 20:36:55 +010012242 int len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012243
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012244 if (in_vim9script()
LemonBoy0f7a3e12022-05-26 12:10:37 +010012245 && (check_for_string_or_list_arg(argvars, 0) == FAIL
12246 || (argvars[1].v_type != VAR_UNKNOWN
zeertzjq825cf812023-08-17 22:55:25 +020012247 && (check_for_bool_arg(argvars, 1) == FAIL
12248 || check_for_opt_number_arg(argvars, 2) == FAIL))))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012249 return;
12250
zeertzjq825cf812023-08-17 22:55:25 +020012251 if (argvars[1].v_type != VAR_UNKNOWN && argvars[2].v_type != VAR_UNKNOWN)
12252 {
12253 tabpage_T *tp;
12254 win_T *wp;
12255
12256 // use the window specified in the third argument
12257 wp = win_id2wp_tp((int)tv_get_number(&argvars[2]), &tp);
12258 if (wp == NULL || tp == NULL)
12259 goto theend;
12260
12261 if (switch_win_noblock(&switchwin, wp, tp, TRUE) != OK)
12262 goto theend;
12263
12264 check_cursor();
12265 winchanged = TRUE;
12266 }
12267
12268 int fnum = curbuf->b_fnum;
Bram Moolenaar6f02b002021-01-10 20:22:54 +010012269 fp = var2fpos(&argvars[0], FALSE, &fnum, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012270 if (fp != NULL && fp->lnum <= curbuf->b_ml.ml_line_count
LemonBoy0f7a3e12022-05-26 12:10:37 +010012271 && fnum == curbuf->b_fnum)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012272 {
Bram Moolenaarb3d33d82020-01-15 20:36:55 +010012273 // Limit the column to a valid value, getvvcol() doesn't check.
12274 if (fp->col < 0)
12275 fp->col = 0;
12276 else
12277 {
John Marriottbfcc8952024-03-11 22:04:45 +010012278 len = (int)ml_get_len(fp->lnum);
Bram Moolenaarb3d33d82020-01-15 20:36:55 +010012279 if (fp->col > len)
12280 fp->col = len;
12281 }
LemonBoy0f7a3e12022-05-26 12:10:37 +010012282 getvvcol(curwin, fp, &vcol_start, NULL, &vcol_end);
12283 ++vcol_start;
12284 ++vcol_end;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012285 }
12286
zeertzjq825cf812023-08-17 22:55:25 +020012287theend:
LemonBoy0f7a3e12022-05-26 12:10:37 +010012288 if (argvars[1].v_type != VAR_UNKNOWN && tv_get_bool(&argvars[1]))
12289 {
12290 if (rettv_list_alloc(rettv) == OK)
12291 {
12292 list_append_number(rettv->vval.v_list, vcol_start);
12293 list_append_number(rettv->vval.v_list, vcol_end);
12294 }
12295 else
12296 rettv->vval.v_number = 0;
12297 }
12298 else
12299 rettv->vval.v_number = vcol_end;
zeertzjq825cf812023-08-17 22:55:25 +020012300
12301 if (winchanged)
12302 restore_win_noblock(&switchwin, TRUE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012303}
12304
12305/*
12306 * "visualmode()" function
12307 */
12308 static void
12309f_visualmode(typval_T *argvars, typval_T *rettv)
12310{
12311 char_u str[2];
12312
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012313 if (in_vim9script() && check_for_opt_bool_arg(argvars, 0) == FAIL)
12314 return;
12315
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012316 rettv->v_type = VAR_STRING;
12317 str[0] = curbuf->b_visual_mode_eval;
12318 str[1] = NUL;
12319 rettv->vval.v_string = vim_strsave(str);
12320
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012321 // A non-zero number or non-empty string argument: reset mode.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012322 if (non_zero_arg(&argvars[0]))
12323 curbuf->b_visual_mode_eval = NUL;
12324}
12325
12326/*
12327 * "wildmenumode()" function
12328 */
12329 static void
12330f_wildmenumode(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
12331{
Bram Moolenaar24959102022-05-07 20:01:16 +010012332 if (wild_menu_showing || ((State & MODE_CMDLINE) && cmdline_pum_active()))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012333 rettv->vval.v_number = 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012334}
12335
12336/*
Bram Moolenaar0c1e3742019-12-27 13:49:24 +010012337 * "windowsversion()" function
12338 */
12339 static void
12340f_windowsversion(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
12341{
12342 rettv->v_type = VAR_STRING;
12343 rettv->vval.v_string = vim_strsave((char_u *)windowsVersion);
12344}
12345
12346/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012347 * "wordcount()" function
12348 */
12349 static void
12350f_wordcount(typval_T *argvars UNUSED, typval_T *rettv)
12351{
12352 if (rettv_dict_alloc(rettv) == FAIL)
12353 return;
12354 cursor_pos_info(rettv->vval.v_dict);
12355}
12356
12357/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012358 * "xor(expr, expr)" function
12359 */
12360 static void
12361f_xor(typval_T *argvars, typval_T *rettv)
12362{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012363 if (in_vim9script()
12364 && (check_for_number_arg(argvars, 0) == FAIL
12365 || check_for_number_arg(argvars, 1) == FAIL))
12366 return;
12367
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012368 rettv->vval.v_number = tv_get_number_chk(&argvars[0], NULL)
12369 ^ tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012370}
12371
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012372#endif // FEAT_EVAL