blob: 3edbf891efd7476e999a47a162fb260361f991b2 [file] [log] [blame]
Bram Moolenaaredf3f972016-08-29 22:49:24 +02001/* vi:set ts=8 sts=4 sw=4 noet:
Bram Moolenaara9b579f2016-07-17 18:29:19 +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/*
Bram Moolenaar14c01f82019-10-09 22:53:08 +020011 * userfunc.c: User defined function support
Bram Moolenaara9b579f2016-07-17 18:29:19 +020012 */
13
14#include "vim.h"
15
16#if defined(FEAT_EVAL) || defined(PROTO)
Bram Moolenaara9b579f2016-07-17 18:29:19 +020017/*
18 * All user-defined functions are found in this hashtable.
19 */
20static hashtab_T func_hashtab;
21
Bram Moolenaare38eab22019-12-05 21:50:01 +010022// Used by get_func_tv()
Bram Moolenaara9b579f2016-07-17 18:29:19 +020023static garray_T funcargs = GA_EMPTY;
24
Bram Moolenaar209b8e32019-03-14 13:43:24 +010025// pointer to funccal for currently active function
26static funccall_T *current_funccal = NULL;
Bram Moolenaara9b579f2016-07-17 18:29:19 +020027
Bram Moolenaar209b8e32019-03-14 13:43:24 +010028// Pointer to list of previously used funccal, still around because some
29// item in it is still being used.
30static funccall_T *previous_funccal = NULL;
Bram Moolenaara9b579f2016-07-17 18:29:19 +020031
32static char *e_funcexts = N_("E122: Function %s already exists, add ! to replace it");
33static char *e_funcdict = N_("E717: Dictionary entry already exists");
34static char *e_funcref = N_("E718: Funcref required");
35static char *e_nofunc = N_("E130: Unknown function: %s");
36
Bram Moolenaarbc7ce672016-08-01 22:49:22 +020037static void funccal_unref(funccall_T *fc, ufunc_T *fp, int force);
Bram Moolenaar79efa2e2021-03-27 15:40:11 +010038static void func_clear(ufunc_T *fp, int force);
39static int func_free(ufunc_T *fp, int force);
Bram Moolenaara9b579f2016-07-17 18:29:19 +020040
41 void
42func_init()
43{
44 hash_init(&func_hashtab);
45}
46
Bram Moolenaar4f0383b2016-07-19 22:43:11 +020047/*
Bram Moolenaar660a10a2019-07-14 15:48:38 +020048 * Return the function hash table
49 */
50 hashtab_T *
51func_tbl_get(void)
52{
53 return &func_hashtab;
54}
55
56/*
Bram Moolenaar6e949782020-04-13 17:21:00 +020057 * Get one function argument.
Bram Moolenaar51e7e782021-04-10 17:46:52 +020058 * If "argtypes" is not NULL also get the type: "arg: type" (:def function).
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +010059 * If "types_optional" is TRUE a missing type is OK, use "any".
Bram Moolenaar057e84a2021-02-28 16:55:11 +010060 * If "evalarg" is not NULL use it to check for an already declared name.
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010061 * Return a pointer to after the type.
62 * When something is wrong return "arg".
63 */
64 static char_u *
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +010065one_function_arg(
66 char_u *arg,
67 garray_T *newargs,
68 garray_T *argtypes,
69 int types_optional,
Bram Moolenaar057e84a2021-02-28 16:55:11 +010070 evalarg_T *evalarg,
Bram Moolenaar2a389082021-04-09 20:24:31 +020071 int is_vararg,
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +010072 int skip)
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010073{
Bram Moolenaar6e949782020-04-13 17:21:00 +020074 char_u *p = arg;
75 char_u *arg_copy = NULL;
Bram Moolenaar51e7e782021-04-10 17:46:52 +020076 int is_underscore = FALSE;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010077
78 while (ASCII_ISALNUM(*p) || *p == '_')
79 ++p;
80 if (arg == p || isdigit(*arg)
Bram Moolenaarb816dae2020-09-20 22:04:00 +020081 || (argtypes == NULL
82 && ((p - arg == 9 && STRNCMP(arg, "firstline", 9) == 0)
83 || (p - arg == 8 && STRNCMP(arg, "lastline", 8) == 0))))
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010084 {
85 if (!skip)
86 semsg(_("E125: Illegal argument: %s"), arg);
87 return arg;
88 }
Bram Moolenaarb4893b82021-02-21 22:20:24 +010089
Bram Moolenaar057e84a2021-02-28 16:55:11 +010090 // Vim9 script: cannot use script var name for argument. In function: also
91 // check local vars and arguments.
92 if (!skip && argtypes != NULL && check_defined(arg, p - arg,
93 evalarg == NULL ? NULL : evalarg->eval_cctx, TRUE) == FAIL)
Bram Moolenaarb4893b82021-02-21 22:20:24 +010094 return arg;
Bram Moolenaarb4893b82021-02-21 22:20:24 +010095
Bram Moolenaar8a7d6542020-01-26 15:56:19 +010096 if (newargs != NULL && ga_grow(newargs, 1) == FAIL)
97 return arg;
98 if (newargs != NULL)
99 {
Bram Moolenaar8a7d6542020-01-26 15:56:19 +0100100 int c;
101 int i;
102
103 c = *p;
104 *p = NUL;
105 arg_copy = vim_strsave(arg);
106 if (arg_copy == NULL)
107 {
108 *p = c;
109 return arg;
110 }
Bram Moolenaar51e7e782021-04-10 17:46:52 +0200111 is_underscore = arg_copy[0] == '_' && arg_copy[1] == NUL;
Bram Moolenaar87795932021-04-10 18:21:30 +0200112 if (argtypes == NULL || !is_underscore)
Bram Moolenaar51e7e782021-04-10 17:46:52 +0200113 // Check for duplicate argument name.
114 for (i = 0; i < newargs->ga_len; ++i)
115 if (STRCMP(((char_u **)(newargs->ga_data))[i], arg_copy) == 0)
116 {
117 semsg(_("E853: Duplicate argument name: %s"), arg_copy);
118 vim_free(arg_copy);
119 return arg;
120 }
Bram Moolenaar8a7d6542020-01-26 15:56:19 +0100121 ((char_u **)(newargs->ga_data))[newargs->ga_len] = arg_copy;
122 newargs->ga_len++;
123
124 *p = c;
125 }
126
127 // get any type from "arg: type"
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +0100128 if (argtypes != NULL && (skip || ga_grow(argtypes, 1) == OK))
Bram Moolenaar8a7d6542020-01-26 15:56:19 +0100129 {
130 char_u *type = NULL;
131
Bram Moolenaar6e949782020-04-13 17:21:00 +0200132 if (VIM_ISWHITE(*p) && *skipwhite(p) == ':')
133 {
Bram Moolenaar451c2e32020-08-15 16:33:28 +0200134 semsg(_(e_no_white_space_allowed_before_colon_str),
Bram Moolenaar6e949782020-04-13 17:21:00 +0200135 arg_copy == NULL ? arg : arg_copy);
136 p = skipwhite(p);
137 }
Bram Moolenaar8a7d6542020-01-26 15:56:19 +0100138 if (*p == ':')
139 {
Bram Moolenaarf93c7fe2020-04-23 22:16:53 +0200140 ++p;
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +0100141 if (!skip && !VIM_ISWHITE(*p))
Bram Moolenaarf93c7fe2020-04-23 22:16:53 +0200142 {
Bram Moolenaarc3fc75d2021-02-07 15:28:09 +0100143 semsg(_(e_white_space_required_after_str_str), ":", p - 1);
Bram Moolenaarf93c7fe2020-04-23 22:16:53 +0200144 return arg;
145 }
146 type = skipwhite(p);
Bram Moolenaar4fc224c2020-07-26 17:56:25 +0200147 p = skip_type(type, TRUE);
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +0100148 if (!skip)
149 type = vim_strnsave(type, p - type);
Bram Moolenaar8a7d6542020-01-26 15:56:19 +0100150 }
Bram Moolenaar51e7e782021-04-10 17:46:52 +0200151 else if (*skipwhite(p) != '=' && !types_optional && !is_underscore)
Bram Moolenaar6e949782020-04-13 17:21:00 +0200152 {
Bram Moolenaar451c2e32020-08-15 16:33:28 +0200153 semsg(_(e_missing_argument_type_for_str),
Bram Moolenaar6e949782020-04-13 17:21:00 +0200154 arg_copy == NULL ? arg : arg_copy);
155 return arg;
156 }
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +0100157 if (!skip)
158 {
159 if (type == NULL && types_optional)
160 // lambda arguments default to "any" type
Bram Moolenaar2a389082021-04-09 20:24:31 +0200161 type = vim_strsave((char_u *)
162 (is_vararg ? "list<any>" : "any"));
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +0100163 ((char_u **)argtypes->ga_data)[argtypes->ga_len++] = type;
164 }
Bram Moolenaar8a7d6542020-01-26 15:56:19 +0100165 }
166
167 return p;
168}
169
170/*
Bram Moolenaar4f0383b2016-07-19 22:43:11 +0200171 * Get function arguments.
Bram Moolenaarcef12702021-01-04 14:09:43 +0100172 * "argp" should point to just after the "(", possibly to white space.
Bram Moolenaar65c44152020-12-24 15:14:01 +0100173 * "argp" is advanced just after "endchar".
Bram Moolenaar4f0383b2016-07-19 22:43:11 +0200174 */
Bram Moolenaarcef12702021-01-04 14:09:43 +0100175 static int
Bram Moolenaara9b579f2016-07-17 18:29:19 +0200176get_function_args(
177 char_u **argp,
178 char_u endchar,
179 garray_T *newargs,
Bram Moolenaar8a7d6542020-01-26 15:56:19 +0100180 garray_T *argtypes, // NULL unless using :def
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +0100181 int types_optional, // types optional if "argtypes" is not NULL
Bram Moolenaar057e84a2021-02-28 16:55:11 +0100182 evalarg_T *evalarg, // context or NULL
Bram Moolenaara9b579f2016-07-17 18:29:19 +0200183 int *varargs,
Bram Moolenaar42ae78c2019-05-09 21:08:58 +0200184 garray_T *default_args,
Bram Moolenaar5e774c72020-04-12 21:53:00 +0200185 int skip,
186 exarg_T *eap,
187 char_u **line_to_free)
Bram Moolenaara9b579f2016-07-17 18:29:19 +0200188{
189 int mustend = FALSE;
Bram Moolenaarcef12702021-01-04 14:09:43 +0100190 char_u *arg;
191 char_u *p;
Bram Moolenaara9b579f2016-07-17 18:29:19 +0200192 int c;
Bram Moolenaar42ae78c2019-05-09 21:08:58 +0200193 int any_default = FALSE;
194 char_u *expr;
Bram Moolenaarcef12702021-01-04 14:09:43 +0100195 char_u *whitep = *argp;
Bram Moolenaara9b579f2016-07-17 18:29:19 +0200196
197 if (newargs != NULL)
198 ga_init2(newargs, (int)sizeof(char_u *), 3);
Bram Moolenaar8a7d6542020-01-26 15:56:19 +0100199 if (argtypes != NULL)
200 ga_init2(argtypes, (int)sizeof(char_u *), 3);
Bram Moolenaare3ffaa62021-06-26 22:17:35 +0200201 if (!skip && default_args != NULL)
Bram Moolenaar42ae78c2019-05-09 21:08:58 +0200202 ga_init2(default_args, (int)sizeof(char_u *), 3);
Bram Moolenaara9b579f2016-07-17 18:29:19 +0200203
204 if (varargs != NULL)
205 *varargs = FALSE;
206
207 /*
208 * Isolate the arguments: "arg1, arg2, ...)"
209 */
Bram Moolenaarcef12702021-01-04 14:09:43 +0100210 arg = skipwhite(*argp);
211 p = arg;
Bram Moolenaara9b579f2016-07-17 18:29:19 +0200212 while (*p != endchar)
213 {
Bram Moolenaar2c330432020-04-13 14:41:35 +0200214 while (eap != NULL && eap->getline != NULL
215 && (*p == NUL || (VIM_ISWHITE(*whitep) && *p == '#')))
Bram Moolenaar5e774c72020-04-12 21:53:00 +0200216 {
217 char_u *theline;
218
219 // End of the line, get the next one.
220 theline = eap->getline(':', eap->cookie, 0, TRUE);
221 if (theline == NULL)
222 break;
223 vim_free(*line_to_free);
224 *line_to_free = theline;
Bram Moolenaar2c330432020-04-13 14:41:35 +0200225 whitep = (char_u *)" ";
Bram Moolenaar5e774c72020-04-12 21:53:00 +0200226 p = skipwhite(theline);
227 }
228
229 if (mustend && *p != endchar)
230 {
231 if (!skip)
232 semsg(_(e_invarg2), *argp);
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +0100233 goto err_ret;
Bram Moolenaar5e774c72020-04-12 21:53:00 +0200234 }
235 if (*p == endchar)
236 break;
237
Bram Moolenaara9b579f2016-07-17 18:29:19 +0200238 if (p[0] == '.' && p[1] == '.' && p[2] == '.')
239 {
240 if (varargs != NULL)
241 *varargs = TRUE;
242 p += 3;
243 mustend = TRUE;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +0100244
245 if (argtypes != NULL)
246 {
247 // ...name: list<type>
Bram Moolenaar28022722020-09-21 22:02:49 +0200248 if (!eval_isnamec1(*p))
Bram Moolenaar8a7d6542020-01-26 15:56:19 +0100249 {
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +0100250 if (!skip)
251 emsg(_(e_missing_name_after_dots));
252 goto err_ret;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +0100253 }
254
255 arg = p;
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +0100256 p = one_function_arg(p, newargs, argtypes, types_optional,
Bram Moolenaar2a389082021-04-09 20:24:31 +0200257 evalarg, TRUE, skip);
Bram Moolenaar8a7d6542020-01-26 15:56:19 +0100258 if (p == arg)
259 break;
Bram Moolenaar4f53b792021-02-07 15:59:49 +0100260 if (*skipwhite(p) == '=')
261 {
262 emsg(_(e_cannot_use_default_for_variable_arguments));
263 break;
264 }
Bram Moolenaar8a7d6542020-01-26 15:56:19 +0100265 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +0200266 }
267 else
268 {
Bram Moolenaar015cf102021-06-26 21:52:02 +0200269 char_u *np;
270
Bram Moolenaara9b579f2016-07-17 18:29:19 +0200271 arg = p;
Bram Moolenaar057e84a2021-02-28 16:55:11 +0100272 p = one_function_arg(p, newargs, argtypes, types_optional,
Bram Moolenaar2a389082021-04-09 20:24:31 +0200273 evalarg, FALSE, skip);
Bram Moolenaar8a7d6542020-01-26 15:56:19 +0100274 if (p == arg)
Bram Moolenaara9b579f2016-07-17 18:29:19 +0200275 break;
Bram Moolenaara9b579f2016-07-17 18:29:19 +0200276
Bram Moolenaar015cf102021-06-26 21:52:02 +0200277 // Recognize " = expr" but not " == expr". A lambda can have
Bram Moolenaar98f9a5f2021-06-26 22:22:38 +0200278 // "(a = expr" but "(a == expr" and "(a =~ expr" are not a lambda.
Bram Moolenaar015cf102021-06-26 21:52:02 +0200279 np = skipwhite(p);
Bram Moolenaar98f9a5f2021-06-26 22:22:38 +0200280 if (*np == '=' && np[1] != '=' && np[1] != '~'
281 && default_args != NULL)
Bram Moolenaar42ae78c2019-05-09 21:08:58 +0200282 {
283 typval_T rettv;
284
Bram Moolenaar170fcfc2020-02-06 17:51:35 +0100285 // find the end of the expression (doesn't evaluate it)
Bram Moolenaar42ae78c2019-05-09 21:08:58 +0200286 any_default = TRUE;
287 p = skipwhite(p) + 1;
Bram Moolenaar2c330432020-04-13 14:41:35 +0200288 whitep = p;
Bram Moolenaar42ae78c2019-05-09 21:08:58 +0200289 p = skipwhite(p);
290 expr = p;
Bram Moolenaar5409f5d2020-06-24 18:37:35 +0200291 if (eval1(&p, &rettv, NULL) != FAIL)
Bram Moolenaar42ae78c2019-05-09 21:08:58 +0200292 {
Bram Moolenaare3ffaa62021-06-26 22:17:35 +0200293 if (!skip)
Bram Moolenaar42ae78c2019-05-09 21:08:58 +0200294 {
Bram Moolenaare3ffaa62021-06-26 22:17:35 +0200295 if (ga_grow(default_args, 1) == FAIL)
296 goto err_ret;
297
298 // trim trailing whitespace
299 while (p > expr && VIM_ISWHITE(p[-1]))
300 p--;
301 c = *p;
302 *p = NUL;
303 expr = vim_strsave(expr);
304 if (expr == NULL)
305 {
306 *p = c;
307 goto err_ret;
308 }
309 ((char_u **)(default_args->ga_data))
Bram Moolenaar42ae78c2019-05-09 21:08:58 +0200310 [default_args->ga_len] = expr;
Bram Moolenaare3ffaa62021-06-26 22:17:35 +0200311 default_args->ga_len++;
312 *p = c;
313 }
Bram Moolenaar42ae78c2019-05-09 21:08:58 +0200314 }
315 else
316 mustend = TRUE;
317 }
318 else if (any_default)
319 {
320 emsg(_("E989: Non-default argument follows default argument"));
Bram Moolenaar914e7ea2020-07-11 15:20:48 +0200321 goto err_ret;
Bram Moolenaar42ae78c2019-05-09 21:08:58 +0200322 }
Bram Moolenaar86cdb8a2021-04-06 19:01:03 +0200323
324 if (VIM_ISWHITE(*p) && *skipwhite(p) == ',')
325 {
326 // Be tolerant when skipping
327 if (!skip)
328 {
329 semsg(_(e_no_white_space_allowed_before_str_str), ",", p);
330 goto err_ret;
331 }
332 p = skipwhite(p);
333 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +0200334 if (*p == ',')
Bram Moolenaar914e7ea2020-07-11 15:20:48 +0200335 {
Bram Moolenaara9b579f2016-07-17 18:29:19 +0200336 ++p;
Bram Moolenaar914e7ea2020-07-11 15:20:48 +0200337 // Don't give this error when skipping, it makes the "->" not
338 // found in "{k,v -> x}" and give a confusing error.
Bram Moolenaar608d78f2021-03-06 22:33:12 +0100339 // Allow missing space after comma in legacy functions.
340 if (!skip && argtypes != NULL
Bram Moolenaar914e7ea2020-07-11 15:20:48 +0200341 && !IS_WHITE_OR_NUL(*p) && *p != endchar)
342 {
Bram Moolenaarc3fc75d2021-02-07 15:28:09 +0100343 semsg(_(e_white_space_required_after_str_str), ",", p - 1);
Bram Moolenaar914e7ea2020-07-11 15:20:48 +0200344 goto err_ret;
345 }
346 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +0200347 else
348 mustend = TRUE;
349 }
Bram Moolenaar2c330432020-04-13 14:41:35 +0200350 whitep = p;
Bram Moolenaara9b579f2016-07-17 18:29:19 +0200351 p = skipwhite(p);
Bram Moolenaara9b579f2016-07-17 18:29:19 +0200352 }
Bram Moolenaar5e774c72020-04-12 21:53:00 +0200353
Bram Moolenaar4f0383b2016-07-19 22:43:11 +0200354 if (*p != endchar)
355 goto err_ret;
Bram Moolenaare38eab22019-12-05 21:50:01 +0100356 ++p; // skip "endchar"
Bram Moolenaara9b579f2016-07-17 18:29:19 +0200357
358 *argp = p;
359 return OK;
360
361err_ret:
362 if (newargs != NULL)
363 ga_clear_strings(newargs);
Bram Moolenaare3ffaa62021-06-26 22:17:35 +0200364 if (!skip && default_args != NULL)
Bram Moolenaar42ae78c2019-05-09 21:08:58 +0200365 ga_clear_strings(default_args);
Bram Moolenaara9b579f2016-07-17 18:29:19 +0200366 return FAIL;
367}
368
369/*
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +0100370 * Parse the argument types, filling "fp->uf_arg_types".
371 * Return OK or FAIL.
372 */
373 static int
374parse_argument_types(ufunc_T *fp, garray_T *argtypes, int varargs)
375{
Bram Moolenaar2a389082021-04-09 20:24:31 +0200376 int len = 0;
377
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +0100378 ga_init2(&fp->uf_type_list, sizeof(type_T *), 10);
379 if (argtypes->ga_len > 0)
380 {
381 // When "varargs" is set the last name/type goes into uf_va_name
382 // and uf_va_type.
Bram Moolenaar2a389082021-04-09 20:24:31 +0200383 len = argtypes->ga_len - (varargs ? 1 : 0);
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +0100384
385 if (len > 0)
386 fp->uf_arg_types = ALLOC_CLEAR_MULT(type_T *, len);
387 if (fp->uf_arg_types != NULL)
388 {
389 int i;
390 type_T *type;
391
392 for (i = 0; i < len; ++ i)
393 {
394 char_u *p = ((char_u **)argtypes->ga_data)[i];
395
396 if (p == NULL)
397 // will get the type from the default value
398 type = &t_unknown;
399 else
Bram Moolenaar9e68c322020-12-25 12:38:04 +0100400 type = parse_type(&p, &fp->uf_type_list, TRUE);
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +0100401 if (type == NULL)
402 return FAIL;
403 fp->uf_arg_types[i] = type;
404 }
405 }
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +0100406 }
Bram Moolenaar2a389082021-04-09 20:24:31 +0200407
408 if (varargs)
409 {
410 char_u *p;
411
412 // Move the last argument "...name: type" to uf_va_name and
413 // uf_va_type.
414 fp->uf_va_name = ((char_u **)fp->uf_args.ga_data)
415 [fp->uf_args.ga_len - 1];
416 --fp->uf_args.ga_len;
417 p = ((char_u **)argtypes->ga_data)[len];
418 if (p == NULL)
419 // TODO: get type from default value
420 fp->uf_va_type = &t_list_any;
421 else
422 {
423 fp->uf_va_type = parse_type(&p, &fp->uf_type_list, TRUE);
424 if (fp->uf_va_type != NULL && fp->uf_va_type->tt_type != VAR_LIST)
425 {
426 semsg(_(e_variable_arguments_type_must_be_list_str),
427 ((char_u **)argtypes->ga_data)[len]);
428 return FAIL;
429 }
430 }
431 if (fp->uf_va_type == NULL)
432 return FAIL;
433 }
434
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +0100435 return OK;
436}
437
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +0100438 static int
439parse_return_type(ufunc_T *fp, char_u *ret_type)
440{
441 if (ret_type == NULL)
442 fp->uf_ret_type = &t_void;
443 else
444 {
445 char_u *p = ret_type;
446
447 fp->uf_ret_type = parse_type(&p, &fp->uf_type_list, TRUE);
448 if (fp->uf_ret_type == NULL)
449 {
450 fp->uf_ret_type = &t_void;
451 return FAIL;
452 }
453 }
454 return OK;
455}
456
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +0100457/*
Bram Moolenaar58016442016-07-31 18:30:22 +0200458 * Register function "fp" as using "current_funccal" as its scope.
459 */
460 static int
461register_closure(ufunc_T *fp)
462{
Bram Moolenaar8dd3a432016-08-01 20:46:25 +0200463 if (fp->uf_scoped == current_funccal)
Bram Moolenaare38eab22019-12-05 21:50:01 +0100464 // no change
Bram Moolenaar8dd3a432016-08-01 20:46:25 +0200465 return OK;
Bram Moolenaarbc7ce672016-08-01 22:49:22 +0200466 funccal_unref(fp->uf_scoped, fp, FALSE);
Bram Moolenaar58016442016-07-31 18:30:22 +0200467 fp->uf_scoped = current_funccal;
468 current_funccal->fc_refcount++;
Bram Moolenaar8dd3a432016-08-01 20:46:25 +0200469
Bram Moolenaar58016442016-07-31 18:30:22 +0200470 if (ga_grow(&current_funccal->fc_funcs, 1) == FAIL)
471 return FAIL;
472 ((ufunc_T **)current_funccal->fc_funcs.ga_data)
473 [current_funccal->fc_funcs.ga_len++] = fp;
Bram Moolenaar58016442016-07-31 18:30:22 +0200474 return OK;
475}
476
Bram Moolenaar1a47ae32019-12-29 23:04:25 +0100477 static void
478set_ufunc_name(ufunc_T *fp, char_u *name)
479{
Bram Moolenaar7b6903f2021-02-03 19:31:29 +0100480 // Add a type cast to avoid a warning for an overflow, the uf_name[] array
481 // actually extends beyond the struct.
482 STRCPY((void *)fp->uf_name, name);
Bram Moolenaar1a47ae32019-12-29 23:04:25 +0100483
484 if (name[0] == K_SPECIAL)
485 {
486 fp->uf_name_exp = alloc(STRLEN(name) + 3);
487 if (fp->uf_name_exp != NULL)
488 {
489 STRCPY(fp->uf_name_exp, "<SNR>");
490 STRCAT(fp->uf_name_exp, fp->uf_name + 3);
491 }
492 }
493}
494
Bram Moolenaar58016442016-07-31 18:30:22 +0200495/*
Bram Moolenaar04b12692020-05-04 23:24:44 +0200496 * Get a name for a lambda. Returned in static memory.
497 */
498 char_u *
499get_lambda_name(void)
500{
501 static char_u name[30];
502 static int lambda_no = 0;
503
504 sprintf((char*)name, "<lambda>%d", ++lambda_no);
505 return name;
506}
507
Bram Moolenaar801ab062020-06-25 19:27:56 +0200508#if defined(FEAT_LUA) || defined(PROTO)
509/*
510 * Registers a native C callback which can be called from Vim script.
511 * Returns the name of the Vim script function.
512 */
513 char_u *
514register_cfunc(cfunc_T cb, cfunc_free_T cb_free, void *state)
515{
516 char_u *name = get_lambda_name();
Bram Moolenaar7d2ac922020-06-29 20:20:33 +0200517 ufunc_T *fp;
Bram Moolenaar801ab062020-06-25 19:27:56 +0200518
519 fp = alloc_clear(offsetof(ufunc_T, uf_name) + STRLEN(name) + 1);
520 if (fp == NULL)
Bram Moolenaar7d2ac922020-06-29 20:20:33 +0200521 return NULL;
Bram Moolenaar801ab062020-06-25 19:27:56 +0200522
Bram Moolenaar38ddf332020-07-31 22:05:04 +0200523 fp->uf_def_status = UF_NOT_COMPILED;
Bram Moolenaar801ab062020-06-25 19:27:56 +0200524 fp->uf_refcount = 1;
525 fp->uf_varargs = TRUE;
Bram Moolenaar38453522021-11-28 22:00:12 +0000526 fp->uf_flags = FC_CFUNC | FC_LAMBDA;
Bram Moolenaar801ab062020-06-25 19:27:56 +0200527 fp->uf_calls = 0;
528 fp->uf_script_ctx = current_sctx;
Bram Moolenaar801ab062020-06-25 19:27:56 +0200529 fp->uf_cb = cb;
530 fp->uf_cb_free = cb_free;
531 fp->uf_cb_state = state;
532
533 set_ufunc_name(fp, name);
534 hash_add(&func_hashtab, UF2HIKEY(fp));
535
536 return name;
Bram Moolenaar801ab062020-06-25 19:27:56 +0200537}
538#endif
539
Bram Moolenaar04b12692020-05-04 23:24:44 +0200540/*
Bram Moolenaar65c44152020-12-24 15:14:01 +0100541 * Skip over "->" or "=>" after the arguments of a lambda.
Bram Moolenaar9e68c322020-12-25 12:38:04 +0100542 * If ": type" is found make "ret_type" point to "type".
Bram Moolenaarc754b4c2020-12-25 15:24:23 +0100543 * If "white_error" is not NULL check for correct use of white space and set
544 * "white_error" to TRUE if there is an error.
Bram Moolenaar65c44152020-12-24 15:14:01 +0100545 * Return NULL if no valid arrow found.
546 */
547 static char_u *
Bram Moolenaarc754b4c2020-12-25 15:24:23 +0100548skip_arrow(
549 char_u *start,
550 int equal_arrow,
551 char_u **ret_type,
552 int *white_error)
Bram Moolenaar65c44152020-12-24 15:14:01 +0100553{
Bram Moolenaarc754b4c2020-12-25 15:24:23 +0100554 char_u *s = start;
555 char_u *bef = start - 2; // "start" points to > of ->
Bram Moolenaar65c44152020-12-24 15:14:01 +0100556
557 if (equal_arrow)
558 {
559 if (*s == ':')
Bram Moolenaar9e68c322020-12-25 12:38:04 +0100560 {
Bram Moolenaarc754b4c2020-12-25 15:24:23 +0100561 if (white_error != NULL && !VIM_ISWHITE(s[1]))
562 {
563 *white_error = TRUE;
Bram Moolenaarc3fc75d2021-02-07 15:28:09 +0100564 semsg(_(e_white_space_required_after_str_str), ":", s);
Bram Moolenaarc754b4c2020-12-25 15:24:23 +0100565 return NULL;
566 }
Bram Moolenaar9e68c322020-12-25 12:38:04 +0100567 s = skipwhite(s + 1);
568 *ret_type = s;
569 s = skip_type(s, TRUE);
Bram Moolenaar0346b792021-01-31 22:18:29 +0100570 if (s == *ret_type)
571 {
572 emsg(_(e_missing_return_type));
573 return NULL;
574 }
Bram Moolenaar9e68c322020-12-25 12:38:04 +0100575 }
Bram Moolenaarc754b4c2020-12-25 15:24:23 +0100576 bef = s;
Bram Moolenaar65c44152020-12-24 15:14:01 +0100577 s = skipwhite(s);
578 if (*s != '=')
579 return NULL;
580 ++s;
581 }
582 if (*s != '>')
583 return NULL;
Bram Moolenaarc754b4c2020-12-25 15:24:23 +0100584 if (white_error != NULL && ((!VIM_ISWHITE(*bef) && *bef != '{')
585 || !IS_WHITE_OR_NUL(s[1])))
586 {
587 *white_error = TRUE;
Bram Moolenaare7a73e02021-01-01 19:17:55 +0100588 semsg(_(e_white_space_required_before_and_after_str_at_str),
589 equal_arrow ? "=>" : "->", bef);
Bram Moolenaarc754b4c2020-12-25 15:24:23 +0100590 return NULL;
591 }
Bram Moolenaar65c44152020-12-24 15:14:01 +0100592 return skipwhite(s + 1);
593}
594
595/*
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +0100596 * Check if "*cmd" points to a function command and if so advance "*cmd" and
597 * return TRUE.
598 * Otherwise return FALSE;
599 * Do not consider "function(" to be a command.
600 */
601 static int
602is_function_cmd(char_u **cmd)
603{
604 char_u *p = *cmd;
605
606 if (checkforcmd(&p, "function", 2))
607 {
608 if (*p == '(')
609 return FALSE;
610 *cmd = p;
611 return TRUE;
612 }
613 return FALSE;
614}
615
616/*
Bram Moolenaar2eb6fc32021-07-25 14:13:53 +0200617 * Called when defining a function: The context may be needed for script
618 * variables declared in a block that is visible now but not when the function
619 * is compiled or called later.
620 */
621 static void
622function_using_block_scopes(ufunc_T *fp, cstack_T *cstack)
623{
624 if (cstack != NULL && cstack->cs_idx >= 0)
625 {
626 int count = cstack->cs_idx + 1;
627 int i;
628
629 fp->uf_block_ids = ALLOC_MULT(int, count);
630 if (fp->uf_block_ids != NULL)
631 {
632 mch_memmove(fp->uf_block_ids, cstack->cs_block_id,
633 sizeof(int) * count);
634 fp->uf_block_depth = count;
635 }
636
637 // Set flag in each block to indicate a function was defined. This
638 // is used to keep the variable when leaving the block, see
639 // hide_script_var().
640 for (i = 0; i <= cstack->cs_idx; ++i)
641 cstack->cs_flags[i] |= CSF_FUNC_DEF;
642 }
643}
644
645/*
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +0100646 * Read the body of a function, put every line in "newlines".
Bram Moolenaar074f84c2021-05-18 11:47:44 +0200647 * This stops at "}", "endfunction" or "enddef".
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +0100648 * "newlines" must already have been initialized.
649 * "eap->cmdidx" is CMD_function, CMD_def or CMD_block;
650 */
651 static int
652get_function_body(
653 exarg_T *eap,
654 garray_T *newlines,
655 char_u *line_arg_in,
656 char_u **line_to_free)
657{
658 linenr_T sourcing_lnum_top = SOURCING_LNUM;
659 linenr_T sourcing_lnum_off;
660 int saved_wait_return = need_wait_return;
661 char_u *line_arg = line_arg_in;
662 int vim9_function = eap->cmdidx == CMD_def
663 || eap->cmdidx == CMD_block;
664#define MAX_FUNC_NESTING 50
665 char nesting_def[MAX_FUNC_NESTING];
Bram Moolenaar5245beb2021-07-15 22:03:50 +0200666 char nesting_inline[MAX_FUNC_NESTING];
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +0100667 int nesting = 0;
668 getline_opt_T getline_options;
669 int indent = 2;
670 char_u *skip_until = NULL;
671 int ret = FAIL;
672 int is_heredoc = FALSE;
Bram Moolenaar20677332021-06-06 17:02:53 +0200673 int heredoc_concat_len = 0;
674 garray_T heredoc_ga;
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +0100675 char_u *heredoc_trimmed = NULL;
676
Bram Moolenaar20677332021-06-06 17:02:53 +0200677 ga_init2(&heredoc_ga, 1, 500);
678
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +0100679 // Detect having skipped over comment lines to find the return
680 // type. Add NULL lines to keep the line count correct.
681 sourcing_lnum_off = get_sourced_lnum(eap->getline, eap->cookie);
682 if (SOURCING_LNUM < sourcing_lnum_off)
683 {
684 sourcing_lnum_off -= SOURCING_LNUM;
685 if (ga_grow(newlines, sourcing_lnum_off) == FAIL)
686 goto theend;
687 while (sourcing_lnum_off-- > 0)
688 ((char_u **)(newlines->ga_data))[newlines->ga_len++] = NULL;
689 }
690
Bram Moolenaar5245beb2021-07-15 22:03:50 +0200691 nesting_def[0] = vim9_function;
692 nesting_inline[0] = eap->cmdidx == CMD_block;
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +0100693 getline_options = vim9_function
694 ? GETLINE_CONCAT_CONTBAR : GETLINE_CONCAT_CONT;
695 for (;;)
696 {
697 char_u *theline;
698 char_u *p;
699 char_u *arg;
700
701 if (KeyTyped)
702 {
703 msg_scroll = TRUE;
704 saved_wait_return = FALSE;
705 }
706 need_wait_return = FALSE;
707
708 if (line_arg != NULL)
709 {
710 // Use eap->arg, split up in parts by line breaks.
711 theline = line_arg;
712 p = vim_strchr(theline, '\n');
713 if (p == NULL)
714 line_arg += STRLEN(line_arg);
715 else
716 {
717 *p = NUL;
718 line_arg = p + 1;
719 }
720 }
721 else
722 {
723 vim_free(*line_to_free);
724 if (eap->getline == NULL)
725 theline = getcmdline(':', 0L, indent, getline_options);
726 else
727 theline = eap->getline(':', eap->cookie, indent,
728 getline_options);
729 *line_to_free = theline;
730 }
731 if (KeyTyped)
732 lines_left = Rows - 1;
733 if (theline == NULL)
734 {
735 // Use the start of the function for the line number.
736 SOURCING_LNUM = sourcing_lnum_top;
737 if (skip_until != NULL)
738 semsg(_(e_missing_heredoc_end_marker_str), skip_until);
Bram Moolenaar5245beb2021-07-15 22:03:50 +0200739 else if (nesting_inline[nesting])
740 emsg(_(e_missing_end_block));
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +0100741 else if (eap->cmdidx == CMD_def)
742 emsg(_(e_missing_enddef));
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +0100743 else
744 emsg(_("E126: Missing :endfunction"));
745 goto theend;
746 }
747
748 // Detect line continuation: SOURCING_LNUM increased more than one.
749 sourcing_lnum_off = get_sourced_lnum(eap->getline, eap->cookie);
750 if (SOURCING_LNUM < sourcing_lnum_off)
751 sourcing_lnum_off -= SOURCING_LNUM;
752 else
753 sourcing_lnum_off = 0;
754
755 if (skip_until != NULL)
756 {
757 // Don't check for ":endfunc"/":enddef" between
758 // * ":append" and "."
759 // * ":python <<EOF" and "EOF"
760 // * ":let {var-name} =<< [trim] {marker}" and "{marker}"
761 if (heredoc_trimmed == NULL
762 || (is_heredoc && skipwhite(theline) == theline)
763 || STRNCMP(theline, heredoc_trimmed,
764 STRLEN(heredoc_trimmed)) == 0)
765 {
766 if (heredoc_trimmed == NULL)
767 p = theline;
768 else if (is_heredoc)
769 p = skipwhite(theline) == theline
770 ? theline : theline + STRLEN(heredoc_trimmed);
771 else
772 p = theline + STRLEN(heredoc_trimmed);
773 if (STRCMP(p, skip_until) == 0)
774 {
775 VIM_CLEAR(skip_until);
776 VIM_CLEAR(heredoc_trimmed);
777 getline_options = vim9_function
778 ? GETLINE_CONCAT_CONTBAR : GETLINE_CONCAT_CONT;
779 is_heredoc = FALSE;
Bram Moolenaar20677332021-06-06 17:02:53 +0200780
781 if (heredoc_concat_len > 0)
782 {
783 // Replace the starting line with all the concatenated
784 // lines.
785 ga_concat(&heredoc_ga, theline);
786 vim_free(((char_u **)(newlines->ga_data))[
787 heredoc_concat_len - 1]);
788 ((char_u **)(newlines->ga_data))[
789 heredoc_concat_len - 1] = heredoc_ga.ga_data;
790 ga_init(&heredoc_ga);
791 heredoc_concat_len = 0;
792 theline += STRLEN(theline); // skip the "EOF"
793 }
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +0100794 }
795 }
796 }
797 else
798 {
Bram Moolenaar5245beb2021-07-15 22:03:50 +0200799 int c;
800 char_u *end;
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +0100801
802 // skip ':' and blanks
803 for (p = theline; VIM_ISWHITE(*p) || *p == ':'; ++p)
804 ;
805
806 // Check for "endfunction", "enddef" or "}".
807 // When a ":" follows it must be a dict key; "enddef: value,"
Bram Moolenaar5245beb2021-07-15 22:03:50 +0200808 if (nesting_inline[nesting]
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +0100809 ? *p == '}'
810 : (checkforcmd(&p, nesting_def[nesting]
811 ? "enddef" : "endfunction", 4)
812 && *p != ':'))
813 {
814 if (nesting-- == 0)
815 {
816 char_u *nextcmd = NULL;
817
818 if (*p == '|' || *p == '}')
819 nextcmd = p + 1;
820 else if (line_arg != NULL && *skipwhite(line_arg) != NUL)
821 nextcmd = line_arg;
822 else if (*p != NUL && *p != (vim9_function ? '#' : '"')
Bram Moolenaar49f1e9e2021-03-22 20:49:02 +0100823 && (vim9_function || p_verbose > 0))
824 {
Bram Moolenaar4bba16d2021-08-15 19:28:05 +0200825 SOURCING_LNUM = sourcing_lnum_top
826 + newlines->ga_len + 1;
Bram Moolenaar49f1e9e2021-03-22 20:49:02 +0100827 if (eap->cmdidx == CMD_def)
828 semsg(_(e_text_found_after_enddef_str), p);
829 else
830 give_warning2((char_u *)
831 _("W22: Text found after :endfunction: %s"),
832 p, TRUE);
833 }
834 if (nextcmd != NULL && *skipwhite(nextcmd) != NUL)
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +0100835 {
836 // Another command follows. If the line came from "eap"
837 // we can simply point into it, otherwise we need to
838 // change "eap->cmdlinep".
839 eap->nextcmd = nextcmd;
840 if (*line_to_free != NULL)
841 {
842 vim_free(*eap->cmdlinep);
843 *eap->cmdlinep = *line_to_free;
844 *line_to_free = NULL;
845 }
846 }
847 break;
848 }
849 }
850
851 // Check for mismatched "endfunc" or "enddef".
852 // We don't check for "def" inside "func" thus we also can't check
853 // for "enddef".
854 // We continue to find the end of the function, although we might
855 // not find it.
856 else if (nesting_def[nesting])
857 {
858 if (checkforcmd(&p, "endfunction", 4) && *p != ':')
859 emsg(_(e_mismatched_endfunction));
860 }
861 else if (eap->cmdidx == CMD_def && checkforcmd(&p, "enddef", 4))
862 emsg(_(e_mismatched_enddef));
863
864 // Increase indent inside "if", "while", "for" and "try", decrease
865 // at "end".
866 if (indent > 2 && (*p == '}' || STRNCMP(p, "end", 3) == 0))
867 indent -= 2;
868 else if (STRNCMP(p, "if", 2) == 0
869 || STRNCMP(p, "wh", 2) == 0
870 || STRNCMP(p, "for", 3) == 0
871 || STRNCMP(p, "try", 3) == 0)
872 indent += 2;
873
874 // Check for defining a function inside this function.
875 // Only recognize "def" inside "def", not inside "function",
876 // For backwards compatibility, see Test_function_python().
877 c = *p;
878 if (is_function_cmd(&p)
879 || (eap->cmdidx == CMD_def && checkforcmd(&p, "def", 3)))
880 {
881 if (*p == '!')
882 p = skipwhite(p + 1);
883 p += eval_fname_script(p);
884 vim_free(trans_function_name(&p, NULL, TRUE, 0, NULL,
885 NULL, NULL));
886 if (*skipwhite(p) == '(')
887 {
888 if (nesting == MAX_FUNC_NESTING - 1)
889 emsg(_(e_function_nesting_too_deep));
890 else
891 {
892 ++nesting;
893 nesting_def[nesting] = (c == 'd');
Bram Moolenaar5245beb2021-07-15 22:03:50 +0200894 nesting_inline[nesting] = FALSE;
895 indent += 2;
896 }
897 }
898 }
899
Bram Moolenaarac2cd2b2021-07-19 21:04:23 +0200900 if (nesting_def[nesting] ? *p != '#' : *p != '"')
Bram Moolenaar5245beb2021-07-15 22:03:50 +0200901 {
Bram Moolenaarac2cd2b2021-07-19 21:04:23 +0200902 // Not a comment line: check for nested inline function.
903 end = p + STRLEN(p) - 1;
Bram Moolenaar5245beb2021-07-15 22:03:50 +0200904 while (end > p && VIM_ISWHITE(*end))
905 --end;
Bram Moolenaar13212572021-08-01 22:01:30 +0200906 if (end > p + 1 && *end == '{' && VIM_ISWHITE(end[-1]))
Bram Moolenaar5245beb2021-07-15 22:03:50 +0200907 {
Bram Moolenaare4db17f2021-08-01 21:19:43 +0200908 int is_block;
909
910 // check for trailing "=> {": start of an inline function
Bram Moolenaarac2cd2b2021-07-19 21:04:23 +0200911 --end;
912 while (end > p && VIM_ISWHITE(*end))
913 --end;
Bram Moolenaare4db17f2021-08-01 21:19:43 +0200914 is_block = end > p + 2 && end[-1] == '=' && end[0] == '>';
915 if (!is_block)
Bram Moolenaar5245beb2021-07-15 22:03:50 +0200916 {
Bram Moolenaare4db17f2021-08-01 21:19:43 +0200917 char_u *s = p;
918
919 // check for line starting with "au" for :autocmd or
920 // "com" for :command, these can use a {} block
921 is_block = checkforcmd_noparen(&s, "autocmd", 2)
922 || checkforcmd_noparen(&s, "command", 3);
923 }
924
925 if (is_block)
926 {
Bram Moolenaarac2cd2b2021-07-19 21:04:23 +0200927 if (nesting == MAX_FUNC_NESTING - 1)
928 emsg(_(e_function_nesting_too_deep));
929 else
930 {
931 ++nesting;
932 nesting_def[nesting] = TRUE;
933 nesting_inline[nesting] = TRUE;
934 indent += 2;
935 }
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +0100936 }
937 }
938 }
939
940 // Check for ":append", ":change", ":insert". Not for :def.
941 p = skip_range(p, FALSE, NULL);
942 if (!vim9_function
943 && ((p[0] == 'a' && (!ASCII_ISALPHA(p[1]) || p[1] == 'p'))
944 || (p[0] == 'c'
945 && (!ASCII_ISALPHA(p[1]) || (p[1] == 'h'
946 && (!ASCII_ISALPHA(p[2]) || (p[2] == 'a'
947 && (STRNCMP(&p[3], "nge", 3) != 0
948 || !ASCII_ISALPHA(p[6])))))))
949 || (p[0] == 'i'
950 && (!ASCII_ISALPHA(p[1]) || (p[1] == 'n'
951 && (!ASCII_ISALPHA(p[2])
952 || (p[2] == 's'
953 && (!ASCII_ISALPHA(p[3])
954 || p[3] == 'e'))))))))
955 skip_until = vim_strsave((char_u *)".");
956
957 // Check for ":python <<EOF", ":tcl <<EOF", etc.
958 arg = skipwhite(skiptowhite(p));
959 if (arg[0] == '<' && arg[1] =='<'
960 && ((p[0] == 'p' && p[1] == 'y'
961 && (!ASCII_ISALNUM(p[2]) || p[2] == 't'
962 || ((p[2] == '3' || p[2] == 'x')
963 && !ASCII_ISALPHA(p[3]))))
964 || (p[0] == 'p' && p[1] == 'e'
965 && (!ASCII_ISALPHA(p[2]) || p[2] == 'r'))
966 || (p[0] == 't' && p[1] == 'c'
967 && (!ASCII_ISALPHA(p[2]) || p[2] == 'l'))
968 || (p[0] == 'l' && p[1] == 'u' && p[2] == 'a'
969 && !ASCII_ISALPHA(p[3]))
970 || (p[0] == 'r' && p[1] == 'u' && p[2] == 'b'
971 && (!ASCII_ISALPHA(p[3]) || p[3] == 'y'))
972 || (p[0] == 'm' && p[1] == 'z'
973 && (!ASCII_ISALPHA(p[2]) || p[2] == 's'))
974 ))
975 {
976 // ":python <<" continues until a dot, like ":append"
977 p = skipwhite(arg + 2);
978 if (STRNCMP(p, "trim", 4) == 0)
979 {
980 // Ignore leading white space.
981 p = skipwhite(p + 4);
982 heredoc_trimmed = vim_strnsave(theline,
983 skipwhite(theline) - theline);
984 }
985 if (*p == NUL)
986 skip_until = vim_strsave((char_u *)".");
987 else
988 skip_until = vim_strnsave(p, skiptowhite(p) - p);
989 getline_options = GETLINE_NONE;
990 is_heredoc = TRUE;
Bram Moolenaar20677332021-06-06 17:02:53 +0200991 if (eap->cmdidx == CMD_def)
992 heredoc_concat_len = newlines->ga_len + 1;
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +0100993 }
994
995 // Check for ":cmd v =<< [trim] EOF"
996 // and ":cmd [a, b] =<< [trim] EOF"
997 // and "lines =<< [trim] EOF" for Vim9
998 // Where "cmd" can be "let", "var", "final" or "const".
999 arg = skipwhite(skiptowhite(p));
1000 if (*arg == '[')
1001 arg = vim_strchr(arg, ']');
1002 if (arg != NULL)
1003 {
1004 int found = (eap->cmdidx == CMD_def && arg[0] == '='
1005 && arg[1] == '<' && arg[2] =='<');
1006
1007 if (!found)
1008 // skip over the argument after "cmd"
1009 arg = skipwhite(skiptowhite(arg));
1010 if (found || (arg[0] == '=' && arg[1] == '<' && arg[2] =='<'
1011 && (checkforcmd(&p, "let", 2)
1012 || checkforcmd(&p, "var", 3)
1013 || checkforcmd(&p, "final", 5)
1014 || checkforcmd(&p, "const", 5))))
1015 {
1016 p = skipwhite(arg + 3);
1017 if (STRNCMP(p, "trim", 4) == 0)
1018 {
1019 // Ignore leading white space.
1020 p = skipwhite(p + 4);
1021 heredoc_trimmed = vim_strnsave(theline,
1022 skipwhite(theline) - theline);
1023 }
1024 skip_until = vim_strnsave(p, skiptowhite(p) - p);
1025 getline_options = GETLINE_NONE;
1026 is_heredoc = TRUE;
1027 }
1028 }
1029 }
1030
1031 // Add the line to the function.
1032 if (ga_grow(newlines, 1 + sourcing_lnum_off) == FAIL)
1033 goto theend;
1034
Bram Moolenaar20677332021-06-06 17:02:53 +02001035 if (heredoc_concat_len > 0)
1036 {
1037 // For a :def function "python << EOF" concatenats all the lines,
1038 // to be used for the instruction later.
1039 ga_concat(&heredoc_ga, theline);
1040 ga_concat(&heredoc_ga, (char_u *)"\n");
1041 p = vim_strsave((char_u *)"");
1042 }
1043 else
1044 {
1045 // Copy the line to newly allocated memory. get_one_sourceline()
1046 // allocates 250 bytes per line, this saves 80% on average. The
1047 // cost is an extra alloc/free.
1048 p = vim_strsave(theline);
1049 }
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +01001050 if (p == NULL)
1051 goto theend;
1052 ((char_u **)(newlines->ga_data))[newlines->ga_len++] = p;
1053
1054 // Add NULL lines for continuation lines, so that the line count is
1055 // equal to the index in the growarray.
1056 while (sourcing_lnum_off-- > 0)
1057 ((char_u **)(newlines->ga_data))[newlines->ga_len++] = NULL;
1058
1059 // Check for end of eap->arg.
1060 if (line_arg != NULL && *line_arg == NUL)
1061 line_arg = NULL;
1062 }
1063
Bram Moolenaar074f84c2021-05-18 11:47:44 +02001064 // Return OK when no error was detected.
1065 if (!did_emsg)
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +01001066 ret = OK;
1067
1068theend:
1069 vim_free(skip_until);
1070 vim_free(heredoc_trimmed);
Bram Moolenaar20677332021-06-06 17:02:53 +02001071 vim_free(heredoc_ga.ga_data);
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +01001072 need_wait_return |= saved_wait_return;
1073 return ret;
1074}
1075
1076/*
1077 * Handle the body of a lambda. *arg points to the "{", process statements
1078 * until the matching "}".
Bram Moolenaar074f84c2021-05-18 11:47:44 +02001079 * When not evaluating "newargs" is NULL.
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +01001080 * When successful "rettv" is set to a funcref.
1081 */
1082 static int
1083lambda_function_body(
1084 char_u **arg,
1085 typval_T *rettv,
1086 evalarg_T *evalarg,
1087 garray_T *newargs,
1088 garray_T *argtypes,
1089 int varargs,
1090 garray_T *default_args,
1091 char_u *ret_type)
1092{
Bram Moolenaarfed9e832021-04-10 21:38:38 +02001093 int evaluate = (evalarg->eval_flags & EVAL_EVALUATE);
Bram Moolenaar074f84c2021-05-18 11:47:44 +02001094 garray_T *gap = &evalarg->eval_ga;
Bram Moolenaarecb66452021-05-18 15:09:18 +02001095 garray_T *freegap = &evalarg->eval_freega;
Bram Moolenaar79efa2e2021-03-27 15:40:11 +01001096 ufunc_T *ufunc = NULL;
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +01001097 exarg_T eap;
1098 garray_T newlines;
1099 char_u *cmdline = NULL;
1100 int ret = FAIL;
1101 char_u *line_to_free = NULL;
1102 partial_T *pt;
1103 char_u *name;
1104 int lnum_save = -1;
1105 linenr_T sourcing_lnum_top = SOURCING_LNUM;
1106
Bram Moolenaare98f60a2021-03-22 18:22:30 +01001107 if (!ends_excmd2(*arg, skipwhite(*arg + 1)))
1108 {
1109 semsg(_(e_trailing_arg), *arg + 1);
1110 return FAIL;
1111 }
1112
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +01001113 CLEAR_FIELD(eap);
1114 eap.cmdidx = CMD_block;
1115 eap.forceit = FALSE;
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +01001116 eap.cmdlinep = &cmdline;
1117 eap.skip = !evaluate;
1118 if (evalarg->eval_cctx != NULL)
1119 fill_exarg_from_cctx(&eap, evalarg->eval_cctx);
1120 else
1121 {
1122 eap.getline = evalarg->eval_getline;
1123 eap.cookie = evalarg->eval_cookie;
1124 }
1125
1126 ga_init2(&newlines, (int)sizeof(char_u *), 10);
1127 if (get_function_body(&eap, &newlines, NULL, &line_to_free) == FAIL)
Bram Moolenaar67da21a2021-03-21 22:12:34 +01001128 {
1129 vim_free(cmdline);
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +01001130 goto erret;
Bram Moolenaar67da21a2021-03-21 22:12:34 +01001131 }
Bram Moolenaar074f84c2021-05-18 11:47:44 +02001132
1133 // When inside a lambda must add the function lines to evalarg.eval_ga.
1134 evalarg->eval_break_count += newlines.ga_len;
1135 if (gap->ga_itemsize > 0)
1136 {
1137 int idx;
1138 char_u *last;
1139 size_t plen;
1140 char_u *pnl;
1141
1142 for (idx = 0; idx < newlines.ga_len; ++idx)
1143 {
1144 char_u *p = skipwhite(((char_u **)newlines.ga_data)[idx]);
1145
Bram Moolenaarecb66452021-05-18 15:09:18 +02001146 if (ga_grow(gap, 1) == FAIL || ga_grow(freegap, 1) == FAIL)
Bram Moolenaar074f84c2021-05-18 11:47:44 +02001147 goto erret;
1148
1149 // Going to concatenate the lines after parsing. For an empty or
1150 // comment line use an empty string.
1151 // Insert NL characters at the start of each line, the string will
1152 // be split again later in .get_lambda_tv().
1153 if (*p == NUL || vim9_comment_start(p))
1154 p = (char_u *)"";
1155 plen = STRLEN(p);
1156 pnl = vim_strnsave((char_u *)"\n", plen + 1);
1157 if (pnl != NULL)
1158 mch_memmove(pnl + 1, p, plen + 1);
Bram Moolenaarecb66452021-05-18 15:09:18 +02001159 ((char_u **)gap->ga_data)[gap->ga_len++] = pnl;
1160 ((char_u **)freegap->ga_data)[freegap->ga_len++] = pnl;
Bram Moolenaar074f84c2021-05-18 11:47:44 +02001161 }
Bram Moolenaarecb66452021-05-18 15:09:18 +02001162 if (ga_grow(gap, 1) == FAIL || ga_grow(freegap, 1) == FAIL)
Bram Moolenaar074f84c2021-05-18 11:47:44 +02001163 goto erret;
1164 if (cmdline != NULL)
1165 // more is following after the "}", which was skipped
1166 last = cmdline;
1167 else
1168 // nothing is following the "}"
1169 last = (char_u *)"}";
1170 plen = STRLEN(last);
1171 pnl = vim_strnsave((char_u *)"\n", plen + 1);
1172 if (pnl != NULL)
1173 mch_memmove(pnl + 1, last, plen + 1);
Bram Moolenaarecb66452021-05-18 15:09:18 +02001174 ((char_u **)gap->ga_data)[gap->ga_len++] = pnl;
1175 ((char_u **)freegap->ga_data)[freegap->ga_len++] = pnl;
Bram Moolenaar074f84c2021-05-18 11:47:44 +02001176 }
1177
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +01001178 if (cmdline != NULL)
1179 {
Bram Moolenaar844fb642021-10-23 13:32:30 +01001180 garray_T *tfgap = &evalarg->eval_tofree_ga;
1181
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +01001182 // Something comes after the "}".
1183 *arg = eap.nextcmd;
Bram Moolenaar67da21a2021-03-21 22:12:34 +01001184
1185 // "arg" points into cmdline, need to keep the line and free it later.
Bram Moolenaar844fb642021-10-23 13:32:30 +01001186 if (ga_grow(tfgap, 1) == OK)
1187 {
1188 ((char_u **)(tfgap->ga_data))[tfgap->ga_len++] = cmdline;
1189 evalarg->eval_using_cmdline = TRUE;
1190 }
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +01001191 }
1192 else
1193 *arg = (char_u *)"";
1194
Bram Moolenaar074f84c2021-05-18 11:47:44 +02001195 if (!evaluate)
1196 {
1197 ret = OK;
1198 goto erret;
1199 }
1200
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +01001201 name = get_lambda_name();
1202 ufunc = alloc_clear(offsetof(ufunc_T, uf_name) + STRLEN(name) + 1);
1203 if (ufunc == NULL)
1204 goto erret;
1205 set_ufunc_name(ufunc, name);
1206 if (hash_add(&func_hashtab, UF2HIKEY(ufunc)) == FAIL)
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +01001207 goto erret;
Bram Moolenaar38453522021-11-28 22:00:12 +00001208 ufunc->uf_flags = FC_LAMBDA;
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +01001209 ufunc->uf_refcount = 1;
1210 ufunc->uf_args = *newargs;
1211 newargs->ga_data = NULL;
1212 ufunc->uf_def_args = *default_args;
1213 default_args->ga_data = NULL;
1214 ufunc->uf_func_type = &t_func_any;
1215
1216 // error messages are for the first function line
1217 lnum_save = SOURCING_LNUM;
1218 SOURCING_LNUM = sourcing_lnum_top;
1219
1220 // parse argument types
1221 if (parse_argument_types(ufunc, argtypes, varargs) == FAIL)
1222 {
1223 SOURCING_LNUM = lnum_save;
1224 goto erret;
1225 }
1226
1227 // parse the return type, if any
1228 if (parse_return_type(ufunc, ret_type) == FAIL)
1229 goto erret;
1230
1231 pt = ALLOC_CLEAR_ONE(partial_T);
1232 if (pt == NULL)
1233 goto erret;
1234 pt->pt_func = ufunc;
1235 pt->pt_refcount = 1;
1236
1237 ufunc->uf_lines = newlines;
1238 newlines.ga_data = NULL;
1239 if (sandbox)
1240 ufunc->uf_flags |= FC_SANDBOX;
1241 if (!ASCII_ISUPPER(*ufunc->uf_name))
1242 ufunc->uf_flags |= FC_VIM9;
1243 ufunc->uf_script_ctx = current_sctx;
1244 ufunc->uf_script_ctx_version = current_sctx.sc_version;
1245 ufunc->uf_script_ctx.sc_lnum += sourcing_lnum_top;
1246 set_function_type(ufunc);
1247
Bram Moolenaar2eb6fc32021-07-25 14:13:53 +02001248 function_using_block_scopes(ufunc, evalarg->eval_cstack);
1249
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +01001250 rettv->vval.v_partial = pt;
1251 rettv->v_type = VAR_PARTIAL;
Bram Moolenaar79efa2e2021-03-27 15:40:11 +01001252 ufunc = NULL;
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +01001253 ret = OK;
1254
1255erret:
1256 if (lnum_save >= 0)
1257 SOURCING_LNUM = lnum_save;
1258 vim_free(line_to_free);
1259 ga_clear_strings(&newlines);
Bram Moolenaar074f84c2021-05-18 11:47:44 +02001260 if (newargs != NULL)
1261 ga_clear_strings(newargs);
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +01001262 ga_clear_strings(default_args);
Bram Moolenaar79efa2e2021-03-27 15:40:11 +01001263 if (ufunc != NULL)
1264 {
1265 func_clear(ufunc, TRUE);
1266 func_free(ufunc, TRUE);
1267 }
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +01001268 return ret;
1269}
1270
1271/*
1272 * Parse a lambda expression and get a Funcref from "*arg" into "rettv".
Bram Moolenaar65c44152020-12-24 15:14:01 +01001273 * "arg" points to the { in "{arg -> expr}" or the ( in "(arg) => expr"
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +01001274 * When "types_optional" is TRUE optionally take argument types.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001275 * Return OK or FAIL. Returns NOTDONE for dict or {expr}.
1276 */
1277 int
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +01001278get_lambda_tv(
1279 char_u **arg,
1280 typval_T *rettv,
1281 int types_optional,
1282 evalarg_T *evalarg)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001283{
Bram Moolenaare40fbc22020-06-27 18:06:45 +02001284 int evaluate = evalarg != NULL
1285 && (evalarg->eval_flags & EVAL_EVALUATE);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001286 garray_T newargs;
1287 garray_T newlines;
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02001288 garray_T *pnewargs;
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +01001289 garray_T argtypes;
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +01001290 garray_T default_args;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001291 ufunc_T *fp = NULL;
Bram Moolenaar445e71c2019-02-14 13:43:36 +01001292 partial_T *pt = NULL;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001293 int varargs;
Bram Moolenaar9e68c322020-12-25 12:38:04 +01001294 char_u *ret_type = NULL;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001295 int ret;
Bram Moolenaar8e2730a2020-07-08 22:01:49 +02001296 char_u *s;
1297 char_u *start, *end;
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02001298 int *old_eval_lavars = eval_lavars_used;
1299 int eval_lavars = FALSE;
Bram Moolenaarf898f7c2021-01-16 18:09:52 +01001300 char_u *tofree1 = NULL;
1301 char_u *tofree2 = NULL;
Bram Moolenaar65c44152020-12-24 15:14:01 +01001302 int equal_arrow = **arg == '(';
Bram Moolenaarc754b4c2020-12-25 15:24:23 +01001303 int white_error = FALSE;
Bram Moolenaar0346b792021-01-31 22:18:29 +01001304 int called_emsg_start = called_emsg;
Bram Moolenaar65c44152020-12-24 15:14:01 +01001305
1306 if (equal_arrow && !in_vim9script())
1307 return NOTDONE;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001308
1309 ga_init(&newargs);
1310 ga_init(&newlines);
1311
Bram Moolenaar9e68c322020-12-25 12:38:04 +01001312 // First, check if this is really a lambda expression. "->" or "=>" must
1313 // be found after the arguments.
Bram Moolenaarcef12702021-01-04 14:09:43 +01001314 s = *arg + 1;
Bram Moolenaar65c44152020-12-24 15:14:01 +01001315 ret = get_function_args(&s, equal_arrow ? ')' : '-', NULL,
Bram Moolenaar057e84a2021-02-28 16:55:11 +01001316 types_optional ? &argtypes : NULL, types_optional, evalarg,
Bram Moolenaar14ded112021-06-26 19:25:49 +02001317 NULL, &default_args, TRUE, NULL, NULL);
Bram Moolenaarc754b4c2020-12-25 15:24:23 +01001318 if (ret == FAIL || skip_arrow(s, equal_arrow, &ret_type, NULL) == NULL)
Bram Moolenaar6dd41b12020-12-24 16:06:00 +01001319 {
1320 if (types_optional)
1321 ga_clear_strings(&argtypes);
Bram Moolenaar0346b792021-01-31 22:18:29 +01001322 return called_emsg == called_emsg_start ? NOTDONE : FAIL;
Bram Moolenaar6dd41b12020-12-24 16:06:00 +01001323 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001324
Bram Moolenaar9e68c322020-12-25 12:38:04 +01001325 // Parse the arguments for real.
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02001326 if (evaluate)
1327 pnewargs = &newargs;
1328 else
1329 pnewargs = NULL;
Bram Moolenaarcef12702021-01-04 14:09:43 +01001330 *arg += 1;
Bram Moolenaar65c44152020-12-24 15:14:01 +01001331 ret = get_function_args(arg, equal_arrow ? ')' : '-', pnewargs,
Bram Moolenaar057e84a2021-02-28 16:55:11 +01001332 types_optional ? &argtypes : NULL, types_optional, evalarg,
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +01001333 &varargs, &default_args,
1334 FALSE, NULL, NULL);
Bram Moolenaar9e68c322020-12-25 12:38:04 +01001335 if (ret == FAIL
Bram Moolenaarc754b4c2020-12-25 15:24:23 +01001336 || (s = skip_arrow(*arg, equal_arrow, &ret_type,
Bram Moolenaare462f522020-12-27 14:43:30 +01001337 equal_arrow || in_vim9script() ? &white_error : NULL)) == NULL)
Bram Moolenaar6dd41b12020-12-24 16:06:00 +01001338 {
1339 if (types_optional)
1340 ga_clear_strings(&argtypes);
Bram Moolenaare5730bd2020-12-25 22:30:16 +01001341 ga_clear_strings(&newargs);
Bram Moolenaarc754b4c2020-12-25 15:24:23 +01001342 return white_error ? FAIL : NOTDONE;
Bram Moolenaar6dd41b12020-12-24 16:06:00 +01001343 }
Bram Moolenaarc754b4c2020-12-25 15:24:23 +01001344 *arg = s;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001345
Bram Moolenaarf898f7c2021-01-16 18:09:52 +01001346 // Skipping over linebreaks may make "ret_type" invalid, make a copy.
1347 if (ret_type != NULL)
1348 {
1349 ret_type = vim_strsave(ret_type);
1350 tofree2 = ret_type;
1351 }
1352
Bram Moolenaare38eab22019-12-05 21:50:01 +01001353 // Set up a flag for checking local variables and arguments.
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02001354 if (evaluate)
1355 eval_lavars_used = &eval_lavars;
1356
Bram Moolenaar65c44152020-12-24 15:14:01 +01001357 *arg = skipwhite_and_linebreak(*arg, evalarg);
1358
Bram Moolenaar9e68c322020-12-25 12:38:04 +01001359 // Recognize "{" as the start of a function body.
1360 if (equal_arrow && **arg == '{')
Bram Moolenaar65c44152020-12-24 15:14:01 +01001361 {
Bram Moolenaarfed9e832021-04-10 21:38:38 +02001362 if (evalarg == NULL)
1363 // cannot happen?
1364 goto theend;
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +01001365 if (lambda_function_body(arg, rettv, evalarg, pnewargs,
1366 types_optional ? &argtypes : NULL, varargs,
1367 &default_args, ret_type) == FAIL)
1368 goto errret;
1369 goto theend;
1370 }
1371 if (default_args.ga_len > 0)
1372 {
1373 emsg(_(e_cannot_use_default_values_in_lambda));
Bram Moolenaar65c44152020-12-24 15:14:01 +01001374 goto errret;
1375 }
1376
Bram Moolenaare38eab22019-12-05 21:50:01 +01001377 // Get the start and the end of the expression.
Bram Moolenaar8e2730a2020-07-08 22:01:49 +02001378 start = *arg;
1379 ret = skip_expr_concatenate(arg, &start, &end, evalarg);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001380 if (ret == FAIL)
1381 goto errret;
Bram Moolenaare40fbc22020-06-27 18:06:45 +02001382 if (evalarg != NULL)
1383 {
1384 // avoid that the expression gets freed when another line break follows
Bram Moolenaarf898f7c2021-01-16 18:09:52 +01001385 tofree1 = evalarg->eval_tofree;
Bram Moolenaare40fbc22020-06-27 18:06:45 +02001386 evalarg->eval_tofree = NULL;
1387 }
1388
Bram Moolenaar65c44152020-12-24 15:14:01 +01001389 if (!equal_arrow)
Bram Moolenaaree619e52020-03-28 21:38:06 +01001390 {
Bram Moolenaar65c44152020-12-24 15:14:01 +01001391 *arg = skipwhite_and_linebreak(*arg, evalarg);
1392 if (**arg != '}')
1393 {
1394 semsg(_("E451: Expected }: %s"), *arg);
1395 goto errret;
1396 }
1397 ++*arg;
Bram Moolenaaree619e52020-03-28 21:38:06 +01001398 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001399
1400 if (evaluate)
1401 {
Bram Moolenaare40fbc22020-06-27 18:06:45 +02001402 int len;
Bram Moolenaar38453522021-11-28 22:00:12 +00001403 int flags = FC_LAMBDA;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001404 char_u *p;
Bram Moolenaar074f84c2021-05-18 11:47:44 +02001405 char_u *line_end;
Bram Moolenaar04b12692020-05-04 23:24:44 +02001406 char_u *name = get_lambda_name();
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02001407
Bram Moolenaar47ed5532019-08-08 20:49:14 +02001408 fp = alloc_clear(offsetof(ufunc_T, uf_name) + STRLEN(name) + 1);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001409 if (fp == NULL)
1410 goto errret;
Bram Moolenaar0cb5bcf2020-06-20 18:19:09 +02001411 fp->uf_def_status = UF_NOT_COMPILED;
Bram Moolenaarc799fe22019-05-28 23:08:19 +02001412 pt = ALLOC_CLEAR_ONE(partial_T);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001413 if (pt == NULL)
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001414 goto errret;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001415
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001416 ga_init2(&newlines, (int)sizeof(char_u *), 1);
1417 if (ga_grow(&newlines, 1) == FAIL)
1418 goto errret;
1419
Bram Moolenaar074f84c2021-05-18 11:47:44 +02001420 // If there are line breaks, we need to split up the string.
1421 line_end = vim_strchr(start, '\n');
Bram Moolenaar68686342021-07-28 15:54:54 +02001422 if (line_end == NULL || line_end > end)
Bram Moolenaar074f84c2021-05-18 11:47:44 +02001423 line_end = end;
1424
1425 // Add "return " before the expression (or the first line).
1426 len = 7 + (int)(line_end - start) + 1;
Bram Moolenaarc799fe22019-05-28 23:08:19 +02001427 p = alloc(len);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001428 if (p == NULL)
1429 goto errret;
1430 ((char_u **)(newlines.ga_data))[newlines.ga_len++] = p;
1431 STRCPY(p, "return ");
Bram Moolenaar074f84c2021-05-18 11:47:44 +02001432 vim_strncpy(p + 7, start, line_end - start);
1433
1434 if (line_end != end)
1435 {
1436 // Add more lines, split by line breaks. Thus is used when a
1437 // lambda with { cmds } is encountered.
1438 while (*line_end == '\n')
1439 {
1440 if (ga_grow(&newlines, 1) == FAIL)
1441 goto errret;
1442 start = line_end + 1;
1443 line_end = vim_strchr(start, '\n');
1444 if (line_end == NULL)
1445 line_end = end;
1446 ((char_u **)(newlines.ga_data))[newlines.ga_len++] =
1447 vim_strnsave(start, line_end - start);
1448 }
1449 }
1450
Bram Moolenaarf10806b2020-04-02 18:34:35 +02001451 if (strstr((char *)p + 7, "a:") == NULL)
1452 // No a: variables are used for sure.
1453 flags |= FC_NOARGS;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001454
1455 fp->uf_refcount = 1;
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01001456 set_ufunc_name(fp, name);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001457 fp->uf_args = newargs;
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02001458 ga_init(&fp->uf_def_args);
Bram Moolenaar9e68c322020-12-25 12:38:04 +01001459 if (types_optional)
1460 {
Bram Moolenaar2a389082021-04-09 20:24:31 +02001461 if (parse_argument_types(fp, &argtypes,
1462 in_vim9script() && varargs) == FAIL)
Bram Moolenaar9e68c322020-12-25 12:38:04 +01001463 goto errret;
1464 if (ret_type != NULL)
1465 {
1466 fp->uf_ret_type = parse_type(&ret_type,
1467 &fp->uf_type_list, TRUE);
1468 if (fp->uf_ret_type == NULL)
1469 goto errret;
1470 }
Bram Moolenaarca2f7e72020-12-31 13:39:54 +01001471 else
Bram Moolenaara9931532021-06-12 15:58:16 +02001472 fp->uf_ret_type = &t_unknown;
Bram Moolenaar9e68c322020-12-25 12:38:04 +01001473 }
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +01001474
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001475 fp->uf_lines = newlines;
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02001476 if (current_funccal != NULL && eval_lavars)
1477 {
Bram Moolenaar10ce39a2016-07-29 22:37:06 +02001478 flags |= FC_CLOSURE;
Bram Moolenaar58016442016-07-31 18:30:22 +02001479 if (register_closure(fp) == FAIL)
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02001480 goto errret;
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02001481 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001482
1483#ifdef FEAT_PROFILE
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001484 if (prof_def_func())
1485 func_do_profile(fp);
1486#endif
Bram Moolenaar93343722018-07-10 19:39:18 +02001487 if (sandbox)
1488 flags |= FC_SANDBOX;
Bram Moolenaar767034c2021-04-09 17:24:52 +02001489 // In legacy script a lambda can be called with more args than
Bram Moolenaar2a389082021-04-09 20:24:31 +02001490 // uf_args.ga_len. In Vim9 script "...name" has to be used.
1491 fp->uf_varargs = !in_vim9script() || varargs;
Bram Moolenaar10ce39a2016-07-29 22:37:06 +02001492 fp->uf_flags = flags;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001493 fp->uf_calls = 0;
Bram Moolenaarf29c1c62018-09-10 21:05:02 +02001494 fp->uf_script_ctx = current_sctx;
Bram Moolenaara755fdb2021-11-20 21:35:41 +00001495 fp->uf_script_ctx.sc_lnum += SOURCING_LNUM - newlines.ga_len + 1;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001496
Bram Moolenaar2eb6fc32021-07-25 14:13:53 +02001497 function_using_block_scopes(fp, evalarg->eval_cstack);
1498
Bram Moolenaar437bafe2016-08-01 15:40:54 +02001499 pt->pt_func = fp;
1500 pt->pt_refcount = 1;
1501 rettv->vval.v_partial = pt;
1502 rettv->v_type = VAR_PARTIAL;
Bram Moolenaar057e84a2021-02-28 16:55:11 +01001503
1504 hash_add(&func_hashtab, UF2HIKEY(fp));
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001505 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001506
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +01001507theend:
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02001508 eval_lavars_used = old_eval_lavars;
Bram Moolenaarefaaaa62020-07-08 22:24:09 +02001509 if (evalarg != NULL && evalarg->eval_tofree == NULL)
Bram Moolenaarf898f7c2021-01-16 18:09:52 +01001510 evalarg->eval_tofree = tofree1;
Bram Moolenaar8e2730a2020-07-08 22:01:49 +02001511 else
Bram Moolenaarf898f7c2021-01-16 18:09:52 +01001512 vim_free(tofree1);
1513 vim_free(tofree2);
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +01001514 if (types_optional)
1515 ga_clear_strings(&argtypes);
Bram Moolenaar2eb6fc32021-07-25 14:13:53 +02001516
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001517 return OK;
1518
1519errret:
1520 ga_clear_strings(&newargs);
1521 ga_clear_strings(&newlines);
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +01001522 ga_clear_strings(&default_args);
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +01001523 if (types_optional)
Bram Moolenaar15bbb8f2021-05-24 15:45:29 +02001524 {
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +01001525 ga_clear_strings(&argtypes);
Bram Moolenaar15bbb8f2021-05-24 15:45:29 +02001526 if (fp != NULL)
1527 vim_free(fp->uf_arg_types);
1528 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001529 vim_free(fp);
Bram Moolenaar445e71c2019-02-14 13:43:36 +01001530 vim_free(pt);
Bram Moolenaarefaaaa62020-07-08 22:24:09 +02001531 if (evalarg != NULL && evalarg->eval_tofree == NULL)
Bram Moolenaarf898f7c2021-01-16 18:09:52 +01001532 evalarg->eval_tofree = tofree1;
Bram Moolenaar8e2730a2020-07-08 22:01:49 +02001533 else
Bram Moolenaarf898f7c2021-01-16 18:09:52 +01001534 vim_free(tofree1);
1535 vim_free(tofree2);
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02001536 eval_lavars_used = old_eval_lavars;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001537 return FAIL;
1538}
1539
1540/*
1541 * Check if "name" is a variable of type VAR_FUNC. If so, return the function
1542 * name it contains, otherwise return "name".
1543 * If "partialp" is not NULL, and "name" is of type VAR_PARTIAL also set
1544 * "partialp".
Bram Moolenaar32b3f822021-01-06 21:59:39 +01001545 * If "type" is not NULL and a Vim9 script-local variable is found look up the
1546 * type of the variable.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001547 */
1548 char_u *
Bram Moolenaar32b3f822021-01-06 21:59:39 +01001549deref_func_name(
1550 char_u *name,
1551 int *lenp,
1552 partial_T **partialp,
1553 type_T **type,
1554 int no_autoload)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001555{
1556 dictitem_T *v;
Bram Moolenaar5fe07d22021-10-22 22:17:53 +01001557 typval_T *tv = NULL;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001558 int cc;
Bram Moolenaar32b3f822021-01-06 21:59:39 +01001559 char_u *s = NULL;
1560 hashtab_T *ht;
Bram Moolenaar5fe07d22021-10-22 22:17:53 +01001561 int did_type = FALSE;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001562
1563 if (partialp != NULL)
1564 *partialp = NULL;
1565
1566 cc = name[*lenp];
1567 name[*lenp] = NUL;
Bram Moolenaar20677332021-06-06 17:02:53 +02001568
Bram Moolenaar32b3f822021-01-06 21:59:39 +01001569 v = find_var(name, &ht, no_autoload);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001570 name[*lenp] = cc;
Bram Moolenaar32b3f822021-01-06 21:59:39 +01001571 if (v != NULL)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001572 {
Bram Moolenaar5fe07d22021-10-22 22:17:53 +01001573 tv = &v->di_tv;
1574 }
1575 else if (in_vim9script() || STRNCMP(name, "s:", 2) == 0)
1576 {
1577 imported_T *import;
1578 char_u *p = name;
1579 int len = *lenp;
1580
1581 if (STRNCMP(name, "s:", 2) == 0)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001582 {
Bram Moolenaar5fe07d22021-10-22 22:17:53 +01001583 p = name + 2;
1584 len -= 2;
1585 }
1586 import = find_imported(p, len, NULL);
1587
1588 // imported variable from another script
1589 if (import != NULL)
1590 {
1591 if (import->imp_funcname != NULL)
1592 {
1593 s = import->imp_funcname;
1594 *lenp = (int)STRLEN(s);
1595 return s;
1596 }
1597 // TODO: what if (import->imp_flags & IMP_FLAGS_STAR)
1598 {
1599 scriptitem_T *si = SCRIPT_ITEM(import->imp_sid);
1600 svar_T *sv = ((svar_T *)si->sn_var_vals.ga_data)
1601 + import->imp_var_vals_idx;
1602 tv = sv->sv_tv;
1603 if (type != NULL)
1604 *type = sv->sv_type;
1605 did_type = TRUE;
1606 }
1607 }
1608 }
1609
1610 if (tv != NULL)
1611 {
1612 if (tv->v_type == VAR_FUNC)
1613 {
1614 if (tv->vval.v_string == NULL)
Bram Moolenaar32b3f822021-01-06 21:59:39 +01001615 {
1616 *lenp = 0;
1617 return (char_u *)""; // just in case
1618 }
Bram Moolenaar5fe07d22021-10-22 22:17:53 +01001619 s = tv->vval.v_string;
Bram Moolenaar32b3f822021-01-06 21:59:39 +01001620 *lenp = (int)STRLEN(s);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001621 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001622
Bram Moolenaar5fe07d22021-10-22 22:17:53 +01001623 if (tv->v_type == VAR_PARTIAL)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001624 {
Bram Moolenaar5fe07d22021-10-22 22:17:53 +01001625 partial_T *pt = tv->vval.v_partial;
Bram Moolenaar32b3f822021-01-06 21:59:39 +01001626
1627 if (pt == NULL)
1628 {
1629 *lenp = 0;
1630 return (char_u *)""; // just in case
1631 }
1632 if (partialp != NULL)
1633 *partialp = pt;
1634 s = partial_name(pt);
1635 *lenp = (int)STRLEN(s);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001636 }
Bram Moolenaar32b3f822021-01-06 21:59:39 +01001637
1638 if (s != NULL)
1639 {
Bram Moolenaar5fe07d22021-10-22 22:17:53 +01001640 if (!did_type && type != NULL && ht == get_script_local_ht())
Bram Moolenaar32b3f822021-01-06 21:59:39 +01001641 {
Bram Moolenaar5fe07d22021-10-22 22:17:53 +01001642 svar_T *sv = find_typval_in_script(tv);
Bram Moolenaar32b3f822021-01-06 21:59:39 +01001643
1644 if (sv != NULL)
1645 *type = sv->sv_type;
1646 }
1647 return s;
1648 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001649 }
1650
1651 return name;
1652}
1653
1654/*
1655 * Give an error message with a function name. Handle <SNR> things.
1656 * "ermsg" is to be passed without translation, use N_() instead of _().
1657 */
Bram Moolenaar4c054e92019-11-10 00:13:50 +01001658 void
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001659emsg_funcname(char *ermsg, char_u *name)
1660{
1661 char_u *p;
1662
1663 if (*name == K_SPECIAL)
1664 p = concat_str((char_u *)"<SNR>", name + 3);
1665 else
1666 p = name;
Bram Moolenaarf9e3e092019-01-13 23:38:42 +01001667 semsg(_(ermsg), p);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001668 if (p != name)
1669 vim_free(p);
1670}
1671
1672/*
1673 * Allocate a variable for the result of a function.
1674 * Return OK or FAIL.
1675 */
1676 int
1677get_func_tv(
Bram Moolenaar6ed88192019-05-11 18:37:44 +02001678 char_u *name, // name of the function
1679 int len, // length of "name" or -1 to use strlen()
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001680 typval_T *rettv,
Bram Moolenaar6ed88192019-05-11 18:37:44 +02001681 char_u **arg, // argument, pointing to the '('
Bram Moolenaare6b53242020-07-01 17:28:33 +02001682 evalarg_T *evalarg, // for line continuation
Bram Moolenaarc6538bc2019-08-03 18:17:11 +02001683 funcexe_T *funcexe) // various values
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001684{
1685 char_u *argp;
1686 int ret = OK;
Bram Moolenaare38eab22019-12-05 21:50:01 +01001687 typval_T argvars[MAX_FUNC_ARGS + 1]; // vars for arguments
1688 int argcount = 0; // number of arguments found
Bram Moolenaar7cb6fc22020-08-21 22:36:47 +02001689 int vim9script = in_vim9script();
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001690
1691 /*
1692 * Get the arguments.
1693 */
1694 argp = *arg;
Bram Moolenaarc6538bc2019-08-03 18:17:11 +02001695 while (argcount < MAX_FUNC_ARGS - (funcexe->partial == NULL ? 0
1696 : funcexe->partial->pt_argc))
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001697 {
Bram Moolenaare6b53242020-07-01 17:28:33 +02001698 // skip the '(' or ',' and possibly line breaks
1699 argp = skipwhite_and_linebreak(argp + 1, evalarg);
1700
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001701 if (*argp == ')' || *argp == ',' || *argp == NUL)
1702 break;
Bram Moolenaare6b53242020-07-01 17:28:33 +02001703 if (eval1(&argp, &argvars[argcount], evalarg) == FAIL)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001704 {
1705 ret = FAIL;
1706 break;
1707 }
1708 ++argcount;
Bram Moolenaar9d489562020-07-30 20:08:50 +02001709 // The comma should come right after the argument, but this wasn't
1710 // checked previously, thus only enforce it in Vim9 script.
Bram Moolenaar7cb6fc22020-08-21 22:36:47 +02001711 if (vim9script)
1712 {
1713 if (*argp != ',' && *skipwhite(argp) == ',')
1714 {
Bram Moolenaarba98fb52021-02-07 18:06:29 +01001715 semsg(_(e_no_white_space_allowed_before_str_str), ",", argp);
Bram Moolenaar7cb6fc22020-08-21 22:36:47 +02001716 ret = FAIL;
1717 break;
1718 }
1719 }
1720 else
Bram Moolenaar9d489562020-07-30 20:08:50 +02001721 argp = skipwhite(argp);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001722 if (*argp != ',')
1723 break;
Bram Moolenaar7cb6fc22020-08-21 22:36:47 +02001724 if (vim9script && !IS_WHITE_OR_NUL(argp[1]))
1725 {
Bram Moolenaarc3fc75d2021-02-07 15:28:09 +01001726 semsg(_(e_white_space_required_after_str_str), ",", argp);
Bram Moolenaar7cb6fc22020-08-21 22:36:47 +02001727 ret = FAIL;
1728 break;
1729 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001730 }
Bram Moolenaare6b53242020-07-01 17:28:33 +02001731 argp = skipwhite_and_linebreak(argp, evalarg);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001732 if (*argp == ')')
1733 ++argp;
1734 else
1735 ret = FAIL;
1736
1737 if (ret == OK)
1738 {
Bram Moolenaar327d3ee2021-07-28 19:34:14 +02001739 int i = 0;
1740 int did_emsg_before = did_emsg;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001741
1742 if (get_vim_var_nr(VV_TESTING))
1743 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01001744 // Prepare for calling test_garbagecollect_now(), need to know
1745 // what variables are used on the call stack.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001746 if (funcargs.ga_itemsize == 0)
1747 ga_init2(&funcargs, (int)sizeof(typval_T *), 50);
1748 for (i = 0; i < argcount; ++i)
1749 if (ga_grow(&funcargs, 1) == OK)
1750 ((typval_T **)funcargs.ga_data)[funcargs.ga_len++] =
1751 &argvars[i];
1752 }
1753
Bram Moolenaarc6538bc2019-08-03 18:17:11 +02001754 ret = call_func(name, len, rettv, argcount, argvars, funcexe);
Bram Moolenaar327d3ee2021-07-28 19:34:14 +02001755 if (in_vim9script() && did_emsg > did_emsg_before)
Bram Moolenaar6e850a62021-07-28 22:21:23 +02001756 {
Bram Moolenaar327d3ee2021-07-28 19:34:14 +02001757 // An error in a builtin function does not return FAIL, but we do
1758 // want to abort further processing if an error was given.
1759 ret = FAIL;
Bram Moolenaar6e850a62021-07-28 22:21:23 +02001760 clear_tv(rettv);
1761 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001762
1763 funcargs.ga_len -= i;
1764 }
1765 else if (!aborting())
1766 {
1767 if (argcount == MAX_FUNC_ARGS)
1768 emsg_funcname(N_("E740: Too many arguments for function %s"), name);
1769 else
1770 emsg_funcname(N_("E116: Invalid arguments for function %s"), name);
1771 }
1772
1773 while (--argcount >= 0)
1774 clear_tv(&argvars[argcount]);
1775
Bram Moolenaar8294d492020-08-10 22:40:56 +02001776 if (in_vim9script())
1777 *arg = argp;
1778 else
1779 *arg = skipwhite(argp);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001780 return ret;
1781}
1782
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001783/*
1784 * Return TRUE if "p" starts with "<SID>" or "s:".
1785 * Only works if eval_fname_script() returned non-zero for "p"!
1786 */
1787 static int
1788eval_fname_sid(char_u *p)
1789{
1790 return (*p == 's' || TOUPPER_ASC(p[2]) == 'I');
1791}
1792
1793/*
1794 * In a script change <SID>name() and s:name() to K_SNR 123_name().
1795 * Change <SNR>123_name() to K_SNR 123_name().
1796 * Use "fname_buf[FLEN_FIXED + 1]" when it fits, otherwise allocate memory
1797 * (slow).
1798 */
Bram Moolenaar5cab73f2020-02-06 19:25:19 +01001799 char_u *
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001800fname_trans_sid(char_u *name, char_u *fname_buf, char_u **tofree, int *error)
1801{
1802 int llen;
1803 char_u *fname;
1804 int i;
1805
1806 llen = eval_fname_script(name);
1807 if (llen > 0)
1808 {
1809 fname_buf[0] = K_SPECIAL;
1810 fname_buf[1] = KS_EXTRA;
1811 fname_buf[2] = (int)KE_SNR;
1812 i = 3;
Bram Moolenaare38eab22019-12-05 21:50:01 +01001813 if (eval_fname_sid(name)) // "<SID>" or "s:"
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001814 {
Bram Moolenaarf29c1c62018-09-10 21:05:02 +02001815 if (current_sctx.sc_sid <= 0)
Bram Moolenaaref140542019-12-31 21:27:13 +01001816 *error = FCERR_SCRIPT;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001817 else
1818 {
Bram Moolenaarad3ec762019-04-21 00:00:13 +02001819 sprintf((char *)fname_buf + 3, "%ld_",
1820 (long)current_sctx.sc_sid);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001821 i = (int)STRLEN(fname_buf);
1822 }
1823 }
1824 if (i + STRLEN(name + llen) < FLEN_FIXED)
1825 {
1826 STRCPY(fname_buf + i, name + llen);
1827 fname = fname_buf;
1828 }
1829 else
1830 {
Bram Moolenaar964b3742019-05-24 18:54:09 +02001831 fname = alloc(i + STRLEN(name + llen) + 1);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001832 if (fname == NULL)
Bram Moolenaaref140542019-12-31 21:27:13 +01001833 *error = FCERR_OTHER;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001834 else
1835 {
1836 *tofree = fname;
1837 mch_memmove(fname, fname_buf, (size_t)i);
1838 STRCPY(fname + i, name + llen);
1839 }
1840 }
1841 }
1842 else
1843 fname = name;
1844 return fname;
1845}
1846
1847/*
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001848 * Find a function "name" in script "sid".
1849 */
1850 static ufunc_T *
1851find_func_with_sid(char_u *name, int sid)
1852{
1853 hashitem_T *hi;
1854 char_u buffer[200];
1855
1856 buffer[0] = K_SPECIAL;
1857 buffer[1] = KS_EXTRA;
1858 buffer[2] = (int)KE_SNR;
1859 vim_snprintf((char *)buffer + 3, sizeof(buffer) - 3, "%ld_%s",
1860 (long)sid, name);
1861 hi = hash_find(&func_hashtab, buffer);
1862 if (!HASHITEM_EMPTY(hi))
1863 return HI2UF(hi);
1864
1865 return NULL;
1866}
1867
1868/*
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001869 * Find a function by name, return pointer to it in ufuncs.
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02001870 * When "is_global" is true don't find script-local or imported functions.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001871 * Return NULL for unknown function.
1872 */
Bram Moolenaarce658352020-07-31 23:47:12 +02001873 ufunc_T *
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02001874find_func_even_dead(char_u *name, int is_global, cctx_T *cctx)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001875{
1876 hashitem_T *hi;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001877 ufunc_T *func;
1878 imported_T *imported;
1879
Bram Moolenaar9721fb42020-06-11 23:10:46 +02001880 if (!is_global)
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001881 {
Bram Moolenaar333894b2020-08-01 18:53:07 +02001882 char_u *after_script = NULL;
Bram Moolenaarefa94442020-08-08 22:16:00 +02001883 long sid = 0;
Bram Moolenaar95006e32020-08-29 17:47:08 +02001884 int find_script_local = in_vim9script()
1885 && eval_isnamec1(*name) && name[1] != ':';
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001886
Bram Moolenaar95006e32020-08-29 17:47:08 +02001887 if (find_script_local)
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001888 {
Bram Moolenaar9721fb42020-06-11 23:10:46 +02001889 // Find script-local function before global one.
1890 func = find_func_with_sid(name, current_sctx.sc_sid);
1891 if (func != NULL)
1892 return func;
1893 }
1894
Bram Moolenaarefa94442020-08-08 22:16:00 +02001895 if (name[0] == K_SPECIAL
Bram Moolenaar9721fb42020-06-11 23:10:46 +02001896 && name[1] == KS_EXTRA
1897 && name[2] == KE_SNR)
1898 {
Bram Moolenaar9721fb42020-06-11 23:10:46 +02001899 // Caller changes s: to <SNR>99_name.
1900
1901 after_script = name + 3;
1902 sid = getdigits(&after_script);
Bram Moolenaarefa94442020-08-08 22:16:00 +02001903 if (*after_script == '_')
Bram Moolenaar9721fb42020-06-11 23:10:46 +02001904 ++after_script;
1905 else
1906 after_script = NULL;
1907 }
Bram Moolenaar95006e32020-08-29 17:47:08 +02001908 if (find_script_local || after_script != NULL)
Bram Moolenaar9721fb42020-06-11 23:10:46 +02001909 {
1910 // Find imported function before global one.
Bram Moolenaarefa94442020-08-08 22:16:00 +02001911 if (after_script != NULL && sid != current_sctx.sc_sid)
1912 imported = find_imported_in_script(after_script, 0, sid);
1913 else
1914 imported = find_imported(after_script == NULL
1915 ? name : after_script, 0, cctx);
Bram Moolenaar9721fb42020-06-11 23:10:46 +02001916 if (imported != NULL && imported->imp_funcname != NULL)
1917 {
1918 hi = hash_find(&func_hashtab, imported->imp_funcname);
1919 if (!HASHITEM_EMPTY(hi))
1920 return HI2UF(hi);
1921 }
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001922 }
1923 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001924
Bram Moolenaara26b9702020-04-18 19:53:28 +02001925 hi = hash_find(&func_hashtab,
1926 STRNCMP(name, "g:", 2) == 0 ? name + 2 : name);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001927 if (!HASHITEM_EMPTY(hi))
1928 return HI2UF(hi);
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001929
1930 return NULL;
1931}
1932
1933/*
1934 * Find a function by name, return pointer to it in ufuncs.
1935 * "cctx" is passed in a :def function to find imported functions.
1936 * Return NULL for unknown or dead function.
1937 */
1938 ufunc_T *
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02001939find_func(char_u *name, int is_global, cctx_T *cctx)
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001940{
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02001941 ufunc_T *fp = find_func_even_dead(name, is_global, cctx);
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01001942
1943 if (fp != NULL && (fp->uf_flags & FC_DEAD) == 0)
1944 return fp;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001945 return NULL;
1946}
1947
1948/*
Bram Moolenaar0f769812020-09-12 18:32:34 +02001949 * Return TRUE if "ufunc" is a global function.
1950 */
1951 int
1952func_is_global(ufunc_T *ufunc)
1953{
1954 return ufunc->uf_name[0] != K_SPECIAL;
1955}
1956
1957/*
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001958 * Copy the function name of "fp" to buffer "buf".
1959 * "buf" must be able to hold the function name plus three bytes.
1960 * Takes care of script-local function names.
1961 */
1962 static void
1963cat_func_name(char_u *buf, ufunc_T *fp)
1964{
Bram Moolenaar0f769812020-09-12 18:32:34 +02001965 if (!func_is_global(fp))
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001966 {
1967 STRCPY(buf, "<SNR>");
1968 STRCAT(buf, fp->uf_name + 3);
1969 }
1970 else
1971 STRCPY(buf, fp->uf_name);
1972}
1973
1974/*
1975 * Add a number variable "name" to dict "dp" with value "nr".
1976 */
1977 static void
1978add_nr_var(
1979 dict_T *dp,
1980 dictitem_T *v,
1981 char *name,
1982 varnumber_T nr)
1983{
1984 STRCPY(v->di_key, name);
1985 v->di_flags = DI_FLAGS_RO | DI_FLAGS_FIX;
1986 hash_add(&dp->dv_hashtab, DI2HIKEY(v));
1987 v->di_tv.v_type = VAR_NUMBER;
1988 v->di_tv.v_lock = VAR_FIXED;
1989 v->di_tv.vval.v_number = nr;
1990}
1991
1992/*
Bram Moolenaar209b8e32019-03-14 13:43:24 +01001993 * Free "fc".
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001994 */
Bram Moolenaar209b8e32019-03-14 13:43:24 +01001995 static void
1996free_funccal(funccall_T *fc)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02001997{
Bram Moolenaar209b8e32019-03-14 13:43:24 +01001998 int i;
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02001999
2000 for (i = 0; i < fc->fc_funcs.ga_len; ++i)
2001 {
Bram Moolenaar209b8e32019-03-14 13:43:24 +01002002 ufunc_T *fp = ((ufunc_T **)(fc->fc_funcs.ga_data))[i];
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02002003
Bram Moolenaar209b8e32019-03-14 13:43:24 +01002004 // When garbage collecting a funccall_T may be freed before the
2005 // function that references it, clear its uf_scoped field.
2006 // The function may have been redefined and point to another
2007 // funccall_T, don't clear it then.
Bram Moolenaarbc7ce672016-08-01 22:49:22 +02002008 if (fp != NULL && fp->uf_scoped == fc)
2009 fp->uf_scoped = NULL;
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02002010 }
Bram Moolenaar58016442016-07-31 18:30:22 +02002011 ga_clear(&fc->fc_funcs);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002012
Bram Moolenaar437bafe2016-08-01 15:40:54 +02002013 func_ptr_unref(fc->func);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002014 vim_free(fc);
2015}
2016
2017/*
Bram Moolenaar209b8e32019-03-14 13:43:24 +01002018 * Free "fc" and what it contains.
2019 * Can be called only when "fc" is kept beyond the period of it called,
2020 * i.e. after cleanup_function_call(fc).
2021 */
2022 static void
2023free_funccal_contents(funccall_T *fc)
2024{
2025 listitem_T *li;
2026
2027 // Free all l: variables.
2028 vars_clear(&fc->l_vars.dv_hashtab);
2029
2030 // Free all a: variables.
2031 vars_clear(&fc->l_avars.dv_hashtab);
2032
2033 // Free the a:000 variables.
Bram Moolenaaraeea7212020-04-02 18:50:46 +02002034 FOR_ALL_LIST_ITEMS(&fc->l_varlist, li)
Bram Moolenaar209b8e32019-03-14 13:43:24 +01002035 clear_tv(&li->li_tv);
2036
2037 free_funccal(fc);
2038}
2039
2040/*
Bram Moolenaar6914c642017-04-01 21:21:30 +02002041 * Handle the last part of returning from a function: free the local hashtable.
2042 * Unless it is still in use by a closure.
2043 */
2044 static void
2045cleanup_function_call(funccall_T *fc)
2046{
Bram Moolenaar209b8e32019-03-14 13:43:24 +01002047 int may_free_fc = fc->fc_refcount <= 0;
2048 int free_fc = TRUE;
2049
Bram Moolenaar6914c642017-04-01 21:21:30 +02002050 current_funccal = fc->caller;
2051
Bram Moolenaar209b8e32019-03-14 13:43:24 +01002052 // Free all l: variables if not referred.
2053 if (may_free_fc && fc->l_vars.dv_refcount == DO_NOT_FREE_CNT)
2054 vars_clear(&fc->l_vars.dv_hashtab);
2055 else
2056 free_fc = FALSE;
2057
2058 // If the a:000 list and the l: and a: dicts are not referenced and
2059 // there is no closure using it, we can free the funccall_T and what's
2060 // in it.
2061 if (may_free_fc && fc->l_avars.dv_refcount == DO_NOT_FREE_CNT)
2062 vars_clear_ext(&fc->l_avars.dv_hashtab, FALSE);
Bram Moolenaar6914c642017-04-01 21:21:30 +02002063 else
2064 {
Bram Moolenaar209b8e32019-03-14 13:43:24 +01002065 int todo;
2066 hashitem_T *hi;
2067 dictitem_T *di;
Bram Moolenaar6914c642017-04-01 21:21:30 +02002068
Bram Moolenaar209b8e32019-03-14 13:43:24 +01002069 free_fc = FALSE;
Bram Moolenaar6914c642017-04-01 21:21:30 +02002070
Bram Moolenaar209b8e32019-03-14 13:43:24 +01002071 // Make a copy of the a: variables, since we didn't do that above.
Bram Moolenaar6914c642017-04-01 21:21:30 +02002072 todo = (int)fc->l_avars.dv_hashtab.ht_used;
2073 for (hi = fc->l_avars.dv_hashtab.ht_array; todo > 0; ++hi)
2074 {
2075 if (!HASHITEM_EMPTY(hi))
2076 {
2077 --todo;
Bram Moolenaar209b8e32019-03-14 13:43:24 +01002078 di = HI2DI(hi);
2079 copy_tv(&di->di_tv, &di->di_tv);
Bram Moolenaar6914c642017-04-01 21:21:30 +02002080 }
2081 }
Bram Moolenaar209b8e32019-03-14 13:43:24 +01002082 }
Bram Moolenaar6914c642017-04-01 21:21:30 +02002083
Bram Moolenaar209b8e32019-03-14 13:43:24 +01002084 if (may_free_fc && fc->l_varlist.lv_refcount == DO_NOT_FREE_CNT)
2085 fc->l_varlist.lv_first = NULL;
2086 else
2087 {
2088 listitem_T *li;
2089
2090 free_fc = FALSE;
2091
2092 // Make a copy of the a:000 items, since we didn't do that above.
Bram Moolenaaraeea7212020-04-02 18:50:46 +02002093 FOR_ALL_LIST_ITEMS(&fc->l_varlist, li)
Bram Moolenaar6914c642017-04-01 21:21:30 +02002094 copy_tv(&li->li_tv, &li->li_tv);
Bram Moolenaar209b8e32019-03-14 13:43:24 +01002095 }
Bram Moolenaar4456ab52019-01-23 23:00:30 +01002096
Bram Moolenaar209b8e32019-03-14 13:43:24 +01002097 if (free_fc)
2098 free_funccal(fc);
2099 else
2100 {
2101 static int made_copy = 0;
2102
2103 // "fc" is still in use. This can happen when returning "a:000",
2104 // assigning "l:" to a global variable or defining a closure.
2105 // Link "fc" in the list for garbage collection later.
2106 fc->caller = previous_funccal;
2107 previous_funccal = fc;
2108
2109 if (want_garbage_collect)
2110 // If garbage collector is ready, clear count.
2111 made_copy = 0;
2112 else if (++made_copy >= (int)((4096 * 1024) / sizeof(*fc)))
Bram Moolenaar4456ab52019-01-23 23:00:30 +01002113 {
Bram Moolenaar209b8e32019-03-14 13:43:24 +01002114 // We have made a lot of copies, worth 4 Mbyte. This can happen
2115 // when repetitively calling a function that creates a reference to
Bram Moolenaar889da2f2019-02-02 14:02:30 +01002116 // itself somehow. Call the garbage collector soon to avoid using
Bram Moolenaar4456ab52019-01-23 23:00:30 +01002117 // too much memory.
2118 made_copy = 0;
Bram Moolenaar889da2f2019-02-02 14:02:30 +01002119 want_garbage_collect = TRUE;
Bram Moolenaar4456ab52019-01-23 23:00:30 +01002120 }
Bram Moolenaar6914c642017-04-01 21:21:30 +02002121 }
2122}
Bram Moolenaarfdeab652020-09-19 15:16:50 +02002123
2124/*
2125 * There are two kinds of function names:
2126 * 1. ordinary names, function defined with :function or :def
2127 * 2. numbered functions and lambdas
2128 * For the first we only count the name stored in func_hashtab as a reference,
2129 * using function() does not count as a reference, because the function is
2130 * looked up by name.
2131 */
Bram Moolenaara05e5242020-09-19 18:19:19 +02002132 int
Bram Moolenaarfdeab652020-09-19 15:16:50 +02002133func_name_refcount(char_u *name)
2134{
2135 return isdigit(*name) || *name == '<';
2136}
2137
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002138/*
2139 * Unreference "fc": decrement the reference count and free it when it
2140 * becomes zero. "fp" is detached from "fc".
2141 * When "force" is TRUE we are exiting.
2142 */
2143 static void
2144funccal_unref(funccall_T *fc, ufunc_T *fp, int force)
2145{
2146 funccall_T **pfc;
2147 int i;
2148
2149 if (fc == NULL)
2150 return;
2151
2152 if (--fc->fc_refcount <= 0 && (force || (
2153 fc->l_varlist.lv_refcount == DO_NOT_FREE_CNT
2154 && fc->l_vars.dv_refcount == DO_NOT_FREE_CNT
2155 && fc->l_avars.dv_refcount == DO_NOT_FREE_CNT)))
2156 for (pfc = &previous_funccal; *pfc != NULL; pfc = &(*pfc)->caller)
2157 {
2158 if (fc == *pfc)
2159 {
2160 *pfc = fc->caller;
2161 free_funccal_contents(fc);
2162 return;
2163 }
2164 }
2165 for (i = 0; i < fc->fc_funcs.ga_len; ++i)
2166 if (((ufunc_T **)(fc->fc_funcs.ga_data))[i] == fp)
2167 ((ufunc_T **)(fc->fc_funcs.ga_data))[i] = NULL;
2168}
2169
2170/*
2171 * Remove the function from the function hashtable. If the function was
2172 * deleted while it still has references this was already done.
2173 * Return TRUE if the entry was deleted, FALSE if it wasn't found.
2174 */
2175 static int
2176func_remove(ufunc_T *fp)
2177{
2178 hashitem_T *hi;
2179
2180 // Return if it was already virtually deleted.
2181 if (fp->uf_flags & FC_DEAD)
2182 return FALSE;
2183
2184 hi = hash_find(&func_hashtab, UF2HIKEY(fp));
2185 if (!HASHITEM_EMPTY(hi))
2186 {
2187 // When there is a def-function index do not actually remove the
2188 // function, so we can find the index when defining the function again.
Bram Moolenaar38ddf332020-07-31 22:05:04 +02002189 // Do remove it when it's a copy.
2190 if (fp->uf_def_status == UF_COMPILED && (fp->uf_flags & FC_COPY) == 0)
Bram Moolenaarc970e422021-03-17 15:03:04 +01002191 {
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002192 fp->uf_flags |= FC_DEAD;
Bram Moolenaarc970e422021-03-17 15:03:04 +01002193 return FALSE;
2194 }
2195 hash_remove(&func_hashtab, hi);
2196 fp->uf_flags |= FC_DELETED;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002197 return TRUE;
2198 }
2199 return FALSE;
2200}
2201
2202 static void
2203func_clear_items(ufunc_T *fp)
2204{
2205 ga_clear_strings(&(fp->uf_args));
2206 ga_clear_strings(&(fp->uf_def_args));
2207 ga_clear_strings(&(fp->uf_lines));
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002208 VIM_CLEAR(fp->uf_arg_types);
Bram Moolenaarfbbcd002020-10-15 12:46:44 +02002209 VIM_CLEAR(fp->uf_block_ids);
Bram Moolenaar292b90d2020-03-18 15:23:16 +01002210 VIM_CLEAR(fp->uf_va_name);
Bram Moolenaar6110e792020-07-08 19:35:21 +02002211 clear_type_list(&fp->uf_type_list);
Bram Moolenaar0d3de8c2021-01-22 20:46:27 +01002212
2213 // Increment the refcount of this function to avoid it being freed
2214 // recursively when the partial is freed.
2215 fp->uf_refcount += 3;
Bram Moolenaarf112f302020-12-20 17:47:52 +01002216 partial_unref(fp->uf_partial);
2217 fp->uf_partial = NULL;
Bram Moolenaar0d3de8c2021-01-22 20:46:27 +01002218 fp->uf_refcount -= 3;
Bram Moolenaar801ab062020-06-25 19:27:56 +02002219
2220#ifdef FEAT_LUA
2221 if (fp->uf_cb_free != NULL)
2222 {
2223 fp->uf_cb_free(fp->uf_cb_state);
2224 fp->uf_cb_free = NULL;
2225 }
2226
2227 fp->uf_cb_state = NULL;
2228 fp->uf_cb = NULL;
2229#endif
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002230#ifdef FEAT_PROFILE
2231 VIM_CLEAR(fp->uf_tml_count);
2232 VIM_CLEAR(fp->uf_tml_total);
2233 VIM_CLEAR(fp->uf_tml_self);
2234#endif
2235}
2236
2237/*
2238 * Free all things that a function contains. Does not free the function
2239 * itself, use func_free() for that.
2240 * When "force" is TRUE we are exiting.
2241 */
2242 static void
2243func_clear(ufunc_T *fp, int force)
2244{
2245 if (fp->uf_cleared)
2246 return;
2247 fp->uf_cleared = TRUE;
2248
2249 // clear this function
2250 func_clear_items(fp);
2251 funccal_unref(fp->uf_scoped, fp, force);
Bram Moolenaarcd45ed02020-12-22 17:35:54 +01002252 unlink_def_function(fp);
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002253}
2254
2255/*
2256 * Free a function and remove it from the list of functions. Does not free
2257 * what a function contains, call func_clear() first.
Bram Moolenaarf7779c62020-05-03 15:38:16 +02002258 * When "force" is TRUE we are exiting.
Bram Moolenaara05e5242020-09-19 18:19:19 +02002259 * Returns OK when the function was actually freed.
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002260 */
Bram Moolenaara05e5242020-09-19 18:19:19 +02002261 static int
Bram Moolenaarf7779c62020-05-03 15:38:16 +02002262func_free(ufunc_T *fp, int force)
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002263{
2264 // Only remove it when not done already, otherwise we would remove a newer
2265 // version of the function with the same name.
2266 if ((fp->uf_flags & (FC_DELETED | FC_REMOVED)) == 0)
2267 func_remove(fp);
2268
Bram Moolenaarf7779c62020-05-03 15:38:16 +02002269 if ((fp->uf_flags & FC_DEAD) == 0 || force)
Bram Moolenaarc4ce36d2020-08-14 17:08:15 +02002270 {
Bram Moolenaarfdeab652020-09-19 15:16:50 +02002271 if (fp->uf_dfunc_idx > 0)
2272 unlink_def_function(fp);
Bram Moolenaarc4ce36d2020-08-14 17:08:15 +02002273 VIM_CLEAR(fp->uf_name_exp);
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002274 vim_free(fp);
Bram Moolenaara05e5242020-09-19 18:19:19 +02002275 return OK;
Bram Moolenaarc4ce36d2020-08-14 17:08:15 +02002276 }
Bram Moolenaara05e5242020-09-19 18:19:19 +02002277 return FAIL;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002278}
2279
2280/*
2281 * Free all things that a function contains and free the function itself.
2282 * When "force" is TRUE we are exiting.
2283 */
2284 static void
2285func_clear_free(ufunc_T *fp, int force)
2286{
2287 func_clear(fp, force);
Bram Moolenaarfdeab652020-09-19 15:16:50 +02002288 if (force || fp->uf_dfunc_idx == 0 || func_name_refcount(fp->uf_name)
2289 || (fp->uf_flags & FC_COPY))
Bram Moolenaar0cb5bcf2020-06-20 18:19:09 +02002290 func_free(fp, force);
Bram Moolenaar925e9fd2020-07-25 15:41:11 +02002291 else
2292 fp->uf_flags |= FC_DEAD;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002293}
2294
Bram Moolenaar38ddf332020-07-31 22:05:04 +02002295/*
2296 * Copy already defined function "lambda" to a new function with name "global".
2297 * This is for when a compiled function defines a global function.
2298 */
Bram Moolenaarcd45ed02020-12-22 17:35:54 +01002299 int
2300copy_func(char_u *lambda, char_u *global, ectx_T *ectx)
Bram Moolenaar38ddf332020-07-31 22:05:04 +02002301{
2302 ufunc_T *ufunc = find_func_even_dead(lambda, TRUE, NULL);
Bram Moolenaarf112f302020-12-20 17:47:52 +01002303 ufunc_T *fp = NULL;
Bram Moolenaar38ddf332020-07-31 22:05:04 +02002304
2305 if (ufunc == NULL)
Bram Moolenaar38ddf332020-07-31 22:05:04 +02002306 {
Bram Moolenaarcd45ed02020-12-22 17:35:54 +01002307 semsg(_(e_lambda_function_not_found_str), lambda);
2308 return FAIL;
Bram Moolenaar38ddf332020-07-31 22:05:04 +02002309 }
Bram Moolenaarcd45ed02020-12-22 17:35:54 +01002310
Bram Moolenaarcd45ed02020-12-22 17:35:54 +01002311 fp = find_func(global, TRUE, NULL);
2312 if (fp != NULL)
2313 {
Bram Moolenaar0d3de8c2021-01-22 20:46:27 +01002314 // TODO: handle ! to overwrite
Bram Moolenaarcd45ed02020-12-22 17:35:54 +01002315 semsg(_(e_funcexts), global);
2316 return FAIL;
2317 }
2318
2319 fp = alloc_clear(offsetof(ufunc_T, uf_name) + STRLEN(global) + 1);
2320 if (fp == NULL)
2321 return FAIL;
2322
2323 fp->uf_varargs = ufunc->uf_varargs;
2324 fp->uf_flags = (ufunc->uf_flags & ~FC_VIM9) | FC_COPY;
2325 fp->uf_def_status = ufunc->uf_def_status;
2326 fp->uf_dfunc_idx = ufunc->uf_dfunc_idx;
2327 if (ga_copy_strings(&ufunc->uf_args, &fp->uf_args) == FAIL
2328 || ga_copy_strings(&ufunc->uf_def_args, &fp->uf_def_args)
2329 == FAIL
2330 || ga_copy_strings(&ufunc->uf_lines, &fp->uf_lines) == FAIL)
2331 goto failed;
2332
2333 fp->uf_name_exp = ufunc->uf_name_exp == NULL ? NULL
2334 : vim_strsave(ufunc->uf_name_exp);
2335 if (ufunc->uf_arg_types != NULL)
2336 {
2337 fp->uf_arg_types = ALLOC_MULT(type_T *, fp->uf_args.ga_len);
2338 if (fp->uf_arg_types == NULL)
2339 goto failed;
2340 mch_memmove(fp->uf_arg_types, ufunc->uf_arg_types,
2341 sizeof(type_T *) * fp->uf_args.ga_len);
2342 }
Bram Moolenaarcd45ed02020-12-22 17:35:54 +01002343 if (ufunc->uf_va_name != NULL)
2344 {
2345 fp->uf_va_name = vim_strsave(ufunc->uf_va_name);
2346 if (fp->uf_va_name == NULL)
2347 goto failed;
2348 }
2349 fp->uf_ret_type = ufunc->uf_ret_type;
2350
2351 fp->uf_refcount = 1;
2352 STRCPY(fp->uf_name, global);
2353 hash_add(&func_hashtab, UF2HIKEY(fp));
2354
2355 // the referenced dfunc_T is now used one more time
2356 link_def_function(fp);
2357
Bram Moolenaar0d3de8c2021-01-22 20:46:27 +01002358 // Create a partial to store the context of the function where it was
2359 // instantiated. Only needs to be done once. Do this on the original
2360 // function, "dfunc->df_ufunc" will point to it.
Bram Moolenaarcd45ed02020-12-22 17:35:54 +01002361 if ((ufunc->uf_flags & FC_CLOSURE) && ufunc->uf_partial == NULL)
2362 {
2363 partial_T *pt = ALLOC_CLEAR_ONE(partial_T);
2364
2365 if (pt == NULL)
2366 goto failed;
2367 if (fill_partial_and_closure(pt, ufunc, ectx) == FAIL)
Bram Moolenaar0d3de8c2021-01-22 20:46:27 +01002368 {
2369 vim_free(pt);
Bram Moolenaarcd45ed02020-12-22 17:35:54 +01002370 goto failed;
Bram Moolenaar0d3de8c2021-01-22 20:46:27 +01002371 }
Bram Moolenaarcd45ed02020-12-22 17:35:54 +01002372 ufunc->uf_partial = pt;
Bram Moolenaar0d3de8c2021-01-22 20:46:27 +01002373 --pt->pt_refcount; // not actually referenced here
Bram Moolenaarcd45ed02020-12-22 17:35:54 +01002374 }
2375
2376 return OK;
Bram Moolenaar38ddf332020-07-31 22:05:04 +02002377
2378failed:
2379 func_clear_free(fp, TRUE);
Bram Moolenaarcd45ed02020-12-22 17:35:54 +01002380 return FAIL;
Bram Moolenaar38ddf332020-07-31 22:05:04 +02002381}
2382
Bram Moolenaar0ba48e82020-11-17 18:23:19 +01002383static int funcdepth = 0;
2384
2385/*
2386 * Increment the function call depth count.
2387 * Return FAIL when going over 'maxfuncdepth'.
2388 * Otherwise return OK, must call funcdepth_decrement() later!
2389 */
2390 int
2391funcdepth_increment(void)
2392{
2393 if (funcdepth >= p_mfd)
2394 {
2395 emsg(_("E132: Function call depth is higher than 'maxfuncdepth'"));
2396 return FAIL;
2397 }
2398 ++funcdepth;
2399 return OK;
2400}
2401
2402 void
2403funcdepth_decrement(void)
2404{
2405 --funcdepth;
2406}
2407
2408/*
2409 * Get the current function call depth.
2410 */
2411 int
2412funcdepth_get(void)
2413{
2414 return funcdepth;
2415}
2416
2417/*
2418 * Restore the function call depth. This is for cases where there is no
Bram Moolenaar8e7d6222020-12-18 19:49:56 +01002419 * guarantee funcdepth_decrement() can be called exactly the same number of
Bram Moolenaar0ba48e82020-11-17 18:23:19 +01002420 * times as funcdepth_increment().
2421 */
2422 void
2423funcdepth_restore(int depth)
2424{
2425 funcdepth = depth;
2426}
Bram Moolenaar6914c642017-04-01 21:21:30 +02002427
2428/*
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002429 * Call a user function.
2430 */
2431 static void
2432call_user_func(
Bram Moolenaare38eab22019-12-05 21:50:01 +01002433 ufunc_T *fp, // pointer to function
2434 int argcount, // nr of args
2435 typval_T *argvars, // arguments
2436 typval_T *rettv, // return value
Bram Moolenaar6f5b6df2020-05-16 21:20:12 +02002437 funcexe_T *funcexe, // context
Bram Moolenaare38eab22019-12-05 21:50:01 +01002438 dict_T *selfdict) // Dictionary for "self"
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002439{
Bram Moolenaarf29c1c62018-09-10 21:05:02 +02002440 sctx_T save_current_sctx;
Bram Moolenaar93343722018-07-10 19:39:18 +02002441 int using_sandbox = FALSE;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002442 funccall_T *fc;
2443 int save_did_emsg;
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02002444 int default_arg_err = FALSE;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002445 dictitem_T *v;
Bram Moolenaare38eab22019-12-05 21:50:01 +01002446 int fixvar_idx = 0; // index in fixvar[]
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002447 int i;
2448 int ai;
2449 int islambda = FALSE;
2450 char_u numbuf[NUMBUFLEN];
2451 char_u *name;
Bram Moolenaarb47bed22021-04-14 17:06:43 +02002452 typval_T *tv_to_free[MAX_FUNC_ARGS];
2453 int tv_to_free_len = 0;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002454#ifdef FEAT_PROFILE
Bram Moolenaarb2049902021-01-24 12:53:53 +01002455 profinfo_T profile_info;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002456#endif
Bram Moolenaare31ee862020-01-07 20:59:34 +01002457 ESTACK_CHECK_DECLARATION
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002458
Bram Moolenaarb2049902021-01-24 12:53:53 +01002459#ifdef FEAT_PROFILE
2460 CLEAR_FIELD(profile_info);
2461#endif
2462
Bram Moolenaar0ba48e82020-11-17 18:23:19 +01002463 // If depth of calling is getting too high, don't execute the function.
2464 if (funcdepth_increment() == FAIL)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002465 {
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002466 rettv->v_type = VAR_NUMBER;
2467 rettv->vval.v_number = -1;
2468 return;
2469 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002470
Bram Moolenaare38eab22019-12-05 21:50:01 +01002471 line_breakcheck(); // check for CTRL-C hit
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002472
Bram Moolenaarc799fe22019-05-28 23:08:19 +02002473 fc = ALLOC_CLEAR_ONE(funccall_T);
Bram Moolenaar4456ab52019-01-23 23:00:30 +01002474 if (fc == NULL)
2475 return;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002476 fc->caller = current_funccal;
2477 current_funccal = fc;
2478 fc->func = fp;
2479 fc->rettv = rettv;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002480 fc->level = ex_nesting_level;
Bram Moolenaare38eab22019-12-05 21:50:01 +01002481 // Check if this function has a breakpoint.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002482 fc->breakpoint = dbg_find_breakpoint(FALSE, fp->uf_name, (linenr_T)0);
2483 fc->dbg_tick = debug_tick;
Bram Moolenaare38eab22019-12-05 21:50:01 +01002484 // Set up fields for closure.
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02002485 ga_init2(&fc->fc_funcs, sizeof(ufunc_T *), 1);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02002486 func_ptr_ref(fp);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002487
Bram Moolenaar0cb5bcf2020-06-20 18:19:09 +02002488 if (fp->uf_def_status != UF_NOT_COMPILED)
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002489 {
Bram Moolenaar12d26532021-02-19 19:13:21 +01002490#ifdef FEAT_PROFILE
2491 ufunc_T *caller = fc->caller == NULL ? NULL : fc->caller->func;
2492#endif
Bram Moolenaar25e0f582020-05-25 22:36:50 +02002493 // Execute the function, possibly compiling it first.
Bram Moolenaarb2049902021-01-24 12:53:53 +01002494#ifdef FEAT_PROFILE
Bram Moolenaar12d26532021-02-19 19:13:21 +01002495 if (do_profiling == PROF_YES)
2496 profile_may_start_func(&profile_info, fp, caller);
Bram Moolenaarb2049902021-01-24 12:53:53 +01002497#endif
Bram Moolenaar6f5b6df2020-05-16 21:20:12 +02002498 call_def_function(fp, argcount, argvars, funcexe->partial, rettv);
Bram Moolenaar0ba48e82020-11-17 18:23:19 +01002499 funcdepth_decrement();
Bram Moolenaarb2049902021-01-24 12:53:53 +01002500#ifdef FEAT_PROFILE
2501 if (do_profiling == PROF_YES && (fp->uf_profiling
Bram Moolenaar12d26532021-02-19 19:13:21 +01002502 || (caller != NULL && caller->uf_profiling)))
2503 profile_may_end_func(&profile_info, fp, caller);
Bram Moolenaarb2049902021-01-24 12:53:53 +01002504#endif
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002505 current_funccal = fc->caller;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002506 free_funccal(fc);
2507 return;
2508 }
2509
Bram Moolenaar38453522021-11-28 22:00:12 +00002510 islambda = fp->uf_flags & FC_LAMBDA;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002511
2512 /*
2513 * Note about using fc->fixvar[]: This is an array of FIXVAR_CNT variables
2514 * with names up to VAR_SHORT_LEN long. This avoids having to alloc/free
2515 * each argument variable and saves a lot of time.
2516 */
2517 /*
2518 * Init l: variables.
2519 */
2520 init_var_dict(&fc->l_vars, &fc->l_vars_var, VAR_DEF_SCOPE);
2521 if (selfdict != NULL)
2522 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01002523 // Set l:self to "selfdict". Use "name" to avoid a warning from
2524 // some compiler that checks the destination size.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002525 v = &fc->fixvar[fixvar_idx++].var;
2526 name = v->di_key;
2527 STRCPY(name, "self");
Bram Moolenaar31b81602019-02-10 22:14:27 +01002528 v->di_flags = DI_FLAGS_RO | DI_FLAGS_FIX;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002529 hash_add(&fc->l_vars.dv_hashtab, DI2HIKEY(v));
2530 v->di_tv.v_type = VAR_DICT;
2531 v->di_tv.v_lock = 0;
2532 v->di_tv.vval.v_dict = selfdict;
2533 ++selfdict->dv_refcount;
2534 }
2535
2536 /*
Bram Moolenaarf10806b2020-04-02 18:34:35 +02002537 * Init a: variables, unless none found (in lambda).
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02002538 * Set a:0 to "argcount" less number of named arguments, if >= 0.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002539 * Set a:000 to a list with room for the "..." arguments.
2540 */
2541 init_var_dict(&fc->l_avars, &fc->l_avars_var, VAR_SCOPE);
Bram Moolenaarf10806b2020-04-02 18:34:35 +02002542 if ((fp->uf_flags & FC_NOARGS) == 0)
2543 add_nr_var(&fc->l_avars, &fc->fixvar[fixvar_idx++].var, "0",
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02002544 (varnumber_T)(argcount >= fp->uf_args.ga_len
2545 ? argcount - fp->uf_args.ga_len : 0));
Bram Moolenaar31b81602019-02-10 22:14:27 +01002546 fc->l_avars.dv_lock = VAR_FIXED;
Bram Moolenaarf10806b2020-04-02 18:34:35 +02002547 if ((fp->uf_flags & FC_NOARGS) == 0)
2548 {
2549 // Use "name" to avoid a warning from some compiler that checks the
2550 // destination size.
2551 v = &fc->fixvar[fixvar_idx++].var;
2552 name = v->di_key;
2553 STRCPY(name, "000");
2554 v->di_flags = DI_FLAGS_RO | DI_FLAGS_FIX;
2555 hash_add(&fc->l_avars.dv_hashtab, DI2HIKEY(v));
2556 v->di_tv.v_type = VAR_LIST;
2557 v->di_tv.v_lock = VAR_FIXED;
2558 v->di_tv.vval.v_list = &fc->l_varlist;
2559 }
Bram Moolenaara80faa82020-04-12 19:37:17 +02002560 CLEAR_FIELD(fc->l_varlist);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002561 fc->l_varlist.lv_refcount = DO_NOT_FREE_CNT;
2562 fc->l_varlist.lv_lock = VAR_FIXED;
2563
2564 /*
2565 * Set a:firstline to "firstline" and a:lastline to "lastline".
2566 * Set a:name to named arguments.
2567 * Set a:N to the "..." arguments.
Bram Moolenaarf10806b2020-04-02 18:34:35 +02002568 * Skipped when no a: variables used (in lambda).
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002569 */
Bram Moolenaarf10806b2020-04-02 18:34:35 +02002570 if ((fp->uf_flags & FC_NOARGS) == 0)
2571 {
2572 add_nr_var(&fc->l_avars, &fc->fixvar[fixvar_idx++].var, "firstline",
Bram Moolenaar6f5b6df2020-05-16 21:20:12 +02002573 (varnumber_T)funcexe->firstline);
Bram Moolenaarf10806b2020-04-02 18:34:35 +02002574 add_nr_var(&fc->l_avars, &fc->fixvar[fixvar_idx++].var, "lastline",
Bram Moolenaar6f5b6df2020-05-16 21:20:12 +02002575 (varnumber_T)funcexe->lastline);
Bram Moolenaarf10806b2020-04-02 18:34:35 +02002576 }
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02002577 for (i = 0; i < argcount || i < fp->uf_args.ga_len; ++i)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002578 {
2579 int addlocal = FALSE;
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02002580 typval_T def_rettv;
2581 int isdefault = FALSE;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002582
2583 ai = i - fp->uf_args.ga_len;
2584 if (ai < 0)
2585 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01002586 // named argument a:name
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002587 name = FUNCARG(fp, i);
2588 if (islambda)
2589 addlocal = TRUE;
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02002590
2591 // evaluate named argument default expression
2592 isdefault = ai + fp->uf_def_args.ga_len >= 0
2593 && (i >= argcount || (argvars[i].v_type == VAR_SPECIAL
2594 && argvars[i].vval.v_number == VVAL_NONE));
2595 if (isdefault)
2596 {
2597 char_u *default_expr = NULL;
Bram Moolenaarb47bed22021-04-14 17:06:43 +02002598
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02002599 def_rettv.v_type = VAR_NUMBER;
2600 def_rettv.vval.v_number = -1;
2601
2602 default_expr = ((char_u **)(fp->uf_def_args.ga_data))
2603 [ai + fp->uf_def_args.ga_len];
Bram Moolenaar5409f5d2020-06-24 18:37:35 +02002604 if (eval1(&default_expr, &def_rettv, &EVALARG_EVALUATE) == FAIL)
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02002605 {
2606 default_arg_err = 1;
2607 break;
2608 }
2609 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002610 }
2611 else
2612 {
Bram Moolenaarf10806b2020-04-02 18:34:35 +02002613 if ((fp->uf_flags & FC_NOARGS) != 0)
2614 // Bail out if no a: arguments used (in lambda).
2615 break;
2616
Bram Moolenaare38eab22019-12-05 21:50:01 +01002617 // "..." argument a:1, a:2, etc.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002618 sprintf((char *)numbuf, "%d", ai + 1);
2619 name = numbuf;
2620 }
2621 if (fixvar_idx < FIXVAR_CNT && STRLEN(name) <= VAR_SHORT_LEN)
2622 {
2623 v = &fc->fixvar[fixvar_idx++].var;
2624 v->di_flags = DI_FLAGS_RO | DI_FLAGS_FIX;
Bram Moolenaar209b8e32019-03-14 13:43:24 +01002625 STRCPY(v->di_key, name);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002626 }
2627 else
2628 {
Bram Moolenaar209b8e32019-03-14 13:43:24 +01002629 v = dictitem_alloc(name);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002630 if (v == NULL)
2631 break;
Bram Moolenaar209b8e32019-03-14 13:43:24 +01002632 v->di_flags |= DI_FLAGS_RO | DI_FLAGS_FIX;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002633 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002634
Bram Moolenaar6e5000d2019-06-17 21:18:41 +02002635 // Note: the values are copied directly to avoid alloc/free.
2636 // "argvars" must have VAR_FIXED for v_lock.
2637 v->di_tv = isdefault ? def_rettv : argvars[i];
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002638 v->di_tv.v_lock = VAR_FIXED;
2639
Bram Moolenaarb47bed22021-04-14 17:06:43 +02002640 if (isdefault)
2641 // Need to free this later, no matter where it's stored.
2642 tv_to_free[tv_to_free_len++] = &v->di_tv;
2643
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002644 if (addlocal)
2645 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01002646 // Named arguments should be accessed without the "a:" prefix in
2647 // lambda expressions. Add to the l: dict.
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02002648 copy_tv(&v->di_tv, &v->di_tv);
2649 hash_add(&fc->l_vars.dv_hashtab, DI2HIKEY(v));
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002650 }
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02002651 else
2652 hash_add(&fc->l_avars.dv_hashtab, DI2HIKEY(v));
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002653
2654 if (ai >= 0 && ai < MAX_FUNC_ARGS)
2655 {
Bram Moolenaar209b8e32019-03-14 13:43:24 +01002656 listitem_T *li = &fc->l_listitems[ai];
2657
2658 li->li_tv = argvars[i];
2659 li->li_tv.v_lock = VAR_FIXED;
2660 list_append(&fc->l_varlist, li);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002661 }
2662 }
2663
Bram Moolenaare38eab22019-12-05 21:50:01 +01002664 // Don't redraw while executing the function.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002665 ++RedrawingDisabled;
Bram Moolenaar93343722018-07-10 19:39:18 +02002666
2667 if (fp->uf_flags & FC_SANDBOX)
2668 {
2669 using_sandbox = TRUE;
2670 ++sandbox;
2671 }
2672
Bram Moolenaar25e0f582020-05-25 22:36:50 +02002673 estack_push_ufunc(fp, 1);
Bram Moolenaare31ee862020-01-07 20:59:34 +01002674 ESTACK_CHECK_SETUP
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01002675 if (p_verbose >= 12)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002676 {
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01002677 ++no_wait_return;
2678 verbose_enter_scroll();
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002679
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01002680 smsg(_("calling %s"), SOURCING_NAME);
2681 if (p_verbose >= 14)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002682 {
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01002683 char_u buf[MSG_BUF_LEN];
2684 char_u numbuf2[NUMBUFLEN];
2685 char_u *tofree;
2686 char_u *s;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002687
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01002688 msg_puts("(");
2689 for (i = 0; i < argcount; ++i)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002690 {
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01002691 if (i > 0)
2692 msg_puts(", ");
2693 if (argvars[i].v_type == VAR_NUMBER)
2694 msg_outnum((long)argvars[i].vval.v_number);
2695 else
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002696 {
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01002697 // Do not want errors such as E724 here.
2698 ++emsg_off;
2699 s = tv2string(&argvars[i], &tofree, numbuf2, 0);
2700 --emsg_off;
2701 if (s != NULL)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002702 {
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01002703 if (vim_strsize(s) > MSG_BUF_CLEN)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002704 {
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01002705 trunc_string(s, buf, MSG_BUF_CLEN, MSG_BUF_LEN);
2706 s = buf;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002707 }
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01002708 msg_puts((char *)s);
2709 vim_free(tofree);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002710 }
2711 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002712 }
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01002713 msg_puts(")");
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002714 }
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01002715 msg_puts("\n"); // don't overwrite this either
2716
2717 verbose_leave_scroll();
2718 --no_wait_return;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002719 }
2720#ifdef FEAT_PROFILE
Bram Moolenaar12d26532021-02-19 19:13:21 +01002721 if (do_profiling == PROF_YES)
2722 profile_may_start_func(&profile_info, fp,
2723 fc->caller == NULL ? NULL : fc->caller->func);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002724#endif
2725
Bram Moolenaarf29c1c62018-09-10 21:05:02 +02002726 save_current_sctx = current_sctx;
2727 current_sctx = fp->uf_script_ctx;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002728 save_did_emsg = did_emsg;
2729 did_emsg = FALSE;
2730
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02002731 if (default_arg_err && (fp->uf_flags & FC_ABORT))
2732 did_emsg = TRUE;
Bram Moolenaarf10806b2020-04-02 18:34:35 +02002733 else if (islambda)
2734 {
2735 char_u *p = *(char_u **)fp->uf_lines.ga_data + 7;
2736
2737 // A Lambda always has the command "return {expr}". It is much faster
2738 // to evaluate {expr} directly.
2739 ++ex_nesting_level;
Bram Moolenaar5409f5d2020-06-24 18:37:35 +02002740 (void)eval1(&p, rettv, &EVALARG_EVALUATE);
Bram Moolenaarf10806b2020-04-02 18:34:35 +02002741 --ex_nesting_level;
2742 }
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02002743 else
2744 // call do_cmdline() to execute the lines
2745 do_cmdline(NULL, get_func_line, (void *)fc,
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002746 DOCMD_NOWAIT|DOCMD_VERBOSE|DOCMD_REPEAT);
2747
2748 --RedrawingDisabled;
2749
Bram Moolenaare38eab22019-12-05 21:50:01 +01002750 // when the function was aborted because of an error, return -1
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002751 if ((did_emsg && (fp->uf_flags & FC_ABORT)) || rettv->v_type == VAR_UNKNOWN)
2752 {
2753 clear_tv(rettv);
2754 rettv->v_type = VAR_NUMBER;
2755 rettv->vval.v_number = -1;
2756 }
2757
2758#ifdef FEAT_PROFILE
Bram Moolenaar12d26532021-02-19 19:13:21 +01002759 if (do_profiling == PROF_YES)
2760 {
2761 ufunc_T *caller = fc->caller == NULL ? NULL : fc->caller->func;
2762
2763 if (fp->uf_profiling || (caller != NULL && caller->uf_profiling))
2764 profile_may_end_func(&profile_info, fp, caller);
2765 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002766#endif
2767
Bram Moolenaare38eab22019-12-05 21:50:01 +01002768 // when being verbose, mention the return value
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002769 if (p_verbose >= 12)
2770 {
2771 ++no_wait_return;
2772 verbose_enter_scroll();
2773
2774 if (aborting())
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01002775 smsg(_("%s aborted"), SOURCING_NAME);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002776 else if (fc->rettv->v_type == VAR_NUMBER)
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01002777 smsg(_("%s returning #%ld"), SOURCING_NAME,
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002778 (long)fc->rettv->vval.v_number);
2779 else
2780 {
2781 char_u buf[MSG_BUF_LEN];
2782 char_u numbuf2[NUMBUFLEN];
2783 char_u *tofree;
2784 char_u *s;
2785
Bram Moolenaare38eab22019-12-05 21:50:01 +01002786 // The value may be very long. Skip the middle part, so that we
2787 // have some idea how it starts and ends. smsg() would always
2788 // truncate it at the end. Don't want errors such as E724 here.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002789 ++emsg_off;
2790 s = tv2string(fc->rettv, &tofree, numbuf2, 0);
2791 --emsg_off;
2792 if (s != NULL)
2793 {
2794 if (vim_strsize(s) > MSG_BUF_CLEN)
2795 {
2796 trunc_string(s, buf, MSG_BUF_CLEN, MSG_BUF_LEN);
2797 s = buf;
2798 }
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01002799 smsg(_("%s returning %s"), SOURCING_NAME, s);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002800 vim_free(tofree);
2801 }
2802 }
Bram Moolenaare38eab22019-12-05 21:50:01 +01002803 msg_puts("\n"); // don't overwrite this either
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002804
2805 verbose_leave_scroll();
2806 --no_wait_return;
2807 }
2808
Bram Moolenaare31ee862020-01-07 20:59:34 +01002809 ESTACK_CHECK_NOW
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01002810 estack_pop();
Bram Moolenaarf29c1c62018-09-10 21:05:02 +02002811 current_sctx = save_current_sctx;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002812#ifdef FEAT_PROFILE
2813 if (do_profiling == PROF_YES)
Bram Moolenaarb2049902021-01-24 12:53:53 +01002814 script_prof_restore(&profile_info.pi_wait_start);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002815#endif
Bram Moolenaar93343722018-07-10 19:39:18 +02002816 if (using_sandbox)
2817 --sandbox;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002818
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01002819 if (p_verbose >= 12 && SOURCING_NAME != NULL)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002820 {
2821 ++no_wait_return;
2822 verbose_enter_scroll();
2823
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01002824 smsg(_("continuing in %s"), SOURCING_NAME);
Bram Moolenaare38eab22019-12-05 21:50:01 +01002825 msg_puts("\n"); // don't overwrite this either
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002826
2827 verbose_leave_scroll();
2828 --no_wait_return;
2829 }
2830
2831 did_emsg |= save_did_emsg;
Bram Moolenaar0ba48e82020-11-17 18:23:19 +01002832 funcdepth_decrement();
Bram Moolenaarb47bed22021-04-14 17:06:43 +02002833 for (i = 0; i < tv_to_free_len; ++i)
2834 clear_tv(tv_to_free[i]);
Bram Moolenaar6914c642017-04-01 21:21:30 +02002835 cleanup_function_call(fc);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002836}
2837
2838/*
Bram Moolenaar50824712020-12-20 21:10:17 +01002839 * Check the argument count for user function "fp".
2840 * Return FCERR_UNKNOWN if OK, FCERR_TOOFEW or FCERR_TOOMANY otherwise.
2841 */
2842 int
2843check_user_func_argcount(ufunc_T *fp, int argcount)
2844{
2845 int regular_args = fp->uf_args.ga_len;
2846
2847 if (argcount < regular_args - fp->uf_def_args.ga_len)
2848 return FCERR_TOOFEW;
2849 else if (!has_varargs(fp) && argcount > regular_args)
2850 return FCERR_TOOMANY;
2851 return FCERR_UNKNOWN;
2852}
2853
2854/*
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002855 * Call a user function after checking the arguments.
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02002856 */
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002857 int
2858call_user_func_check(
2859 ufunc_T *fp,
2860 int argcount,
2861 typval_T *argvars,
2862 typval_T *rettv,
2863 funcexe_T *funcexe,
2864 dict_T *selfdict)
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02002865{
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002866 int error;
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02002867
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002868 if (fp->uf_flags & FC_RANGE && funcexe->doesrange != NULL)
2869 *funcexe->doesrange = TRUE;
Bram Moolenaar50824712020-12-20 21:10:17 +01002870 error = check_user_func_argcount(fp, argcount);
2871 if (error != FCERR_UNKNOWN)
2872 return error;
2873 if ((fp->uf_flags & FC_DICT) && selfdict == NULL)
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002874 error = FCERR_DICT;
2875 else
Bram Moolenaar8dd3a432016-08-01 20:46:25 +02002876 {
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002877 int did_save_redo = FALSE;
2878 save_redo_T save_redo;
2879
2880 /*
2881 * Call the user function.
2882 * Save and restore search patterns, script variables and
2883 * redo buffer.
2884 */
2885 save_search_patterns();
2886 if (!ins_compl_active())
2887 {
2888 saveRedobuff(&save_redo);
2889 did_save_redo = TRUE;
2890 }
2891 ++fp->uf_calls;
Bram Moolenaar6f5b6df2020-05-16 21:20:12 +02002892 call_user_func(fp, argcount, argvars, rettv, funcexe,
2893 (fp->uf_flags & FC_DICT) ? selfdict : NULL);
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002894 if (--fp->uf_calls <= 0 && fp->uf_refcount <= 0)
2895 // Function was unreferenced while being used, free it now.
2896 func_clear_free(fp, FALSE);
2897 if (did_save_redo)
2898 restoreRedobuff(&save_redo);
2899 restore_search_patterns();
2900 error = FCERR_NONE;
Bram Moolenaar8dd3a432016-08-01 20:46:25 +02002901 }
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01002902 return error;
Bram Moolenaar03ff9bc2017-02-02 22:59:27 +01002903}
2904
Bram Moolenaar27e80c82018-10-14 21:41:01 +02002905static funccal_entry_T *funccal_stack = NULL;
2906
2907/*
2908 * Save the current function call pointer, and set it to NULL.
2909 * Used when executing autocommands and for ":source".
2910 */
2911 void
2912save_funccal(funccal_entry_T *entry)
2913{
2914 entry->top_funccal = current_funccal;
2915 entry->next = funccal_stack;
2916 funccal_stack = entry;
2917 current_funccal = NULL;
2918}
2919
2920 void
2921restore_funccal(void)
2922{
2923 if (funccal_stack == NULL)
Bram Moolenaarf9e3e092019-01-13 23:38:42 +01002924 iemsg("INTERNAL: restore_funccal()");
Bram Moolenaar27e80c82018-10-14 21:41:01 +02002925 else
2926 {
2927 current_funccal = funccal_stack->top_funccal;
2928 funccal_stack = funccal_stack->next;
2929 }
2930}
2931
Bram Moolenaarfa55cfc2019-07-13 22:59:32 +02002932 funccall_T *
2933get_current_funccal(void)
2934{
2935 return current_funccal;
2936}
2937
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02002938/*
2939 * Mark all functions of script "sid" as deleted.
2940 */
2941 void
2942delete_script_functions(int sid)
2943{
2944 hashitem_T *hi;
2945 ufunc_T *fp;
Bram Moolenaarce658352020-07-31 23:47:12 +02002946 long_u todo = 1;
Bram Moolenaar909ed7e2020-04-27 23:16:41 +02002947 char_u buf[30];
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02002948 size_t len;
2949
2950 buf[0] = K_SPECIAL;
2951 buf[1] = KS_EXTRA;
2952 buf[2] = (int)KE_SNR;
Bram Moolenaar909ed7e2020-04-27 23:16:41 +02002953 sprintf((char *)buf + 3, "%d_", sid);
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02002954 len = STRLEN(buf);
2955
Bram Moolenaarce658352020-07-31 23:47:12 +02002956 while (todo > 0)
2957 {
2958 todo = func_hashtab.ht_used;
2959 for (hi = func_hashtab.ht_array; todo > 0; ++hi)
2960 if (!HASHITEM_EMPTY(hi))
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02002961 {
Bram Moolenaarce658352020-07-31 23:47:12 +02002962 fp = HI2UF(hi);
2963 if (STRNCMP(fp->uf_name, buf, len) == 0)
2964 {
2965 int changed = func_hashtab.ht_changed;
2966
2967 fp->uf_flags |= FC_DEAD;
Bram Moolenaarc970e422021-03-17 15:03:04 +01002968
2969 if (fp->uf_calls > 0)
2970 {
2971 // Function is executing, don't free it but do remove
2972 // it from the hashtable.
2973 if (func_remove(fp))
2974 fp->uf_refcount--;
2975 }
2976 else
2977 {
2978 func_clear(fp, TRUE);
2979 // When clearing a function another function can be
2980 // cleared as a side effect. When that happens start
2981 // over.
2982 if (changed != func_hashtab.ht_changed)
2983 break;
2984 }
Bram Moolenaarce658352020-07-31 23:47:12 +02002985 }
2986 --todo;
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02002987 }
Bram Moolenaarce658352020-07-31 23:47:12 +02002988 }
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02002989}
2990
Bram Moolenaara9b579f2016-07-17 18:29:19 +02002991#if defined(EXITFREE) || defined(PROTO)
2992 void
2993free_all_functions(void)
2994{
2995 hashitem_T *hi;
Bram Moolenaarc2574872016-08-11 22:51:05 +02002996 ufunc_T *fp;
2997 long_u skipped = 0;
Bram Moolenaar03ff9bc2017-02-02 22:59:27 +01002998 long_u todo = 1;
Bram Moolenaar1f22cc52020-07-14 21:08:49 +02002999 int changed;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003000
Bram Moolenaare38eab22019-12-05 21:50:01 +01003001 // Clean up the current_funccal chain and the funccal stack.
Bram Moolenaar6914c642017-04-01 21:21:30 +02003002 while (current_funccal != NULL)
3003 {
3004 clear_tv(current_funccal->rettv);
3005 cleanup_function_call(current_funccal);
Bram Moolenaar27e80c82018-10-14 21:41:01 +02003006 if (current_funccal == NULL && funccal_stack != NULL)
3007 restore_funccal();
Bram Moolenaar6914c642017-04-01 21:21:30 +02003008 }
3009
Bram Moolenaare38eab22019-12-05 21:50:01 +01003010 // First clear what the functions contain. Since this may lower the
3011 // reference count of a function, it may also free a function and change
3012 // the hash table. Restart if that happens.
Bram Moolenaar03ff9bc2017-02-02 22:59:27 +01003013 while (todo > 0)
3014 {
3015 todo = func_hashtab.ht_used;
3016 for (hi = func_hashtab.ht_array; todo > 0; ++hi)
3017 if (!HASHITEM_EMPTY(hi))
3018 {
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003019 // clear the def function index now
3020 fp = HI2UF(hi);
3021 fp->uf_flags &= ~FC_DEAD;
Bram Moolenaar0cb5bcf2020-06-20 18:19:09 +02003022 fp->uf_def_status = UF_NOT_COMPILED;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003023
Bram Moolenaare38eab22019-12-05 21:50:01 +01003024 // Only free functions that are not refcounted, those are
3025 // supposed to be freed when no longer referenced.
Bram Moolenaar03ff9bc2017-02-02 22:59:27 +01003026 if (func_name_refcount(fp->uf_name))
3027 ++skipped;
3028 else
3029 {
Bram Moolenaar1f22cc52020-07-14 21:08:49 +02003030 changed = func_hashtab.ht_changed;
Bram Moolenaar03ff9bc2017-02-02 22:59:27 +01003031 func_clear(fp, TRUE);
Bram Moolenaar1f22cc52020-07-14 21:08:49 +02003032 if (changed != func_hashtab.ht_changed)
Bram Moolenaar03ff9bc2017-02-02 22:59:27 +01003033 {
3034 skipped = 0;
3035 break;
3036 }
3037 }
3038 --todo;
3039 }
3040 }
3041
Bram Moolenaare38eab22019-12-05 21:50:01 +01003042 // Now actually free the functions. Need to start all over every time,
3043 // because func_free() may change the hash table.
Bram Moolenaar03ff9bc2017-02-02 22:59:27 +01003044 skipped = 0;
Bram Moolenaarc2574872016-08-11 22:51:05 +02003045 while (func_hashtab.ht_used > skipped)
3046 {
3047 todo = func_hashtab.ht_used;
3048 for (hi = func_hashtab.ht_array; todo > 0; ++hi)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003049 if (!HASHITEM_EMPTY(hi))
3050 {
Bram Moolenaarc2574872016-08-11 22:51:05 +02003051 --todo;
Bram Moolenaare38eab22019-12-05 21:50:01 +01003052 // Only free functions that are not refcounted, those are
3053 // supposed to be freed when no longer referenced.
Bram Moolenaarc2574872016-08-11 22:51:05 +02003054 fp = HI2UF(hi);
3055 if (func_name_refcount(fp->uf_name))
3056 ++skipped;
3057 else
3058 {
Bram Moolenaara05e5242020-09-19 18:19:19 +02003059 if (func_free(fp, FALSE) == OK)
3060 {
3061 skipped = 0;
3062 break;
3063 }
3064 // did not actually free it
3065 ++skipped;
Bram Moolenaarc2574872016-08-11 22:51:05 +02003066 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003067 }
Bram Moolenaarc2574872016-08-11 22:51:05 +02003068 }
3069 if (skipped == 0)
3070 hash_clear(&func_hashtab);
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003071
3072 free_def_functions();
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003073}
3074#endif
3075
3076/*
3077 * Return TRUE if "name" looks like a builtin function name: starts with a
Bram Moolenaara26b9702020-04-18 19:53:28 +02003078 * lower case letter and doesn't contain AUTOLOAD_CHAR or ':'.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003079 * "len" is the length of "name", or -1 for NUL terminated.
3080 */
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003081 int
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003082builtin_function(char_u *name, int len)
3083{
3084 char_u *p;
3085
Bram Moolenaara26b9702020-04-18 19:53:28 +02003086 if (!ASCII_ISLOWER(name[0]) || name[1] == ':')
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003087 return FALSE;
3088 p = vim_strchr(name, AUTOLOAD_CHAR);
3089 return p == NULL || (len > 0 && p > name + len);
3090}
3091
3092 int
3093func_call(
3094 char_u *name,
3095 typval_T *args,
3096 partial_T *partial,
3097 dict_T *selfdict,
3098 typval_T *rettv)
3099{
Bram Moolenaar50985eb2020-01-27 22:09:39 +01003100 list_T *l = args->vval.v_list;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003101 listitem_T *item;
3102 typval_T argv[MAX_FUNC_ARGS + 1];
3103 int argc = 0;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003104 int r = 0;
3105
Bram Moolenaar7e9f3512020-05-13 22:44:22 +02003106 CHECK_LIST_MATERIALIZE(l);
Bram Moolenaar00d253e2020-04-06 22:13:01 +02003107 FOR_ALL_LIST_ITEMS(l, item)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003108 {
3109 if (argc == MAX_FUNC_ARGS - (partial == NULL ? 0 : partial->pt_argc))
3110 {
Bram Moolenaarf9e3e092019-01-13 23:38:42 +01003111 emsg(_("E699: Too many arguments"));
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003112 break;
3113 }
Bram Moolenaare38eab22019-12-05 21:50:01 +01003114 // Make a copy of each argument. This is needed to be able to set
3115 // v_lock to VAR_FIXED in the copy without changing the original list.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003116 copy_tv(&item->li_tv, &argv[argc++]);
3117 }
3118
3119 if (item == NULL)
Bram Moolenaarc6538bc2019-08-03 18:17:11 +02003120 {
3121 funcexe_T funcexe;
3122
Bram Moolenaara80faa82020-04-12 19:37:17 +02003123 CLEAR_FIELD(funcexe);
Bram Moolenaarc6538bc2019-08-03 18:17:11 +02003124 funcexe.firstline = curwin->w_cursor.lnum;
3125 funcexe.lastline = curwin->w_cursor.lnum;
Bram Moolenaarc6538bc2019-08-03 18:17:11 +02003126 funcexe.evaluate = TRUE;
3127 funcexe.partial = partial;
3128 funcexe.selfdict = selfdict;
3129 r = call_func(name, -1, rettv, argc, argv, &funcexe);
3130 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003131
Bram Moolenaare38eab22019-12-05 21:50:01 +01003132 // Free the arguments.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003133 while (argc > 0)
3134 clear_tv(&argv[--argc]);
3135
3136 return r;
3137}
3138
Bram Moolenaar0e57dd82019-09-16 22:56:03 +02003139static int callback_depth = 0;
3140
3141 int
3142get_callback_depth(void)
3143{
3144 return callback_depth;
3145}
3146
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003147/*
Bram Moolenaar3a97bb32019-06-01 13:28:35 +02003148 * Invoke call_func() with a callback.
3149 */
3150 int
3151call_callback(
3152 callback_T *callback,
3153 int len, // length of "name" or -1 to use strlen()
3154 typval_T *rettv, // return value goes here
3155 int argcount, // number of "argvars"
Bram Moolenaarc6538bc2019-08-03 18:17:11 +02003156 typval_T *argvars) // vars for arguments, must have "argcount"
Bram Moolenaar3a97bb32019-06-01 13:28:35 +02003157 // PLUS ONE elements!
Bram Moolenaar3a97bb32019-06-01 13:28:35 +02003158{
Bram Moolenaarc6538bc2019-08-03 18:17:11 +02003159 funcexe_T funcexe;
Bram Moolenaar0e57dd82019-09-16 22:56:03 +02003160 int ret;
Bram Moolenaarc6538bc2019-08-03 18:17:11 +02003161
Bram Moolenaara80faa82020-04-12 19:37:17 +02003162 CLEAR_FIELD(funcexe);
Bram Moolenaarc6538bc2019-08-03 18:17:11 +02003163 funcexe.evaluate = TRUE;
3164 funcexe.partial = callback->cb_partial;
Bram Moolenaar0e57dd82019-09-16 22:56:03 +02003165 ++callback_depth;
3166 ret = call_func(callback->cb_name, len, rettv, argcount, argvars, &funcexe);
3167 --callback_depth;
3168 return ret;
Bram Moolenaar3a97bb32019-06-01 13:28:35 +02003169}
3170
3171/*
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003172 * Give an error message for the result of a function.
3173 * Nothing if "error" is FCERR_NONE.
3174 */
3175 void
3176user_func_error(int error, char_u *name)
3177{
3178 switch (error)
3179 {
3180 case FCERR_UNKNOWN:
3181 emsg_funcname(e_unknownfunc, name);
3182 break;
3183 case FCERR_NOTMETHOD:
3184 emsg_funcname(
3185 N_("E276: Cannot use function as a method: %s"), name);
3186 break;
3187 case FCERR_DELETED:
3188 emsg_funcname(N_(e_func_deleted), name);
3189 break;
3190 case FCERR_TOOMANY:
3191 emsg_funcname((char *)e_toomanyarg, name);
3192 break;
3193 case FCERR_TOOFEW:
3194 emsg_funcname((char *)e_toofewarg, name);
3195 break;
3196 case FCERR_SCRIPT:
3197 emsg_funcname(
3198 N_("E120: Using <SID> not in a script context: %s"), name);
3199 break;
3200 case FCERR_DICT:
3201 emsg_funcname(
3202 N_("E725: Calling dict function without Dictionary: %s"),
3203 name);
3204 break;
3205 }
3206}
3207
3208/*
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003209 * Call a function with its resolved parameters
Bram Moolenaardf48fb42016-07-22 21:50:18 +02003210 *
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003211 * Return FAIL when the function can't be called, OK otherwise.
3212 * Also returns OK when an error was encountered while executing the function.
3213 */
3214 int
3215call_func(
Bram Moolenaar6ed88192019-05-11 18:37:44 +02003216 char_u *funcname, // name of the function
3217 int len, // length of "name" or -1 to use strlen()
3218 typval_T *rettv, // return value goes here
3219 int argcount_in, // number of "argvars"
3220 typval_T *argvars_in, // vars for arguments, must have "argcount"
3221 // PLUS ONE elements!
Bram Moolenaarc6538bc2019-08-03 18:17:11 +02003222 funcexe_T *funcexe) // more arguments
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003223{
3224 int ret = FAIL;
Bram Moolenaaref140542019-12-31 21:27:13 +01003225 int error = FCERR_NONE;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003226 int i;
Bram Moolenaarf10806b2020-04-02 18:34:35 +02003227 ufunc_T *fp = NULL;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003228 char_u fname_buf[FLEN_FIXED + 1];
3229 char_u *tofree = NULL;
Bram Moolenaarf10806b2020-04-02 18:34:35 +02003230 char_u *fname = NULL;
3231 char_u *name = NULL;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003232 int argcount = argcount_in;
3233 typval_T *argvars = argvars_in;
Bram Moolenaarc6538bc2019-08-03 18:17:11 +02003234 dict_T *selfdict = funcexe->selfdict;
Bram Moolenaarfcfe1a92019-08-04 23:04:39 +02003235 typval_T argv[MAX_FUNC_ARGS + 1]; // used when "partial" or
3236 // "funcexe->basetv" is not NULL
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003237 int argv_clear = 0;
Bram Moolenaar761fdf02019-08-05 23:10:16 +02003238 int argv_base = 0;
Bram Moolenaarc6538bc2019-08-03 18:17:11 +02003239 partial_T *partial = funcexe->partial;
Bram Moolenaar97f227d2021-07-04 20:20:52 +02003240 type_T check_type;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003241
Bram Moolenaarc507a2d2019-08-29 21:32:55 +02003242 // Initialize rettv so that it is safe for caller to invoke clear_tv(rettv)
3243 // even when call_func() returns FAIL.
3244 rettv->v_type = VAR_UNKNOWN;
3245
Bram Moolenaarf10806b2020-04-02 18:34:35 +02003246 if (partial != NULL)
3247 fp = partial->pt_func;
3248 if (fp == NULL)
3249 {
3250 // Make a copy of the name, if it comes from a funcref variable it
3251 // could be changed or deleted in the called function.
3252 name = len > 0 ? vim_strnsave(funcname, len) : vim_strsave(funcname);
3253 if (name == NULL)
3254 return ret;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003255
Bram Moolenaarf10806b2020-04-02 18:34:35 +02003256 fname = fname_trans_sid(name, fname_buf, &tofree, &error);
3257 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003258
Bram Moolenaarc6538bc2019-08-03 18:17:11 +02003259 if (funcexe->doesrange != NULL)
3260 *funcexe->doesrange = FALSE;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003261
3262 if (partial != NULL)
3263 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01003264 // When the function has a partial with a dict and there is a dict
3265 // argument, use the dict argument. That is backwards compatible.
3266 // When the dict was bound explicitly use the one from the partial.
Bram Moolenaarc6538bc2019-08-03 18:17:11 +02003267 if (partial->pt_dict != NULL && (selfdict == NULL || !partial->pt_auto))
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003268 selfdict = partial->pt_dict;
Bram Moolenaaref140542019-12-31 21:27:13 +01003269 if (error == FCERR_NONE && partial->pt_argc > 0)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003270 {
3271 for (argv_clear = 0; argv_clear < partial->pt_argc; ++argv_clear)
Bram Moolenaar4c054e92019-11-10 00:13:50 +01003272 {
3273 if (argv_clear + argcount_in >= MAX_FUNC_ARGS)
3274 {
Bram Moolenaaref140542019-12-31 21:27:13 +01003275 error = FCERR_TOOMANY;
Bram Moolenaar4c054e92019-11-10 00:13:50 +01003276 goto theend;
3277 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003278 copy_tv(&partial->pt_argv[argv_clear], &argv[argv_clear]);
Bram Moolenaar4c054e92019-11-10 00:13:50 +01003279 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003280 for (i = 0; i < argcount_in; ++i)
3281 argv[i + argv_clear] = argvars_in[i];
3282 argvars = argv;
3283 argcount = partial->pt_argc + argcount_in;
Bram Moolenaar97f227d2021-07-04 20:20:52 +02003284
Bram Moolenaar22f85d02021-07-04 23:29:30 +02003285 if (funcexe->check_type != NULL
3286 && funcexe->check_type->tt_argcount != -1)
Bram Moolenaar97f227d2021-07-04 20:20:52 +02003287 {
3288 // Now funcexe->check_type is missing the added arguments, make
3289 // a copy of the type with the correction.
3290 check_type = *funcexe->check_type;
3291 funcexe->check_type = &check_type;
3292 check_type.tt_argcount += partial->pt_argc;
3293 check_type.tt_min_argcount += partial->pt_argc;
3294 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003295 }
3296 }
3297
Bram Moolenaar32b3f822021-01-06 21:59:39 +01003298 if (error == FCERR_NONE && funcexe->check_type != NULL && funcexe->evaluate)
3299 {
3300 // Check that the argument types are OK for the types of the funcref.
3301 if (check_argument_types(funcexe->check_type, argvars, argcount,
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +01003302 (name != NULL) ? name : funcname) == FAIL)
Bram Moolenaar32b3f822021-01-06 21:59:39 +01003303 error = FCERR_OTHER;
3304 }
3305
Bram Moolenaaref140542019-12-31 21:27:13 +01003306 if (error == FCERR_NONE && funcexe->evaluate)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003307 {
3308 char_u *rfname = fname;
Bram Moolenaar333894b2020-08-01 18:53:07 +02003309 int is_global = FALSE;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003310
Bram Moolenaar333894b2020-08-01 18:53:07 +02003311 // Skip "g:" before a function name.
Bram Moolenaarf10806b2020-04-02 18:34:35 +02003312 if (fp == NULL && fname[0] == 'g' && fname[1] == ':')
Bram Moolenaar333894b2020-08-01 18:53:07 +02003313 {
3314 is_global = TRUE;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003315 rfname = fname + 2;
Bram Moolenaar333894b2020-08-01 18:53:07 +02003316 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003317
Bram Moolenaare38eab22019-12-05 21:50:01 +01003318 rettv->v_type = VAR_NUMBER; // default rettv is number zero
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003319 rettv->vval.v_number = 0;
Bram Moolenaaref140542019-12-31 21:27:13 +01003320 error = FCERR_UNKNOWN;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003321
Bram Moolenaarf10806b2020-04-02 18:34:35 +02003322 if (fp != NULL || !builtin_function(rfname, -1))
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003323 {
3324 /*
3325 * User defined function.
3326 */
Bram Moolenaarf10806b2020-04-02 18:34:35 +02003327 if (fp == NULL)
Bram Moolenaar333894b2020-08-01 18:53:07 +02003328 fp = find_func(rfname, is_global, NULL);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003329
Bram Moolenaare38eab22019-12-05 21:50:01 +01003330 // Trigger FuncUndefined event, may load the function.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003331 if (fp == NULL
3332 && apply_autocmds(EVENT_FUNCUNDEFINED,
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02003333 rfname, rfname, TRUE, NULL)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003334 && !aborting())
3335 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01003336 // executed an autocommand, search for the function again
Bram Moolenaar333894b2020-08-01 18:53:07 +02003337 fp = find_func(rfname, is_global, NULL);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003338 }
Bram Moolenaare38eab22019-12-05 21:50:01 +01003339 // Try loading a package.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003340 if (fp == NULL && script_autoload(rfname, TRUE) && !aborting())
3341 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01003342 // loaded a package, search for the function again
Bram Moolenaar333894b2020-08-01 18:53:07 +02003343 fp = find_func(rfname, is_global, NULL);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003344 }
Bram Moolenaara26b9702020-04-18 19:53:28 +02003345 if (fp == NULL)
3346 {
3347 char_u *p = untrans_function_name(rfname);
3348
3349 // If using Vim9 script try not local to the script.
Bram Moolenaar035d6e92020-08-11 22:30:42 +02003350 // Don't do this if the name starts with "s:".
3351 if (p != NULL && (funcname[0] != 's' || funcname[1] != ':'))
Bram Moolenaar333894b2020-08-01 18:53:07 +02003352 fp = find_func(p, is_global, NULL);
Bram Moolenaara26b9702020-04-18 19:53:28 +02003353 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003354
Bram Moolenaar437bafe2016-08-01 15:40:54 +02003355 if (fp != NULL && (fp->uf_flags & FC_DELETED))
Bram Moolenaaref140542019-12-31 21:27:13 +01003356 error = FCERR_DELETED;
Bram Moolenaar801ab062020-06-25 19:27:56 +02003357#ifdef FEAT_LUA
3358 else if (fp != NULL && (fp->uf_flags & FC_CFUNC))
3359 {
3360 cfunc_T cb = fp->uf_cb;
3361
3362 error = (*cb)(argcount, argvars, rettv, fp->uf_cb_state);
3363 }
3364#endif
Bram Moolenaar437bafe2016-08-01 15:40:54 +02003365 else if (fp != NULL)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003366 {
Bram Moolenaarc6538bc2019-08-03 18:17:11 +02003367 if (funcexe->argv_func != NULL)
Bram Moolenaarb0745b22019-11-09 22:28:11 +01003368 // postponed filling in the arguments, do it now
3369 argcount = funcexe->argv_func(argcount, argvars, argv_clear,
Bram Moolenaarc6538bc2019-08-03 18:17:11 +02003370 fp->uf_args.ga_len);
Bram Moolenaardf48fb42016-07-22 21:50:18 +02003371
Bram Moolenaarfcfe1a92019-08-04 23:04:39 +02003372 if (funcexe->basetv != NULL)
3373 {
3374 // Method call: base->Method()
3375 mch_memmove(&argv[1], argvars, sizeof(typval_T) * argcount);
3376 argv[0] = *funcexe->basetv;
3377 argcount++;
Bram Moolenaar761fdf02019-08-05 23:10:16 +02003378 argvars = argv;
3379 argv_base = 1;
Bram Moolenaarfcfe1a92019-08-04 23:04:39 +02003380 }
Bram Moolenaarfcfe1a92019-08-04 23:04:39 +02003381
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003382 error = call_user_func_check(fp, argcount, argvars, rettv,
3383 funcexe, selfdict);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003384 }
3385 }
Bram Moolenaarac92e252019-08-03 21:58:38 +02003386 else if (funcexe->basetv != NULL)
3387 {
3388 /*
Bram Moolenaarfcfe1a92019-08-04 23:04:39 +02003389 * expr->method(): Find the method name in the table, call its
3390 * implementation with the base as one of the arguments.
Bram Moolenaarac92e252019-08-03 21:58:38 +02003391 */
3392 error = call_internal_method(fname, argcount, argvars, rettv,
3393 funcexe->basetv);
3394 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003395 else
3396 {
3397 /*
3398 * Find the function name in the table, call its implementation.
3399 */
3400 error = call_internal_func(fname, argcount, argvars, rettv);
3401 }
Bram Moolenaar333894b2020-08-01 18:53:07 +02003402
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003403 /*
3404 * The function call (or "FuncUndefined" autocommand sequence) might
3405 * have been aborted by an error, an interrupt, or an explicitly thrown
3406 * exception that has not been caught so far. This situation can be
3407 * tested for by calling aborting(). For an error in an internal
3408 * function or for the "E132" error in call_user_func(), however, the
3409 * throw point at which the "force_abort" flag (temporarily reset by
3410 * emsg()) is normally updated has not been reached yet. We need to
3411 * update that flag first to make aborting() reliable.
3412 */
3413 update_force_abort();
3414 }
Bram Moolenaaref140542019-12-31 21:27:13 +01003415 if (error == FCERR_NONE)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003416 ret = OK;
3417
Bram Moolenaar4c054e92019-11-10 00:13:50 +01003418theend:
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003419 /*
3420 * Report an error unless the argument evaluation or function call has been
3421 * cancelled due to an aborting error, an interrupt, or an exception.
3422 */
3423 if (!aborting())
3424 {
Bram Moolenaarf10806b2020-04-02 18:34:35 +02003425 user_func_error(error, (name != NULL) ? name : funcname);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003426 }
3427
Bram Moolenaar761fdf02019-08-05 23:10:16 +02003428 // clear the copies made from the partial
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003429 while (argv_clear > 0)
Bram Moolenaar761fdf02019-08-05 23:10:16 +02003430 clear_tv(&argv[--argv_clear + argv_base]);
3431
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003432 vim_free(tofree);
3433 vim_free(name);
3434
3435 return ret;
3436}
3437
Bram Moolenaar682d0a12020-07-19 20:48:59 +02003438 char_u *
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003439printable_func_name(ufunc_T *fp)
3440{
3441 return fp->uf_name_exp != NULL ? fp->uf_name_exp : fp->uf_name;
3442}
3443
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003444/*
Bram Moolenaar61a6d4e2020-03-01 23:32:25 +01003445 * List the head of the function: "function name(arg1, arg2)".
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003446 */
3447 static void
3448list_func_head(ufunc_T *fp, int indent)
3449{
3450 int j;
3451
3452 msg_start();
3453 if (indent)
Bram Moolenaar32526b32019-01-19 17:43:09 +01003454 msg_puts(" ");
Bram Moolenaar0cb5bcf2020-06-20 18:19:09 +02003455 if (fp->uf_def_status != UF_NOT_COMPILED)
Bram Moolenaar61a6d4e2020-03-01 23:32:25 +01003456 msg_puts("def ");
3457 else
3458 msg_puts("function ");
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003459 msg_puts((char *)printable_func_name(fp));
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003460 msg_putchar('(');
3461 for (j = 0; j < fp->uf_args.ga_len; ++j)
3462 {
3463 if (j)
Bram Moolenaar32526b32019-01-19 17:43:09 +01003464 msg_puts(", ");
3465 msg_puts((char *)FUNCARG(fp, j));
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003466 if (fp->uf_arg_types != NULL)
3467 {
3468 char *tofree;
3469
3470 msg_puts(": ");
3471 msg_puts(type_name(fp->uf_arg_types[j], &tofree));
3472 vim_free(tofree);
3473 }
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02003474 if (j >= fp->uf_args.ga_len - fp->uf_def_args.ga_len)
3475 {
3476 msg_puts(" = ");
3477 msg_puts(((char **)(fp->uf_def_args.ga_data))
3478 [j - fp->uf_args.ga_len + fp->uf_def_args.ga_len]);
3479 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003480 }
3481 if (fp->uf_varargs)
3482 {
3483 if (j)
Bram Moolenaar32526b32019-01-19 17:43:09 +01003484 msg_puts(", ");
3485 msg_puts("...");
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003486 }
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003487 if (fp->uf_va_name != NULL)
3488 {
3489 if (j)
3490 msg_puts(", ");
3491 msg_puts("...");
3492 msg_puts((char *)fp->uf_va_name);
Bram Moolenaar2a389082021-04-09 20:24:31 +02003493 if (fp->uf_va_type != NULL)
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003494 {
3495 char *tofree;
3496
3497 msg_puts(": ");
3498 msg_puts(type_name(fp->uf_va_type, &tofree));
3499 vim_free(tofree);
3500 }
3501 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003502 msg_putchar(')');
Bram Moolenaar61a6d4e2020-03-01 23:32:25 +01003503
Bram Moolenaar0cb5bcf2020-06-20 18:19:09 +02003504 if (fp->uf_def_status != UF_NOT_COMPILED)
Bram Moolenaar61a6d4e2020-03-01 23:32:25 +01003505 {
3506 if (fp->uf_ret_type != &t_void)
3507 {
3508 char *tofree;
3509
3510 msg_puts(": ");
3511 msg_puts(type_name(fp->uf_ret_type, &tofree));
3512 vim_free(tofree);
3513 }
3514 }
3515 else if (fp->uf_flags & FC_ABORT)
Bram Moolenaar32526b32019-01-19 17:43:09 +01003516 msg_puts(" abort");
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003517 if (fp->uf_flags & FC_RANGE)
Bram Moolenaar32526b32019-01-19 17:43:09 +01003518 msg_puts(" range");
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003519 if (fp->uf_flags & FC_DICT)
Bram Moolenaar32526b32019-01-19 17:43:09 +01003520 msg_puts(" dict");
Bram Moolenaar10ce39a2016-07-29 22:37:06 +02003521 if (fp->uf_flags & FC_CLOSURE)
Bram Moolenaar32526b32019-01-19 17:43:09 +01003522 msg_puts(" closure");
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003523 msg_clr_eos();
3524 if (p_verbose > 0)
Bram Moolenaarf29c1c62018-09-10 21:05:02 +02003525 last_set_msg(fp->uf_script_ctx);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003526}
3527
3528/*
3529 * Get a function name, translating "<SID>" and "<SNR>".
3530 * Also handles a Funcref in a List or Dictionary.
3531 * Returns the function name in allocated memory, or NULL for failure.
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02003532 * Set "*is_global" to TRUE when the function must be global, unless
3533 * "is_global" is NULL.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003534 * flags:
3535 * TFN_INT: internal function name OK
3536 * TFN_QUIET: be quiet
3537 * TFN_NO_AUTOLOAD: do not use script autoloading
Bram Moolenaarb54c3ff2016-07-31 14:11:58 +02003538 * TFN_NO_DEREF: do not dereference a Funcref
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003539 * Advances "pp" to just after the function name (if no error).
3540 */
Bram Moolenaar437bafe2016-08-01 15:40:54 +02003541 char_u *
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003542trans_function_name(
3543 char_u **pp,
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02003544 int *is_global,
Bram Moolenaare38eab22019-12-05 21:50:01 +01003545 int skip, // only find the end, don't evaluate
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003546 int flags,
Bram Moolenaare38eab22019-12-05 21:50:01 +01003547 funcdict_T *fdp, // return: info about dictionary used
Bram Moolenaar32b3f822021-01-06 21:59:39 +01003548 partial_T **partial, // return: partial of a FuncRef
3549 type_T **type) // return: type of funcref if not NULL
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003550{
3551 char_u *name = NULL;
3552 char_u *start;
3553 char_u *end;
3554 int lead;
3555 char_u sid_buf[20];
3556 int len;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003557 int extra = 0;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003558 lval_T lv;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003559 int vim9script;
Bram Moolenaar7b5d5442020-10-04 13:42:34 +02003560 static char *e_function_name = N_("E129: Function name required");
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003561
3562 if (fdp != NULL)
Bram Moolenaara80faa82020-04-12 19:37:17 +02003563 CLEAR_POINTER(fdp);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003564 start = *pp;
3565
Bram Moolenaare38eab22019-12-05 21:50:01 +01003566 // Check for hard coded <SNR>: already translated function ID (from a user
3567 // command).
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003568 if ((*pp)[0] == K_SPECIAL && (*pp)[1] == KS_EXTRA
3569 && (*pp)[2] == (int)KE_SNR)
3570 {
3571 *pp += 3;
3572 len = get_id_len(pp) + 3;
3573 return vim_strnsave(start, len);
3574 }
3575
Bram Moolenaare38eab22019-12-05 21:50:01 +01003576 // A name starting with "<SID>" or "<SNR>" is local to a script. But
3577 // don't skip over "s:", get_lval() needs it for "s:dict.func".
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003578 lead = eval_fname_script(start);
3579 if (lead > 2)
3580 start += lead;
3581
Bram Moolenaare38eab22019-12-05 21:50:01 +01003582 // Note that TFN_ flags use the same values as GLV_ flags.
Bram Moolenaar6e65d592017-12-07 22:11:27 +01003583 end = get_lval(start, NULL, &lv, FALSE, skip, flags | GLV_READ_ONLY,
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003584 lead > 2 ? 0 : FNE_CHECK_START);
3585 if (end == start)
3586 {
3587 if (!skip)
Bram Moolenaar7b5d5442020-10-04 13:42:34 +02003588 emsg(_(e_function_name));
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003589 goto theend;
3590 }
3591 if (end == NULL || (lv.ll_tv != NULL && (lead > 2 || lv.ll_range)))
3592 {
3593 /*
3594 * Report an invalid expression in braces, unless the expression
3595 * evaluation has been cancelled due to an aborting error, an
3596 * interrupt, or an exception.
3597 */
3598 if (!aborting())
3599 {
3600 if (end != NULL)
Bram Moolenaarf9e3e092019-01-13 23:38:42 +01003601 semsg(_(e_invarg2), start);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003602 }
3603 else
3604 *pp = find_name_end(start, NULL, NULL, FNE_INCL_BR);
3605 goto theend;
3606 }
3607
3608 if (lv.ll_tv != NULL)
3609 {
3610 if (fdp != NULL)
3611 {
3612 fdp->fd_dict = lv.ll_dict;
3613 fdp->fd_newkey = lv.ll_newkey;
3614 lv.ll_newkey = NULL;
3615 fdp->fd_di = lv.ll_di;
3616 }
3617 if (lv.ll_tv->v_type == VAR_FUNC && lv.ll_tv->vval.v_string != NULL)
3618 {
3619 name = vim_strsave(lv.ll_tv->vval.v_string);
3620 *pp = end;
3621 }
3622 else if (lv.ll_tv->v_type == VAR_PARTIAL
3623 && lv.ll_tv->vval.v_partial != NULL)
3624 {
Bram Moolenaar437bafe2016-08-01 15:40:54 +02003625 name = vim_strsave(partial_name(lv.ll_tv->vval.v_partial));
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003626 *pp = end;
3627 if (partial != NULL)
3628 *partial = lv.ll_tv->vval.v_partial;
3629 }
3630 else
3631 {
3632 if (!skip && !(flags & TFN_QUIET) && (fdp == NULL
3633 || lv.ll_dict == NULL || fdp->fd_newkey == NULL))
Bram Moolenaarf9e3e092019-01-13 23:38:42 +01003634 emsg(_(e_funcref));
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003635 else
3636 *pp = end;
3637 name = NULL;
3638 }
3639 goto theend;
3640 }
3641
3642 if (lv.ll_name == NULL)
3643 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01003644 // Error found, but continue after the function name.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003645 *pp = end;
3646 goto theend;
3647 }
3648
Bram Moolenaare38eab22019-12-05 21:50:01 +01003649 // Check if the name is a Funcref. If so, use the value.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003650 if (lv.ll_exp_name != NULL)
3651 {
3652 len = (int)STRLEN(lv.ll_exp_name);
Bram Moolenaar32b3f822021-01-06 21:59:39 +01003653 name = deref_func_name(lv.ll_exp_name, &len, partial, type,
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003654 flags & TFN_NO_AUTOLOAD);
3655 if (name == lv.ll_exp_name)
3656 name = NULL;
3657 }
Bram Moolenaarb54c3ff2016-07-31 14:11:58 +02003658 else if (!(flags & TFN_NO_DEREF))
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003659 {
3660 len = (int)(end - *pp);
Bram Moolenaar32b3f822021-01-06 21:59:39 +01003661 name = deref_func_name(*pp, &len, partial, type,
3662 flags & TFN_NO_AUTOLOAD);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003663 if (name == *pp)
3664 name = NULL;
3665 }
3666 if (name != NULL)
3667 {
3668 name = vim_strsave(name);
3669 *pp = end;
3670 if (STRNCMP(name, "<SNR>", 5) == 0)
3671 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01003672 // Change "<SNR>" to the byte sequence.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003673 name[0] = K_SPECIAL;
3674 name[1] = KS_EXTRA;
3675 name[2] = (int)KE_SNR;
3676 mch_memmove(name + 3, name + 5, STRLEN(name + 5) + 1);
3677 }
3678 goto theend;
3679 }
3680
3681 if (lv.ll_exp_name != NULL)
3682 {
3683 len = (int)STRLEN(lv.ll_exp_name);
3684 if (lead <= 2 && lv.ll_name == lv.ll_exp_name
3685 && STRNCMP(lv.ll_name, "s:", 2) == 0)
3686 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01003687 // When there was "s:" already or the name expanded to get a
3688 // leading "s:" then remove it.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003689 lv.ll_name += 2;
3690 len -= 2;
3691 lead = 2;
3692 }
3693 }
3694 else
3695 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01003696 // skip over "s:" and "g:"
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003697 if (lead == 2 || (lv.ll_name[0] == 'g' && lv.ll_name[1] == ':'))
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02003698 {
3699 if (is_global != NULL && lv.ll_name[0] == 'g')
3700 *is_global = TRUE;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003701 lv.ll_name += 2;
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02003702 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003703 len = (int)(end - lv.ll_name);
3704 }
Bram Moolenaar7b5d5442020-10-04 13:42:34 +02003705 if (len <= 0)
3706 {
3707 if (!skip)
3708 emsg(_(e_function_name));
3709 goto theend;
3710 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003711
Bram Moolenaar17f700a2020-12-19 21:23:42 +01003712 // In Vim9 script a user function is script-local by default, unless it
3713 // starts with a lower case character: dict.func().
Bram Moolenaareb6880b2020-07-12 17:07:05 +02003714 vim9script = ASCII_ISUPPER(*start) && in_vim9script();
Bram Moolenaar17f700a2020-12-19 21:23:42 +01003715 if (vim9script)
3716 {
3717 char_u *p;
3718
3719 // SomeScript#func() is a global function.
3720 for (p = start; *p != NUL && *p != '('; ++p)
3721 if (*p == AUTOLOAD_CHAR)
3722 vim9script = FALSE;
3723 }
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003724
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003725 /*
3726 * Copy the function name to allocated memory.
3727 * Accept <SID>name() inside a script, translate into <SNR>123_name().
3728 * Accept <SNR>123_name() outside a script.
3729 */
3730 if (skip)
Bram Moolenaare38eab22019-12-05 21:50:01 +01003731 lead = 0; // do nothing
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003732 else if (lead > 0 || vim9script)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003733 {
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003734 if (!vim9script)
3735 lead = 3;
3736 if (vim9script || (lv.ll_exp_name != NULL
3737 && eval_fname_sid(lv.ll_exp_name))
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003738 || eval_fname_sid(*pp))
3739 {
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003740 // It's script-local, "s:" or "<SID>"
Bram Moolenaarf29c1c62018-09-10 21:05:02 +02003741 if (current_sctx.sc_sid <= 0)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003742 {
Bram Moolenaarf9e3e092019-01-13 23:38:42 +01003743 emsg(_(e_usingsid));
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003744 goto theend;
3745 }
Bram Moolenaarf29c1c62018-09-10 21:05:02 +02003746 sprintf((char *)sid_buf, "%ld_", (long)current_sctx.sc_sid);
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003747 if (vim9script)
3748 extra = 3 + (int)STRLEN(sid_buf);
3749 else
3750 lead += (int)STRLEN(sid_buf);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003751 }
3752 }
Bram Moolenaar22f17a22021-06-21 20:48:58 +02003753 else if (!(flags & TFN_INT) && (builtin_function(lv.ll_name, len)
3754 || (in_vim9script() && *lv.ll_name == '_')))
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003755 {
Bram Moolenaarf9e3e092019-01-13 23:38:42 +01003756 semsg(_("E128: Function name must start with a capital or \"s:\": %s"),
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003757 start);
3758 goto theend;
3759 }
Bram Moolenaarb54c3ff2016-07-31 14:11:58 +02003760 if (!skip && !(flags & TFN_QUIET) && !(flags & TFN_NO_DEREF))
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003761 {
3762 char_u *cp = vim_strchr(lv.ll_name, ':');
3763
3764 if (cp != NULL && cp < end)
3765 {
Bram Moolenaarf9e3e092019-01-13 23:38:42 +01003766 semsg(_("E884: Function name cannot contain a colon: %s"), start);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003767 goto theend;
3768 }
3769 }
3770
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003771 name = alloc(len + lead + extra + 1);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003772 if (name != NULL)
3773 {
Bram Moolenaar9a5e5a32020-01-28 23:09:23 +01003774 if (!skip && (lead > 0 || vim9script))
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003775 {
3776 name[0] = K_SPECIAL;
3777 name[1] = KS_EXTRA;
3778 name[2] = (int)KE_SNR;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003779 if (vim9script || lead > 3) // If it's "<SID>"
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003780 STRCPY(name + 3, sid_buf);
3781 }
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003782 mch_memmove(name + lead + extra, lv.ll_name, (size_t)len);
3783 name[lead + extra + len] = NUL;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003784 }
3785 *pp = end;
3786
3787theend:
3788 clear_lval(&lv);
3789 return name;
3790}
3791
3792/*
Bram Moolenaara26b9702020-04-18 19:53:28 +02003793 * Assuming "name" is the result of trans_function_name() and it was prefixed
3794 * to use the script-local name, return the unmodified name (points into
3795 * "name"). Otherwise return NULL.
3796 * This can be used to first search for a script-local function and fall back
3797 * to the global function if not found.
3798 */
3799 char_u *
3800untrans_function_name(char_u *name)
3801{
3802 char_u *p;
3803
Bram Moolenaareb6880b2020-07-12 17:07:05 +02003804 if (*name == K_SPECIAL && in_vim9script())
Bram Moolenaara26b9702020-04-18 19:53:28 +02003805 {
3806 p = vim_strchr(name, '_');
3807 if (p != NULL)
3808 return p + 1;
3809 }
3810 return NULL;
3811}
3812
3813/*
Bram Moolenaareba3b7f2021-11-30 18:25:08 +00003814 * Call trans_function_name(), except that a lambda is returned as-is.
3815 * Returns the name in allocated memory.
3816 */
3817 char_u *
3818save_function_name(
3819 char_u **name,
3820 int *is_global,
3821 int skip,
3822 int flags,
3823 funcdict_T *fudi)
3824{
3825 char_u *p = *name;
3826 char_u *saved;
3827
3828 if (STRNCMP(p, "<lambda>", 8) == 0)
3829 {
3830 p += 8;
3831 (void)getdigits(&p);
3832 saved = vim_strnsave(*name, p - *name);
3833 if (fudi != NULL)
3834 CLEAR_POINTER(fudi);
3835 }
3836 else
3837 saved = trans_function_name(&p, is_global, skip,
3838 flags, fudi, NULL, NULL);
3839 *name = p;
3840 return saved;
3841}
3842
3843/*
Bram Moolenaar3fffa972020-06-05 21:06:10 +02003844 * List functions. When "regmatch" is NULL all of then.
3845 * Otherwise functions matching "regmatch".
3846 */
Bram Moolenaar6abdcf82020-11-22 18:15:44 +01003847 void
Bram Moolenaar3fffa972020-06-05 21:06:10 +02003848list_functions(regmatch_T *regmatch)
3849{
Bram Moolenaar1f22cc52020-07-14 21:08:49 +02003850 int changed = func_hashtab.ht_changed;
3851 long_u todo = func_hashtab.ht_used;
Bram Moolenaar3fffa972020-06-05 21:06:10 +02003852 hashitem_T *hi;
3853
Bram Moolenaar1f22cc52020-07-14 21:08:49 +02003854 for (hi = func_hashtab.ht_array; todo > 0 && !got_int; ++hi)
Bram Moolenaar3fffa972020-06-05 21:06:10 +02003855 {
3856 if (!HASHITEM_EMPTY(hi))
3857 {
3858 ufunc_T *fp = HI2UF(hi);
3859
3860 --todo;
3861 if ((fp->uf_flags & FC_DEAD) == 0
3862 && (regmatch == NULL
3863 ? !message_filtered(fp->uf_name)
3864 && !func_name_refcount(fp->uf_name)
3865 : !isdigit(*fp->uf_name)
3866 && vim_regexec(regmatch, fp->uf_name, 0)))
3867 {
3868 list_func_head(fp, FALSE);
Bram Moolenaar1f22cc52020-07-14 21:08:49 +02003869 if (changed != func_hashtab.ht_changed)
Bram Moolenaar3fffa972020-06-05 21:06:10 +02003870 {
3871 emsg(_("E454: function list was modified"));
3872 return;
3873 }
3874 }
3875 }
3876 }
3877}
3878
3879/*
Bram Moolenaar04b12692020-05-04 23:24:44 +02003880 * ":function" also supporting nested ":def".
Bram Moolenaar38ddf332020-07-31 22:05:04 +02003881 * When "name_arg" is not NULL this is a nested function, using "name_arg" for
3882 * the function name.
Bram Moolenaar04b12692020-05-04 23:24:44 +02003883 * Returns a pointer to the function or NULL if no function defined.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003884 */
Bram Moolenaar04b12692020-05-04 23:24:44 +02003885 ufunc_T *
Bram Moolenaarfbbcd002020-10-15 12:46:44 +02003886define_function(exarg_T *eap, char_u *name_arg)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003887{
Bram Moolenaar53564f72017-06-24 14:48:11 +02003888 char_u *line_to_free = NULL;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003889 int j;
3890 int c;
3891 int saved_did_emsg;
Bram Moolenaar04b12692020-05-04 23:24:44 +02003892 char_u *name = name_arg;
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02003893 int is_global = FALSE;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003894 char_u *p;
3895 char_u *arg;
Bram Moolenaarcef12702021-01-04 14:09:43 +01003896 char_u *whitep;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003897 char_u *line_arg = NULL;
3898 garray_T newargs;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003899 garray_T argtypes;
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02003900 garray_T default_args;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003901 garray_T newlines;
3902 int varargs = FALSE;
3903 int flags = 0;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003904 char_u *ret_type = NULL;
Bram Moolenaar04b12692020-05-04 23:24:44 +02003905 ufunc_T *fp = NULL;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02003906 int overwrite = FALSE;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003907 dictitem_T *v;
3908 funcdict_T fudi;
Bram Moolenaare38eab22019-12-05 21:50:01 +01003909 static int func_nr = 0; // number for nameless function
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003910 int paren;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003911 hashitem_T *hi;
Bram Moolenaarbc2cfe42019-07-04 14:57:12 +02003912 linenr_T sourcing_lnum_top;
Bram Moolenaare7e48382020-07-22 18:17:08 +02003913 int vim9script = in_vim9script();
Bram Moolenaareef21022020-08-01 22:16:43 +02003914 imported_T *import = NULL;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003915
3916 /*
3917 * ":function" without argument: list functions.
3918 */
Bram Moolenaara72cfb82020-04-23 17:07:30 +02003919 if (ends_excmd2(eap->cmd, eap->arg))
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003920 {
3921 if (!eap->skip)
Bram Moolenaar3fffa972020-06-05 21:06:10 +02003922 list_functions(NULL);
Bram Moolenaar63b91732021-08-05 20:40:03 +02003923 set_nextcmd(eap, eap->arg);
Bram Moolenaar04b12692020-05-04 23:24:44 +02003924 return NULL;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003925 }
3926
3927 /*
3928 * ":function /pat": list functions matching pattern.
3929 */
3930 if (*eap->arg == '/')
3931 {
Bram Moolenaare8c4abb2020-04-02 21:13:25 +02003932 p = skip_regexp(eap->arg + 1, '/', TRUE);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003933 if (!eap->skip)
3934 {
3935 regmatch_T regmatch;
3936
3937 c = *p;
3938 *p = NUL;
3939 regmatch.regprog = vim_regcomp(eap->arg + 1, RE_MAGIC);
3940 *p = c;
3941 if (regmatch.regprog != NULL)
3942 {
3943 regmatch.rm_ic = p_ic;
Bram Moolenaar3fffa972020-06-05 21:06:10 +02003944 list_functions(&regmatch);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003945 vim_regfree(regmatch.regprog);
3946 }
3947 }
3948 if (*p == '/')
3949 ++p;
Bram Moolenaar63b91732021-08-05 20:40:03 +02003950 set_nextcmd(eap, p);
Bram Moolenaar04b12692020-05-04 23:24:44 +02003951 return NULL;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003952 }
3953
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01003954 ga_init(&newargs);
3955 ga_init(&argtypes);
3956 ga_init(&default_args);
3957
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003958 /*
3959 * Get the function name. There are these situations:
3960 * func normal function name
3961 * "name" == func, "fudi.fd_dict" == NULL
3962 * dict.func new dictionary entry
3963 * "name" == NULL, "fudi.fd_dict" set,
3964 * "fudi.fd_di" == NULL, "fudi.fd_newkey" == func
3965 * dict.func existing dict entry with a Funcref
3966 * "name" == func, "fudi.fd_dict" set,
3967 * "fudi.fd_di" set, "fudi.fd_newkey" == NULL
3968 * dict.func existing dict entry that's not a Funcref
3969 * "name" == NULL, "fudi.fd_dict" set,
3970 * "fudi.fd_di" set, "fudi.fd_newkey" == NULL
3971 * s:func script-local function name
3972 * g:func global function name, same as "func"
3973 */
3974 p = eap->arg;
Bram Moolenaar04b12692020-05-04 23:24:44 +02003975 if (name_arg != NULL)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003976 {
Bram Moolenaar04b12692020-05-04 23:24:44 +02003977 // nested function, argument is (args).
3978 paren = TRUE;
3979 CLEAR_FIELD(fudi);
3980 }
3981 else
3982 {
Bram Moolenaareba3b7f2021-11-30 18:25:08 +00003983 name = save_function_name(&p, &is_global, eap->skip,
3984 TFN_NO_AUTOLOAD, &fudi);
Bram Moolenaar04b12692020-05-04 23:24:44 +02003985 paren = (vim_strchr(p, '(') != NULL);
3986 if (name == NULL && (fudi.fd_dict == NULL || !paren) && !eap->skip)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02003987 {
Bram Moolenaar04b12692020-05-04 23:24:44 +02003988 /*
3989 * Return on an invalid expression in braces, unless the expression
3990 * evaluation has been cancelled due to an aborting error, an
3991 * interrupt, or an exception.
3992 */
3993 if (!aborting())
3994 {
3995 if (!eap->skip && fudi.fd_newkey != NULL)
3996 semsg(_(e_dictkey), fudi.fd_newkey);
3997 vim_free(fudi.fd_newkey);
3998 return NULL;
3999 }
4000 else
4001 eap->skip = TRUE;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004002 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004003 }
4004
Bram Moolenaare38eab22019-12-05 21:50:01 +01004005 // An error in a function call during evaluation of an expression in magic
4006 // braces should not cause the function not to be defined.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004007 saved_did_emsg = did_emsg;
4008 did_emsg = FALSE;
4009
4010 /*
4011 * ":function func" with only function name: list function.
4012 */
4013 if (!paren)
4014 {
4015 if (!ends_excmd(*skipwhite(p)))
4016 {
Bram Moolenaar2d06bfd2020-07-23 17:16:18 +02004017 semsg(_(e_trailing_arg), p);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004018 goto ret_free;
4019 }
Bram Moolenaar63b91732021-08-05 20:40:03 +02004020 set_nextcmd(eap, p);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004021 if (eap->nextcmd != NULL)
4022 *p = NUL;
4023 if (!eap->skip && !got_int)
4024 {
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02004025 fp = find_func(name, is_global, NULL);
Bram Moolenaara26b9702020-04-18 19:53:28 +02004026 if (fp == NULL && ASCII_ISUPPER(*eap->arg))
4027 {
4028 char_u *up = untrans_function_name(name);
4029
4030 // With Vim9 script the name was made script-local, if not
4031 // found try again with the original name.
Bram Moolenaarec9749f2020-04-18 20:51:40 +02004032 if (up != NULL)
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02004033 fp = find_func(up, FALSE, NULL);
Bram Moolenaara26b9702020-04-18 19:53:28 +02004034 }
4035
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004036 if (fp != NULL)
4037 {
4038 list_func_head(fp, TRUE);
4039 for (j = 0; j < fp->uf_lines.ga_len && !got_int; ++j)
4040 {
4041 if (FUNCLINE(fp, j) == NULL)
4042 continue;
4043 msg_putchar('\n');
4044 msg_outnum((long)(j + 1));
4045 if (j < 9)
4046 msg_putchar(' ');
4047 if (j < 99)
4048 msg_putchar(' ');
4049 msg_prt_line(FUNCLINE(fp, j), FALSE);
Bram Moolenaare38eab22019-12-05 21:50:01 +01004050 out_flush(); // show a line at a time
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004051 ui_breakcheck();
4052 }
4053 if (!got_int)
4054 {
4055 msg_putchar('\n');
Bram Moolenaar0cb5bcf2020-06-20 18:19:09 +02004056 if (fp->uf_def_status != UF_NOT_COMPILED)
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004057 msg_puts(" enddef");
4058 else
4059 msg_puts(" endfunction");
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004060 }
4061 }
4062 else
Bram Moolenaara26b9702020-04-18 19:53:28 +02004063 emsg_funcname(N_("E123: Undefined function: %s"), eap->arg);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004064 }
4065 goto ret_free;
4066 }
4067
4068 /*
4069 * ":function name(arg1, arg2)" Define function.
4070 */
4071 p = skipwhite(p);
4072 if (*p != '(')
4073 {
4074 if (!eap->skip)
4075 {
Bram Moolenaarf9e3e092019-01-13 23:38:42 +01004076 semsg(_("E124: Missing '(': %s"), eap->arg);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004077 goto ret_free;
4078 }
Bram Moolenaare38eab22019-12-05 21:50:01 +01004079 // attempt to continue by skipping some text
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004080 if (vim_strchr(p, '(') != NULL)
4081 p = vim_strchr(p, '(');
4082 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004083
Bram Moolenaar4efd9942021-01-24 21:14:20 +01004084 if ((vim9script || eap->cmdidx == CMD_def) && VIM_ISWHITE(p[-1]))
4085 {
Bram Moolenaarba98fb52021-02-07 18:06:29 +01004086 semsg(_(e_no_white_space_allowed_before_str_str), "(", p - 1);
Bram Moolenaar4efd9942021-01-24 21:14:20 +01004087 goto ret_free;
4088 }
4089
Bram Moolenaar925e9fd2020-07-25 15:41:11 +02004090 // In Vim9 script only global functions can be redefined.
4091 if (vim9script && eap->forceit && !is_global)
4092 {
4093 emsg(_(e_nobang));
4094 goto ret_free;
4095 }
4096
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +01004097 ga_init2(&newlines, (int)sizeof(char_u *), 10);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004098
Bram Moolenaar04b12692020-05-04 23:24:44 +02004099 if (!eap->skip && name_arg == NULL)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004100 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01004101 // Check the name of the function. Unless it's a dictionary function
4102 // (that we are overwriting).
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004103 if (name != NULL)
4104 arg = name;
4105 else
4106 arg = fudi.fd_newkey;
4107 if (arg != NULL && (fudi.fd_di == NULL
4108 || (fudi.fd_di->di_tv.v_type != VAR_FUNC
4109 && fudi.fd_di->di_tv.v_type != VAR_PARTIAL)))
4110 {
4111 if (*arg == K_SPECIAL)
4112 j = 3;
4113 else
4114 j = 0;
4115 while (arg[j] != NUL && (j == 0 ? eval_isnamec1(arg[j])
4116 : eval_isnamec(arg[j])))
4117 ++j;
4118 if (arg[j] != NUL)
4119 emsg_funcname((char *)e_invarg2, arg);
4120 }
Bram Moolenaare38eab22019-12-05 21:50:01 +01004121 // Disallow using the g: dict.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004122 if (fudi.fd_dict != NULL && fudi.fd_dict->dv_scope == VAR_DEF_SCOPE)
Bram Moolenaarf9e3e092019-01-13 23:38:42 +01004123 emsg(_("E862: Cannot use g: here"));
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004124 }
4125
Bram Moolenaar5e774c72020-04-12 21:53:00 +02004126 // This may get more lines and make the pointers into the first line
4127 // invalid.
Bram Moolenaarcef12702021-01-04 14:09:43 +01004128 ++p;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004129 if (get_function_args(&p, ')', &newargs,
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +01004130 eap->cmdidx == CMD_def ? &argtypes : NULL, FALSE,
Bram Moolenaar057e84a2021-02-28 16:55:11 +01004131 NULL, &varargs, &default_args, eap->skip,
Bram Moolenaar5e774c72020-04-12 21:53:00 +02004132 eap, &line_to_free) == FAIL)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004133 goto errret_2;
Bram Moolenaarcef12702021-01-04 14:09:43 +01004134 whitep = p;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004135
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004136 if (eap->cmdidx == CMD_def)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004137 {
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004138 // find the return type: :def Func(): type
Bram Moolenaar33ea9fd2021-08-08 19:07:37 +02004139 if (*skipwhite(p) == ':')
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004140 {
Bram Moolenaar33ea9fd2021-08-08 19:07:37 +02004141 if (*p != ':')
4142 {
4143 semsg(_(e_no_white_space_allowed_before_colon_str), p);
4144 p = skipwhite(p);
4145 }
4146 else if (!IS_WHITE_OR_NUL(p[1]))
4147 semsg(_(e_white_space_required_after_str_str), ":", p);
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004148 ret_type = skipwhite(p + 1);
Bram Moolenaar4fc224c2020-07-26 17:56:25 +02004149 p = skip_type(ret_type, FALSE);
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004150 if (p > ret_type)
Bram Moolenaar5e774c72020-04-12 21:53:00 +02004151 {
Bram Moolenaar71ccd032020-06-12 22:59:11 +02004152 ret_type = vim_strnsave(ret_type, p - ret_type);
Bram Moolenaarcef12702021-01-04 14:09:43 +01004153 whitep = p;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004154 p = skipwhite(p);
Bram Moolenaar5e774c72020-04-12 21:53:00 +02004155 }
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004156 else
Bram Moolenaar5e774c72020-04-12 21:53:00 +02004157 {
Bram Moolenaar451c2e32020-08-15 16:33:28 +02004158 semsg(_(e_expected_type_str), ret_type);
Bram Moolenaarb8ce6b02020-04-23 22:23:14 +02004159 ret_type = NULL;
Bram Moolenaar5e774c72020-04-12 21:53:00 +02004160 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004161 }
Bram Moolenaare7e48382020-07-22 18:17:08 +02004162 p = skipwhite(p);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004163 }
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004164 else
4165 // find extra arguments "range", "dict", "abort" and "closure"
4166 for (;;)
4167 {
Bram Moolenaarcef12702021-01-04 14:09:43 +01004168 whitep = p;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004169 p = skipwhite(p);
4170 if (STRNCMP(p, "range", 5) == 0)
4171 {
4172 flags |= FC_RANGE;
4173 p += 5;
4174 }
4175 else if (STRNCMP(p, "dict", 4) == 0)
4176 {
4177 flags |= FC_DICT;
4178 p += 4;
4179 }
4180 else if (STRNCMP(p, "abort", 5) == 0)
4181 {
4182 flags |= FC_ABORT;
4183 p += 5;
4184 }
4185 else if (STRNCMP(p, "closure", 7) == 0)
4186 {
4187 flags |= FC_CLOSURE;
4188 p += 7;
4189 if (current_funccal == NULL)
4190 {
4191 emsg_funcname(N_("E932: Closure function should not be at top level: %s"),
4192 name == NULL ? (char_u *)"" : name);
4193 goto erret;
4194 }
4195 }
4196 else
4197 break;
4198 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004199
Bram Moolenaare38eab22019-12-05 21:50:01 +01004200 // When there is a line break use what follows for the function body.
4201 // Makes 'exe "func Test()\n...\nendfunc"' work.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004202 if (*p == '\n')
4203 line_arg = p + 1;
Bram Moolenaare7e48382020-07-22 18:17:08 +02004204 else if (*p != NUL
Bram Moolenaar98981072020-07-29 14:40:25 +02004205 && !(*p == '"' && (!vim9script || eap->cmdidx == CMD_function)
4206 && eap->cmdidx != CMD_def)
Bram Moolenaarcef12702021-01-04 14:09:43 +01004207 && !(VIM_ISWHITE(*whitep) && *p == '#'
4208 && (vim9script || eap->cmdidx == CMD_def))
Bram Moolenaare7e48382020-07-22 18:17:08 +02004209 && !eap->skip
4210 && !did_emsg)
Bram Moolenaar2d06bfd2020-07-23 17:16:18 +02004211 semsg(_(e_trailing_arg), p);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004212
4213 /*
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004214 * Read the body of the function, until "}", ":endfunction" or ":enddef" is
4215 * found.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004216 */
4217 if (KeyTyped)
4218 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01004219 // Check if the function already exists, don't let the user type the
4220 // whole function before telling him it doesn't work! For a script we
4221 // need to skip the body to be able to find what follows.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004222 if (!eap->skip && !eap->forceit)
4223 {
4224 if (fudi.fd_dict != NULL && fudi.fd_newkey == NULL)
Bram Moolenaarf9e3e092019-01-13 23:38:42 +01004225 emsg(_(e_funcdict));
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02004226 else if (name != NULL && find_func(name, is_global, NULL) != NULL)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004227 emsg_funcname(e_funcexts, name);
4228 }
4229
4230 if (!eap->skip && did_emsg)
4231 goto erret;
4232
Bram Moolenaare38eab22019-12-05 21:50:01 +01004233 msg_putchar('\n'); // don't overwrite the function name
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004234 cmdline_row = msg_row;
4235 }
4236
Bram Moolenaarbc2cfe42019-07-04 14:57:12 +02004237 // Save the starting line number.
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01004238 sourcing_lnum_top = SOURCING_LNUM;
Bram Moolenaarbc2cfe42019-07-04 14:57:12 +02004239
Bram Moolenaard87c21a2021-05-18 13:40:33 +02004240 // Do not define the function when getting the body fails and when
4241 // skipping.
4242 if (get_function_body(eap, &newlines, line_arg, &line_to_free) == FAIL
4243 || eap->skip)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004244 goto erret;
4245
4246 /*
4247 * If there are no errors, add the function
4248 */
4249 if (fudi.fd_dict == NULL)
4250 {
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004251 hashtab_T *ht;
4252
Bram Moolenaar32b3f822021-01-06 21:59:39 +01004253 v = find_var(name, &ht, TRUE);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004254 if (v != NULL && v->di_tv.v_type == VAR_FUNC)
4255 {
4256 emsg_funcname(N_("E707: Function name conflicts with variable: %s"),
4257 name);
4258 goto erret;
4259 }
4260
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02004261 fp = find_func_even_dead(name, is_global, NULL);
Bram Moolenaareef21022020-08-01 22:16:43 +02004262 if (vim9script)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004263 {
Bram Moolenaareef21022020-08-01 22:16:43 +02004264 char_u *uname = untrans_function_name(name);
4265
4266 import = find_imported(uname == NULL ? name : uname, 0, NULL);
4267 }
4268
4269 if (fp != NULL || import != NULL)
4270 {
4271 int dead = fp != NULL && (fp->uf_flags & FC_DEAD);
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004272
Bram Moolenaarded5f1b2018-11-10 17:33:29 +01004273 // Function can be replaced with "function!" and when sourcing the
4274 // same script again, but only once.
Bram Moolenaareef21022020-08-01 22:16:43 +02004275 // A name that is used by an import can not be overruled.
4276 if (import != NULL
4277 || (!dead && !eap->forceit
Bram Moolenaarded5f1b2018-11-10 17:33:29 +01004278 && (fp->uf_script_ctx.sc_sid != current_sctx.sc_sid
Bram Moolenaareef21022020-08-01 22:16:43 +02004279 || fp->uf_script_ctx.sc_seq == current_sctx.sc_seq)))
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004280 {
Bram Moolenaard604d782021-11-20 21:46:20 +00004281 SOURCING_LNUM = sourcing_lnum_top;
Bram Moolenaareef21022020-08-01 22:16:43 +02004282 if (vim9script)
Bram Moolenaar7cb6fc22020-08-21 22:36:47 +02004283 emsg_funcname(e_name_already_defined_str, name);
Bram Moolenaareef21022020-08-01 22:16:43 +02004284 else
4285 emsg_funcname(e_funcexts, name);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004286 goto erret;
4287 }
4288 if (fp->uf_calls > 0)
4289 {
Bram Moolenaarded5f1b2018-11-10 17:33:29 +01004290 emsg_funcname(
4291 N_("E127: Cannot redefine function %s: It is in use"),
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004292 name);
4293 goto erret;
4294 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02004295 if (fp->uf_refcount > 1)
4296 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01004297 // This function is referenced somewhere, don't redefine it but
4298 // create a new one.
Bram Moolenaar437bafe2016-08-01 15:40:54 +02004299 --fp->uf_refcount;
Bram Moolenaar8dd3a432016-08-01 20:46:25 +02004300 fp->uf_flags |= FC_REMOVED;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02004301 fp = NULL;
4302 overwrite = TRUE;
4303 }
4304 else
4305 {
Bram Moolenaarb9adef72020-01-02 14:31:22 +01004306 char_u *exp_name = fp->uf_name_exp;
4307
4308 // redefine existing function, keep the expanded name
Bram Moolenaard23a8232018-02-10 18:45:26 +01004309 VIM_CLEAR(name);
Bram Moolenaarb9adef72020-01-02 14:31:22 +01004310 fp->uf_name_exp = NULL;
Bram Moolenaar79c2ad52018-07-29 17:40:43 +02004311 func_clear_items(fp);
Bram Moolenaarb9adef72020-01-02 14:31:22 +01004312 fp->uf_name_exp = exp_name;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004313 fp->uf_flags &= ~FC_DEAD;
Bram Moolenaar79c2ad52018-07-29 17:40:43 +02004314#ifdef FEAT_PROFILE
4315 fp->uf_profiling = FALSE;
4316 fp->uf_prof_initialized = FALSE;
4317#endif
Bram Moolenaarcdc40c42020-12-26 17:43:08 +01004318 fp->uf_def_status = UF_NOT_COMPILED;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02004319 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004320 }
4321 }
4322 else
4323 {
4324 char numbuf[20];
4325
4326 fp = NULL;
4327 if (fudi.fd_newkey == NULL && !eap->forceit)
4328 {
Bram Moolenaarf9e3e092019-01-13 23:38:42 +01004329 emsg(_(e_funcdict));
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004330 goto erret;
4331 }
4332 if (fudi.fd_di == NULL)
4333 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01004334 // Can't add a function to a locked dictionary
Bram Moolenaara187c432020-09-16 21:08:28 +02004335 if (value_check_lock(fudi.fd_dict->dv_lock, eap->arg, FALSE))
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004336 goto erret;
4337 }
Bram Moolenaare38eab22019-12-05 21:50:01 +01004338 // Can't change an existing function if it is locked
Bram Moolenaara187c432020-09-16 21:08:28 +02004339 else if (value_check_lock(fudi.fd_di->di_tv.v_lock, eap->arg, FALSE))
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004340 goto erret;
4341
Bram Moolenaare38eab22019-12-05 21:50:01 +01004342 // Give the function a sequential number. Can only be used with a
4343 // Funcref!
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004344 vim_free(name);
4345 sprintf(numbuf, "%d", ++func_nr);
4346 name = vim_strsave((char_u *)numbuf);
4347 if (name == NULL)
4348 goto erret;
4349 }
4350
4351 if (fp == NULL)
4352 {
4353 if (fudi.fd_dict == NULL && vim_strchr(name, AUTOLOAD_CHAR) != NULL)
4354 {
4355 int slen, plen;
4356 char_u *scriptname;
4357
Bram Moolenaare38eab22019-12-05 21:50:01 +01004358 // Check that the autoload name matches the script name.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004359 j = FAIL;
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01004360 if (SOURCING_NAME != NULL)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004361 {
4362 scriptname = autoload_name(name);
4363 if (scriptname != NULL)
4364 {
4365 p = vim_strchr(scriptname, '/');
4366 plen = (int)STRLEN(p);
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01004367 slen = (int)STRLEN(SOURCING_NAME);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004368 if (slen > plen && fnamecmp(p,
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01004369 SOURCING_NAME + slen - plen) == 0)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004370 j = OK;
4371 vim_free(scriptname);
4372 }
4373 }
4374 if (j == FAIL)
4375 {
Bram Moolenaarf48b2fa2021-04-12 22:02:36 +02004376 linenr_T save_lnum = SOURCING_LNUM;
4377
4378 SOURCING_LNUM = sourcing_lnum_top;
Bram Moolenaarf9e3e092019-01-13 23:38:42 +01004379 semsg(_("E746: Function name does not match script file name: %s"), name);
Bram Moolenaarf48b2fa2021-04-12 22:02:36 +02004380 SOURCING_LNUM = save_lnum;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004381 goto erret;
4382 }
4383 }
4384
Bram Moolenaar47ed5532019-08-08 20:49:14 +02004385 fp = alloc_clear(offsetof(ufunc_T, uf_name) + STRLEN(name) + 1);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004386 if (fp == NULL)
4387 goto erret;
4388
4389 if (fudi.fd_dict != NULL)
4390 {
4391 if (fudi.fd_di == NULL)
4392 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01004393 // add new dict entry
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004394 fudi.fd_di = dictitem_alloc(fudi.fd_newkey);
4395 if (fudi.fd_di == NULL)
4396 {
4397 vim_free(fp);
Bram Moolenaara14e6972020-05-25 23:29:28 +02004398 fp = NULL;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004399 goto erret;
4400 }
4401 if (dict_add(fudi.fd_dict, fudi.fd_di) == FAIL)
4402 {
4403 vim_free(fudi.fd_di);
4404 vim_free(fp);
Bram Moolenaara14e6972020-05-25 23:29:28 +02004405 fp = NULL;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004406 goto erret;
4407 }
4408 }
4409 else
Bram Moolenaare38eab22019-12-05 21:50:01 +01004410 // overwrite existing dict entry
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004411 clear_tv(&fudi.fd_di->di_tv);
4412 fudi.fd_di->di_tv.v_type = VAR_FUNC;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004413 fudi.fd_di->di_tv.vval.v_string = vim_strsave(name);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004414
Bram Moolenaare38eab22019-12-05 21:50:01 +01004415 // behave like "dict" was used
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004416 flags |= FC_DICT;
4417 }
4418
Bram Moolenaare38eab22019-12-05 21:50:01 +01004419 // insert the new function in the function list
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01004420 set_ufunc_name(fp, name);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02004421 if (overwrite)
4422 {
4423 hi = hash_find(&func_hashtab, name);
4424 hi->hi_key = UF2HIKEY(fp);
4425 }
4426 else if (hash_add(&func_hashtab, UF2HIKEY(fp)) == FAIL)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004427 {
4428 vim_free(fp);
Bram Moolenaara14e6972020-05-25 23:29:28 +02004429 fp = NULL;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004430 goto erret;
4431 }
Bram Moolenaar437bafe2016-08-01 15:40:54 +02004432 fp->uf_refcount = 1;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004433 }
4434 fp->uf_args = newargs;
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02004435 fp->uf_def_args = default_args;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004436 fp->uf_ret_type = &t_any;
Bram Moolenaar5deeb3f2020-04-05 17:08:17 +02004437 fp->uf_func_type = &t_func_any;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004438
4439 if (eap->cmdidx == CMD_def)
4440 {
Bram Moolenaar39ca4122020-10-20 14:25:07 +02004441 int lnum_save = SOURCING_LNUM;
4442 cstack_T *cstack = eap->cstack;
Bram Moolenaarbfe12042020-02-04 21:54:07 +01004443
Bram Moolenaar0cb5bcf2020-06-20 18:19:09 +02004444 fp->uf_def_status = UF_TO_BE_COMPILED;
Bram Moolenaar822ba242020-05-24 23:00:18 +02004445
Bram Moolenaarbfe12042020-02-04 21:54:07 +01004446 // error messages are for the first function line
4447 SOURCING_LNUM = sourcing_lnum_top;
4448
Bram Moolenaar2eb6fc32021-07-25 14:13:53 +02004449 // The function may use script variables from the context.
4450 function_using_block_scopes(fp, cstack);
Bram Moolenaarfbbcd002020-10-15 12:46:44 +02004451
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +01004452 if (parse_argument_types(fp, &argtypes, varargs) == FAIL)
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004453 {
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +01004454 SOURCING_LNUM = lnum_save;
4455 goto errret_2;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004456 }
Bram Moolenaarb4d16cb2020-11-05 18:45:46 +01004457 varargs = FALSE;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004458
4459 // parse the return type, if any
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +01004460 if (parse_return_type(fp, ret_type) == FAIL)
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004461 {
Bram Moolenaar7a6eaa02021-03-21 20:53:29 +01004462 SOURCING_LNUM = lnum_save;
4463 goto erret;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004464 }
Bram Moolenaar09689a02020-05-09 22:50:08 +02004465 SOURCING_LNUM = lnum_save;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004466 }
Bram Moolenaar822ba242020-05-24 23:00:18 +02004467 else
Bram Moolenaar0cb5bcf2020-06-20 18:19:09 +02004468 fp->uf_def_status = UF_NOT_COMPILED;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004469
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004470 fp->uf_lines = newlines;
Bram Moolenaar10ce39a2016-07-29 22:37:06 +02004471 if ((flags & FC_CLOSURE) != 0)
4472 {
Bram Moolenaar58016442016-07-31 18:30:22 +02004473 if (register_closure(fp) == FAIL)
Bram Moolenaar10ce39a2016-07-29 22:37:06 +02004474 goto erret;
Bram Moolenaar10ce39a2016-07-29 22:37:06 +02004475 }
4476 else
4477 fp->uf_scoped = NULL;
4478
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004479#ifdef FEAT_PROFILE
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004480 if (prof_def_func())
4481 func_do_profile(fp);
4482#endif
4483 fp->uf_varargs = varargs;
Bram Moolenaar93343722018-07-10 19:39:18 +02004484 if (sandbox)
4485 flags |= FC_SANDBOX;
Bram Moolenaare7e48382020-07-22 18:17:08 +02004486 if (vim9script && !ASCII_ISUPPER(*fp->uf_name))
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02004487 flags |= FC_VIM9;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004488 fp->uf_flags = flags;
4489 fp->uf_calls = 0;
Bram Moolenaar63ce4842020-02-19 15:46:48 +01004490 fp->uf_cleared = FALSE;
Bram Moolenaarf29c1c62018-09-10 21:05:02 +02004491 fp->uf_script_ctx = current_sctx;
Bram Moolenaarf9b2b492020-08-05 14:34:14 +02004492 fp->uf_script_ctx_version = current_sctx.sc_version;
Bram Moolenaarbc2cfe42019-07-04 14:57:12 +02004493 fp->uf_script_ctx.sc_lnum += sourcing_lnum_top;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004494 if (is_export)
4495 {
4496 fp->uf_flags |= FC_EXPORT;
4497 // let ex_export() know the export worked.
4498 is_export = FALSE;
4499 }
4500
Bram Moolenaar6ff71d82020-05-24 23:45:24 +02004501 if (eap->cmdidx == CMD_def)
4502 set_function_type(fp);
Bram Moolenaar67979662020-06-20 22:50:47 +02004503 else if (fp->uf_script_ctx.sc_version == SCRIPT_VERSION_VIM9)
4504 // :func does not use Vim9 script syntax, even in a Vim9 script file
4505 fp->uf_script_ctx.sc_version = SCRIPT_VERSION_MAX;
Bram Moolenaar6ff71d82020-05-24 23:45:24 +02004506
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004507 goto ret_free;
4508
4509erret:
4510 ga_clear_strings(&newargs);
Bram Moolenaar42ae78c2019-05-09 21:08:58 +02004511 ga_clear_strings(&default_args);
Bram Moolenaar31842cd2021-02-12 22:10:21 +01004512 if (fp != NULL)
4513 {
4514 ga_init(&fp->uf_args);
4515 ga_init(&fp->uf_def_args);
4516 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004517errret_2:
4518 ga_clear_strings(&newlines);
Bram Moolenaar31842cd2021-02-12 22:10:21 +01004519 if (fp != NULL)
4520 VIM_CLEAR(fp->uf_arg_types);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004521ret_free:
Bram Moolenaar292b90d2020-03-18 15:23:16 +01004522 ga_clear_strings(&argtypes);
Bram Moolenaar53564f72017-06-24 14:48:11 +02004523 vim_free(line_to_free);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004524 vim_free(fudi.fd_newkey);
Bram Moolenaar04b12692020-05-04 23:24:44 +02004525 if (name != name_arg)
4526 vim_free(name);
Bram Moolenaar5e774c72020-04-12 21:53:00 +02004527 vim_free(ret_type);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004528 did_emsg |= saved_did_emsg;
Bram Moolenaar04b12692020-05-04 23:24:44 +02004529
4530 return fp;
4531}
4532
4533/*
4534 * ":function"
4535 */
4536 void
4537ex_function(exarg_T *eap)
4538{
Bram Moolenaarfbbcd002020-10-15 12:46:44 +02004539 (void)define_function(eap, NULL);
Bram Moolenaar822ba242020-05-24 23:00:18 +02004540}
4541
4542/*
Bram Moolenaar96f8f492020-09-09 17:08:51 +02004543 * :defcompile - compile all :def functions in the current script that need to
Bram Moolenaarb2049902021-01-24 12:53:53 +01004544 * be compiled. Except dead functions. Doesn't do profiling.
Bram Moolenaar822ba242020-05-24 23:00:18 +02004545 */
4546 void
4547ex_defcompile(exarg_T *eap UNUSED)
4548{
Bram Moolenaar7ce85be2020-07-14 15:01:05 +02004549 long todo = (long)func_hashtab.ht_used;
4550 int changed = func_hashtab.ht_changed;
Bram Moolenaar822ba242020-05-24 23:00:18 +02004551 hashitem_T *hi;
4552 ufunc_T *ufunc;
4553
4554 for (hi = func_hashtab.ht_array; todo > 0 && !got_int; ++hi)
4555 {
4556 if (!HASHITEM_EMPTY(hi))
4557 {
4558 --todo;
4559 ufunc = HI2UF(hi);
4560 if (ufunc->uf_script_ctx.sc_sid == current_sctx.sc_sid
Bram Moolenaar96f8f492020-09-09 17:08:51 +02004561 && ufunc->uf_def_status == UF_TO_BE_COMPILED
4562 && (ufunc->uf_flags & FC_DEAD) == 0)
Bram Moolenaarebc3de62020-05-26 11:08:28 +02004563 {
Bram Moolenaare99d4222021-06-13 14:01:26 +02004564 (void)compile_def_function(ufunc, FALSE, CT_NONE, NULL);
Bram Moolenaarebc3de62020-05-26 11:08:28 +02004565
Bram Moolenaar7ce85be2020-07-14 15:01:05 +02004566 if (func_hashtab.ht_changed != changed)
Bram Moolenaarebc3de62020-05-26 11:08:28 +02004567 {
Bram Moolenaar7ce85be2020-07-14 15:01:05 +02004568 // a function has been added or removed, need to start over
4569 todo = (long)func_hashtab.ht_used;
4570 changed = func_hashtab.ht_changed;
Bram Moolenaarebc3de62020-05-26 11:08:28 +02004571 hi = func_hashtab.ht_array;
Bram Moolenaar285b1892020-05-26 11:37:26 +02004572 --hi;
Bram Moolenaarebc3de62020-05-26 11:08:28 +02004573 }
4574 }
Bram Moolenaar822ba242020-05-24 23:00:18 +02004575 }
4576 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004577}
4578
4579/*
4580 * Return 5 if "p" starts with "<SID>" or "<SNR>" (ignoring case).
4581 * Return 2 if "p" starts with "s:".
4582 * Return 0 otherwise.
4583 */
4584 int
4585eval_fname_script(char_u *p)
4586{
Bram Moolenaare38eab22019-12-05 21:50:01 +01004587 // Use MB_STRICMP() because in Turkish comparing the "I" may not work with
4588 // the standard library function.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004589 if (p[0] == '<' && (MB_STRNICMP(p + 1, "SID>", 4) == 0
4590 || MB_STRNICMP(p + 1, "SNR>", 4) == 0))
4591 return 5;
4592 if (p[0] == 's' && p[1] == ':')
4593 return 2;
4594 return 0;
4595}
4596
4597 int
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02004598translated_function_exists(char_u *name, int is_global)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004599{
4600 if (builtin_function(name, -1))
Bram Moolenaarac92e252019-08-03 21:58:38 +02004601 return has_internal_func(name);
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02004602 return find_func(name, is_global, NULL) != NULL;
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004603}
4604
4605/*
4606 * Return TRUE when "ufunc" has old-style "..." varargs
4607 * or named varargs "...name: type".
4608 */
4609 int
4610has_varargs(ufunc_T *ufunc)
4611{
4612 return ufunc->uf_varargs || ufunc->uf_va_name != NULL;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004613}
4614
4615/*
4616 * Return TRUE if a function "name" exists.
Bram Moolenaarb54c3ff2016-07-31 14:11:58 +02004617 * If "no_defef" is TRUE, do not dereference a Funcref.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004618 */
4619 int
Bram Moolenaarb54c3ff2016-07-31 14:11:58 +02004620function_exists(char_u *name, int no_deref)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004621{
4622 char_u *nm = name;
4623 char_u *p;
4624 int n = FALSE;
Bram Moolenaarb54c3ff2016-07-31 14:11:58 +02004625 int flag;
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02004626 int is_global = FALSE;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004627
Bram Moolenaarb54c3ff2016-07-31 14:11:58 +02004628 flag = TFN_INT | TFN_QUIET | TFN_NO_AUTOLOAD;
4629 if (no_deref)
4630 flag |= TFN_NO_DEREF;
Bram Moolenaar32b3f822021-01-06 21:59:39 +01004631 p = trans_function_name(&nm, &is_global, FALSE, flag, NULL, NULL, NULL);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004632 nm = skipwhite(nm);
4633
Bram Moolenaare38eab22019-12-05 21:50:01 +01004634 // Only accept "funcname", "funcname ", "funcname (..." and
4635 // "funcname(...", not "funcname!...".
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004636 if (p != NULL && (*nm == NUL || *nm == '('))
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02004637 n = translated_function_exists(p, is_global);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004638 vim_free(p);
4639 return n;
4640}
4641
Bram Moolenaar113e1072019-01-20 15:30:40 +01004642#if defined(FEAT_PYTHON) || defined(FEAT_PYTHON3) || defined(PROTO)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004643 char_u *
4644get_expanded_name(char_u *name, int check)
4645{
4646 char_u *nm = name;
4647 char_u *p;
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02004648 int is_global = FALSE;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004649
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02004650 p = trans_function_name(&nm, &is_global, FALSE,
Bram Moolenaar32b3f822021-01-06 21:59:39 +01004651 TFN_INT|TFN_QUIET, NULL, NULL, NULL);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004652
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02004653 if (p != NULL && *nm == NUL
4654 && (!check || translated_function_exists(p, is_global)))
4655 return p;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004656
4657 vim_free(p);
4658 return NULL;
4659}
Bram Moolenaar113e1072019-01-20 15:30:40 +01004660#endif
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004661
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004662/*
4663 * Function given to ExpandGeneric() to obtain the list of user defined
4664 * function names.
4665 */
4666 char_u *
4667get_user_func_name(expand_T *xp, int idx)
4668{
4669 static long_u done;
Bram Moolenaar1f22cc52020-07-14 21:08:49 +02004670 static int changed;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004671 static hashitem_T *hi;
4672 ufunc_T *fp;
4673
4674 if (idx == 0)
4675 {
4676 done = 0;
4677 hi = func_hashtab.ht_array;
Bram Moolenaar1f22cc52020-07-14 21:08:49 +02004678 changed = func_hashtab.ht_changed;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004679 }
Bram Moolenaar1f22cc52020-07-14 21:08:49 +02004680 if (changed == func_hashtab.ht_changed && done < func_hashtab.ht_used)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004681 {
4682 if (done++ > 0)
4683 ++hi;
4684 while (HASHITEM_EMPTY(hi))
4685 ++hi;
4686 fp = HI2UF(hi);
4687
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004688 // don't show dead, dict and lambda functions
4689 if ((fp->uf_flags & FC_DEAD) || (fp->uf_flags & FC_DICT)
Bram Moolenaarb49edc12016-07-23 15:47:34 +02004690 || STRNCMP(fp->uf_name, "<lambda>", 8) == 0)
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004691 return (char_u *)"";
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004692
4693 if (STRLEN(fp->uf_name) + 4 >= IOSIZE)
Bram Moolenaare38eab22019-12-05 21:50:01 +01004694 return fp->uf_name; // prevents overflow
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004695
4696 cat_func_name(IObuff, fp);
naohiro ono9aecf792021-08-28 15:56:06 +02004697 if (xp->xp_context != EXPAND_USER_FUNC
4698 && xp->xp_context != EXPAND_DISASSEMBLE)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004699 {
4700 STRCAT(IObuff, "(");
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01004701 if (!has_varargs(fp) && fp->uf_args.ga_len == 0)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004702 STRCAT(IObuff, ")");
4703 }
4704 return IObuff;
4705 }
4706 return NULL;
4707}
4708
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004709/*
4710 * ":delfunction {name}"
4711 */
4712 void
4713ex_delfunction(exarg_T *eap)
4714{
4715 ufunc_T *fp = NULL;
4716 char_u *p;
4717 char_u *name;
4718 funcdict_T fudi;
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02004719 int is_global = FALSE;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004720
4721 p = eap->arg;
Bram Moolenaar32b3f822021-01-06 21:59:39 +01004722 name = trans_function_name(&p, &is_global, eap->skip, 0, &fudi,
4723 NULL, NULL);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004724 vim_free(fudi.fd_newkey);
4725 if (name == NULL)
4726 {
4727 if (fudi.fd_dict != NULL && !eap->skip)
Bram Moolenaarf9e3e092019-01-13 23:38:42 +01004728 emsg(_(e_funcref));
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004729 return;
4730 }
4731 if (!ends_excmd(*skipwhite(p)))
4732 {
4733 vim_free(name);
Bram Moolenaar2d06bfd2020-07-23 17:16:18 +02004734 semsg(_(e_trailing_arg), p);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004735 return;
4736 }
Bram Moolenaar63b91732021-08-05 20:40:03 +02004737 set_nextcmd(eap, p);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004738 if (eap->nextcmd != NULL)
4739 *p = NUL;
4740
Bram Moolenaarddfc0512021-09-06 20:56:56 +02004741 if (isdigit(*name) && fudi.fd_dict == NULL)
4742 {
4743 if (!eap->skip)
4744 semsg(_(e_invarg2), eap->arg);
4745 vim_free(name);
4746 return;
4747 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004748 if (!eap->skip)
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02004749 fp = find_func(name, is_global, NULL);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004750 vim_free(name);
4751
4752 if (!eap->skip)
4753 {
4754 if (fp == NULL)
4755 {
Bram Moolenaard6abcd12017-06-22 19:15:24 +02004756 if (!eap->forceit)
Bram Moolenaarf9e3e092019-01-13 23:38:42 +01004757 semsg(_(e_nofunc), eap->arg);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004758 return;
4759 }
4760 if (fp->uf_calls > 0)
4761 {
Bram Moolenaarf9e3e092019-01-13 23:38:42 +01004762 semsg(_("E131: Cannot delete function %s: It is in use"), eap->arg);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004763 return;
4764 }
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02004765 if (fp->uf_flags & FC_VIM9)
4766 {
Bram Moolenaar451c2e32020-08-15 16:33:28 +02004767 semsg(_(e_cannot_delete_vim9_script_function_str), eap->arg);
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02004768 return;
4769 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004770
4771 if (fudi.fd_dict != NULL)
4772 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01004773 // Delete the dict item that refers to the function, it will
4774 // invoke func_unref() and possibly delete the function.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004775 dictitem_remove(fudi.fd_dict, fudi.fd_di);
4776 }
4777 else
Bram Moolenaar437bafe2016-08-01 15:40:54 +02004778 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01004779 // A normal function (not a numbered function or lambda) has a
4780 // refcount of 1 for the entry in the hashtable. When deleting
4781 // it and the refcount is more than one, it should be kept.
4782 // A numbered function and lambda should be kept if the refcount is
4783 // one or more.
Bram Moolenaar8dd3a432016-08-01 20:46:25 +02004784 if (fp->uf_refcount > (func_name_refcount(fp->uf_name) ? 0 : 1))
Bram Moolenaar437bafe2016-08-01 15:40:54 +02004785 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01004786 // Function is still referenced somewhere. Don't free it but
4787 // do remove it from the hashtable.
Bram Moolenaar8dd3a432016-08-01 20:46:25 +02004788 if (func_remove(fp))
4789 fp->uf_refcount--;
Bram Moolenaar437bafe2016-08-01 15:40:54 +02004790 }
4791 else
Bram Moolenaar03ff9bc2017-02-02 22:59:27 +01004792 func_clear_free(fp, FALSE);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02004793 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004794 }
4795}
4796
4797/*
4798 * Unreference a Function: decrement the reference count and free it when it
Bram Moolenaar437bafe2016-08-01 15:40:54 +02004799 * becomes zero.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004800 */
4801 void
4802func_unref(char_u *name)
4803{
Bram Moolenaar97baee82016-07-26 20:46:08 +02004804 ufunc_T *fp = NULL;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004805
Bram Moolenaar8dd3a432016-08-01 20:46:25 +02004806 if (name == NULL || !func_name_refcount(name))
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004807 return;
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02004808 fp = find_func(name, FALSE, NULL);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02004809 if (fp == NULL && isdigit(*name))
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004810 {
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004811#ifdef EXITFREE
Bram Moolenaar437bafe2016-08-01 15:40:54 +02004812 if (!entered_free_all_mem)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004813#endif
Bram Moolenaar95f09602016-11-10 20:01:45 +01004814 internal_error("func_unref()");
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004815 }
Bram Moolenaar0d3de8c2021-01-22 20:46:27 +01004816 func_ptr_unref(fp);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02004817}
4818
4819/*
4820 * Unreference a Function: decrement the reference count and free it when it
4821 * becomes zero.
Bram Moolenaar0d3de8c2021-01-22 20:46:27 +01004822 * Also when it becomes one and uf_partial points to the function.
Bram Moolenaar437bafe2016-08-01 15:40:54 +02004823 */
4824 void
4825func_ptr_unref(ufunc_T *fp)
4826{
Bram Moolenaar0d3de8c2021-01-22 20:46:27 +01004827 if (fp != NULL && (--fp->uf_refcount <= 0
4828 || (fp->uf_refcount == 1 && fp->uf_partial != NULL
4829 && fp->uf_partial->pt_refcount <= 1
4830 && fp->uf_partial->pt_func == fp)))
Bram Moolenaar97baee82016-07-26 20:46:08 +02004831 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01004832 // Only delete it when it's not being used. Otherwise it's done
4833 // when "uf_calls" becomes zero.
Bram Moolenaar97baee82016-07-26 20:46:08 +02004834 if (fp->uf_calls == 0)
Bram Moolenaar03ff9bc2017-02-02 22:59:27 +01004835 func_clear_free(fp, FALSE);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004836 }
4837}
4838
4839/*
4840 * Count a reference to a Function.
4841 */
4842 void
4843func_ref(char_u *name)
4844{
4845 ufunc_T *fp;
4846
Bram Moolenaar8dd3a432016-08-01 20:46:25 +02004847 if (name == NULL || !func_name_refcount(name))
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004848 return;
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02004849 fp = find_func(name, FALSE, NULL);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02004850 if (fp != NULL)
4851 ++fp->uf_refcount;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004852 else if (isdigit(*name))
Bram Moolenaare38eab22019-12-05 21:50:01 +01004853 // Only give an error for a numbered function.
4854 // Fail silently, when named or lambda function isn't found.
Bram Moolenaar95f09602016-11-10 20:01:45 +01004855 internal_error("func_ref()");
Bram Moolenaar437bafe2016-08-01 15:40:54 +02004856}
4857
4858/*
4859 * Count a reference to a Function.
4860 */
4861 void
4862func_ptr_ref(ufunc_T *fp)
4863{
4864 if (fp != NULL)
4865 ++fp->uf_refcount;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004866}
4867
4868/*
4869 * Return TRUE if items in "fc" do not have "copyID". That means they are not
4870 * referenced from anywhere that is in use.
4871 */
4872 static int
4873can_free_funccal(funccall_T *fc, int copyID)
4874{
4875 return (fc->l_varlist.lv_copyID != copyID
4876 && fc->l_vars.dv_copyID != copyID
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02004877 && fc->l_avars.dv_copyID != copyID
4878 && fc->fc_copyID != copyID);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004879}
4880
4881/*
4882 * ":return [expr]"
4883 */
4884 void
4885ex_return(exarg_T *eap)
4886{
4887 char_u *arg = eap->arg;
4888 typval_T rettv;
4889 int returning = FALSE;
Bram Moolenaar5409f5d2020-06-24 18:37:35 +02004890 evalarg_T evalarg;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004891
4892 if (current_funccal == NULL)
4893 {
Bram Moolenaarf9e3e092019-01-13 23:38:42 +01004894 emsg(_("E133: :return not inside a function"));
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004895 return;
4896 }
4897
Bram Moolenaar844fb642021-10-23 13:32:30 +01004898 init_evalarg(&evalarg);
Bram Moolenaar5409f5d2020-06-24 18:37:35 +02004899 evalarg.eval_flags = eap->skip ? 0 : EVAL_EVALUATE;
4900
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004901 if (eap->skip)
4902 ++emsg_skip;
4903
4904 eap->nextcmd = NULL;
4905 if ((*arg != NUL && *arg != '|' && *arg != '\n')
Bram Moolenaarb171fb12020-06-24 20:34:03 +02004906 && eval0(arg, &rettv, eap, &evalarg) != FAIL)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004907 {
4908 if (!eap->skip)
4909 returning = do_return(eap, FALSE, TRUE, &rettv);
4910 else
4911 clear_tv(&rettv);
4912 }
Bram Moolenaare38eab22019-12-05 21:50:01 +01004913 // It's safer to return also on error.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004914 else if (!eap->skip)
4915 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01004916 // In return statement, cause_abort should be force_abort.
Bram Moolenaarfabaf752017-12-23 17:26:11 +01004917 update_force_abort();
4918
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004919 /*
4920 * Return unless the expression evaluation has been cancelled due to an
4921 * aborting error, an interrupt, or an exception.
4922 */
4923 if (!aborting())
4924 returning = do_return(eap, FALSE, TRUE, NULL);
4925 }
4926
Bram Moolenaare38eab22019-12-05 21:50:01 +01004927 // When skipping or the return gets pending, advance to the next command
4928 // in this line (!returning). Otherwise, ignore the rest of the line.
4929 // Following lines will be ignored by get_func_line().
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004930 if (returning)
4931 eap->nextcmd = NULL;
Bram Moolenaare38eab22019-12-05 21:50:01 +01004932 else if (eap->nextcmd == NULL) // no argument
Bram Moolenaar63b91732021-08-05 20:40:03 +02004933 set_nextcmd(eap, arg);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004934
4935 if (eap->skip)
4936 --emsg_skip;
Bram Moolenaarb7a78f72020-06-28 18:43:40 +02004937 clear_evalarg(&evalarg, eap);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004938}
4939
4940/*
4941 * ":1,25call func(arg1, arg2)" function call.
4942 */
4943 void
4944ex_call(exarg_T *eap)
4945{
4946 char_u *arg = eap->arg;
4947 char_u *startarg;
4948 char_u *name;
4949 char_u *tofree;
4950 int len;
4951 typval_T rettv;
4952 linenr_T lnum;
4953 int doesrange;
4954 int failed = FALSE;
4955 funcdict_T fudi;
4956 partial_T *partial = NULL;
Bram Moolenaare6b53242020-07-01 17:28:33 +02004957 evalarg_T evalarg;
Bram Moolenaar32b3f822021-01-06 21:59:39 +01004958 type_T *type = NULL;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004959
Bram Moolenaare6b53242020-07-01 17:28:33 +02004960 fill_evalarg_from_eap(&evalarg, eap, eap->skip);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004961 if (eap->skip)
4962 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01004963 // trans_function_name() doesn't work well when skipping, use eval0()
4964 // instead to skip to any following command, e.g. for:
4965 // :if 0 | call dict.foo().bar() | endif
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004966 ++emsg_skip;
Bram Moolenaare6b53242020-07-01 17:28:33 +02004967 if (eval0(eap->arg, &rettv, eap, &evalarg) != FAIL)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004968 clear_tv(&rettv);
4969 --emsg_skip;
Bram Moolenaare6b53242020-07-01 17:28:33 +02004970 clear_evalarg(&evalarg, eap);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004971 return;
4972 }
4973
Bram Moolenaar32b3f822021-01-06 21:59:39 +01004974 tofree = trans_function_name(&arg, NULL, eap->skip, TFN_INT,
4975 &fudi, &partial, in_vim9script() ? &type : NULL);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004976 if (fudi.fd_newkey != NULL)
4977 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01004978 // Still need to give an error message for missing key.
Bram Moolenaarf9e3e092019-01-13 23:38:42 +01004979 semsg(_(e_dictkey), fudi.fd_newkey);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004980 vim_free(fudi.fd_newkey);
4981 }
4982 if (tofree == NULL)
4983 return;
4984
Bram Moolenaare38eab22019-12-05 21:50:01 +01004985 // Increase refcount on dictionary, it could get deleted when evaluating
4986 // the arguments.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004987 if (fudi.fd_dict != NULL)
4988 ++fudi.fd_dict->dv_refcount;
4989
Bram Moolenaare38eab22019-12-05 21:50:01 +01004990 // If it is the name of a variable of type VAR_FUNC or VAR_PARTIAL use its
4991 // contents. For VAR_PARTIAL get its partial, unless we already have one
4992 // from trans_function_name().
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004993 len = (int)STRLEN(tofree);
Bram Moolenaar32b3f822021-01-06 21:59:39 +01004994 name = deref_func_name(tofree, &len, partial != NULL ? NULL : &partial,
4995 in_vim9script() && type == NULL ? &type : NULL, FALSE);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004996
Bram Moolenaare38eab22019-12-05 21:50:01 +01004997 // Skip white space to allow ":call func ()". Not good, but required for
4998 // backward compatibility.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02004999 startarg = skipwhite(arg);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005000 if (*startarg != '(')
5001 {
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01005002 semsg(_(e_missing_paren), eap->arg);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005003 goto end;
5004 }
Bram Moolenaar01dd6c32021-09-05 16:36:23 +02005005 if (in_vim9script() && startarg > arg)
5006 {
5007 semsg(_(e_no_white_space_allowed_before_str_str), "(", eap->arg);
5008 goto end;
5009 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005010
5011 /*
5012 * When skipping, evaluate the function once, to find the end of the
5013 * arguments.
5014 * When the function takes a range, this is discovered after the first
5015 * call, and the loop is broken.
5016 */
5017 if (eap->skip)
5018 {
5019 ++emsg_skip;
Bram Moolenaare38eab22019-12-05 21:50:01 +01005020 lnum = eap->line2; // do it once, also with an invalid range
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005021 }
5022 else
5023 lnum = eap->line1;
5024 for ( ; lnum <= eap->line2; ++lnum)
5025 {
Bram Moolenaarc6538bc2019-08-03 18:17:11 +02005026 funcexe_T funcexe;
5027
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005028 if (!eap->skip && eap->addr_count > 0)
5029 {
Bram Moolenaar9e353b52018-11-04 23:39:38 +01005030 if (lnum > curbuf->b_ml.ml_line_count)
5031 {
5032 // If the function deleted lines or switched to another buffer
5033 // the line number may become invalid.
Bram Moolenaar108010a2021-06-27 22:03:33 +02005034 emsg(_(e_invalid_range));
Bram Moolenaar9e353b52018-11-04 23:39:38 +01005035 break;
5036 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005037 curwin->w_cursor.lnum = lnum;
5038 curwin->w_cursor.col = 0;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005039 curwin->w_cursor.coladd = 0;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005040 }
5041 arg = startarg;
Bram Moolenaarc6538bc2019-08-03 18:17:11 +02005042
Bram Moolenaara80faa82020-04-12 19:37:17 +02005043 CLEAR_FIELD(funcexe);
Bram Moolenaarc6538bc2019-08-03 18:17:11 +02005044 funcexe.firstline = eap->line1;
5045 funcexe.lastline = eap->line2;
5046 funcexe.doesrange = &doesrange;
5047 funcexe.evaluate = !eap->skip;
5048 funcexe.partial = partial;
5049 funcexe.selfdict = fudi.fd_dict;
Bram Moolenaar32b3f822021-01-06 21:59:39 +01005050 funcexe.check_type = type;
Bram Moolenaar01dd6c32021-09-05 16:36:23 +02005051 rettv.v_type = VAR_UNKNOWN; // clear_tv() uses this
Bram Moolenaare6b53242020-07-01 17:28:33 +02005052 if (get_func_tv(name, -1, &rettv, &arg, &evalarg, &funcexe) == FAIL)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005053 {
5054 failed = TRUE;
5055 break;
5056 }
Bram Moolenaarc6f9f732018-02-11 19:06:26 +01005057 if (has_watchexpr())
5058 dbg_check_breakpoint(eap);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005059
Bram Moolenaar9cfe8f62019-08-17 21:04:16 +02005060 // Handle a function returning a Funcref, Dictionary or List.
Bram Moolenaare40fbc22020-06-27 18:06:45 +02005061 if (handle_subscript(&arg, &rettv,
5062 eap->skip ? NULL : &EVALARG_EVALUATE, TRUE) == FAIL)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005063 {
5064 failed = TRUE;
5065 break;
5066 }
5067
5068 clear_tv(&rettv);
5069 if (doesrange || eap->skip)
5070 break;
5071
Bram Moolenaare38eab22019-12-05 21:50:01 +01005072 // Stop when immediately aborting on error, or when an interrupt
5073 // occurred or an exception was thrown but not caught.
5074 // get_func_tv() returned OK, so that the check for trailing
5075 // characters below is executed.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005076 if (aborting())
5077 break;
5078 }
5079 if (eap->skip)
5080 --emsg_skip;
Bram Moolenaare6b53242020-07-01 17:28:33 +02005081 clear_evalarg(&evalarg, eap);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005082
Bram Moolenaar1d341892021-09-18 15:25:52 +02005083 // When inside :try we need to check for following "| catch" or "| endtry".
5084 // Not when there was an error, but do check if an exception was thrown.
5085 if ((!aborting() || did_throw)
5086 && (!failed || eap->cstack->cs_trylevel > 0))
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005087 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01005088 // Check for trailing illegal characters and a following command.
Bram Moolenaar8294d492020-08-10 22:40:56 +02005089 arg = skipwhite(arg);
Bram Moolenaara72cfb82020-04-23 17:07:30 +02005090 if (!ends_excmd2(eap->arg, arg))
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005091 {
Bram Moolenaar1d341892021-09-18 15:25:52 +02005092 if (!failed && !aborting())
Bram Moolenaar40d9da22020-02-17 10:01:24 +01005093 {
5094 emsg_severe = TRUE;
Bram Moolenaar2d06bfd2020-07-23 17:16:18 +02005095 semsg(_(e_trailing_arg), arg);
Bram Moolenaar40d9da22020-02-17 10:01:24 +01005096 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005097 }
5098 else
Bram Moolenaar63b91732021-08-05 20:40:03 +02005099 set_nextcmd(eap, arg);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005100 }
5101
5102end:
5103 dict_unref(fudi.fd_dict);
5104 vim_free(tofree);
5105}
5106
5107/*
5108 * Return from a function. Possibly makes the return pending. Also called
5109 * for a pending return at the ":endtry" or after returning from an extra
5110 * do_cmdline(). "reanimate" is used in the latter case. "is_cmd" is set
5111 * when called due to a ":return" command. "rettv" may point to a typval_T
5112 * with the return rettv. Returns TRUE when the return can be carried out,
5113 * FALSE when the return gets pending.
5114 */
5115 int
5116do_return(
5117 exarg_T *eap,
5118 int reanimate,
5119 int is_cmd,
5120 void *rettv)
5121{
5122 int idx;
Bram Moolenaarddef1292019-12-16 17:10:33 +01005123 cstack_T *cstack = eap->cstack;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005124
5125 if (reanimate)
Bram Moolenaare38eab22019-12-05 21:50:01 +01005126 // Undo the return.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005127 current_funccal->returned = FALSE;
5128
5129 /*
5130 * Cleanup (and inactivate) conditionals, but stop when a try conditional
5131 * not in its finally clause (which then is to be executed next) is found.
5132 * In this case, make the ":return" pending for execution at the ":endtry".
5133 * Otherwise, return normally.
5134 */
5135 idx = cleanup_conditionals(eap->cstack, 0, TRUE);
5136 if (idx >= 0)
5137 {
5138 cstack->cs_pending[idx] = CSTP_RETURN;
5139
5140 if (!is_cmd && !reanimate)
Bram Moolenaare38eab22019-12-05 21:50:01 +01005141 // A pending return again gets pending. "rettv" points to an
5142 // allocated variable with the rettv of the original ":return"'s
5143 // argument if present or is NULL else.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005144 cstack->cs_rettv[idx] = rettv;
5145 else
5146 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01005147 // When undoing a return in order to make it pending, get the stored
5148 // return rettv.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005149 if (reanimate)
5150 rettv = current_funccal->rettv;
5151
5152 if (rettv != NULL)
5153 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01005154 // Store the value of the pending return.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005155 if ((cstack->cs_rettv[idx] = alloc_tv()) != NULL)
5156 *(typval_T *)cstack->cs_rettv[idx] = *(typval_T *)rettv;
5157 else
Bram Moolenaare29a27f2021-07-20 21:07:36 +02005158 emsg(_(e_out_of_memory));
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005159 }
5160 else
5161 cstack->cs_rettv[idx] = NULL;
5162
5163 if (reanimate)
5164 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01005165 // The pending return value could be overwritten by a ":return"
5166 // without argument in a finally clause; reset the default
5167 // return value.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005168 current_funccal->rettv->v_type = VAR_NUMBER;
5169 current_funccal->rettv->vval.v_number = 0;
5170 }
5171 }
5172 report_make_pending(CSTP_RETURN, rettv);
5173 }
5174 else
5175 {
5176 current_funccal->returned = TRUE;
5177
Bram Moolenaare38eab22019-12-05 21:50:01 +01005178 // If the return is carried out now, store the return value. For
5179 // a return immediately after reanimation, the value is already
5180 // there.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005181 if (!reanimate && rettv != NULL)
5182 {
5183 clear_tv(current_funccal->rettv);
5184 *current_funccal->rettv = *(typval_T *)rettv;
5185 if (!is_cmd)
5186 vim_free(rettv);
5187 }
5188 }
5189
5190 return idx < 0;
5191}
5192
5193/*
5194 * Free the variable with a pending return value.
5195 */
5196 void
5197discard_pending_return(void *rettv)
5198{
5199 free_tv((typval_T *)rettv);
5200}
5201
5202/*
5203 * Generate a return command for producing the value of "rettv". The result
5204 * is an allocated string. Used by report_pending() for verbose messages.
5205 */
5206 char_u *
5207get_return_cmd(void *rettv)
5208{
5209 char_u *s = NULL;
5210 char_u *tofree = NULL;
5211 char_u numbuf[NUMBUFLEN];
5212
5213 if (rettv != NULL)
5214 s = echo_string((typval_T *)rettv, &tofree, numbuf, 0);
5215 if (s == NULL)
5216 s = (char_u *)"";
5217
5218 STRCPY(IObuff, ":return ");
5219 STRNCPY(IObuff + 8, s, IOSIZE - 8);
5220 if (STRLEN(s) + 8 >= IOSIZE)
5221 STRCPY(IObuff + IOSIZE - 4, "...");
5222 vim_free(tofree);
5223 return vim_strsave(IObuff);
5224}
5225
5226/*
5227 * Get next function line.
5228 * Called by do_cmdline() to get the next line.
5229 * Returns allocated string, or NULL for end of function.
5230 */
5231 char_u *
5232get_func_line(
5233 int c UNUSED,
5234 void *cookie,
Bram Moolenaare96a2492019-06-25 04:12:16 +02005235 int indent UNUSED,
Bram Moolenaar66250c92020-08-20 15:02:42 +02005236 getline_opt_T options UNUSED)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005237{
5238 funccall_T *fcp = (funccall_T *)cookie;
5239 ufunc_T *fp = fcp->func;
5240 char_u *retval;
Bram Moolenaare38eab22019-12-05 21:50:01 +01005241 garray_T *gap; // growarray with function lines
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005242
Bram Moolenaare38eab22019-12-05 21:50:01 +01005243 // If breakpoints have been added/deleted need to check for it.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005244 if (fcp->dbg_tick != debug_tick)
5245 {
5246 fcp->breakpoint = dbg_find_breakpoint(FALSE, fp->uf_name,
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01005247 SOURCING_LNUM);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005248 fcp->dbg_tick = debug_tick;
5249 }
5250#ifdef FEAT_PROFILE
5251 if (do_profiling == PROF_YES)
5252 func_line_end(cookie);
5253#endif
5254
5255 gap = &fp->uf_lines;
5256 if (((fp->uf_flags & FC_ABORT) && did_emsg && !aborted_in_try())
5257 || fcp->returned)
5258 retval = NULL;
5259 else
5260 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01005261 // Skip NULL lines (continuation lines).
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005262 while (fcp->linenr < gap->ga_len
5263 && ((char_u **)(gap->ga_data))[fcp->linenr] == NULL)
5264 ++fcp->linenr;
5265 if (fcp->linenr >= gap->ga_len)
5266 retval = NULL;
5267 else
5268 {
5269 retval = vim_strsave(((char_u **)(gap->ga_data))[fcp->linenr++]);
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01005270 SOURCING_LNUM = fcp->linenr;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005271#ifdef FEAT_PROFILE
5272 if (do_profiling == PROF_YES)
Bram Moolenaarb2049902021-01-24 12:53:53 +01005273 func_line_start(cookie, SOURCING_LNUM);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005274#endif
5275 }
5276 }
5277
Bram Moolenaare38eab22019-12-05 21:50:01 +01005278 // Did we encounter a breakpoint?
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01005279 if (fcp->breakpoint != 0 && fcp->breakpoint <= SOURCING_LNUM)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005280 {
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01005281 dbg_breakpoint(fp->uf_name, SOURCING_LNUM);
Bram Moolenaare38eab22019-12-05 21:50:01 +01005282 // Find next breakpoint.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005283 fcp->breakpoint = dbg_find_breakpoint(FALSE, fp->uf_name,
Bram Moolenaar1a47ae32019-12-29 23:04:25 +01005284 SOURCING_LNUM);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005285 fcp->dbg_tick = debug_tick;
5286 }
5287
5288 return retval;
5289}
5290
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005291/*
5292 * Return TRUE if the currently active function should be ended, because a
5293 * return was encountered or an error occurred. Used inside a ":while".
5294 */
5295 int
5296func_has_ended(void *cookie)
5297{
5298 funccall_T *fcp = (funccall_T *)cookie;
5299
Bram Moolenaare38eab22019-12-05 21:50:01 +01005300 // Ignore the "abort" flag if the abortion behavior has been changed due to
5301 // an error inside a try conditional.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005302 return (((fcp->func->uf_flags & FC_ABORT) && did_emsg && !aborted_in_try())
5303 || fcp->returned);
5304}
5305
5306/*
5307 * return TRUE if cookie indicates a function which "abort"s on errors.
5308 */
5309 int
5310func_has_abort(
5311 void *cookie)
5312{
5313 return ((funccall_T *)cookie)->func->uf_flags & FC_ABORT;
5314}
5315
5316
5317/*
5318 * Turn "dict.Func" into a partial for "Func" bound to "dict".
5319 * Don't do this when "Func" is already a partial that was bound
5320 * explicitly (pt_auto is FALSE).
5321 * Changes "rettv" in-place.
5322 * Returns the updated "selfdict_in".
5323 */
5324 dict_T *
5325make_partial(dict_T *selfdict_in, typval_T *rettv)
5326{
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005327 char_u *fname;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005328 char_u *tofree = NULL;
5329 ufunc_T *fp;
5330 char_u fname_buf[FLEN_FIXED + 1];
5331 int error;
5332 dict_T *selfdict = selfdict_in;
5333
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005334 if (rettv->v_type == VAR_PARTIAL && rettv->vval.v_partial->pt_func != NULL)
5335 fp = rettv->vval.v_partial->pt_func;
5336 else
5337 {
5338 fname = rettv->v_type == VAR_FUNC ? rettv->vval.v_string
5339 : rettv->vval.v_partial->pt_name;
Bram Moolenaare38eab22019-12-05 21:50:01 +01005340 // Translate "s:func" to the stored function name.
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005341 fname = fname_trans_sid(fname, fname_buf, &tofree, &error);
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02005342 fp = find_func(fname, FALSE, NULL);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005343 vim_free(tofree);
5344 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005345
5346 if (fp != NULL && (fp->uf_flags & FC_DICT))
5347 {
Bram Moolenaarc799fe22019-05-28 23:08:19 +02005348 partial_T *pt = ALLOC_CLEAR_ONE(partial_T);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005349
5350 if (pt != NULL)
5351 {
5352 pt->pt_refcount = 1;
5353 pt->pt_dict = selfdict;
5354 pt->pt_auto = TRUE;
5355 selfdict = NULL;
5356 if (rettv->v_type == VAR_FUNC)
5357 {
Bram Moolenaare38eab22019-12-05 21:50:01 +01005358 // Just a function: Take over the function name and use
5359 // selfdict.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005360 pt->pt_name = rettv->vval.v_string;
5361 }
5362 else
5363 {
5364 partial_T *ret_pt = rettv->vval.v_partial;
5365 int i;
5366
Bram Moolenaare38eab22019-12-05 21:50:01 +01005367 // Partial: copy the function name, use selfdict and copy
5368 // args. Can't take over name or args, the partial might
5369 // be referenced elsewhere.
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005370 if (ret_pt->pt_name != NULL)
5371 {
5372 pt->pt_name = vim_strsave(ret_pt->pt_name);
5373 func_ref(pt->pt_name);
5374 }
5375 else
5376 {
5377 pt->pt_func = ret_pt->pt_func;
5378 func_ptr_ref(pt->pt_func);
5379 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005380 if (ret_pt->pt_argc > 0)
5381 {
Bram Moolenaarc799fe22019-05-28 23:08:19 +02005382 pt->pt_argv = ALLOC_MULT(typval_T, ret_pt->pt_argc);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005383 if (pt->pt_argv == NULL)
Bram Moolenaare38eab22019-12-05 21:50:01 +01005384 // out of memory: drop the arguments
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005385 pt->pt_argc = 0;
5386 else
5387 {
5388 pt->pt_argc = ret_pt->pt_argc;
5389 for (i = 0; i < pt->pt_argc; i++)
5390 copy_tv(&ret_pt->pt_argv[i], &pt->pt_argv[i]);
5391 }
5392 }
5393 partial_unref(ret_pt);
5394 }
5395 rettv->v_type = VAR_PARTIAL;
5396 rettv->vval.v_partial = pt;
5397 }
5398 }
5399 return selfdict;
5400}
5401
5402/*
5403 * Return the name of the executed function.
5404 */
5405 char_u *
5406func_name(void *cookie)
5407{
5408 return ((funccall_T *)cookie)->func->uf_name;
5409}
5410
5411/*
5412 * Return the address holding the next breakpoint line for a funccall cookie.
5413 */
5414 linenr_T *
5415func_breakpoint(void *cookie)
5416{
5417 return &((funccall_T *)cookie)->breakpoint;
5418}
5419
5420/*
5421 * Return the address holding the debug tick for a funccall cookie.
5422 */
5423 int *
5424func_dbg_tick(void *cookie)
5425{
5426 return &((funccall_T *)cookie)->dbg_tick;
5427}
5428
5429/*
5430 * Return the nesting level for a funccall cookie.
5431 */
5432 int
5433func_level(void *cookie)
5434{
5435 return ((funccall_T *)cookie)->level;
5436}
5437
5438/*
5439 * Return TRUE when a function was ended by a ":return" command.
5440 */
5441 int
5442current_func_returned(void)
5443{
5444 return current_funccal->returned;
5445}
5446
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005447 int
5448free_unref_funccal(int copyID, int testing)
5449{
5450 int did_free = FALSE;
5451 int did_free_funccal = FALSE;
5452 funccall_T *fc, **pfc;
5453
5454 for (pfc = &previous_funccal; *pfc != NULL; )
5455 {
5456 if (can_free_funccal(*pfc, copyID))
5457 {
5458 fc = *pfc;
5459 *pfc = fc->caller;
Bram Moolenaar209b8e32019-03-14 13:43:24 +01005460 free_funccal_contents(fc);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005461 did_free = TRUE;
5462 did_free_funccal = TRUE;
5463 }
5464 else
5465 pfc = &(*pfc)->caller;
5466 }
5467 if (did_free_funccal)
Bram Moolenaare38eab22019-12-05 21:50:01 +01005468 // When a funccal was freed some more items might be garbage
5469 // collected, so run again.
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005470 (void)garbage_collect(testing);
5471
5472 return did_free;
5473}
5474
5475/*
Bram Moolenaarba209902016-08-24 22:06:38 +02005476 * Get function call environment based on backtrace debug level
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005477 */
5478 static funccall_T *
5479get_funccal(void)
5480{
5481 int i;
5482 funccall_T *funccal;
5483 funccall_T *temp_funccal;
5484
5485 funccal = current_funccal;
5486 if (debug_backtrace_level > 0)
5487 {
5488 for (i = 0; i < debug_backtrace_level; i++)
5489 {
5490 temp_funccal = funccal->caller;
5491 if (temp_funccal)
5492 funccal = temp_funccal;
5493 else
Bram Moolenaare38eab22019-12-05 21:50:01 +01005494 // backtrace level overflow. reset to max
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005495 debug_backtrace_level = i;
5496 }
5497 }
5498 return funccal;
5499}
5500
5501/*
5502 * Return the hashtable used for local variables in the current funccal.
5503 * Return NULL if there is no current funccal.
5504 */
5505 hashtab_T *
5506get_funccal_local_ht()
5507{
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01005508 if (current_funccal == NULL || current_funccal->l_vars.dv_refcount == 0)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005509 return NULL;
5510 return &get_funccal()->l_vars.dv_hashtab;
5511}
5512
5513/*
5514 * Return the l: scope variable.
5515 * Return NULL if there is no current funccal.
5516 */
5517 dictitem_T *
5518get_funccal_local_var()
5519{
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01005520 if (current_funccal == NULL || current_funccal->l_vars.dv_refcount == 0)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005521 return NULL;
5522 return &get_funccal()->l_vars_var;
5523}
5524
5525/*
5526 * Return the hashtable used for argument in the current funccal.
5527 * Return NULL if there is no current funccal.
5528 */
5529 hashtab_T *
5530get_funccal_args_ht()
5531{
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01005532 if (current_funccal == NULL || current_funccal->l_vars.dv_refcount == 0)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005533 return NULL;
5534 return &get_funccal()->l_avars.dv_hashtab;
5535}
5536
5537/*
5538 * Return the a: scope variable.
5539 * Return NULL if there is no current funccal.
5540 */
5541 dictitem_T *
5542get_funccal_args_var()
5543{
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01005544 if (current_funccal == NULL || current_funccal->l_vars.dv_refcount == 0)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005545 return NULL;
Bram Moolenaarc7d9eac2017-02-01 20:26:51 +01005546 return &get_funccal()->l_avars_var;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005547}
5548
5549/*
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005550 * List function variables, if there is a function.
5551 */
5552 void
5553list_func_vars(int *first)
5554{
Bram Moolenaar8a7d6542020-01-26 15:56:19 +01005555 if (current_funccal != NULL && current_funccal->l_vars.dv_refcount > 0)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005556 list_hashtable_vars(&current_funccal->l_vars.dv_hashtab,
Bram Moolenaar32526b32019-01-19 17:43:09 +01005557 "l:", FALSE, first);
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005558}
5559
5560/*
5561 * If "ht" is the hashtable for local variables in the current funccal, return
5562 * the dict that contains it.
5563 * Otherwise return NULL.
5564 */
5565 dict_T *
5566get_current_funccal_dict(hashtab_T *ht)
5567{
5568 if (current_funccal != NULL
5569 && ht == &current_funccal->l_vars.dv_hashtab)
5570 return &current_funccal->l_vars;
5571 return NULL;
5572}
5573
5574/*
Bram Moolenaar10ce39a2016-07-29 22:37:06 +02005575 * Search hashitem in parent scope.
5576 */
5577 hashitem_T *
Bram Moolenaarba96e9a2016-08-01 17:10:20 +02005578find_hi_in_scoped_ht(char_u *name, hashtab_T **pht)
Bram Moolenaar10ce39a2016-07-29 22:37:06 +02005579{
5580 funccall_T *old_current_funccal = current_funccal;
5581 hashtab_T *ht;
5582 hashitem_T *hi = NULL;
Bram Moolenaarba96e9a2016-08-01 17:10:20 +02005583 char_u *varname;
Bram Moolenaar10ce39a2016-07-29 22:37:06 +02005584
5585 if (current_funccal == NULL || current_funccal->func->uf_scoped == NULL)
5586 return NULL;
5587
Bram Moolenaar6f5b6df2020-05-16 21:20:12 +02005588 // Search in parent scope, which can be referenced from a lambda.
Bram Moolenaar10ce39a2016-07-29 22:37:06 +02005589 current_funccal = current_funccal->func->uf_scoped;
Bram Moolenaar58016442016-07-31 18:30:22 +02005590 while (current_funccal != NULL)
Bram Moolenaar10ce39a2016-07-29 22:37:06 +02005591 {
Bram Moolenaarba96e9a2016-08-01 17:10:20 +02005592 ht = find_var_ht(name, &varname);
5593 if (ht != NULL && *varname != NUL)
Bram Moolenaar58016442016-07-31 18:30:22 +02005594 {
Bram Moolenaarba96e9a2016-08-01 17:10:20 +02005595 hi = hash_find(ht, varname);
Bram Moolenaar58016442016-07-31 18:30:22 +02005596 if (!HASHITEM_EMPTY(hi))
5597 {
5598 *pht = ht;
5599 break;
5600 }
5601 }
5602 if (current_funccal == current_funccal->func->uf_scoped)
5603 break;
5604 current_funccal = current_funccal->func->uf_scoped;
Bram Moolenaar10ce39a2016-07-29 22:37:06 +02005605 }
5606 current_funccal = old_current_funccal;
5607
5608 return hi;
5609}
5610
5611/*
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02005612 * Search variable in parent scope.
5613 */
5614 dictitem_T *
Bram Moolenaarba96e9a2016-08-01 17:10:20 +02005615find_var_in_scoped_ht(char_u *name, int no_autoload)
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02005616{
5617 dictitem_T *v = NULL;
5618 funccall_T *old_current_funccal = current_funccal;
5619 hashtab_T *ht;
Bram Moolenaarba96e9a2016-08-01 17:10:20 +02005620 char_u *varname;
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02005621
5622 if (current_funccal == NULL || current_funccal->func->uf_scoped == NULL)
5623 return NULL;
5624
Bram Moolenaare38eab22019-12-05 21:50:01 +01005625 // Search in parent scope which is possible to reference from lambda
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02005626 current_funccal = current_funccal->func->uf_scoped;
5627 while (current_funccal)
5628 {
Bram Moolenaarba96e9a2016-08-01 17:10:20 +02005629 ht = find_var_ht(name, &varname);
5630 if (ht != NULL && *varname != NUL)
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02005631 {
Bram Moolenaarba96e9a2016-08-01 17:10:20 +02005632 v = find_var_in_ht(ht, *name, varname, no_autoload);
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02005633 if (v != NULL)
5634 break;
5635 }
5636 if (current_funccal == current_funccal->func->uf_scoped)
5637 break;
5638 current_funccal = current_funccal->func->uf_scoped;
5639 }
5640 current_funccal = old_current_funccal;
5641
5642 return v;
5643}
5644
5645/*
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005646 * Set "copyID + 1" in previous_funccal and callers.
5647 */
5648 int
5649set_ref_in_previous_funccal(int copyID)
5650{
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005651 funccall_T *fc;
5652
Bram Moolenaar20cc5282021-07-03 16:33:16 +02005653 for (fc = previous_funccal; fc != NULL; fc = fc->caller)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005654 {
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02005655 fc->fc_copyID = copyID + 1;
Bram Moolenaar20cc5282021-07-03 16:33:16 +02005656 if (set_ref_in_ht(&fc->l_vars.dv_hashtab, copyID + 1, NULL)
5657 || set_ref_in_ht(&fc->l_avars.dv_hashtab, copyID + 1, NULL)
5658 || set_ref_in_list_items(&fc->l_varlist, copyID + 1, NULL))
5659 return TRUE;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005660 }
Bram Moolenaar20cc5282021-07-03 16:33:16 +02005661 return FALSE;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005662}
5663
Bram Moolenaarbc7ce672016-08-01 22:49:22 +02005664 static int
5665set_ref_in_funccal(funccall_T *fc, int copyID)
5666{
Bram Moolenaarbc7ce672016-08-01 22:49:22 +02005667 if (fc->fc_copyID != copyID)
5668 {
5669 fc->fc_copyID = copyID;
Bram Moolenaar20cc5282021-07-03 16:33:16 +02005670 if (set_ref_in_ht(&fc->l_vars.dv_hashtab, copyID, NULL)
5671 || set_ref_in_ht(&fc->l_avars.dv_hashtab, copyID, NULL)
5672 || set_ref_in_list_items(&fc->l_varlist, copyID, NULL)
5673 || set_ref_in_func(NULL, fc->func, copyID))
5674 return TRUE;
Bram Moolenaarbc7ce672016-08-01 22:49:22 +02005675 }
Bram Moolenaar20cc5282021-07-03 16:33:16 +02005676 return FALSE;
Bram Moolenaarbc7ce672016-08-01 22:49:22 +02005677}
5678
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005679/*
5680 * Set "copyID" in all local vars and arguments in the call stack.
5681 */
5682 int
5683set_ref_in_call_stack(int copyID)
5684{
Bram Moolenaarc07f67a2019-06-06 19:03:17 +02005685 funccall_T *fc;
5686 funccal_entry_T *entry;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005687
Bram Moolenaar20cc5282021-07-03 16:33:16 +02005688 for (fc = current_funccal; fc != NULL; fc = fc->caller)
5689 if (set_ref_in_funccal(fc, copyID))
5690 return TRUE;
Bram Moolenaarc07f67a2019-06-06 19:03:17 +02005691
5692 // Also go through the funccal_stack.
Bram Moolenaar20cc5282021-07-03 16:33:16 +02005693 for (entry = funccal_stack; entry != NULL; entry = entry->next)
5694 for (fc = entry->top_funccal; fc != NULL; fc = fc->caller)
5695 if (set_ref_in_funccal(fc, copyID))
5696 return TRUE;
5697 return FALSE;
Bram Moolenaarbc7ce672016-08-01 22:49:22 +02005698}
5699
5700/*
5701 * Set "copyID" in all functions available by name.
5702 */
5703 int
5704set_ref_in_functions(int copyID)
5705{
5706 int todo;
5707 hashitem_T *hi = NULL;
Bram Moolenaarbc7ce672016-08-01 22:49:22 +02005708 ufunc_T *fp;
5709
5710 todo = (int)func_hashtab.ht_used;
5711 for (hi = func_hashtab.ht_array; todo > 0 && !got_int; ++hi)
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005712 {
Bram Moolenaarbc7ce672016-08-01 22:49:22 +02005713 if (!HASHITEM_EMPTY(hi))
5714 {
5715 --todo;
5716 fp = HI2UF(hi);
Bram Moolenaar20cc5282021-07-03 16:33:16 +02005717 if (!func_name_refcount(fp->uf_name)
5718 && set_ref_in_func(NULL, fp, copyID))
5719 return TRUE;
Bram Moolenaarbc7ce672016-08-01 22:49:22 +02005720 }
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005721 }
Bram Moolenaar20cc5282021-07-03 16:33:16 +02005722 return FALSE;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005723}
5724
5725/*
5726 * Set "copyID" in all function arguments.
5727 */
5728 int
5729set_ref_in_func_args(int copyID)
5730{
5731 int i;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005732
5733 for (i = 0; i < funcargs.ga_len; ++i)
Bram Moolenaar20cc5282021-07-03 16:33:16 +02005734 if (set_ref_in_item(((typval_T **)funcargs.ga_data)[i],
5735 copyID, NULL, NULL))
5736 return TRUE;
5737 return FALSE;
Bram Moolenaara9b579f2016-07-17 18:29:19 +02005738}
5739
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02005740/*
5741 * Mark all lists and dicts referenced through function "name" with "copyID".
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02005742 * Returns TRUE if setting references failed somehow.
5743 */
5744 int
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005745set_ref_in_func(char_u *name, ufunc_T *fp_in, int copyID)
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02005746{
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005747 ufunc_T *fp = fp_in;
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02005748 funccall_T *fc;
Bram Moolenaaref140542019-12-31 21:27:13 +01005749 int error = FCERR_NONE;
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02005750 char_u fname_buf[FLEN_FIXED + 1];
5751 char_u *tofree = NULL;
5752 char_u *fname;
Bram Moolenaarbc7ce672016-08-01 22:49:22 +02005753 int abort = FALSE;
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02005754
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005755 if (name == NULL && fp_in == NULL)
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02005756 return FALSE;
5757
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005758 if (fp_in == NULL)
5759 {
5760 fname = fname_trans_sid(name, fname_buf, &tofree, &error);
Bram Moolenaar4c17ad92020-04-27 22:47:51 +02005761 fp = find_func(fname, FALSE, NULL);
Bram Moolenaar437bafe2016-08-01 15:40:54 +02005762 }
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02005763 if (fp != NULL)
5764 {
5765 for (fc = fp->uf_scoped; fc != NULL; fc = fc->func->uf_scoped)
Bram Moolenaarbc7ce672016-08-01 22:49:22 +02005766 abort = abort || set_ref_in_funccal(fc, copyID);
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02005767 }
Bram Moolenaar5adc55c2020-05-02 23:12:58 +02005768
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02005769 vim_free(tofree);
Bram Moolenaarbc7ce672016-08-01 22:49:22 +02005770 return abort;
Bram Moolenaar1e96d9b2016-07-29 22:15:09 +02005771}
5772
Bram Moolenaare38eab22019-12-05 21:50:01 +01005773#endif // FEAT_EVAL