2 Copyright 2012 Lukas Mai.
4 This program is free software; you can redistribute it and/or modify it
5 under the terms of either: the GNU General Public License as published
6 by the Free Software Foundation; or the Artistic License.
8 See http://dev.perl.org/licenses/ for more information.
12 #if (__GNUC__ == 4 && __GNUC_MINOR__ >= 6) || __GNUC__ >= 5
13 #define PRAGMA_GCC_(X) _Pragma(#X)
14 #define PRAGMA_GCC(X) PRAGMA_GCC_(GCC X)
23 #define WARNINGS_RESET PRAGMA_GCC(diagnostic pop)
24 #define WARNINGS_ENABLEW(X) PRAGMA_GCC(diagnostic warning #X)
25 #define WARNINGS_ENABLE \
26 WARNINGS_ENABLEW(-Wall) \
27 WARNINGS_ENABLEW(-Wextra) \
28 WARNINGS_ENABLEW(-Wundef) \
29 /* WARNINGS_ENABLEW(-Wshadow) :-( */ \
30 WARNINGS_ENABLEW(-Wbad-function-cast) \
31 WARNINGS_ENABLEW(-Wcast-align) \
32 WARNINGS_ENABLEW(-Wwrite-strings) \
33 /* WARNINGS_ENABLEW(-Wnested-externs) wtf? */ \
34 WARNINGS_ENABLEW(-Wstrict-prototypes) \
35 WARNINGS_ENABLEW(-Wmissing-prototypes) \
36 WARNINGS_ENABLEW(-Winline) \
37 WARNINGS_ENABLEW(-Wdisabled-optimization)
40 #define WARNINGS_RESET
41 #define WARNINGS_ENABLE
45 #define PERL_NO_GET_CONTEXT
56 #define HAVE_PERL_VERSION(R, V, S) \
57 (PERL_REVISION > (R) || (PERL_REVISION == (R) && (PERL_VERSION > (V) || (PERL_VERSION == (V) && (PERL_SUBVERSION >= (S))))))
59 #if HAVE_PERL_VERSION(5, 16, 0)
60 #define IF_HAVE_PERL_5_16(YES, NO) YES
62 #define IF_HAVE_PERL_5_16(YES, NO) NO
66 #if HAVE_PERL_VERSION(5, 17, 6)
67 #error "internal error: missing definition of KEY_my (your perl is too new)"
68 #elif HAVE_PERL_VERSION(5, 15, 8)
70 #elif HAVE_PERL_VERSION(5, 15, 6)
72 #elif HAVE_PERL_VERSION(5, 15, 5)
74 #elif HAVE_PERL_VERSION(5, 13, 0)
77 #error "internal error: missing definition of KEY_my (your perl is too old)"
82 #define MY_PKG "Function::Parameters"
84 #define HINTK_KEYWORDS MY_PKG "/keywords"
85 #define HINTK_FLAGS_ MY_PKG "/flags:"
86 #define HINTK_SHIFT_ MY_PKG "/shift:"
87 #define HINTK_ATTRS_ MY_PKG "/attrs:"
89 #define DEFSTRUCT(T) typedef struct T T; struct T
91 #define UV_BITS (sizeof (UV) * CHAR_BIT)
96 FLAG_DEFAULT_ARGS = 0x04,
97 FLAG_CHECK_NARGS = 0x08,
99 FLAG_NAMED_PARAMS = 0x20
108 static int (*next_keyword_plugin)(pTHX_ char *, STRLEN, OP **);
110 DEFSTRUCT(Resource) {
113 void (*destroy)(pTHX_ void *);
116 typedef Resource *Sentinel[1];
118 static void sentinel_clear_void(pTHX_ void *p) {
122 cur->destroy(aTHX_ cur->data);
123 cur->data = (void *)"no";
130 static void sentinel_register(Sentinel sen, void *data, void (*destroy)(pTHX_ void *)) {
133 Newx(cur, 1, Resource);
135 cur->destroy = destroy;
140 static void my_sv_refcnt_dec_void(pTHX_ void *p) {
145 static SV *sentinel_mortalize(Sentinel sen, SV *sv) {
146 sentinel_register(sen, sv, my_sv_refcnt_dec_void);
150 static void my_safefree(void *p) {
154 #define SENTINEL_ALLOC(SEN, P, N, T) STMT_START { \
156 sentinel_register(SEN, P, my_safefree); \
159 #define SENTINEL_MDUP(SEN, P, O, N, T) STMT_START { \
160 void *const _sentinel_mdup_tmp_ = (P); \
161 SENTINEL_ALLOC(SEN, P, N, T); \
162 memcpy(P, _sentinel_mdup_tmp_, O * sizeof (T)); \
165 #define SENTINEL_REALLOC(SEN, P, N, T) STMT_START { \
168 SENTINEL_ALLOC(SEN, P, N, T); \
170 Resource **_sentinel_realloc_tmp_ = (SEN); \
172 assert(*_sentinel_realloc_tmp_ != NULL); \
173 if ((*_sentinel_realloc_tmp_)->data == (P)) { \
174 Renew((*_sentinel_realloc_tmp_)->data, N, T); \
175 (P) = (*_sentinel_realloc_tmp_)->data; \
178 _sentinel_realloc_tmp_ = &(*_sentinel_realloc_tmp_)->next; \
183 static int kw_flags(pTHX_ Sentinel sen, const char *kw_ptr, STRLEN kw_len, KWSpec *spec) {
186 const char *p, *kw_active;
187 STRLEN kw_active_len;
190 spec->shift = sentinel_mortalize(sen, newSVpvs(""));
191 spec->attrs = sentinel_mortalize(sen, newSVpvs(""));
193 if (!(hints = GvHV(PL_hintgv))) {
196 if (!(psv = hv_fetchs(hints, HINTK_KEYWORDS, 0))) {
200 kw_active = SvPV(sv, kw_active_len);
201 if (kw_active_len <= kw_len) {
206 (p = strchr(p, *kw_ptr)) &&
207 p < kw_active + kw_active_len - kw_len;
211 (p == kw_active || p[-1] == ' ') &&
213 memcmp(kw_ptr, p, kw_len) == 0
216 #define FETCH_HINTK_INTO(NAME, PTR, LEN, X) STMT_START { \
217 const char *fk_ptr_; \
220 fk_sv_ = sentinel_mortalize(sen, newSVpvs(HINTK_ ## NAME)); \
221 sv_catpvn(fk_sv_, PTR, LEN); \
222 fk_ptr_ = SvPV(fk_sv_, fk_len_); \
223 if (!((X) = hv_fetch(hints, fk_ptr_, fk_len_, 0))) { \
224 croak("%s: internal error: $^H{'%.*s'} not set", MY_PKG, (int)fk_len_, fk_ptr_); \
228 FETCH_HINTK_INTO(FLAGS_, kw_ptr, kw_len, psv);
229 spec->flags = SvIV(*psv);
231 FETCH_HINTK_INTO(SHIFT_, kw_ptr, kw_len, psv);
232 SvSetSV(spec->shift, *psv);
234 FETCH_HINTK_INTO(ATTRS_, kw_ptr, kw_len, psv);
235 SvSetSV(spec->attrs, *psv);
237 #undef FETCH_HINTK_INTO
245 static void free_ptr_op(pTHX_ void *vp) {
251 #define sv_eq_pvs(SV, S) my_sv_eq_pvn(aTHX_ SV, "" S "", sizeof (S) - 1)
253 static int my_sv_eq_pvn(pTHX_ SV *sv, const char *p, STRLEN n) {
255 const char *sv_p = SvPV(sv, sv_len);
256 return memcmp(sv_p, p, n) == 0;
260 #include "padop_on_crack.c.inc"
264 MY_ATTR_LVALUE = 0x01,
265 MY_ATTR_METHOD = 0x02,
266 MY_ATTR_SPECIAL = 0x04
269 static void my_sv_cat_c(pTHX_ SV *sv, U32 c) {
270 char ds[UTF8_MAXBYTES + 1], *d;
271 d = (char *)uvchr_to_utf8((U8 *)ds, c);
275 sv_catpvn(sv, ds, d - ds);
278 static bool my_is_uni_xidfirst(pTHX_ UV c) {
279 U8 tmpbuf[UTF8_MAXBYTES + 1];
280 uvchr_to_utf8(tmpbuf, c);
281 return is_utf8_xidfirst(tmpbuf);
284 static bool my_is_uni_xidcont(pTHX_ UV c) {
285 U8 tmpbuf[UTF8_MAXBYTES + 1];
286 uvchr_to_utf8(tmpbuf, c);
287 return is_utf8_xidcont(tmpbuf);
290 static SV *my_scan_word(pTHX_ Sentinel sen, bool allow_package) {
291 bool at_start, at_substart;
293 SV *sv = sentinel_mortalize(sen, newSVpvs(""));
298 at_start = at_substart = TRUE;
299 c = lex_peek_unichar(0);
302 if (at_substart ? my_is_uni_xidfirst(aTHX_ c) : my_is_uni_xidcont(aTHX_ c)) {
304 my_sv_cat_c(aTHX_ sv, c);
306 c = lex_peek_unichar(0);
307 } else if (allow_package && !at_substart && c == '\'') {
309 c = lex_peek_unichar(0);
310 if (!my_is_uni_xidfirst(aTHX_ c)) {
311 lex_stuff_pvs("'", 0);
316 } else if (allow_package && (at_start || !at_substart) && c == ':') {
318 if (lex_peek_unichar(0) != ':') {
319 lex_stuff_pvs(":", 0);
323 c = lex_peek_unichar(0);
324 if (!my_is_uni_xidfirst(aTHX_ c)) {
325 lex_stuff_pvs("::", 0);
336 return SvCUR(sv) ? sv : NULL;
339 static SV *my_scan_parens_tail(pTHX_ Sentinel sen, bool keep_backslash) {
344 start = CopLINE(PL_curcop);
346 sv = sentinel_mortalize(sen, newSVpvs(""));
353 c = lex_read_unichar(0);
355 CopLINE_set(PL_curcop, start);
360 c = lex_read_unichar(0);
362 CopLINE_set(PL_curcop, start);
365 if (keep_backslash || (c != '(' && c != ')')) {
368 } else if (c == '(') {
370 } else if (c == ')') {
377 my_sv_cat_c(aTHX_ sv, c);
383 static void my_check_prototype(pTHX_ Sentinel sen, const SV *declarator, SV *proto) {
384 char *start, *r, *w, *end;
388 start = SvPV(proto, len);
391 for (w = r = start; r < end; r++) {
397 SvCUR_set(proto, w - start);
401 if (!ckWARN(WARN_ILLEGALPROTO)) {
405 /* check for bad characters */
406 if (strspn(start, "$@%*;[]&\\_+") != len) {
407 SV *dsv = sentinel_mortalize(sen, newSVpvs(""));
409 packWARN(WARN_ILLEGALPROTO),
410 "Illegal character in prototype for %"SVf" : %s",
419 : pv_pretty(dsv, start, len, 60, NULL, NULL,
420 PERL_PV_ESCAPE_NONASCII
426 for (r = start; r < end; r++) {
430 packWARN(WARN_ILLEGALPROTO),
431 "Illegal character in prototype for %"SVf" : %s",
432 SVfARG(declarator), r
437 if (r[1] && !strchr(";@%", *r)) {
439 packWARN(WARN_ILLEGALPROTO),
440 "Illegal character after '_' in prototype for %"SVf" : %s",
441 SVfARG(declarator), r
451 packWARN(WARN_ILLEGALPROTO),
452 "prototype after '%c' for %"SVf": %s",
453 *r, SVfARG(declarator), r + 1
461 if (strchr("$@%&*", *r)) {
466 for (; r < end && *r != ']'; r++) {
467 if (!strchr("$@%&*", *r)) {
471 if (*r == ']' && r[-1] != '[') {
476 packWARN(WARN_ILLEGALPROTO),
477 "Illegal character after '\\' in prototype for %"SVf" : %s",
478 SVfARG(declarator), r
498 DEFSTRUCT(ParamInit) {
503 #define VEC(B) B ## _Vec
505 #define DEFVECTOR(B) DEFSTRUCT(VEC(B)) { \
511 DEFVECTOR(ParamInit);
513 #define DEFVECTOR_INIT(N, B) static void N(VEC(B) *p) { \
516 Newx(p->data, p->size, B); \
517 } static void N(VEC(B) *)
519 DEFSTRUCT(ParamSpec) {
521 VEC(Param) positional_required;
522 VEC(ParamInit) positional_optional;
523 VEC(Param) named_required;
524 VEC(ParamInit) named_optional;
529 DEFVECTOR_INIT(pv_init, Param);
530 DEFVECTOR_INIT(piv_init, ParamInit);
532 static void p_init(Param *p) {
534 p->padoff = NOT_IN_PAD;
537 static void ps_init(ParamSpec *ps) {
538 p_init(&ps->invocant);
539 pv_init(&ps->positional_required);
540 piv_init(&ps->positional_optional);
541 pv_init(&ps->named_required);
542 piv_init(&ps->named_optional);
544 ps->rest_hash = NOT_IN_PAD;
547 #define DEFVECTOR_EXTEND(N, B) static B (*N(VEC(B) *p)) { \
548 assert(p->used <= p->size); \
549 if (p->used == p->size) { \
550 const size_t n = p->size / 2 * 3 + 1; \
551 Renew(p->data, n, B); \
554 return &p->data[p->used]; \
555 } static B (*N(VEC(B) *))
557 DEFVECTOR_EXTEND(pv_extend, Param);
558 DEFVECTOR_EXTEND(piv_extend, ParamInit);
560 #define DEFVECTOR_CLEAR(N, B, F) static void N(pTHX_ VEC(B) *p) { \
563 F(aTHX_ &p->data[p->used]); \
568 } static void N(pTHX_ VEC(B) *)
570 static void p_clear(pTHX_ Param *p) {
572 p->padoff = NOT_IN_PAD;
575 static void pi_clear(pTHX_ ParamInit *pi) {
576 p_clear(aTHX_ &pi->param);
583 DEFVECTOR_CLEAR(pv_clear, Param, p_clear);
584 DEFVECTOR_CLEAR(piv_clear, ParamInit, pi_clear);
586 static void ps_clear(pTHX_ ParamSpec *ps) {
587 p_clear(aTHX_ &ps->invocant);
589 pv_clear(aTHX_ &ps->positional_required);
590 piv_clear(aTHX_ &ps->positional_optional);
592 pv_clear(aTHX_ &ps->named_required);
593 piv_clear(aTHX_ &ps->named_optional);
595 p_clear(aTHX_ &ps->slurpy);
598 static int ps_contains(pTHX_ const ParamSpec *ps, SV *sv) {
601 if (ps->invocant.name && sv_eq(sv, ps->invocant.name)) {
605 for (i = 0, lim = ps->positional_required.used; i < lim; i++) {
606 if (sv_eq(sv, ps->positional_required.data[i].name)) {
611 for (i = 0, lim = ps->positional_optional.used; i < lim; i++) {
612 if (sv_eq(sv, ps->positional_optional.data[i].param.name)) {
617 for (i = 0, lim = ps->named_required.used; i < lim; i++) {
618 if (sv_eq(sv, ps->named_required.data[i].name)) {
623 for (i = 0, lim = ps->named_optional.used; i < lim; i++) {
624 if (sv_eq(sv, ps->named_optional.data[i].param.name)) {
632 static void ps_free_void(pTHX_ void *p) {
637 static int args_min(pTHX_ const ParamSpec *ps, const KWSpec *ks) {
640 return SvTRUE(ks->shift) ? 1 : 0;
642 if (ps->invocant.name) {
645 n += ps->positional_required.used;
646 n += ps->named_required.used * 2;
650 static int args_max(const ParamSpec *ps) {
655 if (ps->invocant.name) {
658 n += ps->positional_required.used;
659 n += ps->positional_optional.used;
660 if (ps->named_required.used || ps->named_optional.used || ps->slurpy.name) {
666 static size_t count_positional_params(const ParamSpec *ps) {
667 return ps->positional_required.used + ps->positional_optional.used;
670 static size_t count_named_params(const ParamSpec *ps) {
671 return ps->named_required.used + ps->named_optional.used;
675 PARAM_INVOCANT = 0x01,
679 /* *pinit must be NULL on entry.
680 * caller must free *pinit on error.
682 static PADOFFSET parse_param(
685 const SV *declarator, const KWSpec *spec, ParamSpec *param_spec,
686 int *pflags, SV **pname, OP **pinit
695 c = lex_peek_unichar(0);
701 *pflags |= PARAM_NAMED;
703 c = lex_peek_unichar(0);
707 croak("In %"SVf": unterminated parameter list", SVfARG(declarator));
709 if (!(c == '$' || c == '@' || c == '%')) {
710 croak("In %"SVf": unexpected '%c' in parameter list (expecting a sigil)", SVfARG(declarator), (int)c);
718 if (!(name = my_scan_word(aTHX_ sen, FALSE))) {
719 croak("In %"SVf": missing identifier after '%c'", SVfARG(declarator), sigil);
721 sv_insert(name, 0, 0, &sigil, 1);
725 c = lex_peek_unichar(0);
732 if (!param_spec->invocant.name && SvTRUE(spec->shift)) {
733 param_spec->invocant.name = spec->shift;
734 param_spec->invocant.padoff = pad_add_name_sv(param_spec->invocant.name, 0, NULL, NULL);
737 *pinit = parse_termexpr(0);
740 c = lex_peek_unichar(0);
744 *pflags |= PARAM_INVOCANT;
747 } else if (c == ',') {
750 } else if (c != ')') {
752 croak("In %"SVf": unterminated parameter list", SVfARG(declarator));
754 croak("In %"SVf": unexpected '%c' in parameter list (expecting ',')", SVfARG(declarator), (int)c);
757 return pad_add_name_sv(*pname, IF_HAVE_PERL_5_16(padadd_NO_DUP_CHECK, 0), NULL, NULL);
760 static OP *my_var_g(pTHX_ I32 type, I32 flags, PADOFFSET padoff) {
761 OP *var = newOP(type, flags);
762 var->op_targ = padoff;
766 static OP *my_var(pTHX_ I32 flags, PADOFFSET padoff) {
767 return my_var_g(aTHX_ OP_PADSV, flags, padoff);
770 static OP *mkhvelem(pTHX_ PADOFFSET h, OP *k) {
771 OP *hv = my_var_g(aTHX_ OP_PADHV, OPf_REF, h);
772 return newBINOP(OP_HELEM, 0, hv, k);
775 static OP *mkconstsv(pTHX_ SV *sv) {
776 return newSVOP(OP_CONST, 0, sv);
779 static OP *mkconstiv(pTHX_ IV i) {
780 return mkconstsv(aTHX_ newSViv(i));
783 static OP *mkconstpv(pTHX_ const char *p, size_t n) {
784 return mkconstsv(aTHX_ newSVpv(p, n));
787 #define mkconstpvs(S) mkconstpv(aTHX_ "" S "", sizeof S - 1)
789 static void register_info(pTHX_ UV key, SV *declarator, const KWSpec *kws, const ParamSpec *ps) {
803 char *p = SvPV(declarator, n);
804 char *q = memchr(p, ' ', n);
805 mPUSHp(p, q ? (size_t)(q - p) : n);
808 if (SvTRUE(kws->shift)) {
813 mPUSHs(newRV_noinc((SV *)newAV()));
814 mPUSHs(newRV_noinc((SV *)newAV()));
815 mPUSHs(newRV_noinc((SV *)newAV()));
816 mPUSHs(newRV_noinc((SV *)newAV()));
820 if (ps->invocant.name) {
821 PUSHs(ps->invocant.name);
830 lim = ps->positional_required.used;
834 av_extend(av, lim - 1);
835 for (i = 0; i < lim; i++) {
836 av_push(av, SvREFCNT_inc_simple_NN(ps->positional_required.data[i].name));
840 mPUSHs(newRV_noinc((SV *)av));
846 lim = ps->positional_optional.used;
850 av_extend(av, lim - 1);
851 for (i = 0; i < lim; i++) {
852 av_push(av, SvREFCNT_inc_simple_NN(ps->positional_optional.data[i].param.name));
856 mPUSHs(newRV_noinc((SV *)av));
862 lim = ps->named_required.used;
866 av_extend(av, lim - 1);
867 for (i = 0; i < lim; i++) {
868 av_push(av, SvREFCNT_inc_simple_NN(ps->named_required.data[i].name));
872 mPUSHs(newRV_noinc((SV *)av));
878 lim = ps->named_optional.used;
882 av_extend(av, lim - 1);
883 for (i = 0; i < lim; i++) {
884 av_push(av, SvREFCNT_inc_simple_NN(ps->named_optional.data[i].param.name));
888 mPUSHs(newRV_noinc((SV *)av));
891 if (ps->slurpy.name) {
892 PUSHs(ps->slurpy.name);
900 call_pv(MY_PKG "::_register_info", G_VOID);
906 static int parse_fun(pTHX_ Sentinel sen, OP **pop, const char *keyword_ptr, STRLEN keyword_len, const KWSpec *spec) {
907 ParamSpec *param_spec;
912 OP **prelude_sentinel;
914 OP **attrs_sentinel, *body;
915 unsigned builtin_attrs;
918 declarator = sentinel_mortalize(sen, newSVpvn(keyword_ptr, keyword_len));
926 if ((spec->flags & FLAG_NAME_OK) && (saw_name = my_scan_word(aTHX_ sen, TRUE))) {
928 if (PL_parser->expect != XSTATE) {
929 /* bail out early so we don't predeclare $saw_name */
930 croak("In %"SVf": I was expecting a function body, not \"%"SVf"\"", SVfARG(declarator), SVfARG(saw_name));
933 sv_catpvs(declarator, " ");
934 sv_catsv(declarator, saw_name);
937 sv_eq_pvs(saw_name, "BEGIN") ||
938 sv_eq_pvs(saw_name, "END") ||
939 sv_eq_pvs(saw_name, "INIT") ||
940 sv_eq_pvs(saw_name, "CHECK") ||
941 sv_eq_pvs(saw_name, "UNITCHECK")
943 builtin_attrs |= MY_ATTR_SPECIAL;
947 } else if (!(spec->flags & FLAG_ANON_OK)) {
948 croak("I was expecting a function name, not \"%.*s\"", (int)(PL_parser->bufend - PL_parser->bufptr), PL_parser->bufptr);
950 sv_catpvs(declarator, " (anon)");
953 /* we're a subroutine declaration */
954 floor_ix = start_subparse(FALSE, saw_name ? 0 : CVf_ANON);
955 SAVEFREESV(PL_compcv);
957 /* create outer block: '{' */
958 save_ix = S_block_start(aTHX_ TRUE);
960 /* initialize synthetic optree */
961 Newx(prelude_sentinel, 1, OP *);
962 *prelude_sentinel = NULL;
963 sentinel_register(sen, prelude_sentinel, free_ptr_op);
968 c = lex_peek_unichar(0);
972 Newx(init_sentinel, 1, OP *);
973 *init_sentinel = NULL;
974 sentinel_register(sen, init_sentinel, free_ptr_op);
976 Newx(param_spec, 1, ParamSpec);
978 sentinel_register(sen, param_spec, ps_free_void);
983 while ((c = lex_peek_unichar(0)) != ')') {
989 padoff = parse_param(aTHX_ sen, declarator, spec, param_spec, &flags, &name, init_sentinel);
993 sigil = SvPV_nolen(name)[0];
995 /* internal consistency */
996 if (flags & PARAM_NAMED) {
997 if (flags & PARAM_INVOCANT) {
998 croak("In %"SVf": invocant %"SVf" can't be a named parameter", SVfARG(declarator), SVfARG(name));
1001 croak("In %"SVf": named parameter %"SVf" can't be a%s", SVfARG(declarator), SVfARG(name), sigil == '@' ? "n array" : " hash");
1003 } else if (flags & PARAM_INVOCANT) {
1004 if (*init_sentinel) {
1005 croak("In %"SVf": invocant %"SVf" can't have a default value", SVfARG(declarator), SVfARG(name));
1008 croak("In %"SVf": invocant %"SVf" can't be a%s", SVfARG(declarator), SVfARG(name), sigil == '@' ? "n array" : " hash");
1010 } else if (sigil != '$' && *init_sentinel) {
1011 croak("In %"SVf": %s %"SVf" can't have a default value", SVfARG(declarator), sigil == '@' ? "array" : "hash", SVfARG(name));
1014 /* external constraints */
1015 if (param_spec->slurpy.name) {
1016 croak("In %"SVf": I was expecting \")\" after \"%"SVf"\", not \"%"SVf"\"", SVfARG(declarator), SVfARG(param_spec->slurpy.name), SVfARG(name));
1019 assert(!*init_sentinel);
1020 param_spec->slurpy.name = name;
1021 param_spec->slurpy.padoff = padoff;
1025 if (!(flags & PARAM_NAMED) && count_named_params(param_spec)) {
1026 croak("In %"SVf": positional parameter %"SVf" can't appear after named parameter %"SVf"", SVfARG(declarator), SVfARG(name), SVfARG((param_spec->named_required.used ? param_spec->named_required.data[0] : param_spec->named_optional.data[0].param).name));
1029 if (flags & PARAM_INVOCANT) {
1030 if (param_spec->invocant.name) {
1031 croak("In %"SVf": invalid double invocants %"SVf", %"SVf"", SVfARG(declarator), SVfARG(param_spec->invocant.name), SVfARG(name));
1033 if (count_positional_params(param_spec) || count_named_params(param_spec)) {
1034 croak("In %"SVf": invocant %"SVf" must be first in parameter list", SVfARG(declarator), SVfARG(name));
1036 if (!(spec->flags & FLAG_INVOCANT)) {
1037 croak("In %"SVf": invocant %"SVf" not allowed here", SVfARG(declarator), SVfARG(name));
1039 param_spec->invocant.name = name;
1040 param_spec->invocant.padoff = padoff;
1044 if (*init_sentinel && !(spec->flags & FLAG_DEFAULT_ARGS)) {
1045 croak("In %"SVf": default argument for %"SVf" not allowed here", SVfARG(declarator), SVfARG(name));
1048 if (ps_contains(aTHX_ param_spec, name)) {
1049 croak("In %"SVf": %"SVf" can't appear twice in the same parameter list", SVfARG(declarator), SVfARG(name));
1052 if (flags & PARAM_NAMED) {
1053 if (!(spec->flags & FLAG_NAMED_PARAMS)) {
1054 croak("In %"SVf": named parameter :%"SVf" not allowed here", SVfARG(declarator), SVfARG(name));
1057 if (*init_sentinel) {
1058 ParamInit *pi = piv_extend(¶m_spec->named_optional);
1059 pi->param.name = name;
1060 pi->param.padoff = padoff;
1061 pi->init = *init_sentinel;
1062 *init_sentinel = NULL;
1063 param_spec->named_optional.used++;
1067 if (param_spec->positional_optional.used) {
1068 croak("In %"SVf": can't combine optional positional (%"SVf") and required named (%"SVf") parameters", SVfARG(declarator), SVfARG(param_spec->positional_optional.data[0].param.name), SVfARG(name));
1071 p = pv_extend(¶m_spec->named_required);
1074 param_spec->named_required.used++;
1077 if (*init_sentinel || param_spec->positional_optional.used) {
1078 ParamInit *pi = piv_extend(¶m_spec->positional_optional);
1079 pi->param.name = name;
1080 pi->param.padoff = padoff;
1081 pi->init = *init_sentinel;
1082 *init_sentinel = NULL;
1083 param_spec->positional_optional.used++;
1085 Param *p = pv_extend(¶m_spec->positional_required);
1088 param_spec->positional_required.used++;
1093 lex_read_unichar(0);
1095 *init_sentinel = NULL;
1097 if (!param_spec->invocant.name && SvTRUE(spec->shift)) {
1098 if (ps_contains(aTHX_ param_spec, spec->shift)) {
1099 croak("In %"SVf": %"SVf" can't appear twice in the same parameter list", SVfARG(declarator), SVfARG(spec->shift));
1102 param_spec->invocant.name = spec->shift;
1103 param_spec->invocant.padoff = pad_add_name_sv(param_spec->invocant.name, 0, NULL, NULL);
1109 c = lex_peek_unichar(0);
1111 lex_read_unichar(0);
1114 c = lex_peek_unichar(0);
1116 lex_stuff_pvs(":", 0);
1119 lex_read_unichar(0);
1120 if (!(proto = my_scan_parens_tail(aTHX_ sen, FALSE))) {
1121 croak("In %"SVf": prototype not terminated", SVfARG(declarator));
1123 my_check_prototype(aTHX_ sen, declarator, proto);
1125 c = lex_peek_unichar(0);
1126 if (!(c == ':' || c == '{')) {
1127 lex_stuff_pvs(":", 0);
1134 Newx(attrs_sentinel, 1, OP *);
1135 *attrs_sentinel = NULL;
1136 sentinel_register(sen, attrs_sentinel, free_ptr_op);
1138 if (c == ':' || c == '{') /* '}' - hi, vim */ {
1140 /* kludge default attributes in */
1141 if (SvTRUE(spec->attrs) && SvPV_nolen(spec->attrs)[0] == ':') {
1142 lex_stuff_sv(spec->attrs, 0);
1147 lex_read_unichar(0);
1149 c = lex_peek_unichar(0);
1154 if (!(attr = my_scan_word(aTHX_ sen, FALSE))) {
1159 c = lex_peek_unichar(0);
1162 if (sv_eq_pvs(attr, "lvalue")) {
1163 builtin_attrs |= MY_ATTR_LVALUE;
1165 } else if (sv_eq_pvs(attr, "method")) {
1166 builtin_attrs |= MY_ATTR_METHOD;
1171 lex_read_unichar(0);
1172 if (!(sv = my_scan_parens_tail(aTHX_ sen, TRUE))) {
1173 croak("In %"SVf": unterminated attribute parameter in attribute list", SVfARG(declarator));
1175 sv_catpvs(attr, "(");
1177 sv_catpvs(attr, ")");
1180 c = lex_peek_unichar(0);
1184 *attrs_sentinel = op_append_elem(OP_LIST, *attrs_sentinel, mkconstsv(aTHX_ SvREFCNT_inc_simple_NN(attr)));
1188 lex_read_unichar(0);
1190 c = lex_peek_unichar(0);
1197 if (c != '{') /* '}' - hi, vim */ {
1198 croak("In %"SVf": I was expecting a function body, not \"%c\"", SVfARG(declarator), (int)c);
1201 /* surprise predeclaration! */
1203 /* 'sub NAME (PROTO);' to make name/proto known to perl before it
1204 starts parsing the body */
1205 const I32 sub_ix = start_subparse(FALSE, 0);
1206 SAVEFREESV(PL_compcv);
1208 SvREFCNT_inc_simple_void(PL_compcv);
1212 mkconstsv(aTHX_ SvREFCNT_inc_simple_NN(saw_name)),
1213 proto ? mkconstsv(aTHX_ SvREFCNT_inc_simple_NN(proto)) : NULL,
1219 if (builtin_attrs & MY_ATTR_LVALUE) {
1220 CvLVALUE_on(PL_compcv);
1222 if (builtin_attrs & MY_ATTR_METHOD) {
1223 CvMETHOD_on(PL_compcv);
1225 if (builtin_attrs & MY_ATTR_SPECIAL) {
1226 CvSPECIAL_on(PL_compcv);
1229 /* check number of arguments */
1230 if (spec->flags & FLAG_CHECK_NARGS) {
1233 amin = args_min(aTHX_ param_spec, spec);
1235 OP *chk, *cond, *err, *xcroak;
1237 err = mkconstsv(aTHX_ newSVpvf("Not enough arguments for %"SVf" (expected %d, got ", SVfARG(declarator), amin));
1241 newAVREF(newGVOP(OP_GV, 0, PL_defgv))
1249 xcroak = newCVREF(OPf_WANT_SCALAR,
1250 newGVOP(OP_GV, 0, gv_fetchpvs("Carp::croak", 0, SVt_PVCV)));
1251 err = newUNOP(OP_ENTERSUB, OPf_STACKED,
1252 op_append_elem(OP_LIST, err, xcroak));
1254 cond = newBINOP(OP_LT, 0,
1255 newAVREF(newGVOP(OP_GV, 0, PL_defgv)),
1256 mkconstiv(aTHX_ amin));
1257 chk = newLOGOP(OP_AND, 0, cond, err);
1259 *prelude_sentinel = op_append_list(OP_LINESEQ, *prelude_sentinel, newSTATEOP(0, NULL, chk));
1262 amax = args_max(param_spec);
1264 OP *chk, *cond, *err, *xcroak;
1266 err = mkconstsv(aTHX_ newSVpvf("Too many arguments for %"SVf" (expected %d, got ", SVfARG(declarator), amax));
1270 newAVREF(newGVOP(OP_GV, 0, PL_defgv))
1280 newGVOP(OP_GV, 0, gv_fetchpvs("Carp::croak", 0, SVt_PVCV))
1282 err = newUNOP(OP_ENTERSUB, OPf_STACKED,
1283 op_append_elem(OP_LIST, err, xcroak));
1287 newAVREF(newGVOP(OP_GV, 0, PL_defgv)),
1288 mkconstiv(aTHX_ amax)
1290 chk = newLOGOP(OP_AND, 0, cond, err);
1292 *prelude_sentinel = op_append_list(OP_LINESEQ, *prelude_sentinel, newSTATEOP(0, NULL, chk));
1295 if (param_spec && (count_named_params(param_spec) || (param_spec->slurpy.name && SvPV_nolen(param_spec->slurpy.name)[0] == '%'))) {
1296 OP *chk, *cond, *err, *xcroak;
1297 const UV fixed = count_positional_params(param_spec) + !!param_spec->invocant.name;
1299 err = mkconstsv(aTHX_ newSVpvf("Odd number of paired arguments for %"SVf"", SVfARG(declarator)));
1303 newGVOP(OP_GV, 0, gv_fetchpvs("Carp::croak", 0, SVt_PVCV))
1305 err = newUNOP(OP_ENTERSUB, OPf_STACKED,
1306 op_append_elem(OP_LIST, err, xcroak));
1308 cond = newBINOP(OP_GT, 0,
1309 newAVREF(newGVOP(OP_GV, 0, PL_defgv)),
1310 mkconstiv(aTHX_ fixed));
1311 cond = newLOGOP(OP_AND, 0,
1313 newBINOP(OP_MODULO, 0,
1315 ? newBINOP(OP_SUBTRACT, 0,
1316 newAVREF(newGVOP(OP_GV, 0, PL_defgv)),
1317 mkconstiv(aTHX_ fixed))
1318 : newAVREF(newGVOP(OP_GV, 0, PL_defgv)),
1319 mkconstiv(aTHX_ 2)));
1320 chk = newLOGOP(OP_AND, 0, cond, err);
1322 *prelude_sentinel = op_append_list(OP_LINESEQ, *prelude_sentinel, newSTATEOP(0, NULL, chk));
1327 /* my $invocant = shift; */
1328 if (SvTRUE(spec->shift)) {
1333 OPf_MOD | (OPpLVAL_INTRO << 8),
1334 pad_add_name_sv(spec->shift, 0, NULL, NULL)
1336 var = newASSIGNOP(OPf_STACKED, var, 0, newOP(OP_SHIFT, 0));
1338 *prelude_sentinel = op_append_list(OP_LINESEQ, *prelude_sentinel, newSTATEOP(0, NULL, var));
1341 /* my $invocant = shift; */
1342 if (param_spec->invocant.name) {
1347 OPf_MOD | (OPpLVAL_INTRO << 8),
1348 param_spec->invocant.padoff
1350 var = newASSIGNOP(OPf_STACKED, var, 0, newOP(OP_SHIFT, 0));
1352 *prelude_sentinel = op_append_list(OP_LINESEQ, *prelude_sentinel, newSTATEOP(0, NULL, var));
1355 /* my (...) = @_; */
1362 for (i = 0, lim = param_spec->positional_required.used; i < lim; i++) {
1363 OP *const var = my_var(
1365 OPf_WANT_LIST | (OPpLVAL_INTRO << 8),
1366 param_spec->positional_required.data[i].padoff
1368 lhs = op_append_elem(OP_LIST, lhs, var);
1371 for (i = 0, lim = param_spec->positional_optional.used; i < lim; i++) {
1372 OP *const var = my_var(
1374 OPf_WANT_LIST | (OPpLVAL_INTRO << 8),
1375 param_spec->positional_optional.data[i].param.padoff
1377 lhs = op_append_elem(OP_LIST, lhs, var);
1387 * 1) no named params
1394 * => synthetic %{rest}
1395 * 2.2) slurpy is a hash
1397 * 2.3) slurpy is an array
1398 * => synthetic %{rest}
1399 * remember to declare array later
1402 slurpy_hash = param_spec->slurpy.name && SvPV_nolen(param_spec->slurpy.name)[0] == '%';
1403 if (!count_named_params(param_spec)) {
1404 if (param_spec->slurpy.name) {
1405 padoff = param_spec->slurpy.padoff;
1406 type = slurpy_hash ? OP_PADHV : OP_PADAV;
1408 padoff = NOT_IN_PAD;
1411 } else if (slurpy_hash) {
1412 padoff = param_spec->slurpy.padoff;
1415 padoff = param_spec->rest_hash = pad_add_name_pvs("%{rest}", 0, NULL, NULL);
1419 if (padoff != NOT_IN_PAD) {
1420 OP *const var = my_var_g(
1423 OPf_WANT_LIST | (OPpLVAL_INTRO << 8),
1427 lhs = op_append_elem(OP_LIST, lhs, var);
1429 if (type == OP_PADHV) {
1430 param_spec->rest_hash = padoff;
1437 lhs->op_flags |= OPf_PARENS;
1438 rhs = newAVREF(newGVOP(OP_GV, 0, PL_defgv));
1440 *prelude_sentinel = op_append_list(
1441 OP_LINESEQ, *prelude_sentinel,
1444 newASSIGNOP(OPf_STACKED, lhs, 0, rhs)
1450 /* default positional arguments */
1457 req = param_spec->positional_required.used;
1458 for (i = 0, lim = param_spec->positional_optional.used; i < lim; i++) {
1459 ParamInit *cur = ¶m_spec->positional_optional.data[i];
1464 newAVREF(newGVOP(OP_GV, 0, PL_defgv)),
1465 mkconstiv(aTHX_ req + i + 1)
1468 var = my_var(aTHX_ 0, cur->param.padoff);
1470 nest = op_append_list(
1472 newASSIGNOP(OPf_STACKED, var, 0, cur->init)
1483 *prelude_sentinel = op_append_list(
1484 OP_LINESEQ, *prelude_sentinel,
1489 /* named parameters */
1490 if (count_named_params(param_spec)) {
1493 assert(param_spec->rest_hash != NOT_IN_PAD);
1495 for (i = 0, lim = param_spec->named_required.used; i < lim; i++) {
1496 Param *cur = ¶m_spec->named_required.data[i];
1498 char *p = SvPV(cur->name, n);
1501 cond = mkhvelem(aTHX_ param_spec->rest_hash, mkconstpv(aTHX_ p + 1, n - 1));
1503 if (spec->flags & FLAG_CHECK_NARGS) {
1506 var = mkhvelem(aTHX_ param_spec->rest_hash, mkconstpv(aTHX_ p + 1, n - 1));
1507 var = newUNOP(OP_DELETE, 0, var);
1509 msg = mkconstsv(aTHX_ newSVpvf("In %"SVf": missing named parameter: %.*s", SVfARG(declarator), (int)(n - 1), p + 1));
1512 newGVOP(OP_GV, 0, gv_fetchpvs("Carp::croak", 0, SVt_PVCV))
1514 xcroak = newUNOP(OP_ENTERSUB, OPf_STACKED, op_append_elem(OP_LIST, msg, xcroak));
1516 cond = newUNOP(OP_EXISTS, 0, cond);
1518 cond = newCONDOP(0, cond, var, xcroak);
1523 OPf_MOD | (OPpLVAL_INTRO << 8),
1526 var = newASSIGNOP(OPf_STACKED, var, 0, cond);
1528 *prelude_sentinel = op_append_list(OP_LINESEQ, *prelude_sentinel, newSTATEOP(0, NULL, var));
1531 for (i = 0, lim = param_spec->named_optional.used; i < lim; i++) {
1532 ParamInit *cur = ¶m_spec->named_optional.data[i];
1534 char *p = SvPV(cur->param.name, n);
1537 var = mkhvelem(aTHX_ param_spec->rest_hash, mkconstpv(aTHX_ p + 1, n - 1));
1538 var = newUNOP(OP_DELETE, 0, var);
1540 cond = mkhvelem(aTHX_ param_spec->rest_hash, mkconstpv(aTHX_ p + 1, n - 1));
1541 cond = newUNOP(OP_EXISTS, 0, cond);
1543 cond = newCONDOP(0, cond, var, cur->init);
1548 OPf_MOD | (OPpLVAL_INTRO << 8),
1551 var = newASSIGNOP(OPf_STACKED, var, 0, cond);
1553 *prelude_sentinel = op_append_list(OP_LINESEQ, *prelude_sentinel, newSTATEOP(0, NULL, var));
1556 if (!param_spec->slurpy.name) {
1557 if (spec->flags & FLAG_CHECK_NARGS) {
1558 /* croak if %{rest} */
1559 OP *xcroak, *cond, *keys, *msg;
1561 keys = newUNOP(OP_KEYS, 0, my_var_g(aTHX_ OP_PADHV, 0, param_spec->rest_hash));
1562 keys = newLISTOP(OP_SORT, 0, newOP(OP_PUSHMARK, 0), keys);
1564 OP *first, *mid, *last;
1568 mid = mkconstpvs(", ");
1569 mid->op_sibling = last;
1571 first = newOP(OP_PUSHMARK, 0);
1573 keys = newLISTOP(OP_JOIN, 0, first, mid);
1574 keys->op_targ = pad_alloc(OP_JOIN, SVs_PADTMP);
1575 ((LISTOP *)keys)->op_last = last;
1578 msg = mkconstsv(aTHX_ newSVpvf("In %"SVf": no such named parameter: ", SVfARG(declarator)));
1579 msg = newBINOP(OP_CONCAT, 0, msg, keys);
1583 newGVOP(OP_GV, 0, gv_fetchpvs("Carp::croak", 0, SVt_PVCV))
1585 xcroak = newUNOP(OP_ENTERSUB, OPf_STACKED, op_append_elem(OP_LIST, msg, xcroak));
1587 cond = newUNOP(OP_KEYS, 0, my_var_g(aTHX_ OP_PADHV, 0, param_spec->rest_hash));
1588 xcroak = newCONDOP(0, cond, xcroak, NULL);
1590 *prelude_sentinel = op_append_list(OP_LINESEQ, *prelude_sentinel, newSTATEOP(0, NULL, xcroak));
1594 clear = newASSIGNOP(
1596 my_var_g(aTHX_ OP_PADHV, 0, param_spec->rest_hash),
1601 *prelude_sentinel = op_append_list(OP_LINESEQ, *prelude_sentinel, newSTATEOP(0, NULL, clear));
1603 } else if (param_spec->slurpy.padoff != param_spec->rest_hash) {
1606 assert(SvPV_nolen(param_spec->slurpy.name)[0] == '@');
1611 OPf_MOD | (OPpLVAL_INTRO << 8),
1612 param_spec->slurpy.padoff
1615 var = newASSIGNOP(OPf_STACKED, var, 0, my_var_g(aTHX_ OP_PADHV, 0, param_spec->rest_hash));
1617 *prelude_sentinel = op_append_list(OP_LINESEQ, *prelude_sentinel, newSTATEOP(0, NULL, var));
1619 clear = newASSIGNOP(
1621 my_var_g(aTHX_ OP_PADHV, 0, param_spec->rest_hash),
1626 *prelude_sentinel = op_append_list(OP_LINESEQ, *prelude_sentinel, newSTATEOP(0, NULL, clear));
1631 /* finally let perl parse the actual subroutine body */
1632 body = parse_block(0);
1634 /* add '();' to make function return nothing by default */
1635 /* (otherwise the invisible parameter initialization can "leak" into
1636 the return value: fun ($x) {}->("asdf", 0) == 2) */
1637 if (*prelude_sentinel) {
1638 body = newSTATEOP(0, NULL, body);
1641 body = op_append_list(OP_LINESEQ, *prelude_sentinel, body);
1642 *prelude_sentinel = NULL;
1647 OP *const attrs = *attrs_sentinel;
1648 *attrs_sentinel = NULL;
1650 SvREFCNT_inc_simple_void(PL_compcv);
1652 /* close outer block: '}' */
1653 S_block_end(aTHX_ save_ix, body);
1657 saw_name ? newSVOP(OP_CONST, 0, SvREFCNT_inc_simple_NN(saw_name)) : NULL,
1658 proto ? newSVOP(OP_CONST, 0, SvREFCNT_inc_simple_NN(proto)) : NULL,
1663 register_info(aTHX_ PTR2UV(CvROOT(cv)), declarator, spec, param_spec);
1666 *pop = newOP(OP_NULL, 0);
1667 return KEYWORD_PLUGIN_STMT;
1677 return KEYWORD_PLUGIN_EXPR;
1681 static int my_keyword_plugin(pTHX_ char *keyword_ptr, STRLEN keyword_len, OP **op_ptr) {
1684 Sentinel sen = { NULL };
1689 SAVEDESTRUCTOR_X(sentinel_clear_void, sen);
1691 if (kw_flags(aTHX_ sen, keyword_ptr, keyword_len, &spec)) {
1692 ret = parse_fun(aTHX_ sen, op_ptr, keyword_ptr, keyword_len, &spec);
1694 ret = next_keyword_plugin(aTHX_ keyword_ptr, keyword_len, op_ptr);
1705 MODULE = Function::Parameters PACKAGE = Function::Parameters PREFIX = fp_
1716 xcv = sv_2cv(sv, &hv, &gv, 0);
1717 RETVAL = PTR2UV(xcv ? CvROOT(xcv) : NULL);
1723 HV *const stash = gv_stashpvs(MY_PKG, GV_ADD);
1725 newCONSTSUB(stash, "FLAG_NAME_OK", newSViv(FLAG_NAME_OK));
1726 newCONSTSUB(stash, "FLAG_ANON_OK", newSViv(FLAG_ANON_OK));
1727 newCONSTSUB(stash, "FLAG_DEFAULT_ARGS", newSViv(FLAG_DEFAULT_ARGS));
1728 newCONSTSUB(stash, "FLAG_CHECK_NARGS", newSViv(FLAG_CHECK_NARGS));
1729 newCONSTSUB(stash, "FLAG_INVOCANT", newSViv(FLAG_INVOCANT));
1730 newCONSTSUB(stash, "FLAG_NAMED_PARAMS", newSViv(FLAG_NAMED_PARAMS));
1731 newCONSTSUB(stash, "HINTK_KEYWORDS", newSVpvs(HINTK_KEYWORDS));
1732 newCONSTSUB(stash, "HINTK_FLAGS_", newSVpvs(HINTK_FLAGS_));
1733 newCONSTSUB(stash, "HINTK_SHIFT_", newSVpvs(HINTK_SHIFT_));
1734 newCONSTSUB(stash, "HINTK_ATTRS_", newSVpvs(HINTK_ATTRS_));
1736 next_keyword_plugin = PL_keyword_plugin;
1737 PL_keyword_plugin = my_keyword_plugin;