blob: 63142523c53d636ef6f3ad7b08942f62be488da0 [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);
122static void f_nr2char(typval_T *argvars, typval_T *rettv);
123static void f_or(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200124#ifdef FEAT_PERL
125static void f_perleval(typval_T *argvars, typval_T *rettv);
126#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200127static void f_prevnonblank(typval_T *argvars, typval_T *rettv);
128static void f_printf(typval_T *argvars, typval_T *rettv);
Bram Moolenaare9bd5722019-08-17 19:36:06 +0200129static void f_pum_getpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200130static void f_pumvisible(typval_T *argvars, typval_T *rettv);
131#ifdef FEAT_PYTHON3
132static void f_py3eval(typval_T *argvars, typval_T *rettv);
133#endif
134#ifdef FEAT_PYTHON
135static void f_pyeval(typval_T *argvars, typval_T *rettv);
136#endif
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +0100137#if defined(FEAT_PYTHON) || defined(FEAT_PYTHON3)
138static void f_pyxeval(typval_T *argvars, typval_T *rettv);
139#endif
Bram Moolenaar4f645c52020-02-08 16:40:39 +0100140static void f_test_srand_seed(typval_T *argvars, typval_T *rettv);
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +0100141static void f_rand(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200142static void f_range(typval_T *argvars, typval_T *rettv);
Bram Moolenaar0b6d9112018-05-22 20:35:17 +0200143static void f_reg_executing(typval_T *argvars, typval_T *rettv);
144static void f_reg_recording(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200145static void f_rename(typval_T *argvars, typval_T *rettv);
146static void f_repeat(typval_T *argvars, typval_T *rettv);
Bram Moolenaare99be0e2019-03-26 22:51:09 +0100147#ifdef FEAT_RUBY
148static void f_rubyeval(typval_T *argvars, typval_T *rettv);
149#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200150static void f_screenattr(typval_T *argvars, typval_T *rettv);
151static void f_screenchar(typval_T *argvars, typval_T *rettv);
Bram Moolenaar2912abb2019-03-29 14:16:42 +0100152static void f_screenchars(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200153static void f_screencol(typval_T *argvars, typval_T *rettv);
154static void f_screenrow(typval_T *argvars, typval_T *rettv);
Bram Moolenaar2912abb2019-03-29 14:16:42 +0100155static void f_screenstring(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200156static void f_search(typval_T *argvars, typval_T *rettv);
157static void f_searchdecl(typval_T *argvars, typval_T *rettv);
158static void f_searchpair(typval_T *argvars, typval_T *rettv);
159static void f_searchpairpos(typval_T *argvars, typval_T *rettv);
160static void f_searchpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar6f02b002021-01-10 20:22:54 +0100161static void f_setcharpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200162static void f_setcharsearch(typval_T *argvars, typval_T *rettv);
Bram Moolenaar6f02b002021-01-10 20:22:54 +0100163static void f_setcursorcharpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar691ddee2019-05-09 14:52:41 +0200164static void f_setenv(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200165static void f_setfperm(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200166static void f_setpos(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200167static void f_setreg(typval_T *argvars, typval_T *rettv);
Bram Moolenaarf49cc602018-11-11 15:21:05 +0100168static void f_settagstack(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200169#ifdef FEAT_CRYPT
170static void f_sha256(typval_T *argvars, typval_T *rettv);
Bram Moolenaarb005cd82019-09-04 15:54:55 +0200171#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200172static void f_shellescape(typval_T *argvars, typval_T *rettv);
173static void f_shiftwidth(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200174static void f_soundfold(typval_T *argvars, typval_T *rettv);
175static void f_spellbadword(typval_T *argvars, typval_T *rettv);
176static void f_spellsuggest(typval_T *argvars, typval_T *rettv);
177static void f_split(typval_T *argvars, typval_T *rettv);
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +0100178static void f_srand(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200179static void f_submatch(typval_T *argvars, typval_T *rettv);
180static void f_substitute(typval_T *argvars, typval_T *rettv);
Bram Moolenaarc216a7a2022-12-05 13:50:55 +0000181static void f_swapfilelist(typval_T *argvars, typval_T *rettv);
Bram Moolenaar00f123a2018-08-21 20:28:54 +0200182static void f_swapinfo(typval_T *argvars, typval_T *rettv);
Bram Moolenaar110bd602018-09-16 18:46:59 +0200183static void f_swapname(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200184static void f_synID(typval_T *argvars, typval_T *rettv);
185static void f_synIDattr(typval_T *argvars, typval_T *rettv);
186static void f_synIDtrans(typval_T *argvars, typval_T *rettv);
187static void f_synstack(typval_T *argvars, typval_T *rettv);
188static void f_synconcealed(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200189static void f_tabpagebuflist(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200190static void f_taglist(typval_T *argvars, typval_T *rettv);
191static void f_tagfiles(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200192static void f_type(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200193static void f_virtcol(typval_T *argvars, typval_T *rettv);
194static void f_visualmode(typval_T *argvars, typval_T *rettv);
195static void f_wildmenumode(typval_T *argvars, typval_T *rettv);
Bram Moolenaar0c1e3742019-12-27 13:49:24 +0100196static void f_windowsversion(typval_T *argvars, typval_T *rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +0200197static void f_wordcount(typval_T *argvars, typval_T *rettv);
198static void f_xor(typval_T *argvars, typval_T *rettv);
199
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +0100200
Bram Moolenaar94738d82020-10-21 14:25:07 +0200201/*
202 * Functions that check the argument type of a builtin function.
203 * Each function returns FAIL and gives an error message if the type is wrong.
204 */
205
206// Context passed to an arg_ function.
207typedef struct {
Bram Moolenaarca174532020-10-21 16:42:22 +0200208 int arg_count; // actual argument count
Bram Moolenaar078a4612022-01-04 15:17:03 +0000209 type2_T *arg_types; // list of argument types
Bram Moolenaarca174532020-10-21 16:42:22 +0200210 int arg_idx; // current argument index (first arg is zero)
Bram Moolenaar351ead02021-01-16 16:07:01 +0100211 cctx_T *arg_cctx;
Bram Moolenaar94738d82020-10-21 14:25:07 +0200212} argcontext_T;
213
214// A function to check one argument type. The first argument is the type to
215// check. If needed, other argument types can be obtained with the context.
216// E.g. if "arg_idx" is 1, then (type - 1) is the first argument type.
Ernie Raela8f7f922023-12-14 20:17:04 +0100217// NOTE: Use "arg_any", not NULL, in funcentry_T.f_argcheck array
218// to accept an argument of any type.
Bram Moolenaar078a4612022-01-04 15:17:03 +0000219typedef int (*argcheck_T)(type_T *, type_T *, argcontext_T *);
Bram Moolenaar94738d82020-10-21 14:25:07 +0200220
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100221/*
Bram Moolenaar351ead02021-01-16 16:07:01 +0100222 * Call need_type() to check an argument type.
223 */
224 static int
225check_arg_type(
226 type_T *expected,
227 type_T *actual,
228 argcontext_T *context)
229{
Bram Moolenaarc6951a72022-12-29 20:56:24 +0000230 return need_type(actual, expected, FALSE,
Bram Moolenaar351ead02021-01-16 16:07:01 +0100231 context->arg_idx - context->arg_count, context->arg_idx + 1,
232 context->arg_cctx, FALSE, FALSE);
233}
234
235/*
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100236 * Call need_type() to check an argument type and that it is modifiable
237 */
238 static int
239check_arg_type_mod(
240 type_T *expected,
241 type_T *actual,
242 argcontext_T *context)
243{
Bram Moolenaarc6951a72022-12-29 20:56:24 +0000244 if (need_type(actual, expected, FALSE,
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100245 context->arg_idx - context->arg_count, context->arg_idx + 1,
246 context->arg_cctx, FALSE, FALSE) == FAIL)
247 return FAIL;
248 return arg_type_modifiable(actual, context->arg_idx + 1);
249}
250
251/*
Bram Moolenaarfa103972022-09-29 19:14:42 +0100252 * Give an error if "type" is a constant.
253 */
254 int
255arg_type_modifiable(type_T *type, int arg_idx)
256{
257 char *tofree;
258
259 if ((type->tt_flags & TTFLAG_CONST) == 0)
260 return OK;
261 semsg(_(e_argument_nr_trying_to_modify_const_str),
262 arg_idx, type_name(type, &tofree));
263 vim_free(tofree);
264 return FAIL;
265}
266
267/*
Ernie Raela8f7f922023-12-14 20:17:04 +0100268 * Return OK for any type unconditionally.
269 */
270 static int
271arg_any(type_T *type UNUSED,
272 type_T *decl_type UNUSED,
273 argcontext_T *context UNUSED)
274{
275 return OK;
276}
277
278/*
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100279 * Check "type" is a float or a number.
280 */
Bram Moolenaar94738d82020-10-21 14:25:07 +0200281 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000282arg_float_or_nr(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaar94738d82020-10-21 14:25:07 +0200283{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100284 if (type->tt_type == VAR_FLOAT
285 || type->tt_type == VAR_NUMBER
286 || type_any_or_unknown(type))
Bram Moolenaar94738d82020-10-21 14:25:07 +0200287 return OK;
288 arg_type_mismatch(&t_number, type, context->arg_idx + 1);
289 return FAIL;
290}
291
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100292/*
293 * Check "type" is a number.
294 */
Bram Moolenaarca174532020-10-21 16:42:22 +0200295 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000296arg_number(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarca174532020-10-21 16:42:22 +0200297{
Bram Moolenaar351ead02021-01-16 16:07:01 +0100298 return check_arg_type(&t_number, type, context);
Bram Moolenaarca174532020-10-21 16:42:22 +0200299}
300
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100301/*
LemonBoyafe04662023-08-23 21:08:11 +0200302 * Check "type" is an object.
303 */
304 static int
305arg_object(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
306{
Yegappan Lakshmananb49ad282023-08-27 19:08:40 +0200307 if (type->tt_type == VAR_OBJECT
308 || type_any_or_unknown(type))
309 return OK;
310 arg_type_mismatch(&t_object, type, context->arg_idx + 1);
311 return FAIL;
LemonBoyafe04662023-08-23 21:08:11 +0200312}
313
314/*
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200315 * Check "type" is a dict of 'any'.
316 */
317 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000318arg_dict_any(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200319{
320 return check_arg_type(&t_dict_any, type, context);
321}
322
323/*
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +0200324 * Check "type" is a list of 'any'.
325 */
326 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000327arg_list_any(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +0200328{
329 return check_arg_type(&t_list_any, type, context);
330}
331
332/*
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100333 * Check "type" is a list of 'any' and modifiable
334 */
335 static int
336arg_list_any_mod(
337 type_T *type,
338 type_T *decl_type UNUSED,
339 argcontext_T *context)
340{
341 return check_arg_type_mod(&t_list_any, type, context);
342}
343
344/*
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200345 * Check "type" is a list of numbers.
346 */
347 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000348arg_list_number(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200349{
350 return check_arg_type(&t_list_number, type, context);
351}
352
353/*
354 * Check "type" is a list of strings.
355 */
356 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000357arg_list_string(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200358{
359 return check_arg_type(&t_list_string, type, context);
360}
361
362/*
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100363 * Check "type" is a string.
364 */
365 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000366arg_string(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100367{
Bram Moolenaar351ead02021-01-16 16:07:01 +0100368 return check_arg_type(&t_string, type, context);
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100369}
370
371/*
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +0200372 * Check "type" is a blob
373 */
374 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000375arg_blob(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +0200376{
377 return check_arg_type(&t_blob, type, context);
378}
379
380/*
Bram Moolenaarf2b26bc2021-01-30 23:05:11 +0100381 * Check "type" is a bool or number 0 or 1.
382 */
383 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000384arg_bool(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarf2b26bc2021-01-30 23:05:11 +0100385{
Bram Moolenaarf2b26bc2021-01-30 23:05:11 +0100386 return check_arg_type(&t_bool, type, context);
387}
388
389/*
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200390 * Check "type" is a list of 'any' or a blob.
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100391 */
Bram Moolenaarca174532020-10-21 16:42:22 +0200392 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000393arg_list_or_blob(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarca174532020-10-21 16:42:22 +0200394{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100395 if (type->tt_type == VAR_LIST
396 || type->tt_type == VAR_BLOB
397 || type_any_or_unknown(type))
Bram Moolenaarca174532020-10-21 16:42:22 +0200398 return OK;
399 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
400 return FAIL;
401}
402
403/*
Bram Moolenaarfa103972022-09-29 19:14:42 +0100404 * Check "type" is a modifiable list of 'any' or a blob.
405 */
406 static int
407arg_list_or_blob_mod(
408 type_T *type,
409 type_T *decl_type,
410 argcontext_T *context)
411{
412 if (arg_list_or_blob(type, decl_type, context) == FAIL)
413 return FAIL;
414 return arg_type_modifiable(type, context->arg_idx + 1);
415}
416
417/*
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200418 * Check "type" is a string or a number
419 */
420 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000421arg_string_or_nr(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200422{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100423 if (type->tt_type == VAR_STRING
424 || type->tt_type == VAR_NUMBER
425 || type_any_or_unknown(type))
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200426 return OK;
427 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
428 return FAIL;
429}
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200430
431/*
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200432 * Check "type" is a buffer (string or a number)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200433 */
434 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000435arg_buffer(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200436{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100437 if (type->tt_type == VAR_STRING
438 || type->tt_type == VAR_NUMBER
439 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200440 return OK;
441 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
442 return FAIL;
443}
444
445/*
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200446 * Check "type" is a buffer or a dict of any
447 */
448 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000449arg_buffer_or_dict_any(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200450{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100451 if (type->tt_type == VAR_STRING
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200452 || type->tt_type == VAR_NUMBER
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100453 || type->tt_type == VAR_DICT
454 || type_any_or_unknown(type))
Yegappan Lakshmanancd917202021-07-21 19:09:09 +0200455 return OK;
456 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
457 return FAIL;
458}
459
460/*
461 * Check "type" is a line (string or a number)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200462 */
463 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000464arg_lnum(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200465{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100466 if (type->tt_type == VAR_STRING
467 || type->tt_type == VAR_NUMBER
468 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200469 return OK;
470 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
471 return FAIL;
472}
473
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +0200474/*
Bram Moolenaarca81f0e2021-06-20 14:41:01 +0200475 * Check "type" is a string or a list of strings.
476 */
477 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000478arg_string_or_list_string(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarca81f0e2021-06-20 14:41:01 +0200479{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100480 if (type->tt_type == VAR_STRING
481 || type_any_or_unknown(type))
Bram Moolenaarca81f0e2021-06-20 14:41:01 +0200482 return OK;
483 if (type->tt_type != VAR_LIST)
484 {
485 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
486 return FAIL;
487 }
488 if (type->tt_member->tt_type == VAR_ANY
489 || type->tt_member->tt_type == VAR_STRING)
490 return OK;
491
492 arg_type_mismatch(&t_list_string, type, context->arg_idx + 1);
493 return FAIL;
494}
495
496/*
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200497 * Check "type" is a string or a list of 'any'
498 */
499 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000500arg_string_or_list_any(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200501{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100502 if (type->tt_type == VAR_STRING
503 || type->tt_type == VAR_LIST
504 || type_any_or_unknown(type))
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200505 return OK;
506 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
507 return FAIL;
508}
509
510/*
Ernie Rael51d04d12022-05-04 15:40:22 +0100511 * Check "type" is a string or a dict of 'any'
512 */
513 static int
514arg_string_or_dict_any(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
515{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100516 if (type->tt_type == VAR_STRING
517 || type->tt_type == VAR_DICT
518 || type_any_or_unknown(type))
Ernie Rael51d04d12022-05-04 15:40:22 +0100519 return OK;
520 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
521 return FAIL;
522}
523
524/*
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200525 * Check "type" is a string or a blob
526 */
527 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000528arg_string_or_blob(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200529{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100530 if (type->tt_type == VAR_STRING
531 || type->tt_type == VAR_BLOB
532 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200533 return OK;
534 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
535 return FAIL;
536}
537
538/*
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +0200539 * Check "type" is a list of 'any' or a dict of 'any'.
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100540 */
541 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000542arg_list_or_dict(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100543{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100544 if (type->tt_type == VAR_LIST
545 || type->tt_type == VAR_DICT
546 || type_any_or_unknown(type))
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100547 return OK;
548 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
549 return FAIL;
550}
551
552/*
Bram Moolenaarfa103972022-09-29 19:14:42 +0100553 * Check "type" is a list of 'any' or a dict of 'any'. And modifiable.
554 */
555 static int
556arg_list_or_dict_mod(
557 type_T *type,
558 type_T *decl_type,
559 argcontext_T *context)
560{
561 if (arg_list_or_dict(type, decl_type, context) == FAIL)
562 return FAIL;
563 return arg_type_modifiable(type, context->arg_idx + 1);
564}
565
566/*
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200567 * Check "type" is a list of 'any' or a dict of 'any' or a blob.
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100568 * Also check if "type" is modifiable.
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200569 */
570 static int
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100571arg_list_or_dict_or_blob_mod(
572 type_T *type,
573 type_T *decl_type UNUSED,
574 argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200575{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100576 if (type->tt_type == VAR_LIST
Bram Moolenaar59618fe2021-12-21 12:32:17 +0000577 || type->tt_type == VAR_DICT
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100578 || type->tt_type == VAR_BLOB
579 || type_any_or_unknown(type))
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100580 return arg_type_modifiable(type, context->arg_idx + 1);
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200581 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
582 return FAIL;
583}
584
585/*
Bram Moolenaar2d877592021-12-16 08:21:09 +0000586 * Check "type" is a list of 'any' or a dict of 'any' or a blob or a string.
587 */
588 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000589arg_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 +0000590{
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
593 || type->tt_type == VAR_BLOB
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100594 || type->tt_type == VAR_STRING
595 || type_any_or_unknown(type))
Bram Moolenaar2d877592021-12-16 08:21:09 +0000596 return OK;
597 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
598 return FAIL;
599}
600
601/*
Bram Moolenaara5d1a672022-09-30 17:57:47 +0100602 * Check "type" is a list of 'any' or a dict of 'any' or a blob or a string.
603 * Also check the value is modifiable.
604 */
605 static int
606arg_list_or_dict_or_blob_or_string_mod(
607 type_T *type,
608 type_T *decl_type,
609 argcontext_T *context)
610{
611 if (arg_list_or_dict_or_blob_or_string(type, decl_type, context) == FAIL)
612 return FAIL;
613 return arg_type_modifiable(type, context->arg_idx + 1);
614}
615
616/*
Ernie Raele79e2072024-01-13 11:47:33 +0100617 * Check second argument of map(), filter(), foreach().
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000618 */
619 static int
Ernie Raele79e2072024-01-13 11:47:33 +0100620check_map_filter_arg2(type_T *type, argcontext_T *context,
621 filtermap_T filtermap)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000622{
623 type_T *expected_member = NULL;
624 type_T *(args[2]);
Bram Moolenaarb1e32ac2023-02-21 12:38:51 +0000625 type_T t_func_exp = {VAR_FUNC, 2, 0, 0, NULL, NULL, args};
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000626
627 if (context->arg_types[0].type_curr->tt_type == VAR_LIST
628 || context->arg_types[0].type_curr->tt_type == VAR_DICT)
629 {
630 // Use the declared type if possible, so that an error is given if
631 // a declared list changes type, but not if a constant list changes
632 // type.
633 if (context->arg_types[0].type_decl->tt_type == VAR_LIST
634 || context->arg_types[0].type_decl->tt_type == VAR_DICT)
635 expected_member = context->arg_types[0].type_decl->tt_member;
636 else
637 expected_member = context->arg_types[0].type_curr->tt_member;
638 }
639 else if (context->arg_types[0].type_curr->tt_type == VAR_STRING)
640 expected_member = &t_string;
641 else if (context->arg_types[0].type_curr->tt_type == VAR_BLOB)
642 expected_member = &t_number;
643
644 args[0] = NULL;
645 args[1] = &t_unknown;
646 if (type->tt_argcount != -1)
647 {
648 if (!(type->tt_argcount == 2 || (type->tt_argcount == 1
649 && (type->tt_flags & TTFLAG_VARARGS))))
650 {
651 emsg(_(e_invalid_number_of_arguments));
652 return FAIL;
653 }
654 if (type->tt_flags & TTFLAG_VARARGS)
655 // check the argument types at runtime
656 t_func_exp.tt_argcount = -1;
657 else
658 {
659 if (context->arg_types[0].type_curr->tt_type == VAR_STRING
660 || context->arg_types[0].type_curr->tt_type == VAR_BLOB
661 || context->arg_types[0].type_curr->tt_type == VAR_LIST)
662 args[0] = &t_number;
663 else if (context->arg_types[0].type_decl->tt_type == VAR_DICT)
664 args[0] = &t_string;
665 if (args[0] != NULL)
666 args[1] = expected_member;
667 }
668 }
669
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100670 if (!type_any_or_unknown(type->tt_member) || args[0] != NULL)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000671 {
672 where_T where = WHERE_INIT;
673
Ernie Raele79e2072024-01-13 11:47:33 +0100674 if (filtermap == FILTERMAP_MAP)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000675 t_func_exp.tt_member = expected_member == NULL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100676 || type_any_or_unknown(type->tt_member)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000677 ? &t_any : expected_member;
Ernie Raele79e2072024-01-13 11:47:33 +0100678 else if (filtermap == FILTERMAP_FILTER)
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000679 t_func_exp.tt_member = &t_bool;
Ernie Raele79e2072024-01-13 11:47:33 +0100680 else // filtermap == FILTERMAP_FOREACH
681 t_func_exp.tt_member = &t_unknown;
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000682 if (args[0] == NULL)
683 args[0] = &t_unknown;
Bram Moolenaar6e1a3872022-02-23 19:11:49 +0000684 if (type->tt_argcount == -1)
685 t_func_exp.tt_argcount = -1;
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000686
687 where.wt_index = 2;
LemonBoyc5d27442023-08-19 13:02:35 +0200688 where.wt_kind = WT_ARGUMENT;
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000689 return check_type(&t_func_exp, type, TRUE, where);
690 }
691 return OK;
692}
693
694/*
Bram Moolenaar18024052021-12-25 21:43:28 +0000695 * Check second argument of filter(): func must return a bool.
696 */
697 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000698arg_filter_func(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaar18024052021-12-25 21:43:28 +0000699{
Bram Moolenaar1080c482022-01-26 18:26:21 +0000700 if (type->tt_type == VAR_STRING
701 || type->tt_type == VAR_PARTIAL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100702 || type_any_or_unknown(type))
Bram Moolenaar1080c482022-01-26 18:26:21 +0000703 return OK;
704
705 if (type->tt_type == VAR_FUNC)
Ernie Raele79e2072024-01-13 11:47:33 +0100706 return check_map_filter_arg2(type, context, FILTERMAP_FILTER);
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000707 semsg(_(e_string_or_function_required_for_argument_nr), 2);
708 return FAIL;
Bram Moolenaar18024052021-12-25 21:43:28 +0000709}
710
711/*
Bram Moolenaareddd4fc2022-02-20 15:52:28 +0000712 * Check second argument of map(), the function.
Bram Moolenaar18024052021-12-25 21:43:28 +0000713 */
714 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000715arg_map_func(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaar18024052021-12-25 21:43:28 +0000716{
Bram Moolenaar1080c482022-01-26 18:26:21 +0000717 if (type->tt_type == VAR_STRING
718 || type->tt_type == VAR_PARTIAL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100719 || type_any_or_unknown(type))
Bram Moolenaar1080c482022-01-26 18:26:21 +0000720 return OK;
721
722 if (type->tt_type == VAR_FUNC)
Ernie Raele79e2072024-01-13 11:47:33 +0100723 return check_map_filter_arg2(type, context, FILTERMAP_MAP);
724 semsg(_(e_string_or_function_required_for_argument_nr), 2);
725 return FAIL;
726}
727
728/*
729 * Check second argument of foreach(), the function.
730 */
731 static int
732arg_foreach_func(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
733{
734 if (type->tt_type == VAR_STRING
735 || type->tt_type == VAR_PARTIAL
736 || type_any_or_unknown(type))
737 return OK;
738
739 if (type->tt_type == VAR_FUNC)
740 return check_map_filter_arg2(type, context, FILTERMAP_FOREACH);
Bram Moolenaar16f6c8a2022-02-22 15:12:14 +0000741 semsg(_(e_string_or_function_required_for_argument_nr), 2);
742 return FAIL;
Bram Moolenaar18024052021-12-25 21:43:28 +0000743}
744
745/*
Bram Moolenaare843efc2022-02-22 21:54:44 +0000746 * Check second argument of sort() and uniq(), the "how" argument.
747 */
748 static int
749arg_sort_how(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
750{
751 if (type->tt_type == VAR_STRING
752 || type->tt_type == VAR_PARTIAL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100753 || type_any_or_unknown(type))
Bram Moolenaare843efc2022-02-22 21:54:44 +0000754 return OK;
755
756 if (type->tt_type == VAR_FUNC)
757 {
758 type_T *(args[2]);
Bram Moolenaarb1e32ac2023-02-21 12:38:51 +0000759 type_T t_func_exp = {VAR_FUNC, 2, 0, 0, &t_number, NULL, args};
Bram Moolenaare843efc2022-02-22 21:54:44 +0000760
761 if (context->arg_types[0].type_curr->tt_type == VAR_LIST)
762 args[0] = context->arg_types[0].type_curr->tt_member;
763 else
764 args[0] = &t_unknown;
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100765 if (!type_any_or_unknown(type->tt_member) || args[0] != &t_unknown)
Bram Moolenaare843efc2022-02-22 21:54:44 +0000766 {
767 where_T where = WHERE_INIT;
768
769 args[1] = args[0];
Bram Moolenaarfa026162022-02-23 21:03:32 +0000770 if (type->tt_argcount == -1)
771 t_func_exp.tt_argcount = -1;
Bram Moolenaare843efc2022-02-22 21:54:44 +0000772 where.wt_index = 2;
LemonBoyc5d27442023-08-19 13:02:35 +0200773 where.wt_kind = WT_ARGUMENT;
Bram Moolenaare843efc2022-02-22 21:54:44 +0000774 return check_type(&t_func_exp, type, TRUE, where);
775 }
776
777 return OK;
778 }
779 semsg(_(e_string_or_function_required_for_argument_nr), 2);
780 return FAIL;
781}
782
783/*
Bram Moolenaar73199812021-12-26 17:18:14 +0000784 * Check an expression argument, can be a string, funcref or partial.
785 * Also accept a bool, a constant resulting from compiling a string argument.
786 * Also accept a number, one and zero are accepted.
787 */
788 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000789arg_string_or_func(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaar73199812021-12-26 17:18:14 +0000790{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100791 if (type->tt_type == VAR_STRING
Bram Moolenaar73199812021-12-26 17:18:14 +0000792 || type->tt_type == VAR_PARTIAL
793 || type->tt_type == VAR_FUNC
794 || type->tt_type == VAR_BOOL
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100795 || type->tt_type == VAR_NUMBER
796 || type_any_or_unknown(type))
Bram Moolenaar73199812021-12-26 17:18:14 +0000797 return OK;
798 arg_type_mismatch(&t_func_any, type, context->arg_idx + 1);
799 return FAIL;
800}
801
802/*
Ernie Rael2025af12023-12-12 16:58:00 +0100803 * Check varargs' "type" are class.
LemonBoyafe04662023-08-23 21:08:11 +0200804 */
805 static int
Ernie Rael2025af12023-12-12 16:58:00 +0100806varargs_class(type_T *type UNUSED,
807 type_T *decl_type UNUSED,
808 argcontext_T *context)
LemonBoyafe04662023-08-23 21:08:11 +0200809{
Ernie Rael2025af12023-12-12 16:58:00 +0100810 for (int i = context->arg_idx; i < context->arg_count; ++i)
811 {
812 type2_T *types = &context->arg_types[i];
813 if (types->type_curr->tt_type != VAR_CLASS)
814 {
815 semsg(_(e_class_or_typealias_required_for_argument_nr), i + 1);
816 return FAIL;
817 }
818 }
819 return OK;
LemonBoyafe04662023-08-23 21:08:11 +0200820}
821
822/*
rbtnn0ccb5842021-12-18 18:33:46 +0000823 * Check "type" is a list of 'any' or a blob or a string.
824 */
825 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000826arg_string_list_or_blob(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
rbtnn0ccb5842021-12-18 18:33:46 +0000827{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100828 if (type->tt_type == VAR_LIST
Bram Moolenaar59618fe2021-12-21 12:32:17 +0000829 || type->tt_type == VAR_BLOB
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100830 || type->tt_type == VAR_STRING
831 || type_any_or_unknown(type))
rbtnn0ccb5842021-12-18 18:33:46 +0000832 return OK;
833 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
834 return FAIL;
835}
836
837/*
Yegappan Lakshmananf9dc2782023-05-11 15:02:56 +0100838 * Check "type" is a modifiable list of 'any' or a blob or a string.
839 */
840 static int
841arg_string_list_or_blob_mod(type_T *type, type_T *decl_type, argcontext_T *context)
842{
843 if (arg_string_list_or_blob(type, decl_type, context) == FAIL)
844 return FAIL;
845 return arg_type_modifiable(type, context->arg_idx + 1);
846}
847
848/*
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +0200849 * Check "type" is a job.
850 */
851 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000852arg_job(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +0200853{
854 return check_arg_type(&t_job, type, context);
855}
856
857/*
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +0200858 * Check "type" is a channel or a job.
859 */
860 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000861arg_chan_or_job(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +0200862{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100863 if (type->tt_type == VAR_CHANNEL
864 || type->tt_type == VAR_JOB
865 || type_any_or_unknown(type))
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +0200866 return OK;
867 arg_type_mismatch(&t_channel, type, context->arg_idx + 1);
868 return FAIL;
869}
870
871/*
Bram Moolenaar078a4612022-01-04 15:17:03 +0000872 * Check "type" can be used as the type_decl of the previous argument.
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100873 * Must not be used for the first argcheck_T entry.
874 */
875 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000876arg_same_as_prev(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100877{
Bram Moolenaar078a4612022-01-04 15:17:03 +0000878 type_T *prev_type = context->arg_types[context->arg_idx - 1].type_decl;
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100879
Bram Moolenaar351ead02021-01-16 16:07:01 +0100880 return check_arg_type(prev_type, type, context);
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100881}
882
883/*
Bram Moolenaarb0e6b512021-01-12 20:23:40 +0100884 * Check "type" is the same basic type as the previous argument, checks list or
885 * dict vs other type, but not member type.
886 * Must not be used for the first argcheck_T entry.
887 */
888 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000889arg_same_struct_as_prev(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarb0e6b512021-01-12 20:23:40 +0100890{
Bram Moolenaar078a4612022-01-04 15:17:03 +0000891 type_T *prev_type = context->arg_types[context->arg_idx - 1].type_curr;
Bram Moolenaarb0e6b512021-01-12 20:23:40 +0100892
Bram Moolenaar078a4612022-01-04 15:17:03 +0000893 if (prev_type->tt_type != context->arg_types[context->arg_idx].type_curr->tt_type)
Bram Moolenaar351ead02021-01-16 16:07:01 +0100894 return check_arg_type(prev_type, type, context);
Bram Moolenaarb0e6b512021-01-12 20:23:40 +0100895 return OK;
896}
897
898/*
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100899 * Check "type" is an item of the list or blob of the previous arg.
Bram Moolenaarca174532020-10-21 16:42:22 +0200900 * Must not be used for the first argcheck_T entry.
901 */
902 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000903arg_item_of_prev(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Bram Moolenaarca174532020-10-21 16:42:22 +0200904{
Bram Moolenaar078a4612022-01-04 15:17:03 +0000905 type_T *prev_type = context->arg_types[context->arg_idx - 1].type_curr;
Bram Moolenaarca174532020-10-21 16:42:22 +0200906 type_T *expected;
907
908 if (prev_type->tt_type == VAR_LIST)
909 expected = prev_type->tt_member;
910 else if (prev_type->tt_type == VAR_BLOB)
911 expected = &t_number;
912 else
913 // probably VAR_ANY, can't check
914 return OK;
915
Bram Moolenaar351ead02021-01-16 16:07:01 +0100916 return check_arg_type(expected, type, context);
Bram Moolenaarca174532020-10-21 16:42:22 +0200917}
918
Bram Moolenaar94738d82020-10-21 14:25:07 +0200919/*
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200920 * Check "type" is a string or a number or a list
921 */
922 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000923arg_str_or_nr_or_list(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200924{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100925 if (type->tt_type == VAR_STRING
Bram Moolenaar59618fe2021-12-21 12:32:17 +0000926 || type->tt_type == VAR_NUMBER
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100927 || type->tt_type == VAR_LIST
928 || type_any_or_unknown(type))
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +0200929 return OK;
930 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
931 return FAIL;
932}
933
934/*
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200935 * Check "type" is a dict of 'any' or a string
936 */
937 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000938arg_dict_any_or_string(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200939{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100940 if (type->tt_type == VAR_DICT
941 || type->tt_type == VAR_STRING
942 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200943 return OK;
944 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
945 return FAIL;
946}
947
948/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +0200949 * Check "type" which is the third argument of extend() (number or string or
950 * any)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100951 */
952 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000953arg_extend3(type_T *type, type_T *decl_type, argcontext_T *context)
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100954{
Bram Moolenaar078a4612022-01-04 15:17:03 +0000955 type_T *first_type = context->arg_types[context->arg_idx - 2].type_curr;
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100956
957 if (first_type->tt_type == VAR_LIST)
Bram Moolenaar078a4612022-01-04 15:17:03 +0000958 return arg_number(type, decl_type, context);
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100959 if (first_type->tt_type == VAR_DICT)
Bram Moolenaar078a4612022-01-04 15:17:03 +0000960 return arg_string(type, decl_type, context);
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +0100961 return OK;
962}
963
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +0200964/*
Yegappan Lakshmanana764e732021-07-25 15:57:32 +0200965 * Check "type" which is the first argument of get() (blob or list or dict or
966 * funcref)
967 */
968 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000969arg_get1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana764e732021-07-25 15:57:32 +0200970{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100971 if (type->tt_type == VAR_BLOB
Yegappan Lakshmanana764e732021-07-25 15:57:32 +0200972 || type->tt_type == VAR_LIST
973 || type->tt_type == VAR_DICT
974 || type->tt_type == VAR_FUNC
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100975 || type->tt_type == VAR_PARTIAL
976 || type_any_or_unknown(type))
Yegappan Lakshmanana764e732021-07-25 15:57:32 +0200977 return OK;
978
979 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
980 return FAIL;
981}
982
983/*
984 * Check "type" which is the first argument of len() (number or string or
985 * blob or list or dict)
986 */
987 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +0000988arg_len1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanana764e732021-07-25 15:57:32 +0200989{
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100990 if (type->tt_type == VAR_STRING
Yegappan Lakshmanana764e732021-07-25 15:57:32 +0200991 || type->tt_type == VAR_NUMBER
992 || type->tt_type == VAR_BLOB
993 || type->tt_type == VAR_LIST
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100994 || type->tt_type == VAR_DICT
Yegappan Lakshmanand3eae7b2024-03-03 16:26:58 +0100995 || type->tt_type == VAR_OBJECT
Bram Moolenaar330d64d2022-10-09 12:55:33 +0100996 || type_any_or_unknown(type))
Yegappan Lakshmanana764e732021-07-25 15:57:32 +0200997 return OK;
998
999 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
1000 return FAIL;
1001}
1002
1003/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001004 * Check "type" which is the second argument of remove() (number or string or
1005 * any)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001006 */
1007 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001008arg_remove2(type_T *type, type_T *decl_type, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001009{
Bram Moolenaar078a4612022-01-04 15:17:03 +00001010 type_T *first_type = context->arg_types[context->arg_idx - 1].type_curr;
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001011
1012 if (first_type->tt_type == VAR_LIST || first_type->tt_type == VAR_BLOB)
Bram Moolenaar078a4612022-01-04 15:17:03 +00001013 return arg_number(type, decl_type, context);
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001014 if (first_type->tt_type == VAR_DICT)
Bram Moolenaar078a4612022-01-04 15:17:03 +00001015 return arg_string_or_nr(type, decl_type, context);
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001016 return OK;
1017}
1018
1019/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001020 * Check "type" which is the first argument of repeat() (string or number or
1021 * list or any)
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001022 */
1023 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001024arg_repeat1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001025{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001026 if (type->tt_type == VAR_STRING
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001027 || type->tt_type == VAR_NUMBER
Bakudankun375141e2022-09-09 18:46:47 +01001028 || type->tt_type == VAR_BLOB
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001029 || type->tt_type == VAR_LIST
1030 || type_any_or_unknown(type))
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001031 return OK;
1032
1033 arg_type_mismatch(&t_string, type, context->arg_idx + 1);
1034 return FAIL;
1035}
1036
1037/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001038 * Check "type" which is the first argument of slice() (list or blob or string
1039 * or any)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001040 */
1041 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001042arg_slice1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001043{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001044 if (type->tt_type == VAR_LIST
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001045 || type->tt_type == VAR_BLOB
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001046 || type->tt_type == VAR_STRING
1047 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001048 return OK;
1049
1050 arg_type_mismatch(&t_list_any, type, context->arg_idx + 1);
1051 return FAIL;
1052}
1053
1054/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001055 * Check "type" which is the first argument of count() (string or list or dict
1056 * or any)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001057 */
1058 static int
Bram Moolenaar3e518a82022-08-30 17:45:33 +01001059arg_string_or_list_or_dict(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001060{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001061 if (type->tt_type == VAR_STRING
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001062 || type->tt_type == VAR_LIST
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001063 || type->tt_type == VAR_DICT
1064 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001065 return OK;
1066
Bram Moolenaar3e518a82022-08-30 17:45:33 +01001067 semsg(_(e_string_list_or_dict_required_for_argument_nr),
1068 context->arg_idx + 1);
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001069 return FAIL;
1070}
1071
1072/*
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001073 * Check "type" which is the first argument of cursor() (number or string or
1074 * list or any)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001075 */
1076 static int
Bram Moolenaar078a4612022-01-04 15:17:03 +00001077arg_cursor1(type_T *type, type_T *decl_type UNUSED, argcontext_T *context)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001078{
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001079 if (type->tt_type == VAR_NUMBER
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001080 || type->tt_type == VAR_STRING
Bram Moolenaar330d64d2022-10-09 12:55:33 +01001081 || type->tt_type == VAR_LIST
1082 || type_any_or_unknown(type))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001083 return OK;
1084
1085 arg_type_mismatch(&t_number, type, context->arg_idx + 1);
1086 return FAIL;
1087}
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01001088
1089/*
Bram Moolenaar94738d82020-10-21 14:25:07 +02001090 * Lists of functions that check the argument types of a builtin function.
1091 */
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +02001092static argcheck_T arg1_blob[] = {arg_blob};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001093static argcheck_T arg1_bool[] = {arg_bool};
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001094static argcheck_T arg1_buffer[] = {arg_buffer};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001095static argcheck_T arg1_buffer_or_dict_any[] = {arg_buffer_or_dict_any};
1096static argcheck_T arg1_chan_or_job[] = {arg_chan_or_job};
1097static argcheck_T arg1_dict_any[] = {arg_dict_any};
1098static argcheck_T arg1_dict_or_string[] = {arg_dict_any_or_string};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001099static argcheck_T arg1_float_or_nr[] = {arg_float_or_nr};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001100static argcheck_T arg1_job[] = {arg_job};
1101static argcheck_T arg1_list_any[] = {arg_list_any};
1102static argcheck_T arg1_list_number[] = {arg_list_number};
Yegappan Lakshmananf9dc2782023-05-11 15:02:56 +01001103static argcheck_T arg1_string_or_list_or_blob_mod[] = {arg_string_list_or_blob_mod};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001104static argcheck_T arg1_list_or_dict[] = {arg_list_or_dict};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001105static argcheck_T arg1_list_string[] = {arg_list_string};
Bram Moolenaar3e518a82022-08-30 17:45:33 +01001106static argcheck_T arg1_string_or_list_or_dict[] = {arg_string_or_list_or_dict};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001107static argcheck_T arg1_lnum[] = {arg_lnum};
1108static argcheck_T arg1_number[] = {arg_number};
1109static argcheck_T arg1_string[] = {arg_string};
1110static argcheck_T arg1_string_or_list_any[] = {arg_string_or_list_any};
1111static argcheck_T arg1_string_or_list_string[] = {arg_string_or_list_string};
1112static argcheck_T arg1_string_or_nr[] = {arg_string_or_nr};
Ernie Raela8f7f922023-12-14 20:17:04 +01001113static argcheck_T arg2_any_buffer[] = {arg_any, arg_buffer};
1114static argcheck_T arg2_buffer_any[] = {arg_buffer, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001115static argcheck_T arg2_buffer_bool[] = {arg_buffer, arg_bool};
1116static argcheck_T arg2_buffer_list_any[] = {arg_buffer, arg_list_any};
1117static argcheck_T arg2_buffer_lnum[] = {arg_buffer, arg_lnum};
1118static argcheck_T arg2_buffer_number[] = {arg_buffer, arg_number};
1119static argcheck_T arg2_buffer_string[] = {arg_buffer, arg_string};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001120static argcheck_T arg2_chan_or_job_dict[] = {arg_chan_or_job, arg_dict_any};
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001121static argcheck_T arg2_chan_or_job_string[] = {arg_chan_or_job, arg_string};
Yegappan Lakshmananccfb7c62021-08-16 21:39:09 +02001122static argcheck_T arg2_dict_any_list_any[] = {arg_dict_any, arg_list_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001123static argcheck_T arg2_dict_any_string_or_nr[] = {arg_dict_any, arg_string_or_nr};
1124static argcheck_T arg2_dict_string[] = {arg_dict_any, arg_string};
1125static argcheck_T arg2_float_or_nr[] = {arg_float_or_nr, arg_float_or_nr};
1126static argcheck_T arg2_job_dict[] = {arg_job, arg_dict_any};
1127static argcheck_T arg2_job_string_or_number[] = {arg_job, arg_string_or_nr};
1128static argcheck_T arg2_list_any_number[] = {arg_list_any, arg_number};
1129static argcheck_T arg2_list_any_string[] = {arg_list_any, arg_string};
1130static argcheck_T arg2_list_number[] = {arg_list_number, arg_list_number};
1131static argcheck_T arg2_list_number_bool[] = {arg_list_number, arg_bool};
Bram Moolenaarfa103972022-09-29 19:14:42 +01001132static argcheck_T arg2_listblobmod_item[] = {arg_list_or_blob_mod, arg_item_of_prev};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001133static argcheck_T arg2_lnum[] = {arg_lnum, arg_lnum};
1134static argcheck_T arg2_lnum_number[] = {arg_lnum, arg_number};
1135static argcheck_T arg2_number[] = {arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001136static argcheck_T arg2_number_any[] = {arg_number, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001137static argcheck_T arg2_number_bool[] = {arg_number, arg_bool};
1138static argcheck_T arg2_number_dict_any[] = {arg_number, arg_dict_any};
1139static argcheck_T arg2_number_list[] = {arg_number, arg_list_any};
1140static argcheck_T arg2_number_string[] = {arg_number, arg_string};
Christian Brabandtfbc37f12024-06-18 20:50:58 +02001141static argcheck_T arg2_number_buffer[] = {arg_number, arg_buffer};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001142static argcheck_T arg2_number_string_or_list[] = {arg_number, arg_string_or_list_any};
1143static argcheck_T arg2_str_or_nr_or_list_dict[] = {arg_str_or_nr_or_list, arg_dict_any};
1144static argcheck_T arg2_string[] = {arg_string, arg_string};
Ernie Raela8f7f922023-12-14 20:17:04 +01001145static argcheck_T arg2_string_any[] = {arg_string, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001146static argcheck_T arg2_string_bool[] = {arg_string, arg_bool};
1147static argcheck_T arg2_string_chan_or_job[] = {arg_string, arg_chan_or_job};
1148static argcheck_T arg2_string_dict[] = {arg_string, arg_dict_any};
1149static argcheck_T arg2_string_list_number[] = {arg_string, arg_list_number};
1150static argcheck_T arg2_string_number[] = {arg_string, arg_number};
1151static argcheck_T arg2_string_or_list_dict[] = {arg_string_or_list_any, arg_dict_any};
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00001152static argcheck_T arg2_string_or_list_number[] = {arg_string_or_list_any, arg_number};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001153static argcheck_T arg2_string_string_or_number[] = {arg_string, arg_string_or_nr};
Yegappan Lakshmanan1aefe1d2025-01-14 17:29:42 +01001154static argcheck_T arg2_blob_dict[] = {arg_blob, arg_dict_any};
Ernie Raela8f7f922023-12-14 20:17:04 +01001155static argcheck_T arg3_any_list_dict[] = {arg_any, arg_list_any, arg_dict_any};
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001156static argcheck_T arg3_buffer_lnum_lnum[] = {arg_buffer, arg_lnum, arg_lnum};
1157static argcheck_T arg3_buffer_number_number[] = {arg_buffer, arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001158static argcheck_T arg3_buffer_string_any[] = {arg_buffer, arg_string, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001159static argcheck_T arg3_buffer_string_dict[] = {arg_buffer, arg_string, arg_dict_any};
1160static argcheck_T arg3_dict_number_number[] = {arg_dict_any, arg_number, arg_number};
Yegappan Lakshmananfa378352024-02-01 22:05:27 +01001161static argcheck_T arg3_diff[] = {arg_list_string, arg_list_string, arg_dict_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001162static argcheck_T arg3_list_string_dict[] = {arg_list_any, arg_string, arg_dict_any};
Shougo Matsushita19b71882024-02-28 22:48:12 +01001163static argcheck_T arg3_list_list_dict[] = {arg_list_any, arg_list_any, arg_dict_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001164static argcheck_T arg3_lnum_number_bool[] = {arg_lnum, arg_number, arg_bool};
1165static argcheck_T arg3_number[] = {arg_number, arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001166static argcheck_T arg3_number_any_dict[] = {arg_number, arg_any, arg_dict_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001167static argcheck_T arg3_number_number_dict[] = {arg_number, arg_number, arg_dict_any};
Ernie Raela8f7f922023-12-14 20:17:04 +01001168static argcheck_T arg3_number_string_any[] = {arg_number, arg_string, arg_any};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001169static argcheck_T arg3_number_string_buffer[] = {arg_number, arg_string, arg_buffer};
1170static argcheck_T arg3_number_string_string[] = {arg_number, arg_string, arg_string};
1171static argcheck_T arg3_string[] = {arg_string, arg_string, arg_string};
Ernie Raela8f7f922023-12-14 20:17:04 +01001172static argcheck_T arg3_string_any_dict[] = {arg_string, arg_any, arg_dict_any};
1173static argcheck_T arg3_string_any_string[] = {arg_string, arg_any, arg_string};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001174static argcheck_T arg3_string_bool_bool[] = {arg_string, arg_bool, arg_bool};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001175static argcheck_T arg3_string_number_bool[] = {arg_string, arg_number, arg_bool};
K.Takata11df3ae2022-10-19 14:02:40 +01001176static argcheck_T arg3_string_number_number[] = {arg_string, arg_number, arg_number};
Ernie Rael51d04d12022-05-04 15:40:22 +01001177static argcheck_T arg3_string_or_dict_bool_dict[] = {arg_string_or_dict_any, arg_bool, arg_dict_any};
zeertzjq825cf812023-08-17 22:55:25 +02001178static argcheck_T arg3_string_or_list_bool_number[] = {arg_string_or_list_any, arg_bool, arg_number};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001179static argcheck_T arg3_string_string_bool[] = {arg_string, arg_string, arg_bool};
1180static argcheck_T arg3_string_string_dict[] = {arg_string, arg_string, arg_dict_any};
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02001181static argcheck_T arg3_string_string_number[] = {arg_string, arg_string, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001182static argcheck_T arg4_number_number_string_any[] = {arg_number, arg_number, arg_string, arg_any};
1183static argcheck_T arg4_string_string_any_string[] = {arg_string, arg_string, arg_any, arg_string};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001184static argcheck_T arg4_string_string_number_string[] = {arg_string, arg_string, arg_number, arg_string};
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01001185static argcheck_T arg4_string_number_bool_bool[] = {arg_string, arg_number, arg_bool, arg_bool};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001186/* Function specific argument types (not covered by the above) */
Ernie Raela8f7f922023-12-14 20:17:04 +01001187static 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 +02001188static 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 +02001189static argcheck_T arg4_browse[] = {arg_bool, arg_string, arg_string, arg_string};
Ernie Raela8f7f922023-12-14 20:17:04 +01001190static argcheck_T arg23_chanexpr[] = {arg_chan_or_job, arg_any, arg_dict_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001191static argcheck_T arg23_chanraw[] = {arg_chan_or_job, arg_string_or_blob, arg_dict_any};
Ernie Raela8f7f922023-12-14 20:17:04 +01001192static argcheck_T arg24_count[] = {arg_string_or_list_or_dict, arg_any, arg_bool, arg_number};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001193static argcheck_T arg13_cursor[] = {arg_cursor1, arg_number, arg_number};
Ernie Raela8f7f922023-12-14 20:17:04 +01001194static argcheck_T arg12_deepcopy[] = {arg_any, arg_bool};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001195static argcheck_T arg12_execute[] = {arg_string_or_list_string, arg_string};
Bram Moolenaarfa103972022-09-29 19:14:42 +01001196static argcheck_T arg23_extend[] = {arg_list_or_dict_mod, arg_same_as_prev, arg_extend3};
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001197static argcheck_T arg23_extendnew[] = {arg_list_or_dict, arg_same_struct_as_prev, arg_extend3};
Ernie Raela8f7f922023-12-14 20:17:04 +01001198static argcheck_T arg23_get[] = {arg_get1, arg_string_or_nr, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001199static argcheck_T arg14_glob[] = {arg_string, arg_bool, arg_bool, arg_bool};
1200static argcheck_T arg25_globpath[] = {arg_string, arg_string, arg_bool, arg_bool, arg_bool};
1201static argcheck_T arg24_index[] = {arg_list_or_blob, arg_item_of_prev, arg_number, arg_bool};
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01001202static argcheck_T arg23_index[] = {arg_list_or_blob, arg_filter_func, arg_dict_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001203static argcheck_T arg23_insert[] = {arg_list_or_blob, arg_item_of_prev, arg_number};
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001204static argcheck_T arg1_len[] = {arg_len1};
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001205static argcheck_T arg3_libcall[] = {arg_string, arg_string, arg_string_or_nr};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001206static argcheck_T arg14_maparg[] = {arg_string, arg_string, arg_bool, arg_bool};
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001207static argcheck_T arg2_filter[] = {arg_list_or_dict_or_blob_or_string_mod, arg_filter_func};
Ernie Raele79e2072024-01-13 11:47:33 +01001208static argcheck_T arg2_foreach[] = {arg_list_or_dict_or_blob_or_string, arg_foreach_func};
Ernie Rael2025af12023-12-12 16:58:00 +01001209static argcheck_T arg2_instanceof[] = {arg_object, varargs_class, NULL };
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001210static argcheck_T arg2_map[] = {arg_list_or_dict_or_blob_or_string_mod, arg_map_func};
Ernie Raela8f7f922023-12-14 20:17:04 +01001211static argcheck_T arg2_mapnew[] = {arg_list_or_dict_or_blob_or_string, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001212static argcheck_T arg25_matchadd[] = {arg_string, arg_string, arg_number, arg_number, arg_dict_any};
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001213static argcheck_T arg25_matchaddpos[] = {arg_string, arg_list_any, arg_number, arg_number, arg_dict_any};
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01001214static argcheck_T arg23_matchstrlist[] = {arg_list_string, arg_string, arg_dict_any};
1215static argcheck_T arg45_matchbufline[] = {arg_buffer, arg_string, arg_lnum, arg_lnum, arg_dict_any};
Ernie Raela8f7f922023-12-14 20:17:04 +01001216static 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};
1217static argcheck_T arg23_reduce[] = {arg_string_list_or_blob, arg_any, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001218static argcheck_T arg24_remote_expr[] = {arg_string, arg_string, arg_string, arg_number};
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001219static argcheck_T arg23_remove[] = {arg_list_or_dict_or_blob_mod, arg_remove2, arg_number};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001220static argcheck_T arg2_repeat[] = {arg_repeat1, arg_number};
Bram Moolenaar73199812021-12-26 17:18:14 +00001221static argcheck_T arg15_search[] = {arg_string, arg_string, arg_number, arg_number, arg_string_or_func};
1222static 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 +02001223static argcheck_T arg3_setbufline[] = {arg_buffer, arg_lnum, arg_str_or_nr_or_list};
Ernie Raela8f7f922023-12-14 20:17:04 +01001224static argcheck_T arg2_setline[] = {arg_lnum, arg_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001225static argcheck_T arg24_setloclist[] = {arg_number, arg_list_any, arg_string, arg_dict_any};
1226static argcheck_T arg13_setqflist[] = {arg_list_any, arg_string, arg_dict_any};
1227static argcheck_T arg23_settagstack[] = {arg_number, arg_dict_any, arg_string};
1228static argcheck_T arg02_sign_getplaced[] = {arg_buffer, arg_dict_any};
1229static argcheck_T arg45_sign_place[] = {arg_number, arg_string, arg_string, arg_buffer, arg_dict_any};
1230static argcheck_T arg23_slice[] = {arg_slice1, arg_number, arg_number};
Bram Moolenaara5d1a672022-09-30 17:57:47 +01001231static argcheck_T arg13_sortuniq[] = {arg_list_any_mod, arg_sort_how, arg_dict_any};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001232static argcheck_T arg24_strpart[] = {arg_string, arg_number, arg_number, arg_bool};
1233static argcheck_T arg12_system[] = {arg_string, arg_str_or_nr_or_list};
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02001234static argcheck_T arg23_win_execute[] = {arg_number, arg_string_or_list_string, arg_string};
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001235static argcheck_T arg23_writefile[] = {arg_list_or_blob, arg_string, arg_string};
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02001236static argcheck_T arg24_match_func[] = {arg_string_or_list_any, arg_string, arg_number, arg_number};
Bram Moolenaarcd268012021-07-22 19:11:08 +02001237
Bram Moolenaar32517c42023-01-15 18:17:12 +00001238// Can be used by functions called through "f_retfunc" to create new types.
1239static garray_T *current_type_gap = NULL;
Bram Moolenaar94738d82020-10-21 14:25:07 +02001240
1241/*
1242 * Functions that return the return type of a builtin function.
Bram Moolenaara1224cb2020-10-22 12:31:49 +02001243 * Note that "argtypes" is NULL if "argcount" is zero.
Bram Moolenaar94738d82020-10-21 14:25:07 +02001244 */
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001245 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001246ret_void(int argcount UNUSED,
1247 type2_T *argtypes UNUSED,
1248 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001249{
1250 return &t_void;
1251}
1252 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001253ret_any(int argcount UNUSED,
1254 type2_T *argtypes UNUSED,
1255 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001256{
1257 return &t_any;
1258}
1259 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001260ret_bool(int argcount UNUSED,
1261 type2_T *argtypes UNUSED,
1262 type_T **decl_type UNUSED)
Bram Moolenaar403dc312020-10-17 19:29:51 +02001263{
1264 return &t_bool;
1265}
1266 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001267ret_number_bool(int argcount UNUSED,
1268 type2_T *argtypes UNUSED,
1269 type_T **decl_type UNUSED)
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001270{
1271 return &t_number_bool;
1272}
1273 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001274ret_number(int argcount UNUSED,
1275 type2_T *argtypes UNUSED,
1276 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001277{
1278 return &t_number;
1279}
1280 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001281ret_float(int argcount UNUSED,
1282 type2_T *argtypes UNUSED,
1283 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001284{
1285 return &t_float;
1286}
1287 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001288ret_string(int argcount UNUSED,
1289 type2_T *argtypes UNUSED,
1290 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001291{
1292 return &t_string;
1293}
Bram Moolenaare69f6d02020-04-01 22:11:01 +02001294 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001295ret_list_any(int argcount UNUSED,
1296 type2_T *argtypes UNUSED,
1297 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001298{
1299 return &t_list_any;
1300}
1301 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001302ret_list_number(int argcount UNUSED,
1303 type2_T *argtypes UNUSED,
Bram Moolenaar81330182022-02-01 12:11:58 +00001304 type_T **decl_type)
1305{
Bram Moolenaar81330182022-02-01 12:11:58 +00001306 *decl_type = &t_list_any;
1307 return &t_list_number;
1308}
1309 static type_T *
1310ret_list_string(int argcount UNUSED,
1311 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001312 type_T **decl_type)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001313{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001314 *decl_type = &t_list_any;
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001315 return &t_list_string;
1316}
1317 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001318ret_list_dict_any(int argcount UNUSED,
1319 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001320 type_T **decl_type)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001321{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001322 *decl_type = &t_list_any;
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001323 return &t_list_dict_any;
1324}
1325 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001326ret_list_items(int argcount UNUSED,
1327 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001328 type_T **decl_type)
Bram Moolenaarefc5db52021-07-07 21:21:30 +02001329{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001330 *decl_type = &t_list_any;
Bram Moolenaarefc5db52021-07-07 21:21:30 +02001331 return &t_list_list_any;
1332}
mityu61065042021-07-19 20:07:21 +02001333 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001334ret_list_string_items(int argcount UNUSED,
1335 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001336 type_T **decl_type)
mityu61065042021-07-19 20:07:21 +02001337{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001338 *decl_type = &t_list_any;
mityu61065042021-07-19 20:07:21 +02001339 return &t_list_list_string;
1340}
Bram Moolenaarefc5db52021-07-07 21:21:30 +02001341 static type_T *
zeertzjqd4d12072024-07-16 20:34:16 +02001342ret_list_regionpos(int argcount UNUSED,
1343 type2_T *argtypes UNUSED,
1344 type_T **decl_type)
1345{
1346 *decl_type = &t_list_any;
1347 return &t_list_list_list_number;
1348}
1349 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001350ret_dict_any(int argcount UNUSED,
1351 type2_T *argtypes UNUSED,
1352 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001353{
1354 return &t_dict_any;
1355}
1356 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001357ret_job_info(int argcount,
1358 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001359 type_T **decl_type)
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01001360{
1361 if (argcount == 0)
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001362 {
1363 *decl_type = &t_list_any;
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01001364 return &t_list_job;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001365 }
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01001366 return &t_dict_any;
1367}
1368 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001369ret_dict_number(int argcount UNUSED,
1370 type2_T *argtypes UNUSED,
1371 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001372{
1373 return &t_dict_number;
1374}
1375 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001376ret_dict_string(int argcount UNUSED,
1377 type2_T *argtypes UNUSED,
1378 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001379{
1380 return &t_dict_string;
1381}
1382 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001383ret_blob(int argcount UNUSED,
1384 type2_T *argtypes UNUSED,
1385 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001386{
1387 return &t_blob;
1388}
1389 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001390ret_func_any(int argcount UNUSED,
1391 type2_T *argtypes UNUSED,
1392 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001393{
Bram Moolenaare69f6d02020-04-01 22:11:01 +02001394 return &t_func_any;
1395}
1396 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001397ret_func_unknown(int argcount UNUSED,
1398 type2_T *argtypes UNUSED,
1399 type_T **decl_type UNUSED)
Bram Moolenaar2f9f4cc2021-12-20 09:36:27 +00001400{
1401 return &t_func_unknown;
1402}
1403 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001404ret_channel(int argcount UNUSED,
1405 type2_T *argtypes UNUSED,
1406 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001407{
1408 return &t_channel;
1409}
1410 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001411ret_job(int argcount UNUSED,
1412 type2_T *argtypes UNUSED,
1413 type_T **decl_type UNUSED)
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001414{
1415 return &t_job;
1416}
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001417 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001418ret_first_arg(int argcount,
1419 type2_T *argtypes,
1420 type_T **decl_type)
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001421{
1422 if (argcount > 0)
Bram Moolenaar81330182022-02-01 12:11:58 +00001423 {
1424 *decl_type = argtypes[0].type_decl;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001425 return argtypes[0].type_curr;
Bram Moolenaar81330182022-02-01 12:11:58 +00001426 }
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001427 return &t_void;
1428}
Bram Moolenaar1780f082021-07-31 22:03:59 +02001429 static type_T *
Bram Moolenaar00eb9952022-02-05 19:23:18 +00001430ret_slice(int argcount,
1431 type2_T *argtypes,
1432 type_T **decl_type)
1433{
1434 if (argcount > 0)
1435 {
1436 if (argtypes[0].type_decl != NULL)
1437 {
1438 switch (argtypes[0].type_decl->tt_type)
1439 {
1440 case VAR_STRING: *decl_type = &t_string; break;
1441 case VAR_BLOB: *decl_type = &t_blob; break;
1442 case VAR_LIST: *decl_type = &t_list_any; break;
1443 default: break;
1444 }
1445 }
1446 return argtypes[0].type_curr;
1447 }
1448 return &t_void;
1449}
1450 static type_T *
Bram Moolenaar381692b2022-02-02 20:01:27 +00001451ret_copy(int argcount,
1452 type2_T *argtypes,
1453 type_T **decl_type)
1454{
1455 if (argcount > 0)
1456 {
1457 if (argtypes[0].type_decl != NULL)
1458 {
1459 if (argtypes[0].type_decl->tt_type == VAR_LIST)
1460 *decl_type = &t_list_any;
1461 else if (argtypes[0].type_decl->tt_type == VAR_DICT)
1462 *decl_type = &t_dict_any;
1463 else
1464 *decl_type = argtypes[0].type_decl;
1465 }
1466 if (argtypes[0].type_curr != NULL)
1467 {
1468 if (argtypes[0].type_curr->tt_type == VAR_LIST)
1469 return &t_list_any;
1470 else if (argtypes[0].type_curr->tt_type == VAR_DICT)
1471 return &t_dict_any;
1472 }
1473 return argtypes[0].type_curr;
1474 }
1475 return &t_void;
1476}
1477 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001478ret_extend(int argcount,
1479 type2_T *argtypes,
1480 type_T **decl_type)
1481{
1482 if (argcount > 0)
1483 {
1484 *decl_type = argtypes[0].type_decl;
1485 // if the second argument has a different current type then the current
1486 // type is "any"
1487 if (argcount > 1 && !equal_type(argtypes[0].type_curr,
1488 argtypes[1].type_curr, 0))
1489 {
1490 if (argtypes[0].type_curr->tt_type == VAR_LIST)
1491 return &t_list_any;
1492 if (argtypes[0].type_curr->tt_type == VAR_DICT)
1493 return &t_dict_any;
1494 }
1495 return argtypes[0].type_curr;
1496 }
1497 return &t_void;
1498}
1499 static type_T *
1500ret_repeat(int argcount,
1501 type2_T *argtypes,
1502 type_T **decl_type UNUSED)
Bram Moolenaar1780f082021-07-31 22:03:59 +02001503{
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001504 if (argcount == 0)
1505 return &t_any;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001506 if (argtypes[0].type_curr == &t_number)
Bram Moolenaar1780f082021-07-31 22:03:59 +02001507 return &t_string;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001508 return argtypes[0].type_curr;
Bram Moolenaar1780f082021-07-31 22:03:59 +02001509}
Bram Moolenaarea696852020-11-09 18:31:39 +01001510// for map(): returns first argument but item type may differ
1511 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001512ret_first_cont(int argcount,
1513 type2_T *argtypes,
1514 type_T **decl_type UNUSED)
Bram Moolenaarea696852020-11-09 18:31:39 +01001515{
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001516 if (argcount > 0)
1517 {
Bram Moolenaar078a4612022-01-04 15:17:03 +00001518 if (argtypes[0].type_curr->tt_type == VAR_LIST)
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001519 return &t_list_any;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001520 if (argtypes[0].type_curr->tt_type == VAR_DICT)
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001521 return &t_dict_any;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001522 if (argtypes[0].type_curr->tt_type == VAR_BLOB)
1523 return argtypes[0].type_curr;
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001524 }
Bram Moolenaarea696852020-11-09 18:31:39 +01001525 return &t_any;
1526}
Bram Moolenaar078a4612022-01-04 15:17:03 +00001527// for getline()
1528 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001529ret_getline(int argcount,
1530 type2_T *argtypes UNUSED,
1531 type_T **decl_type UNUSED)
Bram Moolenaar078a4612022-01-04 15:17:03 +00001532{
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001533 if (argcount == 1)
1534 return &t_string;
1535 *decl_type = &t_list_any;
1536 return &t_list_string;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001537}
Bram Moolenaar08018222021-12-22 18:45:37 +00001538// for finddir()
1539 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001540ret_finddir(int argcount,
1541 type2_T *argtypes UNUSED,
1542 type_T **decl_type UNUSED)
Bram Moolenaar08018222021-12-22 18:45:37 +00001543{
1544 if (argcount < 3)
1545 return &t_string;
1546 // Depending on the count would be a string or a list of strings.
1547 return &t_any;
1548}
Bram Moolenaar32517c42023-01-15 18:17:12 +00001549// for values(): list of member of first argument
1550 static type_T *
1551ret_list_member(int argcount,
1552 type2_T *argtypes,
1553 type_T **decl_type)
1554{
1555 if (argcount > 0)
1556 {
1557 type_T *t = argtypes[0].type_decl;
1558 if (current_type_gap != NULL
1559 && (t->tt_type == VAR_DICT || t->tt_type == VAR_LIST))
1560 t = get_list_type(t->tt_member, current_type_gap);
1561 else
1562 t = &t_list_any;
1563 *decl_type = t;
1564
1565 t = argtypes[0].type_curr;
1566 if (current_type_gap != NULL
1567 && (t->tt_type == VAR_DICT || t->tt_type == VAR_LIST))
1568 return get_list_type(t->tt_member, current_type_gap);
1569 }
1570 return &t_list_any;
1571}
Bram Moolenaar865af6b2020-06-18 18:45:49 +02001572
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001573/*
1574 * Used for getqflist(): returns list if there is no argument, dict if there is
1575 * one.
1576 */
1577 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001578ret_list_or_dict_0(int argcount,
1579 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001580 type_T **decl_type)
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001581{
1582 if (argcount > 0)
1583 return &t_dict_any;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001584 *decl_type = &t_list_any;
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001585 return &t_list_dict_any;
1586}
1587
1588/*
1589 * Used for getloclist(): returns list if there is one argument, dict if there
1590 * are two.
1591 */
1592 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001593ret_list_or_dict_1(int argcount,
1594 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001595 type_T **decl_type)
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001596{
1597 if (argcount > 1)
1598 return &t_dict_any;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001599 *decl_type = &t_list_any;
Bram Moolenaarf151ad12020-06-30 13:38:01 +02001600 return &t_list_dict_any;
1601}
1602
Bram Moolenaar846178a2020-07-05 17:04:13 +02001603 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001604ret_argv(int argcount,
1605 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001606 type_T **decl_type)
Bram Moolenaar846178a2020-07-05 17:04:13 +02001607{
1608 // argv() returns list of strings
1609 if (argcount == 0)
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001610 {
1611 *decl_type = &t_list_any;
Bram Moolenaar846178a2020-07-05 17:04:13 +02001612 return &t_list_string;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001613 }
Bram Moolenaar846178a2020-07-05 17:04:13 +02001614
1615 // argv(0) returns a string, but argv(-1] returns a list
1616 return &t_any;
1617}
1618
Bram Moolenaarad7c2492020-07-05 20:55:29 +02001619 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001620ret_remove(int argcount,
1621 type2_T *argtypes,
Bram Moolenaar2ac037f2022-05-09 14:12:14 +01001622 type_T **decl_type)
Bram Moolenaarad7c2492020-07-05 20:55:29 +02001623{
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02001624 if (argcount > 0)
Bram Moolenaar5e654232020-09-16 15:22:00 +02001625 {
Bram Moolenaar078a4612022-01-04 15:17:03 +00001626 if (argtypes[0].type_curr->tt_type == VAR_LIST
1627 || argtypes[0].type_curr->tt_type == VAR_DICT)
Bram Moolenaar81330182022-02-01 12:11:58 +00001628 {
Bram Moolenaar2ac037f2022-05-09 14:12:14 +01001629 if (argcount == 3)
1630 {
1631 *decl_type = argtypes[0].type_decl;
1632 return argtypes[0].type_curr;
1633 }
Bram Moolenaar81330182022-02-01 12:11:58 +00001634 if (argtypes[0].type_curr->tt_type
1635 == argtypes[0].type_decl->tt_type)
1636 *decl_type = argtypes[0].type_decl->tt_member;
Bram Moolenaar078a4612022-01-04 15:17:03 +00001637 return argtypes[0].type_curr->tt_member;
Bram Moolenaar81330182022-02-01 12:11:58 +00001638 }
Bram Moolenaar078a4612022-01-04 15:17:03 +00001639 if (argtypes[0].type_curr->tt_type == VAR_BLOB)
Bram Moolenaar5e654232020-09-16 15:22:00 +02001640 return &t_number;
1641 }
Bram Moolenaarad7c2492020-07-05 20:55:29 +02001642 return &t_any;
1643}
1644
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001645 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001646ret_getreg(int argcount,
1647 type2_T *argtypes UNUSED,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001648 type_T **decl_type)
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001649{
1650 // Assume that if the third argument is passed it's non-zero
1651 if (argcount == 3)
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001652 {
1653 *decl_type = &t_list_any;
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001654 return &t_list_string;
Bram Moolenaar82e46e52022-02-05 18:12:34 +00001655 }
Bram Moolenaar3d945cc2020-08-06 21:26:59 +02001656 return &t_string;
1657}
1658
Bram Moolenaar4a6d1b62020-08-08 17:55:49 +02001659 static type_T *
LemonBoy0f7a3e12022-05-26 12:10:37 +01001660ret_virtcol(int argcount,
1661 type2_T *argtypes UNUSED,
1662 type_T **decl_type)
1663{
1664 // Assume that if the second argument is passed it's non-zero
zeertzjq825cf812023-08-17 22:55:25 +02001665 if (argcount > 1)
LemonBoy0f7a3e12022-05-26 12:10:37 +01001666 {
1667 *decl_type = &t_list_any;
1668 return &t_list_number;
1669 }
1670 return &t_number;
1671}
1672
1673 static type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00001674ret_maparg(int argcount,
1675 type2_T *argtypes UNUSED,
1676 type_T **decl_type UNUSED)
Bram Moolenaar4a6d1b62020-08-08 17:55:49 +02001677{
1678 // Assume that if the fourth argument is passed it's non-zero
1679 if (argcount == 4)
1680 return &t_dict_any;
1681 return &t_string;
1682}
1683
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001684/*
1685 * Array with names and number of arguments of all internal functions
1686 * MUST BE KEPT SORTED IN strcmp() ORDER FOR BINARY SEARCH!
Ernie Rael2025af12023-12-12 16:58:00 +01001687 *
Ernie Raela8f7f922023-12-14 20:17:04 +01001688 * The builtin function may be varargs. In that case
Ernie Rael2025af12023-12-12 16:58:00 +01001689 * - f_max_argc == VARGS
Ernie Raela8f7f922023-12-14 20:17:04 +01001690 * - For varargs, f_argcheck must be NULL terminated. The last non-null
1691 * entry in f_argcheck should validate all the remaining args.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001692 */
Bram Moolenaarac92e252019-08-03 21:58:38 +02001693typedef struct
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001694{
Bram Moolenaar25e42232019-08-04 15:04:10 +02001695 char *f_name; // function name
1696 char f_min_argc; // minimal number of arguments
1697 char f_max_argc; // maximal number of arguments
Ernie Raeld8bf87c2023-12-16 14:03:33 +01001698 char f_argtype; // for method: FEARG_ values; bits FE_
Ernie Raela8f7f922023-12-14 20:17:04 +01001699 argcheck_T *f_argcheck; // list of functions to check argument types;
1700 // use "arg_any" (not NULL) to accept an
1701 // argument of any type
Bram Moolenaar81330182022-02-01 12:11:58 +00001702 type_T *(*f_retfunc)(int argcount, type2_T *argtypes,
1703 type_T **decl_type);
Bram Moolenaarfbdd08e2020-03-01 14:04:46 +01001704 // return type function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001705 void (*f_func)(typval_T *args, typval_T *rvar);
Bram Moolenaar25e42232019-08-04 15:04:10 +02001706 // implementation of function
Bram Moolenaarac92e252019-08-03 21:58:38 +02001707} funcentry_T;
1708
Ernie Rael2025af12023-12-12 16:58:00 +01001709// Set f_max_argc to VARGS for varargs.
1710#define VARGS CHAR_MAX
1711
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02001712// values for f_argtype; zero means it cannot be used as a method
Ernie Raeld8bf87c2023-12-16 14:03:33 +01001713#define FEARG_1 0x01 // base is the first argument
1714#define FEARG_2 0x02 // base is the second argument
1715#define FEARG_3 0x03 // base is the third argument
1716#define FEARG_4 0x04 // base is the fourth argument
1717#define FEARG_MASK 0x0F // bits in f_argtype used as argument index
1718#define FE_X 0x10 // builtin accepts a non-value (class, typealias)
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02001719
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001720#if defined(HAVE_MATH_H)
Bram Moolenaar15c47602020-03-26 22:16:48 +01001721# define MATH_FUNC(name) name
1722#else
1723# define MATH_FUNC(name) NULL
1724#endif
1725#ifdef FEAT_TIMERS
1726# define TIMER_FUNC(name) name
1727#else
1728# define TIMER_FUNC(name) NULL
1729#endif
1730#ifdef FEAT_JOB_CHANNEL
1731# define JOB_FUNC(name) name
1732#else
1733# define JOB_FUNC(name) NULL
1734#endif
1735#ifdef FEAT_PROP_POPUP
1736# define PROP_FUNC(name) name
1737#else
1738# define PROP_FUNC(name) NULL
1739#endif
1740#ifdef FEAT_SIGNS
1741# define SIGN_FUNC(name) name
1742#else
1743# define SIGN_FUNC(name) NULL
1744#endif
1745#ifdef FEAT_SOUND
1746# define SOUND_FUNC(name) name
1747#else
1748# define SOUND_FUNC(name) NULL
1749#endif
1750#ifdef FEAT_TERMINAL
1751# define TERM_FUNC(name) name
1752#else
1753# define TERM_FUNC(name) NULL
1754#endif
1755
Bram Moolenaarac92e252019-08-03 21:58:38 +02001756static funcentry_T global_functions[] =
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02001757{
Bram Moolenaar94738d82020-10-21 14:25:07 +02001758 {"abs", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001759 ret_any, f_abs},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001760 {"acos", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001761 ret_float, f_acos},
Bram Moolenaarfa103972022-09-29 19:14:42 +01001762 {"add", 2, 2, FEARG_1, arg2_listblobmod_item,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001763 ret_first_arg, f_add},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001764 {"and", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001765 ret_number, f_and},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001766 {"append", 2, 2, FEARG_2, arg2_setline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001767 ret_number_bool, f_append},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001768 {"appendbufline", 3, 3, FEARG_3, arg3_setbufline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001769 ret_number_bool, f_appendbufline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001770 {"argc", 0, 1, 0, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001771 ret_number, f_argc},
1772 {"argidx", 0, 0, 0, NULL,
1773 ret_number, f_argidx},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001774 {"arglistid", 0, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001775 ret_number, f_arglistid},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001776 {"argv", 0, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001777 ret_argv, f_argv},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001778 {"asin", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001779 ret_float, f_asin},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001780 {"assert_beeps", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001781 ret_number_bool, f_assert_beeps},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001782 {"assert_equal", 2, 3, FEARG_2, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001783 ret_number_bool, f_assert_equal},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001784 {"assert_equalfile", 2, 3, FEARG_1, arg3_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001785 ret_number_bool, f_assert_equalfile},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001786 {"assert_exception", 1, 2, 0, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001787 ret_number_bool, f_assert_exception},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001788 {"assert_fails", 1, 5, FEARG_1, arg15_assert_fails,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001789 ret_number_bool, f_assert_fails},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001790 {"assert_false", 1, 2, FEARG_1, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001791 ret_number_bool, f_assert_false},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02001792 {"assert_inrange", 3, 4, FEARG_3, arg34_assert_inrange,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001793 ret_number_bool, f_assert_inrange},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001794 {"assert_match", 2, 3, FEARG_2, arg3_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001795 ret_number_bool, f_assert_match},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001796 {"assert_nobeep", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar5b8cabf2021-04-02 18:55:57 +02001797 ret_number_bool, f_assert_nobeep},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001798 {"assert_notequal", 2, 3, FEARG_2, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001799 ret_number_bool, f_assert_notequal},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001800 {"assert_notmatch", 2, 3, FEARG_2, arg3_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001801 ret_number_bool, f_assert_notmatch},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02001802 {"assert_report", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001803 ret_number_bool, f_assert_report},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001804 {"assert_true", 1, 2, FEARG_1, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001805 ret_number_bool, f_assert_true},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001806 {"atan", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001807 ret_float, f_atan},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001808 {"atan2", 2, 2, FEARG_1, arg2_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001809 ret_float, f_atan2},
Yegappan Lakshmanan1755a912022-05-19 10:31:47 +01001810 {"autocmd_add", 1, 1, FEARG_1, arg1_list_any,
1811 ret_number_bool, f_autocmd_add},
1812 {"autocmd_delete", 1, 1, FEARG_1, arg1_list_any,
1813 ret_number_bool, f_autocmd_delete},
1814 {"autocmd_get", 0, 1, FEARG_1, arg1_dict_any,
1815 ret_list_dict_any, f_autocmd_get},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001816 {"balloon_gettext", 0, 0, 0, NULL,
1817 ret_string,
Bram Moolenaar59716a22017-03-01 20:32:44 +01001818#ifdef FEAT_BEVAL
Bram Moolenaar15c47602020-03-26 22:16:48 +01001819 f_balloon_gettext
1820#else
1821 NULL
Bram Moolenaar59716a22017-03-01 20:32:44 +01001822#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01001823 },
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02001824 {"balloon_show", 1, 1, FEARG_1, arg1_string_or_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001825 ret_void,
Bram Moolenaar15c47602020-03-26 22:16:48 +01001826#ifdef FEAT_BEVAL
1827 f_balloon_show
1828#else
1829 NULL
1830#endif
1831 },
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001832 {"balloon_split", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001833 ret_list_string,
Bram Moolenaar15c47602020-03-26 22:16:48 +01001834#if defined(FEAT_BEVAL_TERM)
1835 f_balloon_split
1836#else
1837 NULL
1838#endif
1839 },
Yegappan Lakshmanan810785c2024-12-30 10:29:44 +01001840 {"base64_decode", 1, 1, FEARG_1, arg1_string,
1841 ret_blob, f_base64_decode},
1842 {"base64_encode", 1, 1, FEARG_1, arg1_blob,
1843 ret_string, f_base64_encode},
Christ van Willegence0ef912024-06-20 23:41:59 +02001844 {"bindtextdomain", 2, 2, 0, arg2_string,
Christ van Willegen8252ef12024-07-11 21:36:21 +02001845 ret_bool, f_bindtextdomain},
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +02001846 {"blob2list", 1, 1, FEARG_1, arg1_blob,
1847 ret_list_number, f_blob2list},
Yegappan Lakshmanan1aefe1d2025-01-14 17:29:42 +01001848 {"blob2str", 1, 2, FEARG_1, arg2_blob_dict,
1849 ret_string, f_blob2str},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001850 {"browse", 4, 4, 0, arg4_browse,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001851 ret_string, f_browse},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001852 {"browsedir", 2, 2, 0, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001853 ret_string, f_browsedir},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001854 {"bufadd", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001855 ret_number, f_bufadd},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001856 {"bufexists", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001857 ret_number_bool, f_bufexists},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001858 {"buffer_exists", 1, 1, FEARG_1, arg1_buffer, // obsolete
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001859 ret_number_bool, f_bufexists},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001860 {"buffer_name", 0, 1, FEARG_1, arg1_buffer, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02001861 ret_string, f_bufname},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001862 {"buffer_number", 0, 1, FEARG_1, arg1_buffer, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02001863 ret_number, f_bufnr},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001864 {"buflisted", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001865 ret_number_bool, f_buflisted},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001866 {"bufload", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001867 ret_void, f_bufload},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001868 {"bufloaded", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001869 ret_number_bool, f_bufloaded},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001870 {"bufname", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001871 ret_string, f_bufname},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001872 {"bufnr", 0, 2, FEARG_1, arg2_buffer_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001873 ret_number, f_bufnr},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001874 {"bufwinid", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001875 ret_number, f_bufwinid},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001876 {"bufwinnr", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001877 ret_number, f_bufwinnr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001878 {"byte2line", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001879 ret_number, f_byte2line},
Christian Brabandt67672ef2023-04-24 21:09:54 +01001880 {"byteidx", 2, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001881 ret_number, f_byteidx},
Christian Brabandt67672ef2023-04-24 21:09:54 +01001882 {"byteidxcomp", 2, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001883 ret_number, f_byteidxcomp},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02001884 {"call", 2, 3, FEARG_1, arg3_any_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001885 ret_any, f_call},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001886 {"ceil", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001887 ret_float, f_ceil},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001888 {"ch_canread", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001889 ret_number_bool, JOB_FUNC(f_ch_canread)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001890 {"ch_close", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001891 ret_void, JOB_FUNC(f_ch_close)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001892 {"ch_close_in", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001893 ret_void, JOB_FUNC(f_ch_close_in)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001894 {"ch_evalexpr", 2, 3, FEARG_1, arg23_chanexpr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001895 ret_any, JOB_FUNC(f_ch_evalexpr)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001896 {"ch_evalraw", 2, 3, FEARG_1, arg23_chanraw,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001897 ret_any, JOB_FUNC(f_ch_evalraw)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001898 {"ch_getbufnr", 2, 2, FEARG_1, arg2_chan_or_job_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001899 ret_number, JOB_FUNC(f_ch_getbufnr)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001900 {"ch_getjob", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001901 ret_job, JOB_FUNC(f_ch_getjob)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001902 {"ch_info", 1, 1, FEARG_1, arg1_chan_or_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001903 ret_dict_any, JOB_FUNC(f_ch_info)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001904 {"ch_log", 1, 2, FEARG_1, arg2_string_chan_or_job,
Bram Moolenaar4c5678f2022-11-30 18:12:19 +00001905 ret_void, f_ch_log},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001906 {"ch_logfile", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar4c5678f2022-11-30 18:12:19 +00001907 ret_void, f_ch_logfile},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001908 {"ch_open", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001909 ret_channel, JOB_FUNC(f_ch_open)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001910 {"ch_read", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001911 ret_string, JOB_FUNC(f_ch_read)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001912 {"ch_readblob", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001913 ret_blob, JOB_FUNC(f_ch_readblob)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001914 {"ch_readraw", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001915 ret_string, JOB_FUNC(f_ch_readraw)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001916 {"ch_sendexpr", 2, 3, FEARG_1, arg23_chanexpr,
Yegappan Lakshmanan3b470ae2022-04-16 10:41:27 +01001917 ret_any, JOB_FUNC(f_ch_sendexpr)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001918 {"ch_sendraw", 2, 3, FEARG_1, arg23_chanraw,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001919 ret_void, JOB_FUNC(f_ch_sendraw)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001920 {"ch_setoptions", 2, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001921 ret_void, JOB_FUNC(f_ch_setoptions)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001922 {"ch_status", 1, 2, FEARG_1, arg2_chan_or_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001923 ret_string, JOB_FUNC(f_ch_status)},
1924 {"changenr", 0, 0, 0, NULL,
1925 ret_number, f_changenr},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02001926 {"char2nr", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001927 ret_number, f_char2nr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001928 {"charclass", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001929 ret_number, f_charclass},
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00001930 {"charcol", 1, 2, FEARG_1, arg2_string_or_list_number,
Bram Moolenaar6f02b002021-01-10 20:22:54 +01001931 ret_number, f_charcol},
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01001932 {"charidx", 2, 4, FEARG_1, arg4_string_number_bool_bool,
Bram Moolenaar17793ef2020-12-28 12:56:58 +01001933 ret_number, f_charidx},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02001934 {"chdir", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001935 ret_string, f_chdir},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001936 {"cindent", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001937 ret_number, f_cindent},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001938 {"clearmatches", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001939 ret_void, f_clearmatches},
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00001940 {"col", 1, 2, FEARG_1, arg2_string_or_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001941 ret_number, f_col},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001942 {"complete", 2, 2, FEARG_2, arg2_number_list,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001943 ret_void, f_complete},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02001944 {"complete_add", 1, 1, FEARG_1, arg1_dict_or_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001945 ret_number, f_complete_add},
1946 {"complete_check", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001947 ret_number_bool, f_complete_check},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001948 {"complete_info", 0, 1, FEARG_1, arg1_list_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001949 ret_dict_any, f_complete_info},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001950 {"confirm", 1, 4, FEARG_1, arg4_string_string_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001951 ret_number, f_confirm},
1952 {"copy", 1, 1, FEARG_1, NULL,
Bram Moolenaar381692b2022-02-02 20:01:27 +00001953 ret_copy, f_copy},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001954 {"cos", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001955 ret_float, f_cos},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001956 {"cosh", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01001957 ret_float, f_cosh},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001958 {"count", 2, 4, FEARG_1, arg24_count,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001959 ret_number, f_count},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02001960 {"cscope_connection",0,3, 0, arg3_number_string_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001961 ret_number, f_cscope_connection},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001962 {"cursor", 1, 3, FEARG_1, arg13_cursor,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001963 ret_number, f_cursor},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02001964 {"debugbreak", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001965 ret_number,
Bram Moolenaar4f974752019-02-17 17:44:42 +01001966#ifdef MSWIN
Bram Moolenaar15c47602020-03-26 22:16:48 +01001967 f_debugbreak
1968#else
1969 NULL
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02001970#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01001971 },
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02001972 {"deepcopy", 1, 2, FEARG_1, arg12_deepcopy,
Bram Moolenaar381692b2022-02-02 20:01:27 +00001973 ret_copy, f_deepcopy},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02001974 {"delete", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001975 ret_number_bool, f_delete},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001976 {"deletebufline", 2, 3, FEARG_1, arg3_buffer_lnum_lnum,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001977 ret_number_bool, f_deletebufline},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001978 {"did_filetype", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001979 ret_number_bool, f_did_filetype},
Yegappan Lakshmananfa378352024-02-01 22:05:27 +01001980 {"diff", 2, 3, FEARG_1, arg3_diff,
Yegappan Lakshmanana0010a12024-02-12 20:21:26 +01001981 ret_any, f_diff},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001982 {"diff_filler", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001983 ret_number, f_diff_filler},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02001984 {"diff_hlID", 2, 2, FEARG_1, arg2_lnum_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02001985 ret_number, f_diff_hlID},
h-east29b85712021-07-26 21:54:04 +02001986 {"digraph_get", 1, 1, FEARG_1, arg1_string,
1987 ret_string, f_digraph_get},
zeertzjqd4d12072024-07-16 20:34:16 +02001988 {"digraph_getlist", 0, 1, FEARG_1, arg1_bool,
h-east29b85712021-07-26 21:54:04 +02001989 ret_list_string_items, f_digraph_getlist},
Yegappan Lakshmananfc3b7752021-09-08 14:57:42 +02001990 {"digraph_set", 2, 2, FEARG_1, arg2_string,
h-east29b85712021-07-26 21:54:04 +02001991 ret_bool, f_digraph_set},
zeertzjqd4d12072024-07-16 20:34:16 +02001992 {"digraph_setlist", 1, 1, FEARG_1, arg1_list_string,
h-east29b85712021-07-26 21:54:04 +02001993 ret_bool, f_digraph_setlist},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02001994 {"echoraw", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001995 ret_void, f_echoraw},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001996 {"empty", 1, 1, FEARG_1, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01001997 ret_number_bool, f_empty},
Bram Moolenaar94738d82020-10-21 14:25:07 +02001998 {"environ", 0, 0, 0, NULL,
1999 ret_dict_string, f_environ},
Bram Moolenaar80adaa82023-07-07 18:57:40 +01002000 {"err_teapot", 0, 1, 0, NULL,
2001 ret_number_bool, f_err_teapot},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002002 {"escape", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002003 ret_string, f_escape},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002004 {"eval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002005 ret_any, f_eval},
2006 {"eventhandler", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002007 ret_number_bool, f_eventhandler},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002008 {"executable", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002009 ret_number, f_executable},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002010 {"execute", 1, 2, FEARG_1, arg12_execute,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002011 ret_string, f_execute},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002012 {"exepath", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002013 ret_string, f_exepath},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002014 {"exists", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002015 ret_number_bool, f_exists},
Bram Moolenaar26735992021-08-08 14:43:22 +02002016 {"exists_compiled", 1, 1, FEARG_1, arg1_string,
2017 ret_number_bool, f_exists_compiled},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002018 {"exp", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002019 ret_float, f_exp},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002020 {"expand", 1, 3, FEARG_1, arg3_string_bool_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002021 ret_any, f_expand},
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01002022 {"expandcmd", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002023 ret_string, f_expandcmd},
Bram Moolenaarfbcbffe2020-10-31 19:33:38 +01002024 {"extend", 2, 3, FEARG_1, arg23_extend,
Bram Moolenaar81330182022-02-01 12:11:58 +00002025 ret_extend, f_extend},
Bram Moolenaarb0e6b512021-01-12 20:23:40 +01002026 {"extendnew", 2, 3, FEARG_1, arg23_extendnew,
2027 ret_first_cont, f_extendnew},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002028 {"feedkeys", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002029 ret_void, f_feedkeys},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002030 {"file_readable", 1, 1, FEARG_1, arg1_string, // obsolete
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002031 ret_number_bool, f_filereadable},
Shougo Matsushita60c87432024-06-03 22:59:27 +02002032 {"filecopy", 2, 2, FEARG_1, arg2_string,
2033 ret_number_bool, f_filecopy},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002034 {"filereadable", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002035 ret_number_bool, f_filereadable},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002036 {"filewritable", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002037 ret_number, f_filewritable},
Bram Moolenaar18024052021-12-25 21:43:28 +00002038 {"filter", 2, 2, FEARG_1, arg2_filter,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002039 ret_first_arg, f_filter},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002040 {"finddir", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar08018222021-12-22 18:45:37 +00002041 ret_finddir, f_finddir},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002042 {"findfile", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar10c83dd2021-09-04 14:49:56 +02002043 ret_any, f_findfile},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002044 {"flatten", 1, 2, FEARG_1, arg2_list_any_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002045 ret_list_any, f_flatten},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002046 {"flattennew", 1, 2, FEARG_1, arg2_list_any_number,
Bram Moolenaar3b690062021-02-01 20:14:51 +01002047 ret_list_any, f_flattennew},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002048 {"float2nr", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002049 ret_number, f_float2nr},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002050 {"floor", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002051 ret_float, f_floor},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002052 {"fmod", 2, 2, FEARG_1, arg2_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002053 ret_float, f_fmod},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002054 {"fnameescape", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002055 ret_string, f_fnameescape},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002056 {"fnamemodify", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002057 ret_string, f_fnamemodify},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002058 {"foldclosed", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002059 ret_number, f_foldclosed},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002060 {"foldclosedend", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002061 ret_number, f_foldclosedend},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002062 {"foldlevel", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002063 ret_number, f_foldlevel},
2064 {"foldtext", 0, 0, 0, NULL,
2065 ret_string, f_foldtext},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002066 {"foldtextresult", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002067 ret_string, f_foldtextresult},
Ernie Raele79e2072024-01-13 11:47:33 +01002068 {"foreach", 2, 2, FEARG_1, arg2_foreach,
2069 ret_first_arg, f_foreach},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002070 {"foreground", 0, 0, 0, NULL,
2071 ret_void, f_foreground},
Bram Moolenaardd44b582022-09-15 22:03:57 +01002072 {"fullcommand", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar038e09e2021-02-06 12:38:51 +01002073 ret_string, f_fullcommand},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002074 {"funcref", 1, 3, FEARG_1, arg3_any_list_dict,
Bram Moolenaar2f9f4cc2021-12-20 09:36:27 +00002075 ret_func_unknown, f_funcref},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002076 {"function", 1, 3, FEARG_1, arg3_any_list_dict,
Bram Moolenaar2f9f4cc2021-12-20 09:36:27 +00002077 ret_func_unknown, f_function},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002078 {"garbagecollect", 0, 1, 0, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002079 ret_void, f_garbagecollect},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002080 {"get", 2, 3, FEARG_1, arg23_get,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002081 ret_any, f_get},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002082 {"getbufinfo", 0, 1, FEARG_1, arg1_buffer_or_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002083 ret_list_dict_any, f_getbufinfo},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002084 {"getbufline", 2, 3, FEARG_1, arg3_buffer_lnum_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002085 ret_list_string, f_getbufline},
Bram Moolenaarce30ccc2022-11-21 19:57:04 +00002086 {"getbufoneline", 2, 2, FEARG_1, arg2_buffer_lnum,
2087 ret_string, f_getbufoneline},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002088 {"getbufvar", 2, 3, FEARG_1, arg3_buffer_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002089 ret_any, f_getbufvar},
mikoto20001083cae2024-11-11 21:24:14 +01002090 {"getcellpixels", 0, 0, 0, NULL,
mikoto2000a73dfc22024-11-18 21:12:21 +01002091 ret_list_any, f_getcellpixels},
Kota Kato66bb9ae2023-01-17 18:31:56 +00002092 {"getcellwidths", 0, 0, 0, NULL,
2093 ret_list_any, f_getcellwidths},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002094 {"getchangelist", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002095 ret_list_any, f_getchangelist},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002096 {"getchar", 0, 1, 0, arg1_bool,
Bram Moolenaar3a7503c2021-06-07 18:29:17 +02002097 ret_any, f_getchar},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002098 {"getcharmod", 0, 0, 0, NULL,
2099 ret_number, f_getcharmod},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002100 {"getcharpos", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar6f02b002021-01-10 20:22:54 +01002101 ret_list_number, f_getcharpos},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002102 {"getcharsearch", 0, 0, 0, NULL,
2103 ret_dict_any, f_getcharsearch},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002104 {"getcharstr", 0, 1, 0, arg1_bool,
Bram Moolenaar3a7503c2021-06-07 18:29:17 +02002105 ret_string, f_getcharstr},
Ruslan Russkikh0407d622024-10-08 22:21:05 +02002106 {"getcmdcomplpat", 0, 0, 0, NULL,
2107 ret_string, f_getcmdcomplpat},
Shougo Matsushita79d599b2022-05-07 12:48:29 +01002108 {"getcmdcompltype", 0, 0, 0, NULL,
2109 ret_string, f_getcmdcompltype},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002110 {"getcmdline", 0, 0, 0, NULL,
2111 ret_string, f_getcmdline},
2112 {"getcmdpos", 0, 0, 0, NULL,
2113 ret_number, f_getcmdpos},
Shougo Matsushita69084282024-09-23 20:34:47 +02002114 {"getcmdprompt", 0, 0, 0, NULL,
2115 ret_string, f_getcmdprompt},
Shougo Matsushita79d599b2022-05-07 12:48:29 +01002116 {"getcmdscreenpos", 0, 0, 0, NULL,
2117 ret_number, f_getcmdscreenpos},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002118 {"getcmdtype", 0, 0, 0, NULL,
2119 ret_string, f_getcmdtype},
2120 {"getcmdwintype", 0, 0, 0, NULL,
2121 ret_string, f_getcmdwintype},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002122 {"getcompletion", 2, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002123 ret_list_string, f_getcompletion},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002124 {"getcurpos", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002125 ret_list_number, f_getcurpos},
Bram Moolenaar82e46e52022-02-05 18:12:34 +00002126 {"getcursorcharpos", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar6f02b002021-01-10 20:22:54 +01002127 ret_list_number, f_getcursorcharpos},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002128 {"getcwd", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002129 ret_string, f_getcwd},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002130 {"getenv", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar7ad67d12021-03-10 16:08:26 +01002131 ret_any, f_getenv},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002132 {"getfontname", 0, 1, 0, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002133 ret_string, f_getfontname},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002134 {"getfperm", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002135 ret_string, f_getfperm},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002136 {"getfsize", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002137 ret_number, f_getfsize},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002138 {"getftime", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002139 ret_number, f_getftime},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002140 {"getftype", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002141 ret_string, f_getftype},
2142 {"getimstatus", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002143 ret_number_bool, f_getimstatus},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002144 {"getjumplist", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002145 ret_list_any, f_getjumplist},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002146 {"getline", 1, 2, FEARG_1, arg2_lnum,
Bram Moolenaar078a4612022-01-04 15:17:03 +00002147 ret_getline, f_getline},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002148 {"getloclist", 1, 2, 0, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002149 ret_list_or_dict_1, f_getloclist},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002150 {"getmarklist", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002151 ret_list_dict_any, f_getmarklist},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002152 {"getmatches", 0, 1, 0, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002153 ret_list_dict_any, f_getmatches},
2154 {"getmousepos", 0, 0, 0, NULL,
2155 ret_dict_number, f_getmousepos},
Bram Moolenaar24dc19c2022-11-14 19:49:15 +00002156 {"getmouseshape", 0, 0, 0, NULL,
2157 ret_string, f_getmouseshape},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002158 {"getpid", 0, 0, 0, NULL,
2159 ret_number, f_getpid},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002160 {"getpos", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002161 ret_list_number, f_getpos},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002162 {"getqflist", 0, 1, 0, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002163 ret_list_or_dict_0, f_getqflist},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002164 {"getreg", 0, 3, FEARG_1, arg3_string_bool_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002165 ret_getreg, f_getreg},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002166 {"getreginfo", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002167 ret_dict_any, f_getreginfo},
Shougo Matsushita19b71882024-02-28 22:48:12 +01002168 {"getregion", 2, 3, FEARG_1, arg3_list_list_dict,
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01002169 ret_list_string, f_getregion},
zeertzjqd4d12072024-07-16 20:34:16 +02002170 {"getregionpos", 2, 3, FEARG_1, arg3_list_list_dict,
2171 ret_list_regionpos, f_getregionpos},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002172 {"getregtype", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002173 ret_string, f_getregtype},
Yegappan Lakshmanan520f6ef2022-08-25 17:40:40 +01002174 {"getscriptinfo", 0, 1, 0, arg1_dict_any,
Yegappan Lakshmananf768c3d2022-08-22 13:15:13 +01002175 ret_list_dict_any, f_getscriptinfo},
ichizok663d18d2025-01-02 18:06:00 +01002176 {"getstacktrace", 0, 0, 0, NULL,
2177 ret_list_dict_any, f_getstacktrace},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002178 {"gettabinfo", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002179 ret_list_dict_any, f_gettabinfo},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002180 {"gettabvar", 2, 3, FEARG_1, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002181 ret_any, f_gettabvar},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002182 {"gettabwinvar", 3, 4, FEARG_1, arg4_number_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002183 ret_any, f_gettabwinvar},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002184 {"gettagstack", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002185 ret_dict_any, f_gettagstack},
Christ van Willegence0ef912024-06-20 23:41:59 +02002186 {"gettext", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002187 ret_string, f_gettext},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002188 {"getwininfo", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002189 ret_list_dict_any, f_getwininfo},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002190 {"getwinpos", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002191 ret_list_number, f_getwinpos},
2192 {"getwinposx", 0, 0, 0, NULL,
2193 ret_number, f_getwinposx},
2194 {"getwinposy", 0, 0, 0, NULL,
2195 ret_number, f_getwinposy},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002196 {"getwinvar", 2, 3, FEARG_1, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002197 ret_any, f_getwinvar},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002198 {"glob", 1, 4, FEARG_1, arg14_glob,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002199 ret_any, f_glob},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002200 {"glob2regpat", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002201 ret_string, f_glob2regpat},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002202 {"globpath", 2, 5, FEARG_2, arg25_globpath,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002203 ret_any, f_globpath},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002204 {"has", 1, 2, 0, arg2_string_bool,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002205 ret_number_bool, f_has},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002206 {"has_key", 2, 2, FEARG_1, arg2_dict_any_string_or_nr,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002207 ret_number_bool, f_has_key},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002208 {"haslocaldir", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002209 ret_number, f_haslocaldir},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002210 {"hasmapto", 1, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002211 ret_number_bool, f_hasmapto},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002212 {"highlightID", 1, 1, FEARG_1, arg1_string, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02002213 ret_number, f_hlID},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002214 {"highlight_exists",1, 1, FEARG_1, arg1_string, // obsolete
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002215 ret_number_bool, f_hlexists},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002216 {"histadd", 2, 2, FEARG_2, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002217 ret_number_bool, f_histadd},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002218 {"histdel", 1, 2, FEARG_1, arg2_string_string_or_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002219 ret_number_bool, f_histdel},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002220 {"histget", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002221 ret_string, f_histget},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002222 {"histnr", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002223 ret_number, f_histnr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002224 {"hlID", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002225 ret_number, f_hlID},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002226 {"hlexists", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002227 ret_number_bool, f_hlexists},
Yegappan Lakshmanand1a8d652021-11-03 21:56:45 +00002228 {"hlget", 0, 2, FEARG_1, arg2_string_bool,
2229 ret_list_dict_any, f_hlget},
2230 {"hlset", 1, 1, FEARG_1, arg1_list_any,
2231 ret_number_bool, f_hlset},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002232 {"hostname", 0, 0, 0, NULL,
2233 ret_string, f_hostname},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002234 {"iconv", 3, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002235 ret_string, f_iconv},
Ernie Raelc8e158b2024-07-09 18:39:52 +02002236 {"id", 1, 1, FEARG_1, NULL,
2237 ret_string, f_id},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002238 {"indent", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002239 ret_number, f_indent},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002240 {"index", 2, 4, FEARG_1, arg24_index,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002241 ret_number, f_index},
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01002242 {"indexof", 2, 3, FEARG_1, arg23_index,
2243 ret_number, f_indexof},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002244 {"input", 1, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002245 ret_string, f_input},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002246 {"inputdialog", 1, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002247 ret_string, f_inputdialog},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002248 {"inputlist", 1, 1, FEARG_1, arg1_list_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002249 ret_number, f_inputlist},
2250 {"inputrestore", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002251 ret_number_bool, f_inputrestore},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002252 {"inputsave", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002253 ret_number_bool, f_inputsave},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002254 {"inputsecret", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002255 ret_string, f_inputsecret},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002256 {"insert", 2, 3, FEARG_1, arg23_insert,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002257 ret_first_arg, f_insert},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002258 {"instanceof", 2, VARGS, FEARG_1|FE_X, arg2_instanceof,
LemonBoyafe04662023-08-23 21:08:11 +02002259 ret_bool, f_instanceof},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002260 {"interrupt", 0, 0, 0, NULL,
2261 ret_void, f_interrupt},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002262 {"invert", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002263 ret_number, f_invert},
LemonBoydca1d402022-04-28 15:26:33 +01002264 {"isabsolutepath", 1, 1, FEARG_1, arg1_string,
2265 ret_number_bool, f_isabsolutepath},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002266 {"isdirectory", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002267 ret_number_bool, f_isdirectory},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002268 {"isinf", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002269 ret_number, MATH_FUNC(f_isinf)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002270 {"islocked", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002271 ret_number_bool, f_islocked},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002272 {"isnan", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002273 ret_number_bool, MATH_FUNC(f_isnan)},
Bram Moolenaar3e518a82022-08-30 17:45:33 +01002274 {"items", 1, 1, FEARG_1, arg1_string_or_list_or_dict,
Bram Moolenaarefc5db52021-07-07 21:21:30 +02002275 ret_list_items, f_items},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002276 {"job_getchannel", 1, 1, FEARG_1, arg1_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002277 ret_channel, JOB_FUNC(f_job_getchannel)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002278 {"job_info", 0, 1, FEARG_1, arg1_job,
Bram Moolenaar64ed4d42021-01-12 21:22:31 +01002279 ret_job_info, JOB_FUNC(f_job_info)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002280 {"job_setoptions", 2, 2, FEARG_1, arg2_job_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002281 ret_void, JOB_FUNC(f_job_setoptions)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002282 {"job_start", 1, 2, FEARG_1, arg2_string_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002283 ret_job, JOB_FUNC(f_job_start)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002284 {"job_status", 1, 1, FEARG_1, arg1_job,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002285 ret_string, JOB_FUNC(f_job_status)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002286 {"job_stop", 1, 2, FEARG_1, arg2_job_string_or_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002287 ret_number_bool, JOB_FUNC(f_job_stop)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002288 {"join", 1, 2, FEARG_1, arg2_list_any_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002289 ret_string, f_join},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002290 {"js_decode", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002291 ret_any, f_js_decode},
2292 {"js_encode", 1, 1, FEARG_1, NULL,
2293 ret_string, f_js_encode},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002294 {"json_decode", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002295 ret_any, f_json_decode},
2296 {"json_encode", 1, 1, FEARG_1, NULL,
2297 ret_string, f_json_encode},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002298 {"keys", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002299 ret_list_string, f_keys},
zeertzjqcdc83932022-09-12 13:38:41 +01002300 {"keytrans", 1, 1, FEARG_1, arg1_string,
2301 ret_string, f_keytrans},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002302 {"last_buffer_nr", 0, 0, 0, NULL, // obsolete
Bram Moolenaarb8f519e2020-10-21 14:49:08 +02002303 ret_number, f_last_buffer_nr},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002304 {"len", 1, 1, FEARG_1, arg1_len,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002305 ret_number, f_len},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002306 {"libcall", 3, 3, FEARG_3, arg3_libcall,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002307 ret_string, f_libcall},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002308 {"libcallnr", 3, 3, FEARG_3, arg3_libcall,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002309 ret_number, f_libcallnr},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002310 {"line", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002311 ret_number, f_line},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002312 {"line2byte", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002313 ret_number, f_line2byte},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002314 {"lispindent", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002315 ret_number, f_lispindent},
Yegappan Lakshmanan5dfe4672021-09-14 17:54:30 +02002316 {"list2blob", 1, 1, FEARG_1, arg1_list_number,
2317 ret_blob, f_list2blob},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002318 {"list2str", 1, 2, FEARG_1, arg2_list_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002319 ret_string, f_list2str},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002320 {"listener_add", 1, 2, FEARG_2, arg2_any_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002321 ret_number, f_listener_add},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002322 {"listener_flush", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002323 ret_void, f_listener_flush},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002324 {"listener_remove", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002325 ret_number_bool, f_listener_remove},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002326 {"localtime", 0, 0, 0, NULL,
2327 ret_number, f_localtime},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002328 {"log", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002329 ret_float, f_log},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002330 {"log10", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002331 ret_float, f_log10},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002332 {"luaeval", 1, 2, FEARG_1, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002333 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002334#ifdef FEAT_LUA
Bram Moolenaar15c47602020-03-26 22:16:48 +01002335 f_luaeval
2336#else
2337 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002338#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002339 },
Bram Moolenaar18024052021-12-25 21:43:28 +00002340 {"map", 2, 2, FEARG_1, arg2_map,
Bram Moolenaarea696852020-11-09 18:31:39 +01002341 ret_first_cont, f_map},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002342 {"maparg", 1, 4, FEARG_1, arg14_maparg,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002343 ret_maparg, f_maparg},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002344 {"mapcheck", 1, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002345 ret_string, f_mapcheck},
Ernie Rael09661202022-04-25 14:40:44 +01002346 {"maplist", 0, 1, 0, arg1_bool,
2347 ret_list_dict_any, f_maplist},
Bram Moolenaar18024052021-12-25 21:43:28 +00002348 {"mapnew", 2, 2, FEARG_1, arg2_mapnew,
Bram Moolenaarea696852020-11-09 18:31:39 +01002349 ret_first_cont, f_mapnew},
Ernie Rael51d04d12022-05-04 15:40:22 +01002350 {"mapset", 1, 3, FEARG_1, arg3_string_or_dict_bool_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002351 ret_void, f_mapset},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002352 {"match", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002353 ret_any, f_match},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002354 {"matchadd", 2, 5, FEARG_1, arg25_matchadd,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002355 ret_number, f_matchadd},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002356 {"matchaddpos", 2, 5, FEARG_1, arg25_matchaddpos,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002357 ret_number, f_matchaddpos},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002358 {"matcharg", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002359 ret_list_string, f_matcharg},
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01002360 {"matchbufline", 4, 5, FEARG_1, arg45_matchbufline,
2361 ret_list_any, f_matchbufline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002362 {"matchdelete", 1, 2, FEARG_1, arg2_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002363 ret_number_bool, f_matchdelete},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002364 {"matchend", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002365 ret_number, f_matchend},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002366 {"matchfuzzy", 2, 3, FEARG_1, arg3_list_string_dict,
Yegappan Lakshmanan2d8e9982023-06-24 16:42:25 +01002367 ret_list_any, f_matchfuzzy},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002368 {"matchfuzzypos", 2, 3, FEARG_1, arg3_list_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002369 ret_list_any, f_matchfuzzypos},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002370 {"matchlist", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002371 ret_list_string, f_matchlist},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002372 {"matchstr", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002373 ret_string, f_matchstr},
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01002374 {"matchstrlist", 2, 3, FEARG_1, arg23_matchstrlist,
2375 ret_list_any, f_matchstrlist},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002376 {"matchstrpos", 2, 4, FEARG_1, arg24_match_func,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002377 ret_list_any, f_matchstrpos},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002378 {"max", 1, 1, FEARG_1, arg1_list_or_dict,
Bram Moolenaar9ae37052021-01-22 22:31:10 +01002379 ret_number, f_max},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002380 {"menu_info", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002381 ret_dict_any,
Bram Moolenaara2cbdea2020-03-16 21:08:31 +01002382#ifdef FEAT_MENU
Bram Moolenaar15c47602020-03-26 22:16:48 +01002383 f_menu_info
2384#else
2385 NULL
Bram Moolenaara2cbdea2020-03-16 21:08:31 +01002386#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002387 },
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002388 {"min", 1, 1, FEARG_1, arg1_list_or_dict,
Bram Moolenaar9ae37052021-01-22 22:31:10 +01002389 ret_number, f_min},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002390 {"mkdir", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002391 ret_number_bool, f_mkdir},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002392 {"mode", 0, 1, FEARG_1, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002393 ret_string, f_mode},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002394 {"mzeval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002395 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002396#ifdef FEAT_MZSCHEME
Bram Moolenaar15c47602020-03-26 22:16:48 +01002397 f_mzeval
2398#else
2399 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002400#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002401 },
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002402 {"nextnonblank", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002403 ret_number, f_nextnonblank},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002404 {"nr2char", 1, 2, FEARG_1, arg2_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002405 ret_string, f_nr2char},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002406 {"or", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002407 ret_number, f_or},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002408 {"pathshorten", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002409 ret_string, f_pathshorten},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002410 {"perleval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002411 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002412#ifdef FEAT_PERL
Bram Moolenaar15c47602020-03-26 22:16:48 +01002413 f_perleval
2414#else
2415 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002416#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002417 },
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002418 {"popup_atcursor", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002419 ret_number, PROP_FUNC(f_popup_atcursor)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002420 {"popup_beval", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002421 ret_number, PROP_FUNC(f_popup_beval)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002422 {"popup_clear", 0, 1, 0, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002423 ret_void, PROP_FUNC(f_popup_clear)},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002424 {"popup_close", 1, 2, FEARG_1, arg2_number_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002425 ret_void, PROP_FUNC(f_popup_close)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002426 {"popup_create", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002427 ret_number, PROP_FUNC(f_popup_create)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002428 {"popup_dialog", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002429 ret_number, PROP_FUNC(f_popup_dialog)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002430 {"popup_filter_menu", 2, 2, 0, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002431 ret_bool, PROP_FUNC(f_popup_filter_menu)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002432 {"popup_filter_yesno", 2, 2, 0, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002433 ret_bool, PROP_FUNC(f_popup_filter_yesno)},
Bram Moolenaarbdc09a12022-10-07 14:31:45 +01002434 {"popup_findecho", 0, 0, 0, NULL,
2435 ret_number, PROP_FUNC(f_popup_findecho)},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002436 {"popup_findinfo", 0, 0, 0, NULL,
2437 ret_number, PROP_FUNC(f_popup_findinfo)},
2438 {"popup_findpreview", 0, 0, 0, NULL,
2439 ret_number, PROP_FUNC(f_popup_findpreview)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002440 {"popup_getoptions", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002441 ret_dict_any, PROP_FUNC(f_popup_getoptions)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002442 {"popup_getpos", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002443 ret_dict_any, PROP_FUNC(f_popup_getpos)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002444 {"popup_hide", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002445 ret_void, PROP_FUNC(f_popup_hide)},
2446 {"popup_list", 0, 0, 0, NULL,
2447 ret_list_number, PROP_FUNC(f_popup_list)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002448 {"popup_locate", 2, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002449 ret_number, PROP_FUNC(f_popup_locate)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002450 {"popup_menu", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002451 ret_number, PROP_FUNC(f_popup_menu)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002452 {"popup_move", 2, 2, FEARG_1, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002453 ret_void, PROP_FUNC(f_popup_move)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002454 {"popup_notification", 2, 2, FEARG_1, arg2_str_or_nr_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002455 ret_number, PROP_FUNC(f_popup_notification)},
Christian Brabandtfbc37f12024-06-18 20:50:58 +02002456 {"popup_setbuf", 2, 2, FEARG_1, arg2_number_buffer,
2457 ret_number_bool, PROP_FUNC(f_popup_setbuf)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002458 {"popup_setoptions", 2, 2, FEARG_1, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002459 ret_void, PROP_FUNC(f_popup_setoptions)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002460 {"popup_settext", 2, 2, FEARG_1, arg2_number_string_or_list,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002461 ret_void, PROP_FUNC(f_popup_settext)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002462 {"popup_show", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002463 ret_void, PROP_FUNC(f_popup_show)},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002464 {"pow", 2, 2, FEARG_1, arg2_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002465 ret_float, f_pow},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002466 {"prevnonblank", 1, 1, FEARG_1, arg1_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002467 ret_number, f_prevnonblank},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002468 {"printf", 1, 19, FEARG_2, arg119_printf,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002469 ret_string, f_printf},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002470 {"prompt_getprompt", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002471 ret_string, JOB_FUNC(f_prompt_getprompt)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002472 {"prompt_setcallback", 2, 2, FEARG_1, arg2_buffer_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002473 ret_void, JOB_FUNC(f_prompt_setcallback)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002474 {"prompt_setinterrupt", 2, 2, FEARG_1, arg2_buffer_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002475 ret_void, JOB_FUNC(f_prompt_setinterrupt)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002476 {"prompt_setprompt", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002477 ret_void, JOB_FUNC(f_prompt_setprompt)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002478 {"prop_add", 3, 3, FEARG_1, arg3_number_number_dict,
Bram Moolenaar7f9969c2022-07-25 18:13:54 +01002479 ret_number, PROP_FUNC(f_prop_add)},
Yegappan Lakshmananccfb7c62021-08-16 21:39:09 +02002480 {"prop_add_list", 2, 2, FEARG_1, arg2_dict_any_list_any,
2481 ret_void, PROP_FUNC(f_prop_add_list)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002482 {"prop_clear", 1, 3, FEARG_1, arg3_number_number_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002483 ret_void, PROP_FUNC(f_prop_clear)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002484 {"prop_find", 1, 2, FEARG_1, arg2_dict_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002485 ret_dict_any, PROP_FUNC(f_prop_find)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002486 {"prop_list", 1, 2, FEARG_1, arg2_number_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002487 ret_list_dict_any, PROP_FUNC(f_prop_list)},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002488 {"prop_remove", 1, 3, FEARG_1, arg3_dict_number_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002489 ret_number, PROP_FUNC(f_prop_remove)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002490 {"prop_type_add", 2, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002491 ret_void, PROP_FUNC(f_prop_type_add)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002492 {"prop_type_change", 2, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002493 ret_void, PROP_FUNC(f_prop_type_change)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002494 {"prop_type_delete", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002495 ret_void, PROP_FUNC(f_prop_type_delete)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002496 {"prop_type_get", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002497 ret_dict_any, PROP_FUNC(f_prop_type_get)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002498 {"prop_type_list", 0, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002499 ret_list_string, PROP_FUNC(f_prop_type_list)},
2500 {"pum_getpos", 0, 0, 0, NULL,
2501 ret_dict_number, f_pum_getpos},
2502 {"pumvisible", 0, 0, 0, NULL,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002503 ret_number_bool, f_pumvisible},
Ben Jacksonea19e782024-11-06 21:50:05 +01002504 {"py3eval", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002505 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002506#ifdef FEAT_PYTHON3
Bram Moolenaar15c47602020-03-26 22:16:48 +01002507 f_py3eval
2508#else
2509 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002510#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002511 },
Ben Jacksonea19e782024-11-06 21:50:05 +01002512 {"pyeval", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002513 ret_any,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002514#ifdef FEAT_PYTHON
Bram Moolenaar15c47602020-03-26 22:16:48 +01002515 f_pyeval
2516#else
2517 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002518#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002519 },
Ben Jacksonea19e782024-11-06 21:50:05 +01002520 {"pyxeval", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002521 ret_any,
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01002522#if defined(FEAT_PYTHON) || defined(FEAT_PYTHON3)
Bram Moolenaar15c47602020-03-26 22:16:48 +01002523 f_pyxeval
2524#else
2525 NULL
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01002526#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002527 },
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002528 {"rand", 0, 1, FEARG_1, arg1_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002529 ret_number, f_rand},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002530 {"range", 1, 3, FEARG_1, arg3_number,
Bram Moolenaar82e46e52022-02-05 18:12:34 +00002531 ret_list_number, f_range},
K.Takata11df3ae2022-10-19 14:02:40 +01002532 {"readblob", 1, 3, FEARG_1, arg3_string_number_number,
Bram Moolenaarc423ad72021-01-13 20:38:03 +01002533 ret_blob, f_readblob},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002534 {"readdir", 1, 3, FEARG_1, arg3_string_any_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002535 ret_list_string, f_readdir},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002536 {"readdirex", 1, 3, FEARG_1, arg3_string_any_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002537 ret_list_dict_any, f_readdirex},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002538 {"readfile", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaarc423ad72021-01-13 20:38:03 +01002539 ret_list_string, f_readfile},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002540 {"reduce", 2, 3, FEARG_1, arg23_reduce,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002541 ret_any, f_reduce},
2542 {"reg_executing", 0, 0, 0, NULL,
2543 ret_string, f_reg_executing},
2544 {"reg_recording", 0, 0, 0, NULL,
2545 ret_string, f_reg_recording},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002546 {"reltime", 0, 2, FEARG_1, arg2_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002547 ret_list_any, f_reltime},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002548 {"reltimefloat", 1, 1, FEARG_1, arg1_list_number,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002549 ret_float, f_reltimefloat},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002550 {"reltimestr", 1, 1, FEARG_1, arg1_list_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002551 ret_string, f_reltimestr},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002552 {"remote_expr", 2, 4, FEARG_1, arg24_remote_expr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002553 ret_string, f_remote_expr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002554 {"remote_foreground", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002555 ret_string, f_remote_foreground},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002556 {"remote_peek", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002557 ret_number, f_remote_peek},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002558 {"remote_read", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002559 ret_string, f_remote_read},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002560 {"remote_send", 2, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002561 ret_string, f_remote_send},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002562 {"remote_startserver", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002563 ret_void, f_remote_startserver},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002564 {"remove", 2, 3, FEARG_1, arg23_remove,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002565 ret_remove, f_remove},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002566 {"rename", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002567 ret_number_bool, f_rename},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002568 {"repeat", 2, 2, FEARG_1, arg2_repeat,
Bram Moolenaar1780f082021-07-31 22:03:59 +02002569 ret_repeat, f_repeat},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002570 {"resolve", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002571 ret_string, f_resolve},
Yegappan Lakshmananf9dc2782023-05-11 15:02:56 +01002572 {"reverse", 1, 1, FEARG_1, arg1_string_or_list_or_blob_mod,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002573 ret_first_arg, f_reverse},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002574 {"round", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002575 ret_float, f_round},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002576 {"rubyeval", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002577 ret_any,
Bram Moolenaare99be0e2019-03-26 22:51:09 +01002578#ifdef FEAT_RUBY
Bram Moolenaar15c47602020-03-26 22:16:48 +01002579 f_rubyeval
2580#else
2581 NULL
Bram Moolenaare99be0e2019-03-26 22:51:09 +01002582#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002583 },
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002584 {"screenattr", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002585 ret_number, f_screenattr},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002586 {"screenchar", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002587 ret_number, f_screenchar},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002588 {"screenchars", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002589 ret_list_number, f_screenchars},
2590 {"screencol", 0, 0, 0, NULL,
2591 ret_number, f_screencol},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002592 {"screenpos", 3, 3, FEARG_1, arg3_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002593 ret_dict_number, f_screenpos},
2594 {"screenrow", 0, 0, 0, NULL,
2595 ret_number, f_screenrow},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002596 {"screenstring", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002597 ret_string, f_screenstring},
Bram Moolenaarcd268012021-07-22 19:11:08 +02002598 {"search", 1, 5, FEARG_1, arg15_search,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002599 ret_number, f_search},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002600 {"searchcount", 0, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002601 ret_dict_any, f_searchcount},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002602 {"searchdecl", 1, 3, FEARG_1, arg3_string_bool_bool,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002603 ret_number_bool, f_searchdecl},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002604 {"searchpair", 3, 7, 0, arg37_searchpair,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002605 ret_number, f_searchpair},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002606 {"searchpairpos", 3, 7, 0, arg37_searchpair,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002607 ret_list_number, f_searchpairpos},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002608 {"searchpos", 1, 5, FEARG_1, arg15_search,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002609 ret_list_number, f_searchpos},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002610 {"server2client", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002611 ret_number_bool, f_server2client},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002612 {"serverlist", 0, 0, 0, NULL,
2613 ret_string, f_serverlist},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002614 {"setbufline", 3, 3, FEARG_3, arg3_setbufline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002615 ret_number_bool, f_setbufline},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002616 {"setbufvar", 3, 3, FEARG_3, arg3_buffer_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002617 ret_void, f_setbufvar},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002618 {"setcellwidths", 1, 1, FEARG_1, arg1_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002619 ret_void, f_setcellwidths},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002620 {"setcharpos", 2, 2, FEARG_2, arg2_string_list_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002621 ret_number_bool, f_setcharpos},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002622 {"setcharsearch", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002623 ret_void, f_setcharsearch},
Shougo Matsushita07ea5f12022-08-27 12:22:25 +01002624 {"setcmdline", 1, 2, FEARG_1, arg2_string_number,
2625 ret_number_bool, f_setcmdline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002626 {"setcmdpos", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002627 ret_number_bool, f_setcmdpos},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002628 {"setcursorcharpos", 1, 3, FEARG_1, arg13_cursor,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002629 ret_number_bool, f_setcursorcharpos},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002630 {"setenv", 2, 2, FEARG_2, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002631 ret_void, f_setenv},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002632 {"setfperm", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002633 ret_number_bool, f_setfperm},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002634 {"setline", 2, 2, FEARG_2, arg2_setline,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002635 ret_number_bool, f_setline},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002636 {"setloclist", 2, 4, FEARG_2, arg24_setloclist,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002637 ret_number_bool, f_setloclist},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002638 {"setmatches", 1, 2, FEARG_1, arg2_list_any_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002639 ret_number_bool, f_setmatches},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002640 {"setpos", 2, 2, FEARG_2, arg2_string_list_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002641 ret_number_bool, f_setpos},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002642 {"setqflist", 1, 3, FEARG_1, arg13_setqflist,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002643 ret_number_bool, f_setqflist},
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02002644 {"setreg", 2, 3, FEARG_2, arg3_string_any_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002645 ret_number_bool, f_setreg},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002646 {"settabvar", 3, 3, FEARG_3, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002647 ret_void, f_settabvar},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002648 {"settabwinvar", 4, 4, FEARG_4, arg4_number_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002649 ret_void, f_settabwinvar},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002650 {"settagstack", 2, 3, FEARG_2, arg23_settagstack,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002651 ret_number_bool, f_settagstack},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002652 {"setwinvar", 3, 3, FEARG_3, arg3_number_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002653 ret_void, f_setwinvar},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002654 {"sha256", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002655 ret_string,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002656#ifdef FEAT_CRYPT
Bram Moolenaar15c47602020-03-26 22:16:48 +01002657 f_sha256
2658#else
2659 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002660#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002661 },
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002662 {"shellescape", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002663 ret_string, f_shellescape},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002664 {"shiftwidth", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002665 ret_number, f_shiftwidth},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002666 {"sign_define", 1, 2, FEARG_1, arg2_string_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002667 ret_any, SIGN_FUNC(f_sign_define)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002668 {"sign_getdefined", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002669 ret_list_dict_any, SIGN_FUNC(f_sign_getdefined)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002670 {"sign_getplaced", 0, 2, FEARG_1, arg02_sign_getplaced,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002671 ret_list_dict_any, SIGN_FUNC(f_sign_getplaced)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002672 {"sign_jump", 3, 3, FEARG_1, arg3_number_string_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002673 ret_number, SIGN_FUNC(f_sign_jump)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002674 {"sign_place", 4, 5, FEARG_1, arg45_sign_place,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002675 ret_number, SIGN_FUNC(f_sign_place)},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002676 {"sign_placelist", 1, 1, FEARG_1, arg1_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002677 ret_list_number, SIGN_FUNC(f_sign_placelist)},
Yegappan Lakshmananc72bdd22021-07-11 19:44:18 +02002678 {"sign_undefine", 0, 1, FEARG_1, arg1_string_or_list_string,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002679 ret_number_bool, SIGN_FUNC(f_sign_undefine)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002680 {"sign_unplace", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002681 ret_number_bool, SIGN_FUNC(f_sign_unplace)},
Sean Dewara63780b2021-11-03 13:15:47 +00002682 {"sign_unplacelist", 1, 1, FEARG_1, arg1_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002683 ret_list_number, SIGN_FUNC(f_sign_unplacelist)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002684 {"simplify", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002685 ret_string, f_simplify},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002686 {"sin", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002687 ret_float, f_sin},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002688 {"sinh", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002689 ret_float, f_sinh},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002690 {"slice", 2, 3, FEARG_1, arg23_slice,
Bram Moolenaar00eb9952022-02-05 19:23:18 +00002691 ret_slice, f_slice},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002692 {"sort", 1, 3, FEARG_1, arg13_sortuniq,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002693 ret_first_arg, f_sort},
2694 {"sound_clear", 0, 0, 0, NULL,
2695 ret_void, SOUND_FUNC(f_sound_clear)},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002696 {"sound_playevent", 1, 2, FEARG_1, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002697 ret_number, SOUND_FUNC(f_sound_playevent)},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002698 {"sound_playfile", 1, 2, FEARG_1, arg2_string_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002699 ret_number, SOUND_FUNC(f_sound_playfile)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002700 {"sound_stop", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002701 ret_void, SOUND_FUNC(f_sound_stop)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002702 {"soundfold", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002703 ret_string, f_soundfold},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002704 {"spellbadword", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002705 ret_list_string, f_spellbadword},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002706 {"spellsuggest", 1, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002707 ret_list_string, f_spellsuggest},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002708 {"split", 1, 3, FEARG_1, arg3_string_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002709 ret_list_string, f_split},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002710 {"sqrt", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002711 ret_float, f_sqrt},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002712 {"srand", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002713 ret_list_number, f_srand},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002714 {"state", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002715 ret_string, f_state},
Yegappan Lakshmanan1aefe1d2025-01-14 17:29:42 +01002716 {"str2blob", 1, 2, FEARG_1, arg2_string_dict,
2717 ret_blob, f_str2blob},
Bram Moolenaar80a070c2021-08-08 15:51:10 +02002718 {"str2float", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002719 ret_float, f_str2float},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002720 {"str2list", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002721 ret_list_number, f_str2list},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002722 {"str2nr", 1, 3, FEARG_1, arg3_string_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002723 ret_number, f_str2nr},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002724 {"strcharlen", 1, 1, FEARG_1, arg1_string_or_nr,
Bram Moolenaar70ce8a12021-03-14 19:02:09 +01002725 ret_number, f_strcharlen},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002726 {"strcharpart", 2, 4, FEARG_1, arg24_strpart,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002727 ret_string, f_strcharpart},
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02002728 {"strchars", 1, 2, FEARG_1, arg2_string_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002729 ret_number, f_strchars},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002730 {"strdisplaywidth", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002731 ret_number, f_strdisplaywidth},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002732 {"strftime", 1, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002733 ret_string,
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002734#ifdef HAVE_STRFTIME
Bram Moolenaar15c47602020-03-26 22:16:48 +01002735 f_strftime
2736#else
2737 NULL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02002738#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002739 },
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002740 {"strgetchar", 2, 2, FEARG_1, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002741 ret_number, f_strgetchar},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002742 {"stridx", 2, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002743 ret_number, f_stridx},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002744 {"string", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002745 ret_string, f_string},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002746 {"strlen", 1, 1, FEARG_1, arg1_string_or_nr,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002747 ret_number, f_strlen},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002748 {"strpart", 2, 4, FEARG_1, arg24_strpart,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002749 ret_string, f_strpart},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002750 {"strptime", 2, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002751 ret_number,
Bram Moolenaar10455d42019-11-21 15:36:18 +01002752#ifdef HAVE_STRPTIME
Bram Moolenaar15c47602020-03-26 22:16:48 +01002753 f_strptime
2754#else
2755 NULL
Bram Moolenaar10455d42019-11-21 15:36:18 +01002756#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002757 },
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002758 {"strridx", 2, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002759 ret_number, f_strridx},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002760 {"strtrans", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002761 ret_string, f_strtrans},
Christian Brabandt67672ef2023-04-24 21:09:54 +01002762 {"strutf16len", 1, 2, FEARG_1, arg2_string_bool,
2763 ret_number, f_strutf16len},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002764 {"strwidth", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002765 ret_number, f_strwidth},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002766 {"submatch", 1, 2, FEARG_1, arg2_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002767 ret_string, f_submatch},
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02002768 {"substitute", 4, 4, FEARG_1, arg4_string_string_any_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002769 ret_string, f_substitute},
Bram Moolenaarc216a7a2022-12-05 13:50:55 +00002770 {"swapfilelist", 0, 0, 0, NULL,
2771 ret_list_string, f_swapfilelist},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002772 {"swapinfo", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002773 ret_dict_any, f_swapinfo},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002774 {"swapname", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002775 ret_string, f_swapname},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002776 {"synID", 3, 3, 0, arg3_lnum_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002777 ret_number, f_synID},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002778 {"synIDattr", 2, 3, FEARG_1, arg3_number_string_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002779 ret_string, f_synIDattr},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002780 {"synIDtrans", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002781 ret_number, f_synIDtrans},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002782 {"synconcealed", 2, 2, 0, arg2_lnum_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002783 ret_list_any, f_synconcealed},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002784 {"synstack", 2, 2, 0, arg2_lnum_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002785 ret_list_number, f_synstack},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002786 {"system", 1, 2, FEARG_1, arg12_system,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002787 ret_string, f_system},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002788 {"systemlist", 1, 2, FEARG_1, arg12_system,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002789 ret_list_string, f_systemlist},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002790 {"tabpagebuflist", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002791 ret_list_number, f_tabpagebuflist},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002792 {"tabpagenr", 0, 1, 0, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002793 ret_number, f_tabpagenr},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002794 {"tabpagewinnr", 1, 2, FEARG_1, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002795 ret_number, f_tabpagewinnr},
2796 {"tagfiles", 0, 0, 0, NULL,
2797 ret_list_string, f_tagfiles},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002798 {"taglist", 1, 2, FEARG_1, arg2_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002799 ret_list_dict_any, f_taglist},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002800 {"tan", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002801 ret_float, f_tan},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002802 {"tanh", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002803 ret_float, f_tanh},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002804 {"tempname", 0, 0, 0, NULL,
2805 ret_string, f_tempname},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002806 {"term_dumpdiff", 2, 3, FEARG_1, arg3_string_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002807 ret_number, TERM_FUNC(f_term_dumpdiff)},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002808 {"term_dumpload", 1, 2, FEARG_1, arg2_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002809 ret_number, TERM_FUNC(f_term_dumpload)},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002810 {"term_dumpwrite", 2, 3, FEARG_2, arg3_buffer_string_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002811 ret_void, TERM_FUNC(f_term_dumpwrite)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002812 {"term_getaltscreen", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002813 ret_number, TERM_FUNC(f_term_getaltscreen)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002814 {"term_getansicolors", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002815 ret_list_string,
Bram Moolenaarbd5e6222020-03-26 23:13:34 +01002816#if defined(FEAT_TERMINAL) && (defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS))
Bram Moolenaar15c47602020-03-26 22:16:48 +01002817 f_term_getansicolors
2818#else
2819 NULL
Bram Moolenaarc6df10e2017-07-29 20:15:08 +02002820#endif
Bram Moolenaar15c47602020-03-26 22:16:48 +01002821 },
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002822 {"term_getattr", 2, 2, FEARG_1, arg2_number_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002823 ret_number, TERM_FUNC(f_term_getattr)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002824 {"term_getcursor", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002825 ret_list_any, TERM_FUNC(f_term_getcursor)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002826 {"term_getjob", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002827 ret_job, TERM_FUNC(f_term_getjob)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002828 {"term_getline", 2, 2, FEARG_1, arg2_buffer_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002829 ret_string, TERM_FUNC(f_term_getline)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002830 {"term_getscrolled", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002831 ret_number, TERM_FUNC(f_term_getscrolled)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002832 {"term_getsize", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002833 ret_list_number, TERM_FUNC(f_term_getsize)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002834 {"term_getstatus", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002835 ret_string, TERM_FUNC(f_term_getstatus)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002836 {"term_gettitle", 1, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002837 ret_string, TERM_FUNC(f_term_gettitle)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002838 {"term_gettty", 1, 2, FEARG_1, arg2_buffer_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002839 ret_string, TERM_FUNC(f_term_gettty)},
2840 {"term_list", 0, 0, 0, NULL,
2841 ret_list_number, TERM_FUNC(f_term_list)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002842 {"term_scrape", 2, 2, FEARG_1, arg2_buffer_lnum,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002843 ret_list_dict_any, TERM_FUNC(f_term_scrape)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002844 {"term_sendkeys", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002845 ret_void, TERM_FUNC(f_term_sendkeys)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002846 {"term_setansicolors", 2, 2, FEARG_1, arg2_buffer_list_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002847 ret_void,
Bram Moolenaarbd5e6222020-03-26 23:13:34 +01002848#if defined(FEAT_TERMINAL) && (defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS))
Bram Moolenaar15c47602020-03-26 22:16:48 +01002849 f_term_setansicolors
2850#else
2851 NULL
2852#endif
2853 },
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002854 {"term_setapi", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002855 ret_void, TERM_FUNC(f_term_setapi)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002856 {"term_setkill", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002857 ret_void, TERM_FUNC(f_term_setkill)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002858 {"term_setrestore", 2, 2, FEARG_1, arg2_buffer_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002859 ret_void, TERM_FUNC(f_term_setrestore)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002860 {"term_setsize", 3, 3, FEARG_1, arg3_buffer_number_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002861 ret_void, TERM_FUNC(f_term_setsize)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002862 {"term_start", 1, 2, FEARG_1, arg2_string_or_list_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002863 ret_number, TERM_FUNC(f_term_start)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002864 {"term_wait", 1, 2, FEARG_1, arg2_buffer_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002865 ret_void, TERM_FUNC(f_term_wait)},
2866 {"terminalprops", 0, 0, 0, NULL,
2867 ret_dict_string, f_terminalprops},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002868 {"test_alloc_fail", 3, 3, FEARG_1, arg3_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002869 ret_void, f_test_alloc_fail},
2870 {"test_autochdir", 0, 0, 0, NULL,
2871 ret_void, f_test_autochdir},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002872 {"test_feedinput", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002873 ret_void, f_test_feedinput},
2874 {"test_garbagecollect_now", 0, 0, 0, NULL,
2875 ret_void, f_test_garbagecollect_now},
2876 {"test_garbagecollect_soon", 0, 0, 0, NULL,
2877 ret_void, f_test_garbagecollect_soon},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002878 {"test_getvalue", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002879 ret_number, f_test_getvalue},
Yegappan Lakshmanan06011e12022-01-30 12:37:29 +00002880 {"test_gui_event", 2, 2, FEARG_1, arg2_string_dict,
2881 ret_bool, f_test_gui_event},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002882 {"test_ignore_error", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002883 ret_void, f_test_ignore_error},
Christopher Plewright20b795e2022-12-20 20:01:58 +00002884 {"test_mswin_event", 2, 2, FEARG_1, arg2_string_dict,
2885 ret_number, f_test_mswin_event},
Bram Moolenaar94738d82020-10-21 14:25:07 +02002886 {"test_null_blob", 0, 0, 0, NULL,
2887 ret_blob, f_test_null_blob},
2888 {"test_null_channel", 0, 0, 0, NULL,
2889 ret_channel, JOB_FUNC(f_test_null_channel)},
2890 {"test_null_dict", 0, 0, 0, NULL,
2891 ret_dict_any, f_test_null_dict},
2892 {"test_null_function", 0, 0, 0, NULL,
2893 ret_func_any, f_test_null_function},
2894 {"test_null_job", 0, 0, 0, NULL,
2895 ret_job, JOB_FUNC(f_test_null_job)},
2896 {"test_null_list", 0, 0, 0, NULL,
2897 ret_list_any, f_test_null_list},
2898 {"test_null_partial", 0, 0, 0, NULL,
2899 ret_func_any, f_test_null_partial},
2900 {"test_null_string", 0, 0, 0, NULL,
2901 ret_string, f_test_null_string},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002902 {"test_option_not_set", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002903 ret_void, f_test_option_not_set},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002904 {"test_override", 2, 2, FEARG_2, arg2_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002905 ret_void, f_test_override},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002906 {"test_refcount", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002907 ret_number, f_test_refcount},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002908 {"test_setmouse", 2, 2, 0, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002909 ret_void, f_test_setmouse},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002910 {"test_settime", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002911 ret_void, f_test_settime},
Yegappan Lakshmanan5b739922021-07-10 13:15:41 +02002912 {"test_srand_seed", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002913 ret_void, f_test_srand_seed},
2914 {"test_unknown", 0, 0, 0, NULL,
2915 ret_any, f_test_unknown},
2916 {"test_void", 0, 0, 0, NULL,
2917 ret_void, f_test_void},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002918 {"timer_info", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002919 ret_list_dict_any, TIMER_FUNC(f_timer_info)},
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02002920 {"timer_pause", 2, 2, FEARG_1, arg2_number_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002921 ret_void, TIMER_FUNC(f_timer_pause)},
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +02002922 {"timer_start", 2, 3, FEARG_1, arg3_number_any_dict,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002923 ret_number, TIMER_FUNC(f_timer_start)},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002924 {"timer_stop", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002925 ret_void, TIMER_FUNC(f_timer_stop)},
2926 {"timer_stopall", 0, 0, 0, NULL,
2927 ret_void, TIMER_FUNC(f_timer_stopall)},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002928 {"tolower", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002929 ret_string, f_tolower},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002930 {"toupper", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002931 ret_string, f_toupper},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002932 {"tr", 3, 3, FEARG_1, arg3_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002933 ret_string, f_tr},
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02002934 {"trim", 1, 3, FEARG_1, arg3_string_string_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002935 ret_string, f_trim},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002936 {"trunc", 1, 1, FEARG_1, arg1_float_or_nr,
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01002937 ret_float, f_trunc},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002938 {"type", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002939 ret_number, f_type},
Ernie Raeld8bf87c2023-12-16 14:03:33 +01002940 {"typename", 1, 1, FEARG_1|FE_X, NULL,
Bram Moolenaara47e05f2021-01-12 21:49:00 +01002941 ret_string, f_typename},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002942 {"undofile", 1, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002943 ret_string, f_undofile},
Devin J. Pohly5fee1112023-04-23 20:26:59 -05002944 {"undotree", 0, 1, FEARG_1, arg1_buffer,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002945 ret_dict_any, f_undotree},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02002946 {"uniq", 1, 3, FEARG_1, arg13_sortuniq,
Bram Moolenaar08018222021-12-22 18:45:37 +00002947 ret_first_arg, f_uniq},
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01002948 {"utf16idx", 2, 4, FEARG_1, arg4_string_number_bool_bool,
Christian Brabandt67672ef2023-04-24 21:09:54 +01002949 ret_number, f_utf16idx},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002950 {"values", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar32517c42023-01-15 18:17:12 +00002951 ret_list_member, f_values},
zeertzjq825cf812023-08-17 22:55:25 +02002952 {"virtcol", 1, 3, FEARG_1, arg3_string_or_list_bool_number,
LemonBoy0f7a3e12022-05-26 12:10:37 +01002953 ret_virtcol, f_virtcol},
Bram Moolenaar5a6ec102022-05-27 21:58:00 +01002954 {"virtcol2col", 3, 3, FEARG_1, arg3_number,
2955 ret_number, f_virtcol2col},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002956 {"visualmode", 0, 1, 0, arg1_bool,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002957 ret_string, f_visualmode},
2958 {"wildmenumode", 0, 0, 0, NULL,
2959 ret_number, f_wildmenumode},
Bram Moolenaar52312242021-07-11 18:23:19 +02002960 {"win_execute", 2, 3, FEARG_2, arg23_win_execute,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002961 ret_string, f_win_execute},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002962 {"win_findbuf", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002963 ret_list_number, f_win_findbuf},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002964 {"win_getid", 0, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002965 ret_number, f_win_getid},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002966 {"win_gettype", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002967 ret_string, f_win_gettype},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002968 {"win_gotoid", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002969 ret_number_bool, f_win_gotoid},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002970 {"win_id2tabwin", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002971 ret_list_number, f_win_id2tabwin},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002972 {"win_id2win", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002973 ret_number, f_win_id2win},
Daniel Steinbergee630312022-01-10 13:36:34 +00002974 {"win_move_separator", 2, 2, FEARG_1, arg2_number,
2975 ret_number_bool, f_win_move_separator},
2976 {"win_move_statusline", 2, 2, FEARG_1, arg2_number,
2977 ret_number_bool, f_win_move_statusline},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002978 {"win_screenpos", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002979 ret_list_number, f_win_screenpos},
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02002980 {"win_splitmove", 2, 3, FEARG_1, arg3_number_number_dict,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01002981 ret_number_bool, f_win_splitmove},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002982 {"winbufnr", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002983 ret_number, f_winbufnr},
2984 {"wincol", 0, 0, 0, NULL,
2985 ret_number, f_wincol},
2986 {"windowsversion", 0, 0, 0, NULL,
2987 ret_string, f_windowsversion},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002988 {"winheight", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002989 ret_number, f_winheight},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02002990 {"winlayout", 0, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002991 ret_list_any, f_winlayout},
2992 {"winline", 0, 0, 0, NULL,
2993 ret_number, f_winline},
Yegappan Lakshmanana26f56f2021-07-03 11:58:12 +02002994 {"winnr", 0, 1, FEARG_1, arg1_string,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002995 ret_number, f_winnr},
2996 {"winrestcmd", 0, 0, 0, NULL,
2997 ret_string, f_winrestcmd},
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02002998 {"winrestview", 1, 1, FEARG_1, arg1_dict_any,
Bram Moolenaar94738d82020-10-21 14:25:07 +02002999 ret_void, f_winrestview},
3000 {"winsaveview", 0, 0, 0, NULL,
Bram Moolenaar43b69b32021-01-07 20:23:33 +01003001 ret_dict_number, f_winsaveview},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003002 {"winwidth", 1, 1, FEARG_1, arg1_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003003 ret_number, f_winwidth},
3004 {"wordcount", 0, 0, 0, NULL,
3005 ret_dict_number, f_wordcount},
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02003006 {"writefile", 2, 3, FEARG_1, arg23_writefile,
Bram Moolenaar3af15ab2021-01-17 16:16:23 +01003007 ret_number_bool, f_writefile},
Yegappan Lakshmanan7237cab2021-06-22 19:52:27 +02003008 {"xor", 2, 2, FEARG_1, arg2_number,
Bram Moolenaar94738d82020-10-21 14:25:07 +02003009 ret_number, f_xor},
Bram Moolenaarac92e252019-08-03 21:58:38 +02003010};
3011
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003012/*
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003013 * Return true if specified function allows a type as an argument.
3014 */
3015 static int
3016func_allows_type(int idx)
3017{
3018 return (global_functions[idx].f_argtype & FE_X) != 0;
3019}
3020
3021/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003022 * Function given to ExpandGeneric() to obtain the list of internal
3023 * or user defined function names.
3024 */
3025 char_u *
3026get_function_name(expand_T *xp, int idx)
3027{
3028 static int intidx = -1;
3029 char_u *name;
3030
3031 if (idx == 0)
3032 intidx = -1;
3033 if (intidx < 0)
3034 {
3035 name = get_user_func_name(xp, idx);
naohiro ono5aec7552021-08-19 21:20:41 +02003036 if (name != NULL)
Bram Moolenaar1bb4de52021-01-13 19:48:46 +01003037 {
naohiro ono5aec7552021-08-19 21:20:41 +02003038 if (*name != NUL && *name != '<'
3039 && STRNCMP("g:", xp->xp_pattern, 2) == 0)
Bram Moolenaar1bb4de52021-01-13 19:48:46 +01003040 return cat_prefix_varname('g', name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003041 return name;
Bram Moolenaar1bb4de52021-01-13 19:48:46 +01003042 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003043 }
K.Takataeeec2542021-06-02 13:28:16 +02003044 if (++intidx < (int)ARRAY_LENGTH(global_functions))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003045 {
Kota Kato90c23532023-01-18 15:27:38 +00003046 // Skip if the function doesn't have an implementation (feature not
3047 // implemented).
3048 if (global_functions[intidx].f_func == NULL)
3049 return (char_u *)"";
Bram Moolenaarac92e252019-08-03 21:58:38 +02003050 STRCPY(IObuff, global_functions[intidx].f_name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003051 STRCAT(IObuff, "(");
Bram Moolenaarac92e252019-08-03 21:58:38 +02003052 if (global_functions[intidx].f_max_argc == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003053 STRCAT(IObuff, ")");
3054 return IObuff;
3055 }
3056
3057 return NULL;
3058}
3059
3060/*
3061 * Function given to ExpandGeneric() to obtain the list of internal or
3062 * user defined variable or function names.
3063 */
3064 char_u *
3065get_expr_name(expand_T *xp, int idx)
3066{
3067 static int intidx = -1;
3068 char_u *name;
3069
3070 if (idx == 0)
3071 intidx = -1;
3072 if (intidx < 0)
3073 {
3074 name = get_function_name(xp, idx);
3075 if (name != NULL)
3076 return name;
3077 }
3078 return get_user_var_name(xp, ++intidx);
3079}
3080
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003081/*
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003082 * Find internal function "name" in table "global_functions".
Bram Moolenaar15c47602020-03-26 22:16:48 +01003083 * Return index, or -1 if not found or "implemented" is TRUE and the function
3084 * is not implemented.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003085 */
Bram Moolenaar15c47602020-03-26 22:16:48 +01003086 static int
3087find_internal_func_opt(char_u *name, int implemented)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003088{
3089 int first = 0;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003090 int last;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003091 int cmp;
3092 int x;
3093
K.Takataeeec2542021-06-02 13:28:16 +02003094 last = (int)ARRAY_LENGTH(global_functions) - 1;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003095
3096 // Find the function name in the table. Binary search.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003097 while (first <= last)
3098 {
3099 x = first + ((unsigned)(last - first) >> 1);
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003100 cmp = STRCMP(name, global_functions[x].f_name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003101 if (cmp < 0)
3102 last = x - 1;
3103 else if (cmp > 0)
3104 first = x + 1;
Bram Moolenaar15c47602020-03-26 22:16:48 +01003105 else if (implemented && global_functions[x].f_func == NULL)
3106 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003107 else
3108 return x;
3109 }
3110 return -1;
3111}
3112
Bram Moolenaar15c47602020-03-26 22:16:48 +01003113/*
3114 * Find internal function "name" in table "global_functions".
3115 * Return index, or -1 if not found or the function is not implemented.
3116 */
3117 int
3118find_internal_func(char_u *name)
3119{
3120 return find_internal_func_opt(name, TRUE);
3121}
3122
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003123 int
Bram Moolenaarac92e252019-08-03 21:58:38 +02003124has_internal_func(char_u *name)
3125{
Bram Moolenaar15c47602020-03-26 22:16:48 +01003126 return find_internal_func_opt(name, TRUE) >= 0;
3127}
3128
3129 static int
3130has_internal_func_name(char_u *name)
3131{
3132 return find_internal_func_opt(name, FALSE) >= 0;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003133}
3134
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003135 char *
3136internal_func_name(int idx)
3137{
3138 return global_functions[idx].f_name;
3139}
3140
Bram Moolenaar94738d82020-10-21 14:25:07 +02003141/*
Dominique Pellefe8ebdb2021-05-13 14:55:55 +02003142 * Check the argument types for builtin function "idx".
Bram Moolenaar94738d82020-10-21 14:25:07 +02003143 * Uses the list of types on the type stack: "types".
3144 * Return FAIL and gives an error message when a type is wrong.
3145 */
3146 int
Bram Moolenaar351ead02021-01-16 16:07:01 +01003147internal_func_check_arg_types(
Bram Moolenaar078a4612022-01-04 15:17:03 +00003148 type2_T *types,
Bram Moolenaar351ead02021-01-16 16:07:01 +01003149 int idx,
3150 int argcount,
3151 cctx_T *cctx)
Bram Moolenaar94738d82020-10-21 14:25:07 +02003152{
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003153 // Some internal functions accept types like Class as arguments. For other
3154 // functions, check the arguments are not types.
3155 if (!(func_allows_type(idx)))
3156 {
zeertzjqd9be94c2024-07-14 10:20:20 +02003157 for (int i = 0; i < argcount; ++i)
3158 if (check_type_is_value(types[i].type_curr) == FAIL)
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003159 return FAIL;
3160 }
3161
Bram Moolenaar94738d82020-10-21 14:25:07 +02003162 argcheck_T *argchecks = global_functions[idx].f_argcheck;
Bram Moolenaar94738d82020-10-21 14:25:07 +02003163
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003164 if (argchecks == NULL)
3165 return OK;
Bram Moolenaar94738d82020-10-21 14:25:07 +02003166
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003167 argcontext_T context;
3168
3169 context.arg_count = argcount;
3170 context.arg_types = types;
3171 context.arg_cctx = cctx;
Ernie Raela8f7f922023-12-14 20:17:04 +01003172 for (int i = 0; i < argcount && argchecks[i] != NULL; ++i)
3173 {
3174 context.arg_idx = i;
3175 if (argchecks[i](types[i].type_curr, types[i].type_decl,
3176 &context) == FAIL)
3177 return FAIL;
3178 }
Bram Moolenaar94738d82020-10-21 14:25:07 +02003179 return OK;
3180}
3181
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003182/*
Bram Moolenaar7a40ff02021-07-04 15:54:08 +02003183 * Get the argument count for function "idx".
3184 * "argcount" is the total argument count, "min_argcount" the non-optional
3185 * argument count.
3186 */
3187 void
3188internal_func_get_argcount(int idx, int *argcount, int *min_argcount)
3189{
3190 *argcount = global_functions[idx].f_max_argc;
3191 *min_argcount = global_functions[idx].f_min_argc;
3192}
3193
3194/*
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003195 * Call the "f_retfunc" function to obtain the return type of function "idx".
Bram Moolenaar81330182022-02-01 12:11:58 +00003196 * "decl_type" is set to the declared type.
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003197 * "argtypes" is the list of argument types or NULL when there are no
3198 * arguments.
Bram Moolenaarf78da4f2021-08-01 15:40:31 +02003199 * "argcount" may be less than the actual count when only getting the type.
Bram Moolenaara1224cb2020-10-22 12:31:49 +02003200 */
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003201 type_T *
Bram Moolenaar81330182022-02-01 12:11:58 +00003202internal_func_ret_type(
3203 int idx,
3204 int argcount,
3205 type2_T *argtypes,
Bram Moolenaar32517c42023-01-15 18:17:12 +00003206 type_T **decl_type,
3207 garray_T *type_gap)
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003208{
Bram Moolenaar81330182022-02-01 12:11:58 +00003209 type_T *ret;
3210
Bram Moolenaar32517c42023-01-15 18:17:12 +00003211 current_type_gap = type_gap;
Bram Moolenaar81330182022-02-01 12:11:58 +00003212 *decl_type = NULL;
3213 ret = global_functions[idx].f_retfunc(argcount, argtypes, decl_type);
3214 if (*decl_type == NULL)
3215 *decl_type = ret;
Bram Moolenaar32517c42023-01-15 18:17:12 +00003216 current_type_gap = NULL;
Bram Moolenaar81330182022-02-01 12:11:58 +00003217 return ret;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003218}
3219
3220/*
Bram Moolenaar75ab91f2021-01-10 22:42:50 +01003221 * Return TRUE if "idx" is for the map() function.
3222 */
3223 int
3224internal_func_is_map(int idx)
3225{
3226 return global_functions[idx].f_func == f_map;
3227}
3228
3229/*
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003230 * Check the argument count to use for internal function "idx".
Bram Moolenaar389df252020-07-09 21:20:47 +02003231 * Returns -1 for failure, 0 if no method base accepted, 1 if method base is
3232 * first argument, 2 if method base is second argument, etc. 9 if method base
3233 * is last argument.
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003234 */
3235 int
3236check_internal_func(int idx, int argcount)
3237{
Bram Moolenaar0917e862023-02-18 14:42:44 +00003238 funcerror_T res;
3239 char *name;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003240
3241 if (argcount < global_functions[idx].f_min_argc)
3242 res = FCERR_TOOFEW;
3243 else if (argcount > global_functions[idx].f_max_argc)
3244 res = FCERR_TOOMANY;
3245 else
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003246 return global_functions[idx].f_argtype & FEARG_MASK;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003247
3248 name = internal_func_name(idx);
3249 if (res == FCERR_TOOMANY)
Bram Moolenaare1242042021-12-16 20:56:57 +00003250 semsg(_(e_too_many_arguments_for_function_str), name);
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003251 else
Bram Moolenaare1242042021-12-16 20:56:57 +00003252 semsg(_(e_not_enough_arguments_for_function_str), name);
Bram Moolenaar389df252020-07-09 21:20:47 +02003253 return -1;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003254}
3255
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003256/*
3257 * Some internal functions accept types like Class as arguments. For other
3258 * functions, check the arguments are not types.
3259 *
3260 * Return OK/FAIL.
3261 */
3262 static int
3263check_args_for_type(int idx, int argcount, typval_T *argvars)
3264{
3265 if (!func_allows_type(idx))
3266 {
3267 for (int i = 0; i < argcount; ++i)
3268 if (check_typval_is_value(&argvars[i]) == FAIL)
3269 return FAIL;
3270 }
3271 return OK;
3272}
3273
Bram Moolenaar0917e862023-02-18 14:42:44 +00003274 funcerror_T
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003275call_internal_func(
3276 char_u *name,
3277 int argcount,
3278 typval_T *argvars,
3279 typval_T *rettv)
3280{
3281 int i;
3282
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003283 i = find_internal_func(name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003284 if (i < 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01003285 return FCERR_UNKNOWN;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003286 if (argcount < global_functions[i].f_min_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003287 return FCERR_TOOFEW;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003288 if (argcount > global_functions[i].f_max_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003289 return FCERR_TOOMANY;
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003290 if (check_args_for_type(i, argcount, argvars) == FAIL)
3291 return FCERR_OTHER;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003292 argvars[argcount].v_type = VAR_UNKNOWN;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003293 global_functions[i].f_func(argvars, rettv);
Bram Moolenaaref140542019-12-31 21:27:13 +01003294 return FCERR_NONE;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003295}
3296
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003297 void
3298call_internal_func_by_idx(
3299 int idx,
3300 typval_T *argvars,
3301 typval_T *rettv)
3302{
3303 global_functions[idx].f_func(argvars, rettv);
3304}
3305
Bram Moolenaarac92e252019-08-03 21:58:38 +02003306/*
3307 * Invoke a method for base->method().
3308 */
Bram Moolenaar0917e862023-02-18 14:42:44 +00003309 funcerror_T
Bram Moolenaarac92e252019-08-03 21:58:38 +02003310call_internal_method(
3311 char_u *name,
3312 int argcount,
3313 typval_T *argvars,
3314 typval_T *rettv,
3315 typval_T *basetv)
3316{
Bram Moolenaarac92e252019-08-03 21:58:38 +02003317 int fi;
3318 typval_T argv[MAX_FUNC_ARGS + 1];
3319
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003320 fi = find_internal_func(name);
Bram Moolenaar91746392019-08-16 22:22:31 +02003321 if (fi < 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01003322 return FCERR_UNKNOWN;
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003323 if ((global_functions[fi].f_argtype & FEARG_MASK) == 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01003324 return FCERR_NOTMETHOD;
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003325 if (argcount + 1 < global_functions[fi].f_min_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003326 return FCERR_TOOFEW;
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003327 if (argcount + 1 > global_functions[fi].f_max_argc)
Bram Moolenaaref140542019-12-31 21:27:13 +01003328 return FCERR_TOOMANY;
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003329 if (check_args_for_type(fi, argcount, argvars) == FAIL)
3330 return FCERR_OTHER;
Bram Moolenaarac92e252019-08-03 21:58:38 +02003331
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003332 if ((global_functions[fi].f_argtype & FEARG_MASK) == FEARG_2)
Bram Moolenaar25e42232019-08-04 15:04:10 +02003333 {
Bram Moolenaarb7f22702023-04-27 16:24:07 +01003334 if (argcount < 1)
3335 return FCERR_TOOFEW;
3336
Bram Moolenaar25e42232019-08-04 15:04:10 +02003337 // base value goes second
3338 argv[0] = argvars[0];
3339 argv[1] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003340 for (int i = 1; i < argcount; ++i)
Bram Moolenaar25e42232019-08-04 15:04:10 +02003341 argv[i + 1] = argvars[i];
3342 }
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003343 else if ((global_functions[fi].f_argtype & FEARG_MASK) == FEARG_3)
Bram Moolenaar24278d22019-08-16 21:49:22 +02003344 {
Bram Moolenaarb7f22702023-04-27 16:24:07 +01003345 if (argcount < 2)
3346 return FCERR_TOOFEW;
3347
Bram Moolenaar24278d22019-08-16 21:49:22 +02003348 // base value goes third
3349 argv[0] = argvars[0];
3350 argv[1] = argvars[1];
3351 argv[2] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003352 for (int i = 2; i < argcount; ++i)
Bram Moolenaar24278d22019-08-16 21:49:22 +02003353 argv[i + 1] = argvars[i];
3354 }
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003355 else if ((global_functions[fi].f_argtype & FEARG_MASK) == FEARG_4)
Bram Moolenaaraad222c2019-09-06 22:46:09 +02003356 {
Bram Moolenaarb7f22702023-04-27 16:24:07 +01003357 if (argcount < 3)
3358 return FCERR_TOOFEW;
3359
Bram Moolenaaraad222c2019-09-06 22:46:09 +02003360 // base value goes fourth
3361 argv[0] = argvars[0];
3362 argv[1] = argvars[1];
3363 argv[2] = argvars[2];
3364 argv[3] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003365 for (int i = 3; i < argcount; ++i)
Bram Moolenaaraad222c2019-09-06 22:46:09 +02003366 argv[i + 1] = argvars[i];
3367 }
Bram Moolenaar25e42232019-08-04 15:04:10 +02003368 else
3369 {
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003370 // FEARG_1: base value goes first
Bram Moolenaar25e42232019-08-04 15:04:10 +02003371 argv[0] = *basetv;
Bram Moolenaar848db572022-09-20 19:04:32 +01003372 for (int i = 0; i < argcount; ++i)
Bram Moolenaar25e42232019-08-04 15:04:10 +02003373 argv[i + 1] = argvars[i];
3374 }
Bram Moolenaarac92e252019-08-03 21:58:38 +02003375 argv[argcount + 1].v_type = VAR_UNKNOWN;
3376
Ernie Raeld8bf87c2023-12-16 14:03:33 +01003377 if (check_args_for_type(fi, argcount + 1, argv) == FAIL)
3378 return FCERR_OTHER;
3379
Bram Moolenaar7a4ea1d2019-08-04 21:35:12 +02003380 global_functions[fi].f_func(argv, rettv);
Bram Moolenaaref140542019-12-31 21:27:13 +01003381 return FCERR_NONE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003382}
3383
3384/*
3385 * Return TRUE for a non-zero Number and a non-empty String.
3386 */
Bram Moolenaar0e57dd82019-09-16 22:56:03 +02003387 int
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003388non_zero_arg(typval_T *argvars)
3389{
3390 return ((argvars[0].v_type == VAR_NUMBER
3391 && argvars[0].vval.v_number != 0)
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01003392 || (argvars[0].v_type == VAR_BOOL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003393 && argvars[0].vval.v_number == VVAL_TRUE)
3394 || (argvars[0].v_type == VAR_STRING
3395 && argvars[0].vval.v_string != NULL
3396 && *argvars[0].vval.v_string != NUL));
3397}
3398
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003399/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003400 * "and(expr, expr)" function
3401 */
3402 static void
3403f_and(typval_T *argvars, typval_T *rettv)
3404{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003405 if (in_vim9script()
3406 && (check_for_number_arg(argvars, 0) == FAIL
3407 || check_for_number_arg(argvars, 1) == FAIL))
3408 return;
3409
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003410 rettv->vval.v_number = tv_get_number_chk(&argvars[0], NULL)
3411 & tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaarca851592018-06-06 21:04:07 +02003412}
3413
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003414/*
Bram Moolenaar59716a22017-03-01 20:32:44 +01003415 * "balloon_show()" function
3416 */
3417#ifdef FEAT_BEVAL
3418 static void
Bram Moolenaarbe0a2592019-05-09 13:50:16 +02003419f_balloon_gettext(typval_T *argvars UNUSED, typval_T *rettv)
3420{
3421 rettv->v_type = VAR_STRING;
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003422 if (balloonEval == NULL)
3423 return;
3424
3425 if (balloonEval->msg == NULL)
3426 rettv->vval.v_string = NULL;
3427 else
3428 rettv->vval.v_string = vim_strsave(balloonEval->msg);
Bram Moolenaarbe0a2592019-05-09 13:50:16 +02003429}
3430
3431 static void
Bram Moolenaar59716a22017-03-01 20:32:44 +01003432f_balloon_show(typval_T *argvars, typval_T *rettv UNUSED)
3433{
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003434 if (balloonEval == NULL)
3435 return;
3436
3437 if (in_vim9script()
3438 && check_for_string_or_list_arg(argvars, 0) == FAIL)
3439 return;
3440
3441 if (argvars[0].v_type == VAR_LIST
3442# ifdef FEAT_GUI
3443 && !gui.in_use
3444# endif
3445 )
Bram Moolenaar246fe032017-11-19 19:56:27 +01003446 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003447 list_T *l = argvars[0].vval.v_list;
3448
3449 // empty list removes the balloon
3450 post_balloon(balloonEval, NULL,
3451 l == NULL || l->lv_len == 0 ? NULL : l);
3452 }
3453 else
3454 {
3455 char_u *mesg;
3456
3457 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003458 return;
3459
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003460 mesg = tv_get_string_chk(&argvars[0]);
3461 if (mesg != NULL)
3462 // empty string removes the balloon
3463 post_balloon(balloonEval, *mesg == NUL ? NULL : mesg, NULL);
Bram Moolenaar246fe032017-11-19 19:56:27 +01003464 }
3465}
3466
Bram Moolenaar669a8282017-11-19 20:13:05 +01003467# if defined(FEAT_BEVAL_TERM)
Bram Moolenaar246fe032017-11-19 19:56:27 +01003468 static void
3469f_balloon_split(typval_T *argvars, typval_T *rettv UNUSED)
3470{
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003471 if (rettv_list_alloc(rettv) != OK)
3472 return;
3473
3474 char_u *msg;
3475
3476 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
3477 return;
3478 msg = tv_get_string_chk(&argvars[0]);
3479 if (msg != NULL)
Bram Moolenaar246fe032017-11-19 19:56:27 +01003480 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003481 pumitem_T *array;
3482 int size = split_message(msg, &array);
Bram Moolenaar246fe032017-11-19 19:56:27 +01003483
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00003484 // Skip the first and last item, they are always empty.
3485 for (int i = 1; i < size - 1; ++i)
3486 list_append_string(rettv->vval.v_list, array[i].pum_text, -1);
3487 while (size > 0)
3488 vim_free(array[--size].pum_text);
3489 vim_free(array);
Bram Moolenaar246fe032017-11-19 19:56:27 +01003490 }
Bram Moolenaar59716a22017-03-01 20:32:44 +01003491}
Bram Moolenaar669a8282017-11-19 20:13:05 +01003492# endif
Bram Moolenaar59716a22017-03-01 20:32:44 +01003493#endif
3494
Yegappan Lakshmanan810785c2024-12-30 10:29:44 +01003495// Base64 character set
3496static const char_u base64_table[] = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
3497
3498// Base64 decoding table (initialized in init_base64_dec_table() below)
3499static char_u base64_dec_table[256];
3500
3501/*
3502 * Initialize the base64 decoding table
3503 */
3504 static void
3505init_base64_dec_table(void)
3506{
3507 static int base64_dec_tbl_initialized = FALSE;
3508
3509 if (base64_dec_tbl_initialized)
3510 return;
3511
3512 // Unsupported characters are set to 0xFF
3513 vim_memset(base64_dec_table, 0xFF, sizeof(base64_dec_table));
3514
3515 // Initialize the index for the base64 alphabets
3516 for (size_t i = 0; i < sizeof(base64_table) - 1; i++)
3517 base64_dec_table[(char_u)base64_table[i]] = (char_u)i;
3518
3519 // base64 padding character
3520 base64_dec_table['='] = 0;
3521
3522 base64_dec_tbl_initialized = TRUE;
3523}
3524
3525/*
3526 * Encode the bytes in "blob" using base-64 encoding.
3527 */
3528 static char_u *
3529base64_encode(blob_T *blob)
3530{
3531 size_t input_len = blob->bv_ga.ga_len;
3532 size_t encoded_len = ((input_len + 2) / 3) * 4;
3533 char_u *data = blob->bv_ga.ga_data;
3534
3535 char_u *encoded = alloc(encoded_len + 1);
3536 if (encoded == NULL)
3537 return NULL;
3538
3539 size_t i, j;
3540 for (i = 0, j = 0; i < input_len;)
3541 {
3542 int_u octet_a = i < input_len ? data[i++] : 0;
3543 int_u octet_b = i < input_len ? data[i++] : 0;
3544 int_u octet_c = i < input_len ? data[i++] : 0;
3545
3546 int_u triple = (octet_a << 16) | (octet_b << 8) | octet_c;
3547
3548 encoded[j++] = base64_table[(triple >> 18) & 0x3F];
3549 encoded[j++] = base64_table[(triple >> 12) & 0x3F];
3550 encoded[j++] = (!octet_b && i >= input_len) ? '='
3551 : base64_table[(triple >> 6) & 0x3F];
3552 encoded[j++] = (!octet_c && i >= input_len) ? '='
3553 : base64_table[triple & 0x3F];
3554 }
3555 encoded[j] = NUL;
3556
3557 return encoded;
3558}
3559
3560/*
3561 * Decode the string "data" using base-64 encoding.
3562 */
3563 static void
3564base64_decode(const char_u *data, blob_T *blob)
3565{
3566 size_t input_len = STRLEN(data);
3567
3568 if (input_len == 0)
3569 return;
3570
3571 if (input_len % 4 != 0)
3572 {
3573 // Invalid input length
3574 semsg(_(e_invalid_argument_str), data);
3575 return;
3576 }
3577
3578 init_base64_dec_table();
3579
3580 size_t decoded_len = (input_len / 4) * 3;
3581 if (data[input_len - 1] == '=')
3582 decoded_len--;
3583 if (data[input_len - 2] == '=')
3584 decoded_len--;
3585
3586 size_t i, j;
3587 for (i = 0, j = 0; i < input_len;)
3588 {
3589 int_u sextet_a = base64_dec_table[(char_u)data[i++]];
3590 int_u sextet_b = base64_dec_table[(char_u)data[i++]];
3591 int_u sextet_c = base64_dec_table[(char_u)data[i++]];
3592 int_u sextet_d = base64_dec_table[(char_u)data[i++]];
3593
3594 if (sextet_a == 0xFF || sextet_b == 0xFF || sextet_c == 0xFF
3595 || sextet_d == 0xFF)
3596 {
3597 // Invalid character
3598 semsg(_(e_invalid_argument_str), data);
3599 ga_clear(&blob->bv_ga);
3600 return;
3601 }
3602
3603 int_u triple = (sextet_a << 18) | (sextet_b << 12)
3604 | (sextet_c << 6) | sextet_d;
3605
3606 if (j < decoded_len)
3607 {
3608 ga_append(&blob->bv_ga, (triple >> 16) & 0xFF);
3609 j++;
3610 }
3611 if (j < decoded_len)
3612 {
3613 ga_append(&blob->bv_ga, (triple >> 8) & 0xFF);
3614 j++;
3615 }
3616 if (j < decoded_len)
3617 {
3618 ga_append(&blob->bv_ga, triple & 0xFF);
3619 j++;
3620 }
3621
3622 if (j == decoded_len)
3623 {
3624 // Check for invalid padding bytes (based on the
3625 // "Base64 Malleability in Practice" ACM paper).
3626 if ((data[input_len - 2] == '=' && ((sextet_b & 0xF) != 0))
3627 || ((data[input_len - 1] == '=') && ((sextet_c & 0x3) != 0)))
3628 {
3629 semsg(_(e_invalid_argument_str), data);
3630 ga_clear(&blob->bv_ga);
3631 return;
3632 }
3633 }
3634 }
3635}
3636
3637/*
3638 * "base64_decode(string)" function
3639 */
3640 static void
3641f_base64_decode(typval_T *argvars, typval_T *rettv)
3642{
3643 if (check_for_string_arg(argvars, 0) == FAIL)
3644 return;
3645
3646 if (rettv_blob_alloc(rettv) == FAIL)
3647 return;
3648
3649 char_u *str = tv_get_string_chk(&argvars[0]);
3650 if (str != NULL)
3651 base64_decode(str, rettv->vval.v_blob);
3652}
3653
3654/*
3655 * "base64_encode(blob)" function
3656 */
3657 static void
3658f_base64_encode(typval_T *argvars, typval_T *rettv)
3659{
3660 if (check_for_blob_arg(argvars, 0) == FAIL)
3661 return;
3662
3663 rettv->v_type = VAR_STRING;
3664 rettv->vval.v_string = NULL;
3665
3666 blob_T *blob = argvars->vval.v_blob;
3667 if (blob != NULL)
3668 rettv->vval.v_string = base64_encode(blob);
3669}
3670
Bram Moolenaar59716a22017-03-01 20:32:44 +01003671/*
Bram Moolenaar6b7b7192019-01-11 13:42:41 +01003672 * Get the buffer from "arg" and give an error and return NULL if it is not
3673 * valid.
3674 */
Bram Moolenaara3347722019-05-11 21:14:24 +02003675 buf_T *
Bram Moolenaar6b7b7192019-01-11 13:42:41 +01003676get_buf_arg(typval_T *arg)
3677{
3678 buf_T *buf;
3679
3680 ++emsg_off;
3681 buf = tv_get_buf(arg, FALSE);
3682 --emsg_off;
3683 if (buf == NULL)
Bram Moolenaard82a47d2022-01-05 20:24:39 +00003684 semsg(_(e_invalid_buffer_name_str), tv_get_string(arg));
Bram Moolenaar6b7b7192019-01-11 13:42:41 +01003685 return buf;
3686}
3687
3688/*
Christ van Willegence0ef912024-06-20 23:41:59 +02003689 * "bindtextdomain(package, path)" function
3690 */
3691 static void
Christ van Willegen8252ef12024-07-11 21:36:21 +02003692f_bindtextdomain(typval_T *argvars, typval_T *rettv)
Christ van Willegence0ef912024-06-20 23:41:59 +02003693{
Christ van Willegen8252ef12024-07-11 21:36:21 +02003694 rettv->v_type = VAR_BOOL;
3695 rettv->vval.v_number = VVAL_TRUE;
3696
Christ van Willegence0ef912024-06-20 23:41:59 +02003697 if (check_for_nonempty_string_arg(argvars, 0) == FAIL
3698 || check_for_nonempty_string_arg(argvars, 1) == FAIL)
3699 return;
3700
3701 if (strcmp((const char *)argvars[0].vval.v_string, VIMPACKAGE) == 0)
3702 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[0]));
3703 else
Christ van Willegen8252ef12024-07-11 21:36:21 +02003704 {
3705 if (bindtextdomain((const char *)argvars[0].vval.v_string, (const char *)argvars[1].vval.v_string) == NULL)
3706 {
3707 do_outofmem_msg((long)0);
3708 rettv->vval.v_number = VVAL_FALSE;
3709 }
3710 }
Christ van Willegence0ef912024-06-20 23:41:59 +02003711
3712 return;
3713}
3714
3715/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003716 * "byte2line(byte)" function
3717 */
3718 static void
3719f_byte2line(typval_T *argvars UNUSED, typval_T *rettv)
3720{
3721#ifndef FEAT_BYTEOFF
3722 rettv->vval.v_number = -1;
3723#else
3724 long boff = 0;
3725
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003726 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
3727 return;
3728
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01003729 boff = tv_get_number(&argvars[0]) - 1; // boff gets -1 on type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003730 if (boff < 0)
3731 rettv->vval.v_number = -1;
3732 else
3733 rettv->vval.v_number = ml_find_line_or_offset(curbuf,
3734 (linenr_T)0, &boff);
3735#endif
3736}
3737
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003738/*
3739 * "call(func, arglist [, dict])" function
3740 */
3741 static void
3742f_call(typval_T *argvars, typval_T *rettv)
3743{
3744 char_u *func;
3745 partial_T *partial = NULL;
3746 dict_T *selfdict = NULL;
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003747 char_u *tofree = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003748
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02003749 if (in_vim9script()
Bram Moolenaar223d0a62021-12-25 19:29:21 +00003750 && (check_for_string_or_func_arg(argvars, 0) == FAIL
3751 || check_for_list_arg(argvars, 1) == FAIL
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02003752 || check_for_opt_dict_arg(argvars, 2) == FAIL))
3753 return;
3754
Bram Moolenaard83392a2022-09-01 12:22:46 +01003755 if (check_for_list_arg(argvars, 1) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003756 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003757 if (argvars[1].vval.v_list == NULL)
3758 return;
3759
3760 if (argvars[0].v_type == VAR_FUNC)
3761 func = argvars[0].vval.v_string;
3762 else if (argvars[0].v_type == VAR_PARTIAL)
3763 {
3764 partial = argvars[0].vval.v_partial;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02003765 func = partial_name(partial);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003766 }
3767 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003768 func = tv_get_string(&argvars[0]);
Dominique Pellefe8ebdb2021-05-13 14:55:55 +02003769 if (func == NULL || *func == NUL)
3770 return; // type error, empty name or null function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003771
Yegappan Lakshmanan6289f912025-01-14 17:13:36 +01003772 char_u *p = func;
3773 tofree = trans_function_name(&p, NULL, FALSE, TFN_INT|TFN_QUIET);
3774 if (tofree == NULL)
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003775 {
Yegappan Lakshmanan6289f912025-01-14 17:13:36 +01003776 emsg_funcname(e_unknown_function_str, func);
3777 return;
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003778 }
Yegappan Lakshmanan6289f912025-01-14 17:13:36 +01003779 func = tofree;
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003780
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003781 if (argvars[2].v_type != VAR_UNKNOWN)
3782 {
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +01003783 if (check_for_dict_arg(argvars, 2) == FAIL)
Yegappan Lakshmanan6289f912025-01-14 17:13:36 +01003784 goto done;
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +01003785
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003786 selfdict = argvars[2].vval.v_dict;
3787 }
3788
3789 (void)func_call(func, &argvars[1], partial, selfdict, rettv);
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003790
Yegappan Lakshmanan6289f912025-01-14 17:13:36 +01003791done:
Bram Moolenaar3d8e25a2022-01-22 11:00:02 +00003792 vim_free(tofree);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003793}
3794
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003795/*
3796 * "changenr()" function
3797 */
3798 static void
3799f_changenr(typval_T *argvars UNUSED, typval_T *rettv)
3800{
3801 rettv->vval.v_number = curbuf->b_u_seq_cur;
3802}
3803
3804/*
3805 * "char2nr(string)" function
3806 */
3807 static void
3808f_char2nr(typval_T *argvars, typval_T *rettv)
3809{
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02003810 if (in_vim9script()
3811 && (check_for_string_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02003812 || check_for_opt_bool_arg(argvars, 1) == FAIL))
Bram Moolenaarc5809432021-03-27 21:23:30 +01003813 return;
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02003814
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003815 if (has_mbyte)
3816 {
3817 int utf8 = 0;
3818
3819 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaar24f77502020-09-04 19:50:57 +02003820 utf8 = (int)tv_get_bool_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003821
3822 if (utf8)
Bram Moolenaarbdace832019-03-02 10:13:42 +01003823 rettv->vval.v_number = utf_ptr2char(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003824 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003825 rettv->vval.v_number = (*mb_ptr2char)(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003826 }
3827 else
Bram Moolenaar13505972019-01-24 15:04:48 +01003828 rettv->vval.v_number = tv_get_string(&argvars[0])[0];
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003829}
3830
Bram Moolenaar17793ef2020-12-28 12:56:58 +01003831/*
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003832 * Get the current cursor column and store it in 'rettv'. If 'charcol' is TRUE,
3833 * returns the character index of the column. Otherwise, returns the byte index
3834 * of the column.
3835 */
3836 static void
3837get_col(typval_T *argvars, typval_T *rettv, int charcol)
3838{
3839 colnr_T col = 0;
3840 pos_T *fp;
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00003841 switchwin_T switchwin;
3842 int winchanged = FALSE;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003843
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00003844 if (check_for_string_or_list_arg(argvars, 0) == FAIL
3845 || check_for_opt_number_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02003846 return;
3847
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00003848 if (argvars[1].v_type != VAR_UNKNOWN)
3849 {
3850 tabpage_T *tp;
3851 win_T *wp;
3852
3853 // use the window specified in the second argument
3854 wp = win_id2wp_tp((int)tv_get_number(&argvars[1]), &tp);
3855 if (wp == NULL || tp == NULL)
3856 return;
3857
3858 if (switch_win_noblock(&switchwin, wp, tp, TRUE) != OK)
3859 return;
3860
3861 check_cursor();
3862 winchanged = TRUE;
3863 }
3864
3865 int fnum = curbuf->b_fnum;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003866 fp = var2fpos(&argvars[0], FALSE, &fnum, charcol);
3867 if (fp != NULL && fnum == curbuf->b_fnum)
3868 {
3869 if (fp->col == MAXCOL)
3870 {
3871 // '> can be MAXCOL, get the length of the line then
3872 if (fp->lnum <= curbuf->b_ml.ml_line_count)
John Marriottbfcc8952024-03-11 22:04:45 +01003873 col = ml_get_len(fp->lnum) + 1;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003874 else
3875 col = MAXCOL;
3876 }
3877 else
3878 {
3879 col = fp->col + 1;
3880 // col(".") when the cursor is on the NUL at the end of the line
3881 // because of "coladd" can be seen as an extra column.
3882 if (virtual_active() && fp == &curwin->w_cursor)
3883 {
3884 char_u *p = ml_get_cursor();
3885
3886 if (curwin->w_cursor.coladd >= (colnr_T)chartabsize(p,
3887 curwin->w_virtcol - curwin->w_cursor.coladd))
3888 {
3889 int l;
3890
3891 if (*p != NUL && p[(l = (*mb_ptr2len)(p))] == NUL)
3892 col += l;
3893 }
3894 }
3895 }
3896 }
3897 rettv->vval.v_number = col;
Yegappan Lakshmanan4c8d2f02022-11-12 16:07:47 +00003898
3899 if (winchanged)
3900 restore_win_noblock(&switchwin, TRUE);
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003901}
3902
3903/*
3904 * "charcol()" function
3905 */
3906 static void
3907f_charcol(typval_T *argvars, typval_T *rettv)
3908{
3909 get_col(argvars, rettv, TRUE);
3910}
3911
Bram Moolenaar29b7d7a2019-07-22 23:03:57 +02003912 win_T *
Bram Moolenaaraff74912019-03-30 18:11:49 +01003913get_optional_window(typval_T *argvars, int idx)
3914{
3915 win_T *win = curwin;
3916
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003917 if (argvars[idx].v_type == VAR_UNKNOWN)
3918 return curwin;
3919
3920 win = find_win_by_nr_or_id(&argvars[idx]);
3921 if (win == NULL)
Bram Moolenaaraff74912019-03-30 18:11:49 +01003922 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +00003923 emsg(_(e_invalid_window_number));
3924 return NULL;
Bram Moolenaaraff74912019-03-30 18:11:49 +01003925 }
3926 return win;
3927}
3928
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003929/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003930 * "col(string)" function
3931 */
3932 static void
3933f_col(typval_T *argvars, typval_T *rettv)
3934{
Bram Moolenaar6f02b002021-01-10 20:22:54 +01003935 get_col(argvars, rettv, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003936}
3937
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003938/*
3939 * "confirm(message, buttons[, default [, type]])" function
3940 */
3941 static void
3942f_confirm(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
3943{
3944#if defined(FEAT_GUI_DIALOG) || defined(FEAT_CON_DIALOG)
3945 char_u *message;
3946 char_u *buttons = NULL;
3947 char_u buf[NUMBUFLEN];
3948 char_u buf2[NUMBUFLEN];
3949 int def = 1;
3950 int type = VIM_GENERIC;
3951 char_u *typestr;
3952 int error = FALSE;
3953
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02003954 if (in_vim9script()
3955 && (check_for_string_arg(argvars, 0) == FAIL
3956 || (check_for_opt_string_arg(argvars, 1) == FAIL
3957 || (argvars[1].v_type != VAR_UNKNOWN
3958 && (check_for_opt_number_arg(argvars, 2) == FAIL
3959 || (argvars[2].v_type != VAR_UNKNOWN
3960 && check_for_opt_string_arg(argvars, 3) == FAIL))))))
Bram Moolenaarc5809432021-03-27 21:23:30 +01003961 return;
3962
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003963 message = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003964 if (message == NULL)
3965 error = TRUE;
3966 if (argvars[1].v_type != VAR_UNKNOWN)
3967 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003968 buttons = tv_get_string_buf_chk(&argvars[1], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003969 if (buttons == NULL)
3970 error = TRUE;
3971 if (argvars[2].v_type != VAR_UNKNOWN)
3972 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003973 def = (int)tv_get_number_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003974 if (argvars[3].v_type != VAR_UNKNOWN)
3975 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01003976 typestr = tv_get_string_buf_chk(&argvars[3], buf2);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02003977 if (typestr == NULL)
3978 error = TRUE;
3979 else
3980 {
3981 switch (TOUPPER_ASC(*typestr))
3982 {
3983 case 'E': type = VIM_ERROR; break;
3984 case 'Q': type = VIM_QUESTION; break;
3985 case 'I': type = VIM_INFO; break;
3986 case 'W': type = VIM_WARNING; break;
3987 case 'G': type = VIM_GENERIC; break;
3988 }
3989 }
3990 }
3991 }
3992 }
3993
3994 if (buttons == NULL || *buttons == NUL)
3995 buttons = (char_u *)_("&Ok");
3996
3997 if (!error)
3998 rettv->vval.v_number = do_dialog(type, NULL, message, buttons,
3999 def, NULL, FALSE);
4000#endif
4001}
4002
4003/*
4004 * "copy()" function
4005 */
4006 static void
4007f_copy(typval_T *argvars, typval_T *rettv)
4008{
Bram Moolenaar381692b2022-02-02 20:01:27 +00004009 item_copy(&argvars[0], rettv, FALSE, TRUE, 0);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004010}
4011
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004012/*
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004013 * Set the cursor position.
Yegappan Lakshmanan577922b2023-06-08 17:09:45 +01004014 * If "charcol" is TRUE, then use the column number as a character offset.
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004015 * Otherwise use the column number as a byte offset.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004016 */
4017 static void
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004018set_cursorpos(typval_T *argvars, typval_T *rettv, int charcol)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004019{
Bram Moolenaar79f23442022-10-10 12:42:57 +01004020 long lnum, col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004021 long coladd = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004022 int set_curswant = TRUE;
4023
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004024 if (in_vim9script()
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004025 && (check_for_string_or_number_or_list_arg(argvars, 0) == FAIL
Yegappan Lakshmanancd917202021-07-21 19:09:09 +02004026 || check_for_opt_number_arg(argvars, 1) == FAIL
4027 || (argvars[1].v_type != VAR_UNKNOWN
4028 && check_for_opt_number_arg(argvars, 2) == FAIL)))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004029 return;
4030
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004031 rettv->vval.v_number = -1;
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004032 if (argvars[0].v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004033 {
4034 pos_T pos;
4035 colnr_T curswant = -1;
4036
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004037 if (list2fpos(argvars, &pos, NULL, &curswant, charcol) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004038 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00004039 emsg(_(e_invalid_argument));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004040 return;
4041 }
Bram Moolenaar79f23442022-10-10 12:42:57 +01004042 lnum = pos.lnum;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004043 col = pos.col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004044 coladd = pos.coladd;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004045 if (curswant >= 0)
4046 {
4047 curwin->w_curswant = curswant - 1;
4048 set_curswant = FALSE;
4049 }
4050 }
Bram Moolenaar79f23442022-10-10 12:42:57 +01004051 else if ((argvars[0].v_type == VAR_NUMBER
4052 || argvars[0].v_type == VAR_STRING)
4053 && (argvars[1].v_type == VAR_NUMBER
4054 || argvars[1].v_type == VAR_STRING))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004055 {
Bram Moolenaar79f23442022-10-10 12:42:57 +01004056 lnum = tv_get_lnum(argvars);
4057 if (lnum < 0)
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00004058 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[0]));
Bram Moolenaar79f23442022-10-10 12:42:57 +01004059 else if (lnum == 0)
4060 lnum = curwin->w_cursor.lnum;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004061 col = (long)tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004062 if (charcol)
Bram Moolenaar79f23442022-10-10 12:42:57 +01004063 col = buf_charidx_to_byteidx(curbuf, lnum, col) + 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004064 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004065 coladd = (long)tv_get_number_chk(&argvars[2], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004066 }
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004067 else
4068 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00004069 emsg(_(e_invalid_argument));
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004070 return;
4071 }
Bram Moolenaar79f23442022-10-10 12:42:57 +01004072 if (lnum < 0 || col < 0 || coladd < 0)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004073 return; // type error; errmsg already given
Bram Moolenaar79f23442022-10-10 12:42:57 +01004074 if (lnum > 0)
4075 curwin->w_cursor.lnum = lnum;
zeertzjq2ffdae72024-05-02 13:06:24 +02004076 if (col != MAXCOL && --col < 0)
4077 col = 0;
4078 curwin->w_cursor.col = col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004079 curwin->w_cursor.coladd = coladd;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004080
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004081 // Make sure the cursor is in a valid position.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004082 check_cursor();
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004083 // Correct cursor for multi-byte character.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004084 if (has_mbyte)
4085 mb_adjust_cursor();
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004086
4087 curwin->w_set_curswant = set_curswant;
4088 rettv->vval.v_number = 0;
4089}
4090
Bram Moolenaar6f02b002021-01-10 20:22:54 +01004091/*
4092 * "cursor(lnum, col)" function, or
4093 * "cursor(list)"
4094 *
4095 * Moves the cursor to the specified line and column.
4096 * Returns 0 when the position could be set, -1 otherwise.
4097 */
4098 static void
4099f_cursor(typval_T *argvars, typval_T *rettv)
4100{
4101 set_cursorpos(argvars, rettv, FALSE);
4102}
4103
Bram Moolenaar4f974752019-02-17 17:44:42 +01004104#ifdef MSWIN
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004105/*
4106 * "debugbreak()" function
4107 */
4108 static void
4109f_debugbreak(typval_T *argvars, typval_T *rettv)
4110{
4111 int pid;
4112
4113 rettv->vval.v_number = FAIL;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004114 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
4115 return;
4116
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004117 pid = (int)tv_get_number(&argvars[0]);
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004118 if (pid == 0)
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004119 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00004120 emsg(_(e_invalid_argument));
4121 return;
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004122 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00004123
4124 HANDLE hProcess = OpenProcess(PROCESS_ALL_ACCESS, 0, pid);
4125 if (hProcess == NULL)
4126 return;
4127
4128 DebugBreakProcess(hProcess);
4129 CloseHandle(hProcess);
4130 rettv->vval.v_number = OK;
Bram Moolenaar4551c0a2018-06-20 22:38:21 +02004131}
4132#endif
4133
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004134/*
4135 * "deepcopy()" function
4136 */
4137 static void
4138f_deepcopy(typval_T *argvars, typval_T *rettv)
4139{
Bram Moolenaar239f8d92021-01-17 13:21:20 +01004140 varnumber_T noref = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004141
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +01004142 if (check_for_opt_bool_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004143 return;
4144
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004145 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaar239f8d92021-01-17 13:21:20 +01004146 noref = tv_get_bool_chk(&argvars[1], NULL);
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +01004147
4148 item_copy(&argvars[0], rettv, TRUE, TRUE, noref == 0 ? get_copyID() : 0);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004149}
4150
4151/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004152 * "did_filetype()" function
4153 */
4154 static void
4155f_did_filetype(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
4156{
zeertzjq5bf6c212024-03-31 18:41:27 +02004157 rettv->vval.v_number = curbuf->b_did_filetype;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004158}
4159
4160/*
Bram Moolenaar4132eb52020-02-14 16:53:00 +01004161 * "echoraw({expr})" function
4162 */
4163 static void
4164f_echoraw(typval_T *argvars, typval_T *rettv UNUSED)
4165{
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02004166 char_u *str;
Bram Moolenaar4132eb52020-02-14 16:53:00 +01004167
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02004168 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
4169 return;
4170
4171 str = tv_get_string_chk(&argvars[0]);
Bram Moolenaar4132eb52020-02-14 16:53:00 +01004172 if (str != NULL && *str != NUL)
4173 {
4174 out_str(str);
4175 out_flush();
4176 }
4177}
4178
4179/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004180 * "empty({expr})" function
4181 */
4182 static void
4183f_empty(typval_T *argvars, typval_T *rettv)
4184{
4185 int n = FALSE;
4186
4187 switch (argvars[0].v_type)
4188 {
4189 case VAR_STRING:
4190 case VAR_FUNC:
4191 n = argvars[0].vval.v_string == NULL
4192 || *argvars[0].vval.v_string == NUL;
4193 break;
4194 case VAR_PARTIAL:
Yegappan Lakshmananda9d3452024-05-02 13:02:36 +02004195 n = argvars[0].vval.v_partial == NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004196 break;
4197 case VAR_NUMBER:
4198 n = argvars[0].vval.v_number == 0;
4199 break;
4200 case VAR_FLOAT:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004201 n = argvars[0].vval.v_float == 0.0;
4202 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004203 case VAR_LIST:
4204 n = argvars[0].vval.v_list == NULL
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004205 || argvars[0].vval.v_list->lv_len == 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004206 break;
4207 case VAR_DICT:
4208 n = argvars[0].vval.v_dict == NULL
4209 || argvars[0].vval.v_dict->dv_hashtab.ht_used == 0;
4210 break;
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01004211 case VAR_BOOL:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004212 case VAR_SPECIAL:
4213 n = argvars[0].vval.v_number != VVAL_TRUE;
4214 break;
Bram Moolenaar00b28d62022-12-08 15:32:33 +00004215 case VAR_CLASS:
4216 n = argvars[0].vval.v_class != NULL;
4217 break;
4218 case VAR_OBJECT:
Yegappan Lakshmanand3eae7b2024-03-03 16:26:58 +01004219 n = object_empty(argvars[0].vval.v_object);
Bram Moolenaar00b28d62022-12-08 15:32:33 +00004220 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004221
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01004222 case VAR_BLOB:
4223 n = argvars[0].vval.v_blob == NULL
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01004224 || argvars[0].vval.v_blob->bv_ga.ga_len == 0;
4225 break;
4226
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004227 case VAR_JOB:
4228#ifdef FEAT_JOB_CHANNEL
4229 n = argvars[0].vval.v_job == NULL
4230 || argvars[0].vval.v_job->jv_status != JOB_STARTED;
4231 break;
4232#endif
4233 case VAR_CHANNEL:
4234#ifdef FEAT_JOB_CHANNEL
4235 n = argvars[0].vval.v_channel == NULL
4236 || !channel_is_open(argvars[0].vval.v_channel);
4237 break;
4238#endif
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +02004239 case VAR_TYPEALIAS:
4240 n = argvars[0].vval.v_typealias == NULL
4241 || argvars[0].vval.v_typealias->ta_name == NULL
4242 || *argvars[0].vval.v_typealias->ta_name == NUL;
4243 break;
4244
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004245 case VAR_UNKNOWN:
Bram Moolenaar4c683752020-04-05 21:38:23 +02004246 case VAR_ANY:
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004247 case VAR_VOID:
Bram Moolenaarf18332f2021-05-07 17:55:55 +02004248 case VAR_INSTR:
Bram Moolenaardd589232020-02-29 17:38:12 +01004249 internal_error_no_abort("f_empty(UNKNOWN)");
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004250 n = TRUE;
4251 break;
4252 }
4253
4254 rettv->vval.v_number = n;
4255}
4256
4257/*
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004258 * "environ()" function
4259 */
4260 static void
4261f_environ(typval_T *argvars UNUSED, typval_T *rettv)
4262{
4263#if !defined(AMIGA)
4264 int i = 0;
4265 char_u *entry, *value;
Bram Moolenaar68aaff42022-04-17 10:57:44 +01004266# if defined (MSWIN)
4267# if !defined(_UCRT)
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004268 extern wchar_t **_wenviron;
Bram Moolenaar68aaff42022-04-17 10:57:44 +01004269# endif
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004270# else
4271 extern char **environ;
4272# endif
4273
Bram Moolenaar93a10962022-06-16 11:42:09 +01004274 if (rettv_dict_alloc(rettv) == FAIL)
Bram Moolenaar691ddee2019-05-09 14:52:41 +02004275 return;
4276
4277# ifdef MSWIN
4278 if (*_wenviron == NULL)
4279 return;
4280# else
4281 if (*environ == NULL)
4282 return;
4283# endif
4284
4285 for (i = 0; ; ++i)
4286 {
4287# ifdef MSWIN
4288 short_u *p;
4289
4290 if ((p = (short_u *)_wenviron[i]) == NULL)
4291 return;
4292 entry = utf16_to_enc(p, NULL);
4293# else
4294 if ((entry = (char_u *)environ[i]) == NULL)
4295 return;
4296 entry = vim_strsave(entry);
4297# endif
4298 if (entry == NULL) // out of memory
4299 return;
4300 if ((value = vim_strchr(entry, '=')) == NULL)
4301 {
4302 vim_free(entry);
4303 continue;
4304 }
4305 *value++ = NUL;
4306 dict_add_string(rettv->vval.v_dict, (char *)entry, value);
4307 vim_free(entry);
4308 }
4309#endif
4310}
4311
4312/*
Bram Moolenaar80adaa82023-07-07 18:57:40 +01004313 * "err_teapot()" function
4314 */
4315 static void
4316f_err_teapot(typval_T *argvars, typval_T *rettv UNUSED)
4317{
4318 if (argvars[0].v_type != VAR_UNKNOWN)
4319 {
4320 if (argvars[0].v_type == VAR_STRING)
4321 {
4322 char_u *s = tv_get_string_strict(&argvars[0]);
Sean Dewarb0efa492023-07-08 10:35:19 +01004323 if (*skipwhite(s) == NUL)
Bram Moolenaar80adaa82023-07-07 18:57:40 +01004324 return;
4325 }
4326
4327 int err = FALSE;
4328 int do_503 = eval_expr_to_bool(&argvars[0], &err);
4329 if (!err && do_503)
4330 {
4331 emsg(_(e_coffee_currently_not_available));
4332 return;
4333 }
4334 }
4335
4336 emsg(_(e_im_a_teapot));
4337}
4338
4339/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004340 * "escape({string}, {chars})" function
4341 */
4342 static void
4343f_escape(typval_T *argvars, typval_T *rettv)
4344{
4345 char_u buf[NUMBUFLEN];
4346
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004347 if (in_vim9script()
4348 && (check_for_string_arg(argvars, 0) == FAIL
4349 || check_for_string_arg(argvars, 1) == FAIL))
4350 return;
4351
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004352 rettv->vval.v_string = vim_strsave_escaped(tv_get_string(&argvars[0]),
4353 tv_get_string_buf(&argvars[1], buf));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004354 rettv->v_type = VAR_STRING;
4355}
4356
4357/*
4358 * "eval()" function
4359 */
4360 static void
4361f_eval(typval_T *argvars, typval_T *rettv)
4362{
4363 char_u *s, *p;
4364
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004365 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
4366 return;
4367
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004368 s = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004369 if (s != NULL)
4370 s = skipwhite(s);
4371
4372 p = s;
Bram Moolenaar5409f5d2020-06-24 18:37:35 +02004373 if (s == NULL || eval1(&s, rettv, &EVALARG_EVALUATE) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004374 {
4375 if (p != NULL && !aborting())
Bram Moolenaar108010a2021-06-27 22:03:33 +02004376 semsg(_(e_invalid_expression_str), p);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004377 need_clr_eos = FALSE;
4378 rettv->v_type = VAR_NUMBER;
4379 rettv->vval.v_number = 0;
4380 }
4381 else if (*s != NUL)
Bram Moolenaar74409f62022-01-01 15:58:22 +00004382 semsg(_(e_trailing_characters_str), s);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004383}
4384
4385/*
4386 * "eventhandler()" function
4387 */
4388 static void
4389f_eventhandler(typval_T *argvars UNUSED, typval_T *rettv)
4390{
Bram Moolenaardfc33a62020-04-29 22:30:13 +02004391 rettv->vval.v_number = vgetc_busy || input_busy;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004392}
4393
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004394static garray_T redir_execute_ga;
4395
4396/*
4397 * Append "value[value_len]" to the execute() output.
4398 */
4399 void
4400execute_redir_str(char_u *value, int value_len)
4401{
4402 int len;
4403
4404 if (value_len == -1)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004405 len = (int)STRLEN(value); // Append the entire string
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004406 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004407 len = value_len; // Append only "value_len" characters
Yegappan Lakshmananfadc02a2023-01-27 21:03:12 +00004408 if (ga_grow(&redir_execute_ga, len) == FAIL)
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00004409 return;
4410
4411 mch_memmove((char *)redir_execute_ga.ga_data
4412 + redir_execute_ga.ga_len, value, len);
4413 redir_execute_ga.ga_len += len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004414}
4415
Dominique Pelle748b3082022-01-08 12:41:16 +00004416#if defined(FEAT_LUA) || defined(PROTO)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004417/*
Yegappan Lakshmanan11328bc2021-08-06 21:34:38 +02004418 * Get next line from a string containing NL separated lines.
4419 * Called by do_cmdline() to get the next line.
4420 * Returns an allocated string, or NULL when at the end of the string.
4421 */
4422 static char_u *
4423get_str_line(
4424 int c UNUSED,
4425 void *cookie,
4426 int indent UNUSED,
4427 getline_opt_T options UNUSED)
4428{
4429 char_u *start = *(char_u **)cookie;
4430 char_u *line;
4431 char_u *p;
4432
4433 p = start;
4434 if (p == NULL || *p == NUL)
4435 return NULL;
4436 p = vim_strchr(p, '\n');
4437 if (p == NULL)
4438 line = vim_strsave(start);
4439 else
4440 {
4441 line = vim_strnsave(start, p - start);
4442 p++;
4443 }
4444
4445 *(char_u **)cookie = p;
4446 return line;
4447}
4448
4449/*
4450 * Execute a series of Ex commands in 'str'
4451 */
4452 void
4453execute_cmds_from_string(char_u *str)
4454{
4455 do_cmdline(NULL, get_str_line, (void *)&str,
4456 DOCMD_NOWAIT|DOCMD_VERBOSE|DOCMD_REPEAT|DOCMD_KEYTYPED);
4457}
Dominique Pelle748b3082022-01-08 12:41:16 +00004458#endif
Yegappan Lakshmanan11328bc2021-08-06 21:34:38 +02004459
4460/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004461 * Get next line from a list.
4462 * Called by do_cmdline() to get the next line.
4463 * Returns allocated string, or NULL for end of function.
4464 */
Bram Moolenaara7583c42022-05-07 21:14:05 +01004465 char_u *
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004466get_list_line(
4467 int c UNUSED,
4468 void *cookie,
Bram Moolenaare96a2492019-06-25 04:12:16 +02004469 int indent UNUSED,
Bram Moolenaar66250c92020-08-20 15:02:42 +02004470 getline_opt_T options UNUSED)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004471{
4472 listitem_T **p = (listitem_T **)cookie;
4473 listitem_T *item = *p;
4474 char_u buf[NUMBUFLEN];
4475 char_u *s;
4476
4477 if (item == NULL)
4478 return NULL;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004479 s = tv_get_string_buf_chk(&item->li_tv, buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004480 *p = item->li_next;
4481 return s == NULL ? NULL : vim_strsave(s);
4482}
4483
4484/*
4485 * "execute()" function
4486 */
Bram Moolenaar261f3462019-09-07 15:45:32 +02004487 void
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004488execute_common(typval_T *argvars, typval_T *rettv, int arg_off)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004489{
4490 char_u *cmd = NULL;
4491 list_T *list = NULL;
4492 int save_msg_silent = msg_silent;
4493 int save_emsg_silent = emsg_silent;
4494 int save_emsg_noredir = emsg_noredir;
4495 int save_redir_execute = redir_execute;
Bram Moolenaar20951482017-12-25 13:44:43 +01004496 int save_redir_off = redir_off;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004497 garray_T save_ga;
Bram Moolenaar10ccaa12018-12-07 16:38:23 +01004498 int save_msg_col = msg_col;
Kota Kato3d3f6ac2022-08-04 18:50:14 +01004499 int save_sticky_cmdmod_flags = sticky_cmdmod_flags;
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004500 int echo_output = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004501
4502 rettv->vval.v_string = NULL;
4503 rettv->v_type = VAR_STRING;
4504
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004505 if (argvars[arg_off].v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004506 {
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004507 list = argvars[arg_off].vval.v_list;
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004508 if (list == NULL || list->lv_len == 0)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004509 // empty list, no commands, empty output
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004510 return;
4511 ++list->lv_refcount;
4512 }
Bram Moolenaare2a8f072020-01-08 19:32:18 +01004513 else if (argvars[arg_off].v_type == VAR_JOB
4514 || argvars[arg_off].v_type == VAR_CHANNEL)
4515 {
Bram Moolenaar68db9962021-05-09 23:19:22 +02004516 semsg(_(e_using_invalid_value_as_string_str),
4517 vartype_name(argvars[arg_off].v_type));
Bram Moolenaare2a8f072020-01-08 19:32:18 +01004518 return;
4519 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004520 else
4521 {
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004522 cmd = tv_get_string_chk(&argvars[arg_off]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004523 if (cmd == NULL)
4524 return;
4525 }
4526
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004527 if (argvars[arg_off + 1].v_type != VAR_UNKNOWN)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004528 {
4529 char_u buf[NUMBUFLEN];
Bram Moolenaar3cfa5b12021-06-06 14:14:39 +02004530 char_u *s = tv_get_string_buf_chk_strict(&argvars[arg_off + 1], buf,
4531 in_vim9script());
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004532
4533 if (s == NULL)
4534 return;
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004535 if (*s == NUL)
4536 echo_output = TRUE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004537 if (STRNCMP(s, "silent", 6) == 0)
4538 ++msg_silent;
4539 if (STRCMP(s, "silent!") == 0)
4540 {
4541 emsg_silent = TRUE;
4542 emsg_noredir = TRUE;
4543 }
4544 }
4545 else
4546 ++msg_silent;
4547
4548 if (redir_execute)
4549 save_ga = redir_execute_ga;
Bram Moolenaar04935fb2022-01-08 16:19:22 +00004550 ga_init2(&redir_execute_ga, sizeof(char), 500);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004551 redir_execute = TRUE;
Bram Moolenaar20951482017-12-25 13:44:43 +01004552 redir_off = FALSE;
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004553 if (!echo_output)
4554 msg_col = 0; // prevent leading spaces
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004555
Kota Kato3d3f6ac2022-08-04 18:50:14 +01004556 // For "legacy call execute('cmd')" and "vim9cmd execute('cmd')" apply the
4557 // command modifiers to "cmd".
4558 sticky_cmdmod_flags = cmdmod.cmod_flags & (CMOD_LEGACY | CMOD_VIM9CMD);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004559 if (cmd != NULL)
4560 do_cmdline_cmd(cmd);
4561 else
4562 {
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004563 listitem_T *item;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004564
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02004565 CHECK_LIST_MATERIALIZE(list);
Bram Moolenaar50985eb2020-01-27 22:09:39 +01004566 item = list->lv_first;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004567 do_cmdline(NULL, get_list_line, (void *)&item,
4568 DOCMD_NOWAIT|DOCMD_VERBOSE|DOCMD_REPEAT|DOCMD_KEYTYPED);
4569 --list->lv_refcount;
4570 }
Kota Kato3d3f6ac2022-08-04 18:50:14 +01004571 sticky_cmdmod_flags = save_sticky_cmdmod_flags;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004572
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004573 // Need to append a NUL to the result.
Bram Moolenaard297f352017-01-29 20:31:21 +01004574 if (ga_grow(&redir_execute_ga, 1) == OK)
4575 {
4576 ((char *)redir_execute_ga.ga_data)[redir_execute_ga.ga_len] = NUL;
4577 rettv->vval.v_string = redir_execute_ga.ga_data;
4578 }
4579 else
4580 {
4581 ga_clear(&redir_execute_ga);
4582 rettv->vval.v_string = NULL;
4583 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004584 msg_silent = save_msg_silent;
4585 emsg_silent = save_emsg_silent;
4586 emsg_noredir = save_emsg_noredir;
4587
4588 redir_execute = save_redir_execute;
4589 if (redir_execute)
4590 redir_execute_ga = save_ga;
Bram Moolenaar20951482017-12-25 13:44:43 +01004591 redir_off = save_redir_off;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004592
Bram Moolenaar10ccaa12018-12-07 16:38:23 +01004593 // "silent reg" or "silent echo x" leaves msg_col somewhere in the line.
Bram Moolenaar446e7a32018-12-08 13:57:42 +01004594 if (echo_output)
4595 // When not working silently: put it in column zero. A following
4596 // "echon" will overwrite the message, unavoidably.
4597 msg_col = 0;
4598 else
4599 // When working silently: Put it back where it was, since nothing
4600 // should have been written.
4601 msg_col = save_msg_col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004602}
4603
4604/*
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004605 * "execute()" function
4606 */
4607 static void
4608f_execute(typval_T *argvars, typval_T *rettv)
4609{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004610 if (in_vim9script()
4611 && (check_for_string_or_list_arg(argvars, 0) == FAIL
4612 || check_for_opt_string_arg(argvars, 1) == FAIL))
4613 return;
4614
Bram Moolenaar868b7b62019-05-29 21:44:40 +02004615 execute_common(argvars, rettv, 0);
4616}
4617
4618/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004619 * "exists()" function
4620 */
Bram Moolenaarbb7ee7a2021-08-02 20:06:50 +02004621 void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004622f_exists(typval_T *argvars, typval_T *rettv)
4623{
4624 char_u *p;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004625 int n = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004626
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004627 if (in_vim9script() && check_for_nonempty_string_arg(argvars, 0) == FAIL)
4628 return;
4629
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004630 p = tv_get_string(&argvars[0]);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004631 if (*p == '$') // environment variable
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004632 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004633 // first try "normal" environment variables (fast)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004634 if (mch_getenv(p + 1) != NULL)
4635 n = TRUE;
4636 else
4637 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004638 // try expanding things like $VIM and ${HOME}
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004639 p = expand_env_save(p);
4640 if (p != NULL && *p != '$')
4641 n = TRUE;
4642 vim_free(p);
4643 }
4644 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004645 else if (*p == '&' || *p == '+') // option
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004646 {
Bram Moolenaar9a78e6d2020-07-01 18:29:55 +02004647 n = (eval_option(&p, NULL, TRUE) == OK);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004648 if (*skipwhite(p) != NUL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004649 n = FALSE; // trailing garbage
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004650 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004651 else if (*p == '*') // internal or user defined function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004652 {
Bram Moolenaarb54c3ff2016-07-31 14:11:58 +02004653 n = function_exists(p + 1, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004654 }
Bram Moolenaar15c47602020-03-26 22:16:48 +01004655 else if (*p == '?') // internal function only
4656 {
4657 n = has_internal_func_name(p + 1);
4658 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004659 else if (*p == ':')
4660 {
4661 n = cmd_exists(p + 1);
4662 }
4663 else if (*p == '#')
4664 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004665 if (p[1] == '#')
4666 n = autocmd_supported(p + 2);
4667 else
4668 n = au_exists(p + 1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004669 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004670 else // internal variable
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004671 {
Bram Moolenaarc6f9f732018-02-11 19:06:26 +01004672 n = var_exists(p);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004673 }
4674
4675 rettv->vval.v_number = n;
4676}
4677
Bram Moolenaar26735992021-08-08 14:43:22 +02004678 static void
4679f_exists_compiled(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
4680{
4681 emsg(_(e_exists_compiled_can_only_be_used_in_def_function));
4682}
4683
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004684/*
4685 * "expand()" function
4686 */
4687 static void
4688f_expand(typval_T *argvars, typval_T *rettv)
4689{
4690 char_u *s;
Mike Williams51024bb2024-05-30 07:46:30 +02004691 size_t len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004692 int options = WILD_SILENT|WILD_USE_NL|WILD_LIST_NOTFOUND;
4693 expand_T xpc;
4694 int error = FALSE;
4695 char_u *result;
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004696#ifdef BACKSLASH_IN_FILENAME
4697 char_u *p_csl_save = p_csl;
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004698#endif
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004699
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02004700 if (in_vim9script()
4701 && (check_for_string_arg(argvars, 0) == FAIL
4702 || check_for_opt_bool_arg(argvars, 1) == FAIL
4703 || (argvars[1].v_type != VAR_UNKNOWN
4704 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
4705 return;
4706
4707#ifdef BACKSLASH_IN_FILENAME
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004708 // avoid using 'completeslash' here
4709 p_csl = empty_option;
4710#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004711
4712 rettv->v_type = VAR_STRING;
4713 if (argvars[1].v_type != VAR_UNKNOWN
4714 && argvars[2].v_type != VAR_UNKNOWN
Bram Moolenaar551d25e2020-09-02 21:37:56 +02004715 && tv_get_bool_chk(&argvars[2], &error)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004716 && !error)
Bram Moolenaar45cf6e92017-04-30 20:25:19 +02004717 rettv_list_set(rettv, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004718
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004719 s = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004720 if (*s == '%' || *s == '#' || *s == '<')
4721 {
Bram Moolenaar57544522022-04-12 12:54:11 +01004722 char *errormsg = NULL;
4723
4724 if (p_verbose == 0)
4725 ++emsg_off;
Bram Moolenaara96edb72022-04-28 17:52:24 +01004726 result = eval_vars(s, s, &len, NULL, &errormsg, NULL, FALSE);
Bram Moolenaar57544522022-04-12 12:54:11 +01004727 if (p_verbose == 0)
4728 --emsg_off;
4729 else if (errormsg != NULL)
4730 emsg(errormsg);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004731 if (rettv->v_type == VAR_LIST)
4732 {
Bram Moolenaar93a10962022-06-16 11:42:09 +01004733 if (rettv_list_alloc(rettv) == OK && result != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004734 list_append_string(rettv->vval.v_list, result, -1);
Bram Moolenaar86173482019-10-01 17:02:16 +02004735 vim_free(result);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004736 }
4737 else
4738 rettv->vval.v_string = result;
4739 }
4740 else
4741 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004742 // When the optional second argument is non-zero, don't remove matches
4743 // for 'wildignore' and don't put matches for 'suffixes' at the end.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004744 if (argvars[1].v_type != VAR_UNKNOWN
Bram Moolenaar551d25e2020-09-02 21:37:56 +02004745 && tv_get_bool_chk(&argvars[1], &error))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004746 options |= WILD_KEEP_ALL;
4747 if (!error)
4748 {
4749 ExpandInit(&xpc);
4750 xpc.xp_context = EXPAND_FILES;
4751 if (p_wic)
4752 options += WILD_ICASE;
4753 if (rettv->v_type == VAR_STRING)
4754 rettv->vval.v_string = ExpandOne(&xpc, s, NULL,
4755 options, WILD_ALL);
Bram Moolenaar93a10962022-06-16 11:42:09 +01004756 else if (rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004757 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004758 ExpandOne(&xpc, s, NULL, options, WILD_ALL_KEEP);
Bram Moolenaar848db572022-09-20 19:04:32 +01004759 for (int i = 0; i < xpc.xp_numfiles; i++)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004760 list_append_string(rettv->vval.v_list, xpc.xp_files[i], -1);
4761 ExpandCleanup(&xpc);
4762 }
4763 }
4764 else
4765 rettv->vval.v_string = NULL;
4766 }
Bram Moolenaar8f187fc2020-09-26 18:47:11 +02004767#ifdef BACKSLASH_IN_FILENAME
4768 p_csl = p_csl_save;
4769#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004770}
4771
4772/*
Bram Moolenaar80dad482019-06-09 17:22:31 +02004773 * "expandcmd()" function
4774 * Expand all the special characters in a command string.
4775 */
4776 static void
4777f_expandcmd(typval_T *argvars, typval_T *rettv)
4778{
4779 exarg_T eap;
4780 char_u *cmdstr;
4781 char *errormsg = NULL;
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004782 int emsgoff = TRUE;
Bram Moolenaar80dad482019-06-09 17:22:31 +02004783
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004784 if (in_vim9script()
4785 && (check_for_string_arg(argvars, 0) == FAIL
4786 || check_for_opt_dict_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004787 return;
4788
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004789 if (argvars[1].v_type == VAR_DICT
Bram Moolenaard61efa52022-07-23 09:52:04 +01004790 && dict_get_bool(argvars[1].vval.v_dict, "errmsg", VVAL_FALSE))
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004791 emsgoff = FALSE;
4792
Bram Moolenaar80dad482019-06-09 17:22:31 +02004793 rettv->v_type = VAR_STRING;
4794 cmdstr = vim_strsave(tv_get_string(&argvars[0]));
4795
Yegappan Lakshmanan960dcbd2023-03-07 17:45:11 +00004796 CLEAR_FIELD(eap);
Bram Moolenaar80dad482019-06-09 17:22:31 +02004797 eap.cmd = cmdstr;
4798 eap.arg = cmdstr;
Bram Moolenaar8071cb22019-07-12 17:58:01 +02004799 eap.argt |= EX_NOSPC;
Bram Moolenaar80dad482019-06-09 17:22:31 +02004800 eap.usefilter = FALSE;
4801 eap.nextcmd = NULL;
4802 eap.cmdidx = CMD_USER;
4803
Yegappan Lakshmanan2b74b682022-04-03 21:30:32 +01004804 if (emsgoff)
4805 ++emsg_off;
4806 if (expand_filename(&eap, &cmdstr, &errormsg) == FAIL)
4807 if (!emsgoff && errormsg != NULL && *errormsg != NUL)
4808 emsg(errormsg);
4809 if (emsgoff)
4810 --emsg_off;
Bram Moolenaar80dad482019-06-09 17:22:31 +02004811
4812 rettv->vval.v_string = cmdstr;
4813}
4814
4815/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004816 * "feedkeys()" function
4817 */
4818 static void
4819f_feedkeys(typval_T *argvars, typval_T *rettv UNUSED)
4820{
4821 int remap = TRUE;
4822 int insert = FALSE;
4823 char_u *keys, *flags;
4824 char_u nbuf[NUMBUFLEN];
4825 int typed = FALSE;
4826 int execute = FALSE;
Bram Moolenaara9725222022-01-16 13:30:33 +00004827 int context = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004828 int dangerous = FALSE;
Bram Moolenaar5e66b422019-01-24 21:58:10 +01004829 int lowlevel = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004830
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01004831 // This is not allowed in the sandbox. If the commands would still be
4832 // executed in the sandbox it would be OK, but it probably happens later,
4833 // when "sandbox" is no longer set.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004834 if (check_secure())
4835 return;
4836
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004837 if (in_vim9script()
4838 && (check_for_string_arg(argvars, 0) == FAIL
4839 || check_for_opt_string_arg(argvars, 1) == FAIL))
4840 return;
4841
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004842 keys = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004843
4844 if (argvars[1].v_type != VAR_UNKNOWN)
4845 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01004846 flags = tv_get_string_buf(&argvars[1], nbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004847 for ( ; *flags != NUL; ++flags)
4848 {
4849 switch (*flags)
4850 {
4851 case 'n': remap = FALSE; break;
4852 case 'm': remap = TRUE; break;
4853 case 't': typed = TRUE; break;
4854 case 'i': insert = TRUE; break;
4855 case 'x': execute = TRUE; break;
Bram Moolenaara9725222022-01-16 13:30:33 +00004856 case 'c': context = TRUE; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004857 case '!': dangerous = TRUE; break;
Bram Moolenaar5e66b422019-01-24 21:58:10 +01004858 case 'L': lowlevel = TRUE; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004859 }
4860 }
4861 }
4862
4863 if (*keys != NUL || execute)
4864 {
Christopher Plewright20b795e2022-12-20 20:01:58 +00004865 if (lowlevel
4866#ifdef FEAT_VTP
4867 && (!is_term_win32()
4868 || (keys[0] == 3 && ctrl_c_interrupts && typed))
4869#endif
4870 )
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004871 {
Bram Moolenaar5e66b422019-01-24 21:58:10 +01004872#ifdef USE_INPUT_BUF
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004873 ch_log(NULL, "feedkeys() lowlevel: %s", keys);
Bram Moolenaar9645e2d2020-03-20 20:48:49 +01004874
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004875 int len = (int)STRLEN(keys);
4876 for (int idx = 0; idx < len; ++idx)
4877 {
4878 // if a CTRL-C was typed, set got_int, similar to what
4879 // happens in fill_input_buf()
4880 if (keys[idx] == 3 && ctrl_c_interrupts && typed)
4881 got_int = TRUE;
4882 add_to_input_buf(keys + idx, 1);
4883 }
Bram Moolenaar5e66b422019-01-24 21:58:10 +01004884#else
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004885 emsg(_(e_lowlevel_input_not_supported));
Bram Moolenaar5e66b422019-01-24 21:58:10 +01004886#endif
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004887 }
4888 else
4889 {
4890 // Need to escape K_SPECIAL and CSI before putting the string in
4891 // the typeahead buffer.
4892 char_u *keys_esc = vim_strsave_escape_csi(keys);
4893 if (keys_esc == NULL)
4894 return;
4895
4896 ch_log(NULL, "feedkeys(%s): %s", typed ? "typed" : "", keys);
4897
4898 ins_typebuf(keys_esc, (remap ? REMAP_YES : REMAP_NONE),
4899 insert ? 0 : typebuf.tb_len, !typed, FALSE);
4900 if (vgetc_busy
Bram Moolenaar5d7be4f2017-06-25 13:40:17 +02004901#ifdef FEAT_TIMERS
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004902 || timer_busy
Bram Moolenaar5d7be4f2017-06-25 13:40:17 +02004903#endif
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004904 || input_busy)
4905 typebuf_was_filled = TRUE;
4906
Bram Moolenaar8d4ce562019-01-30 22:01:40 +01004907 vim_free(keys_esc);
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004908 }
Bram Moolenaar8d4ce562019-01-30 22:01:40 +01004909
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004910 if (execute)
4911 {
4912 int save_msg_scroll = msg_scroll;
4913 sctx_T save_sctx;
4914
4915 // Avoid a 1 second delay when the keys start Insert mode.
4916 msg_scroll = FALSE;
4917
4918 ch_log(NULL, "feedkeys() executing");
4919
4920 if (context)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004921 {
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004922 save_sctx = current_sctx;
4923 current_sctx.sc_sid = 0;
4924 current_sctx.sc_version = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004925 }
Bram Moolenaarb55ae8c2022-12-02 13:37:36 +00004926
4927 if (!dangerous)
4928 {
4929 ++ex_normal_busy;
4930 ++in_feedkeys;
4931 }
4932 exec_normal(TRUE, lowlevel, TRUE);
4933 if (!dangerous)
4934 {
4935 --ex_normal_busy;
4936 --in_feedkeys;
4937 }
4938
4939 msg_scroll |= save_msg_scroll;
4940
4941 if (context)
4942 current_sctx = save_sctx;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004943 }
4944 }
4945}
4946
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004947/*
4948 * "fnameescape({string})" function
4949 */
4950 static void
4951f_fnameescape(typval_T *argvars, typval_T *rettv)
4952{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02004953 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
4954 return;
4955
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004956 rettv->vval.v_string = vim_strsave_fnameescape(
Bram Moolenaar21c1a0c2021-10-17 17:20:23 +01004957 tv_get_string(&argvars[0]), VSE_NONE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004958 rettv->v_type = VAR_STRING;
4959}
4960
4961/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004962 * "foreground()" function
4963 */
4964 static void
4965f_foreground(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
4966{
4967#ifdef FEAT_GUI
4968 if (gui.in_use)
Bram Moolenaarafde13b2019-04-28 19:46:49 +02004969 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004970 gui_mch_set_foreground();
Bram Moolenaarafde13b2019-04-28 19:46:49 +02004971 return;
4972 }
4973#endif
4974#if defined(MSWIN) && (!defined(FEAT_GUI) || defined(VIMDLL))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004975 win32_set_foreground();
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004976#endif
4977}
4978
Bakudankun375141e2022-09-09 18:46:47 +01004979/*
4980 * "function()" function
4981 * "funcref()" function
4982 */
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004983 static void
Bram Moolenaar437bafe2016-08-01 15:40:54 +02004984common_function(typval_T *argvars, typval_T *rettv, int is_funcref)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004985{
4986 char_u *s;
4987 char_u *name;
4988 int use_string = FALSE;
4989 partial_T *arg_pt = NULL;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02004990 char_u *trans_name = NULL;
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02004991 int is_global = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02004992
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02004993 if (in_vim9script()
Bram Moolenaarae1068a2021-12-25 19:43:44 +00004994 && (check_for_string_or_func_arg(argvars, 0) == FAIL
4995 || check_for_opt_list_arg(argvars, 1) == FAIL
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02004996 || (argvars[1].v_type != VAR_UNKNOWN
4997 && check_for_opt_dict_arg(argvars, 2) == FAIL)))
4998 return;
4999
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005000 if (argvars[0].v_type == VAR_FUNC)
5001 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005002 // function(MyFunc, [arg], dict)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005003 s = argvars[0].vval.v_string;
5004 }
5005 else if (argvars[0].v_type == VAR_PARTIAL
5006 && argvars[0].vval.v_partial != NULL)
5007 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005008 // function(dict.MyFunc, [arg])
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005009 arg_pt = argvars[0].vval.v_partial;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005010 s = partial_name(arg_pt);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005011 }
5012 else
5013 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005014 // function('MyFunc', [arg], dict)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005015 s = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005016 use_string = TRUE;
5017 }
Bram Moolenaar60b6e6f2021-08-28 12:49:27 +02005018 if (s == NULL)
5019 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00005020 semsg(_(e_invalid_argument_str), "NULL");
Bram Moolenaar60b6e6f2021-08-28 12:49:27 +02005021 return;
5022 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005023
Bram Moolenaar843b8842016-08-21 14:36:15 +02005024 if ((use_string && vim_strchr(s, AUTOLOAD_CHAR) == NULL) || is_funcref)
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005025 {
5026 name = s;
Bram Moolenaareba3b7f2021-11-30 18:25:08 +00005027 trans_name = save_function_name(&name, &is_global, FALSE,
5028 TFN_INT | TFN_QUIET | TFN_NO_AUTOLOAD | TFN_NO_DEREF, NULL);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005029 if (*name != NUL)
5030 s = NULL;
5031 }
5032
Bram Moolenaar843b8842016-08-21 14:36:15 +02005033 if (s == NULL || *s == NUL || (use_string && VIM_ISDIGIT(*s))
5034 || (is_funcref && trans_name == NULL))
Yegappan Lakshmanan655b7342022-03-06 14:27:10 +00005035 semsg(_(e_invalid_argument_str),
5036 use_string ? tv_get_string(&argvars[0]) : s);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005037 // Don't check an autoload name for existence here.
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005038 else if (trans_name != NULL && (is_funcref
Bram Moolenaard9d2fd02022-01-13 21:15:21 +00005039 ? find_func(trans_name, is_global) == NULL
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02005040 : !translated_function_exists(trans_name, is_global)))
Bram Moolenaara6f79292022-01-04 21:30:47 +00005041 semsg(_(e_unknown_function_str_2), s);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005042 else
5043 {
5044 int dict_idx = 0;
5045 int arg_idx = 0;
5046 list_T *list = NULL;
5047
5048 if (STRNCMP(s, "s:", 2) == 0 || STRNCMP(s, "<SID>", 5) == 0)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005049 // Expand s: and <SID> into <SNR>nr_, so that the function can
5050 // also be called from another script. Using trans_function_name()
5051 // would also work, but some plugins depend on the name being
5052 // printable text.
Yegappan Lakshmanane7f4abd2021-12-24 20:47:38 +00005053 name = get_scriptlocal_funcname(s);
Bram Moolenaarc2f17f72022-02-21 13:13:50 +00005054 else if (trans_name != NULL && *trans_name == K_SPECIAL)
5055 name = alloc_printable_func_name(trans_name);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005056 else
5057 name = vim_strsave(s);
5058
5059 if (argvars[1].v_type != VAR_UNKNOWN)
5060 {
5061 if (argvars[2].v_type != VAR_UNKNOWN)
5062 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005063 // function(name, [args], dict)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005064 arg_idx = 1;
5065 dict_idx = 2;
5066 }
5067 else if (argvars[1].v_type == VAR_DICT)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005068 // function(name, dict)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005069 dict_idx = 1;
5070 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005071 // function(name, [args])
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005072 arg_idx = 1;
5073 if (dict_idx > 0)
5074 {
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +01005075 if (check_for_dict_arg(argvars, dict_idx) == FAIL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005076 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005077 vim_free(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005078 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005079 }
5080 if (argvars[dict_idx].vval.v_dict == NULL)
5081 dict_idx = 0;
5082 }
5083 if (arg_idx > 0)
5084 {
5085 if (argvars[arg_idx].v_type != VAR_LIST)
5086 {
Bram Moolenaard82a47d2022-01-05 20:24:39 +00005087 emsg(_(e_second_argument_of_function_must_be_list_or_dict));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005088 vim_free(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005089 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005090 }
5091 list = argvars[arg_idx].vval.v_list;
5092 if (list == NULL || list->lv_len == 0)
5093 arg_idx = 0;
Bram Moolenaar4c054e92019-11-10 00:13:50 +01005094 else if (list->lv_len > MAX_FUNC_ARGS)
5095 {
Yegappan Lakshmanan5018a832022-04-02 21:12:21 +01005096 emsg_funcname(e_too_many_arguments_for_function_str, s);
Bram Moolenaar4c054e92019-11-10 00:13:50 +01005097 vim_free(name);
5098 goto theend;
5099 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005100 }
5101 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005102 if (dict_idx > 0 || arg_idx > 0 || arg_pt != NULL || is_funcref)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005103 {
Bram Moolenaarc799fe22019-05-28 23:08:19 +02005104 partial_T *pt = ALLOC_CLEAR_ONE(partial_T);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005105
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005106 // result is a VAR_PARTIAL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005107 if (pt == NULL)
5108 vim_free(name);
5109 else
5110 {
5111 if (arg_idx > 0 || (arg_pt != NULL && arg_pt->pt_argc > 0))
5112 {
5113 listitem_T *li;
5114 int i = 0;
5115 int arg_len = 0;
5116 int lv_len = 0;
5117
5118 if (arg_pt != NULL)
5119 arg_len = arg_pt->pt_argc;
5120 if (list != NULL)
5121 lv_len = list->lv_len;
5122 pt->pt_argc = arg_len + lv_len;
Bram Moolenaarc799fe22019-05-28 23:08:19 +02005123 pt->pt_argv = ALLOC_MULT(typval_T, pt->pt_argc);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005124 if (pt->pt_argv == NULL)
5125 {
5126 vim_free(pt);
5127 vim_free(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005128 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005129 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005130 for (i = 0; i < arg_len; i++)
5131 copy_tv(&arg_pt->pt_argv[i], &pt->pt_argv[i]);
5132 if (lv_len > 0)
Bram Moolenaar50985eb2020-01-27 22:09:39 +01005133 {
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02005134 CHECK_LIST_MATERIALIZE(list);
Bram Moolenaaraeea7212020-04-02 18:50:46 +02005135 FOR_ALL_LIST_ITEMS(list, li)
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005136 copy_tv(&li->li_tv, &pt->pt_argv[i++]);
Bram Moolenaar50985eb2020-01-27 22:09:39 +01005137 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005138 }
5139
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005140 // For "function(dict.func, [], dict)" and "func" is a partial
5141 // use "dict". That is backwards compatible.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005142 if (dict_idx > 0)
5143 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005144 // The dict is bound explicitly, pt_auto is FALSE.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005145 pt->pt_dict = argvars[dict_idx].vval.v_dict;
5146 ++pt->pt_dict->dv_refcount;
5147 }
5148 else if (arg_pt != NULL)
5149 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005150 // If the dict was bound automatically the result is also
5151 // bound automatically.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005152 pt->pt_dict = arg_pt->pt_dict;
5153 pt->pt_auto = arg_pt->pt_auto;
5154 if (pt->pt_dict != NULL)
5155 ++pt->pt_dict->dv_refcount;
Yegappan Lakshmanan29bb67f2023-10-14 11:18:50 +02005156 pt->pt_obj = arg_pt->pt_obj;
5157 if (pt->pt_obj != NULL)
5158 ++pt->pt_obj->obj_refcount;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005159 }
5160
5161 pt->pt_refcount = 1;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005162 if (arg_pt != NULL && arg_pt->pt_func != NULL)
5163 {
5164 pt->pt_func = arg_pt->pt_func;
5165 func_ptr_ref(pt->pt_func);
5166 vim_free(name);
5167 }
5168 else if (is_funcref)
5169 {
Bram Moolenaard9d2fd02022-01-13 21:15:21 +00005170 pt->pt_func = find_func(trans_name, is_global);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005171 func_ptr_ref(pt->pt_func);
5172 vim_free(name);
5173 }
5174 else
5175 {
5176 pt->pt_name = name;
5177 func_ref(name);
5178 }
Bram Moolenaar92368aa2022-02-07 17:50:39 +00005179
5180 if (arg_pt != NULL)
Bram Moolenaar7aca5ca2022-02-07 19:56:43 +00005181 {
5182 pt->pt_outer_partial = arg_pt;
5183 ++arg_pt->pt_refcount;
5184 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005185 }
5186 rettv->v_type = VAR_PARTIAL;
5187 rettv->vval.v_partial = pt;
5188 }
5189 else
5190 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005191 // result is a VAR_FUNC
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005192 rettv->v_type = VAR_FUNC;
5193 rettv->vval.v_string = name;
5194 func_ref(name);
5195 }
5196 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005197theend:
5198 vim_free(trans_name);
5199}
5200
5201/*
5202 * "funcref()" function
5203 */
5204 static void
5205f_funcref(typval_T *argvars, typval_T *rettv)
5206{
5207 common_function(argvars, rettv, TRUE);
5208}
5209
5210/*
5211 * "function()" function
5212 */
5213 static void
5214f_function(typval_T *argvars, typval_T *rettv)
5215{
5216 common_function(argvars, rettv, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005217}
5218
5219/*
5220 * "garbagecollect()" function
5221 */
5222 static void
5223f_garbagecollect(typval_T *argvars, typval_T *rettv UNUSED)
5224{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005225 if (in_vim9script() && check_for_opt_bool_arg(argvars, 0) == FAIL)
5226 return;
5227
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005228 // This is postponed until we are back at the toplevel, because we may be
5229 // using Lists and Dicts internally. E.g.: ":echo [garbagecollect()]".
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005230 want_garbage_collect = TRUE;
5231
Bram Moolenaar2df47312020-09-05 17:30:44 +02005232 if (argvars[0].v_type != VAR_UNKNOWN && tv_get_bool(&argvars[0]) == 1)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005233 garbage_collect_at_exit = TRUE;
5234}
5235
5236/*
5237 * "get()" function
5238 */
5239 static void
5240f_get(typval_T *argvars, typval_T *rettv)
5241{
5242 listitem_T *li;
5243 list_T *l;
5244 dictitem_T *di;
5245 dict_T *d;
5246 typval_T *tv = NULL;
Bram Moolenaarf91aac52019-07-28 13:21:01 +02005247 int what_is_dict = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005248
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005249 if (argvars[0].v_type == VAR_BLOB)
5250 {
5251 int error = FALSE;
5252 int idx = tv_get_number_chk(&argvars[1], &error);
5253
5254 if (!error)
5255 {
5256 rettv->v_type = VAR_NUMBER;
Bram Moolenaar2ea773b2019-01-15 22:16:42 +01005257 if (idx < 0)
5258 idx = blob_len(argvars[0].vval.v_blob) + idx;
5259 if (idx < 0 || idx >= blob_len(argvars[0].vval.v_blob))
5260 rettv->vval.v_number = -1;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005261 else
Bram Moolenaar2ea773b2019-01-15 22:16:42 +01005262 {
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005263 rettv->vval.v_number = blob_get(argvars[0].vval.v_blob, idx);
Bram Moolenaar2ea773b2019-01-15 22:16:42 +01005264 tv = rettv;
5265 }
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01005266 }
5267 }
5268 else if (argvars[0].v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005269 {
5270 if ((l = argvars[0].vval.v_list) != NULL)
5271 {
5272 int error = FALSE;
5273
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005274 li = list_find(l, (long)tv_get_number_chk(&argvars[1], &error));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005275 if (!error && li != NULL)
5276 tv = &li->li_tv;
5277 }
5278 }
5279 else if (argvars[0].v_type == VAR_DICT)
5280 {
5281 if ((d = argvars[0].vval.v_dict) != NULL)
5282 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005283 di = dict_find(d, tv_get_string(&argvars[1]), -1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005284 if (di != NULL)
5285 tv = &di->di_tv;
5286 }
5287 }
5288 else if (argvars[0].v_type == VAR_PARTIAL || argvars[0].v_type == VAR_FUNC)
5289 {
5290 partial_T *pt;
5291 partial_T fref_pt;
5292
5293 if (argvars[0].v_type == VAR_PARTIAL)
5294 pt = argvars[0].vval.v_partial;
5295 else
5296 {
Bram Moolenaara80faa82020-04-12 19:37:17 +02005297 CLEAR_FIELD(fref_pt);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005298 fref_pt.pt_name = argvars[0].vval.v_string;
5299 pt = &fref_pt;
5300 }
5301
5302 if (pt != NULL)
5303 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005304 char_u *what = tv_get_string(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005305
5306 if (STRCMP(what, "func") == 0 || STRCMP(what, "name") == 0)
5307 {
Bram Moolenaar1ae8c262022-06-27 11:45:52 +01005308 char_u *name = partial_name(pt);
5309
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005310 rettv->v_type = (*what == 'f' ? VAR_FUNC : VAR_STRING);
Bram Moolenaar1ae8c262022-06-27 11:45:52 +01005311 if (name == NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005312 rettv->vval.v_string = NULL;
5313 else
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005314 {
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005315 if (rettv->v_type == VAR_FUNC)
Bram Moolenaar1ae8c262022-06-27 11:45:52 +01005316 func_ref(name);
5317 if (*what == 'n' && pt->pt_name == NULL
5318 && pt->pt_func != NULL)
5319 // use <SNR> instead of the byte code
5320 name = printable_func_name(pt->pt_func);
5321 rettv->vval.v_string = vim_strsave(name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005322 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005323 }
5324 else if (STRCMP(what, "dict") == 0)
Bram Moolenaarf91aac52019-07-28 13:21:01 +02005325 {
5326 what_is_dict = TRUE;
5327 if (pt->pt_dict != NULL)
5328 rettv_dict_set(rettv, pt->pt_dict);
5329 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005330 else if (STRCMP(what, "args") == 0)
5331 {
5332 rettv->v_type = VAR_LIST;
5333 if (rettv_list_alloc(rettv) == OK)
5334 {
5335 int i;
5336
5337 for (i = 0; i < pt->pt_argc; ++i)
5338 list_append_tv(rettv->vval.v_list, &pt->pt_argv[i]);
5339 }
5340 }
LemonBoy48b7d052024-07-09 18:24:59 +02005341 else if (STRCMP(what, "arity") == 0)
5342 {
5343 int required = 0, optional = 0, varargs = FALSE;
5344 char_u *name = partial_name(pt);
5345
5346 get_func_arity(name, &required, &optional, &varargs);
5347
5348 rettv->v_type = VAR_DICT;
5349 if (rettv_dict_alloc(rettv) == OK)
5350 {
5351 dict_T *dict = rettv->vval.v_dict;
5352
5353 // Take into account the arguments of the partial, if any.
5354 // Note that it is possible to supply more arguments than the function
5355 // accepts.
5356 if (pt->pt_argc >= required + optional)
5357 required = optional = 0;
5358 else if (pt->pt_argc > required)
5359 {
5360 optional -= pt->pt_argc - required;
5361 required = 0;
5362 }
5363 else
5364 required -= pt->pt_argc;
5365
5366 dict_add_number(dict, "required", required);
5367 dict_add_number(dict, "optional", optional);
5368 dict_add_bool(dict, "varargs", varargs);
5369 }
5370 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005371 else
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00005372 semsg(_(e_invalid_argument_str), what);
Bram Moolenaarf91aac52019-07-28 13:21:01 +02005373
5374 // When {what} == "dict" and pt->pt_dict == NULL, evaluate the
5375 // third argument
5376 if (!what_is_dict)
5377 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005378 }
5379 }
5380 else
Bram Moolenaar460ae5d2022-01-01 14:19:49 +00005381 semsg(_(e_argument_of_str_must_be_list_dictionary_or_blob), "get()");
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005382
5383 if (tv == NULL)
5384 {
5385 if (argvars[2].v_type != VAR_UNKNOWN)
5386 copy_tv(&argvars[2], rettv);
5387 }
5388 else
5389 copy_tv(tv, rettv);
5390}
5391
Bram Moolenaarb5ae48e2016-08-12 22:23:25 +02005392/*
mikoto2000a73dfc22024-11-18 21:12:21 +01005393 * "getcellpixels()" function
5394 */
5395 static void
5396f_getcellpixels(typval_T *argvars UNUSED, typval_T *rettv)
5397{
5398 if (rettv_list_alloc(rettv) == FAIL)
5399 return;
5400
5401#if defined(FEAT_GUI)
5402 if (gui.in_use)
5403 {
5404 // success pixel size and no gui.
5405 list_append_number(rettv->vval.v_list, (varnumber_T)gui.char_width);
5406 list_append_number(rettv->vval.v_list, (varnumber_T)gui.char_height);
5407 }
5408 else
5409#endif
5410 {
5411 struct cellsize cs;
5412#if defined(UNIX)
5413 mch_calc_cell_size(&cs);
5414#else
5415 // Non-Unix CUIs are not supported, so set this to -1x-1.
5416 cs.cs_xpixel = -1;
5417 cs.cs_ypixel = -1;
5418#endif
5419
5420 // failed get pixel size.
5421 if (cs.cs_xpixel == -1)
5422 return;
5423
5424 // success pixel size and no gui.
5425 list_append_number(rettv->vval.v_list, (varnumber_T)cs.cs_xpixel);
5426 list_append_number(rettv->vval.v_list, (varnumber_T)cs.cs_ypixel);
5427 }
5428
5429}
5430
5431/*
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005432 * "getchangelist()" function
5433 */
5434 static void
5435f_getchangelist(typval_T *argvars, typval_T *rettv)
5436{
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005437 buf_T *buf;
5438 int i;
5439 list_T *l;
5440 dict_T *d;
LemonBoydb0ea7f2022-04-10 17:59:26 +01005441 int changelistindex;
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005442
Bram Moolenaar93a10962022-06-16 11:42:09 +01005443 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005444 return;
5445
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005446 if (in_vim9script() && check_for_opt_buffer_arg(argvars, 0) == FAIL)
5447 return;
5448
Bram Moolenaar4c313b12019-08-24 22:58:31 +02005449 if (argvars[0].v_type == VAR_UNKNOWN)
5450 buf = curbuf;
5451 else
Bram Moolenaara5d38412020-09-02 21:02:35 +02005452 buf = tv_get_buf_from_arg(&argvars[0]);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005453 if (buf == NULL)
5454 return;
5455
5456 l = list_alloc();
5457 if (l == NULL)
5458 return;
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005459 if (list_append_list(rettv->vval.v_list, l) == FAIL)
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005460 {
5461 vim_free(l);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005462 return;
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005463 }
5464
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005465 /*
LemonBoydb0ea7f2022-04-10 17:59:26 +01005466 * The current window change list index tracks only the position for the
5467 * current buffer. For other buffers use the stored index for the current
5468 * window, or, if that's not available, the change list length.
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005469 */
LemonBoydb0ea7f2022-04-10 17:59:26 +01005470 if (buf == curwin->w_buffer)
5471 {
5472 changelistindex = curwin->w_changelistidx;
5473 }
5474 else
5475 {
5476 wininfo_T *wip;
5477
5478 FOR_ALL_BUF_WININFO(buf, wip)
5479 if (wip->wi_win == curwin)
5480 break;
5481 changelistindex = wip != NULL ? wip->wi_changelistidx
5482 : buf->b_changelistlen;
5483 }
5484 list_append_number(rettv->vval.v_list, (varnumber_T)changelistindex);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005485
5486 for (i = 0; i < buf->b_changelistlen; ++i)
5487 {
5488 if (buf->b_changelist[i].lnum == 0)
5489 continue;
5490 if ((d = dict_alloc()) == NULL)
5491 return;
5492 if (list_append_dict(l, d) == FAIL)
5493 return;
Bram Moolenaare0be1672018-07-08 16:50:37 +02005494 dict_add_number(d, "lnum", (long)buf->b_changelist[i].lnum);
5495 dict_add_number(d, "col", (long)buf->b_changelist[i].col);
Bram Moolenaare0be1672018-07-08 16:50:37 +02005496 dict_add_number(d, "coladd", (long)buf->b_changelist[i].coladd);
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005497 }
Bram Moolenaar07ad8162018-02-13 13:59:59 +01005498}
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005499
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005500 static void
5501getpos_both(
5502 typval_T *argvars,
5503 typval_T *rettv,
5504 int getcurpos,
5505 int charcol)
5506{
5507 pos_T *fp = NULL;
5508 pos_T pos;
5509 win_T *wp = curwin;
5510 list_T *l;
5511 int fnum = -1;
5512
5513 if (rettv_list_alloc(rettv) == OK)
5514 {
5515 l = rettv->vval.v_list;
5516 if (getcurpos)
5517 {
5518 if (argvars[0].v_type != VAR_UNKNOWN)
5519 {
5520 wp = find_win_by_nr_or_id(&argvars[0]);
5521 if (wp != NULL)
5522 fp = &wp->w_cursor;
5523 }
5524 else
5525 fp = &curwin->w_cursor;
5526 if (fp != NULL && charcol)
5527 {
5528 pos = *fp;
Bram Moolenaar91458462021-01-13 20:08:38 +01005529 pos.col =
5530 buf_byteidx_to_charidx(wp->w_buffer, pos.lnum, pos.col);
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005531 fp = &pos;
5532 }
5533 }
5534 else
5535 fp = var2fpos(&argvars[0], TRUE, &fnum, charcol);
5536 if (fnum != -1)
5537 list_append_number(l, (varnumber_T)fnum);
5538 else
5539 list_append_number(l, (varnumber_T)0);
5540 list_append_number(l, (fp != NULL) ? (varnumber_T)fp->lnum
5541 : (varnumber_T)0);
5542 list_append_number(l, (fp != NULL)
5543 ? (varnumber_T)(fp->col == MAXCOL ? MAXCOL : fp->col + 1)
5544 : (varnumber_T)0);
5545 list_append_number(l, (fp != NULL) ? (varnumber_T)fp->coladd :
5546 (varnumber_T)0);
5547 if (getcurpos)
5548 {
5549 int save_set_curswant = curwin->w_set_curswant;
5550 colnr_T save_curswant = curwin->w_curswant;
5551 colnr_T save_virtcol = curwin->w_virtcol;
5552
5553 if (wp == curwin)
5554 update_curswant();
5555 list_append_number(l, wp == NULL ? 0 : wp->w_curswant == MAXCOL
5556 ? (varnumber_T)MAXCOL : (varnumber_T)wp->w_curswant + 1);
5557
5558 // Do not change "curswant", as it is unexpected that a get
5559 // function has a side effect.
5560 if (wp == curwin && save_set_curswant)
5561 {
5562 curwin->w_set_curswant = save_set_curswant;
5563 curwin->w_curswant = save_curswant;
5564 curwin->w_virtcol = save_virtcol;
5565 curwin->w_valid &= ~VALID_VIRTCOL;
5566 }
5567 }
5568 }
5569 else
5570 rettv->vval.v_number = FALSE;
5571}
5572
5573/*
5574 * "getcharpos()" function
5575 */
5576 static void
5577f_getcharpos(typval_T *argvars UNUSED, typval_T *rettv)
5578{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005579 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5580 return;
5581
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005582 getpos_both(argvars, rettv, FALSE, TRUE);
5583}
5584
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005585/*
5586 * "getcharsearch()" function
5587 */
5588 static void
5589f_getcharsearch(typval_T *argvars UNUSED, typval_T *rettv)
5590{
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00005591 if (rettv_dict_alloc(rettv) != OK)
5592 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005593
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00005594 dict_T *dict = rettv->vval.v_dict;
5595
5596 dict_add_string(dict, "char", last_csearch());
5597 dict_add_number(dict, "forward", last_csearch_forward());
5598 dict_add_number(dict, "until", last_csearch_until());
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005599}
5600
5601/*
Bram Moolenaar691ddee2019-05-09 14:52:41 +02005602 * "getenv()" function
5603 */
5604 static void
5605f_getenv(typval_T *argvars, typval_T *rettv)
5606{
5607 int mustfree = FALSE;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005608 char_u *p;
Bram Moolenaar691ddee2019-05-09 14:52:41 +02005609
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005610 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5611 return;
5612
5613 p = vim_getenv(tv_get_string(&argvars[0]), &mustfree);
Bram Moolenaar691ddee2019-05-09 14:52:41 +02005614 if (p == NULL)
5615 {
5616 rettv->v_type = VAR_SPECIAL;
5617 rettv->vval.v_number = VVAL_NULL;
5618 return;
5619 }
5620 if (!mustfree)
5621 p = vim_strsave(p);
5622 rettv->vval.v_string = p;
5623 rettv->v_type = VAR_STRING;
5624}
5625
5626/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005627 * "getfontname()" function
5628 */
5629 static void
5630f_getfontname(typval_T *argvars UNUSED, typval_T *rettv)
5631{
5632 rettv->v_type = VAR_STRING;
5633 rettv->vval.v_string = NULL;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005634
5635 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
5636 return;
5637
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005638#ifdef FEAT_GUI
5639 if (gui.in_use)
5640 {
5641 GuiFont font;
5642 char_u *name = NULL;
5643
5644 if (argvars[0].v_type == VAR_UNKNOWN)
5645 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005646 // Get the "Normal" font. Either the name saved by
5647 // hl_set_font_name() or from the font ID.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005648 font = gui.norm_font;
5649 name = hl_get_font_name();
5650 }
5651 else
5652 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01005653 name = tv_get_string(&argvars[0]);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005654 if (STRCMP(name, "*") == 0) // don't use font dialog
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005655 return;
5656 font = gui_mch_get_font(name, FALSE);
5657 if (font == NOFONT)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01005658 return; // Invalid font name, return empty string.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005659 }
5660 rettv->vval.v_string = gui_mch_get_fontname(font, name);
5661 if (argvars[0].v_type != VAR_UNKNOWN)
5662 gui_mch_free_font(font);
5663 }
5664#endif
5665}
5666
5667/*
Bram Moolenaar4f505882018-02-10 21:06:32 +01005668 * "getjumplist()" function
5669 */
5670 static void
5671f_getjumplist(typval_T *argvars, typval_T *rettv)
5672{
Bram Moolenaar4f505882018-02-10 21:06:32 +01005673 win_T *wp;
5674 int i;
5675 list_T *l;
5676 dict_T *d;
Bram Moolenaar4f505882018-02-10 21:06:32 +01005677
Bram Moolenaar93a10962022-06-16 11:42:09 +01005678 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar4f505882018-02-10 21:06:32 +01005679 return;
5680
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005681 if (in_vim9script()
5682 && (check_for_opt_number_arg(argvars, 0) == FAIL
5683 || (argvars[0].v_type != VAR_UNKNOWN
5684 && check_for_opt_number_arg(argvars, 1) == FAIL)))
5685 return;
5686
Bram Moolenaar00aa0692019-04-27 20:37:57 +02005687 wp = find_tabwin(&argvars[0], &argvars[1], NULL);
Bram Moolenaar4f505882018-02-10 21:06:32 +01005688 if (wp == NULL)
5689 return;
5690
Bram Moolenaar57ee2b62019-02-12 22:15:06 +01005691 cleanup_jumplist(wp, TRUE);
5692
Bram Moolenaar4f505882018-02-10 21:06:32 +01005693 l = list_alloc();
5694 if (l == NULL)
5695 return;
Bram Moolenaar4f505882018-02-10 21:06:32 +01005696 if (list_append_list(rettv->vval.v_list, l) == FAIL)
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005697 {
5698 vim_free(l);
Bram Moolenaar4f505882018-02-10 21:06:32 +01005699 return;
Bram Moolenaar9ba61942022-08-31 11:25:06 +01005700 }
5701
Bram Moolenaar4f505882018-02-10 21:06:32 +01005702 list_append_number(rettv->vval.v_list, (varnumber_T)wp->w_jumplistidx);
5703
5704 for (i = 0; i < wp->w_jumplistlen; ++i)
5705 {
Bram Moolenaara7e18d22018-02-11 14:29:49 +01005706 if (wp->w_jumplist[i].fmark.mark.lnum == 0)
5707 continue;
Bram Moolenaar4f505882018-02-10 21:06:32 +01005708 if ((d = dict_alloc()) == NULL)
5709 return;
5710 if (list_append_dict(l, d) == FAIL)
5711 return;
Bram Moolenaare0be1672018-07-08 16:50:37 +02005712 dict_add_number(d, "lnum", (long)wp->w_jumplist[i].fmark.mark.lnum);
5713 dict_add_number(d, "col", (long)wp->w_jumplist[i].fmark.mark.col);
Bram Moolenaare0be1672018-07-08 16:50:37 +02005714 dict_add_number(d, "coladd", (long)wp->w_jumplist[i].fmark.mark.coladd);
Bram Moolenaare0be1672018-07-08 16:50:37 +02005715 dict_add_number(d, "bufnr", (long)wp->w_jumplist[i].fmark.fnum);
Bram Moolenaara7e18d22018-02-11 14:29:49 +01005716 if (wp->w_jumplist[i].fname != NULL)
Bram Moolenaare0be1672018-07-08 16:50:37 +02005717 dict_add_string(d, "filename", wp->w_jumplist[i].fname);
Bram Moolenaar4f505882018-02-10 21:06:32 +01005718 }
Bram Moolenaar4f505882018-02-10 21:06:32 +01005719}
5720
5721/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005722 * "getpid()" function
5723 */
5724 static void
5725f_getpid(typval_T *argvars UNUSED, typval_T *rettv)
5726{
5727 rettv->vval.v_number = mch_get_pid();
5728}
5729
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005730/*
5731 * "getcurpos()" function
5732 */
5733 static void
5734f_getcurpos(typval_T *argvars, typval_T *rettv)
5735{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005736 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
5737 return;
5738
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005739 getpos_both(argvars, rettv, TRUE, FALSE);
5740}
5741
5742 static void
5743f_getcursorcharpos(typval_T *argvars, typval_T *rettv)
5744{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005745 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
5746 return;
5747
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005748 getpos_both(argvars, rettv, TRUE, TRUE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005749}
5750
5751/*
5752 * "getpos(string)" function
5753 */
5754 static void
5755f_getpos(typval_T *argvars, typval_T *rettv)
5756{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02005757 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
5758 return;
5759
Bram Moolenaar6f02b002021-01-10 20:22:54 +01005760 getpos_both(argvars, rettv, FALSE, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02005761}
5762
5763/*
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005764 * Convert from block_def to string
5765 */
Gary Johnson88d4f252024-06-01 20:51:33 +02005766 static char_u *
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005767block_def2str(struct block_def *bd)
5768{
5769 char_u *p, *ret;
5770 size_t size = bd->startspaces + bd->endspaces + bd->textlen;
5771
5772 ret = alloc(size + 1);
5773 if (ret != NULL)
5774 {
5775 p = ret;
5776 vim_memset(p, ' ', bd->startspaces);
5777 p += bd->startspaces;
5778 mch_memmove(p, bd->textstart, bd->textlen);
5779 p += bd->textlen;
5780 vim_memset(p, ' ', bd->endspaces);
5781 *(p + bd->endspaces) = NUL;
5782 }
5783 return ret;
5784}
5785
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005786 static int
5787getregionpos(
5788 typval_T *argvars,
5789 typval_T *rettv,
zeertzjqc95e64f2024-05-20 14:00:31 +02005790 pos_T *p1,
5791 pos_T *p2,
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005792 int *inclusive,
5793 int *region_type,
zeertzjqafc22952024-05-24 19:07:12 +02005794 oparg_T *oap)
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005795{
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005796 int fnum1 = -1, fnum2 = -1;
5797 char_u *type;
5798 buf_T *findbuf;
5799 char_u default_type[] = "v";
zeertzjqafc22952024-05-24 19:07:12 +02005800 int block_width = 0;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005801 int is_select_exclusive;
5802 int l;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005803
5804 if (rettv_list_alloc(rettv) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005805 return FAIL;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005806
Shougo Matsushita19b71882024-02-28 22:48:12 +01005807 if (check_for_list_arg(argvars, 0) == FAIL
5808 || check_for_list_arg(argvars, 1) == FAIL
5809 || check_for_opt_dict_arg(argvars, 2) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005810 return FAIL;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005811
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005812 if (list2fpos(&argvars[0], p1, &fnum1, NULL, FALSE) != OK
5813 || list2fpos(&argvars[1], p2, &fnum2, NULL, FALSE) != OK
Shougo Matsushita84bf6e62024-03-06 21:10:18 +01005814 || fnum1 != fnum2)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005815 return FAIL;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005816
Shougo Matsushita19b71882024-02-28 22:48:12 +01005817 if (argvars[2].v_type == VAR_DICT)
5818 {
5819 is_select_exclusive = dict_get_bool(
5820 argvars[2].vval.v_dict, "exclusive", *p_sel == 'e');
5821 type = dict_get_string(
5822 argvars[2].vval.v_dict, "type", FALSE);
5823 if (type == NULL)
5824 type = default_type;
5825 }
5826 else
5827 {
5828 is_select_exclusive = *p_sel == 'e';
5829 type = default_type;
5830 }
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005831
5832 if (type[0] == 'v' && type[1] == NUL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005833 *region_type = MCHAR;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005834 else if (type[0] == 'V' && type[1] == NUL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005835 *region_type = MLINE;
zeertzjqafc22952024-05-24 19:07:12 +02005836 else if (type[0] == Ctrl_V)
5837 {
5838 char_u *p = type + 1;
5839
5840 if (*p != NUL && ((block_width = getdigits(&p)) <= 0 || *p != NUL))
5841 {
5842 semsg(_(e_invalid_value_for_argument_str_str), "type", type);
5843 return FAIL;
5844 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005845 *region_type = MBLOCK;
zeertzjqafc22952024-05-24 19:07:12 +02005846 }
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005847 else
zeertzjq26dd09a2024-03-10 15:46:58 +01005848 {
5849 semsg(_(e_invalid_value_for_argument_str_str), "type", type);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005850 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01005851 }
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005852
zeertzjq5406eb82024-03-11 21:36:42 +01005853 findbuf = fnum1 != 0 ? buflist_findnr(fnum1) : curbuf;
5854 if (findbuf == NULL || findbuf->b_ml.ml_mfp == NULL)
Shougo Matsushita84bf6e62024-03-06 21:10:18 +01005855 {
zeertzjq5406eb82024-03-11 21:36:42 +01005856 emsg(_(e_buffer_is_not_loaded));
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005857 return FAIL;
Shougo Matsushita84bf6e62024-03-06 21:10:18 +01005858 }
5859
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005860 if (p1->lnum < 1 || p1->lnum > findbuf->b_ml.ml_line_count)
zeertzjq26dd09a2024-03-10 15:46:58 +01005861 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005862 semsg(_(e_invalid_line_number_nr), p1->lnum);
5863 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01005864 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005865 if (p1->col == MAXCOL)
5866 p1->col = ml_get_buf_len(findbuf, p1->lnum) + 1;
5867 else if (p1->col < 1 || p1->col > ml_get_buf_len(findbuf, p1->lnum) + 1)
zeertzjq26dd09a2024-03-10 15:46:58 +01005868 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005869 semsg(_(e_invalid_column_number_nr), p1->col);
5870 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01005871 }
zeertzjq2ffdae72024-05-02 13:06:24 +02005872
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005873 if (p2->lnum < 1 || p2->lnum > findbuf->b_ml.ml_line_count)
zeertzjq26dd09a2024-03-10 15:46:58 +01005874 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005875 semsg(_(e_invalid_line_number_nr), p2->lnum);
5876 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01005877 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005878 if (p2->col == MAXCOL)
5879 p2->col = ml_get_buf_len(findbuf, p2->lnum) + 1;
5880 else if (p2->col < 1 || p2->col > ml_get_buf_len(findbuf, p2->lnum) + 1)
zeertzjq26dd09a2024-03-10 15:46:58 +01005881 {
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005882 semsg(_(e_invalid_column_number_nr), p2->col);
5883 return FAIL;
zeertzjq26dd09a2024-03-10 15:46:58 +01005884 }
5885
5886 curbuf = findbuf;
zeertzjq5406eb82024-03-11 21:36:42 +01005887 curwin->w_buffer = curbuf;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005888 virtual_op = virtual_active();
5889
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005890 // NOTE: Adjustment is needed.
5891 p1->col--;
5892 p2->col--;
Shougo Matsushita19b71882024-02-28 22:48:12 +01005893
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005894 if (!LT_POS(*p1, *p2))
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005895 {
5896 // swap position
5897 pos_T p;
5898
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005899 p = *p1;
5900 *p1 = *p2;
5901 *p2 = p;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005902 }
5903
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005904 if (*region_type == MCHAR)
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005905 {
zeertzjq701ad502024-05-23 07:47:55 +02005906 // Handle 'selection' == "exclusive".
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005907 if (is_select_exclusive && !EQUAL_POS(*p1, *p2))
zeertzjq701ad502024-05-23 07:47:55 +02005908 // When backing up to previous line, inclusive becomes false.
5909 *inclusive = !unadjust_for_sel_inner(p2);
5910 // If p2 is on NUL (end of line), inclusive becomes false.
5911 if (*inclusive && !virtual_op && *ml_get_pos(p2) == NUL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005912 *inclusive = FALSE;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005913 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005914 else if (*region_type == MBLOCK)
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005915 {
5916 colnr_T sc1, ec1, sc2, ec2;
5917
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005918 getvvcol(curwin, p1, &sc1, NULL, &ec1);
5919 getvvcol(curwin, p2, &sc2, NULL, &ec2);
zeertzjqafc22952024-05-24 19:07:12 +02005920 oap->motion_type = MBLOCK;
5921 oap->inclusive = TRUE;
5922 oap->op_type = OP_NOP;
5923 oap->start = *p1;
5924 oap->end = *p2;
5925 oap->start_vcol = MIN(sc1, sc2);
5926 if (block_width > 0)
5927 oap->end_vcol = oap->start_vcol + block_width - 1;
5928 else if (is_select_exclusive && ec1 < sc2 && 0 < sc2 && ec2 > ec1)
5929 oap->end_vcol = sc2 - 1;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005930 else
zeertzjqafc22952024-05-24 19:07:12 +02005931 oap->end_vcol = MAX(ec1, ec2);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005932 }
5933
5934 // Include the trailing byte of a multi-byte char.
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005935 l = mb_ptr2len((char_u *)ml_get_pos(p2));
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005936 if (l > 1)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005937 p2->col += l - 1;
5938
5939 return OK;
5940}
5941
5942/*
5943 * "getregion()" function
5944 */
5945 static void
5946f_getregion(typval_T *argvars, typval_T *rettv)
5947{
5948 pos_T p1, p2;
5949 int inclusive = TRUE;
5950 int region_type = -1;
5951 oparg_T oa;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005952
5953 buf_T *save_curbuf;
5954 int save_virtual;
5955 char_u *akt = NULL;
5956 linenr_T lnum;
5957
5958 save_curbuf = curbuf;
5959 save_virtual = virtual_op;
5960
5961 if (getregionpos(argvars, rettv,
zeertzjqc95e64f2024-05-20 14:00:31 +02005962 &p1, &p2, &inclusive, &region_type, &oa) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005963 return;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005964
5965 for (lnum = p1.lnum; lnum <= p2.lnum; lnum++)
5966 {
5967 int ret = 0;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02005968 struct block_def bd;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005969
5970 if (region_type == MLINE)
5971 akt = vim_strsave(ml_get(lnum));
5972 else if (region_type == MBLOCK)
5973 {
zeertzjq5e3674b2024-02-22 19:51:34 +01005974 block_prep(&oa, &bd, lnum, FALSE);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005975 akt = block_def2str(&bd);
5976 }
5977 else if (p1.lnum < lnum && lnum < p2.lnum)
5978 akt = vim_strsave(ml_get(lnum));
5979 else
5980 {
5981 charwise_block_prep(p1, p2, &bd, lnum, inclusive);
5982 akt = block_def2str(&bd);
5983 }
5984
5985 if (akt)
5986 {
5987 ret = list_append_string(rettv->vval.v_list, akt, -1);
5988 vim_free(akt);
5989 }
5990
5991 if (akt == NULL || ret == FAIL)
5992 {
zeertzjq5e3674b2024-02-22 19:51:34 +01005993 clear_tv(rettv);
5994 (void)rettv_list_alloc(rettv);
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01005995 break;
5996 }
5997 }
5998
zeertzjqc95e64f2024-05-20 14:00:31 +02005999 // getregionpos() may change curbuf and virtual_op
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006000 curbuf = save_curbuf;
6001 curwin->w_buffer = curbuf;
6002 virtual_op = save_virtual;
6003}
6004
6005 static void
zeertzjqc95e64f2024-05-20 14:00:31 +02006006add_regionpos_range(typval_T *rettv, pos_T p1, pos_T p2)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006007{
6008 list_T *l1, *l2, *l3;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006009
6010 l1 = list_alloc();
6011 if (l1 == NULL)
6012 return;
6013
6014 if (list_append_list(rettv->vval.v_list, l1) == FAIL)
6015 {
6016 vim_free(l1);
6017 return;
6018 }
6019
6020 l2 = list_alloc();
6021 if (l2 == NULL)
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006022 {
6023 vim_free(l1);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006024 return;
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006025 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006026
6027 if (list_append_list(l1, l2) == FAIL)
6028 {
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006029 vim_free(l1);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006030 vim_free(l2);
6031 return;
6032 }
6033
6034 l3 = list_alloc();
6035 if (l3 == NULL)
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006036 {
6037 vim_free(l1);
6038 vim_free(l2);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006039 return;
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006040 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006041
6042 if (list_append_list(l1, l3) == FAIL)
6043 {
Christian Brabandtb8ecedc2024-05-08 19:50:26 +02006044 vim_free(l1);
6045 vim_free(l2);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006046 vim_free(l3);
6047 return;
6048 }
6049
zeertzjqc95e64f2024-05-20 14:00:31 +02006050 list_append_number(l2, curbuf->b_fnum);
6051 list_append_number(l2, p1.lnum);
zeertzjq2b09de92024-05-24 07:48:51 +02006052 list_append_number(l2, p1.col);
zeertzjqc95e64f2024-05-20 14:00:31 +02006053 list_append_number(l2, p1.coladd);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006054
zeertzjqc95e64f2024-05-20 14:00:31 +02006055 list_append_number(l3, curbuf->b_fnum);
6056 list_append_number(l3, p2.lnum);
zeertzjq2b09de92024-05-24 07:48:51 +02006057 list_append_number(l3, p2.col);
zeertzjqc95e64f2024-05-20 14:00:31 +02006058 list_append_number(l3, p2.coladd);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006059}
6060
6061/*
6062 * "getregionpos()" function
6063 */
6064 static void
6065f_getregionpos(typval_T *argvars, typval_T *rettv)
6066{
6067 pos_T p1, p2;
6068 int inclusive = TRUE;
6069 int region_type = -1;
zeertzjq2b09de92024-05-24 07:48:51 +02006070 int allow_eol = FALSE;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006071 oparg_T oa;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006072 int lnum;
6073
6074 buf_T *save_curbuf;
6075 int save_virtual;
6076
6077 save_curbuf = curbuf;
6078 save_virtual = virtual_op;
6079
6080 if (getregionpos(argvars, rettv,
zeertzjqc95e64f2024-05-20 14:00:31 +02006081 &p1, &p2, &inclusive, &region_type, &oa) == FAIL)
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006082 return;
6083
zeertzjq2b09de92024-05-24 07:48:51 +02006084 if (argvars[2].v_type == VAR_DICT)
6085 allow_eol = dict_get_bool(argvars[2].vval.v_dict, "eol", FALSE);
6086
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006087 for (lnum = p1.lnum; lnum <= p2.lnum; lnum++)
6088 {
zeertzjq2b09de92024-05-24 07:48:51 +02006089 pos_T ret_p1, ret_p2;
zeertzjqef733742024-05-26 18:42:18 +02006090 char_u *line = ml_get(lnum);
zeertzjq2b09de92024-05-24 07:48:51 +02006091 colnr_T line_len = ml_get_len(lnum);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006092
6093 if (region_type == MLINE)
6094 {
zeertzjqc95e64f2024-05-20 14:00:31 +02006095 ret_p1.col = 1;
6096 ret_p1.coladd = 0;
6097 ret_p2.col = MAXCOL;
6098 ret_p2.coladd = 0;
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006099 }
6100 else
6101 {
zeertzjq52a6f342024-05-22 16:42:44 +02006102 struct block_def bd;
6103
zeertzjqc95e64f2024-05-20 14:00:31 +02006104 if (region_type == MBLOCK)
6105 block_prep(&oa, &bd, lnum, FALSE);
6106 else
6107 charwise_block_prep(p1, p2, &bd, lnum, inclusive);
zeertzjq52a6f342024-05-22 16:42:44 +02006108
6109 if (bd.is_oneChar) // selection entirely inside one char
6110 {
6111 if (region_type == MBLOCK)
6112 {
zeertzjqef733742024-05-26 18:42:18 +02006113 ret_p1.col = mb_prevptr(line, bd.textstart) - line + 1;
zeertzjq52a6f342024-05-22 16:42:44 +02006114 ret_p1.coladd = bd.start_char_vcols
6115 - (bd.start_vcol - oa.start_vcol);
6116 }
6117 else
6118 {
6119 ret_p1.col = p1.col + 1;
6120 ret_p1.coladd = p1.coladd;
6121 }
6122 }
zeertzjq2b09de92024-05-24 07:48:51 +02006123 else if (region_type == MBLOCK && oa.start_vcol > bd.start_vcol)
6124 {
6125 // blockwise selection entirely beyond end of line
6126 ret_p1.col = MAXCOL;
6127 ret_p1.coladd = oa.start_vcol - bd.start_vcol;
6128 bd.is_oneChar = TRUE;
6129 }
zeertzjq52a6f342024-05-22 16:42:44 +02006130 else if (bd.startspaces > 0)
zeertzjqc95e64f2024-05-20 14:00:31 +02006131 {
zeertzjqef733742024-05-26 18:42:18 +02006132 ret_p1.col = mb_prevptr(line, bd.textstart) - line + 1;
zeertzjqc95e64f2024-05-20 14:00:31 +02006133 ret_p1.coladd = bd.start_char_vcols - bd.startspaces;
6134 }
6135 else
6136 {
6137 ret_p1.col = bd.textcol + 1;
6138 ret_p1.coladd = 0;
6139 }
zeertzjq52a6f342024-05-22 16:42:44 +02006140
6141 if (bd.is_oneChar) // selection entirely inside one char
6142 {
6143 ret_p2.col = ret_p1.col;
zeertzjq2b09de92024-05-24 07:48:51 +02006144 ret_p2.coladd = ret_p1.coladd + bd.startspaces + bd.endspaces;
zeertzjq52a6f342024-05-22 16:42:44 +02006145 }
6146 else if (bd.endspaces > 0)
zeertzjqc95e64f2024-05-20 14:00:31 +02006147 {
6148 ret_p2.col = bd.textcol + bd.textlen + 1;
6149 ret_p2.coladd = bd.endspaces;
6150 }
6151 else
6152 {
6153 ret_p2.col = bd.textcol + bd.textlen;
6154 ret_p2.coladd = 0;
6155 }
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006156 }
6157
zeertzjq2b09de92024-05-24 07:48:51 +02006158 if (!allow_eol && ret_p1.col > line_len)
6159 {
6160 ret_p1.col = 0;
6161 ret_p1.coladd = 0;
6162 }
6163 else if (ret_p1.col > line_len + 1)
6164 ret_p1.col = line_len + 1;
6165
6166 if (!allow_eol && ret_p2.col > line_len)
6167 {
6168 ret_p2.col = ret_p1.col == 0 ? 0 : line_len;
6169 ret_p2.coladd = 0;
6170 }
6171 else if (ret_p2.col > line_len + 1)
6172 ret_p2.col = line_len + 1;
6173
zeertzjqc95e64f2024-05-20 14:00:31 +02006174 ret_p1.lnum = lnum;
6175 ret_p2.lnum = lnum;
6176 add_regionpos_range(rettv, ret_p1, ret_p2);
Shougo Matsushitab4757e62024-05-07 20:49:24 +02006177 }
6178
6179 // getregionpos() may change curbuf and virtual_op
zeertzjq5406eb82024-03-11 21:36:42 +01006180 curbuf = save_curbuf;
6181 curwin->w_buffer = curbuf;
Shougo Matsushita3f905ab2024-02-21 00:02:45 +01006182 virtual_op = save_virtual;
6183}
6184
6185/*
zeertzjqd3f00f52021-12-24 12:02:43 +00006186 * Common between getreg(), getreginfo() and getregtype(): get the register
6187 * name from the first argument.
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006188 * Returns zero on error.
6189 */
6190 static int
6191getreg_get_regname(typval_T *argvars)
6192{
6193 char_u *strregname;
6194
6195 if (argvars[0].v_type != VAR_UNKNOWN)
6196 {
6197 strregname = tv_get_string_chk(&argvars[0]);
6198 if (strregname != NULL && in_vim9script() && STRLEN(strregname) > 1)
6199 {
6200 semsg(_(e_register_name_must_be_one_char_str), strregname);
6201 strregname = NULL;
6202 }
6203 if (strregname == NULL) // type error; errmsg already given
6204 return 0;
6205 }
6206 else
6207 // Default to v:register
6208 strregname = get_vim_var_str(VV_REG);
6209
6210 return *strregname == 0 ? '"' : *strregname;
6211}
6212
6213/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006214 * "getreg()" function
6215 */
6216 static void
6217f_getreg(typval_T *argvars, typval_T *rettv)
6218{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006219 int regname;
6220 int arg2 = FALSE;
6221 int return_list = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006222
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02006223 if (in_vim9script()
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006224 && (check_for_opt_string_arg(argvars, 0) == FAIL
6225 || (argvars[0].v_type != VAR_UNKNOWN
6226 && (check_for_opt_bool_arg(argvars, 1) == FAIL
6227 || (argvars[1].v_type != VAR_UNKNOWN
6228 && check_for_opt_bool_arg(argvars, 2) == FAIL)))))
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02006229 return;
6230
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006231 regname = getreg_get_regname(argvars);
6232 if (regname == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006233 return;
6234
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006235 if (argvars[0].v_type != VAR_UNKNOWN && argvars[1].v_type != VAR_UNKNOWN)
6236 {
6237 int error = FALSE;
6238
6239 arg2 = (int)tv_get_bool_chk(&argvars[1], &error);
6240
6241 if (!error && argvars[2].v_type != VAR_UNKNOWN)
6242 return_list = (int)tv_get_bool_chk(&argvars[2], &error);
6243 if (error)
6244 return;
6245 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006246
6247 if (return_list)
6248 {
6249 rettv->v_type = VAR_LIST;
6250 rettv->vval.v_list = (list_T *)get_reg_contents(regname,
6251 (arg2 ? GREG_EXPR_SRC : 0) | GREG_LIST);
6252 if (rettv->vval.v_list == NULL)
6253 (void)rettv_list_alloc(rettv);
6254 else
6255 ++rettv->vval.v_list->lv_refcount;
6256 }
6257 else
6258 {
6259 rettv->v_type = VAR_STRING;
6260 rettv->vval.v_string = get_reg_contents(regname,
6261 arg2 ? GREG_EXPR_SRC : 0);
6262 }
6263}
6264
6265/*
6266 * "getregtype()" function
6267 */
6268 static void
6269f_getregtype(typval_T *argvars, typval_T *rettv)
6270{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006271 int regname;
6272 char_u buf[NUMBUFLEN + 2];
6273 long reglen = 0;
6274
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006275 // on error return an empty string
6276 rettv->v_type = VAR_STRING;
6277 rettv->vval.v_string = NULL;
6278
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006279 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
6280 return;
6281
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006282 regname = getreg_get_regname(argvars);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006283 if (regname == 0)
Bram Moolenaar51e64b22021-12-24 10:48:30 +00006284 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006285
6286 buf[0] = NUL;
6287 buf[1] = NUL;
6288 switch (get_reg_type(regname, &reglen))
6289 {
6290 case MLINE: buf[0] = 'V'; break;
6291 case MCHAR: buf[0] = 'v'; break;
6292 case MBLOCK:
6293 buf[0] = Ctrl_V;
6294 sprintf((char *)buf + 1, "%ld", reglen + 1);
6295 break;
6296 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006297 rettv->vval.v_string = vim_strsave(buf);
6298}
6299
Bram Moolenaarb5ae48e2016-08-12 22:23:25 +02006300/*
Bram Moolenaarf49cc602018-11-11 15:21:05 +01006301 * "gettagstack()" function
6302 */
6303 static void
6304f_gettagstack(typval_T *argvars, typval_T *rettv)
6305{
6306 win_T *wp = curwin; // default is current window
6307
Bram Moolenaar93a10962022-06-16 11:42:09 +01006308 if (rettv_dict_alloc(rettv) == FAIL)
Bram Moolenaarf49cc602018-11-11 15:21:05 +01006309 return;
6310
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006311 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
6312 return;
6313
Bram Moolenaarf49cc602018-11-11 15:21:05 +01006314 if (argvars[0].v_type != VAR_UNKNOWN)
6315 {
6316 wp = find_win_by_nr_or_id(&argvars[0]);
6317 if (wp == NULL)
6318 return;
6319 }
6320
6321 get_tagstack(wp, rettv->vval.v_dict);
6322}
6323
Bram Moolenaar0b39c3f2020-08-30 15:52:10 +02006324/*
6325 * "gettext()" function
6326 */
6327 static void
6328f_gettext(typval_T *argvars, typval_T *rettv)
6329{
Christ van Willegence0ef912024-06-20 23:41:59 +02006330#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
6331 char *prev = NULL;
6332#endif
6333
6334 if (check_for_nonempty_string_arg(argvars, 0) == FAIL
6335 || check_for_opt_string_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02006336 return;
6337
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +01006338 rettv->v_type = VAR_STRING;
Christ van Willegence0ef912024-06-20 23:41:59 +02006339
6340 if (argvars[1].v_type == VAR_STRING &&
6341 argvars[1].vval.v_string != NULL &&
6342 *(argvars[1].vval.v_string) != NUL)
6343 {
6344#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
6345 prev = bind_textdomain_codeset((const char *)argvars[1].vval.v_string, (char *)p_enc);
6346#endif
6347
6348#if defined(HAVE_DGETTEXT)
6349 rettv->vval.v_string = vim_strsave((char_u *)dgettext((const char *)argvars[1].vval.v_string, (const char *)argvars[0].vval.v_string));
6350#else
6351 textdomain((const char *)argvars[1].vval.v_string);
6352 rettv->vval.v_string = vim_strsave((char_u *)_(argvars[0].vval.v_string));
6353 textdomain(VIMPACKAGE);
6354#endif
6355
6356#if defined(HAVE_BIND_TEXTDOMAIN_CODESET)
6357 if (prev != NULL)
6358 bind_textdomain_codeset((const char *)argvars[1].vval.v_string, prev);
6359#endif
6360 }
6361 else
6362 rettv->vval.v_string = vim_strsave((char_u *)_(argvars[0].vval.v_string));
Bram Moolenaar0b39c3f2020-08-30 15:52:10 +02006363}
6364
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01006365// for VIM_VERSION_ defines
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006366#include "version.h"
6367
6368/*
6369 * "has()" function
6370 */
Bram Moolenaara259d8d2020-01-31 20:10:50 +01006371 void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006372f_has(typval_T *argvars, typval_T *rettv)
6373{
6374 int i;
6375 char_u *name;
Bram Moolenaar79296512020-03-22 16:17:14 +01006376 int x = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006377 int n = FALSE;
Bram Moolenaar79296512020-03-22 16:17:14 +01006378 typedef struct {
6379 char *name;
6380 short present;
6381 } has_item_T;
6382 static has_item_T has_list[] =
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006383 {
Bram Moolenaar79296512020-03-22 16:17:14 +01006384 {"amiga",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006385#ifdef AMIGA
Bram Moolenaar79296512020-03-22 16:17:14 +01006386 1
Bram Moolenaar39536dd2019-01-29 22:58:21 +01006387#else
Bram Moolenaar79296512020-03-22 16:17:14 +01006388 0
Bram Moolenaar39536dd2019-01-29 22:58:21 +01006389#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006390 },
6391 {"arp",
6392#if defined(AMIGA) && defined(FEAT_ARP)
6393 1
6394#else
6395 0
6396#endif
6397 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006398 {"haiku",
6399#ifdef __HAIKU__
6400 1
6401#else
6402 0
6403#endif
6404 },
6405 {"bsd",
6406#if defined(BSD) && !defined(MACOS_X)
6407 1
6408#else
6409 0
6410#endif
6411 },
6412 {"hpux",
6413#ifdef hpux
6414 1
6415#else
6416 0
6417#endif
6418 },
6419 {"linux",
6420#ifdef __linux__
6421 1
6422#else
6423 0
6424#endif
6425 },
6426 {"mac", // Mac OS X (and, once, Mac OS Classic)
6427#ifdef MACOS_X
6428 1
6429#else
6430 0
6431#endif
6432 },
6433 {"osx", // Mac OS X
6434#ifdef MACOS_X
6435 1
6436#else
6437 0
6438#endif
6439 },
6440 {"macunix", // Mac OS X, with the darwin feature
6441#if defined(MACOS_X) && defined(MACOS_X_DARWIN)
6442 1
6443#else
6444 0
6445#endif
6446 },
6447 {"osxdarwin", // synonym for macunix
6448#if defined(MACOS_X) && defined(MACOS_X_DARWIN)
6449 1
6450#else
6451 0
6452#endif
6453 },
6454 {"qnx",
6455#ifdef __QNX__
6456 1
6457#else
6458 0
6459#endif
6460 },
6461 {"sun",
6462#ifdef SUN_SYSTEM
6463 1
6464#else
6465 0
6466#endif
6467 },
6468 {"unix",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006469#ifdef UNIX
Bram Moolenaar79296512020-03-22 16:17:14 +01006470 1
6471#else
6472 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006473#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006474 },
6475 {"vms",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006476#ifdef VMS
Bram Moolenaar79296512020-03-22 16:17:14 +01006477 1
6478#else
6479 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006480#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006481 },
6482 {"win32",
Bram Moolenaar4f974752019-02-17 17:44:42 +01006483#ifdef MSWIN
Bram Moolenaar79296512020-03-22 16:17:14 +01006484 1
6485#else
6486 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006487#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006488 },
6489 {"win32unix",
K.Takata972db232022-02-04 10:45:38 +00006490#ifdef WIN32UNIX
Bram Moolenaar79296512020-03-22 16:17:14 +01006491 1
6492#else
6493 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006494#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006495 },
6496 {"win64",
Bram Moolenaar44b443c2019-02-18 22:14:18 +01006497#ifdef _WIN64
Bram Moolenaar79296512020-03-22 16:17:14 +01006498 1
6499#else
6500 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006501#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006502 },
Bram Moolenaar424bcae2022-01-31 14:59:41 +00006503 {"ebcdic", 0 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006504 {"fname_case",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006505#ifndef CASE_INSENSITIVE_FILENAME
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 {"acl",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006512#ifdef HAVE_ACL
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 {"arabic",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006519#ifdef FEAT_ARABIC
Bram Moolenaar79296512020-03-22 16:17:14 +01006520 1
6521#else
6522 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006523#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006524 },
6525 {"autocmd", 1},
6526 {"autochdir",
Bram Moolenaar83ec2a72018-07-27 22:08:59 +02006527#ifdef FEAT_AUTOCHDIR
Bram Moolenaar79296512020-03-22 16:17:14 +01006528 1
6529#else
6530 0
Bram Moolenaar83ec2a72018-07-27 22:08:59 +02006531#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006532 },
6533 {"autoservername",
Bram Moolenaare42a6d22017-11-12 19:21:51 +01006534#ifdef FEAT_AUTOSERVERNAME
Bram Moolenaar79296512020-03-22 16:17:14 +01006535 1
6536#else
6537 0
Bram Moolenaare42a6d22017-11-12 19:21:51 +01006538#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006539 },
6540 {"balloon_eval",
Bram Moolenaarc3719bd2017-11-18 22:13:31 +01006541#ifdef FEAT_BEVAL_GUI
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 {"balloon_multiline",
Bram Moolenaar0bd663a2022-01-22 10:24:47 +00006548#ifdef FEAT_BEVAL_GUI
Bram Moolenaar79296512020-03-22 16:17:14 +01006549 1
6550#else
6551 0
6552#endif
6553 },
6554 {"balloon_eval_term",
Bram Moolenaarc3719bd2017-11-18 22:13:31 +01006555#ifdef FEAT_BEVAL_TERM
Bram Moolenaar79296512020-03-22 16:17:14 +01006556 1
6557#else
6558 0
Bram Moolenaar51b0f372017-11-18 18:52:04 +01006559#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006560 },
Bram Moolenaar2ee347f2022-08-26 17:53:44 +01006561 {"builtin_terms", 1},
6562 {"all_builtin_terms", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006563 {"browsefilter",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006564#if defined(FEAT_BROWSE) && (defined(USE_FILE_CHOOSER) \
Bram Moolenaar4f974752019-02-17 17:44:42 +01006565 || defined(FEAT_GUI_MSWIN) \
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006566 || defined(FEAT_GUI_MOTIF))
Bram Moolenaar79296512020-03-22 16:17:14 +01006567 1
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006568#else
Bram Moolenaar79296512020-03-22 16:17:14 +01006569 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02006570#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01006571 },
6572 {"byte_offset",
6573#ifdef FEAT_BYTEOFF
6574 1
6575#else
6576 0
6577#endif
6578 },
6579 {"channel",
6580#ifdef FEAT_JOB_CHANNEL
6581 1
6582#else
6583 0
6584#endif
6585 },
Bram Moolenaar8e145b82022-05-21 20:17:31 +01006586 {"cindent", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006587 {"clientserver",
6588#ifdef FEAT_CLIENTSERVER
6589 1
6590#else
6591 0
6592#endif
6593 },
6594 {"clipboard",
6595#ifdef FEAT_CLIPBOARD
6596 1
6597#else
6598 0
6599#endif
6600 },
6601 {"cmdline_compl", 1},
6602 {"cmdline_hist", 1},
Martin Tournoij7904fa42022-10-04 16:28:45 +01006603 {"cmdwin", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006604 {"comments", 1},
6605 {"conceal",
6606#ifdef FEAT_CONCEAL
6607 1
6608#else
6609 0
6610#endif
6611 },
6612 {"cryptv",
6613#ifdef FEAT_CRYPT
6614 1
6615#else
6616 0
6617#endif
6618 },
6619 {"crypt-blowfish",
6620#ifdef FEAT_CRYPT
6621 1
6622#else
6623 0
6624#endif
6625 },
6626 {"crypt-blowfish2",
6627#ifdef FEAT_CRYPT
6628 1
6629#else
6630 0
6631#endif
6632 },
6633 {"cscope",
6634#ifdef FEAT_CSCOPE
6635 1
6636#else
6637 0
6638#endif
6639 },
6640 {"cursorbind", 1},
6641 {"cursorshape",
6642#ifdef CURSOR_SHAPE
6643 1
6644#else
6645 0
6646#endif
6647 },
6648 {"debug",
6649#ifdef DEBUG
6650 1
6651#else
6652 0
6653#endif
6654 },
6655 {"dialog_con",
6656#ifdef FEAT_CON_DIALOG
6657 1
6658#else
6659 0
6660#endif
6661 },
glepnirdf461152024-04-04 22:23:29 +02006662 {"dialog_con_gui",
6663#if defined(FEAT_CON_DIALOG) && defined(FEAT_GUI_DIALOG)
6664 1
6665#else
6666 0
6667#endif
6668 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006669 {"dialog_gui",
6670#ifdef FEAT_GUI_DIALOG
6671 1
6672#else
6673 0
6674#endif
6675 },
6676 {"diff",
6677#ifdef FEAT_DIFF
6678 1
6679#else
6680 0
6681#endif
6682 },
6683 {"digraphs",
6684#ifdef FEAT_DIGRAPHS
6685 1
6686#else
6687 0
6688#endif
6689 },
6690 {"directx",
6691#ifdef FEAT_DIRECTX
6692 1
6693#else
6694 0
6695#endif
6696 },
6697 {"dnd",
6698#ifdef FEAT_DND
6699 1
6700#else
6701 0
6702#endif
6703 },
Bram Moolenaar1d1ce612021-06-27 19:02:52 +02006704 {"drop_file",
6705#ifdef HAVE_DROP_FILE
6706 1
6707#else
6708 0
6709#endif
6710 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006711 {"emacs_tags",
6712#ifdef FEAT_EMACS_TAGS
6713 1
6714#else
6715 0
6716#endif
6717 },
6718 {"eval", 1}, // always present, of course!
6719 {"ex_extra", 1}, // graduated feature
6720 {"extra_search",
6721#ifdef FEAT_SEARCH_EXTRA
6722 1
6723#else
6724 0
6725#endif
6726 },
Bram Moolenaarf80f40a2022-08-25 16:02:23 +01006727 {"file_in_path", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006728 {"filterpipe",
6729#if defined(FEAT_FILTERPIPE) && !defined(VIMDLL)
6730 1
6731#else
6732 0
6733#endif
6734 },
6735 {"find_in_path",
6736#ifdef FEAT_FIND_ID
6737 1
6738#else
6739 0
6740#endif
6741 },
Bram Moolenaar73e28dc2022-09-17 21:08:33 +01006742 {"float", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006743 {"folding",
6744#ifdef FEAT_FOLDING
6745 1
6746#else
6747 0
6748#endif
6749 },
Bram Moolenaarc8ac3a02022-09-04 12:29:28 +01006750 {"footer", 0},
Bram Moolenaar79296512020-03-22 16:17:14 +01006751 {"fork",
6752#if !defined(USE_SYSTEM) && defined(UNIX)
6753 1
6754#else
6755 0
6756#endif
6757 },
6758 {"gettext",
6759#ifdef FEAT_GETTEXT
6760 1
6761#else
6762 0
6763#endif
6764 },
6765 {"gui",
6766#ifdef FEAT_GUI
6767 1
6768#else
6769 0
6770#endif
6771 },
Bram Moolenaar0b962e52022-04-03 18:02:37 +01006772 {"gui_neXtaw", 0 },
6773 {"gui_athena", 0 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006774 {"gui_gtk",
6775#ifdef FEAT_GUI_GTK
6776 1
6777#else
6778 0
6779#endif
6780 },
6781 {"gui_gtk2",
6782#if defined(FEAT_GUI_GTK) && !defined(USE_GTK3)
6783 1
6784#else
6785 0
6786#endif
6787 },
6788 {"gui_gtk3",
6789#if defined(FEAT_GUI_GTK) && defined(USE_GTK3)
6790 1
6791#else
6792 0
6793#endif
6794 },
6795 {"gui_gnome",
6796#ifdef FEAT_GUI_GNOME
6797 1
6798#else
6799 0
6800#endif
6801 },
6802 {"gui_haiku",
6803#ifdef FEAT_GUI_HAIKU
6804 1
6805#else
6806 0
6807#endif
6808 },
Bram Moolenaar097148e2020-08-11 21:58:20 +02006809 {"gui_mac", 0},
Bram Moolenaar79296512020-03-22 16:17:14 +01006810 {"gui_motif",
6811#ifdef FEAT_GUI_MOTIF
6812 1
6813#else
6814 0
6815#endif
6816 },
6817 {"gui_photon",
6818#ifdef FEAT_GUI_PHOTON
6819 1
6820#else
6821 0
6822#endif
6823 },
6824 {"gui_win32",
6825#ifdef FEAT_GUI_MSWIN
6826 1
6827#else
6828 0
6829#endif
6830 },
6831 {"iconv",
6832#if defined(HAVE_ICONV_H) && defined(USE_ICONV)
6833 1
6834#else
6835 0
6836#endif
6837 },
6838 {"insert_expand", 1},
Bram Moolenaarbfe13cc2020-04-12 17:53:12 +02006839 {"ipv6",
6840#ifdef FEAT_IPV6
6841 1
6842#else
6843 0
6844#endif
6845 },
Bram Moolenaar79296512020-03-22 16:17:14 +01006846 {"job",
6847#ifdef FEAT_JOB_CHANNEL
6848 1
6849#else
6850 0
6851#endif
6852 },
Bram Moolenaar739f13a2021-12-13 13:12:53 +00006853 {"jumplist", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006854 {"keymap",
6855#ifdef FEAT_KEYMAP
6856 1
6857#else
6858 0
6859#endif
6860 },
6861 {"lambda", 1}, // always with FEAT_EVAL, since 7.4.2120 with closure
6862 {"langmap",
6863#ifdef FEAT_LANGMAP
6864 1
6865#else
6866 0
6867#endif
6868 },
6869 {"libcall",
6870#ifdef FEAT_LIBCALL
6871 1
6872#else
6873 0
6874#endif
6875 },
6876 {"linebreak",
6877#ifdef FEAT_LINEBREAK
6878 1
6879#else
6880 0
6881#endif
6882 },
Bram Moolenaar8e145b82022-05-21 20:17:31 +01006883 {"lispindent", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01006884 {"listcmds", 1},
6885 {"localmap", 1},
6886 {"lua",
6887#if defined(FEAT_LUA) && !defined(DYNAMIC_LUA)
6888 1
6889#else
6890 0
6891#endif
6892 },
6893 {"menu",
6894#ifdef FEAT_MENU
6895 1
6896#else
6897 0
6898#endif
6899 },
6900 {"mksession",
6901#ifdef FEAT_SESSION
6902 1
6903#else
6904 0
6905#endif
6906 },
6907 {"modify_fname", 1},
6908 {"mouse", 1},
6909 {"mouseshape",
6910#ifdef FEAT_MOUSESHAPE
6911 1
6912#else
6913 0
6914#endif
6915 },
6916 {"mouse_dec",
6917#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_DEC)
6918 1
6919#else
6920 0
6921#endif
6922 },
6923 {"mouse_gpm",
Bram Moolenaar33fc4a62022-02-23 18:07:38 +00006924#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_GPM) && !defined(DYNAMIC_GPM)
Bram Moolenaar79296512020-03-22 16:17:14 +01006925 1
6926#else
6927 0
6928#endif
6929 },
6930 {"mouse_jsbterm",
6931#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_JSB)
6932 1
6933#else
6934 0
6935#endif
6936 },
6937 {"mouse_netterm",
6938#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_NET)
6939 1
6940#else
6941 0
6942#endif
6943 },
6944 {"mouse_pterm",
6945#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_PTERM)
6946 1
6947#else
6948 0
6949#endif
6950 },
6951 {"mouse_sgr",
6952#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_XTERM)
6953 1
6954#else
6955 0
6956#endif
6957 },
6958 {"mouse_sysmouse",
6959#if (defined(UNIX) || defined(VMS)) && defined(FEAT_SYSMOUSE)
6960 1
6961#else
6962 0
6963#endif
6964 },
6965 {"mouse_urxvt",
6966#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_URXVT)
6967 1
6968#else
6969 0
6970#endif
6971 },
6972 {"mouse_xterm",
6973#if (defined(UNIX) || defined(VMS)) && defined(FEAT_MOUSE_XTERM)
6974 1
6975#else
6976 0
6977#endif
6978 },
6979 {"multi_byte", 1},
6980 {"multi_byte_ime",
6981#ifdef FEAT_MBYTE_IME
6982 1
6983#else
6984 0
6985#endif
6986 },
6987 {"multi_lang",
6988#ifdef FEAT_MULTI_LANG
6989 1
6990#else
6991 0
6992#endif
6993 },
6994 {"mzscheme",
6995#if defined(FEAT_MZSCHEME) && !defined(DYNAMIC_MZSCHEME)
6996 1
6997#else
6998 0
6999#endif
7000 },
Leah Neukirchen0a7984a2021-10-14 21:27:55 +01007001 {"nanotime",
7002#ifdef ST_MTIM_NSEC
7003 1
7004#else
7005 0
7006#endif
7007 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007008 {"num64", 1},
7009 {"ole",
7010#ifdef FEAT_OLE
7011 1
7012#else
7013 0
7014#endif
7015 },
7016 {"packages",
7017#ifdef FEAT_EVAL
7018 1
7019#else
7020 0
7021#endif
7022 },
Bram Moolenaar2bd9dbc2022-08-25 18:12:06 +01007023 {"path_extra", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007024 {"perl",
7025#if defined(FEAT_PERL) && !defined(DYNAMIC_PERL)
7026 1
7027#else
7028 0
7029#endif
7030 },
7031 {"persistent_undo",
7032#ifdef FEAT_PERSISTENT_UNDO
7033 1
7034#else
7035 0
7036#endif
7037 },
7038 {"python_compiled",
7039#if defined(FEAT_PYTHON)
7040 1
7041#else
7042 0
7043#endif
7044 },
7045 {"python_dynamic",
7046#if defined(FEAT_PYTHON) && defined(DYNAMIC_PYTHON)
7047 1
7048#else
7049 0
7050#endif
7051 },
7052 {"python",
7053#if defined(FEAT_PYTHON) && !defined(DYNAMIC_PYTHON)
7054 1
7055#else
7056 0
7057#endif
7058 },
7059 {"pythonx",
7060#if (defined(FEAT_PYTHON) && !defined(DYNAMIC_PYTHON)) \
7061 || (defined(FEAT_PYTHON3) && !defined(DYNAMIC_PYTHON3))
7062 1
7063#else
7064 0
7065#endif
7066 },
7067 {"python3_compiled",
7068#if defined(FEAT_PYTHON3)
7069 1
7070#else
7071 0
7072#endif
7073 },
7074 {"python3_dynamic",
7075#if defined(FEAT_PYTHON3) && defined(DYNAMIC_PYTHON3)
7076 1
7077#else
7078 0
7079#endif
7080 },
Yee Cheng Chinc13b3d12023-08-20 21:18:38 +02007081 {"python3_stable",
7082#if defined(FEAT_PYTHON3) && defined(DYNAMIC_PYTHON3_STABLE_ABI)
7083 1
7084#else
7085 0
7086#endif
7087 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007088 {"python3",
7089#if defined(FEAT_PYTHON3) && !defined(DYNAMIC_PYTHON3)
7090 1
7091#else
7092 0
7093#endif
7094 },
7095 {"popupwin",
7096#ifdef FEAT_PROP_POPUP
7097 1
7098#else
7099 0
7100#endif
7101 },
7102 {"postscript",
7103#ifdef FEAT_POSTSCRIPT
7104 1
7105#else
7106 0
7107#endif
7108 },
7109 {"printer",
7110#ifdef FEAT_PRINTER
7111 1
7112#else
7113 0
7114#endif
7115 },
7116 {"profile",
7117#ifdef FEAT_PROFILE
7118 1
7119#else
7120 0
7121#endif
7122 },
Ernie Rael076de792023-03-16 21:43:15 +00007123 {"prof_nsec",
Bram Moolenaar08210f82023-04-13 19:15:54 +01007124#ifdef PROF_NSEC
Ernie Rael076de792023-03-16 21:43:15 +00007125 1
7126#else
7127 0
7128#endif
7129 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007130 {"reltime",
7131#ifdef FEAT_RELTIME
7132 1
7133#else
7134 0
7135#endif
7136 },
7137 {"quickfix",
7138#ifdef FEAT_QUICKFIX
7139 1
7140#else
7141 0
7142#endif
7143 },
7144 {"rightleft",
7145#ifdef FEAT_RIGHTLEFT
7146 1
7147#else
7148 0
7149#endif
7150 },
7151 {"ruby",
7152#if defined(FEAT_RUBY) && !defined(DYNAMIC_RUBY)
7153 1
7154#else
7155 0
7156#endif
7157 },
7158 {"scrollbind", 1},
Martin Tournoijba43e762022-10-13 22:12:15 +01007159 {"showcmd", 1},
7160 {"cmdline_info", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007161 {"signs",
7162#ifdef FEAT_SIGNS
7163 1
7164#else
7165 0
7166#endif
7167 },
Bram Moolenaar8e145b82022-05-21 20:17:31 +01007168 {"smartindent", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007169 {"startuptime",
7170#ifdef STARTUPTIME
7171 1
7172#else
7173 0
7174#endif
7175 },
7176 {"statusline",
7177#ifdef FEAT_STL_OPT
7178 1
7179#else
7180 0
7181#endif
7182 },
7183 {"netbeans_intg",
7184#ifdef FEAT_NETBEANS_INTG
7185 1
7186#else
7187 0
7188#endif
7189 },
Christian Brabandtf573c6e2021-06-20 14:02:16 +02007190 {"sodium",
K.Takatad68b2fc2022-02-12 11:18:37 +00007191#if defined(FEAT_SODIUM) && !defined(DYNAMIC_SODIUM)
Christian Brabandtf573c6e2021-06-20 14:02:16 +02007192 1
7193#else
7194 0
7195#endif
7196 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007197 {"sound",
7198#ifdef FEAT_SOUND
7199 1
7200#else
7201 0
7202#endif
7203 },
7204 {"spell",
7205#ifdef FEAT_SPELL
7206 1
7207#else
7208 0
7209#endif
7210 },
7211 {"syntax",
7212#ifdef FEAT_SYN_HL
7213 1
7214#else
7215 0
7216#endif
7217 },
7218 {"system",
7219#if defined(USE_SYSTEM) || !defined(UNIX)
7220 1
7221#else
7222 0
7223#endif
7224 },
Yegappan Lakshmanan655b7342022-03-06 14:27:10 +00007225 {"tag_binary", 1}, // graduated feature
Bram Moolenaar79296512020-03-22 16:17:14 +01007226 {"tcl",
7227#if defined(FEAT_TCL) && !defined(DYNAMIC_TCL)
7228 1
7229#else
7230 0
7231#endif
7232 },
7233 {"termguicolors",
7234#ifdef FEAT_TERMGUICOLORS
7235 1
7236#else
7237 0
7238#endif
7239 },
7240 {"terminal",
7241#if defined(FEAT_TERMINAL) && !defined(MSWIN)
7242 1
7243#else
7244 0
7245#endif
7246 },
7247 {"terminfo",
7248#ifdef TERMINFO
7249 1
7250#else
7251 0
7252#endif
7253 },
7254 {"termresponse",
7255#ifdef FEAT_TERMRESPONSE
7256 1
7257#else
7258 0
7259#endif
7260 },
Bram Moolenaar88774872022-08-16 20:24:29 +01007261 {"textobjects", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007262 {"textprop",
7263#ifdef FEAT_PROP_POPUP
7264 1
7265#else
7266 0
7267#endif
7268 },
7269 {"tgetent",
7270#ifdef HAVE_TGETENT
7271 1
7272#else
7273 0
7274#endif
7275 },
7276 {"timers",
7277#ifdef FEAT_TIMERS
7278 1
7279#else
7280 0
7281#endif
7282 },
Bram Moolenaar651fca82021-11-29 20:39:38 +00007283 {"title", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007284 {"toolbar",
7285#ifdef FEAT_TOOLBAR
7286 1
7287#else
7288 0
7289#endif
7290 },
7291 {"unnamedplus",
7292#if defined(FEAT_CLIPBOARD) && defined(FEAT_X11)
7293 1
7294#else
7295 0
7296#endif
7297 },
7298 {"user-commands", 1}, // was accidentally included in 5.4
7299 {"user_commands", 1},
7300 {"vartabs",
7301#ifdef FEAT_VARTABS
7302 1
7303#else
7304 0
7305#endif
7306 },
7307 {"vertsplit", 1},
7308 {"viminfo",
7309#ifdef FEAT_VIMINFO
7310 1
7311#else
7312 0
7313#endif
7314 },
Bram Moolenaarb79ee0c2022-01-01 12:17:00 +00007315 {"vim9script", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007316 {"vimscript-1", 1},
7317 {"vimscript-2", 1},
7318 {"vimscript-3", 1},
7319 {"vimscript-4", 1},
7320 {"virtualedit", 1},
7321 {"visual", 1},
7322 {"visualextra", 1},
7323 {"vreplace", 1},
7324 {"vtp",
7325#ifdef FEAT_VTP
7326 1
7327#else
7328 0
7329#endif
7330 },
Bram Moolenaar074fbd42022-08-26 16:41:14 +01007331 {"wildignore", 1},
Bram Moolenaar54162322022-08-26 16:58:51 +01007332 {"wildmenu", 1},
Bram Moolenaar79296512020-03-22 16:17:14 +01007333 {"windows", 1},
7334 {"winaltkeys",
7335#ifdef FEAT_WAK
7336 1
7337#else
7338 0
7339#endif
7340 },
7341 {"writebackup",
7342#ifdef FEAT_WRITEBACKUP
7343 1
7344#else
7345 0
7346#endif
7347 },
Christian Brabandte085dfd2023-09-30 12:49:18 +02007348 {"xattr",
7349#ifdef FEAT_XATTR
7350 1
7351#else
7352 0
7353#endif
7354 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007355 {"xim",
7356#ifdef FEAT_XIM
7357 1
7358#else
7359 0
7360#endif
7361 },
7362 {"xfontset",
7363#ifdef FEAT_XFONTSET
7364 1
7365#else
7366 0
7367#endif
7368 },
7369 {"xpm",
7370#if defined(FEAT_XPM_W32) || defined(HAVE_XPM)
7371 1
7372#else
7373 0
7374#endif
7375 },
7376 {"xpm_w32", // for backward compatibility
7377#ifdef FEAT_XPM_W32
7378 1
7379#else
7380 0
7381#endif
7382 },
7383 {"xsmp",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007384#ifdef USE_XSMP
Bram Moolenaar79296512020-03-22 16:17:14 +01007385 1
7386#else
7387 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007388#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007389 },
7390 {"xsmp_interact",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007391#ifdef USE_XSMP_INTERACT
Bram Moolenaar79296512020-03-22 16:17:14 +01007392 1
7393#else
7394 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007395#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007396 },
7397 {"xterm_clipboard",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007398#ifdef FEAT_XCLIPBOARD
Bram Moolenaar79296512020-03-22 16:17:14 +01007399 1
7400#else
7401 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007402#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007403 },
7404 {"xterm_save",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007405#ifdef FEAT_XTERM_SAVE
Bram Moolenaar79296512020-03-22 16:17:14 +01007406 1
7407#else
7408 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007409#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007410 },
7411 {"X11",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007412#if defined(UNIX) && defined(FEAT_X11)
Bram Moolenaar79296512020-03-22 16:17:14 +01007413 1
7414#else
7415 0
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007416#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007417 },
Bram Moolenaar80adaa82023-07-07 18:57:40 +01007418 {":tearoff",
7419// same #ifdef as used for ex_tearoff().
7420#if defined(FEAT_GUI_MSWIN) && defined(FEAT_MENU) && defined(FEAT_TEAROFF)
7421 1
7422#else
7423 0
7424#endif
7425 },
Bram Moolenaar79296512020-03-22 16:17:14 +01007426 {NULL, 0}
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007427 };
7428
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02007429 if (in_vim9script()
7430 && (check_for_string_arg(argvars, 0) == FAIL
7431 || check_for_opt_bool_arg(argvars, 1) == FAIL))
7432 return;
7433
Bram Moolenaard155d7a2018-12-21 16:04:21 +01007434 name = tv_get_string(&argvars[0]);
Bram Moolenaar79296512020-03-22 16:17:14 +01007435 for (i = 0; has_list[i].name != NULL; ++i)
7436 if (STRICMP(name, has_list[i].name) == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007437 {
Bram Moolenaar79296512020-03-22 16:17:14 +01007438 x = TRUE;
7439 n = has_list[i].present;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007440 break;
7441 }
7442
Bram Moolenaar79296512020-03-22 16:17:14 +01007443 // features also in has_list[] but sometimes enabled at runtime
7444 if (x == TRUE && n == FALSE)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007445 {
Bram Moolenaar79296512020-03-22 16:17:14 +01007446 if (0)
Bram Moolenaar86b9a3e2020-04-07 19:57:29 +02007447 {
7448 // intentionally empty
7449 }
Bram Moolenaar79296512020-03-22 16:17:14 +01007450#ifdef VIMDLL
7451 else if (STRICMP(name, "filterpipe") == 0)
7452 n = gui.in_use || gui.starting;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007453#endif
7454#if defined(USE_ICONV) && defined(DYNAMIC_ICONV)
7455 else if (STRICMP(name, "iconv") == 0)
7456 n = iconv_enabled(FALSE);
7457#endif
7458#ifdef DYNAMIC_LUA
7459 else if (STRICMP(name, "lua") == 0)
7460 n = lua_enabled(FALSE);
7461#endif
7462#ifdef DYNAMIC_MZSCHEME
7463 else if (STRICMP(name, "mzscheme") == 0)
7464 n = mzscheme_enabled(FALSE);
7465#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007466#ifdef DYNAMIC_PERL
7467 else if (STRICMP(name, "perl") == 0)
7468 n = perl_enabled(FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007469#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007470#ifdef DYNAMIC_PYTHON
7471 else if (STRICMP(name, "python") == 0)
7472 n = python_enabled(FALSE);
7473#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007474#ifdef DYNAMIC_PYTHON3
7475 else if (STRICMP(name, "python3") == 0)
7476 n = python3_enabled(FALSE);
7477#endif
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01007478#if defined(DYNAMIC_PYTHON) || defined(DYNAMIC_PYTHON3)
7479 else if (STRICMP(name, "pythonx") == 0)
7480 {
7481# if defined(DYNAMIC_PYTHON) && defined(DYNAMIC_PYTHON3)
7482 if (p_pyx == 0)
7483 n = python3_enabled(FALSE) || python_enabled(FALSE);
7484 else if (p_pyx == 3)
7485 n = python3_enabled(FALSE);
7486 else if (p_pyx == 2)
7487 n = python_enabled(FALSE);
7488# elif defined(DYNAMIC_PYTHON)
7489 n = python_enabled(FALSE);
7490# elif defined(DYNAMIC_PYTHON3)
7491 n = python3_enabled(FALSE);
7492# endif
7493 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007494#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007495#ifdef DYNAMIC_RUBY
7496 else if (STRICMP(name, "ruby") == 0)
7497 n = ruby_enabled(FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007498#endif
Bram Moolenaar79296512020-03-22 16:17:14 +01007499#ifdef DYNAMIC_TCL
7500 else if (STRICMP(name, "tcl") == 0)
7501 n = tcl_enabled(FALSE);
Bram Moolenaar4b8366b2019-05-04 17:34:34 +02007502#endif
K.Takatad68b2fc2022-02-12 11:18:37 +00007503#ifdef DYNAMIC_SODIUM
7504 else if (STRICMP(name, "sodium") == 0)
7505 n = sodium_enabled(FALSE);
7506#endif
Bram Moolenaar4f974752019-02-17 17:44:42 +01007507#if defined(FEAT_TERMINAL) && defined(MSWIN)
Bram Moolenaara83e3962017-08-17 14:39:07 +02007508 else if (STRICMP(name, "terminal") == 0)
7509 n = terminal_enabled();
7510#endif
Bram Moolenaar33fc4a62022-02-23 18:07:38 +00007511#ifdef DYNAMIC_GPM
7512 else if (STRICMP(name, "mouse_gpm") == 0)
7513 n = gpm_available();
7514#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007515 }
7516
Bram Moolenaar79296512020-03-22 16:17:14 +01007517 // features not in has_list[]
7518 if (x == FALSE)
7519 {
7520 if (STRNICMP(name, "patch", 5) == 0)
7521 {
7522 x = TRUE;
7523 if (name[5] == '-'
7524 && STRLEN(name) >= 11
K.Takatad90f91f2022-07-30 15:43:59 +01007525 && (name[6] >= '1' && name[6] <= '9'))
Bram Moolenaar79296512020-03-22 16:17:14 +01007526 {
K.Takatad90f91f2022-07-30 15:43:59 +01007527 char *end;
7528 int major, minor;
Bram Moolenaar79296512020-03-22 16:17:14 +01007529
K.Takatad90f91f2022-07-30 15:43:59 +01007530 // This works for patch-8.1.2, patch-9.0.3, patch-10.0.4, etc.
7531 // Not for patch-9.10.5.
7532 major = (int)strtoul((char *)name + 6, &end, 10);
7533 if (*end == '.' && vim_isdigit(end[1])
7534 && end[2] == '.' && vim_isdigit(end[3]))
7535 {
7536 minor = atoi(end + 1);
7537
7538 // Expect "patch-9.9.01234".
7539 n = (major < VIM_VERSION_MAJOR
7540 || (major == VIM_VERSION_MAJOR
7541 && (minor < VIM_VERSION_MINOR
7542 || (minor == VIM_VERSION_MINOR
7543 && has_patch(atoi(end + 3))))));
7544 }
Bram Moolenaar79296512020-03-22 16:17:14 +01007545 }
Keith Thompson184f71c2024-01-04 21:19:04 +01007546 else if (SAFE_isdigit(name[5]))
Bram Moolenaar79296512020-03-22 16:17:14 +01007547 n = has_patch(atoi((char *)name + 5));
7548 }
7549 else if (STRICMP(name, "vim_starting") == 0)
7550 {
7551 x = TRUE;
7552 n = (starting != 0);
7553 }
7554 else if (STRICMP(name, "ttyin") == 0)
7555 {
7556 x = TRUE;
7557 n = mch_input_isatty();
7558 }
7559 else if (STRICMP(name, "ttyout") == 0)
7560 {
7561 x = TRUE;
7562 n = stdout_isatty;
7563 }
7564 else if (STRICMP(name, "multi_byte_encoding") == 0)
7565 {
7566 x = TRUE;
7567 n = has_mbyte;
7568 }
7569 else if (STRICMP(name, "gui_running") == 0)
7570 {
7571 x = TRUE;
7572#ifdef FEAT_GUI
7573 n = (gui.in_use || gui.starting);
7574#endif
7575 }
7576 else if (STRICMP(name, "browse") == 0)
7577 {
7578 x = TRUE;
7579#if defined(FEAT_GUI) && defined(FEAT_BROWSE)
7580 n = gui.in_use; // gui_mch_browse() works when GUI is running
7581#endif
7582 }
7583 else if (STRICMP(name, "syntax_items") == 0)
7584 {
7585 x = TRUE;
7586#ifdef FEAT_SYN_HL
7587 n = syntax_present(curwin);
7588#endif
7589 }
7590 else if (STRICMP(name, "vcon") == 0)
7591 {
7592 x = TRUE;
7593#ifdef FEAT_VTP
7594 n = is_term_win32() && has_vtp_working();
7595#endif
7596 }
7597 else if (STRICMP(name, "netbeans_enabled") == 0)
7598 {
7599 x = TRUE;
7600#ifdef FEAT_NETBEANS_INTG
7601 n = netbeans_active();
7602#endif
7603 }
7604 else if (STRICMP(name, "mouse_gpm_enabled") == 0)
7605 {
7606 x = TRUE;
7607#ifdef FEAT_MOUSE_GPM
7608 n = gpm_enabled();
7609#endif
7610 }
7611 else if (STRICMP(name, "conpty") == 0)
7612 {
7613 x = TRUE;
7614#if defined(FEAT_TERMINAL) && defined(MSWIN)
7615 n = use_conpty();
7616#endif
7617 }
7618 else if (STRICMP(name, "clipboard_working") == 0)
7619 {
7620 x = TRUE;
7621#ifdef FEAT_CLIPBOARD
7622 n = clip_star.available;
7623#endif
7624 }
7625 }
7626
Bram Moolenaar04637e22020-09-05 18:45:29 +02007627 if (argvars[1].v_type != VAR_UNKNOWN && tv_get_bool(&argvars[1]))
Bram Moolenaar79296512020-03-22 16:17:14 +01007628 // return whether feature could ever be enabled
7629 rettv->vval.v_number = x;
7630 else
7631 // return whether feature is enabled
7632 rettv->vval.v_number = n;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007633}
7634
7635/*
Bram Moolenaar8cebd432020-11-08 12:49:47 +01007636 * Return TRUE if "feature" can change later.
7637 * Also when checking for the feature has side effects, such as loading a DLL.
7638 */
7639 int
7640dynamic_feature(char_u *feature)
7641{
7642 return (feature == NULL
Bram Moolenaar8cebd432020-11-08 12:49:47 +01007643#if defined(FEAT_GUI) && defined(FEAT_BROWSE)
7644 || (STRICMP(feature, "browse") == 0 && !gui.in_use)
7645#endif
7646#ifdef VIMDLL
7647 || STRICMP(feature, "filterpipe") == 0
7648#endif
Bram Moolenaar29b281b2020-11-10 20:58:00 +01007649#if defined(FEAT_GUI) && !defined(ALWAYS_USE_GUI) && !defined(VIMDLL)
Bram Moolenaar8cebd432020-11-08 12:49:47 +01007650 // this can only change on Unix where the ":gui" command could be
7651 // used.
7652 || (STRICMP(feature, "gui_running") == 0 && !gui.in_use)
7653#endif
7654#if defined(USE_ICONV) && defined(DYNAMIC_ICONV)
7655 || STRICMP(feature, "iconv") == 0
7656#endif
7657#ifdef DYNAMIC_LUA
7658 || STRICMP(feature, "lua") == 0
7659#endif
7660#ifdef FEAT_MOUSE_GPM
7661 || (STRICMP(feature, "mouse_gpm_enabled") == 0 && !gpm_enabled())
7662#endif
7663#ifdef DYNAMIC_MZSCHEME
7664 || STRICMP(feature, "mzscheme") == 0
7665#endif
7666#ifdef FEAT_NETBEANS_INTG
7667 || STRICMP(feature, "netbeans_enabled") == 0
7668#endif
7669#ifdef DYNAMIC_PERL
7670 || STRICMP(feature, "perl") == 0
7671#endif
7672#ifdef DYNAMIC_PYTHON
7673 || STRICMP(feature, "python") == 0
7674#endif
7675#ifdef DYNAMIC_PYTHON3
7676 || STRICMP(feature, "python3") == 0
7677#endif
7678#if defined(DYNAMIC_PYTHON) || defined(DYNAMIC_PYTHON3)
7679 || STRICMP(feature, "pythonx") == 0
7680#endif
7681#ifdef DYNAMIC_RUBY
7682 || STRICMP(feature, "ruby") == 0
7683#endif
7684#ifdef FEAT_SYN_HL
7685 || STRICMP(feature, "syntax_items") == 0
7686#endif
7687#ifdef DYNAMIC_TCL
7688 || STRICMP(feature, "tcl") == 0
7689#endif
7690 // once "starting" is zero it will stay that way
7691 || (STRICMP(feature, "vim_starting") == 0 && starting != 0)
7692 || STRICMP(feature, "multi_byte_encoding") == 0
7693#if defined(FEAT_TERMINAL) && defined(MSWIN)
7694 || STRICMP(feature, "conpty") == 0
7695#endif
7696 );
7697}
7698
7699/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007700 * "haslocaldir()" function
7701 */
7702 static void
7703f_haslocaldir(typval_T *argvars, typval_T *rettv)
7704{
Bram Moolenaar00aa0692019-04-27 20:37:57 +02007705 tabpage_T *tp = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007706 win_T *wp = NULL;
7707
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02007708 if (in_vim9script()
7709 && (check_for_opt_number_arg(argvars, 0) == FAIL
7710 || (argvars[0].v_type != VAR_UNKNOWN
7711 && check_for_opt_number_arg(argvars, 1) == FAIL)))
7712 return;
7713
Bram Moolenaar00aa0692019-04-27 20:37:57 +02007714 wp = find_tabwin(&argvars[0], &argvars[1], &tp);
7715
7716 // Check for window-local and tab-local directories
7717 if (wp != NULL && wp->w_localdir != NULL)
7718 rettv->vval.v_number = 1;
7719 else if (tp != NULL && tp->tp_localdir != NULL)
7720 rettv->vval.v_number = 2;
7721 else
7722 rettv->vval.v_number = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007723}
7724
7725/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007726 * "highlightID(name)" function
7727 */
7728 static void
7729f_hlID(typval_T *argvars, typval_T *rettv)
7730{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02007731 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
7732 return;
7733
Bram Moolenaard155d7a2018-12-21 16:04:21 +01007734 rettv->vval.v_number = syn_name2id(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007735}
7736
7737/*
7738 * "highlight_exists()" function
7739 */
7740 static void
7741f_hlexists(typval_T *argvars, typval_T *rettv)
7742{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02007743 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
7744 return;
7745
Bram Moolenaard155d7a2018-12-21 16:04:21 +01007746 rettv->vval.v_number = highlight_exists(tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007747}
7748
7749/*
7750 * "hostname()" function
7751 */
7752 static void
7753f_hostname(typval_T *argvars UNUSED, typval_T *rettv)
7754{
7755 char_u hostname[256];
7756
7757 mch_get_host_name(hostname, 256);
7758 rettv->v_type = VAR_STRING;
7759 rettv->vval.v_string = vim_strsave(hostname);
7760}
7761
7762/*
Ernie Raelc8e158b2024-07-09 18:39:52 +02007763 * "id()" function
7764 * Identity. Return address of item as a hex string, %p format.
7765 * Currently only valid for object/container types.
7766 * Return empty string if not an object.
7767 */
Zoltan Arpadffy10231ac2024-08-18 16:59:20 +02007768#ifdef VMS // VMS does not have defined uintptr_t
7769# if defined(HAVE_NO_LONG_LONG)
7770typedef unsigned int uintptr_t;
7771# else
7772typedef unsigned long long uintptr_t;
7773# endif
7774#endif // VMS
7775
John Marriottb3b2bee2024-07-14 11:12:51 +02007776 static void
Ernie Raelc8e158b2024-07-09 18:39:52 +02007777f_id(typval_T *argvars, typval_T *rettv)
7778{
Ernie Rael05124252024-07-11 22:10:45 +02007779 char numbuf[NUMBUFLEN];
7780 char *p = numbuf;
Ernie Raelc8e158b2024-07-09 18:39:52 +02007781
7782 switch (argvars[0].v_type)
7783 {
7784 case VAR_LIST:
7785 case VAR_DICT:
7786 case VAR_OBJECT:
7787 case VAR_JOB:
7788 case VAR_CHANNEL:
7789 case VAR_BLOB:
7790 // Assume pointer value in typval_T vval union at common location.
7791 if (argvars[0].vval.v_object != NULL)
Ernie Rael05124252024-07-11 22:10:45 +02007792 {
7793 // "v" gets the address as an integer
7794 uintptr_t v = (uintptr_t)(void *)argvars[0].vval.v_object;
7795 // Build a hex string from the item's address; it is in
7796 // reverse order. Ignore trailing zeros.
7797 for (; p < numbuf + sizeof(uintptr_t) * 2 && v != 0;
7798 ++p, v >>= 4)
7799 *p = "0123456789abcdef"[v & 0xf];
7800 }
Ernie Raelc8e158b2024-07-09 18:39:52 +02007801 default:
Ernie Rael05124252024-07-11 22:10:45 +02007802 break;
Ernie Raelc8e158b2024-07-09 18:39:52 +02007803 }
Ernie Rael05124252024-07-11 22:10:45 +02007804 *p = NUL;
Ernie Raelc8e158b2024-07-09 18:39:52 +02007805
7806 rettv->v_type = VAR_STRING;
Ernie Rael05124252024-07-11 22:10:45 +02007807 rettv->vval.v_string = vim_strsave((char_u *)numbuf);
Ernie Raelc8e158b2024-07-09 18:39:52 +02007808}
7809
7810/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007811 * "index()" function
7812 */
7813 static void
7814f_index(typval_T *argvars, typval_T *rettv)
7815{
7816 list_T *l;
7817 listitem_T *item;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007818 blob_T *b;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007819 long idx = 0;
7820 int ic = FALSE;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007821 int error = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007822
7823 rettv->vval.v_number = -1;
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02007824
7825 if (in_vim9script()
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +02007826 && (check_for_list_or_blob_arg(argvars, 0) == FAIL
7827 || (argvars[0].v_type == VAR_BLOB
7828 && check_for_number_arg(argvars, 1) == FAIL)
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02007829 || check_for_opt_number_arg(argvars, 2) == FAIL
7830 || (argvars[2].v_type != VAR_UNKNOWN
7831 && check_for_opt_bool_arg(argvars, 3) == FAIL)))
7832 return;
7833
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007834 if (argvars[0].v_type == VAR_BLOB)
7835 {
7836 typval_T tv;
7837 int start = 0;
7838
7839 if (argvars[2].v_type != VAR_UNKNOWN)
7840 {
7841 start = tv_get_number_chk(&argvars[2], &error);
7842 if (error)
7843 return;
7844 }
7845 b = argvars[0].vval.v_blob;
7846 if (b == NULL)
7847 return;
Bram Moolenaar05500ec2019-01-13 19:10:33 +01007848 if (start < 0)
7849 {
7850 start = blob_len(b) + start;
7851 if (start < 0)
7852 start = 0;
7853 }
7854
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007855 for (idx = start; idx < blob_len(b); ++idx)
7856 {
7857 tv.v_type = VAR_NUMBER;
7858 tv.vval.v_number = blob_get(b, idx);
Yinzuo Jiang7ccd1a22024-07-04 17:20:53 +02007859 if (tv_equal(&tv, &argvars[1], ic))
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007860 {
7861 rettv->vval.v_number = idx;
7862 return;
7863 }
7864 }
7865 return;
7866 }
7867 else if (argvars[0].v_type != VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007868 {
Bram Moolenaar460ae5d2022-01-01 14:19:49 +00007869 emsg(_(e_list_or_blob_required));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007870 return;
7871 }
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01007872
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007873 l = argvars[0].vval.v_list;
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00007874 if (l == NULL)
7875 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007876
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00007877 CHECK_LIST_MATERIALIZE(l);
7878 item = l->lv_first;
7879 if (argvars[2].v_type != VAR_UNKNOWN)
7880 {
7881 // Start at specified item. Use the cached index that list_find()
7882 // sets, so that a negative number also works.
7883 item = list_find(l, (long)tv_get_number_chk(&argvars[2], &error));
7884 idx = l->lv_u.mat.lv_idx;
7885 if (argvars[3].v_type != VAR_UNKNOWN)
7886 ic = (int)tv_get_bool_chk(&argvars[3], &error);
7887 if (error)
7888 item = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007889 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00007890
7891 for ( ; item != NULL; item = item->li_next, ++idx)
Yinzuo Jiang7ccd1a22024-07-04 17:20:53 +02007892 if (tv_equal(&item->li_tv, &argvars[1], ic))
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00007893 {
7894 rettv->vval.v_number = idx;
7895 break;
7896 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02007897}
7898
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01007899/*
7900 * Evaluate 'expr' with the v:key and v:val arguments and return the result.
7901 * The expression is expected to return a boolean value. The caller should set
7902 * the VV_KEY and VV_VAL vim variables before calling this function.
7903 */
7904 static int
7905indexof_eval_expr(typval_T *expr)
7906{
7907 typval_T argv[3];
7908 typval_T newtv;
7909 varnumber_T found;
7910 int error = FALSE;
7911
7912 argv[0] = *get_vim_var_tv(VV_KEY);
7913 argv[1] = *get_vim_var_tv(VV_VAL);
7914 newtv.v_type = VAR_UNKNOWN;
7915
zeertzjqad0c4422023-08-17 22:15:47 +02007916 if (eval_expr_typval(expr, FALSE, argv, 2, NULL, &newtv) == FAIL)
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01007917 return FALSE;
7918
7919 found = tv_get_bool_chk(&newtv, &error);
Yegappan Lakshmanan63acae12022-08-14 12:07:11 +01007920 clear_tv(&newtv);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01007921
7922 return error ? FALSE : found;
7923}
7924
7925/*
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01007926 * Evaluate 'expr' for each byte in the Blob 'b' starting with the byte at
7927 * 'startidx' and return the index of the byte where 'expr' is TRUE. Returns
7928 * -1 if 'expr' doesn't evaluate to TRUE for any of the bytes.
7929 */
7930 static int
7931indexof_blob(blob_T *b, long startidx, typval_T *expr)
7932{
7933 long idx = 0;
7934
7935 if (b == NULL)
7936 return -1;
7937
7938 if (startidx < 0)
7939 {
7940 // negative index: index from the last byte
7941 startidx = blob_len(b) + startidx;
7942 if (startidx < 0)
7943 startidx = 0;
7944 }
7945
7946 set_vim_var_type(VV_KEY, VAR_NUMBER);
7947 set_vim_var_type(VV_VAL, VAR_NUMBER);
7948
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02007949 int called_emsg_start = called_emsg;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01007950 for (idx = startidx; idx < blob_len(b); ++idx)
7951 {
7952 set_vim_var_nr(VV_KEY, idx);
7953 set_vim_var_nr(VV_VAL, blob_get(b, idx));
7954
7955 if (indexof_eval_expr(expr))
7956 return idx;
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02007957
7958 if (called_emsg != called_emsg_start)
7959 return -1;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01007960 }
7961
7962 return -1;
7963}
7964
7965/*
7966 * Evaluate 'expr' for each item in the List 'l' starting with the item at
7967 * 'startidx' and return the index of the item where 'expr' is TRUE. Returns
7968 * -1 if 'expr' doesn't evaluate to TRUE for any of the items.
7969 */
7970 static int
7971indexof_list(list_T *l, long startidx, typval_T *expr)
7972{
7973 listitem_T *item;
7974 long idx = 0;
Yegappan Lakshmanan63acae12022-08-14 12:07:11 +01007975 int found;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01007976
7977 if (l == NULL)
7978 return -1;
7979
7980 CHECK_LIST_MATERIALIZE(l);
7981
7982 if (startidx == 0)
7983 item = l->lv_first;
7984 else
7985 {
7986 // Start at specified item. Use the cached index that list_find()
7987 // sets, so that a negative number also works.
7988 item = list_find(l, startidx);
7989 if (item != NULL)
7990 idx = l->lv_u.mat.lv_idx;
7991 }
7992
7993 set_vim_var_type(VV_KEY, VAR_NUMBER);
7994
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02007995 int called_emsg_start = called_emsg;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01007996 for ( ; item != NULL; item = item->li_next, ++idx)
7997 {
7998 set_vim_var_nr(VV_KEY, idx);
7999 copy_tv(&item->li_tv, get_vim_var_tv(VV_VAL));
8000
Yegappan Lakshmanan63acae12022-08-14 12:07:11 +01008001 found = indexof_eval_expr(expr);
8002 clear_tv(get_vim_var_tv(VV_VAL));
8003
8004 if (found)
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008005 return idx;
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008006
8007 if (called_emsg != called_emsg_start)
8008 return -1;
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008009 }
8010
8011 return -1;
8012}
8013
8014/*
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008015 * "indexof()" function
8016 */
8017 static void
8018f_indexof(typval_T *argvars, typval_T *rettv)
8019{
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008020 long startidx = 0;
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008021 typval_T save_val;
8022 typval_T save_key;
8023 int save_did_emsg;
8024
8025 rettv->vval.v_number = -1;
8026
8027 if (check_for_list_or_blob_arg(argvars, 0) == FAIL
8028 || check_for_string_or_func_arg(argvars, 1) == FAIL
8029 || check_for_opt_dict_arg(argvars, 2) == FAIL)
8030 return;
8031
Yegappan Lakshmananfe424d12024-05-17 18:20:43 +02008032 if ((argvars[1].v_type == VAR_STRING &&
8033 (argvars[1].vval.v_string == NULL
8034 || *argvars[1].vval.v_string == NUL))
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008035 || (argvars[1].v_type == VAR_FUNC
8036 && argvars[1].vval.v_partial == NULL))
8037 return;
8038
8039 if (argvars[2].v_type == VAR_DICT)
8040 startidx = dict_get_number_def(argvars[2].vval.v_dict, "startidx", 0);
8041
8042 prepare_vimvar(VV_VAL, &save_val);
8043 prepare_vimvar(VV_KEY, &save_key);
8044
8045 // We reset "did_emsg" to be able to detect whether an error occurred
8046 // during evaluation of the expression.
8047 save_did_emsg = did_emsg;
8048 did_emsg = FALSE;
8049
8050 if (argvars[0].v_type == VAR_BLOB)
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008051 rettv->vval.v_number = indexof_blob(argvars[0].vval.v_blob, startidx,
8052 &argvars[1]);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008053 else
Yegappan Lakshmanan3fbf6cd2022-08-13 21:35:13 +01008054 rettv->vval.v_number = indexof_list(argvars[0].vval.v_list, startidx,
8055 &argvars[1]);
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008056
Yegappan Lakshmananb2186552022-08-13 13:09:20 +01008057 restore_vimvar(VV_KEY, &save_key);
8058 restore_vimvar(VV_VAL, &save_val);
8059 did_emsg |= save_did_emsg;
8060}
8061
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008062static int inputsecret_flag = 0;
8063
8064/*
8065 * "input()" function
8066 * Also handles inputsecret() when inputsecret is set.
8067 */
8068 static void
8069f_input(typval_T *argvars, typval_T *rettv)
8070{
8071 get_user_input(argvars, rettv, FALSE, inputsecret_flag);
8072}
8073
8074/*
8075 * "inputdialog()" function
8076 */
8077 static void
8078f_inputdialog(typval_T *argvars, typval_T *rettv)
8079{
8080#if defined(FEAT_GUI_TEXTDIALOG)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008081 // Use a GUI dialog if the GUI is running and 'c' is not in 'guioptions'
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008082 if (gui.in_use && vim_strchr(p_go, GO_CONDIALOG) == NULL)
8083 {
8084 char_u *message;
8085 char_u buf[NUMBUFLEN];
8086 char_u *defstr = (char_u *)"";
8087
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008088 if (in_vim9script()
8089 && (check_for_string_arg(argvars, 0) == FAIL
8090 || check_for_opt_string_arg(argvars, 1) == FAIL
8091 || (argvars[1].v_type != VAR_UNKNOWN
8092 && check_for_opt_string_arg(argvars, 2) == FAIL)))
8093 return;
8094
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008095 message = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008096 if (argvars[1].v_type != VAR_UNKNOWN
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008097 && (defstr = tv_get_string_buf_chk(&argvars[1], buf)) != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008098 vim_strncpy(IObuff, defstr, IOSIZE - 1);
8099 else
8100 IObuff[0] = NUL;
8101 if (message != NULL && defstr != NULL
8102 && do_dialog(VIM_QUESTION, NULL, message,
8103 (char_u *)_("&OK\n&Cancel"), 1, IObuff, FALSE) == 1)
8104 rettv->vval.v_string = vim_strsave(IObuff);
8105 else
8106 {
8107 if (message != NULL && defstr != NULL
8108 && argvars[1].v_type != VAR_UNKNOWN
8109 && argvars[2].v_type != VAR_UNKNOWN)
8110 rettv->vval.v_string = vim_strsave(
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008111 tv_get_string_buf(&argvars[2], buf));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008112 else
8113 rettv->vval.v_string = NULL;
8114 }
8115 rettv->v_type = VAR_STRING;
8116 }
8117 else
8118#endif
8119 get_user_input(argvars, rettv, TRUE, inputsecret_flag);
8120}
8121
8122/*
8123 * "inputlist()" function
8124 */
8125 static void
8126f_inputlist(typval_T *argvars, typval_T *rettv)
8127{
Bram Moolenaar50985eb2020-01-27 22:09:39 +01008128 list_T *l;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008129 listitem_T *li;
8130 int selected;
8131 int mouse_used;
8132
8133#ifdef NO_CONSOLE_INPUT
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008134 // While starting up, there is no place to enter text. When running tests
8135 // with --not-a-term we assume feedkeys() will be used.
Bram Moolenaar91d348a2017-07-29 20:16:03 +02008136 if (no_console_input() && !is_not_a_term())
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008137 return;
8138#endif
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008139 if (in_vim9script() && check_for_list_arg(argvars, 0) == FAIL)
8140 return;
8141
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008142 if (argvars[0].v_type != VAR_LIST || argvars[0].vval.v_list == NULL)
8143 {
Bram Moolenaar3a846e62022-01-01 16:21:00 +00008144 semsg(_(e_argument_of_str_must_be_list), "inputlist()");
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008145 return;
8146 }
8147
8148 msg_start();
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008149 msg_row = Rows - 1; // for when 'cmdheight' > 1
8150 lines_left = Rows; // avoid more prompt
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008151 msg_scroll = TRUE;
8152 msg_clr_eos();
8153
Bram Moolenaar50985eb2020-01-27 22:09:39 +01008154 l = argvars[0].vval.v_list;
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02008155 CHECK_LIST_MATERIALIZE(l);
Bram Moolenaar00d253e2020-04-06 22:13:01 +02008156 FOR_ALL_LIST_ITEMS(l, li)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008157 {
Bram Moolenaar32526b32019-01-19 17:43:09 +01008158 msg_puts((char *)tv_get_string(&li->li_tv));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008159 msg_putchar('\n');
8160 }
8161
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008162 // Ask for choice.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008163 selected = prompt_for_number(&mouse_used);
8164 if (mouse_used)
8165 selected -= lines_left;
8166
8167 rettv->vval.v_number = selected;
8168}
8169
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008170static garray_T ga_userinput = {0, 0, sizeof(tasave_T), 4, NULL};
8171
8172/*
8173 * "inputrestore()" function
8174 */
8175 static void
8176f_inputrestore(typval_T *argvars UNUSED, typval_T *rettv)
8177{
8178 if (ga_userinput.ga_len > 0)
8179 {
8180 --ga_userinput.ga_len;
8181 restore_typeahead((tasave_T *)(ga_userinput.ga_data)
Bram Moolenaarc41badb2021-06-07 22:04:52 +02008182 + ga_userinput.ga_len, TRUE);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008183 // default return is zero == OK
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008184 }
8185 else if (p_verbose > 1)
8186 {
Bram Moolenaar32526b32019-01-19 17:43:09 +01008187 verb_msg(_("called inputrestore() more often than inputsave()"));
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008188 rettv->vval.v_number = 1; // Failed
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008189 }
8190}
8191
8192/*
8193 * "inputsave()" function
8194 */
8195 static void
8196f_inputsave(typval_T *argvars UNUSED, typval_T *rettv)
8197{
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008198 // Add an entry to the stack of typeahead storage.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008199 if (ga_grow(&ga_userinput, 1) == OK)
8200 {
8201 save_typeahead((tasave_T *)(ga_userinput.ga_data)
8202 + ga_userinput.ga_len);
8203 ++ga_userinput.ga_len;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008204 // default return is zero == OK
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008205 }
8206 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008207 rettv->vval.v_number = 1; // Failed
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008208}
8209
8210/*
8211 * "inputsecret()" function
8212 */
8213 static void
8214f_inputsecret(typval_T *argvars, typval_T *rettv)
8215{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008216 if (in_vim9script()
8217 && (check_for_string_arg(argvars, 0) == FAIL
8218 || check_for_opt_string_arg(argvars, 1) == FAIL))
8219 return;
8220
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008221 ++cmdline_star;
8222 ++inputsecret_flag;
8223 f_input(argvars, rettv);
8224 --cmdline_star;
8225 --inputsecret_flag;
8226}
8227
8228/*
Bram Moolenaar67a2deb2019-11-25 00:05:32 +01008229 * "interrupt()" function
8230 */
8231 static void
8232f_interrupt(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
8233{
8234 got_int = TRUE;
8235}
8236
8237/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008238 * "invert(expr)" function
8239 */
8240 static void
8241f_invert(typval_T *argvars, typval_T *rettv)
8242{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008243 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
8244 return;
8245
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008246 rettv->vval.v_number = ~tv_get_number_chk(&argvars[0], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008247}
8248
8249/*
Ernie Rael4c8da022023-10-11 21:35:11 +02008250 * Free resources in lval_root allocated by fill_exec_lval_root().
8251 */
8252 static void
8253free_lval_root(lval_root_T *root)
8254{
8255 if (root->lr_tv != NULL)
8256 free_tv(root->lr_tv);
8257 class_unref(root->lr_cl_exec);
8258 root->lr_tv = NULL;
8259 root->lr_cl_exec = NULL;
8260}
8261
8262/*
8263 * This is used if executing in a method, the argument string is a
Ernie Rael0f058d12023-10-14 11:25:04 +02008264 * variable/item expr/reference. It may start with a potential class/object
8265 * variable.
Ernie Rael4c8da022023-10-11 21:35:11 +02008266 *
Ernie Rael0f058d12023-10-14 11:25:04 +02008267 * Adjust "root" as needed; lr_tv may be changed or freed.
Ernie Rael4c8da022023-10-11 21:35:11 +02008268 *
8269 * Always returns OK.
8270 * Free resources and return FAIL if the root should not be used. Otherwise OK.
8271 */
8272
8273 static int
Ernie Rael0f058d12023-10-14 11:25:04 +02008274fix_variable_reference_lval_root(lval_root_T *root, char_u *name)
Ernie Rael4c8da022023-10-11 21:35:11 +02008275{
Ernie Rael4c8da022023-10-11 21:35:11 +02008276
Ernie Rael0f058d12023-10-14 11:25:04 +02008277 // Check if lr_tv is the name of an object/class reference: name start with
8278 // "this" or name is class variable. Clear lr_tv if neither.
8279 int found_member = FALSE;
Ernie Rael4c8da022023-10-11 21:35:11 +02008280 if (root->lr_tv->v_type == VAR_OBJECT)
8281 {
Ernie Rael0f058d12023-10-14 11:25:04 +02008282 if (STRNCMP("this.", name, 5) == 0 ||STRCMP("this", name) == 0)
8283 found_member = TRUE;
Ernie Rael4c8da022023-10-11 21:35:11 +02008284 }
Ernie Rael0f058d12023-10-14 11:25:04 +02008285 if (!found_member) // not object member, try class member
Ernie Rael4c8da022023-10-11 21:35:11 +02008286 {
8287 // Explicitly check if the name is a class member.
8288 // If it's not then do nothing.
Ernie Rael0f058d12023-10-14 11:25:04 +02008289 char_u *end;
Ernie Rael4c8da022023-10-11 21:35:11 +02008290 for (end = name; ASCII_ISALNUM(*end) || *end == '_'; ++end)
8291 ;
Ernie Rael0f058d12023-10-14 11:25:04 +02008292 int idx = class_member_idx(root->lr_cl_exec, name, end - name);
8293 if (idx >= 0)
Ernie Rael4c8da022023-10-11 21:35:11 +02008294 {
Ernie Rael0f058d12023-10-14 11:25:04 +02008295 // A class variable, replace lr_tv with it
8296 clear_tv(root->lr_tv);
8297 copy_tv(&root->lr_cl_exec->class_members_tv[idx], root->lr_tv);
8298 found_member = TRUE;
Ernie Rael4c8da022023-10-11 21:35:11 +02008299 }
8300 }
Ernie Rael0f058d12023-10-14 11:25:04 +02008301 if (!found_member)
Ernie Rael4c8da022023-10-11 21:35:11 +02008302 {
8303 free_tv(root->lr_tv);
8304 root->lr_tv = NULL; // Not a member variable
8305 }
Ernie Rael4c8da022023-10-11 21:35:11 +02008306 // If FAIL, then must free_lval_root(root);
8307 return OK;
8308}
8309
8310/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008311 * "islocked()" function
8312 */
8313 static void
8314f_islocked(typval_T *argvars, typval_T *rettv)
8315{
8316 lval_T lv;
8317 char_u *end;
8318 dictitem_T *di;
8319
8320 rettv->vval.v_number = -1;
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02008321
8322 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
8323 return;
8324
Ernie Rael4c8da022023-10-11 21:35:11 +02008325 char_u *name = tv_get_string(&argvars[0]);
8326#ifdef LOG_LOCKVAR
8327 ch_log(NULL, "LKVAR: f_islocked(): name: %s", name);
8328#endif
8329
8330 lval_root_T aroot; // fully initialized in fill_exec_lval_root
8331 lval_root_T *root = NULL;
8332
8333 // Set up lval_root if executing in a method.
8334 if (fill_exec_lval_root(&aroot) == OK)
8335 {
8336 // Almost always produces a valid lval_root since lr_cl_exec is used
8337 // for access verification, lr_tv may be set to NULL.
Ernie Rael0f058d12023-10-14 11:25:04 +02008338 if (fix_variable_reference_lval_root(&aroot, name) == OK)
Ernie Rael4c8da022023-10-11 21:35:11 +02008339 root = &aroot;
Ernie Rael4c8da022023-10-11 21:35:11 +02008340 }
8341
8342 lval_root_T *lval_root_save = lval_root;
8343 lval_root = root;
8344 end = get_lval(name, NULL, &lv, FALSE, FALSE,
Bram Moolenaarbd77aa92021-08-12 17:06:05 +02008345 GLV_NO_AUTOLOAD | GLV_READ_ONLY | GLV_NO_DECL,
8346 FNE_CHECK_START);
Ernie Rael4c8da022023-10-11 21:35:11 +02008347 lval_root = lval_root_save;
8348
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008349 if (end != NULL && lv.ll_name != NULL)
8350 {
8351 if (*end != NUL)
Bram Moolenaar1840a7b2021-07-13 20:32:29 +02008352 {
8353 semsg(_(lv.ll_name == lv.ll_name_end
Bram Moolenaar0bd663a2022-01-22 10:24:47 +00008354 ? e_invalid_argument_str : e_trailing_characters_str), end);
Bram Moolenaar1840a7b2021-07-13 20:32:29 +02008355 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008356 else
8357 {
8358 if (lv.ll_tv == NULL)
8359 {
Bram Moolenaar79518e22017-02-17 16:31:35 +01008360 di = find_var(lv.ll_name, NULL, TRUE);
8361 if (di != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008362 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008363 // Consider a variable locked when:
8364 // 1. the variable itself is locked
8365 // 2. the value of the variable is locked.
8366 // 3. the List or Dict value is locked.
Bram Moolenaar79518e22017-02-17 16:31:35 +01008367 rettv->vval.v_number = ((di->di_flags & DI_FLAGS_LOCK)
8368 || tv_islocked(&di->di_tv));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008369 }
8370 }
Ernie Rael4c8da022023-10-11 21:35:11 +02008371 else if (lv.ll_is_root)
8372 {
8373 rettv->vval.v_number = tv_islocked(lv.ll_tv);
8374 }
Ernie Rael9771b2a2023-10-07 22:05:40 +02008375 else if (lv.ll_object != NULL)
8376 {
8377 typval_T *tv = ((typval_T *)(lv.ll_object + 1)) + lv.ll_oi;
8378 rettv->vval.v_number = tv_islocked(tv);
8379#ifdef LOG_LOCKVAR
8380 ch_log(NULL, "LKVAR: f_islocked(): name %s (obj)", lv.ll_name);
8381#endif
8382 }
8383 else if (lv.ll_class != NULL)
8384 {
8385 typval_T *tv = &lv.ll_class->class_members_tv[lv.ll_oi];
8386 rettv->vval.v_number = tv_islocked(tv);
8387#ifdef LOG_LOCKVAR
8388 ch_log(NULL, "LKVAR: f_islocked(): name %s (cl)", lv.ll_name);
8389#endif
8390 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008391 else if (lv.ll_range)
Bram Moolenaar677658a2022-01-05 16:09:06 +00008392 emsg(_(e_range_not_allowed));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008393 else if (lv.ll_newkey != NULL)
Bram Moolenaara9fa8c52023-01-02 18:10:04 +00008394 semsg(_(e_key_not_present_in_dictionary_str), lv.ll_newkey);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008395 else if (lv.ll_list != NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008396 // List item.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008397 rettv->vval.v_number = tv_islocked(&lv.ll_li->li_tv);
8398 else
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008399 // Dictionary item.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008400 rettv->vval.v_number = tv_islocked(&lv.ll_di->di_tv);
8401 }
8402 }
8403
Ernie Rael4c8da022023-10-11 21:35:11 +02008404 if (root != NULL)
8405 free_lval_root(root);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008406 clear_lval(&lv);
8407}
8408
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008409/*
zeertzjqcdc83932022-09-12 13:38:41 +01008410 * "keytrans()" function
8411 */
8412 static void
8413f_keytrans(typval_T *argvars, typval_T *rettv)
8414{
8415 char_u *escaped;
8416
8417 rettv->v_type = VAR_STRING;
8418 if (check_for_string_arg(argvars, 0) == FAIL
8419 || argvars[0].vval.v_string == NULL)
8420 return;
8421 // Need to escape K_SPECIAL and CSI for mb_unescape().
8422 escaped = vim_strsave_escape_csi(argvars[0].vval.v_string);
8423 rettv->vval.v_string = str2special_save(escaped, TRUE, TRUE);
8424 vim_free(escaped);
8425}
8426
8427/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008428 * "last_buffer_nr()" function.
8429 */
8430 static void
8431f_last_buffer_nr(typval_T *argvars UNUSED, typval_T *rettv)
8432{
8433 int n = 0;
8434 buf_T *buf;
8435
Bram Moolenaar29323592016-07-24 22:04:11 +02008436 FOR_ALL_BUFFERS(buf)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008437 if (n < buf->b_fnum)
8438 n = buf->b_fnum;
8439
8440 rettv->vval.v_number = n;
8441}
8442
8443/*
8444 * "len()" function
8445 */
LemonBoy58f331a2022-04-02 21:59:06 +01008446 void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008447f_len(typval_T *argvars, typval_T *rettv)
8448{
8449 switch (argvars[0].v_type)
8450 {
8451 case VAR_STRING:
8452 case VAR_NUMBER:
8453 rettv->vval.v_number = (varnumber_T)STRLEN(
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008454 tv_get_string(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008455 break;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +01008456 case VAR_BLOB:
8457 rettv->vval.v_number = blob_len(argvars[0].vval.v_blob);
8458 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008459 case VAR_LIST:
8460 rettv->vval.v_number = list_len(argvars[0].vval.v_list);
8461 break;
8462 case VAR_DICT:
8463 rettv->vval.v_number = dict_len(argvars[0].vval.v_dict);
8464 break;
Yegappan Lakshmanand3eae7b2024-03-03 16:26:58 +01008465 case VAR_OBJECT:
8466 rettv->vval.v_number = object_len(argvars[0].vval.v_object);
8467 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008468 case VAR_UNKNOWN:
Bram Moolenaar4c683752020-04-05 21:38:23 +02008469 case VAR_ANY:
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01008470 case VAR_VOID:
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +01008471 case VAR_BOOL:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008472 case VAR_SPECIAL:
8473 case VAR_FLOAT:
8474 case VAR_FUNC:
8475 case VAR_PARTIAL:
8476 case VAR_JOB:
8477 case VAR_CHANNEL:
Bram Moolenaarf18332f2021-05-07 17:55:55 +02008478 case VAR_INSTR:
Bram Moolenaar00b28d62022-12-08 15:32:33 +00008479 case VAR_CLASS:
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +02008480 case VAR_TYPEALIAS:
Bram Moolenaara6f79292022-01-04 21:30:47 +00008481 emsg(_(e_invalid_type_for_len));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008482 break;
8483 }
8484}
8485
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008486 static void
Bram Moolenaar6d721c72017-01-17 16:56:28 +01008487libcall_common(typval_T *argvars UNUSED, typval_T *rettv, int type)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008488{
8489#ifdef FEAT_LIBCALL
8490 char_u *string_in;
8491 char_u **string_result;
8492 int nr_result;
8493#endif
8494
8495 rettv->v_type = type;
8496 if (type != VAR_NUMBER)
8497 rettv->vval.v_string = NULL;
8498
8499 if (check_restricted() || check_secure())
8500 return;
8501
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +02008502 if (in_vim9script()
8503 && (check_for_string_arg(argvars, 0) == FAIL
8504 || check_for_string_arg(argvars, 1) == FAIL
8505 || check_for_string_or_number_arg(argvars, 2) == FAIL))
8506 return;
8507
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008508#ifdef FEAT_LIBCALL
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008509 // The first two args must be strings, otherwise it's meaningless
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008510 if (argvars[0].v_type == VAR_STRING && argvars[1].v_type == VAR_STRING)
8511 {
8512 string_in = NULL;
8513 if (argvars[2].v_type == VAR_STRING)
8514 string_in = argvars[2].vval.v_string;
8515 if (type == VAR_NUMBER)
Bram Moolenaar87e15872021-09-02 19:53:07 +02008516 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008517 string_result = NULL;
Bram Moolenaar87e15872021-09-02 19:53:07 +02008518 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008519 else
Bram Moolenaar87e15872021-09-02 19:53:07 +02008520 {
8521 rettv->vval.v_string = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008522 string_result = &rettv->vval.v_string;
Bram Moolenaar87e15872021-09-02 19:53:07 +02008523 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008524 if (mch_libcall(argvars[0].vval.v_string,
8525 argvars[1].vval.v_string,
8526 string_in,
8527 argvars[2].vval.v_number,
8528 string_result,
8529 &nr_result) == OK
8530 && type == VAR_NUMBER)
8531 rettv->vval.v_number = nr_result;
8532 }
8533#endif
8534}
8535
8536/*
8537 * "libcall()" function
8538 */
8539 static void
8540f_libcall(typval_T *argvars, typval_T *rettv)
8541{
8542 libcall_common(argvars, rettv, VAR_STRING);
8543}
8544
8545/*
8546 * "libcallnr()" function
8547 */
8548 static void
8549f_libcallnr(typval_T *argvars, typval_T *rettv)
8550{
8551 libcall_common(argvars, rettv, VAR_NUMBER);
8552}
8553
8554/*
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008555 * "line(string, [winid])" function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008556 */
8557 static void
8558f_line(typval_T *argvars, typval_T *rettv)
8559{
8560 linenr_T lnum = 0;
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008561 pos_T *fp = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008562 int fnum;
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008563 int id;
8564 tabpage_T *tp;
8565 win_T *wp;
Bram Moolenaar18f47402022-01-06 13:24:51 +00008566 switchwin_T switchwin;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008567
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02008568 if (in_vim9script()
8569 && (check_for_string_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008570 || check_for_opt_number_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan1a71d312021-07-15 12:49:58 +02008571 return;
8572
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008573 if (argvars[1].v_type != VAR_UNKNOWN)
8574 {
8575 // use window specified in the second argument
8576 id = (int)tv_get_number(&argvars[1]);
8577 wp = win_id2wp_tp(id, &tp);
8578 if (wp != NULL && tp != NULL)
8579 {
Bram Moolenaar18f47402022-01-06 13:24:51 +00008580 if (switch_win_noblock(&switchwin, wp, tp, TRUE) == OK)
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008581 {
John Marriott69f85c62024-10-31 10:53:43 +01008582#ifdef FEAT_DIFF
Christian Brabandt05a40e02024-10-29 20:29:04 +01008583 // in diff mode, prevent that the window scrolls
8584 // and keep the topline
8585 if (curwin->w_p_diff && switchwin.sw_curwin->w_p_diff)
8586 skip_update_topline = TRUE;
John Marriott69f85c62024-10-31 10:53:43 +01008587#endif
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008588 check_cursor();
Bram Moolenaar6f02b002021-01-10 20:22:54 +01008589 fp = var2fpos(&argvars[0], TRUE, &fnum, FALSE);
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008590 }
John Marriott69f85c62024-10-31 10:53:43 +01008591#ifdef FEAT_DIFF
Christian Brabandt05a40e02024-10-29 20:29:04 +01008592 if (curwin->w_p_diff && switchwin.sw_curwin->w_p_diff)
8593 skip_update_topline = FALSE;
John Marriott69f85c62024-10-31 10:53:43 +01008594#endif
Bram Moolenaar18f47402022-01-06 13:24:51 +00008595 restore_win_noblock(&switchwin, TRUE);
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008596 }
8597 }
8598 else
8599 // use current window
Bram Moolenaar6f02b002021-01-10 20:22:54 +01008600 fp = var2fpos(&argvars[0], TRUE, &fnum, FALSE);
Bram Moolenaar8e0a8e72019-09-02 22:56:24 +02008601
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008602 if (fp != NULL)
8603 lnum = fp->lnum;
8604 rettv->vval.v_number = lnum;
8605}
8606
8607/*
8608 * "line2byte(lnum)" function
8609 */
8610 static void
8611f_line2byte(typval_T *argvars UNUSED, typval_T *rettv)
8612{
8613#ifndef FEAT_BYTEOFF
8614 rettv->vval.v_number = -1;
8615#else
8616 linenr_T lnum;
8617
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008618 if (in_vim9script() && check_for_lnum_arg(argvars, 0) == FAIL)
8619 return;
8620
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008621 lnum = tv_get_lnum(argvars);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008622 if (lnum < 1 || lnum > curbuf->b_ml.ml_line_count + 1)
8623 rettv->vval.v_number = -1;
8624 else
8625 rettv->vval.v_number = ml_find_line_or_offset(curbuf, lnum, NULL);
8626 if (rettv->vval.v_number >= 0)
8627 ++rettv->vval.v_number;
8628#endif
8629}
8630
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008631#ifdef FEAT_LUA
8632/*
8633 * "luaeval()" function
8634 */
8635 static void
8636f_luaeval(typval_T *argvars, typval_T *rettv)
8637{
8638 char_u *str;
8639 char_u buf[NUMBUFLEN];
8640
Bram Moolenaar8c62a082019-02-08 14:34:10 +01008641 if (check_restricted() || check_secure())
8642 return;
8643
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02008644 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
8645 return;
8646
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008647 str = tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008648 do_luaeval(str, argvars + 1, rettv);
8649}
8650#endif
8651
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008652typedef enum
8653{
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008654 MATCH_END, // matchend()
8655 MATCH_MATCH, // match()
8656 MATCH_STR, // matchstr()
8657 MATCH_LIST, // matchlist()
8658 MATCH_POS // matchstrpos()
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008659} matchtype_T;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008660
8661 static void
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008662find_some_match(typval_T *argvars, typval_T *rettv, matchtype_T type)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008663{
8664 char_u *str = NULL;
8665 long len = 0;
8666 char_u *expr = NULL;
8667 char_u *pat;
8668 regmatch_T regmatch;
8669 char_u patbuf[NUMBUFLEN];
8670 char_u strbuf[NUMBUFLEN];
8671 char_u *save_cpo;
8672 long start = 0;
8673 long nth = 1;
8674 colnr_T startcol = 0;
8675 int match = 0;
8676 list_T *l = NULL;
8677 listitem_T *li = NULL;
8678 long idx = 0;
8679 char_u *tofree = NULL;
8680
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008681 // Make 'cpoptions' empty, the 'l' flag should not be used here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008682 save_cpo = p_cpo;
Bram Moolenaare5a2dc82021-01-03 19:52:05 +01008683 p_cpo = empty_option;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008684
8685 rettv->vval.v_number = -1;
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008686 if (type == MATCH_LIST || type == MATCH_POS)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008687 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008688 // type MATCH_LIST: return empty list when there are no matches.
8689 // type MATCH_POS: return ["", -1, -1, -1]
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008690 if (rettv_list_alloc(rettv) == FAIL)
8691 goto theend;
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008692 if (type == MATCH_POS
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008693 && (list_append_string(rettv->vval.v_list,
8694 (char_u *)"", 0) == FAIL
8695 || list_append_number(rettv->vval.v_list,
8696 (varnumber_T)-1) == FAIL
8697 || list_append_number(rettv->vval.v_list,
8698 (varnumber_T)-1) == FAIL
8699 || list_append_number(rettv->vval.v_list,
8700 (varnumber_T)-1) == FAIL))
8701 {
8702 list_free(rettv->vval.v_list);
8703 rettv->vval.v_list = NULL;
8704 goto theend;
8705 }
8706 }
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008707 else if (type == MATCH_STR)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008708 {
8709 rettv->v_type = VAR_STRING;
8710 rettv->vval.v_string = NULL;
8711 }
8712
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02008713 if (in_vim9script()
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02008714 && (check_for_string_or_list_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008715 || check_for_string_arg(argvars, 1) == FAIL
8716 || check_for_opt_number_arg(argvars, 2) == FAIL
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02008717 || (argvars[2].v_type != VAR_UNKNOWN
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02008718 && check_for_opt_number_arg(argvars, 3) == FAIL)))
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +02008719 goto theend;
8720
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008721 if (argvars[0].v_type == VAR_LIST)
8722 {
8723 if ((l = argvars[0].vval.v_list) == NULL)
8724 goto theend;
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02008725 CHECK_LIST_MATERIALIZE(l);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008726 li = l->lv_first;
8727 }
8728 else
8729 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008730 expr = str = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008731 len = (long)STRLEN(str);
8732 }
8733
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008734 pat = tv_get_string_buf_chk(&argvars[1], patbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008735 if (pat == NULL)
8736 goto theend;
8737
8738 if (argvars[2].v_type != VAR_UNKNOWN)
8739 {
8740 int error = FALSE;
8741
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008742 start = (long)tv_get_number_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008743 if (error)
8744 goto theend;
8745 if (l != NULL)
8746 {
8747 li = list_find(l, start);
8748 if (li == NULL)
8749 goto theend;
Bram Moolenaar0ff6aad2020-01-29 21:27:21 +01008750 idx = l->lv_u.mat.lv_idx; // use the cached index
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008751 }
8752 else
8753 {
8754 if (start < 0)
8755 start = 0;
8756 if (start > len)
8757 goto theend;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008758 // When "count" argument is there ignore matches before "start",
8759 // otherwise skip part of the string. Differs when pattern is "^"
8760 // or "\<".
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008761 if (argvars[3].v_type != VAR_UNKNOWN)
8762 startcol = start;
8763 else
8764 {
8765 str += start;
8766 len -= start;
8767 }
8768 }
8769
8770 if (argvars[3].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01008771 nth = (long)tv_get_number_chk(&argvars[3], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008772 if (error)
8773 goto theend;
8774 }
8775
8776 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
8777 if (regmatch.regprog != NULL)
8778 {
8779 regmatch.rm_ic = p_ic;
8780
8781 for (;;)
8782 {
8783 if (l != NULL)
8784 {
8785 if (li == NULL)
8786 {
8787 match = FALSE;
8788 break;
8789 }
8790 vim_free(tofree);
8791 expr = str = echo_string(&li->li_tv, &tofree, strbuf, 0);
8792 if (str == NULL)
8793 break;
8794 }
8795
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +00008796 match = vim_regexec_nl(&regmatch, str, startcol);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008797
8798 if (match && --nth <= 0)
8799 break;
8800 if (l == NULL && !match)
8801 break;
8802
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008803 // Advance to just after the match.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008804 if (l != NULL)
8805 {
8806 li = li->li_next;
8807 ++idx;
8808 }
8809 else
8810 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008811 startcol = (colnr_T)(regmatch.startp[0]
8812 + (*mb_ptr2len)(regmatch.startp[0]) - str);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008813 if (startcol > (colnr_T)len
8814 || str + startcol <= regmatch.startp[0])
8815 {
8816 match = FALSE;
8817 break;
8818 }
8819 }
8820 }
8821
8822 if (match)
8823 {
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008824 if (type == MATCH_POS)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008825 {
8826 listitem_T *li1 = rettv->vval.v_list->lv_first;
8827 listitem_T *li2 = li1->li_next;
8828 listitem_T *li3 = li2->li_next;
8829 listitem_T *li4 = li3->li_next;
8830
8831 vim_free(li1->li_tv.vval.v_string);
8832 li1->li_tv.vval.v_string = vim_strnsave(regmatch.startp[0],
Bram Moolenaardf44a272020-06-07 20:49:05 +02008833 regmatch.endp[0] - regmatch.startp[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008834 li3->li_tv.vval.v_number =
8835 (varnumber_T)(regmatch.startp[0] - expr);
8836 li4->li_tv.vval.v_number =
8837 (varnumber_T)(regmatch.endp[0] - expr);
8838 if (l != NULL)
8839 li2->li_tv.vval.v_number = (varnumber_T)idx;
8840 }
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008841 else if (type == MATCH_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008842 {
8843 int i;
8844
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008845 // return list with matched string and submatches
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008846 for (i = 0; i < NSUBEXP; ++i)
8847 {
8848 if (regmatch.endp[i] == NULL)
8849 {
8850 if (list_append_string(rettv->vval.v_list,
8851 (char_u *)"", 0) == FAIL)
8852 break;
8853 }
8854 else if (list_append_string(rettv->vval.v_list,
8855 regmatch.startp[i],
8856 (int)(regmatch.endp[i] - regmatch.startp[i]))
8857 == FAIL)
8858 break;
8859 }
8860 }
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008861 else if (type == MATCH_STR)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008862 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008863 // return matched string
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008864 if (l != NULL)
8865 copy_tv(&li->li_tv, rettv);
8866 else
8867 rettv->vval.v_string = vim_strnsave(regmatch.startp[0],
Bram Moolenaardf44a272020-06-07 20:49:05 +02008868 regmatch.endp[0] - regmatch.startp[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008869 }
8870 else if (l != NULL)
8871 rettv->vval.v_number = idx;
8872 else
8873 {
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008874 if (type != MATCH_END)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008875 rettv->vval.v_number =
8876 (varnumber_T)(regmatch.startp[0] - str);
8877 else
8878 rettv->vval.v_number =
8879 (varnumber_T)(regmatch.endp[0] - str);
8880 rettv->vval.v_number += (varnumber_T)(str - expr);
8881 }
8882 }
8883 vim_regfree(regmatch.regprog);
8884 }
8885
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02008886theend:
8887 if (type == MATCH_POS && l == NULL && rettv->vval.v_list != NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01008888 // matchstrpos() without a list: drop the second item.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008889 listitem_remove(rettv->vval.v_list,
8890 rettv->vval.v_list->lv_first->li_next);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02008891 vim_free(tofree);
8892 p_cpo = save_cpo;
8893}
8894
8895/*
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01008896 * Return all the matches in string "str" for pattern "rmp".
8897 * The matches are returned in the List "mlist".
8898 * If "submatches" is TRUE, then submatch information is also returned.
8899 * "matchbuf" is TRUE when called for matchbufline().
8900 */
8901 static int
8902get_matches_in_str(
8903 char_u *str,
8904 regmatch_T *rmp,
8905 list_T *mlist,
8906 int idx,
8907 int submatches,
8908 int matchbuf)
8909{
8910 long len = (long)STRLEN(str);
8911 int match = 0;
8912 colnr_T startidx = 0;
8913
8914 for (;;)
8915 {
8916 match = vim_regexec_nl(rmp, str, startidx);
8917 if (!match)
8918 break;
8919
8920 dict_T *d = dict_alloc();
8921 if (d == NULL)
8922 return FAIL;
8923 if (list_append_dict(mlist, d) == FAIL)
8924 return FAIL;;
8925
8926 if (dict_add_number(d, matchbuf ? "lnum" : "idx", idx) == FAIL)
8927 return FAIL;
8928
8929 if (dict_add_number(d, "byteidx",
8930 (colnr_T)(rmp->startp[0] - str)) == FAIL)
8931 return FAIL;
8932
8933 if (dict_add_string_len(d, "text", rmp->startp[0],
8934 (int)(rmp->endp[0] - rmp->startp[0])) == FAIL)
8935 return FAIL;
8936
8937 if (submatches)
8938 {
8939 list_T *sml = list_alloc();
8940 if (sml == NULL)
8941 return FAIL;
8942
8943 if (dict_add_list(d, "submatches", sml) == FAIL)
8944 return FAIL;
8945
8946 // return a list with the submatches
8947 for (int i = 1; i < NSUBEXP; ++i)
8948 {
8949 if (rmp->endp[i] == NULL)
8950 {
8951 if (list_append_string(sml, (char_u *)"", 0) == FAIL)
8952 return FAIL;
8953 }
8954 else if (list_append_string(sml, rmp->startp[i],
8955 (int)(rmp->endp[i] - rmp->startp[i])) == FAIL)
8956 return FAIL;
8957 }
8958 }
8959 startidx = (colnr_T)(rmp->endp[0] - str);
8960 if (startidx >= (colnr_T)len || str + startidx <= rmp->startp[0])
8961 break;
8962 }
8963
8964 return OK;
8965}
8966
8967/*
8968 * "matchbufline()" function
8969 */
8970 static void
8971f_matchbufline(typval_T *argvars, typval_T *rettv)
8972{
8973 list_T *retlist = NULL;
8974 char_u *save_cpo;
8975 char_u patbuf[NUMBUFLEN];
8976 regmatch_T regmatch;
8977
8978 rettv->vval.v_number = -1;
8979 if (rettv_list_alloc(rettv) != OK)
8980 return;
8981 retlist = rettv->vval.v_list;
8982
8983 if (check_for_buffer_arg(argvars, 0) == FAIL
8984 || check_for_string_arg(argvars, 1) == FAIL
8985 || check_for_lnum_arg(argvars, 2) == FAIL
8986 || check_for_lnum_arg(argvars, 3) == FAIL
8987 || check_for_opt_dict_arg(argvars, 4) == FAIL)
8988 return;
8989
8990 int prev_did_emsg = did_emsg;
8991 buf_T *buf = tv_get_buf(&argvars[0], FALSE);
8992 if (buf == NULL)
8993 {
8994 if (did_emsg == prev_did_emsg)
8995 semsg(_(e_invalid_buffer_name_str), tv_get_string(&argvars[0]));
8996 return;
8997 }
8998 if (buf->b_ml.ml_mfp == NULL)
8999 {
9000 emsg(_(e_buffer_is_not_loaded));
9001 return;
9002 }
9003
9004 char_u *pat = tv_get_string_buf(&argvars[1], patbuf);
9005
9006 int did_emsg_before = did_emsg;
9007 linenr_T slnum = tv_get_lnum_buf(&argvars[2], buf);
9008 if (did_emsg > did_emsg_before)
9009 return;
9010 if (slnum < 1)
9011 {
9012 semsg(_(e_invalid_value_for_argument_str), "lnum");
9013 return;
9014 }
9015
9016 linenr_T elnum = tv_get_lnum_buf(&argvars[3], buf);
9017 if (did_emsg > did_emsg_before)
9018 return;
9019 if (elnum < 1 || elnum < slnum)
9020 {
9021 semsg(_(e_invalid_value_for_argument_str), "end_lnum");
9022 return;
9023 }
9024
9025 if (elnum > buf->b_ml.ml_line_count)
9026 elnum = buf->b_ml.ml_line_count;
9027
9028 int submatches = FALSE;
9029 if (argvars[4].v_type != VAR_UNKNOWN)
9030 {
9031 dict_T *d = argvars[4].vval.v_dict;
9032 if (d != NULL)
9033 {
9034 dictitem_T *di = dict_find(d, (char_u *)"submatches", -1);
9035 if (di != NULL)
9036 {
9037 if (di->di_tv.v_type != VAR_BOOL)
9038 {
9039 semsg(_(e_invalid_value_for_argument_str), "submatches");
9040 return;
9041 }
9042 submatches = tv_get_bool(&di->di_tv);
9043 }
9044 }
9045 }
9046
9047 // Make 'cpoptions' empty, the 'l' flag should not be used here.
9048 save_cpo = p_cpo;
9049 p_cpo = empty_option;
9050
9051 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
9052 if (regmatch.regprog == NULL)
9053 goto theend;
9054 regmatch.rm_ic = p_ic;
9055
9056 while (slnum <= elnum)
9057 {
9058 char_u *str = ml_get_buf(buf, slnum, FALSE);
9059 if (get_matches_in_str(str, &regmatch, retlist, slnum, submatches,
9060 TRUE) == FAIL)
9061 goto cleanup;
9062 slnum++;
9063 }
9064
9065cleanup:
9066 vim_regfree(regmatch.regprog);
9067
9068theend:
9069 p_cpo = save_cpo;
9070}
9071
9072/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009073 * "match()" function
9074 */
9075 static void
9076f_match(typval_T *argvars, typval_T *rettv)
9077{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009078 find_some_match(argvars, rettv, MATCH_MATCH);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009079}
9080
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009081/*
9082 * "matchend()" function
9083 */
9084 static void
9085f_matchend(typval_T *argvars, typval_T *rettv)
9086{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009087 find_some_match(argvars, rettv, MATCH_END);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009088}
9089
9090/*
9091 * "matchlist()" function
9092 */
9093 static void
9094f_matchlist(typval_T *argvars, typval_T *rettv)
9095{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009096 find_some_match(argvars, rettv, MATCH_LIST);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009097}
9098
9099/*
9100 * "matchstr()" function
9101 */
9102 static void
9103f_matchstr(typval_T *argvars, typval_T *rettv)
9104{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009105 find_some_match(argvars, rettv, MATCH_STR);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009106}
9107
9108/*
Yegappan Lakshmananf93b1c82024-01-04 22:28:46 +01009109 * "matchstrlist()" function
9110 */
9111 static void
9112f_matchstrlist(typval_T *argvars, typval_T *rettv)
9113{
9114 list_T *retlist = NULL;
9115 char_u *save_cpo;
9116 list_T *l = NULL;
9117 listitem_T *li = NULL;
9118 char_u patbuf[NUMBUFLEN];
9119 regmatch_T regmatch;
9120
9121 rettv->vval.v_number = -1;
9122 if (rettv_list_alloc(rettv) != OK)
9123 return;
9124 retlist = rettv->vval.v_list;
9125
9126 if (check_for_list_arg(argvars, 0) == FAIL
9127 || check_for_string_arg(argvars, 1) == FAIL
9128 || check_for_opt_dict_arg(argvars, 2) == FAIL)
9129 return;
9130
9131 if ((l = argvars[0].vval.v_list) == NULL)
9132 return;
9133
9134 char_u *pat = tv_get_string_buf_chk(&argvars[1], patbuf);
9135 if (pat == NULL)
9136 return;
9137
9138 // Make 'cpoptions' empty, the 'l' flag should not be used here.
9139 save_cpo = p_cpo;
9140 p_cpo = empty_option;
9141
9142 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
9143 if (regmatch.regprog == NULL)
9144 goto theend;
9145 regmatch.rm_ic = p_ic;
9146
9147 int submatches = FALSE;
9148 if (argvars[2].v_type != VAR_UNKNOWN)
9149 {
9150 dict_T *d = argvars[2].vval.v_dict;
9151 if (d != NULL)
9152 {
9153 dictitem_T *di = dict_find(d, (char_u *)"submatches", -1);
9154 if (di != NULL)
9155 {
9156 if (di->di_tv.v_type != VAR_BOOL)
9157 {
9158 semsg(_(e_invalid_value_for_argument_str), "submatches");
9159 goto cleanup;
9160 }
9161 submatches = tv_get_bool(&di->di_tv);
9162 }
9163 }
9164 }
9165
9166 int idx = 0;
9167 CHECK_LIST_MATERIALIZE(l);
9168 FOR_ALL_LIST_ITEMS(l, li)
9169 {
9170 if (li->li_tv.v_type == VAR_STRING && li->li_tv.vval.v_string != NULL)
9171 {
9172 char_u *str = li->li_tv.vval.v_string;
9173 if (get_matches_in_str(str, &regmatch, retlist, idx, submatches,
9174 FALSE) == FAIL)
9175 goto cleanup;
9176 }
9177 idx++;
9178 }
9179
9180cleanup:
9181 vim_regfree(regmatch.regprog);
9182
9183theend:
9184 p_cpo = save_cpo;
9185}
9186
9187/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009188 * "matchstrpos()" function
9189 */
9190 static void
9191f_matchstrpos(typval_T *argvars, typval_T *rettv)
9192{
Bram Moolenaar8d9f0ef2017-08-27 13:51:01 +02009193 find_some_match(argvars, rettv, MATCH_POS);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009194}
9195
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009196 static void
9197max_min(typval_T *argvars, typval_T *rettv, int domax)
9198{
9199 varnumber_T n = 0;
9200 varnumber_T i;
9201 int error = FALSE;
9202
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009203 if (in_vim9script() && check_for_list_or_dict_arg(argvars, 0) == FAIL)
9204 return;
9205
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009206 if (argvars[0].v_type == VAR_LIST)
9207 {
9208 list_T *l;
9209 listitem_T *li;
9210
9211 l = argvars[0].vval.v_list;
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009212 if (l != NULL && l->lv_len > 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009213 {
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009214 if (l->lv_first == &range_list_item)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009215 {
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009216 if ((l->lv_u.nonmat.lv_stride > 0) ^ domax)
9217 n = l->lv_u.nonmat.lv_start;
9218 else
=?UTF-8?q?Dundar=20G=C3=B6c?=d5cec1f2022-01-29 15:19:23 +00009219 n = l->lv_u.nonmat.lv_start + ((varnumber_T)l->lv_len - 1)
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009220 * l->lv_u.nonmat.lv_stride;
9221 }
9222 else
9223 {
9224 li = l->lv_first;
9225 if (li != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009226 {
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009227 n = tv_get_number_chk(&li->li_tv, &error);
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009228 if (error)
9229 return; // type error; errmsg already given
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009230 for (;;)
9231 {
9232 li = li->li_next;
9233 if (li == NULL)
9234 break;
9235 i = tv_get_number_chk(&li->li_tv, &error);
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009236 if (error)
9237 return; // type error; errmsg already given
Bram Moolenaar9f2d0202020-01-30 16:40:10 +01009238 if (domax ? i > n : i < n)
9239 n = i;
9240 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009241 }
9242 }
9243 }
9244 }
9245 else if (argvars[0].v_type == VAR_DICT)
9246 {
9247 dict_T *d;
9248 int first = TRUE;
9249 hashitem_T *hi;
9250 int todo;
9251
9252 d = argvars[0].vval.v_dict;
9253 if (d != NULL)
9254 {
9255 todo = (int)d->dv_hashtab.ht_used;
Yegappan Lakshmanan14113fd2023-03-07 17:13:51 +00009256 FOR_ALL_HASHTAB_ITEMS(&d->dv_hashtab, hi, todo)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009257 {
9258 if (!HASHITEM_EMPTY(hi))
9259 {
9260 --todo;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009261 i = tv_get_number_chk(&HI2DI(hi)->di_tv, &error);
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009262 if (error)
9263 return; // type error; errmsg already given
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009264 if (first)
9265 {
9266 n = i;
9267 first = FALSE;
9268 }
9269 else if (domax ? i > n : i < n)
9270 n = i;
9271 }
9272 }
9273 }
9274 }
9275 else
Bram Moolenaar460ae5d2022-01-01 14:19:49 +00009276 semsg(_(e_argument_of_str_must_be_list_or_dictionary), domax ? "max()" : "min()");
Bram Moolenaarab65fc72021-02-04 22:07:16 +01009277
9278 rettv->vval.v_number = n;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009279}
9280
9281/*
9282 * "max()" function
9283 */
9284 static void
9285f_max(typval_T *argvars, typval_T *rettv)
9286{
9287 max_min(argvars, rettv, TRUE);
9288}
9289
9290/*
9291 * "min()" function
9292 */
9293 static void
9294f_min(typval_T *argvars, typval_T *rettv)
9295{
9296 max_min(argvars, rettv, FALSE);
9297}
9298
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009299#if defined(FEAT_MZSCHEME) || defined(PROTO)
9300/*
9301 * "mzeval()" function
9302 */
9303 static void
9304f_mzeval(typval_T *argvars, typval_T *rettv)
9305{
9306 char_u *str;
9307 char_u buf[NUMBUFLEN];
9308
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009309 if (check_restricted() || check_secure())
9310 return;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009311
9312 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
9313 return;
9314
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009315 str = tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009316 do_mzeval(str, rettv);
9317}
9318
9319 void
9320mzscheme_call_vim(char_u *name, typval_T *args, typval_T *rettv)
9321{
9322 typval_T argvars[3];
9323
9324 argvars[0].v_type = VAR_STRING;
9325 argvars[0].vval.v_string = name;
9326 copy_tv(args, &argvars[1]);
9327 argvars[2].v_type = VAR_UNKNOWN;
9328 f_call(argvars, rettv);
9329 clear_tv(&argvars[1]);
9330}
9331#endif
9332
9333/*
9334 * "nextnonblank()" function
9335 */
9336 static void
9337f_nextnonblank(typval_T *argvars, typval_T *rettv)
9338{
9339 linenr_T lnum;
9340
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009341 if (in_vim9script() && check_for_lnum_arg(argvars, 0) == FAIL)
9342 return;
9343
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009344 for (lnum = tv_get_lnum(argvars); ; ++lnum)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009345 {
9346 if (lnum < 0 || lnum > curbuf->b_ml.ml_line_count)
9347 {
9348 lnum = 0;
9349 break;
9350 }
9351 if (*skipwhite(ml_get(lnum)) != NUL)
9352 break;
9353 }
9354 rettv->vval.v_number = lnum;
9355}
9356
9357/*
9358 * "nr2char()" function
9359 */
9360 static void
9361f_nr2char(typval_T *argvars, typval_T *rettv)
9362{
9363 char_u buf[NUMBUFLEN];
9364
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +02009365 if (in_vim9script()
9366 && (check_for_number_arg(argvars, 0) == FAIL
9367 || check_for_opt_bool_arg(argvars, 1) == FAIL))
9368 return;
9369
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009370 if (has_mbyte)
9371 {
9372 int utf8 = 0;
9373
9374 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaared6a4302020-09-05 20:29:41 +02009375 utf8 = (int)tv_get_bool_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009376 if (utf8)
Bram Moolenaarbdace832019-03-02 10:13:42 +01009377 buf[utf_char2bytes((int)tv_get_number(&argvars[0]), buf)] = NUL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009378 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009379 buf[(*mb_char2bytes)((int)tv_get_number(&argvars[0]), buf)] = NUL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009380 }
9381 else
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009382 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009383 buf[0] = (char_u)tv_get_number(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009384 buf[1] = NUL;
9385 }
9386 rettv->v_type = VAR_STRING;
9387 rettv->vval.v_string = vim_strsave(buf);
9388}
9389
9390/*
9391 * "or(expr, expr)" function
9392 */
9393 static void
9394f_or(typval_T *argvars, typval_T *rettv)
9395{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009396 if (in_vim9script()
9397 && (check_for_number_arg(argvars, 0) == FAIL
9398 || check_for_number_arg(argvars, 1) == FAIL))
9399 return;
9400
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009401 rettv->vval.v_number = tv_get_number_chk(&argvars[0], NULL)
9402 | tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009403}
9404
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009405#ifdef FEAT_PERL
9406/*
9407 * "perleval()" function
9408 */
9409 static void
9410f_perleval(typval_T *argvars, typval_T *rettv)
9411{
9412 char_u *str;
9413 char_u buf[NUMBUFLEN];
9414
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009415 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
9416 return;
9417
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009418 str = tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009419 do_perleval(str, rettv);
9420}
9421#endif
9422
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009423/*
9424 * "prevnonblank()" function
9425 */
9426 static void
9427f_prevnonblank(typval_T *argvars, typval_T *rettv)
9428{
9429 linenr_T lnum;
9430
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009431 if (in_vim9script() && check_for_lnum_arg(argvars, 0) == FAIL)
9432 return;
9433
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009434 lnum = tv_get_lnum(argvars);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009435 if (lnum < 1 || lnum > curbuf->b_ml.ml_line_count)
9436 lnum = 0;
9437 else
9438 while (lnum >= 1 && *skipwhite(ml_get(lnum)) == NUL)
9439 --lnum;
9440 rettv->vval.v_number = lnum;
9441}
9442
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009443// This dummy va_list is here because:
9444// - passing a NULL pointer doesn't work when va_list isn't a pointer
9445// - locally in the function results in a "used before set" warning
9446// - using va_start() to initialize it gives "function with fixed args" error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009447static va_list ap;
9448
9449/*
9450 * "printf()" function
9451 */
9452 static void
9453f_printf(typval_T *argvars, typval_T *rettv)
9454{
9455 char_u buf[NUMBUFLEN];
9456 int len;
9457 char_u *s;
9458 int saved_did_emsg = did_emsg;
9459 char *fmt;
9460
9461 rettv->v_type = VAR_STRING;
9462 rettv->vval.v_string = NULL;
9463
Yegappan Lakshmanana764e732021-07-25 15:57:32 +02009464 if (in_vim9script() && check_for_string_or_number_arg(argvars, 0) == FAIL)
9465 return;
9466
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009467 // Get the required length, allocate the buffer and do it for real.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009468 did_emsg = FALSE;
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009469 fmt = (char *)tv_get_string_buf(&argvars[0], buf);
Bram Moolenaar8327d1d2017-07-11 22:34:51 +02009470 len = vim_vsnprintf_typval(NULL, 0, fmt, ap, argvars + 1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009471 if (!did_emsg)
9472 {
9473 s = alloc(len + 1);
9474 if (s != NULL)
9475 {
9476 rettv->vval.v_string = s;
Bram Moolenaar8327d1d2017-07-11 22:34:51 +02009477 (void)vim_vsnprintf_typval((char *)s, len + 1, fmt,
9478 ap, argvars + 1);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009479 }
9480 }
9481 did_emsg |= saved_did_emsg;
9482}
9483
9484/*
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009485 * "pum_getpos()" function
9486 */
9487 static void
9488f_pum_getpos(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
9489{
Bram Moolenaar93a10962022-06-16 11:42:09 +01009490 if (rettv_dict_alloc(rettv) == FAIL)
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009491 return;
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009492 pum_set_event_info(rettv->vval.v_dict);
Bram Moolenaare9bd5722019-08-17 19:36:06 +02009493}
9494
9495/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009496 * "pumvisible()" function
9497 */
9498 static void
9499f_pumvisible(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
9500{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009501 if (pum_visible())
9502 rettv->vval.v_number = 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009503}
9504
9505#ifdef FEAT_PYTHON3
9506/*
9507 * "py3eval()" function
9508 */
9509 static void
9510f_py3eval(typval_T *argvars, typval_T *rettv)
9511{
9512 char_u *str;
9513 char_u buf[NUMBUFLEN];
Ben Jacksonea19e782024-11-06 21:50:05 +01009514 dict_T *locals;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009515
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009516 if (check_restricted() || check_secure())
9517 return;
9518
Ben Jacksonea19e782024-11-06 21:50:05 +01009519 if (in_vim9script()
9520 && (check_for_string_arg(argvars, 0) == FAIL
9521 || check_for_opt_dict_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009522 return;
9523
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009524 if (p_pyx == 0)
9525 p_pyx = 3;
9526
Ben Jacksonea19e782024-11-06 21:50:05 +01009527 if (argvars[1].v_type == VAR_DICT)
9528 {
9529 locals = argvars[1].vval.v_dict;
9530 }
9531 else if (argvars[1].v_type != VAR_UNKNOWN)
9532 {
9533 emsg(_(e_dictionary_required));
9534 return;
9535 }
9536 else
9537 {
9538 locals = NULL;
9539 }
9540
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009541 str = tv_get_string_buf(&argvars[0], buf);
Ben Jacksonea19e782024-11-06 21:50:05 +01009542 do_py3eval(str, locals, rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009543}
9544#endif
9545
9546#ifdef FEAT_PYTHON
9547/*
9548 * "pyeval()" function
9549 */
9550 static void
9551f_pyeval(typval_T *argvars, typval_T *rettv)
9552{
9553 char_u *str;
9554 char_u buf[NUMBUFLEN];
Ben Jacksonea19e782024-11-06 21:50:05 +01009555 dict_T *locals;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009556
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009557 if (check_restricted() || check_secure())
9558 return;
9559
Ben Jacksonea19e782024-11-06 21:50:05 +01009560 if (in_vim9script() && (
9561 check_for_string_arg(argvars, 0) == FAIL ||
9562 check_for_opt_dict_arg(argvars, 1) == FAIL ) )
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009563 return;
9564
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009565 if (p_pyx == 0)
9566 p_pyx = 2;
9567
Ben Jacksonea19e782024-11-06 21:50:05 +01009568 if (argvars[1].v_type == VAR_DICT)
9569 {
9570 locals = argvars[1].vval.v_dict;
9571 }
9572 else if (argvars[1].v_type != VAR_UNKNOWN)
9573 {
9574 emsg( "Invalid argument: must be dict" );
9575 return;
9576 }
9577 else
9578 {
9579 locals = NULL;
9580 }
9581
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009582 str = tv_get_string_buf(&argvars[0], buf);
Ben Jacksonea19e782024-11-06 21:50:05 +01009583 do_pyeval(str, locals, rettv);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009584}
9585#endif
9586
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009587#if defined(FEAT_PYTHON) || defined(FEAT_PYTHON3)
9588/*
9589 * "pyxeval()" function
9590 */
9591 static void
9592f_pyxeval(typval_T *argvars, typval_T *rettv)
9593{
Bram Moolenaar8c62a082019-02-08 14:34:10 +01009594 if (check_restricted() || check_secure())
9595 return;
9596
Ben Jacksonea19e782024-11-06 21:50:05 +01009597 if (in_vim9script()
9598 && (check_for_string_arg(argvars, 0) == FAIL
9599 || check_for_opt_dict_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009600 return;
9601
Bram Moolenaarf42dd3c2017-01-28 16:06:38 +01009602# if defined(FEAT_PYTHON) && defined(FEAT_PYTHON3)
9603 init_pyxversion();
9604 if (p_pyx == 2)
9605 f_pyeval(argvars, rettv);
9606 else
9607 f_py3eval(argvars, rettv);
9608# elif defined(FEAT_PYTHON)
9609 f_pyeval(argvars, rettv);
9610# elif defined(FEAT_PYTHON3)
9611 f_py3eval(argvars, rettv);
9612# endif
9613}
9614#endif
9615
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009616static UINT32_T srand_seed_for_testing = 0;
9617static int srand_seed_for_testing_is_used = FALSE;
9618
9619 static void
9620f_test_srand_seed(typval_T *argvars, typval_T *rettv UNUSED)
9621{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009622 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
9623 return;
9624
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009625 if (argvars[0].v_type == VAR_UNKNOWN)
Bram Moolenaar7633fe52020-06-22 19:10:56 +02009626 srand_seed_for_testing_is_used = FALSE;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009627 else
9628 {
Bram Moolenaar7633fe52020-06-22 19:10:56 +02009629 srand_seed_for_testing = (UINT32_T)tv_get_number(&argvars[0]);
9630 srand_seed_for_testing_is_used = TRUE;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009631 }
9632}
9633
9634 static void
9635init_srand(UINT32_T *x)
9636{
LemonBoy9987fe82024-07-04 13:20:49 +02009637 struct {
9638 union {
9639 UINT32_T number;
9640 char_u bytes[sizeof(UINT32_T)];
9641 } contents;
9642 } buf;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009643
9644 if (srand_seed_for_testing_is_used)
9645 {
Bram Moolenaar7633fe52020-06-22 19:10:56 +02009646 *x = srand_seed_for_testing;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009647 return;
9648 }
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009649
LemonBoy9987fe82024-07-04 13:20:49 +02009650 if (mch_get_random(buf.contents.bytes, sizeof(buf.contents.bytes)) == OK)
9651 {
9652 *x = buf.contents.number;
9653 return;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009654 }
LemonBoy9987fe82024-07-04 13:20:49 +02009655
9656 // The system's random number generator doesn't work, fall back to:
9657 // - randombytes_random()
9658 // - reltime() or time()
9659 // - XOR with process ID
9660#if defined(FEAT_SODIUM)
9661 if (crypt_sodium_init() >= 0)
9662 *x = crypt_sodium_randombytes_random();
9663 else
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009664#endif
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009665 {
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009666#if defined(FEAT_RELTIME)
LemonBoy9987fe82024-07-04 13:20:49 +02009667 proftime_T res;
9668 profile_start(&res);
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009669# if defined(MSWIN)
LemonBoy9987fe82024-07-04 13:20:49 +02009670 *x = (UINT32_T)res.LowPart;
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009671# else
LemonBoy9987fe82024-07-04 13:20:49 +02009672 *x = (UINT32_T)res.tv_fsec;
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009673# endif
9674#else
LemonBoy9987fe82024-07-04 13:20:49 +02009675 *x = vim_time();
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009676#endif
LemonBoy9987fe82024-07-04 13:20:49 +02009677 *x ^= mch_get_pid();
Yasuhiro Matsumotof0a9c002022-12-05 21:55:55 +00009678 }
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009679}
9680
kylo252ae6f1d82022-02-16 19:24:07 +00009681#define ROTL(x, k) (((x) << (k)) | ((x) >> (32 - (k))))
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009682#define SPLITMIX32(x, z) ( \
kylo252ae6f1d82022-02-16 19:24:07 +00009683 (z) = ((x) += 0x9e3779b9), \
9684 (z) = ((z) ^ ((z) >> 16)) * 0x85ebca6b, \
9685 (z) = ((z) ^ ((z) >> 13)) * 0xc2b2ae35, \
9686 (z) ^ ((z) >> 16) \
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009687 )
9688#define SHUFFLE_XOSHIRO128STARSTAR(x, y, z, w) \
kylo252ae6f1d82022-02-16 19:24:07 +00009689 result = ROTL((y) * 5, 7) * 9; \
9690 t = (y) << 9; \
9691 (z) ^= (x); \
9692 (w) ^= (y); \
9693 (y) ^= (z), (x) ^= (w); \
9694 (z) ^= t; \
9695 (w) = ROTL(w, 11);
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009696
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009697/*
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009698 * "rand()" function
9699 */
9700 static void
9701f_rand(typval_T *argvars, typval_T *rettv)
9702{
9703 list_T *l = NULL;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009704 static UINT32_T gx, gy, gz, gw;
9705 static int initialized = FALSE;
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009706 listitem_T *lx, *ly, *lz, *lw;
Bram Moolenaar0fd797e2020-11-05 20:46:32 +01009707 UINT32_T x = 0, y, z, w, t, result;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009708
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009709 if (in_vim9script() && check_for_opt_list_arg(argvars, 0) == FAIL)
9710 return;
9711
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009712 if (argvars[0].v_type == VAR_UNKNOWN)
9713 {
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009714 // When no argument is given use the global seed list.
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009715 if (initialized == FALSE)
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009716 {
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009717 // Initialize the global seed list.
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009718 init_srand(&x);
9719
9720 gx = SPLITMIX32(x, z);
9721 gy = SPLITMIX32(x, z);
9722 gz = SPLITMIX32(x, z);
9723 gw = SPLITMIX32(x, z);
9724 initialized = TRUE;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009725 }
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009726
9727 SHUFFLE_XOSHIRO128STARSTAR(gx, gy, gz, gw);
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009728 }
9729 else if (argvars[0].v_type == VAR_LIST)
9730 {
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009731 l = argvars[0].vval.v_list;
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009732 if (l == NULL || list_len(l) != 4)
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009733 goto theend;
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009734
9735 lx = list_find(l, 0L);
9736 ly = list_find(l, 1L);
9737 lz = list_find(l, 2L);
9738 lw = list_find(l, 3L);
9739 if (lx->li_tv.v_type != VAR_NUMBER) goto theend;
9740 if (ly->li_tv.v_type != VAR_NUMBER) goto theend;
9741 if (lz->li_tv.v_type != VAR_NUMBER) goto theend;
9742 if (lw->li_tv.v_type != VAR_NUMBER) goto theend;
9743 x = (UINT32_T)lx->li_tv.vval.v_number;
9744 y = (UINT32_T)ly->li_tv.vval.v_number;
9745 z = (UINT32_T)lz->li_tv.vval.v_number;
9746 w = (UINT32_T)lw->li_tv.vval.v_number;
9747
9748 SHUFFLE_XOSHIRO128STARSTAR(x, y, z, w);
9749
9750 lx->li_tv.vval.v_number = (varnumber_T)x;
9751 ly->li_tv.vval.v_number = (varnumber_T)y;
9752 lz->li_tv.vval.v_number = (varnumber_T)z;
9753 lw->li_tv.vval.v_number = (varnumber_T)w;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009754 }
9755 else
9756 goto theend;
9757
9758 rettv->v_type = VAR_NUMBER;
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009759 rettv->vval.v_number = (varnumber_T)result;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009760 return;
9761
9762theend:
Bram Moolenaar436b5ad2021-12-31 22:49:24 +00009763 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[0]));
Bram Moolenaarf8c1f922019-11-28 22:13:14 +01009764 rettv->v_type = VAR_NUMBER;
9765 rettv->vval.v_number = -1;
Bram Moolenaar06b0b4b2019-11-25 15:40:55 +01009766}
9767
9768/*
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009769 * "srand()" function
9770 */
9771 static void
9772f_srand(typval_T *argvars, typval_T *rettv)
9773{
9774 UINT32_T x = 0, z;
9775
9776 if (rettv_list_alloc(rettv) == FAIL)
9777 return;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009778
9779 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
9780 return;
9781
Bram Moolenaar4f645c52020-02-08 16:40:39 +01009782 if (argvars[0].v_type == VAR_UNKNOWN)
9783 {
9784 init_srand(&x);
9785 }
9786 else
9787 {
9788 int error = FALSE;
9789
9790 x = (UINT32_T)tv_get_number_chk(&argvars[0], &error);
9791 if (error)
9792 return;
9793 }
9794
9795 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
9796 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
9797 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
9798 list_append_number(rettv->vval.v_list, (varnumber_T)SPLITMIX32(x, z));
9799}
9800
9801#undef ROTL
9802#undef SPLITMIX32
9803#undef SHUFFLE_XOSHIRO128STARSTAR
9804
9805/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009806 * "range()" function
9807 */
9808 static void
9809f_range(typval_T *argvars, typval_T *rettv)
9810{
9811 varnumber_T start;
9812 varnumber_T end;
9813 varnumber_T stride = 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009814 int error = FALSE;
9815
Bram Moolenaar93a10962022-06-16 11:42:09 +01009816 if (rettv_list_alloc(rettv) == FAIL)
Yegappan Lakshmananca195cc2022-06-14 13:42:26 +01009817 return;
9818
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009819 if (in_vim9script()
9820 && (check_for_number_arg(argvars, 0) == FAIL
9821 || check_for_opt_number_arg(argvars, 1) == FAIL
9822 || (argvars[1].v_type != VAR_UNKNOWN
9823 && check_for_opt_number_arg(argvars, 2) == FAIL)))
9824 return;
9825
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009826 start = tv_get_number_chk(&argvars[0], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009827 if (argvars[1].v_type == VAR_UNKNOWN)
9828 {
9829 end = start - 1;
9830 start = 0;
9831 }
9832 else
9833 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009834 end = tv_get_number_chk(&argvars[1], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009835 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +01009836 stride = tv_get_number_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009837 }
9838
9839 if (error)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +01009840 return; // type error; errmsg already given
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009841 if (stride == 0)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009842 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00009843 emsg(_(e_stride_is_zero));
9844 return;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01009845 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +00009846 if (stride > 0 ? end + 1 < start : end - 1 > start)
9847 {
9848 emsg(_(e_start_past_end));
9849 return;
9850 }
9851
9852 list_T *list = rettv->vval.v_list;
9853
9854 // Create a non-materialized list. This is much more efficient and
9855 // works with ":for". If used otherwise CHECK_LIST_MATERIALIZE() must
9856 // be called.
9857 list->lv_first = &range_list_item;
9858 list->lv_u.nonmat.lv_start = start;
9859 list->lv_u.nonmat.lv_end = end;
9860 list->lv_u.nonmat.lv_stride = stride;
Christian Brabandtdf63da92023-11-23 20:14:28 +01009861 if (stride > 0 ? end < start : end > start)
9862 list->lv_len = 0;
9863 else
9864 list->lv_len = (end - start) / stride + 1;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01009865}
9866
9867/*
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02009868 * Materialize "list".
9869 * Do not call directly, use CHECK_LIST_MATERIALIZE()
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01009870 */
9871 void
9872range_list_materialize(list_T *list)
9873{
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02009874 varnumber_T start = list->lv_u.nonmat.lv_start;
9875 varnumber_T end = list->lv_u.nonmat.lv_end;
Bram Moolenaar70c43d82022-01-26 21:01:15 +00009876 int stride = list->lv_u.nonmat.lv_stride;
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02009877 varnumber_T i;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01009878
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02009879 list->lv_first = NULL;
9880 list->lv_u.mat.lv_last = NULL;
9881 list->lv_len = 0;
9882 list->lv_u.mat.lv_idx_item = NULL;
9883 for (i = start; stride > 0 ? i <= end : i >= end; i += stride)
Bram Moolenaar70c43d82022-01-26 21:01:15 +00009884 {
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +00009885 if (list_append_number(list, i) == FAIL)
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02009886 break;
Bram Moolenaar70c43d82022-01-26 21:01:15 +00009887 if (list->lv_lock & VAR_ITEMS_LOCKED)
9888 list->lv_u.mat.lv_last->li_tv.v_lock = VAR_LOCKED;
9889 }
9890 list->lv_lock &= ~VAR_ITEMS_LOCKED;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009891}
9892
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009893/*
9894 * "getreginfo()" function
9895 */
9896 static void
9897f_getreginfo(typval_T *argvars, typval_T *rettv)
9898{
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009899 int regname;
9900 char_u buf[NUMBUFLEN + 2];
9901 long reglen = 0;
9902 dict_T *dict;
9903 list_T *list;
9904
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009905 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
9906 return;
9907
zeertzjqd3f00f52021-12-24 12:02:43 +00009908 regname = getreg_get_regname(argvars);
9909 if (regname == 0)
9910 return;
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009911
zeertzjqd3f00f52021-12-24 12:02:43 +00009912 if (regname == '@')
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009913 regname = '"';
9914
9915 if (rettv_dict_alloc(rettv) == FAIL)
9916 return;
9917 dict = rettv->vval.v_dict;
9918
9919 list = (list_T *)get_reg_contents(regname, GREG_EXPR_SRC | GREG_LIST);
9920 if (list == NULL)
9921 return;
Bram Moolenaar91639192020-06-29 19:55:58 +02009922 (void)dict_add_list(dict, "regcontents", list);
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009923
9924 buf[0] = NUL;
9925 buf[1] = NUL;
9926 switch (get_reg_type(regname, &reglen))
9927 {
9928 case MLINE: buf[0] = 'V'; break;
9929 case MCHAR: buf[0] = 'v'; break;
9930 case MBLOCK:
9931 vim_snprintf((char *)buf, sizeof(buf), "%c%ld", Ctrl_V,
9932 reglen + 1);
9933 break;
9934 }
Bram Moolenaar91639192020-06-29 19:55:58 +02009935 (void)dict_add_string(dict, (char *)"regtype", buf);
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009936
9937 buf[0] = get_register_name(get_unname_register());
9938 buf[1] = NUL;
9939 if (regname == '"')
Bram Moolenaar91639192020-06-29 19:55:58 +02009940 (void)dict_add_string(dict, (char *)"points_to", buf);
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009941 else
9942 {
9943 dictitem_T *item = dictitem_alloc((char_u *)"isunnamed");
9944
9945 if (item != NULL)
9946 {
Bram Moolenaar82946e12022-11-24 11:31:29 +00009947 item->di_tv.v_type = VAR_BOOL;
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009948 item->di_tv.vval.v_number = regname == buf[0]
Bram Moolenaar418a29f2021-02-10 22:23:41 +01009949 ? VVAL_TRUE : VVAL_FALSE;
Bram Moolenaar91639192020-06-29 19:55:58 +02009950 (void)dict_add(dict, item);
Bram Moolenaarbb861e22020-06-07 18:16:36 +02009951 }
9952 }
9953}
9954
Bram Moolenaar0b6d9112018-05-22 20:35:17 +02009955 static void
9956return_register(int regname, typval_T *rettv)
9957{
9958 char_u buf[2] = {0, 0};
9959
9960 buf[0] = (char_u)regname;
9961 rettv->v_type = VAR_STRING;
9962 rettv->vval.v_string = vim_strsave(buf);
9963}
9964
9965/*
9966 * "reg_executing()" function
9967 */
9968 static void
9969f_reg_executing(typval_T *argvars UNUSED, typval_T *rettv)
9970{
9971 return_register(reg_executing, rettv);
9972}
9973
9974/*
9975 * "reg_recording()" function
9976 */
9977 static void
9978f_reg_recording(typval_T *argvars UNUSED, typval_T *rettv)
9979{
9980 return_register(reg_recording, rettv);
9981}
9982
Bram Moolenaar7416f3e2017-03-18 18:10:13 +01009983/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009984 * "rename({from}, {to})" function
9985 */
9986 static void
9987f_rename(typval_T *argvars, typval_T *rettv)
9988{
9989 char_u buf[NUMBUFLEN];
9990
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009991 rettv->vval.v_number = -1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +02009992 if (check_restricted() || check_secure())
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +02009993 return;
9994
9995 if (in_vim9script()
9996 && (check_for_string_arg(argvars, 0) == FAIL
9997 || check_for_string_arg(argvars, 1) == FAIL))
9998 return;
9999
10000 rettv->vval.v_number = vim_rename(tv_get_string(&argvars[0]),
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010001 tv_get_string_buf(&argvars[1], buf));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010002}
10003
10004/*
10005 * "repeat()" function
10006 */
10007 static void
10008f_repeat(typval_T *argvars, typval_T *rettv)
10009{
10010 char_u *p;
Bakudankun375141e2022-09-09 18:46:47 +010010011 varnumber_T n;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010012 int slen;
10013 int len;
10014 char_u *r;
10015 int i;
10016
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +020010017 if (in_vim9script()
Bakudankun375141e2022-09-09 18:46:47 +010010018 && (check_for_string_or_number_or_list_or_blob_arg(argvars, 0)
10019 == FAIL
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010020 || check_for_number_arg(argvars, 1) == FAIL))
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +020010021 return;
10022
Bakudankun375141e2022-09-09 18:46:47 +010010023 n = tv_get_number(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010024 if (argvars[0].v_type == VAR_LIST)
10025 {
10026 if (rettv_list_alloc(rettv) == OK && argvars[0].vval.v_list != NULL)
10027 while (n-- > 0)
10028 if (list_extend(rettv->vval.v_list,
10029 argvars[0].vval.v_list, NULL) == FAIL)
10030 break;
10031 }
Bakudankun375141e2022-09-09 18:46:47 +010010032 else if (argvars[0].v_type == VAR_BLOB)
10033 {
10034 if (rettv_blob_alloc(rettv) == FAIL
10035 || argvars[0].vval.v_blob == NULL
10036 || n <= 0)
10037 return;
10038
10039 slen = argvars[0].vval.v_blob->bv_ga.ga_len;
10040 len = (int)slen * n;
10041 if (len <= 0)
10042 return;
10043
10044 if (ga_grow(&rettv->vval.v_blob->bv_ga, len) == FAIL)
10045 return;
10046
10047 rettv->vval.v_blob->bv_ga.ga_len = len;
10048
10049 for (i = 0; i < slen; ++i)
10050 if (blob_get(argvars[0].vval.v_blob, i) != 0)
10051 break;
10052
10053 if (i == slen)
10054 // No need to copy since all bytes are already zero
10055 return;
10056
10057 for (i = 0; i < n; ++i)
10058 blob_set_range(rettv->vval.v_blob,
10059 (long)i * slen, ((long)i + 1) * slen - 1, argvars);
10060 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010061 else
10062 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010063 p = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010064 rettv->v_type = VAR_STRING;
10065 rettv->vval.v_string = NULL;
10066
10067 slen = (int)STRLEN(p);
10068 len = slen * n;
10069 if (len <= 0)
10070 return;
10071
10072 r = alloc(len + 1);
10073 if (r != NULL)
10074 {
10075 for (i = 0; i < n; i++)
10076 mch_memmove(r + i * slen, p, (size_t)slen);
10077 r[len] = NUL;
10078 }
10079
10080 rettv->vval.v_string = r;
10081 }
10082}
10083
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010084#define SP_NOMOVE 0x01 // don't move cursor
10085#define SP_REPEAT 0x02 // repeat to find outer pair
10086#define SP_RETCOUNT 0x04 // return matchcount
10087#define SP_SETPCMARK 0x08 // set previous context mark
10088#define SP_START 0x10 // accept match at start position
10089#define SP_SUBPAT 0x20 // return nr of matching sub-pattern
10090#define SP_END 0x40 // leave cursor at end of match
10091#define SP_COLUMN 0x80 // start at cursor column
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010092
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010093/*
10094 * Get flags for a search function.
10095 * Possibly sets "p_ws".
10096 * Returns BACKWARD, FORWARD or zero (for an error).
10097 */
10098 static int
10099get_search_arg(typval_T *varp, int *flagsp)
10100{
10101 int dir = FORWARD;
10102 char_u *flags;
10103 char_u nbuf[NUMBUFLEN];
10104 int mask;
10105
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010106 if (varp->v_type == VAR_UNKNOWN)
10107 return FORWARD;
10108
10109 flags = tv_get_string_buf_chk(varp, nbuf);
10110 if (flags == NULL)
10111 return 0; // type error; errmsg already given
10112 while (*flags != NUL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010113 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010114 switch (*flags)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010115 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010116 case 'b': dir = BACKWARD; break;
10117 case 'w': p_ws = TRUE; break;
10118 case 'W': p_ws = FALSE; break;
10119 default: mask = 0;
10120 if (flagsp != NULL)
10121 switch (*flags)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010122 {
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010123 case 'c': mask = SP_START; break;
10124 case 'e': mask = SP_END; break;
10125 case 'm': mask = SP_RETCOUNT; break;
10126 case 'n': mask = SP_NOMOVE; break;
10127 case 'p': mask = SP_SUBPAT; break;
10128 case 'r': mask = SP_REPEAT; break;
10129 case 's': mask = SP_SETPCMARK; break;
10130 case 'z': mask = SP_COLUMN; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010131 }
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010132 if (mask == 0)
10133 {
10134 semsg(_(e_invalid_argument_str), flags);
10135 dir = 0;
10136 }
10137 else
10138 *flagsp |= mask;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010139 }
Yegappan Lakshmanan1cfb14a2023-01-09 19:04:23 +000010140 if (dir == 0)
10141 break;
10142 ++flags;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010143 }
10144 return dir;
10145}
10146
10147/*
10148 * Shared by search() and searchpos() functions.
10149 */
10150 static int
10151search_cmn(typval_T *argvars, pos_T *match_pos, int *flagsp)
10152{
10153 int flags;
10154 char_u *pat;
John Marriott8c85a2a2024-05-20 19:18:26 +020010155 size_t patlen;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010156 pos_T pos;
10157 pos_T save_cursor;
10158 int save_p_ws = p_ws;
10159 int dir;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010160 int retval = 0; // default: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010161 long lnum_stop = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010162#ifdef FEAT_RELTIME
10163 long time_limit = 0;
10164#endif
10165 int options = SEARCH_KEEP;
10166 int subpatnum;
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010167 searchit_arg_T sia;
Bram Moolenaara9c01042020-06-07 14:50:50 +020010168 int use_skip = FALSE;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010169 pos_T firstpos;
10170
Yegappan Lakshmanan0ad871d2021-07-23 20:37:56 +020010171 if (in_vim9script()
10172 && (check_for_string_arg(argvars, 0) == FAIL
10173 || check_for_opt_string_arg(argvars, 1) == FAIL
10174 || (argvars[1].v_type != VAR_UNKNOWN
10175 && (check_for_opt_number_arg(argvars, 2) == FAIL
10176 || (argvars[2].v_type != VAR_UNKNOWN
10177 && check_for_opt_number_arg(argvars, 3) == FAIL)))))
10178 goto theend;
10179
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010180 pat = tv_get_string(&argvars[0]);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010181 dir = get_search_arg(&argvars[1], flagsp); // may set p_ws
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010182 if (dir == 0)
10183 goto theend;
10184 flags = *flagsp;
10185 if (flags & SP_START)
10186 options |= SEARCH_START;
10187 if (flags & SP_END)
10188 options |= SEARCH_END;
10189 if (flags & SP_COLUMN)
10190 options |= SEARCH_COL;
10191
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010192 // Optional arguments: line number to stop searching, timeout and skip.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010193 if (argvars[1].v_type != VAR_UNKNOWN && argvars[2].v_type != VAR_UNKNOWN)
10194 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010195 lnum_stop = (long)tv_get_number_chk(&argvars[2], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010196 if (lnum_stop < 0)
10197 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010198 if (argvars[3].v_type != VAR_UNKNOWN)
10199 {
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010200#ifdef FEAT_RELTIME
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010201 time_limit = (long)tv_get_number_chk(&argvars[3], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010202 if (time_limit < 0)
10203 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010204#endif
Bram Moolenaara9c01042020-06-07 14:50:50 +020010205 use_skip = eval_expr_valid_arg(&argvars[4]);
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010206 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010207 }
10208
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010209 /*
10210 * This function does not accept SP_REPEAT and SP_RETCOUNT flags.
10211 * Check to make sure only those flags are set.
10212 * Also, Only the SP_NOMOVE or the SP_SETPCMARK flag can be set. Both
10213 * flags cannot be set. Check for that condition also.
10214 */
10215 if (((flags & (SP_REPEAT | SP_RETCOUNT)) != 0)
10216 || ((flags & SP_NOMOVE) && (flags & SP_SETPCMARK)))
10217 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010218 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[1]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010219 goto theend;
10220 }
10221
10222 pos = save_cursor = curwin->w_cursor;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010223 CLEAR_FIELD(firstpos);
Bram Moolenaara80faa82020-04-12 19:37:17 +020010224 CLEAR_FIELD(sia);
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010225 sia.sa_stop_lnum = (linenr_T)lnum_stop;
10226#ifdef FEAT_RELTIME
Paul Ollis65745772022-06-05 16:55:54 +010010227 sia.sa_tm = time_limit;
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010228#endif
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010229
John Marriott8c85a2a2024-05-20 19:18:26 +020010230 patlen = STRLEN(pat);
10231
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010232 // Repeat until {skip} returns FALSE.
10233 for (;;)
10234 {
John Marriott8c85a2a2024-05-20 19:18:26 +020010235 subpatnum = searchit(curwin, curbuf, &pos, NULL, dir, pat, patlen, 1L,
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010236 options, RE_SEARCH, &sia);
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010237 // finding the first match again means there is no match where {skip}
10238 // evaluates to zero.
10239 if (firstpos.lnum != 0 && EQUAL_POS(pos, firstpos))
10240 subpatnum = FAIL;
10241
Bram Moolenaara9c01042020-06-07 14:50:50 +020010242 if (subpatnum == FAIL || !use_skip)
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010243 // didn't find it or no skip argument
10244 break;
Bram Moolenaar3d79f0a2023-01-22 20:14:26 +000010245 if (firstpos.lnum == 0)
10246 firstpos = pos;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010247
Bram Moolenaara9c01042020-06-07 14:50:50 +020010248 // If the skip expression matches, ignore this match.
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010249 {
10250 int do_skip;
10251 int err;
10252 pos_T save_pos = curwin->w_cursor;
10253
10254 curwin->w_cursor = pos;
Bram Moolenaara9c01042020-06-07 14:50:50 +020010255 err = FALSE;
10256 do_skip = eval_expr_to_bool(&argvars[4], &err);
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010257 curwin->w_cursor = save_pos;
10258 if (err)
10259 {
10260 // Evaluating {skip} caused an error, break here.
10261 subpatnum = FAIL;
10262 break;
10263 }
10264 if (!do_skip)
10265 break;
10266 }
zeertzjq180246c2022-06-23 12:04:46 +010010267
10268 // clear the start flag to avoid getting stuck here
10269 options &= ~SEARCH_START;
Bram Moolenaaradc17a52020-06-06 18:37:51 +020010270 }
10271
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010272 if (subpatnum != FAIL)
10273 {
10274 if (flags & SP_SUBPAT)
10275 retval = subpatnum;
10276 else
10277 retval = pos.lnum;
10278 if (flags & SP_SETPCMARK)
10279 setpcmark();
10280 curwin->w_cursor = pos;
10281 if (match_pos != NULL)
10282 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010283 // Store the match cursor position
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010284 match_pos->lnum = pos.lnum;
10285 match_pos->col = pos.col + 1;
10286 }
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010287 // "/$" will put the cursor after the end of the line, may need to
10288 // correct that here
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010289 check_cursor();
10290 }
10291
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010292 // If 'n' flag is used: restore cursor position.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010293 if (flags & SP_NOMOVE)
10294 curwin->w_cursor = save_cursor;
10295 else
10296 curwin->w_set_curswant = TRUE;
10297theend:
10298 p_ws = save_p_ws;
10299
10300 return retval;
10301}
10302
Bram Moolenaare99be0e2019-03-26 22:51:09 +010010303#ifdef FEAT_RUBY
10304/*
10305 * "rubyeval()" function
10306 */
10307 static void
10308f_rubyeval(typval_T *argvars, typval_T *rettv)
10309{
10310 char_u *str;
10311 char_u buf[NUMBUFLEN];
10312
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010313 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
10314 return;
10315
Bram Moolenaare99be0e2019-03-26 22:51:09 +010010316 str = tv_get_string_buf(&argvars[0], buf);
10317 do_rubyeval(str, rettv);
10318}
10319#endif
10320
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010321/*
10322 * "screenattr()" function
10323 */
10324 static void
10325f_screenattr(typval_T *argvars, typval_T *rettv)
10326{
10327 int row;
10328 int col;
10329 int c;
10330
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010331 if (in_vim9script()
10332 && (check_for_number_arg(argvars, 0) == FAIL
10333 || check_for_number_arg(argvars, 1) == FAIL))
10334 return;
10335
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010336 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10337 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010338 if (row < 0 || row >= screen_Rows
10339 || col < 0 || col >= screen_Columns)
10340 c = -1;
10341 else
10342 c = ScreenAttrs[LineOffset[row] + col];
10343 rettv->vval.v_number = c;
10344}
10345
10346/*
10347 * "screenchar()" function
10348 */
10349 static void
10350f_screenchar(typval_T *argvars, typval_T *rettv)
10351{
10352 int row;
10353 int col;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010354 int c;
10355
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010356 if (in_vim9script()
10357 && (check_for_number_arg(argvars, 0) == FAIL
10358 || check_for_number_arg(argvars, 1) == FAIL))
10359 return;
10360
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010361 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10362 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010363 if (row < 0 || row >= screen_Rows || col < 0 || col >= screen_Columns)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010364 c = -1;
10365 else
10366 {
zeertzjq47eec672023-06-01 20:26:55 +010010367 char_u buf[MB_MAXBYTES + 1];
10368 screen_getbytes(row, col, buf, NULL);
10369 c = (*mb_ptr2char)(buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010370 }
10371 rettv->vval.v_number = c;
10372}
10373
10374/*
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010375 * "screenchars()" function
10376 */
10377 static void
10378f_screenchars(typval_T *argvars, typval_T *rettv)
10379{
10380 int row;
10381 int col;
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010382 int c;
10383 int i;
10384
10385 if (rettv_list_alloc(rettv) == FAIL)
10386 return;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010387
10388 if (in_vim9script()
10389 && (check_for_number_arg(argvars, 0) == FAIL
10390 || check_for_number_arg(argvars, 1) == FAIL))
10391 return;
10392
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010393 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10394 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
10395 if (row < 0 || row >= screen_Rows || col < 0 || col >= screen_Columns)
10396 return;
10397
zeertzjq47eec672023-06-01 20:26:55 +010010398 char_u buf[MB_MAXBYTES + 1];
10399 screen_getbytes(row, col, buf, NULL);
10400 int pcc[MAX_MCO];
10401 if (enc_utf8)
10402 c = utfc_ptr2char(buf, pcc);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010403 else
zeertzjq47eec672023-06-01 20:26:55 +010010404 c = (*mb_ptr2char)(buf);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010405 list_append_number(rettv->vval.v_list, (varnumber_T)c);
10406
10407 if (enc_utf8)
zeertzjq47eec672023-06-01 20:26:55 +010010408 for (i = 0; i < Screen_mco && pcc[i] != 0; ++i)
10409 list_append_number(rettv->vval.v_list, (varnumber_T)pcc[i]);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010410}
10411
10412/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010413 * "screencol()" function
10414 *
10415 * First column is 1 to be consistent with virtcol().
10416 */
10417 static void
10418f_screencol(typval_T *argvars UNUSED, typval_T *rettv)
10419{
10420 rettv->vval.v_number = screen_screencol() + 1;
10421}
10422
10423/*
10424 * "screenrow()" function
10425 */
10426 static void
10427f_screenrow(typval_T *argvars UNUSED, typval_T *rettv)
10428{
10429 rettv->vval.v_number = screen_screenrow() + 1;
10430}
10431
10432/*
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010433 * "screenstring()" function
10434 */
10435 static void
10436f_screenstring(typval_T *argvars, typval_T *rettv)
10437{
10438 int row;
10439 int col;
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010440 char_u buf[MB_MAXBYTES + 1];
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010441
10442 rettv->vval.v_string = NULL;
10443 rettv->v_type = VAR_STRING;
10444
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010445 if (in_vim9script()
10446 && (check_for_number_arg(argvars, 0) == FAIL
10447 || check_for_number_arg(argvars, 1) == FAIL))
10448 return;
10449
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010450 row = (int)tv_get_number_chk(&argvars[0], NULL) - 1;
10451 col = (int)tv_get_number_chk(&argvars[1], NULL) - 1;
10452 if (row < 0 || row >= screen_Rows || col < 0 || col >= screen_Columns)
10453 return;
10454
zeertzjq47eec672023-06-01 20:26:55 +010010455 screen_getbytes(row, col, buf, NULL);
Bram Moolenaar2912abb2019-03-29 14:16:42 +010010456 rettv->vval.v_string = vim_strsave(buf);
10457}
10458
10459/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010460 * "search()" function
10461 */
10462 static void
10463f_search(typval_T *argvars, typval_T *rettv)
10464{
10465 int flags = 0;
10466
10467 rettv->vval.v_number = search_cmn(argvars, NULL, &flags);
10468}
10469
10470/*
10471 * "searchdecl()" function
10472 */
10473 static void
10474f_searchdecl(typval_T *argvars, typval_T *rettv)
10475{
Bram Moolenaar30788d32020-09-05 21:35:16 +020010476 int locally = TRUE;
10477 int thisblock = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010478 int error = FALSE;
10479 char_u *name;
10480
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010481 rettv->vval.v_number = 1; // default: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010482
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020010483 if (in_vim9script()
10484 && (check_for_string_arg(argvars, 0) == FAIL
10485 || check_for_opt_bool_arg(argvars, 1) == FAIL
10486 || (argvars[1].v_type != VAR_UNKNOWN
10487 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
10488 return;
10489
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010490 name = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010491 if (argvars[1].v_type != VAR_UNKNOWN)
10492 {
Bram Moolenaar30788d32020-09-05 21:35:16 +020010493 locally = !(int)tv_get_bool_chk(&argvars[1], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010494 if (!error && argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar30788d32020-09-05 21:35:16 +020010495 thisblock = (int)tv_get_bool_chk(&argvars[2], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010496 }
10497 if (!error && name != NULL)
10498 rettv->vval.v_number = find_decl(name, (int)STRLEN(name),
10499 locally, thisblock, SEARCH_KEEP) == FAIL;
10500}
10501
10502/*
10503 * Used by searchpair() and searchpairpos()
10504 */
10505 static int
10506searchpair_cmn(typval_T *argvars, pos_T *match_pos)
10507{
10508 char_u *spat, *mpat, *epat;
Bram Moolenaar48570482017-10-30 21:48:41 +010010509 typval_T *skip;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010510 int save_p_ws = p_ws;
10511 int dir;
10512 int flags = 0;
10513 char_u nbuf1[NUMBUFLEN];
10514 char_u nbuf2[NUMBUFLEN];
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010515 int retval = 0; // default: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010516 long lnum_stop = 0;
10517 long time_limit = 0;
10518
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +020010519 if (in_vim9script()
10520 && (check_for_string_arg(argvars, 0) == FAIL
10521 || check_for_string_arg(argvars, 1) == FAIL
10522 || check_for_string_arg(argvars, 2) == FAIL
10523 || check_for_opt_string_arg(argvars, 3) == FAIL
10524 || (argvars[3].v_type != VAR_UNKNOWN
10525 && argvars[4].v_type != VAR_UNKNOWN
10526 && (check_for_opt_number_arg(argvars, 5) == FAIL
10527 || (argvars[5].v_type != VAR_UNKNOWN
10528 && check_for_opt_number_arg(argvars, 6) == FAIL)))))
10529 goto theend;
10530
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010531 // Get the three pattern arguments: start, middle, end. Will result in an
10532 // error if not a valid argument.
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010533 spat = tv_get_string_chk(&argvars[0]);
10534 mpat = tv_get_string_buf_chk(&argvars[1], nbuf1);
10535 epat = tv_get_string_buf_chk(&argvars[2], nbuf2);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010536 if (spat == NULL || mpat == NULL || epat == NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010537 goto theend; // type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010538
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010539 // Handle the optional fourth argument: flags
10540 dir = get_search_arg(&argvars[3], &flags); // may set p_ws
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010541 if (dir == 0)
10542 goto theend;
10543
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010544 // Don't accept SP_END or SP_SUBPAT.
10545 // Only one of the SP_NOMOVE or SP_SETPCMARK flags can be set.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010546 if ((flags & (SP_END | SP_SUBPAT)) != 0
10547 || ((flags & SP_NOMOVE) && (flags & SP_SETPCMARK)))
10548 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010549 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[3]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010550 goto theend;
10551 }
10552
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010553 // Using 'r' implies 'W', otherwise it doesn't work.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010554 if (flags & SP_REPEAT)
10555 p_ws = FALSE;
10556
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010557 // Optional fifth argument: skip expression
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010558 if (argvars[3].v_type == VAR_UNKNOWN
10559 || argvars[4].v_type == VAR_UNKNOWN)
Bram Moolenaar48570482017-10-30 21:48:41 +010010560 skip = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010561 else
10562 {
Bram Moolenaara9c01042020-06-07 14:50:50 +020010563 // Type is checked later.
Bram Moolenaar48570482017-10-30 21:48:41 +010010564 skip = &argvars[4];
Bram Moolenaara9c01042020-06-07 14:50:50 +020010565
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010566 if (argvars[5].v_type != VAR_UNKNOWN)
10567 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010568 lnum_stop = (long)tv_get_number_chk(&argvars[5], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010569 if (lnum_stop < 0)
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010570 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010571 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[5]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010572 goto theend;
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010573 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010574#ifdef FEAT_RELTIME
10575 if (argvars[6].v_type != VAR_UNKNOWN)
10576 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010010577 time_limit = (long)tv_get_number_chk(&argvars[6], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010578 if (time_limit < 0)
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010579 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000010580 semsg(_(e_invalid_argument_str), tv_get_string(&argvars[6]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010581 goto theend;
Bram Moolenaar3dddb092018-06-24 19:01:59 +020010582 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010583 }
10584#endif
10585 }
10586 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010587
10588 retval = do_searchpair(spat, mpat, epat, dir, skip, flags,
10589 match_pos, lnum_stop, time_limit);
10590
10591theend:
10592 p_ws = save_p_ws;
10593
10594 return retval;
10595}
10596
10597/*
10598 * "searchpair()" function
10599 */
10600 static void
10601f_searchpair(typval_T *argvars, typval_T *rettv)
10602{
10603 rettv->vval.v_number = searchpair_cmn(argvars, NULL);
10604}
10605
10606/*
10607 * "searchpairpos()" function
10608 */
10609 static void
10610f_searchpairpos(typval_T *argvars, typval_T *rettv)
10611{
10612 pos_T match_pos;
10613 int lnum = 0;
10614 int col = 0;
10615
10616 if (rettv_list_alloc(rettv) == FAIL)
10617 return;
10618
10619 if (searchpair_cmn(argvars, &match_pos) > 0)
10620 {
10621 lnum = match_pos.lnum;
10622 col = match_pos.col;
10623 }
10624
10625 list_append_number(rettv->vval.v_list, (varnumber_T)lnum);
10626 list_append_number(rettv->vval.v_list, (varnumber_T)col);
10627}
10628
10629/*
10630 * Search for a start/middle/end thing.
10631 * Used by searchpair(), see its documentation for the details.
10632 * Returns 0 or -1 for no match,
10633 */
10634 long
10635do_searchpair(
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010636 char_u *spat, // start pattern
10637 char_u *mpat, // middle pattern
10638 char_u *epat, // end pattern
10639 int dir, // BACKWARD or FORWARD
10640 typval_T *skip, // skip expression
10641 int flags, // SP_SETPCMARK and other SP_ values
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010642 pos_T *match_pos,
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010643 linenr_T lnum_stop, // stop at this line if not zero
10644 long time_limit UNUSED) // stop after this many msec
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010645{
10646 char_u *save_cpo;
10647 char_u *pat, *pat2 = NULL, *pat3 = NULL;
John Marriott8c85a2a2024-05-20 19:18:26 +020010648 size_t patlen;
10649 size_t spatlen;
10650 size_t epatlen;
10651 size_t pat2size;
10652 size_t pat2len;
10653 size_t pat3size;
10654 size_t pat3len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010655 long retval = 0;
10656 pos_T pos;
10657 pos_T firstpos;
10658 pos_T foundpos;
10659 pos_T save_cursor;
10660 pos_T save_pos;
10661 int n;
10662 int r;
10663 int nest = 1;
Bram Moolenaar48570482017-10-30 21:48:41 +010010664 int use_skip = FALSE;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010665 int err;
10666 int options = SEARCH_KEEP;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010667
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010668 // Make 'cpoptions' empty, the 'l' flag should not be used here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010669 save_cpo = p_cpo;
10670 p_cpo = empty_option;
10671
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010672 // Make two search patterns: start/end (pat2, for in nested pairs) and
10673 // start/middle/end (pat3, for the top pair).
John Marriott8c85a2a2024-05-20 19:18:26 +020010674 spatlen = STRLEN(spat);
10675 epatlen = STRLEN(epat);
10676 pat2size = spatlen + epatlen + 17;
10677 pat2 = alloc(pat2size);
10678 if (pat2 == NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010679 goto theend;
John Marriott8c85a2a2024-05-20 19:18:26 +020010680 pat3size = spatlen + STRLEN(mpat) + epatlen + 25;
10681 pat3 = alloc(pat3size);
10682 if (pat3 == NULL)
10683 goto theend;
10684 pat2len = vim_snprintf((char *)pat2, pat2size, "\\m\\(%s\\m\\)\\|\\(%s\\m\\)", spat, epat);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010685 if (*mpat == NUL)
John Marriott8c85a2a2024-05-20 19:18:26 +020010686 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010687 STRCPY(pat3, pat2);
John Marriott8c85a2a2024-05-20 19:18:26 +020010688 pat3len = pat2len;
10689 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010690 else
John Marriott8c85a2a2024-05-20 19:18:26 +020010691 pat3len = vim_snprintf((char *)pat3, pat3size, "\\m\\(%s\\m\\)\\|\\(%s\\m\\)\\|\\(%s\\m\\)",
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010692 spat, epat, mpat);
10693 if (flags & SP_START)
10694 options |= SEARCH_START;
10695
Bram Moolenaar48570482017-10-30 21:48:41 +010010696 if (skip != NULL)
Bram Moolenaara9c01042020-06-07 14:50:50 +020010697 use_skip = eval_expr_valid_arg(skip);
Bram Moolenaar48570482017-10-30 21:48:41 +010010698
Bram Moolenaar5ea38d12022-06-16 21:20:48 +010010699#ifdef FEAT_RELTIME
10700 if (time_limit > 0)
10701 init_regexp_timeout(time_limit);
10702#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010703 save_cursor = curwin->w_cursor;
10704 pos = curwin->w_cursor;
Bram Moolenaarb5aedf32017-03-12 18:23:53 +010010705 CLEAR_POS(&firstpos);
10706 CLEAR_POS(&foundpos);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010707 pat = pat3;
John Marriott8c85a2a2024-05-20 19:18:26 +020010708 patlen = pat3len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010709 for (;;)
10710 {
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010711 searchit_arg_T sia;
10712
Bram Moolenaara80faa82020-04-12 19:37:17 +020010713 CLEAR_FIELD(sia);
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010714 sia.sa_stop_lnum = lnum_stop;
John Marriott8c85a2a2024-05-20 19:18:26 +020010715 n = searchit(curwin, curbuf, &pos, NULL, dir, pat, patlen, 1L,
Bram Moolenaar92ea26b2019-10-18 20:53:34 +020010716 options, RE_SEARCH, &sia);
Bram Moolenaarb5aedf32017-03-12 18:23:53 +010010717 if (n == FAIL || (firstpos.lnum != 0 && EQUAL_POS(pos, firstpos)))
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010718 // didn't find it or found the first match again: FAIL
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010719 break;
10720
10721 if (firstpos.lnum == 0)
10722 firstpos = pos;
Bram Moolenaarb5aedf32017-03-12 18:23:53 +010010723 if (EQUAL_POS(pos, foundpos))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010724 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010725 // Found the same position again. Can happen with a pattern that
10726 // has "\zs" at the end and searching backwards. Advance one
10727 // character and try again.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010728 if (dir == BACKWARD)
10729 decl(&pos);
10730 else
10731 incl(&pos);
10732 }
10733 foundpos = pos;
10734
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010735 // clear the start flag to avoid getting stuck here
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010736 options &= ~SEARCH_START;
10737
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010738 // If the skip pattern matches, ignore this match.
Bram Moolenaar48570482017-10-30 21:48:41 +010010739 if (use_skip)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010740 {
10741 save_pos = curwin->w_cursor;
10742 curwin->w_cursor = pos;
Bram Moolenaar48570482017-10-30 21:48:41 +010010743 err = FALSE;
10744 r = eval_expr_to_bool(skip, &err);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010745 curwin->w_cursor = save_pos;
10746 if (err)
10747 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010748 // Evaluating {skip} caused an error, break here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010749 curwin->w_cursor = save_cursor;
10750 retval = -1;
10751 break;
10752 }
10753 if (r)
10754 continue;
10755 }
10756
10757 if ((dir == BACKWARD && n == 3) || (dir == FORWARD && n == 2))
10758 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010759 // Found end when searching backwards or start when searching
10760 // forward: nested pair.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010761 ++nest;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010762 pat = pat2; // nested, don't search for middle
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010763 }
10764 else
10765 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010766 // Found end when searching forward or start when searching
10767 // backward: end of (nested) pair; or found middle in outer pair.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010768 if (--nest == 1)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010769 pat = pat3; // outer level, search for middle
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010770 }
10771
10772 if (nest == 0)
10773 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010774 // Found the match: return matchcount or line number.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010775 if (flags & SP_RETCOUNT)
10776 ++retval;
10777 else
10778 retval = pos.lnum;
10779 if (flags & SP_SETPCMARK)
10780 setpcmark();
10781 curwin->w_cursor = pos;
10782 if (!(flags & SP_REPEAT))
10783 break;
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010784 nest = 1; // search for next unmatched
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010785 }
10786 }
10787
10788 if (match_pos != NULL)
10789 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010790 // Store the match cursor position
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010791 match_pos->lnum = curwin->w_cursor.lnum;
10792 match_pos->col = curwin->w_cursor.col + 1;
10793 }
10794
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010795 // If 'n' flag is used or search failed: restore cursor position.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010796 if ((flags & SP_NOMOVE) || retval == 0)
10797 curwin->w_cursor = save_cursor;
10798
10799theend:
Bram Moolenaar5ea38d12022-06-16 21:20:48 +010010800#ifdef FEAT_RELTIME
Bram Moolenaar0f618382022-08-26 21:33:04 +010010801 if (time_limit > 0)
10802 disable_regexp_timeout();
Bram Moolenaar5ea38d12022-06-16 21:20:48 +010010803#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010804 vim_free(pat2);
10805 vim_free(pat3);
10806 if (p_cpo == empty_option)
10807 p_cpo = save_cpo;
10808 else
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010010809 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010010810 // Darn, evaluating the {skip} expression changed the value.
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010010811 // If it's still empty it was changed and restored, need to restore in
10812 // the complicated way.
10813 if (*p_cpo == NUL)
Bram Moolenaar31e5c602022-04-15 13:53:33 +010010814 set_option_value_give_err((char_u *)"cpo", 0L, save_cpo, 0);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010815 free_string_option(save_cpo);
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010010816 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010817
10818 return retval;
10819}
10820
10821/*
10822 * "searchpos()" function
10823 */
10824 static void
10825f_searchpos(typval_T *argvars, typval_T *rettv)
10826{
10827 pos_T match_pos;
10828 int lnum = 0;
10829 int col = 0;
10830 int n;
10831 int flags = 0;
10832
10833 if (rettv_list_alloc(rettv) == FAIL)
10834 return;
10835
10836 n = search_cmn(argvars, &match_pos, &flags);
10837 if (n > 0)
10838 {
10839 lnum = match_pos.lnum;
10840 col = match_pos.col;
10841 }
10842
10843 list_append_number(rettv->vval.v_list, (varnumber_T)lnum);
10844 list_append_number(rettv->vval.v_list, (varnumber_T)col);
10845 if (flags & SP_SUBPAT)
10846 list_append_number(rettv->vval.v_list, (varnumber_T)n);
10847}
10848
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010849/*
10850 * Set the cursor or mark position.
zeertzjq47eec672023-06-01 20:26:55 +010010851 * If "charpos" is TRUE, then use the column number as a character offset.
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010852 * Otherwise use the column number as a byte offset.
10853 */
10854 static void
10855set_position(typval_T *argvars, typval_T *rettv, int charpos)
10856{
10857 pos_T pos;
10858 int fnum;
10859 char_u *name;
10860 colnr_T curswant = -1;
10861
10862 rettv->vval.v_number = -1;
10863
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020010864 if (in_vim9script()
10865 && (check_for_string_arg(argvars, 0) == FAIL
10866 || check_for_list_arg(argvars, 1) == FAIL))
10867 return;
10868
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010869 name = tv_get_string_chk(argvars);
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010870 if (name == NULL)
10871 return;
10872
10873 if (list2fpos(&argvars[1], &pos, &fnum, &curswant, charpos) != OK)
10874 return;
10875
10876 if (pos.col != MAXCOL && --pos.col < 0)
10877 pos.col = 0;
10878 if ((name[0] == '.' && name[1] == NUL))
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010879 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010880 // set cursor; "fnum" is ignored
10881 curwin->w_cursor = pos;
10882 if (curswant >= 0)
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010883 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010884 curwin->w_curswant = curswant - 1;
10885 curwin->w_set_curswant = FALSE;
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010886 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010887 check_cursor();
10888 rettv->vval.v_number = 0;
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010889 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010890 else if (name[0] == '\'' && name[1] != NUL && name[2] == NUL)
10891 {
10892 // set mark
10893 if (setmark_pos(name[1], &pos, fnum) == OK)
10894 rettv->vval.v_number = 0;
10895 }
10896 else
10897 emsg(_(e_invalid_argument));
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010898}
10899/*
10900 * "setcharpos()" function
10901 */
10902 static void
10903f_setcharpos(typval_T *argvars, typval_T *rettv)
10904{
10905 set_position(argvars, rettv, TRUE);
10906}
10907
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010908 static void
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010909f_setcharsearch(typval_T *argvars, typval_T *rettv UNUSED)
10910{
10911 dict_T *d;
10912 dictitem_T *di;
10913 char_u *csearch;
10914
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +010010915 if (check_for_dict_arg(argvars, 0) == FAIL)
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010916 return;
10917
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010918 if ((d = argvars[0].vval.v_dict) == NULL)
10919 return;
10920
10921 csearch = dict_get_string(d, "char", FALSE);
10922 if (csearch != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010923 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010924 if (enc_utf8)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010925 {
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010926 int pcc[MAX_MCO];
10927 int c = utfc_ptr2char(csearch, pcc);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010928
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010929 set_last_csearch(c, csearch, utfc_ptr2len(csearch));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010930 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010931 else
10932 set_last_csearch(PTR2CHAR(csearch),
10933 csearch, mb_ptr2len(csearch));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010934 }
Yegappan Lakshmanandc4daa32023-01-02 16:54:53 +000010935
10936 di = dict_find(d, (char_u *)"forward", -1);
10937 if (di != NULL)
10938 set_csearch_direction((int)tv_get_number(&di->di_tv)
10939 ? FORWARD : BACKWARD);
10940
10941 di = dict_find(d, (char_u *)"until", -1);
10942 if (di != NULL)
10943 set_csearch_until(!!tv_get_number(&di->di_tv));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010944}
10945
10946/*
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010947 * "setcursorcharpos" function
10948 */
10949 static void
Bram Moolenaar3af15ab2021-01-17 16:16:23 +010010950f_setcursorcharpos(typval_T *argvars, typval_T *rettv)
Bram Moolenaar6f02b002021-01-10 20:22:54 +010010951{
10952 set_cursorpos(argvars, rettv, TRUE);
10953}
10954
10955/*
Bram Moolenaar691ddee2019-05-09 14:52:41 +020010956 * "setenv()" function
10957 */
10958 static void
10959f_setenv(typval_T *argvars, typval_T *rettv UNUSED)
10960{
10961 char_u namebuf[NUMBUFLEN];
10962 char_u valbuf[NUMBUFLEN];
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020010963 char_u *name;
Bram Moolenaar691ddee2019-05-09 14:52:41 +020010964
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020010965 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
10966 return;
10967
zeertzjqfcaeb3d2023-11-28 20:46:29 +010010968 // setting an environment variable may be dangerous, e.g. you could
Christian Brabandt6b89dd62023-10-26 22:14:17 +020010969 // setenv GCONV_PATH=/tmp and then have iconv() unexpectedly call
10970 // a shell command using some shared library:
10971 if (check_restricted() || check_secure())
10972 return;
10973
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020010974 name = tv_get_string_buf(&argvars[0], namebuf);
Bram Moolenaar691ddee2019-05-09 14:52:41 +020010975 if (argvars[1].v_type == VAR_SPECIAL
10976 && argvars[1].vval.v_number == VVAL_NULL)
LemonBoy77142312022-04-15 20:50:46 +010010977 vim_unsetenv_ext(name);
Bram Moolenaar691ddee2019-05-09 14:52:41 +020010978 else
LemonBoy77142312022-04-15 20:50:46 +010010979 vim_setenv_ext(name, tv_get_string_buf(&argvars[1], valbuf));
Bram Moolenaar691ddee2019-05-09 14:52:41 +020010980}
10981
10982/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020010983 * "setfperm({fname}, {mode})" function
10984 */
10985 static void
10986f_setfperm(typval_T *argvars, typval_T *rettv)
10987{
10988 char_u *fname;
10989 char_u modebuf[NUMBUFLEN];
10990 char_u *mode_str;
10991 int i;
10992 int mask;
10993 int mode = 0;
10994
10995 rettv->vval.v_number = 0;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020010996
10997 if (in_vim9script()
10998 && (check_for_string_arg(argvars, 0) == FAIL
10999 || check_for_string_arg(argvars, 1) == FAIL))
11000 return;
11001
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011002 fname = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011003 if (fname == NULL)
11004 return;
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011005 mode_str = tv_get_string_buf_chk(&argvars[1], modebuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011006 if (mode_str == NULL)
11007 return;
11008 if (STRLEN(mode_str) != 9)
11009 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000011010 semsg(_(e_invalid_argument_str), mode_str);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011011 return;
11012 }
11013
11014 mask = 1;
11015 for (i = 8; i >= 0; --i)
11016 {
11017 if (mode_str[i] != '-')
11018 mode |= mask;
11019 mask = mask << 1;
11020 }
11021 rettv->vval.v_number = mch_setperm(fname, mode) == OK;
11022}
11023
11024/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011025 * "setpos()" function
11026 */
11027 static void
11028f_setpos(typval_T *argvars, typval_T *rettv)
11029{
Bram Moolenaar6f02b002021-01-10 20:22:54 +010011030 set_position(argvars, rettv, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011031}
11032
11033/*
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011034 * Translate a register type string to the yank type and block length
11035 */
11036 static int
11037get_yank_type(char_u **pp, char_u *yank_type, long *block_len)
11038{
11039 char_u *stropt = *pp;
11040 switch (*stropt)
11041 {
11042 case 'v': case 'c': // character-wise selection
11043 *yank_type = MCHAR;
11044 break;
11045 case 'V': case 'l': // line-wise selection
11046 *yank_type = MLINE;
11047 break;
11048 case 'b': case Ctrl_V: // block-wise selection
11049 *yank_type = MBLOCK;
11050 if (VIM_ISDIGIT(stropt[1]))
11051 {
11052 ++stropt;
11053 *block_len = getdigits(&stropt) - 1;
11054 --stropt;
11055 }
11056 break;
11057 default:
11058 return FAIL;
11059 }
11060 *pp = stropt;
11061 return OK;
11062}
11063
11064/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011065 * "setreg()" function
11066 */
11067 static void
11068f_setreg(typval_T *argvars, typval_T *rettv)
11069{
11070 int regname;
11071 char_u *strregname;
11072 char_u *stropt;
11073 char_u *strval;
11074 int append;
11075 char_u yank_type;
11076 long block_len;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011077 typval_T *regcontents;
11078 int pointreg;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011079
Yegappan Lakshmanana764e732021-07-25 15:57:32 +020011080 if (in_vim9script()
11081 && (check_for_string_arg(argvars, 0) == FAIL
11082 || check_for_opt_string_arg(argvars, 2) == FAIL))
11083 return;
11084
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011085 pointreg = 0;
11086 regcontents = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011087 block_len = -1;
11088 yank_type = MAUTO;
11089 append = FALSE;
11090
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011091 strregname = tv_get_string_chk(argvars);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011092 rettv->vval.v_number = 1; // FAIL is default
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011093
11094 if (strregname == NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011095 return; // type error; errmsg already given
Bram Moolenaar418a29f2021-02-10 22:23:41 +010011096 if (in_vim9script() && STRLEN(strregname) > 1)
11097 {
11098 semsg(_(e_register_name_must_be_one_char_str), strregname);
11099 return;
11100 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011101 regname = *strregname;
11102 if (regname == 0 || regname == '@')
11103 regname = '"';
11104
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011105 if (argvars[1].v_type == VAR_DICT)
11106 {
11107 dict_T *d = argvars[1].vval.v_dict;
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011108 dictitem_T *di;
11109
11110 if (d == NULL || d->dv_hashtab.ht_used == 0)
11111 {
11112 // Empty dict, clear the register (like setreg(0, []))
11113 char_u *lstval[2] = {NULL, NULL};
11114 write_reg_contents_lst(regname, lstval, 0, FALSE, MAUTO, -1);
11115 return;
11116 }
11117
11118 di = dict_find(d, (char_u *)"regcontents", -1);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011119 if (di != NULL)
11120 regcontents = &di->di_tv;
11121
Bram Moolenaard61efa52022-07-23 09:52:04 +010011122 stropt = dict_get_string(d, "regtype", FALSE);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011123 if (stropt != NULL)
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011124 {
11125 int ret = get_yank_type(&stropt, &yank_type, &block_len);
11126
11127 if (ret == FAIL || *++stropt != NUL)
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011128 {
Bram Moolenaar436b5ad2021-12-31 22:49:24 +000011129 semsg(_(e_invalid_value_for_argument_str), "value");
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011130 return;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011131 }
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011132 }
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011133
11134 if (regname == '"')
11135 {
Bram Moolenaard61efa52022-07-23 09:52:04 +010011136 stropt = dict_get_string(d, "points_to", FALSE);
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011137 if (stropt != NULL)
11138 {
11139 pointreg = *stropt;
11140 regname = pointreg;
11141 }
11142 }
Bram Moolenaard61efa52022-07-23 09:52:04 +010011143 else if (dict_get_bool(d, "isunnamed", -1) > 0)
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011144 pointreg = regname;
11145 }
11146 else
11147 regcontents = &argvars[1];
11148
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011149 if (argvars[2].v_type != VAR_UNKNOWN)
11150 {
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011151 if (yank_type != MAUTO)
11152 {
Bram Moolenaare1242042021-12-16 20:56:57 +000011153 semsg(_(e_too_many_arguments_for_function_str), "setreg");
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011154 return;
11155 }
11156
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011157 stropt = tv_get_string_chk(&argvars[2]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011158 if (stropt == NULL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011159 return; // type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011160 for (; *stropt != NUL; ++stropt)
11161 switch (*stropt)
11162 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011163 case 'a': case 'A': // append
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011164 append = TRUE;
11165 break;
Bram Moolenaar7633fe52020-06-22 19:10:56 +020011166 default:
11167 get_yank_type(&stropt, &yank_type, &block_len);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011168 }
11169 }
11170
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011171 if (regcontents && regcontents->v_type == VAR_LIST)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011172 {
11173 char_u **lstval;
11174 char_u **allocval;
11175 char_u buf[NUMBUFLEN];
11176 char_u **curval;
11177 char_u **curallocval;
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011178 list_T *ll = regcontents->vval.v_list;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011179 listitem_T *li;
11180 int len;
11181
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011182 // If the list is NULL handle like an empty list.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011183 len = ll == NULL ? 0 : ll->lv_len;
11184
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011185 // First half: use for pointers to result lines; second half: use for
11186 // pointers to allocated copies.
Bram Moolenaarc799fe22019-05-28 23:08:19 +020011187 lstval = ALLOC_MULT(char_u *, (len + 1) * 2);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011188 if (lstval == NULL)
11189 return;
11190 curval = lstval;
11191 allocval = lstval + len + 2;
11192 curallocval = allocval;
11193
Bram Moolenaar50985eb2020-01-27 22:09:39 +010011194 if (ll != NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011195 {
Bram Moolenaar7e9f3512020-05-13 22:44:22 +020011196 CHECK_LIST_MATERIALIZE(ll);
Bram Moolenaar00d253e2020-04-06 22:13:01 +020011197 FOR_ALL_LIST_ITEMS(ll, li)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011198 {
Bram Moolenaar50985eb2020-01-27 22:09:39 +010011199 strval = tv_get_string_buf_chk(&li->li_tv, buf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011200 if (strval == NULL)
11201 goto free_lstval;
Bram Moolenaar50985eb2020-01-27 22:09:39 +010011202 if (strval == buf)
11203 {
11204 // Need to make a copy, next tv_get_string_buf_chk() will
11205 // overwrite the string.
11206 strval = vim_strsave(buf);
11207 if (strval == NULL)
11208 goto free_lstval;
11209 *curallocval++ = strval;
11210 }
11211 *curval++ = strval;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011212 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011213 }
11214 *curval++ = NULL;
11215
11216 write_reg_contents_lst(regname, lstval, -1,
11217 append, yank_type, block_len);
11218free_lstval:
11219 while (curallocval > allocval)
11220 vim_free(*--curallocval);
11221 vim_free(lstval);
11222 }
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011223 else if (regcontents)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011224 {
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011225 strval = tv_get_string_chk(regcontents);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011226 if (strval == NULL)
11227 return;
11228 write_reg_contents_ex(regname, strval, -1,
11229 append, yank_type, block_len);
11230 }
Bram Moolenaarbb861e22020-06-07 18:16:36 +020011231 if (pointreg != 0)
11232 get_yank_register(pointreg, TRUE);
11233
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011234 rettv->vval.v_number = 0;
11235}
11236
11237/*
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011238 * "settagstack()" function
11239 */
11240 static void
11241f_settagstack(typval_T *argvars, typval_T *rettv)
11242{
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011243 win_T *wp;
11244 dict_T *d;
11245 int action = 'r';
11246
11247 rettv->vval.v_number = -1;
11248
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011249 if (in_vim9script()
11250 && (check_for_number_arg(argvars, 0) == FAIL
11251 || check_for_dict_arg(argvars, 1) == FAIL
11252 || check_for_opt_string_arg(argvars, 2) == FAIL))
11253 return;
11254
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011255 // first argument: window number or id
11256 wp = find_win_by_nr_or_id(&argvars[0]);
11257 if (wp == NULL)
11258 return;
11259
11260 // second argument: dict with items to set in the tag stack
Yegappan Lakshmanan04c4c572022-08-30 19:48:24 +010011261 if (check_for_dict_arg(argvars, 1) == FAIL)
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011262 return;
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011263 d = argvars[1].vval.v_dict;
11264 if (d == NULL)
11265 return;
11266
11267 // third argument: action - 'a' for append and 'r' for replace.
11268 // default is to replace the stack.
11269 if (argvars[2].v_type == VAR_UNKNOWN)
11270 action = 'r';
Yegappan Lakshmanan8deb2b32022-09-02 15:15:27 +010011271 else if (check_for_string_arg(argvars, 2) == FAIL)
11272 return;
11273 else
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011274 {
11275 char_u *actstr;
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011276 actstr = tv_get_string_chk(&argvars[2]);
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011277 if (actstr == NULL)
11278 return;
Bram Moolenaar271fa082020-01-02 14:02:16 +010011279 if ((*actstr == 'r' || *actstr == 'a' || *actstr == 't')
11280 && actstr[1] == NUL)
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011281 action = *actstr;
11282 else
11283 {
Bram Moolenaard82a47d2022-01-05 20:24:39 +000011284 semsg(_(e_invalid_action_str_2), actstr);
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011285 return;
11286 }
11287 }
Bram Moolenaarf49cc602018-11-11 15:21:05 +010011288
11289 if (set_tagstack(wp, d, action) == OK)
11290 rettv->vval.v_number = 0;
11291}
11292
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011293#ifdef FEAT_CRYPT
11294/*
11295 * "sha256({string})" function
11296 */
11297 static void
11298f_sha256(typval_T *argvars, typval_T *rettv)
11299{
11300 char_u *p;
11301
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011302 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11303 return;
11304
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011305 p = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011306 rettv->vval.v_string = vim_strsave(
11307 sha256_bytes(p, (int)STRLEN(p), NULL, 0));
11308 rettv->v_type = VAR_STRING;
11309}
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011310#endif // FEAT_CRYPT
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011311
11312/*
11313 * "shellescape({string})" function
11314 */
11315 static void
11316f_shellescape(typval_T *argvars, typval_T *rettv)
11317{
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011318 int do_special;
Bram Moolenaar20615522017-06-05 18:46:26 +020011319
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011320 if (in_vim9script()
11321 && (check_for_string_arg(argvars, 0) == FAIL
11322 || check_for_opt_bool_arg(argvars, 1) == FAIL))
11323 return;
11324
11325 do_special = non_zero_arg(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011326 rettv->vval.v_string = vim_strsave_shellescape(
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011327 tv_get_string(&argvars[0]), do_special, do_special);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011328 rettv->v_type = VAR_STRING;
11329}
11330
11331/*
11332 * shiftwidth() function
11333 */
11334 static void
11335f_shiftwidth(typval_T *argvars UNUSED, typval_T *rettv)
11336{
Bram Moolenaarf9514162018-11-22 03:08:29 +010011337 rettv->vval.v_number = 0;
11338
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011339 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
11340 return;
11341
Bram Moolenaarf9514162018-11-22 03:08:29 +010011342 if (argvars[0].v_type != VAR_UNKNOWN)
11343 {
11344 long col;
11345
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011346 col = (long)tv_get_number_chk(argvars, NULL);
Bram Moolenaarf9514162018-11-22 03:08:29 +010011347 if (col < 0)
11348 return; // type error; errmsg already given
11349#ifdef FEAT_VARTABS
Gary Johnson88d4f252024-06-01 20:51:33 +020011350 rettv->vval.v_number = get_sw_value_col(curbuf, col, FALSE);
Bram Moolenaarf9514162018-11-22 03:08:29 +010011351 return;
11352#endif
11353 }
11354
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011355 rettv->vval.v_number = get_sw_value(curbuf);
11356}
11357
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011358/*
11359 * "soundfold({word})" function
11360 */
11361 static void
11362f_soundfold(typval_T *argvars, typval_T *rettv)
11363{
11364 char_u *s;
11365
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011366 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11367 return;
11368
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011369 rettv->v_type = VAR_STRING;
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011370 s = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011371#ifdef FEAT_SPELL
11372 rettv->vval.v_string = eval_soundfold(s);
11373#else
11374 rettv->vval.v_string = vim_strsave(s);
11375#endif
11376}
11377
11378/*
11379 * "spellbadword()" function
11380 */
11381 static void
11382f_spellbadword(typval_T *argvars UNUSED, typval_T *rettv)
11383{
11384 char_u *word = (char_u *)"";
11385 hlf_T attr = HLF_COUNT;
11386 int len = 0;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011387#ifdef FEAT_SPELL
11388 int wo_spell_save = curwin->w_p_spell;
11389
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011390 if (in_vim9script() && check_for_opt_string_arg(argvars, 0) == FAIL)
11391 return;
11392
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011393 if (!curwin->w_p_spell)
11394 {
Yegappan Lakshmananaf936912023-02-20 12:16:39 +000011395 parse_spelllang(curwin);
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011396 curwin->w_p_spell = TRUE;
11397 }
11398
11399 if (*curwin->w_s->b_p_spl == NUL)
11400 {
Bram Moolenaar460ae5d2022-01-01 14:19:49 +000011401 emsg(_(e_spell_checking_is_not_possible));
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011402 curwin->w_p_spell = wo_spell_save;
11403 return;
11404 }
11405#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011406
11407 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011408 {
11409#ifdef FEAT_SPELL
11410 curwin->w_p_spell = wo_spell_save;
11411#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011412 return;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011413 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011414
11415#ifdef FEAT_SPELL
11416 if (argvars[0].v_type == VAR_UNKNOWN)
11417 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011418 // Find the start and length of the badly spelled word.
Christ van Willegen - van Noort8e4c4c72024-05-17 18:49:27 +020011419 len = spell_move_to(curwin, FORWARD, SMT_ALL, TRUE, &attr);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011420 if (len != 0)
Bram Moolenaarb73fa622017-12-21 20:27:47 +010011421 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011422 word = ml_get_cursor();
Bram Moolenaarb73fa622017-12-21 20:27:47 +010011423 curwin->w_set_curswant = TRUE;
11424 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011425 }
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011426 else if (*curbuf->b_s.b_p_spl != NUL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011427 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011428 char_u *str = tv_get_string_chk(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011429 int capcol = -1;
11430
11431 if (str != NULL)
11432 {
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011433 // Check the argument for spelling.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011434 while (*str != NUL)
11435 {
11436 len = spell_check(curwin, str, &attr, &capcol, FALSE);
11437 if (attr != HLF_COUNT)
11438 {
11439 word = str;
11440 break;
11441 }
11442 str += len;
Bram Moolenaar66ab9162018-07-20 20:28:48 +020011443 capcol -= len;
Bram Moolenaar0c779e82019-08-09 17:01:02 +020011444 len = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011445 }
11446 }
11447 }
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011448 curwin->w_p_spell = wo_spell_save;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011449#endif
11450
11451 list_append_string(rettv->vval.v_list, word, len);
11452 list_append_string(rettv->vval.v_list, (char_u *)(
11453 attr == HLF_SPB ? "bad" :
11454 attr == HLF_SPR ? "rare" :
11455 attr == HLF_SPL ? "local" :
11456 attr == HLF_SPC ? "caps" :
11457 ""), -1);
11458}
11459
11460/*
11461 * "spellsuggest()" function
11462 */
11463 static void
11464f_spellsuggest(typval_T *argvars UNUSED, typval_T *rettv)
11465{
11466#ifdef FEAT_SPELL
11467 char_u *str;
11468 int typeerr = FALSE;
11469 int maxcount;
11470 garray_T ga;
11471 int i;
11472 listitem_T *li;
11473 int need_capital = FALSE;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011474 int wo_spell_save = curwin->w_p_spell;
11475
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011476 if (in_vim9script()
11477 && (check_for_string_arg(argvars, 0) == FAIL
11478 || check_for_opt_number_arg(argvars, 1) == FAIL
11479 || (argvars[1].v_type != VAR_UNKNOWN
11480 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
11481 return;
11482
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011483 if (!curwin->w_p_spell)
11484 {
Yegappan Lakshmananaf936912023-02-20 12:16:39 +000011485 parse_spelllang(curwin);
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011486 curwin->w_p_spell = TRUE;
11487 }
11488
11489 if (*curwin->w_s->b_p_spl == NUL)
11490 {
Bram Moolenaar460ae5d2022-01-01 14:19:49 +000011491 emsg(_(e_spell_checking_is_not_possible));
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011492 curwin->w_p_spell = wo_spell_save;
11493 return;
11494 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011495#endif
11496
11497 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011498 {
11499#ifdef FEAT_SPELL
11500 curwin->w_p_spell = wo_spell_save;
11501#endif
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011502 return;
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011503 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011504
11505#ifdef FEAT_SPELL
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011506 str = tv_get_string(&argvars[0]);
11507 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011508 {
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011509 maxcount = (int)tv_get_number_chk(&argvars[1], &typeerr);
11510 if (maxcount <= 0)
11511 return;
11512 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011513 {
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011514 need_capital = (int)tv_get_bool_chk(&argvars[2], &typeerr);
11515 if (typeerr)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011516 return;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011517 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011518 }
=?UTF-8?q?Dundar=20G=C3=B6c?=dd410372022-05-15 13:59:11 +010011519 else
11520 maxcount = 25;
11521
11522 spell_suggest_list(&ga, str, maxcount, need_capital, FALSE);
11523
11524 for (i = 0; i < ga.ga_len; ++i)
11525 {
11526 str = ((char_u **)ga.ga_data)[i];
11527
11528 li = listitem_alloc();
11529 if (li == NULL)
11530 vim_free(str);
11531 else
11532 {
11533 li->li_tv.v_type = VAR_STRING;
11534 li->li_tv.v_lock = 0;
11535 li->li_tv.vval.v_string = str;
11536 list_append(rettv->vval.v_list, li);
11537 }
11538 }
11539 ga_clear(&ga);
Bram Moolenaar152e79e2020-06-10 15:32:08 +020011540 curwin->w_p_spell = wo_spell_save;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011541#endif
11542}
11543
11544 static void
11545f_split(typval_T *argvars, typval_T *rettv)
11546{
11547 char_u *str;
11548 char_u *end;
11549 char_u *pat = NULL;
11550 regmatch_T regmatch;
11551 char_u patbuf[NUMBUFLEN];
11552 char_u *save_cpo;
11553 int match;
11554 colnr_T col = 0;
11555 int keepempty = FALSE;
11556 int typeerr = FALSE;
11557
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011558 if (in_vim9script()
11559 && (check_for_string_arg(argvars, 0) == FAIL
11560 || check_for_opt_string_arg(argvars, 1) == FAIL
11561 || (argvars[1].v_type != VAR_UNKNOWN
11562 && check_for_opt_bool_arg(argvars, 2) == FAIL)))
11563 return;
11564
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011565 // Make 'cpoptions' empty, the 'l' flag should not be used here.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011566 save_cpo = p_cpo;
Bram Moolenaare5a2dc82021-01-03 19:52:05 +010011567 p_cpo = empty_option;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011568
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011569 str = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011570 if (argvars[1].v_type != VAR_UNKNOWN)
11571 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011572 pat = tv_get_string_buf_chk(&argvars[1], patbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011573 if (pat == NULL)
11574 typeerr = TRUE;
11575 if (argvars[2].v_type != VAR_UNKNOWN)
Bram Moolenaar3986b942020-09-06 16:09:04 +020011576 keepempty = (int)tv_get_bool_chk(&argvars[2], &typeerr);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011577 }
11578 if (pat == NULL || *pat == NUL)
11579 pat = (char_u *)"[\\x01- ]\\+";
11580
11581 if (rettv_list_alloc(rettv) == FAIL)
Bram Moolenaar7d5e7442020-07-21 22:25:51 +020011582 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011583 if (typeerr)
Bram Moolenaar7d5e7442020-07-21 22:25:51 +020011584 goto theend;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011585
11586 regmatch.regprog = vim_regcomp(pat, RE_MAGIC + RE_STRING);
11587 if (regmatch.regprog != NULL)
11588 {
11589 regmatch.rm_ic = FALSE;
11590 while (*str != NUL || keepempty)
11591 {
11592 if (*str == NUL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011593 match = FALSE; // empty item at the end
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011594 else
11595 match = vim_regexec_nl(&regmatch, str, col);
11596 if (match)
11597 end = regmatch.startp[0];
11598 else
11599 end = str + STRLEN(str);
11600 if (keepempty || end > str || (rettv->vval.v_list->lv_len > 0
11601 && *str != NUL && match && end < regmatch.endp[0]))
11602 {
11603 if (list_append_string(rettv->vval.v_list, str,
11604 (int)(end - str)) == FAIL)
11605 break;
11606 }
11607 if (!match)
11608 break;
Bram Moolenaar13505972019-01-24 15:04:48 +010011609 // Advance to just after the match.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011610 if (regmatch.endp[0] > str)
11611 col = 0;
11612 else
Bram Moolenaar13505972019-01-24 15:04:48 +010011613 // Don't get stuck at the same match.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011614 col = (*mb_ptr2len)(regmatch.endp[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011615 str = regmatch.endp[0];
11616 }
11617
11618 vim_regfree(regmatch.regprog);
11619 }
11620
Bram Moolenaar7d5e7442020-07-21 22:25:51 +020011621theend:
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011622 p_cpo = save_cpo;
11623}
11624
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011625/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011626 * "submatch()" function
11627 */
11628 static void
11629f_submatch(typval_T *argvars, typval_T *rettv)
11630{
11631 int error = FALSE;
11632 int no;
11633 int retList = 0;
11634
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011635 if (in_vim9script()
11636 && (check_for_number_arg(argvars, 0) == FAIL
11637 || check_for_opt_bool_arg(argvars, 1) == FAIL))
11638 return;
11639
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011640 no = (int)tv_get_number_chk(&argvars[0], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011641 if (error)
11642 return;
Bram Moolenaar989f5922016-08-21 15:26:54 +020011643 if (no < 0 || no >= NSUBEXP)
11644 {
Bram Moolenaard82a47d2022-01-05 20:24:39 +000011645 semsg(_(e_invalid_submatch_number_nr), no);
Bram Moolenaar79518e22017-02-17 16:31:35 +010011646 return;
Bram Moolenaar989f5922016-08-21 15:26:54 +020011647 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011648 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaarad304702020-09-06 18:22:53 +020011649 retList = (int)tv_get_bool_chk(&argvars[1], &error);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011650 if (error)
11651 return;
11652
11653 if (retList == 0)
11654 {
11655 rettv->v_type = VAR_STRING;
11656 rettv->vval.v_string = reg_submatch(no);
11657 }
11658 else
11659 {
11660 rettv->v_type = VAR_LIST;
11661 rettv->vval.v_list = reg_submatch_list(no);
11662 }
11663}
11664
11665/*
11666 * "substitute()" function
11667 */
11668 static void
11669f_substitute(typval_T *argvars, typval_T *rettv)
11670{
11671 char_u patbuf[NUMBUFLEN];
11672 char_u subbuf[NUMBUFLEN];
11673 char_u flagsbuf[NUMBUFLEN];
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +020011674 char_u *str;
11675 char_u *pat;
Bram Moolenaar72ab7292016-07-19 19:10:51 +020011676 char_u *sub = NULL;
11677 typval_T *expr = NULL;
Yegappan Lakshmanan5bca9062021-07-24 21:33:26 +020011678 char_u *flg;
11679
11680 if (in_vim9script()
11681 && (check_for_string_arg(argvars, 0) == FAIL
11682 || check_for_string_arg(argvars, 1) == FAIL
11683 || check_for_string_arg(argvars, 3) == FAIL))
11684 return;
11685
11686 str = tv_get_string_chk(&argvars[0]);
11687 pat = tv_get_string_buf_chk(&argvars[1], patbuf);
11688 flg = tv_get_string_buf_chk(&argvars[3], flagsbuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011689
LemonBoyf3b48952022-05-05 13:53:03 +010011690 if (argvars[2].v_type == VAR_FUNC
11691 || argvars[2].v_type == VAR_PARTIAL
Bram Moolenaar00b28d62022-12-08 15:32:33 +000011692 || argvars[2].v_type == VAR_INSTR
11693 || argvars[2].v_type == VAR_CLASS
11694 || argvars[2].v_type == VAR_OBJECT)
Bram Moolenaar72ab7292016-07-19 19:10:51 +020011695 expr = &argvars[2];
11696 else
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011697 sub = tv_get_string_buf_chk(&argvars[2], subbuf);
Bram Moolenaar72ab7292016-07-19 19:10:51 +020011698
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011699 rettv->v_type = VAR_STRING;
Bram Moolenaar72ab7292016-07-19 19:10:51 +020011700 if (str == NULL || pat == NULL || (sub == NULL && expr == NULL)
11701 || flg == NULL)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011702 rettv->vval.v_string = NULL;
11703 else
John Marriottbd4614f2024-11-18 20:25:21 +010011704 rettv->vval.v_string = do_string_sub(str, STRLEN(str), pat, sub, expr, flg, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011705}
11706
11707/*
Bram Moolenaarc216a7a2022-12-05 13:50:55 +000011708 * "swapfilelist()" function
11709 */
11710 static void
11711f_swapfilelist(typval_T *argvars UNUSED, typval_T *rettv)
11712{
11713 if (rettv_list_alloc(rettv) == FAIL)
11714 return;
11715 recover_names(NULL, FALSE, rettv->vval.v_list, 0, NULL);
11716}
11717
11718/*
Bram Moolenaar00f123a2018-08-21 20:28:54 +020011719 * "swapinfo(swap_filename)" function
11720 */
11721 static void
11722f_swapinfo(typval_T *argvars, typval_T *rettv)
11723{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011724 if (in_vim9script() && check_for_string_arg(argvars, 0) == FAIL)
11725 return;
11726
Bram Moolenaar00f123a2018-08-21 20:28:54 +020011727 if (rettv_dict_alloc(rettv) == OK)
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011728 get_b0_dict(tv_get_string(argvars), rettv->vval.v_dict);
Bram Moolenaar00f123a2018-08-21 20:28:54 +020011729}
11730
11731/*
Bram Moolenaar110bd602018-09-16 18:46:59 +020011732 * "swapname(expr)" function
11733 */
11734 static void
11735f_swapname(typval_T *argvars, typval_T *rettv)
11736{
11737 buf_T *buf;
11738
11739 rettv->v_type = VAR_STRING;
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011740
11741 if (in_vim9script() && check_for_buffer_arg(argvars, 0) == FAIL)
11742 return;
11743
Bram Moolenaarf2d79fa2019-01-03 22:19:27 +010011744 buf = tv_get_buf(&argvars[0], FALSE);
Bram Moolenaar110bd602018-09-16 18:46:59 +020011745 if (buf == NULL || buf->b_ml.ml_mfp == NULL
11746 || buf->b_ml.ml_mfp->mf_fname == NULL)
11747 rettv->vval.v_string = NULL;
11748 else
11749 rettv->vval.v_string = vim_strsave(buf->b_ml.ml_mfp->mf_fname);
11750}
11751
11752/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011753 * "synID(lnum, col, trans)" function
11754 */
11755 static void
11756f_synID(typval_T *argvars UNUSED, typval_T *rettv)
11757{
11758 int id = 0;
11759#ifdef FEAT_SYN_HL
11760 linenr_T lnum;
11761 colnr_T col;
11762 int trans;
11763 int transerr = FALSE;
11764
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011765 if (in_vim9script()
Yegappan Lakshmanancd917202021-07-21 19:09:09 +020011766 && (check_for_lnum_arg(argvars, 0) == FAIL
Yegappan Lakshmanan83494b42021-07-20 17:51:51 +020011767 || check_for_number_arg(argvars, 1) == FAIL
11768 || check_for_bool_arg(argvars, 2) == FAIL))
11769 return;
11770
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011771 lnum = tv_get_lnum(argvars); // -1 on type error
11772 col = (linenr_T)tv_get_number(&argvars[1]) - 1; // -1 on type error
Bram Moolenaarfcb6d702020-09-05 21:41:56 +020011773 trans = (int)tv_get_bool_chk(&argvars[2], &transerr);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011774
11775 if (!transerr && lnum >= 1 && lnum <= curbuf->b_ml.ml_line_count
John Marriottbfcc8952024-03-11 22:04:45 +010011776 && col >= 0 && col < (long)ml_get_len(lnum))
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +000011777 id = syn_get_id(curwin, lnum, col, trans, NULL, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011778#endif
11779
11780 rettv->vval.v_number = id;
11781}
11782
11783/*
11784 * "synIDattr(id, what [, mode])" function
11785 */
11786 static void
11787f_synIDattr(typval_T *argvars UNUSED, typval_T *rettv)
11788{
11789 char_u *p = NULL;
11790#ifdef FEAT_SYN_HL
11791 int id;
11792 char_u *what;
11793 char_u *mode;
11794 char_u modebuf[NUMBUFLEN];
11795 int modec;
11796
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +020011797 if (in_vim9script()
11798 && (check_for_number_arg(argvars, 0) == FAIL
Yegappan Lakshmananf8dbd582021-09-26 19:04:05 +010011799 || check_for_string_arg(argvars, 1) == FAIL
11800 || check_for_opt_string_arg(argvars, 2) == FAIL))
Yegappan Lakshmanan7973de32021-07-24 16:16:15 +020011801 return;
11802
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011803 id = (int)tv_get_number(&argvars[0]);
11804 what = tv_get_string(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011805 if (argvars[2].v_type != VAR_UNKNOWN)
11806 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011807 mode = tv_get_string_buf(&argvars[2], modebuf);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011808 modec = TOLOWER_ASC(mode[0]);
11809 if (modec != 't' && modec != 'c' && modec != 'g')
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011810 modec = 0; // replace invalid with current
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011811 }
11812 else
11813 {
11814#if defined(FEAT_GUI) || defined(FEAT_TERMGUICOLORS)
11815 if (USE_24BIT)
11816 modec = 'g';
11817 else
11818#endif
11819 if (t_colors > 1)
Dominique Pelle4781d6f2021-05-18 21:46:31 +020011820 modec = 'c';
11821 else
11822 modec = 't';
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011823 }
11824
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011825 switch (TOLOWER_ASC(what[0]))
11826 {
11827 case 'b':
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011828 if (TOLOWER_ASC(what[1]) == 'g') // bg[#]
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011829 p = highlight_color(id, what, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011830 else // bold
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011831 p = highlight_has_attr(id, HL_BOLD, modec);
11832 break;
11833
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011834 case 'f': // fg[#] or font
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011835 p = highlight_color(id, what, modec);
11836 break;
11837
11838 case 'i':
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011839 if (TOLOWER_ASC(what[1]) == 'n') // inverse
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011840 p = highlight_has_attr(id, HL_INVERSE, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011841 else // italic
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011842 p = highlight_has_attr(id, HL_ITALIC, modec);
11843 break;
11844
Martin Tournoijba43e762022-10-13 22:12:15 +010011845 case 'n':
Bram Moolenaarde786322022-07-30 14:56:17 +010011846 if (TOLOWER_ASC(what[1]) == 'o') // nocombine
11847 p = highlight_has_attr(id, HL_NOCOMBINE, modec);
11848 else // name
11849 p = get_highlight_name_ext(NULL, id - 1, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011850 break;
11851
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011852 case 'r': // reverse
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011853 p = highlight_has_attr(id, HL_INVERSE, modec);
11854 break;
11855
11856 case 's':
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011857 if (TOLOWER_ASC(what[1]) == 'p') // sp[#]
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011858 p = highlight_color(id, what, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011859 // strikeout
Bram Moolenaarcf4b00c2017-09-02 18:33:56 +020011860 else if (TOLOWER_ASC(what[1]) == 't' &&
11861 TOLOWER_ASC(what[2]) == 'r')
11862 p = highlight_has_attr(id, HL_STRIKETHROUGH, modec);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011863 else // standout
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011864 p = highlight_has_attr(id, HL_STANDOUT, modec);
11865 break;
11866
11867 case 'u':
Bram Moolenaar84f54632022-06-29 18:39:11 +010011868 if (STRLEN(what) >= 9)
11869 {
11870 if (TOLOWER_ASC(what[5]) == 'l')
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011871 // underline
Bram Moolenaar84f54632022-06-29 18:39:11 +010011872 p = highlight_has_attr(id, HL_UNDERLINE, modec);
11873 else if (TOLOWER_ASC(what[5]) != 'd')
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011874 // undercurl
Bram Moolenaar84f54632022-06-29 18:39:11 +010011875 p = highlight_has_attr(id, HL_UNDERCURL, modec);
11876 else if (TOLOWER_ASC(what[6]) != 'o')
11877 // underdashed
11878 p = highlight_has_attr(id, HL_UNDERDASHED, modec);
11879 else if (TOLOWER_ASC(what[7]) == 'u')
11880 // underdouble
11881 p = highlight_has_attr(id, HL_UNDERDOUBLE, modec);
11882 else
11883 // underdotted
11884 p = highlight_has_attr(id, HL_UNDERDOTTED, modec);
11885 }
11886 else
11887 // ul
11888 p = highlight_color(id, what, modec);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011889 break;
11890 }
11891
11892 if (p != NULL)
11893 p = vim_strsave(p);
11894#endif
11895 rettv->v_type = VAR_STRING;
11896 rettv->vval.v_string = p;
11897}
11898
11899/*
11900 * "synIDtrans(id)" function
11901 */
11902 static void
11903f_synIDtrans(typval_T *argvars UNUSED, typval_T *rettv)
11904{
11905 int id;
11906
11907#ifdef FEAT_SYN_HL
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020011908 if (in_vim9script() && check_for_number_arg(argvars, 0) == FAIL)
11909 return;
11910
Bram Moolenaard155d7a2018-12-21 16:04:21 +010011911 id = (int)tv_get_number(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011912
11913 if (id > 0)
11914 id = syn_get_final_id(id);
11915 else
11916#endif
11917 id = 0;
11918
11919 rettv->vval.v_number = id;
11920}
11921
11922/*
11923 * "synconcealed(lnum, col)" function
11924 */
11925 static void
11926f_synconcealed(typval_T *argvars UNUSED, typval_T *rettv)
11927{
11928#if defined(FEAT_SYN_HL) && defined(FEAT_CONCEAL)
11929 linenr_T lnum;
11930 colnr_T col;
11931 int syntax_flags = 0;
11932 int cchar;
11933 int matchid = 0;
11934 char_u str[NUMBUFLEN];
11935#endif
11936
Bram Moolenaar45cf6e92017-04-30 20:25:19 +020011937 rettv_list_set(rettv, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011938
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020011939 if (in_vim9script()
Yegappan Lakshmanancd917202021-07-21 19:09:09 +020011940 && (check_for_lnum_arg(argvars, 0) == FAIL
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020011941 || check_for_number_arg(argvars, 1) == FAIL))
11942 return;
11943
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011944#if defined(FEAT_SYN_HL) && defined(FEAT_CONCEAL)
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011945 lnum = tv_get_lnum(argvars); // -1 on type error
11946 col = (colnr_T)tv_get_number(&argvars[1]) - 1; // -1 on type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011947
Bram Moolenaara80faa82020-04-12 19:37:17 +020011948 CLEAR_FIELD(str);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011949
Bram Moolenaar93a10962022-06-16 11:42:09 +010011950 if (rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011951 {
11952 if (lnum >= 1 && lnum <= curbuf->b_ml.ml_line_count
John Marriottbfcc8952024-03-11 22:04:45 +010011953 && col >= 0 && col <= (long)ml_get_len(lnum)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011954 && curwin->w_p_cole > 0)
11955 {
11956 (void)syn_get_id(curwin, lnum, col, FALSE, NULL, FALSE);
11957 syntax_flags = get_syntax_info(&matchid);
11958
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011959 // get the conceal character
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011960 if ((syntax_flags & HL_CONCEAL) && curwin->w_p_cole < 3)
11961 {
11962 cchar = syn_get_sub_char();
Bram Moolenaar4d785892017-06-22 22:00:50 +020011963 if (cchar == NUL && curwin->w_p_cole == 1)
Bram Moolenaareed9d462021-02-15 20:38:25 +010011964 cchar = (curwin->w_lcs_chars.conceal == NUL) ? ' '
11965 : curwin->w_lcs_chars.conceal;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011966 if (cchar != NUL)
11967 {
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011968 if (has_mbyte)
11969 (*mb_char2bytes)(cchar, str);
11970 else
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011971 str[0] = cchar;
11972 }
11973 }
11974 }
11975
11976 list_append_number(rettv->vval.v_list,
11977 (syntax_flags & HL_CONCEAL) != 0);
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010011978 // -1 to auto-determine strlen
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011979 list_append_string(rettv->vval.v_list, str, -1);
11980 list_append_number(rettv->vval.v_list, matchid);
11981 }
11982#endif
11983}
11984
11985/*
11986 * "synstack(lnum, col)" function
11987 */
11988 static void
11989f_synstack(typval_T *argvars UNUSED, typval_T *rettv)
11990{
11991#ifdef FEAT_SYN_HL
11992 linenr_T lnum;
11993 colnr_T col;
11994 int i;
11995 int id;
11996#endif
11997
Bram Moolenaar45cf6e92017-04-30 20:25:19 +020011998 rettv_list_set(rettv, NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020011999
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020012000 if (in_vim9script()
Yegappan Lakshmanancd917202021-07-21 19:09:09 +020012001 && (check_for_lnum_arg(argvars, 0) == FAIL
Yegappan Lakshmanana9a7c0c2021-07-17 19:11:07 +020012002 || check_for_number_arg(argvars, 1) == FAIL))
12003 return;
12004
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012005#ifdef FEAT_SYN_HL
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012006 lnum = tv_get_lnum(argvars); // -1 on type error
12007 col = (colnr_T)tv_get_number(&argvars[1]) - 1; // -1 on type error
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012008
12009 if (lnum >= 1 && lnum <= curbuf->b_ml.ml_line_count
John Marriottbfcc8952024-03-11 22:04:45 +010012010 && col >= 0 && col <= (long)ml_get_len(lnum)
Bram Moolenaar93a10962022-06-16 11:42:09 +010012011 && rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012012 {
=?UTF-8?q?Dundar=20G=C3=B6c?=420fabc2022-01-28 15:28:04 +000012013 (void)syn_get_id(curwin, lnum, col, FALSE, NULL, TRUE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012014 for (i = 0; ; ++i)
12015 {
12016 id = syn_get_stack_item(i);
12017 if (id < 0)
12018 break;
12019 if (list_append_number(rettv->vval.v_list, id) == FAIL)
12020 break;
12021 }
12022 }
12023#endif
12024}
12025
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012026/*
12027 * "tabpagebuflist()" function
12028 */
12029 static void
12030f_tabpagebuflist(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
12031{
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012032 tabpage_T *tp;
12033 win_T *wp = NULL;
12034
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012035 if (in_vim9script() && check_for_opt_number_arg(argvars, 0) == FAIL)
12036 return;
12037
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012038 if (argvars[0].v_type == VAR_UNKNOWN)
12039 wp = firstwin;
12040 else
12041 {
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012042 tp = find_tabpage((int)tv_get_number(&argvars[0]));
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012043 if (tp != NULL)
12044 wp = (tp == curtab) ? firstwin : tp->tp_firstwin;
12045 }
Bram Moolenaar93a10962022-06-16 11:42:09 +010012046 if (wp != NULL && rettv_list_alloc(rettv) == OK)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012047 {
12048 for (; wp != NULL; wp = wp->w_next)
12049 if (list_append_number(rettv->vval.v_list,
12050 wp->w_buffer->b_fnum) == FAIL)
12051 break;
12052 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012053}
12054
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012055/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012056 * "tagfiles()" function
12057 */
12058 static void
12059f_tagfiles(typval_T *argvars UNUSED, typval_T *rettv)
12060{
12061 char_u *fname;
12062 tagname_T tn;
12063 int first;
12064
12065 if (rettv_list_alloc(rettv) == FAIL)
12066 return;
12067 fname = alloc(MAXPATHL);
12068 if (fname == NULL)
12069 return;
12070
12071 for (first = TRUE; ; first = FALSE)
12072 if (get_tagfname(&tn, first, fname) == FAIL
12073 || list_append_string(rettv->vval.v_list, fname, -1) == FAIL)
12074 break;
12075 tagname_free(&tn);
12076 vim_free(fname);
12077}
12078
12079/*
12080 * "taglist()" function
12081 */
12082 static void
12083f_taglist(typval_T *argvars, typval_T *rettv)
12084{
Bram Moolenaarc6aafba2017-03-21 17:09:10 +010012085 char_u *fname = NULL;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012086 char_u *tag_pattern;
12087
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012088 if (in_vim9script()
12089 && (check_for_string_arg(argvars, 0) == FAIL
12090 || check_for_opt_string_arg(argvars, 1) == FAIL))
12091 return;
12092
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012093 tag_pattern = tv_get_string(&argvars[0]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012094
12095 rettv->vval.v_number = FALSE;
12096 if (*tag_pattern == NUL)
12097 return;
12098
Bram Moolenaarc6aafba2017-03-21 17:09:10 +010012099 if (argvars[1].v_type != VAR_UNKNOWN)
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012100 fname = tv_get_string(&argvars[1]);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012101 if (rettv_list_alloc(rettv) == OK)
Bram Moolenaarc6aafba2017-03-21 17:09:10 +010012102 (void)get_tags(rettv->vval.v_list, tag_pattern, fname);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012103}
12104
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012105/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012106 * "type(expr)" function
12107 */
12108 static void
12109f_type(typval_T *argvars, typval_T *rettv)
12110{
12111 int n = -1;
12112
12113 switch (argvars[0].v_type)
12114 {
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +010012115 case VAR_NUMBER: n = VAR_TYPE_NUMBER; break;
12116 case VAR_STRING: n = VAR_TYPE_STRING; break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012117 case VAR_PARTIAL:
Bram Moolenaar9b4a15d2020-01-11 16:05:23 +010012118 case VAR_FUNC: n = VAR_TYPE_FUNC; break;
12119 case VAR_LIST: n = VAR_TYPE_LIST; break;
12120 case VAR_DICT: n = VAR_TYPE_DICT; break;
12121 case VAR_FLOAT: n = VAR_TYPE_FLOAT; break;
12122 case VAR_BOOL: n = VAR_TYPE_BOOL; break;
12123 case VAR_SPECIAL: n = VAR_TYPE_NONE; break;
Bram Moolenaarf562e722016-07-19 17:25:25 +020012124 case VAR_JOB: n = VAR_TYPE_JOB; break;
12125 case VAR_CHANNEL: n = VAR_TYPE_CHANNEL; break;
Bram Moolenaar6e5ea8d2019-01-12 22:47:31 +010012126 case VAR_BLOB: n = VAR_TYPE_BLOB; break;
Bram Moolenaarf18332f2021-05-07 17:55:55 +020012127 case VAR_INSTR: n = VAR_TYPE_INSTR; break;
Yegappan Lakshmananec3cebb2023-10-27 19:35:26 +020012128 case VAR_TYPEALIAS: n = VAR_TYPE_TYPEALIAS; break;
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012129 case VAR_CLASS:
12130 {
12131 class_T *cl = argvars[0].vval.v_class;
Yegappan Lakshmananda9d3452024-05-02 13:02:36 +020012132 if (cl != NULL && IS_ENUM(cl))
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012133 n = VAR_TYPE_ENUM;
12134 else
12135 n = VAR_TYPE_CLASS;
12136 break;
12137 }
12138 case VAR_OBJECT:
12139 {
Yegappan Lakshmananb2e42b92024-05-01 11:44:17 +020012140 object_T *obj = argvars[0].vval.v_object;
12141
12142 if (obj == NULL)
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012143 n = VAR_TYPE_OBJECT;
Yegappan Lakshmananb2e42b92024-05-01 11:44:17 +020012144 else
12145 {
12146 class_T *cl = argvars[0].vval.v_object->obj_class;
12147 if (IS_ENUM(cl))
12148 n = VAR_TYPE_ENUMVALUE;
12149 else
12150 n = VAR_TYPE_OBJECT;
12151 }
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012152 break;
12153 }
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012154 case VAR_UNKNOWN:
Bram Moolenaar4c683752020-04-05 21:38:23 +020012155 case VAR_ANY:
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010012156 case VAR_VOID:
Yegappan Lakshmanan3164cf82024-03-28 10:36:42 +010012157 internal_error_no_abort("f_type(UNKNOWN)");
12158 n = -1;
12159 break;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012160 }
12161 rettv->vval.v_number = n;
12162}
12163
12164/*
zeertzjq825cf812023-08-17 22:55:25 +020012165 * "virtcol({expr}, [, {list} [, {winid}]])" function
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012166 */
12167 static void
12168f_virtcol(typval_T *argvars, typval_T *rettv)
12169{
LemonBoy0f7a3e12022-05-26 12:10:37 +010012170 colnr_T vcol_start = 0;
12171 colnr_T vcol_end = 0;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012172 pos_T *fp;
zeertzjq825cf812023-08-17 22:55:25 +020012173 switchwin_T switchwin;
12174 int winchanged = FALSE;
Bram Moolenaarb3d33d82020-01-15 20:36:55 +010012175 int len;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012176
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012177 if (in_vim9script()
LemonBoy0f7a3e12022-05-26 12:10:37 +010012178 && (check_for_string_or_list_arg(argvars, 0) == FAIL
12179 || (argvars[1].v_type != VAR_UNKNOWN
zeertzjq825cf812023-08-17 22:55:25 +020012180 && (check_for_bool_arg(argvars, 1) == FAIL
12181 || check_for_opt_number_arg(argvars, 2) == FAIL))))
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012182 return;
12183
zeertzjq825cf812023-08-17 22:55:25 +020012184 if (argvars[1].v_type != VAR_UNKNOWN && argvars[2].v_type != VAR_UNKNOWN)
12185 {
12186 tabpage_T *tp;
12187 win_T *wp;
12188
12189 // use the window specified in the third argument
12190 wp = win_id2wp_tp((int)tv_get_number(&argvars[2]), &tp);
12191 if (wp == NULL || tp == NULL)
12192 goto theend;
12193
12194 if (switch_win_noblock(&switchwin, wp, tp, TRUE) != OK)
12195 goto theend;
12196
12197 check_cursor();
12198 winchanged = TRUE;
12199 }
12200
12201 int fnum = curbuf->b_fnum;
Bram Moolenaar6f02b002021-01-10 20:22:54 +010012202 fp = var2fpos(&argvars[0], FALSE, &fnum, FALSE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012203 if (fp != NULL && fp->lnum <= curbuf->b_ml.ml_line_count
LemonBoy0f7a3e12022-05-26 12:10:37 +010012204 && fnum == curbuf->b_fnum)
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012205 {
Bram Moolenaarb3d33d82020-01-15 20:36:55 +010012206 // Limit the column to a valid value, getvvcol() doesn't check.
12207 if (fp->col < 0)
12208 fp->col = 0;
12209 else
12210 {
John Marriottbfcc8952024-03-11 22:04:45 +010012211 len = (int)ml_get_len(fp->lnum);
Bram Moolenaarb3d33d82020-01-15 20:36:55 +010012212 if (fp->col > len)
12213 fp->col = len;
12214 }
LemonBoy0f7a3e12022-05-26 12:10:37 +010012215 getvvcol(curwin, fp, &vcol_start, NULL, &vcol_end);
12216 ++vcol_start;
12217 ++vcol_end;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012218 }
12219
zeertzjq825cf812023-08-17 22:55:25 +020012220theend:
LemonBoy0f7a3e12022-05-26 12:10:37 +010012221 if (argvars[1].v_type != VAR_UNKNOWN && tv_get_bool(&argvars[1]))
12222 {
12223 if (rettv_list_alloc(rettv) == OK)
12224 {
12225 list_append_number(rettv->vval.v_list, vcol_start);
12226 list_append_number(rettv->vval.v_list, vcol_end);
12227 }
12228 else
12229 rettv->vval.v_number = 0;
12230 }
12231 else
12232 rettv->vval.v_number = vcol_end;
zeertzjq825cf812023-08-17 22:55:25 +020012233
12234 if (winchanged)
12235 restore_win_noblock(&switchwin, TRUE);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012236}
12237
12238/*
12239 * "visualmode()" function
12240 */
12241 static void
12242f_visualmode(typval_T *argvars, typval_T *rettv)
12243{
12244 char_u str[2];
12245
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012246 if (in_vim9script() && check_for_opt_bool_arg(argvars, 0) == FAIL)
12247 return;
12248
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012249 rettv->v_type = VAR_STRING;
12250 str[0] = curbuf->b_visual_mode_eval;
12251 str[1] = NUL;
12252 rettv->vval.v_string = vim_strsave(str);
12253
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012254 // A non-zero number or non-empty string argument: reset mode.
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012255 if (non_zero_arg(&argvars[0]))
12256 curbuf->b_visual_mode_eval = NUL;
12257}
12258
12259/*
12260 * "wildmenumode()" function
12261 */
12262 static void
12263f_wildmenumode(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
12264{
Bram Moolenaar24959102022-05-07 20:01:16 +010012265 if (wild_menu_showing || ((State & MODE_CMDLINE) && cmdline_pum_active()))
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012266 rettv->vval.v_number = 1;
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012267}
12268
12269/*
Bram Moolenaar0c1e3742019-12-27 13:49:24 +010012270 * "windowsversion()" function
12271 */
12272 static void
12273f_windowsversion(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
12274{
12275 rettv->v_type = VAR_STRING;
12276 rettv->vval.v_string = vim_strsave((char_u *)windowsVersion);
12277}
12278
12279/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012280 * "wordcount()" function
12281 */
12282 static void
12283f_wordcount(typval_T *argvars UNUSED, typval_T *rettv)
12284{
12285 if (rettv_dict_alloc(rettv) == FAIL)
12286 return;
12287 cursor_pos_info(rettv->vval.v_dict);
12288}
12289
12290/*
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012291 * "xor(expr, expr)" function
12292 */
12293 static void
12294f_xor(typval_T *argvars, typval_T *rettv)
12295{
Yegappan Lakshmanan4490ec42021-07-27 22:00:44 +020012296 if (in_vim9script()
12297 && (check_for_number_arg(argvars, 0) == FAIL
12298 || check_for_number_arg(argvars, 1) == FAIL))
12299 return;
12300
Bram Moolenaard155d7a2018-12-21 16:04:21 +010012301 rettv->vval.v_number = tv_get_number_chk(&argvars[0], NULL)
12302 ^ tv_get_number_chk(&argvars[1], NULL);
Bram Moolenaar73dad1e2016-07-17 22:13:49 +020012303}
12304
Bram Moolenaar5d18efe2019-12-01 21:11:22 +010012305#endif // FEAT_EVAL