1 /* vi:set ts=8 sts=4 sw=4 noet: 2 * 3 * VIM - Vi IMproved by Bram Moolenaar 4 * 5 * Do ":help uganda" in Vim to read copying and usage conditions. 6 * Do ":help credits" in Vim to see a list of people who contributed. 7 * See README.txt for an overview of the Vim source code. 8 */ 9 10 /* 11 * eval.c: User defined function support 12 */ 13 14 #include "vim.h" 15 16 #if defined(FEAT_EVAL) || defined(PROTO) 17 // flags used in uf_flags 18 #define FC_ABORT 0x01 // abort function on error 19 #define FC_RANGE 0x02 // function accepts range 20 #define FC_DICT 0x04 // Dict function, uses "self" 21 #define FC_CLOSURE 0x08 // closure, uses outer scope variables 22 #define FC_DELETED 0x10 // :delfunction used while uf_refcount > 0 23 #define FC_REMOVED 0x20 // function redefined while uf_refcount > 0 24 #define FC_SANDBOX 0x40 // function defined in the sandbox 25 26 /* From user function to hashitem and back. */ 27 #define UF2HIKEY(fp) ((fp)->uf_name) 28 #define HIKEY2UF(p) ((ufunc_T *)((p) - offsetof(ufunc_T, uf_name))) 29 #define HI2UF(hi) HIKEY2UF((hi)->hi_key) 30 31 #define FUNCARG(fp, j) ((char_u **)(fp->uf_args.ga_data))[j] 32 #define FUNCLINE(fp, j) ((char_u **)(fp->uf_lines.ga_data))[j] 33 34 /* 35 * All user-defined functions are found in this hashtable. 36 */ 37 static hashtab_T func_hashtab; 38 39 /* Used by get_func_tv() */ 40 static garray_T funcargs = GA_EMPTY; 41 42 /* pointer to funccal for currently active function */ 43 funccall_T *current_funccal = NULL; 44 45 /* Pointer to list of previously used funccal, still around because some 46 * item in it is still being used. */ 47 funccall_T *previous_funccal = NULL; 48 49 static char *e_funcexts = N_("E122: Function %s already exists, add ! to replace it"); 50 static char *e_funcdict = N_("E717: Dictionary entry already exists"); 51 static char *e_funcref = N_("E718: Funcref required"); 52 static char *e_nofunc = N_("E130: Unknown function: %s"); 53 54 #ifdef FEAT_PROFILE 55 static void func_do_profile(ufunc_T *fp); 56 static void prof_sort_list(FILE *fd, ufunc_T **sorttab, int st_len, char *title, int prefer_self); 57 static void prof_func_line(FILE *fd, int count, proftime_T *total, proftime_T *self, int prefer_self); 58 static int 59 # ifdef __BORLANDC__ 60 _RTLENTRYF 61 # endif 62 prof_total_cmp(const void *s1, const void *s2); 63 static int 64 # ifdef __BORLANDC__ 65 _RTLENTRYF 66 # endif 67 prof_self_cmp(const void *s1, const void *s2); 68 #endif 69 static void funccal_unref(funccall_T *fc, ufunc_T *fp, int force); 70 71 void 72 func_init() 73 { 74 hash_init(&func_hashtab); 75 } 76 77 /* 78 * Get function arguments. 79 */ 80 static int 81 get_function_args( 82 char_u **argp, 83 char_u endchar, 84 garray_T *newargs, 85 int *varargs, 86 int skip) 87 { 88 int mustend = FALSE; 89 char_u *arg = *argp; 90 char_u *p = arg; 91 int c; 92 int i; 93 94 if (newargs != NULL) 95 ga_init2(newargs, (int)sizeof(char_u *), 3); 96 97 if (varargs != NULL) 98 *varargs = FALSE; 99 100 /* 101 * Isolate the arguments: "arg1, arg2, ...)" 102 */ 103 while (*p != endchar) 104 { 105 if (p[0] == '.' && p[1] == '.' && p[2] == '.') 106 { 107 if (varargs != NULL) 108 *varargs = TRUE; 109 p += 3; 110 mustend = TRUE; 111 } 112 else 113 { 114 arg = p; 115 while (ASCII_ISALNUM(*p) || *p == '_') 116 ++p; 117 if (arg == p || isdigit(*arg) 118 || (p - arg == 9 && STRNCMP(arg, "firstline", 9) == 0) 119 || (p - arg == 8 && STRNCMP(arg, "lastline", 8) == 0)) 120 { 121 if (!skip) 122 EMSG2(_("E125: Illegal argument: %s"), arg); 123 break; 124 } 125 if (newargs != NULL && ga_grow(newargs, 1) == FAIL) 126 goto err_ret; 127 if (newargs != NULL) 128 { 129 c = *p; 130 *p = NUL; 131 arg = vim_strsave(arg); 132 if (arg == NULL) 133 { 134 *p = c; 135 goto err_ret; 136 } 137 138 /* Check for duplicate argument name. */ 139 for (i = 0; i < newargs->ga_len; ++i) 140 if (STRCMP(((char_u **)(newargs->ga_data))[i], arg) == 0) 141 { 142 EMSG2(_("E853: Duplicate argument name: %s"), arg); 143 vim_free(arg); 144 goto err_ret; 145 } 146 ((char_u **)(newargs->ga_data))[newargs->ga_len] = arg; 147 newargs->ga_len++; 148 149 *p = c; 150 } 151 if (*p == ',') 152 ++p; 153 else 154 mustend = TRUE; 155 } 156 p = skipwhite(p); 157 if (mustend && *p != endchar) 158 { 159 if (!skip) 160 EMSG2(_(e_invarg2), *argp); 161 break; 162 } 163 } 164 if (*p != endchar) 165 goto err_ret; 166 ++p; /* skip "endchar" */ 167 168 *argp = p; 169 return OK; 170 171 err_ret: 172 if (newargs != NULL) 173 ga_clear_strings(newargs); 174 return FAIL; 175 } 176 177 /* 178 * Register function "fp" as using "current_funccal" as its scope. 179 */ 180 static int 181 register_closure(ufunc_T *fp) 182 { 183 if (fp->uf_scoped == current_funccal) 184 /* no change */ 185 return OK; 186 funccal_unref(fp->uf_scoped, fp, FALSE); 187 fp->uf_scoped = current_funccal; 188 current_funccal->fc_refcount++; 189 190 if (ga_grow(¤t_funccal->fc_funcs, 1) == FAIL) 191 return FAIL; 192 ((ufunc_T **)current_funccal->fc_funcs.ga_data) 193 [current_funccal->fc_funcs.ga_len++] = fp; 194 return OK; 195 } 196 197 /* 198 * Parse a lambda expression and get a Funcref from "*arg". 199 * Return OK or FAIL. Returns NOTDONE for dict or {expr}. 200 */ 201 int 202 get_lambda_tv(char_u **arg, typval_T *rettv, int evaluate) 203 { 204 garray_T newargs; 205 garray_T newlines; 206 garray_T *pnewargs; 207 ufunc_T *fp = NULL; 208 int varargs; 209 int ret; 210 char_u *start = skipwhite(*arg + 1); 211 char_u *s, *e; 212 static int lambda_no = 0; 213 int *old_eval_lavars = eval_lavars_used; 214 int eval_lavars = FALSE; 215 216 ga_init(&newargs); 217 ga_init(&newlines); 218 219 /* First, check if this is a lambda expression. "->" must exist. */ 220 ret = get_function_args(&start, '-', NULL, NULL, TRUE); 221 if (ret == FAIL || *start != '>') 222 return NOTDONE; 223 224 /* Parse the arguments again. */ 225 if (evaluate) 226 pnewargs = &newargs; 227 else 228 pnewargs = NULL; 229 *arg = skipwhite(*arg + 1); 230 ret = get_function_args(arg, '-', pnewargs, &varargs, FALSE); 231 if (ret == FAIL || **arg != '>') 232 goto errret; 233 234 /* Set up a flag for checking local variables and arguments. */ 235 if (evaluate) 236 eval_lavars_used = &eval_lavars; 237 238 /* Get the start and the end of the expression. */ 239 *arg = skipwhite(*arg + 1); 240 s = *arg; 241 ret = skip_expr(arg); 242 if (ret == FAIL) 243 goto errret; 244 e = *arg; 245 *arg = skipwhite(*arg); 246 if (**arg != '}') 247 goto errret; 248 ++*arg; 249 250 if (evaluate) 251 { 252 int len, flags = 0; 253 char_u *p; 254 char_u name[20]; 255 partial_T *pt; 256 257 sprintf((char*)name, "<lambda>%d", ++lambda_no); 258 259 fp = (ufunc_T *)alloc_clear((unsigned)(sizeof(ufunc_T) + STRLEN(name))); 260 if (fp == NULL) 261 goto errret; 262 pt = (partial_T *)alloc_clear((unsigned)sizeof(partial_T)); 263 if (pt == NULL) 264 { 265 vim_free(fp); 266 goto errret; 267 } 268 269 ga_init2(&newlines, (int)sizeof(char_u *), 1); 270 if (ga_grow(&newlines, 1) == FAIL) 271 goto errret; 272 273 /* Add "return " before the expression. */ 274 len = 7 + e - s + 1; 275 p = (char_u *)alloc(len); 276 if (p == NULL) 277 goto errret; 278 ((char_u **)(newlines.ga_data))[newlines.ga_len++] = p; 279 STRCPY(p, "return "); 280 vim_strncpy(p + 7, s, e - s); 281 282 fp->uf_refcount = 1; 283 STRCPY(fp->uf_name, name); 284 hash_add(&func_hashtab, UF2HIKEY(fp)); 285 fp->uf_args = newargs; 286 fp->uf_lines = newlines; 287 if (current_funccal != NULL && eval_lavars) 288 { 289 flags |= FC_CLOSURE; 290 if (register_closure(fp) == FAIL) 291 goto errret; 292 } 293 else 294 fp->uf_scoped = NULL; 295 296 #ifdef FEAT_PROFILE 297 if (prof_def_func()) 298 func_do_profile(fp); 299 #endif 300 if (sandbox) 301 flags |= FC_SANDBOX; 302 fp->uf_varargs = TRUE; 303 fp->uf_flags = flags; 304 fp->uf_calls = 0; 305 fp->uf_script_ctx = current_sctx; 306 fp->uf_script_ctx.sc_lnum += sourcing_lnum - newlines.ga_len; 307 308 pt->pt_func = fp; 309 pt->pt_refcount = 1; 310 rettv->vval.v_partial = pt; 311 rettv->v_type = VAR_PARTIAL; 312 } 313 314 eval_lavars_used = old_eval_lavars; 315 return OK; 316 317 errret: 318 ga_clear_strings(&newargs); 319 ga_clear_strings(&newlines); 320 vim_free(fp); 321 eval_lavars_used = old_eval_lavars; 322 return FAIL; 323 } 324 325 /* 326 * Check if "name" is a variable of type VAR_FUNC. If so, return the function 327 * name it contains, otherwise return "name". 328 * If "partialp" is not NULL, and "name" is of type VAR_PARTIAL also set 329 * "partialp". 330 */ 331 char_u * 332 deref_func_name(char_u *name, int *lenp, partial_T **partialp, int no_autoload) 333 { 334 dictitem_T *v; 335 int cc; 336 char_u *s; 337 338 if (partialp != NULL) 339 *partialp = NULL; 340 341 cc = name[*lenp]; 342 name[*lenp] = NUL; 343 v = find_var(name, NULL, no_autoload); 344 name[*lenp] = cc; 345 if (v != NULL && v->di_tv.v_type == VAR_FUNC) 346 { 347 if (v->di_tv.vval.v_string == NULL) 348 { 349 *lenp = 0; 350 return (char_u *)""; /* just in case */ 351 } 352 s = v->di_tv.vval.v_string; 353 *lenp = (int)STRLEN(s); 354 return s; 355 } 356 357 if (v != NULL && v->di_tv.v_type == VAR_PARTIAL) 358 { 359 partial_T *pt = v->di_tv.vval.v_partial; 360 361 if (pt == NULL) 362 { 363 *lenp = 0; 364 return (char_u *)""; /* just in case */ 365 } 366 if (partialp != NULL) 367 *partialp = pt; 368 s = partial_name(pt); 369 *lenp = (int)STRLEN(s); 370 return s; 371 } 372 373 return name; 374 } 375 376 /* 377 * Give an error message with a function name. Handle <SNR> things. 378 * "ermsg" is to be passed without translation, use N_() instead of _(). 379 */ 380 static void 381 emsg_funcname(char *ermsg, char_u *name) 382 { 383 char_u *p; 384 385 if (*name == K_SPECIAL) 386 p = concat_str((char_u *)"<SNR>", name + 3); 387 else 388 p = name; 389 EMSG2(_(ermsg), p); 390 if (p != name) 391 vim_free(p); 392 } 393 394 /* 395 * Allocate a variable for the result of a function. 396 * Return OK or FAIL. 397 */ 398 int 399 get_func_tv( 400 char_u *name, /* name of the function */ 401 int len, /* length of "name" */ 402 typval_T *rettv, 403 char_u **arg, /* argument, pointing to the '(' */ 404 linenr_T firstline, /* first line of range */ 405 linenr_T lastline, /* last line of range */ 406 int *doesrange, /* return: function handled range */ 407 int evaluate, 408 partial_T *partial, /* for extra arguments */ 409 dict_T *selfdict) /* Dictionary for "self" */ 410 { 411 char_u *argp; 412 int ret = OK; 413 typval_T argvars[MAX_FUNC_ARGS + 1]; /* vars for arguments */ 414 int argcount = 0; /* number of arguments found */ 415 416 /* 417 * Get the arguments. 418 */ 419 argp = *arg; 420 while (argcount < MAX_FUNC_ARGS - (partial == NULL ? 0 : partial->pt_argc)) 421 { 422 argp = skipwhite(argp + 1); /* skip the '(' or ',' */ 423 if (*argp == ')' || *argp == ',' || *argp == NUL) 424 break; 425 if (eval1(&argp, &argvars[argcount], evaluate) == FAIL) 426 { 427 ret = FAIL; 428 break; 429 } 430 ++argcount; 431 if (*argp != ',') 432 break; 433 } 434 if (*argp == ')') 435 ++argp; 436 else 437 ret = FAIL; 438 439 if (ret == OK) 440 { 441 int i = 0; 442 443 if (get_vim_var_nr(VV_TESTING)) 444 { 445 /* Prepare for calling test_garbagecollect_now(), need to know 446 * what variables are used on the call stack. */ 447 if (funcargs.ga_itemsize == 0) 448 ga_init2(&funcargs, (int)sizeof(typval_T *), 50); 449 for (i = 0; i < argcount; ++i) 450 if (ga_grow(&funcargs, 1) == OK) 451 ((typval_T **)funcargs.ga_data)[funcargs.ga_len++] = 452 &argvars[i]; 453 } 454 455 ret = call_func(name, len, rettv, argcount, argvars, NULL, 456 firstline, lastline, doesrange, evaluate, partial, selfdict); 457 458 funcargs.ga_len -= i; 459 } 460 else if (!aborting()) 461 { 462 if (argcount == MAX_FUNC_ARGS) 463 emsg_funcname(N_("E740: Too many arguments for function %s"), name); 464 else 465 emsg_funcname(N_("E116: Invalid arguments for function %s"), name); 466 } 467 468 while (--argcount >= 0) 469 clear_tv(&argvars[argcount]); 470 471 *arg = skipwhite(argp); 472 return ret; 473 } 474 475 #define FLEN_FIXED 40 476 477 /* 478 * Return TRUE if "p" starts with "<SID>" or "s:". 479 * Only works if eval_fname_script() returned non-zero for "p"! 480 */ 481 static int 482 eval_fname_sid(char_u *p) 483 { 484 return (*p == 's' || TOUPPER_ASC(p[2]) == 'I'); 485 } 486 487 /* 488 * In a script change <SID>name() and s:name() to K_SNR 123_name(). 489 * Change <SNR>123_name() to K_SNR 123_name(). 490 * Use "fname_buf[FLEN_FIXED + 1]" when it fits, otherwise allocate memory 491 * (slow). 492 */ 493 static char_u * 494 fname_trans_sid(char_u *name, char_u *fname_buf, char_u **tofree, int *error) 495 { 496 int llen; 497 char_u *fname; 498 int i; 499 500 llen = eval_fname_script(name); 501 if (llen > 0) 502 { 503 fname_buf[0] = K_SPECIAL; 504 fname_buf[1] = KS_EXTRA; 505 fname_buf[2] = (int)KE_SNR; 506 i = 3; 507 if (eval_fname_sid(name)) /* "<SID>" or "s:" */ 508 { 509 if (current_sctx.sc_sid <= 0) 510 *error = ERROR_SCRIPT; 511 else 512 { 513 sprintf((char *)fname_buf + 3, "%ld_", (long)current_sctx.sc_sid); 514 i = (int)STRLEN(fname_buf); 515 } 516 } 517 if (i + STRLEN(name + llen) < FLEN_FIXED) 518 { 519 STRCPY(fname_buf + i, name + llen); 520 fname = fname_buf; 521 } 522 else 523 { 524 fname = alloc((unsigned)(i + STRLEN(name + llen) + 1)); 525 if (fname == NULL) 526 *error = ERROR_OTHER; 527 else 528 { 529 *tofree = fname; 530 mch_memmove(fname, fname_buf, (size_t)i); 531 STRCPY(fname + i, name + llen); 532 } 533 } 534 } 535 else 536 fname = name; 537 return fname; 538 } 539 540 /* 541 * Find a function by name, return pointer to it in ufuncs. 542 * Return NULL for unknown function. 543 */ 544 ufunc_T * 545 find_func(char_u *name) 546 { 547 hashitem_T *hi; 548 549 hi = hash_find(&func_hashtab, name); 550 if (!HASHITEM_EMPTY(hi)) 551 return HI2UF(hi); 552 return NULL; 553 } 554 555 /* 556 * Copy the function name of "fp" to buffer "buf". 557 * "buf" must be able to hold the function name plus three bytes. 558 * Takes care of script-local function names. 559 */ 560 static void 561 cat_func_name(char_u *buf, ufunc_T *fp) 562 { 563 if (fp->uf_name[0] == K_SPECIAL) 564 { 565 STRCPY(buf, "<SNR>"); 566 STRCAT(buf, fp->uf_name + 3); 567 } 568 else 569 STRCPY(buf, fp->uf_name); 570 } 571 572 /* 573 * Add a number variable "name" to dict "dp" with value "nr". 574 */ 575 static void 576 add_nr_var( 577 dict_T *dp, 578 dictitem_T *v, 579 char *name, 580 varnumber_T nr) 581 { 582 STRCPY(v->di_key, name); 583 v->di_flags = DI_FLAGS_RO | DI_FLAGS_FIX; 584 hash_add(&dp->dv_hashtab, DI2HIKEY(v)); 585 v->di_tv.v_type = VAR_NUMBER; 586 v->di_tv.v_lock = VAR_FIXED; 587 v->di_tv.vval.v_number = nr; 588 } 589 590 /* 591 * Free "fc" and what it contains. 592 */ 593 static void 594 free_funccal( 595 funccall_T *fc, 596 int free_val) /* a: vars were allocated */ 597 { 598 listitem_T *li; 599 int i; 600 601 for (i = 0; i < fc->fc_funcs.ga_len; ++i) 602 { 603 ufunc_T *fp = ((ufunc_T **)(fc->fc_funcs.ga_data))[i]; 604 605 /* When garbage collecting a funccall_T may be freed before the 606 * function that references it, clear its uf_scoped field. 607 * The function may have been redefined and point to another 608 * funccall_T, don't clear it then. */ 609 if (fp != NULL && fp->uf_scoped == fc) 610 fp->uf_scoped = NULL; 611 } 612 ga_clear(&fc->fc_funcs); 613 614 /* The a: variables typevals may not have been allocated, only free the 615 * allocated variables. */ 616 vars_clear_ext(&fc->l_avars.dv_hashtab, free_val); 617 618 /* free all l: variables */ 619 vars_clear(&fc->l_vars.dv_hashtab); 620 621 /* Free the a:000 variables if they were allocated. */ 622 if (free_val) 623 for (li = fc->l_varlist.lv_first; li != NULL; li = li->li_next) 624 clear_tv(&li->li_tv); 625 626 func_ptr_unref(fc->func); 627 vim_free(fc); 628 } 629 630 /* 631 * Handle the last part of returning from a function: free the local hashtable. 632 * Unless it is still in use by a closure. 633 */ 634 static void 635 cleanup_function_call(funccall_T *fc) 636 { 637 current_funccal = fc->caller; 638 639 /* If the a:000 list and the l: and a: dicts are not referenced and there 640 * is no closure using it, we can free the funccall_T and what's in it. */ 641 if (fc->l_varlist.lv_refcount == DO_NOT_FREE_CNT 642 && fc->l_vars.dv_refcount == DO_NOT_FREE_CNT 643 && fc->l_avars.dv_refcount == DO_NOT_FREE_CNT 644 && fc->fc_refcount <= 0) 645 { 646 free_funccal(fc, FALSE); 647 } 648 else 649 { 650 hashitem_T *hi; 651 listitem_T *li; 652 int todo; 653 dictitem_T *v; 654 655 /* "fc" is still in use. This can happen when returning "a:000", 656 * assigning "l:" to a global variable or defining a closure. 657 * Link "fc" in the list for garbage collection later. */ 658 fc->caller = previous_funccal; 659 previous_funccal = fc; 660 661 /* Make a copy of the a: variables, since we didn't do that above. */ 662 todo = (int)fc->l_avars.dv_hashtab.ht_used; 663 for (hi = fc->l_avars.dv_hashtab.ht_array; todo > 0; ++hi) 664 { 665 if (!HASHITEM_EMPTY(hi)) 666 { 667 --todo; 668 v = HI2DI(hi); 669 copy_tv(&v->di_tv, &v->di_tv); 670 } 671 } 672 673 /* Make a copy of the a:000 items, since we didn't do that above. */ 674 for (li = fc->l_varlist.lv_first; li != NULL; li = li->li_next) 675 copy_tv(&li->li_tv, &li->li_tv); 676 } 677 } 678 679 /* 680 * Call a user function. 681 */ 682 static void 683 call_user_func( 684 ufunc_T *fp, /* pointer to function */ 685 int argcount, /* nr of args */ 686 typval_T *argvars, /* arguments */ 687 typval_T *rettv, /* return value */ 688 linenr_T firstline, /* first line of range */ 689 linenr_T lastline, /* last line of range */ 690 dict_T *selfdict) /* Dictionary for "self" */ 691 { 692 char_u *save_sourcing_name; 693 linenr_T save_sourcing_lnum; 694 sctx_T save_current_sctx; 695 int using_sandbox = FALSE; 696 funccall_T *fc; 697 int save_did_emsg; 698 static int depth = 0; 699 dictitem_T *v; 700 int fixvar_idx = 0; /* index in fixvar[] */ 701 int i; 702 int ai; 703 int islambda = FALSE; 704 char_u numbuf[NUMBUFLEN]; 705 char_u *name; 706 size_t len; 707 #ifdef FEAT_PROFILE 708 proftime_T wait_start; 709 proftime_T call_start; 710 int started_profiling = FALSE; 711 #endif 712 713 /* If depth of calling is getting too high, don't execute the function */ 714 if (depth >= p_mfd) 715 { 716 EMSG(_("E132: Function call depth is higher than 'maxfuncdepth'")); 717 rettv->v_type = VAR_NUMBER; 718 rettv->vval.v_number = -1; 719 return; 720 } 721 ++depth; 722 723 line_breakcheck(); /* check for CTRL-C hit */ 724 725 fc = (funccall_T *)alloc(sizeof(funccall_T)); 726 fc->caller = current_funccal; 727 current_funccal = fc; 728 fc->func = fp; 729 fc->rettv = rettv; 730 rettv->vval.v_number = 0; 731 fc->linenr = 0; 732 fc->returned = FALSE; 733 fc->level = ex_nesting_level; 734 /* Check if this function has a breakpoint. */ 735 fc->breakpoint = dbg_find_breakpoint(FALSE, fp->uf_name, (linenr_T)0); 736 fc->dbg_tick = debug_tick; 737 /* Set up fields for closure. */ 738 fc->fc_refcount = 0; 739 fc->fc_copyID = 0; 740 ga_init2(&fc->fc_funcs, sizeof(ufunc_T *), 1); 741 func_ptr_ref(fp); 742 743 if (STRNCMP(fp->uf_name, "<lambda>", 8) == 0) 744 islambda = TRUE; 745 746 /* 747 * Note about using fc->fixvar[]: This is an array of FIXVAR_CNT variables 748 * with names up to VAR_SHORT_LEN long. This avoids having to alloc/free 749 * each argument variable and saves a lot of time. 750 */ 751 /* 752 * Init l: variables. 753 */ 754 init_var_dict(&fc->l_vars, &fc->l_vars_var, VAR_DEF_SCOPE); 755 if (selfdict != NULL) 756 { 757 /* Set l:self to "selfdict". Use "name" to avoid a warning from 758 * some compiler that checks the destination size. */ 759 v = &fc->fixvar[fixvar_idx++].var; 760 name = v->di_key; 761 STRCPY(name, "self"); 762 v->di_flags = DI_FLAGS_RO + DI_FLAGS_FIX; 763 hash_add(&fc->l_vars.dv_hashtab, DI2HIKEY(v)); 764 v->di_tv.v_type = VAR_DICT; 765 v->di_tv.v_lock = 0; 766 v->di_tv.vval.v_dict = selfdict; 767 ++selfdict->dv_refcount; 768 } 769 770 /* 771 * Init a: variables. 772 * Set a:0 to "argcount". 773 * Set a:000 to a list with room for the "..." arguments. 774 */ 775 init_var_dict(&fc->l_avars, &fc->l_avars_var, VAR_SCOPE); 776 add_nr_var(&fc->l_avars, &fc->fixvar[fixvar_idx++].var, "0", 777 (varnumber_T)(argcount - fp->uf_args.ga_len)); 778 /* Use "name" to avoid a warning from some compiler that checks the 779 * destination size. */ 780 v = &fc->fixvar[fixvar_idx++].var; 781 name = v->di_key; 782 STRCPY(name, "000"); 783 v->di_flags = DI_FLAGS_RO | DI_FLAGS_FIX; 784 hash_add(&fc->l_avars.dv_hashtab, DI2HIKEY(v)); 785 v->di_tv.v_type = VAR_LIST; 786 v->di_tv.v_lock = VAR_FIXED; 787 v->di_tv.vval.v_list = &fc->l_varlist; 788 vim_memset(&fc->l_varlist, 0, sizeof(list_T)); 789 fc->l_varlist.lv_refcount = DO_NOT_FREE_CNT; 790 fc->l_varlist.lv_lock = VAR_FIXED; 791 792 /* 793 * Set a:firstline to "firstline" and a:lastline to "lastline". 794 * Set a:name to named arguments. 795 * Set a:N to the "..." arguments. 796 */ 797 add_nr_var(&fc->l_avars, &fc->fixvar[fixvar_idx++].var, "firstline", 798 (varnumber_T)firstline); 799 add_nr_var(&fc->l_avars, &fc->fixvar[fixvar_idx++].var, "lastline", 800 (varnumber_T)lastline); 801 for (i = 0; i < argcount; ++i) 802 { 803 int addlocal = FALSE; 804 805 ai = i - fp->uf_args.ga_len; 806 if (ai < 0) 807 { 808 /* named argument a:name */ 809 name = FUNCARG(fp, i); 810 if (islambda) 811 addlocal = TRUE; 812 } 813 else 814 { 815 /* "..." argument a:1, a:2, etc. */ 816 sprintf((char *)numbuf, "%d", ai + 1); 817 name = numbuf; 818 } 819 if (fixvar_idx < FIXVAR_CNT && STRLEN(name) <= VAR_SHORT_LEN) 820 { 821 v = &fc->fixvar[fixvar_idx++].var; 822 v->di_flags = DI_FLAGS_RO | DI_FLAGS_FIX; 823 } 824 else 825 { 826 v = (dictitem_T *)alloc((unsigned)(sizeof(dictitem_T) 827 + STRLEN(name))); 828 if (v == NULL) 829 break; 830 v->di_flags = DI_FLAGS_RO | DI_FLAGS_FIX | DI_FLAGS_ALLOC; 831 } 832 STRCPY(v->di_key, name); 833 834 /* Note: the values are copied directly to avoid alloc/free. 835 * "argvars" must have VAR_FIXED for v_lock. */ 836 v->di_tv = argvars[i]; 837 v->di_tv.v_lock = VAR_FIXED; 838 839 if (addlocal) 840 { 841 /* Named arguments should be accessed without the "a:" prefix in 842 * lambda expressions. Add to the l: dict. */ 843 copy_tv(&v->di_tv, &v->di_tv); 844 hash_add(&fc->l_vars.dv_hashtab, DI2HIKEY(v)); 845 } 846 else 847 hash_add(&fc->l_avars.dv_hashtab, DI2HIKEY(v)); 848 849 if (ai >= 0 && ai < MAX_FUNC_ARGS) 850 { 851 list_append(&fc->l_varlist, &fc->l_listitems[ai]); 852 fc->l_listitems[ai].li_tv = argvars[i]; 853 fc->l_listitems[ai].li_tv.v_lock = VAR_FIXED; 854 } 855 } 856 857 /* Don't redraw while executing the function. */ 858 ++RedrawingDisabled; 859 save_sourcing_name = sourcing_name; 860 save_sourcing_lnum = sourcing_lnum; 861 sourcing_lnum = 1; 862 863 if (fp->uf_flags & FC_SANDBOX) 864 { 865 using_sandbox = TRUE; 866 ++sandbox; 867 } 868 869 /* need space for function name + ("function " + 3) or "[number]" */ 870 len = (save_sourcing_name == NULL ? 0 : STRLEN(save_sourcing_name)) 871 + STRLEN(fp->uf_name) + 20; 872 sourcing_name = alloc((unsigned)len); 873 if (sourcing_name != NULL) 874 { 875 if (save_sourcing_name != NULL 876 && STRNCMP(save_sourcing_name, "function ", 9) == 0) 877 sprintf((char *)sourcing_name, "%s[%d]..", 878 save_sourcing_name, (int)save_sourcing_lnum); 879 else 880 STRCPY(sourcing_name, "function "); 881 cat_func_name(sourcing_name + STRLEN(sourcing_name), fp); 882 883 if (p_verbose >= 12) 884 { 885 ++no_wait_return; 886 verbose_enter_scroll(); 887 888 smsg((char_u *)_("calling %s"), sourcing_name); 889 if (p_verbose >= 14) 890 { 891 char_u buf[MSG_BUF_LEN]; 892 char_u numbuf2[NUMBUFLEN]; 893 char_u *tofree; 894 char_u *s; 895 896 msg_puts((char_u *)"("); 897 for (i = 0; i < argcount; ++i) 898 { 899 if (i > 0) 900 msg_puts((char_u *)", "); 901 if (argvars[i].v_type == VAR_NUMBER) 902 msg_outnum((long)argvars[i].vval.v_number); 903 else 904 { 905 /* Do not want errors such as E724 here. */ 906 ++emsg_off; 907 s = tv2string(&argvars[i], &tofree, numbuf2, 0); 908 --emsg_off; 909 if (s != NULL) 910 { 911 if (vim_strsize(s) > MSG_BUF_CLEN) 912 { 913 trunc_string(s, buf, MSG_BUF_CLEN, MSG_BUF_LEN); 914 s = buf; 915 } 916 msg_puts(s); 917 vim_free(tofree); 918 } 919 } 920 } 921 msg_puts((char_u *)")"); 922 } 923 msg_puts((char_u *)"\n"); /* don't overwrite this either */ 924 925 verbose_leave_scroll(); 926 --no_wait_return; 927 } 928 } 929 #ifdef FEAT_PROFILE 930 if (do_profiling == PROF_YES) 931 { 932 if (!fp->uf_profiling && has_profiling(FALSE, fp->uf_name, NULL)) 933 { 934 started_profiling = TRUE; 935 func_do_profile(fp); 936 } 937 if (fp->uf_profiling 938 || (fc->caller != NULL && fc->caller->func->uf_profiling)) 939 { 940 ++fp->uf_tm_count; 941 profile_start(&call_start); 942 profile_zero(&fp->uf_tm_children); 943 } 944 script_prof_save(&wait_start); 945 } 946 #endif 947 948 save_current_sctx = current_sctx; 949 current_sctx = fp->uf_script_ctx; 950 save_did_emsg = did_emsg; 951 did_emsg = FALSE; 952 953 /* call do_cmdline() to execute the lines */ 954 do_cmdline(NULL, get_func_line, (void *)fc, 955 DOCMD_NOWAIT|DOCMD_VERBOSE|DOCMD_REPEAT); 956 957 --RedrawingDisabled; 958 959 /* when the function was aborted because of an error, return -1 */ 960 if ((did_emsg && (fp->uf_flags & FC_ABORT)) || rettv->v_type == VAR_UNKNOWN) 961 { 962 clear_tv(rettv); 963 rettv->v_type = VAR_NUMBER; 964 rettv->vval.v_number = -1; 965 } 966 967 #ifdef FEAT_PROFILE 968 if (do_profiling == PROF_YES && (fp->uf_profiling 969 || (fc->caller != NULL && fc->caller->func->uf_profiling))) 970 { 971 profile_end(&call_start); 972 profile_sub_wait(&wait_start, &call_start); 973 profile_add(&fp->uf_tm_total, &call_start); 974 profile_self(&fp->uf_tm_self, &call_start, &fp->uf_tm_children); 975 if (fc->caller != NULL && fc->caller->func->uf_profiling) 976 { 977 profile_add(&fc->caller->func->uf_tm_children, &call_start); 978 profile_add(&fc->caller->func->uf_tml_children, &call_start); 979 } 980 if (started_profiling) 981 // make a ":profdel func" stop profiling the function 982 fp->uf_profiling = FALSE; 983 } 984 #endif 985 986 /* when being verbose, mention the return value */ 987 if (p_verbose >= 12) 988 { 989 ++no_wait_return; 990 verbose_enter_scroll(); 991 992 if (aborting()) 993 smsg((char_u *)_("%s aborted"), sourcing_name); 994 else if (fc->rettv->v_type == VAR_NUMBER) 995 smsg((char_u *)_("%s returning #%ld"), sourcing_name, 996 (long)fc->rettv->vval.v_number); 997 else 998 { 999 char_u buf[MSG_BUF_LEN]; 1000 char_u numbuf2[NUMBUFLEN]; 1001 char_u *tofree; 1002 char_u *s; 1003 1004 /* The value may be very long. Skip the middle part, so that we 1005 * have some idea how it starts and ends. smsg() would always 1006 * truncate it at the end. Don't want errors such as E724 here. */ 1007 ++emsg_off; 1008 s = tv2string(fc->rettv, &tofree, numbuf2, 0); 1009 --emsg_off; 1010 if (s != NULL) 1011 { 1012 if (vim_strsize(s) > MSG_BUF_CLEN) 1013 { 1014 trunc_string(s, buf, MSG_BUF_CLEN, MSG_BUF_LEN); 1015 s = buf; 1016 } 1017 smsg((char_u *)_("%s returning %s"), sourcing_name, s); 1018 vim_free(tofree); 1019 } 1020 } 1021 msg_puts((char_u *)"\n"); /* don't overwrite this either */ 1022 1023 verbose_leave_scroll(); 1024 --no_wait_return; 1025 } 1026 1027 vim_free(sourcing_name); 1028 sourcing_name = save_sourcing_name; 1029 sourcing_lnum = save_sourcing_lnum; 1030 current_sctx = save_current_sctx; 1031 #ifdef FEAT_PROFILE 1032 if (do_profiling == PROF_YES) 1033 script_prof_restore(&wait_start); 1034 #endif 1035 if (using_sandbox) 1036 --sandbox; 1037 1038 if (p_verbose >= 12 && sourcing_name != NULL) 1039 { 1040 ++no_wait_return; 1041 verbose_enter_scroll(); 1042 1043 smsg((char_u *)_("continuing in %s"), sourcing_name); 1044 msg_puts((char_u *)"\n"); /* don't overwrite this either */ 1045 1046 verbose_leave_scroll(); 1047 --no_wait_return; 1048 } 1049 1050 did_emsg |= save_did_emsg; 1051 --depth; 1052 1053 cleanup_function_call(fc); 1054 } 1055 1056 /* 1057 * Unreference "fc": decrement the reference count and free it when it 1058 * becomes zero. "fp" is detached from "fc". 1059 * When "force" is TRUE we are exiting. 1060 */ 1061 static void 1062 funccal_unref(funccall_T *fc, ufunc_T *fp, int force) 1063 { 1064 funccall_T **pfc; 1065 int i; 1066 1067 if (fc == NULL) 1068 return; 1069 1070 if (--fc->fc_refcount <= 0 && (force || ( 1071 fc->l_varlist.lv_refcount == DO_NOT_FREE_CNT 1072 && fc->l_vars.dv_refcount == DO_NOT_FREE_CNT 1073 && fc->l_avars.dv_refcount == DO_NOT_FREE_CNT))) 1074 for (pfc = &previous_funccal; *pfc != NULL; pfc = &(*pfc)->caller) 1075 { 1076 if (fc == *pfc) 1077 { 1078 *pfc = fc->caller; 1079 free_funccal(fc, TRUE); 1080 return; 1081 } 1082 } 1083 for (i = 0; i < fc->fc_funcs.ga_len; ++i) 1084 if (((ufunc_T **)(fc->fc_funcs.ga_data))[i] == fp) 1085 ((ufunc_T **)(fc->fc_funcs.ga_data))[i] = NULL; 1086 } 1087 1088 /* 1089 * Remove the function from the function hashtable. If the function was 1090 * deleted while it still has references this was already done. 1091 * Return TRUE if the entry was deleted, FALSE if it wasn't found. 1092 */ 1093 static int 1094 func_remove(ufunc_T *fp) 1095 { 1096 hashitem_T *hi = hash_find(&func_hashtab, UF2HIKEY(fp)); 1097 1098 if (!HASHITEM_EMPTY(hi)) 1099 { 1100 hash_remove(&func_hashtab, hi); 1101 return TRUE; 1102 } 1103 return FALSE; 1104 } 1105 1106 static void 1107 func_clear_items(ufunc_T *fp) 1108 { 1109 ga_clear_strings(&(fp->uf_args)); 1110 ga_clear_strings(&(fp->uf_lines)); 1111 #ifdef FEAT_PROFILE 1112 vim_free(fp->uf_tml_count); 1113 fp->uf_tml_count = NULL; 1114 vim_free(fp->uf_tml_total); 1115 fp->uf_tml_total = NULL; 1116 vim_free(fp->uf_tml_self); 1117 fp->uf_tml_self = NULL; 1118 #endif 1119 } 1120 1121 /* 1122 * Free all things that a function contains. Does not free the function 1123 * itself, use func_free() for that. 1124 * When "force" is TRUE we are exiting. 1125 */ 1126 static void 1127 func_clear(ufunc_T *fp, int force) 1128 { 1129 if (fp->uf_cleared) 1130 return; 1131 fp->uf_cleared = TRUE; 1132 1133 /* clear this function */ 1134 func_clear_items(fp); 1135 funccal_unref(fp->uf_scoped, fp, force); 1136 } 1137 1138 /* 1139 * Free a function and remove it from the list of functions. Does not free 1140 * what a function contains, call func_clear() first. 1141 */ 1142 static void 1143 func_free(ufunc_T *fp) 1144 { 1145 /* only remove it when not done already, otherwise we would remove a newer 1146 * version of the function */ 1147 if ((fp->uf_flags & (FC_DELETED | FC_REMOVED)) == 0) 1148 func_remove(fp); 1149 1150 vim_free(fp); 1151 } 1152 1153 /* 1154 * Free all things that a function contains and free the function itself. 1155 * When "force" is TRUE we are exiting. 1156 */ 1157 static void 1158 func_clear_free(ufunc_T *fp, int force) 1159 { 1160 func_clear(fp, force); 1161 func_free(fp); 1162 } 1163 1164 /* 1165 * There are two kinds of function names: 1166 * 1. ordinary names, function defined with :function 1167 * 2. numbered functions and lambdas 1168 * For the first we only count the name stored in func_hashtab as a reference, 1169 * using function() does not count as a reference, because the function is 1170 * looked up by name. 1171 */ 1172 static int 1173 func_name_refcount(char_u *name) 1174 { 1175 return isdigit(*name) || *name == '<'; 1176 } 1177 1178 static funccal_entry_T *funccal_stack = NULL; 1179 1180 /* 1181 * Save the current function call pointer, and set it to NULL. 1182 * Used when executing autocommands and for ":source". 1183 */ 1184 void 1185 save_funccal(funccal_entry_T *entry) 1186 { 1187 entry->top_funccal = current_funccal; 1188 entry->next = funccal_stack; 1189 funccal_stack = entry; 1190 current_funccal = NULL; 1191 } 1192 1193 void 1194 restore_funccal(void) 1195 { 1196 if (funccal_stack == NULL) 1197 IEMSG("INTERNAL: restore_funccal()"); 1198 else 1199 { 1200 current_funccal = funccal_stack->top_funccal; 1201 funccal_stack = funccal_stack->next; 1202 } 1203 } 1204 1205 #if defined(EXITFREE) || defined(PROTO) 1206 void 1207 free_all_functions(void) 1208 { 1209 hashitem_T *hi; 1210 ufunc_T *fp; 1211 long_u skipped = 0; 1212 long_u todo = 1; 1213 long_u used; 1214 1215 /* Clean up the current_funccal chain and the funccal stack. */ 1216 while (current_funccal != NULL) 1217 { 1218 clear_tv(current_funccal->rettv); 1219 cleanup_function_call(current_funccal); 1220 if (current_funccal == NULL && funccal_stack != NULL) 1221 restore_funccal(); 1222 } 1223 1224 /* First clear what the functions contain. Since this may lower the 1225 * reference count of a function, it may also free a function and change 1226 * the hash table. Restart if that happens. */ 1227 while (todo > 0) 1228 { 1229 todo = func_hashtab.ht_used; 1230 for (hi = func_hashtab.ht_array; todo > 0; ++hi) 1231 if (!HASHITEM_EMPTY(hi)) 1232 { 1233 /* Only free functions that are not refcounted, those are 1234 * supposed to be freed when no longer referenced. */ 1235 fp = HI2UF(hi); 1236 if (func_name_refcount(fp->uf_name)) 1237 ++skipped; 1238 else 1239 { 1240 used = func_hashtab.ht_used; 1241 func_clear(fp, TRUE); 1242 if (used != func_hashtab.ht_used) 1243 { 1244 skipped = 0; 1245 break; 1246 } 1247 } 1248 --todo; 1249 } 1250 } 1251 1252 /* Now actually free the functions. Need to start all over every time, 1253 * because func_free() may change the hash table. */ 1254 skipped = 0; 1255 while (func_hashtab.ht_used > skipped) 1256 { 1257 todo = func_hashtab.ht_used; 1258 for (hi = func_hashtab.ht_array; todo > 0; ++hi) 1259 if (!HASHITEM_EMPTY(hi)) 1260 { 1261 --todo; 1262 /* Only free functions that are not refcounted, those are 1263 * supposed to be freed when no longer referenced. */ 1264 fp = HI2UF(hi); 1265 if (func_name_refcount(fp->uf_name)) 1266 ++skipped; 1267 else 1268 { 1269 func_free(fp); 1270 skipped = 0; 1271 break; 1272 } 1273 } 1274 } 1275 if (skipped == 0) 1276 hash_clear(&func_hashtab); 1277 } 1278 #endif 1279 1280 /* 1281 * Return TRUE if "name" looks like a builtin function name: starts with a 1282 * lower case letter and doesn't contain AUTOLOAD_CHAR. 1283 * "len" is the length of "name", or -1 for NUL terminated. 1284 */ 1285 static int 1286 builtin_function(char_u *name, int len) 1287 { 1288 char_u *p; 1289 1290 if (!ASCII_ISLOWER(name[0])) 1291 return FALSE; 1292 p = vim_strchr(name, AUTOLOAD_CHAR); 1293 return p == NULL || (len > 0 && p > name + len); 1294 } 1295 1296 int 1297 func_call( 1298 char_u *name, 1299 typval_T *args, 1300 partial_T *partial, 1301 dict_T *selfdict, 1302 typval_T *rettv) 1303 { 1304 listitem_T *item; 1305 typval_T argv[MAX_FUNC_ARGS + 1]; 1306 int argc = 0; 1307 int dummy; 1308 int r = 0; 1309 1310 for (item = args->vval.v_list->lv_first; item != NULL; 1311 item = item->li_next) 1312 { 1313 if (argc == MAX_FUNC_ARGS - (partial == NULL ? 0 : partial->pt_argc)) 1314 { 1315 EMSG(_("E699: Too many arguments")); 1316 break; 1317 } 1318 /* Make a copy of each argument. This is needed to be able to set 1319 * v_lock to VAR_FIXED in the copy without changing the original list. 1320 */ 1321 copy_tv(&item->li_tv, &argv[argc++]); 1322 } 1323 1324 if (item == NULL) 1325 r = call_func(name, (int)STRLEN(name), rettv, argc, argv, NULL, 1326 curwin->w_cursor.lnum, curwin->w_cursor.lnum, 1327 &dummy, TRUE, partial, selfdict); 1328 1329 /* Free the arguments. */ 1330 while (argc > 0) 1331 clear_tv(&argv[--argc]); 1332 1333 return r; 1334 } 1335 1336 /* 1337 * Call a function with its resolved parameters 1338 * 1339 * "argv_func", when not NULL, can be used to fill in arguments only when the 1340 * invoked function uses them. It is called like this: 1341 * new_argcount = argv_func(current_argcount, argv, called_func_argcount) 1342 * 1343 * Return FAIL when the function can't be called, OK otherwise. 1344 * Also returns OK when an error was encountered while executing the function. 1345 */ 1346 int 1347 call_func( 1348 char_u *funcname, /* name of the function */ 1349 int len, /* length of "name" */ 1350 typval_T *rettv, /* return value goes here */ 1351 int argcount_in, /* number of "argvars" */ 1352 typval_T *argvars_in, /* vars for arguments, must have "argcount" 1353 PLUS ONE elements! */ 1354 int (* argv_func)(int, typval_T *, int), 1355 /* function to fill in argvars */ 1356 linenr_T firstline, /* first line of range */ 1357 linenr_T lastline, /* last line of range */ 1358 int *doesrange, /* return: function handled range */ 1359 int evaluate, 1360 partial_T *partial, /* optional, can be NULL */ 1361 dict_T *selfdict_in) /* Dictionary for "self" */ 1362 { 1363 int ret = FAIL; 1364 int error = ERROR_NONE; 1365 int i; 1366 ufunc_T *fp; 1367 char_u fname_buf[FLEN_FIXED + 1]; 1368 char_u *tofree = NULL; 1369 char_u *fname; 1370 char_u *name; 1371 int argcount = argcount_in; 1372 typval_T *argvars = argvars_in; 1373 dict_T *selfdict = selfdict_in; 1374 typval_T argv[MAX_FUNC_ARGS + 1]; /* used when "partial" is not NULL */ 1375 int argv_clear = 0; 1376 1377 /* Make a copy of the name, if it comes from a funcref variable it could 1378 * be changed or deleted in the called function. */ 1379 name = vim_strnsave(funcname, len); 1380 if (name == NULL) 1381 return ret; 1382 1383 fname = fname_trans_sid(name, fname_buf, &tofree, &error); 1384 1385 *doesrange = FALSE; 1386 1387 if (partial != NULL) 1388 { 1389 /* When the function has a partial with a dict and there is a dict 1390 * argument, use the dict argument. That is backwards compatible. 1391 * When the dict was bound explicitly use the one from the partial. */ 1392 if (partial->pt_dict != NULL 1393 && (selfdict_in == NULL || !partial->pt_auto)) 1394 selfdict = partial->pt_dict; 1395 if (error == ERROR_NONE && partial->pt_argc > 0) 1396 { 1397 for (argv_clear = 0; argv_clear < partial->pt_argc; ++argv_clear) 1398 copy_tv(&partial->pt_argv[argv_clear], &argv[argv_clear]); 1399 for (i = 0; i < argcount_in; ++i) 1400 argv[i + argv_clear] = argvars_in[i]; 1401 argvars = argv; 1402 argcount = partial->pt_argc + argcount_in; 1403 } 1404 } 1405 1406 1407 /* 1408 * Execute the function if executing and no errors were detected. 1409 */ 1410 if (!evaluate) 1411 { 1412 // Not evaluating, which means the return value is unknown. This 1413 // matters for giving error messages. 1414 rettv->v_type = VAR_UNKNOWN; 1415 } 1416 else if (error == ERROR_NONE) 1417 { 1418 char_u *rfname = fname; 1419 1420 /* Ignore "g:" before a function name. */ 1421 if (fname[0] == 'g' && fname[1] == ':') 1422 rfname = fname + 2; 1423 1424 rettv->v_type = VAR_NUMBER; /* default rettv is number zero */ 1425 rettv->vval.v_number = 0; 1426 error = ERROR_UNKNOWN; 1427 1428 if (!builtin_function(rfname, -1)) 1429 { 1430 /* 1431 * User defined function. 1432 */ 1433 if (partial != NULL && partial->pt_func != NULL) 1434 fp = partial->pt_func; 1435 else 1436 fp = find_func(rfname); 1437 1438 /* Trigger FuncUndefined event, may load the function. */ 1439 if (fp == NULL 1440 && apply_autocmds(EVENT_FUNCUNDEFINED, 1441 rfname, rfname, TRUE, NULL) 1442 && !aborting()) 1443 { 1444 /* executed an autocommand, search for the function again */ 1445 fp = find_func(rfname); 1446 } 1447 /* Try loading a package. */ 1448 if (fp == NULL && script_autoload(rfname, TRUE) && !aborting()) 1449 { 1450 /* loaded a package, search for the function again */ 1451 fp = find_func(rfname); 1452 } 1453 1454 if (fp != NULL && (fp->uf_flags & FC_DELETED)) 1455 error = ERROR_DELETED; 1456 else if (fp != NULL) 1457 { 1458 if (argv_func != NULL) 1459 argcount = argv_func(argcount, argvars, fp->uf_args.ga_len); 1460 1461 if (fp->uf_flags & FC_RANGE) 1462 *doesrange = TRUE; 1463 if (argcount < fp->uf_args.ga_len) 1464 error = ERROR_TOOFEW; 1465 else if (!fp->uf_varargs && argcount > fp->uf_args.ga_len) 1466 error = ERROR_TOOMANY; 1467 else if ((fp->uf_flags & FC_DICT) && selfdict == NULL) 1468 error = ERROR_DICT; 1469 else 1470 { 1471 int did_save_redo = FALSE; 1472 save_redo_T save_redo; 1473 1474 /* 1475 * Call the user function. 1476 * Save and restore search patterns, script variables and 1477 * redo buffer. 1478 */ 1479 save_search_patterns(); 1480 #ifdef FEAT_INS_EXPAND 1481 if (!ins_compl_active()) 1482 #endif 1483 { 1484 saveRedobuff(&save_redo); 1485 did_save_redo = TRUE; 1486 } 1487 ++fp->uf_calls; 1488 call_user_func(fp, argcount, argvars, rettv, 1489 firstline, lastline, 1490 (fp->uf_flags & FC_DICT) ? selfdict : NULL); 1491 if (--fp->uf_calls <= 0 && fp->uf_refcount <= 0) 1492 /* Function was unreferenced while being used, free it 1493 * now. */ 1494 func_clear_free(fp, FALSE); 1495 if (did_save_redo) 1496 restoreRedobuff(&save_redo); 1497 restore_search_patterns(); 1498 error = ERROR_NONE; 1499 } 1500 } 1501 } 1502 else 1503 { 1504 /* 1505 * Find the function name in the table, call its implementation. 1506 */ 1507 error = call_internal_func(fname, argcount, argvars, rettv); 1508 } 1509 /* 1510 * The function call (or "FuncUndefined" autocommand sequence) might 1511 * have been aborted by an error, an interrupt, or an explicitly thrown 1512 * exception that has not been caught so far. This situation can be 1513 * tested for by calling aborting(). For an error in an internal 1514 * function or for the "E132" error in call_user_func(), however, the 1515 * throw point at which the "force_abort" flag (temporarily reset by 1516 * emsg()) is normally updated has not been reached yet. We need to 1517 * update that flag first to make aborting() reliable. 1518 */ 1519 update_force_abort(); 1520 } 1521 if (error == ERROR_NONE) 1522 ret = OK; 1523 1524 /* 1525 * Report an error unless the argument evaluation or function call has been 1526 * cancelled due to an aborting error, an interrupt, or an exception. 1527 */ 1528 if (!aborting()) 1529 { 1530 switch (error) 1531 { 1532 case ERROR_UNKNOWN: 1533 emsg_funcname(N_("E117: Unknown function: %s"), name); 1534 break; 1535 case ERROR_DELETED: 1536 emsg_funcname(N_("E933: Function was deleted: %s"), name); 1537 break; 1538 case ERROR_TOOMANY: 1539 emsg_funcname((char *)e_toomanyarg, name); 1540 break; 1541 case ERROR_TOOFEW: 1542 emsg_funcname(N_("E119: Not enough arguments for function: %s"), 1543 name); 1544 break; 1545 case ERROR_SCRIPT: 1546 emsg_funcname(N_("E120: Using <SID> not in a script context: %s"), 1547 name); 1548 break; 1549 case ERROR_DICT: 1550 emsg_funcname(N_("E725: Calling dict function without Dictionary: %s"), 1551 name); 1552 break; 1553 } 1554 } 1555 1556 while (argv_clear > 0) 1557 clear_tv(&argv[--argv_clear]); 1558 vim_free(tofree); 1559 vim_free(name); 1560 1561 return ret; 1562 } 1563 1564 /* 1565 * List the head of the function: "name(arg1, arg2)". 1566 */ 1567 static void 1568 list_func_head(ufunc_T *fp, int indent) 1569 { 1570 int j; 1571 1572 msg_start(); 1573 if (indent) 1574 MSG_PUTS(" "); 1575 MSG_PUTS("function "); 1576 if (fp->uf_name[0] == K_SPECIAL) 1577 { 1578 MSG_PUTS_ATTR("<SNR>", HL_ATTR(HLF_8)); 1579 msg_puts(fp->uf_name + 3); 1580 } 1581 else 1582 msg_puts(fp->uf_name); 1583 msg_putchar('('); 1584 for (j = 0; j < fp->uf_args.ga_len; ++j) 1585 { 1586 if (j) 1587 MSG_PUTS(", "); 1588 msg_puts(FUNCARG(fp, j)); 1589 } 1590 if (fp->uf_varargs) 1591 { 1592 if (j) 1593 MSG_PUTS(", "); 1594 MSG_PUTS("..."); 1595 } 1596 msg_putchar(')'); 1597 if (fp->uf_flags & FC_ABORT) 1598 MSG_PUTS(" abort"); 1599 if (fp->uf_flags & FC_RANGE) 1600 MSG_PUTS(" range"); 1601 if (fp->uf_flags & FC_DICT) 1602 MSG_PUTS(" dict"); 1603 if (fp->uf_flags & FC_CLOSURE) 1604 MSG_PUTS(" closure"); 1605 msg_clr_eos(); 1606 if (p_verbose > 0) 1607 last_set_msg(fp->uf_script_ctx); 1608 } 1609 1610 /* 1611 * Get a function name, translating "<SID>" and "<SNR>". 1612 * Also handles a Funcref in a List or Dictionary. 1613 * Returns the function name in allocated memory, or NULL for failure. 1614 * flags: 1615 * TFN_INT: internal function name OK 1616 * TFN_QUIET: be quiet 1617 * TFN_NO_AUTOLOAD: do not use script autoloading 1618 * TFN_NO_DEREF: do not dereference a Funcref 1619 * Advances "pp" to just after the function name (if no error). 1620 */ 1621 char_u * 1622 trans_function_name( 1623 char_u **pp, 1624 int skip, /* only find the end, don't evaluate */ 1625 int flags, 1626 funcdict_T *fdp, /* return: info about dictionary used */ 1627 partial_T **partial) /* return: partial of a FuncRef */ 1628 { 1629 char_u *name = NULL; 1630 char_u *start; 1631 char_u *end; 1632 int lead; 1633 char_u sid_buf[20]; 1634 int len; 1635 lval_T lv; 1636 1637 if (fdp != NULL) 1638 vim_memset(fdp, 0, sizeof(funcdict_T)); 1639 start = *pp; 1640 1641 /* Check for hard coded <SNR>: already translated function ID (from a user 1642 * command). */ 1643 if ((*pp)[0] == K_SPECIAL && (*pp)[1] == KS_EXTRA 1644 && (*pp)[2] == (int)KE_SNR) 1645 { 1646 *pp += 3; 1647 len = get_id_len(pp) + 3; 1648 return vim_strnsave(start, len); 1649 } 1650 1651 /* A name starting with "<SID>" or "<SNR>" is local to a script. But 1652 * don't skip over "s:", get_lval() needs it for "s:dict.func". */ 1653 lead = eval_fname_script(start); 1654 if (lead > 2) 1655 start += lead; 1656 1657 /* Note that TFN_ flags use the same values as GLV_ flags. */ 1658 end = get_lval(start, NULL, &lv, FALSE, skip, flags | GLV_READ_ONLY, 1659 lead > 2 ? 0 : FNE_CHECK_START); 1660 if (end == start) 1661 { 1662 if (!skip) 1663 EMSG(_("E129: Function name required")); 1664 goto theend; 1665 } 1666 if (end == NULL || (lv.ll_tv != NULL && (lead > 2 || lv.ll_range))) 1667 { 1668 /* 1669 * Report an invalid expression in braces, unless the expression 1670 * evaluation has been cancelled due to an aborting error, an 1671 * interrupt, or an exception. 1672 */ 1673 if (!aborting()) 1674 { 1675 if (end != NULL) 1676 EMSG2(_(e_invarg2), start); 1677 } 1678 else 1679 *pp = find_name_end(start, NULL, NULL, FNE_INCL_BR); 1680 goto theend; 1681 } 1682 1683 if (lv.ll_tv != NULL) 1684 { 1685 if (fdp != NULL) 1686 { 1687 fdp->fd_dict = lv.ll_dict; 1688 fdp->fd_newkey = lv.ll_newkey; 1689 lv.ll_newkey = NULL; 1690 fdp->fd_di = lv.ll_di; 1691 } 1692 if (lv.ll_tv->v_type == VAR_FUNC && lv.ll_tv->vval.v_string != NULL) 1693 { 1694 name = vim_strsave(lv.ll_tv->vval.v_string); 1695 *pp = end; 1696 } 1697 else if (lv.ll_tv->v_type == VAR_PARTIAL 1698 && lv.ll_tv->vval.v_partial != NULL) 1699 { 1700 name = vim_strsave(partial_name(lv.ll_tv->vval.v_partial)); 1701 *pp = end; 1702 if (partial != NULL) 1703 *partial = lv.ll_tv->vval.v_partial; 1704 } 1705 else 1706 { 1707 if (!skip && !(flags & TFN_QUIET) && (fdp == NULL 1708 || lv.ll_dict == NULL || fdp->fd_newkey == NULL)) 1709 EMSG(_(e_funcref)); 1710 else 1711 *pp = end; 1712 name = NULL; 1713 } 1714 goto theend; 1715 } 1716 1717 if (lv.ll_name == NULL) 1718 { 1719 /* Error found, but continue after the function name. */ 1720 *pp = end; 1721 goto theend; 1722 } 1723 1724 /* Check if the name is a Funcref. If so, use the value. */ 1725 if (lv.ll_exp_name != NULL) 1726 { 1727 len = (int)STRLEN(lv.ll_exp_name); 1728 name = deref_func_name(lv.ll_exp_name, &len, partial, 1729 flags & TFN_NO_AUTOLOAD); 1730 if (name == lv.ll_exp_name) 1731 name = NULL; 1732 } 1733 else if (!(flags & TFN_NO_DEREF)) 1734 { 1735 len = (int)(end - *pp); 1736 name = deref_func_name(*pp, &len, partial, flags & TFN_NO_AUTOLOAD); 1737 if (name == *pp) 1738 name = NULL; 1739 } 1740 if (name != NULL) 1741 { 1742 name = vim_strsave(name); 1743 *pp = end; 1744 if (STRNCMP(name, "<SNR>", 5) == 0) 1745 { 1746 /* Change "<SNR>" to the byte sequence. */ 1747 name[0] = K_SPECIAL; 1748 name[1] = KS_EXTRA; 1749 name[2] = (int)KE_SNR; 1750 mch_memmove(name + 3, name + 5, STRLEN(name + 5) + 1); 1751 } 1752 goto theend; 1753 } 1754 1755 if (lv.ll_exp_name != NULL) 1756 { 1757 len = (int)STRLEN(lv.ll_exp_name); 1758 if (lead <= 2 && lv.ll_name == lv.ll_exp_name 1759 && STRNCMP(lv.ll_name, "s:", 2) == 0) 1760 { 1761 /* When there was "s:" already or the name expanded to get a 1762 * leading "s:" then remove it. */ 1763 lv.ll_name += 2; 1764 len -= 2; 1765 lead = 2; 1766 } 1767 } 1768 else 1769 { 1770 /* skip over "s:" and "g:" */ 1771 if (lead == 2 || (lv.ll_name[0] == 'g' && lv.ll_name[1] == ':')) 1772 lv.ll_name += 2; 1773 len = (int)(end - lv.ll_name); 1774 } 1775 1776 /* 1777 * Copy the function name to allocated memory. 1778 * Accept <SID>name() inside a script, translate into <SNR>123_name(). 1779 * Accept <SNR>123_name() outside a script. 1780 */ 1781 if (skip) 1782 lead = 0; /* do nothing */ 1783 else if (lead > 0) 1784 { 1785 lead = 3; 1786 if ((lv.ll_exp_name != NULL && eval_fname_sid(lv.ll_exp_name)) 1787 || eval_fname_sid(*pp)) 1788 { 1789 /* It's "s:" or "<SID>" */ 1790 if (current_sctx.sc_sid <= 0) 1791 { 1792 EMSG(_(e_usingsid)); 1793 goto theend; 1794 } 1795 sprintf((char *)sid_buf, "%ld_", (long)current_sctx.sc_sid); 1796 lead += (int)STRLEN(sid_buf); 1797 } 1798 } 1799 else if (!(flags & TFN_INT) && builtin_function(lv.ll_name, len)) 1800 { 1801 EMSG2(_("E128: Function name must start with a capital or \"s:\": %s"), 1802 start); 1803 goto theend; 1804 } 1805 if (!skip && !(flags & TFN_QUIET) && !(flags & TFN_NO_DEREF)) 1806 { 1807 char_u *cp = vim_strchr(lv.ll_name, ':'); 1808 1809 if (cp != NULL && cp < end) 1810 { 1811 EMSG2(_("E884: Function name cannot contain a colon: %s"), start); 1812 goto theend; 1813 } 1814 } 1815 1816 name = alloc((unsigned)(len + lead + 1)); 1817 if (name != NULL) 1818 { 1819 if (lead > 0) 1820 { 1821 name[0] = K_SPECIAL; 1822 name[1] = KS_EXTRA; 1823 name[2] = (int)KE_SNR; 1824 if (lead > 3) /* If it's "<SID>" */ 1825 STRCPY(name + 3, sid_buf); 1826 } 1827 mch_memmove(name + lead, lv.ll_name, (size_t)len); 1828 name[lead + len] = NUL; 1829 } 1830 *pp = end; 1831 1832 theend: 1833 clear_lval(&lv); 1834 return name; 1835 } 1836 1837 /* 1838 * ":function" 1839 */ 1840 void 1841 ex_function(exarg_T *eap) 1842 { 1843 char_u *theline; 1844 char_u *line_to_free = NULL; 1845 int j; 1846 int c; 1847 int saved_did_emsg; 1848 int saved_wait_return = need_wait_return; 1849 char_u *name = NULL; 1850 char_u *p; 1851 char_u *arg; 1852 char_u *line_arg = NULL; 1853 garray_T newargs; 1854 garray_T newlines; 1855 int varargs = FALSE; 1856 int flags = 0; 1857 ufunc_T *fp; 1858 int overwrite = FALSE; 1859 int indent; 1860 int nesting; 1861 char_u *skip_until = NULL; 1862 dictitem_T *v; 1863 funcdict_T fudi; 1864 static int func_nr = 0; /* number for nameless function */ 1865 int paren; 1866 hashtab_T *ht; 1867 int todo; 1868 hashitem_T *hi; 1869 int sourcing_lnum_off; 1870 1871 /* 1872 * ":function" without argument: list functions. 1873 */ 1874 if (ends_excmd(*eap->arg)) 1875 { 1876 if (!eap->skip) 1877 { 1878 todo = (int)func_hashtab.ht_used; 1879 for (hi = func_hashtab.ht_array; todo > 0 && !got_int; ++hi) 1880 { 1881 if (!HASHITEM_EMPTY(hi)) 1882 { 1883 --todo; 1884 fp = HI2UF(hi); 1885 if (message_filtered(fp->uf_name)) 1886 continue; 1887 if (!func_name_refcount(fp->uf_name)) 1888 list_func_head(fp, FALSE); 1889 } 1890 } 1891 } 1892 eap->nextcmd = check_nextcmd(eap->arg); 1893 return; 1894 } 1895 1896 /* 1897 * ":function /pat": list functions matching pattern. 1898 */ 1899 if (*eap->arg == '/') 1900 { 1901 p = skip_regexp(eap->arg + 1, '/', TRUE, NULL); 1902 if (!eap->skip) 1903 { 1904 regmatch_T regmatch; 1905 1906 c = *p; 1907 *p = NUL; 1908 regmatch.regprog = vim_regcomp(eap->arg + 1, RE_MAGIC); 1909 *p = c; 1910 if (regmatch.regprog != NULL) 1911 { 1912 regmatch.rm_ic = p_ic; 1913 1914 todo = (int)func_hashtab.ht_used; 1915 for (hi = func_hashtab.ht_array; todo > 0 && !got_int; ++hi) 1916 { 1917 if (!HASHITEM_EMPTY(hi)) 1918 { 1919 --todo; 1920 fp = HI2UF(hi); 1921 if (!isdigit(*fp->uf_name) 1922 && vim_regexec(®match, fp->uf_name, 0)) 1923 list_func_head(fp, FALSE); 1924 } 1925 } 1926 vim_regfree(regmatch.regprog); 1927 } 1928 } 1929 if (*p == '/') 1930 ++p; 1931 eap->nextcmd = check_nextcmd(p); 1932 return; 1933 } 1934 1935 /* 1936 * Get the function name. There are these situations: 1937 * func normal function name 1938 * "name" == func, "fudi.fd_dict" == NULL 1939 * dict.func new dictionary entry 1940 * "name" == NULL, "fudi.fd_dict" set, 1941 * "fudi.fd_di" == NULL, "fudi.fd_newkey" == func 1942 * dict.func existing dict entry with a Funcref 1943 * "name" == func, "fudi.fd_dict" set, 1944 * "fudi.fd_di" set, "fudi.fd_newkey" == NULL 1945 * dict.func existing dict entry that's not a Funcref 1946 * "name" == NULL, "fudi.fd_dict" set, 1947 * "fudi.fd_di" set, "fudi.fd_newkey" == NULL 1948 * s:func script-local function name 1949 * g:func global function name, same as "func" 1950 */ 1951 p = eap->arg; 1952 name = trans_function_name(&p, eap->skip, TFN_NO_AUTOLOAD, &fudi, NULL); 1953 paren = (vim_strchr(p, '(') != NULL); 1954 if (name == NULL && (fudi.fd_dict == NULL || !paren) && !eap->skip) 1955 { 1956 /* 1957 * Return on an invalid expression in braces, unless the expression 1958 * evaluation has been cancelled due to an aborting error, an 1959 * interrupt, or an exception. 1960 */ 1961 if (!aborting()) 1962 { 1963 if (!eap->skip && fudi.fd_newkey != NULL) 1964 EMSG2(_(e_dictkey), fudi.fd_newkey); 1965 vim_free(fudi.fd_newkey); 1966 return; 1967 } 1968 else 1969 eap->skip = TRUE; 1970 } 1971 1972 /* An error in a function call during evaluation of an expression in magic 1973 * braces should not cause the function not to be defined. */ 1974 saved_did_emsg = did_emsg; 1975 did_emsg = FALSE; 1976 1977 /* 1978 * ":function func" with only function name: list function. 1979 */ 1980 if (!paren) 1981 { 1982 if (!ends_excmd(*skipwhite(p))) 1983 { 1984 EMSG(_(e_trailing)); 1985 goto ret_free; 1986 } 1987 eap->nextcmd = check_nextcmd(p); 1988 if (eap->nextcmd != NULL) 1989 *p = NUL; 1990 if (!eap->skip && !got_int) 1991 { 1992 fp = find_func(name); 1993 if (fp != NULL) 1994 { 1995 list_func_head(fp, TRUE); 1996 for (j = 0; j < fp->uf_lines.ga_len && !got_int; ++j) 1997 { 1998 if (FUNCLINE(fp, j) == NULL) 1999 continue; 2000 msg_putchar('\n'); 2001 msg_outnum((long)(j + 1)); 2002 if (j < 9) 2003 msg_putchar(' '); 2004 if (j < 99) 2005 msg_putchar(' '); 2006 msg_prt_line(FUNCLINE(fp, j), FALSE); 2007 out_flush(); /* show a line at a time */ 2008 ui_breakcheck(); 2009 } 2010 if (!got_int) 2011 { 2012 msg_putchar('\n'); 2013 msg_puts((char_u *)" endfunction"); 2014 } 2015 } 2016 else 2017 emsg_funcname(N_("E123: Undefined function: %s"), name); 2018 } 2019 goto ret_free; 2020 } 2021 2022 /* 2023 * ":function name(arg1, arg2)" Define function. 2024 */ 2025 p = skipwhite(p); 2026 if (*p != '(') 2027 { 2028 if (!eap->skip) 2029 { 2030 EMSG2(_("E124: Missing '(': %s"), eap->arg); 2031 goto ret_free; 2032 } 2033 /* attempt to continue by skipping some text */ 2034 if (vim_strchr(p, '(') != NULL) 2035 p = vim_strchr(p, '('); 2036 } 2037 p = skipwhite(p + 1); 2038 2039 ga_init2(&newlines, (int)sizeof(char_u *), 3); 2040 2041 if (!eap->skip) 2042 { 2043 /* Check the name of the function. Unless it's a dictionary function 2044 * (that we are overwriting). */ 2045 if (name != NULL) 2046 arg = name; 2047 else 2048 arg = fudi.fd_newkey; 2049 if (arg != NULL && (fudi.fd_di == NULL 2050 || (fudi.fd_di->di_tv.v_type != VAR_FUNC 2051 && fudi.fd_di->di_tv.v_type != VAR_PARTIAL))) 2052 { 2053 if (*arg == K_SPECIAL) 2054 j = 3; 2055 else 2056 j = 0; 2057 while (arg[j] != NUL && (j == 0 ? eval_isnamec1(arg[j]) 2058 : eval_isnamec(arg[j]))) 2059 ++j; 2060 if (arg[j] != NUL) 2061 emsg_funcname((char *)e_invarg2, arg); 2062 } 2063 /* Disallow using the g: dict. */ 2064 if (fudi.fd_dict != NULL && fudi.fd_dict->dv_scope == VAR_DEF_SCOPE) 2065 EMSG(_("E862: Cannot use g: here")); 2066 } 2067 2068 if (get_function_args(&p, ')', &newargs, &varargs, eap->skip) == FAIL) 2069 goto errret_2; 2070 2071 /* find extra arguments "range", "dict", "abort" and "closure" */ 2072 for (;;) 2073 { 2074 p = skipwhite(p); 2075 if (STRNCMP(p, "range", 5) == 0) 2076 { 2077 flags |= FC_RANGE; 2078 p += 5; 2079 } 2080 else if (STRNCMP(p, "dict", 4) == 0) 2081 { 2082 flags |= FC_DICT; 2083 p += 4; 2084 } 2085 else if (STRNCMP(p, "abort", 5) == 0) 2086 { 2087 flags |= FC_ABORT; 2088 p += 5; 2089 } 2090 else if (STRNCMP(p, "closure", 7) == 0) 2091 { 2092 flags |= FC_CLOSURE; 2093 p += 7; 2094 if (current_funccal == NULL) 2095 { 2096 emsg_funcname(N_("E932: Closure function should not be at top level: %s"), 2097 name == NULL ? (char_u *)"" : name); 2098 goto erret; 2099 } 2100 } 2101 else 2102 break; 2103 } 2104 2105 /* When there is a line break use what follows for the function body. 2106 * Makes 'exe "func Test()\n...\nendfunc"' work. */ 2107 if (*p == '\n') 2108 line_arg = p + 1; 2109 else if (*p != NUL && *p != '"' && !eap->skip && !did_emsg) 2110 EMSG(_(e_trailing)); 2111 2112 /* 2113 * Read the body of the function, until ":endfunction" is found. 2114 */ 2115 if (KeyTyped) 2116 { 2117 /* Check if the function already exists, don't let the user type the 2118 * whole function before telling him it doesn't work! For a script we 2119 * need to skip the body to be able to find what follows. */ 2120 if (!eap->skip && !eap->forceit) 2121 { 2122 if (fudi.fd_dict != NULL && fudi.fd_newkey == NULL) 2123 EMSG(_(e_funcdict)); 2124 else if (name != NULL && find_func(name) != NULL) 2125 emsg_funcname(e_funcexts, name); 2126 } 2127 2128 if (!eap->skip && did_emsg) 2129 goto erret; 2130 2131 msg_putchar('\n'); /* don't overwrite the function name */ 2132 cmdline_row = msg_row; 2133 } 2134 2135 indent = 2; 2136 nesting = 0; 2137 for (;;) 2138 { 2139 if (KeyTyped) 2140 { 2141 msg_scroll = TRUE; 2142 saved_wait_return = FALSE; 2143 } 2144 need_wait_return = FALSE; 2145 sourcing_lnum_off = sourcing_lnum; 2146 2147 if (line_arg != NULL) 2148 { 2149 /* Use eap->arg, split up in parts by line breaks. */ 2150 theline = line_arg; 2151 p = vim_strchr(theline, '\n'); 2152 if (p == NULL) 2153 line_arg += STRLEN(line_arg); 2154 else 2155 { 2156 *p = NUL; 2157 line_arg = p + 1; 2158 } 2159 } 2160 else 2161 { 2162 vim_free(line_to_free); 2163 if (eap->getline == NULL) 2164 theline = getcmdline(':', 0L, indent); 2165 else 2166 theline = eap->getline(':', eap->cookie, indent); 2167 line_to_free = theline; 2168 } 2169 if (KeyTyped) 2170 lines_left = Rows - 1; 2171 if (theline == NULL) 2172 { 2173 EMSG(_("E126: Missing :endfunction")); 2174 goto erret; 2175 } 2176 2177 /* Detect line continuation: sourcing_lnum increased more than one. */ 2178 if (sourcing_lnum > sourcing_lnum_off + 1) 2179 sourcing_lnum_off = sourcing_lnum - sourcing_lnum_off - 1; 2180 else 2181 sourcing_lnum_off = 0; 2182 2183 if (skip_until != NULL) 2184 { 2185 /* between ":append" and "." and between ":python <<EOF" and "EOF" 2186 * don't check for ":endfunc". */ 2187 if (STRCMP(theline, skip_until) == 0) 2188 VIM_CLEAR(skip_until); 2189 } 2190 else 2191 { 2192 /* skip ':' and blanks*/ 2193 for (p = theline; VIM_ISWHITE(*p) || *p == ':'; ++p) 2194 ; 2195 2196 /* Check for "endfunction". */ 2197 if (checkforcmd(&p, "endfunction", 4) && nesting-- == 0) 2198 { 2199 char_u *nextcmd = NULL; 2200 2201 if (*p == '|') 2202 nextcmd = p + 1; 2203 else if (line_arg != NULL && *skipwhite(line_arg) != NUL) 2204 nextcmd = line_arg; 2205 else if (*p != NUL && *p != '"' && p_verbose > 0) 2206 give_warning2( 2207 (char_u *)_("W22: Text found after :endfunction: %s"), 2208 p, TRUE); 2209 if (nextcmd != NULL) 2210 { 2211 /* Another command follows. If the line came from "eap" we 2212 * can simply point into it, otherwise we need to change 2213 * "eap->cmdlinep". */ 2214 eap->nextcmd = nextcmd; 2215 if (line_to_free != NULL) 2216 { 2217 vim_free(*eap->cmdlinep); 2218 *eap->cmdlinep = line_to_free; 2219 line_to_free = NULL; 2220 } 2221 } 2222 break; 2223 } 2224 2225 /* Increase indent inside "if", "while", "for" and "try", decrease 2226 * at "end". */ 2227 if (indent > 2 && STRNCMP(p, "end", 3) == 0) 2228 indent -= 2; 2229 else if (STRNCMP(p, "if", 2) == 0 2230 || STRNCMP(p, "wh", 2) == 0 2231 || STRNCMP(p, "for", 3) == 0 2232 || STRNCMP(p, "try", 3) == 0) 2233 indent += 2; 2234 2235 /* Check for defining a function inside this function. */ 2236 if (checkforcmd(&p, "function", 2)) 2237 { 2238 if (*p == '!') 2239 p = skipwhite(p + 1); 2240 p += eval_fname_script(p); 2241 vim_free(trans_function_name(&p, TRUE, 0, NULL, NULL)); 2242 if (*skipwhite(p) == '(') 2243 { 2244 ++nesting; 2245 indent += 2; 2246 } 2247 } 2248 2249 /* Check for ":append", ":change", ":insert". */ 2250 p = skip_range(p, NULL); 2251 if ((p[0] == 'a' && (!ASCII_ISALPHA(p[1]) || p[1] == 'p')) 2252 || (p[0] == 'c' 2253 && (!ASCII_ISALPHA(p[1]) || (p[1] == 'h' 2254 && (!ASCII_ISALPHA(p[2]) || (p[2] == 'a' 2255 && (STRNCMP(&p[3], "nge", 3) != 0 2256 || !ASCII_ISALPHA(p[6]))))))) 2257 || (p[0] == 'i' 2258 && (!ASCII_ISALPHA(p[1]) || (p[1] == 'n' 2259 && (!ASCII_ISALPHA(p[2]) || (p[2] == 's')))))) 2260 skip_until = vim_strsave((char_u *)"."); 2261 2262 /* Check for ":python <<EOF", ":tcl <<EOF", etc. */ 2263 arg = skipwhite(skiptowhite(p)); 2264 if (arg[0] == '<' && arg[1] =='<' 2265 && ((p[0] == 'p' && p[1] == 'y' 2266 && (!ASCII_ISALNUM(p[2]) || p[2] == 't' 2267 || ((p[2] == '3' || p[2] == 'x') 2268 && !ASCII_ISALPHA(p[3])))) 2269 || (p[0] == 'p' && p[1] == 'e' 2270 && (!ASCII_ISALPHA(p[2]) || p[2] == 'r')) 2271 || (p[0] == 't' && p[1] == 'c' 2272 && (!ASCII_ISALPHA(p[2]) || p[2] == 'l')) 2273 || (p[0] == 'l' && p[1] == 'u' && p[2] == 'a' 2274 && !ASCII_ISALPHA(p[3])) 2275 || (p[0] == 'r' && p[1] == 'u' && p[2] == 'b' 2276 && (!ASCII_ISALPHA(p[3]) || p[3] == 'y')) 2277 || (p[0] == 'm' && p[1] == 'z' 2278 && (!ASCII_ISALPHA(p[2]) || p[2] == 's')) 2279 )) 2280 { 2281 /* ":python <<" continues until a dot, like ":append" */ 2282 p = skipwhite(arg + 2); 2283 if (*p == NUL) 2284 skip_until = vim_strsave((char_u *)"."); 2285 else 2286 skip_until = vim_strsave(p); 2287 } 2288 } 2289 2290 /* Add the line to the function. */ 2291 if (ga_grow(&newlines, 1 + sourcing_lnum_off) == FAIL) 2292 goto erret; 2293 2294 /* Copy the line to newly allocated memory. get_one_sourceline() 2295 * allocates 250 bytes per line, this saves 80% on average. The cost 2296 * is an extra alloc/free. */ 2297 p = vim_strsave(theline); 2298 if (p == NULL) 2299 goto erret; 2300 ((char_u **)(newlines.ga_data))[newlines.ga_len++] = p; 2301 2302 /* Add NULL lines for continuation lines, so that the line count is 2303 * equal to the index in the growarray. */ 2304 while (sourcing_lnum_off-- > 0) 2305 ((char_u **)(newlines.ga_data))[newlines.ga_len++] = NULL; 2306 2307 /* Check for end of eap->arg. */ 2308 if (line_arg != NULL && *line_arg == NUL) 2309 line_arg = NULL; 2310 } 2311 2312 /* Don't define the function when skipping commands or when an error was 2313 * detected. */ 2314 if (eap->skip || did_emsg) 2315 goto erret; 2316 2317 /* 2318 * If there are no errors, add the function 2319 */ 2320 if (fudi.fd_dict == NULL) 2321 { 2322 v = find_var(name, &ht, FALSE); 2323 if (v != NULL && v->di_tv.v_type == VAR_FUNC) 2324 { 2325 emsg_funcname(N_("E707: Function name conflicts with variable: %s"), 2326 name); 2327 goto erret; 2328 } 2329 2330 fp = find_func(name); 2331 if (fp != NULL) 2332 { 2333 // Function can be replaced with "function!" and when sourcing the 2334 // same script again, but only once. 2335 if (!eap->forceit 2336 && (fp->uf_script_ctx.sc_sid != current_sctx.sc_sid 2337 || fp->uf_script_ctx.sc_seq == current_sctx.sc_seq)) 2338 { 2339 emsg_funcname(e_funcexts, name); 2340 goto erret; 2341 } 2342 if (fp->uf_calls > 0) 2343 { 2344 emsg_funcname( 2345 N_("E127: Cannot redefine function %s: It is in use"), 2346 name); 2347 goto erret; 2348 } 2349 if (fp->uf_refcount > 1) 2350 { 2351 /* This function is referenced somewhere, don't redefine it but 2352 * create a new one. */ 2353 --fp->uf_refcount; 2354 fp->uf_flags |= FC_REMOVED; 2355 fp = NULL; 2356 overwrite = TRUE; 2357 } 2358 else 2359 { 2360 /* redefine existing function */ 2361 VIM_CLEAR(name); 2362 func_clear_items(fp); 2363 #ifdef FEAT_PROFILE 2364 fp->uf_profiling = FALSE; 2365 fp->uf_prof_initialized = FALSE; 2366 #endif 2367 } 2368 } 2369 } 2370 else 2371 { 2372 char numbuf[20]; 2373 2374 fp = NULL; 2375 if (fudi.fd_newkey == NULL && !eap->forceit) 2376 { 2377 EMSG(_(e_funcdict)); 2378 goto erret; 2379 } 2380 if (fudi.fd_di == NULL) 2381 { 2382 /* Can't add a function to a locked dictionary */ 2383 if (tv_check_lock(fudi.fd_dict->dv_lock, eap->arg, FALSE)) 2384 goto erret; 2385 } 2386 /* Can't change an existing function if it is locked */ 2387 else if (tv_check_lock(fudi.fd_di->di_tv.v_lock, eap->arg, FALSE)) 2388 goto erret; 2389 2390 /* Give the function a sequential number. Can only be used with a 2391 * Funcref! */ 2392 vim_free(name); 2393 sprintf(numbuf, "%d", ++func_nr); 2394 name = vim_strsave((char_u *)numbuf); 2395 if (name == NULL) 2396 goto erret; 2397 } 2398 2399 if (fp == NULL) 2400 { 2401 if (fudi.fd_dict == NULL && vim_strchr(name, AUTOLOAD_CHAR) != NULL) 2402 { 2403 int slen, plen; 2404 char_u *scriptname; 2405 2406 /* Check that the autoload name matches the script name. */ 2407 j = FAIL; 2408 if (sourcing_name != NULL) 2409 { 2410 scriptname = autoload_name(name); 2411 if (scriptname != NULL) 2412 { 2413 p = vim_strchr(scriptname, '/'); 2414 plen = (int)STRLEN(p); 2415 slen = (int)STRLEN(sourcing_name); 2416 if (slen > plen && fnamecmp(p, 2417 sourcing_name + slen - plen) == 0) 2418 j = OK; 2419 vim_free(scriptname); 2420 } 2421 } 2422 if (j == FAIL) 2423 { 2424 EMSG2(_("E746: Function name does not match script file name: %s"), name); 2425 goto erret; 2426 } 2427 } 2428 2429 fp = (ufunc_T *)alloc_clear((unsigned)(sizeof(ufunc_T) + STRLEN(name))); 2430 if (fp == NULL) 2431 goto erret; 2432 2433 if (fudi.fd_dict != NULL) 2434 { 2435 if (fudi.fd_di == NULL) 2436 { 2437 /* add new dict entry */ 2438 fudi.fd_di = dictitem_alloc(fudi.fd_newkey); 2439 if (fudi.fd_di == NULL) 2440 { 2441 vim_free(fp); 2442 goto erret; 2443 } 2444 if (dict_add(fudi.fd_dict, fudi.fd_di) == FAIL) 2445 { 2446 vim_free(fudi.fd_di); 2447 vim_free(fp); 2448 goto erret; 2449 } 2450 } 2451 else 2452 /* overwrite existing dict entry */ 2453 clear_tv(&fudi.fd_di->di_tv); 2454 fudi.fd_di->di_tv.v_type = VAR_FUNC; 2455 fudi.fd_di->di_tv.vval.v_string = vim_strsave(name); 2456 2457 /* behave like "dict" was used */ 2458 flags |= FC_DICT; 2459 } 2460 2461 /* insert the new function in the function list */ 2462 STRCPY(fp->uf_name, name); 2463 if (overwrite) 2464 { 2465 hi = hash_find(&func_hashtab, name); 2466 hi->hi_key = UF2HIKEY(fp); 2467 } 2468 else if (hash_add(&func_hashtab, UF2HIKEY(fp)) == FAIL) 2469 { 2470 vim_free(fp); 2471 goto erret; 2472 } 2473 fp->uf_refcount = 1; 2474 } 2475 fp->uf_args = newargs; 2476 fp->uf_lines = newlines; 2477 if ((flags & FC_CLOSURE) != 0) 2478 { 2479 if (register_closure(fp) == FAIL) 2480 goto erret; 2481 } 2482 else 2483 fp->uf_scoped = NULL; 2484 2485 #ifdef FEAT_PROFILE 2486 if (prof_def_func()) 2487 func_do_profile(fp); 2488 #endif 2489 fp->uf_varargs = varargs; 2490 if (sandbox) 2491 flags |= FC_SANDBOX; 2492 fp->uf_flags = flags; 2493 fp->uf_calls = 0; 2494 fp->uf_script_ctx = current_sctx; 2495 fp->uf_script_ctx.sc_lnum += sourcing_lnum - newlines.ga_len - 1; 2496 goto ret_free; 2497 2498 erret: 2499 ga_clear_strings(&newargs); 2500 errret_2: 2501 ga_clear_strings(&newlines); 2502 ret_free: 2503 vim_free(skip_until); 2504 vim_free(line_to_free); 2505 vim_free(fudi.fd_newkey); 2506 vim_free(name); 2507 did_emsg |= saved_did_emsg; 2508 need_wait_return |= saved_wait_return; 2509 } 2510 2511 /* 2512 * Return 5 if "p" starts with "<SID>" or "<SNR>" (ignoring case). 2513 * Return 2 if "p" starts with "s:". 2514 * Return 0 otherwise. 2515 */ 2516 int 2517 eval_fname_script(char_u *p) 2518 { 2519 /* Use MB_STRICMP() because in Turkish comparing the "I" may not work with 2520 * the standard library function. */ 2521 if (p[0] == '<' && (MB_STRNICMP(p + 1, "SID>", 4) == 0 2522 || MB_STRNICMP(p + 1, "SNR>", 4) == 0)) 2523 return 5; 2524 if (p[0] == 's' && p[1] == ':') 2525 return 2; 2526 return 0; 2527 } 2528 2529 int 2530 translated_function_exists(char_u *name) 2531 { 2532 if (builtin_function(name, -1)) 2533 return find_internal_func(name) >= 0; 2534 return find_func(name) != NULL; 2535 } 2536 2537 /* 2538 * Return TRUE if a function "name" exists. 2539 * If "no_defef" is TRUE, do not dereference a Funcref. 2540 */ 2541 int 2542 function_exists(char_u *name, int no_deref) 2543 { 2544 char_u *nm = name; 2545 char_u *p; 2546 int n = FALSE; 2547 int flag; 2548 2549 flag = TFN_INT | TFN_QUIET | TFN_NO_AUTOLOAD; 2550 if (no_deref) 2551 flag |= TFN_NO_DEREF; 2552 p = trans_function_name(&nm, FALSE, flag, NULL, NULL); 2553 nm = skipwhite(nm); 2554 2555 /* Only accept "funcname", "funcname ", "funcname (..." and 2556 * "funcname(...", not "funcname!...". */ 2557 if (p != NULL && (*nm == NUL || *nm == '(')) 2558 n = translated_function_exists(p); 2559 vim_free(p); 2560 return n; 2561 } 2562 2563 char_u * 2564 get_expanded_name(char_u *name, int check) 2565 { 2566 char_u *nm = name; 2567 char_u *p; 2568 2569 p = trans_function_name(&nm, FALSE, TFN_INT|TFN_QUIET, NULL, NULL); 2570 2571 if (p != NULL && *nm == NUL) 2572 if (!check || translated_function_exists(p)) 2573 return p; 2574 2575 vim_free(p); 2576 return NULL; 2577 } 2578 2579 #if defined(FEAT_PROFILE) || defined(PROTO) 2580 /* 2581 * Start profiling function "fp". 2582 */ 2583 static void 2584 func_do_profile(ufunc_T *fp) 2585 { 2586 int len = fp->uf_lines.ga_len; 2587 2588 if (!fp->uf_prof_initialized) 2589 { 2590 if (len == 0) 2591 len = 1; /* avoid getting error for allocating zero bytes */ 2592 fp->uf_tm_count = 0; 2593 profile_zero(&fp->uf_tm_self); 2594 profile_zero(&fp->uf_tm_total); 2595 if (fp->uf_tml_count == NULL) 2596 fp->uf_tml_count = (int *)alloc_clear( 2597 (unsigned)(sizeof(int) * len)); 2598 if (fp->uf_tml_total == NULL) 2599 fp->uf_tml_total = (proftime_T *)alloc_clear( 2600 (unsigned)(sizeof(proftime_T) * len)); 2601 if (fp->uf_tml_self == NULL) 2602 fp->uf_tml_self = (proftime_T *)alloc_clear( 2603 (unsigned)(sizeof(proftime_T) * len)); 2604 fp->uf_tml_idx = -1; 2605 if (fp->uf_tml_count == NULL || fp->uf_tml_total == NULL 2606 || fp->uf_tml_self == NULL) 2607 return; /* out of memory */ 2608 fp->uf_prof_initialized = TRUE; 2609 } 2610 2611 fp->uf_profiling = TRUE; 2612 } 2613 2614 /* 2615 * Dump the profiling results for all functions in file "fd". 2616 */ 2617 void 2618 func_dump_profile(FILE *fd) 2619 { 2620 hashitem_T *hi; 2621 int todo; 2622 ufunc_T *fp; 2623 int i; 2624 ufunc_T **sorttab; 2625 int st_len = 0; 2626 char_u *p; 2627 2628 todo = (int)func_hashtab.ht_used; 2629 if (todo == 0) 2630 return; /* nothing to dump */ 2631 2632 sorttab = (ufunc_T **)alloc((unsigned)(sizeof(ufunc_T *) * todo)); 2633 2634 for (hi = func_hashtab.ht_array; todo > 0; ++hi) 2635 { 2636 if (!HASHITEM_EMPTY(hi)) 2637 { 2638 --todo; 2639 fp = HI2UF(hi); 2640 if (fp->uf_prof_initialized) 2641 { 2642 if (sorttab != NULL) 2643 sorttab[st_len++] = fp; 2644 2645 if (fp->uf_name[0] == K_SPECIAL) 2646 fprintf(fd, "FUNCTION <SNR>%s()\n", fp->uf_name + 3); 2647 else 2648 fprintf(fd, "FUNCTION %s()\n", fp->uf_name); 2649 p = home_replace_save(NULL, 2650 get_scriptname(fp->uf_script_ctx.sc_sid)); 2651 if (p != NULL) 2652 { 2653 fprintf(fd, " Defined: %s line %ld\n", 2654 p, (long)fp->uf_script_ctx.sc_lnum); 2655 vim_free(p); 2656 } 2657 if (fp->uf_tm_count == 1) 2658 fprintf(fd, "Called 1 time\n"); 2659 else 2660 fprintf(fd, "Called %d times\n", fp->uf_tm_count); 2661 fprintf(fd, "Total time: %s\n", profile_msg(&fp->uf_tm_total)); 2662 fprintf(fd, " Self time: %s\n", profile_msg(&fp->uf_tm_self)); 2663 fprintf(fd, "\n"); 2664 fprintf(fd, "count total (s) self (s)\n"); 2665 2666 for (i = 0; i < fp->uf_lines.ga_len; ++i) 2667 { 2668 if (FUNCLINE(fp, i) == NULL) 2669 continue; 2670 prof_func_line(fd, fp->uf_tml_count[i], 2671 &fp->uf_tml_total[i], &fp->uf_tml_self[i], TRUE); 2672 fprintf(fd, "%s\n", FUNCLINE(fp, i)); 2673 } 2674 fprintf(fd, "\n"); 2675 } 2676 } 2677 } 2678 2679 if (sorttab != NULL && st_len > 0) 2680 { 2681 qsort((void *)sorttab, (size_t)st_len, sizeof(ufunc_T *), 2682 prof_total_cmp); 2683 prof_sort_list(fd, sorttab, st_len, "TOTAL", FALSE); 2684 qsort((void *)sorttab, (size_t)st_len, sizeof(ufunc_T *), 2685 prof_self_cmp); 2686 prof_sort_list(fd, sorttab, st_len, "SELF", TRUE); 2687 } 2688 2689 vim_free(sorttab); 2690 } 2691 2692 static void 2693 prof_sort_list( 2694 FILE *fd, 2695 ufunc_T **sorttab, 2696 int st_len, 2697 char *title, 2698 int prefer_self) /* when equal print only self time */ 2699 { 2700 int i; 2701 ufunc_T *fp; 2702 2703 fprintf(fd, "FUNCTIONS SORTED ON %s TIME\n", title); 2704 fprintf(fd, "count total (s) self (s) function\n"); 2705 for (i = 0; i < 20 && i < st_len; ++i) 2706 { 2707 fp = sorttab[i]; 2708 prof_func_line(fd, fp->uf_tm_count, &fp->uf_tm_total, &fp->uf_tm_self, 2709 prefer_self); 2710 if (fp->uf_name[0] == K_SPECIAL) 2711 fprintf(fd, " <SNR>%s()\n", fp->uf_name + 3); 2712 else 2713 fprintf(fd, " %s()\n", fp->uf_name); 2714 } 2715 fprintf(fd, "\n"); 2716 } 2717 2718 /* 2719 * Print the count and times for one function or function line. 2720 */ 2721 static void 2722 prof_func_line( 2723 FILE *fd, 2724 int count, 2725 proftime_T *total, 2726 proftime_T *self, 2727 int prefer_self) /* when equal print only self time */ 2728 { 2729 if (count > 0) 2730 { 2731 fprintf(fd, "%5d ", count); 2732 if (prefer_self && profile_equal(total, self)) 2733 fprintf(fd, " "); 2734 else 2735 fprintf(fd, "%s ", profile_msg(total)); 2736 if (!prefer_self && profile_equal(total, self)) 2737 fprintf(fd, " "); 2738 else 2739 fprintf(fd, "%s ", profile_msg(self)); 2740 } 2741 else 2742 fprintf(fd, " "); 2743 } 2744 2745 /* 2746 * Compare function for total time sorting. 2747 */ 2748 static int 2749 #ifdef __BORLANDC__ 2750 _RTLENTRYF 2751 #endif 2752 prof_total_cmp(const void *s1, const void *s2) 2753 { 2754 ufunc_T *p1, *p2; 2755 2756 p1 = *(ufunc_T **)s1; 2757 p2 = *(ufunc_T **)s2; 2758 return profile_cmp(&p1->uf_tm_total, &p2->uf_tm_total); 2759 } 2760 2761 /* 2762 * Compare function for self time sorting. 2763 */ 2764 static int 2765 #ifdef __BORLANDC__ 2766 _RTLENTRYF 2767 #endif 2768 prof_self_cmp(const void *s1, const void *s2) 2769 { 2770 ufunc_T *p1, *p2; 2771 2772 p1 = *(ufunc_T **)s1; 2773 p2 = *(ufunc_T **)s2; 2774 return profile_cmp(&p1->uf_tm_self, &p2->uf_tm_self); 2775 } 2776 2777 /* 2778 * Prepare profiling for entering a child or something else that is not 2779 * counted for the script/function itself. 2780 * Should always be called in pair with prof_child_exit(). 2781 */ 2782 void 2783 prof_child_enter( 2784 proftime_T *tm) /* place to store waittime */ 2785 { 2786 funccall_T *fc = current_funccal; 2787 2788 if (fc != NULL && fc->func->uf_profiling) 2789 profile_start(&fc->prof_child); 2790 script_prof_save(tm); 2791 } 2792 2793 /* 2794 * Take care of time spent in a child. 2795 * Should always be called after prof_child_enter(). 2796 */ 2797 void 2798 prof_child_exit( 2799 proftime_T *tm) /* where waittime was stored */ 2800 { 2801 funccall_T *fc = current_funccal; 2802 2803 if (fc != NULL && fc->func->uf_profiling) 2804 { 2805 profile_end(&fc->prof_child); 2806 profile_sub_wait(tm, &fc->prof_child); /* don't count waiting time */ 2807 profile_add(&fc->func->uf_tm_children, &fc->prof_child); 2808 profile_add(&fc->func->uf_tml_children, &fc->prof_child); 2809 } 2810 script_prof_restore(tm); 2811 } 2812 2813 #endif /* FEAT_PROFILE */ 2814 2815 #if defined(FEAT_CMDL_COMPL) || defined(PROTO) 2816 2817 /* 2818 * Function given to ExpandGeneric() to obtain the list of user defined 2819 * function names. 2820 */ 2821 char_u * 2822 get_user_func_name(expand_T *xp, int idx) 2823 { 2824 static long_u done; 2825 static hashitem_T *hi; 2826 ufunc_T *fp; 2827 2828 if (idx == 0) 2829 { 2830 done = 0; 2831 hi = func_hashtab.ht_array; 2832 } 2833 if (done < func_hashtab.ht_used) 2834 { 2835 if (done++ > 0) 2836 ++hi; 2837 while (HASHITEM_EMPTY(hi)) 2838 ++hi; 2839 fp = HI2UF(hi); 2840 2841 if ((fp->uf_flags & FC_DICT) 2842 || STRNCMP(fp->uf_name, "<lambda>", 8) == 0) 2843 return (char_u *)""; /* don't show dict and lambda functions */ 2844 2845 if (STRLEN(fp->uf_name) + 4 >= IOSIZE) 2846 return fp->uf_name; /* prevents overflow */ 2847 2848 cat_func_name(IObuff, fp); 2849 if (xp->xp_context != EXPAND_USER_FUNC) 2850 { 2851 STRCAT(IObuff, "("); 2852 if (!fp->uf_varargs && fp->uf_args.ga_len == 0) 2853 STRCAT(IObuff, ")"); 2854 } 2855 return IObuff; 2856 } 2857 return NULL; 2858 } 2859 2860 #endif /* FEAT_CMDL_COMPL */ 2861 2862 /* 2863 * ":delfunction {name}" 2864 */ 2865 void 2866 ex_delfunction(exarg_T *eap) 2867 { 2868 ufunc_T *fp = NULL; 2869 char_u *p; 2870 char_u *name; 2871 funcdict_T fudi; 2872 2873 p = eap->arg; 2874 name = trans_function_name(&p, eap->skip, 0, &fudi, NULL); 2875 vim_free(fudi.fd_newkey); 2876 if (name == NULL) 2877 { 2878 if (fudi.fd_dict != NULL && !eap->skip) 2879 EMSG(_(e_funcref)); 2880 return; 2881 } 2882 if (!ends_excmd(*skipwhite(p))) 2883 { 2884 vim_free(name); 2885 EMSG(_(e_trailing)); 2886 return; 2887 } 2888 eap->nextcmd = check_nextcmd(p); 2889 if (eap->nextcmd != NULL) 2890 *p = NUL; 2891 2892 if (!eap->skip) 2893 fp = find_func(name); 2894 vim_free(name); 2895 2896 if (!eap->skip) 2897 { 2898 if (fp == NULL) 2899 { 2900 if (!eap->forceit) 2901 EMSG2(_(e_nofunc), eap->arg); 2902 return; 2903 } 2904 if (fp->uf_calls > 0) 2905 { 2906 EMSG2(_("E131: Cannot delete function %s: It is in use"), eap->arg); 2907 return; 2908 } 2909 2910 if (fudi.fd_dict != NULL) 2911 { 2912 /* Delete the dict item that refers to the function, it will 2913 * invoke func_unref() and possibly delete the function. */ 2914 dictitem_remove(fudi.fd_dict, fudi.fd_di); 2915 } 2916 else 2917 { 2918 /* A normal function (not a numbered function or lambda) has a 2919 * refcount of 1 for the entry in the hashtable. When deleting 2920 * it and the refcount is more than one, it should be kept. 2921 * A numbered function and lambda should be kept if the refcount is 2922 * one or more. */ 2923 if (fp->uf_refcount > (func_name_refcount(fp->uf_name) ? 0 : 1)) 2924 { 2925 /* Function is still referenced somewhere. Don't free it but 2926 * do remove it from the hashtable. */ 2927 if (func_remove(fp)) 2928 fp->uf_refcount--; 2929 fp->uf_flags |= FC_DELETED; 2930 } 2931 else 2932 func_clear_free(fp, FALSE); 2933 } 2934 } 2935 } 2936 2937 /* 2938 * Unreference a Function: decrement the reference count and free it when it 2939 * becomes zero. 2940 */ 2941 void 2942 func_unref(char_u *name) 2943 { 2944 ufunc_T *fp = NULL; 2945 2946 if (name == NULL || !func_name_refcount(name)) 2947 return; 2948 fp = find_func(name); 2949 if (fp == NULL && isdigit(*name)) 2950 { 2951 #ifdef EXITFREE 2952 if (!entered_free_all_mem) 2953 #endif 2954 internal_error("func_unref()"); 2955 } 2956 if (fp != NULL && --fp->uf_refcount <= 0) 2957 { 2958 /* Only delete it when it's not being used. Otherwise it's done 2959 * when "uf_calls" becomes zero. */ 2960 if (fp->uf_calls == 0) 2961 func_clear_free(fp, FALSE); 2962 } 2963 } 2964 2965 /* 2966 * Unreference a Function: decrement the reference count and free it when it 2967 * becomes zero. 2968 */ 2969 void 2970 func_ptr_unref(ufunc_T *fp) 2971 { 2972 if (fp != NULL && --fp->uf_refcount <= 0) 2973 { 2974 /* Only delete it when it's not being used. Otherwise it's done 2975 * when "uf_calls" becomes zero. */ 2976 if (fp->uf_calls == 0) 2977 func_clear_free(fp, FALSE); 2978 } 2979 } 2980 2981 /* 2982 * Count a reference to a Function. 2983 */ 2984 void 2985 func_ref(char_u *name) 2986 { 2987 ufunc_T *fp; 2988 2989 if (name == NULL || !func_name_refcount(name)) 2990 return; 2991 fp = find_func(name); 2992 if (fp != NULL) 2993 ++fp->uf_refcount; 2994 else if (isdigit(*name)) 2995 /* Only give an error for a numbered function. 2996 * Fail silently, when named or lambda function isn't found. */ 2997 internal_error("func_ref()"); 2998 } 2999 3000 /* 3001 * Count a reference to a Function. 3002 */ 3003 void 3004 func_ptr_ref(ufunc_T *fp) 3005 { 3006 if (fp != NULL) 3007 ++fp->uf_refcount; 3008 } 3009 3010 /* 3011 * Return TRUE if items in "fc" do not have "copyID". That means they are not 3012 * referenced from anywhere that is in use. 3013 */ 3014 static int 3015 can_free_funccal(funccall_T *fc, int copyID) 3016 { 3017 return (fc->l_varlist.lv_copyID != copyID 3018 && fc->l_vars.dv_copyID != copyID 3019 && fc->l_avars.dv_copyID != copyID 3020 && fc->fc_copyID != copyID); 3021 } 3022 3023 /* 3024 * ":return [expr]" 3025 */ 3026 void 3027 ex_return(exarg_T *eap) 3028 { 3029 char_u *arg = eap->arg; 3030 typval_T rettv; 3031 int returning = FALSE; 3032 3033 if (current_funccal == NULL) 3034 { 3035 EMSG(_("E133: :return not inside a function")); 3036 return; 3037 } 3038 3039 if (eap->skip) 3040 ++emsg_skip; 3041 3042 eap->nextcmd = NULL; 3043 if ((*arg != NUL && *arg != '|' && *arg != '\n') 3044 && eval0(arg, &rettv, &eap->nextcmd, !eap->skip) != FAIL) 3045 { 3046 if (!eap->skip) 3047 returning = do_return(eap, FALSE, TRUE, &rettv); 3048 else 3049 clear_tv(&rettv); 3050 } 3051 /* It's safer to return also on error. */ 3052 else if (!eap->skip) 3053 { 3054 /* In return statement, cause_abort should be force_abort. */ 3055 update_force_abort(); 3056 3057 /* 3058 * Return unless the expression evaluation has been cancelled due to an 3059 * aborting error, an interrupt, or an exception. 3060 */ 3061 if (!aborting()) 3062 returning = do_return(eap, FALSE, TRUE, NULL); 3063 } 3064 3065 /* When skipping or the return gets pending, advance to the next command 3066 * in this line (!returning). Otherwise, ignore the rest of the line. 3067 * Following lines will be ignored by get_func_line(). */ 3068 if (returning) 3069 eap->nextcmd = NULL; 3070 else if (eap->nextcmd == NULL) /* no argument */ 3071 eap->nextcmd = check_nextcmd(arg); 3072 3073 if (eap->skip) 3074 --emsg_skip; 3075 } 3076 3077 /* 3078 * ":1,25call func(arg1, arg2)" function call. 3079 */ 3080 void 3081 ex_call(exarg_T *eap) 3082 { 3083 char_u *arg = eap->arg; 3084 char_u *startarg; 3085 char_u *name; 3086 char_u *tofree; 3087 int len; 3088 typval_T rettv; 3089 linenr_T lnum; 3090 int doesrange; 3091 int failed = FALSE; 3092 funcdict_T fudi; 3093 partial_T *partial = NULL; 3094 3095 if (eap->skip) 3096 { 3097 /* trans_function_name() doesn't work well when skipping, use eval0() 3098 * instead to skip to any following command, e.g. for: 3099 * :if 0 | call dict.foo().bar() | endif */ 3100 ++emsg_skip; 3101 if (eval0(eap->arg, &rettv, &eap->nextcmd, FALSE) != FAIL) 3102 clear_tv(&rettv); 3103 --emsg_skip; 3104 return; 3105 } 3106 3107 tofree = trans_function_name(&arg, eap->skip, TFN_INT, &fudi, &partial); 3108 if (fudi.fd_newkey != NULL) 3109 { 3110 /* Still need to give an error message for missing key. */ 3111 EMSG2(_(e_dictkey), fudi.fd_newkey); 3112 vim_free(fudi.fd_newkey); 3113 } 3114 if (tofree == NULL) 3115 return; 3116 3117 /* Increase refcount on dictionary, it could get deleted when evaluating 3118 * the arguments. */ 3119 if (fudi.fd_dict != NULL) 3120 ++fudi.fd_dict->dv_refcount; 3121 3122 /* If it is the name of a variable of type VAR_FUNC or VAR_PARTIAL use its 3123 * contents. For VAR_PARTIAL get its partial, unless we already have one 3124 * from trans_function_name(). */ 3125 len = (int)STRLEN(tofree); 3126 name = deref_func_name(tofree, &len, 3127 partial != NULL ? NULL : &partial, FALSE); 3128 3129 /* Skip white space to allow ":call func ()". Not good, but required for 3130 * backward compatibility. */ 3131 startarg = skipwhite(arg); 3132 rettv.v_type = VAR_UNKNOWN; /* clear_tv() uses this */ 3133 3134 if (*startarg != '(') 3135 { 3136 EMSG2(_("E107: Missing parentheses: %s"), eap->arg); 3137 goto end; 3138 } 3139 3140 /* 3141 * When skipping, evaluate the function once, to find the end of the 3142 * arguments. 3143 * When the function takes a range, this is discovered after the first 3144 * call, and the loop is broken. 3145 */ 3146 if (eap->skip) 3147 { 3148 ++emsg_skip; 3149 lnum = eap->line2; /* do it once, also with an invalid range */ 3150 } 3151 else 3152 lnum = eap->line1; 3153 for ( ; lnum <= eap->line2; ++lnum) 3154 { 3155 if (!eap->skip && eap->addr_count > 0) 3156 { 3157 if (lnum > curbuf->b_ml.ml_line_count) 3158 { 3159 // If the function deleted lines or switched to another buffer 3160 // the line number may become invalid. 3161 EMSG(_(e_invrange)); 3162 break; 3163 } 3164 curwin->w_cursor.lnum = lnum; 3165 curwin->w_cursor.col = 0; 3166 #ifdef FEAT_VIRTUALEDIT 3167 curwin->w_cursor.coladd = 0; 3168 #endif 3169 } 3170 arg = startarg; 3171 if (get_func_tv(name, (int)STRLEN(name), &rettv, &arg, 3172 eap->line1, eap->line2, &doesrange, 3173 !eap->skip, partial, fudi.fd_dict) == FAIL) 3174 { 3175 failed = TRUE; 3176 break; 3177 } 3178 if (has_watchexpr()) 3179 dbg_check_breakpoint(eap); 3180 3181 /* Handle a function returning a Funcref, Dictionary or List. */ 3182 if (handle_subscript(&arg, &rettv, !eap->skip, TRUE) == FAIL) 3183 { 3184 failed = TRUE; 3185 break; 3186 } 3187 3188 clear_tv(&rettv); 3189 if (doesrange || eap->skip) 3190 break; 3191 3192 /* Stop when immediately aborting on error, or when an interrupt 3193 * occurred or an exception was thrown but not caught. 3194 * get_func_tv() returned OK, so that the check for trailing 3195 * characters below is executed. */ 3196 if (aborting()) 3197 break; 3198 } 3199 if (eap->skip) 3200 --emsg_skip; 3201 3202 if (!failed) 3203 { 3204 /* Check for trailing illegal characters and a following command. */ 3205 if (!ends_excmd(*arg)) 3206 { 3207 emsg_severe = TRUE; 3208 EMSG(_(e_trailing)); 3209 } 3210 else 3211 eap->nextcmd = check_nextcmd(arg); 3212 } 3213 3214 end: 3215 dict_unref(fudi.fd_dict); 3216 vim_free(tofree); 3217 } 3218 3219 /* 3220 * Return from a function. Possibly makes the return pending. Also called 3221 * for a pending return at the ":endtry" or after returning from an extra 3222 * do_cmdline(). "reanimate" is used in the latter case. "is_cmd" is set 3223 * when called due to a ":return" command. "rettv" may point to a typval_T 3224 * with the return rettv. Returns TRUE when the return can be carried out, 3225 * FALSE when the return gets pending. 3226 */ 3227 int 3228 do_return( 3229 exarg_T *eap, 3230 int reanimate, 3231 int is_cmd, 3232 void *rettv) 3233 { 3234 int idx; 3235 struct condstack *cstack = eap->cstack; 3236 3237 if (reanimate) 3238 /* Undo the return. */ 3239 current_funccal->returned = FALSE; 3240 3241 /* 3242 * Cleanup (and inactivate) conditionals, but stop when a try conditional 3243 * not in its finally clause (which then is to be executed next) is found. 3244 * In this case, make the ":return" pending for execution at the ":endtry". 3245 * Otherwise, return normally. 3246 */ 3247 idx = cleanup_conditionals(eap->cstack, 0, TRUE); 3248 if (idx >= 0) 3249 { 3250 cstack->cs_pending[idx] = CSTP_RETURN; 3251 3252 if (!is_cmd && !reanimate) 3253 /* A pending return again gets pending. "rettv" points to an 3254 * allocated variable with the rettv of the original ":return"'s 3255 * argument if present or is NULL else. */ 3256 cstack->cs_rettv[idx] = rettv; 3257 else 3258 { 3259 /* When undoing a return in order to make it pending, get the stored 3260 * return rettv. */ 3261 if (reanimate) 3262 rettv = current_funccal->rettv; 3263 3264 if (rettv != NULL) 3265 { 3266 /* Store the value of the pending return. */ 3267 if ((cstack->cs_rettv[idx] = alloc_tv()) != NULL) 3268 *(typval_T *)cstack->cs_rettv[idx] = *(typval_T *)rettv; 3269 else 3270 EMSG(_(e_outofmem)); 3271 } 3272 else 3273 cstack->cs_rettv[idx] = NULL; 3274 3275 if (reanimate) 3276 { 3277 /* The pending return value could be overwritten by a ":return" 3278 * without argument in a finally clause; reset the default 3279 * return value. */ 3280 current_funccal->rettv->v_type = VAR_NUMBER; 3281 current_funccal->rettv->vval.v_number = 0; 3282 } 3283 } 3284 report_make_pending(CSTP_RETURN, rettv); 3285 } 3286 else 3287 { 3288 current_funccal->returned = TRUE; 3289 3290 /* If the return is carried out now, store the return value. For 3291 * a return immediately after reanimation, the value is already 3292 * there. */ 3293 if (!reanimate && rettv != NULL) 3294 { 3295 clear_tv(current_funccal->rettv); 3296 *current_funccal->rettv = *(typval_T *)rettv; 3297 if (!is_cmd) 3298 vim_free(rettv); 3299 } 3300 } 3301 3302 return idx < 0; 3303 } 3304 3305 /* 3306 * Free the variable with a pending return value. 3307 */ 3308 void 3309 discard_pending_return(void *rettv) 3310 { 3311 free_tv((typval_T *)rettv); 3312 } 3313 3314 /* 3315 * Generate a return command for producing the value of "rettv". The result 3316 * is an allocated string. Used by report_pending() for verbose messages. 3317 */ 3318 char_u * 3319 get_return_cmd(void *rettv) 3320 { 3321 char_u *s = NULL; 3322 char_u *tofree = NULL; 3323 char_u numbuf[NUMBUFLEN]; 3324 3325 if (rettv != NULL) 3326 s = echo_string((typval_T *)rettv, &tofree, numbuf, 0); 3327 if (s == NULL) 3328 s = (char_u *)""; 3329 3330 STRCPY(IObuff, ":return "); 3331 STRNCPY(IObuff + 8, s, IOSIZE - 8); 3332 if (STRLEN(s) + 8 >= IOSIZE) 3333 STRCPY(IObuff + IOSIZE - 4, "..."); 3334 vim_free(tofree); 3335 return vim_strsave(IObuff); 3336 } 3337 3338 /* 3339 * Get next function line. 3340 * Called by do_cmdline() to get the next line. 3341 * Returns allocated string, or NULL for end of function. 3342 */ 3343 char_u * 3344 get_func_line( 3345 int c UNUSED, 3346 void *cookie, 3347 int indent UNUSED) 3348 { 3349 funccall_T *fcp = (funccall_T *)cookie; 3350 ufunc_T *fp = fcp->func; 3351 char_u *retval; 3352 garray_T *gap; /* growarray with function lines */ 3353 3354 /* If breakpoints have been added/deleted need to check for it. */ 3355 if (fcp->dbg_tick != debug_tick) 3356 { 3357 fcp->breakpoint = dbg_find_breakpoint(FALSE, fp->uf_name, 3358 sourcing_lnum); 3359 fcp->dbg_tick = debug_tick; 3360 } 3361 #ifdef FEAT_PROFILE 3362 if (do_profiling == PROF_YES) 3363 func_line_end(cookie); 3364 #endif 3365 3366 gap = &fp->uf_lines; 3367 if (((fp->uf_flags & FC_ABORT) && did_emsg && !aborted_in_try()) 3368 || fcp->returned) 3369 retval = NULL; 3370 else 3371 { 3372 /* Skip NULL lines (continuation lines). */ 3373 while (fcp->linenr < gap->ga_len 3374 && ((char_u **)(gap->ga_data))[fcp->linenr] == NULL) 3375 ++fcp->linenr; 3376 if (fcp->linenr >= gap->ga_len) 3377 retval = NULL; 3378 else 3379 { 3380 retval = vim_strsave(((char_u **)(gap->ga_data))[fcp->linenr++]); 3381 sourcing_lnum = fcp->linenr; 3382 #ifdef FEAT_PROFILE 3383 if (do_profiling == PROF_YES) 3384 func_line_start(cookie); 3385 #endif 3386 } 3387 } 3388 3389 /* Did we encounter a breakpoint? */ 3390 if (fcp->breakpoint != 0 && fcp->breakpoint <= sourcing_lnum) 3391 { 3392 dbg_breakpoint(fp->uf_name, sourcing_lnum); 3393 /* Find next breakpoint. */ 3394 fcp->breakpoint = dbg_find_breakpoint(FALSE, fp->uf_name, 3395 sourcing_lnum); 3396 fcp->dbg_tick = debug_tick; 3397 } 3398 3399 return retval; 3400 } 3401 3402 #if defined(FEAT_PROFILE) || defined(PROTO) 3403 /* 3404 * Called when starting to read a function line. 3405 * "sourcing_lnum" must be correct! 3406 * When skipping lines it may not actually be executed, but we won't find out 3407 * until later and we need to store the time now. 3408 */ 3409 void 3410 func_line_start(void *cookie) 3411 { 3412 funccall_T *fcp = (funccall_T *)cookie; 3413 ufunc_T *fp = fcp->func; 3414 3415 if (fp->uf_profiling && sourcing_lnum >= 1 3416 && sourcing_lnum <= fp->uf_lines.ga_len) 3417 { 3418 fp->uf_tml_idx = sourcing_lnum - 1; 3419 /* Skip continuation lines. */ 3420 while (fp->uf_tml_idx > 0 && FUNCLINE(fp, fp->uf_tml_idx) == NULL) 3421 --fp->uf_tml_idx; 3422 fp->uf_tml_execed = FALSE; 3423 profile_start(&fp->uf_tml_start); 3424 profile_zero(&fp->uf_tml_children); 3425 profile_get_wait(&fp->uf_tml_wait); 3426 } 3427 } 3428 3429 /* 3430 * Called when actually executing a function line. 3431 */ 3432 void 3433 func_line_exec(void *cookie) 3434 { 3435 funccall_T *fcp = (funccall_T *)cookie; 3436 ufunc_T *fp = fcp->func; 3437 3438 if (fp->uf_profiling && fp->uf_tml_idx >= 0) 3439 fp->uf_tml_execed = TRUE; 3440 } 3441 3442 /* 3443 * Called when done with a function line. 3444 */ 3445 void 3446 func_line_end(void *cookie) 3447 { 3448 funccall_T *fcp = (funccall_T *)cookie; 3449 ufunc_T *fp = fcp->func; 3450 3451 if (fp->uf_profiling && fp->uf_tml_idx >= 0) 3452 { 3453 if (fp->uf_tml_execed) 3454 { 3455 ++fp->uf_tml_count[fp->uf_tml_idx]; 3456 profile_end(&fp->uf_tml_start); 3457 profile_sub_wait(&fp->uf_tml_wait, &fp->uf_tml_start); 3458 profile_add(&fp->uf_tml_total[fp->uf_tml_idx], &fp->uf_tml_start); 3459 profile_self(&fp->uf_tml_self[fp->uf_tml_idx], &fp->uf_tml_start, 3460 &fp->uf_tml_children); 3461 } 3462 fp->uf_tml_idx = -1; 3463 } 3464 } 3465 #endif 3466 3467 /* 3468 * Return TRUE if the currently active function should be ended, because a 3469 * return was encountered or an error occurred. Used inside a ":while". 3470 */ 3471 int 3472 func_has_ended(void *cookie) 3473 { 3474 funccall_T *fcp = (funccall_T *)cookie; 3475 3476 /* Ignore the "abort" flag if the abortion behavior has been changed due to 3477 * an error inside a try conditional. */ 3478 return (((fcp->func->uf_flags & FC_ABORT) && did_emsg && !aborted_in_try()) 3479 || fcp->returned); 3480 } 3481 3482 /* 3483 * return TRUE if cookie indicates a function which "abort"s on errors. 3484 */ 3485 int 3486 func_has_abort( 3487 void *cookie) 3488 { 3489 return ((funccall_T *)cookie)->func->uf_flags & FC_ABORT; 3490 } 3491 3492 3493 /* 3494 * Turn "dict.Func" into a partial for "Func" bound to "dict". 3495 * Don't do this when "Func" is already a partial that was bound 3496 * explicitly (pt_auto is FALSE). 3497 * Changes "rettv" in-place. 3498 * Returns the updated "selfdict_in". 3499 */ 3500 dict_T * 3501 make_partial(dict_T *selfdict_in, typval_T *rettv) 3502 { 3503 char_u *fname; 3504 char_u *tofree = NULL; 3505 ufunc_T *fp; 3506 char_u fname_buf[FLEN_FIXED + 1]; 3507 int error; 3508 dict_T *selfdict = selfdict_in; 3509 3510 if (rettv->v_type == VAR_PARTIAL && rettv->vval.v_partial->pt_func != NULL) 3511 fp = rettv->vval.v_partial->pt_func; 3512 else 3513 { 3514 fname = rettv->v_type == VAR_FUNC ? rettv->vval.v_string 3515 : rettv->vval.v_partial->pt_name; 3516 /* Translate "s:func" to the stored function name. */ 3517 fname = fname_trans_sid(fname, fname_buf, &tofree, &error); 3518 fp = find_func(fname); 3519 vim_free(tofree); 3520 } 3521 3522 if (fp != NULL && (fp->uf_flags & FC_DICT)) 3523 { 3524 partial_T *pt = (partial_T *)alloc_clear(sizeof(partial_T)); 3525 3526 if (pt != NULL) 3527 { 3528 pt->pt_refcount = 1; 3529 pt->pt_dict = selfdict; 3530 pt->pt_auto = TRUE; 3531 selfdict = NULL; 3532 if (rettv->v_type == VAR_FUNC) 3533 { 3534 /* Just a function: Take over the function name and use 3535 * selfdict. */ 3536 pt->pt_name = rettv->vval.v_string; 3537 } 3538 else 3539 { 3540 partial_T *ret_pt = rettv->vval.v_partial; 3541 int i; 3542 3543 /* Partial: copy the function name, use selfdict and copy 3544 * args. Can't take over name or args, the partial might 3545 * be referenced elsewhere. */ 3546 if (ret_pt->pt_name != NULL) 3547 { 3548 pt->pt_name = vim_strsave(ret_pt->pt_name); 3549 func_ref(pt->pt_name); 3550 } 3551 else 3552 { 3553 pt->pt_func = ret_pt->pt_func; 3554 func_ptr_ref(pt->pt_func); 3555 } 3556 if (ret_pt->pt_argc > 0) 3557 { 3558 pt->pt_argv = (typval_T *)alloc( 3559 sizeof(typval_T) * ret_pt->pt_argc); 3560 if (pt->pt_argv == NULL) 3561 /* out of memory: drop the arguments */ 3562 pt->pt_argc = 0; 3563 else 3564 { 3565 pt->pt_argc = ret_pt->pt_argc; 3566 for (i = 0; i < pt->pt_argc; i++) 3567 copy_tv(&ret_pt->pt_argv[i], &pt->pt_argv[i]); 3568 } 3569 } 3570 partial_unref(ret_pt); 3571 } 3572 rettv->v_type = VAR_PARTIAL; 3573 rettv->vval.v_partial = pt; 3574 } 3575 } 3576 return selfdict; 3577 } 3578 3579 /* 3580 * Return the name of the executed function. 3581 */ 3582 char_u * 3583 func_name(void *cookie) 3584 { 3585 return ((funccall_T *)cookie)->func->uf_name; 3586 } 3587 3588 /* 3589 * Return the address holding the next breakpoint line for a funccall cookie. 3590 */ 3591 linenr_T * 3592 func_breakpoint(void *cookie) 3593 { 3594 return &((funccall_T *)cookie)->breakpoint; 3595 } 3596 3597 /* 3598 * Return the address holding the debug tick for a funccall cookie. 3599 */ 3600 int * 3601 func_dbg_tick(void *cookie) 3602 { 3603 return &((funccall_T *)cookie)->dbg_tick; 3604 } 3605 3606 /* 3607 * Return the nesting level for a funccall cookie. 3608 */ 3609 int 3610 func_level(void *cookie) 3611 { 3612 return ((funccall_T *)cookie)->level; 3613 } 3614 3615 /* 3616 * Return TRUE when a function was ended by a ":return" command. 3617 */ 3618 int 3619 current_func_returned(void) 3620 { 3621 return current_funccal->returned; 3622 } 3623 3624 int 3625 free_unref_funccal(int copyID, int testing) 3626 { 3627 int did_free = FALSE; 3628 int did_free_funccal = FALSE; 3629 funccall_T *fc, **pfc; 3630 3631 for (pfc = &previous_funccal; *pfc != NULL; ) 3632 { 3633 if (can_free_funccal(*pfc, copyID)) 3634 { 3635 fc = *pfc; 3636 *pfc = fc->caller; 3637 free_funccal(fc, TRUE); 3638 did_free = TRUE; 3639 did_free_funccal = TRUE; 3640 } 3641 else 3642 pfc = &(*pfc)->caller; 3643 } 3644 if (did_free_funccal) 3645 /* When a funccal was freed some more items might be garbage 3646 * collected, so run again. */ 3647 (void)garbage_collect(testing); 3648 3649 return did_free; 3650 } 3651 3652 /* 3653 * Get function call environment based on backtrace debug level 3654 */ 3655 static funccall_T * 3656 get_funccal(void) 3657 { 3658 int i; 3659 funccall_T *funccal; 3660 funccall_T *temp_funccal; 3661 3662 funccal = current_funccal; 3663 if (debug_backtrace_level > 0) 3664 { 3665 for (i = 0; i < debug_backtrace_level; i++) 3666 { 3667 temp_funccal = funccal->caller; 3668 if (temp_funccal) 3669 funccal = temp_funccal; 3670 else 3671 /* backtrace level overflow. reset to max */ 3672 debug_backtrace_level = i; 3673 } 3674 } 3675 return funccal; 3676 } 3677 3678 /* 3679 * Return the hashtable used for local variables in the current funccal. 3680 * Return NULL if there is no current funccal. 3681 */ 3682 hashtab_T * 3683 get_funccal_local_ht() 3684 { 3685 if (current_funccal == NULL) 3686 return NULL; 3687 return &get_funccal()->l_vars.dv_hashtab; 3688 } 3689 3690 /* 3691 * Return the l: scope variable. 3692 * Return NULL if there is no current funccal. 3693 */ 3694 dictitem_T * 3695 get_funccal_local_var() 3696 { 3697 if (current_funccal == NULL) 3698 return NULL; 3699 return &get_funccal()->l_vars_var; 3700 } 3701 3702 /* 3703 * Return the hashtable used for argument in the current funccal. 3704 * Return NULL if there is no current funccal. 3705 */ 3706 hashtab_T * 3707 get_funccal_args_ht() 3708 { 3709 if (current_funccal == NULL) 3710 return NULL; 3711 return &get_funccal()->l_avars.dv_hashtab; 3712 } 3713 3714 /* 3715 * Return the a: scope variable. 3716 * Return NULL if there is no current funccal. 3717 */ 3718 dictitem_T * 3719 get_funccal_args_var() 3720 { 3721 if (current_funccal == NULL) 3722 return NULL; 3723 return &get_funccal()->l_avars_var; 3724 } 3725 3726 /* 3727 * List function variables, if there is a function. 3728 */ 3729 void 3730 list_func_vars(int *first) 3731 { 3732 if (current_funccal != NULL) 3733 list_hashtable_vars(¤t_funccal->l_vars.dv_hashtab, 3734 (char_u *)"l:", FALSE, first); 3735 } 3736 3737 /* 3738 * If "ht" is the hashtable for local variables in the current funccal, return 3739 * the dict that contains it. 3740 * Otherwise return NULL. 3741 */ 3742 dict_T * 3743 get_current_funccal_dict(hashtab_T *ht) 3744 { 3745 if (current_funccal != NULL 3746 && ht == ¤t_funccal->l_vars.dv_hashtab) 3747 return ¤t_funccal->l_vars; 3748 return NULL; 3749 } 3750 3751 /* 3752 * Search hashitem in parent scope. 3753 */ 3754 hashitem_T * 3755 find_hi_in_scoped_ht(char_u *name, hashtab_T **pht) 3756 { 3757 funccall_T *old_current_funccal = current_funccal; 3758 hashtab_T *ht; 3759 hashitem_T *hi = NULL; 3760 char_u *varname; 3761 3762 if (current_funccal == NULL || current_funccal->func->uf_scoped == NULL) 3763 return NULL; 3764 3765 /* Search in parent scope which is possible to reference from lambda */ 3766 current_funccal = current_funccal->func->uf_scoped; 3767 while (current_funccal != NULL) 3768 { 3769 ht = find_var_ht(name, &varname); 3770 if (ht != NULL && *varname != NUL) 3771 { 3772 hi = hash_find(ht, varname); 3773 if (!HASHITEM_EMPTY(hi)) 3774 { 3775 *pht = ht; 3776 break; 3777 } 3778 } 3779 if (current_funccal == current_funccal->func->uf_scoped) 3780 break; 3781 current_funccal = current_funccal->func->uf_scoped; 3782 } 3783 current_funccal = old_current_funccal; 3784 3785 return hi; 3786 } 3787 3788 /* 3789 * Search variable in parent scope. 3790 */ 3791 dictitem_T * 3792 find_var_in_scoped_ht(char_u *name, int no_autoload) 3793 { 3794 dictitem_T *v = NULL; 3795 funccall_T *old_current_funccal = current_funccal; 3796 hashtab_T *ht; 3797 char_u *varname; 3798 3799 if (current_funccal == NULL || current_funccal->func->uf_scoped == NULL) 3800 return NULL; 3801 3802 /* Search in parent scope which is possible to reference from lambda */ 3803 current_funccal = current_funccal->func->uf_scoped; 3804 while (current_funccal) 3805 { 3806 ht = find_var_ht(name, &varname); 3807 if (ht != NULL && *varname != NUL) 3808 { 3809 v = find_var_in_ht(ht, *name, varname, no_autoload); 3810 if (v != NULL) 3811 break; 3812 } 3813 if (current_funccal == current_funccal->func->uf_scoped) 3814 break; 3815 current_funccal = current_funccal->func->uf_scoped; 3816 } 3817 current_funccal = old_current_funccal; 3818 3819 return v; 3820 } 3821 3822 /* 3823 * Set "copyID + 1" in previous_funccal and callers. 3824 */ 3825 int 3826 set_ref_in_previous_funccal(int copyID) 3827 { 3828 int abort = FALSE; 3829 funccall_T *fc; 3830 3831 for (fc = previous_funccal; fc != NULL; fc = fc->caller) 3832 { 3833 fc->fc_copyID = copyID + 1; 3834 abort = abort || set_ref_in_ht(&fc->l_vars.dv_hashtab, copyID + 1, 3835 NULL); 3836 abort = abort || set_ref_in_ht(&fc->l_avars.dv_hashtab, copyID + 1, 3837 NULL); 3838 } 3839 return abort; 3840 } 3841 3842 static int 3843 set_ref_in_funccal(funccall_T *fc, int copyID) 3844 { 3845 int abort = FALSE; 3846 3847 if (fc->fc_copyID != copyID) 3848 { 3849 fc->fc_copyID = copyID; 3850 abort = abort || set_ref_in_ht(&fc->l_vars.dv_hashtab, copyID, NULL); 3851 abort = abort || set_ref_in_ht(&fc->l_avars.dv_hashtab, copyID, NULL); 3852 abort = abort || set_ref_in_func(NULL, fc->func, copyID); 3853 } 3854 return abort; 3855 } 3856 3857 /* 3858 * Set "copyID" in all local vars and arguments in the call stack. 3859 */ 3860 int 3861 set_ref_in_call_stack(int copyID) 3862 { 3863 int abort = FALSE; 3864 funccall_T *fc; 3865 3866 for (fc = current_funccal; fc != NULL; fc = fc->caller) 3867 abort = abort || set_ref_in_funccal(fc, copyID); 3868 return abort; 3869 } 3870 3871 /* 3872 * Set "copyID" in all functions available by name. 3873 */ 3874 int 3875 set_ref_in_functions(int copyID) 3876 { 3877 int todo; 3878 hashitem_T *hi = NULL; 3879 int abort = FALSE; 3880 ufunc_T *fp; 3881 3882 todo = (int)func_hashtab.ht_used; 3883 for (hi = func_hashtab.ht_array; todo > 0 && !got_int; ++hi) 3884 { 3885 if (!HASHITEM_EMPTY(hi)) 3886 { 3887 --todo; 3888 fp = HI2UF(hi); 3889 if (!func_name_refcount(fp->uf_name)) 3890 abort = abort || set_ref_in_func(NULL, fp, copyID); 3891 } 3892 } 3893 return abort; 3894 } 3895 3896 /* 3897 * Set "copyID" in all function arguments. 3898 */ 3899 int 3900 set_ref_in_func_args(int copyID) 3901 { 3902 int i; 3903 int abort = FALSE; 3904 3905 for (i = 0; i < funcargs.ga_len; ++i) 3906 abort = abort || set_ref_in_item(((typval_T **)funcargs.ga_data)[i], 3907 copyID, NULL, NULL); 3908 return abort; 3909 } 3910 3911 /* 3912 * Mark all lists and dicts referenced through function "name" with "copyID". 3913 * Returns TRUE if setting references failed somehow. 3914 */ 3915 int 3916 set_ref_in_func(char_u *name, ufunc_T *fp_in, int copyID) 3917 { 3918 ufunc_T *fp = fp_in; 3919 funccall_T *fc; 3920 int error = ERROR_NONE; 3921 char_u fname_buf[FLEN_FIXED + 1]; 3922 char_u *tofree = NULL; 3923 char_u *fname; 3924 int abort = FALSE; 3925 3926 if (name == NULL && fp_in == NULL) 3927 return FALSE; 3928 3929 if (fp_in == NULL) 3930 { 3931 fname = fname_trans_sid(name, fname_buf, &tofree, &error); 3932 fp = find_func(fname); 3933 } 3934 if (fp != NULL) 3935 { 3936 for (fc = fp->uf_scoped; fc != NULL; fc = fc->func->uf_scoped) 3937 abort = abort || set_ref_in_funccal(fc, copyID); 3938 } 3939 vim_free(tofree); 3940 return abort; 3941 } 3942 3943 #endif /* FEAT_EVAL */ 3944